virlen-remote 0.5.0 → 0.7.0

package/dist/protocol/message-files.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 手机端声明它 = **文件面板能给「引用」入口**，并能渲染 `MessageDTO.files` 的 chip。
+ * 电脑端列出它 = **本机认识 `SendParams.files` 与 `MessageDTO.files`**。
+ */
+export declare const MESSAGE_FILE_CAPABILITY = "message.file";
+/**
+ * 一条消息最多能带几个文件引用。
+ *
+ * 上限的意义有两层：① 超过之后模型也只是「看得到一堆路径」，边际收益为零；
+ * ② 它是**载荷上界**（每个引用都在消息里，且会随消息一起持久化 / 导出 / 重放）。
+ * 超限**拒整条**而不是截断：截断是静默的 —— 手机端的 chip 还在，用户会以为都带上了。
+ */
+export declare const MESSAGE_FILE_MAX = 20;
+/**
+ * 单个引用路径的长度上限（1024 字符）。
+ *
+ * 与 `MESSAGE_FILE_MAX` 同一条纪律：路径是**手机端给的字符串**，没有上界就等于允许
+ * 一个（有 bug 或被改写的）客户端把任意长的内容塞进消息里。正常路径远低于这个数
+ * （Windows 的 `MAX_PATH` 是 260）。
+ */
+export declare const MESSAGE_FILE_PATH_MAX = 1024;
+/**
+ * 一条**文件引用**（手机端 → 电脑端 → 引擎内容块）。
+ *
+ * ⚠️ 与 `MessageQuote` 不同，这里**不是快照**：存的是路径，AI 读的那一刻磁盘上是什么就是什么。
+ * 这正是「不搬运内容」的代价，也是它的好处（引用的永远是**当前**内容，不会拿一份过期副本
+ * 去回答）。桌面端的文件附件同此语义。
+ */
+export interface MessageFileRef {
+    /** 文件绝对路径（分隔符按契约统一为 `/`，见 `sanitizeFileRefs`）。 */
+    path: string;
+    /** 文件名（含扩展名）—— chip 上显示的就是它。 */
+    name: string;
+    /** 是否为目录（目录也能被引用：模型用 `list_files` 去看里面有什么）。 */
+    isDir?: boolean;
+    /** 字节数（目录没有这一项）。只用于展示，**不作为任何校验依据**（它不是文件的事实来源）。 */
+    size?: number;
+}
+/**
+ * 校验结果。
+ *
+ * ⚠️ **刻意不写成判别联合**（`| { ok: true; files } | { ok: false; reason }`）：
+ * 布尔字面量的判别联合靠 `strictNullChecks` 才能收窄，而消费方 `virlen-app` 的 tsconfig 是
+ * `strictNullChecks: false` —— 写成判别联合的话，电脑侧那句 `if (!r.ok) { …r.reason… }`
+ * 根本收窄不了（直接 `TS2339: Property 'reason' does not exist`）。契约放在共享包里，
+ * 就不能只在一边成立。
+ *
+ * 不变式：`ok === (reason === '')`（通过时 `reason` 是空串，`files` 是被归一化的引用；
+ * 被拒时 `files` 恒为空数组）。
+ */
+export interface FileRefSanitizeResult {
+    /** 是否通过校验。 */
+    ok: boolean;
+    /** 归一化后的引用；被拒时恒为空数组（调用方那时应该直接抛错）。 */
+    files: MessageFileRef[];
+    /** 被拒原因（可直接显示给用户）；通过时为空串。 */
+    reason: string;
+}
+/**
+ * 校验并归一化手机传来的文件引用（**电脑侧与演示宿主共用这一份**）。
+ *
+ * 规则：
+ *  - 缺省 / `null` → 空数组（不带文件引用是完全正常的一条消息）；
+ *  - 不是数组 / 条目不是对象 / `path` 不是非空字符串 → **整条拒**（返回 `ok:false`）；
+ *  - 路径超过 `MESSAGE_FILE_PATH_MAX`、条目数超过 `MESSAGE_FILE_MAX` → 整条拒；
+ *  - `name` 缺失或为空 → 用路径末段兜底（电脑侧从内容块投影回来时也会用到这条）；
+ *  - `isDir` / `size` 形状不对 → **丢掉该字段**（它们是展示元数据，说谎也只是 chip 上少一行字），
+ *    但路径非法必须拒 —— 那是这条引用**唯一有语义的部分**。
+ *  - 路径分隔符 `\` → `/`（与全项目的路径口径一致，两侧拼串才不会出现 `a\/b`）；
+ *  - 同一路径只保留第一次出现的（手机端连点两下不该变成两条引用）。
+ *
+ * ## 为什么非法就整条拒（而不是「丢掉那一条、其余照发」）
+ *
+ * §36 的教训：**假绿灯比报错难查得多**。丢掉一条引用时，手机端那边的 chip 还在输入框里、
+ * 发完消息里也有它 —— 用户会以为带上了，而 AI 从未看到。拒掉整条之后，用户看到的是
+ * 一条明确的失败提示，芯片还在，可以改完再发。
+ */
+export declare function sanitizeFileRefs(input: unknown): FileRefSanitizeResult;
+//# sourceMappingURL=message-files.d.ts.map

