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

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

@@ -522,6 +522,17 @@ export type VoiceSessionHandle<TContext = unknown, TSession extends VoiceSession
         transferMode?: "cold" | "warm";
     }) => Promise<void>;
     close: (reason?: string) => Promise<void>;
+    /**
+     * Caller-driven in-call pause: the session stays LIVE (socket, state,
+     * transcript) but every idle/silence watchdog is suspended and turn
+     * processing is skipped, so a paused caller is never nudged or hung up on.
+     * Past `pause.maxMs` (default 10 min) the session closes gracefully with
+     * reason "pause-timeout" — completed turns stay durably persisted, so the
+     * host's normal draft/resume path takes over.
+     */
+    pause: () => Promise<void>;
+    /** Lift a caller-driven pause: watchdogs re-arm and turns process again. */
+    resume: () => Promise<void>;
     snapshot: () => Promise<TSession>;
     /**
      * Mutate the live turn-detection config for this session — useful when a
@@ -1016,6 +1027,12 @@ export type CreateVoiceSessionOptions<TContext = unknown, TSession extends Voice
         }) => string | Promise<string>);
         maxReprompts?: number;
     };
+    /** Caller-driven in-call pause (VoiceSessionHandle.pause/resume). `maxMs`
+     *  bounds how long a session may sit paused before it closes gracefully
+     *  with reason "pause-timeout" (default 10 minutes). */
+    pause?: {
+        maxMs?: number;
+    };
     stt?: STTAdapter;
     realtime?: RealtimeAdapter;
     realtimeInputFormat?: AudioFormat;
@@ -1161,7 +1178,7 @@ export type VoiceClientCloseMessage = {
 };
 export type VoiceClientCallControlMessage = {
     type: "call_control";
-    action: "complete" | "escalate" | "no-answer" | "transfer" | "voicemail";
+    action: "complete" | "escalate" | "no-answer" | "pause" | "resume" | "transfer" | "voicemail";
     metadata?: Record<string, unknown>;
     reason?: string;
     target?: string;
@@ -1471,6 +1488,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 +1509,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/index.js

@@ -4368,6 +4368,9 @@ var createVoiceSession = (options) => {
     if (callSilenceTimeoutMs === undefined || callSilenceFired) {
       return;
     }
+    if (callerPaused) {
+      return;
+    }
     clearCallSilenceWatchdog();
     callSilenceWatchdog = setTimeout(fireCallSilenceTimeout, callSilenceTimeoutMs);
   };
@@ -4413,6 +4416,9 @@ var createVoiceSession = (options) => {
     if (stuckCloseAfterMs === undefined || stuckCloseFired) {
       return;
     }
+    if (callerPaused) {
+      return;
+    }
     clearStuckCloseWatchdog();
     stuckCloseWatchdog = setTimeout(fireStuckClose, stuckCloseAfterMs);
   };
@@ -4435,6 +4441,9 @@ var createVoiceSession = (options) => {
       idleRepromptsUsed = 0;
     }
     clearIdleRepromptWatchdog();
+    if (callerPaused) {
+      return;
+    }
     if (idleRepromptsUsed >= idleRepromptMax) {
       return;
     }
@@ -4455,6 +4464,60 @@ var createVoiceSession = (options) => {
       });
     }, idleRepromptAfterMs);
   };
+  const PAUSE_MAX_MS_DEFAULT = 600000;
+  const pauseMaxMs = options.pause?.maxMs && options.pause.maxMs > 0 ? options.pause.maxMs : PAUSE_MAX_MS_DEFAULT;
+  let callerPaused = false;
+  let pauseTimeout = null;
+  const clearPauseTimeout = () => {
+    if (pauseTimeout) {
+      clearTimeout(pauseTimeout);
+      pauseTimeout = null;
+    }
+  };
+  const pauseInternal = async () => {
+    if (callerPaused) {
+      return;
+    }
+    const snapshot = await readSession();
+    if (snapshot.status === "completed" || snapshot.status === "failed" || snapshot.call?.endedAt) {
+      return;
+    }
+    callerPaused = true;
+    clearCallSilenceWatchdog();
+    clearStuckCloseWatchdog();
+    clearIdleRepromptWatchdog();
+    clearPauseTimeout();
+    pauseTimeout = setTimeout(() => {
+      pauseTimeout = null;
+      api.close("pause-timeout");
+    }, pauseMaxMs);
+    await appendTrace({
+      payload: {
+        action: "call.paused",
+        maxMs: pauseMaxMs
+      },
+      session: snapshot,
+      type: "call.lifecycle"
+    });
+  };
+  const resumeInternal = async () => {
+    if (!callerPaused) {
+      return;
+    }
+    callerPaused = false;
+    clearPauseTimeout();
+    kickCallSilenceWatchdog();
+    kickStuckCloseWatchdog();
+    kickIdleRepromptWatchdog(true);
+    const snapshot = await readSession();
+    await appendTrace({
+      payload: {
+        action: "call.resumed"
+      },
+      session: snapshot,
+      type: "call.lifecycle"
+    });
+  };
   const recordingConfig = options.recording;
   const recordingChannels = new Set(recordingConfig?.channels ?? ["assistant", "user"]);
   const recordingMaxBytes = recordingConfig?.maxBytesPerChannel ?? 50 * 1024 * 1024;
