@absolutejs/voice 0.0.22-beta.167 → 0.0.22-beta.169

package/dist/react/useVoiceProviderContracts.d.ts

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

package/dist/svelte/createVoiceProviderContracts.d.ts

@@ -0,0 +1,10 @@
+import { type VoiceProviderContractsWidgetOptions } from '../client/providerContractsWidget';
+export declare const createVoiceProviderContracts: <TProvider extends string = string>(path?: string, options?: VoiceProviderContractsWidgetOptions) => {
+    getHTML: () => string;
+    getViewModel: () => import("../client").VoiceProviderContractsViewModel<TProvider>;
+    close: () => void;
+    getServerSnapshot: () => import("../client").VoiceProviderContractsSnapshot<TProvider>;
+    getSnapshot: () => import("../client").VoiceProviderContractsSnapshot<TProvider>;
+    refresh: () => Promise<import("..").VoiceProviderContractMatrixReport<TProvider> | undefined>;
+    subscribe: (listener: () => void) => () => void;
+};

package/dist/svelte/index.d.ts

@@ -4,6 +4,7 @@ export { createVoiceOpsActionCenter } from './createVoiceOpsActionCenter';
 export { createVoiceOpsStatus } from './createVoiceOpsStatus';
 export { createVoiceProviderSimulationControls } from './createVoiceProviderSimulationControls';
 export { createVoiceProviderCapabilities } from './createVoiceProviderCapabilities';
+export { createVoiceProviderContracts } from './createVoiceProviderContracts';
 export { createVoiceStream } from './createVoiceStream';
 export { createVoiceProviderStatus } from './createVoiceProviderStatus';
 export { createVoiceRoutingStatus } from './createVoiceRoutingStatus';

package/dist/svelte/index.js

@@ -1367,6 +1367,197 @@ var createVoiceProviderCapabilities = (path = "/api/provider-capabilities", opti
     getViewModel: () => createVoiceProviderCapabilitiesViewModel(store.getSnapshot(), options)
   };
 };
