@kuralle-syrinx/core 4.4.0 → 4.5.0

package/dist/policies/rule-based.js

@@ -0,0 +1,130 @@
+// SPDX-License-Identifier: MIT
+import { TurnArbiter } from "../turn-arbiter.js";
+export class RuleBasedInteractionPolicy {
+    arbiter;
+    ttsPlayout;
+    backchannelConfig;
+    pending = [];
+    bargeInAudioConsumed = false;
+    delegateGapOpen = false;
+    delegateCuePlayed = false;
+    userSpeaking = false;
+    constructor(deps) {
+        this.ttsPlayout = deps.ttsPlayout;
+        this.backchannelConfig = deps.backchannel;
+        this.arbiter = new TurnArbiter({
+            bus: deps.bus,
+            primarySpeakerGate: deps.primarySpeakerGate,
+            ttsPlayout: deps.ttsPlayout,
+            minInterruptionMs: deps.minInterruptionMs,
+            pauseThenResolveBargeIn: deps.pauseThenResolveBargeIn,
+            onInterrupt: (id) => this.pending.push({ kind: "interrupt", interruptedContextId: id }),
+        });
+    }
+    observe(obs) {
+        switch (obs.kind) {
+            case "vad_speech_started":
+                this.userSpeaking = true;
+                if (obs.interruptedContextId)
+                    this.arbiter.onSpeechStarted({
+                        kind: "vad.speech_started",
+                        contextId: obs.contextId,
+                        timestampMs: obs.timestampMs,
+                        confidence: obs.confidence,
+                    }, obs.interruptedContextId);
+                break;
+            case "vad_speech_activity":
+                this.arbiter.onSpeechActivity({
+                    kind: "vad.speech_activity",
+                    contextId: obs.contextId,
+                    timestampMs: obs.timestampMs,
+                    isAsync: true,
+                });
+                break;
+            case "vad_speech_ended":
+                this.userSpeaking = false;
+                this.arbiter.onSpeechEnded({
+                    kind: "vad.speech_ended",
+                    contextId: obs.contextId,
+                    timestampMs: obs.timestampMs,
+                }, obs.hasActiveTts);
+                break;
+            case "vad_barge_in_audio":
+                this.bargeInAudioConsumed = this.arbiter.observeBargeInAudio({
+                    kind: "vad.audio",
+                    contextId: obs.contextId,
+                    timestampMs: obs.timestampMs,
+                    audio: obs.audio,
+                });
+                break;
+            case "stt_partial":
+                this.arbiter.noteInterimEvidence(obs.text);
+                if (obs.interruptedContextId) {
+                    this.arbiter.onProviderSttEvidence(obs.contextId, obs.timestampMs, obs.interruptedContextId);
+                }
+                break;
+            case "stt_final":
+                this.arbiter.noteInterimEvidence(obs.text, obs.confidence);
+                if (obs.interruptedContextId) {
+                    this.arbiter.onProviderSttEvidence(obs.contextId, obs.timestampMs, obs.interruptedContextId);
+                }
+                break;
+            case "delegate_state":
+                this.pending.push(...this.handleDelegateState(obs));
+                break;
+            default:
+                break;
+        }
+        if (this.pending.length === 0)
+            return [];
+        const out = this.pending;
+        this.pending = [];
+        return out;
+    }
+    handleDelegateState(obs) {
+        const phase = obs.toolCallPhase;
+        if (!phase)
+            return [];
+        switch (phase) {
+            case "started":
+                this.delegateGapOpen = true;
+                this.delegateCuePlayed = false;
+                return [];
+            case "delayed": {
+                if (!this.delegateGapOpen || this.delegateCuePlayed)
+                    return [];
+                if (this.depsTtsActive())
+                    return [];
+                if (this.userSpeaking)
+                    return [];
+                this.delegateCuePlayed = true;
+                if (this.backchannelConfig?.enabled === false)
+                    return [];
+                const cue = this.backchannelConfig?.cues?.[0] ?? "mm_hmm";
+                return [{ kind: "backchannel", cue }];
+            }
+            case "complete":
+            case "failed":
+                this.delegateGapOpen = false;
+                this.delegateCuePlayed = false;
+                return [];
+            default:
+                return [];
+        }
+    }
+    depsTtsActive() {
+        return this.ttsPlayout.activeContexts().length > 0;
+    }
+    reset(_contextId) {
+        this.delegateGapOpen = false;
+        this.delegateCuePlayed = false;
+        this.userSpeaking = false;
+        this.arbiter.clear();
+    }
+    takeBargeInAudioConsumed() {
+        const consumed = this.bargeInAudioConsumed;
+        this.bargeInAudioConsumed = false;
+        return consumed;
+    }
+}
+//# sourceMappingURL=rule-based.js.map

