@kuralle-syrinx/server-websocket 4.4.1 → 4.5.0

package/dist/backchannel-cue-fixtures.d.ts

@@ -0,0 +1,4 @@
+import type { BackgroundAudioSource } from "./background-audio.js";
+/** Placeholder cue map — pass as `backgroundAudio.cues` at session init. */
+export declare function buildPlaceholderBackchannelCues(): Readonly<Record<string, BackgroundAudioSource>>;
+//# sourceMappingURL=backchannel-cue-fixtures.d.ts.map

package/dist/backchannel-cue-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backchannel-cue-fixtures.d.ts","sourceRoot":"","sources":["../src/backchannel-cue-fixtures.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAcnE,4EAA4E;AAC5E,wBAAgB,+BAA+B,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAMjG"}

package/dist/backchannel-cue-fixtures.js

@@ -0,0 +1,25 @@
+// SPDX-License-Identifier: MIT
+//
+// Deterministic placeholder backchannel cue PCM (16 kHz mono). Real voice-matched
+// assets + locale table are a follow-up — these shaped tones prove the byte-config path.
+import { synthesizeTonePcm16 } from "@kuralle-syrinx/core";
+import { pcm16BytesToSamples } from "@kuralle-syrinx/core/audio";
+const CUE_SAMPLE_RATE_HZ = 16_000;
+function placeholderCue(frequencyHz, durationMs, gain) {
+    const bytes = synthesizeTonePcm16({
+        frequencyHz,
+        durationMs,
+        sampleRateHz: CUE_SAMPLE_RATE_HZ,
+        amplitude: 0.35,
+    });
+    return { pcm: pcm16BytesToSamples(bytes), sampleRateHz: CUE_SAMPLE_RATE_HZ, gain };
+}
+/** Placeholder cue map — pass as `backgroundAudio.cues` at session init. */
+export function buildPlaceholderBackchannelCues() {
+    return {
+        mm_hmm: placeholderCue(440, 400, 0.65),
+        yeah: placeholderCue(520, 350, 0.6),
+        got_it: placeholderCue(380, 450, 0.6),
+    };
+}
+//# sourceMappingURL=backchannel-cue-fixtures.js.map

package/dist/backchannel-cue-fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backchannel-cue-fixtures.js","sourceRoot":"","sources":["../src/backchannel-cue-fixtures.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,kFAAkF;AAClF,yFAAyF;AAEzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC,SAAS,cAAc,CAAC,WAAmB,EAAE,UAAkB,EAAE,IAAY;IAC3E,MAAM,KAAK,GAAG,mBAAmB,CAAC;QAChC,WAAW;QACX,UAAU;QACV,YAAY,EAAE,kBAAkB;QAChC,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;IACH,OAAO,EAAE,GAAG,EAAE,mBAAmB,CAAC,KAAK,CAAC,EAAE,YAAY,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;AACrF,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,+BAA+B;IAC7C,OAAO;QACL,MAAM,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC;QACtC,IAAI,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;QACnC,MAAM,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;KACtC,CAAC;AACJ,CAAC"}

package/dist/background-audio.d.ts

