K5: Tagesbudget als harte Grenze

Es gab keine Obergrenze. Ein Agent in einer Schleife — etwa durch gegenseitige
send_message-Aufrufe — konnte unbeaufsichtigt Guthaben verbrennen; die
Credits-Anzeige war rein informativ.

Verbrauchsdaten in der Datenbank

Voraussetzung dafuer ist eine belastbare Erfassung. Bisher lag der Verbrauch in
TokenUsage.json: Bei JEDEM Agenten-Lauf wurde die gesamte Datei geladen, ergaenzt
und neu geschrieben, unter einem globalen Lock. Das waechst quadratisch und ist
der eigentliche Engpass bei vielen Agenten — unabhaengig davon, welche Datenbank
darunter liegt.

RunUsage liegt jetzt in einer eigenen Tabelle mit Ortsdatum, damit ein Tagesbudget
der Wahrnehmung des Benutzers folgt und die Abfrage ohne Zeitzonenrechnerei
auskommt. Betraege werden als Text abgelegt und als decimal gelesen: Ueber REAL zu
gehen wuerde bei Cent-Betraegen Rundungsfehler einsammeln, die sich ueber tausende
Laeufe summieren. Ein Test weist das mit 1000 Buchungen zu je 0,0001 USD nach.

BudgetGuard

Zwei Arten von Grenzen, weil sich Kosten nicht immer beziffern lassen: Liefert der
Anbieter fuer ein Modell keine Preise, greift die Kostengrenze nicht — die
Token-Grenze dagegen immer. Wer sich absichern will, setzt beide. Ist die Summe
wegen fehlender Preise unvollstaendig, steht das in der Begruendung; sonst wirkte
ein niedriger Verbrauch wie ein noch offener Spielraum.

Grenzen gibt es je Agent und je Instanz. Geprueft wird vor der ersten Anfrage,
damit ein erschoepftes Budget gar nichts mehr kostet. Neuer Endzustand
BudgetExceeded.

Nebenbei: Der Namespace Usage kollidierte mit der gleichnamigen Modellklasse fuer
Token-Angaben und heisst jetzt Accounting.

357 Tests gruen (209 Core, 148 Tools).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

src/ClawdDotNet.Core/Storage/SqliteStorage.cs

@@ -128,6 +128,30 @@ public sealed class SqliteStorage
             CREATE UNIQUE INDEX IF NOT EXISTS UX_Memories_Key
                 ON Memories (Scope, OwnerId, MemoryKey)
                 WHERE MemoryKey IS NOT NULL;
+
+            CREATE TABLE IF NOT EXISTS RunUsage (
+                Id               INTEGER PRIMARY KEY AUTOINCREMENT,
+                AgentId          TEXT    NOT NULL,
+                Model            TEXT    NOT NULL,
+                PromptTokens     INTEGER NOT NULL,
+                CompletionTokens INTEGER NOT NULL,
+                CachedTokens     INTEGER NOT NULL DEFAULT 0,
+                CostUsd          TEXT    NOT NULL DEFAULT '0',
+                CostIsKnown      INTEGER NOT NULL DEFAULT 0,
+                Status           TEXT    NOT NULL DEFAULT '',
+                StepCount        INTEGER NOT NULL DEFAULT 0,
+                DurationMs       INTEGER NOT NULL DEFAULT 0,
+                OccurredAt       TEXT    NOT NULL,
+                -- Ortsdatum, damit ein Tagesbudget der Wahrnehmung des Benutzers folgt
+                -- und die Abfrage ohne Zeitzonenrechnerei auskommt.
+                UsageDate        TEXT    NOT NULL
+            );
+
+            CREATE INDEX IF NOT EXISTS IX_RunUsage_Day
+                ON RunUsage (UsageDate, AgentId);
+
+            CREATE INDEX IF NOT EXISTS IX_RunUsage_Recent
+                ON RunUsage (OccurredAt DESC);
             """;
 
         cmd.ExecuteNonQuery();