lark-remote 0.1.7 → 0.1.9

package/CHANGELOG.md

@@ -5,6 +5,50 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.9] - 2026-08-20
+
+### 新增
+
+- ExitPlanMode 计划审批：计划全文折叠展示 + 五决策对齐 TUI（自动放行 / 附意见 / 采纳修改）
+- 卡片别名管理重构：`alias-store` 并入 `alias-resolve`，`/order` 卡片新增「＋别名」交互（绑定/修改/删除，已绑定指令显示 `$name` 标签 + ✕）
+- DSH / connection-based runner 启动 / 配置热更 / 失败路径修复（CC-01~CC-08）
+
+### 变更
+
+- 别名 API 由「触发词 → 文本」改为「指令 → 别名」：`/order alias add <orderId|序号> <别名>` 绑定、`/order alias rm` 移除；别名随指令持久化在 `orders.json`，删除指令时别名一并删除；名称不能为保留子命令、不能数字开头
+- 用户文档同步别名卡片化交互，移除 `/order alias <name> <text>` 旧用法
+
+### 修复
+
+- 别名卡片成功回调：携带 `card` 替换 pre-click 卡，删除文案对齐新交互
+- kimi ACP runner 模型下发：迁移到纯 ACP 后 `session/set_config_option` 必须紧跟 `session/new|resume` 下发，否则实际跑的是默认模型（CC-07）
+
+## [0.1.8] - 2026-08-19
+
+### 新增
+
+- DSH（DeepSeek Harness）Agent 接入：纯 HTTP 连接 DSH Web Host（无本地子进程），支持会话创建/续跑、`selectModel` 模型对齐、SSE mux 事件订阅、会话历史读取
+- `/config` DSH 配置卡：Host 地址 / 会话 preset / 模型 / 推理强度，模型与预设目录预取动态加载（失败回退固定兜底清单）
+- AskUserQuestion 公共契约（`question-common`）：标准提问审批事件工厂 + 按序答案映射，claude / codex / kimi / pi 统一接入
+- Codex AskUserQuestion：支持自由文本题、补充说明（user_note）、`autoResolutionMs` 透传为单请求审批超时
+- Kimi elicitation 表单回编 + request_permission 兜底桥
+- 工具权限审批卡（`kind === 'tool'`）：ExitPlanMode 等非命令工具展示工具名 + 用途说明，计划审批语义
+- 提问卡单选/多选图标区分（⚪/🔵 vs ⬜/☑️）、自由文本题输入框、自定义答案回显
+
+### 变更
+
+- claude session usage 扫描对齐 codex 语义：非累计字段为末轮（本 run）scope，累计走 `cumulative*` 字段
+- Compact 按钮能力门控放开到所有 `runCompact` 能力 runner（claude / codex / kimi / opencode / pi）
+- claude `/config` 权限模式下拉排除 `manual`（`default` 的别名，避免等价重复项）
+- workspace 保存即触达：`save` 内部调用 `touch`，新保存的工作区排在列表最前
+- DSH 可用性探测跳过二进制检查（HTTP-only Agent）
+
+### 修复
+
+- claude session usage 扫描：修复第三方网关（如 DeepSeek）将零 usage 写在占位行、真实 usage 只在末行导致的 per-run 统计全 0（改为按 message id 逐字段 max 聚合）
+- 审批答案重复投递（重复 nonce 二次点击）改为中性提示，不再误报"提交失败"
+- usage 统计一致性护栏：本 run 超出累计时显式标记 `⚠️ 累计异常`（只标记不修正，便于排查数据源问题）
+
 ## [0.1.7] - 2026-08-18
 
 ### 新增
@@ -175,3 +219,5 @@ Initial release.
 [0.1.4]: https://github.com/bungabungawoda/lark-remote/releases/tag/v0.1.4
 [0.1.5]: https://github.com/bungabungawoda/lark-remote/releases/tag/v0.1.5
 [0.1.6]: https://github.com/bungabungawoda/lark-remote/releases/tag/v0.1.6
