patchwork-os 0.2.0-alpha.0

package/dist/tools/refactorExtractFunction.d.ts

@@ -0,0 +1,52 @@
+import type { ExtensionClient } from "../extensionClient.js";
+import { error, extensionRequired, successStructured } from "./utils.js";
+export declare function createRefactorExtractFunctionTool(workspace: string, extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            destructiveHint: boolean;
+        };
+        extensionRequired: boolean;
+        inputSchema: {
+            type: "object";
+            properties: {
+                file: {
+                    type: string;
+                    description: string;
+                };
+                startLine: {
+                    type: string;
+                    description: string;
+                };
+                endLine: {
+                    type: string;
+                    description: string;
+                };
+                functionName: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                refactored: {
+                    type: "boolean";
+                };
+                method: {
+                    type: "string";
+                };
+                message: {
+                    type: "string";
+                };
+            };
+            required: string[];
+        };
+    };
+    timeoutMs: number;
+    handler(args: Record<string, unknown>, signal?: AbortSignal): Promise<ReturnType<typeof successStructured> | ReturnType<typeof error> | ReturnType<typeof extensionRequired>>;
+};

package/dist/tools/refactorExtractFunction.js

@@ -0,0 +1,121 @@
+import fs from "node:fs";
+import { error, extensionRequired, requireInt, requireString, resolveFilePath, successStructured, } from "./utils.js";
+export function createRefactorExtractFunctionTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "refactorExtractFunction",
+            description: "Extract lines into a named function. Uses VS Code Extract Function when available.",
+            annotations: { destructiveHint: true },
+            extensionRequired: true,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    file: {
+                        type: "string",
+                        description: "File path (relative to workspace)",
+                    },
+                    startLine: {
+                        type: "number",
+                        description: "Start line (1-indexed)",
+                    },
+                    endLine: {
+                        type: "number",
+                        description: "End line (1-indexed)",
+                    },
+                    functionName: {
+                        type: "string",
+                        description: "Name for the extracted function",
+                    },
+                },
+                required: ["file", "startLine", "endLine", "functionName"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    refactored: { type: "boolean" },
+                    method: { type: "string" },
+                    message: { type: "string" },
+                },
+                required: ["refactored", "method", "message"],
+            },
+        },
+        timeoutMs: 30_000,
+        async handler(args, signal) {
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("refactorExtractFunction");
+            }
+            const file = requireString(args, "file");
+            const startLine = requireInt(args, "startLine", 1, 1_000_000);
+            const endLine = requireInt(args, "endLine", 1, 1_000_000);
+            const functionName = requireString(args, "functionName");
+            if (functionName.length > 64 ||
+                !/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(functionName)) {
+                return error("functionName must be a valid identifier (letters, digits, _ or $; max 64 chars)");
+            }
+            let absPath;
+            try {
+                absPath = resolveFilePath(file, workspace);
+            }
+            catch (err) {
+                return successStructured({
+                    refactored: false,
+                    method: "none",
+                    message: err instanceof Error ? err.message : String(err),
+                });
+            }
+            // Strategy 1: Try VS Code code actions
+            try {
+                const actions = await extensionClient.getCodeActions(absPath, startLine, 1, endLine, 9999, signal);
+                const actionsArray = Array.isArray(actions)
+                    ? actions
+                    : (actions?.actions ?? []);
+                const extractAction = actionsArray.find((a) => a.title && /extract/i.test(a.title));
+                if (extractAction) {
+                    const actionTitle = extractAction.title ?? "";
+                    await extensionClient.applyCodeAction(absPath, startLine, 1, endLine, 9999, actionTitle, signal);
+                    return successStructured({
+                        refactored: true,
+                        method: "codeAction",
+                        message: `Applied VS Code code action: "${actionTitle}"`,
+                    });
+                }
+            }
+            catch {
+                // fall through to text manipulation
+            }
+            // Strategy 2: Text manipulation fallback
+            try {
+                const content = fs.readFileSync(absPath, "utf-8");
+                const lines = content.split("\n");
+                const extracted = lines.slice(startLine - 1, endLine);
+                const indent = "  ";
+                const body = extracted.map((l) => `${indent}${l}`).join("\n");
+                const newFunction = `function ${functionName}() {\n${body}\n}\n`;
+                // Find insertion point: insert new function before the extracted block,
+                // then replace the extracted block with a call expression.
+                const insertAt = startLine - 1; // index of first extracted line (0-based)
+                const newLines = [
+                    ...lines.slice(0, insertAt),
+                    newFunction,
+                    `${functionName}();`,
+                    ...lines.slice(endLine),
+                ];
+                fs.writeFileSync(absPath, newLines.join("\n"), "utf-8");
+                return successStructured({
+                    refactored: true,
+                    method: "textManipulation",
+                    message: `Extracted lines ${startLine}-${endLine} into function \`${functionName}\` using text manipulation. Review the result and adjust parameters/return values as needed.`,
+                });
+            }
+            catch (err) {
+                return successStructured({
+                    refactored: false,
+                    method: "none",
+                    message: `Refactor failed: ${err instanceof Error ? err.message : String(err)}`,
+                });
+            }
+        },
+    };
+}
+//# sourceMappingURL=refactorExtractFunction.js.map

