virlen-remote 0.5.0 → 0.6.1

package/dist/protocol/tool-args.js

@@ -0,0 +1,439 @@
+/**
+ * 工具入参摘要 —— 「这一步工具到底在干什么」的**唯一格式化口径**。
+ *
+ * 为什么单列一个模块：手机屏上一行只放得下一步工具调用，而**哪几个键才是关键入参**是随
+ * 工具而变的（`read_file` 看路径、`execute_command` 看命令、`search_text_in_files` 看
+ * 「在哪儿搜什么」）。这份知识原先只存在于桌面端的 28 个 `getShortText()` 组件里 ——
+ * 手机端拿不到，于是真机反馈是「工具气泡只有工具名，看不到编辑的是哪个文件、执行的是什么命令」。
+ *
+ * 三条纪律（与桌面 `tool-call/primary-path.ts` 同源）：
+ *
+ * 1. **按工具名取键**：键名以 `tool_defs/definitions.json` 为准（那是权威契约，本文件
+ *    只挑「主参数」）——不用「给每个工具加一个方法」那种写法，那是把同一件事抄 28 遍；
+ * 2. **拿不到就不猜**：没有可用的关键入参 → `undefined`，手机端只显示工具名（宁可不显示，
+ *    也不要显示一句听起来像那么回事的假话）；
+ * 3. **只给摘要，不给原文**：`write_file.content` / `edit_file.edits[].old_string` 可能是
+ *    整篇文章，原样下行就是流量事故（§7-⑦ 同一条纪律）。长度有硬上限，超长一律截断。
+ *
+ * 产出是**纯文本、纯函数**：同一份实现同时供真实电脑侧（`bridge/dto.ts`）与演示宿主
+ * （`testing/mock-host.ts`）使用，两端不会漂移。
+ *
+ * 本模块承担工具调用的**两种呈现**（两级粒度，别混用）：
+ * - {@link summarizeToolArgs} —— **折叠态**的一行摘要（硬上限 {@link TOOL_ARGS_MAX} = 160）；
+ * - {@link formatToolArgs} —— **展开态**的完整入参（上限 {@link TOOL_DETAIL_MAX} = 5000，
+ *   超出走中间省略 {@link elideMiddle}）。
+ * 两级共用同一个 `shortenPath` 回调：同一份路径不能在折叠态与展开态显示成两个样子。
+ */
+/** 摘要长度硬上限：手机一行放不下更多，也避免长命令 / 长路径把帧撑大。 */
+export const TOOL_ARGS_MAX = 160;
+/**
+ * 各工具的「主参数」键名（按优先级），键名取自 `tool_defs/definitions.json`。
+ *
+ * 只列**需要与兜底顺序不同**的工具：其余工具（`file_info` / `vision_analyze` / `mkdir` …）
+ * 的主参数就是 `path`，交给下面的通用规则即可。
+ */
+const PRIMARY_KEYS = {
+    read_file: ['path', 'paths'],
+    delete_file: ['path', 'paths'],
+    mkdir: ['path', 'paths'],
+    execute_script: ['file_path'],
+    search_knowledge_base: ['query'],
+    list_knowledge_base_documents: ['knowledge_base_id'],
+    get_knowledge_base_document: ['document_id', 'knowledge_base_id'],
+    write_to_knowledge_base: ['document_name'],
+    delete_knowledge_base_document: ['document_id', 'knowledge_base_id'],
+    web_search: ['query'],
+    web_fetch: ['url'],
+    read_skill_source: ['name'],
+    read_messages: ['message_id'],
+    list_messages: ['keyword'],
+    user_choice: ['question'],
+};
+/**
+ * 兜底顺序 —— 未知工具（协议比工具集新 / 旧）也给出一个像样的摘要。
+ *
+ * `path` 在 `query` 之前：与桌面 `DefaultMessage` 的取舍一致（它也是优先取 `path`），
+ * 这种「同一种入参键在两端必须是同一个含义」的规则不该各写一份。
+ */
+const FALLBACK_KEYS = [
+    'command',
+    'path',
+    'paths',
+    'file_path',
+    'url',
+    'query',
+    'keyword',
+    'name',
+    'document_name',
+    'document_id',
+    'knowledge_base_id',
+    'message_id',
+    'question',
+];
+/**
+ * 生成一行入参摘要；没有可显示的内容时返回 `undefined`。
+ *
+ * 未知工具走兜底键序；一个都不命中时用「键=值」拼（最多两个键）——那是桌面
+ * `DefaultMessage` 的行为，手机端不需要比它更聪明，但需要至少能看出「调了什么」。
+ */
+export function summarizeToolArgs(name, input, options = {}) {
+    const max = options.maxLength ?? TOOL_ARGS_MAX;
+    // 入参可能是 JSON 字符串（引擎透传 / 老数据），先解开再当对象用
+    const record = asRecord(input);
+    if (!record) {
+        /*
+         * 看起来像 JSON 却解不开（老数据可能被截断）→ **不给摘要**：半截 JSON 不是信息，
+         * 是噪音 —— 手机屏上一行「{ "path": "src/a」除了占地方什么也说明不了。
+         */
+        if (typeof input === 'string' && looksLikeJson(input))
+            return undefined;
+        const text = scalarText(input);
+        return text ? clip(collapse(text), max) : undefined;
+    }
+    const short = options.shortenPath ?? ((path) => path);
+    const text = summarize(name, record, short);
+    return text ? clip(collapse(text), max) : undefined;
+}
+function summarize(name, rec, short) {
+    switch (name) {
+        // 命令就是这件事本身（tips 是模型的解释，放不进行内摘要，留给桌面卡片）
+        case 'execute_command':
+            return scalarText(rec.command);
+        case 'copy_move_file': {
+            const source = pathText(rec.source, short);
+            const dest = pathText(rec.destination, short);
+            if (!source && !dest)
+                return undefined;
+            if (source && dest)
+                return `${source} → ${dest}`;
+            return source || dest;
+        }
+        /*
+         * 搜索类：桌面文案是「在 X 中搜索 Y」（`SearchTextInFileMessage` /
+         * `SearchFileByNameMessage`），手机沿用同一句式 —— 用户在两个屏幕上看到同一句话，
+         * 才不需要重新理解一次。
+         */
+        case 'search_text_in_files':
+        case 'search_files_by_name': {
+            const root = pathText(rec.path, short);
+            const query = scalarText(rec.query);
+            if (root && query)
+                return `在 ${root} 中搜索 ${query}`;
+            return query ?? root;
+        }
+        case 'read_file': {
+            const paths = pathList(rec, short);
+            if (!paths)
+                return undefined;
+            const range = readRange(rec);
+            return range ? `${paths} ${range}` : paths;
+        }
+        case 'write_file': {
+            const path = pathText(rec.path, short);
+            if (!path)
+                return undefined;
+            const lines = typeof rec.content === 'string' ? countLines(rec.content) : 0;
+            return lines > 0 ? `${path} · 写入 ${lines} 行` : path;
+        }
+        case 'edit_file': {
+            const path = pathText(rec.path, short);
+            const stat = editStat(rec);
+            if (!path)
+                return stat;
+            return stat ? `${path} · ${stat}` : path;
+        }
+        // 清单只在桌面的标题栏浮层里看；消息流这一行只需说明「改了流程」（桌面同一句文案）
+        case 'todo_write': {
+            const todos = rec.todos;
+            if (Array.isArray(todos))
+                return `更新了 ${todos.length} 项任务`;
+            return undefined;
+        }
+        default:
+            break;
+    }
+    const keys = PRIMARY_KEYS[name] ?? FALLBACK_KEYS;
+    for (const key of keys) {
+        const value = rec[key];
+        if (Array.isArray(value)) {
+            const list = listText(value, short);
+            if (list)
+                return list;
+            continue;
+        }
+        const text = pathOrScalar(key, value, short);
+        if (text)
+            return text;
+    }
+    return objectFallback(rec, short);
+}
+/** 一个键都不命中时的兜底：最多两个「键=值」，仍然比一整串 JSON 好读。 */
+function objectFallback(rec, short) {
+    const parts = [];
+    for (const key of Object.keys(rec)) {
+        if (parts.length >= 2)
+            break;
+        const value = rec[key];
+        if (Array.isArray(value))
+            continue;
+        const text = pathOrScalar(key, value, short);
+        if (text)
+            parts.push(`${key}=${text}`);
+    }
+    return parts.length ? parts.join(' ') : undefined;
+}
+/** 路径类键名（这些键的值要过 `shortenPath`，其余原样）。 */
+const PATH_KEYS = new Set(['path', 'paths', 'file_path', 'source', 'destination']);
+function pathOrScalar(key, value, short) {
+    if (PATH_KEYS.has(key))
+        return pathText(value, short);
+    return scalarText(value);
+}
+function pathText(value, short) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed ? short(trimmed) : undefined;
+}
+/** 路径列表：首项 + `+N`（桌面也是一样只报首项与总数，不铺开一串）。 */
+function listText(values, short) {
+    const items = [];
+    for (const value of values) {
+        const text = pathText(value, short);
+        if (text)
+            items.push(text);
+    }
+    if (items.length === 0)
+        return undefined;
+    if (items.length === 1)
+        return items[0];
+    return `${items[0]} +${items.length - 1}`;
+}
+/** `path` / `paths` 两种形状统一成一行（批量形态优先：它是这次调用真正的覆盖面）。 */
+function pathList(rec, short) {
+    if (Array.isArray(rec.paths)) {
+        const text = listText(rec.paths, short);
+        if (text)
+            return text;
+    }
+    return pathText(rec.path, short);
+}
+/** `read_file` 的读取范围：`start_line` / `max_lines` 都已知时给出行区间。 */
+function readRange(rec) {
+    const start = numberText(rec.start_line);
+    if (!start)
+        return undefined;
+    const max = numberText(rec.max_lines);
+    return max ? `${start}-${start + max - 1}` : `${start}`;
+}
+/**
+ * `edit_file` 的改动规模。
+ *
+ * 与桌面 `EditFileMessage` 的**降级分支**同一条算法（没有工具结果 uiData 时按入参行数估）：
+ * 电脑侧手上只有入参，拿不到那次编辑的精确 diff —— 于是如实给一个「按行数估」的说法，
+ * 文案与桌面逐字一致（`减少 X行,新增 Y行`）。
+ */
+function editStat(rec) {
+    let del = 0;
+    let ins = 0;
+    const edits = Array.isArray(rec.edits)
+        ? rec.edits
+        : [{ old_string: rec.old_string, new_string: rec.new_string }];
+    for (const edit of edits) {
+        const item = asRecord(edit);
+        if (!item)
+            continue;
+        if (typeof item.old_string === 'string')
+            del += countLines(item.old_string);
+        if (typeof item.new_string === 'string')
+            ins += countLines(item.new_string);
+    }
+    const parts = [];
+    if (del > 0)
+        parts.push(`减少 ${del}行`);
+    if (ins > 0)
+        parts.push(`新增 ${ins}行`);
+    return parts.length ? parts.join(',') : undefined;
+}
+/** 行数（末尾空行不算，与手机端 `countLines` 同一口径）。 */
+function countLines(text) {
+    const body = text.replace(/\n+$/, '');
+    return body.trim() ? body.split('\n').length : 0;
+}
+/** 标量 → 文本：字符串 / 数字 / 布尔；其余（对象、数组、null）返回 `undefined`。 */
+function scalarText(value) {
+    if (typeof value === 'string')
+        return value.trim() || undefined;
+    if (typeof value === 'number' && Number.isFinite(value))
+        return String(value);
+    if (typeof value === 'boolean')
+        return String(value);
+    return undefined;
+}
+/** 数字键（`start_line` 之类）：只认正整数，`0` / 负数 / NaN 一律当没给。 */
+function numberText(value) {
+    const n = typeof value === 'string' ? Number(value) : value;
+    return typeof n === 'number' && Number.isInteger(n) && n > 0 ? n : undefined;
+}
+/** 对象视图；JSON 字符串也认（宽松解析失败就返回 `undefined`，不抛）。 */
+function asRecord(input) {
+    if (input && typeof input === 'object' && !Array.isArray(input)) {
+        return input;
+    }
+    if (typeof input === 'string') {
+        const trimmed = input.trim();
+        if (!trimmed.startsWith('{'))
+            return undefined;
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                return parsed;
+            }
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return undefined;
+}
+/** 看着像 JSON（对象 / 数组）：用于区分「一段普通文本」与「解不开的结构化入参」。 */
+function looksLikeJson(text) {
+    const trimmed = text.trim();
+    return trimmed.startsWith('{') || trimmed.startsWith('[');
+}
+/** 换行 / 连续空白压成单个空格：多行命令与 JSON 片段在行内摘要里必须是一行。 */
+function collapse(text) {
+    return text.replace(/\s+/g, ' ').trim();
+}
+function clip(text, max) {
+    return text.length > max ? `${text.slice(0, max)}…` : text;
+}
+// ─────────────────── 展开态的「完整入参」与通用中间省略 ───────────────────
+/**
+ * **展开区**文本的长度上限 —— 入参详情与工具输出**共用同一条线**。
+ *
+ * 与 {@link TOOL_ARGS_MAX} 不是一个量级，也不是一回事：那个是**折叠态一行**能放下多少字，
+ * 这个是**展开后**愿意渲染多少字（用户 2026-10 拍板：超了就中间省略）。
+ *
+ * 为什么是 5000：手机一屏约 30 行 × 40 字，5000 字符已是四屏以上；再长就不叫「看」，
+ * 叫「拖着滚」—— 而拖动过程中真正需要的信息（开头在做什么、结尾成没成）都在两头，
+ * 中间那段从来没人读完过。
+ */
+export const TOOL_DETAIL_MAX = 5000;
+/**
+ * 中间省略 —— 头尾都留，挖掉中间。
+ *
+ * 为什么不「从尾部截断」：工具输出与入参的**结论都在两头** —— 开头是命令 / 标题 / 第一个
+ * 文件，结尾是报错 / 汇总 / 最后一个 diff 块。只留头等于把结论切掉，用户还得回电脑前看。
+ *
+ * ⚠️ 被省略的字符数写进正文里（`…（中间省略 N 字符）…`）——这是「这里少了东西」的
+ * **唯一凭证**：只看长度看不出来，一段刚好的 5000 字符与被砍过的 5000 字符无法区分。
+ */
+export function elideMiddle(text, max = TOOL_DETAIL_MAX) {
+    if (max <= 0)
+        return '';
+    if (text.length <= max)
+        return text;
+    // 标记本身也要占额度：先按最坏情况留出余量，末尾再兜一次硬截（结果绝不超上限）
+    const keep = Math.max(2, max - MARKER_RESERVE);
+    const headLength = Math.ceil(keep / 2);
+    const head = text.slice(0, headLength);
+    const tail = text.slice(text.length - (keep - headLength));
+    const omitted = text.length - head.length - tail.length;
+    const result = `${head}\n\n${omittedMark(omitted)}\n\n${tail}`;
+    return result.length <= max ? result : result.slice(0, max);
+}
+/** {@link elideMiddle} 的最坏长度预留（标记行 + 首尾换行），用于算「还能留多少原文字符」。 */
+const MARKER_RESERVE = 32;
+function omittedMark(omitted) {
+    return `…（中间省略 ${omitted} 字符）…`;
+}
+/**
+ * 工具入参的**完整文本**（展开区用）：两空格缩进的 JSON，路径按工作目录缩短，超长中间省略。
+ *
+ * 为什么不把 {@link summarizeToolArgs} 的输出「加长」：摘要只挑**主参数**，而用户点开卡片
+ * 想看的恰恰是那行没显示完的部分 —— 还有哪些键、`write_file` 到底写了什么、`edit_file` 的
+ * old/new 是什么。唯一忠实的做法是把入参本身摆出来，于是这里与桌面导出
+ * （`ui/pages/chat/components/sidebar` 的 `JSON.stringify(tc.input, null, 2)`）用同一种形态。
+ *
+ * ⚠️ 与摘要「只给摘要、不给原文」的纪律**不同**：这里允许出现正文（`write_file.content`
+ * 会原样出现）—— 前提是用户**主动点开**才渲染，总量由 {@link TOOL_DETAIL_MAX} 兜住。
+ * 折叠态绝不带它，那才是流量事故的现场。
+ *
+ * 没有可显示的内容 → `undefined`（展开区不渲染这一块）。
+ */
+export function formatToolArgs(input, options = {}) {
+    const max = options.maxLength ?? TOOL_DETAIL_MAX;
+    const short = options.shortenPath ?? ((path) => path);
+    const value = normalizeDetail(input);
+    if (value === undefined || isEmptyDetail(value))
+        return undefined;
+    const text = typeof value === 'object'
+        ? JSON.stringify(shortenPathValues(value, short), null, 2)
+        : String(value);
+    const trimmed = (text ?? '').trim();
+    return trimmed ? elideMiddle(trimmed, max) : undefined;
+}
+/**
+ * 归一化入参：JSON 字符串解开、普通文本原样、标量转文本，对象 / 数组原样。
+ *
+ * 解不开的 JSON 字符串**原样给出**（与摘要那边的取舍相反：摘要是「半截 JSON 不是信息」，
+ * 而展开区是用户点开来看的现场 —— 模型真发了一段坏 JSON，如实摆出来比藏起来有用）。
+ */
+function normalizeDetail(input) {
+    if (input === undefined || input === null)
+        return undefined;
+    if (typeof input === 'string') {
+        const trimmed = input.trim();
+        if (!trimmed)
+            return undefined;
+        if (!looksLikeJson(trimmed))
+            return trimmed;
+        try {
+            return JSON.parse(trimmed);
+        }
+        catch {
+            return trimmed;
+        }
+    }
+    if (typeof input === 'object')
+        return input;
+    return scalarText(input);
+}
+/**
+ * 空入参（`{}` / `[]`）→ 没有可展示的内容。
+ *
+ * 为什么不是把它当「入参为空」显示出来：展开区那一块的唯一职责是回答「刚才调它的时候
+ * 到底传了什么」。无参数的工具（`get_current_time` 之类）传了个空对象 —— 摆一个 `{}`
+ * 只占地方，反而让用户以为漏显示了什么。
+ */
+function isEmptyDetail(value) {
+    if (Array.isArray(value))
+        return value.length === 0;
+    if (value && typeof value === 'object')
+        return Object.keys(value).length === 0;
+    return false;
+}
+/**
+ * 递归把**路径键**的值缩短（键名与 {@link PATH_KEYS} 同一份：`path` / `paths` / `file_path` …）。
+ */
+function shortenPathValues(value, short) {
+    if (Array.isArray(value))
+        return value.map((item) => shortenPathValues(item, short));
+    if (!value || typeof value !== 'object')
+        return value;
+    const out = {};
+    for (const [key, raw] of Object.entries(value)) {
+        out[key] = PATH_KEYS.has(key) ? shortenPathValue(raw, short) : shortenPathValues(raw, short);
+    }
+    return out;
+}
+/** 路径键的值：字符串 / 字符串数组缩短，其余按普通值递归。 */
+function shortenPathValue(value, short) {
+    if (typeof value === 'string')
+        return short(value);
+    if (Array.isArray(value))
+        return value.map((item) => shortenPathValue(item, short));
+    return shortenPathValues(value, short);
+}
+//# sourceMappingURL=tool-args.js.map

