lark-remote 0.5.6 → 0.5.8

package/dist/card/time.d.ts

@@ -1 +1,15 @@
 export declare function formatTimestamp(ts: string | number | undefined): string;
+/**
+ * 时钟时间 `HH:mm`（同一张卡内的次要信息用）。
+ *
+ * 面板标题在手机上只有约 36 个显示宽度可用：`2026-10-19 21:23` 光时间戳就吃掉
+ * 一半，正文明明只需要知道"什么时候发生的"。完整的日期在会话历史/日志里。
+ */
+export declare function formatClock(ts: string | number | undefined): string;
+/**
+ * `MM-DD HH:mm`（面板标题里的历史事件时间）。
+ *
+ * 比 `HH:mm` 多带上日期（跨天/跨周的会话不会误导），比完整 `YYYY-MM-DD HH:mm`
+ * 省 7 个显示宽度——那 7 个单位在手机上正好是文件名能不能显示出来的差别。
+ */
+export declare function formatMonthDayClock(ts: string | number | undefined): string;

package/dist/card/time.js

@@ -11,4 +11,34 @@ export function formatTimestamp(ts) {
     const mi = String(d.getMinutes()).padStart(2, '0');
     return `${yyyy}-${mm}-${dd} ${hh}:${mi}`;
 }
+/**
+ * 时钟时间 `HH:mm`（同一张卡内的次要信息用）。
+ *
+ * 面板标题在手机上只有约 36 个显示宽度可用：`2026-10-19 21:23` 光时间戳就吃掉
+ * 一半，正文明明只需要知道"什么时候发生的"。完整的日期在会话历史/日志里。
+ */
+export function formatClock(ts) {
+    if (!ts)
+        return '';
+    const d = new Date(ts);
+    if (isNaN(d.getTime()))
+        return '';
+    return `${String(d.getHours()).padStart(2, '0')}:${String(d.getMinutes()).padStart(2, '0')}`;
+}
+/**
+ * `MM-DD HH:mm`（面板标题里的历史事件时间）。
+ *
+ * 比 `HH:mm` 多带上日期（跨天/跨周的会话不会误导），比完整 `YYYY-MM-DD HH:mm`
+ * 省 7 个显示宽度——那 7 个单位在手机上正好是文件名能不能显示出来的差别。
+ */
+export function formatMonthDayClock(ts) {
+    if (!ts)
+        return '';
+    const d = new Date(ts);
+    if (isNaN(d.getTime()))
+        return '';
+    const mm = String(d.getMonth() + 1).padStart(2, '0');
+    const dd = String(d.getDate()).padStart(2, '0');
+    return `${mm}-${dd} ${formatClock(d.getTime())}`;
+}
 //# sourceMappingURL=time.js.map

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

@@ -10,13 +10,24 @@
  * like `✅ **Bash** — pwd` so collapsed panels stay informative.
  */
 import type { ToolEntry } from './run-state.js';
+export { displayWidth, truncateMiddleToDisplayWidth, truncateToDisplayWidth, } from '../common/text-width.js';
+/**
+ * 面板标题的显示宽度上限（半角单位，CJK/emoji 记 2）。
+ *
+ * 手机（~390px 内容宽）上折叠面板的标题只有**一行**可用：减去图标与内边距约
+ * 320px，按 ~7.5px/半角算 ≈ 42 个半角宽度（iPhone SE 更窄，超出时按 `·`/空格
+ * 折行仍可读，但不能整段换行）。超过就折行，断点常常落在 URL 或命令
+ * 中间（2026-10-19 截图反馈）。完整参数在展开后的正文里，标题只负责"哪个工具、
+ * 动了什么"，并带上 `HH:mm` 时间戳（一起计入预算）。
+ */
+export declare const HEADER_DISPLAY_MAX = 42;
 /**
  * One-line header for a tool call:
  *   `⏳ **Bash** — pwd`
  *   `✅ **Read** — /repo/a.ts`
  *   `❌ **Grep** — pattern in path`
  */
-export declare function toolHeaderText(tool: ToolEntry): string;
+export declare function toolHeaderText(tool: ToolEntry, suffix?: string): string;
 /**
  * Structured body markdown for a tool call. Renders input fields by tool name
  * (Bash → command, Read/Edit/Write → file_path, etc.) and output in a code
@@ -25,4 +36,6 @@ export declare function toolHeaderText(tool: ToolEntry): string;
  * for unknown tools: `default` returns '' and unknown tools only surface their
  * args through the panel header's `summarizeInput` fallback.
  */
