@molecule/api-ai-tools 1.5.0 → 1.5.2

package/dist/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,UAAU,CAAA;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CA+T1C,CAAA"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,UAAU,CAAA;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAgU1C,CAAA"}

package/dist/schemas.js

@@ -121,7 +121,7 @@ export const TOOL_SCHEMAS = {
             properties: {
                 pattern: {
                     type: 'string',
-                    description: 'Text or regex pattern to search for.',
+                    description: 'Extended regex (`a|b`, `(x)+`) or plain text to search for; a pattern that is not a valid regex is searched as plain text.',
                 },
                 path: {
                     type: 'string',

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

package/dist/tools.js

@@ -16,6 +16,13 @@ import { TOOL_SCHEMAS } from './schemas.js';
 const stuckAfterMs = () => Number(process.env.MOL_AI_BG_STUCK_AFTER_MS) || 5 * 60 * 1000;
 /** Cumulative wait_for_task time per task id, this process. */
 const waitedByTask = new Map();
+/**
+ * Each waited task's log size at the end of its last wait. A command whose log
+ * keeps growing is slow, not stuck: a serial 139-test suite was called stuck at
+ * 560 s and the executor was told to kill it while its log still grew (X1 run
+ * m21, 2026-10-15).
+ */
+const logBytesByTask = 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, parseCheckCommand, parseCheckProblem, pathArgError, redactSecrets, redactSecretsInCode, resolvePath, shellQuote, sliceLines, stripControlChars, truncateMiddle, whitespaceTolerantReplace, } from './utilities.js';
 /**
  * Build a complete set of AI agent tools bound to an execution backend.
@@ -827,7 +834,13 @@ export function buildTools(backend, config) {
                 // `file:line:content` for matches, plus `--` group separators. Both
                 // shapes are parsed below; without context the output is unchanged.
                 const contextArg = contextLines > 0 ? `-C ${contextLines}` : '';
-                const result = await backend.run(`grep -rn ${globArg} ${contextArg} ${grepExcludeArgs(path)} --max-count=${MAX_SEARCH_RESULTS} -- ${shellQuote(pattern)} ${shellQuote(path)} 2>/dev/null || true`, { timeout: 10000 });
+                // Extended regex, the dialect a pattern like `useTransitions|BrowserRouter`
+                // is written in: as a basic regex its `|` was a literal character and the
+                // search found nothing (X1 run sol-m07). A pattern that is not a valid
+                // extended regex (`foo(` — an unbalanced paren) makes grep exit 2; it is
+                // then searched as the plain text it was meant as.
+                const grepArgs = `-rn ${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 });
                 // 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
@@ -1152,7 +1165,33 @@ export function buildTools(backend, config) {
             // exiting is not going to: on one run the executor waited five times,
             // 120 s each, on an e2e suite that could never start (no browser page
             // attached). Say so once, name the pid, and refuse to wait on it again.
-            const waitedBefore = waitedByTask.get(taskId) ?? 0;
+            let waitedBefore = waitedByTask.get(taskId) ?? 0;
+            // Output since the last wait means the command is working: the stuck
+            // clock starts again from here.
+            const logBytes = async () => {
+                if (!/^mol-bg-[a-z0-9]+-[a-z0-9]+$/.test(taskId))
+                    return null;
+                let r;
+                try {
+                    r = await backend.run(`wc -c < /tmp/${taskId}.log 2>/dev/null`, { timeout: 5_000 });
+                }
+                catch (_error) {
+                    // No answer about the log: treat the size as unknown, which keeps the
+                    // stuck verdict exactly as before.
+                    r = null;
+                }
+                const n = Number.parseInt(r?.stdout?.trim() ?? '', 10);
+                return Number.isFinite(n) ? n : null;
+            };
+            if (taskId && waitedBefore >= stuckAfterMs()) {
+                const now = await logBytes();
+                const before = logBytesByTask.get(taskId);
+                if (now !== null && before !== undefined && now > before) {
+                    logBytesByTask.set(taskId, now);
+                    waitedByTask.set(taskId, 0);
+                    waitedBefore = 0;
+                }
+            }
             if (taskId && waitedBefore >= stuckAfterMs()) {
                 return {
                     taskId,
@@ -1198,6 +1237,22 @@ export function buildTools(backend, config) {
             const waitedMs = Date.now() - startedAt;
             waitedByTask.set(taskId, waitedBefore + waitedMs);
             if (exitCode === null) {
+                const grownTo = await logBytes();
+                const lastSize = logBytesByTask.get(taskId);
+                if (grownTo !== null)
+                    logBytesByTask.set(taskId, grownTo);
+                const stillWriting = grownTo !== null && (lastSize === undefined ? grownTo > 0 : grownTo > lastSize);
+                if (stillWriting && waitedBefore + waitedMs >= stuckAfterMs()) {
+                    waitedByTask.set(taskId, 0);
+                    return {
+                        taskId,
+                        status: 'running',
+                        waitedMs,
+                        note: `Still running after ${Math.round((waitedBefore + waitedMs) / 1000)}s of waiting, and its ` +
+                            `output is still growing (${grownTo} bytes) — slow, not stuck. Call wait_for_task again to ` +
+                            `keep waiting; peek with exec_command: tail ${log}.`,
+                    };
+                }
                 if (waitedBefore + waitedMs >= stuckAfterMs()) {
                     return {
                         taskId,

package/package.json

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