package/dist/protocol/tool-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-args.js","sourceRoot":"","sources":["../../src/protocol/tool-args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,0CAA0C;AAC1C,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAA;AAEhC;;;;;GAKG;AACH,MAAM,YAAY,GAAsC;IACtD,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5B,WAAW,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9B,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,CAAC,WAAW,CAAC;IAC7B,qBAAqB,EAAE,CAAC,OAAO,CAAC;IAChC,6BAA6B,EAAE,CAAC,mBAAmB,CAAC;IACpD,2BAA2B,EAAE,CAAC,aAAa,EAAE,mBAAmB,CAAC;IACjE,uBAAuB,EAAE,CAAC,eAAe,CAAC;IAC1C,8BAA8B,EAAE,CAAC,aAAa,EAAE,mBAAmB,CAAC;IACpE,UAAU,EAAE,CAAC,OAAO,CAAC;IACrB,SAAS,EAAE,CAAC,KAAK,CAAC;IAClB,iBAAiB,EAAE,CAAC,MAAM,CAAC;IAC3B,aAAa,EAAE,CAAC,YAAY,CAAC;IAC7B,aAAa,EAAE,CAAC,SAAS,CAAC;IAC1B,WAAW,EAAE,CAAC,UAAU,CAAC;CAC1B,CAAA;AAED;;;;;GAKG;AACH,MAAM,aAAa,GAAG;IACpB,SAAS;IACT,MAAM;IACN,OAAO;IACP,WAAW;IACX,KAAK;IACL,OAAO;IACP,SAAS;IACT,MAAM;IACN,eAAe;IACf,aAAa;IACb,mBAAmB;IACnB,YAAY;IACZ,UAAU;CACX,CAAA;AAYD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,KAAc,EACd,OAAO,GAA2B,EAAE;IAEpC,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,IAAI,aAAa,CAAA;IAC9C,sCAAsC;IACtC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC9B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ;;;WAGG;QACH,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,aAAa,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAA;QACvE,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;QAC9B,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACrD,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;IAC7D,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;IAC3C,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AACrD,CAAC;AAED,SAAS,SAAS,CAChB,IAAY,EACZ,GAA4B,EAC5B,KAA+B;IAE/B,QAAQ,IAAI,EAAE,CAAC;QACb,wCAAwC;QACxC,KAAK,iBAAiB;YACpB,OAAO,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QAEhC,KAAK,gBAAgB,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;YAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;YAC7C,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI;gBAAE,OAAO,SAAS,CAAA;YACtC,IAAI,MAAM,IAAI,IAAI;gBAAE,OAAO,GAAG,MAAM,MAAM,IAAI,EAAE,CAAA;YAChD,OAAO,MAAM,IAAI,IAAI,CAAA;QACvB,CAAC;QAED;;;;WAIG;QACH,KAAK,sBAAsB,CAAC;QAC5B,KAAK,sBAAsB,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;YACtC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YACnC,IAAI,IAAI,IAAI,KAAK;gBAAE,OAAO,KAAK,IAAI,QAAQ,KAAK,EAAE,CAAA;YAClD,OAAO,KAAK,IAAI,IAAI,CAAA;QACtB,CAAC;QAED,KAAK,WAAW,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YAClC,IAAI,CAAC,KAAK;gBAAE,OAAO,SAAS,CAAA;YAC5B,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;YAC5B,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;QAC5C,CAAC;QAED,KAAK,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;YACtC,IAAI,CAAC,IAAI;gBAAE,OAAO,SAAS,CAAA;YAC3B,MAAM,KAAK,GAAG,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;YAC3E,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;QACrD,CAAC;QAED,KAAK,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;YACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;YAC1B,IAAI,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAA;YACtB,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;QAC1C,CAAC;QAED,2CAA2C;QAC3C,KAAK,YAAY,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAA;YACvB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,OAAO,OAAO,KAAK,CAAC,MAAM,MAAM,CAAA;YAC1D,OAAO,SAAS,CAAA;QAClB,CAAC;QAED;YACE,MAAK;IACT,CAAC;IAED,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,aAAa,CAAA;IAChD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;QACtB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;YACnC,IAAI,IAAI;gBAAE,OAAO,IAAI,CAAA;YACrB,SAAQ;QACV,CAAC;QACD,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;QAC5C,IAAI,IAAI;YAAE,OAAO,IAAI,CAAA;IACvB,CAAC;IAED,OAAO,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;AACnC,CAAC;AAED,4CAA4C;AAC5C,SAAS,cAAc,CACrB,GAA4B,EAC5B,KAA+B;IAE/B,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;YAAE,MAAK;QAC5B,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;QACtB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,SAAQ;QAClC,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;QAC5C,IAAI,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,CAAA;IACxC,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AACnD,CAAC;AAED,yCAAyC;AACzC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAA;AAElF,SAAS,YAAY,CACnB,GAAW,EACX,KAAc,EACd,KAA+B;IAE/B,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IACrD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAA;AAC1B,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc,EAAE,KAA+B;IAC/D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,OAAO,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AAC7C,CAAC;AAED,2CAA2C;AAC3C,SAAS,QAAQ,CAAC,MAA0B,EAAE,KAA+B;IAC3E,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;QACnC,IAAI,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC5B,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACxC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAA;IACvC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAA;AAC3C,CAAC;AAED,uDAAuD;AACvD,SAAS,QAAQ,CAAC,GAA4B,EAAE,KAA+B;IAC7E,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;QACvC,IAAI,IAAI;YAAE,OAAO,IAAI,CAAA;IACvB,CAAC;IACD,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;AAClC,CAAC;AAED,8DAA8D;AAC9D,SAAS,SAAS,CAAC,GAA4B;IAC7C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACxC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAA;IAC5B,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACrC,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,KAAK,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAA;AACzD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,QAAQ,CAAC,GAA4B;IAC5C,IAAI,GAAG,GAAG,CAAC,CAAA;IACX,IAAI,GAAG,GAAG,CAAC,CAAA;IACX,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;QACpC,CAAC,CAAC,GAAG,CAAC,KAAK;QACX,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAA;IAChE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC3B,IAAI,CAAC,IAAI;YAAE,SAAQ;QACnB,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ;YAAE,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAC3E,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ;YAAE,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAC7E,CAAC;IACD,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,GAAG,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAA;IACrC,IAAI,GAAG,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAA;IACrC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AACnD,CAAC;AAED,yCAAyC;AACzC,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACrC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;AAClD,CAAC;AAED,0DAA0D;AAC1D,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,IAAI,EAAE,IAAI,SAAS,CAAA;IAC/D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;IAC7E,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;IACpD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,uDAAuD;AACvD,SAAS,UAAU,CAAC,KAAc;IAChC,MAAM,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IAC3D,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AAC9E,CAAC;AAED,iDAAiD;AACjD,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO,KAAgC,CAAA;IACzC,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;QAC5B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,SAAS,CAAA;QAC9C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YAClC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACnE,OAAO,MAAiC,CAAA;YAC1C,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAA;QAClB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,kDAAkD;AAClD,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAC3B,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;AAC3D,CAAC;AAED,gDAAgD;AAChD,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;AACzC,CAAC;AAED,SAAS,IAAI,CAAC,IAAY,EAAE,GAAW;IACrC,OAAO,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAA;AAC5D,CAAC;AAED,4DAA4D;AAE5D;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAA;AAEnC;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,GAAG,GAAW,eAAe;IACrE,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,EAAE,CAAA;IACvB,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,CAAA;IACnC,yCAAyC;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,cAAc,CAAC,CAAA;IAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAA;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,UAAU,CAAC,CAAC,CAAA;IAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;IACvD,MAAM,MAAM,GAAG,GAAG,IAAI,OAAO,WAAW,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAA;IAC9D,OAAO,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AAC7D,CAAC;AAED,8DAA8D;AAC9D,MAAM,cAAc,GAAG,EAAE,CAAA;AAEzB,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO,UAAU,OAAO,OAAO,CAAA;AACjC,CAAC;AAiBD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAc,EACd,OAAO,GAA0B,EAAE;IAEnC,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,IAAI,eAAe,CAAA;IAChD,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;IAC7D,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA;IACpC,IAAI,KAAK,KAAK,SAAS,IAAI,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACjE,MAAM,IAAI,GACR,OAAO,KAAK,KAAK,QAAQ;QACvB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACnB,MAAM,OAAO,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACnC,OAAO,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AACxD,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAA;IAC3D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;QAC5B,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAA;QAC9B,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAA;QAC3C,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,OAAO,CAAA;QAChB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC3C,OAAO,UAAU,CAAC,KAAK,CAAC,CAAA;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAA;IACnD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC,MAAM,KAAK,CAAC,CAAA;IACxF,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,KAAc,EAAE,KAA+B;IACxE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;IACpF,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACrD,MAAM,GAAG,GAA4B,EAAE,CAAA;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;QAC1E,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAC9F,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,oCAAoC;AACpC,SAAS,gBAAgB,CAAC,KAAc,EAAE,KAA+B;IACvE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAA;IAClD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;IACnF,OAAO,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;AACxC,CAAC"}

