lark-remote 0.5.12 → 0.5.14

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

@@ -5,6 +5,7 @@
  * Uses CardKit 2.0 (no tag:"action" container — 200861 rule).
  */
 import type { ApprovalView } from '../runner/types.js';
+import { type RunTerminal } from './run-state.js';
 /**
  * Render the approval area for a run card.
  * Returns an array of CardKit 2.0 elements to append to the card body.
@@ -12,7 +13,7 @@ import type { ApprovalView } from '../runner/types.js';
 export declare function renderApprovalArea(approval: ApprovalView | undefined, opts?: {
     expired?: boolean;
     runId?: string;
-    terminal?: string;
+    terminal?: RunTerminal;
 }): object[];
 /**
  * 紧凑审批区（run 卡 skeleton/truncatedSkeleton 兜底档专用）：固定小体积的
@@ -26,5 +27,5 @@ export declare function renderApprovalArea(approval: ApprovalView | undefined, o
 export declare function renderApprovalAreaCompact(approval: ApprovalView | undefined, opts?: {
     expired?: boolean;
     runId?: string;
-    terminal?: string;
+    terminal?: RunTerminal;
 }): object[];

package/dist/card/approval-render.js

@@ -9,6 +9,7 @@ import { truncateMarkdownTables } from './text-truncate.js';
 import { truncateUtf8 } from '../common/truncate.js';
 import { cardButton } from './card-shared.js';
 import { countCardElements } from './card-budget.js';
+import { isRunActive } from './run-state.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)}`;
@@ -156,9 +157,9 @@ export function renderApprovalAreaCompact(approval, opts) {
     }
     return elements;
 }
-/** 终态隐藏判定（renderApprovalArea 与 compact 共用）。 */
+/** 终态隐藏判定（renderApprovalArea 与 compact 共用）：仍在推进的 run 不隐藏按钮。 */
 function isTerminalHidden(opts) {
-    return !!opts?.terminal && opts.terminal !== 'running' && opts.terminal !== 'finalizing';
+    return !!opts?.terminal && !isRunActive(opts.terminal);
 }
 /**
  * Render approval action buttons from the real protocol decision list.

package/dist/card/bash-card-session.js

@@ -76,11 +76,8 @@ export class BashCardSession extends CardSession {
         if (this.state.terminal !== 'running') {
             return;
         }
-        this.cancelPendingFlush();
-        // 若有 in-flight flush 正在 await updateCard，必须等它完成后再发终态 patch，
-        // 保证顺序（pre-terminal 先落地 → terminal 后落地 → terminal 胜出）。
-        if (this.flushP)
-            await this.flushP;
+        // 终态 patch 必须排在已开始的 pre-terminal flush 之后。
+        await this.prepareTerminalUpdate();
         this.state = {
             ...this.state,
             terminal,

package/dist/{router → card}/card-helpers.d.ts

@@ -1,13 +1,13 @@
 /**
- * Shared CardKit helpers for router cards (session history, dashboard,
- * ls, ws, etc.).
+ * 卡片构造的共享工具（会话历史卡、分页条、搜索条、ls/ws 面板等）。
  *
- * Re-exports `markdownDiv` from `card/collapsible.ts` and adds session-content
- * specific builders (e.g. `sessionEventPanel`) so `router/index.ts` can fold
- * long session histories into collapsible panels without duplicating logic.
+ * 归属 card/：这些是纯建卡函数，此前住在 router/ 导致 card→router 与
+ * bridge→router 两条反向依赖。`markdownDiv` 从 `card/collapsible.ts` 复用，
+ * 会话内容相关的 builder（如 `sessionEventPanel`）在这里单源，router 与
+ * bridge 都只调用不复制。
  */
-import { markdownDiv } from '../card/collapsible.js';
-import type { AgentSessionContentEvent } from '../runner/index.js';
+import { markdownDiv } from './collapsible.js';
+import type { AgentSessionContentEvent } from '../session-contract.js';
 import { formatUsageStats } from './usage-format.js';
 type SessionUsageLike = Parameters<typeof formatUsageStats>[0];
 export declare function sessionEventPanel(ev: AgentSessionContentEvent, index: number, totalEvents: number, tailExpandedCount?: number, agentKind?: string): object;

