/**
 * AI Provider API Clients
 *
 * HTTP clients for Anthropic, OpenAI, and OpenRouter APIs.
 * Caching happens here - at the HTTP layer where we have access to both prompt and response.
 */
import type { ResponseCache } from '../caching/types';
import type { ClassifierConfig, LlmUsage, Result } from '../types';
/** Result from a provider call including usage data */
interface ProviderResult {
    readonly text: string;
    readonly usage: LlmUsage;
}
interface ProviderCallOptions {
    cache?: ResponseCache | undefined;
    /** Message IDs for cache key generation */
    messageIds?: readonly number[];
    /** Message contents for cache key generation */
    messageContents?: readonly string[];
}
/**
 * Call provider with automatic fallback on rate limit errors.
 * Tries the primary provider first, then each fallback in order.
 *
 * Returns ProviderResult which includes both the text response and usage data.
 */
export declare function callProviderWithFallbacks(prompt: string, config: ClassifierConfig, options?: ProviderCallOptions): Promise<Result<ProviderResult>>;
export {};
//# sourceMappingURL=providers.d.ts.map