patchwork-os 0.2.0-alpha.0

package/dist/tools/searchAndReplace.js

@@ -0,0 +1,281 @@
+import fs from "node:fs";
+import path from "node:path";
+import { resolveCommandPath } from "../probe.js";
+import { error, execSafe, optionalBool, optionalString, requireString, resolveFilePath, successStructured, } from "./utils.js";
+const MAX_FILES = 100;
+const MAX_FILE_SIZE = 2 * 1024 * 1024; // 2MB per file
+export function createSearchAndReplaceTool(workspace) {
+    return {
+        schema: {
+            name: "searchAndReplace",
+            description: "Find and replace across workspace files. Supports regex with capture groups. Returns modified files.",
+            annotations: { destructiveHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    pattern: {
+                        type: "string",
+                        description: "Text or regex pattern to search for",
+                    },
+                    replacement: {
+                        type: "string",
+                        description: "Replacement text. For regex mode, supports $1, $2, etc. capture group references.",
+                    },
+                    glob: {
+                        type: "string",
+                        description: "File glob pattern to limit scope (e.g. '**/*.ts', 'src/**/*.py'). Omit to search all text files.",
+                    },
+                    isRegex: {
+                        type: "boolean",
+                        description: "Treat pattern as a JavaScript regex. Default: false (literal string match).",
+                    },
+                    caseSensitive: {
+                        type: "boolean",
+                        description: "Case-sensitive match. Default: true.",
+                    },
+                    dryRun: {
+                        type: "boolean",
+                        description: "Preview changes without writing files. Default: false.",
+                    },
+                    includeIgnored: {
+                        type: "boolean",
+                        description: "Search inside .gitignored files (e.g. node_modules, build output). Default: false.",
+                    },
+                },
+                required: ["pattern", "replacement"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    matched: { type: "integer" },
+                    modified: { type: "integer" },
+                    totalReplacements: { type: "integer" },
+                    dryRun: { type: "boolean" },
+                    warning: { type: "string" },
+                    message: { type: "string" },
+                    files: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                file: { type: "string" },
+                                replacements: {
+                                    oneOf: [
+                                        { type: "integer" },
+                                        {
+                                            type: "string",
+                                            enum: ["skipped (file too large)"],
+                                        },
+                                    ],
+                                },
+                                written: { type: "boolean" },
+                                writeError: { type: "string" },
+                            },
+                            required: ["file", "replacements"],
+                        },
+                    },
+                },
+                required: ["matched", "modified", "dryRun", "files"],
+            },
+        },
+        handler: async (args, signal) => {
+            const pattern = requireString(args, "pattern");
+            const replacement = requireString(args, "replacement", 65536);
+            const glob = optionalString(args, "glob");
+            const isRegex = optionalBool(args, "isRegex") ?? false;
+            const caseSensitive = optionalBool(args, "caseSensitive") ?? true;
+            const dryRun = optionalBool(args, "dryRun") ?? false;
+            const includeIgnored = optionalBool(args, "includeIgnored") ?? false;
+            if (pattern.length === 0) {
+                return error("pattern must not be empty");
+            }
+            // A null byte terminates the rg -e argument at the OS level, causing rg to
+            // match every line while the JS replacement finds nothing — misleading output.
+            if (pattern.includes("\x00")) {
+                return error("pattern must not contain a null byte");
+            }
+            // Compile regex once (used for both counting matches and replacement)
+            let regex = null;
+            if (isRegex) {
+                // Reject patterns with nested quantifiers — these can cause catastrophic
+                // backtracking (ReDoS) when applied to large files. Same guard as waitForTerminalOutput.
+                if (/\([^)]*[+*]\)[+*?]/.test(pattern) ||
+                    /\([^)]*\{[^}]+\}\)[+*{?]/.test(pattern) ||
+                    /[+*][+*]|\{[^}]+\}[+*]/.test(pattern)) {
+                    return error("Pattern contains nested quantifiers (e.g. (a+)+) which can cause catastrophic backtracking. " +
+                        "Simplify the regex — use a literal string match or a non-nested quantifier.");
+                }
+                try {
+                    regex = new RegExp(pattern, caseSensitive ? "gm" : "gim");
+                }
+                catch (e) {
+                    return error(`Invalid regex pattern: ${e instanceof Error ? e.message : String(e)}`);
+                }
+            }
+            // Step 1: Find files containing the pattern via rg
+            const rgArgs = ["--files-with-matches", "-l"];
+            if (includeIgnored)
+                rgArgs.push("--no-ignore-vcs");
+            if (!caseSensitive)
+                rgArgs.push("-i");
+            if (isRegex) {
+                rgArgs.push("-e", pattern);
+            }
+            else {
+                rgArgs.push("-F", "-e", pattern);
+            }
+            if (glob) {
+                // Reject glob values that rg could misinterpret as flags or path escapes.
+                // Strip an optional leading '!' negation prefix before checking, then validate
+                // that the remaining pattern doesn't start with '-' (flags), '../' (path escape),
+                // or is an absolute path.
+                const normalizedGlobCheck = glob.startsWith("!") ? glob.slice(1) : glob;
+                if (normalizedGlobCheck.startsWith("-") ||
+                    normalizedGlobCheck.startsWith("../") ||
+                    path.isAbsolute(normalizedGlobCheck)) {
+                    return error(`Invalid glob pattern "${glob}": must not start with '-', '../', or be an absolute path`);
+                }
+                // rg applies --glob relative to the search root. A bare pattern like
+                // '*.ts' only matches files at the root level; 'src/*.ts' matches one
+                // level deep. Prepend '**/' when the glob contains no path separator so
+                // that '*.ts' becomes '**/*.ts' and matches files in any subdirectory —
+                // which is what every caller expects.
+                // Handle negation globs ('!*.ts') by prepending after the '!'.
+                const isNegation = glob.startsWith("!");
+                const rawPattern = isNegation ? glob.slice(1) : glob;
+                const needsPrefix = !rawPattern.includes("/") && !rawPattern.startsWith("**/");
+                const normalizedGlob = needsPrefix
+                    ? `${isNegation ? "!" : ""}**/${rawPattern}`
+                    : glob;
+                rgArgs.push("--glob", normalizedGlob);
+            }
+            rgArgs.push(workspace);
+            const findResult = await execSafe(resolveCommandPath("rg", workspace), rgArgs, {
+                cwd: workspace,
+                timeout: 15_000,
+                maxBuffer: 256 * 1024,
+                signal,
+            });
+            const matchedFiles = findResult.stdout
+                .split("\n")
+                .map((f) => f.trim())
+                .filter(Boolean);
+            if (matchedFiles.length === 0) {
+                return successStructured({
+                    matched: 0,
+                    modified: 0,
+                    dryRun,
+                    files: [],
+                    message: "No files contain the search pattern.",
+                });
+            }
+            if (matchedFiles.length > MAX_FILES) {
+                return error(`Pattern matches ${matchedFiles.length} files — exceeds safety limit of ${MAX_FILES}. Narrow the scope with the 'glob' parameter (e.g. 'src/**/*.ts') before proceeding.`);
+            }
+            // Step 2: For each file, read, replace, and optionally write
+            // Process files in parallel batches (bounded concurrency to avoid fd exhaustion)
+            const CONCURRENCY = 10;
+            const processFile = async (filePath, fileSignal) => {
+                // Safety: only operate within workspace. Use the validated real path for
+                // all subsequent fs operations — do NOT call path.resolve(filePath) again,
+                // as that would bypass the symlink resolution done inside resolveFilePath.
+                let resolved;
+                try {
+                    resolved = resolveFilePath(filePath, workspace, { write: true });
+                }
+                catch {
+                    return null;
+                }
+                let content;
+                try {
+                    const stat = await fs.promises.stat(resolved);
+                    if (stat.size > MAX_FILE_SIZE) {
+                        return {
+                            file: filePath,
+                            replacements: "skipped (file too large)",
+                            written: false,
+                        };
+                    }
+                    content = await fs.promises.readFile(resolved, {
+                        encoding: "utf-8",
+                        signal: fileSignal,
+                    });
+                }
+                catch {
+                    return null;
+                }
+                let newContent;
+                let count = 0;
+                if (regex) {
+                    // Create a fresh RegExp per file — the shared `regex` object has the `g`
+                    // flag, and `.lastIndex` is mutable state. Concurrent `processFile` calls
+                    // inside `Promise.all` would race on that single object across `await`
+                    // boundaries, producing incorrect match counts or wrong replacements.
+                    const localRegex = new RegExp(regex.source, regex.flags);
+                    const matches = content.match(localRegex);
+                    count = matches ? matches.length : 0;
+                    newContent = content.replace(localRegex, replacement);
+                }
+                else {
+                    const parts = content.split(pattern);
+                    count = parts.length - 1;
+                    newContent = parts.join(replacement);
+                }
+                if (count === 0)
+                    return null;
+                if (!dryRun) {
+                    try {
+                        await fs.promises.writeFile(resolved, newContent, {
+                            encoding: "utf-8",
+                            signal: fileSignal,
+                        });
+                        return { file: filePath, replacements: count, written: true };
+                    }
+                    catch (err) {
+                        return {
+                            file: filePath,
+                            replacements: count,
+                            written: false,
+                            writeError: err instanceof Error ? err.message : String(err),
+                        };
+                    }
+                }
+                return { file: filePath, replacements: count, written: false };
+            };
+            const results = [];
+            for (let i = 0; i < matchedFiles.length; i += CONCURRENCY) {
+                if (signal?.aborted)
+                    break;
+                const batch = matchedFiles.slice(i, i + CONCURRENCY);
+                const batchResults = await Promise.all(batch.map((f) => processFile(f, signal)));
+                for (const r of batchResults) {
+                    if (r !== null)
+                        results.push(r);
+                }
+            }
+            const totalReplacements = results.reduce((sum, r) => sum + (typeof r.replacements === "number" ? r.replacements : 0), 0);
+            const writtenCount = results.filter((r) => r.written).length;
+            const failedCount = results.filter((r) => !dryRun &&
+                !r.written &&
+                typeof r.replacements === "number" &&
+                r.replacements > 0).length;
+            return successStructured({
+                matched: matchedFiles.length,
+                modified: writtenCount,
+                totalReplacements,
+                dryRun,
+                ...(failedCount > 0 && {
+                    warning: `${writtenCount} file(s) written, ${failedCount} file(s) failed to write — check per-file results`,
+                }),
+                files: results.map((r) => ({
+                    file: r.file,
+                    replacements: r.replacements,
+                    ...(dryRun ? {} : { written: r.written }),
+                    ...(r.writeError && { writeError: r.writeError }),
+                })),
+            });
+        },
+    };
+}
+//# sourceMappingURL=searchAndReplace.js.map