@@ -0,0 +1,59 @@
+import type { VoiceAgentSession } from "@kuralle-syrinx/core";
+export interface BackgroundAudioSource {
+    /** Mono PCM16 samples. Must be loop-clean if it will loop audibly. */
+    readonly pcm: Int16Array;
+    readonly sampleRateHz: number;
+    /** Linear gain 0..1 applied to this source. */
+    readonly gain?: number;
+}
+export interface BackgroundAudioConfig {
+    /** Looped continuously: under speech (ducked) and alone between turns. */
+    readonly ambient?: BackgroundAudioSource;
+    /** Looped while `setThinking(true)` — the audible face of a pending tool call. */
+    readonly thinking?: BackgroundAudioSource;
+    /** Pre-cached one-shot backchannel cues keyed by cue id (IP-C3). */
+    readonly cues?: Readonly<Record<string, BackgroundAudioSource>>;
+    /**
+     * Extra multiplier on background sources while assistant speech is being
+     * mixed, so the bed never muddies the voice. 1 disables ducking. @default 0.5
+     */
+    readonly duckWhileSpeaking?: number;
+    /**
+     * Equal-power fade applied where the bed would otherwise hard-cut: the
+     * ambient's very first samples, and each thinking episode's start and stop.
+     * An abrupt full-volume onset is the harshest moment a caller hears from a
+     * wait — the fade is what makes an episode feel placed rather than switched.
+     * 0 disables. @default 250
+     */
+    readonly fadeMs?: number;
+}
+export declare class BackgroundAudioMixer {
+    private readonly ambient;
+    private readonly thinking;
+    private readonly cueCatalog;
+    private readonly duck;
+    private readonly fadeMs;
+    private thinkingState;
+    private thinkingFadeInPos;
+    private thinkingFadeOutPos;
+    private ambientFadeInPos;
+    private speakingUntilMs;
+    private pendingCue;
+    constructor(config: BackgroundAudioConfig);
+    get hasSources(): boolean;
+    hasCue(cueId: string): boolean;
+    isSpeaking(nowMs?: number): boolean;
+    /** Queue a one-shot backchannel cue by id. Returns false when the cue is unknown. */
+    queueCue(cueId: string): boolean;
+    /** G3 cue wiring: started/delayed → true, complete/failed → false. */
+    setThinking(on: boolean): void;
+    private thinkingScale;
+    private addBed;
+    private addPendingCue;
+    mix(chunk: Uint8Array, sampleRateHz: number, nowMs?: number): Uint8Array;
+    idleFrame(frameMs: number, sampleRateHz: number, nowMs?: number): Uint8Array | null;
+}
+export declare function wireBackgroundThinking(session: VoiceAgentSession, mixer: BackgroundAudioMixer): void;
+export declare function wireBackgroundBackchannel(session: VoiceAgentSession, mixer: BackgroundAudioMixer): void;
+export declare function wireBackgroundAudio(session: VoiceAgentSession, mixer: BackgroundAudioMixer): void;
+//# sourceMappingURL=background-audio.d.ts.map

package/dist/background-audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-audio.d.ts","sourceRoot":"","sources":["../src/background-audio.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAgC,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAI5F,MAAM,WAAW,qBAAqB;IACpC,sEAAsE;IACtE,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IACzC,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IAC1C,oEAAoE;IACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC;IAChE;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AA2HD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6C;IACxE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,UAAU,CAA8B;gBAEpC,MAAM,EAAE,qBAAqB;IAQzC,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI9B,UAAU,CAAC,KAAK,SAAa,GAAG,OAAO;IAIvC,qFAAqF;IACrF,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAOhC,sEAAsE;IACtE,WAAW,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI;IAa9B,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,MAAM;IAoCd,OAAO,CAAC,aAAa;IAMrB,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,SAAa,GAAG,UAAU;IAY5E,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,SAAa,GAAG,UAAU,GAAG,IAAI;CAWxF;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAIpG;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAYvG;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAGjG"}

package/dist/background-audio.js

