import type { ModelChoice, PromptDescriptor, PromptLibrary } from "./prompts.js";
import type { PromptFn } from "./types.js";
/**
 * Rejects explicitly supplied but empty/whitespace-only flag values.
 *
 * An explicit flag always means the user asked for something specific, so an
 * empty value is a mistake rather than a request for the default: it must never
 * fall back to a default, a stored credential or be silently dropped.
 */
export declare function requireNonEmpty(value: string, label: string): string;
export interface ApiKeyStore {
    read(options?: {
        readOnly?: boolean;
    }): Promise<string | null>;
    write(value: string): Promise<void>;
}
export interface EnsureOptionInput<TName extends string = string> {
    value?: string;
    fallback?: string;
    descriptor: PromptDescriptor<TName>;
}
export interface ResolveApiKeyInput {
    value?: string;
    envValue?: string;
    dryRun: boolean;
    assumeYes?: boolean;
    allowStored?: boolean;
}
export interface ResolveModelInput {
    value?: string;
    assumeDefault?: boolean;
    defaultValue: string;
    choices?: ReadonlyArray<ModelChoice>;
    /** Short names accepted on the command line, mapped to their catalog id. */
    aliases?: Readonly<Record<string, string>>;
    /** Set when `choices` is the complete catalog, so unknown ids can be rejected. */
    strictChoices?: boolean;
    label: string;
    onResolve?: (label: string, value: string) => void;
}
export interface ResolveReasoningInput {
    value: string;
    /** Levels the selected model accepts; anything else is rejected. */
    levels: ReadonlyArray<string>;
    label: string;
    onResolve?: (label: string, value: string) => void;
}
export interface OptionResolvers {
    ensure<TName extends string>(input: EnsureOptionInput<TName>): Promise<string>;
    resolveModel(input: ResolveModelInput): Promise<string>;
    resolveReasoning(input: ResolveReasoningInput): Promise<string>;
    resolveConfigName(value: string | undefined, defaultValue: string): Promise<string>;
    resolveApiKey(input: ResolveApiKeyInput): Promise<string>;
}
export interface OptionResolverInit {
    prompts: PromptFn;
    promptLibrary: PromptLibrary;
    apiKeyStore: ApiKeyStore;
    confirm: (message: string) => Promise<boolean>;
    checkAuth: (apiKey: string) => Promise<boolean>;
    loginViaOAuth?: () => Promise<string>;
}
export declare function createOptionResolvers(init: OptionResolverInit): OptionResolvers;