@molecule/api-ai-tools 1.6.5 → 1.6.6

package/dist/cut-run.js

@@ -0,0 +1,267 @@
+/**
+ * A command that a budget stopped before it finished, and the state its result carries so no
+ * reader can mistake it for a run that ended.
+ *
+ * X1 xr-molecule-flash-m93 (2026-10-16, +12:37) sent the supplied RealWorld suite as
+ * `timeout 280 hurl --test --continue-on-error --jobs 1 … hurl/*.hurl 2>&1 | tail -60` and got
+ * back `exitCode: 0`, four finished files' lines and nothing else. Two lies in one result: the
+ * `timeout 280` killed the run at 280 s, and the `| tail` made the pipeline's status the status —
+ * so the executor read a suite that stopped at its fifth file as a suite that ran and nearly
+ * passed, fixed one message, and immediately sent the same 280-second command again (the run's
+ * third, ~14 minutes of a 60-minute cap across three of them).
+ *
+ * So the tool never reports a stopped run as `exitCode: 0`. Such a result carries
+ * `status: 'cut_at_budget'` and an exit code that is `null` whenever the number the pipeline
+ * reported belongs to the filter rather than to the run, and every reader of a run's verdict reads
+ * the state through {@link commandRunState} — a cut run is NOT RUN, never a pass.
+ *
+ * Two things stop a run, and both are read from the command and the result, never inferred:
+ *
+ * 1. **Its own bound** — a `timeout <N>` the command carries ({@link commandTimeoutSeconds}). The
+ *    run used it, so the run was killed at it; with no closing tally in the output, the run did
+ *    not finish. This is m93's shape.
+ * 2. **This tool's budget** — the backend runs the command under `timeout` (see
+ *    `backends/sandbox.ts`), which reports 124 whatever the pipeline did, and returns everything
+ *    printed until then. The budget is the tool's own, so its number belongs to the tool.
+ *
+ * @module
+ */
+import { commandTimeoutSeconds } from './command-position.js';
+import { isSuiteRunCommand } from './utilities.js';
+/**
+ * The state a result carries when a budget stopped its command: a run that did not finish is not a
+ * run that passed, and no reader may treat it as one.
+ */
+export const CUT_AT_BUDGET = 'cut_at_budget';
+/**
+ * The state a command's result records — THE reader every verdict about a run goes through.
+ *
+ * A result that carries no state is a run that ended: the state is written where the run is
+ * stopped ({@link commandCutRun}), so a result without it was never stopped by a budget this
+ * platform set or can see. Results produced before this state existed read the same way, which is
+ * what keeps a past turn's tally readable.
+ *
+ * @param result - The exec_command / wait_for_task result.
+ * @returns The state the result records.
+ */
+export function commandRunState(result) {
+    if (result === null || typeof result !== 'object')
+        return 'ran';
+    return result.status === CUT_AT_BUDGET ? CUT_AT_BUDGET : 'ran';
+}
+/**
+ * The gap between a bound and the elapsed time a run killed at it reports. Zero, and deliberately
+ * not a tolerance: a command killed at its bound reports AT LEAST the bound (the shell's own
+ * bookkeeping runs after the kill, and this tool's round trip is on top), so any slack would only
+ * make a SHORT bound fire on a run that finished inside it (`timeout 5 curl …` answering in 3 s).
+ * A run that finished near its bound carried its runner's closing summary — {@link suiteTally}.
+ *
+ * @param boundSeconds - The bound the run was allowed.
+ * @returns The elapsed ms a run stopped at that bound reports at least.
+ */
+function atBoundMs(boundSeconds) {
+    return boundSeconds * 1000;
+}
+/**
+ * A runner's closing summary, printed only by a run that walked its whole suite: Hurl's
+ * `Executed files:` block and the `N passed` / `N failed` / `N flaky` line Playwright and Vitest
+ * print when they finish.
+ *
+ * This is what separates "stopped at the bound" from "used the bound and finished": a suite that
+ * printed its summary ran to its end, and is read as the run it was.
+ */
+const SUITE_TALLY = /\bExecuted files:\s*\d+|\b\d+\s+(?:passed|failed|flaky|skipped)\b/;
+/**
+ * Whether text carries a runner's closing summary ({@link SUITE_TALLY}).
+ *
+ * @param text - The run's stdout and stderr.
+ * @returns True when the runner's own end-of-run summary is there.
+ */
+export function suiteTally(text) {
+    return SUITE_TALLY.test(text);
+}
+/** The last thing a run printed: its last non-blank line, as one line and short enough to quote. */
+function lastPrinted(text) {
+    const lines = text.split('\n');
+    for (let i = lines.length - 1; i >= 0; i -= 1) {
+        const line = (lines[i] ?? '').trim();
+        if (line)
+            return line.length > 180 ? `${line.slice(0, 177)}…` : line;
+    }
+    return null;
+}
+/** Hurl's per-file line: `Success hurl/articles.hurl (17 request(s) in 318 ms)`. */
+const HURL_FILE_LINE = /^(?:Success|Failure)\s+(\S+)/gm;
+/** Playwright's progress line — `[5/13] specs/auth.spec.ts:10:5 › signs up`. */
+const PROGRESS_LINE = /^\s*\[(\d+)\/(\d+)\]/gm;
+/**
+ * What the runner's own output says the run got through.
+ *
+ * Hurl prints a line per finished file and no total unless it finished; Playwright's line reporter
+ * prints `[n/K]` with both numbers. Neither is inferred from the command — a run that printed
+ * nothing says nothing, which is what `null` means here.
+ *
+ * @param text - The run's stdout and stderr.
+ * @param suite - Whether the command runs a suite.
+ * @returns How many finished, how many the run was walking, and the noun.
+ */
+function runProgress(text, suite) {
+    const files = new Set();
+    for (const m of text.matchAll(HURL_FILE_LINE))
+        files.add(m[1] ?? '');
+    if (files.size > 0)
+        return { ran: files.size, total: null, noun: 'files' };
+    let ran = null;
+    let total = null;
+    for (const m of text.matchAll(PROGRESS_LINE)) {
+        ran = Number(m[1]);
+        total = Number(m[2]);
+    }
+    if (ran !== null)
+        return { ran, total, noun: 'tests' };
+    return { ran: null, total: null, noun: suite ? 'tests' : 'files' };
+}
+/**
+ * The run a command's result records as stopped by a budget, or null when the result is a run that
+ * ended (or says nothing about a run).
+ *
+ * Evidence, in order — never a guess:
+ *
+ * - `timeout`'s own 124 (the code the backend's wrapper returns whenever the TOOL's budget fired,
+ *   whatever the pipeline ended with) — and, when the clock says the command's own smaller bound
+ *   ran out first and less than the budget, that bound instead.
+ * - the command carried its own `timeout <N>`, N is inside this tool's budget (a larger one never
+ *   fires — the tool's does), the run used N, and no runner printed a closing summary: the run was
+ *   killed at its own bound. Its exit code, when the pipeline handed one back, is the filter's.
+ * - the run used this tool's whole budget behind a filter that withheld its output, and printed no
+ *   closing summary: the budget stopped it, and no code in the result is the run's.
+ *
+ * @param command - The command the executor sent.
+ * @param result - Its result.
+ * @param elapsedMs - How long the command ran, in ms.
+ * @param budgetSeconds - This tool's foreground budget, in seconds (0 when it has none).
+ * @returns The stopped run, or null.
+ */
+export function commandCutRun(command, result, elapsedMs, budgetSeconds = 0) {
+    if (typeof command !== 'string' || !command.trim())
+        return null;
+    if (result === null || typeof result !== 'object')
+        return null;
+    if (!Number.isFinite(elapsedMs))
+        return null;
+    const r = result;
+    const exitCode = typeof r.exitCode === 'number' ? r.exitCode : null;
+    const text = `${String(r.stdout ?? '')}\n${String(r.stderr ?? '')}`;
+    // A suite that printed its summary ran to its end, whatever it was wrapped in.
+    if (suiteTally(text))
+        return null;
+    const suite = isSuiteRunCommand(command);
+    const withheld = /\|\s*(?:tail|head|grep|egrep|fgrep|sort|uniq|wc|jq)\b/.test(command);
+    const progress = runProgress(text, suite);
+    const doing = lastPrinted(text);
+    const declared = commandTimeoutSeconds(command);
+    // A command whose own bound is inside this tool's budget is stopped by ITS bound: a larger one
+    // never gets the chance — the backend's `timeout` fires first (see the module doc). With no
+    // 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);
+    // `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
+    // at its own bound reports at least that bound and less than the budget.
+    if (budgetSeconds > 0 && exitCode === 124) {
+        const ownFired = declared !== null &&
+            ownBoundStops &&
+            elapsedMs >= atBoundMs(declared) &&
+            elapsedMs < atBoundMs(budgetSeconds);
+        return {
+            seconds: ownFired ? declared : budgetSeconds,
+            stoppedBy: ownFired ? 'command-timeout' : 'tool-budget',
+            exitCode,
+            ...progress,
+            doing,
+        };
+    }
+    if (declared !== null && ownBoundStops && elapsedMs >= atBoundMs(declared)) {
+        return {
+            seconds: declared,
+            stoppedBy: 'command-timeout',
+            // A code the filter produced is not the run's: `… | tail` handed back 0 forever (m93).
+            exitCode: withheld || exitCode === 0 ? null : exitCode,
+            ...progress,
+            doing,
+        };
+    }
+    // The tool's budget with its code masked: the run used the whole budget and the pipeline left
+    // nothing readable of it — no code of its own, and no runner's closing summary.
+    if (budgetSeconds > 0 && withheld && elapsedMs >= atBoundMs(budgetSeconds)) {
+        return {
+            seconds: budgetSeconds,
+            stoppedBy: 'tool-budget',
+            exitCode: exitCode === 0 ? null : exitCode,
+            ...progress,
+            doing,
+        };
+    }
+    return null;
+}
+/**
+ * The facts a result records about the run a budget stopped it in — what a reader needs to say
+ * how far the run got WITHOUT re-reading its log or re-deriving the counts.
+ *
+ * The numbers are read from the runner's own output where it printed them (Hurl's per-file lines,
+ * Playwright's `[n/K]`), so a caller that can also see the suite itself — the file count of the
+ * `*.hurl` directory the run walked — fills in the `total` this could not know, and both then say
+ * the same sentence ({@link cutRunSentence}).
+ *
+ * @param result - The exec_command / wait_for_task result.
+ * @returns The facts the result carries, or null when it records no stopped run.
+ */
+export function cutRunFacts(result) {
+    if (result === null || typeof result !== 'object')
+        return null;
+    if (commandRunState(result) !== CUT_AT_BUDGET)
+        return null;
+    const cut = result.cutRun;
+    if (cut === null || typeof cut !== 'object')
+        return null;
+    const c = cut;
+    if (typeof c.seconds !== 'number' || typeof c.stoppedBy !== 'string')
+        return null;
+    return {
+        seconds: c.seconds,
+        stoppedBy: c.stoppedBy,
+        exitCode: typeof c.exitCode === 'number' ? c.exitCode : null,
+        ran: typeof c.ran === 'number' ? c.ran : null,
+        total: typeof c.total === 'number' ? c.total : null,
+        noun: c.noun === 'tests' ? 'tests' : 'files',
+        doing: typeof c.doing === 'string' && c.doing ? c.doing : null,
+    };
+}
+/**
+ * The first line of a stopped run's result: how long it was allowed, what stopped it, how far it
+ * got, and the last thing it printed.
+ *
+ * Written to be quotable by the model in one sentence and to leave no room for "nearly passing":
+ * the counts come from the runner's own output ({@link runProgress}), and a `total` the caller
+ * read elsewhere (the suite's own file count) fills in the "M of K" it can then state.
+ *
+ * @param run - The stopped run.
+ * @returns The sentence.
+ */
+export function cutRunSentence(run) {
+    const by = run.stoppedBy === 'tool-budget' ? "this tool's limit" : `its own \`timeout ${run.seconds}\``;
+    const lead = `This run was stopped after ${run.seconds}s (${by})`;
+    const count = run.ran !== null && run.total !== null
+        ? `: ${run.ran} of ${run.total} ${run.noun} ran, the rest did not run`
+        : run.ran !== null
+            ? `: ${run.ran} ${run.noun} ran and the rest did not run`
+            : ' before it finished';
+    const doing = run.doing ? `; the last thing it was doing: ${run.doing}` : '';
+    // Why the result carries no code: without this the model reads the missing field as an
+    // omission, and the number it used to read there was the pipeline's own 0.
+    const code = run.exitCode === null
+        ? ' It has no exit code of its own to report — the one this pipeline produced belongs to the filter, not to the run.'
+        : '';
+    return `${lead}${count}${doing}.${code}`;
+}

