patchwork-os 0.2.0-alpha.0

package/dist/tools/getBufferContent.d.ts

@@ -0,0 +1,80 @@
+import { type ExtensionClient } from "../extensionClient.js";
+export declare function createGetBufferContentTool(workspace: string, extensionClient?: ExtensionClient): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            required: string[];
+            additionalProperties: false;
+            properties: {
+                filePath: {
+                    type: "string";
+                    description: string;
+                };
+                startLine: {
+                    type: "integer";
+                    description: string;
+                    minimum: number;
+                };
+                endLine: {
+                    type: "integer";
+                    description: string;
+                    minimum: number;
+                };
+            };
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                content: {
+                    type: string;
+                    description: string;
+                };
+                filePath: {
+                    type: string;
+                };
+                startLine: {
+                    type: string;
+                };
+                endLine: {
+                    type: string;
+                };
+                totalLines: {
+                    type: string;
+                };
+                isDirty: {
+                    type: string;
+                    description: string;
+                };
+                languageId: {
+                    type: string;
+                };
+                source: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    timeoutMs: number;
+    handler(args: Record<string, unknown>, signal?: AbortSignal): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+            _meta?: Record<string, unknown>;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+};

package/dist/tools/getBufferContent.js

@@ -0,0 +1,207 @@
+import { createReadStream } from "node:fs";
+import fs from "node:fs/promises";
+import readline from "node:readline";
+import { ExtensionTimeoutError, } from "../extensionClient.js";
+import { error, optionalInt, requireString, resolveFilePath, successStructuredLarge, } from "./utils.js";
+const MAX_CONTENT_BYTES = 512 * 1024; // 512 KB hard cap
+/**
+ * Read lines [startLine, endLine] from a large file without loading the whole
+ * file into memory. Uses readline so only the needed lines are buffered.
+ * Returns null if the file cannot be read.
+ */
+async function readLineRange(filePath, startLine, // 1-based inclusive
+endLine, // 1-based inclusive
+signal) {
+    return new Promise((resolve) => {
+        let lineNum = 0;
+        const collected = [];
+        let stream;
+        try {
+            stream = createReadStream(filePath, { encoding: "utf-8" });
+        }
+        catch {
+            return resolve(null);
+        }
+        const rl = readline.createInterface({
+            input: stream,
+            crlfDelay: Number.POSITIVE_INFINITY,
+        });
+        rl.on("line", (line) => {
+            lineNum++;
+            if (lineNum >= startLine && lineNum <= endLine) {
+                collected.push(line);
+            }
+            // Continue counting past the range to get accurate totalLines
+        });
+        rl.on("close", () => {
+            resolve({ lines: collected, totalLines: lineNum });
+        });
+        rl.on("error", () => {
+            rl.close();
+            stream.destroy();
+            resolve(null);
+        });
+        stream.on("error", () => {
+            rl.close();
+            stream.destroy();
+            resolve(null);
+        });
+        signal?.addEventListener("abort", () => {
+            rl.close();
+            stream.destroy();
+            resolve(null);
+        });
+    });
+}
+export function createGetBufferContentTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "getBufferContent",
+            description: "Read workspace file from VS Code buffer including unsaved changes. Use before editText. Returns isDirty flag. Workspace files only.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                required: ["filePath"],
+                additionalProperties: false,
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Workspace or absolute path",
+                    },
+                    startLine: {
+                        type: "integer",
+                        description: "First line to include (1-based, default: 1)",
+                        minimum: 1,
+                    },
+                    endLine: {
+                        type: "integer",
+                        description: "Last line to include (1-based, default: all lines)",
+                        minimum: 1,
+                    },
+                },
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    content: {
+                        type: "string",
+                        description: "File or buffer content (may be sliced by startLine/endLine)",
+                    },
+                    filePath: { type: "string" },
+                    startLine: { type: "integer" },
+                    endLine: { type: "integer" },
+                    totalLines: { type: "integer" },
+                    isDirty: {
+                        type: "boolean",
+                        description: "True when the buffer has unsaved changes (extension only)",
+                    },
+                    languageId: { type: "string" },
+                    source: {
+                        type: "string",
+                        enum: ["extension", "disk"],
+                        description: "Whether content came from the live VS Code buffer or disk",
+                    },
+                },
+                required: ["content", "filePath"],
+            },
+        },
+        // 15s: disk fallback on slow VPS storage or large files via readline streaming
+        timeoutMs: 15_000,
+        async handler(args, signal) {
+            const rawPath = requireString(args, "filePath");
+            const filePath = resolveFilePath(rawPath, workspace);
+            const startLine = optionalInt(args, "startLine", 1, 1_000_000) ?? 1;
+            const endLine = optionalInt(args, "endLine", 1, 1_000_000);
+            let content = null;
+            let meta = {};
+            // Try extension first — only source with unsaved buffer state
+            if (extensionClient?.isConnected()) {
+                try {
+                    const result = await extensionClient.getFileContent(filePath);
+                    if (result !== null && typeof result === "object") {
+                        const r = result;
+                        if (typeof r.content === "string") {
+                            content = r.content;
+                            meta = {
+                                isDirty: r.isDirty ?? false,
+                                languageId: r.languageId,
+                                source: "extension",
+                            };
+                        }
+                    }
+                }
+                catch (err) {
+                    if (!(err instanceof ExtensionTimeoutError))
+                        throw err;
+                    // Timeout — fall through to disk
+                }
+            }
+            // Disk fallback
+            if (content === null) {
+                // Check file size first — avoids reading a huge file into memory
+                let fileSize;
+                try {
+                    const stat = await fs.stat(filePath);
+                    fileSize = stat.size;
+                }
+                catch {
+                    return error(`File not found: ${filePath}`);
+                }
+                if (fileSize > MAX_CONTENT_BYTES) {
+                    // Large file — only serve if the caller provided a line range
+                    if (endLine === undefined) {
+                        const sizeKb = Math.round(fileSize / 1024);
+                        return error(`File too large (${sizeKb}KB). Use startLine/endLine to read in chunks — e.g. startLine:1, endLine:500.`);
+                    }
+                    // Stream only the requested line range — no full-file allocation
+                    const rangeResult = await readLineRange(filePath, startLine, endLine, signal);
+                    if (!rangeResult)
+                        return error(`File not found: ${filePath}`);
+                    const slicedContent = rangeResult.lines.join("\n");
+                    if (Buffer.byteLength(slicedContent, "utf-8") > MAX_CONTENT_BYTES) {
+                        return error(`Requested range is too large (>${MAX_CONTENT_BYTES / 1024}KB). Narrow the line range.`);
+                    }
+                    return successStructuredLarge({
+                        isDirty: false,
+                        source: "disk",
+                        filePath,
+                        content: slicedContent,
+                        startLine,
+                        endLine,
+                        totalLines: rangeResult.totalLines,
+                    });
+                }
+                // Small file — read fully
+                try {
+                    content = await fs.readFile(filePath, { encoding: "utf-8", signal });
+                    meta = { isDirty: false, source: "disk" };
+                }
+                catch {
+                    return error(`File not found: ${filePath}`);
+                }
+            }
+            // content is now set (from extension or small disk file)
+            // Apply size cap (extension could return a large buffer)
+            if (Buffer.byteLength(content, "utf-8") > MAX_CONTENT_BYTES) {
+                const lines = content.split("\n");
+                const sizeKb = Math.round(Buffer.byteLength(content, "utf-8") / 1024);
+                return error(`File too large (${lines.length} lines, ${sizeKb}KB). Use startLine/endLine to read in chunks — e.g. startLine:1, endLine:500.`);
+            }
+            const lines = content.split("\n");
+            const totalLines = lines.length;
+            // Apply line range
+            const start = startLine - 1; // 0-based
+            const end = endLine !== undefined ? endLine : totalLines; // exclusive
+            const sliced = lines.slice(start, end);
+            return successStructuredLarge({
+                ...meta,
+                filePath,
+                content: sliced.join("\n"),
+                startLine,
+                endLine: endLine ?? totalLines,
+                totalLines,
+            });
+        },
+    };
+}
+//# sourceMappingURL=getBufferContent.js.map

