@mastra/e2b-desktop 0.0.0 → 0.1.0-alpha.0

package/LICENSE.md

@@ -0,0 +1,30 @@
+Portions of this software are licensed as follows:
+
+- All content that resides under any directory named "ee/" within this
+  repository, including but not limited to:
+  - `packages/core/src/auth/ee/`
+  - `packages/server/src/server/auth/ee/`
+    is licensed under the license defined in `ee/LICENSE`.
+
+- All third-party components incorporated into the Mastra Software are
+  licensed under the original license provided by the owner of the
+  applicable component.
+
+- Content outside of the above-mentioned directories or restrictions is
+  available under the "Apache License 2.0" as defined below.
+
+# Apache License 2.0
+
+Copyright (c) 2025 Kepler Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/dist/index.cjs

@@ -0,0 +1,285 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _e2b_desktop = require("@e2b/desktop");
+let _mastra_core_workspace = require("@mastra/core/workspace");
+let _mastra_e2b = require("@mastra/e2b");
+//#region src/sandbox/index.ts
+/**
+* E2B Desktop Sandbox Provider
+*
+* An E2B sandbox running a full Linux desktop environment with computer-use
+* (screenshot, mouse, keyboard) control. Extends `@mastra/e2b`'s `E2BSandbox`
+* the same way `@e2b/desktop`'s SDK `Sandbox` extends `e2b`'s: everything the
+* base provider supports (command execution, processes, file upload,
+* reconnection) works against the same desktop VM.
+*
+* @see https://github.com/e2b-dev/desktop
+*/
+/**
+* E2B-hosted desktop template (`@e2b/desktop`'s default). Used when no
+* explicit `template` option is provided — unlike the base provider, no
+* template build is required.
+*/
+const DEFAULT_DESKTOP_TEMPLATE = "desktop";
+/**
+* E2B Desktop sandbox provider for Mastra workspaces.
+*
+* Features:
+* - Everything from `E2BSandbox` (commands, processes, file upload, pause/resume)
+* - `computer` capability: screenshot, mouse, and keyboard control — when
+*   used in a `Workspace`, agents automatically get the
+*   `mastra_workspace_computer_*` tools
+* - Live desktop view via an authenticated noVNC stream URL
+*
+* @example Basic 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({
+*   // file + shell + computer tools are all emitted automatically
+*   workspace: new Workspace({ sandbox }),
+*   // ...
+* });
+* ```
+*
+* @example Direct desktop control
+* ```typescript
+* const sandbox = new E2BDesktopSandbox();
+* await sandbox.start();
+* await sandbox.computer.leftClick(100, 200);
+* const { data } = await sandbox.computer.screenshot();
+* const viewerUrl = await sandbox.computer.streamUrl();
+* ```
+*/
+var E2BDesktopSandbox = class E2BDesktopSandbox extends _mastra_e2b.E2BSandbox {
+	name = "E2BDesktopSandbox";
+	provider = "e2b-desktop";
+	resolution;
+	dpi;
+	_desktopConstructorOptions;
+	/** Stream startup memo, keyed by SDK sandbox ID so a fresh VM restarts it. */
+	_streamStarted = null;
+	constructor(options = {}) {
+		super(options);
+		this.resolution = options.resolution;
+		this.dpi = options.dpi;
+		this._desktopConstructorOptions = { ...options };
+	}
+	/**
+	* Computer-use (desktop) capability: screenshot, mouse, and keyboard
+	* control of the sandbox's desktop, backed by `@e2b/desktop`.
+	* Operations start the sandbox automatically if it is not running.
+	*/
+	computer = {
+		screenshot: async () => {
+			return {
+				data: await this.withDesktop((desktop) => desktop.screenshot()),
+				mediaType: "image/png"
+			};
+		},
+		leftClick: async (x, y) => {
+			await this.withDesktop((desktop) => desktop.leftClick(x, y));
+		},
+		rightClick: async (x, y) => {
+			await this.withDesktop((desktop) => desktop.rightClick(x, y));
+		},
+		doubleClick: async (x, y) => {
+			await this.withDesktop((desktop) => desktop.doubleClick(x, y));
+		},
+		moveMouse: async (x, y) => {
+			await this.withDesktop((desktop) => desktop.moveMouse(x, y));
+		},
+		drag: async (from, to) => {
+			await this.withDesktop((desktop) => desktop.drag([from.x, from.y], [to.x, to.y]));
+		},
+		scroll: async (direction, amount) => {
+			await this.withDesktop((desktop) => desktop.scroll(direction, amount));
+		},
+		type: async (text) => {
+			await this.withDesktop((desktop) => desktop.write(text));
+		},
+		press: async (key) => {
+			await this.withDesktop((desktop) => desktop.press(key));
+		},
+		getScreenSize: async () => {
+			return this.withDesktop((desktop) => desktop.getScreenSize());
+		},
+		getCursorPosition: async () => {
+			return this.withDesktop((desktop) => desktop.getCursorPosition());
+		},
+		streamUrl: async () => {
+			try {
+				return await this.withDesktop(async (desktop) => {
+					await this.ensureStreamStarted(desktop);
+					try {
+						return desktop.stream.getUrl({ authKey: desktop.stream.getAuthKey() });
+					} catch {
+						return desktop.stream.getUrl();
+					}
+				});
+			} catch {
+				return null;
+			}
+		}
+	};
+	/**
+	* Get the underlying `@e2b/desktop` Sandbox instance for direct access to
+	* desktop APIs not exposed through the abstraction (e.g. `launch()`,
+	* `open()`, window helpers, custom stream control).
+	*
+	* @throws {SandboxNotReadyError} If the sandbox has not been started
+	*
+	* @example Launch an application
+	* ```typescript
+	* await sandbox.start();
+	* await sandbox.desktop.launch('xfce4-terminal');
+	* await sandbox.desktop.open('https://mastra.ai');
+	* ```
+	*/
+	get desktop() {
+		if (!this._sandbox) throw new _mastra_core_workspace.SandboxNotReadyError(this.id);
+		return this._sandbox;
+	}
+	/**
+	* Construct a sibling `E2BDesktopSandbox` that inherits this sandbox's
+	* configuration with per-instance overrides. See `E2BSandbox.clone`.
+	*/
+	clone(options = {}) {
+		const { id: _id, ...base } = this._desktopConstructorOptions;
+		return new E2BDesktopSandbox({
+			...base,
+			...options.id !== void 0 && { id: options.id },
+			...options.env !== void 0 && { env: options.env },
+			...options.idleTimeoutMinutes !== void 0 && { timeout: options.idleTimeoutMinutes * 6e4 }
+		});
+	}
+	/** Create a `@e2b/desktop` SDK sandbox (with desktop display options). */
+	async createSdkSandbox(templateId, opts) {
+		return _e2b_desktop.Sandbox.create(templateId, {
+			...opts,
+			...this.resolution && { resolution: this.resolution },
+			...this.dpi !== void 0 && { dpi: this.dpi }
+		});
+	}
+	/** Connect to an existing `@e2b/desktop` SDK sandbox. */
+	async connectSdkSandbox(sandboxId, opts) {
+		return _e2b_desktop.Sandbox.connect(sandboxId, opts);
+	}
+	/**
+	* Resolve the template: without an explicit `template` option, use the
+	* E2B-hosted desktop template (no build needed). Explicit templates go
+	* through the base provider's resolution (ID, builder, or customizer).
+	*/
+	async resolveTemplate() {
+		if (this._resolvedTemplateId) return this._resolvedTemplateId;
+		if (!this.templateSpec) {
+			this._resolvedTemplateId = DEFAULT_DESKTOP_TEMPLATE;
+			return this._resolvedTemplateId;
+		}
+		return super.resolveTemplate();
+	}
+	/**
+	* The default desktop template is E2B-hosted — there is nothing to build.
+	* (Only reached from the template-not-found retry path in `start()`.)
+	*/
+	async buildDefaultTemplate() {
+		this._resolvedTemplateId = DEFAULT_DESKTOP_TEMPLATE;
+		return this._resolvedTemplateId;
+	}
+	/** Ensure the sandbox is running, then run a desktop SDK operation. */
+	async withDesktop(fn) {
+		await this.ensureRunning();
+		return this.retryOnDead(() => fn(this.desktop));
+	}
+	/**
+	* Ensure the VNC stream is running (authenticated), memoized per SDK
+	* sandbox so a resumed/recreated VM restarts it. A stream already started
+	* externally (via the `desktop` escape hatch) is left untouched.
+	*/
+	async ensureStreamStarted(desktop) {
+		if (this._streamStarted?.sandboxId !== desktop.sandboxId) {
+			const promise = desktop.stream.start({ requireAuth: true }).catch((error) => {
+				if (String(error).includes("already running")) return;
+				this._streamStarted = null;
+				throw error;
+			});
+			this._streamStarted = {
+				sandboxId: desktop.sandboxId,
+				promise
+			};
+		}
+		return this._streamStarted.promise;
+	}
+};
+//#endregion
+//#region src/provider.ts
+const e2bDesktopSandboxProvider = {
+	id: "e2b-desktop",
+	name: "E2B Desktop Sandbox",
+	description: "Cloud desktop (computer-use) sandbox powered by E2B",
+	configSchema: {
+		type: "object",
+		properties: {
+			template: {
+				type: "string",
+				description: "Sandbox template ID (defaults to the E2B desktop template)"
+			},
+			timeout: {
+				type: "number",
+				description: "Execution timeout in milliseconds",
+				default: 3e5
+			},
+			env: {
+				type: "object",
+				description: "Environment variables",
+				additionalProperties: { type: "string" }
+			},
+			metadata: {
+				type: "object",
+				description: "Custom metadata",
+				additionalProperties: true
+			},
+			resolution: {
+				type: "array",
+				description: "Desktop resolution as [width, height] in pixels",
+				items: { type: "number" },
+				minItems: 2,
+				maxItems: 2
+			},
+			dpi: {
+				type: "number",
+				description: "Desktop display DPI"
+			},
+			domain: {
+				type: "string",
+				description: "Domain for self-hosted E2B"
+			},
+			apiUrl: {
+				type: "string",
+				description: "API URL for self-hosted E2B"
+			},
+			apiKey: {
+				type: "string",
+				description: "E2B API key"
+			},
+			accessToken: {
+				type: "string",
+				description: "E2B access token"
+			}
+		}
+	},
+	createSandbox: (config) => {
+		const { resolution, ...rest } = config;
+		return new E2BDesktopSandbox({
+			...rest,
+			...resolution && { resolution: [resolution[0], resolution[1]] }
+		});
+	}
+};
+//#endregion
+exports.E2BDesktopSandbox = E2BDesktopSandbox;
+exports.e2bDesktopSandboxProvider = e2bDesktopSandboxProvider;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["E2BSandbox","SandboxNotReadyError","E2BDesktopSdkSandbox"],"sources":["../src/sandbox/index.ts","../src/provider.ts"],"sourcesContent":["/**\n * E2B Desktop Sandbox Provider\n *\n * An E2B sandbox running a full Linux desktop environment with computer-use\n * (screenshot, mouse, keyboard) control. Extends `@mastra/e2b`'s `E2BSandbox`\n * the same way `@e2b/desktop`'s SDK `Sandbox` extends `e2b`'s: everything the\n * base provider supports (command execution, processes, file upload,\n * reconnection) works against the same desktop VM.\n *\n * @see https://github.com/e2b-dev/desktop\n */\n\nimport { Sandbox as E2BDesktopSdkSandbox } from '@e2b/desktop';\nimport type { SandboxCloneOptions, SandboxComputer } from '@mastra/core/workspace';\nimport { SandboxNotReadyError } from '@mastra/core/workspace';\nimport { E2BSandbox } from '@mastra/e2b';\nimport type { E2BSandboxOptions } from '@mastra/e2b';\nimport type { Sandbox, SandboxConnectOpts, SandboxOpts } from 'e2b';\n\n/**\n * E2B-hosted desktop template (`@e2b/desktop`'s default). Used when no\n * explicit `template` option is provided — unlike the base provider, no\n * template build is required.\n */\nconst DEFAULT_DESKTOP_TEMPLATE = 'desktop';\n\n// =============================================================================\n// E2B Desktop Sandbox Options\n// =============================================================================\n\n/**\n * E2B Desktop sandbox provider configuration.\n *\n * Inherits all `E2BSandboxOptions` (credentials, timeout, env, metadata,\n * network, template, instructions). When no `template` is provided, the\n * E2B-hosted `desktop` template is used instead of the base provider's\n * mountable template.\n */\nexport interface E2BDesktopSandboxOptions extends E2BSandboxOptions {\n  /**\n   * Desktop display resolution as `[width, height]` in pixels.\n   * Applies to newly created sandboxes only.\n   */\n  resolution?: [number, number];\n  /**\n   * Desktop display DPI.\n   * Applies to newly created sandboxes only.\n   */\n  dpi?: number;\n}\n\n// =============================================================================\n// E2B Desktop Sandbox Implementation\n// =============================================================================\n\n/**\n * E2B Desktop sandbox provider for Mastra workspaces.\n *\n * Features:\n * - Everything from `E2BSandbox` (commands, processes, file upload, pause/resume)\n * - `computer` capability: screenshot, mouse, and keyboard control — when\n *   used in a `Workspace`, agents automatically get the\n *   `mastra_workspace_computer_*` tools\n * - Live desktop view via an authenticated noVNC stream URL\n *\n * @example Basic usage\n * ```typescript\n * import { Agent } from '@mastra/core/agent';\n * import { Workspace } from '@mastra/core/workspace';\n * import { E2BDesktopSandbox } from '@mastra/e2b-desktop';\n *\n * const sandbox = new E2BDesktopSandbox({ resolution: [1280, 720] });\n * const agent = new Agent({\n *   // file + shell + computer tools are all emitted automatically\n *   workspace: new Workspace({ sandbox }),\n *   // ...\n * });\n * ```\n *\n * @example Direct desktop control\n * ```typescript\n * const sandbox = new E2BDesktopSandbox();\n * await sandbox.start();\n * await sandbox.computer.leftClick(100, 200);\n * const { data } = await sandbox.computer.screenshot();\n * const viewerUrl = await sandbox.computer.streamUrl();\n * ```\n */\nexport class E2BDesktopSandbox extends E2BSandbox {\n  override readonly name: string = 'E2BDesktopSandbox';\n  override readonly provider: string = 'e2b-desktop';\n\n  private readonly resolution?: [number, number];\n  private readonly dpi?: number;\n  private readonly _desktopConstructorOptions: E2BDesktopSandboxOptions;\n\n  /** Stream startup memo, keyed by SDK sandbox ID so a fresh VM restarts it. */\n  private _streamStarted: { sandboxId: string; promise: Promise<void> } | null = null;\n\n  constructor(options: E2BDesktopSandboxOptions = {}) {\n    super(options);\n    this.resolution = options.resolution;\n    this.dpi = options.dpi;\n    this._desktopConstructorOptions = { ...options };\n  }\n\n  /**\n   * Computer-use (desktop) capability: screenshot, mouse, and keyboard\n   * control of the sandbox's desktop, backed by `@e2b/desktop`.\n   * Operations start the sandbox automatically if it is not running.\n   */\n  override readonly computer: SandboxComputer = {\n    screenshot: async () => {\n      const data = await this.withDesktop(desktop => desktop.screenshot());\n      return { data, mediaType: 'image/png' as const };\n    },\n    leftClick: async (x, y) => {\n      await this.withDesktop(desktop => desktop.leftClick(x, y));\n    },\n    rightClick: async (x, y) => {\n      await this.withDesktop(desktop => desktop.rightClick(x, y));\n    },\n    doubleClick: async (x, y) => {\n      await this.withDesktop(desktop => desktop.doubleClick(x, y));\n    },\n    moveMouse: async (x, y) => {\n      await this.withDesktop(desktop => desktop.moveMouse(x, y));\n    },\n    drag: async (from, to) => {\n      await this.withDesktop(desktop => desktop.drag([from.x, from.y], [to.x, to.y]));\n    },\n    scroll: async (direction, amount) => {\n      await this.withDesktop(desktop => desktop.scroll(direction, amount));\n    },\n    type: async text => {\n      await this.withDesktop(desktop => desktop.write(text));\n    },\n    press: async key => {\n      await this.withDesktop(desktop => desktop.press(key));\n    },\n    getScreenSize: async () => {\n      return this.withDesktop(desktop => desktop.getScreenSize());\n    },\n    getCursorPosition: async () => {\n      return this.withDesktop(desktop => desktop.getCursorPosition());\n    },\n    streamUrl: async () => {\n      try {\n        return await this.withDesktop(async desktop => {\n          await this.ensureStreamStarted(desktop);\n          try {\n            return desktop.stream.getUrl({ authKey: desktop.stream.getAuthKey() });\n          } catch {\n            // Stream was started externally without auth — return the plain URL.\n            return desktop.stream.getUrl();\n          }\n        });\n      } catch {\n        return null;\n      }\n    },\n  };\n\n  /**\n   * Get the underlying `@e2b/desktop` Sandbox instance for direct access to\n   * desktop APIs not exposed through the abstraction (e.g. `launch()`,\n   * `open()`, window helpers, custom stream control).\n   *\n   * @throws {SandboxNotReadyError} If the sandbox has not been started\n   *\n   * @example Launch an application\n   * ```typescript\n   * await sandbox.start();\n   * await sandbox.desktop.launch('xfce4-terminal');\n   * await sandbox.desktop.open('https://mastra.ai');\n   * ```\n   */\n  get desktop(): E2BDesktopSdkSandbox {\n    if (!this._sandbox) {\n      throw new SandboxNotReadyError(this.id);\n    }\n    // Safe: the factory hooks below guarantee the SDK sandbox is a desktop sandbox.\n    return this._sandbox as E2BDesktopSdkSandbox;\n  }\n\n  /**\n   * Construct a sibling `E2BDesktopSandbox` that inherits this sandbox's\n   * configuration with per-instance overrides. See `E2BSandbox.clone`.\n   */\n  override clone(options: SandboxCloneOptions = {}): E2BDesktopSandbox {\n    const { id: _id, ...base } = this._desktopConstructorOptions;\n    return new E2BDesktopSandbox({\n      ...base,\n      ...(options.id !== undefined && { id: options.id }),\n      ...(options.env !== undefined && { env: options.env }),\n      ...(options.idleTimeoutMinutes !== undefined && { timeout: options.idleTimeoutMinutes * 60_000 }),\n    });\n  }\n\n  // ---------------------------------------------------------------------------\n  // SDK Factory Hooks\n  // ---------------------------------------------------------------------------\n\n  /** Create a `@e2b/desktop` SDK sandbox (with desktop display options). */\n  protected override async createSdkSandbox(templateId: string, opts: SandboxOpts): Promise<Sandbox> {\n    return E2BDesktopSdkSandbox.create(templateId, {\n      ...opts,\n      ...(this.resolution && { resolution: this.resolution }),\n      ...(this.dpi !== undefined && { dpi: this.dpi }),\n    });\n  }\n\n  /** Connect to an existing `@e2b/desktop` SDK sandbox. */\n  protected override async connectSdkSandbox(sandboxId: string, opts: SandboxConnectOpts): Promise<Sandbox> {\n    return E2BDesktopSdkSandbox.connect(sandboxId, opts);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Template Resolution\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Resolve the template: without an explicit `template` option, use the\n   * E2B-hosted desktop template (no build needed). Explicit templates go\n   * through the base provider's resolution (ID, builder, or customizer).\n   */\n  protected override async resolveTemplate(): Promise<string> {\n    if (this._resolvedTemplateId) {\n      return this._resolvedTemplateId;\n    }\n    if (!this.templateSpec) {\n      this._resolvedTemplateId = DEFAULT_DESKTOP_TEMPLATE;\n      return this._resolvedTemplateId;\n    }\n    return super.resolveTemplate();\n  }\n\n  /**\n   * The default desktop template is E2B-hosted — there is nothing to build.\n   * (Only reached from the template-not-found retry path in `start()`.)\n   */\n  protected override async buildDefaultTemplate(): Promise<string> {\n    this._resolvedTemplateId = DEFAULT_DESKTOP_TEMPLATE;\n    return this._resolvedTemplateId;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Internal Helpers\n  // ---------------------------------------------------------------------------\n\n  /** Ensure the sandbox is running, then run a desktop SDK operation. */\n  private async withDesktop<T>(fn: (desktop: E2BDesktopSdkSandbox) => Promise<T>): Promise<T> {\n    await this.ensureRunning();\n    return this.retryOnDead(() => fn(this.desktop));\n  }\n\n  /**\n   * Ensure the VNC stream is running (authenticated), memoized per SDK\n   * sandbox so a resumed/recreated VM restarts it. A stream already started\n   * externally (via the `desktop` escape hatch) is left untouched.\n   */\n  private async ensureStreamStarted(desktop: E2BDesktopSdkSandbox): Promise<void> {\n    if (this._streamStarted?.sandboxId !== desktop.sandboxId) {\n      const promise = desktop.stream.start({ requireAuth: true }).catch((error: unknown) => {\n        if (String(error).includes('already running')) {\n          return;\n        }\n        this._streamStarted = null;\n        throw error;\n      });\n      this._streamStarted = { sandboxId: desktop.sandboxId, promise };\n    }\n    return this._streamStarted.promise;\n  }\n}\n","/**\n * E2B Desktop sandbox provider descriptor for MastraEditor.\n *\n * @example\n * ```typescript\n * import { e2bDesktopSandboxProvider } from '@mastra/e2b-desktop';\n *\n * const editor = new MastraEditor({\n *   sandboxes: [e2bDesktopSandboxProvider],\n * });\n * ```\n */\nimport type { SandboxProvider } from '@mastra/core/editor';\nimport { E2BDesktopSandbox } from './sandbox';\n\n/**\n * Serializable subset of E2BDesktopSandboxOptions for editor storage.\n * Non-serializable options (TemplateBuilder callbacks, runtime objects) are excluded.\n */\ninterface E2BDesktopProviderConfig {\n  template?: string;\n  timeout?: number;\n  env?: Record<string, string>;\n  metadata?: Record<string, unknown>;\n  resolution?: [number, number];\n  dpi?: number;\n  domain?: string;\n  apiUrl?: string;\n  apiKey?: string;\n  accessToken?: string;\n}\n\nexport const e2bDesktopSandboxProvider: SandboxProvider<E2BDesktopProviderConfig> = {\n  id: 'e2b-desktop',\n  name: 'E2B Desktop Sandbox',\n  description: 'Cloud desktop (computer-use) sandbox powered by E2B',\n  configSchema: {\n    type: 'object',\n    properties: {\n      template: { type: 'string', description: 'Sandbox template ID (defaults to the E2B desktop template)' },\n      timeout: { type: 'number', description: 'Execution timeout in milliseconds', default: 300000 },\n      env: {\n        type: 'object',\n        description: 'Environment variables',\n        additionalProperties: { type: 'string' },\n      },\n      metadata: {\n        type: 'object',\n        description: 'Custom metadata',\n        additionalProperties: true,\n      },\n      resolution: {\n        type: 'array',\n        description: 'Desktop resolution as [width, height] in pixels',\n        items: { type: 'number' },\n        minItems: 2,\n        maxItems: 2,\n      },\n      dpi: { type: 'number', description: 'Desktop display DPI' },\n      domain: { type: 'string', description: 'Domain for self-hosted E2B' },\n      apiUrl: { type: 'string', description: 'API URL for self-hosted E2B' },\n      apiKey: { type: 'string', description: 'E2B API key' },\n      accessToken: { type: 'string', description: 'E2B access token' },\n    },\n  },\n  createSandbox: config => {\n    const { resolution, ...rest } = config;\n    return new E2BDesktopSandbox({\n      ...rest,\n      ...(resolution && { resolution: [resolution[0]!, resolution[1]!] }),\n    });\n  },\n};\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { E2BDesktopSandbox, type E2BDesktopSandboxOptions } from './sandbox/index.js';
+export { e2bDesktopSandboxProvider } from './provider.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAC7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,283 @@
+import { Sandbox } from "@e2b/desktop";
+import { SandboxNotReadyError } from "@mastra/core/workspace";
+import { E2BSandbox } from "@mastra/e2b";
+//#region src/sandbox/index.ts
+/**
+* E2B Desktop Sandbox Provider
+*
+* An E2B sandbox running a full Linux desktop environment with computer-use
+* (screenshot, mouse, keyboard) control. Extends `@mastra/e2b`'s `E2BSandbox`
+* the same way `@e2b/desktop`'s SDK `Sandbox` extends `e2b`'s: everything the
+* base provider supports (command execution, processes, file upload,
+* reconnection) works against the same desktop VM.
+*
+* @see https://github.com/e2b-dev/desktop
+*/
+/**
+* E2B-hosted desktop template (`@e2b/desktop`'s default). Used when no
+* explicit `template` option is provided — unlike the base provider, no
+* template build is required.
+*/
+const DEFAULT_DESKTOP_TEMPLATE = "desktop";
+/**
+* E2B Desktop sandbox provider for Mastra workspaces.
+*
+* Features:
+* - Everything from `E2BSandbox` (commands, processes, file upload, pause/resume)
+* - `computer` capability: screenshot, mouse, and keyboard control — when
+*   used in a `Workspace`, agents automatically get the
+*   `mastra_workspace_computer_*` tools
+* - Live desktop view via an authenticated noVNC stream URL
+*
+* @example Basic 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({
+*   // file + shell + computer tools are all emitted automatically
+*   workspace: new Workspace({ sandbox }),
+*   // ...
+* });
+* ```
+*
+* @example Direct desktop control
+* ```typescript
+* const sandbox = new E2BDesktopSandbox();
+* await sandbox.start();
+* await sandbox.computer.leftClick(100, 200);
+* const { data } = await sandbox.computer.screenshot();
+* const viewerUrl = await sandbox.computer.streamUrl();
+* ```
+*/
+var E2BDesktopSandbox = class E2BDesktopSandbox extends E2BSandbox {
+	name = "E2BDesktopSandbox";
+	provider = "e2b-desktop";
+	resolution;
+	dpi;
+	_desktopConstructorOptions;
+	/** Stream startup memo, keyed by SDK sandbox ID so a fresh VM restarts it. */
+	_streamStarted = null;
+	constructor(options = {}) {
+		super(options);
+		this.resolution = options.resolution;
+		this.dpi = options.dpi;
+		this._desktopConstructorOptions = { ...options };
+	}
+	/**
+	* Computer-use (desktop) capability: screenshot, mouse, and keyboard
+	* control of the sandbox's desktop, backed by `@e2b/desktop`.
+	* Operations start the sandbox automatically if it is not running.
+	*/
+	computer = {
+		screenshot: async () => {
+			return {
+				data: await this.withDesktop((desktop) => desktop.screenshot()),
+				mediaType: "image/png"
+			};
+		},
+		leftClick: async (x, y) => {
+			await this.withDesktop((desktop) => desktop.leftClick(x, y));
+		},
+		rightClick: async (x, y) => {
+			await this.withDesktop((desktop) => desktop.rightClick(x, y));
+		},
+		doubleClick: async (x, y) => {
+			await this.withDesktop((desktop) => desktop.doubleClick(x, y));
+		},
+		moveMouse: async (x, y) => {
+			await this.withDesktop((desktop) => desktop.moveMouse(x, y));
+		},
+		drag: async (from, to) => {
+			await this.withDesktop((desktop) => desktop.drag([from.x, from.y], [to.x, to.y]));
+		},
+		scroll: async (direction, amount) => {
+			await this.withDesktop((desktop) => desktop.scroll(direction, amount));
+		},
+		type: async (text) => {
+			await this.withDesktop((desktop) => desktop.write(text));
+		},
+		press: async (key) => {
+			await this.withDesktop((desktop) => desktop.press(key));
+		},
+		getScreenSize: async () => {
+			return this.withDesktop((desktop) => desktop.getScreenSize());
+		},
+		getCursorPosition: async () => {
+			return this.withDesktop((desktop) => desktop.getCursorPosition());
+		},
+		streamUrl: async () => {
+			try {
+				return await this.withDesktop(async (desktop) => {
+					await this.ensureStreamStarted(desktop);
+					try {
+						return desktop.stream.getUrl({ authKey: desktop.stream.getAuthKey() });
+					} catch {
+						return desktop.stream.getUrl();
+					}
+				});
+			} catch {
+				return null;
+			}
+		}
+	};
+	/**
+	* Get the underlying `@e2b/desktop` Sandbox instance for direct access to
+	* desktop APIs not exposed through the abstraction (e.g. `launch()`,
+	* `open()`, window helpers, custom stream control).
+	*
+	* @throws {SandboxNotReadyError} If the sandbox has not been started
+	*
+	* @example Launch an application
+	* ```typescript
+	* await sandbox.start();
+	* await sandbox.desktop.launch('xfce4-terminal');
+	* await sandbox.desktop.open('https://mastra.ai');
+	* ```
+	*/
+	get desktop() {
+		if (!this._sandbox) throw new SandboxNotReadyError(this.id);
+		return this._sandbox;
+	}
+	/**
+	* Construct a sibling `E2BDesktopSandbox` that inherits this sandbox's
+	* configuration with per-instance overrides. See `E2BSandbox.clone`.
+	*/
+	clone(options = {}) {
+		const { id: _id, ...base } = this._desktopConstructorOptions;
+		return new E2BDesktopSandbox({
+			...base,
+			...options.id !== void 0 && { id: options.id },
+			...options.env !== void 0 && { env: options.env },
+			...options.idleTimeoutMinutes !== void 0 && { timeout: options.idleTimeoutMinutes * 6e4 }
+		});
+	}
+	/** Create a `@e2b/desktop` SDK sandbox (with desktop display options). */
+	async createSdkSandbox(templateId, opts) {
+		return Sandbox.create(templateId, {
+			...opts,
+			...this.resolution && { resolution: this.resolution },
+			...this.dpi !== void 0 && { dpi: this.dpi }
+		});
+	}
+	/** Connect to an existing `@e2b/desktop` SDK sandbox. */
+	async connectSdkSandbox(sandboxId, opts) {
+		return Sandbox.connect(sandboxId, opts);
+	}
+	/**
+	* Resolve the template: without an explicit `template` option, use the
+	* E2B-hosted desktop template (no build needed). Explicit templates go
+	* through the base provider's resolution (ID, builder, or customizer).
+	*/
+	async resolveTemplate() {
+		if (this._resolvedTemplateId) return this._resolvedTemplateId;
+		if (!this.templateSpec) {
+			this._resolvedTemplateId = DEFAULT_DESKTOP_TEMPLATE;
+			return this._resolvedTemplateId;
+		}
+		return super.resolveTemplate();
+	}
+	/**
+	* The default desktop template is E2B-hosted — there is nothing to build.
+	* (Only reached from the template-not-found retry path in `start()`.)
+	*/
+	async buildDefaultTemplate() {
+		this._resolvedTemplateId = DEFAULT_DESKTOP_TEMPLATE;
+		return this._resolvedTemplateId;
+	}
+	/** Ensure the sandbox is running, then run a desktop SDK operation. */
+	async withDesktop(fn) {
+		await this.ensureRunning();
+		return this.retryOnDead(() => fn(this.desktop));
+	}
+	/**
+	* Ensure the VNC stream is running (authenticated), memoized per SDK
+	* sandbox so a resumed/recreated VM restarts it. A stream already started
+	* externally (via the `desktop` escape hatch) is left untouched.
+	*/
+	async ensureStreamStarted(desktop) {
+		if (this._streamStarted?.sandboxId !== desktop.sandboxId) {
+			const promise = desktop.stream.start({ requireAuth: true }).catch((error) => {
+				if (String(error).includes("already running")) return;
+				this._streamStarted = null;
+				throw error;
+			});
+			this._streamStarted = {
+				sandboxId: desktop.sandboxId,
+				promise
+			};
+		}
+		return this._streamStarted.promise;
+	}
+};
+//#endregion
+//#region src/provider.ts
+const e2bDesktopSandboxProvider = {
+	id: "e2b-desktop",
+	name: "E2B Desktop Sandbox",
+	description: "Cloud desktop (computer-use) sandbox powered by E2B",
+	configSchema: {
+		type: "object",
+		properties: {
+			template: {
+				type: "string",
+				description: "Sandbox template ID (defaults to the E2B desktop template)"
+			},
+			timeout: {
+				type: "number",
+				description: "Execution timeout in milliseconds",
+				default: 3e5
+			},
+			env: {
+				type: "object",
+				description: "Environment variables",
+				additionalProperties: { type: "string" }
+			},
+			metadata: {
+				type: "object",
+				description: "Custom metadata",
+				additionalProperties: true
+			},
+			resolution: {
+				type: "array",
+				description: "Desktop resolution as [width, height] in pixels",
+				items: { type: "number" },
+				minItems: 2,
+				maxItems: 2
+			},
+			dpi: {
+				type: "number",
+				description: "Desktop display DPI"
+			},
+			domain: {
+				type: "string",
+				description: "Domain for self-hosted E2B"
+			},
+			apiUrl: {
+				type: "string",
+				description: "API URL for self-hosted E2B"
+			},
+			apiKey: {
+				type: "string",
+				description: "E2B API key"
+			},
+			accessToken: {
+				type: "string",
+				description: "E2B access token"
+			}
+		}
+	},
+	createSandbox: (config) => {
+		const { resolution, ...rest } = config;
+		return new E2BDesktopSandbox({
+			...rest,
+			...resolution && { resolution: [resolution[0], resolution[1]] }
+		});
+	}
+};
+//#endregion
+export { E2BDesktopSandbox, e2bDesktopSandboxProvider };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["E2BDesktopSdkSandbox"],"sources":["../src/sandbox/index.ts","../src/provider.ts"],"sourcesContent":["/**\n * E2B Desktop Sandbox Provider\n *\n * An E2B sandbox running a full Linux desktop environment with computer-use\n * (screenshot, mouse, keyboard) control. Extends `@mastra/e2b`'s `E2BSandbox`\n * the same way `@e2b/desktop`'s SDK `Sandbox` extends `e2b`'s: everything the\n * base provider supports (command execution, processes, file upload,\n * reconnection) works against the same desktop VM.\n *\n * @see https://github.com/e2b-dev/desktop\n */\n\nimport { Sandbox as E2BDesktopSdkSandbox } from '@e2b/desktop';\nimport type { SandboxCloneOptions, SandboxComputer } from '@mastra/core/workspace';\nimport { SandboxNotReadyError } from '@mastra/core/workspace';\nimport { E2BSandbox } from '@mastra/e2b';\nimport type { E2BSandboxOptions } from '@mastra/e2b';\nimport type { Sandbox, SandboxConnectOpts, SandboxOpts } from 'e2b';\n\n/**\n * E2B-hosted desktop template (`@e2b/desktop`'s default). Used when no\n * explicit `template` option is provided — unlike the base provider, no\n * template build is required.\n */\nconst DEFAULT_DESKTOP_TEMPLATE = 'desktop';\n\n// =============================================================================\n// E2B Desktop Sandbox Options\n// =============================================================================\n\n/**\n * E2B Desktop sandbox provider configuration.\n *\n * Inherits all `E2BSandboxOptions` (credentials, timeout, env, metadata,\n * network, template, instructions). When no `template` is provided, the\n * E2B-hosted `desktop` template is used instead of the base provider's\n * mountable template.\n */\nexport interface E2BDesktopSandboxOptions extends E2BSandboxOptions {\n  /**\n   * Desktop display resolution as `[width, height]` in pixels.\n   * Applies to newly created sandboxes only.\n   */\n  resolution?: [number, number];\n  /**\n   * Desktop display DPI.\n   * Applies to newly created sandboxes only.\n   */\n  dpi?: number;\n}\n\n// =============================================================================\n// E2B Desktop Sandbox Implementation\n// =============================================================================\n\n/**\n * E2B Desktop sandbox provider for Mastra workspaces.\n *\n * Features:\n * - Everything from `E2BSandbox` (commands, processes, file upload, pause/resume)\n * - `computer` capability: screenshot, mouse, and keyboard control — when\n *   used in a `Workspace`, agents automatically get the\n *   `mastra_workspace_computer_*` tools\n * - Live desktop view via an authenticated noVNC stream URL\n *\n * @example Basic usage\n * ```typescript\n * import { Agent } from '@mastra/core/agent';\n * import { Workspace } from '@mastra/core/workspace';\n * import { E2BDesktopSandbox } from '@mastra/e2b-desktop';\n *\n * const sandbox = new E2BDesktopSandbox({ resolution: [1280, 720] });\n * const agent = new Agent({\n *   // file + shell + computer tools are all emitted automatically\n *   workspace: new Workspace({ sandbox }),\n *   // ...\n * });\n * ```\n *\n * @example Direct desktop control\n * ```typescript\n * const sandbox = new E2BDesktopSandbox();\n * await sandbox.start();\n * await sandbox.computer.leftClick(100, 200);\n * const { data } = await sandbox.computer.screenshot();\n * const viewerUrl = await sandbox.computer.streamUrl();\n * ```\n */\nexport class E2BDesktopSandbox extends E2BSandbox {\n  override readonly name: string = 'E2BDesktopSandbox';\n  override readonly provider: string = 'e2b-desktop';\n\n  private readonly resolution?: [number, number];\n  private readonly dpi?: number;\n  private readonly _desktopConstructorOptions: E2BDesktopSandboxOptions;\n\n  /** Stream startup memo, keyed by SDK sandbox ID so a fresh VM restarts it. */\n  private _streamStarted: { sandboxId: string; promise: Promise<void> } | null = null;\n\n  constructor(options: E2BDesktopSandboxOptions = {}) {\n    super(options);\n    this.resolution = options.resolution;\n    this.dpi = options.dpi;\n    this._desktopConstructorOptions = { ...options };\n  }\n\n  /**\n   * Computer-use (desktop) capability: screenshot, mouse, and keyboard\n   * control of the sandbox's desktop, backed by `@e2b/desktop`.\n   * Operations start the sandbox automatically if it is not running.\n   */\n  override readonly computer: SandboxComputer = {\n    screenshot: async () => {\n      const data = await this.withDesktop(desktop => desktop.screenshot());\n      return { data, mediaType: 'image/png' as const };\n    },\n    leftClick: async (x, y) => {\n      await this.withDesktop(desktop => desktop.leftClick(x, y));\n    },\n    rightClick: async (x, y) => {\n      await this.withDesktop(desktop => desktop.rightClick(x, y));\n    },\n    doubleClick: async (x, y) => {\n      await this.withDesktop(desktop => desktop.doubleClick(x, y));\n    },\n    moveMouse: async (x, y) => {\n      await this.withDesktop(desktop => desktop.moveMouse(x, y));\n    },\n    drag: async (from, to) => {\n      await this.withDesktop(desktop => desktop.drag([from.x, from.y], [to.x, to.y]));\n    },\n    scroll: async (direction, amount) => {\n      await this.withDesktop(desktop => desktop.scroll(direction, amount));\n    },\n    type: async text => {\n      await this.withDesktop(desktop => desktop.write(text));\n    },\n    press: async key => {\n      await this.withDesktop(desktop => desktop.press(key));\n    },\n    getScreenSize: async () => {\n      return this.withDesktop(desktop => desktop.getScreenSize());\n    },\n    getCursorPosition: async () => {\n      return this.withDesktop(desktop => desktop.getCursorPosition());\n    },\n    streamUrl: async () => {\n      try {\n        return await this.withDesktop(async desktop => {\n          await this.ensureStreamStarted(desktop);\n          try {\n            return desktop.stream.getUrl({ authKey: desktop.stream.getAuthKey() });\n          } catch {\n            // Stream was started externally without auth — return the plain URL.\n            return desktop.stream.getUrl();\n          }\n        });\n      } catch {\n        return null;\n      }\n    },\n  };\n\n  /**\n   * Get the underlying `@e2b/desktop` Sandbox instance for direct access to\n   * desktop APIs not exposed through the abstraction (e.g. `launch()`,\n   * `open()`, window helpers, custom stream control).\n   *\n   * @throws {SandboxNotReadyError} If the sandbox has not been started\n   *\n   * @example Launch an application\n   * ```typescript\n   * await sandbox.start();\n   * await sandbox.desktop.launch('xfce4-terminal');\n   * await sandbox.desktop.open('https://mastra.ai');\n   * ```\n   */\n  get desktop(): E2BDesktopSdkSandbox {\n    if (!this._sandbox) {\n      throw new SandboxNotReadyError(this.id);\n    }\n    // Safe: the factory hooks below guarantee the SDK sandbox is a desktop sandbox.\n    return this._sandbox as E2BDesktopSdkSandbox;\n  }\n\n  /**\n   * Construct a sibling `E2BDesktopSandbox` that inherits this sandbox's\n   * configuration with per-instance overrides. See `E2BSandbox.clone`.\n   */\n  override clone(options: SandboxCloneOptions = {}): E2BDesktopSandbox {\n    const { id: _id, ...base } = this._desktopConstructorOptions;\n    return new E2BDesktopSandbox({\n      ...base,\n      ...(options.id !== undefined && { id: options.id }),\n      ...(options.env !== undefined && { env: options.env }),\n      ...(options.idleTimeoutMinutes !== undefined && { timeout: options.idleTimeoutMinutes * 60_000 }),\n    });\n  }\n\n  // ---------------------------------------------------------------------------\n  // SDK Factory Hooks\n  // ---------------------------------------------------------------------------\n\n  /** Create a `@e2b/desktop` SDK sandbox (with desktop display options). */\n  protected override async createSdkSandbox(templateId: string, opts: SandboxOpts): Promise<Sandbox> {\n    return E2BDesktopSdkSandbox.create(templateId, {\n      ...opts,\n      ...(this.resolution && { resolution: this.resolution }),\n      ...(this.dpi !== undefined && { dpi: this.dpi }),\n    });\n  }\n\n  /** Connect to an existing `@e2b/desktop` SDK sandbox. */\n  protected override async connectSdkSandbox(sandboxId: string, opts: SandboxConnectOpts): Promise<Sandbox> {\n    return E2BDesktopSdkSandbox.connect(sandboxId, opts);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Template Resolution\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Resolve the template: without an explicit `template` option, use the\n   * E2B-hosted desktop template (no build needed). Explicit templates go\n   * through the base provider's resolution (ID, builder, or customizer).\n   */\n  protected override async resolveTemplate(): Promise<string> {\n    if (this._resolvedTemplateId) {\n      return this._resolvedTemplateId;\n    }\n    if (!this.templateSpec) {\n      this._resolvedTemplateId = DEFAULT_DESKTOP_TEMPLATE;\n      return this._resolvedTemplateId;\n    }\n    return super.resolveTemplate();\n  }\n\n  /**\n   * The default desktop template is E2B-hosted — there is nothing to build.\n   * (Only reached from the template-not-found retry path in `start()`.)\n   */\n  protected override async buildDefaultTemplate(): Promise<string> {\n    this._resolvedTemplateId = DEFAULT_DESKTOP_TEMPLATE;\n    return this._resolvedTemplateId;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Internal Helpers\n  // ---------------------------------------------------------------------------\n\n  /** Ensure the sandbox is running, then run a desktop SDK operation. */\n  private async withDesktop<T>(fn: (desktop: E2BDesktopSdkSandbox) => Promise<T>): Promise<T> {\n    await this.ensureRunning();\n    return this.retryOnDead(() => fn(this.desktop));\n  }\n\n  /**\n   * Ensure the VNC stream is running (authenticated), memoized per SDK\n   * sandbox so a resumed/recreated VM restarts it. A stream already started\n   * externally (via the `desktop` escape hatch) is left untouched.\n   */\n  private async ensureStreamStarted(desktop: E2BDesktopSdkSandbox): Promise<void> {\n    if (this._streamStarted?.sandboxId !== desktop.sandboxId) {\n      const promise = desktop.stream.start({ requireAuth: true }).catch((error: unknown) => {\n        if (String(error).includes('already running')) {\n          return;\n        }\n        this._streamStarted = null;\n        throw error;\n      });\n      this._streamStarted = { sandboxId: desktop.sandboxId, promise };\n    }\n    return this._streamStarted.promise;\n  }\n}\n","/**\n * E2B Desktop sandbox provider descriptor for MastraEditor.\n *\n * @example\n * ```typescript\n * import { e2bDesktopSandboxProvider } from '@mastra/e2b-desktop';\n *\n * const editor = new MastraEditor({\n *   sandboxes: [e2bDesktopSandboxProvider],\n * });\n * ```\n */\nimport type { SandboxProvider } from '@mastra/core/editor';\nimport { E2BDesktopSandbox } from './sandbox';\n\n/**\n * Serializable subset of E2BDesktopSandboxOptions for editor storage.\n * Non-serializable options (TemplateBuilder callbacks, runtime objects) are excluded.\n */\ninterface E2BDesktopProviderConfig {\n  template?: string;\n  timeout?: number;\n  env?: Record<string, string>;\n  metadata?: Record<string, unknown>;\n  resolution?: [number, number];\n  dpi?: number;\n  domain?: string;\n  apiUrl?: string;\n  apiKey?: string;\n  accessToken?: string;\n}\n\nexport const e2bDesktopSandboxProvider: SandboxProvider<E2BDesktopProviderConfig> = {\n  id: 'e2b-desktop',\n  name: 'E2B Desktop Sandbox',\n  description: 'Cloud desktop (computer-use) sandbox powered by E2B',\n  configSchema: {\n    type: 'object',\n    properties: {\n      template: { type: 'string', description: 'Sandbox template ID (defaults to the E2B desktop template)' },\n      timeout: { type: 'number', description: 'Execution timeout in milliseconds', default: 300000 },\n      env: {\n        type: 'object',\n        description: 'Environment variables',\n        additionalProperties: { type: 'string' },\n      },\n      metadata: {\n        type: 'object',\n        description: 'Custom metadata',\n        additionalProperties: true,\n      },\n      resolution: {\n        type: 'array',\n        description: 'Desktop resolution as [width, height] in pixels',\n        items: { type: 'number' },\n        minItems: 2,\n        maxItems: 2,\n      },\n      dpi: { type: 'number', description: 'Desktop display DPI' },\n      domain: { type: 'string', description: 'Domain for self-hosted E2B' },\n      apiUrl: { type: 'string', description: 'API URL for self-hosted E2B' },\n      apiKey: { type: 'string', description: 'E2B API key' },\n      accessToken: { type: 'string', description: 'E2B access token' },\n    },\n  },\n  createSandbox: config => {\n    const { resolution, ...rest } = config;\n    return new E2BDesktopSandbox({\n      ...rest,\n      ...(resolution && { resolution: [resolution[0]!, resolution[1]!] }),\n    });\n  },\n};\n"],"mappings":"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"}

