import type { ResearchConfig } from '../config/schema.js';
export interface BraveSearchOptions {
    freshness?: string;
    endpoint?: 'web' | 'news';
    extraSnippets?: boolean;
}
export interface BraveSearchResult {
    title: string;
    url: string;
    snippet: string;
    pageAge?: string;
    extraSnippets?: string[];
}
export interface BraveSearchResponse {
    results: BraveSearchResult[];
    keyIndex: number;
    attempts: Array<{
        keyIndex: number;
        status: number | 'error';
    }>;
}
export declare class BraveClient {
    private readonly cfg;
    private nextKeyIndex;
    private lastRequestAt;
    private lockChain;
    private readonly _sleep;
    private readonly _random;
    constructor(cfg: ResearchConfig['brave'], opts?: {
        sleep?: (ms: number) => Promise<void>;
        random?: () => number;
    });
    private takeKeySlot;
    search(query: string, options?: BraveSearchOptions): Promise<BraveSearchResponse>;
}
//# sourceMappingURL=web-search.d.ts.map