@blackbox_ai/blackbox-cli-core 0.0.7 → 0.8.1

package/dist/src/utils/messageTruncator.js

@@ -0,0 +1,346 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { encoding_for_model, get_encoding } from "tiktoken";
+// --- Constants (inferred from context or standard defaults) ---
+const MIN_TOKENS_TO_PRESERVE = 20;
+const LARGE_CONTEXT_BUFFER = 1000;
+const STANDARD_CONTEXT_BUFFER = 500;
+const ANTHROPIC_LARGE_CONTEXT_THRESHOLD = 16000;
+const ANTHROPIC_LARGE_CONTEXT_MULTIPLIER = 0.9; // Safety buffer
+const SAFE_DEFAULT_MAX_TOKENS = 4096;
+const INITIAL_MESSAGES_TO_KEEP = 2; // Usually keeps System + 1
+export class MessageTruncator {
+    debugMode = false;
+    constructor(debugMode = false) {
+        this.debugMode = debugMode;
+    }
+    /**
+     * Helper to get the tokenizer for a model.
+     * Handles generic fallback if the model string isn't an exact match.
+     */
+    getTokenizer(model) {
+        try {
+            // Clean model name (e.g., "gpt-4-0613" -> "gpt-4") if needed, 
+            // but encoding_for_model usually handles specifics well.
+            return encoding_for_model(model);
+        }
+        catch (_e) {
+            return get_encoding("cl100k_base");
+        }
+    }
+    /**
+     * Helper to count tokens for text or a list of messages.
+     * This mimics the self.count_tokens behavior.
+     */
+    countTokens(enc, input) {
+        if (typeof input === 'string') {
+            return enc.encode(input).length;
+        }
+        // Rough estimation for message list overhead (similar to OpenAI cookbook)
+        let numTokens = 0;
+        const tokensPerMessage = 3;
+        for (const msg of input) {
+            numTokens += tokensPerMessage;
+            // Count content
+            if (typeof msg.content === 'string') {
+                numTokens += enc.encode(msg.content).length;
+            }
+            else if (Array.isArray(msg.content)) {
+                for (const block of msg.content) {
+                    if (block.type === 'text' && block.text) {
+                        numTokens += enc.encode(block.text).length;
+                    }
+                }
+            }
+            // Count tool calls if present
+            if (msg.tool_calls) {
+                for (const tool of msg.tool_calls) {
+                    if (tool.function && tool.function.arguments) {
+                        numTokens += enc.encode(tool.function.arguments).length;
+                    }
+                }
+            }
+        }
+        numTokens += 3; // every reply is primed with <|start|>assistant<|message|>
+        return numTokens;
+    }
+    /**
+     * Returns max token limits for models that may not be available in LiteLLM's get_model_info().
+     * Based on the comprehensive model mapping from the Python implementation.
+     */
+    getModelMaxTokens(model) {
+        const modelLower = model.toLowerCase();
+        // Exact model mappings
+        const modelToLengths = {
+            "anthropic/claude-opus-4": 200_000,
+            "anthropic/claude-opus-4.1": 200_000,
+            "moonshotai/kimi-k2": 260_000,
+            "image-gen": 4_096, // OpenAI GPT-4o image input token limit
+            "transcribe": 8_000, // Whisper-1 approximate limit
+            "custom/blackbox-base": 256_000, // grok-code-fast-1
+            "google/gemini-2.5-pro-preview": 1_048_576, // 1M tokens (Gemini 2.5 Pro)
+            "google/gemini-3-pro-preview": 1_048_576, // 1M tokens (Gemini 3 Pro)
+            "custom/claude-opus-4": 200_000,
+            "gemini-2.5-pro-preview-03-25": 1_048_576,
+            "grok-3-beta": 128_000, // Grok-3 beta by xAI (Elon Musk)
+            "llama-4-maverick-17b-128e-instruct-fp8": 128_000, // unofficial estimate
+            "qwen/qwen2.5-coder-32b-instruct": 128_000,
+            "qwen/qwen2.5-72b-instruct-turbo": 128_000,
+            "black-forest-labs/flux-schnell": 8_192, // estimate based on small models
+            "black-forest-labs/flux-kontext-max": 32_768, // larger context variant
+            "anthropic/claude-sonnet-4": 1_000_000,
+            "openrouter/claude-sonnet-4": 1_000_000,
+            "anthropic/claude-sonnet-4.5": 1_000_000,
+            "x-ai/grok-4-fast": 2_000_000,
+            "gpt-5": 400_000,
+            "kimi-k2-0905": 260_000,
+            "blackbox-pro-plus": 1_000_000,
+            "custom/blackbox-pro-plus": 1_000_000,
+            "custom/blackbox-pro": 1_000_000,
+            "gpt-4o-mini": 256_000, // grok-code-fast-1
+        };
+        // Check for exact match first
+        if (modelToLengths[model]) {
+            return modelToLengths[model];
+        }
+        if (modelToLengths[modelLower]) {
+            return modelToLengths[modelLower];
+        }
+        // Pattern-based matching for common model families
+        if (modelLower.includes("gpt-5"))
+            return 400_000;
+        if (modelLower.includes("gpt-4o") && modelLower.includes("mini"))
+            return 256_000;
+        if (modelLower.includes("gpt-4-turbo") || modelLower.includes("gpt-4-1106"))
+            return 128_000;
+        if (modelLower.includes("gpt-4-32k"))
+            return 32_768;
+        if (modelLower.includes("gpt-4"))
+            return 8_192;
+        if (modelLower.includes("gpt-3.5-turbo-16k"))
+            return 16_385;
+        if (modelLower.includes("gpt-3.5-turbo"))
+            return 4_096;
+        // Claude models
+        if (modelLower.includes("claude-sonnet-4"))
+            return 1_000_000;
+        if (modelLower.includes("claude-opus-4"))
+            return 200_000;
+        if (modelLower.includes("claude-3") || modelLower.includes("claude-2"))
+            return 200_000;
+        // Gemini models
+        if (modelLower.includes("gemini-2.5") || modelLower.includes("gemini-3"))
+            return 1_048_576;
+        if (modelLower.includes("gemini"))
+            return 1_048_576; // Default for Gemini family
+        // Blackbox models
+        if (modelLower.includes("blackbox-pro"))
+            return 1_000_000;
+        if (modelLower.includes("blackbox"))
+            return 256_000;
+        // Grok models
+        if (modelLower.includes("grok-4"))
+            return 2_000_000;
+        if (modelLower.includes("grok-3"))
+            return 128_000;
+        if (modelLower.includes("grok"))
+            return 128_000;
+        // Kimi models
+        if (modelLower.includes("kimi"))
+            return 260_000;
+        // Qwen models
+        if (modelLower.includes("qwen"))
+            return 128_000;
+        // LLaMA models
+        if (modelLower.includes("llama"))
+            return 128_000;
+        return 128_000; // Unknown model
+    }
+    /**
+     * Smartly truncates message content by targeting longer texts first.
+     */
+    truncateMessageContent(enc, messageContent, tokensToRemove) {
+        // 1. Handle Simple String
+        if (typeof messageContent === 'string') {
+            const tokens = enc.encode(messageContent);
+            const totalTokens = tokens.length;
+            const tokensToRemoveFromBlock = Math.min(tokensToRemove, totalTokens - Math.min(MIN_TOKENS_TO_PRESERVE, totalTokens));
+            if (tokensToRemoveFromBlock <= 0) {
+                return [messageContent, tokensToRemove];
+            }
+            const keepCount = Math.max(0, totalTokens - tokensToRemoveFromBlock);
+            const newTokens = tokens.subarray(0, keepCount);
+            const newText = new TextDecoder().decode(enc.decode(newTokens)) + '... [Message truncated]';
+            return [newText, tokensToRemove - tokensToRemoveFromBlock];
+        }
+        // 2. Handle Tool Calls Calculation (Python code did this check implicitly via message structure)
+        // Note: The python code checked 'tool_calls' on the message object, but here we are passed 
+        // message_content. If tool_calls affect the "content" budget, they should be handled before calling this,
+        // or passed in. Following the Python logic strictly, it handled "tool_calls" key in message_content dict.
+        // In TS interfaces, content is usually separate from tool_calls. 
+        // We will assume `tokensToRemove` passed here already accounts for tool overhead if needed.
+        // 3. Handle List of Content Blocks
+        if (Array.isArray(messageContent)) {
+            // Analyze text blocks
+            const textBlocks = [];
+            messageContent.forEach((block, idx) => {
+                if (block.type === 'text' && block.text) {
+                    const tokens = enc.encode(block.text);
+                    textBlocks.push({
+                        index: idx,
+                        text: block.text,
+                        tokens,
+                        token_count: tokens.length
+                    });
+                }
+            });
+            // Sort by length descending
+            textBlocks.sort((a, b) => b.token_count - a.token_count);
+            // Copy content to modify
+            // Deep clone to avoid mutating original immediately
+            const truncatedContent = JSON.parse(JSON.stringify(messageContent));
+            for (const block of textBlocks) {
+                const tokensToRemoveFromBlock = Math.min(tokensToRemove, block.token_count - Math.min(MIN_TOKENS_TO_PRESERVE, block.token_count));
+                if (tokensToRemoveFromBlock > 0) {
+                    const keepCount = Math.max(0, block.token_count - tokensToRemoveFromBlock);
+                    const newTokens = block.tokens.subarray(0, keepCount);
+                    const newText = new TextDecoder().decode(enc.decode(newTokens)) + '... [Message truncated]';
+                    truncatedContent[block.index].text = newText;
+                    tokensToRemove -= tokensToRemoveFromBlock;
+                }
+                if (tokensToRemove <= 0)
+                    break;
+            }
+            return [truncatedContent, tokensToRemove];
+        }
+        return [messageContent, tokensToRemove];
+    }
+    /**
+     * Main truncation method
+     */
+    truncateLongMessages(model, messages, maxOutputTokens = 8192, systemPrompt = null) {
+        // Filter out string-only messages if any (Python code did this)
+        let currentMessages = messages.filter(m => typeof m !== 'string');
+        let enc = null;
+        try {
+            enc = this.getTokenizer(model);
+            // Handle System Prompt insertion logic
+            let systemAddedToTop = false;
+            if (systemPrompt && currentMessages.length > 0 && currentMessages[0].role !== 'system') {
+                currentMessages = [{ role: 'system', content: systemPrompt }, ...currentMessages];
+                systemAddedToTop = true;
+            }
+            const currentInpTotalTokens = this.countTokens(enc, currentMessages);
+            if (this.debugMode) {
+                console.log(` ${model} - current_inp_total_tokens`, currentInpTotalTokens, currentMessages.length);
+            }
+            // --- Calculate Max Allowed Size ---
+            let maxInputTokens = this.getModelMaxTokens(model);
+            if (maxInputTokens === 0) {
+                maxInputTokens = SAFE_DEFAULT_MAX_TOKENS; // Fallback
+            }
+            let maxAllowedSize;
+            if (maxInputTokens > 500_000) {
+                maxAllowedSize = maxInputTokens - LARGE_CONTEXT_BUFFER - maxOutputTokens;
+            }
+            else {
+                maxAllowedSize = maxInputTokens - STANDARD_CONTEXT_BUFFER - maxOutputTokens;
+            }
+            // Anthropic specific logic check
+            if (currentInpTotalTokens > ANTHROPIC_LARGE_CONTEXT_THRESHOLD && model.toLowerCase().includes("anthropic")) {
+                maxAllowedSize = Math.floor(maxAllowedSize * ANTHROPIC_LARGE_CONTEXT_MULTIPLIER);
+            }
+            // --- Check if Truncation is Needed ---
+            if (currentInpTotalTokens <= maxAllowedSize) {
+                if (systemAddedToTop) {
+                    return currentMessages.slice(1);
+                }
+                return currentMessages;
+            }
+            // --- Truncation Logic ---
+            const truncatedMessages = [];
+            let tokensToRemove = currentInpTotalTokens - maxAllowedSize;
+            let removedTokens = 0;
+            // 1. Setup lists
+            let messagesToConsider = currentMessages.slice(0, -1); // All except last user message
+            // Always keep first message (System/Task)
+            if (currentMessages[0].role === 'system') {
+                truncatedMessages.push(currentMessages[0]);
+                messagesToConsider = messagesToConsider.slice(1);
+            }
+            // Keep INITIAL_MESSAGES_TO_KEEP from the start of what remains
+            if (messagesToConsider.length > 0) {
+                const keepCount = Math.min(messagesToConsider.length, INITIAL_MESSAGES_TO_KEEP);
+                truncatedMessages.push(...messagesToConsider.slice(0, keepCount));
+                messagesToConsider = messagesToConsider.slice(keepCount - 1); // Python logic was slice(INITIAL - 1)
+                // Note on Python Slice logic: 
+                // Python: truncated_messages.extend(messages[1:INITIAL_MESSAGES_TO_KEEP])
+                // Python: messages_to_consider = messages_to_consider[INITIAL_MESSAGES_TO_KEEP - 1:]
+                // We replicate this behavior here:
+            }
+            // 2. Remove "Middle" Messages
+            const truncatedMiddleMessages = [];
+            for (const message of messagesToConsider) {
+                if (removedTokens >= tokensToRemove) {
+                    truncatedMiddleMessages.push(message);
+                    continue;
+                }
+                // Count tokens for this specific message
+                const fullMsgTokens = this.countTokens(enc, [message]);
+                removedTokens += fullMsgTokens;
+            }
+            tokensToRemove -= removedTokens;
+            // 3. Handle the "Last of the Initial Kept Messages" (Trim tail of the head)
+            if (tokensToRemove > 0 && truncatedMessages.length > 0) {
+                const lastIndex = truncatedMessages.length - 1;
+                const [newContent, remainingTokens] = this.truncateMessageContent(enc, truncatedMessages[lastIndex].content, tokensToRemove);
+                truncatedMessages[lastIndex].content = newContent;
+                tokensToRemove = remainingTokens;
+            }
+            // 4. Reassemble
+            truncatedMessages.push(...truncatedMiddleMessages);
+            // Add the final user message back
+            truncatedMessages.push(currentMessages[currentMessages.length - 1]);
+            // 5. Trim the final user message if needed
+            if (tokensToRemove > 0) {
+                const lastIndex = truncatedMessages.length - 1;
+                const [newContent, remainingTokens] = this.truncateMessageContent(enc, truncatedMessages[lastIndex].content, tokensToRemove);
+                truncatedMessages[lastIndex].content = newContent;
+                tokensToRemove = remainingTokens;
+            }
+            // --- Final Safety Check ---
+            let inpTotalTokensAfter = this.countTokens(enc, truncatedMessages);
+            if (inpTotalTokensAfter > maxInputTokens) {
+                if (truncatedMessages[0].role === 'system') {
+                    // Keep System + Last Message
+                    const newTruncated = [truncatedMessages[0], truncatedMessages[truncatedMessages.length - 1]];
+                    inpTotalTokensAfter = this.countTokens(enc, newTruncated);
+                    // Clean up system if it was virtually added
+                    if (systemAddedToTop)
+                        return newTruncated.slice(1);
+                    return newTruncated;
+                }
+                else {
+                    // Keep Last Message Only
+                    const newTruncated = [truncatedMessages[truncatedMessages.length - 1]];
+                    inpTotalTokensAfter = this.countTokens(enc, newTruncated);
+                    return newTruncated;
+                }
+            }
+            if (systemAddedToTop) {
+                return truncatedMessages.slice(1);
+            }
+            return truncatedMessages;
+        }
+        finally {
+            // Free the tokenizer memory
+            if (enc) {
+                enc.free();
+            }
+        }
+    }
+}
+//# sourceMappingURL=messageTruncator.js.map

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

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