package/dist/policies/rule-based.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-based.js","sourceRoot":"","sources":["../../src/policies/rule-based.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAM/B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAgBjD,MAAM,OAAO,0BAA0B;IAC5B,OAAO,CAAc;IACb,UAAU,CAAkB;IAC5B,iBAAiB,CAAgD;IAC1E,OAAO,GAA0B,EAAE,CAAC;IACpC,oBAAoB,GAAG,KAAK,CAAC;IAC7B,eAAe,GAAG,KAAK,CAAC;IACxB,iBAAiB,GAAG,KAAK,CAAC;IAC1B,YAAY,GAAG,KAAK,CAAC;IAE7B,YAAY,IAAoC;QAC9C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,WAAW,CAAC;QAC1C,IAAI,CAAC,OAAO,GAAG,IAAI,WAAW,CAAC;YAC7B,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;YAC3C,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;YACrD,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,oBAAoB,EAAE,EAAE,EAAE,CAAC;SACxF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,GAA2B;QACjC,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,oBAAoB;gBACvB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;gBACzB,IAAI,GAAG,CAAC,oBAAoB;oBAAE,IAAI,CAAC,OAAO,CAAC,eAAe,CACxD;wBACE,IAAI,EAAE,oBAAoB;wBAC1B,SAAS,EAAE,GAAG,CAAC,SAAS;wBACxB,WAAW,EAAE,GAAG,CAAC,WAAW;wBAC5B,UAAU,EAAE,GAAG,CAAC,UAAU;qBAC3B,EACD,GAAG,CAAC,oBAAoB,CACzB,CAAC;gBACF,MAAM;YACR,KAAK,qBAAqB;gBACxB,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC;oBAC5B,IAAI,EAAE,qBAAqB;oBAC3B,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,WAAW,EAAE,GAAG,CAAC,WAAW;oBAC5B,OAAO,EAAE,IAAI;iBACd,CAAC,CAAC;gBACH,MAAM;YACR,KAAK,kBAAkB;gBACrB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;gBAC1B,IAAI,CAAC,OAAO,CAAC,aAAa,CACxB;oBACE,IAAI,EAAE,kBAAkB;oBACxB,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,WAAW,EAAE,GAAG,CAAC,WAAW;iBAC7B,EACD,GAAG,CAAC,YAAY,CACjB,CAAC;gBACF,MAAM;YACR,KAAK,oBAAoB;gBACvB,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC;oBAC3D,IAAI,EAAE,WAAW;oBACjB,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,WAAW,EAAE,GAAG,CAAC,WAAW;oBAC5B,KAAK,EAAE,GAAG,CAAC,KAAK;iBACjB,CAAC,CAAC;gBACH,MAAM;YACR,KAAK,aAAa;gBAChB,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC3C,IAAI,GAAG,CAAC,oBAAoB,EAAE,CAAC;oBAC7B,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,oBAAoB,CAAC,CAAC;gBAC/F,CAAC;gBACD,MAAM;YACR,KAAK,WAAW;gBACd,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;gBAC3D,IAAI,GAAG,CAAC,oBAAoB,EAAE,CAAC;oBAC7B,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,oBAAoB,CAAC,CAAC;gBAC/F,CAAC;gBACD,MAAM;YACR,KAAK,gBAAgB;gBACnB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC;gBACpD,MAAM;YACR;gBACE,MAAM;QACV,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,mBAAmB,CAAC,GAAwD;QAClF,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC;QAChC,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAC;QAEtB,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,SAAS;gBACZ,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;gBAC5B,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC;gBAC/B,OAAO,EAAE,CAAC;YACZ,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,iBAAiB;oBAAE,OAAO,EAAE,CAAC;gBAC/D,IAAI,IAAI,CAAC,aAAa,EAAE;oBAAE,OAAO,EAAE,CAAC;gBACpC,IAAI,IAAI,CAAC,YAAY;oBAAE,OAAO,EAAE,CAAC;gBACjC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;gBAC9B,IAAI,IAAI,CAAC,iBAAiB,EAAE,OAAO,KAAK,KAAK;oBAAE,OAAO,EAAE,CAAC;gBACzD,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;gBAC1D,OAAO,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC;YACxC,CAAC;YACD,KAAK,UAAU,CAAC;YAChB,KAAK,QAAQ;gBACX,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;gBAC7B,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC;gBAC/B,OAAO,EAAE,CAAC;YACZ;gBACE,OAAO,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAEO,aAAa;QACnB,OAAO,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,UAAkB;QACtB,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;QAC7B,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC;QAC/B,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,wBAAwB;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC;QAC3C,IAAI,CAAC,oBAAoB,GAAG,KAAK,CAAC;QAClC,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/pricing.d.ts

