@jshookmcp/jshook 0.1.2

package/dist/server/domains/wasm/definitions.js

@@ -0,0 +1,187 @@
+export const wasmTools = [
+    {
+        name: 'wasm_dump',
+        description: 'Dump a WebAssembly module from the current browser page.\n\nExtracts the WASM binary via the webassembly-full hook preset, saves it to disk, and returns module metadata (hash, size, imports, exports).\n\nPrerequisites: A page with WASM must be loaded. The webassembly-full hook preset will be auto-injected if not already active.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                moduleIndex: {
+                    type: 'number',
+                    description: 'Index of the WASM module to dump if multiple were loaded (default: 0 = first)',
+                    default: 0,
+                },
+                outputPath: {
+                    type: 'string',
+                    description: 'Custom output file path. If omitted, auto-generates in artifacts/wasm/',
+                },
+            },
+        },
+    },
+    {
+        name: 'wasm_disassemble',
+        description: 'Disassemble a .wasm file to WebAssembly Text Format (WAT) using wasm2wat.\n\nRequires: wabt toolchain installed (wasm2wat in PATH).\n\nUSE THIS to read WASM bytecode as human-readable text. The output shows all functions, imports, exports, and instructions.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                inputPath: {
+                    type: 'string',
+                    description: 'Path to the .wasm file to disassemble',
+                },
+                outputPath: {
+                    type: 'string',
+                    description: 'Output .wat file path. If omitted, auto-generates in artifacts/wasm/',
+                },
+                foldExprs: {
+                    type: 'boolean',
+                    description: 'Fold expressions for more compact output (default: true)',
+                    default: true,
+                },
+            },
+            required: ['inputPath'],
+        },
+    },
+    {
+        name: 'wasm_decompile',
+        description: 'Decompile a .wasm file to C-like pseudo-code using wasm-decompile.\n\nRequires: wabt toolchain installed (wasm-decompile in PATH).\n\nProduces more readable output than WAT, resembling C/JavaScript syntax. Useful for understanding VMP handler logic.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                inputPath: {
+                    type: 'string',
+                    description: 'Path to the .wasm file to decompile',
+                },
+                outputPath: {
+                    type: 'string',
+                    description: 'Output file path. If omitted, auto-generates in artifacts/wasm/',
+                },
+            },
+            required: ['inputPath'],
+        },
+    },
+    {
+        name: 'wasm_inspect_sections',
+        description: 'Inspect sections and metadata of a .wasm file using wasm-objdump.\n\nRequires: wabt toolchain installed (wasm-objdump in PATH).\n\nReturns section headers, import/export tables, function signatures, and memory layout.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                inputPath: {
+                    type: 'string',
+                    description: 'Path to the .wasm file to inspect',
+                },
+                sections: {
+                    type: 'string',
+                    enum: ['headers', 'details', 'disassemble', 'all'],
+                    description: 'What to dump: headers (section overview), details (full metadata), disassemble (bytecode), all. Default: details',
+                    default: 'details',
+                },
+            },
+            required: ['inputPath'],
+        },
+    },
+    {
+        name: 'wasm_offline_run',
+        description: 'Execute a specific exported function from a .wasm file offline using wasmtime or wasmer.\n\nRequires: wasmtime or wasmer installed in PATH.\n\nUSE THIS to run sign/encrypt functions extracted from WASM VMP without a browser. Provide the function name and arguments.\n\nSecurity: Runs in a sandboxed WASM runtime with no filesystem or network access.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                inputPath: {
+                    type: 'string',
+                    description: 'Path to the .wasm file',
+                },
+                functionName: {
+                    type: 'string',
+                    description: 'Name of the exported function to invoke (e.g., "_sign", "encrypt")',
+                },
+                args: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Arguments to pass to the function (will be parsed as integers/floats)',
+                },
+                runtime: {
+                    type: 'string',
+                    enum: ['wasmtime', 'wasmer', 'auto'],
+                    description: 'WASM runtime to use. "auto" tries wasmtime first, then wasmer. Default: auto',
+                    default: 'auto',
+                },
+                timeoutMs: {
+                    type: 'number',
+                    description: 'Execution timeout in ms (default: 10000)',
+                    default: 10000,
+                },
+            },
+            required: ['inputPath', 'functionName'],
+        },
+    },
+    {
+        name: 'wasm_optimize',
+        description: 'Optimize a .wasm file using binaryen wasm-opt.\n\nRequires: binaryen toolchain installed (wasm-opt in PATH).\n\nApplies optimization passes (dead code elimination, constant folding, etc.) to reduce size and improve performance. Optimized output can be re-injected into the browser.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                inputPath: {
+                    type: 'string',
+                    description: 'Path to the .wasm file to optimize',
+                },
+                outputPath: {
+                    type: 'string',
+                    description: 'Output optimized .wasm file path. If omitted, auto-generates in artifacts/wasm/',
+                },
+                level: {
+                    type: 'string',
+                    enum: ['O1', 'O2', 'O3', 'O4', 'Os', 'Oz'],
+                    description: 'Optimization level (default: O2)',
+                    default: 'O2',
+                },
+            },
+            required: ['inputPath'],
+        },
+    },
+    {
+        name: 'wasm_vmp_trace',
+        description: 'Trace WASM VMP (Virtual Machine Protection) opcode execution.\n\nCombines the webassembly-full hook preset with enhanced import call tracing to reconstruct VMP handler tables and execution flows.\n\nUSE THIS when a page uses WASM-based VMP to protect sign/encrypt functions. Returns:\n- Import call sequence (opcode trace)\n- Identified handler patterns\n- Input→output data flow',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                maxEvents: {
+                    type: 'number',
+                    description: 'Maximum import call events to capture (default: 5000)',
+                    default: 5000,
+                },
+                filterModule: {
+                    type: 'string',
+                    description: 'Only trace calls to this import module name (e.g., "env", "wasi_snapshot_preview1")',
+                },
+            },
+        },
+    },
+    {
+        name: 'wasm_memory_inspect',
+        description: 'Inspect WebAssembly.Memory contents from the browser.\n\nReads the linear memory buffer of the active WASM module, displaying it as hex dump, ASCII, or searching for patterns.\n\nUSE THIS to:\n- Examine WASM memory layout (stack, heap, data segments)\n- Find strings, keys, or encoded data in WASM memory\n- Track how input data is transformed through WASM functions',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                offset: {
+                    type: 'number',
+                    description: 'Starting byte offset to read from (default: 0)',
+                    default: 0,
+                },
+                length: {
+                    type: 'number',
+                    description: 'Number of bytes to read (default: 256, max: 65536)',
+                    default: 256,
+                },
+                format: {
+                    type: 'string',
+                    enum: ['hex', 'ascii', 'both'],
+                    description: 'Output format (default: both)',
+                    default: 'both',
+                },
+                searchPattern: {
+                    type: 'string',
+                    description: 'Search for this hex pattern or ASCII string in the memory range',
+                },
+            },
+        },
+    },
+];
+//# sourceMappingURL=definitions.js.map

package/dist/server/domains/wasm/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../../../src/server/domains/wasm/definitions.ts"],"names":[],"mappings":"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"}

package/dist/server/domains/wasm/handlers.d.ts

@@ -0,0 +1,57 @@
+import type { CodeCollector } from '../../domains/shared/modules.js';
+export declare class WasmToolHandlers {
+    private runner;
+    private registry;
+    private collector;
+    constructor(collector: CodeCollector);
+    private validateOutputPath;
+    handleWasmDump(args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handleWasmDisassemble(args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handleWasmDecompile(args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handleWasmInspectSections(args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handleWasmOfflineRun(args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handleWasmOptimize(args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handleWasmVmpTrace(args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+    handleWasmMemoryInspect(args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+}
+//# sourceMappingURL=handlers.d.ts.map

package/dist/server/domains/wasm/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../../src/server/domains/wasm/handlers.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AA4DpE,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,SAAS,CAAgB;gBAErB,SAAS,EAAE,aAAa;IAOpC,OAAO,CAAC,kBAAkB;IAYpB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IA6F5C,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IAyDnD,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IAkDjD,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IA0CvD,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IA4DlD,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IAuDhD,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IAkEhD,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;CAwH5D"}