@dynamicu/chromedebug-mcp 2.2.0 → 2.2.2

package/README.md

@@ -21,8 +21,8 @@ npm install @dynamicu/chromedebug-mcp
 
 ```bash
 # Clone and install from source
-git clone https://github.com/dynamicupgrade/ChromePilot.git
-cd ChromePilot
+git clone https://github.com/dynamicupgrade/ChromeDebug.git
+cd ChromeDebug
 npm install
 ```
 
@@ -33,7 +33,7 @@ npm install
 To add Chrome Debug to your Claude desktop app:
 
 ```bash
-claude mcp add chromepilot -s user -- chrome-pilot
+claude mcp add chromedebug -s user -- chromedebug-mcp
 ```
 
 ### Embedded HTTP Server
@@ -42,35 +42,27 @@ Chrome Debug automatically starts an embedded HTTP server for Chrome extension c
 
 | Endpoint | Method | Description | Body |
 |----------|--------|-------------|------|
-| `/chrome-pilot/pause` | POST | Pause execution | - |
-| `/chrome-pilot/resume` | POST | Resume execution | - |
-| `/chrome-pilot/step-over` | POST | Step over | - |
-| `/chrome-pilot/evaluate` | POST | Evaluate expression | `{ "expression": "window.user" }` |
-| `/chrome-pilot/scopes` | GET | Get scope variables | - |
-| `/chrome-pilot/set-breakpoint` | POST | Set breakpoint | `{ "url": "file.js", "lineNumber": 10 }` |
-| `/chrome-pilot/logs` | GET | Get recent console logs | - |
-| `/chrome-pilot/screenshot` | POST | Take screenshot | `{ "type": "jpeg", "fullPage": true, "path": "/path/to/save.jpg" }` |
-| `/chrome-pilot/dom-intent` | POST | Process natural language DOM commands | `{ "selector": "#element", "instruction": "make it blue" }` |
-| `/chrome-pilot/status` | GET | Check server and Chrome connection status | - |
-| `/chrome-pilot/recording` | POST | Upload screen recording with logs | FormData with video file, logs JSON, and duration |
-| `/chrome-pilot/recording/:id` | GET | Retrieve a recording by ID | - |
-| `/chrome-pilot/workflow-recording` | POST | Save workflow recording | `{ "sessionId": "...", "actions": [...], "logs": [...] }` |
-| `/chrome-pilot/workflow-recording/:id` | GET | Get workflow recording | - |
-| `/chrome-pilot/restore-point` | POST | Save restore point | `{ "workflowId": "...", "domSnapshot": {...}, ... }` |
-| `/chrome-pilot/restore-point/:id` | GET/DELETE | Get or delete restore point | - |
-| `/chrome-pilot/restore-points/:workflowId` | GET | List restore points for workflow | - |
+| `/chromedebug/evaluate` | POST | Evaluate expression | `{ "expression": "window.user" }` |
+| `/chromedebug/scopes` | GET | Get scope variables | - |
+| `/chromedebug/logs` | GET | Get recent console logs | - |
+| `/chromedebug/screenshot` | GET | Take screenshot | `{ "type": "jpeg", "fullPage": true, "path": "/path/to/save.jpg" }` |
+| `/chromedebug/dom-intent` | POST | Process natural language DOM commands | `{ "selector": "#element", "instruction": "make it blue" }` |
+| `/chromedebug/status` | GET | Check server and Chrome connection status | - |
+| `/chromedebug/upload/:dataType` | POST | Upload screen recording with logs | FormData with video file, logs JSON, and duration |
+| `/chromedebug/recording/:id` | GET | Retrieve a recording by ID | - |
+| `/chromedebug/workflow-recording` | POST | Save workflow recording | `{ "sessionId": "...", "actions": [...], "logs": [...] }` |
+| `/chromedebug/workflow-recording/:sessionId` | GET | Get workflow recording | - |
+| `/chromedebug/restore-point` | POST | Save restore point | `{ "workflowId": "...", "domSnapshot": {...}, ... }` |
+| `/chromedebug/restore-point/:id` | GET/DELETE | Get or delete restore point | - |
+| `/chromedebug/restore-points/:workflowId` | GET | List restore points for workflow | - |
 
 ### MCP Tools
 
 When used as an MCP server, Chrome Debug exposes these tools:
 
 - `launch_chrome` - Launch a Chrome browser instance
