lark-remote 0.5.13 → 0.5.15

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/{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,11 +107,13 @@ 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.

package/dist/card/card-session.js

@@ -150,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);
@@ -186,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) {
@@ -195,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);
     }
     /**
@@ -207,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);

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

@@ -1,4 +1,4 @@
-import { type AgentKind } from '../runner/types.js';
+import type { AgentKind } from '../agent-kinds.js';
 /**
  * Display name for an agent kind in the run card header.
  *

package/dist/card/card-shared.js

@@ -1,4 +1,4 @@
-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.
  *

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

@@ -1,7 +1 @@
-/**
- * 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.
- */
-export declare const FINAL_ANSWER_CHUNK_BYTES = 20000;
 export declare function splitFinalAnswer(text: string, maxBytes?: number): string[];

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

@@ -3,7 +3,7 @@
  * any content. Feishu cards have a hard size budget; a long answer must spill
  * rather than being silently truncated inside the progress card.
  */
-export const FINAL_ANSWER_CHUNK_BYTES = 20_000;
+const FINAL_ANSWER_CHUNK_BYTES = 20_000;
 export function splitFinalAnswer(text, maxBytes = FINAL_ANSWER_CHUNK_BYTES) {
     if (!text || maxBytes <= 0)
         return text ? [text] : [];

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 延迟到合批窗口末尾。

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));
     }
