import { KnowledgeGraph } from '../contracts/graph.js';
import type { ContextPackClaim, ContextPackCoverage, ContextPackEvidenceClass, ContextPackExpandableRef } from '../contracts/context-pack.js';
import type { ContextPackTaskKind } from '../contracts/context-pack.js';
import type { TaskIntentKind } from '../contracts/task-intent.js';
export interface RelevantFilesOptions {
    question: string;
    budget: number;
    limit?: number;
    community?: number;
    fileType?: string;
    taskKind?: ContextPackTaskKind;
    taskIntent?: TaskIntentKind;
}
export interface RelevantFileEntry {
    path: string;
    score: number;
    why: string;
    matched_symbols: string[];
    direct_matches: number;
    related_matches: number;
}
export interface RelevantFilesResult {
    question: string;
    token_count: number;
    relevant_files: RelevantFileEntry[];
    claims: ContextPackClaim[];
    expandable: ContextPackExpandableRef[];
    coverage?: ContextPackCoverage;
    missing_context?: ContextPackEvidenceClass[];
}
export declare function relevantFiles(graph: KnowledgeGraph, options: RelevantFilesOptions): RelevantFilesResult;