@molecule/api-ai-tools 1.9.7 → 1.9.9

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-10-18T00:28:51.925Z
+Generated: 2026-10-18T04:56:57.682Z
 -->
 
 # @molecule/api-ai-tools
@@ -187,6 +187,14 @@ interface CutRun {
   seconds: number
   /** Whether this tool's budget stopped it or the `timeout` the command carried. */
   stoppedBy: CutBy
+  /**
+   * Whether this was a detached background task, read with no budget of this tool's own
+   * ({@link commandCutRun}'s `budgetSeconds` is 0). A background run is bounded by what its own
+   * command carries — so a `command-timeout` cut there is that prefix killing the walk, and the
+   * executor must be told to drop the prefix, never to start the run in the background it is
+   * already in (X1 xr-molecule-flash-m143 +24:45).
+   */
+  background: boolean
   /**
    * The exit code the run's own process reported, or null when the code in the result belongs to
    * the pipeline's filter (`… | tail`) rather than to the run — the case that read as success.
@@ -270,6 +278,25 @@ interface GuardOptions {
 }
 ```
 
+#### `RunnerOutputFilter`
+
+A cutting stage that follows the runner, and the command with the whole pipe removed.
+
+```typescript
+interface RunnerOutputFilter {
+  /** The stage exactly as the runner's command wrote it — `tail -6`. */
+  stage: string
+  /** The pipe as a sentence names it — `| tail -6`. */
+  pipe: string
+  /**
+   * The command with the pipe and the stage removed — `hurl --variable uid=… --test /tmp/t.hurl
+   * 2>&1`. This is a command to send again as written, not a re-typing of it: it is a slice of the
+   * original with the filter's own range cut out, so every other word, quote and redirect stays.
+   */
+  command: string
+}
+```
+
 #### `ToolSchema`
 
 JSON-schema-backed definition for a single agent tool.
@@ -1020,6 +1047,35 @@ function commandTimeoutSeconds(command: string): number | null
 
 **Returns:** The seconds the command allows itself, or null.
 
+#### `withoutTimeoutWrapper(command, which)`
+
+The command with the `timeout <N>` wrapper lifted off the statements `which` selects, and the
+largest bound that was lifted.
+
+The platform moves a run to the background precisely because its own bound cannot fit this
+tool's ceiling, and a background task has no ceiling — its wait is bounded by `wait_for_task`
+and the turn's deadline. The `timeout N` an executor wrote to fit the ceiling therefore keeps
+killing the run at N in the background, where nothing needed it: X1 xr-molecule-flash-m143
+(+24:45) wrote `timeout 280` for a 31-test walk, the tool backgrounded it, and the prefix stopped
+the walk with no tally — then the cut sentence told the executor to "run it in the background",
+which is where it already was.
+
+The wrapper is found by the same parse every other command reader uses ({@link commandStart}):
+`timeout` in an argument bounds nothing, and the wrapper's own flags (`-k`/`--kill-after`,
+`-s`/`--signal`) are stepped over, so `timeout -k 5 280 …` is `280`.
+
+```typescript
+function withoutTimeoutWrapper(
+  command: string,
+  which: (segment: CommandSegment) => boolean,
+): { command: string; seconds: number | null }
+```
+
+- `command` — The shell command.
+- `which` — The statements to lift the wrapper from (a suite run, for the background path).
+
+**Returns:** The rewritten command, and the largest lifted bound (null when nothing was lifted).
+
 #### `runsInCommandPosition(command, pattern)`
 
 Whether any segment of the command runs a program whose command-position text matches
@@ -1296,6 +1352,28 @@ function guardAITool(tool: T, options?: GuardOptions): T
 
 **Returns:** A copy with a guarded `execute`.
 
+#### `diffLineCount(oldLines, newLines)`
+
+Count truly added/removed lines between two line arrays using LCS.
+
+Bounded by construction, so a whole-file edit cannot allocate a quadratic
+table here: the longest common prefix and suffix are trimmed first (exact —
+those lines belong to every optimal diff, and on the usual small edit they
+shrink the table to the edited span), and what is left is capped (see
+{@link lcsLength}).
+
+```typescript
+function diffLineCount(
+  oldLines: readonly string[],
+  newLines: readonly string[],
+): { added: number; removed: number }
+```
+
+- `oldLines` — The original lines array.
+- `newLines` — The modified lines array.
+
+**Returns:** An object with the number of added and removed lines.
+
 #### `commandRunsNoTests(command)`
 
 Whether a shell command invokes a test runner and EVERY such invocation only prints — so the
@@ -1323,6 +1401,27 @@ function commandRunsNoTests(command: string): boolean
 
 **Returns:** True when the command invokes a runner only to print.
 
+#### `outputFilterAfterRunner(command, runs)`
+
+The output filter that follows the runner in `command`, or null when there is none.
+
+Only a stage of the runner's OWN pipeline counts (its separator is `|`), and only when it is the
+LAST stage of that pipeline: a `| grep … | wc -l` chain would leave a dangling pipe if the
+middle stage were cut out, so a chain is not answered here at all. A filter before the runner
+(`cat run.log | tail -20 && hurl …`) reads something else's output and is not this.
+
+```typescript
+function outputFilterAfterRunner(
+  command: string,
+  runs: (segment: CommandSegment) => boolean,
+): RunnerOutputFilter | null
+```
+
+- `command` — The command as the executor sent it.
+- `runs` — Whether a segment is the runner this run is about (the caller knows its own kind: {@link CommandSegment.program} is the program, once wrapper words like `timeout 280` and `npx` are taken away).
+
+**Returns:** The filter and the unfiltered command, or null.
+
 #### `pipelineExitCodeNote(command, exitCode, output)`
 
 The sentence an `exec_command` result carries beside `exitCode` when the code belongs to a
@@ -1780,7 +1879,7 @@ function stalledDocumentSubresource(request: TraceRequest): boolean
 
 **Returns:** True when the request is a document subresource that never finished.
 
-#### `failureTraceNote(items, target, earlierFailures)`
+#### `failureTraceNote(items, target, earlierFailures, apiPrefixes)`
 
 The note a failed suite run's result carries: what each failing test's page actually sent, and
 what came back.
@@ -1811,12 +1910,14 @@ function failureTraceNote(
   items: readonly TraceArtifact[],
   target: string,
   earlierFailures?: readonly string[],
+  apiPrefixes?: readonly string[],
 ): string | null
 ```
 
 - `items` — The traces {@link parseTraceArtifacts} read.
 - `target` — Where the run went — the deployed host, as the note names it.
 - `earlierFailures` — The failing `file:line`s earlier walks of this suite left, so a repeat is ranked above a one-off. Empty when the caller knows of no earlier walk.
+- `apiPrefixes` — The API path prefixes the app's client config names (`['/api']`), read from the app by the caller. Empty when the caller could not read one; the traces' own requests may still supply it. Never a hard-coded literal.
 
 **Returns:** The note, or null when no trace held a recorded response, a real failure or a console error.
 
@@ -2075,6 +2176,24 @@ function isSuiteRunCommand(command: string): boolean
 
 **Returns:** True when the command starts one of those runners.
 
+#### `withoutSuiteTimeout(command)`
+
+The command with the `timeout <N>` wrapper lifted off the statement that runs the suite, and the
+bound that was lifted.
+
+Used where the platform moves a run to the background: the executor wrote the bound to fit this
+tool's foreground ceiling, and in the background that ceiling no longer applies — the task is
+bounded by `wait_for_task` and the turn's deadline — so the prefix only kills the walk
+({@link withoutTimeoutWrapper}; X1 xr-molecule-flash-m143 +24:45).
+
+```typescript
+function withoutSuiteTimeout(command: string): { command: string; seconds: number | null }
+```
+
+- `command` — The shell command.
+
+**Returns:** The rewritten command, and the largest lifted bound (null when nothing was lifted).
+
 #### `isPlaywrightRunCommand(command)`
 
 Whether a command starts a Playwright run — a `playwright test` in command position, in a form

