@mastra/e2b-desktop 0.1.1-alpha.1 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +7 -36
  2. package/package.json +6 -6
package/README.md CHANGED
@@ -10,8 +10,6 @@ Runs a full Linux desktop environment in an [E2B](https://e2b.dev) cloud sandbox
10
10
  npm install @mastra/e2b-desktop
11
11
  ```
12
12
 
13
- Requires an E2B API key (`E2B_API_KEY` env var or the `apiKey` option).
14
-
15
13
  ## Usage
16
14
 
17
15
  ```typescript
@@ -30,42 +28,15 @@ const agent = new Agent({
30
28
  });
31
29
  ```
32
30
 
33
- With a `Workspace`, agents automatically get the `mastra_workspace_computer_*` tools (screenshot, click, type, press key, scroll, drag, …) alongside the shell and process tools.
34
-
35
- ### Direct desktop control
36
-
37
- ```typescript
38
- const sandbox = new E2BDesktopSandbox();
39
- await sandbox.start();
40
-
41
- await sandbox.computer.leftClick(100, 200);
42
- await sandbox.computer.type('hello');
43
- const { data } = await sandbox.computer.screenshot(); // PNG bytes
44
-
45
- // Live desktop view (authenticated noVNC URL)
46
- const viewerUrl = await sandbox.computer.streamUrl();
47
- ```
48
-
49
- ### Raw SDK escape hatch
50
-
51
- Desktop-only APIs (`launch`, `open`, window helpers, custom stream control) are available on the underlying `@e2b/desktop` sandbox:
52
-
53
- ```typescript
54
- await sandbox.desktop.launch('xfce4-terminal');
55
- await sandbox.desktop.open('https://mastra.ai');
56
- ```
57
-
58
- ## Options
31
+ ## Documentation
59
32
 
60
- All [`E2BSandboxOptions`](../e2b) plus:
33
+ - [E2B Desktop integration guide](https://mastra.ai/integrations/sandboxes/e2b-desktop)
34
+ - [Workspace documentation](https://mastra.ai/docs/mastra-platform/workspaces)
61
35
 
62
- | Option | Type | Description |
63
- | ------------ | ------------------ | ------------------------------------------------- |
64
- | `resolution` | `[number, number]` | Desktop resolution in pixels (new sandboxes only) |
65
- | `dpi` | `number` | Desktop display DPI (new sandboxes only) |
36
+ ## Changelog
66
37
 
67
- 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.
38
+ See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/workspaces/e2b-desktop/CHANGELOG.md) for version history and release notes.
68
39
 
69
- ## License
40
+ ## Support
70
41
 
71
- Apache-2.0
42
+ We have an [open community Discord](https://discord.gg/mastra-ai). Come and say hello and let us know if you have any questions or need any help getting things running.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mastra/e2b-desktop",
3
- "version": "0.1.1-alpha.1",
3
+ "version": "0.1.1",
4
4
  "description": "E2B Desktop (computer-use) sandbox provider for Mastra workspaces",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -22,7 +22,7 @@
22
22
  "dependencies": {
23
23
  "@e2b/desktop": "^2.3.1",
24
24
  "e2b": "^2.36.0",
25
- "@mastra/e2b": "^0.11.0-alpha.1"
25
+ "@mastra/e2b": "^0.11.0"
26
26
  },
27
27
  "devDependencies": {
28
28
  "@types/node": "22.20.1",
@@ -33,10 +33,10 @@
33
33
  "tsdown": "0.22.9",
34
34
  "typescript": "^7.0.2",
35
35
  "vitest": "4.1.10",
36
- "@internal/types-builder": "0.0.104",
37
- "@internal/workspace-test-utils": "0.0.73",
38
- "@mastra/core": "1.64.0-alpha.2",
39
- "@internal/lint": "0.0.129"
36
+ "@internal/types-builder": "0.0.105",
37
+ "@internal/lint": "0.0.130",
38
+ "@mastra/core": "1.64.0",
39
+ "@internal/workspace-test-utils": "0.0.74"
40
40
  },
41
41
  "peerDependencies": {
42
42
  "@mastra/core": ">=1.60.0-0 <2.0.0-0"