@mastra/daytona 0.5.2 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,80 @@
 # @mastra/daytona
 
+## 0.6.0
+
+### Minor Changes
+
+- Added networking and bulk file upload support to `DaytonaSandbox`: ([#19577](https://github.com/mastra-ai/mastra/pull/19577))
+
+  - **Public port URLs**: `sandbox.networking.getPortUrl(port)` returns the preview URL for a port, enabling preview URLs and deploys with the new `@mastra/deployer-sandbox` package. Pass `public: true` for tokenless URLs.
+  - **Bulk file upload**: `sandbox.writeFiles(files)` uploads multiple files in one call via the SDK's native `fs.uploadFiles()`.
+  - **Detached lifecycle**: `getPortUrl()`, `stop()`, and `destroy()` now work from a fresh process by looking up the existing sandbox by its `id`, without starting a stopped sandbox first.
+
+  ```typescript
+  import { DaytonaSandbox } from '@mastra/daytona';
+
+  const sandbox = new DaytonaSandbox({ id: 'my-preview', public: true });
+  await sandbox.start();
+  const url = await sandbox.networking.getPortUrl(4111);
+  ```
+
+- Added `clone()` support to the sandbox providers. `clone()` constructs an unstarted sibling sandbox that inherits the template's configuration (credentials, image, resources) with per-instance overrides for `id` and `env`, so one configured sandbox can act as a template for a fleet of sandbox clones (for example, one per project). ([#19616](https://github.com/mastra-ai/mastra/pull/19616))
+
+  ```ts
+  const template = new E2BSandbox({ apiKey, template: 'base' });
+
+  const projectSandbox = template.clone({
+    id: 'mc-project-42',
+    env: { GITHUB_TOKEN: token },
+    idleTimeoutMinutes: 30,
+  });
+  await projectSandbox.start();
+  ```
+
+  `idleTimeoutMinutes` is a best-effort hint that maps to each provider's native lifetime knob (Railway `idleTimeoutMinutes`, E2B/Modal/Vercel timeout in milliseconds, Daytona `autoStopInterval`, Blaxel TTL duration). Docker and Apple Container ignore it since they have no provider-side idle teardown.
+
+### Patch Changes
+
+- Updated dependencies [[`ec857fc`](https://github.com/mastra-ai/mastra/commit/ec857fc79c264b53b38e16478c789b7177f2ad59), [`d7385ad`](https://github.com/mastra-ai/mastra/commit/d7385ad9e88f9e4f33d15c0ec0bfebedde0cbc2e), [`41a5392`](https://github.com/mastra-ai/mastra/commit/41a5392d9f6c5e18d6b227f0fc0ddf49c50774e9), [`3d6e539`](https://github.com/mastra-ai/mastra/commit/3d6e539272eb2ea0407034605ee1906b3be06b39), [`1426af2`](https://github.com/mastra-ai/mastra/commit/1426af24975879c000d13ac75673f630fcc970c1), [`a40adeb`](https://github.com/mastra-ai/mastra/commit/a40adeb222b961a56a58af56a106106525721b74), [`8a0d145`](https://github.com/mastra-ai/mastra/commit/8a0d145aadbdf7278665aceaaec364b35dd9bd94), [`bd2f1d2`](https://github.com/mastra-ai/mastra/commit/bd2f1d274d05e60e2366f005ea0d94d5cea0d5ff), [`e1f2fae`](https://github.com/mastra-ai/mastra/commit/e1f2faebaf048c3d4c2e2c01d293767c195d5794), [`63aa799`](https://github.com/mastra-ai/mastra/commit/63aa799c6b44eacc7806cda6846b7c5bbee06b37), [`b7e79c3`](https://github.com/mastra-ai/mastra/commit/b7e79c3c02ac5cd415db34ba0975ceafc1464333), [`675fbff`](https://github.com/mastra-ai/mastra/commit/675fbff84d3274391b33e852f76083c38a5514e5), [`da009e1`](https://github.com/mastra-ai/mastra/commit/da009e1aacd89ed94b8d1b2af09c9d4fe7c4db49), [`3b77e77`](https://github.com/mastra-ai/mastra/commit/3b77e7704936522e4769d29de1b5ea6901f302bd), [`c7d30cd`](https://github.com/mastra-ai/mastra/commit/c7d30cd86009c407df91105591f03cd6e3d2854d), [`21a0eb8`](https://github.com/mastra-ai/mastra/commit/21a0eb86746ba0b703acea360d4f84c6a5a493f2), [`8b20926`](https://github.com/mastra-ai/mastra/commit/8b20926cd59e2ba3d66458e062fa0e6e2ada3e68), [`975295d`](https://github.com/mastra-ai/mastra/commit/975295d418552f0d46a59edfef4c3ee555f9930a), [`73db8db`](https://github.com/mastra-ai/mastra/commit/73db8db90d69ab6153c7942749f624db0d96952d), [`6b1bf3b`](https://github.com/mastra-ai/mastra/commit/6b1bf3b9494bd51aa8f654c68c9355d6046fa2a1), [`35c2181`](https://github.com/mastra-ai/mastra/commit/35c2181e6a50e47c90ba36260db7c9723d54696f), [`0a2c22c`](https://github.com/mastra-ai/mastra/commit/0a2c22c902604439ec490319e14c17f331e0c84c), [`4cfdd64`](https://github.com/mastra-ai/mastra/commit/4cfdd645794feaea0c4ea711e70ecdfbef0c5b8e), [`b75d749`](https://github.com/mastra-ai/mastra/commit/b75d749621ff5d17e86bcb4ee809d301fb4f7cf3), [`821648b`](https://github.com/mastra-ai/mastra/commit/821648bf2871ef840100c7bacbecf676010bd12a), [`de86fd7`](https://github.com/mastra-ai/mastra/commit/de86fd7119f0438381d1a642e3d258143c0b9c29), [`2745031`](https://github.com/mastra-ai/mastra/commit/2745031d1d4a4978f037092da371428c32e2842a), [`b4b7ea8`](https://github.com/mastra-ai/mastra/commit/b4b7ea8733f033fc441ea47ed03f6afb17ec2248), [`3a8024c`](https://github.com/mastra-ai/mastra/commit/3a8024ce615f8aa89479c0d71fe61d10bb0040be), [`35865a5`](https://github.com/mastra-ai/mastra/commit/35865a53e194aa9634d6a70a97010e7a6b9d58b1), [`74faf8b`](https://github.com/mastra-ai/mastra/commit/74faf8bd9c1018f2492653c06b1e25fc8300e9e6), [`ef03fbc`](https://github.com/mastra-ai/mastra/commit/ef03fbcc556bcbc04c9b3d06fab88771ecaa043c), [`675fbff`](https://github.com/mastra-ai/mastra/commit/675fbff84d3274391b33e852f76083c38a5514e5), [`70687f7`](https://github.com/mastra-ai/mastra/commit/70687f7e495a322a02070b4a67cb0c77a5ca91ec), [`1fadac4`](https://github.com/mastra-ai/mastra/commit/1fadac44537caeefe81f9f775ae2f2f3d94e9069), [`73db8db`](https://github.com/mastra-ai/mastra/commit/73db8db90d69ab6153c7942749f624db0d96952d), [`76b7181`](https://github.com/mastra-ai/mastra/commit/76b71810366e6d90b9d3973149d1c7ba3659ffb9), [`792ec9a`](https://github.com/mastra-ai/mastra/commit/792ec9a0869bab8274cf5e0ed2840738737a1607), [`712b864`](https://github.com/mastra-ai/mastra/commit/712b864aa1ed12b14c54390ec17b69de163c37f7), [`85e4fb5`](https://github.com/mastra-ai/mastra/commit/85e4fb50087a81c74df3a762f53b56373db0b912), [`0c0e8d7`](https://github.com/mastra-ai/mastra/commit/0c0e8d7becd4d1445c656b78d5d845f606c1ff9d), [`a7bbe77`](https://github.com/mastra-ai/mastra/commit/a7bbe773577f60bc4761b534ef7ec6b476332dad), [`72e437c`](https://github.com/mastra-ai/mastra/commit/72e437c515942c80b9def5b026e0bdee61b469d9), [`8f7a5de`](https://github.com/mastra-ai/mastra/commit/8f7a5dedc246cdc938bb65516703cf9b27b03756), [`a7bbe77`](https://github.com/mastra-ai/mastra/commit/a7bbe773577f60bc4761b534ef7ec6b476332dad), [`11f6cd9`](https://github.com/mastra-ai/mastra/commit/11f6cd96fe42582403416608beb212cc1a2cc79e), [`ef03c0c`](https://github.com/mastra-ai/mastra/commit/ef03c0cfc62367a458e4cc56462e2148b35681c5), [`4fb4d88`](https://github.com/mastra-ai/mastra/commit/4fb4d881bc107acee13890ad4d78661016c510ed), [`4e68363`](https://github.com/mastra-ai/mastra/commit/4e683634f94ebd062d26a3bb6093a8dfc7263d37), [`c328769`](https://github.com/mastra-ai/mastra/commit/c3287698ff8ef98dba86d415faa566fa3e5f4d56), [`9f7c67a`](https://github.com/mastra-ai/mastra/commit/9f7c67abeeb52c41c51a9b5edee60b62afe7cd8d), [`3b65e68`](https://github.com/mastra-ai/mastra/commit/3b65e68d7f1c771c7a70eea42d83fefdd28cad88), [`4eba27a`](https://github.com/mastra-ai/mastra/commit/4eba27adcf60f991df0e62f94b3e75b4e67f3b4b), [`c701be3`](https://github.com/mastra-ai/mastra/commit/c701be32d7d9aa94a66da8c6cc38dcac6856f464), [`db650ce`](https://github.com/mastra-ai/mastra/commit/db650ce490348914e85b93651d83acdf8f2a4c31), [`232fcbc`](https://github.com/mastra-ai/mastra/commit/232fcbc14fce625dd672ba043329c0b732c62be2), [`6354eeb`](https://github.com/mastra-ai/mastra/commit/6354eeb32efa9f5f68f51dda394e90e2ee76f1fb), [`a8799bb`](https://github.com/mastra-ai/mastra/commit/a8799bb8e44f4a60d01e4e2acd3448ff80bf14f8), [`3d6e539`](https://github.com/mastra-ai/mastra/commit/3d6e539272eb2ea0407034605ee1906b3be06b39), [`e3868e2`](https://github.com/mastra-ai/mastra/commit/e3868e22babfffd0133771669ca724501c2dd58e), [`9251370`](https://github.com/mastra-ai/mastra/commit/9251370ad413af464aa22d7566338bec5613e8de), [`3491666`](https://github.com/mastra-ai/mastra/commit/34916663c4fdd43b48c21f4ab2d5fb6dcccc94f9), [`c0bec73`](https://github.com/mastra-ai/mastra/commit/c0bec732c93d1a22ae5e51ed66cf8cacca8bd6a6)]:
+  - @mastra/core@1.52.0
+
+## 0.6.0-alpha.0
+
+### Minor Changes
+
+- Added networking and bulk file upload support to `DaytonaSandbox`: ([#19577](https://github.com/mastra-ai/mastra/pull/19577))
+  - **Public port URLs**: `sandbox.networking.getPortUrl(port)` returns the preview URL for a port, enabling preview URLs and deploys with the new `@mastra/deployer-sandbox` package. Pass `public: true` for tokenless URLs.
+  - **Bulk file upload**: `sandbox.writeFiles(files)` uploads multiple files in one call via the SDK's native `fs.uploadFiles()`.
+  - **Detached lifecycle**: `getPortUrl()`, `stop()`, and `destroy()` now work from a fresh process by looking up the existing sandbox by its `id`, without starting a stopped sandbox first.
+
+  ```typescript
+  import { DaytonaSandbox } from '@mastra/daytona';
+
+  const sandbox = new DaytonaSandbox({ id: 'my-preview', public: true });
+  await sandbox.start();
+  const url = await sandbox.networking.getPortUrl(4111);
+  ```
+
+- Added `clone()` support to the sandbox providers. `clone()` constructs an unstarted sibling sandbox that inherits the template's configuration (credentials, image, resources) with per-instance overrides for `id` and `env`, so one configured sandbox can act as a template for a fleet of sandbox clones (for example, one per project). ([#19616](https://github.com/mastra-ai/mastra/pull/19616))
+
+  ```ts
+  const template = new E2BSandbox({ apiKey, template: 'base' });
+
+  const projectSandbox = template.clone({
+    id: 'mc-project-42',
+    env: { GITHUB_TOKEN: token },
+    idleTimeoutMinutes: 30,
+  });
+  await projectSandbox.start();
+  ```
+
+  `idleTimeoutMinutes` is a best-effort hint that maps to each provider's native lifetime knob (Railway `idleTimeoutMinutes`, E2B/Modal/Vercel timeout in milliseconds, Daytona `autoStopInterval`, Blaxel TTL duration). Docker and Apple Container ignore it since they have no provider-side idle teardown.
+
+### Patch Changes
+
+- Updated dependencies [[`ec857fc`](https://github.com/mastra-ai/mastra/commit/ec857fc79c264b53b38e16478c789b7177f2ad59), [`e1f2fae`](https://github.com/mastra-ai/mastra/commit/e1f2faebaf048c3d4c2e2c01d293767c195d5794), [`63aa799`](https://github.com/mastra-ai/mastra/commit/63aa799c6b44eacc7806cda6846b7c5bbee06b37), [`73db8db`](https://github.com/mastra-ai/mastra/commit/73db8db90d69ab6153c7942749f624db0d96952d), [`73db8db`](https://github.com/mastra-ai/mastra/commit/73db8db90d69ab6153c7942749f624db0d96952d), [`76b7181`](https://github.com/mastra-ai/mastra/commit/76b71810366e6d90b9d3973149d1c7ba3659ffb9), [`0c0e8d7`](https://github.com/mastra-ai/mastra/commit/0c0e8d7becd4d1445c656b78d5d845f606c1ff9d), [`9f7c67a`](https://github.com/mastra-ai/mastra/commit/9f7c67abeeb52c41c51a9b5edee60b62afe7cd8d), [`3b65e68`](https://github.com/mastra-ai/mastra/commit/3b65e68d7f1c771c7a70eea42d83fefdd28cad88), [`e3868e2`](https://github.com/mastra-ai/mastra/commit/e3868e22babfffd0133771669ca724501c2dd58e)]:
+  - @mastra/core@1.52.0-alpha.5
+
 ## 0.5.2
 
 ### Patch Changes

package/README.md

@@ -356,12 +356,8 @@ Then use the snapshot name in your sandbox config:
 ```typescript
 const workspace = new Workspace({
   mounts: {
-    '/s3-data': new S3Filesystem({
-      /* ... */
-    }),
-    '/gcs-data': new GCSFilesystem({
-      /* ... */
-    }),
+    '/s3-data': new S3Filesystem({/* ... */}),
+    '/gcs-data': new GCSFilesystem({/* ... */}),
   },
   sandbox: new DaytonaSandbox({ snapshot: 'cloud-fs-mounting' }),
 });

package/dist/index.cjs

@@ -740,6 +740,29 @@ var DaytonaSandbox = class _DaytonaSandbox extends workspace.MastraSandbox {
   name = "DaytonaSandbox";
   provider = "daytona";
   // Non-optional (initialized by base class when mount() exists)
+  /**
+   * Networking capability: public HTTPS URLs for sandbox ports.
+   * Daytona exposes ports through preview links (`getPreviewLink(port)`) —
+   * if the port is closed it is opened automatically. Private sandboxes
+   * require the preview token; pass `public: true` for tokenless URLs
+   * (required for sandbox deploys).
+   *
+   * When not attached in this process, the sandbox is looked up by identity
+   * (`daytona.get()` does not start it), so other processes can resolve
+   * deployments without waking a stopped sandbox.
+   */
+  networking = {
+    getPortUrl: async (port) => {
+      try {
+        const sandbox = this._sandbox ?? await this.lookupDetachedSandbox();
+        if (!sandbox) return null;
+        const preview = await sandbox.getPreviewLink(port);
+        return preview?.url ?? null;
+      } catch {
+        return null;
+      }
+    }
+  };
   status = "pending";
   _daytona = null;
   _sandbox = null;
@@ -765,6 +788,7 @@ var DaytonaSandbox = class _DaytonaSandbox extends workspace.MastraSandbox {
   networkBlockAll;
   networkAllowList;
   connectionOpts;
+  _constructorOptions;
   constructor(options = {}) {
     super({
       ...options,
@@ -797,10 +821,34 @@ var DaytonaSandbox = class _DaytonaSandbox extends workspace.MastraSandbox {
       ...options.apiUrl !== void 0 && { apiUrl: options.apiUrl },
       ...options.target !== void 0 && { target: options.target }
     };
+    this._constructorOptions = { ...options };
   }
   generateId() {
     return `daytona-sandbox-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
   }
+  /**
+   * Construct a sibling `DaytonaSandbox` that inherits this sandbox's
+   * configuration (credentials, snapshot/image, resources, network policy)
+   * with per-instance overrides.
+   *
+   * Performs no I/O — the sandbox clone provisions (or reconnects to an
+   * existing Daytona sandbox with the same logical `id`) on its own `start()`.
+   * Use it when one configured sandbox acts as the template for a fleet of
+   * independent sandboxes (e.g. one per project).
+   *
+   * `options.idleTimeoutMinutes` maps to Daytona's `autoStopInterval`
+   * (minutes); `options.sandboxId` is ignored because Daytona reconnects by
+   * logical `id`.
+   */
+  clone(options = {}) {
+    const { id: _id, name: _name, ...base } = this._constructorOptions;
+    return new _DaytonaSandbox({
+      ...base,
+      ...options.id !== void 0 && { id: options.id },
+      ...options.env !== void 0 && { env: options.env },
+      ...options.idleTimeoutMinutes !== void 0 && { autoStopInterval: options.idleTimeoutMinutes }
+    });
+  }
   /**
    * Get the underlying Daytona Sandbox instance for direct access to Daytona APIs.
    *
@@ -890,13 +938,23 @@ var DaytonaSandbox = class _DaytonaSandbox extends workspace.MastraSandbox {
    * Unmounts all filesystems, then stops the sandbox.
    */
   async stop() {
+    if (!this._sandbox) {
+      try {
+        const existing = await this.lookupDetachedSandbox();
+        if (existing && existing.state === sdk.SandboxState.STARTED) {
+          await this._daytona.stop(existing);
+        }
+      } catch {
+      }
+      return;
+    }
     for (const mountPath of [...this.mounts.entries.keys()]) {
       try {
         await this.unmount(mountPath);
       } catch {
       }
     }
-    if (this._sandbox && this._daytona) {
+    if (this._daytona) {
       try {
         await this._daytona.stop(this._sandbox);
       } catch {
@@ -914,14 +972,13 @@ var DaytonaSandbox = class _DaytonaSandbox extends workspace.MastraSandbox {
         await this._daytona.delete(this._sandbox);
       } catch {
       }
-    } else if (!this._sandbox && this._daytona) {
-      const lookupKey = this._daytonaSandboxId ?? this.sandboxName;
-      if (lookupKey) {
-        try {
-          const orphan = await this._daytona.get(lookupKey);
+    } else if (!this._sandbox) {
+      try {
+        const orphan = await this.lookupDetachedSandbox();
+        if (orphan) {
           await this._daytona.delete(orphan);
-        } catch {
         }
+      } catch {
       }
     }
     this._sandbox = null;
@@ -1000,6 +1057,18 @@ var DaytonaSandbox = class _DaytonaSandbox extends workspace.MastraSandbox {
     const result = await handle.wait();
     return { ...result, command, args };
   }
+  /**
+   * Bulk-write files into the sandbox filesystem via the SDK's native upload.
+   */
+  async writeFiles(files) {
+    await this.ensureRunning();
+    await this.daytona.fs.uploadFiles(
+      files.map((file) => ({
+        source: Buffer.isBuffer(file.content) ? file.content : Buffer.from(file.content),
+        destination: file.path
+      }))
+    );
+  }
   // ---------------------------------------------------------------------------
   // Mount Support
   // ---------------------------------------------------------------------------
@@ -1325,6 +1394,28 @@ var DaytonaSandbox = class _DaytonaSandbox extends workspace.MastraSandbox {
       this.logger.debug(`${LOG_PREFIX} Could not detect working directory, will omit from instructions`);
     }
   }
+  /**
+   * Look up the existing Daytona sandbox by identity WITHOUT starting it.
+   * Used for detached (cross-process) networking/stop/destroy so those
+   * operations never wake a stopped sandbox. Returns null when not found.
+   */
+  async lookupDetachedSandbox() {
+    const lookupKey = this._daytonaSandboxId ?? this.sandboxName;
+    if (!lookupKey) {
+      return null;
+    }
+    if (!this._daytona) {
+      this._daytona = new sdk.Daytona(this.connectionOpts);
+    }
+    try {
+      return await this._daytona.get(lookupKey);
+    } catch (error) {
+      if (error instanceof sdk.DaytonaNotFoundError) {
+        return null;
+      }
+      throw error;
+    }
+  }
   async findExistingSandbox() {
     const DEAD_STATES = [
       sdk.SandboxState.DESTROYED,