@mastra/deployer-sandbox 0.1.2 → 0.1.3

package/dist/studio/index.html

@@ -89,7 +89,7 @@
         connectSSE();
       })();
     </script>
-    <script type="module" crossorigin src="./assets/index-CbYta8Tj.js"></script>
+    <script type="module" crossorigin src="./assets/index-sToavS1V.js"></script>
     <link rel="modulepreload" crossorigin href="./assets/preload-helper-PPVm8Dsz.js">
     <link rel="stylesheet" crossorigin href="./assets/style-BWN25Qlo.css">
   </head>

package/dist/studio/routes-manifest.json

@@ -6,6 +6,7 @@
   "evaluation",
   "experiments",
   "integrations",
+  "intelligence",
   "login",
   "logs",
   "mcps",
@@ -17,7 +18,6 @@
   "resources",
   "scorers",
   "settings",
-  "signals",
   "signup",
   "templates",
   "tools",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/deployer-sandbox",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Deploy a Mastra server into any workspace sandbox that supports networking and get a live public URL",
   "type": "module",
   "files": [
@@ -38,7 +38,7 @@
   "license": "Apache-2.0",
   "dependencies": {
     "fs-extra": "^11.3.5",
-    "@mastra/deployer": "^1.53.0"
+    "@mastra/deployer": "^1.54.0"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",
@@ -46,13 +46,13 @@
     "@vitest/coverage-v8": "4.1.10",
     "@vitest/ui": "4.1.10",
     "eslint": "^10.4.1",
-    "tsup": "^8.5.1",
+    "tsdown": "0.22.9",
     "typescript": "^6.0.3",
     "vitest": "4.1.10",
-    "@internal/playground": "1.20.2",
-    "@internal/types-builder": "0.0.92",
-    "@mastra/core": "1.53.0",
-    "@internal/lint": "0.0.117"
+    "@internal/playground": "1.20.3",
+    "@internal/types-builder": "0.0.93",
+    "@internal/lint": "0.0.118",
+    "@mastra/core": "1.54.0"
   },
   "homepage": "https://mastra.ai",
   "repository": {
@@ -70,8 +70,8 @@
     "node": ">=22.13.0"
   },
   "scripts": {
-    "build": "tsup --silent --config tsup.config.ts",
-    "build:watch": "tsup --watch --silent --config tsup.config.ts",
+    "build": "tsdown --silent --config tsdown.config.ts",
+    "build:watch": "tsdown --watch --silent --config tsdown.config.ts",
     "test": "vitest run",
     "lint": "oxlint . && eslint .",
     "lint:fix": "oxlint --fix . && eslint --fix ."

package/dist/chunk-CSXC6CZL.cjs

@@ -1,115 +0,0 @@
-'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-Z636GNUQ.js

@@ -1,101 +0,0 @@
-// 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

@@ -1 +0,0 @@
-{"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"]}