@framers/agentos 0.1.226 → 0.1.228

package/dist/voice-pipeline/AudioRingBuffer.js

@@ -0,0 +1,43 @@
+/**
+ * @module voice-pipeline/AudioRingBuffer
+ *
+ * Fixed-capacity PCM ring buffer keyed by wall-clock timestamp. Used by
+ * StreamingSTTChain to replay the last ~capacityMs of audio into a backup
+ * provider when the primary fails mid-utterance.
+ *
+ * The buffer treats each AudioFrame as atomic — it never splits frames —
+ * so durationMs() may exceed capacityMs by up to one frame's worth of
+ * audio until the next push. For a 20 ms frame size and a 3000 ms
+ * capacity this overshoot is negligible.
+ */
+export class AudioRingBuffer {
+    constructor(opts) {
+        this.frames = [];
+        this.capacityMs = opts.capacityMs;
+    }
+    push(frame) {
+        this.frames.push(frame);
+        // Always keep at least one frame. Without this guard a pathologically
+        // small capacity (e.g. 1 ms) would evict every push immediately.
+        while (this.frames.length > 1 && this.durationMs() > this.capacityMs) {
+            this.frames.shift();
+        }
+    }
+    snapshot() {
+        return [...this.frames];
+    }
+    durationMs() {
+        if (this.frames.length === 0)
+            return 0;
+        const first = this.frames[0];
+        const last = this.frames[this.frames.length - 1];
+        return last.timestamp - first.timestamp + this.frameDurationMs(last);
+    }
+    clear() {
+        this.frames = [];
+    }
+    frameDurationMs(frame) {
+        return (frame.samples.length / frame.sampleRate) * 1000;
+    }
+}
+//# sourceMappingURL=AudioRingBuffer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AudioRingBuffer.js","sourceRoot":"","sources":["../../src/voice-pipeline/AudioRingBuffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,MAAM,OAAO,eAAe;IAI1B,YAAY,IAA4B;QAFhC,WAAM,GAAiB,EAAE,CAAC;QAGhC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IACpC,CAAC;IAED,IAAI,CAAC,KAAiB;QACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,sEAAsE;QACtE,iEAAiE;QACjE,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YACrE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC;IACH,CAAC;IAED,QAAQ;QACN,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,UAAU;QACR,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACvE,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;IAEO,eAAe,CAAC,KAAiB;QACvC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IAC1D,CAAC;CACF"}

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

@@ -0,0 +1,42 @@
+/**
+ * @module voice-pipeline/CircuitBreaker
+ *
+ * Per-provider state machine: tracks failures within a sliding window, trips
+ * when the failure count crosses a threshold, and auto-recovers after a
+ * cooldown. Auth failures trip permanently (cooldown = Infinity) because a
+ * bad API key won't fix itself without operator intervention.
+ */
+import type { HealthErrorClass } from './VoicePipelineError.js';
+export type BreakerState = 'healthy' | 'tripped';
+export interface CircuitBreakerOptions {
+    failureThreshold: number;
+    windowMs: number;
+    cooldownMs: number;
+    now?: () => number;
+}
+export interface StateChangeEvent {
+    providerId: string;
+    from: BreakerState;
+    to: BreakerState;
+    reason?: HealthErrorClass | 'recover';
+}
+export declare class CircuitBreaker {
+    private readonly failureThreshold;
+    private readonly windowMs;
+    private readonly cooldownMs;
+    private readonly nowFn;
+    private readonly records;
+    private readonly listeners;
+    constructor(opts: CircuitBreakerOptions);
+    state(providerId: string): BreakerState;
+    isAvailable(providerId: string): boolean;
+    recordFailure(providerId: string, reason: HealthErrorClass): void;
+    recordSuccess(providerId: string): void;
+    /** Force a state-transition pass for all tracked providers. Useful when
+     *  the caller wants to drive recoveries on a timer. */
+    tick(_nowHint?: number): void;
+    onStateChange(fn: (event: StateChangeEvent) => void): () => void;
+    private getOrCreate;
+    private transition;
+}
+//# sourceMappingURL=CircuitBreaker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CircuitBreaker.d.ts","sourceRoot":"","sources":["../../src/voice-pipeline/CircuitBreaker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,YAAY,CAAC;IACjB,MAAM,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;CACvC;AASD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgD;gBAE9D,IAAI,EAAE,qBAAqB;IAOvC,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY;IAQvC,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIxC,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAuBjE,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAUvC;2DACuD;IACvD,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAM7B,aAAa,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI;IAKhE,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,UAAU;CAiBnB"}

