sandbox-migrate-to-next

Install @cloudflare/sandbox@next, switch the Dockerfile to cloudflare/sandbox:next, then replace stable APIs using the migration map: string exec becomes argv-based exec returning a process handle, sessions are removed, and terminals use createTerminal plus connect.

String exec was replaced by argv-based exec that returns a process handle instead of a buffered result. Call process.output({ encoding: "utf8" }) to get results, and use an explicit shell binary like /bin/bash -lc for shell syntax.

No. Stable and @next control protocols are incompatible both ways, so gradual rollout leaves a broken mixed window. Production cutover requires a single deploy with wrangler deploy --containers-rollout=immediate.

No. Default and named sessions are removed; pass cwd and env per launch instead. gitCheckout is also gone—run git commands through argv-based exec, such as git clone with a working directory option.

In the 1.0 preview, await sandbox.exec only means the process started, not that the command completed. You must await process.output or use waitFor methods to observe completion, and timeouts only cancel the wait, not the process.