@framers/agentos 0.1.110 → 0.1.112

package/dist/speech/FallbackProxy.js

@@ -2,38 +2,90 @@
 // FallbackSTTProxy
 // ---------------------------------------------------------------------------
 /**
- * A {@link SpeechToTextProvider} that wraps an ordered chain of STT providers.
- * Providers are tried left-to-right; the first successful result is returned.
- * On each failure (except the last) a `provider_fallback` event is emitted on
- * the supplied {@link EventEmitter} so callers can observe the fallback path.
+ * A {@link SpeechToTextProvider} that wraps an ordered chain of STT providers
+ * and implements automatic failover.
+ *
+ * ## Retry Chain Logic
+ *
+ * Providers are tried left-to-right (index 0 first, then 1, etc.). The first
+ * successful transcription result is returned immediately. When a provider
+ * throws:
+ *
+ * - **If it is NOT the last provider:** The error is caught, a
+ *   `provider_fallback` event is emitted on the shared {@link EventEmitter},
+ *   and the next provider is tried. Errors are caught per-provider so that a
+ *   single API outage doesn't block the entire pipeline.
+ *
+ * - **If it IS the last provider:** The error is re-thrown to the caller,
+ *   since there are no more fallbacks to try.
+ *
+ * - **If the chain is empty:** An `Error('No providers in fallback chain')`
+ *   is thrown immediately.
+ *
+ * ## Why Errors are Caught Per-Provider
+ *
+ * Each provider in the chain operates independently. A Deepgram API key
+ * expiration should not prevent OpenAI Whisper from transcribing the same
+ * audio. Catching errors per-provider ensures maximum availability at the
+ * cost of slightly increased latency when early providers fail.
+ *
+ * @see {@link ProviderFallbackEvent} for the event payload shape
+ * @see {@link SpeechProviderResolver.resolveSTT} for how this proxy is created
  *
  * @example
  * ```ts
  * const proxy = new FallbackSTTProxy([whisperProvider, deepgramProvider], emitter);
  * const result = await proxy.transcribe(audio);
+ * // If whisperProvider fails, deepgramProvider is tried automatically.
  * ```
  */
 export class FallbackSTTProxy {
     /**
-     * @param chain   Ordered list of STT providers to try. Must contain at least one entry
-     *                for `transcribe()` to succeed, though an empty chain is allowed
-     *                (it will always throw).
-     * @param emitter EventEmitter on which `provider_fallback` events are published.
+     * Creates a new FallbackSTTProxy wrapping the given provider chain.
+     *
+     * @param chain - Ordered list of STT providers to try. Must contain at least
+     *   one entry for `transcribe()` to succeed, though an empty chain is allowed
+     *   at construction time (it will always throw on transcribe).
+     * @param emitter - EventEmitter on which `provider_fallback` events are
+     *   published. Typically the {@link SpeechProviderResolver} instance.
+     *
+     * @example
+     * ```ts
+     * const proxy = new FallbackSTTProxy(
+     *   [primaryProvider, fallbackProvider],
+     *   resolver, // extends EventEmitter
+     * );
+     * ```
      */
     constructor(chain, emitter) {
         this.chain = chain;
         this.emitter = emitter;
         this.id = chain[0]?.id ?? 'fallback-stt';
-        this.displayName = `Fallback STT (${chain.map((p) => p.id).join(' → ')})`;
+        this.displayName = `Fallback STT (${chain.map((p) => p.id).join(' \u2192 ')})`;
+        // Only the primary provider's streaming capability is exposed because
+        // we cannot seamlessly switch to a fallback mid-stream.
         this.supportsStreaming = chain[0]?.supportsStreaming ?? false;
     }
     /**
-     * Attempt transcription using each provider in order.
+     * Attempt transcription using each provider in the chain in order.
      *
      * Emits a `provider_fallback` event (typed as {@link ProviderFallbackEvent})
-     * whenever a non-final provider throws.  Re-throws the last provider's error
-     * when the entire chain is exhausted, and throws `Error('No providers in
-     * fallback chain')` when `chain` is empty.
+     * whenever a non-final provider throws. Re-throws the last provider's error
+     * when the entire chain is exhausted.
+     *
+     * @param audio - The audio input to transcribe.
+     * @param options - Optional transcription settings (language, model, etc.).
+     * @returns The transcription result from the first provider that succeeds.
+     * @throws {Error} `'No providers in fallback chain'` when the chain is empty.
+     * @throws {Error} The last provider's error when all providers in the chain fail.
+     *
+     * @example
+     * ```ts
+     * const result = await proxy.transcribe(
+     *   { data: wavBuffer, mimeType: 'audio/wav' },
+     *   { language: 'en-US' },
+     * );
+     * ```
      */
     async transcribe(audio, options) {
         if (this.chain.length === 0) {
@@ -44,6 +96,8 @@ export class FallbackSTTProxy {
                 return await this.chain[i].transcribe(audio, options);
             }
             catch (error) {
+                // Only emit a fallback event when there IS a next provider to fall back to.
+                // The last provider's error is re-thrown to the caller as-is.
                 if (i < this.chain.length - 1) {
                     const event = {
                         from: this.chain[i].id,
@@ -58,10 +112,21 @@ export class FallbackSTTProxy {
                 }
             }
         }
-        // Unreachable — TypeScript requires an explicit throw after the loop.
+        // Unreachable in practice — the loop either returns a result or throws.
+        // TypeScript's control flow analysis cannot prove this, so we need an
+        // explicit throw to satisfy the return type.
         throw new Error('No providers in fallback chain');
     }
-    /** Delegates to the first provider in the chain, or returns `'fallback'` for an empty chain. */
+    /**
+     * Returns the human-readable name of the primary (first) provider in the chain.
+     *
+     * @returns The provider name string, or `'fallback'` if the chain is empty.
+     *
+     * @example
+     * ```ts
+     * proxy.getProviderName(); // 'OpenAI Whisper' (from the first chain entry)
+     * ```
+     */
     getProviderName() {
         return this.chain[0]?.getProviderName() ?? 'fallback';
     }
@@ -70,39 +135,71 @@ export class FallbackSTTProxy {
 // FallbackTTSProxy
 // ---------------------------------------------------------------------------
 /**
- * A {@link TextToSpeechProvider} that wraps an ordered chain of TTS providers.
- * Providers are tried left-to-right; the first successful result is returned.
- * On each failure (except the last) a `provider_fallback` event is emitted on
- * the supplied {@link EventEmitter}.
+ * A {@link TextToSpeechProvider} that wraps an ordered chain of TTS providers
+ * and implements automatic failover.
+ *
+ * ## Retry Chain Logic
+ *
+ * Identical to {@link FallbackSTTProxy}: providers are tried left-to-right,
+ * the first successful synthesis result is returned, and `provider_fallback`
+ * events are emitted on each intermediate failure.
+ *
+ * ## Voice Listing
  *
- * Voice listing is delegated to the first provider that exposes
- * `listAvailableVoices()`.  If none do, an empty array is returned.
+ * Voice listing is delegated to the first provider in the chain that exposes
+ * a `listAvailableVoices()` method. If no provider supports this, an empty
+ * array is returned. This is a best-effort approach — the voice list may not
+ * reflect the provider that actually handles synthesis if the primary fails.
+ *
+ * @see {@link ProviderFallbackEvent} for the event payload shape
+ * @see {@link SpeechProviderResolver.resolveTTS} for how this proxy is created
  *
  * @example
  * ```ts
  * const proxy = new FallbackTTSProxy([elevenlabsProvider, openaiTtsProvider], emitter);
  * const audio = await proxy.synthesize('Hello world');
+ * // If ElevenLabs fails, OpenAI TTS is tried automatically.
  * ```
  */
 export class FallbackTTSProxy {
     /**
-     * @param chain   Ordered list of TTS providers to try.
-     * @param emitter EventEmitter on which `provider_fallback` events are published.
+     * Creates a new FallbackTTSProxy wrapping the given provider chain.
+     *
+     * @param chain - Ordered list of TTS providers to try.
+     * @param emitter - EventEmitter on which `provider_fallback` events are published.
+     *
+     * @example
+     * ```ts
+     * const proxy = new FallbackTTSProxy(
+     *   [elevenlabsProvider, openaiTtsProvider],
+     *   resolver,
+     * );
+     * ```
      */
     constructor(chain, emitter) {
         this.chain = chain;
         this.emitter = emitter;
         this.id = chain[0]?.id ?? 'fallback-tts';
-        this.displayName = `Fallback TTS (${chain.map((p) => p.id).join(' → ')})`;
+        this.displayName = `Fallback TTS (${chain.map((p) => p.id).join(' \u2192 ')})`;
         this.supportsStreaming = chain[0]?.supportsStreaming ?? false;
     }
     /**
-     * Attempt synthesis using each provider in order.
+     * Attempt synthesis using each provider in the chain in order.
      *
      * Emits a `provider_fallback` event (typed as {@link ProviderFallbackEvent})
-     * whenever a non-final provider throws.  Re-throws the last provider's error
-     * when the entire chain is exhausted, and throws `Error('No providers in
-     * fallback chain')` when `chain` is empty.
+     * whenever a non-final provider throws. Re-throws the last provider's error
+     * when the entire chain is exhausted.
+     *
+     * @param text - The text to synthesize into speech.
+     * @param options - Optional synthesis settings (voice, speed, format, etc.).
+     * @returns The synthesis result from the first provider that succeeds.
+     * @throws {Error} `'No providers in fallback chain'` when the chain is empty.
+     * @throws {Error} The last provider's error when all providers in the chain fail.
+     *
+     * @example
+     * ```ts
+     * const result = await proxy.synthesize('Hello world', { voice: 'nova' });
+     * ```
      */
     async synthesize(text, options) {
         if (this.chain.length === 0) {
@@ -113,6 +210,8 @@ export class FallbackTTSProxy {
                 return await this.chain[i].synthesize(text, options);
             }
             catch (error) {
+                // Emit fallback event for all providers except the last one.
+                // See FallbackSTTProxy.transcribe for detailed rationale.
                 if (i < this.chain.length - 1) {
                     const event = {
                         from: this.chain[i].id,
@@ -130,14 +229,37 @@ export class FallbackTTSProxy {
         // Unreachable — TypeScript requires an explicit throw after the loop.
         throw new Error('No providers in fallback chain');
     }
-    /** Delegates to the first provider in the chain, or returns `'fallback'` for an empty chain. */
+    /**
+     * Returns the human-readable name of the primary (first) provider.
+     *
+     * @returns The provider name string, or `'fallback'` if the chain is empty.
+     *
+     * @example
+     * ```ts
+     * proxy.getProviderName(); // 'ElevenLabs' (from the first chain entry)
+     * ```
+     */
     getProviderName() {
         return this.chain[0]?.getProviderName() ?? 'fallback';
     }
     /**
-     * Returns voice list from the first provider in the chain that exposes
-     * `listAvailableVoices()`.  Falls back to an empty array when no provider
-     * supports this method.
+     * Returns the voice list from the first provider in the chain that supports
+     * `listAvailableVoices()`.
+     *
+     * Iterates through the chain looking for any provider that implements this
+     * optional method. Returns an empty array when no provider supports voice
+     * listing. This is a best-effort approach — if the primary provider fails
+     * during synthesis and a fallback provider handles it, the returned voice
+     * list may not match the provider that actually produced the audio.
+     *
+     * @returns A promise resolving to an array of available voices, or an empty
+     *   array if no provider in the chain supports voice listing.
+     *
+     * @example
+     * ```ts
+     * const voices = await proxy.listAvailableVoices();
+     * // voices from the first provider that implements the method
+     * ```
      */
     async listAvailableVoices() {
         for (const provider of this.chain) {
@@ -145,6 +267,7 @@ export class FallbackTTSProxy {
                 return provider.listAvailableVoices();
             }
         }
+        // No provider in the chain supports voice listing.
         return [];
     }
 }

package/dist/speech/FallbackProxy.js.map

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