import { type CliFallbackOutcome, type ConnectCheckpoint, type ConnectFailureStage } from './connect-runtime.js';
export type Prompt = (question: string) => Promise<string>;
export declare const SEARCH_RETRY = "tinyfish search query --pretty -- \"<your query>\"";
export declare const DEFAULT_VERIFICATION_QUERY = "today's top Hacker News story";
export declare const MALFORMED_ENV_KEY_MESSAGE = "TINYFISH_API_KEY is set but malformed; it will override any stored key. Fix or unset it, then re-run.";
export declare const MALFORMED_STORED_KEY_MESSAGE = "The stored TinyFish API key is malformed. Run: tinyfish auth login";
interface CliFallbackHooks {
    onStepStart?: (stage: ConnectFailureStage) => void;
    onStepDone?: (phase: ConnectCheckpoint) => void;
}
export interface CliFallbackOptions {
    apiKey?: string;
    verbose: boolean;
    /** Absent means headless: no interactive login, no query prompt. */
    prompt?: Prompt;
    /** Whole-command retry line, per entry point. */
    retryCommand: string;
    /** Absent under --all's zero-harness path, which has no telemetry object. */
    hooks?: CliFallbackHooks;
}
/** One readline per question; a held-open interface wedges raw-stdin children. */
export declare function createStdinPrompt(): Prompt;
/** Steps print retry lines and return outcomes; only interrupts throw. */
export declare function runCliFallback(opts: CliFallbackOptions): Promise<CliFallbackOutcome>;
export {};