[Grok/dsh 41] 子代理消息与续接

[Blackman99]

Parent

#132

Ticket: 41

Status: ready-for-agent

User Stories: 43, 59（见父规格）

What to build

用户向选定子代理发送消息或继续已完成子会话，返回正确目标与送达状态，不新建竞争写入者。

Acceptance criteria

• 活跃/完成/取消子代理的消息、恢复规则按参考区分，目标身份和模型约束可靠。
• 迟到消息、未知目标、权限变化、父会话切换与重复续接明确拒绝或正确排队。
• 新尝试与旧结果不会混淆，消息确实进入目标 dsh 会话，单写者规则仍成立。
• 从父视图与子视图验证完整往返和关闭恢复，补齐自动化契约与用户说明。

Blocked by

• [Grok/dsh 40] dsh 子代理执行与任务视图 #172 — Ticket 40: dsh 子代理执行与任务视图

Delivery contract

用户于2026-09-20批准当前测试与任务拆分。按父规格的已安装产物/真实终端和公开协议测试验收；实际实现须带适用的文档、Changeset及必要检查。ready-for-agent表示任务已定义，不表示前置任务已完成，也不授权自动开始本轮实施、购买付费资源或发布软件版本。

[Blackman99]

已完成，提交 e02467f824484783bf2eeaf615d506f0f9da64fb（已推送到 rewrite/grok-dsh-20260920，rebase 到 #191、#206、#207 之上，冲突已解决并保留双方新增内容）。

实现内容（dsh 仍是执行核心，默认关闭）：

• 开关：[features] active_agent_messages / GROK_ACTIVE_AGENT_MESSAGES（默认关）。开启后父代理和工具创建的子代理都有 send_subagent_message，支持 steer / queue / interject（interject 会提前结束阻塞中的 job_output 等待），也兼容旧的 queue。结果文本、32 KB 上限和额度（每个子代理 8 条、总计 64 条；子代理对每个接收者 4 条在途、每次运行 32 条）都与参考实现一致。开启后 dsh 自带的 send_message / interrupt_agent 会被拒绝。
• 未被取消的已完成子代理会以同一身份在 dsh 任务中唤醒，行上显示 · attempt N，结束时有完成通知。
• resume_from：只接受本会话中已完成、同类型的子代理，固定其模型（覆盖会被忽略）；空值或 "null" 视为未传。错误文本来自参考实现。
• 对话记录显示 Message sent to/queued for/interjected to …、Message rejected · …、continues "…"。只读子代理视图把消息显示为 ◎ Message from parent 回合。
• 文档：帮助文本、README.md / README.zh.md、CONTEXT.md、CONTRIBUTING.md、changeset。

检查结果（真实计数）：

• pnpm run typecheck 通过。
• pnpm test：99 个文件（95 通过、3 失败、1 跳过），2529 通过 / 4 失败 / 8 跳过。失败项：reference-evidence 的 2 个 5s 超时和 rust-launcher 负载超时，均为已有问题；rust-goal 的“用户中断回合时暂停目标”在负载下失败一次，单独重跑 3 次 19/19 通过。
• 新增 scripts/rust-subagent-messages.spec.mjs 12/12，连续 3 次通过；subagents、workflow、scheduler、launcher 共 84/84，subagents、remote-identity、inventory 186 通过 / 7 跳过。
• cargo fmt --check 通过。
• cargo clippy -D warnings：只有已知的 2 个问题（未使用的 tail_marker、filesystem_sandbox.rs 中多余的 return）。
• cargo test --workspace：1678 通过 / 4 失败 / 2 忽略。4 个失败均为已知问题（filesystem_sandbox ×2、voice::substitute_route…、privacy::drafts_stay_local…）。
• PTY：新增 rust-subagent-message-pty-test.py 通过（已加入 test:rust:pty）；subagent、background、scheduler、workflow、monitor 的 PTY 回归也全部通过。
• 安全自查：发送者身份取自调用方代理而非参数；按会话和血缘校验归属；不写磁盘、不做冷恢复；控制目录 0700 未改动；有大小和额度限制；不涉及密钥。

未验证：macOS/Windows、真实模型提供方（只用了无密钥的 mock）；参考二进制未运行，证据来自固定源码版本 e8563f8。

与参考实现的差异（已写入文档）：

• 行不支持 Right/Left 展开；
• 未实现 x.ai/subagent/* ACP 扩展和 ui.cancel_subagents_on_turn_cancel；
• 最多常驻 32 个已结束的子代理；
• 重启后不保留任何状态；
• 工作树隔离的子代理不能唤醒或续跑；
• 工作流、调度和校验子代理不能接收消息。

main、npm 发布和默认启动方式均未改动，PR #213 未触碰。

后续：唯一依赖本任务的 #211 仍被其他未关闭任务阻塞（#168、#186、#188、#194、#201、#203、#204、#206、#207、#208、#209），本次没有解除任何任务的阻塞。