@absolutejs/voice 0.0.22-beta.66 → 0.0.22-beta.67

package/dist/index.js

@@ -10294,6 +10294,122 @@ var createVoiceToolContractRoutes = (options) => {
   }
   return routes;
 };
+// src/turnQuality.ts
+import { Elysia as Elysia14 } from "elysia";
+var DEFAULT_CONFIDENCE_WARN_THRESHOLD = 0.72;
+var escapeHtml15 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var getTurnLatencyMs = (turn) => {
+  const firstTranscriptAt = turn.transcripts.map((transcript) => transcript.endedAtMs ?? transcript.startedAtMs).filter((value) => typeof value === "number").sort((left, right) => left - right)[0];
+  if (firstTranscriptAt === undefined) {
+    return;
+  }
+  return Math.max(0, turn.committedAt - firstTranscriptAt);
+};
+var summarizeTurn = (sessionId, turn, options) => {
+  const quality = turn.quality;
+  const correctionChanged = quality?.correction?.changed === true;
+  const fallbackUsed = quality?.fallbackUsed === true;
+  const lowConfidence = typeof quality?.averageConfidence === "number" && quality.averageConfidence < options.confidenceWarnThreshold;
+  const hasNoQuality = !quality;
+  const status = hasNoQuality ? "unknown" : quality.selectedTranscriptCount === 0 || turn.text.trim().length === 0 ? "fail" : fallbackUsed || correctionChanged || lowConfidence ? "warn" : "pass";
+  return {
+    averageConfidence: quality?.averageConfidence,
+    committedAt: turn.committedAt,
+    correctionChanged,
+    correctionProvider: quality?.correction?.provider,
+    correctionReason: quality?.correction?.reason,
+    costUnits: quality?.cost?.estimatedRelativeCostUnits,
+    fallbackSelectionReason: quality?.fallback?.selectionReason,
+    fallbackUsed,
+    finalTranscriptCount: quality?.finalTranscriptCount ?? 0,
+    latencyMs: getTurnLatencyMs(turn),
+    partialTranscriptCount: quality?.partialTranscriptCount ?? 0,
+    selectedTranscriptCount: quality?.selectedTranscriptCount ?? 0,
+    sessionId,
+    source: quality?.source,
+    status,
+    text: turn.text,
+    turnId: turn.id
+  };
+};
+var resolveSessions = async (options) => {
+  if (options.sessions) {
+    return options.sessions;
+  }
+  if (!options.store) {
+    return [];
+  }
+  const summaries = await options.store.list();
+  const ids = options.sessionIds ?? summaries.map((summary) => summary.id);
+  const hydrated = await Promise.all(ids.slice(0, options.limit ?? 25).map((id) => options.store?.get(id)));
+  const sessions = [];
+  for (const session of hydrated) {
+    if (session) {
+      sessions.push(session);
+    }
+  }
+  return sessions;
+};
+var summarizeVoiceTurnQuality = async (options) => {
+  const sessions = await resolveSessions(options);
+  const confidenceWarnThreshold = options.confidenceWarnThreshold ?? DEFAULT_CONFIDENCE_WARN_THRESHOLD;
+  const turns = sessions.flatMap((session) => session.turns.map((turn) => summarizeTurn(session.id, turn, { confidenceWarnThreshold }))).sort((left, right) => right.committedAt - left.committedAt);
+  const failed = turns.filter((turn) => turn.status === "fail").length;
+  const warnings = turns.filter((turn) => turn.status === "warn").length;
+  return {
+    checkedAt: Date.now(),
+    failed,
+    sessions: sessions.length,
+    status: failed > 0 ? "fail" : warnings > 0 ? "warn" : "pass",
+    total: turns.length,
+    turns,
+    warnings
+  };
+};
+var renderVoiceTurnQualityHTML = (report, options = {}) => {
+  const title = options.title ?? "Voice Turn Quality";
+  const turns = report.turns.map((turn) => `<article class="turn ${escapeHtml15(turn.status)}">
+  <div class="turn-header">
+    <div>
+      <p class="eyebrow">${escapeHtml15(turn.sessionId)} \xB7 ${escapeHtml15(turn.turnId)}</p>
+      <h2>${escapeHtml15(turn.text || "Empty turn")}</h2>
+    </div>
+    <strong>${escapeHtml15(turn.status)}</strong>
+  </div>
+  <dl>
+    <div><dt>Source</dt><dd>${escapeHtml15(turn.source ?? "unknown")}</dd></div>
+    <div><dt>Confidence</dt><dd>${turn.averageConfidence === undefined ? "n/a" : `${Math.round(turn.averageConfidence * 100)}%`}</dd></div>
+    <div><dt>Fallback</dt><dd>${turn.fallbackUsed ? `yes (${escapeHtml15(turn.fallbackSelectionReason ?? "selected")})` : "no"}</dd></div>
+    <div><dt>Correction</dt><dd>${turn.correctionChanged ? `changed${turn.correctionProvider ? ` by ${escapeHtml15(turn.correctionProvider)}` : ""}` : "none"}</dd></div>
+    <div><dt>Transcripts</dt><dd>${String(turn.selectedTranscriptCount)} selected \xB7 ${String(turn.finalTranscriptCount)} final \xB7 ${String(turn.partialTranscriptCount)} partial</dd></div>
+    <div><dt>Cost</dt><dd>${turn.costUnits === undefined ? "n/a" : String(turn.costUnits)}</dd></div>
+  </dl>
+</article>`).join("");
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml15(title)}</title><style>body{background:#101316;color:#f6f2e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1180px;padding:32px}.hero,.turn{background:#181d22;border:1px solid #2a323a;border-radius:20px;margin-bottom:16px;padding:20px}.hero{background:linear-gradient(135deg,rgba(251,191,36,.16),rgba(34,197,94,.1))}.eyebrow{color:#fbbf24;font-size:.78rem;font-weight:900;letter-spacing:.08em;text-transform:uppercase}h1{font-size:clamp(2.3rem,6vw,5rem);letter-spacing:-.06em;line-height:.9;margin:.2rem 0 1rem}h2{margin:.2rem 0 1rem}.summary{display:flex;flex-wrap:wrap;gap:10px}.pill{background:#0f1217;border:1px solid #3f3f46;border-radius:999px;padding:7px 10px}.turn-header{align-items:flex-start;display:flex;gap:16px;justify-content:space-between}.pass{color:#86efac}.warn,.unknown{color:#fde68a}.fail{color:#fca5a5}.turn.fail{border-color:rgba(248,113,113,.45)}dl{display:grid;gap:8px;grid-template-columns:repeat(auto-fit,minmax(160px,1fr))}dt{color:#a8b0b8;font-size:.8rem}dd{margin:0}@media(max-width:800px){main{padding:18px}.turn-header{display:block}}</style></head><body><main><section class="hero"><p class="eyebrow">Realtime STT Debugging</p><h1>${escapeHtml15(title)}</h1><div class="summary"><span class="pill ${escapeHtml15(report.status)}">${escapeHtml15(report.status)}</span><span class="pill">${String(report.total)} turns</span><span class="pill">${String(report.warnings)} warnings</span><span class="pill">${String(report.failed)} failed</span><span class="pill">${String(report.sessions)} sessions</span></div></section>${turns || '<section class="turn"><p>No committed turns found.</p></section>'}</main></body></html>`;
+};
+var createVoiceTurnQualityJSONHandler = (options) => async () => summarizeVoiceTurnQuality(options);
+var createVoiceTurnQualityHTMLHandler = (options) => async () => {
+  const report = await summarizeVoiceTurnQuality(options);
+  const render = options.render ?? ((input) => renderVoiceTurnQualityHTML(input, options));
+  const body = await render(report);
+  return new Response(body, {
+    headers: {
+      "Content-Type": "text/html; charset=utf-8",
+      ...options.headers
+    }
+  });
+};
+var createVoiceTurnQualityRoutes = (options) => {
+  const path = options.path ?? "/api/turn-quality";
+  const htmlPath = options.htmlPath === undefined ? `${path}/htmx` : options.htmlPath;
+  const routes = new Elysia14({
+    name: options.name ?? "absolutejs-voice-turn-quality"
+  }).get(path, createVoiceTurnQualityJSONHandler(options));
+  if (htmlPath) {
+    routes.get(htmlPath, createVoiceTurnQualityHTMLHandler(options));
+  }
+  return routes;
+};
 // src/fileStore.ts
 import { mkdir as mkdir2, readFile, readdir, rename, rm, writeFile } from "fs/promises";
 import { join } from "path";
