sandbox-agent 0.4.0 → 0.4.1

package/dist/providers/docker.js

@@ -1,6 +1,6 @@
 import {
   DEFAULT_SANDBOX_AGENT_IMAGE
-} from "../chunk-TWTMX66J.js";
+} from "../chunk-7BNDCDDU.js";
 
 // src/providers/docker.ts
 import Docker from "dockerode";
@@ -30,6 +30,7 @@ function docker(options = {}) {
   const client = new Docker({ socketPath: "/var/run/docker.sock" });
   return {
     name: "docker",
+    defaultCwd: "/home/sandbox",
     async create() {
       const hostPort = await getPort();
       const env = await resolveValue(options.env, []);

package/dist/providers/docker.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/providers/docker.ts"],"sourcesContent":["import Docker from \"dockerode\";\nimport getPort from \"get-port\";\nimport type { SandboxProvider } from \"./types.ts\";\nimport { DEFAULT_SANDBOX_AGENT_IMAGE } from \"./shared.ts\";\n\nconst DEFAULT_HOST = \"127.0.0.1\";\nconst DEFAULT_AGENT_PORT = 3000;\n\nexport interface DockerProviderOptions {\n  image?: string;\n  host?: string;\n  agentPort?: number;\n  env?: string[] | (() => string[] | Promise<string[]>);\n  binds?: string[] | (() => string[] | Promise<string[]>);\n  createContainerOptions?: Record<string, unknown>;\n}\n\nasync function resolveValue<T>(value: T | (() => T | Promise<T>) | undefined, fallback: T): Promise<T> {\n  if (value === undefined) {\n    return fallback;\n  }\n  if (typeof value === \"function\") {\n    return await (value as () => T | Promise<T>)();\n  }\n  return value;\n}\n\nfunction extractMappedPort(\n  inspect: { NetworkSettings?: { Ports?: Record<string, Array<{ HostPort?: string }> | null | undefined> } },\n  containerPort: number,\n): number {\n  const hostPort = inspect.NetworkSettings?.Ports?.[`${containerPort}/tcp`]?.[0]?.HostPort;\n  if (!hostPort) {\n    throw new Error(`docker sandbox-agent port ${containerPort} is not published`);\n  }\n  return Number(hostPort);\n}\n\nexport function docker(options: DockerProviderOptions = {}): SandboxProvider {\n  const image = options.image ?? DEFAULT_SANDBOX_AGENT_IMAGE;\n  const host = options.host ?? DEFAULT_HOST;\n  const agentPort = options.agentPort ?? DEFAULT_AGENT_PORT;\n  const client = new Docker({ socketPath: \"/var/run/docker.sock\" });\n\n  return {\n    name: \"docker\",\n    async create(): Promise<string> {\n      const hostPort = await getPort();\n      const env = await resolveValue(options.env, []);\n      const binds = await resolveValue(options.binds, []);\n\n      const container = await client.createContainer({\n        Image: image,\n        Cmd: [\"server\", \"--no-token\", \"--host\", \"0.0.0.0\", \"--port\", String(agentPort)],\n        Env: env,\n        ExposedPorts: { [`${agentPort}/tcp`]: {} },\n        HostConfig: {\n          AutoRemove: true,\n          Binds: binds,\n          PortBindings: {\n            [`${agentPort}/tcp`]: [{ HostPort: String(hostPort) }],\n          },\n        },\n        ...(options.createContainerOptions ?? {}),\n      });\n\n      await container.start();\n      return container.id;\n    },\n    async destroy(sandboxId: string): Promise<void> {\n      const container = client.getContainer(sandboxId);\n      try {\n        await container.stop({ t: 5 });\n      } catch {}\n      try {\n        await container.remove({ force: true });\n      } catch {}\n    },\n    async getUrl(sandboxId: string): Promise<string> {\n      const container = client.getContainer(sandboxId);\n      const hostPort = extractMappedPort(await container.inspect(), agentPort);\n      return `http://${host}:${hostPort}`;\n    },\n  };\n}\n"],"mappings":";;;;;AAAA,OAAO,YAAY;AACnB,OAAO,aAAa;AAIpB,IAAM,eAAe;AACrB,IAAM,qBAAqB;AAW3B,eAAe,aAAgB,OAA+C,UAAyB;AACrG,MAAI,UAAU,QAAW;AACvB,WAAO;AAAA,EACT;AACA,MAAI,OAAO,UAAU,YAAY;AAC/B,WAAO,MAAO,MAA+B;AAAA,EAC/C;AACA,SAAO;AACT;AAEA,SAAS,kBACP,SACA,eACQ;AACR,QAAM,WAAW,QAAQ,iBAAiB,QAAQ,GAAG,aAAa,MAAM,IAAI,CAAC,GAAG;AAChF,MAAI,CAAC,UAAU;AACb,UAAM,IAAI,MAAM,6BAA6B,aAAa,mBAAmB;AAAA,EAC/E;AACA,SAAO,OAAO,QAAQ;AACxB;AAEO,SAAS,OAAO,UAAiC,CAAC,GAAoB;AAC3E,QAAM,QAAQ,QAAQ,SAAS;AAC/B,QAAM,OAAO,QAAQ,QAAQ;AAC7B,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,SAAS,IAAI,OAAO,EAAE,YAAY,uBAAuB,CAAC;AAEhE,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,SAA0B;AAC9B,YAAM,WAAW,MAAM,QAAQ;AAC/B,YAAM,MAAM,MAAM,aAAa,QAAQ,KAAK,CAAC,CAAC;AAC9C,YAAM,QAAQ,MAAM,aAAa,QAAQ,OAAO,CAAC,CAAC;AAElD,YAAM,YAAY,MAAM,OAAO,gBAAgB;AAAA,QAC7C,OAAO;AAAA,QACP,KAAK,CAAC,UAAU,cAAc,UAAU,WAAW,UAAU,OAAO,SAAS,CAAC;AAAA,QAC9E,KAAK;AAAA,QACL,cAAc,EAAE,CAAC,GAAG,SAAS,MAAM,GAAG,CAAC,EAAE;AAAA,QACzC,YAAY;AAAA,UACV,YAAY;AAAA,UACZ,OAAO;AAAA,UACP,cAAc;AAAA,YACZ,CAAC,GAAG,SAAS,MAAM,GAAG,CAAC,EAAE,UAAU,OAAO,QAAQ,EAAE,CAAC;AAAA,UACvD;AAAA,QACF;AAAA,QACA,GAAI,QAAQ,0BAA0B,CAAC;AAAA,MACzC,CAAC;AAED,YAAM,UAAU,MAAM;AACtB,aAAO,UAAU;AAAA,IACnB;AAAA,IACA,MAAM,QAAQ,WAAkC;AAC9C,YAAM,YAAY,OAAO,aAAa,SAAS;AAC/C,UAAI;AACF,cAAM,UAAU,KAAK,EAAE,GAAG,EAAE,CAAC;AAAA,MAC/B,QAAQ;AAAA,MAAC;AACT,UAAI;AACF,cAAM,UAAU,OAAO,EAAE,OAAO,KAAK,CAAC;AAAA,MACxC,QAAQ;AAAA,MAAC;AAAA,IACX;AAAA,IACA,MAAM,OAAO,WAAoC;AAC/C,YAAM,YAAY,OAAO,aAAa,SAAS;AAC/C,YAAM,WAAW,kBAAkB,MAAM,UAAU,QAAQ,GAAG,SAAS;AACvE,aAAO,UAAU,IAAI,IAAI,QAAQ;AAAA,IACnC;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/providers/docker.ts"],"sourcesContent":["import Docker from \"dockerode\";\nimport getPort from \"get-port\";\nimport type { SandboxProvider } from \"./types.ts\";\nimport { DEFAULT_SANDBOX_AGENT_IMAGE } from \"./shared.ts\";\n\nconst DEFAULT_HOST = \"127.0.0.1\";\nconst DEFAULT_AGENT_PORT = 3000;\n\nexport interface DockerProviderOptions {\n  image?: string;\n  host?: string;\n  agentPort?: number;\n  env?: string[] | (() => string[] | Promise<string[]>);\n  binds?: string[] | (() => string[] | Promise<string[]>);\n  createContainerOptions?: Record<string, unknown>;\n}\n\nasync function resolveValue<T>(value: T | (() => T | Promise<T>) | undefined, fallback: T): Promise<T> {\n  if (value === undefined) {\n    return fallback;\n  }\n  if (typeof value === \"function\") {\n    return await (value as () => T | Promise<T>)();\n  }\n  return value;\n}\n\nfunction extractMappedPort(\n  inspect: { NetworkSettings?: { Ports?: Record<string, Array<{ HostPort?: string }> | null | undefined> } },\n  containerPort: number,\n): number {\n  const hostPort = inspect.NetworkSettings?.Ports?.[`${containerPort}/tcp`]?.[0]?.HostPort;\n  if (!hostPort) {\n    throw new Error(`docker sandbox-agent port ${containerPort} is not published`);\n  }\n  return Number(hostPort);\n}\n\nexport function docker(options: DockerProviderOptions = {}): SandboxProvider {\n  const image = options.image ?? DEFAULT_SANDBOX_AGENT_IMAGE;\n  const host = options.host ?? DEFAULT_HOST;\n  const agentPort = options.agentPort ?? DEFAULT_AGENT_PORT;\n  const client = new Docker({ socketPath: \"/var/run/docker.sock\" });\n\n  return {\n    name: \"docker\",\n    defaultCwd: \"/home/sandbox\",\n    async create(): Promise<string> {\n      const hostPort = await getPort();\n      const env = await resolveValue(options.env, []);\n      const binds = await resolveValue(options.binds, []);\n\n      const container = await client.createContainer({\n        Image: image,\n        Cmd: [\"server\", \"--no-token\", \"--host\", \"0.0.0.0\", \"--port\", String(agentPort)],\n        Env: env,\n        ExposedPorts: { [`${agentPort}/tcp`]: {} },\n        HostConfig: {\n          AutoRemove: true,\n          Binds: binds,\n          PortBindings: {\n            [`${agentPort}/tcp`]: [{ HostPort: String(hostPort) }],\n          },\n        },\n        ...(options.createContainerOptions ?? {}),\n      });\n\n      await container.start();\n      return container.id;\n    },\n    async destroy(sandboxId: string): Promise<void> {\n      const container = client.getContainer(sandboxId);\n      try {\n        await container.stop({ t: 5 });\n      } catch {}\n      try {\n        await container.remove({ force: true });\n      } catch {}\n    },\n    async getUrl(sandboxId: string): Promise<string> {\n      const container = client.getContainer(sandboxId);\n      const hostPort = extractMappedPort(await container.inspect(), agentPort);\n      return `http://${host}:${hostPort}`;\n    },\n  };\n}\n"],"mappings":";;;;;AAAA,OAAO,YAAY;AACnB,OAAO,aAAa;AAIpB,IAAM,eAAe;AACrB,IAAM,qBAAqB;AAW3B,eAAe,aAAgB,OAA+C,UAAyB;AACrG,MAAI,UAAU,QAAW;AACvB,WAAO;AAAA,EACT;AACA,MAAI,OAAO,UAAU,YAAY;AAC/B,WAAO,MAAO,MAA+B;AAAA,EAC/C;AACA,SAAO;AACT;AAEA,SAAS,kBACP,SACA,eACQ;AACR,QAAM,WAAW,QAAQ,iBAAiB,QAAQ,GAAG,aAAa,MAAM,IAAI,CAAC,GAAG;AAChF,MAAI,CAAC,UAAU;AACb,UAAM,IAAI,MAAM,6BAA6B,aAAa,mBAAmB;AAAA,EAC/E;AACA,SAAO,OAAO,QAAQ;AACxB;AAEO,SAAS,OAAO,UAAiC,CAAC,GAAoB;AAC3E,QAAM,QAAQ,QAAQ,SAAS;AAC/B,QAAM,OAAO,QAAQ,QAAQ;AAC7B,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,SAAS,IAAI,OAAO,EAAE,YAAY,uBAAuB,CAAC;AAEhE,SAAO;AAAA,IACL,MAAM;AAAA,IACN,YAAY;AAAA,IACZ,MAAM,SAA0B;AAC9B,YAAM,WAAW,MAAM,QAAQ;AAC/B,YAAM,MAAM,MAAM,aAAa,QAAQ,KAAK,CAAC,CAAC;AAC9C,YAAM,QAAQ,MAAM,aAAa,QAAQ,OAAO,CAAC,CAAC;AAElD,YAAM,YAAY,MAAM,OAAO,gBAAgB;AAAA,QAC7C,OAAO;AAAA,QACP,KAAK,CAAC,UAAU,cAAc,UAAU,WAAW,UAAU,OAAO,SAAS,CAAC;AAAA,QAC9E,KAAK;AAAA,QACL,cAAc,EAAE,CAAC,GAAG,SAAS,MAAM,GAAG,CAAC,EAAE;AAAA,QACzC,YAAY;AAAA,UACV,YAAY;AAAA,UACZ,OAAO;AAAA,UACP,cAAc;AAAA,YACZ,CAAC,GAAG,SAAS,MAAM,GAAG,CAAC,EAAE,UAAU,OAAO,QAAQ,EAAE,CAAC;AAAA,UACvD;AAAA,QACF;AAAA,QACA,GAAI,QAAQ,0BAA0B,CAAC;AAAA,MACzC,CAAC;AAED,YAAM,UAAU,MAAM;AACtB,aAAO,UAAU;AAAA,IACnB;AAAA,IACA,MAAM,QAAQ,WAAkC;AAC9C,YAAM,YAAY,OAAO,aAAa,SAAS;AAC/C,UAAI;AACF,cAAM,UAAU,KAAK,EAAE,GAAG,EAAE,CAAC;AAAA,MAC/B,QAAQ;AAAA,MAAC;AACT,UAAI;AACF,cAAM,UAAU,OAAO,EAAE,OAAO,KAAK,CAAC;AAAA,MACxC,QAAQ;AAAA,MAAC;AAAA,IACX;AAAA,IACA,MAAM,OAAO,WAAoC;AAC/C,YAAM,YAAY,OAAO,aAAa,SAAS;AAC/C,YAAM,WAAW,kBAAkB,MAAM,UAAU,QAAQ,GAAG,SAAS;AACvE,aAAO,UAAU,IAAI,IAAI,QAAQ;AAAA,IACnC;AAAA,EACF;AACF;","names":[]}