@@ -0,0 +1,34 @@
+import type { UsageRecordedPacket } from "./packets.js";
+export interface SttPrice {
+    readonly usdPerAudioSecond: number;
+}
+export interface LlmPrice {
+    readonly usdPer1MInputTokens: number;
+    readonly usdPer1MOutputTokens: number;
+    readonly usdPer1MCachedInputTokens?: number;
+}
+export interface TtsPrice {
+    readonly usdPer1MCharacters: number;
+}
+export interface PriceCatalog {
+    readonly source: string;
+    readonly version: string;
+    /** Keys: `provider/model` (e.g. `deepgram/nova-3`). */
+    readonly stt: Readonly<Record<string, SttPrice>>;
+    readonly llm: Readonly<Record<string, LlmPrice>>;
+    readonly tts: Readonly<Record<string, TtsPrice>>;
+}
+export type CostResult = {
+    readonly usd: number;
+    readonly unpriced?: undefined;
+} | {
+    readonly usd: null;
+    readonly unpriced: true;
+};
+/**
+ * Public list prices stamped into DEFAULT_PRICE_CATALOG.source.
+ * STT $/audio-second from $/min ÷ 60. TTS is $/1M characters. LLM is $/1M tokens.
+ */
+export declare const DEFAULT_PRICE_CATALOG: PriceCatalog;
+export declare function costOf(usage: UsageRecordedPacket, catalog: PriceCatalog): CostResult;
+//# sourceMappingURL=pricing.d.ts.map

package/dist/pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../src/pricing.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,MAAM,CAAC;CAC7C;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjD,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjD,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;CAClD;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAA;CAAE,CAAC;AAOpD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAuDnC,CAAC;AAEF,wBAAgB,MAAM,CAAC,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU,CAmCpF"}

package/dist/pricing.js

