lark-remote 0.5.7 → 0.5.9

package/dist/card/run-renderer.js

@@ -1,9 +1,12 @@
+import { 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';
-import { truncateUtf8, truncateMarkdownTables, CARD_BUDGET_BYTES } from './text-truncate.js';
+import { truncateMarkdownTables, CARD_BUDGET_BYTES } from './text-truncate.js';
+import { truncateUtf8 } from '../common/truncate.js';
 import { countCardElements, MAX_CARD_ELEMENTS } from './card-budget.js';
-import { truncate } from '../common/truncate.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 { renderApprovalArea } from './approval-render.js';
@@ -12,15 +15,6 @@ const TEXT_BYTES = 10_000;
 const DEGRADED_THINKING_KEEP = 2;
 const DEGRADED_TEXT_BYTES = 5_000;
 const DEGRADED_THINKING_BYTES = 1_000;
-/**
- * 带「详情」按钮的工具行数上限（从最新往回数）。
- *
- * 按钮行是节点大户：`column_set` + 2 个 `column` + 标题 div/text + button/text/
- * behaviors/value ≈ 10 个 JSON 节点；纯标题行只有 2 个。24 行全带按钮 ≈ 240 节点，
- * 直接撞飞书的元素总数上限（实测 203 通过 / 204 失败，见 card-budget.ts）。
- * 最近 8 行保留按钮（用户最可能展开的就是刚跑完的），更早的行退化成一行标题。
- */
-export const MAX_TOOL_ROWS_WITH_BUTTON = 8;
 const DEGRADED_TOOL_KEEP = 3; // Degraded: keep last 3 tool panels
 const EXTREME_TOOL_KEEP = 1; // Extreme: keep last 1 tool panel
 // --- Budget estimate (先估后建) ---
@@ -52,10 +46,75 @@ function shouldShowCompactButton(state, options) {
         return false;
     if (options.compactSupported === false)
         return false;
-    return (state.terminal === 'done' ||
-        state.terminal === 'error' ||
-        state.terminal === 'interrupted' ||
-        state.terminal === 'idle_timeout');
+    // 没有可反查的会话 = 点了必然失败：「/stop 落在 init 之前」的那类卡
+    // 上会留一个注定回「该任务已结束」的死按钮。本轮 sessionId 优先；没有时看
+    // bridge 在开跑前探到的 store 会话（`sessionFallbackAvailable`，缺省视为可用
+    // 以保持渲染层独立调用方的既有语义）。
+    if (!state.sessionId && options.sessionFallbackAvailable === false)
+        return false;
+    // goal 仍 active = 宿主会自动起下一轮，会话永远不 idle，压缩必被拒（DSH 的
+    // 手动压缩要求 agent 空闲）。给按钮就是给一个注定失败的点击：用户点
+    // compact 只会拿到"还有一轮在跑"。
+    if (state.goal?.phase === 'active')
+        return false;
+    return isRunTerminal(state.terminal);
+}
+/**
+ * goal 区块：目标是什么、跑到第几轮、当前什么状态。
+ *
+ * 为什么放在状态行下面（而不是摘要区）：手机上用户只会扫前两屏。goal 是解释
+ * "这轮为什么结束却没收尾/为什么不能压缩"的唯一线索，必须靠前。
+ *
+ * 窄屏约束：每行一个 div，段间用 ` · `，不做 auto+grow 并排。
+ */
+const GOAL_INLINE_WIDTH = 64;
+const GOAL_FULL_MAX_BYTES = 2_400;
+/** 目标阶段的短标签。 */
+function goalPhaseLabel(goal) {
+    if (goal.phase === 'active')
+        return '目标进行中';
+    if (goal.phase === 'paused')
+        return '目标已暂停';
+    if (goal.phase === 'blocked')
+        return '目标被阻断';
+    return '目标已完成';
+}
+/**
+ * Build the goal block (empty when the session has no goal).
+ *
+ * 状态来源是宿主的 `goal` 投影/`goal/change`，不是桥的推断：把"我这一轮结束
+ * 了"当任务结束，就是"卡片写完成、任务还在跑"那类缺陷的来源。
+ */
+function buildGoalSection(state) {
+    const goal = state.goal;
+    if (!goal)
+        return [];
+    const elements = [];
+    const round = `第 ${goal.roundsStarted}/${goal.maxGoalRounds} 轮`;
+    elements.push(markdownDiv(`🎯 **${goalPhaseLabel(goal)}** · ${round}`));
+    // 目标全文可能有换行/超长：行内压成单行并截断，全文进折叠面板。
+    const singleLine = goal.objective.replace(/\s+/gu, ' ').trim();
+    const inline = displayWidth(singleLine) <= GOAL_INLINE_WIDTH
+        ? singleLine
+        : truncateToDisplayWidth(singleLine, GOAL_INLINE_WIDTH);
+    elements.push(markdownDiv(`目标：${inline}`, 'notation'));
+    if (inline !== singleLine) {
+        elements.push(collapsibleMarkdownPanel({
+            title: '🎯 目标全文',
+            expanded: false,
+            border: 'grey',
+            content: truncateUtf8(goal.objective, GOAL_FULL_MAX_BYTES),
+            textSize: 'notation',
+        }));
+    }
+    if (goal.phase === 'blocked' && goal.blockedReason) {
+        elements.push(markdownDiv(`⛔ 阻断：${goal.blockedReason.code} — ${goal.blockedReason.message}`, 'notation'));
+    }
+    if (goal.phase === 'active' && state.terminal === 'goal_continuing') {
+        // 这句话就是整张卡的核心信息：本轮结束 ≠ 任务结束。
+        elements.push(markdownDiv(`_本轮已结束；DSH 会自动开始第 ${goal.roundsStarted + 1} 轮_`, 'notation'));
+    }
+    return elements;
 }
 /**
  * Wrap text block in a collapsible panel with timestamp in the header.
@@ -404,9 +463,22 @@ function assembleRunCard(state, options, elements) {
             template: headerTemplate(state),
             title: { content: headerTitle(state, options), tag: 'plain_text' },
         },
-        body: { elements },
+        // goal 区块紧随状态行（所有预算档位都以此为第一元素），让"目标是什么/
+        // 第几轮"出现在折叠面板之前；它只有 2–3 个元素，兜底档位也扛得住。
+        body: { elements: insertAfterStatusRow(elements, buildGoalSection(state)) },
     };
 }
+/**
+ * 把目标区块插到状态行之后。所有预算档位的 elements 都以 statusRow 开头；
+ * 空数组时原样返回，避免把 `undefined` 塞进飞书卡片数组。
+ */
+function insertAfterStatusRow(elements, extra) {
+    if (extra.length === 0)
+        return elements;
+    if (elements.length === 0)
+        return extra;
+    return [elements[0], ...extra, ...elements.slice(1)];
+}
 /**
  * Build a budget-fallback tier (degraded or extreme): keep the last N thinking
  * blocks and last N tools, truncate text/thinking per tier, then render in
@@ -525,6 +597,9 @@ function buildExtremeFallbackElements(state, options) {
  * 状态标签（运行中/已完成…）不再重复：header 已经写了（`🔧 dsh · 调用工具`
  * / `✅ dsh · 已完成`），终态 summary 还有一次。
  *
+ * 终态也保留状态行：耗时定格，DSH 的步数/上下文投影展示最后一次快照
+ * （2026-10-21 用户要求）。summary 的最终 usage 与状态行并存。
+ *
  * 导出供窄屏守卫测试断言分段宽度（与 `estimateCardBytes` 同一惯例）。
  */
 export function statusLine(state) {
@@ -536,10 +611,11 @@ export function statusLine(state) {
     const elapsed = elapsedLabel(state);
     if (elapsed)
         parts.push(`⏱ ${elapsed}`);
-    // 运行期投影只在 running/finalizing 展示：终态 summary 有权威统计，同一张卡
-    // 上出现两次只会互相矛盾。
+    // 运行期投影在终态也保留（2026-10-21 用户要求）：DSH 卡片完成时，耗时/步数/
+    // 上下文百分比是这一跑留下的最后快照，撤掉后用户只能从 summary 的累计口径
+    // 重新推算。summary 仍展示最终 usage，两者口径不同、并存不冲突。
     const live = state.liveStatus;
-    if (live && (state.terminal === 'running' || state.terminal === 'finalizing')) {
+    if (live) {
         if (live.steps !== undefined)
             parts.push(`🧰 ${live.steps} 步`);
         if (live.contextUsed !== undefined &&
@@ -909,7 +985,16 @@ function buildSummaryContent(state, options = {}) {
         return elements;
     }
     if (state.terminal === 'error') {
-        elements.push(markdownDiv(`⚠️ **运行出错**\n\n${state.errorMsg ?? '未知错误'}`));
+        // 服务方内容审核截断（多为误报）不是「程序出错」：照抄英文内部报文会让
+        // 用户以为代码或配置坏了。文案说清三件事——谁拦的、改动还在、下一步。
+        if (isContentFilterFailure(state.errorMsg)) {
+            elements.push(markdownDiv('⚠️ **服务方内容审核拦截**\n\n' +
+                '模型输出被上游安全策略截断（`content_filter`），多数是误报，不是代码或配置问题。\n' +
+                '本回合已中止；已写入磁盘的改动都还在。重试仍被拦截时，可换模型或稍后再试。'));
+        }
+        else {
+            elements.push(markdownDiv(`⚠️ **运行出错**\n\n${state.errorMsg ?? '未知错误'}`));
+        }
     }
     else if (state.terminal === 'interrupted') {
         // 审批超时（approval_expired 已标记）是「无人响应被自动取消」，不是用户
@@ -958,7 +1043,14 @@ function buildSummaryContent(state, options = {}) {
             model: state.model,
             costUsd: state.costUsd,
             reasoningTokens: state.reasoningTokens,
-        }, { showResult: true, result });
+        }, {
+            showResult: true,
+            result,
+            // 本轮结束但目标继续：不能报"已完成"，也不能说"出错"。
+            ...(state.terminal === 'goal_continuing'
+                ? { completedLabel: '⏳ 本轮结束 · 目标仍在继续' }
+                : {}),
+        });
         elements.push(markdownDiv(usageStatsStr + empty));
         // 后台任务：跨 turn 生命周期，必须显式告知并可逐个停止。
         elements.push(...buildBackgroundJobsSection(state));
@@ -968,7 +1060,55 @@ function buildSummaryContent(state, options = {}) {
 /** 终态卡最多列几个后台任务（多出来的只报数）。 */
 const MAX_BACKGROUND_JOB_LINES = 3;
 /**
- * 后台任务小节：一行标题 + 每个任务一行（标签 + 停止按钮）。
+ * 命令在手机上可直接内联的显示宽度上限（半角单位，CJK/emoji 记 2）。
+ *
+ * 手机内容区约 320–360px，36 个半角单位约一行；再长会折成"每个词一行"。
+ * 超过这个宽度改用代码块整段展示（完整、可读），而不是截断。
+ */
+const BACKGROUND_JOB_INLINE_MAX = 36;
+/**
+ * 代码块再长到这个程度才折叠：约 180 个半角宽度或 6 行。
+ *
+ * 低于阈值直接展示完整命令（用户一眼能看到，不用点）；只有确实很长的
+ * 脚本/链式命令才收进折叠面板，避免一张卡被一条命令占满。
+ */
+const BACKGROUND_JOB_FOLD_DISPLAY_MAX = 180;
+const BACKGROUND_JOB_FOLD_LINES = 6;
+/**
+ * 任务状态标签：目前 DSH 只会给 running/stopping，其他值按运行中处理。
+ */
+function backgroundJobStatusLabel(status) {
+    return status === 'stopping' ? '停止中' : '运行中';
+}
+/**
+ * 生成能包住任意反引号串的代码围栏。命令里的 shell 反引号不能替换成 `'`
+ * （那是改内容），只能选比内容里最长反引号串更长的围栏。
+ */
+function codeFenceFor(content) {
+    let longest = 0;
+    let run = 0;
+    for (const ch of content) {
+        if (ch === '`') {
+            run += 1;
+            longest = Math.max(longest, run);
+        }
+        else {
+            run = 0;
+        }
+    }
+    return '`'.repeat(Math.max(3, longest + 1));
+}
+/**
+ * 后台任务小节：命令独占一行，停止按钮单独一行。
+ *
+ * 布局约束（2026-10-21 手机端反馈）：
+ * - 命令 + 按钮不再并排（grow + auto）：窄屏下 auto 列会被挤成「🟥…」，
+ *   命令也被截断。按钮现在独占一个单列 column_set，宽度由按钮自身决定。
+ * - 命令不 truncate：短命令/单行直接内联；中等长度的多行命令用代码块
+ *   整段展示；只有超长命令（> 180 显示宽度或 > 6 行）才进折叠面板。
+ *   面板折叠只影响视觉，JSON 里始终带全文。
+ * - 含反引号的命令不走行内代码（无法安全包含反引号），改走代码块；
+ *   围栏长度按内容自动加长，命令原文不改写。
  *
  * 按钮 payload 只带 runId/jobId：sessionId 与 cwd 由 bridge 的快照解析，卡片
  * 上少放一个可变字段就少一处不一致。
@@ -978,20 +1118,38 @@ function buildBackgroundJobsSection(state) {
     if (jobs.length === 0)
         return [];
     const elements = [
-        markdownDiv(`🧵 **后台任务** ${jobs.length} 个仍在运行（本轮结束后继续）`),
+        markdownDiv(`🧵 **后台任务** ${jobs.length} 个仍在运行`),
+        markdownDiv('_本轮结束后继续，可逐个停止_', 'notation'),
     ];
-    for (const job of jobs.slice(0, MAX_BACKGROUND_JOB_LINES)) {
-        // label 是任务自报的一行描述，可能含反引号/regex 反斜杠：按 markdown 安全
-        // 形态收敛（markdownDiv 只转义反斜杠，反引号会截断行内代码）。
-        const label = truncate(job.label.replace(/[\r\n]+/g, ' ').replace(/`/g, "'"), 60);
+    jobs.slice(0, MAX_BACKGROUND_JOB_LINES).forEach((job, index) => {
+        const label = job.label.trim();
+        const lineCount = label === '' ? 0 : label.split(/\r?\n/).length;
+        const inline = label.length > 0 &&
+            lineCount === 1 &&
+            !label.includes('`') &&
+            displayWidth(label) <= BACKGROUND_JOB_INLINE_MAX;
+        if (inline) {
+            elements.push(markdownDiv(`· \`${label}\``));
+        }
+        else {
+            // 多行/超宽/含反引号：代码块保留完整命令；只有超长才折叠。
+            const fence = codeFenceFor(label);
+            const content = `${fence}\n${label}\n${fence}`;
+            const fold = lineCount > BACKGROUND_JOB_FOLD_LINES ||
+                displayWidth(label) > BACKGROUND_JOB_FOLD_DISPLAY_MAX;
+            elements.push(fold
+                ? collapsibleMarkdownPanel({
+                    title: `🧵 任务 ${index + 1} · ${backgroundJobStatusLabel(job.status)} · 点击展开完整命令`,
+                    expanded: false,
+                    border: 'grey',
+                    content,
+                    textSize: 'notation',
+                })
+                : markdownDiv(content));
+        }
         elements.push({
             tag: 'column_set',
             columns: [
-                {
-                    tag: 'column',
-                    width: 'grow',
-                    elements: [markdownDiv(`· \`${label}\``, 'notation')],
-                },
                 {
                     tag: 'column',
                     width: 'auto',
@@ -1001,7 +1159,7 @@ function buildBackgroundJobsSection(state) {
                 },
             ],
         });
-    }
+    });
     if (jobs.length > MAX_BACKGROUND_JOB_LINES) {
         elements.push(markdownDiv(`_…另有 ${jobs.length - MAX_BACKGROUND_JOB_LINES} 个任务_`));
     }
@@ -1014,8 +1172,13 @@ function statusTagLabel(terminal) {
 /** CardKit 2.0 header title — agent-aware via options.agentKind. */
 function headerTitle(state, options = {}) {
     const agent = agentDisplayName(options.agentKind ?? 'claude');
-    if (state.terminal === 'done')
-        return `✅ ${agent} · 已完成`;
+    // 本轮 turn 结束但 goal 仍 active：这是"一轮结束"，不是"任务完成"。标题
+    // 必须说清楚，否则用户会以为活儿干完了。
+    if (state.terminal === 'goal_continuing')
+        return `⏳ ${agent} · 本轮结束（目标继续）`;
+    if (state.terminal === 'done') {
+        return state.goal?.phase === 'complete' ? `✅ ${agent} · 目标已完成` : `✅ ${agent} · 已完成`;
+    }
     if (state.terminal === 'error')
         return `⚠️ ${agent} · 出错`;
     if (state.terminal === 'interrupted')

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

@@ -1,5 +1,22 @@
-import type { AgentEvent, ApprovalView, ToolHint } from '../runner/index.js';
-export type RunTerminal = 'running' | 'finalizing' | 'done' | 'error' | 'interrupted' | 'idle_timeout';
+import type { AgentEvent, ApprovalView, ToolHint, GoalView } from '../runner/index.js';
+export type RunTerminal = 'running' | 'finalizing' | 'done' | 'error' | 'interrupted' | 'idle_timeout'
+/**
+ * 本轮 turn 已结束，但会话的 goal 仍 active：宿主会自动开始下一轮，任务没有
+ * 完成，卡片不得写"完成"。与 done 的差别只在语义与渲染，
+ * 卡片同样停止更新。
+ */
+ | 'goal_continuing';
+/**
+ * 已收尾的 run 终态集合（卡片不再更新）。
+ *
+ * 单一来源：事件消费守卫、可压缩记账白名单、Compact 按钮可见性三处共用，
+ * 禁止各自再抄一份字面量——三处漂移过一次（goal_continuing 只进白名单不进
+ * 按钮判据），新增终态时必漏一处的风险是结构性的。
+ */
+export declare const RUN_TERMINAL_STATES: readonly ["done", "error", "interrupted", "idle_timeout", "goal_continuing"];
+export type RunFinalTerminal = (typeof RUN_TERMINAL_STATES)[number];
+/** 该状态是否已收尾（非 running/finalizing）。 */
+export declare function isRunTerminal(terminal: RunTerminal): terminal is RunFinalTerminal;
 export type RunFooter = 'thinking' | 'tool_running' | 'streaming' | null;
 /** 中断来源（interrupted 终态的原因），供卡片如实归因。 */
 export type InterruptedReason = 'approval_timeout' | 'user_stop' | 'approval_cancelled';
@@ -161,6 +178,16 @@ export interface RunState {
         status?: string;
         progress?: string;
     }>;
+    /**
+     * 会话级长期目标（DSH goal）。跨 turn 生命周期：goal 仍 active 时，本轮结束
+     * 只是"一轮结束"，宿主会自动续跑，卡片必须显示目标是什么、跑到第几轮。
+     */
+    goal?: GoalView;
+    /**
+     * goal 是否被成功观测过。`false` = 探测失败，渲染层不得据此断言"没有目标/
+     * 已完成"（把读不到当成没有，就退回了"任务在跑、卡片写完成"的旧缺陷）。
+     */
+    goalKnown?: boolean;
 }
 export interface FinishMeta {
     resultSubtype?: 'success' | 'error' | 'interrupted';

package/dist/card/run-state.js

@@ -3,6 +3,24 @@ const MAX_REASONING_CHARS = 4_000;
 const MAX_TEXT_CHARS = 12_000;
 const MAX_TOOL_DETAIL_CHARS = 3_000;
 const MAX_BLOCKS = 24;
+/**
+ * 已收尾的 run 终态集合（卡片不再更新）。
+ *
+ * 单一来源：事件消费守卫、可压缩记账白名单、Compact 按钮可见性三处共用，
+ * 禁止各自再抄一份字面量——三处漂移过一次（goal_continuing 只进白名单不进
+ * 按钮判据），新增终态时必漏一处的风险是结构性的。
+ */
+export const RUN_TERMINAL_STATES = [
+    'done',
+    'error',
+    'interrupted',
+    'idle_timeout',
+    'goal_continuing',
+];
+/** 该状态是否已收尾（非 running/finalizing）。 */
+export function isRunTerminal(terminal) {
+    return RUN_TERMINAL_STATES.includes(terminal);
+}
 export function createInitialRunState(runId) {
     return {
         runId,
@@ -17,16 +35,17 @@ export function reduceRunState(state, event) {
     // 只有终态才阻止事件处理。finalizing 是非终态，
     // 仍需累积 assistant 内容（thinking、text、tool_use、后台任务输出）。
     const terminal = state.terminal;
-    if (terminal === 'done' ||
-        terminal === 'error' ||
-        terminal === 'interrupted' ||
-        terminal === 'idle_timeout') {
+    if (isRunTerminal(terminal)) {
         return state;
     }
     if (event.type === 'system')
         return reduceSystemEvent(state, event);
     if (event.type === 'run_status')
         return reduceRunStatusEvent(state, event);
+    if (event.type === 'goal_state') {
+        // 覆盖写：每次观测都是宿主的整份快照（phase/轮次/目标全文），不做增量。
+        return { ...state, goal: event.goal ?? undefined, goalKnown: event.known };
+    }
     if (event.type === 'background_jobs')
         return reduceBackgroundJobsEvent(state, event);
     if (event.type === 'result')

package/dist/card/text-truncate.d.ts

@@ -2,17 +2,15 @@
  * UTF-8 byte-safe text truncation primitives.
  *
  * The core `fitUtf8` / `truncateUtf8` / `DEFAULT_TRUNCATE_SUFFIX` primitives
- * live in `src/common/truncate.ts` (shared with session readers to avoid a
- * card→session layer inversion); this module re-exports them and adds the
- * card-specific markdown-table helpers.
+ * live in `src/common/truncate.ts`; this module only adds the card-specific
+ * markdown-table helpers. Card callers import the truncation primitives
+ * directly from common (no re-export shim).
  *
  * Why byte-safe: Feishu card size limits are measured in UTF-8 bytes, and a
  * naive `str.slice(0, n)` can split a multi-byte CJK/emoji codepoint, yielding
  * invalid UTF-8. `fitUtf8` iterates by Unicode codepoint (via `Array.from` /
  * `for...of`) so it never breaks a surrogate pair or a multi-byte sequence.
  */
-import { DEFAULT_TRUNCATE_SUFFIX, truncateUtf8 } from '../common/truncate.js';
-export { DEFAULT_TRUNCATE_SUFFIX, truncateUtf8 };
 /** Feishu 11310 limit: max markdown tables per card. */
 export declare const FEISHU_MAX_TABLES = 5;
 /**

package/dist/card/text-truncate.js

@@ -2,17 +2,15 @@
  * UTF-8 byte-safe text truncation primitives.
  *
  * The core `fitUtf8` / `truncateUtf8` / `DEFAULT_TRUNCATE_SUFFIX` primitives
- * live in `src/common/truncate.ts` (shared with session readers to avoid a
- * card→session layer inversion); this module re-exports them and adds the
- * card-specific markdown-table helpers.
+ * live in `src/common/truncate.ts`; this module only adds the card-specific
+ * markdown-table helpers. Card callers import the truncation primitives
+ * directly from common (no re-export shim).
  *
  * Why byte-safe: Feishu card size limits are measured in UTF-8 bytes, and a
  * naive `str.slice(0, n)` can split a multi-byte CJK/emoji codepoint, yielding
  * invalid UTF-8. `fitUtf8` iterates by Unicode codepoint (via `Array.from` /
  * `for...of`) so it never breaks a surrogate pair or a multi-byte sequence.
  */
-import { DEFAULT_TRUNCATE_SUFFIX, truncateUtf8 } from '../common/truncate.js';
-export { DEFAULT_TRUNCATE_SUFFIX, truncateUtf8 };
 /** Feishu 11310 limit: max markdown tables per card. */
 export const FEISHU_MAX_TABLES = 5;
 /**

package/dist/card/tool-render.js

@@ -10,11 +10,10 @@
  * like `✅ **Bash** — pwd` so collapsed panels stay informative.
  */
 import { truncate } from '../common/truncate.js';
-import { asRecord, summarizeToolInput } from '../common/tool-summary.js';
+import { asRecord, HEADER_SUMMARY_MAX, summarizeToolInput, toolKindOf, } from '../common/tool-summary.js';
 import { truncateMiddleToDisplayWidth } from '../common/text-width.js';
 // 这两个宽度工具原本住在这里；resume 卡片也要用，已下沉到 common。
 export { displayWidth, truncateMiddleToDisplayWidth, truncateToDisplayWidth, } from '../common/text-width.js';
-const HEADER_SUMMARY_MAX = 80;
 /**
  * 面板标题的显示宽度上限（半角单位，CJK/emoji 记 2）。
  *
@@ -161,35 +160,22 @@ function renderInput(tool) {
         default:
             break;
     }
-    switch (tool.name) {
-        case 'Bash':
-        case 'bash':
-        case 'pwsh':
+    switch (toolKindOf(tool.name)) {
+        case 'shell':
             return renderBashInput(str);
-        case 'Read':
-        case 'Edit':
-        case 'Write':
-        case 'NotebookEdit':
-        case 'read':
-        case 'edit':
-        case 'write':
-        case 'read_image':
+        case 'file':
             return renderFileInput(str);
-        case 'Grep':
         case 'grep':
             return renderGrepInput(str);
-        case 'Glob':
         case 'glob':
-        case 'find':
             return renderGlobInput(str);
         case 'ls':
             return renderLsInput(str);
-        case 'WebFetch':
-        case 'web_fetch':
+        case 'webfetch':
             return renderWebFetchInput(str);
-        case 'WebSearch':
+        case 'websearch':
             return renderWebSearchInput(str);
-        case 'web_search':
+        case 'websearch_queries':
             return renderWebQueriesInput(rec.queries) || renderWebSearchInput(str);
         default:
             return '';

package/dist/common/tool-summary.d.ts

@@ -7,5 +7,13 @@
  *
  * 只做"取哪个字段"，不做 agent 分支：工具名与参数名的对应表就是这张 switch。
  */
+/** 工具标题/摘要共用的单行宽度上限。 */
+export declare const HEADER_SUMMARY_MAX = 80;
+/**
+ * 工具别名 → 渲染类别。run 卡面板（`card/tool-render.ts`）与摘要
+ * （本文件）共用这一张表，新增别名只改这里，避免两处 switch 漂移。
+ */
+export type ToolKind = 'shell' | 'file' | 'grep' | 'glob' | 'ls' | 'webfetch' | 'websearch' | 'websearch_queries';
+export declare function toolKindOf(name: string): ToolKind | undefined;
 export declare function asRecord(input: unknown): Record<string, unknown> | null;
 export declare function summarizeToolInput(name: string, input: unknown): string;

package/dist/common/tool-summary.js

@@ -8,7 +8,34 @@
  * 只做"取哪个字段"，不做 agent 分支：工具名与参数名的对应表就是这张 switch。
  */
 import { truncate } from './truncate.js';
-const HEADER_SUMMARY_MAX = 80;
+/** 工具标题/摘要共用的单行宽度上限。 */
+export const HEADER_SUMMARY_MAX = 80;
+const TOOL_KIND_BY_NAME = {
+    Bash: 'shell',
+    bash: 'shell',
+    pwsh: 'shell',
+    Read: 'file',
+    Edit: 'file',
+    Write: 'file',
+    NotebookEdit: 'file',
+    read: 'file',
+    edit: 'file',
+    write: 'file',
+    read_image: 'file',
+    Grep: 'grep',
+    grep: 'grep',
+    Glob: 'glob',
+    glob: 'glob',
+    find: 'glob',
+    ls: 'ls',
+    WebFetch: 'webfetch',
+    web_fetch: 'webfetch',
+    WebSearch: 'websearch',
+    web_search: 'websearch_queries',
+};
+export function toolKindOf(name) {
+    return TOOL_KIND_BY_NAME[name];
+}
 export function asRecord(input) {
     if (!input)
         return null;
@@ -65,38 +92,29 @@ export function summarizeToolInput(name, input) {
         }
         return '';
     };
-    switch (name) {
-        case 'Bash':
-        case 'bash':
-        case 'pwsh':
+    switch (toolKindOf(name)) {
+        case 'shell':
             return pick('command');
-        case 'Read':
-        case 'Edit':
-        case 'Write':
-        case 'NotebookEdit':
-        case 'read':
-        case 'edit':
-        case 'write':
-        case 'read_image':
+        case 'file':
             return pick('file_path') || pick('path');
-        case 'Grep':
         case 'grep': {
             const pat = pick('pattern', 40);
             const p = pick('path', 30);
             return p ? `${pat} in ${p}` : pat;
         }
-        case 'Glob':
         case 'glob':
-        case 'find':
             return pick('pattern');
         case 'ls':
             return pick('path');
-        case 'WebFetch':
-        case 'web_fetch':
+        case 'webfetch':
             return pick('url');
-        case 'WebSearch':
-        case 'web_search':
+        case 'websearch':
+        case 'websearch_queries':
             return pickFirst('queries', 60) || pick('query', 60);
+        default:
+            break;
+    }
+    switch (name) {
         case 'Agent':
         case 'Task':
         case 'subagent':

package/dist/common/turn-failure.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Agent turn 失败原因的判据（卡片渲染与自动续跑共用）。
+ *
+ * 上游把 `finish_reason: content_filter` 归一到普通 error（DSH 侧 code 为
+ * `PI_AI_ERROR`）：它既不是限流也不是故障，而是模型输出被服务方安全策略截断，
+ * 多数是误报。桥接若把它混进「运行出错」，用户看到的是英文内部报文、不知道
+ * 该做什么；桥侧也就无从判断该不该自动续跑。
+ *
+ * 判据只留一处：渲染层（换文案）与桥接层（自动续跑一次）必须同一个口径，
+ * 否则改文案和改重试语义会各自漂移。
+ */
+/** 该 errorMsg 是否表示「模型输出被上游内容审核截断」。 */
+export declare function isContentFilterFailure(errorMsg: string | undefined): boolean;

package/dist/common/turn-failure.js

@@ -0,0 +1,18 @@
+/**
+ * Agent turn 失败原因的判据（卡片渲染与自动续跑共用）。
+ *
+ * 上游把 `finish_reason: content_filter` 归一到普通 error（DSH 侧 code 为
+ * `PI_AI_ERROR`）：它既不是限流也不是故障，而是模型输出被服务方安全策略截断，
+ * 多数是误报。桥接若把它混进「运行出错」，用户看到的是英文内部报文、不知道
+ * 该做什么；桥侧也就无从判断该不该自动续跑。
+ *
+ * 判据只留一处：渲染层（换文案）与桥接层（自动续跑一次）必须同一个口径，
+ * 否则改文案和改重试语义会各自漂移。
+ */
+/** 服务方内容审核截断的报文特征：`Provider finish_reason: content_filter`。 */
+const CONTENT_FILTER_RE = /finish_reason:\s*["']?content_filter\b/i;
+/** 该 errorMsg 是否表示「模型输出被上游内容审核截断」。 */
+export function isContentFilterFailure(errorMsg) {
+    return typeof errorMsg === 'string' && CONTENT_FILTER_RE.test(errorMsg);
+}
+//# sourceMappingURL=turn-failure.js.map