@mastra/daytona 0.0.1

package/dist/sandbox/index.d.ts

@@ -0,0 +1,224 @@
+/**
+ * Daytona Sandbox Provider
+ *
+ * A Daytona sandbox implementation for Mastra workspaces.
+ * Supports command execution, environment variables, resource configuration,
+ * snapshots, and Daytona volumes.
+ *
+ * @see https://www.daytona.io/docs
+ */
+import type { Sandbox, VolumeMount } from '@daytonaio/sdk';
+import type { SandboxInfo, ProviderStatus, MastraSandboxOptions } from '@mastra/core/workspace';
+import { MastraSandbox } from '@mastra/core/workspace';
+import type { DaytonaResources } from './types.js';
+/**
+ * Daytona sandbox provider configuration.
+ */
+export interface DaytonaSandboxOptions extends MastraSandboxOptions {
+    /** Unique identifier for this sandbox instance */
+    id?: string;
+    /** API key for authentication. Falls back to DAYTONA_API_KEY env var. */
+    apiKey?: string;
+    /** API URL. Falls back to DAYTONA_API_URL env var or https://app.daytona.io/api. */
+    apiUrl?: string;
+    /** Target runner region. Falls back to DAYTONA_TARGET env var. */
+    target?: string;
+    /**
+     * Default execution timeout in milliseconds.
+     * @default 300_000 // 5 minutes
+     */
+    timeout?: number;
+    /**
+     * Sandbox runtime language.
+     * @default 'typescript'
+     */
+    language?: 'typescript' | 'javascript' | 'python';
+    /** Resource allocation for the sandbox */
+    resources?: DaytonaResources;
+    /** Environment variables to set in the sandbox */
+    env?: Record<string, string>;
+    /** Custom metadata labels */
+    labels?: Record<string, string>;
+    /** Pre-built snapshot ID to create sandbox from. Takes precedence over resources/image. */
+    snapshot?: string;
+    /**
+     * Docker image to use for sandbox creation. When set, triggers image-based creation.
+     * Can optionally be combined with `resources` for custom resource allocation.
+     * Has no effect when `snapshot` is set.
+     */
+    image?: string;
+    /**
+     * Whether the sandbox should be ephemeral. If true, autoDeleteInterval will be set to 0
+     * (delete immediately on stop).
+     * @default false
+     */
+    ephemeral?: boolean;
+    /**
+     * Auto-stop interval in minutes (0 = disabled).
+     * @default 15
+     */
+    autoStopInterval?: number;
+    /**
+     * Auto-archive interval in minutes (0 = maximum interval, which is 7 days).
+     * @default 7 days
+     */
+    autoArchiveInterval?: number;
+    /**
+     * Daytona volumes to attach at creation.
+     * Volumes are configured at sandbox creation time, not mounted dynamically.
+     */
+    volumes?: Array<VolumeMount>;
+    /** Sandbox display name */
+    name?: string;
+    /** OS user to use for the sandbox */
+    user?: string;
+    /** Whether the sandbox port preview is public */
+    public?: boolean;
+    /**
+     * Auto-delete interval in minutes (negative = disabled, 0 = delete immediately on stop).
+     * @default disabled
+     */
+    autoDeleteInterval?: number;
+    /** Whether to block all network access for the sandbox */
+    networkBlockAll?: boolean;
+    /** Comma-separated list of allowed CIDR network addresses for the sandbox */
+    networkAllowList?: string;
+}
+/**
+ * Daytona sandbox provider for Mastra workspaces.
+ *
+ * Features:
+ * - Isolated cloud sandbox via Daytona SDK
+ * - Multi-runtime support (TypeScript, JavaScript, Python)
+ * - Resource configuration (CPU, memory, disk)
+ * - Volume attachment at creation time
+ * - Automatic sandbox timeout handling with retry
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { Workspace } from '@mastra/core/workspace';
+ * import { DaytonaSandbox } from '@mastra/daytona';
+ *
+ * const sandbox = new DaytonaSandbox({
+ *   timeout: 60000,
+ *   language: 'typescript',
+ * });
+ *
+ * const workspace = new Workspace({ sandbox });
+ * const result = await workspace.executeCode('console.log("Hello!")');
+ * ```
+ *
+ * @example With resources and volumes
+ * ```typescript
+ * const sandbox = new DaytonaSandbox({
+ *   resources: { cpu: 2, memory: 4, disk: 6 },
+ *   volumes: [{ volumeId: 'vol-123', mountPath: '/data' }],
+ *   env: { NODE_ENV: 'production' },
+ * });
+ * ```
+ */
+export declare class DaytonaSandbox extends MastraSandbox {
+    readonly id: string;
+    readonly name = "DaytonaSandbox";
+    readonly provider = "daytona";
+    status: ProviderStatus;
+    private _daytona;
+    private _sandbox;
+    private _createdAt;
+    private _isRetrying;
+    private _workingDir;
+    private readonly timeout;
+    private readonly language;
+    private readonly resources?;
+    private readonly env;
+    private readonly labels;
+    private readonly snapshotId?;
+    private readonly image?;
+    private readonly ephemeral;
+    private readonly autoStopInterval?;
+    private readonly autoArchiveInterval?;
+    private readonly autoDeleteInterval?;
+    private readonly volumeConfigs;
+    private readonly sandboxName?;
+    private readonly sandboxUser?;
+    private readonly sandboxPublic?;
+    private readonly networkBlockAll?;
+    private readonly networkAllowList?;
+    private readonly connectionOpts;
+    constructor(options?: DaytonaSandboxOptions);
+    private generateId;
+    /**
+     * Get the underlying Daytona Sandbox instance for direct access to Daytona APIs.
+     *
+     * Use this when you need to access Daytona features not exposed through the
+     * WorkspaceSandbox interface (e.g., filesystem API, git operations, LSP).
+     *
+     * @throws {SandboxNotReadyError} If the sandbox has not been started
+     *
+     * @example Direct file operations
+     * ```typescript
+     * const daytonaSandbox = sandbox.instance;
+     * await daytonaSandbox.fs.uploadFile(Buffer.from('Hello'), '/tmp/test.txt');
+     * ```
+     */
+    get instance(): Sandbox;
+    /**
+     * Start the Daytona sandbox.
+     * Reconnects to an existing sandbox with the same logical ID if one exists,
+     * otherwise creates a new sandbox instance.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the Daytona sandbox.
+     * Stops the sandbox instance and releases the reference.
+     */
+    stop(): Promise<void>;
+    /**
+     * Destroy the Daytona sandbox and clean up all resources.
+     * Deletes the sandbox and clears all state.
+     */
+    destroy(): Promise<void>;
+    /**
+     * Check if the sandbox is ready for operations.
+     */
+    isReady(): Promise<boolean>;
+    /**
+     * Get information about the current state of the sandbox.
+     */
+    getInfo(): Promise<SandboxInfo>;
+    /**
+     * Get instructions describing this Daytona sandbox.
+     * Used by agents to understand the execution environment.
+     */
+    getInstructions(): string;
+    /**
+     * Detect the actual working directory inside the sandbox via `pwd`.
+     * Stores the result for use in `getInstructions()`.
+     */
+    private detectWorkingDir;
+    /**
+     * Try to find and reconnect to an existing Daytona sandbox with the same
+     * logical ID (via the mastra-sandbox-id label). Returns the sandbox if
+     * found and usable, or null if a fresh sandbox should be created.
+     */
+    private findExistingSandbox;
+    /**
+     * Check if an error indicates the sandbox is dead/gone.
+     * Uses DaytonaNotFoundError from the SDK when available,
+     * with string fallback for edge cases.
+     *
+     * String patterns observed in @daytonaio/sdk@0.143.0 error messages.
+     * Update if SDK error messages change in future versions.
+     */
+    private isSandboxDeadError;
+    /**
+     * Handle sandbox timeout by clearing the instance and resetting state.
+     */
+    private handleSandboxTimeout;
+    /**
+     * Execute a function, retrying once if the sandbox is found to be dead.
+     * Used by DaytonaProcessManager to handle stale sandboxes transparently.
+     */
+    retryOnDead<T>(fn: () => Promise<T>): Promise<T>;
+}
+//# 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":"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"}

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

