@glassly/engine 0.1.0-dev.0

package/build/services/soniox/SonioxDirectService.d.ts

@@ -0,0 +1,109 @@
+/**
+ * SonioxDirectService
+ *
+ * Phone → Soniox direct transcription with a user-supplied API key
+ * (Settings > Keys). Enabled iff the `soniox_api_key` setting is non-empty.
+ *
+ * While enabled, LocalMiniappRuntime routes transcription/translation
+ * subscriptions HERE instead of to the cloud (and pushes an empty cloud
+ * subscription set, which also silences the LC3 audio uplink) — audio for
+ * transcription never touches the Glassly cloud. This service opens one
+ * Soniox realtime WebSocket session per subscription, feeds it decoded PCM
+ * from the glasses mic (`mic_pcm`), assembles tokens into utterances, and
+ * emits the same TranscriptionData / TranslationData shapes the cloud client
+ * emits so the miniapp fan-out is provider-agnostic.
+ *
+ * Failure policy (per product decision): a failing key degrades to on-device
+ * sherpa STT via LocalSttFallbackCoordinator — never back to the cloud.
+ * Reconnect semantics mirror the cloud provider: transient errors back off
+ * 500ms → 8s for 10 attempts, billing/auth (non-transient) errors retry on a
+ * slow 60s cadence forever; after transient attempts are exhausted the slow
+ * cadence takes over too (the phone has no worker-recreate path of last
+ * resort, so it must self-recover).
+ */
+import type { AudioSubscription, TranscriptionData, TranslationData } from "@glassly/cloud-protocol";
+import { SonioxRealtimeClient, type SonioxSessionOptions } from "./SonioxRealtimeClient";
+export type SonioxDirectState = "inactive" | "connecting" | "active" | "error";
+export type SonioxDirectErrorKind = "invalid_key" | "quota" | "unreachable";
+export interface SonioxDirectStatus {
+    enabled: boolean;
+    state: SonioxDirectState;
+    errorKind?: SonioxDirectErrorKind;
+    lastErrorAt?: number;
+}
+declare class SonioxDirectService {
+    private static instance;
+    private started;
+    private apiKey;
+    private desiredSubs;
+    private transcriptionHints;
+    private slots;
+    private micSub;
+    private unsubscribeSettings;
+    private transcriptListeners;
+    private translationListeners;
+    private statusListeners;
+    private lastStatus;
+    private lastErrorAt;
+    private constructor();
+    /** Test seam: swap the realtime-client constructor (bun module mocks leak
+     *  across test files, so injection beats mock.module here). */
+    private clientFactory;
+    setClientFactoryForTests(factory: ((opts: SonioxSessionOptions) => SonioxRealtimeClient) | null): void;
+    static getInstance(): SonioxDirectService;
+    start(): void;
+    stop(): void;
+    private readApiKey;
+    isEnabled(): boolean;
+    /**
+     * Whether the primary (Soniox-direct) transcription path is believed usable.
+     * False once any desired session has failed and none are open — that is the
+     * signal for the sherpa fallback. While disabled this is vacuously true
+     * (callers should gate on isEnabled()).
+     */
+    isHealthy(): boolean;
+    getStatus(): SonioxDirectStatus;
+    onTranscript(cb: (d: TranscriptionData) => void): () => void;
+    onTranslation(cb: (d: TranslationData) => void): () => void;
+    onStatusChanged(cb: (s: SonioxDirectStatus) => void): () => void;
+    /** Registered by LocalMiniappRuntime; invoked when enablement flips so the
+     *  runtime re-partitions subscriptions between cloud and direct. A callback
+     *  (not an import) to avoid a service import cycle. */
+    private routingChangedListener;
+    setRoutingChangedListener(cb: (() => void) | null): void;
+    /**
+     * The full transcription/translation subscription set this service should
+     * serve (same AudioSubscription[] the cloud would otherwise get), plus the
+     * union of auto-mode detection hints. Called by LocalMiniappRuntime on every
+     * subscription recompute; an empty array tears everything down.
+     */
+    setDesiredSubscriptions(subs: AudioSubscription[], transcriptionHints?: string[]): void;
+    validateApiKey(key: string): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        reason: "invalid_key" | "network";
+    }>;
+    private subKey;
+    private reconcile;
+    private createSlot;
+    private connectSlot;
+    private handleSlotError;
+    private handleSlotClosed;
+    private scheduleReconnect;
+    private teardownSlot;
+    private teardownAllSlots;
+    private syncMicListener;
+    /**
+     * Map an assembled utterance to the cloud wire shapes. Language resolution
+     * mirrors cloud result.ts: a specific-language subscription's code WINS over
+     * the provider-detected code (miniapp handlers key on the exact stream, and
+     * Soniox reports bare ISO codes while subscriptions carry BCP-47 tags).
+     */
+    private deliver;
+    private computeStatus;
+    private publishStatus;
+}
+declare const sonioxDirectService: SonioxDirectService;
+export default sonioxDirectService;
+//# sourceMappingURL=SonioxDirectService.d.ts.map

package/build/services/soniox/SonioxDirectService.d.ts.map

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

package/build/services/soniox/SonioxDirectService.js