package/dist/src/utils/pathReader.js

@@ -20,17 +20,37 @@ export async function readPathFromWorkspace(pathStr, config) {
     const workspace = config.getWorkspaceContext();
     const fileService = config.getFileService();
     let absolutePath = null;
-    if (path.isAbsolute(pathStr)) {
-        if (!workspace.isPathWithinWorkspace(pathStr)) {
-            throw new Error(`Absolute path is outside of the allowed workspace: ${pathStr}`);
+    // Clean up escaped characters from terminal paste (e.g., "Screenshot\ 2025" -> "Screenshot 2025")
+    const cleanedPath = pathStr.replace(/\\ /g, ' ').replace(/\\$/g, '');
+    if (path.isAbsolute(cleanedPath)) {
+        // Special handling for macOS temp directories (screenshots)
+        // These paths start with /var/folders/ or /private/var/folders/
+        const isMacOSTempPath = cleanedPath.startsWith('/var/folders/') ||
+            cleanedPath.startsWith('/private/var/folders/') ||
+            cleanedPath.startsWith('/tmp/') ||
+            cleanedPath.startsWith('/private/tmp/');
+        if (isMacOSTempPath) {
+            // Allow reading from macOS temp directories for screenshot support
+            try {
+                await fs.access(cleanedPath);
+                absolutePath = cleanedPath;
+            }
+            catch (_error) {
+                throw new Error(`macOS temp file not accessible (may have been deleted): ${cleanedPath}`);
+            }
+        }
+        else if (!workspace.isPathWithinWorkspace(cleanedPath)) {
+            throw new Error(`Absolute path is outside of the allowed workspace: ${cleanedPath}`);
+        }
+        else {
+            absolutePath = cleanedPath;
         }
-        absolutePath = pathStr;
     }
     else {
         // Prioritized search for relative paths.
         const searchDirs = workspace.getDirectories();
         for (const dir of searchDirs) {
-            const potentialPath = path.resolve(dir, pathStr);
+            const potentialPath = path.resolve(dir, cleanedPath);
             try {
                 await fs.access(potentialPath);
                 absolutePath = potentialPath;
@@ -42,7 +62,7 @@ export async function readPathFromWorkspace(pathStr, config) {
         }
     }
     if (!absolutePath) {
-        throw new Error(`Path not found in workspace: ${pathStr}`);
+        throw new Error(`Path not found in workspace: ${cleanedPath}`);
     }
     const stats = await fs.stat(absolutePath);
     if (stats.isDirectory()) {

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

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

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

@@ -0,0 +1,65 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface SkillMetadata {
+    name: string;
+    description: string;
+}
+export interface Skill extends SkillMetadata {
+    skillName: string;
+    filePath: string;
+}
+/**
+ * Get the available skills for the current environment.
+ * Reads the skills folder in .blackbox folder in the workspace,
+ * returns the name and description of the skills by reading SKILL.md file.
+ *
+ * Directory structure: <workspace>/.blackbox/skills/<skill_name>/SKILL.md
+ *
+ * Every SKILL.md consists of:
+ * - Frontmatter (YAML): Contains name and description fields. These are the only
+ *   fields that Claude reads to determine when the skill gets used, thus it is
+ *   very important to be clear and comprehensive in describing what the skill is,
+ *   and when it should be used.
+ * - Body (Markdown): Instructions and guidance for using the skill. Only loaded
+ *   AFTER the skill triggers (if at all).
+ *
+ * @param workspaceRoot - The root directory of the workspace
+ * @returns A formatted string of available skills for system prompt injection, or undefined if no skills found
+ */
+export declare function getAvailableSkills(workspaceRoot: string): Promise<string | undefined>;
+/**
+ * Extract YAML frontmatter metadata from a SKILL.md file
+ * @param content - The full content of the SKILL.md file
+ * @returns The parsed metadata or null if no valid frontmatter found
+ */
+export declare function extractSkillMetadata(content: string): SkillMetadata | null;
+/**
+ * Read and return the full content of a skill (without frontmatter)
+ * @param workspaceRoot - The root directory of the workspace
+ * @param skillName - The name of the skill directory
+ * @returns The skill content without YAML frontmatter, or null if not found
+ */
+export declare function getSkillContent(workspaceRoot: string, skillName: string): Promise<{
+    content: string;
+    baseDir: string;
+} | null>;
+/**
+ * Create a new skill with a template SKILL.md file
+ * @param workspaceRoot - The root directory of the workspace
+ * @param skillName - The name of the skill to create
+ * @returns Success status and error message if failed
+ */
+export declare function createSkill(workspaceRoot: string, skillName: string): Promise<{
+    success: boolean;
+    error?: string;
+    skillPath?: string;
+}>;
+/**
+ * List all available skills in the workspace
+ * @param workspaceRoot - The root directory of the workspace
+ * @returns Array of skill information
+ */
+export declare function listSkills(workspaceRoot: string): Promise<Skill[]>;