@framers/agentos 0.1.226 → 0.1.228

package/dist/voice-pipeline/providers/StreamingSTTChain.js

@@ -0,0 +1,225 @@
+/**
+ * @module voice-pipeline/providers/StreamingSTTChain
+ *
+ * Priority-ordered fallback wrapper around multiple `IStreamingSTT`
+ * providers. On `startSession()` the chain tries providers in priority
+ * order; the first one whose `startSession()` resolves wins.
+ * Init-failure classification records to the circuit breaker so future
+ * sessions skip recently-tripped providers without the retry-latency
+ * penalty.
+ *
+ * This file implements Layer 2 of the resilience plan (init-time
+ * fallback). Layer 3 (mid-utterance failover via ring buffer) is added
+ * in a later task and plugs into the `wrapSession` seam exposed here.
+ */
+import { EventEmitter } from 'node:events';
+import { VoicePipelineError, AggregateVoiceError, } from '../VoicePipelineError.js';
+import { AudioRingBuffer } from '../AudioRingBuffer.js';
+import { TranscriptDedupe } from '../TranscriptDedupe.js';
+export class StreamingSTTChain {
+    constructor(providers, opts = {}) {
+        this.providerId = 'chain';
+        this.isStreaming = false;
+        if (providers.length === 0) {
+            throw new Error('StreamingSTTChain requires at least one provider');
+        }
+        this._providers = [...providers].sort((a, b) => a.priority - b.priority);
+        this.opts = opts;
+    }
+    /** Providers in priority order (primary first). Exposed for
+     *  introspection by host apps and tests. */
+    get providers() {
+        return this._providers;
+    }
+    get currentProviderId() {
+        return this.activeProviderId;
+    }
+    async startSession(config) {
+        const candidates = this.filterCandidates();
+        if (candidates.length === 0) {
+            this.emitMetric({
+                type: 'provider_unavailable',
+                kind: 'stt',
+                checkedProviders: this._providers.map((p) => p.providerId),
+            });
+            throw new Error('No STT providers available (all tripped or filtered)');
+        }
+        const attempts = [];
+        for (let i = 0; i < candidates.length; i++) {
+            const provider = candidates[i];
+            try {
+                const session = await provider.startSession(config);
+                this.activeProviderId = provider.providerId;
+                const evt = {
+                    kind: 'stt',
+                    providerId: provider.providerId,
+                    attempt: i + 1,
+                };
+                this.opts.onProviderSelected?.(evt);
+                this.emitMetric({ type: 'provider_selected', ...evt });
+                this.opts.breaker?.recordSuccess(provider.providerId);
+                return this.wrapSession(session, provider, candidates.slice(i + 1), config);
+            }
+            catch (err) {
+                const classified = VoicePipelineError.classifyError(err, {
+                    kind: 'stt',
+                    provider: provider.providerId,
+                });
+                attempts.push(classified);
+                const failEvt = {
+                    kind: 'stt',
+                    providerId: provider.providerId,
+                    errorClass: classified.errorClass,
+                    message: classified.message,
+                };
+                this.opts.onProviderFailed?.(failEvt);
+                this.emitMetric({ type: 'provider_failed', ...failEvt });
+                this.opts.breaker?.recordFailure(provider.providerId, classified.errorClass);
+            }
+        }
+        this.emitMetric({
+            type: 'provider_unavailable',
+            kind: 'stt',
+            checkedProviders: candidates.map((p) => p.providerId),
+        });
+        throw new AggregateVoiceError(attempts);
+    }
+    filterCandidates() {
+        if (!this.opts.breaker)
+            return this._providers;
+        return this._providers.filter((p) => this.opts.breaker.isAvailable(p.providerId));
+    }
+    /**
+     * Wraps the session returned by a healthy provider. In init-time-only
+     * mode (enableMidUtteranceFailover=false) this is a pass-through. In
+     * failover mode the session is replaced with a facade that tees audio
+     * into a ring buffer, dedupes transcripts across providers, and on
+     * session error re-routes to the next candidate.
+     */
+    wrapSession(initial, initialProvider, candidates, config) {
+        if (!this.opts.enableMidUtteranceFailover)
+            return initial;
+        const ring = new AudioRingBuffer({
+            capacityMs: this.opts.ringBufferCapacityMs ?? 3000,
+            sampleRate: 16000,
+        });
+        const dedupe = new TranscriptDedupe();
+        const minReplayMs = this.opts.minReplayMs ?? 400;
+        const facade = new EventEmitter();
+        let currentSession = initial;
+        let currentProvider = initialProvider;
+        let remaining = [...candidates];
+        let isFailingOver = false;
+        const attach = (session, providerId) => {
+            session.on('transcript', (evt) => {
+                const r = dedupe.evaluate({
+                    provider: providerId,
+                    text: evt.text,
+                    audioStartMs: evt.audioStartMs ?? 0,
+                    audioEndMs: evt.audioEndMs ?? 0,
+                    isFinal: evt.isFinal,
+                });
+                if (r.isDuplicate)
+                    return;
+                facade.emit('transcript', evt);
+            });
+            for (const passthrough of ['vad', 'speech_start', 'speech_end']) {
+                session.on(passthrough, (...args) => {
+                    facade.emit(passthrough, ...args);
+                });
+            }
+            session.on('error', (err) => {
+                void tryFailover(err);
+            });
+            session.on('close', () => {
+                // Natural close on the active session is a failover trigger so the
+                // user doesn't silently lose voice mid-turn. If the chain was asked
+                // to close() externally, isFailingOver stays false and the close
+                // propagates.
+                if (!isFailingOver && currentSession === session) {
+                    void tryFailover(undefined);
+                }
+            });
+        };
+        const tryFailover = async (err) => {
+            if (isFailingOver)
+                return;
+            isFailingOver = true;
+            const startedAt = Date.now();
+            const classified = VoicePipelineError.classifyError(err ?? new Error('session ended'), { kind: 'stt', provider: currentProvider.providerId });
+            this.opts.breaker?.recordFailure(currentProvider.providerId, classified.errorClass);
+            const bufferedFrames = ring.snapshot();
+            const bufferedMs = ring.durationMs();
+            for (const backup of remaining) {
+                if (this.opts.breaker &&
+                    !this.opts.breaker.isAvailable(backup.providerId)) {
+                    continue;
+                }
+                try {
+                    const session = await backup.startSession(config);
+                    attach(session, backup.providerId);
+                    if (bufferedMs >= minReplayMs) {
+                        for (const f of bufferedFrames) {
+                            try {
+                                await session.pushAudio(f);
+                            }
+                            catch {
+                                /* tolerate frame-level push failures during replay */
+                            }
+                        }
+                    }
+                    currentSession = session;
+                    currentProvider = backup;
+                    remaining = remaining.filter((c) => c !== backup);
+                    this.activeProviderId = backup.providerId;
+                    const lostMs = Date.now() - startedAt;
+                    const evt = {
+                        kind: 'stt',
+                        from: initialProvider.providerId,
+                        to: backup.providerId,
+                        reason: classified.errorClass,
+                        lostMs,
+                    };
+                    this.opts.onProviderFailover?.(evt);
+                    this.emitMetric({ type: 'provider_failover', ...evt });
+                    isFailingOver = false;
+                    return;
+                }
+                catch (backupErr) {
+                    const backClass = VoicePipelineError.classifyError(backupErr, {
+                        kind: 'stt',
+                        provider: backup.providerId,
+                    });
+                    this.opts.breaker?.recordFailure(backup.providerId, backClass.errorClass);
+                }
+            }
+            // All backups exhausted — propagate to the facade consumer.
+            facade.emit('error', new AggregateVoiceError([classified]));
+            isFailingOver = false;
+        };
+        attach(initial, initialProvider.providerId);
+        // The returned object must conform to StreamingSTTSession (EventEmitter
+        // with pushAudio + close). We build that explicitly so TS sees the
+        // right shape.
+        const wrapped = Object.assign(facade, {
+            providerId: 'chain',
+            pushAudio: async (frame) => {
+                ring.push(frame);
+                try {
+                    await currentSession.pushAudio(frame);
+                }
+                catch (pushErr) {
+                    void tryFailover(pushErr);
+                }
+            },
+            close: async () => {
+                await currentSession.close();
+            },
+        });
+        return wrapped;
+    }
+    emitMetric(event) {
+        this.opts.metrics?.emit(event);
+    }
+}
+//# sourceMappingURL=StreamingSTTChain.js.map

