@mastra/e2b-desktop 0.0.0

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# @mastra/e2b-desktop
+
+## 0.1.0-alpha.0
+
+### Minor Changes
+
+- Added `@mastra/e2b-desktop`, a computer-use sandbox provider backed by E2B Desktop. It combines E2B command, process, file, and reconnection support with screenshot, mouse, keyboard, screen information, and authenticated noVNC tools. ([#21707](https://github.com/mastra-ai/mastra/pull/21707))
+
+  ```typescript
+  const sandbox = new E2BDesktopSandbox({ resolution: [1280, 720] });
+  const workspace = new Workspace({ sandbox });
+  ```
+
+  The provider also exports the underlying desktop SDK through `sandbox.desktop` for desktop-specific operations.
+
+### Patch Changes
+
+- Updated dependencies [[`5c2b379`](https://github.com/mastra-ai/mastra/commit/5c2b37916a045b578cc5f4321d99a16fda9117c6)]:
+  - @mastra/e2b@0.10.0-alpha.5

package/README.md

@@ -0,0 +1,71 @@
+# @mastra/e2b-desktop
+
+E2B Desktop (computer-use) sandbox provider for Mastra workspaces.
+
+Runs a full Linux desktop environment in an [E2B](https://e2b.dev) cloud sandbox with screenshot, mouse, and keyboard control. Extends [`@mastra/e2b`](../e2b)'s `E2BSandbox` the same way [`@e2b/desktop`](https://github.com/e2b-dev/desktop)'s SDK extends `e2b`'s — everything the base provider supports (command execution, processes, file upload, pause/resume reconnection) works against the same desktop VM.
+
+## Installation
+
+```bash
+npm install @mastra/e2b-desktop
+```
+
+Requires an E2B API key (`E2B_API_KEY` env var or the `apiKey` option).
+
+## Usage
+
+```typescript
+import { Agent } from '@mastra/core/agent';
+import { Workspace } from '@mastra/core/workspace';
+import { E2BDesktopSandbox } from '@mastra/e2b-desktop';
+
+const sandbox = new E2BDesktopSandbox({ resolution: [1280, 720] });
+
+const agent = new Agent({
+  name: 'desktop-agent',
+  instructions: 'You can control a Linux desktop and run shell commands.',
+  model: 'anthropic/claude-sonnet-4-6',
+  // file + shell + computer tools are all emitted automatically
+  workspace: new Workspace({ sandbox }),
+});
+```
+
+With a `Workspace`, agents automatically get the `mastra_workspace_computer_*` tools (screenshot, click, type, press key, scroll, drag, …) alongside the shell and process tools.
+
+### Direct desktop control
+
+```typescript
+const sandbox = new E2BDesktopSandbox();
+await sandbox.start();
+
+await sandbox.computer.leftClick(100, 200);
+await sandbox.computer.type('hello');
+const { data } = await sandbox.computer.screenshot(); // PNG bytes
+
+// Live desktop view (authenticated noVNC URL)
+const viewerUrl = await sandbox.computer.streamUrl();
+```
+
+### Raw SDK escape hatch
+
+Desktop-only APIs (`launch`, `open`, window helpers, custom stream control) are available on the underlying `@e2b/desktop` sandbox:
+
+```typescript
+await sandbox.desktop.launch('xfce4-terminal');
+await sandbox.desktop.open('https://mastra.ai');
+```
+
+## Options
+
+All [`E2BSandboxOptions`](../e2b) plus:
+
+| Option       | Type               | Description                                       |
+| ------------ | ------------------ | ------------------------------------------------- |
+| `resolution` | `[number, number]` | Desktop resolution in pixels (new sandboxes only) |
+| `dpi`        | `number`           | Desktop display DPI (new sandboxes only)          |
+
+When no `template` is provided, the E2B-hosted `desktop` template is used. Note: the desktop template has no FUSE tooling, so cloud filesystem mounting requires a custom desktop template with `s3fs`/`gcsfuse` installed.
+
+## License
+
+Apache-2.0

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@mastra/e2b-desktop",
+  "version": "0.0.0",
+  "description": "E2B Desktop (computer-use) 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": "tsdown --silent --config tsdown.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": "oxlint . && eslint .",
+    "lint:fix": "oxlint --fix . && eslint --fix ."
+  },
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@e2b/desktop": "^2.3.1",
+    "@mastra/e2b": "workspace:^",
+    "e2b": "^2.36.0"
+  },
+  "devDependencies": {
+    "@internal/lint": "workspace:*",
+    "@internal/types-builder": "workspace:*",
+    "@internal/workspace-test-utils": "workspace:*",
+    "@mastra/core": "workspace:*",
+    "@types/node": "22.20.1",
+    "@vitest/coverage-v8": "catalog:",
+    "@vitest/ui": "catalog:",
+    "dotenv": "^17.4.2",
+    "eslint": "^10.7.0",
+    "tsdown": "0.22.9",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
+  },
+  "peerDependencies": {
+    "@mastra/core": ">=1.60.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/e2b-desktop"
+  },
+  "bugs": {
+    "url": "https://github.com/mastra-ai/mastra/issues"
+  },
+  "engines": {
+    "node": ">=22.13.0"
+  }
+}