子代理：在同一个 harness 里嵌套 agent

示例本次示例：模型把「读代码」委派给子代理

# 主会话里模型调用 subagent 工具：
# tool-subagent 执行（inject=['agents','tools','subagents'...]）
# → SubagentRuntime（subagent/src/index.ts:171）发起委派
# → spawn-in-process provider（inject=['subagents']）：
#    ① sessions.create(子会话, meta:{ parentSession: 主会话id, delegationDepth: 1 })
#    ② AgentFactory 创建子 agent（同进程，跑 05-14 页同一套循环）
#    ③ 子会话日志独立：~/.dsh/sessions/<子sid>.jsonl
# 子 agent 完成 → 结果消息回主会话 → 主会话日志只多一条「委派结果」
#
# 真实 fixture 里的血缘（06 页示例轨迹 06-1）：
{ "type": "session", "id": "eeeeeeee-1111-4222-8333-444444444444",
  "parentSession": "{{SID}}", "delegationDepth": 1 }   ← 子会话头

# fork：模型想「基于当前上下文另开一路探索」
# → fork-in-process：fork 边界必须连续 seq、不在 open turn（06 页约束）
# → 子会话 = 父历史 seed + 自己的新事件；父历史是 seed 不是复制
# spawn：全新上下文（如「去查这个库的文档」）→ 全新会话更干净
# 判断标准（24 页同款）：结果要不要留在当前日志里

§1挂载条目

• subagent → @deepseek-ai/dsh-subagent——运行时核心（Definition + 注册）
• subagent-spawn-in-process → dsh-subagent-spawn-in-process（94 行）——同进程新会话 spawn
• subagent-fork-in-process → dsh-subagent-fork-in-process（124 行）——fork 当前会话
• tool-subagent-control / tool-subagent / tool-subagent-fork / tool-subagent-report / tool-subagent-list-agents——模型可见的委派工具家族
• 可选挂载（不在 base bundle）：subagent-codex（1348 行）、subagent-claude-code（936 行）——把轮次委派给其他产品的 provider

§2包文件地图

§3机制：三种委派模式

1. spawn（新会话）：子 agent 有全新 session——header 带 parentSession（06 页 SessionHeader 的 lineage 字段）。子会话的日志独立，但血缘可追溯。
2. fork（同会话）：fork 当前会话到一个边界——06 页的 fork 约束在此生效（边界必须是连续 seq、不得落在 open turn 内）。子 agent 从 fork 点继续，父历史是 seed。
3. delegation（跨产品）：codex/claude-code provider 把轮次委派给另一个产品的进程——06 页提过的「subagent 提供方在同一个接口之后千差万别」的落点。结果作为消息回到父会话。

无论哪种模式，子 agent 跑的是同一套 05-14 页的循环——subagent 不复制循环，只管理「谁创建谁、血缘如何、结果如何回收」。

§4关键代码

171export class SubagentRuntime extends Service {

22export const inject = ['subagents']

§5易错点