mirror of
https://gitcode.com/JianFeeeee/homeagent-sdk.git
synced 2026-10-31 14:27:30 +00:00
feat(commondev): 支持取消正在运行的任务(commondev_agent_interrupt)
## 缺陷(用户实测反馈) 「commondev 无法取消正在运行的 session,agent 反馈它无法取消错误的 pi session,只能等它跑完。」 日志佐证:agent 在 09:07 收到 interrupt 请求后只能如实回答无法取消。 ## 根因不是"没实现取消",而是取消能力从来没被暴露 pi 的 AgentSession **本身就有** abort()(agent-session.d.ts:598, "Abort current operation and wait for agent to become idle")。 但 commondev 注册的 30 个工具里一个 cancel/stop 都没有, sidecar 也只有 ping/prompt/state/close 四个 method。 这是异步投递(2026-10-17)带来的新缺口:改动之前 prompt 是同步的, 调用方阻塞到任务结束,没有"中途要停"这个需求;改成异步投递后, 任务在后台长跑,用户却失去了停止它的手段。 ## 改动 **sidecar 三个平台各有各的取消方式:** pi → session.abort()(协作式中断,必须 await:不 await 会立刻 回"已中断"而实际还在跑 = 谎报成功) zcode → 整组杀掉当前回合的子进程(没有 abort API) spawn 时 detached=true 建了独立进程组,killTree 整组杀 **interrupt 语义如实回报:** interrupted=true 确实有任务在跑并被终止 interrupted=false 当时没有在跑的任务(不算错误) ok=false + error 该 CLI 没实现 / 调用失败 **三个收尾分支都清 currentChild**(timeout / error / close): 不清的话 interrupt 会拿到已死的子进程去杀,或更糟 —— 误杀下一轮。 ## 判据(4 条 + 「不谎报」) · pi 的两个 sidecar 都有 interrupt 且用 await session.abort() · zcode 的 interrupt 真的 killTree 且用 currentChild · 三个 sidecar 无重复声明(我写的时候真撞了:zcode 已有 currentChild) · **不谎报成功**:sidecar 没跑 / CLI 没实现时必须 interrupted=false ## 变异验证 pi 删 interrupt case → 咬 pi 去掉 await → 咬("会谎报已中断") zcode 不 killTree → 咬("只回 ok 不真杀") ## 顺带 既有判据 TestEveryRegisteredToolHasHandler 立刻抓到我加了 RegisterTool 但没在 handlerFor 映射里登记 —— 它比我先发现漏了接线。
This commit is contained in:
@ -172,6 +172,35 @@ async function handle(method, params) {
|
||||
messages: Array.isArray(s.messages) ? s.messages.length : 0,
|
||||
};
|
||||
}
|
||||
// ★★ interrupt:取消正在运行的任务(2026-10-18 新增)。
|
||||
//
|
||||
// 为什么必须有:prompt 改成异步投递后,Go 侧只能"发出去",无法收回。
|
||||
// 实测后果 —— 用户发现派错了任务、或某个 session 卡住时,**没有任何办法
|
||||
// 停下它**,只能等 pi 自己跑完(agent 在日志里如实回答"无法取消")。
|
||||
//
|
||||
// pi 的 AgentSession 本身有 abort():Abort current operation and wait
|
||||
// for agent to become idle。这里直接用它,不自己造机制。
|
||||
//
|
||||
// 语义说明(必须如实回给调用方):
|
||||
// · abort() 是**协作式**的:它在下一个可中断点生效,不是 SIGKILL。
|
||||
// 工具调用中途可能还要一小段时间才真正停下。
|
||||
// · 返回 interrupted=true 表示"已发出中断且会话已回到空闲";
|
||||
// 若当时没有在跑的任务,interrupted=false 但 ok=true(不算错误)。
|
||||
case "interrupt": {
|
||||
if (!session) return { ok: true, interrupted: false, reason: "no_session" };
|
||||
const hadInflight = inflight > 0;
|
||||
try {
|
||||
await session.abort();
|
||||
} catch (e) {
|
||||
return { ok: false, interrupted: false, error: String((e && e.message) || e) };
|
||||
}
|
||||
return {
|
||||
ok: true,
|
||||
interrupted: hadInflight,
|
||||
// 如实报告剩余在途数:>0 说明还有任务在收尾(调用方可据此决定是否再等)
|
||||
inflight,
|
||||
};
|
||||
}
|
||||
case "close": {
|
||||
try {
|
||||
session?.dispose?.();
|
||||
|
||||
Reference in New Issue
Block a user