rea-agents 6.5.0 → 6.7.0

package/dist/cli-runtime/{Doctor-DIpf_I7N.js → Doctor-DrkWsav4.js}

@@ -1,20 +1,27 @@
 import { __esmMin, __exportAll } from "./rolldown-runtime-DXoylpqc.js";
-import { PRODUCT_IDENTITY, SDK_IDENTITY, init_canonicalOrdering, init_identity, uniqueSorted } from "./reconstructionObligationLedgerSchemas-Bao0xMr-.js";
-import { BinaryTargetError, init_configurationErrors } from "./errorSchemas-CTRmvMl3.js";
-import { ArtifactResourceScope, init_ArtifactResourceScope } from "./ArtifactResourceScope-DQWTcUwE.js";
-import { analysisErrorRemediationAction, init_analysisErrorPresentation } from "./analysisErrorPresentation-DGt7TdsH.js";
-import { execFileOutput, init_ExecFileOutput } from "./ExecFileOutput-BEQs-lDD.js";
-import { homeDirectoryFromEnvironment, init_SupportedClients, init_homeDirectory, manualRegistrationRemediation } from "./SupportedClients-DaX6Lt2d.js";
-import { MAC_HOPPER_SYSTEM_LAUNCHER, init_LinuxHopper, init_MacHopperPaths, linuxHopperBinarySupported, linuxHopperLauncherCandidates, linuxSharedLibrariesAvailable, macHopperApplicationRoots, macHopperCanonicalLauncherCandidates, macHopperRenamedLauncherCandidates, readLinuxDistribution, supportsReaHost, systemLinuxHopperLauncherCandidates } from "./MacHopperPaths-CwL5lYPX.js";
-import { init_BinaryTargetResolver, parseBinaryTarget } from "./BinaryTargetResolver-CVIJ_s1A.js";
+import { PRODUCT_IDENTITY, SDK_IDENTITY, init_canonicalOrdering, init_identity, uniqueSorted } from "./reconstructionObligationLedgerSchemas-Bi6sect1.js";
+import { AnalysisCancelledError, AnalysisError, BinaryTargetError, init_analysisErrorBase, init_analysisErrorCore, init_configurationErrors, init_jsonValue, jsonValueSchema } from "./errorSchemas-Ixz_q7qt.js";
+import { ArtifactReaderFailure, init_ArtifactReader } from "./ArtifactReader-DMwm42bk.js";
+import { AnalysisCleanupLease, init_AnalysisCleanupLease } from "./AnalysisCleanupLease-CWfTGYKd.js";
+import { bindArtifactFileCleanup, init_ArtifactFileOperation } from "./ArtifactFileOperation-Dg4BcoEM.js";
+import { ArtifactResourceScope, init_ArtifactResourceScope } from "./ArtifactResourceScope-CokZGcII.js";
+import { analysisErrorRemediationAction, init_analysisErrorPresentation, init_analysisErrorProjection, projectAnalysisError } from "./cliResultOutput-10sd6xGx.js";
+import { analysisErrorWithCleanupFailure, init_analysisErrorCleanup } from "./analysisErrorCleanup-COdAmDsb.js";
+import { ProviderCleanupError, init_providerCleanupError } from "./providerCleanupError-BhsJyAhk.js";
+import { execFileOutput, init_ExecFileOutput } from "./ExecFileOutput-D6KLYTve.js";
+import { init_SupportedClients, manualRegistrationRemediation } from "./SupportedClients-DMafjitv.js";
+import { homeDirectoryFromEnvironment, init_homeDirectory } from "./homeDirectory-DC_DeJIg.js";
+import { STARTUP_OWNER_CLOSED, init_LinuxHopper, init_SharedStartupAttempt, inspectLinuxHopperLauncher, linuxHopperLauncherCandidates, linuxSharedLibrariesAvailable, readLinuxDistribution, supportsReaHost, systemLinuxHopperLauncherCandidates } from "./SharedStartupAttempt-BxKyf3Uv.js";
+import { MAC_HOPPER_SYSTEM_LAUNCHER, init_MacHopperPaths, macHopperApplicationRoots, macHopperCanonicalLauncherCandidates, macHopperRenamedLauncherCandidates } from "./MacHopperPaths-bGzqjF1Z.js";
+import { init_BinaryTargetResolver, parseBinaryTarget } from "./BinaryTargetResolver-tuCTjBlQ.js";
 import { SUPPORTED_NODE_VERSION_PROSE, init_runtimeVersion, javaScriptRuntime, supportsNodeVersion } from "./runtimeVersion-CMGd0bDu.js";
