chat-flow-ardymalihi 1.0.2 → 3.0.0

package/dist/adapters/voice/HybridVoiceAdapter.d.ts

@@ -0,0 +1,54 @@
+import { IVoiceAdapter, VoiceConfig, AudioFormatMetadata } from '../../interfaces';
+/**
+ * Hybrid Voice Adapter
+ * Combines multiple voice providers:
+ * - STT: Gemini (free with Gemini API key, supports 125+ languages with auto-detection)
+ * - TTS: ElevenLabs (supports 70+ languages with multilingual voice cloning)
+ *
+ * Features:
+ * - Automatic language detection
+ * - Dynamic voice switching based on detected language
+ * - Language-to-voice mapping
+ */
+export declare class HybridVoiceAdapter implements IVoiceAdapter {
+    private sttAdapter;
+    private ttsAdapter;
+    private voiceMapper;
+    private currentLanguage;
+    private voiceConfig?;
+    constructor(geminiApiKey: string, elevenLabsApiKey: string, voiceConfig?: VoiceConfig);
+    /**
+     * Speech-to-text using Gemini with auto language detection
+     */
+    speechToText(audioBase64: string, config?: VoiceConfig['stt']): Promise<string>;
+    /**
+     * Text-to-speech using ElevenLabs with dynamic voice selection
+     */
+    textToSpeech(text: string, config?: VoiceConfig['tts']): Promise<Uint8Array>;
+    /**
+     * Declare the audio format produced by the TTS adapter (ElevenLabs)
+     */
+    getTTSOutputFormat(): AudioFormatMetadata;
+    /**
+     * Declare the expected audio format for the STT adapter (Gemini)
+     */
+    getSTTInputFormat(): AudioFormatMetadata;
+    /**
+     * Set current language for TTS voice selection
+     * @param languageCode ISO 639-1 language code (e.g., 'en', 'ar', 'fa')
+     */
+    setLanguage(languageCode: string): void;
+    /**
+     * Get current language
+     */
+    getCurrentLanguage(): string;
+    /**
+     * Get supported languages
+     */
+    getSupportedLanguages(): string[];
+    /**
+     * Add custom voice mapping for a language
+     */
+    addVoiceMapping(languageCode: string, voiceId: string, name: string): void;
+}
+//# sourceMappingURL=HybridVoiceAdapter.d.ts.map

package/dist/adapters/voice/HybridVoiceAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HybridVoiceAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/voice/HybridVoiceAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAKnF;;;;;;;;;;GAUG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IACpD,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,WAAW,CAAC,CAAc;gBAG9B,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,MAAM,EACxB,WAAW,CAAC,EAAE,WAAW;IAwB7B;;OAEG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAIrF;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAgBlF;;OAEG;IACH,kBAAkB,IAAI,mBAAmB;IAIzC;;OAEG;IACH,iBAAiB,IAAI,mBAAmB;IAIxC;;;OAGG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAQvC;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACH,qBAAqB,IAAI,MAAM,EAAE;IAIjC;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;CAG7E"}

