@jshookmcp/jshook 0.2.0 → 0.2.2

package/dist/src/modules/browser/BrowserModeManager.js

@@ -1,5 +1,5 @@
 import { existsSync } from 'fs';
-import puppeteer from 'rebrowser-puppeteer-core';
+import puppeteer, { Browser, Page } from 'rebrowser-puppeteer-core';
 import { logger } from '../../utils/logger.js';
 import { findBrowserExecutable } from '../../utils/browserExecutable.js';
 import { CaptchaDetector } from '../captcha/CaptchaDetector.js';
@@ -13,6 +13,8 @@ export class BrowserModeManager {
     config;
     captchaDetector;
     launchOptions;
+    chromePid = null;
+    static BROWSER_CLOSE_TIMEOUT_MS = 5000;
     sessionData = {};
     constructor(config = {}, launchOptions = {}) {
         this.config = {
@@ -68,13 +70,19 @@ export class BrowserModeManager {
             options.executablePath = executablePath;
         }
         const browser = await puppeteer.launch(options);
+        const pid = browser.process()?.pid ?? null;
         if (this.isClosing) {
-            await browser.close().catch(error => {
+            await browser.close().catch((error) => {
                 logger.warn('Failed to close browser launched during shutdown', error);
+                BrowserModeManager.forceKillPid(pid);
             });
             throw new Error('Browser launch aborted because close was requested');
         }
         this.browser = browser;
+        this.chromePid = pid;
+        if (pid) {
+            logger.debug(`Chrome child process PID: ${pid}`);
+        }
         logger.info('Browser launched successfully');
         return this.browser;
     }
@@ -107,11 +115,22 @@ export class BrowserModeManager {
     async finalizeClose() {
         try {
             const browser = this.browser;
+            const pid = this.chromePid;
             this.browser = null;
             this.currentPage = null;
+            this.chromePid = null;
             if (browser) {
-                await browser.close();
-                logger.info('Browser closed');
+                try {
+                    await Promise.race([
+                        browser.close(),
+                        new Promise((_, reject) => setTimeout(() => reject(new Error('browser.close() timed out')), BrowserModeManager.BROWSER_CLOSE_TIMEOUT_MS)),
+                    ]);
+                    logger.info('Browser closed');
+                }
+                catch (error) {
+                    logger.warn('browser.close() failed or timed out, attempting force-kill:', error);
+                    BrowserModeManager.forceKillPid(pid);
+                }
             }
         }
         finally {
@@ -165,7 +184,15 @@ export class BrowserModeManager {
     async switchToHeaded(currentPage, url, captchaInfo) {
         logger.info('Switching browser to headed mode for manual CAPTCHA solving');
         await this.saveSessionData(currentPage);
-        await this.browser?.close();
+        const oldPid = this.chromePid;
+        try {
+            await this.browser?.close();
+        }
+        catch (error) {
+            logger.warn('Failed to close old browser during mode switch:', error);
+            BrowserModeManager.forceKillPid(oldPid);
+        }
+        this.chromePid = null;
         this.isHeadless = false;
         await this.launch();
         const newPage = await this.newPage();
@@ -262,7 +289,7 @@ export class BrowserModeManager {
                     restoreStorage(sessionStorage, data.session);
                 }, {
                     local: this.sessionData.localStorage,
-                    session: this.sessionData.sessionStorage
+                    session: this.sessionData.sessionStorage,
                 });
                 logger.info('Session storage data restored');
             }
@@ -384,4 +411,20 @@ export class BrowserModeManager {
     isHeadlessMode() {
         return this.isHeadless;
     }
+    getChromePid() {
+        return this.chromePid;
+    }
+    static forceKillPid(pid) {
+        if (!pid)
+            return;
+        try {
+            process.kill(pid, 'SIGKILL');
+            logger.info(`Force-killed Chrome process PID ${pid}`);
+        }
+        catch (error) {
+            if (error.code !== 'ESRCH') {
+                logger.warn(`Failed to force-kill Chrome PID ${pid}:`, error);
+            }
+        }
+    }
 }

package/dist/src/modules/browser/CDPErrorMapper.d.ts

@@ -0,0 +1,4 @@
+import { ToolError } from '../../errors/ToolError.js';
+export declare function mapCDPError(error: unknown, toolName?: string): ToolError | Error;
+export declare function wrapCDPCall<T>(fn: () => Promise<T>, toolName?: string): Promise<T>;
+export declare function isCDPSessionGone(error: unknown): boolean;

package/dist/src/modules/browser/CDPErrorMapper.js

@@ -0,0 +1,82 @@
+import { ToolError } from '../../errors/ToolError.js';
+const CDP_ERROR_MAPPINGS = [
+    {
+        pattern: /Session.*not found|session closed|Session.*closed/i,
+        code: 'CONNECTION',
+        hint: 'The browser session has been destroyed. Re-launch the browser or open a new tab.',
+    },
+    {
+        pattern: /Target closed|target.*has.*been.*closed/i,
+        code: 'CONNECTION',
+        hint: 'The target page/tab was closed. Open a new tab before re-running this tool.',
+    },
+    {
+        pattern: /Protocol error.*Target\.sendMessageToTarget/i,
+        code: 'CONNECTION',
+        hint: 'CDP protocol communication failed. The browser may have crashed — try page_navigate to restore.',
+    },
+    {
+        pattern: /Execution context was destroyed/i,
+        code: 'RUNTIME',
+        hint: 'The page navigated while a script was running. Re-run the tool after navigation completes.',
+    },
+    {
+        pattern: /Cannot find context with specified id/i,
+        code: 'RUNTIME',
+        hint: 'An iframe or context was removed during execution. Retry after the page settles.',
+    },
+    {
+        pattern: /Node.*not found|Could not find node/i,
+        code: 'NOT_FOUND',
+        hint: 'The referenced DOM node no longer exists. The page may have re-rendered.',
+    },
+    {
+        pattern: /Evaluation failed.*timeout|Navigation timeout|TimeoutError/i,
+        code: 'TIMEOUT',
+        hint: 'The operation timed out. Increase the timeout or check if the page is responding.',
+    },
+    {
+        pattern: /net::ERR_|Failed to navigate|net::ERR_NAME_NOT_RESOLVED/i,
+        code: 'CONNECTION',
+        hint: 'Network error while loading the page. Check the URL and network connectivity.',
+    },
+    {
+        pattern: /Debugger.*not.*enabled|Debugger\.enable.*must.*be.*called/i,
+        code: 'PREREQUISITE',
+        hint: 'The CDP Debugger domain is not enabled. Enable it before using debugger tools.',
+    },
+    {
+        pattern: /Permission denied|Not allowed/i,
+        code: 'PERMISSION',
+        hint: 'The browser denied this operation. Check browser security policies.',
+    },
+];
+export function mapCDPError(error, toolName) {
+    const message = error instanceof Error ? error.message : String(error);
+    for (const mapping of CDP_ERROR_MAPPINGS) {
+        if (mapping.pattern.test(message)) {
+            return new ToolError(mapping.code, `${message}\n\nHint: ${mapping.hint}`, {
+                toolName,
+                cause: error instanceof Error ? error : undefined,
+                details: { originalMessage: message, cdpMapping: true },
+            });
+        }
+    }
+    if (error instanceof ToolError)
+        return error;
+    if (error instanceof Error)
+        return error;
+    return new Error(String(error));
+}
+export async function wrapCDPCall(fn, toolName) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        throw mapCDPError(error, toolName);
+    }
+}
+export function isCDPSessionGone(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return /Session.*not found|Target closed|session closed/i.test(message);
+}

package/dist/src/modules/browser/CamoufoxBrowserManager.d.ts

@@ -38,6 +38,7 @@ export declare class CamoufoxBrowserManager {
     newPage(): Promise<CamoufoxPageLike>;
     goto(url: string, page?: CamoufoxPageLike): Promise<CamoufoxPageLike>;
     close(): Promise<void>;
+    private static readonly BROWSER_CLOSE_TIMEOUT_MS;
     private finalizeClose;
     launchAsServer(port?: number, ws_path?: string): Promise<string>;
     connectToServer(wsEndpoint: string): Promise<CamoufoxBrowserLike>;

package/dist/src/modules/browser/CamoufoxBrowserManager.js

@@ -38,7 +38,9 @@ export class CamoufoxBrowserManager {
     async doLaunch() {
         if (this.browser) {
             logger.info('Closing existing Camoufox browser before relaunch');
-            await this.browser.close().catch(err => logger.warn('Failed to close previous browser:', err));
+            await this.browser
+                .close()
+                .catch((err) => logger.warn('Failed to close previous browser:', err));
             this.browser = null;
         }
         logger.info(`Launching Camoufox (Firefox) [os=${this.config.os}, headless=${this.config.headless}]...`);
@@ -59,7 +61,7 @@ export class CamoufoxBrowserManager {
             block_webrtc: this.config.blockWebrtc,
         }));
         if (this.isClosing) {
-            await this.browser.close().catch(error => {
+            await this.browser.close().catch((error) => {
                 logger.warn('Failed to close Camoufox browser launched during shutdown:', error);
             });
             this.browser = null;
@@ -95,12 +97,16 @@ export class CamoufoxBrowserManager {
         }
         await this.finalizeClose();
     }
+    static BROWSER_CLOSE_TIMEOUT_MS = 5000;
     async finalizeClose() {
         try {
             const browser = this.browser;
             this.browser = null;
             if (browser) {
-                await browser.close();
+                await Promise.race([
+                    browser.close(),
+                    new Promise((_, reject) => setTimeout(() => reject(new Error('camoufox browser.close() timed out')), CamoufoxBrowserManager.BROWSER_CLOSE_TIMEOUT_MS)),
+                ]);
                 logger.info('Camoufox browser closed');
             }
         }
@@ -130,7 +136,9 @@ export class CamoufoxBrowserManager {
         };
         if (this.browserServer) {
             logger.info('Closing existing Camoufox server before relaunch');
-            await this.browserServer.close().catch(err => logger.warn('Failed to close previous server:', err));
+            await this.browserServer
+                .close()
+                .catch((err) => logger.warn('Failed to close previous server:', err));
             this.browserServer = null;
         }
         const server = await launchServer(serverOptions);
@@ -143,7 +151,9 @@ export class CamoufoxBrowserManager {
         logger.info(`Connecting to Camoufox server: ${wsEndpoint}`);
         if (this.browser) {
             logger.info('Disconnecting existing browser before new connection');
-            await this.browser.close().catch(err => logger.warn('Failed to close previous browser:', err));
+            await this.browser
+                .close()
+                .catch((err) => logger.warn('Failed to close previous browser:', err));
             this.browser = null;
         }
         const playwrightModule = await import('playwright-core');

package/dist/src/modules/browser/HookHeartbeat.d.ts

@@ -0,0 +1,38 @@
+export interface HeartbeatScript {
+    id: string;
+    source: string;
+}
+export interface HeartbeatOptions {
+    debounceMs?: number;
+    mainFrameOnly?: boolean;
+}
+interface PageLike {
+    on(event: 'framenavigated', handler: (frame: FrameLike) => void): void;
+    off(event: 'framenavigated', handler: (frame: FrameLike) => void): void;
+    evaluate(fn: string): Promise<unknown>;
+    isClosed(): boolean;
+    mainFrame(): FrameLike;
+}
+interface FrameLike {
+    url(): string;
+    parentFrame(): FrameLike | null;
+}
+export declare class HookHeartbeat {
+    private readonly page;
+    private readonly scripts;
+    private readonly debounceMs;
+    private readonly mainFrameOnly;
+    private debounceTimer;
+    private running;
+    private readonly boundHandler;
+    constructor(page: PageLike, options?: HeartbeatOptions);
+    addScript(script: HeartbeatScript): this;
+    removeScript(id: string): this;
+    start(): this;
+    stop(): void;
+    get isRunning(): boolean;
+    get scriptCount(): number;
+    private onFrameNavigated;
+    private reinjectAll;
+}
+export {};

package/dist/src/modules/browser/HookHeartbeat.js

@@ -0,0 +1,76 @@
+import { logger } from '../../utils/logger.js';
+export class HookHeartbeat {
+    page;
+    scripts = new Map();
+    debounceMs;
+    mainFrameOnly;
+    debounceTimer = null;
+    running = false;
+    boundHandler;
+    constructor(page, options) {
+        this.page = page;
+        this.debounceMs = options?.debounceMs ?? 150;
+        this.mainFrameOnly = options?.mainFrameOnly ?? true;
+        this.boundHandler = this.onFrameNavigated.bind(this);
+    }
+    addScript(script) {
+        this.scripts.set(script.id, script);
+        return this;
+    }
+    removeScript(id) {
+        this.scripts.delete(id);
+        return this;
+    }
+    start() {
+        if (this.running)
+            return this;
+        this.running = true;
+        this.page.on('framenavigated', this.boundHandler);
+        logger.debug(`[HookHeartbeat] Started monitoring (${this.scripts.size} scripts, debounce=${this.debounceMs}ms)`);
+        return this;
+    }
+    stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        this.page.off('framenavigated', this.boundHandler);
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+        logger.debug('[HookHeartbeat] Stopped monitoring');
+    }
+    get isRunning() {
+        return this.running;
+    }
+    get scriptCount() {
+        return this.scripts.size;
+    }
+    onFrameNavigated(frame) {
+        if (this.mainFrameOnly && frame.parentFrame() !== null) {
+            return;
+        }
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+        }
+        this.debounceTimer = setTimeout(() => {
+            this.debounceTimer = null;
+            void this.reinjectAll(frame.url());
+        }, this.debounceMs);
+    }
+    async reinjectAll(url) {
+        if (!this.running || this.page.isClosed())
+            return;
+        if (this.scripts.size === 0)
+            return;
+        logger.debug(`[HookHeartbeat] Re-injecting ${this.scripts.size} scripts after navigation to ${url}`);
+        for (const [id, script] of this.scripts) {
+            try {
+                await this.page.evaluate(script.source);
+            }
+            catch (error) {
+                logger.warn(`[HookHeartbeat] Failed to re-inject script "${id}":`, error);
+            }
+        }
+    }
+}

package/dist/src/modules/browser/UnifiedBrowserManager.d.ts

@@ -1,6 +1,6 @@
 import type { Browser as PuppeteerBrowser, Page as PuppeteerPage } from 'rebrowser-puppeteer-core';
-import { CamoufoxBrowserLike, CamoufoxPageLike } from '../browser/CamoufoxBrowserManager.js';
-import { BrowserInfo } from '../browser/BrowserDiscovery.js';
+import { type CamoufoxBrowserLike, type CamoufoxPageLike } from '../browser/CamoufoxBrowserManager.js';
+import { type BrowserInfo } from '../browser/BrowserDiscovery.js';
 export type BrowserDriver = 'chrome' | 'camoufox';
 export type HeadlessMode = boolean | 'shell' | 'virtual';
 export interface ProxyConfig {

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

@@ -60,7 +60,10 @@ export class UnifiedBrowserManager {
             launchOptions.args = [...(launchOptions.args || []), ...proxyArgs];
         }
         if (this.config.debugPort) {
-            launchOptions.args = [...(launchOptions.args || []), `--remote-debugging-port=${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();
@@ -212,7 +215,7 @@ export class UnifiedBrowserManager {
     }
     async findChromeWithDebugPort(preferredPorts = [9222, 9229, 9333]) {
         const browsers = await this.discoverBrowsers();
-        const chromeBrowsers = browsers.filter(b => b.type === 'chrome' || b.type === 'edge');
+        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;

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

@@ -1,4 +1,4 @@
 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';
+export { CamoufoxBrowserManager, type CamoufoxBrowserConfig, } from '../browser/CamoufoxBrowserManager.js';
+export { BrowserDiscovery, type BrowserInfo, type BrowserSignature, } from '../browser/BrowserDiscovery.js';

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

@@ -1,4 +1,4 @@
 export { UnifiedBrowserManager, } from '../browser/UnifiedBrowserManager.js';
 export { BrowserModeManager } from '../browser/BrowserModeManager.js';
-export { CamoufoxBrowserManager } from '../browser/CamoufoxBrowserManager.js';
-export { BrowserDiscovery } from '../browser/BrowserDiscovery.js';
+export { CamoufoxBrowserManager, } from '../browser/CamoufoxBrowserManager.js';
+export { BrowserDiscovery, } from '../browser/BrowserDiscovery.js';

package/dist/src/modules/captcha/AICaptchaDetector.js

@@ -1,6 +1,8 @@
+import { Page } from 'rebrowser-puppeteer-core';
 import { writeFile, mkdir } from 'fs/promises';
 import { join } from 'path';
 import { logger } from '../../utils/logger.js';
+import { LLMService } from '../../services/LLMService.js';
 import { FALLBACK_CAPTCHA_KEYWORDS, FALLBACK_EXCLUDE_KEYWORDS, } from '../captcha/CaptchaDetector.constants.js';
 import { CAPTCHA_PROVIDER_HINTS, CAPTCHA_TYPES, LEGACY_CAPTCHA_PROVIDER_HINT_ALIASES, LEGACY_CAPTCHA_TYPE_ALIASES, } from '../captcha/types.js';
 const PROMPT_INJECTION_PATTERNS = [
@@ -374,9 +376,7 @@ Analyze the screenshot and return valid JSON.`;
                 type: 'none',
                 confidence: 95,
                 reasoning: 'Fallback heuristics matched OTP or account verification text, not a CAPTCHA. / 后备启发式匹配到一次性验证码或账户校验文本，不视为 CAPTCHA。',
-                suggestions: [
-                    'Continue the login or verification flow normally / 继续正常登录或验证流程',
-                ],
+                suggestions: ['Continue the login or verification flow normally / 继续正常登录或验证流程'],
             };
         }
         const detected = hasStrongCaptchaSignals;
@@ -390,7 +390,10 @@ Analyze the screenshot and return valid JSON.`;
                     : '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 / 等待手动完成后继续']
+                ? [
+                    'Switch to headed mode if needed / 如需要切换到有头模式',
+                    'Wait for manual completion before continuing / 等待手动完成后继续',
+                ]
                 : ['Solve the CAPTCHA manually if one is visible / 如有可见验证码请手动解决'],
         };
     }

package/dist/src/modules/captcha/CaptchaDetector.js

@@ -1,3 +1,4 @@
+import { Page } from 'rebrowser-puppeteer-core';
 import { logger } from '../../utils/logger.js';
 import { CAPTCHA_MATCH_RULES, DOM_MATCH_RULES, EXCLUDE_MATCH_RULES, EXCLUDE_SELECTORS, } from '../captcha/CaptchaDetector.constants.js';
 export class CaptchaDetector {
@@ -225,7 +226,9 @@ export class CaptchaDetector {
         if (!input.likelyCaptcha) {
             return 'ask_ai';
         }
-        if (input.confidence >= 95 || input.candidateCount >= 2 || input.score - input.excludeScore >= 120) {
+        if (input.confidence >= 95 ||
+            input.candidateCount >= 2 ||
+            input.score - input.excludeScore >= 120) {
             return 'manual';
         }
         if (input.excludeScore > 0) {
@@ -257,7 +260,11 @@ export class CaptchaDetector {
                 type: matchRule.rule.typeHint ?? 'url_redirect',
                 providerHint: matchRule.rule.providerHint,
                 url,
-                details: { ruleId: matchRule.rule.id, ruleLabel: matchRule.rule.label, matchText: matchRule.matchText },
+                details: {
+                    ruleId: matchRule.rule.id,
+                    ruleLabel: matchRule.rule.label,
+                    matchText: matchRule.matchText,
+                },
             });
         }
         return { detected: false, type: 'none', confidence: 0 };
@@ -286,7 +293,11 @@ export class CaptchaDetector {
                 type: matchRule.rule.typeHint ?? 'page_redirect',
                 providerHint: matchRule.rule.providerHint,
                 title,
-                details: { ruleId: matchRule.rule.id, ruleLabel: matchRule.rule.label, matchText: matchRule.matchText },
+                details: {
+                    ruleId: matchRule.rule.id,
+                    ruleLabel: matchRule.rule.label,
+                    matchText: matchRule.matchText,
+                },
             });
         }
         return { detected: false, type: 'none', confidence: 0 };

package/dist/src/modules/captcha/rules/captcha-keywords.js

@@ -48,11 +48,7 @@ const EMBEDDED_WIDGET_URL_KEYWORDS = [
     'siteverify',
     'sitekey',
 ];
-const REGIONAL_PROVIDER_URL_KEYWORDS = [
-    'slider-verify',
-    'drag-verify',
-    'slide-check',
-];
+const REGIONAL_PROVIDER_URL_KEYWORDS = ['slider-verify', 'drag-verify', 'slide-check'];
 const GENERIC_CAPTCHA_TEXT_KEYWORDS = [
     'Please verify',
     'Verify you are human',
@@ -99,8 +95,5 @@ export const CAPTCHA_KEYWORDS = {
         ...EMBEDDED_WIDGET_URL_KEYWORDS,
         ...REGIONAL_PROVIDER_URL_KEYWORDS,
     ]),
-    text: mergeUnique([
-        ...GENERIC_CAPTCHA_TEXT_KEYWORDS,
-        ...ZH_CAPTCHA_TEXT_KEYWORDS,
-    ]),
+    text: mergeUnique([...GENERIC_CAPTCHA_TEXT_KEYWORDS, ...ZH_CAPTCHA_TEXT_KEYWORDS]),
 };

package/dist/src/modules/captcha/rules/dom-rules.d.ts

@@ -1,2 +1,28 @@
-import type { CaptchaDomRule } from '../../captcha/types.js';
-export declare const DOM_MATCH_RULES: readonly CaptchaDomRule[];
+export declare const DOM_MATCH_RULES: ({
+    id: string;
+    label: string;
+    selectors: readonly [".captcha-slider", ".verify-slider", "#captcha-slider", ".slide-verify", "[class*=\"captcha\"][class*=\"slider\"]", "[class*=\"verify\"][class*=\"slider\"]", "[id*=\"captcha\"][id*=\"slider\"]", "[id*=\"verify\"][id*=\"slider\"]", "[aria-label*=\"slider\" i]"];
+    confidence: number;
+    typeHint: "slider";
+    requiresVisibility: true;
+    verifier: "slider";
+    providerHint?: undefined;
+} | {
+    id: string;
+    label: string;
+    selectors: readonly ["iframe[src*=\"captcha\" i]", "iframe[src*=\"challenge\" i]", "iframe[title*=\"captcha\" i]", "iframe[title*=\"verification\" i]", "[data-sitekey]", "[class*=\"captcha\"][class*=\"widget\"]", "[class*=\"challenge\"][class*=\"widget\"]", "[class*=\"human\"][class*=\"check\"]"];
+    confidence: number;
+    typeHint: "widget";
+    providerHint: "embedded_widget";
+    requiresVisibility?: undefined;
+    verifier?: undefined;
+} | {
+    id: string;
+    label: string;
+    selectors: readonly ["#challenge-form", "[id*=\"challenge-form\"]", "[class*=\"browser-check\"]", "[class*=\"security-check\"]", "[class*=\"challenge-page\"]", "[class*=\"challenge-container\"]"];
+    confidence: number;
+    typeHint: "browser_check";
+    providerHint: "edge_service";
+    requiresVisibility?: undefined;
+    verifier?: undefined;
+})[];

package/dist/src/modules/captcha/rules/exclude-keywords.js

@@ -29,9 +29,22 @@ const OTP_EXCLUDE_TEXT_KEYWORDS = [
     'Enter your authenticator code',
     'Two-factor authentication',
 ];
-const ZH_EXCLUDE_TITLE_KEYWORDS = ['短信验证', '邮箱验证', '输入验证码', '手机验证', '登录验证', '双重验证'];
+const ZH_EXCLUDE_TITLE_KEYWORDS = [
+    '短信验证',
+    '邮箱验证',
+    '输入验证码',
+    '手机验证',
+    '登录验证',
+    '双重验证',
+];
 const ZH_EXCLUDE_URL_KEYWORDS = ['验证邮箱', '验证手机', '重置密码'];
-const ZH_EXCLUDE_TEXT_KEYWORDS = ['输入验证码', '获取验证码', '发送验证码', '已发送验证码', '双因素认证'];
+const ZH_EXCLUDE_TEXT_KEYWORDS = [
+    '输入验证码',
+    '获取验证码',
+    '发送验证码',
+    '已发送验证码',
+    '双因素认证',
+];
 const AUTH_FLOW_TITLE_KEYWORDS = ['two-factor', '2fa', 'two-factor authentication'];
 export const EXCLUDE_KEYWORDS = {
     title: mergeUnique([

package/dist/src/modules/collector/CodeCache.d.ts

@@ -2,8 +2,10 @@ import type { CodeFile, CollectCodeResult } from '../../types/index.js';
 export interface CacheEntry {
     url: string;
     files: CodeFile[];
+    dependencies?: CollectCodeResult['dependencies'];
     totalSize: number;
     collectTime: number;
+    summaries?: CollectCodeResult['summaries'];
     timestamp: number;
     hash: string;
 }
@@ -24,6 +26,7 @@ export declare class CodeCache {
     init(): Promise<void>;
     private generateKey;
     private getCachePath;
+    private getDependenciesOrEmpty;
     private isExpired;
     get(url: string, options?: Record<string, unknown>): Promise<CollectCodeResult | null>;
     set(url: string, result: CollectCodeResult, options?: Record<string, unknown>): Promise<void>;

package/dist/src/modules/collector/CodeCache.js

@@ -31,6 +31,9 @@ export class CodeCache {
     getCachePath(key) {
         return path.join(this.cacheDir, `${key}.json`);
     }
+    getDependenciesOrEmpty(dependencies) {
+        return dependencies ?? { nodes: [], edges: [] };
+    }
     isExpired(entry) {
         return Date.now() - entry.timestamp > this.maxAge;
     }
@@ -42,9 +45,10 @@ export class CodeCache {
                 logger.debug(`Cache hit (memory): ${url}`);
                 return {
                     files: entry.files,
-                    dependencies: { nodes: [], edges: [] },
+                    dependencies: this.getDependenciesOrEmpty(entry.dependencies),
                     totalSize: entry.totalSize,
                     collectTime: entry.collectTime,
+                    summaries: entry.summaries,
                 };
             }
             else {
@@ -64,9 +68,10 @@ export class CodeCache {
             logger.debug(`Cache hit (disk): ${url}`);
             return {
                 files: entry.files,
-                dependencies: { nodes: [], edges: [] },
+                dependencies: this.getDependenciesOrEmpty(entry.dependencies),
                 totalSize: entry.totalSize,
                 collectTime: entry.collectTime,
+                summaries: entry.summaries,
             };
         }
         catch (err) {
@@ -80,8 +85,10 @@ export class CodeCache {
         const entry = {
             url,
             files: result.files,
+            dependencies: result.dependencies,
             totalSize: result.totalSize,
             collectTime: result.collectTime,
+            summaries: result.summaries,
             timestamp: Date.now(),
             hash,
         };