package/dist/providers/e2b.d.ts

@@ -1,9 +1,16 @@
-import { S as SandboxProvider } from '../types-DLlJOfyX.js';
+import { SandboxBetaCreateOpts, SandboxConnectOpts } from '@e2b/code-interpreter';
+import { S as SandboxProvider } from '../types-DdcvY5CI.js';
 
+type E2BCreateOverrides = Omit<Partial<SandboxBetaCreateOpts>, "timeoutMs" | "autoPause">;
+type E2BConnectOverrides = Omit<Partial<SandboxConnectOpts>, "timeoutMs">;
+type E2BTemplateOverride = string | (() => string | Promise<string>);
 interface E2BProviderOptions {
-    create?: Record<string, unknown> | (() => Record<string, unknown> | Promise<Record<string, unknown>>);
-    connect?: Record<string, unknown> | ((sandboxId: string) => Record<string, unknown> | Promise<Record<string, unknown>>);
+    create?: E2BCreateOverrides | (() => E2BCreateOverrides | Promise<E2BCreateOverrides>);
+    connect?: E2BConnectOverrides | ((sandboxId: string) => E2BConnectOverrides | Promise<E2BConnectOverrides>);
+    template?: E2BTemplateOverride;
     agentPort?: number;
+    timeoutMs?: number;
+    autoPause?: boolean;
 }
 declare function e2b(options?: E2BProviderOptions): SandboxProvider;
 

package/dist/providers/e2b.js

@@ -1,11 +1,16 @@
+import {
+  SandboxDestroyedError
+} from "../chunk-TVCDKGSM.js";
 import {
   DEFAULT_AGENTS,
   SANDBOX_AGENT_INSTALL_SCRIPT
-} from "../chunk-TWTMX66J.js";
+} from "../chunk-7BNDCDDU.js";
 
 // src/providers/e2b.ts
-import { Sandbox } from "@e2b/code-interpreter";
+import { NotFoundError, Sandbox } from "@e2b/code-interpreter";
 var DEFAULT_AGENT_PORT = 3e3;