package/dist/command-position.d.ts

@@ -172,6 +172,30 @@ export declare function statementArgumentEnd(command: string, start: number | nu
  * @returns The seconds the command allows itself, or null.
  */
 export declare function commandTimeoutSeconds(command: string): number | null;
+/**
+ * The command with the `timeout <N>` wrapper lifted off the statements `which` selects, and the
+ * largest bound that was lifted.
+ *
+ * The platform moves a run to the background precisely because its own bound cannot fit this
+ * tool's ceiling, and a background task has no ceiling — its wait is bounded by `wait_for_task`
+ * and the turn's deadline. The `timeout N` an executor wrote to fit the ceiling therefore keeps
+ * killing the run at N in the background, where nothing needed it: X1 xr-molecule-flash-m143
+ * (+24:45) wrote `timeout 280` for a 31-test walk, the tool backgrounded it, and the prefix stopped
+ * the walk with no tally — then the cut sentence told the executor to "run it in the background",
+ * which is where it already was.
+ *
+ * The wrapper is found by the same parse every other command reader uses ({@link commandStart}):
+ * `timeout` in an argument bounds nothing, and the wrapper's own flags (`-k`/`--kill-after`,
+ * `-s`/`--signal`) are stepped over, so `timeout -k 5 280 …` is `280`.
+ *
+ * @param command - The shell command.
+ * @param which - The statements to lift the wrapper from (a suite run, for the background path).
+ * @returns The rewritten command, and the largest lifted bound (null when nothing was lifted).
+ */
+export declare function withoutTimeoutWrapper(command: string, which: (segment: CommandSegment) => boolean): {
+    command: string;
+    seconds: number | null;
+};
 /**
  * Whether any segment of the command runs a program whose command-position text matches
  * `pattern` — the one question a runner-kind table asks.

package/dist/command-position.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-position.d.ts","sourceRoot":"","sources":["../src/command-position.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,uFAAuF;AACvF,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IACf,qFAAqF;IACrF,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IACvB,4FAA4F;IAC5F,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAqND;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM3D;AAmjBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAIjE;AAmCD;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,OAAO,EAAE,cAAc,GAAG,IAAI,CAAA;IAC9B,0FAA0F;IAC1F,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9B;;;;OAIG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB;;;;;OAKG;IACH,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B;;;OAGG;IACH,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB;;;;OAIG;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB;;;;;OAKG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,EAAE,CAE/E;AAmDD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,GAAG,EAAE,MAAM,GAAG,IAAI,GACjB,MAAM,GAAG,IAAI,CAyDf;AAwFD;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAK/E"}
+{"version":3,"file":"command-position.d.ts","sourceRoot":"","sources":["../src/command-position.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,uFAAuF;AACvF,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IACf,qFAAqF;IACrF,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IACvB,4FAA4F;IAC5F,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAqND;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM3D;AAmjBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAIjE;AAmCD;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,OAAO,EAAE,cAAc,GAAG,IAAI,CAAA;IAC9B,0FAA0F;IAC1F,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9B;;;;OAIG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB;;;;;OAKG;IACH,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B;;;OAGG;IACH,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB;;;;OAIG;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB;;;;;OAKG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,EAAE,CAE/E;AAmDD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,GAAG,EAAE,MAAM,GAAG,IAAI,GACjB,MAAM,GAAG,IAAI,CAyDf;AAwFD;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOpE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,GAC1C;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAoD7C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAK/E"}

package/dist/command-position.js

@@ -1076,6 +1076,87 @@ export function commandTimeoutSeconds(command) {
     }
     return bound;
 }
+/**
+ * The command with the `timeout <N>` wrapper lifted off the statements `which` selects, and the
+ * largest bound that was lifted.
+ *
+ * The platform moves a run to the background precisely because its own bound cannot fit this
+ * tool's ceiling, and a background task has no ceiling — its wait is bounded by `wait_for_task`
+ * and the turn's deadline. The `timeout N` an executor wrote to fit the ceiling therefore keeps
+ * killing the run at N in the background, where nothing needed it: X1 xr-molecule-flash-m143
+ * (+24:45) wrote `timeout 280` for a 31-test walk, the tool backgrounded it, and the prefix stopped
+ * the walk with no tally — then the cut sentence told the executor to "run it in the background",
+ * which is where it already was.
+ *
+ * The wrapper is found by the same parse every other command reader uses ({@link commandStart}):
+ * `timeout` in an argument bounds nothing, and the wrapper's own flags (`-k`/`--kill-after`,
+ * `-s`/`--signal`) are stepped over, so `timeout -k 5 280 …` is `280`.
+ *
+ * @param command - The shell command.
+ * @param which - The statements to lift the wrapper from (a suite run, for the background path).
+ * @returns The rewritten command, and the largest lifted bound (null when nothing was lifted).
+ */
+export function withoutTimeoutWrapper(command, which) {
+    if (typeof command !== 'string' || !command.trim())
+        return { command, seconds: null };
+    /** The spans to remove, as offsets in the command — applied back to front. */
+    const removals = [];
+    let seconds = null;
+    for (const located of locatedSegmentsOf(command, 0)) {
+        const segment = located.segment;
+        if (segment === null || segment.timeoutSeconds === null)
+            continue;
+        // A statement inside a nested `sh -c '…'` has no offsets here: its positions are positions in
+        // that string, so nothing may be spliced at them.
+        if (located.start === null || located.programOffset === null)
+            continue;
+        if (!which(segment))
+            continue;
+        // Every word in front of the program: the assignments and the wrappers. The duration belongs
+        // to the wrapper, so the walk has to see the words, not just the parse's total bound.
+        const prefix = command.slice(located.start, located.programOffset);
+        const words = [];
+        const at = new RegExp(WORD.source, 'g');
+        for (let match = at.exec(prefix); match !== null; match = at.exec(prefix)) {
+            words.push({
+                text: match[0],
+                start: located.start + match.index,
+                end: located.start + match.index + match[0].length,
+            });
+        }
+        for (let i = 0; i < words.length; i += 1) {
+            const word = words[i];
+            if (word === undefined || programName(word.text) !== 'timeout')
+                continue;
+            // The wrapper's own flags, then the duration — the same walk {@link commandStart} makes.
+            const withValue = WRAPPER_VALUE_FLAGS.timeout ?? [];
+            let next = i + 1;
+            while (next < words.length && (words[next]?.text ?? '').startsWith('-')) {
+                const flag = unquoted(words[next]?.text ?? '');
+                next += !flag.includes('=') && withValue.includes(flag) ? 2 : 1;
+            }
+            const duration = words[next];
+            const bound = duration === undefined ? null : durationSeconds(unquoted(duration.text));
+            if (duration === undefined || bound === null)
+                continue;
+            seconds = seconds === null ? bound : Math.max(seconds, bound);
+            // The whitespace between the duration and the program goes too, so the command does not
+            // carry a double space where the wrapper stood.
+            let end = duration.end;
+            while (end < command.length && /\s/.test(command[end] ?? ''))
+                end += 1;
+            removals.push({ start: word.start, end });
+            i = next;
+        }
+    }
+    if (removals.length === 0)
+        return { command, seconds: null };
+    let out = command;
+    for (const removal of removals.sort((a, b) => b.start - a.start)) {
+        out = out.slice(0, removal.start) + out.slice(removal.end);
+    }
+    return { command: out, seconds };
+}
 /**
  * Whether any segment of the command runs a program whose command-position text matches
  * `pattern` — the one question a runner-kind table asks.

package/dist/cut-run.d.ts

@@ -134,6 +134,14 @@ export interface CutRun {
     seconds: number;
     /** Whether this tool's budget stopped it or the `timeout` the command carried. */
     stoppedBy: CutBy;
+    /**
+     * Whether this was a detached background task, read with no budget of this tool's own
+     * ({@link commandCutRun}'s `budgetSeconds` is 0). A background run is bounded by what its own
+     * command carries — so a `command-timeout` cut there is that prefix killing the walk, and the
+     * executor must be told to drop the prefix, never to start the run in the background it is
+     * already in (X1 xr-molecule-flash-m143 +24:45).
+     */
+    background: boolean;
     /**
      * The exit code the run's own process reported, or null when the code in the result belongs to
      * the pipeline's filter (`… | tail`) rather than to the run — the case that read as success.

package/dist/cut-run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cut-run.d.ts","sourceRoot":"","sources":["../src/cut-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAKH;;;GAGG;AACH,eAAO,MAAM,aAAa,kBAAkB,CAAA;AAE5C,kFAAkF;AAClF,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,OAAO,aAAa,CAAA;AAE1D;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,eAAe,CAGhE;AAiBD;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB,wEAAwE;IACxE,QAAQ,EAAE,OAAO,CAAA;CAClB;AAkDD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CA4B9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAKD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACb,MAAM,GAAG,IAAI,CAIf;AAED,0BAA0B;AAC1B,MAAM,MAAM,KAAK;AACf,sEAAsE;AACpE,aAAa;AACf,oDAAoD;GAClD,iBAAiB;AACnB;;;;GAIG;GACD,cAAc,CAAA;AAElB,wDAAwD;AACxD,MAAM,WAAW,MAAM;IACrB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAA;IACf,kFAAkF;IAClF,SAAS,EAAE,KAAK,CAAA;IAChB;;;OAGG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB;;;OAGG;IACH,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,qCAAqC;IACrC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;IACvB,yEAAyE;IACzE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAsDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,aAAa,SAAI,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAgFf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAgB1D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAuBlD"}
+{"version":3,"file":"cut-run.d.ts","sourceRoot":"","sources":["../src/cut-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAKH;;;GAGG;AACH,eAAO,MAAM,aAAa,kBAAkB,CAAA;AAE5C,kFAAkF;AAClF,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,OAAO,aAAa,CAAA;AAE1D;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,eAAe,CAGhE;AAiBD;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB,wEAAwE;IACxE,QAAQ,EAAE,OAAO,CAAA;CAClB;AAkDD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CA4B9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAKD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACb,MAAM,GAAG,IAAI,CAIf;AAED,0BAA0B;AAC1B,MAAM,MAAM,KAAK;AACf,sEAAsE;AACpE,aAAa;AACf,oDAAoD;GAClD,iBAAiB;AACnB;;;;GAIG;GACD,cAAc,CAAA;AAElB,wDAAwD;AACxD,MAAM,WAAW,MAAM;IACrB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAA;IACf,kFAAkF;IAClF,SAAS,EAAE,KAAK,CAAA;IAChB;;;;;;OAMG;IACH,UAAU,EAAE,OAAO,CAAA;IACnB;;;OAGG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB;;;OAGG;IACH,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,qCAAqC;IACrC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;IACvB,yEAAyE;IACzE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAsDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,aAAa,SAAI,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAuFf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAiB1D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiClD"}

package/dist/cut-run.js

@@ -296,6 +296,9 @@ export function commandCutRun(command, result, elapsedMs, budgetSeconds = 0, raw
     // tool budget at all (a reader re-reading a background run) the command's own bound is the only
     // one there is.
     const ownBoundStops = budgetSeconds === 0 || (declared !== null && declared < budgetSeconds);
+    // No budget of this tool's in force is what a background reader is: the task was detached, and
+    // nothing bounded it but what its own command carries.
+    const background = budgetSeconds === 0;
     // `timeout`'s own 124 — the code the backend's wrapper returns when the TOOL's budget fires,
     // whatever the pipeline ended with (`backends/sandbox.ts`). Which of the two bounds fired is the
     // clock's to say: a run killed at the tool's budget reports at least the budget, and one killed
@@ -308,6 +311,7 @@ export function commandCutRun(command, result, elapsedMs, budgetSeconds = 0, raw
         return {
             seconds: ownFired ? declared : budgetSeconds,
             stoppedBy: ownFired ? 'command-timeout' : 'tool-budget',
+            background,
             exitCode,
             ...progress,
             doing,
@@ -317,6 +321,7 @@ export function commandCutRun(command, result, elapsedMs, budgetSeconds = 0, raw
         return {
             seconds: declared,
             stoppedBy: 'command-timeout',
+            background,
             // A code the filter produced is not the run's: `… | tail` handed back 0 forever (m93).
             exitCode: withheld || exitCode === 0 ? null : exitCode,
             ...progress,
@@ -329,6 +334,7 @@ export function commandCutRun(command, result, elapsedMs, budgetSeconds = 0, raw
         return {
             seconds: budgetSeconds,
             stoppedBy: 'tool-budget',
+            background,
             exitCode: exitCode === 0 ? null : exitCode,
             ...progress,
             doing,
@@ -344,6 +350,7 @@ export function commandCutRun(command, result, elapsedMs, budgetSeconds = 0, raw
         return {
             seconds: usedBudget ? budgetSeconds : Math.max(1, Math.round(elapsedMs / 1000)),
             stoppedBy: usedBudget ? 'tool-budget' : 'process-stop',
+            background,
             exitCode: withheld || exitCode === 0 ? null : exitCode,
             ...progress,
             doing,
@@ -377,6 +384,7 @@ export function cutRunFacts(result) {
     return {
         seconds: c.seconds,
         stoppedBy: c.stoppedBy,
+        background: c.background === true,
         exitCode: typeof c.exitCode === 'number' ? c.exitCode : null,
         ran: typeof c.ran === 'number' ? c.ran : null,
         total: typeof c.total === 'number' ? c.total : null,
@@ -401,9 +409,19 @@ export function cutRunSentence(run) {
     const by = run.stoppedBy === 'tool-budget'
         ? "this tool's limit"
         : run.stoppedBy === 'command-timeout'
-            ? `its own \`timeout ${run.seconds}\``
+            ? run.background
+                ? `the command's own \`timeout ${run.seconds}\`, which killed it at ${run.seconds} s`
+                : `its own \`timeout ${run.seconds}\``
             : 'a process kill outside this tool (no `timeout` of its own and no limit of this tool had fired)';
-    const background = 'run it in the background (run_in_background + wait_for_task)';
+    // What the reader must do next. A run that was ALREADY a background task has nothing to gain
+    // from being sent to the background again — when its own `timeout` is what stopped it, that
+    // prefix is the thing to drop (X1 xr-molecule-flash-m143 +24:45: three cut sentences in one run
+    // told a background walk to "run it in the background", which is where it already was).
+    const background = run.background
+        ? run.stoppedBy === 'command-timeout'
+            ? `drop the \`timeout\` prefix and send it again — in the background a run is bounded by \`wait_for_task\` and the turn's deadline, not by this tool's ceiling, so the bound you wrote is what killed it`
+            : 'send it again when you are ready'
+        : 'run it in the background (run_in_background + wait_for_task)';
     const missing = run.ran !== null && run.total !== null ? run.total - run.ran : null;
     const lead = missing !== null
         ? `Ran ${run.ran} of ${run.total} ${run.noun} in ${run.seconds} s and was stopped by ${by} — the ${missing} it never reached ${missing === 1 ? 'has' : 'have'} not run; ${background}`

package/dist/index.d.ts

@@ -136,7 +136,9 @@ export * from './command-position.js';
 export * from './cut-run.js';
 export * from './failure-kind.js';
 export * from './input-normalizer.js';
+export * from './line-diff.js';
 export * from './no-test-run.js';
+export * from './output-filter.js';
 export * from './pipeline-exit-note.js';
 export * from './schemas.js';
 export * from './sleep-peek.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkIG;AAEH,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,yBAAyB,CAAA;AACvC,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkIG;AAEH,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,sBAAsB,CAAA;AACpC,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA"}

package/dist/index.js

@@ -136,7 +136,9 @@ export * from './command-position.js';
 export * from './cut-run.js';
 export * from './failure-kind.js';
 export * from './input-normalizer.js';
+export * from './line-diff.js';
 export * from './no-test-run.js';
+export * from './output-filter.js';
 export * from './pipeline-exit-note.js';
 export * from './schemas.js';
 export * from './sleep-peek.js';

package/dist/line-diff.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Real added/removed LINE counts for the `diff` a file-writing tool reports.
+ *
+ * The count is a diff, not an arithmetic delta: replacing one line with another
+ * leaves the line count unchanged, so `new.length - old.length` is 0 for the
+ * edit that changed the file — a result that reads to the model as "your write
+ * did nothing" (X0 xr-molecule-flash-m141 +09:56: `write_file` rewrote
+ * `ArticlePreview.tsx`'s favorite label and reported
+ * `"linesAdded":0,"linesRemoved":0`). The lines an edit actually changed are
+ * found with the same longest-common-subsequence line diff the IDE's tool cards
+ * use (`@molecule/app-ide-react`'s `diffLineCount`); it is mirrored here because
+ * the API and App halves of the workspace cannot import each other (AGENTS.md
+ * Rule 11, enforced by ESLint). Keep the two in step if either changes.
+ *
+ * @module
+ */
+/**
+ * Count truly added/removed lines between two line arrays using LCS.
+ *
+ * Bounded by construction, so a whole-file edit cannot allocate a quadratic
+ * table here: the longest common prefix and suffix are trimmed first (exact —
+ * those lines belong to every optimal diff, and on the usual small edit they
+ * shrink the table to the edited span), and what is left is capped (see
+ * {@link lcsLength}).
+ *
+ * @param oldLines - The original lines array.
+ * @param newLines - The modified lines array.
+ * @returns An object with the number of added and removed lines.
+ */
+export declare function diffLineCount(oldLines: readonly string[], newLines: readonly string[]): {
+    added: number;
+    removed: number;
+};
+//# sourceMappingURL=line-diff.d.ts.map

package/dist/line-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-diff.d.ts","sourceRoot":"","sources":["../src/line-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAmGH;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAuBpC"}

package/dist/line-diff.js

@@ -0,0 +1,150 @@
+/**
+ * Real added/removed LINE counts for the `diff` a file-writing tool reports.
+ *
+ * The count is a diff, not an arithmetic delta: replacing one line with another
+ * leaves the line count unchanged, so `new.length - old.length` is 0 for the
+ * edit that changed the file — a result that reads to the model as "your write
+ * did nothing" (X0 xr-molecule-flash-m141 +09:56: `write_file` rewrote
+ * `ArticlePreview.tsx`'s favorite label and reported
+ * `"linesAdded":0,"linesRemoved":0`). The lines an edit actually changed are
+ * found with the same longest-common-subsequence line diff the IDE's tool cards
+ * use (`@molecule/app-ide-react`'s `diffLineCount`); it is mirrored here because
+ * the API and App halves of the workspace cannot import each other (AGENTS.md
+ * Rule 11, enforced by ESLint). Keep the two in step if either changes.
+ *
+ * @module
+ */
+/**
+ * Largest LCS table the exact diff may build, in cells (old × new). A whole-file
+ * edit can be thousands of lines per side, i.e. tens of millions of cells —
+ * gigabytes of heap for a summary that only needs two numbers. Above this cap
+ * the answer comes from {@link orderedCommonLines}, a provable, order-respecting
+ * common subsequence in O(n log n); below it the result is exact. 1 << 22 cells
+ * is a few milliseconds, and the two-row table keeps memory at O(min(old, new)).
+ */
+const MAX_DIFF_CELLS = 1 << 22;
+/**
+ * Longest common subsequence length of two line arrays, in bounded time and
+ * memory: two rows of the recurrence instead of the whole table, and — once the
+ * table would exceed {@link MAX_DIFF_CELLS} — the order-respecting lower bound
+ * from {@link orderedCommonLines}.
+ *
+ * @param a - The first line array.
+ * @param b - The second line array.
+ * @returns The common subsequence length (a lower bound for the capped inputs).
+ */
+function lcsLength(a, b) {
+    if (a.length === 0 || b.length === 0)
+        return 0;
+    if (a.length * b.length > MAX_DIFF_CELLS)
+        return orderedCommonLines(a, b);
+    // The recurrence needs only the previous row, and a row is `cols` wide — so
+    // the SHORTER array belongs on the `cols` axis, which bounds every row by
+    // min(a, b) and is what the memory claim above rests on. The recurrence is
+    // symmetric, so the length it returns is the same either way.
+    let rows = a;
+    let cols = b;
+    if (cols.length > rows.length) {
+        rows = b;
+        cols = a;
+    }
+    let previous = new Array(cols.length + 1).fill(0);
+    let current = new Array(cols.length + 1).fill(0);
+    for (let i = 1; i <= rows.length; i++) {
+        const line = rows[i - 1];
+        for (let j = 1; j <= cols.length; j++) {
+            if (line === cols[j - 1]) {
+                current[j] = previous[j - 1] + 1;
+            }
+            else {
+                const above = previous[j];
+                const left = current[j - 1];
+                current[j] = above >= left ? above : left;
+            }
+        }
+        const swap = previous;
+        previous = current;
+        current = swap;
+    }
+    return previous[cols.length];
+}
+/**
+ * How many lines the two arrays share IN ORDER, for inputs too large for the
+ * exact table: the longest run of lines that appear in the same relative order
+ * on both sides, found among the lines that occur exactly once in `a` (their
+ * position is unambiguous) by reducing their `b` positions to a longest
+ * strictly increasing run — the standard patience LIS, O(n log n).
+ *
+ * Order is the whole point. Counting the lines as a multiset (order thrown
+ * away) is only an UPPER bound on the LCS, so it under-reports changes: a
+ * 3000-line file whose two halves were swapped shares every line, and the
+ * multiset count would report the replacement as `+0 −0` — a result claiming a
+ * real edit changed nothing. Every line counted here is a real in-order match,
+ * so the answer is a LOWER bound on the LCS and the change count it feeds can
+ * only ever be over-stated, never denied.
+ *
+ * @param a - The first line array.
+ * @param b - The second line array.
+ * @returns A common subsequence length.
+ */
+function orderedCommonLines(a, b) {
+    const occurrences = new Map();
+    for (const line of a)
+        occurrences.set(line, (occurrences.get(line) ?? 0) + 1);
+    const position = new Map();
+    a.forEach((line, index) => {
+        if (occurrences.get(line) === 1)
+            position.set(line, index);
+    });
+    // Patience: `tails[i]` is the smallest `b`-position that ends an increasing
+    // run of length `i + 1`.
+    const tails = [];
+    for (const line of b) {
+        const at = position.get(line);
+        if (at === undefined)
+            continue;
+        let lo = 0;
+        let hi = tails.length;
+        while (lo < hi) {
+            const mid = (lo + hi) >> 1;
+            if (tails[mid] < at)
+                lo = mid + 1;
+            else
+                hi = mid;
+        }
+        tails[lo] = at;
+    }
+    return tails.length;
+}
+/**
+ * Count truly added/removed lines between two line arrays using LCS.
+ *
+ * Bounded by construction, so a whole-file edit cannot allocate a quadratic
+ * table here: the longest common prefix and suffix are trimmed first (exact —
+ * those lines belong to every optimal diff, and on the usual small edit they
+ * shrink the table to the edited span), and what is left is capped (see
+ * {@link lcsLength}).
+ *
+ * @param oldLines - The original lines array.
+ * @param newLines - The modified lines array.
+ * @returns An object with the number of added and removed lines.
+ */
+export function diffLineCount(oldLines, newLines) {
+    const oldLength = oldLines.length;
+    const newLength = newLines.length;
+    const shared = Math.min(oldLength, newLength);
+    // Longest common prefix / suffix. `suffix` is bounded by `shared - prefix`, so
+    // the two trimmed runs can never overlap each other.
+    let prefix = 0;
+    while (prefix < shared && oldLines[prefix] === newLines[prefix])
+        prefix++;
+    let suffix = 0;
+    while (suffix < shared - prefix &&
+        oldLines[oldLength - 1 - suffix] === newLines[newLength - 1 - suffix]) {
+        suffix++;
+    }
+    const common = prefix +
+        suffix +
+        lcsLength(oldLines.slice(prefix, oldLength - suffix), newLines.slice(prefix, newLength - suffix));
+    return { added: newLength - common, removed: oldLength - common };
+}

package/dist/output-filter.d.ts

@@ -0,0 +1,48 @@
+/**
+ * A run whose own command piped its output through `tail`/`head`/`grep`/`sed`/`awk`/`cut`, so the
+ * failure the runner printed is not in what came back.
+ *
+ * xr-molecule-flash-m147 (+10:12) sent `hurl --variable uid=… --test /tmp/t.hurl 2>&1 | tail -6`.
+ * The six lines that survived are Hurl's closing tally; the failed assertion was above the cut.
+ * The platform, seeing a red run with no assertion block, said the cause was "the transport or the
+ * run itself" — a sentence that sends the reader at the network for a status assertion it never
+ * saw. The command was in the platform's hands the whole time: the pipe is the reader's own filter,
+ * not a fact about the run.
+ *
+ * This module answers the one question that lets a caller say so: is an output-slicing stage of
+ * THIS command's pipeline sitting after the runner, and what is the command without it? The parse
+ * is the package's own shell reader ({@link locatedCommandSegments}), so a `|` inside quotes or a
+ * heredoc is not a stage, and only a stage of the runner's own pipeline is considered.
+ *
+ * @module
+ */
+import { type CommandSegment } from './command-position.js';
+/** A cutting stage that follows the runner, and the command with the whole pipe removed. */
+export interface RunnerOutputFilter {
+    /** The stage exactly as the runner's command wrote it — `tail -6`. */
+    stage: string;
+    /** The pipe as a sentence names it — `| tail -6`. */
+    pipe: string;
+    /**
+     * The command with the pipe and the stage removed — `hurl --variable uid=… --test /tmp/t.hurl
+     * 2>&1`. This is a command to send again as written, not a re-typing of it: it is a slice of the
+     * original with the filter's own range cut out, so every other word, quote and redirect stays.
+     */
+    command: string;
+}
+/**
+ * The output filter that follows the runner in `command`, or null when there is none.
+ *
+ * Only a stage of the runner's OWN pipeline counts (its separator is `|`), and only when it is the
+ * LAST stage of that pipeline: a `| grep … | wc -l` chain would leave a dangling pipe if the
+ * middle stage were cut out, so a chain is not answered here at all. A filter before the runner
+ * (`cat run.log | tail -20 && hurl …`) reads something else's output and is not this.
+ *
+ * @param command - The command as the executor sent it.
+ * @param runs - Whether a segment is the runner this run is about (the caller knows its own kind:
+ *   {@link CommandSegment.program} is the program, once wrapper words like `timeout 280` and
+ *   `npx` are taken away).
+ * @returns The filter and the unfiltered command, or null.
+ */
+export declare function outputFilterAfterRunner(command: string, runs: (segment: CommandSegment) => boolean): RunnerOutputFilter | null;
+//# sourceMappingURL=output-filter.d.ts.map

package/dist/output-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-filter.d.ts","sourceRoot":"","sources":["../src/output-filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,KAAK,cAAc,EAA0B,MAAM,uBAAuB,CAAA;AASnF,4FAA4F;AAC5F,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAA;IACb,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,GACzC,kBAAkB,GAAG,IAAI,CAkB3B"}

package/dist/output-filter.js

@@ -0,0 +1,64 @@
+/**
+ * A run whose own command piped its output through `tail`/`head`/`grep`/`sed`/`awk`/`cut`, so the
+ * failure the runner printed is not in what came back.
+ *
+ * xr-molecule-flash-m147 (+10:12) sent `hurl --variable uid=… --test /tmp/t.hurl 2>&1 | tail -6`.
+ * The six lines that survived are Hurl's closing tally; the failed assertion was above the cut.
+ * The platform, seeing a red run with no assertion block, said the cause was "the transport or the
+ * run itself" — a sentence that sends the reader at the network for a status assertion it never
+ * saw. The command was in the platform's hands the whole time: the pipe is the reader's own filter,
+ * not a fact about the run.
+ *
+ * This module answers the one question that lets a caller say so: is an output-slicing stage of
+ * THIS command's pipeline sitting after the runner, and what is the command without it? The parse
+ * is the package's own shell reader ({@link locatedCommandSegments}), so a `|` inside quotes or a
+ * heredoc is not a stage, and only a stage of the runner's own pipeline is considered.
+ *
+ * @module
+ */
+import { locatedCommandSegments } from './command-position.js';
+/**
+ * The programs whose job is to re-shape what an earlier stage printed and that can DROP lines —
+ * the reader's own cut, never part of the run. `tee`, `sort` and `wc` are output plumbing too, but
+ * they do not hide a failure, so they are not read as the cause of a missing one.
+ */
+const CUTTING_FILTERS = new Set(['awk', 'cut', 'grep', 'head', 'sed', 'tail']);
+/**
+ * The output filter that follows the runner in `command`, or null when there is none.
+ *
+ * Only a stage of the runner's OWN pipeline counts (its separator is `|`), and only when it is the
+ * LAST stage of that pipeline: a `| grep … | wc -l` chain would leave a dangling pipe if the
+ * middle stage were cut out, so a chain is not answered here at all. A filter before the runner
+ * (`cat run.log | tail -20 && hurl …`) reads something else's output and is not this.
+ *
+ * @param command - The command as the executor sent it.
+ * @param runs - Whether a segment is the runner this run is about (the caller knows its own kind:
+ *   {@link CommandSegment.program} is the program, once wrapper words like `timeout 280` and
+ *   `npx` are taken away).
+ * @returns The filter and the unfiltered command, or null.
+ */
+export function outputFilterAfterRunner(command, runs) {
+    if (typeof command !== 'string' || command.trim() === '')
+        return null;
+    const entries = locatedCommandSegments(command);
+    const runnerAt = entries.findIndex((entry) => entry.segment !== null && runs(entry.segment));
+    if (runnerAt < 0 || runnerAt + 1 >= entries.length)
+        return null;
+    const runner = entries[runnerAt];
+    const filter = entries[runnerAt + 1];
+    // The stage must be fed by the runner's own pipe, and nothing may be piped out of the filter:
+    // those are the two positions where cutting it out leaves a command that still runs the run.
+    if (!runner || !filter || filter.separator.trim() !== '|')
+        return null;
+    if (!filter.segment || !CUTTING_FILTERS.has(filter.segment.program))
+        return null;
+    if (filter.terminator.trim() === '|')
+        return null;
+    if (runner.end === null || filter.start === null || filter.end === null)
+        return null;
+    return {
+        stage: command.slice(filter.start, filter.end),
+        pipe: `| ${command.slice(filter.start, filter.end)}`,
+        command: `${command.slice(0, runner.end)}${command.slice(filter.end)}`,
+    };
+}

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAiJ9C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAahG;AAkOD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAoEnE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAEA,CAAA;AAE9B;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,wBAAwB,QAI6C,CAAA;AAmBlF;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUhE;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,qBAAqB;IACpC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,8FAA8F;IAC9F,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAA;AAoBpF;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,CAAC,GACxE,qBAAqB,CAkBvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,qBAAqB,GAC5B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiCxB;AA8ED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,EAAE,CAi7ExF"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAkJ9C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAahG;AAkOD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAqEnE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAEA,CAAA;AAE9B;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,wBAAwB,QAI6C,CAAA;AAmBlF;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUhE;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,qBAAqB;IACpC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,8FAA8F;IAC9F,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAA;AAoBpF;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,CAAC,GACxE,qBAAqB,CAkBvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,qBAAqB,GAC5B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiCxB;AA8ED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,EAAE,CAk9ExF"}