package/dist/voice-pipeline/providers/StreamingSTTChain.js.map

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

package/dist/voice-pipeline/providers/StreamingTTSChain.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @module voice-pipeline/providers/StreamingTTSChain
+ *
+ * Priority-ordered fallback wrapper around multiple `IStreamingTTS`
+ * providers. Mirrors `StreamingSTTChain` semantics for outbound synthesis.
+ *
+ * Mid-synthesis failover is simpler than mid-utterance STT failover
+ * because TTS is one-way (text in, audio out). The chain accumulates
+ * tokens pushed to the primary and, on primary failure, re-sends them
+ * to the backup. Clients may use the first backup audio chunk's
+ * `fadeInMs` hint to crossfade between timbres.
+ */
+import type { IStreamingTTS, StreamingTTSSession, StreamingTTSConfig } from '../types.js';
+import type { HealthyProvider } from '../HealthyProvider.js';
+import { type HealthErrorClass } from '../VoicePipelineError.js';
+import type { CircuitBreaker } from '../CircuitBreaker.js';
+import type { VoiceMetricsReporter } from '../VoiceMetricsReporter.js';
+export interface TTSProviderSelectedEvent {
+    kind: 'tts';
+    providerId: string;
+    attempt: number;
+}
+export interface TTSProviderFailedEvent {
+    kind: 'tts';
+    providerId: string;
+    errorClass: HealthErrorClass;
+    message: string;
+}
+export interface TTSProviderFailoverEvent {
+    kind: 'tts';
+    from: string;
+    to: string;
+    reason: HealthErrorClass;
+    lostMs: number;
+}
+export interface StreamingTTSChainOptions {
+    breaker?: CircuitBreaker;
+    metrics?: VoiceMetricsReporter;
+    onProviderSelected?: (event: TTSProviderSelectedEvent) => void;
+    onProviderFailed?: (event: TTSProviderFailedEvent) => void;
+    onProviderFailover?: (event: TTSProviderFailoverEvent) => void;
+    /** When true, the chain tracks accumulated tokens and re-submits them
+     *  to the next backup if the primary errors mid-synthesis. */
+    enableMidSynthesisFailover?: boolean;
+}
+type TTSProvider = IStreamingTTS & HealthyProvider;
+export declare class StreamingTTSChain implements IStreamingTTS {
+    readonly providerId = "chain";
+    private readonly _providers;
+    private readonly opts;
+    private activeProviderId?;
+    constructor(providers: TTSProvider[], opts?: StreamingTTSChainOptions);
+    get providers(): readonly TTSProvider[];
+    get currentProviderId(): string | undefined;
+    startSession(config?: StreamingTTSConfig): Promise<StreamingTTSSession>;
+    private filterCandidates;
+    /**
+     * Wraps a session for mid-synthesis failover. The facade tees pushTokens
+     * calls into an accumulator and, when the primary emits 'error',
+     * opens a new session on the next backup and replays the accumulator
+     * before returning control.
+     */
+    private wrapSession;
+    private emitMetric;
+}
+export {};
+//# sourceMappingURL=StreamingTTSChain.d.ts.map

