/**
 * Vector storage and deterministic nearest-neighbor retrieval.
 *
 * Default backend is an exact, deterministic cosine-similarity scan over stored
 * vectors. This is ample for workspace-scale bounded candidate sets and is
 * deterministic for tests. A `VectorBackend` interface allows swapping in an ANN
 * implementation without changing retrieval semantics.
 */
import type { WorkspaceDb } from "./storage.js";
export interface VectorRecord {
    chunkId: string;
    contentHash: string;
    modelId: string;
    dimensions: number;
    vector: Float32Array;
}
export interface SemanticHit {
    chunkId: string;
    score: number;
}
export declare class VectorIndex {
    private db;
    constructor(db: WorkspaceDb);
    private serialize;
    private deserialize;
    store(generationId: string, chunkId: string, contentHash: string, modelId: string, dimensions: number, vector: number[]): void;
    delete(generationId: string, chunkId: string, modelId: string): void;
    modelIdentity(generationId: string): {
        modelId: string;
        dimensions: number;
    } | undefined;
    count(generationId: string): number;
    /** Exact cosine nearest-neighbor search (deterministic). */
    search(generationId: string, query: number[], opts?: {
        limit?: number;
        modelId?: string;
        candidateChunkIds?: Set<string>;
    }): SemanticHit[];
}
export declare function serializeVectorIndexBackend(): void;
//# sourceMappingURL=vectors.d.ts.map