claude-ide-bridge 1.1.0

package/dist/tools/runCommand.js

@@ -0,0 +1,141 @@
+import { INTERPRETER_COMMANDS } from "../config.js";
+import { execSafe, optionalInt, optionalString, requireString, resolveFilePath, success, truncateOutput, } from "./utils.js";
+const MAX_ARGS = 100;
+const MAX_ARG_LENGTH = 4096;
+/** Flags that allow interpreter commands to execute arbitrary code */
+const DANGEROUS_INTERPRETER_FLAGS = new Set([
+    "-e",
+    "--eval",
+    "-c",
+    "--print",
+    "-p",
+    "--input-type",
+    "--import", // Node.js ESM loader
+    "--loader", // Custom ESM loader
+    "--experimental-loader", // Custom ESM loader (legacy)
+    "-m", // Python module execution
+]);
+/** Flags that redirect where commands read config/manifests from */
+const DANGEROUS_PATH_FLAGS = new Set([
+    "--prefix",
+    "--manifest-path",
+    "--config",
+    "--rcfile",
+    "--require",
+    "-r",
+    "--userconfig", // npm config redirection
+    "--globalconfig", // npm config redirection
+    "-f",
+    "--makefile", // make Makefile path
+]);
+function validateCommand(command, allowlist) {
+    if (command.includes("/") ||
+        command.includes("\\") ||
+        command.includes("..") ||
+        command.includes(" ")) {
+        throw new Error(`Invalid command "${command}": must be a simple basename without /, \\, .., or spaces`);
+    }
+    if (!allowlist.some((entry) => entry.toLowerCase() === command)) {
+        throw new Error(`Command "${command}" is not in the allowlist. Use --allow-command ${command} to add it. Run getToolCapabilities to see allowed commands.`);
+    }
+}
+function validateArgs(args, command) {
+    if (args === undefined || args === null)
+        return [];
+    if (!Array.isArray(args)) {
+        throw new Error("args must be an array of strings");
+    }
+    if (args.length > MAX_ARGS) {
+        throw new Error(`args exceeds maximum length of ${MAX_ARGS}`);
+    }
+    const isInterpreter = INTERPRETER_COMMANDS.has(command);
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (typeof arg !== "string") {
+            throw new Error(`args[${i}] must be a string`);
+        }
+        if (arg.length > MAX_ARG_LENGTH) {
+            throw new Error(`args[${i}] exceeds maximum length of ${MAX_ARG_LENGTH}`);
+        }
+        // Block code-execution flags for interpreter commands
+        if (isInterpreter && DANGEROUS_INTERPRETER_FLAGS.has(arg)) {
+            throw new Error(`Flag "${arg}" is blocked for interpreter command "${command}" — it allows arbitrary code execution`);
+        }
+        // Block config/path-override flags for all commands
+        if (DANGEROUS_PATH_FLAGS.has(arg)) {
+            throw new Error(`Flag "${arg}" is blocked — it can redirect command execution outside the workspace`);
+        }
+    }
+    return args;
+}
+export function createRunCommandTool(workspace, config) {
+    return {
+        schema: {
+            name: "runCommand",
+            description: "Execute an allowlisted command in the workspace. Returns stdout, stderr, exit code, and timing information. Commands run without a shell for security.",
+            annotations: { destructiveHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    command: {
+                        type: "string",
+                        description: "Command basename to run (must be in the allowlist, no paths)",
+                    },
+                    args: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: "Command arguments",
+                    },
+                    cwd: {
+                        type: "string",
+                        description: "Working directory for the command (absolute or workspace-relative, default: workspace root)",
+                    },
+                    timeout: {
+                        type: "integer",
+                        description: `Timeout in milliseconds (default: ${config.commandTimeout}, max: 120000)`,
+                    },
+                },
+                required: ["command"],
+                additionalProperties: false,
+            },
+        },
+        timeoutMs: 300_000,
+        handler: async (args, signal) => {
+            // Normalize to lowercase before all validation — prevents case-sensitivity bypass
+            // on case-insensitive filesystems (macOS HFS+, Windows) where "NODE" resolves to "node"
+            const command = requireString(args, "command", 256).toLowerCase();
+            validateCommand(command, config.commandAllowlist);
+            const cmdArgs = validateArgs(args.args, command);
+            const cwdRaw = optionalString(args, "cwd");
+            const timeout = optionalInt(args, "timeout", 1000, 120_000) ?? config.commandTimeout;
+            const cwd = cwdRaw ? resolveFilePath(cwdRaw, workspace) : workspace;
+            const maxBytes = config.maxResultSize * 1024;
+            const result = await execSafe(command, cmdArgs, {
+                cwd,
+                timeout,
+                maxBuffer: maxBytes,
+                signal,
+            });
+            const stdoutResult = truncateOutput(result.stdout, maxBytes);
+            const stderrResult = truncateOutput(result.stderr, maxBytes);
+            const anyTruncated = stdoutResult.truncated || stderrResult.truncated;
+            return success({
+                exitCode: result.exitCode,
+                stdout: stdoutResult.text,
+                stderr: stderrResult.text,
+                durationMs: result.durationMs,
+                timedOut: result.timedOut,
+                ...(anyTruncated
+                    ? {
+                        truncated: true,
+                        stdoutTruncated: stdoutResult.truncated,
+                        stderrTruncated: stderrResult.truncated,
+                        maxBytes,
+                        note: "Output exceeded limit. Redirect to a file (command > out.txt) to capture full output.",
+                    }
+                    : {}),
+            });
+        },
+    };
+}
+//# sourceMappingURL=runCommand.js.map

