@mcp-graph-workflow/mcp-graph 5.11.0 → 5.13.0

package/dist/core/lsp/lsp-client.js

@@ -0,0 +1,256 @@
+/**
+ * LspClient — Generic JSON-RPC 2.0 client over stdio.
+ *
+ * Communicates with ANY Language Server Protocol server by spawning
+ * it as a child process and exchanging JSON-RPC 2.0 messages via
+ * Content-Length framed stdio.
+ */
+import { spawn } from "node:child_process";
+import { EventEmitter } from "node:events";
+import { logger } from "../utils/logger.js";
+// ---------------------------------------------------------------------------
+// Content-Length header pattern
+// ---------------------------------------------------------------------------
+const HEADER_REGEX = /Content-Length:\s*(\d+)\r\n\r\n/;
+// ---------------------------------------------------------------------------
+// LspClient
+// ---------------------------------------------------------------------------
+export class LspClient extends EventEmitter {
+    command;
+    args;
+    requestTimeoutMs;
+    process = null;
+    nextId = 1;
+    pending = new Map();
+    buffer = Buffer.alloc(0);
+    _ready = false;
+    constructor(command, args, requestTimeoutMs = 30_000) {
+        super();
+        this.command = command;
+        this.args = args;
+        this.requestTimeoutMs = requestTimeoutMs;
+    }
+    /** Whether the child process is running and ready for messages. */
+    get ready() {
+        return this._ready;
+    }
+    /** PID of the child process (if running). */
+    get pid() {
+        return this.process?.pid;
+    }
+    /** Spawn the child process. Does NOT send `initialize`. */
+    async start() {
+        if (this.process) {
+            logger.warn("LspClient.start called but process already running", {
+                command: this.command,
+            });
+            return;
+        }
+        logger.info("LspClient spawning server", {
+            command: this.command,
+            args: this.args.join(" "),
+        });
+        const child = spawn(this.command, this.args, {
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        this.process = child;
+        child.stdout?.on("data", (data) => {
+            this.handleData(data);
+        });
+        child.stderr?.on("data", (data) => {
+            logger.debug("LSP stderr", {
+                command: this.command,
+                data: data.toString("utf8").trim(),
+            });
+        });
+        child.on("error", (err) => {
+            logger.error("LSP process error", {
+                command: this.command,
+                error: err.message,
+            });
+            this._ready = false;
+            this.rejectAll(err);
+            this.emit("error", err);
+        });
+        child.on("exit", (code, signal) => {
+            logger.info("LSP process exited", {
+                command: this.command,
+                code: String(code ?? "null"),
+                signal: String(signal ?? "null"),
+            });
+            this._ready = false;
+            this.rejectAll(new Error(`LSP process exited (code=${code}, signal=${signal})`));
+            this.process = null;
+            this.emit("exit", code, signal);
+        });
+        this._ready = true;
+    }
+    /** Send `shutdown` request + `exit` notification, then wait for exit. */
+    async stop() {
+        if (!this.process) {
+            return;
+        }
+        try {
+            await this.sendRequest("shutdown");
+        }
+        catch {
+            // Server may already be gone — that's fine.
+        }
+        this.sendNotification("exit");
+        await new Promise((resolve) => {
+            const killTimer = setTimeout(() => {
+                logger.warn("LSP process did not exit gracefully, killing", {
+                    command: this.command,
+                });
+                this.kill();
+                resolve();
+            }, 5_000);
+            if (this.process) {
+                this.process.once("exit", () => {
+                    clearTimeout(killTimer);
+                    resolve();
+                });
+            }
+            else {
+                clearTimeout(killTimer);
+                resolve();
+            }
+        });
+        this._ready = false;
+    }
+    /** Send a JSON-RPC request and wait for the corresponding response. */
+    async sendRequest(method, params) {
+        if (!this.process?.stdin?.writable) {
+            throw new Error("LSP process is not running or stdin is not writable");
+        }
+        const id = this.nextId++;
+        const request = {
+            jsonrpc: "2.0",
+            id,
+            method,
+            ...(params !== undefined ? { params } : {}),
+        };
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`LSP request timed out after ${this.requestTimeoutMs}ms: ${method}`));
+            }, this.requestTimeoutMs);
+            this.pending.set(id, {
+                resolve: resolve,
+                reject,
+                timer,
+            });
+            const encoded = this.encode(request);
+            this.process.stdin.write(encoded);
+        });
+    }
+    /** Send a JSON-RPC notification (fire-and-forget, no response expected). */
+    sendNotification(method, params) {
+        if (!this.process?.stdin?.writable) {
+            logger.warn("LspClient.sendNotification: stdin not writable", { method });
+            return;
+        }
+        const notification = {
+            jsonrpc: "2.0",
+            method,
+            ...(params !== undefined ? { params } : {}),
+        };
+        const encoded = this.encode(notification);
+        this.process.stdin.write(encoded);
+    }
+    /** Kill the child process immediately (SIGKILL). */
+    kill() {
+        if (this.process) {
+            this.process.kill("SIGKILL");
+            this.process = null;
+            this._ready = false;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Internal helpers
+    // -------------------------------------------------------------------------
+    /** Encode a JSON-RPC message with Content-Length header. */
+    encode(msg) {
+        const json = JSON.stringify(msg);
+        const body = Buffer.from(json, "utf8");
+        const header = `Content-Length: ${body.byteLength}\r\n\r\n`;
+        return Buffer.concat([Buffer.from(header, "ascii"), body]);
+    }
+    /**
+     * Parse incoming data from stdout, extracting complete JSON-RPC messages.
+     *
+     * Handles chunked delivery: data is accumulated in an internal buffer
+     * and complete messages are extracted as they become available.
+     */
+    handleData(data) {
+        this.buffer = Buffer.concat([this.buffer, data]);
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            const headerStr = this.buffer.toString("ascii", 0, Math.min(this.buffer.byteLength, 256));
+            const match = HEADER_REGEX.exec(headerStr);
+            if (!match) {
+                break;
+            }
+            const contentLength = parseInt(match[1], 10);
+            const headerEnd = match.index + match[0].length;
+            const totalLength = headerEnd + contentLength;
+            if (this.buffer.byteLength < totalLength) {
+                // Not enough data yet — wait for more.
+                break;
+            }
+            const bodyBytes = this.buffer.subarray(headerEnd, totalLength);
+            this.buffer = this.buffer.subarray(totalLength);
+            try {
+                const parsed = JSON.parse(bodyBytes.toString("utf8"));
+                this.handleMessage(parsed);
+            }
+            catch (err) {
+                logger.error("Failed to parse LSP JSON-RPC message", {
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+    }
+    /** Process a single parsed JSON-RPC message (response or notification). */
+    handleMessage(msg) {
+        // Response — has "id"
+        if ("id" in msg && typeof msg.id === "number") {
+            const pending = this.pending.get(msg.id);
+            if (!pending) {
+                logger.warn("Received response for unknown request id", { id: msg.id });
+                return;
+            }
+            this.pending.delete(msg.id);
+            clearTimeout(pending.timer);
+            const response = msg;
+            if (response.error) {
+                pending.reject(new Error(`LSP error ${response.error.code}: ${response.error.message}`));
+            }
+            else {
+                pending.resolve(response.result);
+            }
+            return;
+        }
+        // Notification — has "method" but no "id"
+        if ("method" in msg && typeof msg.method === "string") {
+            this.emit("notification", {
+                method: msg.method,
+                params: msg.params,
+            });
+            return;
+        }
+        logger.warn("Received unrecognized JSON-RPC message", {
+            keys: Object.keys(msg).join(","),
+        });
+    }
+    /** Reject all pending requests with the given error. */
+    rejectAll(error) {
+        const entries = Array.from(this.pending.entries());
+        this.pending.clear();
+        for (const [, pending] of entries) {
+            clearTimeout(pending.timer);
+            pending.reject(error);
+        }
+    }
+}
+//# sourceMappingURL=lsp-client.js.map

package/dist/core/lsp/lsp-client.js.map

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

package/dist/core/lsp/lsp-diagnostics.d.ts

@@ -0,0 +1,40 @@
+/**
+ * LspDiagnosticsCollector — Multi-language diagnostics collector.
+ *
+ * Receives diagnostics pushed from LSP servers via textDocument/publishDiagnostics
+ * and provides query APIs for files, languages, severity filtering, and summaries.
+ */
+import type { LspDiagnostic } from "./lsp-types.js";
+export interface DiagnosticsSummary {
+    byLanguage: Record<string, {
+        errors: number;
+        warnings: number;
+        info: number;
+        hints: number;
+    }>;
+    total: {
+        errors: number;
+        warnings: number;
+        info: number;
+        hints: number;
+    };
+}
+export declare class LspDiagnosticsCollector {
+    /** Map<languageId, Map<file, LspDiagnostic[]>> */
+    private store;
+    /** Called when a server sends textDocument/publishDiagnostics. */
+    onDiagnostics(languageId: string, file: string, diagnostics: LspDiagnostic[]): void;
+    /** Get diagnostics for a specific file (across all languages). */
+    getForFile(file: string): LspDiagnostic[];
+    /** Get all diagnostics for a language. */
+    getForLanguage(languageId: string): Map<string, LspDiagnostic[]>;
+    /** Get all diagnostics, optionally filtered by severity (1=error,2=warning,3=info,4=hint). */
+    getAll(severity?: number): Map<string, LspDiagnostic[]>;
+    /** Get summary counts. */
+    getSummary(): DiagnosticsSummary;
+    /** Clear all diagnostics for a language (e.g., when server restarts). */
+    clearLanguage(languageId: string): void;
+    /** Clear everything. */
+    clearAll(): void;
+}
+//# sourceMappingURL=lsp-diagnostics.d.ts.map

package/dist/core/lsp/lsp-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-diagnostics.d.ts","sourceRoot":"","sources":["../../../src/core/lsp/lsp-diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAIpD,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9F,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1E;AAED,qBAAa,uBAAuB;IAClC,kDAAkD;IAClD,OAAO,CAAC,KAAK,CAAmD;IAEhE,kEAAkE;IAClE,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,GAAG,IAAI;IAoBnF,kEAAkE;IAClE,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE;IAazC,0CAA0C;IAC1C,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;IAIhE,8FAA8F;IAC9F,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;IAyBvD,0BAA0B;IAC1B,UAAU,IAAI,kBAAkB;IAsChC,yEAAyE;IACzE,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKvC,wBAAwB;IACxB,QAAQ,IAAI,IAAI;CAIjB"}

package/dist/core/lsp/lsp-diagnostics.js

@@ -0,0 +1,113 @@
+/**
+ * LspDiagnosticsCollector — Multi-language diagnostics collector.
+ *
+ * Receives diagnostics pushed from LSP servers via textDocument/publishDiagnostics
+ * and provides query APIs for files, languages, severity filtering, and summaries.
+ */
+import { LspDiagnosticSeverity } from "./lsp-types.js";
+import { logger } from "../utils/logger.js";
+export class LspDiagnosticsCollector {
+    /** Map<languageId, Map<file, LspDiagnostic[]>> */
+    store = new Map();
+    /** Called when a server sends textDocument/publishDiagnostics. */
+    onDiagnostics(languageId, file, diagnostics) {
+        let langMap = this.store.get(languageId);
+        if (!langMap) {
+            langMap = new Map();
+            this.store.set(languageId, langMap);
+        }
+        if (diagnostics.length === 0) {
+            langMap.delete(file);
+        }
+        else {
+            langMap.set(file, diagnostics);
+        }
+        logger.debug("lsp-diagnostics:onDiagnostics", {
+            languageId,
+            file,
+            count: String(diagnostics.length),
+        });
+    }
+    /** Get diagnostics for a specific file (across all languages). */
+    getForFile(file) {
+        const result = [];
+        for (const langMap of this.store.values()) {
+            const fileDiags = langMap.get(file);
+            if (fileDiags) {
+                result.push(...fileDiags);
+            }
+        }
+        return result;
+    }
+    /** Get all diagnostics for a language. */
+    getForLanguage(languageId) {
+        return this.store.get(languageId) ?? new Map();
+    }
+    /** Get all diagnostics, optionally filtered by severity (1=error,2=warning,3=info,4=hint). */
+    getAll(severity) {
+        const result = new Map();
+        for (const langMap of this.store.values()) {
+            for (const [file, diagnostics] of langMap) {
+                const filtered = severity != null
+                    ? diagnostics.filter((d) => d.severity === severity)
+                    : diagnostics;
+                if (filtered.length === 0) {
+                    continue;
+                }
+                const existing = result.get(file);
+                if (existing) {
+                    existing.push(...filtered);
+                }
+                else {
+                    result.set(file, [...filtered]);
+                }
+            }
+        }
+        return result;
+    }
+    /** Get summary counts. */
+    getSummary() {
+        const total = { errors: 0, warnings: 0, info: 0, hints: 0 };
+        const byLanguage = {};
+        for (const [languageId, langMap] of this.store) {
+            const langCounts = { errors: 0, warnings: 0, info: 0, hints: 0 };
+            for (const diagnostics of langMap.values()) {
+                for (const diag of diagnostics) {
+                    switch (diag.severity) {
+                        case LspDiagnosticSeverity.Error:
+                            langCounts.errors++;
+                            total.errors++;
+                            break;
+                        case LspDiagnosticSeverity.Warning:
+                            langCounts.warnings++;
+                            total.warnings++;
+                            break;
+                        case LspDiagnosticSeverity.Information:
+                            langCounts.info++;
+                            total.info++;
+                            break;
+                        case LspDiagnosticSeverity.Hint:
+                            langCounts.hints++;
+                            total.hints++;
+                            break;
+                    }
+                }
+            }
+            if (langCounts.errors + langCounts.warnings + langCounts.info + langCounts.hints > 0) {
+                byLanguage[languageId] = langCounts;
+            }
+        }
+        return { byLanguage, total };
+    }
+    /** Clear all diagnostics for a language (e.g., when server restarts). */
+    clearLanguage(languageId) {
+        this.store.delete(languageId);
+        logger.debug("lsp-diagnostics:clearLanguage", { languageId });
+    }
+    /** Clear everything. */
+    clearAll() {
+        this.store.clear();
+        logger.debug("lsp-diagnostics:clearAll");
+    }
+}
+//# sourceMappingURL=lsp-diagnostics.js.map

package/dist/core/lsp/lsp-diagnostics.js.map

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

package/dist/core/lsp/lsp-server-manager.d.ts

@@ -0,0 +1,56 @@
+/**
+ * LspServerManager — Manages multiple language server instances (one per language).
+ *
+ * Handles lazy startup, keep-alive timers, auto-restart on crash,
+ * and extension-based routing via ServerRegistry.
+ */
+import { LspClient } from "./lsp-client.js";
+import { ServerRegistry } from "./server-registry.js";
+import type { LspServerState } from "./lsp-types.js";
+export declare class LspServerManager {
+    private readonly registry;
+    private readonly rootUri;
+    private readonly keepAliveMs;
+    private servers;
+    constructor(registry: ServerRegistry, rootUri: string, keepAliveMs?: number);
+    /**
+     * Get a running LSP client for a language. Starts the server lazily if needed.
+     * Returns null if the server binary is not available.
+     */
+    ensureServer(languageId: string): Promise<LspClient | null>;
+    /**
+     * Get a client for a file path (routes by extension via registry).
+     * Returns null if no server configured for the file's language.
+     */
+    getClientForFile(filePath: string): Promise<LspClient | null>;
+    /**
+     * Check if a language server binary is installed.
+     * Uses probeCommand from config if available, otherwise `which` (or `where` on Windows).
+     */
+    isServerInstalled(languageId: string): Promise<boolean>;
+    /**
+     * Get status of all known language servers.
+     */
+    getStatus(): Map<string, LspServerState>;
+    /**
+     * Shutdown all running servers gracefully.
+     */
+    shutdownAll(): Promise<void>;
+    /**
+     * Stop a single language server.
+     */
+    stopServer(languageId: string): Promise<void>;
+    /**
+     * Reset the keep-alive timer for a language (call on each request).
+     */
+    private resetKeepAlive;
+    /**
+     * Handle server crash: auto-restart up to MAX_RESTART_ATTEMPTS.
+     */
+    private handleServerExit;
+    /**
+     * Start a language server: spawn process, send initialize, wait for response.
+     */
+    private startServer;
+}
+//# sourceMappingURL=lsp-server-manager.d.ts.map

package/dist/core/lsp/lsp-server-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-server-manager.d.ts","sourceRoot":"","sources":["../../../src/core/lsp/lsp-server-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAmBtE,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAL9B,OAAO,CAAC,OAAO,CAAoC;gBAGhC,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,MAA6B;IAG7D;;;OAGG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAqFjE;;;OAGG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IASnE;;;OAGG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoB7D;;OAEG;IACH,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC;IAqBxC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBlC;;OAEG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BnD;;OAEG;IACH,OAAO,CAAC,cAAc;IAmBtB;;OAEG;YACW,gBAAgB;IAiF9B;;OAEG;YACW,WAAW;CAwC1B"}