@blackbox_ai/blackbox-cli 0.9.2 → 1.0.2

package/dist/src/utils/apiKeyUtils.js

@@ -0,0 +1,177 @@
+/**
+ * @license
+ * Copyright 2025 Blackbox
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { SettingScope } from '../config/settings.js';
+/**
+ * Mapping of agent types to their API key requirements
+ */
+export const AGENT_API_KEY_MAP = {
+    blackbox: {
+        envVarName: 'BLACKBOX_API_KEY',
+        settingsPath: 'security.auth.blackbox.apiKey',
+        displayName: 'Blackbox API Key',
+        placeholder: 'Enter your Blackbox API key...',
+        validator: (key) => key.length > 0 && !key.includes(' '),
+        description: 'Blackbox API key required for Blackbox CLI',
+    },
+    claude: {
+        envVarName: 'BLACKBOX_API_KEY', // Claude uses Blackbox API key
+        settingsPath: 'security.auth.blackbox.apiKey',
+        displayName: 'Blackbox API Key (for Claude Code)',
+        placeholder: 'Enter your Blackbox API key...',
+        validator: (key) => key.length > 0 && !key.includes(' '),
+        description: 'Blackbox API key required for Claude Code agent access',
+    },
+    codex: {
+        envVarName: 'OPENAI_API_KEY', // Primary, but can also use BLACKBOX_API_KEY
+        settingsPath: 'security.auth.openai.apiKey',
+        displayName: 'OpenAI API Key',
+        placeholder: 'sk-...',
+        validator: (key) => key.startsWith('sk-') && key.length > 20,
+        description: 'OpenAI API key required for Codex agent (or use Blackbox API key)',
+    },
+    gemini: {
+        envVarName: 'GEMINI_API_KEY',
+        settingsPath: 'security.auth.google.apiKey',
+        displayName: 'Gemini API Key',
+        placeholder: 'Enter your Gemini API key...',
+        validator: (key) => key.length > 0 && !key.includes(' '),
+        description: 'Google Gemini API key required for Gemini agent',
+    },
+};
+/**
+ * Check if an API key is available for the given agent type
+ * Checks both environment variables and settings
+ */
+export function hasApiKeyForAgent(agentType, settings) {
+    const keyInfo = AGENT_API_KEY_MAP[agentType];
+    if (!keyInfo)
+        return false;
+    // Check environment variable first
+    const envKey = process.env[keyInfo.envVarName];
+    if (envKey && keyInfo.validator(envKey)) {
+        return true;
+    }
+    // For Codex, also check for BLACKBOX_API_KEY as fallback
+    if (agentType === 'codex') {
+        const blackboxKey = process.env['BLACKBOX_API_KEY'];
+        if (blackboxKey && blackboxKey.length > 0) {
+            return true;
+        }
+    }
+    // Check settings if available
+    if (settings) {
+        const settingsKey = getApiKeyFromSettings(agentType, settings);
+        if (settingsKey && keyInfo.validator(settingsKey)) {
+            return true;
+        }
+        // For Codex, also check Blackbox key in settings as fallback
+        if (agentType === 'codex') {
+            const blackboxSettingsKey = getApiKeyFromSettings('blackbox', settings);
+            if (blackboxSettingsKey && blackboxSettingsKey.length > 0) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Get API key from settings for the given agent type
+ */
+export function getApiKeyFromSettings(agentType, settings) {
+    const keyInfo = AGENT_API_KEY_MAP[agentType];
+    if (!keyInfo)
+        return undefined;
+    const pathParts = keyInfo.settingsPath.split('.');
+    let current = settings.merged;
+    for (const part of pathParts) {
+        if (current && typeof current === 'object' && current !== null && part in current) {
+            current = current[part];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return typeof current === 'string' ? current : undefined;
+}
+/**
+ * Get the effective API key for an agent (env var takes precedence over settings)
+ */
+export function getEffectiveApiKey(agentType, settings) {
+    const keyInfo = AGENT_API_KEY_MAP[agentType];
+    if (!keyInfo)
+        return undefined;
+    // Environment variable takes precedence
+    const envKey = process.env[keyInfo.envVarName];
+    if (envKey && keyInfo.validator(envKey)) {
+        return envKey;
+    }
+    // For Codex, check BLACKBOX_API_KEY as fallback
+    if (agentType === 'codex') {
+        const blackboxKey = process.env['BLACKBOX_API_KEY'];
+        if (blackboxKey && blackboxKey.length > 0) {
+            return blackboxKey;
+        }
+    }
+    // Fall back to settings
+    if (settings) {
+        const settingsKey = getApiKeyFromSettings(agentType, settings);
+        if (settingsKey && keyInfo.validator(settingsKey)) {
+            return settingsKey;
+        }
+        // For Codex, also check Blackbox key in settings as fallback
+        if (agentType === 'codex') {
+            const blackboxSettingsKey = getApiKeyFromSettings('blackbox', settings);
+            if (blackboxSettingsKey && blackboxSettingsKey.length > 0) {
+                return blackboxSettingsKey;
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Save API key to settings for the given agent type
+ */
+export function saveApiKeyToSettings(agentType, apiKey, settings) {
+    const keyInfo = AGENT_API_KEY_MAP[agentType];
+    if (!keyInfo) {
+        throw new Error(`Unknown agent type: ${agentType}`);
+    }
+    if (!keyInfo.validator(apiKey)) {
+        throw new Error(`Invalid API key format for ${agentType}`);
+    }
+    // Save to the appropriate settings path
+    settings.setValue(SettingScope.User, keyInfo.settingsPath, apiKey);
+}
+/**
+ * Get missing API key info for agents that don't have keys
+ */
+export function getMissingApiKeyInfo(agentTypes, settings) {
+    return agentTypes
+        .filter(agentType => !hasApiKeyForAgent(agentType, settings))
+        .map(agentType => AGENT_API_KEY_MAP[agentType])
+        .filter(Boolean);
+}
+/**
+ * Validate API key format for a specific agent type
+ */
+export function validateApiKey(agentType, apiKey) {
+    const keyInfo = AGENT_API_KEY_MAP[agentType];
+    if (!keyInfo) {
+        return { valid: false, error: `Unknown agent type: ${agentType}` };
+    }
+    if (!apiKey || apiKey.trim().length === 0) {
+        return { valid: false, error: 'API key cannot be empty' };
+    }
+    const trimmedKey = apiKey.trim();
+    if (!keyInfo.validator(trimmedKey)) {
+        if (agentType === 'codex') {
+            return { valid: false, error: 'OpenAI API key must start with "sk-" and be at least 20 characters long' };
+        }
+        return { valid: false, error: `Invalid ${keyInfo.displayName} format` };
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=apiKeyUtils.js.map

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

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

package/dist/src/utils/backgroundUpdateCheck.js

@@ -3,32 +3,122 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { getCurrentVersion, fetchLatestVersionFromAPI, getPlatformString, writePendingUpdate, } from './versionStorage.js';
+import { getCurrentVersion, fetchLatestVersionFromAPI, getPlatformString, writePendingUpdate, shouldCheckForUpdate, writeLastCheck, } from './versionStorage.js';
 import semver from 'semver';
+/**
+ * Fetches the latest version with retry logic
+ * @param platform Platform string
+ * @param maxRetries Maximum number of retry attempts
+ * @param timeoutMs Timeout in milliseconds for each attempt
+ * @returns Latest version string or null if all attempts fail
+ */
+async function fetchLatestVersionWithRetry(platform, maxRetries = 2, timeoutMs = 7000) {
+    const debugMode = process.env['DEBUG'] === 'true';
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+            if (debugMode) {
+                console.debug(`[Update Check] Attempt ${attempt}/${maxRetries} to fetch latest version...`);
+            }
+            const latestVersion = await fetchLatestVersionFromAPI(platform, timeoutMs);
+            if (latestVersion) {
+                if (debugMode) {
+                    console.debug(`[Update Check] Successfully fetched latest version: ${latestVersion}`);
+                }
+                return latestVersion;
+            }
+            if (debugMode) {
+                console.debug(`[Update Check] Attempt ${attempt} returned null, retrying...`);
+            }
+        }
+        catch (error) {
+            if (debugMode) {
+                console.debug(`[Update Check] Attempt ${attempt} failed:`, error);
+            }
+            // If this is not the last attempt, wait before retrying with exponential backoff
+            if (attempt < maxRetries) {
+                const backoffMs = 1000 * Math.pow(2, attempt - 1); // 1s, 2s, 4s...
+                if (debugMode) {
+                    console.debug(`[Update Check] Waiting ${backoffMs}ms before retry...`);
+                }
+                await new Promise(resolve => setTimeout(resolve, backoffMs));
+            }
+        }
+    }
+    if (debugMode) {
+        console.debug(`[Update Check] All ${maxRetries} attempts failed`);
+    }
+    return null;
+}
 /**
  * Performs a background check for updates without blocking CLI startup
  * If an update is found, it stores the information for the next CLI launch
  */
 export async function backgroundUpdateCheck() {
+    const debugMode = process.env['DEBUG'] === 'true';
     try {
+        // Check if enough time has passed since last check (default: 1 hour)
+        if (!shouldCheckForUpdate()) {
+            if (debugMode) {
+                console.debug('[Update Check] Skipping check - not enough time has passed since last check');
+            }
+            return;
+        }
+        if (debugMode) {
+            console.debug('[Update Check] Starting background update check...');
+        }
         // Get current and latest versions
         const currentVersion = await getCurrentVersion();
         if (!currentVersion) {
+            if (debugMode) {
+                console.debug('[Update Check] Could not determine current version');
+            }
+            writeLastCheck(false);
             return;
         }
+        if (debugMode) {
+            console.debug(`[Update Check] Current version: ${currentVersion}`);
+        }
         const platform = getPlatformString();
-        const latestVersion = await fetchLatestVersionFromAPI(platform);
-        // If we can't fetch the latest version, silently fail
+        if (debugMode) {
+            console.debug(`[Update Check] Platform: ${platform}`);
+        }
+        // Fetch latest version with retry logic (2 attempts, 7 second timeout each)
+        const latestVersion = await fetchLatestVersionWithRetry(platform, 2, 7000);
+        // If we can't fetch the latest version, record failed check
         if (!latestVersion) {
+            if (debugMode) {
+                console.debug('[Update Check] Failed to fetch latest version after all retries');
+            }
+            writeLastCheck(false);
             return;
         }
+        if (debugMode) {
+            console.debug(`[Update Check] Latest version: ${latestVersion}`);
+        }
         // Check if update is available
         if (semver.gt(latestVersion, currentVersion)) {
+            if (debugMode) {
+                console.debug(`[Update Check] Update available: ${currentVersion} -> ${latestVersion}`);
+            }
             // Store the pending update for next launch
-            writePendingUpdate(latestVersion);
+            const written = writePendingUpdate(latestVersion);
+            if (debugMode) {
+                console.debug(`[Update Check] Pending update ${written ? 'written' : 'failed to write'}`);
+            }
+            writeLastCheck(true);
+        }
+        else {
+            if (debugMode) {
+                console.debug('[Update Check] Already on latest version');
+            }
+            writeLastCheck(true);
         }
     }
-    catch (_error) {
+    catch (error) {
+        if (debugMode) {
+            console.debug('[Update Check] Unexpected error:', error);
+        }
+        writeLastCheck(false);
         // Silently fail - don't disrupt the CLI
     }
 }
@@ -37,11 +127,18 @@ export async function backgroundUpdateCheck() {
  * This should be called after the CLI has started
  */
 export function startBackgroundUpdateCheck() {
+    const debugMode = process.env['DEBUG'] === 'true';
+    if (debugMode) {
+        console.debug('[Update Check] Scheduling background update check...');
+    }
     // Run the check in the background without awaiting
     // Use setImmediate to ensure it runs after current event loop
     setImmediate(() => {
-        backgroundUpdateCheck().catch(() => {
-            // Silently ignore errors
+        backgroundUpdateCheck().catch((error) => {
+            if (debugMode) {
+                console.debug('[Update Check] Background check failed:', error);
+            }
+            // Silently ignore errors in production
         });
     });
 }

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

@@ -1 +1 @@
-{"version":3,"file":"backgroundUpdateCheck.js","sourceRoot":"","sources":["../../../src/utils/backgroundUpdateCheck.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,IAAI,CAAC;QACH,kCAAkC;QAClC,MAAM,cAAc,GAAG,MAAM,iBAAiB,EAAE,CAAC;QACjD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;QACrC,MAAM,aAAa,GAAG,MAAM,yBAAyB,CAAC,QAAQ,CAAC,CAAC;QAEhE,sDAAsD;QACtD,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,+BAA+B;QAC/B,IAAI,MAAM,CAAC,EAAE,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAAC;YAC7C,2CAA2C;YAC3C,kBAAkB,CAAC,aAAa,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,wCAAwC;IAC1C,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B;IACxC,mDAAmD;IACnD,8DAA8D;IAC9D,YAAY,CAAC,GAAG,EAAE;QAChB,qBAAqB,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;YACjC,yBAAyB;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"backgroundUpdateCheck.js","sourceRoot":"","sources":["../../../src/utils/backgroundUpdateCheck.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,85 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '@blackbox_ai/blackbox-cli-core';
+/**
+ * Memory statistics interface
+ */
+export interface MemoryStats {
+    heapUsed: number;
+    heapTotal: number;
+    heapLimit: number;
+    external: number;
+    rss: number;
+    usagePercentage: number;
+    pressureLevel: 'normal' | 'warning' | 'critical' | 'emergency';
+}
+/**
+ * Memory cleanup callback type
+ */
+export type MemoryCleanupCallback = () => void | Promise<void>;
+/**
+ * Memory manager class for handling memory optimization and monitoring
+ */
+export declare class MemoryManager {
+    private cleanupCallbacks;
+    private monitoringInterval?;
+    private lastGcTime;
+    private gcThrottleMs;
+    private config?;
+    constructor(config?: Config);
+    /**
+     * Get optimal heap size arguments for Node.js
+     */
+    static getOptimalHeapArgs(config?: Config): string[];
+    /**
+     * Get current memory statistics
+     */
+    getMemoryStats(): MemoryStats;
+    /**
+     * Register a cleanup callback to be called during memory pressure
+     */
+    registerCleanupCallback(callback: MemoryCleanupCallback): () => void;
+    /**
+     * Force garbage collection if enough time has passed
+     */
+    forceGarbageCollection(): boolean;
+    /**
+     * Run cleanup callbacks
+     */
+    runCleanupCallbacks(): Promise<void>;
+    /**
+     * Handle memory pressure by running cleanup and forcing GC
+     */
+    handleMemoryPressure(): Promise<void>;
+    /**
+     * Start memory monitoring
+     */
+    startMonitoring(intervalMs?: number): void;
+    /**
+     * Stop memory monitoring
+     */
+    stopMonitoring(): void;
+    /**
+     * Get formatted memory usage string
+     */
+    getFormattedMemoryUsage(): string;
+    /**
+     * Cleanup and destroy the memory manager
+     */
+    destroy(): void;
+}
+/**
+ * Get or create the global memory manager
+ */
+export declare function getMemoryManager(config?: Config): MemoryManager;
+/**
+ * Initialize memory management with optimal settings
+ */
+export declare function initializeMemoryManagement(config?: Config): MemoryManager;
+/**
+ * Utility function to create a memory-aware cleanup callback
+ */
+export declare function createMemoryCleanupCallback(cleanupFn: () => void | Promise<void>, description?: string): MemoryCleanupCallback;