import type { Config } from '../config/schema.js';
export type BrowserDriverKind = Config['browser']['driver']['kind'];
export type BrowserNotReadyReason = 'extension_not_installed' | 'extension_not_connected' | 'chromium_missing' | 'cdp_unreachable' | 'remote_api_key_missing';
export interface BrowserSetupHint {
    driver: BrowserDriverKind;
    reason: BrowserNotReadyReason;
    detail?: string;
    deepLink: string;
}
export declare class BrowserNotReadyError extends Error {
    readonly hint: BrowserSetupHint;
    constructor(hint: BrowserSetupHint);
}
export declare function buildBrowserSetupDeepLink(driver: BrowserDriverKind): string;
export declare function checkBrowserReadiness(cfg: Config | undefined): Promise<BrowserNotReadyError | null>;