@jshookmcp/jshook 0.2.9 → 0.3.0

package/dist/{debugger-gnKxRSN0.mjs → debugger-RS3RSAqs.mjs}

@@ -1,7 +1,7 @@
 import { t as logger } from "./logger-Dh_xb7_2.mjs";
 import { t as ToolError } from "./ToolError-jh9whhMd.mjs";
-import { a as argString, i as argObject, r as argNumber, t as argBool } from "./parse-args-BlRjqlkL.mjs";
-import "./definitions-DVGfrn7y.mjs";
+import { a as argString, i as argObject, r as argNumber, t as argBool } from "./parse-args-B4cY5Vx5.mjs";
+import "./definitions-BbkvZkiv.mjs";
 //#region src/server/domains/debugger/handlers/debugger-control.ts
 var DebuggerControlHandlers = class {
 	constructor(deps) {
@@ -34,21 +34,38 @@ var DebuggerControlHandlers = class {
 	}
 	async handleDebuggerPause(_args) {
 		await this.deps.debuggerManager.pause();
-		return { content: [{
-			type: "text",
-			text: JSON.stringify({
-				success: true,
-				message: "Execution paused"
-			}, null, 2)
-		}] };
+		try {
+			const pausedState = await this.deps.debuggerManager.waitForPaused(500);
+			return { content: [{
+				type: "text",
+				text: JSON.stringify({
+					success: true,
+					paused: true,
+					message: "Execution paused",
+					reason: pausedState.reason,
+					location: pausedState.callFrames[0]?.location
+				}, null, 2)
+			}] };
+		} catch {
+			return { content: [{
+				type: "text",
+				text: JSON.stringify({
+					success: true,
+					paused: false,
+					message: "Pause requested; no paused event observed yet"
+				}, null, 2)
+			}] };
+		}
 	}
 	async handleDebuggerResume(_args) {
+		const wasPaused = this.deps.debuggerManager.getPausedState() !== null;
 		await this.deps.debuggerManager.resume();
 		return { content: [{
 			type: "text",
 			text: JSON.stringify({
 				success: true,
-				message: "Execution resumed"
+				resumed: wasPaused,
+				message: wasPaused ? "Execution resumed" : "Resume requested; debugger was not paused"
 			}, null, 2)
 		}] };
 	}
@@ -74,7 +91,7 @@ var DebuggerSteppingHandlers = class {
 			text: JSON.stringify({
 				success: false,
 				error: "Cannot step while not paused",
-				hint: "The debugger must be paused at a breakpoint to perform step operations. Set a breakpoint with breakpoint_set() or pause with debugger_pause().",
+				hint: "The debugger must be paused at a breakpoint to perform step operations. Set one with breakpoint({ action: 'set', type: 'code', ... }) or pause with debugger_pause().",
 				currentState: "running"
 			}, null, 2)
 		}] };
@@ -114,7 +131,7 @@ var DebuggerSteppingHandlers = class {
 			text: JSON.stringify({
 				success: false,
 				error: "Cannot step while not paused",
-				hint: "The debugger must be paused at a breakpoint to perform step operations. Set a breakpoint with breakpoint_set() or pause with debugger_pause().",
+				hint: "The debugger must be paused at a breakpoint to perform step operations. Set one with breakpoint({ action: 'set', type: 'code', ... }) or pause with debugger_pause().",
 				currentState: "running"
 			}, null, 2)
 		}] };
@@ -154,7 +171,7 @@ var DebuggerSteppingHandlers = class {
 			text: JSON.stringify({
 				success: false,
 				error: "Cannot step out while not paused",
-				hint: "The debugger must be paused at a breakpoint to perform step out. Set a breakpoint with breakpoint_set() or pause with debugger_pause().",
+				hint: "The debugger must be paused at a breakpoint to perform step out. Set one with breakpoint({ action: 'set', type: 'code', ... }) or pause with debugger_pause().",
 				currentState: "running"
 			}, null, 2)
 		}] };

package/dist/definitions-BEoYofW5.mjs