package/dist/index.d.ts

@@ -133,6 +133,7 @@ export * from './backends/local.js';
 export * from './backends/sandbox.js';
 export * from './browser-guard.js';
 export * from './command-position.js';
+export * from './cut-run.js';
 export * from './input-normalizer.js';
 export * from './no-test-run.js';
 export * from './schemas.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,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,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,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA"}

package/dist/index.js

@@ -133,6 +133,7 @@ export * from './backends/local.js';
 export * from './backends/sandbox.js';
 export * from './browser-guard.js';
 export * from './command-position.js';
+export * from './cut-run.js';
 export * from './input-normalizer.js';
 export * from './no-test-run.js';
 export * from './schemas.js';

package/dist/tools.d.ts

@@ -26,6 +26,26 @@ import type { AITool } from '@molecule/api-ai';
  */
 export declare function taskStopCommand(backend: ExecutionBackend, taskId: string): Promise<string>;
 import type { ExecutionBackend, ToolBuildConfig } from './types.js';
+/**
+ * The closing advice on an over-budget message for a command that is not a test
+ * suite: the work it was chaining is what to split.
+ */
+export declare const SPLIT_WORK_ADVICE: string;
+/**
+ * The closing advice on an over-budget message for a command that IS a suite run
+ * (Playwright, Vitest, a `hurl` run — {@link isSuiteRunCommand}): its files are not
+ * a bigger unit to break up.
+ *
+ * X1 flash-m36 asked for this half and the message kept saying "run a smaller unit"
+ * for two months. It is the wrong direction for a suite, and measurably: a run
+ * stopped here reports NO tally, so nothing in the result says which test or request
+ * hung — the run has to be sent again in the background (off this budget, its output
+ * written to a log that can be read mid-run) or, when a consumer knows the runner's
+ * per-request limit, with each request bounded. xr-molecule-flash-m93 (+06:22,
+ * 2026-10-16) lost 4.8 minutes to a Hurl run whose ONE unanswered request had hurl's
+ * 300 s default per request holding the file, ten seconds past this tool's budget.
+ */
+export declare const SUITE_OVER_BUDGET_ADVICE: string;
 /**
  * The steer attached to a SUCCESSFUL read of a package's built output. The ENOENT
  * redirect below fires only when the read FAILS, so a model that knows the hoisted

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAiF9C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAahG;AAwHD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAoEnE;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUhE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsBxE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,EAAE,CAgjExF"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAkF9C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAahG;AAwHD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAgEnE;;;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;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsBxE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,EAAE,CAipExF"}

package/dist/tools.js

@@ -6,6 +6,7 @@
  *
  * @module
  */
