@windagency/valora 2.2.0 → 2.3.0

package/dist/lsp/lsp-lifecycle.service.js

@@ -0,0 +1,57 @@
+/**
+ * LSP Lifecycle Service
+ *
+ * Manages the lifecycle of LSP servers within the context of a pipeline run.
+ * Handles spawn-on-demand, session scoping, and cleanup.
+ */
+import { getLSPClientManager } from './lsp-client-manager.service.js';
+/**
+ * LSP Lifecycle Service — coordinates server lifecycle with pipeline execution
+ */
+export class LSPLifecycleService {
+    manager;
+    sessionActive = false;
+    constructor(projectRoot) {
+        this.manager = getLSPClientManager(projectRoot);
+    }
+    /**
+     * Start a session — allows servers to be spawned
+     */
+    startSession() {
+        this.sessionActive = true;
+    }
+    /**
+     * End a session — shuts down all servers
+     */
+    async endSession() {
+        this.sessionActive = false;
+        await this.manager.shutdownAll();
+    }
+    /**
+     * Check if a session is active
+     */
+    isSessionActive() {
+        return this.sessionActive;
+    }
+    /**
+     * Get the client manager (for tool handlers to use)
+     */
+    getManager() {
+        return this.manager;
+    }
+}
+/**
+ * Singleton management
+ */
+let lifecycleInstance = null;
+export function getLSPLifecycle(projectRoot) {
+    if (!lifecycleInstance && projectRoot) {
+        lifecycleInstance = new LSPLifecycleService(projectRoot);
+    }
+    lifecycleInstance ??= new LSPLifecycleService(process.cwd());
+    return lifecycleInstance;
+}
+export function resetLSPLifecycle() {
+    lifecycleInstance = null;
+}
+//# sourceMappingURL=lsp-lifecycle.service.js.map

package/dist/lsp/lsp-lifecycle.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-lifecycle.service.js","sourceRoot":"","sources":["../../src/lsp/lsp-lifecycle.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAgC,MAAM,8BAA8B,CAAC;AAEjG;;GAEG;AACH,MAAM,OAAO,mBAAmB;IACvB,OAAO,CAA0B;IACjC,aAAa,GAAG,KAAK,CAAC;IAE9B,YAAY,WAAmB;QAC9B,IAAI,CAAC,OAAO,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,YAAY;QACX,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACf,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC3B,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,eAAe;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,UAAU;QACT,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;CACD;AAED;;GAEG;AACH,IAAI,iBAAiB,GAA+B,IAAI,CAAC;AAEzD,MAAM,UAAU,eAAe,CAAC,WAAoB;IACnD,IAAI,CAAC,iBAAiB,IAAI,WAAW,EAAE,CAAC;QACvC,iBAAiB,GAAG,IAAI,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAC1D,CAAC;IACD,iBAAiB,KAAK,IAAI,mBAAmB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7D,OAAO,iBAAiB,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,iBAAiB;IAChC,iBAAiB,GAAG,IAAI,CAAC;AAC1B,CAAC"}

package/dist/lsp/lsp-protocol-adapter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * VSCode LSP Protocol Adapter — vscode-languageserver-protocol implementation
+ *
+ * This is a concrete implementation of LSPProtocolAdapter using the
+ * vscode-languageserver-protocol library for JSON-RPC communication.
+ * The interfaces are defined separately to allow for other implementations
+ * (custom JSON-RPC, mock connections for testing, etc.)
+ *
+ * Benefits:
+ * - Implements library-agnostic LSPProtocolAdapter interface
+ * - Can be swapped with other implementations without changing consumers
+ * - Isolates all vscode-languageserver-protocol dependencies to this file
+ */
+import type { ChildProcess } from 'child_process';
+import type { LSPProtocolAdapter, LSPProtocolConnection } from './lsp-protocol-adapter.interface.js';
+/**
+ * VSCode LSP Protocol Adapter Implementation
+ *
+ * Concrete implementation using vscode-languageserver-protocol.
+ */
+export declare class VSCodeLSPProtocolAdapter implements LSPProtocolAdapter {
+    /**
+     * Create a protocol connection from a child process's stdio streams
+     */
+    createConnection(process: ChildProcess): LSPProtocolConnection | null;
+}
+/**
+ * Default adapter instance factory
+ * This is used by the getLSPProtocolAdapter function in the interface
+ */
+export declare function createDefaultLSPProtocolAdapter(): LSPProtocolAdapter;
+//# sourceMappingURL=lsp-protocol-adapter.d.ts.map

