@mastra/e2b 0.0.3-alpha.0 → 0.1.0-alpha.0

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 (12) hide show
  1. package/CHANGELOG.md +130 -0
  2. package/dist/index.cjs +358 -290
  3. package/dist/index.cjs.map +1 -1
  4. package/dist/index.d.ts +1 -0
  5. package/dist/index.d.ts.map +1 -1
  6. package/dist/index.js +359 -292
  7. package/dist/index.js.map +1 -1
  8. package/dist/sandbox/index.d.ts +81 -66
  9. package/dist/sandbox/index.d.ts.map +1 -1
  10. package/dist/sandbox/process-manager.d.ts +28 -0
  11. package/dist/sandbox/process-manager.d.ts.map +1 -0
  12. package/package.json +11 -11
package/CHANGELOG.md CHANGED
@@ -1,5 +1,135 @@
1
1
  # @mastra/e2b
2
2
 
3
+ ## 0.1.0-alpha.0
4
+
5
+ ### Minor Changes
6
+
7
+ - Fixed `getInstructions()` to report sandbox-level facts only (working directory, provider type) instead of counting all mount entries regardless of state. Added `instructions` option to `E2BSandbox` to override or extend default instructions. ([#13304](https://github.com/mastra-ai/mastra/pull/13304))
8
+
9
+ - Added `E2BProcessManager` for background process management in E2B cloud sandboxes. ([#13293](https://github.com/mastra-ai/mastra/pull/13293))
10
+
11
+ Wraps E2B SDK's `commands.run()` with `background: true` and `commands.connect()` for reconnection. Processes spawned in E2B sandboxes are automatically cleaned up on `stop()` and `destroy()`.
12
+
13
+ Bumps `@mastra/core` peer dependency to `>=1.7.0-0` (requires `SandboxProcessManager` from core).
14
+
15
+ ### Patch Changes
16
+
17
+ - Updated dependencies [[`24284ff`](https://github.com/mastra-ai/mastra/commit/24284ffae306ddf0ab83273e13f033520839ef40), [`f5097cc`](https://github.com/mastra-ai/mastra/commit/f5097cc8a813c82c3378882c31178320cadeb655), [`71e237f`](https://github.com/mastra-ai/mastra/commit/71e237fa852a3ad9a50a3ddb3b5f3b20b9a8181c), [`13a291e`](https://github.com/mastra-ai/mastra/commit/13a291ebb9f9bca80befa0d9166b916bb348e8e9), [`397af5a`](https://github.com/mastra-ai/mastra/commit/397af5a69f34d4157f51a7c8da3f1ded1e1d611c), [`d4701f7`](https://github.com/mastra-ai/mastra/commit/d4701f7e24822b081b70f9c806c39411b1a712e7), [`2b40831`](https://github.com/mastra-ai/mastra/commit/2b40831dcca2275c9570ddf09b7f25ba3e8dc7fc), [`6184727`](https://github.com/mastra-ai/mastra/commit/6184727e812bf7a65cee209bacec3a2f5a16e923), [`6f6385b`](https://github.com/mastra-ai/mastra/commit/6f6385be5b33687cd21e71fc27e972e6928bb34c), [`14aba61`](https://github.com/mastra-ai/mastra/commit/14aba61b9cff76d72bc7ef6f3a83ae2c5d059193), [`dd9dd1c`](https://github.com/mastra-ai/mastra/commit/dd9dd1c9ae32ae79093f8c4adde1732ac6357233)]:
18
+ - @mastra/core@1.7.0-alpha.0
19
+
20
+ ## 0.0.3
21
+
22
+ ### Patch Changes
23
+
24
+ - Removed unused SandboxRuntime type, runtimes option, supportedRuntimes/defaultRuntime getters, and getMounts() method. These were defined but never used for any actual behavior. ([#13053](https://github.com/mastra-ai/mastra/pull/13053))
25
+
26
+ - Added editor provider descriptors for workspace filesystem, sandbox, and blob store packages. Each provider exports an object with `id`, `name`, `description`, `configSchema` (JSON Schema), and a factory method, enabling the editor UI to auto-discover and render configuration forms for workspace providers. ([#13156](https://github.com/mastra-ai/mastra/pull/13156))
27
+ - `@mastra/gcs`: Added `gcsFilesystemProvider` with config schema for bucket, projectId, credentials, prefix, readOnly, and endpoint
28
+ - `@mastra/e2b`: Added `e2bSandboxProvider` with config schema for template, timeout, env, metadata, runtimes, domain, and API settings
29
+
30
+ ```ts
31
+ import { gcsFilesystemProvider } from '@mastra/gcs';
32
+ import { e2bSandboxProvider } from '@mastra/e2b';
33
+
34
+ const editor = new MastraEditor({
35
+ filesystems: {
36
+ gcs: gcsFilesystemProvider,
37
+ },
38
+ sandboxes: {
39
+ e2b: e2bSandboxProvider,
40
+ },
41
+ });
42
+
43
+ // Enumerate available providers and their config schemas for UI rendering
44
+ const fsProviders = editor.getFilesystemProviders();
45
+ const sbProviders = editor.getSandboxProviders();
46
+ ```
47
+
48
+ - Added workspace and skill storage domains with full CRUD, versioning, and implementations across LibSQL, Postgres, and MongoDB. Added `editor.workspace` and `editor.skill` namespaces for managing workspace configurations and skill definitions through the editor. Agents stored in the editor can now reference workspaces (by ID or inline config) and skills, with full hydration to runtime `Workspace` instances during agent resolution. ([#13156](https://github.com/mastra-ai/mastra/pull/13156))
49
+
50
+ **Filesystem-native skill versioning (draft → publish model):**
51
+
52
+ Skills are versioned as filesystem trees with content-addressable blob storage. The editing surface (live filesystem) is separated from the serving surface (versioned blob store), enabling a `draft → publish` workflow:
53
+ - `editor.skill.publish(skillId, source, skillPath)` — Snapshots a skill directory from the filesystem into blob storage, creates a new version with a tree manifest, and sets `activeVersionId`
54
+ - Version switching via `editor.skill.update({ id, activeVersionId })` — Points the skill to a previous version without re-publishing
55
+ - Publishing a skill automatically invalidates cached agents that reference it, so they re-hydrate with the updated version on next access
56
+
57
+ **Agent skill resolution strategies:**
58
+
59
+ Agents can reference skills with different resolution strategies:
60
+ - `strategy: 'latest'` — Resolves the skill's active version (honors `activeVersionId` for rollback)
61
+ - `pin: '<versionId>'` — Pins to a specific version, immune to publishes
62
+ - `strategy: 'live'` — Reads directly from the live filesystem (no blob store)
63
+
64
+ **Blob storage infrastructure:**
65
+ - `BlobStore` abstract class for content-addressable storage keyed by SHA-256 hash
66
+ - `InMemoryBlobStore` for testing
67
+ - LibSQL, Postgres, and MongoDB implementations
68
+ - `S3BlobStore` for storing blobs in S3 or S3-compatible storage (AWS, R2, MinIO, DO Spaces)
69
+ - `BlobStoreProvider` interface and `MastraEditorConfig.blobStores` registry for pluggable blob storage
70
+ - `VersionedSkillSource` and `CompositeVersionedSkillSource` for reading skill files from the blob store at runtime
71
+
72
+ **New storage types:**
73
+ - `StorageWorkspaceSnapshotType` and `StorageSkillSnapshotType` with corresponding input/output types
74
+ - `StorageWorkspaceRef` for ID-based or inline workspace references on agents
75
+ - `StorageSkillConfig` for per-agent skill overrides (`pin`, `strategy`, description, instructions)
76
+ - `SkillVersionTree` and `SkillVersionTreeEntry` for tree manifests
77
+ - `StorageBlobEntry` for content-addressable blob entries
78
+ - `SKILL_BLOBS_SCHEMA` for the `mastra_skill_blobs` table
79
+
80
+ **New editor namespaces:**
81
+ - `editor.workspace` — CRUD for workspace configs, plus `hydrateSnapshotToWorkspace()` for resolving to runtime `Workspace` instances
82
+ - `editor.skill` — CRUD for skill definitions, plus `publish()` for filesystem-to-blob snapshots
83
+
84
+ **Provider registries:**
85
+ - `MastraEditorConfig` accepts `filesystems`, `sandboxes`, and `blobStores` provider registries (keyed by provider ID)
86
+ - Built-in `local` filesystem and sandbox providers are auto-registered
87
+ - `editor.resolveBlobStore()` resolves from provider registry or falls back to the storage backend's blobs domain
88
+ - Providers expose `id`, `name`, `description`, `configSchema` (JSON Schema for UI form rendering), and a factory method
89
+
90
+ **Storage adapter support:**
91
+ - LibSQL: Full `workspaces`, `skills`, and `blobs` domain implementations
92
+ - Postgres: Full `workspaces`, `skills`, and `blobs` domain implementations
93
+ - MongoDB: Full `workspaces`, `skills`, and `blobs` domain implementations
94
+ - All three include `workspace`, `skills`, and `skillsFormat` fields on agent versions
95
+
96
+ **Server endpoints:**
97
+ - `GET/POST/PATCH/DELETE /stored/workspaces` — CRUD for stored workspaces
98
+ - `GET/POST/PATCH/DELETE /stored/skills` — CRUD for stored skills
99
+ - `POST /stored/skills/:id/publish` — Publish a skill from a filesystem source
100
+
101
+ ```ts
102
+ import { MastraEditor } from '@mastra/editor';
103
+ import { s3FilesystemProvider, s3BlobStoreProvider } from '@mastra/s3';
104
+ import { e2bSandboxProvider } from '@mastra/e2b';
105
+
106
+ const editor = new MastraEditor({
107
+ filesystems: { s3: s3FilesystemProvider },
108
+ sandboxes: { e2b: e2bSandboxProvider },
109
+ blobStores: { s3: s3BlobStoreProvider },
110
+ });
111
+
112
+ // Create a skill and publish it
113
+ const skill = await editor.skill.create({
114
+ name: 'Code Review',
115
+ description: 'Reviews code for best practices',
116
+ instructions: 'Analyze the code and provide feedback...',
117
+ });
118
+ await editor.skill.publish(skill.id, source, 'skills/code-review');
119
+
120
+ // Agents resolve skills by strategy
121
+ await editor.agent.create({
122
+ name: 'Dev Assistant',
123
+ model: { provider: 'openai', name: 'gpt-4' },
124
+ workspace: { type: 'id', workspaceId: workspace.id },
125
+ skills: { [skill.id]: { strategy: 'latest' } },
126
+ skillsFormat: 'xml',
127
+ });
128
+ ```
129
+
130
+ - Updated dependencies [[`252580a`](https://github.com/mastra-ai/mastra/commit/252580a71feb0e46d0ccab04a70a79ff6a2ee0ab), [`f8e819f`](https://github.com/mastra-ai/mastra/commit/f8e819fabdfdc43d2da546a3ad81ba23685f603d), [`5c75261`](https://github.com/mastra-ai/mastra/commit/5c7526120d936757d4ffb7b82232e1641ebd45cb), [`e27d832`](https://github.com/mastra-ai/mastra/commit/e27d83281b5e166fd63a13969689e928d8605944), [`e37ef84`](https://github.com/mastra-ai/mastra/commit/e37ef8404043c94ca0c8e35ecdedb093b8087878), [`6fdd3d4`](https://github.com/mastra-ai/mastra/commit/6fdd3d451a07a8e7e216c62ac364f8dd8e36c2af), [`10cf521`](https://github.com/mastra-ai/mastra/commit/10cf52183344743a0d7babe24cd24fd78870c354), [`efdb682`](https://github.com/mastra-ai/mastra/commit/efdb682887f6522149769383908f9790c188ab88), [`0dee7a0`](https://github.com/mastra-ai/mastra/commit/0dee7a0ff4c2507e6eb6e6ee5f9738877ebd4ad1), [`04c2c8e`](https://github.com/mastra-ai/mastra/commit/04c2c8e888984364194131aecb490a3d6e920e61), [`02dc07a`](https://github.com/mastra-ai/mastra/commit/02dc07acc4ad42d93335825e3308f5b42266eba2), [`bb7262b`](https://github.com/mastra-ai/mastra/commit/bb7262b7c0ca76320d985b40510b6ffbbb936582), [`cf1c6e7`](https://github.com/mastra-ai/mastra/commit/cf1c6e789b131f55638fed52183a89d5078b4876), [`5ffadfe`](https://github.com/mastra-ai/mastra/commit/5ffadfefb1468ac2612b20bb84d24c39de6961c0), [`1e1339c`](https://github.com/mastra-ai/mastra/commit/1e1339cc276e571a48cfff5014487877086bfe68), [`d03df73`](https://github.com/mastra-ai/mastra/commit/d03df73f8fe9496064a33e1c3b74ba0479bf9ee6), [`79b8f45`](https://github.com/mastra-ai/mastra/commit/79b8f45a6767e1a5c3d56cd3c5b1214326b81661), [`9bbf08e`](https://github.com/mastra-ai/mastra/commit/9bbf08e3c20731c79dea13a765895b9fcf29cbf1), [`0a25952`](https://github.com/mastra-ai/mastra/commit/0a259526b5e1ac11e6efa53db1f140272962af2d), [`ffa5468`](https://github.com/mastra-ai/mastra/commit/ffa546857fc4821753979b3a34e13b4d76fbbcd4), [`3264a04`](https://github.com/mastra-ai/mastra/commit/3264a04e30340c3c5447433300a035ea0878df85), [`6fdd3d4`](https://github.com/mastra-ai/mastra/commit/6fdd3d451a07a8e7e216c62ac364f8dd8e36c2af), [`088d9ba`](https://github.com/mastra-ai/mastra/commit/088d9ba2577518703c52b0dccd617178d9ee6b0d), [`74fbebd`](https://github.com/mastra-ai/mastra/commit/74fbebd918a03832a2864965a8bea59bf617d3a2), [`aea6217`](https://github.com/mastra-ai/mastra/commit/aea621790bfb2291431b08da0cc5e6e150303ae7), [`b6a855e`](https://github.com/mastra-ai/mastra/commit/b6a855edc056e088279075506442ba1d6fa6def9), [`ae408ea`](https://github.com/mastra-ai/mastra/commit/ae408ea7128f0d2710b78d8623185198e7cb19c1), [`17e942e`](https://github.com/mastra-ai/mastra/commit/17e942eee2ba44985b1f807e6208cdde672f82f9), [`2015cf9`](https://github.com/mastra-ai/mastra/commit/2015cf921649f44c3f5bcd32a2c052335f8e49b4), [`7ef454e`](https://github.com/mastra-ai/mastra/commit/7ef454eaf9dcec6de60021c8f42192052dd490d6), [`2be1d99`](https://github.com/mastra-ai/mastra/commit/2be1d99564ce79acc4846071082bff353035a87a), [`2708fa1`](https://github.com/mastra-ai/mastra/commit/2708fa1055ac91c03e08b598869f6b8fb51fa37f), [`ba74aef`](https://github.com/mastra-ai/mastra/commit/ba74aef5716142dbbe931351f5243c9c6e4128a9), [`ba74aef`](https://github.com/mastra-ai/mastra/commit/ba74aef5716142dbbe931351f5243c9c6e4128a9), [`ec53e89`](https://github.com/mastra-ai/mastra/commit/ec53e8939c76c638991e21af762e51378eff7543), [`9b5a8cb`](https://github.com/mastra-ai/mastra/commit/9b5a8cb13e120811b0bf14140ada314f1c067894), [`607e66b`](https://github.com/mastra-ai/mastra/commit/607e66b02dc7f531ee37799f3456aa2dc0ca7ac5), [`a215d06`](https://github.com/mastra-ai/mastra/commit/a215d06758dcf590eabfe0b7afd4ae39bdbf082c), [`6909c74`](https://github.com/mastra-ai/mastra/commit/6909c74a7781e0447d475e9dbc1dc871b700f426), [`192438f`](https://github.com/mastra-ai/mastra/commit/192438f8a90c4f375e955f8ff179bf8dc6821a83)]:
131
+ - @mastra/core@1.5.0
132
+
3
133
  ## 0.0.3-alpha.0
4
134
 
5
135
  ### Patch Changes