断线、重试与身份变化
分清观察连接和服务端执行。SSE 断开、浏览器关闭或 Widget 卸载只会失去画面连接；原 Run 可能仍在运行、等待工具或已经结束。先查询原 Run 快照，再从 resume_cursor 补读后续事件，按 sequence 去重。
| 场景 | 安全做法 |
|---|---|
| 新 Run 创建请求响应丢失 | 保存的原正文、参数与幂等键原样重试，或查询原业务关联；不要换键创建第二个付费 Run |
| 已取得 Run ID 后快照失败 | 重查同一个 Run ID，不再 POST 创建 |
| SSE 出现缺口或重连 | 用快照替换客户端投影，再从快照 cursor 补读，不让历史事件重新触发 handler |
| 追加输入响应未知 | 用原内容和原幂等键重试 /inputs，确认它是否已进入原 Run |
| 业务工具已执行但回执失联 | 查产品持久业务记录，重投已保存的同一 receipt；结果未知时保持待核对 |
| 页面身份切换或 Key 撤销 | 结束旧客户端/runner，重新验证身份与权限；旧 Subject 的页面不能继续发送 |
明确停止使用 cancel() 或运行取消 API，并以服务端状态为准。这不是产品业务任务取消成功的证明。detach() 只是停止新的工具领取；业务是否取消、补偿或完成，必须由产品自己的接口与回执说明。
旧 Session 固定版本；恢复它时不自动使用 Agent 最新发布版本。遇到 401/403 先处理登录、scope 或撤销，不能把它当网络错误无限重试。未知供应商费用及未知工具副作用不能靠重复请求“补一次”。错误和限制、运行诊断。