+import { commandCutRun, CUT_AT_BUDGET, cutRunSentence } from './cut-run.js';
 import { addChangeSpan, changedSpan, countLines, renderEditExcerpt, renderSmallFile, } from './edit-excerpt.js';
 import { guardToolExecute, missingParamError, ToolInputError } from './input-normalizer.js';
 import { TOOL_SCHEMAS } from './schemas.js';
@@ -208,12 +209,43 @@ function runningNote(clauses) {
     const joined = clauses.join('; ');
     return `${joined[0].toUpperCase()}${joined.slice(1)}.`;
 }
-import { checkBlockedCommand, declaredBudgetSeconds, DEFAULT_SEARCH_EXCLUDED_DIRS, directoryReadHint, emptyCallError, failureCausesNote, findPatternArgs, fusedLine, htmlOutline, isEnvFilePath, isOutsideRoot, isPlaywrightRunCommand, isValidGlob, linesWithinSerialized, 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, serializedChars, shellQuote, sliceLines, SMALL_FILE_WHOLE_CHARS, streamingBackgroundCommand, stripControlChars, suiteRunPriorityLaunch, truncateMiddle, universalCause, whitespaceTolerantReplace, } from './utilities.js';
+import { checkBlockedCommand, declaredBudgetSeconds, DEFAULT_SEARCH_EXCLUDED_DIRS, directoryReadHint, 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, suiteRunPriorityLaunch, truncateMiddle, universalCause, whitespaceTolerantReplace, } 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.
  */
 const OVER_CEILING_GRACE_MS = 45_000;
