import { type KnowledgeAdapterRegistry } from "./adapter-registry.js";
import type { CodeEvidenceHit, CodeEvidenceSnapshot, CodeReference, CodeSearchOptions, KnowledgeFragment, ProjectStructure, CodeImportDiagnostics, CodeImportResolutionCounts, RelatedCodeEvidence } from "./types.js";
export declare const DEFAULT_QUERY_ADAPTERS: KnowledgeAdapterRegistry;
export declare function normalizedCodeText(value: string): string;
export declare function normalizedQualifiedSymbol(value: string): string;
export declare function codePathAllowed(path: string, prefixes: readonly string[] | undefined): boolean;
/** Disposable query structures for one validated snapshot generation. */
export declare class CodeQueryRuntime {
    readonly registry: KnowledgeAdapterRegistry;
    readonly snapshot: CodeEvidenceSnapshot;
    private symbols?;
    private incoming?;
    private structureReader?;
    private structure?;
    constructor(snapshot: CodeEvidenceSnapshot, registry?: KnowledgeAdapterRegistry);
    /** Only reference consumers pay for manifest freshness checks. */
    refreshProjectStructure(repositoryRoot: string): Promise<void>;
    projectStructureWarnings(): ProjectStructure["warnings"];
    projectStructureEstimatedBytes(): number;
    /** Internal outcome counts are generation inventory, never request/fallback rates. */
    importResolutionDiagnostics(): {
        diagnostics: CodeImportDiagnostics;
        byLanguage: Record<string, CodeImportResolutionCounts>;
    };
    private symbolIndex;
    symbol(sought: string, options: CodeSearchOptions, maxResults: number): Omit<CodeEvidenceHit, "resourceUri">[];
    private referenceIndex;
    references(symbolId: string, options: CodeSearchOptions, maxResults: number): Omit<CodeReference, "resourceUri">[];
    /** One hop, no new retained graph. Call names must identify one definition;
     * candidates retain the same explicit lexical status as references. */
    relatedEvidence(symbolId: string, maxResults: number): Array<Omit<RelatedCodeEvidence, "resourceUri"> & {
        fragment: KnowledgeFragment;
    }>;
    /** Batch targets share postings, deduplication and bounded ordering. Used for
     * whole-file impact without querying every declaration independently. */
    referencesTo(targets: readonly KnowledgeFragment[], options: CodeSearchOptions, maxResults: number): Omit<CodeReference, "resourceUri">[];
}
//# sourceMappingURL=query-runtime.d.ts.map