claude-ide-bridge 1.1.0

package/dist/tools/watchDiagnostics.js

@@ -0,0 +1,87 @@
+import { extensionRequired, optionalInt, optionalString, resolveFilePath, success, } from "./utils.js";
+export function createWatchDiagnosticsTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "watchDiagnostics",
+            extensionRequired: true,
+            description: "Wait for diagnostic changes and return updated diagnostics. " +
+                "Long-polls until diagnostics change or timeout. " +
+                "Use this after making edits to wait for the language server to report new errors/warnings. " +
+                "Returns immediately if diagnostics have already changed since the given timestamp.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Optional: only watch diagnostics for this specific file",
+                    },
+                    timeoutMs: {
+                        type: "integer",
+                        description: "Max wait time in milliseconds (default: 10000, max: 30000)",
+                    },
+                    sinceTimestamp: {
+                        type: "integer",
+                        description: "Only return if diagnostics changed after this timestamp (from a previous watchDiagnostics call)",
+                    },
+                },
+                additionalProperties: false,
+            },
+        },
+        timeoutMs: 120_000,
+        handler: (async (args, signal) => {
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("watchDiagnostics");
+            }
+            const rawPath = optionalString(args, "filePath");
+            const resolvedPath = rawPath
+                ? resolveFilePath(rawPath, workspace)
+                : undefined;
+            const timeoutMs = Math.min(optionalInt(args, "timeoutMs", 1000, 30_000) ?? 10_000, 30_000);
+            const sinceTimestamp = optionalInt(args, "sinceTimestamp", 0, Number.MAX_SAFE_INTEGER);
+            // Check if already changed since requested timestamp.
+            // Use explicit undefined check — sinceTimestamp=0 is valid and must not be skipped.
+            if (sinceTimestamp !== undefined &&
+                extensionClient.lastDiagnosticsUpdate > sinceTimestamp) {
+                const diagnostics = extensionClient.getCachedDiagnostics(resolvedPath);
+                return success({
+                    changed: true,
+                    timestamp: extensionClient.lastDiagnosticsUpdate,
+                    diagnostics,
+                    count: diagnostics.length,
+                });
+            }
+            // Long-poll: wait for change or timeout
+            return new Promise((resolve) => {
+                let settled = false;
+                const settle = (changed) => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    cleanup();
+                    const diagnostics = extensionClient.getCachedDiagnostics(resolvedPath);
+                    resolve(success({
+                        changed,
+                        timestamp: extensionClient.lastDiagnosticsUpdate,
+                        diagnostics,
+                        count: diagnostics.length,
+                    }));
+                };
+                const unsubscribe = extensionClient.addDiagnosticsListener((file) => {
+                    if (!resolvedPath || file === resolvedPath) {
+                        settle(true);
+                    }
+                });
+                const timer = setTimeout(() => settle(false), timeoutMs);
+                const abortHandler = () => settle(false);
+                signal?.addEventListener("abort", abortHandler);
+                const cleanup = () => {
+                    clearTimeout(timer);
+                    signal?.removeEventListener("abort", abortHandler);
+                    unsubscribe();
+                };
+            });
+        }),
+    };
+}
+//# sourceMappingURL=watchDiagnostics.js.map

package/dist/tools/watchDiagnostics.js.map

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

package/dist/tools/workspaceSettings.d.ts

