stringray-ai 1.0.38 → 1.0.39

package/dist/plugin/session/session-cleanup-manager.js

@@ -0,0 +1,324 @@
+/**
+ * StringRay Framework v1.0.0 - Session Cleanup Manager
+ *
+ * Manages automatic cleanup of sessions with TTL-based expiration,
+ * idle session detection, and manual cleanup utilities.
+ *
+ * @version 1.0.0
+ * @since 2026-01-07
+ */
+export class SessionCleanupManager {
+    stateManager;
+    config;
+    cleanupInterval;
+    _sessionMetadata;
+    _metadataLoaded = false;
+    sessionMonitor;
+    constructor(stateManager, config = {}, sessionMonitor) {
+        this.stateManager = stateManager;
+        this.sessionMonitor = sessionMonitor;
+        this.config = {
+            ttlMs: 24 * 60 * 60 * 1000,
+            idleTimeoutMs: 2 * 60 * 60 * 1000,
+            maxSessions: 100,
+            cleanupIntervalMs: 5 * 60 * 1000,
+            enableAutoCleanup: true,
+            ...config,
+        };
+        this.initialize();
+    }
+    /**
+     * Lazy-loaded session metadata - loads from state manager on first access
+     */
+    get sessionMetadata() {
+        if (!this._metadataLoaded) {
+            this.loadSessionMetadata();
+            this._metadataLoaded = true;
+        }
+        return this._sessionMetadata;
+    }
+    set sessionMetadata(value) {
+        this._sessionMetadata = value;
+        this._metadataLoaded = true;
+    }
+    /**
+     * Initialize cleanup manager and start auto-cleanup if enabled
+     */
+    initialize() {
+        console.log("🧹 Session Cleanup Manager: Initializing...");
+        this.loadSessionMetadata();
+        if (this.config.enableAutoCleanup) {
+            this.startAutoCleanup();
+        }
+        console.log("✅ Session Cleanup Manager: Initialized");
+    }
+    /**
+     * Register a new session for cleanup tracking
+     */
+    registerSession(sessionId, ttlMs) {
+        const metadata = {
+            sessionId,
+            createdAt: Date.now(),
+            lastActivity: Date.now(),
+            ttlMs: ttlMs || this.config.ttlMs,
+            isActive: true,
+            agentCount: 0,
+            memoryUsage: 0,
+        };
+        this.sessionMetadata.set(sessionId, metadata);
+        this.persistSessionMetadata(sessionId, metadata);
+        console.log(`📋 Session Cleanup Manager: Registered session ${sessionId} with TTL ${ttlMs || this.config.ttlMs}ms`);
+    }
+    updateActivity(sessionId) {
+        const metadata = this.sessionMetadata.get(sessionId);
+        if (metadata) {
+            metadata.lastActivity = Date.now();
+            this.persistSessionMetadata(sessionId, metadata);
+        }
+    }
+    updateMetadata(sessionId, updates) {
+        const metadata = this.sessionMetadata.get(sessionId);
+        if (metadata) {
+            Object.assign(metadata, updates);
+            this.persistSessionMetadata(sessionId, metadata);
+        }
+    }
+    /**
+     * Check if session should be cleaned up
+     */
+    shouldCleanup(sessionId) {
+        const metadata = this.sessionMetadata.get(sessionId);
+        if (!metadata)
+            return false;
+        const now = Date.now();
+        if (now - metadata.createdAt > metadata.ttlMs) {
+            return true;
+        }
+        if (now - metadata.lastActivity > this.config.idleTimeoutMs) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Perform cleanup of expired/idle sessions
+     */
+    async performCleanup() {
+        const result = {
+            sessionsCleaned: 0,
+            sessionsExpired: 0,
+            sessionsIdle: 0,
+            errors: [],
+        };
+        const sessionsToCleanup = [];
+        for (const [sessionId, metadata] of this.sessionMetadata) {
+            if (!metadata.isActive)
+                continue;
+            const now = Date.now();
+            if (now - metadata.createdAt > metadata.ttlMs) {
+                sessionsToCleanup.push(sessionId);
+                result.sessionsExpired++;
+            }
+            else if (now - metadata.lastActivity > this.config.idleTimeoutMs) {
+                sessionsToCleanup.push(sessionId);
+                result.sessionsIdle++;
+            }
+        }
+        if (this.sessionMetadata.size > this.config.maxSessions) {
+            const sortedSessions = Array.from(this.sessionMetadata.entries())
+                .filter(([_, metadata]) => metadata.isActive)
+                .sort((a, b) => a[1].lastActivity - b[1].lastActivity);
+            const excessCount = sortedSessions.length - this.config.maxSessions;
+            for (let i = 0; i < excessCount && i < sortedSessions.length; i++) {
+                const session = sortedSessions[i];
+                if (session) {
+                    sessionsToCleanup.push(session[0]);
+                }
+            }
+        }
+        for (const sessionId of sessionsToCleanup) {
+            try {
+                await this.cleanupSession(sessionId);
+                result.sessionsCleaned++;
+            }
+            catch (error) {
+                result.errors.push(`Failed to cleanup session ${sessionId}: ${error}`);
+            }
+        }
+        if (result.sessionsCleaned > 0) {
+            console.log(`🧹 Session Cleanup Manager: Cleaned up ${result.sessionsCleaned} sessions (${result.sessionsExpired} expired, ${result.sessionsIdle} idle)`);
+        }
+        return result;
+    }
+    /**
+     * Manually cleanup a specific session
+     */
+    async manualCleanup(sessionId, reason) {
+        try {
+            const metadata = this.sessionMetadata.get(sessionId);
+            if (metadata) {
+                metadata.cleanupReason = reason || "manual";
+                this.persistSessionMetadata(sessionId, metadata);
+            }
+            await this.cleanupSession(sessionId);
+            console.log(`🧹 Session Cleanup Manager: Manual cleanup completed for session ${sessionId}`);
+            return true;
+        }
+        catch (error) {
+            console.error(`❌ Session Cleanup Manager: Manual cleanup failed for session ${sessionId}:`, error);
+            return false;
+        }
+    }
+    /**
+     * Cleanup all sessions (emergency cleanup)
+     */
+    async emergencyCleanup() {
+        const result = {
+            sessionsCleaned: 0,
+            sessionsExpired: 0,
+            sessionsIdle: 0,
+            errors: [],
+        };
+        for (const sessionId of this.sessionMetadata.keys()) {
+            try {
+                await this.cleanupSession(sessionId);
+                result.sessionsCleaned++;
+            }
+            catch (error) {
+                result.errors.push(`Failed to cleanup session ${sessionId}: ${error}`);
+            }
+        }
+        console.log(`🚨 Session Cleanup Manager: Emergency cleanup completed - ${result.sessionsCleaned} sessions cleaned`);
+        return result;
+    }
+    /**
+     * Get cleanup statistics
+     */
+    getCleanupStats() {
+        const now = Date.now();
+        let expiredCount = 0;
+        let idleCount = 0;
+        for (const metadata of this.sessionMetadata.values()) {
+            if (!metadata.isActive)
+                continue;
+            if (now - metadata.createdAt > metadata.ttlMs) {
+                expiredCount++;
+            }
+            else if (now - metadata.lastActivity > this.config.idleTimeoutMs) {
+                idleCount++;
+            }
+        }
+        return {
+            totalSessions: this.sessionMetadata.size,
+            activeSessions: Array.from(this.sessionMetadata.values()).filter((m) => m.isActive).length,
+            expiredSessions: expiredCount,
+            idleSessions: idleCount,
+            nextCleanup: this.cleanupInterval
+                ? Date.now() + this.config.cleanupIntervalMs
+                : 0,
+        };
+    }
+    /**
+     * Get session metadata
+     */
+    getSessionMetadata(sessionId) {
+        return this.sessionMetadata.get(sessionId);
+    }
+    /**
+     * List all sessions with metadata
+     */
+    listSessions() {
+        return Array.from(this.sessionMetadata.values());
+    }
+    /**
+     * Start automatic cleanup interval
+     */
+    startAutoCleanup() {
+        this.cleanupInterval = setInterval(async () => {
+            try {
+                await this.performCleanup();
+            }
+            catch (error) {
+                console.error("❌ Session Cleanup Manager: Auto-cleanup failed:", error);
+            }
+        }, this.config.cleanupIntervalMs);
+        console.log(`⏰ Session Cleanup Manager: Auto-cleanup started (interval: ${this.config.cleanupIntervalMs}ms)`);
+    }
+    /**
+     * Stop automatic cleanup
+     */
+    stopAutoCleanup() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = undefined;
+            console.log("⏹️ Session Cleanup Manager: Auto-cleanup stopped");
+        }
+    }
+    /**
+     * Load session metadata from state manager (lazy loading)
+     */
+    loadSessionMetadata() {
+        try {
+            const storedMetadata = this.stateManager.get("cleanup:session_metadata");
+            this._sessionMetadata = new Map();
+            if (storedMetadata &&
+                typeof storedMetadata === "object" &&
+                !Array.isArray(storedMetadata)) {
+                for (const [sessionId, metadata] of Object.entries(storedMetadata)) {
+                    if (metadata && typeof metadata === "object" && metadata.sessionId) {
+                        this._sessionMetadata.set(sessionId, metadata);
+                    }
+                }
+                console.log(`📋 Session Cleanup Manager: Lazy-loaded metadata for ${this._sessionMetadata.size} sessions`);
+            }
+            else if (storedMetadata) {
+                console.warn("⚠️ Session Cleanup Manager: Corrupted session metadata detected, skipping load");
+            }
+        }
+        catch (error) {
+            console.error("❌ Session Cleanup Manager: Failed to load session metadata:", error);
+        }
+    }
+    /**
+     * Persist session metadata to state manager
+     */
+    persistSessionMetadata(sessionId, metadata) {
+        const allMetadata = Object.fromEntries(this.sessionMetadata);
+        this.stateManager.set("cleanup:session_metadata", allMetadata);
+    }
+    /**
+     * Cleanup a specific session
+     */
+    async cleanupSession(sessionId) {
+        const metadata = this.sessionMetadata.get(sessionId);
+        if (!metadata)
+            return;
+        metadata.isActive = false;
+        this.persistSessionMetadata(sessionId, metadata);
+        // Skip session coordinator cleanup in test environment to avoid dependency issues
+        // const sessionCoordinator = this.stateManager.get(
+        //   "delegation:session_coordinator",
+        // ) as SessionCoordinator;
+        // if (sessionCoordinator) {
+        //   sessionCoordinator.cleanupSession(sessionId);
+        // }
+        // Notify session monitor to unregister the session
+        if (this.sessionMonitor) {
+            this.sessionMonitor.unregisterSession(sessionId);
+        }
+        this.stateManager.clear(`session:${sessionId}`);
+        this.sessionMetadata.delete(sessionId);
+        this.persistSessionMetadata(sessionId, metadata);
+        console.log(`🧹 Session Cleanup Manager: Cleaned up session ${sessionId}`);
+    }
+    /**
+     * Shutdown cleanup manager
+     */
+    shutdown() {
+        this.stopAutoCleanup();
+        console.log("🛑 Session Cleanup Manager: Shutdown complete");
+    }
+}
+export const createSessionCleanupManager = (stateManager, config, sessionMonitor) => {
+    return new SessionCleanupManager(stateManager, config, sessionMonitor);
+};
+//# sourceMappingURL=session-cleanup-manager.js.map