@@ -0,0 +1,248 @@
+// SPDX-License-Identifier: MIT
+//
+// Background audio for the outbound path: a looped ambient bed (which doubles
+// as telephony comfort noise between turns), an optional "thinking" loop keyed
+// off the G3 tool-call cues, one-shot backchannel cues, and ducking under speech.
+//
+// Syrinx wires (Twilio media stream, browser jitter buffer) are single ORDERED
+// streams — unlike LiveKit's WebRTC rooms there is no client-side track mixing
+// — so background audio is mixed server-side into the one stream: `mix()` layers
+// the bed under every TTS chunk (ducked), and `idleFrame()` produces bed-only
+// frames for the gaps between turns. Source playback positions are shared
+// between the two so the bed is seamless across turn boundaries.
+//
+// Runtime-neutral: no Node imports — runs on workerd (edge hosts) as-is.
+// Prior art: Pipecat SoundfileMixer (transport-level mix + volume + loop),
+// LiveKit BackgroundAudioPlayer (ambient/thinking split, state-keyed thinking).
+import { Route } from "@kuralle-syrinx/core";
+import { pcm16BytesToSamples, pcm16SamplesToBytes, resamplePcm16 } from "@kuralle-syrinx/core/audio";
+const DEFAULT_AMBIENT_GAIN = 0.25;
+const DEFAULT_THINKING_GAIN = 0.4;
+const DEFAULT_CUE_GAIN = 0.65;
+const DEFAULT_DUCK = 0.5;
+const DEFAULT_FADE_MS = 250;
+const CUE_THINKING_DUCK = 0.25;
+function loopedSource(source, defaultGain) {
+    return {
+        original: source,
+        gain: source.gain ?? defaultGain,
+        byRate: new Map(),
+        position: 0,
+        positionRateHz: source.sampleRateHz,
+    };
+}
+function oneShotSource(source, defaultGain) {
+    return {
+        original: source,
+        gain: source.gain ?? defaultGain,
+        byRate: new Map(),
+        position: 0,
+        positionRateHz: source.sampleRateHz,
+    };
+}
+function samplesAtRate(source, rateHz) {
+    let samples = source.byRate.get(rateHz);
+    if (!samples) {
+        samples = resamplePcm16(source.original.pcm, source.original.sampleRateHz, rateHz);
+        source.byRate.set(rateHz, samples);
+    }
+    if (source.positionRateHz !== rateHz) {
+        source.position = Math.round((source.position * rateHz) / source.positionRateHz);
+        source.positionRateHz = rateHz;
+    }
+    return samples;
+}
+/**
+ * Add samples of `source` (scaled by `scale`, optionally shaped per-sample by
+ * `envelope(i)`) into `target`, advancing the loop.
+ */
+function addLooped(target, source, rateHz, scale, envelope) {
+    const samples = samplesAtRate(source, rateHz);
+    if (samples.length === 0 || scale === 0)
+        return;
+    let pos = source.position % samples.length;
+    for (let i = 0; i < target.length; i += 1) {
+        const gain = envelope ? scale * envelope(i) : scale;
+        target[i] += samples[pos] * gain;
+        pos += 1;
+        if (pos >= samples.length)
+            pos = 0;
+    }
+    source.position = pos;
+}
+function addOneShot(target, source, rateHz) {
+    const samples = samplesAtRate(source, rateHz);
+    if (samples.length === 0 || source.gain === 0)
+        return true;
+    let pos = source.position;
+    for (let i = 0; i < target.length; i += 1) {
+        if (pos >= samples.length) {
+            source.position = samples.length;
+            return true;
+        }
+        target[i] += samples[pos] * source.gain;
+        pos += 1;
+    }
+    source.position = pos;
+    return pos >= samples.length;
+}
+/** Equal-power fade-in gain for sample `n` of a `total`-sample ramp (1 past the ramp). */
+function fadeInGain(n, total) {
+    if (total <= 0 || n >= total)
+        return 1;
+    return Math.sin((n / total) * (Math.PI / 2));
+}
+/** Equal-power fade-out gain for sample `n` of a `total`-sample ramp (0 past the ramp). */
+function fadeOutGain(n, total) {
+    if (total <= 0 || n >= total)
+        return 0;
+    return Math.cos((n / total) * (Math.PI / 2));
+}
+function clipToPcm16Bytes(mix) {
+    const out = new Int16Array(mix.length);
+    for (let i = 0; i < mix.length; i += 1) {
+        const v = Math.round(mix[i]);
+        out[i] = v > 32767 ? 32767 : v < -32768 ? -32768 : v;
+    }
+    return pcm16SamplesToBytes(out);
+}
+export class BackgroundAudioMixer {
+    ambient;
+    thinking;
+    cueCatalog;
+    duck;
+    fadeMs;
+    thinkingState = "off";
+    thinkingFadeInPos = 0;
+    thinkingFadeOutPos = 0;
+    ambientFadeInPos = 0;
+    speakingUntilMs = 0;
+    pendingCue = null;
+    constructor(config) {
+        this.ambient = config.ambient ? loopedSource(config.ambient, DEFAULT_AMBIENT_GAIN) : null;
+        this.thinking = config.thinking ? loopedSource(config.thinking, DEFAULT_THINKING_GAIN) : null;
+        this.cueCatalog = new Map(Object.entries(config.cues ?? {}));
+        this.duck = config.duckWhileSpeaking ?? DEFAULT_DUCK;
+        this.fadeMs = config.fadeMs ?? DEFAULT_FADE_MS;
+    }
+    get hasSources() {
+        return this.ambient !== null || this.thinking !== null || this.cueCatalog.size > 0;
+    }
+    hasCue(cueId) {
+        return this.cueCatalog.has(cueId);
+    }
+    isSpeaking(nowMs = Date.now()) {
+        return nowMs < this.speakingUntilMs;
+    }
+    /** Queue a one-shot backchannel cue by id. Returns false when the cue is unknown. */
+    queueCue(cueId) {
+        const source = this.cueCatalog.get(cueId);
+        if (!source)
+            return false;
+        this.pendingCue = oneShotSource(source, DEFAULT_CUE_GAIN);
+        return true;
+    }
+    /** G3 cue wiring: started/delayed → true, complete/failed → false. */
+    setThinking(on) {
+        if (on) {
+            if (this.thinkingState === "on")
+                return;
+            this.thinkingState = "on";
+            this.thinkingFadeInPos = 0;
+            if (this.thinking)
+                this.thinking.position = 0;
+            return;
+        }
+        if (this.thinkingState !== "on")
+            return;
+        this.thinkingState = this.fadeMs > 0 ? "stopping" : "off";
+        this.thinkingFadeOutPos = 0;
+    }
+    thinkingScale(bedScale) {
+        return this.pendingCue ? bedScale * CUE_THINKING_DUCK : bedScale;
+    }
+    addBed(mixBuf, sampleRateHz, bedScale) {
+        const fadeSamples = Math.round((this.fadeMs / 1000) * sampleRateHz);
+        const thinkingScale = this.thinkingScale(bedScale);
+        if (this.ambient) {
+            const startPos = this.ambientFadeInPos;
+            const envelope = startPos >= fadeSamples
+                ? undefined
+                : (i) => fadeInGain(startPos + i, fadeSamples);
+            addLooped(mixBuf, this.ambient, sampleRateHz, this.ambient.gain * bedScale, envelope);
+            this.ambientFadeInPos = Math.min(fadeSamples, startPos + mixBuf.length);
+        }
+        if (this.thinking && this.thinkingState !== "off") {
+            if (this.thinkingState === "on") {
+                const startPos = this.thinkingFadeInPos;
+                const envelope = startPos >= fadeSamples
+                    ? undefined
+                    : (i) => fadeInGain(startPos + i, fadeSamples);
+                addLooped(mixBuf, this.thinking, sampleRateHz, this.thinking.gain * thinkingScale, envelope);
+                this.thinkingFadeInPos = Math.min(fadeSamples, startPos + mixBuf.length);
+            }
+            else {
+                const startPos = this.thinkingFadeOutPos;
+                addLooped(mixBuf, this.thinking, sampleRateHz, this.thinking.gain * thinkingScale, (i) => fadeOutGain(startPos + i, fadeSamples));
+                this.thinkingFadeOutPos = startPos + mixBuf.length;
+                if (this.thinkingFadeOutPos >= fadeSamples)
+                    this.thinkingState = "off";
+            }
+        }
+    }
+    addPendingCue(mixBuf, sampleRateHz) {
+        if (!this.pendingCue)
+            return;
+        const finished = addOneShot(mixBuf, this.pendingCue, sampleRateHz);
+        if (finished)
+            this.pendingCue = null;
+    }
+    mix(chunk, sampleRateHz, nowMs = Date.now()) {
+        const speech = pcm16BytesToSamples(chunk);
+        const durationMs = (speech.length / sampleRateHz) * 1000;
+        this.speakingUntilMs = Math.max(this.speakingUntilMs, nowMs) + durationMs;
+        if (!this.hasSources && !this.pendingCue)
+            return chunk;
+        const mixBuf = new Float64Array(speech.length);
+        for (let i = 0; i < speech.length; i += 1)
+            mixBuf[i] = speech[i];
+        this.addBed(mixBuf, sampleRateHz, this.duck);
+        return clipToPcm16Bytes(mixBuf);
+    }
+    idleFrame(frameMs, sampleRateHz, nowMs = Date.now()) {
+        if (this.isSpeaking(nowMs))
+            return null;
+        const playThinking = this.thinking !== null && this.thinkingState !== "off";
+        if (!this.ambient && !playThinking && !this.pendingCue)
+            return null;
+        const sampleCount = Math.max(1, Math.round((frameMs / 1000) * sampleRateHz));
+        const mixBuf = new Float64Array(sampleCount);
+        this.addBed(mixBuf, sampleRateHz, 1);
+        this.addPendingCue(mixBuf, sampleRateHz);
+        return clipToPcm16Bytes(mixBuf);
+    }
+}
+export function wireBackgroundThinking(session, mixer) {
+    session.on("tool_call_cue", (event) => {
+        mixer.setThinking(event.phase === "started" || event.phase === "delayed");
+    });
+}
+export function wireBackgroundBackchannel(session, mixer) {
+    session.bus.on("interaction.backchannel", (pkt) => {
+        const backchannel = pkt;
+        if (mixer.queueCue(backchannel.cue))
+            return;
+        session.bus.push(Route.Background, {
+            kind: "metric.conversation",
+            contextId: backchannel.contextId,
+            timestampMs: backchannel.timestampMs,
+            name: "backchannel.suppressed_missing_asset",
+            value: backchannel.cue,
+        });
+    });
+}
+export function wireBackgroundAudio(session, mixer) {
+    wireBackgroundThinking(session, mixer);
+    wireBackgroundBackchannel(session, mixer);
+}
+//# sourceMappingURL=background-audio.js.map

