/**
 * Image-presence pre-flight + fail-fast hint.
 *
 * Implements Decision #6 (revised pass 3) — `olam bootstrap` is the
 * SOLE on-ramp; existing commands (`host-cp start`, `auth up`, `create`)
 * do NOT auto-pull on missing image. Instead they fail-fast with a
 * named remedy pointing operators at bootstrap.
 *
 * Why no auto-pull:
 *   - Eliminates ~150 LOC of dual-path maintenance (Phase 2 review's
 *     OQ39 finding).
 *   - Predictable: there's exactly ONE place that can pull images
 *     (`olam bootstrap`), so support questions ("which command pulled
 *     the wrong digest?") have a single answer.
 *   - The hint operators see is the same regardless of which command
 *     they tried — easier to remember.
 */
export interface DockerImageInspectFn {
    (imageRef: string): {
        exitCode: number;
    };
}
export interface RequireImageInput {
    readonly imageRef: string;
    /**
     * The CLI command that's asking. Surfaced in the remedy line so the
     * operator knows which command failed (helps with screenshots).
     */
    readonly callerCommand: string;
}
export interface RequireImageDecision {
    readonly imageRef: string;
    readonly present: boolean;
    /**
     * Empty when present; the named remedy line (stderr) when absent.
     */
    readonly stderrLine: string;
}
export declare function checkImagePresent(input: RequireImageInput, inspect?: DockerImageInspectFn): RequireImageDecision;
//# sourceMappingURL=image-presence.d.ts.map