tjbot-ce 3.0.1

package/dist/tts/backends/sherpa-onnx-tts.js

@@ -0,0 +1,237 @@
+/**
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import fs from 'fs';
+import path from 'path';
+import { ModelRegistry, TJBotError } from '../../utils/index.js';
+import { getLogger } from '../../utils/logging.js';
+import { TTSEngine } from '../tts-engine.js';
+const logger = getLogger(import.meta.url);
+// Lazy require sherpa-onnx to avoid hard dependency issues
+let sherpa;
+/**
+ * Sherpa-ONNX Local Text-to-Speech Engine
+ *
+ * Offline speech synthesis using Sherpa-ONNX library with Piper voices.
+ * Models are automatically downloaded and cached in ~/.tjbot/models/sherpa-tts/
+ * @public
+ */
+export class SherpaONNXTTSEngine extends TTSEngine {
+    registry = ModelRegistry.getInstance();
+    modelInfo;
+    modelPath;
+    ttsEngine;
+    /**
+     * Initialize the sherpa-onnx TTS engine.
+     * Pre-downloads the configured model.
+     */
+    async initialize() {
+        const config = this.config;
+        if (!config.model) {
+            throw new TJBotError('Sherpa-ONNX TTS model not specified. Provide model name in speak.backend.sherpa-onnx config.');
+        }
+        // Set environment variables to reduce noisy logging
+        if (!process.env.SHERPA_ONNX_LOG_LEVEL) {
+            process.env.SHERPA_ONNX_LOG_LEVEL = 'OFF';
+        }
+        // Load sherpa-onnx
+        if (!sherpa) {
+            const module = await import('sherpa-onnx-node');
+            // CommonJS module imported as ES module has exports in .default
+            sherpa = (module.default || module);
+            logger.debug('successfully loaded sherpa-onnx-node module');
+        }
+        // Load TTS model from registry
+        const modelName = config.model;
+        logger.info(`Loading TTS model: ${modelName}`);
+        this.modelInfo = await this.registry.loadModel(modelName);
+        this.modelPath = this.pathForModel();
+        // Load the TTS synthesizer
+        await this.setupSynthesizer();
+        logger.info('Sherpa-ONNX TTS engine initialized');
+    }
+    pathForModel() {
+        if (!this.modelInfo) {
+            throw new TJBotError('Model info not set. Ensure initialize() was called.');
+        }
+        // Resolve the model directory inside the local cache.
+        const modelCacheDir = this.registry.getModelCacheDirForType('tts');
+        const modelDir = path.join(modelCacheDir, this.modelInfo.folder);
+        const vitsDataDir = this.resolveVitsDataDir(modelDir);
+        // The voice model file is expected in the model directory.
+        const files = fs.readdirSync(modelDir).filter((f) => f.endsWith('.onnx'));
+        if (files.length === 0) {
+            throw new TJBotError(`No .onnx file found in model directory: ${modelDir}`);
+        }
+        const modelFile = path.join(modelDir, files[0]);
+        logger.debug(`Found TTS model file: ${modelFile} (vitsDataDir: ${vitsDataDir})`);
+        return modelFile;
+    }
+    /**
+     * Setup synthesizer based on model configuration
+     */
+    async setupSynthesizer() {
+        if (!this.modelInfo) {
+            throw new TJBotError('Model info not set. Ensure initialize() was called.');
+        }
+        if (!this.modelPath) {
+            throw new TJBotError('Model path not set. Ensure model is downloaded and initialize() was called.');
+        }
+        if (!sherpa) {
+            throw new TJBotError('Sherpa-ONNX module not loaded. Ensure initialize() was called.');
+        }
+        const modelFile = this.modelPath;
+        const modelDir = path.dirname(modelFile);
+        const vitsDataDir = this.resolveVitsDataDir(modelDir);
+        logger.debug(`using TTS model file: ${modelFile} (vitsDataDir: ${vitsDataDir})`);
+        this.ttsEngine = this.createOfflineTTS(modelFile, vitsDataDir);
+    }
+    /**
+     * Synthesize text to WAV audio using sherpa-onnx.
+     * Voice is configured at engine initialization time via config.
+     *
+     * @param text - Text to synthesize
+     * @returns WAV audio buffer
+     * @throws Error if not initialized or synthesis fails
+     */
+    async synthesize(text) {
+        if (!sherpa) {
+            throw new TJBotError('Sherpa-ONNX TTS service not initialized. Call initialize() first.');
+        }
+        if (!this.ttsEngine) {
+            throw new TJBotError('TTS engine not initialized. Call initialize() first.');
+        }
+        this.validateText(text);
+        logger.verbose(`Synthesizing speech with Sherpa-ONNX TTS (model=${this.config.model})`);
+        // Perform synthesis - pass parameters as object
+        const audio = this.ttsEngine.generate({
+            text,
+            sid: 0,
+            speed: 1.0,
+        });
+        // Convert audio data to WAV buffer
+        const wavBuffer = this.audioToWav(audio.samples, audio.sampleRate);
+        logger.debug(`Sherpa-ONNX TTS synthesis complete: ${wavBuffer.length} bytes`);
+        return wavBuffer;
+    }
+    /**
+     * Resolve the data directory for VITS models. Some models include
+     * a separate "espeak-ng-data" folder with necessary data files.
+     * If that folder exists, return its path. Otherwise, return
+     * the base model directory.
+     * @returns Path to the data directory to be used for VITS synthesis
+     */
+    resolveVitsDataDir(modelDir) {
+        const espeakNgDataDir = path.join(modelDir, 'espeak-ng-data');
+        return fs.existsSync(espeakNgDataDir) ? espeakNgDataDir : modelDir;
+    }
+    /**
+     * Setup synthesizer based on model configuration. Creates the OfflineTts instance with the appropriate config.
+     * @param modelFile The full path to the model file
+     * @param vitsDataDir The directory containing VITS data files (may be the same as modelDir or a subdirectory)
+     * @returns An instance of OfflineTts configured with the specified model
+     */
+    createOfflineTTS(modelFile, vitsDataDir) {
+        if (!sherpa) {
+            throw new TJBotError('Sherpa-ONNX module not loaded. Ensure initialize() was called.');
+        }
+        // Suppress sherpa-onnx console output
+        const originalLog = console.log;
+        const originalError = console.error;
+        console.log = () => { };
+        console.error = () => { };
+        const tokensPath = path.join(path.dirname(modelFile), 'tokens.txt');
+        if (!fs.existsSync(tokensPath)) {
+            throw new TJBotError(`Tokens file not found for model ${modelFile} at expected path: ${tokensPath}`);
+        }
+        let ttsEngine;
+        try {
+            // Use the camelCase config expected by sherpa-onnx-node bindings
+            const offlineTtsConfig = {
+                model: {
+                    vits: {
+                        model: modelFile,
+                        tokens: tokensPath,
+                        dataDir: vitsDataDir,
+                        noiseScale: 0.667,
+                        noiseScaleW: 0.8,
+                        lengthScale: 1.0,
+                    },
+                    numThreads: 1,
+                    provider: 'cpu',
+                    debug: 0,
+                },
+                maxNumSentences: 1,
+            };
+            ttsEngine = new sherpa.OfflineTts(offlineTtsConfig);
+        }
+        finally {
+            console.log = originalLog;
+            console.error = originalError;
+        }
+        return ttsEngine;
+    }
+    /**
+     * Convert PCM samples to WAV format.
+     * Creates a proper WAV file with header and audio data.
+     *
+     * @param samples - PCM audio samples (typically as Float32Array)
+     * @param sampleRate - Sample rate in Hz (e.g., 22050)
+     * @returns WAV file as Buffer
+     */
+    audioToWav(samples, sampleRate) {
+        // Convert samples to 16-bit PCM
+        const pcm16 = this.float32ToPcm16(samples);
+        // Create WAV header
+        const channels = 1;
+        const bytesPerSample = 2;
+        const byteRate = sampleRate * channels * bytesPerSample;
+        const blockAlign = channels * bytesPerSample;
+        const header = Buffer.alloc(44);
+        // "RIFF" chunk descriptor
+        header.write('RIFF', 0, 4, 'ascii');
+        header.writeUInt32LE(36 + pcm16.length, 4);
+        header.write('WAVE', 8, 4, 'ascii');
+        // "fmt " subchunk
+        header.write('fmt ', 12, 4, 'ascii');
+        header.writeUInt32LE(16, 16); // Subchunk1Size (16 for PCM)
+        header.writeUInt16LE(1, 20); // AudioFormat (1 for PCM)
+        header.writeUInt16LE(channels, 22); // NumChannels
+        header.writeUInt32LE(sampleRate, 24); // SampleRate
+        header.writeUInt32LE(byteRate, 28); // ByteRate
+        header.writeUInt16LE(blockAlign, 32); // BlockAlign
+        header.writeUInt16LE(16, 34); // BitsPerSample
+        // "data" subchunk
+        const dataHeader = Buffer.alloc(8);
+        dataHeader.write('data', 0, 4, 'ascii');
+        dataHeader.writeUInt32LE(pcm16.length, 4);
+        return Buffer.concat([header, dataHeader, pcm16]);
+    }
+    /**
+     * Convert Float32 PCM samples to 16-bit PCM.
+     *
+     * @param float32Samples - Float32 audio samples (range -1.0 to 1.0)
+     * @returns 16-bit PCM samples as Buffer
+     */
+    float32ToPcm16(float32Samples) {
+        const output = new Int16Array(float32Samples.length);
+        for (let i = 0; i < float32Samples.length; i++) {
+            const sample = Math.max(-1, Math.min(1, float32Samples[i]));
+            output[i] = sample < 0 ? sample * 0x8000 : sample * 0x7fff;
+        }
+        return Buffer.from(output.buffer);
+    }
+}
+//# sourceMappingURL=sherpa-onnx-tts.js.map

