docs(delegation,api): document stall detection, timeout metadata, /agents live status, runs-stream lifecycle - #72519
Merged
Merged
Conversation
…ents live status, runs-stream subagent lifecycle Catch the docs up to this week's delegation work: - delegation.md: structured timeout metadata fields (timeout_seconds/ timed_out_after_seconds/timeout_phase, #72403); new 'Stall Detection for Background Subagents' section (progress-based monitor, thresholds, grace window, stalled event metadata, root-cause fix note — #72227/ #72300/#72412); /agents per-child live activity on CLI + gateway; all-thread diagnostic dump note. - api-server.md: /v1/runs events stream now documents subagent.start/ subagent.complete forwarding, redaction, child_session_id, and the deliberate exclusion of per-tool child events (#72406). - sidebars.ts: register the subagent-lifecycle-api developer guide page (shipped in #72501 but absent from the sidebar). Docusaurus build verified.
Contributor
૮ >ﻌ< ა ci reviewran on d5d83e9 all good! |
alt-glitch
added
type/docs
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
2 participants
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
Docs catch-up for this week's delegation work — the six merged PRs shipped features that weren't yet reflected on the docs site.
Changes
delegation.md:timeout_seconds/timed_out_after_seconds/timeout_phase) on capped-child results (feat(delegate): expose redacted child tool history in subagent_stop (salvage #62011) #72403).stalledevent metadata, and the root-cause note on the inline API-call fix (fix(delegation): progress-based stale detection for detached async runners #72227, feat(delegation): structured timeout/stall metadata + live per-child status in /agents #72300, fix(delegation): route delegated-child API calls inline to avoid nested-pool wedge (#60203) #72412)./agentsnow documents the per-child live activity rows on classic CLI + gateway platforms, including thestallingdisplay (feat(delegation): structured timeout/stall metadata + live per-child status in /agents #72300).api-server.md:/v1/runs/{id}/eventsdocumentssubagent.start/subagent.completeforwarding, forced redaction,child_session_idcorrelation, and the deliberate exclusion of per-tool child events (fix(api): forward subagent lifecycle on /v1/runs stream (salvage #51642) #72406).sidebars.ts: registers thesubagent-lifecycle-apideveloper-guide page (shipped in feat(plugins): public subagent lifecycle API (salvage #63359) #72501 but missing from the sidebar — the page was unreachable by navigation).Validation
npx docusaurus build— SUCCESS, all locales.Infographic