sandbox-agent 0.5.0-rc.2 → 0.5.0

package/dist/providers/e2b.js

@@ -1,15 +1,16 @@
 import {
   SandboxDestroyedError
-} from "../chunk-TVCDKGSM.js";
+} from "../chunk-TEHINGEG.js";
 import {
   DEFAULT_AGENTS,
   SANDBOX_AGENT_INSTALL_SCRIPT
-} from "../chunk-REA2EEYN.js";
+} from "../chunk-7BNDCDDU.js";
 
 // src/providers/e2b.ts
 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") {
@@ -24,6 +25,10 @@ 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;
@@ -44,17 +49,17 @@ function e2b(options = {}) {
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         await Sandbox.betaCreate({ allowInternetAccess: true, ...restCreateOpts, timeoutMs, autoPause })
       );
-      await sandbox.commands.run(`curl -fsSL ${SANDBOX_AGENT_INSTALL_SCRIPT} | sh`).then((r) => {
+      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) {
@@ -89,7 +94,7 @@ ${r.stderr}`);
     async ensureServer(sandboxId) {
       const connectOpts = await resolveOptions(options.connect, sandboxId);
       const sandbox = await Sandbox.connect(sandboxId, { ...connectOpts, timeoutMs });
-      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 });
     }
   };
 }

package/dist/providers/e2b.js.map

@@ -1 +1 @@
-{"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;\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\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(`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      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(`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":[]}
+{"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-DdcvY5CI.js';
+import { S as SandboxProvider } from '../types--QirRZeL.js';
 
 interface LocalProviderOptions {
     host?: string;

package/dist/providers/modal.d.ts

@@ -1,5 +1,5 @@
 import { SandboxCreateParams, Image } from 'modal';
-import { S as SandboxProvider } from '../types-DdcvY5CI.js';
+import { S as SandboxProvider } from '../types--QirRZeL.js';
 
 type ModalCreateOverrides = Omit<Partial<SandboxCreateParams>, "secrets" | "encryptedPorts"> & {
     secrets?: Record<string, string>;

package/dist/providers/modal.js

@@ -1,6 +1,6 @@
 import {
   DEFAULT_SANDBOX_AGENT_IMAGE
-} from "../chunk-REA2EEYN.js";
+} from "../chunk-7BNDCDDU.js";
 
 // src/providers/modal.ts
 import { ModalClient } from "modal";

package/dist/providers/sprites.d.ts

@@ -0,0 +1,22 @@
+import { ClientOptions, SpriteConfig } from '@fly/sprites';
+import { S as SandboxProvider } from '../types--QirRZeL.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-TEHINGEG.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-DdcvY5CI.js';
+import { S as SandboxProvider } from '../types--QirRZeL.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-REA2EEYN.js";
+} from "../chunk-7BNDCDDU.js";
 
 // src/providers/vercel.ts
 import { Sandbox } from "@vercel/sandbox";

package/dist/{types-DdcvY5CI.d.ts → types--QirRZeL.d.ts}

@@ -31,6 +31,11 @@ interface SandboxProvider {
      * Providers that expose a URL can implement `getUrl()` instead.
      */
     getFetch?(sandboxId: string): Promise<typeof globalThis.fetch>;
+    /**
+     * Return a browser-ready Inspector URL for this sandbox.
+     * When omitted, the SDK falls back to `${getUrl()}/ui/`.
+     */
+    getInspectorUrl?(sandboxId: string, baseUrl?: string): Promise<string>;
     /**
      * Ensure the sandbox-agent server process is running inside the sandbox.
      * Called during health-wait after consecutive failures, and before

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "sandbox-agent",
-  "version": "0.5.0-rc.2",
+  "version": "0.5.0",
   "description": "Universal API for automatic coding agents in sandboxes. Supports Claude Code, Codex, OpenCode, and Amp.",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/rivet-dev/sandbox-agent"
+    "url": "https://github.com/rivet-dev/agents.git"
   },
   "type": "module",
   "main": "./dist/index.js",
@@ -27,6 +27,10 @@
       "types": "./dist/providers/daytona.d.ts",
       "import": "./dist/providers/daytona.js"
     },
+    "./agentcomputer": {
+      "types": "./dist/providers/agentcomputer.d.ts",
+      "import": "./dist/providers/agentcomputer.js"
+    },
     "./docker": {
       "types": "./dist/providers/docker.d.ts",
       "import": "./dist/providers/docker.js"
@@ -46,12 +50,17 @@
     "./computesdk": {
       "types": "./dist/providers/computesdk.d.ts",
       "import": "./dist/providers/computesdk.js"
+    },
+    "./sprites": {
+      "types": "./dist/providers/sprites.d.ts",
+      "import": "./dist/providers/sprites.js"
     }
   },
   "peerDependencies": {
     "@cloudflare/sandbox": ">=0.1.0",
     "@daytonaio/sdk": ">=0.12.0",
     "@e2b/code-interpreter": ">=1.0.0",
+    "@fly/sprites": ">=0.0.1",
     "@vercel/sandbox": ">=0.1.0",
     "dockerode": ">=4.0.0",
     "get-port": ">=7.0.0",
@@ -68,6 +77,9 @@
     "@e2b/code-interpreter": {
       "optional": true
     },
+    "@fly/sprites": {
+      "optional": true
+    },
     "@vercel/sandbox": {
       "optional": true
     },
@@ -85,8 +97,8 @@
     }
   },
   "dependencies": {
-    "@sandbox-agent/cli-shared": "0.5.0-rc.2",
-    "acp-http-client": "0.5.0-rc.2"
+    "acp-http-client": "0.5.0",
+    "@sandbox-agent/cli-shared": "0.5.0"
   },
   "files": [
     "dist"
@@ -95,6 +107,7 @@
     "@cloudflare/sandbox": ">=0.1.0",
     "@daytonaio/sdk": ">=0.12.0",
     "@e2b/code-interpreter": ">=1.0.0",
+    "@fly/sprites": ">=0.0.1",
     "@types/dockerode": "^4.0.0",
     "@types/node": "^22.0.0",
     "@types/ws": "^8.18.1",
@@ -110,11 +123,11 @@
     "ws": "^8.19.0"
   },
   "optionalDependencies": {
-    "@sandbox-agent/cli": "0.5.0-rc.2"
+    "@sandbox-agent/cli": "0.5.0"
   },
   "scripts": {
     "generate:openapi": "SANDBOX_AGENT_SKIP_INSPECTOR=1 cargo run -p sandbox-agent-openapi-gen -- --out ../../docs/openapi.json",
-    "generate:types": "openapi-typescript ../../docs/openapi.json -o src/generated/openapi.ts && node ./scripts/patch-openapi-types.mjs",
+    "generate:types": "openapi-typescript ../../docs/openapi.json -o src/generated/openapi.ts && node ./scripts/patch-openapi-types.mjs && biome format --write src/generated/openapi.ts",
     "generate": "pnpm run generate:openapi && pnpm run generate:types",
     "build": "pnpm --filter acp-http-client build && pnpm --filter @sandbox-agent/cli-shared build && if [ -z \"$SKIP_OPENAPI_GEN\" ]; then pnpm run generate:openapi; fi && pnpm run generate:types && tsup",
     "typecheck": "tsc --noEmit",

package/dist/chunk-REA2EEYN.js

@@ -1,15 +0,0 @@
-// src/providers/shared.ts
-var DEFAULT_SANDBOX_AGENT_IMAGE = "rivetdev/sandbox-agent:0.5.0-rc.2-full";
-var SANDBOX_AGENT_INSTALL_SCRIPT = "https://releases.rivet.dev/sandbox-agent/0.5.x/install.sh";
-var DEFAULT_AGENTS = ["claude", "codex"];
-function buildServerStartCommand(port) {
-  return `nohup sandbox-agent server --no-token --host 0.0.0.0 --port ${port} >/tmp/sandbox-agent.log 2>&1 &`;
-}
-
-export {
-  DEFAULT_SANDBOX_AGENT_IMAGE,
-  SANDBOX_AGENT_INSTALL_SCRIPT,
-  DEFAULT_AGENTS,
-  buildServerStartCommand
-};
-//# sourceMappingURL=chunk-REA2EEYN.js.map

package/dist/chunk-REA2EEYN.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/providers/shared.ts"],"sourcesContent":["export const DEFAULT_SANDBOX_AGENT_IMAGE = \"rivetdev/sandbox-agent:0.5.0-rc.2-full\";\nexport const SANDBOX_AGENT_INSTALL_SCRIPT = \"https://releases.rivet.dev/sandbox-agent/0.5.x/install.sh\";\nexport const DEFAULT_AGENTS = [\"claude\", \"codex\"] as const;\n\nexport function buildServerStartCommand(port: number): string {\n  return `nohup sandbox-agent server --no-token --host 0.0.0.0 --port ${port} >/tmp/sandbox-agent.log 2>&1 &`;\n}\n"],"mappings":";AAAO,IAAM,8BAA8B;AACpC,IAAM,+BAA+B;AACrC,IAAM,iBAAiB,CAAC,UAAU,OAAO;AAEzC,SAAS,wBAAwB,MAAsB;AAC5D,SAAO,+DAA+D,IAAI;AAC5E;","names":[]}