@dynamicu/chromedebug-mcp 2.6.6 → 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.6",
+  "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

@@ -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

@@ -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/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/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