@absolutejs/voice 0.0.22-beta.135 → 0.0.22-beta.137

package/dist/index.d.ts

@@ -18,7 +18,7 @@ export type { VoiceDemoReadyReport, VoiceDemoReadyRoutesOptions, VoiceDemoReadyS
 export { compareVoiceEvalBaseline, createVoiceFileEvalBaselineStore, createVoiceFileScenarioFixtureStore, createVoiceEvalRoutes, renderVoiceEvalBaselineHTML, renderVoiceEvalHTML, renderVoiceScenarioEvalHTML, renderVoiceScenarioFixtureEvalHTML, runVoiceScenarioEvals, runVoiceScenarioFixtureEvals, runVoiceSessionEvals } from './evalRoutes';
 export { createVoiceSimulationSuiteRoutes, renderVoiceSimulationSuiteHTML, runVoiceSimulationSuite } from './simulationSuite';
 export { createVoiceWorkflowContract, createVoiceWorkflowContractHandler, createVoiceWorkflowContractPreset, createVoiceWorkflowScenario, recordVoiceWorkflowContractTrace, validateVoiceWorkflowRouteResult } from './workflowContract';
-export { createVoiceSessionListRoutes, createVoiceSessionReplayHTMLHandler, createVoiceSessionReplayJSONHandler, createVoiceSessionReplayRoutes, createVoiceSessionsHTMLHandler, createVoiceSessionsJSONHandler, renderVoiceSessionsHTML, summarizeVoiceSessions, summarizeVoiceSessionReplay } from './sessionReplay';
+export { createVoiceSessionListRoutes, createVoiceSessionReplayHTMLHandler, createVoiceSessionReplayJSONHandler, createVoiceSessionReplayRoutes, createVoiceSessionsHTMLHandler, createVoiceSessionsJSONHandler, renderVoiceSessionsHTML, summarizeVoiceProviderFallbackRecovery, summarizeVoiceSessions, summarizeVoiceSessionReplay } from './sessionReplay';
 export { createVoiceAgent, createVoiceAgentSquad, createVoiceAgentTool } from './agent';
 export { assertVoiceAgentSquadContract, runVoiceAgentSquadContract } from './agentSquadContract';
 export { createVoiceToolIdempotencyKey, createVoiceToolRuntime } from './toolRuntime';
@@ -80,7 +80,7 @@ export type { VoiceDiagnosticsRoutesOptions } from './diagnosticsRoutes';
 export type { VoiceEvalBaselineComparison, VoiceEvalBaselineComparisonOptions, VoiceEvalBaselineStore, VoiceEvalBaselineSummary, VoiceEvalLink, VoiceEvalReport, VoiceEvalRoutesOptions, VoiceEvalSessionReport, VoiceEvalStatus, VoiceEvalTrendBucket, VoiceScenarioEvalDefinition, VoiceScenarioEvalReport, VoiceScenarioEvalResult, VoiceScenarioEvalSessionResult, VoiceScenarioFixture, VoiceScenarioFixtureEvalReport, VoiceScenarioFixtureEvalResult, VoiceScenarioFixtureStore } from './evalRoutes';
 export type { VoiceSimulationSuiteEvalRoutesOptions, VoiceSimulationSuiteOptions, VoiceSimulationSuiteReport, VoiceSimulationSuiteRoutesOptions, VoiceSimulationSuiteSectionSummary, VoiceSimulationSuiteStatus } from './simulationSuite';
 export type { VoiceWorkflowContract, VoiceWorkflowContractDefinition, VoiceWorkflowContractField, VoiceWorkflowContractFieldMatch, VoiceWorkflowContractPresetName, VoiceWorkflowContractPresetOptions, VoiceWorkflowContractTracePayload, VoiceWorkflowContractValidation, VoiceWorkflowContractValidationIssue, VoiceWorkflowOutcome } from './workflowContract';
-export type { VoiceSessionListHTMLHandlerOptions, VoiceSessionListItem, VoiceSessionListOptions, VoiceSessionListRoutesOptions, VoiceSessionListStatus, VoiceSessionReplay, VoiceSessionReplayHTMLHandlerOptions, VoiceSessionReplayOptions, VoiceSessionReplayRoutesOptions, VoiceSessionReplayTurn } from './sessionReplay';
+export type { VoiceSessionListHTMLHandlerOptions, VoiceSessionListItem, VoiceSessionListOptions, VoiceSessionListRoutesOptions, VoiceSessionListStatus, VoiceProviderFallbackRecoverySummary, VoiceSessionReplay, VoiceSessionReplayHTMLHandlerOptions, VoiceSessionReplayOptions, VoiceSessionReplayRoutesOptions, VoiceSessionReplayTurn } from './sessionReplay';
 export type { AnthropicVoiceAssistantModelOptions, GeminiVoiceAssistantModelOptions, OpenAIVoiceAssistantModelOptions, VoiceProviderRouterEvent, VoiceProviderRouterFallbackMode, VoiceProviderRouterHealthOptions, VoiceProviderRouterOptions, VoiceProviderRouterPolicy, VoiceProviderRouterPolicyPreset, VoiceProviderRouterPolicyWeights, VoiceProviderRouterProviderHealth, VoiceProviderRouterProviderProfile, VoiceProviderRouterStrategy, VoiceJSONAssistantModelHandler, VoiceJSONAssistantModelOptions } from './modelAdapters';
 export type { OpenAIVoiceTTSOptions, OpenAIVoiceTTSVoice } from './openaiTTS';
 export type { OpenAIRealtimeAdapterOptions, OpenAIRealtimeModel, OpenAIRealtimeNoiseReduction, OpenAIRealtimeResponseMode, OpenAIRealtimeTranscriptionModel, OpenAIRealtimeVoice } from './openaiRealtime';

package/dist/index.js

@@ -12450,6 +12450,23 @@ var increment4 = (record, key) => {
 var isProviderErrorEvent = (event) => event.type === "session.error" && (event.payload.providerStatus === "error" || typeof event.payload.error === "string");
 var isRecoveredProviderFallbackEvent = (event) => event.type === "session.error" && (event.payload.providerStatus === "fallback" || event.payload.status === "fallback") && event.payload.recovered === true;
 var turnRecoveryKey = (event) => event.turnId ?? `session:${event.sessionId}`;
+var summarizeVoiceProviderFallbackRecovery = (events) => {
+  const sorted = filterVoiceTraceEvents(events);
+  const recoveredEvents = sorted.filter(isRecoveredProviderFallbackEvent);
+  const recoveredKeys = new Set(recoveredEvents.map((event) => turnRecoveryKey(event)));
+  const recoveredSessions = new Set(recoveredEvents.map((event) => event.sessionId));
+  const unresolvedErrorEvents = sorted.filter((event) => isProviderErrorEvent(event) && !recoveredKeys.has(turnRecoveryKey(event)));
+  const unresolvedSessions = new Set(unresolvedErrorEvents.map((event) => event.sessionId));
+  return {
+    recovered: recoveredEvents.length,
+    recoveredSessions: recoveredSessions.size,
+    recoveredTurns: recoveredKeys.size,
+    status: unresolvedErrorEvents.length > 0 ? "fail" : "pass",
+    total: recoveredEvents.length + unresolvedErrorEvents.length,
+    unresolvedErrors: unresolvedErrorEvents.length,
+    unresolvedSessions: unresolvedSessions.size
+  };
+};
 var buildReplayTurns = (events) => {
   const turns = new Map;
   const getTurn = (turnId) => {
@@ -19645,6 +19662,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
   const routingEvents = listVoiceRoutingEvents(events);
   const routingSessions = summarizeVoiceRoutingSessions(routingEvents);
   const liveLatency = summarizeLiveLatency(events, options);
+  const providerRecovery = summarizeVoiceProviderFallbackRecovery(events);
   const [
     quality,
     providers,
@@ -19718,6 +19736,20 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
         }
       ] : []
     },
+    {
+      detail: providerRecovery.unresolvedErrors > 0 ? `${providerRecovery.unresolvedErrors} provider error(s) have no recovered fallback evidence.` : providerRecovery.recovered > 0 ? `${providerRecovery.recovered} provider fallback recovery event(s) kept sessions healthy.` : "No provider fallback recovery was needed in the current trace window.",
+      href: options.links?.resilience ?? "/resilience",
+      label: "Provider fallback recovery",
+      status: providerRecovery.status,
+      value: providerRecovery.total === 0 ? "0 events" : `${providerRecovery.recovered}/${providerRecovery.total}`,
+      actions: providerRecovery.status === "pass" ? [] : [
+        {
+          description: "Open provider resilience traces and inspect unresolved provider errors.",
+          href: options.links?.resilience ?? "/resilience",
+          label: "Open provider recovery"
+        }
+      ]
+    },
     {
       detail: failedSessions === 0 ? sessions.length > 0 ? "Recent sessions have no recorded provider/session failures." : "No sessions have been recorded yet; run a smoke or live session for proof." : `${failedSessions} recent session(s) have failures.`,
       href: options.links?.sessions ?? "/sessions",
@@ -20007,6 +20039,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
         degraded: degradedProviders,
         total: providers.length
       },
+      providerRecovery,
       phoneAgentSmokes: phoneAgentSmokeSummary,
       providerRoutingContracts: providerRoutingContractSummary,
       reconnectContracts: reconnectContractSummary,
@@ -20285,6 +20318,7 @@ var summarizeVoiceOpsStatus = async (options) => {
       events
     })
   ]);