package/dist/{router → card}/card-helpers.js

@@ -1,14 +1,14 @@
 /**
- * Shared CardKit helpers for router cards (session history, dashboard,
- * ls, ws, etc.).
+ * 卡片构造的共享工具（会话历史卡、分页条、搜索条、ls/ws 面板等）。
  *
- * Re-exports `markdownDiv` from `card/collapsible.ts` and adds session-content
- * specific builders (e.g. `sessionEventPanel`) so `router/index.ts` can fold
- * long session histories into collapsible panels without duplicating logic.
+ * 归属 card/：这些是纯建卡函数，此前住在 router/ 导致 card→router 与
+ * bridge→router 两条反向依赖。`markdownDiv` 从 `card/collapsible.ts` 复用，
+ * 会话内容相关的 builder（如 `sessionEventPanel`）在这里单源，router 与
+ * bridge 都只调用不复制。
  */
-import { agentDisplayName, cardButton } from '../card/card-shared.js';
-import { collapsibleMarkdownPanel, markdownDiv } from '../card/collapsible.js';
-import { formatMonthDayClock } from '../card/time.js';
+import { agentDisplayName, cardButton } from './card-shared.js';
+import { collapsibleMarkdownPanel, markdownDiv } from './collapsible.js';
+import { formatMonthDayClock } from './time.js';
 import { displayWidth, truncateMiddleToDisplayWidth } from '../common/text-width.js';
 import { formatUsageStats } from './usage-format.js';
 /**

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

@@ -107,15 +107,19 @@ export declare abstract class CardSession<S, RO = unknown> {
     start(): Promise<void>;
     settle(): Promise<StreamSettleResult>;
     /**
-     * 渲染当前卡片。所有生产子类的 renderer 都自带 stringify 级预算保护
+     * 渲染当前状态对应的卡片（单一渲染入口）。
+     *
+     * 所有生产子类的 renderer 都自带 stringify 级预算保护
      * （run/bash 的 degraded/extreme 路径）；发送前 Bridge 还会再走一次
      * enforceCardBudget，因此这里不再重复裁剪。
      */
-    protected safeRenderCard(): object;
+    protected renderCurrentCard(): object;
     /**
      * Push an update to the card. Tries controller.update first, falls back to
      * connector.updateCard if the controller is unavailable or fails.
      */
     protected updateCard(): Promise<void>;
+    private waitForControllerReady;
+    protected prepareTerminalUpdate(): Promise<void>;
     protected release(): void;
 }

package/dist/card/card-session.js

@@ -138,17 +138,7 @@ export class CardSession {
             // 二次调用也套 timeout 保护：若 controllerReady 永不 settle（首次超时失败），
             // 不能永久挂起。复用同样的 startTimeoutMs 超时。streamOutcome 已存在，
             // 不重复创建 stream。
-            let timer;
-            const timeout = new Promise((_, reject) => {
-                timer = setTimeout(() => reject(new Error(`${this.errorPrefix} stream start timeout`)), this.startTimeoutMs);
-            });
-            try {
-                await Promise.race([this.controllerReady, timeout]);
-            }
-            finally {
-                if (timer)
-                    clearTimeout(timer);
-            }
+            await this.waitForControllerReady();
             return;
         }
         // NOTE: the two renderCard calls below are NOT redundant. The streamCard
