@absolutejs/voice 0.0.22-beta.630 → 0.0.22-beta.631

package/dist/client/htmxBootstrap.js

@@ -1721,6 +1721,7 @@ var createTimeStretcher = () => {
 };
 
 // src/client/audioPlayer.ts
+var activeAudioPlayers = new Set;
 var DEFAULT_LOOKAHEAD_MS = 15;
 var DEFAULT_VOLUME = 1;
 var DEFAULT_PLAYBACK_RATE = 1;
@@ -1729,6 +1730,7 @@ var MAX_PLAYBACK_RATE = 2;
 var STRETCH_BYPASS_EPSILON = 0.01;
 var ANALYSER_FFT_SIZE = 256;
 var PCM_BYTE_MIDPOINT = 128;
+var GAP_EPSILON_S = 0.03;
 var createInitialState3 = () => ({
   activeSourceCount: 0,
   error: null,
@@ -1800,6 +1802,36 @@ var createVoiceAudioPlayer = (source, options = {}) => {
   let interruptPromise = null;
   let resolveInterruptPromise = null;
   let interruptFallbackTimer = null;
+  let concurrencyCounted = false;
+  let observedPeakConcurrency = 0;
+  let scheduledDurationMs = 0;
+  let gapCount = 0;
+  let totalGapMs = 0;
+  let maxGapMs = 0;
+  let errorCount = 0;
+  let hasScheduledAnyChunk = false;
+  const sampleConcurrency = () => {
+    if (activeAudioPlayers.size > observedPeakConcurrency) {
+      observedPeakConcurrency = activeAudioPlayers.size;
+    }
+  };
+  const markPlayerActive = () => {
+    if (concurrencyCounted) {
+      return;
+    }
+    concurrencyCounted = true;
+    activeAudioPlayers.add(sampleConcurrency);
+    for (const sample of activeAudioPlayers) {
+      sample();
+    }
+  };
+  const markPlayerInactive = () => {
+    if (!concurrencyCounted) {
+      return;
+    }
+    concurrencyCounted = false;
+    activeAudioPlayers.delete(sampleConcurrency);
+  };
   const notify = () => {
     for (const subscriber of subscribers) {
       subscriber();
@@ -1913,7 +1945,17 @@ var createVoiceAudioPlayer = (source, options = {}) => {
       });
       maybeResolveInterrupt();
     };
-    const startAt = Math.max(context.currentTime + lookaheadSeconds, queueEndTime);
+    const earliestStart = context.currentTime + lookaheadSeconds;
+    const startAt = Math.max(earliestStart, queueEndTime);
+    if (hasScheduledAnyChunk && earliestStart > queueEndTime + GAP_EPSILON_S) {
+      const gapMs = (earliestStart - queueEndTime) * 1000;
+      gapCount += 1;
+      totalGapMs += gapMs;
+      maxGapMs = Math.max(maxGapMs, gapMs);
+    }
+    hasScheduledAnyChunk = true;
+    scheduledDurationMs += buffer.duration / rate * 1000;
+    sampleConcurrency();
     queueEndTime = startAt + buffer.duration / rate;
     sourceNodes.add(node);
     setState({
@@ -1981,6 +2023,7 @@ var createVoiceAudioPlayer = (source, options = {}) => {
         queuedChunkCount: state.queuedChunkCount + nextChunks.length
       });
     } catch (error) {
+      errorCount += 1;
       setState({
         error: error instanceof Error ? error.message : String(error)
       });
@@ -2004,6 +2047,7 @@ var createVoiceAudioPlayer = (source, options = {}) => {
       return state.activeSourceCount;
     },
     close: async () => {
+      markPlayerInactive();
       unsubscribeSource();
       stopQueuedPlayback({ forceClear: true });
       clearInterruptTimer();
@@ -2043,6 +2087,21 @@ var createVoiceAudioPlayer = (source, options = {}) => {
       return Math.sqrt(sumSquares / analyserBuffer.length);
     },
     getSnapshot: () => state,
+    getIntegritySummary: () => {
+      const chunksReceived = source.assistantAudio.length;
+      const chunksScheduled = state.processedChunkCount;
+      return {
+        chunksReceived,
+        chunksScheduled,
+        errorCount,
+        gapCount,
+        maxConcurrentPlayers: observedPeakConcurrency,
+        maxGapMs: Math.round(maxGapMs),
+        ok: observedPeakConcurrency <= 1 && errorCount === 0 && chunksScheduled >= chunksReceived,
+        scheduledDurationMs: Math.round(scheduledDurationMs),
+        totalGapMs: Math.round(totalGapMs)
+      };
+    },
     interrupt: async () => {
       const startedAt = Date.now();
       const context = await ensureAudioContext();
@@ -2096,6 +2155,7 @@ var createVoiceAudioPlayer = (source, options = {}) => {
         return;
       }
       await audioContext.suspend();
+      markPlayerInactive();
       setState({
         activeSourceCount: sourceNodes.size,
         isActive: false,
@@ -2126,6 +2186,7 @@ var createVoiceAudioPlayer = (source, options = {}) => {
         if (context.state === "suspended") {
           await context.resume();
         }
+        markPlayerActive();
         setState({
           activeSourceCount: sourceNodes.size,
           isActive: true,
@@ -2133,6 +2194,8 @@ var createVoiceAudioPlayer = (source, options = {}) => {
         });
         await queueSync();
       } catch (error) {
+        errorCount += 1;
+        markPlayerInactive();
         setState({
           error: error instanceof Error ? error.message : String(error),
           isActive: false,

package/dist/client/index.js

@@ -528,6 +528,7 @@ var createTimeStretcher = () => {
 };
 
 // src/client/audioPlayer.ts
+var activeAudioPlayers = new Set;
 var DEFAULT_LOOKAHEAD_MS = 15;
 var DEFAULT_VOLUME = 1;
 var DEFAULT_PLAYBACK_RATE = 1;
@@ -536,6 +537,7 @@ var MAX_PLAYBACK_RATE = 2;
 var STRETCH_BYPASS_EPSILON = 0.01;
 var ANALYSER_FFT_SIZE = 256;
 var PCM_BYTE_MIDPOINT = 128;
+var GAP_EPSILON_S = 0.03;
 var createInitialState = () => ({
   activeSourceCount: 0,
   error: null,
@@ -607,6 +609,36 @@ var createVoiceAudioPlayer = (source, options = {}) => {
   let interruptPromise = null;
   let resolveInterruptPromise = null;
   let interruptFallbackTimer = null;
+  let concurrencyCounted = false;
+  let observedPeakConcurrency = 0;
+  let scheduledDurationMs = 0;
+  let gapCount = 0;
+  let totalGapMs = 0;
+  let maxGapMs = 0;
+  let errorCount = 0;
+  let hasScheduledAnyChunk = false;
+  const sampleConcurrency = () => {
+    if (activeAudioPlayers.size > observedPeakConcurrency) {
+      observedPeakConcurrency = activeAudioPlayers.size;
+    }
+  };
+  const markPlayerActive = () => {
+    if (concurrencyCounted) {
+      return;
+    }
+    concurrencyCounted = true;
+    activeAudioPlayers.add(sampleConcurrency);
+    for (const sample of activeAudioPlayers) {
+      sample();
+    }
+  };
+  const markPlayerInactive = () => {
+    if (!concurrencyCounted) {
+      return;
+    }
+    concurrencyCounted = false;
+    activeAudioPlayers.delete(sampleConcurrency);
+  };
   const notify = () => {
     for (const subscriber of subscribers) {
       subscriber();
@@ -720,7 +752,17 @@ var createVoiceAudioPlayer = (source, options = {}) => {
       });
       maybeResolveInterrupt();
     };
-    const startAt = Math.max(context.currentTime + lookaheadSeconds, queueEndTime);
+    const earliestStart = context.currentTime + lookaheadSeconds;
+    const startAt = Math.max(earliestStart, queueEndTime);
+    if (hasScheduledAnyChunk && earliestStart > queueEndTime + GAP_EPSILON_S) {
+      const gapMs = (earliestStart - queueEndTime) * 1000;
+      gapCount += 1;
+      totalGapMs += gapMs;
+      maxGapMs = Math.max(maxGapMs, gapMs);
+    }
+    hasScheduledAnyChunk = true;
+    scheduledDurationMs += buffer.duration / rate * 1000;
+    sampleConcurrency();
     queueEndTime = startAt + buffer.duration / rate;
     sourceNodes.add(node);
     setState({
@@ -788,6 +830,7 @@ var createVoiceAudioPlayer = (source, options = {}) => {
         queuedChunkCount: state.queuedChunkCount + nextChunks.length
       });
     } catch (error) {
+      errorCount += 1;
       setState({
         error: error instanceof Error ? error.message : String(error)
       });
@@ -811,6 +854,7 @@ var createVoiceAudioPlayer = (source, options = {}) => {
       return state.activeSourceCount;
     },
     close: async () => {
+      markPlayerInactive();
       unsubscribeSource();
       stopQueuedPlayback({ forceClear: true });
       clearInterruptTimer();
@@ -850,6 +894,21 @@ var createVoiceAudioPlayer = (source, options = {}) => {
       return Math.sqrt(sumSquares / analyserBuffer.length);
     },
     getSnapshot: () => state,
+    getIntegritySummary: () => {
+      const chunksReceived = source.assistantAudio.length;
+      const chunksScheduled = state.processedChunkCount;
+      return {
+        chunksReceived,
+        chunksScheduled,
+        errorCount,
+        gapCount,
+        maxConcurrentPlayers: observedPeakConcurrency,
+        maxGapMs: Math.round(maxGapMs),
+        ok: observedPeakConcurrency <= 1 && errorCount === 0 && chunksScheduled >= chunksReceived,
+        scheduledDurationMs: Math.round(scheduledDurationMs),
+        totalGapMs: Math.round(totalGapMs)
+      };
+    },
     interrupt: async () => {
       const startedAt = Date.now();
       const context = await ensureAudioContext();
@@ -903,6 +962,7 @@ var createVoiceAudioPlayer = (source, options = {}) => {
         return;
       }
       await audioContext.suspend();
+      markPlayerInactive();
       setState({
         activeSourceCount: sourceNodes.size,
         isActive: false,
@@ -933,6 +993,7 @@ var createVoiceAudioPlayer = (source, options = {}) => {
         if (context.state === "suspended") {
           await context.resume();
         }
+        markPlayerActive();
         setState({
           activeSourceCount: sourceNodes.size,
           isActive: true,
@@ -940,6 +1001,8 @@ var createVoiceAudioPlayer = (source, options = {}) => {
         });
         await queueSync();
       } catch (error) {
+        errorCount += 1;
+        markPlayerInactive();
         setState({
           error: error instanceof Error ? error.message : String(error),
           isActive: false,

package/dist/core/types.d.ts

@@ -1471,6 +1471,20 @@ export type VoiceAudioPlayerSource = {
     assistantAudio: VoiceStreamState["assistantAudio"];
     subscribe: (subscriber: () => void) => () => void;
 };
+/** Post-call playback integrity, for verifying the assistant audio actually
+ *  played cleanly (no overlap, no dropped/stalled packets) — emit it as a trace
+ *  so a garbled call is provable, not guessed. `ok` is the all-clear roll-up. */
+export type VoiceAudioIntegrity = {
+    ok: boolean;
+    chunksReceived: number;
+    chunksScheduled: number;
+    scheduledDurationMs: number;
+    gapCount: number;
+    totalGapMs: number;
+    maxGapMs: number;
+    maxConcurrentPlayers: number;
+    errorCount: number;
+};
 export type VoiceAudioPlayer = {
     close: () => Promise<void>;
     error: string | null;
@@ -1478,6 +1492,8 @@ export type VoiceAudioPlayer = {
      *  driving a visualizer from the actual voice. 0 when idle / no analyser. */
     getOutputLevel: () => number;
     getSnapshot: () => VoiceAudioPlayerState;
+    /** Post-call playback-integrity roll-up (overlap, gaps, drops). */
+    getIntegritySummary: () => VoiceAudioIntegrity;
     activeSourceCount: number;
     isActive: boolean;
     isPlaying: boolean;

package/dist/testing/index.js

@@ -1731,6 +1731,7 @@ var createTimeStretcher = () => {
 };
 
 // src/client/audioPlayer.ts
+var activeAudioPlayers = new Set;
 var DEFAULT_LOOKAHEAD_MS = 15;
 var DEFAULT_VOLUME = 1;
 var DEFAULT_PLAYBACK_RATE = 1;
@@ -1739,6 +1740,7 @@ var MAX_PLAYBACK_RATE = 2;
 var STRETCH_BYPASS_EPSILON = 0.01;
 var ANALYSER_FFT_SIZE = 256;
 var PCM_BYTE_MIDPOINT = 128;
+var GAP_EPSILON_S = 0.03;
 var createInitialState = () => ({
   activeSourceCount: 0,
   error: null,
@@ -1810,6 +1812,36 @@ var createVoiceAudioPlayer = (source, options = {}) => {
   let interruptPromise = null;
   let resolveInterruptPromise = null;
   let interruptFallbackTimer = null;
+  let concurrencyCounted = false;
+  let observedPeakConcurrency = 0;
+  let scheduledDurationMs = 0;
+  let gapCount = 0;
+  let totalGapMs = 0;
+  let maxGapMs = 0;
+  let errorCount = 0;
+  let hasScheduledAnyChunk = false;
+  const sampleConcurrency = () => {
+    if (activeAudioPlayers.size > observedPeakConcurrency) {
+      observedPeakConcurrency = activeAudioPlayers.size;
+    }
+  };
+  const markPlayerActive = () => {
+    if (concurrencyCounted) {
+      return;
+    }
+    concurrencyCounted = true;
+    activeAudioPlayers.add(sampleConcurrency);
+    for (const sample of activeAudioPlayers) {
+      sample();
+    }
+  };
+  const markPlayerInactive = () => {
+    if (!concurrencyCounted) {
+      return;
+    }
+    concurrencyCounted = false;
+    activeAudioPlayers.delete(sampleConcurrency);
+  };
   const notify = () => {
     for (const subscriber of subscribers) {
       subscriber();
@@ -1923,7 +1955,17 @@ var createVoiceAudioPlayer = (source, options = {}) => {
       });
       maybeResolveInterrupt();
     };
-    const startAt = Math.max(context.currentTime + lookaheadSeconds, queueEndTime);
+    const earliestStart = context.currentTime + lookaheadSeconds;
+    const startAt = Math.max(earliestStart, queueEndTime);
+    if (hasScheduledAnyChunk && earliestStart > queueEndTime + GAP_EPSILON_S) {
+      const gapMs = (earliestStart - queueEndTime) * 1000;
+      gapCount += 1;
+      totalGapMs += gapMs;
+      maxGapMs = Math.max(maxGapMs, gapMs);
+    }
+    hasScheduledAnyChunk = true;
+    scheduledDurationMs += buffer.duration / rate * 1000;
+    sampleConcurrency();
     queueEndTime = startAt + buffer.duration / rate;
     sourceNodes.add(node);
     setState({
@@ -1991,6 +2033,7 @@ var createVoiceAudioPlayer = (source, options = {}) => {
         queuedChunkCount: state.queuedChunkCount + nextChunks.length
       });
     } catch (error) {
+      errorCount += 1;
       setState({
         error: error instanceof Error ? error.message : String(error)
       });
@@ -2014,6 +2057,7 @@ var createVoiceAudioPlayer = (source, options = {}) => {
       return state.activeSourceCount;
     },
     close: async () => {
+      markPlayerInactive();
       unsubscribeSource();
       stopQueuedPlayback({ forceClear: true });
       clearInterruptTimer();
@@ -2053,6 +2097,21 @@ var createVoiceAudioPlayer = (source, options = {}) => {
       return Math.sqrt(sumSquares / analyserBuffer.length);
     },
     getSnapshot: () => state,
+    getIntegritySummary: () => {
+      const chunksReceived = source.assistantAudio.length;
+      const chunksScheduled = state.processedChunkCount;
+      return {
+        chunksReceived,
+        chunksScheduled,
+        errorCount,
+        gapCount,
+        maxConcurrentPlayers: observedPeakConcurrency,
+        maxGapMs: Math.round(maxGapMs),
+        ok: observedPeakConcurrency <= 1 && errorCount === 0 && chunksScheduled >= chunksReceived,
+        scheduledDurationMs: Math.round(scheduledDurationMs),
+        totalGapMs: Math.round(totalGapMs)
+      };
+    },
     interrupt: async () => {
       const startedAt = Date.now();
       const context = await ensureAudioContext();
@@ -2106,6 +2165,7 @@ var createVoiceAudioPlayer = (source, options = {}) => {
         return;
       }
       await audioContext.suspend();
+      markPlayerInactive();
       setState({
         activeSourceCount: sourceNodes.size,
         isActive: false,
@@ -2136,6 +2196,7 @@ var createVoiceAudioPlayer = (source, options = {}) => {
         if (context.state === "suspended") {
           await context.resume();
         }
+        markPlayerActive();
         setState({
           activeSourceCount: sourceNodes.size,
           isActive: true,
@@ -2143,6 +2204,8 @@ var createVoiceAudioPlayer = (source, options = {}) => {
         });
         await queueSync();
       } catch (error) {
+        errorCount += 1;
+        markPlayerInactive();
         setState({
           error: error instanceof Error ? error.message : String(error),
           isActive: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/voice",
-  "version": "0.0.22-beta.630",
+  "version": "0.0.22-beta.631",
   "description": "Voice primitives and Elysia plugin for AbsoluteJS",
   "repository": {
     "type": "git",