bedrock-agentcore 0.0.1 → 0.2.0

package/dist/src/tools/code-interpreter/integrations/strands/execute-command-tool.js

@@ -0,0 +1,42 @@
+/// <reference types="node" />
+import { tool } from '@strands-agents/sdk';
+import { z } from 'zod';
+/**
+ * Creates a Strands SDK tool for executing shell commands in CodeInterpreter.
+ *
+ * @param interpreter - CodeInterpreter instance
+ * @returns Strands SDK tool for command execution
+ *
+ * @experimental
+ * @example
+ * ```typescript
+ * import { createExecuteCommandTool } from 'bedrock-agentcore/experimental/code-interpreter/strands'
+ * import { CodeInterpreter } from 'bedrock-agentcore/code-interpreter'
+ *
+ * const interpreter = new CodeInterpreter({ region: 'us-west-2' })
+ * const executeCommandTool = createExecuteCommandTool(interpreter)
+ *
+ * // Use with Strands SDK Agent
+ * const agent = new Agent({
+ *   model: new BedrockModel({ modelId: 'anthropic.claude-sonnet-4-20250514-v1:0' }),
+ *   tools: [executeCommandTool]
+ * })
+ * ```
+ */
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type, @typescript-eslint/explicit-module-boundary-types
+export function createExecuteCommandTool(interpreter) {
+    return tool({
+        name: 'executeCommand',
+        description: `Execute shell commands in the sandbox environment.
+Use this to run system commands, install packages, manipulate files with Unix tools, etc.
+The environment persists across executions within the same session.`,
+        inputSchema: z.object({
+            command: z.string().describe('The shell command to execute'),
+        }),
+        callback: async ({ command }) => {
+            const result = await interpreter.executeCommand({ command });
+            return result;
+        },
+    });
+}
+//# sourceMappingURL=execute-command-tool.js.map

package/dist/src/tools/code-interpreter/integrations/strands/execute-command-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-command-tool.js","sourceRoot":"","sources":["../../../../../../src/tools/code-interpreter/integrations/strands/execute-command-tool.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAE9B,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,+HAA+H;AAC/H,MAAM,UAAU,wBAAwB,CAAC,WAA4B;IACnE,OAAO,IAAI,CAAC;QACV,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE;;oEAEmD;QAChE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;SAC7D,CAAC;QACF,QAAQ,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YAC9B,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;YAE5D,OAAO,MAAM,CAAA;QACf,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/src/tools/code-interpreter/integrations/strands/file-operations-tool.d.ts

@@ -0,0 +1,33 @@
+import type { CodeInterpreter } from '../../client.js';
+/**
+ * Creates a Strands SDK tool for file operations in CodeInterpreter.
+ *
+ * @param interpreter - CodeInterpreter instance
+ * @returns Strands SDK tool for file operations
+ *
+ * @experimental
+ * @example
+ * ```typescript
+ * import { createFileOperationsTool } from 'bedrock-agentcore/experimental/code-interpreter/strands'
+ * import { CodeInterpreter } from 'bedrock-agentcore/code-interpreter'
+ *
+ * const interpreter = new CodeInterpreter({ region: 'us-west-2' })
+ * const fileOpsTool = createFileOperationsTool(interpreter)
+ *
+ * // Use with Strands SDK Agent
+ * const agent = new Agent({
+ *   model: new BedrockModel({ modelId: 'anthropic.claude-sonnet-4-20250514-v1:0' }),
+ *   tools: [fileOpsTool]
+ * })
+ * ```
+ */
+export declare function createFileOperationsTool(interpreter: CodeInterpreter): import("@strands-agents/sdk").InvokableTool<{
+    operation: "remove" | "write" | "read" | "list";
+    path: string;
+    files?: {
+        path: string;
+        content: string;
+    }[] | undefined;
+    paths?: string[] | undefined;
+}, string>;
+//# sourceMappingURL=file-operations-tool.d.ts.map

