@jshookmcp/jshook 0.2.1 → 0.2.3

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

@@ -12,6 +12,12 @@ export const antidebugTools = [
                 },
             },
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'antidebug_bypass_debugger_statement',
@@ -27,6 +33,12 @@ export const antidebugTools = [
                 },
             },
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'antidebug_bypass_timing',
@@ -41,6 +53,12 @@ export const antidebugTools = [
                 },
             },
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'antidebug_bypass_stack_trace',
@@ -57,6 +75,12 @@ export const antidebugTools = [
                 },
             },
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'antidebug_bypass_console_detect',
@@ -65,6 +89,12 @@ export const antidebugTools = [
             type: 'object',
             properties: {},
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'antidebug_detect_protections',
@@ -73,5 +103,11 @@ export const antidebugTools = [
             type: 'object',
             properties: {},
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
 ];

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

@@ -1,3 +1,4 @@
+import { evaluateWithTimeout, evaluateOnNewDocumentWithTimeout, } from '../../../modules/collector/PageController.js';
 import { ANTI_DEBUG_SCRIPTS } from '../../domains/antidebug/scripts.js';
 export class AntiDebugToolHandlers {
     collector;
@@ -77,9 +78,7 @@ export class AntiDebugToolHandlers {
     }
     parseStringArrayArg(value) {
         if (Array.isArray(value)) {
-            return value
-                .map((item) => String(item).trim())
-                .filter((item) => item.length > 0);
+            return value.map((item) => String(item).trim()).filter((item) => item.length > 0);
         }
         if (typeof value === 'string') {
             return value
@@ -90,10 +89,7 @@ export class AntiDebugToolHandlers {
         return [];
     }
     mergeStackFilterPatterns(extraPatterns) {
-        const merged = [
-            ...AntiDebugToolHandlers.DEFAULT_STACK_FILTER_PATTERNS,
-            ...extraPatterns,
-        ].map((item) => item.trim());
+        const merged = [...AntiDebugToolHandlers.DEFAULT_STACK_FILTER_PATTERNS, ...extraPatterns].map((item) => item.trim());
         return Array.from(new Set(merged.filter((item) => item.length > 0)));
     }
     buildScript(template, replacements) {
@@ -105,27 +101,27 @@ export class AntiDebugToolHandlers {
     }
     buildDebuggerBypassScript(mode) {
         return this.buildScript(ANTI_DEBUG_SCRIPTS.bypassDebuggerStatement, {
-            '__ANTI_DEBUG_MODE__': JSON.stringify(mode),
+            __ANTI_DEBUG_MODE__: JSON.stringify(mode),
         });
     }
     buildTimingBypassScript(maxDrift) {
         return this.buildScript(ANTI_DEBUG_SCRIPTS.bypassTiming, {
-            '__ANTI_DEBUG_MAX_DRIFT__': String(maxDrift),
+            __ANTI_DEBUG_MAX_DRIFT__: String(maxDrift),
         });
     }
     buildStackTraceBypassScript(filterPatterns) {
         return this.buildScript(ANTI_DEBUG_SCRIPTS.bypassStackTrace, {
-            '__ANTI_DEBUG_FILTER_PATTERNS__': JSON.stringify(filterPatterns),
+            __ANTI_DEBUG_FILTER_PATTERNS__: JSON.stringify(filterPatterns),
         });
     }
     async injectScripts(page, scripts, persistent) {
         if (persistent) {
             for (const script of scripts) {
-                await page.evaluateOnNewDocument(script);
+                await evaluateOnNewDocumentWithTimeout(page, script);
             }
         }
         for (const script of scripts) {
-            await page.evaluate(script);
+            await evaluateWithTimeout(page, script);
         }
     }
     async getPage() {
@@ -252,7 +248,7 @@ export class AntiDebugToolHandlers {
     async handleAntiDebugDetectProtections(_args) {
         try {
             const page = await this.getPage();
-            const result = (await page.evaluate(ANTI_DEBUG_SCRIPTS.detectProtections));
+            const result = (await evaluateWithTimeout(page, ANTI_DEBUG_SCRIPTS.detectProtections));
             return this.toTextResponse({
                 success: result?.success ?? true,
                 tool: 'antidebug_detect_protections',

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.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.
@@ -200,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/camoufox-browser.js

@@ -12,7 +12,7 @@ async function checkCamoufoxDependencies() {
             return `Camoufox requires native dependencies that are not installed. Run: pnpm add better-sqlite3 or npm rebuild better-sqlite3. Original error: ${errorMsg}`;
         }
         if (errorMsg.includes("Cannot find package 'camoufox-js'")) {
-            return "camoufox-js package is not installed. Run: pnpm add camoufox-js && npx camoufox-js fetch";
+            return 'camoufox-js package is not installed. Run: pnpm add camoufox-js && npx camoufox-js fetch';
         }
         return `Camoufox dependencies check failed: ${errorMsg}`;
     }

package/dist/src/server/domains/browser/handlers/camoufox-flow.js

@@ -8,13 +8,15 @@ export async function handleCamoufoxLaunchFlow(context, args) {
         const wsEndpoint = argString(args, 'wsEndpoint');
         if (!wsEndpoint) {
             return {
-                content: [{
+                content: [
+                    {
                         type: 'text',
                         text: JSON.stringify({
                             success: false,
                             error: 'wsEndpoint is required for connect mode.',
                         }, null, 2),
-                    }],
+                    },
+                ],
             };
         }
         const manager = new CamoufoxBrowserManager({ headless, os });
@@ -23,7 +25,8 @@ export async function handleCamoufoxLaunchFlow(context, args) {
         context.setActiveDriver('camoufox');
         context.clearCamoufoxPage();
         return {
-            content: [{
+            content: [
+                {
                     type: 'text',
                     text: JSON.stringify({
                         success: true,
@@ -32,7 +35,8 @@ export async function handleCamoufoxLaunchFlow(context, args) {
                         wsEndpoint,
                         message: 'Connected to Camoufox server.',
                     }, null, 2),
-                }],
+                },
+            ],
         };
     }
     const manager = new CamoufoxBrowserManager({ headless, os });
@@ -41,7 +45,8 @@ export async function handleCamoufoxLaunchFlow(context, args) {
     context.setActiveDriver('camoufox');
     context.clearCamoufoxPage();
     return {
-        content: [{
+        content: [
+            {
                 type: 'text',
                 text: JSON.stringify({
                     success: true,
@@ -49,7 +54,8 @@ export async function handleCamoufoxLaunchFlow(context, args) {
                     mode: 'launch',
                     message: 'Camoufox (Firefox) browser launched',
                 }, null, 2),
-            }],
+            },
+        ],
     };
 }
 function normalizeWaitUntil(waitUntil) {
@@ -71,7 +77,8 @@ export async function handleCamoufoxNavigateFlow(context, args) {
     await page.goto(url, { waitUntil: normalizeWaitUntil(rawWaitUntil), timeout });
     context.setConsoleMonitorPage(page);
     return {
-        content: [{
+        content: [
+            {
                 type: 'text',
                 text: JSON.stringify({
                     success: true,
@@ -79,6 +86,7 @@ export async function handleCamoufoxNavigateFlow(context, args) {
                     url: page.url(),
                     title: await page.title(),
                 }, null, 2),
-            }],
+            },
+        ],
     };
 }