+var DEFAULT_TIMEOUT_MS = 36e5;
+var SANDBOX_AGENT_PATH_EXPORT = 'export PATH="/usr/local/bin:$HOME/.local/bin:$PATH"';
 async function resolveOptions(value, sandboxId) {
   if (!value) return {};
   if (typeof value === "function") {
@@ -16,40 +21,80 @@ async function resolveOptions(value, sandboxId) {
   }
   return value;
 }
+async function resolveTemplate(value) {
+  if (!value) return void 0;
+  return typeof value === "function" ? await value() : value;
+}
+function buildShellCommand(command, strict = false) {
+  const strictPrefix = strict ? "set -euo pipefail; " : "";
+  return `bash -lc '${strictPrefix}${SANDBOX_AGENT_PATH_EXPORT}; ${command}'`;
+}
 function e2b(options = {}) {
   const agentPort = options.agentPort ?? DEFAULT_AGENT_PORT;
+  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  const autoPause = options.autoPause ?? true;
   return {
     name: "e2b",
+    defaultCwd: "/home/user",
     async create() {
       const createOpts = await resolveOptions(options.create);
-      const sandbox = await Sandbox.create({ allowInternetAccess: true, ...createOpts });
-      await sandbox.commands.run(`curl -fsSL ${SANDBOX_AGENT_INSTALL_SCRIPT} | sh`).then((r) => {
+      const rawTemplate = typeof createOpts.template === "string" ? createOpts.template : void 0;
+      const restCreateOpts = { ...createOpts };
+      delete restCreateOpts.template;
+      const template = await resolveTemplate(options.template) ?? rawTemplate;
+      const sandbox = template ? (
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        await Sandbox.betaCreate(template, { allowInternetAccess: true, ...restCreateOpts, timeoutMs, autoPause })
+      ) : (
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        await Sandbox.betaCreate({ allowInternetAccess: true, ...restCreateOpts, timeoutMs, autoPause })
+      );
+      await sandbox.commands.run(buildShellCommand(`curl -fsSL ${SANDBOX_AGENT_INSTALL_SCRIPT} | sh`, true)).then((r) => {
         if (r.exitCode !== 0) throw new Error(`e2b install failed:
 ${r.stderr}`);
       });
       for (const agent of DEFAULT_AGENTS) {
-        await sandbox.commands.run(`sandbox-agent install-agent ${agent}`).then((r) => {
+        await sandbox.commands.run(buildShellCommand(`sandbox-agent install-agent ${agent}`)).then((r) => {
           if (r.exitCode !== 0) throw new Error(`e2b agent install failed: ${agent}
 ${r.stderr}`);
         });
       }
-      await sandbox.commands.run(`sandbox-agent server --no-token --host 0.0.0.0 --port ${agentPort}`, { background: true, timeoutMs: 0 });
+      await sandbox.commands.run(buildShellCommand(`sandbox-agent server --no-token --host 0.0.0.0 --port ${agentPort}`), { background: true, timeoutMs: 0 });
       return sandbox.sandboxId;
     },
     async destroy(sandboxId) {
+      await this.pause?.(sandboxId);
+    },
+    async reconnect(sandboxId) {
+      const connectOpts = await resolveOptions(options.connect, sandboxId);
+      try {
+        await Sandbox.connect(sandboxId, { ...connectOpts, timeoutMs });
+      } catch (error) {
+        if (error instanceof NotFoundError) {
+          throw new SandboxDestroyedError(sandboxId, "e2b", { cause: error });
+        }
+        throw error;
+      }
+    },
+    async pause(sandboxId) {
+      const connectOpts = await resolveOptions(options.connect, sandboxId);
+      const sandbox = await Sandbox.connect(sandboxId, { ...connectOpts, timeoutMs });
+      await sandbox.betaPause();
+    },
+    async kill(sandboxId) {
       const connectOpts = await resolveOptions(options.connect, sandboxId);
-      const sandbox = await Sandbox.connect(sandboxId, connectOpts);
+      const sandbox = await Sandbox.connect(sandboxId, { ...connectOpts, timeoutMs });
       await sandbox.kill();
     },
     async getUrl(sandboxId) {
       const connectOpts = await resolveOptions(options.connect, sandboxId);
-      const sandbox = await Sandbox.connect(sandboxId, connectOpts);
+      const sandbox = await Sandbox.connect(sandboxId, { ...connectOpts, timeoutMs });
       return `https://${sandbox.getHost(agentPort)}`;
     },
     async ensureServer(sandboxId) {
       const connectOpts = await resolveOptions(options.connect, sandboxId);
-      const sandbox = await Sandbox.connect(sandboxId, connectOpts);
-      await sandbox.commands.run(`sandbox-agent server --no-token --host 0.0.0.0 --port ${agentPort}`, { background: true, timeoutMs: 0 });
+      const sandbox = await Sandbox.connect(sandboxId, { ...connectOpts, timeoutMs });
+      await sandbox.commands.run(buildShellCommand(`sandbox-agent server --no-token --host 0.0.0.0 --port ${agentPort}`), { background: true, timeoutMs: 0 });
     }
   };
 }

package/dist/providers/e2b.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/providers/e2b.ts"],"sourcesContent":["import { Sandbox } from \"@e2b/code-interpreter\";\nimport type { SandboxProvider } from \"./types.ts\";\nimport { DEFAULT_AGENTS, SANDBOX_AGENT_INSTALL_SCRIPT } from \"./shared.ts\";\n\nconst DEFAULT_AGENT_PORT = 3000;\n\nexport interface E2BProviderOptions {\n  create?: Record<string, unknown> | (() => Record<string, unknown> | Promise<Record<string, unknown>>);\n  connect?: Record<string, unknown> | ((sandboxId: string) => Record<string, unknown> | Promise<Record<string, unknown>>);\n  agentPort?: number;\n}\n\nasync function resolveOptions(value: E2BProviderOptions[\"create\"] | E2BProviderOptions[\"connect\"], sandboxId?: string): Promise<Record<string, unknown>> {\n  if (!value) return {};\n  if (typeof value === \"function\") {\n    if (sandboxId) {\n      return await (value as (id: string) => Record<string, unknown> | Promise<Record<string, unknown>>)(sandboxId);\n    }\n    return await (value as () => Record<string, unknown> | Promise<Record<string, unknown>>)();\n  }\n  return value;\n}\n\nexport function e2b(options: E2BProviderOptions = {}): SandboxProvider {\n  const agentPort = options.agentPort ?? DEFAULT_AGENT_PORT;\n\n  return {\n    name: \"e2b\",\n    async create(): Promise<string> {\n      const createOpts = await resolveOptions(options.create);\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const sandbox = await Sandbox.create({ allowInternetAccess: true, ...createOpts } as any);\n\n      await sandbox.commands.run(`curl -fsSL ${SANDBOX_AGENT_INSTALL_SCRIPT} | sh`).then((r) => {\n        if (r.exitCode !== 0) throw new Error(`e2b install failed:\\n${r.stderr}`);\n      });\n      for (const agent of DEFAULT_AGENTS) {\n        await sandbox.commands.run(`sandbox-agent install-agent ${agent}`).then((r) => {\n          if (r.exitCode !== 0) throw new Error(`e2b agent install failed: ${agent}\\n${r.stderr}`);\n        });\n      }\n      await sandbox.commands.run(`sandbox-agent server --no-token --host 0.0.0.0 --port ${agentPort}`, { background: true, timeoutMs: 0 });\n\n      return sandbox.sandboxId;\n    },\n    async destroy(sandboxId: string): Promise<void> {\n      const connectOpts = await resolveOptions(options.connect, sandboxId);\n      const sandbox = await Sandbox.connect(sandboxId, connectOpts as any);\n      await sandbox.kill();\n    },\n    async getUrl(sandboxId: string): Promise<string> {\n      const connectOpts = await resolveOptions(options.connect, sandboxId);\n      const sandbox = await Sandbox.connect(sandboxId, connectOpts as any);\n      return `https://${sandbox.getHost(agentPort)}`;\n    },\n    async ensureServer(sandboxId: string): Promise<void> {\n      const connectOpts = await resolveOptions(options.connect, sandboxId);\n      const sandbox = await Sandbox.connect(sandboxId, connectOpts as any);\n      await sandbox.commands.run(`sandbox-agent server --no-token --host 0.0.0.0 --port ${agentPort}`, { background: true, timeoutMs: 0 });\n    },\n  };\n}\n"],"mappings":";;;;;;AAAA,SAAS,eAAe;AAIxB,IAAM,qBAAqB;AAQ3B,eAAe,eAAe,OAAqE,WAAsD;AACvJ,MAAI,CAAC,MAAO,QAAO,CAAC;AACpB,MAAI,OAAO,UAAU,YAAY;AAC/B,QAAI,WAAW;AACb,aAAO,MAAO,MAAqF,SAAS;AAAA,IAC9G;AACA,WAAO,MAAO,MAA2E;AAAA,EAC3F;AACA,SAAO;AACT;AAEO,SAAS,IAAI,UAA8B,CAAC,GAAoB;AACrE,QAAM,YAAY,QAAQ,aAAa;AAEvC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,SAA0B;AAC9B,YAAM,aAAa,MAAM,eAAe,QAAQ,MAAM;AAEtD,YAAM,UAAU,MAAM,QAAQ,OAAO,EAAE,qBAAqB,MAAM,GAAG,WAAW,CAAQ;AAExF,YAAM,QAAQ,SAAS,IAAI,cAAc,4BAA4B,OAAO,EAAE,KAAK,CAAC,MAAM;AACxF,YAAI,EAAE,aAAa,EAAG,OAAM,IAAI,MAAM;AAAA,EAAwB,EAAE,MAAM,EAAE;AAAA,MAC1E,CAAC;AACD,iBAAW,SAAS,gBAAgB;AAClC,cAAM,QAAQ,SAAS,IAAI,+BAA+B,KAAK,EAAE,EAAE,KAAK,CAAC,MAAM;AAC7E,cAAI,EAAE,aAAa,EAAG,OAAM,IAAI,MAAM,6BAA6B,KAAK;AAAA,EAAK,EAAE,MAAM,EAAE;AAAA,QACzF,CAAC;AAAA,MACH;AACA,YAAM,QAAQ,SAAS,IAAI,yDAAyD,SAAS,IAAI,EAAE,YAAY,MAAM,WAAW,EAAE,CAAC;AAEnI,aAAO,QAAQ;AAAA,IACjB;AAAA,IACA,MAAM,QAAQ,WAAkC;AAC9C,YAAM,cAAc,MAAM,eAAe,QAAQ,SAAS,SAAS;AACnE,YAAM,UAAU,MAAM,QAAQ,QAAQ,WAAW,WAAkB;AACnE,YAAM,QAAQ,KAAK;AAAA,IACrB;AAAA,IACA,MAAM,OAAO,WAAoC;AAC/C,YAAM,cAAc,MAAM,eAAe,QAAQ,SAAS,SAAS;AACnE,YAAM,UAAU,MAAM,QAAQ,QAAQ,WAAW,WAAkB;AACnE,aAAO,WAAW,QAAQ,QAAQ,SAAS,CAAC;AAAA,IAC9C;AAAA,IACA,MAAM,aAAa,WAAkC;AACnD,YAAM,cAAc,MAAM,eAAe,QAAQ,SAAS,SAAS;AACnE,YAAM,UAAU,MAAM,QAAQ,QAAQ,WAAW,WAAkB;AACnE,YAAM,QAAQ,SAAS,IAAI,yDAAyD,SAAS,IAAI,EAAE,YAAY,MAAM,WAAW,EAAE,CAAC;AAAA,IACrI;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/providers/e2b.ts"],"sourcesContent":["import { NotFoundError, Sandbox, type SandboxBetaCreateOpts, type SandboxConnectOpts } from \"@e2b/code-interpreter\";\nimport { SandboxDestroyedError } from \"../client.ts\";\nimport type { SandboxProvider } from \"./types.ts\";\nimport { DEFAULT_AGENTS, SANDBOX_AGENT_INSTALL_SCRIPT } from \"./shared.ts\";\n\nconst DEFAULT_AGENT_PORT = 3000;\nconst DEFAULT_TIMEOUT_MS = 3_600_000;\nconst SANDBOX_AGENT_PATH_EXPORT = 'export PATH=\"/usr/local/bin:$HOME/.local/bin:$PATH\"';\n\ntype E2BCreateOverrides = Omit<Partial<SandboxBetaCreateOpts>, \"timeoutMs\" | \"autoPause\">;\ntype E2BConnectOverrides = Omit<Partial<SandboxConnectOpts>, \"timeoutMs\">;\ntype E2BTemplateOverride = string | (() => string | Promise<string>);\n\nexport interface E2BProviderOptions {\n  create?: E2BCreateOverrides | (() => E2BCreateOverrides | Promise<E2BCreateOverrides>);\n  connect?: E2BConnectOverrides | ((sandboxId: string) => E2BConnectOverrides | Promise<E2BConnectOverrides>);\n  template?: E2BTemplateOverride;\n  agentPort?: number;\n  timeoutMs?: number;\n  autoPause?: boolean;\n}\n\nasync function resolveOptions(value: E2BProviderOptions[\"create\"] | E2BProviderOptions[\"connect\"], sandboxId?: string): Promise<Record<string, unknown>> {\n  if (!value) return {};\n  if (typeof value === \"function\") {\n    if (sandboxId) {\n      return await (value as (id: string) => Record<string, unknown> | Promise<Record<string, unknown>>)(sandboxId);\n    }\n    return await (value as () => Record<string, unknown> | Promise<Record<string, unknown>>)();\n  }\n  return value;\n}\n\nasync function resolveTemplate(value: E2BTemplateOverride | undefined): Promise<string | undefined> {\n  if (!value) return undefined;\n  return typeof value === \"function\" ? await value() : value;\n}\n\nfunction buildShellCommand(command: string, strict = false): string {\n  const strictPrefix = strict ? \"set -euo pipefail; \" : \"\";\n  return `bash -lc '${strictPrefix}${SANDBOX_AGENT_PATH_EXPORT}; ${command}'`;\n}\n\nexport function e2b(options: E2BProviderOptions = {}): SandboxProvider {\n  const agentPort = options.agentPort ?? DEFAULT_AGENT_PORT;\n  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const autoPause = options.autoPause ?? true;\n\n  return {\n    name: \"e2b\",\n    defaultCwd: \"/home/user\",\n    async create(): Promise<string> {\n      const createOpts = await resolveOptions(options.create);\n      const rawTemplate = typeof createOpts.template === \"string\" ? createOpts.template : undefined;\n      const restCreateOpts = { ...createOpts };\n      delete restCreateOpts.template;\n      const template = (await resolveTemplate(options.template)) ?? rawTemplate;\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const sandbox = template\n        ? // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          await Sandbox.betaCreate(template, { allowInternetAccess: true, ...restCreateOpts, timeoutMs, autoPause } as any)\n        : // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          await Sandbox.betaCreate({ allowInternetAccess: true, ...restCreateOpts, timeoutMs, autoPause } as any);\n\n      await sandbox.commands.run(buildShellCommand(`curl -fsSL ${SANDBOX_AGENT_INSTALL_SCRIPT} | sh`, true)).then((r) => {\n        if (r.exitCode !== 0) throw new Error(`e2b install failed:\\n${r.stderr}`);\n      });\n      for (const agent of DEFAULT_AGENTS) {\n        await sandbox.commands.run(buildShellCommand(`sandbox-agent install-agent ${agent}`)).then((r) => {\n          if (r.exitCode !== 0) throw new Error(`e2b agent install failed: ${agent}\\n${r.stderr}`);\n        });\n      }\n      await sandbox.commands.run(buildShellCommand(`sandbox-agent server --no-token --host 0.0.0.0 --port ${agentPort}`), { background: true, timeoutMs: 0 });\n\n      return sandbox.sandboxId;\n    },\n    async destroy(sandboxId: string): Promise<void> {\n      await this.pause?.(sandboxId);\n    },\n    async reconnect(sandboxId: string): Promise<void> {\n      const connectOpts = await resolveOptions(options.connect, sandboxId);\n      try {\n        await Sandbox.connect(sandboxId, { ...connectOpts, timeoutMs } as SandboxConnectOpts);\n      } catch (error) {\n        if (error instanceof NotFoundError) {\n          throw new SandboxDestroyedError(sandboxId, \"e2b\", { cause: error });\n        }\n        throw error;\n      }\n    },\n    async pause(sandboxId: string): Promise<void> {\n      const connectOpts = await resolveOptions(options.connect, sandboxId);\n      const sandbox = await Sandbox.connect(sandboxId, { ...connectOpts, timeoutMs } as SandboxConnectOpts);\n      await sandbox.betaPause();\n    },\n    async kill(sandboxId: string): Promise<void> {\n      const connectOpts = await resolveOptions(options.connect, sandboxId);\n      const sandbox = await Sandbox.connect(sandboxId, { ...connectOpts, timeoutMs } as SandboxConnectOpts);\n      await sandbox.kill();\n    },\n    async getUrl(sandboxId: string): Promise<string> {\n      const connectOpts = await resolveOptions(options.connect, sandboxId);\n      const sandbox = await Sandbox.connect(sandboxId, { ...connectOpts, timeoutMs } as SandboxConnectOpts);\n      return `https://${sandbox.getHost(agentPort)}`;\n    },\n    async ensureServer(sandboxId: string): Promise<void> {\n      const connectOpts = await resolveOptions(options.connect, sandboxId);\n      const sandbox = await Sandbox.connect(sandboxId, { ...connectOpts, timeoutMs } as SandboxConnectOpts);\n      await sandbox.commands.run(buildShellCommand(`sandbox-agent server --no-token --host 0.0.0.0 --port ${agentPort}`), { background: true, timeoutMs: 0 });\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/providers/local.d.ts

@@ -1,5 +1,5 @@
 import { S as SandboxAgentSpawnLogMode } from '../spawn-76JDF5d3.js';
-import { S as SandboxProvider } from '../types-DLlJOfyX.js';
+import { S as SandboxProvider } from '../types-DdcvY5CI.js';
 
 interface LocalProviderOptions {
     host?: string;

package/dist/providers/modal.d.ts

@@ -1,11 +1,14 @@
-import { S as SandboxProvider } from '../types-DLlJOfyX.js';
+import { SandboxCreateParams, Image } from 'modal';
+import { S as SandboxProvider } from '../types-DdcvY5CI.js';
 
+type ModalCreateOverrides = Omit<Partial<SandboxCreateParams>, "secrets" | "encryptedPorts"> & {
+    secrets?: Record<string, string>;
+    encryptedPorts?: number[];
+    appName?: string;
+};
 interface ModalProviderOptions {
-    create?: {
-        secrets?: Record<string, string>;
-        appName?: string;
-        memoryMiB?: number;
-    };
+    create?: ModalCreateOverrides | (() => ModalCreateOverrides | Promise<ModalCreateOverrides>);
+    image?: string | Image;
     agentPort?: number;
 }
 declare function modal(options?: ModalProviderOptions): SandboxProvider;

package/dist/providers/modal.js

@@ -1,34 +1,40 @@
 import {
-  DEFAULT_AGENTS,
-  SANDBOX_AGENT_INSTALL_SCRIPT
-} from "../chunk-TWTMX66J.js";
+  DEFAULT_SANDBOX_AGENT_IMAGE
+} from "../chunk-7BNDCDDU.js";
 
 // src/providers/modal.ts
 import { ModalClient } from "modal";
 var DEFAULT_AGENT_PORT = 3e3;
 var DEFAULT_APP_NAME = "sandbox-agent";
 var DEFAULT_MEMORY_MIB = 2048;
+async function resolveCreateOptions(value) {
+  if (!value) return {};
+  return typeof value === "function" ? await value() : value;
+}
 function modal(options = {}) {
   const agentPort = options.agentPort ?? DEFAULT_AGENT_PORT;
-  const appName = options.create?.appName ?? DEFAULT_APP_NAME;
-  const memoryMiB = options.create?.memoryMiB ?? DEFAULT_MEMORY_MIB;
   const client = new ModalClient();
   return {
     name: "modal",
+    defaultCwd: "/root",
     async create() {
+      const createOpts = await resolveCreateOptions(options.create);
+      const appName = createOpts.appName ?? DEFAULT_APP_NAME;
+      const baseImage = options.image ?? DEFAULT_SANDBOX_AGENT_IMAGE;
       const app = await client.apps.fromName(appName, { createIfMissing: true });
-      const installAgentCmds = DEFAULT_AGENTS.map((agent) => `RUN sandbox-agent install-agent ${agent}`);
-      const image = client.images.fromRegistry("node:22-slim").dockerfileCommands([
-        "RUN apt-get update && apt-get install -y curl ca-certificates && rm -rf /var/lib/apt/lists/*",
-        `RUN curl -fsSL ${SANDBOX_AGENT_INSTALL_SCRIPT} | sh`,
-        ...installAgentCmds
-      ]);
-      const envVars = options.create?.secrets ?? {};
+      const image = typeof baseImage === "string" ? client.images.fromRegistry(baseImage) : baseImage;
+      const envVars = createOpts.secrets ?? {};
       const secrets = Object.keys(envVars).length > 0 ? [await client.secrets.fromObject(envVars)] : [];
+      const sandboxCreateOpts = { ...createOpts };
+      delete sandboxCreateOpts.appName;
+      delete sandboxCreateOpts.secrets;
+      const extraPorts = createOpts.encryptedPorts ?? [];
+      delete sandboxCreateOpts.encryptedPorts;
       const sb = await client.sandboxes.create(app, image, {
-        encryptedPorts: [agentPort],
+        ...sandboxCreateOpts,
+        encryptedPorts: [agentPort, ...extraPorts],
         secrets,
-        memoryMiB
+        memoryMiB: sandboxCreateOpts.memoryMiB ?? DEFAULT_MEMORY_MIB
       });
       sb.exec(["sandbox-agent", "server", "--no-token", "--host", "0.0.0.0", "--port", String(agentPort)]);
       return sb.sandboxId;

package/dist/providers/modal.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/providers/modal.ts"],"sourcesContent":["import { ModalClient } from \"modal\";\nimport type { SandboxProvider } from \"./types.ts\";\nimport { DEFAULT_AGENTS, SANDBOX_AGENT_INSTALL_SCRIPT } from \"./shared.ts\";\n\nconst DEFAULT_AGENT_PORT = 3000;\nconst DEFAULT_APP_NAME = \"sandbox-agent\";\nconst DEFAULT_MEMORY_MIB = 2048;\n\nexport interface ModalProviderOptions {\n  create?: {\n    secrets?: Record<string, string>;\n    appName?: string;\n    memoryMiB?: number;\n  };\n  agentPort?: number;\n}\n\nexport function modal(options: ModalProviderOptions = {}): SandboxProvider {\n  const agentPort = options.agentPort ?? DEFAULT_AGENT_PORT;\n  const appName = options.create?.appName ?? DEFAULT_APP_NAME;\n  const memoryMiB = options.create?.memoryMiB ?? DEFAULT_MEMORY_MIB;\n  const client = new ModalClient();\n\n  return {\n    name: \"modal\",\n    async create(): Promise<string> {\n      const app = await client.apps.fromName(appName, { createIfMissing: true });\n\n      // Pre-install sandbox-agent and agents in the image so they are cached\n      // across sandbox creates and don't need to be installed at runtime.\n      const installAgentCmds = DEFAULT_AGENTS.map((agent) => `RUN sandbox-agent install-agent ${agent}`);\n      const image = client.images\n        .fromRegistry(\"node:22-slim\")\n        .dockerfileCommands([\n          \"RUN apt-get update && apt-get install -y curl ca-certificates && rm -rf /var/lib/apt/lists/*\",\n          `RUN curl -fsSL ${SANDBOX_AGENT_INSTALL_SCRIPT} | sh`,\n          ...installAgentCmds,\n        ]);\n\n      const envVars = options.create?.secrets ?? {};\n      const secrets = Object.keys(envVars).length > 0 ? [await client.secrets.fromObject(envVars)] : [];\n\n      const sb = await client.sandboxes.create(app, image, {\n        encryptedPorts: [agentPort],\n        secrets,\n        memoryMiB,\n      });\n\n      // Start the server as a long-running exec process. We intentionally\n      // do NOT await p.wait() — the process stays alive for the sandbox\n      // lifetime and keeps the port open for the tunnel.\n      sb.exec([\"sandbox-agent\", \"server\", \"--no-token\", \"--host\", \"0.0.0.0\", \"--port\", String(agentPort)]);\n\n      return sb.sandboxId;\n    },\n    async destroy(sandboxId: string): Promise<void> {\n      const sb = await client.sandboxes.fromId(sandboxId);\n      await sb.terminate();\n    },\n    async getUrl(sandboxId: string): Promise<string> {\n      const sb = await client.sandboxes.fromId(sandboxId);\n      const tunnels = await sb.tunnels();\n      const tunnel = tunnels[agentPort];\n      if (!tunnel) {\n        throw new Error(`modal: no tunnel found for port ${agentPort}`);\n      }\n      return tunnel.url;\n    },\n    async ensureServer(sandboxId: string): Promise<void> {\n      const sb = await client.sandboxes.fromId(sandboxId);\n      sb.exec([\"sandbox-agent\", \"server\", \"--no-token\", \"--host\", \"0.0.0.0\", \"--port\", String(agentPort)]);\n    },\n  };\n}\n"],"mappings":";;;;;;AAAA,SAAS,mBAAmB;AAI5B,IAAM,qBAAqB;AAC3B,IAAM,mBAAmB;AACzB,IAAM,qBAAqB;AAWpB,SAAS,MAAM,UAAgC,CAAC,GAAoB;AACzE,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,UAAU,QAAQ,QAAQ,WAAW;AAC3C,QAAM,YAAY,QAAQ,QAAQ,aAAa;AAC/C,QAAM,SAAS,IAAI,YAAY;AAE/B,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,SAA0B;AAC9B,YAAM,MAAM,MAAM,OAAO,KAAK,SAAS,SAAS,EAAE,iBAAiB,KAAK,CAAC;AAIzE,YAAM,mBAAmB,eAAe,IAAI,CAAC,UAAU,mCAAmC,KAAK,EAAE;AACjG,YAAM,QAAQ,OAAO,OAClB,aAAa,cAAc,EAC3B,mBAAmB;AAAA,QAClB;AAAA,QACA,kBAAkB,4BAA4B;AAAA,QAC9C,GAAG;AAAA,MACL,CAAC;AAEH,YAAM,UAAU,QAAQ,QAAQ,WAAW,CAAC;AAC5C,YAAM,UAAU,OAAO,KAAK,OAAO,EAAE,SAAS,IAAI,CAAC,MAAM,OAAO,QAAQ,WAAW,OAAO,CAAC,IAAI,CAAC;AAEhG,YAAM,KAAK,MAAM,OAAO,UAAU,OAAO,KAAK,OAAO;AAAA,QACnD,gBAAgB,CAAC,SAAS;AAAA,QAC1B;AAAA,QACA;AAAA,MACF,CAAC;AAKD,SAAG,KAAK,CAAC,iBAAiB,UAAU,cAAc,UAAU,WAAW,UAAU,OAAO,SAAS,CAAC,CAAC;AAEnG,aAAO,GAAG;AAAA,IACZ;AAAA,IACA,MAAM,QAAQ,WAAkC;AAC9C,YAAM,KAAK,MAAM,OAAO,UAAU,OAAO,SAAS;AAClD,YAAM,GAAG,UAAU;AAAA,IACrB;AAAA,IACA,MAAM,OAAO,WAAoC;AAC/C,YAAM,KAAK,MAAM,OAAO,UAAU,OAAO,SAAS;AAClD,YAAM,UAAU,MAAM,GAAG,QAAQ;AACjC,YAAM,SAAS,QAAQ,SAAS;AAChC,UAAI,CAAC,QAAQ;AACX,cAAM,IAAI,MAAM,mCAAmC,SAAS,EAAE;AAAA,MAChE;AACA,aAAO,OAAO;AAAA,IAChB;AAAA,IACA,MAAM,aAAa,WAAkC;AACnD,YAAM,KAAK,MAAM,OAAO,UAAU,OAAO,SAAS;AAClD,SAAG,KAAK,CAAC,iBAAiB,UAAU,cAAc,UAAU,WAAW,UAAU,OAAO,SAAS,CAAC,CAAC;AAAA,IACrG;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/providers/modal.ts"],"sourcesContent":["import { ModalClient, type Image, type SandboxCreateParams } from \"modal\";\nimport type { SandboxProvider } from \"./types.ts\";\nimport { DEFAULT_SANDBOX_AGENT_IMAGE } from \"./shared.ts\";\n\nconst DEFAULT_AGENT_PORT = 3000;\nconst DEFAULT_APP_NAME = \"sandbox-agent\";\nconst DEFAULT_MEMORY_MIB = 2048;\n\ntype ModalCreateOverrides = Omit<Partial<SandboxCreateParams>, \"secrets\" | \"encryptedPorts\"> & {\n  secrets?: Record<string, string>;\n  encryptedPorts?: number[];\n  appName?: string;\n};\n\nexport interface ModalProviderOptions {\n  create?: ModalCreateOverrides | (() => ModalCreateOverrides | Promise<ModalCreateOverrides>);\n  image?: string | Image;\n  agentPort?: number;\n}\n\nasync function resolveCreateOptions(value: ModalProviderOptions[\"create\"]): Promise<ModalCreateOverrides> {\n  if (!value) return {};\n  return typeof value === \"function\" ? await value() : value;\n}\n\nexport function modal(options: ModalProviderOptions = {}): SandboxProvider {\n  const agentPort = options.agentPort ?? DEFAULT_AGENT_PORT;\n  const client = new ModalClient();\n\n  return {\n    name: \"modal\",\n    defaultCwd: \"/root\",\n    async create(): Promise<string> {\n      const createOpts = await resolveCreateOptions(options.create);\n      const appName = createOpts.appName ?? DEFAULT_APP_NAME;\n      const baseImage = options.image ?? DEFAULT_SANDBOX_AGENT_IMAGE;\n      const app = await client.apps.fromName(appName, { createIfMissing: true });\n\n      // The default `-full` base image already includes sandbox-agent and all\n      // agents pre-installed, so no additional dockerfile commands are needed.\n      const image = typeof baseImage === \"string\" ? client.images.fromRegistry(baseImage) : baseImage;\n\n      const envVars = createOpts.secrets ?? {};\n      const secrets = Object.keys(envVars).length > 0 ? [await client.secrets.fromObject(envVars)] : [];\n      const sandboxCreateOpts = { ...createOpts };\n      delete sandboxCreateOpts.appName;\n      delete sandboxCreateOpts.secrets;\n\n      const extraPorts = createOpts.encryptedPorts ?? [];\n      delete sandboxCreateOpts.encryptedPorts;\n\n      const sb = await client.sandboxes.create(app, image, {\n        ...sandboxCreateOpts,\n        encryptedPorts: [agentPort, ...extraPorts],\n        secrets,\n        memoryMiB: sandboxCreateOpts.memoryMiB ?? DEFAULT_MEMORY_MIB,\n      });\n\n      // Start the server as a long-running exec process. We intentionally\n      // do NOT await p.wait() — the process stays alive for the sandbox\n      // lifetime and keeps the port open for the tunnel.\n      sb.exec([\"sandbox-agent\", \"server\", \"--no-token\", \"--host\", \"0.0.0.0\", \"--port\", String(agentPort)]);\n\n      return sb.sandboxId;\n    },\n    async destroy(sandboxId: string): Promise<void> {\n      const sb = await client.sandboxes.fromId(sandboxId);\n      await sb.terminate();\n    },\n    async getUrl(sandboxId: string): Promise<string> {\n      const sb = await client.sandboxes.fromId(sandboxId);\n      const tunnels = await sb.tunnels();\n      const tunnel = tunnels[agentPort];\n      if (!tunnel) {\n        throw new Error(`modal: no tunnel found for port ${agentPort}`);\n      }\n      return tunnel.url;\n    },\n    async ensureServer(sandboxId: string): Promise<void> {\n      const sb = await client.sandboxes.fromId(sandboxId);\n      sb.exec([\"sandbox-agent\", \"server\", \"--no-token\", \"--host\", \"0.0.0.0\", \"--port\", String(agentPort)]);\n    },\n  };\n}\n"],"mappings":";;;;;AAAA,SAAS,mBAAyD;AAIlE,IAAM,qBAAqB;AAC3B,IAAM,mBAAmB;AACzB,IAAM,qBAAqB;AAc3B,eAAe,qBAAqB,OAAsE;AACxG,MAAI,CAAC,MAAO,QAAO,CAAC;AACpB,SAAO,OAAO,UAAU,aAAa,MAAM,MAAM,IAAI;AACvD;AAEO,SAAS,MAAM,UAAgC,CAAC,GAAoB;AACzE,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,SAAS,IAAI,YAAY;AAE/B,SAAO;AAAA,IACL,MAAM;AAAA,IACN,YAAY;AAAA,IACZ,MAAM,SAA0B;AAC9B,YAAM,aAAa,MAAM,qBAAqB,QAAQ,MAAM;AAC5D,YAAM,UAAU,WAAW,WAAW;AACtC,YAAM,YAAY,QAAQ,SAAS;AACnC,YAAM,MAAM,MAAM,OAAO,KAAK,SAAS,SAAS,EAAE,iBAAiB,KAAK,CAAC;AAIzE,YAAM,QAAQ,OAAO,cAAc,WAAW,OAAO,OAAO,aAAa,SAAS,IAAI;AAEtF,YAAM,UAAU,WAAW,WAAW,CAAC;AACvC,YAAM,UAAU,OAAO,KAAK,OAAO,EAAE,SAAS,IAAI,CAAC,MAAM,OAAO,QAAQ,WAAW,OAAO,CAAC,IAAI,CAAC;AAChG,YAAM,oBAAoB,EAAE,GAAG,WAAW;AAC1C,aAAO,kBAAkB;AACzB,aAAO,kBAAkB;AAEzB,YAAM,aAAa,WAAW,kBAAkB,CAAC;AACjD,aAAO,kBAAkB;AAEzB,YAAM,KAAK,MAAM,OAAO,UAAU,OAAO,KAAK,OAAO;AAAA,QACnD,GAAG;AAAA,QACH,gBAAgB,CAAC,WAAW,GAAG,UAAU;AAAA,QACzC;AAAA,QACA,WAAW,kBAAkB,aAAa;AAAA,MAC5C,CAAC;AAKD,SAAG,KAAK,CAAC,iBAAiB,UAAU,cAAc,UAAU,WAAW,UAAU,OAAO,SAAS,CAAC,CAAC;AAEnG,aAAO,GAAG;AAAA,IACZ;AAAA,IACA,MAAM,QAAQ,WAAkC;AAC9C,YAAM,KAAK,MAAM,OAAO,UAAU,OAAO,SAAS;AAClD,YAAM,GAAG,UAAU;AAAA,IACrB;AAAA,IACA,MAAM,OAAO,WAAoC;AAC/C,YAAM,KAAK,MAAM,OAAO,UAAU,OAAO,SAAS;AAClD,YAAM,UAAU,MAAM,GAAG,QAAQ;AACjC,YAAM,SAAS,QAAQ,SAAS;AAChC,UAAI,CAAC,QAAQ;AACX,cAAM,IAAI,MAAM,mCAAmC,SAAS,EAAE;AAAA,MAChE;AACA,aAAO,OAAO;AAAA,IAChB;AAAA,IACA,MAAM,aAAa,WAAkC;AACnD,YAAM,KAAK,MAAM,OAAO,UAAU,OAAO,SAAS;AAClD,SAAG,KAAK,CAAC,iBAAiB,UAAU,cAAc,UAAU,WAAW,UAAU,OAAO,SAAS,CAAC,CAAC;AAAA,IACrG;AAAA,EACF;AACF;","names":[]}

package/dist/providers/sprites.d.ts

@@ -0,0 +1,22 @@
+import { ClientOptions, SpriteConfig } from '@fly/sprites';
+import { S as SandboxProvider } from '../types-DdcvY5CI.js';
+
+interface SpritesCreateOverrides {
+    name?: string;
+    config?: SpriteConfig;
+}
+type SpritesClientOverrides = Partial<ClientOptions>;
+interface SpritesProviderOptions {
+    token?: string | (() => string | Promise<string>);
+    client?: SpritesClientOverrides | (() => SpritesClientOverrides | Promise<SpritesClientOverrides>);
+    create?: SpritesCreateOverrides | (() => SpritesCreateOverrides | Promise<SpritesCreateOverrides>);
+    env?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
+    installAgents?: readonly string[];
+    agentPort?: number;
+    serviceName?: string;
+    serviceStartDuration?: string;
+    namePrefix?: string;
+}
+declare function sprites(options?: SpritesProviderOptions): SandboxProvider;
+
+export { type SpritesClientOverrides, type SpritesCreateOverrides, type SpritesProviderOptions, sprites };

package/dist/providers/sprites.js

@@ -0,0 +1,209 @@
+import {
+  SandboxDestroyedError
+} from "../chunk-TVCDKGSM.js";
+import {
+  SANDBOX_AGENT_NPX_SPEC
+} from "../chunk-7BNDCDDU.js";
+
+// src/providers/sprites.ts
+import { ExecError, SpritesClient } from "@fly/sprites";
+var DEFAULT_AGENT_PORT = 8080;
+var DEFAULT_SERVICE_NAME = "sandbox-agent";
+var DEFAULT_NAME_PREFIX = "sandbox-agent";
+var DEFAULT_SERVICE_START_DURATION = "10m";
+async function resolveValue(value, fallback) {
+  if (value === void 0) {
+    return fallback;
+  }
+  if (typeof value === "function") {
+    return await value();
+  }
+  return value;
+}
+async function resolveToken(value) {
+  const token = await resolveValue(value, process.env.SPRITES_API_KEY ?? process.env.SPRITE_TOKEN ?? process.env.SPRITES_TOKEN ?? "");
+  if (!token) {
+    throw new Error("sprites provider requires a token. Set SPRITES_API_KEY (or SPRITE_TOKEN) or pass `token`.");
+  }
+  return token;
+}
+function createSpritesClient(token, options) {
+  return new SpritesClient(token, options);
+}
+function generateSpriteName(prefix) {
+  const suffix = typeof globalThis.crypto?.randomUUID === "function" ? globalThis.crypto.randomUUID().slice(0, 8) : `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+  return `${prefix}-${suffix}`.toLowerCase();
+}
+function isSpriteNotFoundError(error) {
+  return error instanceof Error && error.message.startsWith("Sprite not found:");
+}
+function shellQuote(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function buildServiceCommand(env, port) {
+  const exportParts = [];
+  for (const [key, value] of Object.entries(env)) {
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) {
+      throw new Error(`sprites provider received an invalid environment variable name: ${key}`);
+    }
+    exportParts.push(`export ${key}=${shellQuote(value)}`);
+  }
+  exportParts.push(`exec npx -y ${SANDBOX_AGENT_NPX_SPEC} server --no-token --host 0.0.0.0 --port ${port}`);
+  return exportParts.join("; ");
+}
+async function runSpriteCommand(sprite, file, args, env) {
+  try {
+    const result = await sprite.execFile(file, args, env ? { env } : void 0);
+    if (result.exitCode !== 0) {
+      throw new Error(`sprites command failed: ${file} ${args.join(" ")}`);
+    }
+  } catch (error) {
+    if (error instanceof ExecError) {
+      throw new Error(
+        `sprites command failed: ${file} ${args.join(" ")} (exit ${error.exitCode})
+stdout:
+${String(error.stdout)}
+stderr:
+${String(error.stderr)}`,
+        { cause: error }
+      );
+    }
+    throw error;
+  }
+}
+async function fetchService(client, spriteName, serviceName) {
+  const response = await fetch(`${client.baseURL}/v1/sprites/${encodeURIComponent(spriteName)}/services/${encodeURIComponent(serviceName)}`, {
+    method: "GET",
+    headers: {
+      Authorization: `Bearer ${client.token}`
+    }
+  });
+  if (response.status === 404) {
+    return void 0;
+  }
+  if (!response.ok) {
+    throw new Error(`sprites service lookup failed (status ${response.status}): ${await response.text()}`);
+  }
+  return await response.json();
+}
+async function upsertService(client, spriteName, serviceName, port, command) {
+  const existing = await fetchService(client, spriteName, serviceName);
+  const expectedArgs = ["-lc", command];
+  const isCurrent = existing?.cmd === "bash" && existing.http_port === port && JSON.stringify(existing.args ?? []) === JSON.stringify(expectedArgs);
+  if (isCurrent) {
+    return;
+  }
+  const response = await fetch(`${client.baseURL}/v1/sprites/${encodeURIComponent(spriteName)}/services/${encodeURIComponent(serviceName)}`, {
+    method: "PUT",
+    headers: {
+      Authorization: `Bearer ${client.token}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({
+      cmd: "bash",
+      args: expectedArgs,
+      http_port: port
+    })
+  });
+  if (!response.ok) {
+    throw new Error(`sprites service upsert failed (status ${response.status}): ${await response.text()}`);
+  }
+}
+async function startServiceIfNeeded(client, spriteName, serviceName, duration) {
+  const existing = await fetchService(client, spriteName, serviceName);
+  if (existing?.state?.status === "running" || existing?.state?.status === "starting") {
+    return;
+  }
+  const response = await fetch(
+    `${client.baseURL}/v1/sprites/${encodeURIComponent(spriteName)}/services/${encodeURIComponent(serviceName)}/start?duration=${encodeURIComponent(duration)}`,
+    {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${client.token}`
+      }
+    }
+  );
+  if (!response.ok) {
+    throw new Error(`sprites service start failed (status ${response.status}): ${await response.text()}`);
+  }
+  await response.text();
+}
+async function ensureService(client, spriteName, serviceName, port, duration, env) {
+  const command = buildServiceCommand(env, port);
+  await upsertService(client, spriteName, serviceName, port, command);
+  await startServiceIfNeeded(client, spriteName, serviceName, duration);
+}
+function sprites(options = {}) {
+  const agentPort = options.agentPort ?? DEFAULT_AGENT_PORT;
+  const serviceName = options.serviceName ?? DEFAULT_SERVICE_NAME;
+  const serviceStartDuration = options.serviceStartDuration ?? DEFAULT_SERVICE_START_DURATION;
+  const namePrefix = options.namePrefix ?? DEFAULT_NAME_PREFIX;
+  const installAgents = [...options.installAgents ?? []];
+  const getClient = async () => {
+    const token = await resolveToken(options.token);
+    const clientOptions = await resolveValue(options.client, {});
+    return createSpritesClient(token, clientOptions);
+  };
+  const getServerEnv = async () => {
+    return await resolveValue(options.env, {});
+  };
+  const provider = {
+    name: "sprites",
+    defaultCwd: "/home/sprite",
+    async create() {
+      const client = await getClient();
+      const createOptions = await resolveValue(options.create, {});
+      const spriteName = createOptions.name ?? generateSpriteName(namePrefix);
+      const sprite = await client.createSprite(spriteName, createOptions.config);
+      const serverEnv = await getServerEnv();
+      for (const agent of installAgents) {
+        await runSpriteCommand(sprite, "bash", ["-lc", `npx -y ${SANDBOX_AGENT_NPX_SPEC} install-agent ${agent}`], serverEnv);
+      }
+      await ensureService(client, spriteName, serviceName, agentPort, serviceStartDuration, serverEnv);
+      return sprite.name;
+    },
+    async destroy(sandboxId) {
+      const client = await getClient();
+      try {
+        await client.deleteSprite(sandboxId);
+      } catch (error) {
+        if (isSpriteNotFoundError(error) || error instanceof Error && error.message.includes("status 404")) {
+          return;
+        }
+        throw error;
+      }
+    },
+    async reconnect(sandboxId) {
+      const client = await getClient();
+      try {
+        await client.getSprite(sandboxId);
+      } catch (error) {
+        if (isSpriteNotFoundError(error)) {
+          throw new SandboxDestroyedError(sandboxId, "sprites", { cause: error });
+        }
+        throw error;
+      }
+    },
+    async getUrl(sandboxId) {
+      const client = await getClient();
+      const sprite = await client.getSprite(sandboxId);
+      const url = sprite.url;
+      if (!url) {
+        throw new Error(`sprites API did not return a URL for sprite: ${sandboxId}`);
+      }
+      return url;
+    },
+    async ensureServer(sandboxId) {
+      const client = await getClient();
+      await ensureService(client, sandboxId, serviceName, agentPort, serviceStartDuration, await getServerEnv());
+    },
+    async getToken() {
+      return await resolveToken(options.token);
+    }
+  };
+  return provider;
+}
+export {
+  sprites
+};
+//# sourceMappingURL=sprites.js.map

package/dist/providers/sprites.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/sprites.ts"],"sourcesContent":["import { ExecError, SpritesClient, type ClientOptions as SpritesClientOptions, type SpriteConfig } from \"@fly/sprites\";\nimport { SandboxDestroyedError } from \"../client.ts\";\nimport type { SandboxProvider } from \"./types.ts\";\nimport { SANDBOX_AGENT_NPX_SPEC } from \"./shared.ts\";\n\nconst DEFAULT_AGENT_PORT = 8080;\nconst DEFAULT_SERVICE_NAME = \"sandbox-agent\";\nconst DEFAULT_NAME_PREFIX = \"sandbox-agent\";\nconst DEFAULT_SERVICE_START_DURATION = \"10m\";\n\nexport interface SpritesCreateOverrides {\n  name?: string;\n  config?: SpriteConfig;\n}\n\nexport type SpritesClientOverrides = Partial<SpritesClientOptions>;\n\nexport interface SpritesProviderOptions {\n  token?: string | (() => string | Promise<string>);\n  client?: SpritesClientOverrides | (() => SpritesClientOverrides | Promise<SpritesClientOverrides>);\n  create?: SpritesCreateOverrides | (() => SpritesCreateOverrides | Promise<SpritesCreateOverrides>);\n  env?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);\n  installAgents?: readonly string[];\n  agentPort?: number;\n  serviceName?: string;\n  serviceStartDuration?: string;\n  namePrefix?: string;\n}\n\ntype SpritesSandboxProvider = SandboxProvider & {\n  getToken(sandboxId: string): Promise<string>;\n};\n\ninterface SpritesService {\n  cmd?: string;\n  args?: string[];\n  http_port?: number | null;\n  state?: {\n    status?: string;\n  };\n}\n\nasync function resolveValue<T>(value: T | (() => T | Promise<T>) | undefined, fallback: T): Promise<T> {\n  if (value === undefined) {\n    return fallback;\n  }\n  if (typeof value === \"function\") {\n    return await (value as () => T | Promise<T>)();\n  }\n  return value;\n}\n\nasync function resolveToken(value: SpritesProviderOptions[\"token\"]): Promise<string> {\n  const token = await resolveValue(value, process.env.SPRITES_API_KEY ?? process.env.SPRITE_TOKEN ?? process.env.SPRITES_TOKEN ?? \"\");\n  if (!token) {\n    throw new Error(\"sprites provider requires a token. Set SPRITES_API_KEY (or SPRITE_TOKEN) or pass `token`.\");\n  }\n  return token;\n}\n\nfunction createSpritesClient(token: string, options: SpritesClientOverrides): SpritesClient {\n  return new SpritesClient(token, options);\n}\n\nfunction generateSpriteName(prefix: string): string {\n  const suffix =\n    typeof globalThis.crypto?.randomUUID === \"function\"\n      ? globalThis.crypto.randomUUID().slice(0, 8)\n      : `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;\n  return `${prefix}-${suffix}`.toLowerCase();\n}\n\nfunction isSpriteNotFoundError(error: unknown): boolean {\n  return error instanceof Error && error.message.startsWith(\"Sprite not found:\");\n}\n\nfunction shellQuote(value: string): string {\n  return `'${value.replace(/'/g, `'\\\\''`)}'`;\n}\n\nfunction buildServiceCommand(env: Record<string, string>, port: number): string {\n  const exportParts: string[] = [];\n  for (const [key, value] of Object.entries(env)) {\n    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) {\n      throw new Error(`sprites provider received an invalid environment variable name: ${key}`);\n    }\n    exportParts.push(`export ${key}=${shellQuote(value)}`);\n  }\n\n  exportParts.push(`exec npx -y ${SANDBOX_AGENT_NPX_SPEC} server --no-token --host 0.0.0.0 --port ${port}`);\n  return exportParts.join(\"; \");\n}\n\nasync function runSpriteCommand(sprite: ReturnType<SpritesClient[\"sprite\"]>, file: string, args: string[], env?: Record<string, string>): Promise<void> {\n  try {\n    const result = await sprite.execFile(file, args, env ? { env } : undefined);\n    if (result.exitCode !== 0) {\n      throw new Error(`sprites command failed: ${file} ${args.join(\" \")}`);\n    }\n  } catch (error) {\n    if (error instanceof ExecError) {\n      throw new Error(\n        `sprites command failed: ${file} ${args.join(\" \")} (exit ${error.exitCode})\\nstdout:\\n${String(error.stdout)}\\nstderr:\\n${String(error.stderr)}`,\n        { cause: error },\n      );\n    }\n    throw error;\n  }\n}\n\nasync function fetchService(client: SpritesClient, spriteName: string, serviceName: string): Promise<SpritesService | undefined> {\n  const response = await fetch(`${client.baseURL}/v1/sprites/${encodeURIComponent(spriteName)}/services/${encodeURIComponent(serviceName)}`, {\n    method: \"GET\",\n    headers: {\n      Authorization: `Bearer ${client.token}`,\n    },\n  });\n\n  if (response.status === 404) {\n    return undefined;\n  }\n\n  if (!response.ok) {\n    throw new Error(`sprites service lookup failed (status ${response.status}): ${await response.text()}`);\n  }\n\n  return (await response.json()) as SpritesService;\n}\n\nasync function upsertService(client: SpritesClient, spriteName: string, serviceName: string, port: number, command: string): Promise<void> {\n  const existing = await fetchService(client, spriteName, serviceName);\n  const expectedArgs = [\"-lc\", command];\n  const isCurrent = existing?.cmd === \"bash\" && existing.http_port === port && JSON.stringify(existing.args ?? []) === JSON.stringify(expectedArgs);\n  if (isCurrent) {\n    return;\n  }\n\n  const response = await fetch(`${client.baseURL}/v1/sprites/${encodeURIComponent(spriteName)}/services/${encodeURIComponent(serviceName)}`, {\n    method: \"PUT\",\n    headers: {\n      Authorization: `Bearer ${client.token}`,\n      \"Content-Type\": \"application/json\",\n    },\n    body: JSON.stringify({\n      cmd: \"bash\",\n      args: expectedArgs,\n      http_port: port,\n    }),\n  });\n\n  if (!response.ok) {\n    throw new Error(`sprites service upsert failed (status ${response.status}): ${await response.text()}`);\n  }\n}\n\nasync function startServiceIfNeeded(client: SpritesClient, spriteName: string, serviceName: string, duration: string): Promise<void> {\n  const existing = await fetchService(client, spriteName, serviceName);\n  if (existing?.state?.status === \"running\" || existing?.state?.status === \"starting\") {\n    return;\n  }\n\n  const response = await fetch(\n    `${client.baseURL}/v1/sprites/${encodeURIComponent(spriteName)}/services/${encodeURIComponent(serviceName)}/start?duration=${encodeURIComponent(duration)}`,\n    {\n      method: \"POST\",\n      headers: {\n        Authorization: `Bearer ${client.token}`,\n      },\n    },\n  );\n\n  if (!response.ok) {\n    throw new Error(`sprites service start failed (status ${response.status}): ${await response.text()}`);\n  }\n\n  await response.text();\n}\n\nasync function ensureService(\n  client: SpritesClient,\n  spriteName: string,\n  serviceName: string,\n  port: number,\n  duration: string,\n  env: Record<string, string>,\n): Promise<void> {\n  const command = buildServiceCommand(env, port);\n  await upsertService(client, spriteName, serviceName, port, command);\n  await startServiceIfNeeded(client, spriteName, serviceName, duration);\n}\n\nexport function sprites(options: SpritesProviderOptions = {}): SandboxProvider {\n  const agentPort = options.agentPort ?? DEFAULT_AGENT_PORT;\n  const serviceName = options.serviceName ?? DEFAULT_SERVICE_NAME;\n  const serviceStartDuration = options.serviceStartDuration ?? DEFAULT_SERVICE_START_DURATION;\n  const namePrefix = options.namePrefix ?? DEFAULT_NAME_PREFIX;\n  const installAgents = [...(options.installAgents ?? [])];\n\n  const getClient = async (): Promise<SpritesClient> => {\n    const token = await resolveToken(options.token);\n    const clientOptions = await resolveValue(options.client, {});\n    return createSpritesClient(token, clientOptions);\n  };\n\n  const getServerEnv = async (): Promise<Record<string, string>> => {\n    return await resolveValue(options.env, {});\n  };\n\n  const provider: SpritesSandboxProvider = {\n    name: \"sprites\",\n    defaultCwd: \"/home/sprite\",\n    async create(): Promise<string> {\n      const client = await getClient();\n      const createOptions = await resolveValue(options.create, {});\n      const spriteName = createOptions.name ?? generateSpriteName(namePrefix);\n      const sprite = await client.createSprite(spriteName, createOptions.config);\n\n      const serverEnv = await getServerEnv();\n      for (const agent of installAgents) {\n        await runSpriteCommand(sprite, \"bash\", [\"-lc\", `npx -y ${SANDBOX_AGENT_NPX_SPEC} install-agent ${agent}`], serverEnv);\n      }\n\n      await ensureService(client, spriteName, serviceName, agentPort, serviceStartDuration, serverEnv);\n      return sprite.name;\n    },\n    async destroy(sandboxId: string): Promise<void> {\n      const client = await getClient();\n      try {\n        await client.deleteSprite(sandboxId);\n      } catch (error) {\n        if (isSpriteNotFoundError(error) || (error instanceof Error && error.message.includes(\"status 404\"))) {\n          return;\n        }\n        throw error;\n      }\n    },\n    async reconnect(sandboxId: string): Promise<void> {\n      const client = await getClient();\n      try {\n        await client.getSprite(sandboxId);\n      } catch (error) {\n        if (isSpriteNotFoundError(error)) {\n          throw new SandboxDestroyedError(sandboxId, \"sprites\", { cause: error });\n        }\n        throw error;\n      }\n    },\n    async getUrl(sandboxId: string): Promise<string> {\n      const client = await getClient();\n      const sprite = await client.getSprite(sandboxId);\n      const url = (sprite as { url?: string }).url;\n      if (!url) {\n        throw new Error(`sprites API did not return a URL for sprite: ${sandboxId}`);\n      }\n      return url;\n    },\n    async ensureServer(sandboxId: string): Promise<void> {\n      const client = await getClient();\n      await ensureService(client, sandboxId, serviceName, agentPort, serviceStartDuration, await getServerEnv());\n    },\n    async getToken(): Promise<string> {\n      return await resolveToken(options.token);\n    },\n  };\n\n  return provider;\n}\n"],"mappings":"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","names":[]}

package/dist/providers/vercel.d.ts

@@ -1,4 +1,4 @@
-import { S as SandboxProvider } from '../types-DLlJOfyX.js';
+import { S as SandboxProvider } from '../types-DdcvY5CI.js';
 
 interface VercelProviderOptions {
     create?: Record<string, unknown> | (() => Record<string, unknown> | Promise<Record<string, unknown>>);

package/dist/providers/vercel.js

@@ -1,7 +1,7 @@
 import {
   DEFAULT_AGENTS,
   SANDBOX_AGENT_INSTALL_SCRIPT
-} from "../chunk-TWTMX66J.js";
+} from "../chunk-7BNDCDDU.js";
 
 // src/providers/vercel.ts
 import { Sandbox } from "@vercel/sandbox";
@@ -25,6 +25,7 @@ function vercel(options = {}) {
   const agentPort = options.agentPort ?? DEFAULT_AGENT_PORT;
   return {
     name: "vercel",
+    defaultCwd: "/home/vercel-sandbox",
     async create() {
       const sandbox = await Sandbox.create(await resolveCreateOptions(options.create, agentPort));
       await runVercelCommand(sandbox, "sh", ["-c", `curl -fsSL ${SANDBOX_AGENT_INSTALL_SCRIPT} | sh`]);