import type { CapsuleSetId, CitationReference, KnowledgeCapsuleId, RetrievalReference } from "@oscharko-dev/keiko-contracts";
import { KnowledgeStoreError } from "../errors.js";
export type RetrievalErrorCode = "EMBEDDING_ADAPTER_FAILED" | "INCOMPATIBLE_EMBEDDING_IDENTITY" | "CAPSULE_NOT_FOUND" | "INVALID_QUERY" | "STORE_READ_FAILED";
export declare class RetrievalError extends KnowledgeStoreError {
    readonly name: string;
    readonly code: RetrievalErrorCode;
    constructor(code: RetrievalErrorCode, message: string, options?: {
        cause?: unknown;
    });
}
export interface RetrievalQuery {
    readonly capsuleSetId?: CapsuleSetId;
    readonly capsuleId?: KnowledgeCapsuleId;
    readonly text: string;
    readonly topK?: number;
    readonly minScore?: number;
}
export type RetrievalNoEvidenceReason = "no-scope" | "no-vectors" | "incompatible-embedding-identity" | "below-min-score" | "answer-grounding-rejected" | "empty-query" | "embedding-failed";
export interface RetrievalResult {
    readonly references: readonly RetrievalReference[];
    readonly noEvidence: boolean;
    readonly reason?: RetrievalNoEvidenceReason;
}
export declare const DEFAULT_RETRIEVAL_TOP_K = 10;
export declare const MAX_RETRIEVAL_TOP_K = 100;
export type { CitationReference, RetrievalReference };
//# sourceMappingURL=types.d.ts.map