@jshookmcp/jshook 0.2.5 → 0.2.7

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

@@ -1,59 +0,0 @@
-import { bindByDepKey, toolLookup } from '../../domains/shared/registry.js';
-import { coordinationTools } from '../../domains/coordination/definitions.js';
-import { CoordinationHandlers } from '../../domains/coordination/index.js';
-const DOMAIN = 'coordination';
-const DEP_KEY = 'coordinationHandlers';
-const t = toolLookup(coordinationTools);
-const b = (invoke) => bindByDepKey(DEP_KEY, invoke);
-function ensure(ctx) {
-    if (!ctx.coordinationHandlers) {
-        ctx.coordinationHandlers = new CoordinationHandlers(ctx);
-    }
-    return ctx.coordinationHandlers;
-}
-const manifest = {
-    kind: 'domain-manifest',
-    version: 1,
-    domain: DOMAIN,
-    depKey: DEP_KEY,
-    profiles: ['workflow', 'full'],
-    ensure,
-    registrations: [
-        {
-            tool: t('create_task_handoff'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleCreateTaskHandoff(a)),
-        },
-        {
-            tool: t('complete_task_handoff'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleCompleteTaskHandoff(a)),
-        },
-        {
-            tool: t('get_task_context'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleGetTaskContext(a)),
-        },
-        {
-            tool: t('append_session_insight'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleAppendSessionInsight(a)),
-        },
-        {
-            tool: t('save_page_snapshot'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleSavePageSnapshot(a)),
-        },
-        {
-            tool: t('restore_page_snapshot'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleRestorePageSnapshot(a)),
-        },
-        {
-            tool: t('list_page_snapshots'),
-            domain: DOMAIN,
-            bind: b((h) => h.handleListPageSnapshots()),
-        },
-    ],
-};
-export default manifest;

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

@@ -1 +0,0 @@
-export { debuggerTools } from '../../domains/debugger/definitions.tools.js';

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

@@ -1 +0,0 @@
-export { debuggerTools } from '../../domains/debugger/definitions.tools.js';

package/dist/src/server/domains/debugger/definitions.tools.advanced.d.ts

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

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

