@agent-os/workspace-session-cloudflare
Purpose
Section titled “Purpose”Cloudflare Sandbox-compatible backend for @agent-os/workspace-session.
Invariant
Section titled “Invariant”The workspace-session carrier owns lifecycle facts. This backend supplies concrete session, workspace root, cleanup, backup, preview, and destroy proof refs plus bounded exec inside an existing session. SDK clients, namespace bindings, preview tokens, backup handle objects, exec output bodies, and sandbox objects never enter ledger-visible payloads.
Minimal Usage
Section titled “Minimal Usage”Adapt a structural Cloudflare Sandbox namespace or client and pass the provider
to the workspace-session carrier. Missing refs fail closed; there is no
resolver-derived or ambient fallback.
Exec uses sessionRef to recover the existing sandbox session and runs one
bounded command with capped stdout/stderr. It does not allocate preview ports or
background processes.
import { makeCloudflareWorkspaceSessionLiveProvider } from "@agent-os/workspace-session-cloudflare";Verification
Section titled “Verification”cd packages/providers/workspace-session-cloudflarevp test runReal Cloudflare Sandbox smoke requires an app-supplied namespace binding.