Skip to content

docs: parent resolution, prefix supply and the read-route token - #2340

Closed
ananthsub wants to merge 1 commit into
ananthsub/tokidcap/read-routefrom
ananthsub/tokidcap/docs-extras
Closed

docs: parent resolution, prefix supply and the read-route token#2340
ananthsub wants to merge 1 commit into
ananthsub/tokidcap/read-routefrom
ananthsub/tokidcap/docs-extras

Conversation

@ananthsub

@ananthsub ananthsub commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Documents the two optimizations that sit on top of the base feature.

Extends the page added in #2341 with:

How a rollout's calls are linked (#2180). By default calls chain by token prefix, which is correct but cannot tell two attempts of a retried call apart. The model server therefore identifies the parent at request time, by hashing the model-authored turns of an incoming request, and the page explains the two checks that must pass before a match is used and why a miss is harmless.

Prefix supply (#2181). What required_prefix_token_ids does, why re-rendering a conversation can split an assistant turn differently than the model sampled it, and that the backend has to honour the field for any of it to matter.

Both sections lead with the symptom a reader would actually see, delivered_fraction below 1.0 with chains above 1, since that is what sends someone to this page.

Depends on #2181.

@copy-pr-bot

copy-pr-bot Bot commented Aug 5, 2026

Copy link
Copy Markdown

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

@github-actions

github-actions Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

@ananthsub
ananthsub force-pushed the ananthsub/tokidcap/read-route branch from 3dea978 to cbf548b Compare August 5, 2026 01:13
@ananthsub
ananthsub force-pushed the ananthsub/tokidcap/docs-extras branch from 307b288 to 4bf5fa3 Compare August 5, 2026 01:13
@ananthsub
ananthsub force-pushed the ananthsub/tokidcap/read-route branch from cbf548b to cb2f6c6 Compare August 5, 2026 01:21
@ananthsub
ananthsub force-pushed the ananthsub/tokidcap/docs-extras branch from 4bf5fa3 to 7a7a0ca Compare August 5, 2026 01:21
@ananthsub ananthsub added the documentation Improvements to documentation label Aug 5, 2026
@ananthsub
ananthsub marked this pull request as ready for review August 5, 2026 01:30
@ananthsub
ananthsub force-pushed the ananthsub/tokidcap/read-route branch from cb2f6c6 to 6bad3e2 Compare August 5, 2026 02:13
@ananthsub
ananthsub force-pushed the ananthsub/tokidcap/docs-extras branch from 7a7a0ca to bdebca8 Compare August 5, 2026 02:13
@ananthsub
ananthsub force-pushed the ananthsub/tokidcap/docs-extras branch from bdebca8 to b308f9d Compare August 5, 2026 15:21
@ananthsub
ananthsub requested a review from a team as a code owner August 5, 2026 15:21
Adds the parts of the external-harness page that describe the optimizations on top
of capture: how a rollout's calls are linked and what a miss costs, what prefix
supply needs from a backend, and the bearer token on the read route.

Signed-off-by: Ananth Subramaniam <ansubramania@nvidia.com>
@ananthsub
ananthsub force-pushed the ananthsub/tokidcap/docs-extras branch from b308f9d to 3d0fdd0 Compare August 5, 2026 15:57
@ananthsub

Copy link
Copy Markdown
Contributor Author

Closing and reopening against the correct base. This PR was based on ananthsub/tokidcap/read-route, the branch of #2182, which has been dropped from the stack. The stack tooling would not repoint the base once #2182 was closed, so the cleanest fix is a fresh PR based on ananthsub/tokidcap/supplying. Same branch, same commit, same diff.

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

Labels

documentation Improvements to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant