@molecule/api-ai-tools 1.5.0 → 1.5.1

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

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.
@@ -1152,7 +1159,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 +1231,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.1",
   "description": "Shared AI agent tools with backend abstraction for sandbox and local execution",
   "type": "module",
   "main": "dist/index.js",