@absolutejs/voice 0.0.22-beta.36 → 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,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 { 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';
 export { createVoiceSQLiteExternalObjectMapStore, createVoiceSQLiteIntegrationEventStore, createVoiceSQLiteReviewStore, createVoiceSQLiteRuntimeStorage, createVoiceSQLiteSessionStore, createVoiceSQLiteTaskStore, createVoiceSQLiteTraceSinkDeliveryStore, createVoiceSQLiteTraceEventStore } from './sqliteStore';
@@ -34,9 +36,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 { 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';
 export type { VoiceOpsRuntime, VoiceOpsRuntimeConfig, VoiceOpsRuntimeSummary, VoiceOpsRuntimeSinkWorkerConfig, VoiceOpsRuntimeTaskWorkerConfig, VoiceOpsRuntimeTickResult, VoiceOpsRuntimeWebhookWorkerConfig } from './opsRuntime';

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,6 +8993,319 @@ var createGeminiVoiceAssistantModel = (options) => {
     }
   };
 };
+// src/resilienceRoutes.ts
+import { Elysia as Elysia6 } from "elysia";
+var escapeHtml8 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var getString5 = (value) => typeof value === "string" ? value : undefined;
+var 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 = [];
+  for (const event of events) {
+    if (event.type !== "session.error") {
+      continue;
+    }
+    const provider = getString5(event.payload.provider);
+    const providerStatus = isProviderStatus2(event.payload.providerStatus) ? event.payload.providerStatus : undefined;
+    if (!provider || !providerStatus) {
+      continue;
+    }
+    const kind = getString5(event.payload.kind);
+    routingEvents.push({
+      at: event.at,
+      attempt: getNumber3(event.payload.attempt),
+      elapsedMs: getNumber3(event.payload.elapsedMs),
+      error: getString5(event.payload.error),
+      fallbackProvider: getString5(event.payload.fallbackProvider),
+      kind: kind === "stt" || kind === "tts" ? kind : "llm",
+      latencyBudgetMs: getNumber3(event.payload.latencyBudgetMs),
+      operation: getString5(event.payload.operation),
+      provider,
+      selectedProvider: getString5(event.payload.selectedProvider),
+      sessionId: event.sessionId,
+      status: providerStatus,
+      timedOut: getBoolean2(event.payload.timedOut),
+      turnId: event.turnId
+    });
+  }
+  return routingEvents.sort((left, right) => right.at - left.at);
+};
+var summarizeRoutingEvents = (events) => {
+  const byKind = new Map;
+  let errors = 0;
+  let fallbacks = 0;
+  let timeouts = 0;
+  for (const event of events) {
+    byKind.set(event.kind, (byKind.get(event.kind) ?? 0) + 1);
+    if (event.status === "error") {
+      errors += 1;
+    }
+    if (event.status === "fallback") {
+      fallbacks += 1;
+    }
+    if (event.timedOut) {
+      timeouts += 1;
+    }
+  }
+  return {
+    byKind,
+    errors,
+    fallbacks,
+    timeouts,
+    total: events.length
+  };
+};
+var renderProviderCards = (title, providers) => {
+  if (providers.length === 0) {
+    return `<p class="muted">No ${escapeHtml8(title)} provider health yet.</p>`;
+  }
+  return `<div class="provider-grid">${providers.map((provider) => `
+        <article class="card provider ${escapeHtml8(provider.status)}">
+          <div class="card-header">
+            <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>
+            <div><dt>Avg latency</dt><dd>${provider.averageElapsedMs ?? 0}ms</dd></div>
+            <div><dt>Errors</dt><dd>${provider.errorCount}</dd></div>
+            <div><dt>Timeouts</dt><dd>${provider.timeoutCount}</dd></div>
+            <div><dt>Fallbacks</dt><dd>${provider.fallbackCount}</dd></div>
+          </dl>
+          ${provider.lastError ? `<p class="muted">${escapeHtml8(provider.lastError)}</p>` : ""}
+        </article>
+      `).join("")}</div>`;
+};
+var renderTimeline2 = (events) => {
+  if (events.length === 0) {
+    return '<p class="muted">No provider routing events yet. Run the app or simulate provider failover.</p>';
+  }
+  return `<div class="timeline">${events.slice(0, 40).map((event) => `
+        <article class="card event ${escapeHtml8(event.status ?? "unknown")}">
+          <div class="card-header">
+            <strong>${escapeHtml8(event.kind.toUpperCase())} ${escapeHtml8(event.operation ?? "generate")}</strong>
+            <span>${new Date(event.at).toLocaleString()}</span>
+          </div>
+          <p>
+            <span class="pill">${escapeHtml8(event.status ?? "unknown")}</span>
+            <span class="pill">provider: ${escapeHtml8(event.provider ?? "unknown")}</span>
+            ${event.fallbackProvider ? `<span class="pill">fallback: ${escapeHtml8(event.fallbackProvider)}</span>` : ""}
+            ${event.timedOut ? '<span class="pill danger">timed out</span>' : ""}
+          </p>
+          <dl>
+            <div><dt>Attempt</dt><dd>${event.attempt ?? 0}</dd></div>
+            <div><dt>Elapsed</dt><dd>${event.elapsedMs ?? 0}ms</dd></div>
+            <div><dt>Budget</dt><dd>${event.latencyBudgetMs ?? 0}ms</dd></div>
+            <div><dt>Session</dt><dd>${escapeHtml8(event.sessionId)}</dd></div>
+          </dl>
+          ${event.error ? `<p class="muted">${escapeHtml8(event.error)}</p>` : ""}
+        </article>
+      `).join("")}</div>`;
+};
+var renderSimulationControls = (kind, simulation) => {
+  if (!simulation) {
+    return "";
+  }
+  const configuredProviders = simulation.providers.filter((provider) => provider.configured !== false);
+  if (configuredProviders.length === 0) {
+    return `<p class="muted">No ${kind.toUpperCase()} providers are configured for simulation.</p>`;
+  }
+  const pathPrefix = simulation.pathPrefix ?? `/api/${kind}-simulate`;
+  const failureProviders = simulation.failureProviders ?? configuredProviders.map(({ provider }) => provider);
+  const canFail = (provider) => configuredProviders.some((entry) => entry.provider === provider) && (!simulation.fallbackRequiredProvider || configuredProviders.some((entry) => entry.provider === simulation.fallbackRequiredProvider));
+  return `<div class="simulate-panel" data-sim-kind="${kind}" data-sim-prefix="${escapeHtml8(pathPrefix)}">
+    <p class="muted">${escapeHtml8(simulation.failureMessage ?? `Simulate ${kind.toUpperCase()} provider failure without changing provider credentials.`)}</p>
+    <div class="simulate-actions">
+      ${failureProviders.map((provider) => `<button type="button" data-provider-fail="${escapeHtml8(provider)}"${canFail(provider) ? "" : " disabled"}>Simulate ${escapeHtml8(provider)} ${kind.toUpperCase()} failure</button>`).join("")}
+      ${configuredProviders.map((provider) => `<button type="button" data-provider-recover="${escapeHtml8(provider.provider)}">Mark ${escapeHtml8(provider.provider)} recovered</button>`).join("")}
+    </div>
+    ${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">${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>${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; }
+    main { display: grid; gap: 16px; margin: 0 auto; max-width: 1180px; }
+    section, .card { background: rgba(19, 22, 27, 0.92); border: 1px solid #27272a; border-radius: 20px; padding: 20px; }
+    .hero { background: linear-gradient(135deg, rgba(14, 165, 233, 0.18), rgba(245, 158, 11, 0.12)); }
+    .grid, .provider-grid { display: grid; gap: 14px; grid-template-columns: repeat(4, minmax(0, 1fr)); }
+    .timeline { display: grid; gap: 12px; }
+    .card-header { align-items: center; display: flex; gap: 12px; justify-content: space-between; }
+    .card-header strong { font-size: 1.05rem; }
+    .metric strong { display: block; font-size: 2rem; margin-top: 6px; }
+    .muted, dt, span { color: #a1a1aa; }
+    dl { display: grid; gap: 8px; grid-template-columns: repeat(4, minmax(0, 1fr)); }
+    dl div { background: #0f1217; border: 1px solid #27272a; border-radius: 12px; padding: 10px; }
+    dd { font-weight: 800; margin: 4px 0 0; }
+    .pill { background: #0f1217; border: 1px solid #3f3f46; border-radius: 999px; color: #d4d4d8; display: inline-flex; margin: 3px 4px 3px 0; padding: 5px 9px; }
+    .danger { border-color: rgba(239, 68, 68, 0.75); color: #fecaca; }
+    .event.error { border-color: rgba(239, 68, 68, 0.7); }
+    .event.fallback { border-color: rgba(245, 158, 11, 0.7); }
+    .event.success, .provider.healthy { border-color: rgba(34, 197, 94, 0.5); }
+    .provider.suppressed, .provider.degraded, .provider.rate-limited { border-color: rgba(239, 68, 68, 0.7); }
+    .provider.recoverable { border-color: rgba(59, 130, 246, 0.7); }
+    button { background: #f59e0b; border: 0; border-radius: 999px; color: #111827; cursor: pointer; font-weight: 800; padding: 10px 14px; }
+    button:disabled { cursor: not-allowed; opacity: 0.45; }
+    .simulate-actions { display: flex; flex-wrap: wrap; gap: 10px; margin-top: 12px; }
+    .simulate-output { background: #050505; border: 1px solid #27272a; border-radius: 14px; color: #d4d4d8; overflow: auto; padding: 12px; white-space: pre-wrap; }
+    a { color: #f59e0b; }
+    @media (max-width: 850px) { .grid, .provider-grid, dl { grid-template-columns: 1fr; } }
+  </style>
+</head>
+<body>
+  <main>
+    <section class="hero">
+      <h1>Provider routing and resilience</h1>
+      <p>One view for the production reliability story: LLM failover, STT/TTS routing, latency budgets, timeouts, and fallback decisions.</p>
+      ${links ? `<p>${links}</p>` : ""}
+      <p>${kindCounts || '<span class="pill">No routing events yet</span>'}</p>
+    </section>
+    <section class="grid">
+      <article class="card metric"><span>Total routing events</span><strong>${summary.total}</strong></article>
+      <article class="card metric"><span>Fallbacks</span><strong>${summary.fallbacks}</strong></article>
+      <article class="card metric"><span>Errors</span><strong>${summary.errors}</strong></article>
+      <article class="card metric"><span>Timeouts</span><strong>${summary.timeouts}</strong></article>
+    </section>
+    <section>
+      <h2>LLM provider health</h2>
+      ${renderProviderCards("LLM", input.llmProviderHealth)}
+    </section>
+    <section>
+      <h2>STT provider health</h2>
+      ${renderSimulationControls("stt", input.sttSimulation)}
+      ${renderProviderCards("STT", input.sttProviderHealth)}
+    </section>
+    <section>
+      <h2>TTS provider health</h2>
+      ${renderSimulationControls("tts", input.ttsSimulation)}
+      ${renderProviderCards("TTS", input.ttsProviderHealth)}
+    </section>
+    <section>
+      <h2>Routing timeline</h2>
+      ${renderTimeline2(input.routingEvents)}
+    </section>
+  </main>
+  <script>
+    const showResult = (panel, result) => {
+      const output = panel.querySelector(".simulate-output");
+      if (!output) return;
+      output.hidden = false;
+      output.textContent = JSON.stringify(result, null, 2);
+    };
+    document.querySelectorAll("[data-sim-prefix]").forEach((panel) => {
+      const prefix = panel.getAttribute("data-sim-prefix");
+      panel.querySelectorAll("[data-provider-fail]").forEach((button) => {
+        button.addEventListener("click", async () => {
+          const provider = button.getAttribute("data-provider-fail");
+          const response = await fetch(prefix + "/failure?provider=" + encodeURIComponent(provider || ""), { method: "POST" });
+          showResult(panel, await response.json());
+          if (response.ok) window.setTimeout(() => window.location.reload(), 450);
+        });
+      });
+      panel.querySelectorAll("[data-provider-recover]").forEach((button) => {
+        button.addEventListener("click", async () => {
+          const provider = button.getAttribute("data-provider-recover");
+          const response = await fetch(prefix + "/recovery?provider=" + encodeURIComponent(provider || ""), { method: "POST" });
+          showResult(panel, await response.json());
+          if (response.ok) window.setTimeout(() => window.location.reload(), 450);
+        });
+      });
+    });
+  </script>
+</body>
+</html>`;
+};
+var providerFromQuery = (value, providers) => typeof value === "string" && providers.some((provider) => provider.provider === value && provider.configured !== false) ? value : undefined;
+var registerSimulationRoutes = (routes, simulation, defaultPathPrefix) => {
+  if (!simulation) {
+    return routes;
+  }
+  const pathPrefix = simulation.pathPrefix ?? defaultPathPrefix;
+  routes.post(`${pathPrefix}/failure`, async ({ query, set }) => {
+    const provider = providerFromQuery(query.provider, simulation.providers);
+    if (!provider) {
+      set.status = 400;
+      return {
+        error: "Provider is not configured for simulation."
+      };
+    }
+    if (simulation.failureProviders && !simulation.failureProviders.includes(provider)) {
+      set.status = 400;
+      return {
+        error: `${provider} is not configured for failure simulation.`
+      };
+    }
+    if (simulation.fallbackRequiredProvider && !simulation.providers.some((entry) => entry.provider === simulation.fallbackRequiredProvider && entry.configured !== false)) {
+      set.status = 400;
+      return {
+        error: simulation.fallbackRequiredMessage ?? `Configure ${simulation.fallbackRequiredProvider} before simulating fallback.`
+      };
+    }
+    return simulation.run(provider, "failure");
+  });
+  routes.post(`${pathPrefix}/recovery`, async ({ query, set }) => {
+    const provider = providerFromQuery(query.provider, simulation.providers);
+    if (!provider) {
+      set.status = 400;
+      return {
+        error: "Provider is not configured for simulation."
+      };
+    }
+    return simulation.run(provider, "recovery");
+  });
+  return routes;
+};
+var createVoiceResilienceRoutes = (options) => {
+  const path = options.path ?? "/resilience";
+  const routes = new Elysia6({
+    name: options.name ?? "absolutejs-voice-resilience"
+  }).get(path, async () => {
+    const events = await options.store.list();
+    const sttEvents = events.filter((event) => event.payload.kind === "stt");
+    const ttsEvents = events.filter((event) => event.payload.kind === "tts");
+    const data = {
+      links: options.links,
+      llmProviderHealth: await summarizeVoiceProviderHealth({
+        events,
+        providers: options.llmProviders ?? []
+      }),
+      routingEvents: listVoiceRoutingEvents(events),
+      sttProviderHealth: await summarizeVoiceProviderHealth({
+        events: sttEvents,
+        providers: options.sttProviders ?? []
+      }),
+      sttSimulation: options.sttSimulation,
+      title: options.title,
+      ttsProviderHealth: await summarizeVoiceProviderHealth({
+        events: ttsEvents,
+        providers: options.ttsProviders ?? []
+      }),
+      ttsSimulation: options.ttsSimulation
+    };
+    const body = await (options.render ?? renderVoiceResilienceHTML)(data);
+    return new Response(body, {
+      headers: {
+        "Content-Type": "text/html; charset=utf-8",
+        ...options.headers
+      }
+    });
+  });
+  registerSimulationRoutes(routes, options.sttSimulation, "/api/stt-simulate");
+  registerSimulationRoutes(routes, options.ttsSimulation, "/api/tts-simulate");
+  return routes;
+};
 // src/providerAdapters.ts
 class VoiceIOProviderTimeoutError extends Error {
   provider;
@@ -9702,7 +10150,7 @@ var createVoiceMemoryStore = () => {
   return { get, getOrCreate, list, remove, set };
 };
 // src/opsWebhook.ts
-import { Elysia as Elysia5 } 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;
@@ -9832,7 +10280,7 @@ var verifyVoiceOpsWebhookSignature = async (input) => {
 };
 var createVoiceOpsWebhookReceiverRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice-ops/webhook";
-  return new Elysia5().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({
@@ -9865,9 +10313,9 @@ var createVoiceOpsWebhookReceiverRoutes = (options = {}) => {
   });
 };
 // src/handoffHealth.ts
-import { Elysia as Elysia6 } from "elysia";
-var escapeHtml7 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var getString4 = (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;
@@ -9875,11 +10323,11 @@ var increment3 = (record, key) => {
 var normalizeDelivery = (adapterId, value) => {
   const record = value && typeof value === "object" ? value : {};
   return {
-    adapterId: getString4(record.adapterId) ?? adapterId,
-    adapterKind: getString4(record.adapterKind),
+    adapterId: getString6(record.adapterId) ?? adapterId,
+    adapterKind: getString6(record.adapterKind),
     deliveredAt: typeof record.deliveredAt === "number" ? record.deliveredAt : undefined,
-    deliveredTo: getString4(record.deliveredTo),
-    error: getString4(record.error),
+    deliveredTo: getString6(record.deliveredTo),
+    error: getString6(record.error),
     status: isStatus(record.status) ? record.status : "failed"
   };
 };
@@ -9913,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: getString4(event.payload.action),
+      action: getString6(event.payload.action),
       at: event.at,
       deliveries,
-      reason: getString4(event.payload.reason),
+      reason: getString6(event.payload.reason),
       sessionId: event.sessionId,
       status,
-      target: getString4(event.payload.target)
+      target: getString6(event.payload.target)
     };
     return {
       ...item,
@@ -9984,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>${escapeHtml7(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>${escapeHtml7(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("");
@@ -10001,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="${escapeHtml7(event.status)}">`,
+      `<article class="${escapeHtml9(event.status)}">`,
       '<div class="voice-handoff-health-event-header">',
-      `<strong>${escapeHtml7(event.action ?? "handoff")}</strong>`,
-      `<span>${escapeHtml7(event.status)}</span>`,
+      `<strong>${escapeHtml9(event.action ?? "handoff")}</strong>`,
+      `<span>${escapeHtml9(event.status)}</span>`,
       "</div>",
-      `<p><small>${escapeHtml7(event.sessionId)}</small></p>`,
-      event.target ? `<p>Target: ${escapeHtml7(event.target)}</p>` : "",
-      event.reason ? `<p>Reason: ${escapeHtml7(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>",
-        `${escapeHtml7(delivery.adapterId)}: ${escapeHtml7(delivery.status)}`,
-        delivery.deliveredTo ? ` to ${escapeHtml7(delivery.deliveredTo)}` : "",
-        delivery.error ? ` (${escapeHtml7(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="${escapeHtml7(event.replayHref)}">Open replay</a></p>` : "",
+      event.replayHref ? `<p><a href="${escapeHtml9(event.replayHref)}">Open replay</a></p>` : "",
       "</article>"
     ].join("")),
     "</div>"
@@ -10048,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 Elysia6({
+  const routes = new Elysia8({
     name: options.name ?? "absolutejs-voice-handoff-health"
   }).get(path, createVoiceHandoffHealthJSONHandler(options));
   if (htmlPath) {
@@ -12194,6 +12642,7 @@ export {
   resolveVoiceOpsTaskAssignment,
   resolveVoiceOpsTaskAgeBucket,
   resolveVoiceOpsPreset,
+  resolveVoiceDiagnosticsTraceFilter,
   resolveVoiceAssistantMemoryNamespace,
   resolveTurnDetectionConfig,
   resolveAudioConditioningConfig,
@@ -12202,6 +12651,7 @@ export {
   renderVoiceTraceMarkdown,
   renderVoiceTraceHTML,
   renderVoiceSessionsHTML,
+  renderVoiceResilienceHTML,
   renderVoiceProviderHealthHTML,
   renderVoiceHandoffHealthHTML,
   renderVoiceCallReviewMarkdown,
@@ -12214,6 +12664,7 @@ export {
   pruneVoiceTraceEvents,
   matchesVoiceOpsTaskAssignmentRule,
   markVoiceOpsTaskSLABreached,
+  listVoiceRoutingEvents,
   listVoiceOpsTasks,
   isVoiceOpsTaskOverdue,
   heartbeatVoiceOpsTask,
@@ -12269,6 +12720,7 @@ export {
   createVoiceSQLiteExternalObjectMapStore,
   createVoiceS3ReviewStore,
   createVoiceReviewSavedEvent,
+  createVoiceResilienceRoutes,
   createVoiceRedisTaskLeaseCoordinator,
   createVoiceRedisIdempotencyStore,
   createVoiceProviderRouter,
@@ -12324,6 +12776,7 @@ export {
   createVoiceExternalObjectMapId,
   createVoiceExternalObjectMap,
   createVoiceExperiment,
+  createVoiceDiagnosticsRoutes,
   createVoiceCallReviewRecorder,
   createVoiceCallReviewFromSession,
   createVoiceCallReviewFromLiveTelephonyReport,
@@ -12359,6 +12812,7 @@ export {
   buildVoiceTraceReplay,
   buildVoiceOpsTaskFromSLABreach,
   buildVoiceOpsTaskFromReview,
+  buildVoiceDiagnosticsMarkdown,
   assignVoiceOpsTask,
   applyVoiceOpsTaskPolicy,
   applyVoiceOpsTaskAssignmentRule,

package/dist/resilienceRoutes.d.ts

@@ -0,0 +1,106 @@
+import { Elysia } from 'elysia';
+import { type VoiceProviderHealthSummary } from './providerHealth';
+import type { StoredVoiceTraceEvent, VoiceTraceEventStore } from './trace';
+import type { VoiceIOProviderFailureSimulationMode, VoiceIOProviderFailureSimulationResult } from './testing/ioProviderSimulator';
+export type VoiceRoutingEventKind = 'llm' | 'stt' | 'tts';
+export type VoiceRoutingEvent = {
+    at: number;
+    attempt?: number;
+    elapsedMs?: number;
+    error?: string;
+    fallbackProvider?: string;
+    kind: VoiceRoutingEventKind;
+    latencyBudgetMs?: number;
+    operation?: string;
+    provider?: string;
+    selectedProvider?: string;
+    sessionId: string;
+    status?: string;
+    timedOut: boolean;
+    turnId?: string;
+};
+export type VoiceResilienceLink = {
+    href: string;
+    label: string;
+};
+export type VoiceResilienceSimulationProvider<TProvider extends string = string> = {
+    configured?: boolean;
+    provider: TProvider;
+};
+export type VoiceResilienceIOSimulator<TProvider extends string = string> = {
+    failureProviders?: readonly TProvider[];
+    fallbackRequiredProvider?: TProvider;
+    fallbackRequiredMessage?: string;
+    failureMessage?: string;
+    label?: string;
+    pathPrefix?: string;
+    providers: readonly VoiceResilienceSimulationProvider<TProvider>[];
+    recoveryMessage?: string;
+    run: (provider: TProvider, mode: VoiceIOProviderFailureSimulationMode) => Promise<VoiceIOProviderFailureSimulationResult<TProvider>>;
+};
+export type VoiceResiliencePageData = {
+    links?: readonly VoiceResilienceLink[];
+    llmProviderHealth: VoiceProviderHealthSummary<string>[];
+    routingEvents: VoiceRoutingEvent[];
+    sttProviderHealth: VoiceProviderHealthSummary<string>[];
+    sttSimulation?: VoiceResilienceIOSimulator<string>;
+    title?: string;
+    ttsProviderHealth: VoiceProviderHealthSummary<string>[];
+    ttsSimulation?: VoiceResilienceIOSimulator<string>;
+};
+export type VoiceResilienceRoutesOptions = {
+    headers?: HeadersInit;
+    links?: readonly VoiceResilienceLink[];
+    llmProviders?: readonly string[];
+    name?: string;
+    path?: string;
+    render?: (input: VoiceResiliencePageData) => string | Promise<string>;
+    sttProviders?: readonly string[];
+    sttSimulation?: VoiceResilienceIOSimulator<string>;
+    store: VoiceTraceEventStore;
+    title?: string;
+    ttsProviders?: readonly string[];
+    ttsSimulation?: VoiceResilienceIOSimulator<string>;
+};
+export declare const listVoiceRoutingEvents: (events: StoredVoiceTraceEvent[]) => VoiceRoutingEvent[];
+export declare const renderVoiceResilienceHTML: (input: VoiceResiliencePageData) => string;
+export declare const createVoiceResilienceRoutes: (options: VoiceResilienceRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    [x: string]: {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: 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.36",
+	"version": "0.0.22-beta.38",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",