patchwork-os 0.2.0-alpha.0

package/dist/tools/searchWorkspace.js

@@ -0,0 +1,189 @@
+import { resolveCommandPath } from "../probe.js";
+import { error, execSafe, makeRelative, optionalBool, optionalInt, optionalString, requireString, successStructuredLarge, } from "./utils.js";
+export function createSearchWorkspaceTool(workspace, probes) {
+    return {
+        schema: {
+            name: "searchWorkspace",
+            description: "Search workspace files via ripgrep. Returns matching lines with file paths and line numbers.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    query: {
+                        type: "string",
+                        description: "Search pattern (text or regex)",
+                    },
+                    fileGlob: {
+                        type: "string",
+                        description: "Optional glob to filter files (e.g. '*.ts')",
+                    },
+                    isRegex: {
+                        type: "boolean",
+                        description: "Treat query as regex (default: false)",
+                    },
+                    caseSensitive: {
+                        type: "boolean",
+                        description: "Case-sensitive search (default: true)",
+                    },
+                    maxResults: {
+                        type: "integer",
+                        description: "Max results to return (default: 50, max: 200; pass higher value explicitly for broader searches)",
+                        minimum: 1,
+                        maximum: 200,
+                    },
+                    contextLines: {
+                        type: "integer",
+                        description: "Lines of context around matches (default: 0, max: 5)",
+                        minimum: 0,
+                        maximum: 5,
+                    },
+                },
+                required: ["query"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    matches: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                file: { type: "string" },
+                                line: { type: "integer" },
+                                matchText: { type: "string" },
+                            },
+                            required: ["file", "line", "matchText"],
+                        },
+                    },
+                    totalMatches: { type: "integer" },
+                    tool: {
+                        type: "string",
+                        enum: ["rg", "grep"],
+                        description: "Search backend used",
+                    },
+                    truncated: {
+                        type: "boolean",
+                        description: "True when maxResults was reached",
+                    },
+                    note: { type: "string" },
+                },
+                required: ["matches", "totalMatches", "tool"],
+            },
+        },
+        handler: async (args, signal, progress) => {
+            progress?.(0, 100);
+            const query = requireString(args, "query", 500);
+            if (query.trim().length === 0)
+                throw new Error("query must not be empty");
+            const fileGlob = optionalString(args, "fileGlob", 200);
+            const isRegex = optionalBool(args, "isRegex") ?? false;
+            const caseSensitive = optionalBool(args, "caseSensitive") ?? true;
+            const maxResults = optionalInt(args, "maxResults", 1, 200) ?? 50;
+            const contextLines = optionalInt(args, "contextLines", 0, 5) ?? 0;
+            // Reject patterns with nested quantifiers — these cause catastrophic backtracking (ReDoS)
+            if (isRegex) {
+                if (/\([^)]*[+*]\)[+*?]/.test(query) ||
+                    /\([^)]*\{[^}]+\}\)[+*{?]/.test(query) ||
+                    /[+*][+*]|\{[^}]+\}[+*]/.test(query)) {
+                    return error("Pattern contains nested quantifiers (e.g. (a+)+) which can cause catastrophic backtracking (ReDoS). " +
+                        "Simplify the regex — use a literal string match or a non-nested quantifier.");
+                }
+            }
+            if (probes.rg) {
+                // Use ripgrep
+                const rgArgs = ["--json", "--max-count", String(maxResults)];
+                if (fileGlob)
+                    rgArgs.push("--glob", fileGlob);
+                if (!caseSensitive)
+                    rgArgs.push("-i");
+                if (!isRegex)
+                    rgArgs.push("--fixed-strings");
+                if (contextLines > 0)
+                    rgArgs.push("-C", String(contextLines));
+                rgArgs.push("--", query, workspace);
+                const result = await execSafe(resolveCommandPath("rg", workspace), rgArgs, {
+                    timeout: 15000,
+                    maxBuffer: 1024 * 1024,
+                    signal,
+                });
+                // Parse ripgrep JSON output
+                const matches = [];
+                for (const line of result.stdout.split("\n")) {
+                    if (!line.trim())
+                        continue;
+                    try {
+                        const entry = JSON.parse(line);
+                        if (entry.type === "match") {
+                            const d = entry.data;
+                            const filePath = d.path?.text ?? "";
+                            matches.push({
+                                file: makeRelative(filePath, workspace),
+                                line: d.line_number,
+                                column: d.submatches?.[0]?.start ?? 0,
+                                matchText: d.lines?.text?.trimEnd() ?? "",
+                            });
+                        }
+                    }
+                    catch {
+                        /* skip unparseable lines */
+                    }
+                }
+                const truncated = matches.length >= maxResults;
+                return successStructuredLarge({
+                    matches,
+                    totalMatches: matches.length,
+                    tool: "rg",
+                    ...(truncated && {
+                        truncated: true,
+                        note: "Result limit reached — increase maxResults or narrow your query",
+                    }),
+                });
+            }
+            // Fallback to grep
+            const grepArgs = ["-rn"];
+            if (fileGlob)
+                grepArgs.push("--include", fileGlob);
+            if (!caseSensitive)
+                grepArgs.push("-i");
+            if (!isRegex)
+                grepArgs.push("-F");
+            else
+                grepArgs.push("-E");
+            if (contextLines > 0)
+                grepArgs.push(`-C${contextLines}`);
+            grepArgs.push("--", query, workspace);
+            const result = await execSafe("grep", grepArgs, {
+                timeout: 15000,
+                maxBuffer: 1024 * 1024,
+                signal,
+            });
+            const matches = [];
+            for (const line of result.stdout.split("\n")) {
+                const match = line.match(/^(.+?):(\d+):(.*)$/);
+                if (match) {
+                    const filePath = match[1] ?? "";
+                    matches.push({
+                        file: makeRelative(filePath, workspace),
+                        line: Number.parseInt(match[2] ?? "0", 10),
+                        matchText: match[3]?.trimEnd() ?? "",
+                    });
+                    if (matches.length >= maxResults)
+                        break;
+                }
+            }
+            const truncated = matches.length >= maxResults;
+            progress?.(100, 100);
+            return successStructuredLarge({
+                matches,
+                totalMatches: matches.length,
+                tool: "grep",
+                ...(truncated && {
+                    truncated: true,
+                    note: "Result limit reached — increase maxResults or narrow your query",
+                }),
+            });
+        },
+    };
+}
+//# sourceMappingURL=searchWorkspace.js.map

