type CrossEncoder = {
    /** Score a list of (query, doc) pairs. Returns an array of scores aligned to input. */
    scoreBatch(query: string, docs: string[]): Promise<number[]>;
    isReady(): boolean;
};
/**
 * Lazy-load the cross-encoder singleton. Returns null if the model can't be
 * loaded (no network, no model cache, package missing). Subsequent calls
 * after a failure return null immediately — we don't retry.
 */
export declare function getCrossEncoder(modelName?: string): Promise<CrossEncoder | null>;
/**
 * Rerank a list of candidate documents against a query. Returns the input
 * indices reordered by cross-encoder score (descending), each annotated with
 * the calibrated score.
 *
 * If the cross-encoder isn't available, returns the input indices in their
 * original order with score=0 — caller should fall back gracefully.
 */
export declare function crossEncoderRerank(query: string, docs: string[], topK?: number): Promise<Array<{
    index: number;
    score: number;
}>>;
/** Diagnostic — surface whether the model is loaded and any load error. */
export declare function getCrossEncoderStatus(): {
    loaded: boolean;
    attempted: boolean;
    error: string | null;
};
/** Reset singleton (for tests). */
export declare function resetCrossEncoder(): void;
export {};
//# sourceMappingURL=cross-encoder-rerank.d.ts.map