-import { CATALOG_IDENTITY, init_catalogIdentity } from "./catalogIdentity-DLoXgfIR.js";
-import { init_SetupSkill, readInstalledSkillIdentity } from "./ClientConfigurationDocument-ffQ9X0Se.js";
-import { init_ClientRegistrationStatus, readClientRegistrationStatuses } from "./ClientRegistrationStatus-DszCyPEU.js";
+import { CATALOG_IDENTITY, init_catalogIdentity } from "./catalogIdentity-DAEEsOdX.js";
+import { init_SetupSkill, readInstalledSkillIdentity } from "./ClientConfigurationDocument-C9T8MNGc.js";
+import { init_ClientRegistrationStatus, readClientRegistrationStatuses } from "./ClientRegistrationStatus-PnD29RTX.js";
 import { z } from "zod";
 import { join } from "node:path";
-import { access, readFile, readdir, stat } from "node:fs/promises";
 import { constants } from "node:fs";
+import { access, readFile, readdir, stat } from "node:fs/promises";
 
 //#region dist/application/homebrew.js
 var HOMEBREW_COMMANDS, probeHomebrew, caskDirectoriesSchema, caskConfigSchema, installedCaskAppdir;
@@ -154,10 +161,29 @@ function init_DoctorDiagnostics() {
 		});
 		optionalHopperVersionCheck = async (host, hopperPath) => {
 			if (host.platform !== "linux" || hopperPath === undefined) return undefined;
-			return check("hopper-version", await host.supportedLinuxHopper(hopperPath), hopperPath, {
+			const inspected = await host.inspectLinuxHopper(hopperPath);
+			const buildCheck = check("hopper-version", inspected.ok, hopperPath, {
 				remediation: unsupportedHopperRemediation(host.configuredHopperPath === hopperPath),
-				classification: "config_drift"
+				classification: !inspected.ok && [
+					"release_metadata",
+					"download",
+					"verification_unavailable",
+					"cancelled",
+					"cleanup_failed"
+				].includes(inspected.error.reason) ? "unknown" : "config_drift"
 			});
+			return {
+				...buildCheck,
+				details: inspected.ok ? {
+					reported_release_version: inspected.value.version,
+					launcher_sha256: inspected.value.sha256,
+					primary_fingerprint: inspected.value.primaryFingerprint,
+					source: inspected.value.source
+				} : {
+					reason: inspected.error.reason,
+					message: inspected.error.message
+				}
+			};
 		};
 		optionalHopperDemoCheck = async (host, hopperPath) => host.platform !== "linux" || hopperPath === undefined ? undefined : host.linuxDemoRuntimeCheck();
 		optionalIlspyCheck = async (host) => {
@@ -187,7 +213,7 @@ function init_DoctorDiagnostics() {
 			...candidate.remediation === null ? {} : { remediation: candidate.remediation },
 			...candidate.details === undefined ? {} : { details: candidate.details }
 		}));
-		unsupportedHopperRemediation = (configured) => configured ? "Unset or update HOPPER_LAUNCHER_PATH, install the Hopper build supported by this REA release, or update REA." : "Install the Hopper build supported by this REA release, or update REA for a newer Hopper build.";
+		unsupportedHopperRemediation = (configured) => configured ? "Check HOPPER_LAUNCHER_PATH and its publisher verification evidence. Run rea setup to install and retain an authenticated official Hopper package for offline use." : "Run rea setup to install and retain an authenticated official Hopper package for offline use.";
 		parseMajor = (version) => Number.parseInt(version?.split(".")[0] ?? "0", 10);
 		providerCheckName = (providerId, name) => name === providerId || name.startsWith(`${providerId}-`);
 	})))();
@@ -289,15 +315,25 @@ var Doctor_exports = /* @__PURE__ */ __exportAll({
 	runDoctorOwned: () => runDoctorOwned,
 	systemDoctorHost: () => systemDoctorHost
 });
