@jshookmcp/jshook 0.2.5 → 0.2.7

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

@@ -1,110 +0,0 @@
-import { tool } from '../../registry/tool-builder.js';
-export const browserPageSystemTools = [
-    tool('console_enable')
-        .desc('Enable console monitoring to capture console.log, console.error, etc.')
-        .idempotent()
-        .build(),
-    tool('console_get_logs')
-        .desc('Get captured console logs')
-        .enum('type', ['log', 'warn', 'error', 'info', 'debug'], 'Filter by log type')
-        .number('limit', 'Maximum number of logs to return')
-        .number('since', 'Only return logs after this timestamp')
-        .readOnly()
-        .idempotent()
-        .build(),
-    tool('console_execute')
-        .desc('Execute JavaScript expression in console context')
-        .string('expression', 'JavaScript expression to execute')
-        .required('expression')
-        .openWorld()
-        .build(),
-    tool('dom_get_computed_style')
-        .desc('Get computed CSS styles of an element')
-        .string('selector', 'CSS selector')
-        .required('selector')
-        .readOnly()
-        .idempotent()
-        .build(),
-    tool('dom_find_by_text')
-        .desc('Find elements by text content (useful for dynamic content)')
-        .string('text', 'Text to search for')
-        .string('tag', 'Optional tag name to filter (e.g., "button", "a")')
-        .required('text')
-        .readOnly()
-        .idempotent()
-        .build(),
-    tool('dom_get_xpath')
-        .desc('Get XPath of an element')
-        .string('selector', 'CSS selector')
-        .required('selector')
-        .readOnly()
-        .idempotent()
-        .build(),
-    tool('dom_is_in_viewport')
-        .desc('Check if element is visible in viewport')
-        .string('selector', 'CSS selector')
-        .required('selector')
-        .readOnly()
-        .idempotent()
-        .build(),
-    tool('page_get_performance')
-        .desc('Get page performance metrics (load time, network time, etc.)')
-        .readOnly()
-        .idempotent()
-        .build(),
-    tool('page_inject_script')
-        .desc('Inject JavaScript code into page')
-        .string('script', 'JavaScript code to inject')
-        .required('script')
-        .openWorld()
-        .build(),
-    tool('page_set_cookies')
-        .desc('Set cookies for the page')
-        .array('cookies', {
-        type: 'object',
-        properties: {
-            name: { type: 'string' },
-            value: { type: 'string' },
-            domain: { type: 'string' },
-            path: { type: 'string' },
-            expires: { type: 'number' },
-            httpOnly: { type: 'boolean' },
-            secure: { type: 'boolean' },
-            sameSite: { type: 'string', enum: ['Strict', 'Lax', 'None'] },
-        },
-        required: ['name', 'value'],
-    }, 'Array of cookie objects')
-        .required('cookies')
-        .idempotent()
-        .build(),
-    tool('page_get_cookies').desc('Get all cookies for the page').readOnly().idempotent().build(),
-    tool('page_clear_cookies').desc('Clear all cookies').destructive().idempotent().build(),
-    tool('page_set_viewport')
-        .desc('Set viewport size')
-        .number('width', 'Viewport width')
-        .number('height', 'Viewport height')
-        .required('width', 'height')
-        .idempotent()
-        .build(),
-    tool('page_emulate_device')
-        .desc('Emulate mobile device (iPhone, iPad, Android)')
-        .string('device', 'Device to emulate. Supports canonical values (iPhone, iPad, Android) and aliases like "iPhone 13" / "iPhone 14".')
-        .required('device')
-        .idempotent()
-        .build(),
-    tool('page_get_local_storage').desc('Get all localStorage items').readOnly().idempotent().build(),
-    tool('page_set_local_storage')
-        .desc('Set localStorage item')
-        .string('key', 'Storage key')
-        .string('value', 'Storage value')
-        .required('key', 'value')
-        .idempotent()
-        .build(),
-    tool('page_press_key')
-        .desc('Press a keyboard key (e.g., "Enter", "Escape", "ArrowDown")')
-        .string('key', 'Key to press')
-        .required('key')
-        .openWorld()
-        .build(),
-    tool('page_get_all_links').desc('Get all links on the page').readOnly().idempotent().build(),
-];

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

@@ -1,2 +0,0 @@
-import type { Tool } from '@modelcontextprotocol/sdk/types.js';
-export declare const browserRuntimeTools: Tool[];

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

