@absolutejs/voice 0.0.22-beta.97 → 0.0.22-beta.99

package/dist/angular/index.js

@@ -1967,6 +1967,14 @@ var fetchVoiceTurnLatency = async (path = "/api/turn-latency", options = {}) =>
   }
   return await response.json();
 };
+var runVoiceTurnLatencyProof = async (path, options = {}) => {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const response = await fetchImpl(path, { method: "POST" });
+  if (!response.ok) {
+    throw new Error(`Voice turn latency proof failed: HTTP ${response.status}`);
+  }
+  return response.json();
+};
 var createVoiceTurnLatencyStore = (path = "/api/turn-latency", options = {}) => {
   const listeners = new Set;
   let closed = false;
@@ -2006,6 +2014,25 @@ var createVoiceTurnLatencyStore = (path = "/api/turn-latency", options = {}) =>
       throw error;
     }
   };
+  const runProof = async () => {
+    if (!options.proofPath) {
+      throw new Error("Voice turn latency proof path is not configured.");
+    }
+    snapshot = { ...snapshot, error: null, isLoading: true };
+    emit();
+    try {
+      await runVoiceTurnLatencyProof(options.proofPath, options);
+      return await refresh();
+    } catch (error) {
+      snapshot = {
+        ...snapshot,
+        error: error instanceof Error ? error.message : String(error),
+        isLoading: false
+      };
+      emit();
+      throw error;
+    }
+  };
   const close = () => {
     closed = true;
     if (timer) {
@@ -2024,6 +2051,7 @@ var createVoiceTurnLatencyStore = (path = "/api/turn-latency", options = {}) =>
     getServerSnapshot: () => snapshot,
     getSnapshot: () => snapshot,
     refresh,
+    runProof,
     subscribe: (listener) => {
       listeners.add(listener);
       return () => {
@@ -2065,6 +2093,7 @@ class VoiceTurnLatencyService {
       isLoading: computed7(() => isLoadingSignal()),
       refresh: store.refresh,
       report: computed7(() => reportSignal()),
+      runProof: store.runProof,
       updatedAt: computed7(() => updatedAtSignal())
     };
   }

package/dist/angular/voice-turn-latency.service.d.ts

@@ -7,6 +7,7 @@ export declare class VoiceTurnLatencyService {
         isLoading: import("@angular/core").Signal<boolean>;
         refresh: () => Promise<VoiceTurnLatencyReport | undefined>;
         report: import("@angular/core").Signal<VoiceTurnLatencyReport | undefined>;
+        runProof: () => Promise<VoiceTurnLatencyReport | undefined>;
         updatedAt: import("@angular/core").Signal<number | undefined>;
     };
 }

package/dist/client/index.d.ts

@@ -6,6 +6,7 @@ export { bindVoiceBargeIn, createVoiceDuplexController } from './duplex';
 export { bindVoiceHTMX } from './htmx';
 export { createMicrophoneCapture } from './microphone';
 export { createVoiceBargeInMonitor } from './bargeInMonitor';
+export { createVoiceLiveTurnLatencyMonitor } from './liveTurnLatency';
 export { createVoiceAppKitStatusStore, fetchVoiceAppKitStatus } from './appKitStatus';
 export { createVoiceOpsStatusViewModel, defineVoiceOpsStatusElement, getVoiceOpsStatusCSS, getVoiceOpsStatusLabel, mountVoiceOpsStatus, renderVoiceOpsStatusHTML } from './opsStatusWidget';
 export { createVoiceRoutingStatusStore, fetchVoiceRoutingStatus } from './routingStatus';
@@ -13,7 +14,7 @@ export { createVoiceRoutingStatusViewModel, defineVoiceRoutingStatusElement, get
 export { createVoiceProviderStatusStore, fetchVoiceProviderStatus } from './providerStatus';
 export { createVoiceProviderCapabilitiesStore, fetchVoiceProviderCapabilities } from './providerCapabilities';
 export { createVoiceTurnQualityStore, fetchVoiceTurnQuality } from './turnQuality';
-export { createVoiceTurnLatencyStore, fetchVoiceTurnLatency } from './turnLatency';
+export { createVoiceTurnLatencyStore, fetchVoiceTurnLatency, runVoiceTurnLatencyProof } from './turnLatency';
 export { createVoiceTraceTimelineStore, fetchVoiceTraceTimeline } from './traceTimeline';
 export { createVoiceProviderSimulationControlsStore } from './providerSimulationControls';
 export { bindVoiceProviderSimulationControls, createVoiceProviderSimulationControlsViewModel, defineVoiceProviderSimulationControlsElement, mountVoiceProviderSimulationControls, renderVoiceProviderSimulationControlsHTML } from './providerSimulationControlsWidget';
@@ -25,6 +26,7 @@ export { createVoiceTraceTimelineViewModel, defineVoiceTraceTimelineElement, get
 export { createVoiceWorkflowStatusStore, fetchVoiceWorkflowStatus } from './workflowStatus';
 export type { VoiceAppKitStatusClientOptions, VoiceAppKitStatusSnapshot } from './appKitStatus';
 export type { VoiceBargeInMonitorOptions } from './bargeInMonitor';
+export type { VoiceLiveTurnLatencyEvent, VoiceLiveTurnLatencyMonitorOptions, VoiceLiveTurnLatencySnapshot, VoiceLiveTurnLatencyStatus } from './liveTurnLatency';
 export type { VoiceOpsStatusSurfaceView, VoiceOpsStatusViewModel, VoiceOpsStatusWidgetOptions } from './opsStatusWidget';
 export type { VoiceRoutingStatusClientOptions, VoiceRoutingStatusSnapshot } from './routingStatus';
 export type { VoiceRoutingStatusViewModel, VoiceRoutingStatusWidgetOptions } from './routingStatusWidget';

package/dist/client/index.js

@@ -1724,6 +1724,116 @@ var createVoiceBargeInMonitor = (options = {}) => {
     }
   };
 };
+// src/client/liveTurnLatency.ts
+var getAudioLevel = (audio) => {
+  const bytes = audio instanceof Uint8Array ? audio : new Uint8Array(audio);
+  if (bytes.byteLength < 2) {
+    return 0;
+  }
+  const samples = new Int16Array(bytes.buffer, bytes.byteOffset, Math.floor(bytes.byteLength / 2));
+  if (samples.length === 0) {
+    return 0;
+  }
+  let sumSquares = 0;
+  for (const sample of samples) {
+    const normalized = sample / 32768;
+    sumSquares += normalized * normalized;
+  }
+  return Math.min(1, Math.max(0, Math.sqrt(sumSquares / samples.length) * 5.5));
+};
+var createVoiceLiveTurnLatencyMonitor = (options = {}) => {
+  const listeners = new Set;
+  const clock = options.clock ?? (() => Date.now());
+  const failAfterMs = options.failAfterMs ?? 3200;
+  const maxEvents = options.maxEvents ?? 20;
+  const speechThreshold = options.speechThreshold ?? 0.04;
+  const warnAfterMs = options.warnAfterMs ?? 1800;
+  let events = [];
+  let pending;
+  let lastAudioCount = 0;
+  let lastTextCount = 0;
+  let lastSessionId;
+  const emit = () => {
+    for (const listener of listeners) {
+      listener();
+    }
+  };
+  const completePending = (input) => {
+    if (!pending) {
+      return;
+    }
+    const completedAt = input.assistantAudioAt ?? input.assistantTextAt ?? clock();
+    const latencyMs = Math.max(0, completedAt - pending.startedAt);
+    const status = latencyMs > failAfterMs ? "fail" : latencyMs > warnAfterMs ? "warn" : "pass";
+    pending = {
+      ...pending,
+      ...input,
+      completedAt,
+      latencyMs,
+      status
+    };
+    events = [pending, ...events].slice(0, maxEvents);
+    pending = undefined;
+    emit();
+  };
+  const observe = (state) => {
+    const now = clock();
+    if (pending) {
+      if (state.assistantAudio.length > lastAudioCount) {
+        completePending({ assistantAudioAt: now });
+      } else if (state.assistantTexts.length > lastTextCount) {
+        completePending({ assistantTextAt: now });
+      }
+    }
+    lastAudioCount = state.assistantAudio.length;
+    lastTextCount = state.assistantTexts.length;
+    lastSessionId = state.sessionId;
+  };
+  const recordAudio = (audio) => {
+    if (pending || getAudioLevel(audio) < speechThreshold) {
+      return pending;
+    }
+    pending = {
+      id: `live-turn-${crypto.randomUUID()}`,
+      sessionId: lastSessionId ?? null,
+      startedAt: clock(),
+      status: "pending",
+      thresholdMs: failAfterMs
+    };
+    emit();
+    return pending;
+  };
+  const getSnapshot = () => {
+    const completed = events.filter((event) => typeof event.latencyMs === "number");
+    const latencies = completed.map((event) => event.latencyMs);
+    const failed = events.filter((event) => event.status === "fail").length;
+    const warnings = events.filter((event) => event.status === "warn").length;
+    const passed = events.filter((event) => event.status === "pass").length;
+    return {
+      averageLatencyMs: latencies.length ? Math.round(latencies.reduce((total, value) => total + value, 0) / latencies.length) : undefined,
+      events,
+      failed,
+      lastEvent: events[0],
+      passed,
+      pending,
+      status: pending ? "pending" : events.length === 0 ? "empty" : failed > 0 ? "fail" : warnings > 0 ? "warn" : "pass",
+      thresholdMs: failAfterMs,
+      total: events.length,
+      warnings
+    };
+  };
+  return {
+    getSnapshot,
+    observe,
+    recordAudio,
+    subscribe: (listener) => {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+  };
+};
 // src/client/appKitStatus.ts
 var fetchVoiceAppKitStatus = async (path = "/app-kit/status", options = {}) => {
   const fetchImpl = options.fetch ?? globalThis.fetch;
@@ -2339,6 +2449,14 @@ var fetchVoiceTurnLatency = async (path = "/api/turn-latency", options = {}) =>
   }
   return await response.json();
 };
+var runVoiceTurnLatencyProof = async (path, options = {}) => {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const response = await fetchImpl(path, { method: "POST" });
+  if (!response.ok) {
+    throw new Error(`Voice turn latency proof failed: HTTP ${response.status}`);
+  }
+  return response.json();
+};
 var createVoiceTurnLatencyStore = (path = "/api/turn-latency", options = {}) => {
   const listeners = new Set;
   let closed = false;
@@ -2378,6 +2496,25 @@ var createVoiceTurnLatencyStore = (path = "/api/turn-latency", options = {}) =>
       throw error;
     }
   };
+  const runProof = async () => {
+    if (!options.proofPath) {
+      throw new Error("Voice turn latency proof path is not configured.");
+    }
+    snapshot = { ...snapshot, error: null, isLoading: true };
+    emit();
+    try {
+      await runVoiceTurnLatencyProof(options.proofPath, options);
+      return await refresh();
+    } catch (error) {
+      snapshot = {
+        ...snapshot,
+        error: error instanceof Error ? error.message : String(error),
+        isLoading: false
+      };
+      emit();
+      throw error;
+    }
+  };
   const close = () => {
     closed = true;
     if (timer) {
@@ -2396,6 +2533,7 @@ var createVoiceTurnLatencyStore = (path = "/api/turn-latency", options = {}) =>
     getServerSnapshot: () => snapshot,
     getSnapshot: () => snapshot,
     refresh,
+    runProof,
     subscribe: (listener) => {
       listeners.add(listener);
       return () => {
@@ -3004,6 +3142,7 @@ var defineVoiceTurnQualityElement = (tagName = "absolute-voice-turn-quality") =>
 // src/client/turnLatencyWidget.ts
 var DEFAULT_TITLE6 = "Turn Latency";
 var DEFAULT_DESCRIPTION6 = "Per-turn timing from first transcript to commit and assistant response start.";
+var DEFAULT_PROOF_LABEL = "Run latency proof";
 var escapeHtml7 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var formatMs = (value) => typeof value === "number" ? `${Math.round(value)}ms` : "n/a";
 var createVoiceTurnLatencyViewModel = (snapshot, options = {}) => {
@@ -3022,6 +3161,8 @@ var createVoiceTurnLatencyViewModel = (snapshot, options = {}) => {
     error: snapshot.error,
     isLoading: snapshot.isLoading,
     label: snapshot.error ? "Unavailable" : turns.length ? failedCount > 0 ? `${failedCount} slow` : warningCount > 0 ? `${warningCount} warnings` : `avg ${formatMs(snapshot.report?.averageTotalMs)}` : snapshot.isLoading ? "Checking" : "No turns",
+    proofLabel: options.proofPath ? options.proofLabel ?? DEFAULT_PROOF_LABEL : undefined,
+    showProofAction: Boolean(options.proofPath),
     status: snapshot.error ? "error" : turns.length ? failedCount > 0 || warningCount > 0 ? "warning" : "ready" : snapshot.isLoading ? "loading" : "empty",
     title: options.title ?? DEFAULT_TITLE6,
     turns,
@@ -3046,6 +3187,7 @@ var renderVoiceTurnLatencyHTML = (snapshot, options = {}) => {
     <strong class="absolute-voice-turn-latency__label">${escapeHtml7(model.label)}</strong>
   </header>
   <p class="absolute-voice-turn-latency__description">${escapeHtml7(model.description)}</p>
+  ${model.showProofAction ? `<button class="absolute-voice-turn-latency__proof" data-absolute-voice-turn-latency-proof type="button">${escapeHtml7(model.proofLabel ?? DEFAULT_PROOF_LABEL)}</button>` : ""}
   ${turns}
   ${model.error ? `<p class="absolute-voice-turn-latency__error">${escapeHtml7(model.error)}</p>` : ""}
 </section>`;
@@ -3055,11 +3197,19 @@ var mountVoiceTurnLatency = (element, path = "/api/turn-latency", options = {})
   const render = () => {
     element.innerHTML = renderVoiceTurnLatencyHTML(store.getSnapshot(), options);
   };
+  const handleClick = (event) => {
+    const target = event.target;
+    if (target instanceof Element && target.closest("[data-absolute-voice-turn-latency-proof]")) {
+      store.runProof().catch(() => {});
+    }
+  };
   const unsubscribe = store.subscribe(render);
+  element.addEventListener("click", handleClick);
   render();
   store.refresh().catch(() => {});
   return {
     close: () => {
+      element.removeEventListener("click", handleClick);
       unsubscribe();
       store.close();
     },
@@ -3077,6 +3227,8 @@ var defineVoiceTurnLatencyElement = (tagName = "absolute-voice-turn-latency") =>
       this.mounted = mountVoiceTurnLatency(this, this.getAttribute("path") ?? "/api/turn-latency", {
         description: this.getAttribute("description") ?? undefined,
         intervalMs: Number.isFinite(intervalMs) ? intervalMs : 5000,
+        proofLabel: this.getAttribute("proof-label") ?? undefined,
+        proofPath: this.getAttribute("proof-path") ?? undefined,
         title: this.getAttribute("title") ?? undefined
       });
     }
@@ -3252,6 +3404,7 @@ var createVoiceWorkflowStatusStore = (path = "/evals/scenarios/json", options =
   };
 };
 export {
+  runVoiceTurnLatencyProof,
   renderVoiceTurnQualityHTML,
   renderVoiceTurnLatencyHTML,
   renderVoiceTraceTimelineWidgetHTML,
@@ -3309,6 +3462,7 @@ export {
   createVoiceProviderCapabilitiesViewModel,
   createVoiceProviderCapabilitiesStore,
   createVoiceOpsStatusViewModel,
+  createVoiceLiveTurnLatencyMonitor,
   createVoiceDuplexController,
   createVoiceController,
   createVoiceConnection,

package/dist/client/liveTurnLatency.d.ts

@@ -0,0 +1,38 @@
+import type { VoiceStreamState } from '../types';
+export type VoiceLiveTurnLatencyStatus = 'empty' | 'pending' | 'pass' | 'warn' | 'fail';
+export type VoiceLiveTurnLatencyEvent = {
+    assistantAudioAt?: number;
+    assistantTextAt?: number;
+    completedAt?: number;
+    id: string;
+    latencyMs?: number;
+    sessionId?: string | null;
+    startedAt: number;
+    status: Exclude<VoiceLiveTurnLatencyStatus, 'empty'>;
+    thresholdMs: number;
+};
+export type VoiceLiveTurnLatencySnapshot = {
+    averageLatencyMs?: number;
+    events: VoiceLiveTurnLatencyEvent[];
+    failed: number;
+    lastEvent?: VoiceLiveTurnLatencyEvent;
+    passed: number;
+    pending?: VoiceLiveTurnLatencyEvent;
+    status: VoiceLiveTurnLatencyStatus;
+    thresholdMs: number;
+    total: number;
+    warnings: number;
+};
+export type VoiceLiveTurnLatencyMonitorOptions = {
+    clock?: () => number;
+    failAfterMs?: number;
+    maxEvents?: number;
+    speechThreshold?: number;
+    warnAfterMs?: number;
+};
+export declare const createVoiceLiveTurnLatencyMonitor: (options?: VoiceLiveTurnLatencyMonitorOptions) => {
+    getSnapshot: () => VoiceLiveTurnLatencySnapshot;
+    observe: <TResult = unknown>(state: VoiceStreamState<TResult>) => void;
+    recordAudio: (audio: Uint8Array | ArrayBuffer) => VoiceLiveTurnLatencyEvent | undefined;
+    subscribe: (listener: () => void) => () => void;
+};

package/dist/client/turnLatency.d.ts

@@ -2,6 +2,7 @@ import type { VoiceTurnLatencyReport } from '../turnLatency';
 export type VoiceTurnLatencyClientOptions = {
     fetch?: typeof fetch;
     intervalMs?: number;
+    proofPath?: string;
 };
 export type VoiceTurnLatencySnapshot = {
     error: string | null;
@@ -10,10 +11,12 @@ export type VoiceTurnLatencySnapshot = {
     updatedAt?: number;
 };
 export declare const fetchVoiceTurnLatency: (path?: string, options?: Pick<VoiceTurnLatencyClientOptions, "fetch">) => Promise<VoiceTurnLatencyReport>;
+export declare const runVoiceTurnLatencyProof: (path: string, options?: Pick<VoiceTurnLatencyClientOptions, "fetch">) => Promise<unknown>;
 export declare const createVoiceTurnLatencyStore: (path?: string, options?: VoiceTurnLatencyClientOptions) => {
     close: () => void;
     getServerSnapshot: () => VoiceTurnLatencySnapshot;
     getSnapshot: () => VoiceTurnLatencySnapshot;
     refresh: () => Promise<VoiceTurnLatencyReport | undefined>;
+    runProof: () => Promise<VoiceTurnLatencyReport | undefined>;
     subscribe: (listener: () => void) => () => void;
 };

package/dist/client/turnLatencyWidget.d.ts

@@ -12,6 +12,8 @@ export type VoiceTurnLatencyViewModel = {
     error: string | null;
     isLoading: boolean;
     label: string;
+    proofLabel?: string;
+    showProofAction: boolean;
     status: 'empty' | 'error' | 'loading' | 'ready' | 'warning';
     title: string;
     turns: VoiceTurnLatencyCardView[];
@@ -19,6 +21,7 @@ export type VoiceTurnLatencyViewModel = {
 };
 export type VoiceTurnLatencyWidgetOptions = VoiceTurnLatencyClientOptions & {
     description?: string;
+    proofLabel?: string;
     title?: string;
 };
 export declare const createVoiceTurnLatencyViewModel: (snapshot: VoiceTurnLatencySnapshot, options?: VoiceTurnLatencyWidgetOptions) => VoiceTurnLatencyViewModel;

package/dist/react/index.js

@@ -1771,6 +1771,14 @@ var fetchVoiceTurnLatency = async (path = "/api/turn-latency", options = {}) =>
   }
   return await response.json();
 };
+var runVoiceTurnLatencyProof = async (path, options = {}) => {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const response = await fetchImpl(path, { method: "POST" });
+  if (!response.ok) {
+    throw new Error(`Voice turn latency proof failed: HTTP ${response.status}`);
+  }
+  return response.json();
+};
 var createVoiceTurnLatencyStore = (path = "/api/turn-latency", options = {}) => {
   const listeners = new Set;
   let closed = false;
@@ -1810,6 +1818,25 @@ var createVoiceTurnLatencyStore = (path = "/api/turn-latency", options = {}) =>
       throw error;
     }
   };
+  const runProof = async () => {
+    if (!options.proofPath) {
+      throw new Error("Voice turn latency proof path is not configured.");
+    }
+    snapshot = { ...snapshot, error: null, isLoading: true };
+    emit();
+    try {
+      await runVoiceTurnLatencyProof(options.proofPath, options);
+      return await refresh();
+    } catch (error) {
+      snapshot = {
+        ...snapshot,
+        error: error instanceof Error ? error.message : String(error),
+        isLoading: false
+      };
+      emit();
+      throw error;
+    }
+  };
   const close = () => {
     closed = true;
     if (timer) {
@@ -1828,6 +1855,7 @@ var createVoiceTurnLatencyStore = (path = "/api/turn-latency", options = {}) =>
     getServerSnapshot: () => snapshot,
     getSnapshot: () => snapshot,
     refresh,
+    runProof,
     subscribe: (listener) => {
       listeners.add(listener);
       return () => {
@@ -1850,13 +1878,15 @@ var useVoiceTurnLatency = (path = "/api/turn-latency", options = {}) => {
   }, [store]);
   return {
     ...useSyncExternalStore7(store.subscribe, store.getSnapshot, store.getServerSnapshot),
-    refresh: store.refresh
+    refresh: store.refresh,
+    runProof: store.runProof
   };
 };
 
 // src/client/turnLatencyWidget.ts
 var DEFAULT_TITLE6 = "Turn Latency";
 var DEFAULT_DESCRIPTION6 = "Per-turn timing from first transcript to commit and assistant response start.";
+var DEFAULT_PROOF_LABEL = "Run latency proof";
 var escapeHtml7 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var formatMs2 = (value) => typeof value === "number" ? `${Math.round(value)}ms` : "n/a";
 var createVoiceTurnLatencyViewModel = (snapshot, options = {}) => {
@@ -1875,6 +1905,8 @@ var createVoiceTurnLatencyViewModel = (snapshot, options = {}) => {
     error: snapshot.error,
     isLoading: snapshot.isLoading,
     label: snapshot.error ? "Unavailable" : turns.length ? failedCount > 0 ? `${failedCount} slow` : warningCount > 0 ? `${warningCount} warnings` : `avg ${formatMs2(snapshot.report?.averageTotalMs)}` : snapshot.isLoading ? "Checking" : "No turns",
+    proofLabel: options.proofPath ? options.proofLabel ?? DEFAULT_PROOF_LABEL : undefined,
+    showProofAction: Boolean(options.proofPath),
     status: snapshot.error ? "error" : turns.length ? failedCount > 0 || warningCount > 0 ? "warning" : "ready" : snapshot.isLoading ? "loading" : "empty",
     title: options.title ?? DEFAULT_TITLE6,
     turns,
@@ -1899,6 +1931,7 @@ var renderVoiceTurnLatencyHTML = (snapshot, options = {}) => {
     <strong class="absolute-voice-turn-latency__label">${escapeHtml7(model.label)}</strong>
   </header>
   <p class="absolute-voice-turn-latency__description">${escapeHtml7(model.description)}</p>
+  ${model.showProofAction ? `<button class="absolute-voice-turn-latency__proof" data-absolute-voice-turn-latency-proof type="button">${escapeHtml7(model.proofLabel ?? DEFAULT_PROOF_LABEL)}</button>` : ""}
   ${turns}
   ${model.error ? `<p class="absolute-voice-turn-latency__error">${escapeHtml7(model.error)}</p>` : ""}
 </section>`;
@@ -1908,11 +1941,19 @@ var mountVoiceTurnLatency = (element, path = "/api/turn-latency", options = {})
   const render = () => {
     element.innerHTML = renderVoiceTurnLatencyHTML(store.getSnapshot(), options);
   };
+  const handleClick = (event) => {
+    const target = event.target;
+    if (target instanceof Element && target.closest("[data-absolute-voice-turn-latency-proof]")) {
+      store.runProof().catch(() => {});
+    }
+  };
   const unsubscribe = store.subscribe(render);
+  element.addEventListener("click", handleClick);
   render();
   store.refresh().catch(() => {});
   return {
     close: () => {
+      element.removeEventListener("click", handleClick);
       unsubscribe();
       store.close();
     },
@@ -1930,6 +1971,8 @@ var defineVoiceTurnLatencyElement = (tagName = "absolute-voice-turn-latency") =>
       this.mounted = mountVoiceTurnLatency(this, this.getAttribute("path") ?? "/api/turn-latency", {
         description: this.getAttribute("description") ?? undefined,
         intervalMs: Number.isFinite(intervalMs) ? intervalMs : 5000,
+        proofLabel: this.getAttribute("proof-label") ?? undefined,
+        proofPath: this.getAttribute("proof-path") ?? undefined,
         title: this.getAttribute("title") ?? undefined
       });
     }
@@ -1947,8 +1990,8 @@ var VoiceTurnLatency = ({
   path = "/api/turn-latency",
   ...options
 }) => {
-  const snapshot = useVoiceTurnLatency(path, options);
-  const model = createVoiceTurnLatencyViewModel(snapshot, options);
+  const latency = useVoiceTurnLatency(path, options);
+  const model = createVoiceTurnLatencyViewModel(latency, options);
   return /* @__PURE__ */ jsxDEV7("section", {
     className: [
       "absolute-voice-turn-latency",
@@ -1973,6 +2016,14 @@ var VoiceTurnLatency = ({
         className: "absolute-voice-turn-latency__description",
         children: model.description
       }, undefined, false, undefined, this),
+      model.showProofAction ? /* @__PURE__ */ jsxDEV7("button", {
+        className: "absolute-voice-turn-latency__proof",
+        onClick: () => {
+          latency.runProof().catch(() => {});
+        },
+        type: "button",
+        children: model.proofLabel
+      }, undefined, false, undefined, this) : null,
       model.turns.length ? /* @__PURE__ */ jsxDEV7("div", {
         className: "absolute-voice-turn-latency__turns",
         children: model.turns.map((turn) => /* @__PURE__ */ jsxDEV7("article", {

package/dist/react/useVoiceTurnLatency.d.ts

@@ -1,6 +1,7 @@
 import { type VoiceTurnLatencyClientOptions } from '../client/turnLatency';
 export declare const useVoiceTurnLatency: (path?: string, options?: VoiceTurnLatencyClientOptions) => {
     refresh: () => Promise<import("..").VoiceTurnLatencyReport | undefined>;
+    runProof: () => Promise<import("..").VoiceTurnLatencyReport | undefined>;
     error: string | null;
     isLoading: boolean;
     report?: import("..").VoiceTurnLatencyReport;

package/dist/svelte/createVoiceTurnLatency.d.ts

@@ -6,5 +6,6 @@ export declare const createVoiceTurnLatency: (path?: string, options?: VoiceTurn
     getServerSnapshot: () => import("../client").VoiceTurnLatencySnapshot;
     getSnapshot: () => import("../client").VoiceTurnLatencySnapshot;
     refresh: () => Promise<import("..").VoiceTurnLatencyReport | undefined>;
+    runProof: () => Promise<import("..").VoiceTurnLatencyReport | undefined>;
     subscribe: (listener: () => void) => () => void;
 };

package/dist/svelte/index.js

@@ -1766,6 +1766,14 @@ var fetchVoiceTurnLatency = async (path = "/api/turn-latency", options = {}) =>
   }
   return await response.json();
 };
+var runVoiceTurnLatencyProof = async (path, options = {}) => {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const response = await fetchImpl(path, { method: "POST" });
+  if (!response.ok) {
+    throw new Error(`Voice turn latency proof failed: HTTP ${response.status}`);
+  }
+  return response.json();
+};
 var createVoiceTurnLatencyStore = (path = "/api/turn-latency", options = {}) => {
   const listeners = new Set;
   let closed = false;
@@ -1805,6 +1813,25 @@ var createVoiceTurnLatencyStore = (path = "/api/turn-latency", options = {}) =>
       throw error;
     }
   };
+  const runProof = async () => {
+    if (!options.proofPath) {
+      throw new Error("Voice turn latency proof path is not configured.");
+    }
+    snapshot = { ...snapshot, error: null, isLoading: true };
+    emit();
+    try {
+      await runVoiceTurnLatencyProof(options.proofPath, options);
+      return await refresh();
+    } catch (error) {
+      snapshot = {
+        ...snapshot,
+        error: error instanceof Error ? error.message : String(error),
+        isLoading: false
+      };
+      emit();
+      throw error;
+    }
+  };
   const close = () => {
     closed = true;
     if (timer) {
@@ -1823,6 +1850,7 @@ var createVoiceTurnLatencyStore = (path = "/api/turn-latency", options = {}) =>
     getServerSnapshot: () => snapshot,
     getSnapshot: () => snapshot,
     refresh,
+    runProof,
     subscribe: (listener) => {
       listeners.add(listener);
       return () => {
@@ -1835,6 +1863,7 @@ var createVoiceTurnLatencyStore = (path = "/api/turn-latency", options = {}) =>
 // src/client/turnLatencyWidget.ts
 var DEFAULT_TITLE6 = "Turn Latency";
 var DEFAULT_DESCRIPTION6 = "Per-turn timing from first transcript to commit and assistant response start.";
+var DEFAULT_PROOF_LABEL = "Run latency proof";
 var escapeHtml7 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var formatMs2 = (value) => typeof value === "number" ? `${Math.round(value)}ms` : "n/a";
 var createVoiceTurnLatencyViewModel = (snapshot, options = {}) => {
@@ -1853,6 +1882,8 @@ var createVoiceTurnLatencyViewModel = (snapshot, options = {}) => {
     error: snapshot.error,
     isLoading: snapshot.isLoading,
     label: snapshot.error ? "Unavailable" : turns.length ? failedCount > 0 ? `${failedCount} slow` : warningCount > 0 ? `${warningCount} warnings` : `avg ${formatMs2(snapshot.report?.averageTotalMs)}` : snapshot.isLoading ? "Checking" : "No turns",
+    proofLabel: options.proofPath ? options.proofLabel ?? DEFAULT_PROOF_LABEL : undefined,
+    showProofAction: Boolean(options.proofPath),
     status: snapshot.error ? "error" : turns.length ? failedCount > 0 || warningCount > 0 ? "warning" : "ready" : snapshot.isLoading ? "loading" : "empty",
     title: options.title ?? DEFAULT_TITLE6,
     turns,
@@ -1877,6 +1908,7 @@ var renderVoiceTurnLatencyHTML = (snapshot, options = {}) => {
     <strong class="absolute-voice-turn-latency__label">${escapeHtml7(model.label)}</strong>
   </header>
   <p class="absolute-voice-turn-latency__description">${escapeHtml7(model.description)}</p>
+  ${model.showProofAction ? `<button class="absolute-voice-turn-latency__proof" data-absolute-voice-turn-latency-proof type="button">${escapeHtml7(model.proofLabel ?? DEFAULT_PROOF_LABEL)}</button>` : ""}
   ${turns}
   ${model.error ? `<p class="absolute-voice-turn-latency__error">${escapeHtml7(model.error)}</p>` : ""}
 </section>`;
@@ -1886,11 +1918,19 @@ var mountVoiceTurnLatency = (element, path = "/api/turn-latency", options = {})
   const render = () => {
     element.innerHTML = renderVoiceTurnLatencyHTML(store.getSnapshot(), options);
   };
+  const handleClick = (event) => {
+    const target = event.target;
+    if (target instanceof Element && target.closest("[data-absolute-voice-turn-latency-proof]")) {
+      store.runProof().catch(() => {});
+    }
+  };
   const unsubscribe = store.subscribe(render);
+  element.addEventListener("click", handleClick);
   render();
   store.refresh().catch(() => {});
   return {
     close: () => {
+      element.removeEventListener("click", handleClick);
       unsubscribe();
       store.close();
     },
@@ -1908,6 +1948,8 @@ var defineVoiceTurnLatencyElement = (tagName = "absolute-voice-turn-latency") =>
       this.mounted = mountVoiceTurnLatency(this, this.getAttribute("path") ?? "/api/turn-latency", {
         description: this.getAttribute("description") ?? undefined,
         intervalMs: Number.isFinite(intervalMs) ? intervalMs : 5000,
+        proofLabel: this.getAttribute("proof-label") ?? undefined,
+        proofPath: this.getAttribute("proof-path") ?? undefined,
         title: this.getAttribute("title") ?? undefined
       });
     }

package/dist/vue/VoiceTurnLatency.d.ts

@@ -15,6 +15,14 @@ export declare const VoiceTurnLatency: import("vue").DefineComponent<import("vue
         default: string;
         type: StringConstructor;
     };
+    proofLabel: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    proofPath: {
+        default: undefined;
+        type: StringConstructor;
+    };
     title: {
         default: undefined;
         type: StringConstructor;
@@ -38,6 +46,14 @@ export declare const VoiceTurnLatency: import("vue").DefineComponent<import("vue
         default: string;
         type: StringConstructor;
     };
+    proofLabel: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    proofPath: {
+        default: undefined;
+        type: StringConstructor;
+    };
     title: {
         default: undefined;
         type: StringConstructor;
@@ -47,5 +63,7 @@ export declare const VoiceTurnLatency: import("vue").DefineComponent<import("vue
     title: string;
     path: string;
     intervalMs: number;
+    proofPath: string;
+    proofLabel: string;
     class: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/vue/index.js

@@ -1543,6 +1543,14 @@ var fetchVoiceTurnLatency = async (path = "/api/turn-latency", options = {}) =>
   }
   return await response.json();
 };
+var runVoiceTurnLatencyProof = async (path, options = {}) => {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const response = await fetchImpl(path, { method: "POST" });
+  if (!response.ok) {
+    throw new Error(`Voice turn latency proof failed: HTTP ${response.status}`);
+  }
+  return response.json();
+};
 var createVoiceTurnLatencyStore = (path = "/api/turn-latency", options = {}) => {
   const listeners = new Set;
   let closed = false;
@@ -1582,6 +1590,25 @@ var createVoiceTurnLatencyStore = (path = "/api/turn-latency", options = {}) =>
       throw error;
     }
   };
+  const runProof = async () => {
+    if (!options.proofPath) {
+      throw new Error("Voice turn latency proof path is not configured.");
+    }
+    snapshot = { ...snapshot, error: null, isLoading: true };
+    emit();
+    try {
+      await runVoiceTurnLatencyProof(options.proofPath, options);
+      return await refresh();
+    } catch (error) {
+      snapshot = {
+        ...snapshot,
+        error: error instanceof Error ? error.message : String(error),
+        isLoading: false
+      };
+      emit();
+      throw error;
+    }
+  };
   const close = () => {
     closed = true;
     if (timer) {
@@ -1600,6 +1627,7 @@ var createVoiceTurnLatencyStore = (path = "/api/turn-latency", options = {}) =>
     getServerSnapshot: () => snapshot,
     getSnapshot: () => snapshot,
     refresh,
+    runProof,
     subscribe: (listener) => {
       listeners.add(listener);
       return () => {
@@ -1612,6 +1640,7 @@ var createVoiceTurnLatencyStore = (path = "/api/turn-latency", options = {}) =>
 // src/client/turnLatencyWidget.ts
 var DEFAULT_TITLE5 = "Turn Latency";
 var DEFAULT_DESCRIPTION5 = "Per-turn timing from first transcript to commit and assistant response start.";
+var DEFAULT_PROOF_LABEL = "Run latency proof";
 var escapeHtml6 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var formatMs = (value) => typeof value === "number" ? `${Math.round(value)}ms` : "n/a";
 var createVoiceTurnLatencyViewModel = (snapshot, options = {}) => {
@@ -1630,6 +1659,8 @@ var createVoiceTurnLatencyViewModel = (snapshot, options = {}) => {
     error: snapshot.error,
     isLoading: snapshot.isLoading,
     label: snapshot.error ? "Unavailable" : turns.length ? failedCount > 0 ? `${failedCount} slow` : warningCount > 0 ? `${warningCount} warnings` : `avg ${formatMs(snapshot.report?.averageTotalMs)}` : snapshot.isLoading ? "Checking" : "No turns",
+    proofLabel: options.proofPath ? options.proofLabel ?? DEFAULT_PROOF_LABEL : undefined,
+    showProofAction: Boolean(options.proofPath),
     status: snapshot.error ? "error" : turns.length ? failedCount > 0 || warningCount > 0 ? "warning" : "ready" : snapshot.isLoading ? "loading" : "empty",
     title: options.title ?? DEFAULT_TITLE5,
     turns,
@@ -1654,6 +1685,7 @@ var renderVoiceTurnLatencyHTML = (snapshot, options = {}) => {
     <strong class="absolute-voice-turn-latency__label">${escapeHtml6(model.label)}</strong>
   </header>
   <p class="absolute-voice-turn-latency__description">${escapeHtml6(model.description)}</p>
+  ${model.showProofAction ? `<button class="absolute-voice-turn-latency__proof" data-absolute-voice-turn-latency-proof type="button">${escapeHtml6(model.proofLabel ?? DEFAULT_PROOF_LABEL)}</button>` : ""}
   ${turns}
   ${model.error ? `<p class="absolute-voice-turn-latency__error">${escapeHtml6(model.error)}</p>` : ""}
 </section>`;
@@ -1663,11 +1695,19 @@ var mountVoiceTurnLatency = (element, path = "/api/turn-latency", options = {})
   const render = () => {
     element.innerHTML = renderVoiceTurnLatencyHTML(store.getSnapshot(), options);
   };
+  const handleClick = (event) => {
+    const target = event.target;
+    if (target instanceof Element && target.closest("[data-absolute-voice-turn-latency-proof]")) {
+      store.runProof().catch(() => {});
+    }
+  };
   const unsubscribe = store.subscribe(render);
+  element.addEventListener("click", handleClick);
   render();
   store.refresh().catch(() => {});
   return {
     close: () => {
+      element.removeEventListener("click", handleClick);
       unsubscribe();
       store.close();
     },
@@ -1685,6 +1725,8 @@ var defineVoiceTurnLatencyElement = (tagName = "absolute-voice-turn-latency") =>
       this.mounted = mountVoiceTurnLatency(this, this.getAttribute("path") ?? "/api/turn-latency", {
         description: this.getAttribute("description") ?? undefined,
         intervalMs: Number.isFinite(intervalMs) ? intervalMs : 5000,
+        proofLabel: this.getAttribute("proof-label") ?? undefined,
+        proofPath: this.getAttribute("proof-path") ?? undefined,
         title: this.getAttribute("title") ?? undefined
       });
     }
@@ -1717,7 +1759,14 @@ var useVoiceTurnLatency = (path = "/api/turn-latency", options = {}) => {
     unsubscribe();
     store.close();
   });
-  return { error, isLoading, refresh: store.refresh, report, updatedAt };
+  return {
+    error,
+    isLoading,
+    refresh: store.refresh,
+    report,
+    runProof: store.runProof,
+    updatedAt
+  };
 };
 
 // src/vue/VoiceTurnLatency.ts
@@ -1728,12 +1777,16 @@ var VoiceTurnLatency = defineComponent6({
     description: { default: undefined, type: String },
     intervalMs: { default: 5000, type: Number },
     path: { default: "/api/turn-latency", type: String },
+    proofLabel: { default: undefined, type: String },
+    proofPath: { default: undefined, type: String },
     title: { default: undefined, type: String }
   },
   setup(props) {
     const options = {
       description: props.description,
       intervalMs: props.intervalMs,
+      proofLabel: props.proofLabel,
+      proofPath: props.proofPath,
       title: props.title
     };
     const latency = useVoiceTurnLatency(props.path, options);
@@ -1755,6 +1808,13 @@ var VoiceTurnLatency = defineComponent6({
         h6("strong", { class: "absolute-voice-turn-latency__label" }, model.value.label)
       ]),
       h6("p", { class: "absolute-voice-turn-latency__description" }, model.value.description),
+      model.value.showProofAction ? h6("button", {
+        class: "absolute-voice-turn-latency__proof",
+        onClick: () => {
+          latency.runProof().catch(() => {});
+        },
+        type: "button"
+      }, model.value.proofLabel) : null,
       model.value.turns.length ? h6("div", { class: "absolute-voice-turn-latency__turns" }, model.value.turns.map((turn) => h6("article", {
         class: [
           "absolute-voice-turn-latency__turn",

package/dist/vue/useVoiceTurnLatency.d.ts

@@ -5,5 +5,6 @@ export declare const useVoiceTurnLatency: (path?: string, options?: VoiceTurnLat
     isLoading: import("vue").ShallowRef<boolean, boolean>;
     refresh: () => Promise<VoiceTurnLatencyReport | undefined>;
     report: import("vue").ShallowRef<VoiceTurnLatencyReport | undefined, VoiceTurnLatencyReport | undefined>;
+    runProof: () => Promise<VoiceTurnLatencyReport | undefined>;
     updatedAt: import("vue").ShallowRef<number | undefined, number | undefined>;
 };

package/package.json

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