069308bbe6
Preserve the primary Hopper startup failure and launcher diagnostics while retaining resources when cleanup cannot be confirmed. Reauthenticate matching external application sessions before document cleanup, keep the Python bridge available for bounded reconnects, and expose the provider-owned Hopper startup deadline. Real headless Linux Hopper semantic analysis and 65 focused configuration, handshake, cleanup, and bridge tests passed. macOS authorization/crash causes and saved-HOP behavior require their own real-provider verification. Refs #1808 Co-authored-by: N0zoM1z0 <161784452+N0zoM1z0@users.noreply.github.com> Co-authored-by: Kaoru0822 <208281322+kaoru0822-kitauji@users.noreply.github.com>
49 lines
1.8 KiB
TypeScript
49 lines
1.8 KiB
TypeScript
import { HopperProtocolError } from "../domain/hopperErrors.js";
|
|
import type { JsonValue } from "../domain/jsonValue.js";
|
|
import { err, ok, type Result } from "../domain/result.js";
|
|
|
|
/** Bound cleanup handshakes and the bridge's idle reconnection wait. */
|
|
export const HOPPER_SHUTDOWN_TIMEOUT_MS = 30_000;
|
|
|
|
/** Authenticated identity returned by the Hopper bridge health handshake. */
|
|
export interface HopperServerInfo {
|
|
readonly name: string;
|
|
readonly version: string;
|
|
}
|
|
|
|
/** Validate the bridge identity and exact per-launch run identifier. */
|
|
export const parseHopperServerInfo = (
|
|
value: JsonValue,
|
|
expectedRunId: string,
|
|
): Result<HopperServerInfo, HopperProtocolError> => {
|
|
if (
|
|
typeof value === "object" &&
|
|
value !== null &&
|
|
!Array.isArray(value) &&
|
|
value.name === "REA Hopper bridge" &&
|
|
typeof value.version === "string" &&
|
|
value.run_id === expectedRunId
|
|
)
|
|
return ok({ name: value.name, version: value.version });
|
|
return err(new HopperProtocolError("Hopper bridge health result is invalid"));
|
|
};
|
|
|
|
/** Require confirmation that the REA bridge detached or its document closed. */
|
|
export const isHopperShutdownAcknowledgement = (value: JsonValue): boolean => {
|
|
if (typeof value !== "object" || value === null || Array.isArray(value))
|
|
return false;
|
|
if (value.shutdown !== true) return false;
|
|
return (
|
|
(value.analysis_stopped === true && value.document_closed === true) ||
|
|
(value.document_closed === false && value.document_retained === true)
|
|
);
|
|
};
|
|
|
|
/** Detect the verified Linux bridge response that requires group cleanup. */
|
|
export const isHopperCleanupRequired = (value: JsonValue): boolean =>
|
|
typeof value === "object" &&
|
|
value !== null &&
|
|
!Array.isArray(value) &&
|
|
value.shutdown === true &&
|
|
value.cleanup_required === true;
|