@@ -0,0 +1,108 @@
+// SPDX-License-Identifier: MIT
+//
+// Versioned price catalog: usage.recorded quantities → USD.
+// Unknown provider/model keys yield unpriced (never silent 0 for real providers).
+// Declared local/self-hosted models are explicitly zero-cost.
+function catalogKey(provider, model) {
+    if (!provider || !model)
+        return null;
+    return `${provider}/${model}`;
+}
+/**
+ * Public list prices stamped into DEFAULT_PRICE_CATALOG.source.
+ * STT $/audio-second from $/min ÷ 60. TTS is $/1M characters. LLM is $/1M tokens.
+ */
+export const DEFAULT_PRICE_CATALOG = {
+    source: "voice-prices@3 | deepgram.com/pricing PAYG Nova-3 streaming monolingual $0.0077/min → $0.000128333/s; " +
+        "deepgram.com/pricing Aura-2 TTS $0.030/1k chars → $30/1M; " +
+        "cartesia.ai/pricing + docs.cartesia.ai/pricing ~1 credit/char, PAYG ~$50/1M chars (cloudtalk.io cartesia-pricing 2026); " +
+        "openai tts-1 $15/1M chars (openai.com api pricing); gpt-4o-mini-tts text $0.60/1M (community/azure listed text input rate); " +
+        "openai GPT-4.1-mini $0.40/$1.60 per 1M in/out (developers.openai.com/api/docs/pricing; Azure GPT-4.1-mini-2025-04-14 Global); " +
+        "cloud.google.com/speech-to-text/pricing V2 standard recognition $0.016/min → $0.000266667/s (latest_long); " +
+        "ai.google.dev/pricing Gemini 2.5 Flash TTS preview text $0.50/1M chars (Gemini API TTS text input rate, 2026); " +
+        "elevenlabs.io/pricing/api Flash/Turbo TTS $0.05/1k chars → $50/1M; Multilingual v2/v3 $0.10/1k → $100/1M; " +
+        "Scribe v2 Realtime $0.39/hour → $0.000108333/s; " +
+        "grok/stt + grok/* TTS + epsilon/epsilon-tts intentionally ABSENT (no public list price → costOf unpriced, never silent $0)",
+    version: "3",
+    stt: {
+        "deepgram/nova-3": { usdPerAudioSecond: 0.0077 / 60 },
+        "deepgram/nova-2": { usdPerAudioSecond: 0.0077 / 60 },
+        "deepgram/flux-general-en": { usdPerAudioSecond: 0.0077 / 60 },
+        // Google Cloud Speech-to-Text V2 standard streaming recognition list rate.
+        "google/latest_long": { usdPerAudioSecond: 0.016 / 60 },
+        "google/latest_short": { usdPerAudioSecond: 0.016 / 60 },
+        "google/chirp_2": { usdPerAudioSecond: 0.016 / 60 },
+        // ElevenLabs Scribe v2 Realtime — public list $0.39/hour.
+        "elevenlabs/scribe_v2_realtime": { usdPerAudioSecond: 0.39 / 3600 },
+        "local/whisper": { usdPerAudioSecond: 0 },
+        // grok/stt: no public list price — omit so costOf → unpriced
+    },
+    llm: {
+        "openai/gpt-4.1-mini": {
+            usdPer1MInputTokens: 0.4,
+            usdPer1MOutputTokens: 1.6,
+            usdPer1MCachedInputTokens: 0.1,
+        },
+        "local/llm": {
+            usdPer1MInputTokens: 0,
+            usdPer1MOutputTokens: 0,
+        },
+    },
+    tts: {
+        "cartesia/sonic-3": { usdPer1MCharacters: 50 },
+        "openai/gpt-4o-mini-tts": { usdPer1MCharacters: 0.6 },
+        "openai/tts-1": { usdPer1MCharacters: 15 },
+        "deepgram/aura-2-thalia-en": { usdPer1MCharacters: 30 },
+        // Gemini TTS preview models — Gemini API TTS text input list rate.
+        "gemini/gemini-3.1-flash-tts-preview": { usdPer1MCharacters: 0.5 },
+        "gemini/gemini-2.5-flash-preview-tts": { usdPer1MCharacters: 0.5 },
+        "gemini/gemini-2.5-pro-preview-tts": { usdPer1MCharacters: 0.5 },
+        // ElevenLabs public list — Flash/Turbo $0.05/1k, Multilingual $0.10/1k.
+        "elevenlabs/eleven_flash_v2_5": { usdPer1MCharacters: 50 },
+        "elevenlabs/eleven_flash_v2": { usdPer1MCharacters: 50 },
+        "elevenlabs/eleven_turbo_v2_5": { usdPer1MCharacters: 50 },
+        "elevenlabs/eleven_turbo_v2": { usdPer1MCharacters: 50 },
+        "elevenlabs/eleven_multilingual_v2": { usdPer1MCharacters: 100 },
+        "local/tts": { usdPer1MCharacters: 0 },
+        // grok/* voice keys + epsilon/epsilon-tts: no public list — omit → unpriced
+    },
+};
+export function costOf(usage, catalog) {
+    const key = catalogKey(usage.provider, usage.model);
+    if (!key)
+        return { usd: null, unpriced: true };
+    switch (usage.stage) {
+        case "stt": {
+            const price = catalog.stt[key];
+            if (!price)
+                return { usd: null, unpriced: true };
+            const seconds = usage.audioSeconds ?? 0;
+            return { usd: seconds * price.usdPerAudioSecond };
+        }
+        case "tts": {
+            const price = catalog.tts[key];
+            if (!price)
+                return { usd: null, unpriced: true };
+            const characters = usage.characters ?? 0;
+            return { usd: (characters / 1_000_000) * price.usdPer1MCharacters };
+        }
+        case "llm": {
+            const price = catalog.llm[key];
+            if (!price)
+                return { usd: null, unpriced: true };
+            const input = usage.inputTokens ?? 0;
+            const output = usage.outputTokens ?? 0;
+            const cached = usage.cachedInputTokens ?? 0;
+            const cachedRate = price.usdPer1MCachedInputTokens ?? price.usdPer1MInputTokens;
+            // Prefer charging cached tokens at the cached rate when present; non-cached input is the remainder.
+            const nonCachedInput = Math.max(0, input - cached);
+            const usd = (nonCachedInput / 1_000_000) * price.usdPer1MInputTokens +
+                (cached / 1_000_000) * cachedRate +
+                (output / 1_000_000) * price.usdPer1MOutputTokens;
+            return { usd };
+        }
+        default:
+            return { usd: null, unpriced: true };
+    }
+}
+//# sourceMappingURL=pricing.js.map

