chrome-cdp-cli 2.0.4 → 2.1.0

package/dist/cli/CommandRouter.js

@@ -30,8 +30,10 @@ class CommandRouter {
             if (!this.client) {
                 return {
                     success: false,
-                    error: 'Not connected to Chrome. Use "connect" command first.',
-                    exitCode: ExitCode.CONNECTION_ERROR
+                    error: "Not connected to Chrome.\n" +
+                        "Launch Chrome with: google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-debug\n" +
+                        "From Chrome 136, --user-data-dir is required. See: https://developer.chrome.com/blog/remote-debugging-port",
+                    exitCode: ExitCode.CONNECTION_ERROR,
                 };
             }
             const handler = this.registry.get(command.name);
@@ -39,14 +41,14 @@ class CommandRouter {
                 return {
                     success: false,
                     error: `Unknown command: ${command.name}. Use "help" to see available commands.`,
-                    exitCode: ExitCode.INVALID_COMMAND
+                    exitCode: ExitCode.INVALID_COMMAND,
                 };
             }
             if (handler.validateArgs && !handler.validateArgs(command.args)) {
                 return {
                     success: false,
                     error: `Invalid arguments for command "${command.name}". Use "help ${command.name}" for usage information.`,
-                    exitCode: ExitCode.VALIDATION_ERROR
+                    exitCode: ExitCode.VALIDATION_ERROR,
                 };
             }
             if (command.config.verbose) {
@@ -66,36 +68,36 @@ class CommandRouter {
             return {
                 success: false,
                 error: errorMessage,
-                exitCode: this.getExitCodeForError(error)
+                exitCode: this.getExitCodeForError(error),
             };
         }
     }
     isSpecialCommand(commandName) {
         const specialCommands = [
-            'help',
-            'connect',
-            'disconnect',
-            'install_cursor_command',
-            'install_claude_skill'
+            "help",
+            "connect",
+            "disconnect",
+            "install_cursor_command",
+            "install_claude_skill",
         ];
         return specialCommands.includes(commandName);
     }
     async executeSpecialCommand(command) {
         switch (command.name) {
-            case 'help':
+            case "help":
                 return this.executeHelpCommand(command);
-            case 'connect':
+            case "connect":
                 return this.executeConnectCommand(command);
-            case 'disconnect':
+            case "disconnect":
                 return this.executeDisconnectCommand();
-            case 'install_cursor_command':
-            case 'install_claude_skill': {
+            case "install_cursor_command":
+            case "install_claude_skill": {
                 const handler = this.registry.get(command.name);
                 if (!handler) {
                     return {
                         success: false,
                         error: `Handler not found for command: ${command.name}`,
-                        exitCode: ExitCode.INVALID_COMMAND
+                        exitCode: ExitCode.INVALID_COMMAND,
                     };
                 }
                 return await handler.execute(null, command.args);
@@ -104,26 +106,28 @@ class CommandRouter {
                 return {
                     success: false,
                     error: `Unknown special command: ${command.name}`,
-                    exitCode: ExitCode.INVALID_COMMAND
+                    exitCode: ExitCode.INVALID_COMMAND,
                 };
         }
     }
     executeHelpCommand(command) {
         const commandName = command.args.command;
         if (commandName) {
-            const normalizedCommandName = commandName.replace(/-/g, '_');
+            const normalizedCommandName = commandName.replace(/-/g, "_");
             const handler = this.registry.get(normalizedCommandName);
             if (!handler) {
                 return {
                     success: false,
                     error: `Unknown command: ${commandName}`,
-                    exitCode: ExitCode.INVALID_COMMAND
+                    exitCode: ExitCode.INVALID_COMMAND,
                 };
             }
-            const helpText = handler.getHelp ? handler.getHelp() : `No help available for command: ${commandName}`;
+            const helpText = handler.getHelp
+                ? handler.getHelp()
+                : `No help available for command: ${commandName}`;
             return {
                 success: true,
-                data: helpText
+                data: helpText,
             };
         }
         else {
@@ -131,7 +135,7 @@ class CommandRouter {
             const helpText = this.generateGeneralHelp(commands);
             return {
                 success: true,
-                data: helpText
+                data: helpText,
             };
         }
     }
@@ -139,14 +143,14 @@ class CommandRouter {
         try {
             return {
                 success: true,
-                data: `Connected to Chrome at ${command.config.host}:${command.config.port}`
+                data: `Connected to Chrome at ${command.config.host}:${command.config.port}`,
             };
         }
         catch (error) {
             return {
                 success: false,
                 error: `Failed to connect: ${error instanceof Error ? error.message : String(error)}`,
-                exitCode: ExitCode.CONNECTION_ERROR
+                exitCode: ExitCode.CONNECTION_ERROR,
             };
         }
     }
@@ -158,14 +162,14 @@ class CommandRouter {
             }
             return {
                 success: true,
-                data: 'Disconnected from Chrome'
+                data: "Disconnected from Chrome",
             };
         }
         catch (error) {
             return {
                 success: false,
                 error: `Failed to disconnect: ${error instanceof Error ? error.message : String(error)}`,
-                exitCode: ExitCode.CONNECTION_ERROR
+                exitCode: ExitCode.CONNECTION_ERROR,
             };
         }
     }
@@ -178,22 +182,41 @@ class CommandRouter {
             this.logger.setLevel(2);
         }
         this.logger.debug(`CommandRouter.executeWithTimeout called for command: ${command.name}, timeout: ${timeout}ms`);
+        this.logger.debug(`Starting handler execution for: ${command.name}`);
+        const executionPromise = handler.execute(this.client, command.args);
+        const longRunningCommands = ["log", "console", "network"];
+        const isLongRunning = longRunningCommands.includes(command.name) ||
+            command.args?.follow ||
+            command.args?.f;
+        if (isLongRunning) {
+            this.logger.debug(`Command ${command.name} is long-running, skipping timeout`);
+            try {
+                const result = await executionPromise;
+                if (result?.isLongRunning) {
+                    return new Promise(() => {
+                    });
+                }
+                return result;
+            }
+            catch (error) {
+                this.logger.debug(`Command execution error for: ${command.name}:`, error);
+                throw error;
+            }
+        }
         const timeoutPromise = new Promise((_, reject) => {
             setTimeout(() => {
                 this.logger.debug(`Command timeout reached for: ${command.name} after ${timeout}ms`);
                 reject(new Error(`Command timeout after ${timeout}ms`));
             }, timeout);
         });
-        this.logger.debug(`Starting handler execution for: ${command.name}`);
-        const executionPromise = handler.execute(this.client, command.args);
         try {
             const result = await Promise.race([executionPromise, timeoutPromise]);
             this.logger.debug(`Command completed successfully for: ${command.name}`);
-            if (!result || typeof result !== 'object') {
+            if (!result || typeof result !== "object") {
                 return {
                     success: false,
-                    error: 'Invalid command result format',
-                    exitCode: ExitCode.GENERAL_ERROR
+                    error: "Invalid command result format",
+                    exitCode: ExitCode.GENERAL_ERROR,
                 };
             }
             if (result.success && !result.exitCode) {
@@ -203,11 +226,11 @@ class CommandRouter {
         }
         catch (error) {
             this.logger.debug(`Command execution error for: ${command.name}:`, error);
-            if (error instanceof Error && error.message.includes('timeout')) {
+            if (error instanceof Error && error.message.includes("timeout")) {
                 return {
                     success: false,
                     error: error.message,
-                    exitCode: ExitCode.TIMEOUT_ERROR
+                    exitCode: ExitCode.TIMEOUT_ERROR,
                 };
             }
             throw error;
@@ -215,9 +238,9 @@ class CommandRouter {
     }
     generateGeneralHelp(commands) {
         return `
-Chrome DevTools CLI - Command-line tool for controlling Chrome browser
+CDP - Chrome DevTools Protocol CLI
 
-Usage: chrome-cdp-cli [options] <command> [command-options]
+Usage: cdp [options] <command> [command-options]
 
 Global Options:
   -h, --host <host>        Chrome host address (default: localhost)
@@ -231,64 +254,65 @@ Global Options:
   -V, --version            Show version number
 
 Available Commands:
-${commands.map(cmd => `  ${cmd.padEnd(20)} - ${this.getCommandDescription(cmd)}`).join('\n')}
+${commands.map((cmd) => `  ${cmd.padEnd(20)} - ${this.getCommandDescription(cmd)}`).join("\n")}
 
 Examples:
-  chrome-cdp-cli eval "document.title"
-  chrome-cdp-cli eval --file script.js
-  chrome-cdp-cli screenshot --filename page.png
-  chrome-cdp-cli snapshot --format html --filename dom.html
-  chrome-cdp-cli help <command>
+  cdp eval "document.title"
+  cdp eval --file script.js
+  cdp screenshot --filename page.png
+  cdp snapshot --filename dom.html
+  cdp log -f
+  cdp network --urlPattern "/api"
+  cdp help <command>
 
 For more information about a specific command, use:
-  chrome-cdp-cli help <command>
+  cdp help <command>
 `;
     }
     getCommandDescription(commandName) {
         const descriptions = {
-            'connect': 'Connect to Chrome instance',
-            'disconnect': 'Disconnect from Chrome instance',
-            'navigate': 'Navigate to URL',
-            'new-page': 'Create new page/tab',
-            'close-page': 'Close current or specified page',
-            'list-pages': 'List all open pages',
-            'select-page': 'Select/focus page',
-            'resize-page': 'Resize browser viewport',
-            'eval': 'Execute JavaScript code',
-            'click': 'Click element',
-            'fill': 'Fill form field',
-            'fill_form': 'Fill multiple form fields in batch',
-            'hover': 'Hover over element',
-            'drag': 'Perform drag and drop operations',
-            'press_key': 'Simulate keyboard input with modifiers',
-            'upload_file': 'Upload files to file input elements',
-            'wait_for': 'Wait for elements to appear or meet conditions',
-            'handle_dialog': 'Handle browser dialogs (alert, confirm, prompt)',
-            'screenshot': 'Capture page screenshot',
-            'snapshot': 'Capture DOM snapshot with structure and styles',
-            'console-messages': 'Get console messages',
-            'network-requests': 'Get network requests',
-            'console': 'List console messages',
-            'network': 'List network requests',
-            'install_cursor_command': 'Install Cursor IDE commands for Chrome automation',
-            'install_claude_skill': 'Install Claude Code skill for Chrome automation',
-            'help': 'Show help information'
+            connect: "Connect to Chrome instance",
+            disconnect: "Disconnect from Chrome instance",
+            navigate: "Navigate to URL",
+            "new-page": "Create new page/tab",
+            "close-page": "Close current or specified page",
+            "list-pages": "List all open pages",
+            "select-page": "Select/focus page",
+            "resize-page": "Resize browser viewport",
+            eval: "Execute JavaScript code",
+            click: "Click element",
+            fill: "Fill form field",
+            fill_form: "Fill multiple form fields in batch",
+            hover: "Hover over element",
+            drag: "Perform drag and drop operations",
+            press_key: "Simulate keyboard input with modifiers",
+            upload_file: "Upload files to file input elements",
+            wait_for: "Wait for elements to appear or meet conditions",
+            handle_dialog: "Handle browser dialogs (alert, confirm, prompt)",
+            screenshot: "Capture page screenshot",
+            snapshot: "Capture DOM snapshot with structure and styles",
+            log: "Follow console messages in real-time",
+            console: "Follow console messages (alias for log)",
+            network: "Follow network requests in real-time",
+            install_cursor_command: "Install Cursor IDE commands for Chrome automation",
+            install_claude_skill: "Install Claude Code skill for Chrome automation",
+            help: "Show help information",
         };
-        return descriptions[commandName] || 'No description available';
+        return descriptions[commandName] || "No description available";
     }
     getExitCodeForError(error) {
         if (error instanceof Error) {
             const message = error.message.toLowerCase();
-            if (message.includes('timeout')) {
+            if (message.includes("timeout")) {
                 return ExitCode.TIMEOUT_ERROR;
             }
-            if (message.includes('connection') || message.includes('connect')) {
+            if (message.includes("connection") || message.includes("connect")) {
                 return ExitCode.CONNECTION_ERROR;
             }
-            if (message.includes('file') || message.includes('path')) {
+            if (message.includes("file") || message.includes("path")) {
                 return ExitCode.FILE_ERROR;
             }
-            if (message.includes('invalid') || message.includes('validation')) {
+            if (message.includes("invalid") || message.includes("validation")) {
                 return ExitCode.VALIDATION_ERROR;
             }
         }