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

package/dist/client/index.js

@@ -2073,6 +2073,162 @@ var createVoiceProviderStatusStore = (path = "/api/provider-status", options = {
     }
   };
 };
+// src/client/providerCapabilities.ts
+var fetchVoiceProviderCapabilities = async (path = "/api/provider-capabilities", options = {}) => {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const response = await fetchImpl(path);
+  if (!response.ok) {
+    throw new Error(`Voice provider capabilities failed: HTTP ${response.status}`);
+  }
+  return await response.json();
+};
+var createVoiceProviderCapabilitiesStore = (path = "/api/provider-capabilities", 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 fetchVoiceProviderCapabilities(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/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" });
@@ -2364,6 +2520,233 @@ var defineVoiceProviderStatusElement = (tagName = "absolute-voice-provider-statu
     }
   });
 };
+// src/client/providerCapabilitiesWidget.ts
+var DEFAULT_TITLE4 = "Provider Capabilities";
+var DEFAULT_DESCRIPTION4 = "Configured, selected, and healthy voice providers for this deployment.";
+var escapeHtml5 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var formatProvider2 = (provider) => provider.split(/[-_\s]+/).filter(Boolean).map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ") || provider;
+var formatKind2 = (kind) => kind.toUpperCase();
+var formatStatus2 = (status) => status.split("-").map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ");
+var getCapabilityDetail = (capability) => {
+  if (!capability.configured) {
+    return "Not configured in this deployment.";
+  }
+  if (capability.selected) {
+    return `Selected ${capability.kind.toUpperCase()} provider for new sessions.`;
+  }
+  if (capability.health?.status === "healthy") {
+    return "Configured and healthy fallback candidate.";
+  }
+  if (capability.health?.status === "idle") {
+    return "Configured; no traffic observed yet.";
+  }
+  if (capability.health?.lastError) {
+    return capability.health.lastError;
+  }
+  return "Configured and available.";
+};
+var isWarningStatus2 = (status) => status === "degraded" || status === "rate-limited" || status === "suppressed" || status === "unconfigured";
+var createVoiceProviderCapabilitiesViewModel = (snapshot, options = {}) => {
+  const capabilities = (snapshot.report?.capabilities ?? []).map((capability) => ({
+    ...capability,
+    detail: getCapabilityDetail(capability),
+    label: `${formatProvider2(capability.provider)} ${formatKind2(capability.kind)}`,
+    rows: [
+      { label: "Status", value: formatStatus2(capability.status) },
+      { label: "Selected", value: capability.selected ? "Yes" : "No" },
+      { label: "Model", value: capability.model ?? "Default" },
+      {
+        label: "Features",
+        value: capability.features?.join(", ") || "Not specified"
+      },
+      { label: "Runs", value: String(capability.health?.runCount ?? 0) },
+      { label: "Errors", value: String(capability.health?.errorCount ?? 0) }
+    ]
+  }));
+  const warningCount = capabilities.filter((capability) => isWarningStatus2(capability.status)).length;
+  const selectedCount = snapshot.report?.selected ?? capabilities.filter((capability) => capability.selected).length;
+  return {
+    capabilities,
+    description: options.description ?? DEFAULT_DESCRIPTION4,
+    error: snapshot.error,
+    isLoading: snapshot.isLoading,
+    label: snapshot.error ? "Unavailable" : capabilities.length ? warningCount > 0 ? `${warningCount} needs attention` : `${selectedCount} selected` : snapshot.isLoading ? "Checking" : "No capabilities",
+    status: snapshot.error ? "error" : capabilities.length ? warningCount > 0 ? "warning" : "ready" : snapshot.isLoading ? "loading" : "empty",
+    title: options.title ?? DEFAULT_TITLE4,
+    updatedAt: snapshot.updatedAt
+  };
+};
+var renderVoiceProviderCapabilitiesHTML = (snapshot, options = {}) => {
+  const model = createVoiceProviderCapabilitiesViewModel(snapshot, options);
+  const capabilities = model.capabilities.length ? `<div class="absolute-voice-provider-capabilities__providers">${model.capabilities.map((capability) => `<article class="absolute-voice-provider-capabilities__provider absolute-voice-provider-capabilities__provider--${escapeHtml5(capability.status)}">
+  <header>
+    <strong>${escapeHtml5(capability.label)}</strong>
+    <span>${escapeHtml5(formatStatus2(capability.status))}</span>
+  </header>
+  <p>${escapeHtml5(capability.detail)}</p>
+  <dl>${capability.rows.map((row) => `<div>
+    <dt>${escapeHtml5(row.label)}</dt>
+    <dd>${escapeHtml5(row.value)}</dd>
+  </div>`).join("")}</dl>
+</article>`).join("")}</div>` : '<p class="absolute-voice-provider-capabilities__empty">Configure provider capabilities to see deployment coverage.</p>';
+  return `<section class="absolute-voice-provider-capabilities absolute-voice-provider-capabilities--${escapeHtml5(model.status)}">
+  <header class="absolute-voice-provider-capabilities__header">
+    <span class="absolute-voice-provider-capabilities__eyebrow">${escapeHtml5(model.title)}</span>
+    <strong class="absolute-voice-provider-capabilities__label">${escapeHtml5(model.label)}</strong>
+  </header>
+  <p class="absolute-voice-provider-capabilities__description">${escapeHtml5(model.description)}</p>
+  ${capabilities}
+  ${model.error ? `<p class="absolute-voice-provider-capabilities__error">${escapeHtml5(model.error)}</p>` : ""}
+</section>`;
+};
+var getVoiceProviderCapabilitiesCSS = () => `.absolute-voice-provider-capabilities{border:1px solid #bfd7ea;border-radius:20px;background:#f6fbff;color:#08131f;padding:18px;box-shadow:0 18px 40px rgba(14,51,78,.12);font-family:inherit}.absolute-voice-provider-capabilities--error,.absolute-voice-provider-capabilities--warning{border-color:#f2a7a7;background:#fff5f3}.absolute-voice-provider-capabilities__header,.absolute-voice-provider-capabilities__provider header{align-items:start;display:flex;gap:12px;justify-content:space-between}.absolute-voice-provider-capabilities__eyebrow{color:#255f85;font-size:12px;font-weight:800;letter-spacing:.08em;text-transform:uppercase}.absolute-voice-provider-capabilities__label{font-size:24px;line-height:1}.absolute-voice-provider-capabilities__description,.absolute-voice-provider-capabilities__provider p,.absolute-voice-provider-capabilities__provider dt,.absolute-voice-provider-capabilities__empty{color:#405467}.absolute-voice-provider-capabilities__providers{display:grid;gap:12px;margin-top:14px}.absolute-voice-provider-capabilities__provider{background:#fff;border:1px solid #d7e7f3;border-radius:16px;padding:14px}.absolute-voice-provider-capabilities__provider--selected,.absolute-voice-provider-capabilities__provider--healthy{border-color:#86efac}.absolute-voice-provider-capabilities__provider--degraded,.absolute-voice-provider-capabilities__provider--rate-limited,.absolute-voice-provider-capabilities__provider--suppressed,.absolute-voice-provider-capabilities__provider--unconfigured{border-color:#f2a7a7}.absolute-voice-provider-capabilities__provider p{margin:10px 0}.absolute-voice-provider-capabilities__provider dl{display:grid;gap:8px;grid-template-columns:repeat(2,minmax(0,1fr));margin:0}.absolute-voice-provider-capabilities__provider div{background:#f6fbff;border:1px solid #d7e7f3;border-radius:12px;padding:8px}.absolute-voice-provider-capabilities__provider dt{font-size:12px}.absolute-voice-provider-capabilities__provider dd{font-weight:800;margin:4px 0 0}.absolute-voice-provider-capabilities__empty{margin:14px 0 0}.absolute-voice-provider-capabilities__error{color:#9f1239;font-weight:700}`;
+var mountVoiceProviderCapabilities = (element, path = "/api/provider-capabilities", options = {}) => {
+  const store = createVoiceProviderCapabilitiesStore(path, options);
+  const render = () => {
+    element.innerHTML = renderVoiceProviderCapabilitiesHTML(store.getSnapshot(), options);
+  };
+  const unsubscribe = store.subscribe(render);
+  render();
+  store.refresh().catch(() => {});
+  return {
+    close: () => {
+      unsubscribe();
+      store.close();
+    },
+    refresh: store.refresh
+  };
+};
+var defineVoiceProviderCapabilitiesElement = (tagName = "absolute-voice-provider-capabilities") => {
+  if (typeof window === "undefined" || typeof customElements === "undefined" || customElements.get(tagName)) {
+    return;
+  }
+  customElements.define(tagName, class AbsoluteVoiceProviderCapabilitiesElement extends HTMLElement {
+    mounted;
+    connectedCallback() {
+      const intervalMs = Number(this.getAttribute("interval-ms") ?? 5000);
+      this.mounted = mountVoiceProviderCapabilities(this, this.getAttribute("path") ?? "/api/provider-capabilities", {
+        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/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;
@@ -2443,28 +2826,40 @@ 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,
+  defineVoiceProviderCapabilitiesElement,
   defineVoiceOpsStatusElement,
   decodeVoiceAudioChunk,
   createVoiceWorkflowStatusStore,
+  createVoiceTurnQualityViewModel,
+  createVoiceTurnQualityStore,
   createVoiceStream,
   createVoiceRoutingStatusViewModel,
   createVoiceRoutingStatusStore,
@@ -2472,6 +2867,8 @@ export {
   createVoiceProviderStatusStore,
   createVoiceProviderSimulationControlsViewModel,
   createVoiceProviderSimulationControlsStore,
+  createVoiceProviderCapabilitiesViewModel,
+  createVoiceProviderCapabilitiesStore,
   createVoiceOpsStatusViewModel,
   createVoiceDuplexController,
   createVoiceController,

package/dist/client/providerCapabilities.d.ts

@@ -0,0 +1,19 @@
+import type { VoiceProviderCapabilityReport } from '../providerCapabilities';
+export type VoiceProviderCapabilitiesClientOptions = {
+    fetch?: typeof fetch;
+    intervalMs?: number;
+};
+export type VoiceProviderCapabilitiesSnapshot<TProvider extends string = string> = {
+    error: string | null;
+    isLoading: boolean;
+    report?: VoiceProviderCapabilityReport<TProvider>;
+    updatedAt?: number;
+};
+export declare const fetchVoiceProviderCapabilities: <TProvider extends string = string>(path?: string, options?: Pick<VoiceProviderCapabilitiesClientOptions, "fetch">) => Promise<VoiceProviderCapabilityReport<TProvider>>;
+export declare const createVoiceProviderCapabilitiesStore: <TProvider extends string = string>(path?: string, options?: VoiceProviderCapabilitiesClientOptions) => {
+    close: () => void;
+    getServerSnapshot: () => VoiceProviderCapabilitiesSnapshot<TProvider>;
+    getSnapshot: () => VoiceProviderCapabilitiesSnapshot<TProvider>;
+    refresh: () => Promise<VoiceProviderCapabilityReport<TProvider> | undefined>;
+    subscribe: (listener: () => void) => () => void;
+};

package/dist/client/providerCapabilitiesWidget.d.ts

@@ -0,0 +1,32 @@
+import type { VoiceProviderCapabilitySummary } from '../providerCapabilities';
+import { type VoiceProviderCapabilitiesClientOptions, type VoiceProviderCapabilitiesSnapshot } from './providerCapabilities';
+export type VoiceProviderCapabilityCardView<TProvider extends string = string> = VoiceProviderCapabilitySummary<TProvider> & {
+    detail: string;
+    label: string;
+    rows: Array<{
+        label: string;
+        value: string;
+    }>;
+};
+export type VoiceProviderCapabilitiesViewModel<TProvider extends string = string> = {
+    capabilities: VoiceProviderCapabilityCardView<TProvider>[];
+    description: string;
+    error: string | null;
+    isLoading: boolean;
+    label: string;
+    status: 'empty' | 'error' | 'loading' | 'ready' | 'warning';
+    title: string;
+    updatedAt?: number;
+};
+export type VoiceProviderCapabilitiesWidgetOptions = VoiceProviderCapabilitiesClientOptions & {
+    description?: string;
+    title?: string;
+};
+export declare const createVoiceProviderCapabilitiesViewModel: <TProvider extends string = string>(snapshot: VoiceProviderCapabilitiesSnapshot<TProvider>, options?: VoiceProviderCapabilitiesWidgetOptions) => VoiceProviderCapabilitiesViewModel<TProvider>;
+export declare const renderVoiceProviderCapabilitiesHTML: <TProvider extends string = string>(snapshot: VoiceProviderCapabilitiesSnapshot<TProvider>, options?: VoiceProviderCapabilitiesWidgetOptions) => string;
+export declare const getVoiceProviderCapabilitiesCSS: () => string;
+export declare const mountVoiceProviderCapabilities: <TProvider extends string = string>(element: Element, path?: string, options?: VoiceProviderCapabilitiesWidgetOptions) => {
+    close: () => void;
+    refresh: () => Promise<import("..").VoiceProviderCapabilityReport<TProvider> | undefined>;
+};
+export declare const defineVoiceProviderCapabilitiesElement: (tagName?: string) => void;

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';