remoat 0.2.0

package/dist/services/cdpConnectionPool.js

@@ -0,0 +1,235 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CdpConnectionPool = void 0;
+const logger_1 = require("../utils/logger");
+const pathUtils_1 = require("../utils/pathUtils");
+const cdpService_1 = require("./cdpService");
+/**
+ * Pool that manages independent CdpService instances per workspace.
+ *
+ * Each workspace owns its own WebSocket / contexts / pendingCalls, so
+ * switching to workspace B while workspace A's ResponseMonitor is polling
+ * does not destroy A's WebSocket.
+ */
+class CdpConnectionPool {
+    connections = new Map();
+    approvalDetectors = new Map();
+    errorPopupDetectors = new Map();
+    planningDetectors = new Map();
+    userMessageDetectors = new Map();
+    connectingPromises = new Map();
+    cdpOptions;
+    constructor(cdpOptions = {}) {
+        this.cdpOptions = cdpOptions;
+    }
+    /**
+     * Get a CdpService for the given workspace path.
+     * Creates a new connection and caches it if not already connected.
+     * Prevents concurrent connections via Promise locking.
+     *
+     * @param workspacePath Full path of the workspace
+     * @returns Connected CdpService
+     */
+    async getOrConnect(workspacePath) {
+        const projectName = this.extractProjectName(workspacePath);
+        // Return existing connection if available
+        const existing = this.connections.get(projectName);
+        if (existing) {
+            if (existing.isConnected()) {
+                try {
+                    // Re-validate that the still-open window is actually bound to this workspace.
+                    await existing.discoverAndConnectForWorkspace(workspacePath);
+                    return existing;
+                }
+                catch {
+                    // Connection dropped during re-validation; close WebSocket and clean up
+                    existing.disconnect().catch(() => { });
+                    this.connections.delete(projectName);
+                }
+            }
+            else {
+                // Stale disconnected entry (e.g. reconnect was disabled) — clean up
+                this.connections.delete(projectName);
+            }
+        }
+        // Wait for the pending connection promise if one exists (prevents concurrent connections)
+        const pending = this.connectingPromises.get(projectName);
+        if (pending) {
+            return pending;
+        }
+        // Start a new connection
+        const connectPromise = this.createAndConnect(workspacePath, projectName);
+        this.connectingPromises.set(projectName, connectPromise);
+        try {
+            const cdp = await connectPromise;
+            return cdp;
+        }
+        finally {
+            this.connectingPromises.delete(projectName);
+        }
+    }
+    /**
+     * Get a connected CdpService (read-only).
+     * Returns null if not connected.
+     */
+    getConnected(projectName) {
+        const cdp = this.connections.get(projectName);
+        if (cdp && cdp.isConnected()) {
+            return cdp;
+        }
+        return null;
+    }
+    /**
+     * Disconnect the specified workspace.
+     */
+    disconnectWorkspace(projectName) {
+        const cdp = this.connections.get(projectName);
+        if (cdp) {
+            cdp.disconnect().catch((err) => {
+                logger_1.logger.error(`[CdpConnectionPool] Error while disconnecting ${projectName}:`, err);
+            });
+            this.connections.delete(projectName);
+        }
+        const detector = this.approvalDetectors.get(projectName);
+        if (detector) {
+            detector.stop();
+            this.approvalDetectors.delete(projectName);
+        }
+        const errorPopupDetector = this.errorPopupDetectors.get(projectName);
+        if (errorPopupDetector) {
+            errorPopupDetector.stop();
+            this.errorPopupDetectors.delete(projectName);
+        }
+        const planningDetector = this.planningDetectors.get(projectName);
+        if (planningDetector) {
+            planningDetector.stop();
+            this.planningDetectors.delete(projectName);
+        }
+        const userMsgDetector = this.userMessageDetectors.get(projectName);
+        if (userMsgDetector) {
+            userMsgDetector.stop();
+            this.userMessageDetectors.delete(projectName);
+        }
+    }
+    /**
+     * Disconnect all workspace connections.
+     */
+    disconnectAll() {
+        for (const projectName of [...this.connections.keys()]) {
+            this.disconnectWorkspace(projectName);
+        }
+    }
+    /**
+     * Register an approval detector for a workspace.
+     */
+    registerApprovalDetector(projectName, detector) {
+        // Stop existing detector
+        const existing = this.approvalDetectors.get(projectName);
+        if (existing && existing.isActive()) {
+            existing.stop();
+        }
+        this.approvalDetectors.set(projectName, detector);
+    }
+    /**
+     * Get the approval detector for a workspace.
+     */
+    getApprovalDetector(projectName) {
+        return this.approvalDetectors.get(projectName);
+    }
+    /**
+     * Register an error popup detector for a workspace.
+     */
+    registerErrorPopupDetector(projectName, detector) {
+        // Stop existing detector
+        const existing = this.errorPopupDetectors.get(projectName);
+        if (existing && existing.isActive()) {
+            existing.stop();
+        }
+        this.errorPopupDetectors.set(projectName, detector);
+    }
+    /**
+     * Get the error popup detector for a workspace.
+     */
+    getErrorPopupDetector(projectName) {
+        return this.errorPopupDetectors.get(projectName);
+    }
+    /**
+     * Register a planning detector for a workspace.
+     */
+    registerPlanningDetector(projectName, detector) {
+        // Stop existing detector
+        const existing = this.planningDetectors.get(projectName);
+        if (existing && existing.isActive()) {
+            existing.stop();
+        }
+        this.planningDetectors.set(projectName, detector);
+    }
+    /**
+     * Get the planning detector for a workspace.
+     */
+    getPlanningDetector(projectName) {
+        return this.planningDetectors.get(projectName);
+    }
+    /**
+     * Register a user message detector for a workspace.
+     */
+    registerUserMessageDetector(projectName, detector) {
+        const existing = this.userMessageDetectors.get(projectName);
+        if (existing && existing.isActive()) {
+            existing.stop();
+        }
+        this.userMessageDetectors.set(projectName, detector);
+    }
+    /**
+     * Get the user message detector for a workspace.
+     */
+    getUserMessageDetector(projectName) {
+        return this.userMessageDetectors.get(projectName);
+    }
+    /**
+     * Return a list of workspace names with active connections.
+     */
+    getActiveWorkspaceNames() {
+        const active = [];
+        for (const [name, cdp] of this.connections) {
+            if (cdp.isConnected()) {
+                active.push(name);
+            }
+        }
+        return active;
+    }
+    /**
+     * Extract the project name from a workspace path.
+     */
+    extractProjectName(workspacePath) {
+        return (0, pathUtils_1.extractProjectNameFromPath)(workspacePath) || workspacePath;
+    }
+    /**
+     * Create a new CdpService and connect to the workspace.
+     */
+    async createAndConnect(workspacePath, projectName) {
+        // Disconnect old connection if exists
+        const old = this.connections.get(projectName);
+        if (old) {
+            await old.disconnect().catch(() => { });
+            this.connections.delete(projectName);
+        }
+        const cdp = new cdpService_1.CdpService(this.cdpOptions);
+        // Auto-cleanup on disconnect
+        cdp.on('disconnected', () => {
+            logger_1.logger.error(`[CdpConnectionPool] Workspace "${projectName}" disconnected`);
+            // Only remove from Map when reconnection fails
+            // (CdpService attempts reconnection internally, so we don't remove here)
+        });
+        cdp.on('reconnectFailed', () => {
+            logger_1.logger.error(`[CdpConnectionPool] Reconnection failed for workspace "${projectName}". Removing from pool`);
+            this.disconnectWorkspace(projectName);
+        });
+        // Connect to the workspace
+        await cdp.discoverAndConnectForWorkspace(workspacePath);
+        this.connections.set(projectName, cdp);
+        return cdp;
+    }
+}
+exports.CdpConnectionPool = CdpConnectionPool;
+//# sourceMappingURL=cdpConnectionPool.js.map

