@absolutejs/voice 0.0.22-beta.93 → 0.0.22-beta.95

package/dist/client/index.js

@@ -2330,6 +2330,80 @@ var createVoiceTurnQualityStore = (path = "/api/turn-quality", options = {}) =>
     }
   };
 };
+// src/client/turnLatency.ts
+var fetchVoiceTurnLatency = async (path = "/api/turn-latency", options = {}) => {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const response = await fetchImpl(path);
+  if (!response.ok) {
+    throw new Error(`Voice turn latency failed: HTTP ${response.status}`);
+  }
+  return await response.json();
+};
+var createVoiceTurnLatencyStore = (path = "/api/turn-latency", 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 fetchVoiceTurnLatency(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/traceTimeline.ts
 var fetchVoiceTraceTimeline = async (path = "/api/voice-traces", options = {}) => {
   const fetchImpl = options.fetch ?? globalThis.fetch;
@@ -2927,51 +3001,136 @@ var defineVoiceTurnQualityElement = (tagName = "absolute-voice-turn-quality") =>
     }
   });
 };
-// src/client/traceTimelineWidget.ts
-var DEFAULT_TITLE6 = "Voice Traces";
-var DEFAULT_DESCRIPTION6 = "Latest call timelines with provider latency, fallbacks, handoffs, and errors from your self-hosted trace store.";
+// src/client/turnLatencyWidget.ts
+var DEFAULT_TITLE6 = "Turn Latency";
+var DEFAULT_DESCRIPTION6 = "Per-turn timing from first transcript to commit and assistant response start.";
 var escapeHtml7 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var formatMs = (value) => typeof value === "number" ? `${value}ms` : "n/a";