@@ -0,0 +1,449 @@
+/**
+ * SonioxDirectService
+ *
+ * Phone → Soniox direct transcription with a user-supplied API key
+ * (Settings > Keys). Enabled iff the `soniox_api_key` setting is non-empty.
+ *
+ * While enabled, LocalMiniappRuntime routes transcription/translation
+ * subscriptions HERE instead of to the cloud (and pushes an empty cloud
+ * subscription set, which also silences the LC3 audio uplink) — audio for
+ * transcription never touches the Glassly cloud. This service opens one
+ * Soniox realtime WebSocket session per subscription, feeds it decoded PCM
+ * from the glasses mic (`mic_pcm`), assembles tokens into utterances, and
+ * emits the same TranscriptionData / TranslationData shapes the cloud client
+ * emits so the miniapp fan-out is provider-agnostic.
+ *
+ * Failure policy (per product decision): a failing key degrades to on-device
+ * sherpa STT via LocalSttFallbackCoordinator — never back to the cloud.
+ * Reconnect semantics mirror the cloud provider: transient errors back off
+ * 500ms → 8s for 10 attempts, billing/auth (non-transient) errors retry on a
+ * slow 60s cadence forever; after transient attempts are exhausted the slow
+ * cadence takes over too (the phone has no worker-recreate path of last
+ * resort, so it must self-recover).
+ */
+import BluetoothSdk from "@glassly/bluetooth-sdk/internal";
+import { SETTINGS, useSettingsStore } from "../../stores/settings";
+import { BgTimer } from "../../utils/timers";
+import localSttFallbackCoordinator from "../LocalSttFallbackCoordinator";
+import { SonioxRealtimeClient, validateSonioxApiKey, } from "./SonioxRealtimeClient";
+import { SonioxTokenAssembler } from "./SonioxTokenAssembler";
+const LOG_TAG = "SONIOX_DIRECT";
+const RECONNECT_BASE_MS = 500;
+const RECONNECT_MAX_MS = 8_000;
+const RECONNECT_MAX_ATTEMPTS = 10;
+const NON_TRANSIENT_RETRY_MS = 60_000;
+function subLanguage(sub) {
+    const source = sub.kind === "transcription" ? sub.language : sub.source;
+    if (source.mode === "specific")
+        return { language: source.code };
+    return { language: "auto", hints: source.hints };
+}
+function classifyError(err) {
+    if (err.code === 401 || err.code === 403)
+        return "invalid_key";
+    if (err.code === 402 || err.code === 429 || err.code === "quota_exceeded")
+        return "quota";
+    return "unreachable";
+}
+class SonioxDirectService {
+    static instance = null;
+    started = false;
+    apiKey = "";
+    desiredSubs = [];
+    transcriptionHints = [];
+    slots = new Map();
+    micSub = null;
+    unsubscribeSettings = null;
+    transcriptListeners = new Set();
+    translationListeners = new Set();
+    statusListeners = new Set();
+    lastStatus = { enabled: false, state: "inactive" };
+    lastErrorAt;
+    constructor() { }
+    /** Test seam: swap the realtime-client constructor (bun module mocks leak
+     *  across test files, so injection beats mock.module here). */
+    clientFactory = (opts) => new SonioxRealtimeClient(opts);
+    setClientFactoryForTests(factory) {
+        this.clientFactory = factory ?? ((opts) => new SonioxRealtimeClient(opts));
+    }
+    static getInstance() {
+        if (!SonioxDirectService.instance) {
+            SonioxDirectService.instance = new SonioxDirectService();
+        }
+        return SonioxDirectService.instance;
+    }
+    // ===========================================================================
+    // Lifecycle
+    // ===========================================================================
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        this.apiKey = this.readApiKey();
+        this.unsubscribeSettings = useSettingsStore.subscribe((s) => s.settings[SETTINGS.soniox_api_key.key], () => {
+            const next = this.readApiKey();
+            if (next === this.apiKey)
+                return;
+            const enabledChanged = !!next !== !!this.apiKey;
+            this.apiKey = next;
+            console.log(`${LOG_TAG}: api key ${next ? "set" : "cleared"}`);
+            // Existing sessions carry the old key in their config; rebuild.
+            this.teardownAllSlots();
+            this.reconcile();
+            if (enabledChanged) {
+                // Subscriptions must move between cloud and direct; the runtime
+                // re-partitions and calls setDesiredSubscriptions back into us.
+                this.routingChangedListener?.();
+            }
+        });
+        this.reconcile();
+    }
+    stop() {
+        if (!this.started)
+            return;
+        this.started = false;
+        this.unsubscribeSettings?.();
+        this.unsubscribeSettings = null;
+        this.teardownAllSlots();
+        this.reconcile();
+    }
+    readApiKey() {
+        const raw = useSettingsStore.getState().getSetting(SETTINGS.soniox_api_key.key);
+        return typeof raw === "string" ? raw.trim() : "";
+    }
+    // ===========================================================================
+    // Public surface
+    // ===========================================================================
+    isEnabled() {
+        return this.started && this.apiKey.length > 0;
+    }
+    /**
+     * Whether the primary (Soniox-direct) transcription path is believed usable.
+     * False once any desired session has failed and none are open — that is the
+     * signal for the sherpa fallback. While disabled this is vacuously true
+     * (callers should gate on isEnabled()).
+     */
+    isHealthy() {
+        if (!this.isEnabled())
+            return true;
+        if (this.slots.size === 0)
+            return true;
+        let anyOpen = false;
+        let anyFailed = false;
+        for (const slot of this.slots.values()) {
+            if (slot.open)
+                anyOpen = true;
+            if (slot.failed)
+                anyFailed = true;
+        }
+        return anyOpen || !anyFailed;
+    }
+    getStatus() {
+        return this.lastStatus;
+    }
+    onTranscript(cb) {
+        this.transcriptListeners.add(cb);
+        return () => this.transcriptListeners.delete(cb);
+    }
+    onTranslation(cb) {
+        this.translationListeners.add(cb);
+        return () => this.translationListeners.delete(cb);
+    }
+    onStatusChanged(cb) {
+        this.statusListeners.add(cb);
+        return () => this.statusListeners.delete(cb);
+    }
+    /** Registered by LocalMiniappRuntime; invoked when enablement flips so the
+     *  runtime re-partitions subscriptions between cloud and direct. A callback
+     *  (not an import) to avoid a service import cycle. */
+    routingChangedListener = null;
+    setRoutingChangedListener(cb) {
+        this.routingChangedListener = cb;
+    }
+    /**
+     * The full transcription/translation subscription set this service should
+     * serve (same AudioSubscription[] the cloud would otherwise get), plus the
+     * union of auto-mode detection hints. Called by LocalMiniappRuntime on every
+     * subscription recompute; an empty array tears everything down.
+     */
+    setDesiredSubscriptions(subs, transcriptionHints = []) {
+        this.desiredSubs = subs;
+        this.transcriptionHints = transcriptionHints;
+        this.reconcile();
+    }
+    validateApiKey(key) {
+        return validateSonioxApiKey(key.trim());
+    }
+    // ===========================================================================
+    // Session reconciliation
+    // ===========================================================================
+    subKey(sub) {
+        return sub.kind === "transcription"
+            ? `tx:${JSON.stringify(sub.language)}`
+            : `tr:${JSON.stringify(sub.source)}:${sub.target}`;
+    }
+    reconcile() {
+        const desired = new Map();
+        if (this.isEnabled()) {
+            for (const sub of this.desiredSubs)
+                desired.set(this.subKey(sub), sub);
+        }
+        for (const [key, slot] of this.slots) {
+            if (!desired.has(key)) {
+                this.teardownSlot(slot);
+                this.slots.delete(key);
+            }
+        }
+        for (const [key, sub] of desired) {
+            if (!this.slots.has(key)) {
+                this.slots.set(key, this.createSlot(key, sub));
+            }
+        }
+        this.syncMicListener();
+        this.publishStatus();
+    }
+    createSlot(key, sub) {
+        const { language } = subLanguage(sub);
+        const isTranslation = sub.kind === "translation";
+        const slot = {
+            key,
+            sub,
+            client: null,
+            assembler: null,
+            open: false,
+            failed: false,
+            attempts: 0,
+            nonTransient: false,
+            retryTimer: null,
+        };
+        slot.assembler = new SonioxTokenAssembler({
+            scope: key,
+            isTranslation,
+            fallbackLanguage: language === "auto" ? undefined : language,
+            onTranscript: (t) => this.deliver(slot, t),
+        });
+        this.connectSlot(slot);
+        return slot;
+    }
+    connectSlot(slot) {
+        const { language, hints } = subLanguage(slot.sub);
+        const client = this.clientFactory({
+            apiKey: this.apiKey,
+            language,
+            languageHints: hints ?? (language === "auto" ? this.transcriptionHints : undefined),
+            targetLanguage: slot.sub.kind === "translation" ? slot.sub.target : undefined,
+            onOpen: () => {
+                slot.open = true;
+                slot.failed = false;
+                slot.attempts = 0;
+                slot.nonTransient = false;
+                slot.errorKind = undefined;
+                console.log(`${LOG_TAG}: session open ${slot.key}`);
+                this.publishStatus();
+            },
+            onResult: (result) => slot.assembler.handleResult(result),
+            onEndpoint: () => slot.assembler.handleEndpoint(),
+            onFinalized: () => slot.assembler.handleFinalized(),
+            onError: (err) => this.handleSlotError(slot, err),
+            onClose: () => this.handleSlotClosed(slot),
+        });
+        slot.client = client;
+        client.connect();
+    }
+    handleSlotError(slot, err) {
+        if (!this.slots.has(slot.key))
+            return;
+        slot.errorKind = classifyError(err);
+        slot.nonTransient = err.nonTransient;
+        this.lastErrorAt = Date.now();
+        console.warn(`${LOG_TAG}: session error ${slot.key} code=${err.code ?? "?"} ${err.message}`);
+        // A server-side error message usually precedes the socket dying; close
+        // proactively (close() suppresses the client's own onClose callback) and
+        // drive the retry from here.
+        slot.client?.close();
+        this.scheduleReconnect(slot);
+    }
+    handleSlotClosed(slot) {
+        if (!this.slots.has(slot.key))
+            return;
+        this.scheduleReconnect(slot);
+    }
+    scheduleReconnect(slot) {
+        if (slot.retryTimer !== null)
+            return;
+        slot.open = false;
+        slot.failed = true;
+        slot.client = null;
+        let delay;
+        if (slot.nonTransient) {
+            slot.attempts = 0;
+            delay = NON_TRANSIENT_RETRY_MS;
+        }
+        else {
+            slot.attempts += 1;
+            if (slot.attempts > RECONNECT_MAX_ATTEMPTS) {
+                // Unlike the cloud worker (whose detach/attach recreates providers),
+                // nothing else will ever rebuild these sessions — fall back to the
+                // slow cadence instead of giving up outright.
+                delay = NON_TRANSIENT_RETRY_MS;
+            }
+            else {
+                delay = Math.min(RECONNECT_MAX_MS, RECONNECT_BASE_MS * 2 ** (slot.attempts - 1));
+            }
+        }
+        console.log(`${LOG_TAG}: reconnect ${slot.key} attempt=${slot.attempts} delayMs=${delay}`);
+        this.publishStatus();
+        slot.retryTimer = BgTimer.setTimeout(() => {
+            slot.retryTimer = null;
+            if (!this.slots.has(slot.key) || !this.isEnabled())
+                return;
+            this.connectSlot(slot);
+        }, delay);
+    }
+    teardownSlot(slot) {
+        if (slot.retryTimer !== null) {
+            BgTimer.clearTimeout(slot.retryTimer);
+            slot.retryTimer = null;
+        }
+        // Flush the in-flight utterance so a mid-update caption commits rather
+        // than dangling (mirrors the cloud provider's close()).
+        try {
+            slot.assembler.flush();
+        }
+        catch {
+            /* best-effort */
+        }
+        slot.client?.close();
+        slot.client = null;
+        slot.open = false;
+    }
+    teardownAllSlots() {
+        for (const slot of this.slots.values())
+            this.teardownSlot(slot);
+        this.slots.clear();
+    }
+    // ===========================================================================
+    // Audio feed
+    // ===========================================================================
+    syncMicListener() {
+        const wantMic = this.slots.size > 0;
+        if (wantMic && !this.micSub) {
+            this.micSub = BluetoothSdk.addListener("mic_pcm", (event) => {
+                if (!event?.pcm)
+                    return;
+                for (const slot of this.slots.values()) {
+                    slot.client?.sendAudio(event.pcm);
+                }
+            });
+        }
+        else if (!wantMic && this.micSub) {
+            this.micSub.remove();
+            this.micSub = null;
+        }
+    }
+    // ===========================================================================
+    // Transcript delivery
+    // ===========================================================================
+    /**
+     * Map an assembled utterance to the cloud wire shapes. Language resolution
+     * mirrors cloud result.ts: a specific-language subscription's code WINS over
+     * the provider-detected code (miniapp handlers key on the exact stream, and
+     * Soniox reports bare ISO codes while subscriptions carry BCP-47 tags).
+     */
+    deliver(slot, t) {
+        const timestamp = Date.now();
+        const startMs = t.startMs ?? 0;
+        const endMs = t.endMs ?? 0;
+        const durationMs = t.startMs != null && t.endMs != null ? t.endMs - t.startMs : undefined;
+        if (slot.sub.kind === "translation") {
+            const source = slot.sub.source;
+            const resolved = source.mode === "specific"
+                ? { language: source.code, detected: false }
+                : { language: t.sourceLanguage ?? "auto", detected: true };
+            const data = {
+                userId: "local",
+                subscription: slot.sub,
+                text: t.text,
+                originalText: t.originalText,
+                isFinal: t.isFinal,
+                utteranceId: t.utteranceId,
+                speakerId: t.speakerId,
+                startMs,
+                endMs,
+                durationMs,
+                source: { language: resolved.language, detected: resolved.detected },
+                target: { language: slot.sub.target },
+                provider: "soniox-direct",
+                timestamp,
+            };
+            for (const cb of this.translationListeners)
+                cb(data);
+            return;
+        }
+        const source = slot.sub.language;
+        const resolved = source.mode === "specific"
+            ? { language: source.code, detected: false }
+            : { language: t.language ?? "auto", detected: true };
+        const data = {
+            userId: "local",
+            subscription: slot.sub,
+            text: t.text,
+            isFinal: t.isFinal,
+            utteranceId: t.utteranceId,
+            speakerId: t.speakerId,
+            startMs,
+            endMs,
+            durationMs,
+            resolvedLanguage: resolved.language,
+            languageDetected: resolved.detected,
+            tokens: [],
+            provider: "soniox-direct",
+            timestamp,
+        };
+        for (const cb of this.transcriptListeners)
+            cb(data);
+    }
+    // ===========================================================================
+    // Status
+    // ===========================================================================
+    computeStatus() {
+        const enabled = this.isEnabled();
+        if (!enabled)
+            return { enabled: false, state: "inactive" };
+        if (this.slots.size === 0)
+            return { enabled: true, state: "inactive" };
+        let anyOpen = false;
+        let errorKind;
+        let anyFailed = false;
+        for (const slot of this.slots.values()) {
+            if (slot.open)
+                anyOpen = true;
+            if (slot.failed)
+                anyFailed = true;
+            // invalid_key > quota > unreachable, so the UI surfaces the actionable one.
+            if (slot.errorKind === "invalid_key" || (slot.errorKind && errorKind !== "invalid_key")) {
+                errorKind = errorKind === "quota" && slot.errorKind === "unreachable" ? errorKind : slot.errorKind;
+            }
+        }
+        if (anyOpen)
+            return { enabled: true, state: "active" };
+        if (anyFailed)
+            return { enabled: true, state: "error", errorKind, lastErrorAt: this.lastErrorAt };
+        return { enabled: true, state: "connecting" };
+    }
+    publishStatus() {
+        const next = this.computeStatus();
+        const prev = this.lastStatus;
+        const changed = next.enabled !== prev.enabled || next.state !== prev.state || next.errorKind !== prev.errorKind;
+        this.lastStatus = next;
+        if (!changed)
+            return;
+        console.log(`${LOG_TAG}: status -> ${next.state}${next.errorKind ? ` (${next.errorKind})` : ""}`);
+        localSttFallbackCoordinator.onSonioxDirectStateChange(this.isEnabled(), this.isHealthy());
+        for (const cb of this.statusListeners)
+            cb(next);
+    }
+}
+const sonioxDirectService = SonioxDirectService.getInstance();
+export default sonioxDirectService;
+//# sourceMappingURL=SonioxDirectService.js.map

