lark-remote 0.5.5 → 0.5.7

package/dist/card/run-state.js

@@ -8,6 +8,8 @@ export function createInitialRunState(runId) {
         runId,
         terminal: 'running',
         footer: 'thinking',
+        // 状态行的耗时口径：从 run 状态建立那一刻算起（卡片首帧即开始计时）。
+        startedAt: Date.now(),
         blocks: [],
     };
 }
@@ -23,6 +25,10 @@ export function reduceRunState(state, event) {
     }
     if (event.type === 'system')
         return reduceSystemEvent(state, event);
+    if (event.type === 'run_status')
+        return reduceRunStatusEvent(state, event);
+    if (event.type === 'background_jobs')
+        return reduceBackgroundJobsEvent(state, event);
     if (event.type === 'result')
         return reduceResultEvent(state, event);
     if (event.type === 'assistant')
@@ -320,6 +326,42 @@ function reduceResultEvent(state, event) {
             : {}),
     };
 }
+/**
+ * 后台任务名单 → RunState.backgroundJobs。
+ *
+ * 整份替换而非合并：事件本身就是"收尾那一刻仍在跑的完整名单"，合并会把上一
+ * 轮已结束的任务留下来。用户点「停止」成功后由 bridge 直接从 state 里摘掉，
+ * 不再走事件（那时已经没有 run 在消费流了）。
+ */
+function reduceBackgroundJobsEvent(state, event) {
+    if (event.type !== 'background_jobs')
+        return state;
+    return { ...state, backgroundJobs: event.jobs };
+}
+/**
+ * 运行期状态投影 → 状态行。
+ *
+ * 每帧只带一个投影 key，所以只合并"有值"的字段：用 undefined 覆盖会把另一
+ * 维度（上一步算出的上下文水位）擦掉。
+ */
+function reduceRunStatusEvent(state, event) {
+    if (event.type !== 'run_status')
+        return state;
+    const prev = state.liveStatus ?? {};
+    const live = {
+        ...prev,
+        ...(event.contextUsed === undefined ? {} : { contextUsed: event.contextUsed }),
+        ...(event.contextLimit === undefined ? {} : { contextLimit: event.contextLimit }),
+        ...(event.steps === undefined ? {} : { steps: event.steps }),
+        ...(event.toolMs === undefined ? {} : { toolMs: event.toolMs }),
+    };
+    // 窗口上限同时写进 state：终态 summary 的百分比与状态条同源，即使
+    // result.usage 没带上限（DSH 的会话读取端不产出）也算得出来。
+    const next = { ...state, liveStatus: live };
+    if (live.contextLimit !== undefined)
+        next.contextLimit = live.contextLimit;
+    return next;
+}
 /** Handle assistant thinking/text/tool_use content blocks. */
 function reduceAssistantEvent(state, event) {
     if (event.type !== 'assistant')
@@ -577,6 +619,9 @@ export function finishRun(state, terminal, meta = {}) {
         ...state,
         terminal,
         footer: null,
+        // 耗时定格：终态之后再渲染（补 token 统计、点「详情」重渲染）都沿用同一
+        // 结束时刻，否则每次 patch 的数字都会变大。
+        finishedAt: state.finishedAt ?? Date.now(),
         blocks: markThinkingInactive(state.blocks),
         ...sanitizeMeta(meta),
         ...(derivedReason !== undefined ? { interruptedReason: derivedReason } : {}),

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,21 @@
  * like `✅ **Bash** — pwd` so collapsed panels stay informative.
  */
 import { truncate } from '../common/truncate.js';
+import { asRecord, summarizeToolInput } 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）。
+ *
+ * 手机（~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 +41,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 +58,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 +75,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 +99,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 +130,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;
@@ -180,6 +164,7 @@ function renderInput(tool) {
     switch (tool.name) {
         case 'Bash':
         case 'bash':
+        case 'pwsh':
             return renderBashInput(str);
         case 'Read':
         case 'Edit':
@@ -188,37 +173,26 @@ function renderInput(tool) {
         case 'read':
         case 'edit':
         case 'write':
+        case 'read_image':
             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':
             return renderWebFetchInput(str);
         case 'WebSearch':
             return renderWebSearchInput(str);
+        case 'web_search':
+            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,11 @@
+/**
+ * 工具调用参数 → 一行人话摘要（`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 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,153 @@
+/**
+ * 工具调用参数 → 一行人话摘要（`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';
+const HEADER_SUMMARY_MAX = 80;
+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 (name) {
+        case 'Bash':
+        case 'bash':
+        case 'pwsh':
+            return pick('command');
+        case 'Read':
+        case 'Edit':
+        case 'Write':
+        case 'NotebookEdit':
+        case 'read':
+        case 'edit':
+        case 'write':
+        case 'read_image':
+            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':
+            return pick('url');
+        case 'WebSearch':
+        case 'web_search':
+            return pickFirst('queries', 60) || pick('query', 60);
+        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/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 的文件需分片下载，暂不支持）' : ''),
                     });