@jshookmcp/jshook 0.2.1 → 0.2.3

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

@@ -1,6 +1,6 @@
 import { argString } from '../../../domains/shared/parse-args.js';
 function hasEnsureAdvancedFeatures(manager) {
-    return typeof manager.ensureAdvancedFeatures === 'function';
+    return (typeof manager.ensureAdvancedFeatures === 'function');
 }
 function getErrorMessage(error) {
     if (typeof error === 'object' && error !== null && 'message' in error) {

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

@@ -9,6 +9,16 @@ declare const manifest: {
     depKey: "debuggerHandlers";
     profiles: ("workflow" | "full")[];
     ensure: typeof ensure;
+    prerequisites: {
+        debugger_enable: {
+            condition: string;
+            fix: string;
+        }[];
+        breakpoint_set: {
+            condition: string;
+            fix: string;
+        }[];
+    };
     registrations: {
         tool: {
             inputSchema: {

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

@@ -25,43 +25,131 @@ const manifest = {
     depKey: DEP_KEY,
     profiles: ['workflow', 'full'],
     ensure,
+    prerequisites: {
+        debugger_enable: [{ condition: 'Browser must be launched', fix: 'Call browser_launch or browser_attach first' }],
+        breakpoint_set: [{ condition: 'Browser must be launched', fix: 'Call browser_launch and debugger_enable first' }],
+    },
     registrations: [
         { tool: t('debugger_enable'), domain: DOMAIN, bind: b((h, a) => h.handleDebuggerEnable(a)) },
         { tool: t('debugger_disable'), domain: DOMAIN, bind: b((h, a) => h.handleDebuggerDisable(a)) },
         { tool: t('debugger_pause'), domain: DOMAIN, bind: b((h, a) => h.handleDebuggerPause(a)) },
         { tool: t('debugger_resume'), domain: DOMAIN, bind: b((h, a) => h.handleDebuggerResume(a)) },
-        { tool: t('debugger_step_into'), domain: DOMAIN, bind: b((h, a) => h.handleDebuggerStepInto(a)) },
-        { tool: t('debugger_step_over'), domain: DOMAIN, bind: b((h, a) => h.handleDebuggerStepOver(a)) },
+        {
+            tool: t('debugger_step_into'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleDebuggerStepInto(a)),
+        },
+        {
+            tool: t('debugger_step_over'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleDebuggerStepOver(a)),
+        },
         { tool: t('debugger_step_out'), domain: DOMAIN, bind: b((h, a) => h.handleDebuggerStepOut(a)) },
         { tool: t('breakpoint_set'), domain: DOMAIN, bind: b((h, a) => h.handleBreakpointSet(a)) },
-        { tool: t('breakpoint_remove'), domain: DOMAIN, bind: b((h, a) => h.handleBreakpointRemove(a)) },
+        {
+            tool: t('breakpoint_remove'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleBreakpointRemove(a)),
+        },
         { tool: t('breakpoint_list'), domain: DOMAIN, bind: b((h, a) => h.handleBreakpointList(a)) },
         { tool: t('get_call_stack'), domain: DOMAIN, bind: b((h, a) => h.handleGetCallStack(a)) },
-        { tool: t('debugger_evaluate'), domain: DOMAIN, bind: b((h, a) => h.handleDebuggerEvaluate(a)) },
-        { tool: t('debugger_evaluate_global'), domain: DOMAIN, bind: b((h, a) => h.handleDebuggerEvaluateGlobal(a)) },
-        { tool: t('debugger_wait_for_paused'), domain: DOMAIN, bind: b((h, a) => h.handleDebuggerWaitForPaused(a)) },
-        { tool: t('debugger_get_paused_state'), domain: DOMAIN, bind: b((h, a) => h.handleDebuggerGetPausedState(a)) },
-        { tool: t('breakpoint_set_on_exception'), domain: DOMAIN, bind: b((h, a) => h.handleBreakpointSetOnException(a)) },
-        { tool: t('get_object_properties'), domain: DOMAIN, bind: b((h, a) => h.handleGetObjectProperties(a)) },
-        { tool: t('get_scope_variables_enhanced'), domain: DOMAIN, bind: b((h, a) => h.handleGetScopeVariablesEnhanced(a)) },
+        {
+            tool: t('debugger_evaluate'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleDebuggerEvaluate(a)),
+        },
+        {
+            tool: t('debugger_evaluate_global'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleDebuggerEvaluateGlobal(a)),
+        },
+        {
+            tool: t('debugger_wait_for_paused'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleDebuggerWaitForPaused(a)),
+        },
+        {
+            tool: t('debugger_get_paused_state'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleDebuggerGetPausedState(a)),
+        },
+        {
+            tool: t('breakpoint_set_on_exception'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleBreakpointSetOnException(a)),
+        },
+        {
+            tool: t('get_object_properties'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleGetObjectProperties(a)),
+        },
+        {
+            tool: t('get_scope_variables_enhanced'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleGetScopeVariablesEnhanced(a)),
+        },
         { tool: t('debugger_save_session'), domain: DOMAIN, bind: b((h, a) => h.handleSaveSession(a)) },
         { tool: t('debugger_load_session'), domain: DOMAIN, bind: b((h, a) => h.handleLoadSession(a)) },
-        { tool: t('debugger_export_session'), domain: DOMAIN, bind: b((h, a) => h.handleExportSession(a)) },
-        { tool: t('debugger_list_sessions'), domain: DOMAIN, bind: b((h, a) => h.handleListSessions(a)) },
+        {
+            tool: t('debugger_export_session'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleExportSession(a)),
+        },
+        {
+            tool: t('debugger_list_sessions'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleListSessions(a)),
+        },
         { tool: t('watch_add'), domain: DOMAIN, bind: b((h, a) => h.handleWatchAdd(a)) },
         { tool: t('watch_remove'), domain: DOMAIN, bind: b((h, a) => h.handleWatchRemove(a)) },
         { tool: t('watch_list'), domain: DOMAIN, bind: b((h, a) => h.handleWatchList(a)) },
-        { tool: t('watch_evaluate_all'), domain: DOMAIN, bind: b((h, a) => h.handleWatchEvaluateAll(a)) },
+        {
+            tool: t('watch_evaluate_all'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleWatchEvaluateAll(a)),
+        },
         { tool: t('watch_clear_all'), domain: DOMAIN, bind: b((h, a) => h.handleWatchClearAll(a)) },
-        { tool: t('xhr_breakpoint_set'), domain: DOMAIN, bind: b((h, a) => h.handleXHRBreakpointSet(a)) },
-        { tool: t('xhr_breakpoint_remove'), domain: DOMAIN, bind: b((h, a) => h.handleXHRBreakpointRemove(a)) },
-        { tool: t('xhr_breakpoint_list'), domain: DOMAIN, bind: b((h, a) => h.handleXHRBreakpointList(a)) },
-        { tool: t('event_breakpoint_set'), domain: DOMAIN, bind: b((h, a) => h.handleEventBreakpointSet(a)) },
-        { tool: t('event_breakpoint_set_category'), domain: DOMAIN, bind: b((h, a) => h.handleEventBreakpointSetCategory(a)) },
-        { tool: t('event_breakpoint_remove'), domain: DOMAIN, bind: b((h, a) => h.handleEventBreakpointRemove(a)) },
-        { tool: t('event_breakpoint_list'), domain: DOMAIN, bind: b((h, a) => h.handleEventBreakpointList(a)) },
+        {
+            tool: t('xhr_breakpoint_set'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleXHRBreakpointSet(a)),
+        },
+        {
+            tool: t('xhr_breakpoint_remove'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleXHRBreakpointRemove(a)),
+        },
+        {
+            tool: t('xhr_breakpoint_list'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleXHRBreakpointList(a)),
+        },
+        {
+            tool: t('event_breakpoint_set'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleEventBreakpointSet(a)),
+        },
+        {
+            tool: t('event_breakpoint_set_category'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleEventBreakpointSetCategory(a)),
+        },
+        {
+            tool: t('event_breakpoint_remove'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleEventBreakpointRemove(a)),
+        },
+        {
+            tool: t('event_breakpoint_list'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleEventBreakpointList(a)),
+        },
         { tool: t('blackbox_add'), domain: DOMAIN, bind: b((h, a) => h.handleBlackboxAdd(a)) },
-        { tool: t('blackbox_add_common'), domain: DOMAIN, bind: b((h, a) => h.handleBlackboxAddCommon(a)) },
+        {
+            tool: t('blackbox_add_common'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleBlackboxAddCommon(a)),
+        },
         { tool: t('blackbox_list'), domain: DOMAIN, bind: b((h, a) => h.handleBlackboxList(a)) },
     ],
 };

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

@@ -25,6 +25,12 @@ export const encodingTools = [
             },
             required: ['source'],
         },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     },
     {
         name: 'binary_decode',
@@ -50,6 +56,12 @@ export const encodingTools = [
             },
             required: ['data', 'encoding'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'binary_encode',
@@ -74,6 +86,12 @@ export const encodingTools = [
             },
             required: ['data', 'inputFormat', 'outputEncoding'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'binary_entropy_analysis',
@@ -102,6 +120,12 @@ export const encodingTools = [
             },
             required: ['source'],
         },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     },
     {
         name: 'protobuf_decode_raw',
@@ -121,5 +145,11 @@ export const encodingTools = [
             },
             required: ['data'],
         },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     },
 ];

package/dist/src/server/domains/encoding/handlers.base.js

@@ -166,12 +166,11 @@ export class EncodingHandlersBase {
             encoding,
             outputFormat,
             byteLength: buffer.length,
-            result: jsonValue ??
-                {
-                    parsedJson: maybeJson,
-                    utf8,
-                    hex: buffer.toString('hex'),
-                },
+            result: jsonValue ?? {
+                parsedJson: maybeJson,
+                utf8,
+                hex: buffer.toString('hex'),
+            },
         });
     }
     ok(payload) {
@@ -342,8 +341,7 @@ export class EncodingHandlersBase {
             (firstByte >= 0xa0 && firstByte <= 0xbf)) {
             formats.add('messagepack');
         }
-        if ((firstByte >= 0xa0 && firstByte <= 0xbf) ||
-            (firstByte >= 0x80 && firstByte <= 0x9f)) {
+        if ((firstByte >= 0xa0 && firstByte <= 0xbf) || (firstByte >= 0x80 && firstByte <= 0x9f)) {
             formats.add('cbor');
         }
         return Array.from(formats);
@@ -451,10 +449,7 @@ export class EncodingHandlersBase {
         }
         let printable = 0;
         for (const value of buffer.values()) {
-            if ((value >= 0x20 && value <= 0x7e) ||
-                value === 0x09 ||
-                value === 0x0a ||
-                value === 0x0d) {
+            if ((value >= 0x20 && value <= 0x7e) || value === 0x09 || value === 0x0a || value === 0x0d) {
                 printable += 1;
             }
         }

package/dist/src/server/domains/encoding/handlers.impl.core.runtime.shared.js

@@ -6,8 +6,18 @@ export const MAGIC_SIGNATURES = [
     { format: 'zip/apk', bytes: [0x50, 0x4b, 0x03, 0x04] },
     { format: 'pdf', bytes: [0x25, 0x50, 0x44, 0x46] },
 ];
-export const DETECT_SOURCE_SET = new Set(['base64', 'hex', 'file', 'raw']);
-export const ENTROPY_SOURCE_SET = new Set(['base64', 'hex', 'raw', 'file']);
+export const DETECT_SOURCE_SET = new Set([
+    'base64',
+    'hex',
+    'file',
+    'raw',
+]);
+export const ENTROPY_SOURCE_SET = new Set([
+    'base64',
+    'hex',
+    'raw',
+    'file',
+]);
 export const DECODE_ENCODING_SET = new Set([
     'base64',
     'hex',

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

@@ -16,16 +16,30 @@ function ensure(ctx) {
     return ctx.encodingHandlers;
 }
 const manifest = {
-    kind: 'domain-manifest', version: 1,
-    domain: DOMAIN, depKey: DEP_KEY,
+    kind: 'domain-manifest',
+    version: 1,
+    domain: DOMAIN,
+    depKey: DEP_KEY,
     profiles: ['workflow', 'full'],
     ensure,
     registrations: [
-        { tool: t('binary_detect_format'), domain: DOMAIN, bind: b((h, a) => h.handleBinaryDetectFormat(a)) },
+        {
+            tool: t('binary_detect_format'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleBinaryDetectFormat(a)),
+        },
         { tool: t('binary_decode'), domain: DOMAIN, bind: b((h, a) => h.handleBinaryDecode(a)) },
         { tool: t('binary_encode'), domain: DOMAIN, bind: b((h, a) => h.handleBinaryEncode(a)) },
-        { tool: t('binary_entropy_analysis'), domain: DOMAIN, bind: b((h, a) => h.handleBinaryEntropyAnalysis(a)) },
-        { tool: t('protobuf_decode_raw'), domain: DOMAIN, bind: b((h, a) => h.handleProtobufDecodeRaw(a)) },
+        {
+            tool: t('binary_entropy_analysis'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleBinaryEntropyAnalysis(a)),
+        },
+        {
+            tool: t('protobuf_decode_raw'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleProtobufDecodeRaw(a)),
+        },
     ],
 };
 export default manifest;

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

@@ -16,6 +16,12 @@ export const graphqlTools = [
                 },
             },
         },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     },
     {
         name: 'script_replace_persist',
@@ -40,6 +46,12 @@ export const graphqlTools = [
             },
             required: ['url', 'replacement'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
     },
     {
         name: 'graphql_introspect',
@@ -61,6 +73,12 @@ export const graphqlTools = [
             },
             required: ['endpoint'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
     },
     {
         name: 'graphql_extract_queries',
@@ -75,6 +93,12 @@ export const graphqlTools = [
                 },
             },
         },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     },
     {
         name: 'graphql_replay',
@@ -109,5 +133,11 @@ export const graphqlTools = [
             },
             required: ['endpoint', 'query'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
     },
 ];

package/dist/src/server/domains/graphql/handlers.impl.core.runtime.callgraph.d.ts

@@ -1 +1 @@
-export { GraphQLToolHandlersRuntime as GraphQLToolHandlersCallGraph, } from '../../domains/graphql/handlers.impl.core.runtime.replay.js';
+export { GraphQLToolHandlersRuntime as GraphQLToolHandlersCallGraph } from '../../domains/graphql/handlers.impl.core.runtime.replay.js';

package/dist/src/server/domains/graphql/handlers.impl.core.runtime.callgraph.js

@@ -1 +1 @@
-export { GraphQLToolHandlersRuntime as GraphQLToolHandlersCallGraph, } from '../../domains/graphql/handlers.impl.core.runtime.replay.js';
+export { GraphQLToolHandlersRuntime as GraphQLToolHandlersCallGraph } from '../../domains/graphql/handlers.impl.core.runtime.replay.js';

package/dist/src/server/domains/graphql/handlers.impl.core.runtime.extract.d.ts

@@ -1 +1 @@
-export { GraphQLToolHandlersRuntime as GraphQLToolHandlersExtract, } from '../../domains/graphql/handlers.impl.core.runtime.replay.js';
+export { GraphQLToolHandlersRuntime as GraphQLToolHandlersExtract } from '../../domains/graphql/handlers.impl.core.runtime.replay.js';

package/dist/src/server/domains/graphql/handlers.impl.core.runtime.extract.js

@@ -1 +1 @@
-export { GraphQLToolHandlersRuntime as GraphQLToolHandlersExtract, } from '../../domains/graphql/handlers.impl.core.runtime.replay.js';
+export { GraphQLToolHandlersRuntime as GraphQLToolHandlersExtract } from '../../domains/graphql/handlers.impl.core.runtime.replay.js';

package/dist/src/server/domains/graphql/handlers.impl.core.runtime.introspection.d.ts

@@ -1 +1 @@
-export { GraphQLToolHandlersRuntime as GraphQLToolHandlersIntrospection, } from '../../domains/graphql/handlers.impl.core.runtime.replay.js';
+export { GraphQLToolHandlersRuntime as GraphQLToolHandlersIntrospection } from '../../domains/graphql/handlers.impl.core.runtime.replay.js';

package/dist/src/server/domains/graphql/handlers.impl.core.runtime.introspection.js

@@ -1 +1 @@
-export { GraphQLToolHandlersRuntime as GraphQLToolHandlersIntrospection, } from '../../domains/graphql/handlers.impl.core.runtime.replay.js';
+export { GraphQLToolHandlersRuntime as GraphQLToolHandlersIntrospection } from '../../domains/graphql/handlers.impl.core.runtime.replay.js';