package/dist/adapters/voice/HybridVoiceAdapter.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HybridVoiceAdapter = void 0;
+const GeminiVoiceAdapter_1 = require("./GeminiVoiceAdapter");
+const ElevenLabsVoiceAdapter_1 = require("./ElevenLabsVoiceAdapter");
+const LanguageVoiceMapper_1 = require("./LanguageVoiceMapper");
+/**
+ * Hybrid Voice Adapter
+ * Combines multiple voice providers:
+ * - STT: Gemini (free with Gemini API key, supports 125+ languages with auto-detection)
+ * - TTS: ElevenLabs (supports 70+ languages with multilingual voice cloning)
+ *
+ * Features:
+ * - Automatic language detection
+ * - Dynamic voice switching based on detected language
+ * - Language-to-voice mapping
+ */
+class HybridVoiceAdapter {
+    constructor(geminiApiKey, elevenLabsApiKey, voiceConfig) {
+        this.currentLanguage = 'en';
+        this.voiceConfig = voiceConfig;
+        // Use Gemini for STT
+        this.sttAdapter = new GeminiVoiceAdapter_1.GeminiVoiceAdapter(geminiApiKey, voiceConfig);
+        // Use ElevenLabs for TTS
+        this.ttsAdapter = new ElevenLabsVoiceAdapter_1.ElevenLabsVoiceAdapter(elevenLabsApiKey, voiceConfig);
+        // Initialize voice mapper with custom mappings from config
+        const customVoiceMappings = voiceConfig?.tts?.multiLingualVoices;
+        let transformedMappings;
+        if (customVoiceMappings) {
+            transformedMappings = {};
+            for (const [lang, voiceId] of Object.entries(customVoiceMappings)) {
+                transformedMappings[lang] = { voiceId, name: `Custom ${lang.toUpperCase()} Voice` };
+            }
+        }
+        this.voiceMapper = new LanguageVoiceMapper_1.LanguageVoiceMapper(transformedMappings);
+    }
+    /**
+     * Speech-to-text using Gemini with auto language detection
+     */
+    async speechToText(audioBase64, config) {
+        return await this.sttAdapter.speechToText(audioBase64, config);
+    }
+    /**
+     * Text-to-speech using ElevenLabs with dynamic voice selection
+     */
+    async textToSpeech(text, config) {
+        // Use language-specific voice if available
+        const voiceId = this.voiceMapper.getVoiceForLanguage(this.currentLanguage);
+        // Build language-specific config
+        const languageConfig = {
+            provider: (config?.provider || this.voiceConfig?.tts?.provider || 'elevenlabs'),
+            voice: voiceId,
+            language: this.currentLanguage,
+            speakingRate: config?.speakingRate || this.voiceConfig?.tts?.speakingRate,
+            pitch: config?.pitch || this.voiceConfig?.tts?.pitch
+        };
+        return await this.ttsAdapter.textToSpeech(text, languageConfig);
+    }
+    /**
+     * Declare the audio format produced by the TTS adapter (ElevenLabs)
+     */
+    getTTSOutputFormat() {
+        return this.ttsAdapter.getTTSOutputFormat();
+    }
+    /**
+     * Declare the expected audio format for the STT adapter (Gemini)
+     */
+    getSTTInputFormat() {
+        return this.sttAdapter.getSTTInputFormat();
+    }
+    /**
+     * Set current language for TTS voice selection
+     * @param languageCode ISO 639-1 language code (e.g., 'en', 'ar', 'fa')
+     */
+    setLanguage(languageCode) {
+        if (this.currentLanguage !== languageCode) {
+            const voiceMapping = this.voiceMapper.getVoiceMapping(languageCode);
+            console.log(`[HybridVoiceAdapter] Language switched to '${languageCode}' using voice: ${voiceMapping.name} (${voiceMapping.voiceId})`);
+        }
+        this.currentLanguage = languageCode;
+    }
+    /**
+     * Get current language
+     */
+    getCurrentLanguage() {
+        return this.currentLanguage;
+    }
+    /**
+     * Get supported languages
+     */
+    getSupportedLanguages() {
+        return this.voiceMapper.getSupportedLanguages();
+    }
+    /**
+     * Add custom voice mapping for a language
+     */
+    addVoiceMapping(languageCode, voiceId, name) {
+        this.voiceMapper.setVoiceMapping(languageCode, { voiceId, name });
+    }
+}
+exports.HybridVoiceAdapter = HybridVoiceAdapter;
+//# sourceMappingURL=HybridVoiceAdapter.js.map

package/dist/adapters/voice/HybridVoiceAdapter.js.map

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