@@ -0,0 +1,34 @@
+/**
+ * Daytona Process Manager
+ *
+ * Implements SandboxProcessManager for Daytona cloud sandboxes.
+ * Wraps the Daytona SDK's session API (createSession, executeSessionCommand,
+ * getSessionCommandLogs, deleteSession) for background process management.
+ *
+ * Each spawn() creates a dedicated session with a single command.
+ * The user command is wrapped in a subshell `(command)` so that:
+ * - `exit N` exits the subshell, not the session shell
+ * - Heredocs are contained within the subshell
+ * - The session command finishes cleanly
+ */
+import { ProcessHandle, SandboxProcessManager } from '@mastra/core/workspace';
+import type { ProcessInfo, SpawnProcessOptions } from '@mastra/core/workspace';
+import type { DaytonaSandbox } from './index.js';
+export interface DaytonaProcessManagerOptions {
+    env?: Record<string, string | undefined>;
+    /** Default timeout in milliseconds for commands that don't specify one. */
+    defaultTimeout?: number;
+}
+/**
+ * Daytona implementation of SandboxProcessManager.
+ * Uses the Daytona SDK's session API with one session per spawned process.
+ */
+export declare class DaytonaProcessManager extends SandboxProcessManager<DaytonaSandbox> {
+    private _nextPid;
+    private readonly _defaultTimeout?;
+    constructor(opts?: DaytonaProcessManagerOptions);
+    spawn(command: string, options?: SpawnProcessOptions): Promise<ProcessHandle>;
+    list(): Promise<ProcessInfo[]>;
+    get(pid: number): Promise<ProcessHandle | undefined>;
+}
+//# sourceMappingURL=process-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../../src/sandbox/process-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,KAAK,EAAiB,WAAW,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE9F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA2J9C,MAAM,WAAW,4BAA4B;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,qBAAqB,CAAC,cAAc,CAAC;IAC9E,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAS;gBAE9B,IAAI,GAAE,4BAAiC;IAK7C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC;IAkDjF,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAa9B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;CAG3D"}

