B1, B14 und B3 beheben: Compaction-Paarung und Token-Semantik

B1 — Die Compaction behielt blind die letzten 6 Nachrichten. Fiel diese Grenze
mitten in eine Tool-Sequenz, entstand eine tool-Antwort ohne zugehoerigen
assistant-tool_call; die API lehnt das mit HTTP 400 ab. FindSafeTailStart
verschiebt die Grenze jetzt rueckwaerts auf eine Blockgrenze.

B14 — Bei Konversationen mit hoechstens 6 Nachrichten enthielt der Tail auch die
system-Nachricht, die anschliessend ein zweites Mal angehaengt wurde. Ergebnis
war ein doppelter System-Prompt und eine duplizierte Konversation — die
Compaction vergroesserte den Kontext, statt ihn zu verkleinern. Der Tail beginnt
nun grundsaetzlich hinter dem System-Prompt; liegt davor nichts Nennenswertes,
wird die Kompaktierung uebersprungen. Gefunden durch den Property-Test.

Nebeneffekt: Zusammengefasst wird nur noch der Teil, der tatsaechlich wegfaellt.
Der Tail bleibt woertlich erhalten und musste bisher doppelt bezahlt werden.

B3 — maxTokens zaehlte kumulativ ueber alle Schritte, wurde aber wie eine
Kontextgrenze konfiguriert. Da jeder Schritt den vollen Kontext erneut sendet,
brach ein Chat mit 20k Kontext nach vier Schritten ab. Aufgeteilt in
maxCumulativeTokens (Kostenbudget, Default 500k) und maxContextTokens
(Kontextgroesse). Alte Konfigurationen werden beim Laden migriert, die
Fehlermeldungen unterscheiden jetzt Schritt- und Kostenlimit.

Alle 31 Tests gruen.

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

src/ClawdDotNet.Core/Config/AgentConfig.cs

@@ -107,8 +107,26 @@ public sealed class LoopGuardConfig
     [JsonPropertyName("maxSteps")]
     public int MaxSteps { get; set; } = 20;
 
+    /// <summary>
+    /// Kostenbudget für einen kompletten Run: Summe der abgerechneten Tokens über
+    /// ALLE Schritte hinweg.
+    ///
+    /// Achtung — dieser Wert ist nicht mit der Kontextgröße zu verwechseln: Da jeder
+    /// Schritt den vollständigen Kontext erneut sendet, wächst die Summe quadratisch.
+    /// Ein Agent mit stabilem 20k-Kontext verbraucht über 10 Schritte bereits ~200k.
+    /// Der Default ist deshalb bewusst großzügig; für die Kontextgröße ist
+    /// <see cref="MaxContextTokens"/> zuständig.
+    /// </summary>
+    [JsonPropertyName("maxCumulativeTokens")]
+    public int MaxCumulativeTokens { get; set; } = 500_000;
+
+    /// <summary>
+    /// Veraltet: hieß früher "maxTokens" und wurde fälschlich als Kontextgrenze
+    /// verstanden, obwohl er kumulativ zählt. Wird nur noch für die Migration alter
+    /// Konfigurationen gelesen — siehe <see cref="MaxCumulativeTokens"/>.
+    /// </summary>
     [JsonPropertyName("maxTokens")]
-    public int MaxTokens { get; set; } = 80_000;
+    public int? LegacyMaxTokens { get; set; }
 
     [JsonPropertyName("timeoutSeconds")]
     public int TimeoutSeconds { get; set; } = 600;

src/ClawdDotNet.Core/Config/ConfigLoader.cs

@@ -20,10 +20,41 @@ public static class ConfigLoader
         var config = await JsonSerializer.DeserializeAsync<InstanceConfig>(stream, JsonOptions, ct)
             ?? throw new InvalidOperationException($"Config file is empty or invalid: {filePath}");
 
+        Migrate(config);
         Validate(config, filePath);
         return config;
     }
 
+    /// <summary>
+    /// Hebt alte Konfigurationen auf das aktuelle Schema.
+    ///
+    /// "maxTokens" wurde früher als Kontextgrenze verstanden, zählte aber kumulativ
+    /// über alle Schritte — dadurch brachen normale Läufe vorzeitig ab. Der Wert wird
+    /// nicht übernommen, sondern durch den großzügigen Default für das Kostenbudget
+    /// ersetzt; die Kontextsteuerung übernimmt maxContextTokens.
+    /// </summary>
+    public static void Migrate(InstanceConfig config)
+    {
+        foreach (var agent in config.Agents)
+            Migrate(agent);
+    }
+
+    /// <summary>
+    /// Migration für einen einzeln geladenen Agenten (AgentSettings.json).
+    /// </summary>
+    public static void Migrate(AgentConfig agent)
+    {
+        var guard = agent.LoopGuard;
+        if (guard.LegacyMaxTokens is not { } legacy)
+            return;
+
+        // Nur übernehmen, wenn bewusst großzügiger konfiguriert als der Default.
+        if (legacy > guard.MaxCumulativeTokens)
+            guard.MaxCumulativeTokens = legacy;
+
+        guard.LegacyMaxTokens = null;
+    }
+
     private static void Validate(InstanceConfig config, string filePath)
     {
         if (string.IsNullOrWhiteSpace(config.OpenRouterApiKey))

src/ClawdDotNet.Core/Engine/ContextCompactor.cs

@@ -95,12 +95,55 @@ public sealed class ContextCompactor
         return pruned;
     }
 
