Conversation
workspace.repl(name, { capabilities }) grants live objects into a session
as globals. Method calls cross a host-side recorder bridge (native Workers
RPC) and commit into the session log as effects; replaying committed cells
makes zero live calls — state survives eviction without re-firing a single
side effect.
- capability(target, meta?): wrap any object, class instance, RPC stub, or
bare function; description and per-method docs ride along as typed meta.
- Handles: callable results (tabs, responses, …) become host-registered
handles, chainable across cells. They die with the session host; new
code using a dead handle gets a stale-lease error carrying its
acquisition recipe. Revoking a root grant cuts every handle descending
from it.
- Attach-time grants: every repl() call re-attaches. Committed cells
replay under the grant shapes (including data snapshots) they were
recorded with; new cells see the current attachment.
- fetchCapability(): ambient / gateway / allowlisted fetch as an ordinary
capability; ambient fetch inside cells fails with guidance instead.
- workspaceFs(): the workspace filesystem as a capability — writes are
recorded once and never re-fired on replay.
- Structured error kinds: stale-lease, not-granted, oversized-result
(reject, never truncate); replay divergence is now args-aware.
- One JSON-safe value codec (undefined, Date, bigint, bytes, Map, Set)
shared host/isolate by injecting its source into the runner module.
ben-reitz
added this pull request to stack #155
September 23, 2026 09:13
|
Contributor
|
Thanks for your interest in Cloudflare Computer. This repository does not accept unsolicited pull requests. Please use one of the accepted contribution paths instead:
If a maintainer asked you to open this pull request, they can add the |
ben-reitz
changed the title
![devin-ai-integration[bot]](https://avatars.githubusercontent.com/in/811515?s=60&v=4){kind=small}
ben-reitz
changed the title
ben-reitz
marked this pull request as draft
September 23, 2026 09:26
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Lets a session call host code through granted capabilities (
capability(),fetchCapability(), workspace fs).