@mastra/deployer-sandbox 0.0.0-monorepo-flexibility-20260722142608

package/CHANGELOG.md

@@ -0,0 +1,117 @@
+# @mastra/deployer-sandbox
+
+## 0.0.0-monorepo-flexibility-20260722142608
+
+### Minor Changes
+
+- New package: deploy a full Mastra server (including Studio) into any workspace sandbox that supports networking, and get a live public URL in seconds. Works with `@mastra/vercel`, `@mastra/e2b`, and `@mastra/daytona` sandboxes. Built for ephemeral environments: instant previews, PR/CI smoke deploys, agent-built app verification, and multi-tenant untrusted instances. ([#19577](https://github.com/mastra-ai/mastra/pull/19577))
+
+  **Deploy from your Mastra config**
+
+  ```typescript
+  import { Mastra } from '@mastra/core/mastra';
+  import { SandboxDeployer } from '@mastra/deployer-sandbox';
+  import { VercelSandbox } from '@mastra/vercel';
+
+  export const mastra = new Mastra({
+    deployer: new SandboxDeployer({
+      sandbox: new VercelSandbox({ sandboxName: 'my-preview', ports: [4111] }),
+    }),
+  });
+  ```
+
+  Then run `mastra build` — it bundles the project and deploys it into the sandbox in one step. Redeploys reuse the same sandbox and skip dependency installs when the install inputs (`package.json`, bundled lockfiles, and the install command) are unchanged.
+
+  **Manage the deployment**
+
+  The sandbox name is the identity — `getDeployment()` retrieves the deployment from any process or codebase, without importing the Mastra project:
+
+  ```typescript
+  import { getDeployment } from '@mastra/deployer-sandbox/client';
+  import { VercelSandbox } from '@mastra/vercel';
+
+  const dep = await getDeployment({
+    sandbox: new VercelSandbox({ sandboxName: 'my-preview', ports: [4111] }),
+  }); // never wakes a stopped sandbox
+  await dep.stop(); // snapshot-stop (resumable)
+  await dep.destroy(); // permanent delete
+  ```
+
+  **Deploy programmatically (CI / agents)**
+
+  ```typescript
+  import { deployToSandbox } from '@mastra/deployer-sandbox';
+  import { VercelSandbox } from '@mastra/vercel';
+
+  const sandbox = new VercelSandbox({ sandboxName: 'ci-preview', ports: [4111] });
+  const deployment = await deployToSandbox({ sandbox, dir: '.mastra/output' });
+  console.info(deployment.url);
+  ```
+
+  **Resolve and route at runtime**
+
+  The server-only `@mastra/deployer-sandbox/client` export includes `getDeployment()` to resolve the current URL and manage the deployment (`stop()`, `destroy()`, `logs()`, with optional wake-on-demand), plus `createSandboxHandler()` and `createSandboxProxy()` helpers to serve a sandbox behind a stable URL on your own domain.
+
+### Patch Changes
+
+- Updated dependencies [[`ec857fc`](https://github.com/mastra-ai/mastra/commit/ec857fc79c264b53b38e16478c789b7177f2ad59), [`41a5392`](https://github.com/mastra-ai/mastra/commit/41a5392d9f6c5e18d6b227f0fc0ddf49c50774e9), [`3b77e77`](https://github.com/mastra-ai/mastra/commit/3b77e7704936522e4769d29de1b5ea6901f302bd), [`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), [`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), [`74faf8b`](https://github.com/mastra-ai/mastra/commit/74faf8bd9c1018f2492653c06b1e25fc8300e9e6), [`675fbff`](https://github.com/mastra-ai/mastra/commit/675fbff84d3274391b33e852f76083c38a5514e5), [`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), [`23cf854`](https://github.com/mastra-ai/mastra/commit/23cf8547c7e92c4cb01df7b686e695c22c6831fd), [`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), [`53df41b`](https://github.com/mastra-ai/mastra/commit/53df41ba8b00438ebe5daee1b04613aa4239a5b2), [`72e437c`](https://github.com/mastra-ai/mastra/commit/72e437c515942c80b9def5b026e0bdee61b469d9), [`8f7a5de`](https://github.com/mastra-ai/mastra/commit/8f7a5dedc246cdc938bb65516703cf9b27b03756), [`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), [`eac4537`](https://github.com/mastra-ai/mastra/commit/eac453795531df0d5fe3729d80e93a91f8c1bc91), [`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), [`b4b7ea8`](https://github.com/mastra-ai/mastra/commit/b4b7ea8733f033fc441ea47ed03f6afb17ec2248), [`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), [`e3868e2`](https://github.com/mastra-ai/mastra/commit/e3868e22babfffd0133771669ca724501c2dd58e), [`3491666`](https://github.com/mastra-ai/mastra/commit/34916663c4fdd43b48c21f4ab2d5fb6dcccc94f9), [`c0bec73`](https://github.com/mastra-ai/mastra/commit/c0bec732c93d1a22ae5e51ed66cf8cacca8bd6a6)]:
+  - @mastra/core@0.0.0-monorepo-flexibility-20260722142608
+  - @mastra/deployer@0.0.0-monorepo-flexibility-20260722142608
+
+## 0.1.0-alpha.0
+
+### Minor Changes
+
+- New package: deploy a full Mastra server (including Studio) into any workspace sandbox that supports networking, and get a live public URL in seconds. Works with `@mastra/vercel`, `@mastra/e2b`, and `@mastra/daytona` sandboxes. Built for ephemeral environments: instant previews, PR/CI smoke deploys, agent-built app verification, and multi-tenant untrusted instances. ([#19577](https://github.com/mastra-ai/mastra/pull/19577))
+
+  **Deploy from your Mastra config**
+
+  ```typescript
+  import { Mastra } from '@mastra/core/mastra';
+  import { SandboxDeployer } from '@mastra/deployer-sandbox';
+  import { VercelSandbox } from '@mastra/vercel';
+
+  export const mastra = new Mastra({
+    deployer: new SandboxDeployer({
+      sandbox: new VercelSandbox({ sandboxName: 'my-preview', ports: [4111] }),
+    }),
+  });
+  ```
+
+  Then run `mastra build` — it bundles the project and deploys it into the sandbox in one step. Redeploys reuse the same sandbox and skip dependency installs when the install inputs (`package.json`, bundled lockfiles, and the install command) are unchanged.
+
+  **Manage the deployment**
+
+  The sandbox name is the identity — `getDeployment()` retrieves the deployment from any process or codebase, without importing the Mastra project:
+
+  ```typescript
+  import { getDeployment } from '@mastra/deployer-sandbox/client';
+  import { VercelSandbox } from '@mastra/vercel';
+
+  const dep = await getDeployment({
+    sandbox: new VercelSandbox({ sandboxName: 'my-preview', ports: [4111] }),
+  }); // never wakes a stopped sandbox
+  await dep.stop(); // snapshot-stop (resumable)
+  await dep.destroy(); // permanent delete
+  ```
+
+  **Deploy programmatically (CI / agents)**
+
+  ```typescript
+  import { deployToSandbox } from '@mastra/deployer-sandbox';
+  import { VercelSandbox } from '@mastra/vercel';
+
+  const sandbox = new VercelSandbox({ sandboxName: 'ci-preview', ports: [4111] });
+  const deployment = await deployToSandbox({ sandbox, dir: '.mastra/output' });
+  console.info(deployment.url);
+  ```
+
+  **Resolve and route at runtime**
+
+  The server-only `@mastra/deployer-sandbox/client` export includes `getDeployment()` to resolve the current URL and manage the deployment (`stop()`, `destroy()`, `logs()`, with optional wake-on-demand), plus `createSandboxHandler()` and `createSandboxProxy()` helpers to serve a sandbox behind a stable URL on your own domain.
+
+### 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
+  - @mastra/deployer@1.52.0-alpha.5

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/README.md

@@ -0,0 +1,72 @@
+# @mastra/deployer-sandbox
+
+Deploy a full Mastra server into any workspace sandbox that supports networking — and get a live public URL in seconds.
+
+Works with any `WorkspaceSandbox` provider that implements the core `networking` capability (Vercel Sandbox, E2B, Daytona, ...). Positioning: **ephemeral environments** — instant previews, PR/CI smoke deploys, agent-built-app verification, multi-tenant untrusted instances. Not production hosting.
+
+## Usage
+
+```typescript
+// src/mastra/index.ts
+import { Mastra } from '@mastra/core/mastra';
+import { SandboxDeployer } from '@mastra/deployer-sandbox';
+import { VercelSandbox } from '@mastra/vercel';
+
+const deployer = new SandboxDeployer({
+  sandbox: new VercelSandbox({
+    sandboxName: 'my-preview', // identity: redeploys resume this sandbox
+    timeout: 3_600_000,
+    ports: [4111],
+  }),
+});
+
+export const mastra = new Mastra({
+  // ...
+  deployer,
+});
+```
+
+```bash
+mastra build
+```
+
+`mastra build` bundles the project and deploys it into the sandbox in one step, printing the live API and Studio URLs.
+
+Manage the deployment afterward with `getDeployment()` from the server-only `client` export — the sandbox name is the identity, so this works from any process or codebase:
+
+```typescript
+import { getDeployment } from '@mastra/deployer-sandbox/client';
+import { VercelSandbox } from '@mastra/vercel';
+
+const dep = await getDeployment({
+  sandbox: new VercelSandbox({ sandboxName: 'my-preview', ports: [4111] }),
+}); // never wakes a stopped sandbox
+console.log(dep.status, dep.url);
+await dep.stop(); // snapshot-stop (resumable)
+await dep.destroy(); // permanent delete
+```
+
+Provider tooling works too (for example `vercel sandbox ls|stop|rm`).
+
+One-shot programmatic deploy (CI / agents), no bundler — takes a prebuilt output dir:
+
+```typescript
+import { deployToSandbox } from '@mastra/deployer-sandbox';
+import { VercelSandbox } from '@mastra/vercel';
+
+const sandbox = new VercelSandbox({ sandboxName: 'ci-preview', ports: [4111] });
+const deployment = await deployToSandbox({ sandbox, dir: '.mastra/output', port: 4111 });
+console.log(deployment.url);
+```
+
+Pass `wake: true` to resume a stopped sandbox before returning — useful in a route handler that fronts the sandbox. If the server isn't healthy after the resume (some providers restore the filesystem but not processes), the wake relaunches it:
+
+```typescript
+import { getDeployment } from '@mastra/deployer-sandbox/client';
+import { VercelSandbox } from '@mastra/vercel';
+
+const sandbox = new VercelSandbox({ sandboxName: 'my-preview', ports: [4111] });
+const dep = await getDeployment({ sandbox, wake: true });
+```
+
+See the Mastra docs for lifecycle, routing tiers, and security notes.

package/dist/alias.d.ts

@@ -0,0 +1,10 @@
+import type { SandboxAliasOptions } from './types.js';
+/**
+ * Upsert a Vercel Edge Config item so a stable key always points at the
+ * current sandbox URL. Used for Tier 3 routing: apps read the key from Edge
+ * Config (e.g. in middleware) instead of hardcoding the rotating sandbox URL.
+ */
+export declare function updateEdgeConfigAlias(options: SandboxAliasOptions & {
+    url: string;
+}): Promise<void>;
+//# sourceMappingURL=alias.d.ts.map

package/dist/alias.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alias.d.ts","sourceRoot":"","sources":["../src/alias.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,mBAAmB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BzG"}

package/dist/chunk-CSXC6CZL.cjs

@@ -0,0 +1,115 @@
+'use strict';
+
+// src/shared.ts
+var REMOTE_DIR_NAME = "mastra-app";
+var DEFAULT_PORT = 4111;
+var SERVER_SCRIPT = ".mastra-server.sh";
+var SERVER_PIDFILE = ".mastra-server.pid";
+var SERVER_LOGFILE = ".mastra-server.log";
+var INSTALL_MARKER = ".mastra-install-hash";
+async function getInfoSafe(sandbox) {
+  try {
+    return await sandbox.getInfo?.();
+  } catch {
+    return void 0;
+  }
+}
+async function resolveRemoteDir(sandbox, remoteDir) {
+  if (remoteDir) return remoteDir;
+  const result = await runInSandbox(sandbox, `printf %s "\${HOME:-$(pwd)}"`, { allowFailure: true });
+  const base = result.stdout.trim();
+  if (!base) {
+    throw new Error("Could not resolve the sandbox home directory. Pass `remoteDir` explicitly.");
+  }
+  return `${base}/${REMOTE_DIR_NAME}`;
+}
+function shellQuote(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+async function runInSandbox(sandbox, script, opts) {
+  if (!sandbox.executeCommand) {
+    throw new Error(
+      `Sandbox provider "${sandbox.provider}" does not support executeCommand, which is required for sandbox deploys.`
+    );
+  }
+  const result = await sandbox.executeCommand(
+    "sh",
+    ["-c", script],
+    opts?.timeout ? { timeout: opts.timeout } : void 0
+  );
+  if (!result.success && !opts?.allowFailure) {
+    const what = opts?.label ?? truncate(script, 120);
+    throw new Error(
+      `Command failed inside sandbox (exit ${result.exitCode}): ${what}
+${truncate(result.stderr || result.stdout, 4e3)}`
+    );
+  }
+  return { stdout: result.stdout, stderr: result.stderr, exitCode: result.exitCode };
+}
+function truncate(value, max) {
+  return value.length > max ? `${value.slice(0, max)}\u2026 (truncated)` : value;
+}
+async function killPreviousServer(sandbox, remoteDir) {
+  const pidfile = shellQuote(`${remoteDir}/${SERVER_PIDFILE}`);
+  const script = [
+    `if [ -f ${pidfile} ]; then`,
+    `  pid="$(cat ${pidfile})"`,
+    `  kill "$pid" 2>/dev/null || true`,
+    // Wait up to ~5s for the old server to release the port, then force-kill.
+    `  i=0`,
+    `  while kill -0 "$pid" 2>/dev/null && [ "$i" -lt 50 ]; do sleep 0.1; i=$((i + 1)); done`,
+    `  kill -9 "$pid" 2>/dev/null || true`,
+    `  rm -f ${pidfile}`,
+    `fi`
+  ].join("\n");
+  await runInSandbox(sandbox, script, { allowFailure: true, timeout: 15e3 });
+}
+async function launchServer(sandbox, remoteDir) {
+  const script = `${remoteDir}/${SERVER_SCRIPT}`;
+  await runInSandbox(sandbox, `nohup sh ${shellQuote(script)} >/dev/null 2>&1 & echo launched`);
+}
+async function tailServerLog(sandbox, remoteDir, lines = 50) {
+  const logfile = `${remoteDir}/${SERVER_LOGFILE}`;
+  const result = await runInSandbox(
+    sandbox,
+    `tail -n ${Math.floor(lines)} ${shellQuote(logfile)} 2>/dev/null || true`,
+    {
+      allowFailure: true
+    }
+  );
+  return result.stdout;
+}
+async function waitForHealthy(url, opts = {}) {
+  const path = opts.path ?? "/api";
+  const timeoutMs = opts.timeoutMs ?? 6e4;
+  const intervalMs = opts.intervalMs ?? 1e3;
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    try {
+      const res = await fetch(new URL(path, url), { signal: AbortSignal.timeout(intervalMs * 5) });
+      const providerError = res.status === 410 || res.headers.has("x-vercel-error");
+      if (res.status < 500 && !providerError) {
+        return true;
+      }
+    } catch {
+    }
+    await new Promise((resolve) => setTimeout(resolve, intervalMs));
+  }
+  return false;
+}
+
+exports.DEFAULT_PORT = DEFAULT_PORT;
+exports.INSTALL_MARKER = INSTALL_MARKER;
+exports.SERVER_LOGFILE = SERVER_LOGFILE;
+exports.SERVER_PIDFILE = SERVER_PIDFILE;
+exports.SERVER_SCRIPT = SERVER_SCRIPT;
+exports.getInfoSafe = getInfoSafe;
+exports.killPreviousServer = killPreviousServer;
+exports.launchServer = launchServer;
+exports.resolveRemoteDir = resolveRemoteDir;
+exports.runInSandbox = runInSandbox;
+exports.shellQuote = shellQuote;
+exports.tailServerLog = tailServerLog;
+exports.waitForHealthy = waitForHealthy;
+//# sourceMappingURL=chunk-CSXC6CZL.cjs.map
+//# sourceMappingURL=chunk-CSXC6CZL.cjs.map

package/dist/chunk-CSXC6CZL.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shared.ts"],"names":[],"mappings":"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","file":"chunk-CSXC6CZL.cjs","sourcesContent":["import type { SandboxInfo, WorkspaceSandbox } from '@mastra/core/workspace';\n\n/** Directory name (under the sandbox user's home) that the app is deployed into by default. */\nexport const REMOTE_DIR_NAME = 'mastra-app';\n/** Default port the Mastra server listens on. */\nexport const DEFAULT_PORT = 4111;\n/** Launch script written into the remote dir. Re-running it restarts the server (e.g. after a wake). */\nexport const SERVER_SCRIPT = '.mastra-server.sh';\n/** Pidfile written by the launch script. */\nexport const SERVER_PIDFILE = '.mastra-server.pid';\n/** Server log file inside the remote dir. */\nexport const SERVER_LOGFILE = '.mastra-server.log';\n/** Marker recording the package.json hash of the last completed dependency install. */\nexport const INSTALL_MARKER = '.mastra-install-hash';\n\n/** getInfo may be sync or async, and may throw — normalize to `undefined` on failure. */\nexport async function getInfoSafe(sandbox: WorkspaceSandbox): Promise<SandboxInfo | undefined> {\n  try {\n    return await sandbox.getInfo?.();\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Resolve the directory the app is (or will be) deployed into. Defaults to\n * `$HOME/mastra-app` resolved inside the sandbox — home directories persist\n * across snapshot stop/resume on providers that support it, unlike `/tmp`.\n * The sandbox must be running.\n */\nexport async function resolveRemoteDir(sandbox: WorkspaceSandbox, remoteDir?: string): Promise<string> {\n  if (remoteDir) return remoteDir;\n  const result = await runInSandbox(sandbox, `printf %s \"\\${HOME:-$(pwd)}\"`, { allowFailure: true });\n  const base = result.stdout.trim();\n  if (!base) {\n    throw new Error('Could not resolve the sandbox home directory. Pass `remoteDir` explicitly.');\n  }\n  return `${base}/${REMOTE_DIR_NAME}`;\n}\n\n/** Single-quote a value for POSIX shells. */\nexport function shellQuote(value: string): string {\n  return `'${value.replace(/'/g, `'\\\\''`)}'`;\n}\n\n/** Run a shell script string inside the sandbox and throw on failure. */\nexport async function runInSandbox(\n  sandbox: WorkspaceSandbox,\n  script: string,\n  opts?: {\n    allowFailure?: boolean;\n    timeout?: number;\n    /** Safe description used in error messages instead of the script itself. */\n    label?: string;\n  },\n): Promise<{ stdout: string; stderr: string; exitCode: number }> {\n  if (!sandbox.executeCommand) {\n    throw new Error(\n      `Sandbox provider \"${sandbox.provider}\" does not support executeCommand, which is required for sandbox deploys.`,\n    );\n  }\n  // Run via `sh -c` (argv style): providers pass `command` straight to their\n  // exec API as an executable, so a raw script string with spaces would fail.\n  const result = await sandbox.executeCommand(\n    'sh',\n    ['-c', script],\n    opts?.timeout ? { timeout: opts.timeout } : undefined,\n  );\n  if (!result.success && !opts?.allowFailure) {\n    // Never echo the full script back: it can contain secrets (env values)\n    // or entire base64 upload chunks. Use the label or a bounded excerpt.\n    const what = opts?.label ?? truncate(script, 120);\n    throw new Error(\n      `Command failed inside sandbox (exit ${result.exitCode}): ${what}\\n${truncate(result.stderr || result.stdout, 4_000)}`,\n    );\n  }\n  return { stdout: result.stdout, stderr: result.stderr, exitCode: result.exitCode };\n}\n\nfunction truncate(value: string, max: number): string {\n  return value.length > max ? `${value.slice(0, max)}… (truncated)` : value;\n}\n\n/**\n * Kill the previously launched server (if any) using its pidfile, waiting for\n * the process to exit (bounded, then SIGKILL) so the replacement never races\n * the old server for the port. Safe when nothing is running.\n */\nexport async function killPreviousServer(sandbox: WorkspaceSandbox, remoteDir: string): Promise<void> {\n  const pidfile = shellQuote(`${remoteDir}/${SERVER_PIDFILE}`);\n  const script = [\n    `if [ -f ${pidfile} ]; then`,\n    `  pid=\"$(cat ${pidfile})\"`,\n    `  kill \"$pid\" 2>/dev/null || true`,\n    // Wait up to ~5s for the old server to release the port, then force-kill.\n    `  i=0`,\n    `  while kill -0 \"$pid\" 2>/dev/null && [ \"$i\" -lt 50 ]; do sleep 0.1; i=$((i + 1)); done`,\n    `  kill -9 \"$pid\" 2>/dev/null || true`,\n    `  rm -f ${pidfile}`,\n    `fi`,\n  ].join('\\n');\n  await runInSandbox(sandbox, script, { allowFailure: true, timeout: 15_000 });\n}\n\n/**\n * Launch (or relaunch) the server by running the recorded launch script,\n * detached via nohup. Deliberately NOT `processes.spawn()`: provider process\n * handles follow the command's log stream, which would keep the calling\n * process's event loop alive for as long as the server runs. The server's\n * lifecycle is managed through its pidfile instead.\n */\nexport async function launchServer(sandbox: WorkspaceSandbox, remoteDir: string): Promise<void> {\n  const script = `${remoteDir}/${SERVER_SCRIPT}`;\n  await runInSandbox(sandbox, `nohup sh ${shellQuote(script)} >/dev/null 2>&1 & echo launched`);\n}\n\n/** Tail the server log from inside the sandbox. */\nexport async function tailServerLog(sandbox: WorkspaceSandbox, remoteDir: string, lines = 50): Promise<string> {\n  const logfile = `${remoteDir}/${SERVER_LOGFILE}`;\n  const result = await runInSandbox(\n    sandbox,\n    `tail -n ${Math.floor(lines)} ${shellQuote(logfile)} 2>/dev/null || true`,\n    {\n      allowFailure: true,\n    },\n  );\n  return result.stdout;\n}\n\n/**\n * Poll `${url}${path}` until the server responds. Any HTTP status below 500\n * counts as \"the server is up\" — gateway errors (502/503) mean nothing is\n * listening on the port, and 410 is what some providers (e.g. Vercel) return\n * from their edge when the sandbox itself is stopped.\n */\nexport async function waitForHealthy(\n  url: string,\n  opts: { path?: string; timeoutMs?: number; intervalMs?: number } = {},\n): Promise<boolean> {\n  const path = opts.path ?? '/api';\n  const timeoutMs = opts.timeoutMs ?? 60_000;\n  const intervalMs = opts.intervalMs ?? 1_000;\n  const deadline = Date.now() + timeoutMs;\n\n  while (Date.now() < deadline) {\n    try {\n      const res = await fetch(new URL(path, url), { signal: AbortSignal.timeout(intervalMs * 5) });\n      // A provider-edge error header means the response came from the sandbox\n      // infrastructure (stopped/unreachable VM), not from the Mastra server.\n      const providerError = res.status === 410 || res.headers.has('x-vercel-error');\n      if (res.status < 500 && !providerError) {\n        return true;\n      }\n    } catch {\n      // Not reachable yet.\n    }\n    await new Promise(resolve => setTimeout(resolve, intervalMs));\n  }\n  return false;\n}\n"]}

package/dist/chunk-Z636GNUQ.js

@@ -0,0 +1,101 @@
+// src/shared.ts
+var REMOTE_DIR_NAME = "mastra-app";
+var DEFAULT_PORT = 4111;
+var SERVER_SCRIPT = ".mastra-server.sh";
+var SERVER_PIDFILE = ".mastra-server.pid";
+var SERVER_LOGFILE = ".mastra-server.log";
+var INSTALL_MARKER = ".mastra-install-hash";
+async function getInfoSafe(sandbox) {
+  try {
+    return await sandbox.getInfo?.();
+  } catch {
+    return void 0;
+  }
+}
+async function resolveRemoteDir(sandbox, remoteDir) {
+  if (remoteDir) return remoteDir;
+  const result = await runInSandbox(sandbox, `printf %s "\${HOME:-$(pwd)}"`, { allowFailure: true });
+  const base = result.stdout.trim();
+  if (!base) {
+    throw new Error("Could not resolve the sandbox home directory. Pass `remoteDir` explicitly.");
+  }
+  return `${base}/${REMOTE_DIR_NAME}`;
+}
+function shellQuote(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+async function runInSandbox(sandbox, script, opts) {
+  if (!sandbox.executeCommand) {
+    throw new Error(
+      `Sandbox provider "${sandbox.provider}" does not support executeCommand, which is required for sandbox deploys.`
+    );
+  }
+  const result = await sandbox.executeCommand(
+    "sh",
+    ["-c", script],
+    opts?.timeout ? { timeout: opts.timeout } : void 0
+  );
+  if (!result.success && !opts?.allowFailure) {
+    const what = opts?.label ?? truncate(script, 120);
+    throw new Error(
+      `Command failed inside sandbox (exit ${result.exitCode}): ${what}
+${truncate(result.stderr || result.stdout, 4e3)}`
+    );
+  }
+  return { stdout: result.stdout, stderr: result.stderr, exitCode: result.exitCode };
+}
+function truncate(value, max) {
+  return value.length > max ? `${value.slice(0, max)}\u2026 (truncated)` : value;
+}
+async function killPreviousServer(sandbox, remoteDir) {
+  const pidfile = shellQuote(`${remoteDir}/${SERVER_PIDFILE}`);
+  const script = [
+    `if [ -f ${pidfile} ]; then`,
+    `  pid="$(cat ${pidfile})"`,
+    `  kill "$pid" 2>/dev/null || true`,
+    // Wait up to ~5s for the old server to release the port, then force-kill.
+    `  i=0`,
+    `  while kill -0 "$pid" 2>/dev/null && [ "$i" -lt 50 ]; do sleep 0.1; i=$((i + 1)); done`,
+    `  kill -9 "$pid" 2>/dev/null || true`,
+    `  rm -f ${pidfile}`,
+    `fi`
+  ].join("\n");
+  await runInSandbox(sandbox, script, { allowFailure: true, timeout: 15e3 });
+}
+async function launchServer(sandbox, remoteDir) {
+  const script = `${remoteDir}/${SERVER_SCRIPT}`;
+  await runInSandbox(sandbox, `nohup sh ${shellQuote(script)} >/dev/null 2>&1 & echo launched`);
+}
+async function tailServerLog(sandbox, remoteDir, lines = 50) {
+  const logfile = `${remoteDir}/${SERVER_LOGFILE}`;
+  const result = await runInSandbox(
+    sandbox,
+    `tail -n ${Math.floor(lines)} ${shellQuote(logfile)} 2>/dev/null || true`,
+    {
+      allowFailure: true
+    }
+  );
+  return result.stdout;
+}
+async function waitForHealthy(url, opts = {}) {
+  const path = opts.path ?? "/api";
+  const timeoutMs = opts.timeoutMs ?? 6e4;
+  const intervalMs = opts.intervalMs ?? 1e3;
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    try {
+      const res = await fetch(new URL(path, url), { signal: AbortSignal.timeout(intervalMs * 5) });
+      const providerError = res.status === 410 || res.headers.has("x-vercel-error");
+      if (res.status < 500 && !providerError) {
+        return true;
+      }
+    } catch {
+    }
+    await new Promise((resolve) => setTimeout(resolve, intervalMs));
+  }
+  return false;
+}
+
+export { DEFAULT_PORT, INSTALL_MARKER, SERVER_LOGFILE, SERVER_PIDFILE, SERVER_SCRIPT, getInfoSafe, killPreviousServer, launchServer, resolveRemoteDir, runInSandbox, shellQuote, tailServerLog, waitForHealthy };
+//# sourceMappingURL=chunk-Z636GNUQ.js.map
+//# sourceMappingURL=chunk-Z636GNUQ.js.map

package/dist/chunk-Z636GNUQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shared.ts"],"names":[],"mappings":"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","file":"chunk-Z636GNUQ.js","sourcesContent":["import type { SandboxInfo, WorkspaceSandbox } from '@mastra/core/workspace';\n\n/** Directory name (under the sandbox user's home) that the app is deployed into by default. */\nexport const REMOTE_DIR_NAME = 'mastra-app';\n/** Default port the Mastra server listens on. */\nexport const DEFAULT_PORT = 4111;\n/** Launch script written into the remote dir. Re-running it restarts the server (e.g. after a wake). */\nexport const SERVER_SCRIPT = '.mastra-server.sh';\n/** Pidfile written by the launch script. */\nexport const SERVER_PIDFILE = '.mastra-server.pid';\n/** Server log file inside the remote dir. */\nexport const SERVER_LOGFILE = '.mastra-server.log';\n/** Marker recording the package.json hash of the last completed dependency install. */\nexport const INSTALL_MARKER = '.mastra-install-hash';\n\n/** getInfo may be sync or async, and may throw — normalize to `undefined` on failure. */\nexport async function getInfoSafe(sandbox: WorkspaceSandbox): Promise<SandboxInfo | undefined> {\n  try {\n    return await sandbox.getInfo?.();\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Resolve the directory the app is (or will be) deployed into. Defaults to\n * `$HOME/mastra-app` resolved inside the sandbox — home directories persist\n * across snapshot stop/resume on providers that support it, unlike `/tmp`.\n * The sandbox must be running.\n */\nexport async function resolveRemoteDir(sandbox: WorkspaceSandbox, remoteDir?: string): Promise<string> {\n  if (remoteDir) return remoteDir;\n  const result = await runInSandbox(sandbox, `printf %s \"\\${HOME:-$(pwd)}\"`, { allowFailure: true });\n  const base = result.stdout.trim();\n  if (!base) {\n    throw new Error('Could not resolve the sandbox home directory. Pass `remoteDir` explicitly.');\n  }\n  return `${base}/${REMOTE_DIR_NAME}`;\n}\n\n/** Single-quote a value for POSIX shells. */\nexport function shellQuote(value: string): string {\n  return `'${value.replace(/'/g, `'\\\\''`)}'`;\n}\n\n/** Run a shell script string inside the sandbox and throw on failure. */\nexport async function runInSandbox(\n  sandbox: WorkspaceSandbox,\n  script: string,\n  opts?: {\n    allowFailure?: boolean;\n    timeout?: number;\n    /** Safe description used in error messages instead of the script itself. */\n    label?: string;\n  },\n): Promise<{ stdout: string; stderr: string; exitCode: number }> {\n  if (!sandbox.executeCommand) {\n    throw new Error(\n      `Sandbox provider \"${sandbox.provider}\" does not support executeCommand, which is required for sandbox deploys.`,\n    );\n  }\n  // Run via `sh -c` (argv style): providers pass `command` straight to their\n  // exec API as an executable, so a raw script string with spaces would fail.\n  const result = await sandbox.executeCommand(\n    'sh',\n    ['-c', script],\n    opts?.timeout ? { timeout: opts.timeout } : undefined,\n  );\n  if (!result.success && !opts?.allowFailure) {\n    // Never echo the full script back: it can contain secrets (env values)\n    // or entire base64 upload chunks. Use the label or a bounded excerpt.\n    const what = opts?.label ?? truncate(script, 120);\n    throw new Error(\n      `Command failed inside sandbox (exit ${result.exitCode}): ${what}\\n${truncate(result.stderr || result.stdout, 4_000)}`,\n    );\n  }\n  return { stdout: result.stdout, stderr: result.stderr, exitCode: result.exitCode };\n}\n\nfunction truncate(value: string, max: number): string {\n  return value.length > max ? `${value.slice(0, max)}… (truncated)` : value;\n}\n\n/**\n * Kill the previously launched server (if any) using its pidfile, waiting for\n * the process to exit (bounded, then SIGKILL) so the replacement never races\n * the old server for the port. Safe when nothing is running.\n */\nexport async function killPreviousServer(sandbox: WorkspaceSandbox, remoteDir: string): Promise<void> {\n  const pidfile = shellQuote(`${remoteDir}/${SERVER_PIDFILE}`);\n  const script = [\n    `if [ -f ${pidfile} ]; then`,\n    `  pid=\"$(cat ${pidfile})\"`,\n    `  kill \"$pid\" 2>/dev/null || true`,\n    // Wait up to ~5s for the old server to release the port, then force-kill.\n    `  i=0`,\n    `  while kill -0 \"$pid\" 2>/dev/null && [ \"$i\" -lt 50 ]; do sleep 0.1; i=$((i + 1)); done`,\n    `  kill -9 \"$pid\" 2>/dev/null || true`,\n    `  rm -f ${pidfile}`,\n    `fi`,\n  ].join('\\n');\n  await runInSandbox(sandbox, script, { allowFailure: true, timeout: 15_000 });\n}\n\n/**\n * Launch (or relaunch) the server by running the recorded launch script,\n * detached via nohup. Deliberately NOT `processes.spawn()`: provider process\n * handles follow the command's log stream, which would keep the calling\n * process's event loop alive for as long as the server runs. The server's\n * lifecycle is managed through its pidfile instead.\n */\nexport async function launchServer(sandbox: WorkspaceSandbox, remoteDir: string): Promise<void> {\n  const script = `${remoteDir}/${SERVER_SCRIPT}`;\n  await runInSandbox(sandbox, `nohup sh ${shellQuote(script)} >/dev/null 2>&1 & echo launched`);\n}\n\n/** Tail the server log from inside the sandbox. */\nexport async function tailServerLog(sandbox: WorkspaceSandbox, remoteDir: string, lines = 50): Promise<string> {\n  const logfile = `${remoteDir}/${SERVER_LOGFILE}`;\n  const result = await runInSandbox(\n    sandbox,\n    `tail -n ${Math.floor(lines)} ${shellQuote(logfile)} 2>/dev/null || true`,\n    {\n      allowFailure: true,\n    },\n  );\n  return result.stdout;\n}\n\n/**\n * Poll `${url}${path}` until the server responds. Any HTTP status below 500\n * counts as \"the server is up\" — gateway errors (502/503) mean nothing is\n * listening on the port, and 410 is what some providers (e.g. Vercel) return\n * from their edge when the sandbox itself is stopped.\n */\nexport async function waitForHealthy(\n  url: string,\n  opts: { path?: string; timeoutMs?: number; intervalMs?: number } = {},\n): Promise<boolean> {\n  const path = opts.path ?? '/api';\n  const timeoutMs = opts.timeoutMs ?? 60_000;\n  const intervalMs = opts.intervalMs ?? 1_000;\n  const deadline = Date.now() + timeoutMs;\n\n  while (Date.now() < deadline) {\n    try {\n      const res = await fetch(new URL(path, url), { signal: AbortSignal.timeout(intervalMs * 5) });\n      // A provider-edge error header means the response came from the sandbox\n      // infrastructure (stopped/unreachable VM), not from the Mastra server.\n      const providerError = res.status === 410 || res.headers.has('x-vercel-error');\n      if (res.status < 500 && !providerError) {\n        return true;\n      }\n    } catch {\n      // Not reachable yet.\n    }\n    await new Promise(resolve => setTimeout(resolve, intervalMs));\n  }\n  return false;\n}\n"]}