import type { AgentKnowledgeService } from '../../agent-knowledge.service';
import type { ParsedSearchKnowledgeInput } from './schemas';
export type WorkspaceFiles = Awaited<ReturnType<AgentKnowledgeService['materializeWorkspace']>>;
export type FileReferenceResolution = {
    status: 'found';
    file: WorkspaceFiles[number];
} | {
    status: 'missing';
    error: string;
} | {
    status: 'ambiguous';
    error: string;
};
export declare function resolveFileReference(files: WorkspaceFiles, reference: string): FileReferenceResolution;
export declare function getRequiredFileReferences(input: ParsedSearchKnowledgeInput): string[] | undefined;
export declare function mapFileReferences(files: WorkspaceFiles, requestedFiles?: string[]): string[] | undefined;