@absolutejs/voice 0.0.22-beta.326 → 0.0.22-beta.327

package/dist/index.d.ts

@@ -16,10 +16,10 @@ export { assertVoiceRealtimeProviderContractEvidence, buildVoiceRealtimeProvider
 export type { VoiceRealtimeProviderContractAssertionInput, VoiceRealtimeProviderContractAssertionReport, VoiceRealtimeProviderContractCapability, VoiceRealtimeProviderContractCheck, VoiceRealtimeProviderContractDefinition, VoiceRealtimeProviderContractMatrixPresetOptions, VoiceRealtimeProviderContractMatrixInput, VoiceRealtimeProviderContractMatrixReport, VoiceRealtimeProviderContractRoutesOptions, VoiceRealtimeProviderContractRow, VoiceRealtimeProviderPresetProvider, VoiceRealtimeProviderContractStatus } from './realtimeProviderContracts';
 export { buildVoiceDiagnosticsMarkdown, createVoiceDiagnosticsRoutes, resolveVoiceDiagnosticsTraceFilter } from './diagnosticsRoutes';
 export { assertVoiceMediaPipelineEvidence, buildVoiceMediaPipelineReport, createVoiceMediaPipelineRoutes, evaluateVoiceMediaPipelineEvidence, renderVoiceMediaPipelineHTML, renderVoiceMediaPipelineMarkdown } from './mediaPipelineRoutes';
-export { buildVoiceTelephonyMediaReport, createVoiceTelephonyMediaRoutes, renderVoiceTelephonyMediaHTML } from './telephonyMediaRoutes';
+export { buildVoiceTelephonyMediaReport, createVoiceTelephonyMediaRoutes, getLatestVoiceTelephonyMediaReport, renderVoiceTelephonyMediaHTML } from './telephonyMediaRoutes';
 export { createVoiceBrowserMediaRoutes, getLatestVoiceBrowserMediaReport, renderVoiceBrowserMediaHTML, summarizeVoiceBrowserMedia } from './browserMediaRoutes';
 export type { VoiceMediaPipelineAssertionInput, VoiceMediaPipelineAssertionReport, VoiceMediaPipelineReport, VoiceMediaPipelineReportOptions, VoiceMediaPipelineRoutesOptions } from './mediaPipelineRoutes';
-export type { VoiceTelephonyMediaCarrierInput, VoiceTelephonyMediaCarrierReport, VoiceTelephonyMediaReport, VoiceTelephonyMediaRoutesOptions, VoiceTelephonyMediaStatus } from './telephonyMediaRoutes';
+export type { VoiceTelephonyMediaCarrierInput, VoiceTelephonyMediaCarrierReport, VoiceTelephonyMediaReport, VoiceTelephonyMediaRoutesOptions, VoiceTelephonyMediaTraceReportOptions, VoiceTelephonyMediaStatus } from './telephonyMediaRoutes';
 export type { VoiceBrowserMediaReport, VoiceBrowserMediaRoutesOptions, VoiceBrowserMediaSample, VoiceBrowserMediaStatus } from './browserMediaRoutes';
 export { buildVoiceDemoReadyReport, createVoiceDemoReadyRoutes, renderVoiceDemoReadyHTML } from './demoReadyRoutes';
 export { buildVoiceDeliverySinkReport, createVoiceDeliverySinkDescriptor, createVoiceDeliverySinkPair, createVoiceDeliverySinkRoutes, createVoiceFileDeliverySink, createVoicePostgresDeliverySink, createVoiceS3DeliverySink, createVoiceSQLiteDeliverySink, createVoiceWebhookDeliverySink, renderVoiceDeliverySinkHTML } from './deliverySinkRoutes';

package/dist/index.js

@@ -12666,6 +12666,32 @@ var buildVoiceTelephonyMediaReport = (input = {}) => {
     status: issues.length === 0 ? "pass" : "fail"
   };
 };
