@jshookmcp/jshook 0.1.8 → 0.1.9

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

@@ -0,0 +1,106 @@
+import { mergeUnique } from '../../captcha/rules/shared.js';
+const GENERIC_CAPTCHA_TITLE_KEYWORDS = [
+    'captcha',
+    'challenge',
+    'verify',
+    'verification',
+    'robot',
+    'human',
+    'security check',
+    'bot check',
+    'anti-bot',
+];
+const PROVIDER_CAPTCHA_TITLE_KEYWORDS = [
+    'browser check',
+    'security challenge',
+    'human check',
+    'verification widget',
+    'widget challenge',
+];
+const ZH_CAPTCHA_TITLE_KEYWORDS = [
+    '验证码',
+    '安全验证',
+    '人机验证',
+    '滑动验证',
+    '身份验证',
+    '安全检测',
+];
+const GENERIC_CAPTCHA_URL_KEYWORDS = [
+    'captcha',
+    'challenge',
+    'verify',
+    'verification',
+    'robot-check',
+    'security-check',
+    'bot-check',
+];
+const EDGE_PROVIDER_URL_KEYWORDS = [
+    'cdn-cgi/challenge',
+    'challenge-platform',
+    'browser-check',
+    'security-check',
+    'interstitial',
+];
+const EMBEDDED_WIDGET_URL_KEYWORDS = [
+    'captcha-frame',
+    'challenge-frame',
+    'widget-challenge',
+    'siteverify',
+    'sitekey',
+];
+const REGIONAL_PROVIDER_URL_KEYWORDS = [
+    'slider-verify',
+    'drag-verify',
+    'slide-check',
+];
+const GENERIC_CAPTCHA_TEXT_KEYWORDS = [
+    'Please verify',
+    'Verify you are human',
+    'Complete the security check',
+    'Slide to verify',
+    'Click to verify',
+    'Drag the slider',
+    'Prove you are human',
+    'I am not a robot',
+    'Checking your browser',
+    'Just a moment',
+    'Checking if the site connection is secure',
+    'This process is automatic',
+    'Protected by',
+    'Powered by',
+    'Are you a robot',
+    'Confirm you are human',
+    'Security verification required',
+];
+const ZH_CAPTCHA_TEXT_KEYWORDS = [
+    '请完成安全验证',
+    '请滑动验证',
+    '拖动滑块',
+    '点击验证',
+    '人机验证',
+    '安全检测中',
+    '请证明您是人类',
+    '正在检查您的浏览器',
+    '请稍候',
+    '验证您的身份',
+    '请完成验证',
+    '滑动滑块',
+    '请拖动滑块完成验证',
+];
+export const CAPTCHA_KEYWORDS = {
+    title: mergeUnique([
+        ...GENERIC_CAPTCHA_TITLE_KEYWORDS,
+        ...PROVIDER_CAPTCHA_TITLE_KEYWORDS,
+        ...ZH_CAPTCHA_TITLE_KEYWORDS,
+    ]),
+    url: mergeUnique([
+        ...GENERIC_CAPTCHA_URL_KEYWORDS,
+        ...EDGE_PROVIDER_URL_KEYWORDS,
+        ...EMBEDDED_WIDGET_URL_KEYWORDS,
+        ...REGIONAL_PROVIDER_URL_KEYWORDS,
+    ]),
+    text: mergeUnique([
+        ...GENERIC_CAPTCHA_TEXT_KEYWORDS,
+        ...ZH_CAPTCHA_TEXT_KEYWORDS,
+    ]),
+};

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

@@ -0,0 +1,2 @@
+import type { CaptchaDomRule } from '../../captcha/types.js';
+export declare const DOM_MATCH_RULES: readonly CaptchaDomRule[];

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