@@ -1,136 +0,0 @@
-import { tool } from '../../registry/tool-builder.js';
-export const DEBUGGER_ADVANCED_TOOLS = [
-    tool('watch_add')
-        .desc(` Add a watch expression to monitor variable values
-
-Usage:
-- Monitor key variables during debugging
-- Automatically evaluate on each pause
-- Track value changes over time
-
-Example:
-watch_add(expression="window.byted_acrawler", name="acrawler")`)
-        .string('expression', 'JavaScript expression to watch (e.g., "window.obj", "arguments[0]")')
-        .string('name', 'Optional friendly name for the watch expression')
-        .required('expression')
-        .build(),
-    tool('watch_remove')
-        .desc('Remove a watch expression by ID')
-        .string('watchId', 'Watch expression ID (from watch_add or watch_list)')
-        .required('watchId')
-        .idempotent()
-        .build(),
-    tool('watch_list').desc('List all watch expressions').readOnly().idempotent().build(),
-    tool('watch_evaluate_all')
-        .desc(`Evaluate all enabled watch expressions
-
-Returns:
-- Current values of all watch expressions
-- Value change indicators
-- Error information if evaluation fails
-
-Best used when paused at a breakpoint.`)
-        .string('callFrameId', 'Optional call frame ID (from get_call_stack)')
-        .readOnly()
-        .idempotent()
-        .build(),
-    tool('watch_clear_all').desc('Clear all watch expressions').destructive().build(),
-    tool('xhr_breakpoint_set')
-        .desc(` Set XHR/Fetch breakpoint (pause before network requests)
-
-Usage:
-- Intercept API calls
-- Debug request parameter generation
-- Trace network request logic
-
-Supports wildcard patterns:
-- "*api*" - matches any URL containing "api"
-- "*/aweme/v1/*" - matches specific API path
-- "*" - matches all requests
-
-Example:
-xhr_breakpoint_set(urlPattern="*aweme/v1/*")`)
-        .string('urlPattern', 'URL pattern (supports wildcards *)')
-        .required('urlPattern')
-        .idempotent()
-        .build(),
-    tool('xhr_breakpoint_remove')
-        .desc('Remove XHR breakpoint by ID')
-        .string('breakpointId', 'XHR breakpoint ID')
-        .required('breakpointId')
-        .idempotent()
-        .build(),
-    tool('xhr_breakpoint_list').desc('List all XHR breakpoints').readOnly().idempotent().build(),
-    tool('event_breakpoint_set')
-        .desc(` Set event listener breakpoint (pause on event)
-
-Common event names:
-- Mouse: click, dblclick, mousedown, mouseup, mousemove
-- Keyboard: keydown, keyup, keypress
-- Timer: setTimeout, setInterval, requestAnimationFrame
-- WebSocket: message, open, close, error
-
-Example:
-event_breakpoint_set(eventName="click")
-event_breakpoint_set(eventName="setTimeout")`)
-        .string('eventName', 'Event name (e.g., "click", "setTimeout")')
-        .string('targetName', 'Optional target name (e.g., "WebSocket")')
-        .required('eventName')
-        .idempotent()
-        .build(),
-    tool('event_breakpoint_set_category')
-        .desc(`Set breakpoints for entire event category
-
-Categories:
-- mouse: All mouse events (click, mousedown, etc.)
-- keyboard: All keyboard events (keydown, keyup, etc.)
-- timer: All timer events (setTimeout, setInterval, etc.)
-- websocket: All WebSocket events (message, open, etc.)
-
-Example:
-event_breakpoint_set_category(category="mouse")`)
-        .enum('category', ['mouse', 'keyboard', 'timer', 'websocket'], 'Event category')
-        .required('category')
-        .idempotent()
-        .build(),
-    tool('event_breakpoint_remove')
-        .desc('Remove event breakpoint by ID')
-        .string('breakpointId', 'Event breakpoint ID')
-        .required('breakpointId')
-        .idempotent()
-        .build(),
-    tool('event_breakpoint_list').desc('List all event breakpoints').readOnly().idempotent().build(),
-    tool('blackbox_add')
-        .desc(` Blackbox scripts (skip during debugging)
-
-Usage:
-- Skip third-party library code
-- Focus on business logic
-- Improve debugging efficiency
-
-Common patterns:
-- "*jquery*.js" - jQuery
-- "*react*.js" - React
-- "*node_modules/*" - All npm packages
-- "*webpack*" - Webpack bundles
-
-Example:
-blackbox_add(urlPattern="*node_modules/*")`)
-        .string('urlPattern', 'URL pattern to blackbox (supports wildcards *)')
-        .required('urlPattern')
-        .idempotent()
-        .build(),
-    tool('blackbox_add_common')
-        .desc(`Blackbox all common libraries (one-click)
-
-Includes:
-- jquery, react, vue, angular
-- lodash, underscore, moment
-- webpack, node_modules, vendor bundles
-
-Example:
-blackbox_add_common()`)
-        .idempotent()
-        .build(),
-    tool('blackbox_list').desc('List all blackboxed patterns').readOnly().idempotent().build(),
-];

package/dist/src/server/domains/debugger/definitions.tools.core.d.ts

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

package/dist/src/server/domains/debugger/definitions.tools.core.js

