QueueStatsEvent

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

Emitted when queue statistics are requested via getQueueStats().

Remarks

This event provides a point-in-time snapshot of an AudioBufferQueue’s health metrics, including current size, total throughput counters, and the age of the oldest buffered chunk. One event is emitted per queue (input and output) each time getQueueStats() is called.

Use this event for dashboards, logging, or alerting on pipeline health.

Example

agent.on('queue.stats', (event) => {
  console.log(
    `Queue "${event.queueName}": ${event.size} buffered, ` +
    `${event.totalEnqueued} in, ${event.totalDequeued} out, ` +
    `oldest: ${event.oldestChunkAge}ms`
  );
});

// Trigger stats emission
const stats = agent.getQueueStats();

See

• QueueOverflowEvent for overflow-specific alerts
• QueueEvent for all queue event types

Extends

• BaseEvent

Properties