Sandbox SDK
Integrations

Eve

Use a Sandbox SDK provider as the backend for an Eve agent sandbox.

Eve has its own agent runtime and default harness. This integration does not use @ai-sdk/harness; it implements Eve's SandboxBackend interface.

Installation

Eve requires Node.js 24 or newer. For a manual Eve setup, install its normal dependencies with Sandbox SDK:

Terminal
bun add @opencoredev/sandbox-sdk eve ai zod

Configure the backend

agent/sandbox/sandbox.ts
import { defineSandbox } from "eve/sandbox";
import { createEveSandboxBackend } from "@opencoredev/sandbox-sdk/eve";
import { local } from "@opencoredev/sandbox-sdk/local";

export default defineSandbox({
  backend: createEveSandboxBackend({ provider: local() }),
  revalidationKey: () => "repo-bootstrap-v1",
  async bootstrap({ use }) {
    const sandbox = await use();
    await sandbox.writeTextFile({ path: "READY", content: "yes\n" });
  },
  async onSession({ use }) {
    await use();
  },
});

Eve runs bootstrap once for a template identity. Each durable session starts from those files, keeps later writes isolated, and can reconnect through Eve's saved backend metadata.

Choose a provider

import { local } from "@opencoredev/sandbox-sdk/local";
const backend = createEveSandboxBackend({ provider: local() });

Local runs in an isolated AgentOS VM inside the Eve host process. Its state lasts as long as that process unless your application persists it.

The backend maps Eve seed files, filesystem methods, process streams, reconnect metadata, and shutdown. Network-policy changes throw an unsupported SandboxError when the selected provider cannot enforce them.

Compare exact provider behavior in Compatibility, or return to the Integrations overview.

On this page