package/dist/tools.js

@@ -10,6 +10,7 @@ import { posix } from 'path';
 import { commandCutRun, CUT_AT_BUDGET, cutRunSentence, suiteRunExitCode } from './cut-run.js';
 import { addChangeSpan, changedSpan, countLines, renderEditExcerpt, renderSmallFile, } from './edit-excerpt.js';
 import { guardToolExecute, missingParamError, ToolInputError } from './input-normalizer.js';
+import { diffLineCount } from './line-diff.js';
 import { pipelineExitCodeNote } from './pipeline-exit-note.js';
 import { TOOL_SCHEMAS } from './schemas.js';
 import { leadingSleepPeek } from './sleep-peek.js';
@@ -362,7 +363,7 @@ async function backgroundTaskState(backend, command, seconds, ceilingMs) {
 }
 import { suiteCommandTarget } from './suite-overlap.js';
 import { diagnosisTraceCommand } from './trace-artifacts.js';
-import { checkBlockedCommand, declaredBudgetSeconds, DEFAULT_SEARCH_EXCLUDED_DIRS, directoryReadHint, earlyReturnCause, emptyCallError, failureCausesNote, findPathArgs, findPatternArgs, fusedLine, htmlOutline, isCommandTimeout, isEnvFilePath, isOutsideRoot, isPlaywrightRunCommand, isSuiteRunCommand, isValidGlob, linesWithinSerialized, literalDirPrefix, MAX_BATCH_READ_FILES, MAX_FIND_RESULTS, MAX_HTML_INLINE_CHARS, MAX_OUTPUT_SIZE, MAX_READ_CALL_CHARS, MAX_READ_RETURN_CHARS, MAX_READ_SIZE, MAX_SEARCH_CONTEXT_LINES, MAX_SEARCH_RESULTS, MAX_WRITE_SIZE, outputIsWithheldUntilExit, outputRedirectTarget, parseCheckCommand, parseCheckProblem, pathArgError, printsOnlySource, READ_RESULT_ENVELOPE_CHARS, redactSecrets, redactSecretsInCode, repeatingFailure, repeatingFailureNote, resolvePath, RUNNING_FAILURE_LINES, runningCauseCommand, runningOutputSliceCommand, searchTimeoutError, serializedChars, shellQuote, sliceLines, SMALL_FILE_WHOLE_CHARS, streamingBackgroundCommand, stripControlChars, suiteRunPipelinePlacement, suiteRunPriorityLaunch, truncateMiddle, universalCause, whitespaceTolerantReplace, } from './utilities.js';
+import { checkBlockedCommand, declaredBudgetSeconds, DEFAULT_SEARCH_EXCLUDED_DIRS, directoryReadHint, earlyReturnCause, emptyCallError, failureCausesNote, findPathArgs, findPatternArgs, fusedLine, htmlOutline, isCommandTimeout, isEnvFilePath, isOutsideRoot, isPlaywrightRunCommand, isSuiteRunCommand, isValidGlob, linesWithinSerialized, literalDirPrefix, MAX_BATCH_READ_FILES, MAX_FIND_RESULTS, MAX_HTML_INLINE_CHARS, MAX_OUTPUT_SIZE, MAX_READ_CALL_CHARS, MAX_READ_RETURN_CHARS, MAX_READ_SIZE, MAX_SEARCH_CONTEXT_LINES, MAX_SEARCH_RESULTS, MAX_WRITE_SIZE, outputIsWithheldUntilExit, outputRedirectTarget, parseCheckCommand, parseCheckProblem, pathArgError, printsOnlySource, READ_RESULT_ENVELOPE_CHARS, redactSecrets, redactSecretsInCode, repeatingFailure, repeatingFailureNote, resolvePath, RUNNING_FAILURE_LINES, runningCauseCommand, runningOutputSliceCommand, searchTimeoutError, serializedChars, shellQuote, sliceLines, SMALL_FILE_WHOLE_CHARS, streamingBackgroundCommand, stripControlChars, suiteRunPipelinePlacement, suiteRunPriorityLaunch, truncateMiddle, universalCause, whitespaceTolerantReplace, withoutSuiteTimeout, } from './utilities.js';
 /**
  * How long exec_command waits for a command it backgrounded only because the
  * command asked for more than the tool's ceiling, before handing back a task id.
@@ -921,21 +922,27 @@ export function buildTools(backend, config) {
     /**
      * Compute a lightweight diff summary for telemetry and UI badges.
      *
+     * The counts are a real line diff ({@link diffLineCount}), not the change in
+     * line count: replacing one line with another leaves the file the same
+     * length, and a length delta reported that edit as `0/0` — reading to the
+     * model as "your write changed nothing" (xr-molecule-flash-m141 +09:56, a
+     * one-line rewrite of `ArticlePreview.tsx`). A write that leaves the content
+     * identical is `unchanged` rather than a `modified` with `0/0`, so the two
+     * are distinguishable.
+     *
      * @param oldContent - Previous file contents, or `null` when creating a file.
      * @param newContent - Replacement file contents after a write/edit.
-     * @returns Counts describing whether the file was created or modified.
+     * @returns Counts describing whether the file was created, modified or left unchanged.
      */
     function computeDiff(oldContent, newContent) {
         if (oldContent === null) {
-            return { type: 'created', linesAdded: newContent.split('\n').length, linesRemoved: 0 };
+            return { type: 'created', linesAdded: countLines(newContent), linesRemoved: 0 };
         }
-        const oldLines = oldContent.split('\n');
-        const newLines = newContent.split('\n');
-        return {
-            type: 'modified',
-            linesAdded: Math.max(0, newLines.length - oldLines.length),
-            linesRemoved: Math.max(0, oldLines.length - newLines.length),
-        };
+        if (oldContent === newContent) {
+            return { type: 'unchanged', linesAdded: 0, linesRemoved: 0 };
+        }
+        const { added, removed } = diffLineCount(oldContent.split('\n'), newContent.split('\n'));
+        return { type: 'modified', linesAdded: added, linesRemoved: removed };
     }
     // ── Tool implementations ───────────────────────────────────────
     /**
@@ -2137,6 +2144,16 @@ export function buildTools(backend, config) {
                     // an executor's commands routinely carry quotes, heredocs and
                     // newlines, and re-quoting them into a detached `sh -c` is how a
                     // background runner corrupts the very thing it is running.
+                    // The platform moved this run to the background because its own bound could not fit
+                    // this tool's ceiling — and in the background the ceiling no longer applies, so the
+                    // `timeout N` the executor wrote to fit it is the only bound left, and it kills the
+                    // walk mid-run with no tally (X1 xr-molecule-flash-m143 +24:45). Lift it from the
+                    // statement that runs the suite. A run the EXECUTOR detached keeps the bound it chose.
+                    const lifted = overCeiling && input.run_in_background !== true
+                        ? withoutSuiteTimeout(command)
+                        : { command, seconds: null };
+                    if (lifted.seconds !== null)
+                        command = lifted.command;
                     // Keep the log growing while it runs (see streamingBackgroundCommand):
                     // an empty log is what wait_for_task reads as stuck.
                     const streaming = streamingBackgroundCommand(command);
@@ -2144,6 +2161,12 @@ export function buildTools(backend, config) {
                     // its changes are what this branch reports the run's own settings in.
                     if (traced.change)
                         streaming.changes.unshift(traced.change);
+                    // Said once, in the result that also hands back the task id or the run's output.
+                    if (lifted.seconds !== null) {
+                        streaming.changes.unshift(`Dropped your \`timeout ${lifted.seconds}\` from the suite run: in the background it ` +
+                            'is bounded by `wait_for_task` and the turn’s deadline, not by this tool’s ' +
+                            'ceiling, so the bound you wrote would only have killed the walk.');
+                    }
                     // A whole-suite run starves the sandbox it shares with the app and with
                     // every command the executor sends next, so it starts at lower CPU and
                     // IO priority (see suiteRunPriorityLaunch). Foreground runs are never
@@ -2210,8 +2233,15 @@ export function buildTools(backend, config) {
                                             ? { truncated: true, fullOutput: log }
                                             : {}),
                                         error: (sleepNote ? `${sleepNote} ` : '') +
-                                            `${cutRunSentence(cut)} ` +
-                                            (isSuiteRunCommand(command) ? SUITE_OVER_BUDGET_ADVICE : SPLIT_WORK_ADVICE),
+                                            cutRunSentence(cut) +
+                                            // A suite stopped in the background is never sent to the background again:
+                                            // the sentence says what to do, and the advice's reason (it “takes the run
+                                            // off this budget and writes its output to a log”) has already happened.
+                                            (cut.background
+                                                ? ''
+                                                : ` ${isSuiteRunCommand(command)
+                                                    ? SUITE_OVER_BUDGET_ADVICE
+                                                    : SPLIT_WORK_ADVICE}`),
                                     };
                                 }
                                 // The exit file holds the PIPELINE's code: when a stage this rewrite could not

package/dist/trace-artifacts.d.ts

@@ -250,14 +250,24 @@ export declare function stalledDocumentSubresource(request: TraceRequest): boole
  * fetch stalled for 27 s (xr-molecule-flash-m135 +34:10). The page shell's incidental requests
  * (`/sw.js`, the manifest, a favicon, a font) stay out, for m125's reason.
  *
+ * A 404 whose path lacks the API prefix the app's own calls carry is called out with that prefix
+ * ({@link missingApiPrefixRequests}): xr-molecule-flash-m145 posted `/users` to `vite preview`,
+ * whose 404 was answered by the static server because the HTTP client's `baseURL` was never set —
+ * and the note printed "read the handler this route reaches in your own source", which presumes a
+ * request that never reached the API. The prefix is READ (the caller passes what the app's client
+ * config names; the traces add what their own requests show) and never assumed to be `/api`.
+ *
  * @param items - The traces {@link parseTraceArtifacts} read.
  * @param target - Where the run went — the deployed host, as the note names it.
  * @param earlierFailures - The failing `file:line`s earlier walks of this suite left, so a repeat
  *   is ranked above a one-off. Empty when the caller knows of no earlier walk.
+ * @param apiPrefixes - The API path prefixes the app's client config names (`['/api']`), read from
+ *   the app by the caller. Empty when the caller could not read one; the traces' own requests may
+ *   still supply it. Never a hard-coded literal.
  * @returns The note, or null when no trace held a recorded response, a real failure or a console
  *   error.
  */
