@framers/agentos 0.1.74 → 0.1.76

package/dist/orchestration/runtime/LoopController.d.ts

@@ -54,17 +54,17 @@ export interface LoopContext {
      * Implementations should never throw — instead return a result with
      * `success: false` and a populated `error` field.
      */
-    executeTool: (toolCall: ToolCallRequest) => Promise<ToolCallResult>;
+    executeTool: (toolCall: LoopToolCallRequest) => Promise<LoopToolCallResult>;
     /**
      * Feed tool results back into the conversation so the next `generateStream`
      * call has access to them. Typically appends tool messages to the message list.
      */
-    addToolResults: (results: ToolCallResult[]) => void;
+    addToolResults: (results: LoopToolCallResult[]) => void;
 }
 /**
  * A single tool invocation requested by the LLM.
  */
-export interface ToolCallRequest {
+export interface LoopToolCallRequest {
     /** Unique identifier for this tool call within a response (matches the tool result). */
     id: string;
     /** Name of the tool to invoke. */
@@ -73,10 +73,10 @@ export interface ToolCallRequest {
     arguments: Record<string, unknown>;
 }
 /**
- * The outcome of executing a {@link ToolCallRequest}.
+ * The outcome of executing a {@link LoopToolCallRequest}.
  */
-export interface ToolCallResult {
-    /** Matches the originating {@link ToolCallRequest.id}. */
+export interface LoopToolCallResult {
+    /** Matches the originating {@link LoopToolCallRequest.id}. */
     id: string;
     /** Name of the tool that was called. */
     name: string;
@@ -100,7 +100,7 @@ export interface LoopChunk {
     /** Present when `type === 'text_delta'`. */
     content?: string;
     /** Present when `type === 'tool_call_request'`. */
-    toolCalls?: ToolCallRequest[];
+    toolCalls?: LoopToolCallRequest[];
 }
 /**
  * The final return value of `generateStream` (carried in the generator's
@@ -113,7 +113,7 @@ export interface LoopOutput {
      * All tool calls requested in this iteration. An empty array signals that
      * the LLM is done and the loop should terminate.
      */
-    toolCalls: ToolCallRequest[];
+    toolCalls: LoopToolCallRequest[];
     /**
      * The LLM finish reason (e.g. `'stop'`, `'tool_calls'`, `'length'`).
      * Informational; not used for loop-control decisions.
@@ -129,11 +129,11 @@ export type LoopEvent = {
     content: string;
 } | {
     type: 'tool_call_request';
-    toolCalls: ToolCallRequest[];
+    toolCalls: LoopToolCallRequest[];
 } | {
     type: 'tool_result';
     toolName: string;
-    result: ToolCallResult;
+    result: LoopToolCallResult;
 } | {
     type: 'tool_error';
     toolName: string;

package/dist/orchestration/runtime/LoopController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LoopController.d.ts","sourceRoot":"","sources":["../../../src/orchestration/runtime/LoopController.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iFAAiF;IACjF,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;;;OAIG;IACH,WAAW,EAAE,WAAW,GAAG,aAAa,CAAC;IAEzC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,cAAc,EAAE,MAAM,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAEvE;;;;OAIG;IACH,WAAW,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAEpE;;;OAGG;IACH,cAAc,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;CACrD;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wFAAwF;IACxF,EAAE,EAAE,MAAM,CAAC;IAEX,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IAEb,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAC;IAEX,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IAEb,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IAEjB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,IAAI,EAAE,YAAY,GAAG,mBAAmB,CAAC;IAEzC,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,mDAAmD;IACnD,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,SAAS,EAAE,eAAe,EAAE,CAAC;IAE7B;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD;;;GAGG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,SAAS,EAAE,eAAe,EAAE,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC;AAMvD;;;;;;;;;;;;;GAaG;AACH,qBAAa,cAAc;IACzB;;;;;;;OAOG;IACI,OAAO,CACZ,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,WAAW,GACnB,cAAc,CAAC,SAAS,CAAC;CAuG7B"}
+{"version":3,"file":"LoopController.d.ts","sourceRoot":"","sources":["../../../src/orchestration/runtime/LoopController.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iFAAiF;IACjF,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;;;OAIG;IACH,WAAW,EAAE,WAAW,GAAG,aAAa,CAAC;IAEzC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,cAAc,EAAE,MAAM,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAEvE;;;;OAIG;IACH,WAAW,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE5E;;;OAGG;IACH,cAAc,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,KAAK,IAAI,CAAC;CACzD;AAMD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wFAAwF;IACxF,EAAE,EAAE,MAAM,CAAC;IAEX,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IAEb,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,EAAE,EAAE,MAAM,CAAC;IAEX,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IAEb,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IAEjB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,IAAI,EAAE,YAAY,GAAG,mBAAmB,CAAC;IAEzC,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,mDAAmD;IACnD,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,SAAS,EAAE,mBAAmB,EAAE,CAAC;IAEjC;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD;;;GAGG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,SAAS,EAAE,mBAAmB,EAAE,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC;AAMvD;;;;;;;;;;;;;GAaG;AACH,qBAAa,cAAc;IACzB;;;;;;;OAOG;IACI,OAAO,CACZ,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,WAAW,GACnB,cAAc,CAAC,SAAS,CAAC;CAuG7B"}

package/dist/orchestration/runtime/LoopController.js

@@ -84,7 +84,7 @@ export class LoopController {
                 results = settled.map((s, i) => {
                     if (s.status === 'fulfilled')
                         return s.value;
-                    // Convert a rejected promise into a failed ToolCallResult so
+                    // Convert a rejected promise into a failed LoopToolCallResult so
                     // downstream handling is uniform.
                     return {
                         id: toolCalls[i].id,

package/dist/orchestration/runtime/LoopController.js.map

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

package/dist/orchestration/runtime/index.d.ts

@@ -8,7 +8,7 @@
 export { StateManager } from './StateManager.js';
 export { NodeScheduler } from './NodeScheduler.js';
 export { LoopController } from './LoopController.js';
-export type { LoopConfig, LoopContext, LoopEvent } from './LoopController.js';
+export type { LoopConfig, LoopContext, LoopEvent, LoopToolCallRequest, LoopToolCallResult, } from './LoopController.js';
 export { NodeExecutor } from './NodeExecutor.js';
 export type { NodeExecutionResult } from './NodeExecutor.js';
 export { GraphRuntime } from './GraphRuntime.js';

package/dist/orchestration/runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/orchestration/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/orchestration/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EACV,UAAU,EACV,WAAW,EACX,SAAS,EACT,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/orchestration/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/orchestration/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/orchestration/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAQrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/speech/FallbackProxy.d.ts

@@ -0,0 +1,104 @@
+import { EventEmitter } from 'events';
+import type { SpeechToTextProvider, TextToSpeechProvider, SpeechAudioInput, SpeechTranscriptionOptions, SpeechTranscriptionResult, SpeechSynthesisOptions, SpeechSynthesisResult, SpeechVoice } from './types.js';
+/**
+ * Payload emitted on the `provider_fallback` event when a provider in the chain
+ * fails and the proxy advances to the next candidate.
+ */
+export interface ProviderFallbackEvent {
+    /** ID of the provider that failed. */
+    from: string;
+    /** ID of the provider that will be tried next. */
+    to: string;
+    /** Whether this is an STT or TTS chain. */
+    kind: 'stt' | 'tts';
+    /** The error thrown by the failing provider. */
+    error: unknown;
+}
+/**
+ * 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.
+ *
+ * @example
+ * ```ts
+ * const proxy = new FallbackSTTProxy([whisperProvider, deepgramProvider], emitter);
+ * const result = await proxy.transcribe(audio);
+ * ```
+ */
+export declare class FallbackSTTProxy implements SpeechToTextProvider {
+    private readonly chain;
+    private readonly emitter;
+    /** Derived from the first provider in the chain (or `'fallback-stt'` for empty chains). */
+    readonly id: string;
+    /** Human-readable name showing the full chain: `"Fallback STT (p1 → p2)"`. */
+    readonly displayName: string;
+    /** `true` only when the first provider in the chain supports streaming. */
+    readonly supportsStreaming: boolean;
+    /**
+     * @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.
+     */
+    constructor(chain: SpeechToTextProvider[], emitter: EventEmitter);
+    /**
+     * Attempt transcription using each provider 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.
+     */
+    transcribe(audio: SpeechAudioInput, options?: SpeechTranscriptionOptions): Promise<SpeechTranscriptionResult>;
+    /** Delegates to the first provider in the chain, or returns `'fallback'` for an empty chain. */
+    getProviderName(): string;
+}
+/**
+ * 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}.
+ *
+ * Voice listing is delegated to the first provider that exposes
+ * `listAvailableVoices()`.  If none do, an empty array is returned.
+ *
+ * @example
+ * ```ts
+ * const proxy = new FallbackTTSProxy([elevenlabsProvider, openaiTtsProvider], emitter);
+ * const audio = await proxy.synthesize('Hello world');
+ * ```
+ */
+export declare class FallbackTTSProxy implements TextToSpeechProvider {
+    private readonly chain;
+    private readonly emitter;
+    /** Derived from the first provider in the chain (or `'fallback-tts'` for empty chains). */
+    readonly id: string;
+    /** Human-readable name showing the full chain: `"Fallback TTS (p1 → p2)"`. */
+    readonly displayName: string;
+    /** `true` only when the first provider in the chain supports streaming. */
+    readonly supportsStreaming: boolean;
+    /**
+     * @param chain   Ordered list of TTS providers to try.
+     * @param emitter EventEmitter on which `provider_fallback` events are published.
+     */
+    constructor(chain: TextToSpeechProvider[], emitter: EventEmitter);
+    /**
+     * Attempt synthesis using each provider 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.
+     */
+    synthesize(text: string, options?: SpeechSynthesisOptions): Promise<SpeechSynthesisResult>;
+    /** Delegates to the first provider in the chain, or returns `'fallback'` for an empty chain. */
+    getProviderName(): string;
+    /**
+     * 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.
+     */
+    listAvailableVoices(): Promise<SpeechVoice[]>;
+}
+//# sourceMappingURL=FallbackProxy.d.ts.map

package/dist/speech/FallbackProxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FallbackProxy.d.ts","sourceRoot":"","sources":["../../src/speech/FallbackProxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,0BAA0B,EAC1B,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;IACpB,gDAAgD;IAChD,KAAK,EAAE,OAAO,CAAC;CAChB;AAMD;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAiB,YAAW,oBAAoB;IAiBzD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAjB1B,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,2EAA2E;IAC3E,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IAEpC;;;;;OAKG;gBAEgB,KAAK,EAAE,oBAAoB,EAAE,EAC7B,OAAO,EAAE,YAAY;IAOxC;;;;;;;OAOG;IACG,UAAU,CACd,KAAK,EAAE,gBAAgB,EACvB,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,yBAAyB,CAAC;IA2BrC,gGAAgG;IAChG,eAAe,IAAI,MAAM;CAG1B;AAMD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gBAAiB,YAAW,oBAAoB;IAezD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAf1B,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,2EAA2E;IAC3E,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IAEpC;;;OAGG;gBAEgB,KAAK,EAAE,oBAAoB,EAAE,EAC7B,OAAO,EAAE,YAAY;IAOxC;;;;;;;OAOG;IACG,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC;IA2BjC,gGAAgG;IAChG,eAAe,IAAI,MAAM;IAIzB;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CAQpD"}

package/dist/speech/FallbackProxy.js

@@ -0,0 +1,151 @@
+// ---------------------------------------------------------------------------
+// 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.
+ *
+ * @example
+ * ```ts
+ * const proxy = new FallbackSTTProxy([whisperProvider, deepgramProvider], emitter);
+ * const result = await proxy.transcribe(audio);
+ * ```
+ */
+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.
+     */
+    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.supportsStreaming = chain[0]?.supportsStreaming ?? false;
+    }
+    /**
+     * Attempt transcription using each provider 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.
+     */
+    async transcribe(audio, options) {
+        if (this.chain.length === 0) {
+            throw new Error('No providers in fallback chain');
+        }
+        for (let i = 0; i < this.chain.length; i++) {
+            try {
+                return await this.chain[i].transcribe(audio, options);
+            }
+            catch (error) {
+                if (i < this.chain.length - 1) {
+                    const event = {
+                        from: this.chain[i].id,
+                        to: this.chain[i + 1].id,
+                        kind: 'stt',
+                        error,
+                    };
+                    this.emitter.emit('provider_fallback', event);
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        // 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. */
+    getProviderName() {
+        return this.chain[0]?.getProviderName() ?? 'fallback';
+    }
+}
+// ---------------------------------------------------------------------------
+// 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}.
+ *
+ * Voice listing is delegated to the first provider that exposes
+ * `listAvailableVoices()`.  If none do, an empty array is returned.
+ *
+ * @example
+ * ```ts
+ * const proxy = new FallbackTTSProxy([elevenlabsProvider, openaiTtsProvider], emitter);
+ * const audio = await proxy.synthesize('Hello world');
+ * ```
+ */
+export class FallbackTTSProxy {
+    /**
+     * @param chain   Ordered list of TTS providers to try.
+     * @param emitter EventEmitter on which `provider_fallback` events are published.
+     */
+    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.supportsStreaming = chain[0]?.supportsStreaming ?? false;
+    }
+    /**
+     * Attempt synthesis using each provider 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.
+     */
+    async synthesize(text, options) {
+        if (this.chain.length === 0) {
+            throw new Error('No providers in fallback chain');
+        }
+        for (let i = 0; i < this.chain.length; i++) {
+            try {
+                return await this.chain[i].synthesize(text, options);
+            }
+            catch (error) {
+                if (i < this.chain.length - 1) {
+                    const event = {
+                        from: this.chain[i].id,
+                        to: this.chain[i + 1].id,
+                        kind: 'tts',
+                        error,
+                    };
+                    this.emitter.emit('provider_fallback', event);
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        // 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. */
+    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.
+     */
+    async listAvailableVoices() {
+        for (const provider of this.chain) {
+            if (typeof provider.listAvailableVoices === 'function') {
+                return provider.listAvailableVoices();
+            }
+        }
+        return [];
+    }
+}
+//# sourceMappingURL=FallbackProxy.js.map

package/dist/speech/FallbackProxy.js.map

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

package/dist/speech/SpeechProviderResolver.d.ts

@@ -0,0 +1,103 @@
+import { EventEmitter } from 'events';
+import type { SpeechProviderKind, SpeechToTextProvider, TextToSpeechProvider, SpeechVadProvider, WakeWordProvider, SpeechResolverConfig, ProviderRequirements, ProviderRegistration } from './types.js';
+/**
+ * Central resolver for speech providers (STT, TTS, VAD, wake-word).
+ *
+ * Providers are registered with a kind, priority, and catalog metadata.
+ * Resolution filters by `isConfigured`, applies {@link ProviderRequirements},
+ * and optionally wraps multiple candidates in a {@link FallbackSTTProxy} or
+ * {@link FallbackTTSProxy} when fallback mode is enabled in the config.
+ *
+ * Emits:
+ * - `provider_registered` — when a new provider is registered via {@link register}.
+ */
+export declare class SpeechProviderResolver extends EventEmitter {
+    private readonly config?;
+    private readonly env;
+    /** All registered providers keyed by id. */
+    private registrations;
+    /**
+     * @param config Optional resolver configuration (preferred providers, fallback mode).
+     * @param env    Environment variable map used to check provider availability.
+     */
+    constructor(config?: SpeechResolverConfig | undefined, env?: Record<string, string | undefined>);
+    /**
+     * Register a provider.  Overwrites any existing registration with the same id.
+     * Emits a `provider_registered` event with `{ id, kind, source }`.
+     */
+    register(reg: ProviderRegistration): void;
+    /**
+     * List all registrations for a given kind, sorted ascending by priority
+     * (lower number = higher priority).
+     */
+    listProviders(kind: SpeechProviderKind): ProviderRegistration[];
+    /**
+     * Resolve the best STT provider matching optional {@link ProviderRequirements}.
+     *
+     * When `config.stt.fallback` is true and multiple candidates exist, wraps them
+     * in a {@link FallbackSTTProxy}.  Otherwise returns the single best match.
+     *
+     * @throws When no configured STT provider matches requirements.
+     */
+    resolveSTT(requirements?: ProviderRequirements): SpeechToTextProvider;
+    /**
+     * Resolve the best TTS provider matching optional {@link ProviderRequirements}.
+     *
+     * When `config.tts.fallback` is true and multiple candidates exist, wraps them
+     * in a {@link FallbackTTSProxy}.  Otherwise returns the single best match.
+     *
+     * @throws When no configured TTS provider matches requirements.
+     */
+    resolveTTS(requirements?: ProviderRequirements): TextToSpeechProvider;
+    /**
+     * Resolve the highest-priority configured VAD provider.
+     *
+     * @throws When no VAD provider is registered and configured.
+     */
+    resolveVAD(): SpeechVadProvider;
+    /**
+     * Resolve the highest-priority configured wake-word provider, or `null`
+     * when none is registered.
+     */
+    resolveWakeWord(): WakeWordProvider | null;
+    /**
+     * Register core providers from the static catalog and optionally discover
+     * extension providers from an ExtensionManager-like object.  Also applies
+     * user-configured preferred priorities afterwards.
+     *
+     * @param extensionManager Optional object exposing `getDescriptorsByKind(kind)`.
+     */
+    refresh(extensionManager?: any): Promise<void>;
+    /**
+     * Core resolution algorithm shared by {@link resolveSTT} and {@link resolveTTS}.
+     *
+     * When `requirements.preferredIds` is provided, returns matches in that order.
+     * Otherwise returns all configured providers matching requirements, sorted by
+     * priority (ascending).
+     */
+    private resolveByKind;
+    /**
+     * Check whether a registration satisfies the given requirements
+     * (streaming, local, features).
+     */
+    private matchesRequirements;
+    /**
+     * Register providers from the static core list.  Each provider is marked
+     * `isConfigured` based on whether the required environment variables are set.
+     * Providers with `available === false` in the catalog are skipped.
+     */
+    private registerCoreProviders;
+    /**
+     * Discover speech providers exposed by an ExtensionManager via
+     * `getDescriptorsByKind()`.  Extension providers default to priority 200
+     * (lower than core's 100) unless the user overrides via preferred config.
+     */
+    private discoverExtensionProviders;
+    /**
+     * Boost priority for providers listed in `config.stt.preferred` /
+     * `config.tts.preferred`.  Earlier entries get lower (= higher priority)
+     * numbers starting at 50.
+     */
+    private applyPreferredPriorities;
+}
+//# sourceMappingURL=SpeechProviderResolver.d.ts.map

package/dist/speech/SpeechProviderResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpeechProviderResolver.d.ts","sourceRoot":"","sources":["../../src/speech/SpeechProviderResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAEhB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAIpB;;;;;;;;;;GAUG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;IASpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG;IATtB,4CAA4C;IAC5C,OAAO,CAAC,aAAa,CAA2C;IAEhE;;;OAGG;gBAEgB,MAAM,CAAC,EAAE,oBAAoB,YAAA,EAC7B,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe;IAKxE;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,oBAAoB,GAAG,IAAI;IAKzC;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,kBAAkB,GAAG,oBAAoB,EAAE;IAM/D;;;;;;;OAOG;IACH,UAAU,CAAC,YAAY,CAAC,EAAE,oBAAoB,GAAG,oBAAoB;IAerE;;;;;;;OAOG;IACH,UAAU,CAAC,YAAY,CAAC,EAAE,oBAAoB,GAAG,oBAAoB;IAerE;;;;OAIG;IACH,UAAU,IAAI,iBAAiB;IAQ/B;;;OAGG;IACH,eAAe,IAAI,gBAAgB,GAAG,IAAI;IAS1C;;;;;;OAMG;IACG,OAAO,CAAC,gBAAgB,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAcpD;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAoBrB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAgC7B;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IAuClC;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;CAcjC"}