@kuralle-syrinx/core 4.4.0 → 4.5.0

package/dist/audio/pcm.js

@@ -0,0 +1,40 @@
+// SPDX-License-Identifier: MIT
+export function pcm16BytesToSamples(audio) {
+    if (audio.byteLength % 2 !== 0) {
+        throw new Error("PCM16 audio payload must contain an even number of bytes");
+    }
+    const view = new DataView(audio.buffer, audio.byteOffset, audio.byteLength);
+    const samples = new Int16Array(audio.byteLength / 2);
+    for (let i = 0; i < samples.length; i += 1) {
+        samples[i] = view.getInt16(i * 2, true);
+    }
+    return samples;
+}
+export function pcm16SamplesToBytes(samples) {
+    const bytes = new Uint8Array(samples.byteLength);
+    const view = new DataView(bytes.buffer);
+    for (let i = 0; i < samples.length; i += 1) {
+        view.setInt16(i * 2, samples[i], true);
+    }
+    return bytes;
+}
+export function bigEndianPcm16BytesToSamples(audio) {
+    if (audio.byteLength % 2 !== 0) {
+        throw new Error("L16 audio payload must contain an even number of bytes");
+    }
+    const view = new DataView(audio.buffer, audio.byteOffset, audio.byteLength);
+    const samples = new Int16Array(audio.byteLength / 2);
+    for (let i = 0; i < samples.length; i += 1) {
+        samples[i] = view.getInt16(i * 2, false);
+    }
+    return samples;
+}
+export function pcm16SamplesToBigEndianBytes(samples) {
+    const bytes = new Uint8Array(samples.byteLength);
+    const view = new DataView(bytes.buffer);
+    for (let i = 0; i < samples.length; i += 1) {
+        view.setInt16(i * 2, samples[i], false);
+    }
+    return bytes;
+}
+//# sourceMappingURL=pcm.js.map

package/dist/audio/pcm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pcm.js","sourceRoot":"","sources":["../../src/audio/pcm.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,MAAM,UAAU,mBAAmB,CAAC,KAAiB;IACnD,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IACrD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAmB;IACrD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAE,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,KAAiB;IAC5D,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IACrD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,OAAmB;IAC9D,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAE,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/audio/resample.d.ts

@@ -0,0 +1,12 @@
+export declare function resamplePcm16(input: Int16Array, sourceSampleRateHz: number, targetSampleRateHz: number): Int16Array;
+export declare class StreamingPcm16Resampler {
+    private history;
+    private readonly ratio;
+    private readonly fir;
+    private readonly sourceSampleRateHz;
+    private readonly targetSampleRateHz;
+    constructor(sourceSampleRateHz: number, targetSampleRateHz: number);
+    process(input: Int16Array): Int16Array;
+}
+export declare function resamplePcm16Streaming(resamplers: Map<string, StreamingPcm16Resampler>, input: Int16Array, sourceSampleRateHz: number, targetSampleRateHz: number): Int16Array;
+//# sourceMappingURL=resample.d.ts.map

package/dist/audio/resample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resample.d.ts","sourceRoot":"","sources":["../../src/audio/resample.ts"],"names":[],"mappings":"AA0FA,wBAAgB,aAAa,CAC3B,KAAK,EAAE,UAAU,EACjB,kBAAkB,EAAE,MAAM,EAC1B,kBAAkB,EAAE,MAAM,GACzB,UAAU,CAcZ;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAsB;IAC1C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;gBAEhC,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM;IAYlE,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU;CA8BvC;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,EAChD,KAAK,EAAE,UAAU,EACjB,kBAAkB,EAAE,MAAM,EAC1B,kBAAkB,EAAE,MAAM,GACzB,UAAU,CAUZ"}

package/dist/audio/resample.js