package/dist/voice-pipeline/providers/StreamingTTSChain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamingTTSChain.d.ts","sourceRoot":"","sources":["../../../src/voice-pipeline/providers/StreamingTTSChain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAEnB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EACV,oBAAoB,EAErB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,KAAK,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,KAAK,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,CAAC;IAC/D,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAC3D,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,CAAC;IAC/D;kEAC8D;IAC9D,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC;AAED,KAAK,WAAW,GAAG,aAAa,GAAG,eAAe,CAAC;AAEnD,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,UAAU,WAAW;IAE9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAC3C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;IAChD,OAAO,CAAC,gBAAgB,CAAC,CAAS;gBAEtB,SAAS,EAAE,WAAW,EAAE,EAAE,IAAI,GAAE,wBAA6B;IAQzE,IAAI,SAAS,IAAI,SAAS,WAAW,EAAE,CAEtC;IAED,IAAI,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAE1C;IAEK,YAAY,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA6D7E,OAAO,CAAC,gBAAgB;IAOxB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAsInB,OAAO,CAAC,UAAU;CAGnB"}

package/dist/voice-pipeline/providers/StreamingTTSChain.js

@@ -0,0 +1,212 @@
+/**
+ * @module voice-pipeline/providers/StreamingTTSChain
+ *
+ * Priority-ordered fallback wrapper around multiple `IStreamingTTS`
+ * providers. Mirrors `StreamingSTTChain` semantics for outbound synthesis.
+ *
+ * Mid-synthesis failover is simpler than mid-utterance STT failover
+ * because TTS is one-way (text in, audio out). The chain accumulates
+ * tokens pushed to the primary and, on primary failure, re-sends them
+ * to the backup. Clients may use the first backup audio chunk's
+ * `fadeInMs` hint to crossfade between timbres.
+ */
+import { EventEmitter } from 'node:events';
+import { VoicePipelineError, AggregateVoiceError, } from '../VoicePipelineError.js';
+export class StreamingTTSChain {
+    constructor(providers, opts = {}) {
+        this.providerId = 'chain';
+        if (providers.length === 0) {
+            throw new Error('StreamingTTSChain requires at least one provider');
+        }
+        this._providers = [...providers].sort((a, b) => a.priority - b.priority);
+        this.opts = opts;
+    }
+    get providers() {
+        return this._providers;
+    }
+    get currentProviderId() {
+        return this.activeProviderId;
+    }
+    async startSession(config) {
+        const candidates = this.filterCandidates();
+        if (candidates.length === 0) {
+            this.emitMetric({
+                type: 'provider_unavailable',
+                kind: 'tts',
+                checkedProviders: this._providers.map((p) => p.providerId),
+            });
+            throw new Error('No TTS providers available (all tripped or filtered)');
+        }
+        const attempts = [];
+        for (let i = 0; i < candidates.length; i++) {
+            const provider = candidates[i];
+            try {
+                const session = await provider.startSession(config);
+                this.activeProviderId = provider.providerId;
+                const evt = {
+                    kind: 'tts',
+                    providerId: provider.providerId,
+                    attempt: i + 1,
+                };
+                this.opts.onProviderSelected?.(evt);
+                this.emitMetric({ type: 'provider_selected', ...evt });
+                this.opts.breaker?.recordSuccess(provider.providerId);
+                return this.wrapSession(session, provider, candidates.slice(i + 1), config);
+            }
+            catch (err) {
+                const classified = VoicePipelineError.classifyError(err, {
+                    kind: 'tts',
+                    provider: provider.providerId,
+                });
+                attempts.push(classified);
+                const failEvt = {
+                    kind: 'tts',
+                    providerId: provider.providerId,
+                    errorClass: classified.errorClass,
+                    message: classified.message,
+                };
+                this.opts.onProviderFailed?.(failEvt);
+                this.emitMetric({ type: 'provider_failed', ...failEvt });
+                this.opts.breaker?.recordFailure(provider.providerId, classified.errorClass);
+            }
+        }
+        this.emitMetric({
+            type: 'provider_unavailable',
+            kind: 'tts',
+            checkedProviders: candidates.map((p) => p.providerId),
+        });
+        throw new AggregateVoiceError(attempts);
+    }
+    filterCandidates() {
+        if (!this.opts.breaker)
+            return this._providers;
+        return this._providers.filter((p) => this.opts.breaker.isAvailable(p.providerId));
+    }
+    /**
+     * Wraps a session for mid-synthesis failover. The facade tees pushTokens
+     * calls into an accumulator and, when the primary emits 'error',
+     * opens a new session on the next backup and replays the accumulator
+     * before returning control.
+     */
+    wrapSession(initial, initialProvider, candidates, config) {
+        if (!this.opts.enableMidSynthesisFailover)
+            return initial;
+        const facade = new EventEmitter();
+        const tokensSinceFlush = [];
+        let currentSession = initial;
+        let currentProvider = initialProvider;
+        let remaining = [...candidates];
+        let isFailingOver = false;
+        const attach = (session, _providerId) => {
+            session.on('audio', (chunk) => {
+                facade.emit('audio', chunk);
+            });
+            session.on('flush_complete', () => {
+                tokensSinceFlush.length = 0;
+                facade.emit('flush_complete');
+            });
+            session.on('error', (err) => {
+                void tryFailover(err);
+            });
+            session.on('close', () => {
+                if (!isFailingOver && currentSession === session) {
+                    void tryFailover(undefined);
+                }
+            });
+        };
+        const tryFailover = async (err) => {
+            if (isFailingOver)
+                return;
+            isFailingOver = true;
+            const startedAt = Date.now();
+            const classified = VoicePipelineError.classifyError(err ?? new Error('session ended'), { kind: 'tts', provider: currentProvider.providerId });
+            this.opts.breaker?.recordFailure(currentProvider.providerId, classified.errorClass);
+            for (const backup of remaining) {
+                if (this.opts.breaker &&
+                    !this.opts.breaker.isAvailable(backup.providerId)) {
+                    continue;
+                }
+                try {
+                    const session = await backup.startSession(config);
+                    attach(session, backup.providerId);
+                    // Replay everything accumulated since the last successful flush.
+                    for (const t of tokensSinceFlush) {
+                        try {
+                            session.pushTokens(t);
+                        }
+                        catch {
+                            /* tolerate per-token failures during replay */
+                        }
+                    }
+                    currentSession = session;
+                    currentProvider = backup;
+                    remaining = remaining.filter((c) => c !== backup);
+                    this.activeProviderId = backup.providerId;
+                    const evt = {
+                        kind: 'tts',
+                        from: initialProvider.providerId,
+                        to: backup.providerId,
+                        reason: classified.errorClass,
+                        lostMs: Date.now() - startedAt,
+                    };
+                    this.opts.onProviderFailover?.(evt);
+                    this.emitMetric({ type: 'provider_failover', ...evt });
+                    isFailingOver = false;
+                    return;
+                }
+                catch (backupErr) {
+                    const backClass = VoicePipelineError.classifyError(backupErr, {
+                        kind: 'tts',
+                        provider: backup.providerId,
+                    });
+                    this.opts.breaker?.recordFailure(backup.providerId, backClass.errorClass);
+                }
+            }
+            facade.emit('error', new AggregateVoiceError([classified]));
+            isFailingOver = false;
+        };
+        attach(initial, initialProvider.providerId);
+        const wrapped = Object.assign(facade, {
+            providerId: 'chain',
+            pushTokens: (tokens) => {
+                tokensSinceFlush.push(tokens);
+                try {
+                    currentSession.pushTokens(tokens);
+                }
+                catch (err) {
+                    void tryFailover(err);
+                }
+            },
+            flush: async () => {
+                try {
+                    await currentSession.flush();
+                }
+                catch (err) {
+                    void tryFailover(err);
+                }
+            },
+            cancel: () => {
+                tokensSinceFlush.length = 0;
+                try {
+                    currentSession.cancel();
+                }
+                catch {
+                    /* best-effort */
+                }
+            },
+            close: () => {
+                try {
+                    currentSession.close();
+                }
+                catch {
+                    /* best-effort */
+                }
+            },
+        });
+        return wrapped;
+    }
+    emitMetric(event) {
+        this.opts.metrics?.emit(event);
+    }
+}
+//# sourceMappingURL=StreamingTTSChain.js.map

