@soulcraft/brainy 0.52.0 → 0.54.0

package/dist/utils/adaptiveSocketManager.js

@@ -0,0 +1,378 @@
+/**
+ * Adaptive Socket Manager
+ * Automatically manages socket pools and connection settings based on load patterns
+ * Zero-configuration approach that learns and adapts to workload characteristics
+ */
+import { Agent as HttpsAgent } from 'https';
+import { NodeHttpHandler } from '@smithy/node-http-handler';
+import { createModuleLogger } from './logger.js';
+/**
+ * Adaptive Socket Manager that automatically scales based on load patterns
+ */
+export class AdaptiveSocketManager {
+    constructor() {
+        this.logger = createModuleLogger('AdaptiveSocketManager');
+        // Current configuration
+        this.config = {
+            maxSockets: 100, // Start conservative
+            maxFreeSockets: 20,
+            keepAliveTimeout: 60000,
+            connectionTimeout: 10000,
+            socketTimeout: 60000,
+            batchSize: 10
+        };
+        // Performance tracking
+        this.metrics = {
+            requestsPerSecond: 0,
+            pendingRequests: 0,
+            socketUtilization: 0,
+            errorRate: 0,
+            latencyP50: 0,
+            latencyP95: 0,
+            memoryUsage: 0
+        };
+        // Historical data for learning
+        this.history = [];
+        this.maxHistorySize = 100;
+        // Adaptation state
+        this.lastAdaptationTime = 0;
+        this.adaptationInterval = 5000; // Check every 5 seconds
+        this.consecutiveHighLoad = 0;
+        this.consecutiveLowLoad = 0;
+        // Request tracking
+        this.requestStartTimes = new Map();
+        this.requestLatencies = [];
+        this.errorCount = 0;
+        this.successCount = 0;
+        this.lastMetricReset = Date.now();
+        // Socket pool instances
+        this.currentAgent = null;
+        this.currentHandler = null;
+    }
+    /**
+     * Get or create an optimized HTTP handler
+     */
+    getHttpHandler() {
+        // Adapt configuration if needed
+        this.adaptIfNeeded();
+        // Create new handler if configuration changed
+        if (!this.currentHandler || this.shouldRecreateHandler()) {
+            this.currentAgent = new HttpsAgent({
+                keepAlive: true,
+                maxSockets: this.config.maxSockets,
+                maxFreeSockets: this.config.maxFreeSockets,
+                timeout: this.config.keepAliveTimeout,
+                scheduling: 'fifo' // Fair scheduling for high-volume scenarios
+            });
+            this.currentHandler = new NodeHttpHandler({
+                httpsAgent: this.currentAgent,
+                connectionTimeout: this.config.connectionTimeout,
+                socketTimeout: this.config.socketTimeout
+            });
+            this.logger.debug('Created new HTTP handler with config:', this.config);
+        }
+        return this.currentHandler;
+    }
+    /**
+     * Get current batch size recommendation
+     */
+    getBatchSize() {
+        this.adaptIfNeeded();
+        return this.config.batchSize;
+    }
+    /**
+     * Track request start
+     */
+    trackRequestStart(requestId) {
+        this.requestStartTimes.set(requestId, Date.now());
+        this.metrics.pendingRequests++;
+    }
+    /**
+     * Track request completion
+     */
+    trackRequestComplete(requestId, success) {
+        const startTime = this.requestStartTimes.get(requestId);
+        if (startTime) {
+            const latency = Date.now() - startTime;
+            this.requestLatencies.push(latency);
+            this.requestStartTimes.delete(requestId);
+            // Keep latency array bounded
+            if (this.requestLatencies.length > 1000) {
+                this.requestLatencies = this.requestLatencies.slice(-500);
+            }
+        }
+        if (success) {
+            this.successCount++;
+        }
+        else {
+            this.errorCount++;
+        }
+        this.metrics.pendingRequests = Math.max(0, this.metrics.pendingRequests - 1);
+    }
+    /**
+     * Check if we should adapt configuration
+     */
+    adaptIfNeeded() {
+        const now = Date.now();
+        if (now - this.lastAdaptationTime < this.adaptationInterval) {
+            return;
+        }
+        this.lastAdaptationTime = now;
+        this.updateMetrics();
+        this.analyzeAndAdapt();
+    }
+    /**
+     * Update current metrics
+     */
+    updateMetrics() {
+        const now = Date.now();
+        const timeSinceReset = (now - this.lastMetricReset) / 1000;
+        // Calculate requests per second
+        const totalRequests = this.successCount + this.errorCount;
+        this.metrics.requestsPerSecond = timeSinceReset > 0
+            ? totalRequests / timeSinceReset
+            : 0;
+        // Calculate error rate
+        this.metrics.errorRate = totalRequests > 0
+            ? this.errorCount / totalRequests
+            : 0;
+        // Calculate latency percentiles
+        if (this.requestLatencies.length > 0) {
+            const sorted = [...this.requestLatencies].sort((a, b) => a - b);
+            const p50Index = Math.floor(sorted.length * 0.5);
+            const p95Index = Math.floor(sorted.length * 0.95);
+            this.metrics.latencyP50 = sorted[p50Index] || 0;
+            this.metrics.latencyP95 = sorted[p95Index] || 0;
+        }
+        // Calculate socket utilization
+        this.metrics.socketUtilization = this.metrics.pendingRequests / this.config.maxSockets;
+        // Memory usage
+        if (typeof process !== 'undefined' && process.memoryUsage) {
+            const memUsage = process.memoryUsage();
+            this.metrics.memoryUsage = memUsage.heapUsed / memUsage.heapTotal;
+        }
+        // Add to history
+        this.history.push({ ...this.metrics });
+        if (this.history.length > this.maxHistorySize) {
+            this.history.shift();
+        }
+        // Reset counters periodically
+        if (timeSinceReset > 60) {
+            this.lastMetricReset = now;
+            this.successCount = 0;
+            this.errorCount = 0;
+        }
+    }
+    /**
+     * Analyze metrics and adapt configuration
+     */
+    analyzeAndAdapt() {
+        const wasConfig = { ...this.config };
+        // Detect high load conditions
+        const isHighLoad = this.detectHighLoad();
+        const isLowLoad = this.detectLowLoad();
+        const hasErrors = this.metrics.errorRate > 0.01; // More than 1% errors
+        if (isHighLoad) {
+            this.consecutiveHighLoad++;
+            this.consecutiveLowLoad = 0;
+            if (this.consecutiveHighLoad >= 2) { // Wait for 2 consecutive high load readings
+                this.scaleUp();
+            }
+        }
+        else if (isLowLoad) {
+            this.consecutiveLowLoad++;
+            this.consecutiveHighLoad = 0;
+            if (this.consecutiveLowLoad >= 6) { // Wait longer before scaling down
+                this.scaleDown();
+            }
+        }
+        else {
+            // Reset counters if load is normal
+            this.consecutiveHighLoad = Math.max(0, this.consecutiveHighLoad - 1);
+            this.consecutiveLowLoad = Math.max(0, this.consecutiveLowLoad - 1);
+        }
+        // Handle error conditions
+        if (hasErrors) {
+            this.handleErrors();
+        }
+        // Log significant changes
+        if (JSON.stringify(wasConfig) !== JSON.stringify(this.config)) {
+            this.logger.info('Adapted configuration', {
+                from: wasConfig,
+                to: this.config,
+                metrics: this.metrics
+            });
+        }
+    }
+    /**
+     * Detect high load conditions
+     */
+    detectHighLoad() {
+        return (this.metrics.socketUtilization > 0.7 || // Sockets heavily used
+            this.metrics.pendingRequests > this.config.maxSockets * 0.8 || // Many pending requests
+            this.metrics.latencyP95 > 5000 || // High latency
+            this.metrics.requestsPerSecond > 100 // High request rate
+        );
+    }
+    /**
+     * Detect low load conditions
+     */
+    detectLowLoad() {
+        return (this.metrics.socketUtilization < 0.2 && // Sockets barely used
+            this.metrics.pendingRequests < 5 && // Few pending requests
+            this.metrics.latencyP95 < 1000 && // Low latency
+            this.metrics.requestsPerSecond < 10 && // Low request rate
+            this.metrics.memoryUsage < 0.5 // Low memory usage
+        );
+    }
+    /**
+     * Scale up resources for high load
+     */
+    scaleUp() {
+        // Increase socket limits progressively
+        const scaleFactor = this.metrics.errorRate > 0.05 ? 1.5 : 2.0; // Scale more aggressively if no errors
+        this.config.maxSockets = Math.min(2000, // Hard limit to prevent resource exhaustion
+        Math.ceil(this.config.maxSockets * scaleFactor));
+        this.config.maxFreeSockets = Math.min(200, Math.ceil(this.config.maxSockets * 0.1) // Keep 10% as free sockets
+        );
+        // Increase batch size for better throughput
+        this.config.batchSize = Math.min(100, Math.ceil(this.config.batchSize * 1.5));
+        // Adjust timeouts for high load
+        this.config.keepAliveTimeout = 120000; // Keep connections alive longer
+        this.config.connectionTimeout = 15000; // Allow more time for connections
+        this.config.socketTimeout = 90000; // Allow more time for responses
+        this.logger.debug('Scaled up for high load', {
+            sockets: this.config.maxSockets,
+            batchSize: this.config.batchSize
+        });
+    }
+    /**
+     * Scale down resources for low load
+     */
+    scaleDown() {
+        // Only scale down if memory pressure is low
+        if (this.metrics.memoryUsage > 0.7) {
+            return;
+        }
+        // Decrease socket limits conservatively
+        this.config.maxSockets = Math.max(50, // Minimum sockets
+        Math.floor(this.config.maxSockets * 0.7));
+        this.config.maxFreeSockets = Math.max(10, Math.floor(this.config.maxSockets * 0.2) // Keep 20% as free sockets
+        );
+        // Decrease batch size
+        this.config.batchSize = Math.max(5, Math.floor(this.config.batchSize * 0.7));
+        // Adjust timeouts for low load
+        this.config.keepAliveTimeout = 60000;
+        this.config.connectionTimeout = 10000;
+        this.config.socketTimeout = 60000;
+        this.logger.debug('Scaled down for low load', {
+            sockets: this.config.maxSockets,
+            batchSize: this.config.batchSize
+        });
+    }
+    /**
+     * Handle error conditions by adjusting configuration
+     */
+    handleErrors() {
+        const errorRate = this.metrics.errorRate;
+        if (errorRate > 0.1) { // More than 10% errors
+            // Severe errors - back off aggressively
+            this.config.maxSockets = Math.max(50, Math.floor(this.config.maxSockets * 0.5));
+            this.config.batchSize = Math.max(1, Math.floor(this.config.batchSize * 0.3));
+            this.config.connectionTimeout = Math.min(30000, this.config.connectionTimeout * 2);
+            this.config.socketTimeout = Math.min(120000, this.config.socketTimeout * 2);
+            this.logger.warn('High error rate detected, backing off', {
+                errorRate,
+                newConfig: this.config
+            });
+        }
+        else if (errorRate > 0.05) { // More than 5% errors
+            // Moderate errors - reduce load slightly
+            this.config.batchSize = Math.max(1, Math.floor(this.config.batchSize * 0.7));
+            this.config.connectionTimeout = Math.min(20000, this.config.connectionTimeout * 1.2);
+        }
+    }
+    /**
+     * Check if we should recreate the handler
+     */
+    shouldRecreateHandler() {
+        if (!this.currentAgent)
+            return true;
+        // Recreate if socket configuration changed significantly
+        const currentMaxSockets = this.currentAgent.maxSockets;
+        const socketsDiff = Math.abs(currentMaxSockets - this.config.maxSockets);
+        return socketsDiff > currentMaxSockets * 0.5; // 50% change threshold
+    }
+    /**
+     * Get current configuration (for monitoring)
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Get current metrics (for monitoring)
+     */
+    getMetrics() {
+        return { ...this.metrics };
+    }
+    /**
+     * Predict optimal configuration based on historical data
+     */
+    predictOptimalConfig() {
+        if (this.history.length < 10) {
+            return this.config; // Not enough data to predict
+        }
+        // Analyze recent history
+        const recentHistory = this.history.slice(-20);
+        const avgRPS = recentHistory.reduce((sum, m) => sum + m.requestsPerSecond, 0) / recentHistory.length;
+        const maxRPS = Math.max(...recentHistory.map(m => m.requestsPerSecond));
+        const avgLatency = recentHistory.reduce((sum, m) => sum + m.latencyP95, 0) / recentHistory.length;
+        // Predict optimal socket count based on request patterns
+        const optimalSockets = Math.min(2000, Math.max(50, Math.ceil(maxRPS * 2)));
+        // Predict optimal batch size based on latency
+        const optimalBatchSize = avgLatency < 1000 ? 50 : avgLatency < 3000 ? 20 : 10;
+        return {
+            maxSockets: optimalSockets,
+            maxFreeSockets: Math.ceil(optimalSockets * 0.15),
+            keepAliveTimeout: avgRPS > 50 ? 120000 : 60000,
+            connectionTimeout: avgLatency > 3000 ? 20000 : 10000,
+            socketTimeout: avgLatency > 3000 ? 90000 : 60000,
+            batchSize: optimalBatchSize
+        };
+    }
+    /**
+     * Reset to default configuration
+     */
+    reset() {
+        this.config = {
+            maxSockets: 100,
+            maxFreeSockets: 20,
+            keepAliveTimeout: 60000,
+            connectionTimeout: 10000,
+            socketTimeout: 60000,
+            batchSize: 10
+        };
+        this.consecutiveHighLoad = 0;
+        this.consecutiveLowLoad = 0;
+        this.history = [];
+        this.requestLatencies = [];
+        this.errorCount = 0;
+        this.successCount = 0;
+        // Force recreation of handler
+        this.currentAgent = null;
+        this.currentHandler = null;
+        this.logger.info('Reset to default configuration');
+    }
+}
+// Global singleton instance
+let globalSocketManager = null;
+/**
+ * Get the global socket manager instance
+ */
+export function getGlobalSocketManager() {
+    if (!globalSocketManager) {
+        globalSocketManager = new AdaptiveSocketManager();
+    }
+    return globalSocketManager;
+}
+//# sourceMappingURL=adaptiveSocketManager.js.map