package/dist/adapters/voice/LanguageVoiceMapper.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Language to Voice ID Mapping
+ *
+ * Maps ISO 639-1 language codes to ElevenLabs voice IDs.
+ * Provides default voices for common languages and supports custom mappings.
+ *
+ * VOICE PREFERENCE POLICY:
+ * - Female voices are preferred by default for better user experience
+ * - Only use male voices when female voices are not available for a language
+ * - Default voice: Rachel (female, multilingual, supports 29 languages)
+ */
+export interface VoiceMapping {
+    voiceId: string;
+    name: string;
+    description?: string;
+    gender?: 'female' | 'male' | 'neutral';
+}
+export declare class LanguageVoiceMapper {
+    private static readonly DEFAULT_VOICES;
+    /**
+     * VOICE PREFERENCE POLICY:
+     * All default voices use Rachel (21m00Tcm4TlvDq8ikWAM) - a female multilingual voice.
+     *
+     * To add language-specific female voices:
+     * 1. Use customMappings in constructor, OR
+     * 2. Configure via ConversationConfig.languageVoiceMapping
+     *
+     * Example female ElevenLabs voices (update with actual voice IDs):
+     * - Rachel: 21m00Tcm4TlvDq8ikWAM (multilingual, female)
+     * - Bella: EXAVITQu4vr4xnSDxMaL (English, female)
+     * - Elli: MF3mGyEYCl7XYWbV9V6O (English, female)
+     *
+     * Always prefer female voices unless specifically unavailable for a language.
+     */
+    private customMappings;
+    constructor(customMappings?: Record<string, VoiceMapping>);
+    /**
+     * Get voice ID for a language
+     * @param languageCode ISO 639-1 language code
+     * @returns Voice ID for the language
+     */
+    getVoiceForLanguage(languageCode: string): string;
+    /**
+     * Get voice mapping details
+     */
+    getVoiceMapping(languageCode: string): VoiceMapping;
+    /**
+     * Add or update custom voice mapping
+     */
+    setVoiceMapping(languageCode: string, voiceMapping: VoiceMapping): void;
+    /**
+     * Get all supported languages
+     */
+    getSupportedLanguages(): string[];
+    /**
+     * Check if a language is supported
+     */
+    isLanguageSupported(languageCode: string): boolean;
+}
+//# sourceMappingURL=LanguageVoiceMapper.d.ts.map

package/dist/adapters/voice/LanguageVoiceMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LanguageVoiceMapper.d.ts","sourceRoot":"","sources":["../../../src/adapters/voice/LanguageVoiceMapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED,qBAAa,mBAAmB;IAG5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAwDpC;IAEF;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,cAAc,CAA+B;gBAEzC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAIzD;;;;OAIG;IACH,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAkBjD;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY;IAOnD;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,IAAI;IAIvE;;OAEG;IACH,qBAAqB,IAAI,MAAM,EAAE;IAOjC;;OAEG;IACH,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;CAIrD"}