package/dist/voice-pipeline/providers/StreamingTTSChain.js.map

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

package/dist/voice-pipeline/providers/index.d.ts

@@ -17,4 +17,6 @@ export { OpenAIBatchTTS, type OpenAIBatchTTSConfig } from './OpenAIBatchTTS.js';
 export { ElevenLabsBatchTTS, type ElevenLabsBatchTTSConfig } from './ElevenLabsBatchTTS.js';
 export { BatchTTSFallback } from './BatchTTSFallback.js';
 export { OpenAIRealtimeTTS, type OpenAIRealtimeTTSConfig } from './OpenAIRealtimeTTS.js';
+export { StreamingSTTChain, type StreamingSTTChainOptions, type ProviderSelectedEvent, type ProviderFailedEvent, type ProviderFailoverEvent, } from './StreamingSTTChain.js';
+export { StreamingTTSChain, type StreamingTTSChainOptions, type TTSProviderSelectedEvent, type TTSProviderFailedEvent, type TTSProviderFailoverEvent, } from './StreamingTTSChain.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/voice-pipeline/providers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/voice-pipeline/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,oBAAoB,EAAE,KAAK,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAClG,OAAO,EACL,sBAAsB,EACtB,KAAK,4BAA4B,GAClC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,sBAAsB,EACtB,KAAK,4BAA4B,GAClC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,KAAK,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/voice-pipeline/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,oBAAoB,EAAE,KAAK,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAClG,OAAO,EACL,sBAAsB,EACtB,KAAK,4BAA4B,GAClC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,sBAAsB,EACtB,KAAK,4BAA4B,GAClC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,KAAK,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,GAC9B,MAAM,wBAAwB,CAAC"}

