@kuralle-syrinx/core 4.4.0 → 4.5.0

package/dist/turn-arbiter.js

@@ -0,0 +1,259 @@
+// SPDX-License-Identifier: MIT
+//
+// CR-09 — explicit turn-taking state for barge-in decisions (G1 + VE-02).
+import { Route } from "./pipeline-bus.js";
+import * as make from "./packet-factories.js";
+const BACKCHANNELS = new Set([
+    "yeah",
+    "yep",
+    "yup",
+    "uh huh",
+    "uhhuh",
+    "uh-huh",
+    "mhm",
+    "mm hmm",
+    "mm-hmm",
+    "mmhmm",
+    "okay",
+    "ok",
+    "right",
+    "sure",
+    "uh",
+    "um",
+    "hmm",
+    "i see",
+    "got it",
+    "gotcha",
+    "oh",
+]);
+export function isBackchannel(text) {
+    const norm = text
+        .toLowerCase()
+        .replace(/[^a-z\s'-]/g, "")
+        .trim()
+        .replace(/\s+/g, " ");
+    if (!norm)
+        return false;
+    return BACKCHANNELS.has(norm);
+}
+export function isAcknowledgement(text, phrases) {
+    const norm = text
+        .toLowerCase()
+        .replace(/[^a-z\s'-]/g, "")
+        .trim()
+        .replace(/\s+/g, " ");
+    if (!norm)
+        return false;
+    return phrases.some((p) => {
+        const pNorm = p
+            .toLowerCase()
+            .replace(/[^a-z\s'-]/g, "")
+            .trim()
+            .replace(/\s+/g, " ");
+        return pNorm === norm;
+    });
+}
+export class TurnArbiter {
+    deps;
+    turnInterruption = { kind: "idle" };
+    latestInterimText = "";
+    latestInterimConfidence = null;
+    ducked = false;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    noteInterimEvidence(text, confidence) {
+        this.latestInterimText = text;
+        this.latestInterimConfidence = typeof confidence === "number" ? confidence : null;
+    }
+    onSpeechStarted(pkt, interruptedContextId) {
+        const { minInterruptionMs, bus, primarySpeakerGate } = this.deps;
+        // Idempotent for an already-pending barge-in: with both a local VAD and a
+        // provider STT emitting speech-start (vad_events), the later event must not
+        // reset firstSpeechMs and delay the commit.
+        if (this.pendingFor(pkt.contextId))
+            return;
+        if (minInterruptionMs <= 0) {
+            if (this.shouldDeferImmediateBargeInForSpeakerGate()) {
+                this.transitionToPending(pkt, interruptedContextId, true);
+                return;
+            }
+            bus.push(Route.Background, make.metric(interruptedContextId, "vaqi.interruption", "1"));
+            this.decideInterrupt(interruptedContextId);
+            return;
+        }
+        this.transitionToPending(pkt, interruptedContextId, false);
+    }
+    onSpeechActivity(pkt) {
+        const pending = this.pendingFor(pkt.contextId);
+        if (!pending)
+            return;
+        if (pkt.timestampMs - pending.firstSpeechMs < this.deps.minInterruptionMs)
+            return;
+        this.tryCommit(pkt.timestampMs);
+    }
+    // Barge-in evidence for deployments where the provider STT owns endpointing and
+    // no VAD plugin emits vad.speech_started: interim/final transcripts arriving
+    // while TTS playout is active are the speech signal. First evidence opens the
+    // pending window; later evidence commits once sustained past minInterruptionMs,
+    // through the same backchannel / low-confidence / speaker-gate suppression.
+    onProviderSttEvidence(userContextId, timestampMs, interruptedContextId) {
+        const state = this.turnInterruption;
+        if (state.kind === "pending") {
+            if (state.userContextId !== userContextId)
+                return;
+            this.tryCommit(timestampMs);
+            return;
+        }
+        this.transitionToPending({ contextId: userContextId, timestampMs }, interruptedContextId, false);
+    }
+    onSpeechEnded(pkt, hasActiveTts) {
+        const pending = this.pendingFor(pkt.contextId);
+        if (pending) {
+            const durationMs = pkt.timestampMs - pending.firstSpeechMs;
+            if (durationMs >= this.deps.minInterruptionMs) {
+                if (this.deps.primarySpeakerGate.isEnabled() &&
+                    this.deps.primarySpeakerGate.hasProfile() &&
+                    !this.deps.primarySpeakerGate.shouldCommitBargeIn(pending.userContextId)) {
+                    this.suppress(pending, "interrupt.suppressed_non_primary", durationMs);
+                }
+                else {
+                    this.tryCommit(pkt.timestampMs);
+                }
+            }
+            else {
+                this.suppress(pending, "interrupt.suppressed_short_speech", durationMs);
+            }
+            return;
+        }
+        if (!hasActiveTts) {
+            this.deps.primarySpeakerGate.lockProfileFromFirstTurn();
+        }
+    }
+    observeBargeInAudio(pkt) {
+        const pending = this.pendingFor(pkt.contextId);
+        if (!pending)
+            return false;
+        this.deps.primarySpeakerGate.observeBargeInChunk(pkt.audio);
+        if (pending.awaitingAudio) {
+            this.setAwaitingAudio(false);
+            this.tryCommit(pkt.timestampMs);
+        }
+        return true;
+    }
+    emitInterruptDetected(interruptedContextId) {
+        this.deps.bus.push(Route.Critical, make.interruptDetected(interruptedContextId, Date.now(), "vad"));
+    }
+    commitClientInterrupt(interruptedContextId) {
+        if (!this.deps.ttsPlayout.isActive(interruptedContextId))
+            return;
+        this.turnInterruption = { kind: "idle" };
+        this.ducked = false;
+        this.deps.primarySpeakerGate.resetBargeInWindow();
+        this.deps.bus.push(Route.Background, make.metric(interruptedContextId, "interrupt.committed_after_ms", "0"));
+        this.deps.bus.push(Route.Background, make.metric(interruptedContextId, "vaqi.interruption", "1"));
+        this.deps.bus.push(Route.Background, make.metric(interruptedContextId, "interrupt.latency_ms", "0"));
+        this.deps.bus.push(Route.Critical, make.interruptDetected(interruptedContextId, Date.now(), "client"));
+    }
+    clear() {
+        this.turnInterruption = { kind: "idle" };
+        this.latestInterimText = "";
+        this.latestInterimConfidence = null;
+        this.ducked = false;
+    }
+    pendingFor(userContextId) {
+        const state = this.turnInterruption;
+        if (state.kind !== "pending" || state.userContextId !== userContextId)
+            return null;
+        return state;
+    }
+    transitionToPending(pkt, interruptedContextId, awaitingAudio) {
+        this.deps.primarySpeakerGate.beginBargeInWindow();
+        // Reset interim evidence so a stale low-confidence/backchannel interim from a
+        // previous turn cannot suppress this new turn's barge-in. The current turn's
+        // own interims (noteInterimEvidence) repopulate it before tryCommit reads it.
+        this.latestInterimText = "";
+        this.latestInterimConfidence = null;
+        this.turnInterruption = {
+            kind: "pending",
+            userContextId: pkt.contextId,
+            interruptedContextId,
+            firstSpeechMs: pkt.timestampMs,
+            awaitingAudio,
+        };
+        if (this.deps.pauseThenResolveBargeIn && this.deps.ttsPlayout.isActive(interruptedContextId) && !this.ducked) {
+            this.deps.bus.push(Route.Main, make.interactionDuck(interruptedContextId, pkt.timestampMs));
+            this.ducked = true;
+        }
+    }
+    setAwaitingAudio(awaitingAudio) {
+        const state = this.turnInterruption;
+        if (state.kind !== "pending")
+            return;
+        this.turnInterruption = { ...state, awaitingAudio };
+    }
+    shouldDeferImmediateBargeInForSpeakerGate() {
+        const gate = this.deps.primarySpeakerGate;
+        return gate.isEnabled() && gate.hasProfile();
+    }
+    tryCommit(nowMs) {
+        const pending = this.turnInterruption.kind === "pending" ? this.turnInterruption : null;
+        if (!pending)
+            return;
+        if (nowMs - pending.firstSpeechMs < this.deps.minInterruptionMs)
+            return;
+        const gate = this.deps.primarySpeakerGate;
+        if (gate.isEnabled() && gate.hasProfile() && !gate.shouldCommitBargeIn(pending.userContextId)) {
+            this.suppress(pending, "interrupt.suppressed_non_primary", nowMs - pending.firstSpeechMs);
+            return;
+        }
+        const sustainedMs = nowMs - pending.firstSpeechMs;
+        if (this.latestInterimConfidence !== null && this.latestInterimConfidence < 0.5) {
+            this.suppress(pending, "interrupt.suppressed_low_confidence", sustainedMs);
+            return;
+        }
+        if (this.latestInterimText && isBackchannel(this.latestInterimText)) {
+            this.suppress(pending, "interrupt.suppressed_backchannel", sustainedMs);
+            return;
+        }
+        this.turnInterruption = { kind: "idle" };
+        gate.resetBargeInWindow();
+        this.ducked = false;
+        const { bus, ttsPlayout } = this.deps;
+        if (!ttsPlayout.isActive(pending.interruptedContextId)) {
+            bus.push(Route.Background, make.metric(pending.interruptedContextId, "interrupt.gate_resolved_after_tts_end", String(sustainedMs)));
+            return;
+        }
+        bus.push(Route.Background, make.metric(pending.interruptedContextId, "interrupt.committed_after_ms", String(sustainedMs)));
+        bus.push(Route.Background, make.metric(pending.interruptedContextId, "vaqi.interruption", "1"));
+        bus.push(Route.Background, make.metric(pending.interruptedContextId, "interrupt.latency_ms", String(sustainedMs)));
+        this.decideInterrupt(pending.interruptedContextId);
+        this.latestInterimText = "";
+        this.latestInterimConfidence = null;
+    }
+    decideInterrupt(interruptedContextId) {
+        if (this.deps.onInterrupt) {
+            this.deps.onInterrupt(interruptedContextId, "vad");
+            return;
+        }
+        this.emitInterruptDetected(interruptedContextId);
+    }
+    suppress(pending, metricName, durationMs) {
+        if (metricName === "interrupt.suppressed_non_primary") {
+            this.deps.primarySpeakerGate.beginBargeInWindow();
+            this.turnInterruption = { ...pending };
+        }
+        else {
+            this.turnInterruption = { kind: "idle" };
+            this.deps.primarySpeakerGate.resetBargeInWindow();
+            if (this.ducked) {
+                this.deps.bus.push(Route.Main, make.interactionResume(pending.interruptedContextId, Date.now()));
+                this.ducked = false;
+            }
+        }
+        this.deps.bus.push(Route.Background, make.metric(pending.interruptedContextId, metricName, String(durationMs)));
+        this.latestInterimText = "";
+        this.latestInterimConfidence = null;
+    }
+}
+//# sourceMappingURL=turn-arbiter.js.map

package/dist/turn-arbiter.js.map

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

package/dist/voice-agent-session-util.d.ts

@@ -0,0 +1,60 @@
+import { type PipelineBus } from "./pipeline-bus.js";
+import type { SttResultPacket } from "./packets.js";
+import { SessionState } from "./packets.js";
+import type { VoicePlugin } from "./plugin-contract.js";
+import { type Scheduler } from "./scheduler.js";
+import { TtsPlayoutClock } from "./tts-playout-clock.js";
+export declare function estimatePcm16Duration(audio: Uint8Array, sampleRate: number): number;
+export declare function requireTtsAudioSampleRate(value: unknown): number;
+export declare function languageFromTranscripts(transcripts: readonly SttResultPacket[]): string;
+interface ForceFinalizableSttPlugin extends VoicePlugin {
+    forceFinalize(contextId?: string): void;
+}
+export declare function findForceFinalizableSttPlugin(plugins: ReadonlyMap<string, VoicePlugin>): ForceFinalizableSttPlugin | null;
+export interface VoiceSessionWatchdogsDeps {
+    readonly bus: PipelineBus;
+    readonly plugins: ReadonlyMap<string, VoicePlugin>;
+    readonly ttsPlayout: TtsPlayoutClock;
+    readonly sttForceFinalizeTimeoutMs: number;
+    readonly vaqiMissedResponseMs: number;
+    readonly ttsStallMs: number;
+    readonly inputCadenceTimeoutMs: number;
+    readonly getSessionState: () => SessionState;
+    readonly isGenerationInterrupted: (contextId: string) => boolean;
+    readonly onVaqiMissedResponseFired: (contextId: string) => void;
+    readonly scheduler?: Scheduler;
+}
+export declare class VoiceSessionWatchdogs {
+    private readonly deps;
+    private readonly scheduler;
+    private sttForceFinalizeScheduled;
+    private pendingSttContextId;
+    /** Contexts whose STT the force-finalize watchdog has already fired on this turn. */
+    private readonly forceFinalizedContexts;
+    private vaqiMissedResponseScheduled;
+    private vaqiMissedResponseContextId;
+    private vaqiMissedResponseStartMs;
+    private ttsStallScheduled;
+    private ttsStallContextId;
+    private inputCadenceScheduled;
+    private inputCadenceContextId;
+    constructor(deps: VoiceSessionWatchdogsDeps);
+    dispose(): void;
+    scheduleSttForceFinalize(contextId: string): void;
+    /** True when the force-finalize watchdog has already fired for this context this turn. */
+    wasForceFinalized(contextId: string): boolean;
+    /** Retire the flag once the turn has completed (read by the emitter + metrics tracker). */
+    clearForceFinalized(contextId: string): void;
+    clearSttForceFinalizeIfContext(contextId: string): void;
+    startVaqiMissedResponseTimer(contextId: string, startMs: number): void;
+    clearVaqiIfContext(contextId: string): void;
+    armTtsStallTimer(contextId: string): void;
+    clearTtsStallTimerFor(contextId: string): void;
+    scheduleInputCadenceWatchdog(contextId: string): void;
+    clearInputCadenceWatchdog(): void;
+    private clearSttForceFinalizeTimer;
+    private clearVaqiMissedResponseTimer;
+    private clearTtsStallTimer;
+}
+export {};
+//# sourceMappingURL=voice-agent-session-util.d.ts.map

package/dist/voice-agent-session-util.d.ts.map

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

package/dist/voice-agent-session-util.js

@@ -0,0 +1,204 @@
+// SPDX-License-Identifier: MIT
+import { Route } from "./pipeline-bus.js";
+import { ErrorCategory, SessionState } from "./packets.js";
+import { TimerScheduler } from "./scheduler.js";
+import * as make from "./packet-factories.js";
+export function estimatePcm16Duration(audio, sampleRate) {
+    const samples = audio.length / 2;
+    return (samples / sampleRate) * 1000;
+}
+export function requireTtsAudioSampleRate(value) {
+    if (typeof value !== "number" || !Number.isInteger(value) || value <= 0) {
+        throw new Error("tts.audio sampleRateHz must be a positive integer");
+    }
+    return value;
+}
+export function languageFromTranscripts(transcripts) {
+    for (const transcript of transcripts) {
+        if (transcript.language) {
+            return transcript.language;
+        }
+    }
+    return "";
+}
+export function findForceFinalizableSttPlugin(plugins) {
+    for (const name of ["stt", "deepgram"]) {
+        const plugin = plugins.get(name);
+        if (isForceFinalizableSttPlugin(plugin)) {
+            return plugin;
+        }
+    }
+    for (const plugin of plugins.values()) {
+        if (isForceFinalizableSttPlugin(plugin)) {
+            return plugin;
+        }
+    }
+    return null;
+}
+function isForceFinalizableSttPlugin(plugin) {
+    return (typeof plugin === "object" &&
+        plugin !== null &&
+        "forceFinalize" in plugin &&
+        typeof plugin.forceFinalize === "function");
+}
+export class VoiceSessionWatchdogs {
+    deps;
+    scheduler;
+    sttForceFinalizeScheduled = false;
+    pendingSttContextId = "";
+    /** Contexts whose STT the force-finalize watchdog has already fired on this turn. */
+    forceFinalizedContexts = new Set();
+    vaqiMissedResponseScheduled = false;
+    vaqiMissedResponseContextId = "";
+    vaqiMissedResponseStartMs = 0;
+    ttsStallScheduled = false;
+    ttsStallContextId = "";
+    inputCadenceScheduled = false;
+    inputCadenceContextId = "";
+    constructor(deps) {
+        this.deps = deps;
+        this.scheduler = deps.scheduler ?? new TimerScheduler();
+    }
+    dispose() {
+        this.clearSttForceFinalizeTimer();
+        this.clearVaqiMissedResponseTimer();
+        this.clearTtsStallTimer();
+        this.clearInputCadenceWatchdog();
+        this.forceFinalizedContexts.clear();
+    }
+    scheduleSttForceFinalize(contextId) {
+        if (this.deps.getSessionState() !== SessionState.Ready)
+            return;
+        if (this.deps.sttForceFinalizeTimeoutMs <= 0)
+            return;
+        this.pendingSttContextId = contextId;
+        this.clearSttForceFinalizeTimer(false);
+        this.sttForceFinalizeScheduled = true;
+        this.scheduler.schedule("voice.watchdog.stt_force_finalize", this.deps.sttForceFinalizeTimeoutMs, () => {
+            this.sttForceFinalizeScheduled = false;
+            this.forceFinalizedContexts.add(contextId);
+            // Broadcast the decision on the bus: the completing eos may come from the STT
+            // plugin (which cannot know the watchdog fired), so the metrics tracker reads
+            // this mark to label the turn rather than each emitter re-deriving it.
+            this.deps.bus.push(Route.Background, make.metric(contextId, "stt.force_finalized", "1"));
+            const plugin = findForceFinalizableSttPlugin(this.deps.plugins);
+            plugin?.forceFinalize(contextId);
+        });
+    }
+    /** True when the force-finalize watchdog has already fired for this context this turn. */
+    wasForceFinalized(contextId) {
+        return this.forceFinalizedContexts.has(contextId);
+    }
+    /** Retire the flag once the turn has completed (read by the emitter + metrics tracker). */
+    clearForceFinalized(contextId) {
+        this.forceFinalizedContexts.delete(contextId);
+    }
+    clearSttForceFinalizeIfContext(contextId) {
+        if (this.pendingSttContextId === contextId) {
+            this.clearSttForceFinalizeTimer();
+        }
+    }
+    startVaqiMissedResponseTimer(contextId, startMs) {
+        if (this.deps.vaqiMissedResponseMs <= 0)
+            return;
+        this.clearVaqiMissedResponseTimer();
+        this.vaqiMissedResponseContextId = contextId;
+        this.vaqiMissedResponseStartMs = startMs;
+        this.vaqiMissedResponseScheduled = true;
+        this.scheduler.schedule("voice.watchdog.vaqi_missed_response", this.deps.vaqiMissedResponseMs, () => {
+            this.vaqiMissedResponseScheduled = false;
+            const cid = this.vaqiMissedResponseContextId;
+            const elapsedMs = Date.now() - this.vaqiMissedResponseStartMs;
+            this.vaqiMissedResponseContextId = "";
+            this.vaqiMissedResponseStartMs = 0;
+            this.deps.onVaqiMissedResponseFired(cid);
+            this.deps.bus.push(Route.Background, make.metric(cid, "vaqi.missed_response", String(elapsedMs)));
+        });
+    }
+    clearVaqiIfContext(contextId) {
+        if (this.vaqiMissedResponseContextId === contextId) {
+            this.clearVaqiMissedResponseTimer();
+        }
+    }
+    armTtsStallTimer(contextId) {
+        if (this.deps.ttsStallMs <= 0)
+            return;
+        this.clearTtsStallTimer();
+        this.ttsStallContextId = contextId;
+        this.ttsStallScheduled = true;
+        this.scheduler.schedule("voice.watchdog.tts_stall", this.deps.ttsStallMs, () => {
+            this.ttsStallScheduled = false;
+            const cid = this.ttsStallContextId;
+            this.ttsStallContextId = "";
+            if (this.deps.isGenerationInterrupted(cid))
+                return;
+            if (!this.deps.ttsPlayout.isActive(cid))
+                return;
+            this.deps.ttsPlayout.release(cid);
+            this.deps.bus.push(Route.Background, make.metric(cid, "tts.stall_detected", String(this.deps.ttsStallMs)));
+            this.deps.bus.push(Route.Critical, make.ttsError(cid, Date.now(), new Error(`TTS output stalled: no audio or tts.end for ${String(this.deps.ttsStallMs)}ms`), ErrorCategory.NetworkTimeout, true));
+        });
+    }
+    clearTtsStallTimerFor(contextId) {
+        if (this.ttsStallContextId === contextId)
+            this.clearTtsStallTimer();
+    }
+    scheduleInputCadenceWatchdog(contextId) {
+        if (this.deps.inputCadenceTimeoutMs <= 0)
+            return;
+        if (this.deps.getSessionState() !== SessionState.Ready)
+            return;
+        this.clearInputCadenceWatchdog();
+        this.inputCadenceContextId = contextId;
+        this.inputCadenceScheduled = true;
+        this.scheduler.schedule("voice.watchdog.input_cadence", this.deps.inputCadenceTimeoutMs, () => {
+            this.inputCadenceScheduled = false;
+            const cid = this.inputCadenceContextId;
+            if (this.deps.getSessionState() !== SessionState.Ready)
+                return;
+            this.deps.bus.push(Route.Background, make.metric(cid, "input.cadence_stall_ms", String(this.deps.inputCadenceTimeoutMs)));
+            this.deps.bus.push(Route.Critical, {
+                kind: "pipeline.error",
+                contextId: cid,
+                timestampMs: Date.now(),
+                component: "pipeline",
+                category: ErrorCategory.NetworkTimeout,
+                cause: new Error("inbound audio stalled"),
+                isRecoverable: true,
+            });
+            this.scheduleInputCadenceWatchdog(cid);
+        });
+    }
+    clearInputCadenceWatchdog() {
+        if (this.inputCadenceScheduled) {
+            this.scheduler.cancel("voice.watchdog.input_cadence");
+            this.inputCadenceScheduled = false;
+        }
+        this.inputCadenceContextId = "";
+    }
+    clearSttForceFinalizeTimer(clearContext = true) {
+        if (this.sttForceFinalizeScheduled) {
+            this.scheduler.cancel("voice.watchdog.stt_force_finalize");
+            this.sttForceFinalizeScheduled = false;
+        }
+        if (clearContext) {
+            this.pendingSttContextId = "";
+        }
+    }
+    clearVaqiMissedResponseTimer() {
+        if (this.vaqiMissedResponseScheduled) {
+            this.scheduler.cancel("voice.watchdog.vaqi_missed_response");
+            this.vaqiMissedResponseScheduled = false;
+        }
+        this.vaqiMissedResponseContextId = "";
+        this.vaqiMissedResponseStartMs = 0;
+    }
+    clearTtsStallTimer() {
+        if (this.ttsStallScheduled) {
+            this.scheduler.cancel("voice.watchdog.tts_stall");
+            this.ttsStallScheduled = false;
+        }
+        this.ttsStallContextId = "";
+    }
+}
+//# sourceMappingURL=voice-agent-session-util.js.map

package/dist/voice-agent-session-util.js.map

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