export type ContextStoreKind = "gc" | "artifacts";
export interface ContextStoreRetentionOptions {
    maxAgeMs?: number;
    maxSessionDirs?: number;
    maxTotalBytes?: number;
    now?: number;
}
export interface ContextStoreRetentionLease {
    readonly gcDir: string;
    readonly artifactsDir: string;
    release(): void;
}
/**
 * Move recognized context payloads from both historical layouts into the single leased session
 * namespace. Unknown files, symlinks, active runs, and conflicting destinations are left untouched.
 */
export declare function migrateLegacyContextStores(agentDir: string, onlySessionId?: string): void;
export declare function pruneContextStores(agentDir: string, options?: ContextStoreRetentionOptions): string[];
export declare function getContextStoreDir(agentDir: string, kind: ContextStoreKind, sessionId: string): string;
export declare function acquireContextStoreRetention(agentDir: string, sessionId: string, options?: ContextStoreRetentionOptions): ContextStoreRetentionLease;
//# sourceMappingURL=context-store-retention.d.ts.map