@absolutejs/voice 0.0.22-beta.156 → 0.0.22-beta.157

package/dist/index.d.ts

@@ -102,7 +102,7 @@ export type { VoicePhoneAgentCarrier, VoicePhoneAgentCarrierSummary, VoicePhoneA
 export type { VoicePhoneAgentProductionSmokeIssue, VoicePhoneAgentProductionSmokeHandlerOptions, VoicePhoneAgentProductionSmokeHTMLHandlerOptions, VoicePhoneAgentProductionSmokeOptions, VoicePhoneAgentProductionSmokeReport, VoicePhoneAgentProductionSmokeRoutesOptions, VoicePhoneAgentProductionSmokeRequirement } from './phoneAgentProductionSmoke';
 export type { VoiceOpsConsoleLink, VoiceOpsConsoleReport, VoiceOpsConsoleRoutesOptions } from './opsConsoleRoutes';
 export type { VoiceOpsStatus, VoiceOpsStatusLink, VoiceOpsStatusOptions, VoiceOpsStatusReport, VoiceOpsStatusRoutesOptions } from './opsStatus';
-export type { VoiceProductionReadinessAction, VoiceProductionReadinessAuditOptions, VoiceProductionReadinessAuditRequirement, VoiceProductionReadinessAuditSummary, VoiceProductionReadinessCheck, VoiceProductionReadinessProofSource, VoiceProductionReadinessReport, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessTraceDeliverySummary, VoiceProductionReadinessAuditDeliveryOptions, VoiceProductionReadinessAuditDeliverySummary, VoiceProductionReadinessTraceDeliveryOptions, VoiceProductionReadinessStatus } from './productionReadiness';
+export type { VoiceProductionReadinessAction, VoiceProductionReadinessAuditOptions, VoiceProductionReadinessAuditRequirement, VoiceProductionReadinessAuditSummary, VoiceProductionReadinessCheck, VoiceProductionReadinessOpsActionHistoryOptions, VoiceProductionReadinessOpsActionHistorySummary, VoiceProductionReadinessProofSource, VoiceProductionReadinessReport, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessTraceDeliverySummary, VoiceProductionReadinessAuditDeliveryOptions, VoiceProductionReadinessAuditDeliverySummary, VoiceProductionReadinessTraceDeliveryOptions, VoiceProductionReadinessStatus } from './productionReadiness';
 export type { VoiceQualityLink, VoiceQualityMetric, VoiceQualityReport, VoiceQualityRoutesOptions, VoiceQualityStatus, VoiceQualityThresholds } from './qualityRoutes';
 export type { VoiceResilienceIOSimulator, VoiceResilienceLink, VoiceResiliencePageData, VoiceResilienceRoutesOptions, VoiceResilienceSimulationProvider, VoiceRoutingKindSummary, VoiceRoutingDecisionSummary, VoiceRoutingDecisionSummaryOptions, VoiceRoutingEvent, VoiceRoutingEventKind, VoiceRoutingSessionSummary, VoiceRoutingSessionSummaryOptions } from './resilienceRoutes';
 export type { VoiceIOProviderRouterEvent, VoiceIOProviderRouterOptions, VoiceIOProviderRouterPolicy, VoiceIOProviderRouterPolicyConfig, VoiceSTTProviderRouterOptions, VoiceTTSProviderRouterOptions } from './providerAdapters';

package/dist/index.js

@@ -20274,6 +20274,31 @@ var summarizeAuditDeliveries = async (options) => {
     warnPendingAfterMs
   };
 };
+var summarizeOpsActionHistory = async (options) => {
+  if (!options.opsActionHistory) {
+    return;
+  }
+  const opsActionHistory = "list" in options.opsActionHistory ? {
+    failOnFailedActions: true,
+    store: options.opsActionHistory,
+    warnWhenEmpty: false
+  } : {
+    failOnFailedActions: options.opsActionHistory.failOnFailedActions ?? true,
+    store: options.opsActionHistory.store,
+    warnWhenEmpty: options.opsActionHistory.warnWhenEmpty ?? false
+  };
+  const report = await buildVoiceOpsActionHistoryReport({
+    audit: opsActionHistory.store
+  });
+  const status = report.failed > 0 ? opsActionHistory.failOnFailedActions ? "fail" : "warn" : report.total === 0 && opsActionHistory.warnWhenEmpty ? "warn" : "pass";
+  return {
+    failed: report.failed,
+    passed: report.passed,
+    status,
+    total: report.total,
+    warnWhenEmpty: opsActionHistory.warnWhenEmpty
+  };
+};
 var summarizeTraceDeliveries = async (options) => {
   if (!options.traceDeliveries) {
     return;
@@ -20378,6 +20403,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     handoffs,
     audit,
     auditDeliveries,
+    opsActionHistory,
     traceDeliveries,
     deliveryRuntimeSummary,
     carriers,
@@ -20407,6 +20433,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     summarizeVoiceHandoffHealth({ events }),
     summarizeAuditEvidence(options),
     summarizeAuditDeliveries(options),
+    summarizeOpsActionHistory(options),
     summarizeTraceDeliveries(options),
     resolveDeliveryRuntime(options, { query, request }),
     resolveCarriers(options, { query, request }),
@@ -20689,6 +20716,23 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       ]
     });
   }
