patchwork-os 0.2.0-alpha.0

package/dist/tools/headless/lspFallback.js

@@ -0,0 +1,122 @@
+/**
+ * Typed wrappers around HeadlessLspClient for the three tools that fall back
+ * to typescript-language-server when the VS Code extension is not connected:
+ *   - goToDefinition  → textDocument/definition
+ *   - findReferences  → textDocument/references
+ *   - getTypeSignature → textDocument/hover
+ */
+import fs from "node:fs";
+import { getHeadlessLspClient } from "./lspClient.js";
+/** Convert an absolute file path to an LSP file URI. */
+function toUri(filePath) {
+    return `file://${filePath}`;
+}
+/** Detect language ID from file extension. */
+function languageIdFromPath(filePath) {
+    if (filePath.endsWith(".ts") ||
+        filePath.endsWith(".mts") ||
+        filePath.endsWith(".cts"))
+        return "typescript";
+    if (filePath.endsWith(".tsx"))
+        return "typescriptreact";
+    if (filePath.endsWith(".js") ||
+        filePath.endsWith(".mjs") ||
+        filePath.endsWith(".cjs"))
+        return "javascript";
+    if (filePath.endsWith(".jsx"))
+        return "javascriptreact";
+    return "typescript";
+}
+/** Ensure a file is open in the LSP server and the client is initialized. */
+async function ensureFile(filePath, workspaceRoot) {
+    const client = getHeadlessLspClient();
+    if (!client.isReady) {
+        await client.initialize(workspaceRoot);
+    }
+    const uri = toUri(filePath);
+    let text = "";
+    try {
+        text = fs.readFileSync(filePath, "utf-8");
+    }
+    catch {
+        // Let the LSP server handle missing files
+    }
+    await client.openFile(uri, languageIdFromPath(filePath), text);
+}
+/**
+ * textDocument/definition
+ * line and character are 1-based (bridge convention), converted to 0-based for LSP.
+ */
+export async function lspDefinition(filePath, line, character, workspaceRoot) {
+    await ensureFile(filePath, workspaceRoot);
+    const client = getHeadlessLspClient();
+    const raw = await client.request("textDocument/definition", {
+        textDocument: { uri: toUri(filePath) },
+        position: { line: line - 1, character: character - 1 },
+    });
+    if (!raw)
+        return [];
+    const locs = Array.isArray(raw) ? raw : [raw];
+    return locs.filter((l) => l !== null &&
+        typeof l === "object" &&
+        typeof l.uri === "string");
+}
+/**
+ * textDocument/references
+ * line and character are 1-based, converted to 0-based for LSP.
+ */
+export async function lspReferences(filePath, line, character, workspaceRoot) {
+    await ensureFile(filePath, workspaceRoot);
+    const client = getHeadlessLspClient();
+    const raw = await client.request("textDocument/references", {
+        textDocument: { uri: toUri(filePath) },
+        position: { line: line - 1, character: character - 1 },
+        context: { includeDeclaration: true },
+    });
+    if (!raw || !Array.isArray(raw))
+        return [];
+    return raw.filter((l) => l !== null &&
+        typeof l === "object" &&
+        typeof l.uri === "string");
+}
+/**
+ * textDocument/hover → returns extracted markdown/text string, or null.
+ * line and character are 1-based, converted to 0-based for LSP.
+ */
+export async function lspHover(filePath, line, character, workspaceRoot) {
+    await ensureFile(filePath, workspaceRoot);
+    const client = getHeadlessLspClient();
+    const raw = await client.request("textDocument/hover", {
+        textDocument: { uri: toUri(filePath) },
+        position: { line: line - 1, character: character - 1 },
+    });
+    if (!raw)
+        return null;
+    const hover = raw;
+    // LSP hover contents can be: string | { language, value } | { kind, value } | array
+    const contents = hover.contents;
+    if (!contents)
+        return null;
+    if (typeof contents === "string")
+        return contents;
+    if (typeof contents === "object" && !Array.isArray(contents)) {
+        const obj = contents;
+        if (typeof obj.value === "string")
+            return obj.value;
+    }
+    if (Array.isArray(contents)) {
+        const parts = [];
+        for (const c of contents) {
+            if (typeof c === "string")
+                parts.push(c);
+            else if (c &&
+                typeof c === "object" &&
+                typeof c.value === "string") {
+                parts.push(c.value);
+            }
+        }
+        return parts.join("\n\n") || null;
+    }
+    return null;
+}
+//# sourceMappingURL=lspFallback.js.map

package/dist/tools/headless/lspFallback.js.map

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

package/dist/tools/hoverAtCursor.d.ts

@@ -0,0 +1,54 @@
+import { type ExtensionClient } from "../extensionClient.js";
+export declare function createGetHoverAtCursorTool(extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        extensionRequired: boolean;
+        inputSchema: {
+            $schema: string;
+            type: "object";
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                found: {
+                    type: "boolean";
+                };
+                file: {
+                    type: "string";
+                };
+                line: {
+                    type: "number";
+                };
+                column: {
+                    type: "number";
+                };
+                message: {
+                    type: "string";
+                };
+                hover: {
+                    type: "object";
+                };
+            };
+            required: string[];
+        };
+    };
+    timeoutMs: number;
+    handler(): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+};