package/dist/background-audio.js.map

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

package/dist/browser-opus.d.ts

@@ -0,0 +1,12 @@
+export declare const BROWSER_OPUS_SAMPLE_RATE_HZ = 48000;
+export declare const BROWSER_OPUS_FRAME_DURATION_MS = 20;
+export type BrowserOpusCodec = {
+    readonly sampleRateHz: number;
+    readonly frameSamples: number;
+    encodePcm16Frame(samples: Int16Array, flush?: boolean): Uint8Array[];
+    decodeOpusFrame(wire: Uint8Array): Int16Array;
+    reset(): void;
+};
+export declare function createBrowserOpusCodec(sampleRateHz?: number): BrowserOpusCodec;
+export declare function decodeBrowserOpusToPcm16Bytes(wire: Uint8Array, codec: BrowserOpusCodec): Uint8Array;
+//# sourceMappingURL=browser-opus.d.ts.map

package/dist/browser-opus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-opus.d.ts","sourceRoot":"","sources":["../src/browser-opus.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAClD,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU,EAAE,CAAC;IACrE,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;IAC9C,KAAK,IAAI,IAAI,CAAC;CACf,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,YAAY,SAA8B,GAAG,gBAAgB,CAsCnG;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,gBAAgB,GAAG,UAAU,CAEnG"}