package/dist/voice-pipeline/CircuitBreaker.js

@@ -0,0 +1,96 @@
+/**
+ * @module voice-pipeline/CircuitBreaker
+ *
+ * Per-provider state machine: tracks failures within a sliding window, trips
+ * when the failure count crosses a threshold, and auto-recovers after a
+ * cooldown. Auth failures trip permanently (cooldown = Infinity) because a
+ * bad API key won't fix itself without operator intervention.
+ */
+export class CircuitBreaker {
+    constructor(opts) {
+        this.records = new Map();
+        this.listeners = new Set();
+        this.failureThreshold = opts.failureThreshold;
+        this.windowMs = opts.windowMs;
+        this.cooldownMs = opts.cooldownMs;
+        this.nowFn = opts.now ?? (() => Date.now());
+    }
+    state(providerId) {
+        const rec = this.getOrCreate(providerId);
+        if (rec.currentState === 'tripped' && this.nowFn() >= rec.trippedUntil) {
+            this.transition(providerId, rec, 'healthy', 'recover');
+        }
+        return rec.currentState;
+    }
+    isAvailable(providerId) {
+        return this.state(providerId) === 'healthy';
+    }
+    recordFailure(providerId, reason) {
+        const rec = this.getOrCreate(providerId);
+        const now = this.nowFn();
+        // Auth failures are terminal — a bad key won't recover on its own.
+        if (reason === 'auth') {
+            rec.trippedAt = now;
+            rec.trippedUntil = Number.POSITIVE_INFINITY;
+            rec.failures = [];
+            this.transition(providerId, rec, 'tripped', 'auth');
+            return;
+        }
+        rec.failures.push(now);
+        rec.failures = rec.failures.filter((t) => now - t <= this.windowMs);
+        if (rec.failures.length >= this.failureThreshold) {
+            rec.trippedAt = now;
+            rec.trippedUntil = now + this.cooldownMs;
+            rec.failures = [];
+            this.transition(providerId, rec, 'tripped', reason);
+        }
+    }
+    recordSuccess(providerId) {
+        const rec = this.getOrCreate(providerId);
+        rec.failures = [];
+        if (rec.currentState === 'tripped') {
+            rec.trippedAt = null;
+            rec.trippedUntil = 0;
+            this.transition(providerId, rec, 'healthy', 'recover');
+        }
+    }
+    /** Force a state-transition pass for all tracked providers. Useful when
+     *  the caller wants to drive recoveries on a timer. */
+    tick(_nowHint) {
+        for (const id of this.records.keys()) {
+            void this.state(id);
+        }
+    }
+    onStateChange(fn) {
+        this.listeners.add(fn);
+        return () => this.listeners.delete(fn);
+    }
+    getOrCreate(providerId) {
+        let rec = this.records.get(providerId);
+        if (!rec) {
+            rec = {
+                failures: [],
+                trippedAt: null,
+                trippedUntil: 0,
+                currentState: 'healthy',
+            };
+            this.records.set(providerId, rec);
+        }
+        return rec;
+    }
+    transition(providerId, rec, to, reason) {
+        const from = rec.currentState;
+        if (from === to)
+            return;
+        rec.currentState = to;
+        for (const fn of this.listeners) {
+            try {
+                fn({ providerId, from, to, reason });
+            }
+            catch {
+                /* one bad listener must not poison the rest */
+            }
+        }
+    }
+}
+//# sourceMappingURL=CircuitBreaker.js.map

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

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

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