-- `pause_execution` - Pause Chrome execution
-- `resume_execution` - Resume Chrome execution
-- `step_over` - Step over in debugger
 - `evaluate_expression` - Evaluate JavaScript expression
 - `get_scopes` - Get scope variables
-- `set_breakpoint` - Set a breakpoint
 - `get_logs` - Get console logs
 - `take_screenshot` - Take a screenshot
 - `get_page_content` - Get page content (text, HTML, and DOM structure)
@@ -98,8 +90,8 @@ npm start
 # 🔧 MCP tools will use this port for API calls
 
 # In another terminal, test the API (use the port shown in startup)
-curl -X POST http://localhost:3000/chrome-pilot/pause
-curl -X POST http://localhost:3000/chrome-pilot/evaluate \
+curl -X POST http://localhost:3000/chromedebug/pause
+curl -X POST http://localhost:3000/chromedebug/evaluate \
   -H "Content-Type: application/json" \
   -d '{"expression": "document.title"}'
 ```
@@ -131,12 +123,6 @@ Chrome Debug includes a Chrome extension that enables visual element selection f
    - Console logs can be included in the recording
    - Workflows can be replayed later for debugging
 
-3. **Restore Points** (NEW)
-   - During workflow recording, click "📍 Save Restore Point" to capture browser state
-   - Captures DOM, form values, storage, cookies, and scroll position
-   - Restore to any saved point to retry workflows from that state
-   - Perfect for debugging multi-step forms or complex interactions
-   - See [RESTORE_POINTS.md](RESTORE_POINTS.md) for details
 
 ## Development
 
@@ -154,12 +140,6 @@ Once Chrome Debug is installed as an MCP server, you can use these prompts with
 - "Get all the links on the current page"
 - "Take a screenshot of the current page"
 
-### Debugging JavaScript
-- "Set a breakpoint on line 42 of app.js and tell me what variables are in scope when it hits"
-- "Pause execution and show me the current call stack"
-- "Step through the code and watch how the 'counter' variable changes"
-- "Evaluate localStorage.getItem('user') in the browser console"
-
 ### Web Scraping & Automation
 - "Navigate to https://news.ycombinator.com and get the titles of the top 5 stories"
 - "Fill out the search form with 'JavaScript' and submit it"

package/chrome-extension/manifest.json

@@ -1,8 +1,8 @@
 {
   "manifest_version": 3,
-  "name": "ChromeDebug MCP Assistant v2.1.1",
-  "version": "2.1.1",
-  "description": "ChromeDebug MCP visual element selector with function tracing [Build: 2025-01-20-v2.1.1]",
+  "name": "ChromeDebug MCP Assistant v2.1.2",
+  "version": "2.1.2",
+  "description": "ChromeDebug MCP visual element selector with function tracing [Build: 2025-10-14-v2.1.2]",
   "permissions": [
     "activeTab",
     "scripting",

package/chrome-extension/popup.html

@@ -32,6 +32,7 @@
       border-radius: 4px;
       margin-bottom: 15px;
       font-size: 14px;
+      min-height: 40px;
     }
     
     .instructions {
@@ -129,7 +130,7 @@
   </style>
 </head>
 <body>
-  <div style="position: absolute; top: 5px; right: 5px; font-size: 10px; color: #999; font-family: monospace;">v2.0.8</div>
+  <div style="position: absolute; top: 5px; right: 5px; font-size: 10px; color: #999; font-family: monospace;">v2.1.2</div>
   <h2>Chrome Debug Assistant</h2>
 
   <!-- License Section -->

package/chrome-extension/popup.js

@@ -288,12 +288,53 @@ async function checkServerStatus() {
   
   if (connected) {
     statusEl.className = 'server-status connected';
-    statusTextEl.textContent = `Server connected (port ${connectedPort})`;
+    statusTextEl.innerHTML = `Server connected (port ${connectedPort})`;
   } else {
     statusEl.className = 'server-status disconnected';
-    statusTextEl.textContent = 'Server not running';
+
+    // Enhanced disconnected state with install instructions
+    statusTextEl.innerHTML = `
+      <span style="display: block; margin-bottom: 8px;">Server not installed</span>
+      <div style="display: flex; gap: 5px; align-items: center;">
+        <button id="copyInstallCmd" style="padding: 4px 8px; font-size: 11px; background: #2196F3; color: white; border: none; border-radius: 3px; cursor: pointer; flex-shrink: 0;">
+          📋 Copy Install Command
+        </button>
+        <a href="https://www.npmjs.com/package/@dynamicu/chromedebug-mcp" target="_blank" style="font-size: 11px; white-space: nowrap;">
+          View Installation Guide
+        </a>
+      </div>
+    `;
+
+    // Add click handler for copy button
+    setTimeout(() => {
+      const copyBtn = document.getElementById('copyInstallCmd');
+      if (copyBtn) {
+        copyBtn.addEventListener('click', async (e) => {
+          e.preventDefault();
+          const installCommand = 'npm install -g @dynamicu/chromedebug-mcp';
+
+          try {
+            await navigator.clipboard.writeText(installCommand);
+            const originalText = copyBtn.innerHTML;
+            copyBtn.innerHTML = '✅ Copied!';
+            copyBtn.style.background = '#4CAF50';
+
+            setTimeout(() => {
+              copyBtn.innerHTML = originalText;
+              copyBtn.style.background = '#2196F3';
+            }, 2000);
+          } catch (err) {
+            console.error('Failed to copy:', err);
+            copyBtn.innerHTML = '❌ Failed';
+            setTimeout(() => {
+              copyBtn.innerHTML = '📋 Copy Install Command';
+            }, 2000);
+          }
+        });
+      }
+    }, 0);
   }
-  
+
   // Return connection status and port for other functions to use
   return { connected, connectedPort };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamicu/chromedebug-mcp",
-  "version": "2.2.0",
+  "version": "2.2.2",
   "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",
@@ -12,12 +12,12 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/dynamicupgrade/ChromePilot.git"
+    "url": "git+https://github.com/dynamicupgrade/ChromeDebug.git"
   },
   "bugs": {
-    "url": "https://github.com/dynamicupgrade/ChromePilot/issues"
+    "url": "https://github.com/dynamicupgrade/ChromeDebug/issues"
   },
-  "homepage": "https://github.com/dynamicupgrade/ChromePilot#readme",
+  "homepage": "https://github.com/dynamicupgrade/ChromeDebug#readme",
   "scripts": {
     "cleanup": "node scripts/cleanup-processes.js",
     "cleanup-force": "node scripts/cleanup-processes.js --force",
@@ -49,11 +49,11 @@
     "test:migration": "NODE_OPTIONS='--experimental-vm-modules' jest tests/dual-id-migration.test.js",
     "test:regression": "NODE_OPTIONS='--experimental-vm-modules' jest tests/recording-regression.test.js",
     "test:recording-all": "NODE_OPTIONS='--experimental-vm-modules' jest tests/recording-system-comprehensive.test.js tests/chrome-extension-recording.test.js tests/dual-id-migration.test.js tests/recording-regression.test.js tests/dual-recording-id.test.js",
-    "run-migration": "node migrate-dual-ids.js",
+    "run-migration": "node scripts/migrate-dual-ids.js",
     "test:mcp": "NODE_OPTIONS='--experimental-vm-modules' jest tests/mcp-server.test.js",
     "tbv:microtest": "cd chrome-extension && npm run tbv:microtest",
-    "build:free": "webpack --config webpack.config.free.cjs",
-    "build:pro": "webpack --config webpack.config.pro.cjs",
+    "build:free": "webpack --config scripts/webpack.config.free.cjs",
+    "build:pro": "webpack --config scripts/webpack.config.pro.cjs",
     "build:both": "npm run build:free && npm run build:pro"
   },
   "keywords": [

package/scripts/migrate-dual-ids.js

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+// Migration script to convert from dual ID system to base ID system
+// This script updates existing recordings with prefixed IDs to use base IDs
+
+import Database from 'better-sqlite3';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const DB_PATH = path.join(__dirname, 'data/chrome-pilot.db');
+
+console.log('Chrome Debug ID Migration Script');
+console.log('================================');
+console.log(`Database path: ${DB_PATH}`);
+
+try {
+  const db = new Database(DB_PATH);
+  
+  // Disable foreign key constraints during migration
+  db.pragma('foreign_keys = OFF');
+  console.log('Foreign key constraints temporarily disabled');
+  
+  console.log('\n1. Analyzing current database state...');
+  
+  // Get all recordings with prefixed IDs
+  const prefixedRecordings = db.prepare(`
+    SELECT id, session_id, type, timestamp, total_frames 
+    FROM recordings 
+    WHERE id LIKE 'frame_session_%'
+  `).all();
+  
+  console.log(`Found ${prefixedRecordings.length} recordings with prefixed IDs`);
+  
+  if (prefixedRecordings.length === 0) {
+    console.log('No prefixed recordings found. Migration not needed.');
+    process.exit(0);
+  }
+  
+  // Show what will be migrated
+  console.log('\nRecordings to migrate:');
+  for (const record of prefixedRecordings) {
+    const baseId = record.id.replace('frame_session_', '');
+    console.log(`  ${record.id} -> ${baseId} (${record.type}, ${record.total_frames} frames)`);
+  }
+  
+  console.log('\n2. Starting migration transaction...');
+  
+  const migration = db.transaction(() => {
+    let migratedCount = 0;
+    
+    for (const record of prefixedRecordings) {
+      const oldId = record.id;
+      const newId = record.id.replace('frame_session_', '');
+      
+      // Check if base ID already exists
+      const existingBase = db.prepare('SELECT id FROM recordings WHERE id = ?').get(newId);
+      
+      if (existingBase) {
+        console.log(`  WARNING: Base ID ${newId} already exists. Checking frame counts...`);
+        
+        // Count frames for both records
+        const oldFrameCount = db.prepare('SELECT COUNT(*) as count FROM frames WHERE recording_id = ?').get(oldId)?.count || 0;
+        const newFrameCount = db.prepare('SELECT COUNT(*) as count FROM frames WHERE recording_id = ?').get(newId)?.count || 0;
+        
+        console.log(`    Old record frames: ${oldFrameCount}, New record frames: ${newFrameCount}`);
+        
+        if (oldFrameCount > 0 && newFrameCount === 0) {
+          // Old record has frames, new doesn't - migrate frames and delete old
+          console.log(`    Migrating frames from ${oldId} to ${newId}`);
+          db.prepare('UPDATE frames SET recording_id = ? WHERE recording_id = ?').run(newId, oldId);
+          db.prepare('UPDATE recordings SET total_frames = ? WHERE id = ?').run(oldFrameCount, newId);
+          db.prepare('DELETE FROM recordings WHERE id = ?').run(oldId);
+          migratedCount++;
+        } else if (oldFrameCount === 0) {
+          // Old record has no frames - just delete it
+          console.log(`    Deleting empty old record ${oldId}`);
+          db.prepare('DELETE FROM recordings WHERE id = ?').run(oldId);
+          migratedCount++;
+        } else {
+          // Both have frames - manual resolution needed
+          console.log(`    ERROR: Both records have frames. Manual resolution needed for ${oldId} vs ${newId}`);
+        }
+      } else {
+        // Simple case - just update the recording ID
+        console.log(`  Migrating ${oldId} -> ${newId}`);
+        
+        // Update the recording ID
+        db.prepare('UPDATE recordings SET id = ? WHERE id = ?').run(newId, oldId);
+        
+        // Update related frames
+        db.prepare('UPDATE frames SET recording_id = ? WHERE recording_id = ?').run(newId, oldId);
+        
+        // Update related screen interactions (if any)
+        db.prepare('UPDATE screen_interactions SET recording_id = ? WHERE recording_id = ?').run(newId, oldId);
+        
+        migratedCount++;
+      }
+    }
+    
+    return migratedCount;
+  });
+  
+  const migratedCount = migration();
+  
+  console.log(`\n3. Migration completed successfully!`);
+  console.log(`   Migrated ${migratedCount} recordings`);
+  
+  // Verify migration
+  console.log('\n4. Verifying migration...');
+  const remainingPrefixed = db.prepare(`
+    SELECT COUNT(*) as count FROM recordings WHERE id LIKE 'frame_session_%'
+  `).get().count;
+  
+  console.log(`Remaining prefixed recordings: ${remainingPrefixed}`);
+  
+  if (remainingPrefixed === 0) {
+    console.log('✅ Migration verification passed - no prefixed IDs remain');
+  } else {
+    console.log('⚠️  Migration verification failed - some prefixed IDs still exist');
+  }
+  
+  // Re-enable foreign key constraints
+  db.pragma('foreign_keys = ON');
+  console.log('Foreign key constraints re-enabled');
+  
+  console.log('\nMigration completed successfully!');
+  
+  
+  // Close database connection
+  db.close();
+  
+} catch (error) {
+  console.error('Migration failed:', error);
+  process.exit(1);
+}

package/scripts/webpack.config.free.cjs

@@ -0,0 +1,74 @@
+const path = require('path');
+const CopyPlugin = require('copy-webpack-plugin');
+const webpack = require('webpack');
+
+module.exports = {
+  mode: 'production',
+  entry: {
+    background: './chrome-extension/background.js',
+    content: './chrome-extension/content.js',
+    popup: './chrome-extension/popup.js',
+    options: './chrome-extension/options.js'
+  },
+  output: {
+    path: path.resolve(__dirname, 'dist/free'),
+    filename: '[name].js',
+    clean: true
+  },
+  plugins: [
+    new webpack.DefinePlugin({
+      '__TIER__': JSON.stringify('free'),
+      '__FEATURES__': JSON.stringify({
+        enhancedCapture: false,
+        frameEditor: false,
+        advancedSettings: false,
+        functionTracing: false
+      })
+    }),
+    new CopyPlugin({
+      patterns: [
+        // Use free manifest
+        {
+          from: 'chrome-extension/manifest.free.json',
+          to: 'manifest.json'
+        },
+
+        // Copy HTML files
+        { from: 'chrome-extension/popup.html', to: 'popup.html' },
+        { from: 'chrome-extension/options.html', to: 'options.html' },
+        { from: 'chrome-extension/offscreen.html', to: 'offscreen.html' },
+
+        // Copy icons
+        { from: 'chrome-extension/*.png', to: '[name][ext]' },
+
+        // Copy CSS
+        { from: 'chrome-extension/*.css', to: '[name][ext]' },
+
+        // Copy third-party libraries (as-is, no bundling)
+        { from: 'chrome-extension/pako.min.js', to: 'pako.min.js' },
+        { from: 'chrome-extension/web-vitals.iife.js', to: 'web-vitals.iife.js' },
+
+        // Copy supporting modules (these are imported by bundled scripts)
+        { from: 'chrome-extension/pii-redactor.js', to: 'pii-redactor.js' },
+        { from: 'chrome-extension/data-buffer.js', to: 'data-buffer.js' },
+        { from: 'chrome-extension/performance-monitor.js', to: 'performance-monitor.js' },
+        { from: 'chrome-extension/dom-tracker.js', to: 'dom-tracker.js' },
+        { from: 'chrome-extension/network-tracker.js', to: 'network-tracker.js' },
+        { from: 'chrome-extension/upload-manager.js', to: 'upload-manager.js' },
+        { from: 'chrome-extension/extension-config.js', to: 'extension-config.js' },
+        { from: 'chrome-extension/logger.js', to: 'logger.js' },
+        { from: 'chrome-extension/license-helper.js', to: 'license-helper.js' },
+        { from: 'chrome-extension/firebase-client.js', to: 'firebase-client.js' },
+        { from: 'chrome-extension/firebase-config.js', to: 'firebase-config.js' },
+        { from: 'chrome-extension/frame-capture.js', to: 'frame-capture.js' },
+        { from: 'chrome-extension/chrome-session-manager.js', to: 'chrome-session-manager.js' },
+
+        // Copy README
+        { from: 'chrome-extension/README.md', to: 'README.md' }
+      ]
+    })
+  ],
+  optimization: {
+    minimize: false // Don't minimize for easier debugging
+  }
+};

package/scripts/webpack.config.pro.cjs

@@ -0,0 +1,80 @@
+const path = require('path');
+const CopyPlugin = require('copy-webpack-plugin');
+const webpack = require('webpack');
+
+module.exports = {
+  mode: 'production',
+  entry: {
+    background: './chrome-extension/background.js',
+    content: './chrome-extension/content.js',
+    popup: './chrome-extension/popup.js',
+    options: './chrome-extension/options.js',
+    'pro/frame-editor': './chrome-extension/pro/frame-editor.js'
+  },
+  output: {
+    path: path.resolve(__dirname, 'dist/pro'),
+    filename: '[name].js',
+    clean: true
+  },
+  plugins: [
+    new webpack.DefinePlugin({
+      '__TIER__': JSON.stringify('pro'),
+      '__FEATURES__': JSON.stringify({
+        enhancedCapture: true,
+        frameEditor: true,
+        advancedSettings: true,
+        functionTracing: true
+      })
+    }),
+    new CopyPlugin({
+      patterns: [
+        // Use pro manifest
+        {
+          from: 'chrome-extension/manifest.pro.json',
+          to: 'manifest.json'
+        },
+
+        // Copy HTML files
+        { from: 'chrome-extension/popup.html', to: 'popup.html' },
+        { from: 'chrome-extension/options.html', to: 'options.html' },
+        { from: 'chrome-extension/offscreen.html', to: 'offscreen.html' },
+        { from: 'chrome-extension/pro/frame-editor.html', to: 'pro/frame-editor.html' },
+
+        // Copy icons
+        { from: 'chrome-extension/*.png', to: '[name][ext]' },
+
+        // Copy CSS
+        { from: 'chrome-extension/*.css', to: '[name][ext]' },
+
+        // Copy third-party libraries (as-is, no bundling)
+        { from: 'chrome-extension/pako.min.js', to: 'pako.min.js' },
+        { from: 'chrome-extension/web-vitals.iife.js', to: 'web-vitals.iife.js' },
+
+        // Copy supporting modules (these are imported by bundled scripts)
+        { from: 'chrome-extension/pii-redactor.js', to: 'pii-redactor.js' },
+        { from: 'chrome-extension/data-buffer.js', to: 'data-buffer.js' },
+        { from: 'chrome-extension/performance-monitor.js', to: 'performance-monitor.js' },
+        { from: 'chrome-extension/dom-tracker.js', to: 'dom-tracker.js' },
+        { from: 'chrome-extension/network-tracker.js', to: 'network-tracker.js' },
+        { from: 'chrome-extension/upload-manager.js', to: 'upload-manager.js' },
+        { from: 'chrome-extension/extension-config.js', to: 'extension-config.js' },
+        { from: 'chrome-extension/logger.js', to: 'logger.js' },
+        { from: 'chrome-extension/license-helper.js', to: 'license-helper.js' },
+        { from: 'chrome-extension/firebase-client.js', to: 'firebase-client.js' },
+        { from: 'chrome-extension/firebase-config.js', to: 'firebase-config.js' },
+        { from: 'chrome-extension/frame-capture.js', to: 'frame-capture.js' },
+        { from: 'chrome-extension/chrome-session-manager.js', to: 'chrome-session-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' },
+
+        // Copy README
+        { from: 'chrome-extension/README.md', to: 'README.md' }
+      ]
+    })
+  ],
+  optimization: {
+    minimize: false // Don't minimize for easier debugging
+  }
+};

package/src/port-discovery.js

@@ -1,110 +1,49 @@
 // Port discovery utilities for Chrome Debug
 // This helps Chrome extension and MCP clients find the running HTTP server
 //
-// Note: Claude Code (MCP client) may create .chromedebug-port-[UUID] files
-// to track multiple sessions. Our code only uses .chromedebug-port (no UUID).
-// We don't clean these files as we didn't create them.
+// Uses a single .chromedebug-port file that gets overwritten by each server startup.
+// The last-started server's port is what gets discovered.
+//
+// Note: Session isolation is handled by unified-session-manager.js, which uses
+// atomic file-based locks in /tmp/chromedebug-sessions/port-locks/ to ensure
+// each Claude session gets a unique port. This port file is just a hint for
+// external discovery and is not used for session isolation.
 
 import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
-import crypto from 'crypto';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
-// Session management for port discovery
-let currentSessionId = null;
-
-/**
- * Get or generate a session ID for port discovery
- */
-function getSessionId() {
-  if (!currentSessionId) {
-    currentSessionId = crypto.randomBytes(8).toString('hex');
-  }
-  return currentSessionId;
-}
-
-/**
- * Set a custom session ID for port discovery
- */
-export function setPortDiscoverySessionId(sessionId) {
-  if (typeof sessionId === 'string' && sessionId.match(/^[a-zA-Z0-9_-]+$/)) {
-    currentSessionId = sessionId;
-    console.log(`Port discovery session ID set to: ${sessionId}`);
-  } else {
-    throw new Error('Session ID must be alphanumeric with dashes/underscores only');
-  }
-}
-
 /**
- * Get the session-specific port file path
+ * Get the port file path
  */
 function getPortFilePath() {
-  const sessionId = getSessionId();
-  return path.join(__dirname, `../.chromedebug-port-${sessionId}`);
-}
-
-/**
- * Get the legacy port file path (for backward compatibility)
- */
-function getLegacyPortFilePath() {
   return path.join(__dirname, '../.chromedebug-port');
 }
 
 /**
- * Write the current port to a session-specific file for discovery
+ * Write the current port to file for discovery
+ * @param {number} port - The port number to write
  */
-export function writePortFile(port, options = {}) {
-  const { sessionId, writeLegacy = true } = options;
-
-  // Set session ID if provided
-  if (sessionId) {
-    setPortDiscoverySessionId(sessionId);
-  }
-
+export function writePortFile(port) {
   const portFilePath = getPortFilePath();
-  const legacyPortFilePath = getLegacyPortFilePath();
 
   try {
-    // Write to session-specific file
     fs.writeFileSync(portFilePath, port.toString());
-    console.log(`Port ${port} written to ${portFilePath} [Session: ${getSessionId()}]`);
-
-    // Optionally write to legacy file for backward compatibility
-    if (writeLegacy) {
-      try {
-        fs.writeFileSync(legacyPortFilePath, port.toString());
-      } catch (legacyError) {
-        console.warn(`Could not write legacy port file: ${legacyError.message}`);
-      }
-    }
+    console.log(`Port ${port} written to ${portFilePath}`);
   } catch (error) {
     console.error('Failed to write port file:', error);
   }
 }
 
 /**
- * Read the port from session-specific or legacy file
+ * Read the port from file
+ * @returns {number|null} The port number, or null if not found
  */
-export function readPortFile(sessionId = null) {
-  // If session ID provided, use that specific session
-  if (sessionId) {
-    try {
-      const sessionPortFile = path.join(__dirname, `../.chromedebug-port-${sessionId}`);
-      if (fs.existsSync(sessionPortFile)) {
-        const port = parseInt(fs.readFileSync(sessionPortFile, 'utf8').trim());
-        if (!isNaN(port)) {
-          return port;
-        }
-      }
-    } catch (error) {
-      console.error(`Failed to read session port file for ${sessionId}:`, error);
-    }
-  }
-
-  // Try current session file
+export function readPortFile() {
   const portFilePath = getPortFilePath();
+
   try {
     if (fs.existsSync(portFilePath)) {
       const port = parseInt(fs.readFileSync(portFilePath, 'utf8').trim());
@@ -113,63 +52,37 @@ export function readPortFile(sessionId = null) {
       }
     }
   } catch (error) {
-    console.error('Failed to read session port file:', error);
-  }
-
-  // Fall back to legacy file
-  const legacyPortFilePath = getLegacyPortFilePath();
-  try {
-    if (fs.existsSync(legacyPortFilePath)) {
-      const port = parseInt(fs.readFileSync(legacyPortFilePath, 'utf8').trim());
-      if (!isNaN(port)) {
-        return port;
-      }
-    }
-  } catch (error) {
-    console.error('Failed to read legacy port file:', error);
+    console.error('Failed to read port file:', error);
   }
 
   return null;
 }
 
 /**
- * Remove the port files on shutdown
+ * Remove the port file on shutdown
  */
 export function removePortFile() {
   const portFilePath = getPortFilePath();
-  const legacyPortFilePath = getLegacyPortFilePath();
 
   try {
     if (fs.existsSync(portFilePath)) {
       fs.unlinkSync(portFilePath);
-      console.log(`Removed session port file: ${portFilePath}`);
+      console.log(`Removed port file: ${portFilePath}`);
     }
   } catch (error) {
-    console.error('Failed to remove session port file:', error);
-  }
-
-  // Only remove legacy file if no other sessions are using it
-  try {
-    if (fs.existsSync(legacyPortFilePath)) {
-      // Check if there are other session port files
-      const portFiles = fs.readdirSync(__dirname + '/..')
-        .filter(f => f.startsWith('.chromedebug-port-') && f !== `.chromedebug-port-${getSessionId()}`);
-
-      if (portFiles.length === 0) {
-        fs.unlinkSync(legacyPortFilePath);
-        console.log('Removed legacy port file (no other sessions)');
-      }
-    }
-  } catch (error) {
-    console.error('Failed to remove legacy port file:', error);
+    console.error('Failed to remove port file:', error);
   }
 }
 
 /**
  * Try to discover the Chrome Debug server by checking multiple ports
+ * @param {number[]} preferredPorts - Array of ports to check
+ * @param {Object} options - Discovery options
+ * @param {boolean} options.extendedRange - Whether to extend the port range
+ * @returns {Promise<number|null>} The discovered port, or null if not found
  */
 export async function discoverServer(preferredPorts = [3000, 3001, 3002, 3028], options = {}) {
-  const { sessionId, extendedRange = true } = options;
+  const { extendedRange = true } = options;
 
   // Extend port range to reduce conflicts in multi-session environments
   if (extendedRange) {
@@ -183,13 +96,13 @@ export async function discoverServer(preferredPorts = [3000, 3001, 3002, 3028],
     ];
   }
 
-  // First check session-specific port file
-  const filePort = readPortFile(sessionId);
+  // First check port file
+  const filePort = readPortFile();
   if (filePort) {
     preferredPorts.unshift(filePort);
   }
 
-  // Try each port with exponential backoff
+  // Try each port
   for (let i = 0; i < preferredPorts.length; i++) {
     const port = preferredPorts[i];
     try {
@@ -216,43 +129,3 @@ export async function discoverServer(preferredPorts = [3000, 3001, 3002, 3028],
 
   return null;
 }
-
-/**
- * Get session information for port discovery
- */
-export function getPortDiscoveryInfo() {
-  return {
-    sessionId: getSessionId(),
-    portFile: getPortFilePath(),
-    legacyPortFile: getLegacyPortFilePath(),
-    currentPort: readPortFile()
-  };
-}
-
-/**
- * Find all active ChromeDebug sessions by scanning port files
- */
-export function findActiveSessions() {
-  const sessions = [];
-
-  try {
-    const files = fs.readdirSync(__dirname + '/..');
-    const portFiles = files.filter(f => f.startsWith('.chromedebug-port-'));
-
-    for (const file of portFiles) {
-      const sessionId = file.replace('.chromedebug-port-', '');
-      try {
-        const port = parseInt(fs.readFileSync(path.join(__dirname, '..', file), 'utf8').trim());
-        if (!isNaN(port)) {
-          sessions.push({ sessionId, port, portFile: file });
-        }
-      } catch (error) {
-        console.warn(`Could not read port file ${file}: ${error.message}`);
-      }
-    }
-  } catch (error) {
-    console.error('Failed to scan for active sessions:', error);
-  }
-
-  return sessions;
-}

package/chrome-extension/README.md

@@ -1,41 +0,0 @@
-# Chrome Debug Assistant Extension
-
-This Chrome extension enables visual element selection for the Chrome Debug MCP server.
-
-## Installation
-
-1. Open Chrome and navigate to `chrome://extensions/`
-2. Enable "Developer mode" (toggle in the top right)
-3. Click "Load unpacked"
-4. Select the `chrome-extension` directory
-
-## Usage
-
-1. Ensure the Chrome Debug MCP server is running (`npm start`)
-2. Navigate to any webpage
-3. Click on any element to select it
-4. The element will be:
-   - Highlighted with a pink outline
-   - Sent to Chrome Debug server
-   - Available for modification via Claude MCP tools
-
-## How it Works
-
-1. Click any element on the page
-2. The extension sends the element's selector to Chrome Debug
-3. Use Claude in your terminal to modify the selected element:
-   ```
-   "Show me what element is currently selected"
-   "Make the selected element blue"
-   "Apply CSS: padding: 20px !important; border-radius: 8px !important"
-   "Execute JavaScript to get the element's text content"
-   "Clear the selected element"
-   ```
-
-## Features
-
-- Visual element selection with hover highlighting
-- Automatic server detection (scans ports 3000-3025)
-- Pink outline shows currently selected element
-- Server connection status indicator
-- One-click element selection