import type { EmbeddingProvider, EmbeddingScope } from "../types/plugins.js"; export interface EmbeddingCacheOptions { /** Include provider, model, revision and any embedding options. Change on model changes. */ modelKey: string | (() => string); maxEntries?: number; /** Bound digest UTF-16 bytes + vector float64 bytes, not JS heap overhead. */ maxBytes?: number; } /** Opt-in, instance-local LRU. Digests avoid retained plaintext content keys, not secure erasure. */ export declare class CachedEmbeddingProvider implements EmbeddingProvider { private readonly provider; private readonly entries; private readonly secret; private readonly maxEntries; private readonly maxBytes; private readonly modelKey; private bytes; private generation; constructor(provider: EmbeddingProvider, options: EmbeddingCacheOptions); private currentModelKey; /** Release references; already running provider work is not cancelled or securely erased. */ clear(): void; getStats(): { entries: number; accountedBytes: number; }; /** Separate ownership: identical inputs in different scopes never share retained entries. */ createScope(): EmbeddingScope; embed(text: string): Promise; private embedInScope; }