@@ -160,11 +150,11 @@ export class CardSession {
         // those early events. The"reuse first render" optimization was
         // rejected for this reason (premise "two renders with identical input"
         // does not hold).
-        const stream = this.connector.streamCard(this.chatId, this.safeRenderCard(), async (controller) => {
+        const stream = this.connector.streamCard(this.chatId, this.renderCurrentCard(), async (controller) => {
             this.controller = controller;
             this.messageId = controller.messageId;
             try {
-                await controller.update(this.safeRenderCard());
+                await controller.update(this.renderCurrentCard());
             }
             catch (error) {
                 getLogger().warn(`${this.logPrefix} initial controller update failed:`, error);
@@ -177,17 +167,7 @@ export class CardSession {
                 this.rejectController(error);
             return { ok: false, error };
         });
-        let timer;
-        const timeout = new Promise((_, reject) => {
-            timer = setTimeout(() => reject(new Error(`${this.errorPrefix} stream start timeout`)), this.startTimeoutMs);
-        });
-        try {
-            await Promise.race([this.controllerReady, timeout]);
-        }
-        finally {
-            if (timer)
-                clearTimeout(timer);
-        }
+        await this.waitForControllerReady();
     }
     async settle() {
         this.release();
@@ -206,7 +186,7 @@ export class CardSession {
         if (!this.messageId)
             return 'unsent';
         try {
-            await this.connector.updateCard(this.messageId, this.safeRenderCard());
+            await this.connector.updateCard(this.messageId, this.renderCurrentCard());
             return 'updated';
         }
         catch (error) {
@@ -215,11 +195,13 @@ export class CardSession {
         }
     }
     /**
-     * 渲染当前卡片。所有生产子类的 renderer 都自带 stringify 级预算保护
+     * 渲染当前状态对应的卡片（单一渲染入口）。
+     *
+     * 所有生产子类的 renderer 都自带 stringify 级预算保护
      * （run/bash 的 degraded/extreme 路径）；发送前 Bridge 还会再走一次
      * enforceCardBudget，因此这里不再重复裁剪。
      */
-    safeRenderCard() {
+    renderCurrentCard() {
         return this.renderCard(this.state, this.renderOptions);
     }
     /**
@@ -227,7 +209,7 @@ export class CardSession {
      * connector.updateCard if the controller is unavailable or fails.
      */
     async updateCard() {
-        const safeCard = this.safeRenderCard();
+        const safeCard = this.renderCurrentCard();
         if (this.controller) {
             try {
                 await this.controller.update(safeCard);
@@ -247,6 +229,24 @@ export class CardSession {
             }
         }
     }
+    async waitForControllerReady() {
+        let timer;
+        const timeout = new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new Error(`${this.errorPrefix} stream start timeout`)), this.startTimeoutMs);
+        });
+        try {
+            await Promise.race([this.controllerReady, timeout]);
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+        }
+    }
+    async prepareTerminalUpdate() {
+        this.cancelPendingFlush();
+        if (this.flushP)
+            await this.flushP;
+    }
     release() {
         if (this.released)
             return;

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

@@ -1,10 +1,10 @@
-import { type AgentKind } from '../runner/index.js';
+import type { AgentKind } from '../agent-kinds.js';
 /**
  * Display name for an agent kind in the run card header.
  *
- * Reads from the global `AgentRegistry` (set up in `index.ts` at startup)
- * when available. Falls back to a hardcoded map for callers that don't
- * wire up the registry (notably unit tests of pure render helpers).
+ * Display names are static UI labels, so the constant is the single source.
+ * Keeping a second mutable registry here made render helpers depend on startup
+ * order and forced tests to reset global state.
  */
 export declare function agentDisplayName(kind: string): string;
 export declare function terminalToLabel(terminal: string): string;

package/dist/card/card-shared.js

@@ -1,18 +1,12 @@
-import { AgentRegistry } from '../runner/index.js';
-import { AGENT_DISPLAY_NAMES } from '../runner/types.js';
+import { AGENT_DISPLAY_NAMES } from '../agent-kinds.js';
 /**
  * Display name for an agent kind in the run card header.
  *
- * Reads from the global `AgentRegistry` (set up in `index.ts` at startup)
- * when available. Falls back to a hardcoded map for callers that don't
- * wire up the registry (notably unit tests of pure render helpers).
+ * Display names are static UI labels, so the constant is the single source.
+ * Keeping a second mutable registry here made render helpers depend on startup
+ * order and forced tests to reset global state.
  */
 export function agentDisplayName(kind) {
-    const globalReg = AgentRegistry.getGlobalInstance();
-    if (globalReg) {
-        return globalReg.getDisplayName(kind);
-    }
-    // Fallback for render helpers that run without the global registry.
     return AGENT_DISPLAY_NAMES[kind] ?? kind;
 }
 const TERMINAL_LABELS = {

package/dist/card/collapsible.js

@@ -76,8 +76,9 @@ export function markdownDiv(content, textSize) {
  * to be interpreted as a literal. Escape it to preserve the raw backslash.
  *
  * Note: Square brackets [] and pipe | are NOT escaped -- they are valid markdown
- * (links, tables) and escaping them breaks link rendering. Verified safe via
- * tests/escape-bracket-experiment.test.ts: unescaped []| does not trigger 11311.
+ * (links, tables) and escaping them breaks link rendering. Verified by the live
+ * regression test tests/feishu-live/escape-bracket-regression.test.ts: unescaped
+ * []| does not trigger 11311.
  */
 function escapeMarkdown(content) {
     if (!content)

package/dist/card/final-answer-overflow.d.ts

@@ -0,0 +1 @@
+export declare function splitFinalAnswer(text: string, maxBytes?: number): string[];

package/dist/card/final-answer-overflow.js

@@ -0,0 +1,46 @@
+/**
+ * Split an authoritative final answer into plain-text messages without losing
+ * any content. Feishu cards have a hard size budget; a long answer must spill
+ * rather than being silently truncated inside the progress card.
+ */
+const FINAL_ANSWER_CHUNK_BYTES = 20_000;
+export function splitFinalAnswer(text, maxBytes = FINAL_ANSWER_CHUNK_BYTES) {
+    if (!text || maxBytes <= 0)
+        return text ? [text] : [];
+    const chunks = [];
+    let rest = text;
+    let remainingBytes = Buffer.byteLength(rest, 'utf8');
+    while (remainingBytes > maxBytes) {
+        let bytes = 0;
+        let end = 0;
+        let lastNewline = 0;
+        for (const char of rest) {
+            const charBytes = Buffer.byteLength(char, 'utf8');
+            if (bytes + charBytes > maxBytes)
+                break;
+            bytes += charBytes;
+            end += char.length;
+            if (char === '\n')
+                lastNewline = end;
+        }
+        if (end === 0) {
+            // A caller can choose a byte limit smaller than one codepoint. Keep one
+            // codepoint per chunk rather than looping forever with a zero-length cut.
+            const first = Array.from(rest)[0];
+            chunks.push(first);
+            rest = rest.slice(first.length);
+            remainingBytes -= Buffer.byteLength(first, 'utf8');
+            continue;
+        }
+        // Prefer a paragraph/line boundary when it does not waste most of a chunk.
+        const cut = lastNewline > 0 && lastNewline >= Math.floor(end * 0.6) ? lastNewline : end;
+        const chunk = rest.slice(0, cut);
+        chunks.push(chunk);
+        rest = rest.slice(cut);
+        remainingBytes -= Buffer.byteLength(chunk, 'utf8');
+    }
+    if (rest)
+        chunks.push(rest);
+    return chunks;
+}
+//# sourceMappingURL=final-answer-overflow.js.map

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

@@ -1,6 +1,6 @@
 import { CardSession, type CardChannel } from './card-session.js';
 import type { AgentEvent } from '../runner/index.js';
-import { type FinishMeta, type RunState, type RunTerminal } from './run-state.js';
+import { type FinishMeta, type RunFinalTerminal, type RunState } from './run-state.js';
 import { type RunCardRenderOptions } from './run-renderer.js';
 export type { CardChannel as RunCardChannel };
 export declare class RunCardSession extends CardSession<RunState, RunCardRenderOptions> {
@@ -20,5 +20,5 @@ export declare class RunCardSession extends CardSession<RunState, RunCardRenderO
     protected renderCard(state: RunState, options: RunCardRenderOptions): object;
     protected isFlushableState(): boolean;
     push(event: AgentEvent): Promise<void>;
-    finish(terminal: Exclude<RunTerminal, 'running' | 'finalizing'>, meta?: FinishMeta): Promise<void>;
+    finish(terminal: RunFinalTerminal, meta?: FinishMeta): Promise<void>;
 }

package/dist/card/run-card-session.js

@@ -1,5 +1,5 @@
 import { CardSession } from './card-session.js';
-import { createInitialRunState, finishRun, reduceRunState, } from './run-state.js';
+import { createInitialRunState, finishRun, isRunActive, reduceRunState, } from './run-state.js';
 import { renderRunCard } from './run-renderer.js';
 export class RunCardSession extends CardSession {
     constructor(opts) {
@@ -25,7 +25,7 @@ export class RunCardSession extends CardSession {
     isFlushableState() {
         // finish() 已转终态（done/error/interrupted/idle_timeout）时不再 patch；
         // 'finalizing' 是非终态，in-flight/延迟 flush 仍可渲染累积事件。
-        return this.state.terminal === 'running' || this.state.terminal === 'finalizing';
+        return isRunActive(this.state.terminal);
     }
     async push(event) {
         // state 每事件立即 reduce（始终最新），但 updateCard 延迟到合批窗口末尾。
@@ -46,13 +46,8 @@ export class RunCardSession extends CardSession {
     }
     async finish(terminal, meta = {}) {
         // 终态必须即时显示（spec）：取消合批窗口，不等延迟 flush 调度。
-        this.cancelPendingFlush();
-        // 若有 in-flight flush 正在 await updateCard，必须等它完成后再发终态 patch。
-        // 否则两条并发 controller.update 无 FIFO 保证，in-flight 的 pre-terminal
-        // patch 可能在终态 patch 之后 resolve → 用户看到"思考中"终帧。
-        // await 保证顺序：pre-terminal 先落地 → terminal 后落地 → terminal 胜出。
-        if (this.flushP)
-            await this.flushP;
+        // 终态 patch 必须排在已开始的 pre-terminal flush 之后。
+        await this.prepareTerminalUpdate();
         this.state = finishRun(this.state, terminal, meta);
         await this.updateCard();
         this.release();

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

@@ -20,6 +20,12 @@ export interface RunCardRenderOptions {
      */
     sessionFallbackAvailable?: boolean;
 }
+export interface RunCardRenderOutcome {
+    card: object;
+    finalAnswerStatus: 'none' | 'full' | 'overflow';
+    /** Full text to deliver outside the card when finalAnswerStatus is overflow. */
+    finalAnswerText?: string;
+}
 type BlockGroup = {
     kind: 'thinking';
     content: string;
@@ -73,4 +79,12 @@ export declare function estimateCardBytes(state: RunState, options?: RunCardRend
  * CardKit 2.0 renderer - simplified for streaming (no tabs)
  */
 export declare function renderRunCard(state: RunState, options?: RunCardRenderOptions): object;
+/**
+ * Render a run card with metadata the bridge needs to deliver an answer that
+ * cannot fit in one Feishu card. `renderRunCard` remains the card-only API used
+ * by streaming sessions.
+ */
+export declare function renderRunCardDetailed(state: RunState, options?: RunCardRenderOptions): RunCardRenderOutcome;
+/** Exact-match marker used in the card before the answer is sent separately. */
+export declare const FINAL_ANSWER_OVERFLOW_MARKER = "_\u6700\u7EC8\u56DE\u7B54\u8F83\u957F\uFF0C\u5B8C\u6574\u5185\u5BB9\u5DF2\u968F\u540E\u53D1\u9001_";
 export {};

package/dist/card/run-renderer.js

@@ -1,4 +1,4 @@
-import { isRunTerminal, } from './run-state.js';
+import { isRunActive, isRunTerminal, } from './run-state.js';
 import { terminalToColor, terminalToLabel, newSessionButton, stopButton, compactButton, cardButton, agentDisplayName, } from './card-shared.js';
 import { collapsibleMarkdownPanel, markdownDiv } from './collapsible.js';
 import { toolBodyMd, toolHeaderText } from './tool-render.js';
@@ -8,7 +8,7 @@ import { countCardElements, MAX_CARD_ELEMENTS } from './card-budget.js';
 import { displayWidth, truncateToDisplayWidth } from '../common/text-width.js';
 import { isContentFilterFailure } from '../common/turn-failure.js';
 import { formatClock, formatTimestamp } from './time.js';
-import { formatUsageStats } from '../router/usage-format.js';
+import { formatUsageStats } from './usage-format.js';
 import { renderApprovalArea, renderApprovalAreaCompact } from './approval-render.js';
 const REASONING_BYTES = 4_500;
 const TEXT_BYTES = 10_000;
@@ -406,7 +406,7 @@ const EXTREME_TIER = {
 function actionButtonList(state, options) {
     const actionButtons = [];
     // finalizing 也显示停止按钮（进程未退出，用户可 /stop）
-    const showStop = state.terminal === 'running' || state.terminal === 'finalizing';
+    const showStop = isRunActive(state.terminal);
     if (showStop) {
         actionButtons.push(stopButton(state.runId));
     }
@@ -867,6 +867,20 @@ function measurePanelBytes(title, expanded, border, content) {
  * CardKit 2.0 renderer - simplified for streaming (no tabs)
  */
 export function renderRunCard(state, options = {}) {
+    return renderRunCardDetailed(state, options).card;
+}
+/**
+ * Render a run card with metadata the bridge needs to deliver an answer that
+ * cannot fit in one Feishu card. `renderRunCard` remains the card-only API used
+ * by streaming sessions.
+ */
+export function renderRunCardDetailed(state, options = {}) {
+    if (state.finalAnswer?.content.trim()) {
+        return buildFinalAnswerPriorityCard(state, options);
+    }
+    return { card: renderLegacyRunCard(state, options), finalAnswerStatus: 'none' };
+}
+function renderLegacyRunCard(state, options) {
     // 先估后建：用廉价估算预测是否超 28KB 预算，明显超预算直接跳过完整卡构建走
     // degraded。groups/prepared 只算一次，测量与正式渲染共用同一份截断结果，
     // 避免影子测量 + 正式渲染对每个超限块双倍截断。
@@ -927,6 +941,110 @@ export function renderRunCard(state, options = {}) {
     };
     return truncatedSkeleton;
 }
+/** Exact-match marker used in the card before the answer is sent separately. */
+export const FINAL_ANSWER_OVERFLOW_MARKER = '_最终回答较长，完整内容已随后发送_';
+/**
+ * Build a card around the authoritative final answer.
+ *
+ * The answer is measured first with the fixed controls. Progress groups are
+ * added newest-first only while the whole card still fits. If the answer
+ * cannot fit even without progress/summary, the card carries an explicit
+ * marker and the bridge sends the complete answer separately.
+ */
+function buildFinalAnswerPriorityCard(state, options) {
+    const finalAnswer = state.finalAnswer;
+    const groups = groupBlocks(state.blocks);
+    const prepared = prepareGroupContent(groups);
+    const safeAnswer = truncateMarkdownTables(finalAnswer.content);
+    const requiresOverflow = safeAnswer !== finalAnswer.content;
+    const ts = formatTimestamp(finalAnswer.timestamp);
+    const answerElements = renderTextBlock(safeAnswer, ts, state.terminal !== 'running');
+    const fixedStart = [statusRow(state), ...omittedBlocksHint(state)];
+    const summary = buildSummaryContent(state, { includeNotices: false });
+    const controls = [...actionRow(state, options), ...approvalArea(state)];
+    const buildWithProgress = (start, includeSummary) => {
+        const renderedProgress = buildAnswerProgressContent(state, prepared, groups.slice(start));
+        const progress = start < groups.length
+            ? [markdownDiv(`_💡 已省略 ${start} 个早期步骤_`), ...renderedProgress]
+            : renderedProgress;
+        return assembleRunCard(state, options, [
+            ...fixedStart,
+            ...progress,
+            ...(requiresOverflow ? [markdownDiv(FINAL_ANSWER_OVERFLOW_MARKER)] : []),
+            ...answerElements,
+            ...(includeSummary ? summary : []),
+            ...controls,
+        ]);
+    };
+    let best = buildWithProgress(groups.length, true);
+    if (withinRunCardBudget(best)) {
+        for (let start = groups.length - 1; start >= 0; start--) {
+            const candidate = buildWithProgress(start, true);
+            if (!withinRunCardBudget(candidate))
+                break;
+            best = candidate;
+        }
+        return {
+            card: best,
+            finalAnswerStatus: requiresOverflow ? 'overflow' : 'full',
+            ...(requiresOverflow ? { finalAnswerText: finalAnswer.content } : {}),
+        };
+    }
+    // The answer outranks the usage summary. Keep the answer and controls first,
+    // then retry without the summary before declaring a physical overflow.
+    const withoutSummary = buildWithProgress(groups.length, false);
+    if (withinRunCardBudget(withoutSummary)) {
+        return {
+            card: withoutSummary,
+            finalAnswerStatus: requiresOverflow ? 'overflow' : 'full',
+            ...(requiresOverflow ? { finalAnswerText: finalAnswer.content } : {}),
+        };
+    }
+    const overflowCard = assembleRunCard(state, options, [
+        ...fixedStart,
+        markdownDiv(FINAL_ANSWER_OVERFLOW_MARKER),
+        ...controls,
+    ]);
+    return {
+        card: overflowCard,
+        finalAnswerStatus: 'overflow',
+        finalAnswerText: finalAnswer.content,
+    };
+}
+/** Render a contiguous progress suffix for the answer-priority card. */
+function buildAnswerProgressContent(state, prepared, visible) {
+    const elements = [];
+    const outputMax = toolOutputBudget(state);
+    const contentItems = mergeNoticesIntoContent(visible, state.notices);
+    for (const item of contentItems) {
+        if (item.kind === 'notice') {
+            elements.push(renderNoticeRow(item.notice));
+            continue;
+        }
+        const group = item;
+        if (group.kind === 'tool') {
+            elements.push(renderTool(group.tool, outputMax));
+            continue;
+        }
+        if (group.kind === 'text') {
+            const content = prepared.get(group) ?? '';
+            const ts = formatTimestamp(group.timestamp);
+            elements.push(...renderTextBlock(content, ts, state.terminal !== 'running'));
+            continue;
+        }
+        const spec = describePanelGroup(group, prepared);
+        if (!spec)
+            continue;
+        elements.push(collapsibleMarkdownPanel({
+            title: spec.title,
+            expanded: spec.expanded,
+            border: spec.border,
+            content: spec.content,
+            textSize: 'notation',
+        }));
+    }
+    return elements;
+}
 /**
  * Run 卡片的双预算检查：UTF-8 字节 ≤ 28KB **且** 元素数 ≤ `MAX_CARD_ELEMENTS`。
  *
@@ -1037,7 +1155,7 @@ function buildSummaryContent(state, options = {}) {
     }
     else {
         const result = state.resultSubtype ?? 'success';
-        const hasContent = state.blocks.length > 0;
+        const hasContent = state.blocks.length > 0 || !!state.finalAnswer?.content.trim();
         // 压缩（operationKind='compaction'）不会返回 agent 正文——引擎只压缩上下文
         // 窗口，空内容属正常，不能沿用普通 run 的「（未返回内容）」异常信号
         // （2026-09 用户反馈）。所有会压缩的 agent（codex/claude/kimi/opencode/pi）
@@ -1047,25 +1165,10 @@ function buildSummaryContent(state, options = {}) {
             : state.operationKind === 'compaction'
                 ? '\n\n🗜 Compact 完成'
                 : '\n\n（未返回内容）';
-        const usageStatsStr = formatUsageStats({
-            contextLength: state.contextLength,
-            contextLimit: state.contextLimit,
-            compactCount: state.compactCount,
-            compactPreContextLength: state.compactPreContextLength,
-            cacheReadTokens: state.cacheReadTokens,
-            cacheCreationTokens: state.cacheCreationTokens,
-            totalTokens: state.totalTokens,
-            inputTokens: state.inputTokens,
-            outputTokens: state.outputTokens,
-            cumulativeTotalTokens: state.cumulativeTotalTokens,
-            cumulativeInputTokens: state.cumulativeInputTokens,
-            cumulativeOutputTokens: state.cumulativeOutputTokens,
-            cumulativeCacheReadTokens: state.cumulativeCacheReadTokens,
-            cumulativeCacheCreationTokens: state.cumulativeCacheCreationTokens,
-            model: state.model,
-            costUsd: state.costUsd,
-            reasoningTokens: state.reasoningTokens,
-        }, {
+        // RunState 的用量字段就是 formatUsageStats 的入参形态（同为
+        // `UsageSnapshot`）——原先这里逐字段抄了 17 行，加一个字段要同时改
+        // RunState、FinishMeta 和这张清单（§9.21）。
+        const usageStatsStr = formatUsageStats(state, {
             showResult: true,
             result,
             // 本轮结束但目标继续：不能报"已完成"，也不能说"出错"。