package/dist/protocol/message-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-files.d.ts","sourceRoot":"","sources":["../../src/protocol/message-files.ts"],"names":[],"mappings":"AAiCA;;;GAGG;AACH,eAAO,MAAM,uBAAuB,iBAAiB,CAAA;AAErD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAElC;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,OAAO,CAAA;AAEzC;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAA;IACZ,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,+CAA+C;IAC/C,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,qBAAqB;IACpC,cAAc;IACd,EAAE,EAAE,OAAO,CAAA;IACX,qCAAqC;IACrC,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,CAuCtE"}

package/dist/protocol/message-files.js

@@ -0,0 +1,118 @@
+/**
+ * 消息里的**文件引用** —— **两端共用的契约**：能力名 + 引用体 + 校验口径。
+ *
+ * ## 这是什么（与桌面输入框的「文件附件」同一条口径）
+ *
+ * 手机端在文件面板里挑一个电脑上的文件，把它的**路径 + 展示元数据**挂到要发的那条消息上；
+ * 电脑端把它组装成 `{type:'file'}` 内容块交给引擎。**不搬运文件内容** ——
+ * 真正的读取交给 AI 用 `read_file` 工具按需完成（桌面端 `FileAttachment` 的文件头
+ * 写着同一条：「只存路径，不拷贝文件内容」）。
+ *
+ * ## 为什么必须放在共享包里
+ *
+ * 与 §36 的引用（`message-actions.ts`）同一条理由：它是**两端各表一半**的约定 ——
+ * 手机端发 `SendParams.files` 并把 `MessageDTO.files` 渲染成 chip，电脑端把前者组装成内容块、
+ * 把后者投影出来。字段名（`path` / `isDir` / `size`）与「路径分隔符统一成 `/`」的归一化
+ * 各写一份必然漂移，而漂移的症状是**静默的**：元数据对不上时 chip 显示成另一个东西，
+ * 没有任何报错可查。
+ *
+ * ## 校验为什么也在这里（而不是电脑侧自己写一份）
+ *
+ * `sanitizeFileRefs` 是**两端唯一的校验口径**：真电脑侧（`virlen-app/src/bridge/host-source.ts`）
+ * 与演示宿主（`testing/mock-host.ts`）都调它。若各写一份，mock 与真机会在「什么样的 `files`
+ * 算非法」上分叉 —— 而 mock 是单测的唯一参照物，分叉等于测试对着假行为发绿灯。
+ *
+ * ## 能力位的语义（与 §36 的 `MESSAGE_QUOTE_CAPABILITY` 一致）
+ *
+ * `MESSAGE_FILE_CAPABILITY` 是**功能标记**，不是权限：文件引用本身就是 `session.send` 的一个
+ * 参数（越权防线仍是 ACL 里的 `session.send`）。写进本表只为让手机端知道
+ * 「本机电脑端认识 `files`」—— 旧电脑端会把未知字段**静默丢掉**，用户侧的表现是
+ * 「我明明附了文件，AI 却当没看见」，且没有任何报错可查。宁可对旧电脑端不显示这个入口。
+ */
+import { FILE_NAME_MAX_LEN } from './files.js';
+/**
+ * 手机端声明它 = **文件面板能给「引用」入口**，并能渲染 `MessageDTO.files` 的 chip。
+ * 电脑端列出它 = **本机认识 `SendParams.files` 与 `MessageDTO.files`**。
+ */
+export const MESSAGE_FILE_CAPABILITY = 'message.file';
+/**
+ * 一条消息最多能带几个文件引用。
+ *
+ * 上限的意义有两层：① 超过之后模型也只是「看得到一堆路径」，边际收益为零；
+ * ② 它是**载荷上界**（每个引用都在消息里，且会随消息一起持久化 / 导出 / 重放）。
+ * 超限**拒整条**而不是截断：截断是静默的 —— 手机端的 chip 还在，用户会以为都带上了。
+ */
+export const MESSAGE_FILE_MAX = 20;
+/**
+ * 单个引用路径的长度上限（1024 字符）。
+ *
+ * 与 `MESSAGE_FILE_MAX` 同一条纪律：路径是**手机端给的字符串**，没有上界就等于允许
+ * 一个（有 bug 或被改写的）客户端把任意长的内容塞进消息里。正常路径远低于这个数
+ * （Windows 的 `MAX_PATH` 是 260）。
+ */
+export const MESSAGE_FILE_PATH_MAX = 1024;
+/**
+ * 校验并归一化手机传来的文件引用（**电脑侧与演示宿主共用这一份**）。
+ *
+ * 规则：
+ *  - 缺省 / `null` → 空数组（不带文件引用是完全正常的一条消息）；
+ *  - 不是数组 / 条目不是对象 / `path` 不是非空字符串 → **整条拒**（返回 `ok:false`）；
+ *  - 路径超过 `MESSAGE_FILE_PATH_MAX`、条目数超过 `MESSAGE_FILE_MAX` → 整条拒；
+ *  - `name` 缺失或为空 → 用路径末段兜底（电脑侧从内容块投影回来时也会用到这条）；
+ *  - `isDir` / `size` 形状不对 → **丢掉该字段**（它们是展示元数据，说谎也只是 chip 上少一行字），
+ *    但路径非法必须拒 —— 那是这条引用**唯一有语义的部分**。
+ *  - 路径分隔符 `\` → `/`（与全项目的路径口径一致，两侧拼串才不会出现 `a\/b`）；
+ *  - 同一路径只保留第一次出现的（手机端连点两下不该变成两条引用）。
+ *
+ * ## 为什么非法就整条拒（而不是「丢掉那一条、其余照发」）
+ *
+ * §36 的教训：**假绿灯比报错难查得多**。丢掉一条引用时，手机端那边的 chip 还在输入框里、
+ * 发完消息里也有它 —— 用户会以为带上了，而 AI 从未看到。拒掉整条之后，用户看到的是
+ * 一条明确的失败提示，芯片还在，可以改完再发。
+ */
+export function sanitizeFileRefs(input) {
+    /** 被拒（`files` 恒为空数组 —— 失败就是**整条**失败，没有「部分成功」这个态） */
+    const reject = (reason) => ({ ok: false, files: [], reason });
+    if (input == null)
+        return { ok: true, files: [], reason: '' };
+    if (!Array.isArray(input))
+        return reject('文件引用的形状不对');
+    if (input.length > MESSAGE_FILE_MAX) {
+        return reject(`一次最多引用 ${MESSAGE_FILE_MAX} 个文件`);
+    }
+    const files = [];
+    const seen = new Set();
+    for (const raw of input) {
+        if (typeof raw !== 'object' || raw === null) {
+            return reject('文件引用的形状不对');
+        }
+        const item = raw;
+        if (typeof item.path !== 'string' || !item.path.trim()) {
+            return reject('文件引用缺少路径');
+        }
+        // 归一化分隔符：`E:\a\b` → `E:/a/b`（与 `normalizeWorkspace` / 文件面板同一口径）
+        const path = item.path.replace(/\\/g, '/');
+        if (path.length > MESSAGE_FILE_PATH_MAX) {
+            return reject('文件路径过长');
+        }
+        if (seen.has(path))
+            continue;
+        seen.add(path);
+        const name = typeof item.name === 'string' ? item.name.trim() : '';
+        files.push({
+            path,
+            name: (name || baseName(path)).slice(0, FILE_NAME_MAX_LEN),
+            ...(typeof item.isDir === 'boolean' ? { isDir: item.isDir } : {}),
+            ...(typeof item.size === 'number' && Number.isFinite(item.size) && item.size >= 0
+                ? { size: item.size }
+                : {}),
+        });
+    }
+    return { ok: true, files, reason: '' };
+}
+/** 路径末段（`name` 缺失时的兜底；本地实现以免把 `protocol/files` 的整套路径工具拖进来）。 */
+function baseName(path) {
+    const parts = path.replace(/\/+$/, '').split('/');
+    return parts[parts.length - 1] || path;
+}
+//# sourceMappingURL=message-files.js.map

