@jshookmcp/jshook 0.2.8 → 0.3.0

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-BRaefg3u.mjs

@@ -0,0 +1,365 @@
+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",
+	"alias_bind",
+	"alias_open",
+	"navigate",
+	"wait_for",
+	"context_set",
+	"context_get",
+	"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
+const browserPageCoreTools = [
+	tool("page_navigate", (t) => t.desc("Navigate to a URL.").string("url", "Target URL").enum("waitUntil", [
+		"load",
+		"domcontentloaded",
+		"networkidle",
+		"commit"
+	], "When to consider navigation succeeded", { default: "networkidle" }).number("timeout", "Navigation timeout in ms", {
+		default: 3e4,
+		minimum: 1e3,
+		maximum: 12e4
+	}).boolean("enableNetworkMonitoring", "Enable network monitoring before navigation", { default: false }).required("url").idempotent().openWorld()),
+	tool("page_reload", (t) => t.desc("Reload current page").idempotent().openWorld()),
+	tool("page_back", (t) => t.desc("Go back in history").openWorld()),
+	tool("page_forward", (t) => t.desc("Go forward in history").openWorld()),
+	tool("page_click", (t) => t.desc("Click an element.").string("selector", "CSS selector").enum("button", [
+		"left",
+		"right",
+		"middle"
+	], "Mouse button", { default: "left" }).number("clickCount", "Number of clicks", {
+		default: 1,
+		minimum: 1,
+		maximum: 10
+	}).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,
+		maximum: 1e3
+	}).string("frameUrl", "iframe URL substring").string("frameSelector", "iframe CSS selector").requiredOpenWorld("selector", "text")),
+	tool("page_select", (t) => t.desc("Select option(s) in a <select> element.").string("selector", "CSS selector").array("values", { type: "string" }, "Values to select").string("frameUrl", "iframe URL substring").string("frameSelector", "iframe CSS selector").required("selector", "values").idempotent().openWorld()),
+	tool("page_hover", (t) => t.desc("Hover over an element.").string("selector", "CSS selector").string("frameUrl", "iframe URL substring").string("frameSelector", "iframe CSS selector").required("selector").idempotent().openWorld()),
+	tool("page_scroll", (t) => t.desc("Scroll the page.").number("x", "Horizontal position", { default: 0 }).number("y", "Vertical position", { default: 0 }).idempotent()),
+	tool("page_wait_for_selector", (t) => t.desc("Wait for an element to appear.").string("selector", "CSS selector").number("timeout", "Timeout in ms", {
+		default: 3e4,
+		minimum: 1e3,
+		maximum: 12e4
+	}).required("selector").query()),
+	tool("page_evaluate", (t) => t.desc("Execute JavaScript in page context.").string("code", "JavaScript code").boolean("autoSummarize", "Auto-summarize large results", { default: true }).number("maxSize", "Max result size in bytes before summarizing", {
+		default: 51200,
+		minimum: 1024,
+		maximum: 10485760
+	}).array("fieldFilter", { type: "string" }, "Field names to strip from result (recursive)").boolean("stripBase64", "Strip base64 strings from result", { default: false }).string("frameUrl", "iframe URL substring").string("frameSelector", "iframe CSS selector").requiredOpenWorld("code")),
+	tool("page_screenshot", (t) => t.desc("Take a screenshot.").prop("selector", {
+		oneOf: [{
+			type: "string",
+			description: "CSS selector"
+		}, {
+			type: "array",
+			items: { type: "string" },
+			description: "Multiple CSS selectors"
+		}],
+		description: "Element selector(s). Omit for full page viewport."
+	}).object("clip", {
+		x: {
+			type: "number",
+			description: "Left offset"
+		},
+		y: {
+			type: "number",
+			description: "Top offset"
+		},
+		width: {
+			type: "number",
+			description: "Width"
+		},
+		height: {
+			type: "number",
+			description: "Height"
+		}
+	}, "Pixel region to capture", { required: [
+		"x",
+		"y",
+		"width",
+		"height"
+	] }).string("path", "File path to save screenshot").enum("type", ["png", "jpeg"], "Image format", { default: "png" }).number("quality", "Image quality 0-100 (jpeg only)", {
+		minimum: 1,
+		maximum: 100
+	}).boolean("fullPage", "Capture full scrollable page", { default: false }).query()),
+	tool("get_all_scripts", (t) => t.desc("List all loaded scripts.").boolean("includeSource", "Include source code", { default: false }).query()),
+	tool("get_script_source", (t) => t.desc("Get source code of a script.").string("scriptId", "Script ID").string("url", "Script URL (supports wildcards)").boolean("preview", "Preview only (first N lines + metadata)", { default: false }).number("maxLines", "Max lines in preview", {
+		default: 100,
+		minimum: 1,
+		maximum: 1e4
+	}).number("startLine", "Start line (1-based)", { minimum: 1 }).number("endLine", "End line (1-based)", { minimum: 1 }).query())
+];
+//#endregion
+//#region src/server/domains/browser/definitions.tools.page-system.ts
+const browserPageSystemTools = [
+	tool("console_monitor", (t) => t.desc("Enable or disable console monitoring.").enum("action", ["enable", "disable"], "Action").required("action").idempotent()),
+	tool("console_get_logs", (t) => t.desc("Get captured console logs.").enum("type", [
+		"log",
+		"warn",
+		"error",
+		"info",
+		"debug"
+	], "Log type filter").number("limit", "Max logs").number("since", "Timestamp filter").query()),
+	tool("console_execute", (t) => t.desc("Execute JS in console context.").string("expression", "JavaScript expression").requiredOpenWorld("expression")),
+	tool("page_inject_script", (t) => t.desc("Inject JS into the page.").string("script", "JavaScript code").requiredOpenWorld("script")),
+	tool("page_cookies", (t) => t.desc("Manage page cookies. Clear requires expectedCount (call get first).").enum("action", [
+		"get",
+		"set",
+		"clear"
+	], "Action").number("expectedCount", "Required for clear: must match current count").array("cookies", {
+		type: "object",
+		properties: {
+			name: { type: "string" },
+			value: { type: "string" },
+			domain: { type: "string" },
+			path: { type: "string" },
+			expires: { type: "number" },
+			httpOnly: { type: "boolean" },
+			secure: { type: "boolean" },
+			sameSite: {
+				type: "string",
+				enum: [
+					"Strict",
+					"Lax",
+					"None"
+				]
+			}
+		},
+		required: ["name", "value"]
+	}, "Cookies (action=set)").destructive().required("action")),
+	tool("page_set_viewport", (t) => t.desc("Set viewport size.").number("width", "Width").number("height", "Height").required("width", "height").idempotent()),
+	tool("page_emulate_device", (t) => t.desc("Emulate a mobile device.").string("device", "Device name").required("device").idempotent()),
+	tool("page_local_storage", (t) => t.desc("Manage localStorage.").enum("action", ["get", "set"], "Action").string("key", "Key").string("value", "Value").required("action")),
+	tool("page_press_key", (t) => t.desc("Press a keyboard key.").string("key", "Key name").requiredOpenWorld("key"))
+];
+//#endregion
+//#region src/server/domains/browser/definitions.tools.runtime.ts
+const browserRuntimeTools = [
+	tool("get_detailed_data", (t) => t.desc("Retrieve large data by detailId.").string("detailId", "Detail ID from previous response").string("path", "Path to specific nested data").required("detailId").query()),
+	tool("browser_launch", (t) => t.desc("Launch or connect to a browser.").enum("driver", ["chrome", "camoufox"], "Browser driver", { default: "chrome" }).boolean("headless", "Run headless", { default: false }).enum("os", [
+		"windows",
+		"macos",
+		"linux"
+	], "OS fingerprint (camoufox)", { default: "windows" }).enum("mode", ["launch", "connect"], "Launch or connect", { default: "launch" }).string("browserURL", "Browser debug endpoint URL").string("wsEndpoint", "WebSocket endpoint").boolean("autoConnect", "Auto-detect local Chrome debug WebSocket", { default: false }).enum("channel", [
+		"stable",
+		"beta",
+		"dev",
+		"canary"
+	], "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", {
+		width: { type: "number" },
+		height: { type: "number" }
+	}, "Window size (camoufox)").prop("fingerprint", {
+		type: "object",
+		description: "Pre-generated fingerprint (camoufox)",
+		additionalProperties: true
+	}).prop("webglConfig", {
+		type: "object",
+		description: "WebGL config (camoufox)",
+		additionalProperties: true
+	}).prop("firefoxUserPrefs", {
+		type: "object",
+		description: "Firefox about:config overrides (camoufox)",
+		additionalProperties: true
+	}).boolean("mainWorldEval", "Main world eval (camoufox)", { default: false }).boolean("enableCache", "Enable cache (camoufox)", { default: false }).openWorld()),
+	tool("camoufox_server", (t) => t.desc("Manage Camoufox WebSocket server.").enum("action", [
+		"launch",
+		"close",
+		"status"
+	], "Action").number("port", "Listen port (launch)").string("ws_path", "WebSocket path (launch)").enum("os", [
+		"windows",
+		"macos",
+		"linux"
+	], "OS fingerprint (launch)", { default: "windows" }).boolean("headless", "Headless (launch)", { default: true }).boolean("geoip", "GeoIP (launch)", { default: false }).boolean("humanize", "Humanize cursor (launch)", { default: false }).string("proxy", "Proxy URL (launch)").boolean("blockImages", "Block images (launch)", { default: false }).boolean("blockWebrtc", "Block WebRTC (launch)", { default: false }).boolean("blockWebgl", "Block WebGL (launch)", { default: false }).string("locale", "Firefox locale (launch)").array("addons", { type: "string" }, "Addons (launch)").array("fonts", { type: "string" }, "Fonts (launch)").array("excludeAddons", { type: "string" }, "Excluded addons (launch)").boolean("customFontsOnly", "Only custom fonts (launch)", { default: false }).object("screen", {
+		width: { type: "number" },
+		height: { type: "number" }
+	}, "Screen resolution (launch)").object("window", {
+		width: { type: "number" },
+		height: { type: "number" }
+	}, "Window size (launch)").prop("fingerprint", {
+		type: "object",
+		description: "Pre-generated fingerprint (launch)",
+		additionalProperties: true
+	}).prop("webglConfig", {
+		type: "object",
+		description: "WebGL config (launch)",
+		additionalProperties: true
+	}).prop("firefoxUserPrefs", {
+		type: "object",
+		description: "Firefox about:config overrides (launch)",
+		additionalProperties: true
+	}).boolean("mainWorldEval", "Main world eval (launch)", { default: false }).boolean("enableCache", "Enable cache (launch)", { default: false }).required("action").destructive()),
+	tool("browser_attach", (t) => t.desc("Attach to a running browser via CDP.").string("browserURL", "Debug endpoint URL").string("wsEndpoint", "WebSocket URL").boolean("autoConnect", "Auto-detect local Chrome debug WebSocket", { default: false }).enum("channel", [
+		"stable",
+		"beta",
+		"dev",
+		"canary"
+	], "Chrome channel", { default: "stable" }).string("userDataDir", "Chrome profile directory").number("pageIndex", "Tab index to activate", { default: 0 }).openWorld()),
+	tool("browser_list_cdp_targets", (t) => t.desc("List CDP targets.").string("browserURL", "Browser URL").string("wsEndpoint", "WebSocket endpoint").boolean("autoConnect", "Auto-detect local Chrome debug WebSocket", { default: false }).enum("channel", [
+		"stable",
+		"beta",
+		"dev",
+		"canary"
+	], "Chrome channel", { default: "stable" }).string("userDataDir", "Chrome profile directory").string("type", "Target type filter").array("types", { type: "string" }, "Target types to include").string("targetId", "Exact targetId filter").string("urlPattern", "URL substring filter").string("titlePattern", "Title substring filter").boolean("attachedOnly", "Only attached targets", { default: false }).boolean("discoverOOPIF", "Auto-discover cross-origin iframes", { default: true }).query().openWorld()),
+	tool("browser_attach_cdp_target", (t) => t.desc("Attach to a CDP target by targetId.").string("targetId", "Target ID").required("targetId")),
+	tool("browser_detach_cdp_target", (t) => t.desc("Detach the current CDP target session.").destructive()),
+	tool("browser_evaluate_cdp_target", (t) => t.desc("Evaluate JS in the attached CDP target.").string("code", "JavaScript code").string("script", "Alias of code").boolean("returnByValue", "Return by value", { default: true }).boolean("awaitPromise", "Await promises", { default: true }).boolean("autoSummarize", "Summarize large results", { default: true }).number("maxSize", "Max size before summarizing", { default: 51200 }).array("fieldFilter", { type: "string" }, "Field names to strip").boolean("stripBase64", "Strip base64 payloads", { default: false }).required("code")),
+	tool("browser_close", (t) => t.desc("Close browser.").destructive()),
+	tool("browser_status", (t) => t.desc("Browser status.").query())
+];
+//#endregion
+//#region src/server/domains/browser/definitions.tools.security.ts
+const browserSecurityStateTools = [
+	tool("captcha_detect", (t) => t.desc("Detect CAPTCHA on the page.").query()),
+	tool("captcha_wait", (t) => t.desc("Wait for manual CAPTCHA solve.").number("timeout", "Timeout in ms", { default: 3e5 }).query().openWorld()),
+	tool("captcha_config", (t) => t.desc("Configure CAPTCHA detection and auto-handling.").boolean("autoDetectCaptcha", "Auto-detect after navigation").boolean("autoSwitchHeadless", "Switch to headed on detection").number("captchaTimeout", "Wait timeout in ms").idempotent()),
+	tool("stealth_inject", (t) => t.desc("Inject stealth scripts.").idempotent()),
+	tool("stealth_set_user_agent", (t) => t.desc("Set User-Agent and fingerprint.").enum("platform", [
+		"windows",
+		"mac",
+		"linux"
+	], "Platform", { default: "windows" }).idempotent()),
+	tool("stealth_configure_jitter", (t) => t.desc("Configure CDP timing jitter.").boolean("enabled", "Enable", { default: true }).number("minDelayMs", "Min delay ms", { default: 20 }).number("maxDelayMs", "Max delay ms", { default: 80 }).boolean("burstMode", "Skip jitter for time-critical ops", { default: false }).idempotent()),
+	tool("stealth_generate_fingerprint", (t) => t.desc("Generate a browser fingerprint.").enum("os", [
+		"windows",
+		"macos",
+		"linux"
+	], "Target OS").enum("browser", ["chrome", "firefox"], "Target browser", { default: "chrome" }).string("locale", "Locale", { default: "en-US" })),
+	tool("stealth_verify", (t) => t.desc("Run anti-detection checks.").query()),
+	tool("browser_list_tabs", (t) => t.desc("List open tabs.").string("browserURL", "Browser URL").string("wsEndpoint", "WebSocket endpoint").boolean("autoConnect", "Auto-detect Chrome debug WebSocket", { default: false }).enum("channel", [
+		"stable",
+		"beta",
+		"dev",
+		"canary"
+	], "Chrome channel", { default: "stable" }).string("userDataDir", "Chrome profile directory").query().openWorld()),
+	tool("browser_select_tab", (t) => t.desc("Switch active tab.").number("index", "Tab index").string("urlPattern", "URL substring match").string("titlePattern", "Title substring match").idempotent()),
+	tool("framework_state_extract", (t) => t.desc("Extract framework component state.").enum("framework", [
+		"auto",
+		"react",
+		"vue2",
+		"vue3",
+		"svelte",
+		"solid",
+		"preact"
+	], "Framework", { default: "auto" }).string("selector", "Root element CSS selector").number("maxDepth", "Max traversal depth", { default: 5 }).query().openWorld()),
+	tool("indexeddb_dump", (t) => t.desc("Dump IndexedDB contents.").string("database", "Database name").string("store", "Object store name").number("maxRecords", "Max records per store", { default: 100 }).query()),
+	tool("camoufox_geolocation", (t) => t.desc("Get geolocation for a locale.").string("locale", "Locale string").string("proxy", "Proxy URL for IP lookup").required("locale").query())
+];
+//#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",
+		"ease-in",
+		"ease-out"
+	], "Speed curve", { default: "ease" }).boolean("click", "Click at destination", { default: false }).openWorld()),
+	tool("human_scroll", (t) => t.desc("Scroll with human-like speed variation.").number("distance", "Distance px", { default: 500 }).enum("direction", [
+		"up",
+		"down",
+		"left",
+		"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 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 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"
+	], "Solving mode").string("provider", "External solver provider").string("apiKey", "API key").number("timeoutMs", "Timeout ms", { default: 12e4 }).boolean("injectToken", "Auto-inject token", { default: true }).openWorld())
+];
+//#endregion
+//#region src/server/domains/browser/definitions.tools.jsdom.ts
+/**
+* jsdom-backed headless DOM tools.
+*
+* Operate on an in-memory JSDOM session (no browser required). Each session
+* is referenced by `sessionId` returned from `browser_jsdom_parse`; sessions
+* auto-expire after 10 minutes of inactivity.
+*/
+const browserJsdomToolDefinitions = [
+	tool("browser_jsdom_parse", (t) => t.desc("Parse HTML into an in-memory JSDOM session. No browser needed.").string("html", "HTML source").string("url", "Document URL").string("contentType", "Content-Type").enum("runScripts", [
+		"none",
+		"outside-only",
+		"dangerously"
+	], "Script execution mode", { default: "none" }).boolean("includeNodeLocations", "Track source offsets", { default: false }).boolean("pretendToBeVisual", "Expose rAF/matchMedia shims", { default: false }).string("referrer", "Referrer URL").number("storageQuotaBytes", "Storage quota bytes", { default: 5e6 }).required("html").query()),
+	tool("browser_jsdom_query", (t) => t.desc("Query a JSDOM session with a CSS selector.").string("sessionId", "Session ID").string("selector", "CSS selector").number("maxResults", "Max matches", { default: 50 }).array("attributes", { type: "string" }, "Attribute whitelist").boolean("includeText", "Include textContent", { default: true }).boolean("includeHtml", "Include outerHTML", { default: false }).boolean("includeLocation", "Include source offsets", { default: false }).required("sessionId", "selector").query()),
+	tool("browser_jsdom_execute", (t) => t.desc("Evaluate JS inside a JSDOM session.").string("sessionId", "Session ID").string("code", "JavaScript code").number("timeoutMs", "Timeout hint ms", { default: 5e3 }).required("sessionId", "code")),
+	tool("browser_jsdom_serialize", (t) => t.desc("Serialize a JSDOM session to HTML.").string("sessionId", "Session ID").string("selector", "CSS selector for a fragment").boolean("pretty", "Pretty-print", { default: false }).required("sessionId").query()),
+	tool("browser_jsdom_cookies", (t) => t.desc("Manage cookies on a JSDOM session. Isolated from the attached browser.").string("sessionId", "Session ID").enum("action", [
+		"get",
+		"set",
+		"clear"
+	], "Action", { default: "get" }).string("url", "URL scope").object("cookie", {
+		name: {
+			type: "string",
+			description: "Name"
+		},
+		value: {
+			type: "string",
+			description: "Value"
+		},
+		domain: {
+			type: "string",
+			description: "Domain"
+		},
+		path: {
+			type: "string",
+			description: "Path"
+		},
+		expires: {
+			type: "string",
+			description: "Expiration"
+		},
+		httpOnly: {
+			type: "boolean",
+			description: "HttpOnly"
+		},
+		secure: {
+			type: "boolean",
+			description: "Secure"
+		},
+		sameSite: {
+			type: "string",
+			description: "SameSite"
+		},
+		raw: {
+			type: "string",
+			description: "Raw Set-Cookie string"
+		}
+	}, "Cookie (action=set)").destructive().requiredOpenWorld("sessionId"))
+];
+//#endregion
+//#region src/server/domains/browser/definitions.tools.ts
+const browserTools = [
+	...browserRuntimeTools,
+	...browserPageCoreTools,
+	...browserPageSystemTools,
+	...browserSecurityStateTools,
+	...behaviorTools,
+	...browserJsdomToolDefinitions
+];
+//#endregion
+export { advancedBrowserToolDefinitions as n, browserTools as t };

