realtime-voice-agents 2.0.0

package/dist/BackgroundAudioPlayer-iMcivjis.mjs

@@ -0,0 +1,282 @@
+import { o as mulawDecodeSample, s as mulawEncodeSample } from "./mulaw--cwU2c9L.mjs";
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+//#region src/audio/gain.ts
+/**
+* Gain application on μ-law frames, used for background-audio fades and volume.
+* μ-law is logarithmic, so gain must ramp in the linear domain:
+* decode → scale → re-encode.
+*/
+/** Scale an entire μ-law frame by a constant linear gain. */
+function scaleMulaw(frame, gain) {
+	if (gain === 1) return frame;
+	const out = new Uint8Array(frame.length);
+	for (let i = 0; i < frame.length; i++) out[i] = mulawEncodeSample(clamp16(mulawDecodeSample(frame[i]) * gain));
+	return out;
+}
+/**
+* Apply a linearly interpolated gain ramp across a μ-law frame
+* (`startGain` at the first sample → `endGain` at the last).
+*/
+function fadeMulaw(frame, startGain, endGain) {
+	if (startGain === endGain) return scaleMulaw(frame, startGain);
+	const out = new Uint8Array(frame.length);
+	const step = frame.length > 1 ? (endGain - startGain) / (frame.length - 1) : 0;
+	for (let i = 0; i < frame.length; i++) {
+		const gain = startGain + step * i;
+		out[i] = mulawEncodeSample(clamp16(mulawDecodeSample(frame[i]) * gain));
+	}
+	return out;
+}
+function clamp16(v) {
+	const r = Math.round(v);
+	if (r > 32767) return 32767;
+	if (r < -32768) return -32768;
+	return r;
+}
+//#endregion
+//#region src/audio/background/loader.ts
+/**
+* Preset asset loading. Assets are raw 8 kHz μ-law loops in the package's
+* `assets/` directory (generated by scripts/generate-tones.ts and shipped in
+* the npm tarball). Custom sources accept a Buffer or a file path.
+*/
+const PRESET_FILES = {
+	"elevator-jazz": "elevator-jazz.ulaw",
+	lofi: "lofi.ulaw",
+	"keyboard-typing": "keyboard-typing.ulaw",
+	"thinking-hum": "thinking-hum.ulaw",
+	ringing: "ringing.ulaw"
+};
+let cachedAssetsDir = null;
+const bufferCache = /* @__PURE__ */ new Map();
+function assetsDir() {
+	if (cachedAssetsDir) return cachedAssetsDir;
+	const here = path.dirname(fileURLToPath(import.meta.url));
+	const candidates = [
+		path.resolve(here, "../assets"),
+		path.resolve(here, "../../assets"),
+		path.resolve(here, "../../../assets")
+	];
+	for (const candidate of candidates) if (existsSync(candidate)) {
+		cachedAssetsDir = candidate;
+		return candidate;
+	}
+	throw new Error(`background-audio assets directory not found (looked in: ${candidates.join(", ")})`);
+}
+function isPresetName(spec) {
+	return typeof spec === "string";
+}
+/** Resolve a spec to raw μ-law bytes (cached per preset/path). */
+function loadBackgroundAudio(spec) {
+	if (isPresetName(spec)) {
+		const file = PRESET_FILES[spec];
+		if (!file) throw new Error(`unknown background-audio preset "${spec}"`);
+		const full = path.join(assetsDir(), file);
+		let buffer = bufferCache.get(full);
+		if (!buffer) {
+			buffer = readFileSync(full);
+			bufferCache.set(full, buffer);
+		}
+		return buffer;
+	}
+	if (Buffer.isBuffer(spec.custom)) return spec.custom;
+	let buffer = bufferCache.get(spec.custom);
+	if (!buffer) {
+		buffer = readFileSync(spec.custom);
+		bufferCache.set(spec.custom, buffer);
+	}
+	return buffer;
+}
+function presetLabel(spec) {
+	return isPresetName(spec) ? spec : void 0;
+}
+//#endregion
+//#region src/audio/background/BackgroundAudioPlayer.ts
+/**
+* BackgroundAudioPlayer — paced μ-law loop injection into the Twilio stream.
+*
+* Twilio has ONE sequential playout buffer, so background audio must be paced
+* in near-realtime (never bulk-queued): frames-due are computed from the wall
+* clock each tick (drift-corrected), with a small burst cap, keeping at most
+* a few frames buffered ahead. That way, when real agent audio arrives it
+* queues at most ~2 frames behind the hold loop instead of seconds.
+*
+* Safety rails from production systems: a generation counter invalidates
+* orphan intervals after stop/restart races; a hard max-duration failsafe
+* stops a hung tool from looping forever; refcounted acquire/release lets
+* concurrent tools share one loop; a start delay keeps fast tools silent.
+*/
+const FRAME_MS = 20;
+const MAX_BURST_FRAMES = 5;
+var BackgroundAudioPlayer = class {
+	deps;
+	now;
+	generation = 0;
+	active = null;
+	startDelayTimer = null;
+	/** Tool-call ids currently holding the loop. */
+	holders = /* @__PURE__ */ new Set();
+	pendingSpec = null;
+	constructor(deps) {
+		this.deps = deps;
+		this.now = deps.now ?? Date.now;
+	}
+	get isPlaying() {
+		return this.active !== null;
+	}
+	/**
+	* Refcounted acquisition (one holder per tool call). The loop starts after
+	* `startDelayMs` unless every holder releases first.
+	*/
+	acquire(holderId, spec, options = {}) {
+		this.holders.add(holderId);
+		if (this.active || this.startDelayTimer) return;
+		this.pendingSpec = {
+			spec,
+			options
+		};
+		const delay = options.startDelayMs ?? 1e3;
+		if (delay <= 0) {
+			this.startNow();
+			return;
+		}
+		this.startDelayTimer = setTimeout(() => {
+			this.startDelayTimer = null;
+			if (this.holders.size > 0) this.startNow();
+		}, delay);
+		this.startDelayTimer.unref?.();
+	}
+	/** Release one holder; the loop stops when the last holder releases. */
+	release(holderId, opts = {}) {
+		this.holders.delete(holderId);
+		if (this.holders.size > 0) return;
+		this.stop({ immediate: opts.immediate });
+	}
+	/** Direct start (facade `playBackgroundAudio`). Bypasses refcounting. */
+	start(spec, options = {}) {
+		this.holders.add("__manual__");
+		this.cancelDelay();
+		this.pendingSpec = {
+			spec,
+			options
+		};
+		this.startNow();
+	}
+	/**
+	* Stop the loop. Fade-out is applied when `immediate` is false and a
+	* fadeOutMs was configured; agent-audio preemption should pass
+	* `immediate: true` (a fade would delay real speech behind it).
+	*/
+	stop(opts = {}) {
+		this.holders.clear();
+		this.cancelDelay();
+		this.pendingSpec = null;
+		const active = this.active;
+		if (!active) return;
+		this.generation++;
+		clearInterval(active.interval);
+		clearTimeout(active.failsafe);
+		this.active = null;
+		const fadeOutMs = opts.immediate ? 0 : active.fadeOutMs ?? 0;
+		if (fadeOutMs > 0) {
+			const frames = Math.min(Math.ceil(fadeOutMs / FRAME_MS), 25);
+			let offset = active.offset;
+			for (let i = 0; i < frames; i++) {
+				const frame = this.extractFrame(active.scaled, offset);
+				offset = frame.nextOffset;
+				const gainStart = 1 - i / frames;
+				const gainEnd = 1 - (i + 1) / frames;
+				this.deps.sendMedia(Buffer.from(fadeMulaw(frame.frame, gainStart, gainEnd)).toString("base64"));
+			}
+		}
+		this.deps.onStopped?.({ preset: active.preset });
+	}
+	/** Real agent audio arrived — kill the loop instantly, no fade, no clear. */
+	notifyAgentAudio() {
+		if (!this.active && !this.startDelayTimer) return;
+		this.stop({ immediate: true });
+	}
+	cancelDelay() {
+		if (this.startDelayTimer) {
+			clearTimeout(this.startDelayTimer);
+			this.startDelayTimer = null;
+		}
+	}
+	startNow() {
+		if (this.active || !this.pendingSpec) return;
+		const { spec, options } = this.pendingSpec;
+		this.pendingSpec = null;
+		let buffer;
+		try {
+			buffer = loadBackgroundAudio(spec);
+		} catch {
+			return;
+		}
+		if (buffer.length < 160) return;
+		const volume = options.volume ?? .4;
+		const scaled = volume === 1 ? buffer : Buffer.from(scaleMulaw(new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.length), volume));
+		const generation = ++this.generation;
+		const fadeInMs = options.fadeInMs ?? 200;
+		const loop = {
+			generation,
+			buffer,
+			scaled,
+			preset: presetLabel(spec),
+			offset: 0,
+			startedAt: this.now(),
+			framesSent: 0,
+			fadeInFramesLeft: Math.ceil(fadeInMs / FRAME_MS),
+			volume,
+			fadeInMs,
+			fadeOutMs: options.fadeOutMs ?? 200,
+			interval: setInterval(() => this.tick(generation), FRAME_MS),
+			failsafe: setTimeout(() => {
+				if (this.active?.generation === generation) this.stop({ immediate: true });
+			}, options.maxDurationMs ?? 6e4)
+		};
+		loop.interval.unref?.();
+		loop.failsafe.unref?.();
+		this.active = loop;
+		this.deps.onStarted?.({ preset: loop.preset });
+	}
+	tick(generation) {
+		const active = this.active;
+		if (!active || active.generation !== generation) return;
+		const elapsed = this.now() - active.startedAt;
+		const framesDue = Math.floor(elapsed / FRAME_MS) + 1 - active.framesSent;
+		const toSend = Math.min(Math.max(framesDue, 0), MAX_BURST_FRAMES);
+		for (let i = 0; i < toSend; i++) {
+			const { frame, nextOffset } = this.extractFrame(active.scaled, active.offset);
+			active.offset = nextOffset;
+			let payload = frame;
+			if (active.fadeInFramesLeft > 0) {
+				const total = Math.ceil(active.fadeInMs / FRAME_MS);
+				const index = total - active.fadeInFramesLeft;
+				payload = fadeMulaw(frame, index / total, (index + 1) / total);
+				active.fadeInFramesLeft--;
+			}
+			this.deps.sendMedia(Buffer.from(payload).toString("base64"));
+			active.framesSent++;
+		}
+	}
+	/** Wrap-around frame extraction for seamless looping. */
+	extractFrame(buffer, offset) {
+		const size = 160;
+		if (offset + size <= buffer.length) return {
+			frame: new Uint8Array(buffer.buffer, buffer.byteOffset + offset, size),
+			nextOffset: (offset + size) % buffer.length
+		};
+		const frame = new Uint8Array(size);
+		const tail = buffer.length - offset;
+		frame.set(new Uint8Array(buffer.buffer, buffer.byteOffset + offset, tail), 0);
+		frame.set(new Uint8Array(buffer.buffer, buffer.byteOffset, size - tail), tail);
+		return {
+			frame,
+			nextOffset: size - tail
+		};
+	}
+};
+//#endregion
+export { scaleMulaw as a, fadeMulaw as i, isPresetName as n, loadBackgroundAudio as r, BackgroundAudioPlayer as t };

