lark-remote 0.1.7 → 0.1.8

package/CHANGELOG.md

@@ -5,6 +5,32 @@ 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.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 +201,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,15 @@ 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>;
 }
 type ApprovalResponder = (requestId: number | string, response: unknown) => Promise<void>;
 export type { ApprovalAction } from '../runner/types.js';
@@ -101,6 +103,18 @@ 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>;
     /**
      * Update a pending approval's view (out-of-order item/started arrives late).
      * Only applies while the approval is still pending — resolved/expired

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,
@@ -224,6 +227,28 @@ 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);
+    }
     /**
      * Update a pending approval's view (out-of-order item/started arrives late).
      * Only applies while the approval is still pending — resolved/expired
@@ -316,14 +341,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);
         }

package/dist/bridge/index.d.ts

@@ -129,8 +129,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;
     /**
@@ -426,15 +426,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

@@ -97,8 +97,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();
     /**
@@ -753,6 +753,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 +1114,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;
@@ -1485,9 +1491,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 +1546,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 +1676,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') {

package/dist/card/approval-render.js

@@ -42,6 +42,9 @@ export function renderApprovalArea(approval, opts) {
     if (approval.kind === 'command') {
         elements.push(...renderCommandApproval(approval, opts?.expired, opts?.runId));
     }
+    else if (approval.kind === 'tool') {
+        elements.push(...renderToolApproval(approval, opts?.expired, opts?.runId));
+    }
     else if (approval.kind === 'file') {
         elements.push(...renderFileApproval(approval, opts?.expired, opts?.runId));
     }
@@ -106,6 +109,42 @@ function renderDecisionButtons(approval, expired, runId) {
     }));
 }
 // =============================================================================
+// Tool Approval (non-command tools, e.g. ExitPlanMode)
+// =============================================================================
+/**
+ * 通用工具权限请求（kind === 'tool'）：展示工具名 + 用途说明（reason）+ 原始
+ * input（若有）。ExitPlanMode 的 input 为空对象，工具名本身即审批内容，
+ * 不再落入 command 槽位显示无意义 `{}`。
+ */
+function renderToolApproval(approval, expired, runId) {
+    const elements = [];
+    // ExitPlanMode 是「退出计划模式」：标题用计划审批语义；其他工具用通用标题。
+    const isPlanExit = approval.toolName === 'ExitPlanMode';
+    elements.push({
+        tag: 'div',
+        text: {
+            tag: 'lark_md',
+            content: isPlanExit ? '**📋 计划审批**' : '**🔧 工具请求**',
+        },
+    });
+    const toolLabel = approval.toolName ?? '(unknown tool)';
+    elements.push({
+        tag: 'div',
+        text: { tag: 'lark_md', content: `🔧 \`${toolLabel}\`` },
+    });
+    pushIf(elements, reasonDiv(approval));
+    // 原始 input（非空时展示，截断保护卡片预算；ExitPlanMode 的 `{}` 不展示）。
+    if (approval.toolInput && approval.toolInput !== '{}') {
+        const neutralized = approval.toolInput.replace(/`/g, '·');
+        elements.push({
+            tag: 'div',
+            text: { tag: 'lark_md', content: `\`${neutralized.slice(0, 500)}\`` },
+        });
+    }
+    elements.push(...renderDecisionButtons(approval, expired, runId));
+    return elements;
+}
+// =============================================================================
 // Command Approval
 // =============================================================================
 function renderCommandApproval(approval, expired, runId) {
@@ -259,6 +298,14 @@ function renderQuestionApproval(approval, expired, runId) {
         tag: 'div',
         text: { tag: 'lark_md', content: '**❓ 需要你回答**' },
     });
