@kuralle-syrinx/deepgram 4.4.0 → 4.5.0

package/dist/flux.d.ts

@@ -0,0 +1,43 @@
+import { type PipelineBus, type PluginConfig, type SttReconfigure, type SttReconfigurePartial, type VoicePlugin } from "@kuralle-syrinx/core";
+import type { SocketFactory } from "@kuralle-syrinx/ws";
+export declare class DeepgramFluxSTTPlugin implements VoicePlugin {
+    private readonly socketFactory?;
+    readonly endpointingCapability: {
+        owner: "provider_stt";
+        disableConfig: {
+            emit_eos_on_final: boolean;
+        };
+    };
+    private bus;
+    private session;
+    private model;
+    private endpointUrl;
+    private sampleRate;
+    private eotThreshold;
+    private eagerEotThreshold;
+    private eotTimeoutMs;
+    private keyterms;
+    private languageHints;
+    private speechStartedEvents;
+    private encoding;
+    /** Open-ended Flux listen query knobs (profanity_filter, tag, mip_opt_out, …). */
+    private queryParams;
+    private apiKey;
+    private currentContextId;
+    constructor(socketFactory?: SocketFactory | undefined);
+    initialize(bus: PipelineBus, config: PluginConfig): Promise<void>;
+    /**
+     * Mid-stream reconfigure of keyterms / end-of-turn thresholds via the Flux v2 `Configure`
+     * control message — no socket restart (Deepgram "on-the-fly configuration"). Instance state is
+     * updated too, so a reconnect replays the current config (single source of truth with `url()`).
+     * `keyterms` REPLACES the list (Flux semantics), not merges. The provider acks with
+     * ConfigureSuccess / ConfigureFailure (surfaced as metrics in the wire protocol).
+     * `language` (hard switch) is ignored: Flux's model is language-specific (flux-general-en) —
+     * use `languageHints` to bias.
+     */
+    get sttReconfigure(): SttReconfigure;
+    reconfigure(partial: SttReconfigurePartial): void;
+    private emitError;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=flux.d.ts.map

package/dist/flux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flux.d.ts","sourceRoot":"","sources":["../src/flux.ts"],"names":[],"mappings":"AAsBA,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,YAAY,EAEjB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAIjB,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,oBAAoB,CAAC;AA0HpE,qBAAa,qBAAsB,YAAW,WAAW;IAyB3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IAxB3C,QAAQ,CAAC,qBAAqB;;;;;MAK5B;IAEF,OAAO,CAAC,GAAG,CAA4B;IACvC,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,WAAW,CAAsC;IACzD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAO;IAC3B,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,mBAAmB,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAc;IAC9B,kFAAkF;IAClF,OAAO,CAAC,WAAW,CAAsC;IACzD,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,gBAAgB,CAAM;gBAED,aAAa,CAAC,EAAE,aAAa,YAAA;IAEpD,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA2EvE;;;;;;;;OAQG;IACH,IAAI,cAAc,IAAI,cAAc,CAEnC;IAED,WAAW,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAcjD,OAAO,CAAC,SAAS;IAcX,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/flux.js

@@ -0,0 +1,308 @@
+// SPDX-License-Identifier: MIT
+//
+// Deepgram Flux — turn-aware conversational STT (v2 listen API).
+//
+// One model produces transcripts AND owns turn detection, replacing the
+// VAD + silence-endpointing stack. Runs on Workers (plain WebSocket), so this
+// is the semantic end-of-turn path for the edge cascade, where local ONNX
+// endpointers (smart-turn) cannot run.
+//
+// TurnInfo state machine → bus mapping (via stt-core SttEvent):
+//   StartOfTurn     → vad.speech_started   (barge-in signal; Flux recommends it)
+//   Update          → stt.interim
+//   EagerEndOfTurn  → eos.interim          (speculative-generation trigger)
+//   TurnResumed     → eos.retracted        (cancel speculative work)
+//   EndOfTurn       → stt.result + eos.turn_complete
+//
+// Eager mode is enabled by setting `eager_eot_threshold` (Deepgram: fires
+// 150–250ms before EndOfTurn at the cost of extra speculative LLM calls). The
+// EndOfTurn transcript exactly matches the preceding EagerEndOfTurn transcript
+// when no TurnResumed intervened, so a speculative result keyed on the eager
+// transcript can be committed as-is.
+import { Route, categorizeSttError, isRecoverable, optionalStringConfig, readProviderRetryConfig, requireStringConfig, } from "@kuralle-syrinx/core";
+import { defaultNodeSocketFactory, startStreamingSttSession, } from "@kuralle-syrinx/stt-core";
+function meanWordConfidence(words) {
+    if (!words || words.length === 0)
+        return 1;
+    let sum = 0;
+    for (const w of words)
+        sum += w.confidence;
+    return sum / words.length;
+}
+class DeepgramFluxSttWireProtocol {
+    speechStartedEvents;
+    onMetric;
+    constructor(speechStartedEvents, onMetric) {
+        this.speechStartedEvents = speechStartedEvents;
+        this.onMetric = onMetric;
+    }
+    encodeFinalize(_contextId) {
+        return [];
+    }
+    encodeClose() {
+        return [JSON.stringify({ type: "CloseStream" })];
+    }
+    encodeReconfigure(partial) {
+        const thresholds = {};
+        if (partial.eotThreshold !== undefined)
+            thresholds["eot_threshold"] = partial.eotThreshold;
+        if (partial.eagerEotThreshold !== undefined) {
+            thresholds["eager_eot_threshold"] = partial.eagerEotThreshold;
+        }
+        if (partial.eotTimeoutMs !== undefined)
+            thresholds["eot_timeout_ms"] = partial.eotTimeoutMs;
+        const configure = { type: "Configure" };
+        if (Object.keys(thresholds).length > 0)
+            configure["thresholds"] = thresholds;
+        if (partial.keyterms !== undefined)
+            configure["keyterms"] = partial.keyterms;
+        if (partial.languageHints !== undefined)
+            configure["language_hints"] = partial.languageHints;
+        return [JSON.stringify(configure)];
+    }
+    decode(data, _isBinary) {
+        if (typeof data !== "string")
+            return [];
+        let msg;
+        try {
+            msg = JSON.parse(data);
+        }
+        catch (err) {
+            return [
+                {
+                    type: "error",
+                    error: new Error(`Deepgram Flux sent malformed JSON: ${err instanceof Error ? err.message : String(err)}`),
+                },
+            ];
+        }
+        if (msg["type"] === "Error") {
+            const description = typeof msg["description"] === "string" ? msg["description"] : JSON.stringify(msg);
+            return [
+                {
+                    type: "error",
+                    error: new Error(`Deepgram Flux provider error: ${description}`),
+                },
+            ];
+        }
+        // Ack/nack for a mid-stream Configure (dynamic reconfigure). Surface as metrics so the
+        // conversation-state biasing that actuates reconfigure can observe that it took effect.
+        if (msg["type"] === "ConfigureSuccess") {
+            this.onMetric("stt.flux.configure_success", "1");
+            return [];
+        }
+        if (msg["type"] === "ConfigureFailure") {
+            const description = typeof msg["description"] === "string" ? msg["description"] : JSON.stringify(msg);
+            this.onMetric("stt.flux.configure_failure", description);
+            return [];
+        }
+        if (msg["type"] !== "TurnInfo")
+            return [];
+        const info = msg;
+        const transcript = (info.transcript ?? "").trim();
+        switch (info.event) {
+            case "StartOfTurn":
+                if (!this.speechStartedEvents)
+                    return [];
+                return [{ type: "speech_started" }];
+            case "Update":
+                if (!transcript)
+                    return [];
+                return [{ type: "interim", contextId: "", text: transcript }];
+            case "EagerEndOfTurn":
+                if (!transcript)
+                    return [];
+                return [{ type: "eos_interim", text: transcript }];
+            case "TurnResumed":
+                return [{ type: "eos_retracted" }];
+            case "EndOfTurn":
+                if (!transcript)
+                    return [];
+                return [
+                    {
+                        type: "final",
+                        contextId: "",
+                        text: transcript,
+                        confidence: meanWordConfidence(info.words),
+                        language: "en",
+                        speechFinal: true,
+                    },
+                ];
+            default:
+                return [];
+        }
+    }
+}
+export class DeepgramFluxSTTPlugin {
+    socketFactory;
+    endpointingCapability = {
+        owner: "provider_stt",
+        disableConfig: {
+            emit_eos_on_final: false,
+        },
+    };
+    bus = null;
+    session = null;
+    model = "flux-general-en";
+    endpointUrl = "wss://api.deepgram.com/v2/listen";
+    sampleRate = 16000;
+    eotThreshold = 0.7;
+    eagerEotThreshold;
+    eotTimeoutMs = 5000;
+    keyterms = [];
+    languageHints = [];
+    speechStartedEvents = true;
+    encoding = "linear16";
+    /** Open-ended Flux listen query knobs (profanity_filter, tag, mip_opt_out, …). */
+    queryParams;
+    apiKey = "";
+    currentContextId = "";
+    constructor(socketFactory) {
+        this.socketFactory = socketFactory;
+    }
+    async initialize(bus, config) {
+        this.bus = bus;
+        this.apiKey = requireStringConfig(config, "api_key");
+        this.model = optionalStringConfig(config, "model") ?? "flux-general-en";
+        this.endpointUrl = optionalStringConfig(config, "endpoint_url") ?? "wss://api.deepgram.com/v2/listen";
+        this.sampleRate = config["sample_rate"] ?? 16000;
+        this.eotThreshold = config["eot_threshold"] ?? 0.7;
+        this.eagerEotThreshold = config["eager_eot_threshold"];
+        this.eotTimeoutMs = config["eot_timeout_ms"] ?? 5000;
+        this.speechStartedEvents = config["speech_started_events"] ?? true;
+        const emitEosOnFinal = config["emit_eos_on_final"] ?? true;
+        {
+            const raw = config["keyterm"];
+            this.keyterms = Array.isArray(raw)
+                ? raw.filter((t) => typeof t === "string" && t.length > 0)
+                : typeof raw === "string" && raw.length > 0
+                    ? [raw]
+                    : [];
+        }
+        {
+            const raw = config["language_hint"];
+            this.languageHints = Array.isArray(raw)
+                ? raw.filter((t) => typeof t === "string" && t.length > 0)
+                : typeof raw === "string" && raw.length > 0
+                    ? [raw]
+                    : [];
+        }
+        this.encoding = optionalStringConfig(config, "encoding") ?? "linear16";
+        this.queryParams = readPlainObject(config["query_params"]);
+        const audioFormat = {
+            encoding: "pcm_s16le",
+            sampleRateHz: this.sampleRate,
+            channels: 1,
+        };
+        this.session = await startStreamingSttSession(bus, {
+            protocol: new DeepgramFluxSttWireProtocol(this.speechStartedEvents, (name, value) => {
+                bus.push(Route.Background, {
+                    kind: "metric.conversation",
+                    contextId: "",
+                    timestampMs: Date.now(),
+                    name,
+                    value,
+                });
+            }),
+            provider: { name: "deepgram", model: this.model, region: "global" },
+            format: audioFormat,
+            language: "en",
+            emitEosOnFinal,
+            url: () => {
+                const params = new URLSearchParams({
+                    model: this.model,
+                    encoding: this.encoding,
+                    sample_rate: String(this.sampleRate),
+                    eot_threshold: String(this.eotThreshold),
+                    eot_timeout_ms: String(this.eotTimeoutMs),
+                    ...(this.eagerEotThreshold !== undefined
+                        ? { eager_eot_threshold: String(this.eagerEotThreshold) }
+                        : {}),
+                });
+                for (const term of this.keyterms)
+                    params.append("keyterm", term);
+                for (const hint of this.languageHints)
+                    params.append("language_hint", hint);
+                applyQueryParams(params, this.queryParams);
+                const separator = this.endpointUrl.includes("?") ? "&" : "?";
+                return `${this.endpointUrl}${separator}${params.toString()}`;
+            },
+            headers: { Authorization: `Token ${this.apiKey}` },
+            socketFactory: this.socketFactory ?? (await defaultNodeSocketFactory()),
+            retry: readProviderRetryConfig(config),
+            replayBufferSize: config["replay_buffer_size"] ?? 64,
+            metricPrefix: "stt.flux",
+        });
+    }
+    /**
+     * Mid-stream reconfigure of keyterms / end-of-turn thresholds via the Flux v2 `Configure`
+     * control message — no socket restart (Deepgram "on-the-fly configuration"). Instance state is
+     * updated too, so a reconnect replays the current config (single source of truth with `url()`).
+     * `keyterms` REPLACES the list (Flux semantics), not merges. The provider acks with
+     * ConfigureSuccess / ConfigureFailure (surfaced as metrics in the wire protocol).
+     * `language` (hard switch) is ignored: Flux's model is language-specific (flux-general-en) —
+     * use `languageHints` to bias.
+     */
+    get sttReconfigure() {
+        return this;
+    }
+    reconfigure(partial) {
+        if (partial.keyterms !== undefined)
+            this.keyterms = partial.keyterms;
+        if (partial.eotThreshold !== undefined)
+            this.eotThreshold = partial.eotThreshold;
+        if (partial.eagerEotThreshold !== undefined)
+            this.eagerEotThreshold = partial.eagerEotThreshold;
+        if (partial.eotTimeoutMs !== undefined)
+            this.eotTimeoutMs = partial.eotTimeoutMs;
+        if (partial.languageHints !== undefined)
+            this.languageHints = partial.languageHints;
+        try {
+            this.session?.reconfigure(partial);
+        }
+        catch (err) {
+            this.emitError(err instanceof Error ? err : new Error(String(err)));
+        }
+    }
+    emitError(err) {
+        const category = categorizeSttError(err);
+        const packet = {
+            kind: "stt.error",
+            contextId: this.currentContextId,
+            timestampMs: Date.now(),
+            component: "stt",
+            category,
+            cause: err,
+            isRecoverable: isRecoverable(category),
+        };
+        this.bus?.push(Route.Critical, packet);
+    }
+    async close() {
+        await this.session?.dispose();
+        this.session = null;
+        this.bus = null;
+    }
+}
+function readPlainObject(value) {
+    if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+        return value;
+    }
+    return undefined;
+}
+function applyQueryParams(params, extra) {
+    if (!extra)
+        return;
+    for (const [key, value] of Object.entries(extra)) {
+        if (value === undefined || value === null)
+            continue;
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                if (item === undefined || item === null)
+                    continue;
+                params.append(key, String(item));
+            }
+            continue;
+        }
+        params.set(key, String(value));
+    }
+}
+//# sourceMappingURL=flux.js.map

package/dist/flux.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./stt.js";
+export * from "./flux.js";
+export * from "./tts.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// SPDX-License-Identifier: MIT
+//
+// Deepgram provider plugins — speech-to-text and text-to-speech in one package.
+// Import from the barrel for both, or the `./stt` / `./tts` subpaths for one.
+export * from "./stt.js";
+export * from "./flux.js";
+export * from "./tts.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,gFAAgF;AAChF,8EAA8E;AAE9E,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/stt.d.ts

@@ -0,0 +1,49 @@
+import { type PipelineBus, type PluginConfig, type SttReconfigure, type SttReconfigurePartial, type VoicePlugin } from "@kuralle-syrinx/core";
+import type { SocketFactory } from "@kuralle-syrinx/ws";
+export declare class DeepgramSTTPlugin implements VoicePlugin {
+    private readonly socketFactory?;
+    readonly endpointingCapability: {
+        owner: "provider_stt";
+        disableConfig: {
+            emit_eos_on_final: boolean;
+            finalize_on_speech_final: boolean;
+        };
+    };
+    private bus;
+    private session;
+    private protocol;
+    private currentContextId;
+    private model;
+    private language;
+    private sampleRate;
+    private endpointing;
+    private endpointUrl;
+    private smartFormat;
+    private interimResults;
+    private vadEvents;
+    private utteranceEndMs;
+    private keyterms;
+    private encoding;
+    private channels;
+    private noDelay;
+    private queryParams;
+    private disposers;
+    constructor(socketFactory?: SocketFactory | undefined);
+    initialize(bus: PipelineBus, config: PluginConfig): Promise<void>;
+    /**
+     * Per-turn reconfigure of keyterms / silence endpointing. Nova has no in-band
+     * Configure message — updates instance state then reconnects via `session.reset()`
+     * so the re-evaluated `url()` carries the new params (LiveKit Nova-3 pattern).
+     * Call only at a turn boundary (between utterances); reconnect is not free and
+     * would drop mid-utterance audio. keyterms REPLACE the list (Flux semantics).
+     * `language` hard-switches recognition (e.g. "es-ES" or Nova-3 "multi") — applied on
+     * reconnect via the rebuilt `url()`, and re-stamped onto stt.result. Flux-only fields
+     * (eotThreshold, eagerEotThreshold, eotTimeoutMs, contextText) are ignored.
+     */
+    get sttReconfigure(): SttReconfigure;
+    reconfigure(partial: SttReconfigurePartial): void;
+    /** Request that Deepgram flush buffered audio and return provider-final text. */
+    forceFinalize(contextId?: string): void;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=stt.d.ts.map

package/dist/stt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stt.d.ts","sourceRoot":"","sources":["../src/stt.ts"],"names":[],"mappings":"AAUA,OAAO,EAOL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAS9B,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,oBAAoB,CAAC;AA0iBpE,qBAAa,iBAAkB,YAAW,WAAW;IA6BvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IA5B3C,QAAQ,CAAC,qBAAqB;;;;;;MAM5B;IAEF,OAAO,CAAC,GAAG,CAA4B;IACvC,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,gBAAgB,CAAM;IAC9B,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAO;IAC1B,OAAO,CAAC,WAAW,CAAsC;IACzD,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,WAAW,CAAsC;IACzD,OAAO,CAAC,SAAS,CAAyB;gBAEb,aAAa,CAAC,EAAE,aAAa,YAAA;IAEpD,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA0HvE;;;;;;;;;OASG;IACH,IAAI,cAAc,IAAI,cAAc,CAEnC;IAED,WAAW,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAkBjD,iFAAiF;IACjF,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAUjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}