package/dist/pricing.js.map

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

package/dist/primary-speaker-fixtures.d.ts

@@ -0,0 +1,12 @@
+export declare function synthesizeTonePcm16(options: {
+    frequencyHz: number;
+    durationMs: number;
+    sampleRateHz?: number;
+    amplitude?: number;
+    phaseRad?: number;
+}): Uint8Array;
+export declare function mixPcm16(chunks: Uint8Array[], weights: number[]): Uint8Array;
+export declare const PRIMARY_SPEAKER_TONE_HZ = 280;
+export declare const BYSTANDER_SPEAKER_TONE_HZ = 2100;
+export declare const ASSISTANT_ECHO_TONE_HZ = 520;
+//# sourceMappingURL=primary-speaker-fixtures.d.ts.map

package/dist/primary-speaker-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primary-speaker-fixtures.d.ts","sourceRoot":"","sources":["../src/primary-speaker-fixtures.ts"],"names":[],"mappings":"AAMA,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,UAAU,CAYb;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU,CAc5E;AAED,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAC9C,eAAO,MAAM,sBAAsB,MAAM,CAAC"}

package/dist/primary-speaker-fixtures.js

@@ -0,0 +1,37 @@
+// SPDX-License-Identifier: MIT
+//
+// Synthetic PCM fixtures for primary-speaker gate tests.
+import { pcm16BytesToSamples, pcm16SamplesToBytes } from "./audio/pcm.js";
+export function synthesizeTonePcm16(options) {
+    const sampleRateHz = options.sampleRateHz ?? 16000;
+    const amplitude = options.amplitude ?? 0.35;
+    const phaseRad = options.phaseRad ?? 0;
+    const sampleCount = Math.max(1, Math.round((options.durationMs * sampleRateHz) / 1000));
+    const samples = new Int16Array(sampleCount);
+    const omega = (2 * Math.PI * options.frequencyHz) / sampleRateHz;
+    for (let i = 0; i < sampleCount; i += 1) {
+        const value = Math.sin(omega * i + phaseRad) * amplitude * 32767;
+        samples[i] = Math.max(-32768, Math.min(32767, Math.round(value)));
+    }
+    return pcm16SamplesToBytes(samples);
+}
+export function mixPcm16(chunks, weights) {
+    if (chunks.length === 0)
+        return new Uint8Array(0);
+    const maxLen = Math.max(...chunks.map((c) => c.byteLength));
+    const out = new Int16Array(maxLen / 2);
+    for (let c = 0; c < chunks.length; c += 1) {
+        const chunk = chunks[c];
+        const weight = weights[c] ?? 1;
+        const samples = pcm16BytesToSamples(chunk);
+        for (let i = 0; i < samples.length; i += 1) {
+            const mixed = (out[i] ?? 0) + samples[i] * weight;
+            out[i] = Math.max(-32768, Math.min(32767, Math.round(mixed)));
+        }
+    }
+    return pcm16SamplesToBytes(out);
+}
+export const PRIMARY_SPEAKER_TONE_HZ = 280;
+export const BYSTANDER_SPEAKER_TONE_HZ = 2100;
+export const ASSISTANT_ECHO_TONE_HZ = 520;
+//# sourceMappingURL=primary-speaker-fixtures.js.map