@@ -4962,6 +5025,7 @@ var createVoiceSession = (options) => {
     clearCallSilenceWatchdog();
     clearStuckCloseWatchdog();
     clearIdleRepromptWatchdog();
+    clearPauseTimeout();
     clearAmdEvaluationTimer();
     await closeTTSSession("failed");
     await closeAdapter("failed");
@@ -5073,6 +5137,7 @@ var createVoiceSession = (options) => {
     clearCallSilenceWatchdog();
     clearStuckCloseWatchdog();
     clearIdleRepromptWatchdog();
+    clearPauseTimeout();
     clearAmdEvaluationTimer();
     await closeTTSSession("complete");
     await closeAdapter("complete");
@@ -6033,6 +6098,19 @@ var createVoiceSession = (options) => {
     }
     kickStuckCloseWatchdog();
     kickIdleRepromptWatchdog(true);
+    if (callerPaused) {
+      await appendTrace({
+        payload: {
+          action: "turn.skipped",
+          reason: "caller-paused",
+          status: "skipped"
+        },
+        session,
+        turnId: turn.id,
+        type: "call.lifecycle"
+      });
+      return;
+    }
     const liveOpsControl = await options.liveOps?.getControl(options.id);
     if (liveOpsControl?.assistantPaused || liveOpsControl?.operatorTakeover) {
       await appendTrace({
@@ -6883,6 +6961,7 @@ var createVoiceSession = (options) => {
     clearCallSilenceWatchdog();
     clearStuckCloseWatchdog();
     clearIdleRepromptWatchdog();
+    clearPauseTimeout();
     clearAmdEvaluationTimer();
     if (options.noiseSuppressor?.close) {
       try {
@@ -6948,9 +7027,15 @@ var createVoiceSession = (options) => {
     markVoicemail: async (input) => runSerial("api.markVoicemail", async () => {
       await markVoicemailInternal(input);
     }),
+    pause: async () => runSerial("api.pause", async () => {
+      await pauseInternal();
+    }),
     receiveAudio: async (audio) => runSerial("api.receiveAudio", async () => {
       await receiveAudioInternal(audio);
     }),
+    resume: async () => runSerial("api.resume", async () => {
+      await resumeInternal();
+    }),
     snapshot: async () => runSerial("api.snapshot", async () => readSession()),
     transfer: async (input) => runSerial("api.transfer", async () => {
       await transferInternal(input);
@@ -39724,7 +39809,7 @@ var isVoiceClientMessage = (value) => {
       if (!("action" in value)) {
         return false;
       }
-      if (value.action !== "complete" && value.action !== "escalate" && value.action !== "no-answer" && value.action !== "transfer" && value.action !== "voicemail") {
+      if (value.action !== "complete" && value.action !== "escalate" && value.action !== "no-answer" && value.action !== "pause" && value.action !== "resume" && value.action !== "transfer" && value.action !== "voicemail") {
         return false;
       }
       return (!("metadata" in value) || value.metadata === undefined || value.metadata !== null && typeof value.metadata === "object") && (!("reason" in value) || value.reason === undefined || typeof value.reason === "string") && (!("target" in value) || value.target === undefined || typeof value.target === "string");
@@ -40313,6 +40398,12 @@ var voice = (config) => {
           if (message.action === "complete") {
             await current.complete();
           }
+          if (message.action === "pause") {
+            await current.pause();
+          }
+          if (message.action === "resume") {
+            await current.resume();
+          }
         }
         if (message.type === "start" && message.sessionId && message.sessionId !== sessionState.sessionId) {
           const currentSession = runtime.activeSessions.get(sessionState.sessionId);
@@ -44373,7 +44464,9 @@ var createContractApi = (session) => ({
   fail: async () => {},
   markNoAnswer: async () => {},
   markVoicemail: async () => {},
+  pause: async () => {},
   receiveAudio: async () => {},
+  resume: async () => {},
   setTurnDetection: async () => ({
     silenceMs: 0,
     speechThreshold: 0,

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,
@@ -6688,6 +6751,9 @@ var createVoiceSession = (options) => {
     if (callSilenceTimeoutMs === undefined || callSilenceFired) {
       return;
     }
+    if (callerPaused) {
+      return;
+    }
     clearCallSilenceWatchdog();
     callSilenceWatchdog = setTimeout(fireCallSilenceTimeout, callSilenceTimeoutMs);
   };
@@ -6733,6 +6799,9 @@ var createVoiceSession = (options) => {
     if (stuckCloseAfterMs === undefined || stuckCloseFired) {
       return;
     }
+    if (callerPaused) {
+      return;
+    }
     clearStuckCloseWatchdog();
     stuckCloseWatchdog = setTimeout(fireStuckClose, stuckCloseAfterMs);
   };
@@ -6755,6 +6824,9 @@ var createVoiceSession = (options) => {
       idleRepromptsUsed = 0;
     }
     clearIdleRepromptWatchdog();
+    if (callerPaused) {
+      return;
+    }
     if (idleRepromptsUsed >= idleRepromptMax) {
       return;
     }
@@ -6775,6 +6847,60 @@ var createVoiceSession = (options) => {
       });
     }, idleRepromptAfterMs);
   };
+  const PAUSE_MAX_MS_DEFAULT = 600000;
+  const pauseMaxMs = options.pause?.maxMs && options.pause.maxMs > 0 ? options.pause.maxMs : PAUSE_MAX_MS_DEFAULT;
+  let callerPaused = false;
+  let pauseTimeout = null;
+  const clearPauseTimeout = () => {
+    if (pauseTimeout) {
+      clearTimeout(pauseTimeout);
+      pauseTimeout = null;
+    }
+  };
+  const pauseInternal = async () => {
+    if (callerPaused) {
+      return;
+    }
+    const snapshot = await readSession();
+    if (snapshot.status === "completed" || snapshot.status === "failed" || snapshot.call?.endedAt) {
+      return;
+    }
+    callerPaused = true;
+    clearCallSilenceWatchdog();
+    clearStuckCloseWatchdog();
+    clearIdleRepromptWatchdog();
+    clearPauseTimeout();
+    pauseTimeout = setTimeout(() => {
+      pauseTimeout = null;
+      api.close("pause-timeout");
+    }, pauseMaxMs);
+    await appendTrace({
+      payload: {
+        action: "call.paused",
+        maxMs: pauseMaxMs
+      },
+      session: snapshot,
+      type: "call.lifecycle"
+    });
+  };
+  const resumeInternal = async () => {
+    if (!callerPaused) {
+      return;
+    }
+    callerPaused = false;
+    clearPauseTimeout();
+    kickCallSilenceWatchdog();
+    kickStuckCloseWatchdog();
+    kickIdleRepromptWatchdog(true);
+    const snapshot = await readSession();
+    await appendTrace({
+      payload: {
+        action: "call.resumed"
+      },
+      session: snapshot,
+      type: "call.lifecycle"
+    });
+  };
   const recordingConfig = options.recording;
   const recordingChannels = new Set(recordingConfig?.channels ?? ["assistant", "user"]);
   const recordingMaxBytes = recordingConfig?.maxBytesPerChannel ?? 50 * 1024 * 1024;
@@ -7282,6 +7408,7 @@ var createVoiceSession = (options) => {
     clearCallSilenceWatchdog();
     clearStuckCloseWatchdog();
     clearIdleRepromptWatchdog();
+    clearPauseTimeout();
     clearAmdEvaluationTimer();
     await closeTTSSession("failed");
     await closeAdapter("failed");
@@ -7393,6 +7520,7 @@ var createVoiceSession = (options) => {
     clearCallSilenceWatchdog();
     clearStuckCloseWatchdog();
     clearIdleRepromptWatchdog();
+    clearPauseTimeout();
     clearAmdEvaluationTimer();
     await closeTTSSession("complete");
     await closeAdapter("complete");
@@ -8353,6 +8481,19 @@ var createVoiceSession = (options) => {
     }
     kickStuckCloseWatchdog();
     kickIdleRepromptWatchdog(true);
+    if (callerPaused) {
+      await appendTrace({
+        payload: {
+          action: "turn.skipped",
+          reason: "caller-paused",
+          status: "skipped"
+        },
+        session,
+        turnId: turn.id,
+        type: "call.lifecycle"
+      });
+      return;
+    }
     const liveOpsControl = await options.liveOps?.getControl(options.id);
     if (liveOpsControl?.assistantPaused || liveOpsControl?.operatorTakeover) {
       await appendTrace({
@@ -9203,6 +9344,7 @@ var createVoiceSession = (options) => {
     clearCallSilenceWatchdog();
     clearStuckCloseWatchdog();
     clearIdleRepromptWatchdog();
+    clearPauseTimeout();
     clearAmdEvaluationTimer();
     if (options.noiseSuppressor?.close) {
       try {
@@ -9268,9 +9410,15 @@ var createVoiceSession = (options) => {
     markVoicemail: async (input) => runSerial("api.markVoicemail", async () => {
       await markVoicemailInternal(input);
     }),
+    pause: async () => runSerial("api.pause", async () => {
+      await pauseInternal();
+    }),
     receiveAudio: async (audio) => runSerial("api.receiveAudio", async () => {
       await receiveAudioInternal(audio);
     }),
+    resume: async () => runSerial("api.resume", async () => {
+      await resumeInternal();
+    }),
     snapshot: async () => runSerial("api.snapshot", async () => readSession()),
     transfer: async (input) => runSerial("api.transfer", async () => {
       await transferInternal(input);

package/package.json

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