package/dist/BackgroundAudioPlayer-jfRULWKC.cjs

@@ -0,0 +1,313 @@
+const require_rolldown_runtime = require("./rolldown-runtime-VH7oDXx4.cjs");
+const require_mulaw = require("./mulaw-DLUObjdP.cjs");
+let node_fs = require("node:fs");
+let node_path = require("node:path");
+node_path = require_rolldown_runtime.__toESM(node_path, 1);
+let node_url = require("node:url");
+//#region src/audio/gain.ts
+/**
+* Gain application on μ-law frames, used for background-audio fades and volume.
+* μ-law is logarithmic, so gain must ramp in the linear domain:
+* decode → scale → re-encode.
+*/
+/** Scale an entire μ-law frame by a constant linear gain. */
+function scaleMulaw(frame, gain) {
+	if (gain === 1) return frame;
+	const out = new Uint8Array(frame.length);
+	for (let i = 0; i < frame.length; i++) out[i] = require_mulaw.mulawEncodeSample(clamp16(require_mulaw.mulawDecodeSample(frame[i]) * gain));
+	return out;
+}
+/**
+* Apply a linearly interpolated gain ramp across a μ-law frame
+* (`startGain` at the first sample → `endGain` at the last).
+*/
+function fadeMulaw(frame, startGain, endGain) {
+	if (startGain === endGain) return scaleMulaw(frame, startGain);
+	const out = new Uint8Array(frame.length);
+	const step = frame.length > 1 ? (endGain - startGain) / (frame.length - 1) : 0;
+	for (let i = 0; i < frame.length; i++) {
+		const gain = startGain + step * i;
+		out[i] = require_mulaw.mulawEncodeSample(clamp16(require_mulaw.mulawDecodeSample(frame[i]) * gain));
+	}
+	return out;
+}
+function clamp16(v) {
+	const r = Math.round(v);
+	if (r > 32767) return 32767;
+	if (r < -32768) return -32768;
+	return r;
+}
+//#endregion
+//#region src/audio/background/loader.ts
+/**
+* Preset asset loading. Assets are raw 8 kHz μ-law loops in the package's
+* `assets/` directory (generated by scripts/generate-tones.ts and shipped in
+* the npm tarball). Custom sources accept a Buffer or a file path.
+*/
+const PRESET_FILES = {
+	"elevator-jazz": "elevator-jazz.ulaw",
+	lofi: "lofi.ulaw",
+	"keyboard-typing": "keyboard-typing.ulaw",
+	"thinking-hum": "thinking-hum.ulaw",
+	ringing: "ringing.ulaw"
+};
+let cachedAssetsDir = null;
+const bufferCache = /* @__PURE__ */ new Map();
+function assetsDir() {
+	if (cachedAssetsDir) return cachedAssetsDir;
+	const here = node_path.default.dirname((0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href));
+	const candidates = [
+		node_path.default.resolve(here, "../assets"),
+		node_path.default.resolve(here, "../../assets"),
+		node_path.default.resolve(here, "../../../assets")
+	];
+	for (const candidate of candidates) if ((0, node_fs.existsSync)(candidate)) {
+		cachedAssetsDir = candidate;
+		return candidate;
+	}
+	throw new Error(`background-audio assets directory not found (looked in: ${candidates.join(", ")})`);
+}
+function isPresetName(spec) {
+	return typeof spec === "string";
+}
+/** Resolve a spec to raw μ-law bytes (cached per preset/path). */
+function loadBackgroundAudio(spec) {
+	if (isPresetName(spec)) {
+		const file = PRESET_FILES[spec];
+		if (!file) throw new Error(`unknown background-audio preset "${spec}"`);
+		const full = node_path.default.join(assetsDir(), file);
+		let buffer = bufferCache.get(full);
+		if (!buffer) {
+			buffer = (0, node_fs.readFileSync)(full);
+			bufferCache.set(full, buffer);
+		}
+		return buffer;
+	}
+	if (Buffer.isBuffer(spec.custom)) return spec.custom;
+	let buffer = bufferCache.get(spec.custom);
+	if (!buffer) {
+		buffer = (0, node_fs.readFileSync)(spec.custom);
+		bufferCache.set(spec.custom, buffer);
+	}
+	return buffer;
+}
+function presetLabel(spec) {
+	return isPresetName(spec) ? spec : void 0;
+}
+//#endregion
+//#region src/audio/background/BackgroundAudioPlayer.ts
+/**
+* BackgroundAudioPlayer — paced μ-law loop injection into the Twilio stream.
+*
+* Twilio has ONE sequential playout buffer, so background audio must be paced
+* in near-realtime (never bulk-queued): frames-due are computed from the wall
+* clock each tick (drift-corrected), with a small burst cap, keeping at most
+* a few frames buffered ahead. That way, when real agent audio arrives it
+* queues at most ~2 frames behind the hold loop instead of seconds.
+*
+* Safety rails from production systems: a generation counter invalidates
+* orphan intervals after stop/restart races; a hard max-duration failsafe
+* stops a hung tool from looping forever; refcounted acquire/release lets
+* concurrent tools share one loop; a start delay keeps fast tools silent.
+*/
+const FRAME_MS = 20;
+const MAX_BURST_FRAMES = 5;
+var BackgroundAudioPlayer = class {
+	deps;
+	now;
+	generation = 0;
+	active = null;
+	startDelayTimer = null;
+	/** Tool-call ids currently holding the loop. */
+	holders = /* @__PURE__ */ new Set();
+	pendingSpec = null;
+	constructor(deps) {
+		this.deps = deps;
+		this.now = deps.now ?? Date.now;
+	}
+	get isPlaying() {
+		return this.active !== null;
+	}
+	/**
+	* Refcounted acquisition (one holder per tool call). The loop starts after
+	* `startDelayMs` unless every holder releases first.
+	*/
+	acquire(holderId, spec, options = {}) {
+		this.holders.add(holderId);
+		if (this.active || this.startDelayTimer) return;
+		this.pendingSpec = {
+			spec,
+			options
+		};
+		const delay = options.startDelayMs ?? 1e3;
+		if (delay <= 0) {
+			this.startNow();
+			return;
+		}
+		this.startDelayTimer = setTimeout(() => {
+			this.startDelayTimer = null;
+			if (this.holders.size > 0) this.startNow();
+		}, delay);
+		this.startDelayTimer.unref?.();
+	}
+	/** Release one holder; the loop stops when the last holder releases. */
+	release(holderId, opts = {}) {
+		this.holders.delete(holderId);
+		if (this.holders.size > 0) return;
+		this.stop({ immediate: opts.immediate });
+	}
+	/** Direct start (facade `playBackgroundAudio`). Bypasses refcounting. */
+	start(spec, options = {}) {
+		this.holders.add("__manual__");
+		this.cancelDelay();
+		this.pendingSpec = {
+			spec,
+			options
+		};
+		this.startNow();
+	}
+	/**
+	* Stop the loop. Fade-out is applied when `immediate` is false and a
+	* fadeOutMs was configured; agent-audio preemption should pass
+	* `immediate: true` (a fade would delay real speech behind it).
+	*/
+	stop(opts = {}) {
+		this.holders.clear();
+		this.cancelDelay();
+		this.pendingSpec = null;
+		const active = this.active;
+		if (!active) return;
+		this.generation++;
+		clearInterval(active.interval);
+		clearTimeout(active.failsafe);
+		this.active = null;
+		const fadeOutMs = opts.immediate ? 0 : active.fadeOutMs ?? 0;
+		if (fadeOutMs > 0) {
+			const frames = Math.min(Math.ceil(fadeOutMs / FRAME_MS), 25);
+			let offset = active.offset;
+			for (let i = 0; i < frames; i++) {
+				const frame = this.extractFrame(active.scaled, offset);
+				offset = frame.nextOffset;
+				const gainStart = 1 - i / frames;
+				const gainEnd = 1 - (i + 1) / frames;
+				this.deps.sendMedia(Buffer.from(fadeMulaw(frame.frame, gainStart, gainEnd)).toString("base64"));
+			}
+		}
+		this.deps.onStopped?.({ preset: active.preset });
+	}
+	/** Real agent audio arrived — kill the loop instantly, no fade, no clear. */
+	notifyAgentAudio() {
+		if (!this.active && !this.startDelayTimer) return;
+		this.stop({ immediate: true });
+	}
+	cancelDelay() {
+		if (this.startDelayTimer) {
+			clearTimeout(this.startDelayTimer);
+			this.startDelayTimer = null;
+		}
+	}
+	startNow() {
+		if (this.active || !this.pendingSpec) return;
+		const { spec, options } = this.pendingSpec;
+		this.pendingSpec = null;
+		let buffer;
+		try {
+			buffer = loadBackgroundAudio(spec);
+		} catch {
+			return;
+		}
+		if (buffer.length < 160) return;
+		const volume = options.volume ?? .4;
+		const scaled = volume === 1 ? buffer : Buffer.from(scaleMulaw(new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.length), volume));
+		const generation = ++this.generation;
+		const fadeInMs = options.fadeInMs ?? 200;
+		const loop = {
+			generation,
+			buffer,
+			scaled,
+			preset: presetLabel(spec),
+			offset: 0,
+			startedAt: this.now(),
+			framesSent: 0,
+			fadeInFramesLeft: Math.ceil(fadeInMs / FRAME_MS),
+			volume,
+			fadeInMs,
+			fadeOutMs: options.fadeOutMs ?? 200,
+			interval: setInterval(() => this.tick(generation), FRAME_MS),
+			failsafe: setTimeout(() => {
+				if (this.active?.generation === generation) this.stop({ immediate: true });
+			}, options.maxDurationMs ?? 6e4)
+		};
+		loop.interval.unref?.();
+		loop.failsafe.unref?.();
+		this.active = loop;
+		this.deps.onStarted?.({ preset: loop.preset });
+	}
+	tick(generation) {
+		const active = this.active;
+		if (!active || active.generation !== generation) return;
+		const elapsed = this.now() - active.startedAt;
+		const framesDue = Math.floor(elapsed / FRAME_MS) + 1 - active.framesSent;
+		const toSend = Math.min(Math.max(framesDue, 0), MAX_BURST_FRAMES);
+		for (let i = 0; i < toSend; i++) {
+			const { frame, nextOffset } = this.extractFrame(active.scaled, active.offset);
+			active.offset = nextOffset;
+			let payload = frame;
+			if (active.fadeInFramesLeft > 0) {
+				const total = Math.ceil(active.fadeInMs / FRAME_MS);
+				const index = total - active.fadeInFramesLeft;
+				payload = fadeMulaw(frame, index / total, (index + 1) / total);
+				active.fadeInFramesLeft--;
+			}
+			this.deps.sendMedia(Buffer.from(payload).toString("base64"));
+			active.framesSent++;
+		}
+	}
+	/** Wrap-around frame extraction for seamless looping. */
+	extractFrame(buffer, offset) {
+		const size = 160;
+		if (offset + size <= buffer.length) return {
+			frame: new Uint8Array(buffer.buffer, buffer.byteOffset + offset, size),
+			nextOffset: (offset + size) % buffer.length
+		};
+		const frame = new Uint8Array(size);
+		const tail = buffer.length - offset;
+		frame.set(new Uint8Array(buffer.buffer, buffer.byteOffset + offset, tail), 0);
+		frame.set(new Uint8Array(buffer.buffer, buffer.byteOffset, size - tail), tail);
+		return {
+			frame,
+			nextOffset: size - tail
+		};
+	}
+};
+//#endregion
+Object.defineProperty(exports, "BackgroundAudioPlayer", {
+	enumerable: true,
+	get: function() {
+		return BackgroundAudioPlayer;
+	}
+});
+Object.defineProperty(exports, "fadeMulaw", {
+	enumerable: true,
+	get: function() {
+		return fadeMulaw;
+	}
+});
+Object.defineProperty(exports, "isPresetName", {
+	enumerable: true,
+	get: function() {
+		return isPresetName;
+	}
+});
+Object.defineProperty(exports, "loadBackgroundAudio", {
+	enumerable: true,
+	get: function() {
+		return loadBackgroundAudio;
+	}
+});
+Object.defineProperty(exports, "scaleMulaw", {
+	enumerable: true,
+	get: function() {
+		return scaleMulaw;
+	}
+});