package/dist/tools/searchWorkspace.js.map

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

package/dist/tools/selectionRanges.d.ts

@@ -0,0 +1,58 @@
+import type { ExtensionClient } from "../extensionClient.js";
+export declare function createSelectionRangesTool(workspace: string, extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        extensionRequired: boolean;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                filePath: {
+                    type: "string";
+                    description: string;
+                };
+                line: {
+                    type: "integer";
+                    description: string;
+                };
+                column: {
+                    type: "integer";
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                ranges: {
+                    type: "array";
+                    items: {
+                        type: "object";
+                    };
+                };
+                count: {
+                    type: "number";
+                };
+            };
+            required: string[];
+        };
+    };
+    handler: (args: Record<string, unknown>, signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+};

package/dist/tools/selectionRanges.js

@@ -0,0 +1,61 @@
+import { lspColdStartError, lspWithRetry } from "./lsp.js";
+import { extensionRequired, requireInt, requireString, resolveFilePath, successStructured, } from "./utils.js";
+export function createSelectionRangesTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "selectionRanges",
+            extensionRequired: true,
+            description: "Hierarchical selection ranges at position: identifier→expression→block→function→class.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Workspace or absolute path",
+                    },
+                    line: {
+                        type: "integer",
+                        description: "Line number (1-based)",
+                    },
+                    column: {
+                        type: "integer",
+                        description: "Column (1-based)",
+                    },
+                },
+                required: ["filePath", "line", "column"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    ranges: {
+                        type: "array",
+                        items: { type: "object" },
+                    },
+                    count: { type: "number" },
+                },
+                required: ["ranges", "count"],
+            },
+        },
+        handler: async (args, signal) => {
+            const filePath = resolveFilePath(requireString(args, "filePath"), workspace);
+            const line = requireInt(args, "line", 1);
+            const column = requireInt(args, "column", 1);
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("selectionRanges (LSP selection hierarchy)", [
+                    "Use getDocumentSymbols to get the structural outline of the file",
+                ]);
+            }
+            const result = await lspWithRetry(() => extensionClient.selectionRanges(filePath, line, column, signal), signal);
+            if (result === "timeout")
+                return lspColdStartError();
+            if (result === null) {
+                return successStructured({ ranges: [], count: 0 });
+            }
+            const data = result;
+            return successStructured({ ...data, count: data.ranges.length });
+        },
+    };
+}
+//# sourceMappingURL=selectionRanges.js.map

