@memberjunction/livekit-room-server 6.2.0-edge.2 → 6.2.0-edge.4

package/dist/room-audio/pcm-frame-pump.js

@@ -0,0 +1,253 @@
+/**
+ * @fileoverview {@link PcmFramePump} — plays a PCM16 buffer out to a sink in real time, one 20 ms frame at a time.
+ *
+ * The native LiveKit wrapper's `publishAudio` queues whatever it is given and drains it as fast as the WebRTC audio
+ * source accepts it; it does not pace. Handing it a whole song would buffer minutes of audio in memory and make pause,
+ * stop and announcements lag by that much. So the pump paces itself: a fast ticker compares monotonic elapsed time
+ * with frames sent and emits only what is due, plus a small lead (~150 ms) that absorbs timer jitter. The lead is all
+ * that is ever outstanding downstream.
+ *
+ * - **Drift correction** — frames due are computed from the elapsed time since the timeline started, never by
+ *   counting ticks, so a late tick sends two frames and the average rate stays exact.
+ * - **Bounded catch-up** — after a long stall (a blocked event loop) the pump does not burst the backlog; it drops it
+ *   and restarts the timeline, so the downstream queue can never grow past the lead plus a small margin.
+ * - **Loop**, **Pause/Resume** (resume restarts the timeline — no burst), and **InsertClip**: the music fades down to a
+ *   duck level, the clip plays over it, and the music fades back up.
+ *
+ * The clock and ticker are injectable so tests drive time by hand.
+ *
+ * @module @memberjunction/livekit-room-server
+ */
+import { LogError } from '@memberjunction/core';
+import { FloatToPcm16 } from './audio-decoder.js';
+/** How often the ticker fires, in ms. Shorter than a frame so lateness never exceeds about half a frame. */
+const TICK_MS = 10;
+/** How far behind real time the pump will catch up before it drops the backlog instead, in ms. */
+const MAX_CATCH_UP_MS = 200;
+/** The production clock: `performance.now()` and an unref'd `setInterval` (a playing pump never holds the process open). */
+export const SystemPumpClock = {
+    Now: () => performance.now(),
+    StartTicker: (callback, intervalMs) => {
+        const handle = setInterval(callback, intervalMs);
+        handle.unref?.();
+        return { Cancel: () => clearInterval(handle) };
+    },
+};
+/** Paces mono PCM16 out to a sink in real time. See the file overview. */
+export class PcmFramePump {
+    /** @throws {Error} when the music is empty or a timing option is not positive. */
+    constructor(options) {
+        this.ticker = null;
+        this.running = false;
+        this.paused = false;
+        this.ended = false;
+        this.timelineStart = 0;
+        this.framesOnTimeline = 0;
+        this.framesSent = 0;
+        this.musicPosition = 0;
+        this.musicDone = false;
+        this.gain = 1;
+        this.clipQueue = [];
+        this.currentClip = null;
+        this.clipPosition = 0;
+        if (options.Music.length === 0)
+            throw new Error('PcmFramePump needs non-empty audio to play.');
+        if (!(options.SampleRate > 0))
+            throw new Error(`PcmFramePump needs a positive sample rate; got ${options.SampleRate}.`);
+        this.music = options.Music;
+        this.sampleRate = options.SampleRate;
+        this.sink = options.Sink;
+        this.loop = options.Loop ?? true;
+        this.frameMs = options.FrameMs ?? 20;
+        this.samplesPerFrame = Math.max(1, Math.round((this.sampleRate * this.frameMs) / 1000));
+        this.leadFrames = Math.max(1, Math.ceil((options.LeadMs ?? 150) / this.frameMs));
+        this.maxBurstFrames = this.leadFrames + Math.ceil(MAX_CATCH_UP_MS / this.frameMs);
+        this.duckLevel = Math.min(1, Math.max(0, options.DuckLevel ?? 0.15));
+        const duckSamples = Math.max(1, Math.round(((options.DuckMs ?? 150) * this.sampleRate) / 1000));
+        this.gainStep = (1 - this.duckLevel) / duckSamples;
+        this.clock = options.Clock ?? SystemPumpClock;
+        this.onEnded = options.OnEnded;
+    }
+    /** True between {@link Start} and the pump ending (including while paused). */
+    get IsRunning() {
+        return this.running;
+    }
+    /** True while paused. */
+    get IsPaused() {
+        return this.paused;
+    }
+    /** Frames handed to the sink so far. */
+    get FramesSent() {
+        return this.framesSent;
+    }
+    /** Samples per frame at the pump's rate. */
+    get SamplesPerFrame() {
+        return this.samplesPerFrame;
+    }
+    /** Starts playback: sends the lead immediately, then paces in real time. A second call is a no-op. */
+    Start() {
+        if (this.running || this.ended) {
+            return;
+        }
+        this.running = true;
+        this.restartTimeline();
+        this.ticker = this.clock.StartTicker(() => this.tick(), TICK_MS);
+        this.tick();
+    }
+    /** Stops sending frames until {@link Resume}. Playback position, ducking and queued clips are kept. */
+    Pause() {
+        if (this.running) {
+            this.paused = true;
+        }
+    }
+    /** Continues after {@link Pause} from where it left off, on a fresh timeline (so nothing bursts). */
+    Resume() {
+        if (!this.running || !this.paused) {
+            return;
+        }
+        this.paused = false;
+        this.restartTimeline();
+        this.tick();
+    }
+    /**
+     * How much already-sent audio is still ahead of real time, in ms: the pump keeps the sink up to `LeadMs` ahead, so
+     * after the last frame is sent the room is still playing this much. Zero once real time has caught up.
+     */
+    get QueuedAheadMs() {
+        const sentUntil = this.timelineStart + this.framesOnTimeline * this.frameMs;
+        return Math.max(0, sentUntil - this.clock.Now());
+    }
+    /**
+     * Plays `pcm` over the music: the music fades down to the duck level, the clip plays, the music fades back up.
+     * Clips queue behind one another.
+     *
+     * @param pcm Mono PCM16 at the pump's sample rate.
+     * @returns Resolves `true` once the clip has been sent in full, `false` if the pump stopped first or the clip is empty.
+     */
+    InsertClip(pcm) {
+        if (!this.running || pcm.length === 0) {
+            return Promise.resolve(false);
+        }
+        return new Promise((resolve) => this.clipQueue.push({ Pcm: pcm, Done: resolve }));
+    }
+    /** Stops the pump for good. Idempotent; pending clips resolve `false`. */
+    Stop() {
+        this.finish('Stopped');
+    }
+    restartTimeline() {
+        this.timelineStart = this.clock.Now();
+        this.framesOnTimeline = 0;
+    }
+    tick() {
+        if (!this.running || this.paused) {
+            return;
+        }
+        try {
+            const due = this.framesDue();
+            for (let i = 0; i < due && this.running && !this.paused; i++) {
+                this.emitFrame();
+            }
+        }
+        catch (err) {
+            LogError(`[PcmFramePump] the sink failed; stopping playback: ${err instanceof Error ? err.message : String(err)}`);
+            this.finish('SinkError');
+        }
+    }
+    /** Frames owed to the sink now, given elapsed time and the lead. Drops the backlog after a long stall. */
+    framesDue() {
+        const elapsed = this.clock.Now() - this.timelineStart;
+        const target = Math.floor(elapsed / this.frameMs) + this.leadFrames;
+        const due = target - this.framesOnTimeline;
+        if (due > this.maxBurstFrames) {
+            this.restartTimeline(); // stalled too long: skip the missed audio rather than flood the sink
+            return this.leadFrames;
+        }
+        return Math.max(0, due);
+    }
+    emitFrame() {
+        const frame = new Int16Array(this.samplesPerFrame);
+        for (let i = 0; i < frame.length; i++) {
+            frame[i] = FloatToPcm16(this.nextSample());
+        }
+        this.framesOnTimeline++;
+        this.framesSent++;
+        this.sink(frame);
+        if (this.musicDone && !this.currentClip && this.clipQueue.length === 0) {
+            this.finish('Completed');
+        }
+    }
+    /** The next output sample in [-1, 1]: ducked music plus whatever clip is playing. */
+    nextSample() {
+        this.advanceGain();
+        this.startQueuedClipIfDucked();
+        return this.nextMusicSample() * this.gain + this.nextClipSample();
+    }
+    /** Moves the music gain one step toward its target: the duck level while a clip is queued or playing, else full. */
+    advanceGain() {
+        const ducking = this.currentClip !== null || this.clipQueue.length > 0;
+        const target = ducking ? this.duckLevel : 1;
+        if (this.gain > target) {
+            this.gain = Math.max(target, this.gain - this.gainStep);
+        }
+        else if (this.gain < target) {
+            this.gain = Math.min(target, this.gain + this.gainStep);
+        }
+    }
+    startQueuedClipIfDucked() {
+        if (!this.currentClip && this.clipQueue.length > 0 && this.gain <= this.duckLevel) {
+            this.currentClip = this.clipQueue.shift() ?? null;
+            this.clipPosition = 0;
+        }
+    }
+    nextMusicSample() {
+        if (this.musicDone) {
+            return 0;
+        }
+        const sample = this.music[this.musicPosition] / 32768;
+        this.musicPosition++;
+        if (this.musicPosition >= this.music.length) {
+            this.musicPosition = 0;
+            this.musicDone = !this.loop;
+        }
+        return sample;
+    }
+    nextClipSample() {
+        const clip = this.currentClip;
+        if (!clip) {
+            return 0;
+        }
+        const sample = clip.Pcm[this.clipPosition] / 32768;
+        this.clipPosition++;
+        if (this.clipPosition >= clip.Pcm.length) {
+            this.currentClip = null;
+            clip.Done(true);
+        }
+        return sample;
+    }
+    /** Ends the pump once: cancels the ticker, fails any pending clips, reports the reason. */
+    finish(reason) {
+        if (this.ended) {
+            return;
+        }
+        this.ended = true;
+        this.running = false;
+        this.paused = false;
+        try {
+            this.ticker?.Cancel();
+        }
+        finally {
+            this.ticker = null;
+            this.failPendingClips();
+            this.onEnded?.(reason);
+        }
+    }
+    failPendingClips() {
+        const pending = this.currentClip ? [this.currentClip, ...this.clipQueue] : [...this.clipQueue];
+        this.currentClip = null;
+        this.clipQueue.length = 0;
+        for (const clip of pending) {
+            clip.Done(false);
+        }
+    }
+}
+//# sourceMappingURL=pcm-frame-pump.js.map