+  const providerRecovery = shouldInclude("providerRecovery") ? summarizeVoiceProviderFallbackRecovery(events) : undefined;
   const surfaces = {};
   const statuses = [];
   if (quality) {
@@ -20305,6 +20339,10 @@ var summarizeVoiceOpsStatus = async (options) => {
     };
     statuses.push(status);
   }
+  if (providerRecovery) {
+    surfaces.providerRecovery = providerRecovery;
+    statuses.push(providerRecovery.status);
+  }
   if (sessions) {
     const failed = sessions.filter((session) => session.status === "failed").length;
     const status = failed > 0 ? "fail" : "pass";
@@ -20338,7 +20376,7 @@ var escapeHtml34 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&l
 var renderVoiceOpsStatusHTML = (report, options = {}) => {
   const title = options.title ?? "AbsoluteJS Voice Ops Status";
   const surfaces = Object.entries(report.surfaces).map(([key, surface]) => {
-    const value = "total" in surface ? `${Math.max(surface.total - ("failed" in surface ? surface.failed : ("degraded" in surface) ? surface.degraded : 0), 0)}/${surface.total}` : surface.status;
+    const value = "recovered" in surface ? surface.total === 0 ? "0 events" : `${surface.recovered}/${surface.total}` : ("total" in surface) ? `${Math.max(surface.total - ("failed" in surface ? surface.failed : ("degraded" in surface) ? surface.degraded : 0), 0)}/${surface.total}` : surface.status;
     return `<article class="surface ${escapeHtml34(surface.status)}"><span>${escapeHtml34(surface.status.toUpperCase())}</span><h2>${escapeHtml34(key)}</h2><strong>${escapeHtml34(value)}</strong></article>`;
   }).join("");
   return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml34(title)}</title><style>body{background:#0d141b;color:#f8f3e7;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:980px;padding:32px}.hero{background:linear-gradient(135deg,rgba(20,184,166,.2),rgba(245,158,11,.12));border:1px solid #283544;border-radius:28px;margin-bottom:18px;padding:28px}.eyebrow{color:#5eead4;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.4rem,6vw,5rem);line-height:.9;margin:.2rem 0 1rem}.status{border:1px solid #3f3f46;border-radius:999px;display:inline-flex;font-weight:900;padding:8px 12px}.surfaces{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(180px,1fr))}.surface{background:#151d26;border:1px solid #283544;border-radius:20px;padding:18px}.surface span{color:#aab5c0;font-size:.78rem;font-weight:900;letter-spacing:.08em}.surface strong{font-size:1.5rem}.pass{border-color:rgba(34,197,94,.55)}.fail{border-color:rgba(239,68,68,.75)}a{color:#5eead4}</style></head><body><main><section class="hero"><p class="eyebrow">Ops status</p><h1>${escapeHtml34(title)}</h1><p>Compact pass/fail status for framework widgets, demos, and small customer-facing health badges.</p><p class="status ${escapeHtml34(report.status)}">Overall: ${escapeHtml34(report.status.toUpperCase())}</p><p>${report.passed}/${report.total} checks passing</p></section><section class="surfaces">${surfaces || '<article class="surface pass"><span>PASS</span><h2>No checks configured</h2><strong>0/0</strong></article>'}</section></main></body></html>`;
@@ -22732,6 +22770,7 @@ export {
   summarizeVoiceRoutingSessions,
   summarizeVoiceRoutingDecision,
   summarizeVoiceProviderHealth,
+  summarizeVoiceProviderFallbackRecovery,
   summarizeVoiceProviderCapabilities,
   summarizeVoiceOpsTasks,
   summarizeVoiceOpsTaskQueue,

package/dist/opsStatus.d.ts

@@ -1,5 +1,6 @@
 import { type VoiceEvalLink, type VoiceEvalRoutesOptions } from './evalRoutes';
 import { type VoiceQualityRoutesOptions } from './qualityRoutes';
+import { type VoiceProviderFallbackRecoverySummary } from './sessionReplay';
 import { type VoiceTraceEventStore } from './trace';
 export type VoiceOpsStatus = 'pass' | 'fail';
 export type VoiceOpsStatusLink = VoiceEvalLink & {
@@ -11,6 +12,7 @@ export type VoiceOpsStatusOptions<TProvider extends string = string> = {
     include?: {
         handoffs?: boolean;
         providers?: boolean;
+        providerRecovery?: boolean;
         quality?: boolean;
         sessions?: boolean;
         workflows?: boolean;
@@ -40,6 +42,7 @@ export type VoiceOpsStatusReport = {
             status: VoiceOpsStatus;
             total: number;
         };
+        providerRecovery?: VoiceProviderFallbackRecoverySummary;
         quality?: {
             status: VoiceOpsStatus;
         };

package/dist/productionReadiness.d.ts

@@ -1,4 +1,5 @@
 import { Elysia } from 'elysia';
+import { type VoiceProviderFallbackRecoverySummary } from './sessionReplay';
 import { type VoiceTelephonyCarrierMatrixInput } from './telephony/matrix';
 import type { VoiceTraceEventStore } from './trace';
 import type { VoiceTraceSinkDeliveryStore } from './trace';
@@ -83,6 +84,7 @@ export type VoiceProductionReadinessReport = {
             degraded: number;
             total: number;
         };
+        providerRecovery: VoiceProviderFallbackRecoverySummary;
         phoneAgentSmokes?: {
             failed: number;
             passed: number;

package/dist/sessionReplay.d.ts

@@ -43,6 +43,15 @@ export type VoiceSessionListItem = {
     transcriptCount: number;
     turnCount: number;
 };
+export type VoiceProviderFallbackRecoverySummary = {
+    recovered: number;
+    recoveredSessions: number;
+    recoveredTurns: number;
+    status: 'fail' | 'pass';
+    total: number;
+    unresolvedErrors: number;
+    unresolvedSessions: number;
+};
 export type VoiceSessionListOptions = {
     events?: StoredVoiceTraceEvent[];
     limit?: number;
@@ -78,6 +87,7 @@ export type VoiceSessionReplayRoutesOptions = VoiceSessionReplayHTMLHandlerOptio
     name?: string;
     path?: string;
 };
+export declare const summarizeVoiceProviderFallbackRecovery: (events: StoredVoiceTraceEvent[]) => VoiceProviderFallbackRecoverySummary;
 export declare const summarizeVoiceSessionReplay: (options: VoiceSessionReplayOptions) => Promise<VoiceSessionReplay>;
 export declare const summarizeVoiceSessions: (options?: VoiceSessionListOptions) => Promise<VoiceSessionListItem[]>;
 export declare const renderVoiceSessionsHTML: (sessions: VoiceSessionListItem[]) => string;

package/package.json

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