@blackbox_ai/blackbox-cli 0.0.9 → 0.8.1

package/dist/src/services/elevenLabsStreamingService.js

@@ -0,0 +1,202 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getErrorMessage } from '@blackbox_ai/blackbox-cli-core';
+import { WebSocket } from 'ws';
+/**
+ * Service for real-time streaming transcription using ElevenLabs WebSocket API
+ * Based on: https://elevenlabs.io/docs/developers/guides/cookbooks/speech-to-text/streaming
+ */
+export class ElevenLabsStreamingService {
+    apiKey;
+    model;
+    onPartialTranscript;
+    onFinalTranscript;
+    onError;
+    ws = null;
+    fullTranscript = '';
+    partialTranscripts = [];
+    isConnected = false;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.model = config.model || 'scribe_v2';
+        this.onPartialTranscript = config.onPartialTranscript;
+        this.onFinalTranscript = config.onFinalTranscript;
+        this.onError = config.onError;
+    }
+    /**
+     * Start streaming transcription session
+     */
+    async startStreaming() {
+        return new Promise((resolve, reject) => {
+            try {
+                // ElevenLabs WebSocket endpoint - using conversational AI endpoint
+                // which supports speech-to-text streaming
+                const wsUrl = 'wss://api.elevenlabs.io/v1/convai/conversation';
+                this.ws = new WebSocket(wsUrl, {
+                    headers: {
+                        'xi-api-key': this.apiKey,
+                    },
+                });
+                this.ws.on('open', () => {
+                    // Send initial configuration for speech-to-text mode
+                    const config = {
+                        type: 'conversation_initiation_client_data',
+                        conversation_config_override: {
+                            agent: {
+                                prompt: {
+                                    prompt: 'You are a transcription assistant. Only transcribe what the user says, do not respond.',
+                                },
+                            },
+                            tts: {
+                                model_id: this.model,
+                            },
+                        },
+                    };
+                    if (this.ws) {
+                        this.ws.send(JSON.stringify(config));
+                        this.isConnected = true;
+                        resolve();
+                    }
+                });
+                this.ws.on('message', (data) => {
+                    try {
+                        const message = JSON.parse(data.toString());
+                        // Handle different message types from conversational AI endpoint
+                        if (message.type === 'user_transcript' || message.type === 'transcript') {
+                            const text = message.user_transcript || message.transcript || message.text || '';
+                            const isFinal = message.is_final !== false; // Default to true if not specified
+                            if (text) {
+                                if (isFinal) {
+                                    // Final transcription for this segment
+                                    this.partialTranscripts.push(text);
+                                    this.fullTranscript += (this.fullTranscript ? ' ' : '') + text;
+                                    if (this.onFinalTranscript) {
+                                        this.onFinalTranscript(text);
+                                    }
+                                }
+                                else {
+                                    // Partial transcription (interim results)
+                                    if (this.onPartialTranscript) {
+                                        this.onPartialTranscript(text);
+                                    }
+                                }
+                            }
+                        }
+                        else if (message.type === 'interruption') {
+                            // User started speaking, clear any previous partial transcripts
+                            if (this.onPartialTranscript) {
+                                this.onPartialTranscript('');
+                            }
+                        }
+                        else if (message.type === 'error' || message.error) {
+                            const errorMsg = message.message || message.error || 'Streaming transcription error';
+                            const error = new Error(errorMsg);
+                            if (this.onError) {
+                                this.onError(error);
+                            }
+                        }
+                    }
+                    catch (error) {
+                        console.error('Error parsing WebSocket message:', error);
+                    }
+                });
+                this.ws.on('error', (error) => {
+                    this.isConnected = false;
+                    const err = new Error(`WebSocket error: ${error.message}`);
+                    if (this.onError) {
+                        this.onError(err);
+                    }
+                    reject(err);
+                });
+                this.ws.on('close', (code, reason) => {
+                    this.isConnected = false;
+                    if (code !== 1000) {
+                        // Abnormal closure
+                        console.error(`WebSocket closed with code ${code}: ${reason}`);
+                    }
+                });
+            }
+            catch (error) {
+                reject(new Error(`Failed to start streaming: ${getErrorMessage(error)}`));
+            }
+        });
+    }
+    /**
+     * Send audio chunk for transcription
+     * Audio should be in the correct format (PCM, 16kHz, mono)
+     * @param audioChunk Audio data as Buffer
+     */
+    sendAudioChunk(audioChunk) {
+        if (!this.ws || !this.isConnected) {
+            throw new Error('WebSocket not connected');
+        }
+        try {
+            // For conversational AI endpoint, send audio with proper message type
+            const audioMessage = {
+                type: 'audio',
+                audio: audioChunk.toString('base64'),
+            };
+            this.ws.send(JSON.stringify(audioMessage));
+        }
+        catch (error) {
+            throw new Error(`Failed to send audio chunk: ${getErrorMessage(error)}`);
+        }
+    }
+    /**
+     * Stop streaming and close connection
+     */
+    async stopStreaming() {
+        return new Promise((resolve) => {
+            if (!this.ws) {
+                resolve({
+                    fullText: this.fullTranscript,
+                    partialTexts: this.partialTranscripts,
+                });
+                return;
+            }
+            // Send end-of-stream signal (empty buffer or close message)
+            try {
+                // Some APIs expect an empty buffer or specific close message
+                this.ws.send(Buffer.alloc(0));
+            }
+            catch (error) {
+                console.error('Unable to stop the streaming', error);
+                // Ignore errors when sending end signal
+            }
+            // Wait a bit for final transcriptions
+            setTimeout(() => {
+                if (this.ws) {
+                    this.ws.close(1000, 'Normal closure');
+                    this.ws = null;
+                }
+                resolve({
+                    fullText: this.fullTranscript,
+                    partialTexts: this.partialTranscripts,
+                });
+            }, 1000); // Increased timeout to ensure we get final results
+        });
+    }
+    /**
+     * Get current full transcript
+     */
+    getFullTranscript() {
+        return this.fullTranscript;
+    }
+    /**
+     * Check if streaming is active
+     */
+    isStreaming() {
+        return this.isConnected;
+    }
+    /**
+     * Reset transcript state
+     */
+    reset() {
+        this.fullTranscript = '';
+        this.partialTranscripts = [];
+    }
+}
+//# sourceMappingURL=elevenLabsStreamingService.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface TokenResponse {
+    token: string;
+    expiresAt: string;
+}
+/**
+ * Service for generating single-use tokens for ElevenLabs Scribe
+ */
+export declare class ElevenLabsTokenService {
+    private readonly apiKey;
+    constructor(apiKey: string);
+    /**
+     * Generate a single-use token for Scribe realtime transcription
+     * Token expires after 15 minutes
+     */
+    generateScribeToken(): Promise<TokenResponse>;
+}