-export declare function failureTraceNote(items: readonly TraceArtifact[], target: string, earlierFailures?: readonly string[]): string | null;
+export declare function failureTraceNote(items: readonly TraceArtifact[], target: string, earlierFailures?: readonly string[], apiPrefixes?: readonly string[]): string | null;
 /**
  * Whether a Playwright config records traces for the tests that fail.
  *

package/dist/trace-artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trace-artifacts.d.ts","sourceRoot":"","sources":["../src/trace-artifacts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"trace-artifacts.d.ts","sourceRoot":"","sources":["../src/trace-artifacts.ts"],"names":[],"mappings":"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"}

package/dist/trace-artifacts.js

@@ -810,6 +810,94 @@ function transportFailure(items) {
     }
     return null;
 }
+/**
+ * A request's path when the trace recorded a same-origin path — `/users` — or null for an
+ * absolute URL (another origin's path is no evidence about this app's API).
+ *
+ * @param request - One request a trace recorded.
+ * @returns The path without a query or trailing slash, or null.
+ */
+function sameOriginPath(request) {
+    const raw = String(request.path ?? '').split(/[?#]/)[0] ?? '';
+    if (!raw.startsWith('/') || raw === '/')
+        return null;
+    return raw.replace(/\/+$/, '');
+}
+/**
+ * The API path prefixes the traced requests themselves show.
+ *
+ * A request whose path ends with another traced request's path carries that other path's prefix
+ * (`/api/users` beside `/users` → `/api`) — the trace's own evidence, with no literal in the code.
+ *
+ * @param items - The traces the note is about.
+ * @returns The one-segment prefixes (`/api`), sorted; empty when the traces show none.
+ */
+function tracedApiPrefixes(items) {
+    const paths = items.flatMap((item) => item.requests.map(sameOriginPath).filter((path) => path !== null));
+    const prefixes = new Set();
+    for (const longer of paths) {
+        for (const shorter of paths) {
+            if (longer === shorter || shorter.length < 2 || !longer.endsWith(shorter))
+                continue;
+            const prefix = longer.slice(0, longer.length - shorter.length);
+            if (/^\/[^/]+$/.test(prefix))
+                prefixes.add(prefix);
+        }
+    }
+    return [...prefixes].sort();
+}
+/**
+ * The failed 404s whose path carries none of the known API prefixes.
+ *
+ * Only a run where the prefix is KNOWABLE diagnoses: the caller reads it from the app's client
+ * config, and the traces' own requests add what they show ({@link tracedApiPrefixes}). With no
+ * known prefix, an unprefixed path is just a path — assuming `/api` is how a correct request gets
+ * a wrong note.
+ *
+ * @param items - The traces the note is about.
+ * @param apiPrefixes - Prefixes the app's client config names (`['/api']`), never a literal.
+ * @returns One entry per distinct failed 404, in trace order.
+ */
+function missingApiPrefixRequests(items, apiPrefixes) {
+    const prefixes = new Set([...apiPrefixes, ...tracedApiPrefixes(items)]
+        .map((prefix) => `/${String(prefix).replace(/^\/+|\/+$/g, '')}`)
+        .filter((prefix) => prefix !== '/'));
+    if (prefixes.size === 0)
+        return [];
+    const known = [...prefixes];
+    const out = [];
+    const seen = new Set();
+    for (const item of items) {
+        for (const request of item.requests) {
+            // A document navigation is a page route, never an API call — a 404 on one says nothing
+            // about the client's base URL.
+            if (request.status !== 404 || request.type === 'document' || !failedRequest(request))
+                continue;
+            const path = sameOriginPath(request);
+            if (path === null)
+                continue;
+            if (known.some((prefix) => path === prefix || path.startsWith(`${prefix}/`)))
+                continue;
+            const key = `${request.method} ${path}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            out.push({ method: request.method, path, prefix: known[0] ?? '' });
+        }
+    }
+    return out;
+}
+/**
+ * The sentence naming a request that reached the page origin without the app's API prefix.
+ *
+ * @param request - The failed request and the prefix its sibling calls carry.
+ * @returns The sentence the note appends.
+ */
+function missingApiPrefixSentence(request) {
+    return (`\`${request.method} ${request.path}\` → 404: this request went to \`${request.path}\` ` +
+        `without the \`${request.prefix}\` prefix — the HTTP client's base URL is not set: is ` +
+        '`setupProviders()` (which runs the HTTP bond setup) called in `main.tsx`?');
+}
 /**
  * The note a failed suite run's result carries: what each failing test's page actually sent, and
  * what came back.
@@ -854,14 +942,24 @@ function transportFailure(items) {
  * fetch stalled for 27 s (xr-molecule-flash-m135 +34:10). The page shell's incidental requests
  * (`/sw.js`, the manifest, a favicon, a font) stay out, for m125's reason.
  *
+ * A 404 whose path lacks the API prefix the app's own calls carry is called out with that prefix
+ * ({@link missingApiPrefixRequests}): xr-molecule-flash-m145 posted `/users` to `vite preview`,
+ * whose 404 was answered by the static server because the HTTP client's `baseURL` was never set —
+ * and the note printed "read the handler this route reaches in your own source", which presumes a
+ * request that never reached the API. The prefix is READ (the caller passes what the app's client
+ * config names; the traces add what their own requests show) and never assumed to be `/api`.
+ *
  * @param items - The traces {@link parseTraceArtifacts} read.
  * @param target - Where the run went — the deployed host, as the note names it.
  * @param earlierFailures - The failing `file:line`s earlier walks of this suite left, so a repeat
  *   is ranked above a one-off. Empty when the caller knows of no earlier walk.
+ * @param apiPrefixes - The API path prefixes the app's client config names (`['/api']`), read from
+ *   the app by the caller. Empty when the caller could not read one; the traces' own requests may
+ *   still supply it. Never a hard-coded literal.
  * @returns The note, or null when no trace held a recorded response, a real failure or a console
  *   error.
  */
-export function failureTraceNote(items, target, earlierFailures = []) {
+export function failureTraceNote(items, target, earlierFailures = [], apiPrefixes = []) {
     const candidates = items.filter(traceRowEvidence);
     if (candidates.length === 0)
         return null;
@@ -885,6 +983,22 @@ export function failureTraceNote(items, target, earlierFailures = []) {
     const wrapped = traced.some((item) => item.requests.some((request) => request.sent !== undefined && wrappedInData(request.sent)));
     // The "one of these requests failing" answer is only honest when a listed request really failed.
     const anyFailed = traced.some((item) => item.requests.some(failedRequest));
+    // m145's shape: the app's HTTP client lost its base URL, so every API call reached the page
+    // origin without the prefix the app mounts its routes under. The prefix is READ — the caller's
+    // client config plus what the traces show — never assumed to be `/api`.
+    const missingPrefix = missingApiPrefixRequests(traced, apiPrefixes);
+    const failedRequests = traced.flatMap((item) => item.requests.filter(failedRequest));
+    const missingKeys = new Set(missingPrefix.map((request) => `${request.method} ${request.path}`));
+    const everyFailureLacksPrefix = failedRequests.length > 0 &&
+        failedRequests.every((request) => {
+            const path = sameOriginPath(request);
+            return path !== null && missingKeys.has(`${request.method} ${path}`);
+        });
+    // The route advice goes when every failure is one of these: a request that never reached the
+    // API has no handler to read (m145's note sent the run to the PWA and then to the handler).
+    const prefixAdvice = missingPrefix.length > 0
+        ? ` ${missingPrefix.slice(0, 2).map(missingApiPrefixSentence).join(' ')}`
+        : '';
     // The document subresources that never finished anywhere in this read — the assets a timed-out
     // navigation was waiting on, when there is no failed request to explain the timeout.
     const stalledAssets = [
@@ -994,9 +1108,11 @@ export function failureTraceNote(items, target, earlierFailures = []) {
         `requests that failed, the ones that got no response, and its last answered ones):\n` +
         `${rows.join('\n')}${more}\n` +
         (anyFailed
-            ? 'A click that changed nothing is usually one of these requests failing, not the selector: ' +
-                'read the handler this route reaches in your own source, and stop `catch`-ing the request of a ' +
-                'user action silently — log it.'
+            ? everyFailureLacksPrefix
+                ? ''
+                : 'A click that changed nothing is usually one of these requests failing, not the selector: ' +
+                    'read the handler this route reaches in your own source, and stop `catch`-ing the request of a ' +
+                    'user action silently — log it.'
             : stalledAssets.length > 0
                 ? 'No listed request failed — none got a 4xx/5xx or a network error — but the document did ' +
                     'not finish loading because its own subresource never answered. Do not read this as a ' +
@@ -1007,6 +1123,7 @@ export function failureTraceNote(items, target, earlierFailures = []) {
                     'row): if it is not the request the test meant — an unfollow sent where the test clicked ' +
                     'follow — the state the click read was stale before it. Otherwise read the state the ' +
                     'failing test waited on.') +
+        prefixAdvice +
         (wrapped
             ? ' The API received a body wrapped in `data`: app-http’s `post(url, data, config)` / ' +
                 '`put(url, data, config)` / `patch(url, data, config)` take the body as their SECOND ' +

package/dist/utilities.d.ts

@@ -193,6 +193,22 @@ export declare function streamingBackgroundCommand(command: string): {
  * @returns True when the command starts one of those runners.
  */
 export declare function isSuiteRunCommand(command: string): boolean;
+/**
+ * The command with the `timeout <N>` wrapper lifted off the statement that runs the suite, and the
+ * bound that was lifted.
+ *
+ * Used where the platform moves a run to the background: the executor wrote the bound to fit this
+ * tool's foreground ceiling, and in the background that ceiling no longer applies — the task is
+ * bounded by `wait_for_task` and the turn's deadline — so the prefix only kills the walk
+ * ({@link withoutTimeoutWrapper}; X1 xr-molecule-flash-m143 +24:45).
+ *
+ * @param command - The shell command.
+ * @returns The rewritten command, and the largest lifted bound (null when nothing was lifted).
+ */
+export declare function withoutSuiteTimeout(command: string): {
+    command: string;
+    seconds: number | null;
+};
 /**
  * Whether a command starts a Playwright run — a `playwright test` in command position, in a form
  * that runs something.

package/dist/utilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../src/utilities.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../src/utilities.ts"],"names":[],"mappings":"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"}

package/dist/utilities.js

@@ -5,7 +5,7 @@
  * @module
  */
 import { posix } from 'path';
-import { commandSegments, locatedCommandSegments, statementArgumentEnd, } from './command-position.js';
+import { commandSegments, locatedCommandSegments, statementArgumentEnd, withoutTimeoutWrapper, } from './command-position.js';
 import { classifyRunFailure } from './failure-kind.js';
 import { commandRunsNoTests } from './no-test-run.js';
 import { isDiagnosisRun, scopedRerunCommand, suiteCommandTarget, suiteRunInTheWay, withoutHeredocs, withSuiteConfig, } from './suite-overlap.js';
@@ -590,6 +590,21 @@ export function isSuiteRunCommand(command) {
         return false;
     return commandSegments(command).some((segment) => SUITE_RUN_COMMANDS.some((re) => re.test(segment.text)));
 }
+/**
+ * The command with the `timeout <N>` wrapper lifted off the statement that runs the suite, and the
+ * bound that was lifted.
+ *
+ * Used where the platform moves a run to the background: the executor wrote the bound to fit this
+ * tool's foreground ceiling, and in the background that ceiling no longer applies — the task is
+ * bounded by `wait_for_task` and the turn's deadline — so the prefix only kills the walk
+ * ({@link withoutTimeoutWrapper}; X1 xr-molecule-flash-m143 +24:45).
+ *
+ * @param command - The shell command.
+ * @returns The rewritten command, and the largest lifted bound (null when nothing was lifted).
+ */
+export function withoutSuiteTimeout(command) {
+    return withoutTimeoutWrapper(command, (segment) => isSuiteRunCommand(segment.text));
+}
 /**
  * Whether a command starts a Playwright run — a `playwright test` in command position, in a form
  * that runs something.

package/package.json

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