package/dist/tools/searchAndReplace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchAndReplace.js","sourceRoot":"","sources":["../../src/tools/searchAndReplace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,aAAa,EACb,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,eAAe;AAEtD,MAAM,UAAU,0BAA0B,CAAC,SAAiB;IAC1D,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,kBAAkB;YACxB,WAAW,EACT,sGAAsG;YACxG,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;YACtC,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,OAAO,EAAE;wBACP,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,qCAAqC;qBACnD;oBACD,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,mFAAmF;qBACtF;oBACD,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,kGAAkG;qBACrG;oBACD,OAAO,EAAE;wBACP,IAAI,EAAE,SAAS;wBACf,WAAW,EACT,6EAA6E;qBAChF;oBACD,aAAa,EAAE;wBACb,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,sCAAsC;qBACpD;oBACD,MAAM,EAAE;wBACN,IAAI,EAAE,SAAS;wBACf,WAAW,EACT,wDAAwD;qBAC3D;oBACD,cAAc,EAAE;wBACd,IAAI,EAAE,SAAS;wBACf,WAAW,EACT,oFAAoF;qBACvF;iBACF;gBACD,QAAQ,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC;gBACpC,oBAAoB,EAAE,KAAc;aACrC;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,OAAO,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE;oBACrC,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE;oBACtC,iBAAiB,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE;oBAC/C,MAAM,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE;oBACpC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;oBACpC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;oBACpC,KAAK,EAAE;wBACL,IAAI,EAAE,OAAgB;wBACtB,KAAK,EAAE;4BACL,IAAI,EAAE,QAAiB;4BACvB,UAAU,EAAE;gCACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;gCACjC,YAAY,EAAE;oCACZ,KAAK,EAAE;wCACL,EAAE,IAAI,EAAE,SAAkB,EAAE;wCAC5B;4CACE,IAAI,EAAE,QAAiB;4CACvB,IAAI,EAAE,CAAC,0BAA0B,CAAC;yCACnC;qCACF;iCACF;gCACD,OAAO,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE;gCACrC,UAAU,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;6BACxC;4BACD,QAAQ,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC;yBACnC;qBACF;iBACF;gBACD,QAAQ,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC;aACrD;SACF;QACD,OAAO,EAAE,KAAK,EAAE,IAA6B,EAAE,MAAoB,EAAE,EAAE;YACrE,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC/C,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;YAC9D,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC1C,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,KAAK,CAAC;YACvD,MAAM,aAAa,GAAG,YAAY,CAAC,IAAI,EAAE,eAAe,CAAC,IAAI,IAAI,CAAC;YAClE,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,KAAK,CAAC;YACrD,MAAM,cAAc,GAAG,YAAY,CAAC,IAAI,EAAE,gBAAgB,CAAC,IAAI,KAAK,CAAC;YAErE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAC5C,CAAC;YACD,2EAA2E;YAC3E,+EAA+E;YAC/E,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC7B,OAAO,KAAK,CAAC,sCAAsC,CAAC,CAAC;YACvD,CAAC;YACD,sEAAsE;YACtE,IAAI,KAAK,GAAkB,IAAI,CAAC;YAChC,IAAI,OAAO,EAAE,CAAC;gBACZ,yEAAyE;gBACzE,yFAAyF;gBACzF,IACE,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC;oBAClC,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC;oBACxC,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,EACtC,CAAC;oBACD,OAAO,KAAK,CACV,8FAA8F;wBAC5F,6EAA6E,CAChF,CAAC;gBACJ,CAAC;gBACD,IAAI,CAAC;oBACH,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBAC5D,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,KAAK,CACV,0BAA0B,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACvE,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,mDAAmD;YACnD,MAAM,MAAM,GAAG,CAAC,sBAAsB,EAAE,IAAI,CAAC,CAAC;YAC9C,IAAI,cAAc;gBAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YACnD,IAAI,CAAC,aAAa;gBAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YACnC,CAAC;YACD,IAAI,IAAI,EAAE,CAAC;gBACT,0EAA0E;gBAC1E,+EAA+E;gBAC/E,kFAAkF;gBAClF,0BAA0B;gBAC1B,MAAM,mBAAmB,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBACxE,IACE,mBAAmB,CAAC,UAAU,CAAC,GAAG,CAAC;oBACnC,mBAAmB,CAAC,UAAU,CAAC,KAAK,CAAC;oBACrC,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,EACpC,CAAC;oBACD,OAAO,KAAK,CACV,yBAAyB,IAAI,2DAA2D,CACzF,CAAC;gBACJ,CAAC;gBACD,qEAAqE;gBACrE,sEAAsE;gBACtE,wEAAwE;gBACxE,wEAAwE;gBACxE,sCAAsC;gBACtC,+DAA+D;gBAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;gBACxC,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBACrD,MAAM,WAAW,GACf,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBAC7D,MAAM,cAAc,GAAG,WAAW;oBAChC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,UAAU,EAAE;oBAC5C,CAAC,CAAC,IAAI,CAAC;gBACT,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;YACxC,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAEvB,MAAM,UAAU,GAAG,MAAM,QAAQ,CAC/B,kBAAkB,CAAC,IAAI,EAAE,SAAS,CAAC,EACnC,MAAM,EACN;gBACE,GAAG,EAAE,SAAS;gBACd,OAAO,EAAE,MAAM;gBACf,SAAS,EAAE,GAAG,GAAG,IAAI;gBACrB,MAAM;aACP,CACF,CAAC;YAEF,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM;iBACnC,KAAK,CAAC,IAAI,CAAC;iBACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;iBACpB,MAAM,CAAC,OAAO,CAAC,CAAC;YAEnB,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9B,OAAO,iBAAiB,CAAC;oBACvB,OAAO,EAAE,CAAC;oBACV,QAAQ,EAAE,CAAC;oBACX,MAAM;oBACN,KAAK,EAAE,EAAE;oBACT,OAAO,EAAE,sCAAsC;iBAChD,CAAC,CAAC;YACL,CAAC;YAED,IAAI,YAAY,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;gBACpC,OAAO,KAAK,CACV,mBAAmB,YAAY,CAAC,MAAM,oCAAoC,SAAS,sFAAsF,CAC1K,CAAC;YACJ,CAAC;YAED,6DAA6D;YAC7D,iFAAiF;YACjF,MAAM,WAAW,GAAG,EAAE,CAAC;YASvB,MAAM,WAAW,GAAG,KAAK,EACvB,QAAgB,EAChB,UAAwB,EACI,EAAE;gBAC9B,yEAAyE;gBACzE,2EAA2E;gBAC3E,2EAA2E;gBAC3E,IAAI,QAAgB,CAAC;gBACrB,IAAI,CAAC;oBACH,QAAQ,GAAG,eAAe,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBACnE,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,IAAI,CAAC;gBACd,CAAC;gBAED,IAAI,OAAe,CAAC;gBACpB,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAC9C,IAAI,IAAI,CAAC,IAAI,GAAG,aAAa,EAAE,CAAC;wBAC9B,OAAO;4BACL,IAAI,EAAE,QAAQ;4BACd,YAAY,EAAE,0BAA0B;4BACxC,OAAO,EAAE,KAAK;yBACf,CAAC;oBACJ,CAAC;oBACD,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE;wBAC7C,QAAQ,EAAE,OAAO;wBACjB,MAAM,EAAE,UAAU;qBACnB,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,IAAI,CAAC;gBACd,CAAC;gBAED,IAAI,UAAkB,CAAC;gBACvB,IAAI,KAAK,GAAG,CAAC,CAAC;gBAEd,IAAI,KAAK,EAAE,CAAC;oBACV,yEAAyE;oBACzE,0EAA0E;oBAC1E,uEAAuE;oBACvE,sEAAsE;oBACtE,MAAM,UAAU,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;oBACzD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;oBAC1C,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;oBACrC,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;gBACxD,CAAC;qBAAM,CAAC;oBACN,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;oBACrC,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;oBACzB,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBACvC,CAAC;gBAED,IAAI,KAAK,KAAK,CAAC;oBAAE,OAAO,IAAI,CAAC;gBAE7B,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,IAAI,CAAC;wBACH,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE;4BAChD,QAAQ,EAAE,OAAO;4BACjB,MAAM,EAAE,UAAU;yBACnB,CAAC,CAAC;wBACH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;oBAChE,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,OAAO;4BACL,IAAI,EAAE,QAAQ;4BACd,YAAY,EAAE,KAAK;4BACnB,OAAO,EAAE,KAAK;4BACd,UAAU,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;yBAC7D,CAAC;oBACJ,CAAC;gBACH,CAAC;gBACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YACjE,CAAC,CAAC;YAEF,MAAM,OAAO,GAAiB,EAAE,CAAC;YACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC;gBAC1D,IAAI,MAAM,EAAE,OAAO;oBAAE,MAAM;gBAC3B,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC;gBACrD,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CACpC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CACzC,CAAC;gBACF,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;oBAC7B,IAAI,CAAC,KAAK,IAAI;wBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC;YAED,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CACtC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CACT,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,EACjE,CAAC,CACF,CAAC;YACF,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;YAC7D,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAChC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,MAAM;gBACP,CAAC,CAAC,CAAC,OAAO;gBACV,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ;gBAClC,CAAC,CAAC,YAAY,GAAG,CAAC,CACrB,CAAC,MAAM,CAAC;YAET,OAAO,iBAAiB,CAAC;gBACvB,OAAO,EAAE,YAAY,CAAC,MAAM;gBAC5B,QAAQ,EAAE,YAAY;gBACtB,iBAAiB;gBACjB,MAAM;gBACN,GAAG,CAAC,WAAW,GAAG,CAAC,IAAI;oBACrB,OAAO,EAAE,GAAG,YAAY,qBAAqB,WAAW,mDAAmD;iBAC5G,CAAC;gBACF,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACzB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,YAAY,EAAE,CAAC,CAAC,YAAY;oBAC5B,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;oBACzC,GAAG,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC;iBAClD,CAAC,CAAC;aACJ,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/searchTools.d.ts

