@tritard/waterbrother 0.14.10 → 0.14.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tritard/waterbrother",
-  "version": "0.14.10",
+  "version": "0.14.11",
   "description": "Waterbrother: Grok-powered coding CLI with local tools, sessions, operator modes, and approval controls",
   "type": "module",
   "bin": {

package/src/agent.js

@@ -76,7 +76,8 @@ When you use tools:
 - Never claim you ran commands you did not run.
 - If a tool fails, show the failure and recover.
 - You are primarily a coding assistant, but you can also have normal conversations. When the user wants to chat, just chat — be natural, helpful, and engaging. Do not constantly redirect to coding or push "what do you want to build?" when the user is clearly just talking.
-- Only use tools (file writes, shell commands) when the user asks for actual code work. Do not create files for joke requests, hypothetical questions, or non-engineering prompts.`;
+- Only use tools (file writes, shell commands) when the user asks for actual code work. Do not create files for joke requests, hypothetical questions, or non-engineering prompts.
+- You can call multiple tools in a single response. When multiple independent pieces of information are needed, make all calls in parallel for optimal performance. For example, if you need to read 3 files, read all 3 in one response rather than one at a time.`;
 
 const COMPACTION_SYSTEM_PROMPT = `You are compacting a coding assistant conversation for context resumption. Write a continuation summary that allows efficient resumption in a new context window where the conversation history will be replaced with this summary.
 
@@ -126,6 +127,7 @@ const PROFILE_PROMPTS = {
 const MAX_TOOL_CALL_ITERATIONS = 24;
 const LOCAL_COMPACTION_TRANSCRIPT_CHARS = 400_000;
 const LOCAL_COMPACTION_MESSAGE_PREVIEW_CHARS = 280;
+const MAX_COMPACTION_CONSECUTIVE_FAILURES = 3;
 
 function buildSystemPrompt(profile, experienceMode = "standard", autonomyMode = "scoped", memory = "", executionContext = null) {
   const profileLine = PROFILE_PROMPTS[profile] || PROFILE_PROMPTS.coder;
@@ -321,6 +323,8 @@ export class Agent {
     this.autonomyMode = normalizeAutonomyMode(autonomyMode);
     this.requireTurnContracts = requireTurnContracts !== false;
     this.executionContext = null;
+    this._compactionFailures = 0;
+    this._transcriptPath = null;
 
     this.messages = [{ role: "system", content: buildSystemPrompt(profile, this.experienceMode, this.autonomyMode, this.memory) }];
     this.toolRuntime = createToolRuntime({
@@ -442,6 +446,11 @@ export class Agent {
   }
 
   async compactConversation({ keepLast = 24, signal } = {}) {
+    // Circuit breaker: stop trying after consecutive failures
+    if (this._compactionFailures >= MAX_COMPACTION_CONSECUTIVE_FAILURES) {
+      return { compacted: false, reason: "circuit_breaker", totalMessages: this.getSessionMessages().length };
+    }
+
     const keep = Math.max(8, Math.floor(Number(keepLast) || 24));
     const sessionMessages = this.getSessionMessages();
     if (sessionMessages.length <= keep + 2) {
@@ -486,14 +495,35 @@ export class Agent {
         usage = completion?.usage || null;
       } catch (error) {
         if (isAbortError(error)) throw error;
+        this._compactionFailures++;
         summaryBody = summarizeMessagesLocally(toSummarize);
         method = "local-fallback";
       }
     }
 
+    // Reset circuit breaker on success
+    this._compactionFailures = 0;
+
+    // Save transcript to disk before compacting — allows recovery of details
+    let transcriptNote = "";
+    try {
+      if (this.cwd) {
+        const { join } = await import("node:path");
+        const { mkdir, appendFile } = await import("node:fs/promises");
+        const dir = join(this.cwd, ".waterbrother");
+        await mkdir(dir, { recursive: true });
+        const transcriptPath = this._transcriptPath || join(dir, `transcript-${Date.now()}.jsonl`);
+        this._transcriptPath = transcriptPath;
+        for (const msg of toSummarize) {
+          await appendFile(transcriptPath, JSON.stringify(msg) + "\n", "utf8");
+        }
+        transcriptNote = `\n\nIf you need specific details from before compaction (like exact code snippets, error messages, or content you generated), read the full transcript at: ${transcriptPath}`;
+      }
+    } catch {}
+
     const summaryMessage = {
       role: "assistant",
-      content: `### Compacted context summary\n${summaryBody}`
+      content: `### Compacted context summary\n${summaryBody}${transcriptNote}`
     };
 
     this.messages = [