package/dist/provider.d.ts

@@ -0,0 +1,32 @@
+/**
+ * E2B Desktop sandbox provider descriptor for MastraEditor.
+ *
+ * @example
+ * ```typescript
+ * import { e2bDesktopSandboxProvider } from '@mastra/e2b-desktop';
+ *
+ * const editor = new MastraEditor({
+ *   sandboxes: [e2bDesktopSandboxProvider],
+ * });
+ * ```
+ */
+import type { SandboxProvider } from '@mastra/core/editor';
+/**
+ * Serializable subset of E2BDesktopSandboxOptions for editor storage.
+ * Non-serializable options (TemplateBuilder callbacks, runtime objects) are excluded.
+ */
+interface E2BDesktopProviderConfig {
+    template?: string;
+    timeout?: number;
+    env?: Record<string, string>;
+    metadata?: Record<string, unknown>;
+    resolution?: [number, number];
+    dpi?: number;
+    domain?: string;
+    apiUrl?: string;
+    apiKey?: string;
+    accessToken?: string;
+}
+export declare const e2bDesktopSandboxProvider: SandboxProvider<E2BDesktopProviderConfig>;
+export {};
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D;;;GAGG;AACH,UAAU,wBAAwB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,yBAAyB,EAAE,eAAe,CAAC,wBAAwB,CAwC/E,CAAC"}