package/dist/browser-opus.js

@@ -0,0 +1,48 @@
+// SPDX-License-Identifier: MIT
+import { Decoder as OpusDecoder, Encoder as OpusEncoder } from "@evan/opus";
+import { pcm16BytesToSamples, pcm16SamplesToBytes } from "@kuralle-syrinx/core/audio";
+export const BROWSER_OPUS_SAMPLE_RATE_HZ = 48_000;
+export const BROWSER_OPUS_FRAME_DURATION_MS = 20;
+export function createBrowserOpusCodec(sampleRateHz = BROWSER_OPUS_SAMPLE_RATE_HZ) {
+    const encoder = new OpusEncoder({ channels: 1, sample_rate: sampleRateHz, application: "voip" });
+    const decoder = new OpusDecoder({ channels: 1, sample_rate: sampleRateHz });
+    const frameSamples = Math.max(1, Math.round((sampleRateHz * BROWSER_OPUS_FRAME_DURATION_MS) / 1000));
+    let encodeRemainder = new Int16Array(0);
+    return {
+        sampleRateHz,
+        frameSamples,
+        reset() {
+            encodeRemainder = new Int16Array(0);
+        },
+        decodeOpusFrame(wire) {
+            return pcm16BytesToSamples(decoder.decode(wire));
+        },
+        encodePcm16Frame(samples, flush = false) {
+            const pending = new Int16Array(encodeRemainder.length + samples.length);
+            pending.set(encodeRemainder);
+            pending.set(samples, encodeRemainder.length);
+            const completeFrames = Math.floor(pending.length / frameSamples);
+            const frames = [];
+            for (let index = 0; index < completeFrames; index += 1) {
+                const frame = pending.subarray(index * frameSamples, (index + 1) * frameSamples);
+                frames.push(encoder.encode(pcm16SamplesToBytes(frame)));
+            }
+            const consumed = completeFrames * frameSamples;
+            const remainder = pending.subarray(consumed);
+            if (flush && remainder.length > 0) {
+                const padded = new Int16Array(frameSamples);
+                padded.set(remainder);
+                frames.push(encoder.encode(pcm16SamplesToBytes(padded)));
+                encodeRemainder = new Int16Array(0);
+            }
+            else {
+                encodeRemainder = new Int16Array(remainder);
+            }
+            return frames;
+        },
+    };
+}
+export function decodeBrowserOpusToPcm16Bytes(wire, codec) {
+    return pcm16SamplesToBytes(codec.decodeOpusFrame(wire));
+}
+//# sourceMappingURL=browser-opus.js.map

