@jshookmcp/jshook 0.1.9 → 0.2.1

package/dist/src/config/search-defaults.d.ts

@@ -0,0 +1,42 @@
+export declare const DEFAULT_QUERY_CATEGORY_PROFILE_CONFIGS: {
+    pattern: string;
+    flags: string;
+    domainBoosts: {
+        domain: string;
+        weight: number;
+    }[];
+}[];
+export declare const DEFAULT_CJK_QUERY_ALIAS_CONFIGS: {
+    pattern: string;
+    tokens: string[];
+}[];
+export declare const DEFAULT_INTENT_TOOL_BOOST_RULE_CONFIGS: {
+    pattern: string;
+    flags: string;
+    boosts: {
+        tool: string;
+        bonus: number;
+    }[];
+}[];
+export declare const DEFAULT_SEARCH_CONFIG: {
+    queryCategoryProfiles: {
+        pattern: string;
+        flags: string;
+        domainBoosts: {
+            domain: string;
+            weight: number;
+        }[];
+    }[];
+    cjkQueryAliases: {
+        pattern: string;
+        tokens: string[];
+    }[];
+    intentToolBoostRules: {
+        pattern: string;
+        flags: string;
+        boosts: {
+            tool: string;
+            bonus: number;
+        }[];
+    }[];
+};

package/dist/src/config/search-defaults.js

