nolo-cli 0.1.31 → 0.1.32

package/ai/tools/applyEditTool.ts

@@ -1,259 +0,0 @@
-import { bumpDevReloadSuppressIfSelfEditing } from "./devReloadUtils";
-import { buildToolRequestHeaders, getToolBaseUrl } from "./toolApiClient";
-
-type EditMatchOptions = {
-    occurrence?: number;
-    expectedMatches?: number;
-    replaceAll?: boolean;
-};
-
-export type ApplyEdit =
-    | (EditMatchOptions & {
-        type: "replace";
-        oldText: string;
-        newText: string;
-    })
-    | (EditMatchOptions & {
-        type: "insertBefore";
-        anchor: string;
-        content: string;
-    })
-    | (EditMatchOptions & {
-        type: "insertAfter";
-        anchor: string;
-        content: string;
-    })
-    | (EditMatchOptions & {
-        type: "delete";
-        oldText: string;
-    });
-
-export type ApplyEditArgs = {
-    filePath: string;
-    edits: ApplyEdit[];
-};
-
-export const applyEditFunctionSchema = {
-    name: "applyEdit",
-    description: [
-        "推荐默认使用的代码编辑工具：基于“精确文本片段”而不是行号进行局部修改。",
-        "",
-        "适用场景：",
-        "- 替换一个已知的唯一代码片段。",
-        "- 在某个唯一锚点片段之前或之后插入代码。",
-        "- 删除一个精确可定位的片段。",
-        "",
-        "推荐工作流：",
-        "- 先用 codeSearch 找文件或搜索代码；",
-        "- 再用 readFile 读取最新内容；",
-        "- 如果这次修改依赖用户给的 URL / 文档页，先用 fetchWebpage 或其它网页工具抓取真值，再编辑；",
-        "- 直接把 readFile 中复制出的精确片段作为 oldText / anchor 传入。",
-        "- 对从网页提取出的价格、上下文窗口、能力字段，按抓到的原值写入，不要凭记忆改写。",
-        "",
-        "准确率约定：",
-        "- 默认要求片段在文件中只匹配 1 次；",
-        "- 若匹配多次，会直接报错，要求你补更多上下文、设置 occurrence，或显式 replaceAll；",
-        "- replaceAll 只会在你显式传 replaceAll=true 时执行；",
-        "- 可用 expectedMatches 断言匹配数量，进一步防止误改。",
-        "",
-        "返回数据约定（rawData.response 中）：",
-        "- newContent：编辑后的完整文件内容（统一使用 \\n）。",
-        "- diff：基于原始内容与 newContent 的行级 diff。",
-        "- appliedEdits：每个 edit 的匹配次数与实际应用次数。",
-        "",
-        "注意：",
-        "- filePath 必须是相对项目根目录（bun-nolo）的路径。",
-        "- 优先用 applyEdit 做最小局部修改；只有确实无法用精确片段表达时，再考虑 applyLineEdits 或整文件覆盖。",
-    ].join("\n"),
-    parameters: {
-        type: "object",
-        properties: {
-            filePath: {
-                type: "string",
-                description:
-                    "要修改的文件相对项目根目录（bun-nolo）的路径，例如: packages/server/routes.ts",
-            },
-            edits: {
-                type: "array",
-                description:
-                    "要按顺序应用的一组精确片段编辑。后一个 edit 会基于前一个 edit 应用后的最新文本继续执行。",
-                items: {
-                    type: "object",
-                    oneOf: [
-                        {
-                            properties: {
-                                type: { const: "replace" },
-                                oldText: {
-                                    type: "string",
-                                    description: "要被替换的精确原始片段。",
-                                },
-                                newText: {
-                                    type: "string",
-                                    description: "替换后的新片段。",
-                                },
-                                occurrence: {
-                                    type: "number",
-                                    description: "可选：当 oldText 匹配多次时，替换第几次匹配（1-based）。",
-                                },
-                                expectedMatches: {
-                                    type: "number",
-                                    description: "可选：断言 oldText 总共应匹配多少次。",
-                                },
-                                replaceAll: {
-                                    type: "boolean",
-                                    description: "可选：为 true 时替换所有匹配项。",
-                                },
-                            },
-                            required: ["type", "oldText", "newText"],
-                        },
-                        {
-                            properties: {
-                                type: { const: "insertBefore" },
-                                anchor: {
-                                    type: "string",
-                                    description: "作为插入锚点的精确原始片段。",
-                                },
-                                content: {
-                                    type: "string",
-                                    description: "要插入到锚点之前的文本。",
-                                },
-                                occurrence: {
-                                    type: "number",
-                                    description: "可选：当 anchor 匹配多次时，插入到第几次匹配之前（1-based）。",
-                                },
-                                expectedMatches: {
-                                    type: "number",
-                                    description: "可选：断言 anchor 总共应匹配多少次。",
-                                },
-                                replaceAll: {
-                                    type: "boolean",
-                                    description: "可选：为 true 时，对所有匹配锚点都执行插入。",
-                                },
-                            },
-                            required: ["type", "anchor", "content"],
-                        },
-                        {
-                            properties: {
-                                type: { const: "insertAfter" },
-                                anchor: {
-                                    type: "string",
-                                    description: "作为插入锚点的精确原始片段。",
-                                },
-                                content: {
-                                    type: "string",
-                                    description: "要插入到锚点之后的文本。",
-                                },
-                                occurrence: {
-                                    type: "number",
-                                    description: "可选：当 anchor 匹配多次时，插入到第几次匹配之后（1-based）。",
-                                },
-                                expectedMatches: {
-                                    type: "number",
-                                    description: "可选：断言 anchor 总共应匹配多少次。",
-                                },
-                                replaceAll: {
-                                    type: "boolean",
-                                    description: "可选：为 true 时，对所有匹配锚点都执行插入。",
-                                },
-                            },
-                            required: ["type", "anchor", "content"],
-                        },
-                        {
-                            properties: {
-                                type: { const: "delete" },
-                                oldText: {
-                                    type: "string",
-                                    description: "要删除的精确原始片段。",
-                                },
-                                occurrence: {
-                                    type: "number",
-                                    description: "可选：当 oldText 匹配多次时，删除第几次匹配（1-based）。",
-                                },
-                                expectedMatches: {
-                                    type: "number",
-                                    description: "可选：断言 oldText 总共应匹配多少次。",
-                                },
-                                replaceAll: {
-                                    type: "boolean",
-                                    description: "可选：为 true 时删除所有匹配项。",
-                                },
-                            },
-                            required: ["type", "oldText"],
-                        },
-                    ],
-                },
-            },
-        },
-        required: ["filePath", "edits"],
-    },
-};
-
-function assertValidArgs(args: ApplyEditArgs): void {
-    if (!args.filePath || typeof args.filePath !== "string") {
-        throw new Error("应用代码编辑失败：必须提供有效的 filePath 字符串。");
-    }
-    if (!Array.isArray(args.edits) || args.edits.length === 0) {
-        throw new Error("应用代码编辑失败：edits 必须是非空数组。");
-    }
-}
-
-export async function applyEditFunc(
-    args: ApplyEditArgs,
-    thunkApi: any,
-    context?: { parentMessageId?: string; signal?: AbortSignal; agentKey?: string }
-): Promise<{ rawData: any; displayData?: string }> {
-    assertValidArgs(args);
-
-    const { filePath, edits } = args;
-    bumpDevReloadSuppressIfSelfEditing(filePath);
-
-    try {
-        const baseUrl = getToolBaseUrl(thunkApi);
-
-        if (!baseUrl) {
-            throw new Error("应用代码编辑失败：无法获取 applyEdit 服务器地址。");
-        }
-
-        const apiUrl = `${baseUrl.replace(/\/+$/, "")}/api/apply-edit`;
-        const response = await fetch(apiUrl, {
-            method: "POST",
-            headers: buildToolRequestHeaders(thunkApi, {
-                withAuth: true,
-                agentKey: context?.agentKey,
-            }),
-            signal: context?.signal,
-            body: JSON.stringify({ filePath, edits }),
-        });
-
-        const textBody = await response.text();
-        let data: any = {};
-        try {
-            data = textBody ? JSON.parse(textBody) : {};
-        } catch {
-            // ignore JSON parse error
-        }
-
-        if (!response.ok || data?.error) {
-            const errMsg =
-                data?.error ||
-                `applyEdit API 请求失败，状态码: ${response.status}. 响应: ${textBody}`;
-            console.error("applyEdit API Error:", errMsg);
-            throw new Error(errMsg);
-        }
-
-        return {
-            rawData: {
-                applied: true,
-                filePath,
-                editCount: edits.length,
-                response: data,
-            },
-            displayData: `✅ 已成功对文件应用 ${edits.length} 个精确片段编辑: ${filePath}`,
-        };
-    } catch (error: any) {
-        console.error("执行 applyEdit 时发生错误:", error);
-        throw new Error(
-            `应用代码编辑到文件 (${filePath}) 失败：${error?.message || String(error)}`
-        );
-    }
-}

