@absolutejs/voice 0.0.22-beta.297 → 0.0.22-beta.299

package/README.md

@@ -2807,7 +2807,7 @@ app.use(
 );
 ```
 
-`createVoiceOperationsRecordRoutes(...)` links the call/session timeline, transcript, replay, provider decisions, tools, handoffs, guardrail decisions, audit, reviews, ops tasks, integration events, and sink delivery attempts into one debuggable object. Provider decisions include both older provider-routing events and explicit `provider.decision` traces, so the call log can show the surface, selected provider, fallback provider, and human-readable reason for each runtime choice. Use `/voice-operations/:sessionId` as the first place to investigate failed calls, blocked assistant output, blocked tool payloads, provider failures, handoff failures, slow turns, and campaign attempts. The same mount also exposes incident handoff Markdown at `/voice-operations/:sessionId/incident.md` and `/api/voice-operations/:sessionId/incident.md` for support tooling, including provider-decision summaries and an `assistant.guardrail` blocked-stage summary when those trace events exist.
+`createVoiceOperationsRecordRoutes(...)` links the call/session timeline, transcript, replay, provider decisions, tools, handoffs, guardrail decisions, audit, reviews, ops tasks, integration events, and sink delivery attempts into one debuggable object. Provider decisions include both older provider-routing events and explicit `provider.decision` traces, so the call log can show the surface, selected provider, fallback provider, recovery status, fallback/degradation counts, and human-readable reason for each runtime choice. Use `/voice-operations/:sessionId` as the first place to investigate failed calls, blocked assistant output, blocked tool payloads, provider failures, handoff failures, slow turns, and campaign attempts. The same mount also exposes incident handoff Markdown at `/voice-operations/:sessionId/incident.md` and `/api/voice-operations/:sessionId/incident.md` for support tooling, including provider-decision recovery summaries and an `assistant.guardrail` blocked-stage summary when those trace events exist.
 
 Use `evaluateVoiceOperationsRecordGuardrails(...)` when a proof pack or deploy gate needs JSON evidence that guardrails actually ran, blocked the expected stages, and produced named proofs/rule IDs. Use `assertVoiceOperationsRecordGuardrails(...)` in tests or smoke scripts when missing guardrail evidence should fail fast:
 
@@ -4116,7 +4116,7 @@ app.use(
 );
 ```
 
-The routes expose JSON at `/api/voice/provider-decisions`, HTML at `/voice/provider-decisions`, and Markdown at `/voice/provider-decisions.md`. Use this next to provider SLOs when a customer asks not just "is fallback working?" but "why did the system choose this provider for this call?".
+The routes expose JSON at `/api/voice/provider-decisions`, HTML at `/voice/provider-decisions`, and Markdown at `/voice/provider-decisions.md`. Use this next to provider SLOs when a customer asks not just "is fallback working?" but "why did the system choose this provider for this call?". For proof packs, gate fallback and degradation directly with `minFallbacks`, `minDegraded`, `requiredStatuses`, `requiredFallbackProviders`, and `requiredReasonIncludes` so deploy evidence fails when fallback behavior is missing or unexplained.
 
 Use `createVoiceProviderContractMatrixPreset(...)` when you want readiness proof for the whole provider stack without hand-writing every LLM, STT, and TTS contract row. The preset stays primitive: you still own provider lists, selected providers, latency budgets, env, capabilities, and route mounting.
 

package/dist/index.js

