@zhoujinandrew/fish-audio-mcp-server 0.7.0

package/dist/tools/tts.js

@@ -0,0 +1,328 @@
+import { FishAudioSDKService } from '../services/fishAudioSDK.js';
+import { FishAudioError } from '../types/index.js';
+import { loadConfig, getOutputPath } from '../utils/config.js';
+import { writeFileSync, createWriteStream } from 'fs';
+import { playAudio, isAudioPlaybackSupported } from '../utils/audioPlayer.js';
+import { RealTimeAudioPlayer } from '../utils/realTimePlayer.js';
+import { ReferenceSelector } from '../utils/referenceSelector.js';
+import { logger } from '../utils/logger.js';
+export class TTSTool {
+    name = 'fish_audio_tts';
+    description = 'Generate speech from text using Fish Audio TTS API';
+    inputSchema = {
+        type: 'object',
+        properties: {
+            text: {
+                type: 'string',
+                description: 'Text to convert to speech',
+                maxLength: 10000
+            },
+            reference_id: {
+                type: 'string',
+                description: 'Voice model reference ID (optional)'
+            },
+            reference_name: {
+                type: 'string',
+                description: 'Voice model name to search for (optional)'
+            },
+            reference_tag: {
+                type: 'string',
+                description: 'Voice model tag to search for (optional)'
+            },
+            streaming: {
+                type: 'boolean',
+                description: 'Enable HTTP streaming mode (optional)',
+                default: false
+            },
+            websocket_streaming: {
+                type: 'boolean',
+                description: 'Enable WebSocket streaming mode (optional)',
+                default: false
+            },
+            realtime_play: {
+                type: 'boolean',
+                description: 'Enable real-time audio playback during streaming (optional)',
+                default: false
+            },
+            format: {
+                type: 'string',
+                enum: ['mp3', 'wav', 'pcm', 'opus'],
+                description: 'Output audio format (optional)',
+                default: 'mp3'
+            },
+            mp3_bitrate: {
+                type: 'number',
+                enum: [64, 128, 192],
+                description: 'MP3 bitrate in kbps (optional)',
+                default: 128
+            },
+            normalize: {
+                type: 'boolean',
+                description: 'Enable text normalization (optional)',
+                default: true
+            },
+            latency: {
+                type: 'string',
+                enum: ['normal', 'balanced'],
+                description: 'Latency mode (optional)',
+                default: 'balanced'
+            },
+            output_path: {
+                type: 'string',
+                description: 'Custom output file path (optional)'
+            },
+            auto_play: {
+                type: 'boolean',
+                description: 'Automatically play the generated audio (optional)',
+                default: false
+            },
+            speed: {
+                type: 'number',
+                description: 'Speaking rate multiplier (0.5=half speed, 1.0=normal, 2.0=double speed)',
+                minimum: 0.5,
+                maximum: 2.0,
+                default: 1.0
+            },
+            volume: {
+                type: 'number',
+                description: 'Volume adjustment in dB (0=no change, positive=louder, negative=quieter)',
+                default: 0
+            },
+            temperature: {
+                type: 'number',
+                description: 'Expressiveness/emotion control (0=consistent and calm, 1=varied and emotional)',
+                minimum: 0,
+                maximum: 1,
+                default: 0.7
+            }
+        },
+        required: ['text']
+    };
+    service;
+    constructor() {
+        this.service = new FishAudioSDKService();
+    }
+    async run(input) {
+        try {
+            // Validate input
+            if (!input.text || input.text.trim().length === 0) {
+                return {
+                    success: false,
+                    error: 'Text input is required'
+                };
+            }
+            if (input.text.length > 10000) {
+                return {
+                    success: false,
+                    error: 'Text length exceeds maximum limit of 10,000 characters'
+                };
+            }
+            const config = loadConfig();
+            // Select reference ID based on input parameters
+            let selectedReferenceId;
+            if (input.reference_id || input.reference_name || input.reference_tag) {
+                // Use reference selector if references are configured
+                if (config.references && config.references.length > 0) {
+                    const selector = new ReferenceSelector(config.references, config.defaultReference);
+                    selectedReferenceId = selector.selectReference({
+                        id: input.reference_id,
+                        name: input.reference_name,
+                        tag: input.reference_tag
+                    });
+                    if (!selectedReferenceId && (input.reference_name || input.reference_tag)) {
+                        return {
+                            success: false,
+                            error: `No reference found matching: ${input.reference_name || input.reference_tag}`
+                        };
+                    }
+                }
+                else {
+                    // Fallback to direct ID if no references configured
+                    selectedReferenceId = input.reference_id;
+                }
+            }
+            else {
+                // Use default reference or backward compatible referenceId
+                selectedReferenceId = config.defaultReference || config.referenceId;
+            }
+            // Prepare parameters
+            const ttsParams = {
+                text: input.text,
+                referenceId: selectedReferenceId,
+                format: (input.format || config.outputFormat),
+                mp3Bitrate: (input.mp3_bitrate || config.mp3Bitrate),
+                normalize: input.normalize !== false,
+                latency: (input.latency || 'balanced'),
+                streaming: input.streaming ?? config.streaming,
+                speed: input.speed,
+                volume: input.volume,
+                temperature: input.temperature,
+            };
+            // Determine output path
+            const outputPath = input.output_path || getOutputPath(ttsParams.format || 'mp3');
+            // Determine if auto-play is enabled
+            const shouldAutoPlay = input.auto_play ?? config.autoPlay;
+            // Determine if WebSocket streaming is enabled
+            const useWebSocketStreaming = input.websocket_streaming ?? config.websocketStreaming;
+            // WebSocket streaming mode with real-time playback
+            if (useWebSocketStreaming) {
+                return await this.handleWebSocketStreaming(input, ttsParams, outputPath, shouldAutoPlay || false);
+            }
+            if (ttsParams.streaming) {
+                // HTTP Streaming mode
+                const totalBytes = await this.service.generateSpeechStream(ttsParams, outputPath);
+                // Auto-play if requested
+                if (shouldAutoPlay && isAudioPlaybackSupported()) {
+                    try {
+                        await playAudio(outputPath);
+                    }
+                    catch (playError) {
+                        logger.error('Audio playback failed:', playError);
+                    }
+                }
+                return {
+                    success: true,
+                    file_path: outputPath,
+                    format: ttsParams.format,
+                    played: shouldAutoPlay || false
+                };
+            }
+            else {
+                // Non-streaming mode
+                const response = await this.service.generateSpeech(ttsParams);
+                // Save to file if output path is specified
+                if (outputPath) {
+                    writeFileSync(outputPath, response.audio);
+                    // Auto-play if requested
+                    if (shouldAutoPlay && isAudioPlaybackSupported()) {
+                        try {
+                            await playAudio(outputPath);
+                        }
+                        catch (playError) {
+                            logger.error('Audio playback failed:', playError);
+                        }
+                    }
+                    return {
+                        success: true,
+                        file_path: outputPath,
+                        format: response.format,
+                        played: shouldAutoPlay || false
+                    };
+                }
+                else {
+                    // Return base64 encoded audio
+                    return {
+                        success: true,
+                        audio_data: response.audio.toString('base64'),
+                        format: response.format
+                    };
+                }
+            }
+        }
+        catch (error) {
+            if (error instanceof FishAudioError) {
+                return {
+                    success: false,
+                    error: `${error.message} (${error.code})`
+                };
+            }
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error occurred'
+            };
+        }
+    }
+    async handleWebSocketStreaming(input, ttsParams, outputPath, shouldAutoPlay) {
+        const writeStream = outputPath ? createWriteStream(outputPath) : null;
+        let realTimePlayer = null;
+        let totalBytes = 0;
+        const audioChunks = [];
+        try {
+            // Set up real-time player if requested
+            const config = loadConfig();
+            const shouldRealtimePlay = input.realtime_play ?? config.realtimePlay;
+            if (shouldRealtimePlay && isAudioPlaybackSupported()) {
+                realTimePlayer = new RealTimeAudioPlayer();
+                realTimePlayer.start(ttsParams.format || 'opus');
+            }
+            // Split text into chunks for streaming
+            const textChunks = this.splitTextIntoChunks(input.text);
+            // Stream via WebSocket
+            const audioStream = this.service.generateSpeechWebSocket(ttsParams, textChunks);
+            for await (const audioChunk of audioStream) {
+                totalBytes += audioChunk.length;
+                // Write to file if output path specified
+                if (writeStream) {
+                    writeStream.write(audioChunk);
+                }
+                // Play in real-time if requested
+                if (realTimePlayer) {
+                    realTimePlayer.write(audioChunk);
+                }
+                // Collect chunks for post-playback if auto-play is enabled
+                if (shouldAutoPlay && !shouldRealtimePlay) {
+                    audioChunks.push(audioChunk);
+                }
+            }
+            // Close write stream
+            if (writeStream) {
+                writeStream.end();
+            }
+            // Stop real-time player
+            if (realTimePlayer) {
+                realTimePlayer.stop();
+            }
+            // Auto-play collected audio if requested (and not already played in real-time)
+            let played = false;
+            if (shouldAutoPlay && !shouldRealtimePlay && outputPath && isAudioPlaybackSupported()) {
+                try {
+                    await playAudio(outputPath);
+                    played = true;
+                }
+                catch (playError) {
+                    logger.error('Audio playback failed:', playError);
+                }
+            }
+            else if (shouldRealtimePlay) {
+                played = true;
+            }
+            return {
+                success: true,
+                file_path: outputPath || undefined,
+                format: ttsParams.format,
+                played,
+                streaming_mode: 'websocket',
+                total_bytes: totalBytes
+            };
+        }
+        catch (error) {
+            // Clean up on error
+            if (writeStream) {
+                writeStream.end();
+            }
+            if (realTimePlayer) {
+                realTimePlayer.stop();
+            }
+            throw error;
+        }
+    }
+    splitTextIntoChunks(text, chunkSize = 100) {
+        const sentences = text.match(/[^.!?]+[.!?]+/g) || [text];
+        const chunks = [];
+        let currentChunk = '';
+        for (const sentence of sentences) {
+            if (currentChunk.length + sentence.length > chunkSize && currentChunk.length > 0) {
+                chunks.push(currentChunk.trim());
+                currentChunk = sentence;
+            }
+            else {
+                currentChunk += sentence;
+            }
+        }
+        if (currentChunk.trim()) {
+            chunks.push(currentChunk.trim());
+        }
+        return chunks;
+    }
+}
+//# sourceMappingURL=tts.js.map

