import type { KnowledgeCapsuleId, KnowledgeSourceId, RetrievalReference } from "@oscharko-dev/keiko-contracts";
import type { OpenAIEmbeddingAdapter } from "@oscharko-dev/keiko-model-gateway";
import type { ComposedRetrievalScope } from "../composition.js";
import type { KnowledgeStore } from "../store.js";
export interface RetrievalScopeInput {
    readonly capsuleIds: readonly KnowledgeCapsuleId[];
    readonly sourceFilter?: readonly KnowledgeSourceId[];
}
export interface SearchOptions {
    readonly topK: number;
    readonly minScore?: number;
    readonly signal?: AbortSignal;
}
export declare function toScopeInput(scope: ComposedRetrievalScope | {
    readonly capsuleId: KnowledgeCapsuleId;
}): RetrievalScopeInput;
export interface SearchOutcome {
    readonly references: readonly RetrievalReference[];
    readonly noEvidenceReason?: "no-vectors" | "incompatible-embedding-identity" | "below-min-score" | "embedding-failed";
}
export declare function searchVectorsForScope(store: KnowledgeStore, embeddingAdapter: OpenAIEmbeddingAdapter, scope: RetrievalScopeInput, query: string, options: SearchOptions): Promise<SearchOutcome>;
//# sourceMappingURL=scoped-vector-search.d.ts.map