Add Modal and ComputeSDK built-in providers, update examples and docs

- Add `sandbox-agent/modal` provider using Modal SDK with node:22-slim image
- Add `sandbox-agent/computesdk` provider using ComputeSDK's unified sandbox API
- Update Modal and ComputeSDK examples to use new SDK providers
- Update Modal and ComputeSDK deploy docs with provider-based examples
- Add Modal to quickstart CodeGroup and docs.json navigation
- Add provider test entries for Modal and ComputeSDK
- Remove old standalone example files (modal.ts, computesdk.ts)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

examples/modal/package.json

@@ -3,7 +3,7 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "start": "tsx src/modal.ts",
+    "start": "tsx src/index.ts",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {

examples/modal/src/index.ts

@@ -0,0 +1,30 @@
+import { SandboxAgent } from "sandbox-agent";
+import { modal } from "sandbox-agent/modal";
+import { detectAgent } from "@sandbox-agent/example-shared";
+
+const secrets: Record<string, string> = {};
+if (process.env.ANTHROPIC_API_KEY) secrets.ANTHROPIC_API_KEY = process.env.ANTHROPIC_API_KEY;
+if (process.env.OPENAI_API_KEY) secrets.OPENAI_API_KEY = process.env.OPENAI_API_KEY;
+
+const client = await SandboxAgent.start({
+  sandbox: modal({
+    create: { secrets },
+  }),
+});
+
+console.log(`UI: ${client.inspectorUrl}`);
+
+const session = await client.createSession({
+  agent: detectAgent(),
+});
+
+session.onEvent((event) => {
+  console.log(`[${event.sender}]`, JSON.stringify(event.payload));
+});
+
+session.prompt([{ type: "text", text: "Say hello from Modal in one sentence." }]);
+
+process.once("SIGINT", async () => {
+  await client.destroySandbox();
+  process.exit(0);
+});

examples/modal/src/modal.ts

@@ -1,123 +0,0 @@
-import { ModalClient } from "modal";
-import { SandboxAgent } from "sandbox-agent";
-import { detectAgent, buildInspectorUrl, waitForHealth } from "@sandbox-agent/example-shared";
-import { fileURLToPath } from "node:url";
-import { resolve } from "node:path";
-import { run } from "node:test";
-
-const PORT = 3000;
-const APP_NAME = "sandbox-agent";
-
-async function buildSecrets(modal: ModalClient) {
-  const envVars: Record<string, string> = {};
-  if (process.env.ANTHROPIC_API_KEY) 
-    envVars.ANTHROPIC_API_KEY = process.env.ANTHROPIC_API_KEY;
-  if (process.env.OPENAI_API_KEY) 
-    envVars.OPENAI_API_KEY = process.env.OPENAI_API_KEY;
-
-  if (Object.keys(envVars).length === 0) return [];
-  return [await modal.secrets.fromObject(envVars)];
-}
-
-export async function setupModalSandboxAgent(): Promise<{
-  baseUrl: string;
-  cleanup: () => Promise<void>;
-}> {
-  const modal = new ModalClient();
-  const app = await modal.apps.fromName(APP_NAME, { createIfMissing: true });
-
-  const image = modal.images
-    .fromRegistry("ubuntu:22.04")
-    .dockerfileCommands([
-      "RUN apt-get update && apt-get install -y curl ca-certificates",
-      "RUN curl -fsSL https://releases.rivet.dev/sandbox-agent/0.2.x/install.sh | sh",
-    ]);
-
-  const secrets = await buildSecrets(modal);
-
-  console.log("Creating Modal sandbox!");
-  const sb = await modal.sandboxes.create(app, image, {
-    secrets: secrets, 
-    encryptedPorts: [PORT],
-  });
-  console.log(`Sandbox created: ${sb.sandboxId}`);
-
-  const exec = async (cmd: string) => {
-    const p = await sb.exec(["bash", "-c", cmd], {
-      stdout: "pipe",
-      stderr: "pipe",
-    });
-    const exitCode = await p.wait();
-    if (exitCode !== 0) {
-      const stderr = await p.stderr.readText();
-      throw new Error(`Command failed (exit ${exitCode}): ${cmd}\n${stderr}`);
-    }
-  };
-
-  if (process.env.ANTHROPIC_API_KEY) {
-    console.log("Installing Claude agent...");
-    await exec("sandbox-agent install-agent claude");
-  }
-  if (process.env.OPENAI_API_KEY) {
-    console.log("Installing Codex agent...");
-    await exec("sandbox-agent install-agent codex");
-  }
-
-  console.log("Starting server...");
-
-  await sb.exec(
-    ["bash", "-c", `sandbox-agent server --no-token --host 0.0.0.0 --port ${PORT} &`],
-  );
-
-  const tunnels = await sb.tunnels();
-  const tunnel = tunnels[PORT];
-  if (!tunnel) {
-    throw new Error(`No tunnel found for port ${PORT}`);
-  }
-  const baseUrl = tunnel.url;
-
-  console.log("Waiting for server...");
-  await waitForHealth({ baseUrl });
-
-  const cleanup = async () => {
-    try {
-      await sb.terminate();
-    } catch (error) {
-      console.warn("Cleanup failed:", error instanceof Error ? error.message : error);
-    }
-  };
-
-  return { baseUrl, cleanup };
-}
-
-export async function runModalExample(): Promise<void> {
-  const { baseUrl, cleanup } = await setupModalSandboxAgent();
-
-  const handleExit = async () => {
-    await cleanup();
-    process.exit(0);
-  };
-
-  process.once("SIGINT", handleExit);
-  process.once("SIGTERM", handleExit);
-
-  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.");
-
-  await new Promise(() => {});
-}
-
-const isDirectRun = Boolean(
-  process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url),
-);
-
-if (isDirectRun) {
-  runModalExample().catch((error) => {
-    console.error(error instanceof Error ? error.message : error);
-    process.exit(1);
-  });
-}

