@jshookmcp/jshook 0.2.9 → 0.3.0

package/dist/{mojo-ipc-B_H61Afw.mjs → mojo-ipc-DXNEXEqb.mjs}

@@ -1,7 +1,8 @@
 import { n as __require } from "./chunk-CjcI7cDX.mjs";
-import { Ht as MOJO_MONITOR_TIMEOUT_MS } from "./constants-B0OANIBL.mjs";
-import { a as argString, r as argNumber } from "./parse-args-BlRjqlkL.mjs";
-import "./manifest-B3QVVeBS.mjs";
+import { Ut as MOJO_MONITOR_TIMEOUT_MS } from "./constants-CDZLOoVv.mjs";
+import { a as argString, r as argNumber } from "./parse-args-B4cY5Vx5.mjs";
+import { n as capabilityReport, t as capabilityFailure } from "./capabilities-CcHlvWgK.mjs";
+import "./manifest-6lNTMZAB2.mjs";
 import { execFile, spawn } from "node:child_process";
 //#region src/modules/mojo-ipc/MojoMonitor.ts
 function getDefaultInterfaces() {
@@ -91,9 +92,11 @@ rpc.exports = {
 var MojoMonitor = class {
 	active = false;
 	simulationMode = false;
+	fridaProbeSucceeded = false;
 	deviceId;
 	messages = [];
 	interfaces = /* @__PURE__ */ new Map();
+	observedInterfaceNames = /* @__PURE__ */ new Set();
 	availability = {
 		available: false,
 		fridaAvailable: false,
@@ -101,7 +104,7 @@ var MojoMonitor = class {
 		reason: "Not yet initialized. Call start() to probe availability."
 	};
 	constructor() {
-		for (const item of getDefaultInterfaces()) this.interfaces.set(item.name, { ...item });
+		this.resetInterfaces();
 	}
 	isAvailable() {
 		return this.availability.available;
@@ -109,9 +112,19 @@ var MojoMonitor = class {
 	getUnavailableReason() {
 		return this.availability.reason;
 	}
+	getAvailabilitySnapshot() {
+		return { ...this.availability };
+	}
+	async probeAvailability() {
+		this.availability = await detectAvailability();
+		return this.getAvailabilitySnapshot();
+	}
 	isSimulationMode() {
 		return this.simulationMode;
 	}
+	didFridaProbeSucceed() {
+		return this.fridaProbeSucceeded;
+	}
 	setSimulationMode(enabled) {
 		this.simulationMode = enabled;
 	}
@@ -124,20 +137,22 @@ var MojoMonitor = class {
 	async start(deviceId) {
 		this.deviceId = deviceId;
 		this.availability = await detectAvailability();
+		this.resetInterfaces();
+		this.simulationMode = false;
+		this.fridaProbeSucceeded = false;
 		if (!this.availability.available) {
 			this.active = false;
 			return;
 		}
 		this.active = true;
-		this.resetPendingCounts();
 		if (this.availability.fridaCliAvailable) await this.captureWithFrida(deviceId);
 		else this.simulationMode = true;
 	}
 	async stop() {
 		this.active = false;
 		this.deviceId = void 0;
-		this.messages.length = 0;
-		this.resetPendingCounts();
+		this.fridaProbeSucceeded = false;
+		this.resetInterfaces();
 	}
 	async captureMessages(filter = {}) {
 		if (!this.active) return [];
@@ -157,12 +172,23 @@ var MojoMonitor = class {
 			pendingMessages: item.pendingMessages
 		})).toSorted((left, right) => left.name.localeCompare(right.name));
 	}
+	hasObservedInterfaces() {
+		return this.observedInterfaceNames.size > 0;
+	}
+	getObservedInterfaceCount() {
+		return this.observedInterfaceNames.size;
+	}
+	getInterfaceCatalogSource() {
+		if (this.observedInterfaceNames.size === 0) return "seeded-defaults";
+		if (this.observedInterfaceNames.size >= this.interfaces.size) return "observed";
+		return "mixed";
+	}
 	async getMessages(options) {
 		if (!this.active) return {
 			messages: [],
 			totalAvailable: 0,
 			filtered: false,
-			_simulation: this.simulationMode
+			simulation: this.simulationMode
 		};
 		const filter = {};
 		if (options?.interfaceName) filter.interfaceName = options.interfaceName;
@@ -172,12 +198,13 @@ var MojoMonitor = class {
 			messages: allMessages.slice(0, limit),
 			totalAvailable: allMessages.length,
 			filtered: !!options?.interfaceName,
-			_simulation: this.simulationMode
+			simulation: this.simulationMode
 		};
 	}
 	recordMessage(message, version = 1) {
 		if (!this.active) return;
 		this.messages.push({ ...message });
+		this.observedInterfaceNames.add(message.interfaceName);
 		const existing = this.interfaces.get(message.interfaceName);
 		if (existing) {
 			existing.pendingMessages += 1;
@@ -205,20 +232,22 @@ var MojoMonitor = class {
 				windowsHide: true
 			}, (error) => {
 				if (error) {
-					this.simulationMode = true;
 					reject(error);
 					return;
 				}
-				this.simulationMode = false;
 				resolve();
 			}).stdin?.end(script);
+		}).then(() => {
+			this.fridaProbeSucceeded = true;
 		}).catch(() => {
-			this.simulationMode = true;
+			this.fridaProbeSucceeded = false;
 		});
+		this.simulationMode = true;
 	}
 	recomputePendingCounts() {
 		this.resetPendingCounts();
 		for (const message of this.messages) {
+			this.observedInterfaceNames.add(message.interfaceName);
 			const item = this.interfaces.get(message.interfaceName);
 			if (item) item.pendingMessages += 1;
 			else this.interfaces.set(message.interfaceName, {
@@ -231,6 +260,12 @@ var MojoMonitor = class {
 	resetPendingCounts() {
 		for (const item of this.interfaces.values()) item.pendingMessages = 0;
 	}
+	resetInterfaces() {
+		this.messages.length = 0;
+		this.interfaces.clear();
+		this.observedInterfaceNames.clear();
+		for (const item of getDefaultInterfaces()) this.interfaces.set(item.name, { ...item });
+	}
 };
 //#endregion
 //#region src/modules/mojo-ipc/MojoDecoder.ts
@@ -417,14 +452,21 @@ var MojoDecoder = class {
 };
 //#endregion
 //#region src/server/domains/mojo-ipc/handlers.impl.ts
-function unavailablePayload(reason, action) {
+function getMojoFix(reason) {
+	return reason.includes("JSHOOK_ENABLE_MOJO_IPC") ? "Unset JSHOOK_ENABLE_MOJO_IPC or set it to 1, then retry." : "Install Frida and ensure the Chromium target is running.";
+}
+function unavailablePayload(reason, tool) {
 	return {
-		success: false,
-		available: false,
-		action,
+		...capabilityFailure(tool, "mojo_ipc_monitoring", reason, getMojoFix(reason)),
 		error: reason
 	};
 }
+const LIVE_CAPTURE_REASON = "Current Mojo IPC backend only exposes a seeded interface catalog and simulated capture. Live Chromium Mojo hooks are not implemented in this build.";
+const LIVE_CAPTURE_FIX = "No user-side fix is available in this build. Treat mojo_monitor/mojo_list_interfaces/mojo_messages_get as simulation-only until real Frida hooks are implemented.";
+function getFridaProbeSucceeded(monitor) {
+	const maybeMonitor = monitor;
+	return typeof maybeMonitor.didFridaProbeSucceed === "function" ? maybeMonitor.didFridaProbeSucceed() : false;
+}
 var MojoIPCHandlers = class {
 	constructor(monitor, decoder, eventBus) {
 		this.monitor = monitor;
@@ -434,17 +476,82 @@ var MojoIPCHandlers = class {
 	async handleMojoMonitorDispatch(args) {
 		return String(args["action"] ?? "") === "stop" ? this.handleMojoMonitorStop() : this.handleMojoMonitorStart(args);
 	}
+	async handleMojoIpcCapabilities() {
+		const monitor = this.getMonitor();
+		const fridaProbeSucceeded = getFridaProbeSucceeded(monitor);
+		const availability = typeof monitor.probeAvailability === "function" ? await monitor.probeAvailability() : {
+			available: monitor.isAvailable(),
+			reason: monitor.getUnavailableReason(),
+			fridaAvailable: monitor.isAvailable(),
+			fridaCliAvailable: false
+		};
+		return capabilityReport("mojo_ipc_capabilities", [
+			{
+				capability: "mojo_ipc_monitoring",
+				status: availability.available ? "available" : "unavailable",
+				reason: availability.reason,
+				fix: availability.available ? void 0 : getMojoFix(availability.reason ?? ""),
+				details: {
+					tools: [
+						"mojo_monitor",
+						"mojo_list_interfaces",
+						"mojo_messages_get"
+					],
+					fridaAvailable: availability.fridaAvailable,
+					fridaCliAvailable: availability.fridaCliAvailable,
+					fridaProbeSucceeded,
+					active: monitor.isActive(),
+					simulationMode: monitor.isSimulationMode(),
+					interfaceCatalogSource: monitor.getInterfaceCatalogSource(),
+					observedInterfaceCount: monitor.getObservedInterfaceCount(),
+					liveCaptureImplemented: false
+				}
+			},
+			{
+				capability: "mojo_live_capture",
+				status: "unavailable",
+				reason: LIVE_CAPTURE_REASON,
+				fix: LIVE_CAPTURE_FIX,
+				details: {
+					tools: [
+						"mojo_monitor",
+						"mojo_list_interfaces",
+						"mojo_messages_get"
+					],
+					fridaAvailable: availability.fridaAvailable,
+					fridaCliAvailable: availability.fridaCliAvailable,
+					fridaProbeSucceeded,
+					active: monitor.isActive(),
+					simulationMode: monitor.isSimulationMode(),
+					interfaceCatalogSource: monitor.getInterfaceCatalogSource(),
+					observedInterfaceCount: monitor.getObservedInterfaceCount(),
+					fallbackMode: availability.available ? "simulation" : "none",
+					liveCaptureImplemented: false
+				}
+			},
+			{
+				capability: "mojo_payload_decode",
+				status: "available",
+				details: { tools: ["mojo_decode_message"] }
+			}
+		]);
+	}
 	async handleMojoMonitorStart(args) {
 		const monitor = this.getMonitor();
-		if (!monitor.isAvailable()) return unavailablePayload(monitor.getUnavailableReason() ?? "Mojo IPC monitoring is not available", "mojo_monitor");
 		const deviceId = argString(args, "deviceId");
 		await monitor.start(deviceId);
-		return {
+		if (!monitor.isAvailable()) return unavailablePayload(monitor.getUnavailableReason() ?? "Mojo IPC monitoring is not available", "mojo_monitor");
+		const response = {
 			success: true,
 			available: true,
 			started: monitor.isActive(),
-			deviceId: monitor.getDeviceId() ?? null
+			deviceId: monitor.getDeviceId() ?? null,
+			simulation: monitor.isSimulationMode(),
+			interfaceCatalogSource: monitor.getInterfaceCatalogSource(),
+			observedInterfaceCount: monitor.getObservedInterfaceCount()
 		};
+		if (monitor.isSimulationMode()) response.warningMessage = "Mojo IPC monitor is running in simulation mode. Real Frida-backed message capture is not active.";
+		return response;
 	}
 	async handleMojoMonitorStop() {
 		const monitor = this.getMonitor();
@@ -453,7 +560,8 @@ var MojoIPCHandlers = class {
 		return {
 			success: true,
 			available: true,
-			started: false
+			started: false,
+			simulation: monitor.isSimulationMode()
 		};
 	}
 	async handleMojoDecodeMessage(args) {
@@ -473,13 +581,18 @@ var MojoIPCHandlers = class {
 			...unavailablePayload(monitor.getUnavailableReason() ?? "Mojo IPC monitoring is not available", "mojo_list_interfaces"),
 			interfaces: []
 		};
-		const interfaces = await monitor.listInterfaces();
-		return {
+		const response = {
 			success: true,
 			available: true,
 			active: monitor.isActive(),
-			interfaces
+			interfaces: await monitor.listInterfaces(),
+			simulation: monitor.isSimulationMode(),
+			interfaceCatalogSource: monitor.getInterfaceCatalogSource(),
+			observedInterfaceCount: monitor.getObservedInterfaceCount()
 		};
+		if (monitor.getInterfaceCatalogSource() === "seeded-defaults") response.warningMessage = "Interface list currently comes from the seeded default catalog; no live observed Mojo interfaces have been captured yet.";
+		else if (monitor.isSimulationMode()) response.warningMessage = "Mojo IPC monitor is running in simulation mode. Interface counts may not reflect live traffic.";
+		return response;
 	}
 	async handleMojoMessagesGet(args) {
 		const monitor = this.getMonitor();
@@ -488,7 +601,7 @@ var MojoIPCHandlers = class {
 			messages: [],
 			totalAvailable: 0,
 			filtered: false,
-			_simulation: true
+			simulation: true
 		};
 		const limit = argNumber(args, "limit");
 		const interfaceName = argString(args, "interface");
@@ -503,13 +616,15 @@ var MojoIPCHandlers = class {
 			messages: result.messages,
 			totalAvailable: result.totalAvailable,
 			filtered: result.filtered,
-			_simulation: result._simulation
+			simulation: result.simulation,
+			interfaceCatalogSource: monitor.getInterfaceCatalogSource(),
+			observedInterfaceCount: monitor.getObservedInterfaceCount()
 		};
 		if (result.messages && Array.isArray(result.messages) && result.messages.length > 0) this.eventBus?.emit("mojo:message_captured", {
 			messageCount: result.messages.length,
 			timestamp: (/* @__PURE__ */ new Date()).toISOString()
 		});
-		if (monitor.isSimulationMode()) response._warning = "Mojo IPC is operating in simulation mode. Messages are not captured from real Frida hooks. Install Frida for live IPC monitoring.";
+		if (monitor.isSimulationMode()) response.warningMessage = "Mojo IPC is operating in simulation mode. Messages are not captured from real Frida hooks. Install Frida for live IPC monitoring.";
 		return response;
 	}
 	getMonitor() {