@molecule/api-ai-tools 1.5.19 → 1.5.20

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-16T12:22:32.984Z
+Generated: 2026-10-16T12:46:49.316Z
 -->
 
 # @molecule/api-ai-tools
@@ -499,6 +499,27 @@ function guardAITool(tool: T, options?: GuardOptions): T
 
 **Returns:** A copy with a guarded `execute`.
 
+#### `commandRunsNoTests(command)`
+
+Whether a shell command invokes a test runner and EVERY such invocation only prints — so the
+command runs no test at all.
+
+A command that invokes no runner is NOT one of these (false): "the command runs no test" is
+then true for `ls`, which is not the question any caller is asking. The question is whether
+the runner invocation each caller read as a run is one.
+
+A command that also runs tests is false however it is spelled: `npx playwright install &&
+npx playwright test` installs and runs, so a caller that sees `playwright test` in it is
+reading a real run.
+
+```typescript
+function commandRunsNoTests(command: string): boolean
+```
+
+- `command` — The shell command as the executor sent it.
+
+**Returns:** True when the command invokes a runner only to print.
+
 #### `discoverSkills(backend)`
 
 Discover skills from a project directory.
@@ -758,6 +779,10 @@ function streamingBackgroundCommand(command: string): { command: string; changes
 Whether a command runs a whole test suite — a Playwright, Vitest or Hurl run
 — rather than a build, an install or a one-off script.
 
+A command that invokes a runner only to print is not one of these
+({@link commandRunsNoTests}): `npx playwright test --list` prints the tests it would run and
+exits, and `npx playwright install`, `vitest list` and `hurl --help` start no test either.
+
 ```typescript
 function isSuiteRunCommand(command: string): boolean
 ```
@@ -766,6 +791,23 @@ function isSuiteRunCommand(command: string): boolean
 
 **Returns:** True when the command starts one of those runners.
 
+#### `isPlaywrightRunCommand(command)`
+
+Whether a command starts a Playwright run — `playwright test` in a form that runs something.
+
+`npx playwright test --list` matched every `\bplaywright\s+test\b` test in the platform and was
+then treated as a run: held (flash-m79's config check), backgrounded for a run that outlasts
+the tool's ceiling, and rewritten with `--reporter`. A list takes two seconds, prints its lines
+and exits, so it is none of those; {@link commandRunsNoTests} is what decides.
+
+```typescript
+function isPlaywrightRunCommand(command: string): boolean
+```
+
+- `command` — The shell command.
+
+**Returns:** True when the command starts a Playwright run.
+
 #### `suiteRunPriorityLaunch(command, launch)`
 
 Start a background suite run at lower CPU and IO priority, so the sandbox it

package/dist/index.d.ts

@@ -117,6 +117,7 @@ export * from './backends/local.js';
 export * from './backends/sandbox.js';
 export * from './browser-guard.js';
 export * from './input-normalizer.js';
+export * from './no-test-run.js';
 export * from './schemas.js';
 export * from './system-prompt.js';
 export * from './tools.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -117,6 +117,7 @@ export * from './backends/local.js';
 export * from './backends/sandbox.js';
 export * from './browser-guard.js';
 export * from './input-normalizer.js';
+export * from './no-test-run.js';
 export * from './schemas.js';
 export * from './system-prompt.js';
 export * from './tools.js';

package/dist/no-test-run.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The runner invocations that print information and run no test — the one classifier every
+ * site asks before it treats a command as a test run.
+ *
+ * A Playwright CLI has subcommands and flags that never start a test: `playwright test --list`
+ * prints the tests it would run and exits, `show-report`/`show-trace` open a saved report,
+ * `codegen` records one, `install` fetches browsers, `merge-reports` joins blobs, and
+ * `--help`/`--version` print and exit. Vitest lists with `vitest list` / `--list` and hurl
+ * prints with `--help`/`--version`, the same way.
+ *
+ * Every check in the platform read such a command as a whole-suite run, because each one
+ * matched the runner's NAME. X1 xr-molecule-flash-m79's first Playwright command was a config
+ * check — a config written to `/tmp`, `cp`'d beside the suite and used with `--list` — and it
+ * came back HELD, `status: not_run`, with a ~4 KB `suiteNote` telling it to send the same
+ * command with `--max-failures=15` ("uncapped it walks every test … 8–13 minutes"), beside an
+ * environment block saying the run "ran on their defaults" and an import note about a path the
+ * `cp` had already fixed. Nothing ran. The model gave up on the approach, wrote a second
+ * config, and its next command was held again (flash-m74's "same command three times" shape):
+ * two holds, zero tests, and the config check it asked for never answered.
+ *
+ * So the classifiers live here, in one place, and callers ask them instead of their own
+ * regexes: {@link commandRunsNoTests} answers for a whole command, and the runner-specific
+ * sites (molecule-dev's suite checks, `streamingBackgroundCommand`, `isSuiteRunCommand`) route
+ * through it. A command that runs no test is never held, never noted, and never rewritten
+ * (`--retries`, `--reporter`) as if it were a run.
+ *
+ * @module
+ */
+/**
+ * Whether a shell command invokes a test runner and EVERY such invocation only prints — so the
+ * command runs no test at all.
+ *
+ * A command that invokes no runner is NOT one of these (false): "the command runs no test" is
+ * then true for `ls`, which is not the question any caller is asking. The question is whether
+ * the runner invocation each caller read as a run is one.
+ *
+ * A command that also runs tests is false however it is spelled: `npx playwright install &&
+ * npx playwright test` installs and runs, so a caller that sees `playwright test` in it is
+ * reading a real run.
+ *
+ * @param command - The shell command as the executor sent it.
+ * @returns True when the command invokes a runner only to print.
+ */
+export declare function commandRunsNoTests(command: string): boolean;
+//# sourceMappingURL=no-test-run.d.ts.map

package/dist/no-test-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-test-run.d.ts","sourceRoot":"","sources":["../src/no-test-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AA6EH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAY3D"}

package/dist/no-test-run.js

@@ -0,0 +1,125 @@
+/**
+ * The runner invocations that print information and run no test — the one classifier every
+ * site asks before it treats a command as a test run.
+ *
+ * A Playwright CLI has subcommands and flags that never start a test: `playwright test --list`
+ * prints the tests it would run and exits, `show-report`/`show-trace` open a saved report,
+ * `codegen` records one, `install` fetches browsers, `merge-reports` joins blobs, and
+ * `--help`/`--version` print and exit. Vitest lists with `vitest list` / `--list` and hurl
+ * prints with `--help`/`--version`, the same way.
+ *
+ * Every check in the platform read such a command as a whole-suite run, because each one
+ * matched the runner's NAME. X1 xr-molecule-flash-m79's first Playwright command was a config
+ * check — a config written to `/tmp`, `cp`'d beside the suite and used with `--list` — and it
+ * came back HELD, `status: not_run`, with a ~4 KB `suiteNote` telling it to send the same
+ * command with `--max-failures=15` ("uncapped it walks every test … 8–13 minutes"), beside an
+ * environment block saying the run "ran on their defaults" and an import note about a path the
+ * `cp` had already fixed. Nothing ran. The model gave up on the approach, wrote a second
+ * config, and its next command was held again (flash-m74's "same command three times" shape):
+ * two holds, zero tests, and the config check it asked for never answered.
+ *
+ * So the classifiers live here, in one place, and callers ask them instead of their own
+ * regexes: {@link commandRunsNoTests} answers for a whole command, and the runner-specific
+ * sites (molecule-dev's suite checks, `streamingBackgroundCommand`, `isSuiteRunCommand`) route
+ * through it. A command that runs no test is never held, never noted, and never rewritten
+ * (`--retries`, `--reporter`) as if it were a run.
+ *
+ * @module
+ */
+/**
+ * A runner's name as a statement invokes it, from the start of its own arguments. The trailing
+ * guard is what separates the runner from a FILE named after it — `-c playwright.local.config.ts`
+ * names a config, not a second invocation, and reading it as one would give that "invocation" no
+ * `--list` of its own and un-do the answer for the real one.
+ */
+const INVOCATIONS = [
+    ['playwright', /(?:^|[\s;&|(])(?:npx\s+(?:--no-install\s+)?)?(?:\S*\/)?playwright(?![\w.-])/g],
+    ['vitest', /(?:^|[\s;&|(])(?:npx\s+(?:--no-install\s+)?)?(?:\S*\/)?vitest(?![\w.-])/g],
+    ['hurl', /(?:^|[\s;&|(])(?:\S*\/)?hurl(?![\w.-])/g],
+];
+/** Playwright's subcommands that start no test. */
+const PLAYWRIGHT_INFO_SUBCOMMANDS = [
+    'show-report',
+    'show-trace',
+    'codegen',
+    'install',
+    'merge-reports',
+];
+/** Vitest's subcommand that prints what a run would collect. */
+const VITEST_LIST_SUBCOMMAND = 'list';
+/**
+ * The flags that put a runner in an information mode: it prints and exits. `-h` is `--help`
+ * for all three (hurl's manual documents `-h, --help`; Playwright's and Vitest's CLIs follow
+ * the same convention), and the value-taking flags beside them are why each is matched as a
+ * whole token — hurl's `-H` is a header, not help.
+ */
+const NO_RUN_FLAGS = {
+    playwright: [
+        /(?:^|\s)--list(?=\s|$)/,
+        /(?:^|\s)--dry-run(?=\s|$)/,
+        /(?:^|\s)--help(?=\s|$)/,
+        /(?:^|\s)-h(?=\s|$)/,
+        /(?:^|\s)--version(?=\s|$)/,
+    ],
+    vitest: [
+        /(?:^|\s)--list(?=\s|$)/,
+        /(?:^|\s)--help(?=\s|$)/,
+        /(?:^|\s)-h(?=\s|$)/,
+        /(?:^|\s)--version(?=\s|$)/,
+    ],
+    hurl: [/(?:^|\s)--help(?=\s|$)/, /(?:^|\s)-h(?=\s|$)/, /(?:^|\s)--version(?=\s|$)/],
+};
+/** Statements of a shell command, the way the suite checks split them. */
+const STATEMENT_SEP = /\s*(?:&&|\|\||;|\||\n)\s*/;
+/**
+ * A heredoc body is data a command writes, not what it runs: a `playwright test --list` inside
+ * the config a command writes is not a run of this command either way. The pattern consumes the
+ * writer's own line prefix, the same shape `outputRedirectTarget` reads.
+ */
+const HEREDOC = /[^\n;&|]*<<-?\s*(['"]?)(\w+)\1[\s\S]*?\n\s*\2\b/g;
+/**
+ * Whether this runner's invocation — the text from just after its name to the end of its
+ * statement — only prints.
+ *
+ * @param runner - The runner the statement invokes.
+ * @param after - Everything after the runner's name in that statement.
+ * @returns True when the invocation starts no test.
+ */
+function informational(runner, after) {
+    const first = after.trimStart().split(/\s+/)[0] ?? '';
+    if (runner === 'playwright' && PLAYWRIGHT_INFO_SUBCOMMANDS.includes(first))
+        return true;
+    if (runner === 'vitest' && first === VITEST_LIST_SUBCOMMAND)
+        return true;
+    return NO_RUN_FLAGS[runner].some((re) => re.test(after));
+}
+/**
+ * Whether a shell command invokes a test runner and EVERY such invocation only prints — so the
+ * command runs no test at all.
+ *
+ * A command that invokes no runner is NOT one of these (false): "the command runs no test" is
+ * then true for `ls`, which is not the question any caller is asking. The question is whether
+ * the runner invocation each caller read as a run is one.
+ *
+ * A command that also runs tests is false however it is spelled: `npx playwright install &&
+ * npx playwright test` installs and runs, so a caller that sees `playwright test` in it is
+ * reading a real run.
+ *
+ * @param command - The shell command as the executor sent it.
+ * @returns True when the command invokes a runner only to print.
+ */
+export function commandRunsNoTests(command) {
+    if (typeof command !== 'string' || !command.trim())
+        return false;
+    let invocations = 0;
+    for (const statement of command.replace(HEREDOC, ' ').split(STATEMENT_SEP)) {
+        for (const [runner, re] of INVOCATIONS) {
+            for (const m of statement.matchAll(re)) {
+                invocations += 1;
+                if (!informational(runner, statement.slice((m.index ?? 0) + m[0].length)))
+                    return false;
+            }
+        }
+    }
+    return invocations > 0;
+}

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;AAkL9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAoDnE;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUhE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,EAAE,CAuzDxF"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAkL9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAqDnE;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUhE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,EAAE,CA0zDxF"}

package/dist/tools.js

@@ -161,7 +161,7 @@ function waitProgressNote(o) {
     const sentence = parts.join('; ');
     return ` ${sentence[0].toUpperCase()}${sentence.slice(1)}.`;
 }
-import { checkBlockedCommand, declaredBudgetSeconds, DEFAULT_SEARCH_EXCLUDED_DIRS, directoryReadHint, findPatternArgs, fusedLine, htmlOutline, isEnvFilePath, isOutsideRoot, isValidGlob, MAX_BATCH_READ_BYTES, MAX_BATCH_READ_FILES, MAX_FIND_RESULTS, MAX_HTML_INLINE_CHARS, MAX_OUTPUT_SIZE, MAX_READ_RETURN_CHARS, MAX_READ_SIZE, MAX_SEARCH_CONTEXT_LINES, MAX_SEARCH_RESULTS, MAX_WRITE_SIZE, outputIsWithheldUntilExit, outputRedirectTarget, parseCheckCommand, parseCheckProblem, pathArgError, printsOnlySource, redactSecrets, redactSecretsInCode, repeatingFailure, repeatingFailureNote, resolvePath, RUNNING_FAILURE_LINES, runningCauseCommand, runningOutputSliceCommand, shellQuote, sliceLines, SMALL_FILE_WHOLE_CHARS, streamingBackgroundCommand, stripControlChars, suiteRunPriorityLaunch, truncateMiddle, whitespaceTolerantReplace, } from './utilities.js';
+import { checkBlockedCommand, declaredBudgetSeconds, DEFAULT_SEARCH_EXCLUDED_DIRS, directoryReadHint, findPatternArgs, fusedLine, htmlOutline, isEnvFilePath, isOutsideRoot, isPlaywrightRunCommand, isValidGlob, MAX_BATCH_READ_BYTES, MAX_BATCH_READ_FILES, MAX_FIND_RESULTS, MAX_HTML_INLINE_CHARS, MAX_OUTPUT_SIZE, MAX_READ_RETURN_CHARS, MAX_READ_SIZE, MAX_SEARCH_CONTEXT_LINES, MAX_SEARCH_RESULTS, MAX_WRITE_SIZE, outputIsWithheldUntilExit, outputRedirectTarget, parseCheckCommand, parseCheckProblem, pathArgError, printsOnlySource, redactSecrets, redactSecretsInCode, repeatingFailure, repeatingFailureNote, resolvePath, RUNNING_FAILURE_LINES, runningCauseCommand, runningOutputSliceCommand, shellQuote, sliceLines, SMALL_FILE_WHOLE_CHARS, streamingBackgroundCommand, stripControlChars, suiteRunPriorityLaunch, truncateMiddle, 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.
@@ -1371,12 +1371,15 @@ export function buildTools(backend, config) {
             // declaring a budget too: a suite routinely outlasts the ceiling, and killed there
             // behind `| tail` it returns nothing (X1 flash-m29 lost a 290 s run that way).
             // A short one still comes back as a foreground result, through the grace below.
+            // A Playwright command that runs no test is not one of these either: `playwright test
+            // --list` piped through `tail` takes two seconds, and backgrounding it costs the round
+            // trip `wait_for_task` owes the executor (flash-m79's config check).
             const overCeiling = commandBudgetMs !== undefined &&
                 ((outputIsWithheldUntilExit(command) &&
-                    (declaredSeconds > ceilingSeconds || /\bplaywright\s+test\b/.test(command))) ||
+                    (declaredSeconds > ceilingSeconds || isPlaywrightRunCommand(command))) ||
                     // A redirected Playwright run shows nothing either (`> out.txt`), and was killed at
                     // the ceiling with 38 tests unrun (X1 flash-m36).
-                    (/\bplaywright\s+test\b/.test(command) && outputRedirectTarget(command) !== null));
+                    (isPlaywrightRunCommand(command) && outputRedirectTarget(command) !== null));
             if (input.run_in_background === true || overCeiling) {
                 const id = `mol-bg-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
                 const log = `/tmp/${id}.log`;

package/dist/utilities.d.ts

@@ -136,7 +136,9 @@ export declare function outputRedirectTarget(command: string): string | null;
  * its error message. X1 flash-m76 walked 15 tests for 4.0 minutes, every one a
  * `TimeoutError: page.waitForURL` from one missing `navigate('/')`.
  *
- * Only the command's last step is touched, and only its reporter.
+ * Only the command's last step is touched, and only its reporter, and only when that step runs
+ * something: `npx playwright test --list` takes two seconds and writes nothing per test, so
+ * neither reporter nor `--retries=0` is added to it ({@link isPlaywrightRunCommand}).
  *
  * @param command - The command as the executor sent it.
  * @returns The command to run and one sentence per change made (empty when none).
@@ -149,10 +151,26 @@ export declare function streamingBackgroundCommand(command: string): {
  * Whether a command runs a whole test suite — a Playwright, Vitest or Hurl run
  * — rather than a build, an install or a one-off script.
  *
+ * A command that invokes a runner only to print is not one of these
+ * ({@link commandRunsNoTests}): `npx playwright test --list` prints the tests it would run and
+ * exits, and `npx playwright install`, `vitest list` and `hurl --help` start no test either.
+ *
  * @param command - The shell command.
  * @returns True when the command starts one of those runners.
  */
 export declare function isSuiteRunCommand(command: string): boolean;
+/**
+ * Whether a command starts a Playwright run — `playwright test` in a form that runs something.
+ *
+ * `npx playwright test --list` matched every `\bplaywright\s+test\b` test in the platform and was
+ * then treated as a run: held (flash-m79's config check), backgrounded for a run that outlasts
+ * the tool's ceiling, and rewritten with `--reporter`. A list takes two seconds, prints its lines
+ * and exits, so it is none of those; {@link commandRunsNoTests} is what decides.
+ *
+ * @param command - The shell command.
+ * @returns True when the command starts a Playwright run.
+ */
+export declare function isPlaywrightRunCommand(command: string): boolean;
 /**
  * Start a background suite run at lower CPU and IO priority, so the sandbox it
  * shares with everything else stays responsive to what the executor does next.

package/dist/utilities.d.ts.map

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

package/dist/utilities.js

@@ -5,6 +5,7 @@
  * @module
  */
 import { posix } from 'path';
+import { commandRunsNoTests } from './no-test-run.js';
 /**
  * Shell-safe quoting using single quotes. Unlike JSON.stringify (double quotes),
  * single-quoted strings prevent command substitution ($(), backticks) and variable expansion.
@@ -315,12 +316,19 @@ const LINE_REPORTER_FLAG = /--reporter([= ])line\b/;
  * its error message. X1 flash-m76 walked 15 tests for 4.0 minutes, every one a
  * `TimeoutError: page.waitForURL` from one missing `navigate('/')`.
  *
- * Only the command's last step is touched, and only its reporter.
+ * Only the command's last step is touched, and only its reporter, and only when that step runs
+ * something: `npx playwright test --list` takes two seconds and writes nothing per test, so
+ * neither reporter nor `--retries=0` is added to it ({@link isPlaywrightRunCommand}).
  *
  * @param command - The command as the executor sent it.
  * @returns The command to run and one sentence per change made (empty when none).
  */
 export function streamingBackgroundCommand(command) {
+    // A command that runs no test is not a run to keep a growing log for: nothing about it is
+    // rewritten (flash-m79's `--list` was read as a whole-suite run end to end, and got a ~4 KB
+    // refusal to send itself again with `--max-failures=15`).
+    if (commandRunsNoTests(command))
+        return { command, changes: [] };
     const changes = [];
     let out = command;
     const tail = TRAILING_TAIL.exec(out);
@@ -332,12 +340,12 @@ export function streamingBackgroundCommand(command) {
     // A Playwright run behind `| head -N` loses its tally, which prints last (X1
     // flash-m32 counted ✓/✘ marks by hand); the full log comes back anyway.
     const head = /\s*\|\s*head(?:\s+-n)?\s+-?\d+\s*$/.exec(out);
-    if (head && /\bplaywright\s+test\b/.test(out)) {
+    if (head && isPlaywrightRunCommand(out)) {
         out = out.slice(0, head.index);
         changes.push(`Dropped the trailing \`${head[0].trim()}\`: Playwright prints its pass/fail count last, and it would be cut.`);
     }
     const lastStep = out.split(/&&|\|\||;/).at(-1) ?? '';
-    const finalPlaywrightRun = /\bplaywright\s+test\b/.test(lastStep) &&
+    const finalPlaywrightRun = isPlaywrightRunCommand(lastStep) &&
         // `2>&1` only joins stderr to the log; any other pipe or redirect sends the output elsewhere.
         !/[|>]/.test(lastStep.replace(/\d?>&\d/g, ''));
     // A diagnosis or a re-run (capped, last-failed, grepped, or named files) walks each failure
@@ -405,11 +413,29 @@ const SUITE_RUN_COMMANDS = [
  * Whether a command runs a whole test suite — a Playwright, Vitest or Hurl run
  * — rather than a build, an install or a one-off script.
  *
+ * A command that invokes a runner only to print is not one of these
+ * ({@link commandRunsNoTests}): `npx playwright test --list` prints the tests it would run and
+ * exits, and `npx playwright install`, `vitest list` and `hurl --help` start no test either.
+ *
  * @param command - The shell command.
  * @returns True when the command starts one of those runners.
  */
 export function isSuiteRunCommand(command) {
-    return SUITE_RUN_COMMANDS.some((re) => re.test(command));
+    return !commandRunsNoTests(command) && SUITE_RUN_COMMANDS.some((re) => re.test(command));
+}
+/**
+ * Whether a command starts a Playwright run — `playwright test` in a form that runs something.
+ *
+ * `npx playwright test --list` matched every `\bplaywright\s+test\b` test in the platform and was
+ * then treated as a run: held (flash-m79's config check), backgrounded for a run that outlasts
+ * the tool's ceiling, and rewritten with `--reporter`. A list takes two seconds, prints its lines
+ * and exits, so it is none of those; {@link commandRunsNoTests} is what decides.
+ *
+ * @param command - The shell command.
+ * @returns True when the command starts a Playwright run.
+ */
+export function isPlaywrightRunCommand(command) {
+    return /\bplaywright\s+test\b/.test(command) && !commandRunsNoTests(command);
 }
 /**
  * Start a background suite run at lower CPU and IO priority, so the sandbox it
@@ -792,6 +818,8 @@ export function looksLikeHtml(text) {
 export function htmlOutline(text, label = 'document') {
     if (!looksLikeHtml(text))
         return null;
+    // "0 KB" for anything under a kilobyte reads like a bug; say the real unit.
+    const size = (chars) => chars >= 1024 ? `${Math.round(chars / 1024)} KB` : `${chars} char${chars === 1 ? '' : 's'}`;
     const lines = text.split('\n');
     const out = [];
     let skipped = 0;
@@ -800,7 +828,7 @@ export function htmlOutline(text, label = 'document') {
     const flushSkipped = () => {
         if (skipped === 0)
             return;
-        out.push(`        … ${skipped} more line${skipped === 1 ? '' : 's'} (${Math.round(skippedChars / 1024)} KB) …`);
+        out.push(`        … ${skipped} more line${skipped === 1 ? '' : 's'} (${size(skippedChars)}) …`);
         skipped = 0;
         skippedChars = 0;
     };
@@ -824,9 +852,7 @@ export function htmlOutline(text, label = 'document') {
         }
     }
     flushSkipped();
-    // "0 KB" for anything under a kilobyte reads like a bug; say the real unit.
-    const size = text.length >= 1024 ? `${Math.round(text.length / 1024)} KB` : `${text.length} chars`;
-    const header = `OUTLINE of ${label} — ${size}, ${lines.length} lines. ` +
+    const header = `OUTLINE of ${label} — ${size(text.length)}, ${lines.length} lines. ` +
         `Its tags and the tags that open each section, one line each; tag bodies (CSS, JS, text) are not shown.` +
         (truncated ? ` (Outline capped at ${MAX_HTML_OUTLINE_LINES} lines.)` : '');
     return `${header}\n\n${out.join('\n')}`;

package/package.json

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