镜像站点 · 本页由第三方 GitHub 只读镜像提供,非 GitHub 官方站点,不接受任何登录或凭据输入。前往 github.com
Skip to content

feat(unstable): add session/set_title method - #2734

Merged
benbrandt merged 1 commit into
mainfrom
feat/session-set-title
Oct 30, 2026
Merged

benbrandt merged 1 commit into
mainfrom
feat/session-set-title

Conversation

@benbrandt

Copy link
Copy Markdown
Member

Adds schema support for the session-set-title RFD behind a new unstable_session_set_title feature (included in unstable), in both v1 and v2.

Shape

// session/set_title
SetSessionTitleRequest  { sessionId: SessionId, title: string, _meta? }
SetSessionTitleResponse { title: string, _meta? }   // the title the Agent stored, possibly normalized
  • Required and strict: both title fields. A missing, null or non-string title is rejected, because the Agent stores the request title and the Client displays the response title.
  • Capability: sessionCapabilities.title in v1 and session.title in v2, as a SessionTitleCapabilities object where {} means supported. Agents still report titles through session/list and session_info_update without it.

Capability name change from the RFD

The RFD proposed setTitle. Every other session capability is either a method verb (delete, fork, resume) or a feature name (mcp, systemPrompt, additionalDirectories), so setTitle would have been the only verb-plus-noun key. title follows the feature-name style, and later title features can add fields to it, such as the initial title on session/new proposed in #1978. I updated the RFD's capability section and revision history to match.

Docs

  • v2 overview: a row in the unstable features table.
  • initialization pages (v1 and v2): a title field.
  • error pages (v1 and v2): unknown session gets -32002 (the session doesn't have to be active), and a rejected title gets -32602.
  • Generated: unstable JSON schemas and draft schema.mdx pages.

Add schema support for the session-set-title RFD behind the new
`unstable_session_set_title` feature, in both v1 and v2:

- `session/set_title` request with a required `sessionId` and `title`
- response returning the title the agent stored, which may be
  normalized
- `sessionCapabilities.title` (v1) / `session.title` (v2) capability,
  renamed from `setTitle` in the RFD so later title features can extend
  the same object
- draft overview, initialization, and error page entries
@benbrandt
benbrandt requested a review from a team as a code owner October 30, 2026 18:02
@benbrandt
benbrandt enabled auto-merge (squash) October 30, 2026 18:06
@benbrandt
benbrandt merged commit ef8263a into main Oct 30, 2026
14 checks passed
@benbrandt
benbrandt deleted the feat/session-set-title branch October 30, 2026 18:10
@acp-release-bot acp-release-bot Bot mentioned this pull request Oct 30, 2026
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