QueueOverflowEvent

Defined in: src/core/events/types.ts:823

Emitted when an AudioBufferQueue drops chunks due to overflow.

Remarks

This event fires each time the queue drops one or more chunks because it has reached its configured maxSize and the overflow strategy is 'drop-oldest' or 'drop-newest'. The event includes the queue name, the number of chunks dropped in this overflow instance, and the current buffer size after the drop.

Monitoring this event helps detect situations where the STT or output consumer is too slow to keep up with the producer, potentially causing audio gaps.

Example

agent.on('queue.overflow', (event) => {
  console.warn(
    `Queue "${event.queueName}" overflowed: ` +
    `${event.droppedChunks} chunks dropped, ${event.currentSize} remaining`
  );
});

See

• QueueStatsEvent for periodic pipeline health snapshots
• QueueEvent for all queue event types

Extends

• BaseEvent

Properties