+    // Kimi elicitation form：完整题干只在 form message 里合并出现，概要行展示
+    // 于提问卡顶部（数据驱动，Kimi runner 翻译时填充 approval.intro）。
+    if (approval.intro) {
+        elements.push({
+            tag: 'div',
+            text: { tag: 'lark_md', content: `📝 ${approval.intro}` },
+        });
+    }
     if (expired) {
         elements.push({
             tag: 'div',
@@ -271,6 +318,7 @@ function renderQuestionApproval(approval, expired, runId) {
         const q = questions[i];
         const selected = q.selected ?? [];
         const header = q.header || `问题 ${i + 1}`;
+        const freeText = (q.options?.length ?? 0) === 0;
         elements.push({
             tag: 'div',
             text: {
@@ -278,34 +326,26 @@ function renderQuestionApproval(approval, expired, runId) {
                 content: `**${header}**${q.multiSelect ? '（可多选）' : ''}\n${q.question}`,
             },
         });
-        for (const option of q.options) {
+        if (freeText) {
+            // 自由文本题（Codex options:null / Pi extension input）：无选项行，
+            // 直接渲染题面 + 输入框，提交走 answerCustom（coordinator 不要求有选项）。
+            elements.push(renderAnswerInput(approval.requestId, i, q.placeholder ?? '输入回答…', runId));
+            // 已答回显：input_value 不跨卡片更新保留，多题场景下用户提交后若还有
+            // 其他问题未答，卡片必须展示已答文本（与自定义答案选中态同模式）。
+            const answered = q.selected?.find((s) => s.length > 0);
+            if (answered) {
+                elements.push({
+                    tag: 'div',
+                    text: { tag: 'lark_md', content: `✍️ 已答：${answered}` },
+                });
+            }
+            continue;
+        }
+        for (const option of q.options ?? []) {
             const isSelected = selected.includes(option.label);
-            elements.push({
-                tag: 'div',
-                text: {
-                    tag: 'lark_md',
-                    content: `${isSelected ? '✅' : '⬜'} ${option.label}${option.description ? `\n_${option.description}_` : ''}`,
-                },
-            });
-            elements.push({
-                tag: 'button',
-                text: { tag: 'plain_text', content: isSelected ? '取消选择' : '选择' },
-                type: isSelected ? 'default' : 'primary',
-                size: 'small',
-                behaviors: [
-                    {
-                        type: 'callback',
-                        value: {
-                            cmd: 'approval.answer',
-                            requestId: approval.requestId,
-                            questionIndex: i,
-                            option: option.label,
-                            runId,
-                            nonce: mkNonce(),
-                        },
-                    },
-                ],
-            });
+            // 单选/多选图标区分：单选 ⚪/🔵（radio 隐喻），多选 ⬜/☑️（checkbox 隐喻）。
+            const icon = q.multiSelect ? (isSelected ? '☑️' : '⬜') : isSelected ? '🔵' : '⚪';
+            elements.push(renderOptionRow(approval.requestId, i, option, isSelected, icon, runId));
         }
         // 自定义答案（Other）的选中态展示：选项按钮无法表示自由文本，单独显示
         // 已选文本，避免「点了没反应」的困惑（review P3）。
@@ -318,24 +358,21 @@ function renderQuestionApproval(approval, expired, runId) {
         }
         // review P3-4：单选问题提供自定义答案（Other）输入——输入文本后点击
         // 输入框右侧 ✓ 提交图标，input_value 经 connector raw 事件回传。
-        if (!q.multiSelect) {
-            elements.push({
-                tag: 'input',
-                name: `answer-custom-${approval.requestId}-${i}`,
-                placeholder: { tag: 'plain_text', content: '自定义答案（Other）…' },
-                behaviors: [
-                    {
-                        type: 'callback',
-                        value: {
-                            cmd: 'approval.answerCustom',
-                            requestId: approval.requestId,
-                            questionIndex: i,
-                            runId,
-                            nonce: mkNonce(),
-                        },
-                    },
-                ],
-            });
+        // 显隐按 isOther !== false：Kimi form 会丢弃非声明选项值，翻译时置
+        // isOther=false 隐藏输入；Claude 未设置该字段默认显示（行为不变）。
+        if (!q.multiSelect && q.isOther !== false) {
+            elements.push(renderAnswerInput(approval.requestId, i, '自定义答案（Other）…', runId, 'approval.answerCustom'));
+        }
+        // Codex user_note：选项之外的补充说明（allowNote 数据驱动门控）。
+        // 提交走 answerNote（coordinator 记录 note，随答案一起提交），已填回显。
+        if (q.allowNote === true) {
+            elements.push(renderAnswerInput(approval.requestId, i, '补充说明（可选）…', runId, 'approval.answerNote'));
+            if (q.note) {
+                elements.push({
+                    tag: 'div',
+                    text: { tag: 'lark_md', content: `📝 ${q.note}` },
+                });
+            }
         }
         // 多选问题：有勾选才给提交按钮（单选在协调器内即时提交）。
         if (q.multiSelect && selected.length > 0) {
@@ -358,6 +395,111 @@ function renderQuestionApproval(approval, expired, runId) {
             });
         }
     }
+    // 提问卡底部统一「跳过回答」：走现有 approval.respond + decision=decline
+    // （coordinator 对 question 允许 decline 作为安全兜底），runner 按协议映射
+    // 跳过语义（Claude deny / Codex 空 answers / Kimi action decline / Pi cancelled）。
+    if (!expired) {
+        elements.push({
+            tag: 'button',
+            text: { tag: 'plain_text', content: '⏭️ 跳过回答' },
+            type: 'default',
+            behaviors: [
+                {
+                    type: 'callback',
+                    value: {
+                        cmd: 'approval.respond',
+                        decision: 'decline',
+                        requestId: approval.requestId,
+                        runId,
+                        nonce: mkNonce(),
+                    },
+                },
+            ],
+        });
+    }
     return elements;
 }
+/**
+ * 选项行：左按钮右描述（固定 100px 按钮列保证对齐），单选/多选图标区分。
+ * 与 renderAnswerInput 分开以便自由文本题不渲染选项行。
+ */
+function renderOptionRow(requestId, questionIndex, option, isSelected, icon, runId) {
+    return {
+        tag: 'column_set',
+        flex_mode: 'none',
+        columns: [
+            {
+                tag: 'column',
+                width: 'auto',
+                vertical_align: 'center',
+                elements: [
+                    {
+                        tag: 'button',
+                        text: { tag: 'plain_text', content: isSelected ? '取消选择' : '选择' },
+                        type: isSelected ? 'default' : 'primary',
+                        size: 'small',
+                        // 固定宽度让所有选项行的按钮左对齐（描述长短不影响按钮列）。
+                        width: '100px',
+                        behaviors: [
+                            {
+                                type: 'callback',
+                                value: {
+                                    cmd: 'approval.answer',
+                                    requestId,
+                                    questionIndex,
+                                    option: option.label,
+                                    runId,
+                                    nonce: mkNonce(),
+                                },
+                            },
+                        ],
+                    },
+                ],
+            },
+            {
+                tag: 'column',
+                width: 'weighted',
+                weight: 1,
+                vertical_align: 'center',
+                elements: [
+                    {
+                        tag: 'div',
+                        text: {
+                            tag: 'lark_md',
+                            content: `${icon} ${option.label}${option.description ? `\n_${option.description}_` : ''}`,
+                        },
+                    },
+                ],
+            },
+        ],
+    };
+}
+/**
+ * 文本输入行（Other 输入与自由文本题共用）：输入后点击右侧 ✓ 提交图标，
+ * input_value 经 connector raw 事件回传（CardKit input 的 input_value 会被
+ * SDK normalizer 丢弃，必须走 includeRawEvent 路径）。
+ */
+function renderAnswerInput(requestId, questionIndex, placeholder, runId, cmd = 'approval.answerCustom') {
+    // name 必须含 cmd，保证同一题同时渲染多个输入框（如单选选项题的
+    // Other 输入 + Note 输入）时元素 name 唯一——飞书对同卡内重复 name
+    // 报 ErrCode 11310 拒绝整卡（2026-08-19 线上：name(answer-custom-0-0) duplicate）。
+    const kind = cmd === 'approval.answerNote' ? 'note' : 'custom';
+    return {
+        tag: 'input',
+        name: `answer-${kind}-${requestId}-${questionIndex}`,
+        placeholder: { tag: 'plain_text', content: placeholder },
+        behaviors: [
+            {
+                type: 'callback',
+                value: {
+                    cmd,
+                    requestId,
+                    questionIndex,
+                    runId,
+                    nonce: mkNonce(),
+                },
+            },
+        ],
+    };
+}
 //# sourceMappingURL=approval-render.js.map

package/dist/card/card-shared.d.ts

@@ -23,15 +23,17 @@ export declare function stopButton(runId: string): object;
  */
 export declare function newSessionButton(): object;
 /**
- * Create a CardKit 2.0 Compact button for Codex app-server mode.
- * Triggers thread/compact/start via the codex.compact callback.
+ * Create a CardKit 2.0 Compact button for any runCompact-capable runner
+ * (codex/kimi/opencode/pi/claude，鸭子类型 `'runCompact' in runner` 探测）。
+ * Triggers the compact flow via the codex.compact callback（handler 按
+ * runId 解析 agentKind，claude 走 stream-json 内建 /compact）。
  */
 export declare function compactButton(runId: string): object;
 /**
  * Create a CardKit 2.0 Compact button for resume cards (auto-resume / `/resume <id>`).
  * Unlike compactButton (which targets a finished run's runId), this targets a
- * sessionId directly: the bridge resolves the session and calls the app-server
- * runner's runCompact() without a runId. Carries agent so the handler routes
+ * sessionId directly: the bridge resolves the session and calls the runner's
+ * runCompact() without a runId. Carries agent so the handler routes
  * to the correct session reader + runner when the card was rendered for a
  * non-default agent.
  */

package/dist/card/card-shared.js

@@ -78,8 +78,10 @@ export function newSessionButton() {
     };
 }
 /**
- * Create a CardKit 2.0 Compact button for Codex app-server mode.
- * Triggers thread/compact/start via the codex.compact callback.
+ * Create a CardKit 2.0 Compact button for any runCompact-capable runner
+ * (codex/kimi/opencode/pi/claude，鸭子类型 `'runCompact' in runner` 探测）。
+ * Triggers the compact flow via the codex.compact callback（handler 按
+ * runId 解析 agentKind，claude 走 stream-json 内建 /compact）。
  */
 export function compactButton(runId) {
     return {
@@ -92,8 +94,8 @@ export function compactButton(runId) {
 /**
  * Create a CardKit 2.0 Compact button for resume cards (auto-resume / `/resume <id>`).
  * Unlike compactButton (which targets a finished run's runId), this targets a
- * sessionId directly: the bridge resolves the session and calls the app-server
- * runner's runCompact() without a runId. Carries agent so the handler routes
+ * sessionId directly: the bridge resolves the session and calls the runner's
+ * runCompact() without a runId. Carries agent so the handler routes
  * to the correct session reader + runner when the card was rendered for a
  * non-default agent.
  */

package/dist/card/run-renderer.d.ts

@@ -8,6 +8,13 @@ export interface RunCardRenderOptions {
      * Defaults to 'claude' when not provided; the bridge passes `config.defaultAgent`.
      */
     agentKind?: string;
+    /**
+     * Whether the terminal-state Compact button may be rendered. Defaults to true.
+     * The bridge passes `runner 有 runCompact`（与 resume 卡 / auto-resume 卡的
+     * hasRunCompact 探测一致），保证「有能力才渲染」：claude（stream-json，
+     * 无 turn_started → operationKind undefined）同样能拿到按钮。
+     */
+    compactSupported?: boolean;
 }
 type BlockGroup = {
     kind: 'thinking';