Files
deepseek-harness/packages/subagent
Tianyi Cui d49efe8b0f docs(sdk): state the task completion runtime requirement
The SDK subagent provider now uses session/wait to keep a delegated child
runtime alive through nested work. A deployment that explicitly selects an
older dshBin can still initialize and accept a prompt but cannot satisfy
that completion request; it must report an execution failure rather than
silently treating the first idle as success.

State the required operation in the provider's owning failure/recovery
contract and update the current activation upgrade guide to tell users to
upgrade a separately configured runtime with the provider. This adds no
capability negotiation, compatibility fallback, or new runtime behavior.

Validation: upgrade-guide structure/word budget and both bilingual pairs
pass. The requirement matches the provider's direct session/wait request
and the SDK server's explicit unknown-method rejection.
2026-10-06 01:12:59 +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.