@@ -0,0 +1,157 @@
+// SPDX-License-Identifier: MIT
+// Windowed-sinc FIR low-pass filter for anti-alias downsampling.
+// Hann window, 127 taps — gives ~44 dB min stopband attenuation, sufficient for
+// the ≥40 dB alias-suppression requirement (F3). A polyphase structure would be
+// faster but this direct-form is simpler to audit and correct for our frame sizes.
+const FIR_TAPS = 127;
+function buildLowPassFir(cutoffNormalized) {
+    // cutoffNormalized: fraction of the source sample rate (0 = DC, 0.5 = Nyquist).
+    const M = FIR_TAPS - 1; // filter order (126 for 127 taps)
+    const h = new Float64Array(FIR_TAPS);
+    let sum = 0;
+    for (let n = 0; n < FIR_TAPS; n += 1) {
+        const delay = n - M / 2; // centered delay: -63..0..63
+        const sinc = delay === 0
+            ? 2 * cutoffNormalized
+            : Math.sin(2 * Math.PI * cutoffNormalized * delay) / (Math.PI * delay);
+        const hann = 0.5 - 0.5 * Math.cos((2 * Math.PI * n) / M);
+        h[n] = sinc * hann;
+        sum += h[n];
+    }
+    // Normalize for unity DC gain.
+    for (let n = 0; n < FIR_TAPS; n += 1) {
+        h[n] /= sum;
+    }
+    return h;
+}
+// The FIR depends only on the (source,target) rate pair via its cutoff, which is
+// constant per connection. resamplePcm16 runs per audio chunk in the hot path, so
+// cache the kernel instead of rebuilding 127 sinc·Hann taps on every call. Bounded:
+// real deployments use a handful of distinct rate pairs (24k/16k→8k, 48k→16k, …).
+const firCache = new Map();
+function getLowPassFir(cutoffNormalized) {
+    const key = Math.round(cutoffNormalized * 1e6);
+    let fir = firCache.get(key);
+    if (fir === undefined) {
+        fir = buildLowPassFir(cutoffNormalized);
+        firCache.set(key, fir);
+    }
+    return fir;
+}
+// Evaluate the symmetric FIR centered at each decimated output position.
+// Using the symmetric (zero-delay) formula avoids a group-delay shift at the
+// cost of needing halfTaps future samples — which are available because we
+// process a complete chunk at once.  Edge samples (first / last halfTaps/ratio
+// output samples) use only the available taps; their amplitude tapers due to
+// the missing context, which is the accepted trade-off for stateless chunk
+// processing.
+function firDecimate(input, outputLength, ratio, fir) {
+    const M = fir.length;
+    const halfTaps = Math.floor(M / 2); // 63 for 127-tap filter
+    const output = new Int16Array(outputLength);
+    for (let m = 0; m < outputLength; m += 1) {
+        const n0 = Math.round(m * ratio); // nearest source position for output m
+        let acc = 0;
+        // Centered: h[0] multiplies x[n0+halfTaps], h[halfTaps] multiplies x[n0],
+        // h[M-1] multiplies x[n0-halfTaps].
+        for (let k = 0; k < M; k += 1) {
+            const srcIdx = n0 - k + halfTaps;
+            if (srcIdx >= 0 && srcIdx < input.length) {
+                acc += fir[k] * input[srcIdx];
+            }
+        }
+        // Clamp to Int16 range; FIR sum can slightly exceed due to rounding.
+        output[m] = Math.max(-32768, Math.min(32767, Math.round(acc)));
+    }
+    return output;
+}
+function linearInterpolate(input, outputLength, ratio) {
+    const output = new Int16Array(outputLength);
+    for (let i = 0; i < outputLength; i += 1) {
+        const pos = i * ratio;
+        const lo = Math.floor(pos);
+        const hi = Math.min(input.length - 1, lo + 1);
+        const frac = pos - lo;
+        output[i] = Math.round(input[lo] * (1 - frac) + input[hi] * frac);
+    }
+    return output;
+}
+function outputLengthFor(inputLength, sourceSampleRateHz, targetSampleRateHz) {
+    return Math.max(1, Math.round((inputLength * targetSampleRateHz) / sourceSampleRateHz));
+}
+export function resamplePcm16(input, sourceSampleRateHz, targetSampleRateHz) {
+    if (input.length === 0)
+        return new Int16Array(0);
+    if (sourceSampleRateHz === targetSampleRateHz)
+        return input;
+    const outputLength = outputLengthFor(input.length, sourceSampleRateHz, targetSampleRateHz);
+    const ratio = sourceSampleRateHz / targetSampleRateHz;
+    if (ratio <= 1) {
+        return linearInterpolate(input, outputLength, ratio);
+    }
+    const cutoffNormalized = (0.45 * targetSampleRateHz) / sourceSampleRateHz;
+    const fir = getLowPassFir(cutoffNormalized);
+    return firDecimate(input, outputLength, ratio, fir);
+}
+export class StreamingPcm16Resampler {
+    history = new Int16Array(0);
+    ratio;
+    fir;
+    sourceSampleRateHz;
+    targetSampleRateHz;
+    constructor(sourceSampleRateHz, targetSampleRateHz) {
+        this.sourceSampleRateHz = sourceSampleRateHz;
+        this.targetSampleRateHz = targetSampleRateHz;
+        this.ratio = sourceSampleRateHz / targetSampleRateHz;
+        if (this.ratio > 1) {
+            const cutoffNormalized = (0.45 * targetSampleRateHz) / sourceSampleRateHz;
+            this.fir = getLowPassFir(cutoffNormalized);
+        }
+        else {
+            this.fir = null;
+        }
+    }
+    process(input) {
+        if (input.length === 0)
+            return new Int16Array(0);
+        if (this.sourceSampleRateHz === this.targetSampleRateHz)
+            return input;
+        if (this.ratio <= 1 || this.fir === null) {
+            const outputLength = outputLengthFor(input.length, this.sourceSampleRateHz, this.targetSampleRateHz);
+            return linearInterpolate(input, outputLength, this.ratio);
+        }
+        const historyLength = this.history.length;
+        const combined = new Int16Array(historyLength + input.length);
+        combined.set(this.history, 0);
+        combined.set(input, historyLength);
+        const fullOutputLength = outputLengthFor(combined.length, this.sourceSampleRateHz, this.targetSampleRateHz);
+        const fullOutput = firDecimate(combined, fullOutputLength, this.ratio, this.fir);
+        let firstNewOutput = 0;
+        if (historyLength > 0) {
+            while (firstNewOutput < fullOutput.length) {
+                const centerInputIndex = Math.round(firstNewOutput * this.ratio);
+                if (centerInputIndex >= historyLength)
+                    break;
+                firstNewOutput += 1;
+            }
+        }
+        const output = fullOutput.subarray(firstNewOutput);
+        const keepHistory = Math.min(FIR_TAPS - 1, combined.length);
+        this.history = combined.subarray(combined.length - keepHistory);
+        return output;
+    }
+}
+export function resamplePcm16Streaming(resamplers, input, sourceSampleRateHz, targetSampleRateHz) {
+    if (input.length === 0)
+        return new Int16Array(0);
+    if (sourceSampleRateHz === targetSampleRateHz)
+        return input;
+    const key = `${String(sourceSampleRateHz)}->${String(targetSampleRateHz)}`;
+    let resampler = resamplers.get(key);
+    if (!resampler) {
+        resampler = new StreamingPcm16Resampler(sourceSampleRateHz, targetSampleRateHz);
+        resamplers.set(key, resampler);
+    }
+    return resampler.process(input);
+}
+//# sourceMappingURL=resample.js.map

