@blackbox_ai/blackbox-cli 0.9.2 → 1.0.2

package/dist/src/utils/memoryManager.js

@@ -0,0 +1,258 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import os from 'node:os';
+import v8 from 'node:v8';
+/**
+ * Default heap size in MB - set to 8GB as requested
+ */
+const DEFAULT_HEAP_SIZE_MB = 8192;
+/**
+ * Minimum heap size in MB to prevent issues on low-memory systems
+ */
+const MIN_HEAP_SIZE_MB = 2048;
+/**
+ * Memory pressure thresholds
+ */
+const MEMORY_PRESSURE_THRESHOLDS = {
+    WARNING: 0.7, // 70% of heap used
+    CRITICAL: 0.85, // 85% of heap used
+    EMERGENCY: 0.95 // 95% of heap used
+};
+/**
+ * Memory manager class for handling memory optimization and monitoring
+ */
+export class MemoryManager {
+    cleanupCallbacks = new Set();
+    monitoringInterval;
+    lastGcTime = 0;
+    gcThrottleMs = 5000; // Minimum 5 seconds between forced GCs
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Get optimal heap size arguments for Node.js
+     */
+    static getOptimalHeapArgs(config) {
+        const totalMemoryMB = os.totalmem() / (1024 * 1024);
+        const heapStats = v8.getHeapStatistics();
+        const currentMaxOldSpaceSizeMb = Math.floor(heapStats.heap_size_limit / 1024 / 1024);
+        // Calculate target heap size
+        let targetHeapSizeMB = DEFAULT_HEAP_SIZE_MB;
+        // Ensure we don't exceed 80% of total system memory
+        const maxSafeHeapSize = Math.floor(totalMemoryMB * 0.8);
+        if (targetHeapSizeMB > maxSafeHeapSize) {
+            targetHeapSizeMB = maxSafeHeapSize;
+        }
+        // Ensure minimum heap size
+        if (targetHeapSizeMB < MIN_HEAP_SIZE_MB) {
+            targetHeapSizeMB = MIN_HEAP_SIZE_MB;
+        }
+        if (config?.getDebugMode()) {
+            console.debug(`Memory configuration: Current=${currentMaxOldSpaceSizeMb}MB, Target=${targetHeapSizeMB}MB, System=${Math.floor(totalMemoryMB)}MB`);
+        }
+        // Skip relaunch if already configured or explicitly disabled
+        if (process.env['BLACKBOX_CLI_NO_RELAUNCH'] || process.env['GEMINI_CLI_NO_RELAUNCH']) {
+            return [];
+        }
+        // Only relaunch if we need significantly more memory
+        if (targetHeapSizeMB > currentMaxOldSpaceSizeMb + 512) {
+            return [
+                `--max-old-space-size=${targetHeapSizeMB}`,
+                '--max-semi-space-size=128', // Optimize young generation
+                '--optimize-for-size', // Reduce memory overhead
+            ];
+        }
+        return [];
+    }
+    /**
+     * Get current memory statistics
+     */
+    getMemoryStats() {
+        const heapStats = v8.getHeapStatistics();
+        const memUsage = process.memoryUsage();
+        const heapUsed = memUsage.heapUsed;
+        const heapTotal = memUsage.heapTotal;
+        const heapLimit = heapStats.heap_size_limit;
+        const usagePercentage = heapUsed / heapLimit;
+        let pressureLevel = 'normal';
+        if (usagePercentage >= MEMORY_PRESSURE_THRESHOLDS.EMERGENCY) {
+            pressureLevel = 'emergency';
+        }
+        else if (usagePercentage >= MEMORY_PRESSURE_THRESHOLDS.CRITICAL) {
+            pressureLevel = 'critical';
+        }
+        else if (usagePercentage >= MEMORY_PRESSURE_THRESHOLDS.WARNING) {
+            pressureLevel = 'warning';
+        }
+        return {
+            heapUsed,
+            heapTotal,
+            heapLimit,
+            external: memUsage.external,
+            rss: memUsage.rss,
+            usagePercentage,
+            pressureLevel,
+        };
+    }
+    /**
+     * Register a cleanup callback to be called during memory pressure
+     */
+    registerCleanupCallback(callback) {
+        this.cleanupCallbacks.add(callback);
+        return () => this.cleanupCallbacks.delete(callback);
+    }
+    /**
+     * Force garbage collection if enough time has passed
+     */
+    forceGarbageCollection() {
+        const now = Date.now();
+        if (now - this.lastGcTime < this.gcThrottleMs) {
+            return false;
+        }
+        try {
+            if (global.gc) {
+                global.gc();
+                this.lastGcTime = now;
+                return true;
+            }
+        }
+        catch (error) {
+            if (this.config?.getDebugMode()) {
+                console.debug('Failed to force garbage collection:', error);
+            }
+        }
+        return false;
+    }
+    /**
+     * Run cleanup callbacks
+     */
+    async runCleanupCallbacks() {
+        const promises = [];
+        for (const callback of this.cleanupCallbacks) {
+            try {
+                const result = callback();
+                if (result instanceof Promise) {
+                    promises.push(result);
+                }
+            }
+            catch (error) {
+                if (this.config?.getDebugMode()) {
+                    console.debug('Cleanup callback failed:', error);
+                }
+            }
+        }
+        if (promises.length > 0) {
+            await Promise.allSettled(promises);
+        }
+    }
+    /**
+     * Handle memory pressure by running cleanup and forcing GC
+     */
+    async handleMemoryPressure() {
+        if (this.config?.getDebugMode()) {
+            const stats = this.getMemoryStats();
+            console.debug(`Memory pressure detected: ${(stats.usagePercentage * 100).toFixed(1)}% used`);
+        }
+        // Run cleanup callbacks first
+        await this.runCleanupCallbacks();
+        // Force garbage collection
+        this.forceGarbageCollection();
+    }
+    /**
+     * Start memory monitoring
+     */
+    startMonitoring(intervalMs = 10000) {
+        if (this.monitoringInterval) {
+            return;
+        }
+        this.monitoringInterval = setInterval(() => {
+            const stats = this.getMemoryStats();
+            if (stats.pressureLevel === 'emergency' || stats.pressureLevel === 'critical') {
+                this.handleMemoryPressure().catch((error) => {
+                    if (this.config?.getDebugMode()) {
+                        console.debug('Memory pressure handling failed:', error);
+                    }
+                });
+            }
+            if (this.config?.getDebugMode() && stats.pressureLevel !== 'normal') {
+                console.debug(`Memory usage: ${(stats.usagePercentage * 100).toFixed(1)}% (${stats.pressureLevel})`);
+            }
+        }, intervalMs);
+    }
+    /**
+     * Stop memory monitoring
+     */
+    stopMonitoring() {
+        if (this.monitoringInterval) {
+            clearInterval(this.monitoringInterval);
+            this.monitoringInterval = undefined;
+        }
+    }
+    /**
+     * Get formatted memory usage string
+     */
+    getFormattedMemoryUsage() {
+        const stats = this.getMemoryStats();
+        const heapUsedMB = Math.round(stats.heapUsed / 1024 / 1024);
+        const heapLimitMB = Math.round(stats.heapLimit / 1024 / 1024);
+        const percentage = (stats.usagePercentage * 100).toFixed(1);
+        return `${heapUsedMB}MB / ${heapLimitMB}MB (${percentage}%)`;
+    }
+    /**
+     * Cleanup and destroy the memory manager
+     */
+    destroy() {
+        this.stopMonitoring();
+        this.cleanupCallbacks.clear();
+    }
+}
+/**
+ * Global memory manager instance
+ */
+let globalMemoryManager;
+/**
+ * Get or create the global memory manager
+ */
+export function getMemoryManager(config) {
+    if (!globalMemoryManager) {
+        globalMemoryManager = new MemoryManager(config);
+    }
+    return globalMemoryManager;
+}
+/**
+ * Initialize memory management with optimal settings
+ */
+export function initializeMemoryManagement(config) {
+    const memoryManager = getMemoryManager(config);
+    // Start monitoring
+    memoryManager.startMonitoring();
+    // Register process cleanup
+    const cleanup = () => {
+        memoryManager.destroy();
+    };
+    process.on('exit', cleanup);
+    process.on('SIGINT', cleanup);
+    process.on('SIGTERM', cleanup);
+    return memoryManager;
+}
+/**
+ * Utility function to create a memory-aware cleanup callback
+ */
+export function createMemoryCleanupCallback(cleanupFn, description) {
+    return async () => {
+        try {
+            const result = cleanupFn();
+            if (result instanceof Promise) {
+                await result;
+            }
+        }
+        catch (error) {
+            console.warn(`Memory cleanup failed${description ? ` (${description})` : ''}:`, error);
+        }
+    };
+}
+//# sourceMappingURL=memoryManager.js.map

