@mastra/agentcore 0.0.0

package/CHANGELOG.md

@@ -0,0 +1 @@
+# @mastra/agentcore

package/README.md

@@ -0,0 +1,35 @@
+# @mastra/agentcore
+
+AWS Bedrock AgentCore Runtime sandbox provider for Mastra workspaces.
+
+## Installation
+
+```bash
+npm install @mastra/agentcore
+```
+
+## Usage
+
+```typescript
+import { Workspace } from '@mastra/core/workspace';
+import { AgentCoreRuntimeSandbox } from '@mastra/agentcore';
+
+const workspace = new Workspace({
+  sandbox: new AgentCoreRuntimeSandbox({
+    region: 'us-west-2',
+    agentRuntimeArn: process.env.AGENTCORE_RUNTIME_ARN!,
+    runtimeSessionId: '12345678-1234-1234-1234-123456789012',
+  }),
+});
+
+const result = await workspace.sandbox?.executeCommand?.('npm', ['test'], {
+  cwd: '/workspace',
+  timeout: 300_000,
+});
+```
+
+`AgentCoreRuntimeSandbox` uses `InvokeAgentRuntimeCommand` to run one-shot shell commands inside an existing AgentCore Runtime session. It does not provide background process management or filesystem mounts.
+
+By default, `destroy()` does not stop the AgentCore Runtime session because sessions can be shared with other AgentCore invocations. Call `stopRuntimeSession()` explicitly, or set `stopSessionOnLifecycle: true`, when the sandbox owns the session and should clean it up.
+
+AgentCore Code Interpreter is a separate AgentCore service and is not part of this runtime sandbox provider.

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@mastra/agentcore",
+  "version": "0.0.0",
+  "description": "AWS Bedrock AgentCore Runtime sandbox provider for Mastra workspaces",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsup --silent --config tsup.config.ts",
+    "build:lib": "pnpm build",
+    "build:watch": "pnpm build --watch",
+    "test:unit": "vitest run --exclude '**/*.integration.test.ts'",
+    "test:watch": "vitest watch",
+    "test": "vitest run ./src/**/*.integration.test.ts",
+    "test:cloud": "pnpm test",
+    "lint": "eslint ."
+  },
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@aws-sdk/client-bedrock-agentcore": "^3.1045.0"
+  },
+  "devDependencies": {
+    "@internal/lint": "workspace:*",
+    "@internal/types-builder": "workspace:*",
+    "@mastra/core": "workspace:*",
+    "@types/node": "22.19.15",
+    "@vitest/coverage-v8": "catalog:",
+    "@vitest/ui": "catalog:",
+    "dotenv": "^17.3.1",
+    "eslint": "^10.2.1",
+    "tsup": "^8.5.1",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
+  },
+  "peerDependencies": {
+    "@mastra/core": ">=1.12.0-0 <2.0.0-0"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "homepage": "https://mastra.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mastra-ai/mastra.git",
+    "directory": "workspaces/agentcore"
+  },
+  "bugs": {
+    "url": "https://github.com/mastra-ai/mastra/issues"
+  },
+  "engines": {
+    "node": ">=22.13.0"
+  }
+}