package/dist/src/services/elevenLabsTokenService.js

@@ -0,0 +1,42 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getErrorMessage } from '@blackbox_ai/blackbox-cli-core';
+/**
+ * Service for generating single-use tokens for ElevenLabs Scribe
+ */
+export class ElevenLabsTokenService {
+    apiKey;
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    /**
+     * Generate a single-use token for Scribe realtime transcription
+     * Token expires after 15 minutes
+     */
+    async generateScribeToken() {
+        try {
+            const response = await fetch('https://api.elevenlabs.io/v1/single-use-token/realtime_scribe', {
+                method: 'POST',
+                headers: {
+                    'xi-api-key': this.apiKey,
+                },
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Failed to generate token: ${response.status} ${response.statusText} - ${errorText}`);
+            }
+            const data = await response.json();
+            return {
+                token: data.token,
+                expiresAt: data.expires_at || new Date(Date.now() + 15 * 60 * 1000).toISOString(),
+            };
+        }
+        catch (error) {
+            throw new Error(`Token generation failed: ${getErrorMessage(error)}`);
+        }
+    }
+}
+//# sourceMappingURL=elevenLabsTokenService.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"elevenLabsTokenService.js","sourceRoot":"","sources":["../../../src/services/elevenLabsTokenService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAOjE;;GAEG;AACH,MAAM,OAAO,sBAAsB;IAChB,MAAM,CAAS;IAEhC,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,mBAAmB;QACvB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,+DAA+D,EAC/D;gBACE,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,YAAY,EAAE,IAAI,CAAC,MAAM;iBAC1B;aACF,CACF,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACxC,MAAM,IAAI,KAAK,CACb,6BAA6B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,MAAM,SAAS,EAAE,CACrF,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,OAAO;gBACL,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,SAAS,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;aAClF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,4BAA4B,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Settings } from '../config/settings.js';
+export interface VoiceInputOptions {
+    settings: Settings;
+    language?: string;
+    onRecordingStart?: () => void;
+    onRecordingStop?: () => void;
+    onTranscriptionStart?: () => void;
+    onTranscriptionComplete?: (text: string) => void;
+    onError?: (error: Error) => void;
+}
+/**
+ * Handle voice input: record audio and transcribe to text
+ */
+export declare function handleVoiceInput(options: VoiceInputOptions): Promise<string>;
+/**
+ * Check if voice input is properly configured
+ */
+export declare function isVoiceConfigured(settings: Settings): Promise<{
+    configured: boolean;
+    errors: string[];
+}>;

package/dist/src/services/voiceInputHandler.js

@@ -0,0 +1,209 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getErrorMessage } from '@blackbox_ai/blackbox-cli-core';
+import { ElevenLabsService } from './elevenLabsService.js';
+import { VoiceRecordingService } from './voiceRecordingService.js';
+// Debug mode flag - can be set via environment variable
+const DEBUG_MODE = process.env['DEBUG'] === 'true' || process.env['DEBUG'] === '1' || process.env['DEBUG_MODE'] === 'true' || process.env['DEBUG_MODE'] === '1';
+function debugLog(...args) {
+    if (DEBUG_MODE) {
+        console.debug('[DEBUG][VoiceInputHandler]', ...args);
+    }
+}
+function sanitizeApiKey(apiKey) {
+    if (apiKey.length <= 8)
+        return '***';
+    return `${apiKey.substring(0, 4)}...${apiKey.substring(apiKey.length - 4)}`;
+}
+/**
+ * Handle voice input: record audio and transcribe to text
+ */
+export async function handleVoiceInput(options) {
+    const { settings, language, onRecordingStart, onRecordingStop, onTranscriptionStart, onTranscriptionComplete, onError, } = options;
+    debugLog('handleVoiceInput called');
+    try {
+        // Get API key from settings or environment
+        const apiKey = settings.voice?.elevenLabs?.apiKey || process.env['ELEVENLABS_API_KEY'];
+        if (!apiKey) {
+            debugLog('No API key found');
+            throw new Error('ElevenLabs API key not configured. Run: blackbox voice configure');
+        }
+        debugLog('API key found:', sanitizeApiKey(apiKey));
+        debugLog('Voice settings:', {
+            sampleRate: settings.voice?.sampleRate,
+            audioFormat: settings.voice?.audioFormat,
+            language: language || settings.voice?.language,
+        });
+        // Initialize services
+        const voiceService = new VoiceRecordingService({
+            sampleRate: settings.voice?.sampleRate,
+            audioFormat: settings.voice?.audioFormat,
+            silenceThreshold: settings.voice?.silenceThreshold,
+            silenceDuration: settings.voice?.silenceDuration,
+        });
+        // Start recording
+        debugLog('Starting recording...');
+        if (onRecordingStart) {
+            onRecordingStart();
+        }
+        // Create temporary file path for recording
+        const os = await import('node:os');
+        const path = await import('node:path');
+        const tempFilePath = path.join(os.tmpdir(), `voice-recording-${Date.now()}.${settings.voice?.audioFormat || 'wav'}`);
+        // Start recording (will continue until stopped)
+        debugLog('Recording to file:', tempFilePath);
+        await voiceService.startRecording(tempFilePath);
+        let filePath;
+        try {
+            // Wait for user to press Enter to stop recording
+            debugLog('Waiting for user to stop recording...');
+            await waitForEnterKey();
+            // Stop recording
+            debugLog('Stopping recording...');
+            const result = await voiceService.stopRecording();
+            filePath = result.filePath;
+            debugLog('Recording stopped. File:', filePath, 'Size:', result.size, 'bytes, Duration:', result.duration, 's');
+            if (onRecordingStop) {
+                onRecordingStop();
+            }
+        }
+        catch (error) {
+            // Handle cancellation (Ctrl+C or ESC)
+            debugLog('Recording cancelled:', getErrorMessage(error));
+            await voiceService.cancelRecording();
+            if (onRecordingStop) {
+                onRecordingStop();
+            }
+            throw error;
+        }
+        // Transcribe audio
+        debugLog('Starting transcription...');
+        if (onTranscriptionStart) {
+            onTranscriptionStart();
+        }
+        const elevenLabsService = new ElevenLabsService({
+            apiKey,
+            agentId: settings.voice?.elevenLabs?.agentId,
+            model: settings.voice?.elevenLabs?.model,
+            language: language || settings.voice?.language,
+        });
+        debugLog('Calling ElevenLabs transcription service...');
+        const transcription = await elevenLabsService.transcribe(filePath);
+        debugLog('Transcription received, length:', transcription.text.length);
+        debugLog('Transcription text:', transcription.text ? `"${transcription.text}"` : '(empty)');
+        // Cleanup audio file
+        const fs = await import('node:fs');
+        try {
+            debugLog('Cleaning up audio file:', filePath);
+            fs.unlinkSync(filePath);
+        }
+        catch (error) {
+            // Ignore cleanup errors
+            debugLog('Failed to cleanup audio file:', getErrorMessage(error));
+            console.warn('Failed to cleanup audio file:', error);
+        }
+        if (onTranscriptionComplete) {
+            onTranscriptionComplete(transcription.text);
+        }
+        debugLog('Voice input completed successfully');
+        return transcription.text;
+    }
+    catch (error) {
+        const errorMessage = getErrorMessage(error);
+        debugLog('Voice input error:', errorMessage);
+        // The error message from ElevenLabsService already contains formatted error info
+        // Just wrap it with a prefix for context
+        const enhancedMessage = `Voice input failed: ${errorMessage}`;
+        const err = new Error(enhancedMessage);
+        if (onError) {
+            onError(err);
+        }
+        throw err;
+    }
+}
+/**
+ * Wait for user to press Enter key
+ */
+async function waitForEnterKey() {
+    return new Promise((resolve, reject) => {
+        const stdin = process.stdin;
+        stdin.setRawMode(true);
+        stdin.resume();
+        stdin.setEncoding('utf8');
+        const onData = (key) => {
+            // Check for Enter key (carriage return or newline)
+            if (key === '\r' || key === '\n') {
+                stdin.setRawMode(false);
+                stdin.pause();
+                stdin.removeListener('data', onData);
+                resolve();
+            }
+            // Check for Ctrl+C to cancel
+            if (key === '\u0003') {
+                stdin.setRawMode(false);
+                stdin.pause();
+                stdin.removeListener('data', onData);
+                reject(new Error('Recording cancelled'));
+            }
+            // Check for ESC key to cancel
+            if (key === '\u001b') {
+                stdin.setRawMode(false);
+                stdin.pause();
+                stdin.removeListener('data', onData);
+                reject(new Error('Recording cancelled'));
+            }
+        };
+        stdin.on('data', onData);
+    });
+}
+/**
+ * Check if voice input is properly configured
+ */
+export async function isVoiceConfigured(settings) {
+    debugLog('Checking voice configuration...');
+    const errors = [];
+    // Check API key
+    const apiKey = settings.voice?.elevenLabs?.apiKey || process.env['ELEVENLABS_API_KEY'];
+    if (!apiKey) {
+        debugLog('No API key found in configuration');
+        errors.push('ElevenLabs API key not configured');
+    }
+    else {
+        debugLog('API key found:', sanitizeApiKey(apiKey));
+    }
+    // Validate API key if available
+    if (apiKey) {
+        try {
+            debugLog('Validating API key...');
+            const elevenLabsService = new ElevenLabsService({ apiKey });
+            const validation = await elevenLabsService.validateApiKeyDetailed();
+            debugLog('API key validation result:', validation.valid ? 'valid' : 'invalid');
+            if (!validation.valid) {
+                // Use the formatted error message from validation result
+                if (validation.error) {
+                    debugLog('Validation error:', validation.error);
+                    errors.push(validation.error);
+                }
+                else {
+                    debugLog('Validation failed with no specific error');
+                    errors.push('ElevenLabs API key validation failed');
+                }
+            }
+        }
+        catch (error) {
+            const errorMsg = `Failed to validate API key: ${getErrorMessage(error)}`;
+            debugLog('Validation exception:', errorMsg);
+            errors.push(errorMsg);
+        }
+    }
+    const configured = errors.length === 0;
+    debugLog('Voice configuration check complete. Configured:', configured, 'Errors:', errors.length);
+    return {
+        configured,
+        errors,
+    };
+}
+//# sourceMappingURL=voiceInputHandler.js.map

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

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

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

@@ -0,0 +1,69 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface VoiceRecordingConfig {
+    sampleRate?: number;
+    channels?: number;
+    audioFormat?: 'wav' | 'mp3';
+    silenceThreshold?: number;
+    silenceDuration?: number;
+}
+export interface RecordingResult {
+    filePath: string;
+    duration: number;
+    size: number;
+}
+/**
+ * Service for recording audio from microphone
+ * Uses ffmpeg directly for cross-platform audio recording
+ */
+export declare class VoiceRecordingService {
+    private readonly sampleRate;
+    private readonly channels;
+    private readonly audioFormat;
+    private ffmpegProcess;
+    private outputFilePath;
+    private fileStream;
+    private startTime;
+    private audioStream;
+    constructor(config?: VoiceRecordingConfig);
+    /**
+     * List available audio input devices on Windows using DirectShow
+     */
+    private listWindowsAudioDevices;
+    /**
+     * Get the appropriate ffmpeg input device and format based on platform
+     */
+    private getInputDeviceConfig;
+    /**
+     * Start recording audio from microphone
+     * Recording continues until stopRecording() is called
+     * @param outputPath Optional custom output path. If not provided, audio will only be streamed via callback
+     * @param onAudioChunk Optional callback for streaming audio chunks
+     * @returns Promise that resolves with the output file path when recording starts (or empty string if no file)
+     */
+    startRecording(outputPath?: string, onAudioChunk?: (chunk: Buffer) => void): Promise<string>;
+    /**
+     * Parse ffmpeg error messages to provide helpful feedback
+     */
+    private parseFFmpegError;
+    /**
+     * Stop the current recording
+     * @returns Recording result with file path and metadata (file path will be empty if no file was created)
+     */
+    stopRecording(): Promise<RecordingResult>;
+    /**
+     * Check if recording is currently in progress
+     */
+    isRecording(): boolean;
+    /**
+     * Cancel the current recording and delete the file if it exists
+     */
+    cancelRecording(): Promise<void>;
+    /**
+     * Clean up recording resources
+     */
+    private cleanup;
+}