lark-remote 0.1.5 → 0.1.7

package/dist/bridge/queue-manager.d.ts

@@ -29,6 +29,13 @@ export interface QueuedTask {
     workspace: string;
     timestamp: number;
     messagePreview: string;
+    /**
+     * Whether the queued task's message is editable from the queue card.
+     * Card actions like Compact are one-shot operations — editing their
+     * preview is meaningless, so they enqueue with `editable: false` and the
+     * queue card omits the ✏️ 编辑 button.
+     */
+    editable?: boolean;
     /**
      * Edited message content. Set by `updateQueuedTaskMessage` when the user
      * edits a queued message. The original closure captured at enqueue time
@@ -54,6 +61,8 @@ export interface EnqueueOptions {
          * real Feishu id and doubles as the reply target.
          */
         feishuReplyTo?: string;
+        /** Whether the queued task is editable (queue card ✏️ 编辑 button). Defaults to true. */
+        editable?: boolean;
         /** 入队时刻捕获的 agent+session 绑定（方案 D4）。 */
         binding?: AgentBinding;
     };
@@ -92,7 +101,8 @@ export declare class QueueManager {
      * executing/cancelled state. The promise never rejects (send failures
      * resolve undefined), so awaiting it is always safe.
      */
-    private queueCardMessages;
+    /** queue card 的 send promise 表（public：bridge 集成测试注入/断言用）。 */
+    queueCardMessages: Map<string, Promise<string | undefined>>;
     /** Track number of executing tasks per workspace (for queue card display). */
     private pendingOrExecutingCount;
     /**

package/dist/bridge/queue-manager.js

@@ -38,6 +38,7 @@ export class QueueManager {
      * executing/cancelled state. The promise never rejects (send failures
      * resolve undefined), so awaiting it is always safe.
      */
+    /** queue card 的 send promise 表（public：bridge 集成测试注入/断言用）。 */
     queueCardMessages = new Map();
     /** Track number of executing tasks per workspace (for queue card display). */
     pendingOrExecutingCount = new Map();
@@ -138,6 +139,7 @@ export class QueueManager {
                 workspace,
                 timestamp: Date.now(),
                 messagePreview,
+                editable: taskMeta.editable,
                 binding: taskMeta.binding,
             };
             // Check if there are tasks waiting BEFORE adding this one
@@ -395,22 +397,29 @@ export class QueueManager {
             },
             { tag: 'hr' },
         ];
