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

package/dist/index.js

@@ -10294,6 +10294,122 @@ var createVoiceToolContractRoutes = (options) => {
   }
   return routes;
 };
+// src/turnQuality.ts
+import { Elysia as Elysia14 } from "elysia";
+var DEFAULT_CONFIDENCE_WARN_THRESHOLD = 0.72;
+var escapeHtml15 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var getTurnLatencyMs = (turn) => {
+  const firstTranscriptAt = turn.transcripts.map((transcript) => transcript.endedAtMs ?? transcript.startedAtMs).filter((value) => typeof value === "number").sort((left, right) => left - right)[0];
+  if (firstTranscriptAt === undefined) {
+    return;
+  }
+  return Math.max(0, turn.committedAt - firstTranscriptAt);
+};
+var summarizeTurn = (sessionId, turn, options) => {
+  const quality = turn.quality;
+  const correctionChanged = quality?.correction?.changed === true;
+  const fallbackUsed = quality?.fallbackUsed === true;
+  const lowConfidence = typeof quality?.averageConfidence === "number" && quality.averageConfidence < options.confidenceWarnThreshold;
+  const hasNoQuality = !quality;
+  const status = hasNoQuality ? "unknown" : quality.selectedTranscriptCount === 0 || turn.text.trim().length === 0 ? "fail" : fallbackUsed || correctionChanged || lowConfidence ? "warn" : "pass";
+  return {
+    averageConfidence: quality?.averageConfidence,
+    committedAt: turn.committedAt,
+    correctionChanged,
+    correctionProvider: quality?.correction?.provider,
+    correctionReason: quality?.correction?.reason,
+    costUnits: quality?.cost?.estimatedRelativeCostUnits,
+    fallbackSelectionReason: quality?.fallback?.selectionReason,
+    fallbackUsed,
+    finalTranscriptCount: quality?.finalTranscriptCount ?? 0,
+    latencyMs: getTurnLatencyMs(turn),
+    partialTranscriptCount: quality?.partialTranscriptCount ?? 0,
+    selectedTranscriptCount: quality?.selectedTranscriptCount ?? 0,
+    sessionId,
+    source: quality?.source,
+    status,
+    text: turn.text,
+    turnId: turn.id
+  };
+};
+var resolveSessions = async (options) => {
+  if (options.sessions) {
+    return options.sessions;
+  }
+  if (!options.store) {
+    return [];
+  }
+  const summaries = await options.store.list();
+  const ids = options.sessionIds ?? summaries.map((summary) => summary.id);
+  const hydrated = await Promise.all(ids.slice(0, options.limit ?? 25).map((id) => options.store?.get(id)));
+  const sessions = [];
+  for (const session of hydrated) {
+    if (session) {
+      sessions.push(session);
+    }
+  }
+  return sessions;
+};
+var summarizeVoiceTurnQuality = async (options) => {
+  const sessions = await resolveSessions(options);
+  const confidenceWarnThreshold = options.confidenceWarnThreshold ?? DEFAULT_CONFIDENCE_WARN_THRESHOLD;
+  const turns = sessions.flatMap((session) => session.turns.map((turn) => summarizeTurn(session.id, turn, { confidenceWarnThreshold }))).sort((left, right) => right.committedAt - left.committedAt);
+  const failed = turns.filter((turn) => turn.status === "fail").length;
+  const warnings = turns.filter((turn) => turn.status === "warn").length;
+  return {
+    checkedAt: Date.now(),
+    failed,
+    sessions: sessions.length,
+    status: failed > 0 ? "fail" : warnings > 0 ? "warn" : "pass",
+    total: turns.length,
+    turns,
+    warnings
+  };
+};
+var renderVoiceTurnQualityHTML = (report, options = {}) => {
+  const title = options.title ?? "Voice Turn Quality";
+  const turns = report.turns.map((turn) => `<article class="turn ${escapeHtml15(turn.status)}">
+  <div class="turn-header">
+    <div>
+      <p class="eyebrow">${escapeHtml15(turn.sessionId)} \xB7 ${escapeHtml15(turn.turnId)}</p>
+      <h2>${escapeHtml15(turn.text || "Empty turn")}</h2>
+    </div>
+    <strong>${escapeHtml15(turn.status)}</strong>
+  </div>
+  <dl>
+    <div><dt>Source</dt><dd>${escapeHtml15(turn.source ?? "unknown")}</dd></div>
+    <div><dt>Confidence</dt><dd>${turn.averageConfidence === undefined ? "n/a" : `${Math.round(turn.averageConfidence * 100)}%`}</dd></div>
+    <div><dt>Fallback</dt><dd>${turn.fallbackUsed ? `yes (${escapeHtml15(turn.fallbackSelectionReason ?? "selected")})` : "no"}</dd></div>
+    <div><dt>Correction</dt><dd>${turn.correctionChanged ? `changed${turn.correctionProvider ? ` by ${escapeHtml15(turn.correctionProvider)}` : ""}` : "none"}</dd></div>
+    <div><dt>Transcripts</dt><dd>${String(turn.selectedTranscriptCount)} selected \xB7 ${String(turn.finalTranscriptCount)} final \xB7 ${String(turn.partialTranscriptCount)} partial</dd></div>
+    <div><dt>Cost</dt><dd>${turn.costUnits === undefined ? "n/a" : String(turn.costUnits)}</dd></div>
+  </dl>
+</article>`).join("");
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml15(title)}</title><style>body{background:#101316;color:#f6f2e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1180px;padding:32px}.hero,.turn{background:#181d22;border:1px solid #2a323a;border-radius:20px;margin-bottom:16px;padding:20px}.hero{background:linear-gradient(135deg,rgba(251,191,36,.16),rgba(34,197,94,.1))}.eyebrow{color:#fbbf24;font-size:.78rem;font-weight:900;letter-spacing:.08em;text-transform:uppercase}h1{font-size:clamp(2.3rem,6vw,5rem);letter-spacing:-.06em;line-height:.9;margin:.2rem 0 1rem}h2{margin:.2rem 0 1rem}.summary{display:flex;flex-wrap:wrap;gap:10px}.pill{background:#0f1217;border:1px solid #3f3f46;border-radius:999px;padding:7px 10px}.turn-header{align-items:flex-start;display:flex;gap:16px;justify-content:space-between}.pass{color:#86efac}.warn,.unknown{color:#fde68a}.fail{color:#fca5a5}.turn.fail{border-color:rgba(248,113,113,.45)}dl{display:grid;gap:8px;grid-template-columns:repeat(auto-fit,minmax(160px,1fr))}dt{color:#a8b0b8;font-size:.8rem}dd{margin:0}@media(max-width:800px){main{padding:18px}.turn-header{display:block}}</style></head><body><main><section class="hero"><p class="eyebrow">Realtime STT Debugging</p><h1>${escapeHtml15(title)}</h1><div class="summary"><span class="pill ${escapeHtml15(report.status)}">${escapeHtml15(report.status)}</span><span class="pill">${String(report.total)} turns</span><span class="pill">${String(report.warnings)} warnings</span><span class="pill">${String(report.failed)} failed</span><span class="pill">${String(report.sessions)} sessions</span></div></section>${turns || '<section class="turn"><p>No committed turns found.</p></section>'}</main></body></html>`;
+};
+var createVoiceTurnQualityJSONHandler = (options) => async () => summarizeVoiceTurnQuality(options);
+var createVoiceTurnQualityHTMLHandler = (options) => async () => {
+  const report = await summarizeVoiceTurnQuality(options);
+  const render = options.render ?? ((input) => renderVoiceTurnQualityHTML(input, options));
+  const body = await render(report);
+  return new Response(body, {
+    headers: {
+      "Content-Type": "text/html; charset=utf-8",
+      ...options.headers
+    }
+  });
+};
+var createVoiceTurnQualityRoutes = (options) => {
+  const path = options.path ?? "/api/turn-quality";
+  const htmlPath = options.htmlPath === undefined ? `${path}/htmx` : options.htmlPath;
+  const routes = new Elysia14({
+    name: options.name ?? "absolutejs-voice-turn-quality"
+  }).get(path, createVoiceTurnQualityJSONHandler(options));
+  if (htmlPath) {
+    routes.get(htmlPath, createVoiceTurnQualityHTMLHandler(options));
+  }
+  return routes;
+};
 // src/fileStore.ts
 import { mkdir as mkdir2, readFile, readdir, rename, rm, writeFile } from "fs/promises";
 import { join } from "path";
