@blackbox_ai/blackbox-cli 0.0.9 → 0.8.1

package/dist/src/services/elevenLabsErrors.js

@@ -0,0 +1,233 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * ElevenLabs API error codes and types based on official documentation
+ * https://elevenlabs.io/docs/api-reference/error-messages
+ */
+/**
+ * Error codes returned by ElevenLabs API
+ */
+export var ElevenLabsErrorCode;
+(function (ElevenLabsErrorCode) {
+    // 400/401 errors
+    ElevenLabsErrorCode["MAX_CHARACTER_LIMIT_EXCEEDED"] = "max_character_limit_exceeded";
+    ElevenLabsErrorCode["INVALID_API_KEY"] = "invalid_api_key";
+    ElevenLabsErrorCode["QUOTA_EXCEEDED"] = "quota_exceeded";
+    ElevenLabsErrorCode["VOICE_NOT_FOUND"] = "voice_not_found";
+    // 403 errors
+    ElevenLabsErrorCode["ONLY_FOR_CREATOR_PLUS"] = "only_for_creator+";
+    // 429 errors
+    ElevenLabsErrorCode["TOO_MANY_CONCURRENT_REQUESTS"] = "too_many_concurrent_requests";
+    ElevenLabsErrorCode["SYSTEM_BUSY"] = "system_busy";
+    // Generic/Unknown
+    ElevenLabsErrorCode["UNKNOWN"] = "unknown";
+})(ElevenLabsErrorCode || (ElevenLabsErrorCode = {}));
+/**
+ * Error type categories for easier handling
+ */
+export var ElevenLabsErrorType;
+(function (ElevenLabsErrorType) {
+    ElevenLabsErrorType["AUTHENTICATION"] = "authentication";
+    ElevenLabsErrorType["PERMISSION"] = "permission";
+    ElevenLabsErrorType["QUOTA"] = "quota";
+    ElevenLabsErrorType["RATE_LIMIT"] = "rate_limit";
+    ElevenLabsErrorType["VALIDATION"] = "validation";
+    ElevenLabsErrorType["NETWORK"] = "network";
+    ElevenLabsErrorType["UNKNOWN"] = "unknown";
+})(ElevenLabsErrorType || (ElevenLabsErrorType = {}));
+/**
+ * Map of error codes to detailed error information
+ */
+export const ELEVENLABS_ERROR_MAP = {
+    [ElevenLabsErrorCode.MAX_CHARACTER_LIMIT_EXCEEDED]: {
+        code: ElevenLabsErrorCode.MAX_CHARACTER_LIMIT_EXCEEDED,
+        type: ElevenLabsErrorType.VALIDATION,
+        httpStatus: 400,
+        message: 'You are sending too many characters in a single request.',
+        solution: 'Split the request into smaller chunks. Check the character limits for your model at https://elevenlabs.io/docs/api-reference/text-to-speech#character-limits',
+        documentationUrl: 'https://elevenlabs.io/docs/api-reference/text-to-speech#character-limits',
+    },
+    [ElevenLabsErrorCode.INVALID_API_KEY]: {
+        code: ElevenLabsErrorCode.INVALID_API_KEY,
+        type: ElevenLabsErrorType.AUTHENTICATION,
+        httpStatus: 401,
+        message: 'Your API key is invalid or has not been set correctly.',
+        solution: 'Ensure the request is correctly authenticated. Check your API key at https://elevenlabs.io/app/settings/api-keys and run: blackbox voice configure',
+        documentationUrl: 'https://elevenlabs.io/docs/api-reference/authentication',
+    },
+    [ElevenLabsErrorCode.QUOTA_EXCEEDED]: {
+        code: ElevenLabsErrorCode.QUOTA_EXCEEDED,
+        type: ElevenLabsErrorType.QUOTA,
+        httpStatus: 401,
+        message: 'You have insufficient quota to complete the request.',
+        solution: 'On the Creator plan and above, you can enable usage-based billing from your Subscription page at https://elevenlabs.io/app/subscription',
+        documentationUrl: 'https://elevenlabs.io/app/subscription',
+    },
+    [ElevenLabsErrorCode.VOICE_NOT_FOUND]: {
+        code: ElevenLabsErrorCode.VOICE_NOT_FOUND,
+        type: ElevenLabsErrorType.VALIDATION,
+        httpStatus: 400,
+        message: 'The voice_id you entered is incorrect.',
+        solution: 'Check that you are using the correct voice_id for the voice you want to use. You can verify this in My Voices at https://elevenlabs.io/app/voice-library',
+        documentationUrl: 'https://elevenlabs.io/app/voice-library',
+    },
+    [ElevenLabsErrorCode.ONLY_FOR_CREATOR_PLUS]: {
+        code: ElevenLabsErrorCode.ONLY_FOR_CREATOR_PLUS,
+        type: ElevenLabsErrorType.PERMISSION,
+        httpStatus: 403,
+        message: 'You are trying to use professional voices on a free or basic subscription.',
+        solution: 'Upgrade to Creator tier or higher to access professional voices at https://elevenlabs.io/pricing',
+        documentationUrl: 'https://elevenlabs.io/pricing',
+    },
+    [ElevenLabsErrorCode.TOO_MANY_CONCURRENT_REQUESTS]: {
+        code: ElevenLabsErrorCode.TOO_MANY_CONCURRENT_REQUESTS,
+        type: ElevenLabsErrorType.RATE_LIMIT,
+        httpStatus: 429,
+        message: 'You have exceeded the concurrency limit for your subscription.',
+        solution: 'Wait for existing requests to complete before making new ones. Consider upgrading your subscription for higher concurrency limits at https://elevenlabs.io/docs/api-reference/concurrency-and-priority',
+        documentationUrl: 'https://elevenlabs.io/docs/api-reference/concurrency-and-priority',
+    },
+    [ElevenLabsErrorCode.SYSTEM_BUSY]: {
+        code: ElevenLabsErrorCode.SYSTEM_BUSY,
+        type: ElevenLabsErrorType.RATE_LIMIT,
+        httpStatus: 429,
+        message: 'Our services are experiencing high levels of traffic and your request could not be processed.',
+        solution: 'Retry the request later with exponential backoff. Consider upgrading your subscription to get higher priority at https://elevenlabs.io/docs/api-reference/concurrency-and-priority',
+        documentationUrl: 'https://elevenlabs.io/docs/api-reference/concurrency-and-priority',
+    },
+    [ElevenLabsErrorCode.UNKNOWN]: {
+        code: ElevenLabsErrorCode.UNKNOWN,
+        type: ElevenLabsErrorType.UNKNOWN,
+        httpStatus: 500,
+        message: 'An unknown error occurred.',
+        solution: 'Please try again. If the problem persists, contact ElevenLabs support at https://help.elevenlabs.io/hc/en-us/requests/new',
+        documentationUrl: 'https://help.elevenlabs.io/hc/en-us/requests/new',
+    },
+};
+/**
+ * Parse ElevenLabs API error response and return detailed error information
+ */
+export function parseElevenLabsError(statusCode, responseBody) {
+    try {
+        // Try to parse as JSON
+        const json = JSON.parse(responseBody);
+        // Extract error code from various possible locations
+        const errorCode = json.detail?.code ||
+            json.code ||
+            json.detail?.status ||
+            json.status;
+        // Check if we have a known error code
+        if (errorCode && errorCode in ELEVENLABS_ERROR_MAP) {
+            return ELEVENLABS_ERROR_MAP[errorCode];
+        }
+        // Fall back to HTTP status code mapping
+        return mapHttpStatusToError(statusCode, responseBody);
+    }
+    catch {
+        // If JSON parsing fails, map by HTTP status code
+        return mapHttpStatusToError(statusCode, responseBody);
+    }
+}
+/**
+ * Map HTTP status code to error information when specific error code is not available
+ */
+function mapHttpStatusToError(statusCode, responseBody) {
+    switch (statusCode) {
+        case 400:
+            // Could be various validation errors
+            if (responseBody.toLowerCase().includes('character')) {
+                return ELEVENLABS_ERROR_MAP[ElevenLabsErrorCode.MAX_CHARACTER_LIMIT_EXCEEDED];
+            }
+            if (responseBody.toLowerCase().includes('voice')) {
+                return ELEVENLABS_ERROR_MAP[ElevenLabsErrorCode.VOICE_NOT_FOUND];
+            }
+            return {
+                code: ElevenLabsErrorCode.UNKNOWN,
+                type: ElevenLabsErrorType.VALIDATION,
+                httpStatus: 400,
+                message: `Bad request: ${responseBody}`,
+                solution: 'Check your request parameters and try again.',
+            };
+        case 401:
+            // Authentication errors
+            if (responseBody.toLowerCase().includes('quota')) {
+                return ELEVENLABS_ERROR_MAP[ElevenLabsErrorCode.QUOTA_EXCEEDED];
+            }
+            return ELEVENLABS_ERROR_MAP[ElevenLabsErrorCode.INVALID_API_KEY];
+        case 403:
+            // Permission errors
+            if (responseBody.toLowerCase().includes('creator') ||
+                responseBody.toLowerCase().includes('professional')) {
+                return ELEVENLABS_ERROR_MAP[ElevenLabsErrorCode.ONLY_FOR_CREATOR_PLUS];
+            }
+            return {
+                code: ElevenLabsErrorCode.UNKNOWN,
+                type: ElevenLabsErrorType.PERMISSION,
+                httpStatus: 403,
+                message: `Permission denied: ${responseBody}`,
+                solution: 'Ensure your API key has the required permissions at https://elevenlabs.io/app/settings/api-keys',
+                documentationUrl: 'https://elevenlabs.io/app/settings/api-keys',
+            };
+        case 429:
+            // Rate limit errors
+            if (responseBody.toLowerCase().includes('concurrent')) {
+                return ELEVENLABS_ERROR_MAP[ElevenLabsErrorCode.TOO_MANY_CONCURRENT_REQUESTS];
+            }
+            if (responseBody.toLowerCase().includes('busy') ||
+                responseBody.toLowerCase().includes('traffic')) {
+                return ELEVENLABS_ERROR_MAP[ElevenLabsErrorCode.SYSTEM_BUSY];
+            }
+            return {
+                code: ElevenLabsErrorCode.UNKNOWN,
+                type: ElevenLabsErrorType.RATE_LIMIT,
+                httpStatus: 429,
+                message: `Rate limit exceeded: ${responseBody}`,
+                solution: 'Wait a moment and try again. Consider implementing exponential backoff for retries.',
+            };
+        default:
+            return {
+                code: ElevenLabsErrorCode.UNKNOWN,
+                type: ElevenLabsErrorType.UNKNOWN,
+                httpStatus: statusCode,
+                message: responseBody || 'An unknown error occurred',
+                solution: 'Please try again. If the problem persists, contact ElevenLabs support at https://help.elevenlabs.io/hc/en-us/requests/new',
+                documentationUrl: 'https://help.elevenlabs.io/hc/en-us/requests/new',
+            };
+    }
+}
+/**
+ * Format error information into a user-friendly message
+ */
+export function formatElevenLabsError(errorInfo) {
+    let message = `${errorInfo.message}\n\n`;
+    message += `Solution: ${errorInfo.solution}`;
+    if (errorInfo.documentationUrl) {
+        message += `\n\nFor more information, visit: ${errorInfo.documentationUrl}`;
+    }
+    return message;
+}
+/**
+ * Check if an error is retryable (rate limit errors)
+ */
+export function isRetryableError(errorInfo) {
+    return errorInfo.type === ElevenLabsErrorType.RATE_LIMIT;
+}
+/**
+ * Get recommended retry delay in milliseconds for retryable errors
+ */
+export function getRetryDelay(errorInfo, attemptNumber) {
+    if (!isRetryableError(errorInfo)) {
+        return 0;
+    }
+    // Exponential backoff: 1s, 2s, 4s, 8s, 16s
+    const baseDelay = 1000;
+    const maxDelay = 16000;
+    const delay = Math.min(baseDelay * Math.pow(2, attemptNumber - 1), maxDelay);
+    // Add jitter to prevent thundering herd
+    const jitter = Math.random() * 0.3 * delay;
+    return Math.floor(delay + jitter);
+}
+//# sourceMappingURL=elevenLabsErrors.js.map

