@dynamicu/chromedebug-mcp 2.6.4 → 2.6.7

package/config/chromedebug-config.json

@@ -0,0 +1,101 @@
+{
+  "serverPorts": {
+    "httpServer": {
+      "preferredPorts": [
+        3001,
+        3000,
+        3002,
+        3028,
+        3029,
+        3030,
+        3031,
+        3032,
+        3033,
+        3034,
+        3035,
+        3036,
+        8080,
+        8081,
+        8082,
+        8083,
+        8084,
+        8085,
+        8086,
+        8087,
+        8088,
+        8089,
+        8090,
+        9000,
+        9001,
+        9002,
+        9003,
+        9004,
+        9005,
+        9006,
+        9007,
+        9008,
+        9009,
+        9010
+      ],
+      "description": "Ports to try for HTTP server discovery, in priority order"
+    },
+    "mcpServer": {
+      "preferredPorts": [
+        3028,
+        3023,
+        3002,
+        3003,
+        3004,
+        3005,
+        3029,
+        3030,
+        3031,
+        3032,
+        3033,
+        3034,
+        3035,
+        3036,
+        8080,
+        8081,
+        8082,
+        8083,
+        8084,
+        8085,
+        8086,
+        8087,
+        8088,
+        8089,
+        8090,
+        9000,
+        9001,
+        9002,
+        9003,
+        9004,
+        9005,
+        9006,
+        9007,
+        9008,
+        9009,
+        9010
+      ],
+      "description": "Ports to try for MCP server discovery, in priority order"
+    },
+    "discoveryRange": {
+      "start": 3000,
+      "end": 9010,
+      "description": "Port range for automatic discovery when preferred ports are not available"
+    }
+  },
+  "chromeExtension": {
+    "serverDiscovery": {
+      "timeoutMs": 3000,
+      "description": "Timeout for server discovery requests in milliseconds"
+    },
+    "portScanOrder": "httpFirst",
+    "description": "Order to try ports: 'httpFirst' tries HTTP ports first, 'mcpFirst' tries MCP ports first, 'sequential' tries all ports in numerical order"
+  },
+  "logging": {
+    "level": "info",
+    "description": "Logging level: debug, info, warn, error"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamicu/chromedebug-mcp",
-  "version": "2.6.4",
+  "version": "2.6.7",
   "description": "ChromeDebug MCP - MCP server that provides full control over a Chrome browser instance for debugging and automation with AI assistants like Claude Code",
   "main": "src/index.js",
   "type": "module",

package/scripts/package-pro-extension.js

@@ -14,7 +14,7 @@ import archiver from 'archiver';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const rootDir = join(__dirname, '..');
-const proExtensionDir = join(rootDir, 'scripts', 'dist', 'pro');
+const proExtensionDir = join(rootDir, 'dist', 'pro');
 const outputDir = join(rootDir, 'dist');
 const outputFile = join(outputDir, 'chromedebug-extension-pro.zip');
 

package/scripts/webpack.config.free.cjs

@@ -11,7 +11,7 @@ module.exports = {
     options: './chrome-extension/options.js'
   },
   output: {
-    path: path.resolve(__dirname, 'dist/free'),
+    path: path.resolve(__dirname, '../dist/free'),
     filename: '[name].js',
     clean: true
   },
@@ -67,6 +67,9 @@ module.exports = {
         { from: 'chrome-extension/frame-capture.js', to: 'frame-capture.js' },
         { from: 'chrome-extension/chrome-session-manager.js', to: 'chrome-session-manager.js' },
 
+        // Browser-only recording mode files
+        { from: 'chrome-extension/browser-recording-manager.js', to: 'browser-recording-manager.js' },
+
         // Copy README
         { from: 'chrome-extension/README.md', to: 'README.md' }
       ]

package/scripts/webpack.config.pro.cjs

@@ -12,7 +12,7 @@ module.exports = {
     'pro/frame-editor': './chrome-extension/pro/frame-editor.js'
   },
   output: {
-    path: path.resolve(__dirname, 'dist/pro'),
+    path: path.resolve(__dirname, '../dist/pro'),
     filename: '[name].js',
     clean: true
   },
@@ -69,6 +69,9 @@ module.exports = {
         { from: 'chrome-extension/frame-capture.js', to: 'frame-capture.js' },
         { from: 'chrome-extension/chrome-session-manager.js', to: 'chrome-session-manager.js' },
 
+        // Browser-only recording mode files
+        { from: 'chrome-extension/browser-recording-manager.js', to: 'browser-recording-manager.js' },
+
         // Copy Pro features
         { from: 'chrome-extension/pro/function-tracker.js', to: 'pro/function-tracker.js' },
         { from: 'chrome-extension/pro/enhanced-capture.js', to: 'pro/enhanced-capture.js' },

package/src/chrome-controller.js

@@ -1981,10 +1981,10 @@ export class ChromeController {
   async storeWorkflowRecording(sessionId, url, title, includeLogs, actions, logs, name = null, screenshotSettings = null, functionTraces = null) {
     try {
       const { database } = await import('./database.js');
-      
+
       // Store the workflow recording
       const workflowId = database.storeWorkflowRecording(sessionId, url, title, includeLogs, name, screenshotSettings);
-      
+
       // Merge function traces into actions if provided
       let allActions = [...actions];
       if (functionTraces && functionTraces.length > 0) {
@@ -1994,23 +1994,23 @@ export class ChromeController {
         // Sort all actions by timestamp to maintain chronological order
         allActions.sort((a, b) => a.timestamp - b.timestamp);
       }
-      
+
       // Store actions with proper indexing
       const indexedActions = allActions.map((action, index) => ({
         ...action,
         index: index
       }));
-      
+
       const actionsResult = database.storeWorkflowActions(workflowId, indexedActions);
-      
+
       // Store logs if provided
       if (includeLogs && logs && logs.length > 0) {
         const logsResult = database.storeWorkflowLogs(workflowId, logs);
         logger.debug(`Stored ${logsResult.storedCount} logs for workflow ${sessionId}`);
       }
-      
+
       logger.debug(`Stored workflow recording ${sessionId} with ${actionsResult.storedCount} actions (including ${functionTraces ? functionTraces.length : 0} function traces)`);
-      
+
       return {
         success: true,
         sessionId: sessionId,

package/src/cli.js

@@ -81,6 +81,12 @@ For details: https://github.com/dynamicupgrade/ChromeDebug#windows-setup
       verbose: args.verbose
     });
 
+    // Mark as persistent if requested
+    if (args.persistent) {
+      await sessionManager.markAsPersistent();
+      console.error('Session marked as persistent - will not be killed by other instances');
+    }
+
     // Kill other instances unless --allow-multiple is set
     if (!args.allowMultiple) {
       await sessionManager.killOtherInstances();

package/src/database.js

@@ -1414,6 +1414,8 @@ class ChromePilotDatabase {
           return action[camelCaseName] || action[snakeCaseName] || null;
         };
 
+        const screenshotDataToStore = action.screenshot_data || null;
+
         stmt.run(
           workflowId,
           action.index,
@@ -1425,7 +1427,7 @@ class ChromePilotDatabase {
           action.text || null,
           action.placeholder || null,
           action.timestamp,
-          action.screenshot_data || null,
+          screenshotDataToStore,
           action.component || null,  // For function traces
           action.args ? JSON.stringify(action.args) : null,  // Store args as JSON string
           action.stack || null,  // For function traces
@@ -1436,6 +1438,7 @@ class ChromePilotDatabase {
           safeJsonStringify(getEnhancedFieldData(action, 'elementState', 'element_state'), 2048),   // 2KB limit
           safeJsonStringify(getEnhancedFieldData(action, 'performanceMetrics', 'performance_metrics'), 1024)  // 1KB limit
         );
+
         storedCount++;
       }
 
@@ -1452,6 +1455,7 @@ class ChromePilotDatabase {
     `);
     updateStmt.run(storedCount, workflowId);
 
+    logger.debug('[SCREENSHOT-DEBUG] database.storeWorkflowActions - EXIT');
     return { success: true, storedCount };
   }
 
@@ -1560,7 +1564,7 @@ class ChromePilotDatabase {
         text: action.text,
         placeholder: action.placeholder,
         timestamp: action.timestamp,
-        screenshot_data: action.screenshot_data
+        screenshot: action.screenshot_data  // Map screenshot_data to screenshot for consistency
       };
 
       // Add function trace fields if they exist

package/src/http-server.js

@@ -286,18 +286,19 @@ async function startHttpServer(chromeController = null, targetPort = null) {
   });
 
   // Protected workflow recording endpoints
-  app.post('/chromedebug/workflow-recording', 
+  app.post('/chromedebug/workflow-recording',
     authenticate,
     authorize(PERMISSIONS.WORKFLOW_WRITE),
     createValidator(workflowRecordingSchema),
     async (req, res) => {
     const { sessionId, url, title, includeLogs, actions, logs, functionTraces, name, screenshotSettings } = req.body;
+
     logger.info('[HTTP Server] Received workflow recording with name:', name);
     logger.info('[HTTP Server] Function traces count:', functionTraces ? functionTraces.length : 0);
     if (!sessionId || !actions) {
       return res.status(400).json({ error: 'sessionId and actions are required' });
     }
-    
+
     try {
       const result = await activeController.storeWorkflowRecording(sessionId, url, title, includeLogs, actions, logs, name, screenshotSettings, functionTraces);
       res.json(result);

package/src/index.js

@@ -153,7 +153,8 @@ class ChromePilotApp {
       noCleanup: false,
       verbose: false,
       dbPath: null,
-      allowMultiple: false
+      allowMultiple: false,
+      persistent: false
     };
 
     const argv = process.argv.slice(2);
@@ -195,6 +196,9 @@ class ChromePilotApp {
         case '--allow-multiple':
           args.allowMultiple = true;
           break;
+        case '--persistent':
+          args.persistent = true;
+          break;
         case '--help':
           this.showHelp();
           process.exit(0);
@@ -242,6 +246,7 @@ Options:
   --no-cleanup        Skip cleanup of dead processes on startup
   --verbose           Enable verbose logging including session info
   --allow-multiple    Allow multiple ChromeDebug instances (default: kill others on startup)
+  --persistent        Mark as persistent server (won't be killed by other instances)
   --help              Show this help message
 
 Session Isolation:

package/src/services/unified-session-manager.js

@@ -31,7 +31,8 @@ export class UnifiedSessionManager {
       port: null,
       processes: [],
       locks: [],
-      heartbeat: Date.now()
+      heartbeat: Date.now(),
+      persistent: false  // If true, won't be killed by other instances
     };
 
     this.heartbeatInterval = null;
@@ -354,6 +355,18 @@ export class UnifiedSessionManager {
     }
   }
 
+  /**
+   * Mark this session as persistent (won't be killed by other instances)
+   */
+  async markAsPersistent() {
+    this.state.persistent = true;
+    await this.updateSessionFile();
+
+    if (this.verbose) {
+      console.error(`Session ${this.sessionId} marked as persistent`);
+    }
+  }
+
   /**
    * Start heartbeat to keep session alive
    */
@@ -449,6 +462,7 @@ export class UnifiedSessionManager {
   /**
    * Kill all other ChromeDebug instances
    * Uses session files to find PIDs, then kills them gracefully
+   * Skips sessions marked as persistent
    * @returns {Array} Array of killed PIDs
    */
   async killOtherInstances() {
@@ -459,6 +473,12 @@ export class UnifiedSessionManager {
     for (const session of sessions) {
       if (session.pid === currentPid) continue; // Don't kill ourselves
 
+      // Skip persistent sessions
+      if (session.persistent) {
+        console.error(`Skipping persistent session: PID ${session.pid} (session ${session.sessionId})`);
+        continue;
+      }
+
       try {
         // Check if process exists
         process.kill(session.pid, 0); // Signal 0 = check existence
@@ -523,7 +543,7 @@ export class UnifiedSessionManager {
    */
   async isChromeDebugProcess(pid) {
     try {
-      const { execSync } = await import('child_process');
+      const { execSync } = require('child_process');
 
       // Get process command line
       const cmd = execSync(`ps -p ${pid} -o command=`, { encoding: 'utf8' }).trim();

package/src/validation/schemas.js

@@ -20,8 +20,35 @@ export const workflowRecordingSchema = Joi.object({
     Joi.object({
       type: Joi.string().required(),
       timestamp: Joi.number().required(),
-      data: Joi.object().optional()
-    })
+      data: Joi.object().optional(),
+      // Screenshot field - base64 encoded image data
+      screenshot_data: Joi.string().max(10485760).optional(), // 10MB max for base64 string
+      // Click/interaction fields
+      selector: Joi.string().optional(),
+      x: Joi.number().optional(),
+      y: Joi.number().optional(),
+      value: Joi.string().optional(),
+      text: Joi.string().optional(),
+      placeholder: Joi.string().optional(),
+      index: Joi.number().optional(),
+      // Enhanced click tracking fields
+      element_html: Joi.string().max(10240).optional(),
+      elementHTML: Joi.string().max(10240).optional(), // camelCase variant
+      component_data: Joi.string().max(3072).optional(),
+      componentData: Joi.string().max(3072).optional(), // camelCase variant
+      event_handlers: Joi.string().max(2048).optional(),
+      eventHandlers: Joi.string().max(2048).optional(), // camelCase variant
+      element_state: Joi.string().max(2048).optional(),
+      elementState: Joi.string().max(2048).optional(), // camelCase variant
+      performance_metrics: Joi.string().max(1024).optional(),
+      performanceMetrics: Joi.string().max(1024).optional(), // camelCase variant
+      // Function trace fields
+      component: Joi.string().optional(),
+      args: Joi.alternatives().try(Joi.array(), Joi.string()).optional(),
+      stack: Joi.string().optional(),
+      // Attached logs
+      logs: Joi.array().optional()
+    }).unknown(true) // Allow additional fields for future extensibility
   ).required(),
   logs: Joi.array().items(
     Joi.object({
@@ -42,10 +69,13 @@ export const workflowRecordingSchema = Joi.object({
   ).optional(),
   name: Joi.any().optional(),
   screenshotSettings: Joi.object({
-    width: Joi.number().integer().min(100).max(4000).optional(),
-    height: Joi.number().integer().min(100).max(4000).optional(),
-    quality: Joi.number().min(10).max(100).optional()
-  }).optional()
+    width: Joi.number().integer().min(100).max(4000).optional().allow(null),
+    height: Joi.number().integer().min(100).max(4000).optional().allow(null),
+    quality: Joi.number().min(10).max(100).optional().allow(null),
+    format: Joi.string().valid('png', 'jpeg').optional().allow(null),
+    enabled: Joi.boolean().optional().allow(null),
+    maxWidth: Joi.number().integer().optional().allow(null)
+  }).optional().allow(null)
 });
 
 // Frame batch schema