package/dist/lsp/lsp-protocol-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-protocol-adapter.d.ts","sourceRoot":"","sources":["../../src/lsp/lsp-protocol-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAQlD,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAqDlG;;;;GAIG;AACH,qBAAa,wBAAyB,YAAW,kBAAkB;IAClE;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,qBAAqB,GAAG,IAAI;CASrE;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,IAAI,kBAAkB,CAEpE"}

package/dist/lsp/lsp-protocol-adapter.interface.d.ts

@@ -0,0 +1,93 @@
+/**
+ * LSP Protocol Adapter Interface
+ *
+ * Library-agnostic interface for LSP JSON-RPC protocol communication.
+ * Implementations can use vscode-languageserver-protocol, custom JSON-RPC, or any
+ * compatible transport.
+ *
+ * This separation allows:
+ * - Multiple adapter implementations without coupling
+ * - Easy testing with mock protocol connections
+ * - Library migration without changing consumer code
+ */
+import type { ChildProcess } from 'child_process';
+/**
+ * A protocol connection to a language server process
+ *
+ * Wraps the JSON-RPC transport layer, providing typed request/notification methods
+ * without exposing the underlying protocol library.
+ */
+export interface LSPProtocolConnection {
+    /**
+     * Clean up and release all resources
+     */
+    dispose(): void;
+    /**
+     * Register a handler for connection close events
+     */
+    onClose(handler: () => void): void;
+    /**
+     * Register a handler for connection errors
+     */
+    onError(handler: (error: Error) => void): void;
+    /**
+     * Send a JSON-RPC notification (no response expected)
+     *
+     * @param method - The LSP method name
+     * @param params - Optional parameters
+     */
+    sendNotification(method: string, params?: unknown): void;
+    /**
+     * Send a JSON-RPC request and wait for response
+     *
+     * @param method - The LSP method name
+     * @param params - Optional parameters
+     * @returns The response result
+     */
+    sendRequest(method: string, params?: unknown): Promise<unknown>;
+    /**
+     * Start listening for incoming messages
+     */
+    listen(): void;
+}
+/**
+ * LSP Protocol Adapter Interface
+ *
+ * Defines the contract for creating LSP protocol connections.
+ * All protocol-level operations should go through this interface.
+ */
+export interface LSPProtocolAdapter {
+    /**
+     * Create a protocol connection from a child process's stdio streams
+     *
+     * @param process - The child process running the language server
+     * @returns A protocol connection, or null if streams are unavailable
+     */
+    createConnection(process: ChildProcess): LSPProtocolConnection | null;
+}
+/**
+ * Get the singleton LSPProtocolAdapter instance
+ *
+ * @returns LSPProtocolAdapter instance
+ *
+ * @example
+ * import { getLSPProtocolAdapter } from './lsp-protocol-adapter.interface.js';
+ *
+ * const adapter = getLSPProtocolAdapter();
+ * const connection = adapter.createConnection(childProcess);
+ * connection.listen();
+ * const result = await connection.sendRequest('initialize', params);
+ */
+export declare function getLSPProtocolAdapter(): LSPProtocolAdapter;
+/**
+ * Set a custom LSPProtocolAdapter implementation
+ * Useful for testing or switching to different protocol libraries
+ *
+ * @param adapter - The adapter instance to use
+ */
+export declare function setLSPProtocolAdapter(adapter: LSPProtocolAdapter): void;
+/**
+ * Reset the singleton instance (for testing)
+ */
+export declare function resetLSPProtocolAdapter(): void;
+//# sourceMappingURL=lsp-protocol-adapter.interface.d.ts.map

package/dist/lsp/lsp-protocol-adapter.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-protocol-adapter.interface.d.ts","sourceRoot":"","sources":["../../src/lsp/lsp-protocol-adapter.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAIlD;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACrC;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAEnC;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;IAE/C;;;;;OAKG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAEzD;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhE;;OAEG;IACH,MAAM,IAAI,IAAI,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IAClC;;;;;OAKG;IACH,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,qBAAqB,GAAG,IAAI,CAAC;CACtE;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,IAAI,kBAAkB,CAG1D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAEvE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/lsp/lsp-protocol-adapter.interface.js