@@ -0,0 +1,28 @@
+import { CAPTCHA_SELECTORS } from '../../captcha/rules/selectors.js';
+export const DOM_MATCH_RULES = [
+    {
+        id: 'generic-slider-dom',
+        label: 'generic slider challenge selector',
+        selectors: CAPTCHA_SELECTORS.slider,
+        confidence: 92,
+        typeHint: 'slider',
+        requiresVisibility: true,
+        verifier: 'slider',
+    },
+    {
+        id: 'embedded-widget-dom',
+        label: 'embedded widget challenge selector',
+        selectors: CAPTCHA_SELECTORS.widget,
+        confidence: 98,
+        typeHint: 'widget',
+        providerHint: 'embedded_widget',
+    },
+    {
+        id: 'edge-browser-check-dom',
+        label: 'edge browser-check selector',
+        selectors: CAPTCHA_SELECTORS.browserCheck,
+        confidence: 97,
+        typeHint: 'browser_check',
+        providerHint: 'edge_service',
+    },
+];

package/dist/src/modules/captcha/rules/exclude-keywords.d.ts

@@ -0,0 +1,5 @@
+export declare const EXCLUDE_KEYWORDS: {
+    readonly title: string[];
+    readonly url: string[];
+    readonly text: string[];
+};

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

@@ -0,0 +1,44 @@
+import { mergeUnique } from '../../captcha/rules/shared.js';
+const OTP_EXCLUDE_TITLE_KEYWORDS = [
+    'verification code',
+    'enter code',
+    'sms code',
+    'email verification',
+    'phone verification',
+    'verify your email',
+    'verify your phone',
+];
+const OTP_EXCLUDE_URL_KEYWORDS = [
+    'verify-email',
+    'verify-phone',
+    'email-verification',
+    'account-verification',
+    'verify-account',
+    'phone-verification',
+    'sms-verification',
+    'reset-password',
+    'forgot-password',
+];
+const OTP_EXCLUDE_TEXT_KEYWORDS = [
+    'Enter verification code',
+    'Get code',
+    'Send code',
+    'Enter the code',
+    'We sent a code',
+    'verification code sent',
+    'Enter your authenticator code',
+    'Two-factor authentication',
+];
+const ZH_EXCLUDE_TITLE_KEYWORDS = ['短信验证', '邮箱验证', '输入验证码', '手机验证', '登录验证', '双重验证'];
+const ZH_EXCLUDE_URL_KEYWORDS = ['验证邮箱', '验证手机', '重置密码'];
+const ZH_EXCLUDE_TEXT_KEYWORDS = ['输入验证码', '获取验证码', '发送验证码', '已发送验证码', '双因素认证'];
+const AUTH_FLOW_TITLE_KEYWORDS = ['two-factor', '2fa', 'two-factor authentication'];
+export const EXCLUDE_KEYWORDS = {
+    title: mergeUnique([
+        ...OTP_EXCLUDE_TITLE_KEYWORDS,
+        ...ZH_EXCLUDE_TITLE_KEYWORDS,
+        ...AUTH_FLOW_TITLE_KEYWORDS,
+    ]),
+    url: mergeUnique([...OTP_EXCLUDE_URL_KEYWORDS, ...ZH_EXCLUDE_URL_KEYWORDS]),
+    text: mergeUnique([...OTP_EXCLUDE_TEXT_KEYWORDS, ...ZH_EXCLUDE_TEXT_KEYWORDS]),
+};

package/dist/src/modules/captcha/rules/fallback-keywords.d.ts

@@ -0,0 +1,2 @@
+export declare const FALLBACK_CAPTCHA_KEYWORDS: string[];
+export declare const FALLBACK_EXCLUDE_KEYWORDS: string[];

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