+/**
+ * The closing advice on an over-budget message for a command that is not a test
+ * suite: the work it was chaining is what to split.
+ */
+export const SPLIT_WORK_ADVICE = 'Run a smaller unit per command (one test file, one build step) instead of chaining ' +
+    'a build and a whole suite.';
+/**
+ * The closing advice on an over-budget message for a command that IS a suite run
+ * (Playwright, Vitest, a `hurl` run — {@link isSuiteRunCommand}): its files are not
+ * a bigger unit to break up.
+ *
+ * X1 flash-m36 asked for this half and the message kept saying "run a smaller unit"
+ * for two months. It is the wrong direction for a suite, and measurably: a run
+ * stopped here reports NO tally, so nothing in the result says which test or request
+ * hung — the run has to be sent again in the background (off this budget, its output
+ * written to a log that can be read mid-run) or, when a consumer knows the runner's
+ * per-request limit, with each request bounded. xr-molecule-flash-m93 (+06:22,
+ * 2026-10-16) lost 4.8 minutes to a Hurl run whose ONE unanswered request had hurl's
+ * 300 s default per request holding the file, ten seconds past this tool's budget.
+ */
+export const SUITE_OVER_BUDGET_ADVICE = 'A test suite is not a bigger unit to split: stopped here it reports no tally at all, so nothing ' +
+    'in this result says which test or request never finished — run it in the background ' +
+    '(`run_in_background`, then `wait_for_task`), which takes it off this budget and writes its output ' +
+    "to a log, and read that log (or the app's own log) for what it was waiting on.";
+/**
+ * How long a tree walk (`find_files`, `search_files`) may run before the backend's
+ * own deadline stops it. Both tools answer that deadline in their own words
+ * (see searchTimeoutError) rather than forwarding the sandbox SDK's `timeoutMs`
+ * sentence, which names an option the executor cannot set.
+ */
+const SEARCH_TIMEOUT_MS = 10_000;
 /**
  * The share of its budget a command must use before the "you asked for more than
  * this tool's ceiling" note is worth attaching. Below it the clamp changed nothing
@@ -1484,7 +1516,7 @@ export function buildTools(backend, config) {
                 // -H: a search scoped to one file printed `line:content` with no file, and every match
                 // came back `{file: "", line: 0}` (X1 flash-m62).
                 const grepArgs = `-rnH ${globArg} ${contextArg} ${grepExcludeArgs(path)} --max-count=${MAX_SEARCH_RESULTS} -- ${shellQuote(pattern)} ${shellQuote(path)}`;
-                const result = await backend.run(`{ grep -E ${grepArgs}; s=$?; if [ "$s" -eq 2 ]; then grep -F ${grepArgs}; fi; } 2>/dev/null || true`, { timeout: 10000 });
+                const result = await backend.run(`{ grep -E ${grepArgs}; s=$?; if [ "$s" -eq 2 ]; then grep -F ${grepArgs}; fi; } 2>/dev/null || true`, { timeout: SEARCH_TIMEOUT_MS });
                 // grep emits `<file>:<line>:<content>`, so redaction runs PER MATCH on the
                 // content alone: the file prefix would otherwise hide an env assignment from
                 // the line-anchored env pattern, and knowing each match's own path is what
@@ -1521,6 +1553,11 @@ export function buildTools(backend, config) {
                 return { pattern, path, matches };
             }
             catch (e) {
+                if (isCommandTimeout(e))
+                    return {
+                        error: searchTimeoutError('search_files', path, pattern, SEARCH_TIMEOUT_MS / 1000, `Give \`path\` the subdirectory you mean and narrow with \`include\` ` +
+                            `(e.g. "*.ts"), or use find_files with the directory in the pattern.`),
+                    };
                 return { error: `Search failed: ${e.message}` };
             }
         },
@@ -1542,21 +1579,54 @@ export function buildTools(backend, config) {
             const symlinkErr = await checkSymlink(path);
             if (symlinkErr)
                 return { error: symlinkErr };
+            // The directory the PATTERN itself names (`node_modules` +
+            // `@molecule/api-resource-user/dist/*.d.ts`) becomes the search root. Matched
+            // against the whole path with an implicit "any parent" anchor, the pattern
+            // made `find` visit every entry below `path` — the whole dependency tree,
+            // which hit the 10 s deadline with no result at all while the one directory
+            // the model meant answered a `list_files` instantly (xr-molecule-flash-m94).
+            // A bare first segment (`helpers/*`) is left alone on purpose: it means "any
+            // `helpers/` below the root" (xr-molecule-flash-m77, see literalDirPrefix).
+            const prefixDir = literalDirPrefix(pattern);
+            let findRoot = path;
+            let findArgs = findPatternArgs(pattern);
+            let missingPrefix;
             try {
+                if (prefixDir) {
+                    const candidate = `${path.replace(/\/+$/, '')}/${prefixDir}`;
+                    const probe = await backend.run(`test -d ${shellQuote(candidate)}`, {
+                        timeout: SEARCH_TIMEOUT_MS,
+                    });
+                    if (probe.exitCode === 0) {
+                        findRoot = candidate;
+                        // The remainder keeps the `-path` form: `*` crosses `/`, so a `.d.ts`
+                        // in `dist/utilities/` is still found (see findPathArgs).
+                        findArgs = findPathArgs(pattern.replace(/^(?:\.?\/)+/, '').slice(prefixDir.length + 1));
+                    }
+                    else {
+                        missingPrefix = `"${candidate}" does not exist; searched all of ${path}.`;
+                    }
+                }
                 // `findPatternArgs`, not `-name`: a pattern with a `/` in it
                 // (`helpers/*`, `e2e/*.spec.ts`) matched nothing at all, because `-name`
                 // compares it against the basename (xr-molecule-flash-m77).
-                const result = await backend.run(`find ${shellQuote(path)} ${findPruneArgs(path)} ${findPatternArgs(pattern)} -print 2>/dev/null | head -${MAX_FIND_RESULTS}`, { timeout: 10000 });
+                const result = await backend.run(`find ${shellQuote(findRoot)} ${findPruneArgs(findRoot)} ${findArgs} -print 2>/dev/null | head -${MAX_FIND_RESULTS}`, { timeout: SEARCH_TIMEOUT_MS });
                 const files = result.stdout.trim().split('\n').filter(Boolean);
                 // A slash changes what the pattern means — the whole path, not the file
                 // name — and an empty result does not say so, so the model reads it as
                 // "no such file" and goes looking elsewhere. Name the rule on the miss.
-                const note = files.length === 0 && pattern.includes('/')
+                const missNote = files.length === 0 && pattern.includes('/')
                     ? `"${pattern}" contains a "/", so it was matched against each file's PATH below ${path} (a leading "*/" is implicit), not against the file name — no path matched it. list_files shows the real entries.`
                     : undefined;
