@vybestack/llxprt-code-core 0.1.14 → 0.1.15

package/dist/src/ide/ide-client.js

@@ -3,12 +3,12 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { ideContext, OpenFilesNotificationSchema } from '../ide/ideContext.js';
+import { ideContext, IdeContextNotificationSchema } from '../ide/ideContext.js';
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
 const logger = {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    debug: (...args) => console.debug('[DEBUG] [ImportProcessor]', ...args),
+    debug: (...args) => console.debug('[DEBUG] [IDEClient]', ...args),
 };
 export var IDEConnectionStatus;
 (function (IDEConnectionStatus) {
@@ -21,59 +21,96 @@ export var IDEConnectionStatus;
  */
 export class IdeClient {
     client = undefined;
-    connectionStatus = IDEConnectionStatus.Disconnected;
+    state = {
+        status: IDEConnectionStatus.Disconnected,
+    };
     constructor() {
-        this.connectToMcpServer().catch((err) => {
+        this.init().catch((err) => {
             logger.debug('Failed to initialize IdeClient:', err);
         });
     }
     getConnectionStatus() {
-        let details;
-        if (this.connectionStatus === IDEConnectionStatus.Disconnected) {
-            if (!process.env['GEMINI_CLI_IDE_SERVER_PORT']) {
-                details = 'GEMINI_CLI_IDE_SERVER_PORT environment variable is not set.';
-            }
+        return this.state;
+    }
+    setState(status, details) {
+        this.state = { status, details };
+        if (status === IDEConnectionStatus.Disconnected) {
+            logger.debug('IDE integration is disconnected. ', details);
+            ideContext.clearIdeContext();
         }
-        return {
-            status: this.connectionStatus,
-            details,
-        };
     }
-    async connectToMcpServer() {
-        this.connectionStatus = IDEConnectionStatus.Connecting;
-        const idePort = process.env['GEMINI_CLI_IDE_SERVER_PORT'];
-        if (!idePort) {
-            logger.debug('Unable to connect to IDE mode MCP server. GEMINI_CLI_IDE_SERVER_PORT environment variable is not set.');
-            this.connectionStatus = IDEConnectionStatus.Disconnected;
+    getPortFromEnv() {
+        const port = process.env['LLXPRT_CODE_IDE_SERVER_PORT'];
+        if (!port) {
+            this.setState(IDEConnectionStatus.Disconnected, 'LLxprt Code Companion extension not found. Install via /ide install and restart the CLI in a fresh terminal window.');
+            return undefined;
+        }
+        return port;
+    }
+    validateWorkspacePath() {
+        const ideWorkspacePath = process.env['LLXPRT_CODE_IDE_WORKSPACE_PATH'];
+        if (!ideWorkspacePath) {
+            this.setState(IDEConnectionStatus.Disconnected, 'IDE integration requires a single workspace folder to be open in the IDE. Please ensure one folder is open and try again.');
+            return false;
+        }
+        if (ideWorkspacePath !== process.cwd()) {
+            this.setState(IDEConnectionStatus.Disconnected, `LLxprt Code is running in a different directory (${process.cwd()}) from the IDE's open workspace (${ideWorkspacePath}). Please run LLxprt Code in the same directory.`);
+            return false;
+        }
+        return true;
+    }
+    registerClientHandlers() {
+        if (!this.client) {
             return;
         }
+        this.client.setNotificationHandler(IdeContextNotificationSchema, (notification) => {
+            ideContext.setIdeContext(notification.params);
+        });
+        this.client.onerror = (_error) => {
+            this.setState(IDEConnectionStatus.Disconnected, 'Client error.');
+        };
+        this.client.onclose = () => {
+            this.setState(IDEConnectionStatus.Disconnected, 'Connection closed.');
+        };
+    }
+    async establishConnection(port) {
+        let transport;
         try {
             this.client = new Client({
                 name: 'streamable-http-client',
                 // TODO(#3487): use the CLI version here.
                 version: '1.0.0',
             });
-            const transport = new StreamableHTTPClientTransport(new URL(`http://localhost:${idePort}/mcp`));
+            transport = new StreamableHTTPClientTransport(new URL(`http://localhost:${port}/mcp`));
+            this.registerClientHandlers();
             await this.client.connect(transport);
-            this.client.setNotificationHandler(OpenFilesNotificationSchema, (notification) => {
-                ideContext.setOpenFilesContext(notification.params);
-            });
-            this.client.onerror = (error) => {
-                logger.debug('IDE MCP client error:', error);
-                this.connectionStatus = IDEConnectionStatus.Disconnected;
-                ideContext.clearOpenFilesContext();
-            };
-            this.client.onclose = () => {
-                logger.debug('IDE MCP client connection closed.');
-                this.connectionStatus = IDEConnectionStatus.Disconnected;
-                ideContext.clearOpenFilesContext();
-            };
-            this.connectionStatus = IDEConnectionStatus.Connected;
+            this.setState(IDEConnectionStatus.Connected);
         }
         catch (error) {
-            this.connectionStatus = IDEConnectionStatus.Disconnected;
-            logger.debug('Failed to connect to MCP server:', error);
+            this.setState(IDEConnectionStatus.Disconnected, `Failed to connect to IDE server: ${error}`);
+            if (transport) {
+                try {
+                    await transport.close();
+                }
+                catch (closeError) {
+                    logger.debug('Failed to close transport:', closeError);
+                }
+            }
+        }
+    }
+    async init() {
+        if (this.state.status === IDEConnectionStatus.Connected) {
+            return;
+        }
+        this.setState(IDEConnectionStatus.Connecting);
+        if (!this.validateWorkspacePath()) {
+            return;
+        }
+        const port = this.getPortFromEnv();
+        if (!port) {
+            return;
         }
+        await this.establishConnection(port);
     }
 }
 //# sourceMappingURL=ide-client.js.map

package/dist/src/ide/ide-client.js.map

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

package/dist/src/ide/ideContext.d.ts

@@ -5,24 +5,12 @@
  */
 import { z } from 'zod';
 /**
- * Zod schema for validating a cursor position.
+ * Zod schema for validating a file context from the IDE.
  */
-export declare const CursorSchema: z.ZodObject<{
-    line: z.ZodNumber;
-    character: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    line: number;
-    character: number;
-}, {
-    line: number;
-    character: number;
-}>;
-export type Cursor = z.infer<typeof CursorSchema>;
-/**
- * Zod schema for validating an active file context from the IDE.
- */
-export declare const OpenFilesSchema: z.ZodObject<{
-    activeFile: z.ZodString;
+export declare const FileSchema: z.ZodObject<{
+    path: z.ZodString;
+    timestamp: z.ZodNumber;
+    isActive: z.ZodOptional<z.ZodBoolean>;
     selectedText: z.ZodOptional<z.ZodString>;
     cursor: z.ZodOptional<z.ZodObject<{
         line: z.ZodNumber;
@@ -34,141 +22,258 @@ export declare const OpenFilesSchema: z.ZodObject<{
         line: number;
         character: number;
     }>>;
-    recentOpenFiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        filePath: z.ZodString;
-        timestamp: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        filePath: string;
-        timestamp: number;
-    }, {
-        filePath: string;
-        timestamp: number;
-    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
-    activeFile: string;
+    path: string;
+    timestamp: number;
     cursor?: {
         line: number;
         character: number;
     } | undefined;
+    isActive?: boolean | undefined;
     selectedText?: string | undefined;
-    recentOpenFiles?: {
-        filePath: string;
-        timestamp: number;
-    }[] | undefined;
 }, {
-    activeFile: string;
+    path: string;
+    timestamp: number;
     cursor?: {
         line: number;
         character: number;
     } | undefined;
+    isActive?: boolean | undefined;
     selectedText?: string | undefined;
-    recentOpenFiles?: {
-        filePath: string;
-        timestamp: number;
-    }[] | undefined;
 }>;
-export type OpenFiles = z.infer<typeof OpenFilesSchema>;
-/**
- * Zod schema for validating the 'ide/openFilesChanged' notification from the IDE.
- */
-export declare const OpenFilesNotificationSchema: z.ZodObject<{
-    method: z.ZodLiteral<"ide/openFilesChanged">;
-    params: z.ZodObject<{
-        activeFile: z.ZodString;
-        selectedText: z.ZodOptional<z.ZodString>;
-        cursor: z.ZodOptional<z.ZodObject<{
-            line: z.ZodNumber;
-            character: z.ZodNumber;
-        }, "strip", z.ZodTypeAny, {
-            line: number;
-            character: number;
-        }, {
-            line: number;
-            character: number;
-        }>>;
-        recentOpenFiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            filePath: z.ZodString;
+export type File = z.infer<typeof FileSchema>;
+export declare const IdeContextSchema: z.ZodObject<{
+    workspaceState: z.ZodOptional<z.ZodObject<{
+        openFiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
             timestamp: z.ZodNumber;
+            isActive: z.ZodOptional<z.ZodBoolean>;
+            selectedText: z.ZodOptional<z.ZodString>;
+            cursor: z.ZodOptional<z.ZodObject<{
+                line: z.ZodNumber;
+                character: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                line: number;
+                character: number;
+            }, {
+                line: number;
+                character: number;
+            }>>;
         }, "strip", z.ZodTypeAny, {
-            filePath: string;
+            path: string;
             timestamp: number;
+            cursor?: {
+                line: number;
+                character: number;
+            } | undefined;
+            isActive?: boolean | undefined;
+            selectedText?: string | undefined;
         }, {
-            filePath: string;
+            path: string;
             timestamp: number;
+            cursor?: {
+                line: number;
+                character: number;
+            } | undefined;
+            isActive?: boolean | undefined;
+            selectedText?: string | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
-        activeFile: string;
-        cursor?: {
-            line: number;
-            character: number;
-        } | undefined;
-        selectedText?: string | undefined;
-        recentOpenFiles?: {
-            filePath: string;
+        openFiles?: {
+            path: string;
             timestamp: number;
+            cursor?: {
+                line: number;
+                character: number;
+            } | undefined;
+            isActive?: boolean | undefined;
+            selectedText?: string | undefined;
         }[] | undefined;
     }, {
-        activeFile: string;
-        cursor?: {
-            line: number;
-            character: number;
-        } | undefined;
-        selectedText?: string | undefined;
-        recentOpenFiles?: {
-            filePath: string;
+        openFiles?: {
+            path: string;
             timestamp: number;
+            cursor?: {
+                line: number;
+                character: number;
+            } | undefined;
+            isActive?: boolean | undefined;
+            selectedText?: string | undefined;
         }[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    workspaceState?: {
+        openFiles?: {
+            path: string;
+            timestamp: number;
+            cursor?: {
+                line: number;
+                character: number;
+            } | undefined;
+            isActive?: boolean | undefined;
+            selectedText?: string | undefined;
+        }[] | undefined;
+    } | undefined;
+}, {
+    workspaceState?: {
+        openFiles?: {
+            path: string;
+            timestamp: number;
+            cursor?: {
+                line: number;
+                character: number;
+            } | undefined;
+            isActive?: boolean | undefined;
+            selectedText?: string | undefined;
+        }[] | undefined;
+    } | undefined;
+}>;
+export type IdeContext = z.infer<typeof IdeContextSchema>;
+/**
+ * Zod schema for validating the 'ide/contextUpdate' notification from the IDE.
+ */
+export declare const IdeContextNotificationSchema: z.ZodObject<{
+    method: z.ZodLiteral<"ide/contextUpdate">;
+    params: z.ZodObject<{
+        workspaceState: z.ZodOptional<z.ZodObject<{
+            openFiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                timestamp: z.ZodNumber;
+                isActive: z.ZodOptional<z.ZodBoolean>;
+                selectedText: z.ZodOptional<z.ZodString>;
+                cursor: z.ZodOptional<z.ZodObject<{
+                    line: z.ZodNumber;
+                    character: z.ZodNumber;
+                }, "strip", z.ZodTypeAny, {
+                    line: number;
+                    character: number;
+                }, {
+                    line: number;
+                    character: number;
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                path: string;
+                timestamp: number;
+                cursor?: {
+                    line: number;
+                    character: number;
+                } | undefined;
+                isActive?: boolean | undefined;
+                selectedText?: string | undefined;
+            }, {
+                path: string;
+                timestamp: number;
+                cursor?: {
+                    line: number;
+                    character: number;
+                } | undefined;
+                isActive?: boolean | undefined;
+                selectedText?: string | undefined;
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            openFiles?: {
+                path: string;
+                timestamp: number;
+                cursor?: {
+                    line: number;
+                    character: number;
+                } | undefined;
+                isActive?: boolean | undefined;
+                selectedText?: string | undefined;
+            }[] | undefined;
+        }, {
+            openFiles?: {
+                path: string;
+                timestamp: number;
+                cursor?: {
+                    line: number;
+                    character: number;
+                } | undefined;
+                isActive?: boolean | undefined;
+                selectedText?: string | undefined;
+            }[] | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        workspaceState?: {
+            openFiles?: {
+                path: string;
+                timestamp: number;
+                cursor?: {
+                    line: number;
+                    character: number;
+                } | undefined;
+                isActive?: boolean | undefined;
+                selectedText?: string | undefined;
+            }[] | undefined;
+        } | undefined;
+    }, {
+        workspaceState?: {
+            openFiles?: {
+                path: string;
+                timestamp: number;
+                cursor?: {
+                    line: number;
+                    character: number;
+                } | undefined;
+                isActive?: boolean | undefined;
+                selectedText?: string | undefined;
+            }[] | undefined;
+        } | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
-    method: "ide/openFilesChanged";
+    method: "ide/contextUpdate";
     params: {
-        activeFile: string;
-        cursor?: {
-            line: number;
-            character: number;
+        workspaceState?: {
+            openFiles?: {
+                path: string;
+                timestamp: number;
+                cursor?: {
+                    line: number;
+                    character: number;
+                } | undefined;
+                isActive?: boolean | undefined;
+                selectedText?: string | undefined;
+            }[] | undefined;
         } | undefined;
-        selectedText?: string | undefined;
-        recentOpenFiles?: {
-            filePath: string;
-            timestamp: number;
-        }[] | undefined;
     };
 }, {
-    method: "ide/openFilesChanged";
+    method: "ide/contextUpdate";
     params: {
-        activeFile: string;
-        cursor?: {
-            line: number;
-            character: number;
+        workspaceState?: {
+            openFiles?: {
+                path: string;
+                timestamp: number;
+                cursor?: {
+                    line: number;
+                    character: number;
+                } | undefined;
+                isActive?: boolean | undefined;
+                selectedText?: string | undefined;
+            }[] | undefined;
         } | undefined;
-        selectedText?: string | undefined;
-        recentOpenFiles?: {
-            filePath: string;
-            timestamp: number;
-        }[] | undefined;
     };
 }>;
-type OpenFilesSubscriber = (openFiles: OpenFiles | undefined) => void;
+type IdeContextSubscriber = (ideContext: IdeContext | undefined) => void;
 /**
- * Creates a new store for managing the IDE's active file context.
+ * Creates a new store for managing the IDE's context.
  * This factory function encapsulates the state and logic, allowing for the creation
  * of isolated instances, which is particularly useful for testing.
  *
- * @returns An object with methods to interact with the active file context.
+ * @returns An object with methods to interact with the IDE context.
  */
 export declare function createIdeContextStore(): {
-    setOpenFilesContext: (newOpenFiles: OpenFiles) => void;
-    getOpenFilesContext: () => OpenFiles | undefined;
-    subscribeToOpenFiles: (subscriber: OpenFilesSubscriber) => () => void;
-    clearOpenFilesContext: () => void;
+    setIdeContext: (newIdeContext: IdeContext) => void;
+    getIdeContext: () => IdeContext | undefined;
+    subscribeToIdeContext: (subscriber: IdeContextSubscriber) => () => void;
+    clearIdeContext: () => void;
 };
 /**
  * The default, shared instance of the IDE context store for the application.
  */
 export declare const ideContext: {
-    setOpenFilesContext: (newOpenFiles: OpenFiles) => void;
-    getOpenFilesContext: () => OpenFiles | undefined;
-    subscribeToOpenFiles: (subscriber: OpenFilesSubscriber) => () => void;
-    clearOpenFilesContext: () => void;
+    setIdeContext: (newIdeContext: IdeContext) => void;
+    getIdeContext: () => IdeContext | undefined;
+    subscribeToIdeContext: (subscriber: IdeContextSubscriber) => () => void;
+    clearIdeContext: () => void;
 };
 export {};