@sandagent/sandbox-sandock

Sandock sandbox adapter for SandAgent.

Run SandAgent inside a Sandock-hosted Docker sandbox (optionally using a prebuilt image for fast startup).

Install

npm install @sandagent/sandbox-sandock @sandagent/manager

Quickstart

Prereqs:

• Node.js 20+
• SANDOCK_API_KEY
• ANTHROPIC_API_KEY (or your runner credentials)

import { SandAgent } from "@sandagent/manager";
import { SandockSandbox } from "@sandagent/sandbox-sandock";

const sandbox = new SandockSandbox({
  apiKey: process.env.SANDOCK_API_KEY,
  workdir: "/workspace",
  // Optional: use a prebuilt image that already contains runner + dependencies.
  image: "vikadata/sandagent:0.1.0",
  skipBootstrap: true,
  env: {
    ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY!,
  },
  // Optional persistence (workspace + Claude session storage, etc.)
  // volumes: [
  //   { volumeName: "my-workspace", volumeMountPath: "/workspace" },
  //   { volumeName: "my-claude-session", volumeMountPath: "/root/.claude" },
  // ],
});

const agent = new SandAgent({
  sandbox,
  runner: {
    kind: "claude-agent-sdk",
    model: "claude-sonnet-4-20250514",
    outputFormat: "stream",
  },
  env: {
    ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY!,
  },
});

const stream = await agent.stream({
  messages: [{ role: "user", content: "Create a hello world program" }],
  workspace: { path: "/workspace" },
});

Notes

• If skipBootstrap is true, the adapter uses sandagent run from the image.
• If skipBootstrap is false, the adapter installs @sandagent/runner-cli@beta into the sandbox workdir on attach, then uses ${workdir}/node_modules/.bin/sandagent.

License

Apache-2.0