+[0.1.7]: https://github.com/bungabungawoda/lark-remote/releases/tag/v0.1.7
+[0.1.8]: https://github.com/bungabungawoda/lark-remote/releases/tag/v0.1.8

package/dist/bridge/approval-coordinator.d.ts

@@ -13,13 +13,17 @@ import type { ApprovalAction } from '../runner/types.js';
 type ApprovalState = 'pending' | 'submitting' | 'resolved' | 'failed' | 'expired';
 export interface TrackedApproval {
     requestId: number | string;
-    kind: 'command' | 'file' | 'permissions' | 'question';
+    kind: 'command' | 'file' | 'permissions' | 'question' | 'tool';
     state: ApprovalState;
     view: ApprovalView;
     createdAt: number;
     timeoutTimer: ReturnType<typeof setTimeout> | null;
     /** AskUserQuestion 已答问题索引 → 答案 label[]（kind === 'question'）。 */
     answers?: Map<number, string[]>;
+    /** AskUserQuestion 补充说明（Codex user_note）：问题索引 → 文本。 */
+    notes?: Map<number, string>;
+    /** 计划审批修改意见（ExitPlanMode）：planFeedback 回流，供反馈类决策注入。 */
+    feedback?: string;
 }
 type ApprovalResponder = (requestId: number | string, response: unknown) => Promise<void>;
 export type { ApprovalAction } from '../runner/types.js';
@@ -101,6 +105,29 @@ export declare class ApprovalCoordinator {
         requestId: number | string;
         nonce?: string;
     }): Promise<void>;
+    /**
+     * AskUserQuestion 补充说明（Codex user_note）：选项之外的可选文本，随答案
+     * 提交；不单独构成答案（仍需选项/自定义答案才能完成该问题）。note 更新
+     * 后回流视图（卡片回显），同一请求可多次修改（新 nonce 来自新渲染）。
+     */
+    answerNote(action: {
+        questionIndex: number;
+        text: string;
+    }, ctx: {
+        requestId: number | string;
+        nonce?: string;
+    }): Promise<void>;
+    /**
+     * 计划审批修改意见（ExitPlanMode）：输入框提交 → coordinator 记录并回流
+     * 卡片回显，随后「拒绝并附意见」/「批准并采纳修改」按钮复用该文本。
+     * 同一请求可多次修改（新 nonce 来自新渲染）。
+     */
+    planFeedback(action: {
+        text: string;
+    }, ctx: {
+        requestId: number | string;
+        nonce?: string;
+    }): Promise<void>;
     /**
      * Update a pending approval's view (out-of-order item/started arrives late).
      * Only applies while the approval is still pending — resolved/expired
@@ -118,6 +145,8 @@ export declare class ApprovalCoordinator {
     private recordAnswer;
     private getPendingQuestion;
     private allQuestionsAnswered;
+    /** 推送审批卡视图更新（approval_view_updated 重渲染；失败仅记日志）。 */
+    private pushApprovalViewUpdate;
     /** 推送 question 卡片视图更新（选项勾选状态变化）。 */
     private pushQuestionViewUpdate;
     /** 全部问题已答：构建 answers 并提交（非空校验 + 原子状态迁移）。 */

package/dist/bridge/approval-coordinator.js

@@ -37,9 +37,12 @@ export class ApprovalCoordinator {
             existing.view = event.view;
             return;
         }