package/dist/plugin/session/session-cleanup-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-cleanup-manager.js","sourceRoot":"","sources":["../../../src/session/session-cleanup-manager.ts"],"names":[],"mappings":"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"}

package/dist/plugin/session/session-monitor.d.ts

@@ -0,0 +1,99 @@
+/**
+ * StringRay Framework v1.0.0 - Session Monitor
+ *
+ * Provides real-time monitoring of sessions with health checks,
+ * performance tracking, and alerting capabilities.
+ *
+ * @version 1.0.0
+ * @since 2026-01-07
+ */
+import { StringRayStateManager } from "../state/state-manager";
+import { SessionCoordinator } from "../delegation/session-coordinator";
+import { SessionCleanupManager } from "./session-cleanup-manager";
+export interface SessionHealth {
+    sessionId: string;
+    status: "healthy" | "degraded" | "critical" | "unknown";
+    lastCheck: number;
+    responseTime: number;
+    errorCount: number;
+    activeAgents: number;
+    memoryUsage: number;
+    issues: string[];
+}
+export interface SessionMetrics {
+    sessionId: string;
+    timestamp: number;
+    totalInteractions: number;
+    successfulInteractions: number;
+    failedInteractions: number;
+    averageResponseTime: number;
+    conflictResolutionRate: number;
+    coordinationEfficiency: number;
+    memoryUsage: number;
+    agentCount: number;
+}
+export interface MonitorConfig {
+    healthCheckIntervalMs: number;
+    metricsCollectionIntervalMs: number;
+    alertThresholds: {
+        maxResponseTime: number;
+        maxErrorRate: number;
+        maxMemoryUsage: number;
+        minCoordinationEfficiency: number;
+        maxConflicts: number;
+    };
+    enableAlerts: boolean;
+    enableMetrics: boolean;
+}
+export interface Alert {
+    id: string;
+    sessionId: string;
+    type: "health" | "performance" | "resource" | "coordination";
+    severity: "low" | "medium" | "high" | "critical";
+    message: string;
+    timestamp: number;
+    resolved: boolean;
+    resolvedAt?: number;
+}
+export declare class SessionMonitor {
+    private stateManager;
+    private sessionCoordinator;
+    private cleanupManager;
+    private config;
+    private healthChecks;
+    private metricsHistory;
+    private activeAlerts;
+    private healthCheckInterval?;
+    private metricsInterval?;
+    constructor(stateManager: StringRayStateManager, sessionCoordinator: SessionCoordinator, cleanupManager: SessionCleanupManager, config?: Partial<MonitorConfig>);
+    private initialize;
+    registerSession(sessionId: string): void;
+    unregisterSession(sessionId: string): void;
+    performHealthCheck(sessionId: string): Promise<SessionHealth>;
+    collectMetrics(sessionId: string): SessionMetrics | null;
+    getHealthStatus(sessionId: string): SessionHealth | null;
+    getMetricsHistory(sessionId: string, limit?: number): SessionMetrics[];
+    getActiveAlerts(sessionId?: string): Alert[];
+    resolveAlert(alertId: string): boolean;
+    getMonitoringStats(): {
+        totalSessions: number;
+        healthySessions: number;
+        degradedSessions: number;
+        criticalSessions: number;
+        activeAlerts: number;
+        totalMetricsPoints: number;
+    };
+    private startHealthChecks;
+    private startMetricsCollection;
+    private generateAlerts;
+    private loadPersistedData;
+    private persistHealthData;
+    private persistMetricsData;
+    private persistAlertData;
+    shutdown(): void;
+    private calculateSessionMemoryUsage;
+    private countSessionConflicts;
+    private calculateAverageResponseTime;
+}
+export declare const createSessionMonitor: (stateManager: StringRayStateManager, sessionCoordinator: SessionCoordinator, cleanupManager: SessionCleanupManager, config?: Partial<MonitorConfig>) => SessionMonitor;
+//# sourceMappingURL=session-monitor.d.ts.map

package/dist/plugin/session/session-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-monitor.d.ts","sourceRoot":"","sources":["../../../src/session/session-monitor.ts"],"names":[],"mappings":"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"}