package/dist/tools/runCommand.js.map

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

package/dist/tools/runTests.d.ts

@@ -0,0 +1,32 @@
+import type { ProbeResults } from "../probe.js";
+import type { ProgressFn } from "../transport.js";
+export declare function createRunTestsTool(workspace: string, probes?: ProbeResults): {
+    schema: {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                filter: {
+                    type: string;
+                    description: string;
+                };
+                runner: {
+                    type: string;
+                    description: string;
+                };
+                noCache: {
+                    type: string;
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+    };
+    handler(args: Record<string, unknown>, signal?: AbortSignal, progress?: ProgressFn): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};

package/dist/tools/runTests.js

@@ -0,0 +1,160 @@
+import { cargoTestRunner } from "./testRunners/cargoTest.js";
+import { goTestRunner } from "./testRunners/goTest.js";
+import { pytestRunner } from "./testRunners/pytest.js";
+import { jestRunner, vitestRunner } from "./testRunners/vitestJest.js";
+import { optionalBool, optionalString, success } from "./utils.js";
+const MAX_CACHE_ENTRIES = 50;
+const ALL_RUNNERS = [
+    vitestRunner,
+    jestRunner,
+    pytestRunner,
+    cargoTestRunner,
+    goTestRunner,
+];
+export function createRunTestsTool(workspace, probes) {
+    const availableRunners = probes
+        ? ALL_RUNNERS.filter((r) => r.detect(workspace, probes))
+        : [];
+    const caches = new Map();
+    const runningPromises = new Map();
+    const runnerErrors = new Map();
+    async function runRunner(runner, filter, signal) {
+        const cacheKey = `${runner.name}:${filter ?? ""}`;
+        const now = Date.now();
+        const cached = caches.get(cacheKey);
+        if (cached && now - cached.timestamp < runner.cacheTtl) {
+            return cached.data;
+        }
+        let running = runningPromises.get(cacheKey);
+        if (!running) {
+            running = runner
+                .run(workspace, filter, signal)
+                .then((data) => {
+                // Evict oldest entry if cache is full
+                if (caches.size >= MAX_CACHE_ENTRIES) {
+                    const oldestKey = caches.keys().next().value;
+                    if (oldestKey)
+                        caches.delete(oldestKey);
+                }
+                caches.set(cacheKey, { data, timestamp: Date.now() });
+                // Clear any previous error for this runner on success
+                runnerErrors.delete(runner.name);
+                return data;
+            })
+                .catch((err) => {
+                if (!(err instanceof Error) || err.name !== "AbortError") {
+                    caches.set(cacheKey, { data: [], timestamp: Date.now() });
+                    runnerErrors.set(runner.name, err instanceof Error ? err.message : String(err));
+                }
+                return [];
+            })
+                .finally(() => {
+                runningPromises.delete(cacheKey);
+            });
+            runningPromises.set(cacheKey, running);
+        }
+        return running;
+    }
+    return {
+        schema: {
+            name: "runTests",
+            description: "Run tests using auto-detected frameworks (Vitest, Jest, Pytest, Cargo test, Go test). Returns structured results with pass/fail status, failure messages, and file:line locations for correlation with code changes. Results are cached per runner (30s TTL) — use noCache: true after code changes to get fresh results.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    filter: {
+                        type: "string",
+                        description: "Test name pattern or file path to filter which tests run",
+                    },
+                    runner: {
+                        type: "string",
+                        description: "Specific runner to use (e.g., 'vitest', 'jest', 'pytest', 'cargo-test', 'go-test'). Default: all detected",
+                    },
+                    noCache: {
+                        type: "boolean",
+                        description: "Skip cache and force a fresh run. Default: false",
+                    },
+                },
+                additionalProperties: false,
+            },
+        },
+        async handler(args, signal, progress) {
+            progress?.(0, 100);
+            const filter = optionalString(args, "filter");
+            const runnerName = optionalString(args, "runner");
+            const noCache = optionalBool(args, "noCache") ?? false;
+            if (availableRunners.length === 0) {
+                return success({
+                    available: false,
+                    runners: [],
+                    summary: {
+                        total: 0,
+                        passed: 0,
+                        failed: 0,
+                        skipped: 0,
+                        errored: 0,
+                        durationMs: 0,
+                    },
+                    results: [],
+                    failures: [],
+                });
+            }
+            let runners = availableRunners;
+            if (runnerName) {
+                runners = availableRunners.filter((r) => r.name === runnerName);
+                if (runners.length === 0) {
+                    return success({
+                        available: true,
+                        runners: availableRunners.map((r) => r.name),
+                        error: `Runner '${runnerName}' not found. Available: ${availableRunners.map((r) => r.name).join(", ")}`,
+                        summary: {
+                            total: 0,
+                            passed: 0,
+                            failed: 0,
+                            skipped: 0,
+                            errored: 0,
+                            durationMs: 0,
+                        },
+                        results: [],
+                        failures: [],
+                    });
+                }
+            }
+            if (noCache) {
+                for (const r of runners) {
+                    const key = `${r.name}:${filter ?? ""}`;
+                    caches.delete(key);
+                }
+            }
+            const startTime = Date.now();
+            const allResults = await Promise.all(runners.map((r) => runRunner(r, filter, signal)));
+            const results = allResults.flat();
+            const durationMs = Date.now() - startTime;
+            const summary = {
+                total: results.length,
+                passed: results.filter((r) => r.status === "passed").length,
+                failed: results.filter((r) => r.status === "failed").length,
+                skipped: results.filter((r) => r.status === "skipped").length,
+                errored: results.filter((r) => r.status === "errored").length,
+                durationMs,
+            };
+            // Collect any runner errors from this execution
+            const errors = {};
+            for (const r of runners) {
+                const err = runnerErrors.get(r.name);
+                if (err)
+                    errors[r.name] = err;
+            }
+            progress?.(100, 100);
+            return success({
+                available: true,
+                runners: runners.map((r) => r.name),
+                summary,
+                results,
+                failures: results.filter((r) => r.status === "failed" || r.status === "errored"),
+                ...(Object.keys(errors).length > 0 && { runnerErrors: errors }),
+            });
+        },
+    };
+}
+//# sourceMappingURL=runTests.js.map

