open-agents-ai 0.187.206 → 0.187.207

package/dist/index.js

@@ -268905,6 +268905,36 @@ function getSystemPromptForTier(tier) {
       return SYSTEM_PROMPT;
   }
 }
+function computeTodoReminder(input) {
+  const turnsSinceWriteThreshold = input.turnsSinceWriteThreshold ?? 10;
+  const turnsBetweenReminders = input.turnsBetweenReminders ?? 10;
+  if (!input.todos || input.todos.length === 0) {
+    return { shouldInject: false, content: null, reason: "no_todos" };
+  }
+  if (input.lastTodoWriteTurn >= 0) {
+    const turnsSinceWrite = input.currentTurn - input.lastTodoWriteTurn;
+    if (turnsSinceWrite < turnsSinceWriteThreshold) {
+      return { shouldInject: false, content: null, reason: "recent_write" };
+    }
+  } else if (input.currentTurn < turnsSinceWriteThreshold) {
+    return { shouldInject: false, content: null, reason: "too_early" };
+  }
+  if (input.lastReminderTurn >= 0) {
+    const turnsSinceReminder = input.currentTurn - input.lastReminderTurn;
+    if (turnsSinceReminder < turnsBetweenReminders) {
+      return { shouldInject: false, content: null, reason: "recent_reminder" };
+    }
+  }
+  const todoItems = input.todos.slice(0, 12).map((t2, i2) => `${i2 + 1}. [${t2.status}] ${t2.content}`).join("\n");
+  const content = `<system-reminder>
+The todo_write tool hasn't been used recently. If you're working on tasks that would benefit from tracking progress, consider using todo_write to track your progress. Mark the current task in_progress and future tasks pending. When you complete a task, mark it completed immediately \u2014 don't batch completions. Also consider cleaning up the todo list if it has become stale and no longer matches what you are working on. Only use it if it's relevant to the current work. This is just a gentle reminder \u2014 ignore if not applicable. Make sure that you NEVER mention this reminder to the user.
+
+Here are the existing contents of your todo list:
+
+${todoItems}
+</system-reminder>`;
+  return { shouldInject: true, content, reason: "injected" };
+}
 var SYSTEM_PROMPT, SYSTEM_PROMPT_MEDIUM, SYSTEM_PROMPT_SMALL, AgenticRunner, OllamaAgenticBackend;
 var init_agenticRunner = __esm({
   "packages/orchestrator/dist/agenticRunner.js"() {
@@ -269227,30 +269257,65 @@ ${graphSummary}`,
        *
        * Max ~300 tokens to avoid context bloat.
        */
-      buildPlanSkeleton() {
-        const ts = this._taskState;
-        const parts = [];
+      /**
+       * WO-META-TRACK — Read the authoritative todo list from disk.
+       * Returns null if no session id OR no file. Used by buildPlanSkeleton
+       * and by the turn-counter reminder.
+       */
+      readSessionTodos() {
         try {
           const sid = process.env["OA_SESSION_ID"] || this._sessionId || "default";
           const safe = sid.replace(/[^a-zA-Z0-9_.-]/g, "_");
           const fp = _pathJoin(_osHomedir(), ".open-agents", "todos", `${safe}.json`);
-          if (_fsExistsSync(fp)) {
-            const todos = JSON.parse(_fsReadFileSync(fp, "utf-8"));
-            if (Array.isArray(todos) && todos.length > 0) {
-              const lines = todos.slice(0, 12).map((t2) => {
-                const mark = t2.status === "completed" ? "[x]" : t2.status === "in_progress" ? "[~]" : t2.status === "blocked" ? "[!]" : "[ ]";
-                const blocker = t2.blocker ? ` (blocked: ${t2.blocker.slice(0, 40)})` : "";
-                return `${mark} ${t2.content.slice(0, 80)}${blocker}`;
-              });
-              const completedN = todos.filter((t2) => t2.status === "completed").length;
-              const totalN = todos.length;
-              parts.push(`## CURRENT TODO LIST (${completedN}/${totalN} complete)
-` + lines.join("\n") + `
-
-Continue with the current in_progress item. When you finish it, call todo_write to mark it completed and the next one in_progress.`);
+          if (!_fsExistsSync(fp))
+            return null;
+          const parsed = JSON.parse(_fsReadFileSync(fp, "utf-8"));
+          return Array.isArray(parsed) ? parsed : null;
+        } catch {
+          return null;
+        }
+      }
+      /** Track the turn index of the last todo_write call so the reminder
+       *  path can compute `turnsSinceLastTodoWrite` cheaply without walking
+       *  the entire messages array. Reset on run(). */
+      _lastTodoWriteTurn = -1;
+      _lastTodoReminderTurn = -1;
+      /**
+       * WO-META-TRACK — Hannover-style turn-counter reminder.
+       *
+       * Delegates to the pure `computeTodoReminder` function so the gating
+       * logic is independently testable without instantiating a backend.
+       * Mutates `_lastTodoReminderTurn` when a reminder is produced.
+       */
+      getTodoReminderContent(currentTurn) {
+        const todos = this.readSessionTodos();
+        const result = computeTodoReminder({
+          currentTurn,
+          lastTodoWriteTurn: this._lastTodoWriteTurn,
+          lastReminderTurn: this._lastTodoReminderTurn,
+          todos
+        });
+        if (result.shouldInject) {
+          this._lastTodoReminderTurn = currentTurn;
+          return result.content;
+        }
+        return null;
+      }
+      buildPlanSkeleton() {
+        const ts = this._taskState;
+        const parts = [];
+        const todos = this.readSessionTodos();
+        if (todos && todos.length > 0) {
+          const current = todos.find((t2) => t2.status === "in_progress");
+          const completedN = todos.filter((t2) => t2.status === "completed").length;
+          if (current) {
+            parts.push(`[plan: ${completedN}/${todos.length} complete \xB7 currently: ${current.content.slice(0, 80)}]`);
+          } else {
+            const nextPending = todos.find((t2) => t2.status === "pending");
+            if (nextPending) {
+              parts.push(`[plan: ${completedN}/${todos.length} complete \xB7 next: ${nextPending.content.slice(0, 80)}]`);
             }
           }
-        } catch {
         }
         if (ts.goal || ts.completedSteps.length > 0) {
           const done = ts.completedSteps.slice(-5).map((s2) => s2.slice(0, 60));
@@ -269731,6 +269796,8 @@ TASK: ${task}` : task;
         this._selfConsistencyVotes = 0;
         this._retrievalContextCache = null;
         this._loopBlockedTools = void 0;
+        this._lastTodoWriteTurn = -1;
+        this._lastTodoReminderTurn = -1;
         let pendingConstraintWarnings = [];
         let consecutiveTextOnly = 0;
         let loopInterventionCount = 0;
@@ -269813,6 +269880,17 @@ Integrate this guidance into your current approach. Continue working on the task
               timestamp: (/* @__PURE__ */ new Date()).toISOString()
             });
           }