+var getLatestVoiceTelephonyMediaReport = async (options) => {
+  const events = (await options.store.list({ type: "client.telephony_media" })).filter((event) => {
+    const carrier = event.payload.carrier;
+    return typeof carrier === "string" && (!options.carriers || options.carriers.includes(carrier)) && event.payload.envelope && typeof event.payload.envelope === "object";
+  }).sort((left, right) => left.at - right.at);
+  if (events.length === 0) {
+    return;
+  }
+  const byCarrier = new Map;
+  for (const event of events) {
+    const carrier = event.payload.carrier;
+    const envelopes = byCarrier.get(carrier) ?? [];
+    envelopes.push(event.payload.envelope);
+    byCarrier.set(carrier, envelopes);
+  }
+  return buildVoiceTelephonyMediaReport({
+    carriers: [...byCarrier.entries()].map(([carrier, lifecycleEnvelopes]) => ({
+      carrier,
+      envelope: lifecycleEnvelopes.find((envelope) => {
+        const event = envelope.event;
+        return typeof event === "string" && event.toLowerCase() === "media";
+      }),
+      lifecycleEnvelopes
+    }))
+  });
+};
 var renderVoiceTelephonyMediaHTML = (report, options = {}) => {
   const title = options.title ?? "Voice Telephony Media Proof";
   const rows = report.carriers.map((carrier) => `<tr><td>${escapeHtml16(carrier.carrier)}</td><td>${escapeHtml16(carrier.status)}</td><td>${String(carrier.audioBytes)}</td><td>${String(carrier.lifecycle.mediaEvents)}</td><td>${escapeHtml16(carrier.lifecycle.started ? "yes" : "no")}</td><td>${escapeHtml16(carrier.lifecycle.stopped ? "yes" : "no")}</td><td>${escapeHtml16(carrier.frame?.kind ?? "missing")}</td><td>${escapeHtml16(carrier.frame?.format?.encoding ?? "missing")}</td><td>${escapeHtml16(carrier.issues.join(" ") || "none")}</td></tr>`).join("");
@@ -12677,10 +12703,14 @@ var createVoiceTelephonyMediaRoutes = (options = {}) => {
   const routes = new Elysia13({
     name: options.name ?? "absolutejs-voice-telephony-media"
   });
-  routes.get(path, () => buildVoiceTelephonyMediaReport({ carriers: options.carriers }));
+  routes.get(path, async () => options.store ? await getLatestVoiceTelephonyMediaReport({
+    store: options.store
+  }) ?? buildVoiceTelephonyMediaReport({ carriers: options.carriers }) : buildVoiceTelephonyMediaReport({ carriers: options.carriers }));
   if (htmlPath) {
-    routes.get(htmlPath, () => {
-      const report = buildVoiceTelephonyMediaReport({
+    routes.get(htmlPath, async () => {
+      const report = options.store ? await getLatestVoiceTelephonyMediaReport({
+        store: options.store
+      }) ?? buildVoiceTelephonyMediaReport({ carriers: options.carriers }) : buildVoiceTelephonyMediaReport({
         carriers: options.carriers
       });
       return new Response(renderVoiceTelephonyMediaHTML(report, options), {
@@ -21764,6 +21794,25 @@ var createTwilioMediaStreamBridge = (socket, options) => {
   };
   let sessionHandle = null;
   let reviewArtifactDelivered = false;
+  const telephonyMediaCarrier = options.telephonyMediaCarrier ?? "twilio";
+  const appendTelephonyMediaTrace = async (message, override) => {
+    const trace = options.trace;
+    const sessionId = override?.sessionId ?? bridgeState.sessionId ?? (message.event === "start" ? message.start.customParameters?.sessionId : undefined) ?? (message.event === "start" ? message.start.streamSid : "telephony-media");
+    const streamSid = override?.streamSid ?? (message.event === "start" ? message.start.streamSid : ("streamSid" in message) ? message.streamSid : undefined);
+    await trace?.append({
+      at: Date.now(),
+      payload: {
+        callSid: message.event === "start" ? message.start.callSid : message.event === "stop" ? message.stop?.callSid : bridgeState.callSid ?? undefined,
+        carrier: telephonyMediaCarrier,
+        envelope: message,
+        event: message.event,
+        streamId: streamSid
+      },
+      scenarioId: bridgeState.scenarioId ?? undefined,
+      sessionId,
+      type: "client.telephony_media"
+    });
+  };
   const resolveLexicon2 = async () => {
     if (typeof options.lexicon === "function") {
       return normalizeLexicon2(await options.lexicon({
@@ -21864,6 +21913,10 @@ var createTwilioMediaStreamBridge = (socket, options) => {
             reason: message.start.callSid,
             text: bridgeState.sessionId ?? undefined
           });
+          await appendTelephonyMediaTrace(message, {
+            sessionId: bridgeState.sessionId ?? undefined,
+            streamSid: bridgeState.streamSid ?? undefined
+          });
           await ensureSession();
           return;
         }
@@ -21884,6 +21937,10 @@ var createTwilioMediaStreamBridge = (socket, options) => {
             })));
           }
           bridgeState.hasOutboundAudioSinceLastInbound = false;
+          await appendTelephonyMediaTrace(message, {
+            sessionId: bridgeState.sessionId ?? undefined,
+            streamSid: bridgeState.streamSid ?? undefined
+          });
           await activeSession.receiveAudio(transcodeTwilioInboundPayloadToPCM16(message.media.payload));
           return;
         }
@@ -21898,6 +21955,10 @@ var createTwilioMediaStreamBridge = (socket, options) => {
             event: "stop",
             reason: message.stop?.callSid
           });
+          await appendTelephonyMediaTrace(message, {
+            sessionId: bridgeState.sessionId ?? undefined,
+            streamSid: bridgeState.streamSid ?? undefined
+          });
           await sessionHandle?.close("twilio-stop");
           return;
       }
@@ -22198,6 +22259,7 @@ var createPlivoTwilioSocketAdapter = (socket) => ({
 var createPlivoMediaStreamBridge = (socket, options) => {
   const bridge = createTwilioMediaStreamBridge(createPlivoTwilioSocketAdapter(socket), {
     ...options,
+    telephonyMediaCarrier: "plivo",
     onVoiceMessage: options.onVoiceMessage ? (input) => options.onVoiceMessage?.({
       callId: input.callSid,
       message: input.message,
@@ -22825,6 +22887,7 @@ var createTelnyxTwilioSocketAdapter = (socket) => ({
 var createTelnyxMediaStreamBridge = (socket, options) => {
   const bridge = createTwilioMediaStreamBridge(createTelnyxTwilioSocketAdapter(socket), {
     ...options,
+    telephonyMediaCarrier: "telnyx",
     onVoiceMessage: options.onVoiceMessage ? (input) => options.onVoiceMessage?.({
       callControlId: input.callSid,
       message: input.message,
@@ -35542,6 +35605,7 @@ export {
   hasVoiceOpsTaskSLABreach,
   getVoiceLiveOpsControlStatus,
   getVoiceCampaignDialerProofStatus,
+  getLatestVoiceTelephonyMediaReport,
   getLatestVoiceBrowserMediaReport,
   formatVoiceProofTrendAge,
   filterVoiceTraceEvents,

package/dist/telephony/twilio.d.ts

@@ -98,6 +98,7 @@ export type TwilioMediaStreamBridgeOptions<TContext = unknown, TSession extends
     scenarioId?: string;
     sessionId?: string;
     stt: STTAdapter;
+    telephonyMediaCarrier?: 'plivo' | 'telnyx' | 'twilio';
 };
 export type TwilioMediaStreamBridge = {
     close: (reason?: string) => Promise<void>;

package/dist/telephonyMediaRoutes.d.ts

@@ -1,5 +1,6 @@
 import { Elysia } from 'elysia';
 import type { MediaFrame, MediaTelephonyCarrier, MediaTelephonyEnvelope, MediaTelephonyStreamLifecycleReport } from '@absolutejs/media';
+import type { VoiceTraceEventStore } from './trace';
 export type VoiceTelephonyMediaStatus = 'fail' | 'pass';
 export type VoiceTelephonyMediaCarrierInput = {
     carrier: MediaTelephonyCarrier;
@@ -27,11 +28,17 @@ export type VoiceTelephonyMediaRoutesOptions = {
     htmlPath?: false | string;
     name?: string;
     path?: string;
+    store?: VoiceTraceEventStore;
     title?: string;
 };
+export type VoiceTelephonyMediaTraceReportOptions = {
+    carriers?: readonly MediaTelephonyCarrier[];
+    store: VoiceTraceEventStore;
+};
 export declare const buildVoiceTelephonyMediaReport: (input?: {
     carriers?: readonly VoiceTelephonyMediaCarrierInput[];
 }) => VoiceTelephonyMediaReport;
+export declare const getLatestVoiceTelephonyMediaReport: (options: VoiceTelephonyMediaTraceReportOptions) => Promise<VoiceTelephonyMediaReport | undefined>;
 export declare const renderVoiceTelephonyMediaHTML: (report: VoiceTelephonyMediaReport, options?: {
     title?: string;
 }) => string;

package/dist/testing/index.js

@@ -10202,6 +10202,25 @@ var createTwilioMediaStreamBridge = (socket, options) => {
   };
   let sessionHandle = null;
   let reviewArtifactDelivered = false;
+  const telephonyMediaCarrier = options.telephonyMediaCarrier ?? "twilio";
+  const appendTelephonyMediaTrace = async (message, override) => {
+    const trace = options.trace;
+    const sessionId = override?.sessionId ?? bridgeState.sessionId ?? (message.event === "start" ? message.start.customParameters?.sessionId : undefined) ?? (message.event === "start" ? message.start.streamSid : "telephony-media");
+    const streamSid = override?.streamSid ?? (message.event === "start" ? message.start.streamSid : ("streamSid" in message) ? message.streamSid : undefined);
+    await trace?.append({
+      at: Date.now(),
+      payload: {
+        callSid: message.event === "start" ? message.start.callSid : message.event === "stop" ? message.stop?.callSid : bridgeState.callSid ?? undefined,
+        carrier: telephonyMediaCarrier,
+        envelope: message,
+        event: message.event,
+        streamId: streamSid
+      },
+      scenarioId: bridgeState.scenarioId ?? undefined,
+      sessionId,
+      type: "client.telephony_media"
+    });
+  };
   const resolveLexicon = async () => {
     if (typeof options.lexicon === "function") {
       return normalizeLexicon(await options.lexicon({
@@ -10302,6 +10321,10 @@ var createTwilioMediaStreamBridge = (socket, options) => {
             reason: message.start.callSid,
             text: bridgeState.sessionId ?? undefined
           });
+          await appendTelephonyMediaTrace(message, {
+            sessionId: bridgeState.sessionId ?? undefined,
+            streamSid: bridgeState.streamSid ?? undefined
+          });
           await ensureSession();
           return;
         }
@@ -10322,6 +10345,10 @@ var createTwilioMediaStreamBridge = (socket, options) => {
             })));
           }
           bridgeState.hasOutboundAudioSinceLastInbound = false;
+          await appendTelephonyMediaTrace(message, {
+            sessionId: bridgeState.sessionId ?? undefined,
+            streamSid: bridgeState.streamSid ?? undefined
+          });
           await activeSession.receiveAudio(transcodeTwilioInboundPayloadToPCM16(message.media.payload));
           return;
         }
@@ -10336,6 +10363,10 @@ var createTwilioMediaStreamBridge = (socket, options) => {
             event: "stop",
             reason: message.stop?.callSid
           });
+          await appendTelephonyMediaTrace(message, {
+            sessionId: bridgeState.sessionId ?? undefined,
+            streamSid: bridgeState.streamSid ?? undefined
+          });
           await sessionHandle?.close("twilio-stop");
           return;
       }

package/dist/trace.d.ts

@@ -1,5 +1,5 @@
 import type { S3Client, S3Options } from 'bun';
-export type VoiceTraceEventType = 'assistant.guardrail' | 'assistant.memory' | 'assistant.run' | 'agent.context' | 'agent.handoff' | 'agent.model' | 'agent.result' | 'agent.tool' | 'call.handoff' | 'call.lifecycle' | 'client.barge_in' | 'client.browser_media' | 'client.live_latency' | 'client.reconnect' | 'operator.action' | 'provider.decision' | '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.context' | 'agent.handoff' | 'agent.model' | 'agent.result' | 'agent.tool' | 'call.handoff' | 'call.lifecycle' | 'client.barge_in' | 'client.browser_media' | 'client.live_latency' | 'client.reconnect' | 'client.telephony_media' | 'operator.action' | 'provider.decision' | '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.326",
+	"version": "0.0.22-beta.327",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",