@jshookmcp/jshook 0.2.1 → 0.2.2

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

@@ -5,7 +5,7 @@ import { tmpdir } from 'node:os';
 import { resolveArtifactPath } from '../../../utils/artifacts.js';
 import { ExternalToolRunner } from '../../domains/shared/modules.js';
 import { ToolRegistry } from '../../domains/shared/modules.js';
-import { argNumber, argString, argStringRequired, argBool, argStringArray } from '../../domains/shared/parse-args.js';
+import { argNumber, argString, argStringRequired, argBool, argStringArray, } from '../../domains/shared/parse-args.js';
 const isRecord = (value) => typeof value === 'object' && value !== null;
 const hasErrorResult = (value) => isRecord(value) && typeof value.error === 'string';
 export class WasmToolHandlers {
@@ -34,12 +34,16 @@ export class WasmToolHandlers {
             const win = window;
             const hooksRaw = win.__aiHooks?.['preset-webassembly-full'];
             if (!Array.isArray(hooksRaw) || hooksRaw.length === 0) {
-                return { error: 'No WASM modules captured. Ensure the webassembly-full hook preset is active and the page has loaded WASM.' };
+                return {
+                    error: 'No WASM modules captured. Ensure the webassembly-full hook preset is active and the page has loaded WASM.',
+                };
             }
             const hooks = hooksRaw;
             const instantiatedEvents = hooks.filter((e) => e.type === 'instantiated');
             if (idx >= instantiatedEvents.length) {
-                return { error: `Module index ${idx} out of range. Found ${instantiatedEvents.length} instantiated modules.` };
+                return {
+                    error: `Module index ${idx} out of range. Found ${instantiatedEvents.length} instantiated modules.`,
+                };
             }
             const event = instantiatedEvents[idx];
             return {
@@ -88,7 +92,8 @@ export class WasmToolHandlers {
             savedPath = '(binary not available — hook did not store raw bytes)';
         }
         return {
-            content: [{
+            content: [
+                {
                     type: 'text',
                     text: JSON.stringify({
                         success: true,
@@ -102,7 +107,8 @@ export class WasmToolHandlers {
                             ? 'Use wasm_disassemble or wasm_decompile on the dumped file for further analysis.'
                             : 'Binary not captured. Inject hook_preset("webassembly-full") BEFORE page navigation, with window.__wasmModuleStorage patching.',
                     }, null, 2),
-                }],
+                },
+            ],
         };
     }
     async handleWasmDisassemble(args) {
@@ -119,7 +125,16 @@ export class WasmToolHandlers {
         });
         if (!result.ok) {
             return {
-                content: [{ type: 'text', text: JSON.stringify({ success: false, error: result.stderr, exitCode: result.exitCode }) }],
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: result.stderr,
+                            exitCode: result.exitCode,
+                        }),
+                    },
+                ],
             };
         }
         let savedPath;
@@ -140,7 +155,8 @@ export class WasmToolHandlers {
         const lines = result.stdout.split('\n');
         const preview = lines.slice(0, 50).join('\n');
         return {
-            content: [{
+            content: [
+                {
                     type: 'text',
                     text: JSON.stringify({
                         success: true,
@@ -150,7 +166,8 @@ export class WasmToolHandlers {
                         preview: preview + (lines.length > 50 ? '\n... (truncated)' : ''),
                         durationMs: result.durationMs,
                     }, null, 2),
-                }],
+                },
+            ],
         };
     }
     async handleWasmDecompile(args) {
@@ -163,7 +180,16 @@ export class WasmToolHandlers {
         });
         if (!result.ok) {
             return {
-                content: [{ type: 'text', text: JSON.stringify({ success: false, error: result.stderr, exitCode: result.exitCode }) }],
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: result.stderr,
+                            exitCode: result.exitCode,
+                        }),
+                    },
+                ],
             };
         }
         let savedPath;