package/dist/tools/tts.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,98 @@
+export interface ReferenceConfig {
+    id: string;
+    name?: string;
+    tags?: string[];
+}
+export interface Config {
+    apiKey: string;
+    modelId: string;
+    referenceId?: string;
+    references?: ReferenceConfig[];
+    defaultReference?: string;
+    outputFormat: AudioFormat;
+    streaming: boolean;
+    mp3Bitrate: Mp3Bitrate;
+    audioOutputDir: string;
+    autoPlay?: boolean;
+    websocketStreaming?: boolean;
+    realtimePlay?: boolean;
+}
+export type AudioFormat = 'mp3' | 'wav' | 'pcm' | 'opus';
+export type Mp3Bitrate = 64 | 128 | 192;
+export type LatencyMode = 'normal' | 'balanced';
+export interface TTSParams {
+    text: string;
+    referenceId?: string;
+    format?: AudioFormat;
+    mp3Bitrate?: Mp3Bitrate;
+    normalize?: boolean;
+    latency?: LatencyMode;
+    chunkLength?: number;
+    streaming?: boolean;
+    websocketStreaming?: boolean;
+    speed?: number;
+    volume?: number;
+    temperature?: number;
+}
+export interface TTSResponse {
+    audio: Buffer;
+    format: string;
+    duration?: number;
+}
+export interface TTSToolParams {
+    text: string;
+    reference_id?: string;
+    reference_name?: string;
+    reference_tag?: string;
+    streaming?: boolean;
+    websocket_streaming?: boolean;
+    realtime_play?: boolean;
+    format?: AudioFormat;
+    mp3_bitrate?: Mp3Bitrate;
+    normalize?: boolean;
+    latency?: LatencyMode;
+    output_path?: string;
+    auto_play?: boolean;
+    speed?: number;
+    volume?: number;
+    temperature?: number;
+}
+export interface TTSToolResponse {
+    success: boolean;
+    audio_data?: string;
+    file_path?: string;
+    format?: string;
+    played?: boolean;
+    streaming_mode?: 'http' | 'websocket';
+    total_bytes?: number;
+    error?: string;
+}
+export interface FishAudioAPIRequest {
+    text: string;
+    reference_id?: string;
+    chunk_length?: number;
+    format?: string;
+    mp3_bitrate?: number;
+    normalize?: boolean;
+    latency?: string;
+    streaming?: boolean;
+}
+export interface FishAudioAPIResponse {
+    status: string;
+    data?: any;
+    error?: string;
+}
+export declare enum ErrorCode {
+    INVALID_API_KEY = "INVALID_API_KEY",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    INVALID_PARAMS = "INVALID_PARAMS",
+    QUOTA_EXCEEDED = "QUOTA_EXCEEDED",
+    SERVER_ERROR = "SERVER_ERROR",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR"
+}
+export declare class FishAudioError extends Error {
+    code: ErrorCode;
+    details?: any | undefined;
+    constructor(message: string, code: ErrorCode, details?: any | undefined);
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,20 @@
+export var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode["INVALID_API_KEY"] = "INVALID_API_KEY";
+    ErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    ErrorCode["INVALID_PARAMS"] = "INVALID_PARAMS";
+    ErrorCode["QUOTA_EXCEEDED"] = "QUOTA_EXCEEDED";
+    ErrorCode["SERVER_ERROR"] = "SERVER_ERROR";
+    ErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+})(ErrorCode || (ErrorCode = {}));
+export class FishAudioError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'FishAudioError';
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AA6FA,MAAM,CAAN,IAAY,SAOX;AAPD,WAAY,SAAS;IACnB,gDAAmC,CAAA;IACnC,4CAA+B,CAAA;IAC/B,8CAAiC,CAAA;IACjC,8CAAiC,CAAA;IACjC,0CAA6B,CAAA;IAC7B,4CAA+B,CAAA;AACjC,CAAC,EAPW,SAAS,KAAT,SAAS,QAOpB;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IAG9B;IACA;IAHT,YACE,OAAe,EACR,IAAe,EACf,OAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAAW;QACf,YAAO,GAAP,OAAO,CAAM;QAGpB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}

