lark-remote 0.1.7 → 0.1.9

package/dist/card/approval-render.js

@@ -4,10 +4,14 @@
  * Renders command/file/permissions approval areas with button mappings per §8.3.
  * Uses CardKit 2.0 (no tag:"action" container — 200861 rule).
  */
+import { collapsibleMarkdownPanel } from './collapsible.js';
+import { truncateUtf8, truncateMarkdownTables } from './text-truncate.js';
 /** Unique nonce for card button callbacks (SDK dedup + router validation). */
 function mkNonce() {
     return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
 }
+/** 计划面板正文字节预算（折叠展示 + 截断保护 28KB 卡片预算）。 */
+const PLAN_PANEL_BYTES = 6000;
 /** reason div（3 处共用）；反引号中和防 lark_md 解析错误（review P2-2）。 */
 function reasonDiv(approval) {
     if (!approval.reason)
@@ -42,6 +46,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));
     }
@@ -68,20 +75,26 @@ function renderDecisionButtons(approval, expired, runId) {
             },
         ];
     }
+    // ExitPlanMode 计划审批用 TUI 语义文案；其他审批保持原文案。
+    const isPlanExit = approval.kind === 'tool' && approval.toolName === 'ExitPlanMode';
     const BUTTONS = {
-        accept: { label: '✅ 允许', type: 'primary' },
+        accept: { label: isPlanExit ? '✅ 批准并执行' : '✅ 允许', type: 'primary' },
         acceptForSession: { label: '✅ 允许本次会话', type: 'primary' },
         acceptWithExecpolicyAmendment: { label: '🔒 允许并记住命令', type: 'primary' },
-        acceptAll: { label: '✅ 允许所有', type: 'primary' },
+        acceptAll: { label: isPlanExit ? '✅ 批准并自动放行' : '✅ 允许所有', type: 'primary' },
+        acceptWithFeedback: { label: '✍️ 批准并采纳修改', type: 'primary' },
+        declineWithFeedback: { label: '✏️ 拒绝并附意见', type: 'default' },
         decline: { label: '❌ 拒绝', type: 'danger' },
     };
     // Fixed presentation order; only offer decisions the protocol listed
-    // (accept/decline are always available; acceptAll is Claude 专属「允许所有」)。
+    // (accept/decline are always available; 其余按 availableDecisions 出现)。
     const offered = [
         'accept',
         'acceptForSession',
         'acceptWithExecpolicyAmendment',
         'acceptAll',
+        'acceptWithFeedback',
+        'declineWithFeedback',
         'decline',
     ].filter((d) => d === 'accept' || d === 'decline' || approval.availableDecisions.includes(d));
     // 决策按钮逐个作为 body 直接元素返回（CardKit body 纵向堆叠 = 上下排列）。
@@ -106,6 +119,129 @@ function renderDecisionButtons(approval, expired, runId) {
     }));
 }
 // =============================================================================
