sandbox-agent 0.4.0 → 0.4.1

package/dist/providers/vercel.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/providers/vercel.ts"],"sourcesContent":["import { Sandbox } from \"@vercel/sandbox\";\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 VercelProviderOptions {\n  create?: Record<string, unknown> | (() => Record<string, unknown> | Promise<Record<string, unknown>>);\n  agentPort?: number;\n}\n\nasync function resolveCreateOptions(value: VercelProviderOptions[\"create\"], agentPort: number): Promise<Record<string, unknown>> {\n  const resolved = typeof value === \"function\" ? await value() : (value ?? {});\n  return {\n    ports: [agentPort],\n    ...resolved,\n  };\n}\n\nasync function runVercelCommand(sandbox: InstanceType<typeof Sandbox>, cmd: string, args: string[] = []): Promise<void> {\n  const result = await sandbox.runCommand({ cmd, args });\n  if (result.exitCode !== 0) {\n    const stderr = await result.stderr();\n    throw new Error(`vercel command failed: ${cmd} ${args.join(\" \")}\\n${stderr}`);\n  }\n}\n\nexport function vercel(options: VercelProviderOptions = {}): SandboxProvider {\n  const agentPort = options.agentPort ?? DEFAULT_AGENT_PORT;\n\n  return {\n    name: \"vercel\",\n    async create(): Promise<string> {\n      const sandbox = await Sandbox.create((await resolveCreateOptions(options.create, agentPort)) as Parameters<typeof Sandbox.create>[0]);\n\n      await runVercelCommand(sandbox, \"sh\", [\"-c\", `curl -fsSL ${SANDBOX_AGENT_INSTALL_SCRIPT} | sh`]);\n      for (const agent of DEFAULT_AGENTS) {\n        await runVercelCommand(sandbox, \"sandbox-agent\", [\"install-agent\", agent]);\n      }\n      await sandbox.runCommand({\n        cmd: \"sandbox-agent\",\n        args: [\"server\", \"--no-token\", \"--host\", \"0.0.0.0\", \"--port\", String(agentPort)],\n        detached: true,\n      });\n\n      return sandbox.sandboxId;\n    },\n    async destroy(sandboxId: string): Promise<void> {\n      const sandbox = await Sandbox.get({ sandboxId });\n      await sandbox.stop();\n    },\n    async getUrl(sandboxId: string): Promise<string> {\n      const sandbox = await Sandbox.get({ sandboxId });\n      return sandbox.domain(agentPort);\n    },\n    async ensureServer(sandboxId: string): Promise<void> {\n      const sandbox = await Sandbox.get({ sandboxId });\n      await sandbox.runCommand({\n        cmd: \"sandbox-agent\",\n        args: [\"server\", \"--no-token\", \"--host\", \"0.0.0.0\", \"--port\", String(agentPort)],\n        detached: true,\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;AAAA,SAAS,eAAe;AAIxB,IAAM,qBAAqB;AAO3B,eAAe,qBAAqB,OAAwC,WAAqD;AAC/H,QAAM,WAAW,OAAO,UAAU,aAAa,MAAM,MAAM,IAAK,SAAS,CAAC;AAC1E,SAAO;AAAA,IACL,OAAO,CAAC,SAAS;AAAA,IACjB,GAAG;AAAA,EACL;AACF;AAEA,eAAe,iBAAiB,SAAuC,KAAa,OAAiB,CAAC,GAAkB;AACtH,QAAM,SAAS,MAAM,QAAQ,WAAW,EAAE,KAAK,KAAK,CAAC;AACrD,MAAI,OAAO,aAAa,GAAG;AACzB,UAAM,SAAS,MAAM,OAAO,OAAO;AACnC,UAAM,IAAI,MAAM,0BAA0B,GAAG,IAAI,KAAK,KAAK,GAAG,CAAC;AAAA,EAAK,MAAM,EAAE;AAAA,EAC9E;AACF;AAEO,SAAS,OAAO,UAAiC,CAAC,GAAoB;AAC3E,QAAM,YAAY,QAAQ,aAAa;AAEvC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,SAA0B;AAC9B,YAAM,UAAU,MAAM,QAAQ,OAAQ,MAAM,qBAAqB,QAAQ,QAAQ,SAAS,CAA0C;AAEpI,YAAM,iBAAiB,SAAS,MAAM,CAAC,MAAM,cAAc,4BAA4B,OAAO,CAAC;AAC/F,iBAAW,SAAS,gBAAgB;AAClC,cAAM,iBAAiB,SAAS,iBAAiB,CAAC,iBAAiB,KAAK,CAAC;AAAA,MAC3E;AACA,YAAM,QAAQ,WAAW;AAAA,QACvB,KAAK;AAAA,QACL,MAAM,CAAC,UAAU,cAAc,UAAU,WAAW,UAAU,OAAO,SAAS,CAAC;AAAA,QAC/E,UAAU;AAAA,MACZ,CAAC;AAED,aAAO,QAAQ;AAAA,IACjB;AAAA,IACA,MAAM,QAAQ,WAAkC;AAC9C,YAAM,UAAU,MAAM,QAAQ,IAAI,EAAE,UAAU,CAAC;AAC/C,YAAM,QAAQ,KAAK;AAAA,IACrB;AAAA,IACA,MAAM,OAAO,WAAoC;AAC/C,YAAM,UAAU,MAAM,QAAQ,IAAI,EAAE,UAAU,CAAC;AAC/C,aAAO,QAAQ,OAAO,SAAS;AAAA,IACjC;AAAA,IACA,MAAM,aAAa,WAAkC;AACnD,YAAM,UAAU,MAAM,QAAQ,IAAI,EAAE,UAAU,CAAC;AAC/C,YAAM,QAAQ,WAAW;AAAA,QACvB,KAAK;AAAA,QACL,MAAM,CAAC,UAAU,cAAc,UAAU,WAAW,UAAU,OAAO,SAAS,CAAC;AAAA,QAC/E,UAAU;AAAA,MACZ,CAAC;AAAA,IACH;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/providers/vercel.ts"],"sourcesContent":["import { Sandbox } from \"@vercel/sandbox\";\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 VercelProviderOptions {\n  create?: Record<string, unknown> | (() => Record<string, unknown> | Promise<Record<string, unknown>>);\n  agentPort?: number;\n}\n\nasync function resolveCreateOptions(value: VercelProviderOptions[\"create\"], agentPort: number): Promise<Record<string, unknown>> {\n  const resolved = typeof value === \"function\" ? await value() : (value ?? {});\n  return {\n    ports: [agentPort],\n    ...resolved,\n  };\n}\n\nasync function runVercelCommand(sandbox: InstanceType<typeof Sandbox>, cmd: string, args: string[] = []): Promise<void> {\n  const result = await sandbox.runCommand({ cmd, args });\n  if (result.exitCode !== 0) {\n    const stderr = await result.stderr();\n    throw new Error(`vercel command failed: ${cmd} ${args.join(\" \")}\\n${stderr}`);\n  }\n}\n\nexport function vercel(options: VercelProviderOptions = {}): SandboxProvider {\n  const agentPort = options.agentPort ?? DEFAULT_AGENT_PORT;\n\n  return {\n    name: \"vercel\",\n    defaultCwd: \"/home/vercel-sandbox\",\n    async create(): Promise<string> {\n      const sandbox = await Sandbox.create((await resolveCreateOptions(options.create, agentPort)) as Parameters<typeof Sandbox.create>[0]);\n\n      await runVercelCommand(sandbox, \"sh\", [\"-c\", `curl -fsSL ${SANDBOX_AGENT_INSTALL_SCRIPT} | sh`]);\n      for (const agent of DEFAULT_AGENTS) {\n        await runVercelCommand(sandbox, \"sandbox-agent\", [\"install-agent\", agent]);\n      }\n      await sandbox.runCommand({\n        cmd: \"sandbox-agent\",\n        args: [\"server\", \"--no-token\", \"--host\", \"0.0.0.0\", \"--port\", String(agentPort)],\n        detached: true,\n      });\n\n      return sandbox.sandboxId;\n    },\n    async destroy(sandboxId: string): Promise<void> {\n      const sandbox = await Sandbox.get({ sandboxId });\n      await sandbox.stop();\n    },\n    async getUrl(sandboxId: string): Promise<string> {\n      const sandbox = await Sandbox.get({ sandboxId });\n      return sandbox.domain(agentPort);\n    },\n    async ensureServer(sandboxId: string): Promise<void> {\n      const sandbox = await Sandbox.get({ sandboxId });\n      await sandbox.runCommand({\n        cmd: \"sandbox-agent\",\n        args: [\"server\", \"--no-token\", \"--host\", \"0.0.0.0\", \"--port\", String(agentPort)],\n        detached: true,\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;AAAA,SAAS,eAAe;AAIxB,IAAM,qBAAqB;AAO3B,eAAe,qBAAqB,OAAwC,WAAqD;AAC/H,QAAM,WAAW,OAAO,UAAU,aAAa,MAAM,MAAM,IAAK,SAAS,CAAC;AAC1E,SAAO;AAAA,IACL,OAAO,CAAC,SAAS;AAAA,IACjB,GAAG;AAAA,EACL;AACF;AAEA,eAAe,iBAAiB,SAAuC,KAAa,OAAiB,CAAC,GAAkB;AACtH,QAAM,SAAS,MAAM,QAAQ,WAAW,EAAE,KAAK,KAAK,CAAC;AACrD,MAAI,OAAO,aAAa,GAAG;AACzB,UAAM,SAAS,MAAM,OAAO,OAAO;AACnC,UAAM,IAAI,MAAM,0BAA0B,GAAG,IAAI,KAAK,KAAK,GAAG,CAAC;AAAA,EAAK,MAAM,EAAE;AAAA,EAC9E;AACF;AAEO,SAAS,OAAO,UAAiC,CAAC,GAAoB;AAC3E,QAAM,YAAY,QAAQ,aAAa;AAEvC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,YAAY;AAAA,IACZ,MAAM,SAA0B;AAC9B,YAAM,UAAU,MAAM,QAAQ,OAAQ,MAAM,qBAAqB,QAAQ,QAAQ,SAAS,CAA0C;AAEpI,YAAM,iBAAiB,SAAS,MAAM,CAAC,MAAM,cAAc,4BAA4B,OAAO,CAAC;AAC/F,iBAAW,SAAS,gBAAgB;AAClC,cAAM,iBAAiB,SAAS,iBAAiB,CAAC,iBAAiB,KAAK,CAAC;AAAA,MAC3E;AACA,YAAM,QAAQ,WAAW;AAAA,QACvB,KAAK;AAAA,QACL,MAAM,CAAC,UAAU,cAAc,UAAU,WAAW,UAAU,OAAO,SAAS,CAAC;AAAA,QAC/E,UAAU;AAAA,MACZ,CAAC;AAED,aAAO,QAAQ;AAAA,IACjB;AAAA,IACA,MAAM,QAAQ,WAAkC;AAC9C,YAAM,UAAU,MAAM,QAAQ,IAAI,EAAE,UAAU,CAAC;AAC/C,YAAM,QAAQ,KAAK;AAAA,IACrB;AAAA,IACA,MAAM,OAAO,WAAoC;AAC/C,YAAM,UAAU,MAAM,QAAQ,IAAI,EAAE,UAAU,CAAC;AAC/C,aAAO,QAAQ,OAAO,SAAS;AAAA,IACjC;AAAA,IACA,MAAM,aAAa,WAAkC;AACnD,YAAM,UAAU,MAAM,QAAQ,IAAI,EAAE,UAAU,CAAC;AAC/C,YAAM,QAAQ,WAAW;AAAA,QACvB,KAAK;AAAA,QACL,MAAM,CAAC,UAAU,cAAc,UAAU,WAAW,UAAU,OAAO,SAAS,CAAC;AAAA,QAC/E,UAAU;AAAA,MACZ,CAAC;AAAA,IACH;AAAA,EACF;AACF;","names":[]}

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

