bedrock-agentcore 0.1.1 → 0.2.0

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

@@ -7,8 +7,8 @@ import type { CodeInterpreter } from '../../client.js';
  *
  * @example
  * ```typescript
- * import { createExecuteCodeTool } from '@bedrock-agentcore/sdk/code-interpreter/vercel-ai'
- * import { CodeInterpreter } from '@bedrock-agentcore/sdk/code-interpreter'
+ * 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)

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

@@ -9,8 +9,8 @@ import { z } from 'zod';
  *
  * @example
  * ```typescript
- * import { createExecuteCodeTool } from '@bedrock-agentcore/sdk/code-interpreter/vercel-ai'
- * import { CodeInterpreter } from '@bedrock-agentcore/sdk/code-interpreter'
+ * 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)

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

@@ -7,8 +7,8 @@ import type { CodeInterpreter } from '../../client.js';
  *
  * @example
  * ```typescript
- * import { createExecuteCommandTool } from '@bedrock-agentcore/sdk/code-interpreter/vercel-ai'
- * import { CodeInterpreter } from '@bedrock-agentcore/sdk/code-interpreter'
+ * 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)

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

@@ -9,8 +9,8 @@ import { z } from 'zod';
  *
  * @example
  * ```typescript
- * import { createExecuteCommandTool } from '@bedrock-agentcore/sdk/code-interpreter/vercel-ai'
- * import { CodeInterpreter } from '@bedrock-agentcore/sdk/code-interpreter'
+ * 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)

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

