@jshookmcp/jshook 0.1.2

package/dist/modules/browser/UnifiedBrowserManager.js

@@ -0,0 +1,217 @@
+import { BrowserModeManager } from '../browser/BrowserModeManager.js';
+import { CamoufoxBrowserManager, } from '../browser/CamoufoxBrowserManager.js';
+import { BrowserDiscovery } from '../browser/BrowserDiscovery.js';
+import { logger } from '../../utils/logger.js';
+export class UnifiedBrowserManager {
+    driver;
+    config;
+    chromeManager = null;
+    camoufoxManager = null;
+    browserDiscovery;
+    activePage = null;
+    constructor(config = {}) {
+        this.config = config;
+        this.driver = config.driver ?? 'chrome';
+        this.browserDiscovery = new BrowserDiscovery();
+    }
+    async launch() {
+        if (this.driver === 'camoufox') {
+            return this.launchCamoufox();
+        }
+        return this.launchChrome();
+    }
+    async launchChrome() {
+        logger.info(`Launching Chrome [headless=${this.config.headless ?? true}]...`);
+        const modeConfig = {
+            autoDetectCaptcha: this.config.autoDetectCaptcha,
+            autoSwitchHeadless: this.config.autoSwitchHeadless,
+            captchaTimeout: this.config.captchaTimeout,
+            defaultHeadless: this.getHeadlessBoolean(),
+        };
+        const launchOptions = {
+            headless: this.normalizeChromeHeadless(),
+            executablePath: this.config.executablePath,
+            args: this.config.args,
+        };
+        if (this.config.proxy) {
+            const proxyArgs = [`--proxy-server=${this.config.proxy.server}`];
+            launchOptions.args = [...(launchOptions.args || []), ...proxyArgs];
+        }
+        if (this.config.debugPort) {
+            launchOptions.args = [...(launchOptions.args || []), `--remote-debugging-port=${this.config.debugPort}`];
+        }
+        this.chromeManager = new BrowserModeManager(modeConfig, launchOptions);
+        const browser = await this.chromeManager.launch();
+        logger.info('Chrome browser launched successfully');
+        return browser;
+    }
+    async launchCamoufox() {
+        const headless = this.normalizeCamoufoxHeadless();
+        logger.info(`Launching Camoufox (Firefox) [os=${this.config.os ?? 'windows'}, headless=${headless}]...`);
+        const camoufoxConfig = {
+            headless,
+            os: this.config.os,
+            geoip: this.config.geoip,
+            humanize: this.config.humanize,
+            proxy: this.config.proxy,
+            blockImages: this.config.blockImages,
+            blockWebrtc: this.config.blockWebrtc,
+        };
+        this.camoufoxManager = new CamoufoxBrowserManager(camoufoxConfig);
+        const browser = await this.camoufoxManager.launch();
+        logger.info('Camoufox browser launched successfully');
+        return browser;
+    }
+    async connect(wsEndpoint) {
+        if (this.driver === 'camoufox') {
+            return this.connectCamoufox(wsEndpoint);
+        }
+        return this.connectChrome(wsEndpoint);
+    }
+    async connectChrome(wsEndpoint) {
+        logger.info(`Connecting to Chrome browser: ${wsEndpoint}`);
+        const puppeteer = await import('rebrowser-puppeteer-core');
+        const browser = await puppeteer.connect({
+            browserWSEndpoint: wsEndpoint,
+        });
+        this.chromeManager = new BrowserModeManager({}, {});
+        Reflect.set(this.chromeManager, 'browser', browser);
+        logger.info('Connected to Chrome browser successfully');
+        return browser;
+    }
+    async connectCamoufox(wsEndpoint) {
+        logger.info(`Connecting to Camoufox browser: ${wsEndpoint}`);
+        this.camoufoxManager = new CamoufoxBrowserManager({});
+        const browser = await this.camoufoxManager.connectToServer(wsEndpoint);
+        logger.info('Connected to Camoufox browser successfully');
+        return browser;
+    }
+    async newPage() {
+        if (this.driver === 'camoufox') {
+            if (!this.camoufoxManager) {
+                await this.launchCamoufox();
+            }
+            this.activePage = await this.camoufoxManager.newPage();
+            return this.activePage;
+        }
+        if (!this.chromeManager) {
+            await this.launchChrome();
+        }
+        this.activePage = await this.chromeManager.newPage();
+        return this.activePage;
+    }
+    async goto(url, page) {
+        const targetPage = page ?? this.activePage;
+        if (this.driver === 'camoufox') {
+            if (!this.camoufoxManager) {
+                await this.launchCamoufox();
+            }
+            return this.camoufoxManager.goto(url, targetPage);
+        }
+        if (!this.chromeManager) {
+            await this.launchChrome();
+        }
+        return this.chromeManager.goto(url, targetPage);
+    }
+    async close() {
+        if (this.driver === 'camoufox' && this.camoufoxManager) {
+            await this.camoufoxManager.close();
+            this.camoufoxManager = null;
+            this.activePage = null;
+            logger.info('Camoufox browser closed');
+            return;
+        }
+        if (this.chromeManager) {
+            await this.chromeManager.close();
+            this.chromeManager = null;
+            this.activePage = null;
+            logger.info('Chrome browser closed');
+        }
+    }
+    getBrowser() {
+        if (this.driver === 'camoufox') {
+            return this.camoufoxManager?.getBrowser() ?? null;
+        }
+        return this.chromeManager?.getBrowser() ?? null;
+    }
+    getActivePage() {
+        return this.activePage;
+    }
+    getDriver() {
+        return this.driver;
+    }
+    setDriver(driver) {
+        this.driver = driver;
+    }
+    getStatus() {
+        const browser = this.getBrowser();
+        const running = browser !== null && browser.isConnected();
+        return {
+            driver: this.driver,
+            running,
+            hasActivePage: this.activePage !== null,
+            headless: this.config.headless,
+            debugPort: this.config.debugPort,
+        };
+    }
+    async discoverBrowsers() {
+        return this.browserDiscovery.discoverBrowsers();
+    }
+    async findChromeWithDebugPort(preferredPorts = [9222, 9229, 9333]) {
+        const browsers = await this.discoverBrowsers();
+        const chromeBrowsers = browsers.filter(b => b.type === 'chrome' || b.type === 'edge');
+        for (const browser of chromeBrowsers) {
+            if (browser.debugPort && preferredPorts.includes(browser.debugPort)) {
+                return browser;
+            }
+        }
+        return null;
+    }
+    async attachToExistingChrome(preferredPorts = [9222, 9229, 9333]) {
+        const browserInfo = await this.findChromeWithDebugPort(preferredPorts);
+        if (!browserInfo || !browserInfo.debugPort) {
+            logger.info('No existing Chrome browser with debug port found');
+            return null;
+        }
+        const wsEndpoint = `ws://127.0.0.1:${browserInfo.debugPort}`;
+        logger.info(`Found existing Chrome browser on port ${browserInfo.debugPort}, connecting...`);
+        try {
+            return await this.connectChrome(wsEndpoint);
+        }
+        catch (error) {
+            logger.error('Failed to connect to existing Chrome browser', error);
+            return null;
+        }
+    }
+    normalizeChromeHeadless() {
+        const headless = this.config.headless;
+        if (headless === 'virtual') {
+            return true;
+        }
+        if (headless === 'shell') {
+            return 'shell';
+        }
+        return headless ?? true;
+    }
+    normalizeCamoufoxHeadless() {
+        const headless = this.config.headless;
+        if (headless === 'shell') {
+            return true;
+        }
+        if (headless === 'virtual') {
+            return 'virtual';
+        }
+        return headless ?? true;
+    }
+    getHeadlessBoolean() {
+        const headless = this.config.headless;
+        if (headless === 'shell' || headless === 'virtual') {
+            return true;
+        }
+        return headless ?? true;
+    }
+}
+export { BrowserModeManager } from '../browser/BrowserModeManager.js';
+export { CamoufoxBrowserManager } from '../browser/CamoufoxBrowserManager.js';
+export { BrowserDiscovery } from '../browser/BrowserDiscovery.js';
+//# sourceMappingURL=UnifiedBrowserManager.js.map