package/dist/primary-speaker-fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primary-speaker-fixtures.js","sourceRoot":"","sources":["../src/primary-speaker-fixtures.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,yDAAyD;AAEzD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1E,MAAM,UAAU,mBAAmB,CAAC,OAMnC;IACC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC;IACnD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;IAC5C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;IACvC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,UAAU,GAAG,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACxF,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,YAAY,CAAC;IACjE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,SAAS,GAAG,KAAK,CAAC;QACjE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAoB,EAAE,OAAiB;IAC9D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAC5D,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;QACzB,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAE,GAAG,MAAM,CAAC;YACnD,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IACD,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAC3C,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC;AAC9C,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC"}

package/dist/primary-speaker-gate.d.ts

@@ -0,0 +1,42 @@
+export interface SpeakerFingerprint {
+    readonly bands: readonly number[];
+    readonly rms: number;
+    readonly zcr: number;
+}
+export interface PrimarySpeakerGateConfig {
+    readonly enabled?: boolean;
+    readonly similarityThreshold?: number;
+    readonly echoDominanceMargin?: number;
+    readonly onDecision?: (decision: PrimarySpeakerGateDecision) => void;
+}
+export interface PrimarySpeakerGateDecision {
+    readonly contextId: string;
+    readonly signal: "primary_speaker" | "echo_rejected";
+    readonly accepted: boolean;
+    readonly frameCount: number;
+    readonly primaryHits: number;
+    readonly echoRejectedFrames: number;
+}
+export declare class PrimarySpeakerGate {
+    private readonly enabled;
+    private readonly similarityThreshold;
+    private readonly echoDominanceMargin;
+    private readonly onDecision?;
+    private profile;
+    private enrollFrames;
+    private bargeInFrames;
+    private assistantProfile;
+    constructor(config?: PrimarySpeakerGateConfig);
+    isEnabled(): boolean;
+    hasProfile(): boolean;
+    enrollUserTurnChunk(pcm: Uint8Array): void;
+    lockProfileFromFirstTurn(): void;
+    beginBargeInWindow(): void;
+    observeBargeInChunk(pcm: Uint8Array): void;
+    observeAssistantPlayout(pcm: Uint8Array): void;
+    shouldCommitBargeIn(contextId?: string): boolean;
+    resetBargeInWindow(): void;
+}
+export declare function extractSpeakerFingerprint(pcm: Uint8Array): SpeakerFingerprint | null;
+export declare function fingerprintSimilarity(a: SpeakerFingerprint, b: SpeakerFingerprint): number;
+//# sourceMappingURL=primary-speaker-gate.d.ts.map

package/dist/primary-speaker-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primary-speaker-gate.d.ts","sourceRoot":"","sources":["../src/primary-speaker-gate.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,0BAA0B,KAAK,IAAI,CAAC;CACtE;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,eAAe,CAAC;IACrD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAyC;IACrE,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,gBAAgB,CAAmC;gBAE/C,MAAM,GAAE,wBAA6B;IAOjD,SAAS,IAAI,OAAO;IAIpB,UAAU,IAAI,OAAO;IAIrB,mBAAmB,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAM1C,wBAAwB,IAAI,IAAI;IAMhC,kBAAkB,IAAI,IAAI;IAI1B,mBAAmB,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAM1C,uBAAuB,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAO9C,mBAAmB,CAAC,SAAS,SAAK,GAAG,OAAO;IA0B5C,kBAAkB,IAAI,IAAI;CAG3B;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,UAAU,GAAG,kBAAkB,GAAG,IAAI,CA6BpF;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAmB1F"}

package/dist/primary-speaker-gate.js

