@cyanheads/mcp-ts-core 0.1.0-beta.12

package/dist/services/speech/core/ISpeechProvider.js

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview Core interface definition for speech service providers.
+ * Provides the contract for Text-to-Speech (TTS) and Speech-to-Text (STT) operations.
+ * @module src/services/speech/core/ISpeechProvider
+ */
+/**
+ * Type guard — returns `true` if the provider supports text-to-speech synthesis.
+ *
+ * @param provider - Any `ISpeechProvider` instance.
+ * @returns `true` when `provider.supportsTTS` is set, narrowing the type for callers.
+ *
+ * @example
+ * if (supportsTTS(provider)) {
+ *   const result = await provider.textToSpeech({ text: 'Hello' });
+ * }
+ */
+export function supportsTTS(provider) {
+    return provider.supportsTTS;
+}
+/**
+ * Type guard — returns `true` if the provider supports speech-to-text transcription.
+ *
+ * @param provider - Any `ISpeechProvider` instance.
+ * @returns `true` when `provider.supportsSTT` is set, narrowing the type for callers.
+ *
+ * @example
+ * if (supportsSTT(provider)) {
+ *   const result = await provider.speechToText({ audio: buffer });
+ * }
+ */
+export function supportsSTT(provider) {
+    return provider.supportsSTT;
+}
+//# sourceMappingURL=ISpeechProvider.js.map

package/dist/services/speech/core/ISpeechProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISpeechProvider.js","sourceRoot":"","sources":["../../../../src/services/speech/core/ISpeechProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA8EH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,QAAyB;IACnD,OAAO,QAAQ,CAAC,WAAW,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,QAAyB;IACnD,OAAO,QAAQ,CAAC,WAAW,CAAC;AAC9B,CAAC"}

package/dist/services/speech/core/SpeechService.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @fileoverview Speech service orchestrator.
+ * Manages independent TTS and STT provider instances, allowing different providers
+ * to be used for each capability (e.g., ElevenLabs for TTS and Whisper for STT).
+ * @module src/services/speech/core/SpeechService
+ */
+import type { SpeechProviderConfig } from '../types.js';
+import type { ISpeechProvider } from './ISpeechProvider.js';
+/**
+ * Factory function that instantiates a concrete {@link ISpeechProvider} from a config object.
+ * Performs an exhaustive switch over `config.provider` so TypeScript enforces handling
+ * of every declared variant at compile time.
+ *
+ * @param config - Provider configuration including the `provider` discriminant, API key,
+ *   base URL, default voice/model IDs, and timeout.
+ * @returns A fully constructed provider instance ready for use.
+ * @throws {McpError} With `InvalidParams` for the `'mock'` provider (not yet implemented)
+ *   or for any unrecognized provider string.
+ *
+ * @example
+ * const tts = createSpeechProvider({ provider: 'elevenlabs', apiKey: process.env.ELEVEN_KEY });
+ */
+export declare function createSpeechProvider(config: SpeechProviderConfig): ISpeechProvider;
+/**
+ * Orchestrates TTS and STT operations across independently configured providers.
+ * Each capability (TTS, STT) can be backed by a different provider; either or both
+ * may be absent if only one capability is needed.
+ *
+ * @example
+ * const speech = new SpeechService(
+ *   { provider: 'elevenlabs', apiKey: process.env.ELEVEN_KEY },
+ *   { provider: 'openai-whisper', apiKey: process.env.OPENAI_KEY },
+ * );
+ * const { tts, stt } = await speech.healthCheck();
+ */
+export declare class SpeechService {
+    private ttsProvider?;
+    private sttProvider?;
+    /**
+     * Construct a SpeechService with optional TTS and STT providers.
+     * Providers are instantiated via {@link createSpeechProvider}. If a provider's declared
+     * capability does not match its config slot (e.g., a TTS-only provider passed as
+     * `sttConfig`), a warning is logged but no error is thrown.
+     *
+     * @param ttsConfig - Config for the text-to-speech provider. Omit if TTS is not needed.
+     * @param sttConfig - Config for the speech-to-text provider. Omit if STT is not needed.
+     */
+    constructor(ttsConfig?: SpeechProviderConfig, sttConfig?: SpeechProviderConfig);
+    /**
+     * Return the configured TTS provider.
+     *
+     * @returns The active {@link ISpeechProvider} for text-to-speech.
+     * @throws {McpError} With `InvalidRequest` if no TTS provider was configured.
+     */
+    getTTSProvider(): ISpeechProvider;
+    /**
+     * Return the configured STT provider.
+     *
+     * @returns The active {@link ISpeechProvider} for speech-to-text.
+     * @throws {McpError} With `InvalidRequest` if no STT provider was configured.
+     */
+    getSTTProvider(): ISpeechProvider;
+    /**
+     * Returns `true` if a TTS provider is configured and declares `supportsTTS`.
+     *
+     * @returns `true` when TTS synthesis is available, `false` otherwise.
+     */
+    hasTTS(): boolean;
+    /**
+     * Returns `true` if an STT provider is configured and declares `supportsSTT`.
+     *
+     * @returns `true` when speech transcription is available, `false` otherwise.
+     */
+    hasSTT(): boolean;
+    /**
+     * Run health checks against all configured providers in parallel.
+     * Providers that are not configured report `false` without making any network call.
+     *
+     * @returns Object with `tts` and `stt` boolean fields indicating provider health.
+     *   Never rejects — individual provider errors are caught internally.
+     */
+    healthCheck(): Promise<{
+        tts: boolean;
+        stt: boolean;
+    }>;
+}
+//# sourceMappingURL=SpeechService.d.ts.map

