/**
 * 向量索引项
 */
export interface VectorItem {
    /** 唯一 ID */
    id: string;
    /** 向量数据 */
    vector: number[];
    /** 关联的元数据 */
    metadata?: Record<string, unknown>;
}
/**
 * 向量检索结果
 */
export interface VectorSearchResult {
    /** 匹配项 */
    item: VectorItem;
    /** 相似度分数（0-1，越高越相关） */
    score: number;
}
/**
 * 向量索引接口 — Core 定义接口，App 可提供 embedding 增强版
 */
export interface VectorIndex {
    /** 构建索引（替换已有数据） */
    build(items: VectorItem[]): Promise<void>;
    /** 添加单个项 */
    add(item: VectorItem): Promise<void>;
    /** 搜索最相似的 topK 个项 */
    search(query: number[], topK?: number): Promise<VectorSearchResult[]>;
    /** 清空索引 */
    clear(): void;
    /** 索引大小 */
    size(): number;
}
/**
 * 内存向量索引 — 纯 JS 余弦相似度实现，零外部依赖
 *
 * 适合中小规模（<10000 项）场景。
 * 大规模场景应由 App 层替换为基于 embedding 的持久化实现。
 */
export declare class InMemoryVectorIndex implements VectorIndex {
    private items;
    build(items: VectorItem[]): Promise<void>;
    add(item: VectorItem): Promise<void>;
    search(query: number[], topK?: number): Promise<VectorSearchResult[]>;
    clear(): void;
    size(): number;
}
//# sourceMappingURL=vector-index.d.ts.map