open-agents-ai 0.187.587 → 0.187.589

package/dist/index.js

@@ -514656,7 +514656,8 @@ function evaluate(inputs) {
     return {
       decision: "observer_block",
       reason: "Littleman observer flagged this fingerprint as redundant",
-      cachedResult: cached ? cached.result : null
+      cachedResult: cached ? `[CACHED RESULT — you already have this information from a prior call. Do NOT call this tool again with the same arguments.]
+${cached.result}` : null
     };
   }
   if (isReadLike) {
@@ -514672,10 +514673,12 @@ function evaluate(inputs) {
           blockMessage: buildForceProgressBlockMessage(proposedCall, hits)
         };
       }
+      const cachedEnvelope = `[CACHED RESULT — you already have this information from a prior call. Do NOT call this tool again with the same arguments.]
+${cached.result}`;
       return {
         decision: "serve_cached",
         reason: cached.compacted ? "post-compaction cache re-serve" : `duplicate call #${hits} (still under ${threshold}-hit gate)`,
-        cachedResult: cached.result,
+        cachedResult: cachedEnvelope,
         compacted: cached.compacted,
         hitNumber: hits
       };
@@ -529241,14 +529244,15 @@ ${body}`;
       proactivePrune(messages2, currentTurn) {
         if (process.env["OA_DISABLE_PROACTIVE_PRUNE"] === "1")
           return;
-        const AGED_FILE_READ_TURNS = 10;
-        const AGED_SHELL_TURNS = 5;
+        const AGED_FILE_READ_TURNS = 20;
+        const AGED_SHELL_TURNS = 12;
         const ERROR_MARKERS = /(?:error|fail|exception|traceback|enoent|enotfound|exit code [^0]|status[: ]+1\d?\d?)/i;
         const PRUNE_PREFIX = "[Tool result cleared";
         const DEDUPE_PREFIX = "[deduped — same call as turn";
         const FILE_AGED_PREFIX = "[file_read aged out, summary:";
         const SHELL_AGED_PREFIX = "[shell succeeded, output pruned —";
         const seen = /* @__PURE__ */ new Map();
+        const seenResource = /* @__PURE__ */ new Map();
         const pending = [];
         let scanTurn = 0;
         for (let i2 = 0; i2 < messages2.length; i2++) {
@@ -529293,7 +529297,26 @@ ${body}`;
               }
               seen.set(fp, { turn: scanTurn, idx: resultIdx });
               const ageTurns = currentTurn - scanTurn;