package/build/services/soniox/SonioxDirectService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SonioxDirectService.js","sourceRoot":"","sources":["../../../src/services/soniox/SonioxDirectService.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SonioxDirectService\n *\n * Phone → Soniox direct transcription with a user-supplied API key\n * (Settings > Keys). Enabled iff the `soniox_api_key` setting is non-empty.\n *\n * While enabled, LocalMiniappRuntime routes transcription/translation\n * subscriptions HERE instead of to the cloud (and pushes an empty cloud\n * subscription set, which also silences the LC3 audio uplink) — audio for\n * transcription never touches the Glassly cloud. This service opens one\n * Soniox realtime WebSocket session per subscription, feeds it decoded PCM\n * from the glasses mic (`mic_pcm`), assembles tokens into utterances, and\n * emits the same TranscriptionData / TranslationData shapes the cloud client\n * emits so the miniapp fan-out is provider-agnostic.\n *\n * Failure policy (per product decision): a failing key degrades to on-device\n * sherpa STT via LocalSttFallbackCoordinator — never back to the cloud.\n * Reconnect semantics mirror the cloud provider: transient errors back off\n * 500ms → 8s for 10 attempts, billing/auth (non-transient) errors retry on a\n * slow 60s cadence forever; after transient attempts are exhausted the slow\n * cadence takes over too (the phone has no worker-recreate path of last\n * resort, so it must self-recover).\n */\n\nimport BluetoothSdk from \"@glassly/bluetooth-sdk/internal\"\nimport type {AudioSubscription, TranscriptionData, TranslationData} from \"@glassly/cloud-protocol\"\n\nimport {SETTINGS, useSettingsStore} from \"../../stores/settings\"\nimport {BgTimer} from \"../../utils/timers\"\nimport localSttFallbackCoordinator from \"../LocalSttFallbackCoordinator\"\nimport {\n  SonioxClientError,\n  SonioxRealtimeClient,\n  validateSonioxApiKey,\n  type SonioxSessionOptions,\n} from \"./SonioxRealtimeClient\"\nimport {SonioxTokenAssembler} from \"./SonioxTokenAssembler\"\n\nconst LOG_TAG = \"SONIOX_DIRECT\"\n\nconst RECONNECT_BASE_MS = 500\nconst RECONNECT_MAX_MS = 8_000\nconst RECONNECT_MAX_ATTEMPTS = 10\nconst NON_TRANSIENT_RETRY_MS = 60_000\n\nexport type SonioxDirectState = \"inactive\" | \"connecting\" | \"active\" | \"error\"\nexport type SonioxDirectErrorKind = \"invalid_key\" | \"quota\" | \"unreachable\"\n\nexport interface SonioxDirectStatus {\n  enabled: boolean\n  state: SonioxDirectState\n  errorKind?: SonioxDirectErrorKind\n  lastErrorAt?: number\n}\n\ninterface SessionSlot {\n  key: string\n  sub: AudioSubscription\n  client: SonioxRealtimeClient | null\n  assembler: SonioxTokenAssembler\n  open: boolean\n  /** ≥1 failed connect/drop since the last successful open. */\n  failed: boolean\n  attempts: number\n  nonTransient: boolean\n  errorKind?: SonioxDirectErrorKind\n  retryTimer: number | null\n}\n\nfunction subLanguage(sub: AudioSubscription): {language: string; hints?: string[]} {\n  const source = sub.kind === \"transcription\" ? sub.language : sub.source\n  if (source.mode === \"specific\") return {language: source.code}\n  return {language: \"auto\", hints: source.hints}\n}\n\nfunction classifyError(err: SonioxClientError): SonioxDirectErrorKind {\n  if (err.code === 401 || err.code === 403) return \"invalid_key\"\n  if (err.code === 402 || err.code === 429 || err.code === \"quota_exceeded\") return \"quota\"\n  return \"unreachable\"\n}\n\nclass SonioxDirectService {\n  private static instance: SonioxDirectService | null = null\n\n  private started = false\n  private apiKey = \"\"\n  private desiredSubs: AudioSubscription[] = []\n  private transcriptionHints: string[] = []\n  private slots = new Map<string, SessionSlot>()\n\n  private micSub: {remove: () => void} | null = null\n  private unsubscribeSettings: (() => void) | null = null\n\n  private transcriptListeners = new Set<(d: TranscriptionData) => void>()\n  private translationListeners = new Set<(d: TranslationData) => void>()\n  private statusListeners = new Set<(s: SonioxDirectStatus) => void>()\n  private lastStatus: SonioxDirectStatus = {enabled: false, state: \"inactive\"}\n  private lastErrorAt: number | undefined\n\n  private constructor() {}\n\n  /** Test seam: swap the realtime-client constructor (bun module mocks leak\n   *  across test files, so injection beats mock.module here). */\n  private clientFactory: (opts: SonioxSessionOptions) => SonioxRealtimeClient = (opts) => new SonioxRealtimeClient(opts)\n  setClientFactoryForTests(factory: ((opts: SonioxSessionOptions) => SonioxRealtimeClient) | null): void {\n    this.clientFactory = factory ?? ((opts) => new SonioxRealtimeClient(opts))\n  }\n\n  static getInstance(): SonioxDirectService {\n    if (!SonioxDirectService.instance) {\n      SonioxDirectService.instance = new SonioxDirectService()\n    }\n    return SonioxDirectService.instance\n  }\n\n  // ===========================================================================\n  // Lifecycle\n  // ===========================================================================\n\n  start(): void {\n    if (this.started) return\n    this.started = true\n    this.apiKey = this.readApiKey()\n    this.unsubscribeSettings = useSettingsStore.subscribe(\n      (s) => s.settings[SETTINGS.soniox_api_key.key] as string | undefined,\n      () => {\n        const next = this.readApiKey()\n        if (next === this.apiKey) return\n        const enabledChanged = !!next !== !!this.apiKey\n        this.apiKey = next\n        console.log(`${LOG_TAG}: api key ${next ? \"set\" : \"cleared\"}`)\n        // Existing sessions carry the old key in their config; rebuild.\n        this.teardownAllSlots()\n        this.reconcile()\n        if (enabledChanged) {\n          // Subscriptions must move between cloud and direct; the runtime\n          // re-partitions and calls setDesiredSubscriptions back into us.\n          this.routingChangedListener?.()\n        }\n      },\n    )\n    this.reconcile()\n  }\n\n  stop(): void {\n    if (!this.started) return\n    this.started = false\n    this.unsubscribeSettings?.()\n    this.unsubscribeSettings = null\n    this.teardownAllSlots()\n    this.reconcile()\n  }\n\n  private readApiKey(): string {\n    const raw = useSettingsStore.getState().getSetting(SETTINGS.soniox_api_key.key)\n    return typeof raw === \"string\" ? raw.trim() : \"\"\n  }\n\n  // ===========================================================================\n  // Public surface\n  // ===========================================================================\n\n  isEnabled(): boolean {\n    return this.started && this.apiKey.length > 0\n  }\n\n  /**\n   * Whether the primary (Soniox-direct) transcription path is believed usable.\n   * False once any desired session has failed and none are open — that is the\n   * signal for the sherpa fallback. While disabled this is vacuously true\n   * (callers should gate on isEnabled()).\n   */\n  isHealthy(): boolean {\n    if (!this.isEnabled()) return true\n    if (this.slots.size === 0) return true\n    let anyOpen = false\n    let anyFailed = false\n    for (const slot of this.slots.values()) {\n      if (slot.open) anyOpen = true\n      if (slot.failed) anyFailed = true\n    }\n    return anyOpen || !anyFailed\n  }\n\n  getStatus(): SonioxDirectStatus {\n    return this.lastStatus\n  }\n\n  onTranscript(cb: (d: TranscriptionData) => void): () => void {\n    this.transcriptListeners.add(cb)\n    return () => this.transcriptListeners.delete(cb)\n  }\n\n  onTranslation(cb: (d: TranslationData) => void): () => void {\n    this.translationListeners.add(cb)\n    return () => this.translationListeners.delete(cb)\n  }\n\n  onStatusChanged(cb: (s: SonioxDirectStatus) => void): () => void {\n    this.statusListeners.add(cb)\n    return () => this.statusListeners.delete(cb)\n  }\n\n  /** Registered by LocalMiniappRuntime; invoked when enablement flips so the\n   *  runtime re-partitions subscriptions between cloud and direct. A callback\n   *  (not an import) to avoid a service import cycle. */\n  private routingChangedListener: (() => void) | null = null\n  setRoutingChangedListener(cb: (() => void) | null): void {\n    this.routingChangedListener = cb\n  }\n\n  /**\n   * The full transcription/translation subscription set this service should\n   * serve (same AudioSubscription[] the cloud would otherwise get), plus the\n   * union of auto-mode detection hints. Called by LocalMiniappRuntime on every\n   * subscription recompute; an empty array tears everything down.\n   */\n  setDesiredSubscriptions(subs: AudioSubscription[], transcriptionHints: string[] = []): void {\n    this.desiredSubs = subs\n    this.transcriptionHints = transcriptionHints\n    this.reconcile()\n  }\n\n  validateApiKey(key: string): Promise<{ok: true} | {ok: false; reason: \"invalid_key\" | \"network\"}> {\n    return validateSonioxApiKey(key.trim())\n  }\n\n  // ===========================================================================\n  // Session reconciliation\n  // ===========================================================================\n\n  private subKey(sub: AudioSubscription): string {\n    return sub.kind === \"transcription\"\n      ? `tx:${JSON.stringify(sub.language)}`\n      : `tr:${JSON.stringify(sub.source)}:${sub.target}`\n  }\n\n  private reconcile(): void {\n    const desired = new Map<string, AudioSubscription>()\n    if (this.isEnabled()) {\n      for (const sub of this.desiredSubs) desired.set(this.subKey(sub), sub)\n    }\n\n    for (const [key, slot] of this.slots) {\n      if (!desired.has(key)) {\n        this.teardownSlot(slot)\n        this.slots.delete(key)\n      }\n    }\n    for (const [key, sub] of desired) {\n      if (!this.slots.has(key)) {\n        this.slots.set(key, this.createSlot(key, sub))\n      }\n    }\n\n    this.syncMicListener()\n    this.publishStatus()\n  }\n\n  private createSlot(key: string, sub: AudioSubscription): SessionSlot {\n    const {language} = subLanguage(sub)\n    const isTranslation = sub.kind === \"translation\"\n    const slot: SessionSlot = {\n      key,\n      sub,\n      client: null,\n      assembler: null as unknown as SonioxTokenAssembler,\n      open: false,\n      failed: false,\n      attempts: 0,\n      nonTransient: false,\n      retryTimer: null,\n    }\n    slot.assembler = new SonioxTokenAssembler({\n      scope: key,\n      isTranslation,\n      fallbackLanguage: language === \"auto\" ? undefined : language,\n      onTranscript: (t) => this.deliver(slot, t),\n    })\n    this.connectSlot(slot)\n    return slot\n  }\n\n  private connectSlot(slot: SessionSlot): void {\n    const {language, hints} = subLanguage(slot.sub)\n    const client = this.clientFactory({\n      apiKey: this.apiKey,\n      language,\n      languageHints: hints ?? (language === \"auto\" ? this.transcriptionHints : undefined),\n      targetLanguage: slot.sub.kind === \"translation\" ? slot.sub.target : undefined,\n      onOpen: () => {\n        slot.open = true\n        slot.failed = false\n        slot.attempts = 0\n        slot.nonTransient = false\n        slot.errorKind = undefined\n        console.log(`${LOG_TAG}: session open ${slot.key}`)\n        this.publishStatus()\n      },\n      onResult: (result) => slot.assembler.handleResult(result),\n      onEndpoint: () => slot.assembler.handleEndpoint(),\n      onFinalized: () => slot.assembler.handleFinalized(),\n      onError: (err) => this.handleSlotError(slot, err),\n      onClose: () => this.handleSlotClosed(slot),\n    })\n    slot.client = client\n    client.connect()\n  }\n\n  private handleSlotError(slot: SessionSlot, err: SonioxClientError): void {\n    if (!this.slots.has(slot.key)) return\n    slot.errorKind = classifyError(err)\n    slot.nonTransient = err.nonTransient\n    this.lastErrorAt = Date.now()\n    console.warn(`${LOG_TAG}: session error ${slot.key} code=${err.code ?? \"?\"} ${err.message}`)\n    // A server-side error message usually precedes the socket dying; close\n    // proactively (close() suppresses the client's own onClose callback) and\n    // drive the retry from here.\n    slot.client?.close()\n    this.scheduleReconnect(slot)\n  }\n\n  private handleSlotClosed(slot: SessionSlot): void {\n    if (!this.slots.has(slot.key)) return\n    this.scheduleReconnect(slot)\n  }\n\n  private scheduleReconnect(slot: SessionSlot): void {\n    if (slot.retryTimer !== null) return\n    slot.open = false\n    slot.failed = true\n    slot.client = null\n\n    let delay: number\n    if (slot.nonTransient) {\n      slot.attempts = 0\n      delay = NON_TRANSIENT_RETRY_MS\n    } else {\n      slot.attempts += 1\n      if (slot.attempts > RECONNECT_MAX_ATTEMPTS) {\n        // Unlike the cloud worker (whose detach/attach recreates providers),\n        // nothing else will ever rebuild these sessions — fall back to the\n        // slow cadence instead of giving up outright.\n        delay = NON_TRANSIENT_RETRY_MS\n      } else {\n        delay = Math.min(RECONNECT_MAX_MS, RECONNECT_BASE_MS * 2 ** (slot.attempts - 1))\n      }\n    }\n    console.log(`${LOG_TAG}: reconnect ${slot.key} attempt=${slot.attempts} delayMs=${delay}`)\n    this.publishStatus()\n\n    slot.retryTimer = BgTimer.setTimeout(() => {\n      slot.retryTimer = null\n      if (!this.slots.has(slot.key) || !this.isEnabled()) return\n      this.connectSlot(slot)\n    }, delay)\n  }\n\n  private teardownSlot(slot: SessionSlot): void {\n    if (slot.retryTimer !== null) {\n      BgTimer.clearTimeout(slot.retryTimer)\n      slot.retryTimer = null\n    }\n    // Flush the in-flight utterance so a mid-update caption commits rather\n    // than dangling (mirrors the cloud provider's close()).\n    try {\n      slot.assembler.flush()\n    } catch {\n      /* best-effort */\n    }\n    slot.client?.close()\n    slot.client = null\n    slot.open = false\n  }\n\n  private teardownAllSlots(): void {\n    for (const slot of this.slots.values()) this.teardownSlot(slot)\n    this.slots.clear()\n  }\n\n  // ===========================================================================\n  // Audio feed\n  // ===========================================================================\n\n  private syncMicListener(): void {\n    const wantMic = this.slots.size > 0\n    if (wantMic && !this.micSub) {\n      this.micSub = BluetoothSdk.addListener(\"mic_pcm\", (event: {pcm: ArrayBuffer}) => {\n        if (!event?.pcm) return\n        for (const slot of this.slots.values()) {\n          slot.client?.sendAudio(event.pcm)\n        }\n      })\n    } else if (!wantMic && this.micSub) {\n      this.micSub.remove()\n      this.micSub = null\n    }\n  }\n\n  // ===========================================================================\n  // Transcript delivery\n  // ===========================================================================\n\n  /**\n   * Map an assembled utterance to the cloud wire shapes. Language resolution\n   * mirrors cloud result.ts: a specific-language subscription's code WINS over\n   * the provider-detected code (miniapp handlers key on the exact stream, and\n   * Soniox reports bare ISO codes while subscriptions carry BCP-47 tags).\n   */\n  private deliver(\n    slot: SessionSlot,\n    t: {\n      text: string\n      isFinal: boolean\n      utteranceId?: string\n      speakerId?: string\n      language?: string\n      originalText?: string\n      sourceLanguage?: string\n      startMs?: number\n      endMs?: number\n    },\n  ): void {\n    const timestamp = Date.now()\n    const startMs = t.startMs ?? 0\n    const endMs = t.endMs ?? 0\n    const durationMs = t.startMs != null && t.endMs != null ? t.endMs - t.startMs : undefined\n\n    if (slot.sub.kind === \"translation\") {\n      const source = slot.sub.source\n      const resolved =\n        source.mode === \"specific\"\n          ? {language: source.code, detected: false}\n          : {language: t.sourceLanguage ?? \"auto\", detected: true}\n      const data: TranslationData = {\n        userId: \"local\",\n        subscription: slot.sub,\n        text: t.text,\n        originalText: t.originalText,\n        isFinal: t.isFinal,\n        utteranceId: t.utteranceId,\n        speakerId: t.speakerId,\n        startMs,\n        endMs,\n        durationMs,\n        source: {language: resolved.language, detected: resolved.detected},\n        target: {language: slot.sub.target},\n        provider: \"soniox-direct\",\n        timestamp,\n      }\n      for (const cb of this.translationListeners) cb(data)\n      return\n    }\n\n    const source = slot.sub.language\n    const resolved =\n      source.mode === \"specific\"\n        ? {language: source.code, detected: false}\n        : {language: t.language ?? \"auto\", detected: true}\n    const data: TranscriptionData = {\n      userId: \"local\",\n      subscription: slot.sub,\n      text: t.text,\n      isFinal: t.isFinal,\n      utteranceId: t.utteranceId,\n      speakerId: t.speakerId,\n      startMs,\n      endMs,\n      durationMs,\n      resolvedLanguage: resolved.language,\n      languageDetected: resolved.detected,\n      tokens: [],\n      provider: \"soniox-direct\",\n      timestamp,\n    }\n    for (const cb of this.transcriptListeners) cb(data)\n  }\n\n  // ===========================================================================\n  // Status\n  // ===========================================================================\n\n  private computeStatus(): SonioxDirectStatus {\n    const enabled = this.isEnabled()\n    if (!enabled) return {enabled: false, state: \"inactive\"}\n    if (this.slots.size === 0) return {enabled: true, state: \"inactive\"}\n\n    let anyOpen = false\n    let errorKind: SonioxDirectErrorKind | undefined\n    let anyFailed = false\n    for (const slot of this.slots.values()) {\n      if (slot.open) anyOpen = true\n      if (slot.failed) anyFailed = true\n      // invalid_key > quota > unreachable, so the UI surfaces the actionable one.\n      if (slot.errorKind === \"invalid_key\" || (slot.errorKind && errorKind !== \"invalid_key\")) {\n        errorKind = errorKind === \"quota\" && slot.errorKind === \"unreachable\" ? errorKind : slot.errorKind\n      }\n    }\n    if (anyOpen) return {enabled: true, state: \"active\"}\n    if (anyFailed) return {enabled: true, state: \"error\", errorKind, lastErrorAt: this.lastErrorAt}\n    return {enabled: true, state: \"connecting\"}\n  }\n\n  private publishStatus(): void {\n    const next = this.computeStatus()\n    const prev = this.lastStatus\n    const changed = next.enabled !== prev.enabled || next.state !== prev.state || next.errorKind !== prev.errorKind\n    this.lastStatus = next\n    if (!changed) return\n    console.log(`${LOG_TAG}: status -> ${next.state}${next.errorKind ? ` (${next.errorKind})` : \"\"}`)\n    localSttFallbackCoordinator.onSonioxDirectStateChange(this.isEnabled(), this.isHealthy())\n    for (const cb of this.statusListeners) cb(next)\n  }\n}\n\nconst sonioxDirectService = SonioxDirectService.getInstance()\nexport default sonioxDirectService\n"]}