Dudu-0223andimccyu
0487699ae4
* feat(subagent): share identity and collaboration guidance * fix(subagent): complete shared guidance snapshot expectations * fix(subagent): match task descriptions to the user language * refactor(subagent): retain shared guidance with Session ids * test(subagent): recognize parent ids in shared identity * Checkpoint ID collaboration guidance generated expectations * Preserve historical Web schema sidecars * fix(test-support): preserve job references during snapshot refresh * test(subagent): refresh ID-only collaboration guidance outputs * fix(subagent): rely on list_agents tool description * fix(subagent): keep collaboration guidance consistent with live identity * test(team): parse parent identity from shared guidance * test(subagent): address parent from shared identity context * test(subagent): refresh compiled Web guidance snapshots * test(subagent): refresh browser collaboration context fixtures * docs(subagent): attribute required identity to standard controls * fix(subagent): clarify collaboration identity prompts * test(subagent): remove duplicate PowerShell collaboration context * refactor(subagent): match unavailable-root errors by name and code --------- Co-authored-by: imccyu <[email protected]>
description, kind
| description | kind |
|---|---|
| The subagent package group: the delegation seam, its in-process and out-of-process backends, and the model-facing delegation tools. | package-group |
subagent/ — subagent capability family
English | 中文
Summary
The subagent package family lets an agent delegate a task to a child, continue the child's work, and discover every child it created. Choose a fresh in-process child for isolated work, a history-seeded in-process child when prior conversation matters, or an out-of-process child backed by ACP, Codex, Claude Code, or another Harness runtime. Model-facing tools also let agents message adjacent agents, interrupt work, and list child status. Each child remains visible to its parent whether it is running or stored; the package READMEs document provider-specific setup and limits.
Table of Contents
Packages
| Package | Role | ctx key |
|---|---|---|
subagent/ |
Defines the delegation service: provider registry, one-shot runs, continuable children, and discovery | ctx.subagents |
subagent-spawn-in-process/ |
Runs a fresh in-process child | registers on ctx.subagents |
subagent-fork-in-process/ |
Runs an in-process child seeded from the parent's completed history | registers on ctx.subagents |
subagent-acp/ |
Runs an out-of-process child over the Agent Client Protocol | registers on ctx.subagents |
subagent-codex/ |
Runs a real Codex child through the official app-server protocol | registers on ctx.subagents |
subagent-claude-code/ |
Runs a real Claude Code child through the official Agent SDK | registers on ctx.subagents |
subagent-dsh-sdk/ |
Runs an out-of-process Harness child through the TypeScript SDK | registers on ctx.subagents |
tool-subagent/ |
Exposes delegation to the model | registers on ctx.tools |
tool-subagent-control/ |
Exposes adjacent-agent messaging, interrupt, and listing to the model | registers on ctx.tools |
Related documentation
- Subagent subsystem — the service contract, provider contract, and terminal result semantics.
- historical Subagent capability seam — the design record for the delegation capability family.
- Continuable subagents — durable children that accept follow-up turns.
- tool-subagent-control README — the follow-up, interrupt, and listing surface.
Dev Note
None.