docs: supersede RFC 2447 with SDK-owned runtime RFC - #2550
Merged
Conversation
3 tasks
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
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.
Summary
Why
RFC 2447 combined the typed SDK contract, ABI direction, runtime ownership, MCP topology, permission-mode isolation, and platform lifecycle into one broad proposal. RFC 2549 keeps the contract decisions that have proven useful and replaces the less focused runtime and process-topology guidance with explicit ownership, lifecycle, platform, authentication, migration, and acceptance gates.
The permission contract is deliberately separated from the process topology. Effective authority is the intersection of an immutable runtime ceiling, an immutable session context, managed policy, and user policy. A model-visible tool argument, public session ID, MCP metadata field, or reconnect token is never authority.
Discussion: #2549
Supersedes: #2447
Related remote-connection proposal: #2513
Canonical authorization prerequisite: #2542
Portable session-authorization foundation: #2545
Compatibility promise
This refactor is not allowed to disrupt current CLI, MCP, Rust, Python, or TypeScript users. Existing commands, defaults, flags, sockets, platform identity, exit codes, schemas, constructors, typed methods, package exports, result envelopes, structured errors, and lifecycle behavior are explicit release gates.
Released callers that do not use a future trusted host session API inherit a compatibility session with today's behavior and require no source changes. The host-only session factory is additive. Mixed modes are exposed only on topologies whose session-to-action binding passes substitution, replay, expiry, revocation, generation, and reconnect tests.
Browser-use improvements may continue shipping through the current CLI and daemon topology. Canonical dispatch authorization (#2542) and the portable session-authorization foundation (#2545) can land before the larger SDK-owned-runtime refactor; direct SDK ownership, private workers, remote connections, and service cleanup do not block the browser release.
Security and disclosure review
The public issue, RFC, north-star note, and staged diff were scanned for credentials, private paths, private user or partner context, sensitive screenshots, raw session material, and vulnerability details. The proposal states target security requirements without publishing implementation-state vulnerability claims.
Validation
npm --prefix docs run docs:check-hygienenpm --prefix docs run docs:check-linksnpm --prefix docs run docs:check