+    /// <summary>
+    /// Sucht einen Index, an dem der Kontext geteilt werden darf, ohne eine Tool-Sequenz
+    /// zu zerreißen.
+    ///
+    /// Eine <c>tool</c>-Nachricht darf nie am Anfang des behaltenen Teils stehen — ihr
+    /// <c>assistant</c>-Aufruf stünde sonst nicht mehr davor und die API lehnt die
+    /// gesamte Anfrage mit HTTP 400 ab. Deshalb wandert die Grenze rückwärts bis zum
+    /// Beginn des Blocks, in den sie fällt.
+    /// </summary>
+    private static int FindSafeTailStart(List<ChatMessage> messages, int desiredStart, int minIndex)
+    {
+        var i = Math.Clamp(desiredStart, minIndex, messages.Count);
+
+        // Rückwärts, bis der Anfang keine verwaiste Tool-Antwort mehr ist.
+        while (i > minIndex && i < messages.Count && messages[i].Role == "tool")
+            i--;
+
+        return i;
+    }
+
     private async Task CompactViaLlmAsync(
         List<ChatMessage> messages, string model, CancellationToken ct)
     {
         var systemMsg = messages.FirstOrDefault(m => m.Role == "system");
+
+        // Der System-Prompt wird separat behandelt und darf nie Teil des Tails werden,
+        // sonst landet er doppelt im Kontext.
+        var firstNonSystem = systemMsg is null ? 0 : messages.IndexOf(systemMsg) + 1;
+
+        var tailStart = FindSafeTailStart(
+            messages,
+            messages.Count - ProtectedTailMessages,
+            firstNonSystem);
+
+        // Wenn vor dem geschützten Ende nichts Nennenswertes liegt, gibt es nichts
+        // zusammenzufassen — eine Kompaktierung würde den Kontext sogar vergrößern.
+        if (tailStart - firstNonSystem < 2)
+        {
+            _logger.LogInformation(
+                "Compaction übersprungen: nur {Count} Nachricht(en) vor dem geschützten Ende",
+                tailStart - firstNonSystem);
+            return;
+        }
+
+        // Nur den Teil zusammenfassen, der tatsächlich wegfällt — der Tail bleibt
+        // ohnehin wörtlich erhalten und müsste sonst doppelt bezahlt werden.
         var conversationParts = messages
-            .Where(m => m.Role != "system")
+            .Take(tailStart)
+            .Skip(firstNonSystem)
             .Select(FormatMessageForSummary);
 
         var conversationText = string.Join("\n", conversationParts);
@@ -136,10 +179,9 @@ public sealed class ContextCompactor
                 return;
             }
 
-            // Nachrichten ersetzen: System-Prompt + Zusammenfassung + geschützte letzte Nachrichten
-            var tail = messages
-                .Skip(Math.Max(0, messages.Count - ProtectedTailMessages))
-                .ToList();
+            // Nachrichten ersetzen: System-Prompt + Zusammenfassung + geschützte letzte Nachrichten.
+            // tailStart liegt garantiert auf einer Blockgrenze und hinter dem System-Prompt.
+            var tail = messages.Skip(tailStart).ToList();
 
             messages.Clear();
 

src/ClawdDotNet.Core/Engine/LoopGuard.cs

@@ -16,13 +16,23 @@ public sealed class LoopGuard
     public void RecordStep()
     {
         if (Interlocked.Increment(ref _steps) > _cfg.MaxSteps)
-            throw new LoopLimitExceededException($"Max steps ({_cfg.MaxSteps}) exceeded.");
+            throw new LoopLimitExceededException(
+                $"Schritt-Limit erreicht: {_cfg.MaxSteps} Schritte pro Run.");
     }
 
+    /// <summary>
+    /// Bucht die abgerechneten Tokens eines Schritts auf das Kostenbudget des Runs.
+    /// Das ist eine reine Kostenbremse — die Kontextgröße wird davon getrennt über
+    /// <see cref="LoopGuardConfig.MaxContextTokens"/> und die Compaction gesteuert.
+    /// </summary>
     public void RecordTokens(int count)
     {
-        if (Interlocked.Add(ref _tokens, count) > _cfg.MaxTokens)
-            throw new LoopLimitExceededException($"Max tokens ({_cfg.MaxTokens}) exceeded.");
+        var total = Interlocked.Add(ref _tokens, count);
+        if (total > _cfg.MaxCumulativeTokens)
+            throw new LoopLimitExceededException(
+                $"Kostenbudget erschöpft: {total:N0} von maximal {_cfg.MaxCumulativeTokens:N0} " +
+                "abgerechneten Tokens in diesem Run. Hinweis: Jeder Schritt sendet den " +
+                "kompletten Kontext erneut, die Summe wächst daher überproportional.");
     }
 }