lark-remote 0.1.5 → 0.1.6

package/dist/card/approval-render.d.ts

@@ -0,0 +1,16 @@
+/**
+ * renderApprovalArea: renders the approval request area in a run card.
+ *
+ * Renders command/file/permissions approval areas with button mappings per §8.3.
+ * Uses CardKit 2.0 (no tag:"action" container — 200861 rule).
+ */
+import type { ApprovalView } from '../runner/types.js';
+/**
+ * Render the approval area for a run card.
+ * Returns an array of CardKit 2.0 elements to append to the card body.
+ */
+export declare function renderApprovalArea(approval: ApprovalView | undefined, opts?: {
+    expired?: boolean;
+    runId?: string;
+    terminal?: string;
+}): object[];

package/dist/card/approval-render.js

@@ -0,0 +1,247 @@
+/**
+ * renderApprovalArea: renders the approval request area in a run card.
+ *
+ * Renders command/file/permissions approval areas with button mappings per §8.3.
+ * Uses CardKit 2.0 (no tag:"action" container — 200861 rule).
+ */
+/** Unique nonce for card button callbacks (SDK dedup + router validation). */
+function mkNonce() {
+    return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+}
+/**
+ * Render the approval area for a run card.
+ * Returns an array of CardKit 2.0 elements to append to the card body.
+ */
+export function renderApprovalArea(approval, opts) {
+    if (!approval)
+        return [];
+    // 终态（done/error/interrupted/idle_timeout）下 run 已结束：coordinator 已
+    // 释放，按钮点击无处响应，隐藏整个审批区避免"点了没反应"（P2-7）。
+    if (opts?.terminal && opts.terminal !== 'running' && opts.terminal !== 'finalizing') {
+        return [];
+    }
+    const elements = [];
+    if (approval.kind === 'command') {
+        elements.push(...renderCommandApproval(approval, opts?.expired, opts?.runId));
+    }
+    else if (approval.kind === 'file') {
+        elements.push(...renderFileApproval(approval, opts?.expired, opts?.runId));
+    }
+    else if (approval.kind === 'permissions') {
+        elements.push(...renderPermissionsApproval(approval, opts?.expired, opts?.runId));
+    }
+    return elements;
+}
+/**
+ * Render approval action buttons from the real protocol decision list.
+ * accept and decline are always offered (decline is a universal safety
+ * affordance even when the server omits it); acceptForSession and
+ * acceptWithExecpolicyAmendment appear only when the server offers them.
+ */
+function renderDecisionButtons(approval, expired, runId) {
+    if (expired) {
+        return [
+            {
+                tag: 'div',
+                text: { tag: 'lark_md', content: '⏰ **审批已过期**' },
+            },
+        ];
+    }
+    const BUTTONS = {
+        accept: { label: '✅ 允许', type: 'primary' },
+        acceptForSession: { label: '✅ 允许本次会话', type: 'primary' },
+        acceptWithExecpolicyAmendment: { label: '🔒 允许并记住命令', type: 'primary' },
+        decline: { label: '❌ 拒绝', type: 'danger' },
+    };
+    // Fixed presentation order; only offer decisions the protocol listed
+    // (accept/decline are always available).
+    const offered = ['accept', 'acceptForSession', 'acceptWithExecpolicyAmendment', 'decline'].filter((d) => d === 'accept' || d === 'decline' || approval.availableDecisions.includes(d));
+    // 决策按钮逐个作为 body 直接元素返回（CardKit body 纵向堆叠 = 上下排列）。
+    // 不能用 column_set width:auto 横排：手机窄屏下多个按钮挤在一行，按钮文字
+    // 被截断成省略号，用户无法辨认审批动作。
+    return offered.map((d) => ({
+        tag: 'button',
+        text: { tag: 'plain_text', content: BUTTONS[d].label },
+        type: BUTTONS[d].type,
+        behaviors: [
+            {
+                type: 'callback',
+                value: {
+                    cmd: 'approval.respond',
+                    decision: d,
+                    requestId: approval.requestId,
+                    runId,
+                    nonce: mkNonce(),
+                },
+            },
+        ],
+    }));
+}
+// =============================================================================
+// Command Approval
+// =============================================================================
+function renderCommandApproval(approval, expired, runId) {
+    const elements = [];
+    // Command display
+    const cmdContent = approval.command ? `\`${approval.command.slice(0, 500)}\`` : '(no command)';
+    elements.push({
+        tag: 'div',
+        text: { tag: 'lark_md', content: `**⚡ 命令审批**\n${cmdContent}` },
+    });
+    if (approval.commandCwd) {
+        elements.push({
+            tag: 'div',
+            text: { tag: 'lark_md', content: `📂 \`${approval.commandCwd}\`` },
+        });
+    }
+    if (approval.reason) {
+        elements.push({
+            tag: 'div',
+            text: { tag: 'lark_md', content: `💡 ${approval.reason}` },
+        });
+    }
+    // Action buttons — derived from the real protocol decision list (see
+    // renderDecisionButtons): accept/decline always, acceptForSession and
+    // acceptWithExecpolicyAmendment only when the server offers them.
+    elements.push(...renderDecisionButtons(approval, expired, runId));
+    // Pending count
+    if (approval.pendingTotal > 1) {
+        elements.push({
+            tag: 'div',
+            text: { tag: 'lark_md', content: `📋 还有 ${approval.pendingTotal - 1} 个待审批请求` },
+        });
+    }
+    return elements;
+}
+// =============================================================================
+// File Approval
+// =============================================================================
+function renderFileApproval(approval, expired, runId) {
+    const elements = [];
+    elements.push({
+        tag: 'div',
+        text: { tag: 'lark_md', content: '**📄 文件变更审批**' },
+    });
+    if (approval.reason) {
+        elements.push({
+            tag: 'div',
+            text: { tag: 'lark_md', content: `💡 ${approval.reason}` },
+        });
+    }
+    // File changes list
+    if (approval.fileChanges && approval.fileChanges.length > 0) {
+        // 审批区 diff 总预算：估算函数不计审批区，多文件大 diff 可能顶爆 28KB 卡
+        // （ErrCode 11310）。与 tool-render 的 OUTPUT_MAX/BODY_TOTAL_MAX 同思路。
+        const TOTAL_DIFF_CHARS = 2400;
+        let renderedDiffChars = 0;
+        let omittedDiffs = 0;
+        for (const change of approval.fileChanges) {
+            const icon = change.kind === 'add' ? '🆕' : change.kind === 'delete' ? '🗑️' : '✏️';
+            elements.push({
+                tag: 'div',
+                text: { tag: 'lark_md', content: `${icon} \`${change.path}\` (${change.kind})` },
+            });
+            if (change.diff) {
+                if (renderedDiffChars < TOTAL_DIFF_CHARS) {
+                    elements.push({
+                        tag: 'div',
+                        text: { tag: 'lark_md', content: renderFileDiff(change.diff) },
+                    });
+                    renderedDiffChars += Math.min(change.diff.length, MAX_DIFF_CHARS);
+                }
+                else {
+                    omittedDiffs += 1;
+                }
+            }
+        }
+        if (omittedDiffs > 0) {
+            elements.push({
+                tag: 'div',
+                text: { tag: 'lark_md', content: `_…${omittedDiffs} 个 diff 已省略（卡片预算）_` },
+            });
+        }
+    }
+    // Action buttons
+    // Derived from the real protocol decision list (see renderDecisionButtons).
+    elements.push(...renderDecisionButtons(approval, expired, runId));
+    if (approval.pendingTotal > 1) {
+        elements.push({
+            tag: 'div',
+            text: { tag: 'lark_md', content: `📋 还有 ${approval.pendingTotal - 1} 个待审批请求` },
+        });
+    }
+    return elements;
+}
+/**
+ * Render a file-change diff as a fenced code block.
+ * Truncates to protect the 28KB card budget and neutralizes triple backticks
+ * that would break the markdown fence (飞书 11311 类解析错误防线).
+ */
+function renderFileDiff(diff) {
+    const sanitized = diff.replace(/```/g, '···');
+    const truncated = sanitized.length > MAX_DIFF_CHARS
+        ? `${sanitized.slice(0, MAX_DIFF_CHARS)}\n…(diff 已截断)`
+        : sanitized;
+    return `\`\`\`diff\n${truncated}\n\`\`\``;
+}
+/** Per-diff render cap (chars), see TOTAL_DIFF_CHARS for the approval-area cap. */
+const MAX_DIFF_CHARS = 1200;
+// =============================================================================
+// Permissions Approval
+// =============================================================================
+function renderPermissionsApproval(approval, expired, runId) {
+    const elements = [];
+    elements.push({
+        tag: 'div',
+        text: { tag: 'lark_md', content: '**🔒 权限审批**' },
+    });
+    if (approval.reason) {
+        elements.push({
+            tag: 'div',
+            text: { tag: 'lark_md', content: `💡 ${approval.reason}` },
+        });
+    }
+    // Permission items with toggle buttons
+    if (approval.permissions?.items) {
+        for (const item of approval.permissions.items) {
+            const icon = item.selected ? '✅' : '⬜';
+            elements.push({
+                tag: 'div',
+                text: { tag: 'lark_md', content: `${icon} ${item.label}` },
+            });
+            elements.push({
+                tag: 'button',
+                text: {
+                    tag: 'plain_text',
+                    content: item.selected ? '取消授予' : '授予',
+                },
+                type: item.selected ? 'default' : 'primary',
+                size: 'small',
+                behaviors: [
+                    {
+                        type: 'callback',
+                        value: {
+                            cmd: 'approval.toggle',
+                            requestId: approval.requestId,
+                            permId: item.id,
+                            selected: !item.selected,
+                            runId,
+                            nonce: mkNonce(),
+                        },
+                    },
+                ],
+            });
+        }
+    }
+    // Action buttons
+    // Derived from the real protocol decision list (see renderDecisionButtons).
+    elements.push(...renderDecisionButtons(approval, expired, runId));
+    if (approval.pendingTotal > 1) {
+        elements.push({
+            tag: 'div',
+            text: { tag: 'lark_md', content: `📋 还有 ${approval.pendingTotal - 1} 个待审批请求` },
+        });
+    }
+    return elements;
+}
+//# sourceMappingURL=approval-render.js.map

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

@@ -32,5 +32,19 @@ export declare function newSessionButton(): object;
  * agent's session reader (P2 fix: completion cards from non-default agents
  * must carry agent to avoid wrong-reader fallback).
  */
