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

package/dist/diagnosticsRoutes.d.ts

@@ -0,0 +1,44 @@
+import { Elysia } from 'elysia';
+import { evaluateVoiceTrace, type StoredVoiceTraceEvent, type VoiceTraceEventFilter, type VoiceTraceEventStore, type VoiceTraceRedactionConfig } from './trace';
+export type VoiceDiagnosticsRoutesOptions = {
+    evaluation?: Parameters<typeof evaluateVoiceTrace>[1];
+    headers?: HeadersInit;
+    name?: string;
+    path?: string;
+    redact?: VoiceTraceRedactionConfig;
+    store: VoiceTraceEventStore;
+    title?: string;
+};
+export declare const resolveVoiceDiagnosticsTraceFilter: (query: Record<string, unknown>) => VoiceTraceEventFilter;
+export declare const buildVoiceDiagnosticsMarkdown: (events: StoredVoiceTraceEvent[], options?: {
+    evaluation?: Parameters<typeof evaluateVoiceTrace>[1];
+    title?: string;
+}) => string;
+export declare const createVoiceDiagnosticsRoutes: (options: VoiceDiagnosticsRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/index.d.ts

@@ -1,12 +1,14 @@
 export { voice } from './plugin';
 export { createVoiceAssistant, createVoiceExperiment, summarizeVoiceAssistantRuns } from './assistant';
 export { createVoiceAssistantHealthHTMLHandler, createVoiceAssistantHealthJSONHandler, createVoiceAssistantHealthRoutes, renderVoiceAssistantHealthHTML, summarizeVoiceAssistantHealth } from './assistantHealth';
+export { buildVoiceDiagnosticsMarkdown, createVoiceDiagnosticsRoutes, resolveVoiceDiagnosticsTraceFilter } from './diagnosticsRoutes';
 export { createVoiceSessionListRoutes, createVoiceSessionReplayHTMLHandler, createVoiceSessionReplayJSONHandler, createVoiceSessionReplayRoutes, createVoiceSessionsHTMLHandler, createVoiceSessionsJSONHandler, renderVoiceSessionsHTML, summarizeVoiceSessions, summarizeVoiceSessionReplay } from './sessionReplay';
 export { createVoiceAgent, createVoiceAgentSquad, createVoiceAgentTool } from './agent';
 export { createStoredVoiceCallReviewArtifact, createStoredVoiceExternalObjectMap, createStoredVoiceIntegrationEvent, createStoredVoiceOpsTask, createVoiceFileExternalObjectMapStore, createVoiceFileAssistantMemoryStore, createVoiceFileIntegrationEventStore, createVoiceFileReviewStore, createVoiceFileRuntimeStorage, createVoiceFileSessionStore, createVoiceFileTaskStore, createVoiceFileTraceSinkDeliveryStore, createVoiceFileTraceEventStore } from './fileStore';
 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';
@@ -35,9 +37,11 @@ export { createVoiceCallReviewFromLiveTelephonyReport, createVoiceCallReviewReco
 export type { VoiceAssistant, VoiceAssistantArtifactPlan, VoiceAssistantExperiment, VoiceAssistantExperimentOptions, VoiceAssistantGuardrailInput, VoiceAssistantGuardrails, VoiceAssistantMemoryLifecycle, VoiceAssistantMemoryLifecycleInput, VoiceAssistantOptions, VoiceAssistantOutputGuardrailInput, VoiceAssistantPreset, VoiceAssistantRunsSummary, VoiceAssistantRunSummary, VoiceAssistantVariant } from './assistant';
 export type { VoiceAssistantHealthFailure, VoiceAssistantHealthHTMLHandlerOptions, VoiceAssistantHealthRoutesOptions, VoiceAssistantHealthSummary, VoiceAssistantHealthSummaryOptions } from './assistantHealth';
 export type { VoiceAssistantMemoryBinding, VoiceAssistantMemoryHandle, VoiceAssistantMemoryOptions, VoiceAssistantMemoryRecord, VoiceAssistantMemoryStore } from './assistantMemory';
+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

@@ -6822,7 +6822,7 @@ var createVoiceAssistantHealthRoutes = (options) => {
   }
   return routes;
 };
-// src/sessionReplay.ts
+// src/diagnosticsRoutes.ts
 import { Elysia as Elysia4 } from "elysia";
 
 // src/trace.ts
@@ -7489,9 +7489,144 @@ var buildVoiceTraceReplay = (events, options = {}) => ({
   summary: summarizeVoiceTrace(options.redact ? redactVoiceTraceEvents(events, options.redact) : events)
 });
 
-// src/sessionReplay.ts
-var getString3 = (value) => typeof value === "string" ? value : undefined;
+// src/diagnosticsRoutes.ts
 var escapeHtml6 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var getString3 = (value) => typeof value === "string" && value.trim() ? value : undefined;
+var getNumber2 = (value) => {
+  const parsed = typeof value === "number" ? value : typeof value === "string" ? Number(value) : undefined;
+  return typeof parsed === "number" && Number.isFinite(parsed) ? parsed : undefined;
+};
+var getBoolean = (value) => value === true || value === "true" || value === "1";
+var parseTraceTypeFilter = (value) => {
+  if (typeof value !== "string" || !value.trim()) {
+    return;
+  }
+  const types = value.split(",").map((entry) => entry.trim()).filter(Boolean);
+  return types.length <= 1 ? types[0] : types;
+};
+var resolveVoiceDiagnosticsTraceFilter = (query) => ({
+  limit: getNumber2(query.limit),
+  scenarioId: getString3(query.scenarioId),
+  sessionId: getString3(query.sessionId),
+  traceId: getString3(query.traceId),
+  turnId: getString3(query.turnId),
+  type: parseTraceTypeFilter(query.type)
+});
+var filterByDiagnosticsQuery = (events, query) => {
+  const provider = getString3(query.provider);
+  const status = getString3(query.status);
+  const since = getNumber2(query.since);
+  const until = getNumber2(query.until);
+  return filterVoiceTraceEvents(events, resolveVoiceDiagnosticsTraceFilter(query)).filter((event) => (!provider || event.payload.provider === provider) && (!status || event.payload.providerStatus === status || event.payload.status === status) && (since === undefined || event.at >= since) && (until === undefined || event.at <= until));
+};
+var buildVoiceDiagnosticsMarkdown = (events, options = {}) => {
+  const summary = summarizeVoiceTrace(events);
+  const evaluation = evaluateVoiceTrace(events, options.evaluation);
+  const trace = renderVoiceTraceMarkdown(events, {
+    evaluation: options.evaluation,
+    title: options.title ?? `Voice Diagnostics ${summary.sessionId ?? ""}`.trim()
+  });
+  return [
+    `# ${options.title ?? "Voice Diagnostics Bug Report"}`,
+    "",
+    `Session: ${summary.sessionId ?? "unknown"}`,
+    `Pass: ${evaluation.pass ? "yes" : "no"}`,
+    `Events: ${summary.eventCount}`,
+    `Turns: ${summary.turnCount}`,
+    `Errors: ${summary.errorCount}`,
+    `Tool errors: ${summary.toolErrorCount}`,
+    `Estimated cost units: ${summary.cost.estimatedRelativeCostUnits}`,
+    "",
+    "## Issues",
+    "",
+    evaluation.issues.length ? evaluation.issues.map((issue) => `- [${issue.severity}] ${issue.code}: ${issue.message}`).join(`
+`) : "- none",
+    "",
+    "## Trace",
+    "",
+    trace
+  ].join(`
+`);
+};
+var renderDiagnosticsIndex = (input) => {
+  const sessions = new Map;
+  for (const event of input.events) {
+    sessions.set(event.sessionId, [...sessions.get(event.sessionId) ?? [], event]);
+  }
+  const rows = [...sessions.entries()].sort(([, left], [, right]) => (right.at(-1)?.at ?? 0) - (left.at(-1)?.at ?? 0)).slice(0, 50).map(([sessionId, events]) => {
+    const summary = summarizeVoiceTrace(events);
+    const encoded = encodeURIComponent(sessionId);
+    return `<tr><td>${escapeHtml6(sessionId)}</td><td>${summary.eventCount}</td><td>${summary.turnCount}</td><td>${summary.errorCount}</td><td><a href="${input.basePath}/html?sessionId=${encoded}&redact=true">HTML</a> \xB7 <a href="${input.basePath}/markdown?sessionId=${encoded}&redact=true">Markdown</a> \xB7 <a href="${input.basePath}/json?sessionId=${encoded}&redact=true">JSON</a></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>${escapeHtml6(input.title)}</title><style>body{font-family:ui-sans-serif,system-ui,sans-serif;margin:2rem;background:#f8f7f2;color:#181713}main{max-width:1100px;margin:auto}table{width:100%;border-collapse:collapse;background:white}td,th{border-bottom:1px solid #eee;padding:.7rem;text-align:left}a{color:#9a3412}</style></head><body><main><h1>${escapeHtml6(input.title)}</h1><p>Recent voice trace diagnostics. Exports support filters: sessionId, traceId, turnId, scenarioId, type, provider, status, since, until, limit, redact.</p><table><thead><tr><th>Session</th><th>Events</th><th>Turns</th><th>Errors</th><th>Exports</th></tr></thead><tbody>${rows}</tbody></table></main></body></html>`;
+};
+var withRedaction = (events, query, defaultRedact) => {
+  const shouldRedact = query.redact === undefined ? defaultRedact : getBoolean(query.redact);
+  return shouldRedact ? redactVoiceTraceEvents(events, shouldRedact) : events;
+};
+var createVoiceDiagnosticsRoutes = (options) => {
+  const path = options.path ?? "/diagnostics";
+  const title = options.title ?? "AbsoluteJS Voice Diagnostics";
+  const routes = new Elysia4({
+    name: options.name ?? "absolutejs-voice-diagnostics"
+  });
+  routes.get(path, async () => {
+    const events = await options.store.list();
+    return new Response(renderDiagnosticsIndex({ basePath: path, events, title }), {
+      headers: {
+        "Content-Type": "text/html; charset=utf-8",
+        ...options.headers
+      }
+    });
+  });
+  routes.get(`${path}/json`, async ({ query }) => {
+    const events = filterByDiagnosticsQuery(await options.store.list(), query);
+    const redacted = withRedaction(events, query, options.redact);
+    return Response.json({
+      ...await exportVoiceTrace({
+        filter: resolveVoiceDiagnosticsTraceFilter(query),
+        redact: false,
+        store: {
+          ...options.store,
+          list: async () => redacted
+        }
+      }),
+      filteredCount: events.length,
+      redacted: redacted !== events
+    });
+  });
+  routes.get(`${path}/markdown`, async ({ query }) => {
+    const events = withRedaction(filterByDiagnosticsQuery(await options.store.list(), query), query, options.redact ?? true);
+    const body = buildVoiceDiagnosticsMarkdown(events, {
+      evaluation: options.evaluation,
+      title
+    });
+    return new Response(body, {
+      headers: {
+        "Content-Type": "text/markdown; charset=utf-8",
+        ...options.headers
+      }
+    });
+  });
+  routes.get(`${path}/html`, async ({ query }) => {
+    const events = withRedaction(filterByDiagnosticsQuery(await options.store.list(), query), query, options.redact ?? true);
+    const body = renderVoiceTraceHTML(events, {
+      evaluation: options.evaluation,
+      title
+    });
+    return new Response(body, {
+      headers: {
+        "Content-Type": "text/html; charset=utf-8",
+        ...options.headers
+      }
+    });
+  });
+  return routes;
+};
+// src/sessionReplay.ts
+import { Elysia as Elysia5 } from "elysia";
+var getString4 = (value) => typeof value === "string" ? value : undefined;
+var escapeHtml7 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var increment2 = (record, key) => {
   record[key] = (record[key] ?? 0) + 1;
 };
@@ -7520,14 +7655,14 @@ var buildReplayTurns = (events) => {
       case "turn.transcript":
         turn.transcripts.push({
           isFinal: event.payload.isFinal === true,
-          text: getString3(event.payload.text)
+          text: getString4(event.payload.text)
         });
         break;
       case "turn.committed":
-        turn.committedText = getString3(event.payload.text);
+        turn.committedText = getString4(event.payload.text);
         break;
       case "turn.assistant": {
-        const text = getString3(event.payload.text);
+        const text = getString4(event.payload.text);
         if (text) {
           turn.assistantReplies.push(text);
         }
@@ -7596,7 +7731,7 @@ var summarizeVoiceSessions = async (options = {}) => {
     let latestOutcome;
     let errorCount = 0;
     for (const event of sorted) {
-      const provider = getString3(event.payload.provider);
+      const provider = getString4(event.payload.provider);
       if (provider) {
         providers.add(provider);
       }
@@ -7604,7 +7739,7 @@ var summarizeVoiceSessions = async (options = {}) => {
         errorCount += 1;
         increment2(providerErrors, provider ?? "unknown");
       }
-      const outcome = getString3(event.payload.outcome);
+      const outcome = getString4(event.payload.outcome);
       if (outcome) {
         latestOutcome = outcome;
       }
@@ -7650,10 +7785,10 @@ var summarizeVoiceSessions = async (options = {}) => {
 var renderVoiceSessionsHTML = (sessions) => sessions.length === 0 ? '<p class="voice-sessions-empty">No voice sessions found.</p>' : [
   '<div class="voice-sessions-list">',
   ...sessions.map((session) => [
-    `<article class="voice-session-card ${escapeHtml6(session.status)}">`,
+    `<article class="voice-session-card ${escapeHtml7(session.status)}">`,
     '<div class="voice-session-card-header">',
-    `<strong>${escapeHtml6(session.sessionId)}</strong>`,
-    `<span>${escapeHtml6(session.status)}</span>`,
+    `<strong>${escapeHtml7(session.sessionId)}</strong>`,
+    `<span>${escapeHtml7(session.status)}</span>`,
     "</div>",
     "<dl>",
     `<div><dt>Events</dt><dd>${String(session.eventCount)}</dd></div>`,
@@ -7661,9 +7796,9 @@ var renderVoiceSessionsHTML = (sessions) => sessions.length === 0 ? '<p class="v
     `<div><dt>Transcripts</dt><dd>${String(session.transcriptCount)}</dd></div>`,
     `<div><dt>Errors</dt><dd>${String(session.errorCount)}</dd></div>`,
     "</dl>",
-    session.latestOutcome ? `<p>Outcome: ${escapeHtml6(session.latestOutcome)}</p>` : "",
-    session.providers.length ? `<p>Providers: ${session.providers.map(escapeHtml6).join(", ")}</p>` : "",
-    session.replayHref ? `<p><a href="${escapeHtml6(session.replayHref)}">Open replay</a></p>` : "",
+    session.latestOutcome ? `<p>Outcome: ${escapeHtml7(session.latestOutcome)}</p>` : "",
+    session.providers.length ? `<p>Providers: ${session.providers.map(escapeHtml7).join(", ")}</p>` : "",
+    session.replayHref ? `<p><a href="${escapeHtml7(session.replayHref)}">Open replay</a></p>` : "",
     "</article>"
   ].join("")),
   "</div>"
@@ -7694,7 +7829,7 @@ var createVoiceSessionsHTMLHandler = (options = {}) => async ({ query }) => {
 var createVoiceSessionListRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice-sessions";
   const htmlPath = options.htmlPath === undefined ? `${path}/htmx` : options.htmlPath;
-  const routes = new Elysia4({
+  const routes = new Elysia5({
     name: options.name ?? "absolutejs-voice-session-list"
   }).get(path, createVoiceSessionsJSONHandler(options));
   if (htmlPath) {
@@ -7722,7 +7857,7 @@ var createVoiceSessionReplayHTMLHandler = (options) => async ({ params }) => {
 var createVoiceSessionReplayRoutes = (options) => {
   const path = options.path ?? "/api/voice-sessions/:sessionId/replay";
   const htmlPath = options.htmlPath === undefined ? `${path}/htmx` : options.htmlPath;
-  const routes = new Elysia4({
+  const routes = new Elysia5({
     name: options.name ?? "absolutejs-voice-session-replay"
   }).get(path, createVoiceSessionReplayJSONHandler(options));
   if (htmlPath) {
@@ -8858,12 +8993,356 @@ var createGeminiVoiceAssistantModel = (options) => {
     }
   };
 };
+// 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.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 Elysia5 } from "elysia";
-var escapeHtml7 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var getString4 = (value) => typeof value === "string" ? value : undefined;
-var getNumber2 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
-var getBoolean = (value) => value === true;
+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) => {
   const routingEvents = [];
@@ -8871,26 +9350,26 @@ var listVoiceRoutingEvents = (events) => {
     if (event.type !== "session.error") {
       continue;
     }
-    const provider = getString4(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 = getString4(event.payload.kind);
+    const kind = getString7(event.payload.kind);
     routingEvents.push({
       at: event.at,
-      attempt: getNumber2(event.payload.attempt),
-      elapsedMs: getNumber2(event.payload.elapsedMs),
-      error: getString4(event.payload.error),
-      fallbackProvider: getString4(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: getNumber2(event.payload.latencyBudgetMs),
-      operation: getString4(event.payload.operation),
+      latencyBudgetMs: getNumber4(event.payload.latencyBudgetMs),
+      operation: getString7(event.payload.operation),
       provider,
-      selectedProvider: getString4(event.payload.selectedProvider),
+      selectedProvider: getString7(event.payload.selectedProvider),
       sessionId: event.sessionId,
       status: providerStatus,
-      timedOut: getBoolean(event.payload.timedOut),
+      timedOut: getBoolean2(event.payload.timedOut),
       turnId: event.turnId
     });
   }
@@ -8923,13 +9402,13 @@ var summarizeRoutingEvents = (events) => {
 };
 var renderProviderCards = (title, providers) => {
   if (providers.length === 0) {
-    return `<p class="muted">No ${escapeHtml7(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 ${escapeHtml7(provider.status)}">
+        <article class="card provider ${escapeHtml10(provider.status)}">
           <div class="card-header">
-            <strong>${escapeHtml7(provider.provider)}</strong>
-            <span>${escapeHtml7(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>
@@ -8938,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">${escapeHtml7(provider.lastError)}</p>` : ""}
+          ${provider.lastError ? `<p class="muted">${escapeHtml10(provider.lastError)}</p>` : ""}
         </article>
       `).join("")}</div>`;
 };
@@ -8947,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 ${escapeHtml7(event.status ?? "unknown")}">
+        <article class="card event ${escapeHtml10(event.status ?? "unknown")}">
           <div class="card-header">
-            <strong>${escapeHtml7(event.kind.toUpperCase())} ${escapeHtml7(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">${escapeHtml7(event.status ?? "unknown")}</span>
-            <span class="pill">provider: ${escapeHtml7(event.provider ?? "unknown")}</span>
-            ${event.fallbackProvider ? `<span class="pill">fallback: ${escapeHtml7(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>${escapeHtml7(event.sessionId)}</dd></div>
+            <div><dt>Session</dt><dd>${escapeHtml10(event.sessionId)}</dd></div>
           </dl>
-          ${event.error ? `<p class="muted">${escapeHtml7(event.error)}</p>` : ""}
+          ${event.error ? `<p class="muted">${escapeHtml10(event.error)}</p>` : ""}
         </article>
       `).join("")}</div>`;
 };
@@ -8979,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="${escapeHtml7(pathPrefix)}">
-    <p class="muted">${escapeHtml7(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="${escapeHtml7(provider)}"${canFail(provider) ? "" : " disabled"}>Simulate ${escapeHtml7(provider)} ${kind.toUpperCase()} failure</button>`).join("")}
-      ${configuredProviders.map((provider) => `<button type="button" data-provider-recover="${escapeHtml7(provider.provider)}">Mark ${escapeHtml7(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">${escapeHtml7(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">${escapeHtml7(kind)}: ${String(count)}</span>`).join("");
-  const links = input.links?.length ? input.links.map((link) => `<a href="${escapeHtml7(link.href)}">${escapeHtml7(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>${escapeHtml7(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; }
@@ -9134,7 +9613,7 @@ var registerSimulationRoutes = (routes, simulation, defaultPathPrefix) => {
 };
 var createVoiceResilienceRoutes = (options) => {
   const path = options.path ?? "/resilience";
-  const routes = new Elysia5({
+  const routes = new Elysia8({
     name: options.name ?? "absolutejs-voice-resilience"
   }).get(path, async () => {
     const events = await options.store.list();
@@ -10015,7 +10494,7 @@ var createVoiceMemoryStore = () => {
   return { get, getOrCreate, list, remove, set };
 };
 // src/opsWebhook.ts
-import { Elysia as Elysia6 } 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;
@@ -10145,7 +10624,7 @@ var verifyVoiceOpsWebhookSignature = async (input) => {
 };
 var createVoiceOpsWebhookReceiverRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice-ops/webhook";
-  return new Elysia6().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({
@@ -10177,198 +10656,6 @@ var createVoiceOpsWebhookReceiverRoutes = (options = {}) => {
     parse: "text"
   });
 };
-// src/handoffHealth.ts
-import { Elysia as Elysia7 } from "elysia";
-var escapeHtml8 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-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 Elysia7({
-    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
@@ -12507,6 +12794,7 @@ export {
   resolveVoiceOpsTaskAssignment,
   resolveVoiceOpsTaskAgeBucket,
   resolveVoiceOpsPreset,
+  resolveVoiceDiagnosticsTraceFilter,
   resolveVoiceAssistantMemoryNamespace,
   resolveTurnDetectionConfig,
   resolveAudioConditioningConfig,
@@ -12516,6 +12804,7 @@ export {
   renderVoiceTraceHTML,
   renderVoiceSessionsHTML,
   renderVoiceResilienceHTML,
+  renderVoiceQualityHTML,
   renderVoiceProviderHealthHTML,
   renderVoiceHandoffHealthHTML,
   renderVoiceCallReviewMarkdown,
@@ -12537,6 +12826,7 @@ export {
   failVoiceOpsTask,
   exportVoiceTrace,
   evaluateVoiceTrace,
+  evaluateVoiceQuality,
   encodeTwilioMulawBase64,
   deliverVoiceTraceEventsToSinks,
   deliverVoiceIntegrationEventToSinks,
@@ -12587,6 +12877,7 @@ export {
   createVoiceResilienceRoutes,
   createVoiceRedisTaskLeaseCoordinator,
   createVoiceRedisIdempotencyStore,
+  createVoiceQualityRoutes,
   createVoiceProviderRouter,
   createVoiceProviderHealthRoutes,
   createVoiceProviderHealthJSONHandler,
@@ -12640,6 +12931,7 @@ export {
   createVoiceExternalObjectMapId,
   createVoiceExternalObjectMap,
   createVoiceExperiment,
+  createVoiceDiagnosticsRoutes,
   createVoiceCallReviewRecorder,
   createVoiceCallReviewFromSession,
   createVoiceCallReviewFromLiveTelephonyReport,
@@ -12675,6 +12967,7 @@ export {
   buildVoiceTraceReplay,
   buildVoiceOpsTaskFromSLABreach,
   buildVoiceOpsTaskFromReview,
+  buildVoiceDiagnosticsMarkdown,
   assignVoiceOpsTask,
   applyVoiceOpsTaskPolicy,
   applyVoiceOpsTaskAssignmentRule,

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.37",
+	"version": "0.0.22-beta.39",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",