package/dist/browser-opus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-opus.js","sourceRoot":"","sources":["../src/browser-opus.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtF,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAM,CAAC;AAClD,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,CAAC;AAUjD,MAAM,UAAU,sBAAsB,CAAC,YAAY,GAAG,2BAA2B;IAC/E,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,YAAqB,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1G,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,YAAqB,EAAE,CAAC,CAAC;IACrF,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,8BAA8B,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACrG,IAAI,eAAe,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAExC,OAAO;QACL,YAAY;QACZ,YAAY;QACZ,KAAK;YACH,eAAe,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;QACtC,CAAC;QACD,eAAe,CAAC,IAAgB;YAC9B,OAAO,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACnD,CAAC;QACD,gBAAgB,CAAC,OAAmB,EAAE,KAAK,GAAG,KAAK;YACjD,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,eAAe,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YACxE,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;YAC7C,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC;YACjE,MAAM,MAAM,GAAiB,EAAE,CAAC;YAChC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,cAAc,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;gBACvD,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,GAAG,YAAY,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC;gBACjF,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC1D,CAAC;YACD,MAAM,QAAQ,GAAG,cAAc,GAAG,YAAY,CAAC;YAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC7C,IAAI,KAAK,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC;gBAC5C,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACzD,eAAe,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACN,eAAe,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;YAC9C,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,IAAgB,EAAE,KAAuB;IACrF,OAAO,mBAAmB,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/carrier-commands.d.ts