@@ -0,0 +1,44 @@
+/**
+ * @module voice-pipeline/HealthyProvider
+ *
+ * Provider-health trait adopted by every STT/TTS implementation so chains
+ * can prune, route, and circuit-break without peering into each provider's
+ * private state.
+ */
+import type { HealthErrorClass } from './VoicePipelineError.js';
+export interface ProviderCapabilities {
+    /** ISO language tags supported; ['*'] for any language. */
+    languages: string[];
+    /** True if this provider streams; false for batch-only. */
+    streaming: boolean;
+    /** Known max concurrent sessions the provider allows; Infinity if unlimited. */
+    maxConcurrent: number;
+    /** Relative cost bucket. 'cheap' < 'standard' < 'premium'. */
+    costTier: 'cheap' | 'standard' | 'premium';
+    /** Expected latency class for real-time viability. */
+    latencyClass: 'realtime' | 'near-realtime' | 'batch';
+}
+export interface HealthCheckResult {
+    ok: boolean;
+    latencyMs?: number;
+    error?: {
+        class: HealthErrorClass;
+        message: string;
+    };
+}
+export interface HealthyProvider {
+    /** Unique, stable provider id; same value used in VoicePipelineError.provider. */
+    readonly providerId: string;
+    /** Lower = tried first. Apps may override via constructor option. */
+    readonly priority: number;
+    readonly capabilities: ProviderCapabilities;
+    /**
+     * Lightweight probe (should complete in under 1 second). Must NOT consume
+     * billable audio or synthesis during a health check — it exists to verify
+     * authentication and reachability, not to measure quality.
+     */
+    healthCheck(): Promise<HealthCheckResult>;
+}
+export declare function defaultCapabilities(overrides?: Partial<ProviderCapabilities>): ProviderCapabilities;
+export declare function supportsLanguage(caps: ProviderCapabilities, lang: string): boolean;
+//# sourceMappingURL=HealthyProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HealthyProvider.d.ts","sourceRoot":"","sources":["../../src/voice-pipeline/HealthyProvider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,2DAA2D;IAC3D,SAAS,EAAE,OAAO,CAAC;IACnB,gFAAgF;IAChF,aAAa,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IAC3C,sDAAsD;IACtD,YAAY,EAAE,UAAU,GAAG,eAAe,GAAG,OAAO,CAAC;CACtD;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,gBAAgB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD;AAED,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC5C;;;;OAIG;IACH,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC3C;AAED,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,oBAAoB,CAAM,GAC5C,oBAAoB,CAStB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAWlF"}

package/dist/voice-pipeline/HealthyProvider.js

@@ -0,0 +1,29 @@
+/**
+ * @module voice-pipeline/HealthyProvider
+ *
+ * Provider-health trait adopted by every STT/TTS implementation so chains
+ * can prune, route, and circuit-break without peering into each provider's
+ * private state.
+ */
+export function defaultCapabilities(overrides = {}) {
+    return {
+        languages: ['*'],
+        streaming: true,
+        maxConcurrent: Infinity,
+        costTier: 'standard',
+        latencyClass: 'realtime',
+        ...overrides,
+    };
+}
+export function supportsLanguage(caps, lang) {
+    if (caps.languages.includes('*'))
+        return true;
+    const normalized = lang.toLowerCase();
+    return caps.languages.some((supported) => {
+        const s = supported.toLowerCase();
+        return (s === normalized ||
+            normalized.startsWith(s + '-') ||
+            s.startsWith(normalized + '-'));
+    });
+}
+//# sourceMappingURL=HealthyProvider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HealthyProvider.js","sourceRoot":"","sources":["../../src/voice-pipeline/HealthyProvider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqCH,MAAM,UAAU,mBAAmB,CACjC,YAA2C,EAAE;IAE7C,OAAO;QACL,SAAS,EAAE,CAAC,GAAG,CAAC;QAChB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,QAAQ;QACvB,QAAQ,EAAE,UAAU;QACpB,YAAY,EAAE,UAAU;QACxB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAA0B,EAAE,IAAY;IACvE,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACtC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;QACvC,MAAM,CAAC,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;QAClC,OAAO,CACL,CAAC,KAAK,UAAU;YAChB,UAAU,CAAC,UAAU,CAAC,CAAC,GAAG,GAAG,CAAC;YAC9B,CAAC,CAAC,UAAU,CAAC,UAAU,GAAG,GAAG,CAAC,CAC/B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,43 @@
+/**
+ * @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.
+ */
+export interface TranscriptObservation {
+    provider: string;
+    text: string;
+    audioStartMs: number;
+    audioEndMs: number;
+    isFinal: boolean;
+}
+export interface DedupeResult {
+    isDuplicate: boolean;
+    reason?: 'exact' | 'fuzzy' | 'superset';
+    against?: {
+        provider: string;
+        text: string;
+    };
+}
+export declare class TranscriptDedupe {
+    private recent;
+    private readonly fuzzyThreshold;
+    private readonly retainMs;
+    constructor(opts?: {
+        fuzzyThreshold?: number;
+        retainMs?: number;
+    });
+    evaluate(obs: TranscriptObservation): DedupeResult;
+    reset(): void;
+    private prune;
+}
+//# sourceMappingURL=TranscriptDedupe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TranscriptDedupe.d.ts","sourceRoot":"","sources":["../../src/voice-pipeline/TranscriptDedupe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;IACxC,OAAO,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AA2BD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,IAAI,GAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO;IAKrE,QAAQ,CAAC,GAAG,EAAE,qBAAqB,GAAG,YAAY;IA+ClD,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,KAAK;CAId"}

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