@@ -1,173 +0,0 @@
-import { tool } from '../../registry/tool-builder.js';
-export const DEBUGGER_CORE_TOOLS = [
-    tool('debugger_enable')
-        .desc('Enable the debugger (must be called before setting breakpoints)')
-        .idempotent()
-        .build(),
-    tool('debugger_disable')
-        .desc('Disable the debugger and clear all breakpoints')
-        .destructive()
-        .build(),
-    tool('debugger_pause').desc('Pause execution at the next statement').build(),
-    tool('debugger_resume').desc('Resume execution (continue)').build(),
-    tool('debugger_step_into').desc('Step into the next function call').build(),
-    tool('debugger_step_over').desc('Step over the next function call').build(),
-    tool('debugger_step_out').desc('Step out of the current function').build(),
-    tool('breakpoint_set')
-        .desc('Set a breakpoint at a specific location. Supports URL-based and scriptId-based breakpoints with optional conditions.')
-        .string('url', 'URL of the script (e.g., "app.js", "https://cdn.example.com/app.js")')
-        .string('scriptId', 'Script ID (alternative to URL, get from get_all_scripts)')
-        .number('lineNumber', 'Line number (0-based)')
-        .number('columnNumber', 'Column number (0-based, optional)')
-        .string('condition', 'Conditional breakpoint expression (e.g., "x > 100")')
-        .required('lineNumber')
-        .idempotent()
-        .build(),
-    tool('breakpoint_remove')
-        .desc('Remove a breakpoint by its ID')
-        .string('breakpointId', 'Breakpoint ID (from breakpoint_set or breakpoint_list)')
-        .required('breakpointId')
-        .idempotent()
-        .build(),
-    tool('breakpoint_list').desc('List all active breakpoints').readOnly().idempotent().build(),
-    tool('get_call_stack')
-        .desc('Get the current call stack (only available when paused at a breakpoint)')
-        .readOnly()
-        .idempotent()
-        .build(),
-    tool('debugger_evaluate')
-        .desc('Evaluate an expression in the context of the current call frame (only when paused)')
-        .string('expression', 'JavaScript expression to evaluate (e.g., "x + y", "user.name")')
-        .string('callFrameId', 'Call frame ID (from get_call_stack, defaults to current frame)')
-        .required('expression')
-        .openWorld()
-        .build(),
-    tool('debugger_evaluate_global')
-        .desc('Evaluate an expression in the global context (does not require paused state)')
-        .string('expression', 'JavaScript expression to evaluate')
-        .required('expression')
-        .openWorld()
-        .build(),
-    tool('debugger_wait_for_paused')
-        .desc('Wait for the debugger to pause (useful after setting breakpoints and triggering code)')
-        .number('timeout', 'Timeout in milliseconds (default: 30000)', { default: 30000 })
-        .readOnly()
-        .idempotent()
-        .build(),
-    tool('debugger_get_paused_state')
-        .desc('Get the current paused state (check if debugger is paused and why)')
-        .readOnly()
-        .idempotent()
-        .build(),
-    tool('breakpoint_set_on_exception')
-        .desc('Pause on exceptions (all exceptions or only uncaught)')
-        .enum('state', ['none', 'uncaught', 'all'], 'Exception pause state', { default: 'none' })
-        .required('state')
-        .idempotent()
-        .build(),
-    tool('get_object_properties')
-        .desc('Get all properties of an object (when paused, use objectId from variables)')
-        .string('objectId', 'Object ID (from get_scope_variables)')
-        .required('objectId')
-        .readOnly()
-        .idempotent()
-        .build(),
-    tool('get_scope_variables_enhanced')
-        .desc(`Enhanced scope variable inspection with deep object traversal.
-
-Improvements over get_scope_variables:
-1. Graceful error handling for "Could not find object" errors (retries with fallback)
-2. Configurable object property expansion
-3. Adjustable traversal depth
-4. Selective error skipping
-
-Use cases:
-- Inspect complex nested objects
-- Debug variable state in async/closure scopes
-- Examine prototype chains
-
-Examples:
-get_scope_variables_enhanced()
-get_scope_variables_enhanced(callFrameId="xxx", includeObjectProperties=true)`)
-        .string('callFrameId', 'Call frame ID (from get_call_stack, defaults to current frame)')
-        .boolean('includeObjectProperties', 'Expand object properties recursively (default: false)', {
-        default: false,
-    })
-        .number('maxDepth', 'Maximum traversal depth for nested objects (default: 1)', { default: 1 })
-        .boolean('skipErrors', 'Skip properties that throw errors during access (default: true)', {
-        default: true,
-    })
-        .readOnly()
-        .idempotent()
-        .build(),
-    tool('debugger_save_session')
-        .desc(`Save the current debugging session to a JSON file for later restoration.
-
-Captures:
-- All active breakpoints (location, condition, action)
-- Watch expressions
-- Blackboxed script patterns
-
-Saved to:
-- Default: ./debugger-sessions/<timestamp>.json
-- Custom: specified filePath
-
-Examples:
-debugger_save_session()
-debugger_save_session(filePath="my-debug-session.json", metadata={description: "Login flow debugging"})`)
-        .string('filePath', 'Output file path (defaults to ./debugger-sessions/<timestamp>.json)')
-        .object('metadata', {}, 'Optional metadata to attach (e.g., description, tags)')
-        .idempotent()
-        .build(),
-    tool('debugger_load_session')
-        .desc(`Load a previously saved debugging session to restore breakpoints and watches.
-
-Two input modes:
-1. File path: provide filePath to load from disk
-2. Inline JSON: provide sessionData as JSON string
-
-Restores:
-- Breakpoints with original conditions
-- Watch expressions
-- Blackboxed patterns
-
-Examples:
-debugger_load_session(filePath="my-debug-session.json")
-debugger_load_session(sessionData="{...}")`)
-        .string('filePath', 'Path to the saved session file')
-        .string('sessionData', 'Session JSON string (alternative to filePath)')
-        .idempotent()
-        .build(),
-    tool('debugger_export_session')
-        .desc(`Export the current debugging session as a JSON string for sharing or backup.
-
-Returns session data as JSON, including:
-- Active breakpoints
-- Watch expressions
-- Blackboxed patterns
-
-Examples:
-debugger_export_session()
-debugger_export_session(metadata={description: "API debugging session"})`)
-        .object('metadata', {}, 'Optional metadata to include in the export')
-        .readOnly()
-        .idempotent()
-        .build(),
-    tool('debugger_list_sessions')
-        .desc(`List all saved debugging sessions in the ./debugger-sessions/ directory.
-
-Returns for each session:
-- File name and path
-- Creation timestamp
-- Attached metadata (if any)
-
-Use cases:
-- Browse available sessions to restore
-- Clean up old sessions
-
-Examples:
-debugger_list_sessions()`)
-        .readOnly()
-        .idempotent()
-        .build(),
-];

