/**
 * Retrieval facade: executes a plan against the ready index generation and
 * produces addressable, evidence-backed, freshness-labeled results.
 *
 * Results never authorize mutation. Revalidation against current file content
 * hashes must be performed before any mutation planning.
 */
import type { WorkspaceDb } from "./storage.js";
import type { EmbeddingBackend, RetrievalContextPacket, RetrievalPlan, WorkspaceRetrievalResult } from "./types.js";
export interface RetrieveOptions {
    plan: RetrievalPlan;
    generationId?: string;
    embedding?: EmbeddingBackend;
    root?: string;
    freshOnly?: boolean;
    currentFile?: string;
}
export interface RetrievalOutcome {
    packet: RetrievalContextPacket;
    results: WorkspaceRetrievalResult[];
    generationId: string;
}
export declare function executeRetrieval(db: WorkspaceDb, options: RetrieveOptions): RetrievalOutcome;
/** Revalidate a result's content hash against the current file on disk. */
export declare function revalidateResult(result: WorkspaceRetrievalResult, root: string): WorkspaceRetrievalResult["freshness"];
//# sourceMappingURL=retrieve.d.ts.map