examples/modal/tests/modal.test.ts

@@ -1,26 +1,29 @@
 import { describe, it, expect } from "vitest";
-import { buildHeaders } from "@sandbox-agent/example-shared";
-import { setupModalSandboxAgent } from "../src/modal.ts";
+import { SandboxAgent } from "sandbox-agent";
+import { modal } from "sandbox-agent/modal";
 
 const shouldRun = Boolean(process.env.MODAL_TOKEN_ID && process.env.MODAL_TOKEN_SECRET);
 const timeoutMs = Number.parseInt(process.env.SANDBOX_TEST_TIMEOUT_MS || "", 10) || 300_000;
 
 const testFn = shouldRun ? it : it.skip;
 
-describe("modal example", () => {
+describe("modal provider", () => {
   testFn(
     "starts sandbox-agent and responds to /v1/health",
     async () => {
-      const { baseUrl, cleanup } = await setupModalSandboxAgent();
+      const secrets: Record<string, string> = {};
+      if (process.env.ANTHROPIC_API_KEY) secrets.ANTHROPIC_API_KEY = process.env.ANTHROPIC_API_KEY;
+      if (process.env.OPENAI_API_KEY) secrets.OPENAI_API_KEY = process.env.OPENAI_API_KEY;
+
+      const sdk = await SandboxAgent.start({
+        sandbox: modal({ create: { secrets } }),
+      });
+
       try {
-        const response = await fetch(`${baseUrl}/v1/health`, {
-          headers: buildHeaders({}),
-        });
-        expect(response.ok).toBe(true);
-        const data = await response.json();
-        expect(data.status).toBe("ok");
+        const health = await sdk.getHealth();
+        expect(health.status).toBe("ok");
       } finally {
-        await cleanup();
+        await sdk.destroySandbox();
       }
     },
     timeoutMs,