@jshookmcp/jshook 0.2.9 → 0.3.0

package/dist/{handlers-DxGIq15_2.mjs → handlers-BWXEy6ef.mjs}

@@ -1,4 +1,4 @@
-import { cn as SANDBOX_MEMORY_LIMIT_MB, on as SANDBOX_EXEC_TIMEOUT_MS, sn as SANDBOX_MAX_TIMEOUT_MS } from "./constants-B0OANIBL.mjs";
+import { fn as SANDBOX_EXEC_TIMEOUT_MS, mn as SANDBOX_MEMORY_LIMIT_MB, pn as SANDBOX_MAX_TIMEOUT_MS } from "./constants-CDZLOoVv.mjs";
 import { randomUUID } from "node:crypto";
 import { getQuickJS } from "quickjs-emscripten";
 //#region src/server/sandbox/SandboxHelpers.ts
@@ -358,10 +358,10 @@ var QuickJSSandbox = class {
 		const context = runtime.newContext();
 		const logs = [];
 		try {
-			this._injectConsole(context, logs);
-			this._injectHelpers(context);
-			if (this.bridge) this._injectBridge(context, this.bridge, logs);
-			if (options.globals) this._injectGlobals(context, options.globals);
+			this.injectConsole(context, logs);
+			this.injectHelpers(context);
+			if (this.bridge) this.injectBridge(context, this.bridge, logs);
+			if (options.globals) this.injectGlobals(context, options.globals);
 			const result = context.evalCode(code, "sandbox-eval.js");
 			if (result.error) {
 				const errorMsg = context.dump(result.error);
@@ -433,7 +433,7 @@ var QuickJSSandbox = class {
 				__bridgeRound: round
 			};
 			if (round > 0) roundGlobals.__bridgeResults = bridgeResults;
-			const roundResult = await this._executeOneRound(code, bridge, {
+			const roundResult = await this.executeOneRound(code, bridge, {
 				...options,
 				globals: roundGlobals
 			});
@@ -492,7 +492,7 @@ var QuickJSSandbox = class {
 	* Run a single evaluation round inside a fresh QuickJS runtime.
 	* Used internally by executeWithOrchestration.
 	*/
-	async _executeOneRound(code, bridge, options = {}) {
+	async executeOneRound(code, bridge, options = {}) {
 		const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
 		const memoryLimitBytes = options.memoryLimitBytes ?? DEFAULT_MEMORY_LIMIT_BYTES;
 		const runtime = (await getQuickJS()).newRuntime();
@@ -509,10 +509,10 @@ var QuickJSSandbox = class {
 		const context = runtime.newContext();
 		const logs = [];
 		try {
-			this._injectConsole(context, logs);
-			this._injectHelpers(context);
-			this._injectBridgeForOrchestration(context, bridge, logs);
-			if (options.globals) this._injectGlobals(context, options.globals);
+			this.injectConsole(context, logs);
+			this.injectHelpers(context);
+			this.injectBridgeForOrchestration(context, bridge, logs);
+			if (options.globals) this.injectGlobals(context, options.globals);
 			const result = context.evalCode(code, "sandbox-eval.js");
 			if (result.error) {
 				const errorMsg = context.dump(result.error);
@@ -558,7 +558,7 @@ var QuickJSSandbox = class {
 	* Inject a `console` object into the sandbox whose `log` method
 	* pushes stringified arguments into the captured `logs` array.
 	*/
-	_injectConsole(ctx, logs) {
+	injectConsole(ctx, logs) {
 		const consoleObj = ctx.newObject();
 		const logFn = ctx.newFunction("log", (...args) => {
 			const parts = args.map((a) => {
@@ -577,7 +577,7 @@ var QuickJSSandbox = class {
 	/**
 	* Inject user-supplied global variables into the QuickJS context.
 	*/
-	_injectGlobals(ctx, globals) {
+	injectGlobals(ctx, globals) {
 		for (const [key, value] of Object.entries(globals)) {
 			const handle = marshalToQuickJS(ctx, value);
 			ctx.setProp(ctx.global, key, handle);
@@ -588,7 +588,7 @@ var QuickJSSandbox = class {
 	* Inject pre-built helper libraries (base64, hex, hash, etc.) into the
 	* sandbox global scope by evaluating the helper source code.
 	*/
-	_injectHelpers(ctx) {
+	injectHelpers(ctx) {
 		const result = ctx.evalCode(SANDBOX_HELPER_SOURCE, "sandbox-helpers.js");
 		if (result.error) {
 			ctx.dump(result.error);
@@ -606,7 +606,7 @@ var QuickJSSandbox = class {
 	* For sandbox scripts that need bridge results inline, the host orchestrator
 	* (AutoCorrectionLoop or handler) resolves bridge calls between executions.
 	*/
-	_injectBridge(ctx, bridge, logs) {
+	injectBridge(ctx, bridge, logs) {
 		const mcpObj = ctx.newObject();
 		const callFn = ctx.newFunction("call", (nameHandle, argsHandle) => {
 			const name = ctx.getString(nameHandle);
@@ -635,7 +635,7 @@ var QuickJSSandbox = class {
 	* resolves these calls between rounds and injects results into
 	* `__bridgeResults[callId]`.
 	*/
-	_injectBridgeForOrchestration(ctx, bridge, logs) {
+	injectBridgeForOrchestration(ctx, bridge, logs) {
 		const mcpObj = ctx.newObject();
 		const callFn = ctx.newFunction("call", (nameHandle, argsHandle) => {
 			const name = ctx.getString(nameHandle);

package/dist/{handlers-tB9Mp9ZK.mjs → handlers-Bndn6QvE.mjs}

@@ -1,4 +1,4 @@
-import { n as asJsonResponse, r as asTextResponse } from "./response-BQVP-xUn.mjs";
+import { n as asJsonResponse, r as asTextResponse } from "./response-CWhh2aLo.mjs";
 //#region src/server/domains/evidence/handlers.ts
 /**
 * Evidence domain handlers — delegates to ReverseEvidenceGraph.
@@ -7,6 +7,12 @@ var EvidenceHandlers = class {
 	constructor(graph) {
 		this.graph = graph;
 	}
+	pickStringArg(args, keys) {
+		for (const key of keys) {
+			const value = args[key];
+			if (typeof value === "string" && value.length > 0) return value;
+		}
+	}
 	serializeNodes(nodes) {
 		return nodes.map((node) => ({
 			id: node.id,
@@ -17,9 +23,30 @@ var EvidenceHandlers = class {
 	}
 	handleQueryDispatch(args) {
 		switch (args["by"]) {
-			case "function": return this.handleQueryFunction(args);
-			case "script": return this.handleQueryScript(args);
-			default: return this.handleQueryUrl(args);
+			case "function": return this.handleQueryFunction({
+				...args,
+				name: this.pickStringArg(args, [
+					"name",
+					"value",
+					"query"
+				])
+			});
+			case "script": return this.handleQueryScript({
+				...args,
+				scriptId: this.pickStringArg(args, [
+					"scriptId",
+					"value",
+					"query"
+				])
+			});
+			default: return this.handleQueryUrl({
+				...args,
+				url: this.pickStringArg(args, [
+					"url",
+					"value",
+					"query"
+				])
+			});
 		}
 	}
 	handleExportDispatch(args) {

package/dist/{handlers-CTsDAO6p.mjs → handlers-BqC4bD4s.mjs}

@@ -1,5 +1,5 @@
 import { t as ToolError } from "./ToolError-jh9whhMd.mjs";
-import { a as argString, o as argStringArray, t as argBool } from "./parse-args-BlRjqlkL.mjs";
+import { a as argString, o as argStringArray, t as argBool } from "./parse-args-B4cY5Vx5.mjs";
 //#region src/modules/skia-capture/SkiaSceneExtractor.ts
 function hasEvaluate(value) {
 	if (typeof value !== "object" || value === null || !("evaluate" in value)) return false;

package/dist/{handlers-C87g8oCe.mjs → handlers-BtYq60bM2.mjs}

@@ -1,4 +1,4 @@
-import { a as argString } from "./parse-args-BlRjqlkL.mjs";
+import { a as argString } from "./parse-args-B4cY5Vx5.mjs";
 //#region src/server/domains/instrumentation/handlers.ts
 function jsonResponse(data) {
 	return { content: [{

package/dist/{handlers-DeLOCd5m.mjs → handlers-BzgcB4iv.mjs}

@@ -1,7 +1,7 @@
-import { gr as WEBHOOK_PROCESS_TIMEOUT_MS } from "./constants-B0OANIBL.mjs";
-import { n as asJsonResponse } from "./response-BQVP-xUn.mjs";
-import { i as getProjectRoot, r as getExtensionRegistryDir } from "./outputPaths-B1uGmrWZ.mjs";
-import { a as argString, i as argObject, s as argStringRequired } from "./parse-args-BlRjqlkL.mjs";
+import { kr as WEBHOOK_PROCESS_TIMEOUT_MS } from "./constants-CDZLOoVv.mjs";
+import { n as asJsonResponse } from "./response-CWhh2aLo.mjs";
+import { i as getProjectRoot, r as getExtensionRegistryDir } from "./outputPaths-um7lCRY3.mjs";
+import { a as argString, i as argObject, s as argStringRequired } from "./parse-args-B4cY5Vx5.mjs";
 import http from "node:http";
 import { existsSync, mkdirSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";
@@ -279,7 +279,7 @@ var WebhookBridge = class {
 	}
 	/**
 	* Register an external callback URL for a webhook endpoint.
-	* Used when webhook_create registers an endpoint — the URL is stored
+	* Used when webhook({ action: "create" }) registers an endpoint — the URL is stored
 	* here so emitEvent() can forward events to external callbacks.
 	*/
 	registerExternalCallback(endpointId, url) {
@@ -620,8 +620,8 @@ function isCallable(value) {
 	return typeof value === "function";
 }
 var ExtensionRegistryHandlers = class {
-	_webhookServer;
-	_commandQueue;
+	webhookServer;
+	commandQueue;
 	constructor(registry, webhook) {
 		this.registry = registry;
 		this.webhook = webhook;
@@ -741,21 +741,21 @@ var ExtensionRegistryHandlers = class {
 		});
 	}
 	getWebhookServer() {
-		if (!this._webhookServer) {
-			this._commandQueue = new CommandQueue();
-			this._webhookServer = new WebhookServer({ commandQueue: this._commandQueue });
+		if (!this.webhookServer) {
+			this.commandQueue = new CommandQueue();
+			this.webhookServer = new WebhookServer({ commandQueue: this.commandQueue });
 		}
-		return this._webhookServer;
+		return this.webhookServer;
 	}
 	async startWebhookServer() {
 		const server = this.getWebhookServer();
 		if (!server.isRunning()) server.start();
 	}
 	async stopWebhookServer() {
-		if (this._webhookServer) {
-			await this._webhookServer.stop();
-			this._webhookServer = void 0;
-			this._commandQueue = void 0;
+		if (this.webhookServer) {
+			await this.webhookServer.stop();
+			this.webhookServer = void 0;
+			this.commandQueue = void 0;
 		}
 	}
 	getRegistry() {
@@ -767,8 +767,8 @@ var ExtensionRegistryHandlers = class {
 		return this.webhook;
 	}
 	getCommandQueue() {
-		if (!this._commandQueue) this._commandQueue = new CommandQueue();
-		return this._commandQueue;
+		if (!this.commandQueue) this.commandQueue = new CommandQueue();
+		return this.commandQueue;
 	}
 	emitEvent(event, payload) {
 		this.getWebhook().sendEvent(event, payload).catch(() => void 0);

package/dist/{handlers-Cgyg6c0U.mjs → handlers-CRyRWj2b.mjs}

@@ -1,5 +1,6 @@
-import { dr as UNIDBG_TIMEOUT_MS } from "./constants-B0OANIBL.mjs";
-import { a as invokePlugin, c as FridaSession, i as getAvailablePlugins, n as UnidbgRunner, o as HookCodeGenerator, r as HookGenerator, s as GhidraAnalyzer } from "./binary-instrument-CXfpx6fT.mjs";
+import { xr as UNIDBG_TIMEOUT_MS } from "./constants-CDZLOoVv.mjs";
+import { a as invokePlugin, c as FridaSession, i as getAvailablePlugins, n as UnidbgRunner, o as HookCodeGenerator, r as HookGenerator, s as GhidraAnalyzer } from "./binary-instrument--V3MAhJ4.mjs";
+import { n as capabilityReport, t as capabilityFailure } from "./capabilities-CcHlvWgK.mjs";
 import { access } from "node:fs/promises";
 import { execFile } from "node:child_process";
 //#region src/server/domains/binary-instrument/handlers/shared.ts
@@ -7,6 +8,12 @@ import { execFile } from "node:child_process";
 * Shared types and helpers for binary-instrument sub-handlers.
 */
 const UNIDBG_MAX_BUFFER_BYTES = 8 * 1024 * 1024;
+const LEGACY_PLUGIN_FIXES = {
+	plugin_frida_bridge: "Install @jshookmcpextension/plugin-frida-bridge and reload extensions.",
+	plugin_ghidra_bridge: "Install @jshookmcpextension/plugin-ghidra-bridge and reload extensions.",
+	plugin_ida_bridge: "Install @jshookmcpextension/plugin-ida-bridge and reload extensions.",
+	plugin_jadx_bridge: "Install @jshookmcpextension/plugin-jadx-bridge and reload extensions."
+};
 function textResponse(text) {
 	return { content: [{
 		type: "text",
@@ -46,15 +53,39 @@ function hasInstalledLegacyPlugin(context, pluginId) {
 	if (!(installed instanceof Map)) return void 0;
 	return installed.has(pluginId);
 }
+function getLegacyPluginFix(pluginId) {
+	return LEGACY_PLUGIN_FIXES[pluginId];
+}
+function getLegacyPluginStatus(context, pluginId) {
+	const installed = hasInstalledLegacyPlugin(context, pluginId);
+	if (installed === true) return {
+		status: "available",
+		fix: getLegacyPluginFix(pluginId)
+	};
+	if (installed === false) return {
+		status: "unavailable",
+		reason: `Plugin ${pluginId.replaceAll("_", "-")} is not installed`,
+		fix: getLegacyPluginFix(pluginId)
+	};
+	return {
+		status: "unknown",
+		reason: "Extension plugin registry is not available in the current server context",
+		fix: "Run inside the full MCP server with extension support enabled."
+	};
+}
 async function invokeLegacyPlugin(context, pluginId, toolName, args) {
-	if (!context || hasInstalledLegacyPlugin(context, pluginId) === false) return textResponse(`Plugin ${pluginId.replaceAll("_", "-")} is not installed`);
+	const pluginStatus = getLegacyPluginStatus(context, pluginId);
+	if (!context || pluginStatus.status !== "available") return jsonResponse({
+		...capabilityFailure(toolName, pluginId, pluginStatus.reason ?? `Plugin ${pluginId.replaceAll("_", "-")} is not available`, pluginStatus.fix),
+		status: pluginStatus.status
+	});
 	const result = await invokePlugin(context, {
 		pluginId,
 		toolName,
 		args
 	});
 	if (result.success) return jsonResponse(result);
-	return textResponse(result.error ?? "Plugin invocation failed");
+	return jsonResponse({ ...capabilityFailure(toolName, pluginId, result.error ?? "Plugin invocation failed", pluginStatus.fix) });
 }
 function readHookOptions(args, key) {
 	const raw = args[key];
@@ -179,7 +210,10 @@ var FridaHandlers = class {
 		if (!availability.available) {
 			const sessionId = `mock-frida-${makeMockId(target)}`;
 			return jsonResponse({
+				success: false,
 				available: false,
+				capability: "frida_cli",
+				fix: "Install frida-tools and ensure the frida CLI is on PATH.",
 				target,
 				sessionId,
 				reason: availability.reason ?? "Frida CLI is not available",
@@ -191,13 +225,27 @@ var FridaHandlers = class {
 				}]
 			});
 		}
-		const sessionId = await frida.attach(target);
+		let sessionId;
+		try {
+			sessionId = await frida.attach(target);
+		} catch (error) {
+			return jsonResponse({
+				success: false,
+				available: true,
+				capability: "frida_attach",
+				fix: "Run the server elevated or choose a target process that allows Frida injection.",
+				target,
+				reason: error instanceof Error ? error.message : String(error),
+				sessions: frida.listSessions()
+			});
+		}
 		this.state.context?.eventBus.emit("frida:attached", {
 			target,
 			sessionId,
 			timestamp: (/* @__PURE__ */ new Date()).toISOString()
 		});
 		return jsonResponse({
+			success: true,
 			available: true,
 			target,
 			sessionId,
@@ -210,6 +258,8 @@ var FridaHandlers = class {
 		const availability = await frida.getAvailability();
 		if (!availability.available) return jsonResponse({
 			available: false,
+			capability: "frida_cli",
+			fix: "Install frida-tools and ensure the frida CLI is on PATH.",
 			sessionId,
 			reason: availability.reason ?? "Frida CLI is not available",
 			modules: [{
@@ -221,14 +271,26 @@ var FridaHandlers = class {
 		});
 		if (!frida.useSession(sessionId)) return jsonResponse({
 			available: false,
+			capability: "frida_session",
+			fix: "Call frida_attach first and reuse the returned sessionId.",
 			sessionId,
 			reason: `Unknown Frida session: ${sessionId}`,
 			modules: []
 		});
+		const modules = await frida.enumerateModules();
+		const diagnostics = frida.getSessionDiagnostics(sessionId);
+		if (diagnostics?.status === "error" && diagnostics.lastError) return jsonResponse({
+			success: false,
+			available: true,
+			sessionId,
+			reason: diagnostics.lastError,
+			modules
+		});
 		return jsonResponse({
+			success: true,
 			available: true,
 			sessionId,
-			modules: await frida.enumerateModules()
+			modules
 		});
 	}
 	async handleFridaRunScript(args) {
@@ -239,6 +301,8 @@ var FridaHandlers = class {
 		const availability = await frida.getAvailability();
 		if (!availability.available) return {
 			available: false,
+			capability: "frida_cli",
+			fix: "Install frida-tools and ensure the frida CLI is on PATH.",
 			sessionId,
 			reason: availability.reason ?? "Frida CLI is not available",
 			execution: {
@@ -248,6 +312,8 @@ var FridaHandlers = class {
 		};
 		if (!frida.useSession(sessionId)) return {
 			available: false,
+			capability: "frida_session",
+			fix: "Call frida_attach first and reuse the returned sessionId.",
 			sessionId,
 			reason: `Unknown Frida session: ${sessionId}`,
 			execution: {
@@ -255,11 +321,20 @@ var FridaHandlers = class {
 				error: "Unknown session"
 			}
 		};
-		return {
+		const execution = await frida.executeScript(script);
+		if (execution.error) return jsonResponse({
+			success: false,
 			available: true,
 			sessionId,
-			execution: await frida.executeScript(script)
-		};
+			reason: execution.error,
+			execution
+		});
+		return jsonResponse({
+			success: true,
+			available: true,
+			sessionId,
+			execution
+		});
 	}
 	async handleFridaDetach(args) {
 		const sessionId = readOptionalString(args, "sessionId");
@@ -277,20 +352,28 @@ var FridaHandlers = class {
 		return invokeLegacyPlugin(this.state.context, "plugin_frida_bridge", "frida_detach", args);
 	}
 	async handleFridaListSessions(_args) {
-		if (hasInstalledLegacyPlugin(this.state.context, "plugin_frida_bridge") === false) return textResponse("Plugin plugin-frida-bridge is not installed");
 		const frida = this.getFridaSession();
-		if ((await frida.getAvailability()).available) {
-			const sessions = frida.listSessions();
-			return jsonResponse({
-				success: true,
-				sessions,
-				count: sessions.length
-			});
-		}
+		const availability = await frida.getAvailability();
+		const sessions = frida.listSessions();
+		if (availability.available) return jsonResponse({
+			success: true,
+			available: true,
+			sessions,
+			count: sessions.length
+		});
+		const pluginStatus = getLegacyPluginStatus(this.state.context, "plugin_frida_bridge");
+		if (sessions.length > 0 || pluginStatus.status === "unavailable") return jsonResponse({
+			success: true,
+			available: false,
+			capability: "frida_cli",
+			reason: availability.reason ?? "Frida CLI is not available",
+			fix: "Install frida-tools and ensure the frida CLI is on PATH.",
+			sessions,
+			count: sessions.length
+		});
 		return invokeLegacyPlugin(this.state.context, "plugin_frida_bridge", "frida_list_sessions", _args);
 	}
 	async handleFridaGenerateScript(args) {
-		if (hasInstalledLegacyPlugin(this.state.context, "plugin_frida_bridge") === false) return textResponse("Plugin plugin-frida-bridge is not installed");
 		const target = readOptionalString(args, "target") ?? "unknown";
 		const template = readOptionalString(args, "template") ?? "trace";
 		const functionName = readOptionalString(args, "functionName") ?? "target_function";
@@ -315,6 +398,8 @@ var FridaHandlers = class {
 		const availability = await frida.getAvailability();
 		if (!availability.available) return {
 			available: false,
+			capability: "frida_cli",
+			fix: "Install frida-tools and ensure the frida CLI is on PATH.",
 			sessionId,
 			moduleName,
 			reason: availability.reason ?? "Frida CLI is not available",
@@ -322,18 +407,31 @@ var FridaHandlers = class {
 		};
 		if (!frida.useSession(sessionId)) return {
 			available: false,
+			capability: "frida_session",
+			fix: "Call frida_attach first and reuse the returned sessionId.",
 			sessionId,
 			reason: `Unknown Frida session: ${sessionId}`,
 			functions: []
 		};
 		const functions = await frida.enumerateFunctions(moduleName);
-		return {
+		const diagnostics = frida.getSessionDiagnostics(sessionId);
+		if (diagnostics?.status === "error" && diagnostics.lastError) return jsonResponse({
+			success: false,
 			available: true,
 			sessionId,
 			moduleName,
+			reason: diagnostics.lastError,
 			functions,
 			count: functions.length
-		};
+		});
+		return jsonResponse({
+			success: true,
+			available: true,
+			sessionId,
+			moduleName,
+			functions,
+			count: functions.length
+		});
 	}
 	async handleFridaFindSymbols(args) {
 		const sessionId = readRequiredString(args, "sessionId");
@@ -342,6 +440,8 @@ var FridaHandlers = class {
 		const availability = await frida.getAvailability();
 		if (!availability.available) return {
 			available: false,
+			capability: "frida_cli",
+			fix: "Install frida-tools and ensure the frida CLI is on PATH.",
 			sessionId,
 			pattern,
 			reason: availability.reason ?? "Frida CLI is not available",
@@ -349,18 +449,31 @@ var FridaHandlers = class {
 		};
 		if (!frida.useSession(sessionId)) return {
 			available: false,
+			capability: "frida_session",
+			fix: "Call frida_attach first and reuse the returned sessionId.",
 			sessionId,
 			reason: `Unknown Frida session: ${sessionId}`,
 			symbols: []
 		};
 		const symbols = await frida.findSymbols(pattern);
-		return {
+		const diagnostics = frida.getSessionDiagnostics(sessionId);
+		if (diagnostics?.status === "error" && diagnostics.lastError) return jsonResponse({
+			success: false,
 			available: true,
 			sessionId,
 			pattern,
+			reason: diagnostics.lastError,
 			symbols,
 			count: symbols.length
-		};
+		});
+		return jsonResponse({
+			success: true,
+			available: true,
+			sessionId,
+			pattern,
+			symbols,
+			count: symbols.length
+		});
 	}
 	getFridaSession() {
 		if (!this.state.fridaSession) this.state.fridaSession = new FridaSession();
@@ -387,6 +500,8 @@ var AnalysisHandlers = class {
 		const analysis = await ghidra.analyze(binaryPath, timeout !== void 0 ? { timeout } : void 0);
 		if (!availability.available) return {
 			available: false,
+			capability: "ghidra_headless",
+			fix: "Install Ghidra and ensure analyzeHeadless is on PATH.",
 			binaryPath,
 			reason: availability.reason ?? "Ghidra analyzeHeadless is not available",
 			analysis
@@ -452,6 +567,8 @@ var AnalysisHandlers = class {
 		const availability = await getUnidbgAvailability();
 		if (!availability.available) return {
 			available: false,
+			capability: "unidbg_jar",
+			fix: "Set UNIDBG_JAR to a reachable Unidbg JAR path.",
 			binaryPath,
 			functionName,
 			args: invokeArgs,
@@ -499,6 +616,8 @@ var AnalysisHandlers = class {
 		} catch (error) {
 			return {
 				available: false,
+				capability: "unidbg_jar",
+				fix: "Set UNIDBG_JAR to a reachable Unidbg JAR path and retry.",
 				soPath,
 				arch,
 				reason: error instanceof Error ? error.message : String(error),
@@ -560,6 +679,96 @@ var AnalysisHandlers = class {
 	}
 };
 //#endregion
+//#region src/server/domains/binary-instrument/handlers/capability-handlers.ts
+var CapabilityHandlers = class {
+	constructor(state) {
+		this.state = state;
+	}
+	async handleBinaryInstrumentCapabilities() {
+		const fridaAvailability = await this.getFridaSession().getAvailability();
+		const ghidraAvailability = await this.getGhidraAnalyzer().getAvailability();
+		const unidbgAvailability = await getUnidbgAvailability();
+		return jsonResponse(capabilityReport("binary_instrument_capabilities", [
+			{
+				capability: "frida_cli",
+				status: fridaAvailability.available ? "available" : "unavailable",
+				reason: fridaAvailability.reason,
+				fix: fridaAvailability.available ? void 0 : "Install frida-tools and ensure the frida CLI is on PATH.",
+				details: {
+					tools: [
+						"frida_attach",
+						"frida_enumerate_modules",
+						"frida_run_script",
+						"frida_enumerate_functions",
+						"frida_find_symbols"
+					],
+					...fridaAvailability.path ? { path: fridaAvailability.path } : {},
+					...fridaAvailability.version ? { version: fridaAvailability.version } : {}
+				}
+			},
+			{
+				capability: "plugin_frida_bridge",
+				...getLegacyPluginStatus(this.state.context, "plugin_frida_bridge"),
+				details: { tools: [
+					"frida_attach",
+					"frida_detach",
+					"frida_list_sessions"
+				] }
+			},
+			{
+				capability: "ghidra_headless",
+				status: ghidraAvailability.available ? "available" : "unavailable",
+				reason: ghidraAvailability.reason,
+				fix: ghidraAvailability.available ? void 0 : "Install Ghidra and ensure analyzeHeadless is on PATH.",
+				details: {
+					tools: ["ghidra_analyze"],
+					...ghidraAvailability.path ? { path: ghidraAvailability.path } : {},
+					...ghidraAvailability.version ? { version: ghidraAvailability.version } : {}
+				}
+			},
+			{
+				capability: "plugin_ghidra_bridge",
+				...getLegacyPluginStatus(this.state.context, "plugin_ghidra_bridge"),
+				details: { tools: ["ghidra_decompile"] }
+			},
+			{
+				capability: "plugin_ida_bridge",
+				...getLegacyPluginStatus(this.state.context, "plugin_ida_bridge"),
+				details: { tools: ["ida_decompile"] }
+			},
+			{
+				capability: "plugin_jadx_bridge",
+				...getLegacyPluginStatus(this.state.context, "plugin_jadx_bridge"),
+				details: { tools: ["jadx_decompile"] }
+			},
+			{
+				capability: "unidbg_jar",
+				status: unidbgAvailability.available ? "available" : "unavailable",
+				reason: unidbgAvailability.reason || void 0,
+				fix: unidbgAvailability.available ? void 0 : "Set UNIDBG_JAR to a reachable Unidbg JAR path.",
+				details: {
+					tools: [
+						"unidbg_emulate",
+						"unidbg_launch",
+						"unidbg_call",
+						"unidbg_trace"
+					],
+					command: unidbgAvailability.command,
+					jarPath: unidbgAvailability.jarPath
+				}
+			}
+		]));
+	}
+	getFridaSession() {
+		if (!this.state.fridaSession) this.state.fridaSession = new FridaSession();
+		return this.state.fridaSession;
+	}
+	getGhidraAnalyzer() {
+		if (!this.state.ghidra) this.state.ghidra = new GhidraAnalyzer();
+		return this.state.ghidra;
+	}
+};
+//#endregion
 //#region src/server/domains/binary-instrument/handlers.impl.core.ts
 /**
 * BinaryInstrument domain — composition facade.
@@ -571,6 +780,7 @@ var BinaryInstrumentHandlers = class {
 	state;
 	frida;
 	analysis;
+	capabilities;
 	constructor(first, second, third) {
 		this.state = {
 			hookCodeGenerator: new HookCodeGenerator(),
@@ -582,6 +792,10 @@ var BinaryInstrumentHandlers = class {
 		if (third) this.state.hookGen = third;
 		this.frida = new FridaHandlers(this.state);
 		this.analysis = new AnalysisHandlers(this.state);
+		this.capabilities = new CapabilityHandlers(this.state);
+	}
+	handleBinaryInstrumentCapabilities() {
+		return this.capabilities.handleBinaryInstrumentCapabilities();
 	}
 	handleFridaAttach(args) {
 		return this.frida.handleFridaAttach(args);