+var formatMs = (value) => typeof value === "number" ? `${Math.round(value)}ms` : "n/a";
+var createVoiceTurnLatencyViewModel = (snapshot, options = {}) => {
+  const turns = (snapshot.report?.turns ?? []).map((turn) => ({
+    ...turn,
+    label: turn.text || "Empty turn",
+    rows: turn.stages.map((stage) => ({
+      label: stage.label,
+      value: formatMs(stage.valueMs)
+    }))
+  }));
+  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_DESCRIPTION6,
+    error: snapshot.error,
+    isLoading: snapshot.isLoading,
+    label: snapshot.error ? "Unavailable" : turns.length ? failedCount > 0 ? `${failedCount} slow` : warningCount > 0 ? `${warningCount} warnings` : `avg ${formatMs(snapshot.report?.averageTotalMs)}` : 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_TITLE6,
+    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--${escapeHtml7(turn.status)}">
+  <header>
+    <strong>${escapeHtml7(turn.label)}</strong>
+    <span>${escapeHtml7(turn.status)}</span>
+  </header>
+  <dl>${turn.rows.map((row) => `<div>
+    <dt>${escapeHtml7(row.label)}</dt>
+    <dd>${escapeHtml7(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--${escapeHtml7(model.status)}">
+  <header class="absolute-voice-turn-latency__header">
+    <span class="absolute-voice-turn-latency__eyebrow">${escapeHtml7(model.title)}</span>
+    <strong class="absolute-voice-turn-latency__label">${escapeHtml7(model.label)}</strong>
+  </header>
+  <p class="absolute-voice-turn-latency__description">${escapeHtml7(model.description)}</p>
+  ${turns}
+  ${model.error ? `<p class="absolute-voice-turn-latency__error">${escapeHtml7(model.error)}</p>` : ""}
+</section>`;
+};
+var mountVoiceTurnLatency = (element, path = "/api/turn-latency", options = {}) => {
+  const store = createVoiceTurnLatencyStore(path, options);
+  const render = () => {
+    element.innerHTML = renderVoiceTurnLatencyHTML(store.getSnapshot(), options);
+  };
+  const unsubscribe = store.subscribe(render);
+  render();
+  store.refresh().catch(() => {});
+  return {
+    close: () => {
+      unsubscribe();
+      store.close();
+    },
+    refresh: store.refresh
+  };
+};
+var defineVoiceTurnLatencyElement = (tagName = "absolute-voice-turn-latency") => {
+  if (typeof window === "undefined" || typeof customElements === "undefined" || customElements.get(tagName)) {
+    return;
+  }
+  customElements.define(tagName, class AbsoluteVoiceTurnLatencyElement extends HTMLElement {
+    mounted;
+    connectedCallback() {
+      const intervalMs = Number(this.getAttribute("interval-ms") ?? 5000);
+      this.mounted = mountVoiceTurnLatency(this, this.getAttribute("path") ?? "/api/turn-latency", {
+        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/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 formatMs2 = (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),
+    durationLabel: formatMs2(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_DESCRIPTION6,
+    description: options.description ?? DEFAULT_DESCRIPTION7,
     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_TITLE6,
+    title: options.title ?? DEFAULT_TITLE7,
     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--${escapeHtml7(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--${escapeHtml8(session.status)}">
   <header>
-    <strong>${escapeHtml7(session.sessionId)}</strong>
-    <span>${escapeHtml7(session.status)}</span>
+    <strong>${escapeHtml8(session.sessionId)}</strong>
+    <span>${escapeHtml8(session.status)}</span>
   </header>
-  <p>${escapeHtml7(session.label)} \xB7 ${escapeHtml7(session.durationLabel)} \xB7 ${escapeHtml7(session.providerLabel)}</p>
-  <a href="${escapeHtml7(session.detailHref)}">Open timeline</a>
+  <p>${escapeHtml8(session.label)} \xB7 ${escapeHtml8(session.durationLabel)} \xB7 ${escapeHtml8(session.providerLabel)}</p>
+  <a href="${escapeHtml8(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--${escapeHtml7(model.status)}">
+  return `<section class="absolute-voice-trace-timeline absolute-voice-trace-timeline--${escapeHtml8(model.status)}">
   <header class="absolute-voice-trace-timeline__header">
-    <span class="absolute-voice-trace-timeline__eyebrow">${escapeHtml7(model.title)}</span>
-    <strong class="absolute-voice-trace-timeline__label">${escapeHtml7(model.label)}</strong>
+    <span class="absolute-voice-trace-timeline__eyebrow">${escapeHtml8(model.title)}</span>
+    <strong class="absolute-voice-trace-timeline__label">${escapeHtml8(model.label)}</strong>
   </header>
-  <p class="absolute-voice-trace-timeline__description">${escapeHtml7(model.description)}</p>
+  <p class="absolute-voice-trace-timeline__description">${escapeHtml8(model.description)}</p>
   ${sessions}
-  ${model.error ? `<p class="absolute-voice-trace-timeline__error">${escapeHtml7(model.error)}</p>` : ""}
+  ${model.error ? `<p class="absolute-voice-trace-timeline__error">${escapeHtml8(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}`;
@@ -3094,6 +3253,7 @@ var createVoiceWorkflowStatusStore = (path = "/evals/scenarios/json", options =
 };
 export {
   renderVoiceTurnQualityHTML,
+  renderVoiceTurnLatencyHTML,
   renderVoiceTraceTimelineWidgetHTML,
   renderVoiceRoutingStatusHTML,
   renderVoiceProviderStatusHTML,
@@ -3101,6 +3261,7 @@ export {
   renderVoiceProviderCapabilitiesHTML,
   renderVoiceOpsStatusHTML,
   mountVoiceTurnQuality,
+  mountVoiceTurnLatency,
   mountVoiceTraceTimeline,
   mountVoiceRoutingStatus,
   mountVoiceProviderStatus,
@@ -3116,12 +3277,14 @@ export {
   getVoiceOpsStatusCSS,
   fetchVoiceWorkflowStatus,
   fetchVoiceTurnQuality,
+  fetchVoiceTurnLatency,
   fetchVoiceTraceTimeline,
   fetchVoiceRoutingStatus,
   fetchVoiceProviderStatus,
   fetchVoiceProviderCapabilities,
   fetchVoiceAppKitStatus,
   defineVoiceTurnQualityElement,
+  defineVoiceTurnLatencyElement,
   defineVoiceTraceTimelineElement,
   defineVoiceRoutingStatusElement,
   defineVoiceProviderStatusElement,
@@ -3132,6 +3295,8 @@ export {
   createVoiceWorkflowStatusStore,
   createVoiceTurnQualityViewModel,
   createVoiceTurnQualityStore,
+  createVoiceTurnLatencyViewModel,
+  createVoiceTurnLatencyStore,
   createVoiceTraceTimelineViewModel,
   createVoiceTraceTimelineStore,
   createVoiceStream,

package/dist/client/turnLatency.d.ts

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

package/dist/client/turnLatencyWidget.d.ts

@@ -0,0 +1,30 @@
+import type { VoiceTurnLatencyItem } from '../turnLatency';
+import { type VoiceTurnLatencyClientOptions, type VoiceTurnLatencySnapshot } from './turnLatency';
+export type VoiceTurnLatencyCardView = VoiceTurnLatencyItem & {
+    label: string;
+    rows: Array<{
+        label: string;
+        value: string;
+    }>;
+};
+export type VoiceTurnLatencyViewModel = {
+    description: string;
+    error: string | null;
+    isLoading: boolean;
+    label: string;
+    status: 'empty' | 'error' | 'loading' | 'ready' | 'warning';
+    title: string;
+    turns: VoiceTurnLatencyCardView[];
+    updatedAt?: number;
+};
+export type VoiceTurnLatencyWidgetOptions = VoiceTurnLatencyClientOptions & {
+    description?: string;
+    title?: string;
+};
+export declare const createVoiceTurnLatencyViewModel: (snapshot: VoiceTurnLatencySnapshot, options?: VoiceTurnLatencyWidgetOptions) => VoiceTurnLatencyViewModel;
+export declare const renderVoiceTurnLatencyHTML: (snapshot: VoiceTurnLatencySnapshot, options?: VoiceTurnLatencyWidgetOptions) => string;
+export declare const mountVoiceTurnLatency: (element: Element, path?: string, options?: VoiceTurnLatencyWidgetOptions) => {
+    close: () => void;
+    refresh: () => Promise<import("..").VoiceTurnLatencyReport | undefined>;
+};
+export declare const defineVoiceTurnLatencyElement: (tagName?: string) => void;

package/dist/index.d.ts

@@ -10,6 +10,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 { createVoiceTurnLatencyHTMLHandler, createVoiceTurnLatencyJSONHandler, createVoiceTurnLatencyRoutes, renderVoiceTurnLatencyHTML, summarizeVoiceTurnLatency } from './turnLatency';
 export { createVoiceTurnQualityHTMLHandler, createVoiceTurnQualityJSONHandler, createVoiceTurnQualityRoutes, renderVoiceTurnQualityHTML, summarizeVoiceTurnQuality } from './turnQuality';
 export { createVoiceOutcomeContractHTMLHandler, createVoiceOutcomeContractJSONHandler, createVoiceOutcomeContractRoutes, renderVoiceOutcomeContractHTML, runVoiceOutcomeContractSuite } from './outcomeContract';
 export { applyVoiceTelephonyOutcome, createMemoryVoiceTelephonyWebhookIdempotencyStore, createVoiceTelephonyOutcomePolicy, createVoiceTelephonyWebhookHandler, createVoiceTelephonyWebhookRoutes, parseVoiceTelephonyWebhookEvent, resolveVoiceTelephonyOutcome, signVoiceTwilioWebhook, verifyVoiceTwilioWebhookSignature, voiceTelephonyOutcomeToRouteResult } from './telephonyOutcome';
@@ -61,6 +62,7 @@ export type { AnthropicVoiceAssistantModelOptions, GeminiVoiceAssistantModelOpti
 export type { OpenAIVoiceTTSOptions, OpenAIVoiceTTSVoice } from './openaiTTS';
 export type { VoiceProviderHealthStatus, VoiceProviderHealthSummary, VoiceProviderHealthSummaryOptions } from './providerHealth';
 export type { VoiceProviderCapabilityDefinition, VoiceProviderCapabilityHandlerOptions, VoiceProviderCapabilityHTMLHandlerOptions, VoiceProviderCapabilityKind, VoiceProviderCapabilityOptions, VoiceProviderCapabilityReport, VoiceProviderCapabilityRoutesOptions, VoiceProviderCapabilitySummary } from './providerCapabilities';
+export type { VoiceTurnLatencyHTMLHandlerOptions, VoiceTurnLatencyItem, VoiceTurnLatencyOptions, VoiceTurnLatencyReport, VoiceTurnLatencyRoutesOptions, VoiceTurnLatencyStage, VoiceTurnLatencyStatus } from './turnLatency';
 export type { VoiceTurnQualityHTMLHandlerOptions, VoiceTurnQualityItem, VoiceTurnQualityOptions, VoiceTurnQualityReport, VoiceTurnQualityRoutesOptions, VoiceTurnQualityStatus } from './turnQuality';
 export type { VoiceOutcomeContractDefinition, VoiceOutcomeContractHTMLHandlerOptions, VoiceOutcomeContractIssue, VoiceOutcomeContractOptions, VoiceOutcomeContractReport, VoiceOutcomeContractRoutesOptions, VoiceOutcomeContractStatus, VoiceOutcomeContractSuiteReport } from './outcomeContract';
 export type { VoiceTelephonyOutcomeAction, VoiceTelephonyOutcomeDecision, VoiceTelephonyOutcomePolicy, VoiceTelephonyOutcomeProviderEvent, VoiceTelephonyOutcomeRouteResult, VoiceTelephonyOutcomeStatusDecision, VoiceTelephonyWebhookDecision, VoiceTelephonyWebhookHandlerOptions, VoiceTelephonyWebhookIdempotencyStore, VoiceTelephonyWebhookParseInput, VoiceTelephonyWebhookProvider, VoiceTelephonyWebhookRoutesOptions, VoiceTelephonyWebhookVerificationResult, StoredVoiceTelephonyWebhookDecision } from './telephonyOutcome';