aws-runtime-bridge 1.9.78 → 1.9.80

package/package/acode/dist/built-in-file-tools.js

@@ -1,966 +1,4 @@
-import { randomUUID } from "node:crypto";
-import { promises as fs, createReadStream } from "node:fs";
-import path from "node:path";
-import readline from "node:readline";
-import { runShellCommand, } from "./builtins/shellCommandRunner.js";
-import { symbolsTool } from "./built-in-symbols-tool.js";
-// ── read_file pagination & truncation constants ──────────────────────────────
-const DEFAULT_READ_LIMIT = 2000;
-const MAX_LINE_LENGTH = 2000;
-const MAX_READ_BYTES = 50 * 1024; // 50 KB
-const BINARY_SAMPLE_BYTES = 4096;
-const BINARY_NON_PRINTABLE_RATIO = 0.3;
-const BINARY_EXTENSIONS = new Set([
-    ".png", ".jpg", ".jpeg", ".gif", ".bmp", ".ico", ".webp", ".tiff", ".tif",
-    ".zip", ".gz", ".tar", ".rar", ".7z", ".bz2", ".xz", ".lz",
-    ".exe", ".dll", ".so", ".dylib", ".bin", ".o", ".a",
-    ".pdf", ".doc", ".docx", ".xls", ".xlsx", ".ppt", ".pptx",
-    ".mp3", ".mp4", ".avi", ".mov", ".wav", ".flv", ".mkv", ".ogg",
-    ".woff", ".woff2", ".ttf", ".otf", ".eot",
-    ".class", ".jar", ".war", ".ear",
-    ".pyc", ".pyo", ".node",
-    ".sqlite", ".db", ".mdb",
-    ".wasm",
-]);
-// ─────────────────────────────────────────────────────────────────────────────
-// ── grep search constants ────────────────────────────────────────────────────
-const MAX_GREP_FILES = 1000;
-const MAX_GREP_FILE_SIZE = 1024 * 1024; // 1 MB – skip larger files
-const MAX_GREP_OUTPUT_BYTES = 256 * 1024; // 256 KB – cap total output
-const DEFAULT_GREP_MAX_RESULTS = 1000;
-const GREP_SKIP_DIRS = new Set([
-    ".git", "node_modules", "dist", "build", ".next", ".nuxt",
-    ".cache", ".turbo", ".output", "coverage", ".nyc_output",
-]);
-function toDisplayPath(targetPath) {
-    return targetPath.replace(/\\/g, "/");
-}
-async function pathExists(targetPath) {
-    try {
-        await fs.access(targetPath);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-function countOccurrences(content, search) {
-    if (!search) {
-        return 0;
-    }
-    let count = 0;
-    let index = content.indexOf(search);
-    while (index >= 0) {
-        count += 1;
-        index = content.indexOf(search, index + search.length);
-    }
-    return count;
-}
-function readStringArg(args, names, label) {
-    for (const name of names) {
-        const value = args[name];
-        if (typeof value === "string") {
-            return value;
-        }
-    }
-    throw new Error(`${label} is required`);
-}
-function readOptionalStringArg(args, names) {
-    for (const name of names) {
-        const value = args[name];
-        if (typeof value === "string" && value.trim()) {
-            return value;
-        }
-    }
-    return undefined;
-}
-function readOptionalPositiveIntegerArg(args, names, fallback) {
-    for (const name of names) {
-        const value = args[name];
-        const numeric = typeof value === "number"
-            ? value
-            : typeof value === "string"
-                ? Number(value)
-                : NaN;
-        if (Number.isFinite(numeric) && numeric > 0) {
-            return Math.floor(numeric);
-        }
-    }
-    return fallback;
-}
-/**
- * 检测文件是否为二进制文件。
- * 主流程：先查扩展名黑名单 -> 再采样前 4KB 检测 NUL 字节或高比例不可见字符。
- */
-async function isBinaryFile(filePath) {
-    const ext = path.extname(filePath).toLowerCase();
-    if (BINARY_EXTENSIONS.has(ext)) {
-        return true;
-    }
-    const handle = await fs.open(filePath, "r");
-    try {
-        const buffer = Buffer.alloc(BINARY_SAMPLE_BYTES);
-        const { bytesRead } = await handle.read(buffer, 0, BINARY_SAMPLE_BYTES, 0);
-        if (bytesRead === 0) {
-            return false;
-        }
-        const sample = buffer.subarray(0, bytesRead);
-        // NUL byte = definitely binary
-        if (sample.includes(0)) {
-            return true;
-        }
-        // >30% non-printable characters = likely binary
-        let nonPrintable = 0;
-        for (let i = 0; i < bytesRead; i++) {
-            const byte = sample[i];
-            // Allow: tab(0x09), LF(0x0a), CR(0x0d), printable ASCII (0x20-0x7e), UTF-8 high bytes (0x80-0xff)
-            if (byte < 0x09 || (byte > 0x0d && byte < 0x20)) {
-                nonPrintable++;
-            }
-        }
-        return nonPrintable / bytesRead > BINARY_NON_PRINTABLE_RATIO;
-    }
-    finally {
-        await handle.close();
-    }
-}
-export function ensureInsideWorkspace(workspaceRoot, targetPath) {
-    const resolvedTargetPath = path.resolve(targetPath);
-    const relativePath = path.relative(workspaceRoot, resolvedTargetPath);
-    if (relativePath.startsWith("..") || path.isAbsolute(relativePath)) {
-        throw new Error(`Target path is outside workspace: ${resolvedTargetPath}`);
-    }
-    return resolvedTargetPath;
-}
-async function resolveWorkspaceDirectory(workingDirectory, rawCwd) {
-    const requestedRoot = path.resolve(String(workingDirectory || "").trim());
-    const workspaceRoot = await fs.realpath(requestedRoot);
-    const workspaceStat = await fs.stat(workspaceRoot);
-    if (!workspaceStat.isDirectory()) {
-        throw new Error(`Workspace path is not a directory: ${requestedRoot}`);
-    }
-    if (!rawCwd?.trim()) {
-        return { workspaceRoot, cwd: workspaceRoot };
-    }
-    const requestedCwd = rawCwd.trim();
-    const candidatePath = path.isAbsolute(requestedCwd)
-        ? path.resolve(requestedCwd)
-        : path.resolve(requestedRoot, requestedCwd);
-    const requestedRelativePath = path.relative(requestedRoot, candidatePath);
-    if (requestedRelativePath.startsWith("..") ||
-        path.isAbsolute(requestedRelativePath)) {
-        throw new Error(`Command cwd is outside workspace: ${candidatePath}`);
-    }
-    const realCwd = ensureInsideWorkspace(workspaceRoot, await fs.realpath(candidatePath));
-    const cwdStat = await fs.stat(realCwd);
-    if (!cwdStat.isDirectory()) {
-        throw new Error(`Command cwd is not a directory: ${realCwd}`);
-    }
-    return { workspaceRoot, cwd: realCwd };
-}
-async function ensureWritableTarget(workspaceRoot, targetPath) {
-    const realParentPath = await fs.realpath(path.dirname(targetPath));
-    ensureInsideWorkspace(workspaceRoot, realParentPath);
-    try {
-        const targetLinkStat = await fs.lstat(targetPath);
-        if (targetLinkStat.isSymbolicLink()) {
-            throw new Error(`Refusing to write through symbolic link: ${targetPath}`);
-        }
-    }
-    catch (error) {
-        const errorCode = typeof error === "object" && error !== null
-            ? Reflect.get(error, "code")
-            : undefined;
-        if (errorCode !== "ENOENT") {
-            throw error;
-        }
-    }
-}
-/**
- * 解析内置文件工具目标路径。
- * 主流程：同时校验请求路径与 realpath 工作区边界，防止绝对路径、`..` 与符号链接目录穿透。
- */
-export async function resolveWorkspaceTarget(workingDirectory, rawFilePath) {
-    const requestedRoot = path.resolve(String(workingDirectory || "").trim());
-    const workspaceRoot = await fs.realpath(requestedRoot);
-    const workspaceStat = await fs.stat(workspaceRoot);
-    if (!workspaceStat.isDirectory()) {
-        throw new Error(`Workspace path is not a directory: ${requestedRoot}`);
-    }
-    const normalizedFilePath = rawFilePath.trim();
-    if (!normalizedFilePath) {
-        throw new Error("file_path is required");
-    }
-    const requestedPath = path.isAbsolute(normalizedFilePath)
-        ? path.resolve(normalizedFilePath)
-        : path.resolve(requestedRoot, normalizedFilePath);
-    const requestedRelativePath = path.relative(requestedRoot, requestedPath);
-    if (requestedRelativePath.startsWith("..") ||
-        path.isAbsolute(requestedRelativePath)) {
-        throw new Error(`Target path is outside workspace: ${requestedPath}`);
-    }
-    return {
-        workspaceRoot,
-        requestedPath,
-        targetPath: ensureInsideWorkspace(workspaceRoot, path.join(workspaceRoot, requestedRelativePath)),
-    };
-}
-/**
- * 原子写入完整文件内容。
- * 主流程：创建父目录 -> 校验 realpath 边界和符号链接 -> 写同目录临时文件 -> rename 覆盖目标。
- */
-async function writeFileAtomically(workingDirectory, filePath, content) {
-    const target = await resolveWorkspaceTarget(workingDirectory, filePath);
-    const parentPath = path.dirname(target.targetPath);
-    const createdParentDirectory = !(await pathExists(parentPath));
-    await fs.mkdir(parentPath, { recursive: true });
-    await ensureWritableTarget(target.workspaceRoot, target.targetPath);
-    const temporaryPath = path.join(parentPath, `.${path.basename(target.targetPath)}.${process.pid}.${randomUUID()}.tmp`);
-    try {
-        await fs.writeFile(temporaryPath, content, "utf-8");
-        await fs.rename(temporaryPath, target.targetPath);
-    }
-    catch (error) {
-        await fs.rm(temporaryPath, { force: true });
-        throw error;
-    }
-    return {
-        workspaceRoot: target.workspaceRoot,
-        targetPath: target.targetPath,
-        bytes: Buffer.byteLength(content, "utf-8"),
-        createdParentDirectory,
-    };
-}
-async function readFileInsideWorkspace(workingDirectory, filePath) {
-    const target = await resolveWorkspaceTarget(workingDirectory, filePath);
-    const realTargetPath = ensureInsideWorkspace(target.workspaceRoot, await fs.realpath(target.targetPath));
-    const stat = await fs.stat(realTargetPath);
-    if (!stat.isFile()) {
-        throw new Error(`Path is not a file: ${realTargetPath}`);
-    }
-    return {
-        workspaceRoot: target.workspaceRoot,
-        targetPath: realTargetPath,
-        content: await fs.readFile(realTargetPath, "utf-8"),
-    };
-}
-/**
- * 分页流式读取工作区内文本文件，带行号前缀、双重截断上限和续读提示。
- *
- * 主流程：
- *   1. 路径解析与安全校验（复用 resolveWorkspaceTarget + ensureInsideWorkspace + realpath）
- *   2. 二进制检测（扩展名黑名单 + 4KB 采样）
- *   3. createReadStream + readline 逐行流式读取，跳过 offset 前行
- *   4. 收集 limit 行，同时持续计数总行数（用于底部提示）
- *   5. 双重上限：行数 2000 + 字节 50KB，先触发先截断
- *   6. 拼装行号前缀 + 底部续读提示
- *
- * 不修改 readFileInsideWorkspace，edit_file 仍使用全量读取。
- */
-async function readFileWithPagination(workingDirectory, filePath, offset, limit) {
-    const target = await resolveWorkspaceTarget(workingDirectory, filePath);
-    const realTargetPath = ensureInsideWorkspace(target.workspaceRoot, await fs.realpath(target.targetPath));
-    const stat = await fs.stat(realTargetPath);
-    if (!stat.isFile()) {
-        throw new Error(`Path is not a file: ${realTargetPath}`);
-    }
-    // ── 二进制检测 ──
-    if (await isBinaryFile(realTargetPath)) {
-        return {
-            workspaceRoot: target.workspaceRoot,
-            targetPath: realTargetPath,
-            content: "[Binary file, content skipped]",
-            isBinary: true,
-            truncated: false,
-            totalLines: 0,
-            shownFromLine: 0,
-            shownToLine: 0,
-        };
-    }
-    // ── 流式逐行读取 ──
-    const stream = createReadStream(realTargetPath, { encoding: "utf-8" });
-    const rl = readline.createInterface({
-        input: stream,
-        crlfDelay: Infinity,
-    });
-    try {
-        const outputLines = [];
-        let lineNumber = 0; // 0-indexed 内部计数
-        let totalLines = 0;
-        let bytes = 0;
-        let truncatedByLines = false;
-        let truncatedByBytes = false;
-        const startIndex = offset - 1; // 转为 0-indexed
-        for await (const text of rl) {
-            totalLines++;
-            // 跳过 offset 前的行
-            if (lineNumber < startIndex) {
-                lineNumber++;
-                continue;
-            }
-            // 已达 limit 上限：停止收集但继续计数
-            if (outputLines.length >= limit) {
-                truncatedByLines = true;
-                lineNumber++;
-                continue;
-            }
-            // 单行截断
-            let line = text;
-            if (line.length > MAX_LINE_LENGTH) {
-                line =
-                    line.slice(0, MAX_LINE_LENGTH) +
-                        `... (line truncated to ${MAX_LINE_LENGTH} chars)`;
-            }
-            const numberedLine = `${lineNumber + 1}: ${line}`;
-            const lineBytes = Buffer.byteLength(numberedLine, "utf-8") + 1; // +1 for \n
-            // 字节上限：停止读取（totalLines 不再准确）
-            if (bytes + lineBytes > MAX_READ_BYTES) {
-                truncatedByBytes = true;
-                break;
-            }
-            outputLines.push(numberedLine);
-            bytes += lineBytes;
-            lineNumber++;
-        }
-        // offset 超出文件总行数（空文件除外）
-        if (totalLines > 0 &&
-            outputLines.length === 0 &&
-            !truncatedByLines &&
-            !truncatedByBytes &&
-            startIndex >= totalLines) {
-            throw new Error(`offset ${offset} exceeds total line count ${totalLines} in file: ${realTargetPath}`);
-        }
-        const shownFromLine = outputLines.length > 0 ? offset : 0;
-        const shownToLine = outputLines.length > 0 ? offset + outputLines.length - 1 : 0;
-        // ── 底部续读提示 ──
-        let footer;
-        if (truncatedByBytes) {
-            footer = `Output capped at 50 KB. Showing lines ${shownFromLine}-${shownToLine}. Use offset=${shownToLine + 1} to continue.`;
-        }
-        else if (truncatedByLines) {
-            footer = `Showing lines ${shownFromLine}-${shownToLine} of ${totalLines}. Use offset=${shownToLine + 1} to continue.`;
-        }
-        else {
-            footer = `End of file - total ${totalLines} lines`;
-        }
-        const content = outputLines.length > 0
-            ? outputLines.join("\n") + "\n" + footer
-            : footer;
-        return {
-            workspaceRoot: target.workspaceRoot,
-            targetPath: realTargetPath,
-            content,
-            isBinary: false,
-            truncated: truncatedByLines || truncatedByBytes,
-            totalLines: truncatedByBytes ? -1 : totalLines,
-            shownFromLine,
-            shownToLine,
-        };
-    }
-    finally {
-        rl.close();
-        stream.destroy();
-    }
-}
-// ── grep helpers ──────────────────────────────────────────────────────────────
-/**
- * 将 glob 通配符转换为 RegExp（匹配文件 basename）。
- * 支持：* (不跨 / ), ? (单个非 / 字符), {a,b} (分组), [abc] (字符类)。
- */
-function globToRegex(pattern) {
-    let regex = "";
-    let i = 0;
-    while (i < pattern.length) {
-        const char = pattern[i];
-        if (char === "*") {
-            regex += "[^/]*";
-        }
-        else if (char === "?") {
-            regex += "[^/]";
-        }
-        else if (char === "{") {
-            const end = pattern.indexOf("}", i);
-            if (end >= 0) {
-                const content = pattern.slice(i + 1, end);
-                regex += `(${content.split(",").join("|")})`;
-                i = end;
-            }
-            else {
-                regex += "\\{";
-            }
-        }
-        else if (char === "[") {
-            const end = pattern.indexOf("]", i);
-            if (end >= 0) {
-                regex += pattern.slice(i, end + 1);
-                i = end;
-            }
-            else {
-                regex += "\\[";
-            }
-        }
-        else if ("+^$.()|\\".includes(char)) {
-            regex += "\\" + char;
-        }
-        else {
-            regex += char;
-        }
-        i++;
-    }
-    return new RegExp(`^${regex}$`);
-}
-/**
- * 递归遍历目录，返回所有匹配 include/exclude 的文件路径。
- * 主流程：readdir -> 跳过 GREP_SKIP_DIRS 和隐藏目录 -> 递归子目录 -> 过滤文件名。
- */
-async function walkDirectory(dir, includeRegex, excludeRegex, maxFiles) {
-    const results = [];
-    async function walk(currentDir) {
-        if (results.length >= maxFiles)
-            return;
-        const entries = await fs.readdir(currentDir, { withFileTypes: true });
-        for (const entry of entries) {
-            if (results.length >= maxFiles)
-                return;
-            if (entry.name.startsWith(".") && entry.isDirectory())
-                continue;
-            const fullPath = path.join(currentDir, entry.name);
-            if (entry.isDirectory()) {
-                if (GREP_SKIP_DIRS.has(entry.name))
-                    continue;
-                await walk(fullPath);
-            }
-            else if (entry.isFile()) {
-                if (includeRegex && !includeRegex.test(entry.name))
-                    continue;
-                if (excludeRegex && excludeRegex.test(entry.name))
-                    continue;
-                results.push(fullPath);
-            }
-        }
-    }
-    await walk(dir);
-    return results;
-}
-/**
- * 在单个文件中搜索正则匹配，返回匹配行（含行号）或计数。
- * 主流程：文件大小检查 -> 二进制检测 -> 流式逐行读取 -> 正则匹配 -> 收集结果。
- */
-async function searchInFile(filePath, workspaceRoot, options) {
-    const stat = await fs.stat(filePath);
-    if (stat.size > MAX_GREP_FILE_SIZE) {
-        return { matches: [], count: 0 };
-    }
-    if (await isBinaryFile(filePath)) {
-        return { matches: [], count: 0 };
-    }
-    const relativePath = path.relative(workspaceRoot, filePath).replace(/\\/g, "/");
-    const matches = [];
-    let count = 0;
-    const stream = createReadStream(filePath, { encoding: "utf-8" });
-    const rl = readline.createInterface({ input: stream, crlfDelay: Infinity });
-    try {
-        let lineNumber = 0;
-        for await (const text of rl) {
-            lineNumber++;
-            if (options.regex.test(text)) {
-                count++;
-                if (options.collectContent) {
-                    let content = text;
-                    if (content.length > MAX_LINE_LENGTH) {
-                        content =
-                            content.slice(0, MAX_LINE_LENGTH) +
-                                `... (line truncated to ${MAX_LINE_LENGTH} chars)`;
-                    }
-                    matches.push({ file: relativePath, line: lineNumber, content });
-                    if (matches.length >= options.maxResults)
-                        break;
-                }
-                if (options.stopOnFirstMatch)
-                    break;
-            }
-        }
-    }
-    finally {
-        rl.close();
-        stream.destroy();
-    }
-    return { matches, count };
-}
-const MAX_COMMAND_TIMEOUT_MS = 10 * 60_000;
-const DEFAULT_COMMAND_TIMEOUT_MS = MAX_COMMAND_TIMEOUT_MS;
-const DEFAULT_COMMAND_INACTIVITY_TIMEOUT_MS = 60_000;
-const MAX_COMMAND_INACTIVITY_TIMEOUT_MS = 10 * 60_000;
-function writeFileTool(workingDirectory, onFileChange) {
-    return {
-        kind: "builtin",
-        toolName: "write_file",
-        exposedName: "write_file",
-        description: "Create or overwrite a UTF-8 text file inside the current workspace. Parent directories are created automatically.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                file_path: {
-                    type: "string",
-                    description: "Workspace-relative file path to write.",
-                },
-                content: {
-                    type: "string",
-                    description: "Complete UTF-8 file content.",
-                },
-            },
-            required: ["file_path", "content"],
-            additionalProperties: false,
-        },
-        async execute(args) {
-            const filePath = readStringArg(args, ["file_path", "filePath"], "file_path");
-            const content = readStringArg(args, ["content"], "content");
-            const target = await resolveWorkspaceTarget(workingDirectory, filePath);
-            const existed = await pathExists(target.targetPath);
-            const beforeContent = existed
-                ? await fs.readFile(target.targetPath, "utf-8").catch(() => null)
-                : null;
-            const result = await writeFileAtomically(workingDirectory, filePath, content);
-            if (onFileChange) {
-                const relativePath = path
-                    .relative(result.workspaceRoot, result.targetPath)
-                    .replace(/\\/g, "/");
-                await onFileChange({
-                    filePath: relativePath,
-                    operation: existed ? "UPDATE" : "CREATE",
-                    beforeContent,
-                    afterContent: content,
-                });
-            }
-            return {
-                ok: true,
-                tool: "write_file",
-                workspacePath: toDisplayPath(result.workspaceRoot),
-                filePath: toDisplayPath(result.targetPath),
-                bytes: result.bytes,
-                createdParentDirectory: result.createdParentDirectory,
-            };
-        },
-    };
-}
-function editFileTool(workingDirectory, onFileChange) {
-    return {
-        kind: "builtin",
-        toolName: "edit_file",
-        exposedName: "edit_file",
-        description: "Replace exactly one occurrence of old_string with new_string in a UTF-8 workspace text file.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                file_path: {
-                    type: "string",
-                    description: "Workspace-relative file path to edit.",
-                },
-                old_string: {
-                    type: "string",
-                    description: "Existing text to replace. Must occur exactly once.",
-                },
-                new_string: { type: "string", description: "Replacement text." },
-            },
-            required: ["file_path", "old_string", "new_string"],
-            additionalProperties: false,
-        },
-        async execute(args) {
-            const filePath = readStringArg(args, ["file_path", "filePath"], "file_path");
-            const oldString = readStringArg(args, ["old_string", "oldString"], "old_string");
-            const newString = readStringArg(args, ["new_string", "newString"], "new_string");
-            if (!oldString) {
-                throw new Error("old_string must not be empty");
-            }
-            const current = await readFileInsideWorkspace(workingDirectory, filePath);
-            const occurrences = countOccurrences(current.content, oldString);
-            if (occurrences === 0) {
-                throw new Error("old_string was not found in file");
-            }
-            if (occurrences > 1) {
-                throw new Error(`old_string occurs ${occurrences} times; provide a unique match`);
-            }
-            const updatedContent = current.content.replace(oldString, newString);
-            const result = await writeFileAtomically(workingDirectory, filePath, updatedContent);
-            if (onFileChange) {
-                const relativePath = path
-                    .relative(result.workspaceRoot, result.targetPath)
-                    .replace(/\\/g, "/");
-                await onFileChange({
-                    filePath: relativePath,
-                    operation: "UPDATE",
-                    beforeContent: current.content,
-                    afterContent: updatedContent,
-                });
-            }
-            return {
-                ok: true,
-                tool: "edit_file",
-                workspacePath: toDisplayPath(result.workspaceRoot),
-                filePath: toDisplayPath(result.targetPath),
-                replacements: 1,
-                bytes: result.bytes,
-            };
-        },
-    };
-}
-function deleteFileTool(workingDirectory, onFileChange) {
-    return {
-        kind: "builtin",
-        toolName: "delete_file",
-        exposedName: "delete_file",
-        description: "Delete a file inside the current workspace. Returns an error if the file does not exist.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                file_path: {
-                    type: "string",
-                    description: "Workspace-relative file path to delete.",
-                },
-            },
-            required: ["file_path"],
-            additionalProperties: false,
-        },
-        async execute(args) {
-            const filePath = readStringArg(args, ["file_path", "filePath"], "file_path");
-            const target = await resolveWorkspaceTarget(workingDirectory, filePath);
-            const realTargetPath = ensureInsideWorkspace(target.workspaceRoot, await fs.realpath(target.targetPath).catch(() => target.targetPath));
-            const stat = await fs.stat(realTargetPath).catch(() => null);
-            if (!stat) {
-                throw new Error(`File does not exist: ${realTargetPath}`);
-            }
-            if (!stat.isFile()) {
-                throw new Error(`Path is not a file: ${realTargetPath}`);
-            }
-            const beforeContent = await fs
-                .readFile(realTargetPath, "utf-8")
-                .catch(() => null);
-            await fs.rm(realTargetPath, { force: true });
-            if (onFileChange) {
-                const relativePath = path
-                    .relative(target.workspaceRoot, realTargetPath)
-                    .replace(/\\/g, "/");
-                await onFileChange({
-                    filePath: relativePath,
-                    operation: "DELETE",
-                    beforeContent,
-                    afterContent: null,
-                });
-            }
-            return {
-                ok: true,
-                tool: "delete_file",
-                workspacePath: toDisplayPath(target.workspaceRoot),
-                filePath: toDisplayPath(realTargetPath),
-                deleted: true,
-            };
-        },
-    };
-}
-function readFileTool(workingDirectory) {
-    return {
-        kind: "builtin",
-        toolName: "read_file",
-        exposedName: "read_file",
-        description: "Read a UTF-8 text file inside the current workspace. " +
-            "Returns content with line numbers in the format '<line>: <content>'. " +
-            "Supports offset (1-indexed line number to start from) and limit (max lines to return, default 2000). " +
-            "Output is capped at 2000 lines or 50 KB, whichever is reached first. " +
-            "Individual lines longer than 2000 characters are truncated. " +
-            "Avoid tiny repeated slices (e.g. 30-line chunks); read a larger window if more context is needed.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                file_path: {
-                    type: "string",
-                    description: "Workspace-relative file path to read.",
-                },
-                offset: {
-                    type: "number",
-                    description: "Line number to start reading from (1-indexed). Defaults to 1.",
-                },
-                limit: {
-                    type: "number",
-                    description: "Maximum number of lines to return. Defaults to 2000.",
-                },
-            },
-            required: ["file_path"],
-            additionalProperties: false,
-        },
-        async execute(args) {
-            const filePath = readStringArg(args, ["file_path", "filePath"], "file_path");
-            const offset = readOptionalPositiveIntegerArg(args, ["offset"], 1);
-            const limit = readOptionalPositiveIntegerArg(args, ["limit"], DEFAULT_READ_LIMIT);
-            const result = await readFileWithPagination(workingDirectory, filePath, offset, limit);
-            return {
-                ok: true,
-                tool: "read_file",
-                workspacePath: toDisplayPath(result.workspaceRoot),
-                filePath: toDisplayPath(result.targetPath),
-                content: result.content,
-                isBinary: result.isBinary,
-                truncated: result.truncated,
-                totalLines: result.totalLines,
-                shownFromLine: result.shownFromLine,
-                shownToLine: result.shownToLine,
-            };
-        },
-    };
-}
-function bashTool(workingDirectory, agentId) {
-    return {
-        kind: "builtin",
-        toolName: "Bash",
-        exposedName: "Bash",
-        description: "Execute a shell command in the current workspace. Use for local diagnostics, builds, tests, and OS commands. The command runs with a bounded timeout and returns stdout, stderr, and exit code.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                command: { type: "string", description: "Shell command to execute." },
-                cwd: {
-                    type: "string",
-                    description: "Optional workspace-relative working directory. Defaults to the workspace root.",
-                },
-                timeout_ms: {
-                    type: "number",
-                    description: "Optional timeout in milliseconds. Defaults to 600000 and is capped at 600000.",
-                },
-                inactivity_timeout_ms: {
-                    type: "number",
-                    description: "Optional no-output timeout in milliseconds. Defaults to 60000 and is capped at 600000.",
-                },
-                description: {
-                    type: "string",
-                    description: "Optional short reason for running the command.",
-                },
-            },
-            required: ["command"],
-            additionalProperties: false,
-        },
-        async execute(args, context) {
-            const command = readStringArg(args, ["command"], "command").trim();
-            if (!command) {
-                throw new Error("command must not be empty");
-            }
-            const requestedTimeoutMs = readOptionalPositiveIntegerArg(args, ["timeout_ms", "timeoutMs"], DEFAULT_COMMAND_TIMEOUT_MS);
-            const timeoutMs = Math.min(requestedTimeoutMs, MAX_COMMAND_TIMEOUT_MS);
-            const requestedInactivityTimeoutMs = readOptionalPositiveIntegerArg(args, ["inactivity_timeout_ms", "inactivityTimeoutMs"], DEFAULT_COMMAND_INACTIVITY_TIMEOUT_MS);
-            const inactivityTimeoutMs = Math.min(requestedInactivityTimeoutMs, MAX_COMMAND_INACTIVITY_TIMEOUT_MS);
-            const cwdArg = readOptionalStringArg(args, ["cwd"]);
-            const resolved = await resolveWorkspaceDirectory(workingDirectory, cwdArg);
-            const result = await runShellCommand({
-                commandText: command,
-                agentId,
-                workspaceRoot: resolved.workspaceRoot,
-                cwd: resolved.cwd,
-                timeoutMs,
-                inactivityTimeoutMs,
-                onOutput: context?.onOutput,
-            });
-            return {
-                ok: result.exitCode === 0 && !result.timedOut,
-                tool: "Bash",
-                command,
-                cwd: toDisplayPath(resolved.cwd),
-                exitCode: result.exitCode,
-                signal: result.signal,
-                timedOut: result.timedOut,
-                inactivityTimedOut: result.inactivityTimedOut,
-                timeoutMs,
-                inactivityTimeoutMs,
-                durationMs: result.durationMs,
-                outputSpilled: result.outputSpilled,
-                outputFilePath: result.outputFilePath,
-                outputLineCount: result.outputLineCount,
-                commandFilePath: result.commandFilePath,
-                commandLineCount: result.commandLineCount,
-                stdout: result.stdout,
-                stderr: result.stderr,
-            };
-        },
-    };
-}
-function grepTool(workingDirectory) {
-    return {
-        kind: "builtin",
-        toolName: "grep",
-        exposedName: "grep",
-        description: "Search file contents using regular expressions within the workspace. " +
-            "Returns matched lines with file paths and line numbers. " +
-            "Supports include/exclude glob patterns, case-insensitive matching, and three output modes " +
-            "(content, files_with_matches, count). Searches recursively through directories, " +
-            "skipping binary files, hidden directories, and common build/dependency directories (node_modules, .git, dist, etc.).",
-        inputSchema: {
-            type: "object",
-            properties: {
-                pattern: {
-                    type: "string",
-                    description: "Regular expression pattern to search for in file contents.",
-                },
-                path: {
-                    type: "string",
-                    description: "Workspace-relative file or directory path to search in. Defaults to the workspace root.",
-                },
-                include: {
-                    type: "string",
-                    description: "Glob pattern to filter files by name (e.g. '*.ts', '*.{js,ts}'). Only matching files are searched.",
-                },
-                exclude: {
-                    type: "string",
-                    description: "Glob pattern to exclude files by name (e.g. '*.test.ts'). Matching files are skipped.",
-                },
-                case_insensitive: {
-                    type: "boolean",
-                    description: "Case-insensitive matching. Default false.",
-                },
-                output_mode: {
-                    type: "string",
-                    enum: ["content", "files_with_matches", "count"],
-                    description: "Output format: 'content' returns matched lines with line numbers (default), " +
-                        "'files_with_matches' returns only file paths with matches, " +
-                        "'count' returns match counts per file.",
-                },
-                max_results: {
-                    type: "number",
-                    description: "Maximum number of matched lines to return (content mode). Default 1000.",
-                },
-            },
-            required: ["pattern"],
-            additionalProperties: false,
-        },
-        /**
-         * grep 工具执行主流程：
-         *   1. 解析参数（pattern, path, include/exclude, output_mode 等）
-         *   2. 编译正则（含 case_insensitive 标志）
-         *   3. 解析搜索路径并校验 workspace 边界
-         *   4. 收集待搜索文件列表（单文件或递归遍历目录）
-         *   5. 逐文件搜索（流式读取 + 正则匹配）
-         *   6. 根据 output_mode 构建响应
-         */
-        async execute(args) {
-            const pattern = readStringArg(args, ["pattern"], "pattern");
-            const searchPath = readOptionalStringArg(args, ["path"]) || ".";
-            const includeGlob = readOptionalStringArg(args, ["include"]);
-            const excludeGlob = readOptionalStringArg(args, ["exclude"]);
-            const caseInsensitive = args.case_insensitive === true;
-            const outputMode = (() => {
-                const mode = args.output_mode;
-                if (mode === "files_with_matches" || mode === "count")
-                    return mode;
-                return "content";
-            })();
-            const maxResults = readOptionalPositiveIntegerArg(args, ["max_results"], DEFAULT_GREP_MAX_RESULTS);
-            // ── 编译正则 ──
-            const flags = caseInsensitive ? "i" : "";
-            let regex;
-            try {
-                regex = new RegExp(pattern, flags);
-            }
-            catch (error) {
-                throw new Error(`Invalid regex pattern: ${error instanceof Error ? error.message : String(error)}`);
-            }
-            const includeRegex = includeGlob ? globToRegex(includeGlob) : null;
-            const excludeRegex = excludeGlob ? globToRegex(excludeGlob) : null;
-            // ── 解析搜索路径（复用 workspace 安全校验） ──
-            const target = await resolveWorkspaceTarget(workingDirectory, searchPath);
-            const realTargetPath = ensureInsideWorkspace(target.workspaceRoot, await fs.realpath(target.targetPath));
-            const targetStat = await fs.stat(realTargetPath);
-            // ── 收集文件列表 ──
-            let files;
-            if (targetStat.isFile()) {
-                files = [realTargetPath];
-            }
-            else if (targetStat.isDirectory()) {
-                files = await walkDirectory(realTargetPath, includeRegex, excludeRegex, MAX_GREP_FILES);
-            }
-            else {
-                throw new Error(`Path is neither a file nor a directory: ${realTargetPath}`);
-            }
-            // ── 逐文件搜索 ──
-            const allMatches = [];
-            const fileCounts = [];
-            const matchedFiles = [];
-            let totalMatches = 0;
-            let outputBytes = 0;
-            let truncated = false;
-            for (const filePath of files) {
-                // content 模式：全局 maxResults 上限
-                if (outputMode === "content" && allMatches.length >= maxResults) {
-                    truncated = true;
-                    break;
-                }
-                const searchOptions = {
-                    regex,
-                    maxResults: outputMode === "content"
-                        ? maxResults - allMatches.length
-                        : Number.MAX_SAFE_INTEGER,
-                    collectContent: outputMode === "content",
-                    stopOnFirstMatch: outputMode === "files_with_matches",
-                };
-                const result = await searchInFile(filePath, target.workspaceRoot, searchOptions);
-                if (result.count > 0) {
-                    const relativePath = path
-                        .relative(target.workspaceRoot, filePath)
-                        .replace(/\\/g, "/");
-                    matchedFiles.push(relativePath);
-                    totalMatches += result.count;
-                    if (outputMode === "content") {
-                        for (const match of result.matches) {
-                            const matchBytes = Buffer.byteLength(match.content, "utf-8") + 64;
-                            if (outputBytes + matchBytes > MAX_GREP_OUTPUT_BYTES) {
-                                truncated = true;
-                                break;
-                            }
-                            outputBytes += matchBytes;
-                            allMatches.push(match);
-                        }
-                        if (truncated)
-                            break;
-                        // max_results 截断：收集完本文件匹配后检查是否已达上限
-                        if (allMatches.length >= maxResults) {
-                            truncated = true;
-                            break;
-                        }
-                    }
-                    else if (outputMode === "count") {
-                        fileCounts.push({ file: relativePath, count: result.count });
-                    }
-                }
-            }
-            // ── 构建响应 ──
-            const response = {
-                ok: true,
-                tool: "grep",
-                pattern,
-                searchPath: toDisplayPath(target.targetPath),
-                outputMode,
-                filesSearched: files.length,
-                filesMatched: matchedFiles.length,
-                totalMatches,
-                truncated,
-            };
-            if (outputMode === "content") {
-                response.matches = allMatches;
-            }
-            else if (outputMode === "files_with_matches") {
-                response.matches = matchedFiles;
-            }
-            else {
-                response.matches = fileCounts;
-            }
-            return response;
-        },
-    };
-}
-export function createBuiltInFileTools(workingDirectory, agentId, onFileChange) {
-    const resolvedAgentId = agentId || "unknown";
-    return [
-        readFileTool(workingDirectory),
-        writeFileTool(workingDirectory, onFileChange),
-        editFileTool(workingDirectory, onFileChange),
-        deleteFileTool(workingDirectory, onFileChange),
-        grepTool(workingDirectory),
-        bashTool(workingDirectory, resolvedAgentId),
-        symbolsTool(workingDirectory),
-    ];
-}
+import{randomUUID as Y}from"node:crypto";import{promises as u,createReadStream as C}from"node:fs";import f from"node:path";import D from"node:readline";import{runShellCommand as K}from"./builtins/shellCommandRunner.js";import{symbolsTool as V}from"./built-in-symbols-tool.js";const H=2e3,v=2e3,Z=50*1024,U=4096,J=.3,Q=new Set([".png",".jpg",".jpeg",".gif",".bmp",".ico",".webp",".tiff",".tif",".zip",".gz",".tar",".rar",".7z",".bz2",".xz",".lz",".exe",".dll",".so",".dylib",".bin",".o",".a",".pdf",".doc",".docx",".xls",".xlsx",".ppt",".pptx",".mp3",".mp4",".avi",".mov",".wav",".flv",".mkv",".ogg",".woff",".woff2",".ttf",".otf",".eot",".class",".jar",".war",".ear",".pyc",".pyo",".node",".sqlite",".db",".mdb",".wasm"]),tt=1e3,et=1024*1024,nt=256*1024,ot=1e3,it=new Set([".git","node_modules","dist","build",".next",".nuxt",".cache",".turbo",".output","coverage",".nyc_output"]);function y(o){return o.replace(/\\/g,"/")}async function q(o){try{return await u.access(o),!0}catch{return!1}}function rt(o,n){if(!n)return 0;let t=0,e=o.indexOf(n);for(;e>=0;)t+=1,e=o.indexOf(n,e+n.length);return t}function _(o,n,t){for(const e of n){const i=o[e];if(typeof i=="string")return i}throw new Error(`${t} is required`)}function O(o,n){for(const t of n){const e=o[t];if(typeof e=="string"&&e.trim())return e}}function A(o,n,t){for(const e of n){const i=o[e],r=typeof i=="number"?i:typeof i=="string"?Number(i):NaN;if(Number.isFinite(r)&&r>0)return Math.floor(r)}return t}async function W(o){const n=f.extname(o).toLowerCase();if(Q.has(n))return!0;const t=await u.open(o,"r");try{const e=Buffer.alloc(U),{bytesRead:i}=await t.read(e,0,U,0);if(i===0)return!1;const r=e.subarray(0,i);if(r.includes(0))return!0;let c=0;for(let s=0;s<i;s++){const a=r[s];(a<9||a>13&&a<32)&&c++}return c/i>J}finally{await t.close()}}function E(o,n){const t=f.resolve(n),e=f.relative(o,t);if(e.startsWith("..")||f.isAbsolute(e))throw new Error(`Target path is outside workspace: ${t}`);return t}async function at(o,n){const t=f.resolve(String(o||"").trim()),e=await u.realpath(t);if(!(await u.stat(e)).isDirectory())throw new Error(`Workspace path is not a directory: ${t}`);if(!n?.trim())return{workspaceRoot:e,cwd:e};const r=n.trim(),c=f.isAbsolute(r)?f.resolve(r):f.resolve(t,r),s=f.relative(t,c);if(s.startsWith("..")||f.isAbsolute(s))throw new Error(`Command cwd is outside workspace: ${c}`);const a=E(e,await u.realpath(c));if(!(await u.stat(a)).isDirectory())throw new Error(`Command cwd is not a directory: ${a}`);return{workspaceRoot:e,cwd:a}}async function st(o,n){const t=await u.realpath(f.dirname(n));E(o,t);try{if((await u.lstat(n)).isSymbolicLink())throw new Error(`Refusing to write through symbolic link: ${n}`)}catch(e){if((typeof e=="object"&&e!==null?Reflect.get(e,"code"):void 0)!=="ENOENT")throw e}}async function R(o,n){const t=f.resolve(String(o||"").trim()),e=await u.realpath(t);if(!(await u.stat(e)).isDirectory())throw new Error(`Workspace path is not a directory: ${t}`);const r=n.trim();if(!r)throw new Error("file_path is required");const c=f.isAbsolute(r)?f.resolve(r):f.resolve(t,r),s=f.relative(t,c);if(s.startsWith("..")||f.isAbsolute(s))throw new Error(`Target path is outside workspace: ${c}`);return{workspaceRoot:e,requestedPath:c,targetPath:E(e,f.join(e,s))}}async function j(o,n,t){const e=await R(o,n),i=f.dirname(e.targetPath),r=!await q(i);await u.mkdir(i,{recursive:!0}),await st(e.workspaceRoot,e.targetPath);const c=f.join(i,`.${f.basename(e.targetPath)}.${process.pid}.${Y()}.tmp`);try{await u.writeFile(c,t,"utf-8"),await u.rename(c,e.targetPath)}catch(s){throw await u.rm(c,{force:!0}),s}return{workspaceRoot:e.workspaceRoot,targetPath:e.targetPath,bytes:Buffer.byteLength(t,"utf-8"),createdParentDirectory:r}}async function ct(o,n){const t=await R(o,n),e=E(t.workspaceRoot,await u.realpath(t.targetPath));if(!(await u.stat(e)).isFile())throw new Error(`Path is not a file: ${e}`);return{workspaceRoot:t.workspaceRoot,targetPath:e,content:await u.readFile(e,"utf-8")}}async function lt(o,n,t,e){const i=await R(o,n),r=E(i.workspaceRoot,await u.realpath(i.targetPath));if(!(await u.stat(r)).isFile())throw new Error(`Path is not a file: ${r}`);if(await W(r))return{workspaceRoot:i.workspaceRoot,targetPath:r,content:"[Binary file, content skipped]",isBinary:!0,truncated:!1,totalLines:0,shownFromLine:0,shownToLine:0};const s=C(r,{encoding:"utf-8"}),a=D.createInterface({input:s,crlfDelay:1/0});try{const d=[];let p=0,l=0,I=0,m=!1,w=!1;const S=t-1;for await(const L of a){if(l++,p<S){p++;continue}if(d.length>=e){m=!0,p++;continue}let x=L;x.length>v&&(x=x.slice(0,v)+`... (line truncated to ${v} chars)`);const k=`${p+1}: ${x}`,T=Buffer.byteLength(k,"utf-8")+1;if(I+T>Z){w=!0;break}d.push(k),I+=T,p++}if(l>0&&d.length===0&&!m&&!w&&S>=l)throw new Error(`offset ${t} exceeds total line count ${l} in file: ${r}`);const P=d.length>0?t:0,h=d.length>0?t+d.length-1:0;let b;w?b=`Output capped at 50 KB. Showing lines ${P}-${h}. Use offset=${h+1} to continue.`:m?b=`Showing lines ${P}-${h} of ${l}. Use offset=${h+1} to continue.`:b=`End of file - total ${l} lines`;const M=d.length>0?d.join(`
+`)+`
+`+b:b;return{workspaceRoot:i.workspaceRoot,targetPath:r,content:M,isBinary:!1,truncated:m||w,totalLines:w?-1:l,shownFromLine:P,shownToLine:h}}finally{a.close(),s.destroy()}}function G(o){let n="",t=0;for(;t<o.length;){const e=o[t];if(e==="*")n+="[^/]*";else if(e==="?")n+="[^/]";else if(e==="{"){const i=o.indexOf("}",t);if(i>=0){const r=o.slice(t+1,i);n+=`(${r.split(",").join("|")})`,t=i}else n+="\\{"}else if(e==="["){const i=o.indexOf("]",t);i>=0?(n+=o.slice(t,i+1),t=i):n+="\\["}else"+^$.()|\\".includes(e)?n+="\\"+e:n+=e;t++}return new RegExp(`^${n}$`)}async function ut(o,n,t,e){const i=[];async function r(c){if(i.length>=e)return;const s=await u.readdir(c,{withFileTypes:!0});for(const a of s){if(i.length>=e)return;if(a.name.startsWith(".")&&a.isDirectory())continue;const d=f.join(c,a.name);if(a.isDirectory()){if(it.has(a.name))continue;await r(d)}else if(a.isFile()){if(n&&!n.test(a.name)||t&&t.test(a.name))continue;i.push(d)}}}return await r(o),i}async function dt(o,n,t){if((await u.stat(o)).size>et)return{matches:[],count:0};if(await W(o))return{matches:[],count:0};const i=f.relative(n,o).replace(/\\/g,"/"),r=[];let c=0;const s=C(o,{encoding:"utf-8"}),a=D.createInterface({input:s,crlfDelay:1/0});try{let d=0;for await(const p of a)if(d++,t.regex.test(p)){if(c++,t.collectContent){let l=p;if(l.length>v&&(l=l.slice(0,v)+`... (line truncated to ${v} chars)`),r.push({file:i,line:d,content:l}),r.length>=t.maxResults)break}if(t.stopOnFirstMatch)break}}finally{a.close(),s.destroy()}return{matches:r,count:c}}const X=10*6e4,ft=X,pt=6e4,ht=10*6e4;function mt(o,n){return{kind:"builtin",toolName:"write_file",exposedName:"write_file",description:"Create or overwrite a UTF-8 text file inside the current workspace. Parent directories are created automatically.",inputSchema:{type:"object",properties:{file_path:{type:"string",description:"Workspace-relative file path to write."},content:{type:"string",description:"Complete UTF-8 file content."}},required:["file_path","content"],additionalProperties:!1},async execute(t){const e=_(t,["file_path","filePath"],"file_path"),i=_(t,["content"],"content"),r=await R(o,e),c=await q(r.targetPath),s=c?await u.readFile(r.targetPath,"utf-8").catch(()=>null):null,a=await j(o,e,i);if(n){const d=f.relative(a.workspaceRoot,a.targetPath).replace(/\\/g,"/");await n({filePath:d,operation:c?"UPDATE":"CREATE",beforeContent:s,afterContent:i})}return{ok:!0,tool:"write_file",workspacePath:y(a.workspaceRoot),filePath:y(a.targetPath),bytes:a.bytes,createdParentDirectory:a.createdParentDirectory}}}}function wt(o,n){return{kind:"builtin",toolName:"edit_file",exposedName:"edit_file",description:"Replace exactly one occurrence of old_string with new_string in a UTF-8 workspace text file.",inputSchema:{type:"object",properties:{file_path:{type:"string",description:"Workspace-relative file path to edit."},old_string:{type:"string",description:"Existing text to replace. Must occur exactly once."},new_string:{type:"string",description:"Replacement text."}},required:["file_path","old_string","new_string"],additionalProperties:!1},async execute(t){const e=_(t,["file_path","filePath"],"file_path"),i=_(t,["old_string","oldString"],"old_string"),r=_(t,["new_string","newString"],"new_string");if(!i)throw new Error("old_string must not be empty");const c=await ct(o,e),s=rt(c.content,i);if(s===0)throw new Error("old_string was not found in file");if(s>1)throw new Error(`old_string occurs ${s} times; provide a unique match`);const a=c.content.replace(i,r),d=await j(o,e,a);if(n){const p=f.relative(d.workspaceRoot,d.targetPath).replace(/\\/g,"/");await n({filePath:p,operation:"UPDATE",beforeContent:c.content,afterContent:a})}return{ok:!0,tool:"edit_file",workspacePath:y(d.workspaceRoot),filePath:y(d.targetPath),replacements:1,bytes:d.bytes}}}}function gt(o,n){return{kind:"builtin",toolName:"delete_file",exposedName:"delete_file",description:"Delete a file inside the current workspace. Returns an error if the file does not exist.",inputSchema:{type:"object",properties:{file_path:{type:"string",description:"Workspace-relative file path to delete."}},required:["file_path"],additionalProperties:!1},async execute(t){const e=_(t,["file_path","filePath"],"file_path"),i=await R(o,e),r=E(i.workspaceRoot,await u.realpath(i.targetPath).catch(()=>i.targetPath)),c=await u.stat(r).catch(()=>null);if(!c)throw new Error(`File does not exist: ${r}`);if(!c.isFile())throw new Error(`Path is not a file: ${r}`);const s=await u.readFile(r,"utf-8").catch(()=>null);if(await u.rm(r,{force:!0}),n){const a=f.relative(i.workspaceRoot,r).replace(/\\/g,"/");await n({filePath:a,operation:"DELETE",beforeContent:s,afterContent:null})}return{ok:!0,tool:"delete_file",workspacePath:y(i.workspaceRoot),filePath:y(r),deleted:!0}}}}function yt(o){return{kind:"builtin",toolName:"read_file",exposedName:"read_file",description:"Read a UTF-8 text file inside the current workspace. Returns content with line numbers in the format '<line>: <content>'. Supports offset (1-indexed line number to start from) and limit (max lines to return, default 2000). Output is capped at 2000 lines or 50 KB, whichever is reached first. Individual lines longer than 2000 characters are truncated. Avoid tiny repeated slices (e.g. 30-line chunks); read a larger window if more context is needed.",inputSchema:{type:"object",properties:{file_path:{type:"string",description:"Workspace-relative file path to read."},offset:{type:"number",description:"Line number to start reading from (1-indexed). Defaults to 1."},limit:{type:"number",description:"Maximum number of lines to return. Defaults to 2000."}},required:["file_path"],additionalProperties:!1},async execute(n){const t=_(n,["file_path","filePath"],"file_path"),e=A(n,["offset"],1),i=A(n,["limit"],H),r=await lt(o,t,e,i);return{ok:!0,tool:"read_file",workspacePath:y(r.workspaceRoot),filePath:y(r.targetPath),content:r.content,isBinary:r.isBinary,truncated:r.truncated,totalLines:r.totalLines,shownFromLine:r.shownFromLine,shownToLine:r.shownToLine}}}}function _t(o,n){return{kind:"builtin",toolName:"Bash",exposedName:"Bash",description:"Execute a shell command in the current workspace. Use for local diagnostics, builds, tests, and OS commands. The command runs with a bounded timeout and returns stdout, stderr, and exit code.",inputSchema:{type:"object",properties:{command:{type:"string",description:"Shell command to execute."},cwd:{type:"string",description:"Optional workspace-relative working directory. Defaults to the workspace root."},timeout_ms:{type:"number",description:"Optional timeout in milliseconds. Defaults to 600000 and is capped at 600000."},inactivity_timeout_ms:{type:"number",description:"Optional no-output timeout in milliseconds. Defaults to 60000 and is capped at 600000."},description:{type:"string",description:"Optional short reason for running the command."}},required:["command"],additionalProperties:!1},async execute(t,e){const i=_(t,["command"],"command").trim();if(!i)throw new Error("command must not be empty");const r=A(t,["timeout_ms","timeoutMs"],ft),c=Math.min(r,X),s=A(t,["inactivity_timeout_ms","inactivityTimeoutMs"],pt),a=Math.min(s,ht),d=O(t,["cwd"]),p=await at(o,d),l=await K({commandText:i,agentId:n,workspaceRoot:p.workspaceRoot,cwd:p.cwd,timeoutMs:c,inactivityTimeoutMs:a,onOutput:e?.onOutput});return{ok:l.exitCode===0&&!l.timedOut,tool:"Bash",command:i,cwd:y(p.cwd),exitCode:l.exitCode,signal:l.signal,timedOut:l.timedOut,inactivityTimedOut:l.inactivityTimedOut,timeoutMs:c,inactivityTimeoutMs:a,durationMs:l.durationMs,outputSpilled:l.outputSpilled,outputFilePath:l.outputFilePath,outputLineCount:l.outputLineCount,commandFilePath:l.commandFilePath,commandLineCount:l.commandLineCount,stdout:l.stdout,stderr:l.stderr}}}}function Pt(o){return{kind:"builtin",toolName:"grep",exposedName:"grep",description:"Search file contents using regular expressions within the workspace. Returns matched lines with file paths and line numbers. Supports include/exclude glob patterns, case-insensitive matching, and three output modes (content, files_with_matches, count). Searches recursively through directories, skipping binary files, hidden directories, and common build/dependency directories (node_modules, .git, dist, etc.).",inputSchema:{type:"object",properties:{pattern:{type:"string",description:"Regular expression pattern to search for in file contents."},path:{type:"string",description:"Workspace-relative file or directory path to search in. Defaults to the workspace root."},include:{type:"string",description:"Glob pattern to filter files by name (e.g. '*.ts', '*.{js,ts}'). Only matching files are searched."},exclude:{type:"string",description:"Glob pattern to exclude files by name (e.g. '*.test.ts'). Matching files are skipped."},case_insensitive:{type:"boolean",description:"Case-insensitive matching. Default false."},output_mode:{type:"string",enum:["content","files_with_matches","count"],description:"Output format: 'content' returns matched lines with line numbers (default), 'files_with_matches' returns only file paths with matches, 'count' returns match counts per file."},max_results:{type:"number",description:"Maximum number of matched lines to return (content mode). Default 1000."}},required:["pattern"],additionalProperties:!1},async execute(n){const t=_(n,["pattern"],"pattern"),e=O(n,["path"])||".",i=O(n,["include"]),r=O(n,["exclude"]),c=n.case_insensitive===!0,s=(()=>{const g=n.output_mode;return g==="files_with_matches"||g==="count"?g:"content"})(),a=A(n,["max_results"],ot),d=c?"i":"";let p;try{p=new RegExp(t,d)}catch(g){throw new Error(`Invalid regex pattern: ${g instanceof Error?g.message:String(g)}`)}const l=i?G(i):null,I=r?G(r):null,m=await R(o,e),w=E(m.workspaceRoot,await u.realpath(m.targetPath)),S=await u.stat(w);let P;if(S.isFile())P=[w];else if(S.isDirectory())P=await ut(w,l,I,tt);else throw new Error(`Path is neither a file nor a directory: ${w}`);const h=[],b=[],M=[];let L=0,x=0,k=!1;for(const g of P){if(s==="content"&&h.length>=a){k=!0;break}const z={regex:p,maxResults:s==="content"?a-h.length:Number.MAX_SAFE_INTEGER,collectContent:s==="content",stopOnFirstMatch:s==="files_with_matches"},F=await dt(g,m.workspaceRoot,z);if(F.count>0){const N=f.relative(m.workspaceRoot,g).replace(/\\/g,"/");if(M.push(N),L+=F.count,s==="content"){for(const $ of F.matches){const B=Buffer.byteLength($.content,"utf-8")+64;if(x+B>nt){k=!0;break}x+=B,h.push($)}if(k)break;if(h.length>=a){k=!0;break}}else s==="count"&&b.push({file:N,count:F.count})}}const T={ok:!0,tool:"grep",pattern:t,searchPath:y(m.targetPath),outputMode:s,filesSearched:P.length,filesMatched:M.length,totalMatches:L,truncated:k};return s==="content"?T.matches=h:s==="files_with_matches"?T.matches=M:T.matches=b,T}}}function Rt(o,n,t){const e=n||"unknown";return[yt(o),mt(o,t),wt(o,t),gt(o,t),Pt(o),_t(o,e),V(o)]}export{Rt as createBuiltInFileTools,E as ensureInsideWorkspace,R as resolveWorkspaceTarget};
+