patchwork-os 0.2.0-alpha.0

package/dist/tools/lsp.d.ts

@@ -0,0 +1,1086 @@
+import { type ExtensionClient } from "../extensionClient.js";
+export declare function lspWithRetry<T>(fn: () => Promise<T | null>, signal?: AbortSignal, isLspReady?: () => boolean): Promise<T | null | "timeout">;
+/** Standard error returned when an LSP tool exhausts its retry budget. */
+export declare function lspColdStartError(): {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError: true;
+};
+export declare function createGoToDefinitionTool(workspace: string, extensionClient: ExtensionClient, hasTypescriptLsp?: boolean): {
+    schema: {
+        name: string;
+        extensionFallback: 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: {
+                found: {
+                    type: string;
+                };
+                message: {
+                    type: string;
+                };
+                uri: {
+                    type: string;
+                };
+                range: {
+                    type: string;
+                    properties: {
+                        startLine: {
+                            type: string;
+                        };
+                        startColumn: {
+                            type: string;
+                        };
+                        endLine: {
+                            type: string;
+                        };
+                        endColumn: {
+                            type: 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;
+    }>;
+};
+export declare function createFindReferencesTool(workspace: string, extensionClient: ExtensionClient, hasTypescriptLsp?: boolean): {
+    schema: {
+        name: string;
+        extensionFallback: 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;
+                };
+                cursor: {
+                    type: "string";
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                found: {
+                    type: string;
+                };
+                references: {
+                    type: string;
+                    items: {
+                        type: string;
+                        properties: {
+                            uri: {
+                                type: string;
+                            };
+                            range: {
+                                type: string;
+                            };
+                        };
+                    };
+                };
+                total: {
+                    type: string;
+                };
+                nextCursor: {
+                    type: 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;
+    }>;
+};
+export declare function createGetHoverTool(workspace: string, extensionClient: ExtensionClient, lspVerbosity?: "minimal" | "normal" | "verbose"): {
+    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: {
+                found: {
+                    type: string;
+                };
+                message: {
+                    type: string;
+                };
+                contents: {
+                    type: string;
+                };
+                range: {
+                    type: 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;
+    }>;
+};
+export declare function createGetCodeActionsTool(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;
+                };
+                startColumn: {
+                    type: "integer";
+                    description: string;
+                };
+                endLine: {
+                    type: "integer";
+                    description: string;
+                };
+                endColumn: {
+                    type: "integer";
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                actions: {
+                    type: string;
+                    items: {
+                        type: string;
+                        properties: {
+                            title: {
+                                type: string;
+                            };
+                            kind: {
+                                type: string;
+                            };
+                            id: {
+                                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;
+    }>;
+};
+export declare function createApplyCodeActionTool(workspace: string, extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        extensionRequired: boolean;
+        description: string;
+        annotations: {
+            destructiveHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                filePath: {
+                    type: "string";
+                    description: string;
+                };
+                startLine: {
+                    type: "integer";
+                    description: string;
+                };
+                startColumn: {
+                    type: "integer";
+                    description: string;
+                };
+                endLine: {
+                    type: "integer";
+                    description: string;
+                };
+                endColumn: {
+                    type: "integer";
+                    description: string;
+                };
+                actionTitle: {
+                    type: "string";
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                applied: {
+                    type: "boolean";
+                };
+                title: {
+                    type: "string";
+                };
+                command: {
+                    type: readonly ["string", "null"];
+                };
+                error: {
+                    type: "string";
+                };
+                available: {
+                    type: "array";
+                    items: {
+                        type: "string";
+                    };
+                };
+            };
+            required: string[];
+            additionalProperties: true;
+        };
+    };
+    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 createPreviewCodeActionTool(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;
+                };
+                startColumn: {
+                    type: "integer";
+                    description: string;
+                };
+                endLine: {
+                    type: "integer";
+                    description: string;
+                };
+                endColumn: {
+                    type: "integer";
+                    description: string;
+                };
+                actionTitle: {
+                    type: "string";
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                title: {
+                    type: string;
+                };
+                changes: {
+                    type: string;
+                    items: {
+                        type: string;
+                        properties: {
+                            file: {
+                                type: string;
+                            };
+                            edits: {
+                                type: string;
+                                items: {
+                                    type: string;
+                                    properties: {
+                                        range: {
+                                            type: string;
+                                            properties: {
+                                                startLine: {
+                                                    type: string;
+                                                };
+                                                startColumn: {
+                                                    type: string;
+                                                };
+                                                endLine: {
+                                                    type: string;
+                                                };
+                                                endColumn: {
+                                                    type: string;
+                                                };
+                                            };
+                                            required: string[];
+                                        };
+                                        newText: {
+                                            type: string;
+                                        };
+                                    };
+                                    required: string[];
+                                };
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                totalFiles: {
+                    type: string;
+                };
+                totalEdits: {
+                    type: string;
+                };
+                note: {
+                    type: 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;
+    }>;
+};
+export declare function createRenameSymbolTool(workspace: string, extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        extensionRequired: boolean;
+        description: string;
+        annotations: {
+            destructiveHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                filePath: {
+                    type: "string";
+                    description: string;
+                };
+                line: {
+                    type: "integer";
+                    description: string;
+                };
+                column: {
+                    type: "integer";
+                    description: string;
+                };
+                newName: {
+                    type: "string";
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                success: {
+                    type: string;
+                };
+                newName: {
+                    type: string;
+                };
+                affectedFiles: {
+                    type: string;
+                    items: {
+                        type: string;
+                        properties: {
+                            file: {
+                                type: string;
+                            };
+                            editCount: {
+                                type: string;
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                totalEdits: {
+                    type: string;
+                };
+                error: {
+                    type: 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;
+    }>;
+};
+export declare function createGetCallHierarchyTool(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;
+                };
+                direction: {
+                    type: "string";
+                    enum: string[];
+                    description: string;
+                };
+                maxResults: {
+                    type: "integer";
+                    description: string;
+                };
+                cursor: {
+                    type: "string";
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                found: {
+                    type: string;
+                };
+                message: {
+                    type: string;
+                };
+                incoming: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                outgoing: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                incomingTotal: {
+                    type: string;
+                };
+                outgoingTotal: {
+                    type: string;
+                };
+                nextCursor: {
+                    type: 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;
+    }>;
+};
+export declare function createSearchWorkspaceSymbolsTool(workspace: string, extensionClient: ExtensionClient, hasUniversalCtags?: boolean): {
+    schema: {
+        name: string;
+        extensionFallback: boolean;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                query: {
+                    type: "string";
+                    description: string;
+                };
+                maxResults: {
+                    type: "integer";
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                symbols: {
+                    type: string;
+                    items: {
+                        type: string;
+                        properties: {
+                            name: {
+                                type: string;
+                            };
+                            kind: {
+                                type: string;
+                            };
+                            uri: {
+                                type: string;
+                            };
+                            range: {
+                                type: string;
+                            };
+                            containerName: {
+                                type: string;
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                count: {
+                    type: 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;
+    }>;
+};
+export declare function createPrepareRenameTool(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: {
+                canRename: {
+                    type: string;
+                };
+                reason: {
+                    type: string;
+                };
+                placeholder: {
+                    type: string;
+                };
+                range: {
+                    type: string;
+                    properties: {
+                        startLine: {
+                            type: string;
+                        };
+                        startColumn: {
+                            type: string;
+                        };
+                        endLine: {
+                            type: string;
+                        };
+                        endColumn: {
+                            type: 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;
+    }>;
+};
+export declare function createFormatRangeTool(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;
+                };
+                endLine: {
+                    type: "integer";
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                formatted: {
+                    type: string;
+                };
+                editCount: {
+                    type: string;
+                };
+                reason: {
+                    type: 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;
+    }>;
+};
+export declare function createFindImplementationsTool(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: {
+                found: {
+                    type: string;
+                };
+                implementations: {
+                    type: string;
+                    items: {
+                        type: string;
+                        properties: {
+                            file: {
+                                type: string;
+                            };
+                            line: {
+                                type: string;
+                            };
+                            column: {
+                                type: string;
+                            };
+                            endLine: {
+                                type: string;
+                            };
+                            endColumn: {
+                                type: string;
+                            };
+                        };
+                    };
+                };
+                count: {
+                    type: 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;
+    }>;
+};
+export declare function createGoToTypeDefinitionTool(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: {
+                found: {
+                    type: string;
+                };
+                message: {
+                    type: string;
+                };
+                locations: {
+                    type: string;
+                    items: {
+                        type: string;
+                        properties: {
+                            file: {
+                                type: string;
+                            };
+                            line: {
+                                type: string;
+                            };
+                            column: {
+                                type: string;
+                            };
+                            endLine: {
+                                type: string;
+                            };
+                            endColumn: {
+                                type: 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;
+    }>;
+};
+export declare function createGoToDeclarationTool(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: {
+                found: {
+                    type: string;
+                };
+                message: {
+                    type: string;
+                };
+                locations: {
+                    type: string;
+                    items: {
+                        type: string;
+                        properties: {
+                            file: {
+                                type: string;
+                            };
+                            line: {
+                                type: string;
+                            };
+                            column: {
+                                type: string;
+                            };
+                            endLine: {
+                                type: string;
+                            };
+                            endColumn: {
+                                type: 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;
+    }>;
+};