patchwork-os 0.2.0-alpha.0

package/dist/tools/signatureHelp.d.ts

@@ -0,0 +1,86 @@
+import type { ExtensionClient } from "../extensionClient.js";
+export declare function createSignatureHelpTool(workspace: string, extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        extensionRequired: boolean;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                filePath: {
+                    type: "string";
+                    description: string;
+                };
+                line: {
+                    type: "integer";
+                    description: string;
+                };
+                column: {
+                    type: "integer";
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                found: {
+                    type: string;
+                };
+                activeSignature: {
+                    type: string;
+                };
+                activeParameter: {
+                    type: string;
+                };
+                signatures: {
+                    type: string;
+                    items: {
+                        type: string;
+                        properties: {
+                            label: {
+                                type: string;
+                            };
+                            documentation: {
+                                type: string[];
+                            };
+                            parameters: {
+                                type: string;
+                                items: {
+                                    type: string;
+                                    properties: {
+                                        label: {
+                                            type: string[];
+                                        };
+                                        documentation: {
+                                            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/signatureHelp.js

@@ -0,0 +1,79 @@
+import { lspColdStartError, lspWithRetry } from "./lsp.js";
+import { extensionRequired, requireInt, requireString, resolveFilePath, successStructured, } from "./utils.js";
+export function createSignatureHelpTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "signatureHelp",
+            extensionRequired: true,
+            description: "Function signature and param info at a call site. Returns active sig, param index, overloads.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Workspace or absolute path",
+                    },
+                    line: {
+                        type: "integer",
+                        description: "Line number (1-based, inside a function call)",
+                    },
+                    column: {
+                        type: "integer",
+                        description: "Column (1-based, inside a function call)",
+                    },
+                },
+                required: ["filePath", "line", "column"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    found: { type: "boolean" },
+                    activeSignature: { type: "integer" },
+                    activeParameter: { type: "integer" },
+                    signatures: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                label: { type: "string" },
+                                documentation: { type: ["string", "null"] },
+                                parameters: {
+                                    type: "array",
+                                    items: {
+                                        type: "object",
+                                        properties: {
+                                            label: { type: ["string", "array"] },
+                                            documentation: { type: ["string", "null"] },
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+                required: ["found"],
+            },
+        },
+        handler: async (args, signal) => {
+            const filePath = resolveFilePath(requireString(args, "filePath"), workspace);
+            const line = requireInt(args, "line", 1);
+            const column = requireInt(args, "column", 1);
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("signatureHelp (LSP signature info)", [
+                    "Use getHover to get type information about a function",
+                    "Use goToDefinition to navigate to the function definition",
+                ]);
+            }
+            const result = await lspWithRetry(() => extensionClient.signatureHelp(filePath, line, column, signal), signal);
+            if (result === "timeout")
+                return lspColdStartError();
+            if (result === null) {
+                return successStructured({ found: false });
+            }
+            return successStructured({ found: true, ...result });
+        },
+    };
+}
+//# sourceMappingURL=signatureHelp.js.map

package/dist/tools/signatureHelp.js.map

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

package/dist/tools/spawnWorkspace.d.ts

@@ -0,0 +1,103 @@
+import type { ChildProcess, SpawnOptions } from "node:child_process";
+export interface SpawnWorkspaceResult {
+    pid: number;
+    port: number;
+    workspace: string;
+    authToken: string;
+    lockFile: string;
+    /**
+     * True when `waitForExtension` was requested AND the spawned bridge
+     * reported extensionConnected=true before the deadline. Undefined when
+     * `waitForExtension` was not requested.
+     */
+    extensionConnected?: boolean;
+    /** PID of the spawned `code-server` process when `codeServer: true`. */
+    codeServerPid?: number;
+    /** Port chosen for the spawned `code-server` (when `codeServer: true`). */
+    codeServerPort?: number;
+}
+export type HealthFetcher = (url: string, token: string) => Promise<{
+    extensionConnected: boolean;
+} | null>;
+export type SpawnFn = (cmd: string, args: string[], opts: SpawnOptions) => Pick<ChildProcess, "pid" | "unref">;
+export declare function createSpawnWorkspaceTool(spawnFn?: SpawnFn, healthFetcher?: HealthFetcher): {
+    schema: {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                path: {
+                    type: string;
+                    description: string;
+                };
+                port: {
+                    type: string;
+                    description: string;
+                };
+                timeoutMs: {
+                    type: string;
+                    description: string;
+                };
+                token: {
+                    type: string;
+                    description: string;
+                };
+                waitForExtension: {
+                    type: string;
+                    description: string;
+                };
+                codeServer: {
+                    type: string;
+                    description: string;
+                };
+                codeServerPort: {
+                    type: string;
+                    description: string;
+                };
+                codeServerBin: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                pid: {
+                    type: string;
+                };
+                port: {
+                    type: string;
+                };
+                workspace: {
+                    type: string;
+                };
+                authToken: {
+                    type: string;
+                };
+                lockFile: {
+                    type: string;
+                };
+                extensionConnected: {
+                    type: string;
+                };
+                codeServerPid: {
+                    type: string;
+                };
+                codeServerPort: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    handler: (args: Record<string, unknown>) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};

package/dist/tools/spawnWorkspace.js

@@ -0,0 +1,268 @@
+import { spawn } from "node:child_process";
+import fs from "node:fs/promises";
+import { homedir } from "node:os";
+import path from "node:path";
+import { err, okS, toCallToolResult } from "../fp/result.js";
+const defaultHealthFetcher = async (url, token) => {
+    try {
+        const res = await fetch(url, {
+            headers: { Authorization: `Bearer ${token}` },
+        });
+        if (!res.ok)
+            return null;
+        const body = (await res.json());
+        return {
+            extensionConnected: body.extensionConnected === true,
+        };
+    }
+    catch {
+        return null;
+    }
+};
+function getLockDir() {
+    const configDir = process.env.CLAUDE_CONFIG_DIR || path.join(homedir(), ".claude");
+    return path.join(configDir, "ide");
+}
+async function findLockForPid(lockDir, pid) {
+    let entries;
+    try {
+        entries = await fs.readdir(lockDir);
+    }
+    catch {
+        return null;
+    }
+    for (const entry of entries) {
+        if (!entry.endsWith(".lock"))
+            continue;
+        const lockPath = path.join(lockDir, entry);
+        try {
+            const raw = await fs.readFile(lockPath, "utf-8");
+            const data = JSON.parse(raw);
+            if (data.pid === pid && data.isBridge === true) {
+                return { lockFile: lockPath, data };
+            }
+        }
+        catch {
+            // skip unreadable / non-JSON files
+        }
+    }
+    return null;
+}
+export function createSpawnWorkspaceTool(spawnFn = spawn, healthFetcher = defaultHealthFetcher) {
+    return {
+        schema: {
+            name: "spawnWorkspace",
+            description: "Spawn claude-ide-bridge for a workspace dir. Returns pid/port/authToken once lock appears; optionally waits for extension handshake.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    path: {
+                        type: "string",
+                        description: "Absolute path to the workspace directory to open",
+                    },
+                    port: {
+                        type: "integer",
+                        description: "Port for the spawned bridge (optional; picks a free port if omitted)",
+                    },
+                    timeoutMs: {
+                        type: "integer",
+                        description: "Max ms to wait for bridge lock (and extension handshake when waitForExtension=true). Default 30000.",
+                    },
+                    token: {
+                        type: "string",
+                        description: "Fixed auth token for the spawned bridge (optional)",
+                    },
+                    waitForExtension: {
+                        type: "boolean",
+                        description: "If true, poll /health on the spawned bridge until extensionConnected=true. Shares the timeoutMs budget.",
+                    },
+                    codeServer: {
+                        type: "boolean",
+                        description: "If true, also spawn `code-server` against the workspace (prereq: installed on PATH with extension pre-loaded). Implicitly enables waitForExtension.",
+                    },
+                    codeServerPort: {
+                        type: "integer",
+                        description: "Port for the spawned code-server (default: 8080). Ignored when codeServer=false.",
+                    },
+                    codeServerBin: {
+                        type: "string",
+                        description: "Override code-server binary path (default: 'code-server' on PATH).",
+                    },
+                },
+                required: ["path"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    pid: { type: "number" },
+                    port: { type: "number" },
+                    workspace: { type: "string" },
+                    authToken: { type: "string" },
+                    lockFile: { type: "string" },
+                    extensionConnected: { type: "boolean" },
+                    codeServerPid: { type: "number" },
+                    codeServerPort: { type: "number" },
+                },
+                required: ["pid", "port", "workspace", "authToken", "lockFile"],
+            },
+        },
+        handler: async (args) => {
+            return toCallToolResult(await spawnWorkspace(args, spawnFn, healthFetcher));
+        },
+    };
+}
+async function spawnWorkspace(args, spawnFn, healthFetcher) {
+    const rawPath = args.path;
+    if (typeof rawPath !== "string" || rawPath.trim() === "") {
+        return err("invalid_arg", "path must be a non-empty string");
+    }
+    if (rawPath.includes("\x00")) {
+        return err("invalid_arg", "path must not contain null bytes");
+    }
+    const workspacePath = path.resolve(rawPath);
+    const timeoutMs = typeof args.timeoutMs === "number" && args.timeoutMs > 0
+        ? args.timeoutMs
+        : 30_000;
+    const portArg = typeof args.port === "number" && Number.isInteger(args.port)
+        ? args.port
+        : undefined;
+    const tokenArg = typeof args.token === "string" && args.token.length > 0
+        ? args.token
+        : undefined;
+    // Locate the bridge entry point: dist/index.js (one dir above this file)
+    const bridgeBin = path.resolve(new URL(".", import.meta.url).pathname, "..", "index.js");
+    const spawnArgs = [bridgeBin, "--workspace", workspacePath];
+    if (portArg !== undefined) {
+        spawnArgs.push("--port", String(portArg));
+    }
+    if (tokenArg !== undefined) {
+        spawnArgs.push("--fixed-token", tokenArg);
+    }
+    let child;
+    try {
+        child = spawnFn(process.execPath, spawnArgs, {
+            detached: true,
+            stdio: "ignore",
+        });
+    }
+    catch (e) {
+        return err("exec_failed", `Failed to spawn bridge: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    if (child.pid === undefined) {
+        return err("exec_failed", "Failed to spawn bridge: no PID assigned");
+    }
+    // Let the child survive past parent exit
+    child.unref();
+    const pid = child.pid;
+    const lockDir = getLockDir();
+    const deadline = Date.now() + timeoutMs;
+    const pollInterval = 500;
+    const codeServerMode = args.codeServer === true;
+    // code-server mode is useless without waiting for the extension to connect
+    // (that's the whole point — spawn an IDE so LSP becomes available).
+    const waitForExtension = args.waitForExtension === true || codeServerMode;
+    const codeServerPort = typeof args.codeServerPort === "number" &&
+        Number.isInteger(args.codeServerPort)
+        ? args.codeServerPort
+        : 8080;
+    const codeServerBin = typeof args.codeServerBin === "string" && args.codeServerBin.length > 0
+        ? args.codeServerBin
+        : "code-server";
+    while (Date.now() < deadline) {
+        const found = await findLockForPid(lockDir, pid);
+        if (found !== null) {
+            const port = found.data.port ?? portArg ?? 0;
+            const baseResult = {
+                pid,
+                port,
+                workspace: found.data.workspace,
+                authToken: found.data.authToken,
+                lockFile: found.lockFile,
+            };
+            // Spawn code-server once the bridge is listening so the extension
+            // inside code-server can immediately discover the lock file and
+            // connect. Any spawn failure (binary missing, etc.) surfaces as
+            // code_server_missing so the caller gets a clean diagnostic instead
+            // of the generic handshake-timeout error below.
+            let codeServerPid;
+            if (codeServerMode) {
+                try {
+                    const csChild = spawnFn(codeServerBin, [
+                        "--bind-addr",
+                        `127.0.0.1:${codeServerPort}`,
+                        "--auth",
+                        "none",
+                        workspacePath,
+                    ], { detached: true, stdio: "ignore" });
+                    if (csChild.pid === undefined) {
+                        return err("code_server_missing", `code-server spawned without a PID — check '${codeServerBin}' is on PATH`);
+                    }
+                    csChild.unref();
+                    codeServerPid = csChild.pid;
+                    baseResult.codeServerPid = codeServerPid;
+                    baseResult.codeServerPort = codeServerPort;
+                }
+                catch (e) {
+                    // Clean up the bridge we just spawned before reporting.
+                    try {
+                        process.kill(pid, "SIGTERM");
+                    }
+                    catch {
+                        /* ignore */
+                    }
+                    return err("code_server_missing", `Failed to spawn '${codeServerBin}': ${e instanceof Error ? e.message : String(e)}`);
+                }
+            }
+            if (!waitForExtension) {
+                return okS(baseResult);
+            }
+            // Share the remaining timeout budget between lock discovery and
+            // extension handshake. If the bridge wrote a lock but the extension
+            // never connects, we still time out.
+            const healthUrl = `http://127.0.0.1:${port}/health`;
+            while (Date.now() < deadline) {
+                const health = await healthFetcher(healthUrl, found.data.authToken);
+                if (health?.extensionConnected === true) {
+                    return okS({
+                        ...baseResult,
+                        extensionConnected: true,
+                    });
+                }
+                const remaining = deadline - Date.now();
+                if (remaining <= 0)
+                    break;
+                await new Promise((resolve) => setTimeout(resolve, Math.min(pollInterval, remaining)));
+            }
+            // Lock appeared but extension never connected — kill child + timeout.
+            try {
+                process.kill(pid, "SIGTERM");
+            }
+            catch {
+                // already exited
+            }
+            if (codeServerPid !== undefined) {
+                try {
+                    process.kill(codeServerPid, "SIGTERM");
+                }
+                catch {
+                    // already exited
+                }
+            }
+            return err("timeout", `Bridge started (pid=${pid}) but extension did not connect within ${timeoutMs}ms`);
+        }
+        const remaining = deadline - Date.now();
+        if (remaining <= 0)
+            break;
+        await new Promise((resolve) => setTimeout(resolve, Math.min(pollInterval, remaining)));
+    }
+    // Timed out — kill the child
+    try {
+        process.kill(pid, "SIGTERM");
+    }
+    catch {
+        // ignore — already exited
+    }
+    return err("timeout", `Bridge did not write lock file within ${timeoutMs}ms (pid=${pid}, workspace=${workspacePath})`);
+}
+//# sourceMappingURL=spawnWorkspace.js.map

package/dist/tools/spawnWorkspace.js.map

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

package/dist/tools/stackTraceParser.d.ts

@@ -0,0 +1,43 @@
+/**
+ * One frame pulled out of a stack trace. `file` is raw from the trace —
+ * may be absolute, workspace-relative, or a webpack/source-map ref.
+ * Resolution to an absolute workspace path is the caller's job.
+ */
+export interface StackFrame {
+    /** Original frame text (trimmed). */
+    raw: string;
+    /** Function / method / symbol name if identifiable, else null. */
+    function: string | null;
+    /** File path as it appeared in the trace. */
+    file: string;
+    /** 1-indexed line number. */
+    line: number;
+    /** 1-indexed column, if present. */
+    column: number | null;
+    /** Detected language family that produced the frame. */
+    language: "node" | "python" | "browser" | "generic";
+}
+/**
+ * Heuristic stack-trace parser. Recognises:
+ *   Node/V8: `    at fn (/abs/path/file.ts:123:45)`
+ *            `    at /abs/path/file.ts:123:45`
+ *   Browser: `fn@http://host/path/file.js:123:45`
+ *            `http://host/path/file.js:123:45`
+ *   Python:  `  File "/path/file.py", line 123, in fn`
+ *   Generic: any `file:line:column` or `file:line` inside the text.
+ *
+ * Frames are returned in the order they appear — the first frame is the
+ * top of the stack (where the error was thrown / re-raised last).
+ */
+export declare function parseStackTrace(text: string): StackFrame[];
+/**
+ * Resolve a parsed frame's `file` to an absolute path inside `workspace`.
+ * Handles:
+ *   - absolute paths inside the workspace → pass through
+ *   - workspace-relative paths → joined with workspace
+ *   - URL-form paths (http://host/a/b/file.ts) → strip scheme+host, try as relative
+ *
+ * Returns `null` for paths that resolve outside the workspace (security
+ * guard — we don't want to blame files outside the project root).
+ */
+export declare function resolveFrameFile(workspace: string, file: string): string | null;