package/dist/tools/refactorExtractFunction.js.map

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

package/dist/tools/refactorPreview.d.ts

@@ -0,0 +1,75 @@
+import { type ExtensionClient } from "../extensionClient.js";
+export declare function createRefactorPreviewTool(workspace: string, extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        description: string;
+        extensionRequired: boolean;
+        inputSchema: {
+            type: "object";
+            properties: {
+                filePath: {
+                    type: string;
+                    description: string;
+                };
+                startLine: {
+                    type: string;
+                    description: string;
+                };
+                startColumn: {
+                    type: string;
+                    description: string;
+                };
+                endLine: {
+                    type: string;
+                    description: string;
+                };
+                endColumn: {
+                    type: string;
+                    description: string;
+                };
+                actionTitle: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                title: {
+                    type: "string";
+                };
+                changes: {
+                    type: "array";
+                    items: {
+                        type: "object";
+                    };
+                };
+                totalFiles: {
+                    type: "number";
+                };
+                totalEdits: {
+                    type: "number";
+                };
+                note: {
+                    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/refactorPreview.js

@@ -0,0 +1,93 @@
+import { ExtensionTimeoutError, } from "../extensionClient.js";
+import { error, extensionRequired, requireInt, requireString, resolveFilePath, successStructured, } from "./utils.js";
+export function createRefactorPreviewTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "refactorPreview",
+            description: "Preview refactoring edits across files without applying. Use getCodeActions first.",
+            extensionRequired: true,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Workspace or absolute path",
+                    },
+                    startLine: {
+                        type: "integer",
+                        description: "Start line (1-based)",
+                    },
+                    startColumn: {
+                        type: "integer",
+                        description: "Start column (1-based)",
+                    },
+                    endLine: {
+                        type: "integer",
+                        description: "End line (1-based)",
+                    },
+                    endColumn: {
+                        type: "integer",
+                        description: "End column (1-based)",
+                    },
+                    actionTitle: {
+                        type: "string",
+                        description: "Exact action title from getCodeActions output",
+                    },
+                },
+                required: [
+                    "filePath",
+                    "startLine",
+                    "startColumn",
+                    "endLine",
+                    "endColumn",
+                    "actionTitle",
+                ],
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    title: { type: "string" },
+                    changes: {
+                        type: "array",
+                        items: { type: "object" },
+                    },
+                    totalFiles: { type: "number" },
+                    totalEdits: { type: "number" },
+                    note: { type: "string" },
+                },
+                required: ["title", "changes"],
+            },
+        },
+        handler: async (args, signal) => {
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("refactorPreview", [
+                    "Use getCodeActions + applyCodeAction to apply refactorings directly",
+                ]);
+            }
+            const filePath = resolveFilePath(requireString(args, "filePath"), workspace);
+            const startLine = requireInt(args, "startLine");
+            const startColumn = requireInt(args, "startColumn");
+            const endLine = requireInt(args, "endLine");
+            const endColumn = requireInt(args, "endColumn");
+            const actionTitle = requireString(args, "actionTitle");
+            let result;
+            try {
+                result = await extensionClient.previewCodeAction(filePath, startLine, startColumn, endLine, endColumn, actionTitle, signal);
+            }
+            catch (err) {
+                if (err instanceof ExtensionTimeoutError) {
+                    return error("Language server timed out — it may still be indexing. " +
+                        "Wait a few seconds and try again.");
+                }
+                throw err;
+            }
+            if (!result)
+                return error("No response from extension");
+            const r = result;
+            if (typeof r.error === "string")
+                return error(r.error);
+            return successStructured(result);
+        },
+    };
+}
+//# sourceMappingURL=refactorPreview.js.map

package/dist/tools/refactorPreview.js.map

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

package/dist/tools/replaceBlock.d.ts

@@ -0,0 +1,62 @@
+import { type ExtensionClient } from "../extensionClient.js";
+import type { FileLock } from "../fileLock.js";
+export declare function createReplaceBlockTool(workspace: string, extensionClient?: ExtensionClient, fileLock?: FileLock, sessionId?: string): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            destructiveHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            required: string[];
+            additionalProperties: false;
+            properties: {
+                filePath: {
+                    type: "string";
+                    description: string;
+                };
+                oldContent: {
+                    type: "string";
+                    description: string;
+                };
+                newContent: {
+                    type: "string";
+                    description: string;
+                };
+                save: {
+                    type: "boolean";
+                    description: string;
+                };
+            };
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                success: {
+                    type: string;
+                };
+                saved: {
+                    type: string;
+                };
+                source: {
+                    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;
+    }>;
+};

package/dist/tools/replaceBlock.js

