@mastra/e2b 0.9.0 → 0.10.0-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @mastra/e2b
 
+## 0.10.0-alpha.0
+
+### Minor Changes
+
+- Added a `lifecycle` option to `E2BSandbox` so you can choose what happens when a sandbox times out. Sandboxes still pause by default and resume on next use; pass `{ onTimeout: 'kill' }` to destroy idle sandboxes instead, which suits workspaces whose data is stored outside the sandbox. ([#22120](https://github.com/mastra-ai/mastra/pull/22120))
+
+### Patch Changes
+
+- Updated dependencies [[`2c85f42`](https://github.com/mastra-ai/mastra/commit/2c85f428e04ccd63ea31a7ec80b5b327afdad555), [`11bbeb9`](https://github.com/mastra-ai/mastra/commit/11bbeb9b108ef2264e05acefc6dafb9cbb342921), [`1a485f3`](https://github.com/mastra-ai/mastra/commit/1a485f3538f5ec64d58bd8b5e1e99de0c695c87b), [`0d37487`](https://github.com/mastra-ai/mastra/commit/0d37487d9f349388a3f1cef6a536cf9dcc4b6273), [`8661d7d`](https://github.com/mastra-ai/mastra/commit/8661d7d7179f0a024456aabdd8679bcecd09ac28), [`575e343`](https://github.com/mastra-ai/mastra/commit/575e343900451021d96110916497d334af7bc252), [`cacb839`](https://github.com/mastra-ai/mastra/commit/cacb8392d9e74189b56d857290b0615f98a2683d), [`b47b26e`](https://github.com/mastra-ai/mastra/commit/b47b26e6fe95cb8a3482be2c5e52de157fe59d0b), [`0d37487`](https://github.com/mastra-ai/mastra/commit/0d37487d9f349388a3f1cef6a536cf9dcc4b6273), [`c46eb09`](https://github.com/mastra-ai/mastra/commit/c46eb09ce4987509af57a0ac582c61241a6dd2f1), [`30ed33e`](https://github.com/mastra-ai/mastra/commit/30ed33ee14084a26019aba15fceadda6d6ddefaf), [`91ad69d`](https://github.com/mastra-ai/mastra/commit/91ad69d64994c89199b0c55399e64ed91c61df2f), [`8dc408d`](https://github.com/mastra-ai/mastra/commit/8dc408d34438f9e13297f792c11a5cfd6cf952e1), [`c92def1`](https://github.com/mastra-ai/mastra/commit/c92def10a13c822972c96f0a4ca6ffc1f4258aed), [`c5eaec5`](https://github.com/mastra-ai/mastra/commit/c5eaec5a860d80d0e3805e67db0414b87ac8cbed), [`e66b2ba`](https://github.com/mastra-ai/mastra/commit/e66b2ba100db63eaeab6e21e1ea34b113f2ec781)]:
+  - @mastra/core@1.62.0-alpha.3
+
 ## 0.9.0
 
 ### Minor Changes

package/README.md

@@ -29,6 +29,19 @@ const agent = new Agent({
 });
 ```
 
+### Timeout Lifecycle
+
+When a sandbox reaches its `timeout`, it is paused by default: the whole VM is snapshotted and the next `start()` reconnects and resumes it. For stateless workspaces whose data lives outside the sandbox (for example mounted from S3), you can have idle sandboxes destroyed instead and recreated on next use:
+
+```typescript
+const sandbox = new E2BSandbox({
+  timeout: 60_000,
+  lifecycle: { onTimeout: 'kill' }, // default: { onTimeout: 'pause' }
+});
+```
+
+Calling `stop()` explicitly always pauses the sandbox, regardless of this setting.
+
 ### Mounting Cloud Storage
 
 E2B sandboxes can mount S3, GCS, or Azure Blob filesystems, making cloud storage accessible as a local directory inside the sandbox:

package/dist/index.cjs

@@ -652,6 +652,7 @@ var E2BSandbox = class E2BSandbox extends _mastra_core_workspace.MastraSandbox {
 	env;
 	metadata;
 	network;
+	lifecycle;
 	connectionOpts;
 	_instructionsOverride;
 	_constructorOptions;
@@ -671,6 +672,7 @@ var E2BSandbox = class E2BSandbox extends _mastra_core_workspace.MastraSandbox {
 		this.env = options.env ?? {};
 		this.metadata = options.metadata ?? {};
 		this.network = options.network;
+		this.lifecycle = options.lifecycle ?? { onTimeout: "pause" };
 		this.connectionOpts = {
 			...options.domain && { domain: options.domain },
 			...options.apiUrl && { apiUrl: options.apiUrl },
@@ -760,7 +762,7 @@ var E2BSandbox = class E2BSandbox extends _mastra_core_workspace.MastraSandbox {
 		try {
 			this._sandbox = await e2b.Sandbox.create(resolvedTemplateId, {
 				...this.connectionOpts,
-				lifecycle: { onTimeout: "pause" },
+				lifecycle: this.lifecycle,
 				metadata: {
 					...this.metadata,
 					"mastra-sandbox-id": this.id
@@ -777,7 +779,7 @@ var E2BSandbox = class E2BSandbox extends _mastra_core_workspace.MastraSandbox {
 				this.logger.debug(`${LOG_PREFIX} Retrying sandbox creation with rebuilt template: ${rebuiltTemplateId}`);
 				this._sandbox = await e2b.Sandbox.create(rebuiltTemplateId, {
 					...this.connectionOpts,
-					lifecycle: { onTimeout: "pause" },
+					lifecycle: this.lifecycle,
 					metadata: {
 						...this.metadata,
 						"mastra-sandbox-id": this.id