patchwork-os 0.2.0-alpha.0

package/dist/tools/openFile.js

@@ -0,0 +1,129 @@
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import { ExtensionTimeoutError, } from "../extensionClient.js";
+import { error, findLineNumber, optionalInt, optionalString, requireString, resolveFilePath, successStructured, } from "./utils.js";
+export function createOpenFileTool(workspace, editorCommand, openedFiles, extensionClient) {
+    return {
+        schema: {
+            name: "openFile",
+            description: "Open a file in the editor and optionally select a range of text",
+            annotations: {
+                title: "Open File in Editor",
+                readOnlyHint: false,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: false,
+            },
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                additionalProperties: false,
+                required: ["filePath"],
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Workspace or absolute path to the file to open",
+                    },
+                    startLine: {
+                        type: "integer",
+                        minimum: 1,
+                        description: "Line to scroll to (1-based). Takes precedence over startText.",
+                    },
+                    startText: {
+                        type: "string",
+                        description: "Text pattern to find and scroll to. Ignored if startLine is set.",
+                    },
+                },
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    success: { type: "boolean" },
+                    filePath: { type: "string" },
+                    via: { type: "string" },
+                    tracked: { type: "boolean" },
+                    message: { type: "string" },
+                },
+                required: ["success"],
+            },
+        },
+        async handler(args) {
+            const rawPath = requireString(args, "filePath");
+            const startText = optionalString(args, "startText", 512);
+            const startLine = optionalInt(args, "startLine");
+            const filePath = resolveFilePath(rawPath, workspace);
+            if (!fs.existsSync(filePath)) {
+                return error(`File not found: ${filePath}`);
+            }
+            // Cap tracked files to prevent unbounded memory growth
+            if (openedFiles.size >= 500) {
+                const oldest = openedFiles.values().next().value;
+                if (oldest)
+                    openedFiles.delete(oldest);
+            }
+            openedFiles.add(filePath);
+            // Prefer extension path when connected — works in remote/container environments
+            // and supports precise cursor positioning
+            if (extensionClient?.isConnected()) {
+                let line;
+                // startLine takes precedence over startText (matches CLI fallback behaviour and schema docs)
+                if (startLine) {
+                    line = startLine;
+                }
+                else if (startText) {
+                    const found = await findLineNumber(filePath, startText);
+                    if (found)
+                        line = found;
+                }
+                try {
+                    const result = await extensionClient.openFile(filePath, line);
+                    return successStructured({
+                        success: result,
+                        filePath,
+                        via: "extension",
+                    });
+                }
+                catch (err) {
+                    if (!(err instanceof ExtensionTimeoutError))
+                        throw err;
+                    // Timeout — fall through to CLI fallback
+                }
+            }
+            if (!editorCommand) {
+                return successStructured({
+                    success: true,
+                    filePath,
+                    tracked: true,
+                    message: "No editor command configured (headless VPS or SSH remote without GUI IDE). " +
+                        "File recorded internally — use getBufferContent, editText, or replaceBlock to work with it directly.",
+                });
+            }
+            // Fallback: CLI spawn
+            let gotoArg = filePath;
+            if (startText) {
+                const line = await findLineNumber(filePath, startText);
+                if (line)
+                    gotoArg = `${filePath}:${line}`;
+            }
+            else if (startLine) {
+                gotoArg = `${filePath}:${startLine}`;
+            }
+            try {
+                const child = spawn(editorCommand, ["--reuse-window", "--goto", gotoArg], {
+                    detached: true,
+                    stdio: "ignore",
+                });
+                child.on("error", (spawnErr) => {
+                    console.warn("[openFile] editor spawn error:", spawnErr.message);
+                });
+                child.unref();
+                return successStructured({ success: true, filePath });
+            }
+            catch (err) {
+                const errMsg = err instanceof Error ? err.message : String(err);
+                return error(`Failed to launch "${editorCommand}": ${errMsg}. Use the --editor flag to specify a different editor command.`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=openFile.js.map

package/dist/tools/openFile.js.map

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

package/dist/tools/openInBrowser.d.ts

@@ -0,0 +1,55 @@
+export declare function createOpenInBrowserTool(): {
+    schema: {
+        name: string;
+        description: string;
+        extensionRequired: boolean;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            idempotentHint: boolean;
+            openWorldHint: boolean;
+        };
+        inputSchema: {
+            $schema: string;
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                html: {
+                    type: string;
+                    description: string;
+                };
+                filename: {
+                    type: string;
+                    description: string;
+                };
+            };
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                path: {
+                    type: string;
+                };
+                headless: {
+                    type: string;
+                };
+                url: {
+                    type: string;
+                };
+                note: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    handler(args: Record<string, unknown>): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    }>;
+};

package/dist/tools/openInBrowser.js

@@ -0,0 +1,129 @@
+import fs from "node:fs/promises";
+import http from "node:http";
+import os from "node:os";
+import path from "node:path";
+import { execSafe, optionalString, requireString, successStructured, } from "./utils.js";
+/** True when a graphical display is available. */
+function hasDisplay() {
+    if (process.platform === "darwin" || process.platform === "win32")
+        return true;
+    return !!(process.env.DISPLAY || process.env.WAYLAND_DISPLAY);
+}
+/**
+ * Serve HTML once over a loopback HTTP server on a random port.
+ * Closes after the first GET or after 5 minutes. Never binds to 0.0.0.0.
+ */
+function serveOnce(html) {
+    return new Promise((resolve, reject) => {
+        const server = http.createServer((_req, res) => {
+            res.writeHead(200, {
+                "Content-Type": "text/html; charset=utf-8",
+                "Cache-Control": "no-store",
+            });
+            res.end(html);
+            setImmediate(() => server.close());
+        });
+        server.on("error", reject);
+        server.listen(0, "127.0.0.1", () => {
+            const addr = server.address();
+            if (!addr || typeof addr === "string") {
+                server.close();
+                return reject(new Error("Failed to bind"));
+            }
+            resolve(`http://127.0.0.1:${addr.port}/`);
+            setTimeout(() => server.close(), 5 * 60 * 1000).unref();
+        });
+    });
+}
+export function createOpenInBrowserTool() {
+    return {
+        schema: {
+            name: "openInBrowser",
+            description: "Write HTML to temp file and open in default browser. For visual reports and dashboards.",
+            extensionRequired: false,
+            annotations: {
+                title: "Open HTML in Browser",
+                readOnlyHint: false,
+                destructiveHint: false,
+                idempotentHint: false,
+                openWorldHint: true,
+            },
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                additionalProperties: false,
+                required: ["html"],
+                properties: {
+                    html: {
+                        type: "string",
+                        description: "Full self-contained HTML document content",
+                    },
+                    filename: {
+                        type: "string",
+                        description: "Basename only, must end in .html. Default: report-<timestamp>.html",
+                    },
+                },
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    path: { type: "string" },
+                    headless: { type: "boolean" },
+                    url: { type: "string" },
+                    note: { type: "string" },
+                },
+                required: ["path"],
+            },
+        },
+        async handler(args) {
+            const html = requireString(args, "html", 10 * 1024 * 1024);
+            const rawFilename = optionalString(args, "filename", 256);
+            // Sanitize filename: strip to basename, reject traversal, require .html extension
+            let sanitizedFilename;
+            if (rawFilename) {
+                const base = path.basename(rawFilename);
+                if (base !== rawFilename ||
+                    base.includes("..") ||
+                    !base.endsWith(".html")) {
+                    sanitizedFilename = `report-${Date.now()}.html`;
+                }
+                else {
+                    sanitizedFilename = base;
+                }
+            }
+            else {
+                sanitizedFilename = `report-${Date.now()}.html`;
+            }
+            const tmpPath = path.join(os.tmpdir(), sanitizedFilename);
+            await fs.writeFile(tmpPath, html, "utf8");
+            // Headless VPS — no display server, serve over loopback HTTP instead
+            if (process.platform !== "darwin" &&
+                process.platform !== "win32" &&
+                !hasDisplay()) {
+                const url = await serveOnce(html);
+                const port = new URL(url).port;
+                return successStructured({
+                    path: tmpPath,
+                    headless: true,
+                    url,
+                    note: `Headless server detected (no DISPLAY). HTML at ${url} — ` +
+                        `SSH tunnel: ssh -L ${port}:127.0.0.1:${port} your-vps then open http://localhost:${port}/ ` +
+                        `or save: curl -s ${url} -o /tmp/report.html`,
+                });
+            }
+            // Desktop — open in system default browser
+            const platform = process.platform;
+            if (platform === "darwin") {
+                await execSafe("open", [tmpPath]);
+            }
+            else if (platform === "win32") {
+                await execSafe("cmd", ["/c", "start", "", tmpPath]);
+            }
+            else {
+                await execSafe("xdg-open", [tmpPath]);
+            }
+            return successStructured({ path: tmpPath });
+        },
+    };
+}
+//# sourceMappingURL=openInBrowser.js.map