package/dist/src/services/elevenLabsErrors.js.map

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

package/dist/src/services/elevenLabsService.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type ElevenLabsErrorInfo } from './elevenLabsErrors.js';
+export interface ElevenLabsConfig {
+    apiKey: string;
+    agentId?: string;
+    model?: string;
+    language?: string;
+}
+export interface TranscriptionResult {
+    text: string;
+    language?: string;
+    duration?: number;
+}
+export interface ApiKeyValidationResult {
+    valid: boolean;
+    error?: string;
+    errorType?: 'missing' | 'invalid' | 'permission' | 'network' | 'unknown';
+    errorInfo?: ElevenLabsErrorInfo;
+}
+export interface ElevenLabsError {
+    detail?: {
+        status?: string;
+        message?: string;
+    };
+    message?: string;
+    status?: string;
+}
+/**
+ * Service for interacting with ElevenLabs Speech-to-Text API
+ */
+export declare class ElevenLabsService {
+    private readonly apiKey;
+    private readonly model;
+    private readonly language;
+    private readonly baseUrl;
+    constructor(config: ElevenLabsConfig);
+    /**
+     * Transcribe audio file to text using ElevenLabs API
+     * @param audioFilePath Path to the audio file
+     * @returns Transcription result
+     */
+    transcribe(audioFilePath: string): Promise<TranscriptionResult>;
+    /**
+     * Validate API key by making a test request
+     * @returns true if API key is valid
+     */
+    validateApiKey(): Promise<boolean>;
+    /**
+     * Validate API key with detailed error information
+     * @returns Validation result with error details
+     */
+    validateApiKeyDetailed(): Promise<ApiKeyValidationResult>;
+    /**
+     * Get available models for speech-to-text
+     * @returns List of available models
+     */
+    getAvailableModels(): Promise<string[]>;
+}