@@ -7,8 +7,8 @@ import type { CodeInterpreter } from '../../client.js';
  *
  * @example
  * ```typescript
- * import { createFileOperationsTool } from '@bedrock-agentcore/sdk/code-interpreter/vercel-ai'
- * import { CodeInterpreter } from '@bedrock-agentcore/sdk/code-interpreter'
+ * 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)
@@ -21,7 +21,7 @@ import type { CodeInterpreter } from '../../client.js';
  * ```
  */
 export declare function createFileOperationsTool(interpreter: CodeInterpreter): import("ai").Tool<{
-    operation: "write" | "read" | "list" | "remove";
+    operation: "remove" | "write" | "read" | "list";
     path: string;
     files?: {
         path: string;

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

@@ -9,8 +9,8 @@ import { z } from 'zod';
  *
  * @example
  * ```typescript
- * import { createFileOperationsTool } from '@bedrock-agentcore/sdk/code-interpreter/vercel-ai'
- * import { CodeInterpreter } from '@bedrock-agentcore/sdk/code-interpreter'
+ * 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)

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

@@ -8,7 +8,7 @@
  * ```typescript
  * import { ToolLoopAgent } from 'ai'
  * import { bedrock } from '@ai-sdk/amazon-bedrock'
- * import { CodeInterpreterTools } from '@bedrock-agentcore/sdk/code-interpreter/vercel-ai'
+ * import { CodeInterpreterTools } from 'bedrock-agentcore/code-interpreter/vercel-ai'
  *
  * const codeInterpreter = new CodeInterpreterTools({ region: 'us-west-2' })
  *

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

@@ -8,7 +8,7 @@
  * ```typescript
  * import { ToolLoopAgent } from 'ai'
  * import { bedrock } from '@ai-sdk/amazon-bedrock'
- * import { CodeInterpreterTools } from '@bedrock-agentcore/sdk/code-interpreter/vercel-ai'
+ * import { CodeInterpreterTools } from 'bedrock-agentcore/code-interpreter/vercel-ai'
  *
  * const codeInterpreter = new CodeInterpreterTools({ region: 'us-west-2' })
  *

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

@@ -15,7 +15,7 @@ import { createExecuteCommandTool } from './execute-command-tool.js';
  *
  * @example
  * ```typescript
- * import { CodeInterpreterTools } from '@bedrock-agentcore/sdk/code-interpreter/vercel-ai'
+ * import { CodeInterpreterTools } from 'bedrock-agentcore/code-interpreter/vercel-ai'
  * import { ToolLoopAgent } from 'ai'
  * import { bedrock } from '@ai-sdk/amazon-bedrock'
  *

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

@@ -14,7 +14,7 @@ import { createExecuteCommandTool } from './execute-command-tool.js';
  *
  * @example
  * ```typescript
- * import { CodeInterpreterTools } from '@bedrock-agentcore/sdk/code-interpreter/vercel-ai'
+ * import { CodeInterpreterTools } from 'bedrock-agentcore/code-interpreter/vercel-ai'
  * import { ToolLoopAgent } from 'ai'
  * import { bedrock } from '@ai-sdk/amazon-bedrock'
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bedrock-agentcore",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "TypeScript SDK for AWS Bedrock AgentCore",
   "main": "dist/src/index.js",
   "module": "dist/src/index.js",
@@ -26,6 +26,10 @@
       "import": "./dist/src/tools/browser/integrations/vercel-ai/index.js",
       "types": "./dist/src/tools/browser/integrations/vercel-ai/index.d.ts"
     },
+    "./experimental/browser/strands": {
+      "import": "./dist/src/tools/browser/integrations/strands/index.js",
+      "types": "./dist/src/tools/browser/integrations/strands/index.d.ts"
+    },
     "./code-interpreter": {
       "import": "./dist/src/tools/code-interpreter/index.js",
       "types": "./dist/src/tools/code-interpreter/index.d.ts"
@@ -33,22 +37,37 @@
     "./code-interpreter/vercel-ai": {
       "import": "./dist/src/tools/code-interpreter/integrations/vercel-ai/index.js",
       "types": "./dist/src/tools/code-interpreter/integrations/vercel-ai/index.d.ts"
+    },
+    "./experimental/code-interpreter/strands": {
+      "import": "./dist/src/tools/code-interpreter/integrations/strands/index.js",
+      "types": "./dist/src/tools/code-interpreter/integrations/strands/index.d.ts"
+    },
+    "./runtime": {
+      "import": "./dist/src/runtime/index.js",
+      "types": "./dist/src/runtime/index.d.ts"
+    },
+    "./identity": {
+      "import": "./dist/src/identity/index.js",
+      "types": "./dist/src/identity/index.d.ts"
     }
   },
   "scripts": {
     "build": "tsc",
-    "check": "npm run lint && npm run format && npm run type-check && npm run test:coverage",
+    "check": "npm run lint && npm run format && npm run type-check:all && npm run test:coverage",
     "clean": "rm -rf node_modules dist package-lock.json",
     "test": "vitest run --project unit-node",
+    "test:all": "vitest run --project unit-node && vitest run --project integ",
+    "ci": "npm run lint && npm run format:check && npm run type-check:all && npm run build && npm run test:all",
     "test:watch": "vitest --project unit-node",
     "test:coverage": "vitest run --coverage --project unit-node",
-    "test:types": "vitest run --project types",
     "test:integ": "vitest run --project integ",
-    "lint": "eslint src examples",
-    "lint:fix": "eslint src examples --fix",
-    "format": "prettier --write src examples",
-    "format:check": "prettier --check src examples",
+    "lint": "eslint src tests_integ",
+    "lint:fix": "eslint src tests_integ --fix",
+    "format": "prettier --write src tests_integ",
+    "format:check": "prettier --check src tests_integ",
     "type-check": "tsc --noEmit",
+    "type-check:tests": "tsc --noEmit -p tsconfig.test.json",
+    "type-check:all": "npm run type-check && npm run type-check:tests",
     "type-check:watch": "tsc --noEmit --watch",
     "prepare": "npm run build && husky || true"
   },
@@ -65,7 +84,11 @@
   "license": "Apache-2.0",
   "devDependencies": {
     "@ai-sdk/amazon-bedrock": "^4.0.0-beta.67",
-    "@types/node": "^24.6.0",
+    "@aws-sdk/client-cognito-identity-provider": "^3.957.0",
+    "@strands-agents/sdk": "^0.1.4",
+    "@types/express": "^4.17.0",
+    "@types/node": "^24.10.4",
+    "@types/supertest": "^6.0.3",
     "@typescript-eslint/eslint-plugin": "^8.48.0",
     "@typescript-eslint/parser": "^8.0.0",
     "@vitest/coverage-v8": "^4.0.13",
@@ -74,8 +97,9 @@
     "eslint-plugin-tsdoc": "^0.5.0",
     "husky": "^9.1.7",
     "playwright": "^1.56.1",
-    "tsx": "^4.19.4",
     "prettier": "^3.0.0",
+    "supertest": "^7.1.4",
+    "tsx": "^4.19.4",
     "typescript": "^5.5.0",
     "vitest": "^4.0.8"
   },
@@ -92,15 +116,23 @@
   "homepage": "https://github.com/aws/bedrock-agentcore-sdk-typescript#readme",
   "dependencies": {
     "@aws-crypto/sha256-js": "^5.2.0",
-    "@aws-sdk/client-bedrock-agent-runtime": "^3.939.0",
-    "@aws-sdk/client-bedrock-agentcore": "^3.939.0",
+    "@aws-sdk/client-bedrock-agentcore": "^3.948.0",
+    "@aws-sdk/client-bedrock-agentcore-control": "^3.948.0",
     "@aws-sdk/credential-providers": "^3.939.0",
+    "@aws-sdk/protocol-http": "^3.370.0",
+    "@aws-sdk/signature-v4": "^3.370.0",
+    "@fastify/sse": "^0.4.0",
+    "@fastify/websocket": "^11.0.1",
     "@smithy/protocol-http": "^5.3.5",
     "@smithy/signature-v4": "^5.3.5",
     "@smithy/util-utf8": "^4.2.0",
+    "@types/ws": "^8.18.1",
+    "fastify": "^5.7.1",
+    "ws": "^8.18.3",
     "zod": "^4.1.13"
   },
   "peerDependencies": {
+    "@strands-agents/sdk": ">=0.1.0",
     "ai": ">=6.0.0-beta",
     "playwright": ">=1.56.0"
   },
@@ -110,6 +142,9 @@
     },
     "playwright": {
       "optional": true
+    },
+    "@strands-agents/sdk": {
+      "optional": true
     }
   }
 }