@mastra/daytona 0.1.0-alpha.0 → 0.2.0-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,119 @@
 # @mastra/daytona
 
+## 0.2.0-alpha.0
+
+### Minor Changes
+
+- Added provider-specific `daytona` getter to access the underlying Daytona `Sandbox` instance directly. Deprecated the generic `instance` getter in favor of the new `daytona` getter for better IDE discoverability and consistency with other sandbox providers. ([#14166](https://github.com/mastra-ai/mastra/pull/14166))
+
+  ```typescript
+  // Before
+  const daytonaSandbox = sandbox.instance;
+
+  // After
+  const daytonaSandbox = sandbox.daytona;
+  ```
+
+### Patch Changes
+
+- Improved Daytona process handling to use provider session IDs directly as `ProcessHandle.pid`. ([#13591](https://github.com/mastra-ai/mastra/pull/13591))
+
+  ```typescript
+  const handle = await sandbox.processes.spawn('node server.js');
+  await sandbox.processes.get(handle.pid);
+  ```
+
+- Fixed sandbox reconnection when Daytona sandbox is externally stopped or times out due to inactivity. Previously, the error thrown by the Daytona SDK (e.g. "failed to resolve container IP") did not match the known dead-sandbox patterns, so the automatic retry logic would not trigger and the error would propagate to the user. Added two new error patterns to correctly detect stopped sandboxes and trigger automatic recovery. ([#14175](https://github.com/mastra-ai/mastra/pull/14175))
+
+- dependencies updates: ([#13591](https://github.com/mastra-ai/mastra/pull/13591))
+  - Updated peerDependency `@mastra/core` to `>=1.12.0-0 <2.0.0-0`
+- Updated dependencies [[`9cede11`](https://github.com/mastra-ai/mastra/commit/9cede110abac9d93072e0521bb3c8bcafb9fdadf), [`a59f126`](https://github.com/mastra-ai/mastra/commit/a59f1269104f54726699c5cdb98c72c93606d2df), [`c510833`](https://github.com/mastra-ai/mastra/commit/c5108333e8cbc19dafee5f8bfefbcb5ee935335c), [`7296fcc`](https://github.com/mastra-ai/mastra/commit/7296fcc599c876a68699a71c7054a16d5aaf2337), [`00c27f9`](https://github.com/mastra-ai/mastra/commit/00c27f9080731433230a61be69c44e39a7a7b4c7), [`ee19c9b`](https://github.com/mastra-ai/mastra/commit/ee19c9ba3ec3ed91feb214ad539bdc766c53bb01)]:
+  - @mastra/core@1.12.0-alpha.1
+
+## 0.1.0
+
+### Minor Changes
+
+- Add DaytonaSandbox workspace provider — Daytona cloud sandbox integration for Mastra workspaces, implementing the WorkspaceSandbox interface with support for command execution, environment variables, resource configuration, snapshots, and Daytona volumes. ([#13112](https://github.com/mastra-ai/mastra/pull/13112))
+
+  **Basic usage**
+
+  ```ts
+  import { Workspace } from '@mastra/core/workspace';
+  import { DaytonaSandbox } from '@mastra/daytona';
+
+  const sandbox = new DaytonaSandbox({
+    id: 'my-sandbox',
+    env: { NODE_ENV: 'production' },
+  });
+
+  const workspace = new Workspace({ sandbox });
+  await workspace.init();
+
+  const result = await workspace.sandbox.executeCommand('echo', ['Hello!']);
+  console.log(result.stdout); // "Hello!"
+
+  await workspace.destroy();
+  ```
+
+- Added S3 and GCS cloud filesystem mounting support via FUSE (s3fs-fuse, gcsfuse). Daytona sandboxes can now mount cloud storage as local directories, matching the mount capabilities of E2B and Blaxel providers. ([#13544](https://github.com/mastra-ai/mastra/pull/13544))
+
+  **New methods:**
+  - `mount(filesystem, mountPath)` — Mount an S3 or GCS filesystem at a path in the sandbox
+  - `unmount(mountPath)` — Unmount a previously mounted filesystem
+
+  **What changed:**
+  - Added S3 and GCS bucket mounts as local directories in Daytona sandboxes.
+  - Improved reconnect behavior so mounts are restored reliably.
+  - Added safety checks to prevent mounting into non-empty directories.
+  - Improved concurrent mount support by isolating credentials per mount.
+
+  **Usage:**
+
+  ```typescript
+  import { Workspace } from '@mastra/core/workspace';
+  import { S3Filesystem } from '@mastra/s3';
+  import { DaytonaSandbox } from '@mastra/daytona';
+
+  const workspace = new Workspace({
+    mounts: {
+      '/data': new S3Filesystem({
+        bucket: 'my-bucket',
+        region: 'us-east-1',
+        accessKeyId: process.env.AWS_ACCESS_KEY_ID,
+        secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
+      }),
+    },
+    sandbox: new DaytonaSandbox(),
+  });
+  ```
+
+### Patch Changes
+
+- Remove internal `processes` field from sandbox provider options ([#13597](https://github.com/mastra-ai/mastra/pull/13597))
+
+  The `processes` field is no longer exposed in constructor options for E2B, Daytona, and Blaxel sandbox providers. This field is managed internally and was not intended to be user-configurable.
+
+- Improved S3/GCS FUSE mounting reliability and sandbox reconnection. ([#13543](https://github.com/mastra-ai/mastra/pull/13543))
+
+  **Mounting improvements**
+  - Replaced direct SDK coupling in mount helpers with callback-based context, making mount operations more testable and resilient
+  - Added tmpfs overlay to handle FUSE-on-FUSE remount scenarios that previously failed with ENOENT
+  - Added `mount --move` fallback when standard FUSE unmount fails on stuck mounts
+  - `stop()` now unmounts all filesystems before stopping the sandbox
+  - Added early connectivity check for GCS mounting that detects Daytona's restricted internet tiers and fails fast with an actionable error message instead of hanging
+  - Improved gcsfuse installation with distro-aware codename detection (bookworm for Debian, jammy for Ubuntu)
+  - Added input validation for bucket names, endpoints, and credentials before interpolating into shell commands
+
+  **Reconnection improvements**
+  - `findExistingSandbox` now looks up sandboxes by name first (works for stopped sandboxes), then falls back to label search
+  - Added transitional state handling that polls and waits when a sandbox is starting/stopping/restoring before attempting to start it, avoiding "State change in progress" errors
+
+- Sandbox instructions no longer include a working directory path, keeping instructions stable across sessions. ([#13520](https://github.com/mastra-ai/mastra/pull/13520))
+
+- Updated dependencies [[`504fc8b`](https://github.com/mastra-ai/mastra/commit/504fc8b9d0ddab717577ad3bf9c95ea4bd5377bd), [`f9c150b`](https://github.com/mastra-ai/mastra/commit/f9c150b7595ad05ad9cc9a11098e2944361e8c22), [`88de7e8`](https://github.com/mastra-ai/mastra/commit/88de7e8dfe4b7e1951a9e441bb33136e705ce24e), [`edee4b3`](https://github.com/mastra-ai/mastra/commit/edee4b37dff0af515fc7cc0e8d71ee39e6a762f0), [`3790c75`](https://github.com/mastra-ai/mastra/commit/3790c7578cc6a47d854eb12d89e6b1912867fe29), [`e7a235b`](https://github.com/mastra-ai/mastra/commit/e7a235be6472e0c870ed6c791ddb17c492dc188b), [`d51d298`](https://github.com/mastra-ai/mastra/commit/d51d298953967aab1f58ec965b644d109214f085), [`6dbeeb9`](https://github.com/mastra-ai/mastra/commit/6dbeeb94a8b1eebb727300d1a98961f882180794), [`d5f0d8d`](https://github.com/mastra-ai/mastra/commit/d5f0d8d6a03e515ddaa9b5da19b7e44b8357b07b), [`09c3b18`](https://github.com/mastra-ai/mastra/commit/09c3b1802ff14e243a8a8baea327440bc8cc2e32), [`b896379`](https://github.com/mastra-ai/mastra/commit/b8963791c6afa79484645fcec596a201f936b9a2), [`85c84eb`](https://github.com/mastra-ai/mastra/commit/85c84ebb78aebfcba9d209c8e152b16d7a00cb71), [`a89272a`](https://github.com/mastra-ai/mastra/commit/a89272a5d71939b9fcd284e6a6dc1dd091a6bdcf), [`ee9c8df`](https://github.com/mastra-ai/mastra/commit/ee9c8df644f19d055af5f496bf4942705f5a47b7), [`77b4a25`](https://github.com/mastra-ai/mastra/commit/77b4a254e51907f8ff3a3ba95596a18e93ae4b35), [`276246e`](https://github.com/mastra-ai/mastra/commit/276246e0b9066a1ea48bbc70df84dbe528daaf99), [`08ecfdb`](https://github.com/mastra-ai/mastra/commit/08ecfdbdad6fb8285deef86a034bdf4a6047cfca), [`d5f628c`](https://github.com/mastra-ai/mastra/commit/d5f628ca86c6f6f3ff1035d52f635df32dd81cab), [`524c0f3`](https://github.com/mastra-ai/mastra/commit/524c0f3c434c3d9d18f66338dcef383d6161b59c), [`c18a0e9`](https://github.com/mastra-ai/mastra/commit/c18a0e9cef1e4ca004b2963d35e4cfc031971eac), [`4bd21ea`](https://github.com/mastra-ai/mastra/commit/4bd21ea43d44d0a0427414fc047577f9f0aa3bec), [`115a7a4`](https://github.com/mastra-ai/mastra/commit/115a7a47db5e9896fec12ae6507501adb9ec89bf), [`22a48ae`](https://github.com/mastra-ai/mastra/commit/22a48ae2513eb54d8d79dad361fddbca97a155e8), [`3c6ef79`](https://github.com/mastra-ai/mastra/commit/3c6ef798481e00d6d22563be2de98818fd4dd5e0), [`9311c17`](https://github.com/mastra-ai/mastra/commit/9311c17d7a0640d9c4da2e71b814dc67c57c6369), [`7edf78f`](https://github.com/mastra-ai/mastra/commit/7edf78f80422c43e84585f08ba11df0d4d0b73c5), [`1c4221c`](https://github.com/mastra-ai/mastra/commit/1c4221cf6032ec98d0e094d4ee11da3e48490d96), [`d25b9ea`](https://github.com/mastra-ai/mastra/commit/d25b9eabd400167255a97b690ffbc4ee4097ded5), [`fe1ce5c`](https://github.com/mastra-ai/mastra/commit/fe1ce5c9211c03d561606fda95cbfe7df1d9a9b5), [`b03c0e0`](https://github.com/mastra-ai/mastra/commit/b03c0e0389a799523929a458b0509c9e4244d562), [`0a8366b`](https://github.com/mastra-ai/mastra/commit/0a8366b0a692fcdde56c4d526e4cf03c502ae4ac), [`85664e9`](https://github.com/mastra-ai/mastra/commit/85664e9fd857320fbc245e301f764f45f66f32a3), [`bc79650`](https://github.com/mastra-ai/mastra/commit/bc796500c6e0334faa158a96077e3fb332274869), [`9257d01`](https://github.com/mastra-ai/mastra/commit/9257d01d1366d81f84c582fe02b5e200cf9621f4), [`3a3a59e`](https://github.com/mastra-ai/mastra/commit/3a3a59e8ffaa6a985fe3d9a126a3f5ade11a6724), [`3108d4e`](https://github.com/mastra-ai/mastra/commit/3108d4e649c9fddbf03253a6feeb388a5fa9fa5a), [`0c33b2c`](https://github.com/mastra-ai/mastra/commit/0c33b2c9db537f815e1c59e2c898ffce2e395a79), [`191e5bd`](https://github.com/mastra-ai/mastra/commit/191e5bd29b82f5bda35243945790da7bc7b695c2), [`f77cd94`](https://github.com/mastra-ai/mastra/commit/f77cd94c44eabed490384e7d19232a865e13214c), [`e8135c7`](https://github.com/mastra-ai/mastra/commit/e8135c7e300dac5040670eec7eab896ac6092e30), [`daca48f`](https://github.com/mastra-ai/mastra/commit/daca48f0fb17b7ae0b62a2ac40cf0e491b2fd0b7), [`257d14f`](https://github.com/mastra-ai/mastra/commit/257d14faca5931f2e4186fc165b6f0b1f915deee), [`352f25d`](https://github.com/mastra-ai/mastra/commit/352f25da316b24cdd5b410fd8dddf6a8b763da2a), [`93477d0`](https://github.com/mastra-ai/mastra/commit/93477d0769b8a13ea5ed73d508d967fb23eaeed9), [`31c78b3`](https://github.com/mastra-ai/mastra/commit/31c78b3eb28f58a8017f1dcc795c33214d87feac), [`0bc0720`](https://github.com/mastra-ai/mastra/commit/0bc07201095791858087cc56f353fcd65e87ab54), [`36516ac`](https://github.com/mastra-ai/mastra/commit/36516aca1021cbeb42e74751b46a2614101f37c8), [`e947652`](https://github.com/mastra-ai/mastra/commit/e9476527fdecb4449e54570e80dfaf8466901254), [`3c6ef79`](https://github.com/mastra-ai/mastra/commit/3c6ef798481e00d6d22563be2de98818fd4dd5e0), [`9257d01`](https://github.com/mastra-ai/mastra/commit/9257d01d1366d81f84c582fe02b5e200cf9621f4), [`ec248f6`](https://github.com/mastra-ai/mastra/commit/ec248f6b56e8a037c066c49b2178e2507471d988)]:
+  - @mastra/core@1.9.0
+
 ## 0.1.0-alpha.0
 
 ### Minor Changes

package/dist/index.cjs

@@ -250,7 +250,6 @@ Sandbox network response: ${checkOutput}` : "")
 }
 var DaytonaProcessHandle = class extends workspace.ProcessHandle {
   pid;
-  _sessionId;
   _cmdId;
   _sandbox;
   _startTime;
@@ -259,10 +258,9 @@ var DaytonaProcessHandle = class extends workspace.ProcessHandle {
   _waitPromise = null;
   _streamingPromise = null;
   _killed = false;
-  constructor(pid, sessionId, cmdId, sandbox, startTime, options) {
+  constructor(sessionId, cmdId, sandbox, startTime, options) {
     super(options);
-    this.pid = pid;
-    this._sessionId = sessionId;
+    this.pid = sessionId;
     this._cmdId = cmdId;
     this._sandbox = sandbox;
     this._startTime = startTime;
@@ -280,7 +278,7 @@ var DaytonaProcessHandle = class extends workspace.ProcessHandle {
   async _resolveExitCode() {
     if (this._exitCode !== void 0) return;
     try {
-      const cmd = await this._sandbox.process.getSessionCommand(this._sessionId, this._cmdId);
+      const cmd = await this._sandbox.process.getSessionCommand(this.pid, this._cmdId);
       this._exitCode = cmd.exitCode ?? 0;
     } catch {
       if (this._exitCode === void 0) {
@@ -346,7 +344,7 @@ var DaytonaProcessHandle = class extends workspace.ProcessHandle {
     this._killed = true;
     this._exitCode = 137;
     try {
-      await this._sandbox.process.deleteSession(this._sessionId);
+      await this._sandbox.process.deleteSession(this.pid);
     } catch {
     }
     return true;
@@ -355,11 +353,11 @@ var DaytonaProcessHandle = class extends workspace.ProcessHandle {
     if (this._exitCode !== void 0) {
       throw new Error(`Process ${this.pid} has already exited with code ${this._exitCode}`);
     }
-    await this._sandbox.process.sendSessionCommandInput(this._sessionId, this._cmdId, data);
+    await this._sandbox.process.sendSessionCommandInput(this.pid, this._cmdId, data);
   }
 };
 var DaytonaProcessManager = class extends workspace.SandboxProcessManager {
-  _nextPid = 1;
+  _spawnCounter = 0;
   _defaultTimeout;
   constructor(opts = {}) {
     super({ env: opts.env });
@@ -371,20 +369,19 @@ var DaytonaProcessManager = class extends workspace.SandboxProcessManager {
       timeout: options.timeout ?? this._defaultTimeout
     };
     return this.sandbox.retryOnDead(async () => {
-      const sandbox = this.sandbox.instance;
-      const pid = this._nextPid++;
+      const sandbox = this.sandbox.daytona;
       const mergedEnv = { ...this.env, ...effectiveOptions.env };
       const envs = Object.fromEntries(
         Object.entries(mergedEnv).filter((entry) => entry[1] !== void 0)
       );
       const sessionCommand = buildSpawnCommand(command, effectiveOptions.cwd, envs);
-      const sessionId = `mastra-proc-${Date.now().toString(36)}-${pid}`;
+      const sessionId = `mastra-proc-${Date.now().toString(36)}-${++this._spawnCounter}`;
       await sandbox.process.createSession(sessionId);
       const { cmdId } = await sandbox.process.executeSessionCommand(sessionId, {
         command: sessionCommand,
         runAsync: true
       });
-      const handle = new DaytonaProcessHandle(pid, sessionId, cmdId, sandbox, Date.now(), effectiveOptions);
+      const handle = new DaytonaProcessHandle(sessionId, cmdId, sandbox, Date.now(), effectiveOptions);
       const streamingPromise = sandbox.process.getSessionCommandLogs(
         sessionId,
         cmdId,
@@ -393,7 +390,7 @@ var DaytonaProcessManager = class extends workspace.SandboxProcessManager {
       ).catch(() => {
       });
       handle.streamingPromise = streamingPromise;
-      this._tracked.set(pid, handle);
+      this._tracked.set(handle.pid, handle);
       return handle;
     });
   }
@@ -409,9 +406,6 @@ var DaytonaProcessManager = class extends workspace.SandboxProcessManager {
     }
     return result;
   }
-  async get(pid) {
-    return this._tracked.get(pid);
-  }
 };
 function buildSpawnCommand(command, cwd, envs) {
   const parts = [];
@@ -458,7 +452,9 @@ var SAFE_MARKER_NAME = /^mount-[a-z0-9]+$/;
 var SANDBOX_DEAD_PATTERNS = [
   /sandbox is not running/i,
   /sandbox already destroyed/i,
-  /sandbox.*not found/i
+  /sandbox.*not found/i,
+  /failed to resolve container IP/i,
+  /is the sandbox started/i
 ];
 var DaytonaSandbox = class _DaytonaSandbox extends workspace.MastraSandbox {
   id;
@@ -535,16 +531,21 @@ var DaytonaSandbox = class _DaytonaSandbox extends workspace.MastraSandbox {
    *
    * @example Direct file operations
    * ```typescript
-   * const daytonaSandbox = sandbox.instance;
+   * await sandbox.start();
+   * const daytonaSandbox = sandbox.daytona;
    * await daytonaSandbox.fs.uploadFile(Buffer.from('Hello'), '/tmp/test.txt');
    * ```
    */
-  get instance() {
+  get daytona() {
     if (!this._sandbox) {
       throw new workspace.SandboxNotReadyError(this.id);
     }
     return this._sandbox;
   }
+  /** @deprecated Use `daytona` instead. */
+  get instance() {
+    return this.daytona;
+  }
   // ---------------------------------------------------------------------------
   // Lifecycle
   // ---------------------------------------------------------------------------