import type { WikiPassage, WikiPageRecord } from "../page-record.js";
import type { AnnEngine, EmbeddingProvider, SemanticCoverageQuery, SemanticCoverageScore, SemanticHit, SemanticIndexDescriptor, SemanticSearchResult, SynchronizableSemanticIndex } from "./types.js";
export declare function semanticIndexFile(wikiRoot: string): string;
export declare class PersistentSemanticIndex implements SynchronizableSemanticIndex {
    private readonly wikiRoot;
    private readonly provider;
    private readonly engine;
    private readonly persistChanges;
    private readonly pages;
    private readonly passages;
    private loaded;
    private loadPromise;
    private generatedAt;
    private mutationQueue;
    private readonly coverageVectorCache;
    constructor(wikiRoot: string, provider: EmbeddingProvider, engine?: AnnEngine, persistChanges?: boolean);
    get descriptor(): SemanticIndexDescriptor;
    private withMutation;
    private load;
    private removePageInMemory;
    private applyPreparedPage;
    private persist;
    private embedPreparedPages;
    upsertPassages(pagePath: string, passages: WikiPassage[]): Promise<void>;
    removePage(pagePath: string): Promise<void>;
    synchronize(records: readonly WikiPageRecord[]): Promise<{
        reusedPages: number;
        embeddedPages: number;
        removedPages: number;
        embeddedPassages: number;
    }>;
    searchWithDiagnostics(query: string, k: number): Promise<SemanticSearchResult>;
    search(query: string, k: number): Promise<SemanticHit[]>;
    assessCoverage(queries: readonly SemanticCoverageQuery[], pagePaths: readonly string[]): Promise<SemanticCoverageScore[]>;
}
export declare function configuredSemanticIndex(wikiRoot: string, options?: {
    persist?: boolean;
}): Promise<SynchronizableSemanticIndex | null>;
export declare function clearSemanticIndexes(): void;
//# sourceMappingURL=index.d.ts.map