@@ -0,0 +1,49 @@
+import { mergeUnique } from '../../captcha/rules/shared.js';
+const FALLBACK_CAPTCHA_ENGLISH = [
+    'captcha',
+    'verification challenge',
+    'security check',
+    'human verification',
+    'slide to verify',
+    'drag the slider',
+    'select all images',
+    'i am not a robot',
+    'protected by security verification',
+    'checking your browser',
+];
+const FALLBACK_CAPTCHA_CHINESE = [
+    '验证码',
+    '人机验证',
+    '安全验证',
+    '滑动验证',
+    '拖动滑块',
+    '请完成验证',
+    '请完成安全验证',
+    '请证明您是人类',
+    '正在检查您的浏览器',
+];
+const FALLBACK_EXCLUDE_ENGLISH = [
+    'verification code',
+    'enter verification code',
+    'sms code',
+    'email verification',
+    'phone verification',
+    'two-factor authentication',
+    'authenticator code',
+];
+const FALLBACK_EXCLUDE_CHINESE = [
+    '输入验证码',
+    '短信验证码',
+    '邮箱验证码',
+    '获取验证码',
+    '发送验证码',
+    '双因素认证',
+];
+export const FALLBACK_CAPTCHA_KEYWORDS = mergeUnique([
+    ...FALLBACK_CAPTCHA_ENGLISH,
+    ...FALLBACK_CAPTCHA_CHINESE,
+]);
+export const FALLBACK_EXCLUDE_KEYWORDS = mergeUnique([
+    ...FALLBACK_EXCLUDE_ENGLISH,
+    ...FALLBACK_EXCLUDE_CHINESE,
+]);

package/dist/src/modules/captcha/rules/index.d.ts

@@ -0,0 +1,6 @@
+export { CAPTCHA_KEYWORDS } from '../../captcha/rules/captcha-keywords.js';
+export { DOM_MATCH_RULES } from '../../captcha/rules/dom-rules.js';
+export { EXCLUDE_KEYWORDS } from '../../captcha/rules/exclude-keywords.js';
+export { FALLBACK_CAPTCHA_KEYWORDS, FALLBACK_EXCLUDE_KEYWORDS, } from '../../captcha/rules/fallback-keywords.js';
+export { CAPTCHA_MATCH_RULES, EXCLUDE_MATCH_RULES } from '../../captcha/rules/assessment-rules.js';
+export { CAPTCHA_SELECTORS, EXCLUDE_SELECTORS } from '../../captcha/rules/selectors.js';

package/dist/src/modules/captcha/rules/index.js

@@ -0,0 +1,6 @@
+export { CAPTCHA_KEYWORDS } from '../../captcha/rules/captcha-keywords.js';
+export { DOM_MATCH_RULES } from '../../captcha/rules/dom-rules.js';
+export { EXCLUDE_KEYWORDS } from '../../captcha/rules/exclude-keywords.js';
+export { FALLBACK_CAPTCHA_KEYWORDS, FALLBACK_EXCLUDE_KEYWORDS, } from '../../captcha/rules/fallback-keywords.js';
+export { CAPTCHA_MATCH_RULES, EXCLUDE_MATCH_RULES } from '../../captcha/rules/assessment-rules.js';
+export { CAPTCHA_SELECTORS, EXCLUDE_SELECTORS } from '../../captcha/rules/selectors.js';

package/dist/src/modules/captcha/rules/selectors.d.ts

@@ -0,0 +1,8 @@
+export declare const EXCLUDE_SELECTORS: readonly ["[class*=\"video\"]", "[class*=\"player\"]", "[id*=\"video\"]", "[id*=\"player\"]", "[class*=\"swiper\"]", "[class*=\"carousel\"]", "[class*=\"banner\"]", "[class*=\"gallery\"]", "[class*=\"douyin\"]", "[class*=\"tiktok\"]", "[class*=\"scroll\"]", "[class*=\"scrollbar\"]", "[class*=\"progress\"]", "[class*=\"range\"]", "[class*=\"volume\"]"];
+export declare const CAPTCHA_SELECTORS: {
+    readonly slider: 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]"];
+    readonly image: readonly ["[class*=\"captcha-image\"]", "[id*=\"captcha-image\"]", ".verify-img", ".captcha-img", "img[src*=\"captcha\"]", "img[alt*=\"\"]", "img[alt*=\"captcha\"]"];
+    readonly widget: 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\"]"];
+    readonly browserCheck: readonly ["#challenge-form", "[id*=\"challenge-form\"]", "[class*=\"browser-check\"]", "[class*=\"security-check\"]", "[class*=\"challenge-page\"]", "[class*=\"challenge-container\"]"];
+    readonly generic: readonly ["[class*=\"captcha\"]", "[id*=\"captcha\"]", "[class*=\"verify\"]", "[id*=\"verify\"]", "[class*=\"challenge\"]", "[id*=\"challenge\"]", "iframe[src*=\"captcha\"]", "iframe[src*=\"verify\"]"];
+};

