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

package/dist/svelte/index.js

@@ -1757,6 +1757,176 @@ var createVoiceTraceTimeline = (path = "/api/voice-traces", options = {}) => {
     getViewModel: () => createVoiceTraceTimelineViewModel(store.getSnapshot(), 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/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 formatMs2 = (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: formatMs2(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 ${formatMs2(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/svelte/createVoiceTurnLatency.ts
+var createVoiceTurnLatency = (path = "/api/turn-latency", options = {}) => {
+  const store = createVoiceTurnLatencyStore(path, options);
+  return {
+    ...store,
+    getHTML: () => renderVoiceTurnLatencyHTML(store.getSnapshot(), options),
+    getViewModel: () => createVoiceTurnLatencyViewModel(store.getSnapshot(), options)
+  };
+};
 // src/client/turnQuality.ts
 var fetchVoiceTurnQuality = async (path = "/api/turn-quality", options = {}) => {
   const fetchImpl = options.fetch ?? globalThis.fetch;
@@ -1837,9 +2007,9 @@ var createVoiceTurnQualityStore = (path = "/api/turn-quality", options = {}) =>
 };
 
 // src/client/turnQualityWidget.ts
-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 DEFAULT_TITLE7 = "Turn Quality";
+var DEFAULT_DESCRIPTION7 = "Per-turn STT confidence, fallback selection, corrections, and transcript coverage.";
+var escapeHtml8 = (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) => {
@@ -1877,37 +2047,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_DESCRIPTION6,
+    description: options.description ?? DEFAULT_DESCRIPTION7,
     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_TITLE6,
+    title: options.title ?? DEFAULT_TITLE7,
     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--${escapeHtml7(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--${escapeHtml8(turn.status)}">
   <header>
-    <strong>${escapeHtml7(turn.label)}</strong>
-    <span>${escapeHtml7(turn.status)}</span>
+    <strong>${escapeHtml8(turn.label)}</strong>
+    <span>${escapeHtml8(turn.status)}</span>
   </header>
-  <p>${escapeHtml7(turn.detail)}</p>
+  <p>${escapeHtml8(turn.detail)}</p>
   <dl>${turn.rows.map((row) => `<div>
-    <dt>${escapeHtml7(row.label)}</dt>
-    <dd>${escapeHtml7(row.value)}</dd>
+    <dt>${escapeHtml8(row.label)}</dt>
+    <dd>${escapeHtml8(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--${escapeHtml7(model.status)}">
+  return `<section class="absolute-voice-turn-quality absolute-voice-turn-quality--${escapeHtml8(model.status)}">
   <header class="absolute-voice-turn-quality__header">
-    <span class="absolute-voice-turn-quality__eyebrow">${escapeHtml7(model.title)}</span>
-    <strong class="absolute-voice-turn-quality__label">${escapeHtml7(model.label)}</strong>
+    <span class="absolute-voice-turn-quality__eyebrow">${escapeHtml8(model.title)}</span>
+    <strong class="absolute-voice-turn-quality__label">${escapeHtml8(model.label)}</strong>
   </header>
-  <p class="absolute-voice-turn-quality__description">${escapeHtml7(model.description)}</p>
+  <p class="absolute-voice-turn-quality__description">${escapeHtml8(model.description)}</p>
   ${turns}
-  ${model.error ? `<p class="absolute-voice-turn-quality__error">${escapeHtml7(model.error)}</p>` : ""}
+  ${model.error ? `<p class="absolute-voice-turn-quality__error">${escapeHtml8(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}`;
@@ -2676,6 +2846,7 @@ var createVoiceController = (path, options = {}) => {
 export {
   createVoiceWorkflowStatus,
   createVoiceTurnQuality,
+  createVoiceTurnLatency,
   createVoiceTraceTimeline,
   createVoiceStream2 as createVoiceStream,
   createVoiceRoutingStatus,

package/dist/turnLatency.d.ts

@@ -0,0 +1,93 @@
+import { Elysia } from 'elysia';
+import type { VoiceSessionRecord, VoiceSessionStore } from './types';
+export type VoiceTurnLatencyStatus = 'pass' | 'warn' | 'fail' | 'empty';
+export type VoiceTurnLatencyStage = {
+    label: string;
+    valueMs?: number;
+};
+export type VoiceTurnLatencyItem = {
+    assistantTextStartedAt?: number;
+    committedAt: number;
+    finalTranscriptAt?: number;
+    firstTranscriptAt?: number;
+    sessionId: string;
+    stages: VoiceTurnLatencyStage[];
+    status: VoiceTurnLatencyStatus;
+    text: string;
+    totalMs?: number;
+    turnId: string;
+};
+export type VoiceTurnLatencyReport = {
+    averageTotalMs?: number;
+    checkedAt: number;
+    failed: number;
+    sessions: number;
+    status: VoiceTurnLatencyStatus;
+    total: number;
+    turns: VoiceTurnLatencyItem[];
+    warnings: number;
+};
+export type VoiceTurnLatencyOptions<TSession extends VoiceSessionRecord = VoiceSessionRecord> = {
+    limit?: number;
+    sessionIds?: string[];
+    sessions?: TSession[];
+    store?: VoiceSessionStore<TSession>;
+    warnAfterMs?: number;
+    failAfterMs?: number;
+};
+export type VoiceTurnLatencyHTMLHandlerOptions<TSession extends VoiceSessionRecord = VoiceSessionRecord> = VoiceTurnLatencyOptions<TSession> & {
+    headers?: HeadersInit;
+    render?: (report: VoiceTurnLatencyReport) => string | Promise<string>;
+    title?: string;
+};
+export type VoiceTurnLatencyRoutesOptions<TSession extends VoiceSessionRecord = VoiceSessionRecord> = VoiceTurnLatencyHTMLHandlerOptions<TSession> & {
+    htmlPath?: false | string;
+    name?: string;
+    path?: string;
+};
+export declare const summarizeVoiceTurnLatency: <TSession extends VoiceSessionRecord = VoiceSessionRecord>(options: VoiceTurnLatencyOptions<TSession>) => Promise<VoiceTurnLatencyReport>;
+export declare const renderVoiceTurnLatencyHTML: (report: VoiceTurnLatencyReport, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceTurnLatencyJSONHandler: <TSession extends VoiceSessionRecord = VoiceSessionRecord>(options: VoiceTurnLatencyOptions<TSession>) => () => Promise<VoiceTurnLatencyReport>;
+export declare const createVoiceTurnLatencyHTMLHandler: <TSession extends VoiceSessionRecord = VoiceSessionRecord>(options: VoiceTurnLatencyHTMLHandlerOptions<TSession>) => () => Promise<Response>;
+export declare const createVoiceTurnLatencyRoutes: <TSession extends VoiceSessionRecord = VoiceSessionRecord>(options: VoiceTurnLatencyRoutesOptions<TSession>) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    [x: string]: {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: VoiceTurnLatencyReport;
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/vue/VoiceTurnLatency.d.ts

@@ -0,0 +1,51 @@
+export declare const VoiceTurnLatency: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    class: {
+        default: string;
+        type: StringConstructor;
+    };
+    description: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    intervalMs: {
+        default: number;
+        type: NumberConstructor;
+    };
+    path: {
+        default: string;
+        type: StringConstructor;
+    };
+    title: {
+        default: undefined;
+        type: 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<{
+    class: {
+        default: string;
+        type: StringConstructor;
+    };
+    description: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    intervalMs: {
+        default: number;
+        type: NumberConstructor;
+    };
+    path: {
+        default: string;
+        type: StringConstructor;
+    };
+    title: {
+        default: undefined;
+        type: StringConstructor;
+    };
+}>> & Readonly<{}>, {
+    description: string;
+    title: string;
+    path: string;
+    intervalMs: number;
+    class: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/vue/index.d.ts

@@ -3,6 +3,7 @@ export { VoiceProviderSimulationControls } from './VoiceProviderSimulationContro
 export { VoiceProviderCapabilities } from './VoiceProviderCapabilities';
 export { VoiceProviderStatus } from './VoiceProviderStatus';
 export { VoiceRoutingStatus } from './VoiceRoutingStatus';
+export { VoiceTurnLatency } from './VoiceTurnLatency';
 export { VoiceTurnQuality } from './VoiceTurnQuality';
 export { useVoiceAppKitStatus } from './useVoiceAppKitStatus';
 export { useVoiceStream } from './useVoiceStream';
@@ -12,5 +13,6 @@ export { useVoiceProviderCapabilities } from './useVoiceProviderCapabilities';
 export { useVoiceProviderSimulationControls } from './useVoiceProviderSimulationControls';
 export { useVoiceRoutingStatus } from './useVoiceRoutingStatus';
 export { useVoiceTraceTimeline } from './useVoiceTraceTimeline';
+export { useVoiceTurnLatency } from './useVoiceTurnLatency';
 export { useVoiceTurnQuality } from './useVoiceTurnQuality';
 export { useVoiceWorkflowStatus } from './useVoiceWorkflowStatus';