-                return { pattern, path, files, ...(note ? { note } : {}) };
+                const notes = [missingPrefix, missNote].filter((n) => Boolean(n));
+                return { pattern, path, files, ...(notes.length ? { note: notes.join(' ') } : {}) };
             }
             catch (e) {
+                if (isCommandTimeout(e))
+                    return {
+                        error: searchTimeoutError('find_files', findRoot === path ? path : `${findRoot} (under ${path})`, pattern, SEARCH_TIMEOUT_MS / 1000, `Give \`path\` the directory you mean (a package's own folder rather than all of ` +
+                            `${path}) or use list_files on it, and keep the pattern narrow.`),
+                    };
                 return { error: `Find failed: ${e.message}` };
             }
         },
@@ -1825,18 +1895,31 @@ export function buildTools(backend, config) {
                     : sanitizeOutput;
                 const stdout = grade(truncateMiddle(result.stdout, MAX_OUTPUT_SIZE));
                 const stderr = sanitizeOutput(truncateMiddle(result.stderr, MAX_OUTPUT_SIZE));
-                if (budgetSeconds && result.exitCode === 124) {
+                // A run a budget stopped is NOT a run that ended: it reports `status: 'cut_at_budget'`,
+                // never a 0 the pipeline produced, and names how far it got. Read from the command, the
+                // output and the clock in one place (cut-run.ts) so every reader of a run's verdict reads
+                // the same state (X1 xr-molecule-flash-m93: `timeout 280 hurl … | tail -60` came back
+                // `exitCode: 0` after 284 s and four of thirteen files, and the executor re-sent it).
+                const cut = commandCutRun(command, { exitCode: result.exitCode, stdout, stderr }, elapsedMs, budgetSeconds);
+                if (cut) {
+                    const cutLead = cutRunSentence(cut);
                     return {
                         stdout,
                         stderr,
-                        exitCode: result.exitCode,
-                        error: `The command was stopped after ${budgetSeconds}s, this tool's limit; the output above is ` +
-                            'everything it printed until then' +
-                            (/\|\s*(tail|head)\b/.test(command)
-                                ? ' — and a pipe through tail/head holds everything back until the command ends, so it printed nothing: run it without the pipe (use a line reporter and let the output stream)'
+                        status: CUT_AT_BUDGET,
+                        exitCode: cut.exitCode,
+                        // The facts, so a reader that can also see the suite itself (its own `.hurl` file
+                        // count) says the same sentence with the total the output alone cannot give.
+                        cutRun: cut,
+                        error: `${cutLead} ` +
+                            // The tool's own budget stopping a run that printed nothing: keep the sentence that
+                            // says why the output is empty, since nothing else in the result can say it.
+                            (cut.stoppedBy === 'tool-budget'
+                                ? `The output above is everything it printed until then${/\|\s*(tail|head)\b/.test(command)
+                                    ? ' — and a pipe through tail/head holds everything back until the command ends, so it printed nothing: run it without the pipe (use a line reporter and let the output stream)'
+                                    : ''}. `
                                 : '') +
-                            '. Run a smaller unit per command (one test file, one build step) instead of chaining ' +
-                            'a build and a whole suite.',
+                            (isSuiteRunCommand(command) ? SUITE_OVER_BUDGET_ADVICE : SPLIT_WORK_ADVICE),
                     };
                 }
                 return {
@@ -2175,6 +2258,28 @@ export function buildTools(backend, config) {
             // the second and third were found by runs stopped before they walked the rest. Null for
             // anything that is not a run with failures in it.
             const causes = failureCausesNote(output);
+            // A backgrounded run is under no tool budget, and the exit file hands back the PIPELINE's
+            // code — so a suite killed at a `timeout 280` the command carried behind a `| tail` reports
+            // 0 here too. The run's start is in its own id ({@link taskStartedAt}), so the bound it used
+            // is readable without new state: say stopped, and never hand the pipeline's 0 back as the
+            // run's (X1 xr-molecule-flash-m93 re-sent that run three times).
+            const run = runByTask.get(taskId);
+            const startedAtMs = taskStartedAt(taskId);
+            const cut = run && startedAtMs !== null
+                ? commandCutRun(run.command, { exitCode, stdout: output, stderr: '' }, Date.now() - startedAtMs, 0)
+                : null;
+            if (cut) {
+                return {
+                    taskId,
+                    status: CUT_AT_BUDGET,
+                    exitCode: cut.exitCode,
+                    waitedMs,
+                    cutRun: cut,
+                    note: [cutRunSentence(cut), causes].filter((n) => Boolean(n)).join(' '),
+                    stdout: sanitizeOutput(truncateMiddle(output, MAX_OUTPUT_SIZE)),
+                    ...(output.length > MAX_OUTPUT_SIZE ? { truncated: true, fullOutput: log } : {}),
+                };
+            }
             // Same shaping as a foreground exec result, so the executor reads both
             // the same way.
             return {

package/dist/utilities.d.ts

@@ -274,6 +274,81 @@ export declare function isValidGlob(pattern: string): boolean;
  *   `-path '…'` alternatives, ORed inside parens when there is more than one.
  */
 export declare function findPatternArgs(pattern: string): string;
+/**
+ * The `-path` alternatives of {@link findPatternArgs}, for a pattern whose
+ * directory the caller has already rooted the search at.
+ *
+ * `find_files` narrows the search root itself when the pattern spells its own
+ * directory out (see {@link literalDirPrefix}) — `node_modules` plus
+ * `@molecule/api-resource-user/dist/*.d.ts` searched that one directory. The
+ * remainder (`*.d.ts`) must then keep the `-path` form rather than collapsing to
+ * `-name`: `*` crosses `/` in an fnmatch glob, so the `-path` form still finds a
+ * declaration file in a `dist/utilities/` subdirectory, which `-name '*.d.ts'`
+ * would drop (a silent partial answer, which is worse than the timeout it
+ * replaced).
+ *
+ * @param pattern - The pattern's remainder, with a `/` in it or not.
+ * @returns One or more `-path '…'` alternatives, ORed inside parens when there
+ *   is more than one.
+ */
+export declare function findPathArgs(pattern: string): string;
+/**
+ * The directory a GLOB pattern spells out, when it spells one out: everything
+ * before the pattern's first glob character, trimmed back to the last `/`.
+ *
+ * A pattern is matched against the whole path with a leading "any parent"
+ * anchor ({@link findPatternArgs}), so `find` visits every entry below the
+ * search root. Handed `/workspace/node_modules` and
+ * `@molecule/api-resource-user/dist/*.d.ts` — a directory named outright —
+ * `find` walked the sandbox's entire dependency tree and hit the tool's 10 s
+ * deadline without printing a result (xr-molecule-flash-m94: the one directory
+ * the model meant answered a `list_files` in 0 s). The literal prefix is that
+ * directory, and rooting the search at it is what keeps the call instant.
+ *
+ * A BARE first segment (`helpers/*`, `bonds/*`, `e2e/*.spec.ts`) is NOT one:
+ * `helpers/*` means "a `helpers/` directory anywhere below the root", which the
+ * tool documents and a live run relied on (xr-molecule-flash-m77 — a path
+ * pattern is not anchored to one depth). Rooting those at
+ * `<root>/helpers` would answer with a SUBSET, silently: the nested
+ * `api/src/helpers/` matches would disappear, and a missing file reads as
+ * "no such file". So a prefix is returned only when it names a path of two or
+ * more segments (`@molecule/api-resource-user/dist`), which is the shape that
+ * is a directory rather than a directory name.
+ *
+ * @param pattern - A pattern already accepted by {@link isValidGlob}.
+ * @returns The literal directory prefix, without a trailing slash, or null when
+ *   the pattern has no glob character, no `/`, or only a bare name before one.
+ */
+export declare function literalDirPrefix(pattern: string): string | null;
+/**
+ * Whether a backend error is the sandbox's own command deadline.
+ *
+ * The E2B SDK answers a timed-out `exec` with its generic text —
+ * `[deadline_exceeded] the operation timed out: … It can be modified by passing
+ * 'timeoutMs' when making the request. Use '0' to disable the timeout.` — which
+ * names an option the executor cannot set and says nothing about the search
+ * that died. Handing that sentence to the model is what xr-molecule-flash-m94
+ * read after `find_files` spent 10 s walking `node_modules`; the tool answers
+ * the deadline in its own words instead (see {@link searchTimeoutError}).
+ *
+ * @param error - The error the backend threw.
+ * @returns True when the error reads as a timeout or a deadline.
+ */
+export declare function isCommandTimeout(error: unknown): boolean;
+/**
+ * The answer a search tool gives when the backend's deadline fires: what was
+ * searched, for what, how long the tool allowed, and the two ways to get an
+ * answer — a narrower `path`, or a listing. Never the vendor's `timeoutMs`
+ * sentence (see {@link isCommandTimeout}).
+ *
+ * @param tool - The tool that timed out (`find_files`, `search_files`).
+ * @param searched - The directory the search actually covered.
+ * @param pattern - The pattern it was searching for.
+ * @param seconds - The tool's own limit, in seconds.
+ * @param hint - What to do differently — the narrower target or the listing tool.
+ * @returns The message's text.
+ */
+export declare function searchTimeoutError(tool: string, searched: string, pattern: string, seconds: number, hint: string): string;
 /**
  * Validate a file tool's `path` argument is a non-empty string. A weak model
  * sometimes omits it or passes a non-string, which would otherwise crash

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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"}