lark-remote 0.5.20 → 0.5.21

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

@@ -20,18 +20,13 @@ export type SessionDisplayUsage = Pick<UsageSnapshot, 'contextLength' | 'context
  * 到本函数（run-renderer 的状态行 `📊 N` 也走这里）。
  */
 export declare function formatTokenK(n: number): string;
-/**
- * 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 & {
+interface UsageStatsInput extends UsageSnapshot {
     /** 实际生效模型（system.init 携带）。非空字符串才显示。 */
     model?: string;
     /** 本次 run 花费（USD）。存在才显示。 */
     costUsd?: number;
-}, options?: {
+}
+interface UsageDisplayOptions {
     showResult?: boolean;
     result?: string;
     /**
@@ -39,4 +34,12 @@ export declare function formatUsageStats(usage?: UsageSnapshot & {
      * 本轮 turn 结束不等于任务结束。
      */
     completedLabel?: string;
-}): string;
+}
+/**
+ * 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?: UsageStatsInput, options?: UsageDisplayOptions): string;
+export {};

package/dist/card/usage-format.js

@@ -29,122 +29,136 @@ export function formatTokenK(n) {
     }
     return n.toString();
 }
+function cumulativeField(value) {
+    return value !== undefined ? ` · 累计 ${formatTokenK(value)}` : '';
+}
+function cumulativeCachePercent(usage) {
+    const cumInput = usage?.cumulativeInputTokens;
+    const cumCacheRead = usage?.cumulativeCacheReadTokens;
+    return cumInput !== undefined && cumCacheRead !== undefined && cumInput + cumCacheRead > 0
+        ? Math.round((cumCacheRead / (cumInput + cumCacheRead)) * 100)
+        : null;
+}
+function cumulativeParts(usage) {
+    const cumCacheRead = usage?.cumulativeCacheReadTokens;
+    const percent = cumulativeCachePercent(usage);
+    const cacheRead = cumCacheRead !== undefined
+        ? cumulativeField(cumCacheRead) + (percent !== null ? ` (${percent}%)` : '')
+        : '';
+    return {
+        input: cumulativeField(usage?.cumulativeInputTokens),
+        output: cumulativeField(usage?.cumulativeOutputTokens),
+        cacheRead,
+        cacheCreate: cumulativeField(usage?.cumulativeCacheCreationTokens),
+    };
+}
 /**
- * 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)
+ * 一致性护栏：本 run ≤ 累计 是硬不变量（累计 = 所有 run 之和，必 ≥ 本 run）。
+ * 违反说明来源 scope 混用（如 DeepSeek live result usage 是累积/超大 scope，
+ * 大于 jsonl 去重聚合的 session 累计）。只标记不修正——数字保持原样便于排查，
+ * 由数据源修复。两侧都有值时校验（避免旧数据/缺失字段误报）。
+ * 两个分支（real input/output / 10% 估计）共用，保证"本 run > 累计"在任意
+ * 路径都显式暴露。
  */