@@ -0,0 +1,50 @@
+/**
+ * LSP Protocol Adapter Interface
+ *
+ * Library-agnostic interface for LSP JSON-RPC protocol communication.
+ * Implementations can use vscode-languageserver-protocol, custom JSON-RPC, or any
+ * compatible transport.
+ *
+ * This separation allows:
+ * - Multiple adapter implementations without coupling
+ * - Easy testing with mock protocol connections
+ * - Library migration without changing consumer code
+ */
+import { createDefaultLSPProtocolAdapter } from './lsp-protocol-adapter.js';
+/**
+ * Singleton instance
+ */
+let adapterInstance = null;
+/**
+ * Get the singleton LSPProtocolAdapter instance
+ *
+ * @returns LSPProtocolAdapter instance
+ *
+ * @example
+ * import { getLSPProtocolAdapter } from './lsp-protocol-adapter.interface.js';
+ *
+ * const adapter = getLSPProtocolAdapter();
+ * const connection = adapter.createConnection(childProcess);
+ * connection.listen();
+ * const result = await connection.sendRequest('initialize', params);
+ */
+export function getLSPProtocolAdapter() {
+    adapterInstance ??= createDefaultLSPProtocolAdapter();
+    return adapterInstance;
+}
+/**
+ * Set a custom LSPProtocolAdapter implementation
+ * Useful for testing or switching to different protocol libraries
+ *
+ * @param adapter - The adapter instance to use
+ */
+export function setLSPProtocolAdapter(adapter) {
+    adapterInstance = adapter;
+}
+/**
+ * Reset the singleton instance (for testing)
+ */
+export function resetLSPProtocolAdapter() {
+    adapterInstance = null;
+}
+//# sourceMappingURL=lsp-protocol-adapter.interface.js.map

package/dist/lsp/lsp-protocol-adapter.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-protocol-adapter.interface.js","sourceRoot":"","sources":["../../src/lsp/lsp-protocol-adapter.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AA+DzE;;GAEG;AACH,IAAI,eAAe,GAA8B,IAAI,CAAC;AAEtD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB;IACpC,eAAe,KAAK,+BAA+B,EAAE,CAAC;IACtD,OAAO,eAAe,CAAC;AACxB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA2B;IAChE,eAAe,GAAG,OAAO,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACtC,eAAe,GAAG,IAAI,CAAC;AACxB,CAAC"}

package/dist/lsp/lsp-protocol-adapter.js

@@ -0,0 +1,69 @@
+/**
+ * VSCode LSP Protocol Adapter — vscode-languageserver-protocol implementation
+ *
+ * This is a concrete implementation of LSPProtocolAdapter using the
+ * vscode-languageserver-protocol library for JSON-RPC communication.
+ * The interfaces are defined separately to allow for other implementations
+ * (custom JSON-RPC, mock connections for testing, etc.)
+ *
+ * Benefits:
+ * - Implements library-agnostic LSPProtocolAdapter interface
+ * - Can be swapped with other implementations without changing consumers
+ * - Isolates all vscode-languageserver-protocol dependencies to this file
+ */
+import { createProtocolConnection, StreamMessageReader, StreamMessageWriter } from 'vscode-languageserver-protocol/node';
+/**
+ * Wraps a vscode-languageserver-protocol ProtocolConnection
+ */
+class VSCodeProtocolConnection {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    dispose() {
+        this.connection.dispose();
+    }
+    listen() {
+        this.connection.listen();
+    }
+    onClose(handler) {
+        this.connection.onClose(handler);
+    }
+    onError(handler) {
+        this.connection.onError(([error]) => {
+            handler(error);
+        });
+    }
+    sendNotification(method, params) {
+        void this.connection.sendNotification(method, params);
+    }
+    async sendRequest(method, params) {
+        return this.connection.sendRequest(method, params);
+    }
+}
+/**
+ * VSCode LSP Protocol Adapter Implementation
+ *
+ * Concrete implementation using vscode-languageserver-protocol.
+ */
+export class VSCodeLSPProtocolAdapter {
+    /**
+     * Create a protocol connection from a child process's stdio streams
+     */
+    createConnection(process) {
+        if (!process.stdout || !process.stdin)
+            return null;
+        const reader = new StreamMessageReader(process.stdout);
+        const writer = new StreamMessageWriter(process.stdin);
+        const connection = createProtocolConnection(reader, writer);
+        return new VSCodeProtocolConnection(connection);
+    }
+}
+/**
+ * Default adapter instance factory
+ * This is used by the getLSPProtocolAdapter function in the interface
+ */
+export function createDefaultLSPProtocolAdapter() {
+    return new VSCodeLSPProtocolAdapter();
+}
+//# sourceMappingURL=lsp-protocol-adapter.js.map