package/dist/tools/getBufferContent.js.map

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

package/dist/tools/getChangeImpact.d.ts

@@ -0,0 +1,76 @@
+import type { ExtensionClient } from "../extensionClient.js";
+export declare function createGetChangeImpactTool(workspace: string, extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        extensionRequired: boolean;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                filePath: {
+                    type: "string";
+                    description: string;
+                };
+                changedSymbols: {
+                    type: "array";
+                    description: string;
+                    maxItems: number;
+                    items: {
+                        type: "object";
+                        properties: {
+                            name: {
+                                type: "string";
+                            };
+                            line: {
+                                type: "integer";
+                            };
+                        };
+                        required: string[];
+                        additionalProperties: false;
+                    };
+                };
+                workspaceOnly: {
+                    type: "boolean";
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                diagnostics: {
+                    type: string;
+                };
+                symbolImpact: {
+                    type: string;
+                };
+                blastRadius: {
+                    type: string;
+                    enum: string[];
+                };
+                summary: {
+                    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;
+    }>;
+};

package/dist/tools/getChangeImpact.js

@@ -0,0 +1,184 @@
+import { error, extensionRequired, optionalInt, requireString, resolveFilePath, successStructured, } from "./utils.js";
+function blastRadiusLevel(maxRefs) {
+    if (maxRefs >= 20)
+        return "high";
+    if (maxRefs >= 5)
+        return "medium";
+    return "low";
+}
+export function createGetChangeImpactTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "getChangeImpact",
+            extensionRequired: true,
+            description: "Blast radius after editing a file: diagnostics + reference counts for changed symbols.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Workspace or absolute path of the edited file",
+                    },
+                    changedSymbols: {
+                        type: "array",
+                        description: "Symbols that were changed (optional). Each entry must have a name; " +
+                            "optionally a line number to disambiguate overloads.",
+                        maxItems: 10,
+                        items: {
+                            type: "object",
+                            properties: {
+                                name: { type: "string" },
+                                line: { type: "integer" },
+                            },
+                            required: ["name"],
+                            additionalProperties: false,
+                        },
+                    },
+                    workspaceOnly: {
+                        type: "boolean",
+                        description: "Filter references to workspace files only (default: true). " +
+                            "External refs (node_modules, stdlib) are counted separately.",
+                    },
+                },
+                required: ["filePath"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    diagnostics: { type: "object" },
+                    symbolImpact: { type: "array" },
+                    blastRadius: { type: "string", enum: ["low", "medium", "high"] },
+                    summary: { type: "string" },
+                },
+                required: ["diagnostics", "symbolImpact", "blastRadius", "summary"],
+            },
+        },
+        handler: async (args, signal) => {
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("getChangeImpact");
+            }
+            const filePath = resolveFilePath(requireString(args, "filePath"), workspace);
+            const workspaceOnly = args.workspaceOnly !== false; // default true
+            const maxRefsPerSymbol = optionalInt(args, "maxReferencesPerSymbol") ?? 20;
+            // Validate changedSymbols array
+            const rawSymbols = args.changedSymbols;
+            const changedSymbols = [];
+            if (Array.isArray(rawSymbols)) {
+                for (const s of rawSymbols.slice(0, 10)) {
+                    const sym = s;
+                    if (typeof sym?.name === "string") {
+                        changedSymbols.push({
+                            name: sym.name,
+                            line: typeof sym.line === "number" ? sym.line : undefined,
+                        });
+                    }
+                }
+            }
+            const compositeSignal = AbortSignal.any([
+                ...(signal ? [signal] : []),
+                AbortSignal.timeout(15_000),
+            ]);
+            // 1. Get live diagnostics for the file
+            const diagnosticsRaw = await extensionClient
+                .getDiagnostics(filePath)
+                .catch(() => null);
+            const diagItems = Array.isArray(diagnosticsRaw) ? diagnosticsRaw : [];
+            const errors = diagItems.filter((d) => d.severity === "error").length;
+            const warnings = diagItems.filter((d) => d.severity === "warning").length;
+            if (compositeSignal.aborted) {
+                return error("Request aborted");
+            }
+            const symbolImpact = [];
+            if (changedSymbols.length > 0) {
+                // 2. Get document symbols to find positions of named symbols
+                const docSymsRaw = await extensionClient
+                    .getDocumentSymbols(filePath, compositeSignal)
+                    .catch(() => null);
+                const docSyms = (() => {
+                    if (!docSymsRaw)
+                        return [];
+                    const r = docSymsRaw;
+                    if (Array.isArray(r))
+                        return r;
+                    if (Array.isArray(r?.symbols))
+                        return r.symbols;
+                    return [];
+                })();
+                // 3. Match requested symbols to their positions
+                const symbolPositions = [];
+                for (const wanted of changedSymbols) {
+                    if (compositeSignal.aborted)
+                        break;
+                    const match = docSyms.find((s) => s.name === wanted.name &&
+                        (wanted.line === undefined || s.line === wanted.line));
+                    if (match) {
+                        symbolPositions.push({
+                            name: wanted.name,
+                            line: Number(match.selectionLine ?? match.line),
+                            column: Number(match.selectionColumn ?? match.column ?? 1),
+                        });
+                    }
+                }
+                // 4. Find references for matched symbols (max 5 in parallel)
+                const CONCURRENCY = 5;
+                for (let i = 0; i < symbolPositions.length; i += CONCURRENCY) {
+                    if (compositeSignal.aborted)
+                        break;
+                    const batch = symbolPositions.slice(i, i + CONCURRENCY);
+                    const results = await Promise.allSettled(batch.map((pos) => extensionClient.findReferences(filePath, pos.line, pos.column, compositeSignal)));
+                    for (let j = 0; j < batch.length; j++) {
+                        const pos = batch[j];
+                        if (!pos)
+                            continue;
+                        const result = results[j];
+                        const refsRaw = result?.status === "fulfilled"
+                            ? result.value
+                            : null;
+                        const allRefs = Array.isArray(refsRaw?.references)
+                            ? refsRaw.references
+                            : [];
+                        const wsRefs = allRefs.filter((r) => workspaceOnly
+                            ? typeof r.file === "string" &&
+                                (r.file.startsWith(workspace) ||
+                                    !r.file.includes("node_modules"))
+                            : true);
+                        const externalRefCount = allRefs.length - wsRefs.length;
+                        const affectedFiles = [
+                            ...new Set(wsRefs
+                                .map((r) => r.file)
+                                .filter((f) => typeof f === "string")),
+                        ];
+                        const referenceCount = Math.min(wsRefs.length, maxRefsPerSymbol);
+                        symbolImpact.push({
+                            name: pos.name,
+                            referenceCount,
+                            affectedFiles,
+                            externalRefCount,
+                        });
+                    }
+                }
+            }
+            const maxRefs = symbolImpact.reduce((m, s) => Math.max(m, s.referenceCount), 0);
+            const blastRadius = blastRadiusLevel(maxRefs);
+            const parts = [
+                `${errors} error(s), ${warnings} warning(s) in ${filePath}`,
+            ];
+            if (symbolImpact.length > 0) {
+                const affected = [
+                    ...new Set(symbolImpact.flatMap((s) => s.affectedFiles)),
+                ].length;
+                parts.push(`${symbolImpact.length} changed symbol(s) affect ${affected} file(s)`);
+            }
+            const summary = `${parts.join("; ")}. Blast radius: ${blastRadius}.`;
+            return successStructured({
+                diagnostics: { errors, warnings, items: diagItems.slice(0, 50) },
+                symbolImpact,
+                blastRadius,
+                summary,
+            });
+        },
+    };
+}
+//# sourceMappingURL=getChangeImpact.js.map