package/dist/voice-pipeline/providers/index.js

@@ -17,4 +17,6 @@ export { OpenAIBatchTTS } from './OpenAIBatchTTS.js';
 export { ElevenLabsBatchTTS } from './ElevenLabsBatchTTS.js';
 export { BatchTTSFallback } from './BatchTTSFallback.js';
 export { OpenAIRealtimeTTS } from './OpenAIRealtimeTTS.js';
+export { StreamingSTTChain, } from './StreamingSTTChain.js';
+export { StreamingTTSChain, } from './StreamingTTSChain.js';
 //# sourceMappingURL=index.js.map

package/dist/voice-pipeline/providers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/voice-pipeline/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,oBAAoB,EAAmC,MAAM,2BAA2B,CAAC;AAClG,OAAO,EACL,sBAAsB,GAEvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,sBAAsB,GAEvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,cAAc,EAA6B,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAiC,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAgC,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/voice-pipeline/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,oBAAoB,EAAmC,MAAM,2BAA2B,CAAC;AAClG,OAAO,EACL,sBAAsB,GAEvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,sBAAsB,GAEvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,cAAc,EAA6B,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAiC,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAgC,MAAM,wBAAwB,CAAC;AACzF,OAAO,EACL,iBAAiB,GAKlB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,GAKlB,MAAM,wBAAwB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos",
-  "version": "0.1.226",
+  "version": "0.1.228",
   "description": "Modular AgentOS orchestration library",
   "type": "module",
   "main": "dist/index.js",