package/dist/definitions-BbkvZkiv.mjs

@@ -0,0 +1,96 @@
+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()),
+	tool("debugger_pause", (t) => t.desc("Pause execution at the next statement")),
+	tool("debugger_resume", (t) => t.desc("Resume execution (continue)")),
+	tool("debugger_step", (t) => t.desc("Step execution: into (enter next call), over (skip next call), out (exit current function).").enum("direction", [
+		"into",
+		"over",
+		"out"
+	], "Step direction").required("direction")),
+	tool("breakpoint", (t) => t.desc(`Manage breakpoints: code (line/script), XHR (URL pattern), event listener, event category, and exception breakpoints.
+
+Actions:
+- set: Create a breakpoint. Type determines required params.
+- remove: Remove a breakpoint by ID.
+- list: List active breakpoints of the given type.
+
+Types & params:
+- code: lineNumber (required), scriptId?, columnNumber?, condition?
+- xhr: urlPattern (required for set)
+- event: eventName (required for set), targetName?
+- event_category: category (required for set)
+- exception: state (required for set)`).enum("action", [
+		"set",
+		"remove",
+		"list"
+	], "Breakpoint operation").enum("type", [
+		"code",
+		"xhr",
+		"event",
+		"event_category",
+		"exception"
+	], "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",
+		"websocket"
+	], "Event category (type=event_category)").enum("state", [
+		"none",
+		"uncaught",
+		"all"
+	], "Exception pause state (type=exception)").string("breakpointId", "Breakpoint ID (action=remove)").required("action").idempotent()),
+	tool("get_call_stack", (t) => t.desc("Get the current call stack (only available when paused at a breakpoint)").query()),
+	tool("debugger_evaluate", (t) => t.desc("Evaluate a JavaScript expression. context=\"frame\" evaluates in the current call frame (requires paused state); context=\"global\" evaluates in the global context (no pause required).").enum("context", ["frame", "global"], "Evaluation context", { default: "frame" }).string("expression", "JavaScript expression to evaluate").string("callFrameId", "Call frame ID (for context=frame; from get_call_stack, defaults to current frame)").requiredOpenWorld("expression")),
+	tool("debugger_wait_for_paused", (t) => t.desc("Wait for the debugger to pause (useful after setting breakpoints and triggering code)").number("timeout", "Timeout in milliseconds (default: 30000)", {
+		default: 3e4,
+		minimum: 1e3,
+		maximum: 12e4
+	}).query()),
+	tool("debugger_get_paused_state", (t) => t.desc("Get the current paused state (check if debugger is paused and why)").query()),
+	tool("get_object_properties", (t) => t.desc("Get all properties of an object (when paused, use objectId from variables)").string("objectId", "Object ID (from get_scope_variables)").required("objectId").query()),
+	tool("get_scope_variables_enhanced", (t) => t.desc(`Enhanced scope variable inspection with deep object traversal.`).string("callFrameId", "Call frame ID (from get_call_stack, defaults to current frame)").boolean("includeObjectProperties", "Expand object properties recursively (default: false)", { default: false }).number("maxDepth", "Maximum traversal depth for nested objects (default: 1)", {
+		default: 1,
+		minimum: 1,
+		maximum: 10
+	}).boolean("skipErrors", "Skip properties that throw errors during access (default: true)", { default: true }).query()),
+	tool("debugger_session", (t) => t.desc("Manage debugger sessions. Actions: save (persist current session to file), load (restore session from file/JSON), export (export session as JSON string), list (list saved sessions in ./debugger-sessions/).").enum("action", [
+		"save",
+		"load",
+		"export",
+		"list"
+	], "Session operation").string("filePath", "File path for save/load actions").string("sessionData", "Session JSON string for load action (alternative to filePath)").object("metadata", {}, "Optional metadata for save/export actions").required("action"))
+];
+//#endregion
+//#region src/server/domains/debugger/definitions.tools.advanced.ts
+const DEBUGGER_ADVANCED_TOOLS = [
+	tool("watch", (t) => t.desc(`Manage watch expressions for monitoring variable values during debugging.
+
+Actions:
+- add: Add a watch expression (requires expression)
+- remove: Remove by watchId
+- list: List all watches
+- evaluate_all: Evaluate all enabled watches (optional callFrameId)
+- clear_all: Clear all watches`).enum("action", [
+		"add",
+		"remove",
+		"list",
+		"evaluate_all",
+		"clear_all"
+	], "Watch operation").string("expression", "JavaScript expression to watch (action=add)").string("name", "Friendly name for the watch (action=add)").string("watchId", "Watch expression ID (action=remove)").string("callFrameId", "Call frame ID (action=evaluate_all)").required("action")),
+	tool("blackbox_add", (t) => t.desc(`Blackbox scripts (skip during debugging)
+
+Usage:
+- Skip third-party library c...`).string("urlPattern", "URL pattern to blackbox (supports wildcards *)").required("urlPattern").idempotent()),
+	tool("blackbox_add_common", (t) => t.desc(`Blackbox all common libraries (one-click)
+
+Includes:
+- jquery, react, vue, an...`).idempotent()),
+	tool("blackbox_list", (t) => t.desc("List all blackboxed patterns").query())
+];
+//#endregion
+//#region src/server/domains/debugger/definitions.tools.ts
+const debuggerTools = [...DEBUGGER_CORE_TOOLS, ...DEBUGGER_ADVANCED_TOOLS];
+//#endregion
+export { debuggerTools as t };

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-C1gCHO0i.mjs

