@coda-console/grok-bot 0.1.4 → 0.1.6

package/README.md

@@ -42,7 +42,7 @@
 副作用调用由适配器向 coda MCP 的 status 取 turn 票据并生成 requestId，授权与通知复用 Coda 会话机制。`spawn` 必须指定目标 `project`，缺失直接拒绝（Bot 的空目录没有代码）；开 Agent、给别的会话发消息由 Coda 的授权卡片批准。给自己开出的子会话补充是已批准任务的延续，不另问；`cancel` 只能停自己开出的子会话，由 Coda 校验归属，不另问。适配器不另发审批卡片，工具范围之外全部拒绝。
 
 `spawn`、`send`、`cancel` 的 requestId 由本轮 ID、工具名和规范化参数的 SHA-256 生成 UUID；对象键递归排序，数组顺序保留，参数顶层的 turn/requestId 不参与计算。同一轮内参数等价的重试复用同一 ID，由 Coda 恢复原调用；改参数或换轮次会得到新 ID。
-`spawn`、`send` 提交给 Coda 后，超过 20 秒仍未返回就先回复「已提交，正在等用户在 Coda 卡片上批准；结果会作为新消息送来；不要重试或轮询」。阈值为适配器的 `SUBMISSION_WAIT_MS` 常量。提前回执前以原 toolCallId 登记独立后台活动，原调用继续执行；实际返回或 MCP 断连时，活动报 handling，补交结果、终结原工具记录并报 done/failed。原轮次已结束时由 Coda 开自主轮次交回，失败会明确显示给用户，不自动重试。没有 waits 能力的客户端会继续等实际结果，不提前回执。收到回执后可 coda_done，等待批准的子会话不在 status.children 中不代表失败，不要改写同一任务重复派出。
+`spawn`、`send` 提交给 Coda 后，超过 20 秒仍未返回就先回复「已提交，正在等用户在 Coda 卡片上批准；结果会作为新消息送来；不要重试或轮询」。阈值为适配器的 `SUBMISSION_WAIT_MS` 常量。提交调用时就在原轮次内以 toolCallId 登记独立后台活动；20 秒只控制提前回执。回执前取消或超时也不把仍在运行的工具标为失败，原调用继续执行；实际返回或 MCP 断连时，活动报 handling，补交结果、终结原工具记录并报 done/failed。原轮次已结束时由 Coda 开自主轮次交回，失败会明确显示给用户，不自动重试。没有 waits 能力的客户端会继续等实际结果，不提前回执。收到回执后可 coda_done，等待批准的子会话不在 status.children 中不代表失败，不要改写同一任务重复派出。
 
 ## 远端协议与调试
 

package/agent/session.mjs

@@ -90,7 +90,8 @@ export class Adapter {
   finish(s, stopReason) {
     const turn = s.turn;
     if (!turn) return;
-    for (const [toolCallId] of turn.tools) this.update(s, { sessionUpdate: 'tool_call_update', toolCallId, status: 'failed', rawOutput: '本轮已结束，远端操作结果未确认' });
+    for (const [toolCallId, call] of turn.tools) if (!call.background)
+      this.update(s, { sessionUpdate: 'tool_call_update', toolCallId, status: 'failed', rawOutput: '本轮已结束，远端操作结果未确认' });
     this.clock.clearTimeout(turn.timer);
     s.turn = null;
     turn.controller.abort();
@@ -185,10 +186,14 @@ export class Adapter {
   }
   async trace(s, name, args, operation, replyAfter) {
     const turn = s.turn, toolCallId = randomUUID();
+    const background = replyAfter !== undefined && !!this.waits;
     const toolCall = { toolCallId, title: `Coda · ${name}`, kind: 'other', status: 'pending', rawInput: args };
-    if (turn) { turn.tools.set(toolCallId, true); this.update(s, { sessionUpdate: 'tool_call', ...toolCall }); }
+    if (turn) { turn.tools.set(toolCallId, { background }); this.update(s, { sessionUpdate: 'tool_call', ...toolCall }); }
     else this.log(JSON.stringify({ sessionId: s.id, toolCallId, name, arguments: args, state: 'started' }));
-    let background = false;
+    // Register while the initiating turn is still active, before dispatch. The
+    // request survives cancellation even before its early acknowledgement.
+    if (background) this.rpc.notify('_coda/wait', { sessionId: s.id, waitId: toolCallId, kind: 'task', state: 'waiting',
+      title: `Coda · ${name} 等待结果`, toolCallId });
     const activity = state => this.rpc.notify('_coda/wait', { sessionId: s.id, waitId: toolCallId, state });
     const report = (status, rawOutput) => {
       if (background) {
@@ -196,7 +201,7 @@ export class Adapter {
         // activity's original cause. Do not reopen the Bot's expired turn.
         activity('handling');
         this.update(s, { sessionUpdate: 'tool_call_update', toolCallId, status, rawOutput });
-        this.say(s, status === 'failed'
+        if (s.turn !== turn || !turn.tools.has(toolCallId)) this.say(s, status === 'failed'
           ? `Coda · ${name} 后台调用失败：${typeof rawOutput === 'string' ? rawOutput : JSON.stringify(rawOutput)}。请核实执行结果，不要自动重发。`
           : `Coda · ${name} 后台调用已返回，结果见该工具记录。`);
         activity(status === 'failed' ? 'failed' : 'done');
@@ -214,13 +219,10 @@ export class Adapter {
       } finally { turn?.tools.delete(toolCallId); }
     })();
     // Without activity support we cannot safely hand off a pending call.
-    if (replyAfter === undefined || !this.waits) return completed;
+    if (!background) return completed;
     let timer;
     const submitted = new Promise(resolve => {
       timer = this.clock.setTimeout(() => {
-        background = true;
-        this.rpc.notify('_coda/wait', { sessionId: s.id, waitId: toolCallId, kind: 'task', state: 'waiting',
-          title: `Coda · ${name} 等待结果`, toolCallId });
         turn.tools.delete(toolCallId);
         resolve({ content: [{ type: 'text', text: '已提交，正在等用户在 Coda 卡片上批准；结果会作为新消息送来；不要重试或轮询。没有其他工作就结束本轮。' }] });
       }, replyAfter);

package/package.json

@@ -3,7 +3,7 @@
   "id": "grok-bot",
   "displayName": "Grok Bot",
   "description": "把 Grok 云端 Bot 接到 Coda 的长期会话：Webhook 消息、定时巡检与用户审批。",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "type": "module",
   "engines": { "node": ">=24" },
   "categories": ["Agent"],