@@ -0,0 +1,146 @@
+export const DEFAULT_QUERY_CATEGORY_PROFILE_CONFIGS = [
+    {
+        pattern: '(?:security|vuln|xss|injection|csrf|exploit|attack|prototype\\s*pollution|漏洞|安全|注入|攻击)',
+        flags: 'i',
+        domainBoosts: [
+            { domain: 'security', weight: 1.6 },
+            { domain: 'analysis', weight: 1.2 },
+        ],
+    },
+    {
+        pattern: '(?:debug|breakpoint|pause|step\\s*over|step\\s*into|stack\\s*trace|断点|调试|单步)',
+        flags: 'i',
+        domainBoosts: [
+            { domain: 'debugger', weight: 1.6 },
+            { domain: 'runtime', weight: 1.2 },
+        ],
+    },
+    {
+        pattern: '(?:network|request|response|header|cookie|fetch|xhr|网络|请求|抓包)',
+        flags: 'i',
+        domainBoosts: [
+            { domain: 'network', weight: 1.6 },
+            { domain: 'browser', weight: 1.1 },
+        ],
+    },
+    {
+        pattern: '(?:transform|deobfuscate|beautify|minify|decode|encode|解密|混淆|反混淆|转换)',
+        flags: 'i',
+        domainBoosts: [
+            { domain: 'transform', weight: 1.6 },
+            { domain: 'analysis', weight: 1.2 },
+        ],
+    },
+    {
+        pattern: '(?:memory|heap|dump|scan|inject|内存|堆|扫描)',
+        flags: 'i',
+        domainBoosts: [
+            { domain: 'memory', weight: 1.6 },
+            { domain: 'native', weight: 1.2 },
+        ],
+    },
+    {
+        pattern: '(?:wasm|webassembly)',
+        flags: 'i',
+        domainBoosts: [{ domain: 'wasm', weight: 1.6 }],
+    },
+    {
+        pattern: '(?:browser|page|tab|navigate|click|screenshot|浏览器|页面|标签)',
+        flags: 'i',
+        domainBoosts: [{ domain: 'browser', weight: 1.4 }],
+    },
+    {
+        pattern: '(?:captcha|人机验证|验证码|图形验证)',
+        flags: 'i',
+        domainBoosts: [
+            { domain: 'captcha', weight: 1.6 },
+            { domain: 'browser', weight: 1.1 },
+        ],
+    },
+];
+export const DEFAULT_CJK_QUERY_ALIAS_CONFIGS = [
+    { pattern: '工作流|流程编排|流程自动化|编排', tokens: ['workflow', 'flow', 'orchestration'] },
+    { pattern: '抓包|抓取|采集|捕获', tokens: ['capture', 'sniff', 'collect'] },
+    { pattern: '接口|端点', tokens: ['api', 'endpoint', 'request'] },
+    { pattern: '探测|探针|扫描', tokens: ['probe', 'scan'] },
+    { pattern: '账号|账户|用户', tokens: ['account', 'user'] },
+    { pattern: '注册|开户|报名', tokens: ['register', 'signup'] },
+    { pattern: '验证|校验|激活', tokens: ['verify', 'verification', 'activation'] },
+    { pattern: '验证码|图形验证码|人机验证', tokens: ['captcha', 'verify', 'verification'] },
+    { pattern: '邮箱|邮件', tokens: ['email', 'mail'] },
+    { pattern: 'keygen|密钥|注册码|激活码', tokens: ['keygen', 'key', 'activation'] },
+    { pattern: '轮询|监听', tokens: ['poll', 'watch'] },
+    { pattern: '批量|并发', tokens: ['batch', 'parallel'] },
+    { pattern: '令牌|凭证|鉴权|认证', tokens: ['token', 'auth', 'credential'] },
+    { pattern: '提取|抽取|解析', tokens: ['extract', 'parse'] },
+    { pattern: '多标签页|多标签|标签页', tokens: ['tab', 'multi'] },
+    { pattern: '脚本库|脚本仓库', tokens: ['script', 'library'] },
+    { pattern: '脚本', tokens: ['script'] },
+    { pattern: '执行|运行', tokens: ['run', 'execute'] },
+    { pattern: '导出', tokens: ['export'] },
+    { pattern: '回放|重放', tokens: ['replay'] },
+    { pattern: '请求', tokens: ['request'] },
+];
+export const DEFAULT_INTENT_TOOL_BOOST_RULE_CONFIGS = [
+    {
+        pattern: '(?:端到端闭环|全链路闭环|一键闭环|api(?:[_\\s-]*)capture(?:[_\\s-]*)session|web_api_capture_session|抓取接口|抓包流程)',
+        flags: 'i',
+        boosts: [
+            { tool: 'web_api_capture_session', bonus: 26 },
+            { tool: 'api_probe_batch', bonus: 18 },
+            { tool: 'network_extract_auth', bonus: 10 },
+            { tool: 'network_export_har', bonus: 8 },
+        ],
+    },
+    {
+        pattern: '(?:register|signup|sign\\s*up|账号注册|账户注册|邮箱验证|验证账号|激活账号|注册验证|验证码|邮箱激活|激活链接|mail\\s*verify|email\\s*verify|account\\s*pending|keygen)',
+        flags: 'i',
+        boosts: [
+            { tool: 'run_extension_workflow', bonus: 40 },
+            { tool: 'list_extension_workflows', bonus: 24 },
+            { tool: 'register_account_flow', bonus: 20 },
+            { tool: 'batch_register', bonus: 18 },
+            { tool: 'tab_workflow', bonus: 8 },
+        ],
+    },
+    {
+        pattern: '(?:script\\s*library|script\\s*preset|run\\s*script|脚本库执行|脚本库|执行脚本)',
+        flags: 'i',
+        boosts: [
+            { tool: 'page_script_run', bonus: 22 },
+            { tool: 'page_script_register', bonus: 16 },
+            { tool: 'run_extension_workflow', bonus: 10 },
+        ],
+    },
+    {
+        pattern: '(?:bundle|webpack|js\\s*bundle|脚本包|静态包|源码包)',
+        flags: 'i',
+        boosts: [
+            { tool: 'js_bundle_search', bonus: 20 },
+            { tool: 'source_map_extract', bonus: 10 },
+            { tool: 'webpack_enumerate', bonus: 8 },
+        ],
+    },
+    {
+        pattern: '(?:workflow|orchestration|工作流|流程编排|流程自动化)',
+        flags: 'i',
+        boosts: [
+            { tool: 'run_extension_workflow', bonus: 26 },
+            { tool: 'list_extension_workflows', bonus: 16 },
+            { tool: 'web_api_capture_session', bonus: 8 },
+        ],
+    },
+    {
+        pattern: '(?=.*(?:抓包|抓取|捕获|capture|sniff|collect))(?=.*(?:鉴权|认证|令牌|凭证|jwt|token|auth|credential))',
+        flags: 'i',
+        boosts: [
+            { tool: 'web_api_capture_session', bonus: 20 },
+            { tool: 'network_extract_auth', bonus: 18 },
+        ],
+    },
+];
+export const DEFAULT_SEARCH_CONFIG = {
+    queryCategoryProfiles: DEFAULT_QUERY_CATEGORY_PROFILE_CONFIGS,
+    cjkQueryAliases: DEFAULT_CJK_QUERY_ALIAS_CONFIGS,
+    intentToolBoostRules: DEFAULT_INTENT_TOOL_BOOST_RULE_CONFIGS,
+};