@@ -12387,7 +12503,7 @@ var createVoiceMemoryStore = () => {
   return { get, getOrCreate, list, remove, set };
 };
 // src/opsWebhook.ts
-import { Elysia as Elysia14 } from "elysia";
+import { Elysia as Elysia15 } from "elysia";
 var toHex5 = (bytes) => Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
 var signVoiceOpsWebhookBody = async (input) => {
   const encoder = new TextEncoder;
@@ -12517,7 +12633,7 @@ var verifyVoiceOpsWebhookSignature = async (input) => {
 };
 var createVoiceOpsWebhookReceiverRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice-ops/webhook";
-  return new Elysia14().post(path, async ({ body, request, set }) => {
+  return new Elysia15().post(path, async ({ body, request, set }) => {
     const bodyText = typeof body === "string" ? body : JSON.stringify(body);
     if (options.signingSecret) {
       const verification = await verifyVoiceOpsWebhookSignature({
@@ -14664,6 +14780,7 @@ export {
   validateVoiceWorkflowRouteResult,
   transcodeTwilioInboundPayloadToPCM16,
   transcodePCMToTwilioOutboundPayload,
+  summarizeVoiceTurnQuality,
   summarizeVoiceTraceSinkDeliveries,
   summarizeVoiceTrace,
   summarizeVoiceSessions,
@@ -14703,6 +14820,7 @@ export {
   resolveAudioConditioningConfig,
   requeueVoiceOpsTask,
   reopenVoiceOpsTask,
+  renderVoiceTurnQualityHTML,
   renderVoiceTraceMarkdown,
   renderVoiceTraceHTML,
   renderVoiceToolContractHTML,
@@ -14757,6 +14875,9 @@ export {
   createVoiceWebhookDeliveryWorkerLoop,
   createVoiceWebhookDeliveryWorker,
   createVoiceTwilioRedirectHandoffAdapter,
+  createVoiceTurnQualityRoutes,
+  createVoiceTurnQualityJSONHandler,
+  createVoiceTurnQualityHTMLHandler,
   createVoiceTraceSinkStore,
   createVoiceTraceSinkDeliveryWorkerLoop,
   createVoiceTraceSinkDeliveryWorker,

package/dist/react/VoiceProviderCapabilities.d.ts

@@ -0,0 +1,6 @@
+import { type VoiceProviderCapabilitiesWidgetOptions } from '../client/providerCapabilitiesWidget';
+export type VoiceProviderCapabilitiesProps = VoiceProviderCapabilitiesWidgetOptions & {
+    className?: string;
+    path?: string;
+};
+export declare const VoiceProviderCapabilities: ({ className, path, ...options }: VoiceProviderCapabilitiesProps) => import("react/jsx-runtime").JSX.Element;

package/dist/react/VoiceTurnQuality.d.ts

@@ -0,0 +1,6 @@
+import { type VoiceTurnQualityWidgetOptions } from '../client/turnQualityWidget';
+export type VoiceTurnQualityProps = VoiceTurnQualityWidgetOptions & {
+    className?: string;
+    path?: string;
+};
+export declare const VoiceTurnQuality: ({ className, path, ...options }: VoiceTurnQualityProps) => import("react/jsx-runtime").JSX.Element;

package/dist/react/index.d.ts

@@ -1,11 +1,15 @@
 export { VoiceOpsStatus } from './VoiceOpsStatus';
 export { VoiceProviderSimulationControls } from './VoiceProviderSimulationControls';
+export { VoiceProviderCapabilities } from './VoiceProviderCapabilities';
 export { VoiceProviderStatus } from './VoiceProviderStatus';
 export { VoiceRoutingStatus } from './VoiceRoutingStatus';
+export { VoiceTurnQuality } from './VoiceTurnQuality';
 export { useVoiceAppKitStatus } from './useVoiceAppKitStatus';
 export { useVoiceStream } from './useVoiceStream';
 export { useVoiceController } from './useVoiceController';
 export { useVoiceProviderStatus } from './useVoiceProviderStatus';
+export { useVoiceProviderCapabilities } from './useVoiceProviderCapabilities';
 export { useVoiceProviderSimulationControls } from './useVoiceProviderSimulationControls';
 export { useVoiceRoutingStatus } from './useVoiceRoutingStatus';
+export { useVoiceTurnQuality } from './useVoiceTurnQuality';
 export { useVoiceWorkflowStatus } from './useVoiceWorkflowStatus';