@mastra/vercel 0.1.0 → 0.2.0-alpha.0

package/dist/microvm/index.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Vercel Sandbox (MicroVM) Provider
+ *
+ * Wraps the official `@vercel/sandbox` SDK, which provisions ephemeral
+ * Firecracker MicroVMs (Amazon Linux 2023) with a persistent in-session
+ * filesystem, command execution, background processes, and exposed ports.
+ *
+ * This is distinct from the `VercelSandbox` provider in this package, which
+ * runs commands as Vercel serverless Functions and is stateless.
+ *
+ * @see https://vercel.com/docs/vercel-sandbox
+ */
+import type { RequestContext } from '@mastra/core/di';
+import type { CommandResult, ExecuteCommandOptions, InstructionsOption, MastraSandboxOptions, ProviderStatus, SandboxInfo } from '@mastra/core/workspace';
+import { MastraSandbox } from '@mastra/core/workspace';
+import { Sandbox } from '@vercel/sandbox';
+import { VercelMicroVMProcessManager } from './process-manager.js';
+/** Vercel Sandbox runtimes (default `node24`). */
+export type VercelMicroVMRuntime = 'node24' | 'node22' | 'node26' | 'python3.13';
+/**
+ * Vercel Sandbox (MicroVM) provider configuration.
+ *
+ * Authentication: the SDK uses the `VERCEL_OIDC_TOKEN` environment variable
+ * automatically when available. To authenticate from an environment without
+ * OIDC, supply `token`, `teamId`, and `projectId` together (falling back to
+ * the `VERCEL_TOKEN`, `VERCEL_TEAM_ID`, and `VERCEL_PROJECT_ID` env vars).
+ */
+export interface VercelMicroVMSandboxOptions extends Omit<MastraSandboxOptions, 'processes'> {
+    /** Unique identifier for this sandbox instance. */
+    id?: string;
+    /** Optional sandbox name passed to the Vercel API. Auto-generated if omitted. */
+    sandboxName?: string;
+    /** Vercel API token. Falls back to the `VERCEL_TOKEN` env var. */
+    token?: string;
+    /** Vercel team ID. Falls back to the `VERCEL_TEAM_ID` env var. */
+    teamId?: string;
+    /** Vercel project ID. Falls back to the `VERCEL_PROJECT_ID` env var. */
+    projectId?: string;
+    /** Sandbox runtime. @default 'node24' */
+    runtime?: VercelMicroVMRuntime;
+    /**
+     * Timeout in milliseconds before the sandbox auto-terminates.
+     * @default 300_000 // 5 minutes
+     */
+    timeout?: number;
+    /** Resources to allocate. `vcpus` controls CPU count (2048 MB memory per vCPU). */
+    resources?: {
+        vcpus?: number;
+    };
+    /** Ports to expose from the sandbox (up to 4). Access via `getInfo().metadata.domains`. */
+    ports?: number[];
+    /** Default environment variables inherited by all commands. */
+    env?: Record<string, string>;
+    /** Custom metadata surfaced via `getInfo()`. */
+    metadata?: Record<string, unknown>;
+    /**
+     * Custom instructions that override the default instructions
+     * returned by `getInstructions()`.
+     *
+     * - `string` — Fully replaces the default instructions. Pass an empty
+     *   string to suppress instructions entirely.
+     * - `(opts) => string` — Receives the default instructions and optional
+     *   request context so you can extend or customise per-request.
+     */
+    instructions?: InstructionsOption;
+}
+/**
+ * Vercel Sandbox (MicroVM) provider for Mastra workspaces.
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { Workspace } from '@mastra/core/workspace';
+ * import { VercelMicroVMSandbox } from '@mastra/vercel';
+ *
+ * const workspace = new Workspace({
+ *   sandbox: new VercelMicroVMSandbox({ runtime: 'node24', timeout: 600_000 }),
+ * });
+ *
+ * const result = await workspace.sandbox.executeCommand('node', ['--version']);
+ * ```
+ */
+export declare class VercelMicroVMSandbox extends MastraSandbox {
+    readonly id: string;
+    readonly name = "VercelMicroVMSandbox";
+    readonly provider = "vercel-microvm";
+    status: ProviderStatus;
+    readonly processes: VercelMicroVMProcessManager;
+    private _sandbox;
+    private _createdAt;
+    private readonly _sandboxName?;
+    private readonly _token?;
+    private readonly _teamId?;
+    private readonly _projectId?;
+    private readonly _runtime;
+    private readonly _timeout;
+    private readonly _vcpus?;
+    private readonly _ports?;
+    private readonly _env;
+    private readonly _metadata;
+    private readonly _instructionsOverride?;
+    constructor(options?: VercelMicroVMSandboxOptions);
+    /**
+     * The underlying `@vercel/sandbox` instance.
+     * Throws if the sandbox has not been started yet.
+     */
+    get sandbox(): Sandbox;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    destroy(): Promise<void>;
+    private _teardown;
+    executeCommand(command: string, args?: string[], options?: ExecuteCommandOptions): Promise<CommandResult>;
+    getInfo(): SandboxInfo;
+    getInstructions(opts?: {
+        requestContext?: RequestContext;
+    }): string;
+    private _getDefaultInstructions;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/microvm/index.ts"],"names":[],"mappings":"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"}

package/dist/microvm/process-manager.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Vercel Sandbox (MicroVM) Process Manager
+ *
+ * Implements SandboxProcessManager for the `@vercel/sandbox` SDK. Each spawn()
+ * starts a detached command via `sandbox.runCommand({ detached: true })` and
+ * streams its output through the command's async `logs()` iterator.
+ *
+ * The Vercel Sandbox SDK does not expose a stdin channel for running commands,
+ * so `sendStdin()` throws a clear "not supported" error.
+ */
+import { ProcessHandle, SandboxProcessManager } from '@mastra/core/workspace';
+import type { ProcessInfo, SpawnProcessOptions } from '@mastra/core/workspace';
+import type { VercelMicroVMSandbox } from './index.js';
+export interface VercelMicroVMProcessManagerOptions {
+    env?: Record<string, string | undefined>;
+}
+/**
+ * Vercel Sandbox implementation of SandboxProcessManager. Uses one detached
+ * `runCommand` per spawned process.
+ */
+export declare class VercelMicroVMProcessManager extends SandboxProcessManager<VercelMicroVMSandbox> {
+    spawn(command: string, options?: SpawnProcessOptions): Promise<ProcessHandle>;
+    list(): Promise<ProcessInfo[]>;
+}
+//# sourceMappingURL=process-manager.d.ts.map

package/dist/microvm/process-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../../src/microvm/process-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,KAAK,EAAiB,WAAW,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE9F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAgIpD,MAAM,WAAW,kCAAkC;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C;AAED;;;GAGG;AACH,qBAAa,2BAA4B,SAAQ,qBAAqB,CAAC,oBAAoB,CAAC;IACpF,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC;IAiCjF,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CAYrC"}

package/dist/microvm-provider.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Vercel Sandbox (MicroVM) provider descriptor for MastraEditor.
+ *
+ * @example
+ * ```typescript
+ * import { vercelMicroVMSandboxProvider } from '@mastra/vercel';
+ *
+ * const editor = new MastraEditor({
+ *   sandboxes: [vercelMicroVMSandboxProvider],
+ * });
+ * ```
+ */
+import type { SandboxProvider } from '@mastra/core/editor';
+/**
+ * Serializable subset of VercelMicroVMSandboxOptions for editor storage.
+ */
+interface VercelMicroVMProviderConfig {
+    token?: string;
+    teamId?: string;
+    projectId?: string;
+    runtime?: 'node24' | 'node22' | 'node26' | 'python3.13';
+    timeout?: number;
+    vcpus?: number;
+    ports?: number[];
+    env?: Record<string, string>;
+}
+export declare const vercelMicroVMSandboxProvider: SandboxProvider<VercelMicroVMProviderConfig>;
+export {};
+//# sourceMappingURL=microvm-provider.d.ts.map

package/dist/microvm-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"microvm-provider.d.ts","sourceRoot":"","sources":["../src/microvm-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D;;GAEG;AACH,UAAU,2BAA2B;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,eAAO,MAAM,4BAA4B,EAAE,eAAe,CAAC,2BAA2B,CAyCrF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/vercel",
-  "version": "0.1.0",
+  "version": "0.2.0-alpha.0",
   "description": "Vercel serverless sandbox provider for Mastra workspaces",
   "type": "module",
   "main": "dist/index.js",
@@ -19,19 +19,21 @@
     "./package.json": "./package.json"
   },
   "license": "Apache-2.0",
-  "dependencies": {},
+  "dependencies": {
+    "@vercel/sandbox": "2.0.2"
+  },
   "devDependencies": {
     "@types/node": "22.19.15",
-    "@vitest/coverage-v8": "4.0.18",
-    "@vitest/ui": "4.0.18",
+    "@vitest/coverage-v8": "4.1.5",
+    "@vitest/ui": "4.1.5",
     "dotenv": "^17.3.1",
-    "eslint": "^9.39.4",
+    "eslint": "^10.2.1",
     "tsup": "^8.5.1",
-    "typescript": "^5.9.3",
-    "vitest": "4.0.18",
-    "@internal/types-builder": "0.0.51",
-    "@internal/lint": "0.0.76",
-    "@mastra/core": "1.19.0"
+    "typescript": "^6.0.3",
+    "vitest": "4.1.5",
+    "@internal/lint": "0.0.99",
+    "@internal/types-builder": "0.0.74",
+    "@mastra/core": "1.38.0-alpha.3"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.12.0-0 <2.0.0-0"