package/dist/src/constants.d.ts

@@ -60,21 +60,8 @@ export declare const WORKFLOW_BUNDLE_CACHE_TTL_MS: number;
 export declare const WORKFLOW_BUNDLE_CACHE_MAX_BYTES: number;
 export declare const SEARCH_WORKFLOW_BOOST_TIERS: Set<string>;
 export declare const SEARCH_WORKFLOW_DOMAIN_BOOST_MULTIPLIER: number;
-export type SearchIntentToolBoostRuleConfig = {
-    pattern: string;
-    flags?: string;
-    boosts: Array<{
-        tool: string;
-        bonus: number;
-    }>;
-};
-export declare const SEARCH_INTENT_TOOL_BOOST_RULES_OVERRIDE: SearchIntentToolBoostRuleConfig[] | null;
-export declare const DYNAMIC_BOOST_ENABLED: boolean;
-export type DynamicBoostStrategy = 'max' | 'top1' | 'majority' | 'weighted';
-export declare const DYNAMIC_BOOST_STRATEGY: DynamicBoostStrategy;
-export declare const DYNAMIC_BOOST_SKIP_SEARCH_TO_FULL: boolean;
-export declare const DYNAMIC_BOOST_MAX_JUMP: number;
-export declare const DYNAMIC_BOOST_RERESEARCH_AFTER_BOOST: boolean;
+export declare const ACTIVATION_TTL_MINUTES: number;
+export declare const SEARCH_AUTO_ACTIVATE_DOMAINS: boolean;
 export declare const SEARCH_TFIDF_COSINE_WEIGHT: number;
 export declare const SEARCH_AFFINITY_BOOST_FACTOR: number;
 export declare const SEARCH_AFFINITY_TOP_N: number;

package/dist/src/constants.js

@@ -40,17 +40,6 @@ const csv = (key, fallback) => {
         .filter(Boolean);
     return parsed.length > 0 ? parsed : fallback;
 };
-const json = (key, fallback) => {
-    const v = process.env[key];
-    if (!v)
-        return fallback;
-    try {
-        return JSON.parse(v);
-    }
-    catch {
-        return fallback;
-    }
-};
 export const DEBUG_PORT_CANDIDATES = list('DEBUG_PORT_CANDIDATES', [9222, 9229, 9333, 2039]);
 export const DEFAULT_DEBUG_PORT = int('DEFAULT_DEBUG_PORT', 9222);
 export const GHIDRA_BRIDGE_ENDPOINT = str('GHIDRA_BRIDGE_URL', 'http://127.0.0.1:18080');
