SIGN IN SIGN UP

docs: document thinking-level model suffix in subagent tool surfaces (#1565)

* docs: document thinking-level model suffix in subagent tool surfaces

The subagent tool's flat schema exposes a `thinking` field that only
applies to action='watchdog.configure'. Calling models routinely pass it
on dispatch calls, where it validates and is silently ignored, so
children run at the agent's pinned thinking level no matter what the
orchestrator requested.

The supported per-run override is a thinking suffix on the model string
(provider/id:high etc.), which wins over agent frontmatter, but none of
the model-facing surfaces mentioned it: the tool descriptions had no
occurrence of thinking levels, the model param description didn't
mention suffixes, and the thinking field description didn't say it is
watchdog-only.

Document the suffix mechanism in the full, compact, and prompt-guideline
model bullets, the dispatch model param description, and the thinking
field description.

* docs: state suffix precedence in compact description, assert new guidance

Review feedback: the compact model bullet omitted that the thinking
suffix wins over the agent default (present in the full description and
prompt guidelines), and the test only bumped the byte budget without
asserting the new guidance. Add the precedence clause and pin the
suffix syntax, precedence, and watchdog-only scope in all three
surfaces.

* docs: credit thinking suffix guidance

Co-authored-by: Yanqiang Lu <yanqianglu@users.noreply.github.com>

---------

Co-authored-by: Yanqiang Lu <yanqianglu@users.noreply.github.com>
Co-authored-by: Nico Bailon <nico.bailon@gmail.com>
Y
YanQiang Lu committed
b08f5d85c5e89e3782b874210a678be27357bc84
Parent: e3987ad
Committed by GitHub <noreply@github.com> on 8/26/2026, 11:37:53 PM