@@ -0,0 +1,178 @@
+// SPDX-License-Identifier: MIT
+//
+// VE-02 / G23 — lightweight primary-speaker gate for barge-in (FireRedChat pVAD direction).
+// Locks a spectral fingerprint from the first user turn; gates sustained barge-in on match.
+import { pcm16BytesToSamples } from "./audio/pcm.js";
+const SAMPLE_RATE_HZ = 16000;
+const MIN_SAMPLES = 320;
+const BAND_HZ = [150, 300, 600, 1200, 2400, 4800];
+export class PrimarySpeakerGate {
+    enabled;
+    similarityThreshold;
+    echoDominanceMargin;
+    onDecision;
+    profile = null;
+    enrollFrames = [];
+    bargeInFrames = [];
+    assistantProfile = null;
+    constructor(config = {}) {
+        this.enabled = config.enabled !== false;
+        this.similarityThreshold = config.similarityThreshold ?? 0.72;
+        this.echoDominanceMargin = config.echoDominanceMargin ?? 0.12;
+        this.onDecision = config.onDecision;
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    hasProfile() {
+        return this.profile !== null;
+    }
+    enrollUserTurnChunk(pcm) {
+        if (!this.enabled || this.profile !== null)
+            return;
+        const frame = extractSpeakerFingerprint(pcm);
+        if (frame)
+            this.enrollFrames.push(frame);
+    }
+    lockProfileFromFirstTurn() {
+        if (!this.enabled || this.profile !== null || this.enrollFrames.length === 0)
+            return;
+        this.profile = averageFingerprints(this.enrollFrames);
+        this.enrollFrames = [];
+    }
+    beginBargeInWindow() {
+        this.bargeInFrames = [];
+    }
+    observeBargeInChunk(pcm) {
+        if (!this.enabled)
+            return;
+        const frame = extractSpeakerFingerprint(pcm);
+        if (frame)
+            this.bargeInFrames.push(frame);
+    }
+    observeAssistantPlayout(pcm) {
+        if (!this.enabled)
+            return;
+        const frame = extractSpeakerFingerprint(pcm);
+        if (!frame)
+            return;
+        this.assistantProfile = frame;
+    }
+    shouldCommitBargeIn(contextId = "") {
+        if (!this.enabled || this.profile === null)
+            return true;
+        if (this.bargeInFrames.length === 0)
+            return false;
+        let primaryHits = 0;
+        let echoRejectedFrames = 0;
+        for (const frame of this.bargeInFrames) {
+            const primarySim = fingerprintSimilarity(frame, this.profile);
+            if (this.assistantProfile !== null) {
+                const echoSim = fingerprintSimilarity(frame, this.assistantProfile);
+                if (echoSim >= primarySim + this.echoDominanceMargin) {
+                    echoRejectedFrames += 1;
+                    continue;
+                }
+            }
+            if (primarySim >= this.similarityThreshold)
+                primaryHits += 1;
+        }
+        const required = Math.max(1, Math.ceil(this.bargeInFrames.length * 0.45));
+        const accepted = primaryHits >= required;
+        const decision = { contextId, accepted, frameCount: this.bargeInFrames.length, primaryHits, echoRejectedFrames };
+        if (echoRejectedFrames > 0)
+            this.onDecision?.({ signal: "echo_rejected", ...decision });
+        this.onDecision?.({ signal: "primary_speaker", ...decision });
+        return accepted;
+    }
+    resetBargeInWindow() {
+        this.bargeInFrames = [];
+    }
+}
+export function extractSpeakerFingerprint(pcm) {
+    if (pcm.byteLength < MIN_SAMPLES * 2)
+        return null;
+    let samples;
+    try {
+        samples = pcm16BytesToSamples(pcm);
+    }
+    catch {
+        return null;
+    }
+    if (samples.length < MIN_SAMPLES)
+        return null;
+    const window = samples.length > 512 ? samples.subarray(0, 512) : samples;
+    const bands = BAND_HZ.map((hz) => goertzelMagnitude(window, hz, SAMPLE_RATE_HZ));
+    const maxBand = Math.max(...bands, 1e-9);
+    const normalizedBands = bands.map((b) => b / maxBand);
+    let sumSq = 0;
+    let crossings = 0;
+    let prev = window[0] >= 0;
+    for (let i = 0; i < window.length; i += 1) {
+        const s = window[i];
+        sumSq += s * s;
+        const positive = s >= 0;
+        if (i > 0 && positive !== prev)
+            crossings += 1;
+        prev = positive;
+    }
+    const rms = Math.sqrt(sumSq / window.length) / 32768;
+    const zcr = crossings / window.length;
+    return { bands: normalizedBands, rms, zcr };
+}
+export function fingerprintSimilarity(a, b) {
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.bands.length; i += 1) {
+        const av = a.bands[i] ?? 0;
+        const bv = b.bands[i] ?? 0;
+        dot += av * bv;
+        normA += av * av;
+        normB += bv * bv;
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    if (denom <= 0)
+        return 0;
+    const spectral = dot / denom;
+    const rmsDelta = Math.abs(a.rms - b.rms);
+    const zcrDelta = Math.abs(a.zcr - b.zcr);
+    const timbrePenalty = Math.min(1, rmsDelta * 4 + zcrDelta * 2);
+    return Math.max(0, spectral * (1 - timbrePenalty * 0.35));
+}
+function averageFingerprints(frames) {
+    const bandCount = frames[0].bands.length;
+    const bands = new Array(bandCount).fill(0);
+    let rms = 0;
+    let zcr = 0;
+    for (const frame of frames) {
+        rms += frame.rms;
+        zcr += frame.zcr;
+        for (let i = 0; i < bandCount; i += 1) {
+            bands[i] = (bands[i] ?? 0) + (frame.bands[i] ?? 0);
+        }
+    }
+    const n = frames.length;
+    return {
+        bands: bands.map((b) => b / n),
+        rms: rms / n,
+        zcr: zcr / n,
+    };
+}
+function goertzelMagnitude(samples, targetHz, sampleRateHz) {
+    const omega = (2 * Math.PI * targetHz) / sampleRateHz;
+    const coeff = 2 * Math.cos(omega);
+    let s0 = 0;
+    let s1 = 0;
+    let s2 = 0;
+    for (let i = 0; i < samples.length; i += 1) {
+        const x = samples[i] / 32768;
+        s0 = x + coeff * s1 - s2;
+        s2 = s1;
+        s1 = s0;
+    }
+    const real = s1 - s2 * Math.cos(omega);
+    const imag = s2 * Math.sin(omega);
+    return Math.sqrt(real * real + imag * imag);
+}
+//# sourceMappingURL=primary-speaker-gate.js.map

package/dist/primary-speaker-gate.js.map

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

package/dist/provider-fallback.d.ts

@@ -0,0 +1,28 @@
+import { type PipelineBus } from "./pipeline-bus.js";
+import { type Scheduler } from "./scheduler.js";
+export interface FallbackProvider<TReq, TResp> {
+    readonly id: string;
+    send(req: TReq, signal: AbortSignal): Promise<TResp>;
+    healthProbe(signal: AbortSignal): Promise<boolean>;
+}
+export interface ProviderFallbackOptions {
+    readonly bus: PipelineBus;
+    readonly contextId: string;
+    readonly attemptTimeoutMs: number;
+    readonly recoveryProbeIntervalMs: number;
+    readonly scheduler?: Scheduler;
+}
+export declare class ProviderFallback<TReq, TResp> {
+    private readonly providers;
+    private readonly opts;
+    private readonly unavailable;
+    private readonly recoveryTimers;
+    private readonly scheduler;
+    constructor(providers: readonly FallbackProvider<TReq, TResp>[], opts: ProviderFallbackOptions);
+    send(req: TReq): Promise<TResp>;
+    close(): void;
+    private markUnavailable;
+    private scheduleRecoveryProbe;
+    private metric;
+}
+//# sourceMappingURL=provider-fallback.d.ts.map

package/dist/provider-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-fallback.d.ts","sourceRoot":"","sources":["../src/provider-fallback.ts"],"names":[],"mappings":"AAEA,OAAO,EAAS,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhE,MAAM,WAAW,gBAAgB,CAAC,IAAI,EAAE,KAAK;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACrD,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;CAChC;AAED,qBAAa,gBAAgB,CAAC,IAAI,EAAE,KAAK;IAMrC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI;IANvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAGnB,SAAS,EAAE,SAAS,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EACnD,IAAI,EAAE,uBAAuB;IAK1C,IAAI,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC;IAcrC,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,qBAAqB;IAoB7B,OAAO,CAAC,MAAM;CAGf"}