claude-ide-bridge 1.1.0

package/dist/tools/debug.js

@@ -0,0 +1,248 @@
+import { ExtensionTimeoutError, } from "../extensionClient.js";
+import { error, extensionRequired, optionalInt, optionalString, requireArray, requireString, resolveFilePath, success, } from "./utils.js";
+export function createGetDebugStateTool(extensionClient) {
+    return {
+        schema: {
+            name: "getDebugState",
+            extensionRequired: true,
+            description: "Get the current state of the VS Code debugger: active session info, paused location, " +
+                "call stack, local variables, and registered breakpoints. " +
+                "Returns hasActiveSession=false when no debug session is running. " +
+                "Requires the VS Code extension.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                additionalProperties: false,
+            },
+        },
+        async handler() {
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("getDebugState");
+            }
+            try {
+                const result = await extensionClient.getDebugState();
+                if (result === null) {
+                    return success({
+                        hasActiveSession: false,
+                        isPaused: false,
+                        breakpoints: [],
+                    });
+                }
+                return success(result);
+            }
+            catch (err) {
+                if (err instanceof ExtensionTimeoutError) {
+                    return error("Extension timed out getting debug state");
+                }
+                throw err;
+            }
+        },
+    };
+}
+export function createEvaluateInDebuggerTool(extensionClient) {
+    return {
+        schema: {
+            name: "evaluateInDebugger",
+            extensionRequired: true,
+            description: "Evaluate an expression in the active debug session (REPL/watch). " +
+                "The session must be paused at a breakpoint for variables to be in scope. " +
+                "Requires the VS Code extension.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                required: ["expression"],
+                properties: {
+                    expression: {
+                        type: "string",
+                        description: "Expression to evaluate",
+                    },
+                    frameId: {
+                        type: "integer",
+                        description: "Stack frame ID from getDebugState callStack (0=top frame)",
+                    },
+                    context: {
+                        type: "string",
+                        enum: ["repl", "watch", "hover"],
+                        description: "Evaluation context (default: repl)",
+                    },
+                },
+                additionalProperties: false,
+            },
+        },
+        timeoutMs: 30_000,
+        async handler(args) {
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("evaluateInDebugger");
+            }
+            const expression = requireString(args, "expression", 10_000);
+            const frameId = optionalInt(args, "frameId", 0, 10_000);
+            const context = optionalString(args, "context") ?? "repl";
+            try {
+                const result = await extensionClient.evaluateInDebugger(expression, frameId, context);
+                if (result === null)
+                    return error("No active debug session or evaluation failed");
+                return success(result);
+            }
+            catch (err) {
+                if (err instanceof ExtensionTimeoutError) {
+                    return error("Extension timed out evaluating expression");
+                }
+                throw err;
+            }
+        },
+    };
+}
+export function createSetDebugBreakpointsTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "setDebugBreakpoints",
+            extensionRequired: true,
+            description: "Set breakpoints in a file, replacing any existing breakpoints for that file. " +
+                "Supports conditional breakpoints, logpoints, and hit-count conditions. " +
+                "Pass an empty breakpoints array to clear all breakpoints in the file. " +
+                "Requires the VS Code extension.",
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                required: ["file", "breakpoints"],
+                properties: {
+                    file: {
+                        type: "string",
+                        description: "Absolute path to the file",
+                    },
+                    breakpoints: {
+                        type: "array",
+                        description: "Breakpoints to set (replaces existing ones for this file)",
+                        items: {
+                            type: "object",
+                            required: ["line"],
+                            properties: {
+                                line: {
+                                    type: "integer",
+                                    description: "Line number (1-based)",
+                                },
+                                condition: {
+                                    type: "string",
+                                    description: "Conditional expression",
+                                },
+                                logMessage: {
+                                    type: "string",
+                                    description: "Logpoint message (no pause, just log)",
+                                },
+                                hitCondition: {
+                                    type: "string",
+                                    description: "Hit condition (e.g. '>5')",
+                                },
+                            },
+                            additionalProperties: false,
+                        },
+                    },
+                },
+                additionalProperties: false,
+            },
+        },
+        async handler(args) {
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("setDebugBreakpoints");
+            }
+            const file = resolveFilePath(requireString(args, "file"), workspace);
+            const rawBreakpoints = requireArray(args, "breakpoints");
+            const breakpoints = rawBreakpoints.map((b, i) => {
+                if (typeof b !== "object" || b === null)
+                    throw new Error(`breakpoints[${i}] must be an object`);
+                const bp = b;
+                if (typeof bp.line !== "number")
+                    throw new Error(`breakpoints[${i}].line must be a number`);
+                return bp;
+            });
+            const bps = breakpoints;
+            try {
+                const result = await extensionClient.setDebugBreakpoints(file, bps);
+                if (result === null)
+                    return error("Failed to set breakpoints");
+                return success(result);
+            }
+            catch (err) {
+                if (err instanceof ExtensionTimeoutError) {
+                    return error("Extension timed out setting breakpoints");
+                }
+                throw err;
+            }
+        },
+    };
+}
+export function createStartDebuggingTool(extensionClient) {
+    return {
+        schema: {
+            name: "startDebugging",
+            extensionRequired: true,
+            description: "Start a debug session using a launch configuration from .vscode/launch.json. " +
+                "Pass configName to select a specific configuration by name, or omit to use the first one. " +
+                "Requires the VS Code extension.",
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                properties: {
+                    configName: {
+                        type: "string",
+                        description: "Name of the launch configuration to use",
+                    },
+                },
+                additionalProperties: false,
+            },
+        },
+        async handler(args) {
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("startDebugging");
+            }
+            const configName = optionalString(args, "configName");
+            try {
+                const result = await extensionClient.startDebugging(configName);
+                if (result === null)
+                    return error("Failed to start debug session");
+                return success(result);
+            }
+            catch (err) {
+                if (err instanceof ExtensionTimeoutError) {
+                    return error("Extension timed out starting debug session");
+                }
+                throw err;
+            }
+        },
+    };
+}
+export function createStopDebuggingTool(extensionClient) {
+    return {
+        schema: {
+            name: "stopDebugging",
+            extensionRequired: true,
+            description: "Stop the active debug session. Has no effect if no session is running. " +
+                "Requires the VS Code extension.",
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                additionalProperties: false,
+            },
+        },
+        async handler() {
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("stopDebugging");
+            }
+            try {
+                const result = await extensionClient.stopDebugging();
+                if (result === null)
+                    return error("Failed to stop debug session");
+                return success(result);
+            }
+            catch (err) {
+                if (err instanceof ExtensionTimeoutError) {
+                    return error("Extension timed out stopping debug session");
+                }
+                throw err;
+            }
+        },
+    };
+}
+//# sourceMappingURL=debug.js.map

