@absolutejs/voice 0.0.22-beta.148 → 0.0.22-beta.149

package/dist/index.js

@@ -19889,6 +19889,14 @@ var resolveProofSources = async (options, input) => {
   }
   return typeof options.proofSources === "function" ? await options.proofSources(input) : options.proofSources;
 };
+var isVoiceDeliveryRuntime = (value) => typeof value.summarize === "function";
+var resolveDeliveryRuntime = async (options, input) => {
+  if (options.deliveryRuntime === false || options.deliveryRuntime === undefined) {
+    return;
+  }
+  const runtime = typeof options.deliveryRuntime === "function" ? await options.deliveryRuntime(input) : options.deliveryRuntime;
+  return isVoiceDeliveryRuntime(runtime) ? await runtime.summarize() : runtime;
+};
 var defaultAuditRequirements = [
   {
     label: "Provider-call audit",
@@ -20013,6 +20021,48 @@ var summarizeTraceDeliveries = async (options) => {
     warnPendingAfterMs
   };
 };
+var summarizeDeliveryRuntime = (summary) => {
+  if (!summary) {
+    return;
+  }
+  const audit = summary.audit ? {
+    deadLettered: summary.audit.deadLettered,
+    delivered: summary.audit.delivered,
+    failed: summary.audit.failed,
+    pending: summary.audit.pending,
+    retryEligible: summary.audit.retryEligible,
+    skipped: summary.audit.skipped,
+    total: summary.audit.total
+  } : undefined;
+  const trace = summary.trace ? {
+    deadLettered: summary.trace.deadLettered,
+    delivered: summary.trace.delivered,
+    failed: summary.trace.failed,
+    pending: summary.trace.pending,
+    retryEligible: summary.trace.retryEligible,
+    skipped: summary.trace.skipped,
+    total: summary.trace.total
+  } : undefined;
+  const queues = [audit, trace].filter((queue) => Boolean(queue));
+  const total = queues.reduce((sum, queue) => sum + queue.total, 0);
+  const failed = queues.reduce((sum, queue) => sum + queue.failed, 0);
+  const deadLettered = queues.reduce((sum, queue) => sum + queue.deadLettered, 0);
+  const pending = queues.reduce((sum, queue) => sum + queue.pending, 0);
+  const retryEligible = queues.reduce((sum, queue) => sum + queue.retryEligible, 0);
+  const status = failed > 0 || deadLettered > 0 ? "fail" : pending > 0 || retryEligible > 0 ? "warn" : "pass";
+  return {
+    audit,
+    deadLettered,
+    delivered: queues.reduce((sum, queue) => sum + queue.delivered, 0),
+    failed,
+    pending,
+    retryEligible,
+    skipped: queues.reduce((sum, queue) => sum + queue.skipped, 0),
+    status,
+    total,
+    trace
+  };
+};
 var summarizeLiveLatency = (events, options) => {
   const warnAfterMs = options.liveLatencyWarnAfterMs ?? 1800;
   const failAfterMs = options.liveLatencyFailAfterMs ?? 3200;
@@ -20044,6 +20094,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     audit,
     auditDeliveries,
     traceDeliveries,
+    deliveryRuntimeSummary,
     carriers,
     agentSquadContracts,
     providerRoutingContracts,
@@ -20072,6 +20123,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     summarizeAuditEvidence(options),
     summarizeAuditDeliveries(options),
     summarizeTraceDeliveries(options),
+    resolveDeliveryRuntime(options, { query, request }),
     resolveCarriers(options, { query, request }),
     resolveAgentSquadContracts(options, { query, request }),
     resolveProviderRoutingContracts(options, { query, request }),
@@ -20080,6 +20132,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     resolveBargeInReports(options, { query, request }),
     resolveProofSources(options, { query, request })
   ]);
+  const deliveryRuntime = summarizeDeliveryRuntime(deliveryRuntimeSummary);
   const degradedProviders = providers.filter((provider) => provider.status === "degraded" || provider.status === "rate-limited" || provider.status === "suppressed").length;
   const failedSessions = sessions.filter((session) => session.status === "failed").length;
   const checks = [
@@ -20368,6 +20421,23 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       ]
     });
   }