package/dist/sandbox/types.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Daytona Sandbox Types
+ */
+/**
+ * Resource allocation for Daytona sandboxes.
+ */
+export interface DaytonaResources {
+    /** CPU cores */
+    cpu?: number;
+    /** Memory in GiB */
+    memory?: number;
+    /** Disk in GiB */
+    disk?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sandbox/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/utils/compact.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Returns a shallow copy of the object with all undefined values removed.
+ */
+export declare function compact<T extends object>(obj: T): T;
+//# sourceMappingURL=compact.d.ts.map

package/dist/utils/compact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact.d.ts","sourceRoot":"","sources":["../../src/utils/compact.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAEnD"}

package/dist/utils/shell-quote.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shell-quote a single argument for safe use in a command string.
+ *
+ * Arguments containing only safe characters are returned as-is.
+ * All others are wrapped in single quotes with embedded single quotes escaped.
+ */
+export declare function shellQuote(arg: string): string;
+//# sourceMappingURL=shell-quote.d.ts.map

package/dist/utils/shell-quote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-quote.d.ts","sourceRoot":"","sources":["../../src/utils/shell-quote.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK9C"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@mastra/daytona",
+  "version": "0.0.1",
+  "description": "Daytona cloud sandbox provider for Mastra workspaces",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@daytonaio/sdk": "^0.143.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.19.7",
+    "@vitest/coverage-v8": "4.0.18",
+    "@vitest/ui": "4.0.18",
+    "dotenv": "^17.2.3",
+    "eslint": "^9.37.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "4.0.18",
+    "@internal/lint": "0.0.63",
+    "@internal/workspace-test-utils": "0.0.7",
+    "@internal/types-builder": "0.0.38",
+    "@mastra/core": "1.8.0"
+  },
+  "peerDependencies": {
+    "@mastra/core": ">=1.3.0-0 <2.0.0-0"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "homepage": "https://mastra.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mastra-ai/mastra.git",
+    "directory": "workspaces/daytona"
+  },
+  "bugs": {
+    "url": "https://github.com/mastra-ai/mastra/issues"
+  },
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "scripts": {
+    "build": "tsup --silent --config tsup.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": "eslint ."
+  }
+}