SDK client

Top-level Sandbox and Template exports read connection settings from the environment. Create an AgentBox client when one process needs explicit settings or more than one isolated configuration.

import { AgentBox } from "@abox-dev/sdk";

const client = new AgentBox({ apiKey: process.env.AGENTBOX_API_KEY });
const sandbox = await client.Sandbox.create();

try {
  const result = await sandbox.commands.run("printf 'explicit client works'");
  console.log(result.stdout);
} finally {
  await sandbox.kill();
}

Client settings are defaults. Options passed to a particular SDK call take precedence. In JavaScript the client exposes Sandbox and Template; Python also exposes their async variants.

AgentBox does not currently document a public Volumes API, BYOC deployment, or multiple managed regions. Do not build routing logic around those capabilities. Use the generated client reference for the exact options supported by the pinned SDK release.