@molecule/api-ai-tools 1.6.4 → 1.6.6

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
@@ -691,6 +766,27 @@ export declare function failuresByCause(log: string): FailureCause[];
  * @returns The note, or null.
  */
 export declare function failureCausesNote(log: string): string | null;
+/**
+ * The command that re-runs the tests at `locations` the way the run IN FLIGHT ran them: the same
+ * invocation, in the same directory, narrowed to those tests — or null when the running command
+ * is not a Playwright run this can narrow.
+ *
+ * The `locations` are the paths the run's own log printed, which are relative to the directory
+ * that run started in, so a re-run has to resolve them there: the command names that directory
+ * unless it already changes into one of its own, because the executor's next command starts
+ * wherever it starts. The returned command is for AFTER the run ends — it is a second run against
+ * the same app and database, and that is exactly what is refused while the run walks
+ * ({@link suiteRunInTheWay}).
+ *
+ * @param run - The run in flight: the command it was started with, as it was run, and the
+ *   directory that command ran in.
+ * @param locations - The failing `file:line`s to re-run, as the run's log printed them.
+ * @returns The re-run command, or null when there is no suite to narrow.
+ */
+export declare function rerunOfRunningSuite(run: {
+    command: string;
+    cwd?: string;
+}, locations: readonly string[]): string | null;
 /**
  * The sentence that names a cause repeating among a running suite's failures, mid-run.
  *
@@ -705,10 +801,21 @@ export declare function failureCausesNote(log: string): string | null;
  * stopped eight runs at their first repeating cause in 14.5 minutes and never finished one, so
  * the note must not say to stop when the run still has other causes to name.
  *
+ * The run is STILL WALKING while this note is written — both callers produce it mid-run — so a
+ * re-run of one of its tests is a second run against the same app and database, and the platform
+ * refuses that ({@link suiteRunInTheWay}, the same rule its overlap hold answers with):
+ * xr-molecule-flash-m89 (2026-10-16) read *"Start on them now, while the run keeps walking.
+ * `null-fields.spec.ts:53` alone reproduces the first one."* and sent exactly that re-run 23 s
+ * later, where the hold answered *"A playwright suite is already running against this app and
+ * database … Wait for it."* The note therefore hands over the read-and-fix to do NOW and the
+ * re-run for after the run ends — the exact command where the caller knows how the run was
+ * started ({@link rerunOfRunningSuite}), the timing alone where it does not.
+ *
  * @param found - What {@link repeatingFailure} found.
  * @param o - The run's facts: its `taskId`, its `log` path, `stop` — the shell command that
- *   stops it, printed only for a {@link UniversalCause} — and `universal`, what
- *   {@link universalCause} found (absent means the run is not failing whole).
+ *   stops it, printed only for a {@link UniversalCause} — `universal`, what
+ *   {@link universalCause} found (absent means the run is not failing whole), and `run`, how the
+ *   run was started ({@link rerunOfRunningSuite}) when the caller knows it.
  * @returns The note.
  */
 export declare function repeatingFailureNote(found: RepeatingFailure, o: {
@@ -716,6 +823,10 @@ export declare function repeatingFailureNote(found: RepeatingFailure, o: {
     log: string;
     stop: string;
     universal?: UniversalCause | null;
+    run?: {
+        command: string;
+        cwd?: string;
+    };
 }): string;
 /**
  * Attempt a whitespace-tolerant replacement when an exact `old_string` match

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

@@ -7,6 +7,7 @@
 import { posix } from 'path';
 import { commandSegments } from './command-position.js';
 import { commandRunsNoTests } from './no-test-run.js';
+import { isDiagnosisRun, scopedRerunCommand, suiteCommandTarget, suiteRunInTheWay, withoutHeredocs, } from './suite-overlap.js';
 /**
  * Shell-safe quoting using single quotes. Unlike JSON.stringify (double quotes),
  * single-quoted strings prevent command substitution ($(), backticks) and variable expansion.
@@ -386,8 +387,11 @@ export function streamingBackgroundCommand(command) {
     // A diagnosis or a re-run (capped, last-failed, grepped, or named files) walks each failure
     // once: the suite's own `retries` doubled every failure of X1 flash-m71's first whole run,
     // which had dropped the `--retries=0` it used one command earlier. The uncapped proof run
-    // keeps the suite's retries.
-    const iterating = /--max-failures\b|--last-failed\b|(?:^|\s)(?:-g|--grep)\b|\S+\.(?:spec|test)\.[cm]?[jt]sx?(?::\d+)?\b/.test(lastStep);
+    // keeps the suite's retries — including the `--max-failures=0` the platform's own note asks
+    // for on it (xr-molecule-flash-m89). Which runs those are is {@link isDiagnosisRun}'s answer
+    // and nobody else's: the platform's notes ask the same function, so a run cannot be a
+    // diagnosis to one of them and the whole suite to the other.
+    const diagnosis = isDiagnosisRun(lastStep);
     // The last step's reporters: one printer, and it is `list`. Every branch below only ever moves
     // the command TO that shape — a reporter set is never left with two printers in it.
     const reporters = finalPlaywrightRun ? lastReporterFlag(lastStep) : null;
@@ -437,7 +441,7 @@ export function streamingBackgroundCommand(command) {
         changes.push('Added `--reporter=list` so each test result is written to the log as it finishes ' +
             '(the config reporter may print nothing until the end).');
     }
-    if (finalPlaywrightRun && iterating && !/--retries\b/.test(lastStep)) {
+    if (finalPlaywrightRun && diagnosis && !/--retries\b/.test(lastStep)) {
         out = `${out.trimEnd()} --retries=0`;
         changes.push('Added `--retries=0`: a diagnosis or re-run walks each failure once; keep the suite’s retries for the proof run.');
     }
@@ -680,9 +684,104 @@ export function isValidGlob(pattern) {
 export function findPatternArgs(pattern) {
     if (!pattern.includes('/'))
         return `-name ${shellQuote(pattern)}`;
+    return findPathArgs(pattern);
+}
+/**
+ * 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 function findPathArgs(pattern) {
     const paths = pathPatternVariants(pattern).map((p) => `-path ${shellQuote(`*/${p}`)}`);
     return paths.length === 1 ? paths[0] : `\\( ${paths.join(' -o ')} \\)`;
 }