package/dist/room-audio/pcm-frame-pump.js.map

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

package/dist/room-audio/room-audio-decode-cache.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview {@link RoomAudioDecodeCache} — a small LRU of ready-to-play PCM keyed by source (an `MJ: Files` id or
+ * a URL), so every caller placed on hold in the same queue does not re-download and re-decode the same file.
+ *
+ * It caches the in-flight PROMISE, so ten callers arriving at once share one download. A failed load is evicted so
+ * the next caller retries. Bounded both by entry count and by total samples held.
+ *
+ * @module @memberjunction/livekit-room-server
+ */
+/** Default maximum number of cached sources. */
+export declare const DEFAULT_DECODE_CACHE_ENTRIES = 8;
+/** Default maximum total samples held across all entries (128 Mi samples = 256 MB of PCM16). */
+export declare const DEFAULT_DECODE_CACHE_MAX_SAMPLES: number;
+/** A bounded, promise-sharing LRU of decoded PCM. */
+export declare class RoomAudioDecodeCache {
+    private readonly maxEntries;
+    private readonly maxSamples;
+    private readonly slots;
+    /**
+     * @param maxEntries Maximum number of cached sources.
+     * @param maxSamples Maximum total samples held across all resolved entries.
+     */
+    constructor(maxEntries?: number, maxSamples?: number);
+    /** How many sources are cached (or loading). */
+    get Size(): number;
+    /**
+     * Returns the cached PCM for `key`, or runs `load` once and caches its result. Concurrent callers for the same key
+     * share one load. A rejected load is removed so the next call retries.
+     */
+    GetOrLoad(key: string, load: () => Promise<Int16Array>): Promise<Int16Array>;
+    /** Empties the cache. */
+    Clear(): void;
+    /** Drops least-recently-used entries until both bounds hold (never the most recent one). */
+    private evictOverflow;
+    private totalSamples;
+}
+//# sourceMappingURL=room-audio-decode-cache.d.ts.map

