docs(delegation): align guidance with current contract - #66556
Closed
helix4u wants to merge 2 commits into
Closed
Conversation
helix4u
marked this pull request as ready for review
July 17, 2026 22:17
This was referenced Jul 17, 2026
Contributor
|
Salvaged and merged as #66576 (rebased so your commit keeps authorship). I added one small follow-up commit cleaning up two stale internal comments in |
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.
What does this PR do?
Aligns the delegation documentation and model-facing tool description with the contract currently shipped on
main.PR #56386 intentionally removed model-controlled
toolsetsfromdelegate_taskso children inherit the parent's enabled capabilities. The feature reference, delegation guide, Chinese translations, and several live description strings still advertised that removed argument. The same pages also described top-level delegation as synchronous even though #49734 made top-level model dispatch background by default.This update removes the invalid call shapes and documents the current lifecycle without changing runtime behavior. PR #55010 remains the separate proposal to restore an explicit
background=falseescape hatch.Related Issue
Follow-up to #56386 and #49734. Related behavior proposal: #55010.
Type of Change
Changes Made
toolsetsarguments from English and Chinese delegation examples.delegate_taskdescription to advertise one batch handle and one consolidated result instead of nonexistent per-task handles.toolsetsreferences from the Python docstrings and dynamic schema descriptions.How to Test
pythondocumentation blocks withast.parse— passed.HERMES_HOMEand verified that neither schema shape exposestoolsets, the description advertises one batch handle/consolidated result, and the stale parameter wording is absent — passed.git diff --check— passed.Checklist
Code
fix(scope):,feat(scope):, etc.)pytest tests/ -qand all tests pass — not run for this documentation-only correction; focused validation is listed aboveDocumentation & Housekeeping
docs/, docstrings) — or N/Acli-config.yaml.exampleif I added/changed config keys — N/A: no config changeCONTRIBUTING.mdorAGENTS.mdif I changed architecture or workflows — N/A: no architecture or workflow changeScreenshots / Logs
N/A — documentation and model-facing description correction.