package/dist/src/tools/code-interpreter/integrations/strands/file-operations-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-operations-tool.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/code-interpreter/integrations/strands/file-operations-tool.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,eAAe;;;;;;;;WAwDpE"}

package/dist/src/tools/code-interpreter/integrations/strands/file-operations-tool.js

@@ -0,0 +1,78 @@
+/// <reference types="node" />
+import { tool } from '@strands-agents/sdk';
+import { z } from 'zod';
+/**
+ * Creates a Strands SDK tool for file operations in CodeInterpreter.
+ *
+ * @param interpreter - CodeInterpreter instance
+ * @returns Strands SDK tool for file operations
+ *
+ * @experimental
+ * @example
+ * ```typescript
+ * import { createFileOperationsTool } from 'bedrock-agentcore/experimental/code-interpreter/strands'
+ * import { CodeInterpreter } from 'bedrock-agentcore/code-interpreter'
+ *
+ * const interpreter = new CodeInterpreter({ region: 'us-west-2' })
+ * const fileOpsTool = createFileOperationsTool(interpreter)
+ *
+ * // Use with Strands SDK Agent
+ * const agent = new Agent({
+ *   model: new BedrockModel({ modelId: 'anthropic.claude-sonnet-4-20250514-v1:0' }),
+ *   tools: [fileOpsTool]
+ * })
+ * ```
+ */
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type, @typescript-eslint/explicit-module-boundary-types
+export function createFileOperationsTool(interpreter) {
+    return tool({
+        name: 'fileOperations',
+        description: `Manage files in the code execution sandbox.
+Use this to create notebooks/scripts, store intermediate results, and inspect outputs.
+Operations: write (create/update files), read (get file contents), list (show directory contents), remove (delete files).`,
+        inputSchema: z.object({
+            operation: z.enum(['write', 'read', 'list', 'remove']).describe('File operation to perform'),
+            files: z
+                .array(z.object({
+                path: z.string().describe('File path'),
+                content: z.string().describe('File content (for write operation)'),
+            }))
+                .optional()
+                .describe('Files to write (for write operation)'),
+            paths: z.array(z.string()).optional().describe('File paths to read or remove (for read/remove operations)'),
+            path: z.string().optional().default('.').describe('Directory path to list (for list operation)'),
+        }),
+        callback: async ({ operation, files, paths, path }) => {
+            switch (operation) {
+                case 'write': {
+                    if (!files || files.length === 0) {
+                        return 'status: error\nerror: No files specified for write operation';
+                    }
+                    const result = await interpreter.writeFiles({ files });
+                    return result;
+                }
+                case 'read': {
+                    if (!paths || paths.length === 0) {
+                        return 'status: error\nerror: No paths specified for read operation';
+                    }
+                    const result = await interpreter.readFiles({ paths });
+                    return result;
+                }
+                case 'list': {
+                    const result = await interpreter.listFiles({ path });
+                    return result;
+                }
+                case 'remove': {
+                    if (!paths || paths.length === 0) {
+                        return 'status: error\nerror: No paths specified for remove operation';
+                    }
+                    const result = await interpreter.removeFiles({ paths });
+                    return result;
+                }
+                default:
+                    return 'status: error\nerror: Invalid operation';
+            }
+        },
+    });
+}
+//# sourceMappingURL=file-operations-tool.js.map

package/dist/src/tools/code-interpreter/integrations/strands/file-operations-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-operations-tool.js","sourceRoot":"","sources":["../../../../../../src/tools/code-interpreter/integrations/strands/file-operations-tool.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAE9B,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,+HAA+H;AAC/H,MAAM,UAAU,wBAAwB,CAAC,WAA4B;IACnE,OAAO,IAAI,CAAC;QACV,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE;;0HAEyG;QACtH,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;YAC5F,KAAK,EAAE,CAAC;iBACL,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;gBACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;aACnE,CAAC,CACH;iBACA,QAAQ,EAAE;iBACV,QAAQ,CAAC,sCAAsC,CAAC;YACnD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;YAC3G,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC;SACjG,CAAC;QACF,QAAQ,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE;YACpD,QAAQ,SAAS,EAAE,CAAC;gBAClB,KAAK,OAAO,CAAC,CAAC,CAAC;oBACb,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBACjC,OAAO,8DAA8D,CAAA;oBACvE,CAAC;oBACD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;oBACtD,OAAO,MAAM,CAAA;gBACf,CAAC;gBAED,KAAK,MAAM,CAAC,CAAC,CAAC;oBACZ,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBACjC,OAAO,6DAA6D,CAAA;oBACtE,CAAC;oBACD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;oBACrD,OAAO,MAAM,CAAA;gBACf,CAAC;gBAED,KAAK,MAAM,CAAC,CAAC,CAAC;oBACZ,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,CAAA;oBACpD,OAAO,MAAM,CAAA;gBACf,CAAC;gBAED,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACd,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBACjC,OAAO,+DAA+D,CAAA;oBACxE,CAAC;oBACD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;oBACvD,OAAO,MAAM,CAAA;gBACf,CAAC;gBAED;oBACE,OAAO,yCAAyC,CAAA;YACpD,CAAC;QACH,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/src/tools/code-interpreter/integrations/strands/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Strands SDK integrations for AWS Bedrock AgentCore CodeInterpreter.
+ *
+ * **⚠️ EXPERIMENTAL:** This integration uses the Strands TypeScript SDK, which is
+ * currently experimental and subject to breaking changes.
+ *
+ * This module provides a unified CodeInterpreterTools class that simplifies
+ * integration with Strands SDK Agent.
+ *
+ * @experimental
+ * @example
+ * ```typescript
+ * import { Agent, BedrockModel } from '@strands-agents/sdk'
+ * import { CodeInterpreterTools } from 'bedrock-agentcore/experimental/code-interpreter/strands'
+ *
+ * const codeInterpreter = new CodeInterpreterTools({ region: 'us-west-2' })
+ *
+ * const agent = new Agent({
+ *   model: new BedrockModel({ modelId: 'anthropic.claude-sonnet-4-20250514-v1:0' }),
+ *   instructions: 'You are a helpful coding assistant...',
+ *   tools: codeInterpreter.tools,
+ * })
+ *
+ * // Clean up when done
+ * await codeInterpreter.stopSession()
+ * ```
+ */
+export { CodeInterpreterTools } from './tools.js';
+export { createExecuteCodeTool } from './execute-code-tool.js';
+export { createExecuteCommandTool } from './execute-command-tool.js';
+export { createFileOperationsTool } from './file-operations-tool.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/tools/code-interpreter/integrations/strands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/code-interpreter/integrations/strands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/src/tools/code-interpreter/integrations/strands/index.js

@@ -0,0 +1,32 @@
+/**
+ * Strands SDK integrations for AWS Bedrock AgentCore CodeInterpreter.
+ *
+ * **⚠️ EXPERIMENTAL:** This integration uses the Strands TypeScript SDK, which is
+ * currently experimental and subject to breaking changes.
+ *
+ * This module provides a unified CodeInterpreterTools class that simplifies
+ * integration with Strands SDK Agent.
+ *
+ * @experimental
+ * @example
+ * ```typescript
+ * import { Agent, BedrockModel } from '@strands-agents/sdk'
+ * import { CodeInterpreterTools } from 'bedrock-agentcore/experimental/code-interpreter/strands'
+ *
+ * const codeInterpreter = new CodeInterpreterTools({ region: 'us-west-2' })
+ *
+ * const agent = new Agent({
+ *   model: new BedrockModel({ modelId: 'anthropic.claude-sonnet-4-20250514-v1:0' }),
+ *   instructions: 'You are a helpful coding assistant...',
+ *   tools: codeInterpreter.tools,
+ * })
+ *
+ * // Clean up when done
+ * await codeInterpreter.stopSession()
+ * ```
+ */
+export { CodeInterpreterTools } from './tools.js';
+export { createExecuteCodeTool } from './execute-code-tool.js';
+export { createExecuteCommandTool } from './execute-command-tool.js';
+export { createFileOperationsTool } from './file-operations-tool.js';
+//# sourceMappingURL=index.js.map

