rea-agents 6.4.0 → 6.5.0

package/dist/cli-runtime/JavaScriptApplicationWorkflowEvidence-Bz4-V0Ct.js

@@ -0,0 +1,75 @@
+import { __esmMin } from "./rolldown-runtime-DXoylpqc.js";
+import { createEvidence, init_evidence } from "./reconstructionObligationLedgerSchemas-Bao0xMr-.js";
+import { JAVASCRIPT_APPLICATION_WORKFLOW_PROVIDER, init_InvestigationProviders } from "./InvestigationProviders-DoQRIHii.js";
+
+//#region dist/application/javascript/JavaScriptApplicationWorkflowEvidence.js
+var createApplicationFeatureTraceEvidence, createJavaScriptSemanticTraceEvidence, createApplicationVersionComparisonEvidence, createSourceToBundleComparisonEvidence, createJavaScriptExportShapeComparisonEvidence;
+function init_JavaScriptApplicationWorkflowEvidence() {
+	return (init_JavaScriptApplicationWorkflowEvidence = __esmMin((() => {
+		init_evidence();
+		init_InvestigationProviders();
+		createApplicationFeatureTraceEvidence = (parameters, result) => createEvidence(undefined, JAVASCRIPT_APPLICATION_WORKFLOW_PROVIDER, {
+			predicateType: "rea.application-feature-trace",
+			operation: "trace_application_feature",
+			parameters,
+			result,
+			rawResult: null,
+			confidence: "inferred",
+			authority: "analyst-inference",
+			environment: null,
+			limitations: result.limitations,
+			evidenceLinks: result.evidence_links
+		});
+		createJavaScriptSemanticTraceEvidence = (parameters, result) => createEvidence(undefined, JAVASCRIPT_APPLICATION_WORKFLOW_PROVIDER, {
+			predicateType: "rea.javascript-semantic-trace",
+			operation: "trace_javascript_semantics",
+			parameters,
+			result,
+			rawResult: null,
+			confidence: "inferred",
+			authority: "analyst-inference",
+			environment: null,
+			limitations: result.limitations,
+			evidenceLinks: result.evidence_links
+		});
+		createApplicationVersionComparisonEvidence = (parameters, result) => createEvidence(undefined, JAVASCRIPT_APPLICATION_WORKFLOW_PROVIDER, {
+			predicateType: "rea.application-version-comparison",
+			operation: "compare_application_versions",
+			parameters,
+			result,
+			rawResult: null,
+			confidence: "inferred",
+			authority: "analyst-inference",
+			environment: null,
+			limitations: result.limitations,
+			evidenceLinks: result.evidence_links
+		});
+		createSourceToBundleComparisonEvidence = (parameters, result) => createEvidence(undefined, JAVASCRIPT_APPLICATION_WORKFLOW_PROVIDER, {
+			predicateType: "rea.source-to-bundle-comparison",
+			operation: "compare_source_to_bundle",
+			parameters,
+			result,
+			rawResult: null,
+			confidence: "inferred",
+			authority: "analyst-inference",
+			environment: null,
+			limitations: result.limitations,
+			evidenceLinks: result.evidence_links
+		});
+		createJavaScriptExportShapeComparisonEvidence = (parameters, result) => createEvidence(undefined, JAVASCRIPT_APPLICATION_WORKFLOW_PROVIDER, {
+			predicateType: "rea.javascript-export-shape-comparison",
+			operation: "compare_javascript_export_shapes",
+			parameters,
+			result,
+			rawResult: null,
+			confidence: "inferred",
+			authority: "analyst-inference",
+			environment: null,
+			limitations: result.limitations,
+			evidenceLinks: result.evidence_links
+		});
+	})))();
+}
+
+//#endregion
+export { createApplicationFeatureTraceEvidence, createApplicationVersionComparisonEvidence, createJavaScriptExportShapeComparisonEvidence, createJavaScriptSemanticTraceEvidence, createSourceToBundleComparisonEvidence, init_JavaScriptApplicationWorkflowEvidence };

package/dist/cli-runtime/JavaScriptWorkerMemoryLimit-B1bwMM1a.js

