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

package/dist/client/index.js

@@ -1758,6 +1758,23 @@ var createVoiceLiveTurnLatencyMonitor = (options = {}) => {
       listener();
     }
   };
+  const reportCompletedEvent = async (event) => {
+    await options.onComplete?.(event);
+    if (!options.reportPath) {
+      return;
+    }
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    const response = await fetchImpl(options.reportPath, {
+      body: JSON.stringify(event),
+      headers: {
+        "content-type": "application/json"
+      },
+      method: "POST"
+    });
+    if (!response.ok) {
+      throw new Error(`Voice live turn latency report failed: HTTP ${response.status}`);
+    }
+  };
   const completePending = (input) => {
     if (!pending) {
       return;
@@ -1773,6 +1790,7 @@ var createVoiceLiveTurnLatencyMonitor = (options = {}) => {
       status
     };
     events = [pending, ...events].slice(0, maxEvents);
+    reportCompletedEvent(pending).catch(() => {});
     pending = undefined;
     emit();
   };

package/dist/client/liveTurnLatency.d.ts

@@ -26,7 +26,10 @@ export type VoiceLiveTurnLatencySnapshot = {
 export type VoiceLiveTurnLatencyMonitorOptions = {
     clock?: () => number;
     failAfterMs?: number;
+    fetch?: typeof fetch;
     maxEvents?: number;
+    onComplete?: (event: VoiceLiveTurnLatencyEvent) => Promise<void> | void;
+    reportPath?: string;
     speechThreshold?: number;
     warnAfterMs?: number;
 };

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
@@ -10017,6 +10049,8 @@ var timelineLabel = (event) => {
       return `Guardrail ${eventStatus(event) ?? "check"}`;
     case "call.handoff":
       return `Call handoff ${eventStatus(event) ?? ""}`.trim();
+    case "client.live_latency":
+      return `Live latency${eventElapsedMs(event) !== undefined ? ` ${eventElapsedMs(event)}ms` : ""}`;
     case "session.error":
       return `Error${getString9(event.payload.error) ? `: ${getString9(event.payload.error)}` : ""}`;
     case "turn.cost":

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/dist/trace.d.ts

@@ -1,4 +1,4 @@
-export type VoiceTraceEventType = 'assistant.guardrail' | 'assistant.memory' | 'assistant.run' | 'agent.handoff' | 'agent.model' | 'agent.result' | 'agent.tool' | 'call.handoff' | 'call.lifecycle' | 'client.barge_in' | 'session.error' | 'turn.assistant' | 'turn.committed' | 'turn.cost' | 'turn_latency.stage' | 'turn.transcript' | 'workflow.contract';
+export type VoiceTraceEventType = 'assistant.guardrail' | 'assistant.memory' | 'assistant.run' | 'agent.handoff' | 'agent.model' | 'agent.result' | 'agent.tool' | 'call.handoff' | 'call.lifecycle' | 'client.barge_in' | 'client.live_latency' | 'session.error' | 'turn.assistant' | 'turn.committed' | 'turn.cost' | 'turn_latency.stage' | 'turn.transcript' | 'workflow.contract';
 export type VoiceTraceEvent<TPayload extends Record<string, unknown> = Record<string, unknown>> = {
     at: number;
     id?: string;

package/package.json

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