@@ -1,100 +0,0 @@
-import { tool } from '../../registry/tool-builder.js';
-export const browserRuntimeTools = [
-    tool('get_detailed_data')
-        .desc(` 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`)
-        .string('detailId', 'Detail ID token from previous tool response')
-        .string('path', 'Optional: Path to specific data (e.g., "frontierSign" or "methods.0")')
-        .required('detailId')
-        .readOnly()
-        .idempotent()
-        .build(),
-    tool('browser_launch')
-        .desc(`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`)
-        .enum('driver', ['chrome', 'camoufox'], 'Browser driver. chrome = rebrowser-puppeteer-core (full CDP support). camoufox = Firefox anti-detect (requires: npx camoufox-js fetch).', { default: 'chrome' })
-        .boolean('headless', 'Run headless (default follows PUPPETEER_HEADLESS env; set false to show browser window for manual login)', { default: false })
-        .enum('os', ['windows', 'macos', 'linux'], 'OS fingerprint to spoof (camoufox only)', {
-        default: 'windows',
-    })
-        .enum('mode', ['launch', 'connect'], 'Launch mode. launch = start local browser. connect = reuse existing browser (chrome: browserURL/wsEndpoint/autoConnect, camoufox: wsEndpoint).', { default: 'launch' })
-        .string('browserURL', 'HTTP URL of existing browser debug endpoint (chrome connect mode). Example: http://127.0.0.1:9222')
-        .string('wsEndpoint', 'WebSocket endpoint to connect to (chrome or camoufox connect mode). For camoufox, get this from camoufox_server_launch.')
-        .boolean('autoConnect', 'Chrome 144+ only. Auto-detect the local Chrome debugging WebSocket from DevToolsActivePort. Requires remote debugging to be enabled at chrome://inspect/#remote-debugging, and Chrome may prompt you to manually approve this client.', { default: false })
-        .enum('channel', ['stable', 'beta', 'dev', 'canary'], 'Chrome channel used for autoConnect when userDataDir is not provided.', { default: 'stable' })
-        .string('userDataDir', 'Optional Chrome profile directory for autoConnect. If omitted, the default profile path for the selected channel is used.')
-        .openWorld()
-        .build(),
-    tool('camoufox_server_launch')
-        .desc(`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`)
-        .number('port', 'Port to listen on (default: auto-assigned)')
-        .string('ws_path', 'WebSocket path (default: auto-generated)')
-        .enum('os', ['windows', 'macos', 'linux'], 'OS fingerprint to spoof', { default: 'windows' })
-        .boolean('headless', 'Run headless (default: true)', { default: true })
-        .openWorld()
-        .build(),
-    tool('camoufox_server_close')
-        .desc('Close the Camoufox WebSocket server. Connected clients are disconnected.')
-        .destructive()
-        .build(),
-    tool('camoufox_server_status')
-        .desc('Get the current status of the Camoufox WebSocket server (running, wsEndpoint).')
-        .readOnly()
-        .idempotent()
-        .build(),
-    tool('browser_attach')
-        .desc(`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.`)
-        .string('browserURL', 'HTTP URL of the remote debugging endpoint (e.g., http://127.0.0.1:9222)')
-        .string('wsEndpoint', 'WebSocket URL from /json/version (e.g., ws://127.0.0.1:9222/devtools/browser/xxx)')
-        .boolean('autoConnect', 'Chrome 144+ only. Auto-detect the local Chrome debugging WebSocket from DevToolsActivePort. Requires remote debugging to be enabled at chrome://inspect/#remote-debugging, and Chrome may prompt you to manually approve this client.', { default: false })
-        .enum('channel', ['stable', 'beta', 'dev', 'canary'], 'Chrome channel used for autoConnect when userDataDir is not provided.', { default: 'stable' })
-        .string('userDataDir', 'Optional Chrome profile directory for autoConnect. If omitted, the default profile path for the selected channel is used.')
-        .number('pageIndex', 'Index of the page/tab to activate (default: 0)', { default: 0 })
-        .openWorld()
-        .build(),
-    tool('browser_close').desc('Close browser instance').destructive().build(),
-    tool('browser_status')
-        .desc('Get browser status (running, pages count, version)')
-        .readOnly()
-        .idempotent()
-        .build(),
-];

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

@@ -1,2 +0,0 @@
-import type { Tool } from '@modelcontextprotocol/sdk/types.js';
-export declare const browserSecurityStateTools: Tool[];

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

