@molecule/api-ai-tools 1.5.13 → 1.5.15

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-16T02:43:35.968Z
+Generated: 2026-10-16T05:16:44.196Z
 -->
 
 # @molecule/api-ai-tools
@@ -887,6 +887,22 @@ function parseCheckProblem(result: {
 
 **Returns:** The message for the tool result, or null.
 
+#### `fusedLine(content, newString)`
+
+The line a replacement fused when it dropped the newline its `old_string`
+ended with: `new_string`'s text is followed on the same line by what used to
+be the next line. Read off the file as it now is, so the line shown is the
+line the parser is actually complaining about.
+
+```typescript
+function fusedLine(content: string, newString: string): { line: number; text: string } | null
+```
+
+- `content` — The file's content after the edit.
+- `newString` — A replacement's `new_string`, whose `old_string` ended with a newline.
+
+**Returns:** The fused line's 1-based number and its text, or null when the replacement's text is not followed by more of the same line (it ends the file, the following newline survived, or another replacement rewrote it).
+
 ### Constants
 
 #### `TOOL_SCHEMAS`
@@ -967,6 +983,14 @@ needs.
 const MAX_READ_RETURN_CHARS: number
 ```
 
+#### `SMALL_FILE_WHOLE_CHARS`
+
+A file this small is returned whole even when a window is asked for (paging it costs a call each).
+
+```typescript
+const SMALL_FILE_WHOLE_CHARS: number
+```
+
 #### `MAX_SEARCH_RESULTS`
 
 Max search results.
@@ -1053,6 +1077,15 @@ Peer dependencies:
   Line numbers count the way `read_file` does, so they are valid offsets. The
   excerpt is redacted like a read. The existing fields (`ok`,
   `replacementsApplied`, `alreadyApplied`, `syntaxError`) are unchanged.
+- **A dropped line break and the parse error it causes are reported as ONE
+  thing.** When a replacement's `old_string` ended with a newline and its
+  `new_string` does not (so the next line is pulled up onto it) and the file
+  then fails its parse check, `edit_file` returns a single `syntaxError` that
+  names the replacement, shows the fused line with its number, and says to
+  re-send that replacement with the newline restored — instead of the
+  `newlineNote` hint beside an unrelated-looking parse error, which an executor
+  repairs by rewriting the fused line's text and fuses the next one. The
+  `newlineNote` alone is still returned when the file parses.
 - **A parameter under another name is not a broken tool.** Every tool's input
   is normalized first (`cmd` → `command`, `file` → `path`, camelCase ⇄
   snake_case), and a handler that throws returns an error naming the missing

package/dist/index.d.ts

@@ -38,6 +38,15 @@
  *   Line numbers count the way `read_file` does, so they are valid offsets. The
  *   excerpt is redacted like a read. The existing fields (`ok`,
  *   `replacementsApplied`, `alreadyApplied`, `syntaxError`) are unchanged.
+ * - **A dropped line break and the parse error it causes are reported as ONE
+ *   thing.** When a replacement's `old_string` ended with a newline and its
+ *   `new_string` does not (so the next line is pulled up onto it) and the file
+ *   then fails its parse check, `edit_file` returns a single `syntaxError` that
+ *   names the replacement, shows the fused line with its number, and says to
+ *   re-send that replacement with the newline restored — instead of the
+ *   `newlineNote` hint beside an unrelated-looking parse error, which an executor
+ *   repairs by rewriting the fused line's text and fuses the next one. The
+ *   `newlineNote` alone is still returned when the file parses.
  * - **A parameter under another name is not a broken tool.** Every tool's input
  *   is normalized first (`cmd` → `command`, `file` → `path`, camelCase ⇄
  *   snake_case), and a handler that throws returns an error naming the missing

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -38,6 +38,15 @@
  *   Line numbers count the way `read_file` does, so they are valid offsets. The
  *   excerpt is redacted like a read. The existing fields (`ok`,
  *   `replacementsApplied`, `alreadyApplied`, `syntaxError`) are unchanged.
+ * - **A dropped line break and the parse error it causes are reported as ONE
+ *   thing.** When a replacement's `old_string` ended with a newline and its
+ *   `new_string` does not (so the next line is pulled up onto it) and the file
+ *   then fails its parse check, `edit_file` returns a single `syntaxError` that
+ *   names the replacement, shows the fused line with its number, and says to
+ *   re-send that replacement with the newline restored — instead of the
+ *   `newlineNote` hint beside an unrelated-looking parse error, which an executor
+ *   repairs by rewriting the fused line's text and fuses the next one. The
+ *   `newlineNote` alone is still returned when the file parses.
  * - **A parameter under another name is not a broken tool.** Every tool's input
  *   is normalized first (`cmd` → `command`, `file` → `path`, camelCase ⇄
  *   snake_case), and a handler that throws returns an error naming the missing

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;AA8B9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAwCnE;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,EAAE,CAwiDxF"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AA8B9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AA0CnE;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,EAAE,CAooDxF"}

package/dist/tools.js

@@ -25,7 +25,7 @@ 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();
-import { checkBlockedCommand, declaredBudgetSeconds, DEFAULT_SEARCH_EXCLUDED_DIRS, directoryReadHint, isEnvFilePath, isOutsideRoot, isValidGlob, MAX_BATCH_READ_BYTES, MAX_BATCH_READ_FILES, MAX_FIND_RESULTS, 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, redactSecrets, redactSecretsInCode, resolvePath, shellQuote, sliceLines, streamingBackgroundCommand, stripControlChars, truncateMiddle, whitespaceTolerantReplace, } from './utilities.js';
+import { checkBlockedCommand, declaredBudgetSeconds, DEFAULT_SEARCH_EXCLUDED_DIRS, directoryReadHint, fusedLine, isEnvFilePath, isOutsideRoot, isValidGlob, MAX_BATCH_READ_BYTES, MAX_BATCH_READ_FILES, MAX_FIND_RESULTS, 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, redactSecrets, redactSecretsInCode, resolvePath, shellQuote, sliceLines, SMALL_FILE_WHOLE_CHARS, streamingBackgroundCommand, stripControlChars, 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.
@@ -133,6 +133,8 @@ export function buildTools(backend, config) {
         }
         return pathGuards ? resolvePath(path, root) : path;
     }
+    /** Paths read with a window in this tool set, to tell paging from one targeted read. */
+    const windowedReads = new Set();
     /**
      * Verify that `path` does not symlink outside the project root when guards are enabled.
      *
@@ -391,6 +393,20 @@ export function buildTools(backend, config) {
             const effectiveWindow = !sliceLines(content, window) && content.length > MAX_READ_RETURN_CHARS
                 ? { offset: 1, limit: linesWithin(content, MAX_READ_RETURN_CHARS) }
                 : window;
+            // A SECOND window of the same small file: hand back all of it (one window is a targeted read). X1 flash-m50 paged files that fit in one
+            // call 13 times in a row, each window answered with "read it again with no offset/limit".
+            const small = sliceLines(content, window);
+            const pagedBefore = small?.truncated ? windowedReads.has(path) : false;
+            if (small?.truncated)
+                windowedReads.add(path);
+            if (small?.truncated && pagedBefore && content.length <= SMALL_FILE_WHOLE_CHARS) {
+                return {
+                    path,
+                    content: sanitizeFileContent(content, path),
+                    totalLines: small.totalLines,
+                    note: `The whole file is returned (${Math.round(content.length / 1024)} KB, ${small.totalLines} lines): a file this small fits in one call, so it is not paged.`,
+                };
+            }
             const windowed = sliceLines(content, effectiveWindow);
             if (windowed) {
                 return {
@@ -826,7 +842,14 @@ export function buildTools(backend, config) {
                     ? `${alreadyApplied} of these edits ${alreadyApplied === 1 ? 'was' : 'were'} already in the file (its new_string is there and its old_string is not) — nothing to do for ${alreadyApplied === 1 ? 'it' : 'them'}.`
                     : null;
                 if (content === oldContent) {
-                    return { path, ok: true, replacementsApplied: 0, alreadyApplied, note: alreadyNote };
+                    // A replacement whose new_string IS its old_string changes nothing; `ok` alone read
+                    // as a fix applied (X1 flash-m51).
+                    const identical = replacements.filter((r) => typeof r.old_string === 'string' && r.old_string === r.new_string).length;
+                    const note = alreadyNote ??
+                        (identical > 0
+                            ? `Nothing changed: ${identical === 1 ? 'the replacement’s new_string is' : `${identical} replacements’ new_string are`} identical to old_string, so the file is exactly as it was. Write the text you want in new_string.`
+                            : 'Nothing changed: the file is exactly as it was.');
+                    return { path, ok: true, replacementsApplied: 0, alreadyApplied, note };
                 }
                 if (onFileDiff)
                     onFileDiff({ path, oldContent, newContent: content });
@@ -853,24 +876,61 @@ export function buildTools(backend, config) {
                 // A replacement whose old text ended in a newline and whose new text does not
                 // joins the line after it onto its last line. Applied as written, but said:
                 // flash-m28 saw two lines merged only one round trip later.
-                const joined = replacements.filter((r) => typeof r.old_string === 'string' &&
+                const dropped = replacements
+                    .map((r, i) => ({ ...r, position: i + 1 }))
+                    .filter((r) => typeof r.old_string === 'string' &&
                     typeof r.new_string === 'string' &&
                     r.old_string.endsWith('\n') &&
                     r.new_string !== '' &&
-                    !r.new_string.endsWith('\n')).length;
+                    !r.new_string.endsWith('\n'));
+                const syntax = await syntaxErrorAfterWrite(path);
+                // Those two facts are ONE accident, and reported apart the model repairs the
+                // wrong one: flash-m55 dropped the boundary on two consecutive edit_file calls,
+                // both left `handlers/conduit.ts` unparseable, and it fixed the fused LINE's
+                // text — which re-fused the next line in the same batch. When the parse error
+                // follows a dropped newline, name the fused line and the single edit that
+                // undoes it, instead of a style note beside an unrelated-looking parse error.
+                const which = dropped.length === 1
+                    ? `replacement ${dropped[0].position}`
+                    : `replacements ${dropped.map((r) => r.position).join(', ')}`;
+                const located = dropped.flatMap((r) => {
+                    const line = fusedLine(finalContent, r.new_string);
+                    return line ? [line] : [];
+                });
+                const fused = located.slice(0, 3);
+                const fusedOmitted = located.length - fused.length;
+                const shownFused = fused
+                    .map((l) => `  ${l.line}: ${l.text.length > 200 ? `${l.text.slice(0, 200)}…` : l.text}`)
+                    .join('\n');
+                const fusedNote = syntax.syntaxError && dropped.length > 0
+                    ? 'The file no longer parses after this change, and ' +
+                        `${which} removed the line break that followed the replaced text — so the next line ` +
+                        'now continues on the line before it, and that fused line is what the parser rejects:\n' +
+                        (shownFused || `  (not located as the file now reads — read_file ${path})`) +
+                        (fusedOmitted > 0
+                            ? `\n  (${fusedOmitted} more fused line(s) — read_file ${path})`
+                            : '') +
+                        `\nRe-send ${which} with the trailing newline restored on new_string (change nothing ` +
+                        "else about it). Editing the FUSED LINE's text instead fuses the next line the same " +
+                        `way (flash-m55: three edits in a row).\n${syntax.syntaxError}`
+                    : null;
                 return {
                     path,
                     ok: true,
                     replacementsApplied: replacements.length - alreadyApplied,
-                    ...(joined > 0
-                        ? {
-                            newlineNote: `${joined === 1 ? 'A replacement' : `${joined} replacements`} removed the line break after the replaced text (old_string ended with a newline, new_string does not), so the next line now continues on the same line. Check the excerpt; add the newline back if that was not intended.`,
-                        }
-                        : {}),
+                    ...(fusedNote
+                        ? { syntaxError: fusedNote }
+                        : {
+                            ...(dropped.length > 0
+                                ? {
+                                    newlineNote: `${dropped.length === 1 ? 'A replacement' : `${dropped.length} replacements`} removed the line break after the replaced text (old_string ended with a newline, new_string does not), so the next line now continues on the same line. Check the excerpt; add the newline back if that was not intended.`,
+                                }
+                                : {}),
+                            ...syntax,
+                        }),
                     ...(alreadyApplied > 0 ? { alreadyApplied, note: alreadyNote } : {}),
                     totalLines: countLines(finalContent),
                     ...(excerpt ? { excerpt: sanitizeFileContent(excerpt, path) } : {}),
-                    ...(await syntaxErrorAfterWrite(path)),
                 };
             }
             catch (e) {
@@ -1395,13 +1455,26 @@ export function buildTools(backend, config) {
                             `kill $(cat /tmp/${taskId}.pid) 2>/dev/null; pkill -f ${taskId}.sh) and move on; do not wait on it again.`,
                     };
                 }
+                // The output so far rides the result: a wait that shows nothing was waited blind
+                // (X1 flash-m50: 4m42s across two waits on an 11-minute run).
+                const own = outputFileByTask.get(taskId);
+                let soFar;
+                try {
+                    const r = await backend.run(`cat ${log}${own ? ` ${shellQuote(own)}` : ''} 2>/dev/null | tail -c 3000`, { timeout: 5_000 });
+                    soFar = r.stdout ?? '';
+                }
+                catch (_error) {
+                    // No tail: the note still says how to peek.
+                    soFar = '';
+                }
                 return {
                     taskId,
                     status: 'running',
                     waitedMs,
+                    ...(soFar.trim() ? { outputSoFar: sanitizeOutput(soFar) } : {}),
                     note: `Still running after ${Math.round(waitedMs / 1000)}s. Call wait_for_task again to ` +
-                        `keep waiting — its result carries the log output. To peek at the output so far, ` +
-                        `exec_command: tail ${log} (read_file cannot reach /tmp).`,
+                        `keep waiting — its result carries the log output${soFar.trim() ? '; outputSoFar is the end of the log as it stands, so there is no need to tail it' : ''}. ` +
+                        `Do other work in the meantime (another suite, a fix you have already found) rather than waiting.`,
                 };
             }
             let output;
@@ -1413,6 +1486,20 @@ export function buildTools(backend, config) {
                 // an empty output with a real exit code is still a result.
                 output = '';
             }
+            // A command that wrote its output to its own file (`> /tmp/e2e.log`) left the task log
+            // holding a word: read that file too, so the result (and every note built on it) has the
+            // run's output (X1 flash-m48: 60 passed / 14 failed, and the notes saw "started").
+            const ownFile = outputFileByTask.get(taskId);
+            if (ownFile && output.trim().length < 2000) {
+                try {
+                    const ownText = await backend.readFile(ownFile);
+                    if (ownText.trim())
+                        output = `${output.trim() ? `${output.trimEnd()}\n` : ''}${ownText}`;
+                }
+                catch (_error) {
+                    // The file is gone or unreadable: the task log is the whole result, as before.
+                }
+            }
             // Same shaping as a foreground exec result, so the executor reads both
             // the same way.
             return {

package/dist/utilities.d.ts

@@ -249,6 +249,8 @@ export declare const MAX_BATCH_READ_BYTES: number;
  * needs.
  */
 export declare const MAX_READ_RETURN_CHARS: number;
+/** A file this small is returned whole even when a window is asked for (paging it costs a call each). */
+export declare const SMALL_FILE_WHOLE_CHARS: number;
 /** Max search results. */
 export declare const MAX_SEARCH_RESULTS = 50;
 /** Max find results. */
@@ -337,4 +339,20 @@ export declare function parseCheckProblem(result: {
     stderr: string;
     exitCode: number;
 }): string | null;
+/**
+ * The line a replacement fused when it dropped the newline its `old_string`
+ * ended with: `new_string`'s text is followed on the same line by what used to
+ * be the next line. Read off the file as it now is, so the line shown is the
+ * line the parser is actually complaining about.
+ *
+ * @param content - The file's content after the edit.
+ * @param newString - A replacement's `new_string`, whose `old_string` ended with a newline.
+ * @returns The fused line's 1-based number and its text, or null when the
+ *   replacement's text is not followed by more of the same line (it ends the
+ *   file, the following newline survived, or another replacement rewrote it).
+ */
+export declare function fusedLine(content: string, newString: string): {
+    line: number;
+    text: string;
+} | null;
 //# sourceMappingURL=utilities.d.ts.map

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

@@ -101,7 +101,13 @@ const NON_SECRET_VALUES = new Set([
 const jsonValueReplacer = (quote) => (match, prefix) => {
     const value = match.slice(prefix.length);
     const inner = value.slice(1, -1);
-    if (NON_SECRET_VALUES.has(inner.toLowerCase()))
+    // An empty value hides nothing, and a suite fixture's `"password": ""` is the fact a
+    // failing assertion turns on (X1 flash-m52).
+    // A version (`"jsonwebtoken": "9.0.2"`, a package name that holds a keyword) is not a
+    // credential, and a masked one hid which version is installed (X1 flash-m57).
+    if (/^[\^~]?\d+\.\d+\.\d+(?:[-+][\w.-]+)?$/.test(inner))
+        return match;
+    if (inner === '' || NON_SECRET_VALUES.has(inner.toLowerCase()))
         return match;
     return `${prefix}${quote}[REDACTED]${quote}`;
 };
@@ -492,6 +498,8 @@ export const MAX_BATCH_READ_BYTES = 200 * 1024;
  * needs.
  */
 export const MAX_READ_RETURN_CHARS = 80 * 1024;
+/** A file this small is returned whole even when a window is asked for (paging it costs a call each). */
+export const SMALL_FILE_WHOLE_CHARS = 24 * 1024;
 /** Max search results. */
 export const MAX_SEARCH_RESULTS = 50;
 /** Max find results. */
@@ -716,3 +724,33 @@ export function parseCheckProblem(result) {
         return null;
     return text.slice(0, 1200);
 }
+/**
+ * The line a replacement fused when it dropped the newline its `old_string`
+ * ended with: `new_string`'s text is followed on the same line by what used to
+ * be the next line. Read off the file as it now is, so the line shown is the
+ * line the parser is actually complaining about.
+ *
+ * @param content - The file's content after the edit.
+ * @param newString - A replacement's `new_string`, whose `old_string` ended with a newline.
+ * @returns The fused line's 1-based number and its text, or null when the
+ *   replacement's text is not followed by more of the same line (it ends the
+ *   file, the following newline survived, or another replacement rewrote it).
+ */
+export function fusedLine(content, newString) {
+    for (let at = content.indexOf(newString); at >= 0; at = content.indexOf(newString, at + 1)) {
+        const endsAt = at + newString.length;
+        const next = content[endsAt];
+        // End of file (nothing was joined) or a newline (the boundary survived) are
+        // both "not fused". A later replacement in the same batch may have rewritten
+        // this text, so keep looking rather than giving up on the first occurrence.
+        if (next === undefined || next === '\n')
+            continue;
+        const lineStart = content.lastIndexOf('\n', at) + 1;
+        const lineEnd = content.indexOf('\n', endsAt);
+        return {
+            line: content.slice(0, lineStart).split('\n').length,
+            text: content.slice(lineStart, lineEnd === -1 ? undefined : lineEnd),
+        };
+    }
+    return null;
+}

package/package.json

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