@absolutejs/voice 0.0.22-beta.38 → 0.0.22-beta.39

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export { createStoredVoiceCallReviewArtifact, createStoredVoiceExternalObjectMap
 export { createVoiceAssistantMemoryHandle, createVoiceAssistantMemoryRecord, createVoiceMemoryAssistantMemoryStore, resolveVoiceAssistantMemoryNamespace } from './assistantMemory';
 export { createAnthropicVoiceAssistantModel, createGeminiVoiceAssistantModel, createJSONVoiceAssistantModel, createOpenAIVoiceAssistantModel, createVoiceProviderRouter } from './modelAdapters';
 export { createVoiceProviderHealthHTMLHandler, createVoiceProviderHealthJSONHandler, createVoiceProviderHealthRoutes, renderVoiceProviderHealthHTML, summarizeVoiceProviderHealth } from './providerHealth';
+export { createVoiceQualityRoutes, evaluateVoiceQuality, renderVoiceQualityHTML } from './qualityRoutes';
 export { createVoiceResilienceRoutes, listVoiceRoutingEvents, renderVoiceResilienceHTML } from './resilienceRoutes';
 export { createVoiceSTTProviderRouter, createVoiceTTSProviderRouter } from './providerAdapters';
 export { buildVoiceTraceReplay, createVoiceMemoryTraceSinkDeliveryStore, createVoiceTraceHTTPSink, createVoiceMemoryTraceEventStore, createVoiceTraceSinkDeliveryId, createVoiceTraceSinkDeliveryRecord, createVoiceTraceSinkStore, createVoiceTraceEvent, createVoiceTraceEventId, deliverVoiceTraceEventsToSinks, evaluateVoiceTrace, exportVoiceTrace, filterVoiceTraceEvents, pruneVoiceTraceEvents, redactVoiceTraceEvent, redactVoiceTraceEvents, redactVoiceTraceText, renderVoiceTraceHTML, renderVoiceTraceMarkdown, resolveVoiceTraceRedactionOptions, selectVoiceTraceEventsForPrune, summarizeVoiceTrace } from './trace';
@@ -40,6 +41,7 @@ export type { VoiceDiagnosticsRoutesOptions } from './diagnosticsRoutes';
 export type { VoiceSessionListHTMLHandlerOptions, VoiceSessionListItem, VoiceSessionListOptions, VoiceSessionListRoutesOptions, VoiceSessionListStatus, VoiceSessionReplay, VoiceSessionReplayHTMLHandlerOptions, VoiceSessionReplayOptions, VoiceSessionReplayRoutesOptions, VoiceSessionReplayTurn } from './sessionReplay';
 export type { AnthropicVoiceAssistantModelOptions, GeminiVoiceAssistantModelOptions, OpenAIVoiceAssistantModelOptions, VoiceProviderRouterEvent, VoiceProviderRouterFallbackMode, VoiceProviderRouterHealthOptions, VoiceProviderRouterOptions, VoiceProviderRouterPolicy, VoiceProviderRouterProviderHealth, VoiceProviderRouterProviderProfile, VoiceJSONAssistantModelHandler, VoiceJSONAssistantModelOptions } from './modelAdapters';
 export type { VoiceProviderHealthStatus, VoiceProviderHealthSummary, VoiceProviderHealthSummaryOptions } from './providerHealth';
+export type { VoiceQualityMetric, VoiceQualityReport, VoiceQualityRoutesOptions, VoiceQualityStatus, VoiceQualityThresholds } from './qualityRoutes';
 export type { VoiceResilienceIOSimulator, VoiceResilienceLink, VoiceResiliencePageData, VoiceResilienceRoutesOptions, VoiceResilienceSimulationProvider, VoiceRoutingEvent, VoiceRoutingEventKind } from './resilienceRoutes';
 export type { VoiceIOProviderRouterEvent, VoiceSTTProviderRouterOptions, VoiceTTSProviderRouterOptions } from './providerAdapters';
 export type { VoiceAgent, VoiceAgentMessage, VoiceAgentMessageRole, VoiceAgentModel, VoiceAgentModelInput, VoiceAgentModelOutput, VoiceAgentOptions, VoiceAgentRunResult, VoiceAgentSquadOptions, VoiceAgentTool, VoiceAgentToolCall, VoiceAgentToolResult } from './agent';

package/dist/index.js

@@ -8993,11 +8993,355 @@ var createGeminiVoiceAssistantModel = (options) => {
     }
   };
 };
-// src/resilienceRoutes.ts
+// src/qualityRoutes.ts
+import { Elysia as Elysia7 } from "elysia";
+
+// src/handoffHealth.ts
 import { Elysia as Elysia6 } from "elysia";
 var escapeHtml8 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var getString5 = (value) => typeof value === "string" ? value : undefined;
