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

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,6 +1,7 @@
 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';
@@ -35,6 +36,7 @@ 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';

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) {
@@ -8859,11 +8994,11 @@ var createGeminiVoiceAssistantModel = (options) => {
   };
 };
 // 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 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 getNumber3 = (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 +9006,26 @@ var listVoiceRoutingEvents = (events) => {
     if (event.type !== "session.error") {
       continue;
     }
-    const provider = getString4(event.payload.provider);
+    const provider = getString5(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 = getString5(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: getNumber3(event.payload.attempt),
+      elapsedMs: getNumber3(event.payload.elapsedMs),
+      error: getString5(event.payload.error),
+      fallbackProvider: getString5(event.payload.fallbackProvider),
       kind: kind === "stt" || kind === "tts" ? kind : "llm",
-      latencyBudgetMs: getNumber2(event.payload.latencyBudgetMs),
-      operation: getString4(event.payload.operation),
+      latencyBudgetMs: getNumber3(event.payload.latencyBudgetMs),
+      operation: getString5(event.payload.operation),
       provider,
-      selectedProvider: getString4(event.payload.selectedProvider),
+      selectedProvider: getString5(event.payload.selectedProvider),
       sessionId: event.sessionId,
       status: providerStatus,
-      timedOut: getBoolean(event.payload.timedOut),
+      timedOut: getBoolean2(event.payload.timedOut),
       turnId: event.turnId
     });
   }
@@ -8923,13 +9058,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 ${escapeHtml8(title)} provider health yet.</p>`;
   }
   return `<div class="provider-grid">${providers.map((provider) => `
-        <article class="card provider ${escapeHtml7(provider.status)}">
+        <article class="card provider ${escapeHtml8(provider.status)}">
           <div class="card-header">
-            <strong>${escapeHtml7(provider.provider)}</strong>
-            <span>${escapeHtml7(provider.status)}${provider.recommended ? " \xB7 recommended" : ""}</span>
+            <strong>${escapeHtml8(provider.provider)}</strong>
+            <span>${escapeHtml8(provider.status)}${provider.recommended ? " \xB7 recommended" : ""}</span>
           </div>
           <dl>
             <div><dt>Runs</dt><dd>${provider.runCount}</dd></div>
@@ -8938,7 +9073,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">${escapeHtml8(provider.lastError)}</p>` : ""}
         </article>
       `).join("")}</div>`;
 };
@@ -8947,24 +9082,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 ${escapeHtml8(event.status ?? "unknown")}">
           <div class="card-header">
-            <strong>${escapeHtml7(event.kind.toUpperCase())} ${escapeHtml7(event.operation ?? "generate")}</strong>
+            <strong>${escapeHtml8(event.kind.toUpperCase())} ${escapeHtml8(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">${escapeHtml8(event.status ?? "unknown")}</span>
+            <span class="pill">provider: ${escapeHtml8(event.provider ?? "unknown")}</span>
+            ${event.fallbackProvider ? `<span class="pill">fallback: ${escapeHtml8(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>${escapeHtml8(event.sessionId)}</dd></div>
           </dl>
-          ${event.error ? `<p class="muted">${escapeHtml7(event.error)}</p>` : ""}
+          ${event.error ? `<p class="muted">${escapeHtml8(event.error)}</p>` : ""}
         </article>
       `).join("")}</div>`;
 };
@@ -8979,26 +9114,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="${escapeHtml8(pathPrefix)}">
+    <p class="muted">${escapeHtml8(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="${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("")}
     </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">${escapeHtml8(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">${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 ") : "";
   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>${escapeHtml8(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 +9269,7 @@ var registerSimulationRoutes = (routes, simulation, defaultPathPrefix) => {
 };
 var createVoiceResilienceRoutes = (options) => {
   const path = options.path ?? "/resilience";
-  const routes = new Elysia5({
+  const routes = new Elysia6({
     name: options.name ?? "absolutejs-voice-resilience"
   }).get(path, async () => {
     const events = await options.store.list();
@@ -10015,7 +10150,7 @@ var createVoiceMemoryStore = () => {
   return { get, getOrCreate, list, remove, set };
 };
 // src/opsWebhook.ts
-import { Elysia as Elysia6 } from "elysia";
+import { Elysia as Elysia7 } 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 +10280,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 Elysia7().post(path, async ({ body, request, set }) => {
     const bodyText = typeof body === "string" ? body : JSON.stringify(body);
     if (options.signingSecret) {
       const verification = await verifyVoiceOpsWebhookSignature({
@@ -10178,9 +10313,9 @@ var createVoiceOpsWebhookReceiverRoutes = (options = {}) => {
   });
 };
 // 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;
+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;
@@ -10188,11 +10323,11 @@ var increment3 = (record, key) => {
 var normalizeDelivery = (adapterId, value) => {
   const record = value && typeof value === "object" ? value : {};
   return {
-    adapterId: getString5(record.adapterId) ?? adapterId,
-    adapterKind: getString5(record.adapterKind),
+    adapterId: getString6(record.adapterId) ?? adapterId,
+    adapterKind: getString6(record.adapterKind),
     deliveredAt: typeof record.deliveredAt === "number" ? record.deliveredAt : undefined,
-    deliveredTo: getString5(record.deliveredTo),
-    error: getString5(record.error),
+    deliveredTo: getString6(record.deliveredTo),
+    error: getString6(record.error),
     status: isStatus(record.status) ? record.status : "failed"
   };
 };
@@ -10226,13 +10361,13 @@ var summarizeVoiceHandoffHealth = async (options = {}) => {
     const status = isStatus(event.payload.status) ? event.payload.status : "failed";
     const deliveries = normalizeDeliveries(event.payload);
     const item = {
-      action: getString5(event.payload.action),
+      action: getString6(event.payload.action),
       at: event.at,
       deliveries,
-      reason: getString5(event.payload.reason),
+      reason: getString6(event.payload.reason),
       sessionId: event.sessionId,
       status,
-      target: getString5(event.payload.target)
+      target: getString6(event.payload.target)
     };
     return {
       ...item,
@@ -10297,10 +10432,10 @@ var renderActionSummary = (summary) => {
   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>`,
+    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>${escapeHtml8(adapterId)}: ${String(counts.delivered)} delivered / ${String(counts.failed)} failed / ${String(counts.skipped)} skipped</li>`).join("")}</ul>`,
+    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("");
@@ -10314,22 +10449,22 @@ var renderVoiceHandoffHealthHTML = (summary) => [
   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)}">`,
