patchwork-os 0.2.0-alpha.0

package/dist/tools/getToolCapabilities.js

@@ -0,0 +1,298 @@
+import { successStructured } from "./utils.js";
+export function createGetToolCapabilitiesTool(probes, extensionClient, config) {
+    return {
+        schema: {
+            name: "getToolCapabilities",
+            description: "Available CLI tools, ext connection state, and which features are functional vs stub-only.",
+            annotations: { readOnlyHint: true },
+            cache_control: { type: "ephemeral" },
+            inputSchema: {
+                type: "object",
+                properties: {},
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    extensionConnected: { type: "boolean" },
+                    tier: { type: "string" },
+                    tierDescription: { type: "string" },
+                    editor: { type: "string" },
+                    cliTools: { type: "object" },
+                    linters: { type: "object" },
+                    formatters: { type: "object" },
+                    testRunners: { type: "object" },
+                    features: { type: "object" },
+                    commandAllowlist: { type: "array", items: { type: "string" } },
+                    availableTools: { type: "object" },
+                },
+                required: [
+                    "extensionConnected",
+                    "tier",
+                    "tierDescription",
+                    "cliTools",
+                    "linters",
+                    "formatters",
+                    "testRunners",
+                    "features",
+                    "commandAllowlist",
+                    "availableTools",
+                ],
+            },
+        },
+        handler: async () => {
+            return successStructured({
+                extensionConnected: extensionClient.isConnected(),
+                tier: extensionClient.isConnected() ? "full" : "basic",
+                tierDescription: extensionClient.isConnected()
+                    ? "All tools available including LSP, debugger, and terminal integration"
+                    : "File operations, Git, GitHub, and CLI tools available. Connect the VS Code extension for LSP, debugger, and terminal tools.",
+                editor: config.editorCommand ?? "none",
+                cliTools: {
+                    rg: probes.rg,
+                    fd: probes.fd,
+                    git: probes.git,
+                    codex: probes.codex,
+                },
+                linters: {
+                    tsc: probes.tsc,
+                    eslint: probes.eslint,
+                    pyright: probes.pyright,
+                    ruff: probes.ruff,
+                    cargo: probes.cargo,
+                    go: probes.go,
+                    biome: probes.biome,
+                },
+                formatters: {
+                    prettier: probes.prettier,
+                    black: probes.black,
+                    gofmt: probes.gofmt,
+                    rustfmt: probes.rustfmt,
+                },
+                testRunners: {
+                    vitest: probes.vitest,
+                    jest: probes.jest,
+                    pytest: probes.pytest,
+                    cargo: probes.cargo,
+                    go: probes.go,
+                },
+                features: {
+                    diagnostics: extensionClient.isConnected() ||
+                        probes.tsc ||
+                        probes.eslint ||
+                        probes.pyright ||
+                        probes.ruff ||
+                        probes.cargo ||
+                        probes.go ||
+                        probes.biome
+                        ? "available"
+                        : "unavailable",
+                    search: probes.rg ? "rg" : "grep-fallback",
+                    fileSearch: probes.fd
+                        ? "fd"
+                        : probes.git
+                            ? "git-ls-files"
+                            : "find-fallback",
+                    fileOps: extensionClient.isConnected()
+                        ? "available (VS Code)"
+                        : "available (native fs fallback — no trash, no undo buffer)",
+                    editText: extensionClient.isConnected()
+                        ? "available (VS Code WorkspaceEdit)"
+                        : "available (native fs fallback — no undo buffer)",
+                    selection: extensionClient.isConnected() ? "available" : "stub-only",
+                    dirtyCheck: extensionClient.isConnected()
+                        ? "real-time"
+                        : "mtime-heuristic",
+                    save: extensionClient.isConnected()
+                        ? "real-buffer-save (VS Code)"
+                        : config.editorCommand
+                            ? "editor-cli-reopen (edits already on disk)"
+                            : "no-op (edits already on disk via editText)",
+                    lsp: extensionClient.isConnected()
+                        ? "available (VS Code LSP)"
+                        : "unavailable (requires extension)",
+                    terminalOutput: extensionClient.isConnected()
+                        ? "available (runInTerminal uses VS Code shell integration; getTerminalOutput uses proposed API)"
+                        : "unavailable (requires extension)",
+                },
+                commandAllowlist: config.commandAllowlist,
+                availableTools: {
+                    // Always available (work with or without extension)
+                    files: [
+                        "openFile",
+                        "createFile",
+                        "deleteFile",
+                        "renameFile",
+                        "findFiles",
+                        "getFileTree",
+                        "getOpenEditors",
+                        "checkDocumentDirty",
+                        "saveDocument",
+                        "getBufferContent",
+                        ...(extensionClient.isConnected()
+                            ? ["watchFiles", "unwatchFiles"]
+                            : []),
+                    ],
+                    editing: [
+                        "replaceBlock",
+                        "editText",
+                        "openDiff",
+                        "closeAllDiffTabs",
+                        "formatDocument",
+                        "fixAllLintErrors",
+                        ...(extensionClient.isConnected()
+                            ? ["closeTab", "organizeImports"]
+                            : []),
+                    ],
+                    git: [
+                        "getGitStatus",
+                        "getGitDiff",
+                        "getGitLog",
+                        "gitAdd",
+                        "gitCommit",
+                        "gitCheckout",
+                        "gitBlame",
+                        "gitFetch",
+                        "gitPull",
+                        "gitPush",
+                        "gitListBranches",
+                        "gitStash",
+                        "gitStashPop",
+                        "gitStashList",
+                        "getCommitDetails",
+                        "getDiffBetweenRefs",
+                    ],
+                    diagnostics: [
+                        "getDiagnostics",
+                        "runTests",
+                        ...(extensionClient.isConnected() ? ["watchDiagnostics"] : []),
+                    ],
+                    search: ["searchWorkspace", "searchAndReplace"],
+                    lsp: extensionClient.isConnected()
+                        ? [
+                            "getDocumentSymbols",
+                            "goToDefinition",
+                            "findReferences",
+                            "getHover",
+                            "getCodeActions",
+                            "applyCodeAction",
+                            "previewCodeAction",
+                            "renameSymbol",
+                            "searchWorkspaceSymbols",
+                            "getCallHierarchy",
+                            "getTypeHierarchy",
+                            "getInlayHints",
+                            "getHoverAtCursor",
+                            "explainSymbol",
+                            "refactorPreview",
+                            "prepareRename",
+                            "signatureHelp",
+                            "foldingRanges",
+                            "selectionRanges",
+                            "refactorAnalyze",
+                            "getSemanticTokens",
+                            "getCodeLens",
+                            "getChangeImpact",
+                            "getImportedSignatures",
+                            "getDocumentLinks",
+                            "batchGetHover",
+                            "batchGoToDefinition",
+                            "batchFindImplementations",
+                            "refactorExtractFunction",
+                            "getImportTree",
+                            "findImplementations",
+                            "goToTypeDefinition",
+                            "goToDeclaration",
+                        ]
+                        : [],
+                    planning: [
+                        "createPlan",
+                        "updatePlan",
+                        "getPlan",
+                        "deletePlan",
+                        "listPlans",
+                    ],
+                    terminal: extensionClient.isConnected()
+                        ? [
+                            "listTerminals",
+                            "getTerminalOutput",
+                            "createTerminal",
+                            "sendTerminalCommand",
+                            "runInTerminal",
+                            "waitForTerminalOutput",
+                            "disposeTerminal",
+                        ]
+                        : [],
+                    debug: extensionClient.isConnected()
+                        ? [
+                            "getDebugState",
+                            "evaluateInDebugger",
+                            "setDebugBreakpoints",
+                            "startDebugging",
+                            "stopDebugging",
+                        ]
+                        : [],
+                    http: ["sendHttpRequest", "parseHttpFile"],
+                    analysis: [
+                        "getTypeSignature",
+                        "getImportTree",
+                        "getCodeCoverage",
+                        "generateTests",
+                        "getDependencyTree",
+                        "getGitHotspots",
+                        "getSecurityAdvisories",
+                        "getPRTemplate",
+                        ...(probes.gh ? ["createIssueFromAIComment"] : []),
+                    ],
+                    ...(probes.gh
+                        ? {
+                            github: [
+                                "githubCreatePR",
+                                "githubListPRs",
+                                "githubViewPR",
+                                "githubGetPRDiff",
+                                "githubPostPRReview",
+                                "githubListIssues",
+                                "githubGetIssue",
+                                "githubCreateIssue",
+                                "githubCommentIssue",
+                                "githubListRuns",
+                                "githubGetRunLogs",
+                            ],
+                        }
+                        : {}),
+                    other: [
+                        "runCommand",
+                        "getToolCapabilities",
+                        "getProjectInfo",
+                        "getAIComments",
+                        "getActivityLog",
+                        "getCurrentSelection",
+                        "getLatestSelection",
+                        "getWorkspaceFolders",
+                        "setActiveWorkspaceFolder",
+                        "bridgeStatus",
+                        ...(extensionClient.isConnected()
+                            ? [
+                                "readClipboard",
+                                "writeClipboard",
+                                "getWorkspaceSettings",
+                                "setWorkspaceSetting",
+                                "executeVSCodeCommand",
+                                "listVSCodeCommands",
+                                "getNotebookCells",
+                                "runNotebookCell",
+                                "getNotebookOutput",
+                                "setEditorDecorations",
+                                "clearEditorDecorations",
+                                "listTasks",
+                                "runTask",
+                            ]
+                            : []),
+                    ],
+                },
+            });
+        },
+    };
+}
+//# sourceMappingURL=getToolCapabilities.js.map