package/dist/testing/mock-host.d.ts

@@ -1,5 +1,6 @@
+import { type CompressMode } from '../protocol/compress.js';
 import type { HostDataSource, HostEmit } from '../protocol/host.js';
-import type { ApprovalTier } from '../protocol/api.js';
+import type { ApprovalTier, RunningToolDTO } from '../protocol/api.js';
 export interface MockHostOptions {
     /** 流式段数。 */
     streamSteps?: number;
@@ -17,6 +18,14 @@ export interface MockHostOptions {
      * 打开后手机端能看到「工具 · list_files」气泡（harness 人工验证用）。
      */
     demoToolMessage?: boolean;
+    /**
+     * 模拟链路通讯类型（§37）：`'relay'` 时**所有 `host.file.*` 一律拒**，
+     * 与真实电脑侧的「非中继才给传文件」同一条口径（文案也同一句）。
+     *
+     * 为何要能模拟：手机端「中继时置灰入口」与「电脑端拒了之后怎么提示」是两条独立分支，
+     * 而不给一个会拒的宿主就测不到后者的错误路径。
+     */
+    fileLinkKind?: 'direct' | 'relay';
 }
 /** 构造演示用交互（供 harness / 单测触发手机端卡片）。 */
 export interface MockInteractionSpec {
@@ -61,6 +70,40 @@ export interface MockHostDataSource extends HostDataSource {
         name: string;
         chars: number;
     } | null): void;
+    /**
+     * 手动推一次「**正在执行中**的工具」（`RuntimeDTO.runningTools`），供手机端 UI 联调 / 单测。
+     *
+     * 与 `setToolProgress` 是一对（先后相接的两个阶段）：参数累积期看 `toolProgress`，
+     * 工具开始执行到结果回来之间看 `runningTools`。传 `null` = **跑完了**（一并把 `working` 收掉，
+     * 真机上工具跑完要么接着下一轮、要么整个 run 结束）；传空数组 = 这次执行中的工具都结束了，
+     * 但会话仍在跑（模型正在接着思考）。
+     *
+     * ⚠️ 真实电脑侧没有这个「手动口」：那些字段是 `store-bridge` 从会话消息（assistant 的
+     * `toolCalls[]` 减去已有结果）**推导**出来的（§27 的姊妹字段），mock 手推是为了让手机端
+     * 在**没有引擎**的情况下也能看到这一帧。
+     */
+    setRunningTools(sessionId: string, tools: RunningToolDTO[] | null): void;
+    /**
+     * 读一份**演示文件树**里的文件（测试 / harness 断言用）—— `null` = 不存在。
+     *
+     * 为什么需要：上传是否真的落到「正确的相对路径、正确的字节」只能从宿主侧看，
+     * 而手机端的 RPC 应答只说「成功了」。只测应答 = 测了个寂寞。
+     */
+    readMockFile(sessionId: string, relPath: string): Uint8Array | null;
+    /** 往演示文件树里放一个文件（建目录是隐式的）。 */
+    writeMockFile(sessionId: string, relPath: string, content: string | Uint8Array): void;
+    /** 当前文件树里的全部相对路径（排序后）。 */
+    listMockFiles(sessionId: string): string[];
+    /**
+     * 最后**真正执行**的那次压缩（`null` = 还没压过）—— 测试 / harness 观察口。
+     *
+     * 为什么需要：手机端的 RPC 应答只是一句 `{ok:true}`，它只说「电脑侧受理了」，**不说用了哪种方式**
+     * —— 而「选中了正文压缩却走了 AI 摘要（还花了钱）」正是这个参数最危险的失败形态。
+     */
+    lastCompress(): {
+        sessionId: string;
+        mode: CompressMode;
+    } | null;
 }
 export declare function createMockHostDataSource(options?: MockHostOptions): MockHostDataSource;
 //# sourceMappingURL=mock-host.d.ts.map