package/dist/services/speech/core/SpeechService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpeechService.d.ts","sourceRoot":"","sources":["../../../../src/services/speech/core/SpeechService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,eAAe,CAqBlF;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,WAAW,CAAC,CAAkB;IACtC,OAAO,CAAC,WAAW,CAAC,CAAkB;IAEtC;;;;;;;;OAQG;gBACS,SAAS,CAAC,EAAE,oBAAoB,EAAE,SAAS,CAAC,EAAE,oBAAoB;IAoB9E;;;;;OAKG;IACH,cAAc,IAAI,eAAe;IAOjC;;;;;OAKG;IACH,cAAc,IAAI,eAAe;IAOjC;;;;OAIG;IACH,MAAM,IAAI,OAAO;IAIjB;;;;OAIG;IACH,MAAM,IAAI,OAAO;IAIjB;;;;;;OAMG;IACG,WAAW,IAAI,OAAO,CAAC;QAC3B,GAAG,EAAE,OAAO,CAAC;QACb,GAAG,EAAE,OAAO,CAAC;KACd,CAAC;CASH"}

package/dist/services/speech/core/SpeechService.js

@@ -0,0 +1,135 @@
+/**
+ * @fileoverview Speech service orchestrator.
+ * Manages independent TTS and STT provider instances, allowing different providers
+ * to be used for each capability (e.g., ElevenLabs for TTS and Whisper for STT).
+ * @module src/services/speech/core/SpeechService
+ */
+import { JsonRpcErrorCode, McpError } from '../../../types-global/errors.js';
+import { logger } from '../../../utils/internal/logger.js';
+import { ElevenLabsProvider } from '../providers/elevenlabs.provider.js';
+import { WhisperProvider } from '../providers/whisper.provider.js';
+/**
+ * Factory function that instantiates a concrete {@link ISpeechProvider} from a config object.
+ * Performs an exhaustive switch over `config.provider` so TypeScript enforces handling
+ * of every declared variant at compile time.
+ *
+ * @param config - Provider configuration including the `provider` discriminant, API key,
+ *   base URL, default voice/model IDs, and timeout.
+ * @returns A fully constructed provider instance ready for use.
+ * @throws {McpError} With `InvalidParams` for the `'mock'` provider (not yet implemented)
+ *   or for any unrecognized provider string.
+ *
+ * @example
+ * const tts = createSpeechProvider({ provider: 'elevenlabs', apiKey: process.env.ELEVEN_KEY });
+ */
+export function createSpeechProvider(config) {
+    logger.debug(`Creating speech provider: ${config.provider}`);
+    switch (config.provider) {
+        case 'elevenlabs':
+            return new ElevenLabsProvider(config);
+        case 'openai-whisper':
+            return new WhisperProvider(config);
+        case 'mock':
+            throw new McpError(JsonRpcErrorCode.InvalidParams, 'Mock provider not yet implemented');
+        default: {
+            const _exhaustive = config.provider;
+            throw new McpError(JsonRpcErrorCode.InvalidParams, `Unknown speech provider: ${String(_exhaustive)}`);
+        }
+    }
+}
+/**
+ * Orchestrates TTS and STT operations across independently configured providers.
+ * Each capability (TTS, STT) can be backed by a different provider; either or both
+ * may be absent if only one capability is needed.
+ *
+ * @example
+ * const speech = new SpeechService(
+ *   { provider: 'elevenlabs', apiKey: process.env.ELEVEN_KEY },
+ *   { provider: 'openai-whisper', apiKey: process.env.OPENAI_KEY },
+ * );
+ * const { tts, stt } = await speech.healthCheck();
+ */
+export class SpeechService {
+    ttsProvider;
+    sttProvider;
+    /**
+     * Construct a SpeechService with optional TTS and STT providers.
+     * Providers are instantiated via {@link createSpeechProvider}. If a provider's declared
+     * capability does not match its config slot (e.g., a TTS-only provider passed as
+     * `sttConfig`), a warning is logged but no error is thrown.
+     *
+     * @param ttsConfig - Config for the text-to-speech provider. Omit if TTS is not needed.
+     * @param sttConfig - Config for the speech-to-text provider. Omit if STT is not needed.
+     */
+    constructor(ttsConfig, sttConfig) {
+        if (ttsConfig) {
+            this.ttsProvider = createSpeechProvider(ttsConfig);
+            if (!this.ttsProvider.supportsTTS) {
+                logger.warning(`TTS provider ${ttsConfig.provider} does not support text-to-speech`);
+            }
+        }
+        if (sttConfig) {
+            this.sttProvider = createSpeechProvider(sttConfig);
+            if (!this.sttProvider.supportsSTT) {
+                logger.warning(`STT provider ${sttConfig.provider} does not support speech-to-text`);
+            }
+        }
+        logger.info(`Speech service initialized: TTS=${this.ttsProvider?.name ?? 'none'}, STT=${this.sttProvider?.name ?? 'none'}`);
+    }
+    /**
+     * Return the configured TTS provider.
+     *
+     * @returns The active {@link ISpeechProvider} for text-to-speech.
+     * @throws {McpError} With `InvalidRequest` if no TTS provider was configured.
+     */
+    getTTSProvider() {
+        if (!this.ttsProvider) {
+            throw new McpError(JsonRpcErrorCode.InvalidRequest, 'No TTS provider configured');
+        }
+        return this.ttsProvider;
+    }
+    /**
+     * Return the configured STT provider.
+     *
+     * @returns The active {@link ISpeechProvider} for speech-to-text.
+     * @throws {McpError} With `InvalidRequest` if no STT provider was configured.
+     */
+    getSTTProvider() {
+        if (!this.sttProvider) {
+            throw new McpError(JsonRpcErrorCode.InvalidRequest, 'No STT provider configured');
+        }
+        return this.sttProvider;
+    }
+    /**
+     * Returns `true` if a TTS provider is configured and declares `supportsTTS`.
+     *
+     * @returns `true` when TTS synthesis is available, `false` otherwise.
+     */
+    hasTTS() {
+        return this.ttsProvider?.supportsTTS ?? false;
+    }
+    /**
+     * Returns `true` if an STT provider is configured and declares `supportsSTT`.
+     *
+     * @returns `true` when speech transcription is available, `false` otherwise.
+     */
+    hasSTT() {
+        return this.sttProvider?.supportsSTT ?? false;
+    }
+    /**
+     * Run health checks against all configured providers in parallel.
+     * Providers that are not configured report `false` without making any network call.
+     *
+     * @returns Object with `tts` and `stt` boolean fields indicating provider health.
+     *   Never rejects — individual provider errors are caught internally.
+     */
+    async healthCheck() {
+        const ttsHealth = this.ttsProvider ? await this.ttsProvider.healthCheck() : false;
+        const sttHealth = this.sttProvider ? await this.sttProvider.healthCheck() : false;
+        return {
+            tts: ttsHealth,
+            stt: sttHealth,
+        };
+    }
+}
+//# sourceMappingURL=SpeechService.js.map