package/dist/tools/runTests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runTests.js","sourceRoot":"","sources":["../../src/tools/runTests.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B,MAAM,WAAW,GAAiB;IAChC,YAAY;IACZ,UAAU;IACV,YAAY;IACZ,eAAe;IACf,YAAY;CACb,CAAC;AAOF,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,MAAqB;IACzE,MAAM,gBAAgB,GAAG,MAAM;QAC7B,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACxD,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC9C,MAAM,eAAe,GAAG,IAAI,GAAG,EAAiC,CAAC;IACjE,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE/C,KAAK,UAAU,SAAS,CACtB,MAAkB,EAClB,MAAe,EACf,MAAoB;QAEpB,MAAM,QAAQ,GAAG,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;YACvD,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;QAED,IAAI,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,MAAM;iBACb,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC;iBAC9B,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;gBACb,sCAAsC;gBACtC,IAAI,MAAM,CAAC,IAAI,IAAI,iBAAiB,EAAE,CAAC;oBACrC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;oBAC7C,IAAI,SAAS;wBAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAC1C,CAAC;gBACD,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACtD,sDAAsD;gBACtD,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACjC,OAAO,IAAI,CAAC;YACd,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;gBACtB,IAAI,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;oBACzD,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;oBAC1D,YAAY,CAAC,GAAG,CACd,MAAM,CAAC,IAAI,EACX,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CACjD,CAAC;gBACJ,CAAC;gBACD,OAAO,EAAkB,CAAC;YAC5B,CAAC,CAAC;iBACD,OAAO,CAAC,GAAG,EAAE;gBACZ,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC;YACL,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,UAAU;YAChB,WAAW,EACT,2TAA2T;YAC7T,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,0DAA0D;qBAC7D;oBACD,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,2GAA2G;qBAC9G;oBACD,OAAO,EAAE;wBACP,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,kDAAkD;qBAChE;iBACF;gBACD,oBAAoB,EAAE,KAAc;aACrC;SACF;QAED,KAAK,CAAC,OAAO,CACX,IAA6B,EAC7B,MAAoB,EACpB,QAAqB;YAErB,QAAQ,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACnB,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC9C,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAClD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,KAAK,CAAC;YAEvD,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClC,OAAO,OAAO,CAAC;oBACb,SAAS,EAAE,KAAK;oBAChB,OAAO,EAAE,EAAE;oBACX,OAAO,EAAE;wBACP,KAAK,EAAE,CAAC;wBACR,MAAM,EAAE,CAAC;wBACT,MAAM,EAAE,CAAC;wBACT,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,CAAC;wBACV,UAAU,EAAE,CAAC;qBACd;oBACD,OAAO,EAAE,EAAE;oBACX,QAAQ,EAAE,EAAE;iBACb,CAAC,CAAC;YACL,CAAC;YAED,IAAI,OAAO,GAAG,gBAAgB,CAAC;YAC/B,IAAI,UAAU,EAAE,CAAC;gBACf,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;gBAChE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO,OAAO,CAAC;wBACb,SAAS,EAAE,IAAI;wBACf,OAAO,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;wBAC5C,KAAK,EAAE,WAAW,UAAU,2BAA2B,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;wBACvG,OAAO,EAAE;4BACP,KAAK,EAAE,CAAC;4BACR,MAAM,EAAE,CAAC;4BACT,MAAM,EAAE,CAAC;4BACT,OAAO,EAAE,CAAC;4BACV,OAAO,EAAE,CAAC;4BACV,UAAU,EAAE,CAAC;yBACd;wBACD,OAAO,EAAE,EAAE;wBACX,QAAQ,EAAE,EAAE;qBACb,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,IAAI,OAAO,EAAE,CAAC;gBACZ,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;oBACxB,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;oBACxC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAClC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CACjD,CAAC;YACF,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;YAClC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAE1C,MAAM,OAAO,GAAG;gBACd,KAAK,EAAE,OAAO,CAAC,MAAM;gBACrB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM;gBAC3D,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM;gBAC3D,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;gBAC7D,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;gBAC7D,UAAU;aACX,CAAC;YAEF,gDAAgD;YAChD,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACrC,IAAI,GAAG;oBAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;YAChC,CAAC;YAED,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACrB,OAAO,OAAO,CAAC;gBACb,SAAS,EAAE,IAAI;gBACf,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;gBACnC,OAAO;gBACP,OAAO;gBACP,QAAQ,EAAE,OAAO,CAAC,MAAM,CACtB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CACvD;gBACD,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;aAChE,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/saveDocument.d.ts