package/dist/tts/backends/sherpa-onnx-tts.js.map

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

package/dist/tts/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export { TTSController } from './tts.js';
+export { createTTSEngine } from './tts-engine.js';
+export type { TTSEngine } from './tts-engine.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/tts/index.js

@@ -0,0 +1,20 @@
+/**
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// TTS controller
+export { TTSController } from './tts.js';
+// TTS engine factory (async)
+export { createTTSEngine } from './tts-engine.js';
+//# sourceMappingURL=index.js.map

package/dist/tts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,6BAA6B;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/tts/tts-engine.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { SpeakConfig, TTSEngineConfig } from '../config/index.js';
+/**
+ * Abstract Text-to-Speech Engine Base Class
+ *
+ * Defines the interface for TTS backends (IBM Watson, sherpa-onnx, etc.)
+ * All implementations must extend this class and implement the required methods.
+ * @public
+ */
+export declare abstract class TTSEngine {
+    protected config: TTSEngineConfig;
+    constructor(config?: TTSEngineConfig);
+    /**
+     * Initialize the TTS engine. Must be called before synthesize().
+     * @throws {TJBotError} if initialization fails
+     * @public
+     */
+    abstract initialize(): Promise<void>;
+    /**
+     * Clean up resources used by the TTS engine.
+     * Optional method for backends that need to release resources.
+     * @public
+     */
+    cleanup?(): Promise<void>;
+    /**
+     * Synthesize text to WAV audio.
+     * Both backends should validate input text and return audio as a Buffer in WAV format.
+     * Voice is configured at engine initialization time and cannot be changed per synthesis call.
+     * @param text - Text to synthesize
+     * @returns WAV audio buffer
+     * @throws {TJBotError} if synthesis fails
+     * @public
+     */
+    abstract synthesize(text: string): Promise<Buffer>;
+    /**
+     * Validates text input for synthesis.
+     * Checks for null/empty/whitespace-only input.
+     *
+     * @param text - Text to validate
+     * @throws Error if text is invalid
+     */
+    protected validateText(text: string): void;
+}
+/**
+ * Create a TTS engine instance based on the configuration.
+ * Uses dynamic imports to lazily load backend implementations only when needed.
+ * @param speakConfig - Configuration for the TTS engine with backend settings
+ * @returns {Promise<TTSEngine>} Initialized TTS engine instance
+ * @throws {TJBotError} if backend type is unknown or dependencies are not installed
+ * @public
+ */
+export declare function createTTSEngine(speakConfig: SpeakConfig): Promise<TTSEngine>;
+//# sourceMappingURL=tts-engine.d.ts.map

