[bug] Subagent sessions that did not terminate normally are shown as green (ready/archived state indistinguishable from completed)

[qyz7438]

Status: 用户报告的子代理会话状态显示问题

现象

用户在 DSH Web GUI 中发现，部分子代理会话"没有正常结束"但仍然显示为绿色，与"正常完成"的会话视觉上无法区分。

• 当前有约 39 个子代理会话处于 ready 状态（定义为：仅存在于存储中、可 send_message 续接、非终态、不是等待收集的结果），1 个 running。
• 子代理目录（subagent header catalog）中，这些 ready / 未正常结束（中断、取消、失败、仅存档）的会话，其状态圆点被渲染为绿色（done），与真正完成的会话相同。
• 用户无法分辨"真正完成"与"未正常结束 / 仅存档"，要求作为 bug 提交。

环境

• 仓库：deepseek-ai/deepseek-harness（商品 id R_kgDOT3T1gw）
• HEAD：47f943859b（Merge pull request #2519 from deepseek-harness/feat/npm-public）
• 分类：General

状态模型现状

数据层 activity 字段只区分 running / inactive，不含终态结局。

packages/subagent/subagent/src/list-children.ts（第 49–55 行，SubagentListEntry 的 JSDoc）：

"Store snapshot activity: running means the logical record is live in ctx.sessions; inactive means it exists only in persistence. Neither encodes a durable outcome, and a continuable child may still reject delivery as an ownership conflict."

即 list_agents / catalog 只告诉 GUI "该记录当前是否在内存中活跃"，并不说明该会话是否完成、失败还是被中断/取消。

模型面 list_agents 工具的状态枚举（running / idle / ready）：

packages/subagent/tool-subagent-control/src/list-agents.ts（第 52–63 行）：

• running = 有活跃 driver；
• idle = 常驻 Agent 两次 turn 之间；
• ready = 仅存在于存储中，"resumable, not terminal, and not a result waiting to be collected"（可续接、非终态）。

注意 ready 不是终态，但它（连同任何未正常结束的会话）在 GUI 中都会落到 inactive 分支。

Web 客户端把 host 侧驱动状态折叠成二元 inactive：

packages/client/runtime/src/client/sessions/manager.ts（第 928–946 行，updateCatalogActivity；第 930 行 const activity = running ? 'running' : 'inactive'）—— 任何 disengage（含中断/取消/存档）都变成 inactive，没有 failed / aborted / interrupted 通道传给 UI。

状态 → 颜色映射（组件 + 行号）

核心渲染：packages/client/ui-subagent/src/client/SubagentCatalogAction.tsx 第 348 行：

<StateDot state={entry.activity === 'running' ? 'ongoing' : 'done'} />

• running → ongoing（蓝色追逐动画）
• 一切非 running（inactive）→ done（绿色） —— 包括正常完成、中断、失败、取消、仅存档（ready）。

同文件内其它同样映射：

• 第 202 行（加载占位行）：<StateDot state={summary.running ? 'ongoing' : 'done'} />
• 第 586 行（触发按钮点）：{descendants.runningCount > 0 && <StateDot state="ongoing" />}（无 running 子代理时完全不显示绿/蓝点）

颜色令牌：packages/client/ui-primitives/src/StateDot.module.css

• 第 33–35 行 [data-state='done'] → var(--dsw-alias-state-success-primary)（绿）
• 第 49–52 行 [data-state='ongoing']（matrix 动画）→ var(--dsh-state-ongoing)（DeepSeek 蓝）
• 第 41–43 行 [data-state='error'] → 红；目录渲染中从未使用（catalog 只传 ongoing / done 两个值）

StateDot.tsx 第 10 行语义：绿色看齐 done，error（红）对应失败。红/失败态在整个 subagent 目录里是"不可达"的。

父行侧栏：packages/client/ui-workspace/src/client/rows/Rows.tsx 第 253–259 行 —— 非 running 的会话显示绿色 done（status.running 外，completed 与 idle 均为 done/绿），与上述问题一致地放大了"非活跃即绿"的暗示。

根因分析（按可能性排序）

1. 数据层 activity 枚举缺失终态 completed/failed/aborted，ready/未正常结束与"完成"在同一 inactive 桶。

   • list-children.ts:49–55 明确"Neither encodes a durable outcome"；
   • README.md@ui-subagent/README.md:33 已登记为已知限制："The catalog has no durable outcome — activity and timing do not distinguish completion, failure, or cancellation, and the UI exposes no Activation identity…"。
   • 这是最深层的成因：即便 UI 想区分，也没有可用的结局字段。

2. GUI 把所有非 running 条目映射为绿色 done（SubagentCatalogAction.tsx:348）。

   • 映射只有 running ? 'ongoing' : 'done' 两个分支，把「未正常结束 / 仅存档」与「正常完成」渲染成同一种绿色，error（红）态在目录中永远走不到。

3. 中断（interrupt）后的会话状态没有传导到 UI。

   • 客户端 manager.ts:930 把任何 disengage 折叠为 inactive，没有 failed/aborted/interrupted 枚举值到达 catalog；
   • StateDot 已具备 error / warning 语义，但目录渲染从不使用，说明中断/失败信息的管线在其到达前端之前就丢失了。

（三者本质上是同一问题的三个层次：状态空间定义、UI 取色分支、中断事件传播。）

期望行为

终态 / 非终态 / 失败应可区分显示，让用户能分辨"真正完成"与"未正常结束 / 仅存档"：

• completed（正常完成）→ 绿色 done（现状）
• running → 蓝色 ongoing（现状）
• ready（仅存档、可续接、非终态）→ 灰色/存档色，例如复用 warning 之外的 --dsw-* 中性 token，或用不同图标，避免被误读为"完成"
• failed（失败/报错）→ 红色 error（StateDot 已有语义但目录未用）
• aborted / interrupted（被用户或父代中断）→ 中性的明显区分色 / 标签（如 amber warning 或独立图标）
• 目录行正文也应体现结局（如英文状态词与颜色对应），而不只是圆点颜色

建议

1. 在数据层补一个可序列化的终态结局（例如在 subagentTiming / 新的 projection 或 SubagentListEntry 上增加 outcome/terminal 字段），来源建议 subagent/descriptor 与 turn/end（stopReason: completed/aborted/max-tokens/error/disposed，参见 agent-loop / subagent-dsh-sdk 的终态映射惯例）。
2. 前端取色改为枚举分支：SubagentCatalogAction.tsx:348 由二分 running/inactive 扩展为 running → ongoing、completed → done、ready → neutral/archive、failed → error、aborted → warning/neutral；同时把 error 状态真正路由到 StateDot。
3. 中断事件传播：在客户端 manager.ts 保留 failed/aborted/interrupted 的到达通道，避免 disengage 即塌缩为 inactive。
4. 更新 ui-subagent/README.md:33 的已知限制条目（一旦实现），并补充组件级快照/单测覆盖各结局颜色的渲染。

未确认项

• 本 issue 基于源码静态分析与用户现象对照；未运行 pnpm run test:gui / 实机 GUI 复现（只读调研，不做改动）。
• 具体希望采纳的 ready 视觉方案（灰/存档色 vs 独立徽标）等待维护者/设计定夺。
• interrupt 后 host 是否已在 turn/end 写入 stopReason: 'aborted'、以及该信息目前未到达 list-children 的细节，须结合 host 侧持久化/广播实现进一步核对（未在此只读调查中逐文件验证）。