@@ -0,0 +1,47 @@
+import { t as tool } from "./tool-builder-BHJp32mV.mjs";
+//#region src/server/domains/wasm/definitions.ts
+const wasmTools = [
+	tool("wasm_capabilities", (t) => t.desc("Report WASM tool availability.").query()),
+	tool("wasm_dump", (t) => t.desc("Dump a captured WebAssembly module from the current page.").number("moduleIndex", "Index of the WASM module to dump if multiple were loaded", { default: 0 }).string("outputPath", "Custom output file path. If omitted, auto-generates in artifacts/wasm/")),
+	tool("wasm_disassemble", (t) => t.desc("Disassemble a .wasm file to WAT.").string("inputPath", "Path to the .wasm file to disassemble").string("outputPath", "Output .wat file path. If omitted, auto-generates in artifacts/wasm/").boolean("foldExprs", "Fold expressions for more compact output", { default: true }).required("inputPath")),
+	tool("wasm_decompile", (t) => t.desc("Decompile a .wasm file to pseudo-code.").string("inputPath", "Path to the .wasm file to decompile").string("outputPath", "Output file path. If omitted, auto-generates in artifacts/wasm/").required("inputPath")),
+	tool("wasm_inspect_sections", (t) => t.desc("Inspect sections and metadata of a .wasm file.").string("inputPath", "Path to the .wasm file to inspect").enum("sections", [
+		"headers",
+		"details",
+		"disassemble",
+		"all"
+	], "What to dump: headers (section overview), details (full metadata), disassemble (bytecode), all", { default: "details" }).required("inputPath")),
+	tool("wasm_offline_run", (t) => t.desc("Run an exported .wasm function.").string("inputPath", "Path to the .wasm file").string("functionName", "Name of the exported function to invoke").array("args", { type: "string" }, "Arguments to pass to the function (will be parsed as integers/floats)").enum("runtime", [
+		"wasmtime",
+		"wasmer",
+		"auto"
+	], "WASM runtime to use. \"auto\" tries wasmtime first, then wasmer", { default: "auto" }).number("timeoutMs", "Execution timeout in ms", { default: 1e4 }).required("inputPath", "functionName")),
+	tool("wasm_optimize", (t) => t.desc("Optimize a .wasm file.").string("inputPath", "Path to the .wasm file to optimize").string("outputPath", "Output optimized .wasm file path. If omitted, auto-generates in artifacts/wasm/").enum("level", [
+		"O1",
+		"O2",
+		"O3",
+		"O4",
+		"Os",
+		"Oz"
+	], "Optimization level", { default: "O2" }).required("inputPath")),
+	tool("wasm_vmp_trace", (t) => t.desc("Read captured WASM VMP import-call traces from the current page.").number("maxEvents", "Maximum import call events to capture", { default: 5e3 }).string("filterModule", "Filter by import module name")),
+	tool("wasm_memory_inspect", (t) => t.desc("Inspect exported WebAssembly.Memory from the current page.").number("offset", "Starting byte offset to read from", { default: 0 }).number("length", "Number of bytes to read", { default: 256 }).enum("format", [
+		"hex",
+		"ascii",
+		"both"
+	], "Output format", { default: "both" }).string("searchPattern", "Search for this hex pattern or ASCII string in the memory range")),
+	tool("wasm_to_c", (t) => t.desc("Convert a .wasm file to C source and header.").string("inputPath", "Path to the .wasm file to convert").string("outputDir", "Directory for generated .c and .h files. If omitted, uses artifacts/wasm/").required("inputPath")),
+	tool("wasm_detect_obfuscation", (t) => t.desc("Detect obfuscation patterns in a .wasm file.").string("inputPath", "Path to the .wasm file to analyze").boolean("verbose", "Include detailed pattern evidence in output", { default: false }).required("inputPath")),
+	tool("wasm_instrument_trace", (t) => t.desc("Generate a JS instrumentation wrapper for a .wasm module.").string("inputPath", "Path to the .wasm file to instrument").array("hooks", {
+		type: "string",
+		enum: [
+			"call",
+			"memory",
+			"branch",
+			"loop",
+			"local"
+		]
+	}, "Hook types to inject").boolean("allHooks", "Inject all available hook types", { default: true }).string("outputPath", "Output JS file path. If omitted, auto-generates in artifacts/wasm/").required("inputPath"))
+];
+//#endregion
+export { wasmTools as t };

package/dist/{definitions-bAhHQJq9.mjs → definitions-BRaefg3u.mjs}