package/dist/adapters/voice/LanguageVoiceMapper.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * Language to Voice ID Mapping
+ *
+ * Maps ISO 639-1 language codes to ElevenLabs voice IDs.
+ * Provides default voices for common languages and supports custom mappings.
+ *
+ * VOICE PREFERENCE POLICY:
+ * - Female voices are preferred by default for better user experience
+ * - Only use male voices when female voices are not available for a language
+ * - Default voice: Rachel (female, multilingual, supports 29 languages)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LanguageVoiceMapper = void 0;
+class LanguageVoiceMapper {
+    constructor(customMappings) {
+        this.customMappings = customMappings || {};
+    }
+    /**
+     * Get voice ID for a language
+     * @param languageCode ISO 639-1 language code
+     * @returns Voice ID for the language
+     */
+    getVoiceForLanguage(languageCode) {
+        const code = languageCode.toLowerCase();
+        // Check custom mappings first
+        if (this.customMappings[code]) {
+            return this.customMappings[code].voiceId;
+        }
+        // Check default mappings
+        if (LanguageVoiceMapper.DEFAULT_VOICES[code]) {
+            return LanguageVoiceMapper.DEFAULT_VOICES[code].voiceId;
+        }
+        // Fallback to default English voice
+        console.warn(`[LanguageVoiceMapper] No voice mapping found for language '${code}'. Using default English voice.`);
+        return LanguageVoiceMapper.DEFAULT_VOICES['en'].voiceId;
+    }
+    /**
+     * Get voice mapping details
+     */
+    getVoiceMapping(languageCode) {
+        const code = languageCode.toLowerCase();
+        return this.customMappings[code] ||
+            LanguageVoiceMapper.DEFAULT_VOICES[code] ||
+            LanguageVoiceMapper.DEFAULT_VOICES['en'];
+    }
+    /**
+     * Add or update custom voice mapping
+     */
+    setVoiceMapping(languageCode, voiceMapping) {
+        this.customMappings[languageCode.toLowerCase()] = voiceMapping;
+    }
+    /**
+     * Get all supported languages
+     */
+    getSupportedLanguages() {
+        return [
+            ...Object.keys(LanguageVoiceMapper.DEFAULT_VOICES),
+            ...Object.keys(this.customMappings)
+        ];
+    }
+    /**
+     * Check if a language is supported
+     */
+    isLanguageSupported(languageCode) {
+        const code = languageCode.toLowerCase();
+        return !!(LanguageVoiceMapper.DEFAULT_VOICES[code] || this.customMappings[code]);
+    }
+}
+exports.LanguageVoiceMapper = LanguageVoiceMapper;
+// Default voice mappings for common languages
+// These are example ElevenLabs voice IDs - replace with actual production voices
+LanguageVoiceMapper.DEFAULT_VOICES = {
+    'en': {
+        voiceId: '21m00Tcm4TlvDq8ikWAM', // Rachel (default English voice)
+        name: 'Rachel',
+        description: 'Clear American English'
+    },
+    'ar': {
+        voiceId: '21m00Tcm4TlvDq8ikWAM', // Same voice - ElevenLabs supports multilingual
+        name: 'Rachel (Arabic)',
+        description: 'Multilingual voice for Arabic'
+    },
+    'fa': {
+        voiceId: '21m00Tcm4TlvDq8ikWAM', // Same voice - supports Persian
+        name: 'Rachel (Persian)',
+        description: 'Multilingual voice for Persian'
+    },
+    'es': {
+        voiceId: '21m00Tcm4TlvDq8ikWAM',
+        name: 'Rachel (Spanish)',
+        description: 'Multilingual voice for Spanish'
+    },
+    'fr': {
+        voiceId: '21m00Tcm4TlvDq8ikWAM',
+        name: 'Rachel (French)',
+        description: 'Multilingual voice for French'
+    },
+    'de': {
+        voiceId: '21m00Tcm4TlvDq8ikWAM',
+        name: 'Rachel (German)',
+        description: 'Multilingual voice for German'
+    },
+    'it': {
+        voiceId: '21m00Tcm4TlvDq8ikWAM',
+        name: 'Rachel (Italian)',
+        description: 'Multilingual voice for Italian'
+    },
+    'pt': {
+        voiceId: '21m00Tcm4TlvDq8ikWAM',
+        name: 'Rachel (Portuguese)',
+        description: 'Multilingual voice for Portuguese'
+    },
+    'zh': {
+        voiceId: '21m00Tcm4TlvDq8ikWAM',
+        name: 'Rachel (Chinese)',
+        description: 'Multilingual voice for Chinese'
+    },
+    'ja': {
+        voiceId: '21m00Tcm4TlvDq8ikWAM',
+        name: 'Rachel (Japanese)',
+        description: 'Multilingual voice for Japanese'
+    },
+    'ko': {
+        voiceId: '21m00Tcm4TlvDq8ikWAM',
+        name: 'Rachel (Korean)',
+        description: 'Multilingual voice for Korean'
+    }
+};
+//# sourceMappingURL=LanguageVoiceMapper.js.map

package/dist/adapters/voice/LanguageVoiceMapper.js.map

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

package/dist/adapters/voice/VertexVoiceAdapter.d.ts

