claude-ide-bridge 1.1.0

package/dist/tools/fileOperations.d.ts

@@ -0,0 +1,111 @@
+import { type ExtensionClient } from "../extensionClient.js";
+export declare function createCreateFileTool(workspace: string, extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            destructiveHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            required: string[];
+            properties: {
+                filePath: {
+                    type: "string";
+                    description: string;
+                };
+                content: {
+                    type: "string";
+                    description: string;
+                };
+                isDirectory: {
+                    type: "boolean";
+                    description: string;
+                };
+                overwrite: {
+                    type: "boolean";
+                    description: string;
+                };
+                openAfterCreate: {
+                    type: "boolean";
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+    };
+    handler: (args: Record<string, unknown>, signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};
+export declare function createDeleteFileTool(workspace: string, extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            destructiveHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            required: string[];
+            properties: {
+                filePath: {
+                    type: "string";
+                    description: string;
+                };
+                recursive: {
+                    type: "boolean";
+                    description: string;
+                };
+                useTrash: {
+                    type: "boolean";
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+    };
+    handler: (args: Record<string, unknown>, signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};
+export declare function createRenameFileTool(workspace: string, extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            destructiveHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            required: string[];
+            properties: {
+                oldPath: {
+                    type: "string";
+                    description: string;
+                };
+                newPath: {
+                    type: "string";
+                    description: string;
+                };
+                overwrite: {
+                    type: "boolean";
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+    };
+    handler: (args: Record<string, unknown>, signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};

package/dist/tools/fileOperations.js

@@ -0,0 +1,280 @@
+import fs from "node:fs";
+import path from "node:path";
+import { ExtensionTimeoutError, } from "../extensionClient.js";
+import { error, optionalBool, optionalString, requireString, resolveFilePath, success, } from "./utils.js";
+export function createCreateFileTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "createFile",
+            description: "Create a new file or directory in the workspace. Uses VS Code when connected, falls back to native fs otherwise (openAfterCreate ignored in fallback mode).",
+            annotations: { destructiveHint: true },
+            inputSchema: {
+                type: "object",
+                required: ["filePath"],
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Absolute or workspace-relative path for the new file or directory",
+                    },
+                    content: {
+                        type: "string",
+                        description: "Initial file content (default: empty)",
+                    },
+                    isDirectory: {
+                        type: "boolean",
+                        description: "Create a directory instead of a file (default: false)",
+                    },
+                    overwrite: {
+                        type: "boolean",
+                        description: "Overwrite if file already exists (default: false)",
+                    },
+                    openAfterCreate: {
+                        type: "boolean",
+                        description: "Open the file in editor after creation (default: true)",
+                    },
+                },
+                additionalProperties: false,
+            },
+        },
+        handler: async (args, signal) => {
+            const rawPath = requireString(args, "filePath");
+            const content = optionalString(args, "content", 1_048_576) ?? "";
+            const isDirectory = optionalBool(args, "isDirectory") ?? false;
+            const overwrite = optionalBool(args, "overwrite") ?? false;
+            const openAfterCreate = optionalBool(args, "openAfterCreate") ?? true;
+            const filePath = resolveFilePath(rawPath, workspace);
+            // Try extension first (can also open the file in editor)
+            if (extensionClient.isConnected()) {
+                try {
+                    const result = await extensionClient.createFile(filePath, content, isDirectory, overwrite, openAfterCreate);
+                    if (result !== null) {
+                        return success(result);
+                    }
+                }
+                catch (err) {
+                    if (!(err instanceof ExtensionTimeoutError))
+                        throw err;
+                    // Timeout — fall through to native fs fallback
+                }
+            }
+            // Bail out before touching the filesystem if the call was already cancelled
+            if (signal?.aborted)
+                throw new Error("Request aborted");
+            // Native fs fallback
+            try {
+                if (isDirectory) {
+                    await fs.promises.mkdir(filePath, { recursive: true });
+                }
+                else {
+                    // Ensure parent directory exists
+                    await fs.promises.mkdir(path.dirname(filePath), { recursive: true });
+                    if (!overwrite) {
+                        // Atomic exclusive-create: fails with EEXIST if file already exists (no TOCTOU race)
+                        try {
+                            await fs.promises.writeFile(filePath, content, {
+                                encoding: "utf-8",
+                                flag: "wx",
+                                signal,
+                            });
+                        }
+                        catch (err) {
+                            if (err instanceof Error &&
+                                err.code === "EEXIST") {
+                                return error(`File already exists: ${filePath} (set overwrite: true to replace)`);
+                            }
+                            throw err;
+                        }
+                    }
+                    else {
+                        await fs.promises.writeFile(filePath, content, {
+                            encoding: "utf-8",
+                            signal,
+                        });
+                    }
+                }
+                return success({
+                    created: true,
+                    filePath,
+                    isDirectory,
+                    source: extensionClient.isConnected()
+                        ? "native-fs (extension timed out)"
+                        : "native-fs",
+                });
+            }
+            catch (err) {
+                return error(`Failed to create ${isDirectory ? "directory" : "file"}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        },
+    };
+}
+export function createDeleteFileTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "deleteFile",
+            description: "Delete a file or directory in the workspace. Uses VS Code when connected (supports trash), falls back to native fs for permanent deletion.",
+            annotations: { destructiveHint: true },
+            inputSchema: {
+                type: "object",
+                required: ["filePath"],
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Absolute or workspace-relative path to delete",
+                    },
+                    recursive: {
+                        type: "boolean",
+                        description: "Delete directory contents recursively (default: false)",
+                    },
+                    useTrash: {
+                        type: "boolean",
+                        description: "Move to trash instead of permanent delete (default: true)",
+                    },
+                },
+                additionalProperties: false,
+            },
+        },
+        handler: async (args, signal) => {
+            const rawPath = requireString(args, "filePath");
+            const recursive = optionalBool(args, "recursive") ?? false;
+            const useTrash = optionalBool(args, "useTrash") ?? true;
+            const filePath = resolveFilePath(rawPath, workspace);
+            // Try extension first (supports trash)
+            if (extensionClient.isConnected()) {
+                try {
+                    const result = await extensionClient.deleteFile(filePath, recursive, useTrash);
+                    if (result !== null) {
+                        return success(result);
+                    }
+                }
+                catch (err) {
+                    if (!(err instanceof ExtensionTimeoutError))
+                        throw err;
+                    // Timeout — fall through to native fs fallback
+                }
+            }
+            if (signal?.aborted)
+                throw new Error("Request aborted");
+            // Native fs fallback (no trash support — permanent delete only)
+            try {
+                const stat = await fs.promises.stat(filePath);
+                if (stat.isDirectory() && !recursive) {
+                    return error("Cannot delete directory without recursive: true");
+                }
+                if (useTrash) {
+                    // Cannot move to trash without the extension — warn the user
+                    return error("VS Code extension not connected — native fallback cannot move to trash. " +
+                        "Set useTrash: false for permanent deletion, or reconnect the extension.");
+                }
+                await fs.promises.rm(filePath, { recursive, force: false });
+                return success({
+                    deleted: true,
+                    filePath,
+                    source: extensionClient.isConnected()
+                        ? "native-fs (extension timed out)"
+                        : "native-fs",
+                    warning: "Permanently deleted (not moved to trash)",
+                });
+            }
+            catch (err) {
+                return error(`Failed to delete: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        },
+    };
+}
+export function createRenameFileTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "renameFile",
+            description: "Rename or move a file or directory within the workspace. Uses VS Code when connected, falls back to native fs otherwise.",
+            annotations: { destructiveHint: true },
+            inputSchema: {
+                type: "object",
+                required: ["oldPath", "newPath"],
+                properties: {
+                    oldPath: {
+                        type: "string",
+                        description: "Current absolute or workspace-relative path",
+                    },
+                    newPath: {
+                        type: "string",
+                        description: "New absolute or workspace-relative path",
+                    },
+                    overwrite: {
+                        type: "boolean",
+                        description: "Overwrite if target already exists (default: false)",
+                    },
+                },
+                additionalProperties: false,
+            },
+        },
+        handler: async (args, signal) => {
+            const rawOld = requireString(args, "oldPath");
+            const rawNew = requireString(args, "newPath");
+            const overwrite = optionalBool(args, "overwrite") ?? false;
+            const oldPath = resolveFilePath(rawOld, workspace);
+            const newPath = resolveFilePath(rawNew, workspace);
+            // Try extension first
+            if (extensionClient.isConnected()) {
+                try {
+                    const result = await extensionClient.renameFile(oldPath, newPath, overwrite);
+                    if (result !== null) {
+                        return success(result);
+                    }
+                }
+                catch (err) {
+                    if (!(err instanceof ExtensionTimeoutError))
+                        throw err;
+                    // Timeout — fall through to native fs fallback
+                }
+            }
+            if (signal?.aborted)
+                throw new Error("Request aborted");
+            // Native fs fallback
+            try {
+                // Ensure target parent directory exists before any move attempt
+                await fs.promises.mkdir(path.dirname(newPath), { recursive: true });
+                if (!overwrite) {
+                    // Use link(2) + unlink(2) for an atomic "move only if dest does not exist"
+                    // when both paths are on the same filesystem. link(2) fails with EEXIST
+                    // atomically, eliminating the TOCTOU window of a separate access() check.
+                    try {
+                        await fs.promises.link(oldPath, newPath);
+                        await fs.promises.unlink(oldPath);
+                    }
+                    catch (linkErr) {
+                        const code = linkErr.code;
+                        if (code === "EEXIST") {
+                            return error(`Target already exists: ${newPath} (set overwrite: true to replace)`);
+                        }
+                        // Cross-device link not permitted — fall back to best-effort check + rename
+                        if (code !== "EXDEV")
+                            throw linkErr;
+                        try {
+                            await fs.promises.access(newPath);
+                            return error(`Target already exists: ${newPath} (set overwrite: true to replace)`);
+                        }
+                        catch {
+                            // Target doesn't exist — proceed (best-effort on cross-device moves)
+                        }
+                        await fs.promises.rename(oldPath, newPath);
+                    }
+                }
+                else {
+                    await fs.promises.rename(oldPath, newPath);
+                }
+                return success({
+                    renamed: true,
+                    oldPath,
+                    newPath,
+                    source: extensionClient.isConnected()
+                        ? "native-fs (extension timed out)"
+                        : "native-fs",
+                });
+            }
+            catch (err) {
+                return error(`Failed to rename: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=fileOperations.js.map

package/dist/tools/fileOperations.js.map

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

package/dist/tools/fileWatcher.d.ts

@@ -0,0 +1,54 @@
+import { type ExtensionClient } from "../extensionClient.js";
+export declare function createWatchFilesTool(extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                id: {
+                    type: "string";
+                    description: string;
+                };
+                pattern: {
+                    type: "string";
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+    };
+    handler: (args: Record<string, unknown>) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};
+export declare function createUnwatchFilesTool(extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                id: {
+                    type: "string";
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+    };
+    handler: (args: Record<string, unknown>) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};

package/dist/tools/fileWatcher.js

@@ -0,0 +1,100 @@
+import { ExtensionTimeoutError, } from "../extensionClient.js";
+import { error, requireString, success } from "./utils.js";
+export function createWatchFilesTool(extensionClient) {
+    return {
+        schema: {
+            name: "watchFiles",
+            description: "Watch files matching a glob pattern for changes (created, modified, deleted). Notifications are pushed when matching files change. Use unwatchFiles to stop watching. Requires the VS Code extension.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    id: {
+                        type: "string",
+                        description: "Unique ID for this watcher (used to unwatch later)",
+                    },
+                    pattern: {
+                        type: "string",
+                        description: "Glob pattern to watch (e.g., '**/*.ts', 'src/**/*.{js,jsx}')",
+                    },
+                },
+                required: ["id", "pattern"],
+                additionalProperties: false,
+            },
+        },
+        handler: async (args) => {
+            if (!extensionClient.isConnected()) {
+                return success({
+                    available: false,
+                    error: "VS Code extension not connected — file watching requires the extension",
+                });
+            }
+            const id = requireString(args, "id", 100);
+            const pattern = requireString(args, "pattern", 500);
+            if (/[\x00-\x1f]/.test(id) || /[\x00-\x1f]/.test(pattern)) {
+                return error("id and pattern must not contain control characters");
+            }
+            // Reject patterns that could escape the workspace
+            if (pattern.startsWith("/") ||
+                pattern.startsWith("\\") ||
+                pattern.includes("..")) {
+                return error("pattern must be relative to the workspace (no absolute paths or '..')");
+            }
+            try {
+                const result = await extensionClient.watchFiles(id, pattern);
+                if (result === null) {
+                    return error("Failed to register file watcher");
+                }
+                return success(result);
+            }
+            catch (err) {
+                if (err instanceof ExtensionTimeoutError) {
+                    return error("Extension timed out — file watching may be unavailable");
+                }
+                throw err;
+            }
+        },
+    };
+}
+export function createUnwatchFilesTool(extensionClient) {
+    return {
+        schema: {
+            name: "unwatchFiles",
+            description: "Stop watching files for a previously registered watcher by ID.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    id: {
+                        type: "string",
+                        description: "ID of the watcher to remove",
+                    },
+                },
+                required: ["id"],
+                additionalProperties: false,
+            },
+        },
+        handler: async (args) => {
+            if (!extensionClient.isConnected()) {
+                return success({
+                    available: false,
+                    error: "VS Code extension not connected — file watching requires the extension",
+                });
+            }
+            const id = requireString(args, "id", 100);
+            try {
+                const result = await extensionClient.unwatchFiles(id);
+                if (result === null) {
+                    return error("Failed to unregister file watcher");
+                }
+                return success(result);
+            }
+            catch (err) {
+                if (err instanceof ExtensionTimeoutError) {
+                    return error("Extension timed out — file watching may be unavailable");
+                }
+                throw err;
+            }
+        },
+    };
+}
+//# sourceMappingURL=fileWatcher.js.map

package/dist/tools/fileWatcher.js.map

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

package/dist/tools/findFiles.d.ts

@@ -0,0 +1,31 @@
+import type { ProbeResults } from "../probe.js";
+export declare function createFindFilesTool(workspace: string, probes: ProbeResults): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                pattern: {
+                    type: string;
+                    description: string;
+                };
+                directory: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+    };
+    handler: (args: Record<string, unknown>, signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};