import type { FileManifestEntry } from '@/types/graph';
/**
 * Prefix marker for the file manifest block.
 * Used to detect and deduplicate manifest messages across turns.
 */
export declare const FILE_MANIFEST_PREFIX = "[Conversation Files]";
/**
 * Builds a compact text block listing all files in the conversation.
 * Each entry costs ~10-15 tokens, so 10 files ≈ 100-150 tokens total.
 *
 * The block includes retrieval hints so the LLM knows how to fetch
 * full content on demand (via file_search or content_tool).
 *
 * @param manifest - Array of file metadata entries
 * @returns Formatted text block, or empty string if manifest is empty/undefined
 */
export declare function buildFileManifestBlock(manifest: FileManifestEntry[] | undefined): string;