-export function formatUsageStats(usage, options) {
+function cumulativeTotalSuffix(usage, totalTokens) {
+    const cum = usage?.cumulativeTotalTokens;
+    if (cum === undefined)
+        return '';
+    const guard = totalTokens > cum ? ' · ⚠️ 累计异常' : '';
+    return cumulativeField(cum) + guard;
+}
+function contextLine(length, usage) {
+    const ctxLimit = usage.contextLimit;
+    const ctxPercent = ctxLimit !== undefined && ctxLimit > 0 ? ` (${Math.round((length / ctxLimit) * 100)}%)` : '';
+    const preCompact = usage.compactPreContextLength !== undefined
+        ? `（压缩前 ${formatTokenK(usage.compactPreContextLength)}）`
+        : '';
+    return `Context - ${formatTokenK(length)}${ctxPercent}${preCompact}`;
+}
+function headerLines(usage, options) {
     const lines = [];
-    // 1. Success 状态（通用格式，无具体结果值）
     lines.push(options?.completedLabel ?? '✅ 已完成');
-    // 1.4. 实际生效模型（非空字符串才显示）
-    if (usage?.model) {
+    if (usage?.model)
         lines.push(`Model - ${usage.model}`);
-    }
-    // 1.5. 可选的结果行（showResult 为 true 时显示）
-    if (options?.showResult && options?.result) {
+    if (options?.showResult && options?.result)
         lines.push(`结果 - ${options.result}`);
-    }
-    // 2. Context 长度（compact 卡同时展示压缩前水位）
-    if (usage?.contextLength !== undefined) {
-        const ctxLimit = usage.contextLimit;
-        const ctxPercent = ctxLimit !== undefined && ctxLimit > 0
-            ? ` (${Math.round((usage.contextLength / ctxLimit) * 100)}%)`
-            : '';
-        const preCompact = usage.compactPreContextLength !== undefined
-            ? `（压缩前 ${formatTokenK(usage.compactPreContextLength)}）`
-            : '';
-        lines.push(`Context - ${formatTokenK(usage.contextLength)}${ctxPercent}${preCompact}`);
-    }
-    // 3. Compact 次数
-    if (usage?.compactCount) {
+    if (usage?.contextLength !== undefined)
+        lines.push(contextLine(usage.contextLength, usage));
+    if (usage?.compactCount)
         lines.push(`Compact - ${usage.compactCount}次`);
+    return lines;
+}
+/** 命中率分母由调用方给：real 分支是 input+cacheRead，estimate 分支是 totalInput。 */
+function makeTokenLines(input, output, cacheRead, cacheCreation, totalTokens, cachePercent, parts, usage) {
+    const lines = [
+        `Input token - ${formatTokenK(input)}${parts.input}`,
+        `Output token - ${formatTokenK(output)}${parts.output}`,
+    ];
+    if (cacheCreation > 0) {
+        lines.push(`Cache create - ${formatTokenK(cacheCreation)}${parts.cacheCreate}`);
     }
-    // 4-7. Token 统计
+    lines.push(`Cached token - ${formatTokenK(cacheRead)} (${cachePercent}%)${parts.cacheRead}`);
+    lines.push(`Total token - ${formatTokenK(totalTokens)}${cumulativeTotalSuffix(usage, totalTokens)}`);
+    return lines;
+}
+function realTokenLines(usage, realInput, realOutput, parts) {
+    // Unified ccusage-aligned formula:
+    //   total = max(total_tokens, input + output + cacheRead + cacheCreation)
+    //   cache% = cacheRead / (input + cacheRead)
+    // cacheRead/cacheCreation are never double-counted; total_tokens folds in any
+    // extra (e.g. opencode reasoning, which is separate from output) via max().
+    const cacheRead = usage.cacheReadTokens ?? 0;
+    const cacheCreation = usage.cacheCreationTokens ?? 0;
+    const sumParts = realInput + realOutput + cacheRead + cacheCreation;
+    const totalTokens = usage.totalTokens != null ? Math.max(usage.totalTokens, sumParts) : sumParts;
+    const promptTokens = realInput + cacheRead;
+    const cachePercent = promptTokens > 0 ? Math.round((cacheRead / promptTokens) * 100) : 0;
+    return makeTokenLines(realInput, realOutput, cacheRead, cacheCreation, totalTokens, cachePercent, parts, usage);
+}
+function estimateTokenLines(usage, parts) {
+    // Estimate path: when real input/output are absent,
+    // fall back to the 10% estimate based on contextLength.
     const cacheRead = usage?.cacheReadTokens ?? 0;
     const cacheCreation = usage?.cacheCreationTokens ?? 0;
+    const inputRef = usage?.contextLength ?? cacheRead;
+    if (inputRef <= 0 && cacheRead <= 0 && cacheCreation <= 0)
+        return [];
+    const totalInput = inputRef + cacheRead;
+    const outputEst = inputRef > 0 ? Math.round(inputRef * 0.1) : 0;
+    const cachePercent = totalInput > 0 ? Math.round((cacheRead / totalInput) * 100) : 0;
+    const totalTokens = totalInput + outputEst + cacheCreation;
+    return makeTokenLines(totalInput, outputEst, cacheRead, cacheCreation, totalTokens, cachePercent, parts, usage);
+}
+function tokenLines(usage, parts) {
     const realInput = usage?.inputTokens;
     const realOutput = usage?.outputTokens;
-    // Cumulative suffix (session-wide totals), appended to Input/Output lines.
-    const cumInputSuffix = usage?.cumulativeInputTokens !== undefined
-        ? ` · 累计 ${formatTokenK(usage.cumulativeInputTokens)}`
-        : '';
-    const cumOutputSuffix = usage?.cumulativeOutputTokens !== undefined
-        ? ` · 累计 ${formatTokenK(usage.cumulativeOutputTokens)}`
-        : '';
-    const cumTotalSuffix = usage?.cumulativeTotalTokens !== undefined
-        ? ` · 累计 ${formatTokenK(usage.cumulativeTotalTokens)}`
-        : '';
-    // 一致性护栏：本 run ≤ 累计 是硬不变量（累计 = 所有 run 之和，必 ≥ 本 run）。
-    // 违反说明来源 scope 混用（如 DeepSeek live result usage 是累积/超大 scope，
-    // 大于 jsonl 去重聚合的 session 累计）。只标记不修正——数字保持原样便于排查，
-    // 由数据源修复。两侧都有值时校验（避免旧数据/缺失字段误报）。
-    // 两个分支（real input/output / 10% 估计）共用，保证"本 run > 累计"在任意
-    // 路径都显式暴露。
-    const withCumGuard = (totalTokens) => cumTotalSuffix +
-        (usage?.cumulativeTotalTokens !== undefined && totalTokens > usage.cumulativeTotalTokens
-            ? ' · ⚠️ 累计异常'
-            : '');
-    // 计算累计 cache 命中率
-    const cumInput = usage?.cumulativeInputTokens;
-    const cumCacheRead = usage?.cumulativeCacheReadTokens;
-    const cumCachePercent = cumInput !== undefined && cumCacheRead !== undefined && cumInput + cumCacheRead > 0
-        ? Math.round((cumCacheRead / (cumInput + cumCacheRead)) * 100)
-        : null;
-    // 构建累计 suffix
-    const cumCacheReadSuffix = cumCacheRead !== undefined
-        ? ` · 累计 ${formatTokenK(cumCacheRead)}` +
-            (cumCachePercent !== null ? ` (${cumCachePercent}%)` : '')
-        : '';
-    const cumCacheCreateSuffix = usage?.cumulativeCacheCreationTokens !== undefined
-        ? ` · 累计 ${formatTokenK(usage.cumulativeCacheCreationTokens)}`
-        : '';
     if (realInput !== undefined && realOutput !== undefined) {
-        // Unified ccusage-aligned formula:
-        //   total = max(total_tokens, input + output + cacheRead + cacheCreation)
-        //   cache% = cacheRead / (input + cacheRead)
-        // cacheRead/cacheCreation are never double-counted; total_tokens folds in any
-        // extra (e.g. opencode reasoning, which is separate from output) via max().
-        const promptTokens = realInput + cacheRead;
-        const cachePercent = promptTokens > 0 ? Math.round((cacheRead / promptTokens) * 100) : 0;
-        const sumParts = realInput + realOutput + cacheRead + cacheCreation;
-        const totalTokens = usage?.totalTokens != null ? Math.max(usage.totalTokens, sumParts) : sumParts;
-        lines.push(`Input token - ${formatTokenK(realInput)}${cumInputSuffix}`);
-        lines.push(`Output token - ${formatTokenK(realOutput)}${cumOutputSuffix}`);
-        if (cacheCreation > 0) {
-            lines.push(`Cache create - ${formatTokenK(cacheCreation)}${cumCacheCreateSuffix}`);
-        }
-        lines.push(`Cached token - ${formatTokenK(cacheRead)} (${cachePercent}%)${cumCacheReadSuffix}`);
-        lines.push(`Total token - ${formatTokenK(totalTokens)}${withCumGuard(totalTokens)}`);
+        return realTokenLines(usage, realInput, realOutput, parts);
     }
-    else {
-        // Estimate path: when real input/output are absent,
-        // fall back to the 10% estimate based on contextLength.
-        const inputRef = usage?.contextLength ?? cacheRead;
-        if (inputRef > 0 || cacheRead > 0 || cacheCreation > 0) {
-            const totalInput = inputRef + cacheRead;
-            const outputEst = inputRef > 0 ? Math.round(inputRef * 0.1) : 0;
-            const cachePercent = totalInput > 0 ? Math.round((cacheRead / totalInput) * 100) : 0;
-            const totalTokens = totalInput + outputEst + cacheCreation;
-            lines.push(`Input token - ${formatTokenK(totalInput)}${cumInputSuffix}`);
-            lines.push(`Output token - ${formatTokenK(outputEst)}${cumOutputSuffix}`);
-            if (cacheCreation > 0) {
-                lines.push(`Cache create - ${formatTokenK(cacheCreation)}${cumCacheCreateSuffix}`);
-            }
-            lines.push(`Cached token - ${formatTokenK(cacheRead)} (${cachePercent}%)${cumCacheReadSuffix}`);
-            lines.push(`Total token - ${formatTokenK(totalTokens)}${withCumGuard(totalTokens)}`);
-        }
-    }
-    // 8. 本次 run 花费（USD）
+    return estimateTokenLines(usage, parts);
+}
+function trailingLines(usage) {
+    const lines = [];
     if (usage?.costUsd !== undefined) {
         lines.push(`Cost - $${usage.costUsd.toFixed(4)}`);
     }
-    // 9. 推理 token（> 0 才显示，格式对齐既有 token 行）
     if (usage?.reasoningTokens !== undefined && usage.reasoningTokens > 0) {
         lines.push(`Reasoning token - ${formatTokenK(usage.reasoningTokens)}`);
     }
-    return lines.join('\n');
+    return lines;
+}
+/**
+ * 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 function formatUsageStats(usage, options) {
+    const parts = cumulativeParts(usage);
+    return [
+        ...headerLines(usage, options),
+        ...tokenLines(usage, parts),
+        ...trailingLines(usage),
+    ].join('\n');
 }
 //# sourceMappingURL=usage-format.js.map

package/dist/common/text-width.js

@@ -33,33 +33,45 @@ export function displayWidth(text) {
         total += charWidth(ch);
     return total;
 }
+/**
+ * 显示宽度为 2 的码点区间（闭区间，Map 的键 = 下界、值 = 上界）。
+ *
+ * 用 Map 而非对象字面量：对象字面量的 `constructor` / `toString` 等键会命中
+ * Object.prototype，查表会拿到非预期值；数字键的 Map 无此问题。顺序与原 if 链
+ * 一致（所有区间都返回同一宽度，遍历早停即等价），逐字保留：
+ * - [0x1100,0x115f] Hangul Jamo；U+2329 / U+232A 单独列为单码点区间；
+ * - CJK 统一表意文字 / 假名 / 全角标点 / 兼容表意 / 全角 / Hangul 音节；
+ * - 常见 emoji（0x1f300–0x1faff）与 Misc Symbols（0x2600–0x27bf）；
+ * - Misc Technical 块（U+2300–U+23FF）：⏱⏹⏳⏸⏺ 等计时器/播放器符号在
+ *   状态行里实际使用，手机端按 emoji 宽度渲染——按 1 计会系统性低估行宽，
+ *   窄屏余量比设计值更小。
+ */
+const WIDE_CODE_POINT_RANGES = new Map([
+    [0x1100, 0x115f],
+    [0x2329, 0x2329],
+    [0x232a, 0x232a],
+    [0x2e80, 0xa4cf],
+    [0xac00, 0xd7a3],
+    [0xf900, 0xfaff],
+    [0xfe30, 0xfe6f],
+    [0xff00, 0xff60],
+    [0xffe0, 0xffe6],
+    [0x1f300, 0x1faff],
+    [0x2600, 0x27bf],
+    [0x2300, 0x23ff],
+]);
+/** 码点是否落在任一「宽度 2」区间内（模块级命名函数，供 charWidth 查表）。 */
+function isWideCodePoint(code) {
+    for (const [lo, hi] of WIDE_CODE_POINT_RANGES) {
+        if (code >= lo && code <= hi)
+            return true;
+    }
+    return false;
+}
 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;
-    // Misc Technical 块（U+2300–U+23FF）：⏱⏹⏳⏸⏺ 等计时器/播放器符号在
-    // 状态行里实际使用，手机端按 emoji 宽度渲染——按 1 计会系统性低估行宽，
-    // 窄屏余量比设计值更小。
-    if (code >= 0x2300 && code <= 0x23ff)
-        return 2;
-    return 1;
+    return isWideCodePoint(code) ? 2 : 1;
 }
 /**
  * 中间省略截断：保留开头与结尾，只在中间打 `…`。

package/dist/common/tool-summary.js

@@ -52,101 +52,143 @@ export function asRecord(input) {
     }
     return null;
 }
-export function summarizeToolInput(name, input) {
-    const rec = asRecord(input);
-    if (!rec)
+// --- 字段选取原语 ---
+// 模块级纯函数：调用方（`summarizeToolInput`）只负责选路，字段口径各自独立。
+function pickField(rec, key, max = HEADER_SUMMARY_MAX) {
+    const v = rec[key];
+    if (typeof v !== 'string')
         return '';
-    const pick = (key, max = HEADER_SUMMARY_MAX) => {
-        const v = rec[key];
-        if (typeof v !== 'string')
-            return '';
-        const oneLine = v.replace(/\s+/g, ' ').trim();
-        // 码点安全截断：裸 slice 切在代理对中间会留下孤立代理项进卡片
-        // （同族修复见 tool-render.ts 的 toolHeaderText）。
-        return truncate(oneLine, max);
-    };
-    /** 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;
-        }
+    const oneLine = v.replace(/\s+/g, ' ').trim();
+    // 码点安全截断：裸 slice 切在代理对中间会留下孤立代理项进卡片
+    // （同族修复见 tool-render.ts 的 toolHeaderText）。
+    return truncate(oneLine, max);
+}
+/** First non-empty of several keys（DSH 同名工具跨版本改过参数名）。 */
+function pickAnyField(rec, keys, max = HEADER_SUMMARY_MAX) {
+    for (const key of keys) {
+        const v = pickField(rec, key, max);
+        if (v)
+            return v;
+    }
+    return '';
+}
+/** 数组参数的第一个字符串项（DSH web_search 的 queries、present 的 files）。 */
+function pickFirstField(rec, key, max = HEADER_SUMMARY_MAX) {
+    const v = rec[key];
+    if (typeof v === 'string')
+        return pickField(rec, key, max);
+    if (!Array.isArray(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 truncate(oneLine, max);
-            }
-            if (item && typeof item === 'object') {
-                const path = item.path;
-                if (typeof path === 'string' && path.trim())
-                    return path;
-            }
+    for (const item of v) {
+        if (typeof item === 'string' && item.trim()) {
+            const oneLine = item.replace(/\s+/g, ' ').trim();
+            return truncate(oneLine, max);
         }
-        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;
+        if (item && typeof item === 'object') {
+            const path = item.path;
+            if (typeof path === 'string' && path.trim())
+                return path;
         }
-        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']);
     }
+    return '';
+}
+function shellSummary(rec) {
+    return pickField(rec, 'command');
+}
+function fileSummary(rec) {
+    return pickField(rec, 'file_path') || pickField(rec, 'path');
+}
+function grepSummary(rec) {
+    const pat = pickField(rec, 'pattern', 40);
+    const p = pickField(rec, 'path', 30);
+    return p ? `${pat} in ${p}` : pat;
+}
+function patternSummary(rec) {
+    return pickField(rec, 'pattern');
+}
+function pathSummary(rec) {
+    return pickField(rec, 'path');
+}
+function urlSummary(rec) {
+    return pickField(rec, 'url');
+}
+function queriesSummary(rec) {
+    return pickFirstField(rec, 'queries', 60) || pickField(rec, 'query', 60);
+}
+function subagentSummary(rec) {
+    return pickField(rec, 'description') || pickField(rec, 'subagent_type');
+}
+function messageSummary(rec) {
+    return pickField(rec, 'description') || pickField(rec, 'agent_id');
+}
+function jobIdSummary(rec) {
+    return pickField(rec, 'job_id');
+}
+function jobListSummary() {
+    return '（列出任务）';
+}
+function filesSummary(rec) {
+    return pickFirstField(rec, 'files');
+}
+function nameSummary(rec) {
+    return pickField(rec, 'name');
+}
+function runCodeSummary(rec) {
+    return pickField(rec, 'description') || pickField(rec, 'language');
+}
+function textSummary(rec) {
+    return pickField(rec, 'text');
+}
+function questionCountSummary(rec) {
+    const questions = rec.questions;
+    return Array.isArray(questions) ? `${questions.length} 个问题` : '';
+}
+function todoSummary(rec) {
+    return summarizeTodos(rec);
+}
+const FALLBACK_FIELDS = ['command', 'file_path', 'path', 'query', 'url'];
+/** 类别 → 摘要器。ToolKind 的每个成员都必须有条目。 */
+const KIND_SUMMARY = new Map([
+    ['shell', shellSummary],
+    ['file', fileSummary],
+    ['grep', grepSummary],
+    ['glob', patternSummary],
+    ['ls', pathSummary],
+    ['webfetch', urlSummary],
+    ['websearch', queriesSummary],
+    ['websearch_queries', queriesSummary],
+]);
+/**
+ * 工具名 → 摘要器。用 Map 而非对象字面量：`constructor` / `toString` 这类
+ * 工具名会命中 Object.prototype，查表会拿到非函数值。
+ */
+const NAME_SUMMARY = new Map([
+    ['Agent', subagentSummary],
+    ['Task', subagentSummary],
+    ['subagent', subagentSummary],
+    ['workflow', subagentSummary],
+    ['todo_write', todoSummary],
+    ['job_output', jobIdSummary],
+    ['job_kill', jobIdSummary],
+    ['job_list', jobListSummary],
+    ['present', filesSummary],
+    ['skill', nameSummary],
+    ['run_code', runCodeSummary],
+    ['terminal_send', textSummary],
+    ['ask_user_question', questionCountSummary],
+    ['send_message', messageSummary],
+    ['interrupt_agent', messageSummary],
+]);
+export function summarizeToolInput(name, input) {
+    const rec = asRecord(input);
+    if (!rec)
+        return '';
+    const kind = toolKindOf(name);
+    const byKind = kind === undefined ? undefined : KIND_SUMMARY.get(kind);
+    if (byKind)
+        return byKind(rec);
+    const byName = NAME_SUMMARY.get(name);
+    return byName ? byName(rec) : pickAnyField(rec, FALLBACK_FIELDS);
 }
 /** todo_write 摘要：完成进度 + 当前 in_progress 项主题。 */
 function summarizeTodos(rec) {