/**
 * Retrieval Configuration for PraisonAI TypeScript SDK.
 *
 * Python parity with praisonaiagents/rag/retrieval_config.py:
 * - RetrievalPolicy enum
 * - CitationsMode enum
 * - RetrievalConfig class
 */
/**
 * Retrieval policy for RAG.
 * Python parity with RetrievalPolicy enum.
 */
export declare const RetrievalPolicy: {
    readonly ALWAYS: "always";
    readonly ON_DEMAND: "on_demand";
    readonly SMART: "smart";
    readonly NEVER: "never";
};
export type RetrievalPolicyType = typeof RetrievalPolicy[keyof typeof RetrievalPolicy];
/**
 * How to handle citations in RAG responses.
 * Python parity with CitationsMode enum.
 */
export declare const CitationsMode: {
    readonly NONE: "none";
    readonly INLINE: "inline";
    readonly FOOTNOTES: "footnotes";
    readonly APPEND: "append";
};
export type CitationsModeType = typeof CitationsMode[keyof typeof CitationsMode];
/**
 * Unified retrieval configuration for Agent-first RAG.
 * Python parity with RetrievalConfig dataclass.
 */
export interface RetrievalConfig {
    policy: RetrievalPolicyType;
    topK: number;
    minScore: number;
    maxContextTokens: number;
    citationsMode: CitationsModeType;
    includeSources: boolean;
    strategy: 'basic' | 'fusion' | 'hybrid';
    rerank: boolean;
    rerankTopK: number;
    queryExpansion: boolean;
    queryRewrite: boolean;
    cacheResults: boolean;
    cacheTtlSeconds: number;
    metadataFilters: Record<string, any>;
    sourceFilters: string[];
    hybridAlpha: number;
    fusionK: number;
    diversityPenalty: number;
}
/**
 * Create a new RetrievalConfig with defaults.
 */
export declare function createRetrievalConfig(partial?: Partial<RetrievalConfig>): RetrievalConfig;
/**
 * Create a simple retrieval config for basic use cases.
 */
export declare function createSimpleRetrievalConfig(topK?: number): RetrievalConfig;
/**
 * Create a smart retrieval config with reranking.
 */
export declare function createSmartRetrievalConfig(topK?: number): RetrievalConfig;