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

package/dist/angular/index.d.ts

@@ -4,4 +4,5 @@ export { VoiceControllerService } from './voice-controller.service';
 export { VoiceProviderCapabilitiesService } from './voice-provider-capabilities.service';
 export { VoiceProviderStatusService } from './voice-provider-status.service';
 export { VoiceRoutingStatusService } from './voice-routing-status.service';
+export { VoiceTurnQualityService } from './voice-turn-quality.service';
 export { VoiceWorkflowStatusService } from './voice-workflow-status.service';

package/dist/angular/index.js

@@ -1826,9 +1826,131 @@ VoiceRoutingStatusService = __decorateElement(_init, 0, "VoiceRoutingStatusServi
 __runInitializers(_init, 1, VoiceRoutingStatusService);
 __decoratorMetadata(_init, VoiceRoutingStatusService);
 let _VoiceRoutingStatusService = VoiceRoutingStatusService;
-// src/angular/voice-workflow-status.service.ts
+// src/angular/voice-turn-quality.service.ts
 import { computed as computed6, Injectable as Injectable7, signal as signal7 } from "@angular/core";
 
+// 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/angular/voice-turn-quality.service.ts
+var _dec = [
+  Injectable7({ providedIn: "root" })
+];
+var _init = __decoratorStart(undefined);
+
+class VoiceTurnQualityService {
+  connect(path = "/api/turn-quality", options = {}) {
+    const store = createVoiceTurnQualityStore(path, options);
+    const errorSignal = signal7(null);
+    const isLoadingSignal = signal7(false);
+    const reportSignal = signal7(undefined);
+    const updatedAtSignal = signal7(undefined);
+    const sync = () => {
+      const snapshot = store.getSnapshot();
+      errorSignal.set(snapshot.error);
+      isLoadingSignal.set(snapshot.isLoading);
+      reportSignal.set(snapshot.report);
+      updatedAtSignal.set(snapshot.updatedAt);
+    };
+    const unsubscribe = store.subscribe(sync);
+    sync();
+    store.refresh().catch(() => {});
+    return {
+      close: () => {
+        unsubscribe();
+        store.close();
+      },
+      error: computed6(() => errorSignal()),
+      isLoading: computed6(() => isLoadingSignal()),
+      refresh: store.refresh,
+      report: computed6(() => reportSignal()),
+      updatedAt: computed6(() => updatedAtSignal())
+    };
+  }
+}
+VoiceTurnQualityService = __decorateElement(_init, 0, "VoiceTurnQualityService", _dec, VoiceTurnQualityService);
+__runInitializers(_init, 1, VoiceTurnQualityService);
+__decoratorMetadata(_init, VoiceTurnQualityService);
+let _VoiceTurnQualityService = VoiceTurnQualityService;
+// src/angular/voice-workflow-status.service.ts
+import { computed as computed7, Injectable as Injectable8, signal as signal8 } from "@angular/core";
+
 // src/client/workflowStatus.ts
 var fetchVoiceWorkflowStatus = async (path = "/evals/scenarios/json", options = {}) => {
   const fetchImpl = options.fetch ?? globalThis.fetch;
@@ -1910,17 +2032,17 @@ var createVoiceWorkflowStatusStore = (path = "/evals/scenarios/json", options =
 
 // src/angular/voice-workflow-status.service.ts
 var _dec = [
-  Injectable7({ providedIn: "root" })
+  Injectable8({ providedIn: "root" })
 ];
 var _init = __decoratorStart(undefined);
 
 class VoiceWorkflowStatusService {
   connect(path = "/evals/scenarios/json", options = {}) {
     const store = createVoiceWorkflowStatusStore(path, options);
-    const errorSignal = signal7(null);
-    const isLoadingSignal = signal7(false);
-    const reportSignal = signal7(undefined);
-    const updatedAtSignal = signal7(undefined);
+    const errorSignal = signal8(null);
+    const isLoadingSignal = signal8(false);
+    const reportSignal = signal8(undefined);
+    const updatedAtSignal = signal8(undefined);
     const sync = () => {
       const snapshot = store.getSnapshot();
       errorSignal.set(snapshot.error);
@@ -1938,11 +2060,11 @@ class VoiceWorkflowStatusService {
         unsubscribe();
         store.close();
       },
-      error: computed6(() => errorSignal()),
-      isLoading: computed6(() => isLoadingSignal()),
+      error: computed7(() => errorSignal()),
+      isLoading: computed7(() => isLoadingSignal()),
       refresh: store.refresh,
-      report: computed6(() => reportSignal()),
-      updatedAt: computed6(() => updatedAtSignal())
+      report: computed7(() => reportSignal()),
+      updatedAt: computed7(() => updatedAtSignal())
     };
   }
 }
@@ -1952,6 +2074,7 @@ __decoratorMetadata(_init, VoiceWorkflowStatusService);
 let _VoiceWorkflowStatusService = VoiceWorkflowStatusService;
 export {
   VoiceWorkflowStatusService,
+  VoiceTurnQualityService,
   VoiceStreamService,
   VoiceRoutingStatusService,
   VoiceProviderStatusService,

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

@@ -0,0 +1,12 @@
+import { type VoiceTurnQualityClientOptions } from '../client/turnQuality';
+import type { VoiceTurnQualityReport } from '../turnQuality';
+export declare class VoiceTurnQualityService {
+    connect(path?: string, options?: VoiceTurnQualityClientOptions): {
+        close: () => void;
+        error: import("@angular/core").Signal<string | null>;
+        isLoading: import("@angular/core").Signal<boolean>;
+        refresh: () => Promise<VoiceTurnQualityReport | undefined>;
+        report: import("@angular/core").Signal<VoiceTurnQualityReport | undefined>;
+        updatedAt: import("@angular/core").Signal<number | undefined>;
+    };
+}

package/dist/client/index.d.ts

@@ -11,10 +11,12 @@ export { createVoiceRoutingStatusStore, fetchVoiceRoutingStatus } from './routin
 export { createVoiceRoutingStatusViewModel, defineVoiceRoutingStatusElement, getVoiceRoutingStatusCSS, mountVoiceRoutingStatus, renderVoiceRoutingStatusHTML } from './routingStatusWidget';
 export { createVoiceProviderStatusStore, fetchVoiceProviderStatus } from './providerStatus';
 export { createVoiceProviderCapabilitiesStore, fetchVoiceProviderCapabilities } from './providerCapabilities';
+export { createVoiceTurnQualityStore, fetchVoiceTurnQuality } from './turnQuality';
 export { createVoiceProviderSimulationControlsStore } from './providerSimulationControls';
 export { bindVoiceProviderSimulationControls, createVoiceProviderSimulationControlsViewModel, defineVoiceProviderSimulationControlsElement, mountVoiceProviderSimulationControls, renderVoiceProviderSimulationControlsHTML } from './providerSimulationControlsWidget';
 export { createVoiceProviderStatusViewModel, defineVoiceProviderStatusElement, getVoiceProviderStatusCSS, mountVoiceProviderStatus, renderVoiceProviderStatusHTML } from './providerStatusWidget';
 export { createVoiceProviderCapabilitiesViewModel, defineVoiceProviderCapabilitiesElement, getVoiceProviderCapabilitiesCSS, mountVoiceProviderCapabilities, renderVoiceProviderCapabilitiesHTML } from './providerCapabilitiesWidget';
+export { createVoiceTurnQualityViewModel, defineVoiceTurnQualityElement, getVoiceTurnQualityCSS, mountVoiceTurnQuality, renderVoiceTurnQualityHTML } from './turnQualityWidget';
 export { createVoiceWorkflowStatusStore, fetchVoiceWorkflowStatus } from './workflowStatus';
 export type { VoiceAppKitStatusClientOptions, VoiceAppKitStatusSnapshot } from './appKitStatus';
 export type { VoiceOpsStatusSurfaceView, VoiceOpsStatusViewModel, VoiceOpsStatusWidgetOptions } from './opsStatusWidget';
@@ -22,8 +24,10 @@ export type { VoiceRoutingStatusClientOptions, VoiceRoutingStatusSnapshot } from
 export type { VoiceRoutingStatusViewModel, VoiceRoutingStatusWidgetOptions } from './routingStatusWidget';
 export type { VoiceProviderStatusClientOptions, VoiceProviderStatusSnapshot } from './providerStatus';
 export type { VoiceProviderCapabilitiesClientOptions, VoiceProviderCapabilitiesSnapshot } from './providerCapabilities';
+export type { VoiceTurnQualityClientOptions, VoiceTurnQualitySnapshot } from './turnQuality';
 export type { VoiceProviderSimulationControlsOptions, VoiceProviderSimulationControlsSnapshot, VoiceProviderSimulationProvider } from './providerSimulationControls';
 export type { VoiceProviderSimulationControlsViewModel } from './providerSimulationControlsWidget';
 export type { VoiceProviderStatusCardView, VoiceProviderStatusViewModel, VoiceProviderStatusWidgetOptions } from './providerStatusWidget';
 export type { VoiceProviderCapabilitiesViewModel, VoiceProviderCapabilitiesWidgetOptions, VoiceProviderCapabilityCardView } from './providerCapabilitiesWidget';
+export type { VoiceTurnQualityCardView, VoiceTurnQualityViewModel, VoiceTurnQualityWidgetOptions } from './turnQualityWidget';
 export type { VoiceWorkflowStatusClientOptions, VoiceWorkflowStatusSnapshot } from './workflowStatus';

package/dist/client/index.js

@@ -2151,6 +2151,84 @@ var createVoiceProviderCapabilitiesStore = (path = "/api/provider-capabilities",
     }
   };
 };
+// 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/client/providerSimulationControls.ts
 var postSimulation = async (pathPrefix, mode, provider, fetchImpl) => {
   const response = await fetchImpl(`${pathPrefix}/${mode}?provider=${encodeURIComponent(provider)}`, { method: "POST" });
@@ -2558,6 +2636,117 @@ var defineVoiceProviderCapabilitiesElement = (tagName = "absolute-voice-provider
     }
   });
 };