package/dist/src/utils/memoryManager.js.map

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

package/dist/src/utils/memoryMonitor.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface MemoryStats {
+    heapUsed: number;
+    heapTotal: number;
+    heapLimit: number;
+    heapUsagePercent: number;
+    external: number;
+    rss: number;
+    arrayBuffers: number;
+    timestamp: number;
+}
+export interface MemoryAlert {
+    level: 'info' | 'warning' | 'critical';
+    message: string;
+    stats: MemoryStats;
+    timestamp: number;
+}
+export declare class MemoryMonitor {
+    private static instance;
+    private alerts;
+    private intervalId;
+    private onAlert?;
+    private isMonitoring;
+    private readonly WARNING_THRESHOLD;
+    private readonly CRITICAL_THRESHOLD;
+    private readonly MONITORING_INTERVAL;
+    private constructor();
+    static getInstance(): MemoryMonitor;
+    /**
+     * Get current memory statistics
+     */
+    getCurrentStats(): MemoryStats;
+    /**
+     * Format memory stats for display
+     */
+    formatStats(stats: MemoryStats): string;
+    /**
+     * Get a simple memory status string
+     */
+    getMemoryStatus(): string;
+    /**
+     * Start continuous memory monitoring
+     */
+    startMonitoring(onAlert?: (alert: MemoryAlert) => void): void;
+    /**
+     * Stop memory monitoring
+     */
+    stopMonitoring(): void;
+    /**
+     * Check current memory usage and generate alerts
+     */
+    private checkMemoryUsage;
+    /**
+     * Get memory level based on usage percentage
+     */
+    private getMemoryLevel;
+    /**
+     * Generate alert message
+     */
+    private getAlertMessage;
+    /**
+     * Get recent alerts
+     */
+    getRecentAlerts(count?: number): MemoryAlert[];
+    /**
+     * Clear all alerts
+     */
+    clearAlerts(): void;
+    /**
+     * Get system memory information
+     */
+    getSystemInfo(): {
+        totalMemory: number;
+        freeMemory: number;
+        usedMemory: number;
+        memoryUsagePercent: number;
+        nodeVersion: string;
+        platform: string;
+    };
+    /**
+     * Generate a comprehensive memory report
+     */
+    generateReport(): string;
+}
+export declare const memoryMonitor: MemoryMonitor;

