@molecule/api-ai-tools 1.17.8 → 1.17.10

package/README.md

@@ -3,7 +3,7 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
 Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
 Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
 To change this document, edit the module-level JSDoc in src/index.ts.
-Generated: 2026-11-08T00:13:16.790Z
+Generated: 2026-11-09T14:59:02.031Z
 -->
 
 # @molecule/api-ai-tools
@@ -6042,7 +6042,11 @@ Peer dependencies:
   execution. `commandStepView` reads the active step for diagnostics; `logicalCommandText`
   exposes the planned commands for static classification. Preserve the descriptor when
   wrapping again. The metadata is advisory and never establishes a completed test result.
-- **`yieldOnFirstFailureFor`** can yield one still-running deployed task's concrete diagnostic; callers opt out after a prior wait result or unknown history.
+- **`yieldOnFirstFailureFor`** lets `wait_for_task` yield new final-failure causes from a
+  still-running deployed task. Fix while it walks; once every known cause is fixed, deploy
+  now, let the task keep finding causes until the deploy lands and stops it, then collect
+  its stopped or completed result with `wait_for_task`. A local diagnostic tests mutable
+  source: collect or stop it before editing that source, since edits invalidate its result.
 - **`wait_for_task` state probes report current progress without guessing log growth.**
   A call shorter than one normal two-second poll omits both growth and no-growth
   claims; task age, log counters and time-left estimates remain available.

package/dist/index.d.ts

@@ -35,7 +35,11 @@
  *   execution. `commandStepView` reads the active step for diagnostics; `logicalCommandText`
  *   exposes the planned commands for static classification. Preserve the descriptor when
  *   wrapping again. The metadata is advisory and never establishes a completed test result.
- * - **`yieldOnFirstFailureFor`** can yield one still-running deployed task's concrete diagnostic; callers opt out after a prior wait result or unknown history.
+ * - **`yieldOnFirstFailureFor`** lets `wait_for_task` yield new final-failure causes from a
+ *   still-running deployed task. Fix while it walks; once every known cause is fixed, deploy
+ *   now, let the task keep finding causes until the deploy lands and stops it, then collect
+ *   its stopped or completed result with `wait_for_task`. A local diagnostic tests mutable
+ *   source: collect or stop it before editing that source, since edits invalidate its result.
  * - **`wait_for_task` state probes report current progress without guessing log growth.**
  *   A call shorter than one normal two-second poll omits both growth and no-growth
  *   claims; task age, log counters and time-left estimates remain available.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8KG;AAEH,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA;AACrC,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,0BAA0B,CAAA;AACxC,cAAc,oCAAoC,CAAA;AAClD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,wBAAwB,CAAA;AACtC,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA;AAC1B,cAAc,sBAAsB,CAAA;AACpC,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkLG;AAEH,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA;AACrC,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,0BAA0B,CAAA;AACxC,cAAc,oCAAoC,CAAA;AAClD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,wBAAwB,CAAA;AACtC,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA;AAC1B,cAAc,sBAAsB,CAAA;AACpC,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA"}

package/dist/index.js

@@ -35,7 +35,11 @@
  *   execution. `commandStepView` reads the active step for diagnostics; `logicalCommandText`
  *   exposes the planned commands for static classification. Preserve the descriptor when
  *   wrapping again. The metadata is advisory and never establishes a completed test result.
- * - **`yieldOnFirstFailureFor`** can yield one still-running deployed task's concrete diagnostic; callers opt out after a prior wait result or unknown history.
+ * - **`yieldOnFirstFailureFor`** lets `wait_for_task` yield new final-failure causes from a
+ *   still-running deployed task. Fix while it walks; once every known cause is fixed, deploy
+ *   now, let the task keep finding causes until the deploy lands and stops it, then collect
+ *   its stopped or completed result with `wait_for_task`. A local diagnostic tests mutable
+ *   source: collect or stop it before editing that source, since edits invalidate its result.
  * - **`wait_for_task` state probes report current progress without guessing log growth.**
  *   A call shorter than one normal two-second poll omits both growth and no-growth
  *   claims; task age, log counters and time-left estimates remain available.

package/dist/tools.js

@@ -3802,7 +3802,7 @@ export function buildTools(backend, config) {
                         // deployed run it belongs to can no longer pass and a local edit cannot void a green
                         // proof. Keep discovering causes during the repair, then replace the failed build:
                         // waiting after its known causes were fixed cost l1671 another 295 s without learning
-                        // another cause. Retirement must precede replacement so no walk mixes builds or data.
+                        // another cause. The landed deploy stops this walk before the next one starts.
                         note: localDiagnostic
                             ? 'A test in this local diagnostic has failed on its final attempt. This is partial ' +
                                 'output, not a completed result; the task is still running against mutable local source. ' +
@@ -3827,9 +3827,9 @@ export function buildTools(backend, config) {
                                 'pass. This is partial log output, not a completed result: leave the task running while you fix ' +
                                 'and collect any new causes it exposes. Local edits do not change this deployed ' +
                                 'build, so start on this failure now: read the failing spec and the code it drives, ' +
-                                'and fix it while the run keeps walking. Once every known cause is fixed, deploy now ' +
-                                'rather than waiting for this failed walk to finish. The deploy must retire this task before replacing the build; ' +
-                                'collect its stopped or completed result with `wait_for_task`. Do not start a second test run while this task is running. ' +
+                                'and fix it while the run keeps walking. Once every known cause is fixed, deploy now; ' +
+                                'the task keeps finding causes until the deploy lands and stops it, then collect its stopped or completed result ' +
+                                'with `wait_for_task`. Do not start a second test run while this task is running. ' +
                                 'Its remaining tests stay unmeasured; hand-back still requires the full supplied suite against the new deployed build to pass with its own settings.',
                     };
                 }

package/dist/utilities.js

@@ -2784,7 +2784,7 @@ export function runningLogReadCommand(log, own) {
  *   read did not run, so nothing may be said about the log).
  */
 export function parseRunningLogRead(stdout) {
-    const sized = /^\s*(\d+)\s*\n/.exec(stdout);
+    const sized = /^[\t ]*(\d+)[\t ]*\r?\n/.exec(stdout);
     if (sized === null)
         return null;
     return { text: stdout.slice(sized[0].length), bytes: Number(sized[1]) };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/api-ai-tools",
-  "version": "1.17.8",
+  "version": "1.17.10",
   "description": "Shared AI agent tools with backend abstraction for sandbox and local execution",
   "type": "module",
   "main": "dist/index.js",