@absolutejs/voice 0.0.22-beta.90 → 0.0.22-beta.91

package/dist/react/index.js

@@ -1495,8 +1495,272 @@ var VoiceRoutingStatus = ({
     ]
   }, undefined, true, undefined, this);
 };
-// src/react/useVoiceTurnQuality.tsx
+// src/client/traceTimeline.ts
+var fetchVoiceTraceTimeline = async (path = "/api/voice-traces", options = {}) => {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const response = await fetchImpl(path);
+  if (!response.ok) {
+    throw new Error(`Voice trace timeline failed: HTTP ${response.status}`);
+  }
+  return await response.json();
+};
+var createVoiceTraceTimelineStore = (path = "/api/voice-traces", options = {}) => {
+  const listeners = new Set;
+  let closed = false;
+  let timer;
+  let snapshot = {
+    error: null,
+    isLoading: false,
+    report: null
+  };
+  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 fetchVoiceTraceTimeline(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/traceTimelineWidget.ts
+var DEFAULT_TITLE5 = "Voice Traces";
+var DEFAULT_DESCRIPTION5 = "Latest call timelines with provider latency, fallbacks, handoffs, and errors from your self-hosted trace store.";
+var escapeHtml6 = (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 = {}) => {
+  const sessions = (snapshot.report?.sessions ?? []).slice(0, options.limit ?? 3).map((session) => ({
+    ...session,
+    detailHref: `${options.detailBasePath ?? "/traces"}/${encodeURIComponent(session.sessionId)}`,
+    durationLabel: formatMs(session.summary.callDurationMs),
+    label: `${session.summary.eventCount} events / ${session.summary.turnCount} turns`,
+    providerLabel: formatProviders(session)
+  }));
+  const failed = sessions.filter((session) => session.status === "failed").length;
+  const warnings = sessions.filter((session) => session.status === "warning").length;
+  return {
+    description: options.description ?? DEFAULT_DESCRIPTION5,
+    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_TITLE5,
+    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--${escapeHtml6(session.status)}">
+  <header>
+    <strong>${escapeHtml6(session.sessionId)}</strong>
+    <span>${escapeHtml6(session.status)}</span>
+  </header>
+  <p>${escapeHtml6(session.label)} \xB7 ${escapeHtml6(session.durationLabel)} \xB7 ${escapeHtml6(session.providerLabel)}</p>
+  <a href="${escapeHtml6(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--${escapeHtml6(model.status)}">
+  <header class="absolute-voice-trace-timeline__header">
+    <span class="absolute-voice-trace-timeline__eyebrow">${escapeHtml6(model.title)}</span>
+    <strong class="absolute-voice-trace-timeline__label">${escapeHtml6(model.label)}</strong>
+  </header>
+  <p class="absolute-voice-trace-timeline__description">${escapeHtml6(model.description)}</p>
+  ${sessions}
+  ${model.error ? `<p class="absolute-voice-trace-timeline__error">${escapeHtml6(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}`;
+var mountVoiceTraceTimeline = (element, path = "/api/voice-traces", options = {}) => {
+  const store = createVoiceTraceTimelineStore(path, options);
+  const render = () => {
+    element.innerHTML = renderVoiceTraceTimelineWidgetHTML(store.getSnapshot(), options);
+  };
+  const unsubscribe = store.subscribe(render);
+  render();
+  store.refresh().catch(() => {});
+  return {
+    close: () => {
+      unsubscribe();
+      store.close();
+    },
+    refresh: store.refresh
+  };
+};
+var defineVoiceTraceTimelineElement = (tagName = "absolute-voice-trace-timeline") => {
+  if (typeof window === "undefined" || typeof customElements === "undefined" || customElements.get(tagName)) {
+    return;
+  }
+  customElements.define(tagName, class AbsoluteVoiceTraceTimelineElement extends HTMLElement {
+    mounted;
+    connectedCallback() {
+      const intervalMs = Number(this.getAttribute("interval-ms") ?? 5000);
+      const limit = Number(this.getAttribute("limit") ?? 3);
+      this.mounted = mountVoiceTraceTimeline(this, this.getAttribute("path") ?? "/api/voice-traces", {
+        description: this.getAttribute("description") ?? undefined,
+        detailBasePath: this.getAttribute("detail-base-path") ?? undefined,
+        intervalMs: Number.isFinite(intervalMs) ? intervalMs : 5000,
+        limit: Number.isFinite(limit) ? limit : 3,
+        title: this.getAttribute("title") ?? undefined
+      });
+    }
+    disconnectedCallback() {
+      this.mounted?.close();
+      this.mounted = undefined;
+    }
+  });
+};
+
+// src/react/useVoiceTraceTimeline.tsx
 import { useEffect as useEffect6, useRef as useRef6, useSyncExternalStore as useSyncExternalStore6 } from "react";
+var useVoiceTraceTimeline = (path = "/api/voice-traces", options = {}) => {
+  const storeRef = useRef6(null);
+  if (!storeRef.current) {
+    storeRef.current = createVoiceTraceTimelineStore(path, options);
+  }
+  const store = storeRef.current;
+  useEffect6(() => {
+    store.refresh().catch(() => {});
+    return () => store.close();
+  }, [store]);
+  return {
+    ...useSyncExternalStore6(store.subscribe, store.getSnapshot, store.getServerSnapshot),
+    refresh: store.refresh
+  };
+};
+
+// src/react/VoiceTraceTimeline.tsx
+import { jsxDEV as jsxDEV6 } from "react/jsx-dev-runtime";
+var VoiceTraceTimeline = ({
+  className,
+  path = "/api/voice-traces",
+  ...options
+}) => {
+  const snapshot = useVoiceTraceTimeline(path, options);
+  const model = createVoiceTraceTimelineViewModel(snapshot, options);
+  return /* @__PURE__ */ jsxDEV6("section", {
+    className: [
+      "absolute-voice-trace-timeline",
+      `absolute-voice-trace-timeline--${model.status}`,
+      className
+    ].filter(Boolean).join(" "),
+    children: [
+      /* @__PURE__ */ jsxDEV6("header", {
+        className: "absolute-voice-trace-timeline__header",
+        children: [
+          /* @__PURE__ */ jsxDEV6("span", {
+            className: "absolute-voice-trace-timeline__eyebrow",
+            children: model.title
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV6("strong", {
+            className: "absolute-voice-trace-timeline__label",
+            children: model.label
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV6("p", {
+        className: "absolute-voice-trace-timeline__description",
+        children: model.description
+      }, undefined, false, undefined, this),
+      model.sessions.length ? /* @__PURE__ */ jsxDEV6("div", {
+        className: "absolute-voice-trace-timeline__sessions",
+        children: model.sessions.map((session) => /* @__PURE__ */ jsxDEV6("article", {
+          className: [
+            "absolute-voice-trace-timeline__session",
+            `absolute-voice-trace-timeline__session--${session.status}`
+          ].join(" "),
+          children: [
+            /* @__PURE__ */ jsxDEV6("header", {
+              children: [
+                /* @__PURE__ */ jsxDEV6("strong", {
+                  children: session.sessionId
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV6("span", {
+                  children: session.status
+                }, undefined, false, undefined, this)
+              ]
+            }, undefined, true, undefined, this),
+            /* @__PURE__ */ jsxDEV6("p", {
+              children: [
+                session.label,
+                " \xB7 ",
+                session.durationLabel,
+                " \xB7",
+                " ",
+                session.providerLabel
+              ]
+            }, undefined, true, undefined, this),
+            /* @__PURE__ */ jsxDEV6("a", {
+              href: session.detailHref,
+              children: "Open timeline"
+            }, undefined, false, undefined, this)
+          ]
+        }, session.sessionId, true, undefined, this))
+      }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV6("p", {
+        className: "absolute-voice-trace-timeline__empty",
+        children: "Run a voice session to see call timelines."
+      }, undefined, false, undefined, this),
+      model.error ? /* @__PURE__ */ jsxDEV6("p", {
+        className: "absolute-voice-trace-timeline__error",
+        children: model.error
+      }, undefined, false, undefined, this) : null
+    ]
+  }, undefined, true, undefined, this);
+};
+// src/react/useVoiceTurnQuality.tsx
+import { useEffect as useEffect7, useRef as useRef7, useSyncExternalStore as useSyncExternalStore7 } from "react";
 
 // src/client/turnQuality.ts
 var fetchVoiceTurnQuality = async (path = "/api/turn-quality", options = {}) => {
@@ -1579,25 +1843,25 @@ var createVoiceTurnQualityStore = (path = "/api/turn-quality", options = {}) =>
 
 // src/react/useVoiceTurnQuality.tsx
 var useVoiceTurnQuality = (path = "/api/turn-quality", options = {}) => {
-  const storeRef = useRef6(null);
+  const storeRef = useRef7(null);
   if (!storeRef.current) {
     storeRef.current = createVoiceTurnQualityStore(path, options);
   }
   const store = storeRef.current;
-  useEffect6(() => {
+  useEffect7(() => {
     store.refresh().catch(() => {});
     return () => store.close();
   }, [store]);
   return {
-    ...useSyncExternalStore6(store.subscribe, store.getSnapshot, store.getServerSnapshot),
+    ...useSyncExternalStore7(store.subscribe, store.getSnapshot, store.getServerSnapshot),
     refresh: store.refresh
   };
 };
 
 // src/client/turnQualityWidget.ts
-var DEFAULT_TITLE5 = "Turn Quality";
-var DEFAULT_DESCRIPTION5 = "Per-turn STT confidence, fallback selection, corrections, and transcript coverage.";
-var escapeHtml6 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var DEFAULT_TITLE6 = "Turn Quality";
+var DEFAULT_DESCRIPTION6 = "Per-turn STT confidence, fallback selection, corrections, and transcript coverage.";
+var escapeHtml7 = (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) => {
@@ -1635,37 +1899,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_DESCRIPTION5,
+    description: options.description ?? DEFAULT_DESCRIPTION6,
     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,
+    title: options.title ?? DEFAULT_TITLE6,
     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)}">
+  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--${escapeHtml7(turn.status)}">
   <header>
-    <strong>${escapeHtml6(turn.label)}</strong>
-    <span>${escapeHtml6(turn.status)}</span>
+    <strong>${escapeHtml7(turn.label)}</strong>
+    <span>${escapeHtml7(turn.status)}</span>
   </header>
-  <p>${escapeHtml6(turn.detail)}</p>
+  <p>${escapeHtml7(turn.detail)}</p>
   <dl>${turn.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-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)}">
+  return `<section class="absolute-voice-turn-quality absolute-voice-turn-quality--${escapeHtml7(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>
+    <span class="absolute-voice-turn-quality__eyebrow">${escapeHtml7(model.title)}</span>
+    <strong class="absolute-voice-turn-quality__label">${escapeHtml7(model.label)}</strong>
   </header>
-  <p class="absolute-voice-turn-quality__description">${escapeHtml6(model.description)}</p>
+  <p class="absolute-voice-turn-quality__description">${escapeHtml7(model.description)}</p>
   ${turns}
-  ${model.error ? `<p class="absolute-voice-turn-quality__error">${escapeHtml6(model.error)}</p>` : ""}
+  ${model.error ? `<p class="absolute-voice-turn-quality__error">${escapeHtml7(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}`;
@@ -1707,7 +1971,7 @@ var defineVoiceTurnQualityElement = (tagName = "absolute-voice-turn-quality") =>
 };
 
 // src/react/VoiceTurnQuality.tsx
-import { jsxDEV as jsxDEV6 } from "react/jsx-dev-runtime";
+import { jsxDEV as jsxDEV7 } from "react/jsx-dev-runtime";
 var VoiceTurnQuality = ({
   className,
   path = "/api/turn-quality",
@@ -1715,58 +1979,58 @@ var VoiceTurnQuality = ({
 }) => {
   const snapshot = useVoiceTurnQuality(path, options);
   const model = createVoiceTurnQualityViewModel(snapshot, options);
-  return /* @__PURE__ */ jsxDEV6("section", {
+  return /* @__PURE__ */ jsxDEV7("section", {
     className: [
       "absolute-voice-turn-quality",
       `absolute-voice-turn-quality--${model.status}`,
       className
     ].filter(Boolean).join(" "),
     children: [
-      /* @__PURE__ */ jsxDEV6("header", {
+      /* @__PURE__ */ jsxDEV7("header", {
         className: "absolute-voice-turn-quality__header",
         children: [
-          /* @__PURE__ */ jsxDEV6("span", {
+          /* @__PURE__ */ jsxDEV7("span", {
             className: "absolute-voice-turn-quality__eyebrow",
             children: model.title
           }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV6("strong", {
+          /* @__PURE__ */ jsxDEV7("strong", {
             className: "absolute-voice-turn-quality__label",
             children: model.label
           }, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this),
-      /* @__PURE__ */ jsxDEV6("p", {
+      /* @__PURE__ */ jsxDEV7("p", {
         className: "absolute-voice-turn-quality__description",
         children: model.description
       }, undefined, false, undefined, this),
-      model.turns.length ? /* @__PURE__ */ jsxDEV6("div", {
+      model.turns.length ? /* @__PURE__ */ jsxDEV7("div", {
         className: "absolute-voice-turn-quality__turns",
-        children: model.turns.map((turn) => /* @__PURE__ */ jsxDEV6("article", {
+        children: model.turns.map((turn) => /* @__PURE__ */ jsxDEV7("article", {
           className: [
             "absolute-voice-turn-quality__turn",
             `absolute-voice-turn-quality__turn--${turn.status}`
           ].join(" "),
           children: [
-            /* @__PURE__ */ jsxDEV6("header", {
+            /* @__PURE__ */ jsxDEV7("header", {
               children: [
-                /* @__PURE__ */ jsxDEV6("strong", {
+                /* @__PURE__ */ jsxDEV7("strong", {
                   children: turn.label
                 }, undefined, false, undefined, this),
-                /* @__PURE__ */ jsxDEV6("span", {
+                /* @__PURE__ */ jsxDEV7("span", {
                   children: turn.status
                 }, undefined, false, undefined, this)
               ]
             }, undefined, true, undefined, this),
-            /* @__PURE__ */ jsxDEV6("p", {
+            /* @__PURE__ */ jsxDEV7("p", {
               children: turn.detail
             }, undefined, false, undefined, this),
-            /* @__PURE__ */ jsxDEV6("dl", {
-              children: turn.rows.map((row) => /* @__PURE__ */ jsxDEV6("div", {
+            /* @__PURE__ */ jsxDEV7("dl", {
+              children: turn.rows.map((row) => /* @__PURE__ */ jsxDEV7("div", {
                 children: [
-                  /* @__PURE__ */ jsxDEV6("dt", {
+                  /* @__PURE__ */ jsxDEV7("dt", {
                     children: row.label
                   }, undefined, false, undefined, this),
-                  /* @__PURE__ */ jsxDEV6("dd", {
+                  /* @__PURE__ */ jsxDEV7("dd", {
                     children: row.value
                   }, undefined, false, undefined, this)
                 ]
@@ -1774,11 +2038,11 @@ var VoiceTurnQuality = ({
             }, undefined, false, undefined, this)
           ]
         }, `${turn.sessionId}:${turn.turnId}`, true, undefined, this))
-      }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV6("p", {
+      }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV7("p", {
         className: "absolute-voice-turn-quality__empty",
         children: "Complete a voice turn to see STT quality diagnostics."
       }, undefined, false, undefined, this),
-      model.error ? /* @__PURE__ */ jsxDEV6("p", {
+      model.error ? /* @__PURE__ */ jsxDEV7("p", {
         className: "absolute-voice-turn-quality__error",
         children: model.error
       }, undefined, false, undefined, this) : null
@@ -1786,7 +2050,7 @@ var VoiceTurnQuality = ({
   }, undefined, true, undefined, this);
 };
 // src/react/useVoiceStream.tsx
-import { useEffect as useEffect7, useRef as useRef7, useSyncExternalStore as useSyncExternalStore7 } from "react";
+import { useEffect as useEffect8, useRef as useRef8, useSyncExternalStore as useSyncExternalStore8 } from "react";
 
 // src/client/actions.ts
 var normalizeErrorMessage = (value) => {
@@ -2314,13 +2578,13 @@ var EMPTY_SNAPSHOT = {
   turns: []
 };
 var useVoiceStream = (path, options = {}) => {
-  const streamRef = useRef7(null);
+  const streamRef = useRef8(null);
   if (!streamRef.current) {
     streamRef.current = createVoiceStream(path, options);
   }
   const stream = streamRef.current;
-  useEffect7(() => () => stream.close(), [stream]);
-  const snapshot = useSyncExternalStore7(stream.subscribe, stream.getSnapshot, stream.getServerSnapshot) ?? EMPTY_SNAPSHOT;
+  useEffect8(() => () => stream.close(), [stream]);
+  const snapshot = useSyncExternalStore8(stream.subscribe, stream.getSnapshot, stream.getServerSnapshot) ?? EMPTY_SNAPSHOT;
   return {
     ...snapshot,
     callControl: (message) => stream.callControl(message),
@@ -2330,7 +2594,7 @@ var useVoiceStream = (path, options = {}) => {
   };
 };
 // src/react/useVoiceController.tsx
-import { useEffect as useEffect8, useRef as useRef8, useSyncExternalStore as useSyncExternalStore8 } from "react";
+import { useEffect as useEffect9, useRef as useRef9, useSyncExternalStore as useSyncExternalStore9 } from "react";
 
 // src/client/htmx.ts
 var DEFAULT_EVENT_NAME = "voice-refresh";
@@ -2977,13 +3241,13 @@ var EMPTY_SNAPSHOT2 = {
   turns: []
 };
 var useVoiceController = (path, options = {}) => {
-  const controllerRef = useRef8(null);
+  const controllerRef = useRef9(null);
   if (!controllerRef.current) {
     controllerRef.current = createVoiceController(path, options);
   }
   const controller = controllerRef.current;
-  useEffect8(() => () => controller.close(), [controller]);
-  const snapshot = useSyncExternalStore8(controller.subscribe, controller.getSnapshot, controller.getServerSnapshot) ?? EMPTY_SNAPSHOT2;
+  useEffect9(() => () => controller.close(), [controller]);
+  const snapshot = useSyncExternalStore9(controller.subscribe, controller.getSnapshot, controller.getServerSnapshot) ?? EMPTY_SNAPSHOT2;
   return {
     ...snapshot,
     bindHTMX: controller.bindHTMX,
@@ -2997,7 +3261,7 @@ var useVoiceController = (path, options = {}) => {
   };
 };
 // src/react/useVoiceWorkflowStatus.tsx
-import { useEffect as useEffect9, useRef as useRef9, useSyncExternalStore as useSyncExternalStore9 } from "react";
+import { useEffect as useEffect10, useRef as useRef10, useSyncExternalStore as useSyncExternalStore10 } from "react";
 
 // src/client/workflowStatus.ts
 var fetchVoiceWorkflowStatus = async (path = "/evals/scenarios/json", options = {}) => {
@@ -3080,23 +3344,24 @@ var createVoiceWorkflowStatusStore = (path = "/evals/scenarios/json", options =
 
 // src/react/useVoiceWorkflowStatus.tsx
 var useVoiceWorkflowStatus = (path = "/evals/scenarios/json", options = {}) => {
-  const storeRef = useRef9(null);
+  const storeRef = useRef10(null);
   if (!storeRef.current) {
     storeRef.current = createVoiceWorkflowStatusStore(path, options);
   }
   const store = storeRef.current;
-  useEffect9(() => {
+  useEffect10(() => {
     store.refresh().catch(() => {});
     return () => store.close();
   }, [store]);
   return {
-    ...useSyncExternalStore9(store.subscribe, store.getSnapshot, store.getServerSnapshot),
+    ...useSyncExternalStore10(store.subscribe, store.getSnapshot, store.getServerSnapshot),
     refresh: store.refresh
   };
 };
 export {
   useVoiceWorkflowStatus,
   useVoiceTurnQuality,
+  useVoiceTraceTimeline,
   useVoiceStream,
   useVoiceRoutingStatus,
   useVoiceProviderStatus,
@@ -3105,6 +3370,7 @@ export {
   useVoiceController,
   useVoiceAppKitStatus,
   VoiceTurnQuality,
+  VoiceTraceTimeline,
   VoiceRoutingStatus,
   VoiceProviderStatus,
   VoiceProviderSimulationControls,

package/dist/react/useVoiceTraceTimeline.d.ts

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

package/dist/svelte/createVoiceTraceTimeline.d.ts

@@ -0,0 +1,10 @@
+import { type VoiceTraceTimelineWidgetOptions } from '../client/traceTimelineWidget';
+export declare const createVoiceTraceTimeline: (path?: string, options?: VoiceTraceTimelineWidgetOptions) => {
+    getHTML: () => string;
+    getViewModel: () => import("../client").VoiceTraceTimelineViewModel;
+    close: () => void;
+    getServerSnapshot: () => import("../client").VoiceTraceTimelineSnapshot;
+    getSnapshot: () => import("../client").VoiceTraceTimelineSnapshot;
+    refresh: () => Promise<import("..").VoiceTraceTimelineReport | null>;
+    subscribe: (listener: () => void) => () => void;
+};

package/dist/svelte/index.d.ts

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