@molecule/api-ai-tools 1.10.8 → 1.10.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-20T08:52:42.570Z
+Generated: 2026-10-20T13:43:44.255Z
 -->
 
 # @molecule/api-ai-tools
@@ -449,14 +449,14 @@ interface TraceRequest {
   /**
    * The response status as the trace recorded it. Playwright writes `-1` when a request was never
    * answered (its HAR entry starts at `-1` and only a response event overwrites it); `0` is the
-   * same absence when the snapshot carried no response at all. Neither is a server failure.
+   * same absence when the snapshot carried no response at all. Neither alone proves a server failure.
    */
   status: number
   /**
    * Playwright's own error text for a request that failed WITHOUT a response
    * (`net::ERR_CONNECTION_REFUSED`) — a real failure. A request that got no response and recorded
-   * no text was aborted or still in flight when the test ended (the page closed under it), so it
-   * says nothing about the server (xr-molecule-flash-m112 +30:45).
+   * no text may still have been in flight when recording ended. Missing text or an explicit
+   * cancellation cannot establish either a server failure or server health.
    */
   failure?: string
   /**
@@ -1562,6 +1562,19 @@ function durationSeconds(word: string): number | null
 
 **Returns:** The seconds, or null when the word is not a duration.
 
+#### `endsInBackground(command)`
+
+Whether the outer shell's final statement starts a background job.
+Inner shell strings have their own job tables and do not count.
+
+```typescript
+function endsInBackground(command: string): boolean
+```
+
+- `command` — The shell command.
+
+**Returns:** Whether its final statement ends with the shell's `&` operator.
+
 #### `commandSegments(command)`
 
 The segments of a command, each with its program and arguments — the answer every classifier
@@ -2568,11 +2581,12 @@ function isStaticAssetRequest(request: TraceRequest): boolean
 
 #### `failedRequest(request)`
 
-Whether a trace recorded a request the server actually failed: a 4xx/5xx, or a network error.
+Whether a trace recorded a failed response or a request error other than cancellation.
 
 A 404 on a static asset is excepted: `/sw.js` and `/fonts/*` 404 on an app that never shipped
 them, and naming one as a failure sent m125 into writing the caching worker it had asked about.
-A 5xx on an asset, or a network error, still counts — the server did fail.
+A 5xx on an asset, or a network error, still counts. A request error alone does not locate
+the cause in the server: the browser or network may have rejected the request.
 
 ```typescript
 function failedRequest(request: TraceRequest): boolean
@@ -2584,9 +2598,9 @@ function failedRequest(request: TraceRequest): boolean
 
 #### `unansweredRequest(request)`
 
-Whether a trace recorded NO response and no reason for it — a request that was aborted or still
-in flight when the test ended. It is not evidence that the server failed (m112 +30:45), and one
-the page shell made is not evidence about the step at all (m125 +29:33).
+Whether a trace recorded no response and no error other than cancellation. The request may
+have been pending or cancelled when recording ended; the trace does not establish whether
+the endpoint stalled. A shell request is not evidence about the step (m125 +29:33).
 
 ```typescript
 function unansweredRequest(request: TraceRequest): boolean
@@ -2594,7 +2608,7 @@ function unansweredRequest(request: TraceRequest): boolean
 
 - `request` — One request a trace recorded.
 
-**Returns:** True when the request is still in flight and worth naming.
+**Returns:** True when the request's missing response is inconclusive and worth naming.
 
 #### `stalledDocumentSubresource(request)`
 

package/dist/command-position.d.ts

@@ -58,6 +58,14 @@ export interface CommandSegment {
  * @returns The seconds, or null when the word is not a duration.
  */
 export declare function durationSeconds(word: string): number | null;
+/**
+ * Whether the outer shell's final statement starts a background job.
+ * Inner shell strings have their own job tables and do not count.
+ *
+ * @param command - The shell command.
+ * @returns Whether its final statement ends with the shell's `&` operator.
+ */
+export declare function endsInBackground(command: string): boolean;
 /**
  * The segments of a command, each with its program and arguments — the answer every classifier
  * that reads a command as "this runs the suite" is asking for.

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;;;;;OAKG;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;AAgSD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM3D;AA6qBD;;;;;;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;AA4GD;;;;;;;;;;;;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"}
+{"version":3,"file":"command-position.d.ts","sourceRoot":"","sources":["../src/command-position.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,uFAAuF;AACvF,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;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;AAgSD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM3D;AAikBD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD;AA8GD;;;;;;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;AA4GD;;;;;;;;;;;;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

@@ -863,6 +863,16 @@ function splitSegments(command) {
     }
     return out;
 }
+/**
+ * Whether the outer shell's final statement starts a background job.
+ * Inner shell strings have their own job tables and do not count.
+ *
+ * @param command - The shell command.
+ * @returns Whether its final statement ends with the shell's `&` operator.
+ */
+export function endsInBackground(command) {
+    return splitSegments(command).at(-1)?.after === '&';
+}
 /** A redirect's target word: a quoted one keeps its spaces (`tee 'out file.txt'`). */
 const REDIRECT_TARGET_WORD = String.raw `(?:'[^']*'|"[^"]*"|[^\s;&|]+)`;
 /**

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;AAgO9C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAahG;AAkaD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AA8HnE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAEA,CAAA;AAE9B;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,wBAAwB,QAI6C,CAAA;AA2DlF;;;;;;;;;;;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;AA2GD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,EAAE,CAm4FxF"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AA4O9C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAahG;AAudD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AA8HnE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAEA,CAAA;AAE9B;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,wBAAwB,QAI6C,CAAA;AA2DlF;;;;;;;;;;;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;AA2GD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,EAAE,CAi5FxF"}

package/dist/tools.js

@@ -8,6 +8,7 @@
  */
 import { posix } from 'path';
 import { browserProbeOverBudgetAdvice, browserProbeRefusal } from './browser-probe.js';
+import { endsInBackground } from './command-position.js';
 import { commandCutRun, CUT_AT_BUDGET, cutRunSentence, suiteRunExitCode, suiteSummary, } from './cut-run.js';
 import { addChangeSpan, changedSpan, countLines, renderEditExcerpt, renderSmallFile, } from './edit-excerpt.js';
 import { INLINE_SCRIPT_BUDGET_MS, inlineLocalScriptCommand, inlineScriptRunawaySentence, } from './inline-script.js';
@@ -33,6 +34,16 @@ const waitedByTask = new Map();
 const logBytesByTask = new Map();
 /** The file a background command writes its own output to, when it redirects it. */
 const outputFileByTask = new Map();
+/**
+ * Recovered legacy task ids whose command ENDS with a backgrounded statement (`… &`).
+ *
+ * Such a launch returns the status of the backgrounding operation itself — a launch
+ * acknowledgement — and its wrapper is expected to be gone while the run it started still walks, so
+ * neither the wrapper's code nor its death says the run ended ({@link taskEndState}). The run's own
+ * output is the only ending that counts. New tasks append a shell `wait` and record the actual
+ * child's status; only scripts recovered from earlier versions need this compatibility path.
+ */
+const detachedByTask = new Set();
 /**
  * Task ids whose log has SHOWN a failure's own body under a `✘` row — the inline failure switch's
  * effect, read from the log itself ({@link logShowsInlineFailureBodies}).
@@ -225,22 +236,59 @@ const TASK_END_LOOK_MS = 3_000;
 /** How much of a task's own output the end test reads — a runner's tally is its last lines. */
 const TASK_OUTPUT_END_BYTES = 4_000;
 /**
- * The shell probe behind {@link taskEndState}: the pid the launcher wrote, and the end of the
- * file the command redirects its own output to.
+ * The verdict an exit file holds, or null when it holds none.
+ *
+ * The launcher writes the file as `echo $? > <exitFile>`, which opens it and then writes the code
+ * — so a reader can catch it EMPTY in between, and a wrapper killed at that instant leaves it
+ * empty for good. Neither is a verdict. Reading it as 0 (what this used to do) hands back success
+ * for a command that may have failed — the same fabrication `molecule-dev/api/src/ai/
+ * background-tasks.ts` refuses when it treats such a read as "no exit file yet".
+ *
+ * @param raw - The exit file's content as read.
+ * @returns The exit code it records, or null when it records none.
+ */
+function exitCodeIn(raw) {
+    const trimmed = raw.trim();
+    return /^\d+$/.test(trimmed) ? Number.parseInt(trimmed, 10) : null;
+}
+/**
+ * The shell probe behind {@link taskEndState}: the code the launcher wrote, the pid it wrote, and
+ * the end of the file the command redirects its own output to.
  *
  * The pid test is the one `molecule-dev/api/src/ai/background-tasks.ts` applies in `liveness` —
  * a written exit code ends the task, a live pid keeps it running, and a handle the sandbox cannot
  * account for stays unknown — so this package and that one cannot disagree about whether a task
  * is still walking.
  *
+ * The exit file is read in THIS shell, beside the pid test, because the two are ONE observation.
+ * Read as two round trips — a wait's tick reading the file, then this probe asking the pid — a
+ * wrapper that finished and wrote its code between them was reported "ended without writing an
+ * exit code" while its code was on disk (xr-molecule-flash-m303: 13/13 Hurl files green,
+ * `exitCode: null`, after a wait that returned on the tick the run ended).
+ *
+ * The pid test runs BEFORE the exit file is read, and that order is the point: the launcher writes
+ * the code and then exits, and `kill -0` answers "gone" only once the process is reaped — so a
+ * "gone" answer means the write has already happened, and the read that follows cannot miss it.
+ * Read first, the same shell would still have a window between the two statements.
+ *
+ * The first TWO lines are always the two headers, in this order, and the exit header is always
+ * there (`unknown` when the file holds no code yet). {@link taskEndState} reads those positions
+ * and nothing else, so a run whose own output prints `MOL_TASK_EXIT 0` cannot have that line
+ * mistaken for a written code — the bytes a command can produce start at the third line.
+ *
  * @param taskId - The task's `mol-bg-…` handle (format already checked by the caller).
  * @param own - The file the command redirects its own output to, when the launch could tell.
- * @returns The command; its first line is `MOL_TASK_STATE <alive|gone|unknown>`, the rest the tail.
+ * @returns The command; line 1 is `MOL_TASK_STATE <alive|gone|unknown>`, line 2
+ *   `MOL_TASK_EXIT <n|unknown>`, and the rest the tail of the run's own output.
  */
 const taskStateCommand = (taskId, own) => `P=$(cat /tmp/${taskId}.pid 2>/dev/null); ` +
-    `if [ -z "$P" ] || [ ! -f /tmp/${taskId}.sh ]; then echo MOL_TASK_STATE unknown; ` +
-    `elif kill -0 "$P" 2>/dev/null; then echo MOL_TASK_STATE alive; ` +
-    `else echo MOL_TASK_STATE gone; fi; ` +
+    `if [ -z "$P" ] || [ ! -f /tmp/${taskId}.sh ]; then S=unknown; ` +
+    `elif kill -0 "$P" 2>/dev/null; then S=alive; ` +
+    `else S=gone; fi; ` +
+    `c=$(cat /tmp/${taskId}.exit 2>/dev/null); ` +
+    `case "$c" in ''|*[!0-9]*) X=unknown;; *) X=$c;; esac; ` +
+    `echo MOL_TASK_STATE "$S"; ` +
+    `echo MOL_TASK_EXIT "$X"; ` +
     (own ? `tail -c ${TASK_OUTPUT_END_BYTES} ${shellQuote(own)} 2>/dev/null` : 'true');
 /**
  * The ending a task's own output already records, read from the file its command redirects to.
@@ -286,10 +334,12 @@ function outputEnding(text) {
  *
  * @param backend - The execution backend the task runs on.
  * @param taskId - The task's `mol-bg-…` handle.
- * @returns Whether it has ended, and the code its own output recorded when it recorded one.
+ * @returns Whether it has ended, and the code the exit file (or the run's own output) recorded,
+ *   or null when there is no verdict to report.
  */
 async function taskEndState(backend, taskId) {
     const own = outputFileByTask.get(taskId);
+    const detached = detachedByTask.has(taskId);
     let stdout;
     try {
         const r = await backend.run(taskStateCommand(taskId, own), { timeout: 5_000 });
@@ -300,18 +350,32 @@ async function taskEndState(backend, taskId) {
         // the loud one (a result handed back for a run that is still walking).
         return { ended: false, exitCode: null };
     }
-    const [stateLine = '', ...rest] = stdout.split('\n');
-    const state = /MOL_TASK_STATE (alive|gone|unknown)/.exec(stateLine)?.[1] ?? 'unknown';
-    const ownEnding = outputEnding(rest.join('\n'));
+    // The headers are OURS, at fixed positions — a line the run's own output prints that is shaped
+    // like one cannot be read as one, and the bytes after line 2 are the run's tail regardless.
+    const lines = stdout.split('\n').map((line) => line.replace(/\r$/, ''));
+    const state = /^MOL_TASK_STATE (alive|gone|unknown)$/.exec(lines[0] ?? '')?.[1] ?? 'unknown';
+    const headerCode = /^MOL_TASK_EXIT (\d+)$/.exec(lines[1] ?? '')?.[1];
+    const reported = headerCode === undefined ? null : Number(headerCode);
+    const ownEnding = outputEnding(lines.slice(2).join('\n'));
     // The run's own output can end the task while its wrapper is still alive: the wrapper may be
     // waiting on the wrong thing (m182's was blocked) while the run it started is over. An explicit
-    // `EXIT=<n>` is that verdict; a bare tally is trusted only once the pid is gone, because the
-    // instant between a walk's tally and its next walk's header reads the same.
+    // `EXIT=<n>` is that verdict — more specific than the wrapper's own code, which in that shape is
+    // the status of the backgrounding statement, not of the run — and a bare tally is trusted only
+    // once the pid is gone, because the instant between a walk's tally and its next walk's header
+    // reads the same.
     if (ownEnding.ended && (ownEnding.exitCode !== null || state === 'gone'))
         return ownEnding;
+    // The code the launcher wrote, read in the same shell as the pid test. It is an ending only once
+    // the wrapper is GONE: a wrapper still alive has not reached that write yet (or is a moment away
+    // from exiting), so the code is not an ending for it — and a launch whose LAST statement is
+    // backgrounded (`… &`) returned the status of the backgrounding operation, a launch
+    // acknowledgement, that is never the run's verdict (see {@link detachedByTask}). Read after the
+    // pid test, it is found here rather than reported as never written (xr-molecule-flash-m303).
+    if (!detached && reported !== null && state === 'gone')
+        return { ended: true, exitCode: reported };
     // A pid this sandbox can account for and that is gone, with no exit file: the wrapper that
     // writes the exit code was killed or exited, so the task ended and has no verdict to invent.
-    if (state === 'gone')
+    if (!detached && state === 'gone')
         return { ended: true, exitCode: null };
     return { ended: false, exitCode: null };
 }
@@ -517,9 +581,7 @@ async function backgroundTaskState(backend, command, seconds, ceilingMs) {
     const ids = recent.filter((id) => owned.has(id));
     const exitCodeOf = async (id) => {
         try {
-            const raw = await backend.readFile(`/tmp/${id}.exit`);
-            const code = Number.parseInt(raw.trim(), 10);
-            return Number.isFinite(code) ? code : 0;
+            return exitCodeIn(await backend.readFile(`/tmp/${id}.exit`));
         }
         catch (_error) {
             // No exit file yet: the task is still running. Not an error.
@@ -537,7 +599,9 @@ async function backgroundTaskState(backend, command, seconds, ceilingMs) {
     // whose run is already over (m182 +30:25: `sleep 240; tail /tmp/full-run.log` was answered "is
     // live" for a task that had ended 20 s after it started).
     const stateOf = async (id) => {
-        const exitCode = await exitCodeOf(id);
+        // A launch that ended in `&` writes its exit file at once with the launch's own status; that
+        // is an acknowledgement, and the task's end is read from its own output instead.
+        const exitCode = detachedByTask.has(id) ? null : await exitCodeOf(id);
         if (exitCode !== null)
             return { id, ended: true, exitCode };
         return { id, ...(await taskEndState(backend, id)) };
@@ -2752,6 +2816,13 @@ export function buildTools(backend, config) {
                     // (X1 xr-molecule-flash-m157 +14:02 — two whole walks chained with `;`).
                     if (streaming.error)
                         return { error: streaming.error };
+                    // This tool already backgrounds the script. If its last statement also uses `&`,
+                    // let the same shell wait for that child and preserve its exit code. Inferring its
+                    // completion from output cannot work for silent commands such as `true &`.
+                    // The parser reads the outer shell: an inner `sh -c '… &'` has its own job table.
+                    if (endsInBackground(streaming.command)) {
+                        streaming.command += '\nwait "$!"';
+                    }
                     // …and the trace flag this tool added (above), which the streaming rewrite never saw:
                     // its changes are what this branch reports the run's own settings in.
                     if (traced.change)
@@ -2796,15 +2867,14 @@ export function buildTools(backend, config) {
                     // seconds (a Hurl suite: 37 ms). Handing it back as a task cost a
                     // wait_for_task round trip each time (X1 flash-m20, twice in ten
                     // minutes), so wait a short grace first and return a finished command
-                    // exactly as a foreground run returns.
+                    // exactly as a foreground run returns. A redundant final `&` is followed by `wait`
+                    // above, so this file also carries the actual child status in that case.
                     if (overCeiling && input.run_in_background !== true) {
                         const graceUntil = Date.now() + overCeilingGraceMs;
                         while (Date.now() < graceUntil) {
                             let code = null;
                             try {
-                                const raw = await backend.readFile(exitFile);
-                                const parsed = Number.parseInt(raw.trim(), 10);
-                                code = Number.isFinite(parsed) ? parsed : 0;
+                                code = exitCodeIn(await backend.readFile(exitFile));
                             }
                             catch (_error) {
                                 // No exit file yet: still running.
@@ -3154,6 +3224,10 @@ export function buildTools(backend, config) {
                     // already resolved and stays as written.
                     if (target)
                         outputFileByTask.set(taskId, posix.resolve(root, target));
+                    // The launch's own shape outlives this process the same way its redirect target does:
+                    // a command that ended in `&` is still a launch acknowledgement, not a finished run.
+                    if (endsInBackground(script))
+                        detachedByTask.add(taskId);
                 }
                 catch (_error) {
                     // No script under that id: this process did not start the task, so
@@ -3225,11 +3299,17 @@ export function buildTools(backend, config) {
             const requested = Number(input.timeout);
             const budgetMs = Number.isFinite(requested) && requested > 0 ? Math.min(requested, ceiling) : ceiling;
             const startedAt = Date.now();
+            // A task whose command ended in `&` writes its exit file the moment it launches, with the
+            // launch's own status: that code is an acknowledgement, never the run's verdict, and its end
+            // is read from its own output by {@link taskEndState} instead.
+            const detachedRun = detachedByTask.has(taskId);
             const readExit = async () => {
+                if (detachedRun)
+                    return null;
                 try {
-                    const raw = await backend.readFile(exitFile);
-                    const code = Number.parseInt(raw.trim(), 10);
-                    return Number.isFinite(code) ? code : 0;
+                    // A file that is there but holds no number yet is the launcher's truncate-then-write
+                    // instant, not a verdict — the next tick reads the code (see {@link exitCodeIn}).
+                    return exitCodeIn(await backend.readFile(exitFile));
                 }
                 catch (_error) {
                     // No exit file yet — the command is still running. Not an error.

package/dist/trace-artifacts.d.ts

@@ -35,14 +35,14 @@ export interface TraceRequest {
     /**
      * The response status as the trace recorded it. Playwright writes `-1` when a request was never
      * answered (its HAR entry starts at `-1` and only a response event overwrites it); `0` is the
-     * same absence when the snapshot carried no response at all. Neither is a server failure.
+     * same absence when the snapshot carried no response at all. Neither alone proves a server failure.
      */
     status: number;
     /**
      * Playwright's own error text for a request that failed WITHOUT a response
      * (`net::ERR_CONNECTION_REFUSED`) — a real failure. A request that got no response and recorded
-     * no text was aborted or still in flight when the test ended (the page closed under it), so it
-     * says nothing about the server (xr-molecule-flash-m112 +30:45).
+     * no text may still have been in flight when recording ended. Missing text or an explicit
+     * cancellation cannot establish either a server failure or server health.
      */
     failure?: string;
     /**
@@ -480,23 +480,24 @@ export declare function parseTraceArtifacts(stdout: string): TraceArtifact[];
  */
 export declare function isStaticAssetRequest(request: TraceRequest): boolean;
 /**
- * Whether a trace recorded a request the server actually failed: a 4xx/5xx, or a network error.
+ * Whether a trace recorded a failed response or a request error other than cancellation.
  *
  * A 404 on a static asset is excepted: `/sw.js` and `/fonts/*` 404 on an app that never shipped
  * them, and naming one as a failure sent m125 into writing the caching worker it had asked about.
- * A 5xx on an asset, or a network error, still counts — the server did fail.
+ * A 5xx on an asset, or a network error, still counts. A request error alone does not locate
+ * the cause in the server: the browser or network may have rejected the request.
  *
  * @param request - One request a trace recorded.
  * @returns True when the request failed in a way the note should name.
  */
 export declare function failedRequest(request: TraceRequest): boolean;
 /**
- * Whether a trace recorded NO response and no reason for it — a request that was aborted or still
- * in flight when the test ended. It is not evidence that the server failed (m112 +30:45), and one
- * the page shell made is not evidence about the step at all (m125 +29:33).
+ * Whether a trace recorded no response and no error other than cancellation. The request may
+ * have been pending or cancelled when recording ended; the trace does not establish whether
+ * the endpoint stalled. A shell request is not evidence about the step (m125 +29:33).
  *
  * @param request - One request a trace recorded.
- * @returns True when the request is still in flight and worth naming.
+ * @returns True when the request's missing response is inconclusive and worth naming.
  */
 export declare function unansweredRequest(request: TraceRequest): boolean;
 /**

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

@@ -1896,11 +1896,12 @@ export function isStaticAssetRequest(request) {
     return STATIC_ASSET_PATH.test(path) || STATIC_ASSET_DIR.test(path) || SHELL_FILE_PATH.test(path);
 }
 /**
- * Whether a trace recorded a request the server actually failed: a 4xx/5xx, or a network error.
+ * Whether a trace recorded a failed response or a request error other than cancellation.
  *
  * A 404 on a static asset is excepted: `/sw.js` and `/fonts/*` 404 on an app that never shipped
  * them, and naming one as a failure sent m125 into writing the caching worker it had asked about.
- * A 5xx on an asset, or a network error, still counts — the server did fail.
+ * A 5xx on an asset, or a network error, still counts. A request error alone does not locate
+ * the cause in the server: the browser or network may have rejected the request.
  *
  * @param request - One request a trace recorded.
  * @returns True when the request failed in a way the note should name.
@@ -1908,20 +1909,27 @@ export function isStaticAssetRequest(request) {
 export function failedRequest(request) {
     if (isStaticAssetRequest(request) && request.status === 404)
         return false;
-    return request.status >= 400 || (request.status <= 0 && request.failure !== undefined);
+    return request.status >= 400 || (request.status <= 0 && recordedRequestFailure(request));
+}
+/** A browser cancellation records no conclusion about the endpoint's availability. */
+const REQUEST_CANCELLED = /\b(?:net::ERR_ABORTED|NS_BINDING_ABORTED|AbortError)\b|^(?:aborted|cancelled|canceled)$/i;
+/** Whether the request carries a nonempty error that is not an explicit cancellation. */
+function recordedRequestFailure(request) {
+    const failure = request.failure?.trim();
+    return failure !== undefined && failure !== '' && !REQUEST_CANCELLED.test(failure);
 }
 /**
- * Whether a trace recorded NO response and no reason for it — a request that was aborted or still
- * in flight when the test ended. It is not evidence that the server failed (m112 +30:45), and one
- * the page shell made is not evidence about the step at all (m125 +29:33).
+ * Whether a trace recorded no response and no error other than cancellation. The request may
+ * have been pending or cancelled when recording ended; the trace does not establish whether
+ * the endpoint stalled. A shell request is not evidence about the step (m125 +29:33).
  *
  * @param request - One request a trace recorded.
- * @returns True when the request is still in flight and worth naming.
+ * @returns True when the request's missing response is inconclusive and worth naming.
  */
 export function unansweredRequest(request) {
     if (isStaticAssetRequest(request))
         return false;
-    return request.status <= 0 && request.failure === undefined;
+    return request.status <= 0 && !recordedRequestFailure(request);
 }
 /**
  * Whether a trace recorded a DOCUMENT SUBRESOURCE that never finished: a stylesheet, script or
@@ -2200,14 +2208,16 @@ function navigationNeverFinished(item) {
 function transportFailure(items) {
     for (const item of items) {
         const document = item.requests.find((request) => request.type === 'document');
-        const failed = item.requests.find((request) => request.failure !== undefined && NETWORK_ERROR.test(request.failure));
+        const failed = item.requests.find((request) => recordedRequestFailure(request) &&
+            request.failure !== undefined &&
+            NETWORK_ERROR.test(request.failure));
         if (failed !== undefined) {
             const error = NETWORK_ERROR.exec(failed.failure ?? '')?.[0] ?? failed.failure ?? '';
             return { error, where: failed.path };
         }
         for (const line of item.console) {
             const error = NETWORK_ERROR.exec(line)?.[0];
-            if (error !== undefined)
+            if (error !== undefined && !REQUEST_CANCELLED.test(error))
                 return {
                     error,
                     where: document?.path ?? item.requests[0]?.path ?? 'the page',
@@ -2249,27 +2259,22 @@ function isApiPath(path, prefixes) {
     });
 }
 /**
- * The API requests a failing run's traces recorded with NO response, one entry per method+path.
- *
- * A request still in flight is not a server failure on its own ({@link unansweredRequest}), and
- * the note says so. Several API paths left unanswered in one walk is a different fact: the server
- * stopped answering while the tests ran, and the closing "the cause is in the page" reading is
- * then false (xr-molecule-flash-m215 +36:28: three API paths got no response and two `page.goto`
- * calls timed out across a platform restart, and the note sent the run at avatar components and
- * token signing).
+ * The API requests that recorded an error without a response, one entry per method+path.
+ * Missing failure text stays inconclusive regardless of the number of pending requests
+ * (m303/m305). An answer from another endpoint cannot excuse a recorded failure here.
  *
  * @param items - The traces the note is about.
  * @param apiPrefixes - The API prefixes the caller read, or empty.
  * @returns One entry per distinct method+path, in the order the traces recorded them.
  */
-function unansweredApiRequests(items, apiPrefixes) {
+function failedApiRequests(items, apiPrefixes) {
     const groups = new Map();
     for (const item of items) {
         // The step's own requests are also in `item.requests` on a modern trace, but an older reader
         // put them only on the action: count each method+path once per trace, not once per list.
         const seen = new Set();
         for (const request of [...item.requests, ...(item.lastAction?.requests ?? [])]) {
-            if (!unansweredRequest(request))
+            if (request.status > 0 || !failedRequest(request))
                 continue;
             const path = sameOriginPath(request);
             if (path === null || !isApiPath(path, apiPrefixes))
@@ -2304,11 +2309,10 @@ function navigationTimedOut(item, failures) {
     return failure !== undefined && navigationMethod(failure.operation) !== null;
 }
 /**
- * The reading a run gets when the server stopped answering: the API requests with no response and
- * the page loads that never finished, named once so both the lead and the closing sentence carry
- * the same fact.
+ * Recorded API errors without responses and page loads that never finished. Both the lead and
+ * closing sentence name the evidence without assigning a server, network, or browser cause.
  *
- * @param requests - The API requests the traces recorded with no response.
+ * @param requests - The API requests that recorded errors without a response.
  * @param navigations - How many traced failures were a navigation that never finished.
  * @param capital - True to start a sentence, false to continue one.
  * @returns The sentence, without a trailing period run or a next step.
@@ -2320,15 +2324,14 @@ function serverSilentReading(requests, navigations, capital) {
     const more = requests.length > shown.length ? ` and ${requests.length - shown.length} more` : '';
     const asked = requests.length === 0
         ? ''
-        : `${requests.length} API ${requests.length === 1 ? 'request' : 'requests'} got no response` +
+        : `${requests.length} API ${requests.length === 1 ? 'request' : 'requests'} failed without a response` +
             (shown.length === 0 ? '' : ` (${shown.join(', ')}${more})`);
     const loads = navigations === 0
         ? ''
         : `${navigations} page ${navigations === 1 ? 'load' : 'loads'} never finished`;
     const what = [asked, loads].filter((part) => part !== '').join(' and ');
-    return (`${capital ? 'The' : 'the'} server did not answer: ${what}. That is the app — a restart, a ` +
-        'cold start, or a request the server never finishes — being unavailable while these tests ' +
-        'ran, not page state.');
+    return (`${capital ? 'The' : 'the'} trace recorded incomplete requests or page loads: ${what}. ` +
+        'This does not identify whether the cause is in the server, network, or browser.');
 }
 /**
  * The path segments a request ASKS FOR a credential through — a login, a registration, a token
@@ -3397,15 +3400,13 @@ export function failureTraceNote(items, target, earlierFailures = [], apiPrefixe
         ...new Set(stalls.flatMap((stall) => (stall === null ? [] : [stall.reported]))),
     ];
     const anyStalled = stalls.some((stall) => stall !== null);
-    // The server stopped answering while the tests ran (m215): several API requests with no
-    // response, or a navigation that never finished. A single request still in flight is not this
-    // (m112), and the note must never close with "the cause is in the page" beside it — the run
-    // then rewrites the page while the API was the thing that never answered.
-    const silentApiRequests = unansweredApiRequests(traced, apiPrefixes);
+    // A recorded request error or navigation deadline is evidence of a failed attempt, not proof
+    // of its cause. Pending requests remain inconclusive at every count (m303/m305).
+    const silentApiRequests = failedApiRequests(traced, apiPrefixes);
+    const hasPendingRequests = traced.some((item) => [...item.requests, ...(item.lastAction?.requests ?? [])].some(unansweredRequest));
     const silentNavigations = traced.filter((item) => navigationTimedOut(item, failures)).length;
     const serverSilent = silentApiRequests.length >= 2 || silentNavigations > 0;
-    // A single unanswered request stays what it always was (m112). Two or more distinct API paths
-    // are a fact about the server, and it leads the note before any row.
+    // Multiple recorded API failures lead the note; no response alone cannot trigger this.
     const serverSilentLead = silentApiRequests.length < 2
         ? ''
         : `${serverSilentReading(silentApiRequests, silentNavigations, true)}\n\n`;
@@ -3529,7 +3530,7 @@ export function failureTraceNote(items, target, earlierFailures = [], apiPrefixe
         if (unanswered.length > 0 && room > 0) {
             const shown = unanswered.slice(0, room);
             room -= shown.length;
-            parts.push(`no response recorded — still in flight when the test ended, so not a server failure; ` +
+            parts.push(`no response recorded — possibly still in flight when the test ended or cancelled; ` +
                 `that alone does not establish the cause: ${shown.map(requestLabel).join('; ')}`);
         }
         if (answered.length > 0 && room > 0) {
@@ -3755,19 +3756,23 @@ export function failureTraceNote(items, target, earlierFailures = [], apiPrefixe
                                 // a fact about the element, so it replaces the "look at the page" advice (m197).
                                 hiddenBox
                             : serverSilent
-                                ? // The server did not answer (m215): a page-state reading would send the run at
-                                    // the markup while nothing answered it. Same fact as the lead, and the one action.
+                                ? // A navigation deadline must not be presented as proof of page-state failure.
+                                    // Name the incomplete load without claiming why it did not finish.
                                     'No listed request failed — none got a 4xx/5xx or a network error — but ' +
                                         `${serverSilentReading(silentApiRequests, silentNavigations, false)} ` +
-                                        `Re-run only these tests against ${target} (\`--last-failed\`) before changing ` +
-                                        'any code; change the app only if they fail again with requests that answered.'
-                                : 'No listed request failed — none got a 4xx/5xx or a network error — so the cause is in the ' +
-                                    "page, not the API. Start with what the test's last action sent (the first line of each " +
-                                    'row) and what the page did next: a request that answered (2xx included) while the page ' +
-                                    'still did not show the state the assertion waited on is the fact to read — its status ' +
-                                    'and response body, not the selector. If the request is not the one the test meant — an ' +
-                                    'unfollow sent where the test clicked follow — the state the action read was stale ' +
-                                    'before it.') +
+                                        `Re-run only these tests against ${target} (\`--last-failed\`) or inspect the app's ` +
+                                        'runtime log for the same window to distinguish the cause.'
+                                : hasPendingRequests
+                                    ? 'No listed request failed with a 4xx/5xx or a network error, but some requests have no ' +
+                                        'recorded response. This does not establish whether the server stalled or the browser cancelled ' +
+                                        'the request. Read the pending paths alongside the failed action and its timeout.'
+                                    : 'No listed request failed with a 4xx/5xx or a network error. That does not establish ' +
+                                        "that its response body or the page state was correct. Read what the test's last action sent (the first line of each " +
+                                        'row) and what the page did next: a request that answered (2xx included) while the page ' +
+                                        'still did not show the state the assertion waited on is the fact to read — its status ' +
+                                        'and response body, not the selector. If the request is not the one the test meant — an ' +
+                                        'unfollow sent where the test clicked follow — the state the action read was stale ' +
+                                        'before it.') +
         prefixAdvice +
         (wrapped
             ? ' The API received a body wrapped in `data`: app-http’s `post(url, data, config)` / ' +

package/package.json

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