@@ -13146,7 +13146,7 @@ var uniqueSorted = (values) => [
 ].sort();
 var createVoiceProviderDecisionTraceEvent = (input) => {
   const surface = input.surface ?? surfaceForKind(input.kind);
-  const reason = input.reason ?? (input.status === "fallback" ? `Fallback from ${input.provider} to ${input.fallbackProvider ?? input.selectedProvider ?? "next provider"}.` : input.status === "error" ? `Provider ${input.provider} errored before recovery.` : input.status === "skipped" ? `Provider ${input.provider} was skipped by policy.` : `Provider ${input.selectedProvider ?? input.provider} selected by policy.`);
+  const reason = input.reason ?? (input.status === "degraded" ? `Provider ${input.provider} degraded to ${input.fallbackProvider ?? input.selectedProvider ?? "lower-fidelity fallback"}.` : input.status === "fallback" ? `Fallback from ${input.provider} to ${input.fallbackProvider ?? input.selectedProvider ?? "next provider"}.` : input.status === "error" ? `Provider ${input.provider} errored before recovery.` : input.status === "skipped" ? `Provider ${input.provider} was skipped by policy.` : `Provider ${input.selectedProvider ?? input.provider} selected by policy.`);
   return {
     at: input.at ?? Date.now(),
     payload: {
@@ -13170,7 +13170,7 @@ var listVoiceProviderDecisionTraces = (events) => {
     const provider = getString8(event.payload.provider);
     const status = getString8(event.payload.status);
     const surface = getString8(event.payload.surface);
-    if (!provider || !surface || status !== "error" && status !== "fallback" && status !== "selected" && status !== "skipped" && status !== "success") {
+    if (!provider || !surface || status !== "error" && status !== "fallback" && status !== "degraded" && status !== "selected" && status !== "skipped" && status !== "success") {
       return;
     }
     return {
@@ -13237,6 +13237,18 @@ var buildVoiceProviderDecisionTraceReport = async (options) => {
       });
     }
   }
+  const fallbackCount = decisions.filter((decision) => decision.status === "fallback").length;
+  const degradedCount = decisions.filter((decision) => decision.status === "degraded").length;
+  const statuses = new Set(decisions.map((decision) => decision.status));
+  const providers = uniqueSorted(decisions.flatMap((decision) => [
+    decision.provider,
+    decision.selectedProvider,
+    decision.fallbackProvider
+  ]));
+  const fallbackProviders = uniqueSorted(decisions.flatMap((decision) => [
+    decision.fallbackProvider,
+    decision.status === "fallback" || decision.status === "degraded" ? decision.selectedProvider : undefined
+  ]));
   if (options.minDecisions !== undefined && decisions.length < options.minDecisions) {
     issues.push({
       code: "voice.provider_decision_trace.min_decisions",
@@ -13244,9 +13256,60 @@ var buildVoiceProviderDecisionTraceReport = async (options) => {
       status: "fail"
     });
   }
+  if (options.minFallbacks !== undefined && fallbackCount < options.minFallbacks) {
+    issues.push({
+      code: "voice.provider_decision_trace.min_fallbacks",
+      message: `Found ${String(fallbackCount)} provider fallback trace(s); expected at least ${String(options.minFallbacks)}.`,
+      status: "fail"
+    });
+  }
+  if (options.minDegraded !== undefined && degradedCount < options.minDegraded) {
+    issues.push({
+      code: "voice.provider_decision_trace.min_degraded",
+      message: `Found ${String(degradedCount)} provider degradation trace(s); expected at least ${String(options.minDegraded)}.`,
+      status: "fail"
+    });
+  }
+  for (const status of options.requiredStatuses ?? []) {
+    if (!statuses.has(status)) {
+      issues.push({
+        code: "voice.provider_decision_trace.status_missing",
+        message: `Missing provider decision status: ${status}.`,
+        status: "fail"
+      });
+    }
+  }
+  for (const provider of options.requiredProviders ?? []) {
+    if (!providers.includes(provider)) {
+      issues.push({
+        code: "voice.provider_decision_trace.provider_missing",
+        message: `Missing provider decision provider: ${provider}.`,
+        status: "fail"
+      });
+    }
+  }
+  for (const provider of options.requiredFallbackProviders ?? []) {
+    if (!fallbackProviders.includes(provider)) {
+      issues.push({
+        code: "voice.provider_decision_trace.fallback_provider_missing",
+        message: `Missing provider decision fallback provider: ${provider}.`,
+        status: "fail"
+      });
+    }
+  }
+  for (const phrase of options.requiredReasonIncludes ?? []) {
+    if (!decisions.some((decision) => decision.reason.includes(phrase))) {
+      issues.push({
+        code: "voice.provider_decision_trace.reason_missing",
+        message: `Missing provider decision reason containing: ${phrase}.`,
+        status: "fail"
+      });
+    }
+  }
   const surfaceReports = [...surfaces.entries()].sort(([left], [right]) => left.localeCompare(right)).map(([surface, surfaceDecisions]) => {
     const surfaceIssues = issues.filter((issue) => issue.surface === surface);
     return {
+      degraded: surfaceDecisions.filter((decision) => decision.status === "degraded").length,
       decisions: surfaceDecisions.length,
       errors: surfaceDecisions.filter((decision) => decision.status === "error").length,
       fallbacks: surfaceDecisions.filter((decision) => decision.status === "fallback").length,
@@ -13263,20 +13326,16 @@ var buildVoiceProviderDecisionTraceReport = async (options) => {
       surface
     };
   });
-  const providers = uniqueSorted(decisions.flatMap((decision) => [
-    decision.provider,
-    decision.selectedProvider,
-    decision.fallbackProvider
-  ]));
   return {
     checkedAt: now,
     decisions,
     issues,
     status: reportStatus(issues),
     summary: {
+      degraded: degradedCount,
       decisions: decisions.length,
       errors: decisions.filter((decision) => decision.status === "error").length,
-      fallbacks: decisions.filter((decision) => decision.status === "fallback").length,
+      fallbacks: fallbackCount,
       providers: providers.length,
       selected: decisions.filter((decision) => decision.status === "selected" || decision.status === "success").length,
       surfaces: surfaces.size
@@ -13291,11 +13350,12 @@ var renderVoiceProviderDecisionTraceMarkdown = (report) => [
   `Decisions: ${String(report.summary.decisions)}`,
   `Providers: ${String(report.summary.providers)}`,
   `Fallbacks: ${String(report.summary.fallbacks)}`,
+  `Degraded: ${String(report.summary.degraded)}`,
   `Errors: ${String(report.summary.errors)}`,
   "",
-  "| Surface | Status | Decisions | Selected | Fallbacks | Errors | Providers |",
-  "| --- | --- | ---: | ---: | ---: | ---: | --- |",
-  ...report.surfaces.map((surface) => `| ${surface.surface} | ${surface.status} | ${String(surface.decisions)} | ${String(surface.selected)} | ${String(surface.fallbacks)} | ${String(surface.errors)} | ${surface.providers.join(", ")} |`),
+  "| Surface | Status | Decisions | Selected | Fallbacks | Degraded | Errors | Providers |",
+  "| --- | --- | ---: | ---: | ---: | ---: | ---: | --- |",
+  ...report.surfaces.map((surface) => `| ${surface.surface} | ${surface.status} | ${String(surface.decisions)} | ${String(surface.selected)} | ${String(surface.fallbacks)} | ${String(surface.degraded)} | ${String(surface.errors)} | ${surface.providers.join(", ")} |`),
   "",
   ...report.issues.map((issue) => `- ${issue.status}: ${issue.message}`)
 ].join(`
@@ -13326,12 +13386,13 @@ code{background:#e2e8f0;border-radius:8px;padding:2px 6px}
 <article class="card"><strong>${String(report.summary.decisions)}</strong><p>decisions</p></article>
 <article class="card"><strong>${String(report.summary.providers)}</strong><p>providers</p></article>
 <article class="card"><strong>${String(report.summary.fallbacks)}</strong><p>fallbacks</p></article>
+<article class="card"><strong>${String(report.summary.degraded)}</strong><p>degraded</p></article>
 <article class="card"><strong>${String(report.summary.errors)}</strong><p>errors</p></article>
 </section>
 <section class="surfaces">
 ${report.surfaces.map((surface) => `<article class="surface">
 <header><strong>${escapeHtml17(surface.surface)}</strong> <span class="status ${surface.status}">${escapeHtml17(surface.status)}</span></header>
-<p>${String(surface.decisions)} decision(s), ${String(surface.fallbacks)} fallback(s), ${String(surface.errors)} error(s).</p>
+<p>${String(surface.decisions)} decision(s), ${String(surface.fallbacks)} fallback(s), ${String(surface.degraded)} degraded decision(s), ${String(surface.errors)} error(s).</p>
 <p class="muted">Providers: ${escapeHtml17(surface.providers.join(", ") || "none")}</p>
 <p>${surface.reasons.map((reason) => `<code>${escapeHtml17(reason)}</code>`).join(" ")}</p>
 </article>`).join(`
@@ -26263,6 +26324,29 @@ var toProviderDecision = (event) => {
     turnId: event.turnId
   };
 };
+var summarizeProviderDecisions = (decisions) => {
+  const providers = uniqueSorted8(decisions.flatMap((decision) => [
+    decision.provider,
+    decision.selectedProvider,
+    decision.fallbackProvider
+  ]));
+  const surfaces = uniqueSorted8(decisions.map((decision) => decision.surface));
+  const degraded = decisions.filter((decision) => decision.status === "degraded").length;
+  const errors = decisions.filter((decision) => decision.status === "error").length;
+  const fallbacks = decisions.filter((decision) => decision.status === "fallback").length;
+  const selected = decisions.filter((decision) => decision.status === "selected" || decision.status === "success").length;
+  const recoveryStatus = errors > 0 ? "failed" : degraded > 0 ? "degraded" : fallbacks > 0 ? "recovered" : selected > 0 ? "selected" : "none";
+  return {
+    degraded,
+    errors,
+    fallbacks,
+    providers,
+    recoveryStatus,
+    selected,
+    surfaces,
+    total: decisions.length
+  };
+};
 var buildTranscript = (replay) => replay.turns.map((turn) => ({
   assistantReplies: turn.assistantReplies,
   committedText: turn.committedText,
@@ -26305,6 +26389,7 @@ var buildVoiceOperationsRecord = async (options) => {
   const taskIds = new Set(tasks?.map((task) => task.id) ?? []);
   const integrationEvents = options.integrationEvents ? (await options.integrationEvents.list()).filter((event) => hasPayloadValue(event.payload, "sessionId", new Set([options.sessionId])) || hasPayloadValue(event.payload, "reviewId", reviewIds) || hasPayloadValue(event.payload, "taskId", taskIds)) : undefined;
   const sinkDeliveries = integrationEvents?.reduce((total, event) => total + Object.keys(event.sinkDeliveries ?? {}).length, 0) ?? 0;
+  const providerDecisions = traceEvents.map(toProviderDecision).filter((decision) => decision !== undefined);
   return {
     audit: auditEvents ? {
       error: countOutcome(auditEvents, "error"),
@@ -26326,7 +26411,8 @@ var buildVoiceOperationsRecord = async (options) => {
       total: integrationEvents.length
     } : undefined,
     outcome: resolveOutcome4(traceEvents),
-    providerDecisions: traceEvents.map(toProviderDecision).filter((decision) => decision !== undefined),
+    providerDecisions,
+    providerDecisionSummary: summarizeProviderDecisions(providerDecisions),
     providers: timelineSession?.providers ?? [],
     replay,
     reviews: reviews ? {
@@ -26448,6 +26534,14 @@ var renderVoiceOperationsRecordIncidentMarkdown = (record) => {
     ].filter((part) => typeof part === "string");
     return `- ${provider}: ${parts.join("; ") || "decision recorded"}`;
   }) : ["- none recorded"];
+  const providerDecisionSummary = record.providerDecisionSummary;
+  const providerRecoveryLine = [
+    `status=${providerDecisionSummary.recoveryStatus}`,
+    `selected=${String(providerDecisionSummary.selected)}`,
+    `fallbacks=${String(providerDecisionSummary.fallbacks)}`,
+    `degraded=${String(providerDecisionSummary.degraded)}`,
+    `errors=${String(providerDecisionSummary.errors)}`
+  ].join("; ");
   return [
     `# Voice incident handoff: ${record.sessionId}`,
     "",
@@ -26460,6 +26554,7 @@ var renderVoiceOperationsRecordIncidentMarkdown = (record) => {
     `- Open tasks: ${openTasks.join("; ") || "none"}`,
     `- Top errors: ${topErrors.join("; ") || "none"}`,
     `- Guardrails: ${String(record.guardrails.blocked)} blocked / ${String(record.guardrails.warned)} warned / ${String(record.guardrails.total)} decisions`,
+    `- Provider recovery: ${providerRecoveryLine}`,
     "",
     "## Provider decisions",
     "",
@@ -26497,6 +26592,7 @@ var renderVoiceOperationsRecordHTML = (record, options = {}) => {
   const providers = record.providers.length ? record.providers.map((provider) => `<article><strong>${escapeHtml42(provider.provider)}</strong><span>${String(provider.eventCount)} events</span><span>${formatMs5(provider.averageElapsedMs)} avg</span><span>${String(provider.errorCount)} errors</span></article>`).join("") : '<p class="muted">No provider events recorded.</p>';
   const transcript = record.transcript.length ? record.transcript.map((turn) => `<li><strong>${escapeHtml42(turn.id)}</strong>${turn.committedText ? `<p><span class="label">Caller</span>${escapeHtml42(turn.committedText)}</p>` : ""}${turn.assistantReplies.map((reply) => `<p><span class="label">Assistant</span>${escapeHtml42(reply)}</p>`).join("")}${turn.errors.map((error) => `<p class="error"><span class="label">Error</span>${escapeHtml42(error)}</p>`).join("")}</li>`).join("") : "<li>No transcript turns recorded.</li>";
   const providerDecisions = record.providerDecisions.length ? record.providerDecisions.map((decision) => `<li><strong>${escapeHtml42(decision.provider ?? decision.selectedProvider ?? decision.fallbackProvider ?? "provider")}</strong> <span>${escapeHtml42(decision.status ?? decision.type)}</span> ${formatMs5(decision.elapsedMs)}${decision.surface ? `<p><span class="label">Surface</span>${escapeHtml42(decision.surface)}</p>` : ""}${decision.kind ? `<p><span class="label">Kind</span>${escapeHtml42(decision.kind)}</p>` : ""}${decision.selectedProvider ? `<p>Selected: ${escapeHtml42(decision.selectedProvider)}</p>` : ""}${decision.fallbackProvider ? `<p>Fallback: ${escapeHtml42(decision.fallbackProvider)}</p>` : ""}${decision.error ? `<p class="error">${escapeHtml42(decision.error)}</p>` : ""}${decision.reason ? `<p>${escapeHtml42(decision.reason)}</p>` : ""}</li>`).join("") : "<li>No provider decisions recorded.</li>";
+  const providerDecisionSummary = record.providerDecisionSummary;
   const handoffs = record.handoffs.length ? record.handoffs.map((handoff) => `<li><strong>${escapeHtml42(handoff.fromAgentId ?? "unknown")}</strong> to <strong>${escapeHtml42(handoff.targetAgentId ?? "unknown")}</strong> <span>${escapeHtml42(handoff.status ?? "")}</span><p>${escapeHtml42(handoff.summary ?? handoff.reason ?? "")}</p></li>`).join("") : "<li>No agent handoffs recorded.</li>";
   const tools = record.tools.length ? record.tools.map((tool) => `<li><strong>${escapeHtml42(tool.toolName ?? "tool")}</strong> <span>${escapeHtml42(tool.status ?? "")}</span> ${formatMs5(tool.elapsedMs)} ${tool.error ? `<p>${escapeHtml42(tool.error)}</p>` : ""}</li>`).join("") : "<li>No tool calls recorded.</li>";
   const reviews = record.reviews?.reviews.length ? record.reviews.reviews.map((review) => `<li><strong>${escapeHtml42(review.title)}</strong> <span>${escapeHtml42(review.summary.outcome ?? "")}</span><p>${escapeHtml42(review.postCall?.summary ?? review.transcript.actual)}</p></li>`).join("") : "<li>No call reviews recorded.</li>";
@@ -26522,7 +26618,7 @@ var renderVoiceOperationsRecordHTML = (record, options = {}) => {
 );`);
   const incidentMarkdown = escapeHtml42(renderVoiceOperationsRecordIncidentMarkdown(record));
   const incidentLink = options.incidentHref ? `<a href="${escapeHtml42(options.incidentHref)}">Download incident.md</a>` : "";
-  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml42(options.title ?? "Voice Operations Record")}</title><style>body{background:#101417;color:#f9f4e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.eyebrow{color:#fbbf24;font-size:.8rem;font-weight:900;letter-spacing:.14em;text-transform:uppercase}h1{font-size:clamp(2.4rem,6vw,4.8rem);line-height:.9;margin:.2rem 0 1rem}.status{border:1px solid #475569;border-radius:999px;display:inline-flex;padding:8px 12px}.healthy{color:#86efac}.warning{color:#fbbf24}.failed,.error{color:#fca5a5}.grid{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));margin:20px 0}.card,.primitive{background:#182025;border:1px solid #2d3a43;border-radius:20px;padding:16px}.card span,.muted,.label{color:#a9b4bd}.label{display:block;font-size:.72rem;font-weight:900;letter-spacing:.12em;text-transform:uppercase}.card strong{display:block;font-size:2rem}section{margin-top:28px}article{display:grid;gap:8px}ul{display:grid;gap:10px;list-style:none;padding:0}li{background:#182025;border:1px solid #2d3a43;border-radius:16px;padding:14px}pre{background:#080d10;border:1px solid #2d3a43;border-radius:16px;color:#dbeafe;overflow:auto;padding:14px}.hero-actions{display:flex;flex-wrap:wrap;gap:10px;margin-top:16px}.hero-actions a{background:#fbbf24;border-radius:999px;color:#111827;font-weight:900;padding:10px 14px;text-decoration:none}.two-column{display:grid;gap:18px;grid-template-columns:minmax(0,1.15fr) minmax(280px,.85fr)}@media(max-width:860px){main{padding:20px}.two-column{grid-template-columns:1fr}}</style></head><body><main><p class="eyebrow">Call log replacement</p><h1>${escapeHtml42(options.title ?? "Voice Operations Record")}</h1><p class="status ${escapeHtml42(record.status)}">${escapeHtml42(record.status)}</p><div class="hero-actions"><a href="#transcript">Transcript</a><a href="#provider-decisions">Provider decisions</a><a href="#guardrails">Guardrails</a><a href="#incident-handoff">Incident handoff</a>${incidentLink}</div><section class="grid"><div class="card"><span>Events</span><strong>${String(record.summary.eventCount)}</strong></div><div class="card"><span>Turns</span><strong>${String(record.summary.turnCount)}</strong></div><div class="card"><span>Errors</span><strong>${String(record.summary.errorCount)}</strong></div><div class="card"><span>Duration</span><strong>${formatMs5(record.summary.callDurationMs)}</strong></div><div class="card"><span>Guardrails</span><strong>${String(record.guardrails.blocked)}</strong></div><div class="card"><span>Audit</span><strong>${String(record.audit?.total ?? 0)}</strong></div><div class="card"><span>Reviews</span><strong>${String(record.reviews?.total ?? 0)}</strong></div><div class="card"><span>Tasks</span><strong>${String(record.tasks?.total ?? 0)}</strong></div><div class="card"><span>Integrations</span><strong>${String(record.integrationEvents?.total ?? 0)}</strong></div></section><section class="two-column"><div><h2 id="transcript">Transcript</h2><ul>${transcript}</ul></div><div><h2 id="provider-decisions">Provider Decisions</h2><ul>${providerDecisions}</ul></div></section><section id="guardrails"><h2>Guardrail Evidence</h2><p class="muted">Live <code>assistant.guardrail</code> decisions attached to this session.</p><ul>${guardrails}</ul></section><section id="incident-handoff"><h2>Copyable Incident Handoff</h2><p class="muted">Paste this into Slack, Linear, Zendesk, or an incident review. ${incidentLink}</p><pre><code>${incidentMarkdown}</code></pre></section><section class="primitive"><p class="eyebrow">Copy into your app</p><h2><code>createVoiceOperationsRecordRoutes(...)</code> gives every call one debuggable object</h2><p class="muted">Use this as the support/debug payload across traces, provider routing, tools, handoffs, guardrails, audit, latency, replay, reviews, tasks, and webhook delivery.</p><pre><code>${snippet}</code></pre></section><section><h2>Provider Summary</h2><div class="grid">${providers}</div></section><section><h2>Handoffs</h2><ul>${handoffs}</ul></section><section><h2>Tools</h2><ul>${tools}</ul></section><section><h2>Reviews</h2><ul>${reviews}</ul></section><section><h2>Tasks</h2><ul>${tasks}</ul></section><section><h2>Integration Events</h2><ul>${integrationEvents}</ul></section></main></body></html>`;
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml42(options.title ?? "Voice Operations Record")}</title><style>body{background:#101417;color:#f9f4e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.eyebrow{color:#fbbf24;font-size:.8rem;font-weight:900;letter-spacing:.14em;text-transform:uppercase}h1{font-size:clamp(2.4rem,6vw,4.8rem);line-height:.9;margin:.2rem 0 1rem}.status{border:1px solid #475569;border-radius:999px;display:inline-flex;padding:8px 12px}.healthy{color:#86efac}.warning{color:#fbbf24}.failed,.error{color:#fca5a5}.grid{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));margin:20px 0}.card,.primitive{background:#182025;border:1px solid #2d3a43;border-radius:20px;padding:16px}.card span,.muted,.label{color:#a9b4bd}.label{display:block;font-size:.72rem;font-weight:900;letter-spacing:.12em;text-transform:uppercase}.card strong{display:block;font-size:2rem}section{margin-top:28px}article{display:grid;gap:8px}ul{display:grid;gap:10px;list-style:none;padding:0}li{background:#182025;border:1px solid #2d3a43;border-radius:16px;padding:14px}pre{background:#080d10;border:1px solid #2d3a43;border-radius:16px;color:#dbeafe;overflow:auto;padding:14px}.hero-actions{display:flex;flex-wrap:wrap;gap:10px;margin-top:16px}.hero-actions a{background:#fbbf24;border-radius:999px;color:#111827;font-weight:900;padding:10px 14px;text-decoration:none}.two-column{display:grid;gap:18px;grid-template-columns:minmax(0,1.15fr) minmax(280px,.85fr)}@media(max-width:860px){main{padding:20px}.two-column{grid-template-columns:1fr}}</style></head><body><main><p class="eyebrow">Call log replacement</p><h1>${escapeHtml42(options.title ?? "Voice Operations Record")}</h1><p class="status ${escapeHtml42(record.status)}">${escapeHtml42(record.status)}</p><div class="hero-actions"><a href="#transcript">Transcript</a><a href="#provider-decisions">Provider decisions</a><a href="#guardrails">Guardrails</a><a href="#incident-handoff">Incident handoff</a>${incidentLink}</div><section class="grid"><div class="card"><span>Events</span><strong>${String(record.summary.eventCount)}</strong></div><div class="card"><span>Turns</span><strong>${String(record.summary.turnCount)}</strong></div><div class="card"><span>Errors</span><strong>${String(record.summary.errorCount)}</strong></div><div class="card"><span>Duration</span><strong>${formatMs5(record.summary.callDurationMs)}</strong></div><div class="card"><span>Provider recovery</span><strong>${escapeHtml42(providerDecisionSummary.recoveryStatus)}</strong><span>${String(providerDecisionSummary.fallbacks)} fallback / ${String(providerDecisionSummary.degraded)} degraded / ${String(providerDecisionSummary.errors)} errors</span></div><div class="card"><span>Guardrails</span><strong>${String(record.guardrails.blocked)}</strong></div><div class="card"><span>Audit</span><strong>${String(record.audit?.total ?? 0)}</strong></div><div class="card"><span>Reviews</span><strong>${String(record.reviews?.total ?? 0)}</strong></div><div class="card"><span>Tasks</span><strong>${String(record.tasks?.total ?? 0)}</strong></div><div class="card"><span>Integrations</span><strong>${String(record.integrationEvents?.total ?? 0)}</strong></div></section><section class="two-column"><div><h2 id="transcript">Transcript</h2><ul>${transcript}</ul></div><div><h2 id="provider-decisions">Provider Decisions</h2><ul>${providerDecisions}</ul></div></section><section id="guardrails"><h2>Guardrail Evidence</h2><p class="muted">Live <code>assistant.guardrail</code> decisions attached to this session.</p><ul>${guardrails}</ul></section><section id="incident-handoff"><h2>Copyable Incident Handoff</h2><p class="muted">Paste this into Slack, Linear, Zendesk, or an incident review. ${incidentLink}</p><pre><code>${incidentMarkdown}</code></pre></section><section class="primitive"><p class="eyebrow">Copy into your app</p><h2><code>createVoiceOperationsRecordRoutes(...)</code> gives every call one debuggable object</h2><p class="muted">Use this as the support/debug payload across traces, provider routing, tools, handoffs, guardrails, audit, latency, replay, reviews, tasks, and webhook delivery.</p><pre><code>${snippet}</code></pre></section><section><h2>Provider Summary</h2><div class="grid">${providers}</div></section><section><h2>Handoffs</h2><ul>${handoffs}</ul></section><section><h2>Tools</h2><ul>${tools}</ul></section><section><h2>Reviews</h2><ul>${reviews}</ul></section><section><h2>Tasks</h2><ul>${tasks}</ul></section><section><h2>Integration Events</h2><ul>${integrationEvents}</ul></section></main></body></html>`;
 };
 var createVoiceOperationsRecordRoutes = (options) => {
   const path = options.path ?? "/api/voice-operations/:sessionId";

package/dist/operationsRecord.d.ts

@@ -54,6 +54,17 @@ export type VoiceOperationsRecordProviderDecision = {
     type: StoredVoiceTraceEvent['type'];
     turnId?: string;
 };
+export type VoiceOperationsRecordProviderDecisionRecoveryStatus = 'degraded' | 'failed' | 'none' | 'recovered' | 'selected';
+export type VoiceOperationsRecordProviderDecisionSummary = {
+    degraded: number;
+    errors: number;
+    fallbacks: number;
+    providers: string[];
+    recoveryStatus: VoiceOperationsRecordProviderDecisionRecoveryStatus;
+    selected: number;
+    surfaces: string[];
+    total: number;
+};
 export type VoiceOperationsRecordAuditSummary = {
     error: number;
     events: StoredVoiceAuditEvent[];
@@ -139,6 +150,7 @@ export type VoiceOperationsRecord = {
     integrationEvents?: VoiceOperationsRecordIntegrationEventSummary;
     outcome: VoiceOperationsRecordOutcome;
     providerDecisions: VoiceOperationsRecordProviderDecision[];
+    providerDecisionSummary: VoiceOperationsRecordProviderDecisionSummary;
     providers: VoiceTraceTimelineProviderSummary[];
     replay: VoiceSessionReplay;
     reviews?: VoiceOperationsRecordReviewSummary;

package/dist/providerDecisionTraces.d.ts

@@ -1,7 +1,7 @@
 import { Elysia } from 'elysia';
 import { type VoiceRoutingEventKind } from './resilienceRoutes';
 import type { StoredVoiceTraceEvent, VoiceTraceEvent, VoiceTraceEventStore } from './trace';
-export type VoiceProviderDecisionStatus = 'error' | 'fallback' | 'selected' | 'skipped' | 'success';
+export type VoiceProviderDecisionStatus = 'degraded' | 'error' | 'fallback' | 'selected' | 'skipped' | 'success';
 export type VoiceProviderDecisionTrace = {
     at: number;
     elapsedMs?: number;
@@ -31,6 +31,7 @@ export type VoiceProviderDecisionTraceIssue = {
     surface?: string;
 };
 export type VoiceProviderDecisionSurfaceReport = {
+    degraded: number;
     decisions: number;
     errors: number;
     fallbacks: number;
@@ -48,6 +49,7 @@ export type VoiceProviderDecisionTraceReport = {
     issues: VoiceProviderDecisionTraceIssue[];
     status: 'fail' | 'pass' | 'warn';
     summary: {
+        degraded: number;
         decisions: number;
         errors: number;
         fallbacks: number;
@@ -60,9 +62,15 @@ export type VoiceProviderDecisionTraceReport = {
 export type VoiceProviderDecisionTraceReportOptions = {
     events?: StoredVoiceTraceEvent[] | VoiceProviderDecisionTrace[];
     maxAgeMs?: number;
+    minDegraded?: number;
     minDecisions?: number;
+    minFallbacks?: number;
     now?: number;
+    requiredFallbackProviders?: readonly string[];
+    requiredProviders?: readonly string[];
+    requiredReasonIncludes?: readonly string[];
     requiredSurfaces?: readonly string[];
+    requiredStatuses?: readonly VoiceProviderDecisionStatus[];
     sessionId?: string;
     store?: VoiceTraceEventStore;
 };

package/package.json

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