+// 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/client/workflowStatus.ts
 var fetchVoiceWorkflowStatus = async (path = "/evals/scenarios/json", options = {}) => {
   const fetchImpl = options.fetch ?? globalThis.fetch;
@@ -2637,26 +2826,31 @@ var createVoiceWorkflowStatusStore = (path = "/evals/scenarios/json", options =
   };
 };
 export {
+  renderVoiceTurnQualityHTML,
   renderVoiceRoutingStatusHTML,
   renderVoiceProviderStatusHTML,
   renderVoiceProviderSimulationControlsHTML,
   renderVoiceProviderCapabilitiesHTML,
   renderVoiceOpsStatusHTML,
+  mountVoiceTurnQuality,
   mountVoiceRoutingStatus,
   mountVoiceProviderStatus,
   mountVoiceProviderSimulationControls,
   mountVoiceProviderCapabilities,
   mountVoiceOpsStatus,
+  getVoiceTurnQualityCSS,
   getVoiceRoutingStatusCSS,
   getVoiceProviderStatusCSS,
   getVoiceProviderCapabilitiesCSS,
   getVoiceOpsStatusLabel,
   getVoiceOpsStatusCSS,
   fetchVoiceWorkflowStatus,
+  fetchVoiceTurnQuality,
   fetchVoiceRoutingStatus,
   fetchVoiceProviderStatus,
   fetchVoiceProviderCapabilities,
   fetchVoiceAppKitStatus,
+  defineVoiceTurnQualityElement,
   defineVoiceRoutingStatusElement,
   defineVoiceProviderStatusElement,
   defineVoiceProviderSimulationControlsElement,
@@ -2664,6 +2858,8 @@ export {
   defineVoiceOpsStatusElement,
   decodeVoiceAudioChunk,
   createVoiceWorkflowStatusStore,
+  createVoiceTurnQualityViewModel,
+  createVoiceTurnQualityStore,
   createVoiceStream,
   createVoiceRoutingStatusViewModel,
   createVoiceRoutingStatusStore,

package/dist/client/turnQuality.d.ts

@@ -0,0 +1,19 @@
+import type { VoiceTurnQualityReport } from '../turnQuality';
+export type VoiceTurnQualityClientOptions = {
+    fetch?: typeof fetch;
+    intervalMs?: number;
+};
+export type VoiceTurnQualitySnapshot = {
+    error: string | null;
+    isLoading: boolean;
+    report?: VoiceTurnQualityReport;
+    updatedAt?: number;
+};
+export declare const fetchVoiceTurnQuality: (path?: string, options?: Pick<VoiceTurnQualityClientOptions, "fetch">) => Promise<VoiceTurnQualityReport>;
+export declare const createVoiceTurnQualityStore: (path?: string, options?: VoiceTurnQualityClientOptions) => {
+    close: () => void;
+    getServerSnapshot: () => VoiceTurnQualitySnapshot;
+    getSnapshot: () => VoiceTurnQualitySnapshot;
+    refresh: () => Promise<VoiceTurnQualityReport | undefined>;
+    subscribe: (listener: () => void) => () => void;
+};

package/dist/client/turnQualityWidget.d.ts

@@ -0,0 +1,32 @@
+import type { VoiceTurnQualityItem } from '../turnQuality';
+import { type VoiceTurnQualityClientOptions, type VoiceTurnQualitySnapshot } from './turnQuality';
+export type VoiceTurnQualityCardView = VoiceTurnQualityItem & {
+    detail: string;
+    label: string;
+    rows: Array<{
+        label: string;
+        value: string;
+    }>;
+};
+export type VoiceTurnQualityViewModel = {
+    description: string;
+    error: string | null;
+    isLoading: boolean;
+    label: string;
+    status: 'empty' | 'error' | 'loading' | 'ready' | 'warning';
+    title: string;
+    turns: VoiceTurnQualityCardView[];
+    updatedAt?: number;
+};
+export type VoiceTurnQualityWidgetOptions = VoiceTurnQualityClientOptions & {
+    description?: string;
+    title?: string;
+};
+export declare const createVoiceTurnQualityViewModel: (snapshot: VoiceTurnQualitySnapshot, options?: VoiceTurnQualityWidgetOptions) => VoiceTurnQualityViewModel;
+export declare const renderVoiceTurnQualityHTML: (snapshot: VoiceTurnQualitySnapshot, options?: VoiceTurnQualityWidgetOptions) => string;
+export declare const getVoiceTurnQualityCSS: () => string;
+export declare const mountVoiceTurnQuality: (element: Element, path?: string, options?: VoiceTurnQualityWidgetOptions) => {
+    close: () => void;
+    refresh: () => Promise<import("..").VoiceTurnQualityReport | undefined>;
+};
+export declare const defineVoiceTurnQualityElement: (tagName?: string) => void;

package/dist/index.d.ts

@@ -9,6 +9,7 @@ export { createVoiceSessionListRoutes, createVoiceSessionReplayHTMLHandler, crea
 export { createVoiceAgent, createVoiceAgentSquad, createVoiceAgentTool } from './agent';
 export { createVoiceToolIdempotencyKey, createVoiceToolRuntime } from './toolRuntime';
 export { createVoiceToolContract, createVoiceToolContractHTMLHandler, createVoiceToolContractJSONHandler, createVoiceToolContractRoutes, createVoiceToolRuntimeContractDefaults, renderVoiceToolContractHTML, runVoiceToolContractSuite, runVoiceToolContract } from './toolContract';
+export { createVoiceTurnQualityHTMLHandler, createVoiceTurnQualityJSONHandler, createVoiceTurnQualityRoutes, renderVoiceTurnQualityHTML, summarizeVoiceTurnQuality } from './turnQuality';
 export { createStoredVoiceCallReviewArtifact, createStoredVoiceExternalObjectMap, createStoredVoiceIntegrationEvent, createStoredVoiceOpsTask, createVoiceFileExternalObjectMapStore, createVoiceFileAssistantMemoryStore, createVoiceFileIntegrationEventStore, createVoiceFileReviewStore, createVoiceFileRuntimeStorage, createVoiceFileSessionStore, createVoiceFileTaskStore, createVoiceFileTraceSinkDeliveryStore, createVoiceFileTraceEventStore } from './fileStore';
 export { createVoiceAssistantMemoryHandle, createVoiceAssistantMemoryRecord, createVoiceMemoryAssistantMemoryStore, resolveVoiceAssistantMemoryNamespace } from './assistantMemory';
 export { createAnthropicVoiceAssistantModel, createGeminiVoiceAssistantModel, createJSONVoiceAssistantModel, createOpenAIVoiceAssistantModel, resolveVoiceProviderRoutingPolicyPreset, createVoiceProviderRouter } from './modelAdapters';
@@ -52,6 +53,7 @@ export type { VoiceSessionListHTMLHandlerOptions, VoiceSessionListItem, VoiceSes
 export type { AnthropicVoiceAssistantModelOptions, GeminiVoiceAssistantModelOptions, OpenAIVoiceAssistantModelOptions, VoiceProviderRouterEvent, VoiceProviderRouterFallbackMode, VoiceProviderRouterHealthOptions, VoiceProviderRouterOptions, VoiceProviderRouterPolicy, VoiceProviderRouterPolicyPreset, VoiceProviderRouterPolicyWeights, VoiceProviderRouterProviderHealth, VoiceProviderRouterProviderProfile, VoiceProviderRouterStrategy, VoiceJSONAssistantModelHandler, VoiceJSONAssistantModelOptions } from './modelAdapters';
 export type { VoiceProviderHealthStatus, VoiceProviderHealthSummary, VoiceProviderHealthSummaryOptions } from './providerHealth';
 export type { VoiceProviderCapabilityDefinition, VoiceProviderCapabilityHandlerOptions, VoiceProviderCapabilityHTMLHandlerOptions, VoiceProviderCapabilityKind, VoiceProviderCapabilityOptions, VoiceProviderCapabilityReport, VoiceProviderCapabilityRoutesOptions, VoiceProviderCapabilitySummary } from './providerCapabilities';
+export type { VoiceTurnQualityHTMLHandlerOptions, VoiceTurnQualityItem, VoiceTurnQualityOptions, VoiceTurnQualityReport, VoiceTurnQualityRoutesOptions, VoiceTurnQualityStatus } from './turnQuality';
 export type { VoiceOpsConsoleLink, VoiceOpsConsoleReport, VoiceOpsConsoleRoutesOptions } from './opsConsoleRoutes';
 export type { VoiceQualityLink, VoiceQualityMetric, VoiceQualityReport, VoiceQualityRoutesOptions, VoiceQualityStatus, VoiceQualityThresholds } from './qualityRoutes';
 export type { VoiceResilienceIOSimulator, VoiceResilienceLink, VoiceResiliencePageData, VoiceResilienceRoutesOptions, VoiceResilienceSimulationProvider, VoiceRoutingDecisionSummary, VoiceRoutingDecisionSummaryOptions, VoiceRoutingEvent, VoiceRoutingEventKind } from './resilienceRoutes';