@sema-agent/core 2.4.0 → 2.5.0

package/dist/tools/fs/fs-bash.js

@@ -173,7 +173,7 @@ async function runShell(env, cwd, toolName, command, timeoutSec, caps, signal, c
             const rawRemainSec = Math.floor((deadline - Date.now()) / 1000);
             const maxSec = Math.max(1, rawRemainSec);
             if (maxSec < timeout) {
-                execClamp.onClamp?.(timeout, maxSec);
+                execClamp.onClamp?.(requestedSec, maxSec);
                 timeout = maxSec;
                 clampedByDeadline = true;
                 deadlineExhausted = rawRemainSec < 1;
@@ -310,6 +310,9 @@ async function runShell(env, cwd, toolName, command, timeoutSec, caps, signal, c
             cwdOutsideNote = `NOTE: working directory is now outside the task root(s) (${cwdRef.current}); relative paths in the structured file tools (Read/Edit/Write/Grep/Glob) will resolve there and may be refused. Pass absolute in-root paths, or \`cd\` back inside.`;
         }
     }
+    const survivedCapNote = cappedByMaxTimeout
+        ? `NOTE: requested timeout ${requestedSec}s was capped to the ${caps.maxSec}s engine ceiling (requests above the max are reduced to it) — no effect on this run (the command completed in time); use run_in_background for work that needs longer.`
+        : "";
     const clippedStdout = clipShellOutput(stdout);
     const clippedStderr = clipShellOutput(stderr);
     const stdoutImage = dataUriImageFromStdout(stdout);
@@ -319,9 +322,9 @@ async function runShell(env, cwd, toolName, command, timeoutSec, caps, signal, c
         return {
             content: [
                 { type: "image", data: stdoutImage.data, mimeType: stdoutImage.mime },
-                { type: "text", text: `exit code: ${exitCode}\n[Image data detected in stdout and shown above]${stderr.trim() !== "" ? `\n--- stderr ---\n${clippedStderr}` : ""}${imgOverflowNote}${cwdOutsideNote ? `\n${cwdOutsideNote}` : ""}` },
+                { type: "text", text: `exit code: ${exitCode}\n[Image data detected in stdout and shown above]${stderr.trim() !== "" ? `\n--- stderr ---\n${clippedStderr}` : ""}${imgOverflowNote}${cwdOutsideNote ? `\n${cwdOutsideNote}` : ""}${survivedCapNote ? `\n${survivedCapNote}` : ""}` },
             ],
-            details: { type: "bash", stdout: "[image data]", stderr: clippedStderr, exitCode, isImage: true, ...(imgOverflowFile !== undefined ? { output_file: imgOverflowFile } : {}) },
+            details: { type: "bash", stdout: "[image data]", stderr: clippedStderr, exitCode, isImage: true, ...(imgOverflowFile !== undefined ? { output_file: imgOverflowFile } : {}), ...(cappedByMaxTimeout ? { requestedTimeoutSec: requestedSec, cappedToMaxTimeoutSec: caps.maxSec } : {}) },
         };
     }
     const cleanOverflowFile = stdout.length > bashMaxOutputChars() || stderr.length > bashMaxOutputChars() ? await writeShellOverflowFile(env, stdout, stderr) : undefined;
@@ -334,6 +337,8 @@ async function runShell(env, cwd, toolName, command, timeoutSec, caps, signal, c
         parts.push(overflowNote.trim());
     if (cwdOutsideNote)
         parts.push(cwdOutsideNote);
+    if (survivedCapNote)
+        parts.push(survivedCapNote);
     return {
         content: parts.join("\n"),
         details: {
@@ -343,6 +348,7 @@ async function runShell(env, cwd, toolName, command, timeoutSec, caps, signal, c
             exitCode,
             ...(exit1Note ? { returnCodeInterpretation: exit1Note } : {}),
             ...(cleanOverflowFile !== undefined ? { output_file: cleanOverflowFile } : {}),
+            ...(cappedByMaxTimeout ? { requestedTimeoutSec: requestedSec, cappedToMaxTimeoutSec: caps.maxSec } : {}),
         },
     };
 }
@@ -379,7 +385,7 @@ export function createBashTool(env, rootCanonical, coAuthor = false, cwdRef = {
         description: bashDescription(coAuthor, timeoutCaps, bgNotifies, bgRetained),
         parameters: Type.Object({
             command: Type.String({ description: "The command to execute" }),
-            timeout: Type.Optional(Type.Number({ description: `Optional timeout in milliseconds (max ${timeoutCaps.maxMs})` })),
+            timeout: Type.Optional(Type.Number({ description: `Optional timeout in milliseconds (max ${timeoutCaps.maxMs}; requests above the max are capped to it)` })),
             description: Type.Optional(Type.String({
                 description: 'Clear, concise description of what this command does in active voice. Never use words like "complex" or "risk" in the description - just describe what it does.\n' +
                     "\n" +
@@ -632,7 +638,7 @@ export function createBashReadonlyTool(env, rootCanonical, allow, execClamp, tim
             "allowlisted commands run. Still subject to the deployment's approval policy.",
         parameters: Type.Object({
             command: Type.String({ description: "A single allowlisted read-only command (no shell operators)." }),
-            timeout: Type.Optional(Type.Number({ description: `Timeout in milliseconds (default ${timeoutCaps.defaultMs}, max ${timeoutCaps.maxMs}).` })),
+            timeout: Type.Optional(Type.Number({ description: `Timeout in milliseconds (default ${timeoutCaps.defaultMs}, max ${timeoutCaps.maxMs}; requests above the max are capped to it).` })),
         }),
         effect: "read",
         execute: async (args, ctx) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/core",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Stateless, task-oriented AI agent core",
   "type": "module",
   "license": "BUSL-1.1",