@@ -0,0 +1,32 @@
+import { IVoiceAdapter, VoiceConfig, AudioFormatMetadata } from '../../interfaces';
+/**
+ * Vertex Voice Adapter - Gemini 2.0 / 2.5
+ * Uses the Generative Language API (Multimodal) for both STT and TTS.
+ */
+export declare class VertexVoiceAdapter implements IVoiceAdapter {
+    private apiKey;
+    private voiceConfig?;
+    private sttModelId;
+    private ttsModelId;
+    constructor(apiKey: string, voiceConfig?: VoiceConfig);
+    /**
+     * Speech-to-Text via Gemini 2.0
+     * Uses multimodal input to transcribe audio.
+     */
+    speechToText(audioBase64: string, config?: VoiceConfig['stt']): Promise<string>;
+    /**
+     * Text-to-Speech via Gemini 2.5
+     * Requests "AUDIO" modality in the response.
+     */
+    textToSpeech(text: string, config?: VoiceConfig['tts']): Promise<Uint8Array>;
+    private base64ToUint8Array;
+    /**
+     * Wrap raw PCM data in a WAV container.
+     * Gemini output: 24kHz, 1 channel, 16-bit
+     */
+    private wrapInWav;
+    private writeString;
+    getTTSOutputFormat(): AudioFormatMetadata;
+    getSTTInputFormat(): AudioFormatMetadata;
+}
+//# sourceMappingURL=VertexVoiceAdapter.d.ts.map

package/dist/adapters/voice/VertexVoiceAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VertexVoiceAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/voice/VertexVoiceAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEnF;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IACpD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAC,CAAc;IAGlC,OAAO,CAAC,UAAU,CAA2B;IAE7C,OAAO,CAAC,UAAU,CAAkC;gBAExC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW;IAKrD;;;OAGG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAoDrF;;;OAGG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAkDlF,OAAO,CAAC,kBAAkB;IAc1B;;;OAGG;IACH,OAAO,CAAC,SAAS;IAuCjB,OAAO,CAAC,WAAW;IAMnB,kBAAkB,IAAI,mBAAmB;IAIzC,iBAAiB,IAAI,mBAAmB;CAG3C"}