package/dist/src/modules/captcha/rules/selectors.js

@@ -0,0 +1,67 @@
+export const EXCLUDE_SELECTORS = [
+    '[class*="video"]',
+    '[class*="player"]',
+    '[id*="video"]',
+    '[id*="player"]',
+    '[class*="swiper"]',
+    '[class*="carousel"]',
+    '[class*="banner"]',
+    '[class*="gallery"]',
+    '[class*="douyin"]',
+    '[class*="tiktok"]',
+    '[class*="scroll"]',
+    '[class*="scrollbar"]',
+    '[class*="progress"]',
+    '[class*="range"]',
+    '[class*="volume"]',
+];
+export const CAPTCHA_SELECTORS = {
+    slider: [
+        '.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]',
+    ],
+    image: [
+        '[class*="captcha-image"]',
+        '[id*="captcha-image"]',
+        '.verify-img',
+        '.captcha-img',
+        'img[src*="captcha"]',
+        'img[alt*=""]',
+        'img[alt*="captcha"]',
+    ],
+    widget: [
+        '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"]',
+    ],
+    browserCheck: [
+        '#challenge-form',
+        '[id*="challenge-form"]',
+        '[class*="browser-check"]',
+        '[class*="security-check"]',
+        '[class*="challenge-page"]',
+        '[class*="challenge-container"]',
+    ],
+    generic: [
+        '[class*="captcha"]',
+        '[id*="captcha"]',
+        '[class*="verify"]',
+        '[id*="verify"]',
+        '[class*="challenge"]',
+        '[id*="challenge"]',
+        'iframe[src*="captcha"]',
+        'iframe[src*="verify"]',
+    ],
+};

package/dist/src/modules/captcha/rules/shared.d.ts

@@ -0,0 +1 @@
+export declare function mergeUnique(values: readonly string[]): string[];

package/dist/src/modules/captcha/rules/shared.js

@@ -0,0 +1,3 @@
+export function mergeUnique(values) {
+    return [...new Set(values)];
+}

package/dist/src/modules/captcha/types.d.ts

