@jshookmcp/jshook 0.2.0 → 0.2.2

package/dist/src/server/domains/antidebug/manifest.d.ts

@@ -1,7 +1,57 @@
-import type { DomainManifest } from '../../domains/shared/registry.js';
+import type { MCPServerContext } from '../../domains/shared/registry.js';
 import { AntiDebugToolHandlers } from '../../domains/antidebug/index.js';
-declare const DOMAIN: "antidebug";
-declare const DEP_KEY: "antidebugHandlers";
 type H = AntiDebugToolHandlers;
-declare const manifest: DomainManifest<typeof DEP_KEY, H, typeof DOMAIN>;
+declare function ensure(ctx: MCPServerContext): H;
+declare const manifest: {
+    kind: "domain-manifest";
+    version: 1;
+    domain: "antidebug";
+    depKey: "antidebugHandlers";
+    profiles: "full"[];
+    ensure: typeof ensure;
+    registrations: {
+        tool: {
+            inputSchema: {
+                [x: string]: unknown;
+                type: "object";
+                properties?: {
+                    [x: string]: object;
+                } | undefined;
+                required?: string[] | undefined;
+            };
+            name: string;
+            description?: string | undefined;
+            outputSchema?: {
+                [x: string]: unknown;
+                type: "object";
+                properties?: {
+                    [x: string]: object;
+                } | undefined;
+                required?: string[] | undefined;
+            } | undefined;
+            annotations?: {
+                title?: string | undefined;
+                readOnlyHint?: boolean | undefined;
+                destructiveHint?: boolean | undefined;
+                idempotentHint?: boolean | undefined;
+                openWorldHint?: boolean | undefined;
+            } | undefined;
+            execution?: {
+                taskSupport?: "optional" | "required" | "forbidden" | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            icons?: {
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+                theme?: "light" | "dark" | undefined;
+            }[] | undefined;
+            title?: string | undefined;
+        };
+        domain: "antidebug";
+        bind: (deps: import("../../domains/shared/registry.js").ToolHandlerDeps) => (args: import("../../types.js").ToolArgs) => Promise<unknown>;
+    }[];
+};
 export default manifest;

package/dist/src/server/domains/antidebug/manifest.js

@@ -16,17 +16,43 @@ function ensure(ctx) {
     return ctx.antidebugHandlers;
 }
 const manifest = {
-    kind: 'domain-manifest', version: 1,
-    domain: DOMAIN, depKey: DEP_KEY,
+    kind: 'domain-manifest',
+    version: 1,
+    domain: DOMAIN,
+    depKey: DEP_KEY,
     profiles: ['full'],
     ensure,
     registrations: [
-        { tool: t('antidebug_bypass_all'), domain: DOMAIN, bind: b((h, a) => h.handleAntiDebugBypassAll(a)) },
-        { tool: t('antidebug_bypass_debugger_statement'), domain: DOMAIN, bind: b((h, a) => h.handleAntiDebugBypassDebuggerStatement(a)) },
-        { tool: t('antidebug_bypass_timing'), domain: DOMAIN, bind: b((h, a) => h.handleAntiDebugBypassTiming(a)) },
-        { tool: t('antidebug_bypass_stack_trace'), domain: DOMAIN, bind: b((h, a) => h.handleAntiDebugBypassStackTrace(a)) },
-        { tool: t('antidebug_bypass_console_detect'), domain: DOMAIN, bind: b((h, a) => h.handleAntiDebugBypassConsoleDetect(a)) },
-        { tool: t('antidebug_detect_protections'), domain: DOMAIN, bind: b((h, a) => h.handleAntiDebugDetectProtections(a)) },
+        {
+            tool: t('antidebug_bypass_all'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleAntiDebugBypassAll(a)),
+        },
+        {
+            tool: t('antidebug_bypass_debugger_statement'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleAntiDebugBypassDebuggerStatement(a)),
+        },
+        {
+            tool: t('antidebug_bypass_timing'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleAntiDebugBypassTiming(a)),
+        },
+        {
+            tool: t('antidebug_bypass_stack_trace'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleAntiDebugBypassStackTrace(a)),
+        },
+        {
+            tool: t('antidebug_bypass_console_detect'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleAntiDebugBypassConsoleDetect(a)),
+        },
+        {
+            tool: t('antidebug_detect_protections'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleAntiDebugDetectProtections(a)),
+        },
     ],
 };
 export default manifest;

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

@@ -1 +1 @@
-export { browserTools, advancedBrowserToolDefinitions } from '../../domains/browser/definitions.tools.js';
+export { browserTools, advancedBrowserToolDefinitions, } from '../../domains/browser/definitions.tools.js';

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

@@ -1 +1 @@
-export { browserTools, advancedBrowserToolDefinitions } from '../../domains/browser/definitions.tools.js';
+export { browserTools, advancedBrowserToolDefinitions, } from '../../domains/browser/definitions.tools.js';

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

@@ -31,7 +31,16 @@ export const advancedBrowserToolDefinitions = [
             properties: {
                 action: {
                     type: 'string',
-                    enum: ['list', 'alias_bind', 'alias_open', 'navigate', 'wait_for', 'context_set', 'context_get', 'transfer'],
+                    enum: [
+                        'list',
+                        'alias_bind',
+                        'alias_open',
+                        'navigate',
+                        'wait_for',
+                        'context_set',
+                        'context_get',
+                        'transfer',
+                    ],
                     description: 'Tab workflow action to perform',
                 },
                 alias: {

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

@@ -12,16 +12,46 @@ export const behaviorTools = [
         inputSchema: {
             type: 'object',
             properties: {
-                fromX: { type: 'number', description: 'Start X coordinate (default: current mouse position or 0)' },
-                fromY: { type: 'number', description: 'Start Y coordinate (default: current mouse position or 0)' },
+                fromX: {
+                    type: 'number',
+                    description: 'Start X coordinate (default: current mouse position or 0)',
+                },
+                fromY: {
+                    type: 'number',
+                    description: 'Start Y coordinate (default: current mouse position or 0)',
+                },
                 toX: { type: 'number', description: 'Target X coordinate' },
                 toY: { type: 'number', description: 'Target Y coordinate' },
-                selector: { type: 'string', description: 'CSS selector to move to (alternative to toX/toY — auto-resolves element center)' },
-                durationMs: { type: 'number', description: 'Movement duration in ms (default: 600)', default: 600 },
-                steps: { type: 'integer', description: 'Number of intermediate points (default: 24)', default: 24 },
-                jitterPx: { type: 'number', description: 'Max random offset per step in pixels (default: 1.5)', default: 1.5 },
-                curve: { type: 'string', enum: ['ease', 'linear', 'ease-in', 'ease-out'], description: 'Speed curve (default: ease)', default: 'ease' },
-                click: { type: 'boolean', description: 'Click at destination after movement (default: false)', default: false },
+                selector: {
+                    type: 'string',
+                    description: 'CSS selector to move to (alternative to toX/toY — auto-resolves element center)',
+                },
+                durationMs: {
+                    type: 'number',
+                    description: 'Movement duration in ms (default: 600)',
+                    default: 600,
+                },
+                steps: {
+                    type: 'integer',
+                    description: 'Number of intermediate points (default: 24)',
+                    default: 24,
+                },
+                jitterPx: {
+                    type: 'number',
+                    description: 'Max random offset per step in pixels (default: 1.5)',
+                    default: 1.5,
+                },
+                curve: {
+                    type: 'string',
+                    enum: ['ease', 'linear', 'ease-in', 'ease-out'],
+                    description: 'Speed curve (default: ease)',
+                    default: 'ease',
+                },
+                click: {
+                    type: 'boolean',
+                    description: 'Click at destination after movement (default: false)',
+                    default: false,
+                },
             },
         },
     },
@@ -37,13 +67,41 @@ export const behaviorTools = [
         inputSchema: {
             type: 'object',
             properties: {
-                distance: { type: 'number', description: 'Total scroll distance in pixels (default: 500)', default: 500 },
-                direction: { type: 'string', enum: ['up', 'down', 'left', 'right'], description: 'Scroll direction (default: down)', default: 'down' },
-                durationMs: { type: 'number', description: 'Total scroll duration in ms (default: 1500)', default: 1500 },
-                segments: { type: 'integer', description: 'Number of scroll segments (default: 8)', default: 8 },
-                pauseMs: { type: 'number', description: 'Average pause between segments in ms (default: 80)', default: 80 },
-                jitter: { type: 'number', description: 'Random variation factor 0-1 (default: 0.3)', default: 0.3 },
-                selector: { type: 'string', description: 'CSS selector of scrollable container (default: window)' },
+                distance: {
+                    type: 'number',
+                    description: 'Total scroll distance in pixels (default: 500)',
+                    default: 500,
+                },
+                direction: {
+                    type: 'string',
+                    enum: ['up', 'down', 'left', 'right'],
+                    description: 'Scroll direction (default: down)',
+                    default: 'down',
+                },
+                durationMs: {
+                    type: 'number',
+                    description: 'Total scroll duration in ms (default: 1500)',
+                    default: 1500,
+                },
+                segments: {
+                    type: 'integer',
+                    description: 'Number of scroll segments (default: 8)',
+                    default: 8,
+                },
+                pauseMs: {
+                    type: 'number',
+                    description: 'Average pause between segments in ms (default: 80)',
+                    default: 80,
+                },
+                jitter: {
+                    type: 'number',
+                    description: 'Random variation factor 0-1 (default: 0.3)',
+                    default: 0.3,
+                },
+                selector: {
+                    type: 'string',
+                    description: 'CSS selector of scrollable container (default: window)',
+                },
             },
         },
     },
@@ -64,9 +122,21 @@ export const behaviorTools = [
                 selector: { type: 'string', description: 'CSS selector of the input field' },
                 text: { type: 'string', description: 'Text to type' },
                 wpm: { type: 'integer', description: 'Words per minute (default: 90)', default: 90 },
-                errorRate: { type: 'number', description: 'Probability of typo per character 0-0.2 (default: 0.02)', default: 0.02 },
-                correctDelayMs: { type: 'number', description: 'Delay before correcting a typo in ms (default: 200)', default: 200 },
-                clearFirst: { type: 'boolean', description: 'Clear existing value before typing (default: false)', default: false },
+                errorRate: {
+                    type: 'number',
+                    description: 'Probability of typo per character 0-0.2 (default: 0.02)',
+                    default: 0.02,
+                },
+                correctDelayMs: {
+                    type: 'number',
+                    description: 'Delay before correcting a typo in ms (default: 200)',
+                    default: 200,
+                },
+                clearFirst: {
+                    type: 'boolean',
+                    description: 'Clear existing value before typing (default: false)',
+                    default: false,
+                },
             },
             required: ['selector', 'text'],
         },
@@ -92,7 +162,10 @@ export const behaviorTools = [
                     type: 'string',
                     description: 'Deprecated legacy external-service override; avoid in new callers',
                 },
-                apiKey: { type: 'string', description: 'External solver API key (default: from CAPTCHA_API_KEY env)' },
+                apiKey: {
+                    type: 'string',
+                    description: 'External solver API key (default: from CAPTCHA_API_KEY env)',
+                },
                 challengeType: {
                     type: 'string',
                     enum: ['image', 'widget', 'browser_check', 'auto'],
@@ -105,7 +178,11 @@ export const behaviorTools = [
                 },
                 siteKey: { type: 'string', description: 'Widget site key (auto-extracted if omitted)' },
                 pageUrl: { type: 'string', description: 'Page URL for context (auto-detected if omitted)' },
-                timeoutMs: { type: 'number', description: 'Max solve time in ms (default: 180000)', default: 180000 },
+                timeoutMs: {
+                    type: 'number',
+                    description: 'Max solve time in ms (default: 180000)',
+                    default: 180000,
+                },
                 maxRetries: { type: 'integer', description: 'Max retry attempts (default: 2)', default: 2 },
             },
         },
@@ -136,8 +213,16 @@ export const behaviorTools = [
                     description: 'Deprecated legacy external-service override; avoid in new callers',
                 },
                 apiKey: { type: 'string', description: 'External solver API key' },
-                timeoutMs: { type: 'number', description: 'Max solve time in ms (default: 120000)', default: 120000 },
-                injectToken: { type: 'boolean', description: 'Auto-inject solved token into page (default: true)', default: true },
+                timeoutMs: {
+                    type: 'number',
+                    description: 'Max solve time in ms (default: 120000)',
+                    default: 120000,
+                },
+                injectToken: {
+                    type: 'boolean',
+                    description: 'Auto-inject solved token into page (default: true)',
+                    default: true,
+                },
             },
         },
     },

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