@@ -1,196 +0,0 @@
-import { tool } from '../../registry/tool-builder.js';
-export const browserSecurityStateTools = [
-    tool('captcha_detect')
-        .desc(`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.`)
-        .readOnly()
-        .idempotent()
-        .build(),
-    tool('captcha_wait')
-        .desc(`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)`)
-        .number('timeout', 'Timeout in milliseconds (default: 300000 = 5 minutes)', { default: 300000 })
-        .readOnly()
-        .idempotent()
-        .openWorld()
-        .build(),
-    tool('captcha_config')
-        .desc(`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)`)
-        .boolean('autoDetectCaptcha', 'Whether to automatically detect CAPTCHA after navigation')
-        .boolean('autoSwitchHeadless', 'Whether to automatically switch to headed mode when CAPTCHA detected')
-        .number('captchaTimeout', 'Timeout for waiting user to complete CAPTCHA (milliseconds)')
-        .idempotent()
-        .build(),
-    tool('stealth_inject')
-        .desc(`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.`)
-        .idempotent()
-        .build(),
-    tool('stealth_set_user_agent')
-        .desc(`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.`)
-        .enum('platform', ['windows', 'mac', 'linux'], 'Target platform', { default: 'windows' })
-        .idempotent()
-        .build(),
-    tool('stealth_configure_jitter')
-        .desc(`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)`)
-        .boolean('enabled', 'Enable/disable jitter', { default: true })
-        .number('minDelayMs', 'Minimum delay (ms)', { default: 20 })
-        .number('maxDelayMs', 'Maximum delay (ms)', { default: 80 })
-        .boolean('burstMode', 'Skip jitter for time-critical ops', { default: false })
-        .idempotent()
-        .build(),
-    tool('stealth_generate_fingerprint')
-        .desc(`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.`)
-        .enum('os', ['windows', 'macos', 'linux'], 'Target OS for fingerprint')
-        .enum('browser', ['chrome', 'firefox'], 'Target browser', { default: 'chrome' })
-        .string('locale', 'Locale string (e.g. en-US)', { default: 'en-US' })
-        .build(),
-    tool('stealth_verify')
-        .desc(`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.`)
-        .readOnly()
-        .idempotent()
-        .build(),
-    tool('browser_list_tabs')
-        .desc(`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")`)
-        .string('browserURL', 'Optional: connect to this browser URL before listing (e.g. http://127.0.0.1:9222)')
-        .string('wsEndpoint', 'Optional: connect to this browser WebSocket endpoint before listing.')
-        .boolean('autoConnect', 'Chrome 144+ only. Auto-detect the local Chrome debugging WebSocket from DevToolsActivePort. Requires remote debugging to be enabled at chrome://inspect/#remote-debugging, and Chrome may prompt you to manually approve this client.', { default: false })
-        .enum('channel', ['stable', 'beta', 'dev', 'canary'], 'Chrome channel used for autoConnect when userDataDir is not provided.', { default: 'stable' })
-        .string('userDataDir', 'Optional Chrome profile directory for autoConnect. If omitted, the default profile path for the selected channel is used.')
-        .readOnly()
-        .idempotent()
-        .openWorld()
-        .build(),
-    tool('browser_select_tab')
-        .desc(`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"`)
-        .number('index', 'Tab index from browser_list_tabs (0-based)')
-        .string('urlPattern', 'Substring to match against tab URLs')
-        .string('titlePattern', 'Substring to match against tab titles')
-        .idempotent()
-        .build(),
-    tool('framework_state_extract')
-        .desc('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.')
-        .enum('framework', ['auto', 'react', 'vue2', 'vue3', 'svelte', 'solid', 'preact'], 'Framework to target. auto = detect automatically.', { default: 'auto' })
-        .string('selector', 'CSS selector of root element to inspect (default: #root, #app, [data-reactroot], body)')
-        .number('maxDepth', 'Maximum component tree depth to traverse', { default: 5 })
-        .readOnly()
-        .idempotent()
-        .build(),
-    tool('indexeddb_dump')
-        .desc('Dump all IndexedDB databases and their contents. Useful for analyzing PWA data, stored tokens, or offline application state.')
-        .string('database', 'Specific database name to dump (default: all databases)')
-        .string('store', 'Specific object store to dump (default: all stores)')
-        .number('maxRecords', 'Maximum records per store to return', { default: 100 })
-        .readOnly()
-        .idempotent()
-        .build(),
-];

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

@@ -1,65 +0,0 @@
-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 resetAndEnableMonitoring;
-    private syncTabRegistryWithCollectorPages;
-    private parseHeadlessArg;
-    private parseChromeConnectRequest;
-    private hasChromeConnectRequest;
-    private describeChromeConnectRequest;
-    private isAutoConnectRequest;
-    private getAutoConnectApprovalHint;
-    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 {};