@absolutejs/voice 0.0.22-beta.157 → 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, VoiceProductionReadinessOpsActionHistoryOptions, VoiceProductionReadinessOpsActionHistorySummary, 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) {
@@ -20844,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) => {
@@ -20864,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, {
@@ -23594,6 +23652,7 @@ export {
   summarizeVoiceProviderHealth,
   summarizeVoiceProviderFallbackRecovery,
   summarizeVoiceProviderCapabilities,
+  summarizeVoiceProductionReadinessGate,
   summarizeVoiceOpsTasks,
   summarizeVoiceOpsTaskQueue,
   summarizeVoiceOpsTaskAnalytics,
@@ -23967,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;
@@ -242,6 +260,8 @@ 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[];
@@ -273,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.157",
+	"version": "0.0.22-beta.158",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",