@absolutejs/voice 0.0.22-beta.302 → 0.0.22-beta.303

package/dist/index.d.ts

@@ -10,7 +10,7 @@ export { createVoiceAuditHTTPSink, createVoiceAuditS3Sink, createVoiceAuditSinkD
 export { buildVoiceAuditDeliveryReport, createVoiceAuditDeliveryHTMLHandler, createVoiceAuditDeliveryJSONHandler, createVoiceAuditDeliveryRoutes, renderVoiceAuditDeliveryHTML, resolveVoiceAuditDeliveryFilter } from './auditDeliveryRoutes';
 export { createVoiceBargeInRoutes, renderVoiceBargeInHTML, summarizeVoiceBargeIn } from './bargeInRoutes';
 export { createVoiceReconnectContractRoutes, renderVoiceReconnectContractHTML, summarizeVoiceReconnectContractSnapshots, runVoiceReconnectContract } from './reconnectContract';
-export { assertVoiceRealtimeChannelEvidence, buildVoiceRealtimeChannelReport, createVoiceRealtimeChannelRoutes, evaluateVoiceRealtimeChannelEvidence, renderVoiceRealtimeChannelHTML, renderVoiceRealtimeChannelMarkdown } from './realtimeChannel';
+export { assertVoiceRealtimeChannelEvidence, buildVoiceRealtimeChannelRuntimeSamplesFromTrace, buildVoiceRealtimeChannelReport, createVoiceRealtimeChannelRoutes, evaluateVoiceRealtimeChannelEvidence, renderVoiceRealtimeChannelHTML, renderVoiceRealtimeChannelMarkdown } from './realtimeChannel';
 export type { VoiceRealtimeChannelAssertionInput, VoiceRealtimeChannelAssertionReport, VoiceRealtimeChannelBrowserCapture, VoiceRealtimeChannelIssue, VoiceRealtimeChannelReport, VoiceRealtimeChannelReportOptions, VoiceRealtimeChannelRoutesOptions, VoiceRealtimeChannelRuntimeSample, VoiceRealtimeChannelStatus } from './realtimeChannel';
 export { buildVoiceDiagnosticsMarkdown, createVoiceDiagnosticsRoutes, resolveVoiceDiagnosticsTraceFilter } from './diagnosticsRoutes';
 export { buildVoiceDemoReadyReport, createVoiceDemoReadyRoutes, renderVoiceDemoReadyHTML } from './demoReadyRoutes';

package/dist/index.js

@@ -10954,6 +10954,77 @@ var validateFormat = (label, actual, expected, issues) => {
     });
   }
 };
