@framers/agentos 0.1.109 → 0.1.111

package/dist/speech/providers/DeepgramBatchSTTProvider.js

@@ -2,7 +2,18 @@
  * Maps Deepgram word-level data to {@link SpeechTranscriptionSegment} objects.
  *
  * Each word is promoted to its own segment so that per-word timing and speaker
- * information is preserved in the normalized result.
+ * information is preserved in the normalized result. This 1:1 word-to-segment
+ * mapping enables downstream consumers to reconstruct speaker-attributed
+ * timelines at the finest granularity Deepgram provides.
+ *
+ * Deepgram returns times in seconds (unlike AssemblyAI which uses milliseconds),
+ * so no unit conversion is needed here.
+ *
+ * @param words - Array of Deepgram word objects from the API response.
+ * @returns An array of normalized transcription segments, one per word.
+ *
+ * @see {@link DeepgramWord} for the input shape
+ * @see {@link SpeechTranscriptionSegment} for the output shape
  */
 function wordsToSegments(words) {
     return words.map((w) => ({
@@ -24,46 +35,125 @@ function wordsToSegments(words) {
 /**
  * Speech-to-text provider that uses the Deepgram batch (pre-recorded) REST API.
  *
- * Sends audio as a raw binary body and returns a normalised
- * {@link SpeechTranscriptionResult}. Streaming is not supported — use a
- * Deepgram streaming adapter for real-time transcription.
+ * ## REST API Contract
+ *
+ * - **Endpoint:** `POST https://api.deepgram.com/v1/listen`
+ * - **Authentication:** `Authorization: Token <apiKey>` header
+ * - **Content-Type:** Set to the audio's MIME type (e.g. `audio/wav`)
+ * - **Body:** Raw audio bytes sent directly (no multipart form)
+ * - **Query parameters:** `model`, `punctuate`, `diarize`, `language`
+ * - **Response:** JSON containing `results.channels[].alternatives[]` with
+ *   transcript text, confidence scores, and optional word-level timing
+ *
+ * ## Word-Level Diarization Mapping
+ *
+ * When `enableSpeakerDiarization` is `true`, the `diarize=true` query parameter
+ * is set. Deepgram then includes a `speaker` field (zero-based integer index) on
+ * each word in the response. These speaker indices are preserved through the
+ * {@link wordsToSegments} mapping into the normalized result.
+ *
+ * ## Error Handling
+ *
+ * Non-2xx responses from Deepgram trigger an `Error` with the HTTP status code
+ * and response body text included in the message for debugging. Network-level
+ * errors (DNS failures, timeouts) propagate as-is from the fetch implementation.
+ *
+ * Streaming is NOT supported by this provider — use a Deepgram WebSocket adapter
+ * for real-time transcription.
+ *
+ * @see {@link DeepgramBatchSTTProviderConfig} for configuration options
+ * @see {@link wordsToSegments} for the word-to-segment mapping logic
  *
  * @example
  * ```ts
- * const provider = new DeepgramBatchSTTProvider({ apiKey: process.env.DEEPGRAM_API_KEY! });
- * const result = await provider.transcribe({ data: audioBuffer, mimeType: 'audio/wav' });
+ * const provider = new DeepgramBatchSTTProvider({
+ *   apiKey: process.env.DEEPGRAM_API_KEY!,
+ *   model: 'nova-2',
+ * });
+ * const result = await provider.transcribe(
+ *   { data: audioBuffer, mimeType: 'audio/wav' },
+ *   { enableSpeakerDiarization: true },
+ * );
  * console.log(result.text);
+ * console.log(result.segments?.map(s => `[Speaker ${s.speaker}] ${s.text}`));
  * ```
  */
 export class DeepgramBatchSTTProvider {
+    /**
+     * Creates a new DeepgramBatchSTTProvider.
+     *
+     * @param config - Provider configuration including API key and optional defaults.
+     *
+     * @example
+     * ```ts
+     * const provider = new DeepgramBatchSTTProvider({
+     *   apiKey: 'dg-xxxx',
+     *   model: 'nova-2',
+     *   language: 'en-US',
+     * });
+     * ```
+     */
     constructor(config) {
         this.config = config;
+        /** Unique provider identifier used for registration and resolution. */
         this.id = 'deepgram-batch';
+        /** Human-readable display name for UI and logging. */
         this.displayName = 'Deepgram (Batch)';
+        /** This provider uses synchronous HTTP requests, not WebSocket streaming. */
         this.supportsStreaming = false;
         this.fetchImpl = config.fetchImpl ?? fetch;
     }
-    /** Returns the human-readable provider name. */
+    /**
+     * Returns the human-readable provider name.
+     *
+     * @returns The display name string `'Deepgram (Batch)'`.
+     *
+     * @example
+     * ```ts
+     * provider.getProviderName(); // 'Deepgram (Batch)'
+     * ```
+     */
     getProviderName() {
         return this.displayName;
     }
     /**
      * Transcribes an audio buffer using the Deepgram pre-recorded API.
      *
-     * @param audio - Raw audio data and associated metadata.
-     * @param options - Optional transcription settings (language, diarization…).
-     * @returns A promise resolving to the normalised transcription result.
-     * @throws When the Deepgram API returns a non-2xx status.
+     * Sends the raw audio bytes as the request body (not multipart form) with
+     * the appropriate Content-Type header. The response is parsed and normalized
+     * into a {@link SpeechTranscriptionResult}.
+     *
+     * @param audio - Raw audio data and associated metadata (buffer, MIME type,
+     *   duration). The `data` buffer is sent directly as the request body.
+     * @param options - Optional transcription settings. Supports `model`,
+     *   `language`, and `enableSpeakerDiarization` overrides.
+     * @returns A promise resolving to the normalized transcription result with
+     *   text, confidence, timing, and optional speaker-attributed segments.
+     * @throws {Error} When the Deepgram API returns a non-2xx status code.
+     *   The error message includes the HTTP status and response body for debugging.
+     *
+     * @example
+     * ```ts
+     * const result = await provider.transcribe(
+     *   { data: wavBuffer, mimeType: 'audio/wav', durationSeconds: 5.2 },
+     *   { language: 'fr-FR', enableSpeakerDiarization: true },
+     * );
+     * ```
      */
     async transcribe(audio, options = {}) {
+        // Resolve configuration with fallback chain: options > config > defaults
         const model = options.model ?? this.config.model ?? 'nova-2';
         const lang = options.language ?? this.config.language ?? 'en-US';
         const diarize = options.enableSpeakerDiarization ?? false;
+        // Build the Deepgram REST API URL with query parameters.
+        // Punctuation is always enabled for better transcript readability.
         const url = `https://api.deepgram.com/v1/listen` +
             `?model=${encodeURIComponent(model)}` +
             `&punctuate=true` +
             `&diarize=${diarize}` +
             `&language=${encodeURIComponent(lang)}`;
+        // Use the audio's actual MIME type so Deepgram can decode correctly.
+        // Deepgram supports wav, mp3, ogg, flac, webm, and many other formats.
         const contentType = audio.mimeType ?? 'audio/wav';
         const response = await this.fetchImpl(url, {
             method: 'POST',
@@ -71,6 +161,8 @@ export class DeepgramBatchSTTProvider {
                 Authorization: `Token ${this.config.apiKey}`,
                 'Content-Type': contentType,
             },
+            // Cast needed because SpeechAudioInput.data is typed as Buffer but
+            // fetch expects BodyInit (Blob | ArrayBuffer | string | etc.)
             body: audio.data,
         });
         if (!response.ok) {
@@ -78,20 +170,23 @@ export class DeepgramBatchSTTProvider {
             throw new Error(`Deepgram transcription failed (${response.status}): ${message}`);
         }
         const payload = (await response.json());
+        // Extract the first channel's first alternative — Deepgram always returns
+        // at least one channel with one alternative for valid audio input.
         const firstAlternative = payload.results?.channels?.[0]?.alternatives?.[0];
         const transcript = firstAlternative?.transcript ?? '';
         const confidence = firstAlternative?.confidence;
         const words = firstAlternative?.words ?? [];
+        // Prefer the API's reported duration over the client-provided estimate
         const durationSeconds = payload.metadata?.duration ?? audio.durationSeconds;
         return {
             text: transcript,
             language: lang,
             durationSeconds,
             confidence,
-            cost: 0,
+            cost: 0, // Cost tracking is handled at a higher layer
             segments: words.length > 0 ? wordsToSegments(words) : undefined,
             providerResponse: payload,
-            isFinal: true,
+            isFinal: true, // Batch API always returns final results
             usage: {
                 durationMinutes: (durationSeconds ?? 0) / 60,
                 modelUsed: model,

package/dist/speech/providers/DeepgramBatchSTTProvider.js.map

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

package/dist/speech/providers/ElevenLabsTextToSpeechProvider.d.ts

@@ -1,20 +1,169 @@
 import type { SpeechSynthesisOptions, SpeechSynthesisResult, SpeechVoice, TextToSpeechProvider } from '../types.js';
+/**
+ * Configuration for the {@link ElevenLabsTextToSpeechProvider}.
+ *
+ * @see {@link ElevenLabsTextToSpeechProvider} for usage examples
+ * @see https://docs.elevenlabs.io/api-reference/text-to-speech
+ */
 export interface ElevenLabsTextToSpeechProviderConfig {
+    /**
+     * ElevenLabs API key used for authentication.
+     * Sent as the `xi-api-key` header value (not Bearer-style auth).
+     */
     apiKey: string;
+    /**
+     * Base URL for the ElevenLabs API. Override for proxies or self-hosted instances.
+     * @default 'https://api.elevenlabs.io/v1'
+     */
     baseUrl?: string;
+    /**
+     * Default voice ID. ElevenLabs uses opaque IDs (not human-readable names).
+     * @default 'EXAVITQu4vr4xnSDxMaL' (the "Sarah" voice)
+     */
     voiceId?: string;
+    /**
+     * Default model ID for synthesis.
+     * @default 'eleven_multilingual_v2'
+     */
     model?: string;
+    /**
+     * Custom fetch implementation for dependency injection in tests.
+     * @default globalThis.fetch
+     */
     fetchImpl?: typeof fetch;
 }
+/**
+ * Text-to-speech provider that uses the ElevenLabs TTS API.
+ *
+ * ## API Contract
+ *
+ * - **Endpoint:** `POST {baseUrl}/text-to-speech/{voiceId}`
+ * - **Authentication:** `xi-api-key: <apiKey>` header
+ * - **Content-Type:** `application/json`
+ * - **Accept:** `audio/mpeg` (MP3 response)
+ * - **Request body:** `{ text, model_id, voice_settings: { stability, similarity_boost, style, use_speaker_boost } }`
+ * - **Response:** Raw MP3 audio bytes
+ *
+ * ## Voice Settings
+ *
+ * ElevenLabs exposes fine-grained voice control via `voice_settings`:
+ * - **stability** (0.0–1.0) — Lower values = more expressive/variable, higher = more consistent
+ * - **similarity_boost** (0.0–1.0) — Higher values make output more similar to the original voice
+ * - **style** (0.0–1.0) — Style exaggeration (optional, only for v2+ models)
+ * - **use_speaker_boost** (boolean) — Enhances speaker similarity (default: true)
+ *
+ * These can be passed via `options.providerSpecificOptions`.
+ *
+ * ## Voice ID Resolution
+ *
+ * The voice ID is resolved with the following priority:
+ * 1. `options.voice` (per-call override)
+ * 2. `config.voiceId` (constructor default)
+ * 3. `options.providerSpecificOptions.voiceId` (legacy override path)
+ * 4. `'EXAVITQu4vr4xnSDxMaL'` (hardcoded fallback — the "Sarah" voice)
+ *
+ * ## Voice Listing
+ *
+ * {@link listAvailableVoices} fetches the user's voice library from the
+ * `/voices` endpoint and maps each entry to the normalized {@link SpeechVoice}
+ * shape. Returns an empty array on API errors (graceful degradation).
+ *
+ * @see {@link ElevenLabsTextToSpeechProviderConfig} for configuration options
+ *
+ * @example
+ * ```ts
+ * const provider = new ElevenLabsTextToSpeechProvider({
+ *   apiKey: process.env.ELEVENLABS_API_KEY!,
+ *   voiceId: 'pNInz6obpgDQGcFmaJgB', // "Adam"
+ * });
+ * const result = await provider.synthesize('Hello world', {
+ *   providerSpecificOptions: { stability: 0.7, similarityBoost: 0.8 },
+ * });
+ * ```
+ */
 export declare class ElevenLabsTextToSpeechProvider implements TextToSpeechProvider {
     private readonly config;
+    /** Unique provider identifier used for registration and resolution. */
     readonly id = "elevenlabs";
+    /** Human-readable display name for UI and logging. */
     readonly displayName = "ElevenLabs";
+    /**
+     * Streaming is supported — ElevenLabs offers a WebSocket streaming endpoint,
+     * and even the REST endpoint can be consumed as a stream.
+     */
     readonly supportsStreaming = true;
+    /** Fetch implementation — injected for testability, defaults to global fetch. */
     private readonly fetchImpl;
+    /**
+     * Creates a new ElevenLabsTextToSpeechProvider.
+     *
+     * @param config - Provider configuration including API key and optional defaults.
+     *
+     * @example
+     * ```ts
+     * const provider = new ElevenLabsTextToSpeechProvider({
+     *   apiKey: 'xi-xxxx',
+     *   voiceId: 'pNInz6obpgDQGcFmaJgB',
+     *   model: 'eleven_multilingual_v2',
+     * });
+     * ```
+     */
     constructor(config: ElevenLabsTextToSpeechProviderConfig);
+    /**
+     * Returns the human-readable provider name.
+     *
+     * @returns The display name string `'ElevenLabs'`.
+     *
+     * @example
+     * ```ts
+     * provider.getProviderName(); // 'ElevenLabs'
+     * ```
+     */
     getProviderName(): string;
+    /**
+     * Synthesizes speech from text using the ElevenLabs TTS API.
+     *
+     * @param text - The text to convert to audio.
+     * @param options - Optional synthesis settings. Use `providerSpecificOptions`
+     *   to control ElevenLabs-specific voice settings (stability, similarityBoost,
+     *   style, useSpeakerBoost).
+     * @returns A promise resolving to the MP3 audio buffer and metadata.
+     * @throws {Error} When the ElevenLabs API returns a non-2xx status code.
+     *   Common causes: invalid API key (401), voice not found (404),
+     *   character limit exceeded (400), or rate limit (429).
+     *
+     * @example
+     * ```ts
+     * const result = await provider.synthesize('Hello there!', {
+     *   voice: 'pNInz6obpgDQGcFmaJgB',
+     *   providerSpecificOptions: {
+     *     stability: 0.3,       // More expressive
+     *     similarityBoost: 0.9, // Closer to original voice
+     *     style: 0.5,           // Moderate style exaggeration
+     *   },
+     * });
+     * ```
+     */
     synthesize(text: string, options?: SpeechSynthesisOptions): Promise<SpeechSynthesisResult>;
+    /**
+     * Fetches the user's voice library from the ElevenLabs API.
+     *
+     * Returns available voices mapped to the normalized {@link SpeechVoice} shape.
+     * Gracefully returns an empty array on API errors (e.g. network failure,
+     * invalid key) to avoid breaking voice selection UIs.
+     *
+     * The voice library includes both ElevenLabs' pre-made voices and any
+     * custom/cloned voices in the user's account.
+     *
+     * @returns A promise resolving to an array of available voices, or an empty
+     *   array if the API call fails.
+     *
+     * @example
+     * ```ts
+     * const voices = await provider.listAvailableVoices();
+     * const rachel = voices.find(v => v.name === 'Rachel');
+     * ```
+     */
     listAvailableVoices(): Promise<SpeechVoice[]>;
 }
 //# sourceMappingURL=ElevenLabsTextToSpeechProvider.d.ts.map

package/dist/speech/providers/ElevenLabsTextToSpeechProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ElevenLabsTextToSpeechProvider.d.ts","sourceRoot":"","sources":["../../../src/speech/providers/ElevenLabsTextToSpeechProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EACrB,WAAW,EACX,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,oCAAoC;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,qBAAa,8BAA+B,YAAW,oBAAoB;IAM7D,OAAO,CAAC,QAAQ,CAAC,MAAM;IALnC,SAAgB,EAAE,gBAAgB;IAClC,SAAgB,WAAW,gBAAgB;IAC3C,SAAgB,iBAAiB,QAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAEZ,MAAM,EAAE,oCAAoC;IAIzE,eAAe,IAAI,MAAM;IAInB,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC;IA8D3B,mBAAmB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CAwCpD"}
+{"version":3,"file":"ElevenLabsTextToSpeechProvider.d.ts","sourceRoot":"","sources":["../../../src/speech/providers/ElevenLabsTextToSpeechProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EACrB,WAAW,EACX,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAErB;;;;;GAKG;AACH,MAAM,WAAW,oCAAoC;IACnD;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,qBAAa,8BAA+B,YAAW,oBAAoB;IA8B7D,OAAO,CAAC,QAAQ,CAAC,MAAM;IA7BnC,uEAAuE;IACvE,SAAgB,EAAE,gBAAgB;IAElC,sDAAsD;IACtD,SAAgB,WAAW,gBAAgB;IAE3C;;;OAGG;IACH,SAAgB,iBAAiB,QAAQ;IAEzC,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IAEzC;;;;;;;;;;;;;OAaG;gBAC0B,MAAM,EAAE,oCAAoC;IAIzE;;;;;;;;;OASG;IACH,eAAe,IAAI,MAAM;IAIzB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC;IAwEjC;;;;;;;;;;;;;;;;;;OAkBG;IACG,mBAAmB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CA6CpD"}

package/dist/speech/providers/ElevenLabsTextToSpeechProvider.js

@@ -1,42 +1,153 @@
+/**
+ * Text-to-speech provider that uses the ElevenLabs TTS API.
+ *
+ * ## API Contract
+ *
+ * - **Endpoint:** `POST {baseUrl}/text-to-speech/{voiceId}`
+ * - **Authentication:** `xi-api-key: <apiKey>` header
+ * - **Content-Type:** `application/json`
+ * - **Accept:** `audio/mpeg` (MP3 response)
+ * - **Request body:** `{ text, model_id, voice_settings: { stability, similarity_boost, style, use_speaker_boost } }`
+ * - **Response:** Raw MP3 audio bytes
+ *
+ * ## Voice Settings
+ *
+ * ElevenLabs exposes fine-grained voice control via `voice_settings`:
+ * - **stability** (0.0–1.0) — Lower values = more expressive/variable, higher = more consistent
+ * - **similarity_boost** (0.0–1.0) — Higher values make output more similar to the original voice
+ * - **style** (0.0–1.0) — Style exaggeration (optional, only for v2+ models)
+ * - **use_speaker_boost** (boolean) — Enhances speaker similarity (default: true)
+ *
+ * These can be passed via `options.providerSpecificOptions`.
+ *
+ * ## Voice ID Resolution
+ *
+ * The voice ID is resolved with the following priority:
+ * 1. `options.voice` (per-call override)
+ * 2. `config.voiceId` (constructor default)
+ * 3. `options.providerSpecificOptions.voiceId` (legacy override path)
+ * 4. `'EXAVITQu4vr4xnSDxMaL'` (hardcoded fallback — the "Sarah" voice)
+ *
+ * ## Voice Listing
+ *
+ * {@link listAvailableVoices} fetches the user's voice library from the
+ * `/voices` endpoint and maps each entry to the normalized {@link SpeechVoice}
+ * shape. Returns an empty array on API errors (graceful degradation).
+ *
+ * @see {@link ElevenLabsTextToSpeechProviderConfig} for configuration options
+ *
+ * @example
+ * ```ts
+ * const provider = new ElevenLabsTextToSpeechProvider({
+ *   apiKey: process.env.ELEVENLABS_API_KEY!,
+ *   voiceId: 'pNInz6obpgDQGcFmaJgB', // "Adam"
+ * });
+ * const result = await provider.synthesize('Hello world', {
+ *   providerSpecificOptions: { stability: 0.7, similarityBoost: 0.8 },
+ * });
+ * ```
+ */
 export class ElevenLabsTextToSpeechProvider {
+    /**
+     * Creates a new ElevenLabsTextToSpeechProvider.
+     *
+     * @param config - Provider configuration including API key and optional defaults.
+     *
+     * @example
+     * ```ts
+     * const provider = new ElevenLabsTextToSpeechProvider({
+     *   apiKey: 'xi-xxxx',
+     *   voiceId: 'pNInz6obpgDQGcFmaJgB',
+     *   model: 'eleven_multilingual_v2',
+     * });
+     * ```
+     */
     constructor(config) {
         this.config = config;
+        /** Unique provider identifier used for registration and resolution. */
         this.id = 'elevenlabs';
+        /** Human-readable display name for UI and logging. */
         this.displayName = 'ElevenLabs';
+        /**
+         * Streaming is supported — ElevenLabs offers a WebSocket streaming endpoint,
+         * and even the REST endpoint can be consumed as a stream.
+         */
         this.supportsStreaming = true;
         this.fetchImpl = config.fetchImpl ?? fetch;
     }
+    /**
+     * Returns the human-readable provider name.
+     *
+     * @returns The display name string `'ElevenLabs'`.
+     *
+     * @example
+     * ```ts
+     * provider.getProviderName(); // 'ElevenLabs'
+     * ```
+     */
     getProviderName() {
         return this.displayName;
     }
+    /**
+     * Synthesizes speech from text using the ElevenLabs TTS API.
+     *
+     * @param text - The text to convert to audio.
+     * @param options - Optional synthesis settings. Use `providerSpecificOptions`
+     *   to control ElevenLabs-specific voice settings (stability, similarityBoost,
+     *   style, useSpeakerBoost).
+     * @returns A promise resolving to the MP3 audio buffer and metadata.
+     * @throws {Error} When the ElevenLabs API returns a non-2xx status code.
+     *   Common causes: invalid API key (401), voice not found (404),
+     *   character limit exceeded (400), or rate limit (429).
+     *
+     * @example
+     * ```ts
+     * const result = await provider.synthesize('Hello there!', {
+     *   voice: 'pNInz6obpgDQGcFmaJgB',
+     *   providerSpecificOptions: {
+     *     stability: 0.3,       // More expressive
+     *     similarityBoost: 0.9, // Closer to original voice
+     *     style: 0.5,           // Moderate style exaggeration
+     *   },
+     * });
+     * ```
+     */
     async synthesize(text, options = {}) {
+        // Voice ID resolution with 4-level fallback chain.
+        // The providerSpecificOptions.voiceId path exists for backwards compat.
         const voiceId = options.voice ??
             this.config.voiceId ??
             (typeof options.providerSpecificOptions?.voiceId === 'string'
                 ? options.providerSpecificOptions.voiceId
                 : undefined) ??
-            'EXAVITQu4vr4xnSDxMaL';
+            'EXAVITQu4vr4xnSDxMaL'; // Default "Sarah" voice
         const model = options.model ?? this.config.model ?? 'eleven_multilingual_v2';
         const response = await this.fetchImpl(`${this.config.baseUrl ?? 'https://api.elevenlabs.io/v1'}/text-to-speech/${voiceId}`, {
             method: 'POST',
             headers: {
+                // ElevenLabs uses its own header format instead of standard Authorization
                 'xi-api-key': this.config.apiKey,
                 'Content-Type': 'application/json',
+                // Request MP3 format in the response
                 Accept: 'audio/mpeg',
             },
             body: JSON.stringify({
                 text,
                 model_id: model,
                 voice_settings: {
+                    // Extract provider-specific settings with sensible defaults.
+                    // These defaults produce natural-sounding output for most voices.
                     stability: typeof options.providerSpecificOptions?.stability === 'number'
                         ? options.providerSpecificOptions.stability
                         : 0.5,
                     similarity_boost: typeof options.providerSpecificOptions?.similarityBoost === 'number'
                         ? options.providerSpecificOptions.similarityBoost
                         : 0.75,
+                    // Style is only meaningful for v2+ models; omit if not specified
                     style: typeof options.providerSpecificOptions?.style === 'number'
                         ? options.providerSpecificOptions.style
                         : undefined,
+                    // Speaker boost enhances vocal clarity and similarity
                     use_speaker_boost: typeof options.providerSpecificOptions?.useSpeakerBoost === 'boolean'
                         ? options.providerSpecificOptions.useSpeakerBoost
                         : true,
@@ -51,7 +162,7 @@ export class ElevenLabsTextToSpeechProvider {
         return {
             audioBuffer,
             mimeType: 'audio/mpeg',
-            cost: 0,
+            cost: 0, // Cost tracking is handled at a higher layer
             voiceUsed: voiceId,
             providerName: this.displayName,
             usage: {
@@ -60,6 +171,25 @@ export class ElevenLabsTextToSpeechProvider {
             },
         };
     }
+    /**
+     * Fetches the user's voice library from the ElevenLabs API.
+     *
+     * Returns available voices mapped to the normalized {@link SpeechVoice} shape.
+     * Gracefully returns an empty array on API errors (e.g. network failure,
+     * invalid key) to avoid breaking voice selection UIs.
+     *
+     * The voice library includes both ElevenLabs' pre-made voices and any
+     * custom/cloned voices in the user's account.
+     *
+     * @returns A promise resolving to an array of available voices, or an empty
+     *   array if the API call fails.
+     *
+     * @example
+     * ```ts
+     * const voices = await provider.listAvailableVoices();
+     * const rachel = voices.find(v => v.name === 'Rachel');
+     * ```
+     */
     async listAvailableVoices() {
         const response = await this.fetchImpl(`${this.config.baseUrl ?? 'https://api.elevenlabs.io/v1'}/voices`, {
             method: 'GET',
@@ -67,6 +197,9 @@ export class ElevenLabsTextToSpeechProvider {
                 'xi-api-key': this.config.apiKey,
             },
         });
+        // Graceful degradation: return empty list on API failure rather than
+        // throwing, since voice listing is typically used for UI population
+        // and should not block core functionality.
         if (!response.ok) {
             return [];
         }
@@ -74,6 +207,7 @@ export class ElevenLabsTextToSpeechProvider {
         return (payload.voices ?? [])
             .filter((voice) => typeof voice === 'object' && voice !== null)
             .map((voice) => {
+            // Extract labels object for accent/language metadata
             const labels = typeof voice.labels === 'object' && voice.labels !== null
                 ? voice.labels
                 : {};
@@ -89,6 +223,7 @@ export class ElevenLabsTextToSpeechProvider {
                 provider: this.id,
             };
         })
+            // Filter out entries with empty IDs (malformed API response entries)
             .filter((voice) => voice.id);
     }
 }

package/dist/speech/providers/ElevenLabsTextToSpeechProvider.js.map

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