package/dist/adapters/voice/VertexVoiceAdapter.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VertexVoiceAdapter = void 0;
+/**
+ * Vertex Voice Adapter - Gemini 2.0 / 2.5
+ * Uses the Generative Language API (Multimodal) for both STT and TTS.
+ */
+class VertexVoiceAdapter {
+    constructor(apiKey, voiceConfig) {
+        // Using lite model for STT (known to work with inline audio)
+        this.sttModelId = 'gemini-2.0-flash-lite';
+        // Using specific preview model for TTS support
+        this.ttsModelId = 'gemini-2.5-flash-preview-tts';
+        this.apiKey = apiKey;
+        this.voiceConfig = voiceConfig;
+    }
+    /**
+     * Speech-to-Text via Gemini 2.0
+     * Uses multimodal input to transcribe audio.
+     */
+    async speechToText(audioBase64, config) {
+        const url = `https://generativelanguage.googleapis.com/v1beta/models/${this.sttModelId}:generateContent?key=${this.apiKey}`;
+        // STT uses camelCase for gemini-2.0-flash-exp standard parts (or snake_case? exp usually supports snake_case but let's stick to standard if possible or try likely variants)
+        // Trying camelCase based on standard JSON API behavior.
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    contents: [{
+                            role: 'user',
+                            parts: [
+                                // System instruction via prompt
+                                { text: "Transcribe the audio exactly as spoken. Do not add timestamps, speaker labels, or conversational filler." },
+                                {
+                                    inlineData: {
+                                        mimeType: config?.encoding === 'FLAC' ? 'audio/flac' :
+                                            config?.encoding === 'LINEAR16' ? 'audio/l16' :
+                                                'audio/wav',
+                                        data: audioBase64
+                                    }
+                                }
+                            ]
+                        }],
+                    generationConfig: {
+                        temperature: 0,
+                    }
+                })
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Gemini STT Error (${response.status}): ${errorText}`);
+            }
+            const json = await response.json();
+            const text = json.candidates?.[0]?.content?.parts?.[0]?.text;
+            if (!text) {
+                console.warn('Gemini STT returned no text content.');
+                return '';
+            }
+            return text.trim();
+        }
+        catch (error) {
+            console.error('Vertex STT Exception:', error);
+            throw new Error(`STT failed: ${error.message}`);
+        }
+    }
+    /**
+     * Text-to-Speech via Gemini 2.5
+     * Requests "AUDIO" modality in the response.
+     */
+    async textToSpeech(text, config) {
+        const ttsConfig = config || this.voiceConfig?.tts;
+        const voiceName = ttsConfig?.voice || 'Puck';
+        const url = `https://generativelanguage.googleapis.com/v1beta/models/${this.ttsModelId}:generateContent?key=${this.apiKey}`;
+        // Uses snake_case for TTS preview model as established by working attempts initially (Step 231)
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    contents: [{
+                            parts: [{ text: `Please speak the following text: ${text}` }]
+                        }],
+                    generation_config: {
+                        response_modalities: ["AUDIO"],
+                        speech_config: {
+                            voice_config: {
+                                prebuilt_voice_config: {
+                                    voice_name: voiceName
+                                }
+                            }
+                        }
+                    }
+                })
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                if (response.status === 401)
+                    throw new Error("Unauthorized: Invalid API Key.");
+                throw new Error(`Gemini TTS Error (${response.status}): ${errorText}`);
+            }
+            const json = await response.json();
+            // Extract the base64 audio data
+            const audioPart = json.candidates?.[0]?.content?.parts?.find((p) => p.inlineData || p.inline_data);
+            const audioBase64 = audioPart?.inlineData?.data || audioPart?.inline_data?.data;
+            if (!audioBase64) {
+                throw new Error('Model generated response but did not return audio data. Ensure "AUDIO" modality is supported by your key/region.');
+            }
+            return this.wrapInWav(this.base64ToUint8Array(audioBase64));
+        }
+        catch (error) {
+            console.error('Vertex TTS Exception:', error);
+            throw new Error(`TTS failed: ${error.message}`);
+        }
+    }
+    base64ToUint8Array(base64) {
+        if (typeof Buffer !== 'undefined') {
+            return new Uint8Array(Buffer.from(base64, 'base64'));
+        }
+        else {
+            const binaryString = atob(base64);
+            const len = binaryString.length;
+            const bytes = new Uint8Array(len);
+            for (let i = 0; i < len; i++) {
+                bytes[i] = binaryString.charCodeAt(i);
+            }
+            return bytes;
+        }
+    }
+    /**
+     * Wrap raw PCM data in a WAV container.
+     * Gemini output: 24kHz, 1 channel, 16-bit
+     */
+    wrapInWav(pcmData) {
+        const sampleRate = 24000;
+        const channels = 1;
+        const bitDepth = 16;
+        const byteRate = sampleRate * channels * (bitDepth / 8);
+        const blockAlign = channels * (bitDepth / 8);
+        const dataSize = pcmData.length;
+        const fileSize = 36 + dataSize;
+        const header = new Uint8Array(44);
+        const view = new DataView(header.buffer);
+        // RIFF chunk descriptor
+        this.writeString(view, 0, 'RIFF');
+        view.setUint32(4, fileSize, true); // true = little-endian
+        this.writeString(view, 8, 'WAVE');
+        // fmt sub-chunk
+        this.writeString(view, 12, 'fmt ');
+        view.setUint32(16, 16, true); // Subchunk1Size (16 for PCM)
+        view.setUint16(20, 1, true); // AudioFormat (1 for PCM)
+        view.setUint16(22, channels, true);
+        view.setUint32(24, sampleRate, true);
+        view.setUint32(28, byteRate, true);
+        view.setUint16(32, blockAlign, true);
+        view.setUint16(34, bitDepth, true);
+        // data sub-chunk
+        this.writeString(view, 36, 'data');
+        view.setUint32(40, dataSize, true);
+        // Concatenate header and PCM data
+        const wavFile = new Uint8Array(header.length + pcmData.length);
+        wavFile.set(header);
+        wavFile.set(pcmData, header.length);
+        return wavFile;
+    }
+    writeString(view, offset, string) {
+        for (let i = 0; i < string.length; i++) {
+            view.setUint8(offset + i, string.charCodeAt(i));
+        }
+    }
+    getTTSOutputFormat() {
+        return { format: 'wav', sampleRate: 24000, channels: 1, bitDepth: 16 };
+    }
+    getSTTInputFormat() {
+        return { format: 'wav', sampleRate: 16000, channels: 1, bitDepth: 16 };
+    }
+}
+exports.VertexVoiceAdapter = VertexVoiceAdapter;
+//# sourceMappingURL=VertexVoiceAdapter.js.map