@@ -0,0 +1,86 @@
+import { __esmMin } from "./rolldown-runtime-DXoylpqc.js";
+import { init_runtimeVersion, javaScriptRuntime } from "./runtimeVersion-CMGd0bDu.js";
+
+//#region dist/domain/javascript/javascriptModuleSpecifier.js
+var isRelativeJavaScriptModuleSpecifier;
+function init_javascriptModuleSpecifier() {
+	return (init_javascriptModuleSpecifier = __esmMin((() => {
+		isRelativeJavaScriptModuleSpecifier = (value) => value === "." || value === ".." || value.startsWith("./") || value.startsWith("../");
+	})))();
+}
+
+//#endregion
+//#region dist/application/TypeScriptEmittedSourceCandidates.js
+var EMITTED_SUFFIXES, typescriptEmittedSourceCandidates;
+function init_TypeScriptEmittedSourceCandidates() {
+	return (init_TypeScriptEmittedSourceCandidates = __esmMin((() => {
+		EMITTED_SUFFIXES = [
+			[".js", [
+				".ts",
+				".tsx",
+				".d.ts"
+			]],
+			[".mjs", [".mts", ".d.mts"]],
+			[".cjs", [".cts", ".d.cts"]],
+			[".jsx", [".tsx", ".d.ts"]]
+		];
+		typescriptEmittedSourceCandidates = (sourcePath, candidate) => {
+			if (!/\.(?:ts|tsx|mts|cts)$/u.test(sourcePath)) return [];
+			const emitted = EMITTED_SUFFIXES.find(([suffix]) => candidate.endsWith(suffix));
+			if (emitted === undefined) return [];
+			const stem = candidate.slice(0, candidate.length - emitted[0].length);
+			return emitted[1].map((suffix) => ({
+				path: `${stem}${suffix}`,
+				kind: suffix.startsWith(".d.") ? "declaration" : "implementation"
+			}));
+		};
+	})))();
+}
+
+//#endregion
+//#region dist/domain/sourceMapEnvelope.js
+var sourceMapJsonText, isRecord, isVersion3Map, flattenSourceMapLeaves;
+function init_sourceMapEnvelope() {
+	return (init_sourceMapEnvelope = __esmMin((() => {
+		sourceMapJsonText = (text) => {
+			const withoutBom = text.replace(/^\uFEFF/u, "");
+			if (!withoutBom.startsWith(")]}'")) return withoutBom;
+			const newline = withoutBom.search(/[\r\n]/u);
+			return newline === -1 ? "" : withoutBom.slice(newline);
+		};
+		isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+		isVersion3Map = (value) => isRecord(value) && value.version === 3;
+		flattenSourceMapLeaves = (root) => {
+			if (!isVersion3Map(root)) return undefined;
+			const leaves = [];
+			const pending = [root];
+			while (pending.length > 0) {
+				const map = pending.pop();
+				if (!isVersion3Map(map)) return undefined;
+				if (Array.isArray(map.sections)) {
+					for (let index = map.sections.length - 1; index >= 0; index -= 1) {
+						const section = map.sections[index];
+						if (!isRecord(section) || !isRecord(section.map)) return undefined;
+						pending.push(section.map);
+					}
+				} else leaves.push(map);
+			}
+			return leaves;
+		};
+	})))();
+}
+
+//#endregion
+//#region dist/process/JavaScriptWorkerMemoryLimit.js
+var MIB, BUN_WORKER_RUNTIME_RESERVE_BYTES, javaScriptWorkerMemoryLimitBytes;
+function init_JavaScriptWorkerMemoryLimit() {
+	return (init_JavaScriptWorkerMemoryLimit = __esmMin((() => {
+		init_runtimeVersion();
+		MIB = 1024 * 1024;
+		BUN_WORKER_RUNTIME_RESERVE_BYTES = 512 * MIB;
+		javaScriptWorkerMemoryLimitBytes = (heapBudgetMiB, host = process) => host.platform === "win32" && javaScriptRuntime(host.versions).id === "bun" ? heapBudgetMiB * MIB + BUN_WORKER_RUNTIME_RESERVE_BYTES : null;
+	})))();
+}
+
+//#endregion
+export { flattenSourceMapLeaves, init_JavaScriptWorkerMemoryLimit, init_TypeScriptEmittedSourceCandidates, init_javascriptModuleSpecifier, init_sourceMapEnvelope, isRelativeJavaScriptModuleSpecifier, javaScriptWorkerMemoryLimitBytes, sourceMapJsonText, typescriptEmittedSourceCandidates };