package/ai/tools/applyLineEditsTool.ts

@@ -1,315 +0,0 @@
-// 文件路径: packages/ai/tools/applyLineEditsTool.ts
-
-import { bumpDevReloadSuppressIfSelfEditing } from "./devReloadUtils";
-import { buildToolRequestHeaders, getToolBaseUrl } from "./toolApiClient";
-
-// ---- Types ----
-
-/**
- * 提高编辑成功率用的公共字段：
- * - 建议 LLM 在规划编辑前先调用 readFile 获取最新内容；
- * - 然后把“将要修改的那几行原始代码”（用 \n 拼接）复制到 originalSnippet。
- *
- * 后端会把行号当作“粗定位”，再结合 originalSnippet 在附近搜索精确位置，
- * 这样即使行号有轻微偏差，也有很大概率能对齐到正确位置再修改，而不是直接失败。
- */
-export type LineEditCommon = {
-    /**
-     * 可选：LLM 看到的原始代码片段。
-     *
-     * 用法建议：
-     * - replaceRange / deleteRange：
-     *   把 startLine~endLine 对应的原始行文本（用 \n 拼接）原样复制到 originalSnippet。
-     * - insertBefore / insertAfter：
-     *   把插入点附近的一行原始代码（通常是当前这一行）复制到 originalSnippet。
-     *
-     * 行为说明：
-     * - 后端会先按行号找到大致区域；
-     * - 若提供了 originalSnippet，会在该区域附近优先搜索同样的片段；
-     * - 若找到，就以搜索结果为准自动修正编辑位置；
-     * - 若找不到，则退化为按行号硬改（与旧行为一致），不会因此额外报错。
-     */
-    originalSnippet?: string;
-};
-
-export type LineEdit =
-    | (LineEditCommon & {
-        type: "replaceRange";
-        /**
-         * 期望被替换的起始、结束行（包含），1-based。
-         * 实际应用时，后端会以此为“粗定位”，并结合 originalSnippet 做精确对齐。
-         */
-        startLine: number;
-        endLine: number;
-        /**
-         * 用于替换这段行区间的新文本（可以是多行或空字符串）。
-         * 文本内部按 \n 分行。
-         */
-        replacement: string;
-    })
-    | (LineEditCommon & {
-        type: "insertBefore";
-        /**
-         * 在第 line 行“之前”插入 content。
-         * 1 <= line <= 文件总行数 + 1；
-         * 当 line === 文件总行数 + 1 时，相当于在文件尾部追加。
-         *
-         * 实际应用时，后端会把此行号作为插入点“粗定位”，
-         * 并优先尝试在附近用 originalSnippet 微调到更精确的位置。
-         */
-        line: number;
-        content: string;
-    })
-    | (LineEditCommon & {
-        type: "insertAfter";
-        /**
-         * 在第 line 行“之后”插入 content。
-         * 1 <= line <= 文件总行数；
-         * 若 line > 文件总行数，会退化为在文件尾部追加。
-         *
-         * 实际应用时，后端会把此行号作为插入点“粗定位”，
-         * 并优先尝试在附近用 originalSnippet 微调到更精确的位置。
-         */
-        line: number;
-        content: string;
-    })
-    | (LineEditCommon & {
-        type: "deleteRange";
-        /**
-         * 期望删除的起始行、结束行（包含），1-based。
-         * 实际应用时，后端会以此为“粗定位”，并结合 originalSnippet 做精确对齐。
-         */
-        startLine: number;
-        endLine: number;
-    });
-
-export type ApplyLineEditsArgs = {
-    filePath: string;
-    edits: LineEdit[];
-};
-
-// ---- 工具 Schema，供 LLM 调用 ----
-
-export const applyLineEditsFunctionSchema = {
-    name: "applyLineEdits",
-    description: [
-        "对指定文件按“行号”执行一组精确的文本编辑操作，而不是整文件重写。",
-        "",
-        "适用场景：",
-        "- 替换某个连续的行区间（一个函数体、一段 JSX 区块等）。",
-        "- 在某一行之前或之后插入若干行代码。",
-        "- 删除一段连续的行。",
-        "",
-        "约定：",
-        "- 所有行号均为 1-based（第一行为 1）。",
-        "- 建议一次调用只包含 1 个 edit；多个 edit 会顺序依次应用，后续 edit 的行号基于前一个 edit 应用后的结果。",
-        "",
-        "为了在行号有轻微偏差的情况下仍然成功修改，推荐同时提供 originalSnippet：",
-        "- 在规划编辑前，请先调用 readFile 工具获取最新的文件内容和行号信息。",
-        "- 若 readFile 使用了 startLine/endLine 只返回局部内容：",
-        "  - lines[0] 对应的真实行号为 lineOffset；",
-        "  - 计算 startLine/endLine 时需用 lineOffset + index。",
-        "- 对 replaceRange / deleteRange：",
-        "  - 在 readFile 返回的 lines 中，取出 startLine~endLine 对应的原始行文本，用 \\n 拼接后放入 originalSnippet。",
-        "- 对 insertBefore / insertAfter：",
-        "  - 取插入点附近的一行原始代码文本（通常是插入点当前这一行），放入 originalSnippet。",
-        "- 后端会：",
-        "  - 将传入的行号视为“粗定位”；",
-        "  - 然后在该行号附近优先搜索 originalSnippet；",
-        "  - 若找到，就以搜索结果为准自动修正编辑位置，从而提高成功率；",
-        "  - 若找不到，则退化为按行号硬改（与旧行为一致），不会因为 snippet 不匹配而额外报错。",
-        "",
-        "返回数据约定（rawData.response 中）：",
-        "- newContent：应用行级编辑后的完整文件内容（统一使用 \\n 作为换行符），用于“最终文件预览”。",
-        "- diff：基于原始内容与 newContent 的行级 diff（diffLines 结果），用于 UI 中的 Diff 视图。",
-    ].join("\n"),
-    parameters: {
-        type: "object",
-        properties: {
-            filePath: {
-                type: "string",
-                description:
-                    "要修改的文件相对项目根目录（bun-nolo）的路径，例如: packages/chat/src/messages/web/ToolMessageContent.tsx",
-            },
-            edits: {
-                type: "array",
-                description:
-                    "要按顺序应用的一系列行级编辑操作。建议一次只传一个 edit，减少行号偏移带来的复杂性。",
-                items: {
-                    type: "object",
-                    oneOf: [
-                        {
-                            properties: {
-                                type: { const: "replaceRange" },
-                                startLine: {
-                                    type: "number",
-                                    description:
-                                        "期望被替换的起始行（包含），1-based。",
-                                },
-                                endLine: {
-                                    type: "number",
-                                    description:
-                                        "期望被替换的结束行（包含），1-based，必须 >= startLine。",
-                                },
-                                replacement: {
-                                    type: "string",
-                                    description:
-                                        "用于替换这段行区间的新文本（可以是多行或空字符串）。文本内部按 \\n 分行。",
-                                },
-                                originalSnippet: {
-                                    type: "string",
-                                    description:
-                                        "可选但强烈建议：startLine~endLine 对应的原始代码片段（用 \\n 拼接）。后端会优先在该行区附近搜索这段文本，并在行号略有偏差时自动对齐后再应用替换，从而大幅提高成功率。",
-                                },
-                            },
-                            required: ["type", "startLine", "endLine", "replacement"],
-                        },
-                        {
-                            properties: {
-                                type: { const: "insertBefore" },
-                                line: {
-                                    type: "number",
-                                    description:
-                                        "在第 line 行“之前”插入 content。1 <= line <= 文件总行数 + 1。",
-                                },
-                                content: {
-                                    type: "string",
-                                    description:
-                                        "要插入的文本（可以是多行），文本内部按 \\n 分行。",
-                                },
-                                originalSnippet: {
-                                    type: "string",
-                                    description:
-                                        "可选：插入点附近的一行原始代码文本（通常是当前第 line 行）。后端会在该行号附近优先搜索这行文本，在有轻微行号偏移时，仍然能找到合理的插入位置。",
-                                },
-                            },
-                            required: ["type", "line", "content"],
-                        },
-                        {
-                            properties: {
-                                type: { const: "insertAfter" },
-                                line: {
-                                    type: "number",
-                                    description:
-                                        "在第 line 行“之后”插入 content。1 <= line <= 文件总行数。",
-                                },
-                                content: {
-                                    type: "string",
-                                    description:
-                                        "要插入的文本（可以是多行），文本内部按 \\n 分行。",
-                                },
-                                originalSnippet: {
-                                    type: "string",
-                                    description:
-                                        "可选：插入点附近的一行原始代码文本（通常是当前第 line 行）。后端会在该行号附近优先搜索这行文本，在有轻微行号偏移时，仍然能找到合理的插入位置。",
-                                },
-                            },
-                            required: ["type", "line", "content"],
-                        },
-                        {
-                            properties: {
-                                type: { const: "deleteRange" },
-                                startLine: {
-                                    type: "number",
-                                    description:
-                                        "期望删除的起始行（包含），1-based。",
-                                },
-                                endLine: {
-                                    type: "number",
-                                    description:
-                                        "期望删除的结束行（包含），1-based，必须 >= startLine。",
-                                },
-                                originalSnippet: {
-                                    type: "string",
-                                    description:
-                                        "可选但建议：startLine~endLine 对应的原始代码片段（用 \\n 拼接）。后端会优先在该行区附近搜索这段文本，在行号略有偏差时自动对齐后再执行删除，减少误删风险且提高成功率。",
-                                },
-                            },
-                            required: ["type", "startLine", "endLine"],
-                        },
-                    ],
-                },
-            },
-        },
-        required: ["filePath", "edits"],
-    },
-};
-
-// ---- 参数校验 ----
-
-function assertValidArgs(args: ApplyLineEditsArgs): void {
-    const { filePath, edits } = args;
-
-    if (!filePath || typeof filePath !== "string") {
-        throw new Error("应用行级代码编辑失败：必须提供有效的 filePath 字符串。");
-    }
-    if (!Array.isArray(edits) || edits.length === 0) {
-        throw new Error("应用行级代码编辑失败：edits 必须是非空数组。");
-    }
-}
-
-// ---- 真正执行 ----
-
-export async function applyLineEditsFunc(
-    args: ApplyLineEditsArgs,
-    thunkApi: any,
-    context?: { parentMessageId?: string; signal?: AbortSignal; agentKey?: string }
-): Promise<{ rawData: any; displayData?: string }> {
-    assertValidArgs(args);
-
-    const { filePath, edits } = args;
-
-    bumpDevReloadSuppressIfSelfEditing(filePath);
-
-    try {
-        const baseUrl = getToolBaseUrl(thunkApi);
-
-        if (!baseUrl) {
-            throw new Error("应用行级代码编辑失败：无法获取 applyLineEdits 服务器地址。");
-        }
-
-        const apiUrl = `${baseUrl.replace(/\/+$/, "")}/api/apply-line-edits`;
-
-        const response = await fetch(apiUrl, {
-            method: "POST",
-            headers: buildToolRequestHeaders(thunkApi, {
-                withAuth: true,
-                agentKey: context?.agentKey,
-            }),
-            signal: context?.signal,
-            body: JSON.stringify({ filePath, edits }),
-        });
-
-        const textBody = await response.text();
-        let data: any = {};
-        try {
-            data = textBody ? JSON.parse(textBody) : {};
-        } catch {
-            // ignore JSON parse error
-        }
-
-        if (!response.ok || data?.error) {
-            const errMsg =
-                data?.error ||
-                `applyLineEdits API 请求失败，状态码: ${response.status}. 响应: ${textBody}`;
-            console.error("applyLineEdits API Error:", errMsg);
-            throw new Error(errMsg);
-        }
-
-        return {
-            rawData: {
-                applied: true,
-                filePath,
-                editCount: edits.length,
-                response: data,
-            },
-            displayData: `✅ 已成功对文件应用 ${edits.length} 个行级编辑操作: ${filePath}`,
-        };
-    } catch (error: any) {
-        console.error("执行 applyLineEdits 时发生错误:", error);
-        throw new Error(
-            `应用行级代码编辑到文件 (${filePath}) 失败：${error?.message || String(error)
-            }`
-        );
-    }
-}