+var getString5 = (value) => typeof value === "string" && value.length > 0 ? value : undefined;
+var isStatus = (value) => value === "delivered" || value === "failed" || value === "skipped";
+var increment3 = (record, key) => {
+  record[key] = (record[key] ?? 0) + 1;
+};
+var normalizeDelivery = (adapterId, value) => {
+  const record = value && typeof value === "object" ? value : {};
+  return {
+    adapterId: getString5(record.adapterId) ?? adapterId,
+    adapterKind: getString5(record.adapterKind),
+    deliveredAt: typeof record.deliveredAt === "number" ? record.deliveredAt : undefined,
+    deliveredTo: getString5(record.deliveredTo),
+    error: getString5(record.error),
+    status: isStatus(record.status) ? record.status : "failed"
+  };
+};
+var normalizeDeliveries = (payload) => {
+  const deliveries = payload.deliveries;
+  if (!deliveries || typeof deliveries !== "object") {
+    return [];
+  }
+  return Object.entries(deliveries).map(([adapterId, value]) => normalizeDelivery(adapterId, value));
+};
+var resolveReplayHref = (event, replayHref) => {
+  if (replayHref === false) {
+    return;
+  }
+  if (typeof replayHref === "function") {
+    return replayHref(event);
+  }
+  return `${replayHref ?? "/api/voice-sessions"}/${encodeURIComponent(event.sessionId)}/replay/htmx`;
+};
+var summarizeVoiceHandoffHealth = async (options = {}) => {
+  const sourceEvents = options.events ?? await options.store?.list() ?? [];
+  const search = options.q?.trim().toLowerCase();
+  const byAction = {};
+  const byAdapter = {};
+  const byStatus = {
+    delivered: 0,
+    failed: 0,
+    skipped: 0
+  };
+  const events = sourceEvents.filter((event) => event.type === "call.handoff").map((event) => {
+    const status = isStatus(event.payload.status) ? event.payload.status : "failed";
+    const deliveries = normalizeDeliveries(event.payload);
+    const item = {
+      action: getString5(event.payload.action),
+      at: event.at,
+      deliveries,
+      reason: getString5(event.payload.reason),
+      sessionId: event.sessionId,
+      status,
+      target: getString5(event.payload.target)
+    };
+    return {
+      ...item,
+      replayHref: resolveReplayHref(item, options.replayHref)
+    };
+  }).filter((event) => {
+    if (options.status && options.status !== "all" && event.status !== options.status) {
+      return false;
+    }
+    if (!search) {
+      return true;
+    }
+    return [
+      event.action,
+      event.reason,
+      event.sessionId,
+      event.status,
+      event.target,
+      ...event.deliveries.flatMap((delivery) => [
+        delivery.adapterId,
+        delivery.adapterKind,
+        delivery.deliveredTo,
+        delivery.error,
+        delivery.status
+      ])
+    ].some((value) => value?.toLowerCase().includes(search));
+  }).sort((left, right) => right.at - left.at).slice(0, options.limit ?? 50);
+  for (const event of events) {
+    byStatus[event.status] += 1;
+    if (event.action) {
+      increment3(byAction, event.action);
+    }
+    for (const delivery of event.deliveries) {
+      byAdapter[delivery.adapterId] ??= {
+        delivered: 0,
+        failed: 0,
+        skipped: 0
+      };
+      byAdapter[delivery.adapterId][delivery.status] += 1;
+    }
+  }
+  return {
+    byAction,
+    byAdapter,
+    byStatus,
+    events,
+    failed: byStatus.failed,
+    total: events.length
+  };
+};
+var renderMetricGrid = (summary) => [
+  '<section class="voice-handoff-health-grid">',
+  `<article><span>Total</span><strong>${String(summary.total)}</strong></article>`,
+  `<article><span>Delivered</span><strong>${String(summary.byStatus.delivered)}</strong></article>`,
+  `<article><span>Failed</span><strong>${String(summary.byStatus.failed)}</strong></article>`,
+  `<article><span>Skipped</span><strong>${String(summary.byStatus.skipped)}</strong></article>`,
+  "</section>"
+].join("");
+var renderActionSummary = (summary) => {
+  const actions = Object.entries(summary.byAction).sort((left, right) => right[1] - left[1]);
+  const adapters = Object.entries(summary.byAdapter).sort(([left], [right]) => left.localeCompare(right));
+  return [
+    '<section class="voice-handoff-health-columns">',
+    "<article><h3>Actions</h3>",
+    actions.length === 0 ? "<p>No handoff actions yet.</p>" : `<ul>${actions.map(([action, count]) => `<li>${escapeHtml8(action)}: ${String(count)}</li>`).join("")}</ul>`,
+    "</article>",
+    "<article><h3>Adapters</h3>",
+    adapters.length === 0 ? "<p>No adapter deliveries yet.</p>" : `<ul>${adapters.map(([adapterId, counts]) => `<li>${escapeHtml8(adapterId)}: ${String(counts.delivered)} delivered / ${String(counts.failed)} failed / ${String(counts.skipped)} skipped</li>`).join("")}</ul>`,
+    "</article>",
+    "</section>"
+  ].join("");
+};
+var renderVoiceHandoffHealthHTML = (summary) => [
+  '<div class="voice-handoff-health">',
+  renderMetricGrid(summary),
+  renderActionSummary(summary),
+  "<section>",
+  "<h3>Recent Handoffs</h3>",
+  summary.events.length === 0 ? '<p class="voice-handoff-health-empty">No handoffs found.</p>' : [
+    '<div class="voice-handoff-health-events">',
+    ...summary.events.map((event) => [
+      `<article class="${escapeHtml8(event.status)}">`,
+      '<div class="voice-handoff-health-event-header">',
+      `<strong>${escapeHtml8(event.action ?? "handoff")}</strong>`,
+      `<span>${escapeHtml8(event.status)}</span>`,
+      "</div>",
+      `<p><small>${escapeHtml8(event.sessionId)}</small></p>`,
+      event.target ? `<p>Target: ${escapeHtml8(event.target)}</p>` : "",
+      event.reason ? `<p>Reason: ${escapeHtml8(event.reason)}</p>` : "",
+      event.deliveries.length ? `<ul>${event.deliveries.map((delivery) => [
+        "<li>",
+        `${escapeHtml8(delivery.adapterId)}: ${escapeHtml8(delivery.status)}`,
+        delivery.deliveredTo ? ` to ${escapeHtml8(delivery.deliveredTo)}` : "",
+        delivery.error ? ` (${escapeHtml8(delivery.error)})` : "",
+        "</li>"
+      ].join("")).join("")}</ul>` : "",
+      event.replayHref ? `<p><a href="${escapeHtml8(event.replayHref)}">Open replay</a></p>` : "",
+      "</article>"
+    ].join("")),
+    "</div>"
+  ].join(""),
+  "</section>",
+  "</div>"
+].join("");
+var createVoiceHandoffHealthJSONHandler = (options = {}) => async ({ query }) => summarizeVoiceHandoffHealth({
+  ...options,
+  limit: typeof query?.limit === "string" ? Number(query.limit) : options.limit,
+  q: query?.q ?? options.q,
+  status: query?.status === "delivered" || query?.status === "failed" || query?.status === "skipped" || query?.status === "all" ? query.status : options.status
+});
+var createVoiceHandoffHealthHTMLHandler = (options = {}) => async ({ query }) => {
+  const summary = await summarizeVoiceHandoffHealth({
+    ...options,
+    limit: typeof query?.limit === "string" ? Number(query.limit) : options.limit,
+    q: query?.q ?? options.q,
+    status: query?.status === "delivered" || query?.status === "failed" || query?.status === "skipped" || query?.status === "all" ? query.status : options.status
+  });
+  const body = await (options.render?.(summary) ?? renderVoiceHandoffHealthHTML(summary));
+  return new Response(body, {
+    headers: {
+      "Content-Type": "text/html; charset=utf-8",
+      ...options.headers
+    }
+  });
+};
+var createVoiceHandoffHealthRoutes = (options = {}) => {
+  const path = options.path ?? "/api/voice-handoffs";
+  const htmlPath = options.htmlPath === undefined ? `${path}/htmx` : options.htmlPath;
+  const routes = new Elysia6({
+    name: options.name ?? "absolutejs-voice-handoff-health"
+  }).get(path, createVoiceHandoffHealthJSONHandler(options));
+  if (htmlPath) {
+    routes.get(htmlPath, createVoiceHandoffHealthHTMLHandler(options));
+  }
+  return routes;
+};
+
+// src/qualityRoutes.ts
+var DEFAULT_THRESHOLDS = {
+  maxDuplicateTurnRate: 0,
+  maxEmptyTurnRate: 0.02,
+  maxHandoffFailureRate: 0,
+  maxMissingAssistantReplyRate: 0.05,
+  maxProviderAverageLatencyMs: 3000,
+  maxProviderErrorRate: 0.05,
+  maxProviderFallbackRate: 0.25,
+  maxProviderTimeoutRate: 0.03
+};
+var getString6 = (value) => typeof value === "string" ? value : undefined;
 var getNumber3 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