-              if (name10 === "file_read" && ageTurns > AGED_FILE_READ_TURNS && content.length > 200) {
+              const wasRecentlyWritten = (() => {
+                try {
+                  const o2 = JSON.parse(tc.function.arguments || "{}");
+                  const p2 = String(o2.path ?? o2.file ?? "");
+                  for (let k = Math.max(0, i2 - 20); k < i2; k++) {
+                    const m2 = messages2[k];
+                    if (m2.role === "assistant" && m2.tool_calls) {
+                      for (const tc2 of m2.tool_calls) {
+                        if ((tc2.function.name === "file_edit" || tc2.function.name === "file_write" || tc2.function.name === "file_patch") && tc2.function.arguments?.includes(p2)) {
+                          return true;
+                        }
+                      }
+                    }
+                  }
+                  return false;
+                } catch {
+                  return false;
+                }
+              })();
+              if (name10 === "file_read" && ageTurns > AGED_FILE_READ_TURNS && content.length > 200 && !wasRecentlyWritten) {
                 const pathArg = (() => {
                   try {
                     const o2 = JSON.parse(tc.function.arguments || "{}");
@@ -529302,11 +529325,15 @@ ${body}`;
                     return "?";
                   }
                 })();
-                const firstLine = content.split("\n")[0]?.slice(0, 80) ?? "";
+                const lines = content.split("\n");
+                const lineCount = lines.length;
+                const contentPreview = content.slice(0, 500);
                 pending.push({
                   idx: resultIdx,
                   reason: "aged_file",
-                  replacement: `${FILE_AGED_PREFIX} path=${pathArg}, size=${content.length} chars, first-line="${firstLine}"]`
+                  replacement: `${FILE_AGED_PREFIX} path=${pathArg}, ${lineCount} lines, ${content.length} chars]
+${contentPreview}
+[End of aged file_read preview — do NOT re-read this file, use the content above]`
                 });
                 continue;
               }
@@ -530113,6 +530140,61 @@ ${latest.output || ""}`.trim();
         sections.push(`(turn ${turn} — this block is regenerated every turn from your tool history)`);
         return sections.join("\n");
       }
+      /**
+       * REG-62: Pre-call knowledge injection. Builds a concise system message
+       * summarizing what the model has already read/searched/listed so it
+       * doesn't re-call those tools. This is the PRIMARY fix for duplicate
+       * tool calls — the model re-reads because it can't find prior results
+       * in the long transcript. By injecting a summary right before the LLM
+       * call, the model knows what it already has.
+       */
+      _renderKnowledgeBlock(recentToolResults) {
+        if (recentToolResults.size === 0)
+          return null;
+        const filesRead = [];
+        const dirsListed = [];
+        const searches = [];
+        const shells = [];
+        for (const [fingerprint, entry] of recentToolResults) {
+          if (entry.compacted)
+            continue;
+          const colonIdx = fingerprint.indexOf(":");
+          const toolName = colonIdx > 0 ? fingerprint.slice(0, colonIdx) : fingerprint;
+          if (toolName === "file_read") {
+            const pathMatch = fingerprint.match(/path=([^,\s]+)/);
+            if (pathMatch?.[1])
+              filesRead.push(pathMatch[1]);
+          } else if (toolName === "list_directory") {
+            const pathMatch = fingerprint.match(/path=([^,\s]+)/);
+            if (pathMatch?.[1])
+              dirsListed.push(pathMatch[1]);
+          } else if (toolName === "grep_search" || toolName === "find_files") {
+            searches.push(toolName);
+          } else if (toolName === "shell" || toolName === "shell_async") {
+            const cmdMatch = fingerprint.match(/cmd=([^,\s]+)/);
+            shells.push(cmdMatch?.[1] ?? toolName);
+          }
+        }
+        const sections = ["[KNOWLEDGE — you already have these results in context above. Do NOT re-call these tools for the same targets:]"];
+        if (filesRead.length > 0) {
+          const unique = [...new Set(filesRead)].slice(0, 30);
+          sections.push(`Files already read (${unique.length}): ${unique.join(", ")}`);
+        }
+        if (dirsListed.length > 0) {
+          const unique = [...new Set(dirsListed)].slice(0, 15);
+          sections.push(`Directories already listed (${unique.length}): ${unique.join(", ")}`);
+        }
+        if (searches.length > 0) {
+          sections.push(`Searches already run: ${searches.length}`);
+        }
+        if (shells.length > 0) {
+          const unique = [...new Set(shells)].slice(0, 15);
+          sections.push(`Shell commands already executed (${unique.length}): ${unique.join(", ")}`);
+        }
+        if (sections.length <= 1)
+          return null;
+        return sections.join("\n");
+      }
       makePhaseSummarizer() {
         if (process.env["OA_DISABLE_PHASE_SUMMARIZER"] === "1")
           return null;
@@ -530341,6 +530423,46 @@ ${blob}
       _buildToolFingerprint(name10, args) {
         return `${name10}:${this._buildExactArgsKey(args)}`;
       }
+      /**
+       * REG-62: Build a resource-level key for semantic dedup.
+       *
+       * Unlike _buildToolFingerprint (exact args match), this normalizes
+       * different calls that target the SAME resource:
+       *   file_read("foo.ts") == file_read("foo.ts", offset=10)
+       *   file_read("foo.ts") == shell("cat foo.ts")
+       *   grep_search("x", path="src") == grep_search("x", path="src", include="*.ts")
+       *
+       * Returns empty string if no resource key can be extracted (non-dedupable).
+       */
+      _buildResourceKey(name10, args) {
+        const a2 = args ?? {};
+        if (name10 === "file_read") {
+          const p2 = String(a2.path ?? a2.file ?? "");
+          return p2 ? `resource:file:${p2}` : "";
+        }
+        if (name10 === "shell" || name10 === "shell_async") {
+          const cmd = String(a2.command ?? a2.cmd ?? "");
+          const catMatch = cmd.match(/(?:cat|head|tail|type|less|more)\s+["']?([^\s"';&|>]+)/);
+          if (catMatch?.[1])
+            return `resource:file:${catMatch[1]}`;
+          return "";
+        }
+        if (name10 === "grep_search") {
+          const p2 = String(a2.path ?? ".");
+          const pat = String(a2.pattern ?? "");
+          return `resource:grep:${p2}:${pat}`;
+        }
+        if (name10 === "find_files") {
+          const p2 = String(a2.path ?? ".");
+          const pat = String(a2.pattern ?? "");
+          return `resource:find:${p2}:${pat}`;
+        }
+        if (name10 === "list_directory") {
+          const p2 = String(a2.path ?? ".");
+          return `resource:ls:${p2}`;
+        }
+        return "";
+      }
       _formatExactArgValue(value2) {
         const canonical = this._canonicalArgValue(value2);
         const oneLine = canonical.replace(/\r/g, "\\r").replace(/\n/g, "\\n");
@@ -532566,6 +532688,9 @@ ${memoryLines.join("\n")}`
           const progressBlock = this._renderProgressNudgeBlock(turn);
           if (progressBlock)
             _injections.push(progressBlock);
+          const knowledgeBlock = this._renderKnowledgeBlock(recentToolResults);
+          if (knowledgeBlock)
+            _injections.push(knowledgeBlock);
           if (_injections.length > 0) {
             const reqMsgs = chatRequest.messages;
             if (Array.isArray(reqMsgs)) {
@@ -579023,12 +579148,9 @@ sleep 1
       if (ctx3.isBlessed?.()) {
         ctx3.blessStop?.();
       }
-      if (ctx3.isTelegramActive?.()) {
-        ctx3.telegramStop?.();
-      }
       const clearedQueue = ctx3.clearQueuedPrompts?.() ?? 0;
       if (!ctx3.hasActiveTask?.()) {
-        if (!ctx3.isBlessed?.() && !ctx3.isTelegramActive?.()) {
+        if (!ctx3.isBlessed?.()) {
           renderWarning(clearedQueue > 0 ? `No active task to stop. Cleared ${clearedQueue} queued prompt(s).` : "No active task to stop.");
         }
         return "handled";
@@ -588195,19 +588317,21 @@ After synthesis, call task_complete with the final prioritized summary.`,
               new GrepSearchTool(this.repoRoot),
               new GlobFindTool(this.repoRoot),
               new MemoryReadTool(this.repoRoot),
-              new MemorySearchTool(this.repoRoot)
+              new MemorySearchTool(this.repoRoot),
+              new MemoryWriteTool(this.repoRoot)
             ];
-            return [...tools.map(adaptTool2), taskComplete];
+            return [...tools.map(adaptTool2), this.createDreamTodoWriteTool(), this.createDreamWorkingNotesTool(), taskComplete];
           }
           case "monitor": {
             const tools = [
               new FileReadTool(this.repoRoot),
               new DreamShellTool(this.repoRoot),
               // read-only shell
-              new AutoresearchTool(this.repoRoot)
+              new AutoresearchTool(this.repoRoot),
               // status-only in prompt
+              new MemoryReadTool(this.repoRoot)
             ];
-            return [...tools.map(adaptTool2), taskComplete];
+            return [...tools.map(adaptTool2), this.createDreamTodoWriteTool(), taskComplete];
           }
           case "evaluator": {
             const tools = [
@@ -588219,7 +588343,7 @@ After synthesis, call task_complete with the final prioritized summary.`,
               new MemoryWriteTool(this.repoRoot),
               new GrepSearchTool(this.repoRoot)
             ];
-            return [...tools.map(adaptTool2), taskComplete];
+            return [...tools.map(adaptTool2), this.createDreamTodoWriteTool(), this.createDreamWorkingNotesTool(), taskComplete];
           }
           case "critic": {
             const tools = [
@@ -588228,7 +588352,7 @@ After synthesis, call task_complete with the final prioritized summary.`,
               new MemorySearchTool(this.repoRoot),
               new GrepSearchTool(this.repoRoot)
             ];
-            return [...tools.map(adaptTool2), taskComplete];
+            return [...tools.map(adaptTool2), this.createDreamTodoWriteTool(), taskComplete];
           }
           case "flow_maintainer": {
             const tools = [
@@ -588236,7 +588360,7 @@ After synthesis, call task_complete with the final prioritized summary.`,
               new MemoryWriteTool(this.repoRoot),
               new MemorySearchTool(this.repoRoot)
             ];
-            return [...tools.map(adaptTool2), taskComplete];
+            return [...tools.map(adaptTool2), this.createDreamTodoWriteTool(), this.createDreamWorkingNotesTool(), taskComplete];
           }
         }
       }
@@ -588613,6 +588737,13 @@ ${summaryResult}
       }
       /** Build tools appropriate for the dream mode */
       buildDreamTools(toolMode) {
+        const memoryAndPlanTools = [
+          new MemoryReadTool(this.repoRoot),
+          new MemoryWriteTool(this.repoRoot),
+          new MemorySearchTool(this.repoRoot)
+        ].map(adaptTool2);
+        const todoWriteTool = this.createDreamTodoWriteTool();
+        const workingNotesTool = this.createDreamWorkingNotesTool();
         if (toolMode === "full") {
           const tools = [
             new FileReadTool(this.repoRoot),
@@ -588630,6 +588761,9 @@ ${summaryResult}
           ];
           return [
             ...tools.map(adaptTool2),
+            ...memoryAndPlanTools,
+            todoWriteTool,
+            workingNotesTool,
             this.createTaskCompleteTool()
           ];
         }
@@ -588650,9 +588784,113 @@ ${summaryResult}
         return [
           ...readTools.map(adaptTool2),
           ...dreamWriteTools.map(adaptTool2),
+          ...memoryAndPlanTools,
+          todoWriteTool,
+          workingNotesTool,
           this.createTaskCompleteTool()
         ];
       }
+      /** Dream-scoped todo_write — persists to .oa/dreams/todo-state.json */
+      createDreamTodoWriteTool() {
+        const todoPath3 = join114(this.dreamsDir, "todo-state.json");
+        return {
+          name: "todo_write",
+          description: "Update the task checklist for this dream session. Mark items in_progress/completed/pending as you work through stages.",
+          parameters: {
+            type: "object",
+            properties: {
+              todos: {
+                type: "array",
+                description: "Full list of todo items for this dream session",
+                items: {
+                  type: "object",
+                  properties: {
+                    id: { type: "string", description: "Stable id for this item" },
+                    content: { type: "string", description: "What needs to be done" },
+                    status: { type: "string", enum: ["pending", "in_progress", "completed", "blocked"] }
+                  },
+                  required: ["content", "status"]
+                }
+              }
+            },
+            required: ["todos"]
+          },
+          async execute(args) {
+            const todos = args["todos"];
+            if (!Array.isArray(todos)) {
+              return { success: false, output: "", error: "todos must be an array" };
+            }
+            try {
+              writeFileSync52(todoPath3, JSON.stringify({ todos, updatedAt: (/* @__PURE__ */ new Date()).toISOString() }, null, 2), "utf-8");
+              const summary = todos.map(
+                (t2, i2) => `  ${t2.status === "completed" ? "✓" : t2.status === "in_progress" ? "▶" : "◯"} ${i2 + 1}: ${t2.content || "(untitled)"}`
+              ).join("\n");
+              return { success: true, output: `Todo list updated (${todos.length} items):
+${summary}` };
+            } catch (err) {
+              return { success: false, output: "", error: String(err) };
+            }
+          }
+        };
+      }
+      /** Dream-scoped working_notes — persists to .oa/dreams/working-notes.json */
+      createDreamWorkingNotesTool() {
+        const notesPath = join114(this.dreamsDir, "working-notes.json");
+        return {
+          name: "working_notes",
+          description: "Track discoveries, decisions, and findings across dream stages. Notes persist within this dream session.",
+          parameters: {
+            type: "object",
+            properties: {
+              action: {
+                type: "string",
+                enum: ["add", "list", "search", "clear", "summary"],
+                description: "Action to perform (default: list)"
+              },
+              content: { type: "string", description: "Note content (for add action)" },
+              category: {
+                type: "string",
+                enum: ["finding", "todo", "question", "decision", "blocker"],
+                description: "Note category (for add action, default: finding)"
+              }
+            }
+          },
+          async execute(args) {
+            const action = args["action"] || "list";
+            try {
+              let notes2 = [];
+              if (existsSync97(notesPath)) {
+                notes2 = JSON.parse(readFileSync80(notesPath, "utf-8"));
+              }
+              if (action === "add") {
+                const note = {
+                  content: String(args["content"] ?? ""),
+                  category: String(args["category"] ?? "finding"),
+                  addedAt: (/* @__PURE__ */ new Date()).toISOString()
+                };
+                notes2.push(note);
+                writeFileSync52(notesPath, JSON.stringify(notes2, null, 2), "utf-8");
+                return { success: true, output: `Note added: [${note.category}] ${note.content.slice(0, 80)}` };
+              }
+              if (action === "clear") {
+                writeFileSync52(notesPath, "[]", "utf-8");
+                return { success: true, output: "All notes cleared." };
+              }
+              if (action === "search") {
+                const q = String(args["content"] ?? "").toLowerCase();
+                const matches = notes2.filter((n2) => n2.content.toLowerCase().includes(q));
+                return { success: true, output: matches.length ? matches.map((n2) => `[${n2.category}] ${n2.content}`).join("\n") : "No matching notes." };
+              }
+              if (notes2.length === 0) {
+                return { success: true, output: "No working notes yet." };
+              }
+              return { success: true, output: notes2.map((n2) => `[${n2.category}] ${n2.content}`).join("\n") };
+            } catch (err) {
+              return { success: false, output: "", error: String(err) };
+            }
+          }
+        };
+      }
       createTaskCompleteTool() {
         return {
           name: "task_complete",
@@ -588832,6 +589070,8 @@ ${files.map((f2) => `- [\`${f2}\`](./${f2})`).join("\n")}
           parameters: t2.parameters,
           execute: t2.execute.bind(t2)
         }));
+        tools.push(this.createDreamTodoWriteTool());
+        tools.push(this.createDreamWorkingNotesTool());
         tools.push({
           name: "task_complete",
           description: "Signal consolidation is done. Args: {summary: string}",

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "open-agents-ai",
-  "version": "0.187.587",
+  "version": "0.187.589",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "open-agents-ai",
-      "version": "0.187.587",
+      "version": "0.187.589",
       "hasInstallScript": true,
       "license": "CC-BY-NC-4.0",
       "dependencies": {
@@ -1914,12 +1914,12 @@
       }
     },
     "node_modules/@types/node": {
-      "version": "25.7.0",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-25.7.0.tgz",
-      "integrity": "sha512-z+pdZyxE+RTQE9AcboAZCb4otwcrvgHD+GlBpPgn0emDVt0ohrTMhAwlr2Wd9nZ+nihhYFxO2pThz3C5qSu2Eg==",
+      "version": "25.8.0",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-25.8.0.tgz",
+      "integrity": "sha512-TCFSk8IZh+iLX1xtksoBVtdmgL+1IX0fC9BeU4QqFSuNdN/K+HUlhqOzEmSYYpZUVsLYcPqc9KX+60iDuninSQ==",
       "license": "MIT",
       "dependencies": {
-        "undici-types": "~7.21.0"
+        "undici-types": ">=7.24.0 <7.24.7"
       }
     },
     "node_modules/@types/sinon": {
@@ -6994,9 +6994,9 @@
       }
     },
     "node_modules/undici-types": {
-      "version": "7.21.0",
-      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.21.0.tgz",
-      "integrity": "sha512-w9IMgQrz4O0YN1LtB7K5P63vhlIOvC7opSmouCJ+ZywlPAlO9gIkJ+otk6LvGpAs2wg4econaCz3TvQ9xPoyuQ==",
+      "version": "7.24.6",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.24.6.tgz",
+      "integrity": "sha512-WRNW+sJgj5OBN4/0JpHFqtqzhpbnV0GuB+OozA9gCL7a993SmU+1JBZCzLNxYsbMfIeDL+lTsphD5jN5N+n0zg==",
       "license": "MIT"
     },
     "node_modules/unlimited-timeout": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "open-agents-ai",
-  "version": "0.187.587",
+  "version": "0.187.589",
   "description": "AI coding agent powered by open-source models (Ollama/vLLM) — interactive TUI with agentic tool-calling loop",
   "type": "module",
   "main": "./dist/index.js",