package/dist/lsp/lsp-protocol-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-protocol-adapter.js","sourceRoot":"","sources":["../../src/lsp/lsp-protocol-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EACN,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,MAAM,qCAAqC,CAAC;AAkB7C;;GAEG;AACH,MAAM,wBAAwB;IACZ,UAAU,CAA6B;IAExD,YAAY,UAAsC;QACjD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC9B,CAAC;IAED,OAAO;QACN,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM;QACL,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,OAAO,CAAC,OAAmB;QAC1B,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,CAAC,OAA+B;QACtC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE;YACnC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,gBAAgB,CAAC,MAAc,EAAE,MAAgB;QAChD,KAAK,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,MAAgB;QACjD,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;CACD;AAED;;;;GAIG;AACH,MAAM,OAAO,wBAAwB;IACpC;;OAEG;IACH,gBAAgB,CAAC,OAAqB;QACrC,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAEnD,MAAM,MAAM,GAAG,IAAI,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,IAAI,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,UAAU,GAAG,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAE5D,OAAO,IAAI,wBAAwB,CAAC,UAAU,CAAC,CAAC;IACjD,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,UAAU,+BAA+B;IAC9C,OAAO,IAAI,wBAAwB,EAAE,CAAC;AACvC,CAAC"}

package/dist/lsp/lsp-result-cache.d.ts

@@ -0,0 +1,43 @@
+/**
+ * LSP Result Cache
+ *
+ * LRU cache for LSP responses to avoid redundant server calls.
+ */
+import type { LSPCacheOptions } from './lsp.types.js';
+/**
+ * LRU cache for LSP results
+ */
+export declare class LSPResultCache {
+    private readonly cache;
+    private readonly options;
+    constructor(options?: Partial<LSPCacheOptions>);
+    /**
+     * Get a cached result
+     */
+    get<T>(key: string): null | T;
+    /**
+     * Set a cached result
+     */
+    set<T>(key: string, value: T): void;
+    /**
+     * Invalidate entries for a file (e.g., when file is modified)
+     */
+    invalidateFile(filePath: string): void;
+    /**
+     * Clear the entire cache
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        maxEntries: number;
+        size: number;
+        ttlMs: number;
+    };
+    /**
+     * Generate a cache key for an LSP request
+     */
+    static makeKey(method: string, filePath: string, ...extra: Array<number | string>): string;
+}
+//# sourceMappingURL=lsp-result-cache.d.ts.map

package/dist/lsp/lsp-result-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-result-cache.d.ts","sourceRoot":"","sources":["../../src/lsp/lsp-result-cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAc,eAAe,EAAE,MAAM,aAAa,CAAC;AAQ/D;;GAEG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;IAChE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;gBAE9B,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAI9C;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,CAAC;IAiB7B;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAgBnC;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQtC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,QAAQ,IAAI;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAQ/D;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM;CAG1F"}

package/dist/lsp/lsp-result-cache.js

@@ -0,0 +1,87 @@
+/**
+ * LSP Result Cache
+ *
+ * LRU cache for LSP responses to avoid redundant server calls.
+ */
+/** Default cache settings */
+const DEFAULT_OPTIONS = {
+    maxEntries: 500,
+    ttlMs: 30_000 // 30 seconds
+};
+/**
+ * LRU cache for LSP results
+ */
+export class LSPResultCache {
+    cache = new Map();
+    options;
+    constructor(options) {
+        this.options = { ...DEFAULT_OPTIONS, ...options };
+    }
+    /**
+     * Get a cached result
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return null;
+        // Check TTL
+        if (Date.now() - entry.timestamp > this.options.ttlMs) {
+            this.cache.delete(key);
+            return null;
+        }
+        // Move to end (most recently used)
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        return entry.value;
+    }
+    /**
+     * Set a cached result
+     */
+    set(key, value) {
+        // Evict oldest if at capacity
+        if (this.cache.size >= this.options.maxEntries) {
+            const oldest = this.cache.keys().next().value;
+            if (oldest !== undefined) {
+                this.cache.delete(oldest);
+            }
+        }
+        this.cache.set(key, {
+            key,
+            timestamp: Date.now(),
+            value
+        });
+    }
+    /**
+     * Invalidate entries for a file (e.g., when file is modified)
+     */
+    invalidateFile(filePath) {
+        for (const [key] of this.cache) {
+            if (key.startsWith(filePath)) {
+                this.cache.delete(key);
+            }
+        }
+    }
+    /**
+     * Clear the entire cache
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        return {
+            maxEntries: this.options.maxEntries,
+            size: this.cache.size,
+            ttlMs: this.options.ttlMs
+        };
+    }
+    /**
+     * Generate a cache key for an LSP request
+     */
+    static makeKey(method, filePath, ...extra) {
+        return [filePath, method, ...extra.map(String)].join(':');
+    }
+}
+//# sourceMappingURL=lsp-result-cache.js.map

