@strands-agents/sdk 1.17.0 → 1.19.0

package/dist/src/vended-tools/notebook/notebook.js

@@ -1,40 +1,131 @@
 import { tool } from '../../index.js';
 import { z } from 'zod';
+const DEFAULT_MAX_NOTEBOOK_SIZE_BYTES = 1_048_576; // 1 MiB
+/** Modes that mutate `notebooks` state and must be persisted. */
+const MUTATING_MODES = new Set(['create', 'write', 'clear']);
+/** Modes that can grow state and therefore need size-cap enforcement. */
+const GROWING_MODES = new Set(['create', 'write']);
 /**
- * Zod schema for notebook input validation.
+ * Creates a notebook tool with a custom name, description, and size cap.
+ *
+ * @param options - Configuration options for the tool.
+ * @returns A tool that manages text notebooks in agent state.
+ *
+ * @throws Error if `name` is empty or `maxNotebookSizeBytes` is not a positive integer.
+ *
+ * @example
+ * ```typescript
+ * const myNotebook = makeNotebook({ name: 'scratchpad', maxNotebookSizeBytes: 65536 })
+ * const agent = new Agent({ tools: [myNotebook] })
+ * ```
  */
-const notebookInputSchema = z
-    .object({
-    mode: z
-        .enum(['create', 'list', 'read', 'write', 'clear'])
-        .describe('The operation to perform: `create`, `list`, `read`, `write`, `clear`.'),
-    name: z.string().optional().describe('Name of the notebook to operate on. Defaults to "default".'),
-    newStr: z
-        .string()
-        .optional()
-        .describe('Text to append, or the new string for replacement and insertion operations.'),
-    readRange: z
-        .array(z.number())
-        .optional()
-        .describe('Optional parameter of `view` command. Line range to show [start, end]. Supports negative indices.'),
-    oldStr: z.string().optional().describe('String to replace in write mode when doing text replacement.'),
-    insertLine: z
-        .union([z.string(), z.number()])
-        .optional()
-        .describe('Line number (int) or search text (str) for insertion point in write mode.\nSupports negative indices.'),
-})
-    .refine((data) => {
-    // Validate write mode requirements
-    if (data.mode === 'write') {
-        const hasReplacement = data.oldStr !== undefined && data.newStr !== undefined;
-        const hasInsertion = data.insertLine !== undefined && data.newStr !== undefined;
-        const hasAppend = data.oldStr === undefined && data.insertLine === undefined && data.newStr !== undefined;
-        return hasReplacement || hasInsertion || hasAppend;
+export function makeNotebook({ name = 'notebook', description = 'Manages text notebooks for note-taking and documentation. Supports create, list, read, write (append, replace, or insert), and clear operations. In write mode: newStr alone appends to the end; newStr with oldStr replaces matching text; newStr with insertLine inserts at a position. A write only succeeds on a notebook that already exists: use list to check, or create to start a new one (create replaces any existing content). Notebooks persist within the agent invocation.', maxNotebookSizeBytes = DEFAULT_MAX_NOTEBOOK_SIZE_BYTES, } = {}) {
+    if (!name) {
+        throw new Error('name must be a non-empty string');
     }
-    return true;
-}, {
-    message: 'Write operation requires newStr, optionally with oldStr for replacement or insertLine for insertion',
-});
+    if (!Number.isInteger(maxNotebookSizeBytes) || maxNotebookSizeBytes < 1) {
+        throw new Error('maxNotebookSizeBytes must be a positive integer');
+    }
+    /**
+     * Zod schema for notebook input validation.
+     */
+    const notebookInputSchema = z
+        .object({
+        mode: z
+            .enum(['create', 'list', 'read', 'write', 'clear'])
+            .describe('The operation to perform: `create`, `list`, `read`, `write`, `clear`.'),
+        name: z.string().optional().describe('Name of the notebook to operate on. Defaults to "default".'),
+        newStr: z
+            .string()
+            .optional()
+            .describe('Text to append, or the new string for replacement and insertion operations.'),
+        readRange: z
+            .array(z.number())
+            .optional()
+            .describe('Optional parameter of `read` command. Line range to show [start, end]. Supports negative indices.'),
+        oldStr: z.string().optional().describe('String to replace in write mode when doing text replacement.'),
+        insertLine: z
+            .union([z.string(), z.number()])
+            .optional()
+            .describe('Line number (int) or search text (str) for insertion point in write mode.\nSupports negative indices.'),
+    })
+        .refine((data) => {
+        // Validate write mode requirements
+        if (data.mode === 'write') {
+            const hasReplacement = data.oldStr !== undefined && data.newStr !== undefined;
+            const hasInsertion = data.insertLine !== undefined && data.newStr !== undefined;
+            const hasAppend = data.oldStr === undefined && data.insertLine === undefined && data.newStr !== undefined;
+            const isAmbiguous = data.oldStr !== undefined && data.insertLine !== undefined;
+            return (hasReplacement || hasInsertion || hasAppend) && !isAmbiguous;
+        }
+        return true;
+    }, {
+        message: 'Write operation requires newStr, optionally with oldStr for replacement or insertLine for insertion; ' +
+            'oldStr and insertLine cannot be combined',
+    });
+    return tool({
+        name,
+        description,
+        inputSchema: notebookInputSchema,
+        callback: (input, context) => {
+            if (!context) {
+                throw new Error('Tool context is required for notebook operations');
+            }
+            // Get notebooks from state, or initialize if not present
+            const notebooksObj = context.agent.appState.get('notebooks');
+            let notebooks;
+            if (notebooksObj == null) {
+                notebooks = {};
+            }
+            else if (typeof notebooksObj === 'object' && !Array.isArray(notebooksObj)) {
+                if (Object.values(notebooksObj).some((v) => typeof v !== 'string')) {
+                    throw new Error('Malformed notebooks state: keys and values must be strings');
+                }
+                notebooks = notebooksObj;
+            }
+            else {
+                throw new Error('Malformed notebooks state: expected a plain object');
+            }
+            // Ensure default notebook exists
+            if (Object.keys(notebooks).length === 0) {
+                notebooks.default = '';
+            }
+            let result;
+            switch (input.mode) {
+                case 'create':
+                    result = handleCreate(notebooks, input.name ?? 'default', input.newStr);
+                    break;
+                case 'list':
+                    result = handleList(notebooks);
+                    break;
+                case 'read':
+                    result = handleRead(notebooks, input.name ?? 'default', input.readRange);
+                    break;
+                case 'write':
+                    result = handleWrite(notebooks, input.name ?? 'default', input.oldStr, input.newStr, input.insertLine);
+                    break;
+                case 'clear':
+                    result = handleClear(notebooks, input.name ?? 'default');
+                    break;
+                default:
+                    throw new Error(`Unknown mode: ${input.mode}`);
+            }
+            if (GROWING_MODES.has(input.mode)) {
+                const notebookName = input.name ?? 'default';
+                const encoder = new TextEncoder();
+                const size = encoder.encode(notebooks[notebookName]).byteLength;
+                if (size > maxNotebookSizeBytes) {
+                    throw new Error(`Notebook '${notebookName}' content (${size} bytes) would exceed maximum of ${maxNotebookSizeBytes} bytes`);
+                }
+            }
+            if (MUTATING_MODES.has(input.mode)) {
+                // Persist notebooks back to state
+                context.agent.appState.set('notebooks', notebooks);
+            }
+            return result;
+        },
+    });
+}
 /**
  * Notebook tool for managing persistent text notebooks.
  *
@@ -55,48 +146,7 @@ const notebookInputSchema = z
  * )
  * ```
  */
-export const notebook = tool({
-    name: 'notebook',
-    description: 'Manages text notebooks for note-taking and documentation. Supports create, list, read, write (append, replace, or insert), and clear operations. In write mode: newStr alone appends to the end; newStr with oldStr replaces matching text; newStr with insertLine inserts at a position. A write only succeeds on a notebook that already exists: use list to check, or create to start a new one (create replaces any existing content). Notebooks persist within the agent invocation.',
-    inputSchema: notebookInputSchema,
-    callback: (input, context) => {
-        if (!context) {
-            throw new Error('Tool context is required for notebook operations');
-        }
-        // Get notebooks from state, or initialize if not present
-        let notebooks = context.agent.appState.get('notebooks');
-        if (!notebooks) {
-            notebooks = {};
-        }
-        // Ensure default notebook exists
-        if (Object.keys(notebooks).length === 0) {
-            notebooks.default = '';
-        }
-        let result;
-        switch (input.mode) {
-            case 'create':
-                result = handleCreate(notebooks, input.name ?? 'default', input.newStr);
-                break;
-            case 'list':
-                result = handleList(notebooks);
-                break;
-            case 'read':
-                result = handleRead(notebooks, input.name ?? 'default', input.readRange);
-                break;
-            case 'write':
-                result = handleWrite(notebooks, input.name ?? 'default', input.oldStr, input.newStr, input.insertLine);
-                break;
-            case 'clear':
-                result = handleClear(notebooks, input.name ?? 'default');
-                break;
-            default:
-                throw new Error(`Unknown mode: ${input.mode}`);
-        }
-        // Persist notebooks back to state
-        context.agent.appState.set('notebooks', notebooks);
-        return result;
-    },
-});
+export const notebook = makeNotebook();
 /**
  * Handles create operation.
  */
@@ -145,12 +195,13 @@ function handleRead(notebooks, name, readRange) {
         end = lines.length + end + 1;
     }
     const selectedLines = [];
-    for (let lineNum = start; lineNum <= end; lineNum++) {
-        if (lineNum >= 1 && lineNum <= lines.length) {
-            selectedLines.push(`${lineNum}: ${lines[lineNum - 1]}`);
-        }
+    for (let lineNum = Math.max(start, 1); lineNum <= Math.min(end, lines.length); lineNum++) {
+        selectedLines.push(`${lineNum}: ${lines[lineNum - 1]}`);
+    }
+    if (selectedLines.length === 0) {
+        return `No lines found in range [${readRange[0]}, ${readRange[1]}]. Notebook '${name}' has ${lines.length} line(s).`;
     }
-    return selectedLines.length > 0 ? selectedLines.join('\n') : 'No valid lines found in range';
+    return selectedLines.join('\n');
 }
 /**
  * Handles write operation (append, string replacement, or line insertion).

package/dist/src/vended-tools/notebook/notebook.js.map

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

package/dist/src/vended-tools/shell/make-shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"make-shell.d.ts","sourceRoot":"","sources":["../../../../src/vended-tools/shell/make-shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAA;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAQ/C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,CAAC,CAAC,OAAO,CAAA;CACxB;AAgBD,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAA;AAC9E,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAA;AA6B5G;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAA;AAC7E,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAA;AAS3G;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,gBAAgB,CAAA"}
+{"version":3,"file":"make-shell.d.ts","sourceRoot":"","sources":["../../../../src/vended-tools/shell/make-shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAA;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAQ/C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,CAAC,CAAC,OAAO,CAAA;CACxB;AAgBD,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAA;AAC9E,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAA;AAkC5G;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAA;AAC7E,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAA;AAS3G;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,gBAAgB,CAAA"}

package/dist/src/vended-tools/shell/make-shell.js

@@ -40,12 +40,16 @@ export function makeShell(sandboxOrOptions, maybeOptions) {
             const sandbox = boundSandbox ?? context.agent.sandbox;
             try {
                 const result = await sandbox.execute(input.command, { timeout: input.timeout ?? 120 });
-                return { output: result.stdout, error: result.stderr };
+                return { output: result.stdout, error: result.stderr, exit_code: result.exitCode };
             }
             catch (err) {
                 // Shell* extends Bash* so pre-rename catch clauses keep matching.
-                if (err instanceof SandboxTimeoutError)
-                    throw new ShellTimeoutError(err.message);
+                if (err instanceof SandboxTimeoutError) {
+                    // Thrown errors reach the model as `Error: <message>`, so the partial output rides in the message.
+                    // 124 is the timeout(1) convention for a command killed by its time limit.
+                    const partial = { output: err.stdout, error: err.stderr, exit_code: 124 };
+                    throw new ShellTimeoutError(`${err.message}\n${JSON.stringify(partial)}`, partial);
+                }
                 throw new ShellExecutionError(err.message);
             }
         },

package/dist/src/vended-tools/shell/make-shell.js.map

@@ -1 +1 @@
-{"version":3,"file":"make-shell.js","sourceRoot":"","sources":["../../../../src/vended-tools/shell/make-shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAA;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,yBAAyB,EAAoB,MAAM,YAAY,CAAA;AAEhH,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC7D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CACzF,CAAC,CAAA;AAQF;;;;GAIG;AACH,SAAS,gBAAgB,CACvB,gBAA6C,EAC7C,YAA+B;IAE/B,MAAM,YAAY,GAAG,gBAAgB,YAAY,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAA;IACvF,MAAM,OAAO,GAAG,gBAAgB,YAAY,OAAO,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAA;IACrH,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,CAAA;AAClC,CAAC;AAID,MAAM,UAAU,SAAS,CACvB,gBAA6C,EAC7C,YAA+B;IAE/B,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAA;IAElF,OAAO,IAAI,CAAC;QACV,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO;QAC7B,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,yBAAyB;QAC7D,WAAW,EAAE,CAAC,OAAO,CAAC,WAAW,IAAI,uBAAuB,CAAmC;QAC/F,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACjC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;YAClE,CAAC;YAED,MAAM,OAAO,GAAG,YAAY,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAA;YACrD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC,CAAA;gBACtF,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAiB,CAAA;YACvE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,kEAAkE;gBAClE,IAAI,GAAG,YAAY,mBAAmB;oBAAE,MAAM,IAAI,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;gBAChF,MAAM,IAAI,mBAAmB,CAAE,GAAa,CAAC,OAAO,CAAC,CAAA;YACvD,CAAC;QACH,CAAC;KACF,CAAC,CAAA;AACJ,CAAC;AAYD,MAAM,UAAU,QAAQ,CACtB,gBAA6C,EAC7C,YAA+B;IAE/B,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAA;IAClF,OAAO,SAAS,CAAC,YAAY,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM,EAAE,CAAC,CAAA;AAC9E,CAAC"}
+{"version":3,"file":"make-shell.js","sourceRoot":"","sources":["../../../../src/vended-tools/shell/make-shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAA;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,yBAAyB,EAAoB,MAAM,YAAY,CAAA;AAEhH,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC7D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CACzF,CAAC,CAAA;AAQF;;;;GAIG;AACH,SAAS,gBAAgB,CACvB,gBAA6C,EAC7C,YAA+B;IAE/B,MAAM,YAAY,GAAG,gBAAgB,YAAY,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAA;IACvF,MAAM,OAAO,GAAG,gBAAgB,YAAY,OAAO,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAA;IACrH,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,CAAA;AAClC,CAAC;AAID,MAAM,UAAU,SAAS,CACvB,gBAA6C,EAC7C,YAA+B;IAE/B,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAA;IAElF,OAAO,IAAI,CAAC;QACV,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO;QAC7B,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,yBAAyB;QAC7D,WAAW,EAAE,CAAC,OAAO,CAAC,WAAW,IAAI,uBAAuB,CAAmC;QAC/F,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACjC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;YAClE,CAAC;YAED,MAAM,OAAO,GAAG,YAAY,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAA;YACrD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC,CAAA;gBACtF,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAiB,CAAA;YACnG,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,kEAAkE;gBAClE,IAAI,GAAG,YAAY,mBAAmB,EAAE,CAAC;oBACvC,mGAAmG;oBACnG,2EAA2E;oBAC3E,MAAM,OAAO,GAAgB,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,CAAA;oBACtF,MAAM,IAAI,iBAAiB,CAAC,GAAG,GAAG,CAAC,OAAO,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;gBACpF,CAAC;gBACD,MAAM,IAAI,mBAAmB,CAAE,GAAa,CAAC,OAAO,CAAC,CAAA;YACvD,CAAC;QACH,CAAC;KACF,CAAC,CAAA;AACJ,CAAC;AAYD,MAAM,UAAU,QAAQ,CACtB,gBAA6C,EAC7C,YAA+B;IAE/B,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAA;IAClF,OAAO,SAAS,CAAC,YAAY,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM,EAAE,CAAC,CAAA;AAC9E,CAAC"}

package/dist/src/vended-tools/shell/types.d.ts

@@ -13,7 +13,9 @@ export declare const SANDBOX_SHELL_DESCRIPTION: string;
  * type keep working; new code should catch this instead.
  */
 export declare class ShellTimeoutError extends BashTimeoutError {
-    constructor(message: string);
+    /** Output captured before the command was killed, when the sandbox reported it. */
+    readonly partial?: ShellOutput;
+    constructor(message: string, partial?: ShellOutput);
 }
 /**
  * Error thrown when a sandbox-routed shell command fails.
@@ -25,9 +27,8 @@ export declare class ShellExecutionError extends BashSessionError {
     constructor(message: string);
 }
 /**
- * Output format for shell command execution. Structurally identical to the bash
- * tool's output, so pre-rename consumers keep working, but declared standalone;
- * mirrors the Python SDK's `ShellOutput`.
+ * Output format for shell command execution. Declared standalone; mirrors the
+ * Python SDK's `ShellOutput`.
  */
 export interface ShellOutput {
     /**
@@ -39,9 +40,13 @@ export interface ShellOutput {
      * Empty string if no errors occurred.
      */
     error: string;
+    /**
+     * Exit code of the command. Non-zero means the command failed.
+     */
+    exit_code: number;
     /**
      * Allow indexing with string keys for JSONValue compatibility.
      */
-    [key: string]: string;
+    [key: string]: string | number;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/src/vended-tools/shell/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/vended-tools/shell/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAErE,eAAO,MAAM,yBAAyB,QAE8C,CAAA;AAEpF;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,gBAAgB;gBACzC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,gBAAgB;gBAC3C,OAAO,EAAE,MAAM;CAI5B;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;IAEb;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/vended-tools/shell/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAErE,eAAO,MAAM,yBAAyB,QAG8C,CAAA;AAEpF;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,gBAAgB;IACrD,mFAAmF;IACnF,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAA;gBAElB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW;CAKnD;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,gBAAgB;gBAC3C,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;CAC/B"}

package/dist/src/vended-tools/shell/types.js

@@ -5,7 +5,8 @@
  * callers who caught the pre-rename error types keep working.
  */
 import { BashTimeoutError, BashSessionError } from '../bash/types.js';
-export const SANDBOX_SHELL_DESCRIPTION = 'Executes shell commands. Each call runs in a fresh shell; ' +
+export const SANDBOX_SHELL_DESCRIPTION = 'Executes shell commands and returns output (stdout), error (stderr), and exit_code (non-zero means the ' +
+    'command failed). Each call runs in a fresh shell; ' +
     'state such as variables and the working directory does not persist across calls.';
 /**
  * Error thrown when a sandbox-routed shell command exceeds its timeout.
@@ -14,9 +15,13 @@ export const SANDBOX_SHELL_DESCRIPTION = 'Executes shell commands. Each call run
  * type keep working; new code should catch this instead.
  */
 export class ShellTimeoutError extends BashTimeoutError {
-    constructor(message) {
+    /** Output captured before the command was killed, when the sandbox reported it. */
+    partial;
+    constructor(message, partial) {
         super(message);
         this.name = 'ShellTimeoutError';
+        if (partial)
+            this.partial = partial;
     }
 }
 /**

package/dist/src/vended-tools/shell/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/vended-tools/shell/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAErE,MAAM,CAAC,MAAM,yBAAyB,GACpC,4DAA4D;IAC5D,kFAAkF,CAAA;AAEpF;;;;;GAKG;AACH,MAAM,OAAO,iBAAkB,SAAQ,gBAAgB;IACrD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IACjC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,mBAAoB,SAAQ,gBAAgB;IACvD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/vended-tools/shell/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAErE,MAAM,CAAC,MAAM,yBAAyB,GACpC,yGAAyG;IACzG,oDAAoD;IACpD,kFAAkF,CAAA;AAEpF;;;;;GAKG;AACH,MAAM,OAAO,iBAAkB,SAAQ,gBAAgB;IACrD,mFAAmF;IAC1E,OAAO,CAAc;IAE9B,YAAY,OAAe,EAAE,OAAqB;QAChD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;QAC/B,IAAI,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACrC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,mBAAoB,SAAQ,gBAAgB;IACvD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF"}

package/dist/src/vended-tools/web-fetch/extract.d.ts

@@ -0,0 +1,23 @@
+/**
+ * HTML → markdown extraction for the web fetch tool.
+ *
+ * Delegates HTML-to-markdown conversion to turndown with ATX headings and
+ * fenced code blocks. Non-content elements (scripts, styles, media, forms,
+ * etc.) are dropped entirely. `data:` URI images are replaced with their alt
+ * text (or nothing) to avoid enormous blobs in the output. `javascript:`
+ * hrefs and src values are stripped silently.
+ *
+ * Requires `turndown` as an optional peer dependency.
+ */
+/**
+ * Convert HTML to markdown suitable for a model to read.
+ *
+ * The page title, if present, is rendered as a top-level ATX heading so the
+ * model sees it as part of the document. Returns the original HTML string if
+ * conversion fails.
+ *
+ * @param html - Raw HTML string to convert.
+ * @returns The converted markdown string, or the original HTML if conversion failed.
+ */
+export declare function htmlToMarkdown(html: string): Promise<string>;
+//# sourceMappingURL=extract.d.ts.map

package/dist/src/vended-tools/web-fetch/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../../../src/vended-tools/web-fetch/extract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAyGH;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUlE"}

package/dist/src/vended-tools/web-fetch/extract.js

@@ -0,0 +1,130 @@
+/**
+ * HTML → markdown extraction for the web fetch tool.
+ *
+ * Delegates HTML-to-markdown conversion to turndown with ATX headings and
+ * fenced code blocks. Non-content elements (scripts, styles, media, forms,
+ * etc.) are dropped entirely. `data:` URI images are replaced with their alt
+ * text (or nothing) to avoid enormous blobs in the output. `javascript:`
+ * hrefs and src values are stripped silently.
+ *
+ * Requires `turndown` as an optional peer dependency.
+ */
+import { logger } from '../../logging/logger.js';
+// Elements whose entire subtree is discarded.
+const DROPPED_ELEMENTS = [
+    'script',
+    'style',
+    'noscript',
+    'template',
+    'svg',
+    'canvas',
+    'iframe',
+    'object',
+    'embed',
+    'video',
+    'audio',
+    'form',
+    'input',
+    'button',
+    'select',
+    'textarea',
+    'nav',
+];
+// Strip invisible characters before URL scheme detection.
+function _stripInvisible(value) {
+    return value.replace(/^[\p{Cc}\p{Cf}\p{Zs}]+/u, '');
+}
+async function loadTurndown() {
+    try {
+        return (await import('turndown')).default;
+    }
+    catch (cause) {
+        throw new Error("web_fetch requires the 'turndown' package. Install it with: npm install turndown", { cause });
+    }
+}
+async function _createTurndownService() {
+    const Turndown = await loadTurndown();
+    const td = new Turndown({
+        headingStyle: 'atx',
+        codeBlockStyle: 'fenced',
+        bulletListMarker: '-',
+        emDelimiter: '*',
+        strongDelimiter: '**',
+        linkStyle: 'inlined',
+    });
+    // Cast needed because svg/noscript/template are absent from HTMLElementTagNameMap.
+    td.remove(DROPPED_ELEMENTS);
+    // Render the <title> as a top-level heading so it appears in the document
+    // body rather than being silently dropped (turndown ignores <head> elements).
+    td.addRule('title', {
+        filter: 'title',
+        replacement: (_content, node) => {
+            const text = node.textContent?.trim() ?? '';
+            return text ? `# ${text}\n\n` : '';
+        },
+    });
+    // Replace data: URI images with alt text only (they can be enormous blobs).
+    // Strip javascript: src values entirely.
+    td.addRule('safeImage', {
+        filter: 'img',
+        replacement: (_content, node) => {
+            const element = node;
+            const src = (element.getAttribute('src') ?? '').trim();
+            const alt = element.getAttribute('alt') ?? '';
+            if (!src)
+                return alt;
+            try {
+                const scheme = new URL(_stripInvisible(src)).protocol;
+                if (scheme === 'javascript:')
+                    return '';
+                if (scheme === 'data:')
+                    return alt;
+            }
+            catch {
+                // not an absolute URL — pass through as-is
+            }
+            return `![${alt}](${src})`;
+        },
+    });
+    // Strip javascript: hrefs — render link text only.
+    td.addRule('safeLink', {
+        filter: (node) => {
+            if (node.nodeName !== 'A')
+                return false;
+            const href = (node.getAttribute('href') ?? '').trim();
+            try {
+                return new URL(_stripInvisible(href)).protocol === 'javascript:';
+            }
+            catch {
+                return false;
+            }
+        },
+        replacement: (content) => content,
+    });
+    return td;
+}
+// Cache the configured service so rules are registered once across all calls.
+let _turndownServicePromise = null;
+/**
+ * Convert HTML to markdown suitable for a model to read.
+ *
+ * The page title, if present, is rendered as a top-level ATX heading so the
+ * model sees it as part of the document. Returns the original HTML string if
+ * conversion fails.
+ *
+ * @param html - Raw HTML string to convert.
+ * @returns The converted markdown string, or the original HTML if conversion failed.
+ */
+export async function htmlToMarkdown(html) {
+    _turndownServicePromise ??= _createTurndownService();
+    const td = await _turndownServicePromise;
+    try {
+        const markdown = td.turndown(html).trim();
+        return markdown ? markdown + '\n' : '';
+    }
+    catch (error) {
+        logger.warn(`error=<${error}> | html_to_markdown failed, returning raw html`);
+        return html;
+    }
+}
+//# sourceMappingURL=extract.js.map

package/dist/src/vended-tools/web-fetch/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../../../src/vended-tools/web-fetch/extract.ts"],"names":[],"mappings":"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"}

package/dist/src/vended-tools/web-fetch/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Web fetch tool: fetch a URL and return clean markdown suitable for a model to read.
+ *
+ * Distinct from the http-request tool (raw API calls). See {@link webFetch}.
+ */
+export { webFetch, makeWebFetch } from './web-fetch.js';
+export type { MakeWebFetchOptions } from './types.js';
+export type { WebFetchMarkdownInput, WebFetchAgenticInput } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/vended-tools/web-fetch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/vended-tools/web-fetch/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACvD,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AACrD,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA"}

package/dist/src/vended-tools/web-fetch/index.js

@@ -0,0 +1,7 @@
+/**
+ * Web fetch tool: fetch a URL and return clean markdown suitable for a model to read.
+ *
+ * Distinct from the http-request tool (raw API calls). See {@link webFetch}.
+ */
+export { webFetch, makeWebFetch } from './web-fetch.js';
+//# sourceMappingURL=index.js.map

package/dist/src/vended-tools/web-fetch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/vended-tools/web-fetch/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/src/vended-tools/web-fetch/types.d.ts

@@ -0,0 +1,40 @@
+import type { Model } from '../../models/model.js';
+/**
+ * Input parameters for the markdown mode web fetch tool.
+ */
+export interface WebFetchMarkdownInput {
+    /** URL to fetch. Must be http:// or https://. */
+    url: string;
+}
+/**
+ * Input parameters for the agentic mode web fetch tool.
+ */
+export interface WebFetchAgenticInput {
+    /** URL to fetch. Must be http:// or https://. */
+    url: string;
+    /** Question or instruction about the page content. */
+    prompt: string;
+}
+export declare const WEB_FETCH_DESCRIPTION_MARKDOWN: string;
+export declare const WEB_FETCH_DESCRIPTION_AGENTIC: string;
+/**
+ * Options for {@link makeWebFetch}.
+ */
+export interface MakeWebFetchOptions {
+    /** Tool name shown to the model. Defaults to `'web_fetch'`. */
+    name?: string;
+    /** Tool description shown to the model. Defaults to a mode-appropriate description. */
+    description?: string;
+    /** Maximum response body size in bytes. Defaults to 5 MiB. */
+    maxBytes?: number;
+    /** Maximum characters of extracted content delivered to the model. Defaults to 50,000. */
+    maxContentChars?: number;
+    /**
+     * Optional model for the analyst agent. Only used when `mode` is `'agentic'`.
+     * Falls back to the host agent's model when not provided.
+     */
+    model?: Model;
+    /** Extraction mode. Defaults to `'agentic'`. */
+    mode?: 'markdown' | 'agentic';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/vended-tools/web-fetch/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/vended-tools/web-fetch/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAElD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAA;IACX,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAA;CACf;AAED,eAAO,MAAM,8BAA8B,QAGA,CAAA;AAE3C,eAAO,MAAM,6BAA6B,QAIL,CAAA;AAErC;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uFAAuF;IACvF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0FAA0F;IAC1F,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,gDAAgD;IAChD,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,CAAA;CAC9B"}