import { type NodeFileSystem } from './filesystem.js';
import type { InstallPlan, LifecycleResult } from './types.js';
export type InstallerFaultPhase = 'after-lock' | 'after-header' | 'after-intent' | 'after-temp-sync' | 'before-rename' | 'after-rename' | 'after-operation' | 'after-applied' | 'after-verification' | 'after-ledger' | 'before-commit' | 'after-commit' | 'recovery-started' | 'before-recovery-operation' | 'after-recovery-read' | 'before-ledger-mutation' | 'after-ledger-claim' | 'after-ledger-mutation' | 'after-terminal-observation' | 'after-restored';
export interface InstallerCoordinatorOptions {
    readonly filesystem: NodeFileSystem;
    readonly environment?: Readonly<NodeJS.ProcessEnv>;
    readonly lockTimeoutMs?: number;
    readonly fault?: (phase: InstallerFaultPhase, operationIndex?: number) => void | Promise<void>;
}
export declare class InstallerCoordinator {
    #private;
    constructor(options: InstallerCoordinatorOptions);
    apply(candidate: InstallPlan): Promise<LifecycleResult>;
    recover(location: string): Promise<LifecycleResult | null>;
    doctor(location: string): Promise<import("./doctor.js").DoctorReport>;
}
export declare function buildPlanDigest(plan: Omit<InstallPlan, 'planDigest' | 'transactionId'>): string;
export declare function newTransactionId(): string;