+          {
+            const maybeReminder = this.getTodoReminderContent(turn);
+            if (maybeReminder) {
+              messages2.push({ role: "user", content: maybeReminder });
+              this.emit({
+                type: "status",
+                content: `todo_reminder injected (turn ${turn}, last todo_write turn ${this._lastTodoWriteTurn})`,
+                timestamp: (/* @__PURE__ */ new Date()).toISOString()
+              });
+            }
+          }
           const turnTier = this.options.modelTier ?? "large";
           if (turn === 0 && (turnTier === "small" || turnTier === "medium")) {
             const goal = this._taskState.goal || "";
@@ -270564,6 +270642,9 @@ ${memoryLines.join("\n")}`
               this._taskState.toolCallCount++;
               const filePath = typeof tc.arguments?.path === "string" ? tc.arguments.path : "";
               recordToolExecution(this._appState, tc.name, performance.now() - toolStart, result.success, filePath || void 0);
+              if (tc.name === "todo_write") {
+                this._lastTodoWriteTurn = turn;
+              }
               if (tc.name === "file_read" || tc.name === "list_directory" || tc.name === "find_files" || tc.name === "grep_search") {
                 this._taskState.currentStep = `exploring: ${filePath || String(tc.arguments?.pattern ?? tc.arguments?.path ?? "").slice(0, 60)}`;
               } else if (tc.name === "file_write" || tc.name === "file_edit" || tc.name === "batch_edit") {
@@ -276281,6 +276362,7 @@ __export(dist_exports4, {
   cleanScaffolding: () => cleanScaffolding,
   clearTurnState: () => clearTurnState,
   compilePersonalityPrompt: () => compilePersonalityPrompt,
+  computeTodoReminder: () => computeTodoReminder,
   createAppState: () => createAppState,
   createChildAbortController: () => createChildAbortController,
   deleteAgentTaskSidecar: () => deleteAgentTaskSidecar,

package/package.json

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