@@ -0,0 +1,97 @@
+export declare const CAPTCHA_TYPES: readonly ["slider", "image", "widget", "browser_check", "page_redirect", "url_redirect", "text_input", "none", "unknown"];
+export type CaptchaType = (typeof CAPTCHA_TYPES)[number];
+export declare const CAPTCHA_PROVIDER_HINTS: readonly ["regional_service", "embedded_widget", "edge_service", "managed_service", "external_review", "unknown"];
+export type CaptchaProviderHint = (typeof CAPTCHA_PROVIDER_HINTS)[number];
+export declare const LEGACY_CAPTCHA_TYPE_ALIASES: Readonly<Record<string, CaptchaType>>;
+export declare const LEGACY_CAPTCHA_PROVIDER_HINT_ALIASES: Readonly<Record<string, CaptchaProviderHint>>;
+export interface CaptchaDetectionResultBase {
+    detected: boolean;
+    type: CaptchaType;
+    providerHint?: CaptchaProviderHint;
+    confidence: number;
+}
+export interface CaptchaDetectionResult extends CaptchaDetectionResultBase {
+    selector?: string;
+    title?: string;
+    url?: string;
+    details?: unknown;
+    falsePositiveReason?: string;
+}
+export declare const CAPTCHA_SIGNAL_SOURCES: readonly ["url", "title", "dom", "text", "vendor"];
+export type CaptchaSignalSource = (typeof CAPTCHA_SIGNAL_SOURCES)[number];
+export declare const CAPTCHA_SIGNAL_KINDS: readonly ["captcha", "exclude"];
+export type CaptchaSignalKind = (typeof CAPTCHA_SIGNAL_KINDS)[number];
+export interface CaptchaSignal {
+    source: CaptchaSignalSource;
+    kind: CaptchaSignalKind;
+    value: string;
+    confidence: number;
+    typeHint?: CaptchaType;
+    providerHint?: CaptchaProviderHint;
+    details?: unknown;
+}
+export interface CaptchaHeuristicRule {
+    id: string;
+    label: string;
+    pattern: RegExp;
+    confidence: number;
+    requiresDomConfirmation?: boolean;
+    typeHint?: Exclude<CaptchaType, 'none'>;
+    providerHint?: CaptchaProviderHint;
+}
+export interface CaptchaDomRule {
+    id: string;
+    label: string;
+    selectors: readonly string[];
+    confidence: number;
+    typeHint: Exclude<CaptchaType, 'none'>;
+    providerHint?: CaptchaProviderHint;
+    requiresVisibility?: boolean;
+    verifier?: 'slider';
+}
+export interface CaptchaCandidate {
+    source: CaptchaSignalSource;
+    value: string;
+    confidence: number;
+    type: Exclude<CaptchaType, 'none'>;
+    providerHint?: CaptchaProviderHint;
+}
+export declare const CAPTCHA_NEXT_STEPS: readonly ["ignore", "observe", "ask_ai", "manual", "switch_to_headed"];
+export type CaptchaNextStep = (typeof CAPTCHA_NEXT_STEPS)[number];
+export interface CaptchaAssessment {
+    signals: CaptchaSignal[];
+    candidates: CaptchaCandidate[];
+    score: number;
+    excludeScore: number;
+    confidence: number;
+    likelyCaptcha: boolean;
+    recommendedNextStep: CaptchaNextStep;
+    primaryDetection: CaptchaDetectionResult;
+}
+export interface CaptchaLocation {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface AICaptchaDetectionResult extends CaptchaDetectionResultBase {
+    reasoning: string;
+    location?: CaptchaLocation | null;
+    screenshot?: string;
+    screenshotPath?: string;
+    suggestions?: string[];
+}
+export interface CaptchaDetectionConfig {
+    autoDetectCaptcha?: boolean;
+    autoSwitchHeadless?: boolean;
+    captchaTimeout?: number;
+    defaultHeadless?: boolean;
+    askBeforeSwitchBack?: boolean;
+}
+export interface CaptchaPageInfo {
+    url: string;
+    title: string;
+    bodyText: string;
+    hasIframes: boolean;
+    suspiciousElements: string[];
+}

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

@@ -0,0 +1,44 @@
+export const CAPTCHA_TYPES = [
+    'slider',
+    'image',
+    'widget',
+    'browser_check',
+    'page_redirect',
+    'url_redirect',
+    'text_input',
+    'none',
+    'unknown',
+];
+export const CAPTCHA_PROVIDER_HINTS = [
+    'regional_service',
+    'embedded_widget',
+    'edge_service',
+    'managed_service',
+    'external_review',
+    'unknown',
+];
+export const LEGACY_CAPTCHA_TYPE_ALIASES = {
+    checkbox: 'widget',
+    challenge_widget: 'widget',
+    browsercheck: 'browser_check',
+    'browser-check': 'browser_check',
+    redirect: 'page_redirect',
+};
+export const LEGACY_CAPTCHA_PROVIDER_HINT_ALIASES = {
+    regional: 'regional_service',
+    embedded: 'embedded_widget',
+    widget: 'embedded_widget',
+    edge: 'edge_service',
+    managed: 'managed_service',
+    'external-ai-required': 'external_review',
+    unknown: 'unknown',
+};
+export const CAPTCHA_SIGNAL_SOURCES = ['url', 'title', 'dom', 'text', 'vendor'];
+export const CAPTCHA_SIGNAL_KINDS = ['captcha', 'exclude'];
+export const CAPTCHA_NEXT_STEPS = [
+    'ignore',
+    'observe',
+    'ask_ai',
+    'manual',
+    'switch_to_headed',
+];

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

@@ -0,0 +1,116 @@
+import type { Browser, Page } from 'rebrowser-puppeteer-core';
+import type { CollectCodeOptions, CollectCodeResult, CodeFile, PuppeteerConfig } from '../../types/index.js';
+import { CodeCache } from '../collector/CodeCache.js';
+import { SmartCodeCollector } from '../collector/SmartCodeCollector.js';
+import { CodeCompressor } from '../collector/CodeCompressor.js';
+export declare class CodeCollector {
+    private config;
+    private browser;
+    private collectedUrls;
+    private initPromise;
+    private collectLock;
+    private readonly MAX_COLLECTED_URLS;
+    private readonly MAX_FILES_PER_COLLECT;
+    private readonly MAX_RESPONSE_SIZE;
+    private readonly MAX_SINGLE_FILE_SIZE;
+    private readonly viewport;
+    private readonly userAgent;
+    private collectedFilesCache;
+    private cache;
+    cacheEnabled: boolean;
+    smartCollector: SmartCodeCollector;
+    private compressor;
+    private cdpSession;
+    cdpListeners: {
+        responseReceived?: (params: unknown) => void;
+    };
+    private activePageIndex;
+    private currentHeadless;
+    private explicitlyClosed;
+    constructor(config: PuppeteerConfig);
+    setCacheEnabled(enabled: boolean): void;
+    clearFileCache(): Promise<void>;
+    getFileCacheStats(): Promise<{
+        memoryEntries: number;
+        diskEntries: number;
+        totalSize: number;
+    }>;
+    clearAllData(): Promise<void>;
+    getAllStats(): Promise<{
+        cache: {
+            memoryEntries: number;
+            diskEntries: number;
+            totalSize: number;
+        };
+        compression: {
+            cacheSize: number;
+            totalCompressed: number;
+            totalOriginalSize: number;
+            totalCompressedSize: number;
+            averageRatio: number;
+            cacheHits: number;
+            cacheMisses: number;
+            totalTime: number;
+        };
+        collector: {
+            collectedUrls: number;
+            maxCollectedUrls: number;
+        };
+    }>;
+    getCache(): CodeCache;
+    getCompressor(): CodeCompressor;
+    cleanupCollectedUrls(): void;
+    init(headless?: boolean): Promise<void>;
+    private initInner;
+    private resolveExecutablePath;
+    close(): Promise<void>;
+    getActivePage(): Promise<Page>;
+    listPages(): Promise<Array<{
+        index: number;
+        url: string;
+        title: string;
+    }>>;
+    selectPage(index: number): Promise<void>;
+    createPage(url?: string): Promise<Page>;
+    private applyAntiDetection;
+    getStatus(): Promise<{
+        running: boolean;
+        pagesCount: number;
+        version?: string;
+        effectiveHeadless?: boolean;
+    }>;
+    collect(options: CollectCodeOptions): Promise<CollectCodeResult>;
+    private collectInner;
+    shouldCollectUrl(url: string, filterRules?: string[]): boolean;
+    navigateWithRetry(page: Page, url: string, options: NonNullable<Parameters<Page['goto']>[1]>, maxRetries?: number): Promise<void>;
+    getPerformanceMetrics(page: Page): Promise<Record<string, number>>;
+    collectPageMetadata(page: Page): Promise<Record<string, unknown>>;
+    connect(endpoint: string): Promise<void>;
+    getBrowser(): Browser | null;
+    getCollectionStats(): {
+        totalCollected: number;
+        uniqueUrls: number;
+    };
+    clearCache(): void;
+    getCollectedFilesSummary(): Array<{
+        url: string;
+        size: number;
+        type: string;
+        truncated?: boolean;
+        originalSize?: number;
+    }>;
+    getFileByUrl(url: string): CodeFile | null;
+    getFilesByPattern(pattern: string, limit?: number, maxTotalSize?: number): {
+        files: CodeFile[];
+        totalSize: number;
+        matched: number;
+        returned: number;
+        truncated: boolean;
+    };
+    getTopPriorityFiles(topN?: number, maxTotalSize?: number): {
+        files: CodeFile[];
+        totalSize: number;
+        totalFiles: number;
+    };
+    clearCollectedFilesCache(): void;
+}