@@ -5,6 +5,22 @@ interface SandboxProvider {
     create(): Promise<string>;
     /** Permanently tear down a sandbox. */
     destroy(sandboxId: string): Promise<void>;
+    /**
+     * Reconnect to an existing sandbox before the SDK attempts health checks.
+     * Providers can use this to resume paused sandboxes or surface provider-specific
+     * reconnect errors.
+     */
+    reconnect?(sandboxId: string): Promise<void>;
+    /**
+     * Gracefully stop or pause a sandbox without permanently deleting it.
+     * When omitted, callers should fall back to `destroy()`.
+     */
+    pause?(sandboxId: string): Promise<void>;
+    /**
+     * Permanently delete a sandbox. When omitted, callers should fall back to
+     * `destroy()`.
+     */
+    kill?(sandboxId: string): Promise<void>;
     /**
      * Return the sandbox-agent base URL for this sandbox.
      * Providers that cannot expose a URL should implement `getFetch()` instead.
@@ -23,6 +39,12 @@ interface SandboxProvider {
      * (e.g. the duplicate process exits on port conflict).
      */
     ensureServer?(sandboxId: string): Promise<void>;
+    /**
+     * Default working directory for sessions when the caller does not specify
+     * one. Remote providers should set this to a path that exists inside the
+     * sandbox (e.g. '/home/user'). When omitted, falls back to process.cwd().
+     */
+    defaultCwd?: string;
 }
 
 export type { SandboxProvider as S };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sandbox-agent",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Universal API for automatic coding agents in sandboxes. Supports Claude Code, Codex, OpenCode, and Amp.",
   "license": "Apache-2.0",
   "repository": {
@@ -46,12 +46,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 +73,9 @@
     "@e2b/code-interpreter": {
       "optional": true
     },
+    "@fly/sprites": {
+      "optional": true
+    },
     "@vercel/sandbox": {
       "optional": true
     },
@@ -85,8 +93,8 @@
     }
   },
   "dependencies": {
-    "@sandbox-agent/cli-shared": "0.4.0",
-    "acp-http-client": "0.4.0"
+    "@sandbox-agent/cli-shared": "0.4.1",
+    "acp-http-client": "0.4.1"
   },
   "files": [
     "dist"
@@ -95,6 +103,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,7 +119,7 @@
     "ws": "^8.19.0"
   },
   "optionalDependencies": {
-    "@sandbox-agent/cli": "0.4.0"
+    "@sandbox-agent/cli": "0.4.1"
   },
   "scripts": {
     "generate:openapi": "SANDBOX_AGENT_SKIP_INSPECTOR=1 cargo run -p sandbox-agent-openapi-gen -- --out ../../docs/openapi.json",

package/dist/chunk-TWTMX66J.js

@@ -1,15 +0,0 @@
-// src/providers/shared.ts
-var DEFAULT_SANDBOX_AGENT_IMAGE = "rivetdev/sandbox-agent:0.4.0-full";
-var SANDBOX_AGENT_INSTALL_SCRIPT = "https://releases.rivet.dev/sandbox-agent/0.3.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-TWTMX66J.js.map

package/dist/chunk-TWTMX66J.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/providers/shared.ts"],"sourcesContent":["export const DEFAULT_SANDBOX_AGENT_IMAGE = \"rivetdev/sandbox-agent:0.4.0-full\";\nexport const SANDBOX_AGENT_INSTALL_SCRIPT = \"https://releases.rivet.dev/sandbox-agent/0.3.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":[]}