package/dist/tools/getToolCapabilities.js.map

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

package/dist/tools/getTypeSignature.d.ts

@@ -0,0 +1,70 @@
+import { type ExtensionClient } from "../extensionClient.js";
+export declare function createGetTypeSignatureTool(extensionClient: ExtensionClient, workspace?: string, hasTypescriptLsp?: boolean): {
+    schema: {
+        name: string;
+        extensionFallback: boolean;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            $schema: string;
+            type: "object";
+            required: string[];
+            properties: {
+                file: {
+                    type: string;
+                };
+                line: {
+                    type: string;
+                    minimum: number;
+                };
+                column: {
+                    type: string;
+                    minimum: number;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                found: {
+                    type: "boolean";
+                };
+                file: {
+                    type: "string";
+                };
+                line: {
+                    type: "integer";
+                };
+                column: {
+                    type: "integer";
+                };
+                signature: {
+                    type: "string";
+                };
+                raw: {
+                    type: "array";
+                    items: {
+                        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;
+    }>;
+};

package/dist/tools/getTypeSignature.js

@@ -0,0 +1,132 @@
+import { ExtensionTimeoutError, } from "../extensionClient.js";
+import { lspHover } from "./headless/lspFallback.js";
+import { error, extensionRequired, requireInt, requireString, successStructured, } from "./utils.js";
+export function createGetTypeSignatureTool(extensionClient, workspace = "", hasTypescriptLsp = false) {
+    return {
+        schema: {
+            name: "getTypeSignature",
+            extensionFallback: true,
+            description: "Type signature for symbol at position via LSP hover. Returns clean signature from hover markdown.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                required: ["file", "line", "column"],
+                properties: {
+                    file: { type: "string" },
+                    line: { type: "integer", minimum: 1 },
+                    column: { type: "integer", minimum: 1 },
+                },
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    found: { type: "boolean" },
+                    file: { type: "string" },
+                    line: { type: "integer" },
+                    column: { type: "integer" },
+                    signature: { type: "string" },
+                    raw: { type: "array", items: { type: "string" } },
+                },
+                required: ["found", "file", "line", "column"],
+            },
+        },
+        async handler(args) {
+            const file = requireString(args, "file");
+            const line = requireInt(args, "line", 1);
+            const column = requireInt(args, "column", 1);
+            if (!extensionClient.isConnected()) {
+                // Headless fallback via typescript-language-server
+                if (hasTypescriptLsp && workspace) {
+                    try {
+                        const hoverText = await lspHover(file, line, column, workspace);
+                        if (!hoverText) {
+                            return successStructured({ found: false, file, line, column });
+                        }
+                        let signature = null;
+                        const match = hoverText.match(/```(?:typescript|ts)\n([\s\S]*?)```/);
+                        if (match) {
+                            signature = match[1]?.trim() ?? null;
+                        }
+                        if (!signature) {
+                            signature = hoverText.trim() || null;
+                        }
+                        if (!signature) {
+                            return successStructured({ found: false, file, line, column });
+                        }
+                        return successStructured({
+                            found: true,
+                            file,
+                            line,
+                            column,
+                            signature,
+                            raw: [hoverText],
+                        });
+                    }
+                    catch {
+                        // fall through to extensionRequired
+                    }
+                }
+                return extensionRequired("getTypeSignature");
+            }
+            try {
+                const result = await extensionClient.getHover(file, line, column);
+                if (result === null || result === undefined) {
+                    return successStructured({ found: false, file, line, column });
+                }
+                // Extract contents array from hover result
+                const hover = result;
+                const contents = [];
+                if (Array.isArray(hover.contents)) {
+                    for (const c of hover.contents) {
+                        if (typeof c === "string")
+                            contents.push(c);
+                        else if (c &&
+                            typeof c === "object" &&
+                            typeof c.value === "string") {
+                            contents.push(c.value);
+                        }
+                    }
+                }
+                else if (hover.markdown && typeof hover.markdown === "string") {
+                    contents.push(hover.markdown);
+                }
+                if (contents.length === 0) {
+                    return successStructured({ found: false, file, line, column });
+                }
+                // Try to extract a fenced code block from any content string
+                let signature = null;
+                for (const content of contents) {
+                    const match = content.match(/```(?:typescript|ts)\n([\s\S]*?)```/);
+                    if (match) {
+                        signature = match[1]?.trim() ?? null;
+                        break;
+                    }
+                }
+                // Fall back to first non-empty content string
+                if (!signature) {
+                    signature = contents.find((c) => c.trim().length > 0)?.trim() ?? null;
+                }
+                if (!signature) {
+                    return successStructured({ found: false, file, line, column });
+                }
+                return successStructured({
+                    found: true,
+                    file,
+                    line,
+                    column,
+                    signature,
+                    raw: contents,
+                });
+            }
+            catch (err) {
+                if (err instanceof ExtensionTimeoutError) {
+                    return error("Extension timed out getting type signature");
+                }
+                throw err;
+            }
+        },
+    };
+}
+//# sourceMappingURL=getTypeSignature.js.map

package/dist/tools/getTypeSignature.js.map

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

package/dist/tools/getWorkspaceFolders.d.ts

@@ -0,0 +1,58 @@
+import type { ExtensionClient } from "../extensionClient.js";
+export declare function createGetWorkspaceFoldersTool(workspaceFolders: string[], extensionClient?: ExtensionClient): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            $schema: string;
+            type: string;
+            additionalProperties: boolean;
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                success: {
+                    type: "boolean";
+                };
+                folders: {
+                    type: "array";
+                    items: {
+                        type: "object";
+                        properties: {
+                            name: {
+                                type: "string";
+                            };
+                            path: {
+                                type: "string";
+                            };
+                            uri: {
+                                type: "string";
+                            };
+                            index: {
+                                type: "integer";
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                rootPath: {
+                    type: readonly ["string", "null"];
+                };
+                workspaceFile: {
+                    type: readonly ["string", "null"];
+                };
+            };
+            required: string[];
+        };
+    };
+    handler(): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    }>;
+};

package/dist/tools/getWorkspaceFolders.js

@@ -0,0 +1,69 @@
+import path from "node:path";
+import { successStructured } from "./utils.js";
+export function createGetWorkspaceFoldersTool(workspaceFolders, extensionClient) {
+    return {
+        schema: {
+            name: "getWorkspaceFolders",
+            description: "Get all workspace folders currently open in the IDE",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    success: { type: "boolean" },
+                    folders: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                name: { type: "string" },
+                                path: { type: "string" },
+                                uri: { type: "string" },
+                                index: { type: "integer" },
+                            },
+                            required: ["name", "path", "uri", "index"],
+                        },
+                    },
+                    rootPath: { type: ["string", "null"] },
+                    workspaceFile: { type: ["string", "null"] },
+                },
+                required: ["success", "folders", "rootPath", "workspaceFile"],
+            },
+        },
+        async handler() {
+            // Use extension for real multi-root data when available
+            if (extensionClient?.isConnected()) {
+                try {
+                    const folders = await extensionClient.getWorkspaceFolders();
+                    if (folders && folders.length > 0) {
+                        return successStructured({
+                            success: true,
+                            folders,
+                            rootPath: folders[0]?.path ?? null,
+                            workspaceFile: null,
+                        });
+                    }
+                }
+                catch {
+                    // Fall through to static list
+                }
+            }
+            return successStructured({
+                success: true,
+                folders: workspaceFolders.map((p, i) => ({
+                    name: path.basename(p),
+                    uri: `file://${p}`,
+                    path: p,
+                    index: i,
+                })),
+                rootPath: workspaceFolders[0] ?? null,
+                workspaceFile: null,
+            });
+        },
+    };
+}
+//# sourceMappingURL=getWorkspaceFolders.js.map

