@framers/agentos 0.1.227 → 0.1.229

package/dist/voice-pipeline/TranscriptDedupe.js

@@ -0,0 +1,96 @@
+/**
+ * @module voice-pipeline/TranscriptDedupe
+ *
+ * Duplicate-transcript detector used by StreamingSTTChain after a mid-
+ * utterance failover. The backup provider replays the ring buffer and
+ * re-transcribes audio the primary already saw; without dedupe the session
+ * sees "hello world" twice.
+ *
+ * Dedupe signal: audio-clock overlap (primary fact) + fuzzy string match
+ * (tie-breaker). Two transcripts overlap if their [audioStartMs, audioEndMs]
+ * ranges intersect; when they do, we compare normalized text.
+ *
+ * Same-provider observations are never considered duplicates — interim
+ * transcripts from a single streaming provider are part of its protocol.
+ */
+const PUNCT_RE = /[.,!?;:"'()\[\]{}]/g;
+const WS_RE = /\s+/g;
+function normalize(text) {
+    return text.toLowerCase().replace(PUNCT_RE, '').replace(WS_RE, ' ').trim();
+}
+function tokenSet(text) {
+    return new Set(normalize(text).split(' ').filter(Boolean));
+}
+function tokenSetSimilarity(a, b) {
+    const ta = tokenSet(a);
+    const tb = tokenSet(b);
+    if (ta.size === 0 && tb.size === 0)
+        return 1;
+    if (ta.size === 0 || tb.size === 0)
+        return 0;
+    let intersect = 0;
+    for (const t of ta)
+        if (tb.has(t))
+            intersect++;
+    return intersect / Math.max(ta.size, tb.size);
+}
+function rangesOverlap(a, b) {
+    return a.audioStartMs < b.audioEndMs && b.audioStartMs < a.audioEndMs;
+}
+export class TranscriptDedupe {
+    constructor(opts = {}) {
+        this.recent = [];
+        this.fuzzyThreshold = opts.fuzzyThreshold ?? 0.85;
+        this.retainMs = opts.retainMs ?? 10000;
+    }
+    evaluate(obs) {
+        this.prune(obs.audioEndMs);
+        for (const prev of this.recent) {
+            if (prev.provider === obs.provider)
+                continue;
+            if (!rangesOverlap(prev, obs))
+                continue;
+            const na = normalize(prev.text);
+            const nb = normalize(obs.text);
+            if (na === nb) {
+                this.recent.push(obs);
+                return {
+                    isDuplicate: true,
+                    reason: 'exact',
+                    against: { provider: prev.provider, text: prev.text },
+                };
+            }
+            // Longer transcript subsumes shorter one (primary saw more audio by
+            // the time backup caught up — suppress the backup's shorter view).
+            if (na.includes(nb) || nb.includes(na)) {
+                if (na.length >= nb.length) {
+                    this.recent.push(obs);
+                    return {
+                        isDuplicate: true,
+                        reason: 'superset',
+                        against: { provider: prev.provider, text: prev.text },
+                    };
+                }
+            }
+            const sim = tokenSetSimilarity(prev.text, obs.text);
+            if (sim >= this.fuzzyThreshold) {
+                this.recent.push(obs);
+                return {
+                    isDuplicate: true,
+                    reason: 'fuzzy',
+                    against: { provider: prev.provider, text: prev.text },
+                };
+            }
+        }
+        this.recent.push(obs);
+        return { isDuplicate: false };
+    }
+    reset() {
+        this.recent = [];
+    }
+    prune(upToMs) {
+        const cutoff = upToMs - this.retainMs;
+        this.recent = this.recent.filter((o) => o.audioEndMs >= cutoff);
+    }
+}
+//# sourceMappingURL=TranscriptDedupe.js.map

package/dist/voice-pipeline/TranscriptDedupe.js.map

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

package/dist/voice-pipeline/VoiceMetricsReporter.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @module voice-pipeline/VoiceMetricsReporter
+ *
+ * Typed pub/sub bus for voice-pipeline lifecycle events. Chains and
+ * circuit breakers emit structured events here; host applications
+ * subscribe to forward them to clients (WebSocket frames), metrics
+ * systems (Prometheus, Datadog), or logs.
+ *
+ * Listener errors are swallowed — one bad subscriber must not poison the
+ * fan-out path for others.
+ */
+import type { HealthErrorClass } from './VoicePipelineError.js';
+export type VoiceMetricEvent = {
+    type: 'provider_selected';
+    kind: 'stt' | 'tts';
+    providerId: string;
+    attempt: number;
+} | {
+    type: 'provider_failed';
+    kind: 'stt' | 'tts';
+    providerId: string;
+    errorClass: HealthErrorClass;
+    message: string;
+} | {
+    type: 'provider_failover';
+    kind: 'stt' | 'tts';
+    from: string;
+    to: string;
+    reason: HealthErrorClass;
+    lostMs: number;
+} | {
+    type: 'provider_degraded';
+    kind: 'stt' | 'tts';
+    providerId: string;
+    latencyMs: number;
+    thresholdMs: number;
+} | {
+    type: 'provider_unavailable';
+    kind: 'stt' | 'tts';
+    checkedProviders: string[];
+};
+export type VoiceMetricListener = (event: VoiceMetricEvent) => void;
+export declare class VoiceMetricsReporter {
+    private readonly listeners;
+    subscribe(fn: VoiceMetricListener): () => void;
+    emit(event: VoiceMetricEvent): void;
+}
+//# sourceMappingURL=VoiceMetricsReporter.d.ts.map

package/dist/voice-pipeline/VoiceMetricsReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoiceMetricsReporter.d.ts","sourceRoot":"","sources":["../../src/voice-pipeline/VoiceMetricsReporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,MAAM,gBAAgB,GACxB;IACE,IAAI,EAAE,mBAAmB,CAAC;IAC1B,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,IAAI,EAAE,mBAAmB,CAAC;IAC1B,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,mBAAmB,CAAC;IAC1B,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,sBAAsB,CAAC;IAC7B,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC;AAEN,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAEpE,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAE5D,SAAS,CAAC,EAAE,EAAE,mBAAmB,GAAG,MAAM,IAAI;IAO9C,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;CASpC"}

package/dist/voice-pipeline/VoiceMetricsReporter.js

@@ -0,0 +1,33 @@
+/**
+ * @module voice-pipeline/VoiceMetricsReporter
+ *
+ * Typed pub/sub bus for voice-pipeline lifecycle events. Chains and
+ * circuit breakers emit structured events here; host applications
+ * subscribe to forward them to clients (WebSocket frames), metrics
+ * systems (Prometheus, Datadog), or logs.
+ *
+ * Listener errors are swallowed — one bad subscriber must not poison the
+ * fan-out path for others.
+ */
+export class VoiceMetricsReporter {
+    constructor() {
+        this.listeners = new Set();
+    }
+    subscribe(fn) {
+        this.listeners.add(fn);
+        return () => {
+            this.listeners.delete(fn);
+        };
+    }
+    emit(event) {
+        for (const fn of this.listeners) {
+            try {
+                fn(event);
+            }
+            catch {
+                /* swallow — one bad listener must not poison the rest */
+            }
+        }
+    }
+}
+//# sourceMappingURL=VoiceMetricsReporter.js.map

package/dist/voice-pipeline/VoiceMetricsReporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoiceMetricsReporter.js","sourceRoot":"","sources":["../../src/voice-pipeline/VoiceMetricsReporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAyCH,MAAM,OAAO,oBAAoB;IAAjC;QACmB,cAAS,GAAG,IAAI,GAAG,EAAuB,CAAC;IAkB9D,CAAC;IAhBC,SAAS,CAAC,EAAuB;QAC/B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvB,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC5B,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAuB;QAC1B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,EAAE,CAAC,KAAK,CAAC,CAAC;YACZ,CAAC;YAAC,MAAM,CAAC;gBACP,yDAAyD;YAC3D,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/voice-pipeline/VoicePipelineError.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @module voice-pipeline/VoicePipelineError
+ *
+ * Structured error class for voice pipeline failures. Carries enough shape
+ * for chains and circuit breakers to classify and react without stringly
+ * matching error.message.
+ */
+export type HealthErrorClass = 'auth' | 'quota' | 'network' | 'service' | 'unknown';
+export interface VoicePipelineErrorInit {
+    kind: 'stt' | 'tts' | 'transport';
+    provider: string;
+    errorClass: HealthErrorClass;
+    message: string;
+    cause?: unknown;
+    retryable: boolean;
+}
+export declare class VoicePipelineError extends Error {
+    readonly kind: VoicePipelineErrorInit['kind'];
+    readonly provider: string;
+    readonly errorClass: HealthErrorClass;
+    readonly retryable: boolean;
+    readonly cause?: unknown;
+    constructor(init: VoicePipelineErrorInit);
+    /**
+     * Best-effort classification of an arbitrary error into a voice-pipeline
+     * error with a well-known errorClass. Preserves the original error as
+     * `cause` so upstream inspection can still recover provider-specific
+     * detail.
+     */
+    static classifyError(err: unknown, meta: {
+        kind: VoicePipelineErrorInit['kind'];
+        provider: string;
+    }): VoicePipelineError;
+}
+/**
+ * Aggregate thrown by `StreamingSTTChain` / `StreamingTTSChain` when every
+ * candidate provider fails. Carries the per-provider error list so callers
+ * can display a breakdown rather than a single confusing message.
+ */
+export declare class AggregateVoiceError extends Error {
+    readonly attempts: VoicePipelineError[];
+    constructor(attempts: VoicePipelineError[]);
+}
+//# sourceMappingURL=VoicePipelineError.d.ts.map

package/dist/voice-pipeline/VoicePipelineError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoicePipelineError.d.ts","sourceRoot":"","sources":["../../src/voice-pipeline/VoicePipelineError.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,OAAO,GACP,SAAS,GACT,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,WAAW,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEb,IAAI,EAAE,sBAAsB;IAUxC;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAClB,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE;QAAE,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAC/D,kBAAkB;CAoCtB;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;gBAE5B,QAAQ,EAAE,kBAAkB,EAAE;CAQ3C"}

package/dist/voice-pipeline/VoicePipelineError.js

@@ -0,0 +1,74 @@
+/**
+ * @module voice-pipeline/VoicePipelineError
+ *
+ * Structured error class for voice pipeline failures. Carries enough shape
+ * for chains and circuit breakers to classify and react without stringly
+ * matching error.message.
+ */
+export class VoicePipelineError extends Error {
+    constructor(init) {
+        super(init.message);
+        this.name = 'VoicePipelineError';
+        this.kind = init.kind;
+        this.provider = init.provider;
+        this.errorClass = init.errorClass;
+        this.retryable = init.retryable;
+        this.cause = init.cause;
+    }
+    /**
+     * Best-effort classification of an arbitrary error into a voice-pipeline
+     * error with a well-known errorClass. Preserves the original error as
+     * `cause` so upstream inspection can still recover provider-specific
+     * detail.
+     */
+    static classifyError(err, meta) {
+        const raw = err instanceof Error ? err : new Error(String(err));
+        const msg = raw.message ?? '';
+        const code = err?.code ?? '';
+        let errorClass = 'unknown';
+        let retryable = true;
+        if (/\b401\b|unauthori[sz]ed|invalid api key|forbidden|\b403\b/i.test(msg)) {
+            errorClass = 'auth';
+            retryable = false;
+        }
+        else if (/\b429\b|rate.?limit|too many/i.test(msg)) {
+            errorClass = 'quota';
+            retryable = true;
+        }
+        else if (/\b5\d\d\b|internal server|bad gateway|gateway timeout|service unavailable/i.test(msg)) {
+            errorClass = 'service';
+            retryable = true;
+        }
+        else if (code === 'ECONNRESET' ||
+            code === 'ETIMEDOUT' ||
+            code === 'ENOTFOUND' ||
+            /econnreset|etimedout|enotfound|socket hang up|network/i.test(msg)) {
+            errorClass = 'network';
+            retryable = true;
+        }
+        return new VoicePipelineError({
+            kind: meta.kind,
+            provider: meta.provider,
+            errorClass,
+            message: msg || 'unknown voice pipeline error',
+            cause: err,
+            retryable,
+        });
+    }
+}
+/**
+ * Aggregate thrown by `StreamingSTTChain` / `StreamingTTSChain` when every
+ * candidate provider fails. Carries the per-provider error list so callers
+ * can display a breakdown rather than a single confusing message.
+ */
+export class AggregateVoiceError extends Error {
+    constructor(attempts) {
+        const summary = attempts
+            .map((a) => `${a.provider}: ${a.errorClass} \u2014 ${a.message}`)
+            .join('; ');
+        super(`All ${attempts.length} providers failed \u2014 ${summary}`);
+        this.name = 'AggregateVoiceError';
+        this.attempts = attempts;
+    }
+}
+//# sourceMappingURL=VoicePipelineError.js.map

package/dist/voice-pipeline/VoicePipelineError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoicePipelineError.js","sourceRoot":"","sources":["../../src/voice-pipeline/VoicePipelineError.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkBH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAO3C,YAAY,IAA4B;QACtC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAClB,GAAY,EACZ,IAAgE;QAEhE,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAChE,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAI,GAAgC,EAAE,IAAI,IAAI,EAAE,CAAC;QAE3D,IAAI,UAAU,GAAqB,SAAS,CAAC;QAC7C,IAAI,SAAS,GAAG,IAAI,CAAC;QAErB,IAAI,4DAA4D,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3E,UAAU,GAAG,MAAM,CAAC;YACpB,SAAS,GAAG,KAAK,CAAC;QACpB,CAAC;aAAM,IAAI,+BAA+B,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACrD,UAAU,GAAG,OAAO,CAAC;YACrB,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;aAAM,IAAI,4EAA4E,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAClG,UAAU,GAAG,SAAS,CAAC;YACvB,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;aAAM,IACL,IAAI,KAAK,YAAY;YACrB,IAAI,KAAK,WAAW;YACpB,IAAI,KAAK,WAAW;YACpB,wDAAwD,CAAC,IAAI,CAAC,GAAG,CAAC,EAClE,CAAC;YACD,UAAU,GAAG,SAAS,CAAC;YACvB,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;QAED,OAAO,IAAI,kBAAkB,CAAC;YAC5B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,UAAU;YACV,OAAO,EAAE,GAAG,IAAI,8BAA8B;YAC9C,KAAK,EAAE,GAAG;YACV,SAAS;SACV,CAAC,CAAC;IACL,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAG5C,YAAY,QAA8B;QACxC,MAAM,OAAO,GAAG,QAAQ;aACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,UAAU,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;aAChE,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,KAAK,CAAC,OAAO,QAAQ,CAAC,MAAM,4BAA4B,OAAO,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF"}

package/dist/voice-pipeline/env-constructor.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @module voice-pipeline/env-constructor
+ *
+ * Batteries-included constructor for `StreamingSTTChain` +
+ * `StreamingTTSChain`. Reads provider keys from an env-like object and
+ * builds priority-ordered chains with shared circuit breaker and metrics
+ * reporter. Host apps can skip the manual wiring and use this factory as
+ * the default integration point.
+ */
+import { StreamingSTTChain } from './providers/StreamingSTTChain.js';
+import { StreamingTTSChain } from './providers/StreamingTTSChain.js';
+import { CircuitBreaker } from './CircuitBreaker.js';
+import { VoiceMetricsReporter } from './VoiceMetricsReporter.js';
+export declare class NoVoiceProvidersAvailableError extends Error {
+    readonly checkedEnvVars: string[];
+    constructor(checked: string[]);
+}
+export interface VoiceProviderEnvConfig {
+    /** Environment source. Defaults to process.env. */
+    env?: Record<string, string | undefined>;
+    /** Prefer streaming-class providers for first-try. Default true. */
+    preferStreaming?: boolean;
+    /** Language hint — providers whose capabilities don't match are still
+     *  included (capability filtering is host-app policy), but this value
+     *  is passed through to StreamingTTSConfig / StreamingSTTConfig via
+     *  startSession consumers. */
+    languageHint?: string;
+    /** Target cost tier. Reserved for future per-session routing; not used yet. */
+    tier?: 'cheap' | 'standard' | 'premium';
+    /** Whether the STT chain keeps a ring buffer + re-routes mid-utterance.
+     *  Default true — this is the whole point of the resilience work. */
+    enableMidUtteranceFailover?: boolean;
+    /** Whether the TTS chain re-sends accumulated tokens on primary
+     *  failure. Default true. */
+    enableMidSynthesisFailover?: boolean;
+}
+export interface VoiceProviderBundle {
+    stt: StreamingSTTChain;
+    tts: StreamingTTSChain;
+    metrics: VoiceMetricsReporter;
+    breaker: CircuitBreaker;
+    /** Release any global resources the bundle owns. Currently a no-op
+     *  because sessions clean up themselves; exposed now so host apps can
+     *  depend on the shape. */
+    dispose(): Promise<void>;
+}
+export declare function createVoiceProvidersFromEnv(config?: VoiceProviderEnvConfig): VoiceProviderBundle;
+//# sourceMappingURL=env-constructor.d.ts.map

package/dist/voice-pipeline/env-constructor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-constructor.d.ts","sourceRoot":"","sources":["../../src/voice-pipeline/env-constructor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAIjE,qBAAa,8BAA+B,SAAQ,KAAK;IACvD,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE;CAO9B;AAED,MAAM,WAAW,sBAAsB;IACrC,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,oEAAoE;IACpE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;kCAG8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IACxC;yEACqE;IACrE,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC;iCAC6B;IAC7B,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,iBAAiB,CAAC;IACvB,GAAG,EAAE,iBAAiB,CAAC;IACvB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,OAAO,EAAE,cAAc,CAAC;IACxB;;+BAE2B;IAC3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,wBAAgB,2BAA2B,CACzC,MAAM,GAAE,sBAA2B,GAClC,mBAAmB,CA8ErB"}

package/dist/voice-pipeline/env-constructor.js

@@ -0,0 +1,85 @@
+/**
+ * @module voice-pipeline/env-constructor
+ *
+ * Batteries-included constructor for `StreamingSTTChain` +
+ * `StreamingTTSChain`. Reads provider keys from an env-like object and
+ * builds priority-ordered chains with shared circuit breaker and metrics
+ * reporter. Host apps can skip the manual wiring and use this factory as
+ * the default integration point.
+ */
+import { DeepgramStreamingSTT } from './providers/DeepgramStreamingSTT.js';
+import { ElevenLabsStreamingSTT } from './providers/ElevenLabsStreamingSTT.js';
+import { ElevenLabsStreamingTTS } from './providers/ElevenLabsStreamingTTS.js';
+import { OpenAIRealtimeTTS } from './providers/OpenAIRealtimeTTS.js';
+import { ElevenLabsBatchTTS } from './providers/ElevenLabsBatchTTS.js';
+import { OpenAIBatchTTS } from './providers/OpenAIBatchTTS.js';
+import { StreamingSTTChain } from './providers/StreamingSTTChain.js';
+import { StreamingTTSChain } from './providers/StreamingTTSChain.js';
+import { CircuitBreaker } from './CircuitBreaker.js';
+import { VoiceMetricsReporter } from './VoiceMetricsReporter.js';
+export class NoVoiceProvidersAvailableError extends Error {
+    constructor(checked) {
+        super(`No voice providers available. Set any of: ${checked.join(', ')} in the server env.`);
+        this.name = 'NoVoiceProvidersAvailableError';
+        this.checkedEnvVars = checked;
+    }
+}
+export function createVoiceProvidersFromEnv(config = {}) {
+    const env = config.env ?? globalThis.process?.env ?? {};
+    const checkedKeys = [
+        'DEEPGRAM_API_KEY',
+        'ELEVENLABS_API_KEY',
+        'OPENAI_API_KEY',
+    ];
+    const deepgramKey = env['DEEPGRAM_API_KEY'];
+    const elevenLabsKey = env['ELEVENLABS_API_KEY'];
+    const openaiKey = env['OPENAI_API_KEY'];
+    const metrics = new VoiceMetricsReporter();
+    const breaker = new CircuitBreaker({
+        failureThreshold: 3,
+        windowMs: 60000,
+        cooldownMs: 60000,
+    });
+    const sttProviders = [];
+    if (deepgramKey) {
+        sttProviders.push(new DeepgramStreamingSTT({ apiKey: deepgramKey, priority: 10 }));
+    }
+    if (elevenLabsKey) {
+        sttProviders.push(new ElevenLabsStreamingSTT({ apiKey: elevenLabsKey, priority: 20 }));
+    }
+    const ttsProviders = [];
+    if (elevenLabsKey) {
+        ttsProviders.push(new ElevenLabsStreamingTTS({ apiKey: elevenLabsKey, priority: 10 }));
+    }
+    if (openaiKey) {
+        ttsProviders.push(new OpenAIRealtimeTTS({ apiKey: openaiKey, priority: 20 }));
+        ttsProviders.push(new OpenAIBatchTTS({ apiKey: openaiKey, priority: 90 }));
+    }
+    if (elevenLabsKey) {
+        ttsProviders.push(new ElevenLabsBatchTTS({ apiKey: elevenLabsKey, priority: 80 }));
+    }
+    if (sttProviders.length === 0 || ttsProviders.length === 0) {
+        throw new NoVoiceProvidersAvailableError(checkedKeys);
+    }
+    const stt = new StreamingSTTChain(sttProviders, {
+        breaker,
+        metrics,
+        enableMidUtteranceFailover: config.enableMidUtteranceFailover ?? true,
+        ringBufferCapacityMs: 3000,
+    });
+    const tts = new StreamingTTSChain(ttsProviders, {
+        breaker,
+        metrics,
+        enableMidSynthesisFailover: config.enableMidSynthesisFailover ?? true,
+    });
+    return {
+        stt,
+        tts,
+        metrics,
+        breaker,
+        async dispose() {
+            /* Sessions clean themselves up; nothing global to release today. */
+        },
+    };
+}
+//# sourceMappingURL=env-constructor.js.map

package/dist/voice-pipeline/env-constructor.js.map

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

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

@@ -104,5 +104,12 @@ export { WebSocketStreamTransport } from './WebSocketStreamTransport.js';
 export { WebRTCStreamTransport, createWebRTCTransport } from './WebRTCStreamTransport.js';
 export { VoicePipelineOrchestrator } from './VoicePipelineOrchestrator.js';
 export { VoiceInterruptError } from './VoiceInterruptError.js';
-export { DeepgramStreamingSTT, type DeepgramStreamingSTTConfig, ElevenLabsStreamingSTT, type ElevenLabsStreamingSTTConfig, ElevenLabsStreamingTTS, type ElevenLabsStreamingTTSConfig, AgentSessionVoiceAdapter, } from './providers/index.js';
+export { DeepgramStreamingSTT, type DeepgramStreamingSTTConfig, ElevenLabsStreamingSTT, type ElevenLabsStreamingSTTConfig, ElevenLabsStreamingTTS, type ElevenLabsStreamingTTSConfig, AgentSessionVoiceAdapter, StreamingSTTChain, type StreamingSTTChainOptions, type ProviderSelectedEvent, type ProviderFailedEvent, type ProviderFailoverEvent, StreamingTTSChain, type StreamingTTSChainOptions, type TTSProviderSelectedEvent, type TTSProviderFailedEvent, type TTSProviderFailoverEvent, } from './providers/index.js';
+export { VoicePipelineError, AggregateVoiceError, type HealthErrorClass, type VoicePipelineErrorInit, } from './VoicePipelineError.js';
+export { type HealthyProvider, type ProviderCapabilities, type HealthCheckResult, defaultCapabilities, supportsLanguage, } from './HealthyProvider.js';
+export { CircuitBreaker, type BreakerState, type CircuitBreakerOptions, type StateChangeEvent, } from './CircuitBreaker.js';
+export { AudioRingBuffer, type AudioRingBufferOptions } from './AudioRingBuffer.js';
+export { TranscriptDedupe, type TranscriptObservation, type DedupeResult, } from './TranscriptDedupe.js';
+export { VoiceMetricsReporter, type VoiceMetricEvent, type VoiceMetricListener, } from './VoiceMetricsReporter.js';
+export { createVoiceProvidersFromEnv, NoVoiceProvidersAvailableError, type VoiceProviderEnvConfig, type VoiceProviderBundle, } from './env-constructor.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/voice-pipeline/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgGG;AAIH,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAG1F,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAG3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,EACL,oBAAoB,EACpB,KAAK,0BAA0B,EAC/B,sBAAsB,EACtB,KAAK,4BAA4B,EACjC,sBAAsB,EACtB,KAAK,4BAA4B,EACjC,wBAAwB,GACzB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/voice-pipeline/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgGG;AAIH,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAG1F,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAG3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,EACL,oBAAoB,EACpB,KAAK,0BAA0B,EAC/B,sBAAsB,EACtB,KAAK,4BAA4B,EACjC,sBAAsB,EACtB,KAAK,4BAA4B,EACjC,wBAAwB,EACxB,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,GAC5B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC"}

package/dist/voice-pipeline/index.js

@@ -113,5 +113,13 @@ export { VoicePipelineOrchestrator } from './VoicePipelineOrchestrator.js';
 // Typed error for barge-in interruptions
 export { VoiceInterruptError } from './VoiceInterruptError.js';
 // Streaming provider implementations
-export { DeepgramStreamingSTT, ElevenLabsStreamingSTT, ElevenLabsStreamingTTS, AgentSessionVoiceAdapter, } from './providers/index.js';
+export { DeepgramStreamingSTT, ElevenLabsStreamingSTT, ElevenLabsStreamingTTS, AgentSessionVoiceAdapter, StreamingSTTChain, StreamingTTSChain, } from './providers/index.js';
+// Resilience primitives
+export { VoicePipelineError, AggregateVoiceError, } from './VoicePipelineError.js';
+export { defaultCapabilities, supportsLanguage, } from './HealthyProvider.js';
+export { CircuitBreaker, } from './CircuitBreaker.js';
+export { AudioRingBuffer } from './AudioRingBuffer.js';
+export { TranscriptDedupe, } from './TranscriptDedupe.js';
+export { VoiceMetricsReporter, } from './VoiceMetricsReporter.js';
+export { createVoiceProvidersFromEnv, NoVoiceProvidersAvailableError, } from './env-constructor.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/voice-pipeline/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgGG;AAEH,wDAAwD;AACxD,8EAA8E;AAC9E,cAAc,YAAY,CAAC;AAE3B,4CAA4C;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,6CAA6C;AAC7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,2CAA2C;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,oDAAoD;AACpD,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAE1F,gDAAgD;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,yCAAyC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,qCAAqC;AACrC,OAAO,EACL,oBAAoB,EAEpB,sBAAsB,EAEtB,sBAAsB,EAEtB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/voice-pipeline/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgGG;AAEH,wDAAwD;AACxD,8EAA8E;AAC9E,cAAc,YAAY,CAAC;AAE3B,4CAA4C;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,6CAA6C;AAC7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,2CAA2C;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,oDAAoD;AACpD,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAE1F,gDAAgD;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,yCAAyC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,qCAAqC;AACrC,OAAO,EACL,oBAAoB,EAEpB,sBAAsB,EAEtB,sBAAsB,EAEtB,wBAAwB,EACxB,iBAAiB,EAKjB,iBAAiB,GAKlB,MAAM,sBAAsB,CAAC;AAE9B,wBAAwB;AACxB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GAGpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAIL,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,cAAc,GAIf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAA+B,MAAM,sBAAsB,CAAC;AACpF,OAAO,EACL,gBAAgB,GAGjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,oBAAoB,GAGrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,GAG/B,MAAM,sBAAsB,CAAC"}

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

@@ -24,6 +24,16 @@
  * @see https://developers.deepgram.com/docs/streaming
  */
 import type { IStreamingSTT, StreamingSTTSession, StreamingSTTConfig } from '../types.js';
+import { type HealthyProvider, type HealthCheckResult, type ProviderCapabilities } from '../HealthyProvider.js';
+/**
+ * Shape of the injected health probe used for deterministic tests.
+ * Default implementation hits Deepgram's /v1/projects endpoint.
+ */
+export type VoiceHealthProbe = (apiKey: string) => Promise<{
+    ok: boolean;
+    status: number;
+    latencyMs: number;
+}>;
 /**
  * Configuration for the {@link DeepgramStreamingSTT} provider.
  */
@@ -40,6 +50,15 @@ export interface DeepgramStreamingSTTConfig {
      * @default 'nova-2'
      */
     model?: string;
+    /**
+     * Chain priority. Lower values are tried first.
+     * @default 10
+     */
+    priority?: number;
+    /** Optional capability overrides. Merged into defaultCapabilities(). */
+    capabilities?: Partial<ProviderCapabilities>;
+    /** Injectable health probe for tests. Defaults to Deepgram /v1/projects. */
+    healthProbe?: VoiceHealthProbe;
 }
 /**
  * Streaming STT provider that creates Deepgram WebSocket sessions.
@@ -55,12 +74,16 @@ export interface DeepgramStreamingSTTConfig {
  * session.on('transcript', (event) => console.log(event.text));
  * ```
  */
-export declare class DeepgramStreamingSTT implements IStreamingSTT {
+export declare class DeepgramStreamingSTT implements IStreamingSTT, HealthyProvider {
     private readonly config;
     readonly providerId = "deepgram-streaming";
     readonly isStreaming = true;
+    readonly priority: number;
+    readonly capabilities: ProviderCapabilities;
     private readonly keyPool;
+    private readonly healthProbe;
     constructor(config: DeepgramStreamingSTTConfig);
+    healthCheck(): Promise<HealthCheckResult>;
     /**
      * Create a new streaming STT session connected to Deepgram.
      * Each session gets a fresh key from the round-robin pool.

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

@@ -1 +1 @@
-{"version":3,"file":"DeepgramStreamingSTT.d.ts","sourceRoot":"","sources":["../../../src/voice-pipeline/providers/DeepgramStreamingSTT.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAKH,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAInB,MAAM,aAAa,CAAC;AAMrB;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAmQD;;;;;;;;;;;;;GAaG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IAK5C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,QAAQ,CAAC,UAAU,wBAAwB;IAC3C,QAAQ,CAAC,WAAW,QAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;gBAER,MAAM,EAAE,0BAA0B;IAI/D;;;OAGG;IACG,YAAY,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAM9E"}
+{"version":3,"file":"DeepgramStreamingSTT.d.ts","sourceRoot":"","sources":["../../../src/voice-pipeline/providers/DeepgramStreamingSTT.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAKH,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAInB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAG/B;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,MAAM,EAAE,MAAM,KACX,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAmBjE;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,wEAAwE;IACxE,YAAY,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAE7C,4EAA4E;IAC5E,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC;AAmQD;;;;;;;;;;;;;GAaG;AACH,qBAAa,oBAAqB,YAAW,aAAa,EAAE,eAAe;IAQ7D,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPnC,QAAQ,CAAC,UAAU,wBAAwB;IAC3C,QAAQ,CAAC,WAAW,QAAQ;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmB;gBAElB,MAAM,EAAE,0BAA0B;IAazD,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;IA6B/C;;;OAGG;IACG,YAAY,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAM9E"}

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

@@ -26,6 +26,21 @@
 import { EventEmitter } from 'node:events';
 import WebSocket from 'ws';
 import { ApiKeyPool } from '../../core/providers/ApiKeyPool.js';
+import { defaultCapabilities, } from '../HealthyProvider.js';
+import { VoicePipelineError } from '../VoicePipelineError.js';
+async function defaultDeepgramProbe(apiKey) {
+    const start = Date.now();
+    try {
+        const res = await fetch('https://api.deepgram.com/v1/projects', {
+            headers: { Authorization: `Token ${apiKey}` },
+            signal: AbortSignal.timeout(1000),
+        });
+        return { ok: res.ok, status: res.status, latencyMs: Date.now() - start };
+    }
+    catch (err) {
+        throw err;
+    }
+}
 // ---------------------------------------------------------------------------
 // Session Implementation
 // ---------------------------------------------------------------------------
@@ -229,6 +244,42 @@ export class DeepgramStreamingSTT {
         this.providerId = 'deepgram-streaming';
         this.isStreaming = true;
         this.keyPool = new ApiKeyPool(config.apiKey);
+        this.priority = config.priority ?? 10;
+        this.capabilities = defaultCapabilities({
+            languages: ['*'],
+            streaming: true,
+            costTier: 'standard',
+            latencyClass: 'realtime',
+            ...(config.capabilities ?? {}),
+        });
+        this.healthProbe = config.healthProbe ?? defaultDeepgramProbe;
+    }
+    async healthCheck() {
+        if (!this.keyPool.hasKeys) {
+            return { ok: false, error: { class: 'auth', message: 'no api key available' } };
+        }
+        const key = this.keyPool.next();
+        try {
+            const res = await this.healthProbe(key);
+            if (res.ok)
+                return { ok: true, latencyMs: res.latencyMs };
+            const classified = VoicePipelineError.classifyError(new Error(`HTTP ${res.status}`), { kind: 'stt', provider: this.providerId });
+            return {
+                ok: false,
+                latencyMs: res.latencyMs,
+                error: { class: classified.errorClass, message: `HTTP ${res.status}` },
+            };
+        }
+        catch (err) {
+            const classified = VoicePipelineError.classifyError(err, {
+                kind: 'stt',
+                provider: this.providerId,
+            });
+            return {
+                ok: false,
+                error: { class: classified.errorClass, message: classified.message },
+            };
+        }
     }
     /**
      * Create a new streaming STT session connected to Deepgram.