+        // 事件级 timeoutMs 优先（Codex autoResolutionMs / Pi extension timeout），
+        // 缺省回落 run 级默认超时。放在事件上而非桥按 agentKind 分支，公共层
+        // 保持无 agent 分支。
         const timer = setTimeout(() => {
             this.expireApproval(event.requestId);
-        }, this.approvalTimeoutMs);
+        }, event.timeoutMs ?? this.approvalTimeoutMs);
         const tracked = {
             requestId: event.requestId,
             kind: event.kind,
@@ -94,12 +97,33 @@ export class ApprovalCoordinator {
         if (!tracked.view.availableDecisions.includes(decision) && !safetyOverride) {
             throw new Error(`Decision "${decision}" not in available decisions: ${tracked.view.availableDecisions.join(', ')}`);
         }
+        // 反馈类决策：注入用户已填写的修改意见（卡片输入框经 planFeedback 回流到
+        // coordinator）。decisionToApprovalAction 只带决策名，payload 在此补齐；
+        // 调用方直接传完整 payload 时以显式值为准。
+        let effectiveAction = action;
+        if (action.action === 'decline_with_feedback' || action.action === 'accept_with_feedback') {
+            const explicit = action.action === 'decline_with_feedback' ? action.message : action.plan;
+            const text = explicit.trim() || tracked.feedback?.trim() || '';
+            if (!text) {
+                throw new Error('请先填写修改意见');
+            }
+            effectiveAction =
+                action.action === 'decline_with_feedback'
+                    ? { action: 'decline_with_feedback', message: text }
+                    : {
+                        action: 'accept_with_feedback',
+                        // 批准并采纳修改：新计划 = 原计划 + 用户意见（无原计划时意见即计划）。
+                        plan: tracked.view.plan?.trim()
+                            ? `${tracked.view.plan.trim()}\n\n## 用户修改意见\n${text}`
+                            : `# 用户修改意见\n\n${text}`,
+                    };
+        }
         // Atomic state transition: pending → submitting（同步，无 await）
         tracked.state = 'submitting';
         this.clearTimer(tracked);
         // Send response via the responder
         try {
-            await this.responder(ctx.requestId, action);
+            await this.responder(ctx.requestId, effectiveAction);
             tracked.state = 'resolved';
             // 提交成功后立即从卡片移除审批区（agent 无关）：claude 控制协议没有
             // resolved 回发，不推就会「已点允许按钮仍在」残留 UI；codex 的 server
@@ -224,6 +248,50 @@ export class ApprovalCoordinator {
         }
         this.pushQuestionViewUpdate(ctx.requestId, tracked);
     }
+    /**
+     * AskUserQuestion 补充说明（Codex user_note）：选项之外的可选文本，随答案
+     * 提交；不单独构成答案（仍需选项/自定义答案才能完成该问题）。note 更新
+     * 后回流视图（卡片回显），同一请求可多次修改（新 nonce 来自新渲染）。
+     */
+    async answerNote(action, ctx) {
+        const tracked = this.getPendingQuestion(ctx.requestId);
+        const questions = tracked.view.questions;
+        const q = questions[action.questionIndex];
+        if (!q) {
+            throw new Error(`Question ${action.questionIndex} not found in request ${ctx.requestId}`);
+        }
+        const text = action.text.trim();
+        if (!text) {
+            throw new Error('请输入补充说明');
+        }
+        this.assertFreshNonce(ctx.requestId, ctx.nonce);
+        tracked.notes ??= new Map();
+        tracked.notes.set(action.questionIndex, text);
+        q.note = text;
+        this.pushQuestionViewUpdate(ctx.requestId, tracked);
+    }
+    /**
+     * 计划审批修改意见（ExitPlanMode）：输入框提交 → coordinator 记录并回流
+     * 卡片回显，随后「拒绝并附意见」/「批准并采纳修改」按钮复用该文本。
+     * 同一请求可多次修改（新 nonce 来自新渲染）。
+     */
+    async planFeedback(action, ctx) {
+        const tracked = this.approvals.get(ctx.requestId);
+        if (!tracked) {
+            throw new Error(`Approval request ${ctx.requestId} not found`);
+        }
+        if (tracked.state !== 'pending') {
+            throw new Error(`Approval request ${ctx.requestId} is no longer pending`);
+        }
+        const text = action.text.trim();
+        if (!text) {
+            throw new Error('请输入修改意见');
+        }
+        this.assertFreshNonce(ctx.requestId, ctx.nonce);
+        tracked.feedback = text;
+        tracked.view.planFeedback = text;
+        this.pushApprovalViewUpdate(ctx.requestId, tracked);
+    }
     /**
      * Update a pending approval's view (out-of-order item/started arrives late).
      * Only applies while the approval is still pending — resolved/expired
@@ -295,8 +363,8 @@ export class ApprovalCoordinator {
         }
         return true;
     }
-    /** 推送 question 卡片视图更新（选项勾选状态变化）。 */
-    pushQuestionViewUpdate(requestId, tracked) {
+    /** 推送审批卡视图更新（approval_view_updated 重渲染；失败仅记日志）。 */
+    pushApprovalViewUpdate(requestId, tracked) {
         void this.pushToCard([
             {
                 type: 'approval_view_updated',
@@ -308,6 +376,10 @@ export class ApprovalCoordinator {
             getLogger().warn(`[approval-coordinator] question view update failed requestId=${requestId}: ${err instanceof Error ? err.message : String(err)}`);
         });
     }
+    /** 推送 question 卡片视图更新（选项勾选状态变化）。 */
+    pushQuestionViewUpdate(requestId, tracked) {
+        this.pushApprovalViewUpdate(requestId, tracked);
+    }
     /** 全部问题已答：构建 answers 并提交（非空校验 + 原子状态迁移）。 */
     async respondQuestionAnswers(tracked, ctx) {
         this.assertFreshNonce(ctx.requestId, ctx.nonce);
@@ -316,14 +388,22 @@ export class ApprovalCoordinator {
         }
         const questions = tracked.view.questions ?? [];
         const answers = {};
+        const notes = {};
         for (let i = 0; i < questions.length; i++) {
             const selected = tracked.answers?.get(i) ?? [];
             answers[questions[i].question] = questions[i].multiSelect ? selected : selected[0];
+            const note = tracked.notes?.get(i);
+            if (note)
+                notes[questions[i].question] = note;
         }
         tracked.state = 'submitting';
         this.clearTimer(tracked);
         try {
-            await this.responder(ctx.requestId, { action: 'answer', answers });
+            await this.responder(ctx.requestId, {
+                action: 'answer',
+                answers,
+                ...(Object.keys(notes).length > 0 ? { notes } : {}),
+            });
             tracked.state = 'resolved';
             this.pushResolved(ctx.requestId);
         }
@@ -380,6 +460,10 @@ export class ApprovalCoordinator {
                 return 'acceptAll';
             case 'answer':
                 return 'answer';
+            case 'decline_with_feedback':
+                return 'declineWithFeedback';
+            case 'accept_with_feedback':
+                return 'acceptWithFeedback';
             case 'decline':
                 return 'decline';
             case 'cancel':
@@ -398,6 +482,10 @@ export function decisionToApprovalAction(decision) {
             return { action: 'accept_with_execpolicy_amendment' };
         case 'acceptAll':
             return { action: 'accept_all' };
+        case 'declineWithFeedback':
+            return { action: 'decline_with_feedback', message: '' };
+        case 'acceptWithFeedback':
+            return { action: 'accept_with_feedback', plan: '' };
         case 'decline':
             return { action: 'decline' };
         case 'cancel':

package/dist/bridge/index.d.ts

@@ -121,6 +121,13 @@ export declare class Bridge {
      * blocked the queue forever.
      */
     private runners;
+    /**
+     * Runner 槽位在「活跃运行期间配置变更」时被标 stale（CC-06/P1）：clearRunners() 对
+     * 活跃 workspace 只标 stale、不立即 evict（避免误杀长驻连接），当前 run 结束后由
+     * finalizeRun 安全 evict+dispose，下一轮 getRunner 创建新配置的 runner。
+     * key 为 `${cwd}\u0000${agentKind}`。
+     */
+    private staleRunnerSlots;
     /** Queue manager for per-workspace serial processing queue. */
     /** 普通消息队列管理器（public：测试注入 queue-card 状态用）。 */
     queueManager: QueueManager;
@@ -129,8 +136,8 @@ export declare class Bridge {
     /** Approval coordinators keyed by runId. */
     private approvalCoordinators;
     /**
-     * 最近一次已完成的 codex app-server run（按 cwd）。run 结束后 activeRuns
-     * 已清空，Compact 需要它来校验 runId 并提供 sessionId。
+     * 最近一次已完成的、runner 有 runCompact 的 run（按 cwd）。run 结束后
+     * activeRuns 已清空，Compact 需要它来校验 runId 并提供 sessionId。
      */
     private lastCompactableCodexRun;
     /**
@@ -383,6 +390,16 @@ export declare class Bridge {
         decision: string;
         nonce: string;
     }): Promise<void>;
+    /**
+     * 计划审批修改意见（ExitPlanMode 输入框）：记录到 coordinator 并回流卡片。
+     * 「拒绝并附意见」/「批准并采纳修改」按钮复用该文本。
+     */
+    handleApprovalPlanFeedback(opts: {
+        runId: string;
+        requestId: number | string;
+        text: string;
+        nonce: string;
+    }): Promise<void>;
     /**
      * Handle a permission toggle from a card button click.
      * Routes to the ApprovalCoordinator for the given run.
@@ -426,15 +443,28 @@ export declare class Bridge {
         nonce: string;
     }): Promise<void>;
     /**
-     * Handle codex.compact card action — trigger a Codex compaction request.
-     * Validates the run exists and is in a terminal state, then calls
-     * the app-server runner's runCompact().
+     * Codex AskUserQuestion 补充说明（user_note，2026-08-18 live 验证模型理解
+     * "user_note: <text>" 条目）：记录到 coordinator，随答案一起提交。
+     * 路由到 ApprovalCoordinator.answerNote。
+     */
+    handleApprovalAnswerNote(opts: {
+        runId: string;
+        requestId: number | string;
+        questionIndex: number;
+        text: string;
+        nonce: string;
+    }): Promise<void>;
+    /**
+     * Handle codex.compact card action — trigger a compaction request for any
+     * runCompact-capable runner（codex/kimi/opencode/pi/claude，按
+     * lastCompactableCodexRun 记录的 agentKind 路由）。Validates the run exists
+     * and is in a terminal state, then calls the runner's runCompact().
      */
     handleCodexCompact(value: {
         runId?: string;
     }, ctx: BridgeContext): Promise<void>;
     /**
-     * Stream a Codex compaction to a card: start a RunCardSession with
+     * Stream a compaction to a card: start a RunCardSession with
      * operationKind='compaction' (no recursive Compact button), consume
      * runner.runCompact() events, read authoritative jsonl usage, and finish
      * the card. Shared by handleCodexCompact (run card button) and

package/dist/bridge/index.js

@@ -89,6 +89,13 @@ export class Bridge {
      * blocked the queue forever.
      */
     runners = new Map();
+    /**
+     * Runner 槽位在「活跃运行期间配置变更」时被标 stale（CC-06/P1）：clearRunners() 对
+     * 活跃 workspace 只标 stale、不立即 evict（避免误杀长驻连接），当前 run 结束后由
+     * finalizeRun 安全 evict+dispose，下一轮 getRunner 创建新配置的 runner。
+     * key 为 `${cwd}\u0000${agentKind}`。
+     */
+    staleRunnerSlots = new Set();
     /** Queue manager for per-workspace serial processing queue. */
     /** 普通消息队列管理器（public：测试注入 queue-card 状态用）。 */
     queueManager;
@@ -97,8 +104,8 @@ export class Bridge {
     /** Approval coordinators keyed by runId. */
     approvalCoordinators = new Map();
     /**
-     * 最近一次已完成的 codex app-server run（按 cwd）。run 结束后 activeRuns
-     * 已清空，Compact 需要它来校验 runId 并提供 sessionId。
+     * 最近一次已完成的、runner 有 runCompact 的 run（按 cwd）。run 结束后
+     * activeRuns 已清空，Compact 需要它来校验 runId 并提供 sessionId。
      */
     lastCompactableCodexRun = new Map();
     /**
@@ -259,10 +266,18 @@ export class Bridge {
         // keeping it is correct; finalizeRun deletes the cache entry when the run
         // ends, and the next run picks up the new config/agent via getRunner.
         for (const cwd of [...this.runners.keys()]) {
-            if (this.activeRuns.has(cwd))
+            if (this.activeRuns.has(cwd)) {
+                // CC-06/P1: 活跃 workspace 不能立即 evict（会误杀长驻连接），但必须标记 stale，
+                // 否则 finalizeRun 对 workspace-lifetime runner 也不 evict → 下一轮复用旧配置实例。
+                // 这里只标待淘汰，当前 run 结束后由 finalizeRun 安全 evict。
+                for (const kind of [...this.runners.get(cwd).keys()]) {
+                    this.staleRunnerSlots.add(`${cwd}\u0000${kind}`);
+                }
                 continue;
+            }
             for (const kind of [...this.runners.get(cwd).keys()]) {
                 this.evictRunnerSlot(cwd, kind);
+                this.staleRunnerSlots.delete(`${cwd}\u0000${kind}`);
             }
         }
     }
@@ -287,6 +302,7 @@ export class Bridge {
             void evicted.dispose();
         }
         workspaceMap.delete(kind);
+        this.staleRunnerSlots.delete(`${cwd}\u0000${kind}`);
         if (workspaceMap.size === 0) {
             this.runners.delete(cwd);
         }
@@ -753,6 +769,9 @@ export class Bridge {
                 showToolResult: this.config.output.showToolResult,
                 // Run card header shows the current agent name (e.g. "Claude · 思考中")
                 agentKind,
+                // Compact 按钮能力门控与 resume 卡 / auto-resume 卡一致（hasRunCompact
+                // 鸭子探测）：claude（stream-json，无 turn_started）也能拿到按钮。
+                compactSupported: this.hasRunCompact(cwd, agentKind),
             },
         });
         const activeRun = {
@@ -1111,7 +1130,10 @@ export class Bridge {
                 // 由 formatUsageStats 的 max/兜底公式处理。
             }
             else {
-                // codex（jsonl 优先）或无 live usage → jsonl 兜底所有 flow 字段
+                // codex（jsonl 优先）或无 live usage → jsonl 兜底所有 flow 字段。
+                // jsonl 的非累计字段已是末轮（本 run）scope（claude reader 修复后对齐
+                // codex `last_token_usage` 语义，见 scalarScan），不再是 session 累计；
+                // session 累计只经 cumulative* 字段透传，卡片"本 run ≤ 累计"不变量成立。
                 finalInputTokens = finalUsage?.inputTokens ?? liveInputTokens;
                 finalOutputTokens = finalUsage?.outputTokens ?? liveOutputTokens;
                 finalCacheReadTokens = finalUsage?.cacheReadTokens ?? finalCacheReadTokens;
@@ -1296,9 +1318,13 @@ export class Bridge {
                 // evicted+disposed by clearRunners (/config) and interruptCurrentRun
                 // (/stop). Spawn-per-message runners are evicted as before to prevent
                 // stale process references accumulating.
-                if (activeRun.runner.lifetime !== 'workspace') {
+                // CC-06/P1: 配置变更期间（clearRunners 标了 stale）的 workspace-lifetime
+                // runner 也必须在 run 结束后 evict，否则下一轮复用旧配置实例。
+                const slotKey = `${cwd}\u0000${activeRun.agentKind}`;
+                if (activeRun.runner.lifetime !== 'workspace' || this.staleRunnerSlots.has(slotKey)) {
                     this.evictRunnerSlot(cwd, activeRun.agentKind);
                 }
+                this.staleRunnerSlots.delete(slotKey);
                 // Compact 卡片需要 runId + sessionId；record 供终态卡上的 Compact 按钮
                 // 校验与取参（activeRuns 已清空，无法再查到）。异常退出（error/
                 // interrupted/idle_timeout）同样记录——上下文往往更大，压缩后再续。
@@ -1441,6 +1467,15 @@ export class Bridge {
             await coordinator.submit(action, { requestId: opts.requestId, nonce: opts.nonce });
         });
     }
+    /**
+     * 计划审批修改意见（ExitPlanMode 输入框）：记录到 coordinator 并回流卡片。
+     * 「拒绝并附意见」/「批准并采纳修改」按钮复用该文本。
+     */
+    async handleApprovalPlanFeedback(opts) {
+        return this.withCoordinator(opts.runId, async (coordinator) => {
+            await coordinator.planFeedback({ text: opts.text }, { requestId: opts.requestId, nonce: opts.nonce });
+        });
+    }
     /**
      * Handle a permission toggle from a card button click.
      * Routes to the ApprovalCoordinator for the given run.
@@ -1485,9 +1520,20 @@ export class Bridge {
         return this.withCoordinator(opts.runId, (coordinator) => coordinator.answerCustom({ questionIndex: opts.questionIndex, text: opts.text }, { requestId: opts.requestId, nonce: opts.nonce }));
     }
     /**
-     * Handle codex.compact card action — trigger a Codex compaction request.
-     * Validates the run exists and is in a terminal state, then calls
-     * the app-server runner's runCompact().
+     * Codex AskUserQuestion 补充说明（user_note，2026-08-18 live 验证模型理解
+     * "user_note: <text>" 条目）：记录到 coordinator，随答案一起提交。
+     * 路由到 ApprovalCoordinator.answerNote。
+     */
+    async handleApprovalAnswerNote(opts) {
+        const log = getLogger();
+        log.info(`[bridge] handleApprovalAnswerNote runId=${opts.runId.slice(0, 8)}... requestId=${opts.requestId} question=${opts.questionIndex}`);
+        return this.withCoordinator(opts.runId, (coordinator) => coordinator.answerNote({ questionIndex: opts.questionIndex, text: opts.text }, { requestId: opts.requestId, nonce: opts.nonce }));
+    }
+    /**
+     * Handle codex.compact card action — trigger a compaction request for any
+     * runCompact-capable runner（codex/kimi/opencode/pi/claude，按
+     * lastCompactableCodexRun 记录的 agentKind 路由）。Validates the run exists
+     * and is in a terminal state, then calls the runner's runCompact().
      */
     async handleCodexCompact(value, ctx) {
         const log = getLogger();
@@ -1529,7 +1575,7 @@ export class Bridge {
         });
     }
     /**
-     * Stream a Codex compaction to a card: start a RunCardSession with
+     * Stream a compaction to a card: start a RunCardSession with
      * operationKind='compaction' (no recursive Compact button), consume
      * runner.runCompact() events, read authoritative jsonl usage, and finish
      * the card. Shared by handleCodexCompact (run card button) and
@@ -1659,7 +1705,7 @@ export class Bridge {
             await this.sendResult({ text: `⚠️ 未找到 session ${sessionId}（当前目录: ${cwd}）` }, ctx);
             return;
         }
-        // Check that the runner has runCompact (codex app-server only).
+        // Check that the runner has runCompact（codex/kimi/opencode/pi/claude 鸭子探测）。
         const runner = this.getRunner(cwd, agentKind);
         if (!('runCompact' in runner) ||
             typeof runner.runCompact !== 'function') {