package/dist/tools/getChangeImpact.js.map

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

package/dist/tools/getClaudeTaskStatus.d.ts

@@ -0,0 +1,87 @@
+import type { ClaudeOrchestrator } from "../claudeOrchestrator.js";
+export declare function createGetClaudeTaskStatusTool(orchestrator: ClaudeOrchestrator, sessionId: string): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            openWorldHint: boolean;
+        };
+        inputSchema: {
+            type: string;
+            properties: {
+                taskId: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                taskId: {
+                    type: string;
+                };
+                status: {
+                    type: string;
+                };
+                cancelReason: {
+                    type: string;
+                };
+                createdAt: {
+                    type: string;
+                };
+                startedAt: {
+                    type: string;
+                };
+                doneAt: {
+                    type: string;
+                };
+                output: {
+                    type: string;
+                };
+                stderrTail: {
+                    type: string;
+                };
+                wasAborted: {
+                    type: string;
+                };
+                errorMessage: {
+                    type: string;
+                };
+                timeoutMs: {
+                    type: string;
+                };
+                startupMs: {
+                    type: string;
+                };
+                hint: {
+                    type: string;
+                };
+                origin: {
+                    type: string;
+                    enum: string[];
+                };
+                triggerSource: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    handler: (args: Record<string, unknown>) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+};