@@ -184,7 +210,8 @@ export class WasmToolHandlers {
         const lines = result.stdout.split('\n');
         const preview = lines.slice(0, 60).join('\n');
         return {
-            content: [{
+            content: [
+                {
                     type: 'text',
                     text: JSON.stringify({
                         success: true,
@@ -193,7 +220,8 @@ export class WasmToolHandlers {
                         preview: preview + (lines.length > 60 ? '\n... (truncated)' : ''),
                         durationMs: result.durationMs,
                     }, null, 2),
-                }],
+                },
+            ],
         };
     }
     async handleWasmInspectSections(args) {
@@ -213,13 +241,23 @@ export class WasmToolHandlers {
         });
         if (!result.ok) {
             return {
-                content: [{ type: 'text', text: JSON.stringify({ success: false, error: result.stderr, exitCode: result.exitCode }) }],
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: result.stderr,
+                            exitCode: result.exitCode,
+                        }),
+                    },
+                ],
             };
         }
         const lines = result.stdout.split('\n');
         const preview = lines.slice(0, 100).join('\n');
         return {
-            content: [{
+            content: [
+                {
                     type: 'text',
                     text: JSON.stringify({
                         success: true,
@@ -227,7 +265,8 @@ export class WasmToolHandlers {
                         preview: preview + (lines.length > 100 ? '\n... (truncated)' : ''),
                         durationMs: result.durationMs,
                     }, null, 2),
-                }],
+                },
+            ],
         };
     }
     async handleWasmOfflineRun(args) {
@@ -247,13 +286,15 @@ export class WasmToolHandlers {
             }
             else {
                 return {
-                    content: [{
+                    content: [
+                        {
                             type: 'text',
                             text: JSON.stringify({
                                 success: false,
                                 error: 'No WASM runtime found. Install wasmtime or wasmer.',
                             }),
-                        }],
+                        },
+                    ],
                 };
             }
         }
@@ -269,7 +310,8 @@ export class WasmToolHandlers {
             timeoutMs,
         });
         return {
-            content: [{
+            content: [
+                {
                     type: 'text',
                     text: JSON.stringify({
                         success: result.ok,
@@ -281,7 +323,8 @@ export class WasmToolHandlers {
                         exitCode: result.exitCode,
                         durationMs: result.durationMs,
                     }, null, 2),
-                }],
+                },
+            ],
         };
     }
     async handleWasmOptimize(args) {
@@ -307,7 +350,16 @@ export class WasmToolHandlers {
         });
         if (!result.ok) {
             return {
-                content: [{ type: 'text', text: JSON.stringify({ success: false, error: result.stderr, exitCode: result.exitCode }) }],
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: result.stderr,
+                            exitCode: result.exitCode,
+                        }),
+                    },
+                ],
             };
         }
         let inputSize = 0;
@@ -316,9 +368,11 @@ export class WasmToolHandlers {
             inputSize = (await stat(inputPath)).size;
             outputSize = (await stat(destPath)).size;
         }