package/dist/sandbox/index.d.ts

@@ -0,0 +1,129 @@
+/**
+ * E2B Desktop Sandbox Provider
+ *
+ * An E2B sandbox running a full Linux desktop environment with computer-use
+ * (screenshot, mouse, keyboard) control. Extends `@mastra/e2b`'s `E2BSandbox`
+ * the same way `@e2b/desktop`'s SDK `Sandbox` extends `e2b`'s: everything the
+ * base provider supports (command execution, processes, file upload,
+ * reconnection) works against the same desktop VM.
+ *
+ * @see https://github.com/e2b-dev/desktop
+ */
+import { Sandbox as E2BDesktopSdkSandbox } from '@e2b/desktop';
+import type { SandboxCloneOptions, SandboxComputer } from '@mastra/core/workspace';
+import { E2BSandbox } from '@mastra/e2b';
+import type { E2BSandboxOptions } from '@mastra/e2b';
+import type { Sandbox, SandboxConnectOpts, SandboxOpts } from 'e2b';
+/**
+ * E2B Desktop sandbox provider configuration.
+ *
+ * Inherits all `E2BSandboxOptions` (credentials, timeout, env, metadata,
+ * network, template, instructions). When no `template` is provided, the
+ * E2B-hosted `desktop` template is used instead of the base provider's
+ * mountable template.
+ */
+export interface E2BDesktopSandboxOptions extends E2BSandboxOptions {
+    /**
+     * Desktop display resolution as `[width, height]` in pixels.
+     * Applies to newly created sandboxes only.
+     */
+    resolution?: [number, number];
+    /**
+     * Desktop display DPI.
+     * Applies to newly created sandboxes only.
+     */
+    dpi?: number;
+}
+/**
+ * E2B Desktop sandbox provider for Mastra workspaces.
+ *
+ * Features:
+ * - Everything from `E2BSandbox` (commands, processes, file upload, pause/resume)
+ * - `computer` capability: screenshot, mouse, and keyboard control — when
+ *   used in a `Workspace`, agents automatically get the
+ *   `mastra_workspace_computer_*` tools
+ * - Live desktop view via an authenticated noVNC stream URL
+ *
+ * @example Basic 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({
+ *   // file + shell + computer tools are all emitted automatically
+ *   workspace: new Workspace({ sandbox }),
+ *   // ...
+ * });
+ * ```
+ *
+ * @example Direct desktop control
+ * ```typescript
+ * const sandbox = new E2BDesktopSandbox();
+ * await sandbox.start();
+ * await sandbox.computer.leftClick(100, 200);
+ * const { data } = await sandbox.computer.screenshot();
+ * const viewerUrl = await sandbox.computer.streamUrl();
+ * ```
+ */
+export declare class E2BDesktopSandbox extends E2BSandbox {
+    readonly name: string;
+    readonly provider: string;
+    private readonly resolution?;
+    private readonly dpi?;
+    private readonly _desktopConstructorOptions;
+    /** Stream startup memo, keyed by SDK sandbox ID so a fresh VM restarts it. */
+    private _streamStarted;
+    constructor(options?: E2BDesktopSandboxOptions);
+    /**
+     * Computer-use (desktop) capability: screenshot, mouse, and keyboard
+     * control of the sandbox's desktop, backed by `@e2b/desktop`.
+     * Operations start the sandbox automatically if it is not running.
+     */
+    readonly computer: SandboxComputer;
+    /**
+     * Get the underlying `@e2b/desktop` Sandbox instance for direct access to
+     * desktop APIs not exposed through the abstraction (e.g. `launch()`,
+     * `open()`, window helpers, custom stream control).
+     *
+     * @throws {SandboxNotReadyError} If the sandbox has not been started
+     *
+     * @example Launch an application
+     * ```typescript
+     * await sandbox.start();
+     * await sandbox.desktop.launch('xfce4-terminal');
+     * await sandbox.desktop.open('https://mastra.ai');
+     * ```
+     */
+    get desktop(): E2BDesktopSdkSandbox;
+    /**
+     * Construct a sibling `E2BDesktopSandbox` that inherits this sandbox's
+     * configuration with per-instance overrides. See `E2BSandbox.clone`.
+     */
+    clone(options?: SandboxCloneOptions): E2BDesktopSandbox;
+    /** Create a `@e2b/desktop` SDK sandbox (with desktop display options). */
+    protected createSdkSandbox(templateId: string, opts: SandboxOpts): Promise<Sandbox>;
+    /** Connect to an existing `@e2b/desktop` SDK sandbox. */
+    protected connectSdkSandbox(sandboxId: string, opts: SandboxConnectOpts): Promise<Sandbox>;
+    /**
+     * Resolve the template: without an explicit `template` option, use the
+     * E2B-hosted desktop template (no build needed). Explicit templates go
+     * through the base provider's resolution (ID, builder, or customizer).
+     */
+    protected resolveTemplate(): Promise<string>;
+    /**
+     * The default desktop template is E2B-hosted — there is nothing to build.
+     * (Only reached from the template-not-found retry path in `start()`.)
+     */
+    protected buildDefaultTemplate(): Promise<string>;
+    /** Ensure the sandbox is running, then run a desktop SDK operation. */
+    private withDesktop;
+    /**
+     * Ensure the VNC stream is running (authenticated), memoized per SDK
+     * sandbox so a resumed/recreated VM restarts it. A stream already started
+     * externally (via the `desktop` escape hatch) is left untouched.
+     */
+    private ensureStreamStarted;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/sandbox/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sandbox/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEnF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAapE;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;IACjE;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,iBAAkB,SAAQ,UAAU;IAC/C,SAAkB,IAAI,EAAE,MAAM,CAAuB;IACrD,SAAkB,QAAQ,EAAE,MAAM,CAAiB;IAEnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAmB;IAC/C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAA2B;IAEtE,8EAA8E;IAC9E,OAAO,CAAC,cAAc,CAA8D;gBAExE,OAAO,GAAE,wBAA6B;IAOlD;;;;OAIG;IACH,SAAkB,QAAQ,EAAE,eAAe,CAkDzC;IAEF;;;;;;;;;;;;;OAaG;IACH,IAAI,OAAO,IAAI,oBAAoB,CAMlC;IAED;;;OAGG;IACM,KAAK,CAAC,OAAO,GAAE,mBAAwB,GAAG,iBAAiB;IAcpE,0EAA0E;cACjD,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAQlG,yDAAyD;cAChC,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAQzG;;;;OAIG;cACsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAW3D;;;OAGG;cACsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;IAShE,uEAAuE;YACzD,WAAW;IAKzB;;;;OAIG;YACW,mBAAmB;CAalC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/e2b-desktop",
-  "version": "0.0.0",
+  "version": "0.1.0-alpha.0",
   "description": "E2B Desktop (computer-use) sandbox provider for Mastra workspaces",
   "type": "module",
   "main": "dist/index.js",
@@ -18,36 +18,25 @@
     },
     "./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"
+    "e2b": "^2.36.0",
+    "@mastra/e2b": "^0.10.0-alpha.5"
   },
   "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:",
+    "@vitest/coverage-v8": "4.1.10",
+    "@vitest/ui": "4.1.10",
     "dotenv": "^17.4.2",
     "eslint": "^10.7.0",
     "tsdown": "0.22.9",
-    "typescript": "catalog:",
-    "vitest": "catalog:"
+    "typescript": "^6.0.3",
+    "vitest": "4.1.10",
+    "@internal/types-builder": "0.0.100",
+    "@internal/lint": "0.0.125",
+    "@internal/workspace-test-utils": "0.0.69",
+    "@mastra/core": "1.62.0-alpha.12"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.60.0-0 <2.0.0-0"
@@ -67,5 +56,16 @@
   },
   "engines": {
     "node": ">=22.13.0"
+  },
+  "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 ."
   }
-}
+}