package/dist/audio/resample.js.map

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

package/dist/audio-envelope.d.ts

@@ -0,0 +1,23 @@
+import type { AudioFormat } from "./packets.js";
+export declare const SYRINX_AUDIO_ENVELOPE_NAME: "syrinx.audio.v1";
+export declare const SYRINX_AUDIO_ENVELOPE_MAGIC: Uint8Array<ArrayBuffer>;
+export interface SyrinxAudioEnvelopeHeader {
+    readonly type: "audio";
+    readonly contextId?: string;
+    readonly sampleRateHz: number;
+    readonly sequence?: number;
+    readonly encoding?: "pcm_s16le" | "opus";
+    readonly channels?: 1;
+    readonly byteLength?: number;
+    readonly durationMs?: number;
+}
+export interface SyrinxAudioEnvelope {
+    readonly header: SyrinxAudioEnvelopeHeader;
+    readonly audio: Uint8Array;
+}
+export declare function assertAudioFormat(format: AudioFormat): void;
+export declare function assertAudioPayload(format: AudioFormat, audio: Uint8Array): void;
+export declare function encodeSyrinxAudioEnvelope(header: SyrinxAudioEnvelopeHeader, audio: Uint8Array): Uint8Array;
+export declare function decodeSyrinxAudioEnvelope(data: Uint8Array): SyrinxAudioEnvelope;
+export declare function hasSyrinxAudioEnvelope(data: Uint8Array): boolean;
+//# sourceMappingURL=audio-envelope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audio-envelope.d.ts","sourceRoot":"","sources":["../src/audio-envelope.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,eAAO,MAAM,0BAA0B,EAAG,iBAA0B,CAAC;AACrE,eAAO,MAAM,2BAA2B,yBAA+C,CAAC;AAExF,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAK3D;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAgB/E;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,EAAE,KAAK,EAAE,UAAU,GAAG,UAAU,CAU1G;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,UAAU,GAAG,mBAAmB,CA2B/E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAMhE"}