package/dist/services/speech/core/SpeechService.js.map

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

package/dist/services/speech/providers/elevenlabs.provider.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @fileoverview ElevenLabs text-to-speech provider implementation.
+ * Wraps the ElevenLabs v1 REST API to provide TTS synthesis and voice listing.
+ * STT is not supported by ElevenLabs and will throw `MethodNotFound`.
+ * @module src/services/speech/providers/elevenlabs.provider
+ */
+import type { ISpeechProvider } from '../core/ISpeechProvider.js';
+import type { SpeechProviderConfig, SpeechToTextOptions, SpeechToTextResult, TextToSpeechOptions, TextToSpeechResult, Voice } from '../types.js';
+/**
+ * ElevenLabs TTS provider.
+ * Implements {@link ISpeechProvider} for text-to-speech only (`supportsTTS = true`,
+ * `supportsSTT = false`). Calls the ElevenLabs v1 REST API using `fetchWithTimeout`.
+ *
+ * Default voice: `EXAVITQu4vr4xnSDxMaL` (Bella)
+ * Default model: `eleven_monolingual_v1`
+ * Default timeout: 30 000 ms
+ */
+export declare class ElevenLabsProvider implements ISpeechProvider {
+    readonly name = "elevenlabs";
+    readonly supportsTTS = true;
+    readonly supportsSTT = false;
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly defaultVoiceId;
+    private readonly defaultModelId;
+    private readonly timeout;
+    /**
+     * Construct an ElevenLabsProvider.
+     *
+     * @param config - Provider configuration. `config.apiKey` is required; all other
+     *   fields fall back to ElevenLabs defaults.
+     * @throws {McpError} With `InvalidParams` if `config.apiKey` is absent.
+     */
+    constructor(config: SpeechProviderConfig);
+    /**
+     * Synthesize speech from text using the ElevenLabs text-to-speech API.
+     * Posts to `POST /text-to-speech/{voiceId}` and returns the raw MP3 audio as a Buffer.
+     * Voice settings (stability, similarity_boost, style) are merged from `options.voice`
+     * with provider defaults. Text is validated for non-empty and ≤ 5 000 characters.
+     *
+     * @param options - TTS options. `options.text` is required. `options.voice.voiceId`
+     *   overrides the provider default voice; `options.modelId` overrides the default model.
+     * @returns Resolved {@link TextToSpeechResult} with `audio` as a `Buffer`, `format` of
+     *   `'mp3'`, `characterCount` equal to `options.text.length`, and `metadata` containing
+     *   `voiceId`, `modelId`, and `provider`.
+     * @throws {McpError} With `InvalidParams` for empty text or text > 5 000 chars.
+     * @throws {McpError} With `InternalError` if the ElevenLabs API call fails.
+     */
+    textToSpeech(options: TextToSpeechOptions): Promise<TextToSpeechResult>;
+    /**
+     * Not supported — ElevenLabs is a TTS-only provider.
+     *
+     * @param _options - Unused.
+     * @throws {McpError} Always, with `MethodNotFound`.
+     */
+    speechToText(_options: SpeechToTextOptions): Promise<SpeechToTextResult>;
+    /**
+     * Fetch all voices available in the authenticated ElevenLabs account.
+     * Calls `GET /voices` and maps the API response to the canonical {@link Voice} shape,
+     * extracting gender from the `labels.gender` field when present.
+     *
+     * @returns Resolved array of {@link Voice} objects. The array may be empty if the
+     *   account has no voices configured.
+     * @throws {McpError} With `InternalError` if the ElevenLabs API call fails.
+     */
+    getVoices(): Promise<Voice[]>;
+    /**
+     * Verify ElevenLabs API connectivity by attempting to fetch the voice list.
+     * A successful `getVoices()` call indicates the API key is valid and the service
+     * is reachable.
+     *
+     * @returns `true` if `getVoices()` resolves without error, `false` otherwise.
+     *   Never rejects.
+     */
+    healthCheck(): Promise<boolean>;
+}
+//# sourceMappingURL=elevenlabs.provider.d.ts.map