package/dist/BaseRealtimeProvider-BQigr5mB.mjs

@@ -0,0 +1,62 @@
+import { t as TypedEmitter } from "./events-BylBSBW-.mjs";
+//#region src/logging/logger.ts
+const noopLogger = {
+	debug: () => {},
+	info: () => {},
+	warn: () => {},
+	error: () => {},
+	child: () => noopLogger
+};
+/** Console-backed logger, useful in examples and debugging. */
+function consoleLogger(context = {}) {
+	const prefix = Object.keys(context).length ? ` ${JSON.stringify(context)}` : "";
+	return {
+		debug: (msg, data) => console.debug(`[debug]${prefix} ${msg}`, data ?? ""),
+		info: (msg, data) => console.info(`[info]${prefix} ${msg}`, data ?? ""),
+		warn: (msg, data) => console.warn(`[warn]${prefix} ${msg}`, data ?? ""),
+		error: (msg, data) => console.error(`[error]${prefix} ${msg}`, data ?? ""),
+		child: (extra) => consoleLogger({
+			...context,
+			...extra
+		})
+	};
+}
+function childLogger(logger, context) {
+	return logger.child ? logger.child(context) : logger;
+}
+//#endregion
+//#region src/internal/merge.ts
+/** Recursive plain-object merge; arrays and non-objects replace wholesale. */
+function deepMerge(base, patch) {
+	if (!patch) return base;
+	const out = { ...base };
+	for (const [key, value] of Object.entries(patch)) {
+		const existing = out[key];
+		if (value !== null && typeof value === "object" && !Array.isArray(value) && existing !== null && typeof existing === "object" && !Array.isArray(existing)) out[key] = deepMerge(existing, value);
+		else out[key] = value;
+	}
+	return out;
+}
+//#endregion
+//#region src/providers/base/BaseRealtimeProvider.ts
+/**
+* The provider contract: μ-law in, μ-law out, normalized events.
+* Transcoding (when the provider speaks PCM) lives inside the provider, so
+* the engine stays codec-free. `connect()` is re-invokable on the same
+* instance — the session layer owns reconnect policy and context re-injection.
+*/
+var BaseRealtimeProvider = class extends TypedEmitter {
+	/** Interrupt in-flight generation (where the wire protocol supports it). */
+	cancelResponse() {}
+	/** Trim the last assistant item to what the caller actually heard. */
+	truncatePlayback(_itemId, _audioEndMs) {}
+	/**
+	* Whether the most recent connect restored server-side context (session
+	* resumption). When true, the engine skips transcript re-injection.
+	*/
+	get didResume() {
+		return false;
+	}
+};
+//#endregion
+export { noopLogger as a, consoleLogger as i, deepMerge as n, childLogger as r, BaseRealtimeProvider as t };