@@ -0,0 +1,43 @@
+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",
+	"get_data",
+	"list",
+	"clear",
+	"toggle",
+	"export"
+], "Operation to perform").string("hookId", "Hook identifier (required for inject/get_data/toggle; optional for clear/export)").string("code", "Hook code to inject (required for action=inject)").enum("method", ["evaluateOnNewDocument", "evaluate"], "Injection method (for action=inject)", { default: "evaluate" }).boolean("enabled", "Enable or disable hook (required for action=toggle)").enum("format", ["json", "csv"], "Export format (for action=export)", { default: "json" }).required("action"))];
+const hookPresetTools = [tool("hook_preset", (t) => t.desc("Install a pre-built JavaScript hook from 20+ built-in presets (eval, atob/btoa, Proxy, Reflect, Object.defineProperty, etc.), or provide customTemplate/customTemplates to install your own reusable hook bodies. Use listPresets=true to see all available preset descriptions.").string("preset", "Single preset name to install. Accepts built-in preset ids or ids provided by customTemplate/customTemplates.").array("presets", { type: "string" }, "List of preset names to install simultaneously. Accepts built-in ids and custom template ids.").prop("customTemplate", {
+	type: "object",
+	properties: {
+		id: {
+			type: "string",
+			description: "Stable preset id, for example deobfuscation-sinks"
+		},
+		description: {
+			type: "string",
+			description: "Human-readable description for listPresets output."
+		},
+		body: {
+			type: "string",
+			description: "Hook body snippet inserted into the preset wrapper."
+		}
+	},
+	required: ["id", "body"],
+	description: "Inline custom template. body should contain the hook body inserted into the standard buildHookCode wrapper. Use {{STACK_CODE}} and {{LOG_FN}} placeholders when needed."
+}).prop("customTemplates", {
+	type: "array",
+	items: {
+		type: "object",
+		properties: {
+			id: { type: "string" },
+			description: { type: "string" },
+			body: { type: "string" }
+		},
+		required: ["id", "body"]
+	},
+	description: "List of inline custom templates to register for this invocation."
+}).boolean("captureStack", "Include call stack in captured data (has performance impact)", { default: false }).boolean("logToConsole", "Log hook events to browser console", { default: true }).enum("method", ["evaluate", "evaluateOnNewDocument"], "Injection method: evaluate=current page, evaluateOnNewDocument=before page scripts", { default: "evaluate" }).boolean("listPresets", "Set to true to list all available presets with descriptions instead of installing.", { default: false }))];
+//#endregion
+export { hookPresetTools as n, aiHookTools as t };