package/dist/tools/openInBrowser.js.map

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

package/dist/tools/organizeImports.d.ts

@@ -0,0 +1,56 @@
+import { type ExtensionClient } from "../extensionClient.js";
+export declare function createOrganizeImportsTool(workspace: string, extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            destructiveHint: boolean;
+            idempotentHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                filePath: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                organized: {
+                    type: string;
+                };
+                source: {
+                    type: string;
+                };
+                changes: {
+                    type: string;
+                };
+                linesBeforeCount: {
+                    type: string;
+                };
+                linesAfterCount: {
+                    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/organizeImports.js

@@ -0,0 +1,115 @@
+import fs from "node:fs";
+import { ExtensionTimeoutError, } from "../extensionClient.js";
+import { error, execSafe, requireString, resolveFilePath, successStructured, } from "./utils.js";
+async function organizeImportsNative(resolved, workspace) {
+    const biome = await execSafe("npx", [
+        "--no-install",
+        "biome",
+        "check",
+        "--apply",
+        "--formatter-enabled=false",
+        "--linter-enabled=false",
+        "--organize-imports-enabled=true",
+        resolved,
+    ], { cwd: workspace, timeout: 30_000 });
+    if (biome.exitCode === 0)
+        return { source: "biome" };
+    const prettier = await execSafe("npx", ["--no-install", "prettier", "--write", resolved], { cwd: workspace, timeout: 30_000 });
+    if (prettier.exitCode === 0)
+        return { source: "prettier" };
+    return null;
+}
+export function createOrganizeImportsTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "organizeImports",
+            description: "Organize/sort imports in workspace file. Uses VS Code ext when connected; falls back to Biome or Prettier.",
+            annotations: { destructiveHint: true, idempotentHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "File to organize imports in (relative or absolute path)",
+                    },
+                },
+                required: ["filePath"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    organized: { type: "boolean" },
+                    source: { type: "string" },
+                    changes: { type: "string" },
+                    linesBeforeCount: { type: "integer" },
+                    linesAfterCount: { type: "integer" },
+                },
+                required: ["organized"],
+            },
+        },
+        handler: async (args, _signal) => {
+            const rawPath = requireString(args, "filePath");
+            const resolved = resolveFilePath(rawPath, workspace, { write: true });
+            let contentBefore;
+            try {
+                contentBefore = fs.readFileSync(resolved, "utf-8");
+            }
+            catch {
+                return error({ error: `File not found: ${rawPath}` });
+            }
+            if (!extensionClient.isConnected()) {
+                const nativeResult = await organizeImportsNative(resolved, workspace);
+                if (!nativeResult) {
+                    return error({
+                        error: "Extension not connected and no CLI formatter (biome/prettier) available — cannot organize imports",
+                    });
+                }
+                let contentAfter;
+                try {
+                    contentAfter = fs.readFileSync(resolved, "utf-8");
+                }
+                catch {
+                    return error({ error: "File unreadable after organize operation" });
+                }
+                return successStructured({
+                    organized: true,
+                    source: nativeResult.source,
+                    changes: contentBefore === contentAfter ? "none" : "modified",
+                    linesBeforeCount: contentBefore.split("\n").length,
+                    linesAfterCount: contentAfter.split("\n").length,
+                });
+            }
+            let result;
+            try {
+                result = await extensionClient.organizeImports(resolved);
+            }
+            catch (err) {
+                if (err instanceof ExtensionTimeoutError) {
+                    return error("Extension timed out — organize imports may require more time");
+                }
+                throw err;
+            }
+            if (result === null) {
+                return error({
+                    error: "Extension failed to organize imports",
+                });
+            }
+            let contentAfter;
+            try {
+                contentAfter = fs.readFileSync(resolved, "utf-8");
+            }
+            catch {
+                return error({ error: "File unreadable after organize operation" });
+            }
+            return successStructured({
+                organized: true,
+                source: "extension",
+                changes: contentBefore === contentAfter ? "none" : "modified",
+                linesBeforeCount: contentBefore.split("\n").length,
+                linesAfterCount: contentAfter.split("\n").length,
+            });
+        },
+    };
+}
+//# sourceMappingURL=organizeImports.js.map

