import { EvidenceProducerResult, KnowledgeEntry, KnowledgeEvidenceProducerPort, KnowledgeNeed, RetrievalRequestSignatureV1, RetrievalTaskAction, SearchOptions, SemanticExecutionContext } from '@devflow-tools/sdk';
import type { KnowledgeProjectSignals } from './source-selector.js';
export interface KnowledgeSearchOptions extends SearchOptions {
    retrievalIntent?: 'explicit' | 'automatic_context' | 'prefetch';
    budgetTokens?: number;
    projectSignals?: KnowledgeProjectSignals;
    activeSkill?: string;
    relevantFiles?: string[];
    action?: RetrievalTaskAction;
    knowledgeNeeds?: KnowledgeNeed[];
    semanticNeedsResolved?: boolean;
    sessionId?: string;
    executionId?: string;
    requestId?: string;
    turnId?: string;
    intentArtifactHash?: string;
    queryPlanHash?: string;
}
export interface KnowledgeSearchStatus {
    entries: KnowledgeEntry[];
    warnings: string[];
    budgetTokens: number;
    tokenCount: number;
    truncatedCount: number;
    rejectedLowScore?: number;
    rejectedIncompatibleSources?: number;
    retrievalDiagnostics: {
        selectedSources: string[];
        sourceSignals: string[];
        sourceRejections: Array<{
            source: string;
            reason: string;
        }>;
        coverageGaps: Array<{
            sourceId: string;
            kind: string;
            entity?: string;
            symbol?: string;
            reason: string;
        }>;
        compatibleChunks: number;
        hybridCandidates: number;
        qualityRejected: Record<string, number>;
        channelCandidateCounts?: Record<'exact' | 'bm25' | 'entity' | 'manifest' | 'vector', number>;
        vectorStatus?: 'ready' | 'unavailable' | 'not_requested';
        embeddingProfileHash?: string;
        embeddingGeneration?: number;
        graphExpansions?: number;
        abstentionReason?: string;
    };
}
export interface KnowledgeReadOnlySearchPort {
    searchReadOnly(query: string, options?: KnowledgeSearchOptions): Promise<KnowledgeSearchStatus>;
}
export declare class KnowledgeQueryService implements KnowledgeEvidenceProducerPort {
    private readonly backend;
    constructor(backend: KnowledgeReadOnlySearchPort);
    search(query: string, options?: KnowledgeSearchOptions): Promise<KnowledgeSearchStatus>;
    search(context: SemanticExecutionContext, request: RetrievalRequestSignatureV1): Promise<EvidenceProducerResult>;
    private searchEvidence;
}
//# sourceMappingURL=knowledge-query-service.d.ts.map