@blackbox_ai/blackbox-cli 0.8.6 → 1.0.2

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

@@ -0,0 +1,200 @@
+/**
+ * @license
+ * 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.
+ * This implementation writes directly to the TTY file descriptor to avoid
+ * any buffering or interference with stdin/stdout streams.
+ * @returns Promise that resolves to 'light' or 'dark', or null if detection fails
+ */
+export async function detectTerminalBackground() {
+    // 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 \
+            // 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);
+                // Calculate relative luminance using the formula from WCAG
+                // https://www.w3.org/TR/WCAG20/#relativeluminancedef
+                const luminance = (0.2126 * r + 0.7152 * g + 0.0722 * b) / 255;
+                const result = luminance > 0.5 ? 'light' : 'dark';
+                // Clean up immediately and resolve
+                cleanup();
+                resolve(result);
+            }
+        };
+        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
+            // 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
+            // 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 default theme name based on terminal background detection.
+ * Falls back to 'Blackbox Dark' if detection fails.
+ * @returns Promise that resolves to the theme name
+ */
+export async function getDefaultThemeForTerminal() {
+    const background = await detectTerminalBackground();
+    if (background === 'light') {
+        return 'Blackbox Light';
+    }
+    // Default to dark theme if detection fails or background is dark
+    return 'Blackbox Dark';
+}
+//# sourceMappingURL=terminalBackgroundDetector.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,48 @@
+/**
+ * @license
+ * 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.
+ * Blackbox agent uses the existing Gemini client directly to reuse streaming, tools, and UI components.
+ * 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,
+ * used by both single agent and multi-agent systems.
+ *
+ * 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, 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, 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, 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, settings?: LoadedSettings): string;

package/dist/src/utils/agentCommandBuilder.js

@@ -0,0 +1,328 @@
+/**
+ * @license
+ * Copyright 2025 Blackbox
+ * 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.
+ * Other agents use CLI execution for their specific implementations.
+ */
+export function shouldUseDirectClient(agentType) {
+    return agentType === 'blackbox';
+}
+/**
+ * Builds the CLI command for the specified agent type.
+ * This is the single source of truth for agent command generation,
+ * used by both single agent and multi-agent systems.
+ *
+ * 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, options, settings) {
+    // Escape single quotes in the task for shell safety
+    const escapedTask = task.replace(/'/g, "'\\''");
+    switch (agentType) {
+        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 = getEffectiveApiKey('claude', settings);
+            if (!blackboxApiKey) {
+                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 '${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: blackboxApiKey,
+                openai_api_key: openaiApiKey
+            };
+            const resolved = resolveOpenAIModel(model, apiKeys);
+            if (!resolved.userApiKey) {
+                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/')) {
+                // Use the full Blackbox model name (e.g., blackboxai/openai/gpt-5.1)
+                const blackboxModel = resolved.selectedModel;
+                // Create config.toml for Blackbox provider
+                const configToml = `model = "${blackboxModel}"
+model_provider = "blackbox-ai-gateway"
+
+[shell_environment_policy]
+ignore_default_excludes = true
+inherit = "all"
+
+[model_providers.blackbox-ai-gateway]
+name = "BlackBox AI Gateway"
+base_url = "https://api.blackbox.ai/v1"
+env_key = "BLACKBOX_API_KEY"
+wire_api = "chat"
+
+[debug]
+log_requests = true`;
+                // Use Blackbox provider with custom configuration
+                return `mkdir -p ~/.codex && cat > ~/.codex/config.toml << 'EOF'
+${configToml}
+EOF
+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
+                const configToml = `model = "${resolved.selectedModel}"
+model_provider = "openai"
+
+[shell_environment_policy]
+ignore_default_excludes = true
+inherit = "all"
+
+[model_providers.openai]
+name = "OpenAI"
+base_url = "https://api.openai.com/v1"
+env_key = "OPENAI_API_KEY"
+wire_api = "responses"
+
+[debug]
+log_requests = true`;
+                // Use original OpenAI provider with custom configuration
+                return `mkdir -p ~/.codex && cat > ~/.codex/config.toml << 'EOF'
+${configToml}
+EOF
+OPENAI_API_KEY="${resolved.userApiKey}" codex exec --json --skip-git-repo-check --dangerously-bypass-approvals-and-sandbox '${finalInstruction}'`;
+            }
+        }
+        case 'gemini': {
+            const geminiApiKey = getEffectiveApiKey('gemini', settings);
+            if (!geminiApiKey) {
+                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 '${finalInstruction}' --output-format stream-json`;
+        }
+        default:
+            throw new Error(`Unsupported agent type: ${agentType}`);
+    }
+}
+/**
+ * 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, settings) {
+    const blackboxApiKey = getEffectiveApiKey('claude', settings);
+    if (!blackboxApiKey) {
+        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 '
+  if .type == "assistant" and .message.content then
+    .message.content[] | 
+    if .type == "text" then .text
+    elif .type == "tool_use" then 
+      "+-------------------------------------------------------------+\\n" +
+      "| 🔧 TOOL USE: \\(.name)\\n" +
+      "+-------------------------------------------------------------+\\n" +
+      "| Input:\\n" +
+      ((.input | @json | split("\\n")) | map("|   " + .) | join("\\n")) + "\\n" +
+      "+-------------------------------------------------------------+\\n"
+    else empty
+    end
+  elif .type == "user" and .message.content then
+    .message.content[] |
+    if .type == "tool_result" then 
+      "\\n" +
+      ((.content | split("\\n")) as $lines |
+      if ($lines | length) > 10 then
+        ($lines[:10] | join("\\n")) + "\\n" +
+        "\\n... (\\($lines | length - 10) more lines hidden) ...\\n"
+      else
+        $lines | join("\\n")
+      end) +
+      "\\n"
+    else empty
+    end
+  else empty
+  end
+' > ${outputFile} 2>&1`;
+}
+/**
+ * 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, 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: blackboxApiKey,
+        openai_api_key: openaiApiKey
+    };
+    const resolved = resolveOpenAIModel(model, apiKeys);
+    if (!resolved.userApiKey) {
+        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
+    if (resolved.selectedModel.startsWith('blackboxai/')) {
+        const blackboxModel = resolved.selectedModel;
+        // Create config.toml for Blackbox provider
+        const configToml = `model = "${blackboxModel}"
+model_provider = "blackbox-ai-gateway"
+
+[shell_environment_policy]
+ignore_default_excludes = true
+inherit = "all"
+
+[model_providers.blackbox-ai-gateway]
+name = "BlackBox AI Gateway"
+base_url = "https://api.blackbox.ai/v1"
+env_key = "BLACKBOX_API_KEY"
+wire_api = "chat"
+
+[debug]
+log_requests = true`;
+        return `mkdir -p ~/.codex && cat > ~/.codex/config.toml << 'EOF'
+${configToml}
+EOF
+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 
+    "\\n🔧 EXECUTING: " + .item.command + "\\n"
+  elif .type == "item.completed" and .item.type == "command_execution" then
+    if .item.exit_code == 0 then
+      ((.item.aggregated_output | split("\\n")) as $lines |
+      if ($lines | length) > 20 then
+        ($lines[:20] | join("\\n")) + "\\n" +
+        "\\n... (\\($lines | length - 20) more lines hidden) ...\\n"
+      else
+        $lines | join("\\n")
+      end) + "\\n"
+    else
+      "❌ Command failed with exit code: " + (.item.exit_code | tostring) + "\\n" + .item.aggregated_output + "\\n"
+    end
+  elif .type == "turn.started" then
+    "🚀 Starting Codex execution...\\n"
+  elif .type == "turn.completed" then
+    "✅ Codex execution completed.\\n"
+  else empty
+  end
+' > ${outputFile} 2>&1`;
+    }
+    else {
+        // Create config.toml for OpenAI provider
+        const configToml = `model = "${resolved.selectedModel}"
+model_provider = "openai"
+
+[shell_environment_policy]
+ignore_default_excludes = true
+inherit = "all"
+
+[model_providers.openai]
+name = "OpenAI"
+base_url = "https://api.openai.com/v1"
+env_key = "OPENAI_API_KEY"
+wire_api = "responses"
+
+[debug]
+log_requests = true`;
+        return `mkdir -p ~/.codex && cat > ~/.codex/config.toml << 'EOF'
+${configToml}
+EOF
+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 
+    "\\n🔧 EXECUTING: " + .item.command + "\\n"
+  elif .type == "item.completed" and .item.type == "command_execution" then
+    if .item.exit_code == 0 then
+      ((.item.aggregated_output | split("\\n")) as $lines |
+      if ($lines | length) > 20 then
+        ($lines[:20] | join("\\n")) + "\\n" +
+        "\\n... (\\($lines | length - 20) more lines hidden) ...\\n"
+      else
+        $lines | join("\\n")
+      end) + "\\n"
+    else
+      "❌ Command failed with exit code: " + (.item.exit_code | tostring) + "\\n" + .item.aggregated_output + "\\n"
+    end
+  elif .type == "turn.started" then
+    "🚀 Starting Codex execution...\\n"
+  elif .type == "turn.completed" then
+    "✅ Codex execution completed.\\n"
+  else empty
+  end
+' > ${outputFile} 2>&1`;
+    }
+}
+/**
+ * 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, settings) {
+    const geminiApiKey = getEffectiveApiKey('gemini', settings);
+    if (!geminiApiKey) {
+        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 '
+def hr(n): ("─" * n);
+
+def box(title; body):
+  "\\n┌" + hr(78) + "┐\\n" +
+  "│ " + (title | ascii_upcase) + (" " * (77 - (title|length))) + "│\\n" +
+  "├" + hr(78) + "┤\\n" +
+  (body
+    | split("\\n")
+    | map("│ " + . + (" " * (77 - (. | length))))
+    | join("\\n")
+  ) +
+  "\\n└" + hr(78) + "┘";
+
+if .type == "message" and .role == "assistant" then
+  box("assistant"; .content)
+elif .type == "tool_use" then
+  box("tool call: " + .tool_name; "INPUT:\\n" + (.parameters | tojson))
+elif .type == "tool_result" then
+  box("tool result"; "STATUS: " + .status + (if .output != null and .output != "" then "\\nOUTPUT:\\n" + .output else "" end))
+else empty end' > ${outputFile} 2>&1`;
+}
+//# sourceMappingURL=agentCommandBuilder.js.map

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

@@ -0,0 +1 @@
+{"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;
+};