package/dist/room-audio/room-audio-decode-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-audio-decode-cache.d.ts","sourceRoot":"","sources":["../../src/room-audio/room-audio-decode-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,gDAAgD;AAChD,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,gGAAgG;AAChG,eAAO,MAAM,gCAAgC,QAAoB,CAAC;AAQlE,qDAAqD;AACrD,qBAAa,oBAAoB;IAQ7B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAR7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IAEtD;;;OAGG;gBAEgB,UAAU,GAAE,MAAqC,EACjD,UAAU,GAAE,MAAyC;IAGxE,gDAAgD;IAChD,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;;OAGG;IACI,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAwBnF,yBAAyB;IAClB,KAAK,IAAI,IAAI;IAIpB,4FAA4F;IAC5F,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,YAAY;CAOrB"}

package/dist/room-audio/room-audio-decode-cache.js

@@ -0,0 +1,75 @@
+/**
+ * @fileoverview {@link RoomAudioDecodeCache} — a small LRU of ready-to-play PCM keyed by source (an `MJ: Files` id or
+ * a URL), so every caller placed on hold in the same queue does not re-download and re-decode the same file.
+ *
+ * It caches the in-flight PROMISE, so ten callers arriving at once share one download. A failed load is evicted so
+ * the next caller retries. Bounded both by entry count and by total samples held.
+ *
+ * @module @memberjunction/livekit-room-server
+ */
+/** Default maximum number of cached sources. */
+export const DEFAULT_DECODE_CACHE_ENTRIES = 8;
+/** Default maximum total samples held across all entries (128 Mi samples = 256 MB of PCM16). */
+export const DEFAULT_DECODE_CACHE_MAX_SAMPLES = 128 * 1024 * 1024;
+/** A bounded, promise-sharing LRU of decoded PCM. */
+export class RoomAudioDecodeCache {
+    /**
+     * @param maxEntries Maximum number of cached sources.
+     * @param maxSamples Maximum total samples held across all resolved entries.
+     */
+    constructor(maxEntries = DEFAULT_DECODE_CACHE_ENTRIES, maxSamples = DEFAULT_DECODE_CACHE_MAX_SAMPLES) {
+        this.maxEntries = maxEntries;
+        this.maxSamples = maxSamples;
+        this.slots = new Map();
+    }
+    /** How many sources are cached (or loading). */
+    get Size() {
+        return this.slots.size;
+    }
+    /**
+     * Returns the cached PCM for `key`, or runs `load` once and caches its result. Concurrent callers for the same key
+     * share one load. A rejected load is removed so the next call retries.
+     */
+    GetOrLoad(key, load) {
+        const existing = this.slots.get(key);
+        if (existing) {
+            this.slots.delete(key); // re-insert: Map order is the recency order
+            this.slots.set(key, existing);
+            return existing.Load;
+        }
+        const slot = { Load: load(), Samples: 0 };
+        this.slots.set(key, slot);
+        this.evictOverflow();
+        slot.Load.then((pcm) => {
+            slot.Samples = pcm.length;
+            this.evictOverflow();
+        }, () => {
+            if (this.slots.get(key) === slot) {
+                this.slots.delete(key); // the caller sees the rejection; the cache just forgets it
+            }
+        });
+        return slot.Load;
+    }
+    /** Empties the cache. */
+    Clear() {
+        this.slots.clear();
+    }
+    /** Drops least-recently-used entries until both bounds hold (never the most recent one). */
+    evictOverflow() {
+        while (this.slots.size > 1 && (this.slots.size > this.maxEntries || this.totalSamples() > this.maxSamples)) {
+            const oldest = this.slots.keys().next().value;
+            if (oldest === undefined) {
+                return;
+            }
+            this.slots.delete(oldest);
+        }
+    }
+    totalSamples() {
+        let total = 0;
+        for (const slot of this.slots.values()) {
+            total += slot.Samples;
+        }
+        return total;
+    }
+}
+//# sourceMappingURL=room-audio-decode-cache.js.map

