Files
deepseek-harness/packages/subagent
Tianyi Cui b49deaa8ee docs(subagent): require runtime-wide external run identities
SubagentRun.id previously promised uniqueness only within one parent,
but the unified manager indexes every external activation by that id in
one runtime-wide resident map. Publication also checks the live Agent and
Session registries. Two compliant-looking provider results could therefore
collide even when they belonged to different parents.

Document the existing shared Session id namespace across all parents,
providers, and local Sessions. Update the package reference, bilingual
type-equivalent declaration, and the current upgrade guide so custom
providers know to replace parent-local counters with fresh execution ids.
The shipped ACP, DSH SDK, Codex, and Claude Code providers already mint
UUIDs; no runtime mapping or additional retained identity state is needed.

Add a cross-parent collision test through startActivation. It proves that
publication rejects the duplicate, disposes only the new external handle,
leaves the second parent catalog empty, and preserves the first catalog
entry and execution result through normal cleanup.

Validation: all seven external-lifecycle tests pass, as do scoped bilingual
pairing, verify-upgrade-guides, doc-sync, and full lint. Cordis catalog and
inspection-catalog regeneration produces no tracked artifact changes.
2026-10-06 00:25:47 +08:00
..

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

Dev Note

None.