@@ -0,0 +1,61 @@
+import type { McpTransport } from "../transport.js";
+export declare function createSearchToolsTool(transport: McpTransport): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        cache_control: {
+            type: "ephemeral";
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                query: {
+                    type: "string";
+                    description: string;
+                };
+                categories: {
+                    type: "array";
+                    description: string;
+                    items: {
+                        type: "string";
+                    };
+                };
+                limit: {
+                    type: "integer";
+                    description: string;
+                    minimum: number;
+                    maximum: number;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                tools: {
+                    type: "array";
+                };
+                totalMatched: {
+                    type: "integer";
+                };
+                query: {
+                    type: "string";
+                };
+                categories: {
+                    type: "array";
+                };
+            };
+            required: string[];
+        };
+    };
+    handler: (args: Record<string, unknown>) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    }>;
+};

package/dist/tools/searchTools.js

@@ -0,0 +1,85 @@
+import { successStructured } from "./utils.js";
+const DEFAULT_LIMIT = 10;
+const MAX_LIMIT = 50;
+export function createSearchToolsTool(transport) {
+    return {
+        schema: {
+            name: "searchTools",
+            description: "Find available tools by keyword or category. Use before browsing tools/list to avoid loading all schemas.",
+            annotations: { readOnlyHint: true },
+            cache_control: { type: "ephemeral" },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    query: {
+                        type: "string",
+                        description: "Keyword to match against tool name and description",
+                    },
+                    categories: {
+                        type: "array",
+                        description: "Filter by categories (e.g. lsp, git, terminal, debug, editor, analysis, github, bridge)",
+                        items: { type: "string" },
+                    },
+                    limit: {
+                        type: "integer",
+                        description: `Max results to return (default ${DEFAULT_LIMIT}, max ${MAX_LIMIT})`,
+                        minimum: 1,
+                        maximum: MAX_LIMIT,
+                    },
+                },
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    tools: { type: "array" },
+                    totalMatched: { type: "integer" },
+                    query: { type: "string" },
+                    categories: { type: "array" },
+                },
+                required: ["tools", "totalMatched"],
+            },
+        },
+        handler: async (args) => {
+            const query = typeof args.query === "string" ? args.query.toLowerCase().trim() : "";
+            const filterCategories = Array.isArray(args.categories) &&
+                args.categories.every((c) => typeof c === "string")
+                ? args.categories.map((c) => c.toLowerCase())
+                : [];
+            const limit = typeof args.limit === "number"
+                ? Math.min(Math.max(1, Math.floor(args.limit)), MAX_LIMIT)
+                : DEFAULT_LIMIT;
+            const allSchemas = transport.getToolSchemas();
+            const matched = allSchemas.filter((t) => {
+                // Category filter: if specified, tool must belong to at least one of them
+                if (filterCategories.length > 0) {
+                    const toolCats = (t.categories ?? []).map((c) => c.toLowerCase());
+                    if (!filterCategories.some((fc) => toolCats.includes(fc))) {
+                        return false;
+                    }
+                }
+                // Keyword filter: match against name or description
+                if (query) {
+                    const haystack = `${t.name} ${t.description}`.toLowerCase();
+                    if (!haystack.includes(query))
+                        return false;
+                }
+                return true;
+            });
+            const tools = matched.slice(0, limit).map((t) => ({
+                name: t.name,
+                description: t.description,
+                ...(t.categories ? { categories: t.categories } : {}),
+            }));
+            return successStructured({
+                tools,
+                totalMatched: matched.length,
+                ...(query ? { query } : {}),
+                ...(filterCategories.length > 0
+                    ? { categories: filterCategories }
+                    : {}),
+            });
+        },
+    };
+}
+//# sourceMappingURL=searchTools.js.map

