@liforma/client 0.3.0 → 0.4.1

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @liforma/client changelog
 
+## 0.4.1 — 2026-08-11
+
+### Added
+
+- `learningLocale` / `secondaryLocale` on `<Experience>`, React launch options, and `<liforma-experience learning-locale>` / `secondary-locale` / `locale` attributes
+- Browser mint defaults `locale` from `navigator.language` when omitted
+
+### Fixed
+
+- React `buildExperienceStartOptions` / `experienceLaunchKey` now pass and remint on learning/secondary locale
+
+## 0.4.0 — 2026-08-11
+
+### Added
+
+- First-class BYO voice helpers:
+  - `@liforma/client/elevenlabs` — `connectElevenLabsAgent`
+  - `@liforma/client/openai` — `connectOpenAiRealtime` / `connectOpenAiRealtimeWebRtc`
+  - `@liforma/client/deepgram` — `connectDeepgramAgent`
+  - `@liforma/client/google` — `connectGeminiLive`
+  - `@liforma/client/livekit` — `connectLiveKitAgent` (`createUtterance({ track })` + optional transcript)
+- Shared `@liforma/client/byo` primitives (`createTurnSession`, PCM/mic helpers, `BYO_PLAYBACK_GUIDANCE`)
+- Optional peers: `@elevenlabs/client`, `livekit-client`
+
+### Notes
+
+- Prefer these helpers over hand-rolled vendor WebSockets; see docs → Bring your own voice
+
 ## 0.3.0 — 2026-08-06
 
 ### Added

package/README.md