-        // Show message preview with edit button (only if not executing)
+        // Show message preview with edit button (only if not executing AND the
+        // task is editable). One-shot card actions like Compact enqueue with
+        // editable=false: their preview is not user-editable text, so the ✏️ 编辑
+        // button must not appear (queue card is still shown — only editing is
+        // meaningless for them).
         if (messagePreview) {
             elements.push({
                 tag: 'div',
                 text: { tag: 'lark_md', content: `📝 \`${messagePreview}\`` },
             });
-            // Edit button: a pending (queued) task is always editable. The
-            // executing/cancelled states render via dedicated card builders that
-            // hard-disable all buttons, so this builder only serves pending cards.
-            elements.push({
-                tag: 'button',
-                text: { tag: 'plain_text', content: '✏️ 编辑' },
-                type: 'default',
-                size: 'small',
-                behaviors: [{ type: 'callback', value: { cmd: 'queue.edit', workspace, messageId } }],
-            });
+            const task = this.indexGet(workspace, messageId);
+            if (task?.editable !== false) {
+                // Edit button: a pending (queued) task is editable by default. The
+                // executing/cancelled states render via dedicated card builders that
+                // hard-disable all buttons, so this builder only serves pending cards.
+                elements.push({
+                    tag: 'button',
+                    text: { tag: 'plain_text', content: '✏️ 编辑' },
+                    type: 'default',
+                    size: 'small',
+                    behaviors: [{ type: 'callback', value: { cmd: 'queue.edit', workspace, messageId } }],
+                });
+            }
             elements.push({ tag: 'hr' });
         }
         // Action buttons

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,363 @@
+/**
+ * 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)}`;
+}
+/** reason div（3 处共用）；反引号中和防 lark_md 解析错误（review P2-2）。 */
+function reasonDiv(approval) {
+    if (!approval.reason)
+        return null;
+    const neutralized = approval.reason.replace(/`/g, '·');
+    return {
+        tag: 'div',
+        text: { tag: 'lark_md', content: `💡 ${neutralized}` },
+    };
+}
+/**
+ * Append a possibly-null element to the array (convenience for optional divs).
+ * If the element is null, nothing is appended.
+ */
+function pushIf(arr, el) {
+    if (el !== null)
+        arr.push(el);
+}
+/**
+ * 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));
+    }
+    else if (approval.kind === 'question') {
+        elements.push(...renderQuestionApproval(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' },
+        acceptAll: { label: '✅ 允许所有', type: 'primary' },
+        decline: { label: '❌ 拒绝', type: 'danger' },
+    };
+    // Fixed presentation order; only offer decisions the protocol listed
+    // (accept/decline are always available; acceptAll is Claude 专属「允许所有」)。
+    const offered = [
+        'accept',
+        'acceptForSession',
+        'acceptWithExecpolicyAmendment',
+        'acceptAll',
+        '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
+    // review P2-2：命令里的反引号会提前终止 lark_md 行内代码 span，奇数次
+    // 反引号极易触发 11311 解析错误导致整卡失败（同 renderFileDiff 的中和策略）。
+    const neutralizedCommand = (approval.command ?? '').replace(/`/g, '·');
+    const cmdContent = neutralizedCommand
+        ? `\`${neutralizedCommand.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}\`` },
+        });
+    }
+    pushIf(elements, reasonDiv(approval));
+    // 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));
+    return elements;
+}
+// =============================================================================
+// File Approval
+// =============================================================================
+function renderFileApproval(approval, expired, runId) {
+    const elements = [];
+    elements.push({
+        tag: 'div',
+        text: { tag: 'lark_md', content: '**📄 文件变更审批**' },
+    });
+    pushIf(elements, reasonDiv(approval));
+    // 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));
+    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: '**🔒 权限审批**' },
+    });
+    pushIf(elements, reasonDiv(approval));
+    // 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));
+    return elements;
+}
+// =============================================================================
+// AskUserQuestion Approval
+// =============================================================================
+/**
+ * 渲染 Claude AskUserQuestion 选项卡（审批区复用）。
+ *
+ * - 单选问题：点击选项即选中（协调器在全部问题答完后自动提交）。
+ * - 多选问题：点击切换勾选，勾选后出现「提交答案」按钮。
+ * - 已选状态经 approval_view_updated 回流（view.questions[].selected）。
+ */
+function renderQuestionApproval(approval, expired, runId) {
+    const elements = [];
+    elements.push({
+        tag: 'div',
+        text: { tag: 'lark_md', content: '**❓ 需要你回答**' },
+    });
+    if (expired) {
+        elements.push({
+            tag: 'div',
+            text: { tag: 'lark_md', content: '⏰ **审批已过期**' },
+        });
+        return elements;
+    }
+    const questions = approval.questions ?? [];
+    for (let i = 0; i < questions.length; i++) {
+        const q = questions[i];
+        const selected = q.selected ?? [];
+        const header = q.header || `问题 ${i + 1}`;
+        elements.push({
+            tag: 'div',
+            text: {
+                tag: 'lark_md',
+                content: `**${header}**${q.multiSelect ? '（可多选）' : ''}\n${q.question}`,
+            },
+        });
+        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(),
+                        },
+                    },
+                ],
+            });
+        }
+        // 自定义答案（Other）的选中态展示：选项按钮无法表示自由文本，单独显示
+        // 已选文本，避免「点了没反应」的困惑（review P3）。
+        const customSelected = q.selected?.find((s) => !q.options.some((o) => o.label === s));
+        if (customSelected) {
+            elements.push({
+                tag: 'div',
+                text: { tag: 'lark_md', content: `✍️ 自定义答案：${customSelected}` },
+            });
+        }
+        // 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(),
+                        },
+                    },
+                ],
+            });
+        }
+        // 多选问题：有勾选才给提交按钮（单选在协调器内即时提交）。
+        if (q.multiSelect && selected.length > 0) {
+            elements.push({
+                tag: 'button',
+                text: { tag: 'plain_text', content: `✅ 提交答案（已选 ${selected.length} 项）` },
+                type: 'primary',
+                behaviors: [
+                    {
+                        type: 'callback',
+                        value: {
+                            cmd: 'approval.answerSubmit',
+                            requestId: approval.requestId,
+                            questionIndex: i,
+                            runId,
+                            nonce: mkNonce(),
+                        },
+                    },
+                ],
+            });
+        }
+    }
+    return elements;
+}
+//# sourceMappingURL=approval-render.js.map

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

