export interface FileState {
    /** File content at read time */
    content: string;
    /** mtimeMs from fs.stat(), floored to integer */
    timestamp: number;
    /** offset parameter used during read (1-indexed) */
    offset: number | undefined;
    /** limit parameter used during read */
    limit: number | undefined;
}
/**
 * LRU file state cache with no external dependencies.
 * Uses Map insertion order (iterators return entries in insertion order)
 * to implement LRU eviction — on every access the entry is deleted and
 * re-inserted so it moves to the "newest" position.
 */
declare class FileStateCache {
    private cache;
    private totalBytes;
    private normalizeKey;
    get(key: string): FileState | undefined;
    set(key: string, value: FileState): void;
    has(key: string): boolean;
    delete(key: string): boolean;
    clear(): void;
    get size(): number;
}
/** Singleton file state cache instance */
export declare const fileStateCache: FileStateCache;
export {};