@@ -0,0 +1,124 @@
+import type { CallTransferPacket, DtmfSendPacket } from "@kuralle-syrinx/core";
+export interface TwilioSendDigitsCommand {
+    readonly carrier: "twilio";
+    readonly kind: "send_digits";
+    /** REST Calls API path segment after /2010-04-01/Accounts/{AccountSid} */
+    readonly path: string;
+    readonly method: "POST";
+    readonly form: {
+        readonly SendDigits: string;
+    };
+    /** Equivalent TwiML fragment for a voice response webhook. */
+    readonly twiml: string;
+}
+export interface TelnyxSendDtmfCommand {
+    readonly carrier: "telnyx";
+    readonly kind: "send_dtmf";
+    readonly path: string;
+    readonly method: "POST";
+    readonly json: {
+        readonly digits: string;
+        readonly duration_millis?: number;
+    };
+}
+export type SendDtmfCommand = TwilioSendDigitsCommand | TelnyxSendDtmfCommand;
+/**
+ * Twilio DTMF via Calls API `SendDigits` / TwiML `<Play digits="...">`.
+ * Pause letters `w`/`W` pass through unchanged (Twilio's native pause syntax).
+ * Live dispatch unverified.
+ */
+export declare function buildTwilioSendDigits(callSid: string, packet: Pick<DtmfSendPacket, "digits">): TwilioSendDigitsCommand;
+/**
+ * Telnyx Call Control `send_dtmf`. Pause letters retained in the digits string.
+ * Live dispatch unverified.
+ */
+export declare function buildTelnyxSendDtmf(callControlId: string, packet: Pick<DtmfSendPacket, "digits">, opts?: {
+    readonly durationMillis?: number;
+}): TelnyxSendDtmfCommand;
+export interface TwilioTransferCommand {
+    readonly carrier: "twilio";
+    readonly kind: "transfer";
+    readonly mode: CallTransferPacket["mode"];
+    readonly path: string;
+    readonly method: "POST";
+    /**
+     * Calls API redirect: set Url to a TwiML Bin / webhook that dials the target.
+     * For cold/warm we emit the Dial TwiML the webhook would return.
+     */
+    readonly form: {
+        readonly Url?: string;
+        readonly Method?: "POST" | "GET";
+        readonly Twiml?: string;
+    };
+    readonly twiml: string;
+    /** Warm-handoff summary when mode is warm (not on the wire — for the receiving app). */
+    readonly summary?: string;
+}
+export interface TelnyxTransferCommand {
+    readonly carrier: "telnyx";
+    readonly kind: "transfer";
+    readonly mode: CallTransferPacket["mode"];
+    readonly path: string;
+    readonly method: "POST";
+    readonly json: {
+        readonly to: string;
+        /** Prefer Call-Control transfer over SIP REFER (attestation B penalty). */
+        readonly command_id?: string;
+        readonly client_state?: string;
+        readonly webhook_url?: string;
+    };
+    readonly summary?: string;
+}
+export type TransferCommand = TwilioTransferCommand | TelnyxTransferCommand;
+/**
+ * Twilio transfer via Calls API Twiml/Url redirect.
+ * Prefer `<Dial>` (Call-Control style) over SIP REFER — REFER drops STIR/SHAKEN
+ * attestation to B and hurts answer rate.
+ * Live dispatch unverified.
+ */
+export declare function buildTwilioTransfer(callSid: string, packet: Pick<CallTransferPacket, "mode" | "target" | "summary">, opts?: {
+    readonly redirectUrl?: string;
+}): TwilioTransferCommand;
+/**
+ * Telnyx Call Control `transfer`. Prefer this over SIP REFER (mode sip_refer still
+ * uses the transfer action with the SIP URI as `to` — Call Control, not raw REFER).
+ * Live dispatch unverified.
+ */
+export declare function buildTelnyxTransfer(callControlId: string, packet: Pick<CallTransferPacket, "mode" | "target" | "summary">, opts?: {
+    readonly webhookUrl?: string;
+    readonly commandId?: string;
+}): TelnyxTransferCommand;
+export interface TwilioRestCredentials {
+    readonly accountSid: string;
+    readonly authToken: string;
+    /** Default https://api.twilio.com/2010-04-01/Accounts/{AccountSid} */
+    readonly baseUrl?: string;
+}
+export interface TelnyxRestCredentials {
+    readonly apiKey: string;
+    /** Default https://api.telnyx.com */
+    readonly baseUrl?: string;
+}
+export type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+/**
+ * Dispatch a Twilio form POST via global `fetch()`. Credentials injected —
+ * never reads process.env (Workers-safe). Live call unverified.
+ */
+export declare function dispatchTwilioCommand(creds: TwilioRestCredentials, command: TwilioSendDigitsCommand | TwilioTransferCommand, fetchImpl?: FetchLike): Promise<Response>;
+/**
+ * Dispatch a Telnyx Call Control JSON POST via global `fetch()`. Credentials
+ * injected — never reads process.env (Workers-safe). Live call unverified.
+ */
+export declare function dispatchTelnyxCommand(creds: TelnyxRestCredentials, command: TelnyxSendDtmfCommand | TelnyxTransferCommand, fetchImpl?: FetchLike): Promise<Response>;
+/**
+ * Injectable summarizer for warm transfer. The transport calls this when a
+ * `call.transfer` packet has mode `"warm"` and no `summary` yet. Do NOT build
+ * a bespoke LLM here — inject your reasoner/app hook.
+ */
+export type WarmTransferSummarizer = (args: {
+    readonly contextId: string;
+    readonly target: string;
+}) => string | Promise<string | undefined> | undefined;
+/** Resolve summary: packet.summary wins; else optional summarizer; else undefined. */
+export declare function resolveTransferSummary(packet: CallTransferPacket, summarizer?: WarmTransferSummarizer): Promise<string | undefined>;
+//# sourceMappingURL=carrier-commands.d.ts.map

package/dist/carrier-commands.d.ts.map

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