事件与生命周期参考图

1. 为什么要区分 durable event 与 live event

Session event 是可回放事实；agent/* 是运行时协调。前者必须能落盘并在未来重建，后者可以携带当前 Agent、AbortSignal 等进程内对象。

2. 一次工具轮次的事件表

3. Waterfall 的心智模型

listenerA(value, next) {
  value.tags.push('A')
  return next(value)          // 协作：继续下游
}
listenerB(value, next) {
  if (!allowed(value)) return { kind: 'reject' } // 短路
  return next(value)
}
listenerC(value, next) {
  return next(rewrite(value)) // 替换下游输入
}

如果监听器只是观察，却忘了调用 next()，它可能无意中成为权威短路者。因此 DSH 对 waterfall 的教学和组合测试很重视。

4. 取消信号

一整个 turn 应共享同一个显式 AbortSignal，并穿过 pre-step、prompt assembly、model request、stream、tool execute、turn-stopping；下一 turn 使用新 signal。取消是协作式的：不响应 signal 的插件必须自己 settle 后，teardown 才能真正静止。

5. 事件设计判断题

• 需要恢复后仍知道？→ Session event。
• 只是当前进程中的“谁在运行”？→ agent/* live event。
• 多个插件可改写/短路？→ waterfall。
• 所有观察者都要完成但无顺序？→ parallel。
• 终止检查需要顺序？→ serial。
• 只做通知且不应影响结果？→ emit。