package/dist/tools/searchTools.js.map

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

package/dist/tools/searchWorkspace.d.ts

@@ -0,0 +1,99 @@
+import type { ProbeResults } from "../probe.js";
+import type { ProgressFn } from "../transport.js";
+export declare function createSearchWorkspaceTool(workspace: string, probes: ProbeResults): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                query: {
+                    type: string;
+                    description: string;
+                };
+                fileGlob: {
+                    type: string;
+                    description: string;
+                };
+                isRegex: {
+                    type: string;
+                    description: string;
+                };
+                caseSensitive: {
+                    type: string;
+                    description: string;
+                };
+                maxResults: {
+                    type: string;
+                    description: string;
+                    minimum: number;
+                    maximum: number;
+                };
+                contextLines: {
+                    type: string;
+                    description: string;
+                    minimum: number;
+                    maximum: number;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                matches: {
+                    type: string;
+                    items: {
+                        type: string;
+                        properties: {
+                            file: {
+                                type: string;
+                            };
+                            line: {
+                                type: string;
+                            };
+                            matchText: {
+                                type: string;
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                totalMatches: {
+                    type: string;
+                };
+                tool: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                truncated: {
+                    type: string;
+                    description: string;
+                };
+                note: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    handler: (args: Record<string, unknown>, signal?: AbortSignal, progress?: ProgressFn) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+            _meta?: Record<string, unknown>;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+};