@blackbox_ai/blackbox-cli 0.9.2 → 1.0.2

package/dist/src/ui/utils/terminalBackgroundDetector.js

@@ -3,6 +3,22 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+// Cache for terminal background RGB to avoid re-detection
+let cachedTerminalBgRgb = undefined;
+/**
+ * Gets the cached terminal background RGB, or null if not yet detected.
+ * @returns Cached RGB tuple or null
+ */
+export function getCachedTerminalBackgroundRgb() {
+    return cachedTerminalBgRgb ?? null;
+}
+/**
+ * Sets the cached terminal background RGB.
+ * @param rgb RGB tuple or null
+ */
+export function setCachedTerminalBackgroundRgb(rgb) {
+    cachedTerminalBgRgb = rgb;
+}
 /**
  * Detects if the terminal has a light or dark background.
  * Uses OSC 11 escape sequence to query the terminal background color.
@@ -48,34 +64,119 @@ export async function detectTerminalBackground() {
             }
         };
         const cleanup = () => {
-            process.stdin.removeListener('data', onData);
-            // Restore original raw mode state
-            if (process.stdin.isTTY) {
-                try {
-                    process.stdin.setRawMode(originalRawMode);
-                    // Pause stdin to ensure it's not actively reading
-                    process.stdin.pause();
-                    // Give a moment for any buffered data to clear
-                    setImmediate(() => {
-                        // Read and discard any remaining data in the buffer
-                        if (process.stdin.readable) {
-                            process.stdin.read();
-                        }
-                    });
-                }
-                catch (_err) {
-                    // Ignore errors during cleanup
+            if (!process.stdin.isTTY) {
+                return;
+            }
+            try {
+                process.stdin.removeListener('data', onData);
+                // Immediately restore original raw mode state
+                process.stdin.setRawMode(originalRawMode);
+                // Don't pause - let the normal input system handle stdin
+                // The input system will set up its own listeners
+            }
+            catch (_err) {
+                // Ignore errors during cleanup
+            }
+        };
+        try {
+            // Set up stdin to receive the response
+            // Only modify stdin if it's in a valid state
+            if (process.stdin.isTTY && !process.stdin.destroyed) {
+                const wasPaused = process.stdin.isPaused();
+                process.stdin.setRawMode(true);
+                if (wasPaused) {
+                    process.stdin.resume();
                 }
+                process.stdin.on('data', onData);
+                // Query the terminal background color using OSC 11
+                // Write directly to stdout to avoid any buffering issues
+                process.stdout.write('\x1b]11;?\x1b\\');
+            }
+            else {
+                cleanup();
+                resolve(null);
+            }
+        }
+        catch (_err) {
+            cleanup();
+            resolve(null);
+        }
+    });
+}
+/**
+ * Gets the actual RGB terminal background color.
+ * Uses OSC 11 escape sequence to query the terminal background color.
+ * @returns Promise that resolves to RGB tuple [r, g, b] or null if detection fails
+ */
+export async function getTerminalBackgroundRgb() {
+    // Check if we're in a TTY
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        return null;
+    }
+    return new Promise((resolve) => {
+        const timeout = setTimeout(() => {
+            cleanup();
+            resolve(null);
+        }, 100); // 100ms timeout
+        let response = '';
+        let resolved = false;
+        const stdinTTY = process.stdin;
+        const originalRawMode = stdinTTY.isRaw;
+        const onData = (data) => {
+            const chunk = data.toString();
+            response += chunk;
+            // OSC 11 response format: ESC ] 11 ; rgb:RRRR/GGGG/BBBB ESC \
+            // or: ESC ] 11 ; rgb:RR/GG/BB ESC \
+            // Some terminals may send the response multiple times or with variations
+            // eslint-disable-next-line no-control-regex
+            const match = response.match(/\x1b\]11;rgb:([0-9a-f]+)\/([0-9a-f]+)\/([0-9a-f]+)/i);
+            if (match && !resolved) {
+                resolved = true;
+                clearTimeout(timeout);
+                // Parse RGB values (they can be 2 or 4 hex digits)
+                const r = parseInt(match[1].substring(0, 2), 16);
+                const g = parseInt(match[2].substring(0, 2), 16);
+                const b = parseInt(match[3].substring(0, 2), 16);
+                // Cache the result
+                cachedTerminalBgRgb = [r, g, b];
+                // Clean up immediately and resolve
+                cleanup();
+                resolve([r, g, b]);
+            }
+        };
+        const cleanup = () => {
+            if (!process.stdin.isTTY) {
+                return;
+            }
+            try {
+                process.stdin.removeListener('data', onData);
+                // Immediately restore original raw mode state
+                process.stdin.setRawMode(originalRawMode);
+                // Don't pause - let the normal input system handle stdin
+                // The input system will set up its own listeners
+            }
+            catch (_err) {
+                // Ignore errors during cleanup
             }
         };
         try {
             // Set up stdin to receive the response
-            process.stdin.setRawMode(true);
-            process.stdin.resume();
-            process.stdin.on('data', onData);
-            // Query the terminal background color using OSC 11
-            // Write directly to stdout to avoid any buffering issues
-            process.stdout.write('\x1b]11;?\x1b\\');
+            // Only modify stdin if it's in a valid state
+            if (process.stdin.isTTY && !process.stdin.destroyed) {
+                const wasPaused = process.stdin.isPaused();
+                process.stdin.setRawMode(true);
+                if (wasPaused) {
+                    process.stdin.resume();
+                }
+                process.stdin.on('data', onData);
+                // Query the terminal background color using OSC 11
+                // Write directly to stdout to avoid any buffering issues
+                process.stdout.write('\x1b]11;?\x1b\\');
+            }
+            else {
+                cleanup();
+                resolve(null);
+            }
         }
         catch (_err) {
             cleanup();

package/dist/src/ui/utils/terminalBackgroundDetector.js.map

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

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

@@ -3,6 +3,7 @@
  * Copyright 2025 Blackbox
  * SPDX-License-Identifier: Apache-2.0
  */
+import type { LoadedSettings } from '../config/settings.js';
 export type AgentType = 'blackbox' | 'claude' | 'codex' | 'gemini';
 /**
  * Determines if an agent should use direct client integration vs CLI execution.
@@ -10,6 +11,17 @@ export type AgentType = 'blackbox' | 'claude' | 'codex' | 'gemini';
  * Other agents use CLI execution for their specific implementations.
  */
 export declare function shouldUseDirectClient(agentType: AgentType): boolean;
+/**
+ * Options for building agent commands with multi-turn support
+ */
+export interface AgentCommandOptions {
+    /** Session ID for multi-turn conversations (used by Claude CLI --resume) */
+    sessionId?: string;
+    /** Whether this is the first message in the session */
+    isFirstMessage?: boolean;
+    /** Past messages/conversation history to prepend to the instruction (for multi-turn) */
+    pastMessages?: string;
+}
 /**
  * Builds the CLI command for the specified agent type.
  * This is the single source of truth for agent command generation,
@@ -18,19 +30,19 @@ export declare function shouldUseDirectClient(agentType: AgentType): boolean;
  * Note: For blackbox agent in single agent mode, direct client integration is preferred
  * over CLI execution to reuse existing streaming and tool infrastructure.
  */
-export declare function buildAgentCommand(agentType: AgentType, model: string, task: string): string;
+export declare function buildAgentCommand(agentType: AgentType, model: string, task: string, options?: AgentCommandOptions, settings?: LoadedSettings): string;
 /**
  * Builds the enhanced Claude command with jq parsing for readable output.
  * Used specifically in multi-agent scenarios for better output formatting.
  */
-export declare function buildClaudeCommandWithJqParsing(model: string, task: string, outputFile: string): string;
+export declare function buildClaudeCommandWithJqParsing(model: string, task: string, outputFile: string, settings?: LoadedSettings): string;
 /**
  * Builds the enhanced Codex command with jq parsing for readable output.
  * Used specifically in multi-agent scenarios for better output formatting.
  */
-export declare function buildCodexCommandWithJqParsing(model: string, task: string, outputFile: string): string;
+export declare function buildCodexCommandWithJqParsing(model: string, task: string, outputFile: string, settings?: LoadedSettings): string;
 /**
  * Builds the enhanced Gemini command with jq parsing for readable output.
  * Used specifically in multi-agent scenarios for better output formatting.
  */
-export declare function buildGeminiCommandWithJqParsing(model: string, task: string, outputFile: string): string;
+export declare function buildGeminiCommandWithJqParsing(model: string, task: string, outputFile: string, settings?: LoadedSettings): string;

package/dist/src/utils/agentCommandBuilder.js

@@ -4,6 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { resolveOpenAIModel } from '@blackbox_ai/blackbox-cli-core';
+import { getEffectiveApiKey } from './apiKeyUtils.js';
 /**
  * Determines if an agent should use direct client integration vs CLI execution.
  * Blackbox agent uses the existing Gemini client directly to reuse streaming, tools, and UI components.
@@ -20,28 +21,56 @@ export function shouldUseDirectClient(agentType) {
  * Note: For blackbox agent in single agent mode, direct client integration is preferred
  * over CLI execution to reuse existing streaming and tool infrastructure.
  */
-export function buildAgentCommand(agentType, model, task) {
+export function buildAgentCommand(agentType, model, task, options, settings) {
     // Escape single quotes in the task for shell safety
     const escapedTask = task.replace(/'/g, "'\\''");
     switch (agentType) {
-        case 'blackbox':
-            return `blackbox -p '${escapedTask}' -y`;
+        case 'blackbox': {
+            // For multi-turn support: prepend past messages to the instruction
+            // This follows the remote-code approach which is simpler and more reliable
+            let finalInstruction = escapedTask;
+            if (options?.pastMessages) {
+                // Escape the past messages for shell safety
+                const escapedPastMessages = options.pastMessages.replace(/'/g, "'\\''");
+                finalInstruction = `${escapedPastMessages}\n\nFOLLOWUP REQUEST:\n${escapedTask}`;
+            }
+            return `blackbox -p '${finalInstruction}' -y`;
+        }
         case 'claude': {
-            const blackboxApiKey = process.env['BLACKBOX_API_KEY'];
+            const blackboxApiKey = getEffectiveApiKey('claude', settings);
             if (!blackboxApiKey) {
-                throw new Error('BLACKBOX_API_KEY environment variable is required for Claude agent');
+                throw new Error('BLACKBOX_API_KEY is required for Claude Code agent. Please run "/agent configure" to set up your API key.');
+            }
+            // For multi-turn support: prepend past messages to the instruction
+            // This follows the remote-code approach which is simpler and more reliable
+            let finalInstruction = escapedTask;
+            if (options?.pastMessages) {
+                // Escape the past messages for shell safety
+                const escapedPastMessages = options.pastMessages.replace(/'/g, "'\\''");
+                finalInstruction = `${escapedPastMessages}\n\nFOLLOWUP REQUEST:\n${escapedTask}`;
             }
-            return `ANTHROPIC_API_KEY="${blackboxApiKey}" ANTHROPIC_BASE_URL="https://api.blackbox.ai" claude --model "${model}" -p --output-format=stream-json --include-partial-messages --dangerously-skip-permissions --verbose '${escapedTask}'`;
+            return `ANTHROPIC_API_KEY="${blackboxApiKey}" ANTHROPIC_BASE_URL="https://api.blackbox.ai" claude --model "${model}" -p --output-format=stream-json --include-partial-messages --dangerously-skip-permissions --verbose '${finalInstruction}'`;
         }
         case 'codex': {
+            // Get effective API keys from both environment and settings
+            const blackboxApiKey = getEffectiveApiKey('blackbox', settings);
+            const openaiApiKey = getEffectiveApiKey('codex', settings);
             // Resolve model to use Blackbox provider if available
             const apiKeys = {
-                blackbox_api_key: process.env['BLACKBOX_API_KEY'],
-                openai_api_key: process.env['OPENAI_API_KEY']
+                blackbox_api_key: blackboxApiKey,
+                openai_api_key: openaiApiKey
             };
             const resolved = resolveOpenAIModel(model, apiKeys);
             if (!resolved.userApiKey) {
-                throw new Error('Either BLACKBOX_API_KEY or OPENAI_API_KEY environment variable is required for Codex agent');
+                throw new Error('Either BLACKBOX_API_KEY or OPENAI_API_KEY is required for Codex agent. Please run "/agent configure" to set up your API key.');
+            }
+            // For multi-turn support: prepend past messages to the instruction
+            // This follows the remote-code approach which is simpler and more reliable
+            let finalInstruction = escapedTask;
+            if (options?.pastMessages) {
+                // Escape the past messages for shell safety
+                const escapedPastMessages = options.pastMessages.replace(/'/g, "'\\''");
+                finalInstruction = `${escapedPastMessages}\n\nFOLLOWUP REQUEST:\n${escapedTask}`;
             }
             // Check if using Blackbox provider
             if (resolved.selectedModel.startsWith('blackboxai/')) {
@@ -67,7 +96,7 @@ log_requests = true`;
                 return `mkdir -p ~/.codex && cat > ~/.codex/config.toml << 'EOF'
 ${configToml}
 EOF
-BLACKBOX_API_KEY="${resolved.userApiKey}" codex exec --json --dangerously-bypass-approvals-and-sandbox '${escapedTask}'`;
+BLACKBOX_API_KEY="${resolved.userApiKey}" codex exec --json --skip-git-repo-check --dangerously-bypass-approvals-and-sandbox '${finalInstruction}'`;
             }
             else {
                 // Create config.toml for OpenAI provider
@@ -90,15 +119,23 @@ log_requests = true`;
                 return `mkdir -p ~/.codex && cat > ~/.codex/config.toml << 'EOF'
 ${configToml}
 EOF
-OPENAI_API_KEY="${resolved.userApiKey}" codex exec --json --dangerously-bypass-approvals-and-sandbox '${escapedTask}'`;
+OPENAI_API_KEY="${resolved.userApiKey}" codex exec --json --skip-git-repo-check --dangerously-bypass-approvals-and-sandbox '${finalInstruction}'`;
             }
         }
         case 'gemini': {
-            const geminiApiKey = process.env['GEMINI_API_KEY'];
+            const geminiApiKey = getEffectiveApiKey('gemini', settings);
             if (!geminiApiKey) {
-                throw new Error('GEMINI_API_KEY environment variable is required for Gemini agent');
+                throw new Error('GEMINI_API_KEY is required for Gemini agent. Please run "/agent configure" to set up your API key.');
+            }
+            // For multi-turn support: prepend past messages to the instruction
+            // This follows the remote-code approach which is simpler and more reliable
+            let finalInstruction = escapedTask;
+            if (options?.pastMessages) {
+                // Escape the past messages for shell safety
+                const escapedPastMessages = options.pastMessages.replace(/'/g, "'\\''");
+                finalInstruction = `${escapedPastMessages}\n\nFOLLOWUP REQUEST:\n${escapedTask}`;
             }
-            return `GEMINI_API_KEY="${geminiApiKey}" gemini --model "${model}" --yolo '${escapedTask}' --output-format stream-json`;
+            return `GEMINI_API_KEY="${geminiApiKey}" gemini --model "${model}" --yolo '${finalInstruction}' --output-format stream-json`;
         }
         default:
             throw new Error(`Unsupported agent type: ${agentType}`);
@@ -108,10 +145,10 @@ OPENAI_API_KEY="${resolved.userApiKey}" codex exec --json --dangerously-bypass-a
  * Builds the enhanced Claude command with jq parsing for readable output.
  * Used specifically in multi-agent scenarios for better output formatting.
  */
-export function buildClaudeCommandWithJqParsing(model, task, outputFile) {
-    const blackboxApiKey = process.env['BLACKBOX_API_KEY'];
+export function buildClaudeCommandWithJqParsing(model, task, outputFile, settings) {
+    const blackboxApiKey = getEffectiveApiKey('claude', settings);
     if (!blackboxApiKey) {
-        throw new Error('BLACKBOX_API_KEY environment variable is required for Claude agent');
+        throw new Error('BLACKBOX_API_KEY is required for Claude Code agent. Please run "/agent configure" to set up your API key.');
     }
     const escapedTask = task.replace(/'/g, "'\\''");
     return `ANTHROPIC_API_KEY="${blackboxApiKey}" ANTHROPIC_BASE_URL="https://api.blackbox.ai" claude --model "${model}" -p --output-format=stream-json --dangerously-skip-permissions --verbose '${escapedTask}' 2>&1 | jq -r '
@@ -149,15 +186,18 @@ export function buildClaudeCommandWithJqParsing(model, task, outputFile) {
  * Builds the enhanced Codex command with jq parsing for readable output.
  * Used specifically in multi-agent scenarios for better output formatting.
  */
-export function buildCodexCommandWithJqParsing(model, task, outputFile) {
+export function buildCodexCommandWithJqParsing(model, task, outputFile, settings) {
+    // Get effective API keys from both environment and settings
+    const blackboxApiKey = getEffectiveApiKey('blackbox', settings);
+    const openaiApiKey = getEffectiveApiKey('codex', settings);
     // Resolve model to use Blackbox provider if available
     const apiKeys = {
-        blackbox_api_key: process.env['BLACKBOX_API_KEY'],
-        openai_api_key: process.env['OPENAI_API_KEY']
+        blackbox_api_key: blackboxApiKey,
+        openai_api_key: openaiApiKey
     };
     const resolved = resolveOpenAIModel(model, apiKeys);
     if (!resolved.userApiKey) {
-        throw new Error('Either BLACKBOX_API_KEY or OPENAI_API_KEY environment variable is required for Codex agent');
+        throw new Error('Either BLACKBOX_API_KEY or OPENAI_API_KEY is required for Codex agent. Please run "/agent configure" to set up your API key.');
     }
     const escapedTask = task.replace(/'/g, "'\\''");
     // Check if using Blackbox provider
@@ -182,7 +222,7 @@ log_requests = true`;
         return `mkdir -p ~/.codex && cat > ~/.codex/config.toml << 'EOF'
 ${configToml}
 EOF
-BLACKBOX_API_KEY="${resolved.userApiKey}" codex exec --json --dangerously-bypass-approvals-and-sandbox '${escapedTask}' 2>&1 | jq -r '
+BLACKBOX_API_KEY="${resolved.userApiKey}" codex exec --json --skip-git-repo-check --dangerously-bypass-approvals-and-sandbox '${escapedTask}' 2>&1 | jq -r '
   if .type == "item.completed" and .item.type == "agent_message" then
     .item.text
   elif .type == "item.started" and .item.type == "command_execution" then 
@@ -227,7 +267,7 @@ log_requests = true`;
         return `mkdir -p ~/.codex && cat > ~/.codex/config.toml << 'EOF'
 ${configToml}
 EOF
-OPENAI_API_KEY="${resolved.userApiKey}" codex exec --json --dangerously-bypass-approvals-and-sandbox '${escapedTask}' 2>&1 | jq -r '
+OPENAI_API_KEY="${resolved.userApiKey}" codex exec --json --skip-git-repo-check --dangerously-bypass-approvals-and-sandbox '${escapedTask}' 2>&1 | jq -r '
   if .type == "item.completed" and .item.type == "agent_message" then
     .item.text
   elif .type == "item.started" and .item.type == "command_execution" then 
@@ -257,10 +297,10 @@ OPENAI_API_KEY="${resolved.userApiKey}" codex exec --json --dangerously-bypass-a
  * Builds the enhanced Gemini command with jq parsing for readable output.
  * Used specifically in multi-agent scenarios for better output formatting.
  */
-export function buildGeminiCommandWithJqParsing(model, task, outputFile) {
-    const geminiApiKey = process.env['GEMINI_API_KEY'];
+export function buildGeminiCommandWithJqParsing(model, task, outputFile, settings) {
+    const geminiApiKey = getEffectiveApiKey('gemini', settings);
     if (!geminiApiKey) {
-        throw new Error('GEMINI_API_KEY environment variable is required for Gemini agent');
+        throw new Error('GEMINI_API_KEY is required for Gemini agent. Please run "/agent configure" to set up your API key.');
     }
     const escapedTask = task.replace(/'/g, "'\\''");
     return `GEMINI_API_KEY="${geminiApiKey}" gemini --model "${model}" --yolo '${escapedTask}' --output-format stream-json | jq -r '

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

@@ -1 +1 @@
-{"version":3,"file":"agentCommandBuilder.js","sourceRoot":"","sources":["../../../src/utils/agentCommandBuilder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIpE;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAoB;IACxD,OAAO,SAAS,KAAK,UAAU,CAAC;AAClC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAoB,EACpB,KAAa,EACb,IAAY;IAEZ,oDAAoD;IACpD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEhD,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,UAAU;YACb,OAAO,gBAAgB,WAAW,MAAM,CAAC;QAE3C,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;YACvD,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;YACxF,CAAC;YACD,OAAO,sBAAsB,cAAc,kEAAkE,KAAK,yGAAyG,WAAW,GAAG,CAAC;QAC5O,CAAC;QAED,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,sDAAsD;YACtD,MAAM,OAAO,GAAG;gBACd,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;gBACjD,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;aAC9C,CAAC;YAEF,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACpD,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,4FAA4F,CAAC,CAAC;YAChH,CAAC;YAED,mCAAmC;YACnC,IAAI,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gBACrD,qEAAqE;gBACrE,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC;gBAE7C,2CAA2C;gBAC3C,MAAM,UAAU,GAAG,YAAY,aAAa;;;;;;;;;;;;;;oBAchC,CAAC;gBAEb,kDAAkD;gBAClD,OAAO;EACb,UAAU;;oBAEQ,QAAQ,CAAC,UAAU,mEAAmE,WAAW,GAAG,CAAC;YACnH,CAAC;iBAAM,CAAC;gBACN,yCAAyC;gBACzC,MAAM,UAAU,GAAG,YAAY,QAAQ,CAAC,aAAa;;;;;;;;;;;;;;oBAczC,CAAC;gBAEb,yDAAyD;gBACzD,OAAO;EACb,UAAU;;kBAEM,QAAQ,CAAC,UAAU,mEAAmE,WAAW,GAAG,CAAC;YACjH,CAAC;QACH,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YACnD,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;YACtF,CAAC;YACD,OAAO,mBAAmB,YAAY,qBAAqB,KAAK,aAAa,WAAW,+BAA+B,CAAC;QAC1H,CAAC;QAED;YACE,MAAM,IAAI,KAAK,CAAC,2BAA2B,SAAS,EAAE,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,+BAA+B,CAC7C,KAAa,EACb,IAAY,EACZ,UAAkB;IAElB,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACvD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEhD,OAAO,sBAAsB,cAAc,kEAAkE,KAAK,8EAA8E,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA6BvM,UAAU,OAAO,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAC5C,KAAa,EACb,IAAY,EACZ,UAAkB;IAElB,sDAAsD;IACtD,MAAM,OAAO,GAAG;QACd,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QACjD,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;KAC9C,CAAC;IAEF,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAEpD,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,4FAA4F,CAAC,CAAC;IAChH,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEhD,mCAAmC;IACnC,IAAI,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACrD,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC;QAE7C,2CAA2C;QAC3C,MAAM,UAAU,GAAG,YAAY,aAAa;;;;;;;;;;;;;;oBAc5B,CAAC;QAEjB,OAAO;EACT,UAAU;;oBAEQ,QAAQ,CAAC,UAAU,mEAAmE,WAAW;;;;;;;;;;;;;;;;;;;;;;;MAuB/G,UAAU,OAAO,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,yCAAyC;QACzC,MAAM,UAAU,GAAG,YAAY,QAAQ,CAAC,aAAa;;;;;;;;;;;;;;oBAcrC,CAAC;QAEjB,OAAO;EACT,UAAU;;kBAEM,QAAQ,CAAC,UAAU,mEAAmE,WAAW;;;;;;;;;;;;;;;;;;;;;;;MAuB7G,UAAU,OAAO,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,+BAA+B,CAC7C,KAAa,EACb,IAAY,EACZ,UAAkB;IAElB,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACnD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEhD,OAAO,mBAAmB,YAAY,qBAAqB,KAAK,aAAa,WAAW;;;;;;;;;;;;;;;;;;;;oBAoBtE,UAAU,OAAO,CAAC;AACtC,CAAC"}
+{"version":3,"file":"agentCommandBuilder.js","sourceRoot":"","sources":["../../../src/utils/agentCommandBuilder.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright 2025 Blackbox
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AgentType } from '@blackbox_ai/blackbox-cli-core';
+import type { LoadedSettings } from '../config/settings.js';
+export interface ApiKeyInfo {
+    envVarName: string;
+    settingsPath: string;
+    displayName: string;
+    placeholder: string;
+    validator: (key: string) => boolean;
+    description: string;
+}
+/**
+ * Mapping of agent types to their API key requirements
+ */
+export declare const AGENT_API_KEY_MAP: Record<AgentType, ApiKeyInfo>;
+/**
+ * Check if an API key is available for the given agent type
+ * Checks both environment variables and settings
+ */
+export declare function hasApiKeyForAgent(agentType: AgentType, settings?: LoadedSettings): boolean;
+/**
+ * Get API key from settings for the given agent type
+ */
+export declare function getApiKeyFromSettings(agentType: AgentType, settings: LoadedSettings): string | undefined;
+/**
+ * Get the effective API key for an agent (env var takes precedence over settings)
+ */
+export declare function getEffectiveApiKey(agentType: AgentType, settings?: LoadedSettings): string | undefined;
+/**
+ * Save API key to settings for the given agent type
+ */
+export declare function saveApiKeyToSettings(agentType: AgentType, apiKey: string, settings: LoadedSettings): void;
+/**
+ * Get missing API key info for agents that don't have keys
+ */
+export declare function getMissingApiKeyInfo(agentTypes: AgentType[], settings?: LoadedSettings): ApiKeyInfo[];
+/**
+ * Validate API key format for a specific agent type
+ */
+export declare function validateApiKey(agentType: AgentType, apiKey: string): {
+    valid: boolean;
+    error?: string;
+};