Add OpenCode integration for Sandbox SDK

[ghostwriternr]

Summary

Adds support for running OpenCode (AI coding agent) inside Sandbox containers with three functions:

• createOpencodeServer() for server lifecycle management
• createOpencode() for programmatic SDK access (server + typed client)
• proxyToOpencode() for web UI request proxying

Usage

Web UI proxy:

import { createOpencodeServer, proxyToOpencode } from '@cloudflare/sandbox/opencode'

export default {
  async fetch(request, env) {
    const sandbox = getSandbox(env.Sandbox, 'opencode')
    const server = await createOpencodeServer(sandbox, {
      directory: '/home/user/project',
      config: { provider: { anthropic: { options: { apiKey: env.ANTHROPIC_API_KEY } } } }
    })
    return proxyToOpencode(request, sandbox, server)
  }
}

Programmatic SDK access:

import { createOpencode } from '@cloudflare/sandbox/opencode'

const { client, server } = await createOpencode<OpencodeClient>(sandbox, {
  directory: '/home/user/project',
  config: { provider: { anthropic: { options: { apiKey: env.ANTHROPIC_API_KEY } } } }
})

const session = await client.session.create({ body: { title: 'Task' } })
await client.session.prompt({ path: { id: session.data.id }, body: { ... } })

Implementation details

• Custom fetch adapter routes SDK requests through sandbox.containerFetch()
• Detects and reuses existing OpenCode server process on the same port
• Extracts API keys from config and sets as env vars (OpenCode expects ANTHROPIC_API_KEY etc.)
• Handles localhost redirect quirk for proper API routing in web UI
• Peer dependency on @opencode-ai/sdk (optional install)
• Example container pre-clones sample project for immediate use

[changeset-bot]

🦋 Changeset detected

Latest commit: 1a9d1fe

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@cloudflare/sandbox	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/cloudflare/sandbox-sdk/@cloudflare/sandbox@282

commit: 1a9d1fe

[github-actions]

🐳 Docker Images Published

Default (no Python):

FROM cloudflare/sandbox:0.0.0-pr-282-9de5893

With Python:

FROM cloudflare/sandbox:0.0.0-pr-282-9de5893-python

With OpenCode:

FROM cloudflare/sandbox:0.0.0-pr-282-9de5893-opencode

Version: 0.0.0-pr-282-9de5893

Use the -python variant for Python code execution, or -opencode for the OpenCode AI coding agent.