+var readString = (value) => typeof value === "string" && value.trim() ? value.trim() : undefined;
+var readNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
+var eventHasRealtimeAssistantProof = (event) => event.type === "turn.assistant" && (event.payload.realtimeConfigured === true || event.payload.mode === "realtime" || event.metadata?.realtime === true);
+var buildVoiceRealtimeChannelRuntimeSamplesFromTrace = (events, options = {}) => {
+  const format = options.format ?? DEFAULT_REALTIME_FORMAT2;
+  const source = options.source ?? "trace-store";
+  const samples = [];
+  const stagesByTurn = new Map;
+  for (const event of events) {
+    if (event.type !== "turn_latency.stage" || !event.turnId) {
+      continue;
+    }
+    const stage = readString(event.payload.stage);
+    if (!stage) {
+      continue;
+    }
+    const stages = stagesByTurn.get(event.turnId) ?? new Map;
+    stages.set(stage, event.at);
+    stagesByTurn.set(event.turnId, stages);
+  }
+  for (const event of [...events].sort((left, right) => left.at - right.at)) {
+    if (event.type === "turn.committed") {
+      samples.push({
+        format,
+        kind: "input-audio",
+        observedAt: event.at,
+        ok: true,
+        sessionId: event.sessionId,
+        source,
+        turnId: event.turnId
+      });
+      samples.push({
+        kind: "turn-commit",
+        observedAt: event.at,
+        ok: true,
+        sessionId: event.sessionId,
+        source,
+        turnId: event.turnId
+      });
+      continue;
+    }
+    if (eventHasRealtimeAssistantProof(event)) {
+      const stages = event.turnId ? stagesByTurn.get(event.turnId) : undefined;
+      const committedAt = stages?.get("turn_committed");
+      const audioAt = stages?.get("assistant_audio_received") ?? stages?.get("tts_send_completed") ?? stages?.get("assistant_text_started") ?? event.at;
+      const latencyMs = committedAt !== undefined ? Math.max(0, audioAt - committedAt) : readNumber(event.payload.elapsedMs);
+      samples.push({
+        format,
+        kind: "assistant-audio",
+        latencyMs,
+        observedAt: event.at,
+        ok: event.payload.status !== "realtime-send-failed",
+        sessionId: event.sessionId,
+        source,
+        turnId: event.turnId
+      });
+      continue;
+    }
+    if (event.type === "client.reconnect") {
+      samples.push({
+        kind: "reconnect",
+        observedAt: event.at,
+        ok: event.payload.status !== "failed",
+        sessionId: event.sessionId,
+        source,
+        turnId: event.turnId
+      });
+    }
+  }
+  return samples;
+};
 var buildVoiceRealtimeChannelReport = (options) => {
   const expectedInputFormat = options.expectedInputFormat ?? DEFAULT_REALTIME_FORMAT2;
   const expectedOutputFormat = options.expectedOutputFormat ?? expectedInputFormat;
@@ -11121,8 +11192,26 @@ var createVoiceRealtimeChannelRoutes = (options) => {
   const markdownPath = options.markdownPath ?? "/voice/realtime-channel.md";
   const headers = options.headers ?? {};
   const title = options.title ?? "Voice Realtime Channel Proof";
-  const report = () => buildVoiceRealtimeChannelReport(options);
-  const app = new Elysia9({ name: options.name ?? "voice-realtime-channel" }).get(path, () => new Response(JSON.stringify(report(), null, 2), {
+  const resolveOptions = async () => {
+    const source = typeof options.source === "function" ? await options.source() : options.source ?? options;
+    const {
+      headers: _headers,
+      htmlPath: _htmlPath,
+      markdownPath: _markdownPath,
+      name: _name,
+      path: _path,
+      render: _render,
+      source: _source,
+      title: _title,
+      ...reportOptions
+    } = {
+      ...options,
+      ...source
+    };
+    return reportOptions;
+  };
+  const report = async () => buildVoiceRealtimeChannelReport(await resolveOptions());
+  const app = new Elysia9({ name: options.name ?? "voice-realtime-channel" }).get(path, async () => new Response(JSON.stringify(await report(), null, 2), {
     headers: {
       "content-type": "application/json; charset=utf-8",
       ...headers
@@ -11130,7 +11219,7 @@ var createVoiceRealtimeChannelRoutes = (options) => {
   }));
   if (htmlPath !== false) {
     app.get(htmlPath, async () => {
-      const current = report();
+      const current = await report();
       const body = options.render ? await options.render(current) : renderVoiceRealtimeChannelHTML(current, title);
       return new Response(body, {
         headers: {
@@ -11141,7 +11230,7 @@ var createVoiceRealtimeChannelRoutes = (options) => {
     });
   }
   if (markdownPath !== false) {
-    app.get(markdownPath, () => new Response(renderVoiceRealtimeChannelMarkdown(report()), {
+    app.get(markdownPath, async () => new Response(renderVoiceRealtimeChannelMarkdown(await report()), {
       headers: {
         "content-type": "text/markdown; charset=utf-8",
         ...headers
@@ -34683,6 +34772,7 @@ export {
   buildVoiceTelephonyWebhookSecurityReport,
   buildVoiceSloReadinessThresholdReport,
   buildVoiceSloCalibrationReport,
+  buildVoiceRealtimeChannelRuntimeSamplesFromTrace,
   buildVoiceRealtimeChannelReport,
   buildVoiceProviderSloReport,
   buildVoiceProviderOrchestrationReport,

package/dist/realtimeChannel.d.ts

@@ -1,12 +1,16 @@
 import { Elysia } from 'elysia';
 import type { AudioFormat } from './types';
+import type { StoredVoiceTraceEvent } from './trace';
 export type VoiceRealtimeChannelStatus = 'fail' | 'pass' | 'warn';
 export type VoiceRealtimeChannelRuntimeSample = {
     format?: AudioFormat;
+    observedAt?: number;
     kind: 'assistant-audio' | 'browser-capture' | 'input-audio' | 'reconnect' | 'turn-commit';
     latencyMs?: number;
     ok?: boolean;
+    sessionId?: string;
     source?: string;
+    turnId?: string;
 };
 export type VoiceRealtimeChannelBrowserCapture = {
     audioContextSampleRateHz?: number;
@@ -78,8 +82,13 @@ export type VoiceRealtimeChannelRoutesOptions = VoiceRealtimeChannelReportOption
     name?: string;
     path?: string;
     render?: (report: VoiceRealtimeChannelReport) => Promise<string> | string;
+    source?: (() => Promise<VoiceRealtimeChannelReportOptions> | VoiceRealtimeChannelReportOptions) | VoiceRealtimeChannelReportOptions;
     title?: string;
 };
+export declare const buildVoiceRealtimeChannelRuntimeSamplesFromTrace: (events: readonly StoredVoiceTraceEvent[], options?: {
+    format?: AudioFormat;
+    source?: string;
+}) => VoiceRealtimeChannelRuntimeSample[];
 export declare const buildVoiceRealtimeChannelReport: (options: VoiceRealtimeChannelReportOptions) => VoiceRealtimeChannelReport;
 export declare const evaluateVoiceRealtimeChannelEvidence: (report: VoiceRealtimeChannelReport, input?: VoiceRealtimeChannelAssertionInput) => VoiceRealtimeChannelAssertionReport;
 export declare const assertVoiceRealtimeChannelEvidence: (report: VoiceRealtimeChannelReport, input?: VoiceRealtimeChannelAssertionInput) => VoiceRealtimeChannelAssertionReport;

package/package.json

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