@absolutejs/voice 0.0.22-beta.101 → 0.0.22-beta.102

package/dist/index.js

@@ -9744,12 +9744,28 @@ var resolveCarriers = async (options, input) => {
     providers: [...providers]
   });
 };
+var summarizeLiveLatency = (events, options) => {
+  const warnAfterMs = options.liveLatencyWarnAfterMs ?? 1800;
+  const failAfterMs = options.liveLatencyFailAfterMs ?? 3200;
+  const latencies = events.filter((event) => event.type === "client.live_latency").map((event) => typeof event.payload.latencyMs === "number" ? event.payload.latencyMs : typeof event.payload.elapsedMs === "number" ? event.payload.elapsedMs : undefined).filter((value) => typeof value === "number");
+  const failed = latencies.filter((value) => value > failAfterMs).length;
+  const warnings = latencies.filter((value) => value > warnAfterMs && value <= failAfterMs).length;
+  const averageLatencyMs = latencies.length > 0 ? Math.round(latencies.reduce((total, value) => total + value, 0) / latencies.length) : undefined;
+  return {
+    averageLatencyMs,
+    failed,
+    status: latencies.length === 0 ? "warn" : failed > 0 ? "fail" : warnings > 0 ? "warn" : "pass",
+    total: latencies.length,
+    warnings
+  };
+};
 var buildVoiceProductionReadinessReport = async (options, input = {}) => {
   const request = input.request ?? new Request("http://localhost/");
   const query = input.query ?? {};
   const events = await options.store.list();
   const routingEvents = listVoiceRoutingEvents(events);
   const routingSessions = summarizeVoiceRoutingSessions(routingEvents);
+  const liveLatency = summarizeLiveLatency(events, options);
   const [quality, providers, sessions, handoffs, carriers] = await Promise.all([
     evaluateVoiceQuality({ events }),
     Promise.all([
@@ -9856,6 +9872,20 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       ]
     }
   ];
+  checks.push({
+    detail: liveLatency.total === 0 ? "No browser live-latency measurements are recorded yet." : liveLatency.status === "pass" ? `Live browser turn latency averages ${liveLatency.averageLatencyMs}ms.` : `${liveLatency.failed} failed and ${liveLatency.warnings} warned live-latency measurement(s).`,
+    href: options.links?.liveLatency ?? "/traces",
+    label: "Live latency proof",
+    status: liveLatency.status,
+    value: liveLatency.averageLatencyMs === undefined ? `${liveLatency.total} samples` : `${liveLatency.averageLatencyMs}ms avg`,
+    actions: liveLatency.status === "pass" ? [] : [
+      {
+        description: "Run a live browser voice turn and inspect the persisted latency trace.",
+        href: options.links?.liveLatency ?? "/traces",
+        label: "Open live latency traces"
+      }
+    ]
+  });
   const carrierSummary = carriers ? {
     failing: carriers.summary.failing,
     providers: carriers.summary.providers,
@@ -9886,6 +9916,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       carriers: "/carriers",
       handoffs: "/handoffs",
       handoffRetry: "/api/voice-handoffs/retry",
+      liveLatency: "/traces",
       quality: "/quality",
       resilience: "/resilience",
       sessions: "/sessions",
@@ -9898,6 +9929,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
         failed: handoffs.failed,
         total: handoffs.total
       },
+      liveLatency,
       providers: {
         degraded: degradedProviders,
         total: providers.length

package/dist/productionReadiness.d.ts

@@ -23,6 +23,7 @@ export type VoiceProductionReadinessReport = {
         carriers?: string;
         handoffs?: string;
         handoffRetry?: string;
+        liveLatency?: string;
         quality?: string;
         resilience?: string;
         sessions?: string;
@@ -40,6 +41,13 @@ export type VoiceProductionReadinessReport = {
             failed: number;
             total: number;
         };
+        liveLatency: {
+            averageLatencyMs?: number;
+            failed: number;
+            status: VoiceProductionReadinessStatus;
+            total: number;
+            warnings: number;
+        };
         providers: {
             degraded: number;
             total: number;
@@ -73,6 +81,8 @@ export type VoiceProductionReadinessRoutesOptions = {
     sttProviders?: readonly string[];
     title?: string;
     ttsProviders?: readonly string[];
+    liveLatencyWarnAfterMs?: number;
+    liveLatencyFailAfterMs?: number;
 };
 export declare const buildVoiceProductionReadinessReport: (options: VoiceProductionReadinessRoutesOptions, input?: {
     query?: Record<string, unknown>;

package/package.json

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