package/dist/modules/browser/UnifiedBrowserManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnifiedBrowserManager.js","sourceRoot":"","sources":["../../../src/modules/browser/UnifiedBrowserManager.ts"],"names":[],"mappings":"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"}

package/dist/modules/browser/index.d.ts

@@ -0,0 +1,5 @@
+export { UnifiedBrowserManager, type BrowserDriver, type HeadlessMode, type ProxyConfig, type UnifiedBrowserConfig, type IBrowserManager, type BrowserStatus, } from '../browser/UnifiedBrowserManager.js';
+export { BrowserModeManager, type BrowserModeConfig } from '../browser/BrowserModeManager.js';
+export { CamoufoxBrowserManager, type CamoufoxBrowserConfig } from '../browser/CamoufoxBrowserManager.js';
+export { BrowserDiscovery, type BrowserInfo, type BrowserSignature } from '../browser/BrowserDiscovery.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/browser/index.ts"],"names":[],"mappings":"AASA,OAAO,EACL,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,wCAAwC,CAAC;AAGhD,OAAO,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAGjG,OAAO,EAAE,sBAAsB,EAAE,KAAK,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAG7G,OAAO,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/modules/browser/index.js

@@ -0,0 +1,5 @@
+export { UnifiedBrowserManager, } from '../browser/UnifiedBrowserManager.js';
+export { BrowserModeManager } from '../browser/BrowserModeManager.js';
+export { CamoufoxBrowserManager } from '../browser/CamoufoxBrowserManager.js';
+export { BrowserDiscovery } from '../browser/BrowserDiscovery.js';
+//# sourceMappingURL=index.js.map