package/dist/room-audio/room-audio-decode-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-audio-decode-cache.js","sourceRoot":"","sources":["../../src/room-audio/room-audio-decode-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,gDAAgD;AAChD,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAE9C,gGAAgG;AAChG,MAAM,CAAC,MAAM,gCAAgC,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAQlE,qDAAqD;AACrD,MAAM,OAAO,oBAAoB;IAG/B;;;OAGG;IACH,YACmB,aAAqB,4BAA4B,EACjD,aAAqB,gCAAgC;QADrD,eAAU,GAAV,UAAU,CAAuC;QACjD,eAAU,GAAV,UAAU,CAA2C;QARvD,UAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;IASnD,CAAC;IAEJ,gDAAgD;IAChD,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED;;;OAGG;IACI,SAAS,CAAC,GAAW,EAAE,IAA+B;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,4CAA4C;YACpE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YAC9B,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QACD,MAAM,IAAI,GAAc,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,IAAI,CACZ,CAAC,GAAG,EAAE,EAAE;YACN,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC;YAC1B,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,CAAC,EACD,GAAG,EAAE;YACH,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;gBACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,2DAA2D;YACrF,CAAC;QACH,CAAC,CACF,CAAC;QACF,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,yBAAyB;IAClB,KAAK;QACV,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,4FAA4F;IACpF,aAAa;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3G,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC9C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO;YACT,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAEO,YAAY;QAClB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC;QACxB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/room-audio/room-audio-player.d.ts