@@ -0,0 +1,28 @@
+import { type ExtensionClient } from "../extensionClient.js";
+export declare function createSaveDocumentTool(workspace: string, extensionClient?: ExtensionClient): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            destructiveHint: boolean;
+        };
+        inputSchema: {
+            $schema: string;
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                filePath: {
+                    type: string;
+                    description: string;
+                };
+            };
+        };
+    };
+    handler(args: Record<string, unknown>): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};

package/dist/tools/saveDocument.js

@@ -0,0 +1,58 @@
+import { ExtensionTimeoutError, } from "../extensionClient.js";
+import { requireString, resolveFilePath, success } from "./utils.js";
+export function createSaveDocumentTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "saveDocument",
+            description: "Save a document with unsaved changes. Uses VS Code's real buffer save when the extension is connected (ensures editor state matches disk). Without the extension, this is a no-op — edits applied via editText are already written directly to disk.",
+            annotations: { destructiveHint: true },
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                additionalProperties: false,
+                required: ["filePath"],
+                properties: {
+                    filePath: { type: "string", description: "Path to the file to save" },
+                },
+            },
+        },
+        async handler(args) {
+            const rawPath = requireString(args, "filePath");
+            const filePath = resolveFilePath(rawPath, workspace);
+            // Use extension for real buffer flush when available
+            if (extensionClient?.isConnected()) {
+                try {
+                    const saved = await extensionClient.saveFile(filePath);
+                    if (saved) {
+                        return success({
+                            success: true,
+                            filePath,
+                            saved: true,
+                            source: "vscode-buffer",
+                        });
+                    }
+                    // false — file not open in editor (already on disk from editText or never opened)
+                    return success({
+                        success: true,
+                        filePath,
+                        saved: false,
+                        message: "File is not open in VS Code editor — content is already persisted to disk",
+                    });
+                }
+                catch (err) {
+                    if (!(err instanceof ExtensionTimeoutError))
+                        throw err;
+                    // Timeout — fall through to no-op response
+                }
+            }
+            // Without the extension, editText already writes directly to disk
+            return success({
+                success: true,
+                filePath,
+                saved: false,
+                message: "Extension not connected — edits are written directly to disk by editText; no buffer flush needed",
+            });
+        },
+    };
+}
+//# sourceMappingURL=saveDocument.js.map