@@ -0,0 +1,67 @@
+import { type ExtensionClient } from "../extensionClient.js";
+export declare function createGetWorkspaceSettingsTool(extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            $schema: string;
+            type: "object";
+            properties: {
+                section: {
+                    type: "string";
+                    description: string;
+                };
+                target: {
+                    type: "string";
+                    enum: string[];
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+    };
+    handler(args: Record<string, unknown>): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};
+export declare function createSetWorkspaceSettingTool(extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            destructiveHint: boolean;
+        };
+        inputSchema: {
+            $schema: string;
+            type: "object";
+            required: string[];
+            properties: {
+                key: {
+                    type: "string";
+                    description: string;
+                };
+                value: {
+                    description: string;
+                };
+                target: {
+                    type: "string";
+                    enum: string[];
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+    };
+    handler(args: Record<string, unknown>): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};

package/dist/tools/workspaceSettings.js

@@ -0,0 +1,102 @@
+import { ExtensionTimeoutError, } from "../extensionClient.js";
+import { error, extensionRequired, success } from "./utils.js";
+export function createGetWorkspaceSettingsTool(extensionClient) {
+    return {
+        schema: {
+            name: "getWorkspaceSettings",
+            description: "Read VS Code workspace settings. Optionally filter by section (e.g. 'editor', 'typescript'). " +
+                "Returns values with their sources (workspace vs global). " +
+                "Requires the VS Code extension.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                properties: {
+                    section: {
+                        type: "string",
+                        description: "Settings section to read (e.g. 'editor', 'typescript'). Omit for all.",
+                    },
+                    target: {
+                        type: "string",
+                        enum: ["workspace", "global"],
+                        description: "Which scope to read (default: workspace)",
+                    },
+                },
+                additionalProperties: false,
+            },
+        },
+        async handler(args) {
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("getWorkspaceSettings");
+            }
+            const section = typeof args.section === "string" ? args.section : undefined;
+            const target = typeof args.target === "string" ? args.target : undefined;
+            try {
+                const result = await extensionClient.getWorkspaceSettings(section, target);
+                if (result === null)
+                    return error("Failed to read workspace settings");
+                return success(result);
+            }
+            catch (err) {
+                if (err instanceof ExtensionTimeoutError) {
+                    return error("Extension timed out reading settings");
+                }
+                throw err;
+            }
+        },
+    };
+}
+export function createSetWorkspaceSettingTool(extensionClient) {
+    return {
+        schema: {
+            name: "setWorkspaceSetting",
+            description: "Write a VS Code workspace setting. Use dot notation for the key (e.g. 'editor.tabSize'). " +
+                "Writes to workspace scope by default. Writes to 'security.*' are blocked. " +
+                "Requires the VS Code extension.",
+            annotations: { destructiveHint: true },
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                required: ["key", "value"],
+                properties: {
+                    key: {
+                        type: "string",
+                        description: "Setting key in dot notation (e.g. 'editor.tabSize')",
+                    },
+                    value: {
+                        description: "New value for the setting",
+                    },
+                    target: {
+                        type: "string",
+                        enum: ["workspace", "global"],
+                        description: "Which scope to write to (default: workspace)",
+                    },
+                },
+                additionalProperties: false,
+            },
+        },
+        async handler(args) {
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("setWorkspaceSetting");
+            }
+            const key = args.key;
+            if (typeof key !== "string" || key.length === 0)
+                return error("key is required");
+            const value = args.value;
+            const target = typeof args.target === "string" ? args.target : undefined;
+            try {
+                const result = await extensionClient.setWorkspaceSetting(key, value, target);
+                if (result === null)
+                    return error("Failed to write setting — ensure a workspace folder is open");
+                return success(result);
+            }
+            catch (err) {
+                if (err instanceof ExtensionTimeoutError) {
+                    return error("Extension timed out writing setting");
+                }
+                throw err;
+            }
+        },
+    };
+}
+//# sourceMappingURL=workspaceSettings.js.map

package/dist/tools/workspaceSettings.js.map

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

package/dist/tools/workspaceSnapshots.d.ts

@@ -0,0 +1,174 @@
+export declare function createCreateSnapshotTool(workspace: string): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            destructiveHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            required: string[];
+            properties: {
+                name: {
+                    type: string;
+                    description: string;
+                };
+                includeUntracked: {
+                    type: string;
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+    };
+    handler: (args: Record<string, unknown>, signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};
+export declare function createListSnapshotsTool(workspace: string): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {};
+            additionalProperties: false;
+        };
+    };
+    handler: (_args: Record<string, unknown>, signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};
+export declare function createRestoreSnapshotTool(workspace: string): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            destructiveHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                name: {
+                    type: string;
+                    description: string;
+                };
+                index: {
+                    type: string;
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+    };
+    handler: (args: Record<string, unknown>, signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};
+export declare function createDeleteSnapshotTool(workspace: string): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            destructiveHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                name: {
+                    type: string;
+                    description: string;
+                };
+                index: {
+                    type: string;
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+    };
+    handler: (args: Record<string, unknown>, signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};
+export declare function createDiffSnapshotTool(workspace: string): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                name: {
+                    type: string;
+                    description: string;
+                };
+                index: {
+                    type: string;
+                    description: string;
+                };
+                stat: {
+                    type: string;
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+    };
+    handler: (args: Record<string, unknown>, signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};
+export declare function createShowSnapshotTool(workspace: string): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                name: {
+                    type: string;
+                    description: string;
+                };
+                index: {
+                    type: string;
+                    description: string;
+                };
+                stat: {
+                    type: string;
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+    };
+    handler: (args: Record<string, unknown>, signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};