package/dist/cli-runtime/JebMcpEndpoint-DUytrn5G.js

@@ -0,0 +1,428 @@
+import { __esmMin } from "./rolldown-runtime-DXoylpqc.js";
+import { err, init_result, init_urlComponents, ok, urlDeclaresQueryOrFragment } from "./reconstructionObligationLedgerSchemas-Bao0xMr-.js";
+import { AnalysisCapabilityUnavailableError, AnalysisInputError, init_analysisErrorCore } from "./errorSchemas-CTRmvMl3.js";
+import { init_WindowsNativeLoader, systemWindowsNativeAuthority } from "./snapshotEnvironment-D_tWyOub.js";
+import { execFileOutput, execFileOutputFailure, init_ExecFileOutput } from "./ExecFileOutput-BEQs-lDD.js";
+import { init_WindowsAuthority, inspectWindowsNativeReadiness } from "./PrivateRuntimeRoot-DAy0PiBM.js";
+import { ZipArtifactReader, init_ZipArtifactReader } from "./ZipArtifactReader-B8ZgNe4D.js";
+import { delimiter, isAbsolute, join, resolve } from "node:path";
+import { access, realpath, stat } from "node:fs/promises";
+import { constants } from "node:fs";
+
+//#region dist/android/JadxRelease.js
+var JADX_RELEASE, JADX_BRIDGE_IDENTITY, JADX_JAR_CONFIGURATION_REMEDIATION, JADX_JAVA_RUNTIME_REMEDIATION, JADX_JVM_OPTIONS_REMEDIATION, JADX_UNSUPPORTED_HOST_REMEDIATION, JADX_WINDOWS_NATIVE_REMEDIATION, JADX_JAVA_PROBE_REMEDIATION, JADX_PROVIDER_IDENTITY, JADX_LIMITATIONS;
+function init_JadxRelease() {
+	return (init_JadxRelease = __esmMin((() => {
+		JADX_RELEASE = Object.freeze({
+			version: "0.7.1",
+			revision: "5844800a486d2248fa949b74c9896285f5b54de2",
+			sha256: "6e5eacf500b64292bfb73c49797c1958f6ee44646e43e868039ae7feb573ff75",
+			url: "https://github.com/1013503897/jadx-headless-mcp/releases/download/v0.7.1/jadx-headless-mcp-0.7.1-all.jar"
+		});
+		JADX_BRIDGE_IDENTITY = Object.freeze({
+			name: "rea-jadx-bridge",
+			version: "1"
+		});
+		JADX_JAR_CONFIGURATION_REMEDIATION = `Set REA_JADX_MCP_JAR to the absolute path of a caller-supplied jadx-headless-mcp ${JADX_RELEASE.version} JAR. REA does not download or install it.`;
+		JADX_JAVA_RUNTIME_REMEDIATION = "Select a full JDK including jdk.compiler via JAVA_HOME or PATH, then verify it with java --list-modules. REA does not install Java.";
+		JADX_JVM_OPTIONS_REMEDIATION = "Set REA_JADX_HEAP_MIB to a positive integer (heap size in MiB) and REA_JADX_ACTIVE_PROCESSOR_COUNT to a positive integer within the JVM's signed 32-bit range.";
+		JADX_UNSUPPORTED_HOST_REMEDIATION = "Use Linux, macOS, or Windows x64 with its bundled native controls for Android JADX analysis.";
+		JADX_WINDOWS_NATIVE_REMEDIATION = "Use a matching current Windows x64 REA package with its bundled native controls. The native failure above identifies the failed constraint; Java installation or registration changes cannot enable a missing native backend.";
+		JADX_JAVA_PROBE_REMEDIATION = "Verify the selected Java launcher with java --list-modules: it must start promptly and emit a concise module listing including a parseable java.base version. REA does not install Java.";
+		JADX_PROVIDER_IDENTITY = Object.freeze({
+			id: "jadx",
+			name: "JADX headless",
+			version: JADX_RELEASE.version
+		});
+		JADX_LIMITATIONS = [
+			"Static decompiler observations do not establish runtime behavior; the APK is never executed.",
+			"Method signatures use provider display types; DEX prototypes come from frozen JADX metadata. Display names may be aliases, and overload indices are local to this engine and artifact.",
+			"Class inventories use parsed metadata before code generation, including synthetic members that may be omitted from decompiled source. Source positions remain unknown.",
+			"Incoming reference totals count JADX using nodes. Direct invoke entries within a using method report raw DEX code-unit offsets and method indexes, but coverage is limited to those nodes and directly matched invokes; it does not establish every possible dynamic or reflective call site.",
+			"Manifest summary fields are extracted by the upstream engine; decoded XML is retained for verification. APK signatures, split APKs, native libraries and Android runtime capture are not verified by this provider."
+		];
+	})))();
+}
+
+//#endregion
+//#region dist/android/JadxConfiguration.js
+var JAVA_MODULE_LISTING_TIMEOUT_MS, JAVA_MODULE_LISTING_MAX_OUTPUT_BYTES, JAR_METADATA_READ_MAX_BYTES, JADX_FAILURE_KINDS, projectJadxFailureOutcome, JadxConfigurationFailure, inspectJadxAvailability, resolveJadxConfigurationInputs, validateJadxConfiguration, readJadxConfigurationInputs, validateJadxConfigurationContents, projectConfigurationFailure, requireEngineArchive, requireSupportedHost, resolveJar, resolveJava, requireJavaHomeExecutable, resolveJvmArguments, inspectJavaRuntime, configurationFailure, errorText;
+function init_JadxConfiguration() {
+	return (init_JadxConfiguration = __esmMin((() => {
+		init_WindowsAuthority();
+		init_WindowsNativeLoader();
+		init_analysisErrorCore();
+		init_ZipArtifactReader();
+		init_ExecFileOutput();
+		init_JadxRelease();
+		JAVA_MODULE_LISTING_TIMEOUT_MS = 1e4;
+		JAVA_MODULE_LISTING_MAX_OUTPUT_BYTES = 1024 * 1024;
+		JAR_METADATA_READ_MAX_BYTES = 8 * 1024 * 1024;
+		JADX_FAILURE_KINDS = [
+			"windows_native_artifact",
+			"windows_native_runtime",
+			"java_runtime",
+			"java_home",
+			"jvm_options",
+			"jar",
+			"java_probe",
+			"unsupported_host"
+		];
+		projectJadxFailureOutcome = (kind, configured) => {
+			const drift = configured ? "config_drift" : "missing_analysis_engine";
+			switch (kind) {
+				case "windows_native_artifact": return {
+					remediation: JADX_WINDOWS_NATIVE_REMEDIATION,
+					classification: "missing_dependency"
+				};
+				case "windows_native_runtime": return {
+					remediation: JADX_WINDOWS_NATIVE_REMEDIATION,
+					classification: "runtime_failure"
+				};
+				case "java_runtime": return {
+					remediation: JADX_JAVA_RUNTIME_REMEDIATION,
+					classification: "missing_dependency"
+				};
+				case "java_home": return {
+					remediation: JADX_JAVA_RUNTIME_REMEDIATION,
+					classification: drift
+				};
+				case "jvm_options": return {
+					remediation: JADX_JVM_OPTIONS_REMEDIATION,
+					classification: drift
+				};
+				case "jar": return {
+					remediation: JADX_JAR_CONFIGURATION_REMEDIATION,
+					classification: drift
+				};
+				case "java_probe": return {
+					remediation: JADX_JAVA_PROBE_REMEDIATION,
+					classification: drift
+				};
+				case "unsupported_host": return {
+					remediation: JADX_UNSUPPORTED_HOST_REMEDIATION,
+					classification: "unsupported_host"
+				};
+				case null: return {
+					remediation: JADX_JAR_CONFIGURATION_REMEDIATION,
+					classification: drift
+				};
+			}
+		};
+		JadxConfigurationFailure = class extends Error {
+			code;
+			diagnostics;
+			kind;
+			constructor(code, message, diagnostics, kind, options) {
+				super(message, options);
+				this.code = code;
+				this.diagnostics = diagnostics;
+				this.kind = kind;
+			}
+		};
+		inspectJadxAvailability = async (environment, signal) => {
+			try {
+				const configuration = await readJadxConfigurationInputs(environment, signal);
+				await validateJadxConfigurationContents(configuration, environment, signal);
+				return {
+					status: "available",
+					code: null,
+					reason: null,
+					diagnostics: {
+						configured: true,
+						java_executable: configuration.java,
+						jdk_compiler: true,
+						jar_path: configuration.jar
+					}
+				};
+			} catch (cause) {
+				if (signal?.aborted === true) throw cause;
+				if (cause instanceof JadxConfigurationFailure) return {
+					status: "unavailable",
+					code: cause.code,
+					reason: cause.message,
+					diagnostics: {
+						...cause.diagnostics,
+						failure_kind: cause.kind
+					}
+				};
+				throw cause;
+			}
+		};
+		resolveJadxConfigurationInputs = async (environment, operation, signal) => {
+			try {
+				return await readJadxConfigurationInputs(environment, signal);
+			} catch (cause) {
+				if (signal?.aborted === true) throw cause;
+				if (!(cause instanceof JadxConfigurationFailure)) throw cause;
+				throw projectConfigurationFailure(operation, cause);
+			}
+		};
+		validateJadxConfiguration = async (configuration, environment, operation, signal) => {
+			try {
+				await validateJadxConfigurationContents(configuration, environment, signal);
+			} catch (cause) {
+				if (signal?.aborted === true) throw cause;
+				if (!(cause instanceof JadxConfigurationFailure)) throw cause;
+				throw projectConfigurationFailure(operation, cause);
+			}
+		};
+		readJadxConfigurationInputs = async (environment, signal) => {
+			signal?.throwIfAborted();
+			requireSupportedHost();
+			const jar = await resolveJar(environment);
+			const java = await resolveJava(environment, signal);
+			await requireJavaHomeExecutable(environment.JAVA_HOME, java);
+			signal?.throwIfAborted();
+			return {
+				jar,
+				java,
+				jvmArguments: resolveJvmArguments(environment)
+			};
+		};
+		validateJadxConfigurationContents = async (configuration, environment, signal) => {
+			signal?.throwIfAborted();
+			await inspectJavaRuntime(configuration.java, environment, signal);
+			await requireEngineArchive(configuration.jar, signal);
+		};
+		projectConfigurationFailure = (operation, cause) => {
+			const output = cause.diagnostics;
+			return new AnalysisCapabilityUnavailableError("jadx", operation, cause.message, {
+				cause,
+				userMessage: cause.message,
+				...typeof output.stdout === "string" && typeof output.stderr === "string" ? { capturedOutput: {
+					stdout: output.stdout,
+					stderr: output.stderr,
+					truncated: output.output_truncated === true
+				} } : {}
+			});
+		};
+		requireEngineArchive = async (jar, signal) => {
+			const missing = new Set([
+				"com/atxx/jhmcp/JadxSession.class",
+				"com/atxx/jhmcp/SessionHolder.class",
+				"jadx/api/JadxDecompiler.class",
+				"com/google/gson/Gson.class",
+				"io/modelcontextprotocol/kotlin/sdk/server/Server.class"
+			]);
+			const reader = new ZipArtifactReader(jar, "zip", JAR_METADATA_READ_MAX_BYTES);
+			try {
+				for await (const entry of reader.entries(signal)) {
+					if (entry.kind === "file" && !entry.encrypted) missing.delete(entry.path);
+					if (missing.size === 0) return;
+				}
+			} catch (cause) {
+				if (signal?.aborted === true) throw cause;
+				const reason = cause instanceof Error ? cause.message : String(cause);
+				throw configurationFailure("version_unresolved", `Cannot inspect REA_JADX_MCP_JAR ${jar} as a Java archive: ${reason}. ${JADX_JAR_CONFIGURATION_REMEDIATION}`, {
+					jar_path: jar,
+					phase: "jar-inspection",
+					archive_error: reason,
+					maximum_metadata_read_bytes: JAR_METADATA_READ_MAX_BYTES
+				}, "jar", cause);
+			} finally {
+				await reader.close();
+			}
+			throw configurationFailure("unsupported_version", `REA_JADX_MCP_JAR ${jar} does not contain the required metadata bridge classes: ${[...missing].join(", ")}. ${JADX_JAR_CONFIGURATION_REMEDIATION}`, {
+				jar_path: jar,
+				phase: "jar-inspection",
+				missing_classes: [...missing]
+			}, "jar");
+		};
+		requireSupportedHost = () => {
+			if (process.platform === "linux" || process.platform === "darwin") return;
+			if (process.platform === "win32" && process.arch === "x64") {
+				const loaded = systemWindowsNativeAuthority();
+				if (loaded.available) {
+					if (loaded.authority.inspection.protocolStdin === true) return;
+					throw configurationFailure("runtime_missing", "The bundled Windows native artifact lacks owned protocol stdin; use a matching current Windows x64 REA package.", {
+						platform: process.platform,
+						architecture: process.arch,
+						phase: "process-ownership",
+						owned_protocol_stdin: false
+					}, "windows_native_artifact");
+				}
+				const readiness = inspectWindowsNativeReadiness(process.platform, loaded);
+				throw configurationFailure(readiness.available ? "runtime_unavailable" : readiness.code, readiness.available ? "Windows native readiness disagreed with the native loader result." : readiness.reason, {
+					platform: process.platform,
+					architecture: process.arch,
+					phase: "process-ownership",
+					owned_protocol_stdin: false,
+					...readiness.available ? {} : {
+						failure_stage: readiness.failureStage,
+						remediation: readiness.remediation
+					}
+				}, readiness.available ? "windows_native_runtime" : readiness.code === "unsupported_host" ? "unsupported_host" : readiness.code === "runtime_missing" ? "windows_native_artifact" : "windows_native_runtime");
+			}
+			throw configurationFailure("unsupported_host", `Android JADX subprocess ownership is unsupported on ${process.platform}/${process.arch}; use Linux, macOS, or Windows x64 with its bundled native controls.`, { platform: process.platform }, "unsupported_host");
+		};
+		resolveJar = async (environment) => {
+			const jar = environment.REA_JADX_MCP_JAR;
+			if (jar === undefined || !isAbsolute(jar)) throw configurationFailure("not_configured", JADX_JAR_CONFIGURATION_REMEDIATION, { jar_configured: false }, "jar");
+			try {
+				await access(jar, constants.R_OK);
+				if (!(await stat(jar)).isFile()) throw configurationFailure("executable_missing", `REA_JADX_MCP_JAR is not a regular file: ${jar}`, { jar_path: jar }, "jar");
+				return await realpath(jar);
+			} catch (cause) {
+				if (cause instanceof JadxConfigurationFailure) throw cause;
+				throw configurationFailure("executable_missing", `Cannot read REA_JADX_MCP_JAR ${jar}: ${cause instanceof Error ? cause.message : String(cause)}`, { jar_path: jar }, "jar", cause);
+			}
+		};
+		resolveJava = async (environment, signal) => {
+			const executable = process.platform === "win32" ? "java.exe" : "java";
+			if (environment.JAVA_HOME === undefined) {
+				if (process.platform !== "win32") return executable;
+				const path = Object.entries(environment).find(([key]) => key.toLowerCase() === "path")?.[1] ?? "";
+				for (const directory of [process.cwd(), ...path.split(delimiter)]) {
+					signal?.throwIfAborted();
+					const selected = directory.startsWith("\"") && directory.endsWith("\"") ? directory.slice(1, -1) : directory;
+					const candidate = resolve(selected, executable);
+					try {
+						await access(candidate, constants.R_OK | constants.X_OK);
+						if ((await stat(candidate)).isFile()) return await realpath(candidate);
+					} catch (cause) {
+						if (typeof cause === "object" && cause !== null && "code" in cause && (cause.code === "ENOENT" || cause.code === "ENOTDIR")) continue;
+						throw configurationFailure("runtime_missing", `Cannot inspect selected Java executable ${candidate}: ${errorText(cause)}`, { java_executable: candidate }, "java_runtime", cause);
+					}
+				}
+				throw configurationFailure("runtime_missing", "Cannot find java.exe on the selected Windows PATH. Select a full JDK with JAVA_HOME or PATH, then verify it with java --list-modules. REA does not install Java.", { java_executable: executable }, "java_runtime");
+			}
+			if (isAbsolute(environment.JAVA_HOME)) return join(environment.JAVA_HOME, "bin", executable);
+			throw configurationFailure("open_options_invalid", "JAVA_HOME must select an existing JDK by absolute path; omit it to use java on PATH.", { java_home: environment.JAVA_HOME }, "java_home");
+		};
+		requireJavaHomeExecutable = async (javaHome, java) => {
+			if (javaHome === undefined) return;
+			try {
+				await access(java, constants.R_OK | constants.X_OK);
+				if ((await stat(java)).isFile()) return;
+				throw configurationFailure("runtime_missing", `JAVA_HOME java is not a regular file: ${java}`, { java_executable: java }, "java_runtime");
+			} catch (cause) {
+				if (cause instanceof JadxConfigurationFailure) throw cause;
+				throw configurationFailure("runtime_missing", `Cannot execute JAVA_HOME java ${java}: ${cause instanceof Error ? cause.message : String(cause)}`, { java_executable: java }, "java_runtime", cause);
+			}
+		};
+		resolveJvmArguments = (environment) => {
+			const result = [];
+			for (const [name, prefix, suffix] of [[
+				"REA_JADX_HEAP_MIB",
+				"-Xmx",
+				"m"
+			], [
+				"REA_JADX_ACTIVE_PROCESSOR_COUNT",
+				"-XX:ActiveProcessorCount=",
+				""
+			]]) {
+				const value = environment[name];
+				if (value === undefined) continue;
+				if (!/^[1-9]\d*$/u.test(value) || !Number.isSafeInteger(Number(value))) throw configurationFailure("open_options_invalid", `${name} must be a positive safe integer; received ${value}.`, {
+					setting: name,
+					value
+				}, "jvm_options");
+				if (name === "REA_JADX_ACTIVE_PROCESSOR_COUNT" && Number(value) > 2147483647) throw configurationFailure("open_options_invalid", `${name} exceeds the JVM's signed 32-bit processor-count range.`, {
+					setting: name,
+					value
+				}, "jvm_options");
+				result.push(`${prefix}${value}${suffix}`);
+			}
+			return result;
+		};
+		inspectJavaRuntime = async (java, environment, signal) => {
+			let stdout;
+			let stderr;
+			try {
+				({stdout, stderr} = await execFileOutput(java, ["--list-modules"], {
+					env: { ...environment },
+					timeout: JAVA_MODULE_LISTING_TIMEOUT_MS,
+					maxBuffer: JAVA_MODULE_LISTING_MAX_OUTPUT_BYTES,
+					...signal === undefined ? {} : { signal }
+				}));
+			} catch (cause) {
+				if (signal?.aborted === true) throw cause;
+				const output = execFileOutputFailure(cause);
+				if (output === undefined) throw cause;
+				const diagnostics = {
+					java_executable: java,
+					phase: "module-inspection",
+					exit_code: typeof output.code === "number" ? output.code : null,
+					process_error_code: typeof output.code === "string" ? output.code : null,
+					signal: output.signal,
+					killed: output.killed,
+					stdout: output.stdout,
+					stderr: output.stderr,
+					output_truncated: output.outputTruncated
+				};
+				if (output.outputTruncated) throw configurationFailure("version_unresolved", `The selected Java launcher ${java} exceeded the ${JAVA_MODULE_LISTING_MAX_OUTPUT_BYTES / (1024 * 1024)} MiB output budget while listing modules. REA retained partial output but could not establish compiler or version availability. Inspect the selected launcher for verbose or unbounded output; ` + "java --list-modules should return a concise module listing.", {
+					...diagnostics,
+					failure: "output_limit",
+					output_limit_bytes: JAVA_MODULE_LISTING_MAX_OUTPUT_BYTES
+				}, "java_probe", cause);
+				if (output.killed) throw configurationFailure("version_unresolved", `The selected Java launcher ${java} was terminated or did not finish the module-listing probe within ${JAVA_MODULE_LISTING_TIMEOUT_MS / 1e3} seconds. Inspect the launcher and its startup responsiveness, then verify it returns compiler and version modules with java --list-modules.`, {
+					...diagnostics,
+					failure: "probe_terminated",
+					deadline_ms: JAVA_MODULE_LISTING_TIMEOUT_MS
+				}, "java_probe", cause);
+				throw configurationFailure("runtime_missing", `Cannot inspect selected Java runtime ${java}: ${output.stderr.trim() || errorText(cause)}. Select a full JDK including jdk.compiler via JAVA_HOME or PATH; verify it with java --list-modules.`, diagnostics, "java_runtime", cause);
+			}
+			const compiler = /^jdk\.compiler(?:@|$)/mu.test(stdout);
+			if (!compiler) throw configurationFailure("runtime_missing", `Selected Java runtime ${java} does not provide jdk.compiler. Select a full JDK including jdk.compiler via JAVA_HOME or PATH; verify it with java --list-modules. A JRE cannot compile REA's source bridge.`, {
+				java_executable: java,
+				phase: "module-inspection",
+				jdk_compiler: false,
+				stdout,
+				stderr,
+				output_truncated: false
+			}, "java_runtime");
+			const major = /^java\.base@(\d+)(?:[.+_-]|$)/mu.exec(stdout)?.[1];
+			if (major === undefined) throw configurationFailure("version_unresolved", `The selected Java launcher ${java} did not report a parseable java.base version in its module listing. Inspect the launcher output and verify it with java --list-modules.`, {
+				java_executable: java,
+				phase: "module-inspection",
+				jdk_compiler: true,
+				java_major: null,
+				stdout,
+				stderr,
+				output_truncated: false
+			}, "java_probe");
+			if (Number(major) < 17) throw configurationFailure("unsupported_version", `Selected Java runtime ${java} must be JDK 17 or newer and include jdk.compiler; verify it with java --list-modules.`, {
+				java_executable: java,
+				phase: "module-inspection",
+				jdk_compiler: true,
+				java_major: major ?? null,
+				stdout,
+				stderr,
+				output_truncated: false
+			}, "java_runtime");
+		};
+		configurationFailure = (code, message, diagnostics, kind, cause) => new JadxConfigurationFailure(code, message, diagnostics, kind, cause === undefined ? undefined : { cause });
+		errorText = (cause) => cause instanceof Error ? cause.message : String(cause);
+	})))();
+}
+
+//#endregion
+//#region dist/jeb/JebMcpEndpoint.js
+var DEFAULT_JEB_MCP_ENDPOINT, parseJebMcpEndpoint;
+function init_JebMcpEndpoint() {
+	return (init_JebMcpEndpoint = __esmMin((() => {
+		init_analysisErrorCore();
+		init_result();
+		init_urlComponents();
+		DEFAULT_JEB_MCP_ENDPOINT = "http://127.0.0.1:8425/mcp";
+		parseJebMcpEndpoint = (value) => {
+			const raw = value === undefined || value.length === 0 ? null : value;
+			let url;
+			try {
+				url = new URL(raw ?? "http://127.0.0.1:8425/mcp");
+			} catch {
+				return err(new AnalysisInputError("jeb_mcp_endpoint", { cause: "Expected an absolute http(s) URL" }));
+			}
+			if (url.protocol !== "http:" && url.protocol !== "https:") return err(new AnalysisInputError("jeb_mcp_endpoint", { cause: "Only http and https JEB MCP endpoints are supported" }));
+			if (url.hostname !== "127.0.0.1" && url.hostname !== "[::1]") return err(new AnalysisInputError("jeb_mcp_endpoint", { cause: "JEB MCP endpoint must use a literal loopback host (127.0.0.1 or ::1)" }));
+			if (url.username !== "" || url.password !== "") return err(new AnalysisInputError("jeb_mcp_endpoint", { cause: "Embedding credentials in the JEB MCP endpoint is not supported; configure authentication with the engine" }));
+			if (url.pathname !== "/mcp" && url.pathname !== "/mcp/") return err(new AnalysisInputError("jeb_mcp_endpoint", { cause: "JEB MCP endpoint must use the /mcp route" }));
+			if (urlDeclaresQueryOrFragment(url)) return err(new AnalysisInputError("jeb_mcp_endpoint", { cause: "JEB MCP endpoint query strings and fragments are not supported" }));
+			return ok(url);
+		};
+	})))();
+}
+
+//#endregion
+export { DEFAULT_JEB_MCP_ENDPOINT, JADX_BRIDGE_IDENTITY, JADX_FAILURE_KINDS, JADX_LIMITATIONS, JADX_PROVIDER_IDENTITY, JADX_RELEASE, init_JadxConfiguration, init_JadxRelease, init_JebMcpEndpoint, inspectJadxAvailability, parseJebMcpEndpoint, projectJadxFailureOutcome, resolveJadxConfigurationInputs, validateJadxConfiguration };