fix: pass queueSizeMs from RoomOutputOptions through to AudioSource (#1207)

Co-authored-by: cxyangs <27497414+cxyangs@users.noreply.github.com>

Author: cxyangs

.changeset/pass-queueSizeMs-to-audiosource.md

@@ -0,0 +1,5 @@
+---
+"@livekit/agents": patch
+---
+
+fix: pass queueSizeMs from RoomOutputOptions through to AudioSource

agents/src/ipc/proc_pool.test.ts

@@ -1,7 +1,7 @@
 // SPDX-FileCopyrightText: 2026 LiveKit, Inc.
 //
 // SPDX-License-Identifier: Apache-2.0
-import { Throws } from '@livekit/throws-transformer/throws';
+import type { Throws } from '@livekit/throws-transformer/throws';
 import { describe, expect, it, vi } from 'vitest';
 import type { RunningJobInfo } from '../job.js';
 import { type JobExecutor, JobStatus } from './job_executor.js';

agents/src/voice/room_io/_output.ts

@@ -333,7 +333,11 @@ export class ParticipantAudioOutput extends AudioOutput {
     super(options.sampleRate, undefined, { pause: true });
     this.room = room;
     this.options = options;
-    this.audioSource = new AudioSource(options.sampleRate, options.numChannels);
+    this.audioSource = new AudioSource(
+      options.sampleRate,
+      options.numChannels,
+      options.queueSizeMs,
+    );
   }
 
   get subscribed(): boolean {

agents/src/voice/room_io/room_io.ts

@@ -95,6 +95,12 @@ export interface RoomOutputOptions {
   /** The name of the audio track to publish. If not provided, default to "roomio_audio".
    */
   audioPublishOptions: TrackPublishOptions;
+  /** Maximum queue size in milliseconds for the audio output buffer.
+    When TTS generates audio faster than real-time, a larger queue prevents
+    early frames from being discarded by the ring buffer.
+    Defaults to the AudioSource internal default (1000ms).
+  */
+  queueSizeMs?: number;
 }
 
 const DEFAULT_ROOM_INPUT_OPTIONS: RoomInputOptions = {
@@ -462,6 +468,7 @@ export class RoomIO {
         sampleRate: this.outputOptions.audioSampleRate,
         numChannels: this.outputOptions.audioNumChannels,
         trackPublishOptions: this.outputOptions.audioPublishOptions,
+        queueSizeMs: this.outputOptions.queueSizeMs,
       });
     }
     if (this.outputOptions.transcriptionEnabled) {