open-agents-ai 0.187.523 → 0.187.524

package/dist/index.js

@@ -526383,6 +526383,122 @@ Your hypotheses MUST address this specific error, not generic causes.
           return null;
         }
       }
+      /**
+       * REG-61 sliding-window first-edit / sustained-edit nudge.
+       *
+       * Fires when:
+       *   • turn ≥ 4 (give the agent a few turns to orient)
+       *   • EITHER this run has zero creative edits OR the last creative edit
+       *     was ≥ 5 turns ago (re-fires when agent slips back into read mode)
+       *   • there have been ≥ 3 read-class tool calls in the trailing window
+       *     (since the last creative edit)
+       *   • not in the 5-turn cooldown after a previous firing
+       *
+       * Why earlier than REG-44/REG-58: by turn 12 the read habit is locked in
+       * and prompts get ignored. Re-fire-with-cooldown handles the batch524 stax
+       * case where one early file_write satisfied the initial gate, then the
+       * agent spent 22 turns re-reading source. Directive text names the 4 valid
+       * creative-edit tools EXPLICITLY and lists todo_write as NOT counting
+       * (batch524 osm responded to the original directive with todo_write
+       * thinking it qualified). Generic across ecosystems — no manifest/file/
+       * language keywords.
+       *
+       * BFC-61 (root-cause from batch527-midi-solo): refactored from inline
+       * block in the main turn loop into this method so the brute-force
+       * re-engagement inner loop can also invoke it. Without BFC-61, REG-61
+       * stops checking once the runner enters brute-force cycles, allowing
+       * 30+ minutes of read-paralysis (batch527 hit this — 804 consecutive
+       * non-edit calls in brute-force, REG-61 fired 0× in that phase).
+       *
+       * Side effects when firing:
+       *   - bumps `this._reg61CooldownUntilTurn`
+       *   - pushes a system message with the directive into `messages`
+       *   - emits a `status` event with telemetry (turn, reads_in_window, gap)
+       *
+       * State (instance fields, persist across cycles — desired):
+       *   - `_lastFileWriteTurn`: bumped by tool dispatch on creative edits
+       *   - `_reg61CooldownUntilTurn`: bumped by this method when firing
+       *
+       * @param turn - Current turn counter from the enclosing loop. In
+       *               brute-force cycles this resets to 0 each cycle, but the
+       *               cooldown / lastFileWriteTurn state is retained across
+       *               cycles via instance fields, so behavior is consistent.
+       * @param toolCallLog - Append-only ordered tool-call history.
+       * @param messages - Conversation history to inject the system directive into.
+       * @param cycleLabel - Optional label to disambiguate brute-force fires
+       *               from main-loop fires in the status emit (e.g. "bf-cycle 2").
+       */
+      _runReg61Check(turn, toolCallLog, messages2, cycleLabel) {
+        const REG61_TURN_FLOOR = 4;
+        const REG61_MIN_READS = 3;
+        const REG61_NO_WRITE_GAP = 5;
+        const REG61_COOLDOWN = 5;
+        if (process.env["OA_DISABLE_REG61"] === "1")
+          return;
+        if (turn < REG61_TURN_FLOOR)
+          return;
+        if (turn <= this._reg61CooldownUntilTurn)
+          return;
+        const _writeGate = this._lastFileWriteTurn < 0 || turn - this._lastFileWriteTurn >= REG61_NO_WRITE_GAP;
+        if (!_writeGate)
+          return;
+        const _readClassNames = /* @__PURE__ */ new Set([
+          "file_read",
+          "file_explore",
+          "list_directory",
+          "grep_search",
+          "glob_find",
+          "find_files",
+          "code_neighbors",
+          "repo_map",
+          "codebase_map",
+          "semantic_map",
+          "symbol_search",
+          "todo_read",
+          "memory_read",
+          "memory_search"
+        ]);
+        const _editClassNames = /* @__PURE__ */ new Set([
+          "file_write",
+          "file_edit",
+          "batch_edit",
+          "file_patch"
+        ]);
+        let _readsInWindow = 0;
+        for (let k = toolCallLog.length - 1; k >= 0; k--) {
+          const _name = toolCallLog[k].name;
+          if (_editClassNames.has(_name))
+            break;
+          if (_readClassNames.has(_name))
+            _readsInWindow++;
+        }
+        if (_readsInWindow < REG61_MIN_READS)
+          return;
+        this._reg61CooldownUntilTurn = turn + REG61_COOLDOWN;
+        const _gapDesc = this._lastFileWriteTurn < 0 ? `no creative edits yet this run` : `${turn - this._lastFileWriteTurn} turns since last creative edit (turn ${this._lastFileWriteTurn})`;
+        const reg61Msg = `[FIRST-EDIT NUDGE — REG-61]
+You have made ${_readsInWindow} read/exploration calls in the trailing window — ${_gapDesc}. Reading is preparation; writing is progress. Runs that stay in pure-read mode produce zero deliverables.
+
+Your NEXT tool call MUST be EXACTLY ONE of:
+  • file_write   — create a new file
+  • file_edit    — modify an existing file (find/replace)
+  • batch_edit   — multiple find/replace edits in one call
+  • file_patch   — apply a unified diff
+
+These are the ONLY four tools that count as creative edits. The following do NOT count and will NOT satisfy this directive:
+  • todo_write    (only updates the todo list, not the filesystem)
+  • memory_write  (writes to memory store, not the project)
+  • list_directory / file_read / file_explore / grep_search / shell
+
+Pick the SMALLEST concrete deliverable from the spec — typically the project entry point or the file most other modules depend on. Write a stub or skeleton if the full implementation is too large; you can iterate later. Do NOT issue another read or todo update before producing the next file_write/file_edit/batch_edit/file_patch.`;
+        messages2.push({ role: "system", content: reg61Msg });
+        const _cyclePart = cycleLabel ? ` (${cycleLabel})` : "";
+        this.emit({
+          type: "status",
+          content: `REG-61 FIRST-EDIT NUDGE — fired at turn ${turn}${_cyclePart}; reads_in_window=${_readsInWindow}; ${_gapDesc}`,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        });
+      }
       readSessionTodos() {
         try {
           const sid = process.env["OA_SESSION_ID"] || this._sessionId || "default";
@@ -528620,70 +528736,7 @@ TASK: ${task}` : task;
               timestamp: (/* @__PURE__ */ new Date()).toISOString()
             });
           }
-          const REG61_TURN_FLOOR = 4;
-          const REG61_MIN_READS = 3;
-          const REG61_NO_WRITE_GAP = 5;
-          const REG61_COOLDOWN = 5;
-          if (turn >= REG61_TURN_FLOOR && turn > this._reg61CooldownUntilTurn && process.env["OA_DISABLE_REG61"] !== "1") {
-            const _writeGate = this._lastFileWriteTurn < 0 || turn - this._lastFileWriteTurn >= REG61_NO_WRITE_GAP;
-            if (_writeGate) {
-              const _readClassNames = /* @__PURE__ */ new Set([
-                "file_read",
-                "file_explore",
-                "list_directory",
-                "grep_search",
-                "glob_find",
-                "find_files",
-                "code_neighbors",
-                "repo_map",
-                "codebase_map",
-                "semantic_map",
-                "symbol_search",
-                "todo_read",
-                "memory_read",
-                "memory_search"
-              ]);
-              let _readsInWindow = 0;
-              const _editClassNames = /* @__PURE__ */ new Set([
-                "file_write",
-                "file_edit",
-                "batch_edit",
-                "file_patch"
-              ]);
-              for (let k = toolCallLog.length - 1; k >= 0; k--) {
-                const _name = toolCallLog[k].name;
-                if (_editClassNames.has(_name))
-                  break;
-                if (_readClassNames.has(_name))
-                  _readsInWindow++;
-              }
-              if (_readsInWindow >= REG61_MIN_READS) {
-                this._reg61CooldownUntilTurn = turn + REG61_COOLDOWN;
-                const _gapDesc = this._lastFileWriteTurn < 0 ? `no creative edits yet this run` : `${turn - this._lastFileWriteTurn} turns since last creative edit (turn ${this._lastFileWriteTurn})`;
-                const reg61Msg = `[FIRST-EDIT NUDGE — REG-61]
-You have made ${_readsInWindow} read/exploration calls in the trailing window — ${_gapDesc}. Reading is preparation; writing is progress. Runs that stay in pure-read mode produce zero deliverables.
-
-Your NEXT tool call MUST be EXACTLY ONE of:
-  • file_write   — create a new file
-  • file_edit    — modify an existing file (find/replace)
-  • batch_edit   — multiple find/replace edits in one call
-  • file_patch   — apply a unified diff
-
-These are the ONLY four tools that count as creative edits. The following do NOT count and will NOT satisfy this directive:
-  • todo_write    (only updates the todo list, not the filesystem)
-  • memory_write  (writes to memory store, not the project)
-  • list_directory / file_read / file_explore / grep_search / shell
-
-Pick the SMALLEST concrete deliverable from the spec — typically the project entry point or the file most other modules depend on. Write a stub or skeleton if the full implementation is too large; you can iterate later. Do NOT issue another read or todo update before producing the next file_write/file_edit/batch_edit/file_patch.`;
-                messages2.push({ role: "system", content: reg61Msg });
-                this.emit({
-                  type: "status",
-                  content: `REG-61 FIRST-EDIT NUDGE — fired at turn ${turn}; reads_in_window=${_readsInWindow}; ${_gapDesc}`,
-                  timestamp: (/* @__PURE__ */ new Date()).toISOString()
-                });
-              }
-            }
-          }
+          this._runReg61Check(turn, toolCallLog, messages2);
           const REG58_NO_WRITE_BUDGET = 30;
           if (turn > stagnationCooldownUntilTurn && this._lastFileWriteTurn >= 0 && turn - this._lastFileWriteTurn >= REG58_NO_WRITE_BUDGET && process.env["OA_DISABLE_REG58"] !== "1") {
             const gap = turn - this._lastFileWriteTurn;
@@ -532118,6 +532171,7 @@ Your most recent tool calls SUCCEEDED. If the task is complete, call task_comple
             content: `Re-engaging — cycle ${bruteForceCycle} (${totalTurns} turns, ${toolCallCount} tool calls so far)`,
             timestamp: (/* @__PURE__ */ new Date()).toISOString()
           });
+          this._reg61CooldownUntilTurn = -1;
           messages2.push({
             role: "user",
             content: `[CONTINUATION — Cycle ${bruteForceCycle}]
@@ -532151,6 +532205,7 @@ You have ${this.options.maxTurns} more turns. Continue making progress. Call tas
               this.emit({ type: "error", content: "Task aborted by user", timestamp: (/* @__PURE__ */ new Date()).toISOString() });
               break;
             }
+            this._runReg61Check(turn, toolCallLog, messages2, `bf-cycle ${bruteForceCycle}`);
             const bfNow = Date.now();
             if (bfNow > nextSelfEval) {
               selfEvalCount++;

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "open-agents-ai",
-  "version": "0.187.523",
+  "version": "0.187.524",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "open-agents-ai",
-      "version": "0.187.523",
+      "version": "0.187.524",
       "hasInstallScript": true,
       "license": "CC-BY-NC-4.0",
       "dependencies": {

package/package.json

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