[Feature] 提供优雅关闭/重启入口：当前 SIGTERM 会直接取消在途 agent 工作

[AmigaMeow]

背景

DSH 是常驻进程（dsh web），同一进程内可能同时挂着多个会话。要让配置/插件改动生效（改 settings.yaml、装插件等），目前只能重启进程；而重启会打断同进程内所有会话在途的 turn。

用户侧表现：

• 被打断的会话显示灰色「已停止」（turn/end {interrupted}）
• 若打断的是工具调用，还会出现红字 ToolOutcomeUnknownError / TOOL_OUTCOME_UNKNOWN

墓碑本身没问题 —— interruptedTurnClosers() 的善后是对的。问题是在途工作没有任何被救回的机会。

隔离复现

用独立 DSH_HOME 的 headless 实例（不碰任何现有实例、不开端口）：

DSH_HOME=/tmp/dsh-repro-home dsh --profile headless \
  "必须用 bash 工具执行：sleep 40; echo done > marker.txt"

等 tool/call 落盘后（约 6s）发 SIGTERM：

观测项	实测
SIGTERM → 进程退出	0.16 秒
在途的 40s bash	被掐断，marker.txt 未生成
残留子进程	无（已被清理）
会话日志 tool/call	1
会话日志 tool/result	0
TOOL_OUTCOME_UNKNOWN / turn/end interrupted	0（要等下次 resume 才补写）

源码定位

apps/cli/src/process-shutdown.ts

• PROCESS_SHUTDOWN_TIMEOUT_MS = 5_000 —— dispose 的上限
• interrupt(code) → start(code, /* forceAfterDispose */ true) —— dispose 完成后立即 process.exit
• SIGTERM / SIGINT 接到 interrupt；shutdown() 只被 cmdline 使用

packages/core/agent-loop/src/index.ts —— dispose 时：

machine.cancel({ kind: "disposed" })   // → phase.abort.abort()
await machine.whenIdle()               // 等它「静止」，不是等它「完成」

所以 0.16 秒退出不是因为宽限被绕过，而是因为 dispose 主动取消在途工作，随后立即退出。 5 秒是 dispose 的天花板，这个场景根本用不到它。

我认为这是设计选择，不是 bug

apps/cli/tests/process-shutdown.spec.ts 里有明确断言：第一个信号触发 dispose（drain），第二个信号才强制退出。这套语义是被测试固定下来的。

所以这里提的不是"写错了"，而是缺一个能力。

期望（都希望是 opt-in，不改现有默认行为）

1. 可选的「排空后退出」路径 —— 关闭时等在途 turn 走到安全点（工具完成或可中断点），而不是立刻 cancel；
2. 或可配的关闭宽限 —— 让长工具（分钟级 bash）有机会跑完，���不是被 cancel 一起带走；
3. 或 CLI 提供 dsh restart 之类的显式优雅重启入口 —— 用户想让新配置生效时，不必 resort to kill -TERM。

补充

• 与 provider 无关：中断和用哪个渠道没关系，"别的渠道没出现过"是采样错觉 —— 只有正在跑 turn 的会话才会留下墓碑。
• 现有的 interruptedTurnClosers() 善后机制很好，本 proposal 只是希望在它之前多一层机会。

[PerryLink]

在 master（c291e7961）逐条核实了你帖子的源码定位，全部成立：

• PROCESS_SHUTDOWN_TIMEOUT_MS = 5_000（apps/cli/src/process-shutdown.ts:4）；interrupt 在已有 pending 时（第二次信号）立即 forceExitOnce（:69-75）——"第一信号排空、第二信号强退"是被测试固定的语义（apps/cli/tests/process-shutdown.spec.ts:129）。
• SIGTERM→interrupt(0)、SIGINT→interrupt(130)（apps/cli/src/profile-boot.ts:309-310）✓
• dispose = machine.cancel({kind:'disposed'}) + await machine.whenIdle() + scope dispose（packages/core/agent-loop/src/index.ts:592-594）——等"静止"而非等"完成"，与你的观测一致。
• 全库无 dsh restart 命令；launcher 只有 profile/web/plugin/dump-config（apps/cli/src/args.ts:145-201）。

现状盘点：无排空路径、5s 宽限硬编码、无 restart。你的三个期望方向（opt-in drain 钩子 / 可配宽限 / restart 命令）都要维护者定语义，但原语现成：cancel+whenIdle 已是 drain 可挂的位置（index.ts:592-594），把"在途 turn 完成"做成 dispose 前可选等待是可行的。（未验证：长 bash 子进程被 cancel 后的清理责任在 tool 层，我没有逐一核实。）

[puremixai]

哥们，你是监控着每个discussions吗

[PerryLink]

毕竟最近在家待业，没啥事儿干。就多研究研究，参与参与社区。