package/dist/modules/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/browser/index.ts"],"names":[],"mappings":"AASA,OAAO,EACL,qBAAqB,GAOtB,MAAM,wCAAwC,CAAC;AAGhD,OAAO,EAAE,kBAAkB,EAA0B,MAAM,qCAAqC,CAAC;AAGjG,OAAO,EAAE,sBAAsB,EAA8B,MAAM,yCAAyC,CAAC;AAG7G,OAAO,EAAE,gBAAgB,EAA2C,MAAM,mCAAmC,CAAC"}

package/dist/modules/captcha/AICaptchaDetector.d.ts

@@ -0,0 +1,33 @@
+import { Page } from 'rebrowser-puppeteer-core';
+import { LLMService } from '../../services/LLMService.js';
+export interface AICaptchaDetectionResult {
+    detected: boolean;
+    type?: 'slider' | 'image' | 'recaptcha' | 'hcaptcha' | 'cloudflare' | 'text_input' | 'none';
+    confidence: number;
+    reasoning: string;
+    location?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    screenshot?: string;
+    screenshotPath?: string;
+    vendor?: string;
+    suggestions?: string[];
+}
+export declare class AICaptchaDetector {
+    private llm;
+    private screenshotDir;
+    private hasLoggedVisionFallback;
+    constructor(llm: LLMService, screenshotDir?: string);
+    private saveScreenshot;
+    detect(page: Page): Promise<AICaptchaDetectionResult>;
+    private getPageInfo;
+    private analyzeWithAI;
+    private buildAnalysisPrompt;
+    private parseAIResponse;
+    private fallbackTextAnalysis;
+    waitForCompletion(page: Page, timeout?: number): Promise<boolean>;
+}
+//# sourceMappingURL=AICaptchaDetector.d.ts.map

package/dist/modules/captcha/AICaptchaDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AICaptchaDetector.d.ts","sourceRoot":"","sources":["../../../src/modules/captcha/AICaptchaDetector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAIhD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,YAAY,GAAG,YAAY,GAAG,MAAM,CAAC;IAC5F,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE;QACT,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,uBAAuB,CAAS;gBAE5B,GAAG,EAAE,UAAU,EAAE,aAAa,GAAE,MAAwB;YAKtD,cAAc;IAmBtB,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,wBAAwB,CAAC;YA4B7C,WAAW;YAkDX,aAAa;IAgE3B,OAAO,CAAC,mBAAmB;IA6M3B,OAAO,CAAC,eAAe;IAqCvB,OAAO,CAAC,oBAAoB;IA8BtB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,MAAe,GAAG,OAAO,CAAC,OAAO,CAAC;CAmBhF"}

package/dist/modules/captcha/AICaptchaDetector.js