package/dist/src/services/elevenLabsService.js

@@ -0,0 +1,186 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getErrorMessage } from '@blackbox_ai/blackbox-cli-core';
+import * as fs from 'node:fs';
+import { fetch } from 'undici';
+import { parseElevenLabsError, formatElevenLabsError, ElevenLabsErrorType, } from './elevenLabsErrors.js';
+/**
+ * Service for interacting with ElevenLabs Speech-to-Text API
+ */
+export class ElevenLabsService {
+    apiKey;
+    model;
+    language;
+    baseUrl = 'https://api.elevenlabs.io/v1';
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.model = config.model || 'scribe_v2';
+        this.language = config.language || 'en';
+    }
+    /**
+     * Transcribe audio file to text using ElevenLabs API
+     * @param audioFilePath Path to the audio file
+     * @returns Transcription result
+     */
+    async transcribe(audioFilePath) {
+        try {
+            // Read audio file
+            const audioBuffer = fs.readFileSync(audioFilePath);
+            // Create boundary for multipart/form-data
+            const boundary = `----WebKitFormBoundary${Math.random().toString(36).substring(2)}`;
+            // Build multipart form data manually
+            const parts = [];
+            // Add model_id field
+            parts.push(Buffer.from(`--${boundary}\r\n` +
+                `Content-Disposition: form-data; name="model_id"\r\n\r\n` +
+                `${this.model}\r\n`));
+            // Add language field if provided
+            if (this.language) {
+                parts.push(Buffer.from(`--${boundary}\r\n` +
+                    `Content-Disposition: form-data; name="language"\r\n\r\n` +
+                    `${this.language}\r\n`));
+            }
+            // Add audio file - API expects "file" not "audio"
+            parts.push(Buffer.from(`--${boundary}\r\n` +
+                `Content-Disposition: form-data; name="file"; filename="recording.wav"\r\n` +
+                `Content-Type: audio/wav\r\n\r\n`));
+            parts.push(audioBuffer);
+            parts.push(Buffer.from(`\r\n`));
+            // Add closing boundary
+            parts.push(Buffer.from(`--${boundary}--\r\n`));
+            // Combine all parts
+            const body = Buffer.concat(parts);
+            // Make API request with proper Content-Type
+            const response = await fetch(`${this.baseUrl}/speech-to-text`, {
+                method: 'POST',
+                headers: {
+                    'xi-api-key': this.apiKey,
+                    'Content-Type': `multipart/form-data; boundary=${boundary}`,
+                    'Content-Length': body.length.toString(),
+                },
+                body,
+            });
+            if (!response.ok) {
+                const responseText = await response.text();
+                const errorInfo = parseElevenLabsError(response.status, responseText);
+                const errorMessage = formatElevenLabsError(errorInfo);
+                throw new Error(errorMessage);
+            }
+            const result = (await response.json());
+            return {
+                text: result.text || '',
+                language: result.language,
+                duration: result.duration,
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to transcribe audio: ${getErrorMessage(error)}`);
+        }
+    }
+    /**
+     * Validate API key by making a test request
+     * @returns true if API key is valid
+     */
+    async validateApiKey() {
+        const result = await this.validateApiKeyDetailed();
+        return result.valid;
+    }
+    /**
+     * Validate API key with detailed error information
+     * @returns Validation result with error details
+     */
+    async validateApiKeyDetailed() {
+        try {
+            // Try to get user subscription info to validate the key
+            const response = await fetch(`${this.baseUrl}/user/subscription`, {
+                method: 'GET',
+                headers: {
+                    'xi-api-key': this.apiKey,
+                },
+            });
+            if (response.ok) {
+                return { valid: true };
+            }
+            // Parse error response with detailed error information
+            const responseText = await response.text();
+            const errorInfo = parseElevenLabsError(response.status, responseText);
+            // Map error type to validation result
+            let errorType;
+            switch (errorInfo.type) {
+                case ElevenLabsErrorType.AUTHENTICATION:
+                    errorType = 'invalid';
+                    break;
+                case ElevenLabsErrorType.PERMISSION:
+                    errorType = 'permission';
+                    break;
+                case ElevenLabsErrorType.NETWORK:
+                    errorType = 'network';
+                    break;
+                default:
+                    errorType = 'unknown';
+            }
+            // If subscription endpoint fails, try the voices endpoint as fallback
+            if (response.status >= 500) {
+                const voicesResponse = await fetch(`${this.baseUrl}/voices`, {
+                    method: 'GET',
+                    headers: {
+                        'xi-api-key': this.apiKey,
+                    },
+                });
+                if (voicesResponse.ok) {
+                    return { valid: true };
+                }
+                const voicesResponseText = await voicesResponse.text();
+                const voicesErrorInfo = parseElevenLabsError(voicesResponse.status, voicesResponseText);
+                return {
+                    valid: false,
+                    error: formatElevenLabsError(voicesErrorInfo),
+                    errorType: voicesErrorInfo.type === ElevenLabsErrorType.AUTHENTICATION ? 'invalid' :
+                        voicesErrorInfo.type === ElevenLabsErrorType.PERMISSION ? 'permission' :
+                            voicesErrorInfo.type === ElevenLabsErrorType.NETWORK ? 'network' : 'unknown',
+                    errorInfo: voicesErrorInfo,
+                };
+            }
+            return {
+                valid: false,
+                error: formatElevenLabsError(errorInfo),
+                errorType,
+                errorInfo,
+            };
+        }
+        catch (error) {
+            return {
+                valid: false,
+                error: `Network error: ${getErrorMessage(error)}`,
+                errorType: 'network',
+            };
+        }
+    }
+    /**
+     * Get available models for speech-to-text
+     * @returns List of available models
+     */
+    async getAvailableModels() {
+        try {
+            const response = await fetch(`${this.baseUrl}/models`, {
+                method: 'GET',
+                headers: {
+                    'xi-api-key': this.apiKey,
+                },
+            });
+            if (!response.ok) {
+                throw new Error(`Failed to fetch models: ${response.statusText}`);
+            }
+            const data = (await response.json());
+            return data.models?.map((m) => m.model_id) || [];
+        }
+        catch (error) {
+            console.error('Failed to fetch available models:', error);
+            return ['scribe_v1', 'scribe_v1_experimental', 'scribe_v2']; // Update default models  
+        }
+    }
+}
+//# sourceMappingURL=elevenLabsService.js.map

package/dist/src/services/elevenLabsService.js.map

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

package/dist/src/services/elevenLabsStreamingService.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface StreamingTranscriptionConfig {
+    apiKey: string;
+    model?: string;
+    language?: string;
+    onPartialTranscript?: (text: string) => void;
+    onFinalTranscript?: (text: string) => void;
+    onError?: (error: Error) => void;
+}
+export interface StreamingTranscriptionResult {
+    fullText: string;
+    partialTexts: string[];
+}
+/**
+ * Service for real-time streaming transcription using ElevenLabs WebSocket API
+ * Based on: https://elevenlabs.io/docs/developers/guides/cookbooks/speech-to-text/streaming
+ */
+export declare class ElevenLabsStreamingService {
+    private readonly apiKey;
+    private readonly model;
+    private readonly onPartialTranscript?;
+    private readonly onFinalTranscript?;
+    private readonly onError?;
+    private ws;
+    private fullTranscript;
+    private partialTranscripts;
+    private isConnected;
+    constructor(config: StreamingTranscriptionConfig);
+    /**
+     * Start streaming transcription session
+     */
+    startStreaming(): Promise<void>;
+    /**
+     * Send audio chunk for transcription
+     * Audio should be in the correct format (PCM, 16kHz, mono)
+     * @param audioChunk Audio data as Buffer
+     */
+    sendAudioChunk(audioChunk: Buffer): void;
+    /**
+     * Stop streaming and close connection
+     */
+    stopStreaming(): Promise<StreamingTranscriptionResult>;
+    /**
+     * Get current full transcript
+     */
+    getFullTranscript(): string;
+    /**
+     * Check if streaming is active
+     */
+    isStreaming(): boolean;
+    /**
+     * Reset transcript state
+     */
+    reset(): void;
+}