+// src/client/providerContracts.ts
+var fetchVoiceProviderContracts = async (path = "/api/provider-contracts", options = {}) => {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const response = await fetchImpl(path);
+  if (!response.ok) {
+    throw new Error(`Voice provider contracts failed: HTTP ${response.status}`);
+  }
+  return await response.json();
+};
+var createVoiceProviderContractsStore = (path = "/api/provider-contracts", 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 fetchVoiceProviderContracts(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/providerContractsWidget.ts
+var DEFAULT_TITLE5 = "Provider Contracts";
+var DEFAULT_DESCRIPTION5 = "Production contract coverage for provider env, latency, fallback, streaming, and capabilities.";
+var escapeHtml6 = (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 formatStatus2 = (status) => status.split("-").map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ");
+var contractDetail = (row) => {
+  const failing = row.checks.filter((check) => check.status !== "pass");
+  if (failing.length === 0) {
+    return "Provider contract is production-ready.";
+  }
+  return failing.map((check) => `${check.label}: ${check.detail ?? check.status}`).join(" ");
+};
+var createVoiceProviderContractsViewModel = (snapshot, options = {}) => {
+  const rows = (snapshot.report?.rows ?? []).map((row) => ({
+    ...row,
+    detail: contractDetail(row),
+    label: `${formatProvider2(row.provider)} ${row.kind.toUpperCase()}`,
+    remediations: row.checks.filter((check) => check.status !== "pass" && check.remediation).map((check) => ({
+      detail: check.remediation?.detail ?? "",
+      href: check.remediation?.href,
+      label: check.remediation?.label ?? check.label
+    })),
+    rows: [
+      { label: "Status", value: formatStatus2(row.status) },
+      { label: "Selected", value: row.selected ? "Yes" : "No" },
+      { label: "Configured", value: row.configured ? "Yes" : "No" },
+      {
+        label: "Checks",
+        value: row.checks.map((check) => `${check.label}: ${formatStatus2(check.status)}`).join(", ")
+      }
+    ]
+  }));
+  const warningCount = snapshot.report ? snapshot.report.failed + snapshot.report.warned : rows.filter((row) => row.status !== "pass").length;
+  return {
+    description: options.description ?? DEFAULT_DESCRIPTION5,
+    error: snapshot.error,
+    isLoading: snapshot.isLoading,
+    label: snapshot.error ? "Unavailable" : rows.length ? warningCount > 0 ? `${warningCount} needs attention` : `${rows.length} passing` : snapshot.isLoading ? "Checking" : "No contracts",
+    rows,
+    status: snapshot.error ? "error" : rows.length ? warningCount > 0 ? "warning" : "ready" : snapshot.isLoading ? "loading" : "empty",
+    title: options.title ?? DEFAULT_TITLE5,
+    updatedAt: snapshot.updatedAt
+  };
+};
+var renderVoiceProviderContractsHTML = (snapshot, options = {}) => {
+  const model = createVoiceProviderContractsViewModel(snapshot, options);
+  const rows = model.rows.length ? `<div class="absolute-voice-provider-contracts__rows">${model.rows.map((row) => `<article class="absolute-voice-provider-contracts__row absolute-voice-provider-contracts__row--${escapeHtml6(row.status)}">
+  <header>
+    <strong>${escapeHtml6(row.label)}</strong>
+    <span>${escapeHtml6(formatStatus2(row.status))}</span>
+  </header>
+  <p>${escapeHtml6(row.detail)}</p>
+  ${row.remediations.length ? `<ul class="absolute-voice-provider-contracts__remediations">${row.remediations.map((remediation) => `<li>${remediation.href ? `<a href="${escapeHtml6(remediation.href)}">${escapeHtml6(remediation.label)}</a>` : `<strong>${escapeHtml6(remediation.label)}</strong>`}<span>${escapeHtml6(remediation.detail)}</span></li>`).join("")}</ul>` : ""}
+  <dl>${row.rows.map((item) => `<div>
+    <dt>${escapeHtml6(item.label)}</dt>
+    <dd>${escapeHtml6(item.value)}</dd>
+  </div>`).join("")}</dl>
+</article>`).join("")}</div>` : '<p class="absolute-voice-provider-contracts__empty">Configure provider contracts to see production coverage.</p>';
+  return `<section class="absolute-voice-provider-contracts absolute-voice-provider-contracts--${escapeHtml6(model.status)}">
+  <header class="absolute-voice-provider-contracts__header">
+    <span class="absolute-voice-provider-contracts__eyebrow">${escapeHtml6(model.title)}</span>
+    <strong class="absolute-voice-provider-contracts__label">${escapeHtml6(model.label)}</strong>
+  </header>
+  <p class="absolute-voice-provider-contracts__description">${escapeHtml6(model.description)}</p>
+  ${rows}
+  ${model.error ? `<p class="absolute-voice-provider-contracts__error">${escapeHtml6(model.error)}</p>` : ""}
+</section>`;
+};
+var getVoiceProviderContractsCSS = () => `.absolute-voice-provider-contracts{border:1px solid #b8dcc7;border-radius:20px;background:#f7fff9;color:#09140d;padding:18px;box-shadow:0 18px 40px rgba(21,83,45,.12);font-family:inherit}.absolute-voice-provider-contracts--error,.absolute-voice-provider-contracts--warning{border-color:#f2a7a7;background:#fff7f4}.absolute-voice-provider-contracts__header,.absolute-voice-provider-contracts__row header{align-items:start;display:flex;gap:12px;justify-content:space-between}.absolute-voice-provider-contracts__eyebrow{color:#166534;font-size:12px;font-weight:800;letter-spacing:.08em;text-transform:uppercase}.absolute-voice-provider-contracts__label{font-size:24px;line-height:1}.absolute-voice-provider-contracts__description,.absolute-voice-provider-contracts__row p,.absolute-voice-provider-contracts__row dt,.absolute-voice-provider-contracts__empty{color:#405448}.absolute-voice-provider-contracts__rows{display:grid;gap:12px;margin-top:14px}.absolute-voice-provider-contracts__row{background:#fff;border:1px solid #d6eadb;border-radius:16px;padding:14px}.absolute-voice-provider-contracts__row--pass{border-color:#86efac}.absolute-voice-provider-contracts__row--warn,.absolute-voice-provider-contracts__row--fail{border-color:#f2a7a7}.absolute-voice-provider-contracts__row p{margin:10px 0}.absolute-voice-provider-contracts__remediations{display:grid;gap:8px;list-style:none;margin:0 0 10px;padding:0}.absolute-voice-provider-contracts__remediations li{background:#fff7ed;border:1px solid #fed7aa;border-radius:12px;display:grid;gap:3px;padding:8px}.absolute-voice-provider-contracts__remediations a,.absolute-voice-provider-contracts__remediations strong{color:#9a3412}.absolute-voice-provider-contracts__remediations span{color:#7c2d12}.absolute-voice-provider-contracts__row dl{display:grid;gap:8px;grid-template-columns:repeat(2,minmax(0,1fr));margin:0}.absolute-voice-provider-contracts__row div{background:#f7fff9;border:1px solid #d6eadb;border-radius:12px;padding:8px}.absolute-voice-provider-contracts__row dt{font-size:12px}.absolute-voice-provider-contracts__row dd{font-weight:800;margin:4px 0 0}.absolute-voice-provider-contracts__error{color:#9f1239;font-weight:700}`;
+var mountVoiceProviderContracts = (element, path = "/api/provider-contracts", options = {}) => {
+  const store = createVoiceProviderContractsStore(path, options);
+  const render = () => {
+    element.innerHTML = renderVoiceProviderContractsHTML(store.getSnapshot(), options);
+  };
+  const unsubscribe = store.subscribe(render);
+  render();
+  store.refresh().catch(() => {});
+  return {
+    close: () => {
+      unsubscribe();
+      store.close();
+    },
+    refresh: store.refresh
+  };
+};
+var defineVoiceProviderContractsElement = (tagName = "absolute-voice-provider-contracts") => {
+  if (typeof window === "undefined" || typeof customElements === "undefined" || customElements.get(tagName)) {
+    return;
+  }
+  customElements.define(tagName, class AbsoluteVoiceProviderContractsElement extends HTMLElement {
+    mounted;
+    connectedCallback() {
+      const intervalMs = Number(this.getAttribute("interval-ms") ?? 5000);
+      this.mounted = mountVoiceProviderContracts(this, this.getAttribute("path") ?? "/api/provider-contracts", {
+        description: this.getAttribute("description") ?? undefined,
+        intervalMs: Number.isFinite(intervalMs) ? intervalMs : 5000,
+        title: this.getAttribute("title") ?? undefined
+      });
+    }
+    disconnectedCallback() {
+      this.mounted?.close();
+      this.mounted = undefined;
+    }
+  });
+};
+
+// src/svelte/createVoiceProviderContracts.ts
+var createVoiceProviderContracts = (path = "/api/provider-contracts", options = {}) => {
+  const store = createVoiceProviderContractsStore(path, options);
+  return {
+    ...store,
+    getHTML: () => renderVoiceProviderContractsHTML(store.getSnapshot(), options),
+    getViewModel: () => createVoiceProviderContractsViewModel(store.getSnapshot(), options)
+  };
+};
 // src/client/actions.ts
 var normalizeErrorMessage = (value) => {
   if (typeof value === "string" && value.trim()) {
@@ -2090,11 +2281,11 @@ var createVoiceProviderStatusStore = (path = "/api/provider-status", options = {
 };
 
 // src/client/providerStatusWidget.ts
-var DEFAULT_TITLE5 = "Voice Providers";
-var DEFAULT_DESCRIPTION5 = "Live provider health, fallback counts, latency, and suppression state from your self-hosted trace store.";
-var escapeHtml6 = (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 formatStatus2 = (status) => status.split("-").map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ");
+var DEFAULT_TITLE6 = "Voice Providers";
+var DEFAULT_DESCRIPTION6 = "Live provider health, fallback counts, latency, and suppression state from your self-hosted trace store.";
+var escapeHtml7 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var formatProvider3 = (provider) => provider.split(/[-_\s]+/).filter(Boolean).map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ") || provider;
+var formatStatus3 = (status) => status.split("-").map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ");
 var formatLatency = (value) => typeof value === "number" ? `${value}ms` : "No samples";
 var formatSuppression = (value) => typeof value === "number" ? `${Math.ceil(value / 1000)}s` : "None";
 var getProviderDetail = (provider) => {
@@ -2120,7 +2311,7 @@ var createVoiceProviderStatusViewModel = (snapshot, options = {}) => {
   const providers = snapshot.providers.map((provider) => ({
     ...provider,
     detail: getProviderDetail(provider),
-    label: `${formatProvider2(provider.provider)}${provider.recommended ? " recommended" : ""}`,
+    label: `${formatProvider3(provider.provider)}${provider.recommended ? " recommended" : ""}`,
     rows: [
       { label: "Runs", value: String(provider.runCount) },
       { label: "Avg latency", value: formatLatency(provider.averageElapsedMs) },
@@ -2136,37 +2327,37 @@ var createVoiceProviderStatusViewModel = (snapshot, options = {}) => {
   const warningCount = providers.filter((provider) => isWarningStatus2(provider.status)).length;
   const healthyCount = providers.filter((provider) => provider.status === "healthy").length;
   return {
-    description: options.description ?? DEFAULT_DESCRIPTION5,
+    description: options.description ?? DEFAULT_DESCRIPTION6,
     error: snapshot.error,
     isLoading: snapshot.isLoading,
     label: snapshot.error ? "Unavailable" : providers.length ? warningCount > 0 ? `${warningCount} needs attention` : `${healthyCount} healthy` : snapshot.isLoading ? "Checking" : "No provider traffic",
     providers,
     status: snapshot.error ? "error" : providers.length ? warningCount > 0 ? "warning" : "ready" : snapshot.isLoading ? "loading" : "empty",
-    title: options.title ?? DEFAULT_TITLE5,
+    title: options.title ?? DEFAULT_TITLE6,
     updatedAt: snapshot.updatedAt
   };
 };
 var renderVoiceProviderStatusHTML = (snapshot, options = {}) => {
   const model = createVoiceProviderStatusViewModel(snapshot, options);
-  const providers = model.providers.length ? `<div class="absolute-voice-provider-status__providers">${model.providers.map((provider) => `<article class="absolute-voice-provider-status__provider absolute-voice-provider-status__provider--${escapeHtml6(provider.status)}">
+  const providers = model.providers.length ? `<div class="absolute-voice-provider-status__providers">${model.providers.map((provider) => `<article class="absolute-voice-provider-status__provider absolute-voice-provider-status__provider--${escapeHtml7(provider.status)}">
   <header>
-    <strong>${escapeHtml6(provider.label)}</strong>
-    <span>${escapeHtml6(formatStatus2(provider.status))}</span>
+    <strong>${escapeHtml7(provider.label)}</strong>
+    <span>${escapeHtml7(formatStatus3(provider.status))}</span>
   </header>
-  <p>${escapeHtml6(provider.detail)}</p>
+  <p>${escapeHtml7(provider.detail)}</p>
   <dl>${provider.rows.map((row) => `<div>
-    <dt>${escapeHtml6(row.label)}</dt>
-    <dd>${escapeHtml6(row.value)}</dd>
+    <dt>${escapeHtml7(row.label)}</dt>
+    <dd>${escapeHtml7(row.value)}</dd>
   </div>`).join("")}</dl>
 </article>`).join("")}</div>` : '<p class="absolute-voice-provider-status__empty">Run voice traffic to see provider health.</p>';
-  return `<section class="absolute-voice-provider-status absolute-voice-provider-status--${escapeHtml6(model.status)}">
+  return `<section class="absolute-voice-provider-status absolute-voice-provider-status--${escapeHtml7(model.status)}">
   <header class="absolute-voice-provider-status__header">
-    <span class="absolute-voice-provider-status__eyebrow">${escapeHtml6(model.title)}</span>
-    <strong class="absolute-voice-provider-status__label">${escapeHtml6(model.label)}</strong>
+    <span class="absolute-voice-provider-status__eyebrow">${escapeHtml7(model.title)}</span>
+    <strong class="absolute-voice-provider-status__label">${escapeHtml7(model.label)}</strong>
   </header>
-  <p class="absolute-voice-provider-status__description">${escapeHtml6(model.description)}</p>
+  <p class="absolute-voice-provider-status__description">${escapeHtml7(model.description)}</p>
   ${providers}
-  ${model.error ? `<p class="absolute-voice-provider-status__error">${escapeHtml6(model.error)}</p>` : ""}
+  ${model.error ? `<p class="absolute-voice-provider-status__error">${escapeHtml7(model.error)}</p>` : ""}
 </section>`;
 };
 var getVoiceProviderStatusCSS = () => `.absolute-voice-provider-status{border:1px solid #d8d2c4;border-radius:20px;background:#fffaf0;color:#16130d;padding:18px;box-shadow:0 18px 40px rgba(47,37,18,.12);font-family:inherit}.absolute-voice-provider-status--error,.absolute-voice-provider-status--warning{border-color:#f2a7a7;background:#fff5f3}.absolute-voice-provider-status__header,.absolute-voice-provider-status__provider header{align-items:start;display:flex;gap:12px;justify-content:space-between}.absolute-voice-provider-status__eyebrow{color:#73664f;font-size:12px;font-weight:800;letter-spacing:.08em;text-transform:uppercase}.absolute-voice-provider-status__label{font-size:24px;line-height:1}.absolute-voice-provider-status__description,.absolute-voice-provider-status__provider p,.absolute-voice-provider-status__provider dt,.absolute-voice-provider-status__empty{color:#514733}.absolute-voice-provider-status__providers{display:grid;gap:12px;margin-top:14px}.absolute-voice-provider-status__provider{background:#fff;border:1px solid #eee4d2;border-radius:16px;padding:14px}.absolute-voice-provider-status__provider--degraded,.absolute-voice-provider-status__provider--rate-limited,.absolute-voice-provider-status__provider--suppressed{border-color:#f2a7a7}.absolute-voice-provider-status__provider--recoverable{border-color:#fbbf24}.absolute-voice-provider-status__provider p{margin:10px 0}.absolute-voice-provider-status__provider dl{display:grid;gap:8px;grid-template-columns:repeat(2,minmax(0,1fr));margin:0}.absolute-voice-provider-status__provider div{background:#fffaf0;border:1px solid #eee4d2;border-radius:12px;padding:8px}.absolute-voice-provider-status__provider dt{font-size:12px}.absolute-voice-provider-status__provider dd{font-weight:800;margin:4px 0 0}.absolute-voice-provider-status__empty{margin:14px 0 0}.absolute-voice-provider-status__error{color:#9f1239;font-weight:700}`;
@@ -2297,9 +2488,9 @@ var createVoiceRoutingStatusStore = (path = "/api/routing/latest", options = {})
 };
 
 // src/client/routingStatusWidget.ts
-var DEFAULT_TITLE6 = "Voice Routing";
-var DEFAULT_DESCRIPTION6 = "Latest provider routing decision from the self-hosted trace store.";
-var escapeHtml7 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var DEFAULT_TITLE7 = "Voice Routing";
+var DEFAULT_DESCRIPTION7 = "Latest provider routing decision from the self-hosted trace store.";
+var escapeHtml8 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var formatValue = (value, fallback = "None") => typeof value === "string" && value.trim() ? value : typeof value === "number" && Number.isFinite(value) ? String(value) : fallback;
 var createVoiceRoutingStatusViewModel = (snapshot, options = {}) => {
   const decision = snapshot.decision;
@@ -2323,30 +2514,30 @@ var createVoiceRoutingStatusViewModel = (snapshot, options = {}) => {
   ] : [];
   return {
     decision,
-    description: options.description ?? DEFAULT_DESCRIPTION6,
+    description: options.description ?? DEFAULT_DESCRIPTION7,
     error: snapshot.error,
     isLoading: snapshot.isLoading,
     label: snapshot.error ? "Unavailable" : decision ? `${formatValue(decision.kind).toUpperCase()} ${formatValue(decision.status, "unknown")}` : snapshot.isLoading ? "Checking" : "No routing yet",
     rows,
     status: snapshot.error ? "error" : decision ? "ready" : snapshot.isLoading ? "loading" : "empty",
-    title: options.title ?? DEFAULT_TITLE6,
+    title: options.title ?? DEFAULT_TITLE7,
     updatedAt: snapshot.updatedAt
   };
 };
 var renderVoiceRoutingStatusHTML = (snapshot, options = {}) => {
   const model = createVoiceRoutingStatusViewModel(snapshot, options);
   const rows = model.rows.length ? `<div class="absolute-voice-routing-status__grid">${model.rows.map((row) => `<div>
-  <span>${escapeHtml7(row.label)}</span>
-  <strong>${escapeHtml7(row.value)}</strong>
+  <span>${escapeHtml8(row.label)}</span>
+  <strong>${escapeHtml8(row.value)}</strong>
 </div>`).join("")}</div>` : '<p class="absolute-voice-routing-status__empty">Start a voice session to see the selected provider.</p>';
-  return `<section class="absolute-voice-routing-status absolute-voice-routing-status--${escapeHtml7(model.status)}">
+  return `<section class="absolute-voice-routing-status absolute-voice-routing-status--${escapeHtml8(model.status)}">
   <header class="absolute-voice-routing-status__header">
-    <span class="absolute-voice-routing-status__eyebrow">${escapeHtml7(model.title)}</span>
-    <strong class="absolute-voice-routing-status__label">${escapeHtml7(model.label)}</strong>
+    <span class="absolute-voice-routing-status__eyebrow">${escapeHtml8(model.title)}</span>
+    <strong class="absolute-voice-routing-status__label">${escapeHtml8(model.label)}</strong>
   </header>
-  <p class="absolute-voice-routing-status__description">${escapeHtml7(model.description)}</p>
+  <p class="absolute-voice-routing-status__description">${escapeHtml8(model.description)}</p>
   ${rows}
-  ${model.error ? `<p class="absolute-voice-routing-status__error">${escapeHtml7(model.error)}</p>` : ""}
+  ${model.error ? `<p class="absolute-voice-routing-status__error">${escapeHtml8(model.error)}</p>` : ""}
 </section>`;
 };
 var getVoiceRoutingStatusCSS = () => `.absolute-voice-routing-status{border:1px solid #d8d2c4;border-radius:20px;background:#fffaf0;color:#16130d;padding:18px;box-shadow:0 18px 40px rgba(47,37,18,.12);font-family:inherit}.absolute-voice-routing-status--error{border-color:#f2a7a7;background:#fff5f3}.absolute-voice-routing-status__header{align-items:start;display:flex;gap:12px;justify-content:space-between}.absolute-voice-routing-status__eyebrow{color:#73664f;font-size:12px;font-weight:800;letter-spacing:.08em;text-transform:uppercase}.absolute-voice-routing-status__label{font-size:24px;line-height:1}.absolute-voice-routing-status__description{color:#514733;margin:12px 0 0}.absolute-voice-routing-status__grid{display:grid;gap:8px;grid-template-columns:repeat(2,minmax(0,1fr));margin-top:14px}.absolute-voice-routing-status__grid div{background:#fff;border:1px solid #eee4d2;border-radius:14px;padding:10px 12px}.absolute-voice-routing-status__grid span{color:#655944;display:block;font-size:12px;margin-bottom:4px}.absolute-voice-routing-status__grid strong{overflow-wrap:anywhere}.absolute-voice-routing-status__empty{color:#655944;margin:14px 0 0}.absolute-voice-routing-status__error{color:#9f1239;font-weight:700}`;
@@ -2477,9 +2668,9 @@ var createVoiceTraceTimelineStore = (path = "/api/voice-traces", options = {}) =
 };
 
 // src/client/traceTimelineWidget.ts
-var DEFAULT_TITLE7 = "Voice Traces";
-var DEFAULT_DESCRIPTION7 = "Latest call timelines with provider latency, fallbacks, handoffs, and errors from your self-hosted trace store.";
-var escapeHtml8 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var DEFAULT_TITLE8 = "Voice Traces";
+var DEFAULT_DESCRIPTION8 = "Latest call timelines with provider latency, fallbacks, handoffs, and errors from your self-hosted trace store.";
+var escapeHtml9 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var formatMs = (value) => typeof value === "number" ? `${value}ms` : "n/a";
 var formatProviders = (session) => session.providers.length ? session.providers.map((provider) => provider.provider).join(", ") : "No providers";
 var createVoiceTraceTimelineViewModel = (snapshot, options = {}) => {
@@ -2493,34 +2684,34 @@ var createVoiceTraceTimelineViewModel = (snapshot, options = {}) => {
   const failed = sessions.filter((session) => session.status === "failed").length;
   const warnings = sessions.filter((session) => session.status === "warning").length;
   return {
-    description: options.description ?? DEFAULT_DESCRIPTION7,
+    description: options.description ?? DEFAULT_DESCRIPTION8,
     error: snapshot.error,
     isLoading: snapshot.isLoading,
     label: snapshot.error ? "Unavailable" : failed > 0 ? `${failed} failed` : warnings > 0 ? `${warnings} warning` : sessions.length ? `${sessions.length} recent` : snapshot.isLoading ? "Checking" : "No traces yet",
     sessions,
     status: snapshot.error ? "error" : failed > 0 ? "failed" : warnings > 0 ? "warning" : sessions.length ? "ready" : snapshot.isLoading ? "loading" : "empty",
-    title: options.title ?? DEFAULT_TITLE7,
+    title: options.title ?? DEFAULT_TITLE8,
     updatedAt: snapshot.updatedAt
   };
 };
 var renderVoiceTraceTimelineWidgetHTML = (snapshot, options = {}) => {
   const model = createVoiceTraceTimelineViewModel(snapshot, options);
-  const sessions = model.sessions.length ? `<div class="absolute-voice-trace-timeline__sessions">${model.sessions.map((session) => `<article class="absolute-voice-trace-timeline__session absolute-voice-trace-timeline__session--${escapeHtml8(session.status)}">
+  const sessions = model.sessions.length ? `<div class="absolute-voice-trace-timeline__sessions">${model.sessions.map((session) => `<article class="absolute-voice-trace-timeline__session absolute-voice-trace-timeline__session--${escapeHtml9(session.status)}">
   <header>
-    <strong>${escapeHtml8(session.sessionId)}</strong>
-    <span>${escapeHtml8(session.status)}</span>
+    <strong>${escapeHtml9(session.sessionId)}</strong>
+    <span>${escapeHtml9(session.status)}</span>
   </header>
-  <p>${escapeHtml8(session.label)} \xB7 ${escapeHtml8(session.durationLabel)} \xB7 ${escapeHtml8(session.providerLabel)}</p>
-  <a href="${escapeHtml8(session.detailHref)}">Open timeline</a>
+  <p>${escapeHtml9(session.label)} \xB7 ${escapeHtml9(session.durationLabel)} \xB7 ${escapeHtml9(session.providerLabel)}</p>
+  <a href="${escapeHtml9(session.detailHref)}">Open timeline</a>
 </article>`).join("")}</div>` : '<p class="absolute-voice-trace-timeline__empty">Run a voice session to see call timelines.</p>';
-  return `<section class="absolute-voice-trace-timeline absolute-voice-trace-timeline--${escapeHtml8(model.status)}">
+  return `<section class="absolute-voice-trace-timeline absolute-voice-trace-timeline--${escapeHtml9(model.status)}">
   <header class="absolute-voice-trace-timeline__header">
-    <span class="absolute-voice-trace-timeline__eyebrow">${escapeHtml8(model.title)}</span>
-    <strong class="absolute-voice-trace-timeline__label">${escapeHtml8(model.label)}</strong>
+    <span class="absolute-voice-trace-timeline__eyebrow">${escapeHtml9(model.title)}</span>
+    <strong class="absolute-voice-trace-timeline__label">${escapeHtml9(model.label)}</strong>
   </header>
-  <p class="absolute-voice-trace-timeline__description">${escapeHtml8(model.description)}</p>
+  <p class="absolute-voice-trace-timeline__description">${escapeHtml9(model.description)}</p>
   ${sessions}
-  ${model.error ? `<p class="absolute-voice-trace-timeline__error">${escapeHtml8(model.error)}</p>` : ""}
+  ${model.error ? `<p class="absolute-voice-trace-timeline__error">${escapeHtml9(model.error)}</p>` : ""}
 </section>`;
 };
 var getVoiceTraceTimelineCSS = () => `.absolute-voice-trace-timeline{border:1px solid #bad7d3;border-radius:20px;background:#f3fffb;color:#09201c;padding:18px;box-shadow:0 18px 40px rgba(9,32,28,.12);font-family:inherit}.absolute-voice-trace-timeline--error,.absolute-voice-trace-timeline--failed{border-color:#f2a7a7;background:#fff5f3}.absolute-voice-trace-timeline--warning{border-color:#fbbf24;background:#fffaf0}.absolute-voice-trace-timeline__header,.absolute-voice-trace-timeline__session header{align-items:start;display:flex;gap:12px;justify-content:space-between}.absolute-voice-trace-timeline__eyebrow{color:#17665b;font-size:12px;font-weight:800;letter-spacing:.08em;text-transform:uppercase}.absolute-voice-trace-timeline__label{font-size:24px;line-height:1}.absolute-voice-trace-timeline__description,.absolute-voice-trace-timeline__session p,.absolute-voice-trace-timeline__empty{color:#35544f}.absolute-voice-trace-timeline__sessions{display:grid;gap:12px;margin-top:14px}.absolute-voice-trace-timeline__session{background:#fff;border:1px solid #cfe7e2;border-radius:16px;padding:14px}.absolute-voice-trace-timeline__session--failed{border-color:#f2a7a7}.absolute-voice-trace-timeline__session--warning{border-color:#fbbf24}.absolute-voice-trace-timeline__session p{margin:10px 0}.absolute-voice-trace-timeline__session a{color:#0f766e;font-weight:800}.absolute-voice-trace-timeline__empty{margin:14px 0 0}.absolute-voice-trace-timeline__error{color:#9f1239;font-weight:700}`;
@@ -2677,10 +2868,10 @@ var createVoiceTurnLatencyStore = (path = "/api/turn-latency", options = {}) =>
 };
 
 // src/client/turnLatencyWidget.ts
-var DEFAULT_TITLE8 = "Turn Latency";
-var DEFAULT_DESCRIPTION8 = "Per-turn timing from first transcript to commit and assistant response start.";
+var DEFAULT_TITLE9 = "Turn Latency";
+var DEFAULT_DESCRIPTION9 = "Per-turn timing from first transcript to commit and assistant response start.";
 var DEFAULT_PROOF_LABEL = "Run latency proof";
-var escapeHtml9 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var escapeHtml10 = (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 = {}) => {
   const turns = (snapshot.report?.turns ?? []).map((turn) => ({
@@ -2694,39 +2885,39 @@ var createVoiceTurnLatencyViewModel = (snapshot, options = {}) => {
   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_DESCRIPTION8,
+    description: options.description ?? DEFAULT_DESCRIPTION9,
     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_TITLE8,
+    title: options.title ?? DEFAULT_TITLE9,
     turns,
     updatedAt: snapshot.updatedAt
   };
 };
 var renderVoiceTurnLatencyHTML = (snapshot, options = {}) => {
   const model = createVoiceTurnLatencyViewModel(snapshot, options);
-  const turns = model.turns.length ? `<div class="absolute-voice-turn-latency__turns">${model.turns.map((turn) => `<article class="absolute-voice-turn-latency__turn absolute-voice-turn-latency__turn--${escapeHtml9(turn.status)}">
+  const turns = model.turns.length ? `<div class="absolute-voice-turn-latency__turns">${model.turns.map((turn) => `<article class="absolute-voice-turn-latency__turn absolute-voice-turn-latency__turn--${escapeHtml10(turn.status)}">
   <header>
-    <strong>${escapeHtml9(turn.label)}</strong>
-    <span>${escapeHtml9(turn.status)}</span>
+    <strong>${escapeHtml10(turn.label)}</strong>
+    <span>${escapeHtml10(turn.status)}</span>
   </header>
   <dl>${turn.rows.map((row) => `<div>
-    <dt>${escapeHtml9(row.label)}</dt>
-    <dd>${escapeHtml9(row.value)}</dd>
+    <dt>${escapeHtml10(row.label)}</dt>
+    <dd>${escapeHtml10(row.value)}</dd>
   </div>`).join("")}</dl>
 </article>`).join("")}</div>` : '<p class="absolute-voice-turn-latency__empty">Complete a voice turn to see latency diagnostics.</p>';
-  return `<section class="absolute-voice-turn-latency absolute-voice-turn-latency--${escapeHtml9(model.status)}">
+  return `<section class="absolute-voice-turn-latency absolute-voice-turn-latency--${escapeHtml10(model.status)}">
   <header class="absolute-voice-turn-latency__header">
-    <span class="absolute-voice-turn-latency__eyebrow">${escapeHtml9(model.title)}</span>
-    <strong class="absolute-voice-turn-latency__label">${escapeHtml9(model.label)}</strong>
+    <span class="absolute-voice-turn-latency__eyebrow">${escapeHtml10(model.title)}</span>
+    <strong class="absolute-voice-turn-latency__label">${escapeHtml10(model.label)}</strong>
   </header>
-  <p class="absolute-voice-turn-latency__description">${escapeHtml9(model.description)}</p>
-  ${model.showProofAction ? `<button class="absolute-voice-turn-latency__proof" data-absolute-voice-turn-latency-proof type="button">${escapeHtml9(model.proofLabel ?? DEFAULT_PROOF_LABEL)}</button>` : ""}
+  <p class="absolute-voice-turn-latency__description">${escapeHtml10(model.description)}</p>
+  ${model.showProofAction ? `<button class="absolute-voice-turn-latency__proof" data-absolute-voice-turn-latency-proof type="button">${escapeHtml10(model.proofLabel ?? DEFAULT_PROOF_LABEL)}</button>` : ""}
   ${turns}
-  ${model.error ? `<p class="absolute-voice-turn-latency__error">${escapeHtml9(model.error)}</p>` : ""}
+  ${model.error ? `<p class="absolute-voice-turn-latency__error">${escapeHtml10(model.error)}</p>` : ""}
 </section>`;
 };
 var mountVoiceTurnLatency = (element, path = "/api/turn-latency", options = {}) => {
@@ -2865,9 +3056,9 @@ var createVoiceTurnQualityStore = (path = "/api/turn-quality", options = {}) =>
 };
 
 // src/client/turnQualityWidget.ts
-var DEFAULT_TITLE9 = "Turn Quality";
-var DEFAULT_DESCRIPTION9 = "Per-turn STT confidence, fallback selection, corrections, and transcript coverage.";
-var escapeHtml10 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var DEFAULT_TITLE10 = "Turn Quality";
+var DEFAULT_DESCRIPTION10 = "Per-turn STT confidence, fallback selection, corrections, and transcript coverage.";
+var escapeHtml11 = (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) => {
@@ -2905,37 +3096,37 @@ var createVoiceTurnQualityViewModel = (snapshot, options = {}) => {
   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_DESCRIPTION9,
+    description: options.description ?? DEFAULT_DESCRIPTION10,
     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_TITLE9,
+    title: options.title ?? DEFAULT_TITLE10,
     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--${escapeHtml10(turn.status)}">
+  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--${escapeHtml11(turn.status)}">
   <header>
-    <strong>${escapeHtml10(turn.label)}</strong>
-    <span>${escapeHtml10(turn.status)}</span>
+    <strong>${escapeHtml11(turn.label)}</strong>
+    <span>${escapeHtml11(turn.status)}</span>
   </header>
-  <p>${escapeHtml10(turn.detail)}</p>
+  <p>${escapeHtml11(turn.detail)}</p>
   <dl>${turn.rows.map((row) => `<div>
-    <dt>${escapeHtml10(row.label)}</dt>
-    <dd>${escapeHtml10(row.value)}</dd>
+    <dt>${escapeHtml11(row.label)}</dt>
+    <dd>${escapeHtml11(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--${escapeHtml10(model.status)}">
+  return `<section class="absolute-voice-turn-quality absolute-voice-turn-quality--${escapeHtml11(model.status)}">
   <header class="absolute-voice-turn-quality__header">
-    <span class="absolute-voice-turn-quality__eyebrow">${escapeHtml10(model.title)}</span>
-    <strong class="absolute-voice-turn-quality__label">${escapeHtml10(model.label)}</strong>
+    <span class="absolute-voice-turn-quality__eyebrow">${escapeHtml11(model.title)}</span>
+    <strong class="absolute-voice-turn-quality__label">${escapeHtml11(model.label)}</strong>
   </header>
-  <p class="absolute-voice-turn-quality__description">${escapeHtml10(model.description)}</p>
+  <p class="absolute-voice-turn-quality__description">${escapeHtml11(model.description)}</p>
   ${turns}
-  ${model.error ? `<p class="absolute-voice-turn-quality__error">${escapeHtml10(model.error)}</p>` : ""}
+  ${model.error ? `<p class="absolute-voice-turn-quality__error">${escapeHtml11(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}`;
@@ -3715,6 +3906,7 @@ export {
   createVoiceRoutingStatus,
   createVoiceProviderStatus,
   createVoiceProviderSimulationControls,
+  createVoiceProviderContracts,
   createVoiceProviderCapabilities,
   createVoiceOpsStatus,
   createVoiceOpsActionCenter,

package/dist/vue/VoiceProviderContracts.d.ts

@@ -0,0 +1,21 @@
+export declare const VoiceProviderContracts: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    description: StringConstructor;
+    intervalMs: NumberConstructor;
+    path: {
+        default: string;
+        type: StringConstructor;
+    };
+    title: StringConstructor;
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    description: StringConstructor;
+    intervalMs: NumberConstructor;
+    path: {
+        default: string;
+        type: StringConstructor;
+    };
+    title: StringConstructor;
+}>> & Readonly<{}>, {
+    path: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/vue/index.d.ts

@@ -3,6 +3,7 @@ export { VoiceOpsActionCenter } from './VoiceOpsActionCenter';
 export { VoiceDeliveryRuntime } from './VoiceDeliveryRuntime';
 export { VoiceProviderSimulationControls } from './VoiceProviderSimulationControls';
 export { VoiceProviderCapabilities } from './VoiceProviderCapabilities';
+export { VoiceProviderContracts } from './VoiceProviderContracts';
 export { VoiceProviderStatus } from './VoiceProviderStatus';
 export { VoiceRoutingStatus } from './VoiceRoutingStatus';
 export { VoiceTurnLatency } from './VoiceTurnLatency';
@@ -15,6 +16,7 @@ export { useVoiceStream } from './useVoiceStream';
 export { useVoiceController } from './useVoiceController';
 export { useVoiceProviderStatus } from './useVoiceProviderStatus';
 export { useVoiceProviderCapabilities } from './useVoiceProviderCapabilities';
+export { useVoiceProviderContracts } from './useVoiceProviderContracts';
 export { useVoiceProviderSimulationControls } from './useVoiceProviderSimulationControls';
 export { useVoiceRoutingStatus } from './useVoiceRoutingStatus';
 export { useVoiceTraceTimeline } from './useVoiceTraceTimeline';