package/dist/tts/tts-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts-engine.d.ts","sourceRoot":"","sources":["../../src/tts/tts-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACH,WAAW,EAGX,eAAe,EAElB,MAAM,oBAAoB,CAAC;AAG5B;;;;;;GAMG;AACH,8BAAsB,SAAS;IAC3B,SAAS,CAAC,MAAM,EAAE,eAAe,CAAC;gBAEtB,MAAM,CAAC,EAAE,eAAe;IAIpC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAEpC;;;;OAIG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAEzB;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAElD;;;;;;OAMG;IACH,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAK7C;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAoElF"}

package/dist/tts/tts-engine.js

@@ -0,0 +1,109 @@
+/**
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { getTTSBackendConfig, } from '../config/index.js';
+import { TJBotError } from '../utils/index.js';
+/**
+ * Abstract Text-to-Speech Engine Base Class
+ *
+ * Defines the interface for TTS backends (IBM Watson, sherpa-onnx, etc.)
+ * All implementations must extend this class and implement the required methods.
+ * @public
+ */
+export class TTSEngine {
+    config;
+    constructor(config) {
+        this.config = config ?? {};
+    }
+    /**
+     * Validates text input for synthesis.
+     * Checks for null/empty/whitespace-only input.
+     *
+     * @param text - Text to validate
+     * @throws Error if text is invalid
+     */
+    validateText(text) {
+        if (!text || typeof text !== 'string' || text.trim().length === 0) {
+            throw new TJBotError('Text input cannot be empty or whitespace-only');
+        }
+    }
+}
+/**
+ * Create a TTS engine instance based on the configuration.
+ * Uses dynamic imports to lazily load backend implementations only when needed.
+ * @param speakConfig - Configuration for the TTS engine with backend settings
+ * @returns {Promise<TTSEngine>} Initialized TTS engine instance
+ * @throws {TJBotError} if backend type is unknown or dependencies are not installed
+ * @public
+ */
+export async function createTTSEngine(speakConfig) {
+    const backend = (speakConfig.backend?.type ?? 'local');
+    try {
+        if (backend === 'none') {
+            // Return a stub engine that throws on all synthesize calls
+            class NoneTTSEngine extends TTSEngine {
+                async initialize() {
+                    // No-op for 'none' backend
+                }
+                async synthesize() {
+                    throw new TJBotError('TTS is disabled. Configure a text-to-speech backend (local, ibm-watson-tts, google-cloud-tts, or azure-tts) to use speech synthesis.');
+                }
+            }
+            return new NoneTTSEngine();
+        }
+        if (backend === 'local') {
+            const module = await import('./backends/sherpa-onnx-tts.js');
+            if (!module?.SherpaONNXTTSEngine) {
+                throw new TJBotError('TTS backend "local" is unavailable (missing SherpaONNXTTSEngine export).');
+            }
+            const config = getTTSBackendConfig(speakConfig.backend, backend);
+            return new module.SherpaONNXTTSEngine(config);
+        }
+        if (backend === 'ibm-watson-tts') {
+            const module = await import('./backends/ibm-watson-tts.js');
+            if (!module?.IBMTTSEngine) {
+                throw new TJBotError('TTS backend "ibm-watson-tts" is unavailable (missing IBMTTSEngine export).');
+            }
+            const config = getTTSBackendConfig(speakConfig.backend, backend);
+            return new module.IBMTTSEngine(config);
+        }
+        if (backend === 'google-cloud-tts') {
+            const module = await import('./backends/google-cloud-tts.js');
+            if (!module?.GoogleCloudTTSEngine) {
+                throw new TJBotError('TTS backend "google-cloud-tts" is unavailable (missing GoogleCloudTTSEngine export).');
+            }
+            const config = getTTSBackendConfig(speakConfig.backend, backend);
+            return new module.GoogleCloudTTSEngine(config);
+        }
+        if (backend === 'azure-tts') {
+            const module = await import('./backends/azure-tts.js');
+            if (!module?.AzureTTSEngine) {
+                throw new TJBotError('TTS backend "azure-tts" is unavailable (missing AzureTTSEngine export).');
+            }
+            const config = getTTSBackendConfig(speakConfig.backend, backend);
+            return new module.AzureTTSEngine(config);
+        }
+        throw new TJBotError(`Unknown TTS backend type: ${backend}`);
+    }
+    catch (error) {
+        if (error instanceof TJBotError) {
+            throw error;
+        }
+        throw new TJBotError(`Failed to load TTS backend "${backend}". Ensure dependencies are installed.`, {
+            cause: error,
+        });
+    }
+}
+//# sourceMappingURL=tts-engine.js.map