package/ai/tools/browserTools/click.ts

@@ -1,33 +0,0 @@
-
-import { executeBrowserTool } from "./common";
-
-export const browser_click_Schema = {
-    name: "browser_click",
-    description:
-        "在当前浏览器会话中，点击匹配指定 CSS 选择器的元素。",
-    parameters: {
-        type: "object",
-        properties: {
-            sessionId: {
-                type: "string",
-                description: "由 browser_openSession 返回的活跃会话 ID。",
-            },
-            selector: {
-                type: "string",
-                description: "要点击元素的 CSS 选择器 (例如 '#submit-btn', '.nav-link').",
-            },
-        },
-        required: ["sessionId", "selector"],
-    },
-};
-
-export async function browser_click_Func(
-    args: { sessionId: string; selector: string },
-    thunkApi: any
-) {
-    const result = await executeBrowserTool("browser_click", args, thunkApi);
-    return {
-        rawData: result,
-        displayData: `✅ 已点击元素: \`${args.selector}\``,
-    };
-}

package/ai/tools/browserTools/closeSession.ts

@@ -1,29 +0,0 @@
-import { executeBrowserTool } from "./common";
-
-export const browser_closeSession_Schema = {
-  name: "browser_closeSession",
-  description:
-    "关闭一个已有的浏览器会话并释放服务器上的浏览器槽位。完成页面操作后应尽快调用。",
-  parameters: {
-    type: "object",
-    properties: {
-      sessionId: {
-        type: "string",
-        description: "由 browser_openSession 返回的活跃会话 ID。",
-      },
-    },
-    required: ["sessionId"],
-  },
-};
-
-export async function browser_closeSession_Func(
-  args: { sessionId: string },
-  thunkApi: any
-) {
-  const result = await executeBrowserTool("browser_closeSession", args, thunkApi);
-
-  return {
-    rawData: result.status,
-    displayData: `✅ 已关闭浏览器会话 ${args.sessionId}。`,
-  };
-}

package/ai/tools/browserTools/common.ts

@@ -1,27 +0,0 @@
-import { callToolApi } from "../toolApiClient";
-
-/**
- * 调用统一的后端浏览器工具API端点。
- * @param toolName - 要调用的工具名称 (例如 'browser_openSession')。
- * @param parameters - 传递给工具的参数。
- * @param thunkApi - Redux Thunk API。
- * @returns 后端返回的执行结果。
- */
-export async function executeBrowserTool(
-  toolName: string,
-  parameters: any,
-  thunkApi: any
-): Promise<any> {
-  try {
-    const result = await callToolApi<{ data: any }>(
-      thunkApi,
-      "/api/browser-tool",
-      { toolName, params: parameters },
-      { withAuth: true }
-    );
-    return result.data;
-  } catch (error: any) {
-    console.error(`执行浏览器工具 '${toolName}' 时发生网络或解析错误:`, error);
-    throw new Error(`浏览器工具 '${toolName}' 失败: ${error.message}`);
-  }
-}