package/dist/src/server/domains/debugger/definitions.tools.d.ts

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

package/dist/src/server/domains/debugger/definitions.tools.js

@@ -1,3 +0,0 @@
-import { DEBUGGER_CORE_TOOLS } from '../../domains/debugger/definitions.tools.core.js';
-import { DEBUGGER_ADVANCED_TOOLS } from '../../domains/debugger/definitions.tools.advanced.js';
-export const debuggerTools = [...DEBUGGER_CORE_TOOLS, ...DEBUGGER_ADVANCED_TOOLS];

package/dist/src/server/domains/debugger/handlers/blackbox-handlers.d.ts

@@ -1,29 +0,0 @@
-import type { DebuggerManager } from '../../../domains/shared/modules.js';
-interface BlackboxHandlersDeps {
-    debuggerManager: DebuggerManager;
-}
-export declare class BlackboxHandlers {
-    private deps;
-    constructor(deps: BlackboxHandlersDeps);
-    private ensureAdvancedFeaturesIfSupported;
-    private getBlackboxManager;
-    handleBlackboxAdd(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleBlackboxAddCommon(_args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleBlackboxList(_args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-}
-export {};

package/dist/src/server/domains/debugger/handlers/blackbox-handlers.js

@@ -1,124 +0,0 @@
-import { argString } from '../../../domains/shared/parse-args.js';
-function hasEnsureAdvancedFeatures(manager) {
-    return (typeof manager.ensureAdvancedFeatures === 'function');
-}
-function getErrorMessage(error) {
-    if (typeof error === 'object' && error !== null && 'message' in error) {
-        const message = error.message;
-        if (typeof message === 'string' && message.length > 0) {
-            return message;
-        }
-    }
-    return String(error);
-}
-export class BlackboxHandlers {
-    deps;
-    constructor(deps) {
-        this.deps = deps;
-    }
-    async ensureAdvancedFeaturesIfSupported() {
-        if (hasEnsureAdvancedFeatures(this.deps.debuggerManager)) {
-            await this.deps.debuggerManager.ensureAdvancedFeatures();
-        }
-    }
-    async getBlackboxManager() {
-        await this.ensureAdvancedFeaturesIfSupported();
-        return this.deps.debuggerManager.getBlackboxManager();
-    }
-    async handleBlackboxAdd(args) {
-        try {
-            const urlPattern = argString(args, 'urlPattern', '');
-            const blackboxManager = await this.getBlackboxManager();
-            await blackboxManager.blackboxByPattern(urlPattern);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: true,
-                            message: 'Script pattern blackboxed',
-                            urlPattern,
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: false,
-                            message: 'Failed to add blackbox pattern',
-                            error: getErrorMessage(error),
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-    }
-    async handleBlackboxAddCommon(_args) {
-        try {
-            const blackboxManager = await this.getBlackboxManager();
-            await blackboxManager.blackboxCommonLibraries();
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: true,
-                            message: 'Blackboxed common library patterns',
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: false,
-                            message: 'Failed to add common blackbox patterns',
-                            error: getErrorMessage(error),
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-    }
-    async handleBlackboxList(_args) {
-        try {
-            const blackboxManager = await this.getBlackboxManager();
-            const patterns = blackboxManager.getAllBlackboxedPatterns();
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: true,
-                            message: `Found ${patterns.length} blackboxed pattern(s)`,
-                            patterns,
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: false,
-                            message: 'Failed to list blackbox patterns',
-                            error: getErrorMessage(error),
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-    }
-}

package/dist/src/server/domains/debugger/handlers/breakpoint-basic.d.ts

@@ -1,27 +0,0 @@
-import type { DebuggerManager } from '../../../domains/shared/modules.js';
-interface BreakpointBasicHandlersDeps {
-    debuggerManager: DebuggerManager;
-}
-export declare class BreakpointBasicHandlers {
-    private deps;
-    constructor(deps: BreakpointBasicHandlersDeps);
-    handleBreakpointSet(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleBreakpointRemove(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleBreakpointList(_args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-}
-export {};

package/dist/src/server/domains/debugger/handlers/breakpoint-basic.js

@@ -1,85 +0,0 @@
-import { argString, argNumber } from '../../../domains/shared/parse-args.js';
-export class BreakpointBasicHandlers {
-    deps;
-    constructor(deps) {
-        this.deps = deps;
-    }
-    async handleBreakpointSet(args) {
-        const url = argString(args, 'url');
-        const scriptId = argString(args, 'scriptId');
-        const lineNumber = argNumber(args, 'lineNumber', 0);
-        const columnNumber = argNumber(args, 'columnNumber');
-        const condition = argString(args, 'condition');
-        let breakpoint;
-        if (url) {
-            breakpoint = await this.deps.debuggerManager.setBreakpointByUrl({
-                url,
-                lineNumber,
-                columnNumber,
-                condition,
-            });
-        }
-        else if (scriptId) {
-            breakpoint = await this.deps.debuggerManager.setBreakpoint({
-                scriptId,
-                lineNumber,
-                columnNumber,
-                condition,
-            });
-        }
-        else {
-            throw new Error('Either url or scriptId must be provided');
-        }
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        success: true,
-                        breakpoint: {
-                            breakpointId: breakpoint.breakpointId,
-                            location: breakpoint.location,
-                            condition: breakpoint.condition,
-                            enabled: breakpoint.enabled,
-                        },
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    async handleBreakpointRemove(args) {
-        const breakpointId = argString(args, 'breakpointId', '');
-        await this.deps.debuggerManager.removeBreakpoint(breakpointId);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        success: true,
-                        message: `Breakpoint ${breakpointId} removed`,
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    async handleBreakpointList(_args) {
-        const breakpoints = this.deps.debuggerManager.listBreakpoints();
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        count: breakpoints.length,
-                        breakpoints: breakpoints.map((bp) => ({
-                            breakpointId: bp.breakpointId,
-                            location: bp.location,
-                            condition: bp.condition,
-                            enabled: bp.enabled,
-                            hitCount: bp.hitCount,
-                        })),
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-}

package/dist/src/server/domains/debugger/handlers/breakpoint-exception.d.ts

@@ -1,15 +0,0 @@
-import type { DebuggerManager } from '../../../domains/shared/modules.js';
-interface BreakpointExceptionHandlersDeps {
-    debuggerManager: DebuggerManager;
-}
-export declare class BreakpointExceptionHandlers {
-    private deps;
-    constructor(deps: BreakpointExceptionHandlersDeps);
-    handleBreakpointSetOnException(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-}
-export {};