package/dist/utils/adaptiveSocketManager.js.map

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

package/dist/utils/performanceMonitor.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Performance Monitor
+ * Automatically tracks and optimizes system performance
+ * Provides real-time insights and auto-tuning recommendations
+ */
+interface PerformanceMetrics {
+    totalOperations: number;
+    successfulOperations: number;
+    failedOperations: number;
+    averageLatency: number;
+    p95Latency: number;
+    p99Latency: number;
+    operationsPerSecond: number;
+    bytesPerSecond: number;
+    memoryUsage: number;
+    cpuUsage: number;
+    socketUtilization: number;
+    queueDepth: number;
+    errorRate: number;
+    healthScore: number;
+}
+interface PerformanceTrend {
+    metric: string;
+    direction: 'improving' | 'degrading' | 'stable';
+    changeRate: number;
+    prediction: number;
+}
+/**
+ * Comprehensive performance monitoring and optimization
+ */
+export declare class PerformanceMonitor {
+    private logger;
+    private metrics;
+    private history;
+    private maxHistorySize;
+    private operationLatencies;
+    private operationSizes;
+    private lastReset;
+    private resetInterval;
+    private lastCpuUsage;
+    private lastCpuCheck;
+    private thresholds;
+    private recommendations;
+    private autoOptimizeEnabled;
+    private lastOptimization;
+    private optimizationInterval;
+    /**
+     * Track an operation completion
+     */
+    trackOperation(success: boolean, latency: number, bytes?: number): void;
+    /**
+     * Update all metrics
+     */
+    private updateMetrics;
+    /**
+     * Update resource metrics
+     */
+    private updateResourceMetrics;
+    /**
+     * Calculate overall health score
+     */
+    private calculateHealthScore;
+    /**
+     * Check for alert conditions
+     */
+    private checkAlerts;
+    /**
+     * Auto-optimize system based on metrics
+     */
+    private autoOptimize;
+    /**
+     * Analyze performance trends
+     */
+    private analyzeTrends;
+    /**
+     * Reset counters
+     */
+    private resetCounters;
+    /**
+     * Get current metrics
+     */
+    getMetrics(): Readonly<PerformanceMetrics>;
+    /**
+     * Get performance trends
+     */
+    getTrends(): PerformanceTrend[];
+    /**
+     * Get recommendations
+     */
+    getRecommendations(): string[];
+    /**
+     * Get performance report
+     */
+    getReport(): {
+        metrics: PerformanceMetrics;
+        trends: PerformanceTrend[];
+        recommendations: string[];
+        socketConfig: any;
+        backpressureStatus: any;
+    };
+    /**
+     * Enable/disable auto-optimization
+     */
+    setAutoOptimize(enabled: boolean): void;
+    /**
+     * Reset all metrics and history
+     */
+    reset(): void;
+}
+/**
+ * Get the global performance monitor instance
+ */
+export declare function getGlobalPerformanceMonitor(): PerformanceMonitor;
+export {};