chore: add boxlite

examples/boxlite/.gitignore

@@ -0,0 +1 @@
+oci-image/

examples/boxlite/Dockerfile

@@ -0,0 +1,5 @@
+FROM node:22-bookworm-slim
+RUN apt-get update && apt-get install -y curl ca-certificates && rm -rf /var/lib/apt/lists/*
+RUN curl -fsSL https://releases.rivet.dev/sandbox-agent/0.2.x/install.sh | sh
+RUN sandbox-agent install-agent claude
+RUN sandbox-agent install-agent codex

examples/boxlite/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@sandbox-agent/example-boxlite",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "start": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@boxlite-ai/boxlite": "latest",
+    "@sandbox-agent/example-shared": "workspace:*",
+    "sandbox-agent": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "latest",
+    "tsx": "latest",
+    "typescript": "latest"
+  }
+}

examples/boxlite/src/index.ts

@@ -0,0 +1,46 @@
+import { SimpleBox } from "@boxlite-ai/boxlite";
+import { SandboxAgent } from "sandbox-agent";
+import { detectAgent, buildInspectorUrl, waitForHealth } from "@sandbox-agent/example-shared";
+import { setupImage, OCI_DIR } from "./setup-image.ts";
+
+const env: Record<string, string> = {};
+if (process.env.ANTHROPIC_API_KEY) env.ANTHROPIC_API_KEY = process.env.ANTHROPIC_API_KEY;
+if (process.env.OPENAI_API_KEY) env.OPENAI_API_KEY = process.env.OPENAI_API_KEY;
+
+setupImage();
+
+console.log("Creating BoxLite sandbox...");
+const box = new SimpleBox({
+	rootfsPath: OCI_DIR,
+	env,
+	ports: [{ hostPort: 3000, guestPort: 3000 }],
+	diskSizeGb: 4,
+});
+
+console.log("Starting server...");
+const result = await box.exec(
+	"sh", "-c",
+	"nohup sandbox-agent server --no-token --host 0.0.0.0 --port 3000 >/tmp/sandbox-agent.log 2>&1 &",
+);
+if (result.exitCode !== 0) throw new Error(`Failed to start server: ${result.stderr}`);
+
+const baseUrl = "http://localhost:3000";
+
+console.log("Waiting for server...");
+await waitForHealth({ baseUrl });
+
+const client = await SandboxAgent.connect({ baseUrl });
+const session = await client.createSession({ agent: detectAgent(), sessionInit: { cwd: "/root", mcpServers: [] } });
+const sessionId = session.id;
+
+console.log(`  UI: ${buildInspectorUrl({ baseUrl, sessionId })}`);
+console.log("  Press Ctrl+C to stop.");
+
+const keepAlive = setInterval(() => {}, 60_000);
+const cleanup = async () => {
+	clearInterval(keepAlive);
+	await box.stop();
+	process.exit(0);
+};
+process.once("SIGINT", cleanup);
+process.once("SIGTERM", cleanup);

examples/boxlite/src/setup-image.ts

@@ -0,0 +1,16 @@
+import { execSync } from "node:child_process";
+import { existsSync, mkdirSync } from "node:fs";
+
+export const DOCKER_IMAGE = "sandbox-agent-boxlite";
+export const OCI_DIR = new URL("../oci-image", import.meta.url).pathname;
+
+export function setupImage() {
+	console.log(`Building image "${DOCKER_IMAGE}" (cached after first run)...`);
+	execSync(`docker build -t ${DOCKER_IMAGE} ${new URL("..", import.meta.url).pathname}`, { stdio: "inherit" });
+
+	if (!existsSync(`${OCI_DIR}/oci-layout`)) {
+		console.log("Exporting to OCI layout...");
+		mkdirSync(OCI_DIR, { recursive: true });
+		execSync(`docker save ${DOCKER_IMAGE} | tar -xf - -C ${OCI_DIR}`, { stdio: "inherit" });
+	}
+}

examples/boxlite/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM"],
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "allowImportingTsExtensions": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "**/*.test.ts"]
+}