import type { DatabaseHandle } from './db.js';
import type { SearchResult } from '../types.js';
/**
 * Insert or replace the 384-dim embedding for `nodeId`. sqlite-vec requires
 * BigInt rowids via better-sqlite3; the vector is packed as a raw Buffer
 * over the Float32Array's backing ArrayBuffer.
 */
export declare function upsertEmbedding(db: DatabaseHandle, nodeId: string, vector: Float32Array): void;
/**
 * kNN search over the embedding table. Returns a SearchResult per hit with
 * a score of `1 - distance` (cosine-like, higher is better) and a short
 * excerpt from the node's content.
 */
export declare function searchVector(db: DatabaseHandle, vector: Float32Array, limit?: number): SearchResult[];
/**
 * Remove the embedding row for `nodeId` if one exists.
 */
export declare function deleteEmbedding(db: DatabaseHandle, nodeId: string): void;