@brutalist/mcp 0.6.0 → 0.6.2

package/dist/streaming/session-manager.d.ts

@@ -0,0 +1,238 @@
+import { EventEmitter } from 'events';
+import { StreamingEvent } from '../cli-agents.js';
+import { IntelligentBuffer, EventBatch } from './intelligent-buffer.js';
+/**
+ * Session manager statistics
+ */
+export interface SessionManagerStats {
+    activeSessions: number;
+    totalEvents: number;
+    memoryUsage: number;
+    totalSubscribers: number;
+    uptime: number;
+}
+/**
+ * Session state tracking for analysis
+ */
+export interface AnalysisState {
+    status: 'starting' | 'running' | 'paused' | 'complete' | 'failed';
+    activeAgents: Set<string>;
+    completedAgents: Set<string>;
+    failedAgents: Set<string>;
+    findings: StreamingEvent[];
+    startTime: number;
+    endTime?: number;
+    progress: {
+        totalPhases: number;
+        currentPhase: number;
+        phaseName: string;
+        phaseProgress: number;
+    };
+    metrics: {
+        totalEvents: number;
+        findingsCount: number;
+        errorsCount: number;
+        avgResponseTime: number;
+    };
+}
+/**
+ * Session context with full lifecycle management
+ */
+export interface SessionContext {
+    id: string;
+    startTime: number;
+    lastActivity: number;
+    subscribers: Set<StreamingSubscriber>;
+    eventBuffer: IntelligentBuffer;
+    metadata: Record<string, any>;
+    analysis: AnalysisState;
+    connectionCount: number;
+    maxConnections: number;
+    resources: {
+        memoryUsage: number;
+        eventCount: number;
+        connectionTime: number;
+    };
+    cleanup?: {
+        ttl: number;
+        scheduled: boolean;
+        timer?: NodeJS.Timeout;
+    };
+}
+/**
+ * Streaming subscriber interface
+ */
+export interface StreamingSubscriber {
+    id: string;
+    sessionId: string;
+    type: 'sse' | 'websocket' | 'polling';
+    emit(event: StreamingEvent): Promise<void>;
+    emitBatch(batch: EventBatch): Promise<void>;
+    close(): void;
+    isConnected(): boolean;
+    getConnectionInfo(): {
+        connectedAt: number;
+        lastActivity: number;
+        eventsDelivered: number;
+        errorsCount: number;
+    };
+}
+/**
+ * Session lifecycle events
+ */
+export interface SessionEvents {
+    'session:created': (context: SessionContext) => void;
+    'session:destroyed': (sessionId: string) => void;
+    'session:activity': (sessionId: string, activity: string) => void;
+    'session:error': (sessionId: string, error: Error) => void;
+    'subscriber:connected': (sessionId: string, subscriber: StreamingSubscriber) => void;
+    'subscriber:disconnected': (sessionId: string, subscriberId: string) => void;
+    'analysis:started': (sessionId: string, agents: string[]) => void;
+    'analysis:progress': (sessionId: string, progress: AnalysisState['progress']) => void;
+    'analysis:completed': (sessionId: string, results: AnalysisState) => void;
+    'analysis:failed': (sessionId: string, error: Error) => void;
+}
+/**
+ * Session configuration options
+ */
+export interface SessionConfig {
+    ttl?: number;
+    maxConnections?: number;
+    maxMemoryMB?: number;
+    maxEvents?: number;
+    autoCleanup?: boolean;
+    bufferConfig?: {
+        enableCoalescence: boolean;
+        adaptiveThrottling: boolean;
+        backpressureThreshold: number;
+    };
+}
+/**
+ * Session channel manager with comprehensive lifecycle management
+ *
+ * Features:
+ * - Session isolation with secure access control
+ * - Automatic resource cleanup and garbage collection
+ * - Connection pooling and limits
+ * - Real-time monitoring and metrics
+ * - Event buffering and delivery guarantees
+ * - Analysis state tracking
+ * - Graceful error handling and recovery
+ */
+export declare class SessionChannelManager extends EventEmitter {
+    private sessions;
+    private cleanupTimers;
+    private globalBuffer;
+    private startTime;
+    private readonly config;
+    private readonly DEFAULT_CONFIG;
+    private metrics;
+    constructor(config?: SessionConfig);
+    /**
+     * Create new session with full context
+     */
+    createSession(sessionId?: string, metadata?: Record<string, any>): SessionContext;
+    /**
+     * Get session context with access validation
+     */
+    getSession(sessionId: string, requireActive?: boolean): SessionContext | null;
+    /**
+     * Subscribe to session events with connection management
+     */
+    subscribe(sessionId: string, subscriber: StreamingSubscriber): Promise<boolean>;
+    /**
+     * Unsubscribe from session events
+     */
+    unsubscribe(sessionId: string, subscriberId: string): boolean;
+    /**
+     * Emit event to session with intelligent buffering
+     */
+    emitToSession(sessionId: string, event: StreamingEvent): Promise<void>;
+    /**
+     * Start analysis tracking for session
+     */
+    startAnalysis(sessionId: string, agents: string[]): boolean;
+    /**
+     * Complete analysis for session
+     */
+    completeAnalysis(sessionId: string): boolean;
+    /**
+     * Fail analysis for session
+     */
+    failAnalysis(sessionId: string, error: Error): boolean;
+    /**
+     * Destroy session and cleanup resources
+     */
+    destroySession(sessionId: string): boolean;
+    /**
+     * Get all active sessions
+     */
+    getActiveSessions(): SessionContext[];
+    /**
+     * Get session statistics
+     */
+    /**
+     * Get global system metrics
+     */
+    getGlobalMetrics(): any;
+    /**
+     * Check if session exists
+     */
+    hasSession(sessionId: string): boolean;
+    /**
+     * Get session statistics
+     */
+    getSessionStats(sessionId: string): {
+        eventsEmitted: number;
+        bufferStats: {
+            flushCount: number;
+        };
+    } | null;
+    /**
+     * End analysis for session
+     */
+    endAnalysis(sessionId: string): boolean;
+    /**
+     * Complete session (alias for endAnalysis)
+     */
+    completeSession(sessionId: string): boolean;
+    /**
+     * Get global statistics
+     */
+    getGlobalStats(): SessionManagerStats;
+    /**
+     * Shutdown session manager
+     */
+    shutdown(): void;
+    /**
+     * Cleanup all resources
+     */
+    destroy(): void;
+    /**
+     * Update analysis state based on events
+     */
+    private updateAnalysisState;
+    /**
+     * Schedule session cleanup
+     */
+    private scheduleCleanup;
+    /**
+     * Setup global event handlers
+     */
+    private setupEventHandlers;
+    /**
+     * Deliver event batch to session subscribers
+     */
+    private deliverBatch;
+    /**
+     * Start periodic maintenance tasks
+     */
+    private startMaintenance;
+    /**
+     * Update internal metrics
+     */
+    private updateMetrics;
+}
+export declare const SessionManager: typeof SessionChannelManager;
+export type SessionManager = SessionChannelManager;
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/streaming/session-manager.d.ts.map

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