package/dist/testing/mock-host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mock-host.d.ts","sourceRoot":"","sources":["../../src/testing/mock-host.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAEhE,OAAO,KAAK,EAGV,YAAY,EAkBb,MAAM,iBAAiB,CAAA;AAGxB,MAAM,WAAW,eAAe;IAC9B,YAAY;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gBAAgB;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,sCAAsC;AACtC,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,QAAQ,GAAG,eAAe,CAAA;IACjC,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,YAAY,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;CACpC;AAED,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,iDAAiD;IACjD,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC1B,wCAAwC;IACxC,kBAAkB,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAAA;IACtD,mBAAmB;IACnB,mBAAmB,IAAI,MAAM,EAAE,CAAA;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAA;IACxB,gDAAgD;IAChD,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACpD;;;;;OAKG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GAAG,IAAI,CAAA;CAC3F;AAqBD,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,eAAoB,GAAG,kBAAkB,CA0kB1F"}
+{"version":3,"file":"mock-host.d.ts","sourceRoot":"","sources":["../../src/testing/mock-host.ts"],"names":[],"mappings":"AAyBA,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAA;AA2B7B,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAEhE,OAAO,KAAK,EAIV,YAAY,EA0BZ,cAAc,EAKf,MAAM,iBAAiB,CAAA;AAGxB,MAAM,WAAW,eAAe;IAC9B,YAAY;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gBAAgB;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;CAClC;AAED,sCAAsC;AACtC,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,QAAQ,GAAG,eAAe,CAAA;IACjC,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,YAAY,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;CACpC;AAED,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,iDAAiD;IACjD,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC1B,wCAAwC;IACxC,kBAAkB,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAAA;IACtD,mBAAmB;IACnB,mBAAmB,IAAI,MAAM,EAAE,CAAA;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAA;IACxB,gDAAgD;IAChD,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACpD;;;;;OAKG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GAAG,IAAI,CAAA;IAC1F;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,IAAI,GAAG,IAAI,CAAA;IACxE;;;;;OAKG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAA;IACnE,6BAA6B;IAC7B,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAA;IACrF,0BAA0B;IAC1B,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC1C;;;;;OAKG;IACH,YAAY,IAAI;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,YAAY,CAAA;KAAE,GAAG,IAAI,CAAA;CACjE;AA8HD,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,eAAoB,GAAG,kBAAkB,CA86B1F"}