Repository navigation
docs(schema): reorder the protocol pages and rename Cancellation - #2964
Merged
Merged
Conversation
Keep the connection lifecycle order at the top, then order the rest by what each page depends on. Agent Plan follows Tool Calls, Subagents moves after the pages it links to, and the protocol-wide pages run Transports, Cancellation, Errors, Extensibility, Security. In v1, Session Config Options now comes before Session Modes, which it supersedes. The hidden draft groups follow the same order.
The page covers `$/cancel_request`. Session cancellation with `session/cancel` is on the prompt pages, so the old title read as the wrong topic in the nav. The URL is unchanged. Update the "See protocol docs" links that named the page by its title and regenerate the schema files.
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
Two changes to how the protocol pages read in the sidebar.
Page order
The top of the list already follows the connection lifecycle: Initialization, Authentication, Session Setup, then the prompt pages. The rest is now ordered by what each page depends on.
session/updatemessages the Agent sends while a prompt runs.Migrating from v1 stays second in the v2 list while v2 is in Preview.
Page title
"Cancellation" is now "Request Cancellation" in v1, v2, and their drafts. The page covers
$/cancel_request.session/cancelis on the prompt pages, so the old title read as the wrong topic. The RFD and the stabilization announcement already use the new name.The URL is unchanged. The "See protocol docs" links that named the page by its old title are updated, and the schema files are regenerated. Only that link text changes in the
$/cancel_requestdescriptions.Testing
npm run generatecargo clippyin the three configurations fromnpm run checknpm run format:checkandnpm run spellcheckcargo test --all-features