package/dist/src/tools/code-interpreter/integrations/strands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/tools/code-interpreter/integrations/strands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/src/tools/code-interpreter/integrations/strands/tools.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Unified CodeInterpreter Tools for Strands SDK
+ *
+ * Provides all three CodeInterpreter tools and session management in one class.
+ */
+import { CodeInterpreter } from '../../client.js';
+import type { CodeInterpreterConfig, SessionInfo } from '../../types.js';
+import { createExecuteCodeTool } from './execute-code-tool.js';
+import { createFileOperationsTool } from './file-operations-tool.js';
+import { createExecuteCommandTool } from './execute-command-tool.js';
+/**
+ * CodeInterpreterTools - All-in-one CodeInterpreter integration for Strands SDK
+ *
+ * Provides three ready-to-use tools and session management in a single class.
+ *
+ * @example
+ * ```typescript
+ * import { CodeInterpreterTools } from 'bedrock-agentcore/experimental/code-interpreter/strands'
+ * import { Agent, BedrockModel } from '@strands-agents/sdk'
+ *
+ * // Create tools instance
+ * const codeInterpreter = new CodeInterpreterTools({ region: 'us-west-2' })
+ *
+ * // Start session (optional - automatically started on first use)
+ * await codeInterpreter.startSession()
+ *
+ * // Create agent with all three tools
+ * const agent = new Agent({
+ *   model: new BedrockModel({ modelId: 'anthropic.claude-sonnet-4-20250514-v1:0' }),
+ *   tools: codeInterpreter.tools,
+ * })
+ *
+ * // Clean up when done
+ * await codeInterpreter.stopSession()
+ * ```
+ */
+export declare class CodeInterpreterTools {
+    private interpreter;
+    /**
+     * Tool for executing Python, JavaScript, or TypeScript code
+     */
+    readonly executeCode: ReturnType<typeof createExecuteCodeTool>;
+    /**
+     * Tool for file operations (read, write, list, remove)
+     */
+    readonly fileOperations: ReturnType<typeof createFileOperationsTool>;
+    /**
+     * Tool for executing shell commands
+     */
+    readonly executeCommand: ReturnType<typeof createExecuteCommandTool>;
+    /**
+     * All three tools in an array for easy spreading into agent config
+     *
+     * @example
+     * ```typescript
+     * const agent = new Agent({
+     *   tools: codeInterpreter.tools, // spreads all three tools
+     * })
+     *
+     * // Or combine with other tools
+     * const agent = new Agent({
+     *   tools: [...codeInterpreter.tools, ...browserTools.tools],
+     * })
+     * ```
+     */
+    readonly tools: Array<ReturnType<typeof createExecuteCodeTool> | ReturnType<typeof createFileOperationsTool> | ReturnType<typeof createExecuteCommandTool>>;
+    constructor(config?: CodeInterpreterConfig);
+    /**
+     * Start a CodeInterpreter session
+     *
+     * Sessions are automatically started on first tool use, but you can
+     * call this explicitly to start the session upfront.
+     *
+     * @param sessionName - Optional session name for AWS
+     * @param timeout - Optional session timeout in seconds (default: 900, max: 28800)
+     * @returns Session information
+     */
+    startSession(sessionName?: string, timeout?: number): Promise<SessionInfo>;
+    /**
+     * Stop the current CodeInterpreter session
+     *
+     * Call this when you're done using the tools to clean up resources.
+     */
+    stopSession(): Promise<void>;
+    /**
+     * Get the underlying CodeInterpreter client
+     *
+     * Provides direct access to the client for advanced use cases.
+     *
+     * @returns The CodeInterpreter client instance
+     */
+    getClient(): CodeInterpreter;
+}
+//# sourceMappingURL=tools.d.ts.map