package/dist/tools/selectionRanges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectionRanges.js","sourceRoot":"","sources":["../../src/tools/selectionRanges.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,MAAM,UAAU,yBAAyB,CACvC,SAAiB,EACjB,eAAgC;IAEhC,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,iBAAiB;YACvB,iBAAiB,EAAE,IAAI;YACvB,WAAW,EACT,wFAAwF;YAC1F,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;YACnC,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,QAAQ,EAAE;wBACR,IAAI,EAAE,QAAiB;wBACvB,WAAW,EAAE,4BAA4B;qBAC1C;oBACD,IAAI,EAAE;wBACJ,IAAI,EAAE,SAAkB;wBACxB,WAAW,EAAE,uBAAuB;qBACrC;oBACD,MAAM,EAAE;wBACN,IAAI,EAAE,SAAkB;wBACxB,WAAW,EAAE,kBAAkB;qBAChC;iBACF;gBACD,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC;gBACxC,oBAAoB,EAAE,KAAc;aACrC;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,MAAM,EAAE;wBACN,IAAI,EAAE,OAAgB;wBACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;qBACnC;oBACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;iBACnC;gBACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;aAC9B;SACF;QACD,OAAO,EAAE,KAAK,EAAE,IAA6B,EAAE,MAAoB,EAAE,EAAE;YACrE,MAAM,QAAQ,GAAG,eAAe,CAC9B,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,EAC/B,SAAS,CACV,CAAC;YACF,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;YAC7C,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC;gBACnC,OAAO,iBAAiB,CAAC,2CAA2C,EAAE;oBACpE,kEAAkE;iBACnE,CAAC,CAAC;YACL,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B,GAAG,EAAE,CAAC,eAAe,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EACrE,MAAM,CACP,CAAC;YACF,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,iBAAiB,EAAE,CAAC;YACrD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,OAAO,iBAAiB,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YACrD,CAAC;YACD,MAAM,IAAI,GAAG,MAA+B,CAAC;YAC7C,OAAO,iBAAiB,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACnE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/semanticTokens.d.ts

@@ -0,0 +1,87 @@
+import type { ExtensionClient } from "../extensionClient.js";
+export declare function createGetSemanticTokensTool(workspace: string, extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        extensionRequired: boolean;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                filePath: {
+                    type: "string";
+                    description: string;
+                };
+                startLine: {
+                    type: "integer";
+                    description: string;
+                    minimum: number;
+                };
+                endLine: {
+                    type: "integer";
+                    description: string;
+                    minimum: number;
+                };
+                maxTokens: {
+                    type: "integer";
+                    description: string;
+                    minimum: number;
+                    maximum: number;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                tokens: {
+                    type: "array";
+                    items: {
+                        type: "object";
+                    };
+                };
+                count: {
+                    type: "number";
+                };
+                capped: {
+                    type: "boolean";
+                };
+                legend: {
+                    type: "object";
+                    properties: {
+                        tokenTypes: {
+                            type: "array";
+                            items: {
+                                type: "string";
+                            };
+                        };
+                        tokenModifiers: {
+                            type: "array";
+                            items: {
+                                type: "string";
+                            };
+                        };
+                    };
+                    required: string[];
+                };
+            };
+            required: string[];
+        };
+    };
+    handler(args: Record<string, unknown>, signal?: AbortSignal): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+};

package/dist/tools/semanticTokens.js