@@ -336,7 +336,11 @@ Modes:
                 selector: {
                     oneOf: [
                         { type: 'string', description: 'Single CSS selector' },
-                        { type: 'array', items: { type: 'string' }, description: 'Array of CSS selectors for batch element screenshots' },
+                        {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Array of CSS selectors for batch element screenshots',
+                        },
                     ],
                     description: 'CSS selector(s) of the element(s) to screenshot. Omit or pass "all" for full page viewport.',
                 },

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

@@ -38,7 +38,7 @@ Drivers:
 Modes:
 - launch (default): launch a local browser instance
 - connect: reuse an existing browser instance
-  - chrome: connect via browserURL (http://host:port) or wsEndpoint
+  - chrome: connect via browserURL (http://host:port), wsEndpoint, or Chrome 144+ autoConnect
   - camoufox: connect via wsEndpoint from camoufox_server_launch`,
         inputSchema: {
             type: 'object',
@@ -62,7 +62,7 @@ Modes:
                 },
                 mode: {
                     type: 'string',
-                    description: 'Launch mode. launch = start local browser. connect = reuse existing browser (chrome: browserURL/wsEndpoint, camoufox: wsEndpoint).',
+                    description: 'Launch mode. launch = start local browser. connect = reuse existing browser (chrome: browserURL/wsEndpoint/autoConnect, camoufox: wsEndpoint).',
                     enum: ['launch', 'connect'],
                     default: 'launch',
                 },
@@ -74,6 +74,21 @@ Modes:
                     type: 'string',
                     description: 'WebSocket endpoint to connect to (chrome or camoufox connect mode). For camoufox, get this from camoufox_server_launch.',
                 },
+                autoConnect: {
+                    type: 'boolean',
+                    description: '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,
+                },
+                channel: {
+                    type: 'string',
+                    description: 'Chrome channel used for autoConnect when userDataDir is not provided.',
+                    enum: ['stable', 'beta', 'dev', 'canary'],
+                    default: 'stable',
+                },
+                userDataDir: {
+                    type: 'string',
+                    description: 'Optional Chrome profile directory for autoConnect. If omitted, the default profile path for the selected channel is used.',
+                },
             },
         },
     },
@@ -136,11 +151,12 @@ Requires binaries: npx camoufox-js fetch`,
         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://...).
+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.`,
@@ -155,6 +171,21 @@ After attaching, use page_navigate / page_screenshot / debugger_enable normally.
                     type: 'string',
                     description: 'WebSocket URL from /json/version (e.g., ws://127.0.0.1:9222/devtools/browser/xxx)',
                 },
+                autoConnect: {
+                    type: 'boolean',
+                    description: '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,
+                },
+                channel: {
+                    type: 'string',
+                    description: 'Chrome channel used for autoConnect when userDataDir is not provided.',
+                    enum: ['stable', 'beta', 'dev', 'canary'],
+                    default: 'stable',
+                },
+                userDataDir: {
+                    type: 'string',
+                    description: 'Optional Chrome profile directory for autoConnect. If omitted, the default profile path for the selected channel is used.',
+                },
                 pageIndex: {
                     type: 'number',
                     description: 'Index of the page/tab to activate (default: 0)',

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

@@ -112,7 +112,9 @@ Call after browser_launch for best results.`,
 
 Updates navigator.userAgent, navigator.platform, navigator.vendor,
 navigator.hardwareConcurrency, and navigator.deviceMemory consistently
-to avoid fingerprint inconsistencies.`,
+to avoid fingerprint inconsistencies.
+
+UA strings are updated to Chrome 131 with platform-appropriate hardware profiles.`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -125,6 +127,98 @@ to avoid fingerprint inconsistencies.`,
             },
         },
     },
+    {
+        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
+- burstMode: skip jitter for time-critical operations (debugging, breakpoints)`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                enabled: {
+                    type: 'boolean',
+                    description: 'Enable/disable jitter',
+                    default: true,
+                },
+                minDelayMs: {
+                    type: 'number',
+                    description: 'Minimum delay (ms)',
+                    default: 20,
+                },
+                maxDelayMs: {
+                    type: 'number',
+                    description: 'Maximum delay (ms)',
+                    default: 80,
+                },
+                burstMode: {
+                    type: 'boolean',
+                    description: 'Skip jitter for time-critical ops',
+                    default: false,
+                },
+            },
+        },
+    },
+    {
+        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.
+Falls back to built-in StealthScripts patches if packages are not installed.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                os: {
+                    type: 'string',
+                    description: 'Target OS for fingerprint',
+                    enum: ['windows', 'macos', 'linux'],
+                },
+                browser: {
+                    type: 'string',
+                    description: 'Target browser',
+                    enum: ['chrome', 'firefox'],
+                    default: 'chrome',
+                },
+                locale: {
+                    type: 'string',
+                    description: 'Locale string (e.g. en-US)',
+                    default: 'en-US',
+                },
+            },
+        },
+    },
+    {
+        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.
+
+Best used after stealth_inject to verify patches are effective.`,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
     {
         name: 'browser_list_tabs',
         description: `List all open tabs/pages in the connected browser.
@@ -133,12 +227,13 @@ 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")
+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(browserURL="http://127.0.0.1:9222")
+browser_list_tabs(autoConnect=true, channel="stable")`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -146,6 +241,25 @@ browser_list_tabs(browserURL="http://127.0.0.1:9222")`,
                     type: 'string',
                     description: 'Optional: connect to this browser URL before listing (e.g. http://127.0.0.1:9222)',
                 },
+                wsEndpoint: {
+                    type: 'string',
+                    description: 'Optional: connect to this browser WebSocket endpoint before listing.',
+                },
+                autoConnect: {
+                    type: 'boolean',
+                    description: '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,
+                },
+                channel: {
+                    type: 'string',
+                    description: 'Chrome channel used for autoConnect when userDataDir is not provided.',
+                    enum: ['stable', 'beta', 'dev', 'canary'],
+                    default: 'stable',
+                },
+                userDataDir: {
+                    type: 'string',
+                    description: 'Optional Chrome profile directory for autoConnect. If omitted, the default profile path for the selected channel is used.',
+                },
             },
         },
     },

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

@@ -16,7 +16,13 @@ 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<{