package/dist/audio-envelope.js

@@ -0,0 +1,114 @@
+// SPDX-License-Identifier: MIT
+export const SYRINX_AUDIO_ENVELOPE_NAME = "syrinx.audio.v1";
+export const SYRINX_AUDIO_ENVELOPE_MAGIC = new Uint8Array([83, 89, 82, 88, 65, 49, 10]);
+export function assertAudioFormat(format) {
+    if (format.channels !== 1)
+        throw new Error("audio must be mono");
+    if (!Number.isInteger(format.sampleRateHz) || format.sampleRateHz <= 0) {
+        throw new Error("sampleRateHz must be a positive integer");
+    }
+}
+export function assertAudioPayload(format, audio) {
+    if (format.encoding === "opus") {
+        if (audio.byteLength === 0) {
+            throw new Error("opus payload must not be empty");
+        }
+        return;
+    }
+    if (format.encoding === "mulaw") {
+        if (audio.byteLength === 0) {
+            throw new Error("mulaw payload must not be empty");
+        }
+        return;
+    }
+    if (audio.byteLength % 2 !== 0) {
+        throw new Error("PCM16 payload must contain an even number of bytes");
+    }
+}
+export function encodeSyrinxAudioEnvelope(header, audio) {
+    validateSyrinxAudioEnvelope(header, audio);
+    const headerBytes = new TextEncoder().encode(JSON.stringify(header));
+    const output = new Uint8Array(SYRINX_AUDIO_ENVELOPE_MAGIC.byteLength + 4 + headerBytes.byteLength + audio.byteLength);
+    output.set(SYRINX_AUDIO_ENVELOPE_MAGIC, 0);
+    new DataView(output.buffer, output.byteOffset, output.byteLength)
+        .setUint32(SYRINX_AUDIO_ENVELOPE_MAGIC.byteLength, headerBytes.byteLength, true);
+    output.set(headerBytes, SYRINX_AUDIO_ENVELOPE_MAGIC.byteLength + 4);
+    output.set(audio, SYRINX_AUDIO_ENVELOPE_MAGIC.byteLength + 4 + headerBytes.byteLength);
+    return output;
+}
+export function decodeSyrinxAudioEnvelope(data) {
+    if (!hasSyrinxAudioEnvelope(data)) {
+        throw new Error("Syrinx binary audio envelope magic is missing");
+    }
+    const headerLengthOffset = SYRINX_AUDIO_ENVELOPE_MAGIC.byteLength;
+    if (data.byteLength < headerLengthOffset + 4) {
+        throw new Error("Syrinx binary audio envelope is truncated");
+    }
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    const headerLength = view.getUint32(headerLengthOffset, true);
+    const headerStart = headerLengthOffset + 4;
+    const headerEnd = headerStart + headerLength;
+    if (headerLength <= 0 || headerEnd > data.byteLength) {
+        throw new Error("Syrinx binary audio envelope has an invalid header length");
+    }
+    const parsed = JSON.parse(new TextDecoder().decode(data.subarray(headerStart, headerEnd)));
+    if (!parsed || typeof parsed !== "object") {
+        throw new Error("Syrinx binary audio envelope header must be an object");
+    }
+    const header = parsed;
+    const audio = data.subarray(headerEnd);
+    validateSyrinxAudioEnvelope(header, audio);
+    return { header, audio };
+}
+export function hasSyrinxAudioEnvelope(data) {
+    if (data.byteLength < SYRINX_AUDIO_ENVELOPE_MAGIC.byteLength)
+        return false;
+    for (let i = 0; i < SYRINX_AUDIO_ENVELOPE_MAGIC.byteLength; i += 1) {
+        if (data[i] !== SYRINX_AUDIO_ENVELOPE_MAGIC[i])
+            return false;
+    }
+    return true;
+}
+function validateSyrinxAudioEnvelope(header, audio) {
+    if (header.type !== "audio") {
+        throw new Error("Syrinx binary audio envelope type must be audio");
+    }
+    if (!isPositiveInteger(header.sampleRateHz)) {
+        throw new Error("Syrinx binary audio envelope sampleRateHz must be a positive integer");
+    }
+    if (header.encoding && header.encoding !== "pcm_s16le" && header.encoding !== "opus") {
+        throw new Error(`Unsupported Syrinx binary audio encoding: ${header.encoding}`);
+    }
+    if (header.sequence !== undefined && !isNonNegativeInteger(header.sequence)) {
+        throw new Error("Syrinx binary audio envelope sequence must be a non-negative integer");
+    }
+    if (header.durationMs !== undefined && !isNonNegativeInteger(header.durationMs)) {
+        throw new Error("Syrinx binary audio envelope durationMs must be a non-negative integer");
+    }
+    if (header.byteLength !== undefined && !isNonNegativeInteger(header.byteLength)) {
+        throw new Error("Syrinx binary audio envelope byteLength must be a non-negative integer");
+    }
+    if (header.byteLength !== undefined && header.byteLength !== audio.byteLength) {
+        throw new Error("Syrinx binary audio envelope byteLength does not match payload");
+    }
+    const format = {
+        encoding: header.encoding === "opus" ? "opus" : "pcm_s16le",
+        sampleRateHz: header.sampleRateHz,
+        channels: header.channels ?? 1,
+    };
+    assertAudioFormat(format);
+    assertAudioPayload(format, audio);
+    if (format.encoding !== "opus" && header.durationMs !== undefined) {
+        const expectedDurationMs = Math.round((audio.byteLength / 2 / header.sampleRateHz) * 1000);
+        if (Math.abs(header.durationMs - expectedDurationMs) > 1) {
+            throw new Error("Syrinx binary audio envelope durationMs does not match payload and sampleRateHz");
+        }
+    }
+}
+function isPositiveInteger(value) {
+    return typeof value === "number" && Number.isInteger(value) && value > 0;
+}
+function isNonNegativeInteger(value) {
+    return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
+//# sourceMappingURL=audio-envelope.js.map

package/dist/audio-envelope.js.map

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

package/dist/confidence-to-wait.d.ts

@@ -0,0 +1,12 @@
+export interface ConfidenceToWaitConfig {
+    /** Wait at confidence = 1.0 (high EOT certainty). Default: 150 ms. */
+    readonly minWaitMs?: number;
+    /** Wait at confidence = 0.0 (low EOT certainty). Default: 2000 ms. */
+    readonly maxWaitMs?: number;
+}
+/**
+ * Maps an end-of-turn confidence score to a bounded finalize wait (LiveKit-style).
+ * Higher confidence → shorter wait. Monotonic, clamped, deterministic.
+ */
+export declare function confidenceToWaitMs(confidence: number, config?: ConfidenceToWaitConfig): number;
+//# sourceMappingURL=confidence-to-wait.d.ts.map

package/dist/confidence-to-wait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence-to-wait.d.ts","sourceRoot":"","sources":["../src/confidence-to-wait.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACrC,sEAAsE;IACtE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAKD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,sBAA2B,GAClC,MAAM,CAUR"}

package/dist/confidence-to-wait.js

@@ -0,0 +1,18 @@
+// SPDX-License-Identifier: MIT
+const DEFAULT_MIN_WAIT_MS = 150;
+const DEFAULT_MAX_WAIT_MS = 2000;
+/**
+ * Maps an end-of-turn confidence score to a bounded finalize wait (LiveKit-style).
+ * Higher confidence → shorter wait. Monotonic, clamped, deterministic.
+ */
+export function confidenceToWaitMs(confidence, config = {}) {
+    const minWaitMs = config.minWaitMs ?? DEFAULT_MIN_WAIT_MS;
+    const maxWaitMs = config.maxWaitMs ?? DEFAULT_MAX_WAIT_MS;
+    if (maxWaitMs < minWaitMs) {
+        throw new Error(`maxWaitMs (${String(maxWaitMs)}) must be >= minWaitMs (${String(minWaitMs)})`);
+    }
+    const clamped = Math.min(1, Math.max(0, confidence));
+    const span = maxWaitMs - minWaitMs;
+    return Math.round(maxWaitMs - clamped * span);
+}
+//# sourceMappingURL=confidence-to-wait.js.map

package/dist/confidence-to-wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence-to-wait.js","sourceRoot":"","sources":["../src/confidence-to-wait.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAS/B,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAChC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAEjC;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAkB,EAClB,SAAiC,EAAE;IAEnC,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,mBAAmB,CAAC;IAC1D,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,mBAAmB,CAAC;IAC1D,IAAI,SAAS,GAAG,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,cAAc,MAAM,CAAC,SAAS,CAAC,2BAA2B,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAClG,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,SAAS,GAAG,SAAS,CAAC;IACnC,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;AAChD,CAAC"}

package/dist/conversation-event.d.ts

@@ -0,0 +1,19 @@
+export interface ConversationEvent {
+    /** Component that emitted the event: "vad", "stt", "eos", "llm", "tts", "tool", "session", "turn" */
+    readonly component: string;
+    /** Sub-type: "speech_started", "interim", "final", "delta", "first_audio", "call_started", etc. */
+    readonly type: string;
+    /** Arbitrary key-value payload. Always includes "context_id". */
+    readonly data: Readonly<Record<string, string>>;
+    /** Wall-clock time of the event in ms since epoch. */
+    readonly timestampMs: number;
+}
+/**
+ * Create a ReadableStream of ConversationEvents that is fed by a callback.
+ * Returns [stream, push] — call push(event) to enqueue, consumers read from stream.
+ */
+export declare function createConversationEventStream(): [
+    ReadableStream<ConversationEvent>,
+    (event: ConversationEvent) => void
+];
+//# sourceMappingURL=conversation-event.d.ts.map

package/dist/conversation-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-event.d.ts","sourceRoot":"","sources":["../src/conversation-event.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,iBAAiB;IAChC,qGAAqG;IACrG,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mGAAmG;IACnG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,sDAAsD;IACtD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAMD;;;GAGG;AACH,wBAAgB,6BAA6B,IAAI;IAC/C,cAAc,CAAC,iBAAiB,CAAC;IACjC,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI;CACnC,CA4BA"}

package/dist/conversation-event.js

@@ -0,0 +1,44 @@
+// SPDX-License-Identifier: MIT
+//
+// Syrinx Kernel v2 — Conversation Event (Debug Stream)
+//
+// Normalized event type consumed by debugger UIs and the VoiceSessionRecorder.
+// Every pipeline component emits these alongside their functional packets.
+// Exposed as `session.debugEvents: ReadableStream<ConversationEvent>`.
+//
+// Design decision (per RFC Q3 resolution): events flow through the bus on
+// the Background route. If Background saturates, drops are metric'd.
+// =============================================================================
+// Factory
+// =============================================================================
+/**
+ * Create a ReadableStream of ConversationEvents that is fed by a callback.
+ * Returns [stream, push] — call push(event) to enqueue, consumers read from stream.
+ */
+export function createConversationEventStream() {
+    let controller = null;
+    const stream = new ReadableStream({
+        start(c) {
+            controller = c;
+        },
+        cancel() {
+            controller = null;
+        },
+    });
+    const push = (event) => {
+        // Only retain events when a reader is attached. A ReadableStream buffers
+        // enqueue() without bound; with no debug consumer (nothing in-tree reads this
+        // by default) every packet's event would be retained for the whole call and
+        // grow memory unbounded. `locked` is true once getReader() is called.
+        if (controller && stream.locked) {
+            try {
+                controller.enqueue(event);
+            }
+            catch {
+                // Stream closed — drop
+            }
+        }
+    };
+    return [stream, push];
+}
+//# sourceMappingURL=conversation-event.js.map

package/dist/conversation-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-event.js","sourceRoot":"","sources":["../src/conversation-event.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,uDAAuD;AACvD,EAAE;AACF,+EAA+E;AAC/E,2EAA2E;AAC3E,uEAAuE;AACvE,EAAE;AACF,0EAA0E;AAC1E,qEAAqE;AAiBrE,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,UAAU,6BAA6B;IAI3C,IAAI,UAAU,GACZ,IAAI,CAAC;IAEP,MAAM,MAAM,GAAG,IAAI,cAAc,CAAoB;QACnD,KAAK,CAAC,CAAC;YACL,UAAU,GAAG,CAAC,CAAC;QACjB,CAAC;QACD,MAAM;YACJ,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,CAAC,KAAwB,EAAQ,EAAE;QAC9C,yEAAyE;QACzE,8EAA8E;QAC9E,4EAA4E;QAC5E,sEAAsE;QACtE,IAAI,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,uBAAuB;YACzB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/error-handler.d.ts

@@ -0,0 +1,35 @@
+import { ErrorCategory, type VoiceErrorPacket } from "./packets.js";
+/**
+ * Categorize an error from the STT provider.
+ *
+ * Heuristic:
+ *   - HTTP 429 → RateLimit (recoverable)
+ *   - Network errors (ECONNRESET, ETIMEDOUT, ENOTFOUND) → NetworkTimeout (recoverable)
+ *   - HTTP 401/403 → Authentication (fatal)
+ *   - HTTP 400/422 → InvalidInput (fatal)
+ *   - HTTP 402 → ResourceExhausted (fatal)
+ *   - Everything else → InternalFault (fatal)
+ */
+export declare function categorizeSttError(err: unknown): ErrorCategory;
+/**
+ * Categorize an error from the TTS provider.
+ * Same heuristic as STT — TTS providers have similar error patterns.
+ */
+export declare function categorizeTtsError(err: unknown): ErrorCategory;
+/**
+ * Categorize an error from the LLM provider.
+ *
+ * Additional LLM-specific heuristics:
+ *   - "context length exceeded" → InvalidInput (fatal)
+ *   - "content filter" / "safety" → InvalidInput (fatal)
+ */
+export declare function categorizeLlmError(err: unknown): ErrorCategory;
+/**
+ * Returns true if the error category is recoverable (retry with backoff).
+ */
+export declare function isRecoverable(category: ErrorCategory): boolean;
+/**
+ * Returns true if the error packet represents a fatal error.
+ */
+export declare function isFatalError(pkt: VoiceErrorPacket): boolean;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAMpE;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAiD9D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAE9D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAc9D;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAE9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAE3D"}