@mastra/platform-workspace 1.3.0 → 1.4.0-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @mastra/platform
 
+## 1.4.0-alpha.0
+
+### Minor Changes
+
+- Added provider-selectable Platform Workspace routing through `SANDBOX_PROVIDER`, with direct E2B command execution and snapshot restore support. ([#21991](https://github.com/mastra-ai/mastra/pull/21991))
+
+  Set `SANDBOX_PROVIDER=e2b` before constructing `PlatformSandbox` or `PlatformFilesystem` to use provider-prefixed E2B routes. Set it to `railway` for provider-prefixed Railway routes, or leave it unset to preserve the legacy `/v1/projects/...` Railway API.
+
 ## 1.3.0
 
 ### Minor Changes

package/dist/client.d.ts

@@ -20,12 +20,15 @@ export interface PlatformClientOptions {
 export interface PlatformRequestOptions extends RequestInit {
     query?: Record<string, string | number | boolean | undefined>;
 }
+export type SandboxProvider = 'railway' | 'e2b';
 export declare function requireOption(value: string | undefined, name: string): string;
 export declare function resolvePlatformOptions(options: PlatformClientOptions): {
     accessToken: string;
     projectId: string;
     actingUserId: string | undefined;
     proxyUrl: string;
+    sandboxProvider: SandboxProvider;
+    useLegacyRoutes: boolean;
     sessionId: string | undefined;
     threadId: string | undefined;
     fetch: typeof fetch;
@@ -55,6 +58,8 @@ export declare class PlatformClient {
     readonly projectId: string;
     readonly actingUserId: string | undefined;
     readonly proxyUrl: string;
+    readonly sandboxProvider: SandboxProvider;
+    private readonly useLegacyRoutes;
     /** Advisory session correlation id — see {@link PlatformClientOptions.sessionId}. */
     readonly sessionId: string | undefined;
     /** Advisory thread correlation id — see {@link PlatformClientOptions.threadId}. */

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;CAC/D;AAWD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7E;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,qBAAqB;;;;;;;;EAUpE;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,gGAAgG;IAChG,IAAI,EAAE,MAAM,CAAC;CACd;AAkBD,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2HAA2H;IAC3H,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,yGAAyG;IACzG,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE9B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAUzC;AAED,qBAAa,cAAc;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qFAAqF;IACrF,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC;gBAEjB,OAAO,EAAE,qBAAqB;IAWpC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,QAAQ,CAAC;CA2BrF"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;CAC/D;AAED,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,KAAK,CAAC;AAWhD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7E;AAUD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,qBAAqB;;;;;;;;;;EAcpE;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,gGAAgG;IAChG,IAAI,EAAE,MAAM,CAAC;CACd;AAkBD,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2HAA2H;IAC3H,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,yGAAyG;IACzG,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE9B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAUzC;AAED,qBAAa,cAAc;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,qFAAqF;IACrF,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC;gBAEjB,OAAO,EAAE,qBAAqB;IAapC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,QAAQ,CAAC;CA4BrF"}

package/dist/direct-exec.d.ts

@@ -36,7 +36,7 @@ export interface DirectExecWebSocket {
  * (the package's minimum) and in the browser. Tests inject a fake here.
  */
 export type DirectExecWebSocketFactory = (endpoint: string, subprotocols: string[]) => DirectExecWebSocket;
-/** Lease payload returned by `POST /v1/projects/:projectId/sandbox/:sandboxId/exec-lease`. */
+/** Lease payload returned by `POST /v1/:provider/projects/:projectId/sandbox/:sandboxId/exec-lease`. */
 export interface ExecLease {
     jwt: string;
     wsEndpoint: string;

package/dist/direct-exec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"direct-exec.d.ts","sourceRoot":"","sources":["../src/direct-exec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAeH;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,GAAG,aAAa,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACpE,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,mBAAmB,CAAC;AAE3G,8FAA8F;AAC9F,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,uFAAuF;AACvF,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,0BAA0B,CAAC;CAC/C;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAcD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyJpG"}
+{"version":3,"file":"direct-exec.d.ts","sourceRoot":"","sources":["../src/direct-exec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAeH;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,GAAG,aAAa,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACpE,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,mBAAmB,CAAC;AAE3G,wGAAwG;AACxG,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,uFAAuF;AACvF,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,0BAA0B,CAAC;CAC/C;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAcD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyJpG"}

package/dist/e2b-exec.d.ts

@@ -0,0 +1,7 @@
+import type { DirectExecOptions, DirectExecResult, ExecLease } from './direct-exec.js';
+export interface E2BExecLease extends ExecLease {
+    sandboxId: string;
+}
+export type E2BExecRunner = (lease: E2BExecLease, options: DirectExecOptions) => Promise<DirectExecResult>;
+export declare const execViaE2BLease: E2BExecRunner;
+//# sourceMappingURL=e2b-exec.d.ts.map

package/dist/e2b-exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"e2b-exec.d.ts","sourceRoot":"","sources":["../src/e2b-exec.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIvF,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE3G,eAAO,MAAM,eAAe,EAAE,aAwD7B,CAAC"}

package/dist/index.cjs

@@ -25,6 +25,7 @@ let buffer = require("buffer");
 let path = require("path");
 path = __toESM(path, 1);
 let _mastra_core_workspace = require("@mastra/core/workspace");
+let e2b = require("e2b");
 //#region src/client.ts
 const DEFAULT_PROXY_URL = "https://workspaces.mastra.ai";
 /**
@@ -37,12 +38,20 @@ function requireOption(value, name) {
 	if (!value) throw new Error(`${name} is required`);
 	return value;
 }
+function resolveSandboxProvider(value) {
+	const provider = value?.trim() || "railway";
+	if (provider !== "railway" && provider !== "e2b") throw new Error("SANDBOX_PROVIDER must be either \"railway\" or \"e2b\"");
+	return provider;
+}
 function resolvePlatformOptions(options) {
+	const configuredSandboxProvider = process.env.SANDBOX_PROVIDER?.trim();
 	return {
 		accessToken: requireOption(options.accessToken ?? process.env.MASTRA_PLATFORM_ACCESS_TOKEN, "accessToken"),
 		projectId: requireOption(options.projectId ?? process.env.MASTRA_PROJECT_ID, "projectId"),
 		actingUserId: options.actingUserId?.trim() || void 0,
 		proxyUrl: (process.env.MASTRA_WORKSPACE_PROXY_URL ?? DEFAULT_PROXY_URL).replace(/\/$/, ""),
+		sandboxProvider: resolveSandboxProvider(configuredSandboxProvider),
+		useLegacyRoutes: !configuredSandboxProvider,
 		sessionId: options.sessionId,
 		threadId: options.threadId,
 		fetch: options.fetch ?? fetch
@@ -89,6 +98,8 @@ var PlatformClient = class {
 	projectId;
 	actingUserId;
 	proxyUrl;
+	sandboxProvider;
+	useLegacyRoutes;
 	/** Advisory session correlation id — see {@link PlatformClientOptions.sessionId}. */
 	sessionId;
 	/** Advisory thread correlation id — see {@link PlatformClientOptions.threadId}. */
@@ -100,12 +111,15 @@ var PlatformClient = class {
 		this.projectId = resolved.projectId;
 		this.actingUserId = resolved.actingUserId;
 		this.proxyUrl = resolved.proxyUrl;
+		this.sandboxProvider = resolved.sandboxProvider;
+		this.useLegacyRoutes = resolved.useLegacyRoutes;
 		this.sessionId = resolved.sessionId;
 		this.threadId = resolved.threadId;
 		this.fetch = resolved.fetch;
 	}
 	async request(path, options = {}) {
-		const url = new URL(`${this.proxyUrl}/v1/projects/${encodeURIComponent(this.projectId)}${path}`);
+		const providerPath = this.useLegacyRoutes ? "" : `/${this.sandboxProvider}`;
+		const url = new URL(`${this.proxyUrl}/v1${providerPath}/projects/${encodeURIComponent(this.projectId)}${path}`);
 		for (const [key, value] of Object.entries(options.query ?? {})) if (value !== void 0) url.searchParams.set(key, String(value));
 		const headers = new Headers(options.headers);
 		headers.set("authorization", `Bearer ${this.accessToken}`);
@@ -526,6 +540,62 @@ function execViaLease(lease, options) {
 	});
 }
 //#endregion
+//#region src/e2b-exec.ts
+const E2B_ENVD_VERSION = "0.4.0";
+const execViaE2BLease = async (lease, options) => {
+	const stdoutChunks = [];
+	const stderrChunks = [];
+	const onStdout = (data) => {
+		stdoutChunks.push(data);
+		options.onStdout?.(data);
+	};
+	const onStderr = (data) => {
+		stderrChunks.push(data);
+		options.onStderr?.(data);
+	};
+	try {
+		const result = await new e2b.Sandbox({
+			sandboxId: lease.sandboxId,
+			envdVersion: E2B_ENVD_VERSION,
+			envdAccessToken: lease.jwt,
+			sandboxUrl: lease.wsEndpoint,
+			validateApiKey: false
+		}).commands.run(options.command, {
+			cwd: options.cwd,
+			envs: options.env,
+			timeoutMs: options.timeoutMs,
+			onStdout,
+			onStderr
+		});
+		return {
+			exitCode: result.exitCode,
+			stdout: result.stdout,
+			stderr: result.stderr,
+			truncated: false,
+			timedOut: false,
+			opened: true
+		};
+	} catch (error) {
+		if (error instanceof e2b.CommandExitError) return {
+			exitCode: error.exitCode,
+			stdout: error.stdout,
+			stderr: error.stderr,
+			truncated: false,
+			timedOut: false,
+			opened: true
+		};
+		return {
+			exitCode: null,
+			stdout: stdoutChunks.join(""),
+			stderr: stderrChunks.join(""),
+			truncated: false,
+			timedOut: error instanceof e2b.TimeoutError,
+			closeReason: error instanceof Error ? error.message : String(error),
+			opened: true
+		};
+	}
+};
+//#endregion
 //#region src/private-net-exec.ts
 /**
 * Thrown by {@link execViaPrivateNetwork} when the sidecar returns a non-2xx
@@ -867,6 +937,7 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 	_instructionsOverride;
 	_createdAt = null;
 	_webSocketFactory;
+	_e2bExecRunner;
 	_privateNetFetch;
 	/**
 	* Registry that maps `sandboxId → instanceUrl` for the private-network
@@ -964,6 +1035,7 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 		this._timeout = options.timeout;
 		this._instructionsOverride = options.instructions;
 		this._webSocketFactory = options.webSocketFactory;
+		this._e2bExecRunner = options.e2bExecRunner ?? execViaE2BLease;
 		this._privateNetFetch = options.privateNetFetch;
 		this._addressRegistry = options.addressRegistry;
 	}
@@ -984,6 +1056,7 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 	*/
 	clone(options = {}) {
 		const id = options.id ?? options.checkpointName;
+		const seedCheckpointName = options.seedCheckpointName ?? (this._client.sandboxProvider === "e2b" ? options.checkpointName : void 0) ?? this._seedCheckpointName;
 		return new PlatformSandbox({
 			...id !== void 0 && { id },
 			accessToken: this._client.accessToken,
@@ -994,13 +1067,14 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 			fetch: this._client.fetch,
 			environmentId: this._environmentId,
 			...options.sandboxId !== void 0 && { sandboxId: options.sandboxId },
-			...(options.seedCheckpointName ?? this._seedCheckpointName) !== void 0 && { seedCheckpointName: options.seedCheckpointName ?? this._seedCheckpointName },
+			...seedCheckpointName !== void 0 && { seedCheckpointName },
 			idleTimeoutMinutes: options.idleTimeoutMinutes ?? this._idleTimeoutMinutes,
 			...this._networkIsolation !== void 0 && { networkIsolation: this._networkIsolation },
 			env: options.env ?? this._env,
 			...this._timeout !== void 0 && { timeout: this._timeout },
 			...this._instructionsOverride !== void 0 && { instructions: this._instructionsOverride },
 			...this._webSocketFactory !== void 0 && { webSocketFactory: this._webSocketFactory },
+			e2bExecRunner: this._e2bExecRunner,
 			...this._privateNetFetch !== void 0 && { privateNetFetch: this._privateNetFetch },
 			...this._addressRegistry !== void 0 && { addressRegistry: this._addressRegistry }
 		});
@@ -1201,7 +1275,7 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 	* it. Any in-flight capture is awaited first so the preserved checkpoint
 	* reflects the latest disk state we asked for.
 	*
-	* Corresponds to `DELETE /v1/projects/:pid/sandbox/:sandboxId` on
+	* Corresponds to `DELETE /v1/:provider/projects/:pid/sandbox/:sandboxId` on
 	* workspace-proxy, which by contract does not touch the checkpoint. Use
 	* {@link destroy} when you want the checkpoint released too.
 	*/
@@ -1222,15 +1296,15 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 	* transient proxy error must not leave the caller with a half-torn-down
 	* sandbox they can't safely retry.
 	*
-	* Requires the caller to have constructed with a recovery `id` (there is
-	* no checkpoint to delete otherwise); callers without one skip the
-	* checkpoint DELETE and behave identically to {@link stop}.
+	* Railway requires a caller-supplied recovery `id` before it can have a
+	* checkpoint to delete. E2B also permits capture with the automatic id, so
+	* destroy releases that named snapshot even when no recovery id was supplied.
 	*/
 	async destroy() {
 		if (!this._sandboxId) return;
 		const destroyedSandboxId = this._sandboxId;
 		this._captureInFlight = null;
-		if (this._hasRecoveryKey) try {
+		if (this._hasRecoveryKey || this._client.sandboxProvider === "e2b") try {
 			await this._client.request(`/sandbox/${encodeURIComponent(destroyedSandboxId)}/checkpoint`, {
 				method: "DELETE",
 				headers: { "content-type": "application/json" },
@@ -1313,7 +1387,7 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 	* to a skip as described above.
 	*/
 	async captureCheckpoint() {
-		if (!this._hasRecoveryKey) {
+		if (!this._hasRecoveryKey && this._client.sandboxProvider !== "e2b") {
 			this.logger.debug(`captureCheckpoint skipped: no recovery key configured for sandbox ${this._sandboxId ?? "(unstarted)"}`);
 			return {
 				status: "skipped",
@@ -1496,13 +1570,14 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 			}
 			lastLease = lease;
 			attemptsMade = attempt + 1;
-			const result = await execViaLease(lease, {
+			const execOptions = {
 				command: fullCommand,
 				...options?.cwd !== void 0 && { cwd: options.cwd },
 				...filteredEnv !== void 0 && { env: filteredEnv },
 				...effectiveTimeout != null && effectiveTimeout > 0 && { timeoutMs: effectiveTimeout },
 				...this._webSocketFactory && { webSocketFactory: this._webSocketFactory }
-			});
+			};
+			const result = lease.provider === "e2b" ? await this._e2bExecRunner(lease, execOptions) : await execViaLease(lease, execOptions);
 			lastResult = result;
 			if (result.exitCode !== null || result.timedOut) return result;
 		}
@@ -1585,6 +1660,9 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 			const json = await (await this._client.request(`/sandbox/${encodeURIComponent(sandboxId)}/exec-lease`, { method: "POST" })).json();
 			const expiresAtMs = json.expiresAt ? Date.parse(json.expiresAt) : null;
 			const lease = {
+				provider: json.provider,
+				sandboxId: json.sandboxId,
+				providerResourceId: json.providerResourceId,
 				jwt: json.jwt,
 				wsEndpoint: json.wsEndpoint,
 				subprotocol: json.subprotocol,