package/dist/services/cdpConnectionPool.js.map

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

package/dist/services/cdpService.d.ts

@@ -0,0 +1,214 @@
+import { EventEmitter } from 'events';
+export interface CdpServiceOptions {
+    portsToScan?: number[];
+    cdpCallTimeout?: number;
+    /** Number of auto-reconnect attempts on disconnect. 0 = no reconnect. Default: 3 */
+    maxReconnectAttempts?: number;
+    /** Delay between reconnect attempts (ms). Default: 2000 */
+    reconnectDelayMs?: number;
+}
+export interface CdpContext {
+    id: number;
+    name: string;
+    url: string;
+}
+export interface InjectResult {
+    ok: boolean;
+    method?: string;
+    contextId?: number;
+    error?: string;
+}
+export interface ExtractedResponseImage {
+    name: string;
+    mimeType: string;
+    base64Data?: string;
+    url?: string;
+}
+/** UI sync operation result type (Step 9) */
+export interface UiSyncResult {
+    ok: boolean;
+    /** Mode name set (on setUiMode success) */
+    mode?: string;
+    /** Model name set (on setUiModel success) */
+    model?: string;
+    error?: string;
+}
+export declare class CdpService extends EventEmitter {
+    private ports;
+    private isConnectedFlag;
+    private ws;
+    private contexts;
+    private pendingCalls;
+    private idCounter;
+    private cdpCallTimeout;
+    private targetUrl;
+    /** Number of auto-reconnect attempts on disconnect */
+    private maxReconnectAttempts;
+    /** Delay between reconnect attempts (ms) */
+    private reconnectDelayMs;
+    /** Current reconnect attempt count */
+    private reconnectAttemptCount;
+    /** Reconnecting flag (prevents double connections) */
+    private isReconnecting;
+    /** Currently connected workspace name */
+    private currentWorkspaceName;
+    /** Last requested workspace path (used for deterministic reconnect) */
+    private currentWorkspacePath;
+    /** Workspace switching flag (suppresses disconnected event) */
+    private isSwitchingWorkspace;
+    constructor(options?: CdpServiceOptions);
+    private getJson;
+    discoverTarget(): Promise<string>;
+    connect(): Promise<void>;
+    call(method: string, params?: any): Promise<any>;
+    disconnect(): Promise<void>;
+    /**
+     * Return the currently connected workspace name.
+     */
+    getCurrentWorkspaceName(): string | null;
+    /**
+     * Discover and connect to the workbench page for the specified workspace.
+     * Does nothing if already connected to the correct page.
+     *
+     * @param workspacePath Full workspace path (e.g., /home/user/Code/MyProject)
+     * @returns true on successful connection
+     */
+    discoverAndConnectForWorkspace(workspacePath: string): Promise<boolean>;
+    /**
+     * Verify whether the currently attached page still represents the expected workspace.
+     */
+    private verifyCurrentWorkspace;
+    private _discoverAndConnectForWorkspaceImpl;
+    /**
+     * Connect to the specified page (skip if already connected).
+     */
+    private connectToPage;
+    /**
+     * Connect to each workbench page via CDP to get document.title and detect workspace name.
+     * Fallback when /json/list titles are stale or incomplete.
+     *
+     * If the title is "Untitled (Workspace)", verify workspace folder path via CDP.
+     *
+     * @param workbenchPages List of workbench pages
+     * @param projectName Workspace directory name
+     * @param workspacePath Full workspace path (for folder path matching)
+     */
+    private probeWorkbenchPages;
+    /**
+     * Check if the currently connected page has the specified workspace folder open.
+     * In Antigravity (VS Code-based), info may be available from explorer views or APIs.
+     *
+     * Detects folder path via multiple approaches:
+     * 1. Check vscode.workspace.workspaceFolders via VS Code API
+     * 2. Check folder path display in DOM
+     * 3. Get workspace info from window.location.hash, etc.
+     */
+    private probeWorkspaceFolderPath;
+    /**
+     * Launch Antigravity and wait for a new workbench page to appear, then connect.
+     */
+    private launchAndConnectWorkspace;
+    private runCommand;
+    /**
+     * Quietly disconnect the existing connection (no reconnect attempts).
+     * Used during workspace switching.
+     *
+     * Important: ws.close() fires close event asynchronously, so all listeners
+     * must be removed first to prevent targetUrl reset and tryReconnect()
+     * from reconnecting to a different workbench.
+     */
+    private disconnectQuietly;
+    /**
+     * Reject all unresolved pending calls to prevent memory leaks.
+     * (Step 12: Error handling)
+     * @param error Error to pass to reject
+     */
+    private clearPendingCalls;
+    /**
+     * Attempt auto-reconnect after CDP disconnection.
+     * Fires 'reconnectFailed' event after maxReconnectAttempts failures.
+     * (Step 12: Error handling and timeout management)
+     */
+    private tryReconnect;
+    isConnected(): boolean;
+    getContexts(): CdpContext[];
+    /**
+     * Wait by polling until cascade-panel context becomes available.
+     * Right after Antigravity launch, contexts are created asynchronously even after Runtime.enable,
+     * so use this method to confirm readiness before DOM operations.
+     *
+     * @param timeoutMs Maximum wait time (ms). Default: 10000
+     * @param pollIntervalMs Polling interval (ms). Default: 500
+     * @returns true if cascade-panel context was found
+     */
+    waitForCascadePanelReady(timeoutMs?: number, pollIntervalMs?: number): Promise<boolean>;
+    getPrimaryContextId(): number | null;
+    /**
+     * Focus the chat input field.
+     */
+    private focusChatInput;
+    /**
+     * Select all text in the focused input and delete it to ensure a clean state.
+     * Uses Meta+A (select all) then Backspace (delete) via CDP key events.
+     */
+    private clearInputField;
+    /**
+     * Send Enter key to submit the message.
+     */
+    private pressEnterToSend;
+    /**
+     * Detect file input in the UI and attach the specified files.
+     */
+    private attachImageFiles;
+    /**
+     * Inject and send the specified text into Antigravity's chat input field.
+     *
+     * Strategy:
+     *   1. Focus editor via Runtime.evaluate
+     *   2. Input text via CDP Input.insertText
+     *   3. Send via CDP Input.dispatchKeyEvent(Enter)
+     *
+     * Using CDP Input API instead of DOM manipulation ensures reliable
+     * delivery to Cascade panel's React/framework event handlers.
+     */
+    injectMessage(text: string): Promise<InjectResult>;
+    /**
+     * Attach image files to the UI and send the specified text.
+     */
+    injectMessageWithImageFiles(text: string, imageFilePaths: string[]): Promise<InjectResult>;
+    /**
+     * Extract images from the latest AI response.
+     */
+    extractLatestResponseImages(maxImages?: number): Promise<ExtractedResponseImage[]>;
+    /**
+     * Get the currently selected mode from the Antigravity UI.
+     * Reads the mode toggle button text and maps it back to internal mode name.
+     *
+     * @returns Internal mode name (e.g., 'fast', 'plan') or null if not found
+     */
+    getCurrentMode(): Promise<string | null>;
+    /**
+     * Operate Antigravity UI mode dropdown to switch to the specified mode.
+     * Two-step approach:
+     *   Step 1: Click mode toggle button ("Fast"/"Plan" + chevron icon) to open dropdown
+     *   Step 2: Select the target mode option from dropdown
+     *
+     * @param modeName Mode name to set (e.g., 'fast', 'plan')
+     */
+    setUiMode(modeName: string): Promise<UiSyncResult>;
+    /**
+     * Dynamically retrieve the list of available models from the Antigravity UI.
+     */
+    getUiModels(): Promise<string[]>;
+    /**
+     * Get the currently selected model from the Antigravity UI.
+     */
+    getCurrentModel(): Promise<string | null>;
+    /**
+     * Operate Antigravity UI model dropdown to switch to the specified model.
+     * (Step 9: Model/mode switching UI sync)
+     *
+     * @param modelName Model name to set (e.g., 'gpt-4o', 'claude-3-opus')
+     */
+    setUiModel(modelName: string): Promise<UiSyncResult>;
+}