package/dist/src/tools/code-interpreter/integrations/strands/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/code-interpreter/integrations/strands/tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAsB,MAAM,gBAAgB,CAAA;AAC5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,WAAW,CAAiB;IAEpC;;OAEG;IACH,SAAgB,WAAW,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAA;IAErE;;OAEG;IACH,SAAgB,cAAc,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAA;IAE3E;;OAEG;IACH,SAAgB,cAAc,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAA;IAE3E;;;;;;;;;;;;;;OAcG;IACH,SAAgB,KAAK,EAAE,KAAK,CACxB,UAAU,CAAC,OAAO,qBAAqB,CAAC,GACxC,UAAU,CAAC,OAAO,wBAAwB,CAAC,GAC3C,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAC9C,CAAA;gBAEW,MAAM,GAAE,qBAA0B;IAY9C;;;;;;;;;OASG;IACG,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAOhF;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC;;;;;;OAMG;IACH,SAAS,IAAI,eAAe;CAG7B"}

package/dist/src/tools/code-interpreter/integrations/strands/tools.js

@@ -0,0 +1,112 @@
+/**
+ * Unified CodeInterpreter Tools for Strands SDK
+ *
+ * Provides all three CodeInterpreter tools and session management in one class.
+ */
+import { CodeInterpreter } from '../../client.js';
+import { createExecuteCodeTool } from './execute-code-tool.js';
+import { createFileOperationsTool } from './file-operations-tool.js';
+import { createExecuteCommandTool } from './execute-command-tool.js';
+/**
+ * CodeInterpreterTools - All-in-one CodeInterpreter integration for Strands SDK
+ *
+ * Provides three ready-to-use tools and session management in a single class.
+ *
+ * @example
+ * ```typescript
+ * import { CodeInterpreterTools } from 'bedrock-agentcore/experimental/code-interpreter/strands'
+ * import { Agent, BedrockModel } from '@strands-agents/sdk'
+ *
+ * // Create tools instance
+ * const codeInterpreter = new CodeInterpreterTools({ region: 'us-west-2' })
+ *
+ * // Start session (optional - automatically started on first use)
+ * await codeInterpreter.startSession()
+ *
+ * // Create agent with all three tools
+ * const agent = new Agent({
+ *   model: new BedrockModel({ modelId: 'anthropic.claude-sonnet-4-20250514-v1:0' }),
+ *   tools: codeInterpreter.tools,
+ * })
+ *
+ * // Clean up when done
+ * await codeInterpreter.stopSession()
+ * ```
+ */
+export class CodeInterpreterTools {
+    interpreter;
+    /**
+     * Tool for executing Python, JavaScript, or TypeScript code
+     */
+    executeCode;
+    /**
+     * Tool for file operations (read, write, list, remove)
+     */
+    fileOperations;
+    /**
+     * Tool for executing shell commands
+     */
+    executeCommand;
+    /**
+     * All three tools in an array for easy spreading into agent config
+     *
+     * @example
+     * ```typescript
+     * const agent = new Agent({
+     *   tools: codeInterpreter.tools, // spreads all three tools
+     * })
+     *
+     * // Or combine with other tools
+     * const agent = new Agent({
+     *   tools: [...codeInterpreter.tools, ...browserTools.tools],
+     * })
+     * ```
+     */
+    tools;
+    constructor(config = {}) {
+        this.interpreter = new CodeInterpreter(config);
+        // Create all three tools
+        this.executeCode = createExecuteCodeTool(this.interpreter);
+        this.fileOperations = createFileOperationsTool(this.interpreter);
+        this.executeCommand = createExecuteCommandTool(this.interpreter);
+        // Create tools array for Strands SDK (uses arrays, not objects)
+        this.tools = [this.executeCode, this.fileOperations, this.executeCommand];
+    }
+    /**
+     * Start a CodeInterpreter session
+     *
+     * Sessions are automatically started on first tool use, but you can
+     * call this explicitly to start the session upfront.
+     *
+     * @param sessionName - Optional session name for AWS
+     * @param timeout - Optional session timeout in seconds (default: 900, max: 28800)
+     * @returns Session information
+     */
+    async startSession(sessionName, timeout) {
+        const params = {};
+        if (sessionName !== undefined)
+            params.sessionName = sessionName;
+        if (timeout !== undefined)
+            params.timeout = timeout;
+        return this.interpreter.startSession(Object.keys(params).length > 0 ? params : undefined);
+    }
+    /**
+     * Stop the current CodeInterpreter session
+     *
+     * Call this when you're done using the tools to clean up resources.
+     */
+    async stopSession() {
+        await this.interpreter.stopSession();
+    }
+    /**
+     * Get the underlying CodeInterpreter client
+     *
+     * Provides direct access to the client for advanced use cases.
+     *
+     * @returns The CodeInterpreter client instance
+     */
+    getClient() {
+        return this.interpreter;
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/src/tools/code-interpreter/integrations/strands/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../../../../src/tools/code-interpreter/integrations/strands/tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,OAAO,oBAAoB;IACvB,WAAW,CAAiB;IAEpC;;OAEG;IACa,WAAW,CAA0C;IAErE;;OAEG;IACa,cAAc,CAA6C;IAE3E;;OAEG;IACa,cAAc,CAA6C;IAE3E;;;;;;;;;;;;;;OAcG;IACa,KAAK,CAIpB;IAED,YAAY,SAAgC,EAAE;QAC5C,IAAI,CAAC,WAAW,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAA;QAE9C,yBAAyB;QACzB,IAAI,CAAC,WAAW,GAAG,qBAAqB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAC1D,IAAI,CAAC,cAAc,GAAG,wBAAwB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAChE,IAAI,CAAC,cAAc,GAAG,wBAAwB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAEhE,gEAAgE;QAChE,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC,CAAA;IAC3E,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,YAAY,CAAC,WAAoB,EAAE,OAAgB;QACvD,MAAM,MAAM,GAAuB,EAAE,CAAA;QACrC,IAAI,WAAW,KAAK,SAAS;YAAE,MAAM,CAAC,WAAW,GAAG,WAAW,CAAA;QAC/D,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAA;QACnD,OAAO,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAC3F,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAA;IACtC,CAAC;IAED;;;;;;OAMG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,WAAW,CAAA;IACzB,CAAC;CACF"}

package/dist/src/tools/code-interpreter/integrations/vercel-ai/execute-code-tool.d.ts

@@ -0,0 +1,27 @@
+import type { CodeInterpreter } from '../../client.js';
+/**
+ * Creates a Vercel AI SDK tool for executing code in CodeInterpreter.
+ *
+ * @param interpreter - CodeInterpreter instance
+ * @returns Vercel AI SDK tool for code execution
+ *
+ * @example
+ * ```typescript
+ * import { createExecuteCodeTool } from 'bedrock-agentcore/code-interpreter/vercel-ai'
+ * import { CodeInterpreter } from 'bedrock-agentcore/code-interpreter'
+ *
+ * const interpreter = new CodeInterpreter({ region: 'us-west-2' })
+ * const executeCodeTool = createExecuteCodeTool(interpreter)
+ *
+ * // Use with Vercel AI SDK Agent
+ * const agent = new ToolLoopAgent({
+ *   model: bedrock('global.anthropic.claude-sonnet-4-20250514-v1:0'),
+ *   tools: { executeCode: executeCodeTool }
+ * })
+ * ```
+ */
+export declare function createExecuteCodeTool(interpreter: CodeInterpreter): import("ai").Tool<{
+    code: string;
+    language: "python" | "javascript" | "typescript";
+}, string>;
+//# sourceMappingURL=execute-code-tool.d.ts.map

package/dist/src/tools/code-interpreter/integrations/vercel-ai/execute-code-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-code-tool.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/code-interpreter/integrations/vercel-ai/execute-code-tool.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,eAAe;;;WAqBjE"}

package/dist/src/tools/code-interpreter/integrations/vercel-ai/execute-code-tool.js

@@ -0,0 +1,46 @@
+/// <reference types="node" />
+import { tool } from 'ai';
+import { z } from 'zod';
+/**
+ * Creates a Vercel AI SDK tool for executing code in CodeInterpreter.
+ *
+ * @param interpreter - CodeInterpreter instance
+ * @returns Vercel AI SDK tool for code execution
+ *
+ * @example
+ * ```typescript
+ * import { createExecuteCodeTool } from 'bedrock-agentcore/code-interpreter/vercel-ai'
+ * import { CodeInterpreter } from 'bedrock-agentcore/code-interpreter'
+ *
+ * const interpreter = new CodeInterpreter({ region: 'us-west-2' })
+ * const executeCodeTool = createExecuteCodeTool(interpreter)
+ *
+ * // Use with Vercel AI SDK Agent
+ * const agent = new ToolLoopAgent({
+ *   model: bedrock('global.anthropic.claude-sonnet-4-20250514-v1:0'),
+ *   tools: { executeCode: executeCodeTool }
+ * })
+ * ```
+ */
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type, @typescript-eslint/explicit-module-boundary-types
+export function createExecuteCodeTool(interpreter) {
+    return tool({
+        description: `Execute code in a secure sandbox environment.
+Use this to perform calculations, data analysis, create visualizations, or run any code.
+The environment persists across executions within the same session.
+Supports Python, JavaScript, and TypeScript.`,
+        inputSchema: z.object({
+            code: z.string().describe('The code to execute. Can use imports and access files.'),
+            language: z
+                .enum(['python', 'javascript', 'typescript'])
+                .default('python')
+                .describe('Programming language to use (default: python)'),
+        }),
+        execute: async ({ code, language }) => {
+            'use step';
+            const result = await interpreter.executeCode({ code, language });
+            return result;
+        },
+    });
+}
+//# sourceMappingURL=execute-code-tool.js.map

package/dist/src/tools/code-interpreter/integrations/vercel-ai/execute-code-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-code-tool.js","sourceRoot":"","sources":["../../../../../../src/tools/code-interpreter/integrations/vercel-ai/execute-code-tool.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAE9B,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAA;AACzB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,+HAA+H;AAC/H,MAAM,UAAU,qBAAqB,CAAC,WAA4B;IAChE,OAAO,IAAI,CAAC;QACV,WAAW,EAAE;;;6CAG4B;QACzC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;YACnF,QAAQ,EAAE,CAAC;iBACR,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;iBAC5C,OAAO,CAAC,QAAQ,CAAC;iBACjB,QAAQ,CAAC,+CAA+C,CAAC;SAC7D,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE;YACpC,UAAU,CAAA;YAEV,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;YAEhE,OAAO,MAAM,CAAA;QACf,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/src/tools/code-interpreter/integrations/vercel-ai/execute-command-tool.d.ts

@@ -0,0 +1,26 @@
+import type { CodeInterpreter } from '../../client.js';
+/**
+ * Creates a Vercel AI SDK tool for executing shell commands in CodeInterpreter.
+ *
+ * @param interpreter - CodeInterpreter instance
+ * @returns Vercel AI SDK tool for command execution
+ *
+ * @example
+ * ```typescript
+ * import { createExecuteCommandTool } from 'bedrock-agentcore/code-interpreter/vercel-ai'
+ * import { CodeInterpreter } from 'bedrock-agentcore/code-interpreter'
+ *
+ * const interpreter = new CodeInterpreter({ region: 'us-west-2' })
+ * const executeCommandTool = createExecuteCommandTool(interpreter)
+ *
+ * // Use with Vercel AI SDK Agent
+ * const agent = new ToolLoopAgent({
+ *   model: bedrock('global.anthropic.claude-sonnet-4-20250514-v1:0'),
+ *   tools: { executeCommand: executeCommandTool }
+ * })
+ * ```
+ */
+export declare function createExecuteCommandTool(interpreter: CodeInterpreter): import("ai").Tool<{
+    command: string;
+}, string>;
+//# sourceMappingURL=execute-command-tool.d.ts.map

package/dist/src/tools/code-interpreter/integrations/vercel-ai/execute-command-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-command-tool.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/code-interpreter/integrations/vercel-ai/execute-command-tool.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,eAAe;;WAgBpE"}

package/dist/src/tools/code-interpreter/integrations/vercel-ai/execute-command-tool.js

@@ -0,0 +1,41 @@
+/// <reference types="node" />
+import { tool } from 'ai';
+import { z } from 'zod';
+/**
+ * Creates a Vercel AI SDK tool for executing shell commands in CodeInterpreter.
+ *
+ * @param interpreter - CodeInterpreter instance
+ * @returns Vercel AI SDK tool for command execution
+ *
+ * @example
+ * ```typescript
+ * import { createExecuteCommandTool } from 'bedrock-agentcore/code-interpreter/vercel-ai'
+ * import { CodeInterpreter } from 'bedrock-agentcore/code-interpreter'
+ *
+ * const interpreter = new CodeInterpreter({ region: 'us-west-2' })
+ * const executeCommandTool = createExecuteCommandTool(interpreter)
+ *
+ * // Use with Vercel AI SDK Agent
+ * const agent = new ToolLoopAgent({
+ *   model: bedrock('global.anthropic.claude-sonnet-4-20250514-v1:0'),
+ *   tools: { executeCommand: executeCommandTool }
+ * })
+ * ```
+ */
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type, @typescript-eslint/explicit-module-boundary-types
+export function createExecuteCommandTool(interpreter) {
+    return tool({
+        description: `Execute shell commands in the sandbox environment.
+Use this to run system commands, install packages, manipulate files with Unix tools, etc.
+The environment persists across executions within the same session.`,
+        inputSchema: z.object({
+            command: z.string().describe('The shell command to execute'),
+        }),
+        execute: async ({ command }) => {
+            'use step';
+            const result = await interpreter.executeCommand({ command });
+            return result;
+        },
+    });
+}
+//# sourceMappingURL=execute-command-tool.js.map

package/dist/src/tools/code-interpreter/integrations/vercel-ai/execute-command-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-command-tool.js","sourceRoot":"","sources":["../../../../../../src/tools/code-interpreter/integrations/vercel-ai/execute-command-tool.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAE9B,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAA;AACzB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,+HAA+H;AAC/H,MAAM,UAAU,wBAAwB,CAAC,WAA4B;IACnE,OAAO,IAAI,CAAC;QACV,WAAW,EAAE;;oEAEmD;QAChE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;SAC7D,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YAC7B,UAAU,CAAA;YAEV,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;YAE5D,OAAO,MAAM,CAAA;QACf,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/src/tools/code-interpreter/integrations/vercel-ai/file-operations-tool.d.ts

@@ -0,0 +1,32 @@
+import type { CodeInterpreter } from '../../client.js';
+/**
+ * Creates a Vercel AI SDK tool for file operations in CodeInterpreter.
+ *
+ * @param interpreter - CodeInterpreter instance
+ * @returns Vercel AI SDK tool for file operations
+ *
+ * @example
+ * ```typescript
+ * import { createFileOperationsTool } from 'bedrock-agentcore/code-interpreter/vercel-ai'
+ * import { CodeInterpreter } from 'bedrock-agentcore/code-interpreter'
+ *
+ * const interpreter = new CodeInterpreter({ region: 'us-west-2' })
+ * const fileOpsTool = createFileOperationsTool(interpreter)
+ *
+ * // Use with Vercel AI SDK Agent
+ * const agent = new ToolLoopAgent({
+ *   model: bedrock('global.anthropic.claude-sonnet-4-20250514-v1:0'),
+ *   tools: { fileOps: fileOpsTool }
+ * })
+ * ```
+ */
+export declare function createFileOperationsTool(interpreter: CodeInterpreter): import("ai").Tool<{
+    operation: "remove" | "write" | "read" | "list";
+    path: string;
+    files?: {
+        path: string;
+        content: string;
+    }[] | undefined;
+    paths?: string[] | undefined;
+}, string>;
+//# sourceMappingURL=file-operations-tool.d.ts.map