@@ -12387,7 +12503,7 @@ var createVoiceMemoryStore = () => {
   return { get, getOrCreate, list, remove, set };
 };
 // src/opsWebhook.ts
-import { Elysia as Elysia14 } from "elysia";
+import { Elysia as Elysia15 } from "elysia";
 var toHex5 = (bytes) => Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
 var signVoiceOpsWebhookBody = async (input) => {
   const encoder = new TextEncoder;
@@ -12517,7 +12633,7 @@ var verifyVoiceOpsWebhookSignature = async (input) => {
 };
 var createVoiceOpsWebhookReceiverRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice-ops/webhook";
-  return new Elysia14().post(path, async ({ body, request, set }) => {
+  return new Elysia15().post(path, async ({ body, request, set }) => {
     const bodyText = typeof body === "string" ? body : JSON.stringify(body);
     if (options.signingSecret) {
       const verification = await verifyVoiceOpsWebhookSignature({
@@ -14664,6 +14780,7 @@ export {
   validateVoiceWorkflowRouteResult,
   transcodeTwilioInboundPayloadToPCM16,
   transcodePCMToTwilioOutboundPayload,
+  summarizeVoiceTurnQuality,
   summarizeVoiceTraceSinkDeliveries,
   summarizeVoiceTrace,
   summarizeVoiceSessions,
@@ -14703,6 +14820,7 @@ export {
   resolveAudioConditioningConfig,
   requeueVoiceOpsTask,
   reopenVoiceOpsTask,
+  renderVoiceTurnQualityHTML,
   renderVoiceTraceMarkdown,
   renderVoiceTraceHTML,
   renderVoiceToolContractHTML,
@@ -14757,6 +14875,9 @@ export {
   createVoiceWebhookDeliveryWorkerLoop,
   createVoiceWebhookDeliveryWorker,
   createVoiceTwilioRedirectHandoffAdapter,
+  createVoiceTurnQualityRoutes,
+  createVoiceTurnQualityJSONHandler,
+  createVoiceTurnQualityHTMLHandler,
   createVoiceTraceSinkStore,
   createVoiceTraceSinkDeliveryWorkerLoop,
   createVoiceTraceSinkDeliveryWorker,

package/dist/react/VoiceTurnQuality.d.ts

@@ -0,0 +1,6 @@
+import { type VoiceTurnQualityWidgetOptions } from '../client/turnQualityWidget';
+export type VoiceTurnQualityProps = VoiceTurnQualityWidgetOptions & {
+    className?: string;
+    path?: string;
+};
+export declare const VoiceTurnQuality: ({ className, path, ...options }: VoiceTurnQualityProps) => import("react/jsx-runtime").JSX.Element;

package/dist/react/index.d.ts

@@ -3,6 +3,7 @@ export { VoiceProviderSimulationControls } from './VoiceProviderSimulationContro
 export { VoiceProviderCapabilities } from './VoiceProviderCapabilities';
 export { VoiceProviderStatus } from './VoiceProviderStatus';
 export { VoiceRoutingStatus } from './VoiceRoutingStatus';
+export { VoiceTurnQuality } from './VoiceTurnQuality';
 export { useVoiceAppKitStatus } from './useVoiceAppKitStatus';
 export { useVoiceStream } from './useVoiceStream';
 export { useVoiceController } from './useVoiceController';
@@ -10,4 +11,5 @@ export { useVoiceProviderStatus } from './useVoiceProviderStatus';
 export { useVoiceProviderCapabilities } from './useVoiceProviderCapabilities';
 export { useVoiceProviderSimulationControls } from './useVoiceProviderSimulationControls';
 export { useVoiceRoutingStatus } from './useVoiceRoutingStatus';
+export { useVoiceTurnQuality } from './useVoiceTurnQuality';
 export { useVoiceWorkflowStatus } from './useVoiceWorkflowStatus';

package/dist/react/index.js

@@ -1495,9 +1495,299 @@ var VoiceRoutingStatus = ({
     ]
   }, undefined, true, undefined, this);
 };
-// src/react/useVoiceStream.tsx
+// src/react/useVoiceTurnQuality.tsx
 import { useEffect as useEffect6, useRef as useRef6, useSyncExternalStore as useSyncExternalStore6 } from "react";
 
+// src/client/turnQuality.ts
+var fetchVoiceTurnQuality = async (path = "/api/turn-quality", options = {}) => {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const response = await fetchImpl(path);
+  if (!response.ok) {
+    throw new Error(`Voice turn quality failed: HTTP ${response.status}`);
+  }
+  return await response.json();
+};
+var createVoiceTurnQualityStore = (path = "/api/turn-quality", options = {}) => {
+  const listeners = new Set;
+  let closed = false;
+  let timer;
+  let snapshot = {
+    error: null,
+    isLoading: false
+  };
+  const emit = () => {
+    for (const listener of listeners) {
+      listener();
+    }
+  };
+  const refresh = async () => {
+    if (closed) {
+      return snapshot.report;
+    }
+    snapshot = {
+      ...snapshot,
+      error: null,
+      isLoading: true
+    };
+    emit();
+    try {
+      const report = await fetchVoiceTurnQuality(path, options);
+      snapshot = {
+        error: null,
+        isLoading: false,
+        report,
+        updatedAt: Date.now()
+      };
+      emit();
+      return report;
+    } catch (error) {
+      snapshot = {
+        ...snapshot,
+        error: error instanceof Error ? error.message : String(error),
+        isLoading: false
+      };
+      emit();
+      throw error;
+    }
+  };
+  const close = () => {
+    closed = true;
+    if (timer) {
+      clearInterval(timer);
+      timer = undefined;
+    }
+    listeners.clear();
+  };
+  if (options.intervalMs && options.intervalMs > 0) {
+    timer = setInterval(() => {
+      refresh().catch(() => {});
+    }, options.intervalMs);
+  }
+  return {
+    close,
+    getServerSnapshot: () => snapshot,
+    getSnapshot: () => snapshot,
+    refresh,
+    subscribe: (listener) => {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+  };
+};
+
+// src/react/useVoiceTurnQuality.tsx
+var useVoiceTurnQuality = (path = "/api/turn-quality", options = {}) => {
+  const storeRef = useRef6(null);
+  if (!storeRef.current) {
+    storeRef.current = createVoiceTurnQualityStore(path, options);
+  }
+  const store = storeRef.current;
+  useEffect6(() => {
+    store.refresh().catch(() => {});
+    return () => store.close();
+  }, [store]);
+  return {
+    ...useSyncExternalStore6(store.subscribe, store.getSnapshot, store.getServerSnapshot),
+    refresh: store.refresh
+  };
+};
+
+// src/client/turnQualityWidget.ts
+var DEFAULT_TITLE5 = "Turn Quality";
+var DEFAULT_DESCRIPTION5 = "Per-turn STT confidence, fallback selection, corrections, and transcript coverage.";
+var escapeHtml6 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var formatConfidence = (value) => typeof value === "number" ? `${Math.round(value * 100)}%` : "n/a";
+var formatMaybe = (value) => value === undefined || value === "" ? "n/a" : String(value);
+var getTurnDetail = (turn) => {
+  if (turn.status === "fail") {
+    return "Empty or unusable committed turn; inspect transcripts and adapter events.";
+  }
+  if (turn.fallbackUsed) {
+    return `Fallback STT selected${turn.fallbackSelectionReason ? ` by ${turn.fallbackSelectionReason}` : ""}.`;
+  }
+  if (turn.correctionChanged) {
+    return `Correction changed the turn${turn.correctionProvider ? ` via ${turn.correctionProvider}` : ""}.`;
+  }
+  if (turn.status === "warn") {
+    return "Turn completed with quality warnings.";
+  }
+  if (turn.status === "unknown") {
+    return "No quality diagnostics were recorded for this turn.";
+  }
+  return "Turn quality looks healthy.";
+};
+var createVoiceTurnQualityViewModel = (snapshot, options = {}) => {
+  const turns = (snapshot.report?.turns ?? []).map((turn) => ({
+    ...turn,
+    detail: getTurnDetail(turn),
+    label: turn.text || "Empty turn",
+    rows: [
+      { label: "Source", value: turn.source ?? "unknown" },
+      { label: "Confidence", value: formatConfidence(turn.averageConfidence) },
+      { label: "Fallback", value: turn.fallbackUsed ? "Yes" : "No" },
+      { label: "Correction", value: turn.correctionChanged ? "Changed" : "None" },
+      { label: "Transcripts", value: `${turn.selectedTranscriptCount} selected` },
+      { label: "Cost", value: formatMaybe(turn.costUnits) }
+    ]
+  }));
+  const warningCount = snapshot.report?.warnings ?? turns.filter((turn) => turn.status === "warn").length;
+  const failedCount = snapshot.report?.failed ?? turns.filter((turn) => turn.status === "fail").length;
+  return {
+    description: options.description ?? DEFAULT_DESCRIPTION5,
+    error: snapshot.error,
+    isLoading: snapshot.isLoading,
+    label: snapshot.error ? "Unavailable" : turns.length ? failedCount > 0 ? `${failedCount} failed` : warningCount > 0 ? `${warningCount} warnings` : `${turns.length} healthy` : snapshot.isLoading ? "Checking" : "No turns",
+    status: snapshot.error ? "error" : turns.length ? failedCount > 0 || warningCount > 0 ? "warning" : "ready" : snapshot.isLoading ? "loading" : "empty",
+    title: options.title ?? DEFAULT_TITLE5,
+    turns,
+    updatedAt: snapshot.updatedAt
+  };
+};
+var renderVoiceTurnQualityHTML = (snapshot, options = {}) => {
+  const model = createVoiceTurnQualityViewModel(snapshot, options);
+  const turns = model.turns.length ? `<div class="absolute-voice-turn-quality__turns">${model.turns.map((turn) => `<article class="absolute-voice-turn-quality__turn absolute-voice-turn-quality__turn--${escapeHtml6(turn.status)}">
+  <header>
+    <strong>${escapeHtml6(turn.label)}</strong>
+    <span>${escapeHtml6(turn.status)}</span>
+  </header>
+  <p>${escapeHtml6(turn.detail)}</p>
+  <dl>${turn.rows.map((row) => `<div>
+    <dt>${escapeHtml6(row.label)}</dt>
+    <dd>${escapeHtml6(row.value)}</dd>
+  </div>`).join("")}</dl>
+</article>`).join("")}</div>` : '<p class="absolute-voice-turn-quality__empty">Complete a voice turn to see STT quality diagnostics.</p>';
+  return `<section class="absolute-voice-turn-quality absolute-voice-turn-quality--${escapeHtml6(model.status)}">
+  <header class="absolute-voice-turn-quality__header">
+    <span class="absolute-voice-turn-quality__eyebrow">${escapeHtml6(model.title)}</span>
+    <strong class="absolute-voice-turn-quality__label">${escapeHtml6(model.label)}</strong>
+  </header>
+  <p class="absolute-voice-turn-quality__description">${escapeHtml6(model.description)}</p>
+  ${turns}
+  ${model.error ? `<p class="absolute-voice-turn-quality__error">${escapeHtml6(model.error)}</p>` : ""}
+</section>`;
+};
+var getVoiceTurnQualityCSS = () => `.absolute-voice-turn-quality{border:1px solid #e4d1a3;border-radius:20px;background:#fff9eb;color:#17120a;padding:18px;box-shadow:0 18px 40px rgba(73,48,14,.12);font-family:inherit}.absolute-voice-turn-quality--error,.absolute-voice-turn-quality--warning{border-color:#f2a7a7;background:#fff5f3}.absolute-voice-turn-quality__header,.absolute-voice-turn-quality__turn header{align-items:start;display:flex;gap:12px;justify-content:space-between}.absolute-voice-turn-quality__eyebrow{color:#8a5a0a;font-size:12px;font-weight:800;letter-spacing:.08em;text-transform:uppercase}.absolute-voice-turn-quality__label{font-size:24px;line-height:1}.absolute-voice-turn-quality__description,.absolute-voice-turn-quality__turn p,.absolute-voice-turn-quality__turn dt,.absolute-voice-turn-quality__empty{color:#5a4930}.absolute-voice-turn-quality__turns{display:grid;gap:12px;margin-top:14px}.absolute-voice-turn-quality__turn{background:#fff;border:1px solid #f0dfba;border-radius:16px;padding:14px}.absolute-voice-turn-quality__turn--pass{border-color:#86efac}.absolute-voice-turn-quality__turn--warn,.absolute-voice-turn-quality__turn--unknown{border-color:#fbbf24}.absolute-voice-turn-quality__turn--fail{border-color:#f2a7a7}.absolute-voice-turn-quality__turn p{margin:10px 0}.absolute-voice-turn-quality__turn dl{display:grid;gap:8px;grid-template-columns:repeat(2,minmax(0,1fr));margin:0}.absolute-voice-turn-quality__turn div{background:#fff9eb;border:1px solid #f0dfba;border-radius:12px;padding:8px}.absolute-voice-turn-quality__turn dt{font-size:12px}.absolute-voice-turn-quality__turn dd{font-weight:800;margin:4px 0 0}.absolute-voice-turn-quality__empty{margin:14px 0 0}.absolute-voice-turn-quality__error{color:#9f1239;font-weight:700}`;
+var mountVoiceTurnQuality = (element, path = "/api/turn-quality", options = {}) => {
+  const store = createVoiceTurnQualityStore(path, options);
+  const render = () => {
+    element.innerHTML = renderVoiceTurnQualityHTML(store.getSnapshot(), options);
+  };
+  const unsubscribe = store.subscribe(render);
+  render();
+  store.refresh().catch(() => {});
+  return {
+    close: () => {
+      unsubscribe();
+      store.close();
+    },
+    refresh: store.refresh
+  };
+};
+var defineVoiceTurnQualityElement = (tagName = "absolute-voice-turn-quality") => {
+  if (typeof window === "undefined" || typeof customElements === "undefined" || customElements.get(tagName)) {
+    return;
+  }
+  customElements.define(tagName, class AbsoluteVoiceTurnQualityElement extends HTMLElement {
+    mounted;
+    connectedCallback() {
+      const intervalMs = Number(this.getAttribute("interval-ms") ?? 5000);
+      this.mounted = mountVoiceTurnQuality(this, this.getAttribute("path") ?? "/api/turn-quality", {
+        description: this.getAttribute("description") ?? undefined,
+        intervalMs: Number.isFinite(intervalMs) ? intervalMs : 5000,
+        title: this.getAttribute("title") ?? undefined
+      });
+    }
+    disconnectedCallback() {
+      this.mounted?.close();
+      this.mounted = undefined;
+    }
+  });
+};
+
+// src/react/VoiceTurnQuality.tsx
+import { jsxDEV as jsxDEV6 } from "react/jsx-dev-runtime";
+var VoiceTurnQuality = ({
+  className,
+  path = "/api/turn-quality",
+  ...options
+}) => {
+  const snapshot = useVoiceTurnQuality(path, options);
+  const model = createVoiceTurnQualityViewModel(snapshot, options);
+  return /* @__PURE__ */ jsxDEV6("section", {
+    className: [
+      "absolute-voice-turn-quality",
+      `absolute-voice-turn-quality--${model.status}`,
+      className
+    ].filter(Boolean).join(" "),
+    children: [
+      /* @__PURE__ */ jsxDEV6("header", {
+        className: "absolute-voice-turn-quality__header",
+        children: [
+          /* @__PURE__ */ jsxDEV6("span", {
+            className: "absolute-voice-turn-quality__eyebrow",
+            children: model.title
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV6("strong", {
+            className: "absolute-voice-turn-quality__label",
+            children: model.label
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV6("p", {
+        className: "absolute-voice-turn-quality__description",
+        children: model.description
+      }, undefined, false, undefined, this),
+      model.turns.length ? /* @__PURE__ */ jsxDEV6("div", {
+        className: "absolute-voice-turn-quality__turns",
+        children: model.turns.map((turn) => /* @__PURE__ */ jsxDEV6("article", {
+          className: [
+            "absolute-voice-turn-quality__turn",
+            `absolute-voice-turn-quality__turn--${turn.status}`
+          ].join(" "),
+          children: [
+            /* @__PURE__ */ jsxDEV6("header", {
+              children: [
+                /* @__PURE__ */ jsxDEV6("strong", {
+                  children: turn.label
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV6("span", {
+                  children: turn.status
+                }, undefined, false, undefined, this)
+              ]
+            }, undefined, true, undefined, this),
+            /* @__PURE__ */ jsxDEV6("p", {
+              children: turn.detail
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsxDEV6("dl", {
+              children: turn.rows.map((row) => /* @__PURE__ */ jsxDEV6("div", {
+                children: [
+                  /* @__PURE__ */ jsxDEV6("dt", {
+                    children: row.label
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV6("dd", {
+                    children: row.value
+                  }, undefined, false, undefined, this)
+                ]
+              }, row.label, true, undefined, this))
+            }, undefined, false, undefined, this)
+          ]
+        }, `${turn.sessionId}:${turn.turnId}`, true, undefined, this))
+      }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV6("p", {
+        className: "absolute-voice-turn-quality__empty",
+        children: "Complete a voice turn to see STT quality diagnostics."
+      }, undefined, false, undefined, this),
+      model.error ? /* @__PURE__ */ jsxDEV6("p", {
+        className: "absolute-voice-turn-quality__error",
+        children: model.error
+      }, undefined, false, undefined, this) : null
+    ]
+  }, undefined, true, undefined, this);
+};
+// src/react/useVoiceStream.tsx
+import { useEffect as useEffect7, useRef as useRef7, useSyncExternalStore as useSyncExternalStore7 } from "react";
+
 // src/client/actions.ts
 var normalizeErrorMessage = (value) => {
   if (typeof value === "string" && value.trim()) {
@@ -2024,13 +2314,13 @@ var EMPTY_SNAPSHOT = {
   turns: []
 };
 var useVoiceStream = (path, options = {}) => {
-  const streamRef = useRef6(null);
+  const streamRef = useRef7(null);
   if (!streamRef.current) {
     streamRef.current = createVoiceStream(path, options);
   }
   const stream = streamRef.current;
-  useEffect6(() => () => stream.close(), [stream]);
-  const snapshot = useSyncExternalStore6(stream.subscribe, stream.getSnapshot, stream.getServerSnapshot) ?? EMPTY_SNAPSHOT;
+  useEffect7(() => () => stream.close(), [stream]);
+  const snapshot = useSyncExternalStore7(stream.subscribe, stream.getSnapshot, stream.getServerSnapshot) ?? EMPTY_SNAPSHOT;
   return {
     ...snapshot,
     callControl: (message) => stream.callControl(message),
@@ -2040,7 +2330,7 @@ var useVoiceStream = (path, options = {}) => {
   };
 };
 // src/react/useVoiceController.tsx
-import { useEffect as useEffect7, useRef as useRef7, useSyncExternalStore as useSyncExternalStore7 } from "react";
+import { useEffect as useEffect8, useRef as useRef8, useSyncExternalStore as useSyncExternalStore8 } from "react";
 
 // src/client/htmx.ts
 var DEFAULT_EVENT_NAME = "voice-refresh";
@@ -2687,13 +2977,13 @@ var EMPTY_SNAPSHOT2 = {
   turns: []
 };
 var useVoiceController = (path, options = {}) => {
-  const controllerRef = useRef7(null);
+  const controllerRef = useRef8(null);
   if (!controllerRef.current) {
     controllerRef.current = createVoiceController(path, options);
   }
   const controller = controllerRef.current;
-  useEffect7(() => () => controller.close(), [controller]);
-  const snapshot = useSyncExternalStore7(controller.subscribe, controller.getSnapshot, controller.getServerSnapshot) ?? EMPTY_SNAPSHOT2;
+  useEffect8(() => () => controller.close(), [controller]);
+  const snapshot = useSyncExternalStore8(controller.subscribe, controller.getSnapshot, controller.getServerSnapshot) ?? EMPTY_SNAPSHOT2;
   return {
     ...snapshot,
     bindHTMX: controller.bindHTMX,
@@ -2707,7 +2997,7 @@ var useVoiceController = (path, options = {}) => {
   };
 };
 // src/react/useVoiceWorkflowStatus.tsx
-import { useEffect as useEffect8, useRef as useRef8, useSyncExternalStore as useSyncExternalStore8 } from "react";
+import { useEffect as useEffect9, useRef as useRef9, useSyncExternalStore as useSyncExternalStore9 } from "react";
 
 // src/client/workflowStatus.ts
 var fetchVoiceWorkflowStatus = async (path = "/evals/scenarios/json", options = {}) => {
@@ -2790,22 +3080,23 @@ var createVoiceWorkflowStatusStore = (path = "/evals/scenarios/json", options =
 
 // src/react/useVoiceWorkflowStatus.tsx
 var useVoiceWorkflowStatus = (path = "/evals/scenarios/json", options = {}) => {
-  const storeRef = useRef8(null);
+  const storeRef = useRef9(null);
   if (!storeRef.current) {
     storeRef.current = createVoiceWorkflowStatusStore(path, options);
   }
   const store = storeRef.current;
-  useEffect8(() => {
+  useEffect9(() => {
     store.refresh().catch(() => {});
     return () => store.close();
   }, [store]);
   return {
-    ...useSyncExternalStore8(store.subscribe, store.getSnapshot, store.getServerSnapshot),
+    ...useSyncExternalStore9(store.subscribe, store.getSnapshot, store.getServerSnapshot),
     refresh: store.refresh
   };
 };
 export {
   useVoiceWorkflowStatus,
+  useVoiceTurnQuality,
   useVoiceStream,
   useVoiceRoutingStatus,
   useVoiceProviderStatus,
@@ -2813,6 +3104,7 @@ export {
   useVoiceProviderCapabilities,
   useVoiceController,
   useVoiceAppKitStatus,
+  VoiceTurnQuality,
   VoiceRoutingStatus,
   VoiceProviderStatus,
   VoiceProviderSimulationControls,

package/dist/react/useVoiceTurnQuality.d.ts

@@ -0,0 +1,8 @@
+import { type VoiceTurnQualityClientOptions } from '../client/turnQuality';
+export declare const useVoiceTurnQuality: (path?: string, options?: VoiceTurnQualityClientOptions) => {
+    refresh: () => Promise<import("..").VoiceTurnQualityReport | undefined>;
+    error: string | null;
+    isLoading: boolean;
+    report?: import("..").VoiceTurnQualityReport;
+    updatedAt?: number;
+};

package/dist/svelte/createVoiceTurnQuality.d.ts

@@ -0,0 +1,10 @@
+import { type VoiceTurnQualityWidgetOptions } from '../client/turnQualityWidget';
+export declare const createVoiceTurnQuality: (path?: string, options?: VoiceTurnQualityWidgetOptions) => {
+    getHTML: () => string;
+    getViewModel: () => import("../client").VoiceTurnQualityViewModel;
+    close: () => void;
+    getServerSnapshot: () => import("../client").VoiceTurnQualitySnapshot;
+    getSnapshot: () => import("../client").VoiceTurnQualitySnapshot;
+    refresh: () => Promise<import("..").VoiceTurnQualityReport | undefined>;
+    subscribe: (listener: () => void) => () => void;
+};

package/dist/svelte/index.d.ts

@@ -5,5 +5,6 @@ export { createVoiceProviderCapabilities } from './createVoiceProviderCapabiliti
 export { createVoiceStream } from './createVoiceStream';
 export { createVoiceProviderStatus } from './createVoiceProviderStatus';
 export { createVoiceRoutingStatus } from './createVoiceRoutingStatus';
+export { createVoiceTurnQuality } from './createVoiceTurnQuality';
 export { createVoiceWorkflowStatus } from './createVoiceWorkflowStatus';
 export { createVoiceController } from '../client/controller';