+/**
+ * Create a CardKit 2.0 Compact button for Codex app-server mode.
+ * Triggers thread/compact/start via the codex.compact callback.
+ */
+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
+ * to the correct session reader + runner when the card was rendered for a
+ * non-default agent.
+ */
+export declare function resumeCompactButton(sessionId: string, agent: string): object;
 export declare function resumeUseButton(sessionId: string, agent: AgentKind): object;
 export {};

package/dist/card/card-shared.js

@@ -102,6 +102,34 @@ export function newSessionButton() {
  * agent's session reader (P2 fix: completion cards from non-default agents
  * must carry agent to avoid wrong-reader fallback).
  */
+/**
+ * Create a CardKit 2.0 Compact button for Codex app-server mode.
+ * Triggers thread/compact/start via the codex.compact callback.
+ */
+export function compactButton(runId) {
+    return {
+        tag: 'button',
+        text: { content: '🗜 Compact' },
+        type: 'primary',
+        behaviors: [{ type: 'callback', value: { cmd: 'codex.compact', 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
+ * to the correct session reader + runner when the card was rendered for a
+ * non-default agent.
+ */
+export function resumeCompactButton(sessionId, agent) {
+    return {
+        tag: 'button',
+        text: { content: '🗜 Compact' },
+        type: 'primary',
+        behaviors: [{ type: 'callback', value: { cmd: 'resume.compact', sessionId, agent } }],
+    };
+}
 export function resumeUseButton(sessionId, agent) {
     return {
         tag: 'button',

package/dist/card/run-renderer.js

@@ -1,9 +1,10 @@
-import { terminalToColor, terminalToLabel, newSessionButton, stopButton, agentDisplayName, } from './card-shared.js';
+import { terminalToColor, terminalToLabel, newSessionButton, stopButton, compactButton, agentDisplayName, } from './card-shared.js';
 import { collapsibleMarkdownPanel, markdownDiv } from './collapsible.js';
 import { toolBodyMd, toolHeaderText } from './tool-render.js';
 import { truncateUtf8, truncateMarkdownTables } from './text-truncate.js';
 import { formatTimestamp } from './time.js';
 import { formatUsageStats } from '../router/index.js';
+import { renderApprovalArea } from './approval-render.js';
 const CARD_BUDGET_BYTES = 28_000;
 const REASONING_BYTES = 4_500;
 const TEXT_BYTES = 10_000;
@@ -24,6 +25,20 @@ function measureJson(obj) {
 }
 /** markdownDiv('', 'notation') 的序列化字节（空内容 div 的常量开销，估算时复用）。 */
 const EMPTY_MD_DIV_BYTES = measureJson(markdownDiv('', 'notation'));
+/**
+ * Compact 按钮可见性：普通 run（operationKind='turn'）到达任意终态即可压缩。
+ * 异常退出（error/interrupted/idle_timeout）时上下文往往更大，更需要压缩后
+ * 再继续，因此不再要求 resultSubtype==='success'。compaction 卡
+ * （operationKind='compaction'）永不显示，防止递归 Compact。
+ */
+function shouldShowCompactButton(state) {
+    if (state.operationKind !== 'turn')
+        return false;
+    return (state.terminal === 'done' ||
+        state.terminal === 'error' ||
+        state.terminal === 'interrupted' ||
+        state.terminal === 'idle_timeout');
+}
 /**
  * Wrap text block in a collapsible panel with timestamp in the header.
  * This unifies timestamp position across all block types (thinking/plan/file_change/tool/text).
@@ -250,13 +265,17 @@ function buildDegradedElements(state, options) {
         }
     }
     elements.push(...buildSummaryContent(state));
-    // Bottom action row: stop (if running) + new session (always)
+    // Bottom action row: stop (if running) + compact (if applicable) + new session (always)
     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)) {
+        actionButtons.push(compactButton(state.runId));
+    }
     actionButtons.push(newSessionButton());
     if (actionButtons.length > 0) {
         elements.push({ tag: 'div', text: { content: '‎', tag: 'lark_md' } }, // spacer
@@ -269,6 +288,15 @@ function buildDegradedElements(state, options) {
             })),
         });
     }
+    // 审批区位于 body 最底部（底部操作行之后）：待审批时决策按钮不遮挡内容流。
+    // 多槽渲染（review P2-3）：并发审批全部展示，互不顶掉。
+    for (const slot of state.approvals ?? []) {
+        elements.push(...renderApprovalArea(slot.view, {
+            expired: slot.expired,
+            runId: state.runId,
+            terminal: state.terminal,
+        }));
+    }
     return elements;
 }
 /**
@@ -340,13 +368,17 @@ function buildExtremeFallbackElements(state, options) {
         elements.push(markdownDiv('_暂无输出_'));
     }
     elements.push(...buildSummaryContent(state));
-    // Bottom action row: stop (if running) + new session (always)
+    // Bottom action row: stop (if running) + compact (if applicable) + new session (always)
     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)) {
+        actionButtons.push(compactButton(state.runId));
+    }
     actionButtons.push(newSessionButton());
     if (actionButtons.length > 0) {
         elements.push({ tag: 'div', text: { content: '‎', tag: 'lark_md' } }, // spacer
@@ -359,6 +391,15 @@ function buildExtremeFallbackElements(state, options) {
             })),
         });
     }
+    // 审批区位于 body 最底部（底部操作行之后）：待审批时决策按钮不遮挡内容流。
+    // 多槽渲染（review P2-3）：并发审批全部展示，互不顶掉。
+    for (const slot of state.approvals ?? []) {
+        elements.push(...renderApprovalArea(slot.view, {
+            expired: slot.expired,
+            runId: state.runId,
+            terminal: state.terminal,
+        }));
+    }
     return elements;
 }
 /** Build the status row element (shared across full/degraded/extreme). */
@@ -399,13 +440,16 @@ function buildSkeletonElements(state) {
     elements.push(markdownDiv('_⚠️ 输出过大且含大量转义字符，已省略全部内容以避免超限；完整内容请查日志_'));
     // Summary (token stats etc.) — static, bounded size
     elements.push(...buildSummaryContent(state));
-    // Bottom action row: stop (if running/finalizing) + new session (always).
+    // Bottom action row: stop (if running/finalizing) + compact (if applicable) + new session (always).
     // Degraded paths must keep the action buttons reachable (design constraint).
     const actionButtons = [];
     const showStop = state.terminal === 'running' || state.terminal === 'finalizing';
     if (showStop) {
         actionButtons.push(stopButton(state.runId));
     }
+    if (shouldShowCompactButton(state)) {
+        actionButtons.push(compactButton(state.runId));
+    }
     actionButtons.push(newSessionButton());
     elements.push({ tag: 'div', text: { content: '‎', tag: 'lark_md' } }, // spacer
     {
@@ -588,11 +632,14 @@ export function renderRunCard(state, options = {}) {
             ...buildChronologicalContent(state, options, prepared, groups),
             ...buildSummaryContent(state),
         ];
-        // Bottom action row: stop (if running) + new session (always)
+        // Bottom action row: stop (if running) + compact (if applicable) + new session (always)
         const actionButtons = [];
         if (showStop) {
             actionButtons.push(stopButton(runId));
         }
+        if (shouldShowCompactButton(state)) {
+            actionButtons.push(compactButton(runId));
+        }
         actionButtons.push(newSessionButton());
         if (actionButtons.length > 0) {
             elements.push({ tag: 'div', text: { content: '‎', tag: 'lark_md' } }, // spacer
@@ -605,6 +652,15 @@ export function renderRunCard(state, options = {}) {
                 })),
             });
         }
+        // 审批区位于 body 最底部（底部操作行之后）：待审批时决策按钮不遮挡内容流。
+        // 多槽渲染（review P2-3）：并发审批全部展示，互不顶掉。
+        for (const slot of state.approvals ?? []) {
+            elements.push(...renderApprovalArea(slot.view, {
+                expired: slot.expired,
+                runId: state.runId,
+                terminal: state.terminal,
+            }));
+        }
         const card = {
             schema: '2.0',
             config: { wide_screen_mode: true, update_multi: true },
@@ -765,7 +821,10 @@ function buildSummaryContent(state) {
         elements.push(markdownDiv(`⚠️ **运行出错**\n\n${state.errorMsg ?? '未知错误'}`));
     }
     else if (state.terminal === 'interrupted') {
-        elements.push(markdownDiv('⏹ **已被用户终止**'));
+        // 审批超时（approval_expired 已标记）是「无人响应被自动取消」，不是用户
+        // 主动终止；如实展示原因，避免用户误判为 Agent 出错或自己操作过。
+        const expiredApproval = (state.approvals ?? []).some((a) => a.expired);
+        elements.push(markdownDiv(expiredApproval ? '⏰ **审批超时未响应，已自动取消**' : '⏹ **已被用户终止**'));
     }
     else if (state.terminal === 'idle_timeout') {
         elements.push(markdownDiv(`⏱ **已超时**\n\n${state.idleTimeoutMinutes ?? 0} 分钟无响应，已自动终止`));
@@ -778,6 +837,7 @@ function buildSummaryContent(state) {
             contextLength: state.contextLength,
             contextLimit: state.contextLimit,
             compactCount: state.compactCount,
+            compactPreContextLength: state.compactPreContextLength,
             cacheReadTokens: state.cacheReadTokens,
             cacheCreationTokens: state.cacheCreationTokens,
             totalTokens: state.totalTokens,
@@ -801,6 +861,9 @@ function buildDurationInfo(state) {
         state.terminal === 'idle_timeout') {
         return `⏱ ${state.footer || '已完成'}`;
     }
+    // 与标题一致：审批等待期间状态行显示「等待审批中」，而不是「工具调用中」。
+    if (hasPendingApproval(state))
+        return '✋ 等待审批中';
     return footerText2(state.footer);
 }
 function footerText2(footer) {
@@ -827,6 +890,10 @@ function headerTitle2(state, options = {}) {
         return `⏱ ${agent} · 已超时`;
     if (state.terminal === 'finalizing')
         return `⏳ ${agent} · 完成中`;
+    // 审批等待期间 server 暂停 turn，命令工具停在 tool_running——标题必须提示
+    // 正在等人工决策，而不是「调用工具」（2026-08-14 UX）。
+    if (hasPendingApproval(state))
+        return `✋ ${agent} · 等待审批`;
     if (state.footer === 'thinking')
         return `💭 ${agent} · 思考中`;
     if (state.footer === 'streaming')
@@ -835,6 +902,10 @@ function headerTitle2(state, options = {}) {
         return `🔧 ${agent} · 调用工具`;
     return `🔴 ${agent} · 运行中`;
 }
+/** 是否有未过期（仍可操作）的待审批请求。 */
+function hasPendingApproval(state) {
+    return (state.approvals ?? []).some((a) => !a.expired);
+}
 /** CardKit 2.0 header template color */
 function headerTemplate2(state) {
     return terminalToColor(state.terminal);

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

@@ -1,4 +1,4 @@
-import type { AgentEvent } from '../runner/index.js';
+import type { AgentEvent, ApprovalView } from '../runner/index.js';
 export type RunTerminal = 'running' | 'finalizing' | 'done' | 'error' | 'interrupted' | 'idle_timeout';
 export type RunFooter = 'thinking' | 'tool_running' | 'streaming' | null;
 type ToolStatus = 'running' | 'ok' | 'error';
@@ -23,27 +23,36 @@ export interface ToolEntry {
 }
 export type RunBlock = {
     kind: 'thinking';
+    /** app-server item id; exec-mode blocks leave it undefined. */
+    itemId?: string;
     content: string;
     active: boolean;
     timestamp?: string;
+    completedAt?: string;
 } | {
     kind: 'text';
+    itemId?: string;
     content: string;
     timestamp?: string;
+    completedAt?: string;
 } | {
     kind: 'tool';
     tool: ToolEntry;
 } | {
     kind: 'plan';
+    itemId?: string;
     content: string;
     active: boolean;
     timestamp?: string;
+    completedAt?: string;
 } | {
     kind: 'file_change';
+    itemId?: string;
     path: string;
     operation: 'create' | 'edit' | 'delete' | 'read';
     diff?: string;
     timestamp?: string;
+    completedAt?: string;
 };
 export interface RunState {
     runId: string;
@@ -51,7 +60,7 @@ export interface RunState {
     footer: RunFooter;
     blocks: RunBlock[];
     sessionId?: string;
-    resultSubtype?: 'success' | 'error';
+    resultSubtype?: 'success' | 'error' | 'interrupted';
     contextLength?: number;
     /** 当前模型 context window 上限（codex jsonl 提供）；卡片据此渲染百分比。 */
     contextLimit?: number;
@@ -77,15 +86,28 @@ export interface RunState {
     /** 会话累计 cache creation token（所有 run 之和）。 */
     cumulativeCacheCreationTokens?: number;
     plan?: string;
+    /** Codex 操作类型：'turn' 表示普通 run，'compaction' 表示 compact 运行。 */
+    operationKind?: 'turn' | 'compaction';
+    /** 压缩前上下文水位（codex compact 卡展示「压缩前 X → 压缩后 Y」）。 */
+    compactPreContextLength?: number;
+    /**
+     * 待审批请求列表（app-server 模式，review P2-3）。同一 turn 内并发多个审批
+     * 时全部渲染，避免后到者顶掉先到者的按钮（单槽会丢 UI，只能等超时 cancel）。
+     */
+    approvals?: Array<{
+        view: ApprovalView;
+        expired?: boolean;
+    }>;
 }
 export interface FinishMeta {
-    resultSubtype?: 'success' | 'error';
+    resultSubtype?: 'success' | 'error' | 'interrupted';
     contextLength?: number;
     /** 当前模型 context window 上限；透传到 RunState 供 done 卡片显示百分比。 */
     contextLimit?: number;
     errorMsg?: string;
     idleTimeoutMinutes?: number;
     compactCount?: number;
+    compactPreContextLength?: number;
     cacheReadTokens?: number;
     cacheCreationTokens?: number;
     /** Agent-declared total; threaded to RunState for the done card. */