package/dist/tools/organizeImports.js.map

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

package/dist/tools/performanceReport.d.ts

@@ -0,0 +1,133 @@
+import type { ActivityLog } from "../activityLog.js";
+import type { ExtensionClient } from "../extensionClient.js";
+export interface PerformanceReportDeps {
+    activityLog: ActivityLog;
+    extensionClient: ExtensionClient;
+    getSessions: () => {
+        active: number;
+        inGrace: number;
+    };
+    getRateLimitRejected: () => number;
+    getExtensionDisconnectCount: () => number;
+}
+export declare function createGetPerformanceReportTool(deps: PerformanceReportDeps): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            additionalProperties: false;
+            properties: {
+                windowMinutes: {
+                    type: "number";
+                    description: string;
+                    minimum: number;
+                    maximum: number;
+                };
+            };
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                generatedAt: {
+                    type: string;
+                };
+                windowMinutes: {
+                    type: string;
+                };
+                latency: {
+                    type: string;
+                    properties: {
+                        perTool: {
+                            type: string;
+                        };
+                        overallP95Ms: {
+                            type: string;
+                        };
+                    };
+                    required: string[];
+                };
+                throughput: {
+                    type: string;
+                    properties: {
+                        callsPerMinute: {
+                            type: string;
+                        };
+                        errorsPerMinute: {
+                            type: string;
+                        };
+                        errorRatePct: {
+                            type: string;
+                        };
+                        rateLimitRejectedTotal: {
+                            type: string;
+                        };
+                    };
+                    required: string[];
+                };
+                extension: {
+                    type: string;
+                    properties: {
+                        connected: {
+                            type: string;
+                        };
+                        rttMs: {
+                            type: string[];
+                        };
+                        circuitBreakerSuspended: {
+                            type: string;
+                        };
+                        disconnectCount: {
+                            type: string;
+                        };
+                        connectionQuality: {
+                            type: string;
+                            enum: string[];
+                        };
+                    };
+                    required: string[];
+                };
+                sessions: {
+                    type: string;
+                    properties: {
+                        active: {
+                            type: string;
+                        };
+                        inGrace: {
+                            type: string;
+                        };
+                    };
+                    required: string[];
+                };
+                health: {
+                    type: string;
+                    properties: {
+                        score: {
+                            type: string;
+                        };
+                        signals: {
+                            type: string;
+                            items: {
+                                type: string;
+                            };
+                        };
+                    };
+                    required: string[];
+                };
+            };
+            required: string[];
+        };
+    };
+    handler: (params: {
+        windowMinutes?: number;
+    }) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    }>;
+};