@@ -1,4 +1,4 @@
-import { t as tool } from "./tool-builder-DCbIC5Eo.mjs";
+import { t as tool } from "./tool-builder-BHJp32mV.mjs";
 //#region src/server/domains/browser/definitions.tools.advanced.ts
 const advancedBrowserToolDefinitions = [tool("js_heap_search", (t) => t.desc("Search JS heap for strings matching a pattern.").string("pattern", "Pattern to search").number("maxResults", "Max matches", { default: 50 }).boolean("caseSensitive", "Case sensitive", { default: false }).required("pattern").query()), tool("tab_workflow", (t) => t.desc("Cross-tab coordination.").enum("action", [
 	"list",
@@ -8,7 +8,8 @@ const advancedBrowserToolDefinitions = [tool("js_heap_search", (t) => t.desc("Se
 	"wait_for",
 	"context_set",
 	"context_get",
-	"transfer"
+	"transfer",
+	"clear"
 ], "Action").string("alias", "Tab alias").string("fromAlias", "Source tab alias").number("index", "Tab index (0-based)").string("url", "URL").string("selector", "CSS selector to wait for").string("waitForText", "Text to wait for").string("key", "Context key").string("value", "Context value").string("expression", "JS expression for transfer").number("timeoutMs", "Timeout ms", { default: 1e4 }).requiredOpenWorld("action"))];
 //#endregion
 //#region src/server/domains/browser/definitions.tools.page-core.ts
@@ -37,6 +38,10 @@ const browserPageCoreTools = [
 	}).number("delay", "Delay between mousedown and mouseup in ms", {
 		minimum: 0,
 		maximum: 1e4
+	}).number("timeout", "Click timeout in ms", {
+		default: 1e4,
+		minimum: 1e3,
+		maximum: 12e4
 	}).string("frameUrl", "iframe URL substring").string("frameSelector", "iframe CSS selector").requiredOpenWorld("selector")),
 	tool("page_type", (t) => t.desc("Type text into an element.").string("selector", "CSS selector").string("text", "Text to type").number("delay", "Delay between key presses in ms", {
 		minimum: 0,
@@ -154,7 +159,7 @@ const browserRuntimeTools = [
 		"beta",
 		"dev",
 		"canary"
-	], "Chrome channel", { default: "stable" }).string("userDataDir", "Chrome profile directory").boolean("geoip", "Auto-resolve GeoIP (camoufox)", { default: false }).boolean("humanize", "Humanize cursor (camoufox)", { default: false }).string("proxy", "Proxy URL (camoufox)").boolean("blockImages", "Block images (camoufox)", { default: false }).boolean("blockWebrtc", "Block WebRTC (camoufox)", { default: false }).boolean("blockWebgl", "Block WebGL (camoufox)", { default: false }).string("locale", "Firefox locale (camoufox)").array("addons", { type: "string" }, "Firefox addons (camoufox)").array("fonts", { type: "string" }, "Custom fonts (camoufox)").array("excludeAddons", { type: "string" }, "Addons to exclude (camoufox)").boolean("customFontsOnly", "Only use custom fonts (camoufox)", { default: false }).object("screen", {
+	], "Chrome channel", { default: "stable" }).string("userDataDir", "Chrome profile directory").array("args", { type: "string" }, "Extra Chrome launch args").boolean("enableV8NativesSyntax", "Enable V8 native syntax for launched Chrome", { default: true }).boolean("geoip", "Auto-resolve GeoIP (camoufox)", { default: false }).boolean("humanize", "Humanize cursor (camoufox)", { default: false }).string("proxy", "Proxy URL (camoufox)").boolean("blockImages", "Block images (camoufox)", { default: false }).boolean("blockWebrtc", "Block WebRTC (camoufox)", { default: false }).boolean("blockWebgl", "Block WebGL (camoufox)", { default: false }).string("locale", "Firefox locale (camoufox)").array("addons", { type: "string" }, "Firefox addons (camoufox)").array("fonts", { type: "string" }, "Custom fonts (camoufox)").array("excludeAddons", { type: "string" }, "Addons to exclude (camoufox)").boolean("customFontsOnly", "Only use custom fonts (camoufox)", { default: false }).object("screen", {
 		width: { type: "number" },
 		height: { type: "number" }
 	}, "Screen resolution (camoufox)").object("window", {
@@ -259,6 +264,7 @@ const browserSecurityStateTools = [
 //#endregion
 //#region src/server/domains/browser/definitions.tools.behavior.ts
 const behaviorTools = [
+	tool("captcha_solver_capabilities", (t) => t.desc("Report CAPTCHA solving mode availability.").query()),
 	tool("human_mouse", (t) => t.desc("Move mouse along a Bezier curve with jitter.").number("fromX", "Start X").number("fromY", "Start Y").number("toX", "Target X").number("toY", "Target Y").string("selector", "CSS selector (alternative to toX/toY)").number("durationMs", "Duration ms", { default: 600 }).number("steps", "Intermediate points", { default: 24 }).number("jitterPx", "Max jitter px", { default: 1.5 }).enum("curve", [
 		"ease",
 		"linear",
@@ -272,13 +278,13 @@ const behaviorTools = [
 		"right"
 	], "Direction", { default: "down" }).number("durationMs", "Duration ms", { default: 1500 }).number("segments", "Segments", { default: 8 }).number("pauseMs", "Pause between segments ms", { default: 80 }).number("jitter", "Variation factor 0-1", { default: .3 }).string("selector", "Scrollable container selector").openWorld()),
 	tool("human_typing", (t) => t.desc("Type text with human-like speed and occasional typos.").string("selector", "CSS selector").string("text", "Text to type").number("wpm", "Words per minute", { default: 90 }).number("errorRate", "Typo probability per char", { default: .02 }).number("correctDelayMs", "Delay before correcting typo ms", { default: 200 }).boolean("clearFirst", "Clear existing value first", { default: false }).requiredOpenWorld("selector", "text")),
-	tool("captcha_vision_solve", (t) => t.desc("Solve CAPTCHA via external service or AI vision.").enum("mode", ["external_service", "manual"], "Solver mode").string("provider", "External solver provider").string("apiKey", "API key").enum("challengeType", [
+	tool("captcha_vision_solve", (t) => t.desc("Solve a CAPTCHA with manual flow or a configured external service.").enum("mode", ["external_service", "manual"], "Solver mode").string("provider", "External solver provider").string("apiKey", "API key").enum("challengeType", [
 		"image",
 		"widget",
 		"browser_check",
 		"auto"
 	], "Challenge type", { default: "auto" }).string("typeHint", "Legacy alias for challengeType").string("siteKey", "Widget site key").string("pageUrl", "Page URL").number("timeoutMs", "Timeout ms", { default: 18e4 }).number("maxRetries", "Max retries", { default: 2 }).openWorld()),
-	tool("widget_challenge_solve", (t) => t.desc("Solve embedded widget challenge.").string("siteKey", "Widget site key").string("pageUrl", "Page URL").enum("mode", [
+	tool("widget_challenge_solve", (t) => t.desc("Solve a widget challenge with hook, manual, or configured external service.").string("siteKey", "Widget site key").string("pageUrl", "Page URL").enum("mode", [
 		"external_service",
 		"hook",
 		"manual"

package/dist/{definitions-DVGfrn7y.mjs → definitions-BbkvZkiv.mjs}

@@ -1,4 +1,4 @@
-import { t as tool } from "./tool-builder-DCbIC5Eo.mjs";
+import { t as tool } from "./tool-builder-BHJp32mV.mjs";
 //#region src/server/domains/debugger/definitions.tools.core.ts
 const DEBUGGER_CORE_TOOLS = [
 	tool("debugger_lifecycle", (t) => t.desc("Manage the debugger lifecycle (enable or disable)").enum("action", ["enable", "disable"], "Action to perform").required("action").idempotent()),
@@ -31,7 +31,7 @@ Types & params:
 		"event",
 		"event_category",
 		"exception"
-	], "Breakpoint type (default: code)", { default: "code" }).string("scriptId", "Script ID (type=code)").number("lineNumber", "Line number 0-based (type=code, action=set)").number("columnNumber", "Column number 0-based (type=code)").string("condition", "Conditional expression (type=code)").string("urlPattern", "URL pattern with wildcards (type=xhr, action=set)").string("eventName", "Event name e.g. \"click\" (type=event, action=set)").string("targetName", "Target name e.g. \"WebSocket\" (type=event)").enum("category", [
+	], "Breakpoint type (default: code)", { default: "code" }).string("url", "Script URL (type=code, alternative to scriptId)").string("scriptId", "Script ID (type=code)").number("lineNumber", "Line number 0-based (type=code, action=set)").number("columnNumber", "Column number 0-based (type=code)").string("condition", "Conditional expression (type=code)").string("urlPattern", "URL pattern with wildcards (type=xhr, action=set)").string("eventName", "Event name e.g. \"click\" (type=event, action=set)").string("targetName", "Target name e.g. \"WebSocket\" (type=event)").enum("category", [
 		"mouse",
 		"keyboard",
 		"timer",

package/dist/definitions-BtWSHJ3o.mjs

@@ -0,0 +1,17 @@
+import { t as tool } from "./tool-builder-BHJp32mV.mjs";
+//#region src/server/domains/coordination/definitions.ts
+const coordinationTools = [
+	tool("create_task_handoff", (t) => t.desc("Create an in-session task handoff.").string("description", "Task description").array("constraints", { type: "string" }, "Constraints for the specialist").string("targetDomain", "Suggested domain for the specialist").required("description")),
+	tool("complete_task_handoff", (t) => t.desc("Complete a task handoff.").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")),
+	tool("get_task_context", (t) => t.desc("Read task handoff context.").string("taskId", "Optional task ID to read a single handoff").query()),
+	tool("append_session_insight", (t) => t.desc("Append a session insight.").string("category", "Insight category").string("content", "The insight content").number("confidence", "Confidence level 0.0-1.0", {
+		minimum: 0,
+		maximum: 1,
+		default: 1
+	}).required("category", "content")),
+	tool("save_page_snapshot", (t) => t.desc("Save current page state.").string("label", "Human-readable label for this snapshot").readOnly()),
+	tool("restore_page_snapshot", (t) => t.desc("Restore a saved page snapshot.").string("snapshotId", "Snapshot ID from save_page_snapshot").required("snapshotId").idempotent()),
+	tool("list_page_snapshots", (t) => t.desc("List saved page snapshots.").query())
+];
+//#endregion
+export { coordinationTools as t };

package/dist/{definitions-BMfYXoNC.mjs → definitions-C1gCHO0i.mjs}

@@ -1,4 +1,4 @@
-import { t as tool } from "./tool-builder-DCbIC5Eo.mjs";
+import { t as tool } from "./tool-builder-BHJp32mV.mjs";
 //#region src/server/domains/hooks/definitions.ts
 const aiHookTools = [tool("ai_hook", (t) => t.desc("Manage AI hooks. Actions: inject (inject code into page), get_data (retrieve captured hook data), list (all active hooks), clear (remove hook data by id or all), toggle (enable/disable a hook), export (export data as JSON/CSV).").enum("action", [
 	"inject",

package/dist/{definitions-C1UvM5Iy.mjs → definitions-CDOg_b-l.mjs}

@@ -1,4 +1,4 @@
-import { t as tool } from "./tool-builder-DCbIC5Eo.mjs";
+import { t as tool } from "./tool-builder-BHJp32mV.mjs";
 //#region src/server/domains/analysis/definitions.ts
 const webcrackMappingsSchema = {
 	type: "array",
@@ -120,7 +120,19 @@ const coreTools = [
 		minimum: 1,
 		maximum: 1e4
 	}).openWorld()),
-	tool("llm_suggest_names", (t) => t.desc("Use client LLM (via MCP sampling) to suggest meaningful names for obfuscated ...").array("identifiers", { type: "string" }, "Array of obfuscated identifier names to rename").required("code", "identifiers").readOnly())
+	tool("llm_suggest_names", (t) => t.desc("Use client LLM (via MCP sampling) to suggest meaningful names for obfuscated ...").array("identifiers", { type: "string" }, "Array of obfuscated identifier names to rename").required("code", "identifiers").readOnly()),
+	tool("js_deobfuscate_jsvmp", (t) => t.desc("Deobfuscate JSVMP/VM-protected JavaScript: extract VM bytecode and restore original logic.").string("code", "Obfuscated JavaScript source containing VM/JSVMP patterns").boolean("aggressive", "Use aggressive deobfuscation strategy", { default: false }).boolean("extractInstructions", "Extract and list VM instructions", { default: true }).number("timeout", "Deobfuscation timeout in ms", {
+		default: 3e4,
+		minimum: 5e3,
+		maximum: 12e4
+	}).boolean("detectOnly", "Only detect JSVMP without deobfuscating", { default: false }).required("code")),
+	tool("js_deobfuscate_pipeline", (t) => t.desc("Three-stage deobfuscation pipeline: preprocess → deobfuscate → humanize.").string("code", "Obfuscated JavaScript source").boolean("useWebcrack", "Apply webcrack after preprocessor stage", { default: true }).boolean("aggressive", "Enable aggressive transforms in deobfuscator stage", { default: false }).boolean("humanize", "Run humanizer stage (variable renaming)", { default: true }).boolean("returnStageDetails", "Include per-stage results in output", { default: false }).required("code")),
+	tool("js_analyze_vm", (t) => t.desc("Analyze JSVMP/VM interpreter structure: dispatch type, handler table, opcode map.").string("code", "JavaScript source containing VM interpreter").boolean("extractBytecode", "Attempt to extract VM bytecode", { default: true }).boolean("mapOpcodes", "Map opcodes to inferred operations", { default: true }).required("code")),
+	tool("js_solve_constraints", (t) => t.desc("Solve opaque predicates and constant expressions in obfuscated code.").string("code", "JavaScript source with opaque predicates or constant conditions").boolean("replaceInPlace", "Replace solved conditions with their constant values", { default: true }).number("maxIterations", "Maximum solving iterations", {
+		default: 100,
+		minimum: 1,
+		maximum: 1e4
+	}).required("code"))
 ];
 //#endregion
 export { coreTools as t };

package/dist/definitions-CVPD9hzZ.mjs

@@ -0,0 +1,54 @@
+import { t as tool } from "./tool-builder-BHJp32mV.mjs";
+//#region src/server/domains/platform/definitions.ts
+const platformTools = [
+	tool("platform_capabilities", (t) => t.desc("Report platform tool backend availability.").query()),
+	tool("miniapp_pkg_scan", (t) => t.desc("Scan local directories for miniapp package files.").string("searchPath", "可选。指定扫描根目录；不提供时使用默认路径（MiniApp/Cache 与 MiniApp/Plugin）。")),
+	tool("miniapp_pkg_unpack", (t) => t.desc("Unpack a miniapp package.").string("inputPath", "必填。小程序包文件路径。").string("outputDir", "可选。输出目录；不提供时自动生成 artifacts 临时目录。").required("inputPath")),
+	tool("miniapp_pkg_analyze", (t) => t.desc("Analyze an unpacked miniapp package.").string("unpackedDir", "必填。已解包目录路径。").required("unpackedDir")),
+	tool("asar_extract", (t) => t.desc("Extract files from an Electron ASAR archive.").string("inputPath", "必填。asar 文件路径。").string("outputDir", "可选。提取目录；不提供时自动生成 artifacts 临时目录。").boolean("listOnly", "可选。默认 false；true 时仅列出文件清单，不执行提取。", { default: false }).required("inputPath")),
+	tool("electron_inspect_app", (t) => t.desc("Inspect an Electron app structure.").string("appPath", "Path to Electron app (.exe or app directory)").required("appPath")),
+	tool("electron_scan_userdata", (t) => t.desc("Scan a directory for Electron JSON userdata files.").string("dirPath", "Directory path to scan for JSON files").number("maxFiles", "可选。最多读取的 JSON 文件数量。默认 20。", {
+		default: 20,
+		minimum: 1,
+		maximum: 1e4
+	}).number("maxFileSizeKB", "可选。单个文件大小上限（KB）。超限文件跳过。默认 1024。", {
+		default: 1024,
+		minimum: 1,
+		maximum: 102400
+	}).required("dirPath").query()),
+	tool("asar_search", (t) => t.desc("Search text inside an ASAR archive.").string("inputPath", "必填。ASAR 文件路径。").string("pattern", "必填。正则表达式字符串。").string("fileGlob", "可选。文件扩展名过滤。默认 *.js。", { default: "*.js" }).number("maxResults", "可选。最大返回匹配数。默认 100。", {
+		default: 100,
+		minimum: 1,
+		maximum: 1e4
+	}).required("inputPath", "pattern").query()),
+	tool("electron_check_fuses", (t) => t.desc("Read Electron fuse states.").string("exePath", "必填。Electron .exe 文件路径。").required("exePath").query()),
+	tool("electron_patch_fuses", (t) => t.desc("Patch Electron fuse states.").string("exePath", "Electron .exe file path").enum("profile", ["debug", "custom"], "Patch profile. \"debug\" enables debug-related fuses. \"custom\" requires a fuses object.", { default: "debug" }).object("fuses", {}, "For profile=\"custom\". Map of fuse names to ENABLE/DISABLE. E.g. {\"RunAsNode\": \"ENABLE\"}.").boolean("createBackup", "Create a .exe.bak backup before patching.", { default: true }).required("exePath").destructive()),
+	tool("v8_bytecode_decompile", (t) => t.desc("Decompile or extract strings from V8 bytecode files.").string("filePath", "Path to .jsc bytecode file").required("filePath").query()),
+	tool("electron_launch_debug", (t) => t.desc("Launch Electron with main and renderer CDP ports.").string("exePath", "Electron .exe file path").number("mainPort", "Main process inspect port.", {
+		default: 9229,
+		minimum: 1,
+		maximum: 65535
+	}).number("rendererPort", "Renderer remote debugging port.", {
+		default: 9222,
+		minimum: 1,
+		maximum: 65535
+	}).array("args", { type: "string" }, "Extra command-line arguments.").boolean("skipFuseCheck", "Skip fuse status check.", { default: false }).number("waitMs", "Milliseconds to wait for CDP ports.", {
+		default: 8e3,
+		minimum: 1e3,
+		maximum: 12e4
+	}).requiredOpenWorld("exePath")),
+	tool("electron_debug_status", (t) => t.desc("Check status of dual-CDP debug sessions launched by electron_launch_debug.").string("sessionId", "Optional. Check specific session. Omit to list all.").query()),
+	tool("electron_ipc_sniff", (t) => t.desc("Monitor Electron IPC via renderer-side hooks.").enum("action", [
+		"start",
+		"dump",
+		"stop",
+		"list",
+		"guide"
+	], "Action to perform.", { default: "guide" }).number("port", "Renderer CDP port (--remote-debugging-port).", {
+		default: 9222,
+		minimum: 1,
+		maximum: 65535
+	}).string("sessionId", "Session ID for dump/stop.").boolean("clear", "Clear captured messages after dump.", { default: true }).openWorld())
+];
+//#endregion
+export { platformTools as t };

package/dist/{definitions-Cke7zEb8.mjs → definitions-Cea8Lgl7.mjs}

@@ -1,4 +1,4 @@
-import { t as tool } from "./tool-builder-DCbIC5Eo.mjs";
+import { t as tool } from "./tool-builder-BHJp32mV.mjs";
 //#region src/server/domains/workflow/definitions.ts
 const workflowNetworkPolicySchema = {
 	type: "object",

package/dist/definitions-DAgIyjxM.mjs

@@ -0,0 +1,10 @@
+import { t as tool } from "./tool-builder-BHJp32mV.mjs";
+//#region src/server/domains/sourcemap/definitions.ts
+const sourcemapTools = [
+	tool("sourcemap_discover", (t) => t.desc("Discover source maps on the current page.").boolean("includeInline", "Include inline data: source maps.", { default: true })),
+	tool("sourcemap_fetch_and_parse", (t) => t.desc("Parse a source map.").string("sourceMapUrl", "Source map URL.").string("scriptUrl", "Script URL for relative map resolution.").required("sourceMapUrl")),
+	tool("sourcemap_reconstruct_tree", (t) => t.desc("Reconstruct source files from a source map.").string("sourceMapUrl", "Source map URL.").string("outputDir", "Output directory under the project root.").required("sourceMapUrl")),
+	tool("sourcemap_parse_v4", (t) => t.desc("Parse source map with ECMA-426 v4 scope/debug-id support; falls back to v3.").string("sourceMapUrl", "Source map URL to parse.").boolean("extractScopes", "Extract and decode scope information from v4 x_scopes field", { default: true }).boolean("extractDebugIds", "Extract debug-id mappings for source correlation", { default: true }).boolean("compareV3", "Compare v4 fields against v3 baseline and report differences", { default: false }).required("sourceMapUrl"))
+];
+//#endregion
+export { sourcemapTools as t };

package/dist/{definitions-B4rAvHNZ.mjs → definitions-DJA27nsL.mjs}

@@ -1,4 +1,4 @@
-import { t as tool } from "./tool-builder-DCbIC5Eo.mjs";
+import { t as tool } from "./tool-builder-BHJp32mV.mjs";
 //#region src/server/domains/process/definitions.ts
 /**
 * Process Manager Tool Definitions
@@ -12,9 +12,9 @@ const processToolDefinitions = [
 		minimum: 1,
 		maximum: 65535
 	}).array("args", { type: "string" }, "Additional command line arguments").required("executablePath")),
-	tool("memory_read", (t) => t.desc("Read memory from a process at a specific address. Requires elevated privileges.").string("address", "Memory address to read (hex string like \"0x12345678\")").number("size", "Number of bytes to read").required("pid", "address", "size")),
-	tool("memory_write", (t) => t.desc("Write data to process memory at a specific address. Requires elevated privileges.").string("address", "Memory address to write to (hex string like \"0x12345678\")").string("data", "Data to write (hex string or base64)").enum("encoding", ["hex", "base64"], "Encoding of the data parameter", { default: "hex" }).required("pid", "address", "data")),
-	tool("memory_scan", (t) => t.desc("Scan process memory for a pattern or value. Requires elevated privileges.").string("pattern", "Pattern to search for (hex bytes like \"48 8B 05\" or value)").enum("patternType", [
+	tool("memory_read", (t) => t.desc("Read memory from a process at a specific address. Requires elevated privileges.").number("pid", "Target process ID").string("address", "Memory address to read (hex string like \"0x12345678\")").number("size", "Number of bytes to read").required("pid", "address", "size")),
+	tool("memory_write", (t) => t.desc("Write data to process memory at a specific address. Requires elevated privileges.").number("pid", "Target process ID").string("address", "Memory address to write to (hex string like \"0x12345678\")").string("data", "Data to write (hex string or base64)").enum("encoding", ["hex", "base64"], "Encoding of the data parameter", { default: "hex" }).required("pid", "address", "data")),
+	tool("memory_scan", (t) => t.desc("Scan process memory for a pattern or value. Requires elevated privileges.").number("pid", "Target process ID").string("pattern", "Pattern to search for (hex bytes like \"48 8B 05\" or value)").enum("patternType", [
 		"hex",
 		"int32",
 		"int64",
@@ -22,8 +22,8 @@ const processToolDefinitions = [
 		"double",
 		"string"
 	], "Type of pattern to search", { default: "hex" }).boolean("suspendTarget", "Suspend the target process during scan for a consistent memory snapshot (default: false)", { default: false }).required("pid", "pattern")),
-	tool("memory_check_protection", (t) => t.desc("Check memory protection flags at a specific address.").string("address", "Memory address to check (hex string like \"0x12345678\")").required("pid", "address")),
-	tool("memory_scan_filtered", (t) => t.desc("Scan memory within a filtered set of addresses (secondary scan).").string("pattern", "Pattern to search for").array("addresses", { type: "string" }, "List of addresses to scan within (from previous scan)").enum("patternType", [
+	tool("memory_check_protection", (t) => t.desc("Check memory protection flags at a specific address.").number("pid", "Target process ID").string("address", "Memory address to check (hex string like \"0x12345678\")").required("pid", "address")),
+	tool("memory_scan_filtered", (t) => t.desc("Scan memory within a filtered set of addresses (secondary scan).").number("pid", "Target process ID").string("pattern", "Pattern to search for").array("addresses", { type: "string" }, "List of addresses to scan within (from previous scan)").enum("patternType", [
 		"hex",
 		"int32",
 		"int64",
@@ -53,11 +53,14 @@ const processToolDefinitions = [
 	tool("memory_dump_region", (t) => t.desc("Dump a memory region to a file for analysis.").number("pid", "Target process ID").string("address", "Start address (hex)").number("size", "Number of bytes to dump").string("outputPath", "Output file path").required("pid", "address", "size", "outputPath")),
 	tool("memory_list_regions", (t) => t.desc("List all memory regions in a process with protection flags.").number("pid", "Target process ID").required("pid")),
 	tool("memory_audit_export", (t) => t.desc("Export the in-memory audit trail for memory operations as JSON.")),
-	tool("inject_dll", (t) => t.desc("Inject a DLL into a target process using CreateRemoteThread + LoadLibraryA (W...").string("dllPath", "Full path to the DLL file to inject").required("pid", "dllPath")),
-	tool("inject_shellcode", (t) => t.desc("Inject and execute shellcode in a target process.").string("shellcode", "Shellcode bytes (hex string or base64)").enum("encoding", ["hex", "base64"], "Encoding of shellcode", { default: "hex" }).required("pid", "shellcode")),
+	tool("inject_dll", (t) => t.desc("Inject a DLL into a target process using CreateRemoteThread + LoadLibraryA (W...").number("pid", "Target process ID").string("dllPath", "Full path to the DLL file to inject").required("pid", "dllPath")),
+	tool("inject_shellcode", (t) => t.desc("Inject and execute shellcode in a target process.").number("pid", "Target process ID").string("shellcode", "Shellcode bytes (hex string or base64)").enum("encoding", ["hex", "base64"], "Encoding of shellcode", { default: "hex" }).required("pid", "shellcode")),
 	tool("check_debug_port", (t) => t.desc("Check if a process is being debugged using NtQueryInformationProcess (ProcessDebugPort).").number("pid", "Target process ID").required("pid")),
 	tool("enumerate_modules", (t) => t.desc("List all loaded modules (DLLs) in a process with their base addresses.").number("pid", "Target process ID").required("pid")),
-	tool("electron_attach", (t) => t.desc("Connect to a running Electron app (VS Code, Cursor, etc.) via CDP and inspect...").string("pageUrl", "Filter pages by URL substring (e.g. \"extension-host\" to target VS Code extension host)"))
+	tool("electron_attach", (t) => t.desc("Attach to an Electron CDP port and optionally evaluate in a matching page.").number("port", "CDP port to connect to", {
+		minimum: 1,
+		maximum: 65535
+	}).string("pageUrl", "Optional URL substring used to pick the target page").string("evaluate", "Optional JavaScript expression to evaluate in the selected page").string("wsEndpoint", "Optional browser WebSocket endpoint override"))
 ];
 //#endregion
 export { processToolDefinitions as t };

package/dist/{definitions-ClJLzsJQ.mjs → definitions-DKPFU3LW.mjs}

@@ -1,4 +1,4 @@
-import { t as tool } from "./tool-builder-DCbIC5Eo.mjs";
+import { t as tool } from "./tool-builder-BHJp32mV.mjs";
 //#region src/server/domains/maintenance/definitions.ts
 const tokenBudgetTools = [
 	tool("get_token_budget_stats", (t) => t.desc("Get token budget usage stats, warnings, and optimization suggestions").query()),

package/dist/{definitions-D3VsGcvz.mjs → definitions-DPRpZQ96.mjs}

@@ -1,12 +1,12 @@
-import { t as tool } from "./tool-builder-DCbIC5Eo.mjs";
+import { t as tool } from "./tool-builder-BHJp32mV.mjs";
 //#region src/server/domains/encoding/definitions.ts
 const encodingTools = [
-	tool("binary_detect_format", (t) => t.desc("Detect binary payload format/encoding via magic bytes, encoding heuristics, a...").enum("source", [
+	tool("binary_detect_format", (t) => t.desc("Detect binary payload format and encoding signals.").enum("source", [
 		"base64",
 		"hex",
 		"file",
 		"raw"
-	], "How to interpret input payload").string("filePath", "File path when source=file").string("requestId", "Captured network requestId to resolve response body").required("source").query()),
+	], "How to interpret input payload").string("data", "Input payload for base64/hex/raw sources").string("filePath", "File path when source=file").string("requestId", "Captured requestId when a response body is available").required("source").query()),
 	tool("binary_decode", (t) => t.desc("Decode binary payloads into hex, utf8, or json output").string("data", "Input encoded payload").enum("encoding", [
 		"base64",
 		"hex",
@@ -17,7 +17,7 @@ const encodingTools = [
 		"hex",
 		"utf8",
 		"json"
-	], "Target output format", { default: "hex" }).required("data", "encoding")),
+	], "Target output format", { default: "hex" }).required("data", "encoding").query()),
 	tool("binary_encode", (t) => t.desc("Encode utf8/hex/json input into base64/hex/url output").string("data", "Input payload").enum("inputFormat", [
 		"utf8",
 		"hex",
@@ -26,13 +26,13 @@ const encodingTools = [
 		"base64",
 		"hex",
 		"url"
-	], "Desired output encoding").required("data", "inputFormat", "outputEncoding")),
-	tool("binary_entropy_analysis", (t) => t.desc("Compute Shannon entropy + byte frequency to assess plaintext/encoded/compress...").enum("source", [
+	], "Desired output encoding").required("data", "inputFormat", "outputEncoding").query()),
+	tool("binary_entropy_analysis", (t) => t.desc("Compute entropy and byte frequency for a payload.").enum("source", [
 		"base64",
 		"hex",
 		"raw",
 		"file"
-	], "How to interpret input payload").string("filePath", "File path when source=file").number("blockSize", "Block size for per-block entropy", {
+	], "How to interpret input payload").string("data", "Input payload for base64/hex/raw sources").string("filePath", "File path when source=file").number("blockSize", "Block size for per-block entropy", {
 		default: 256,
 		minimum: 16,
 		maximum: 8192

package/dist/{definitions-B18eyf0B.mjs → definitions-DUE5gmdn.mjs}

@@ -1,4 +1,4 @@
-import { t as tool } from "./tool-builder-DCbIC5Eo.mjs";
+import { t as tool } from "./tool-builder-BHJp32mV.mjs";
 //#region src/server/domains/antidebug/definitions.ts
 const antidebugTools = [tool("antidebug_bypass", (t) => t.desc("Bypass one or more anti-debug protection types. Specify types to apply; omit or use [\"all\"] to apply all bypasses. Types: all, debugger_statement, timing, stack_trace, console_detect.").array("types", {
 	type: "string",

package/dist/definitions-DYVjOtxa.mjs

@@ -0,0 +1,26 @@
+import { t as tool } from "./tool-builder-BHJp32mV.mjs";
+//#region src/server/domains/shared-state-board/definitions.ts
+const sharedStateBoardTools = [
+	tool("state_board", (t) => t.desc("Manage shared state board entries.").enum("action", [
+		"set",
+		"get",
+		"delete",
+		"list",
+		"history",
+		"clear"
+	], "Operation to perform").string("key", "Key name (required for set/get/delete/history)").prop("value", {
+		type: "object",
+		description: "Value to store"
+	}).string("namespace", "Namespace for key isolation").number("ttlSeconds", "TTL in seconds").boolean("includeValues", "Include current values in list results", { default: false }).number("limit", "Maximum history entries to return", { default: 50 }).string("keyPattern", "Key pattern filter").required("action")),
+	tool("state_board_watch", (t) => t.desc("Start, poll, or stop shared state board watches.").enum("action", [
+		"start",
+		"poll",
+		"stop"
+	], "Watch operation: start watching, poll for changes, or stop watching").string("key", "Key or pattern to watch").string("namespace", "Namespace").number("pollIntervalMs", "Polling interval in milliseconds").string("watchId", "Watch ID").required("action")),
+	tool("state_board_io", (t) => t.desc("Export or import state board entries.").enum("action", ["export", "import"], "IO operation").string("namespace", "Namespace filter or target namespace").string("keyPattern", "Key pattern filter").prop("data", {
+		type: "object",
+		description: "Entries to import"
+	}).boolean("overwrite", "Overwrite existing keys on import").required("action"))
+];
+//#endregion
+export { sharedStateBoardTools as t };

package/dist/{definitions-BB_4jnmy.mjs → definitions-DcYLVLCo.mjs}

@@ -1,4 +1,4 @@
-import { t as tool } from "./tool-builder-DCbIC5Eo.mjs";
+import { t as tool } from "./tool-builder-BHJp32mV.mjs";
 //#region src/server/domains/streaming/definitions.ts
 const streamingTools = [
 	tool("ws_monitor", (t) => t.desc("Enable or disable WebSocket frame capture via CDP Network events.").enum("action", ["enable", "disable"], "Monitor action").string("urlFilter", "Regex filter for WebSocket URL (action=enable)").number("maxFrames", "Maximum frames in memory (action=enable, default: 1000)", {

package/dist/{definitions-Beid2EB3.mjs → definitions-Pp5LI2H4.mjs}

@@ -1,4 +1,4 @@
-import { t as tool } from "./tool-builder-DCbIC5Eo.mjs";
+import { t as tool } from "./tool-builder-BHJp32mV.mjs";
 //#region src/server/domains/graphql/definitions.ts
 const graphqlTools = [
 	tool("call_graph_analyze", (t) => t.desc("Analyze runtime function call graph from in-page traces").number("maxDepth", "Maximum stack-derived edge depth", { default: 5 }).string("filterPattern", "Regex filter for function names").query()),

package/dist/definitions-j9KdHVNR.mjs

@@ -0,0 +1,14 @@
+import { t as tool } from "./tool-builder-BHJp32mV.mjs";
+//#region src/server/domains/proxy/definitions.ts
+const PROXY_TOOLS = [
+	tool("proxy_start", (t) => t.desc("Start the local HTTP/HTTPS proxy.").number("port", "Listen port.", { default: 8080 }).boolean("useHttps", "Enable HTTPS interception.", { default: true })),
+	tool("proxy_stop", (t) => t.desc("Stop the proxy.").destructive()),
+	tool("proxy_status", (t) => t.desc("Read proxy status and CA path.").query()),
+	tool("proxy_export_ca", (t) => t.desc("Read the proxy CA certificate.").query()),
+	tool("proxy_add_rule", (t) => t.desc("Add a proxy rule.").string("action", "Rule action: forward, mock_response, or block.").string("method", "HTTP method to match.", { default: "GET" }).string("urlPattern", "URL matcher string or regex literal.").number("mockStatus", "Response status for mock_response.", { default: 200 }).string("mockBody", "Response body for mock_response.").required("action")),
+	tool("proxy_get_requests", (t) => t.desc("Read captured proxy requests.").string("urlFilter", "Optional URL filter.").query()),
+	tool("proxy_clear_logs", (t) => t.desc("Clear captured proxy logs.").resettable()),
+	tool("proxy_setup_adb_device", (t) => t.desc("Configure an Android device to use the proxy.").string("deviceSerial", "ADB device serial."))
+];
+//#endregion
+export { PROXY_TOOLS as t };