+  if (deliveryRuntime) {
+    checks.push({
+      detail: deliveryRuntime.status === "pass" ? "Delivery runtime queues are clear." : deliveryRuntime.failed > 0 || deliveryRuntime.deadLettered > 0 ? `${deliveryRuntime.failed} failed and ${deliveryRuntime.deadLettered} dead-lettered runtime delivery item(s).` : `${deliveryRuntime.pending} runtime delivery item(s) are pending.`,
+      href: options.links?.deliveryRuntime ?? "/delivery-runtime",
+      label: "Delivery runtime",
+      proofSource: proofSource("deliveryRuntime"),
+      status: deliveryRuntime.status,
+      value: `${deliveryRuntime.delivered + deliveryRuntime.skipped}/${deliveryRuntime.total}`,
+      actions: deliveryRuntime.status === "pass" ? [] : [
+        {
+          description: "Open the delivery runtime control plane to inspect queues or manually tick workers.",
+          href: options.links?.deliveryRuntime ?? "/delivery-runtime",
+          label: "Open delivery runtime"
+        }
+      ]
+    });
+  }
   if (carriers && carrierSummary) {
     checks.push({
       detail: carrierSummary.status === "pass" ? "Configured carrier setup and contract checks are passing." : `${carrierSummary.failing} carrier(s) failing, ${carrierSummary.warnings} warning(s).`,
@@ -20393,6 +20463,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       auditDeliveries: "/audit",
       bargeIn: "/barge-in",
       carriers: "/carriers",
+      deliveryRuntime: "/delivery-runtime",
       handoffs: "/handoffs",
       handoffRetry: "/api/voice-handoffs/retry",
       liveLatency: "/traces",
@@ -20413,6 +20484,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       auditDeliveries,
       bargeIn: bargeInSummary,
       carriers: carrierSummary,
+      deliveryRuntime,
       handoffs: {
         failed: handoffs.failed,
         total: handoffs.total

package/dist/productionReadiness.d.ts

@@ -5,6 +5,7 @@ import type { VoiceTraceEventStore } from './trace';
 import type { VoiceTraceSinkDeliveryStore } from './trace';
 import type { VoiceAgentSquadContractReport } from './agentSquadContract';
 import type { VoiceBargeInReport } from './bargeInRoutes';
+import type { VoiceDeliveryRuntime, VoiceDeliveryRuntimeSummary } from './deliveryRuntime';
 import type { VoiceProviderRoutingContractReport } from './providerRoutingContract';
 import type { VoicePhoneAgentProductionSmokeReport } from './phoneAgentProductionSmoke';
 import type { VoiceReconnectContractReport } from './reconnectContract';
@@ -42,6 +43,7 @@ export type VoiceProductionReadinessReport = {
         auditDeliveries?: string;
         bargeIn?: string;
         carriers?: string;
+        deliveryRuntime?: string;
         handoffs?: string;
         handoffRetry?: string;
         liveLatency?: string;
@@ -78,6 +80,7 @@ export type VoiceProductionReadinessReport = {
             status: VoiceProductionReadinessStatus;
             warnings: number;
         };
+        deliveryRuntime?: VoiceProductionReadinessDeliveryRuntimeSummary;
         handoffs: {
             failed: number;
             total: number;
@@ -168,6 +171,27 @@ export type VoiceProductionReadinessTraceDeliverySummary = {
     total: number;
     warnPendingAfterMs: number;
 };
+export type VoiceProductionReadinessDeliveryRuntimeSummary = {
+    audit?: VoiceProductionReadinessDeliveryRuntimeQueueSummary;
+    deadLettered: number;
+    delivered: number;
+    failed: number;
+    pending: number;
+    retryEligible: number;
+    skipped: number;
+    status: VoiceProductionReadinessStatus;
+    total: number;
+    trace?: VoiceProductionReadinessDeliveryRuntimeQueueSummary;
+};
+export type VoiceProductionReadinessDeliveryRuntimeQueueSummary = {
+    deadLettered: number;
+    delivered: number;
+    failed: number;
+    pending: number;
+    retryEligible: number;
+    skipped: number;
+    total: number;
+};
 export type VoiceProductionReadinessAuditOptions = VoiceAuditEventStore | {
     require?: readonly (VoiceAuditEventType | VoiceProductionReadinessAuditRequirement)[];
     store: VoiceAuditEventStore;
@@ -199,6 +223,10 @@ export type VoiceProductionReadinessRoutesOptions = {
         query: Record<string, unknown>;
         request: Request;
     }) => Promise<readonly VoiceTelephonyCarrierMatrixInput[]> | readonly VoiceTelephonyCarrierMatrixInput[]);
+    deliveryRuntime?: false | VoiceDeliveryRuntime | VoiceDeliveryRuntimeSummary | ((input: {
+        query: Record<string, unknown>;
+        request: Request;
+    }) => Promise<VoiceDeliveryRuntime | VoiceDeliveryRuntimeSummary> | VoiceDeliveryRuntime | VoiceDeliveryRuntimeSummary);
     headers?: HeadersInit;
     htmlPath?: false | string;
     links?: VoiceProductionReadinessReport['links'];

package/package.json

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