Skip to content

docs(rfd): move session options to preview - #2941

Open
benbrandt wants to merge 1 commit into
mainfrom
docs/session-options-preview
Open

benbrandt wants to merge 1 commit into
mainfrom
docs/session-options-preview

Conversation

@benbrandt

Copy link
Copy Markdown
Member

Move the Session options RFD from Draft to Preview for feedback from Agent and Client implementers. session/options and initial configOptions remain behind unstable_session_options. No schemas, feature gates, or wire requirements change.

The RFD now links to released SDK support and wire tests instead of listing planned examples. The draft guides and v2 overview also name session/fork alongside the other setup methods that accept initial values. The fork field itself landed in #2794.

What to try

Use npx -y @agentclientprotocol/claude-agent-acp@0.109.1-preview.5 as the Agent command. After checking the advertised capability, call session/options for a workspace, then send a model and reasoning level on session/new and compare the resulting options. For an existing session, compare the preview with session/resume in the same workspace. This package includes the v1 changed-workspace fix.

Rust SDK 5.3.0 and TypeScript SDK 2.7.0 include the fork field for both protocol versions. Delta uses discovery before the first prompt and sends choices on new. Zed uses the initial values on new behind acp-beta, without querying first.

Validation

  • npm run check passed. Mint validation of the five changed MDX pages passed (mint validate --no-build --files …).
  • Ran the exact published Agent command above over stdio on v1 and v2. Discovery left the session list unchanged, wrote no transcript, and sent no session updates. session/new then applied the selected model on both versions.
  • Full-site mint validate stops at docs/get-started/registry.mdx:954:7 on an SVG doctype. The same error reproduces on unmodified main at 1a52ecae.

Please leave this PR open for a few days for feedback before merging.

@benbrandt
benbrandt requested a review from a team as a code owner November 20, 2026 16:04

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant