/** A file surfaced by the walk, carrying the mtime+size from the walk's own stat. */
export interface WalkedFile {
    path: string;
    mtimeMs: number;
    size: number;
}
/**
 * Walk a directory recursively for files with a given extension, newest first,
 * keeping each match's mtime and size from the walk's own stat. Callers that
 * then compare against the scan ledger reuse these instead of re-stat'ing every
 * path — eliminating a second stat per file on the Codex/Droid/routine scans.
 */
export declare function walkForFilesWithStat(dir: string, ext: string, limit: number): WalkedFile[];
/** Walk a directory recursively for files with a given extension, newest first. */
export declare function walkForFiles(dir: string, ext: string, limit: number): string[];
/**
 * Return the newest mtime (ms) among files with the given extension, or null
 * when none match. Single pass tracking the max — no collection or sort.
 * Hot-path helper for the `agents run` account-recency probe.
 */
export declare function latestFileMtimeMs(dir: string, ext: string): number | null;
