/**
 * [Free LLM Router](https://freellmrouter.com/docs): fetch ranked free OpenRouter model IDs.
 * Uses FREE_LLM_ROUTER_API_KEY. Chat calls still go to OpenRouter with OPEN_ROUTER_API_KEY.
 */
export type FreeRouterUseCase = 'chat' | 'vision' | 'tools' | 'longContext' | 'reasoning';
export type FreeRouterSort = 'contextLength' | 'maxOutput' | 'capable' | 'leastIssues' | 'newest';
export type FreeRouterCacheMode = 'default' | 'no-store';
export type FreeRouterTimeRange = '15m' | '30m' | '1h' | '6h' | '24h' | '7d' | '30d' | 'all';
export interface GetModelIdsResult {
    ids: string[];
    requestId?: string;
    count?: number;
}
/** Result of validating a Free LLM Router API key (does not use the model-ID cache). */
export type FreeLlmRouterKeyVerifyResult = {
    ok: true;
} | {
    ok: false;
    reason: 'missing' | 'unauthorized' | 'bad_response' | 'http_error';
    message: string;
};
/**
 * Check whether a Free LLM Router API key is accepted by the service.
 * Uses `GET /models/ids?topN=1` only; does not read or write the in-process model list cache.
 *
 * @param options.apiKey — If omitted, uses `FREE_LLM_ROUTER_API_KEY` from the environment.
 */
export declare function verifyFreeLlmRouterApiKey(options?: {
    apiKey?: string;
}): Promise<FreeLlmRouterKeyVerifyResult>;
/**
 * Returns ranked free model IDs for OpenRouter. In-process cache (~15 minutes) matches
 * [Free LLM Router](https://freellmrouter.com/docs) SDK behavior.
 */
export declare function getModelIds(useCase?: FreeRouterUseCase[], sort?: FreeRouterSort, topN?: number, options?: {
    cache?: FreeRouterCacheMode;
    maxErrorRate?: number;
    timeRange?: FreeRouterTimeRange;
    myReports?: boolean;
}): Promise<GetModelIdsResult>;
/** Fire-and-forget feedback (does not count toward router quota per docs). */
export declare function reportIssue(modelId: string, issue: 'error' | 'rate_limited' | 'unavailable', requestId?: string, details?: string): void;
export declare function reportSuccess(modelId: string, requestId?: string, details?: string): void;
export declare function clearFreeLlmRouterCacheForTests(): void;
//# sourceMappingURL=freeLlmRouter.d.ts.map