+var rate = (count, total) => count / Math.max(1, total);
+var roundMetric2 = (value) => Math.round(value * 1e4) / 1e4;
+var createMetric = (input) => ({
+  ...input,
+  actual: roundMetric2(input.actual),
+  pass: input.actual <= input.threshold
+});
+var evaluateVoiceQuality = async (input) => {
+  const events = filterVoiceTraceEvents(input.events ?? await input.store?.list() ?? []);
+  const thresholds = {
+    ...DEFAULT_THRESHOLDS,
+    ...input.thresholds
+  };
+  const committedTurns = events.filter((event) => event.type === "turn.committed");
+  const assistantReplies = events.filter((event) => event.type === "turn.assistant");
+  const sessionIdsWithAssistantReply = new Set(assistantReplies.map((event) => event.sessionId));
+  const sessionsWithTurns = new Set(committedTurns.map((event) => event.sessionId));
+  const emptyTurns = committedTurns.filter((event) => !getString6(event.payload.text)?.trim());
+  const turnTextsBySession = new Map;
+  let duplicateTurns = 0;
+  for (const turn of committedTurns) {
+    const normalized = getString6(turn.payload.text)?.trim().toLowerCase();
+    if (!normalized) {
+      continue;
+    }
+    const seen = turnTextsBySession.get(turn.sessionId) ?? new Set;
+    if (seen.has(normalized)) {
+      duplicateTurns += 1;
+    }
+    seen.add(normalized);
+    turnTextsBySession.set(turn.sessionId, seen);
+  }
+  const missingAssistantReplySessions = [...sessionsWithTurns].filter((sessionId) => !sessionIdsWithAssistantReply.has(sessionId)).length;
+  const providerEvents = events.filter((event) => event.type === "session.error" && typeof event.payload.provider === "string" && typeof event.payload.providerStatus === "string");
+  const providerErrors = providerEvents.filter((event) => event.payload.providerStatus === "error");
+  const providerFallbacks = providerEvents.filter((event) => event.payload.providerStatus === "fallback");
+  const providerTimeouts = providerEvents.filter((event) => event.payload.timedOut === true);
+  const providerLatencies = providerEvents.map((event) => getNumber3(event.payload.elapsedMs)).filter((value) => value !== undefined);
+  const averageProviderLatencyMs = providerLatencies.length > 0 ? providerLatencies.reduce((sum, value) => sum + value, 0) / providerLatencies.length : 0;
+  const handoffHealth = await summarizeVoiceHandoffHealth({ events });
+  const metrics = {
+    duplicateTurnRate: createMetric({
+      actual: rate(duplicateTurns, committedTurns.length),
+      label: "Duplicate turn rate",
+      threshold: thresholds.maxDuplicateTurnRate,
+      unit: "rate"
+    }),
+    emptyTurnRate: createMetric({
+      actual: rate(emptyTurns.length, committedTurns.length),
+      label: "Empty turn rate",
+      threshold: thresholds.maxEmptyTurnRate,
+      unit: "rate"
+    }),
+    handoffFailureRate: createMetric({
+      actual: rate(handoffHealth.failed, handoffHealth.total),
+      label: "Handoff failure rate",
+      threshold: thresholds.maxHandoffFailureRate,
+      unit: "rate"
+    }),
+    missingAssistantReplyRate: createMetric({
+      actual: rate(missingAssistantReplySessions, sessionsWithTurns.size),
+      label: "Missing assistant reply rate",
+      threshold: thresholds.maxMissingAssistantReplyRate,
+      unit: "rate"
+    }),
+    providerAverageLatencyMs: createMetric({
+      actual: averageProviderLatencyMs,
+      label: "Average provider latency",
+      threshold: thresholds.maxProviderAverageLatencyMs,
+      unit: "ms"
+    }),
+    providerErrorRate: createMetric({
+      actual: rate(providerErrors.length, providerEvents.length),
+      label: "Provider error rate",
+      threshold: thresholds.maxProviderErrorRate,
+      unit: "rate"
+    }),
+    providerFallbackRate: createMetric({
+      actual: rate(providerFallbacks.length, providerEvents.length),
+      label: "Provider fallback rate",
+      threshold: thresholds.maxProviderFallbackRate,
+      unit: "rate"
+    }),
+    providerTimeoutRate: createMetric({
+      actual: rate(providerTimeouts.length, providerEvents.length),
+      label: "Provider timeout rate",
+      threshold: thresholds.maxProviderTimeoutRate,
+      unit: "rate"
+    })
+  };
+  const status = Object.values(metrics).every((metric) => metric.pass) ? "pass" : "fail";
+  return {
+    checkedAt: Date.now(),
+    eventCount: events.length,
+    metrics,
+    status,
+    thresholds
+  };
+};
+var escapeHtml9 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var formatMetricValue = (metric) => metric.unit === "rate" ? `${(metric.actual * 100).toFixed(2)}%` : metric.unit === "ms" ? `${Math.round(metric.actual)}ms` : String(metric.actual);
+var formatThreshold = (metric) => metric.unit === "rate" ? `${(metric.threshold * 100).toFixed(2)}%` : metric.unit === "ms" ? `${Math.round(metric.threshold)}ms` : String(metric.threshold);
+var renderVoiceQualityHTML = (report) => {
+  const rows = Object.entries(report.metrics).map(([key, metric]) => `<tr class="${metric.pass ? "pass" : "fail"}"><td>${escapeHtml9(metric.label)}</td><td>${escapeHtml9(formatMetricValue(metric))}</td><td>${escapeHtml9(formatThreshold(metric))}</td><td>${metric.pass ? "pass" : "fail"}</td><td><code>${escapeHtml9(key)}</code></td></tr>`).join("");
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>AbsoluteJS Voice Quality</title><style>body{font-family:ui-sans-serif,system-ui,sans-serif;margin:2rem;background:#f8f7f2;color:#181713}main{max-width:1100px;margin:auto}.status{border-radius:999px;display:inline-flex;padding:.35rem .75rem;font-weight:800}.status.pass{background:#dcfce7;color:#166534}.status.fail{background:#fee2e2;color:#991b1b}table{border-collapse:collapse;width:100%;background:white;margin-top:1rem}td,th{border-bottom:1px solid #eee;padding:.75rem;text-align:left}.pass td{border-left:4px solid #16a34a}.fail td{border-left:4px solid #dc2626}code{background:#f3f4f6;padding:.15rem .3rem;border-radius:.3rem}</style></head><body><main><h1>Voice quality gates</h1><p class="status ${report.status}">${report.status}</p><p>${report.eventCount} event(s) checked.</p><table><thead><tr><th>Metric</th><th>Actual</th><th>Threshold</th><th>Status</th><th>Key</th></tr></thead><tbody>${rows}</tbody></table></main></body></html>`;
+};
+var createVoiceQualityRoutes = (options) => {
+  const path = options.path ?? "/quality";
+  const routes = new Elysia7({
+    name: options.name ?? "absolutejs-voice-quality"
+  });
+  const getReport = () => evaluateVoiceQuality({
+    events: options.events,
+    store: options.store,
+    thresholds: options.thresholds
+  });
+  routes.get(path, async () => {
+    const report = await getReport();
+    return new Response(renderVoiceQualityHTML(report), {
+      headers: {
+        "Content-Type": "text/html; charset=utf-8",
+        ...options.headers
+      }
+    });
+  });
+  routes.get(`${path}/json`, async () => getReport());
+  routes.get(`${path}/status`, async ({ set }) => {
+    const report = await getReport();
+    if (report.status === "fail") {
+      set.status = 503;
+    }
+    return report;
+  });
+  return routes;
+};
+// src/resilienceRoutes.ts
+import { Elysia as Elysia8 } from "elysia";
+var escapeHtml10 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var getString7 = (value) => typeof value === "string" ? value : undefined;
+var getNumber4 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
 var getBoolean2 = (value) => value === true;
 var isProviderStatus2 = (value) => value === "error" || value === "fallback" || value === "success";
 var listVoiceRoutingEvents = (events) => {
@@ -9006,23 +9350,23 @@ var listVoiceRoutingEvents = (events) => {
     if (event.type !== "session.error") {
       continue;
     }
-    const provider = getString5(event.payload.provider);
+    const provider = getString7(event.payload.provider);
     const providerStatus = isProviderStatus2(event.payload.providerStatus) ? event.payload.providerStatus : undefined;
     if (!provider || !providerStatus) {
       continue;
     }
-    const kind = getString5(event.payload.kind);
+    const kind = getString7(event.payload.kind);
     routingEvents.push({
       at: event.at,
-      attempt: getNumber3(event.payload.attempt),
-      elapsedMs: getNumber3(event.payload.elapsedMs),
-      error: getString5(event.payload.error),
-      fallbackProvider: getString5(event.payload.fallbackProvider),
+      attempt: getNumber4(event.payload.attempt),
+      elapsedMs: getNumber4(event.payload.elapsedMs),
+      error: getString7(event.payload.error),
+      fallbackProvider: getString7(event.payload.fallbackProvider),
       kind: kind === "stt" || kind === "tts" ? kind : "llm",
-      latencyBudgetMs: getNumber3(event.payload.latencyBudgetMs),
-      operation: getString5(event.payload.operation),
+      latencyBudgetMs: getNumber4(event.payload.latencyBudgetMs),
+      operation: getString7(event.payload.operation),
       provider,
-      selectedProvider: getString5(event.payload.selectedProvider),
+      selectedProvider: getString7(event.payload.selectedProvider),
       sessionId: event.sessionId,
       status: providerStatus,
       timedOut: getBoolean2(event.payload.timedOut),
@@ -9058,13 +9402,13 @@ var summarizeRoutingEvents = (events) => {
 };
 var renderProviderCards = (title, providers) => {
   if (providers.length === 0) {
-    return `<p class="muted">No ${escapeHtml8(title)} provider health yet.</p>`;
+    return `<p class="muted">No ${escapeHtml10(title)} provider health yet.</p>`;
   }
   return `<div class="provider-grid">${providers.map((provider) => `
-        <article class="card provider ${escapeHtml8(provider.status)}">
+        <article class="card provider ${escapeHtml10(provider.status)}">
           <div class="card-header">
-            <strong>${escapeHtml8(provider.provider)}</strong>
-            <span>${escapeHtml8(provider.status)}${provider.recommended ? " \xB7 recommended" : ""}</span>
+            <strong>${escapeHtml10(provider.provider)}</strong>
+            <span>${escapeHtml10(provider.status)}${provider.recommended ? " \xB7 recommended" : ""}</span>
           </div>
           <dl>
             <div><dt>Runs</dt><dd>${provider.runCount}</dd></div>
@@ -9073,7 +9417,7 @@ var renderProviderCards = (title, providers) => {
             <div><dt>Timeouts</dt><dd>${provider.timeoutCount}</dd></div>
             <div><dt>Fallbacks</dt><dd>${provider.fallbackCount}</dd></div>
           </dl>
-          ${provider.lastError ? `<p class="muted">${escapeHtml8(provider.lastError)}</p>` : ""}
+          ${provider.lastError ? `<p class="muted">${escapeHtml10(provider.lastError)}</p>` : ""}
         </article>
       `).join("")}</div>`;
 };
@@ -9082,24 +9426,24 @@ var renderTimeline2 = (events) => {
     return '<p class="muted">No provider routing events yet. Run the app or simulate provider failover.</p>';
   }
   return `<div class="timeline">${events.slice(0, 40).map((event) => `
-        <article class="card event ${escapeHtml8(event.status ?? "unknown")}">
+        <article class="card event ${escapeHtml10(event.status ?? "unknown")}">
           <div class="card-header">
-            <strong>${escapeHtml8(event.kind.toUpperCase())} ${escapeHtml8(event.operation ?? "generate")}</strong>
+            <strong>${escapeHtml10(event.kind.toUpperCase())} ${escapeHtml10(event.operation ?? "generate")}</strong>
             <span>${new Date(event.at).toLocaleString()}</span>
           </div>
           <p>
-            <span class="pill">${escapeHtml8(event.status ?? "unknown")}</span>
-            <span class="pill">provider: ${escapeHtml8(event.provider ?? "unknown")}</span>
-            ${event.fallbackProvider ? `<span class="pill">fallback: ${escapeHtml8(event.fallbackProvider)}</span>` : ""}
+            <span class="pill">${escapeHtml10(event.status ?? "unknown")}</span>
+            <span class="pill">provider: ${escapeHtml10(event.provider ?? "unknown")}</span>
+            ${event.fallbackProvider ? `<span class="pill">fallback: ${escapeHtml10(event.fallbackProvider)}</span>` : ""}
             ${event.timedOut ? '<span class="pill danger">timed out</span>' : ""}
           </p>
           <dl>
             <div><dt>Attempt</dt><dd>${event.attempt ?? 0}</dd></div>
             <div><dt>Elapsed</dt><dd>${event.elapsedMs ?? 0}ms</dd></div>
             <div><dt>Budget</dt><dd>${event.latencyBudgetMs ?? 0}ms</dd></div>
-            <div><dt>Session</dt><dd>${escapeHtml8(event.sessionId)}</dd></div>
+            <div><dt>Session</dt><dd>${escapeHtml10(event.sessionId)}</dd></div>
           </dl>
-          ${event.error ? `<p class="muted">${escapeHtml8(event.error)}</p>` : ""}
+          ${event.error ? `<p class="muted">${escapeHtml10(event.error)}</p>` : ""}
         </article>
       `).join("")}</div>`;
 };
@@ -9114,26 +9458,26 @@ var renderSimulationControls = (kind, simulation) => {
   const pathPrefix = simulation.pathPrefix ?? `/api/${kind}-simulate`;
   const failureProviders = simulation.failureProviders ?? configuredProviders.map(({ provider }) => provider);
   const canFail = (provider) => configuredProviders.some((entry) => entry.provider === provider) && (!simulation.fallbackRequiredProvider || configuredProviders.some((entry) => entry.provider === simulation.fallbackRequiredProvider));
-  return `<div class="simulate-panel" data-sim-kind="${kind}" data-sim-prefix="${escapeHtml8(pathPrefix)}">
-    <p class="muted">${escapeHtml8(simulation.failureMessage ?? `Simulate ${kind.toUpperCase()} provider failure without changing provider credentials.`)}</p>
+  return `<div class="simulate-panel" data-sim-kind="${kind}" data-sim-prefix="${escapeHtml10(pathPrefix)}">
+    <p class="muted">${escapeHtml10(simulation.failureMessage ?? `Simulate ${kind.toUpperCase()} provider failure without changing provider credentials.`)}</p>
     <div class="simulate-actions">
-      ${failureProviders.map((provider) => `<button type="button" data-provider-fail="${escapeHtml8(provider)}"${canFail(provider) ? "" : " disabled"}>Simulate ${escapeHtml8(provider)} ${kind.toUpperCase()} failure</button>`).join("")}
-      ${configuredProviders.map((provider) => `<button type="button" data-provider-recover="${escapeHtml8(provider.provider)}">Mark ${escapeHtml8(provider.provider)} recovered</button>`).join("")}
+      ${failureProviders.map((provider) => `<button type="button" data-provider-fail="${escapeHtml10(provider)}"${canFail(provider) ? "" : " disabled"}>Simulate ${escapeHtml10(provider)} ${kind.toUpperCase()} failure</button>`).join("")}
+      ${configuredProviders.map((provider) => `<button type="button" data-provider-recover="${escapeHtml10(provider.provider)}">Mark ${escapeHtml10(provider.provider)} recovered</button>`).join("")}
     </div>
-    ${simulation.fallbackRequiredProvider && !configuredProviders.some((entry) => entry.provider === simulation.fallbackRequiredProvider) ? `<p class="muted">${escapeHtml8(simulation.fallbackRequiredMessage ?? `Configure ${simulation.fallbackRequiredProvider} to enable fallback simulation.`)}</p>` : ""}
+    ${simulation.fallbackRequiredProvider && !configuredProviders.some((entry) => entry.provider === simulation.fallbackRequiredProvider) ? `<p class="muted">${escapeHtml10(simulation.fallbackRequiredMessage ?? `Configure ${simulation.fallbackRequiredProvider} to enable fallback simulation.`)}</p>` : ""}
     <pre class="simulate-output" hidden></pre>
   </div>`;
 };
 var renderVoiceResilienceHTML = (input) => {
   const summary = summarizeRoutingEvents(input.routingEvents);
-  const kindCounts = [...summary.byKind.entries()].map(([kind, count]) => `<span class="pill">${escapeHtml8(kind)}: ${String(count)}</span>`).join("");
-  const links = input.links?.length ? input.links.map((link) => `<a href="${escapeHtml8(link.href)}">${escapeHtml8(link.label)}</a>`).join(" \xB7 ") : "";
+  const kindCounts = [...summary.byKind.entries()].map(([kind, count]) => `<span class="pill">${escapeHtml10(kind)}: ${String(count)}</span>`).join("");
+  const links = input.links?.length ? input.links.map((link) => `<a href="${escapeHtml10(link.href)}">${escapeHtml10(link.label)}</a>`).join(" \xB7 ") : "";
   return `<!doctype html>
 <html lang="en">
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1" />
-  <title>${escapeHtml8(input.title ?? "AbsoluteJS Voice Resilience")}</title>
+  <title>${escapeHtml10(input.title ?? "AbsoluteJS Voice Resilience")}</title>
   <style>
     :root { color-scheme: dark; }
     body { background: radial-gradient(circle at top left, #172554, #09090b 36%, #050505); color: #f4f4f5; font-family: ui-sans-serif, system-ui, sans-serif; margin: 0; padding: 24px; }
@@ -9269,7 +9613,7 @@ var registerSimulationRoutes = (routes, simulation, defaultPathPrefix) => {
 };
 var createVoiceResilienceRoutes = (options) => {
   const path = options.path ?? "/resilience";
-  const routes = new Elysia6({
+  const routes = new Elysia8({
     name: options.name ?? "absolutejs-voice-resilience"
   }).get(path, async () => {
     const events = await options.store.list();
@@ -10150,7 +10494,7 @@ var createVoiceMemoryStore = () => {
   return { get, getOrCreate, list, remove, set };
 };
 // src/opsWebhook.ts
-import { Elysia as Elysia7 } from "elysia";
+import { Elysia as Elysia9 } from "elysia";
 var toHex5 = (bytes) => Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
 var signVoiceOpsWebhookBody = async (input) => {
   const encoder = new TextEncoder;
@@ -10280,7 +10624,7 @@ var verifyVoiceOpsWebhookSignature = async (input) => {
 };
 var createVoiceOpsWebhookReceiverRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice-ops/webhook";
-  return new Elysia7().post(path, async ({ body, request, set }) => {
+  return new Elysia9().post(path, async ({ body, request, set }) => {
     const bodyText = typeof body === "string" ? body : JSON.stringify(body);
     if (options.signingSecret) {
       const verification = await verifyVoiceOpsWebhookSignature({
@@ -10312,198 +10656,6 @@ var createVoiceOpsWebhookReceiverRoutes = (options = {}) => {
     parse: "text"
   });
 };
-// src/handoffHealth.ts
-import { Elysia as Elysia8 } from "elysia";
-var escapeHtml9 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var getString6 = (value) => typeof value === "string" && value.length > 0 ? value : undefined;
-var isStatus = (value) => value === "delivered" || value === "failed" || value === "skipped";
-var increment3 = (record, key) => {
-  record[key] = (record[key] ?? 0) + 1;
-};
-var normalizeDelivery = (adapterId, value) => {
-  const record = value && typeof value === "object" ? value : {};
-  return {
-    adapterId: getString6(record.adapterId) ?? adapterId,
-    adapterKind: getString6(record.adapterKind),
-    deliveredAt: typeof record.deliveredAt === "number" ? record.deliveredAt : undefined,
-    deliveredTo: getString6(record.deliveredTo),
-    error: getString6(record.error),
-    status: isStatus(record.status) ? record.status : "failed"
-  };
-};
-var normalizeDeliveries = (payload) => {
-  const deliveries = payload.deliveries;
-  if (!deliveries || typeof deliveries !== "object") {
-    return [];
-  }
-  return Object.entries(deliveries).map(([adapterId, value]) => normalizeDelivery(adapterId, value));
-};
-var resolveReplayHref = (event, replayHref) => {
-  if (replayHref === false) {
-    return;
-  }
-  if (typeof replayHref === "function") {
-    return replayHref(event);
-  }
-  return `${replayHref ?? "/api/voice-sessions"}/${encodeURIComponent(event.sessionId)}/replay/htmx`;
-};
-var summarizeVoiceHandoffHealth = async (options = {}) => {
-  const sourceEvents = options.events ?? await options.store?.list() ?? [];
-  const search = options.q?.trim().toLowerCase();
-  const byAction = {};
-  const byAdapter = {};
-  const byStatus = {
-    delivered: 0,
-    failed: 0,
-    skipped: 0
-  };
-  const events = sourceEvents.filter((event) => event.type === "call.handoff").map((event) => {
-    const status = isStatus(event.payload.status) ? event.payload.status : "failed";
-    const deliveries = normalizeDeliveries(event.payload);
-    const item = {
-      action: getString6(event.payload.action),
-      at: event.at,
-      deliveries,
-      reason: getString6(event.payload.reason),
-      sessionId: event.sessionId,
-      status,
-      target: getString6(event.payload.target)
-    };
-    return {
-      ...item,
-      replayHref: resolveReplayHref(item, options.replayHref)
-    };
-  }).filter((event) => {
-    if (options.status && options.status !== "all" && event.status !== options.status) {
-      return false;
-    }
-    if (!search) {
-      return true;
-    }
-    return [
-      event.action,
-      event.reason,
-      event.sessionId,
-      event.status,
-      event.target,
-      ...event.deliveries.flatMap((delivery) => [
-        delivery.adapterId,
-        delivery.adapterKind,
-        delivery.deliveredTo,
-        delivery.error,
-        delivery.status
-      ])
-    ].some((value) => value?.toLowerCase().includes(search));
-  }).sort((left, right) => right.at - left.at).slice(0, options.limit ?? 50);
-  for (const event of events) {
-    byStatus[event.status] += 1;
-    if (event.action) {
-      increment3(byAction, event.action);
-    }
-    for (const delivery of event.deliveries) {
-      byAdapter[delivery.adapterId] ??= {
-        delivered: 0,
-        failed: 0,
-        skipped: 0
-      };
-      byAdapter[delivery.adapterId][delivery.status] += 1;
-    }
-  }
-  return {
-    byAction,
-    byAdapter,
-    byStatus,
-    events,
-    failed: byStatus.failed,
-    total: events.length
-  };
-};
-var renderMetricGrid = (summary) => [
-  '<section class="voice-handoff-health-grid">',
-  `<article><span>Total</span><strong>${String(summary.total)}</strong></article>`,
-  `<article><span>Delivered</span><strong>${String(summary.byStatus.delivered)}</strong></article>`,
-  `<article><span>Failed</span><strong>${String(summary.byStatus.failed)}</strong></article>`,
-  `<article><span>Skipped</span><strong>${String(summary.byStatus.skipped)}</strong></article>`,
-  "</section>"
-].join("");
-var renderActionSummary = (summary) => {
-  const actions = Object.entries(summary.byAction).sort((left, right) => right[1] - left[1]);
-  const adapters = Object.entries(summary.byAdapter).sort(([left], [right]) => left.localeCompare(right));
-  return [
-    '<section class="voice-handoff-health-columns">',
-    "<article><h3>Actions</h3>",
-    actions.length === 0 ? "<p>No handoff actions yet.</p>" : `<ul>${actions.map(([action, count]) => `<li>${escapeHtml9(action)}: ${String(count)}</li>`).join("")}</ul>`,
-    "</article>",
-    "<article><h3>Adapters</h3>",
-    adapters.length === 0 ? "<p>No adapter deliveries yet.</p>" : `<ul>${adapters.map(([adapterId, counts]) => `<li>${escapeHtml9(adapterId)}: ${String(counts.delivered)} delivered / ${String(counts.failed)} failed / ${String(counts.skipped)} skipped</li>`).join("")}</ul>`,
-    "</article>",
-    "</section>"
-  ].join("");
-};
-var renderVoiceHandoffHealthHTML = (summary) => [
-  '<div class="voice-handoff-health">',
-  renderMetricGrid(summary),
-  renderActionSummary(summary),
-  "<section>",
-  "<h3>Recent Handoffs</h3>",
-  summary.events.length === 0 ? '<p class="voice-handoff-health-empty">No handoffs found.</p>' : [
-    '<div class="voice-handoff-health-events">',
-    ...summary.events.map((event) => [
-      `<article class="${escapeHtml9(event.status)}">`,
-      '<div class="voice-handoff-health-event-header">',
-      `<strong>${escapeHtml9(event.action ?? "handoff")}</strong>`,
-      `<span>${escapeHtml9(event.status)}</span>`,
-      "</div>",
-      `<p><small>${escapeHtml9(event.sessionId)}</small></p>`,
-      event.target ? `<p>Target: ${escapeHtml9(event.target)}</p>` : "",
-      event.reason ? `<p>Reason: ${escapeHtml9(event.reason)}</p>` : "",
-      event.deliveries.length ? `<ul>${event.deliveries.map((delivery) => [
-        "<li>",
-        `${escapeHtml9(delivery.adapterId)}: ${escapeHtml9(delivery.status)}`,
-        delivery.deliveredTo ? ` to ${escapeHtml9(delivery.deliveredTo)}` : "",
-        delivery.error ? ` (${escapeHtml9(delivery.error)})` : "",
-        "</li>"
-      ].join("")).join("")}</ul>` : "",
-      event.replayHref ? `<p><a href="${escapeHtml9(event.replayHref)}">Open replay</a></p>` : "",
-      "</article>"
-    ].join("")),
-    "</div>"
-  ].join(""),
-  "</section>",
-  "</div>"
-].join("");
-var createVoiceHandoffHealthJSONHandler = (options = {}) => async ({ query }) => summarizeVoiceHandoffHealth({
-  ...options,
-  limit: typeof query?.limit === "string" ? Number(query.limit) : options.limit,
-  q: query?.q ?? options.q,
-  status: query?.status === "delivered" || query?.status === "failed" || query?.status === "skipped" || query?.status === "all" ? query.status : options.status
-});
-var createVoiceHandoffHealthHTMLHandler = (options = {}) => async ({ query }) => {
-  const summary = await summarizeVoiceHandoffHealth({
-    ...options,
-    limit: typeof query?.limit === "string" ? Number(query.limit) : options.limit,
-    q: query?.q ?? options.q,
-    status: query?.status === "delivered" || query?.status === "failed" || query?.status === "skipped" || query?.status === "all" ? query.status : options.status
-  });
-  const body = await (options.render?.(summary) ?? renderVoiceHandoffHealthHTML(summary));
-  return new Response(body, {
-    headers: {
-      "Content-Type": "text/html; charset=utf-8",
-      ...options.headers
-    }
-  });
-};
-var createVoiceHandoffHealthRoutes = (options = {}) => {
-  const path = options.path ?? "/api/voice-handoffs";
-  const htmlPath = options.htmlPath === undefined ? `${path}/htmx` : options.htmlPath;
-  const routes = new Elysia8({
-    name: options.name ?? "absolutejs-voice-handoff-health"
-  }).get(path, createVoiceHandoffHealthJSONHandler(options));
-  if (htmlPath) {
-    routes.get(htmlPath, createVoiceHandoffHealthHTMLHandler(options));
-  }
-  return routes;
-};
 // src/queue.ts
 var releaseLeaseScript = `
 if redis.call("GET", KEYS[1]) == ARGV[1] then
@@ -12652,6 +12804,7 @@ export {
   renderVoiceTraceHTML,
   renderVoiceSessionsHTML,
   renderVoiceResilienceHTML,
+  renderVoiceQualityHTML,
   renderVoiceProviderHealthHTML,
   renderVoiceHandoffHealthHTML,
   renderVoiceCallReviewMarkdown,
@@ -12673,6 +12826,7 @@ export {
   failVoiceOpsTask,
   exportVoiceTrace,
   evaluateVoiceTrace,
+  evaluateVoiceQuality,
   encodeTwilioMulawBase64,
   deliverVoiceTraceEventsToSinks,
   deliverVoiceIntegrationEventToSinks,
@@ -12723,6 +12877,7 @@ export {
   createVoiceResilienceRoutes,
   createVoiceRedisTaskLeaseCoordinator,
   createVoiceRedisIdempotencyStore,
+  createVoiceQualityRoutes,
   createVoiceProviderRouter,
   createVoiceProviderHealthRoutes,
   createVoiceProviderHealthJSONHandler,

package/dist/qualityRoutes.d.ts

@@ -0,0 +1,69 @@
+import { Elysia } from 'elysia';
+import { type StoredVoiceTraceEvent, type VoiceTraceEventStore } from './trace';
+export type VoiceQualityStatus = 'pass' | 'fail';
+export type VoiceQualityThresholds = {
+    maxDuplicateTurnRate?: number;
+    maxEmptyTurnRate?: number;
+    maxHandoffFailureRate?: number;
+    maxMissingAssistantReplyRate?: number;
+    maxProviderAverageLatencyMs?: number;
+    maxProviderErrorRate?: number;
+    maxProviderFallbackRate?: number;
+    maxProviderTimeoutRate?: number;
+};
+export type VoiceQualityMetric = {
+    actual: number;
+    label: string;
+    pass: boolean;
+    threshold: number;
+    unit: 'count' | 'ms' | 'rate';
+};
+export type VoiceQualityReport = {
+    checkedAt: number;
+    eventCount: number;
+    metrics: Record<string, VoiceQualityMetric>;
+    status: VoiceQualityStatus;
+    thresholds: Required<VoiceQualityThresholds>;
+};
+export type VoiceQualityRoutesOptions = {
+    events?: StoredVoiceTraceEvent[];
+    headers?: HeadersInit;
+    name?: string;
+    path?: string;
+    store?: VoiceTraceEventStore;
+    thresholds?: VoiceQualityThresholds;
+};
+export declare const evaluateVoiceQuality: (input: {
+    events?: StoredVoiceTraceEvent[];
+    store?: VoiceTraceEventStore;
+    thresholds?: VoiceQualityThresholds;
+}) => Promise<VoiceQualityReport>;
+export declare const renderVoiceQualityHTML: (report: VoiceQualityReport) => string;
+export declare const createVoiceQualityRoutes: (options: VoiceQualityRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/package.json

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