Files
rea/src/hopper/HopperDiagnostics.ts
T
morlutoandGitHub 735c10059c refactor(domain): split error taxonomy into thematic modules (#636)
Move each error family out of domain/errors.ts into its own module
(base, core, provider selection/adapter, browser observation,
artifact, evidence, unknown registry, hopper, configuration) and
relocate AnalysisErrorProjection to analysisErrorProjection.
Migrate all 162 importers to the owning modules and delete
errors.ts. No re-export shims; behavior is unchanged.
2026-10-06 05:57:38 +08:00

49 lines
1.8 KiB
TypeScript

import type { HopperDiagnosticType } from "../domain/hopperErrors.js";
import type { ProcessCleanupResult } from "../process/ProcessOwnership.js";
import type {
ProviderProcessLaunch,
ProviderProcessStopResult,
} from "../process/ProviderProcess.js";
/** Sanitized Hopper launcher and owned-shutdown telemetry. */
export type HopperDiagnostic =
| { readonly type: "launcher-stderr"; readonly bytes: number }
| { readonly type: "launcher-exit"; readonly code: number | null }
| {
readonly type: "bridge-diagnostic";
readonly request_id: number;
readonly code: number;
readonly category: HopperDiagnosticType;
readonly message: string;
}
| {
readonly type: "owned-shutdown";
readonly status: ProviderProcessStopResult["status"];
readonly launcher_pid: number | null;
readonly process_group_id: number | null;
readonly cleanup_signaled: boolean | null;
readonly reason: string | null;
};
/** Retain actionable ownership coordinates without exposing the run token. */
export const createOwnedHopperShutdownDiagnostic = (
launch: ProviderProcessLaunch,
stopped: ProviderProcessStopResult,
cleanup: ProcessCleanupResult | undefined,
): Extract<HopperDiagnostic, { readonly type: "owned-shutdown" }> => ({
type: "owned-shutdown",
status: stopped.status,
launcher_pid: launch.ownership?.leaderPid ?? launch.process.pid ?? null,
process_group_id: launch.ownership?.processGroupId ?? null,
cleanup_signaled: cleanup?.cleaned === true ? cleanup.signaled : null,
reason: stopped.status === "incomplete" ? stopped.reason : null,
});
/** Convert an unexpected cleanup rejection without exposing a stack or token. */
export const providerCleanupFailure = (
_cause: unknown,
): ProcessCleanupResult => ({
cleaned: false,
reason: "owned provider cleanup failed",
});