+/**
+ * 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 function literalDirPrefix(pattern) {
+    const stripped = pattern.replace(/^(?:\.?\/)+/, '');
+    const firstGlob = stripped.search(/[?*[]/);
+    // No glob at all: the pattern IS a path, and the whole-tree form already
+    // finds it at any depth.
+    if (firstGlob === -1)
+        return null;
+    const at = stripped.slice(0, firstGlob).lastIndexOf('/');
+    if (at <= 0)
+        return null;
+    const prefix = stripped.slice(0, at);
+    return prefix.includes('/') ? prefix : 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 function isCommandTimeout(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return /deadline[_ ]?exceeded|timed out|timeout/i.test(message);
+}
+/**
+ * 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 function searchTimeoutError(tool, searched, pattern, seconds, hint) {
+    return (`${tool} timed out after ${seconds}s searching ${searched} for "${pattern}" — the sandbox stopped the ` +
+        `command at its deadline, so there is no result (this is not an empty directory). ${hint}`);
+}
 /**
  * The `-path` globs for a pattern that contains a slash, one per way each
  * doubled-star directory segment can stand for zero directories.
@@ -1707,6 +1806,33 @@ export function failureCausesNote(log) {
     return (`${total} failure${total === 1 ? '' : 's'} in this run, grouped by cause — fix every cause ` +
         `below before the next deploy:\n${lines.join('\n')}${moreCauses}`);
 }
+/**
+ * The command that re-runs the tests at `locations` the way the run IN FLIGHT ran them: the same
+ * invocation, in the same directory, narrowed to those tests — or null when the running command
+ * is not a Playwright run this can narrow.
+ *
+ * The `locations` are the paths the run's own log printed, which are relative to the directory
+ * that run started in, so a re-run has to resolve them there: the command names that directory
+ * unless it already changes into one of its own, because the executor's next command starts
+ * wherever it starts. The returned command is for AFTER the run ends — it is a second run against
+ * the same app and database, and that is exactly what is refused while the run walks
+ * ({@link suiteRunInTheWay}).
+ *
+ * @param run - The run in flight: the command it was started with, as it was run, and the
+ *   directory that command ran in.
+ * @param locations - The failing `file:line`s to re-run, as the run's log printed them.
+ * @returns The re-run command, or null when there is no suite to narrow.
+ */
+export function rerunOfRunningSuite(run, locations) {
+    if (locations.length === 0)
+        return null;
+    const scoped = scopedRerunCommand(run.command, locations);
+    if (scoped === run.command)
+        return null;
+    if (!run.cwd || commandSegments(withoutHeredocs(run.command)).some((s) => s.program === 'cd'))
+        return scoped;
+    return `cd ${shellQuote(run.cwd)} && ${scoped}`;
+}
 /**
  * The sentence that names a cause repeating among a running suite's failures, mid-run.
  *
@@ -1721,10 +1847,21 @@ export function failureCausesNote(log) {
  * stopped eight runs at their first repeating cause in 14.5 minutes and never finished one, so
  * the note must not say to stop when the run still has other causes to name.
  *
+ * The run is STILL WALKING while this note is written — both callers produce it mid-run — so a
+ * re-run of one of its tests is a second run against the same app and database, and the platform
+ * refuses that ({@link suiteRunInTheWay}, the same rule its overlap hold answers with):
+ * xr-molecule-flash-m89 (2026-10-16) read *"Start on them now, while the run keeps walking.
+ * `null-fields.spec.ts:53` alone reproduces the first one."* and sent exactly that re-run 23 s
+ * later, where the hold answered *"A playwright suite is already running against this app and
+ * database … Wait for it."* The note therefore hands over the read-and-fix to do NOW and the
+ * re-run for after the run ends — the exact command where the caller knows how the run was
+ * started ({@link rerunOfRunningSuite}), the timing alone where it does not.
+ *
  * @param found - What {@link repeatingFailure} found.
  * @param o - The run's facts: its `taskId`, its `log` path, `stop` — the shell command that
- *   stops it, printed only for a {@link UniversalCause} — and `universal`, what
- *   {@link universalCause} found (absent means the run is not failing whole).
+ *   stops it, printed only for a {@link UniversalCause} — `universal`, what
+ *   {@link universalCause} found (absent means the run is not failing whole), and `run`, how the
+ *   run was started ({@link rerunOfRunningSuite}) when the caller knows it.
  * @returns The note.
  */
 export function repeatingFailureNote(found, o) {
@@ -1752,11 +1889,33 @@ export function repeatingFailureNote(found, o) {
         ? `every one with \`${found.message}\``
         : `each after ~${found.seconds}s — the same duration to within half a second`;
     const first = found.tests[0];
-    const reproduce = first?.where && !found.message
-        ? ` \`${first.where}\` alone reproduces the first one.`
-        : first?.where
-            ? ` Re-run \`${first.where}\` alone to see its error in full.`
-            : '';
+    const firstAt = first?.where ?? '';
+    // The re-run this note names, and whether a run is in its way — the SAME rule the platform's
+    // overlap hold answers with (@link suiteRunInTheWay), asked of the same pair: the app the
+    // composed re-run would measure, and the app the run in flight measures (both read off the two
+    // commands, so a re-run aimed anywhere else is not refused).
+    const rerun = firstAt && o.run ? rerunOfRunningSuite(o.run, [firstAt]) : null;
+    const measured = o.run ? suiteCommandTarget(o.run.command) : null;
+    const inTheWay = measured === null
+        ? null
+        : suiteRunInTheWay({ target: rerun ? suiteCommandTarget(rerun) : measured }, [
+            // The composer only narrows a `playwright test` run, and the sentence below says the run
+            // is still walking, so the run in flight is a suite either way.
+            { runsSuite: true, target: measured },
+        ]);
+    // Where the run's own app is not known (this process did not start it — a restart between the
+    // launch and the wait), the note still knows the run is WALKING, which is the whole of the
+    // reason the re-run waits: nothing may start against the app it walks.
+    const aRunIsInTheWay = measured === null || inTheWay !== null;
+    const reproduce = firstAt
+        ? ` Read \`${firstAt}\` and the code it drives now, and fix it: nothing may run against this ` +
+            `app while the run walks — a second run against the same app and database is refused — so ` +
+            `run it alone once the run has ended.`
+        : '';
+    // Where the note knows how the run was started, it also hands over the exact command for after
+    // it: the whole-suite command it must not send again, narrowed to the failing test, in the
+    // directory the run started in. Without that record it says the timing and nothing more.
+    const thenRun = aRunIsInTheWay && rerun ? `\nSend this once the run ends:\n  ${rerun}` : '';
     const where = `task ${o.taskId}, log ${o.log}`;
     if (o.universal) {
         const files = o.universal.files.map(shortFile);
@@ -1777,13 +1936,13 @@ export function repeatingFailureNote(found, o) {
     if (isCause)
         return (`${found.count} different tests in this run have already failed the same way — ${signature} — ` +
             `so one cause is repeating:\n${rows}${more}\n` +
-            `Start fixing it now, while the run keeps walking.${reproduce} ${keepGoing}`);
+            `Start fixing it now, while the run keeps walking.${reproduce} ${keepGoing}${thenRun}`);
     return (`${found.count} different tests in this run each failed after ~${found.seconds}s — the same ` +
         `duration to within half a second. A shared duration is a lead, not a cause: a suite whose ` +
         `config sets a timeout spends that timeout on every failure that waits for anything, so ` +
         `different missing elements land on the same number. Read these failures before fixing one ` +
         `of them:\n${rows}${more}\n` +
-        `Start on them now, while the run keeps walking.${reproduce} ${keepGoing}`);
+        `Start on them now, while the run keeps walking.${reproduce} ${keepGoing}${thenRun}`);
 }
 /**
  * Attempt a whitespace-tolerant replacement when an exact `old_string` match

package/package.json

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