@@ -0,0 +1,86 @@
+import { lspColdStartError, lspWithRetry } from "./lsp.js";
+import { extensionRequired, optionalInt, requireString, resolveFilePath, successStructured, } from "./utils.js";
+export function createGetSemanticTokensTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "getSemanticTokens",
+            extensionRequired: true,
+            description: "Semantic token types and modifiers for a file from the language server.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Workspace or absolute path",
+                    },
+                    startLine: {
+                        type: "integer",
+                        description: "First line to include (1-based, optional)",
+                        minimum: 1,
+                    },
+                    endLine: {
+                        type: "integer",
+                        description: "Last line to include (1-based, inclusive, optional)",
+                        minimum: 1,
+                    },
+                    maxTokens: {
+                        type: "integer",
+                        description: "Max tokens to return (default: 2000, max: 5000)",
+                        minimum: 1,
+                        maximum: 5000,
+                    },
+                },
+                required: ["filePath"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    tokens: {
+                        type: "array",
+                        items: { type: "object" },
+                    },
+                    count: { type: "number" },
+                    capped: { type: "boolean" },
+                    legend: {
+                        type: "object",
+                        properties: {
+                            tokenTypes: {
+                                type: "array",
+                                items: { type: "string" },
+                            },
+                            tokenModifiers: {
+                                type: "array",
+                                items: { type: "string" },
+                            },
+                        },
+                        required: ["tokenTypes", "tokenModifiers"],
+                    },
+                },
+                required: ["tokens", "count", "capped", "legend"],
+            },
+        },
+        async handler(args, signal) {
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("getSemanticTokens");
+            }
+            const filePath = resolveFilePath(requireString(args, "filePath"), workspace);
+            const startLine = optionalInt(args, "startLine");
+            const endLine = optionalInt(args, "endLine");
+            const maxTokens = optionalInt(args, "maxTokens");
+            const result = await lspWithRetry(() => extensionClient.getSemanticTokens(filePath, startLine ?? undefined, endLine ?? undefined, maxTokens ?? undefined, signal), signal);
+            if (result === "timeout")
+                return lspColdStartError();
+            if (result === null)
+                return successStructured({
+                    tokens: [],
+                    count: 0,
+                    capped: false,
+                    legend: { tokenTypes: [], tokenModifiers: [] },
+                });
+            return successStructured(result);
+        },
+    };
+}
+//# sourceMappingURL=semanticTokens.js.map

package/dist/tools/semanticTokens.js.map

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

package/dist/tools/setActiveWorkspaceFolder.d.ts

@@ -0,0 +1,41 @@
+import type { Config } from "../config.js";
+export declare function createSetActiveWorkspaceFolderTool(config: Config): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            idempotentHint: boolean;
+        };
+        inputSchema: {
+            $schema: string;
+            type: "object";
+            required: string[];
+            properties: {
+                path: {
+                    type: "string";
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                set: {
+                    type: string;
+                };
+                activeWorkspaceFolder: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    handler(args: Record<string, unknown>): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    }>;
+};

package/dist/tools/setActiveWorkspaceFolder.js

@@ -0,0 +1,38 @@
+import path from "node:path";
+import { requireString, successStructured } from "./utils.js";
+export function createSetActiveWorkspaceFolderTool(config) {
+    return {
+        schema: {
+            name: "setActiveWorkspaceFolder",
+            description: "Set active workspace folder for file ops. Useful in multi-root workspaces.",
+            annotations: { idempotentHint: true },
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                required: ["path"],
+                properties: {
+                    path: {
+                        type: "string",
+                        description: "Absolute path to the workspace folder to activate",
+                    },
+                },
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    set: { type: "boolean" },
+                    activeWorkspaceFolder: { type: "string" },
+                },
+                required: ["set", "activeWorkspaceFolder"],
+            },
+        },
+        async handler(args) {
+            const folderPath = requireString(args, "path");
+            const resolved = path.resolve(folderPath);
+            config.activeWorkspaceFolder = resolved;
+            return successStructured({ set: true, activeWorkspaceFolder: resolved });
+        },
+    };
+}
+//# sourceMappingURL=setActiveWorkspaceFolder.js.map

package/dist/tools/setActiveWorkspaceFolder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setActiveWorkspaceFolder.js","sourceRoot":"","sources":["../../src/tools/setActiveWorkspaceFolder.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE9D,MAAM,UAAU,kCAAkC,CAAC,MAAc;IAC/D,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,0BAA0B;YAChC,WAAW,EACT,4EAA4E;YAC9E,WAAW,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE;YACrC,WAAW,EAAE;gBACX,OAAO,EAAE,yCAAyC;gBAClD,IAAI,EAAE,QAAiB;gBACvB,QAAQ,EAAE,CAAC,MAAM,CAAC;gBAClB,UAAU,EAAE;oBACV,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAiB;wBACvB,WAAW,EAAE,mDAAmD;qBACjE;iBACF;gBACD,oBAAoB,EAAE,KAAc;aACrC;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;oBACxB,qBAAqB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC1C;gBACD,QAAQ,EAAE,CAAC,KAAK,EAAE,uBAAuB,CAAC;aAC3C;SACF;QACD,KAAK,CAAC,OAAO,CAAC,IAA6B;YACzC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC1C,MAAM,CAAC,qBAAqB,GAAG,QAAQ,CAAC;YACxC,OAAO,iBAAiB,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,qBAAqB,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC3E,CAAC;KACF,CAAC;AACJ,CAAC"}