@jshookmcp/jshook 0.2.3 → 0.2.6

package/dist/src/server/domains/browser/handlers/framework-state.js

@@ -224,7 +224,11 @@ export class FrameworkStateHandlers {
                             return null;
                         states.push({
                             component: 'SolidRoot',
-                            state: [{ _note: 'Solid detected via hydration markers; install solid-devtools for full state extraction' }],
+                            state: [
+                                {
+                                    _note: 'Solid detected via hydration markers; install solid-devtools for full state extraction',
+                                },
+                            ],
                         });
                         return states;
                     }
@@ -287,7 +291,9 @@ export class FrameworkStateHandlers {
                             }
                             const typeName = vnode['type'];
                             const name = typeof typeName === 'function'
-                                ? typeName['displayName'] ?? typeName['name'] ?? 'PreactComponent'
+                                ? (typeName['displayName'] ??
+                                    typeName['name'] ??
+                                    'PreactComponent')
                                 : typeof typeName === 'string'
                                     ? typeName
                                     : 'PreactComponent';
@@ -362,25 +368,37 @@ export class FrameworkStateHandlers {
                 const rootEl = getRootEl();
                 const rootObj = rootEl;
                 const keys = Object.keys(rootObj);
+                const hasReactMarker = keys.some((k) => k.startsWith('__reactFiber') ||
+                    k.startsWith('__reactInternalInstance') ||
+                    k.startsWith('__reactFiberContainer'));
+                const hasVue3Marker = keys.some((k) => k === '__vueParentComponent' || k === '__vue_app__');
+                const hasVue2Marker = keys.some((k) => k === '__vue__');
+                const hasSvelteMarker = keys.some((k) => k === '$$' || k === '__svelte_meta' || k.startsWith('__s'));
+                const hasSolidMarker = win['_$DX'] !== undefined ||
+                    win['_$HY'] !== undefined ||
+                    Boolean(document.querySelector('[data-hk]'));
+                const hasPreactMarker = keys.some((k) => k === '__k' || k === '__e' || k === '_dom' || k === '_children');
                 let detectedFramework = opts.framework;
+                if (detectedFramework === 'preact' && hasReactMarker) {
+                    detectedFramework = 'react';
+                }
                 if (detectedFramework === 'auto') {
-                    if (keys.some((k) => k.startsWith('__reactFiber') || k.startsWith('__reactInternalInstance'))) {
+                    if (hasReactMarker) {
                         detectedFramework = 'react';
                     }
-                    else if (keys.some((k) => k === '__vueParentComponent' || k === '__vue_app__')) {
+                    else if (hasVue3Marker) {
                         detectedFramework = 'vue3';
                     }
-                    else if (keys.some((k) => k === '__vue__')) {
+                    else if (hasVue2Marker) {
                         detectedFramework = 'vue2';
                     }
-                    else if (keys.some((k) => k === '$$' || k === '__svelte_meta' || k.startsWith('__s'))) {
+                    else if (hasSvelteMarker) {
                         detectedFramework = 'svelte';
                     }
-                    else if (win['_$DX'] || win['_$HY'] || document.querySelector('[data-hk]')) {
+                    else if (hasSolidMarker) {
                         detectedFramework = 'solid';
                     }
-                    else if (!keys.some((k) => k.startsWith('__reactFiber')) &&
-                        keys.some((k) => k === '__k' || k === '__e' || k === '_dom')) {
+                    else if (hasPreactMarker) {
                         detectedFramework = 'preact';
                     }
                 }

package/dist/src/server/domains/browser/handlers/indexeddb-dump.js

@@ -13,33 +13,24 @@ export class IndexedDBDumpHandlers {
             const result = await page.evaluate(async (opts) => {
                 const dbList = await indexedDB.databases();
                 const output = {};
-                const openDb = (name, version) => new Promise((resolve, reject) => {
-                    const req = version ? indexedDB.open(name, version) : indexedDB.open(name);
-                    req.onsuccess = () => resolve(req.result);
-                    req.onerror = () => reject(req.error);
-                });
-                const getAllFromStore = (db, storeName, max) => new Promise((resolve, reject) => {
-                    try {
-                        const tx = db.transaction(storeName, 'readonly');
-                        const req = tx.objectStore(storeName).getAll();
-                        req.onsuccess = () => resolve(req.result.slice(0, max));
-                        req.onerror = () => reject(req.error);
-                    }
-                    catch (e) {
-                        reject(e);
-                    }
-                });
                 for (const dbInfo of dbList) {
                     if (!dbInfo.name)
                         continue;
                     if (opts.database && dbInfo.name !== opts.database)
                         continue;
+                    const dbName = dbInfo.name;
                     let db;
                     try {
-                        db = await openDb(dbInfo.name, dbInfo.version);
+                        db = await new Promise((resolve, reject) => {
+                            const req = dbInfo.version
+                                ? indexedDB.open(dbName, dbInfo.version)
+                                : indexedDB.open(dbName);
+                            req.addEventListener('success', () => resolve(req.result), { once: true });
+                            req.addEventListener('error', () => reject(req.error), { once: true });
+                        });
                     }
                     catch {
-                        output[dbInfo.name] = { __error__: ['failed to open'] };
+                        output[dbName] = { __error__: ['failed to open'] };
                         continue;
                     }
                     const storeNames = Array.from(db.objectStoreNames);
@@ -48,14 +39,24 @@ export class IndexedDBDumpHandlers {
                         if (opts.store && storeName !== opts.store)
                             continue;
                         try {
-                            dbData[storeName] = await getAllFromStore(db, storeName, opts.maxRecords);
+                            dbData[storeName] = await new Promise((resolve, reject) => {
+                                try {
+                                    const tx = db.transaction(storeName, 'readonly');
+                                    const req = tx.objectStore(storeName).getAll();
+                                    req.addEventListener('success', () => resolve(req.result.slice(0, opts.maxRecords)), { once: true });
+                                    req.addEventListener('error', () => reject(req.error), { once: true });
+                                }
+                                catch (e) {
+                                    reject(e);
+                                }
+                            });
                         }
                         catch {
                             dbData[storeName] = ['__error reading store__'];
                         }
                     }
                     db.close();
-                    output[dbInfo.name] = dbData;
+                    output[dbName] = dbData;
                 }
                 return output;
             }, { database, store, maxRecords });

package/dist/src/server/domains/browser/handlers/script-management.js

@@ -24,7 +24,7 @@ export class ScriptManagementHandlers {
     async handleGetScriptSource(args) {
         const scriptId = argString(args, 'scriptId');
         const url = argString(args, 'url');
-        const preview = argBool(args, 'preview', false);
+        const preview = argBool(args, 'preview', true);
         const maxLines = argNumber(args, 'maxLines', 100);
         const startLine = argNumber(args, 'startLine');
         const endLine = argNumber(args, 'endLine');

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

@@ -5,6 +5,7 @@ interface StealthInjectionHandlersDeps {
     pageController: PageController;
     getActiveDriver: () => 'chrome' | 'camoufox';
 }
+export declare function _resetFingerprintCacheForTesting(): void;
 export declare class StealthInjectionHandlers {
     private deps;
     constructor(deps: StealthInjectionHandlersDeps);

package/dist/src/server/domains/browser/handlers/stealth-injection.js

@@ -17,6 +17,9 @@ async function getFingerprintManager() {
         return null;
     }
 }
+export function _resetFingerprintCacheForTesting() {
+    fingerprintManagerInstance = null;
+}
 export class StealthInjectionHandlers {
     deps;
     constructor(deps) {

package/dist/src/server/domains/browser/handlers.impl.d.ts

@@ -4,7 +4,6 @@ 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 { type LLMService } from '../../../services/LLMService.js';
 import { DetailedDataManager } from '../../../utils/DetailedDataManager.js';
 import { type CamoufoxBrowserManager } from '../../domains/shared/modules.js';
 import { BrowserControlHandlers } from '../../domains/browser/handlers/browser-control.js';
@@ -58,7 +57,7 @@ export declare class BrowserToolHandlers {
     private tabWorkflow;
     private detailedData;
     private _tabRegistry;
-    constructor(collector: CodeCollector, pageController: PageController, domInspector: DOMInspector, scriptManager: ScriptManager, consoleMonitor: ConsoleMonitor, llmService: LLMService);
+    constructor(collector: CodeCollector, pageController: PageController, domInspector: DOMInspector, scriptManager: ScriptManager, consoleMonitor: ConsoleMonitor);
     getTabRegistry(): TabRegistry;
     private getCamoufoxPage;
     private closeCamoufox;

package/dist/src/server/domains/browser/handlers.impl.js

@@ -1,5 +1,4 @@
 import { AICaptchaDetector } from '../../domains/shared/modules.js';
-import {} from '../../../services/LLMService.js';
 import { argString, argNumber, argBool } from '../../domains/shared/parse-args.js';
 import { DetailedDataManager } from '../../../utils/DetailedDataManager.js';
 import { resolveOutputDirectory } from '../../../utils/outputPaths.js';
@@ -60,14 +59,14 @@ export class BrowserToolHandlers {
     tabWorkflow;
     detailedData;
     _tabRegistry;
-    constructor(collector, pageController, domInspector, scriptManager, consoleMonitor, llmService) {
+    constructor(collector, pageController, domInspector, scriptManager, consoleMonitor) {
         this.collector = collector;
         this.pageController = pageController;
         this.domInspector = domInspector;
         this.scriptManager = scriptManager;
         this.consoleMonitor = consoleMonitor;
         const screenshotDir = resolveOutputDirectory(process.env.CAPTCHA_SCREENSHOT_DIR, 'screenshots/captcha');
-        this.captchaDetector = new AICaptchaDetector(llmService, screenshotDir);
+        this.captchaDetector = new AICaptchaDetector(screenshotDir);
         this.detailedDataManager = DetailedDataManager.getInstance();
         const modules = initializeBrowserHandlerModules({
             collector: this.collector,

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

@@ -8,7 +8,7 @@ const b = (invoke) => bindByDepKey(DEP_KEY, invoke);
 function ensure(ctx) {
     ensureBrowserCore(ctx);
     if (!ctx.browserHandlers) {
-        ctx.browserHandlers = new BrowserToolHandlers(ctx.collector, ctx.pageController, ctx.domInspector, ctx.scriptManager, ctx.consoleMonitor, ctx.llm);
+        ctx.browserHandlers = new BrowserToolHandlers(ctx.collector, ctx.pageController, ctx.domInspector, ctx.scriptManager, ctx.consoleMonitor);
     }
     return ctx.browserHandlers;
 }
@@ -29,18 +29,42 @@ const manifest = {
         hint: 'Browser automation workflow: bootstrap browser/page state -> navigate -> interact -> extract data',
     },
     prerequisites: {
-        page_navigate: [{ condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' }],
-        page_click: [{ condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' }],
-        page_type: [{ condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' }],
-        page_screenshot: [{ condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' }],
-        page_evaluate: [{ condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' }],
-        page_hover: [{ condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' }],
-        page_scroll: [{ condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' }],
-        page_back: [{ condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' }],
-        page_forward: [{ condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' }],
-        page_reload: [{ condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' }],
-        dom_get_structure: [{ condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' }],
-        dom_query_selector: [{ condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' }],
+        page_navigate: [
+            { condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' },
+        ],
+        page_click: [
+            { condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' },
+        ],
+        page_type: [
+            { condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' },
+        ],
+        page_screenshot: [
+            { condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' },
+        ],
+        page_evaluate: [
+            { condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' },
+        ],
+        page_hover: [
+            { condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' },
+        ],
+        page_scroll: [
+            { condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' },
+        ],
+        page_back: [
+            { condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' },
+        ],
+        page_forward: [
+            { condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' },
+        ],
+        page_reload: [
+            { condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' },
+        ],
+        dom_get_structure: [
+            { condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' },
+        ],
+        dom_query_selector: [
+            { condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' },
+        ],
     },
     registrations: [
         { tool: t('get_detailed_data'), domain: DOMAIN, bind: b((h, a) => h.handleGetDetailedData(a)) },

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

@@ -1,218 +1,52 @@
+import { tool } from '../../registry/tool-builder.js';
 export const coordinationTools = [
-    {
-        name: 'create_task_handoff',
-        description: 'Create a sub-task handoff for specialist agent delegation.\n\n' +
-            'Use this as a Planner Agent to delegate work to a Specialist. ' +
-            'Automatically captures the current page URL (if any) and injects it into the task context.\n\n' +
-            'Returns:\n' +
-            '- taskId: unique identifier to track this handoff\n' +
-            '- status: "pending"\n' +
-            '- pageUrl: auto-captured active page URL\n\n' +
-            'Example:\n' +
-            '  create_task_handoff({ description: "Analyze API surface of current page", targetDomain: "network" })',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                description: {
-                    type: 'string',
-                    description: 'Clear description of what the specialist should accomplish',
-                },
-                constraints: {
-                    type: 'array',
-                    items: { type: 'string' },
-                    description: 'Optional constraints for the specialist (e.g. "do not navigate away", "read-only analysis")',
-                },
-                targetDomain: {
-                    type: 'string',
-                    description: 'Suggested domain for the specialist (e.g. "network", "debugger", "browser"). Advisory only.',
-                },
-            },
-            required: ['description'],
-        },
-        annotations: {
-            title: 'Create Task Handoff',
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: 'complete_task_handoff',
-        description: 'Complete a previously created task handoff with results.\n\n' +
-            'Use this as a Specialist Agent to report execution results back to the Planner. ' +
-            'Once completed, the handoff status transitions to "completed" and cannot be modified.\n\n' +
-            'Example:\n' +
-            '  complete_task_handoff({\n' +
-            '    taskId: "abc-123",\n' +
-            '    summary: "Found 5 API endpoints with Bearer auth",\n' +
-            '    keyFindings: ["POST /api/v1/login uses JWT", "X-Signature header is HMAC-SHA256"]\n' +
-            '  })',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                taskId: {
-                    type: 'string',
-                    description: 'Task ID from create_task_handoff',
-                },
-                summary: {
-                    type: 'string',
-                    description: 'Concise summary of what was accomplished',
-                },
-                keyFindings: {
-                    type: 'array',
-                    items: { type: 'string' },
-                    description: 'Key discoveries or results from the task',
-                },
-                artifacts: {
-                    type: 'array',
-                    items: { type: 'string' },
-                    description: 'Paths to generated artifact files (HAR exports, reports, etc.)',
-                },
-            },
-            required: ['taskId', 'summary'],
-        },
-        annotations: {
-            title: 'Complete Task Handoff',
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: 'get_task_context',
-        description: 'Read the context of a task handoff.\n\n' +
-            'Returns the full handoff record including description, constraints, status, ' +
-            'page URL, and any completion data. If no taskId is provided, returns all active handoffs.\n\n' +
-            'Also returns accumulated session insights when no taskId is specified.\n\n' +
-            'Example:\n' +
-            '  get_task_context()                  // list all handoffs + session insights\n' +
-            '  get_task_context({ taskId: "abc" }) // specific handoff details',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                taskId: {
-                    type: 'string',
-                    description: 'Specific task ID to retrieve (omit for all active handoffs)',
-                },
-            },
-        },
-        annotations: {
-            title: 'Get Task Context',
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: 'append_session_insight',
-        description: 'Append a discovery to the session-level knowledge accumulator.\n\n' +
-            'Session insights persist for the lifetime of the MCP session and are shared ' +
-            'across all handoffs. Use this to record cross-cutting findings that any agent ' +
-            'in the session should know about.\n\n' +
-            'Categories: "auth", "crypto", "api", "anti_debug", "architecture", "vulnerability", "other"\n\n' +
-            'Example:\n' +
-            '  append_session_insight({\n' +
-            '    category: "auth",\n' +
-            '    content: "JWT stored in localStorage under key \'access_token\'",\n' +
-            '    confidence: 0.95\n' +
-            '  })',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                category: {
-                    type: 'string',
-                    enum: ['auth', 'crypto', 'api', 'anti_debug', 'architecture', 'vulnerability', 'other'],
-                    description: 'Category of the insight',
-                },
-                content: {
-                    type: 'string',
-                    description: 'The insight content',
-                },
-                confidence: {
-                    type: 'number',
-                    description: 'Confidence level 0.0-1.0 (default: 1.0)',
-                    minimum: 0,
-                    maximum: 1,
-                },
-            },
-            required: ['category', 'content'],
-        },
-        annotations: {
-            title: 'Append Session Insight',
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: 'save_page_snapshot',
-        description: 'Save a snapshot of the current page state (URL, cookies, localStorage, sessionStorage).\n\n' +
-            'Useful for checkpoint/restore workflows during reverse engineering — ' +
-            'save state before invasive operations, restore if needed.\n\n' +
-            'Example:\n' +
-            '  save_page_snapshot()\n' +
-            '  save_page_snapshot({ label: "before-login" })',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                label: {
-                    type: 'string',
-                    description: 'Optional human-readable label for this snapshot',
-                },
-            },
-        },
-        annotations: {
-            title: 'Save Page Snapshot',
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: 'restore_page_snapshot',
-        description: 'Restore a previously saved page snapshot.\n\n' +
-            'Navigates to the saved URL and reinjects cookies, localStorage, and sessionStorage.\n\n' +
-            'Example:\n' +
-            '  restore_page_snapshot({ snapshotId: "a1b2c3d4" })',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                snapshotId: {
-                    type: 'string',
-                    description: 'Snapshot ID from save_page_snapshot',
-                },
-            },
-            required: ['snapshotId'],
-        },
-        annotations: {
-            title: 'Restore Page Snapshot',
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: 'list_page_snapshots',
-        description: 'List all saved page snapshots in the current session.\n\n' +
-            'Returns snapshot IDs, URLs, labels, and state counts.\n\n' +
-            'Example:\n' +
-            '  list_page_snapshots()',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-        },
-        annotations: {
-            title: 'List Page Snapshots',
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    },
+    tool('create_task_handoff')
+        .desc('Create a sub-task handoff for specialist agent delegation. Auto-captures active page URL.')
+        .string('description', 'What the specialist should accomplish')
+        .array('constraints', { type: 'string' }, 'Constraints for the specialist')
+        .string('targetDomain', 'Suggested domain for the specialist')
+        .required('description')
+        .build(),
+    tool('complete_task_handoff')
+        .desc('Complete a task handoff with results. Transitions status to completed.')
+        .string('taskId', 'Task ID from create_task_handoff')
+        .string('summary', 'Concise summary of what was accomplished')
+        .array('keyFindings', { type: 'string' }, 'Key discoveries or results')
+        .array('artifacts', { type: 'string' }, 'Paths to generated artifact files')
+        .required('taskId', 'summary')
+        .build(),
+    tool('get_task_context')
+        .desc('Read task handoff context. Without taskId returns all active handoffs + session insights.')
+        .string('taskId', 'Specific task ID to retrieve')
+        .readOnly()
+        .idempotent()
+        .build(),
+    tool('append_session_insight')
+        .desc('Append a discovery to the session-level knowledge accumulator shared across handoffs')
+        .enum('category', ['auth', 'crypto', 'api', 'anti_debug', 'architecture', 'vulnerability', 'other'], 'Insight category')
+        .string('content', 'The insight content')
+        .prop('confidence', {
+        type: 'number',
+        description: 'Confidence level 0.0-1.0',
+        minimum: 0,
+        maximum: 1,
+    })
+        .required('category', 'content')
+        .build(),
+    tool('save_page_snapshot')
+        .desc('Save current page state (URL, cookies, storage) for checkpoint/restore workflows')
+        .string('label', 'Human-readable label for this snapshot')
+        .readOnly()
+        .build(),
+    tool('restore_page_snapshot')
+        .desc('Restore a saved page snapshot — navigates to URL and reinjects cookies and storage')
+        .string('snapshotId', 'Snapshot ID from save_page_snapshot')
+        .required('snapshotId')
+        .idempotent()
+        .build(),
+    tool('list_page_snapshots')
+        .desc('List all saved page snapshots in the current session')
+        .readOnly()
+        .idempotent()
+        .build(),
 ];

package/dist/src/server/domains/coordination/index.d.ts

@@ -1,4 +1,5 @@
-import type { MCPServerContext } from '../../MCPServer.context.js';
+import type { MCPServerContext } from '../../domains/shared/registry.js';
+export * from './definitions.js';
 export interface TaskHandoff {
     id: string;
     status: 'pending' | 'in_progress' | 'completed' | 'failed';

package/dist/src/server/domains/coordination/index.js

@@ -1,4 +1,5 @@
 import { randomUUID } from 'node:crypto';
+export * from './definitions.js';
 export class CoordinationHandlers {
     handoffs = new Map();
     insights = [];