@blackbox_ai/blackbox-cli 0.0.7 → 0.8.1

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":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,OAAO,EAAE,iBAAiB,EAA+B,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,wDAAwD;AACxD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,GAAG,CAAC;AAEhK,SAAS,QAAQ,CAAC,GAAG,IAAe;IAClC,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,IAAI,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,MAAc;IACpC,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;AAC9E,CAAC;AAYD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAA0B;IAE1B,MAAM,EACJ,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,uBAAuB,EACvB,OAAO,GACR,GAAG,OAAO,CAAC;IAEZ,QAAQ,CAAC,yBAAyB,CAAC,CAAC;IAEpC,IAAI,CAAC;QACH,2CAA2C;QAC3C,MAAM,MAAM,GACV,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAE1E,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,QAAQ,CAAC,kBAAkB,CAAC,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,kEAAkE,CACnE,CAAC;QACJ,CAAC;QAED,QAAQ,CAAC,gBAAgB,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;QACnD,QAAQ,CAAC,iBAAiB,EAAE;YAC1B,UAAU,EAAE,QAAQ,CAAC,KAAK,EAAE,UAAU;YACtC,WAAW,EAAE,QAAQ,CAAC,KAAK,EAAE,WAAW;YACxC,QAAQ,EAAE,QAAQ,IAAI,QAAQ,CAAC,KAAK,EAAE,QAAQ;SAC/C,CAAC,CAAC;QAEH,sBAAsB;QACtB,MAAM,YAAY,GAAG,IAAI,qBAAqB,CAAC;YAC7C,UAAU,EAAE,QAAQ,CAAC,KAAK,EAAE,UAAU;YACtC,WAAW,EAAE,QAAQ,CAAC,KAAK,EAAE,WAA4B;YACzD,gBAAgB,EAAE,QAAQ,CAAC,KAAK,EAAE,gBAAgB;YAClD,eAAe,EAAE,QAAQ,CAAC,KAAK,EAAE,eAAe;SACjD,CAAC,CAAC;QAEH,kBAAkB;QAClB,QAAQ,CAAC,uBAAuB,CAAC,CAAC;QAClC,IAAI,gBAAgB,EAAE,CAAC;YACrB,gBAAgB,EAAE,CAAC;QACrB,CAAC;QAED,2CAA2C;QAC3C,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAC5B,EAAE,CAAC,MAAM,EAAE,EACX,mBAAmB,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,CAAC,KAAK,EAAE,WAAW,IAAI,KAAK,EAAE,CACxE,CAAC;QAEF,gDAAgD;QAChD,QAAQ,CAAC,oBAAoB,EAAE,YAAY,CAAC,CAAC;QAC7C,MAAM,YAAY,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;QAEhD,IAAI,QAAgB,CAAC;QACrB,IAAI,CAAC;YACH,iDAAiD;YACjD,QAAQ,CAAC,uCAAuC,CAAC,CAAC;YAClD,MAAM,eAAe,EAAE,CAAC;YAExB,iBAAiB;YACjB,QAAQ,CAAC,uBAAuB,CAAC,CAAC;YAClC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,aAAa,EAAE,CAAC;YAClD,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;YAC3B,QAAQ,CAAC,0BAA0B,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,kBAAkB,EAAE,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAE/G,IAAI,eAAe,EAAE,CAAC;gBACpB,eAAe,EAAE,CAAC;YACpB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,sCAAsC;YACtC,QAAQ,CAAC,sBAAsB,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;YACzD,MAAM,YAAY,CAAC,eAAe,EAAE,CAAC;YACrC,IAAI,eAAe,EAAE,CAAC;gBACpB,eAAe,EAAE,CAAC;YACpB,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,mBAAmB;QACnB,QAAQ,CAAC,2BAA2B,CAAC,CAAC;QACtC,IAAI,oBAAoB,EAAE,CAAC;YACzB,oBAAoB,EAAE,CAAC;QACzB,CAAC;QAED,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,CAAC;YAC9C,MAAM;YACN,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO;YAC5C,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK;YACxC,QAAQ,EAAE,QAAQ,IAAI,QAAQ,CAAC,KAAK,EAAE,QAAQ;SAC/C,CAAC,CAAC;QAEH,QAAQ,CAAC,6CAA6C,CAAC,CAAC;QACxD,MAAM,aAAa,GAAG,MAAM,iBAAiB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACnE,QAAQ,CAAC,iCAAiC,EAAE,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvE,QAAQ,CAAC,qBAAqB,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAE5F,qBAAqB;QACrB,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QACnC,IAAI,CAAC;YACH,QAAQ,CAAC,yBAAyB,EAAE,QAAQ,CAAC,CAAC;YAC9C,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,wBAAwB;YACxB,QAAQ,CAAC,+BAA+B,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;YAClE,OAAO,CAAC,IAAI,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,uBAAuB,EAAE,CAAC;YAC5B,uBAAuB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC;QAED,QAAQ,CAAC,oCAAoC,CAAC,CAAC;QAC/C,OAAO,aAAa,CAAC,IAAI,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QAC5C,QAAQ,CAAC,oBAAoB,EAAE,YAAY,CAAC,CAAC;QAE7C,iFAAiF;QACjF,yCAAyC;QACzC,MAAM,eAAe,GAAG,uBAAuB,YAAY,EAAE,CAAC;QAE9D,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QACvC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,CAAC;QACf,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,eAAe;IAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC5B,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACvB,KAAK,CAAC,MAAM,EAAE,CAAC;QACf,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAE1B,MAAM,MAAM,GAAG,CAAC,GAAW,EAAE,EAAE;YAC7B,mDAAmD;YACnD,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBACjC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBACxB,KAAK,CAAC,KAAK,EAAE,CAAC;gBACd,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACrC,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,6BAA6B;YAC7B,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;gBACrB,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBACxB,KAAK,CAAC,KAAK,EAAE,CAAC;gBACd,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACrC,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;YAC3C,CAAC;YACD,8BAA8B;YAC9B,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;gBACrB,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBACxB,KAAK,CAAC,KAAK,EAAE,CAAC;gBACd,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACrC,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC,CAAC;QAEF,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,QAAkB;IAIxD,QAAQ,CAAC,iCAAiC,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,gBAAgB;IAChB,MAAM,MAAM,GACV,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAC1E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,QAAQ,CAAC,mCAAmC,CAAC,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IACnD,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,gBAAgB,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,gCAAgC;IAChC,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC;YACH,QAAQ,CAAC,uBAAuB,CAAC,CAAC;YAClC,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;YAC5D,MAAM,UAAU,GAA2B,MAAM,iBAAiB,CAAC,sBAAsB,EAAE,CAAC;YAE5F,QAAQ,CAAC,4BAA4B,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAE/E,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;gBACtB,yDAAyD;gBACzD,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;oBACrB,QAAQ,CAAC,mBAAmB,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;oBAChD,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBAChC,CAAC;qBAAM,CAAC;oBACN,QAAQ,CAAC,0CAA0C,CAAC,CAAC;oBACrD,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;gBACtD,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,+BAA+B,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YACzE,QAAQ,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;IACvC,QAAQ,CAAC,iDAAiD,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAElG,OAAO;QACL,UAAU;QACV,MAAM;KACP,CAAC;AACJ,CAAC"}

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;
+}