/**
 * Read an entire JSONL file into an array.
 * Invalid lines are silently skipped.
 */
export declare function readJsonlFile<T = unknown>(filePath: string): Promise<T[]>;
/**
 * Scan the first N lines of a JSONL file with an early-stop visitor.
 */
export declare function scanJsonlHead(filePath: string, maxLines: number, visitor: (parsed: unknown, lineIndex: number) => 'continue' | 'stop'): Promise<void>;
/**
 * Count lines and get byte size for a file.
 */
export declare function getFileStats(filePath: string): Promise<{
    lines: number;
    bytes: number;
}>;
/**
 * Read a single JSON file and parse it. Returns null if file doesn't exist or parse fails.
 */
export declare function readJsonFile<T = unknown>(filePath: string): Promise<T | null>;
/**
 * Truncate a string with ellipsis if it exceeds max length.
 */
export declare function truncate(s: string, max: number): string;
/**
 * Recursively find files matching a predicate.
 */
export declare function findFiles(dir: string, predicate: (name: string) => boolean, maxDepth?: number): string[];
//# sourceMappingURL=common.d.ts.map