import type { ContextPackSliceMetadata } from '../../contracts/context-pack.js';
import type { KnowledgeGraph } from '../../contracts/graph.js';
import type { RetrievalGenerationIntent, RetrievalIntent, RetrievalTargetDomainHint } from '../../contracts/retrieval-gate.js';
export interface SliceScoredNode {
    id: string;
    label: string;
    sourceFile: string;
    nodeKind?: string | undefined;
    frameworkRole?: string | undefined;
    exactLabelMatch: boolean;
    /** Strength of the prompt's explicit symbol match; preserves Class.method precision. */
    symbolMatchScore?: number;
    literalPathMatch?: boolean;
    sourcePathMatch: boolean;
    score: number;
}
interface SliceOptions {
    prompt?: string | undefined;
    generationIntent?: RetrievalGenerationIntent | undefined;
    targetDomainHint?: RetrievalTargetDomainHint | undefined;
    mentionedSymbols?: readonly string[] | undefined;
    excludedDomains?: readonly string[] | undefined;
    excludedTerms?: readonly string[] | undefined;
    excludedPathHints?: readonly string[] | undefined;
    rootPath?: string | undefined;
}
export declare function sliceCandidatesForRetrieve(graph: KnowledgeGraph, scoredCandidates: readonly SliceScoredNode[], intent: RetrievalIntent, options?: SliceOptions): {
    ordered_ids: string[];
    metadata: ContextPackSliceMetadata;
} | null;
export {};