@@ -0,0 +1,391 @@
+import { writeFile, mkdir } from 'fs/promises';
+import { join } from 'path';
+import { logger } from '../../utils/logger.js';
+export class AICaptchaDetector {
+    llm;
+    screenshotDir;
+    hasLoggedVisionFallback = false;
+    constructor(llm, screenshotDir = './screenshots') {
+        this.llm = llm;
+        this.screenshotDir = screenshotDir;
+    }
+    async saveScreenshot(screenshotBase64) {
+        try {
+            await mkdir(this.screenshotDir, { recursive: true });
+            const timestamp = Date.now();
+            const filename = `captcha-${timestamp}.png`;
+            const filepath = join(this.screenshotDir, filename);
+            const buffer = Buffer.from(screenshotBase64, 'base64');
+            await writeFile(filepath, buffer);
+            logger.info(`Screenshot saved: ${filepath}`);
+            return filepath;
+        }
+        catch (error) {
+            logger.error('Failed to persist CAPTCHA screenshot', error);
+            throw error;
+        }
+    }
+    async detect(page) {
+        try {
+            logger.info('Running AI captcha detection...');
+            const screenshot = await page.screenshot({
+                encoding: 'base64',
+                fullPage: false,
+            });
+            const pageInfo = await this.getPageInfo(page);
+            const analysis = await this.analyzeWithAI(screenshot, pageInfo);
+            logger.info(`AI CAPTCHA detection result: ${analysis.detected ? 'detected' : 'not_detected'} (confidence: ${analysis.confidence}%)`);
+            return analysis;
+        }
+        catch (error) {
+            logger.error('AI CAPTCHA detection failed', error);
+            return {
+                detected: false,
+                confidence: 0,
+                reasoning: `AI detection error: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    async getPageInfo(page) {
+        const url = page.url();
+        const title = await page.title();
+        const info = await page.evaluate(() => {
+            const bodyText = document.body.innerText.substring(0, 1000);
+            const hasIframes = document.querySelectorAll('iframe').length > 0;
+            const suspiciousElements = [];
+            const captchaSelectors = [
+                '[class*="captcha"]',
+                '[id*="captcha"]',
+                '[class*="verify"]',
+                '[id*="verify"]',
+                '[class*="challenge"]',
+                'iframe[src*="recaptcha"]',
+                'iframe[src*="hcaptcha"]',
+                '.geetest_holder',
+                '#nc_1_wrapper',
+            ];
+            for (const selector of captchaSelectors) {
+                const elements = document.querySelectorAll(selector);
+                if (elements.length > 0) {
+                    suspiciousElements.push(`${selector} (${elements.length})`);
+                }
+            }
+            return {
+                bodyText,
+                hasIframes,
+                suspiciousElements,
+            };
+        });
+        return {
+            url,
+            title,
+            ...info,
+        };
+    }
+    async analyzeWithAI(screenshot, pageInfo) {
+        const prompt = this.buildAnalysisPrompt(pageInfo);
+        try {
+            logger.info('Starting AI captcha analysis...');
+            const response = await this.llm.analyzeImage(screenshot, prompt);
+            logger.info('AI analysis completed. Parsing response...');
+            return this.parseAIResponse(response, '');
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            const visionUnsupported = errorMessage.includes('does not support image analysis');
+            if (visionUnsupported) {
+                if (!this.hasLoggedVisionFallback) {
+                    logger.warn('Configured model does not support vision. Falling back to external analysis guidance.');
+                    this.hasLoggedVisionFallback = true;
+                }
+                const screenshotPath = await this.saveScreenshot(screenshot);
+                return {
+                    detected: false,
+                    type: 'none',
+                    confidence: 0,
+                    reasoning: 'The configured MCP model does not support image analysis and requires external AI assistance.\n\n' +
+                        'A screenshot has been saved (see screenshotPath).\n' +
+                        'The analysis prompt is included below.\n\n' +
+                        'Use a vision-capable model (for example GPT-4o or Claude 3) to analyze the screenshot and determine whether a captcha is present.\n\n' +
+                        '---\n\n' +
+                        `${prompt}\n\n` +
+                        '---\n\n' +
+                        'Review the file at screenshotPath with the prompt above.',
+                    screenshotPath,
+                    vendor: 'external-ai-required',
+                    suggestions: [
+                        `Use a vision-capable model to analyze the screenshot: ${screenshotPath}`,
+                        'Reuse the prompt embedded in the reasoning field',
+                        'After analysis, manually decide whether captcha handling is required',
+                        'Or configure MCP with a vision-capable model (for example gpt-4o or claude-3-opus)',
+                    ],
+                };
+            }
+            logger.error('AI captcha analysis failed:', errorMessage);
+            logger.info('Falling back to rule-based captcha detection');
+            return this.fallbackTextAnalysis(pageInfo);
+        }
+    }
+    buildAnalysisPrompt(pageInfo) {
+        return `# 
+
+## 
+，（CAPTCHA），。
+
+## 
+\`\`\`json
+{
+  "url": "${pageInfo.url}",
+  "title": "${pageInfo.title}",
+  "hasIframes": ${pageInfo.hasIframes},
+  "suspiciousElements": ${JSON.stringify(pageInfo.suspiciousElements)},
+  "bodyTextPreview": "${pageInfo.bodyText.substring(0, 200).replace(/"/g, '\\"')}..."
+}
+\`\`\`
+
+## 
+
+### 1. （Interactive CAPTCHA）
+**1.1 （Slider CAPTCHA）**
+- ****: 、
+- ****: (Geetest)、、、
+- ****: 、、""
+- **DOM**: \`.geetest_slider\`, \`.nc_1_wrapper\`, \`.tcaptcha-transform\`
+
+**1.2 （Image CAPTCHA）**
+- ****: （""）
+- ****: reCAPTCHA v2、hCaptcha
+- ****: 3x34x4、
+- **DOM**: \`iframe[src*="recaptcha"]\`, \`.h-captcha\`
+
+**1.3 （Text CAPTCHA）**
+- ****: /
+- ****: 、
+- ****: ""
+
+### 2. （Automatic CAPTCHA）
+**2.1 reCAPTCHA v3**
+- ****: ，reCAPTCHA
+- ****: "Protected by reCAPTCHA" 
+
+**2.2 Cloudflare Turnstile**
+- ****: "" / "Checking your browser"
+- ****: Cloudflare logo、、Ray ID
+
+### 3. （False Positives - ）
+**3.1 **
+-  、、
+-  ""（）
+-  ""（）
+
+**3.2 **
+-  、
+-  、
+-  
+
+**3.3 UI**
+-  Range slider、Progress bar
+-  Carousel、Swiper
+-  、
+
+## 
+
+### Step 1: 
+1. ：
+   -  + 
+   -  + 
+   - ""
+   - ""
+   - Cloudflare/reCAPTCHA logo
+
+### Step 2: 
+1. URL：
+   - \`/captcha\`, \`/challenge\`, \`/verify\`
+   - \`cdn-cgi/challenge\` (Cloudflare)
+   - \`recaptcha.net\`, \`hcaptcha.com\`
+
+2. ：
+   - ""、""、""
+   - "Verify", "Challenge", "Security Check"
+
+3. ：
+   - suspiciousElements → 
+   -  → 
+
+### Step 3: 
+1. ：
+   - ""、""
+   - ，
+   - →  \`detected: false\`
+
+2. /UI：
+   - 、、
+   - →  \`detected: false\`
+
+### Step 4: 
+- **90-100%**:  + DOM
+- **70-89%**: ，DOM
+- **50-69%**: ，
+- **0-49%**: 
+
+## 
+
+**JSON Schema**:
+
+\`\`\`json
+{
+  "detected": boolean,
+  "type": "slider" | "image" | "recaptcha" | "hcaptcha" | "cloudflare" | "text_input" | "none",
+  "confidence": number,
+  "reasoning": string,
+  "location": {
+    "x": number,
+    "y": number,
+    "width": number,
+    "height": number
+  } | null,
+  "vendor": "geetest" | "tencent" | "aliyun" | "recaptcha" | "hcaptcha" | "cloudflare" | "unknown",
+  "suggestions": string[]
+}
+\`\`\`
+
+### 
+- **detected**: （）
+- **type**: （）
+- **confidence**: （0-100）
+- **reasoning**: （200，）
+- **location**: （，null）
+- **vendor**: （"unknown"）
+- **suggestions**: （，2-3）
+
+### 
+
+**1: **
+\`\`\`json
+{
+  "detected": true,
+  "type": "slider",
+  "confidence": 95,
+  "reasoning": "：1) ；2) ''；3) DOM.geetest_slider。。",
+  "location": {
+    "x": 450,
+    "y": 300,
+    "width": 320,
+    "height": 180
+  },
+  "vendor": "geetest",
+  "suggestions": [
+    "",
+    "captcha_wait",
+    "，"
+  ]
+}
+\`\`\`
+
+**2:  - **
+\`\`\`json
+{
+  "detected": false,
+  "type": "none",
+  "confidence": 95,
+  "reasoning": "''''，，。，。",
+  "location": null,
+  "vendor": "unknown",
+  "suggestions": [
+    "，",
+    ""
+  ]
+}
+\`\`\`
+
+**3: **
+\`\`\`json
+{
+  "detected": false,
+  "type": "none",
+  "confidence": 98,
+  "reasoning": "，、。，suspiciousElements，URL。",
+  "location": null,
+  "vendor": "unknown",
+  "suggestions": [
+    "，",
+    ""
+  ]
+}
+\`\`\`
+
+## 
+
+1. ****:  \`detected: false\`，
+2. ****:  > DOM > 
+3. ****: URL、、DOM、
+4. ****: reasoning
+5. ****: suggestions
+
+，JSON。`;
+    }
+    parseAIResponse(response, screenshotPath) {
+        try {
+            const jsonMatch = response.match(/```json\s*([\s\S]*?)\s*```/) || response.match(/\{[\s\S]*\}/);
+            if (!jsonMatch) {
+                throw new Error('AIJSON');
+            }
+            const jsonStr = jsonMatch[1] || jsonMatch[0];
+            const result = JSON.parse(jsonStr);
+            return {
+                detected: result.detected || false,
+                type: result.type || 'none',
+                confidence: result.confidence || 0,
+                reasoning: result.reasoning || '',
+                location: result.location,
+                vendor: result.vendor,
+                suggestions: result.suggestions || [],
+                screenshotPath: screenshotPath || undefined,
+            };
+        }
+        catch (error) {
+            logger.error('Failed to parse AI CAPTCHA response', error);
+            const detected = response.toLowerCase().includes('detected') && response.toLowerCase().includes('true');
+            return {
+                detected,
+                confidence: detected ? 50 : 80,
+                reasoning: `AI parse failed, raw response: ${response.substring(0, 200)}`,
+                screenshotPath: screenshotPath || undefined,
+            };
+        }
+    }
+    fallbackTextAnalysis(pageInfo) {
+        logger.warn('Using fallback keyword-based CAPTCHA detection');
+        const hasCaptchaElements = pageInfo.suspiciousElements.length > 0;
+        const hasCaptchaKeywords = pageInfo.title.toLowerCase().includes('captcha') ||
+            pageInfo.title.toLowerCase().includes('verify') ||
+            pageInfo.bodyText.toLowerCase().includes('captcha') ||
+            pageInfo.bodyText.toLowerCase().includes('verification');
+        const detected = hasCaptchaElements && hasCaptchaKeywords;
+        return {
+            detected,
+            confidence: detected ? 60 : 90,
+            reasoning: detected
+                ? 'Fallback heuristics matched both suspicious elements and CAPTCHA keywords.'
+                : 'Fallback heuristics did not find strong CAPTCHA signals.',
+            suggestions: detected
+                ? ['Switch to headed mode if needed', 'Wait for manual completion before continuing']
+                : ['Solve the CAPTCHA manually if one is visible'],
+        };
+    }
+    async waitForCompletion(page, timeout = 300000) {
+        logger.info('Waiting for CAPTCHA to be solved...');
+        const startTime = Date.now();
+        while (Date.now() - startTime < timeout) {
+            const result = await this.detect(page);
+            if (!result.detected || result.confidence < 50) {
+                logger.info('CAPTCHA is no longer detected; continuing workflow');
+                return true;
+            }
+            await new Promise((resolve) => setTimeout(resolve, 3000));
+        }
+        logger.error('Timed out while waiting for CAPTCHA completion');
+        return false;
+    }
+}
+//# sourceMappingURL=AICaptchaDetector.js.map