package/dist/utils/audioPlayer.d.ts

@@ -0,0 +1,3 @@
+export declare function playAudio(filePath: string): Promise<void>;
+export declare function isAudioPlaybackSupported(): boolean;
+//# sourceMappingURL=audioPlayer.d.ts.map

package/dist/utils/audioPlayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioPlayer.d.ts","sourceRoot":"","sources":["../../src/utils/audioPlayer.ts"],"names":[],"mappings":"AAOA,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB/D;AAED,wBAAgB,wBAAwB,IAAI,OAAO,CAGlD"}

package/dist/utils/audioPlayer.js

@@ -0,0 +1,35 @@
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { platform } from 'os';
+import { logger } from './logger.js';
+const execAsync = promisify(exec);
+export async function playAudio(filePath) {
+    const os = platform();
+    let command;
+    switch (os) {
+        case 'darwin': // macOS
+            command = `afplay "${filePath}"`;
+            break;
+        case 'win32': // Windows
+            command = `powershell -c "(New-Object Media.SoundPlayer '${filePath}').PlaySync()"`;
+            break;
+        case 'linux':
+            // Try multiple players in order of preference
+            command = `which aplay >/dev/null 2>&1 && aplay "${filePath}" || which mpg123 >/dev/null 2>&1 && mpg123 "${filePath}" || which ffplay >/dev/null 2>&1 && ffplay -nodisp -autoexit "${filePath}" || echo "No audio player found"`;
+            break;
+        default:
+            throw new Error(`Unsupported platform: ${os}`);
+    }
+    try {
+        await execAsync(command);
+    }
+    catch (error) {
+        logger.error('Failed to play audio:', error);
+        throw new Error(`Audio playback failed: ${error}`);
+    }
+}
+export function isAudioPlaybackSupported() {
+    const os = platform();
+    return ['darwin', 'win32', 'linux'].includes(os);
+}
+//# sourceMappingURL=audioPlayer.js.map