@@ -0,0 +1,125 @@
+import fs from "node:fs/promises";
+import { ExtensionTimeoutError, } from "../extensionClient.js";
+import { error, optionalBool, requireString, resolveFilePath, successStructured, } from "./utils.js";
+export function createReplaceBlockTool(workspace, extensionClient, fileLock, sessionId) {
+    return {
+        schema: {
+            name: "replaceBlock",
+            description: "Replace exact text block in a workspace file by content match, no line numbers. Fails clearly if not found or ambiguous.",
+            annotations: { destructiveHint: true },
+            inputSchema: {
+                type: "object",
+                required: ["filePath", "oldContent", "newContent"],
+                additionalProperties: false,
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Workspace or absolute file path",
+                    },
+                    oldContent: {
+                        type: "string",
+                        description: "The exact text to find and replace (must match precisely, including whitespace)",
+                    },
+                    newContent: {
+                        type: "string",
+                        description: "The text to replace oldContent with",
+                    },
+                    save: {
+                        type: "boolean",
+                        description: "Save after replacing (default: true)",
+                    },
+                },
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    success: { type: "boolean" },
+                    saved: { type: "boolean" },
+                    source: { type: "string" },
+                },
+                required: ["success"],
+            },
+        },
+        async handler(args) {
+            const rawPath = requireString(args, "filePath");
+            const oldContent = requireString(args, "oldContent", 65_536);
+            const newContent = requireString(args, "newContent", 65_536);
+            const save = optionalBool(args, "save") ?? true;
+            if (oldContent.length === 0) {
+                return error("oldContent must not be empty");
+            }
+            const filePath = resolveFilePath(rawPath, workspace, { write: true });
+            // Try extension first — operates on the live buffer including unsaved changes
+            if (extensionClient?.isConnected()) {
+                try {
+                    const result = await extensionClient.replaceBlock(filePath, oldContent, newContent, save);
+                    if (result !== null) {
+                        return successStructured(result);
+                    }
+                }
+                catch (err) {
+                    if (!(err instanceof ExtensionTimeoutError))
+                        throw err;
+                    // Timeout — fall through to native fallback
+                }
+            }
+            // Native fallback — operates on disk content
+            let text;
+            let originalMtimeMs;
+            try {
+                const stat = await fs.stat(filePath);
+                originalMtimeMs = stat.mtimeMs;
+                text = await fs.readFile(filePath, "utf-8");
+            }
+            catch {
+                return error(`File not found: ${filePath}`);
+            }
+            const firstIndex = text.indexOf(oldContent);
+            if (firstIndex === -1) {
+                return error("oldContent not found in file — verify the exact text including whitespace and line endings");
+            }
+            const secondIndex = text.indexOf(oldContent, firstIndex + 1);
+            if (secondIndex !== -1) {
+                let count = 2;
+                let idx = secondIndex;
+                while ((idx = text.indexOf(oldContent, idx + 1)) !== -1)
+                    count++;
+                return error(`oldContent matches ${count} locations — add more surrounding context to make it unique`);
+            }
+            const newText = text.slice(0, firstIndex) +
+                newContent +
+                text.slice(firstIndex + oldContent.length);
+            // Acquire per-file lock before write to serialize concurrent edits from multiple sessions
+            let release = null;
+            if (fileLock) {
+                if (sessionId) {
+                    const result = fileLock.tryAcquire(filePath, sessionId);
+                    if ("lockedBySession" in result) {
+                        return error(`File is locked by another session (${result.lockedBySession}) — retry after that session completes its edit`, "LOCKED_BY_SESSION");
+                    }
+                    release = result.release;
+                }
+                else {
+                    release = await fileLock.acquire(filePath);
+                }
+            }
+            try {
+                // Optimistic concurrency check — detect concurrent modification
+                const statAfter = await fs.stat(filePath);
+                if (statAfter.mtimeMs !== originalMtimeMs) {
+                    return error("File was modified concurrently — retry the edit");
+                }
+                await fs.writeFile(filePath, newText, "utf-8");
+            }
+            finally {
+                release?.();
+            }
+            return successStructured({
+                success: true,
+                saved: save,
+                source: "native-fs",
+            });
+        },
+    };
+}
+//# sourceMappingURL=replaceBlock.js.map

package/dist/tools/replaceBlock.js.map

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

package/dist/tools/resumeClaudeTask.d.ts

@@ -0,0 +1,75 @@
+import type { ClaudeOrchestrator } from "../claudeOrchestrator.js";
+export declare function createResumeClaudeTaskTool(orchestrator: ClaudeOrchestrator, sessionId: string): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        inputSchema: {
+            type: string;
+            properties: {
+                taskId: {
+                    type: string;
+                    description: string;
+                };
+                timeoutMs: {
+                    type: string;
+                    description: string;
+                };
+                effort: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                fallbackModel: {
+                    type: string;
+                    description: string;
+                };
+                maxBudgetUsd: {
+                    type: string;
+                    description: string;
+                };
+                startupTimeoutMs: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                newTaskId: {
+                    type: string;
+                };
+                originalTaskId: {
+                    type: string;
+                };
+                prompt: {
+                    type: string;
+                };
+                status: {
+                    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;
+    }>;
+};