@jshookmcp/jshook 0.1.2

package/dist/server/domains/browser/definitions.tools.page-system.js.map

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

package/dist/server/domains/browser/definitions.tools.runtime.d.ts

@@ -0,0 +1,3 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const browserRuntimeTools: Tool[];
+//# sourceMappingURL=definitions.tools.runtime.d.ts.map

package/dist/server/domains/browser/definitions.tools.runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.tools.runtime.d.ts","sourceRoot":"","sources":["../../../../src/server/domains/browser/definitions.tools.runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D,eAAO,MAAM,mBAAmB,EAAE,IAAI,EA2LrC,CAAC"}

package/dist/server/domains/browser/definitions.tools.runtime.js

@@ -0,0 +1,183 @@
+export const browserRuntimeTools = [
+    {
+        name: 'get_detailed_data',
+        description: ` Retrieve detailed data using detailId token.
+
+When tools return large data, they provide a detailId instead of full data to prevent context overflow.
+Use this tool to retrieve the full data or specific parts.
+
+Examples:
+- get_detailed_data("detail_abc123") -> Get full data
+- get_detailed_data("detail_abc123", path="frontierSign") -> Get specific property
+- get_detailed_data("detail_abc123", path="methods.0") -> Get first method`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                detailId: {
+                    type: 'string',
+                    description: 'Detail ID token from previous tool response',
+                },
+                path: {
+                    type: 'string',
+                    description: 'Optional: Path to specific data (e.g., "frontierSign" or "methods.0")',
+                },
+            },
+            required: ['detailId'],
+        },
+    },
+    {
+        name: 'browser_launch',
+        description: `Launch browser instance.
+
+Drivers:
+- chrome (default): rebrowser-puppeteer-core, Chromium-based, full CDP support (debugger, network, stealth scripts, etc.)
+- camoufox: Firefox-based anti-detect browser, C++ engine-level fingerprint spoofing.
+  Requires binaries first: npx camoufox-js fetch
+  Note: CDP tools (debugger, network monitor, etc.) are not available in camoufox mode.
+
+Modes:
+- launch (default): launch a local browser instance
+- connect: reuse an existing browser instance
+  - chrome: connect via browserURL (http://host:port) or wsEndpoint
+  - camoufox: connect via wsEndpoint from camoufox_server_launch`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                driver: {
+                    type: 'string',
+                    description: 'Browser driver. chrome = rebrowser-puppeteer-core (full CDP support). camoufox = Firefox anti-detect (requires: npx camoufox-js fetch).',
+                    enum: ['chrome', 'camoufox'],
+                    default: 'chrome',
+                },
+                headless: {
+                    type: 'boolean',
+                    description: 'Run headless (default follows PUPPETEER_HEADLESS env; set false to show browser window for manual login)',
+                    default: false,
+                },
+                os: {
+                    type: 'string',
+                    description: 'OS fingerprint to spoof (camoufox only)',
+                    enum: ['windows', 'macos', 'linux'],
+                    default: 'windows',
+                },
+                mode: {
+                    type: 'string',
+                    description: 'Launch mode. launch = start local browser. connect = reuse existing browser (chrome: browserURL/wsEndpoint, camoufox: wsEndpoint).',
+                    enum: ['launch', 'connect'],
+                    default: 'launch',
+                },
+                browserURL: {
+                    type: 'string',
+                    description: 'HTTP URL of existing browser debug endpoint (chrome connect mode). Example: http://127.0.0.1:9222',
+                },
+                wsEndpoint: {
+                    type: 'string',
+                    description: 'WebSocket endpoint to connect to (chrome or camoufox connect mode). For camoufox, get this from camoufox_server_launch.',
+                },
+            },
+        },
+    },
+    {
+        name: 'camoufox_server_launch',
+        description: `Launch a Camoufox WebSocket server for multi-process / remote connections.
+
+Use this when you need concurrent browser instances or want to manage the browser lifecycle separately from the automation client.
+
+Steps:
+1. Call camoufox_server_launch → get wsEndpoint
+2. Call browser_launch(driver="camoufox", mode="connect", wsEndpoint=<endpoint>) from one or more sessions
+3. Use page_navigate and other tools normally
+4. Call camoufox_server_close when done
+
+Requires binaries: npx camoufox-js fetch`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                port: {
+                    type: 'number',
+                    description: 'Port to listen on (default: auto-assigned)',
+                },
+                ws_path: {
+                    type: 'string',
+                    description: 'WebSocket path (default: auto-generated)',
+                },
+                os: {
+                    type: 'string',
+                    description: 'OS fingerprint to spoof',
+                    enum: ['windows', 'macos', 'linux'],
+                    default: 'windows',
+                },
+                headless: {
+                    type: 'boolean',
+                    description: 'Run headless (default: true)',
+                    default: true,
+                },
+            },
+        },
+    },
+    {
+        name: 'camoufox_server_close',
+        description: 'Close the Camoufox WebSocket server. Connected clients are disconnected.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'camoufox_server_status',
+        description: 'Get the current status of the Camoufox WebSocket server (running, wsEndpoint).',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'browser_attach',
+        description: `Attach to an existing browser instance via Chrome DevTools Protocol (CDP).
+
+Use this when a browser is already running with remote debugging enabled.
+Supports both browserURL (http://host:port) and WebSocket endpoint (ws://...).
+
+Example:
+- browser_attach(browserURL="http://127.0.0.1:9222")
+- browser_attach(wsEndpoint="ws://127.0.0.1:9222/devtools/browser/xxx")
+- browser_attach(browserURL="http://127.0.0.1:9222", pageIndex=0)
+
+After attaching, use page_navigate / page_screenshot / debugger_enable normally.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                browserURL: {
+                    type: 'string',
+                    description: 'HTTP URL of the remote debugging endpoint (e.g., http://127.0.0.1:9222)',
+                },
+                wsEndpoint: {
+                    type: 'string',
+                    description: 'WebSocket URL from /json/version (e.g., ws://127.0.0.1:9222/devtools/browser/xxx)',
+                },
+                pageIndex: {
+                    type: 'number',
+                    description: 'Index of the page/tab to activate (default: 0)',
+                    default: 0,
+                },
+            },
+        },
+    },
+    {
+        name: 'browser_close',
+        description: 'Close browser instance',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'browser_status',
+        description: 'Get browser status (running, pages count, version)',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+];
+//# sourceMappingURL=definitions.tools.runtime.js.map

package/dist/server/domains/browser/definitions.tools.runtime.js.map

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

package/dist/server/domains/browser/definitions.tools.security.d.ts

@@ -0,0 +1,3 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const browserSecurityStateTools: Tool[];
+//# sourceMappingURL=definitions.tools.security.d.ts.map

package/dist/server/domains/browser/definitions.tools.security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.tools.security.d.ts","sourceRoot":"","sources":["../../../../src/server/domains/browser/definitions.tools.security.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D,eAAO,MAAM,yBAAyB,EAAE,IAAI,EAmO3C,CAAC"}

package/dist/server/domains/browser/definitions.tools.security.js

@@ -0,0 +1,225 @@
+export const browserSecurityStateTools = [
+    {
+        name: 'captcha_detect',
+        description: `Detect CAPTCHA on the current page using AI vision analysis.
+
+Detection process:
+1. Takes a screenshot and analyzes it with AI (Vision LLM)
+2. Applies rule-based detection as fallback if AI unavailable
+3. Returns detection result with confidence score
+
+Supported CAPTCHA types:
+- Slider CAPTCHA: drag-to-verify style challenges
+- Image CAPTCHA: select-images challenges
+- reCAPTCHA / hCaptcha
+- Cloudflare Challenge
+- Custom CAPTCHA implementations
+
+Response fields:
+- detected: whether CAPTCHA was found
+- type: CAPTCHA type identifier
+- vendor: vendor name if identified
+- confidence: detection confidence (0-100)
+- reasoning: AI analysis explanation
+- screenshot: base64 screenshot (if MCP cannot view images, use external AI)
+- suggestions: recommended next steps
+
+Note:
+When the MCP LLM cannot access Vision API directly, the screenshot is provided as base64.
+Use an external AI (GPT-4o, Claude 3) to analyze the screenshot.`,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'captcha_wait',
+        description: `Wait for the user to manually solve a CAPTCHA.
+
+Steps:
+1. CAPTCHA is detected on the page
+2. Browser switches to headed (visible) mode
+3. User solves the CAPTCHA manually
+4. Script resumes automatically after detection
+
+Timeout: default 300000ms (5 minutes)`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                timeout: {
+                    type: 'number',
+                    description: 'Timeout in milliseconds (default: 300000 = 5 minutes)',
+                    default: 300000,
+                },
+            },
+        },
+    },
+    {
+        name: 'captcha_config',
+        description: `Configure CAPTCHA detection behavior.
+
+Parameters:
+- autoDetectCaptcha: auto-detect CAPTCHA after page_navigate (default: true)
+- autoSwitchHeadless: auto-switch to headed mode when CAPTCHA detected (default: true)
+- captchaTimeout: timeout for waiting user to solve CAPTCHA in ms (default: 300000)`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                autoDetectCaptcha: {
+                    type: 'boolean',
+                    description: 'Whether to automatically detect CAPTCHA after navigation',
+                },
+                autoSwitchHeadless: {
+                    type: 'boolean',
+                    description: 'Whether to automatically switch to headed mode when CAPTCHA detected',
+                },
+                captchaTimeout: {
+                    type: 'number',
+                    description: 'Timeout for waiting user to complete CAPTCHA (milliseconds)',
+                },
+            },
+        },
+    },
+    {
+        name: 'stealth_inject',
+        description: `Inject modern stealth scripts to bypass bot detection.
+
+Anti-detection patches:
+1. Hide navigator.webdriver flag
+2. Inject window.chrome object
+3. Restore navigator.plugins
+4. Fix Permissions API behavior
+5. Patch Canvas fingerprinting
+6. Patch WebGL fingerprinting
+7. Restore hardware concurrency
+8. Fix Battery API responses
+9. Fix MediaDevices enumeration
+10. Fix Notification API
+
+Compatible with undetected-chromedriver, puppeteer-extra-plugin-stealth, playwright-stealth.
+Call after browser_launch for best results.`,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'stealth_set_user_agent',
+        description: `Set a realistic User-Agent and browser fingerprint for the target platform.
+
+Updates navigator.userAgent, navigator.platform, navigator.vendor,
+navigator.hardwareConcurrency, and navigator.deviceMemory consistently
+to avoid fingerprint inconsistencies.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                platform: {
+                    type: 'string',
+                    description: 'Target platform',
+                    enum: ['windows', 'mac', 'linux'],
+                    default: 'windows',
+                },
+            },
+        },
+    },
+    {
+        name: 'browser_list_tabs',
+        description: `List all open tabs/pages in the connected browser.
+
+Use this after browser_attach to see all available pages/tabs.
+Returns index, URL, and title for each tab.
+
+Workflow:
+1. browser_attach(browserURL="http://127.0.0.1:9222")
+2. browser_list_tabs() -> see all tabs with their indexes
+3. browser_select_tab(index=N) -> switch to desired tab
+
+Can also connect and list in one call:
+browser_list_tabs(browserURL="http://127.0.0.1:9222")`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                browserURL: {
+                    type: 'string',
+                    description: 'Optional: connect to this browser URL before listing (e.g. http://127.0.0.1:9222)',
+                },
+            },
+        },
+    },
+    {
+        name: 'browser_select_tab',
+        description: `Switch the active tab/page by index or URL/title pattern.
+
+After browser_list_tabs, use this to activate a specific tab.
+All subsequent page_* tools will operate on the selected tab.
+
+Examples:
+- browser_select_tab(index=0) -> first tab
+- browser_select_tab(urlPattern="qwen") -> tab whose URL contains "qwen"
+- browser_select_tab(titlePattern="Mini Program") -> tab whose title contains "Mini Program"`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                index: {
+                    type: 'number',
+                    description: 'Tab index from browser_list_tabs (0-based)',
+                },
+                urlPattern: {
+                    type: 'string',
+                    description: 'Substring to match against tab URLs',
+                },
+                titlePattern: {
+                    type: 'string',
+                    description: 'Substring to match against tab titles',
+                },
+            },
+        },
+    },
+    {
+        name: 'framework_state_extract',
+        description: 'Extract React/Vue component state from the live page. Useful for debugging frontend applications and finding hidden state.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                framework: {
+                    type: 'string',
+                    description: 'Framework to target. auto = detect automatically.',
+                    enum: ['auto', 'react', 'vue2', 'vue3'],
+                    default: 'auto',
+                },
+                selector: {
+                    type: 'string',
+                    description: 'CSS selector of root element to inspect (default: #root, #app, [data-reactroot], body)',
+                },
+                maxDepth: {
+                    type: 'number',
+                    description: 'Maximum component tree depth to traverse',
+                    default: 5,
+                },
+            },
+        },
+    },
+    {
+        name: 'indexeddb_dump',
+        description: 'Dump all IndexedDB databases and their contents. Useful for analyzing PWA data, stored tokens, or offline application state.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                database: {
+                    type: 'string',
+                    description: 'Specific database name to dump (default: all databases)',
+                },
+                store: {
+                    type: 'string',
+                    description: 'Specific object store to dump (default: all stores)',
+                },
+                maxRecords: {
+                    type: 'number',
+                    description: 'Maximum records per store to return',
+                    default: 100,
+                },
+            },
+        },
+    },
+];
+//# sourceMappingURL=definitions.tools.security.js.map