package/dist/services/speech/providers/elevenlabs.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs.provider.d.ts","sourceRoot":"","sources":["../../../../src/services/speech/providers/elevenlabs.provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,KAAK,EACN,MAAM,aAAa,CAAC;AAsBrB;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACxD,SAAgB,IAAI,gBAAgB;IACpC,SAAgB,WAAW,QAAQ;IACnC,SAAgB,WAAW,SAAS;IAEpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC;;;;;;OAMG;gBACS,MAAM,EAAE,oBAAoB;IAgBxC;;;;;;;;;;;;;OAaG;IACG,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqF7E;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAOxE;;;;;;;;OAQG;IACG,SAAS,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAsDnC;;;;;;;OAOG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAiBtC"}

package/dist/services/speech/providers/elevenlabs.provider.js

@@ -0,0 +1,199 @@
+/**
+ * @fileoverview ElevenLabs text-to-speech provider implementation.
+ * Wraps the ElevenLabs v1 REST API to provide TTS synthesis and voice listing.
+ * STT is not supported by ElevenLabs and will throw `MethodNotFound`.
+ * @module src/services/speech/providers/elevenlabs.provider
+ */
+import { JsonRpcErrorCode, McpError } from '../../../types-global/errors.js';
+import { logger } from '../../../utils/internal/logger.js';
+import { requestContextService } from '../../../utils/internal/requestContext.js';
+import { fetchWithTimeout } from '../../../utils/network/fetchWithTimeout.js';
+/**
+ * ElevenLabs TTS provider.
+ * Implements {@link ISpeechProvider} for text-to-speech only (`supportsTTS = true`,
+ * `supportsSTT = false`). Calls the ElevenLabs v1 REST API using `fetchWithTimeout`.
+ *
+ * Default voice: `EXAVITQu4vr4xnSDxMaL` (Bella)
+ * Default model: `eleven_monolingual_v1`
+ * Default timeout: 30 000 ms
+ */
+export class ElevenLabsProvider {
+    name = 'elevenlabs';
+    supportsTTS = true;
+    supportsSTT = false;
+    apiKey;
+    baseUrl;
+    defaultVoiceId;
+    defaultModelId;
+    timeout;
+    /**
+     * Construct an ElevenLabsProvider.
+     *
+     * @param config - Provider configuration. `config.apiKey` is required; all other
+     *   fields fall back to ElevenLabs defaults.
+     * @throws {McpError} With `InvalidParams` if `config.apiKey` is absent.
+     */
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new McpError(JsonRpcErrorCode.InvalidParams, 'ElevenLabs API key is required');
+        }
+        this.apiKey = config.apiKey;
+        this.baseUrl = config.baseUrl ?? 'https://api.elevenlabs.io/v1';
+        this.defaultVoiceId = config.defaultVoiceId ?? 'EXAVITQu4vr4xnSDxMaL'; // Default: Bella
+        this.defaultModelId = config.defaultModelId ?? 'eleven_monolingual_v1';
+        this.timeout = config.timeout ?? 30000;
+        logger.info(`ElevenLabs TTS provider initialized: ${this.baseUrl}, voice=${this.defaultVoiceId}`);
+    }
+    /**
+     * Synthesize speech from text using the ElevenLabs text-to-speech API.
+     * Posts to `POST /text-to-speech/{voiceId}` and returns the raw MP3 audio as a Buffer.
+     * Voice settings (stability, similarity_boost, style) are merged from `options.voice`
+     * with provider defaults. Text is validated for non-empty and ≤ 5 000 characters.
+     *
+     * @param options - TTS options. `options.text` is required. `options.voice.voiceId`
+     *   overrides the provider default voice; `options.modelId` overrides the default model.
+     * @returns Resolved {@link TextToSpeechResult} with `audio` as a `Buffer`, `format` of
+     *   `'mp3'`, `characterCount` equal to `options.text.length`, and `metadata` containing
+     *   `voiceId`, `modelId`, and `provider`.
+     * @throws {McpError} With `InvalidParams` for empty text or text > 5 000 chars.
+     * @throws {McpError} With `InternalError` if the ElevenLabs API call fails.
+     */
+    async textToSpeech(options) {
+        const context = requestContextService.createRequestContext({
+            operation: 'elevenlabs-tts',
+            ...(options.context ?? {}),
+        });
+        const voiceId = options.voice?.voiceId ?? this.defaultVoiceId;
+        const modelId = options.modelId ?? this.defaultModelId;
+        logger.debug('Converting text to speech with ElevenLabs', context);
+        if (!options.text || options.text.trim().length === 0) {
+            throw new McpError(JsonRpcErrorCode.InvalidParams, 'Text cannot be empty', context);
+        }
+        if (options.text.length > 5000) {
+            throw new McpError(JsonRpcErrorCode.InvalidParams, 'Text exceeds maximum length of 5000 characters', context);
+        }
+        const url = `${this.baseUrl}/text-to-speech/${voiceId}`;
+        // Build voice settings
+        const voiceSettings = {
+            stability: options.voice?.stability ?? 0.5,
+            similarity_boost: options.voice?.similarityBoost ?? 0.75,
+            style: options.voice?.style ?? 0.0,
+            use_speaker_boost: true,
+        };
+        const requestBody = {
+            text: options.text,
+            model_id: modelId,
+            voice_settings: voiceSettings,
+        };
+        try {
+            const response = await fetchWithTimeout(url, this.timeout, context, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'xi-api-key': this.apiKey,
+                },
+                body: JSON.stringify(requestBody),
+            });
+            // fetchWithTimeout already throws McpError on non-ok responses
+            const audioBuffer = Buffer.from(await response.arrayBuffer());
+            logger.info(`Text-to-speech conversion successful (voice=${voiceId}, ${audioBuffer.length} bytes)`, context);
+            return {
+                audio: audioBuffer,
+                format: 'mp3',
+                characterCount: options.text.length,
+                metadata: {
+                    voiceId,
+                    modelId,
+                    provider: this.name,
+                },
+            };
+        }
+        catch (error) {
+            if (error instanceof McpError) {
+                throw error;
+            }
+            logger.error('Failed to convert text to speech', error instanceof Error ? error : new Error(String(error)), context);
+            throw new McpError(JsonRpcErrorCode.InternalError, `Failed to convert text to speech: ${error instanceof Error ? error.message : 'Unknown error'}`, context);
+        }
+    }
+    /**
+     * Not supported — ElevenLabs is a TTS-only provider.
+     *
+     * @param _options - Unused.
+     * @throws {McpError} Always, with `MethodNotFound`.
+     */
+    speechToText(_options) {
+        throw new McpError(JsonRpcErrorCode.MethodNotFound, 'Speech-to-text is not supported by ElevenLabs provider');
+    }
+    /**
+     * Fetch all voices available in the authenticated ElevenLabs account.
+     * Calls `GET /voices` and maps the API response to the canonical {@link Voice} shape,
+     * extracting gender from the `labels.gender` field when present.
+     *
+     * @returns Resolved array of {@link Voice} objects. The array may be empty if the
+     *   account has no voices configured.
+     * @throws {McpError} With `InternalError` if the ElevenLabs API call fails.
+     */
+    async getVoices() {
+        const context = requestContextService.createRequestContext({
+            operation: 'elevenlabs-getVoices',
+        });
+        logger.debug('Fetching available voices from ElevenLabs', context);
+        const url = `${this.baseUrl}/voices`;
+        try {
+            const response = await fetchWithTimeout(url, this.timeout, context, {
+                method: 'GET',
+                headers: {
+                    'xi-api-key': this.apiKey,
+                },
+            });
+            // fetchWithTimeout already throws McpError on non-ok responses
+            const data = (await response.json());
+            const voices = data.voices.map((v) => ({
+                id: v.voice_id,
+                name: v.name,
+                ...(v.description !== undefined && { description: v.description }),
+                ...(v.category !== undefined && { category: v.category }),
+                ...(v.preview_url !== undefined && { previewUrl: v.preview_url }),
+                ...(v.labels?.gender !== undefined && {
+                    gender: v.labels.gender,
+                }),
+                metadata: {
+                    labels: v.labels,
+                },
+            }));
+            logger.info(`Successfully fetched ${voices.length} voices`, context);
+            return voices;
+        }
+        catch (error) {
+            if (error instanceof McpError) {
+                throw error;
+            }
+            logger.error('Failed to fetch voices', error instanceof Error ? error : new Error(String(error)), context);
+            throw new McpError(JsonRpcErrorCode.InternalError, `Failed to fetch voices: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Verify ElevenLabs API connectivity by attempting to fetch the voice list.
+     * A successful `getVoices()` call indicates the API key is valid and the service
+     * is reachable.
+     *
+     * @returns `true` if `getVoices()` resolves without error, `false` otherwise.
+     *   Never rejects.
+     */
+    async healthCheck() {
+        try {
+            // Simple health check: try to fetch voices
+            await this.getVoices();
+            return true;
+        }
+        catch (error) {
+            const context = requestContextService.createRequestContext({
+                operation: 'elevenlabs-healthCheck',
+            });
+            logger.error('ElevenLabs health check failed', error instanceof Error ? error : new Error(String(error)), context);
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=elevenlabs.provider.js.map

package/dist/services/speech/providers/elevenlabs.provider.js.map

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

package/dist/services/speech/providers/whisper.provider.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @fileoverview OpenAI Whisper speech-to-text provider implementation.
+ * Wraps the OpenAI audio transcriptions API (`POST /audio/transcriptions`) to provide
+ * STT transcription in multiple languages. TTS is not supported and will throw `MethodNotFound`.
+ * Audio is submitted as multipart `FormData`; the 25 MB Whisper file-size limit is enforced
+ * before the network call.
+ * @module src/services/speech/providers/whisper.provider
+ */
+import type { ISpeechProvider } from '../core/ISpeechProvider.js';
+import type { SpeechProviderConfig, SpeechToTextOptions, SpeechToTextResult, TextToSpeechOptions, TextToSpeechResult, Voice } from '../types.js';
+/**
+ * OpenAI Whisper STT provider.
+ * Implements {@link ISpeechProvider} for speech-to-text only (`supportsSTT = true`,
+ * `supportsTTS = false`). Submits audio to the OpenAI transcriptions endpoint via
+ * multipart form upload using `fetchWithTimeout`.
+ *
+ * Default model: `whisper-1`
+ * Default timeout: 60 000 ms (audio processing is slower than typical API calls)
+ * Maximum audio size: 25 MB (enforced locally before the network call)
+ */
+export declare class WhisperProvider implements ISpeechProvider {
+    readonly name = "openai-whisper";
+    readonly supportsTTS = false;
+    readonly supportsSTT = true;
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly defaultModelId;
+    private readonly timeout;
+    /**
+     * Construct a WhisperProvider.
+     *
+     * @param config - Provider configuration. `config.apiKey` is required; other fields
+     *   fall back to OpenAI API defaults.
+     * @throws {McpError} With `InvalidParams` if `config.apiKey` is absent.
+     */
+    constructor(config: SpeechProviderConfig);
+    /**
+     * Not supported — Whisper is an STT-only provider.
+     *
+     * @param _options - Unused.
+     * @throws {McpError} Always, with `MethodNotFound`.
+     */
+    textToSpeech(_options: TextToSpeechOptions): Promise<TextToSpeechResult>;
+    /**
+     * Transcribe audio to text using the OpenAI Whisper API.
+     * Audio may be provided as a raw `Buffer` or a base64-encoded string. The data is
+     * submitted to `POST /audio/transcriptions` as multipart `FormData`. When
+     * `options.timestamps` is `true`, the request uses `verbose_json` format and requests
+     * word-level granularity, populating `result.words`.
+     *
+     * @param options - Transcription options. `options.audio` is required. Optional fields:
+     *   `format` (determines MIME type/filename), `language` (ISO-639-1 hint),
+     *   `modelId` (overrides provider default), `prompt` (style guide), `temperature`,
+     *   and `timestamps` (enables word-level output).
+     * @returns Resolved {@link SpeechToTextResult} with `text`, optional `language`,
+     *   `duration`, `words` (if timestamps were requested), and `metadata` containing
+     *   `modelId`, `provider`, and `task`.
+     * @throws {McpError} With `InvalidParams` for missing audio, invalid base64, or audio > 25 MB.
+     * @throws {McpError} With `InternalError` if the Whisper API call fails.
+     */
+    speechToText(options: SpeechToTextOptions): Promise<SpeechToTextResult>;
+    /**
+     * Not applicable — Whisper is an STT-only provider with no voice concept.
+     *
+     * @throws {McpError} Always, with `MethodNotFound`.
+     */
+    getVoices(): Promise<Voice[]>;
+    /**
+     * Verify OpenAI API connectivity by fetching the models list (`GET /models`).
+     * Uses a 5-second timeout regardless of the provider's configured `timeout`,
+     * to keep health checks lightweight.
+     *
+     * @returns `true` if the models endpoint responds with HTTP 200, `false` otherwise.
+     *   Never rejects.
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * Map an {@link AudioFormat} string to a file extension for the multipart upload filename.
+     * Defaults to `'mp3'` for unrecognized or absent formats.
+     *
+     * @param format - Audio format string (e.g., `'wav'`, `'ogg'`).
+     * @returns File extension without leading dot (e.g., `'wav'`).
+     */
+    private getFileExtension;
+    /**
+     * Map an {@link AudioFormat} string to the corresponding MIME type for the `Blob`
+     * used in the multipart upload. Defaults to `'audio/mpeg'` for unrecognized formats.
+     *
+     * @param format - Audio format string (e.g., `'wav'`, `'ogg'`).
+     * @returns MIME type string (e.g., `'audio/wav'`).
+     */
+    private getMimeType;
+}
+//# sourceMappingURL=whisper.provider.d.ts.map

package/dist/services/speech/providers/whisper.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whisper.provider.d.ts","sourceRoot":"","sources":["../../../../src/services/speech/providers/whisper.provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,KAAK,EAEN,MAAM,aAAa,CAAC;AAmBrB;;;;;;;;;GASG;AACH,qBAAa,eAAgB,YAAW,eAAe;IACrD,SAAgB,IAAI,oBAAoB;IACxC,SAAgB,WAAW,SAAS;IACpC,SAAgB,WAAW,QAAQ;IAEnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC;;;;;;OAMG;gBACS,MAAM,EAAE,oBAAoB;IAexC;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAOxE;;;;;;;;;;;;;;;;OAgBG;IACG,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAwH7E;;;;OAIG;IACH,SAAS,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAO7B;;;;;;;OAOG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IA2BrC;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;CAYpB"}