+  if (opsActionHistory) {
+    checks.push({
+      detail: opsActionHistory.status === "pass" ? opsActionHistory.total > 0 ? `${opsActionHistory.passed} operator action(s) completed successfully.` : "No operator action failures are recorded." : opsActionHistory.failed > 0 ? `${opsActionHistory.failed} operator action(s) failed and need review.` : "No operator action history is recorded yet.",
+      href: options.links?.opsActions ?? "/voice/ops-actions",
+      label: "Operator action history",
+      proofSource: proofSource("opsActions", "operatorActions"),
+      status: opsActionHistory.status,
+      value: `${opsActionHistory.passed}/${opsActionHistory.total}`,
+      actions: opsActionHistory.status === "pass" ? [] : [
+        {
+          description: "Open operator action history and inspect failed control-plane actions.",
+          href: options.links?.opsActions ?? "/voice/ops-actions",
+          label: "Open action history"
+        }
+      ]
+    });
+  }
   if (traceDeliveries) {
     checks.push({
       detail: traceDeliveries.status === "pass" ? "Trace sink deliveries are clear." : traceDeliveries.staleFailing > 0 ? `${traceDeliveries.staleFailing} trace delivery item(s) are stale past ${Math.round(traceDeliveries.failPendingAfterMs / 1000)}s.` : traceDeliveries.failed > 0 || traceDeliveries.deadLettered > 0 ? `${traceDeliveries.failed} failed and ${traceDeliveries.deadLettered} dead-lettered trace delivery item(s).` : `${traceDeliveries.pending} trace delivery item(s) are pending.`,
@@ -20752,6 +20796,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       handoffs: "/handoffs",
       handoffRetry: "/api/voice-handoffs/retry",
       liveLatency: "/traces",
+      opsActions: "/voice/ops-actions",
       phoneAgentSmoke: "/sessions",
       providerRoutingContracts: "/resilience",
       quality: "/quality",
@@ -20775,6 +20820,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
         total: handoffs.total
       },
       liveLatency,
+      opsActionHistory,
       providers: {
         degraded: degradedProviders,
         total: providers.length

package/dist/productionReadiness.d.ts

@@ -47,6 +47,7 @@ export type VoiceProductionReadinessReport = {
         handoffs?: string;
         handoffRetry?: string;
         liveLatency?: string;
+        opsActions?: string;
         phoneAgentSmoke?: string;
         providerRoutingContracts?: string;
         quality?: string;
@@ -92,6 +93,7 @@ export type VoiceProductionReadinessReport = {
             total: number;
             warnings: number;
         };
+        opsActionHistory?: VoiceProductionReadinessOpsActionHistorySummary;
         providers: {
             degraded: number;
             total: number;
@@ -171,6 +173,13 @@ export type VoiceProductionReadinessTraceDeliverySummary = {
     total: number;
     warnPendingAfterMs: number;
 };
+export type VoiceProductionReadinessOpsActionHistorySummary = {
+    failed: number;
+    passed: number;
+    status: VoiceProductionReadinessStatus;
+    total: number;
+    warnWhenEmpty: boolean;
+};
 export type VoiceProductionReadinessDeliveryRuntimeSummary = {
     audit?: VoiceProductionReadinessDeliveryRuntimeQueueSummary;
     deadLettered: number;
@@ -208,6 +217,11 @@ export type VoiceProductionReadinessTraceDeliveryOptions = VoiceTraceSinkDeliver
     store: VoiceTraceSinkDeliveryStore;
     warnPendingAfterMs?: number;
 };
+export type VoiceProductionReadinessOpsActionHistoryOptions = VoiceAuditEventStore | {
+    failOnFailedActions?: boolean;
+    store: VoiceAuditEventStore;
+    warnWhenEmpty?: boolean;
+};
 export type VoiceProductionReadinessRoutesOptions = {
     agentSquadContracts?: false | readonly VoiceAgentSquadContractReport[] | ((input: {
         query: Record<string, unknown>;
@@ -232,6 +246,7 @@ export type VoiceProductionReadinessRoutesOptions = {
     links?: VoiceProductionReadinessReport['links'];
     llmProviders?: readonly string[];
     name?: string;
+    opsActionHistory?: false | VoiceProductionReadinessOpsActionHistoryOptions;
     path?: string;
     phoneAgentSmokes?: false | readonly VoicePhoneAgentProductionSmokeReport[] | ((input: {
         query: Record<string, unknown>;

package/package.json

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