@framers/agentos 0.1.75 → 0.1.76

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"}

package/dist/speech/SpeechProviderResolver.js

@@ -0,0 +1,256 @@
+import { EventEmitter } from 'events';
+import { FallbackSTTProxy, FallbackTTSProxy } from './FallbackProxy.js';
+import { findSpeechProviderCatalogEntry } from './providerCatalog.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 class SpeechProviderResolver extends EventEmitter {
+    /**
+     * @param config Optional resolver configuration (preferred providers, fallback mode).
+     * @param env    Environment variable map used to check provider availability.
+     */
+    constructor(config, env = process.env) {
+        super();
+        this.config = config;
+        this.env = env;
+        /** All registered providers keyed by id. */
+        this.registrations = new Map();
+    }
+    /**
+     * Register a provider.  Overwrites any existing registration with the same id.
+     * Emits a `provider_registered` event with `{ id, kind, source }`.
+     */
+    register(reg) {
+        this.registrations.set(reg.id, reg);
+        this.emit('provider_registered', { id: reg.id, kind: reg.kind, source: reg.source });
+    }
+    /**
+     * List all registrations for a given kind, sorted ascending by priority
+     * (lower number = higher priority).
+     */
+    listProviders(kind) {
+        return [...this.registrations.values()]
+            .filter((r) => r.kind === kind)
+            .sort((a, b) => a.priority - b.priority);
+    }
+    /**
+     * 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) {
+        const candidates = this.resolveByKind('stt', requirements);
+        if (candidates.length === 0) {
+            throw new Error('No configured STT provider matches requirements');
+        }
+        if (this.config?.stt?.fallback && candidates.length > 1) {
+            return new FallbackSTTProxy(candidates.map((r) => r.provider), this);
+        }
+        return candidates[0].provider;
+    }
+    /**
+     * 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) {
+        const candidates = this.resolveByKind('tts', requirements);
+        if (candidates.length === 0) {
+            throw new Error('No configured TTS provider matches requirements');
+        }
+        if (this.config?.tts?.fallback && candidates.length > 1) {
+            return new FallbackTTSProxy(candidates.map((r) => r.provider), this);
+        }
+        return candidates[0].provider;
+    }
+    /**
+     * Resolve the highest-priority configured VAD provider.
+     *
+     * @throws When no VAD provider is registered and configured.
+     */
+    resolveVAD() {
+        const vads = this.listProviders('vad').filter((r) => r.isConfigured);
+        if (vads.length === 0) {
+            throw new Error('No VAD provider registered');
+        }
+        return vads[0].provider;
+    }
+    /**
+     * Resolve the highest-priority configured wake-word provider, or `null`
+     * when none is registered.
+     */
+    resolveWakeWord() {
+        const wakeWords = this.listProviders('wake-word').filter((r) => r.isConfigured);
+        return wakeWords.length > 0 ? wakeWords[0].provider : null;
+    }
+    // ---------------------------------------------------------------------------
+    // Bulk registration helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * 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)`.
+     */
+    async refresh(extensionManager) {
+        this.registerCoreProviders();
+        if (extensionManager) {
+            this.discoverExtensionProviders(extensionManager);
+        }
+        this.applyPreferredPriorities();
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * 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).
+     */
+    resolveByKind(kind, requirements) {
+        if (requirements?.preferredIds?.length) {
+            const results = [];
+            for (const id of requirements.preferredIds) {
+                const reg = this.registrations.get(id);
+                if (reg && reg.kind === kind && reg.isConfigured && this.matchesRequirements(reg, requirements)) {
+                    results.push(reg);
+                }
+            }
+            return results;
+        }
+        return this.listProviders(kind)
+            .filter((r) => r.isConfigured)
+            .filter((r) => this.matchesRequirements(r, requirements));
+    }
+    /**
+     * Check whether a registration satisfies the given requirements
+     * (streaming, local, features).
+     */
+    matchesRequirements(reg, req) {
+        if (!req)
+            return true;
+        if (req.streaming !== undefined && reg.catalogEntry.streaming !== req.streaming)
+            return false;
+        if (req.local !== undefined && reg.catalogEntry.local !== req.local)
+            return false;
+        if (req.features?.length) {
+            const providerFeatures = reg.catalogEntry.features ?? [];
+            if (!req.features.every((f) => providerFeatures.includes(f)))
+                return false;
+        }
+        return true;
+    }
+    /**
+     * 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.
+     */
+    registerCoreProviders() {
+        const coreProviders = [
+            { id: 'openai-whisper', kind: 'stt', envVars: ['OPENAI_API_KEY'] },
+            { id: 'deepgram-batch', kind: 'stt', envVars: ['DEEPGRAM_API_KEY'] },
+            { id: 'assemblyai', kind: 'stt', envVars: ['ASSEMBLYAI_API_KEY'] },
+            { id: 'azure-speech-stt', kind: 'stt', envVars: ['AZURE_SPEECH_KEY', 'AZURE_SPEECH_REGION'] },
+            { id: 'openai-tts', kind: 'tts', envVars: ['OPENAI_API_KEY'] },
+            { id: 'elevenlabs', kind: 'tts', envVars: ['ELEVENLABS_API_KEY'] },
+            { id: 'azure-speech-tts', kind: 'tts', envVars: ['AZURE_SPEECH_KEY', 'AZURE_SPEECH_REGION'] },
+            { id: 'agentos-adaptive-vad', kind: 'vad', envVars: [] },
+        ];
+        for (const def of coreProviders) {
+            const catalogEntry = findSpeechProviderCatalogEntry(def.id);
+            if (!catalogEntry)
+                continue;
+            if (catalogEntry.available === false)
+                continue;
+            const isConfigured = def.envVars.length === 0 || def.envVars.every((v) => Boolean(this.env[v]));
+            this.register({
+                id: def.id,
+                kind: def.kind,
+                provider: null, // Lazy — actual provider instance created on first use.
+                catalogEntry,
+                isConfigured,
+                priority: 100,
+                source: 'core',
+            });
+        }
+    }
+    /**
+     * 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.
+     */
+    discoverExtensionProviders(extensionManager) {
+        /** Maps extension descriptor kinds to {@link SpeechProviderKind}. */
+        const kindMap = {
+            'stt-provider': 'stt',
+            'tts-provider': 'tts',
+            'vad-provider': 'vad',
+            'wake-word-provider': 'wake-word',
+        };
+        for (const descriptorKind of Object.keys(kindMap)) {
+            const descriptors = extensionManager.getDescriptorsByKind?.(descriptorKind) ?? [];
+            for (const desc of descriptors) {
+                const catalogEntry = findSpeechProviderCatalogEntry(desc.id);
+                const isConfigured = catalogEntry
+                    ? catalogEntry.envVars.length === 0 ||
+                        catalogEntry.envVars.every((v) => Boolean(this.env[v]))
+                    : true;
+                this.register({
+                    id: desc.id,
+                    kind: kindMap[descriptorKind] ?? 'stt',
+                    provider: desc.payload,
+                    catalogEntry: catalogEntry ?? {
+                        id: desc.id,
+                        kind: kindMap[descriptorKind] ?? 'stt',
+                        label: desc.id,
+                        envVars: [],
+                        local: false,
+                        description: '',
+                    },
+                    isConfigured,
+                    priority: 200,
+                    source: 'extension',
+                });
+            }
+        }
+    }
+    /**
+     * Boost priority for providers listed in `config.stt.preferred` /
+     * `config.tts.preferred`.  Earlier entries get lower (= higher priority)
+     * numbers starting at 50.
+     */
+    applyPreferredPriorities() {
+        if (this.config?.stt?.preferred) {
+            for (let i = 0; i < this.config.stt.preferred.length; i++) {
+                const reg = this.registrations.get(this.config.stt.preferred[i]);
+                if (reg)
+                    reg.priority = 50 + i;
+            }
+        }
+        if (this.config?.tts?.preferred) {
+            for (let i = 0; i < this.config.tts.preferred.length; i++) {
+                const reg = this.registrations.get(this.config.tts.preferred[i]);
+                if (reg)
+                    reg.priority = 50 + i;
+            }
+        }
+    }
+}
+//# sourceMappingURL=SpeechProviderResolver.js.map

package/dist/speech/SpeechProviderResolver.js.map

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