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

package/dist/index.d.ts

@@ -44,7 +44,8 @@ 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 { createVoiceReadinessProfile } from './readinessProfiles';
 export { buildVoiceOpsConsoleReport, createVoiceOpsConsoleRoutes, renderVoiceOpsConsoleHTML } from './opsConsoleRoutes';
 export { summarizeVoiceOpsStatus } from './opsStatus';
 export { createVoiceOpsStatusRoutes, renderVoiceOpsStatusHTML } from './opsStatusRoutes';
@@ -102,7 +103,8 @@ 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 { VoiceReadinessProfileName, VoiceReadinessProfileOptions, VoiceReadinessProfileRoutesOptions } from './readinessProfiles';
 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, {
@@ -20886,6 +20944,78 @@ var createVoiceProductionReadinessRoutes = (options) => {
   }
   return routes;
 };
+// src/readinessProfiles.ts
+var auditStoreFromOptions = (audit) => {
+  if (!audit) {
+    return;
+  }
+  return "list" in audit ? audit : audit.store;
+};
+var withDefined = (options) => Object.fromEntries(Object.entries(options).filter(([, value]) => value !== undefined));
+var mergeLinks = (defaults, links) => ({
+  ...defaults,
+  ...links
+});
+var createVoiceReadinessProfile = (profile, options = {}) => {
+  if (profile === "meeting-recorder") {
+    return withDefined({
+      bargeInReports: options.bargeInReports,
+      gate: options.gate,
+      links: mergeLinks({
+        bargeIn: "/barge-in",
+        liveLatency: "/live-latency",
+        providerRoutingContracts: "/resilience",
+        quality: "/quality",
+        reconnectContracts: "/voice/reconnect-contract",
+        resilience: "/resilience",
+        sessions: "/sessions"
+      }, options.links),
+      proofSources: options.proofSources,
+      providerRoutingContracts: options.providerRoutingContracts,
+      reconnectContracts: options.reconnectContracts
+    });
+  }
+  if (profile === "phone-agent") {
+    return withDefined({
+      auditDeliveries: options.auditDeliveries,
+      carriers: options.carriers,
+      deliveryRuntime: options.deliveryRuntime,
+      gate: options.gate,
+      links: mergeLinks({
+        auditDeliveries: "/audit/deliveries",
+        carriers: "/carriers",
+        deliveryRuntime: "/delivery-runtime",
+        handoffs: "/handoffs",
+        phoneAgentSmoke: "/sessions",
+        providerRoutingContracts: "/resilience",
+        resilience: "/resilience",
+        sessions: "/sessions",
+        traceDeliveries: "/traces/deliveries"
+      }, options.links),
+      phoneAgentSmokes: options.phoneAgentSmokes,
+      proofSources: options.proofSources,
+      providerRoutingContracts: options.providerRoutingContracts,
+      traceDeliveries: options.traceDeliveries
+    });
+  }
+  const opsActionHistory = options.opsActionHistory ?? auditStoreFromOptions(options.audit);
+  return withDefined({
+    audit: options.audit,
+    auditDeliveries: options.auditDeliveries,
+    deliveryRuntime: options.deliveryRuntime,
+    gate: options.gate,
+    links: mergeLinks({
+      audit: "/audit",
+      auditDeliveries: "/audit/deliveries",
+      deliveryRuntime: "/delivery-runtime",
+      opsActions: "/voice/ops-actions",
+      traceDeliveries: "/traces/deliveries"
+    }, options.links),
+    opsActionHistory,
+    proofSources: options.proofSources,
+    traceDeliveries: options.traceDeliveries
+  });
+};
 // src/opsConsoleRoutes.ts
 import { Elysia as Elysia34 } from "elysia";
 var DEFAULT_LINKS = [
@@ -23594,6 +23724,7 @@ export {
   summarizeVoiceProviderHealth,
   summarizeVoiceProviderFallbackRecovery,
   summarizeVoiceProviderCapabilities,
+  summarizeVoiceProductionReadinessGate,
   summarizeVoiceOpsTasks,
   summarizeVoiceOpsTaskQueue,
   summarizeVoiceOpsTaskAnalytics,
@@ -23809,6 +23940,7 @@ export {
   createVoiceRedisTaskLeaseCoordinator,
   createVoiceRedisIdempotencyStore,
   createVoiceReconnectContractRoutes,
+  createVoiceReadinessProfile,
   createVoiceQualityRoutes,
   createVoiceProviderRouter,
   createVoiceProviderHealthRoutes,
@@ -23967,6 +24099,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/dist/readinessProfiles.d.ts

@@ -0,0 +1,19 @@
+import type { VoiceProductionReadinessAuditOptions, VoiceProductionReadinessAuditDeliveryOptions, VoiceProductionReadinessOpsActionHistoryOptions, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessTraceDeliveryOptions } from './productionReadiness';
+export type VoiceReadinessProfileName = 'meeting-recorder' | 'ops-heavy' | 'phone-agent';
+export type VoiceReadinessProfileOptions = {
+    audit?: VoiceProductionReadinessAuditOptions;
+    auditDeliveries?: VoiceProductionReadinessAuditDeliveryOptions;
+    bargeInReports?: VoiceProductionReadinessRoutesOptions['bargeInReports'];
+    carriers?: VoiceProductionReadinessRoutesOptions['carriers'];
+    deliveryRuntime?: VoiceProductionReadinessRoutesOptions['deliveryRuntime'];
+    gate?: VoiceProductionReadinessRoutesOptions['gate'];
+    links?: VoiceProductionReadinessRoutesOptions['links'];
+    opsActionHistory?: VoiceProductionReadinessOpsActionHistoryOptions;
+    phoneAgentSmokes?: VoiceProductionReadinessRoutesOptions['phoneAgentSmokes'];
+    proofSources?: VoiceProductionReadinessRoutesOptions['proofSources'];
+    providerRoutingContracts?: VoiceProductionReadinessRoutesOptions['providerRoutingContracts'];
+    reconnectContracts?: VoiceProductionReadinessRoutesOptions['reconnectContracts'];
+    traceDeliveries?: VoiceProductionReadinessTraceDeliveryOptions;
+};
+export type VoiceReadinessProfileRoutesOptions = Partial<Omit<VoiceProductionReadinessRoutesOptions, 'store'>>;
+export declare const createVoiceReadinessProfile: (profile: VoiceReadinessProfileName, options?: VoiceReadinessProfileOptions) => VoiceReadinessProfileRoutesOptions;

package/package.json

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