package/dist/tts/tts-engine.js.map

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

package/dist/tts/tts.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Copyright 2025 IBM Corp. All Rights Reserved.
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { SpeakConfig } from '../config/config-types.js';
+import { SpeakerController } from '../speaker/index.js';
+/**
+ * TTS controller manages text-to-speech synthesis and engine lifecycle.
+ * TTS engine is eagerly initialized during setupSpeaker() and cached for reuse.
+
+ */
+export declare class TTSController {
+    private ttsEngine?;
+    private speakerController;
+    private speakConfig?;
+    constructor(speakerController: SpeakerController);
+    /**
+     * Initialize the TTS backend
+     * Called during setupSpeaker to eagerly load TTS engine
+     * @param config Configuration object with backend, IBM settings, and Sherpa settings
+     */
+    initialize(config: SpeakConfig): Promise<void>;
+    /**
+     * Synthesize text to speech and play the audio.
+     * Lazily initializes the TTS engine on first call.
+     *
+     * @param text The text to speak
+     */
+    speak(text: string): Promise<void>;
+    /**
+     * Clean up TTS resources.
+     */
+    cleanup(): Promise<void>;
+}
+//# sourceMappingURL=tts.d.ts.map

package/dist/tts/tts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts.d.ts","sourceRoot":"","sources":["../../src/tts/tts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAOxD;;;;GAIG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,WAAW,CAAC,CAAc;gBAEtB,iBAAiB,EAAE,iBAAiB;IAKhD;;;;OAIG;IACG,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpD;;;;;OAKG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CxC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAOjC"}