@@ -0,0 +1,178 @@
+/**
+ * @fileoverview {@link RoomAudioPlayer} — joins a LiveKit room as a small publish-only bot and plays audio into it:
+ * contact-center hold music, with spoken announcements ducked over the top ("you are caller number three").
+ *
+ * The audio comes from an `MJ: Files` row, an https URL, raw PCM, or the built-in comfort tone. It is decoded once
+ * (WAV or MP3), resampled to {@link ROOM_AUDIO_SAMPLE_RATE}, cached by source, and paced into the room in 20 ms
+ * frames by a {@link PcmFramePump}. Each playback is a {@link RoomAudioHandle} the caller pauses, resumes, announces
+ * through and stops; the player keeps a registry so a room's playbacks can be found and stopped together (the
+ * `room_finished` webhook does this), and a playback whose bot is disconnected by the server removes itself.
+ *
+ * It reuses the agent bridge's plumbing rather than its own: bot tokens from {@link LiveKitTokenService}, the native
+ * room client through `@memberjunction/ai-bridge-livekit`'s module loader at the same specifier the agent coordinator
+ * resolves, and the PCM16 resampler from `@memberjunction/ai-bridge-base`.
+ *
+ * @module @memberjunction/livekit-room-server
+ */
+import { BaseSingleton } from '@memberjunction/global';
+import { type IMetadataProvider, type UserInfo } from '@memberjunction/core';
+import { type NativeModuleLoader } from '@memberjunction/ai-bridge-livekit';
+import { LiveKitTokenService } from '../livekit-token-service.js';
+import { type PumpClock } from './pcm-frame-pump.js';
+import { type RoomAudioFileReader, type RoomAudioUrlFetcher } from './room-audio-sources.js';
+import type { IRoomSpeechSynthesizer } from './room-speech-synthesizer.js';
+/** The rate the player publishes at (Hz). Music sounds noticeably duller at the 24 kHz the agent voice uses. */
+export declare const ROOM_AUDIO_SAMPLE_RATE = 48000;
+/** What to play: an `MJ: Files` row, an https URL, raw mono PCM16, or the built-in comfort tone. */
+export type RoomAudioSource = {
+    Kind: 'File';
+    FileID: string;
+} | {
+    Kind: 'Url';
+    Url: string;
+} | {
+    Kind: 'Pcm';
+    Pcm: Int16Array;
+    SampleRate: number;
+} | {
+    Kind: 'ComfortTone';
+};
+/** Parameters for {@link RoomAudioPlayer.Start}. */
+export interface StartRoomAudioParams {
+    /** The LiveKit room to play into. */
+    RoomName: string;
+    /** What to play. */
+    Source: RoomAudioSource;
+    /** Loop the audio until stopped. Default `true`; when `false` the bot leaves the room once the audio ends. */
+    Loop?: boolean;
+    /** The bot's display name in the room. Default `'On hold'`. */
+    DisplayName?: string;
+    /** The bot's participant identity. Default `hold-<playback id>`. */
+    Identity?: string;
+    /** The user the file load (and any announcement synthesis) runs as. */
+    ContextUser: UserInfo;
+    /** The metadata provider for the file load. Default: the global provider. */
+    Provider?: IMetadataProvider;
+}
+/**
+ * Why a playback ended, as reported by {@link RoomAudioHandle.Ended}:
+ * - `Completed`: non-looping audio played to its end (every frame went to the room).
+ * - `Stopped`: {@link RoomAudioHandle.Stop} was called (or {@link RoomAudioPlayer.StopAllInRoom}).
+ * - `Failed`: the bot's audio sink failed mid-playback, so the audio was cut short.
+ * - `Disconnected`: the server dropped the bot (room closed, participant removed) before the audio ended.
+ */
+export type RoomAudioEndReason = 'Completed' | 'Stopped' | 'Failed' | 'Disconnected';
+/** An announcement: text to speak through the speech synthesizer, or ready-made mono PCM16. */
+export type RoomAudioClip = {
+    Text: string;
+} | {
+    Pcm: Int16Array;
+    SampleRate: number;
+};
+/** A live playback in one room. */
+export interface RoomAudioHandle {
+    /** This playback's id (also the default identity suffix of its bot). */
+    readonly PlaybackID: string;
+    /** The room it plays into. */
+    readonly RoomName: string;
+    /** True while audio is being sent (false once paused or stopped). */
+    readonly IsPlaying: boolean;
+    /** Why the playback ended, or `null` while it is still live. */
+    readonly EndReason: RoomAudioEndReason | null;
+    /**
+     * Resolves once the playback has ended and its bot has left the room, with the reason. Only `Completed` means the
+     * whole clip reached the room — use it to gate anything that must follow a full play, e.g. starting a recording
+     * only after a recording disclosure has been heard. A looping playback never completes on its own; it resolves
+     * `Stopped` when stopped. The first reason wins. Never rejects.
+     */
+    readonly Ended: Promise<RoomAudioEndReason>;
+    /**
+     * Plays a clip over the music, ducking the music while it plays. Resolves `true` once the clip has been sent in
+     * full; `false` when it could not be played (no speech synthesizer installed, synthesis failed, or the playback
+     * stopped first). Never rejects.
+     */
+    Announce(clip: RoomAudioClip): Promise<boolean>;
+    /** Stops sending audio, keeping the position. */
+    Pause(): void;
+    /** Continues after {@link Pause}. */
+    Resume(): void;
+    /** Stops playback and disconnects the bot. Idempotent; never rejects. */
+    Stop(): Promise<void>;
+}
+/** The part of {@link LiveKitTokenService} the player uses — a seam for tests. */
+export type RoomAudioTokenMinter = Pick<LiveKitTokenService, 'MintToken'>;
+/**
+ * Plays audio into LiveKit rooms. A process-wide singleton so the playback registry (and the `room_finished` cleanup
+ * that reads it) is shared by every caller.
+ */
+export declare class RoomAudioPlayer extends BaseSingleton<RoomAudioPlayer> {
+    private readonly active;
+    private readonly decodeCache;
+    private tokenMinter;
+    private loadNativeModule;
+    private nativeModuleSpecifierOverride?;
+    private fileReader;
+    private urlFetcher;
+    private clock;
+    private speechSynthesizer?;
+    private warnedNoSynthesizer;
+    private comfortTone?;
+    /** BaseSingleton requires a protected constructor. */
+    protected constructor();
+    /** The process-wide player. */
+    static get Instance(): RoomAudioPlayer;
+    /**
+     * Installs the text-to-speech used by {@link RoomAudioHandle.Announce} with `{ Text }` — e.g. an
+     * `MJRoomSpeechSynthesizer`. None is installed by default (a voice is vendor-specific); without one a text
+     * announcement returns `false` and the player logs the omission once.
+     *
+     * @param synthesizer The synthesizer, or `undefined` to remove it.
+     */
+    SetSpeechSynthesizer(synthesizer: IRoomSpeechSynthesizer | undefined): void;
+    /** Overrides where bot tokens come from (tests; a host with its own credentials). */
+    SetTokenService(minter: RoomAudioTokenMinter): void;
+    /** Overrides the native room-module loader (tests inject a fake module). */
+    SetNativeModuleLoader(loader: NativeModuleLoader): void;
+    /** Overrides the native room-module specifier; `undefined` returns to `LIVEKIT_NATIVE_MODULE` / the default. */
+    SetNativeModuleSpecifier(specifier: string | undefined): void;
+    /** Overrides how `MJ: Files` bytes are read (tests). */
+    SetFileReader(reader: RoomAudioFileReader): void;
+    /** Overrides how URLs are fetched (tests). */
+    SetUrlFetcher(fetcher: RoomAudioUrlFetcher): void;
+    /** Overrides the pacing clock (tests). */
+    SetClock(clock: PumpClock): void;
+    /** Forgets every cached decode (e.g. after a hold file is replaced under the same id). */
+    ClearDecodeCache(): void;
+    /**
+     * Starts playing `params.Source` into `params.RoomName`: loads and decodes it (cached by source), joins the room as
+     * a publish-only bot, and paces the audio in.
+     *
+     * @returns The live playback.
+     * @throws {Error} when the source cannot be loaded or decoded, LiveKit is not configured, or the bot cannot join.
+     */
+    Start(params: StartRoomAudioParams): Promise<RoomAudioHandle>;
+    /** The live playbacks in a room (room names compare case-insensitively). */
+    GetActive(roomName: string): RoomAudioHandle[];
+    /**
+     * Stops every playback in a room. Never throws.
+     *
+     * @returns How many playbacks were stopped.
+     */
+    StopAllInRoom(roomName: string): Promise<number>;
+    /** Resolves the source to mono PCM16 at {@link ROOM_AUDIO_SAMPLE_RATE}, through the decode cache where it can. */
+    private resolvePcm;
+    private decodeContent;
+    /** Joins the room as the playback's bot, registers the playback, and starts the pump. */
+    private joinAndPlay;
+    /** A publish-only bot token: it never needs to hear the room, and it carries no data channel. */
+    private mintBotToken;
+    /** Connects the bot; on failure always releases the client before rethrowing. */
+    private connectClient;
+    private createPump;
+    private playbackOwner;
+    private deregister;
+    /** The server dropped the bot (room closed, participant removed): stop and forget the playback. */
+    private handleServerDisconnect;
+    private synthesize;
+}
+//# sourceMappingURL=room-audio-player.d.ts.map

package/dist/room-audio/room-audio-player.d.ts.map

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