@@ -16,7 +16,7 @@ Portal (API keys & origins): [app.liforma.ai](https://app.liforma.ai)
 npm install @liforma/client
 ```
 
-Optional peers: `svelte` ^5 for the Svelte entry; `react` / `react-dom` ^18 or ^19 for React / Next.
+Optional peers: `svelte` ^5 for the Svelte entry; `react` / `react-dom` ^18 or ^19 for React / Next; `@elevenlabs/client` for `/elevenlabs`; `livekit-client` for `/livekit`. `/openai`, `/deepgram`, and `/google` use the browser WebSocket API (no extra peer). Shared BYO primitives live in `@liforma/client/byo` (used by the vendor helpers; rarely imported directly).
 
 ## Hello world
 
@@ -81,6 +81,12 @@ export function Demo() {
 | `@liforma/client/svelte` | `<Experience />`, `<ExperienceThumbnail />`, `<ExperienceWidget />` |
 | `@liforma/client/react` | React components |
 | `@liforma/client/next` | Next helpers + client components |
+| `@liforma/client/byo` | Shared BYO primitives (PCM/mic/turn helpers) |
+| `@liforma/client/elevenlabs` | `connectElevenLabsAgent` (BYO ElevenLabs Agents → avatar) |
+| `@liforma/client/openai` | `connectOpenAiRealtime` / `connectOpenAiRealtimeWebRtc` (BYO OpenAI Realtime → avatar) |
+| `@liforma/client/deepgram` | `connectDeepgramAgent` (BYO Deepgram Voice Agent → avatar) |
+| `@liforma/client/google` | `connectGeminiLive` (BYO Gemini Live → avatar) |
+| `@liforma/client/livekit` | `connectLiveKitAgent` (BYO LiveKit remote track → avatar) |
 | CDN `sdk/v2/client.js` | Web components + `window.Liforma` |
 
 ## Session minting
@@ -109,6 +115,13 @@ experience.on('started', async () => {
     audio: { url: 'https://cdn.example.com/line.mp3' },
     queue: 'append'
   });
+
+  // Vendor BYO helpers (install optional peers as needed):
+  // import { connectElevenLabsAgent } from '@liforma/client/elevenlabs';
+  // import { connectOpenAiRealtime } from '@liforma/client/openai';
+  // import { connectDeepgramAgent } from '@liforma/client/deepgram';
+  // import { connectGeminiLive } from '@liforma/client/google';
+  // import { connectLiveKitAgent } from '@liforma/client/livekit';
 });
 ```
 

package/dist/byo/audioCapture.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Shared Web Audio capture: AudioWorklet when available, ScriptProcessor fallback.
+ * Used by BYO mic uplink and MediaStreamTrack → PCM piping.
+ */
+export type AudioCaptureSession = {
+    stop(): void;
+    readonly fromSampleRate: number;
+    readonly usingWorklet: boolean;
+};
+export type StartAudioCaptureOptions = {
+    readonly mediaStream: MediaStream;
+    readonly targetSampleRate: number;
+    /** Called with pcm_s16le mono at targetSampleRate. */
+    readonly onPcm: (bytes: Uint8Array) => void;
+    /** When false, frames are dropped. */
+    readonly shouldSend?: () => boolean;
+    readonly onLog?: (line: string, kind?: 'info' | 'warn') => void;
+};
+/**
+ * Capture a MediaStream as pcm_s16le at targetSampleRate.
+ * Prefers AudioWorklet; falls back to ScriptProcessorNode.
+ */
+export declare function startAudioCapture(options: StartAudioCaptureOptions): Promise<AudioCaptureSession>;
+//# sourceMappingURL=audioCapture.d.ts.map

package/dist/byo/audioCapture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioCapture.d.ts","sourceRoot":"","sources":["../../src/byo/audioCapture.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,MAAM,mBAAmB,GAAG;IACjC,IAAI,IAAI,IAAI,CAAC;IACb,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACtC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAC5C,sCAAsC;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;CAChE,CAAC;AAsCF;;;GAGG;AACH,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,wBAAwB,GAC/B,OAAO,CAAC,mBAAmB,CAAC,CAoI9B"}

package/dist/byo/index.d.ts

@@ -0,0 +1,8 @@
+export type { ByoBridge, ByoConnectCallbacks, ByoMicCaptureOptions, ByoPcmExperience, ByoPcmSpeechController, ByoPlayExperience, ByoPlaySpeechController, ByoSpeechUtterance } from './types';
+export { BYO_PLAYBACK_GUIDANCE, MAX_PCM_CHUNK_BYTES, base64ToPcmBytes, floatToPcm16Le, parsePcmSampleRate, pcmBytesToBase64, resampleFloat32, writePcmInChunks } from './pcm';
+export { clearPcmByteCarry, createPcmByteCarry, takeEvenPcmBytes, type PcmByteCarry } from './pcmCarry';
+export { createCubicResampler, type FloatResampler } from './resample';
+export { startAudioCapture, type AudioCaptureSession, type StartAudioCaptureOptions } from './audioCapture';
+export { shouldCaptureMic, startPcmMic, type PcmMicSession, type StartPcmMicOptions } from './mic';
+export { createTurnSession, type ByoTurn, type ByoTurnSession, type CreateTurnSessionOptions } from './turn';
+//# sourceMappingURL=index.d.ts.map

package/dist/byo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/byo/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,SAAS,EACT,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACN,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,MAAM,OAAO,CAAC;AAEf,OAAO,EACN,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,YAAY,EACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAEvE,OAAO,EACN,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAEnG,OAAO,EACN,iBAAiB,EACjB,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAC7B,MAAM,QAAQ,CAAC"}

package/dist/byo/index.js

@@ -0,0 +1,307 @@
+//#region src/byo/pcm.ts
+var e = 64 * 1024, t = {
+	RECOMMENDED_CHUNK_MS_MIN: 20,
+	RECOMMENDED_CHUNK_MS_MAX: 200,
+	PLAYBACK_JITTER_BUFFER_MS: 150,
+	PLAYBACK_JITTER_BUFFER_MS_MIN: 80,
+	PLAYBACK_JITTER_BUFFER_MS_MAX: 250
+};
+function n(e) {
+	let t = atob(e), n = new Uint8Array(t.length);
+	for (let e = 0; e < t.length; e++) n[e] = t.charCodeAt(e);
+	return n;
+}
+function r(e) {
+	let t = "", n = 32768;
+	for (let r = 0; r < e.length; r += n) t += String.fromCharCode(...e.subarray(r, r + n));
+	return btoa(t);
+}
+function i(e) {
+	let t = new Uint8Array(e.length * 2), n = new DataView(t.buffer);
+	for (let t = 0; t < e.length; t++) {
+		let r = Math.max(-1, Math.min(1, e[t]));
+		n.setInt16(t * 2, r < 0 ? r * 32768 : r * 32767, !0);
+	}
+	return t;
+}
+function a(e, t, n) {
+	if (t === n || e.length === 0) return e;
+	let r = t / n, i = Math.max(1, Math.round(e.length / r)), a = new Float32Array(i);
+	for (let t = 0; t < i; t++) {
+		let n = t * r, i = Math.floor(n), o = Math.min(i + 1, e.length - 1), s = n - i;
+		a[t] = e[i] * (1 - s) + e[o] * s;
+	}
+	return a;
+}
+function o(e) {
+	let t = /^pcm_(\d+)$/.exec(e ?? "");
+	if (!t) return null;
+	let n = Number(t[1]);
+	return Number.isFinite(n) && n > 0 ? n : null;
+}
+async function s(t, n) {
+	if (n.byteLength === 0 || n.byteLength & 1 && (n = n.subarray(0, n.byteLength - 1), n.byteLength === 0)) return;
+	if (n.byteLength <= 65536) {
+		await t.write(n);
+		return;
+	}
+	let r = 0;
+	for (; r < n.byteLength;) {
+		let i = Math.min(r + e, n.byteLength);
+		if ((i - r) % 2 == 1 && --i, i <= r) break;
+		await t.write(n.subarray(r, i)), r = i;
+	}
+}
+//#endregion
+//#region src/byo/pcmCarry.ts
+function c() {
+	return { pending: null };
+}
+function l(e, t) {
+	let n = e.pending;
+	if (e.pending = null, n == null && t.byteLength === 0 || n == null && !(t.byteLength & 1)) return t;
+	let r = (n == null ? 0 : 1) + t.byteLength & -2;
+	if (r === 0) return e.pending = n ?? t[0] ?? null, new Uint8Array();
+	let i = new Uint8Array(r), a = 0;
+	n != null && (i[a++] = n);
+	let o = r - a;
+	return o > 0 && i.set(t.subarray(0, o), a), o < t.byteLength && (e.pending = t[t.byteLength - 1]), i;
+}
+function u(e) {
+	e.pending = null;
+}
+//#endregion
+//#region src/byo/resample.ts
+function d(e, t, n, r, i) {
+	let a = -.5 * e + 1.5 * t - 1.5 * n + .5 * r, o = e - 2.5 * t + 2 * n - .5 * r, s = -.5 * e + .5 * n, c = t;
+	return ((a * i + o) * i + s) * i + c;
+}
+function f(e, t) {
+	if (!(e > 0) || !(t > 0)) throw Error("Resampler rates must be positive");
+	if (e === t) return {
+		fromRate: e,
+		toRate: t,
+		push(e) {
+			return e;
+		},
+		flush() {
+			return new Float32Array();
+		}
+	};
+	let n = e / t, r = new Float32Array(), i = 0;
+	return {
+		fromRate: e,
+		toRate: t,
+		push(e) {
+			if (e.length === 0) return new Float32Array();
+			let t = new Float32Array(r.length + e.length);
+			if (t.set(r), t.set(e, r.length), r = t, r.length < 4) return new Float32Array();
+			let a = [];
+			for (; i + 2 < r.length - 1;) {
+				let e = Math.floor(i), t = i - e, o = Math.max(0, e - 1), s = Math.min(r.length - 1, e + 1), c = Math.min(r.length - 1, e + 2);
+				a.push(d(r[o], r[e], r[s], r[c], t)), i += n;
+			}
+			let o = Math.max(0, Math.floor(i) - 1);
+			return o > 0 && (r = r.subarray(o), i -= o), a.length ? Float32Array.from(a) : new Float32Array();
+		},
+		flush() {
+			return r.length === 0 ? new Float32Array() : (r = new Float32Array(), i = 0, new Float32Array());
+		}
+	};
+}
+//#endregion
+//#region src/byo/audioCapture.ts
+var p = "liforma-pcm-capture", m = `
+class LiformaPcmCaptureProcessor extends AudioWorkletProcessor {
+  process(inputs) {
+    const ch = inputs[0] && inputs[0][0];
+    if (ch && ch.length) {
+      const copy = new Float32Array(ch.length);
+      copy.set(ch);
+      this.port.postMessage(copy, [copy.buffer]);
+    }
+    return true;
+  }
+}
+registerProcessor('${p}', LiformaPcmCaptureProcessor);
+`, h = null;
+function g() {
+	return h ||= URL.createObjectURL(new Blob([m], { type: "application/javascript" })), h;
+}
+function _() {
+	return window.AudioContext || window.webkitAudioContext || null;
+}
+async function v(e) {
+	let { mediaStream: t, targetSampleRate: n, onPcm: r, shouldSend: a, onLog: o } = e, s = _();
+	if (!s) throw Error("Web Audio is required for audio capture");
+	let c = new s(), l = c.createMediaStreamSource(t), u = c.createGain();
+	u.gain.value = 0;
+	let d = c.sampleRate, m = f(d, n), h = !1, v = !1, y = (e) => {
+		if (h || a && !a()) return;
+		let t = m.push(e);
+		t.length !== 0 && r(i(t));
+	}, b = () => void 0;
+	return await (async () => {
+		if (typeof c.audioWorklet?.addModule != "function") return !1;
+		try {
+			await c.audioWorklet.addModule(g());
+			let e = new AudioWorkletNode(c, p, {
+				numberOfInputs: 1,
+				numberOfOutputs: 1,
+				outputChannelCount: [1]
+			});
+			return e.port.onmessage = (e) => {
+				e.data instanceof Float32Array && y(e.data);
+			}, l.connect(e), e.connect(u), u.connect(c.destination), b = () => {
+				e.port.onmessage = null;
+				try {
+					e.disconnect();
+				} catch {}
+				try {
+					l.disconnect();
+				} catch {}
+				try {
+					u.disconnect();
+				} catch {}
+			}, v = !0, !0;
+		} catch {
+			return !1;
+		}
+	})() ? o?.(`Mic/track capture via AudioWorklet at ${d} Hz → ${n} Hz`) : ((() => {
+		let e = c.createScriptProcessor?.bind(c);
+		if (!e) throw Error("Neither AudioWorklet nor ScriptProcessor is available");
+		let t = e(4096, 1, 1);
+		t.onaudioprocess = (e) => {
+			y(e.inputBuffer.getChannelData(0));
+		}, l.connect(t), t.connect(u), u.connect(c.destination), b = () => {
+			t.onaudioprocess = null;
+			try {
+				t.disconnect();
+			} catch {}
+			try {
+				l.disconnect();
+			} catch {}
+			try {
+				u.disconnect();
+			} catch {}
+		}, v = !1;
+	})(), o?.(`Mic/track capture via ScriptProcessor at ${d} Hz → ${n} Hz`, "warn")), c.state === "suspended" && await c.resume().catch(() => void 0), {
+		fromSampleRate: d,
+		usingWorklet: v,
+		stop() {
+			h || (h = !0, m.flush(), b(), c.close().catch(() => void 0));
+		}
+	};
+}
+//#endregion
+//#region src/byo/mic.ts
+async function y(e) {
+	let t = e.mediaStream ?? await navigator.mediaDevices.getUserMedia({ audio: {
+		channelCount: 1,
+		echoCancellation: !0,
+		noiseSuppression: !0
+	} }), n = !e.mediaStream, r = await v({
+		mediaStream: t,
+		targetSampleRate: e.targetSampleRate,
+		onPcm: e.onPcm,
+		shouldSend: e.shouldSend,
+		onLog: e.onLog
+	});
+	return {
+		fromSampleRate: r.fromSampleRate,
+		usingWorklet: r.usingWorklet,
+		stop() {
+			if (r.stop(), n) for (let e of t.getTracks()) e.stop();
+		}
+	};
+}
+function b(e) {
+	return e.mediaStream ? !0 : e.captureMic !== !1;
+}
+//#endregion
+//#region src/byo/turn.ts
+function x(e, t) {
+	let { sampleRate: r, isEnded: i, canWrite: a, onWriteError: o } = t, d = null, f = "", p = c();
+	function m() {
+		return typeof r == "function" ? r() : r;
+	}
+	function h() {
+		let e = f.trim();
+		return f = "", e;
+	}
+	function g() {
+		if (d) return d;
+		let t = m();
+		if (t == null) return null;
+		let n = h();
+		return d = {
+			utterance: e.speech.createUtterance({
+				format: {
+					encoding: "pcm_s16le",
+					sampleRate: t,
+					channels: 1
+				},
+				queue: "replace-active",
+				...n ? { transcript: n } : {}
+			}),
+			writes: Promise.resolve(),
+			transcript: n
+		}, d;
+	}
+	function _(e) {
+		if (i() || a && !a()) return;
+		let t = l(p, e);
+		if (t.byteLength === 0) return;
+		let n = g();
+		n && (n.writes = n.writes.then(() => s(n.utterance, t)).catch((e) => {
+			console.error(e), o?.(e), u(p);
+			let t = d;
+			d = null, t && t.utterance.cancel().catch(() => void 0);
+		}));
+	}
+	return {
+		getTurn: () => d,
+		writePcm: _,
+		writePcmBase64(e) {
+			e && _(n(e));
+		},
+		setTranscript(e, t = "append") {
+			let n = t === "replace" ? e.trim() : `${d?.transcript ?? f}${e}`.trim();
+			if (n) {
+				if (!d) {
+					f = n;
+					return;
+				}
+				d.transcript = n, d.utterance.setTranscript(n).catch(() => void 0);
+			}
+		},
+		async closeActiveTurn() {
+			let e = d;
+			if (d = null, u(p), e) try {
+				await e.writes;
+				let t = e.transcript.trim();
+				await e.utterance.close({
+					...t ? { transcript: t } : {},
+					history: "none"
+				});
+			} catch {}
+		},
+		bargeIn() {
+			f = "", u(p);
+			let t = d;
+			d = null, t ? t.utterance.cancel() : e.speech.interrupt({ scope: "active" });
+		},
+		abandonActiveTurn() {
+			f = "", u(p);
+			let e = d;
+			d = null, e && e.utterance.cancel().catch(() => void 0);
+		},
+		clearPending() {
+			f = "";
+		}
+	};
+}
+//#endregion
+export { t as BYO_PLAYBACK_GUIDANCE, e as MAX_PCM_CHUNK_BYTES, n as base64ToPcmBytes, u as clearPcmByteCarry, f as createCubicResampler, c as createPcmByteCarry, x as createTurnSession, i as floatToPcm16Le, o as parsePcmSampleRate, r as pcmBytesToBase64, a as resampleFloat32, b as shouldCaptureMic, v as startAudioCapture, y as startPcmMic, l as takeEvenPcmBytes, s as writePcmInChunks };
+
+//# sourceMappingURL=index.js.map

package/dist/byo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/byo/pcm.ts","../../src/byo/pcmCarry.ts","../../src/byo/resample.ts","../../src/byo/audioCapture.ts","../../src/byo/mic.ts","../../src/byo/turn.ts"],"sourcesContent":["/** Liforma `speech.write` rejects chunks larger than 64 KiB. */\nexport const MAX_PCM_CHUNK_BYTES = 64 * 1024;\n\n/**\n * Playback / chunk guidance for custom BYO bridges (mirrors speech controller limits).\n * Prefer ~20–200 ms PCM frames; the player starts after an adaptive ~80–250 ms jitter\n * buffer (default 150 ms) based on chunk arrival variance.\n */\nexport const BYO_PLAYBACK_GUIDANCE = {\n\tRECOMMENDED_CHUNK_MS_MIN: 20,\n\tRECOMMENDED_CHUNK_MS_MAX: 200,\n\tPLAYBACK_JITTER_BUFFER_MS: 150,\n\tPLAYBACK_JITTER_BUFFER_MS_MIN: 80,\n\tPLAYBACK_JITTER_BUFFER_MS_MAX: 250\n} as const;\n\nexport function base64ToPcmBytes(b64: string): Uint8Array {\n\tconst bin = atob(b64);\n\tconst out = new Uint8Array(bin.length);\n\tfor (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);\n\treturn out;\n}\n\nexport function pcmBytesToBase64(bytes: Uint8Array): string {\n\tlet bin = '';\n\tconst chunk = 0x8000;\n\tfor (let i = 0; i < bytes.length; i += chunk) {\n\t\tbin += String.fromCharCode(...bytes.subarray(i, i + chunk));\n\t}\n\treturn btoa(bin);\n}\n\nexport function floatToPcm16Le(input: Float32Array): Uint8Array {\n\tconst out = new Uint8Array(input.length * 2);\n\tconst view = new DataView(out.buffer);\n\tfor (let i = 0; i < input.length; i++) {\n\t\tconst s = Math.max(-1, Math.min(1, input[i]!));\n\t\tview.setInt16(i * 2, s < 0 ? s * 0x8000 : s * 0x7fff, true);\n\t}\n\treturn out;\n}\n\n/** Naive linear resample Float32 → target rate. */\nexport function resampleFloat32(input: Float32Array, fromRate: number, toRate: number): Float32Array {\n\tif (fromRate === toRate || input.length === 0) return input;\n\tconst ratio = fromRate / toRate;\n\tconst outLen = Math.max(1, Math.round(input.length / ratio));\n\tconst out = new Float32Array(outLen);\n\tfor (let i = 0; i < outLen; i++) {\n\t\tconst src = i * ratio;\n\t\tconst i0 = Math.floor(src);\n\t\tconst i1 = Math.min(i0 + 1, input.length - 1);\n\t\tconst t = src - i0;\n\t\tout[i] = input[i0]! * (1 - t) + input[i1]! * t;\n\t}\n\treturn out;\n}\n\n/**\n * Parse vendor format strings like `pcm_16000` / `pcm_24000`.\n * Returns null when the format is missing or not PCM.\n */\nexport function parsePcmSampleRate(format: string | null | undefined): number | null {\n\tconst m = /^pcm_(\\d+)$/.exec(format ?? '');\n\tif (!m) return null;\n\tconst rate = Number(m[1]);\n\treturn Number.isFinite(rate) && rate > 0 ? rate : null;\n}\n\n/**\n * Write even-length PCM, splitting at MAX_PCM_CHUNK_BYTES on even boundaries.\n * Callers that may receive odd-length frames should run bytes through\n * {@link takeEvenPcmBytes} first so samples are not dropped across chunks.\n */\nexport async function writePcmInChunks(\n\tutterance: { write: (chunk: ArrayBuffer | ArrayBufferView) => Promise<unknown> },\n\tbytes: Uint8Array\n): Promise<void> {\n\tif (bytes.byteLength === 0) return;\n\tif ((bytes.byteLength & 1) !== 0) {\n\t\t// Defensive: drop trailing unpaired byte within a single call.\n\t\tbytes = bytes.subarray(0, bytes.byteLength - 1);\n\t\tif (bytes.byteLength === 0) return;\n\t}\n\tif (bytes.byteLength <= MAX_PCM_CHUNK_BYTES) {\n\t\tawait utterance.write(bytes);\n\t\treturn;\n\t}\n\tlet offset = 0;\n\twhile (offset < bytes.byteLength) {\n\t\tlet end = Math.min(offset + MAX_PCM_CHUNK_BYTES, bytes.byteLength);\n\t\tif ((end - offset) % 2 === 1) end -= 1;\n\t\tif (end <= offset) break;\n\t\tawait utterance.write(bytes.subarray(offset, end));\n\t\toffset = end;\n\t}\n}\n","/**\n * Carry an odd trailing PCM byte across chunk boundaries so we never silently\n * drop a sample when vendor frames are odd-length or split mid-sample.\n */\n\nexport type PcmByteCarry = {\n\t/** Pending unpaired byte waiting for its mate; null when 16-bit aligned. */\n\tpending: number | null;\n};\n\nexport function createPcmByteCarry(): PcmByteCarry {\n\treturn { pending: null };\n}\n\n/**\n * Merge carry + incoming bytes into an even-length buffer for write, updating carry.\n * Returns a (possibly empty) even-length Uint8Array ready for utterance.write.\n */\nexport function takeEvenPcmBytes(carry: PcmByteCarry, incoming: Uint8Array): Uint8Array {\n\tconst prefix = carry.pending;\n\tcarry.pending = null;\n\n\tif (prefix == null && incoming.byteLength === 0) {\n\t\treturn incoming;\n\t}\n\n\t// Fast path: aligned and already even — no copy.\n\tif (prefix == null && (incoming.byteLength & 1) === 0) {\n\t\treturn incoming;\n\t}\n\n\tconst totalLen = (prefix != null ? 1 : 0) + incoming.byteLength;\n\tconst evenLen = totalLen & ~1;\n\n\tif (evenLen === 0) {\n\t\t// Single unpaired byte overall — keep it for the next call.\n\t\tcarry.pending = prefix ?? incoming[0] ?? null;\n\t\treturn new Uint8Array(0);\n\t}\n\n\tconst out = new Uint8Array(evenLen);\n\tlet o = 0;\n\tif (prefix != null) {\n\t\tout[o++] = prefix;\n\t}\n\tconst fromIncoming = evenLen - o;\n\tif (fromIncoming > 0) {\n\t\tout.set(incoming.subarray(0, fromIncoming), o);\n\t}\n\tif (fromIncoming < incoming.byteLength) {\n\t\tcarry.pending = incoming[incoming.byteLength - 1]!;\n\t}\n\treturn out;\n}\n\n/** Drop any leftover odd byte (end of utterance). */\nexport function clearPcmByteCarry(carry: PcmByteCarry): void {\n\tcarry.pending = null;\n}\n","/**\n * Stateful cubic (Catmull-Rom) resampler for continuous PCM capture streams.\n * Better than naive linear for uplink mic / track capture.\n */\n\nexport type FloatResampler = {\n\t/** Push a mono float buffer; returns samples at the target rate (may be empty). */\n\tpush(input: Float32Array): Float32Array;\n\t/** Flush any remaining fractional sample (usually silence). */\n\tflush(): Float32Array;\n\treadonly fromRate: number;\n\treadonly toRate: number;\n};\n\nfunction catmullRom(y0: number, y1: number, y2: number, y3: number, t: number): number {\n\tconst a0 = -0.5 * y0 + 1.5 * y1 - 1.5 * y2 + 0.5 * y3;\n\tconst a1 = y0 - 2.5 * y1 + 2 * y2 - 0.5 * y3;\n\tconst a2 = -0.5 * y0 + 0.5 * y2;\n\tconst a3 = y1;\n\treturn ((a0 * t + a1) * t + a2) * t + a3;\n}\n\n/**\n * Create a continuous resampler. When rates match, push() returns the input as-is\n * (no copy) when possible.\n */\nexport function createCubicResampler(fromRate: number, toRate: number): FloatResampler {\n\tif (!(fromRate > 0) || !(toRate > 0)) {\n\t\tthrow new Error('Resampler rates must be positive');\n\t}\n\n\tif (fromRate === toRate) {\n\t\treturn {\n\t\t\tfromRate,\n\t\t\ttoRate,\n\t\t\tpush(input) {\n\t\t\t\treturn input;\n\t\t\t},\n\t\t\tflush() {\n\t\t\t\treturn new Float32Array(0);\n\t\t\t}\n\t\t};\n\t}\n\n\tconst ratio = fromRate / toRate;\n\t/** History + pending input (keeps 3 samples of lookbehind for cubic). */\n\tlet pending = new Float32Array(0);\n\tlet pos = 0; // position in pending sample space for next output\n\n\treturn {\n\t\tfromRate,\n\t\ttoRate,\n\t\tpush(input) {\n\t\t\tif (input.length === 0) return new Float32Array(0);\n\t\t\tconst merged = new Float32Array(pending.length + input.length);\n\t\t\tmerged.set(pending);\n\t\t\tmerged.set(input, pending.length);\n\t\t\tpending = merged;\n\n\t\t\tif (pending.length < 4) return new Float32Array(0);\n\n\t\t\tconst out: number[] = [];\n\t\t\t// Need i+2 available for cubic; stop while pos+2 < length-1 equivalently floor(pos)+2 < len-?\n\t\t\twhile (pos + 2 < pending.length - 1) {\n\t\t\t\tconst i1 = Math.floor(pos);\n\t\t\t\tconst t = pos - i1;\n\t\t\t\tconst i0 = Math.max(0, i1 - 1);\n\t\t\t\tconst i2 = Math.min(pending.length - 1, i1 + 1);\n\t\t\t\tconst i3 = Math.min(pending.length - 1, i1 + 2);\n\t\t\t\tout.push(\n\t\t\t\t\tcatmullRom(pending[i0]!, pending[i1]!, pending[i2]!, pending[i3]!, t)\n\t\t\t\t);\n\t\t\t\tpos += ratio;\n\t\t\t}\n\n\t\t\t// Drop consumed samples but keep lookbehind (≥1) and unread tail.\n\t\t\tconst drop = Math.max(0, Math.floor(pos) - 1);\n\t\t\tif (drop > 0) {\n\t\t\t\tpending = pending.subarray(drop);\n\t\t\t\tpos -= drop;\n\t\t\t}\n\n\t\t\treturn out.length ? Float32Array.from(out) : new Float32Array(0);\n\t\t},\n\t\tflush() {\n\t\t\tif (pending.length === 0) return new Float32Array(0);\n\t\t\t// Emit one last sample if we have enough history; otherwise drop.\n\t\t\tpending = new Float32Array(0);\n\t\t\tpos = 0;\n\t\t\treturn new Float32Array(0);\n\t\t}\n\t};\n}\n","/**\n * Shared Web Audio capture: AudioWorklet when available, ScriptProcessor fallback.\n * Used by BYO mic uplink and MediaStreamTrack → PCM piping.\n */\n\nimport { floatToPcm16Le } from './pcm';\nimport { createCubicResampler, type FloatResampler } from './resample';\n\nexport type AudioCaptureSession = {\n\tstop(): void;\n\treadonly fromSampleRate: number;\n\treadonly usingWorklet: boolean;\n};\n\nexport type StartAudioCaptureOptions = {\n\treadonly mediaStream: MediaStream;\n\treadonly targetSampleRate: number;\n\t/** Called with pcm_s16le mono at targetSampleRate. */\n\treadonly onPcm: (bytes: Uint8Array) => void;\n\t/** When false, frames are dropped. */\n\treadonly shouldSend?: () => boolean;\n\treadonly onLog?: (line: string, kind?: 'info' | 'warn') => void;\n};\n\nconst WORKLET_NAME = 'liforma-pcm-capture';\n\nconst WORKLET_SOURCE = `\nclass LiformaPcmCaptureProcessor extends AudioWorkletProcessor {\n  process(inputs) {\n    const ch = inputs[0] && inputs[0][0];\n    if (ch && ch.length) {\n      const copy = new Float32Array(ch.length);\n      copy.set(ch);\n      this.port.postMessage(copy, [copy.buffer]);\n    }\n    return true;\n  }\n}\nregisterProcessor('${WORKLET_NAME}', LiformaPcmCaptureProcessor);\n`;\n\nlet workletUrl: string | null = null;\n\nfunction getWorkletUrl(): string {\n\tif (!workletUrl) {\n\t\tworkletUrl = URL.createObjectURL(\n\t\t\tnew Blob([WORKLET_SOURCE], { type: 'application/javascript' })\n\t\t);\n\t}\n\treturn workletUrl;\n}\n\nfunction getAudioContextCtor(): typeof AudioContext | null {\n\treturn (\n\t\twindow.AudioContext ||\n\t\t(window as unknown as { webkitAudioContext?: typeof AudioContext }).webkitAudioContext ||\n\t\tnull\n\t);\n}\n\n/**\n * Capture a MediaStream as pcm_s16le at targetSampleRate.\n * Prefers AudioWorklet; falls back to ScriptProcessorNode.\n */\nexport async function startAudioCapture(\n\toptions: StartAudioCaptureOptions\n): Promise<AudioCaptureSession> {\n\tconst { mediaStream, targetSampleRate, onPcm, shouldSend, onLog } = options;\n\tconst AudioContextCtor = getAudioContextCtor();\n\tif (!AudioContextCtor) throw new Error('Web Audio is required for audio capture');\n\n\tconst audioCtx = new AudioContextCtor();\n\tconst source = audioCtx.createMediaStreamSource(mediaStream);\n\tconst silent = audioCtx.createGain();\n\tsilent.gain.value = 0;\n\tconst fromSampleRate = audioCtx.sampleRate;\n\tconst resampler: FloatResampler = createCubicResampler(fromSampleRate, targetSampleRate);\n\tlet stopped = false;\n\tlet usingWorklet = false;\n\n\tconst emitFloat = (input: Float32Array) => {\n\t\tif (stopped) return;\n\t\tif (shouldSend && !shouldSend()) return;\n\t\tconst resampled = resampler.push(input);\n\t\tif (resampled.length === 0) return;\n\t\tonPcm(floatToPcm16Le(resampled));\n\t};\n\n\tlet disconnectGraph: () => void = () => undefined;\n\n\tconst tryWorklet = async (): Promise<boolean> => {\n\t\tif (typeof audioCtx.audioWorklet?.addModule !== 'function') return false;\n\t\ttry {\n\t\t\tawait audioCtx.audioWorklet.addModule(getWorkletUrl());\n\t\t\tconst node = new AudioWorkletNode(audioCtx, WORKLET_NAME, {\n\t\t\t\tnumberOfInputs: 1,\n\t\t\t\tnumberOfOutputs: 1,\n\t\t\t\toutputChannelCount: [1]\n\t\t\t});\n\t\t\tnode.port.onmessage = (ev) => {\n\t\t\t\tif (ev.data instanceof Float32Array) emitFloat(ev.data);\n\t\t\t};\n\t\t\tsource.connect(node);\n\t\t\tnode.connect(silent);\n\t\t\tsilent.connect(audioCtx.destination);\n\t\t\tdisconnectGraph = () => {\n\t\t\t\tnode.port.onmessage = null;\n\t\t\t\ttry {\n\t\t\t\t\tnode.disconnect();\n\t\t\t\t} catch {\n\t\t\t\t\t/* ignore */\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\tsource.disconnect();\n\t\t\t\t} catch {\n\t\t\t\t\t/* ignore */\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\tsilent.disconnect();\n\t\t\t\t} catch {\n\t\t\t\t\t/* ignore */\n\t\t\t\t}\n\t\t\t};\n\t\t\tusingWorklet = true;\n\t\t\treturn true;\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t};\n\n\tconst useScriptProcessor = (): void => {\n\t\tconst createScriptProcessor = (\n\t\t\taudioCtx as AudioContext & {\n\t\t\t\tcreateScriptProcessor?: (\n\t\t\t\t\tbufferSize: number,\n\t\t\t\t\tinputChannels: number,\n\t\t\t\t\toutputChannels: number\n\t\t\t\t) => ScriptProcessorNode;\n\t\t\t}\n\t\t).createScriptProcessor?.bind(audioCtx);\n\n\t\tif (!createScriptProcessor) {\n\t\t\tthrow new Error('Neither AudioWorklet nor ScriptProcessor is available');\n\t\t}\n\n\t\tconst processor = createScriptProcessor(4096, 1, 1);\n\t\tprocessor.onaudioprocess = (ev) => {\n\t\t\temitFloat(ev.inputBuffer.getChannelData(0));\n\t\t};\n\t\tsource.connect(processor);\n\t\tprocessor.connect(silent);\n\t\tsilent.connect(audioCtx.destination);\n\t\tdisconnectGraph = () => {\n\t\t\tprocessor.onaudioprocess = null;\n\t\t\ttry {\n\t\t\t\tprocessor.disconnect();\n\t\t\t} catch {\n\t\t\t\t/* ignore */\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tsource.disconnect();\n\t\t\t} catch {\n\t\t\t\t/* ignore */\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tsilent.disconnect();\n\t\t\t} catch {\n\t\t\t\t/* ignore */\n\t\t\t}\n\t\t};\n\t\tusingWorklet = false;\n\t};\n\n\tif (!(await tryWorklet())) {\n\t\tuseScriptProcessor();\n\t\tonLog?.(\n\t\t\t`Mic/track capture via ScriptProcessor at ${fromSampleRate} Hz → ${targetSampleRate} Hz`,\n\t\t\t'warn'\n\t\t);\n\t} else {\n\t\tonLog?.(`Mic/track capture via AudioWorklet at ${fromSampleRate} Hz → ${targetSampleRate} Hz`);\n\t}\n\n\tif (audioCtx.state === 'suspended') {\n\t\tawait audioCtx.resume().catch(() => undefined);\n\t}\n\n\treturn {\n\t\tfromSampleRate,\n\t\tusingWorklet,\n\t\tstop() {\n\t\t\tif (stopped) return;\n\t\t\tstopped = true;\n\t\t\tresampler.flush();\n\t\t\tdisconnectGraph();\n\t\t\tvoid audioCtx.close().catch(() => undefined);\n\t\t}\n\t};\n}\n","import { startAudioCapture } from './audioCapture';\n\nexport type StartPcmMicOptions = {\n\treadonly targetSampleRate: number;\n\t/** Existing stream; when omitted, requests getUserMedia. */\n\treadonly mediaStream?: MediaStream;\n\t/** Called with pcm_s16le mono chunks at targetSampleRate. */\n\treadonly onPcm: (bytes: Uint8Array) => void;\n\t/** When false, PCM frames are dropped (e.g. before SettingsApplied). */\n\treadonly shouldSend?: () => boolean;\n\treadonly onLog?: (line: string, kind?: 'info' | 'warn') => void;\n};\n\nexport type PcmMicSession = {\n\tstop(): void;\n\treadonly fromSampleRate: number;\n\t/** True when capture used AudioWorklet (false = ScriptProcessor fallback). */\n\treadonly usingWorklet: boolean;\n};\n\n/**\n * Capture mic (or an existing MediaStream), resample to targetRate, emit pcm_s16le.\n * Prefers AudioWorklet + cubic resample; falls back to ScriptProcessor.\n */\nexport async function startPcmMic(options: StartPcmMicOptions): Promise<PcmMicSession> {\n\tconst ownedStream =\n\t\toptions.mediaStream ??\n\t\t(await navigator.mediaDevices.getUserMedia({\n\t\t\taudio: {\n\t\t\t\tchannelCount: 1,\n\t\t\t\techoCancellation: true,\n\t\t\t\tnoiseSuppression: true\n\t\t\t}\n\t\t}));\n\tconst stopTracksOnStop = !options.mediaStream;\n\n\tconst capture = await startAudioCapture({\n\t\tmediaStream: ownedStream,\n\t\ttargetSampleRate: options.targetSampleRate,\n\t\tonPcm: options.onPcm,\n\t\tshouldSend: options.shouldSend,\n\t\tonLog: options.onLog\n\t});\n\n\treturn {\n\t\tfromSampleRate: capture.fromSampleRate,\n\t\tusingWorklet: capture.usingWorklet,\n\t\tstop() {\n\t\t\tcapture.stop();\n\t\t\tif (stopTracksOnStop) {\n\t\t\t\tfor (const track of ownedStream.getTracks()) track.stop();\n\t\t\t}\n\t\t}\n\t};\n}\n\n/** Resolve whether to start mic from shared BYO mic options. */\nexport function shouldCaptureMic(options: {\n\tcaptureMic?: boolean;\n\tmediaStream?: MediaStream;\n}): boolean {\n\tif (options.mediaStream) return true;\n\treturn options.captureMic !== false;\n}\n","import { base64ToPcmBytes, writePcmInChunks } from './pcm';\nimport { clearPcmByteCarry, createPcmByteCarry, takeEvenPcmBytes } from './pcmCarry';\nimport type { ByoPcmExperience, ByoSpeechUtterance } from './types';\n\nexport type ByoTurn = {\n\tutterance: ByoSpeechUtterance;\n\twrites: Promise<void>;\n\ttranscript: string;\n};\n\nexport type CreateTurnSessionOptions = {\n\t/**\n\t * Fixed sample rate, or a getter when the vendor locks rate after connect\n\t * (e.g. ElevenLabs `agent_output_audio_format`).\n\t */\n\treadonly sampleRate: number | (() => number | null);\n\treadonly isEnded: () => boolean;\n\t/** When false, writePcm is a no-op (e.g. before Deepgram SettingsApplied). */\n\treadonly canWrite?: () => boolean;\n\treadonly onWriteError?: (error: unknown) => void;\n};\n\nexport type ByoTurnSession = {\n\tgetTurn(): ByoTurn | null;\n\twritePcm(bytes: Uint8Array): void;\n\twritePcmBase64(b64: string): void;\n\tsetTranscript(text: string, mode?: 'replace' | 'append'): void;\n\t/** Await pending writes and close the utterance (normal turn end). */\n\tcloseActiveTurn(): Promise<void>;\n\t/** Cancel active utterance / interrupt (user barge-in). */\n\tbargeIn(): void;\n\t/**\n\t * Drop the active turn on unexpected disconnect — cancel if open so the\n\t * player does not keep an orphaned utterance.\n\t * Does **not** call `speech.interrupt` when idle (safe after a clean `end()`).\n\t */\n\tabandonActiveTurn(): void;\n\tclearPending(): void;\n};\n\n/**\n * Shared per-turn PCM + transcript state machine for BYO createUtterance bridges.\n */\nexport function createTurnSession(\n\texperience: ByoPcmExperience,\n\toptions: CreateTurnSessionOptions\n): ByoTurnSession {\n\tconst { sampleRate: sampleRateOpt, isEnded, canWrite, onWriteError } = options;\n\n\tlet turn: ByoTurn | null = null;\n\tlet pendingTranscript = '';\n\tconst pcmCarry = createPcmByteCarry();\n\n\tfunction resolveSampleRate(): number | null {\n\t\treturn typeof sampleRateOpt === 'function' ? sampleRateOpt() : sampleRateOpt;\n\t}\n\n\tfunction consumePendingTranscript(): string {\n\t\tconst text = pendingTranscript.trim();\n\t\tpendingTranscript = '';\n\t\treturn text;\n\t}\n\n\tfunction openTurnIfNeeded(): ByoTurn | null {\n\t\tif (turn) return turn;\n\t\tconst sampleRate = resolveSampleRate();\n\t\tif (sampleRate == null) return null;\n\t\tconst seed = consumePendingTranscript();\n\t\tconst utterance = experience.speech.createUtterance({\n\t\t\tformat: { encoding: 'pcm_s16le', sampleRate, channels: 1 },\n\t\t\tqueue: 'replace-active',\n\t\t\t...(seed ? { transcript: seed } : {})\n\t\t});\n\t\tturn = { utterance, writes: Promise.resolve(), transcript: seed };\n\t\treturn turn;\n\t}\n\n\tfunction writePcm(bytes: Uint8Array): void {\n\t\tif (isEnded()) return;\n\t\tif (canWrite && !canWrite()) return;\n\t\tconst even = takeEvenPcmBytes(pcmCarry, bytes);\n\t\tif (even.byteLength === 0) return;\n\t\tconst current = openTurnIfNeeded();\n\t\tif (!current) return;\n\t\tcurrent.writes = current.writes\n\t\t\t.then(() => writePcmInChunks(current.utterance, even))\n\t\t\t.catch((err) => {\n\t\t\t\tconsole.error(err);\n\t\t\t\tonWriteError?.(err);\n\t\t\t\tclearPcmByteCarry(pcmCarry);\n\t\t\t\t// Drop the half-open utterance so hosts are not stuck until vendor close.\n\t\t\t\tconst failed = turn;\n\t\t\t\tturn = null;\n\t\t\t\tif (failed) {\n\t\t\t\t\tvoid failed.utterance.cancel().catch(() => undefined);\n\t\t\t\t}\n\t\t\t});\n\t}\n\n\treturn {\n\t\tgetTurn: () => turn,\n\n\t\twritePcm,\n\n\t\twritePcmBase64(b64: string) {\n\t\t\tif (!b64) return;\n\t\t\twritePcm(base64ToPcmBytes(b64));\n\t\t},\n\n\t\tsetTranscript(text: string, mode: 'replace' | 'append' = 'append') {\n\t\t\tconst next =\n\t\t\t\tmode === 'replace'\n\t\t\t\t\t? text.trim()\n\t\t\t\t\t: `${turn?.transcript ?? pendingTranscript}${text}`.trim();\n\t\t\tif (!next) return;\n\t\t\tif (!turn) {\n\t\t\t\tpendingTranscript = next;\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tturn.transcript = next;\n\t\t\tvoid turn.utterance.setTranscript(next).catch(() => undefined);\n\t\t},\n\n\t\tasync closeActiveTurn() {\n\t\t\tconst current = turn;\n\t\t\tturn = null;\n\t\t\tclearPcmByteCarry(pcmCarry);\n\t\t\tif (!current) return;\n\t\t\ttry {\n\t\t\t\tawait current.writes;\n\t\t\t\tconst transcript = current.transcript.trim();\n\t\t\t\tawait current.utterance.close({\n\t\t\t\t\t...(transcript ? { transcript } : {}),\n\t\t\t\t\thistory: 'none'\n\t\t\t\t});\n\t\t\t} catch {\n\t\t\t\t/* ignore */\n\t\t\t}\n\t\t},\n\n\t\tbargeIn() {\n\t\t\tpendingTranscript = '';\n\t\t\tclearPcmByteCarry(pcmCarry);\n\t\t\tconst current = turn;\n\t\t\tturn = null;\n\t\t\tvoid (current\n\t\t\t\t? current.utterance.cancel()\n\t\t\t\t: experience.speech.interrupt({ scope: 'active' }));\n\t\t},\n\n\t\tabandonActiveTurn() {\n\t\t\tpendingTranscript = '';\n\t\t\tclearPcmByteCarry(pcmCarry);\n\t\t\tconst current = turn;\n\t\t\tturn = null;\n\t\t\t// Cancel only — never interrupt when idle. Close handlers also run after a\n\t\t\t// clean end()/closeActiveTurn(); interrupt-when-idle would clobber the next speak.\n\t\t\tif (current) {\n\t\t\t\tvoid current.utterance.cancel().catch(() => undefined);\n\t\t\t}\n\t\t},\n\n\t\tclearPending() {\n\t\t\tpendingTranscript = '';\n\t\t}\n\t};\n}\n"],"mappings":";AACA,IAAa,IAAsB,KAAK,MAO3B,IAAwB;CACpC,0BAA0B;CAC1B,0BAA0B;CAC1B,2BAA2B;CAC3B,+BAA+B;CAC/B,+BAA+B;AAChC;AAEA,SAAgB,EAAiB,GAAyB;CACzD,IAAM,IAAM,KAAK,CAAG,GACd,IAAM,IAAI,WAAW,EAAI,MAAM;CACrC,KAAK,IAAI,IAAI,GAAG,IAAI,EAAI,QAAQ,KAAK,EAAI,KAAK,EAAI,WAAW,CAAC;CAC9D,OAAO;AACR;AAEA,SAAgB,EAAiB,GAA2B;CAC3D,IAAI,IAAM,IACJ,IAAQ;CACd,KAAK,IAAI,IAAI,GAAG,IAAI,EAAM,QAAQ,KAAK,GACtC,KAAO,OAAO,aAAa,GAAG,EAAM,SAAS,GAAG,IAAI,CAAK,CAAC;CAE3D,OAAO,KAAK,CAAG;AAChB;AAEA,SAAgB,EAAe,GAAiC;CAC/D,IAAM,IAAM,IAAI,WAAW,EAAM,SAAS,CAAC,GACrC,IAAO,IAAI,SAAS,EAAI,MAAM;CACpC,KAAK,IAAI,IAAI,GAAG,IAAI,EAAM,QAAQ,KAAK;EACtC,IAAM,IAAI,KAAK,IAAI,IAAI,KAAK,IAAI,GAAG,EAAM,EAAG,CAAC;EAC7C,EAAK,SAAS,IAAI,GAAG,IAAI,IAAI,IAAI,QAAS,IAAI,OAAQ,EAAI;CAC3D;CACA,OAAO;AACR;AAGA,SAAgB,EAAgB,GAAqB,GAAkB,GAA8B;CACpG,IAAI,MAAa,KAAU,EAAM,WAAW,GAAG,OAAO;CACtD,IAAM,IAAQ,IAAW,GACnB,IAAS,KAAK,IAAI,GAAG,KAAK,MAAM,EAAM,SAAS,CAAK,CAAC,GACrD,IAAM,IAAI,aAAa,CAAM;CACnC,KAAK,IAAI,IAAI,GAAG,IAAI,GAAQ,KAAK;EAChC,IAAM,IAAM,IAAI,GACV,IAAK,KAAK,MAAM,CAAG,GACnB,IAAK,KAAK,IAAI,IAAK,GAAG,EAAM,SAAS,CAAC,GACtC,IAAI,IAAM;EAChB,EAAI,KAAK,EAAM,MAAQ,IAAI,KAAK,EAAM,KAAO;CAC9C;CACA,OAAO;AACR;AAMA,SAAgB,EAAmB,GAAkD;CACpF,IAAM,IAAI,cAAc,KAAK,KAAU,EAAE;CACzC,IAAI,CAAC,GAAG,OAAO;CACf,IAAM,IAAO,OAAO,EAAE,EAAE;CACxB,OAAO,OAAO,SAAS,CAAI,KAAK,IAAO,IAAI,IAAO;AACnD;AAOA,eAAsB,EACrB,GACA,GACgB;CAEhB,IADI,EAAM,eAAe,KACpB,EAAM,aAAa,MAEvB,IAAQ,EAAM,SAAS,GAAG,EAAM,aAAa,CAAC,GAC1C,EAAM,eAAe,IAAG;CAE7B,IAAI,EAAM,cAAA,OAAmC;EAC5C,MAAM,EAAU,MAAM,CAAK;EAC3B;CACD;CACA,IAAI,IAAS;CACb,OAAO,IAAS,EAAM,aAAY;EACjC,IAAI,IAAM,KAAK,IAAI,IAAS,GAAqB,EAAM,UAAU;EAEjE,KADK,IAAM,KAAU,KAAM,KAAG,KAC1B,KAAO,GAAQ;EAEnB,AADA,MAAM,EAAU,MAAM,EAAM,SAAS,GAAQ,CAAG,CAAC,GACjD,IAAS;CACV;AACD;;;ACtFA,SAAgB,IAAmC;CAClD,OAAO,EAAE,SAAS,KAAK;AACxB;AAMA,SAAgB,EAAiB,GAAqB,GAAkC;CACvF,IAAM,IAAS,EAAM;CAQrB,IAPA,EAAM,UAAU,MAEZ,KAAU,QAAQ,EAAS,eAAe,KAK1C,KAAU,QAAA,EAAS,EAAS,aAAa,IAC5C,OAAO;CAIR,IAAM,KADY,KAAU,OAAW,IAAJ,KAAS,EAAS,aAC1B;CAE3B,IAAI,MAAY,GAGf,OADA,EAAM,UAAU,KAAU,EAAS,MAAM,MAClC,IAAI,WAAY;CAGxB,IAAM,IAAM,IAAI,WAAW,CAAO,GAC9B,IAAI;CACR,AAAI,KAAU,SACb,EAAI,OAAO;CAEZ,IAAM,IAAe,IAAU;CAO/B,OANI,IAAe,KAClB,EAAI,IAAI,EAAS,SAAS,GAAG,CAAY,GAAG,CAAC,GAE1C,IAAe,EAAS,eAC3B,EAAM,UAAU,EAAS,EAAS,aAAa,KAEzC;AACR;AAGA,SAAgB,EAAkB,GAA2B;CAC5D,EAAM,UAAU;AACjB;;;AC5CA,SAAS,EAAW,GAAY,GAAY,GAAY,GAAY,GAAmB;CACtF,IAAM,IAAK,MAAO,IAAK,MAAM,IAAK,MAAM,IAAK,KAAM,GAC7C,IAAK,IAAK,MAAM,IAAK,IAAI,IAAK,KAAM,GACpC,IAAK,MAAO,IAAK,KAAM,GACvB,IAAK;CACX,SAAS,IAAK,IAAI,KAAM,IAAI,KAAM,IAAI;AACvC;AAMA,SAAgB,EAAqB,GAAkB,GAAgC;CACtF,IAAI,EAAE,IAAW,MAAM,EAAE,IAAS,IACjC,MAAU,MAAM,kCAAkC;CAGnD,IAAI,MAAa,GAChB,OAAO;EACN;EACA;EACA,KAAK,GAAO;GACX,OAAO;EACR;EACA,QAAQ;GACP,OAAO,IAAI,aAAc;EAC1B;CACD;CAGD,IAAM,IAAQ,IAAW,GAErB,IAAU,IAAI,aAAc,GAC5B,IAAM;CAEV,OAAO;EACN;EACA;EACA,KAAK,GAAO;GACX,IAAI,EAAM,WAAW,GAAG,OAAO,IAAI,aAAc;GACjD,IAAM,IAAS,IAAI,aAAa,EAAQ,SAAS,EAAM,MAAM;GAK7D,IAJA,EAAO,IAAI,CAAO,GAClB,EAAO,IAAI,GAAO,EAAQ,MAAM,GAChC,IAAU,GAEN,EAAQ,SAAS,GAAG,OAAO,IAAI,aAAc;GAEjD,IAAM,IAAgB,CAAC;GAEvB,OAAO,IAAM,IAAI,EAAQ,SAAS,IAAG;IACpC,IAAM,IAAK,KAAK,MAAM,CAAG,GACnB,IAAI,IAAM,GACV,IAAK,KAAK,IAAI,GAAG,IAAK,CAAC,GACvB,IAAK,KAAK,IAAI,EAAQ,SAAS,GAAG,IAAK,CAAC,GACxC,IAAK,KAAK,IAAI,EAAQ,SAAS,GAAG,IAAK,CAAC;IAI9C,AAHA,EAAI,KACH,EAAW,EAAQ,IAAM,EAAQ,IAAM,EAAQ,IAAM,EAAQ,IAAM,CAAC,CACrE,GACA,KAAO;GACR;GAGA,IAAM,IAAO,KAAK,IAAI,GAAG,KAAK,MAAM,CAAG,IAAI,CAAC;GAM5C,OALI,IAAO,MACV,IAAU,EAAQ,SAAS,CAAI,GAC/B,KAAO,IAGD,EAAI,SAAS,aAAa,KAAK,CAAG,IAAI,IAAI,aAAc;EAChE;EACA,QAAQ;GAKP,OAJI,EAAQ,WAAW,IAAU,IAAI,aAAc,KAEnD,IAAU,IAAI,aAAc,GAC5B,IAAM,GACC,IAAI,aAAc;EAC1B;CACD;AACD;;;ACpEA,IAAM,IAAe,uBAEf,IAAiB;;;;;;;;;;;;qBAYF,EAAa;GAG9B,IAA4B;AAEhC,SAAS,IAAwB;CAMhC,OALA,AACC,MAAa,IAAI,gBAChB,IAAI,KAAK,CAAC,CAAc,GAAG,EAAE,MAAM,yBAAyB,CAAC,CAC9D,GAEM;AACR;AAEA,SAAS,IAAkD;CAC1D,OACC,OAAO,gBACN,OAAmE,sBACpE;AAEF;AAMA,eAAsB,EACrB,GAC+B;CAC/B,IAAM,EAAE,gBAAa,qBAAkB,UAAO,eAAY,aAAU,GAC9D,IAAmB,EAAoB;CAC7C,IAAI,CAAC,GAAkB,MAAU,MAAM,yCAAyC;CAEhF,IAAM,IAAW,IAAI,EAAiB,GAChC,IAAS,EAAS,wBAAwB,CAAW,GACrD,IAAS,EAAS,WAAW;CACnC,EAAO,KAAK,QAAQ;CACpB,IAAM,IAAiB,EAAS,YAC1B,IAA4B,EAAqB,GAAgB,CAAgB,GACnF,IAAU,IACV,IAAe,IAEb,KAAa,MAAwB;EAE1C,IADI,KACA,KAAc,CAAC,EAAW,GAAG;EACjC,IAAM,IAAY,EAAU,KAAK,CAAK;EAClC,EAAU,WAAW,KACzB,EAAM,EAAe,CAAS,CAAC;CAChC,GAEI,UAAoC,KAAA;CAmGxC,OAdM,OAAM,YAnFqC;EAChD,IAAI,OAAO,EAAS,cAAc,aAAc,YAAY,OAAO;EACnE,IAAI;GACH,MAAM,EAAS,aAAa,UAAU,EAAc,CAAC;GACrD,IAAM,IAAO,IAAI,iBAAiB,GAAU,GAAc;IACzD,gBAAgB;IAChB,iBAAiB;IACjB,oBAAoB,CAAC,CAAC;GACvB,CAAC;GA0BD,OAzBA,EAAK,KAAK,aAAa,MAAO;IAC7B,AAAI,EAAG,gBAAgB,gBAAc,EAAU,EAAG,IAAI;GACvD,GACA,EAAO,QAAQ,CAAI,GACnB,EAAK,QAAQ,CAAM,GACnB,EAAO,QAAQ,EAAS,WAAW,GACnC,UAAwB;IACvB,EAAK,KAAK,YAAY;IACtB,IAAI;KACH,EAAK,WAAW;IACjB,QAAQ,CAER;IACA,IAAI;KACH,EAAO,WAAW;IACnB,QAAQ,CAER;IACA,IAAI;KACH,EAAO,WAAW;IACnB,QAAQ,CAER;GACD,GACA,IAAe,IACR;EACR,QAAQ;GACP,OAAO;EACR;CACD,GA6CuB,IAOtB,IAAQ,yCAAyC,EAAe,QAAQ,EAAiB,IAAI,YAlDvD;EACtC,IAAM,IACL,EAOC,uBAAuB,KAAK,CAAQ;EAEtC,IAAI,CAAC,GACJ,MAAU,MAAM,uDAAuD;EAGxE,IAAM,IAAY,EAAsB,MAAM,GAAG,CAAC;EAyBlD,AAxBA,EAAU,kBAAkB,MAAO;GAClC,EAAU,EAAG,YAAY,eAAe,CAAC,CAAC;EAC3C,GACA,EAAO,QAAQ,CAAS,GACxB,EAAU,QAAQ,CAAM,GACxB,EAAO,QAAQ,EAAS,WAAW,GACnC,UAAwB;GACvB,EAAU,iBAAiB;GAC3B,IAAI;IACH,EAAU,WAAW;GACtB,QAAQ,CAER;GACA,IAAI;IACH,EAAO,WAAW;GACnB,QAAQ,CAER;GACA,IAAI;IACH,EAAO,WAAW;GACnB,QAAQ,CAER;EACD,GACA,IAAe;CAChB,GAGoB,GACnB,IACC,4CAA4C,EAAe,QAAQ,EAAiB,MACpF,MACD,IAKG,EAAS,UAAU,eACtB,MAAM,EAAS,OAAO,EAAE,YAAY,KAAA,CAAS,GAGvC;EACN;EACA;EACA,OAAO;GACF,MACJ,IAAU,IACV,EAAU,MAAM,GAChB,EAAgB,GAChB,EAAc,MAAM,EAAE,YAAY,KAAA,CAAS;EAC5C;CACD;AACD;;;AC9KA,eAAsB,EAAY,GAAqD;CACtF,IAAM,IACL,EAAQ,eACP,MAAM,UAAU,aAAa,aAAa,EAC1C,OAAO;EACN,cAAc;EACd,kBAAkB;EAClB,kBAAkB;CACnB,EACD,CAAC,GACI,IAAmB,CAAC,EAAQ,aAE5B,IAAU,MAAM,EAAkB;EACvC,aAAa;EACb,kBAAkB,EAAQ;EAC1B,OAAO,EAAQ;EACf,YAAY,EAAQ;EACpB,OAAO,EAAQ;CAChB,CAAC;CAED,OAAO;EACN,gBAAgB,EAAQ;EACxB,cAAc,EAAQ;EACtB,OAAO;GAEN,IADA,EAAQ,KAAK,GACT,GACH,KAAK,IAAM,KAAS,EAAY,UAAU,GAAG,EAAM,KAAK;EAE1D;CACD;AACD;AAGA,SAAgB,EAAiB,GAGrB;CAEX,OADI,EAAQ,cAAoB,KACzB,EAAQ,eAAe;AAC/B;;;ACpBA,SAAgB,EACf,GACA,GACiB;CACjB,IAAM,EAAE,YAAY,GAAe,YAAS,aAAU,oBAAiB,GAEnE,IAAuB,MACvB,IAAoB,IAClB,IAAW,EAAmB;CAEpC,SAAS,IAAmC;EAC3C,OAAO,OAAO,KAAkB,aAAa,EAAc,IAAI;CAChE;CAEA,SAAS,IAAmC;EAC3C,IAAM,IAAO,EAAkB,KAAK;EAEpC,OADA,IAAoB,IACb;CACR;CAEA,SAAS,IAAmC;EAC3C,IAAI,GAAM,OAAO;EACjB,IAAM,IAAa,EAAkB;EACrC,IAAI,KAAc,MAAM,OAAO;EAC/B,IAAM,IAAO,EAAyB;EAOtC,OADA,IAAO;GAAE,WALS,EAAW,OAAO,gBAAgB;IACnD,QAAQ;KAAE,UAAU;KAAa;KAAY,UAAU;IAAE;IACzD,OAAO;IACP,GAAI,IAAO,EAAE,YAAY,EAAK,IAAI,CAAC;GACpC,CACS;GAAW,QAAQ,QAAQ,QAAQ;GAAG,YAAY;EAAK,GACzD;CACR;CAEA,SAAS,EAAS,GAAyB;EAE1C,IADI,EAAQ,KACR,KAAY,CAAC,EAAS,GAAG;EAC7B,IAAM,IAAO,EAAiB,GAAU,CAAK;EAC7C,IAAI,EAAK,eAAe,GAAG;EAC3B,IAAM,IAAU,EAAiB;EAC5B,MACL,EAAQ,SAAS,EAAQ,OACvB,WAAW,EAAiB,EAAQ,WAAW,CAAI,CAAC,EACpD,OAAO,MAAQ;GAGf,AAFA,QAAQ,MAAM,CAAG,GACjB,IAAe,CAAG,GAClB,EAAkB,CAAQ;GAE1B,IAAM,IAAS;GAEf,AADA,IAAO,MACH,KACH,EAAY,UAAU,OAAO,EAAE,YAAY,KAAA,CAAS;EAEtD,CAAC;CACH;CAEA,OAAO;EACN,eAAe;EAEf;EAEA,eAAe,GAAa;GACtB,KACL,EAAS,EAAiB,CAAG,CAAC;EAC/B;EAEA,cAAc,GAAc,IAA6B,UAAU;GAClE,IAAM,IACL,MAAS,YACN,EAAK,KAAK,IACV,GAAG,GAAM,cAAc,IAAoB,IAAO,KAAK;GACtD,OACL;QAAI,CAAC,GAAM;KACV,IAAoB;KACpB;IACD;IAEA,AADA,EAAK,aAAa,GAClB,EAAU,UAAU,cAAc,CAAI,EAAE,YAAY,KAAA,CAAS;GAF7D;EAGD;EAEA,MAAM,kBAAkB;GACvB,IAAM,IAAU;GAChB,QAAO,MACP,EAAkB,CAAQ,GACrB,GACL,IAAI;IACH,MAAM,EAAQ;IACd,IAAM,IAAa,EAAQ,WAAW,KAAK;IAC3C,MAAM,EAAQ,UAAU,MAAM;KAC7B,GAAI,IAAa,EAAE,cAAW,IAAI,CAAC;KACnC,SAAS;IACV,CAAC;GACF,QAAQ,CAER;EACD;EAEA,UAAU;GAET,AADA,IAAoB,IACpB,EAAkB,CAAQ;GAC1B,IAAM,IAAU;GAEhB,AADA,IAAO,MACP,IACG,EAAQ,UAAU,OAAO,IACzB,EAAW,OAAO,UAAU,EAAE,OAAO,SAAS,CAAC;EACnD;EAEA,oBAAoB;GAEnB,AADA,IAAoB,IACpB,EAAkB,CAAQ;GAC1B,IAAM,IAAU;GAIhB,AAHA,IAAO,MAGH,KACH,EAAa,UAAU,OAAO,EAAE,YAAY,KAAA,CAAS;EAEvD;EAEA,eAAe;GACd,IAAoB;EACrB;CACD;AACD"}

package/dist/byo/mic.d.ts

@@ -0,0 +1,27 @@
+export type StartPcmMicOptions = {
+    readonly targetSampleRate: number;
+    /** Existing stream; when omitted, requests getUserMedia. */
+    readonly mediaStream?: MediaStream;
+    /** Called with pcm_s16le mono chunks at targetSampleRate. */
+    readonly onPcm: (bytes: Uint8Array) => void;
+    /** When false, PCM frames are dropped (e.g. before SettingsApplied). */
+    readonly shouldSend?: () => boolean;
+    readonly onLog?: (line: string, kind?: 'info' | 'warn') => void;
+};
+export type PcmMicSession = {
+    stop(): void;
+    readonly fromSampleRate: number;
+    /** True when capture used AudioWorklet (false = ScriptProcessor fallback). */
+    readonly usingWorklet: boolean;
+};
+/**
+ * Capture mic (or an existing MediaStream), resample to targetRate, emit pcm_s16le.
+ * Prefers AudioWorklet + cubic resample; falls back to ScriptProcessor.
+ */
+export declare function startPcmMic(options: StartPcmMicOptions): Promise<PcmMicSession>;
+/** Resolve whether to start mic from shared BYO mic options. */
+export declare function shouldCaptureMic(options: {
+    captureMic?: boolean;
+    mediaStream?: MediaStream;
+}): boolean;
+//# sourceMappingURL=mic.d.ts.map

package/dist/byo/mic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mic.d.ts","sourceRoot":"","sources":["../../src/byo/mic.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,kBAAkB,GAAG;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,4DAA4D;IAC5D,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAC5C,wEAAwE;IACxE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;CAChE,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC3B,IAAI,IAAI,IAAI,CAAC;IACb,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CA8BrF;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACzC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC1B,GAAG,OAAO,CAGV"}

package/dist/byo/pcm.d.ts

@@ -0,0 +1,33 @@
+/** Liforma `speech.write` rejects chunks larger than 64 KiB. */
+export declare const MAX_PCM_CHUNK_BYTES: number;
+/**
+ * Playback / chunk guidance for custom BYO bridges (mirrors speech controller limits).
+ * Prefer ~20–200 ms PCM frames; the player starts after an adaptive ~80–250 ms jitter
+ * buffer (default 150 ms) based on chunk arrival variance.
+ */
+export declare const BYO_PLAYBACK_GUIDANCE: {
+    readonly RECOMMENDED_CHUNK_MS_MIN: 20;
+    readonly RECOMMENDED_CHUNK_MS_MAX: 200;
+    readonly PLAYBACK_JITTER_BUFFER_MS: 150;
+    readonly PLAYBACK_JITTER_BUFFER_MS_MIN: 80;
+    readonly PLAYBACK_JITTER_BUFFER_MS_MAX: 250;
+};
+export declare function base64ToPcmBytes(b64: string): Uint8Array;
+export declare function pcmBytesToBase64(bytes: Uint8Array): string;
+export declare function floatToPcm16Le(input: Float32Array): Uint8Array;
+/** Naive linear resample Float32 → target rate. */
+export declare function resampleFloat32(input: Float32Array, fromRate: number, toRate: number): Float32Array;
+/**
+ * Parse vendor format strings like `pcm_16000` / `pcm_24000`.
+ * Returns null when the format is missing or not PCM.
+ */
+export declare function parsePcmSampleRate(format: string | null | undefined): number | null;
+/**
+ * Write even-length PCM, splitting at MAX_PCM_CHUNK_BYTES on even boundaries.
+ * Callers that may receive odd-length frames should run bytes through
+ * {@link takeEvenPcmBytes} first so samples are not dropped across chunks.
+ */
+export declare function writePcmInChunks(utterance: {
+    write: (chunk: ArrayBuffer | ArrayBufferView) => Promise<unknown>;
+}, bytes: Uint8Array): Promise<void>;
+//# sourceMappingURL=pcm.d.ts.map

package/dist/byo/pcm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pcm.d.ts","sourceRoot":"","sources":["../../src/byo/pcm.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,eAAO,MAAM,mBAAmB,QAAY,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;;;CAMxB,CAAC;AAEX,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAKxD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAO1D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,UAAU,CAQ9D;AAED,mDAAmD;AACnD,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAanG;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAKnF;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACrC,SAAS,EAAE;IAAE,KAAK,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG,eAAe,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,EAChF,KAAK,EAAE,UAAU,GACf,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/byo/pcmCarry.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Carry an odd trailing PCM byte across chunk boundaries so we never silently
+ * drop a sample when vendor frames are odd-length or split mid-sample.
+ */
+export type PcmByteCarry = {
+    /** Pending unpaired byte waiting for its mate; null when 16-bit aligned. */
+    pending: number | null;
+};
+export declare function createPcmByteCarry(): PcmByteCarry;
+/**
+ * Merge carry + incoming bytes into an even-length buffer for write, updating carry.
+ * Returns a (possibly empty) even-length Uint8Array ready for utterance.write.
+ */
+export declare function takeEvenPcmBytes(carry: PcmByteCarry, incoming: Uint8Array): Uint8Array;
+/** Drop any leftover odd byte (end of utterance). */
+export declare function clearPcmByteCarry(carry: PcmByteCarry): void;
+//# sourceMappingURL=pcmCarry.d.ts.map

package/dist/byo/pcmCarry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pcmCarry.d.ts","sourceRoot":"","sources":["../../src/byo/pcmCarry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,YAAY,GAAG;IAC1B,4EAA4E;IAC5E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,wBAAgB,kBAAkB,IAAI,YAAY,CAEjD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,GAAG,UAAU,CAmCtF;AAED,qDAAqD;AACrD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAE3D"}

package/dist/byo/resample.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Stateful cubic (Catmull-Rom) resampler for continuous PCM capture streams.
+ * Better than naive linear for uplink mic / track capture.
+ */
+export type FloatResampler = {
+    /** Push a mono float buffer; returns samples at the target rate (may be empty). */
+    push(input: Float32Array): Float32Array;
+    /** Flush any remaining fractional sample (usually silence). */
+    flush(): Float32Array;
+    readonly fromRate: number;
+    readonly toRate: number;
+};
+/**
+ * Create a continuous resampler. When rates match, push() returns the input as-is
+ * (no copy) when possible.
+ */
+export declare function createCubicResampler(fromRate: number, toRate: number): FloatResampler;
+//# sourceMappingURL=resample.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resample.d.ts","sourceRoot":"","sources":["../../src/byo/resample.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,cAAc,GAAG;IAC5B,mFAAmF;IACnF,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAAC;IACxC,+DAA+D;IAC/D,KAAK,IAAI,YAAY,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB,CAAC;AAUF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAkErF"}

package/dist/byo/turn.d.ts

@@ -0,0 +1,39 @@
+import type { ByoPcmExperience, ByoSpeechUtterance } from './types';
+export type ByoTurn = {
+    utterance: ByoSpeechUtterance;
+    writes: Promise<void>;
+    transcript: string;
+};
+export type CreateTurnSessionOptions = {
+    /**
+     * Fixed sample rate, or a getter when the vendor locks rate after connect
+     * (e.g. ElevenLabs `agent_output_audio_format`).
+     */
+    readonly sampleRate: number | (() => number | null);
+    readonly isEnded: () => boolean;
+    /** When false, writePcm is a no-op (e.g. before Deepgram SettingsApplied). */
+    readonly canWrite?: () => boolean;
+    readonly onWriteError?: (error: unknown) => void;
+};
+export type ByoTurnSession = {
+    getTurn(): ByoTurn | null;
+    writePcm(bytes: Uint8Array): void;
+    writePcmBase64(b64: string): void;
+    setTranscript(text: string, mode?: 'replace' | 'append'): void;
+    /** Await pending writes and close the utterance (normal turn end). */
+    closeActiveTurn(): Promise<void>;
+    /** Cancel active utterance / interrupt (user barge-in). */
+    bargeIn(): void;
+    /**
+     * Drop the active turn on unexpected disconnect — cancel if open so the
+     * player does not keep an orphaned utterance.
+     * Does **not** call `speech.interrupt` when idle (safe after a clean `end()`).
+     */
+    abandonActiveTurn(): void;
+    clearPending(): void;
+};
+/**
+ * Shared per-turn PCM + transcript state machine for BYO createUtterance bridges.
+ */
+export declare function createTurnSession(experience: ByoPcmExperience, options: CreateTurnSessionOptions): ByoTurnSession;
+//# sourceMappingURL=turn.d.ts.map

package/dist/byo/turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn.d.ts","sourceRoot":"","sources":["../../src/byo/turn.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAEpE,MAAM,MAAM,OAAO,GAAG;IACrB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACtC;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC5B,OAAO,IAAI,OAAO,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAClC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC/D,sEAAsE;IACtE,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,2DAA2D;IAC3D,OAAO,IAAI,IAAI,CAAC;IAChB;;;;OAIG;IACH,iBAAiB,IAAI,IAAI,CAAC;IAC1B,YAAY,IAAI,IAAI,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,UAAU,EAAE,gBAAgB,EAC5B,OAAO,EAAE,wBAAwB,GAC/B,cAAc,CAwHhB"}