real-browser-mcp-server 1.3.3 → 1.4.0

package/src/shared/tools.js

@@ -1,618 +0,0 @@
-/**
- * Brave Real Browser MCP Server - Shared Tool Definitions
- * 
- * OPTIMIZED: 22 tools (merged from 28)
- * 
- * Merges Applied:
- * - iframe_handler + stream_extractor + player_api_hook → media_extractor
- * - get_content + js_scrape → get_content (enhanced)
- * - search_regex + extract_json + scrape_meta_tags → extract_data
- * - solve_captcha + form_automator → solve_captcha (enhanced)
- * 
- * New Features:
- * - URL/Base64/AES Decoders built into media_extractor
- * - AI Auto-Healing Selectors
- * - Smart Retry Mechanisms
- * - Batch Operations
- */
-
-const TOOLS = [
-  // 1. Browser Init
-  {
-    name: 'browser_init',
-    emoji: '🚀',
-    description: 'Initialize Brave browser with stealth, anti-detection, and AI healing',
-    descriptionHindi: 'ब्राउज़र शुरू करना (stealth + AI healing)',
-    category: 'browser',
-    requiresBrowser: false,
-    requiresPage: false,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        headless: { type: 'boolean', default: false },
-        proxy: {
-          type: 'object',
-          properties: {
-            host: { type: 'string' },
-            port: { type: 'number' },
-            username: { type: 'string' },
-            password: { type: 'string' }
-          }
-        },
-        turnstile: { type: 'boolean', default: true, description: 'Auto-solve Cloudflare Turnstile' },
-        enableBlocker: { type: 'boolean', default: true, description: 'Block ads and trackers' },
-        aiHealing: { type: 'boolean', default: true, description: 'Enable AI auto-healing for broken selectors' }
-      }
-    }
-  },
-
-  // 2. Navigate
-  {
-    name: 'navigate',
-    emoji: '🧭',
-    description: 'Navigate to URL with smart retry, context recovery, and AI healing',
-    descriptionHindi: 'URL पर जाना (smart retry + recovery)',
-    category: 'navigation',
-    requiresBrowser: true,
-    requiresPage: false,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        url: { type: 'string' },
-        waitUntil: { type: 'string', enum: ['load', 'domcontentloaded', 'networkidle0', 'networkidle2'], default: 'networkidle2' },
-        timeout: { type: 'number', default: 30000 },
-        retries: { type: 'number', default: 3, description: 'Auto-retry on failures' },
-        smartWait: { type: 'boolean', default: true, description: 'AI-powered smart waiting' }
-      },
-      required: ['url']
-    }
-  },
-
-  // 3. Get Content (MERGED: get_content + js_scrape)
-  {
-    name: 'get_content',
-    emoji: '📄',
-    description: 'Get page content in multiple formats: html (full HTML), text (plain text), markdown (formatted MD), rawHttp (raw HTTP response without JS rendering - fast, no browser needed, bypasses JS protections). Supports CSS selector targeting, AI auto-healing for broken selectors, JS wait, and attribute extraction.',
-    descriptionHindi: 'पेज का कंटेंट लेना — formats: html/text/markdown/rawHttp। rawHttp mode बिना JS के raw HTML fetch करता है। AI healing + selector targeting।',
-    category: 'extraction',
-    requiresBrowser: true,
-    requiresPage: true,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        format: { type: 'string', enum: ['html', 'text', 'markdown', 'rawHttp'], default: 'text' },
-        selector: { type: 'string', description: 'CSS selector (AI will auto-heal if broken)' },
-        waitForJS: { type: 'boolean', default: true, description: 'Wait for JavaScript to render' },
-        timeout: { type: 'number', default: 10000 },
-        aiHeal: { type: 'boolean', default: true, description: 'Auto-fix broken selectors' },
-        extractAttributes: { type: 'boolean', default: false, description: 'Extract all element attributes' },
-        rawHttpUrl: { type: 'string', description: 'URL to fetch raw HTTP (no JS). Defaults to current page URL if not set' }
-      }
-    }
-  },
-
-  // 4. Wait
-  {
-    name: 'wait',
-    emoji: '⏳',
-    description: 'Smart wait with AI prediction for optimal timing',
-    descriptionHindi: 'स्मार्ट इंतजार (AI prediction)',
-    category: 'utility',
-    requiresBrowser: true,
-    requiresPage: true,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        type: { type: 'string', enum: ['selector', 'navigation', 'timeout', 'networkidle', 'smart'], default: 'smart' },
-        value: { type: 'string', description: 'Selector or timeout value' },
-        timeout: { type: 'number', default: 30000 },
-        aiOptimize: { type: 'boolean', default: true, description: 'AI optimizes wait time based on page load patterns' }
-      },
-      required: ['value']
-    }
-  },
-
-  // 5. Click (ENHANCED: iframe + hover + auto video player detection)
-  {
-    name: 'click',
-    emoji: '👆',
-    description: 'Human-like click with AI healing, iframe support, hover for dynamic controls, and auto video player detection',
-    descriptionHindi: 'क्लिक करना (AI healing + iframe + auto video player detection)',
-    category: 'interaction',
-    requiresBrowser: true,
-    requiresPage: true,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        selector: { type: 'string', description: 'CSS selector (AI auto-heals if element not found)' },
-        humanLike: { type: 'boolean', default: true, description: 'Ghost cursor human movement' },
-        aiHeal: { type: 'boolean', default: true, description: 'Auto-find alternative selector if broken' },
-        autoAcceptDialogs: { type: 'boolean', default: true, description: 'Auto-accept alerts/confirms to prevent blocking' },
-        retries: { type: 'number', default: 3, description: 'Auto-retry on failure' },
-        clickCount: { type: 'number', default: 1 },
-        delay: { type: 'number', default: 0 },
-        timeout: { type: 'number', default: 60000, description: 'Timeout for element to appear' },
-        // Hover support for video player dynamic controls
-        hoverFirst: { type: 'boolean', default: false, description: 'Hover before click (for dynamic controls like video players)' },
-        hoverOnly: { type: 'boolean', default: false, description: 'Only hover, do not click (to reveal hidden controls)' },
-        hoverDuration: { type: 'number', default: 500, description: 'Wait time after hover before click (ms)' },
-        // iframe support
-        iframe: { type: 'number', description: 'Execute in specific iframe index (use media_extractor list_iframes to get index)' },
-        iframeSelector: { type: 'string', description: 'Alternative: iframe CSS selector instead of index' },
-        // Scroll into view
-        scrollIntoView: { type: 'boolean', default: true, description: 'Auto-scroll element into view before click' },
-        forceClick: { type: 'boolean', default: false, description: 'Force click even if element not visible (use JS click)' },
-        // NEW: Auto Video Player Detection & Control
-        autoDetectPlayer: { type: 'boolean', default: false, description: 'Auto-detect video player iframe (JWPlayer, VideoJS, Plyr, VidStack, DooPlayer)' },
-        usePlayerAPI: { type: 'boolean', default: true, description: 'Use player API (jwplayer.play()) instead of DOM click for reliable playback' },
-        waitForPlay: { type: 'boolean', default: false, description: 'Wait until video actually starts playing' },
-        playerTimeout: { type: 'number', default: 15000, description: 'Max wait time for video to start playing (ms)' }
-      },
-      required: ['selector']
-    }
-  },
-
-  // 6. Type (ENHANCED: iframe support)
-  {
-    name: 'type',
-    emoji: '⌨️',
-    description: 'Type text with human speed variation, smart clearing, and iframe support',
-    descriptionHindi: 'टेक्स्ट टाइप करना (human speed + iframe support)',
-    category: 'interaction',
-    requiresBrowser: true,
-    requiresPage: true,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        selector: { type: 'string' },
-        text: { type: 'string' },
-        delay: { type: 'number', default: 50, description: 'Keystroke delay with natural variation' },
-        clear: { type: 'boolean', default: true },
-        aiHeal: { type: 'boolean', default: true },
-        // NEW: iframe support
-        iframe: { type: 'number', description: 'Execute in specific iframe index' },
-        iframeSelector: { type: 'string', description: 'Alternative: iframe CSS selector' },
-        // NEW: Additional options
-        pressEnter: { type: 'boolean', default: false, description: 'Press Enter after typing' },
-        waitForSelector: { type: 'boolean', default: true, description: 'Wait for selector before typing' }
-      },
-      required: ['selector', 'text']
-    }
-  },
-
-  // 7. Browser Close
-  {
-    name: 'browser_close',
-    emoji: '🔴',
-    description: 'Close browser with cleanup and session save',
-    descriptionHindi: 'ब्राउज़र बंद करना',
-    category: 'browser',
-    requiresBrowser: true,
-    requiresPage: false,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        force: { type: 'boolean', default: false },
-        saveSession: { type: 'boolean', default: false, description: 'Save cookies and storage for next session' }
-      }
-    }
-  },
-
-  // 8. Solve Captcha (MERGED with form_automator - Enhanced with OCR + Form Automation)
-  {
-    name: 'solve_captcha',
-    emoji: '🔓',
-    description: 'Auto-solve CAPTCHA with AI + Smart Form Automation (Turnstile, reCAPTCHA, hCaptcha, Text/Image OCR)',
-    descriptionHindi: 'CAPTCHA हल करना + फॉर्म भरना (AI + OCR powered)',
-    category: 'interaction',
-    requiresBrowser: true,
-    requiresPage: true,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        // === CAPTCHA OPTIONS ===
-        type: {
-          type: 'string',
-          enum: ['turnstile', 'recaptcha', 'hcaptcha', 'text', 'image', 'auto'],
-          default: 'auto',
-          description: 'Captcha type: turnstile/recaptcha/hcaptcha (JS-based), text/image (OCR-based), auto (detect)'
-        },
-        timeout: { type: 'number', default: 30000 },
-        aiMode: { type: 'boolean', default: true, description: 'Use AI vision for complex CAPTCHAs' },
-        captchaSelector: { type: 'string', description: 'CSS selector for captcha image (required for text/image type)' },
-        inputSelector: { type: 'string', description: 'CSS selector for input field to fill result' },
-        refreshSelector: { type: 'string', description: 'CSS selector for captcha refresh button' },
-        lang: { type: 'string', default: 'eng', description: 'OCR language: eng, hin, eng+hin' },
-        expectedLength: { type: 'number', description: 'Expected captcha text length' },
-        allowedChars: { type: 'string', description: 'Allowed characters in captcha' },
-        maxRetries: { type: 'number', default: 3, description: 'Max refresh attempts for OCR' },
-
-        // === IFRAME SUPPORT ===
-        iframe: { type: 'number', description: 'Execute in specific iframe index (use media_extractor list_iframes to get index)' },
-        iframeSelector: { type: 'string', description: 'Alternative: iframe CSS selector instead of index' },
-
-        // === FORM AUTOMATION OPTIONS (merged from form_automator) ===
-        formData: { type: 'object', description: 'Form field data to fill (AI matches fields automatically)' },
-        formSelector: { type: 'string', description: 'Form selector (AI auto-detects if not provided)' },
-        submit: { type: 'boolean', default: false, description: 'Auto-submit form after filling and captcha solving' },
-        humanLike: { type: 'boolean', default: true, description: 'Human-like typing with random delays' },
-        aiMatch: { type: 'boolean', default: true, description: 'AI matches fields even if names differ' },
-        analyzeFirst: { type: 'boolean', default: true, description: 'Analyze page structure before solving' }
-      }
-    }
-  },
-
-  // 9. Random Scroll
-  {
-    name: 'random_scroll',
-    emoji: '📜',
-    description: 'Human-like scroll with AI pattern detection',
-    descriptionHindi: 'स्क्रॉल करना (human-like + AI)',
-    category: 'interaction',
-    requiresBrowser: true,
-    requiresPage: true,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        direction: { type: 'string', enum: ['up', 'down', 'random', 'smart'], default: 'smart' },
-        amount: { type: 'number', default: 0, description: '0 = AI decides based on content' },
-        smooth: { type: 'boolean', default: true },
-        aiDetectLazyLoad: { type: 'boolean', default: true, description: 'Auto-detect lazy loading patterns' }
-      }
-    }
-  },
-
-  // 10. Find Element
-  {
-    name: 'find_element',
-    emoji: '🔍',
-    description: 'Find elements with AI-powered selector healing and smart search',
-    descriptionHindi: 'एलीमेंट खोजना (AI healing)',
-    category: 'extraction',
-    requiresBrowser: true,
-    requiresPage: true,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        selector: { type: 'string', description: 'CSS selector (AI heals if broken)' },
-        xpath: { type: 'string', description: 'XPath alternative' },
-        text: { type: 'string', description: 'Find by text content' },
-        multiple: { type: 'boolean', default: false },
-        aiHeal: { type: 'boolean', default: true, description: 'Auto-find alternatives if selector fails' },
-        smartAttributes: { type: 'boolean', default: true, description: 'Extract smart element attributes' }
-      }
-    }
-  },
-
-  // 11. Save Content as Markdown
-  {
-    name: 'save_content_as_markdown',
-    emoji: '📝',
-    description: 'Save page content with AI-enhanced formatting',
-    descriptionHindi: 'कंटेंट MD में सेव करना (AI-enhanced)',
-    category: 'extraction',
-    requiresBrowser: true,
-    requiresPage: true,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        filename: { type: 'string' },
-        selector: { type: 'string' },
-        includeImages: { type: 'boolean', default: true },
-        includeMeta: { type: 'boolean', default: true },
-        aiClean: { type: 'boolean', default: true, description: 'AI removes ads and clutter' }
-      },
-      required: ['filename']
-    }
-  },
-
-  // 12. Redirect Tracer
-  {
-    name: 'redirect_tracer',
-    emoji: '🔀',
-    description: 'Trace complete redirect chains including HTTP 301/302 redirects, JavaScript-based navigations (window.location, setTimeout redirects), and meta refresh tags. Auto-decodes encoded URLs in the chain. Returns full redirect path with status codes and headers.',
-    descriptionHindi: 'पूरी redirect chain ट्रेस — HTTP 301/302 + JS navigation + meta refresh। Auto URL decode।',
-    category: 'network',
-    requiresBrowser: true,
-    requiresPage: false,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        url: { type: 'string' },
-        maxRedirects: { type: 'number', default: 20 },
-        includeHeaders: { type: 'boolean', default: false },
-        followJS: { type: 'boolean', default: true, description: 'Track JS navigations' },
-        followMeta: { type: 'boolean', default: true, description: 'Track meta refresh redirects' },
-        decodeURLs: { type: 'boolean', default: true, description: 'Auto-decode encoded URLs in chain' }
-      },
-      required: ['url']
-    }
-  },
-
-  // 13. Extract Data (MERGED: search_regex + extract_json + scrape_meta_tags + POWER FEATURES)
-  {
-    name: 'extract_data',
-    emoji: '🔎',
-    description: 'Universal data extractor with 8 modes: (1) regex - pattern matching with flags, (2) json - JSON path extraction, (3) meta - HTML meta tags + Open Graph + Twitter Cards, (4) structured - CSS selector-based extraction, (5) auto - AI picks best method, (6) deobfuscate - decode obfuscated JS: _0x string arrays, hex strings, unicode escapes, eval unpacker, webpack modules, terser single-letter mappings, string concatenation resolver ("htt"+"ps://" → "https://"), array rotation detection, (7) apiDiscovery - find hidden API endpoints via runtime fetch/XHR interception + static analysis of scripts, (8) decrypt - auto-decode encrypted data: recursive Base64 chain (5 levels), hex, URL decode, ROT13, AES-256-CBC with auto key extraction from CryptoJS patterns in page scripts.',
-    descriptionHindi: 'यूनिवर्सल डेटा एक्सट्रैक्टर — 8 modes: regex, json, meta, structured, auto, deobfuscate (JS decode), apiDiscovery (hidden APIs), decrypt (Base64/hex/AES auto-decrypt)।',
-    category: 'extraction',
-    requiresBrowser: true,
-    requiresPage: true,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        type: { type: 'string', enum: ['regex', 'json', 'meta', 'structured', 'auto', 'deobfuscate', 'apiDiscovery', 'decrypt'], default: 'auto' },
-        pattern: { type: 'string', description: 'For regex: pattern to search' },
-        selector: { type: 'string', description: 'For structured: CSS selector' },
-        jsonPath: { type: 'string', description: 'For JSON: path expression' },
-        source: { type: 'string', enum: ['html', 'text', 'scripts', 'ld+json', 'api', 'all'], default: 'all' },
-        autoDecode: { type: 'boolean', default: true, description: 'Auto-decode Base64/URL in results' },
-        flags: { type: 'string', default: 'gi', description: 'Regex flags' },
-        encryptedData: { type: 'string', description: 'For decrypt: data to decode/decrypt' },
-        autoFindKey: { type: 'boolean', default: true, description: 'For decrypt: auto-extract AES keys from page scripts' },
-        aesKey: { type: 'string', description: 'For decrypt: AES decryption key' },
-        aesIV: { type: 'string', description: 'For decrypt: AES initialization vector' }
-      }
-    }
-  },
-
-  // 14. Press Key
-  {
-    name: 'press_key',
-    emoji: '🎹',
-    description: 'Press keyboard keys with human-like timing',
-    descriptionHindi: 'की प्रेस करना',
-    category: 'interaction',
-    requiresBrowser: true,
-    requiresPage: true,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        key: { type: 'string' },
-        modifiers: { type: 'array', items: { type: 'string' } },
-        count: { type: 'number', default: 1 },
-        humanDelay: { type: 'boolean', default: true, description: 'Natural delay between presses' }
-      },
-      required: ['key']
-    }
-  },
-
-  // 15. Progress Tracker
-  {
-    name: 'progress_tracker',
-    emoji: '📈',
-    description: 'Track automation progress with AI predictions',
-    descriptionHindi: 'प्रोग्रेस ट्रैक करना (AI predictions)',
-    category: 'utility',
-    requiresBrowser: false,
-    requiresPage: false,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        action: { type: 'string', enum: ['start', 'update', 'complete', 'get'], default: 'get' },
-        taskName: { type: 'string' },
-        progress: { type: 'number', description: '0-100' },
-        aiEstimate: { type: 'boolean', default: true, description: 'AI estimates remaining time' }
-      }
-    }
-  },
-
-  // 16. Deep Analysis
-  {
-    name: 'deep_analysis',
-    emoji: '🧠',
-    description: 'Deep page analysis: DOM structure, scripts, styles, accessibility, performance metrics, SEO tags, security headers, anti-bot detection (Cloudflare, DataDome, reCAPTCHA), technology stack identification, and AI-powered recommendations for scraping strategy.',
-    descriptionHindi: 'गहरा पेज विश्लेषण — DOM, scripts, anti-bot detection, tech stack, SEO, AI recommendations।',
-    category: 'analysis',
-    requiresBrowser: true,
-    requiresPage: true,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        types: { type: 'array', items: { type: 'string' }, default: ['all'] },
-        detailed: { type: 'boolean', default: true },
-        aiInsights: { type: 'boolean', default: true, description: 'AI provides recommendations' },
-        detectAntiBot: { type: 'boolean', default: true, description: 'Detect anti-bot measures' }
-      }
-    }
-  },
-
-  // 17. Network Recorder (POWER ENHANCED)
-  {
-    name: 'network_recorder',
-    emoji: '📡',
-    description: 'Record all network activity with 9 actions: (1) start - begin recording + inject pre-page-load API interceptors (monkey-patches fetch, XMLHttpRequest, navigator.sendBeacon) + WebSocket constructor interceptor, (2) stop - stop recording, (3) get - get all records with filters, (4) clear - clear all records, (5) get_media - get only video/audio/HLS/DASH stream URLs, (6) get_navigations - track JS redirects and meta refreshes, (7) get_api_calls - get all API calls with full request/response bodies (JSON, form data), (8) get_intercepted_apis - get runtime-intercepted API calls captured via monkey-patched fetch/XHR/sendBeacon (catches calls from obfuscated/webpack code), (9) get_websockets - get all WebSocket connections and messages (sent + received with timestamps). Supports filters: resourceType, urlPattern, mediaOnly.',
-    descriptionHindi: 'नेटवर्क रिकॉर्डर — 9 actions: start/stop/get/clear/get_media/get_navigations/get_api_calls/get_intercepted_apis/get_websockets। Runtime API interception + WebSocket capture।',
-    category: 'network',
-    requiresBrowser: true,
-    requiresPage: false,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        action: { type: 'string', enum: ['start', 'stop', 'get', 'clear', 'get_media', 'get_navigations', 'get_api_calls', 'get_intercepted_apis', 'get_websockets'], default: 'get' },
-        filter: {
-          type: 'object',
-          properties: {
-            resourceType: { type: 'string' },
-            urlPattern: { type: 'string' },
-            type: { type: 'string' },
-            mediaOnly: { type: 'boolean' }
-          }
-        },
-        aiDetectStreams: { type: 'boolean', default: true, description: 'AI detects video/audio streams' },
-        captureXhrBody: { type: 'boolean', default: false, description: 'Capture fetch/XHR response bodies (JSON, form-urlencoded)' }
-      }
-    }
-  },
-
-  // 18. Link Harvester
-  {
-    name: 'link_harvester',
-    emoji: '🔗',
-    description: 'Extract all links from page including hidden links (display:none, visibility:hidden), Base64/URL encoded links, obfuscated links (data attributes, JS variables), links inside iframes (multi-level), and dynamically generated links. Supports CSS selector filtering and auto-decode.',
-    descriptionHindi: 'सभी लिंक्स निकालना — hidden, encoded, obfuscated, iframe, dynamic links।',
-    category: 'extraction',
-    requiresBrowser: true,
-    requiresPage: true,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        types: { type: 'array', items: { type: 'string' }, default: ['all'] },
-        selector: { type: 'string' },
-        includeText: { type: 'boolean', default: true },
-        includeHidden: { type: 'boolean', default: true },
-        searchIframes: { type: 'boolean', default: true },
-        autoDecode: { type: 'boolean', default: true, description: 'Auto-decode Base64/URL encoded links' },
-        detectObfuscation: { type: 'boolean', default: true, description: 'Detect and bypass obfuscation' }
-      }
-    }
-  },
-
-  // 19. Cookie Manager
-  {
-    name: 'cookie_manager',
-    emoji: '🍪',
-    description: 'Smart cookie management with AI session persistence',
-    descriptionHindi: 'कुकीज़ मैनेज करना (smart)',
-    category: 'browser',
-    requiresBrowser: true,
-    requiresPage: false,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        action: { type: 'string', enum: ['get', 'set', 'delete', 'clear', 'export', 'import'], default: 'get' },
-        name: { type: 'string' },
-        value: { type: 'string' },
-        domain: { type: 'string' },
-        expires: { type: 'number' },
-        aiOptimize: { type: 'boolean', default: true, description: 'AI optimizes cookie persistence' }
-      }
-    }
-  },
-
-  // 20. File Downloader
-  {
-    name: 'file_downloader',
-    emoji: '⬇️',
-    description: 'Download files with resume, batch, and auto-decrypt support',
-    descriptionHindi: 'फाइल डाउनलोड करना (resume + batch)',
-    category: 'network',
-    requiresBrowser: true,
-    requiresPage: false,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        url: { type: 'string' },
-        filename: { type: 'string' },
-        directory: { type: 'string', default: './downloads' },
-        resume: { type: 'boolean', default: true, description: 'Resume interrupted downloads' },
-        batch: { type: 'array', items: { type: 'string' }, description: 'Multiple URLs for batch download' },
-        autoDecode: { type: 'boolean', default: true, description: 'Auto-decode Base64/URL encoded URLs' },
-        decryptKey: { type: 'string', description: 'AES key for encrypted files' }
-      }
-    }
-  },
-
-  // 21. Media Extractor (MERGED: iframe_handler + stream_extractor + player_api_hook)
-  {
-    name: 'media_extractor',
-    emoji: '🎬',
-    description: 'Universal media extractor with 6 actions: (1) extract - find all video/audio/HLS/DASH/download URLs from page + nested iframes (3+ levels deep), (2) list_iframes - list all iframes with indices, (3) switch_iframe - switch context to specific iframe, (4) player_control - control video players (JWPlayer, VideoJS, Plyr, VidStack, DooPlayer) via API: play/pause/seek/sources, (5) decode_url - decode obfuscated URLs: auto/url/base64/aes with key+IV, (6) batch_extract - extract from multiple URLs at once. Supports quality selection (best/worst/all) and deep script scanning.',
-    descriptionHindi: 'मीडिया एक्सट्रैक्टर — 6 actions: extract/list_iframes/switch_iframe/player_control/decode_url/batch_extract। Video players + iframes + decoders।',
-    category: 'extraction',
-    requiresBrowser: true,
-    requiresPage: true,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        action: {
-          type: 'string',
-          enum: ['extract', 'list_iframes', 'switch_iframe', 'player_control', 'decode_url', 'batch_extract'],
-          default: 'extract'
-        },
-        // For extraction
-        types: { type: 'array', items: { type: 'string' }, default: ['all'], description: 'video, audio, hls, dash, download, iframes' },
-        quality: { type: 'string', enum: ['best', 'worst', 'all'], default: 'best' },
-        deep: { type: 'boolean', default: true, description: 'Deep scan scripts and data attributes' },
-        searchIframes: { type: 'boolean', default: true },
-        // For iframe control
-        selector: { type: 'string', description: 'iFrame selector' },
-        index: { type: 'number', description: 'iFrame index' },
-        // For player control
-        playerAction: { type: 'string', enum: ['info', 'play', 'pause', 'seek', 'sources'], default: 'info' },
-        // For decoders
-        encodedData: { type: 'string', description: 'For decode_url action' },
-        decoderType: { type: 'string', enum: ['auto', 'url', 'base64', 'aes'], default: 'auto' },
-        aesKey: { type: 'string', description: 'AES decryption key' },
-        aesIV: { type: 'string', description: 'AES IV (optional)' },
-        // Batch operations
-        urls: { type: 'array', items: { type: 'string' }, description: 'Multiple URLs for batch extraction' },
-        aiOptimize: { type: 'boolean', default: true, description: 'AI optimizes extraction strategy' }
-      }
-    }
-  },
-
-  // 22. Execute JS (ENHANCED: iframe context fix)
-  {
-    name: 'execute_js',
-    emoji: '💻',
-    description: 'Execute custom JavaScript with async support, error handling, and iframe context',
-    descriptionHindi: 'कस्टम JS चलाना (async + iframe context support)',
-    category: 'interaction',
-    requiresBrowser: true,
-    requiresPage: true,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        code: { type: 'string' },
-        returnValue: { type: 'boolean', default: true },
-        async: { type: 'boolean', default: false, description: 'Execute async code' },
-        timeout: { type: 'number', default: 30000 },
-        // FIXED: iframe context now works properly
-        iframe: { type: 'number', description: 'Execute in specific iframe index (0=main, 1+=iframes)' },
-        iframeSelector: { type: 'string', description: 'Alternative: iframe CSS selector' },
-        waitForIframe: { type: 'boolean', default: true, description: 'Wait for iframe to be ready' }
-      },
-      required: ['code']
-    }
-  }
-];
-
-// Tool categories
-const CATEGORIES = {
-  browser: { name: 'Browser', emoji: '🌐', description: 'Browser lifecycle management' },
-  navigation: { name: 'Navigation', emoji: '🧭', description: 'Page navigation' },
-  interaction: { name: 'Interaction', emoji: '👆', description: 'User interactions' },
-  extraction: { name: 'Extraction', emoji: '📄', description: 'Content extraction and scraping' },
-  network: { name: 'Network', emoji: '📡', description: 'Network operations' },
-  analysis: { name: 'Analysis', emoji: '🧠', description: 'Page analysis' },
-  utility: { name: 'Utility', emoji: '🛠️', description: 'Utility tools' }
-};
-
-// Helper functions
-const getToolByName = (name) => TOOLS.find(t => t.name === name);
-const getToolsByCategory = (category) => TOOLS.filter(t => t.category === category);
-const getToolNames = () => TOOLS.map(t => t.name);
-const getRequiredParams = (toolName) => {
-  const tool = getToolByName(toolName);
-  return tool?.inputSchema?.required || [];
-};
-
-// Export
-const TOOL_DISPLAY = TOOLS.map(t => ({
-  name: t.name,
-  emoji: t.emoji,
-  description: t.description,
-  descriptionHindi: t.descriptionHindi,
-  category: t.category
-}));
-
-module.exports = {
-  TOOLS,
-  TOOL_DISPLAY,
-  CATEGORIES,
-  getToolByName,
-  getToolsByCategory,
-  getToolNames,
-  getRequiredParams
-};