import type { Command } from 'commander';
interface StagedEntry {
    id: string;
    timestamp: string;
    path: string;
    size: number;
    isDirectory: boolean;
}
export declare function formatSize(bytes: number): string;
export interface StaleStagingInfo {
    /** Entries older than maxAge. */
    staleEntries: StagedEntry[];
    /** Total bytes across stale entries. */
    totalBytes: number;
    /** Human-readable total size. */
    totalSize: string;
    /** Number of stale entries. */
    count: number;
}
/**
 * Check for staging entries older than a given age.
 * Pure function — no I/O side effects beyond reading the filesystem.
 *
 * @param maxAgeMs - Maximum age in milliseconds (default: 7 days)
 * @returns Info about stale entries, or null if none found.
 */
export declare function getStaleStagingInfo(maxAgeMs?: number): StaleStagingInfo | null;
/**
 * Purge stale staging entries. Returns the number of entries removed.
 *
 * @param entries - Entries to purge (from getStaleStagingInfo().staleEntries)
 * @returns Number of entries successfully removed.
 */
export declare function purgeStagingEntries(entries: StagedEntry[]): number;
export declare function registerStaging(program: Command): void;
export {};