package/dist/tools/saveDocument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"saveDocument.js","sourceRoot":"","sources":["../../src/tools/saveDocument.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,UAAU,sBAAsB,CACpC,SAAiB,EACjB,eAAiC;IAEjC,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,cAAc;YACpB,WAAW,EACT,sPAAsP;YACxP,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;YACtC,WAAW,EAAE;gBACX,OAAO,EAAE,yCAAyC;gBAClD,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,KAAK;gBAC3B,QAAQ,EAAE,CAAC,UAAU,CAAC;gBACtB,UAAU,EAAE;oBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;iBACtE;aACF;SACF;QAED,KAAK,CAAC,OAAO,CAAC,IAA6B;YACzC,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAChD,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAErD,qDAAqD;YACrD,IAAI,eAAe,EAAE,WAAW,EAAE,EAAE,CAAC;gBACnC,IAAI,CAAC;oBACH,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;oBACvD,IAAI,KAAK,EAAE,CAAC;wBACV,OAAO,OAAO,CAAC;4BACb,OAAO,EAAE,IAAI;4BACb,QAAQ;4BACR,KAAK,EAAE,IAAI;4BACX,MAAM,EAAE,eAAe;yBACxB,CAAC,CAAC;oBACL,CAAC;oBACD,kFAAkF;oBAClF,OAAO,OAAO,CAAC;wBACb,OAAO,EAAE,IAAI;wBACb,QAAQ;wBACR,KAAK,EAAE,KAAK;wBACZ,OAAO,EACL,2EAA2E;qBAC9E,CAAC,CAAC;gBACL,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,CAAC,CAAC,GAAG,YAAY,qBAAqB,CAAC;wBAAE,MAAM,GAAG,CAAC;oBACvD,2CAA2C;gBAC7C,CAAC;YACH,CAAC;YAED,kEAAkE;YAClE,OAAO,OAAO,CAAC;gBACb,OAAO,EAAE,IAAI;gBACb,QAAQ;gBACR,KAAK,EAAE,KAAK;gBACZ,OAAO,EACL,kGAAkG;aACrG,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/searchAndReplace.d.ts

@@ -0,0 +1,50 @@
+export declare function createSearchAndReplaceTool(workspace: string): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            destructiveHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                pattern: {
+                    type: string;
+                    description: string;
+                };
+                replacement: {
+                    type: string;
+                    description: string;
+                };
+                glob: {
+                    type: string;
+                    description: string;
+                };
+                isRegex: {
+                    type: string;
+                    description: string;
+                };
+                caseSensitive: {
+                    type: string;
+                    description: string;
+                };
+                dryRun: {
+                    type: string;
+                    description: string;
+                };
+                includeIgnored: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+    };
+    handler: (args: Record<string, unknown>) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};