/**
 * Session Cleanup Manager
 *
 * Manages automatic cleanup of sessions with TTL-based expiration,
 * idle session detection, and manual cleanup utilities.
 *
 * @since 2026-01-07
 */
import { XrayStateManager } from "../state/state-manager.js";
import { SessionMonitor } from "./session-monitor.js";
export interface SessionMetadata {
    sessionId: string;
    createdAt: number;
    lastActivity: number;
    ttlMs: number;
    isActive: boolean;
    agentCount: number;
    memoryUsage: number;
    cleanupReason?: string;
}
export interface CleanupConfig {
    ttlMs: number;
    idleTimeoutMs: number;
    maxSessions: number;
    cleanupIntervalMs: number;
    enableAutoCleanup: boolean;
}
export interface CleanupResult {
    sessionsCleaned: number;
    sessionsExpired: number;
    sessionsIdle: number;
    errors: string[];
}
export declare class SessionCleanupManager {
    private stateManager;
    private config;
    private cleanupInterval?;
    private _sessionMetadata?;
    private _metadataLoaded;
    /** Same object the store holds, so a one-field write does not clone every session. */
    private metadataRecord;
    private sessionMonitor;
    constructor(stateManager: XrayStateManager, config?: Partial<CleanupConfig>, sessionMonitor?: SessionMonitor);
    /**
     * Lazy-loaded session metadata - loads from state manager on first access
     */
    private get sessionMetadata();
    private set sessionMetadata(value);
    /**
     * Initialize cleanup manager and start auto-cleanup if enabled
     */
    private initialize;
    start(): void;
    /**
     * Register a new session for cleanup tracking
     */
    registerSession(sessionId: string, ttlMs?: number): void;
    updateActivity(sessionId: string): void;
    updateMetadata(sessionId: string, updates: Partial<SessionMetadata>): void;
    /**
     * Check if session should be cleaned up
     */
    shouldCleanup(sessionId: string): boolean;
    /**
     * Perform cleanup of expired/idle sessions
     */
    performCleanup(): Promise<CleanupResult>;
    /**
     * Manually cleanup a specific session
     */
    manualCleanup(sessionId: string, reason?: string): Promise<boolean>;
    /**
     * Cleanup all sessions (emergency cleanup)
     */
    emergencyCleanup(): Promise<CleanupResult>;
    /**
     * Get cleanup statistics
     */
    getCleanupStats(): {
        totalSessions: number;
        activeSessions: number;
        expiredSessions: number;
        idleSessions: number;
        nextCleanup: number;
    };
    /**
     * Get session metadata
     */
    getSessionMetadata(sessionId: string): SessionMetadata | undefined;
    /**
     * List all sessions with metadata
     */
    listSessions(): SessionMetadata[];
    /**
     * Start automatic cleanup interval
     */
    private startAutoCleanup;
    /**
     * Stop automatic cleanup
     */
    stopAutoCleanup(): void;
    /**
     * Load session metadata from state manager (lazy loading)
     */
    private loadSessionMetadata;
    /**
     * Persist session metadata to state manager
     */
    private persistSessionMetadata;
    /**
     * Cleanup a specific session
     */
    private cleanupSession;
    /**
     * Shutdown cleanup manager
     */
    shutdown(): void;
}
export declare const createSessionCleanupManager: (stateManager: XrayStateManager, config?: Partial<CleanupConfig>, sessionMonitor?: SessionMonitor) => SessionCleanupManager;