package/dist/tools/getWorkspaceFolders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWorkspaceFolders.js","sourceRoot":"","sources":["../../src/tools/getWorkspaceFolders.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,UAAU,6BAA6B,CAC3C,gBAA0B,EAC1B,eAAiC;IAEjC,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EAAE,qDAAqD;YAClE,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;YACnC,WAAW,EAAE;gBACX,OAAO,EAAE,yCAAyC;gBAClD,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,KAAK;aAC5B;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,OAAO,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE;oBACrC,OAAO,EAAE;wBACP,IAAI,EAAE,OAAgB;wBACtB,KAAK,EAAE;4BACL,IAAI,EAAE,QAAiB;4BACvB,UAAU,EAAE;gCACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;gCACjC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;gCACjC,GAAG,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;gCAChC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE;6BACpC;4BACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC;yBAC3C;qBACF;oBACD,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAU,EAAE;oBAC/C,aAAa,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAU,EAAE;iBACrD;gBACD,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,CAAC;aAC9D;SACF;QAED,KAAK,CAAC,OAAO;YACX,wDAAwD;YACxD,IAAI,eAAe,EAAE,WAAW,EAAE,EAAE,CAAC;gBACnC,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,mBAAmB,EAAE,CAAC;oBAC5D,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAClC,OAAO,iBAAiB,CAAC;4BACvB,OAAO,EAAE,IAAI;4BACb,OAAO;4BACP,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI;4BAClC,aAAa,EAAE,IAAI;yBACpB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,8BAA8B;gBAChC,CAAC;YACH,CAAC;YAED,OAAO,iBAAiB,CAAC;gBACvB,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;oBACvC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;oBACtB,GAAG,EAAE,UAAU,CAAC,EAAE;oBAClB,IAAI,EAAE,CAAC;oBACP,KAAK,EAAE,CAAC;iBACT,CAAC,CAAC;gBACH,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,IAAI;gBACrC,aAAa,EAAE,IAAI;aACpB,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}