package/dist/tools/debug.js.map

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

package/dist/tools/decorations.d.ts

@@ -0,0 +1,92 @@
+import { type ExtensionClient } from "../extensionClient.js";
+export declare function createSetEditorDecorationsTool(workspace: string, extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        extensionRequired: boolean;
+        description: string;
+        annotations: {
+            idempotentHint: boolean;
+        };
+        inputSchema: {
+            $schema: string;
+            type: "object";
+            required: string[];
+            properties: {
+                id: {
+                    type: "string";
+                    description: string;
+                };
+                file: {
+                    type: "string";
+                    description: string;
+                };
+                decorations: {
+                    type: "array";
+                    description: string;
+                    items: {
+                        type: "object";
+                        required: string[];
+                        properties: {
+                            startLine: {
+                                type: "integer";
+                                description: string;
+                            };
+                            endLine: {
+                                type: "integer";
+                                description: string;
+                            };
+                            message: {
+                                type: "string";
+                                description: string;
+                            };
+                            hoverMessage: {
+                                type: "string";
+                                description: string;
+                            };
+                            style: {
+                                type: "string";
+                                enum: string[];
+                                description: string;
+                            };
+                        };
+                        additionalProperties: false;
+                    };
+                };
+            };
+            additionalProperties: false;
+        };
+    };
+    handler(args: Record<string, unknown>): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};
+export declare function createClearEditorDecorationsTool(extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        extensionRequired: boolean;
+        description: string;
+        annotations: {
+            idempotentHint: boolean;
+        };
+        inputSchema: {
+            $schema: string;
+            type: "object";
+            properties: {
+                id: {
+                    type: "string";
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+    };
+    handler(args: Record<string, unknown>): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};

package/dist/tools/decorations.js

@@ -0,0 +1,150 @@
+import { ExtensionTimeoutError, } from "../extensionClient.js";
+import { error, extensionRequired, optionalArray, optionalString, requireString, resolveFilePath, success, } from "./utils.js";
+export function createSetEditorDecorationsTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "setEditorDecorations",
+            extensionRequired: true,
+            description: "Place visual decorations (highlights, annotations, inline text) on lines in a file. " +
+                "Decorations are grouped by a logical ID — you can have multiple independent decoration sets. " +
+                "Each call replaces existing decorations for that ID+file. " +
+                "Styles: info (green), warning (yellow), error (red), focus (border), strikethrough, dim. " +
+                "Requires the VS Code extension.",
+            annotations: { idempotentHint: true },
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                required: ["id", "file", "decorations"],
+                properties: {
+                    id: {
+                        type: "string",
+                        description: "Logical group name for these decorations (alphanumeric + hyphens)",
+                    },
+                    file: {
+                        type: "string",
+                        description: "Absolute path to the file to decorate",
+                    },
+                    decorations: {
+                        type: "array",
+                        description: "Decorations to apply",
+                        items: {
+                            type: "object",
+                            required: ["startLine"],
+                            properties: {
+                                startLine: {
+                                    type: "integer",
+                                    description: "Start line (1-based)",
+                                },
+                                endLine: {
+                                    type: "integer",
+                                    description: "End line (1-based, defaults to startLine)",
+                                },
+                                message: {
+                                    type: "string",
+                                    description: "Inline message shown after the line",
+                                },
+                                hoverMessage: {
+                                    type: "string",
+                                    description: "Tooltip shown on hover",
+                                },
+                                style: {
+                                    type: "string",
+                                    enum: [
+                                        "info",
+                                        "warning",
+                                        "error",
+                                        "focus",
+                                        "strikethrough",
+                                        "dim",
+                                    ],
+                                    description: "Visual style (default: info)",
+                                },
+                            },
+                            additionalProperties: false,
+                        },
+                    },
+                },
+                additionalProperties: false,
+            },
+        },
+        async handler(args) {
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("setEditorDecorations");
+            }
+            const id = requireString(args, "id", 64);
+            const file = resolveFilePath(requireString(args, "file"), workspace);
+            const rawDecorations = optionalArray(args, "decorations") ?? [];
+            const decorations = rawDecorations.map((d, i) => {
+                if (typeof d !== "object" || d === null)
+                    throw new Error(`decorations[${i}] must be an object`);
+                const dec = d;
+                if (typeof dec.startLine !== "number")
+                    throw new Error(`decorations[${i}].startLine must be a number`);
+                if (![
+                    "info",
+                    "warning",
+                    "error",
+                    "focus",
+                    "strikethrough",
+                    "dim",
+                ].includes(dec.style))
+                    throw new Error(`decorations[${i}].style is invalid`);
+                return dec;
+            });
+            try {
+                const result = await extensionClient.setDecorations(id, file, decorations);
+                if (result === null)
+                    return error("Failed to set decorations");
+                return success(result);
+            }
+            catch (err) {
+                if (err instanceof ExtensionTimeoutError) {
+                    return error("Extension timed out setting decorations");
+                }
+                throw err;
+            }
+        },
+    };
+}
+export function createClearEditorDecorationsTool(extensionClient) {
+    return {
+        schema: {
+            name: "clearEditorDecorations",
+            extensionRequired: true,
+            description: "Clear editor decorations. Pass an id to clear a specific decoration set, " +
+                "or omit to clear all Claude-managed decorations. " +
+                "Requires the VS Code extension.",
+            annotations: { idempotentHint: true },
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                properties: {
+                    id: {
+                        type: "string",
+                        description: "Decoration set ID to clear. Omit to clear all.",
+                    },
+                },
+                additionalProperties: false,
+            },
+        },
+        async handler(args) {
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("clearEditorDecorations");
+            }
+            const id = optionalString(args, "id", 64);
+            try {
+                const result = await extensionClient.clearDecorations(id);
+                if (result === null)
+                    return error("Failed to clear decorations");
+                return success(result);
+            }
+            catch (err) {
+                if (err instanceof ExtensionTimeoutError) {
+                    return error("Extension timed out clearing decorations");
+                }
+                throw err;
+            }
+        },
+    };
+}
+//# sourceMappingURL=decorations.js.map

package/dist/tools/decorations.js.map

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

package/dist/tools/diffDebugger.d.ts

@@ -0,0 +1,62 @@
+import type { ToolHandler } from "../transport.js";
+export declare function createDiffDebugTool(workspace: string, getDiagnosticsFn: ToolHandler): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                commitRange: {
+                    type: string;
+                    description: string;
+                };
+                staged: {
+                    type: string;
+                    description: string;
+                };
+                filePath: {
+                    type: string;
+                    description: string;
+                };
+                proximity: {
+                    type: string;
+                    description: string;
+                };
+                severity: {
+                    oneOf: ({
+                        type: string;
+                        items?: undefined;
+                    } | {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                    })[];
+                    description: string;
+                };
+                source: {
+                    oneOf: ({
+                        type: string;
+                        items?: undefined;
+                    } | {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                    })[];
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+    };
+    handler: (args: Record<string, unknown>, signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};