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

package/dist/vue/index.js

@@ -1531,8 +1531,283 @@ var VoiceRoutingStatus = defineComponent5({
     ]);
   }
 });
+// src/vue/VoiceTurnQuality.ts
+import { computed as computed5, defineComponent as defineComponent6, h as h6 } from "vue";
+
+// src/client/turnQuality.ts
+var fetchVoiceTurnQuality = async (path = "/api/turn-quality", options = {}) => {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const response = await fetchImpl(path);
+  if (!response.ok) {
+    throw new Error(`Voice turn quality failed: HTTP ${response.status}`);
+  }
+  return await response.json();
+};
+var createVoiceTurnQualityStore = (path = "/api/turn-quality", options = {}) => {
+  const listeners = new Set;
+  let closed = false;
+  let timer;
+  let snapshot = {
+    error: null,
+    isLoading: false
+  };
+  const emit = () => {
+    for (const listener of listeners) {
+      listener();
+    }
+  };
+  const refresh = async () => {
+    if (closed) {
+      return snapshot.report;
+    }
+    snapshot = {
+      ...snapshot,
+      error: null,
+      isLoading: true
+    };
+    emit();
+    try {
+      const report = await fetchVoiceTurnQuality(path, options);
+      snapshot = {
+        error: null,
+        isLoading: false,
+        report,
+        updatedAt: Date.now()
+      };
+      emit();
+      return report;
+    } catch (error) {
+      snapshot = {
+        ...snapshot,
+        error: error instanceof Error ? error.message : String(error),
+        isLoading: false
+      };
+      emit();
+      throw error;
+    }
+  };
+  const close = () => {
+    closed = true;
+    if (timer) {
+      clearInterval(timer);
+      timer = undefined;
+    }
+    listeners.clear();
+  };
+  if (options.intervalMs && options.intervalMs > 0) {
+    timer = setInterval(() => {
+      refresh().catch(() => {});
+    }, options.intervalMs);
+  }
+  return {
+    close,
+    getServerSnapshot: () => snapshot,
+    getSnapshot: () => snapshot,
+    refresh,
+    subscribe: (listener) => {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+  };
+};
+
+// src/client/turnQualityWidget.ts
+var DEFAULT_TITLE5 = "Turn Quality";
+var DEFAULT_DESCRIPTION5 = "Per-turn STT confidence, fallback selection, corrections, and transcript coverage.";
+var escapeHtml6 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var formatConfidence = (value) => typeof value === "number" ? `${Math.round(value * 100)}%` : "n/a";
+var formatMaybe = (value) => value === undefined || value === "" ? "n/a" : String(value);
+var getTurnDetail = (turn) => {
+  if (turn.status === "fail") {
+    return "Empty or unusable committed turn; inspect transcripts and adapter events.";
+  }
+  if (turn.fallbackUsed) {
+    return `Fallback STT selected${turn.fallbackSelectionReason ? ` by ${turn.fallbackSelectionReason}` : ""}.`;
+  }
+  if (turn.correctionChanged) {
+    return `Correction changed the turn${turn.correctionProvider ? ` via ${turn.correctionProvider}` : ""}.`;
+  }
+  if (turn.status === "warn") {
+    return "Turn completed with quality warnings.";
+  }
+  if (turn.status === "unknown") {
+    return "No quality diagnostics were recorded for this turn.";
+  }
+  return "Turn quality looks healthy.";
+};
+var createVoiceTurnQualityViewModel = (snapshot, options = {}) => {
+  const turns = (snapshot.report?.turns ?? []).map((turn) => ({
+    ...turn,
+    detail: getTurnDetail(turn),
+    label: turn.text || "Empty turn",
+    rows: [
+      { label: "Source", value: turn.source ?? "unknown" },
+      { label: "Confidence", value: formatConfidence(turn.averageConfidence) },
+      { label: "Fallback", value: turn.fallbackUsed ? "Yes" : "No" },
+      { label: "Correction", value: turn.correctionChanged ? "Changed" : "None" },
+      { label: "Transcripts", value: `${turn.selectedTranscriptCount} selected` },
+      { label: "Cost", value: formatMaybe(turn.costUnits) }
+    ]
+  }));
+  const warningCount = snapshot.report?.warnings ?? turns.filter((turn) => turn.status === "warn").length;
+  const failedCount = snapshot.report?.failed ?? turns.filter((turn) => turn.status === "fail").length;
+  return {
+    description: options.description ?? DEFAULT_DESCRIPTION5,
+    error: snapshot.error,
+    isLoading: snapshot.isLoading,
+    label: snapshot.error ? "Unavailable" : turns.length ? failedCount > 0 ? `${failedCount} failed` : warningCount > 0 ? `${warningCount} warnings` : `${turns.length} healthy` : snapshot.isLoading ? "Checking" : "No turns",
+    status: snapshot.error ? "error" : turns.length ? failedCount > 0 || warningCount > 0 ? "warning" : "ready" : snapshot.isLoading ? "loading" : "empty",
+    title: options.title ?? DEFAULT_TITLE5,
+    turns,
+    updatedAt: snapshot.updatedAt
+  };
+};
+var renderVoiceTurnQualityHTML = (snapshot, options = {}) => {
+  const model = createVoiceTurnQualityViewModel(snapshot, options);
+  const turns = model.turns.length ? `<div class="absolute-voice-turn-quality__turns">${model.turns.map((turn) => `<article class="absolute-voice-turn-quality__turn absolute-voice-turn-quality__turn--${escapeHtml6(turn.status)}">
+  <header>
+    <strong>${escapeHtml6(turn.label)}</strong>
+    <span>${escapeHtml6(turn.status)}</span>
+  </header>
+  <p>${escapeHtml6(turn.detail)}</p>
+  <dl>${turn.rows.map((row) => `<div>
+    <dt>${escapeHtml6(row.label)}</dt>
+    <dd>${escapeHtml6(row.value)}</dd>
+  </div>`).join("")}</dl>
+</article>`).join("")}</div>` : '<p class="absolute-voice-turn-quality__empty">Complete a voice turn to see STT quality diagnostics.</p>';
+  return `<section class="absolute-voice-turn-quality absolute-voice-turn-quality--${escapeHtml6(model.status)}">
+  <header class="absolute-voice-turn-quality__header">
+    <span class="absolute-voice-turn-quality__eyebrow">${escapeHtml6(model.title)}</span>
+    <strong class="absolute-voice-turn-quality__label">${escapeHtml6(model.label)}</strong>
+  </header>
+  <p class="absolute-voice-turn-quality__description">${escapeHtml6(model.description)}</p>
+  ${turns}
+  ${model.error ? `<p class="absolute-voice-turn-quality__error">${escapeHtml6(model.error)}</p>` : ""}
+</section>`;
+};
+var getVoiceTurnQualityCSS = () => `.absolute-voice-turn-quality{border:1px solid #e4d1a3;border-radius:20px;background:#fff9eb;color:#17120a;padding:18px;box-shadow:0 18px 40px rgba(73,48,14,.12);font-family:inherit}.absolute-voice-turn-quality--error,.absolute-voice-turn-quality--warning{border-color:#f2a7a7;background:#fff5f3}.absolute-voice-turn-quality__header,.absolute-voice-turn-quality__turn header{align-items:start;display:flex;gap:12px;justify-content:space-between}.absolute-voice-turn-quality__eyebrow{color:#8a5a0a;font-size:12px;font-weight:800;letter-spacing:.08em;text-transform:uppercase}.absolute-voice-turn-quality__label{font-size:24px;line-height:1}.absolute-voice-turn-quality__description,.absolute-voice-turn-quality__turn p,.absolute-voice-turn-quality__turn dt,.absolute-voice-turn-quality__empty{color:#5a4930}.absolute-voice-turn-quality__turns{display:grid;gap:12px;margin-top:14px}.absolute-voice-turn-quality__turn{background:#fff;border:1px solid #f0dfba;border-radius:16px;padding:14px}.absolute-voice-turn-quality__turn--pass{border-color:#86efac}.absolute-voice-turn-quality__turn--warn,.absolute-voice-turn-quality__turn--unknown{border-color:#fbbf24}.absolute-voice-turn-quality__turn--fail{border-color:#f2a7a7}.absolute-voice-turn-quality__turn p{margin:10px 0}.absolute-voice-turn-quality__turn dl{display:grid;gap:8px;grid-template-columns:repeat(2,minmax(0,1fr));margin:0}.absolute-voice-turn-quality__turn div{background:#fff9eb;border:1px solid #f0dfba;border-radius:12px;padding:8px}.absolute-voice-turn-quality__turn dt{font-size:12px}.absolute-voice-turn-quality__turn dd{font-weight:800;margin:4px 0 0}.absolute-voice-turn-quality__empty{margin:14px 0 0}.absolute-voice-turn-quality__error{color:#9f1239;font-weight:700}`;
+var mountVoiceTurnQuality = (element, path = "/api/turn-quality", options = {}) => {
+  const store = createVoiceTurnQualityStore(path, options);
+  const render = () => {
+    element.innerHTML = renderVoiceTurnQualityHTML(store.getSnapshot(), options);
+  };
+  const unsubscribe = store.subscribe(render);
+  render();
+  store.refresh().catch(() => {});
+  return {
+    close: () => {
+      unsubscribe();
+      store.close();
+    },
+    refresh: store.refresh
+  };
+};
+var defineVoiceTurnQualityElement = (tagName = "absolute-voice-turn-quality") => {
+  if (typeof window === "undefined" || typeof customElements === "undefined" || customElements.get(tagName)) {
+    return;
+  }
+  customElements.define(tagName, class AbsoluteVoiceTurnQualityElement extends HTMLElement {
+    mounted;
+    connectedCallback() {
+      const intervalMs = Number(this.getAttribute("interval-ms") ?? 5000);
+      this.mounted = mountVoiceTurnQuality(this, this.getAttribute("path") ?? "/api/turn-quality", {
+        description: this.getAttribute("description") ?? undefined,
+        intervalMs: Number.isFinite(intervalMs) ? intervalMs : 5000,
+        title: this.getAttribute("title") ?? undefined
+      });
+    }
+    disconnectedCallback() {
+      this.mounted?.close();
+      this.mounted = undefined;
+    }
+  });
+};
+
+// src/vue/useVoiceTurnQuality.ts
+import { onUnmounted as onUnmounted6, shallowRef as shallowRef5 } from "vue";
+var useVoiceTurnQuality = (path = "/api/turn-quality", options = {}) => {
+  const store = createVoiceTurnQualityStore(path, options);
+  const error = shallowRef5(null);
+  const isLoading = shallowRef5(false);
+  const report = shallowRef5();
+  const updatedAt = shallowRef5(undefined);
+  const sync = () => {
+    const snapshot = store.getSnapshot();
+    error.value = snapshot.error;
+    isLoading.value = snapshot.isLoading;
+    report.value = snapshot.report;
+    updatedAt.value = snapshot.updatedAt;
+  };
+  const unsubscribe = store.subscribe(sync);
+  sync();
+  store.refresh().catch(() => {});
+  onUnmounted6(() => {
+    unsubscribe();
+    store.close();
+  });
+  return { error, isLoading, refresh: store.refresh, report, updatedAt };
+};
+
+// src/vue/VoiceTurnQuality.ts
+var VoiceTurnQuality = defineComponent6({
+  name: "VoiceTurnQuality",
+  props: {
+    class: { default: "", type: String },
+    description: { default: undefined, type: String },
+    intervalMs: { default: 5000, type: Number },
+    path: { default: "/api/turn-quality", type: String },
+    title: { default: undefined, type: String }
+  },
+  setup(props) {
+    const options = {
+      description: props.description,
+      intervalMs: props.intervalMs,
+      title: props.title
+    };
+    const quality = useVoiceTurnQuality(props.path, options);
+    const model = computed5(() => createVoiceTurnQualityViewModel({
+      error: quality.error.value,
+      isLoading: quality.isLoading.value,
+      report: quality.report.value,
+      updatedAt: quality.updatedAt.value
+    }, options));
+    return () => h6("section", {
+      class: [
+        "absolute-voice-turn-quality",
+        `absolute-voice-turn-quality--${model.value.status}`,
+        props.class
+      ]
+    }, [
+      h6("header", { class: "absolute-voice-turn-quality__header" }, [
+        h6("span", { class: "absolute-voice-turn-quality__eyebrow" }, model.value.title),
+        h6("strong", { class: "absolute-voice-turn-quality__label" }, model.value.label)
+      ]),
+      h6("p", { class: "absolute-voice-turn-quality__description" }, model.value.description),
+      model.value.turns.length ? h6("div", { class: "absolute-voice-turn-quality__turns" }, model.value.turns.map((turn) => h6("article", {
+        class: [
+          "absolute-voice-turn-quality__turn",
+          `absolute-voice-turn-quality__turn--${turn.status}`
+        ],
+        key: `${turn.sessionId}:${turn.turnId}`
+      }, [
+        h6("header", [
+          h6("strong", turn.label),
+          h6("span", turn.status)
+        ]),
+        h6("p", turn.detail),
+        h6("dl", turn.rows.map((row) => h6("div", { key: row.label }, [
+          h6("dt", row.label),
+          h6("dd", row.value)
+        ])))
+      ]))) : h6("p", { class: "absolute-voice-turn-quality__empty" }, "Complete a voice turn to see STT quality diagnostics."),
+      model.value.error ? h6("p", { class: "absolute-voice-turn-quality__error" }, model.value.error) : null
+    ]);
+  }
+});
 // src/vue/useVoiceStream.ts
-import { onUnmounted as onUnmounted6, ref as ref5, shallowRef as shallowRef5 } from "vue";
+import { onUnmounted as onUnmounted7, ref as ref5, shallowRef as shallowRef6 } from "vue";
 
 // src/client/actions.ts
 var normalizeErrorMessage = (value) => {
@@ -2050,15 +2325,15 @@ var createVoiceStream = (path, options = {}) => {
 // src/vue/useVoiceStream.ts
 var useVoiceStream = (path, options = {}) => {
   const stream = createVoiceStream(path, options);
-  const assistantAudio = shallowRef5([]);
-  const assistantTexts = shallowRef5([]);
-  const call = shallowRef5(null);
+  const assistantAudio = shallowRef6([]);
+  const assistantTexts = shallowRef6([]);
+  const call = shallowRef6(null);
   const error = ref5(null);
   const isConnected = ref5(false);
   const partial = ref5("");
   const sessionId = ref5(stream.sessionId);
   const status = ref5(stream.status);
-  const turns = shallowRef5([]);
+  const turns = shallowRef6([]);
   const sync = () => {
     assistantAudio.value = [...stream.assistantAudio];
     assistantTexts.value = [...stream.assistantTexts];
@@ -2076,7 +2351,7 @@ var useVoiceStream = (path, options = {}) => {
     unsubscribe();
     stream.close();
   };
-  onUnmounted6(destroy);
+  onUnmounted7(destroy);
   return {
     assistantAudio,
     assistantTexts,
@@ -2094,7 +2369,7 @@ var useVoiceStream = (path, options = {}) => {
   };
 };
 // src/vue/useVoiceController.ts
-import { onUnmounted as onUnmounted7, ref as ref6, shallowRef as shallowRef6 } from "vue";
+import { onUnmounted as onUnmounted8, ref as ref6, shallowRef as shallowRef7 } from "vue";
 
 // src/client/htmx.ts
 var DEFAULT_EVENT_NAME = "voice-refresh";
@@ -2729,8 +3004,8 @@ var createVoiceController = (path, options = {}) => {
 // src/vue/useVoiceController.ts
 var useVoiceController = (path, options = {}) => {
   const controller = createVoiceController(path, options);
-  const assistantAudio = shallowRef6([]);
-  const assistantTexts = shallowRef6([]);
+  const assistantAudio = shallowRef7([]);
+  const assistantTexts = shallowRef7([]);
   const error = ref6(null);
   const isConnected = ref6(false);
   const isRecording = ref6(false);
@@ -2738,7 +3013,7 @@ var useVoiceController = (path, options = {}) => {
   const recordingError = ref6(null);
   const sessionId = ref6(controller.sessionId);
   const status = ref6(controller.status);
-  const turns = shallowRef6([]);
+  const turns = shallowRef7([]);
   const sync = () => {
     assistantAudio.value = [...controller.assistantAudio];
     assistantTexts.value = [...controller.assistantTexts];
@@ -2757,7 +3032,7 @@ var useVoiceController = (path, options = {}) => {
     unsubscribe();
     controller.close();
   };
-  onUnmounted7(destroy);
+  onUnmounted8(destroy);
   return {
     assistantAudio,
     assistantTexts,
@@ -2779,7 +3054,7 @@ var useVoiceController = (path, options = {}) => {
   };
 };
 // src/vue/useVoiceWorkflowStatus.ts
-import { onUnmounted as onUnmounted8, ref as ref7, shallowRef as shallowRef7 } from "vue";
+import { onUnmounted as onUnmounted9, ref as ref7, shallowRef as shallowRef8 } from "vue";
 
 // src/client/workflowStatus.ts
 var fetchVoiceWorkflowStatus = async (path = "/evals/scenarios/json", options = {}) => {
@@ -2865,7 +3140,7 @@ var useVoiceWorkflowStatus = (path = "/evals/scenarios/json", options = {}) => {
   const store = createVoiceWorkflowStatusStore(path, options);
   const error = ref7(null);
   const isLoading = ref7(false);
-  const report = shallowRef7(undefined);
+  const report = shallowRef8(undefined);
   const updatedAt = ref7(undefined);
   const sync = () => {
     const snapshot = store.getSnapshot();
@@ -2879,7 +3154,7 @@ var useVoiceWorkflowStatus = (path = "/evals/scenarios/json", options = {}) => {
   if (typeof window !== "undefined") {
     store.refresh().catch(() => {});
   }
-  onUnmounted8(() => {
+  onUnmounted9(() => {
     unsubscribe();
     store.close();
   });
@@ -2893,6 +3168,7 @@ var useVoiceWorkflowStatus = (path = "/evals/scenarios/json", options = {}) => {
 };
 export {
   useVoiceWorkflowStatus,
+  useVoiceTurnQuality,
   useVoiceStream,
   useVoiceRoutingStatus,
   useVoiceProviderStatus,
@@ -2900,6 +3176,7 @@ export {
   useVoiceProviderCapabilities,
   useVoiceController,
   useVoiceAppKitStatus,
+  VoiceTurnQuality,
   VoiceRoutingStatus,
   VoiceProviderStatus,
   VoiceProviderSimulationControls,

package/dist/vue/useVoiceTurnQuality.d.ts

@@ -0,0 +1,9 @@
+import { type VoiceTurnQualityClientOptions } from '../client/turnQuality';
+import type { VoiceTurnQualityReport } from '../turnQuality';
+export declare const useVoiceTurnQuality: (path?: string, options?: VoiceTurnQualityClientOptions) => {
+    error: import("vue").ShallowRef<string | null, string | null>;
+    isLoading: import("vue").ShallowRef<boolean, boolean>;
+    refresh: () => Promise<VoiceTurnQualityReport | undefined>;
+    report: import("vue").ShallowRef<VoiceTurnQualityReport | undefined, VoiceTurnQualityReport | undefined>;
+    updatedAt: import("vue").ShallowRef<number | undefined, number | undefined>;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@absolutejs/voice",
-	"version": "0.0.22-beta.66",
+	"version": "0.0.22-beta.67",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",