-export declare function toolBodyMd(tool: ToolEntry): string;
+export declare function toolBodyMd(tool: ToolEntry, opts?: {
+    outputMax?: number;
+}): string;

package/dist/card/tool-render.js

@@ -10,7 +10,20 @@
  * like `✅ **Bash** — pwd` so collapsed panels stay informative.
  */
 import { truncate } from '../common/truncate.js';
-const HEADER_SUMMARY_MAX = 80;
+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';
+/**
+ * 面板标题的显示宽度上限（半角单位，CJK/emoji 记 2）。
+ *
+ * 手机（~390px 内容宽）上折叠面板的标题只有**一行**可用：减去图标与内边距约
+ * 320px，按 ~7.5px/半角算 ≈ 42 个半角宽度（iPhone SE 更窄，超出时按 `·`/空格
+ * 折行仍可读，但不能整段换行）。超过就折行，断点常常落在 URL 或命令
+ * 中间（2026-10-19 截图反馈）。完整参数在展开后的正文里，标题只负责"哪个工具、
+ * 动了什么"，并带上 `HH:mm` 时间戳（一起计入预算）。
+ */
+export const HEADER_DISPLAY_MAX = 42;
 const BODY_FIELD_MAX = 600;
 const OUTPUT_MAX = 1200;
 /**
@@ -27,11 +40,11 @@ const BODY_TOTAL_MAX = 2500;
  *   `✅ **Read** — /repo/a.ts`
  *   `❌ **Grep** — pattern in path`
  */