package/dist/server/domains/browser/definitions.tools.security.js.map

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

package/dist/server/domains/browser/handlers/browser-control.d.ts

@@ -0,0 +1,59 @@
+import type { CodeCollector } from '../../../domains/shared/modules.js';
+import type { PageController } from '../../../domains/shared/modules.js';
+import type { ConsoleMonitor } from '../../../domains/shared/modules.js';
+import type { CamoufoxBrowserManager } from '../../../domains/shared/modules.js';
+import type { TabRegistry } from '../../../../modules/browser/TabRegistry.js';
+interface BrowserControlHandlersDeps {
+    collector: CodeCollector;
+    pageController: PageController;
+    consoleMonitor: ConsoleMonitor;
+    getActiveDriver: () => 'chrome' | 'camoufox';
+    getCamoufoxManager: () => CamoufoxBrowserManager | null;
+    getCamoufoxPage: () => Promise<unknown>;
+    getTabRegistry: () => TabRegistry;
+}
+export declare class BrowserControlHandlers {
+    private deps;
+    constructor(deps: BrowserControlHandlersDeps);
+    private parseHeadlessArg;
+    private shouldAttemptLinuxHeadfulFallback;
+    private persistHeadlessEnv;
+    handleBrowserLaunch(args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handleBrowserClose(_args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handleBrowserStatus(_args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handleBrowserListTabs(args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handleBrowserSelectTab(args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handleBrowserAttach(args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+}
+export {};
+//# sourceMappingURL=browser-control.d.ts.map

package/dist/server/domains/browser/handlers/browser-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-control.d.ts","sourceRoot":"","sources":["../../../../../src/server/domains/browser/handlers/browser-control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAQhE,UAAU,0BAA0B;IAClC,SAAS,EAAE,aAAa,CAAC;IACzB,cAAc,EAAE,cAAc,CAAC;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,eAAe,EAAE,MAAM,QAAQ,GAAG,UAAU,CAAC;IAC7C,kBAAkB,EAAE,MAAM,sBAAsB,GAAG,IAAI,CAAC;IACxD,eAAe,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,cAAc,EAAE,MAAM,WAAW,CAAC;CACnC;AAED,qBAAa,sBAAsB;IACrB,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,0BAA0B;IAEpD,OAAO,CAAC,gBAAgB;IAwBxB,OAAO,CAAC,iCAAiC;YAmB3B,kBAAkB;IAuB1B,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IA+KjD,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IAoBjD,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IAalD,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IAgEnD,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IA2GpD,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;CA8GxD"}