@absolutejs/voice 0.0.22-beta.58 → 0.0.22-beta.581

package/dist/client/htmxBootstrap.js

@@ -1,3 +1,6 @@
+// src/internal/html.ts
+var escapeHtml = (value) => String(value).replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+
 // src/client/htmx.ts
 var DEFAULT_EVENT_NAME = "voice-refresh";
 var DEFAULT_QUERY_PARAM = "sessionId";
@@ -101,19 +104,25 @@ var createMicrophoneCapture = (options) => {
   let processorNode = null;
   let mediaStream = null;
   const start = async () => {
-    if (typeof navigator === "undefined" || !navigator.mediaDevices?.getUserMedia) {
+    if (!options.stream && (typeof navigator === "undefined" || !navigator.mediaDevices?.getUserMedia)) {
       throw new Error("Browser microphone capture requires navigator.mediaDevices.getUserMedia.");
     }
     const AudioContextCtor = (typeof window !== "undefined" ? window.AudioContext ?? window.webkitAudioContext : undefined) ?? AudioContext;
     if (!AudioContextCtor) {
       throw new Error("Browser microphone capture requires AudioContext support.");
     }
-    mediaStream = await navigator.mediaDevices.getUserMedia({
+    mediaStream = options.stream ?? await navigator.mediaDevices.getUserMedia({
       audio: {
-        channelCount: options.channelCount ?? 1
+        autoGainControl: true,
+        channelCount: options.channelCount ?? 1,
+        echoCancellation: true,
+        noiseSuppression: true
       }
     });
     audioContext = new AudioContextCtor;
+    if (audioContext.state === "suspended") {
+      await audioContext.resume();
+    }
     sourceNode = audioContext.createMediaStreamSource(mediaStream);
     processorNode = audioContext.createScriptProcessor(4096, 1, 1);
     processorNode.onaudioprocess = (event) => {
@@ -181,13 +190,25 @@ var serverMessageToAction = (message) => {
     case "assistant":
       return {
         text: message.text,
+        turnId: message.turnId,
         type: "assistant"
       };
+    case "assistant_delta":
+      return {
+        delta: message.delta,
+        turnId: message.turnId,
+        type: "assistant_delta"
+      };
     case "complete":
       return {
         sessionId: message.sessionId,
         type: "complete"
       };
+    case "connection":
+      return {
+        reconnect: message.reconnect,
+        type: "connection"
+      };
     case "call_lifecycle":
       return {
         event: message.event,
@@ -209,9 +230,22 @@ var serverMessageToAction = (message) => {
         transcript: message.transcript,
         type: "partial"
       };
+    case "replay":
+      return {
+        assistantTexts: message.assistantTexts,
+        call: message.call,
+        partial: message.partial,
+        scenarioId: message.scenarioId,
+        sessionId: message.sessionId,
+        sessionMetadata: message.sessionMetadata,
+        status: message.status,
+        turns: message.turns,
+        type: "replay"
+      };
     case "session":
       return {
         sessionId: message.sessionId,
+        sessionMetadata: message.sessionMetadata,
         scenarioId: message.scenarioId,
         status: message.status,
         type: "session"
@@ -226,6 +260,233 @@ var serverMessageToAction = (message) => {
   }
 };
 
+// node_modules/@absolutejs/media/dist/index.js
+var TAU = Math.PI * 2;
+var pushIssue = (issues, severity, code, message) => {
+  issues.push({ code, message, severity });
+};
+var average = (values) => values.length === 0 ? undefined : values.reduce((total, value) => total + value, 0) / values.length;
+var max = (values) => values.length === 0 ? undefined : Math.max(...values);
+var numericStat = (stat, key) => {
+  const value = stat[key];
+  return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+};
+var booleanStat = (stat, key) => {
+  const value = stat[key];
+  return typeof value === "boolean" ? value : undefined;
+};
+var stringStat = (stat, key) => {
+  const value = stat[key];
+  return typeof value === "string" ? value : undefined;
+};
+var statKey = (stat) => String(stat.id ?? stringStat(stat, "ssrc") ?? numericStat(stat, "ssrc") ?? stringStat(stat, "trackIdentifier") ?? stringStat(stat, "mid") ?? "unknown");
+var secondsToMs = (value) => value === undefined ? undefined : value * 1000;
+var normalizeWebRTCStat = (stat) => {
+  const sample = {};
+  for (const [key, value] of Object.entries(stat)) {
+    if (value === null || typeof value === "boolean" || typeof value === "number" || typeof value === "string") {
+      sample[key] = value;
+    }
+  }
+  return sample;
+};
+var buildMediaWebRTCStatsReport = (input = {}) => {
+  const stats = input.stats ?? [];
+  const issues = [];
+  const inbound = stats.filter((stat) => stat.type === "inbound-rtp" && stringStat(stat, "kind") !== "video");
+  const outbound = stats.filter((stat) => stat.type === "outbound-rtp" && stringStat(stat, "kind") !== "video");
+  const candidatePairs = stats.filter((stat) => stat.type === "candidate-pair");
+  const audioTracks = stats.filter((stat) => (stat.type === "track" || stat.type === "media-source") && stringStat(stat, "kind") === "audio");
+  const activeCandidatePairs = candidatePairs.filter((stat) => booleanStat(stat, "selected") === true || booleanStat(stat, "nominated") === true || stringStat(stat, "state") === "succeeded").length;
+  const liveAudioTracks = audioTracks.filter((stat) => stringStat(stat, "readyState") !== "ended" && stringStat(stat, "trackState") !== "ended" && booleanStat(stat, "ended") !== true).length;
+  const endedAudioTracks = audioTracks.filter((stat) => stringStat(stat, "readyState") === "ended" || stringStat(stat, "trackState") === "ended" || booleanStat(stat, "ended") === true).length;
+  const inboundPackets = inbound.reduce((total, stat) => total + (numericStat(stat, "packetsReceived") ?? 0), 0);
+  const outboundPackets = outbound.reduce((total, stat) => total + (numericStat(stat, "packetsSent") ?? 0), 0);
+  const packetsLost = [...inbound, ...outbound].reduce((total, stat) => total + Math.max(0, numericStat(stat, "packetsLost") ?? 0), 0);
+  const packetLossDenominator = inboundPackets + packetsLost;
+  const packetLossRatio = packetLossDenominator === 0 ? 0 : packetsLost / packetLossDenominator;
+  const bytesReceived = inbound.reduce((total, stat) => total + (numericStat(stat, "bytesReceived") ?? 0), 0);
+  const bytesSent = outbound.reduce((total, stat) => total + (numericStat(stat, "bytesSent") ?? 0), 0);
+  const roundTripTimeMs = max(candidatePairs.map((stat) => secondsToMs(numericStat(stat, "currentRoundTripTime") ?? numericStat(stat, "roundTripTime"))).filter((value) => value !== undefined));
+  const jitterMs = max([...inbound, ...outbound].map((stat) => secondsToMs(numericStat(stat, "jitter"))).filter((value) => value !== undefined));
+  const jitterBufferDelayMs = max(inbound.map((stat) => {
+    const delay = numericStat(stat, "jitterBufferDelay");
+    const emitted = numericStat(stat, "jitterBufferEmittedCount");
+    return delay !== undefined && emitted !== undefined && emitted > 0 ? delay / emitted * 1000 : undefined;
+  }).filter((value) => value !== undefined));
+  const audioLevels = audioTracks.map((stat) => numericStat(stat, "audioLevel")).filter((value) => value !== undefined);
+  if (input.requireConnectedCandidatePair && candidatePairs.length > 0 && activeCandidatePairs === 0) {
+    pushIssue(issues, "error", "media.webrtc_candidate_pair_missing", "No active WebRTC candidate pair was observed.");
+  }
+  if (input.requireLiveAudioTrack && liveAudioTracks === 0) {
+    pushIssue(issues, "error", "media.webrtc_audio_track_missing", "No live WebRTC audio track was observed.");
+  }
+  if (input.maxPacketLossRatio !== undefined && packetLossRatio > input.maxPacketLossRatio) {
+    pushIssue(issues, "warning", "media.webrtc_packet_loss", `Observed WebRTC packet loss ratio ${String(packetLossRatio)} above ${String(input.maxPacketLossRatio)}.`);
+  }
+  if (input.maxRoundTripTimeMs !== undefined && roundTripTimeMs !== undefined && roundTripTimeMs > input.maxRoundTripTimeMs) {
+    pushIssue(issues, "warning", "media.webrtc_round_trip_time", `Observed WebRTC RTT ${String(roundTripTimeMs)}ms above ${String(input.maxRoundTripTimeMs)}ms.`);
+  }
+  if (input.maxJitterMs !== undefined && jitterMs !== undefined && jitterMs > input.maxJitterMs) {
+    pushIssue(issues, "warning", "media.webrtc_jitter", `Observed WebRTC jitter ${String(jitterMs)}ms above ${String(input.maxJitterMs)}ms.`);
+  }
+  return {
+    activeCandidatePairs,
+    audioLevelAverage: average(audioLevels),
+    bytesReceived,
+    bytesSent,
+    checkedAt: Date.now(),
+    endedAudioTracks,
+    inboundPackets,
+    issues,
+    jitterBufferDelayMs,
+    jitterMs,
+    liveAudioTracks,
+    outboundPackets,
+    packetLossRatio,
+    packetsLost,
+    roundTripTimeMs,
+    status: issues.some((issue) => issue.severity === "error") ? "fail" : issues.length > 0 ? "warn" : "pass",
+    totalStats: stats.length
+  };
+};
+var collectMediaWebRTCStats = async (input) => {
+  const report = await input.peerConnection.getStats(input.selector ?? null);
+  return [...report.values()].map(normalizeWebRTCStat);
+};
+var buildMediaWebRTCStreamContinuityReport = (input = {}) => {
+  const stats = input.stats ?? [];
+  const previousStats = input.previousStats ?? [];
+  const issues = [];
+  const previousByKey = new Map(previousStats.map((stat) => [statKey(stat), stat]));
+  const audioRtp = stats.filter((stat) => (stat.type === "inbound-rtp" || stat.type === "outbound-rtp") && stringStat(stat, "kind") !== "video" && stringStat(stat, "mediaType") !== "video");
+  const streams = audioRtp.map((stat) => {
+    const direction = stat.type === "outbound-rtp" ? "outbound" : "inbound";
+    const packetsKey = direction === "outbound" ? "packetsSent" : "packetsReceived";
+    const bytesKey = direction === "outbound" ? "bytesSent" : "bytesReceived";
+    const previous = previousByKey.get(statKey(stat));
+    const currentPackets = numericStat(stat, packetsKey);
+    const previousPackets = previous ? numericStat(previous, packetsKey) : undefined;
+    const currentBytes = numericStat(stat, bytesKey);
+    const previousBytes = previous ? numericStat(previous, bytesKey) : undefined;
+    const timeDeltaMs = stat.timestamp !== undefined && previous?.timestamp !== undefined ? stat.timestamp - previous.timestamp : undefined;
+    return {
+      bytesDelta: currentBytes !== undefined && previousBytes !== undefined ? currentBytes - previousBytes : undefined,
+      currentPackets,
+      direction,
+      id: statKey(stat),
+      packetDelta: currentPackets !== undefined && previousPackets !== undefined ? currentPackets - previousPackets : undefined,
+      previousPackets,
+      timeDeltaMs
+    };
+  });
+  const inbound = streams.filter((stream) => stream.direction === "inbound");
+  const outbound = streams.filter((stream) => stream.direction === "outbound");
+  const maxObservedGapMs = max(streams.map((stream) => stream.timeDeltaMs).filter((value) => value !== undefined));
+  const stalledInboundStreams = inbound.filter((stream) => input.maxInboundPacketStallMs !== undefined && stream.timeDeltaMs !== undefined && stream.timeDeltaMs >= input.maxInboundPacketStallMs && stream.packetDelta !== undefined && stream.packetDelta <= 0).length;
+  const stalledOutboundStreams = outbound.filter((stream) => input.maxOutboundPacketStallMs !== undefined && stream.timeDeltaMs !== undefined && stream.timeDeltaMs >= input.maxOutboundPacketStallMs && stream.packetDelta !== undefined && stream.packetDelta <= 0).length;
+  if (input.requireInboundAudio && inbound.length === 0) {
+    pushIssue(issues, "error", "media.webrtc_inbound_audio_missing", "No inbound WebRTC audio RTP stream was observed.");
+  }
+  if (input.requireOutboundAudio && outbound.length === 0) {
+    pushIssue(issues, "error", "media.webrtc_outbound_audio_missing", "No outbound WebRTC audio RTP stream was observed.");
+  }
+  if (input.maxGapMs !== undefined && maxObservedGapMs !== undefined && maxObservedGapMs > input.maxGapMs) {
+    pushIssue(issues, "warning", "media.webrtc_stream_gap", `Observed WebRTC stream sample gap ${String(maxObservedGapMs)}ms above ${String(input.maxGapMs)}ms.`);
+  }
+  if (stalledInboundStreams > 0) {
+    pushIssue(issues, "error", "media.webrtc_inbound_stalled", `${String(stalledInboundStreams)} inbound WebRTC audio stream(s) stopped receiving packets.`);
+  }
+  if (stalledOutboundStreams > 0) {
+    pushIssue(issues, "error", "media.webrtc_outbound_stalled", `${String(stalledOutboundStreams)} outbound WebRTC audio stream(s) stopped sending packets.`);
+  }
+  return {
+    checkedAt: Date.now(),
+    inboundAudioStreams: inbound.length,
+    issues,
+    maxObservedGapMs,
+    outboundAudioStreams: outbound.length,
+    stalledInboundStreams,
+    stalledOutboundStreams,
+    status: issues.some((issue) => issue.severity === "error") ? "fail" : issues.length > 0 ? "warn" : "pass",
+    streams,
+    totalStats: stats.length
+  };
+};
+
+// src/client/browserMedia.ts
+var DEFAULT_BROWSER_MEDIA_PATH = "/api/voice/browser-media";
+var DEFAULT_BROWSER_MEDIA_INTERVAL_MS = 5000;
+var resolvePeerConnection = async (options) => options.peerConnection ?? await options.getPeerConnection?.() ?? null;
+var postBrowserMediaReport = async (payload, options) => {
+  const requestFetch = options.fetch ?? globalThis.fetch;
+  if (!requestFetch) {
+    return;
+  }
+  await requestFetch(options.path ?? DEFAULT_BROWSER_MEDIA_PATH, {
+    body: JSON.stringify(payload),
+    headers: {
+      "Content-Type": "application/json"
+    },
+    keepalive: true,
+    method: "POST"
+  });
+};
+var createVoiceBrowserMediaReporter = (options) => {
+  let interval = null;
+  let previousStats = [];
+  const reportOnce = async () => {
+    const peerConnection = await resolvePeerConnection(options);
+    if (!peerConnection) {
+      return;
+    }
+    const stats = await collectMediaWebRTCStats({ peerConnection });
+    const report = buildMediaWebRTCStatsReport({
+      ...options,
+      stats
+    });
+    const continuity = options.continuity === false ? undefined : buildMediaWebRTCStreamContinuityReport({
+      ...options.continuity,
+      previousStats,
+      stats
+    });
+    const payload = {
+      at: Date.now(),
+      continuity,
+      report,
+      scenarioId: options.getScenarioId?.() ?? null,
+      sessionId: options.getSessionId?.() ?? null
+    };
+    previousStats = stats;
+    options.onReport?.(payload);
+    await postBrowserMediaReport(payload, options);
+    return payload;
+  };
+  const run = () => {
+    reportOnce().catch((error) => {
+      options.onError?.(error);
+    });
+  };
+  const stop = () => {
+    if (interval) {
+      clearInterval(interval);
+      interval = null;
+    }
+  };
+  return {
+    close: stop,
+    reportOnce,
+    stop,
+    start: () => {
+      if (interval) {
+        return;
+      }
+      run();
+      interval = setInterval(run, options.intervalMs ?? DEFAULT_BROWSER_MEDIA_INTERVAL_MS);
+    }
+  };
+};
+
 // src/client/connection.ts
 var WS_OPEN = 1;
 var WS_CLOSED = 3;
@@ -240,13 +501,14 @@ var NOOP_CONNECTION = {
   callControl: noop,
   close: noop,
   endTurn: noop,
+  send: noop,
+  sendAudio: noop,
+  simulateDisconnect: noop,
+  subscribe: noopUnsubscribe,
   getReadyState: () => WS_CLOSED,
   getScenarioId: () => "",
   getSessionId: () => "",
-  send: noop,
-  sendAudio: noop,
-  start: () => {},
-  subscribe: noopUnsubscribe
+  start: () => {}
 };
 var createSessionId = () => crypto.randomUUID();
 var buildWsUrl = (path, sessionId, scenarioId) => {
@@ -269,10 +531,12 @@ var isVoiceServerMessage = (value) => {
     case "assistant":
     case "call_lifecycle":
     case "complete":
+    case "connection":
     case "error":
     case "final":
     case "partial":
     case "pong":
+    case "replay":
     case "session":
     case "turn":
       return true;
@@ -309,6 +573,9 @@ var createVoiceConnection = (path, options = {}) => {
     sessionId: options.sessionId ?? createSessionId(),
     ws: null
   };
+  const emitConnection = (reconnect) => {
+    listeners.forEach((listener) => listener(reconnect));
+  };
   const clearTimers = () => {
     if (state.pingInterval) {
       clearInterval(state.pingInterval);
@@ -331,9 +598,28 @@ var createVoiceConnection = (path, options = {}) => {
     }
   };
   const scheduleReconnect = () => {
+    const nextAttemptAt = Date.now() + RECONNECT_DELAY_MS;
     state.reconnectAttempts += 1;
+    emitConnection({
+      reconnect: {
+        attempts: state.reconnectAttempts,
+        lastDisconnectAt: Date.now(),
+        maxAttempts: maxReconnectAttempts,
+        nextAttemptAt,
+        status: "reconnecting"
+      },
+      type: "connection"
+    });
     state.reconnectTimeout = setTimeout(() => {
       if (state.reconnectAttempts > maxReconnectAttempts) {
+        emitConnection({
+          reconnect: {
+            attempts: state.reconnectAttempts,
+            maxAttempts: maxReconnectAttempts,
+            status: "exhausted"
+          },
+          type: "connection"
+        });
         return;
       }
       connect();
@@ -343,9 +629,21 @@ var createVoiceConnection = (path, options = {}) => {
     const ws = new WebSocket(buildWsUrl(path, state.sessionId, state.scenarioId));
     ws.binaryType = "arraybuffer";
     ws.onopen = () => {
+      const wasReconnecting = state.reconnectAttempts > 0;
       state.isConnected = true;
-      state.reconnectAttempts = 0;
       flushPendingMessages();
+      if (wasReconnecting) {
+        emitConnection({
+          reconnect: {
+            attempts: state.reconnectAttempts,
+            lastResumedAt: Date.now(),
+            maxAttempts: maxReconnectAttempts,
+            status: "resumed"
+          },
+          type: "connection"
+        });
+        state.reconnectAttempts = 0;
+      }
       listeners.forEach((listener) => listener({
         scenarioId: state.scenarioId ?? undefined,
         sessionId: state.sessionId,
@@ -375,6 +673,16 @@ var createVoiceConnection = (path, options = {}) => {
       const reconnectable = shouldReconnect && event.code !== WS_NORMAL_CLOSURE && state.reconnectAttempts < maxReconnectAttempts;
       if (reconnectable) {
         scheduleReconnect();
+      } else if (shouldReconnect && event.code !== WS_NORMAL_CLOSURE) {
+        emitConnection({
+          reconnect: {
+            attempts: state.reconnectAttempts,
+            lastDisconnectAt: Date.now(),
+            maxAttempts: maxReconnectAttempts,
+            status: "exhausted"
+          },
+          type: "connection"
+        });
       }
     };
     state.ws = ws;
@@ -397,9 +705,9 @@ var createVoiceConnection = (path, options = {}) => {
       state.scenarioId = input.scenarioId;
     }
     send({
-      type: "start",
+      scenarioId: state.scenarioId ?? undefined,
       sessionId: state.sessionId,
-      scenarioId: state.scenarioId ?? undefined
+      type: "start"
     });
   };
   const sendAudio = (audio) => {
@@ -423,6 +731,11 @@ var createVoiceConnection = (path, options = {}) => {
     state.isConnected = false;
     listeners.clear();
   };
+  const simulateDisconnect = () => {
+    if (state.ws?.readyState === WS_OPEN) {
+      state.ws.close(4000, "absolutejs-voice-reconnect-proof");
+    }
+  };
   const subscribe = (callback) => {
     listeners.add(callback);
     return () => {
@@ -434,26 +747,35 @@ var createVoiceConnection = (path, options = {}) => {
     callControl,
     close,
     endTurn,
-    getReadyState: () => state.ws?.readyState ?? WS_CLOSED,
-    getScenarioId: () => state.scenarioId ?? "",
-    getSessionId: () => state.sessionId,
     send,
     sendAudio,
+    simulateDisconnect,
     start,
-    subscribe
+    subscribe,
+    getReadyState: () => state.ws?.readyState ?? WS_CLOSED,
+    getScenarioId: () => state.scenarioId ?? "",
+    getSessionId: () => state.sessionId
   };
 };
 
 // src/client/store.ts
+var createInitialReconnectState = () => ({
+  attempts: 0,
+  maxAttempts: 0,
+  status: "idle"
+});
 var createInitialState = () => ({
   assistantAudio: [],
+  assistantStreamingText: "",
   assistantTexts: [],
   call: null,
   error: null,
   isConnected: false,
-  scenarioId: null,
   partial: "",
+  reconnect: createInitialReconnectState(),
+  scenarioId: null,
   sessionId: null,
+  sessionMetadata: null,
   status: "idle",
   turns: []
 });
@@ -482,9 +804,16 @@ var createVoiceStreamStore = () => {
       case "assistant":
         state = {
           ...state,
+          assistantStreamingText: "",
           assistantTexts: [...state.assistantTexts, action.text]
         };
         break;
+      case "assistant_delta":
+        state = {
+          ...state,
+          assistantStreamingText: `${state.assistantStreamingText}${action.delta}`
+        };
+        break;
       case "complete":
         state = {
           ...state,
@@ -509,7 +838,19 @@ var createVoiceStreamStore = () => {
       case "connected":
         state = {
           ...state,
-          isConnected: true
+          isConnected: true,
+          reconnect: state.reconnect.status === "reconnecting" ? {
+            ...state.reconnect,
+            lastResumedAt: Date.now(),
+            nextAttemptAt: undefined,
+            status: "resumed"
+          } : state.reconnect
+        };
+        break;
+      case "connection":
+        state = {
+          ...state,
+          reconnect: action.reconnect
         };
         break;
       case "disconnected":
@@ -537,6 +878,28 @@ var createVoiceStreamStore = () => {
           partial: action.transcript.text
         };
         break;
+      case "replay":
+        state = {
+          ...state,
+          assistantStreamingText: "",
+          assistantTexts: [...action.assistantTexts],
+          call: action.call ?? null,
+          error: null,
+          isConnected: action.status === "active",
+          partial: action.partial,
+          reconnect: state.reconnect.status === "reconnecting" ? {
+            ...state.reconnect,
+            lastResumedAt: Date.now(),
+            nextAttemptAt: undefined,
+            status: "resumed"
+          } : state.reconnect,
+          scenarioId: action.scenarioId ?? state.scenarioId,
+          sessionId: action.sessionId,
+          sessionMetadata: action.sessionMetadata ?? state.sessionMetadata,
+          status: action.status,
+          turns: [...action.turns]
+        };
+        break;
       case "session":
         state = {
           ...state,
@@ -544,6 +907,7 @@ var createVoiceStreamStore = () => {
           scenarioId: action.scenarioId ?? state.scenarioId,
           isConnected: action.status === "active",
           sessionId: action.sessionId,
+          sessionMetadata: action.sessionMetadata ?? state.sessionMetadata,
           status: action.status
         };
         break;
@@ -574,29 +938,73 @@ var createVoiceStreamStore = () => {
 var createVoiceStream = (path, options = {}) => {
   const connection = createVoiceConnection(path, options);
   const store = createVoiceStreamStore();
+  const browserMediaReporter = options.browserMedia && typeof window !== "undefined" ? createVoiceBrowserMediaReporter({
+    ...options.browserMedia,
+    getScenarioId: () => options.browserMedia ? options.browserMedia.getScenarioId?.() ?? connection.getScenarioId() : connection.getScenarioId(),
+    getSessionId: () => options.browserMedia ? options.browserMedia.getSessionId?.() ?? connection.getSessionId() : connection.getSessionId()
+  }) : null;
   const subscribers = new Set;
   const start = (input) => Promise.resolve().then(() => {
     if (!input?.sessionId && !input?.scenarioId) {
       return;
     }
     connection.start(input);
+    browserMediaReporter?.start();
   });
   const notify = () => {
     subscribers.forEach((subscriber) => subscriber());
   };
+  const reportReconnect = () => {
+    if (!options.reconnectReportPath || typeof fetch === "undefined") {
+      return;
+    }
+    const snapshot = store.getSnapshot();
+    const body = JSON.stringify({
+      at: Date.now(),
+      reconnect: snapshot.reconnect,
+      scenarioId: snapshot.scenarioId,
+      sessionId: connection.getSessionId(),
+      turnIds: snapshot.turns.map((turn) => turn.id)
+    });
+    fetch(options.reconnectReportPath, {
+      body,
+      headers: {
+        "Content-Type": "application/json"
+      },
+      keepalive: true,
+      method: "POST"
+    }).catch(() => {});
+  };
   const unsubscribeConnection = connection.subscribe((message) => {
     const action = serverMessageToAction(message);
     if (action) {
       store.dispatch(action);
+      if (message.type === "connection") {
+        reportReconnect();
+      }
       notify();
     }
   });
   return {
+    start,
+    get assistantAudio() {
+      return store.getSnapshot().assistantAudio;
+    },
+    get assistantTexts() {
+      return store.getSnapshot().assistantTexts;
+    },
+    get assistantStreamingText() {
+      return store.getSnapshot().assistantStreamingText;
+    },
+    get call() {
+      return store.getSnapshot().call;
+    },
     callControl(message) {
       connection.callControl(message);
     },
     close() {
       unsubscribeConnection();
+      browserMediaReporter?.close();
       connection.close();
       store.dispatch({ type: "disconnected" });
       notify();
@@ -616,44 +1024,43 @@ var createVoiceStream = (path, options = {}) => {
     get isConnected() {
       return store.getSnapshot().isConnected;
     },
-    get scenarioId() {
-      return store.getSnapshot().scenarioId;
-    },
-    start,
     get partial() {
       return store.getSnapshot().partial;
     },
-    get sessionId() {
-      return connection.getSessionId();
+    get reconnect() {
+      return store.getSnapshot().reconnect;
     },
-    get status() {
-      return store.getSnapshot().status;
+    get scenarioId() {
+      return store.getSnapshot().scenarioId;
     },
-    get turns() {
-      return store.getSnapshot().turns;
+    sendAudio(audio) {
+      connection.sendAudio(audio);
     },
-    get assistantTexts() {
-      return store.getSnapshot().assistantTexts;
+    get sessionId() {
+      return connection.getSessionId();
     },
-    get assistantAudio() {
-      return store.getSnapshot().assistantAudio;
+    get sessionMetadata() {
+      return store.getSnapshot().sessionMetadata;
     },
-    get call() {
-      return store.getSnapshot().call;
+    simulateDisconnect() {
+      connection.simulateDisconnect();
     },
-    sendAudio(audio) {
-      connection.sendAudio(audio);
+    get status() {
+      return store.getSnapshot().status;
     },
     subscribe(subscriber) {
       subscribers.add(subscriber);
       return () => {
         subscribers.delete(subscriber);
       };
+    },
+    get turns() {
+      return store.getSnapshot().turns;
     }
   };
 };
 
-// src/audioConditioning.ts
+// src/core/audioConditioning.ts
 var DEFAULT_TARGET_LEVEL = 0.08;
 var DEFAULT_MAX_GAIN = 3;
 var DEFAULT_NOISE_GATE_THRESHOLD = 0.006;
@@ -671,7 +1078,7 @@ var resolveAudioConditioningConfig = (config) => {
   };
 };
 
-// src/turnProfiles.ts
+// src/core/turnProfiles.ts
 var TURN_PROFILE_DEFAULTS = {
   balanced: {
     qualityProfile: "general",
@@ -693,12 +1100,12 @@ var TURN_PROFILE_DEFAULTS = {
   }
 };
 var QUALITY_PROFILE_DEFAULTS = {
-  general: {},
   "accent-heavy": {
     silenceMs: 1200,
     speechThreshold: 0.01,
     transcriptStabilityMs: 1200
   },
+  general: {},
   "noisy-room": {
     silenceMs: 2000,
     speechThreshold: 0.02,
@@ -726,7 +1133,7 @@ var resolveTurnDetectionConfig = (config) => {
   };
 };
 
-// src/presets.ts
+// src/core/presets.ts
 var PRESET_INPUTS = {
   chat: {
     audioConditioning: {
@@ -747,8 +1154,8 @@ var PRESET_INPUTS = {
     },
     sttLifecycle: "continuous",
     turnDetection: {
-      qualityProfile: "short-command",
-      profile: "balanced"
+      profile: "balanced",
+      qualityProfile: "short-command"
     }
   },
   default: {
@@ -763,8 +1170,8 @@ var PRESET_INPUTS = {
     },
     sttLifecycle: "continuous",
     turnDetection: {
-      qualityProfile: "general",
-      profile: "fast"
+      profile: "fast",
+      qualityProfile: "general"
     }
   },
   dictation: {
@@ -786,8 +1193,8 @@ var PRESET_INPUTS = {
     },
     sttLifecycle: "continuous",
     turnDetection: {
-      qualityProfile: "accent-heavy",
-      profile: "long-form"
+      profile: "long-form",
+      qualityProfile: "accent-heavy"
     }
   },
   "guided-intake": {
@@ -809,8 +1216,8 @@ var PRESET_INPUTS = {
     },
     sttLifecycle: "turn-scoped",
     turnDetection: {
-      qualityProfile: "accent-heavy",
-      profile: "long-form"
+      profile: "long-form",
+      qualityProfile: "accent-heavy"
     }
   },
   "noisy-room": {
@@ -832,8 +1239,8 @@ var PRESET_INPUTS = {
     },
     sttLifecycle: "continuous",
     turnDetection: {
-      qualityProfile: "noisy-room",
       profile: "long-form",
+      qualityProfile: "noisy-room",
       silenceMs: 2100,
       speechThreshold: 0.02,
       transcriptStabilityMs: 1650
@@ -858,8 +1265,8 @@ var PRESET_INPUTS = {
     },
     sttLifecycle: "continuous",
     turnDetection: {
-      qualityProfile: "noisy-room",
       profile: "long-form",
+      qualityProfile: "noisy-room",
       silenceMs: 660,
       speechThreshold: 0.012,
       transcriptStabilityMs: 300
@@ -884,8 +1291,8 @@ var PRESET_INPUTS = {
     },
     sttLifecycle: "continuous",
     turnDetection: {
-      qualityProfile: "noisy-room",
       profile: "long-form",
+      qualityProfile: "noisy-room",
       silenceMs: 620,
       speechThreshold: 0.012,
       transcriptStabilityMs: 280
@@ -910,8 +1317,8 @@ var PRESET_INPUTS = {
     },
     sttLifecycle: "continuous",
     turnDetection: {
-      qualityProfile: "noisy-room",
-      profile: "long-form"
+      profile: "long-form",
+      qualityProfile: "noisy-room"
     }
   }
 };
@@ -935,14 +1342,17 @@ var resolveVoiceRuntimePreset = (name = "default") => {
 // src/client/controller.ts
 var createInitialState2 = (stream) => ({
   assistantAudio: [...stream.assistantAudio],
+  assistantStreamingText: stream.assistantStreamingText,
   assistantTexts: [...stream.assistantTexts],
   call: stream.call,
   error: stream.error,
   isConnected: stream.isConnected,
   isRecording: false,
   partial: stream.partial,
+  reconnect: stream.reconnect,
   recordingError: null,
   sessionId: stream.sessionId,
+  sessionMetadata: stream.sessionMetadata,
   scenarioId: stream.scenarioId,
   status: stream.status,
   turns: [...stream.turns]
@@ -965,12 +1375,15 @@ var createVoiceController = (path, options = {}) => {
     state = {
       ...state,
       assistantAudio: [...stream.assistantAudio],
+      assistantStreamingText: stream.assistantStreamingText,
       assistantTexts: [...stream.assistantTexts],
       call: stream.call,
       error: stream.error,
       isConnected: stream.isConnected,
       partial: stream.partial,
+      reconnect: stream.reconnect,
       sessionId: stream.sessionId,
+      sessionMetadata: stream.sessionMetadata,
       scenarioId: stream.scenarioId,
       status: stream.status,
       turns: [...stream.turns]
@@ -994,8 +1407,15 @@ var createVoiceController = (path, options = {}) => {
     capture = createMicrophoneCapture({
       channelCount: options.capture?.channelCount ?? preset.capture.channelCount,
       onLevel: options.capture?.onLevel,
-      onAudio: (audio) => stream.sendAudio(audio),
-      sampleRateHz: options.capture?.sampleRateHz ?? preset.capture.sampleRateHz
+      onAudio: (audio) => {
+        if (options.capture?.onAudio) {
+          options.capture.onAudio(audio, stream.sendAudio);
+          return;
+        }
+        stream.sendAudio(audio);
+      },
+      sampleRateHz: options.capture?.sampleRateHz ?? preset.capture.sampleRateHz,
+      ...options.capture?.stream ? { stream: options.capture.stream } : {}
     });
     return capture;
   };
@@ -1041,11 +1461,25 @@ var createVoiceController = (path, options = {}) => {
     stream.close();
   };
   return {
+    close,
+    startRecording,
+    stopRecording,
+    get assistantAudio() {
+      return state.assistantAudio;
+    },
+    get assistantTexts() {
+      return state.assistantTexts;
+    },
+    get assistantStreamingText() {
+      return state.assistantStreamingText;
+    },
     bindHTMX(bindingOptions) {
       return bindVoiceHTMX(stream, bindingOptions);
     },
+    get call() {
+      return state.call;
+    },
     callControl: (message) => stream.callControl(message),
-    close,
     endTurn: () => stream.endTurn(),
     get error() {
       return state.error;
@@ -1061,21 +1495,26 @@ var createVoiceController = (path, options = {}) => {
     get partial() {
       return state.partial;
     },
+    get reconnect() {
+      return state.reconnect;
+    },
     get recordingError() {
       return state.recordingError;
     },
+    get scenarioId() {
+      return state.scenarioId;
+    },
     sendAudio: (audio) => stream.sendAudio(audio),
     get sessionId() {
       return state.sessionId;
     },
-    get scenarioId() {
-      return state.scenarioId;
+    get sessionMetadata() {
+      return state.sessionMetadata;
     },
-    startRecording,
+    simulateDisconnect: () => stream.simulateDisconnect(),
     get status() {
       return state.status;
     },
-    stopRecording,
     subscribe: (subscriber) => {
       subscribers.add(subscriber);
       return () => {
@@ -1091,15 +1530,690 @@ var createVoiceController = (path, options = {}) => {
     },
     get turns() {
       return state.turns;
+    }
+  };
+};
+
+// src/client/timeStretch.ts
+var HOP_MS = 10;
+var SEEK_MS = 5;
+var ENERGY_EPSILON = 0.000001;
+var HALF = 0.5;
+var MS_PER_SECOND = 1000;
+var makeHann = (length) => {
+  const weights = new Float32Array(length);
+  for (let index = 0;index < length; index += 1) {
+    weights[index] = HALF - HALF * Math.cos(2 * Math.PI * index / length);
+  }
+  return weights;
+};
+var correlationScore = (base, start, ref, length) => {
+  let dot = 0;
+  let energy = 0;
+  for (let index = 0;index < length; index += 1) {
+    const sample = base[start + index] ?? 0;
+    dot += sample * (ref[index] ?? 0);
+    energy += sample * sample;
+  }
+  return dot / Math.sqrt(energy + ENERGY_EPSILON);
+};
+var overlapAddGrain = (src, off, tail, weights, hop) => {
+  const out = new Float32Array(hop);
+  const nextTail = new Float32Array(hop);
+  for (let index = 0;index < hop; index += 1) {
+    out[index] = (tail[index] ?? 0) + (src[off + index] ?? 0) * (weights[index] ?? 0);
+    nextTail[index] = (src[off + hop + index] ?? 0) * (weights[hop + index] ?? 0);
+  }
+  return { nextTail, out };
+};
+var createTimeStretcher = () => {
+  let sampleRate = 0;
+  let channelCount = 0;
+  let hop = 0;
+  let frameLen = 0;
+  let seek = 0;
+  let weights = new Float32Array(0);
+  let buffers = [];
+  let inputStart = 0;
+  let analysisPos = 0;
+  let olaTail = [];
+  let naturalRef = null;
+  const init = (rate, channels) => {
+    sampleRate = rate;
+    channelCount = channels;
+    hop = Math.max(1, Math.round(sampleRate * HOP_MS / MS_PER_SECOND));
+    frameLen = hop * 2;
+    seek = Math.max(1, Math.round(sampleRate * SEEK_MS / MS_PER_SECOND));
+    weights = makeHann(frameLen);
+    buffers = Array.from({ length: channels }, () => new Float32Array(0));
+    olaTail = Array.from({ length: channels }, () => new Float32Array(hop));
+    inputStart = 0;
+    analysisPos = seek;
+    naturalRef = null;
+  };
+  const reset = () => {
+    buffers = buffers.map(() => new Float32Array(0));
+    olaTail = olaTail.map(() => new Float32Array(hop));
+    inputStart = 0;
+    analysisPos = seek;
+    naturalRef = null;
+  };
+  const append = (input) => {
+    for (let channel = 0;channel < channelCount; channel += 1) {
+      const incoming = input[channel] ?? input[0] ?? new Float32Array(0);
+      const existing = buffers[channel] ?? new Float32Array(0);
+      const merged = new Float32Array(existing.length + incoming.length);
+      merged.set(existing, 0);
+      merged.set(incoming, existing.length);
+      buffers[channel] = merged;
+    }
+  };
+  const inputEnd = () => inputStart + (buffers[0]?.length ?? 0);
+  const compact = () => {
+    const keepFrom = Math.max(inputStart, Math.floor(analysisPos) - seek - 1);
+    if (keepFrom <= inputStart)
+      return;
+    const drop = keepFrom - inputStart;
+    for (let channel = 0;channel < channelCount; channel += 1) {
+      buffers[channel] = (buffers[channel] ?? new Float32Array(0)).slice(drop);
+    }
+    inputStart = keepFrom;
+  };
+  const bestOffset = (center) => {
+    if (!naturalRef)
+      return 0;
+    const [base] = buffers;
+    if (!base)
+      return 0;
+    let bestDelta = 0;
+    let bestScore = -Infinity;
+    for (let delta = -seek;delta <= seek; delta += 1) {
+      const score = correlationScore(base, center + delta - inputStart, naturalRef, frameLen);
+      if (score <= bestScore)
+        continue;
+      bestScore = score;
+      bestDelta = delta;
+    }
+    return bestDelta;
+  };
+  const process = (input, speed, rate) => {
+    const channels = Math.max(1, input.length);
+    if (sampleRate !== rate || channelCount !== channels)
+      init(rate, channels);
+    append(input);
+    const analysisHop = hop * speed;
+    const segments = Array.from({ length: channelCount }, () => []);
+    const emitGrain = (pos) => {
+      const off = pos - inputStart;
+      for (let channel = 0;channel < channelCount; channel += 1) {
+        const src = buffers[channel];
+        const tail = olaTail[channel];
+        if (!src || !tail)
+          continue;
+        const grain = overlapAddGrain(src, off, tail, weights, hop);
+        olaTail[channel] = grain.nextTail;
+        segments[channel]?.push(grain.out);
+      }
+    };
+    const captureRef = (pos) => {
+      const ref = new Float32Array(frameLen);
+      const refOff = pos + hop - inputStart;
+      const [base] = buffers;
+      if (base)
+        ref.set(base.subarray(refOff, refOff + frameLen));
+      naturalRef = ref;
+    };
+    const canEmit = () => Math.floor(analysisPos) - seek >= inputStart && Math.floor(analysisPos) + seek + frameLen + hop <= inputEnd();
+    while (canEmit()) {
+      const center = Math.round(analysisPos);
+      const pos = center + bestOffset(center);
+      emitGrain(pos);
+      captureRef(pos);
+      analysisPos += analysisHop;
+    }
+    compact();
+    return segments.map((channelSegments) => {
+      const total = channelSegments.reduce((sum, seg) => sum + seg.length, 0);
+      const merged = new Float32Array(total);
+      let offset = 0;
+      for (const seg of channelSegments) {
+        merged.set(seg, offset);
+        offset += seg.length;
+      }
+      return merged;
+    });
+  };
+  return { process, reset };
+};
+
+// src/client/audioPlayer.ts
+var DEFAULT_LOOKAHEAD_MS = 15;
+var DEFAULT_VOLUME = 1;
+var DEFAULT_PLAYBACK_RATE = 1;
+var MIN_PLAYBACK_RATE = 0.5;
+var MAX_PLAYBACK_RATE = 2;
+var STRETCH_BYPASS_EPSILON = 0.01;
+var createInitialState3 = () => ({
+  activeSourceCount: 0,
+  error: null,
+  isActive: false,
+  isPlaying: false,
+  lastInterruptLatencyMs: undefined,
+  lastPlaybackStopLatencyMs: undefined,
+  processedChunkCount: 0,
+  queuedChunkCount: 0
+});
+var getAudioContextCtor = () => {
+  if (typeof window === "undefined") {
+    return typeof AudioContext === "undefined" ? undefined : AudioContext;
+  }
+  return window.AudioContext ?? window.webkitAudioContext;
+};
+var clampVolume = (volume) => {
+  if (typeof volume !== "number" || !Number.isFinite(volume)) {
+    return DEFAULT_VOLUME;
+  }
+  return Math.min(1, Math.max(0, volume));
+};
+var clampPlaybackRate = (rate) => {
+  if (typeof rate !== "number" || !Number.isFinite(rate)) {
+    return DEFAULT_PLAYBACK_RATE;
+  }
+  return Math.min(MAX_PLAYBACK_RATE, Math.max(MIN_PLAYBACK_RATE, rate));
+};
+var decodePCM16LEChunk = (audioContext, chunk) => {
+  const { format } = chunk;
+  if (format.container !== "raw" || format.encoding !== "pcm_s16le") {
+    throw new Error(`Unsupported assistant audio format: ${format.container}/${format.encoding}`);
+  }
+  const bytes = chunk.chunk;
+  const channels = Math.max(1, format.channels);
+  const sampleCount = Math.floor(bytes.byteLength / 2);
+  const frameCount = Math.max(1, Math.floor(sampleCount / channels));
+  const audioBuffer = audioContext.createBuffer(channels, frameCount, format.sampleRateHz);
+  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  for (let channelIndex = 0;channelIndex < channels; channelIndex += 1) {
+    const channelData = audioBuffer.getChannelData(channelIndex);
+    for (let frameIndex = 0;frameIndex < frameCount; frameIndex += 1) {
+      const sampleIndex = frameIndex * channels + channelIndex;
+      const sampleOffset = sampleIndex * 2;
+      if (sampleOffset + 1 >= bytes.byteLength) {
+        channelData[frameIndex] = 0;
+        continue;
+      }
+      channelData[frameIndex] = view.getInt16(sampleOffset, true) / 32768;
+    }
+  }
+  return audioBuffer;
+};
+var createVoiceAudioPlayer = (source, options = {}) => {
+  const subscribers = new Set;
+  const sourceNodes = new Set;
+  const lookaheadSeconds = (options.lookaheadMs ?? DEFAULT_LOOKAHEAD_MS) / 1000;
+  let state = createInitialState3();
+  let audioContext = null;
+  let outputNode = null;
+  let volume = clampVolume(options.volume);
+  let playbackRate = clampPlaybackRate(options.playbackRate);
+  let stretcher = null;
+  let queueEndTime = 0;
+  let syncPromise = Promise.resolve();
+  let interruptStartedAt = null;
+  let interruptPromise = null;
+  let resolveInterruptPromise = null;
+  let interruptFallbackTimer = null;
+  const notify = () => {
+    for (const subscriber of subscribers) {
+      subscriber();
+    }
+  };
+  const setState = (next) => {
+    state = {
+      ...state,
+      ...next
+    };
+    notify();
+  };
+  const clearError = () => {
+    if (state.error !== null) {
+      setState({ error: null });
+    }
+  };
+  const clearInterruptTimer = () => {
+    if (interruptFallbackTimer !== null) {
+      clearTimeout(interruptFallbackTimer);
+      interruptFallbackTimer = null;
+    }
+  };
+  const resolveInterrupt = (latencyMs) => {
+    clearInterruptTimer();
+    interruptStartedAt = null;
+    stretcher?.reset();
+    setState({
+      activeSourceCount: sourceNodes.size,
+      isPlaying: false,
+      lastInterruptLatencyMs: latencyMs,
+      lastPlaybackStopLatencyMs: state.lastPlaybackStopLatencyMs ?? latencyMs
+    });
+    resolveInterruptPromise?.();
+    resolveInterruptPromise = null;
+    interruptPromise = null;
+  };
+  const estimateOutputStopLatencyMs = (context) => {
+    if (!context) {
+      return 0;
+    }
+    return Math.max(0, ((context.baseLatency ?? 0) + (context.outputLatency ?? 0)) * 1000);
+  };
+  const applyOutputGain = (context) => {
+    if (!outputNode) {
+      return;
+    }
+    const gainValue = volume;
+    if (outputNode.gain.setValueAtTime) {
+      outputNode.gain.setValueAtTime(gainValue, context?.currentTime ?? 0);
+      return;
+    }
+    outputNode.gain.value = gainValue;
+  };
+  const muteOutputGain = (context) => {
+    if (!outputNode) {
+      return;
+    }
+    const gainValue = 0;
+    if (outputNode.gain.setValueAtTime) {
+      outputNode.gain.setValueAtTime(gainValue, context?.currentTime ?? 0);
+      return;
+    }
+    outputNode.gain.value = gainValue;
+  };
+  const maybeResolveInterrupt = () => {
+    if (interruptStartedAt === null || sourceNodes.size > 0) {
+      return;
+    }
+    resolveInterrupt(Date.now() - interruptStartedAt);
+  };
+  const ensureAudioContext = async () => {
+    if (audioContext) {
+      return audioContext;
+    }
+    if (options.createAudioContext) {
+      audioContext = options.createAudioContext();
+    } else {
+      const AudioContextCtor = getAudioContextCtor();
+      if (!AudioContextCtor) {
+        throw new Error("Assistant audio playback requires AudioContext support.");
+      }
+      audioContext = new AudioContextCtor;
+    }
+    if (audioContext.createGain) {
+      outputNode = audioContext.createGain();
+      outputNode.connect?.(audioContext.destination);
+    }
+    queueEndTime = audioContext.currentTime;
+    return audioContext;
+  };
+  const scheduleBuffer = (context, buffer, rate) => {
+    const node = context.createBufferSource();
+    node.buffer = buffer;
+    if (node.playbackRate) {
+      node.playbackRate.value = rate;
+    }
+    node.connect(outputNode ?? context.destination);
+    node.onended = () => {
+      sourceNodes.delete(node);
+      node.disconnect?.();
+      setState({
+        activeSourceCount: sourceNodes.size,
+        isPlaying: sourceNodes.size > 0 && state.isActive
+      });
+      maybeResolveInterrupt();
+    };
+    const startAt = Math.max(context.currentTime + lookaheadSeconds, queueEndTime);
+    queueEndTime = startAt + buffer.duration / rate;
+    sourceNodes.add(node);
+    setState({
+      activeSourceCount: sourceNodes.size,
+      isPlaying: true
+    });
+    node.start(startAt);
+  };
+  const scheduleChunk = async (chunk) => {
+    const context = await ensureAudioContext();
+    const buffer = decodePCM16LEChunk(context, chunk);
+    if (Math.abs(playbackRate - 1) <= STRETCH_BYPASS_EPSILON) {
+      stretcher?.reset();
+      scheduleBuffer(context, buffer, playbackRate);
+      return;
+    }
+    const channels = Math.max(1, chunk.format.channels);
+    const input = [];
+    for (let channelIndex = 0;channelIndex < channels; channelIndex += 1) {
+      input.push(buffer.getChannelData(channelIndex));
+    }
+    stretcher ??= createTimeStretcher();
+    const stretched = stretcher.process(input, playbackRate, chunk.format.sampleRateHz);
+    const outLength = stretched[0]?.length ?? 0;
+    if (outLength === 0) {
+      return;
+    }
+    const outBuffer = context.createBuffer(channels, outLength, chunk.format.sampleRateHz);
+    for (let channelIndex = 0;channelIndex < channels; channelIndex += 1) {
+      const channelOut = stretched[channelIndex];
+      if (!channelOut)
+        continue;
+      outBuffer.getChannelData(channelIndex).set(channelOut);
+    }
+    scheduleBuffer(context, outBuffer, 1);
+  };
+  const stopQueuedPlayback = (options2) => {
+    for (const node of [...sourceNodes]) {
+      node.stop?.();
+    }
+    queueEndTime = audioContext ? audioContext.currentTime : 0;
+    if (options2?.forceClear) {
+      for (const node of sourceNodes) {
+        node.disconnect?.();
+      }
+      sourceNodes.clear();
+      maybeResolveInterrupt();
+    }
+  };
+  const sync = async () => {
+    if (!state.isActive) {
+      return;
+    }
+    const nextChunks = source.assistantAudio.slice(state.processedChunkCount);
+    if (nextChunks.length === 0) {
+      return;
+    }
+    try {
+      clearError();
+      for (const chunk of nextChunks) {
+        await scheduleChunk(chunk);
+      }
+      setState({
+        processedChunkCount: source.assistantAudio.length,
+        queuedChunkCount: state.queuedChunkCount + nextChunks.length
+      });
+    } catch (error) {
+      setState({
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
+  };
+  const queueSync = () => {
+    syncPromise = syncPromise.then(() => sync(), () => sync());
+    return syncPromise;
+  };
+  const unsubscribeSource = source.subscribe(() => {
+    if (options.autoStart && !state.isActive && source.assistantAudio.length > 0) {
+      player.start();
+      return;
+    }
+    if (state.isActive) {
+      queueSync();
+    }
+  });
+  const player = {
+    get activeSourceCount() {
+      return state.activeSourceCount;
     },
-    get assistantTexts() {
-      return state.assistantTexts;
+    close: async () => {
+      unsubscribeSource();
+      stopQueuedPlayback({ forceClear: true });
+      clearInterruptTimer();
+      resolveInterruptPromise?.();
+      resolveInterruptPromise = null;
+      interruptPromise = null;
+      interruptStartedAt = null;
+      if (audioContext && audioContext.state !== "closed") {
+        await audioContext.close();
+      }
+      audioContext = null;
+      outputNode?.disconnect?.();
+      outputNode = null;
+      queueEndTime = 0;
+      setState({
+        activeSourceCount: 0,
+        isActive: false,
+        isPlaying: false
+      });
     },
-    get assistantAudio() {
-      return state.assistantAudio;
+    get error() {
+      return state.error;
     },
-    get call() {
-      return state.call;
+    getSnapshot: () => state,
+    interrupt: async () => {
+      const startedAt = Date.now();
+      const context = await ensureAudioContext();
+      interruptStartedAt = startedAt;
+      muteOutputGain(context);
+      const playbackStopLatencyMs = Date.now() - startedAt + estimateOutputStopLatencyMs(context);
+      setState({
+        isActive: false,
+        isPlaying: sourceNodes.size > 0,
+        lastPlaybackStopLatencyMs: playbackStopLatencyMs
+      });
+      if (sourceNodes.size === 0) {
+        resolveInterrupt(playbackStopLatencyMs);
+        return;
+      }
+      if (!interruptPromise) {
+        interruptPromise = new Promise((resolve) => {
+          resolveInterruptPromise = resolve;
+        });
+      }
+      clearInterruptTimer();
+      interruptFallbackTimer = setTimeout(() => {
+        for (const node of sourceNodes) {
+          node.disconnect?.();
+        }
+        sourceNodes.clear();
+        resolveInterrupt(Date.now() - startedAt);
+      }, 250);
+      stopQueuedPlayback();
+      await interruptPromise;
+    },
+    get isActive() {
+      return state.isActive;
+    },
+    get isPlaying() {
+      return state.isPlaying;
+    },
+    get lastInterruptLatencyMs() {
+      return state.lastInterruptLatencyMs;
+    },
+    get lastPlaybackStopLatencyMs() {
+      return state.lastPlaybackStopLatencyMs;
+    },
+    pause: async () => {
+      if (!audioContext) {
+        setState({
+          activeSourceCount: 0,
+          isActive: false,
+          isPlaying: false
+        });
+        return;
+      }
+      await audioContext.suspend();
+      setState({
+        activeSourceCount: sourceNodes.size,
+        isActive: false,
+        isPlaying: false
+      });
+    },
+    get playbackRate() {
+      return playbackRate;
+    },
+    get processedChunkCount() {
+      return state.processedChunkCount;
+    },
+    get queuedChunkCount() {
+      return state.queuedChunkCount;
+    },
+    setPlaybackRate: (nextRate) => {
+      playbackRate = clampPlaybackRate(nextRate);
+    },
+    setVolume: (nextVolume) => {
+      volume = clampVolume(nextVolume);
+      applyOutputGain(audioContext);
+    },
+    start: async () => {
+      try {
+        clearError();
+        const context = await ensureAudioContext();
+        applyOutputGain(context);
+        if (context.state === "suspended") {
+          await context.resume();
+        }
+        setState({
+          activeSourceCount: sourceNodes.size,
+          isActive: true,
+          isPlaying: context.state === "running"
+        });
+        await queueSync();
+      } catch (error) {
+        setState({
+          error: error instanceof Error ? error.message : String(error),
+          isActive: false,
+          isPlaying: false
+        });
+        throw error;
+      }
+    },
+    subscribe: (subscriber) => {
+      subscribers.add(subscriber);
+      return () => {
+        subscribers.delete(subscriber);
+      };
+    },
+    get volume() {
+      return volume;
+    }
+  };
+  return player;
+};
+
+// src/client/bargeInMonitor.ts
+var DEFAULT_THRESHOLD_MS = 250;
+var createEventId = () => `barge-in:${Date.now()}:${crypto.randomUUID?.() ?? Math.random().toString(36).slice(2)}`;
+var summarize = (events, thresholdMs) => {
+  const stopped = events.filter((event) => event.status === "stopped");
+  const latencies = stopped.map((event) => event.latencyMs).filter((value) => typeof value === "number");
+  const failed = stopped.filter((event) => typeof event.latencyMs === "number" && event.latencyMs > thresholdMs).length;
+  const passed = stopped.length - failed;
+  return {
+    averageLatencyMs: latencies.length > 0 ? Math.round(latencies.reduce((total, value) => total + value, 0) / latencies.length) : undefined,
+    events: [...events],
+    failed,
+    lastEvent: events.at(-1),
+    passed,
+    status: events.length === 0 ? "empty" : failed > 0 ? "fail" : stopped.length === 0 ? "warn" : "pass",
+    thresholdMs,
+    total: stopped.length
+  };
+};
+var createVoiceBargeInMonitor = (options = {}) => {
+  const listeners = new Set;
+  const thresholdMs = options.thresholdMs ?? DEFAULT_THRESHOLD_MS;
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const events = [];
+  const emit = () => {
+    for (const listener of listeners) {
+      listener();
+    }
+  };
+  const postEvent = (event) => {
+    if (!options.path || typeof fetchImpl !== "function") {
+      return;
+    }
+    fetchImpl(options.path, {
+      body: JSON.stringify(event),
+      headers: {
+        "Content-Type": "application/json"
+      },
+      method: "POST"
+    }).catch(() => {});
+  };
+  const record = (status, input) => {
+    const event = {
+      at: Date.now(),
+      id: createEventId(),
+      latencyMs: input.latencyMs,
+      playbackStopLatencyMs: input.playbackStopLatencyMs,
+      reason: input.reason,
+      sessionId: input.sessionId,
+      status,
+      thresholdMs
+    };
+    events.push(event);
+    postEvent(event);
+    emit();
+    return event;
+  };
+  return {
+    getSnapshot: () => summarize(events, thresholdMs),
+    recordRequested: (input) => record("requested", input),
+    recordSkipped: (input) => record("skipped", input),
+    recordStopped: (input) => record("stopped", input),
+    subscribe: (subscriber) => {
+      listeners.add(subscriber);
+      return () => {
+        listeners.delete(subscriber);
+      };
+    }
+  };
+};
+
+// src/client/duplex.ts
+var DEFAULT_INTERRUPT_THRESHOLD = 0.08;
+var shouldInterruptForLevel = (level, options = {}) => (options.enabled ?? true) && level >= (options.interruptThreshold ?? DEFAULT_INTERRUPT_THRESHOLD);
+var bindVoiceBargeIn = (controller, player, options = {}) => {
+  let lastPartial = controller.partial;
+  const interruptIfPlaying = (reason) => {
+    if (!player.isPlaying || options.enabled === false) {
+      options.monitor?.recordSkipped({
+        reason,
+        sessionId: controller.sessionId
+      });
+      return;
+    }
+    options.monitor?.recordRequested({
+      reason,
+      sessionId: controller.sessionId
+    });
+    player.interrupt().then(() => {
+      options.monitor?.recordStopped({
+        latencyMs: player.lastInterruptLatencyMs,
+        playbackStopLatencyMs: player.lastPlaybackStopLatencyMs,
+        reason,
+        sessionId: controller.sessionId
+      });
+    });
+  };
+  const unsubscribe = controller.subscribe(() => {
+    if (options.interruptOnPartial === false) {
+      lastPartial = controller.partial;
+      return;
+    }
+    if (!lastPartial && controller.partial) {
+      interruptIfPlaying("partial-transcript");
+    }
+    lastPartial = controller.partial;
+  });
+  return {
+    close: () => {
+      unsubscribe();
+    },
+    handleLevel: (level) => {
+      if (shouldInterruptForLevel(level, options)) {
+        interruptIfPlaying("input-level");
+      }
+    },
+    sendAudio: (audio) => {
+      interruptIfPlaying("manual-audio");
+      controller.sendAudio(audio);
     }
   };
 };
@@ -1126,8 +2240,7 @@ var DEFAULT_GUIDED_PROMPTS = [
   "Now describe what you are trying to do or test.",
   "Finish with any detail that feels blocked, risky, or unclear."
 ];
-var clamp = (value, min, max) => Math.min(max, Math.max(min, value));
-var escapeHtml = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var clamp = (value, min, max2) => Math.min(max2, Math.max(min, value));
 var readErrorField = (value, key) => {
   const candidate = value[key];
   if (typeof candidate === "string" && candidate.trim()) {
@@ -1160,6 +2273,17 @@ var formatErrorMessage = (error) => {
   }
   return "Unexpected error";
 };
+var formatReconnectState = (reconnect) => {
+  const pieces = [reconnect.status];
+  if (reconnect.attempts > 0 || reconnect.maxAttempts > 0) {
+    pieces.push(`${reconnect.attempts}/${reconnect.maxAttempts} attempts`);
+  }
+  if (reconnect.nextAttemptAt) {
+    const waitMs = Math.max(0, reconnect.nextAttemptAt - Date.now());
+    pieces.push(`retry in ${Math.ceil(waitMs / 100) / 10}s`);
+  }
+  return pieces.join(" · ");
+};
 var createInitialVoiceWaveLevels = (count = VOICE_WAVE_POINTS) => Array.from({ length: count }, () => 0);
 var pushVoiceWaveLevel = (levels, nextLevel, count = VOICE_WAVE_POINTS) => {
   const next = levels.slice(-(count - 1));
@@ -1216,6 +2340,20 @@ var parsePromptList = (value) => {
   } catch {}
   return DEFAULT_GUIDED_PROMPTS;
 };
+var parseOptionalNumber = (value) => {
+  if (!value) {
+    return;
+  }
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : undefined;
+};
+var resolveElement2 = (root, selector, ctor) => {
+  if (!selector) {
+    return null;
+  }
+  const value = document.querySelector(selector);
+  return value instanceof ctor ? value : null;
+};
 var requireElement = (root, selector, ctor, name) => {
   const value = selector ? document.querySelector(selector) : null;
   if (value instanceof ctor) {
@@ -1266,11 +2404,20 @@ var initVoiceHTMXRoot = (root) => {
   const guidedPrompts = parsePromptList(root.dataset.voiceGuidedPrompts);
   const guidedLabel = root.dataset.voiceGuidedLabel ?? DEFAULT_GUIDED_LABEL;
   const generalLabel = root.dataset.voiceGeneralLabel ?? DEFAULT_GENERAL_LABEL;
+  const reconnectReportPath = root.dataset.voiceReconnectReportPath;
+  const bargeInPath = root.dataset.voiceBargeInPath;
+  const bargeInMonitor = bargeInPath ? createVoiceBargeInMonitor({
+    path: bargeInPath,
+    thresholdMs: parseOptionalNumber(root.dataset.voiceBargeInThresholdMs)
+  }) : null;
+  const bargeInRecentWindowMs = parseOptionalNumber(root.dataset.voiceBargeInRecentWindowMs) ?? 4000;
+  const bargeInSpeechThreshold = parseOptionalNumber(root.dataset.voiceBargeInSpeechThreshold) ?? 0.04;
   const syncElement = requireElement(document, root.dataset.voiceSync, HTMLElement, "voice-htmx-sync");
   const connectionMetric = requireElement(root, root.dataset.voiceConnection, HTMLElement, "metric-connection");
   const errorStatus = requireElement(root, root.dataset.voiceError, HTMLElement, "status-error");
   const microphoneStatus = requireElement(root, root.dataset.voiceMicrophone, HTMLElement, "status-mic");
   const promptStatus = requireElement(root, root.dataset.voicePrompt, HTMLElement, "status-prompt");
+  const reconnectStatus = resolveElement2(root, root.dataset.voiceReconnect, HTMLElement);
   const chatList = requireElement(root, root.dataset.voiceChat, HTMLElement, "chat-list");
   const startGuidedButton = requireElement(root, root.dataset.voiceStartGuided, HTMLButtonElement, "start-guided");
   const startGeneralButton = requireElement(root, root.dataset.voiceStartGeneral, HTMLButtonElement, "start-general");
@@ -1279,35 +2426,70 @@ var initVoiceHTMXRoot = (root) => {
   const voiceMonitorCopy = requireElement(root, root.dataset.voiceMonitorCopy, HTMLElement, "voice-monitor-copy");
   const voiceWaveGlow = requireElement(root, root.dataset.voiceWaveGlow, SVGPathElement, "voice-wave-glow");
   const voiceWavePath = requireElement(root, root.dataset.voiceWavePath, SVGPathElement, "voice-wave-path");
+  let activeMode = null;
+  let hasStartedModes = {
+    general: false,
+    guided: false
+  };
+  let isCapturing = false;
+  let micError = null;
+  let waveLevels = createInitialVoiceWaveLevels();
+  let guidedBargeInBinding = null;
+  let generalBargeInBinding = null;
   const guidedVoice = createVoiceController(guidedPath, {
     capture: {
+      onAudio: (audio, sendAudio) => {
+        if (guidedBargeInBinding) {
+          guidedBargeInBinding.sendAudio(audio);
+          return;
+        }
+        sendAudio(audio);
+      },
       onLevel: (level) => {
+        guidedBargeInBinding?.handleLevel(level);
         waveLevels = pushVoiceWaveLevel(waveLevels, level);
         renderWave();
       }
     },
+    connection: {
+      reconnectReportPath
+    },
     preset: "guided-intake"
   });
   const generalVoice = createVoiceController(generalPath, {
     capture: {
+      onAudio: (audio, sendAudio) => {
+        if (generalBargeInBinding) {
+          generalBargeInBinding.sendAudio(audio);
+          return;
+        }
+        sendAudio(audio);
+      },
       onLevel: (level) => {
+        generalBargeInBinding?.handleLevel(level);
         waveLevels = pushVoiceWaveLevel(waveLevels, level);
         renderWave();
       }
     },
+    connection: {
+      reconnectReportPath
+    },
     preset: "dictation"
   });
   const stopGuidedBinding = guidedVoice.bindHTMX({ element: syncElement });
   const stopGeneralBinding = generalVoice.bindHTMX({ element: syncElement });
-  let activeMode = null;
-  let hasStartedModes = {
-    general: false,
-    guided: false
-  };
-  let isCapturing = false;
-  let micError = null;
-  let waveLevels = createInitialVoiceWaveLevels();
+  const guidedAudioPlayer = createVoiceAudioPlayer(guidedVoice);
+  const generalAudioPlayer = createVoiceAudioPlayer(generalVoice);
+  guidedBargeInBinding = bindVoiceBargeIn(guidedVoice, guidedAudioPlayer, {
+    interruptThreshold: bargeInSpeechThreshold,
+    monitor: bargeInMonitor ?? undefined
+  });
+  generalBargeInBinding = bindVoiceBargeIn(generalVoice, generalAudioPlayer, {
+    interruptThreshold: bargeInSpeechThreshold,
+    monitor: bargeInMonitor ?? undefined
+  });
   const currentVoice = () => activeMode === "general" ? generalVoice : guidedVoice;
+  const currentAudioPlayer = () => activeMode === "general" ? generalAudioPlayer : guidedAudioPlayer;
   const renderWave = () => {
     const path = createVoiceWavePath(waveLevels);
     voiceWaveGlow.setAttribute("d", path);
@@ -1319,9 +2501,12 @@ var initVoiceHTMXRoot = (root) => {
   const render = () => {
     const voice = currentVoice();
     const hasStarted = (activeMode ? hasStartedModes[activeMode] : false) || voice.turns.length > 0;
-    const status = voice.status;
+    const { status } = voice;
     connectionMetric.textContent = voice.isConnected ? "Connected" : "Waiting";
     errorStatus.textContent = micError || voice.error || "None";
+    if (reconnectStatus) {
+      reconnectStatus.textContent = formatReconnectState(voice.reconnect);
+    }
     microphoneStatus.textContent = isCapturing ? DEFAULT_MIC_LIVE : DEFAULT_MIC_IDLE;
     promptStatus.textContent = resolvePromptMessage({
       guidedPrompts,
@@ -1385,8 +2570,18 @@ var initVoiceHTMXRoot = (root) => {
       render();
     }
   };
-  guidedVoice.subscribe(render);
-  generalVoice.subscribe(render);
+  guidedVoice.subscribe(() => {
+    if (guidedVoice.assistantAudio.length > 0) {
+      guidedAudioPlayer.start().catch(() => {});
+    }
+    render();
+  });
+  generalVoice.subscribe(() => {
+    if (generalVoice.assistantAudio.length > 0) {
+      generalAudioPlayer.start().catch(() => {});
+    }
+    render();
+  });
   startGuidedButton.addEventListener("click", () => {
     startMode("guided");
   });
@@ -1396,9 +2591,16 @@ var initVoiceHTMXRoot = (root) => {
   stopButton.addEventListener("click", () => {
     stopMic();
   });
+  root.addEventListener("absolute-voice-simulate-disconnect", () => {
+    currentVoice().simulateDisconnect();
+  });
   window.addEventListener("beforeunload", () => {
     guidedVoice.stopRecording();
     generalVoice.stopRecording();
+    guidedBargeInBinding?.close();
+    generalBargeInBinding?.close();
+    guidedAudioPlayer.close();
+    generalAudioPlayer.close();
     stopGuidedBinding();
     stopGeneralBinding();
     guidedVoice.close();