brave-real-browser-mcp-server 2.43.22 → 2.43.24

package/lib/cjs/module/pageController.js

@@ -58,7 +58,7 @@ async function pageController({ browser, page, proxy, turnstile, xvfbsession, pi
                             url.includes('track');
                         if (isAdPopup) {
                             await newPage.close().catch(() => { });
-                            console.log('[popup-blocker] Blocked popup ad:', url.substring(0, 50));
+                            console.error('[popup-blocker] Blocked popup ad:', url.substring(0, 50));
                         }
                     }
                 }
@@ -333,7 +333,7 @@ async function pageController({ browser, page, proxy, turnstile, xvfbsession, pi
             get: () => 8,
             configurable: true
         });
-        
+
         // Device memory should be 4, 8, or 16 GB
         if ('deviceMemory' in navigator) {
             Object.defineProperty(navigator, 'deviceMemory', {
@@ -341,7 +341,7 @@ async function pageController({ browser, page, proxy, turnstile, xvfbsession, pi
                 configurable: true
             });
         }
-        
+
         // ========== NOTIFICATION PERMISSION FIX ==========
         if (typeof Notification !== 'undefined') {
             Object.defineProperty(Notification, 'permission', {
@@ -349,11 +349,11 @@ async function pageController({ browser, page, proxy, turnstile, xvfbsession, pi
                 configurable: true
             });
         }
-        
+
         // ========== DOCUMENT FOCUS FIX ==========
         const originalHasFocus = document.hasFocus.bind(document);
-        document.hasFocus = function() { return true; };
-        
+        document.hasFocus = function () { return true; };
+
         // ========== CONNECTION API FIX ==========
         if (!navigator.connection) {
             Object.defineProperty(navigator, 'connection', {
@@ -363,14 +363,14 @@ async function pageController({ browser, page, proxy, turnstile, xvfbsession, pi
                     effectiveType: '4g',
                     saveData: false,
                     type: 'wifi',
-                    addEventListener: function() {},
-                    removeEventListener: function() {},
-                    dispatchEvent: function() { return true; }
+                    addEventListener: function () { },
+                    removeEventListener: function () { },
+                    dispatchEvent: function () { return true; }
                 }),
                 configurable: true
             });
         }
-        
+
         // ========== PERFORMANCE MEMORY FIX ==========
         if (window.performance && !performance.memory) {
             Object.defineProperty(performance, 'memory', {
@@ -382,17 +382,17 @@ async function pageController({ browser, page, proxy, turnstile, xvfbsession, pi
                 configurable: true
             });
         }
-        
+
         // ========== CHROME RUNTIME FIX (Critical for CreepJS) ==========
-        (function() {
+        (function () {
             const chromeObj = {
                 app: {
                     isInstalled: false,
                     InstallState: { DISABLED: 'disabled', INSTALLED: 'installed', NOT_INSTALLED: 'not_installed' },
                     RunningState: { CANNOT_RUN: 'cannot_run', READY_TO_RUN: 'ready_to_run', RUNNING: 'running' },
-                    getDetails: function() { return null; },
-                    getIsInstalled: function() { return false; },
-                    runningState: function() { return 'cannot_run'; }
+                    getDetails: function () { return null; },
+                    getIsInstalled: function () { return false; },
+                    runningState: function () { return 'cannot_run'; }
                 },
                 runtime: {
                     OnInstalledReason: { CHROME_UPDATE: 'chrome_update', INSTALL: 'install', SHARED_MODULE_UPDATE: 'shared_module_update', UPDATE: 'update' },
@@ -401,14 +401,14 @@ async function pageController({ browser, page, proxy, turnstile, xvfbsession, pi
                     PlatformNaclArch: { ARM: 'arm', MIPS: 'mips', MIPS64: 'mips64', X86_32: 'x86-32', X86_64: 'x86-64' },
                     PlatformOs: { ANDROID: 'android', CROS: 'cros', FUCHSIA: 'fuchsia', LINUX: 'linux', MAC: 'mac', OPENBSD: 'openbsd', WIN: 'win' },
                     RequestUpdateCheckStatus: { NO_UPDATE: 'no_update', THROTTLED: 'throttled', UPDATE_AVAILABLE: 'update_available' },
-                    connect: function() { return { name: '', sender: undefined, onDisconnect: { addListener: function() {} }, onMessage: { addListener: function() {} }, postMessage: function() {}, disconnect: function() {} }; },
-                    sendMessage: function() {},
+                    connect: function () { return { name: '', sender: undefined, onDisconnect: { addListener: function () { } }, onMessage: { addListener: function () { } }, postMessage: function () { }, disconnect: function () { } }; },
+                    sendMessage: function () { },
                     id: undefined
                 },
-                csi: function() {
+                csi: function () {
                     return { startE: Date.now(), onloadT: Date.now(), pageT: Math.floor(Math.random() * 1000) + 500, tran: 15 };
                 },
-                loadTimes: function() {
+                loadTimes: function () {
                     return {
                         requestTime: Date.now() / 1000 - Math.random() * 2,
                         startLoadTime: Date.now() / 1000 - Math.random(),
@@ -426,21 +426,21 @@ async function pageController({ browser, page, proxy, turnstile, xvfbsession, pi
                     };
                 }
             };
-            
+
             const makeNative = (fn, name) => {
-                Object.defineProperty(fn, 'toString', { value: function() { return 'function ' + name + '() { [native code] }'; } });
+                Object.defineProperty(fn, 'toString', { value: function () { return 'function ' + name + '() { [native code] }'; } });
                 return fn;
             };
             chromeObj.csi = makeNative(chromeObj.csi, 'csi');
             chromeObj.loadTimes = makeNative(chromeObj.loadTimes, 'loadTimes');
-            
+
             if (!window.chrome) {
                 Object.defineProperty(window, 'chrome', { value: chromeObj, writable: true, enumerable: true, configurable: true });
             } else {
                 Object.keys(chromeObj).forEach(key => { if (!window.chrome[key]) window.chrome[key] = chromeObj[key]; });
             }
         })();
-        
+
         // ========== NATIVE DIALOGS FIX (MUST BE FIRST) ==========
         // Fix alert, confirm, prompt to pass SannySoft detection
         (function () {

package/lib/esm/module/pageController.mjs

@@ -58,7 +58,7 @@ export async function pageController({ browser, page, proxy, turnstile, xvfbsess
                             url.includes('track');
                         if (isAdPopup) {
                             await newPage.close().catch(() => { });
-                            console.log('[popup-blocker] Blocked popup ad:', url.substring(0, 50));
+                            console.error('[popup-blocker] Blocked popup ad:', url.substring(0, 50));
                         }
                     }
                 }
@@ -333,7 +333,7 @@ export async function pageController({ browser, page, proxy, turnstile, xvfbsess
             get: () => 8,
             configurable: true
         });
-        
+
         // Device memory should be 4, 8, or 16 GB
         if ('deviceMemory' in navigator) {
             Object.defineProperty(navigator, 'deviceMemory', {
@@ -341,7 +341,7 @@ export async function pageController({ browser, page, proxy, turnstile, xvfbsess
                 configurable: true
             });
         }
-        
+
         // ========== NOTIFICATION PERMISSION FIX ==========
         if (typeof Notification !== 'undefined') {
             Object.defineProperty(Notification, 'permission', {
@@ -349,11 +349,11 @@ export async function pageController({ browser, page, proxy, turnstile, xvfbsess
                 configurable: true
             });
         }
-        
+
         // ========== DOCUMENT FOCUS FIX ==========
         const originalHasFocus = document.hasFocus.bind(document);
-        document.hasFocus = function() { return true; };
-        
+        document.hasFocus = function () { return true; };
+
         // ========== CONNECTION API FIX ==========
         if (!navigator.connection) {
             Object.defineProperty(navigator, 'connection', {
@@ -363,14 +363,14 @@ export async function pageController({ browser, page, proxy, turnstile, xvfbsess
                     effectiveType: '4g',
                     saveData: false,
                     type: 'wifi',
-                    addEventListener: function() {},
-                    removeEventListener: function() {},
-                    dispatchEvent: function() { return true; }
+                    addEventListener: function () { },
+                    removeEventListener: function () { },
+                    dispatchEvent: function () { return true; }
                 }),
                 configurable: true
             });
         }
-        
+
         // ========== PERFORMANCE MEMORY FIX ==========
         if (window.performance && !performance.memory) {
             Object.defineProperty(performance, 'memory', {
@@ -382,17 +382,17 @@ export async function pageController({ browser, page, proxy, turnstile, xvfbsess
                 configurable: true
             });
         }
-        
+
         // ========== CHROME RUNTIME FIX (Critical for CreepJS) ==========
-        (function() {
+        (function () {
             const chromeObj = {
                 app: {
                     isInstalled: false,
                     InstallState: { DISABLED: 'disabled', INSTALLED: 'installed', NOT_INSTALLED: 'not_installed' },
                     RunningState: { CANNOT_RUN: 'cannot_run', READY_TO_RUN: 'ready_to_run', RUNNING: 'running' },
-                    getDetails: function() { return null; },
-                    getIsInstalled: function() { return false; },
-                    runningState: function() { return 'cannot_run'; }
+                    getDetails: function () { return null; },
+                    getIsInstalled: function () { return false; },
+                    runningState: function () { return 'cannot_run'; }
                 },
                 runtime: {
                     OnInstalledReason: { CHROME_UPDATE: 'chrome_update', INSTALL: 'install', SHARED_MODULE_UPDATE: 'shared_module_update', UPDATE: 'update' },
@@ -401,14 +401,14 @@ export async function pageController({ browser, page, proxy, turnstile, xvfbsess
                     PlatformNaclArch: { ARM: 'arm', MIPS: 'mips', MIPS64: 'mips64', X86_32: 'x86-32', X86_64: 'x86-64' },
                     PlatformOs: { ANDROID: 'android', CROS: 'cros', FUCHSIA: 'fuchsia', LINUX: 'linux', MAC: 'mac', OPENBSD: 'openbsd', WIN: 'win' },
                     RequestUpdateCheckStatus: { NO_UPDATE: 'no_update', THROTTLED: 'throttled', UPDATE_AVAILABLE: 'update_available' },
-                    connect: function() { return { name: '', sender: undefined, onDisconnect: { addListener: function() {} }, onMessage: { addListener: function() {} }, postMessage: function() {}, disconnect: function() {} }; },
-                    sendMessage: function() {},
+                    connect: function () { return { name: '', sender: undefined, onDisconnect: { addListener: function () { } }, onMessage: { addListener: function () { } }, postMessage: function () { }, disconnect: function () { } }; },
+                    sendMessage: function () { },
                     id: undefined
                 },
-                csi: function() {
+                csi: function () {
                     return { startE: Date.now(), onloadT: Date.now(), pageT: Math.floor(Math.random() * 1000) + 500, tran: 15 };
                 },
-                loadTimes: function() {
+                loadTimes: function () {
                     return {
                         requestTime: Date.now() / 1000 - Math.random() * 2,
                         startLoadTime: Date.now() / 1000 - Math.random(),
@@ -426,21 +426,21 @@ export async function pageController({ browser, page, proxy, turnstile, xvfbsess
                     };
                 }
             };
-            
+
             const makeNative = (fn, name) => {
-                Object.defineProperty(fn, 'toString', { value: function() { return 'function ' + name + '() { [native code] }'; } });
+                Object.defineProperty(fn, 'toString', { value: function () { return 'function ' + name + '() { [native code] }'; } });
                 return fn;
             };
             chromeObj.csi = makeNative(chromeObj.csi, 'csi');
             chromeObj.loadTimes = makeNative(chromeObj.loadTimes, 'loadTimes');
-            
+
             if (!window.chrome) {
                 Object.defineProperty(window, 'chrome', { value: chromeObj, writable: true, enumerable: true, configurable: true });
             } else {
                 Object.keys(chromeObj).forEach(key => { if (!window.chrome[key]) window.chrome[key] = chromeObj[key]; });
             }
         })();
-        
+
         // ========== NATIVE DIALOGS FIX (MUST BE FIRST) ==========
         // Fix alert, confirm, prompt to pass SannySoft detection
         (function () {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-real-browser-mcp-server",
-  "version": "2.43.22",
+  "version": "2.43.24",
   "description": "MCP Server for Brave Real Browser - Puppeteer with Brave Browser, Stealth Mode, Ad Blocker, and Turnstile Auto-Solver for undetectable web automation.",
   "main": "lib/cjs/index.js",
   "module": "lib/esm/index.mjs",
@@ -74,7 +74,7 @@
   "license": "ISC",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.3",
-    "brave-real-puppeteer-core": "^24.37.3-brave.6",
+    "brave-real-puppeteer-core": "^24.37.3-brave.8",
     "ghost-cursor": "^1.4.2",
     "puppeteer-extra": "^3.3.6",
     "puppeteer-extra-plugin-stealth": "^2.11.2",

package/packages/brave-real-blocker/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-real-blocker",
-  "version": "1.19.23",
+  "version": "1.19.25",
   "description": "Advanced uBlock Origin management and stealth features for Brave Real Browser",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -56,7 +56,7 @@
     "@cliqz/adblocker-puppeteer": "^1.34.0",
     "@ghostery/adblocker-puppeteer": "^2.14.1",
     "adm-zip": "^0.5.10",
-    "brave-real-puppeteer-core": "^24.37.3-brave.6",
+    "brave-real-puppeteer-core": "^24.37.3-brave.8",
     "cross-fetch": "^4.1.0",
     "fs-extra": "^11.3.3",
     "got": "^13.0.0"

package/packages/brave-real-launcher/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-real-launcher",
-  "version": "1.25.22",
+  "version": "1.25.24",
   "description": "Launch Brave Browser with ease from node. Based on chrome-launcher with Brave-specific support.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -54,7 +54,7 @@
     "typescript": "^5.0.0"
   },
   "dependencies": {
-    "brave-real-blocker": "^1.19.23",
+    "brave-real-blocker": "^1.19.25",
     "escape-string-regexp": "^5.0.0",
     "is-wsl": "^3.1.1",
     "which": "^6.0.1"

package/packages/brave-real-playwright-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-real-playwright-core",
-  "version": "1.61.22",
+  "version": "1.61.24",
   "description": "Brave-optimized Playwright Core (v1.57.0) with comprehensive stealth patches and error stack sanitization",
   "keywords": [
     "playwright",

package/packages/brave-real-puppeteer-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-real-puppeteer-core",
-  "version": "24.37.3-brave.6",
+  "version": "24.37.3-brave.8",
   "description": "🦁 Brave Real-World Optimized Puppeteer & Playwright Core with 1-5ms ultra-fast timing, 50+ professional stealth features, intelligent browser auto-detection, and 100% bot detection bypass. Features cross-platform Brave browser integration, comprehensive anti-detection, and breakthrough performance improvements.",
   "keywords": [
     "automation",
@@ -135,7 +135,7 @@
   },
   "dependencies": {
     "@puppeteer/browsers": "2.12.1",
-    "brave-real-launcher": "^1.25.22",
+    "brave-real-launcher": "^1.25.24",
     "chromium-bidi": "14.0.0",
     "debug": "^4.4.3",
     "devtools-protocol": "0.0.1566079",

package/src/mcp/handlers.js

@@ -17,6 +17,7 @@ const ocr = require('../../lib/ocr-captcha-solver');
 let browserInstance = null;
 let pageInstance = null;
 let blockerInstance = null;
+let setupPageFn = null; // CDP early injection function
 let networkRecords = [];
 let isRecordingNetwork = false;
 let progressTasks = {};
@@ -249,14 +250,14 @@ const handlers = {
         // Selectors for common modal close buttons
         const closeSelectors = [
           // Bootstrap/Standard Modals
-          '.modal.show .btn-close', 
-          '.modal.show .close', 
+          '.modal.show .btn-close',
+          '.modal.show .close',
           '.modal.in .close',
           '.modal-footer .btn-primary', // "OK" button usually
           '.modal-footer .btn-secondary', // "Close" button
           // Custom Overlays
-          '#modal-close', 
-          '.popup-close', 
+          '#modal-close',
+          '.popup-close',
           '.overlay-close',
           // Generic "X" buttons in overlays
           'div[role="dialog"] button[aria-label="Close"]',
@@ -563,6 +564,7 @@ const handlers = {
     browserInstance = result.browser;
     pageInstance = result.page;
     blockerInstance = result.blocker;
+    setupPageFn = result.setupPage; // Store CDP early injection function
 
     // ═══════════════════════════════════════════════════════════════
     // GLOBAL DIALOG HANDLER - Auto-handle dialogs
@@ -571,19 +573,19 @@ const handlers = {
     pageInstance.on('dialog', async (dialog) => {
       const dialogType = dialog.type();
       const msg = dialog.message().toLowerCase();
-      
-      notifyProgress('browser_init', 'progress', 
+
+      notifyProgress('browser_init', 'progress',
         `🔔 Handling dialog: ${dialogType} - ${dialog.message().substring(0, 100)}...`);
-      
+
       try {
         // Critical Fix: BLOCK redirects to external sites (e.g., eCommittee)
         // These redirects take the user away from the search page
         if (msg.includes('redirect') || msg.includes('external') || msg.includes('leaving')) {
-           console.log('🚫 Blocking redirect dialog (Dismiss)');
-           await dialog.dismiss(); // Simulate clicking 'Cancel'
+          console.error('🚫 Blocking redirect dialog (Dismiss)');
+          await dialog.dismiss(); // Simulate clicking 'Cancel'
         } else {
-           // Auto-accept other dialogs (like alerts or simple confirmations)
-           await dialog.accept(); // Simulate clicking 'OK'
+          // Auto-accept other dialogs (like alerts or simple confirmations)
+          await dialog.accept(); // Simulate clicking 'OK'
         }
       } catch (e) {
         // Ignore errors (dialog might be closed by injected script)
@@ -598,7 +600,7 @@ const handlers = {
     await pageInstance.evaluateOnNewDocument(() => {
       window.originalConfirm = window.confirm;
       window.originalAlert = window.alert;
-      
+
       // Smart Confirm Handler
       window.confirm = (msg) => {
         console.log('Intercepted Confirm Dialog:', msg);
@@ -608,13 +610,13 @@ const handlers = {
         }
         return true; // Return TRUE = Click OK
       };
-      
+
       // Silently ignore alerts (always OK)
       window.alert = (msg) => {
         console.log('Blocked Alert Dialog:', msg);
         return true;
       };
-      
+
       // Silently return null for prompts
       window.prompt = (msg) => {
         console.log('Blocked Prompt Dialog:', msg);
@@ -646,6 +648,24 @@ const handlers = {
 
     notifyProgress('navigate', 'started', `Navigating to: ${url}`);
 
+    // ═══════════════════════════════════════════════════════════════
+    // CDP EARLY INJECTION - Setup BEFORE navigation for better ad blocking
+    // This ensures CSS and scripts are injected before page scripts run
+    // ═══════════════════════════════════════════════════════════════
+    console.error('[Navigate] setupPageFn available:', !!setupPageFn);
+    if (setupPageFn) {
+      try {
+        await setupPageFn(page);
+        notifyProgress('navigate', 'progress', 'CDP early injection setup complete');
+        console.error('[Navigate] CDP early injection SUCCESS');
+      } catch (e) {
+        // Non-critical error, continue navigation
+        console.error('[Navigate] CDP early injection failed:', e.message);
+      }
+    } else {
+      console.error('[Navigate] No setupPageFn available - CDP early injection skipped');
+    }
+
     let lastError = null;
 
     for (let attempt = 0; attempt <= retries; attempt++) {
@@ -796,11 +816,11 @@ const handlers = {
   // 5. Click (ENHANCED: iframe + hover + auto video player detection)
   async click(params) {
     const { page } = requireBrowser();
-    const { 
-      selector, 
-      humanLike = true, 
-      clickCount = 1, 
-      delay = 0, 
+    const {
+      selector,
+      humanLike = true,
+      clickCount = 1,
+      delay = 0,
       autoAcceptDialogs = true,
       retries = 3,
       timeout = 60000,
@@ -834,17 +854,17 @@ const handlers = {
     // ═══════════════════════════════════════════════════════════════
     if (autoDetectPlayer) {
       notifyProgress('click', 'progress', '🔍 Scanning all iframes for video players...');
-      
+
       const frames = page.frames();
-      
+
       for (let i = 0; i < frames.length; i++) {
         try {
           const frame = frames[i];
           const frameUrl = frame.url();
-          
+
           // Skip blank frames
           if (frameUrl === 'about:blank' || !frameUrl) continue;
-          
+
           // Detect player in this frame
           const playerInfo = await frame.evaluate(() => {
             const result = {
@@ -855,7 +875,7 @@ const handlers = {
               controls: [],
               downloadButton: null
             };
-            
+
             // Check for video element
             const video = document.querySelector('video');
             if (video) {
@@ -867,7 +887,7 @@ const handlers = {
                 readyState: video.readyState
               };
             }
-            
+
             // 1. JWPlayer Detection
             if (window.jwplayer && typeof window.jwplayer === 'function') {
               try {
@@ -877,49 +897,49 @@ const handlers = {
                   result.playerType = 'jwplayer';
                   result.playerState = jw.getState();
                   result.controls.push('.jw-icon-display', '.jw-icon-playback', '[aria-label="Play"]');
-                  
+
                   // Find download button in JWPlayer
                   const dlBtn = document.querySelector('[aria-label="Download"], .jw-icon-download, [class*="download"]');
                   if (dlBtn) result.downloadButton = '[aria-label="Download"]';
                 }
-              } catch (e) {}
+              } catch (e) { }
             }
-            
+
             // 2. VideoJS Detection
             if (window.videojs || document.querySelector('.video-js')) {
               result.hasPlayer = true;
               result.playerType = result.playerType || 'videojs';
               result.controls.push('.vjs-big-play-button', '.vjs-play-control');
             }
-            
+
             // 3. Plyr Detection
             if (window.Plyr || document.querySelector('.plyr')) {
               result.hasPlayer = true;
               result.playerType = result.playerType || 'plyr';
               result.controls.push('.plyr__control--play', '[data-plyr="play"]');
             }
-            
+
             // 4. VidStack Detection
             if (window.VidStack || document.querySelector('media-player')) {
               result.hasPlayer = true;
               result.playerType = result.playerType || 'vidstack';
               result.controls.push('media-play-button', '[data-media-play]');
             }
-            
+
             // 5. DooPlayer Detection
             if (window.DooPlay || document.querySelector('#dooplay') || document.querySelector('.dooplay')) {
               result.hasPlayer = true;
               result.playerType = result.playerType || 'dooplayer';
               result.controls.push('.play-btn', '.dooplay-play');
             }
-            
+
             // 6. Generic HTML5 Video
             if (result.hasVideo && !result.hasPlayer) {
               result.hasPlayer = true;
               result.playerType = 'html5';
               result.controls.push('video');
             }
-            
+
             // Find any download button
             if (!result.downloadButton) {
               const dlSelectors = [
@@ -934,14 +954,14 @@ const handlers = {
                 }
               }
             }
-            
+
             return result;
           }).catch(() => ({ hasPlayer: false }));
-          
+
           if (playerInfo.hasPlayer) {
             context = frame;
-            frameInfo = { 
-              index: i, 
+            frameInfo = {
+              index: i,
               url: frameUrl,
               autoDetected: true
             };
@@ -951,8 +971,8 @@ const handlers = {
               controls: playerInfo.controls,
               downloadButton: playerInfo.downloadButton
             };
-            
-            notifyProgress('click', 'progress', 
+
+            notifyProgress('click', 'progress',
               `✅ Found ${playerInfo.playerType.toUpperCase()} in iframe ${i}: ${frameUrl.substring(0, 50)}...`);
             break;
           }
@@ -961,7 +981,7 @@ const handlers = {
           continue;
         }
       }
-      
+
       if (!detectedPlayer) {
         notifyProgress('click', 'progress', '⚠️ No video player found in any iframe, using main page');
       }
@@ -971,7 +991,7 @@ const handlers = {
     if (!autoDetectPlayer && (iframe !== undefined || iframeSelector)) {
       try {
         const frames = page.frames();
-        
+
         if (iframe !== undefined && frames[iframe]) {
           context = frames[iframe];
           frameInfo = { index: iframe, url: frames[iframe].url() };
@@ -1020,10 +1040,10 @@ const handlers = {
       // ═══════════════════════════════════════════════════════════════
       if (usePlayerAPI && detectedPlayer && (selector === 'video' || selector.includes('play') || selector.includes('Play'))) {
         notifyProgress('click', 'progress', `🎬 Using ${detectedPlayer.type} API for playback...`);
-        
+
         playerResult = await context.evaluate((playerType) => {
           const result = { success: false, method: null, state: null };
-          
+
           try {
             if (playerType === 'jwplayer' && window.jwplayer) {
               const jw = window.jwplayer();
@@ -1059,20 +1079,20 @@ const handlers = {
           } catch (e) {
             result.error = e.message;
           }
-          
+
           return result;
         }, detectedPlayer.type).catch(e => ({ success: false, error: e.message }));
-        
+
         if (playerResult.success) {
           notifyProgress('click', 'progress', `✅ ${playerResult.method} executed`);
-          
+
           // Wait for play if requested
           if (waitForPlay) {
             notifyProgress('click', 'progress', '⏳ Waiting for video to start playing...');
-            
+
             const startTime = Date.now();
             let isPlaying = false;
-            
+
             while (Date.now() - startTime < playerTimeout) {
               const state = await context.evaluate(() => {
                 const video = document.querySelector('video');
@@ -1089,21 +1109,21 @@ const handlers = {
                 }
                 return { playing: false };
               }).catch(() => ({ playing: false }));
-              
+
               if (state.playing || state.currentTime > 0) {
                 isPlaying = true;
                 notifyProgress('click', 'progress', `▶️ Video is now playing (${state.currentTime?.toFixed(1) || 0}s)`);
                 break;
               }
-              
+
               await new Promise(r => setTimeout(r, 500));
             }
-            
+
             if (!isPlaying) {
               notifyProgress('click', 'progress', '⚠️ Video may still be buffering');
             }
           }
-          
+
           notifyProgress('click', 'completed', `Video playback started via ${playerResult.method}`, {
             selector,
             clicked: true,
@@ -1112,7 +1132,7 @@ const handlers = {
             iframe: frameInfo,
             playerResult
           });
-          
+
           return {
             success: true,
             selector,
@@ -1153,7 +1173,7 @@ const handlers = {
           // HOVER functionality (for video player dynamic controls)
           if (hoverFirst || hoverOnly) {
             notifyProgress('click', 'progress', `Hovering over ${selector}...`);
-            
+
             try {
               await context.hover(selector);
               notifyProgress('click', 'progress', `Hover successful, waiting ${hoverDuration}ms for controls...`);
@@ -1169,7 +1189,7 @@ const handlers = {
                 }
               }
             }
-            
+
             if (hoverOnly) {
               notifyProgress('click', 'completed', `Hover completed: ${selector}`, { selector, hovered: true, iframe: frameInfo });
               return { success: true, selector, hovered: true, clicked: false, iframe: frameInfo, detectedPlayer };
@@ -1187,7 +1207,7 @@ const handlers = {
             try {
               const { createCursor } = require('ghost-cursor');
               const cursor = createCursor(page);
-              
+
               if (context !== page) {
                 const element = await context.$(selector);
                 if (element) {
@@ -1210,19 +1230,19 @@ const handlers = {
 
           await new Promise(r => setTimeout(r, 300));
 
-          notifyProgress('click', 'completed', 
-            `${hoverFirst ? 'Hovered+' : ''}Clicked: ${selector}${dialogHandled ? ' (dialog auto-accepted)' : ''}`, 
+          notifyProgress('click', 'completed',
+            `${hoverFirst ? 'Hovered+' : ''}Clicked: ${selector}${dialogHandled ? ' (dialog auto-accepted)' : ''}`,
             { selector, humanLike, dialogHandled, iframe: frameInfo, detectedPlayer, attempts: attempt }
           );
 
-          return { 
-            success: true, 
-            selector, 
-            clicked: true, 
-            dialogHandled, 
-            iframe: frameInfo, 
+          return {
+            success: true,
+            selector,
+            clicked: true,
+            dialogHandled,
+            iframe: frameInfo,
             detectedPlayer,
-            attempts: attempt 
+            attempts: attempt
           };
 
         } catch (attemptError) {
@@ -1246,10 +1266,10 @@ const handlers = {
   // 6. Type (ENHANCED: iframe support)
   async type(params) {
     const { page } = requireBrowser();
-    const { 
-      selector, 
-      text, 
-      delay = 50, 
+    const {
+      selector,
+      text,
+      delay = 50,
       clear = false,
       // NEW: iframe support
       iframe,
@@ -1268,7 +1288,7 @@ const handlers = {
     if (iframe !== undefined || iframeSelector) {
       try {
         const frames = page.frames();
-        
+
         if (iframe !== undefined && frames[iframe]) {
           context = frames[iframe];
           frameInfo = { index: iframe, url: frames[iframe].url() };
@@ -1345,6 +1365,7 @@ const handlers = {
       browserInstance = null;
       pageInstance = null;
       blockerInstance = null;
+      setupPageFn = null;
     }
 
     notifyProgress('browser_close', 'completed', 'Browser closed');
@@ -2752,8 +2773,8 @@ const handlers = {
   // 26. Execute JS (ENHANCED: iframe context support - FIXED)
   async execute_js(params) {
     const { page } = requireBrowser();
-    const { 
-      code, 
+    const {
+      code,
       returnValue = true,
       // NEW: iframe support (FIXED)
       iframe,
@@ -2771,7 +2792,7 @@ const handlers = {
     if (iframe !== undefined || iframeSelector) {
       try {
         const frames = page.frames();
-        
+
         if (iframe !== undefined) {
           // iframe index provided
           if (iframe === 0) {
@@ -2820,9 +2841,9 @@ const handlers = {
       // Execute the code in the correct context
       const result = await context.evaluate(code);
 
-      notifyProgress('execute_js', 'completed', 'JavaScript executed', { 
-        hasResult: result !== undefined, 
-        iframe: frameInfo 
+      notifyProgress('execute_js', 'completed', 'JavaScript executed', {
+        hasResult: result !== undefined,
+        iframe: frameInfo
       });
 
       return { success: true, result: returnValue ? result : undefined, iframe: frameInfo };
@@ -4227,6 +4248,7 @@ async function cleanup() {
     browserInstance = null;
     pageInstance = null;
     blockerInstance = null;
+    setupPageFn = null;
   }
 }