+// Tool Approval (non-command tools, e.g. ExitPlanMode)
+// =============================================================================
+/**
+ * 通用工具权限请求（kind === 'tool'）：展示工具名 + 用途说明（reason）+ 原始
+ * input（若有）。ExitPlanMode 走独立计划审批分支（计划全文 + 修改意见输入）。
+ */
+function renderToolApproval(approval, expired, runId) {
+    // ExitPlanMode：对齐 TUI「先看完整计划再交互」——计划全文折叠面板 +
+    // 修改意见输入 + 五决策按钮（批准并执行 / 批准并自动放行 / 拒绝并附意见 /
+    // 批准并采纳修改 / 拒绝）。
+    if (approval.toolName === 'ExitPlanMode') {
+        return renderPlanApproval(approval, expired, runId);
+    }
+    const elements = [];
+    elements.push({
+        tag: 'div',
+        text: {
+            tag: 'lark_md',
+            content: '**🔧 工具请求**',
+        },
+    });
+    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;
+}
+/**
+ * ExitPlanMode 计划审批区：
+ * - 计划全文（input.plan 或计划文件读取）折叠展示，反引号中和 + 表格限数 +
+ *   字节预算截断；
+ * - 计划文件路径（有则展示，含模型写错目录的退化场景）；
+ * - 修改意见输入框（approval.planFeedback → coordinator 回流回显），供
+ *   「拒绝并附意见」/「批准并采纳修改」复用；
+ * - 决策按钮由 renderDecisionButtons 按 availableDecisions 渲染。
+ */
+function renderPlanApproval(approval, expired, runId) {
+    const elements = [];
+    elements.push({
+        tag: 'div',
+        text: { tag: 'lark_md', content: '**📋 计划审批**' },
+    });
+    pushIf(elements, reasonDiv(approval));
+    if (approval.planFilePath) {
+        const neutralizedPath = approval.planFilePath.replace(/`/g, '·');
+        elements.push({
+            tag: 'div',
+            text: { tag: 'lark_md', content: `📄 ${neutralizedPath}` },
+        });
+    }
+    if (approval.plan) {
+        // 反引号中和防 11311（同 reasonDiv/command 策略）；表格限数防 11310；
+        // 字节预算截断防 28KB 超限。
+        const neutralized = approval.plan.replace(/`/g, '·');
+        const tableSafe = truncateMarkdownTables(neutralized);
+        const content = truncateUtf8(tableSafe, PLAN_PANEL_BYTES);
+        elements.push(collapsibleMarkdownPanel({
+            title: '📋 计划',
+            expanded: false,
+            border: 'blue',
+            content,
+        }));
+    }
+    else {
+        elements.push({
+            tag: 'div',
+            text: {
+                tag: 'lark_md',
+                content: '📋 未获取到计划文件内容（可参考上方正文摘要）',
+            },
+        });
+    }
+    if (!expired) {
+        elements.push(renderPlanFeedbackInput(approval.requestId, runId));
+        if (approval.planFeedback) {
+            const neutralized = approval.planFeedback.replace(/`/g, '·');
+            elements.push({
+                tag: 'div',
+                text: { tag: 'lark_md', content: `📝 ${neutralized}` },
+            });
+        }
+    }
+    elements.push(...renderDecisionButtons(approval, expired, runId));
+    return elements;
+}
+/**
+ * 计划修改意见输入行：输入后点击右侧 ✓ 提交图标，input_value 经 connector
+ * raw 事件回传（CardKit input 的 input_value 会被 SDK normalizer 丢弃，
+ * 必须走 includeRawEvent 路径，同 answerNote）。
+ */
+function renderPlanFeedbackInput(requestId, runId) {
+    return {
+        tag: 'input',
+        name: `plan-feedback-${requestId}`,
+        placeholder: {
+            tag: 'plain_text',
+            content: '填写修改意见（可配合「拒绝并附意见」/「批准并采纳修改」）…',
+        },
+        behaviors: [
+            {
+                type: 'callback',
+                value: {
+                    cmd: 'approval.planFeedback',
+                    requestId,
+                    runId,
+                    nonce: mkNonce(),
+                },
+            },
+        ],
+    };
+}
+// =============================================================================
 // Command Approval
 // =============================================================================
 function renderCommandApproval(approval, expired, runId) {
@@ -259,6 +395,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 +415,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 +423,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 +455,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 +492,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';

package/dist/card/run-renderer.js

@@ -25,13 +25,21 @@ function measureJson(obj) {
 /** markdownDiv('', 'notation') 的序列化字节（空内容 div 的常量开销，估算时复用）。 */
 const EMPTY_MD_DIV_BYTES = measureJson(markdownDiv('', 'notation'));
 /**
- * Compact 按钮可见性：普通 run（operationKind='turn'）到达任意终态即可压缩。
+ * Compact 按钮可见性：到达任意终态即可压缩。
  * 异常退出（error/interrupted/idle_timeout）时上下文往往更大，更需要压缩后
  * 再继续，因此不再要求 resultSubtype==='success'。compaction 卡
  * （operationKind='compaction'）永不显示，防止递归 Compact。
+ *
+ * 能力门控（compactSupported !== false）与执行侧 `'runCompact' in runner`
+ * 鸭子探测对齐：claude 走 stream-json，不发射 turn_started，operationKind
+ * 恒 undefined——若以 operationKind==='turn' 作门控，claude 终态卡永远拿
+ * 不到按钮（2026-08-19 缺陷）。compaction 卡的「防递归」仍由 operationKind
+ * 保证，两者是不同质的判断。
  */
-function shouldShowCompactButton(state) {
-    if (state.operationKind !== 'turn')
+function shouldShowCompactButton(state, options) {
+    if (state.operationKind === 'compaction')
+        return false;
+    if (options.compactSupported === false)
         return false;
     return (state.terminal === 'done' ||
         state.terminal === 'error' ||
@@ -201,15 +209,15 @@ const EXTREME_TIER = {
     textBytes: DEGRADED_TEXT_BYTES,
 };
 /** Bottom action row: stop (if running) + compact (if applicable) + new session (always). */
-function actionRow(state) {
+function actionRow(state, options) {
     const actionButtons = [];
     // finalizing 也显示停止按钮（进程未退出，用户可 /stop）
     const showStop = state.terminal === 'running' || state.terminal === 'finalizing';
     if (showStop) {
         actionButtons.push(stopButton(state.runId));
     }
-    // Compact 按钮：普通 turn 到达任意终态即可压缩（含异常退出），compaction 卡除外
-    if (shouldShowCompactButton(state)) {
+    // Compact 按钮：到达任意终态即可压缩（含异常退出），compaction 卡除外
+    if (shouldShowCompactButton(state, options)) {
         actionButtons.push(compactButton(state.runId));
     }
     actionButtons.push(newSessionButton());
@@ -323,7 +331,7 @@ function buildFallbackElements(state, options, tier) {
         elements.push(markdownDiv('_暂无输出_'));
     }
     elements.push(...buildSummaryContent(state));
-    elements.push(...actionRow(state));
+    elements.push(...actionRow(state, options));
     elements.push(...approvalArea(state));
     return elements;
 }
@@ -374,7 +382,7 @@ function statusRow(state) {
  * stop while running/finalizing). No block content is rendered, so the size is
  * bounded by static structure regardless of input — closing the safety-net gap.
  */
-function buildSkeletonElements(state) {
+function buildSkeletonElements(state, options) {
     const elements = [];
     elements.push(statusRow(state));
     elements.push(markdownDiv('_⚠️ 输出过大且含大量转义字符，已省略全部内容以避免超限；完整内容请查日志_'));
@@ -382,7 +390,7 @@ function buildSkeletonElements(state) {
     elements.push(...buildSummaryContent(state));
     // Bottom action row: stop (if running/finalizing) + compact (if applicable) + new session (always).
     // Degraded paths must keep the action buttons reachable (design constraint).
-    elements.push(...actionRow(state));
+    elements.push(...actionRow(state, options));
     return elements;
 }
 /**
@@ -450,6 +458,9 @@ export function estimateCardBytes(state, options = {}, shared) {
     if (state.terminal === 'running' || state.terminal === 'finalizing') {
         actionButtons.push(stopButton(state.runId));
     }
+    if (shouldShowCompactButton(state, options)) {
+        actionButtons.push(compactButton(state.runId));
+    }
     actionButtons.push(newSessionButton());
     total += measureJson([
         { tag: 'div', text: { content: '‎', tag: 'lark_md' } },
@@ -551,7 +562,7 @@ export function renderRunCard(state, options = {}) {
             statusRow(state),
             ...buildChronologicalContent(state, options, prepared, groups),
             ...buildSummaryContent(state),
-            ...actionRow(state),
+            ...actionRow(state, options),
             ...approvalArea(state),
         ];
         const card = assembleRunCard(state, options, elements);
@@ -573,7 +584,7 @@ export function renderRunCard(state, options = {}) {
     if (Buffer.byteLength(JSON.stringify(extremeCard), 'utf8') <= CARD_BUDGET_BYTES) {
         return extremeCard;
     }
-    const skeletonCard = assembleRunCard(state, options, buildSkeletonElements(state));
+    const skeletonCard = assembleRunCard(state, options, buildSkeletonElements(state, options));
     // skeleton 卡是静态结构，理论上必 ≤28KB；保留兜底断言以防未来结构膨胀
     if (Buffer.byteLength(JSON.stringify(skeletonCard), 'utf8') <= CARD_BUDGET_BYTES) {
         return skeletonCard;

package/dist/config/index.d.ts

@@ -6,6 +6,8 @@ export declare const CLAUDE_EFFORTS: readonly ["low", "medium", "high", "xhigh",
  * Claude 官方 --permission-mode 枚举（claude --help 输出，2026-08 实测）。
  * 额外支持 'default'：Claude settings.json 的官方未设置值，等价于不传
  * --permission-mode（交互式默认：高风险工具逐个询问）。
+ * 'manual' 是 'default' 的别名（claude CLI 等价），schema 保留以向后兼容旧配置，
+ * 但 UI 下拉不展示（见 router/config/claude.ts）。
  */
 export declare const CLAUDE_PERMISSION_MODES: readonly ["default", "acceptEdits", "auto", "bypassPermissions", "manual", "dontAsk", "plan"];
 /** Valid thinking levels for Pi */
@@ -17,7 +19,7 @@ export declare const PI_THINKING_LEVELS: readonly ["off", "minimal", "low", "med
  */
 export declare const DEFAULT_STOP_GRACE_MS: 5000;
 /** Codex app-server turn idle timeout default (minutes). */
-export declare const DEFAULT_TURN_IDLE_TIMEOUT_MINUTES: 10;
+export declare const DEFAULT_TURN_IDLE_TIMEOUT_MINUTES: 30;
 /** 入站媒体默认配置（schema 默认与 connector 兜底共用，避免双源漂移）。 */
 export declare const DEFAULT_INBOUND_MEDIA_DIR_NAME = ".lark-remote-temp";
 export declare const DEFAULT_INBOUND_MEDIA_MAX_SIZE_MB = 50;
@@ -112,6 +114,15 @@ declare const KimiConfigSchema: z.ZodObject<{
         turnIdleTimeoutMinutes: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+/** DSH (DeepSeek Harness) Web Host default base URL. */
+export declare const DEFAULT_DSH_HOST = "http://127.0.0.1:3080";
+/** DSH (DeepSeek Harness) Web Host connection config. */
+declare const DshConfigSchema: z.ZodObject<{
+    host: z.ZodDefault<z.ZodString>;
+    agentPreset: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    reasoningEffort: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export declare const AppConfigSchema: z.ZodObject<{
     feishu: z.ZodObject<{
         appId: z.ZodString;
@@ -201,6 +212,12 @@ export declare const AppConfigSchema: z.ZodObject<{
                 turnIdleTimeoutMinutes: z.ZodDefault<z.ZodNumber>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
+        dsh: z.ZodOptional<z.ZodObject<{
+            host: z.ZodDefault<z.ZodString>;
+            agentPreset: z.ZodOptional<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            reasoningEffort: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     agentChoices: z.ZodOptional<z.ZodObject<{
         codex: z.ZodOptional<z.ZodObject<{
@@ -220,6 +237,9 @@ export declare const AppConfigSchema: z.ZodObject<{
             model: z.ZodOptional<z.ZodString>;
             thinkingEffort: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
+        dsh: z.ZodOptional<z.ZodObject<{
+            host: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     idle: z.ZodDefault<z.ZodObject<{
         watchdogMinutes: z.ZodDefault<z.ZodNumber>;
@@ -248,6 +268,7 @@ export declare const AppConfigSchema: z.ZodObject<{
         opencode: "opencode";
         pi: "pi";
         kimi: "kimi";
+        dsh: "dsh";
     }>>;
     checkUpdateOnStartup: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
@@ -299,12 +320,14 @@ type CodexConfig = z.infer<typeof CodexConfigSchema>;
 type OpencodeConfig = z.infer<typeof OpencodeConfigSchema>;
 type PiConfig = z.infer<typeof PiConfigSchema>;
 type KimiConfig = z.infer<typeof KimiConfigSchema>;
+export type DshConfig = z.infer<typeof DshConfigSchema>;
 /** Get configuration for a specific agent. Falls back to defaults if not configured. */
 export declare function getAgentConfig(config: AppConfig, kind: 'claude'): ClaudeConfig;
 export declare function getAgentConfig(config: AppConfig, kind: 'codex'): CodexConfig | undefined;
 export declare function getAgentConfig(config: AppConfig, kind: 'opencode'): OpencodeConfig | undefined;
 export declare function getAgentConfig(config: AppConfig, kind: 'pi'): PiConfig | undefined;
 export declare function getAgentConfig(config: AppConfig, kind: 'kimi'): KimiConfig | undefined;
+export declare function getAgentConfig(config: AppConfig, kind: 'dsh'): DshConfig | undefined;
 /**
  * 从 Claude settings.json 的 env 中读取所有以 MODEL 结尾的环境变量值，
  * 返回去重后的模型 ID 列表。