package/dist/adapters/voice/VertexVoiceAdapter.js.map

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

package/dist/adapters/webhook/WebhookService.d.ts

@@ -0,0 +1,47 @@
+import { IWebhookService, Message, IntentResult, WorkflowResult } from '../../interfaces';
+import { ConversationSession } from '../../core/entities/ConversationSession';
+/**
+ * WebhookService
+ *
+ * Handles HTTP POST delivery of webhook events to configured endpoints.
+ * Features:
+ * - Event filtering (only sends subscribed events)
+ * - Event-specific payload construction
+ * - Custom headers support
+ * - Async fire-and-forget delivery
+ * - Error logging without blocking conversation flow
+ * - Wraps internal session data extraction
+ */
+export declare class WebhookService implements IWebhookService {
+    constructor();
+    triggerSessionStarted(session: ConversationSession): Promise<void>;
+    /**
+     * Get webhook config from session metadata
+     */
+    private getWebhookConfig;
+    triggerSessionEnded(session: ConversationSession, recordingUrl?: string): Promise<void>;
+    triggerUserMessage(session: ConversationSession, message: Message): Promise<void>;
+    triggerBotMessage(session: ConversationSession, message: Message): Promise<void>;
+    triggerIntentDetected(session: ConversationSession, intent: IntentResult): Promise<void>;
+    triggerIntentFailed(session: ConversationSession, intent: IntentResult): Promise<void>;
+    triggerWorkflowExecuted(session: ConversationSession, workflow: {
+        workflowName: string;
+        parameters: any;
+        result: WorkflowResult;
+    }): Promise<void>;
+    triggerWorkflowFailed(session: ConversationSession, workflow: {
+        workflowName: string;
+        parameters: any;
+        error?: string;
+    }): Promise<void>;
+    triggerErrorOccurred(session: ConversationSession, error: Error): Promise<void>;
+    /**
+     * Internal method to send webhook via HTTP POST
+     */
+    private sendWebhook;
+    /**
+     * Build base session data for webhooks
+     */
+    private getSessionData;
+}
+//# sourceMappingURL=WebhookService.d.ts.map

package/dist/adapters/webhook/WebhookService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebhookService.d.ts","sourceRoot":"","sources":["../../../src/adapters/webhook/WebhookService.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,eAAe,EAiBf,OAAO,EACP,YAAY,EACZ,cAAc,EACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAE9E;;;;;;;;;;;GAWG;AACH,qBAAa,cAAe,YAAW,eAAe;;IAI5C,qBAAqB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxE;;OAEG;YACW,gBAAgB;IAKxB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CvF,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBjF,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBhF,qBAAqB,CAAC,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBxF,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBtF,uBAAuB,CACzB,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,cAAc,CAAA;KAAE,GAC5E,OAAO,CAAC,IAAI,CAAC;IAgBV,qBAAqB,CACvB,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,GAAG,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACpE,OAAO,CAAC,IAAI,CAAC;IAgBV,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBrF;;OAEG;YACW,WAAW;IAoCzB;;OAEG;IACH,OAAO,CAAC,cAAc;CA2BzB"}