@jshookmcp/jshook 0.2.2 → 0.2.3

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

@@ -1,14 +1,14 @@
 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
+        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',
@@ -27,18 +27,18 @@ Examples:
     },
     {
         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), wsEndpoint, or Chrome 144+ autoConnect
+        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), wsEndpoint, or Chrome 144+ autoConnect
   - camoufox: connect via wsEndpoint from camoufox_server_launch`,
         inputSchema: {
             type: 'object',
@@ -94,16 +94,16 @@ Modes:
     },
     {
         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
-
+        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',
@@ -148,17 +148,17 @@ Requires binaries: npx camoufox-js fetch`,
     },
     {
         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 browserURL (http://host:port), WebSocket endpoint (ws://...), and Chrome 144+ autoConnect.
-
-Example:
-- browser_attach(browserURL="http://127.0.0.1:9222")
-- browser_attach(wsEndpoint="ws://127.0.0.1:9222/devtools/browser/xxx")
-- browser_attach(autoConnect=true, channel="stable")
-- browser_attach(browserURL="http://127.0.0.1:9222", pageIndex=0)
-
+        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 browserURL (http://host:port), WebSocket endpoint (ws://...), and Chrome 144+ autoConnect.
+
+Example:
+- browser_attach(browserURL="http://127.0.0.1:9222")
+- browser_attach(wsEndpoint="ws://127.0.0.1:9222/devtools/browser/xxx")
+- browser_attach(autoConnect=true, channel="stable")
+- browser_attach(browserURL="http://127.0.0.1:9222", pageIndex=0)
+
 After attaching, use page_navigate / page_screenshot / debugger_enable normally.`,
         inputSchema: {
             type: 'object',

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

@@ -1,32 +1,32 @@
 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
-- Widget CAPTCHA: embedded checkbox or iframe-based challenges
-- Browser Check: interstitial or automatic integrity checks
-- Custom CAPTCHA implementations
-
-Response fields:
-- detected: whether CAPTCHA was found
-- type: CAPTCHA type identifier
-- providerHint: broad provider category if identified
-- confidence: detection confidence (0-100)
-- reasoning: AI analysis explanation
-- screenshotPath: saved screenshot path when a vision-capable model is unavailable
-- suggestions: recommended next steps
-
-Note:
-When the configured MCP model cannot access vision directly, the detector saves a screenshot
-to disk and returns screenshotPath together with prompt guidance in the reasoning field.
+        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
+- Widget CAPTCHA: embedded checkbox or iframe-based challenges
+- Browser Check: interstitial or automatic integrity checks
+- Custom CAPTCHA implementations
+
+Response fields:
+- detected: whether CAPTCHA was found
+- type: CAPTCHA type identifier
+- providerHint: broad provider category if identified
+- confidence: detection confidence (0-100)
+- reasoning: AI analysis explanation
+- screenshotPath: saved screenshot path when a vision-capable model is unavailable
+- suggestions: recommended next steps
+
+Note:
+When the configured MCP model cannot access vision directly, the detector saves a screenshot
+to disk and returns screenshotPath together with prompt guidance in the reasoning field.
 Use an external AI (GPT-4o, Claude 3) to analyze the saved screenshot if needed.`,
         inputSchema: {
             type: 'object',
@@ -35,16 +35,16 @@ Use an external AI (GPT-4o, Claude 3) to analyze the saved screenshot if needed.
     },
     {
         name: 'captcha_wait',
-        description: `Wait for the user to manually solve a CAPTCHA.
-
-Steps:
-1. CAPTCHA is detected on the page
-2. This tool polls the current page until the CAPTCHA is no longer detected
-3. User solves the CAPTCHA manually in the active browser/page
-4. Script resumes automatically after detection
-
-Note: this tool does not switch browser modes on its own.
-
+        description: `Wait for the user to manually solve a CAPTCHA.
+
+Steps:
+1. CAPTCHA is detected on the page
+2. This tool polls the current page until the CAPTCHA is no longer detected
+3. User solves the CAPTCHA manually in the active browser/page
+4. Script resumes automatically after detection
+
+Note: this tool does not switch browser modes on its own.
+
 Timeout: default 300000ms (5 minutes)`,
         inputSchema: {
             type: 'object',
@@ -59,11 +59,11 @@ Timeout: default 300000ms (5 minutes)`,
     },
     {
         name: 'captcha_config',
-        description: `Configure CAPTCHA detection behavior.
-
-Parameters:
-- autoDetectCaptcha: enable CAPTCHA auto-handling for browser-mode integrations that use these settings
-- autoSwitchHeadless: allow supported integrations to switch to headed mode when CAPTCHA is detected
+        description: `Configure CAPTCHA detection behavior.
+
+Parameters:
+- autoDetectCaptcha: enable CAPTCHA auto-handling for browser-mode integrations that use these settings
+- autoSwitchHeadless: allow supported integrations to switch to headed mode when CAPTCHA is detected
 - captchaTimeout: timeout for waiting user to solve CAPTCHA in ms (default: 300000)`,
         inputSchema: {
             type: 'object',
@@ -85,21 +85,21 @@ Parameters:
     },
     {
         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.
+        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',
@@ -108,12 +108,12 @@ Call after browser_launch for best results.`,
     },
     {
         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.
-
+        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.
+
 UA strings are updated to Chrome 131 with platform-appropriate hardware profiles.`,
         inputSchema: {
             type: 'object',
@@ -129,15 +129,15 @@ UA strings are updated to Chrome 131 with platform-appropriate hardware profiles
     },
     {
         name: 'stealth_configure_jitter',
-        description: `Configure CDP command timing jitter to mimic natural network latency.
-
-Jitter adds random delays to CDP commands to prevent timing-based bot detection.
-Default: 20-80ms uniform random delay on all CDP send() calls.
-
-Parameters:
-- enabled: turn jitter on/off
-- minDelayMs: minimum delay in milliseconds
-- maxDelayMs: maximum delay in milliseconds
+        description: `Configure CDP command timing jitter to mimic natural network latency.
+
+Jitter adds random delays to CDP commands to prevent timing-based bot detection.
+Default: 20-80ms uniform random delay on all CDP send() calls.
+
+Parameters:
+- enabled: turn jitter on/off
+- minDelayMs: minimum delay in milliseconds
+- maxDelayMs: maximum delay in milliseconds
 - burstMode: skip jitter for time-critical operations (debugging, breakpoints)`,
         inputSchema: {
             type: 'object',
@@ -167,12 +167,12 @@ Parameters:
     },
     {
         name: 'stealth_generate_fingerprint',
-        description: `Generate a realistic browser fingerprint using real-world datasets.
-
-Requires fingerprint-generator and fingerprint-injector packages (optional dependencies).
-The generated fingerprint is cached per session and auto-applied on next stealth_inject.
-
-Covers: screen resolution, WebGL params, fonts, codecs, AudioContext, navigator properties.
+        description: `Generate a realistic browser fingerprint using real-world datasets.
+
+Requires fingerprint-generator and fingerprint-injector packages (optional dependencies).
+The generated fingerprint is cached per session and auto-applied on next stealth_inject.
+
+Covers: screen resolution, WebGL params, fonts, codecs, AudioContext, navigator properties.
 Falls back to built-in StealthScripts patches if packages are not installed.`,
         inputSchema: {
             type: 'object',
@@ -198,21 +198,21 @@ Falls back to built-in StealthScripts patches if packages are not installed.`,
     },
     {
         name: 'stealth_verify',
-        description: `Run offline anti-detection checks on the current page.
-
-Verifies that stealth patches are working correctly by checking:
-- navigator.webdriver absence
-- window.chrome object structure
-- navigator.plugins list
-- UA/platform consistency
-- WebGL vendor/renderer
-- Canvas noise injection
-- cdc_ variable cleanup
-- Hardware profile consistency
-
-Returns a structured report with pass/fail for each check, an overall score (0-100),
-and recommendations for improving detection evasion.
-
+        description: `Run offline anti-detection checks on the current page.
+
+Verifies that stealth patches are working correctly by checking:
+- navigator.webdriver absence
+- window.chrome object structure
+- navigator.plugins list
+- UA/platform consistency
+- WebGL vendor/renderer
+- Canvas noise injection
+- cdc_ variable cleanup
+- Hardware profile consistency
+
+Returns a structured report with pass/fail for each check, an overall score (0-100),
+and recommendations for improving detection evasion.
+
 Best used after stealth_inject to verify patches are effective.`,
         inputSchema: {
             type: 'object',
@@ -221,18 +221,18 @@ Best used after stealth_inject to verify patches are effective.`,
     },
     {
         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") or browser_attach(autoConnect=true)
-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")
+        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") or browser_attach(autoConnect=true)
+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")
 browser_list_tabs(autoConnect=true, channel="stable")`,
         inputSchema: {
             type: 'object',
@@ -265,14 +265,14 @@ browser_list_tabs(autoConnect=true, channel="stable")`,
     },
     {
         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"
+        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',
@@ -294,14 +294,14 @@ Examples:
     },
     {
         name: 'framework_state_extract',
-        description: 'Extract React/Vue component state from the live page. Useful for debugging frontend applications and finding hidden state.',
+        description: 'Extract component state from the live page. Supports React, Vue 2/3, Svelte 3/4/5, Solid.js, and Preact. Also detects Next.js/Nuxt meta-framework metadata (routes, build info, payload). Useful for debugging frontend applications, reverse-engineering SPA state, and finding hidden data.',
         inputSchema: {
             type: 'object',
             properties: {
                 framework: {
                     type: 'string',
                     description: 'Framework to target. auto = detect automatically.',
-                    enum: ['auto', 'react', 'vue2', 'vue3'],
+                    enum: ['auto', 'react', 'vue2', 'vue3', 'svelte', 'solid', 'preact'],
                     default: 'auto',
                 },
                 selector: {

package/dist/src/server/domains/browser/handlers/facade-initializer.d.ts

@@ -3,9 +3,9 @@ import type { PageController } from '../../../domains/shared/modules.js';
 import type { DOMInspector } from '../../../domains/shared/modules.js';
 import type { ScriptManager } from '../../../domains/shared/modules.js';
 import type { ConsoleMonitor } from '../../../domains/shared/modules.js';
-import { AICaptchaDetector } from '../../../domains/shared/modules.js';
-import { DetailedDataManager } from '../../../../utils/DetailedDataManager.js';
-import { CamoufoxBrowserManager } from '../../../domains/shared/modules.js';
+import { type AICaptchaDetector } from '../../../domains/shared/modules.js';
+import { type DetailedDataManager } from '../../../../utils/DetailedDataManager.js';
+import { type CamoufoxBrowserManager } from '../../../domains/shared/modules.js';
 import { BrowserControlHandlers } from '../../../domains/browser/handlers/browser-control.js';
 import { CamoufoxBrowserHandlers } from '../../../domains/browser/handlers/camoufox-browser.js';
 import { PageNavigationHandlers } from '../../../domains/browser/handlers/page-navigation.js';

package/dist/src/server/domains/browser/handlers/facade-initializer.js

@@ -1,6 +1,6 @@
-import { AICaptchaDetector } from '../../../domains/shared/modules.js';
-import { DetailedDataManager } from '../../../../utils/DetailedDataManager.js';
-import { CamoufoxBrowserManager } from '../../../domains/shared/modules.js';
+import {} from '../../../domains/shared/modules.js';
+import {} from '../../../../utils/DetailedDataManager.js';
+import {} from '../../../domains/shared/modules.js';
 import { BrowserControlHandlers } from '../../../domains/browser/handlers/browser-control.js';
 import { CamoufoxBrowserHandlers } from '../../../domains/browser/handlers/camoufox-browser.js';
 import { PageNavigationHandlers } from '../../../domains/browser/handlers/page-navigation.js';