package/dist/src/utils/memoryMonitor.js

@@ -0,0 +1,238 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import v8 from 'node:v8';
+import os from 'node:os';
+export class MemoryMonitor {
+    static instance;
+    alerts = [];
+    intervalId = null;
+    onAlert;
+    isMonitoring = false;
+    // Thresholds for memory alerts
+    WARNING_THRESHOLD = 70; // 70% of heap limit
+    CRITICAL_THRESHOLD = 85; // 85% of heap limit
+    MONITORING_INTERVAL = 5000; // 5 seconds
+    constructor() { }
+    static getInstance() {
+        if (!MemoryMonitor.instance) {
+            MemoryMonitor.instance = new MemoryMonitor();
+        }
+        return MemoryMonitor.instance;
+    }
+    /**
+     * Get current memory statistics
+     */
+    getCurrentStats() {
+        const heapStats = v8.getHeapStatistics();
+        const memUsage = process.memoryUsage();
+        const heapUsed = heapStats.used_heap_size;
+        const heapTotal = heapStats.total_heap_size;
+        const heapLimit = heapStats.heap_size_limit;
+        const heapUsagePercent = (heapUsed / heapLimit) * 100;
+        return {
+            heapUsed: Math.round(heapUsed / 1024 / 1024), // MB
+            heapTotal: Math.round(heapTotal / 1024 / 1024), // MB
+            heapLimit: Math.round(heapLimit / 1024 / 1024), // MB
+            heapUsagePercent: Math.round(heapUsagePercent * 100) / 100,
+            external: Math.round(memUsage.external / 1024 / 1024), // MB
+            rss: Math.round(memUsage.rss / 1024 / 1024), // MB
+            arrayBuffers: Math.round(memUsage.arrayBuffers / 1024 / 1024), // MB
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Format memory stats for display
+     */
+    formatStats(stats) {
+        return [
+            `Heap: ${stats.heapUsed}MB/${stats.heapLimit}MB (${stats.heapUsagePercent}%)`,
+            `RSS: ${stats.rss}MB`,
+            `External: ${stats.external}MB`,
+            `ArrayBuffers: ${stats.arrayBuffers}MB`,
+        ].join(' | ');
+    }
+    /**
+     * Get a simple memory status string
+     */
+    getMemoryStatus() {
+        const stats = this.getCurrentStats();
+        const status = this.getMemoryLevel(stats.heapUsagePercent);
+        const statusIcon = status === 'critical' ? '🔴' : status === 'warning' ? '🟡' : '🟢';
+        return `${statusIcon} Memory: ${stats.heapUsed}MB/${stats.heapLimit}MB (${stats.heapUsagePercent}%)`;
+    }
+    /**
+     * Start continuous memory monitoring
+     */
+    startMonitoring(onAlert) {
+        if (this.isMonitoring) {
+            return;
+        }
+        this.onAlert = onAlert;
+        this.isMonitoring = true;
+        // Initial stats
+        const initialStats = this.getCurrentStats();
+        console.log(`🔍 Memory Monitor Started - ${this.formatStats(initialStats)}`);
+        this.intervalId = setInterval(() => {
+            this.checkMemoryUsage();
+        }, this.MONITORING_INTERVAL);
+    }
+    /**
+     * Stop memory monitoring
+     */
+    stopMonitoring() {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+        this.isMonitoring = false;
+        console.log('🔍 Memory Monitor Stopped');
+    }
+    /**
+     * Check current memory usage and generate alerts
+     */
+    checkMemoryUsage() {
+        const stats = this.getCurrentStats();
+        const level = this.getMemoryLevel(stats.heapUsagePercent);
+        if (level !== 'info') {
+            const alert = {
+                level,
+                message: this.getAlertMessage(level, stats),
+                stats,
+                timestamp: Date.now(),
+            };
+            this.alerts.push(alert);
+            // Keep only last 50 alerts
+            if (this.alerts.length > 50) {
+                this.alerts = this.alerts.slice(-50);
+            }
+            if (this.onAlert) {
+                this.onAlert(alert);
+            }
+            // Log critical alerts immediately
+            if (level === 'critical') {
+                console.error(`🔴 CRITICAL MEMORY ALERT: ${alert.message}`);
+                console.error(`   ${this.formatStats(stats)}`);
+                // Trigger garbage collection if available
+                if (global.gc) {
+                    console.log('🗑️  Triggering garbage collection...');
+                    global.gc();
+                }
+            }
+            else if (level === 'warning') {
+                console.warn(`🟡 Memory Warning: ${alert.message}`);
+            }
+        }
+    }
+    /**
+     * Get memory level based on usage percentage
+     */
+    getMemoryLevel(usagePercent) {
+        if (usagePercent >= this.CRITICAL_THRESHOLD) {
+            return 'critical';
+        }
+        else if (usagePercent >= this.WARNING_THRESHOLD) {
+            return 'warning';
+        }
+        return 'info';
+    }
+    /**
+     * Generate alert message
+     */
+    getAlertMessage(level, stats) {
+        if (level === 'critical') {
+            return `Memory usage critical at ${stats.heapUsagePercent}% (${stats.heapUsed}MB/${stats.heapLimit}MB). Consider reducing workload or increasing heap size.`;
+        }
+        else {
+            return `Memory usage high at ${stats.heapUsagePercent}% (${stats.heapUsed}MB/${stats.heapLimit}MB). Monitor for potential issues.`;
+        }
+    }
+    /**
+     * Get recent alerts
+     */
+    getRecentAlerts(count = 10) {
+        return this.alerts.slice(-count);
+    }
+    /**
+     * Clear all alerts
+     */
+    clearAlerts() {
+        this.alerts = [];
+    }
+    /**
+     * Get system memory information
+     */
+    getSystemInfo() {
+        const totalMemory = Math.round(os.totalmem() / 1024 / 1024); // MB
+        const freeMemory = Math.round(os.freemem() / 1024 / 1024); // MB
+        const usedMemory = totalMemory - freeMemory;
+        const memoryUsagePercent = (usedMemory / totalMemory) * 100;
+        return {
+            totalMemory,
+            freeMemory,
+            usedMemory,
+            memoryUsagePercent: Math.round(memoryUsagePercent * 100) / 100,
+            nodeVersion: process.version,
+            platform: os.platform(),
+        };
+    }
+    /**
+     * Generate a comprehensive memory report
+     */
+    generateReport() {
+        const stats = this.getCurrentStats();
+        const systemInfo = this.getSystemInfo();
+        const recentAlerts = this.getRecentAlerts(5);
+        const report = [
+            '📊 MEMORY MONITORING REPORT',
+            '='.repeat(50),
+            '',
+            '🔧 System Information:',
+            `   Platform: ${systemInfo.platform}`,
+            `   Node.js: ${systemInfo.nodeVersion}`,
+            `   Total System Memory: ${systemInfo.totalMemory}MB`,
+            `   Free System Memory: ${systemInfo.freeMemory}MB`,
+            `   System Memory Usage: ${systemInfo.memoryUsagePercent}%`,
+            '',
+            '💾 Current Heap Statistics:',
+            `   Heap Used: ${stats.heapUsed}MB`,
+            `   Heap Total: ${stats.heapTotal}MB`,
+            `   Heap Limit: ${stats.heapLimit}MB`,
+            `   Heap Usage: ${stats.heapUsagePercent}%`,
+            `   RSS: ${stats.rss}MB`,
+            `   External: ${stats.external}MB`,
+            `   Array Buffers: ${stats.arrayBuffers}MB`,
+            '',
+            '🚨 Recent Alerts:',
+        ];
+        if (recentAlerts.length === 0) {
+            report.push('   No recent alerts - memory usage is normal');
+        }
+        else {
+            recentAlerts.forEach((alert) => {
+                const time = new Date(alert.timestamp).toLocaleTimeString();
+                const icon = alert.level === 'critical' ? '🔴' : '🟡';
+                report.push(`   ${icon} [${time}] ${alert.level.toUpperCase()}: ${alert.message}`);
+            });
+        }
+        report.push('');
+        report.push('💡 Recommendations:');
+        if (stats.heapUsagePercent > 85) {
+            report.push('   - CRITICAL: Consider increasing heap size or reducing workload');
+            report.push('   - Run with: node --max-old-space-size=16384 (16GB)');
+        }
+        else if (stats.heapUsagePercent > 70) {
+            report.push('   - WARNING: Monitor memory usage closely');
+            report.push('   - Consider optimizing data structures or implementing cleanup');
+        }
+        else {
+            report.push('   - Memory usage is within normal limits');
+        }
+        return report.join('\n');
+    }
+}
+// Export singleton instance
+export const memoryMonitor = MemoryMonitor.getInstance();
+//# sourceMappingURL=memoryMonitor.js.map

package/dist/src/utils/memoryMonitor.js.map

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

package/dist/src/utils/memoryWrapper.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Check if we need to relaunch with better memory settings
+ */
+export declare function shouldRelaunchWithMemory(): boolean;
+/**
+ * Relaunch the process with optimal memory settings
+ */
+export declare function relaunchWithOptimalMemory(): Promise<never>;
+/**
+ * Ensure the process is running with optimal memory settings
+ * This should be called early in the application startup
+ */
+export declare function ensureOptimalMemory(): Promise<void>;