@@ -1,4 +1,4 @@
-import { CardSession, type CardChannel, type StreamSettleResult } from './card-session.js';
+import { CardSession, type CardChannel } from './card-session.js';
 import { type BashState, type BashRenderOptions } from './bash-renderer.js';
 /**
  * Store-time 输出上限（字符，P1-3 层①）。§P1-3 建议「store-time 截断，
@@ -23,18 +23,6 @@ export declare function capBashOutput(value: string): string;
  * independent cards.
  */
 export declare class BashCardSession extends CardSession<BashState, BashRenderOptions> {
-    /**
-     * P1-3 层③：push 合批窗口（ms），与 RunCardSession 同语义。连续 update 各触发
-     * 一次全卡 render + patch 是 PATCH 风暴主源；窗口内多个事件复用同一次延迟 flush。
-     * 窗口大小可通过 constructor 覆盖（测试用小窗口/0 禁用）。
-     */
-    private readonly coalesceMs;
-    private flushTimer;
-    private flushInFlight;
-    /** in-flight flush 期间到达的 update 标记：flush 完成后需重新调度（防 stale 帧）。 */
-    private pendingReschedule;
-    /** 当前 in-flight flush 的 promise：finish 在终态 patch 前 await 它保证顺序。 */
-    private flushP;
     constructor(opts: {
         connector: CardChannel;
         chatId: string;
@@ -51,6 +39,7 @@ export declare class BashCardSession extends CardSession<BashState, BashRenderOp
     protected get errorPrefix(): string;
     protected renderCard(state: BashState, options: BashRenderOptions): object;
     protected hasOwnBudgetProtection(): boolean;
+    protected isFlushableState(): boolean;
     /** Patch the card with updated bash state (e.g. new stdout/stderr). */
     update(patch: Partial<BashState>): Promise<void>;
     /** Transition to a terminal state and patch the card. */
@@ -59,17 +48,6 @@ export declare class BashCardSession extends CardSession<BashState, BashRenderOp
         stderr?: string;
         output?: string;
     }): Promise<void>;
-    /**
-     * 调度一次延迟 flush：已有 pending 调度则复用（合批核心）；flushInFlight 期间
-     * 不再起 timer（防重入叠加），但置 pendingReschedule 让 in-flight 完成后补渲染。
-     */
-    private scheduleFlush;
-    /** 执行一次 render + updateCard（合批窗口到期或 finish 即时 flush 时调用）。 */
-    private flush;
-    /** 取消待 flush 的合批调度（finish/settle 前清理，避免延迟 update 与终态竞争）。 */
-    private cancelPendingFlush;
-    /** settle 前兜底取消合批调度，避免 release 后 dangling timer 更新已释放的 stream。 */
-    settle(): Promise<StreamSettleResult>;
     /**
      * 合并 patch 并对 output/stderr 做 store-time 截断（P1-3 层①）。
      * 截断发生在入口（store 时），渲染层无需再为大 state 付代价。

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

@@ -1,5 +1,6 @@
 import { CardSession } from './card-session.js';
 import { renderBashCard } from './bash-renderer.js';
+import { keepTail } from '../common/truncate.js';
 /**
  * Store-time 输出上限（字符，P1-3 层①）。§P1-3 建议「store-time 截断，
  * 保留尾部，上限如 24~64KB」——取区间下界 24_000 字符（字符上限 ×4 字节最坏
@@ -8,10 +9,6 @@ import { renderBashCard } from './bash-renderer.js';
  * state 与 bridge 局部变量。
  */
 export const BASH_OUTPUT_STORE_CAP = 24_000;
-/** 字符级 tail 保留（与 run-state.keepLatest 的 slice(-maxChars) 语义一致）。 */
-function keepTail(value, maxChars) {
-    return value.length <= maxChars ? value : value.slice(-maxChars);
-}
 /**
  * Store-time 截断入口（P1-3 层①/层④共用）。bridge 本地 output/stderr 与 session
  * state 都走它，保证任意路径驻留的字符串 ≤ BASH_OUTPUT_STORE_CAP 字符。
@@ -29,18 +26,6 @@ export function capBashOutput(value) {
  * independent cards.
  */
 export class BashCardSession extends CardSession {
-    /**
-     * P1-3 层③：push 合批窗口（ms），与 RunCardSession 同语义。连续 update 各触发
-     * 一次全卡 render + patch 是 PATCH 风暴主源；窗口内多个事件复用同一次延迟 flush。
-     * 窗口大小可通过 constructor 覆盖（测试用小窗口/0 禁用）。
-     */
-    coalesceMs;
-    flushTimer;
-    flushInFlight = false;
-    /** in-flight flush 期间到达的 update 标记：flush 完成后需重新调度（防 stale 帧）。 */
-    pendingReschedule = false;
-    /** 当前 in-flight flush 的 promise：finish 在终态 patch 前 await 它保证顺序。 */
-    flushP;
     constructor(opts) {
         super({
             runId: opts.runId,
@@ -56,8 +41,8 @@ export class BashCardSession extends CardSession {
             renderOptions: opts.renderOptions,
             startTimeoutMs: opts.startTimeoutMs,
             settleTimeoutMs: opts.settleTimeoutMs,
+            coalesceMs: opts.coalesceMs,
         });
-        this.coalesceMs = opts.coalesceMs ?? 100;
     }
     get logPrefix() {
         return '[bash-card]';
@@ -76,6 +61,10 @@ export class BashCardSession extends CardSession {
         // 卡应跳过它，靠自身 renderer 保护。
         return true;
     }
+    isFlushableState() {
+        // finish() 已把 state 转终态后，in-flight/延迟 flush 不再用旧 state patch。
+        return this.state.terminal === 'running';
+    }
     /** Patch the card with updated bash state (e.g. new stdout/stderr). */
     async update(patch) {
         this.state = this.applyCap(patch);
@@ -102,62 +91,6 @@ export class BashCardSession extends CardSession {
         await this.updateCard();
         this.release();
     }
-    /**
-     * 调度一次延迟 flush：已有 pending 调度则复用（合批核心）；flushInFlight 期间
-     * 不再起 timer（防重入叠加），但置 pendingReschedule 让 in-flight 完成后补渲染。
-     */
-    scheduleFlush() {
-        if (this.flushTimer)
-            return;
-        if (this.flushInFlight) {
-            this.pendingReschedule = true;
-            return;
-        }
-        this.flushTimer = setTimeout(() => {
-            this.flushTimer = undefined;
-            void this.flush();
-        }, this.coalesceMs);
-    }
-    /** 执行一次 render + updateCard（合批窗口到期或 finish 即时 flush 时调用）。 */
-    async flush() {
-        if (this.flushInFlight)
-            return;
-        // 终态守卫：finish 已把 state 转终态后，in-flight/延迟 flush 不再用旧 state patch
-        if (this.state.terminal !== 'running')
-            return;
-        this.flushInFlight = true;
-        const flushPromise = (async () => {
-            try {
-                await this.updateCard();
-            }
-            finally {
-                this.flushInFlight = false;
-                this.flushP = undefined;
-                // in-flight 期间若有 update 到达（pendingReschedule），重新调度一次渲染
-                if (this.pendingReschedule) {
-                    this.pendingReschedule = false;
-                    this.scheduleFlush();
-                }
-            }
-        })();
-        this.flushP = flushPromise;
-        return flushPromise;
-    }
-    /** 取消待 flush 的合批调度（finish/settle 前清理，避免延迟 update 与终态竞争）。 */
-    cancelPendingFlush() {
-        this.pendingReschedule = false;
-        if (this.flushTimer) {
-            clearTimeout(this.flushTimer);
-            this.flushTimer = undefined;
-            return true;
-        }
-        return false;
-    }
-    /** settle 前兜底取消合批调度，避免 release 后 dangling timer 更新已释放的 stream。 */
-    async settle() {
-        this.cancelPendingFlush();
-        return super.settle();
-    }
     /**
      * 合并 patch 并对 output/stderr 做 store-time 截断（P1-3 层①）。
      * 截断发生在入口（store 时），渲染层无需再为大 state 付代价。

package/dist/card/bash-renderer.js

@@ -1,11 +1,10 @@
 import { terminalToColor, terminalToLabel, stopButton } from './card-shared.js';
 import { markdownDiv } from './collapsible.js';
-import { truncateUtf8 } from './text-truncate.js';
+import { truncateUtf8, CARD_BUDGET_BYTES } from './text-truncate.js';
 /**
  * 飞书卡片大小限制（安全阈值，与 run-renderer 一致）。
- * 本地定义，不从 card-budget.ts 导入（避免流式/静态耦合）。
+ * 从共享的 text-truncate.ts 导入，避免三处各自定义后数值漂移。
  */
-const CARD_BUDGET_BYTES = 28_000;
 /**
  * 单个输出字段的默认最大字节数（保守值，用于正常路径）。
  * 飞书卡片限制约 28KB，留余量给卡片其他部分（header、status row、footer）