+      `<article class="${escapeHtml9(event.status)}">`,
       '<div class="voice-handoff-health-event-header">',
-      `<strong>${escapeHtml8(event.action ?? "handoff")}</strong>`,
-      `<span>${escapeHtml8(event.status)}</span>`,
+      `<strong>${escapeHtml9(event.action ?? "handoff")}</strong>`,
+      `<span>${escapeHtml9(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>` : "",
+      `<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>",
-        `${escapeHtml8(delivery.adapterId)}: ${escapeHtml8(delivery.status)}`,
-        delivery.deliveredTo ? ` to ${escapeHtml8(delivery.deliveredTo)}` : "",
-        delivery.error ? ` (${escapeHtml8(delivery.error)})` : "",
+        `${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="${escapeHtml8(event.replayHref)}">Open replay</a></p>` : "",
+      event.replayHref ? `<p><a href="${escapeHtml9(event.replayHref)}">Open replay</a></p>` : "",
       "</article>"
     ].join("")),
     "</div>"
@@ -10361,7 +10496,7 @@ var createVoiceHandoffHealthHTMLHandler = (options = {}) => async ({ query }) =>
 var createVoiceHandoffHealthRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice-handoffs";
   const htmlPath = options.htmlPath === undefined ? `${path}/htmx` : options.htmlPath;
-  const routes = new Elysia7({
+  const routes = new Elysia8({
     name: options.name ?? "absolutejs-voice-handoff-health"
   }).get(path, createVoiceHandoffHealthJSONHandler(options));
   if (htmlPath) {
@@ -12507,6 +12642,7 @@ export {
   resolveVoiceOpsTaskAssignment,
   resolveVoiceOpsTaskAgeBucket,
   resolveVoiceOpsPreset,
+  resolveVoiceDiagnosticsTraceFilter,
   resolveVoiceAssistantMemoryNamespace,
   resolveTurnDetectionConfig,
   resolveAudioConditioningConfig,
@@ -12640,6 +12776,7 @@ export {
   createVoiceExternalObjectMapId,
   createVoiceExternalObjectMap,
   createVoiceExperiment,
+  createVoiceDiagnosticsRoutes,
   createVoiceCallReviewRecorder,
   createVoiceCallReviewFromSession,
   createVoiceCallReviewFromLiveTelephonyReport,
@@ -12675,6 +12812,7 @@ export {
   buildVoiceTraceReplay,
   buildVoiceOpsTaskFromSLABreach,
   buildVoiceOpsTaskFromReview,
+  buildVoiceDiagnosticsMarkdown,
   assignVoiceOpsTask,
   applyVoiceOpsTaskPolicy,
   applyVoiceOpsTaskAssignmentRule,

package/package.json

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