-        catch { }
+        catch {
+        }
         return {
-            content: [{
+            content: [
+                {
                     type: 'text',
                     text: JSON.stringify({
                         success: true,
@@ -329,7 +383,8 @@ export class WasmToolHandlers {
                         reductionPercent: inputSize > 0 ? ((1 - outputSize / inputSize) * 100).toFixed(1) : '0',
                         durationMs: result.durationMs,
                     }, null, 2),
-                }],
+                },
+            ],
         };
     }
     async handleWasmVmpTrace(args) {
@@ -340,7 +395,9 @@ export class WasmToolHandlers {
             const win = window;
             const hooksRaw = win.__aiHooks?.['preset-webassembly-full'];
             if (!Array.isArray(hooksRaw) || hooksRaw.length === 0) {
-                return { error: 'No WASM hook data. Inject hook_preset("webassembly-full") and reload the page.' };
+                return {
+                    error: 'No WASM hook data. Inject hook_preset("webassembly-full") and reload the page.',
+                };
             }
             const hooks = hooksRaw;
             let importCalls = hooks.filter((e) => e.type === 'import_call');
@@ -371,18 +428,22 @@ export class WasmToolHandlers {
         }, { maxEvents, filterModule });
         if (hasErrorResult(traceData)) {
             return {
-                content: [{ type: 'text', text: JSON.stringify({ success: false, error: traceData.error }) }],
+                content: [
+                    { type: 'text', text: JSON.stringify({ success: false, error: traceData.error }) },
+                ],
             };
         }
         return {
-            content: [{
+            content: [
+                {
                     type: 'text',
                     text: JSON.stringify({
                         success: true,
                         ...traceData,
                         hint: 'Top functions show VMP handler dispatch patterns. Use wasm_disassemble to analyze their implementation.',
                     }, null, 2),
-                }],
+                },
+            ],
         };
     }
     async handleWasmMemoryInspect(args) {
@@ -398,7 +459,9 @@ export class WasmToolHandlers {
             const memoryEvents = hooks.filter((e) => e.type === 'memory_created');
             const instances = win.__wasmInstances;
             if (!Array.isArray(instances) || instances.length === 0) {
-                return { error: 'No WASM memory available. Ensure the webassembly-full hook is active and a WASM module is instantiated.' };
+                return {
+                    error: 'No WASM memory available. Ensure the webassembly-full hook is active and a WASM module is instantiated.',
+                };
             }
             try {
                 const firstInstance = instances[0];
@@ -414,8 +477,12 @@ export class WasmToolHandlers {
                     const pattern = opts.searchPattern;
                     const isHex = /^[0-9a-fA-F\s]+$/.test(pattern);
                     if (isHex) {
-                        const hexBytes = pattern.replace(/\s/g, '').match(/.{2}/g)?.map((h) => parseInt(h, 16)) || [];
-                        for (let i = opts.offset; i <= Math.min(opts.offset + opts.length - hexBytes.length, buffer.length - hexBytes.length); i++) {
+                        const hexBytes = pattern
+                            .replace(/\s/g, '')
+                            .match(/.{2}/g)
+                            ?.map((h) => parseInt(h, 16)) || [];
+                        for (let i = opts.offset; i <=
+                            Math.min(opts.offset + opts.length - hexBytes.length, buffer.length - hexBytes.length); i++) {
                             let match = true;
                             for (let j = 0; j < hexBytes.length; j++) {
                                 if (buffer[i + j] !== hexBytes[j]) {
@@ -430,7 +497,8 @@ export class WasmToolHandlers {
                     else {
                         const encoder = new TextEncoder();
                         const patternBytes = encoder.encode(pattern);
-                        for (let i = opts.offset; i <= Math.min(opts.offset + opts.length - patternBytes.length, buffer.length - patternBytes.length); i++) {
+                        for (let i = opts.offset; i <=
+                            Math.min(opts.offset + opts.length - patternBytes.length, buffer.length - patternBytes.length); i++) {
                             let match = true;
                             for (let j = 0; j < patternBytes.length; j++) {
                                 if (buffer[i + j] !== patternBytes[j]) {
@@ -471,15 +539,20 @@ export class WasmToolHandlers {
                 const row = data.slice(i, i + 16);
                 const addr = (offset + i).toString(16).padStart(8, '0');
                 const hex = row.map((b) => b.toString(16).padStart(2, '0')).join(' ');
-                const ascii = row.map((b) => (b >= 0x20 && b < 0x7f) ? String.fromCharCode(b) : '.').join('');
+                const ascii = row
+                    .map((b) => (b >= 0x20 && b < 0x7f ? String.fromCharCode(b) : '.'))
+                    .join('');
                 hexDump += `${addr}  ${hex.padEnd(48)}  |${ascii}|\n`;
             }
         }
         if (format === 'ascii') {
-            asciiDump = data.map((b) => (b >= 0x20 && b < 0x7f) ? String.fromCharCode(b) : '.').join('');
+            asciiDump = data
+                .map((b) => (b >= 0x20 && b < 0x7f ? String.fromCharCode(b) : '.'))
+                .join('');
         }
         return {
-            content: [{
+            content: [
+                {
                     type: 'text',
                     text: JSON.stringify({
                         success: true,
@@ -491,7 +564,8 @@ export class WasmToolHandlers {
                         asciiDump: format === 'ascii' ? asciiDump : undefined,
                         searchResults: memData.searchResults,
                     }, null, 2),
-                }],
+                },
+            ],
         };
     }
 }

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

@@ -16,19 +16,29 @@ function ensure(ctx) {
     return ctx.wasmHandlers;
 }
 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('wasm_dump'), domain: DOMAIN, bind: b((h, a) => h.handleWasmDump(a)) },
         { tool: t('wasm_disassemble'), domain: DOMAIN, bind: b((h, a) => h.handleWasmDisassemble(a)) },
         { tool: t('wasm_decompile'), domain: DOMAIN, bind: b((h, a) => h.handleWasmDecompile(a)) },
-        { tool: t('wasm_inspect_sections'), domain: DOMAIN, bind: b((h, a) => h.handleWasmInspectSections(a)) },
+        {
+            tool: t('wasm_inspect_sections'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleWasmInspectSections(a)),
+        },
         { tool: t('wasm_offline_run'), domain: DOMAIN, bind: b((h, a) => h.handleWasmOfflineRun(a)) },
         { tool: t('wasm_optimize'), domain: DOMAIN, bind: b((h, a) => h.handleWasmOptimize(a)) },
         { tool: t('wasm_vmp_trace'), domain: DOMAIN, bind: b((h, a) => h.handleWasmVmpTrace(a)) },
-        { tool: t('wasm_memory_inspect'), domain: DOMAIN, bind: b((h, a) => h.handleWasmMemoryInspect(a)) },
+        {
+            tool: t('wasm_memory_inspect'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleWasmMemoryInspect(a)),
+        },
     ],
 };
 export default manifest;

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

@@ -56,6 +56,12 @@ export const workflowToolDefinitions = [
             },
             required: ['url'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
     },
     {
         name: 'js_bundle_search',
@@ -75,8 +81,14 @@ export const workflowToolDefinitions = [
                         properties: {
                             name: { type: 'string', description: 'Human-readable label for this pattern' },
                             regex: { type: 'string', description: 'JavaScript regex string' },
-                            contextBefore: { type: 'number', description: 'Characters of context before match (default: 80)' },
-                            contextAfter: { type: 'number', description: 'Characters of context after match (default: 80)' },
+                            contextBefore: {
+                                type: 'number',
+                                description: 'Characters of context before match (default: 80)',
+                            },
+                            contextAfter: {
+                                type: 'number',
+                                description: 'Characters of context after match (default: 80)',
+                            },
                         },
                         required: ['name', 'regex'],
                     },
@@ -99,6 +111,12 @@ export const workflowToolDefinitions = [
             },
             required: ['url', 'patterns'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
     },
     {
         name: 'page_script_register',
@@ -121,6 +139,12 @@ export const workflowToolDefinitions = [
             },
             required: ['name', 'code'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'page_script_run',
@@ -140,6 +164,12 @@ export const workflowToolDefinitions = [
             },
             required: ['name'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
     },
     {
         name: 'api_probe_batch',
@@ -189,6 +219,12 @@ export const workflowToolDefinitions = [
             },
             required: ['baseUrl', 'paths'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
     },
     {
         name: 'register_account_flow',
@@ -235,6 +271,12 @@ export const workflowToolDefinitions = [
             },
             required: ['registerUrl', 'fields'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
     },
     {
         name: 'batch_register',
@@ -311,6 +353,12 @@ export const workflowToolDefinitions = [
             },
             required: ['registerUrl', 'accounts'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
     },
     {
         name: 'list_extension_workflows',
@@ -320,6 +368,12 @@ export const workflowToolDefinitions = [
             properties: {},
             additionalProperties: false,
         },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     },
     {
         name: 'run_extension_workflow',
@@ -355,5 +409,11 @@ export const workflowToolDefinitions = [
             },
             required: ['workflowId'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
     },
 ];