package/dist/protocol/message-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-files.js","sourceRoot":"","sources":["../../src/protocol/message-files.ts"],"names":[],"mappings":"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"}

package/dist/protocol/tool-args.d.ts

@@ -0,0 +1,95 @@
+/**
+ * 工具入参摘要 —— 「这一步工具到底在干什么」的**唯一格式化口径**。
+ *
+ * 为什么单列一个模块：手机屏上一行只放得下一步工具调用，而**哪几个键才是关键入参**是随
+ * 工具而变的（`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 declare const TOOL_ARGS_MAX = 160;
+export interface ToolArgsSummaryOptions {
+    /**
+     * 路径缩短回调（电脑侧传 `toShortPath(path, workspace)`，与桌面卡片同一口径）。
+     * 不传 = 原样显示 —— 演示宿主 / 单测不需要工作目录上下文。
+     */
+    shortenPath?: (path: string) => string;
+    /** 摘要上限，默认 {@link TOOL_ARGS_MAX}。 */
+    maxLength?: number;
+}
+/**
+ * 生成一行入参摘要；没有可显示的内容时返回 `undefined`。
+ *
+ * 未知工具走兜底键序；一个都不命中时用「键=值」拼（最多两个键）——那是桌面
+ * `DefaultMessage` 的行为，手机端不需要比它更聪明，但需要至少能看出「调了什么」。
+ */
+export declare function summarizeToolArgs(name: string, input: unknown, options?: ToolArgsSummaryOptions): string | undefined;
+/**
+ * **展开区**文本的长度上限 —— 入参详情与工具输出**共用同一条线**。
+ *
+ * 与 {@link TOOL_ARGS_MAX} 不是一个量级，也不是一回事：那个是**折叠态一行**能放下多少字，
+ * 这个是**展开后**愿意渲染多少字（用户 2026-10 拍板：超了就中间省略）。
+ *
+ * 为什么是 5000：手机一屏约 30 行 × 40 字，5000 字符已是四屏以上；再长就不叫「看」，
+ * 叫「拖着滚」—— 而拖动过程中真正需要的信息（开头在做什么、结尾成没成）都在两头，
+ * 中间那段从来没人读完过。
+ */
+export declare const TOOL_DETAIL_MAX = 5000;
+/**
+ * 中间省略 —— 头尾都留，挖掉中间。
+ *
+ * 为什么不「从尾部截断」：工具输出与入参的**结论都在两头** —— 开头是命令 / 标题 / 第一个
+ * 文件，结尾是报错 / 汇总 / 最后一个 diff 块。只留头等于把结论切掉，用户还得回电脑前看。
+ *
+ * ⚠️ 被省略的字符数写进正文里（`…（中间省略 N 字符）…`）——这是「这里少了东西」的
+ * **唯一凭证**：只看长度看不出来，一段刚好的 5000 字符与被砍过的 5000 字符无法区分。
+ */
+export declare function elideMiddle(text: string, max?: number): string;
+/**
+ * {@link formatToolArgs} 的可选项 —— 与 {@link ToolArgsSummaryOptions} 是同一种上下文。
+ */
+export interface ToolArgsFormatOptions {
+    /**
+     * 路径缩短回调（电脑侧传 `toShortPath(path, workspace)`）。
+     *
+     * ⚠️ 必须与 {@link summarizeToolArgs} 传的是**同一个**回调：折叠态显示 `src/a.ts`、
+     * 展开后变成 `E:/code/demo/src/a.ts`，用户会以为点开卡片改坏了什么。
+     */
+    shortenPath?: (path: string) => string;
+    /** 上限，默认 {@link TOOL_DETAIL_MAX}（超出中间省略）。 */
+    maxLength?: number;
+}
+/**
+ * 工具入参的**完整文本**（展开区用）：两空格缩进的 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 declare function formatToolArgs(input: unknown, options?: ToolArgsFormatOptions): string | undefined;
+//# sourceMappingURL=tool-args.d.ts.map

package/dist/protocol/tool-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-args.d.ts","sourceRoot":"","sources":["../../src/protocol/tool-args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,0CAA0C;AAC1C,eAAO,MAAM,aAAa,MAAM,CAAA;AAgDhC,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IACtC,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,sBAA2B,GACnC,MAAM,GAAG,SAAS,CAiBpB;AAiOD;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,OAAO,CAAA;AAEnC;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAwB,GAAG,MAAM,CAW/E;AASD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IACtC,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,qBAA0B,GAClC,MAAM,GAAG,SAAS,CAWpB"}