-export function toolHeaderText(tool) {
+export function toolHeaderText(tool, suffix = '') {
     const icon = tool.status === 'ok' ? '✅' : tool.status === 'error' ? '❌' : '⏳';
     // use the cached parsed record when available (avoids per-render parse).
     const input = tool.parsedInput !== undefined ? tool.parsedInput : tool.input;
-    const summary = summarizeInput(tool.name, input);
+    const summary = summarizeToolInput(tool.name, input);
     // 信息保真 ACP kind 映射后 name 与原始 title 不同时，title 以
     // ` — {summary}` 追加在标题末尾（截断沿用 HEADER_SUMMARY_MAX）。
     // 用 truncate（suffix 为空）而非裸 slice：裸 slice 按 UTF-16 码元切，
@@ -44,9 +57,14 @@ export function toolHeaderText(tool) {
     // `✅ **Bash** — ls` instead of `✅ **Bash** — ls — ls`.
     const parts = [summary, blockSummary].filter(Boolean);
     const uniqueParts = parts.filter((part, i) => parts.indexOf(part) === i);
-    return uniqueParts.length > 0
+    const title = uniqueParts.length > 0
         ? `${icon} **${tool.name}** — ${uniqueParts.join(' — ')}`
         : `${icon} **${tool.name}**`;
+    // 折叠面板的标题必须能在一行内放下（手机窄屏）：超宽就按显示宽度截断，
+    // 完整值仍在展开后的正文里。`suffix`（时间戳）一起计入预算，否则"标题压到
+    // 60 宽 + 18 宽时间戳"在手机上照样折行。
+    // 中间省略：路径/URL 的结尾（文件名）比开头更有信息量。
+    return truncateMiddleToDisplayWidth(`${title}${suffix}`, HEADER_DISPLAY_MAX);
 }
 /**
  * Structured body markdown for a tool call. Renders input fields by tool name
@@ -56,13 +74,14 @@ export function toolHeaderText(tool) {
  * for unknown tools: `default` returns '' and unknown tools only surface their
  * args through the panel header's `summarizeInput` fallback.
  */
-export function toolBodyMd(tool) {
+export function toolBodyMd(tool, opts = {}) {
     const parts = [];
     const inputMd = renderInput(tool);
     if (inputMd)
         parts.push(inputMd);
     if (tool.output) {
-        const truncated = truncate(tool.output, OUTPUT_MAX);
+        const outputMax = Math.min(opts.outputMax ?? OUTPUT_MAX, OUTPUT_MAX);
+        const truncated = truncate(tool.output, outputMax);
         if (tool.status === 'error') {
             parts.push(`**Error**\n\`\`\`\n${truncated}\n\`\`\``);
         }
@@ -79,51 +98,6 @@ export function toolBodyMd(tool) {
     // 同上：走 truncate 保证切点不落在代理对中间（末尾 '…' 由 truncate 附加以对齐预算）。
     return `${truncate(body, BODY_TOTAL_MAX)}\n\n_（body 已截断，完整内容查日志）_`;
 }
-function summarizeInput(name, input) {
-    const rec = asRecord(input);
-    if (!rec)
-        return '';
-    const pick = (key, max = HEADER_SUMMARY_MAX) => {
-        const v = rec[key];
-        if (typeof v !== 'string')
-            return '';
-        const oneLine = v.replace(/\s+/g, ' ').trim();
-        return oneLine.length > max ? `${oneLine.slice(0, max)}…` : oneLine;
-    };
-    switch (name) {
-        case 'Bash':
-        case 'bash':
-            return pick('command');
-        case 'Read':
-        case 'Edit':
-        case 'Write':
-        case 'NotebookEdit':
-        case 'read':
-        case 'edit':
-        case 'write':
-            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 'find':
-            return pick('pattern');
-        case 'ls':
-            return pick('path');
-        case 'WebFetch':
-            return pick('url');
-        case 'WebSearch':
-            return pick('query', 60);
-        case 'Agent':
-        case 'Task':
-            return pick('description') || pick('subagent_type');
-        default:
-            return pick('command') || pick('file_path') || pick('path') || pick('query');
-    }
-}
 // --- Named render bodies (shared by tool-name cases and toolHint branches) ---
 function renderBashInput(str) {
     const cmd = str('command');
@@ -155,6 +129,15 @@ function renderWebFetchInput(str) {
 function renderWebSearchInput(str) {
     return str('query') ? `**Query** \`${truncate(str('query'), BODY_FIELD_MAX)}\`` : '';
 }
+/** DSH `web_search` 的批量查询参数（`queries: string[]`）。 */
+function renderWebQueriesInput(queries) {
+    if (!Array.isArray(queries))
+        return '';
+    const items = queries.filter((q) => typeof q === 'string' && q.trim().length > 0);
+    if (items.length === 0)
+        return '';
+    return `**Query** \`${truncate(items.join('` / `'), BODY_FIELD_MAX)}\``;
+}
 function renderInput(tool) {
     // use the cached parsed record when available (avoids per-render parse).
     const input = tool.parsedInput !== undefined ? tool.parsedInput : tool.input;
@@ -177,48 +160,25 @@ function renderInput(tool) {
         default:
             break;
     }
-    switch (tool.name) {
-        case 'Bash':
-        case 'bash':
+    switch (toolKindOf(tool.name)) {
+        case 'shell':
             return renderBashInput(str);
-        case 'Read':
-        case 'Edit':
-        case 'Write':
-        case 'NotebookEdit':
-        case 'read':
-        case 'edit':
-        case 'write':
+        case 'file':
             return renderFileInput(str);
-        case 'Grep':
         case 'grep':
             return renderGrepInput(str);
-        case 'Glob':
-        case 'find':
+        case 'glob':
             return renderGlobInput(str);
         case 'ls':
             return renderLsInput(str);
-        case 'WebFetch':
+        case 'webfetch':
             return renderWebFetchInput(str);
-        case 'WebSearch':
+        case 'websearch':
             return renderWebSearchInput(str);
+        case 'websearch_queries':
+            return renderWebQueriesInput(rec.queries) || renderWebSearchInput(str);
         default:
             return '';
     }
 }
-function asRecord(input) {
-    if (!input)
-        return null;
-    if (typeof input === 'object')
-        return input;
-    if (typeof input === 'string') {
-        try {
-            const p = JSON.parse(input);
-            return p && typeof p === 'object' ? p : null;
-        }
-        catch {
-            return null;
-        }
-    }
-    return null;
-}
 //# sourceMappingURL=tool-render.js.map

package/dist/common/text-width.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 文本的**显示宽度**工具（半角 1 / 全角与 emoji 2）。
+ *
+ * 为什么单列一个模块：卡片标题、状态行、resume 卡片标题都要按"手机上能放几行"
+ * 来收敛，而卡片层（`src/card/`）与会话读取层（`src/session/`）都要用——放在
+ * 任何一侧都会让另一侧反向依赖。
+ */
+/**
+ * 按**显示宽度**截断（半角 1 / 全角与 emoji 2）。
+ *
+ * markdown 的 `**` 与 emoji 都要按视觉宽度算：只按字符数截断时，一行 34 个
+ * CJK 就是 34 个字宽，手机上必然折行。
+ */
+export declare function truncateToDisplayWidth(text: string, maxUnits: number): string;
+/** 字符串的显示宽度（半角 1 / 全角与 emoji 2）。 */
+export declare function displayWidth(text: string): number;
+/**
+ * 中间省略截断：保留开头与结尾，只在中间打 `…`。
+ *
+ * 标题里的路径/URL 必须保留**结尾**才有信息量（`~/code/notes-app/.../notes/
+ * 2026-10-19-vision-remaining.md` 里真正有用的是文件名），尾部省略会把文件名
+ * 整个切掉；纯尾部截断只适合"开头即结论"的句子（命令）。
+ */
+export declare function truncateMiddleToDisplayWidth(text: string, maxUnits: number): string;

package/dist/common/text-width.js

@@ -0,0 +1,93 @@
+/**
+ * 文本的**显示宽度**工具（半角 1 / 全角与 emoji 2）。
+ *
+ * 为什么单列一个模块：卡片标题、状态行、resume 卡片标题都要按"手机上能放几行"
+ * 来收敛，而卡片层（`src/card/`）与会话读取层（`src/session/`）都要用——放在
+ * 任何一侧都会让另一侧反向依赖。
+ */
+/**
+ * 按**显示宽度**截断（半角 1 / 全角与 emoji 2）。
+ *
+ * markdown 的 `**` 与 emoji 都要按视觉宽度算：只按字符数截断时，一行 34 个
+ * CJK 就是 34 个字宽，手机上必然折行。
+ */
+export function truncateToDisplayWidth(text, maxUnits) {
+    if (displayWidth(text) <= maxUnits)
+        return text;
+    let used = 0;
+    let out = '';
+    for (const ch of text) {
+        const w = charWidth(ch);
+        // 预留 1 个单位给省略号
+        if (used + w > maxUnits - 1)
+            break;
+        out += ch;
+        used += w;
+    }
+    return `${out}…`;
+}
+/** 字符串的显示宽度（半角 1 / 全角与 emoji 2）。 */
+export function displayWidth(text) {
+    let total = 0;
+    for (const ch of text)
+        total += charWidth(ch);
+    return total;
+}
+function charWidth(ch) {
+    const code = ch.codePointAt(0) ?? 0;
+    // CJK 统一表意文字、假名、全角标点、常见 emoji 都按两个半角算。
+    if (code >= 0x1100 && (code <= 0x115f || code === 0x2329 || code === 0x232a))
+        return 2;
+    if (code >= 0x2e80 && code <= 0xa4cf)
+        return 2;
+    if (code >= 0xac00 && code <= 0xd7a3)
+        return 2;
+    if (code >= 0xf900 && code <= 0xfaff)
+        return 2;
+    if (code >= 0xfe30 && code <= 0xfe6f)
+        return 2;
+    if (code >= 0xff00 && code <= 0xff60)
+        return 2;
+    if (code >= 0xffe0 && code <= 0xffe6)
+        return 2;
+    if (code >= 0x1f300 && code <= 0x1faff)
+        return 2;
+    if (code >= 0x2600 && code <= 0x27bf)
+        return 2;
+    return 1;
+}
+/**
+ * 中间省略截断：保留开头与结尾，只在中间打 `…`。
+ *
+ * 标题里的路径/URL 必须保留**结尾**才有信息量（`~/code/notes-app/.../notes/
+ * 2026-10-19-vision-remaining.md` 里真正有用的是文件名），尾部省略会把文件名
+ * 整个切掉；纯尾部截断只适合"开头即结论"的句子（命令）。
+ */
+export function truncateMiddleToDisplayWidth(text, maxUnits) {
+    if (displayWidth(text) <= maxUnits)
+        return text;
+    const budget = Math.max(1, maxUnits - 1); // 给省略号留 1 个单位
+    const headBudget = Math.ceil(budget / 2);
+    const tailBudget = budget - headBudget;
+    let head = '';
+    let used = 0;
+    for (const ch of text) {
+        const w = charWidth(ch);
+        if (used + w > headBudget)
+            break;
+        head += ch;
+        used += w;
+    }
+    let tail = '';
+    used = 0;
+    const chars = [...text];
+    for (let i = chars.length - 1; i >= 0; i--) {
+        const w = charWidth(chars[i]);
+        if (used + w > tailBudget)
+            break;
+        tail = chars[i] + tail;
+        used += w;
+    }
+    return `${head}…${tail}`;
+}
+//# sourceMappingURL=text-width.js.map

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

@@ -0,0 +1,19 @@
+/**
+ * 工具调用参数 → 一行人话摘要（`bash — npm test`、`read — src/a.ts`）。
+ *
+ * 为什么要抽到 common：run 卡的面板标题（`src/card/tool-render.ts`）和
+ * resume 卡的「🔧 工具调用」标题（`src/session/<agent>/sessions.ts`）都要同一套口径；
+ * 各写一份必然漂移（同一个 `glob` 在一处显示 pattern、另一处显示目录）。
+ *
+ * 只做"取哪个字段"，不做 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

@@ -0,0 +1,171 @@
+/**
+ * 工具调用参数 → 一行人话摘要（`bash — npm test`、`read — src/a.ts`）。
+ *
+ * 为什么要抽到 common：run 卡的面板标题（`src/card/tool-render.ts`）和
+ * resume 卡的「🔧 工具调用」标题（`src/session/<agent>/sessions.ts`）都要同一套口径；
+ * 各写一份必然漂移（同一个 `glob` 在一处显示 pattern、另一处显示目录）。
+ *
+ * 只做"取哪个字段"，不做 agent 分支：工具名与参数名的对应表就是这张 switch。
+ */
+import { truncate } from './truncate.js';
+/** 工具标题/摘要共用的单行宽度上限。 */
+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;
+    if (typeof input === 'object')
+        return input;
+    if (typeof input === 'string') {
+        try {
+            const p = JSON.parse(input);
+            return p && typeof p === 'object' ? p : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+export function summarizeToolInput(name, input) {
+    const rec = asRecord(input);
+    if (!rec)
+        return '';
+    const pick = (key, max = HEADER_SUMMARY_MAX) => {
+        const v = rec[key];
+        if (typeof v !== 'string')
+            return '';
+        const oneLine = v.replace(/\s+/g, ' ').trim();
+        return oneLine.length > max ? `${oneLine.slice(0, max)}…` : oneLine;
+    };
+    /** First non-empty of several keys（DSH 同名工具跨版本改过参数名）。 */
+    const pickAny = (keys, max = HEADER_SUMMARY_MAX) => {
+        for (const key of keys) {
+            const v = pick(key, max);
+            if (v)
+                return v;
+        }
+        return '';
+    };
+    /** 数组参数的第一个字符串项（DSH web_search 的 queries、present 的 files）。 */
+    const pickFirst = (key, max = HEADER_SUMMARY_MAX) => {
+        const v = rec[key];
+        if (typeof v === 'string')
+            return pick(key, max);
+        if (!Array.isArray(v))
+            return '';
+        for (const item of v) {
+            if (typeof item === 'string' && item.trim()) {
+                const oneLine = item.replace(/\s+/g, ' ').trim();
+                return oneLine.length > max ? `${oneLine.slice(0, max)}…` : oneLine;
+            }
+            if (item && typeof item === 'object') {
+                const path = item.path;
+                if (typeof path === 'string' && path.trim())
+                    return path;
+            }
+        }
+        return '';
+    };
+    switch (toolKindOf(name)) {
+        case 'shell':
+            return pick('command');
+        case 'file':
+            return pick('file_path') || pick('path');
+        case 'grep': {
+            const pat = pick('pattern', 40);
+            const p = pick('path', 30);
+            return p ? `${pat} in ${p}` : pat;
+        }
+        case 'glob':
+            return pick('pattern');
+        case 'ls':
+            return pick('path');
+        case 'webfetch':
+            return pick('url');
+        case 'websearch':
+        case 'websearch_queries':
+            return pickFirst('queries', 60) || pick('query', 60);
+        default:
+            break;
+    }
+    switch (name) {
+        case 'Agent':
+        case 'Task':
+        case 'subagent':
+        case 'workflow':
+            return pick('description') || pick('subagent_type');
+        case 'todo_write':
+            return summarizeTodos(rec);
+        case 'job_output':
+        case 'job_kill':
+            return pick('job_id');
+        case 'job_list':
+            return '（列出任务）';
+        case 'present':
+            return pickFirst('files');
+        case 'skill':
+            return pick('name');
+        case 'run_code':
+            return pick('description') || pick('language');
+        case 'terminal_send':
+            return pick('text');
+        case 'ask_user_question': {
+            const questions = rec.questions;
+            return Array.isArray(questions) ? `${questions.length} 个问题` : '';
+        }
+        case 'send_message':
+        case 'interrupt_agent':
+            return pick('description') || pick('agent_id');
+        default:
+            return pickAny(['command', 'file_path', 'path', 'query', 'url']);
+    }
+}
+/** todo_write 摘要：完成进度 + 当前 in_progress 项主题。 */
+function summarizeTodos(rec) {
+    const todos = rec.todos;
+    if (!Array.isArray(todos))
+        return '';
+    let done = 0;
+    let active = '';
+    for (const item of todos) {
+        if (!item || typeof item !== 'object')
+            continue;
+        const todo = item;
+        if (todo.status === 'completed')
+            done += 1;
+        if (!active && todo.status === 'in_progress' && typeof todo.content === 'string') {
+            active = todo.content.replace(/\s+/g, ' ').trim();
+        }
+    }
+    const progress = `${done}/${todos.length}`;
+    if (!active)
+        return `已完成 ${progress}`;
+    return truncate(`已完成 ${progress} · ${active}`, HEADER_SUMMARY_MAX, { suffix: '…' });
+}
+//# sourceMappingURL=tool-summary.js.map

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

package/dist/config/index.d.ts

@@ -28,7 +28,7 @@ export declare const DEFAULT_TURN_IDLE_TIMEOUT_MINUTES: 30;
  * 单文件上限默认 100MB：50MB 对视频偏小（2026-09-15 事故就是 mp4 被丢弃）。
  * 注意飞书侧 `type=file` 超过 100MB 必须用 Range 分片下载，而 SDK 的
  * `downloadResourceToFile` 不分片（必报 234037），所以 100 是实际可用上限
- * （inbound-message-matrix.md §4.4）。
+ * （inbound-message-matrix.md §4 第 4 条）。
  */
 export declare const DEFAULT_INBOUND_MEDIA_DIR_NAME = ".lark-remote-temp";
 export declare const DEFAULT_INBOUND_MEDIA_MAX_SIZE_MB = 100;

package/dist/config/index.js

@@ -56,7 +56,7 @@ export const DEFAULT_TURN_IDLE_TIMEOUT_MINUTES = DEFAULTS.TURN_IDLE_TIMEOUT_MINU
  * 单文件上限默认 100MB：50MB 对视频偏小（2026-09-15 事故就是 mp4 被丢弃）。
  * 注意飞书侧 `type=file` 超过 100MB 必须用 Range 分片下载，而 SDK 的
  * `downloadResourceToFile` 不分片（必报 234037），所以 100 是实际可用上限
- * （inbound-message-matrix.md §4.4）。
+ * （inbound-message-matrix.md §4 第 4 条）。
  */
 export const DEFAULT_INBOUND_MEDIA_DIR_NAME = '.lark-remote-temp';
 export const DEFAULT_INBOUND_MEDIA_MAX_SIZE_MB = 100;

package/dist/connector/index.js

@@ -424,7 +424,7 @@ export class FeishuConnector {
                         kind: res.kind,
                         fileName: res.fileName,
                         // 飞书侧 >100MB 必须 Range 分片（SDK 不分片），到上限就是下不动：
-                        // 提示写清楚，避免用户以为"再放大上限就能存"（matrix §4.4/§2 #11）。
+                        // 提示写清楚，避免用户以为"再放大上限就能存"（inbound-message-matrix.md §4 第 4 条）。
                         reason: `超过 ${limitMb}MB 大小限制` +
                             (limitMb >= 100 ? '（飞书 >100MB 的文件需分片下载，暂不支持）' : ''),
                     });