export type GcSessionScopeStatus = "ok" | "approaching_limit" | "over_limit" | "unavailable";
export interface GcSessionScopeUsage {
    status: GcSessionScopeStatus;
    /** Absolute path of the managed scope for the current working directory. */
    path: string;
    total_bytes: number;
    limit_bytes: number;
    entries: number;
    /** True when the walk stopped at `MAX_WALK_ENTRIES`, so totals are a floor. */
    truncated: boolean;
    reason?: string;
}
/**
 * Measure the managed scope directory backing `scopePath`.
 *
 * Never throws: an unreadable or absent scope is reported as `unavailable` so
 * a capacity probe can never fail a gc run.
 */
export declare function collectSessionScopeUsage(scopePath: string, limitBytes?: number): Promise<GcSessionScopeUsage>;
/** Whether the usage is worth putting in front of an operator. */
export declare function shouldReportSessionScope(usage: GcSessionScopeUsage): boolean;