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

package/dist/index.d.ts

@@ -44,7 +44,7 @@ export { createVoiceProviderHealthHTMLHandler, createVoiceProviderHealthJSONHand
 export { createVoiceProviderCapabilityHTMLHandler, createVoiceProviderCapabilityJSONHandler, createVoiceProviderCapabilityRoutes, renderVoiceProviderCapabilityHTML, summarizeVoiceProviderCapabilities } from './providerCapabilities';
 export { assertVoiceProviderRoutingContract, runVoiceProviderRoutingContract } from './providerRoutingContract';
 export { createVoicePhoneAgentProductionSmokeHTMLHandler, createVoicePhoneAgentProductionSmokeJSONHandler, createVoicePhoneAgentProductionSmokeRoutes, renderVoicePhoneAgentProductionSmokeHTML, runVoicePhoneAgentProductionSmokeContract } from './phoneAgentProductionSmoke';
-export { buildVoiceProductionReadinessReport, createVoiceProductionReadinessRoutes, renderVoiceProductionReadinessHTML } from './productionReadiness';
+export { buildVoiceProductionReadinessGate, buildVoiceProductionReadinessReport, createVoiceProductionReadinessRoutes, renderVoiceProductionReadinessHTML, summarizeVoiceProductionReadinessGate } from './productionReadiness';
 export { buildVoiceOpsConsoleReport, createVoiceOpsConsoleRoutes, renderVoiceOpsConsoleHTML } from './opsConsoleRoutes';
 export { summarizeVoiceOpsStatus } from './opsStatus';
 export { createVoiceOpsStatusRoutes, renderVoiceOpsStatusHTML } from './opsStatusRoutes';
@@ -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, VoiceProductionReadinessGateIssue, VoiceProductionReadinessGateOptions, VoiceProductionReadinessGateReport, 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

@@ -20128,6 +20128,47 @@ var assertVoiceProviderRoutingContract = async (options) => {
 import { Elysia as Elysia33 } from "elysia";
 var escapeHtml35 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var rollupStatus2 = (checks) => checks.some((check) => check.status === "fail") ? "fail" : checks.some((check) => check.status === "warn") ? "warn" : "pass";
+var readinessGateCodes = {
+  "Agent squad contracts": "voice.readiness.agent_squad_contracts",
+  "Audit evidence": "voice.readiness.audit_evidence",
+  "Audit sink delivery": "voice.readiness.audit_sink_delivery",
+  "Barge-in interruption proof": "voice.readiness.barge_in_interruption",
+  "Carrier readiness": "voice.readiness.carrier_readiness",
+  "Delivery runtime": "voice.readiness.delivery_runtime",
+  "Handoff delivery": "voice.readiness.handoff_delivery",
+  "Live latency proof": "voice.readiness.live_latency",
+  "Operator action history": "voice.readiness.operator_action_history",
+  "Phone agent production smoke": "voice.readiness.phone_agent_smoke",
+  "Provider fallback recovery": "voice.readiness.provider_fallback_recovery",
+  "Provider health": "voice.readiness.provider_health",
+  "Provider routing contracts": "voice.readiness.provider_routing_contracts",
+  "Quality gates": "voice.readiness.quality_gates",
+  "Reconnect recovery contracts": "voice.readiness.reconnect_contracts",
+  "Routing evidence": "voice.readiness.routing_evidence",
+  "Session health": "voice.readiness.session_health",
+  "Trace sink delivery": "voice.readiness.trace_sink_delivery"
+};
+var readinessGateCodeForCheck = (check) => readinessGateCodes[check.label] ?? `voice.readiness.${check.label.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "")}`;
+var summarizeVoiceProductionReadinessGate = (report, options = {}) => {
+  const issues = report.checks.filter((check) => check.status !== "pass").map((check) => ({
+    code: readinessGateCodeForCheck(check),
+    detail: check.detail,
+    href: check.href,
+    label: check.label,
+    status: check.status,
+    value: check.value
+  }));
+  const failures = issues.filter((issue) => issue.status === "fail");
+  const warnings = issues.filter((issue) => issue.status === "warn");
+  const ok = failures.length === 0 && (options.failOnWarnings ? warnings.length === 0 : true);
+  return {
+    checkedAt: report.checkedAt,
+    failures,
+    ok,
+    status: ok ? report.status : "fail",
+    warnings
+  };
+};
 var carrierStatus = (matrix) => matrix.summary.failing > 0 ? "fail" : matrix.summary.warnings > 0 || matrix.summary.ready < matrix.summary.providers ? "warn" : "pass";
 var resolveCarriers = async (options, input) => {
   if (options.carriers === false || options.carriers === undefined) {
@@ -20274,6 +20315,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 +20444,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     handoffs,
     audit,
     auditDeliveries,
+    opsActionHistory,
     traceDeliveries,
     deliveryRuntimeSummary,
     carriers,
@@ -20407,6 +20474,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 +20757,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 +20837,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 +20861,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
         total: handoffs.total
       },
       liveLatency,
+      opsActionHistory,
       providers: {
         degraded: degradedProviders,
         total: providers.length
@@ -20798,6 +20885,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     }
   };
 };
+var buildVoiceProductionReadinessGate = async (options, input = {}) => summarizeVoiceProductionReadinessGate(await buildVoiceProductionReadinessReport(options, input), options.gate || undefined);
 var renderVoiceProductionReadinessHTML = (report, options = {}) => {
   const title = options.title ?? "AbsoluteJS Voice Production Readiness";
   const checks = report.checks.map((check, index) => {
@@ -20818,11 +20906,27 @@ var renderVoiceProductionReadinessHTML = (report, options = {}) => {
 };
 var createVoiceProductionReadinessRoutes = (options) => {
   const path = options.path ?? "/api/production-readiness";
+  const gatePath = options.gatePath === undefined ? "/api/production-readiness/gate" : options.gatePath;
   const htmlPath = options.htmlPath ?? "/production-readiness";
   const routes = new Elysia33({
     name: options.name ?? "absolutejs-voice-production-readiness"
   });
   routes.get(path, async ({ query, request }) => buildVoiceProductionReadinessReport(options, { query, request }));
+  if (gatePath !== false) {
+    routes.get(gatePath, async ({ query, request }) => {
+      const gate = await buildVoiceProductionReadinessGate(options, {
+        query,
+        request
+      });
+      return new Response(JSON.stringify(gate), {
+        headers: {
+          "Content-Type": "application/json; charset=utf-8",
+          ...options.headers
+        },
+        status: gate.ok ? 200 : 503
+      });
+    });
+  }
   if (htmlPath !== false) {
     routes.get(htmlPath, async ({ query, request }) => {
       const report = await buildVoiceProductionReadinessReport(options, {
@@ -23548,6 +23652,7 @@ export {
   summarizeVoiceProviderHealth,
   summarizeVoiceProviderFallbackRecovery,
   summarizeVoiceProviderCapabilities,
+  summarizeVoiceProductionReadinessGate,
   summarizeVoiceOpsTasks,
   summarizeVoiceOpsTaskQueue,
   summarizeVoiceOpsTaskAnalytics,
@@ -23921,6 +24026,7 @@ export {
   buildVoiceTraceReplay,
   buildVoiceTraceDeliveryReport,
   buildVoiceProductionReadinessReport,
+  buildVoiceProductionReadinessGate,
   buildVoiceOpsTaskFromSLABreach,
   buildVoiceOpsTaskFromReview,
   buildVoiceOpsConsoleReport,

package/dist/productionReadiness.d.ts

@@ -27,6 +27,24 @@ export type VoiceProductionReadinessCheck = {
     status: VoiceProductionReadinessStatus;
     value?: number | string;
 };
+export type VoiceProductionReadinessGateIssue = {
+    code: string;
+    detail?: string;
+    href?: string;
+    label: string;
+    status: Exclude<VoiceProductionReadinessStatus, 'pass'>;
+    value?: number | string;
+};
+export type VoiceProductionReadinessGateOptions = {
+    failOnWarnings?: boolean;
+};
+export type VoiceProductionReadinessGateReport = {
+    checkedAt: number;
+    failures: VoiceProductionReadinessGateIssue[];
+    ok: boolean;
+    status: VoiceProductionReadinessStatus;
+    warnings: VoiceProductionReadinessGateIssue[];
+};
 export type VoiceProductionReadinessProofSource = {
     detail?: string;
     href?: string;
@@ -47,6 +65,7 @@ export type VoiceProductionReadinessReport = {
         handoffs?: string;
         handoffRetry?: string;
         liveLatency?: string;
+        opsActions?: string;
         phoneAgentSmoke?: string;
         providerRoutingContracts?: string;
         quality?: string;
@@ -92,6 +111,7 @@ export type VoiceProductionReadinessReport = {
             total: number;
             warnings: number;
         };
+        opsActionHistory?: VoiceProductionReadinessOpsActionHistorySummary;
         providers: {
             degraded: number;
             total: number;
@@ -171,6 +191,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 +235,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>;
@@ -228,10 +260,13 @@ export type VoiceProductionReadinessRoutesOptions = {
         request: Request;
     }) => Promise<VoiceDeliveryRuntime | VoiceDeliveryRuntimeSummary> | VoiceDeliveryRuntime | VoiceDeliveryRuntimeSummary);
     headers?: HeadersInit;
+    gate?: false | VoiceProductionReadinessGateOptions;
+    gatePath?: false | string;
     htmlPath?: false | string;
     links?: VoiceProductionReadinessReport['links'];
     llmProviders?: readonly string[];
     name?: string;
+    opsActionHistory?: false | VoiceProductionReadinessOpsActionHistoryOptions;
     path?: string;
     phoneAgentSmokes?: false | readonly VoicePhoneAgentProductionSmokeReport[] | ((input: {
         query: Record<string, unknown>;
@@ -258,10 +293,15 @@ export type VoiceProductionReadinessRoutesOptions = {
     liveLatencyWarnAfterMs?: number;
     liveLatencyFailAfterMs?: number;
 };
+export declare const summarizeVoiceProductionReadinessGate: (report: VoiceProductionReadinessReport, options?: VoiceProductionReadinessGateOptions) => VoiceProductionReadinessGateReport;
 export declare const buildVoiceProductionReadinessReport: (options: VoiceProductionReadinessRoutesOptions, input?: {
     query?: Record<string, unknown>;
     request?: Request;
 }) => Promise<VoiceProductionReadinessReport>;
+export declare const buildVoiceProductionReadinessGate: (options: VoiceProductionReadinessRoutesOptions, input?: {
+    query?: Record<string, unknown>;
+    request?: Request;
+}) => Promise<VoiceProductionReadinessGateReport>;
 export declare const renderVoiceProductionReadinessHTML: (report: VoiceProductionReadinessReport, options?: {
     title?: string;
 }) => string;

package/package.json

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