package/dist/tools/hoverAtCursor.js

@@ -0,0 +1,68 @@
+import { ExtensionTimeoutError, } from "../extensionClient.js";
+import { error, extensionRequired, successStructured } from "./utils.js";
+export function createGetHoverAtCursorTool(extensionClient) {
+    return {
+        schema: {
+            name: "getHoverAtCursor",
+            description: "Hover docs for symbol at current cursor. Zero-input wrapper around getHover.",
+            annotations: { readOnlyHint: true },
+            extensionRequired: true,
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    found: { type: "boolean" },
+                    file: { type: "string" },
+                    line: { type: "number" },
+                    column: { type: "number" },
+                    message: { type: "string" },
+                    hover: { type: "object" },
+                },
+                required: ["found"],
+            },
+        },
+        timeoutMs: 8_000,
+        async handler() {
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("getHoverAtCursor");
+            }
+            const file = extensionClient.latestActiveFile;
+            const selection = extensionClient.latestSelection;
+            if (!file) {
+                return error("No active file tracked — open a file in VS Code first");
+            }
+            const line = selection ? selection.startLine : 1;
+            const column = selection ? selection.startColumn : 1;
+            try {
+                const result = await extensionClient.getHover(file, line, column);
+                if (result === null) {
+                    return successStructured({
+                        found: false,
+                        file,
+                        line,
+                        column,
+                        message: "No hover information available at cursor position",
+                    });
+                }
+                return successStructured({
+                    found: true,
+                    file,
+                    line,
+                    column,
+                    hover: result,
+                });
+            }
+            catch (err) {
+                if (err instanceof ExtensionTimeoutError) {
+                    return error("Extension timed out getting hover information");
+                }
+                throw err;
+            }
+        },
+    };
+}
+//# sourceMappingURL=hoverAtCursor.js.map

package/dist/tools/hoverAtCursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hoverAtCursor.js","sourceRoot":"","sources":["../../src/tools/hoverAtCursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,UAAU,0BAA0B,CAAC,eAAgC;IACzE,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,kBAAkB;YACxB,WAAW,EACT,8EAA8E;YAChF,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;YACnC,iBAAiB,EAAE,IAAI;YACvB,WAAW,EAAE;gBACX,OAAO,EAAE,yCAAyC;gBAClD,IAAI,EAAE,QAAiB;gBACvB,oBAAoB,EAAE,KAAc;aACrC;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,KAAK,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE;oBACnC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;oBACjC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;oBACjC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;oBACnC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;oBACpC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;iBACnC;gBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;aACpB;SACF;QACD,SAAS,EAAE,KAAK;QAChB,KAAK,CAAC,OAAO;YACX,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC;gBACnC,OAAO,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;YAC/C,CAAC;YAED,MAAM,IAAI,GAAG,eAAe,CAAC,gBAAgB,CAAC;YAC9C,MAAM,SAAS,GAAG,eAAe,CAAC,eAAe,CAAC;YAElD,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,KAAK,CAAC,uDAAuD,CAAC,CAAC;YACxE,CAAC;YAED,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;YAErD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;gBAClE,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;oBACpB,OAAO,iBAAiB,CAAC;wBACvB,KAAK,EAAE,KAAK;wBACZ,IAAI;wBACJ,IAAI;wBACJ,MAAM;wBACN,OAAO,EAAE,mDAAmD;qBAC7D,CAAC,CAAC;gBACL,CAAC;gBACD,OAAO,iBAAiB,CAAC;oBACvB,KAAK,EAAE,IAAI;oBACX,IAAI;oBACJ,IAAI;oBACJ,MAAM;oBACN,KAAK,EAAE,MAAM;iBACd,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,qBAAqB,EAAE,CAAC;oBACzC,OAAO,KAAK,CAAC,+CAA+C,CAAC,CAAC;gBAChE,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/httpClient.d.ts

@@ -0,0 +1,141 @@
+export declare function createSendHttpRequestTool(options?: {
+    allowPrivateHttp?: boolean;
+}): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            openWorldHint: boolean;
+        };
+        inputSchema: {
+            $schema: string;
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                method: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                url: {
+                    type: string;
+                    description: string;
+                };
+                headers: {
+                    type: string;
+                    additionalProperties: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                body: {
+                    type: string;
+                    description: string;
+                };
+                timeoutMs: {
+                    type: string;
+                    description: string;
+                };
+                maxResponseBytes: {
+                    type: string;
+                    description: string;
+                };
+                followRedirects: {
+                    type: string;
+                    description: string;
+                };
+            };
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                status: {
+                    type: string;
+                };
+                statusText: {
+                    type: string;
+                };
+                headers: {
+                    type: string;
+                };
+                body: {
+                    type: string;
+                };
+                durationMs: {
+                    type: string;
+                };
+                redirects: {
+                    type: string;
+                };
+                truncated: {
+                    type: string;
+                };
+                fullBytes: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    timeoutMs: number;
+    handler(args: Record<string, unknown>, signal?: AbortSignal): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+};
+export declare function createParseHttpFileTool(workspace: string): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            $schema: string;
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                filePath: {
+                    type: string;
+                    description: string;
+                };
+            };
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                requests: {
+                    type: string;
+                };
+                count: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    handler(args: Record<string, unknown>): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+};