package/dist/tts/tts.js

@@ -0,0 +1,101 @@
+/**
+ * Copyright 2025 IBM Corp. All Rights Reserved.
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import fs from 'fs';
+import temp from 'temp';
+import { TJBotError } from '../utils/errors.js';
+import { getLogger } from '../utils/logging.js';
+import { createTTSEngine } from './tts-engine.js';
+const logger = getLogger(import.meta.url);
+/**
+ * TTS controller manages text-to-speech synthesis and engine lifecycle.
+ * TTS engine is eagerly initialized during setupSpeaker() and cached for reuse.
+
+ */
+export class TTSController {
+    ttsEngine;
+    speakerController;
+    speakConfig;
+    constructor(speakerController) {
+        this.ttsEngine = undefined;
+        this.speakerController = speakerController;
+    }
+    /**
+     * Initialize the TTS backend
+     * Called during setupSpeaker to eagerly load TTS engine
+     * @param config Configuration object with backend, IBM settings, and Sherpa settings
+     */
+    async initialize(config) {
+        this.speakConfig = config;
+        this.ttsEngine = await createTTSEngine(config);
+        await this.ttsEngine.initialize();
+    }
+    /**
+     * Synthesize text to speech and play the audio.
+     * Lazily initializes the TTS engine on first call.
+     *
+     * @param text The text to speak
+     */
+    async speak(text) {
+        if (this.ttsEngine === undefined) {
+            throw new TJBotError('TTS engine not initialized. Call initialize() before speaking.');
+        }
+        if (!text || text.trim().length === 0) {
+            throw new TJBotError('Text to speak cannot be empty');
+        }
+        try {
+            // Synthesize audio - voice is configured at engine initialization time
+            logger.verbose('Synthesizing speech...');
+            const audioBuffer = await this.ttsEngine.synthesize(text);
+            // Write to temporary file
+            const info = temp.openSync('tjbot');
+            logger.debug(`writing audio buffer to temp file: ${info.path}`);
+            const fd = fs.createWriteStream(info.path);
+            fd.write(audioBuffer);
+            // Wait for file to be written
+            const writePromise = new Promise((resolve, reject) => {
+                fd.on('close', () => resolve());
+                fd.on('error', () => reject());
+            });
+            fd.end();
+            await writePromise;
+            // Play the audio file
+            await this.speakerController.playAudio(info.path);
+            // Clean up temp file
+            try {
+                fs.unlinkSync(info.path);
+            }
+            catch (err) {
+                logger.error('Could not delete temp audio file:', err);
+            }
+        }
+        catch (error) {
+            logger.error('Error during speech synthesis:', error);
+            throw error;
+        }
+    }
+    /**
+     * Clean up TTS resources.
+     */
+    async cleanup() {
+        if (this.ttsEngine) {
+            logger.debug('TTSController cleanup');
+            await this.ttsEngine.cleanup?.();
+            this.ttsEngine = undefined;
+        }
+    }
+}
+//# sourceMappingURL=tts.js.map

package/dist/tts/tts.js.map

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