-var runDoctor, runDoctorOwned, inspectDoctor, closeDoctorHost, doctorReportWithCleanup, collectDoctorIdentity, skillIdentityAligned, skillIdentityState, skillIdentityRemediation, skillIdentityCheck, registrationCheck, installationState, systemDoctorHost, readMacosVersion, executableAvailable, uncomposedLinuxDemoRuntimeCheck, manualHopperPaths, uniqueLines, firstIlspyVersionLine;
+var runDoctor, runDoctorOwned, inspectDoctor, registrationAdvisoryChecks, closeDoctorHost, doctorReportWithCleanup, collectDoctorIdentity, skillIdentityAligned, skillIdentityState, skillIdentityRemediation, skillIdentityCheck, registrationCheck, installationState, systemDoctorHost, readMacosVersion, executableAvailable, uncomposedLinuxDemoRuntimeCheck, manualHopperPaths, uniqueLines, firstIlspyVersionLine;
 function init_Doctor() {
 	return (init_Doctor = __esmMin((() => {
+		init_analysisErrorProjection();
+		init_analysisErrorBase();
+		init_analysisErrorCore();
+		init_providerCleanupError();
+		init_analysisErrorCleanup();
+		init_ArtifactFileOperation();
+		init_ArtifactReader();
+		init_AnalysisCleanupLease();
+		init_SharedStartupAttempt();
 		init_ArtifactResourceScope();
 		init_homeDirectory();
 		init_analysisErrorPresentation();
 		init_configurationErrors();
 		init_BinaryTargetResolver();
 		init_ExecFileOutput();
+		init_jsonValue();
 		init_runtimeVersion();
 		init_homebrew();
 		init_MacHopperPaths();
@@ -315,17 +351,30 @@ function init_Doctor() {
 				report = await inspectDoctor(target, host, requestedScope);
 			} catch (cause) {
 				const cleanup = await closeDoctorHost(host);
-				if (cleanup !== undefined) throw new AggregateError([cause, new Error(cleanup)], "Doctor failed and its resource cleanup remains incomplete.", { cause });
+				if (cleanup !== undefined && cause instanceof AnalysisError) {
+					const cleanupError = typeof cleanup === "string" ? new ProviderCleanupError("rea", [], { reason: cleanup }, { operation: "doctor" }) : cleanup;
+					throw analysisErrorWithCleanupFailure(cause, cleanupError, "doctor").bindCleanupDependencies([cause, cleanupError]);
+				}
+				if (cleanup !== undefined) throw new AggregateError([cause, typeof cleanup === "string" ? new Error(cleanup) : cleanup], "Doctor failed and its resource cleanup remains incomplete.", { cause });
 				throw cause;
 			}
 			const cleanup = await closeDoctorHost(host);
+			if (cleanup === undefined && report.healthy && host.signal?.aborted) throw new AnalysisCancelledError("doctor", {
+				cause: host.signal.reason,
+				diagnostics: { doctor_report: jsonValueSchema.parse(report) }
+			});
 			return cleanup === undefined ? report : doctorReportWithCleanup(report, cleanup);
 		};
 		inspectDoctor = async (target, host, requestedScope) => {
+			if (host.signal?.aborted) throw new AnalysisCancelledError("doctor", { cause: host.signal.reason });
 			const scope = normalizeDoctorScope(requestedScope, target);
 			const { checks: diagnosticChecks, hopperPath, providerInspections } = await collectDoctorDiagnostics(target, host);
 			const identity = await collectDoctorIdentity(host, scope);
-			const checks = [...diagnosticChecks, ...identity.checks];
+			const checks = [
+				...diagnosticChecks,
+				...identity.checks,
+				...registrationAdvisoryChecks(identity.value.registrations)
+			];
 			const providers = {
 				hopperAvailable: hopperPath !== undefined && checks.filter(({ name }) => name.startsWith("hopper")).every(({ ok }) => ok),
 				hopperConfigured: host.configuredHopperPath !== undefined,
@@ -351,19 +400,27 @@ function init_Doctor() {
 				identity: identity.value
 			};
 		};
+		registrationAdvisoryChecks = (registrations) => registrations.flatMap(({ client, advisory }) => advisory === undefined ? [] : [{
+			name: `registration_timeout:${client}`,
+			ok: true,
+			classification: "healthy",
+			detail: advisory
+		}]);
 		closeDoctorHost = async (host) => {
 			try {
 				return await host.close?.();
 			} catch (cause) {
+				if (cause instanceof AnalysisError) return cause;
 				return `Doctor host cleanup failed: ${cause instanceof Error ? cause.message : String(cause)}`;
 			}
 		};
-		doctorReportWithCleanup = (report, detail) => {
+		doctorReportWithCleanup = (report, cleanup) => {
 			const check = {
 				name: "doctor-resource-cleanup",
 				ok: false,
 				classification: "config_drift",
-				detail,
+				detail: typeof cleanup === "string" ? cleanup : `${cleanup.message} ${cleanup.cleanupResources.join(", ")}`,
+				...typeof cleanup === "string" ? {} : { details: { cleanup_failure: projectAnalysisError(cleanup) } },
 				remediation: "Resolve the reported cleanup failure, then rerun rea doctor."
 			};
 			return {
@@ -386,7 +443,10 @@ function init_Doctor() {
 					cli_package_version: PRODUCT_IDENTITY.packageVersion,
 					expected_skill_version: PRODUCT_IDENTITY.skillVersion,
 					sdk: SDK_IDENTITY,
-					catalog: CATALOG_IDENTITY,
+					catalog: {
+						counts: CATALOG_IDENTITY.counts,
+						digests: CATALOG_IDENTITY.digests
+					},
 					live_server: {
 						state: "unknown",
 						remediation: "Call binary_session in the active client to inspect the running server identity."
@@ -437,13 +497,24 @@ function init_Doctor() {
 		installationState = (paths) => paths.length === 0 ? "unknown" : paths.length === 1 ? "single" : "multiple";
 		systemDoctorHost = (options = {}) => {
 			const resources = new ArtifactResourceScope();
+			const controller = new AbortController();
+			const inspectionSignal = options.signal === undefined ? controller.signal : AbortSignal.any([options.signal, controller.signal]);
 			const platform = options.platform ?? process.platform;
 			const architecture = options.architecture ?? process.arch;
 			const environment = options.environment ?? process.env;
 			const hostExecFileOutput = options.execFileOutput ?? execFileOutput;
 			const homeDirectory = homeDirectoryFromEnvironment(environment, platform);
 			const commandEnvironment = { env: environment };
+			const fileCloseResources = {
+				retain: (owner, resource) => resources.retain({
+					kind: "lease",
+					resource,
+					lease: AnalysisCleanupLease.forCloseOwner(owner, resource)
+				}),
+				run: (operation) => resources.run(operation)
+			};
 			return {
+				...options.signal === undefined ? {} : { signal: options.signal },
 				platform,
 				architecture,
 				runtime: javaScriptRuntime(process.versions),
@@ -485,7 +556,7 @@ function init_Doctor() {
 				},
 				executable: (path) => executableAvailable(path, platform, hostExecFileOutput, commandEnvironment),
 				linuxDemoRuntimeCheck: options.linuxDemoRuntimeCheck ?? uncomposedLinuxDemoRuntimeCheck,
-				supportedLinuxHopper: linuxHopperBinarySupported,
+				inspectLinuxHopper: (path) => inspectLinuxHopperLauncher(path, environment),
 				async brewHopperPath() {
 					return probeHomebrew(async (command) => {
 						let caskroom;
@@ -500,8 +571,9 @@ function init_Doctor() {
 					});
 				},
 				manualHopperPaths: () => manualHopperPaths(homeDirectory),
-				...options.providerInspections === undefined ? {} : { providerInspections: options.providerInspections },
+				...options.providerInspections === undefined ? {} : { providerInspections: () => resources.run(() => options.providerInspections(fileCloseResources, inspectionSignal)) },
 				...options.providerRegistrationEnvironment === undefined ? {} : { providerRegistrationEnvironment: options.providerRegistrationEnvironment },
+				...options.resolveProviderRequestBudget === undefined ? {} : { resolveProviderRequestBudget: options.resolveProviderRequestBudget },
 				async ilspyCmdVersion(path) {
 					try {
 						await access(path, constants.X_OK);
@@ -526,17 +598,25 @@ function init_Doctor() {
 				},
 				installedSkillIdentity: (clientIds) => readInstalledSkillIdentity(homeDirectory, clientIds, environment, platform, resources),
 				close: async () => {
+					controller.abort(STARTUP_OWNER_CLOSED);
 					try {
 						await resources.close();
 						return undefined;
 					} catch (cause) {
-						return `Doctor resource cleanup failed: ${cause instanceof Error ? cause.message : String(cause)}`;
+						const observation = ArtifactReaderFailure.cleanupObservation(cause, "doctor resources");
+						const failure = new ProviderCleanupError("rea", observation.resources, { reason: observation.reason }, {
+							cause,
+							operation: "doctor"
+						});
+						bindArtifactFileCleanup(cause, failure);
+						throw failure;
 					}
 				},
 				clientRegistrations: () => readClientRegistrationStatuses(homeDirectory, undefined, {
 					platform,
 					environment,
-					resources
+					resources,
+					...options.resolveProviderRequestBudget === undefined ? {} : { resolveProviderRequestBudget: options.resolveProviderRequestBudget }
 				})
 			};
 		};