package/dist/utils/audioPlayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioPlayer.js","sourceRoot":"","sources":["../../src/utils/audioPlayer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAgB;IAC9C,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;IACtB,IAAI,OAAe,CAAC;IAEpB,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,QAAQ,EAAE,QAAQ;YACrB,OAAO,GAAG,WAAW,QAAQ,GAAG,CAAC;YACjC,MAAM;QACR,KAAK,OAAO,EAAE,UAAU;YACtB,OAAO,GAAG,iDAAiD,QAAQ,gBAAgB,CAAC;YACpF,MAAM;QACR,KAAK,OAAO;YACV,8CAA8C;YAC9C,OAAO,GAAG,yCAAyC,QAAQ,gDAAgD,QAAQ,kEAAkE,QAAQ,mCAAmC,CAAC;YACjO,MAAM;QACR;YACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;IACtB,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACnD,CAAC"}

package/dist/utils/config.d.ts

@@ -0,0 +1,4 @@
+import { Config } from '../types/index.js';
+export declare function loadConfig(): Config;
+export declare function getOutputPath(format: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAA4C,MAAM,mBAAmB,CAAC;AAuErF,wBAAgB,UAAU,IAAI,MAAM,CAsDnC;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKpD"}

package/dist/utils/config.js

@@ -0,0 +1,119 @@
+import { config as dotenvConfig } from 'dotenv';
+import { existsSync, mkdirSync } from 'fs';
+import { join, resolve } from 'path';
+import { homedir } from 'os';
+import { logger } from './logger.js';
+dotenvConfig();
+function parseBoolean(value, defaultValue) {
+    if (!value)
+        return defaultValue;
+    return value.toLowerCase() === 'true';
+}
+function parseAudioFormat(value, defaultValue) {
+    if (!value)
+        return defaultValue;
+    const validFormats = ['mp3', 'wav', 'pcm', 'opus'];
+    const format = value.toLowerCase();
+    return validFormats.includes(format) ? format : defaultValue;
+}
+function parseMp3Bitrate(value, defaultValue) {
+    if (!value)
+        return defaultValue;
+    const bitrate = parseInt(value);
+    const validBitrates = [64, 128, 192];
+    return validBitrates.includes(bitrate) ? bitrate : defaultValue;
+}
+let configCache = null;
+function parseReferences() {
+    const references = [];
+    // Parse FISH_REFERENCES as JSON array
+    const referencesStr = process.env.FISH_REFERENCES;
+    if (referencesStr) {
+        try {
+            const parsedRefs = JSON.parse(referencesStr);
+            if (Array.isArray(parsedRefs)) {
+                for (const ref of parsedRefs) {
+                    if (ref.reference_id || ref.id) {
+                        references.push({
+                            id: ref.reference_id || ref.id,
+                            name: ref.name,
+                            tags: ref.tags
+                        });
+                    }
+                }
+            }
+        }
+        catch (error) {
+            logger.error('Failed to parse FISH_REFERENCES as JSON:', error);
+            logger.error('Please use JSON array format: [{"reference_id":"id1","name":"Alice","tags":["female","english"]}]');
+        }
+    }
+    // Fallback: support individual reference configs for backward compatibility
+    if (references.length === 0) {
+        for (let i = 1; i <= 10; i++) {
+            const id = process.env[`FISH_REFERENCE_${i}_ID`];
+            if (id) {
+                references.push({
+                    id,
+                    name: process.env[`FISH_REFERENCE_${i}_NAME`],
+                    tags: process.env[`FISH_REFERENCE_${i}_TAGS`]?.split(',').map(t => t.trim())
+                });
+            }
+        }
+    }
+    return references;
+}
+export function loadConfig() {
+    if (configCache) {
+        return configCache;
+    }
+    const apiKey = process.env.FISH_API_KEY;
+    if (!apiKey) {
+        throw new Error('FISH_API_KEY environment variable is required');
+    }
+    // Default to user's home directory for audio output
+    const defaultOutputDir = join(homedir(), '.fish-audio-mcp', 'audio_output');
+    let audioOutputDir = process.env.AUDIO_OUTPUT_DIR || defaultOutputDir;
+    // Expand ~ to home directory if present
+    if (audioOutputDir.startsWith('~/')) {
+        audioOutputDir = join(homedir(), audioOutputDir.slice(2));
+    }
+    const resolvedOutputDir = resolve(audioOutputDir);
+    // Create output directory if it doesn't exist
+    try {
+        if (!existsSync(resolvedOutputDir)) {
+            mkdirSync(resolvedOutputDir, { recursive: true });
+        }
+    }
+    catch (error) {
+        logger.error(`Warning: Could not create audio output directory at ${resolvedOutputDir}. Audio files will be saved to memory only.`);
+    }
+    const streaming = parseBoolean(process.env.FISH_STREAMING, false);
+    const autoPlay = parseBoolean(process.env.FISH_AUTO_PLAY, false);
+    // Parse references
+    const references = parseReferences();
+    const defaultReference = process.env.FISH_DEFAULT_REFERENCE || process.env.FISH_REFERENCE_ID;
+    const config = {
+        apiKey,
+        modelId: process.env.FISH_MODEL_ID || 's1',
+        referenceId: process.env.FISH_REFERENCE_ID, // Keep for backward compatibility
+        references,
+        defaultReference,
+        outputFormat: parseAudioFormat(process.env.FISH_OUTPUT_FORMAT, 'mp3'),
+        streaming: streaming,
+        mp3Bitrate: parseMp3Bitrate(process.env.FISH_MP3_BITRATE, 128),
+        audioOutputDir: resolvedOutputDir,
+        autoPlay: autoPlay,
+        websocketStreaming: false, // Default to false for HTTP streaming
+        realtimePlay: false // Default to false for standard playback
+    };
+    configCache = config;
+    return config;
+}
+export function getOutputPath(format) {
+    const config = loadConfig();
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const filename = `tts_${timestamp}.${format}`;
+    return join(config.audioOutputDir, filename);
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

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