export type BundleDropErrorCode = 'CHECK_FAILED' | 'RESOLVE_FAILED' | 'INCOMPATIBLE_BINARY' | 'NO_UPDATE' | 'DOWNLOAD_URL_MISSING' | 'DOWNLOAD_FAILED' | 'INSTALL_FAILED' | 'HASH_MISSING' | 'APPLY_NO_BUNDLE' | 'APPLY_ALREADY_APPLIED' | 'APPLY_FAILED' | 'UNKNOWN';
export type BundleDropErrorStep = 'check' | 'resolve' | 'resolveDownloadUrl' | 'download' | 'install' | 'persist' | 'apply';
/**
 * Structured error thrown by BundleDrop runtime flows.
 */
export declare class BundleDropError extends Error {
    /** Stable machine-readable error code. */
    code: BundleDropErrorCode;
    /** Runtime step where the error occurred. */
    step: BundleDropErrorStep;
    /** Optional diagnostic context for logs or support tooling. */
    context?: Record<string, any>;
    /** Original error or value that caused this error, when available. */
    cause?: unknown;
    /**
     * Create a structured BundleDrop runtime error.
     */
    constructor(args: {
        /** Human-readable error message. */
        message: string;
        /** Stable machine-readable error code. */
        code: BundleDropErrorCode;
        /** Runtime step where the error occurred. */
        step: BundleDropErrorStep;
        /** Optional diagnostic context for logs or support tooling. */
        context?: Record<string, any>;
        /** Original error or value that caused this error, when available. */
        cause?: unknown;
    });
}
/**
 * Type guard for `BundleDropError`.
 */
export declare function isBundleDropError(e: unknown): e is BundleDropError;
export type InstallPhase = 'download' | 'install';
export declare class InstallPhaseError extends Error {
    phase: InstallPhase;
    originalCause: unknown;
    constructor(phase: InstallPhase, cause: unknown);
}
export declare function isInstallPhaseError(e: unknown): e is InstallPhaseError;