package/dist/lsp/lsp-result-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-result-cache.js","sourceRoot":"","sources":["../../src/lsp/lsp-result-cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,6BAA6B;AAC7B,MAAM,eAAe,GAAoB;IACxC,UAAU,EAAE,GAAG;IACf,KAAK,EAAE,MAAM,CAAC,aAAa;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,cAAc;IACT,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;IAC/C,OAAO,CAAkB;IAE1C,YAAY,OAAkC;QAC7C,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,GAAG,CAAI,GAAW;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAExB,YAAY;QACZ,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACvD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACb,CAAC;QAED,mCAAmC;QACnC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAE3B,OAAO,KAAK,CAAC,KAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,GAAG,CAAI,GAAW,EAAE,KAAQ;QAC3B,8BAA8B;QAC9B,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YAChD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC9C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC3B,CAAC;QACF,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YACnB,GAAG;YACH,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,KAAK;SACL,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,QAAgB;QAC9B,KAAK,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC9B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC;QACF,CAAC;IACF,CAAC;IAED;;OAEG;IACH,KAAK;QACJ,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,QAAQ;QACP,OAAO;YACN,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;YACnC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YACrB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;SACzB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,MAAc,EAAE,QAAgB,EAAE,GAAG,KAA6B;QAChF,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC;CACD"}

package/dist/lsp/lsp-tools.service.d.ts

@@ -0,0 +1,68 @@
+/**
+ * LSP Tools Service
+ *
+ * LLM tool handlers for LSP operations:
+ * goto_definition, get_type_info, get_diagnostics, hover_info
+ */
+import type { getLogger } from '../output/logger.js';
+type Logger = ReturnType<typeof getLogger>;
+/**
+ * LSP Tools Service — handles LLM tool calls for LSP operations
+ */
+export declare class LSPToolsService {
+    private readonly cache;
+    private readonly projectRoot;
+    constructor(projectRoot?: string, _logger?: Logger);
+    /**
+     * Execute the goto_definition tool
+     */
+    executeGotoDefinition(args: Record<string, unknown>): Promise<string>;
+    /**
+     * Execute the get_type_info tool
+     */
+    executeGetTypeInfo(args: Record<string, unknown>): Promise<string>;
+    /**
+     * Execute the get_diagnostics tool
+     */
+    executeGetDiagnostics(args: Record<string, unknown>): Promise<string>;
+    /**
+     * Execute the hover_info tool
+     */
+    executeHoverInfo(args: Record<string, unknown>): Promise<string>;
+    /**
+     * Execute a hover request
+     */
+    private executeHover;
+    /**
+     * Resolve a position from either symbol name or line/character
+     */
+    private resolvePosition;
+    /**
+     * Read file content
+     */
+    private readFileContent;
+    /**
+     * Convert file path to URI
+     */
+    private toUri;
+    /**
+     * Get language ID for a file
+     */
+    private getLanguageId;
+    /**
+     * Parse a definition result from LSP
+     */
+    private parseDefinitionResult;
+    /**
+     * Format a definition result for display
+     */
+    private formatDefinitionResult;
+    /**
+     * Format diagnostics for display
+     */
+    private formatDiagnostics;
+}
+export declare function getLSPToolsService(projectRoot?: string): LSPToolsService;
+export declare function resetLSPToolsService(): void;
+export {};
+//# sourceMappingURL=lsp-tools.service.d.ts.map

package/dist/lsp/lsp-tools.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-tools.service.d.ts","sourceRoot":"","sources":["../../src/lsp/lsp-tools.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAO/C,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AA2B3C;;GAEG;AACH,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,WAAW,GAAE,MAAsB,EAAE,OAAO,CAAC,EAAE,MAAM;IAIjE;;OAEG;IACG,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IA8C3E;;OAEG;IACG,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAUxE;;OAEG;IACG,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAwC3E;;OAEG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAYtE;;OAEG;YACW,YAAY;IA0C1B;;OAEG;YACW,eAAe;IAuB7B;;OAEG;YACW,eAAe;IAS7B;;OAEG;IACH,OAAO,CAAC,KAAK;IAKb;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAI9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAmBzB;AAkBD,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,CAGxE;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}