@shawnowen/comet-mcp 2.3.1 → 2.4.2

package/dist/cdp-client.d.ts

@@ -1,3 +1,4 @@
+import CDP from "chrome-remote-interface";
 import type { CDPTarget, CDPVersion, NavigateResult, ScreenshotResult, EvaluateResult, CometState, NetworkIdleResult } from "./types.js";
 export declare class CometCDPClient {
     private client;
@@ -8,6 +9,12 @@ export declare class CometCDPClient {
     private maxReconnectAttempts;
     private isReconnecting;
     get isConnected(): boolean;
+    /**
+     * Access the raw CDP protocol client for direct domain calls
+     * (e.g., Page.printToPDF, Network.enable, Input.dispatchKeyEvent).
+     * Throws if not connected — always check isConnected or call connect() first.
+     */
+    get protocol(): CDP.Client;
     /**
      * Health check - verify connection is actually alive (not just "connected" in state)
      * This catches cases where WebSocket died silently
@@ -41,15 +48,26 @@ export declare class CometCDPClient {
      * Check if Comet process is running
      */
     private isCometProcessRunning;
-    /**
-     * Kill any running Comet process
-     */
-    private killComet;
+    private readCrashHistory;
+    private writeCrashHistory;
+    recordCrash(): void;
+    checkCrashLoopCap(): {
+        blocked: boolean;
+        count: number;
+        windowMinutes: number;
+    };
     /**
      * Start Comet browser with remote debugging enabled
      * Handles macOS, Windows, and WSL environments
      */
     startComet(port?: number): Promise<string>;
+    /**
+     * Position the Comet browser window on the top display using full-screen bounds.
+     * Top display staging bounds: origin (0, -1440), size 2560x1440.
+     * Keep the native window state normal so browser tabs and toolbar remain visible.
+     * Uses CDP Browser.getWindowForTarget + Browser.setWindowBounds.
+     */
+    positionOnTopDisplay(targetId?: string): Promise<void>;
     /**
      * Get CDP version info
      */
@@ -58,6 +76,9 @@ export declare class CometCDPClient {
      * List all available tabs/targets
      */
     listTargets(): Promise<CDPTarget[]>;
+    waitForTargetUrl(url: string, timeoutMs?: number): Promise<CDPTarget>;
+    private getWindowIdForTarget;
+    private findSidecarTargetForWindow;
     /**
      * Connect to a specific tab
      */
@@ -89,6 +110,21 @@ export declare class CometCDPClient {
      * Press a key
      */
     pressKey(key: string): Promise<void>;
+    /**
+     * Return the existing Perplexity sidecar CDP target without activating Comet
+     * or sending OS-level keyboard shortcuts.
+     */
+    ensureSidecarOpen(options?: {
+        windowId?: number;
+        targetId?: string;
+    }): Promise<CDPTarget | null>;
+    /**
+     * Connect a separate CDP client to the sidecar target for isolated interaction.
+     */
+    connectToSidecar(options?: {
+        windowId?: number;
+        targetId?: string;
+    }): Promise<CometCDPClient | null>;
     /**
      * Create a new tab
      */