@@ -1137,13 +1137,12 @@ function buildSummaryContent(state, options = {}) {
         }
     }
     else if (state.terminal === 'interrupted') {
-        // 审批超时（approval_expired 已标记）是「无人响应被自动取消」，不是用户
-        // 主动终止；如实展示原因，避免用户误判为 Agent 出错或自己操作过。
-        // 顶层 approvalExpired 优先：approval_resolved 会移除审批条目，但标记
-        // 必须活到终态渲染（2026-08-15 事故回归）。
+        // 中断来源三元：审批超时 / 用户取消审批 / 用户主动终止。
+        // 显式原因优先：approvalExpired 是粘性标记（cancel 语义下 agent 可能继续跑），
+        // 用户随后主动 /stop 时若仍按过期渲染，就把「我自己停的」误报成自动取消。
         const expiredApproval = state.interruptedReason === 'approval_timeout' ||
-            state.approvalExpired === true ||
-            (state.approvals ?? []).some((a) => a.expired);
+            (state.interruptedReason === undefined &&
+                (state.approvalExpired === true || (state.approvals ?? []).some((a) => a.expired)));
         elements.push(markdownDiv(expiredApproval
             ? '⏰ **审批超时未响应，已自动取消**'
             : state.interruptedReason === 'approval_cancelled'
@@ -1165,31 +1164,21 @@ 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,
-        }, {
+        // goal 本 run 读不到（known=false）时不能写「已完成」：这是 GoalStateEvent
+        // 契约里明令禁止的推断（读不到 ≠ 没有目标）。run 本身成功，只是目标维度未知。
+        const goalUnknown = state.terminal === 'done' && state.goalKnown === false;
+        // RunState 的用量字段就是 formatUsageStats 的入参形态（同为
+        // `UsageSnapshot`）——原先这里逐字段抄了 17 行，加一个字段要同时改
+        // RunState、FinishMeta 和这张清单（§9.21）。
+        const usageStatsStr = formatUsageStats(state, {
             showResult: true,
             result,
             // 本轮结束但目标继续：不能报"已完成"，也不能说"出错"。
             ...(state.terminal === 'goal_continuing'
                 ? { completedLabel: '⏳ 本轮结束 · 目标仍在继续' }
-                : {}),
+                : goalUnknown
+                    ? { completedLabel: '✅ 本轮完成 · 目标状态未确认' }
+                    : {}),
         });
         elements.push(markdownDiv(usageStatsStr + empty));
         // 后台任务：跨 turn 生命周期，必须显式告知并可逐个停止。
@@ -1317,7 +1306,17 @@ function headerTitle(state, options = {}) {
     if (state.terminal === 'goal_continuing')
         return `⏳ ${agent} · 本轮结束（目标继续）`;
     if (state.terminal === 'done') {
-        return state.goal?.phase === 'complete' ? `✅ ${agent} · 目标已完成` : `✅ ${agent} · 已完成`;
+        // goal 维度优先于「完成」：blocked/paused 不是任务做完了，complete 才是；
+        // 读不到（goalKnown=false）时也不能替宿主宣布完成。
+        if (state.goal?.phase === 'complete')
+            return `✅ ${agent} · 目标已完成`;
+        if (state.goal?.phase === 'blocked')
+            return `⛔ ${agent} · 目标被阻断`;
+        if (state.goal?.phase === 'paused')
+            return `⏸ ${agent} · 目标已暂停`;
+        if (state.goalKnown === false)
+            return `✅ ${agent} · 完成（目标未确认）`;
+        return `✅ ${agent} · 已完成`;
     }
     if (state.terminal === 'error')
         return `⚠️ ${agent} · 出错`;

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

@@ -1,4 +1,5 @@
 import type { AgentEvent, ApprovalView, ToolHint, GoalView } from '../runner/index.js';
+import type { UsageSnapshot } from '../session-contract.js';
 export type RunTerminal = 'running' | 'finalizing' | 'done' | 'error' | 'interrupted' | 'idle_timeout'
 /**
  * 本轮 turn 已结束，但会话的 goal 仍 active：宿主会自动开始下一轮，任务没有
@@ -17,6 +18,16 @@ declare const RUN_TERMINAL_STATES: readonly ["done", "error", "interrupted", "id
 export type RunFinalTerminal = (typeof RUN_TERMINAL_STATES)[number];
 /** 该状态是否已收尾（非 running/finalizing）。 */
 export declare function isRunTerminal(terminal: RunTerminal): terminal is RunFinalTerminal;
+/** 仍在推进的两个状态（`RunTerminal` 的非终态部分）。 */
+export type RunActiveTerminal = 'running' | 'finalizing';
+/**
+ * 该状态是否仍在推进（running 或 finalizing）。
+ *
+ * `finalizing` 是「result 已到、进程还在收尾」的非终态：卡片仍要处理事件、
+ * 仍要显示停止按钮。这个判据此前在 card/bridge 里逐字抄了四处，与
+ * `isRunTerminal` 互为反义却各写各的——收在这儿与终态判据并排。
+ */
+export declare function isRunActive(terminal: RunTerminal): terminal is RunActiveTerminal;
 export type RunFooter = 'thinking' | 'tool_running' | 'streaming' | null;
 /** 中断来源（interrupted 终态的原因），供卡片如实归因。 */
 export type InterruptedReason = 'approval_timeout' | 'user_stop' | 'approval_cancelled';
@@ -91,7 +102,12 @@ export interface FinalAnswerState {
     complete: boolean;
     source: 'protocol' | 'inferred';
 }
-export interface RunState {
+/**
+ * 一张 run 卡的状态。用量字段（context/tokens/cache/累计/推理）一律来自
+ * `UsageSnapshot` 单源——原先在这里、`FinishMeta`、`usage-format` 和桥侧各抄
+ * 一份（§9.21「五处一致」靠人记），加一个字段要改四遍。
+ */
+export interface RunState extends UsageSnapshot {
     runId: string;
     terminal: RunTerminal;
     footer: RunFooter;
@@ -109,30 +125,8 @@ export interface RunState {
     resultSubtype?: 'success' | 'error' | 'interrupted';
     /** interrupted 终态的中断来源；undefined = 未归类（渲染默认文案）。 */
     interruptedReason?: InterruptedReason;
-    contextLength?: number;
-    /** 当前模型 context window 上限（codex jsonl 提供）；卡片据此渲染百分比。 */
-    contextLimit?: number;
     errorMsg?: string;
     idleTimeoutMinutes?: number;
-    compactCount?: number;
-    cacheReadTokens?: number;
-    cacheCreationTokens?: number;
-    /** Agent-declared total; the done card uses max(total, sum of parts). */
-    totalTokens?: number;
-    /** Real input tokens from the agent's result event (codex/opencode).
-     *  When present, the done card shows the real value instead of the
-     *  contextLength-based estimate. */
-    inputTokens?: number;
-    /** Real output tokens from the agent's result event. */
-    outputTokens?: number;
-    /** 会话累计 total/input/output（所有 run 之和），Run 卡片展示"累计"。 */
-    cumulativeTotalTokens?: number;
-    cumulativeInputTokens?: number;
-    cumulativeOutputTokens?: number;
-    /** 会话累计 cache read token（所有 run 之和）。 */
-    cumulativeCacheReadTokens?: number;
-    /** 会话累计 cache creation token（所有 run 之和）。 */
-    cumulativeCacheCreationTokens?: number;
     plan?: string;
     /** 实际生效模型（system.init 携带；失败兜底 synthetic init 为 ''，渲染须容忍）。 */
     model?: string;
@@ -146,12 +140,8 @@ export interface RunState {
     sessionTitle?: string;
     /** 当前模式（ACP current_mode_update.currentModeId）。 */
     mode?: string;
-    /** 推理 token（pi usage.reasoning 累加，经 finish meta 写入）。 */
-    reasoningTokens?: number;
     /** Codex 操作类型：'turn' 表示普通 run，'compaction' 表示 compact 运行。 */
     operationKind?: 'turn' | 'compaction';
-    /** 压缩前上下文水位（codex compact 卡展示「压缩前 X → 压缩后 Y」）。 */
-    compactPreContextLength?: number;
     /**
      * 待审批请求列表（app-server 模式）。同一 turn 内并发多个审批
      * 时全部渲染，避免后到者顶掉先到者的按钮（单槽会丢 UI，只能等超时 cancel）。
@@ -200,35 +190,23 @@ export interface RunState {
      */
     goalKnown?: boolean;
 }
-export interface FinishMeta {
+/** 终态卡片的一次性元信息；用量部分与 `RunState` 同源（`UsageSnapshot`）。 */
+export interface FinishMeta extends UsageSnapshot {
     resultSubtype?: 'success' | 'error' | 'interrupted';
     /** 中断来源：由桥侧在 finish 时显式传入（/stop → user_stop、审批卡取消 → approval_cancelled）。 */
     interruptedReason?: InterruptedReason;
-    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. */
-    totalTokens?: number;
-    /** Real input/output tokens from the agent's result event. Threaded through
-     *  to RunState so the done card can display real values instead of estimates. */
-    inputTokens?: number;
-    outputTokens?: number;
-    /** 会话累计 total/input/output（所有 run 之和），从 session jsonl 读取。 */
-    cumulativeTotalTokens?: number;
-    cumulativeInputTokens?: number;
-    cumulativeOutputTokens?: number;
-    cumulativeCacheReadTokens?: number;
-    cumulativeCacheCreationTokens?: number;
-    /** 推理 token（pi usage.reasoning 累加，经 usageMeta 透传）。 */
-    reasoningTokens?: number;
 }
 export declare function createInitialRunState(runId: string): RunState;
 export declare function reduceRunState(state: RunState, event: AgentEvent): RunState;
-export declare function finishRun(state: RunState, terminal: Exclude<RunTerminal, 'running' | 'finalizing'>, meta?: FinishMeta): RunState;
+/**
+ * 用户停止某个后台任务成功后，从卡片状态里摘掉它。
+ *
+ * run 此时已经收尾（没有流再消费事件），所以这条不走 reducer 的事件入口；但
+ * RunState 的形状只允许在本模块内拼装——bridge 直接展开 state 曾把「摘一条」
+ * 写成「整体重建」，字段一多就会漏带。
+ */
+export declare function removeBackgroundJob(state: RunState, jobId: string): RunState;
+export declare function finishRun(state: RunState, terminal: RunFinalTerminal, meta?: FinishMeta): RunState;
 export {};

package/dist/card/run-state.js

@@ -22,6 +22,16 @@ const RUN_TERMINAL_STATES = [
 export function isRunTerminal(terminal) {
     return RUN_TERMINAL_STATES.includes(terminal);
 }
+/**
+ * 该状态是否仍在推进（running 或 finalizing）。
+ *
+ * `finalizing` 是「result 已到、进程还在收尾」的非终态：卡片仍要处理事件、
+ * 仍要显示停止按钮。这个判据此前在 card/bridge 里逐字抄了四处，与
+ * `isRunTerminal` 互为反义却各写各的——收在这儿与终态判据并排。
+ */
+export function isRunActive(terminal) {
+    return terminal === 'running' || terminal === 'finalizing';
+}
 export function createInitialRunState(runId) {
     return {
         runId,
@@ -411,6 +421,19 @@ function reduceBackgroundJobsEvent(state, event) {
         return state;
     return { ...state, backgroundJobs: event.jobs };
 }
+/**
+ * 用户停止某个后台任务成功后，从卡片状态里摘掉它。
+ *
+ * run 此时已经收尾（没有流再消费事件），所以这条不走 reducer 的事件入口；但
+ * RunState 的形状只允许在本模块内拼装——bridge 直接展开 state 曾把「摘一条」
+ * 写成「整体重建」，字段一多就会漏带。
+ */
+export function removeBackgroundJob(state, jobId) {
+    return {
+        ...state,
+        backgroundJobs: (state.backgroundJobs ?? []).filter((job) => job.id !== jobId),
+    };
+}
 /**
  * 运行期状态投影 → 状态行。
  *

package/dist/card/usage-format.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Format session/run usage stats (context, compact count, tokens, cost) into
+ * the display strings shown on cards. Pure — no Router state.
+ *
+ * 归属 card/：渲染层（run-renderer）与 router 都只消费它的展示字符串，此前
+ * 住在 router/ 让它成为 card→router 的唯一理由。
+ */
+import type { UsageSnapshot } from '../session-contract.js';
+/** `formatUsageStats` 只读这几项：会话/进度卡片上的紧凑用量行。 */
+export type SessionDisplayUsage = Pick<UsageSnapshot, 'contextLength' | 'contextLimit' | 'compactCount' | 'cacheReadTokens' | 'cacheCreationTokens'>;
+/**
+ * Format usage stats (context length, compact count, cache tokens) into a display string.
+ * Each stat on its own line with blank lines between sections.
+ * @param usage - Usage stats object
+ * @param options - Optional display options (showResult adds result line)
+ */
+export declare function formatUsageStats(usage?: UsageSnapshot & {
+    /** 实际生效模型（system.init 携带）。非空字符串才显示。 */
+    model?: string;
+    /** 本次 run 花费（USD）。存在才显示。 */
+    costUsd?: number;
+}, options?: {
+    showResult?: boolean;
+    result?: string;
+    /**
+     * 首行状态文案。默认 `✅ 已完成`；goal 仍 active 的收尾卡必须换掉它——
+     * 本轮 turn 结束不等于任务结束。
+     */
+    completedLabel?: string;
+}): string;

package/dist/{router → card}/usage-format.js

@@ -1,17 +1,10 @@
 /**
  * Format session/run usage stats (context, compact count, tokens, cost) into
  * the display strings shown on cards. Pure — no Router state.
+ *
+ * 归属 card/：渲染层（run-renderer）与 router 都只消费它的展示字符串，此前
+ * 住在 router/ 让它成为 card→router 的唯一理由。
  */
-export function activeRunUsage(activeRun) {
-    if (!activeRun || activeRun.contextLength === undefined)
-        return undefined;
-    return {
-        contextLength: activeRun.contextLength,
-        compactCount: activeRun.compactCount,
-        cacheReadTokens: activeRun.cacheReadTokens,
-        cacheCreationTokens: activeRun.cacheCreationTokens,
-    };
-}
 /**
  * Format number to human-readable unit string.
  * - >= 1M: one decimal, M suffix (e.g., 1200000 → 1.2M, 25000000 → 25M)

package/dist/clone.js

@@ -390,7 +390,12 @@ export class CloneSession {
             const raw = JSON.parse(fs.readFileSync(path.join(this.configDir, 'startup-contact.json'), 'utf-8'));
             return typeof raw.userId === 'string' && raw.userId ? raw.userId : undefined;
         }
-        catch {
+        catch (err) {
+            // ENOENT = 旧实例从未写过 startup-contact（正常）。其余（解析失败/权限）
+            // 留痕：否则下游会误归因成「旧 owner 无条目」。
+            if (err.code !== 'ENOENT') {
+                getLogger().debug(`[clone] cannot read startup-contact.json for previous owner: ${err?.message ?? String(err)}`);
+            }
             return undefined;
         }
     }

package/dist/config/index.d.ts

@@ -34,27 +34,23 @@ export declare const DEFAULT_APPROVAL_TIMEOUT_MS: number;
  */
 export declare const DEFAULT_INBOUND_MEDIA_DIR_NAME = ".lark-remote-temp";
 export declare const DEFAULT_INBOUND_MEDIA_MAX_SIZE_MB = 100;
-/** 模型 ID → alias 映射。 */
-export declare const MODEL_ID_TO_ALIAS: Record<string, string>;
-/** alias → model ID 反向映射。 */
-export declare const MODEL_ALIAS_TO_ID: Record<string, string>;
 declare const ClaudeConfigSchema: z.ZodObject<{
     model: z.ZodDefault<z.ZodString>;
     effort: z.ZodDefault<z.ZodEnum<{
-        medium: "medium";
         low: "low";
         high: "high";
-        xhigh: "xhigh";
         max: "max";
+        medium: "medium";
+        xhigh: "xhigh";
     }>>;
     permissionMode: z.ZodDefault<z.ZodEnum<{
         default: "default";
-        plan: "plan";
-        auto: "auto";
-        manual: "manual";
         acceptEdits: "acceptEdits";
+        auto: "auto";
         bypassPermissions: "bypassPermissions";
+        manual: "manual";
         dontAsk: "dontAsk";
+        plan: "plan";
     }>>;
     approvalTimeoutMs: z.ZodDefault<z.ZodNumber>;
     idleTtlMinutes: z.ZodDefault<z.ZodNumber>;
@@ -102,11 +98,11 @@ declare const PiConfigSchema: z.ZodObject<{
     provider: z.ZodDefault<z.ZodString>;
     model: z.ZodDefault<z.ZodString>;
     thinking: z.ZodDefault<z.ZodEnum<{
-        medium: "medium";
-        off: "off";
         low: "low";
         high: "high";
+        medium: "medium";
         xhigh: "xhigh";
+        off: "off";
         minimal: "minimal";
     }>>;
     tools: z.ZodDefault<z.ZodString>;
@@ -121,8 +117,8 @@ declare const KimiConfigSchema: z.ZodObject<{
     }>>;
     permissionMode: z.ZodDefault<z.ZodEnum<{
         auto: "auto";
-        yolo: "yolo";
         manual: "manual";
+        yolo: "yolo";
     }>>;
     acp: z.ZodOptional<z.ZodObject<{
         binary: z.ZodDefault<z.ZodString>;
@@ -156,20 +152,20 @@ export declare const AppConfigSchema: z.ZodObject<{
     claude: z.ZodDefault<z.ZodObject<{
         model: z.ZodDefault<z.ZodString>;
         effort: z.ZodDefault<z.ZodEnum<{
-            medium: "medium";
             low: "low";
             high: "high";
-            xhigh: "xhigh";
             max: "max";
+            medium: "medium";
+            xhigh: "xhigh";
         }>>;
         permissionMode: z.ZodDefault<z.ZodEnum<{
             default: "default";
-            plan: "plan";
-            auto: "auto";
-            manual: "manual";
             acceptEdits: "acceptEdits";
+            auto: "auto";
             bypassPermissions: "bypassPermissions";
+            manual: "manual";
             dontAsk: "dontAsk";
+            plan: "plan";
         }>>;
         approvalTimeoutMs: z.ZodDefault<z.ZodNumber>;
         idleTtlMinutes: z.ZodDefault<z.ZodNumber>;
@@ -215,11 +211,11 @@ export declare const AppConfigSchema: z.ZodObject<{
             provider: z.ZodDefault<z.ZodString>;
             model: z.ZodDefault<z.ZodString>;
             thinking: z.ZodDefault<z.ZodEnum<{
-                medium: "medium";
-                off: "off";
                 low: "low";
                 high: "high";
+                medium: "medium";
                 xhigh: "xhigh";
+                off: "off";
                 minimal: "minimal";
             }>>;
             tools: z.ZodDefault<z.ZodString>;
@@ -233,8 +229,8 @@ export declare const AppConfigSchema: z.ZodObject<{
             }>>;
             permissionMode: z.ZodDefault<z.ZodEnum<{
                 auto: "auto";
-                yolo: "yolo";
                 manual: "manual";
+                yolo: "yolo";
             }>>;
             acp: z.ZodOptional<z.ZodObject<{
                 binary: z.ZodDefault<z.ZodString>;