@@ -115,12 +104,8 @@ export const WORKFLOW_BUNDLE_CACHE_TTL_MS = int('WORKFLOW_BUNDLE_CACHE_TTL_MS',
 export const WORKFLOW_BUNDLE_CACHE_MAX_BYTES = int('WORKFLOW_BUNDLE_CACHE_MAX_BYTES', 100 * 1024 * 1024);
 export const SEARCH_WORKFLOW_BOOST_TIERS = new Set(csv('SEARCH_WORKFLOW_BOOST_TIERS', ['workflow', 'full']));
 export const SEARCH_WORKFLOW_DOMAIN_BOOST_MULTIPLIER = float('SEARCH_WORKFLOW_DOMAIN_BOOST_MULTIPLIER', 1.5);
-export const SEARCH_INTENT_TOOL_BOOST_RULES_OVERRIDE = json('SEARCH_INTENT_TOOL_BOOST_RULES_JSON', null);
-export const DYNAMIC_BOOST_ENABLED = bool('DYNAMIC_BOOST_ENABLED', true);
-export const DYNAMIC_BOOST_STRATEGY = str('DYNAMIC_BOOST_STRATEGY', 'majority');
-export const DYNAMIC_BOOST_SKIP_SEARCH_TO_FULL = bool('DYNAMIC_BOOST_SKIP_SEARCH_TO_FULL', true);
-export const DYNAMIC_BOOST_MAX_JUMP = int('DYNAMIC_BOOST_MAX_JUMP', 1);
-export const DYNAMIC_BOOST_RERESEARCH_AFTER_BOOST = bool('DYNAMIC_BOOST_RERESEARCH_AFTER_BOOST', false);
+export const ACTIVATION_TTL_MINUTES = int('ACTIVATION_TTL_MINUTES', 30);
+export const SEARCH_AUTO_ACTIVATE_DOMAINS = bool('SEARCH_AUTO_ACTIVATE_DOMAINS', true);
 export const SEARCH_TFIDF_COSINE_WEIGHT = float('SEARCH_TFIDF_COSINE_WEIGHT', 0.3);
 export const SEARCH_AFFINITY_BOOST_FACTOR = float('SEARCH_AFFINITY_BOOST_FACTOR', 0.15);
 export const SEARCH_AFFINITY_TOP_N = int('SEARCH_AFFINITY_TOP_N', 5);

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/collector/CodeCollector.d.ts

@@ -3,16 +3,32 @@ import type { CollectCodeOptions, CollectCodeResult, CodeFile, PuppeteerConfig }
 import { CodeCache } from '../collector/CodeCache.js';
 import { SmartCodeCollector } from '../collector/SmartCodeCollector.js';
 import { CodeCompressor } from '../collector/CodeCompressor.js';
+type ChromeReleaseChannel = 'stable' | 'beta' | 'dev' | 'canary';
+export interface ChromeConnectOptions {
+    browserURL?: string;
+    wsEndpoint?: string;
+    autoConnect?: boolean;
+    channel?: ChromeReleaseChannel;
+    userDataDir?: string;
+}
+export interface ResolvedPageDescriptor {
+    index: number;
+    url: string;
+    title: string;
+    page: Page;
+}
 export declare class CodeCollector {
     private config;
     private browser;
     private collectedUrls;
     private initPromise;
     private collectLock;
+    private connectAttemptId;
     private readonly MAX_COLLECTED_URLS;
     private readonly MAX_FILES_PER_COLLECT;
     private readonly MAX_RESPONSE_SIZE;
     private readonly MAX_SINGLE_FILE_SIZE;
+    private readonly CONNECT_TIMEOUT_MS;
     private readonly viewport;
     private readonly userAgent;
     private collectedFilesCache;
@@ -27,6 +43,7 @@ export declare class CodeCollector {
     private activePageIndex;
     private currentHeadless;
     private explicitlyClosed;
+    private connectedToExistingBrowser;
     constructor(config: PuppeteerConfig);
     setCacheEnabled(enabled: boolean): void;
     clearFileCache(): Promise<void>;
@@ -64,12 +81,16 @@ export declare class CodeCollector {
     private initInner;
     private resolveExecutablePath;
     close(): Promise<void>;
+    private getPageTargets;
+    private resolvePageTargetHandle;
+    isExistingBrowserConnection(): boolean;
     getActivePage(): Promise<Page>;
     listPages(): Promise<Array<{
         index: number;
         url: string;
         title: string;
     }>>;
+    listResolvedPages(timeoutMs?: number): Promise<ResolvedPageDescriptor[]>;
     selectPage(index: number): Promise<void>;
     createPage(url?: string): Promise<Page>;
     private applyAntiDetection;
@@ -85,7 +106,15 @@ export declare class CodeCollector {
     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>;
+    private resolveDefaultChromeUserDataDir;
+    private resolveAutoConnectWsEndpoint;
+    private resolveConnectOptions;
+    private isAutoConnectRequest;
+    private getUnknownErrorMessage;
+    private normalizeConnectError;
+    private buildConnectTimeoutError;
+    private connectWithTimeout;
+    connect(endpointOrOptions: string | ChromeConnectOptions): Promise<void>;
     getBrowser(): Browser | null;
     getCollectionStats(): {
         totalCollected: number;
@@ -114,3 +143,4 @@ export declare class CodeCollector {
     };
     clearCollectedFilesCache(): void;
 }
+export {};