import type { Ledger } from "./ledger.js";
export declare function ensureSemanticSchema(ledger: Ledger): void;
/** Cut one settled episode into contextualized chunks. */
export declare function chunkEpisode(ledger: Ledger, episodeId: number): number;
/** Chunk every settled, not-yet-chunked episode. */
export declare function buildPendingChunks(ledger: Ledger, now?: number): number;
/** Embed a few batches of pending chunks. Returns embedded count. */
export declare function embedPendingChunks(ledger: Ledger, opts?: {
    apiKey?: string;
    fetchImpl?: typeof fetch;
    batches?: number;
}): Promise<number>;
export interface SemanticHit {
    chunkId: number;
    episodeId: number;
    firstUtt: number;
    score: number;
    header: string;
    snippet: string;
}
/** Embed the query, dot-product across all embedded chunks, top-k. */
export declare function semanticSearch(ledger: Ledger, query: string, opts?: {
    limit?: number;
    apiKey?: string;
    fetchImpl?: typeof fetch;
}): Promise<SemanticHit[]>;
/** Called from the ingest interval: chunk settled episodes, embed a few batches. */
export declare function semanticTick(ledger: Ledger): Promise<void>;