@absolutejs/voice 0.0.22-beta.325 → 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,
@@ -30278,6 +30341,21 @@ var buildOperationsRecordLinks = (input) => {
     sessionId,
     status: "fail"
   })) : [];
+  const telephonyMedia = input.telephonyMedia && input.telephonyMedia.status !== "pass" ? input.telephonyMedia.carriers.filter((carrier) => carrier.status !== "pass").flatMap((carrier) => {
+    const sessionIds = [
+      ...carrier.lifecycle.streamIds,
+      carrier.frame?.sessionId
+    ].filter((value, index, values) => typeof value === "string" && value.length > 0 && values.indexOf(value) === index);
+    const fallbackSessionId = `${carrier.carrier}-telephony-media`;
+    const ids = sessionIds.length > 0 ? sessionIds : [fallbackSessionId];
+    return ids.map((sessionId) => ({
+      detail: carrier.issues[0] ?? `${carrier.lifecycle.issues.length} telephony media lifecycle issue(s)`,
+      href: voiceOperationsRecordHref(input.base, sessionId),
+      label: "Open telephony media operations record",
+      sessionId,
+      status: "fail"
+    }));
+  }) : [];
   return {
     failedSessions: input.failedSessionIds.map((sessionId) => ({
       href: voiceOperationsRecordHref(input.base, sessionId),
@@ -30287,7 +30365,8 @@ var buildOperationsRecordLinks = (input) => {
     })),
     failingLatency,
     mediaQuality,
-    providerErrors
+    providerErrors,
+    telephonyMedia
   };
 };
 var firstOperationsRecordHref = (links) => links[0]?.href;
@@ -30388,7 +30467,8 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     liveLatencyFailAfterMs: options.liveLatencyFailAfterMs ?? 3200,
     liveLatencyMaxAgeMs: options.liveLatencyMaxAgeMs,
     liveLatencyWarnAfterMs: options.liveLatencyWarnAfterMs ?? 1800,
-    mediaPipeline
+    mediaPipeline,
+    telephonyMedia
   });
   const checks = [
     {
@@ -30671,11 +30751,11 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     const firstIssue = telephonyMedia.issues[0];
     checks.push({
       detail: telephonyMediaSummary.status === "pass" ? `Telephony media serializers are passing for ${telephonyMediaSummary.passed}/${telephonyMediaSummary.carriers} carrier(s) with ${telephonyMediaSummary.audioBytes} audio byte(s), ${telephonyMediaSummary.mediaEvents} media event(s), and valid start/media/stop lifecycle sequencing.` : firstIssue ?? `${telephonyMediaSummary.issues} telephony media serializer issue(s) need review.`,
-      href: options.links?.telephonyMedia ?? "/voice/telephony-media",
+      href: firstOperationsRecordHref(operationsRecords.telephonyMedia) ?? options.links?.telephonyMedia ?? "/voice/telephony-media",
       label: "Telephony media serializers",
       proofSource: proofSource("telephonyMedia", "carrierMediaSerializers"),
       gateExplanation: telephonyMediaSummary.status === "pass" ? undefined : {
-        evidenceHref: options.links?.telephonyMedia ?? "/voice/telephony-media",
+        evidenceHref: firstOperationsRecordHref(operationsRecords.telephonyMedia) ?? options.links?.telephonyMedia ?? "/voice/telephony-media",
         observed: firstIssue ?? `${telephonyMediaSummary.issues} issue(s)`,
         remediation: "Inspect carrier media proof, fix start/media/stop sequencing, payload parsing, byte flow, or outbound envelope serialization, then rerun readiness proof.",
         thresholdLabel: "Telephony media serializer and lifecycle status",
@@ -30684,6 +30764,13 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       status: telephonyMediaSummary.status,
       value: telephonyMediaSummary.status === "pass" ? `${telephonyMediaSummary.passed}/${telephonyMediaSummary.carriers}` : `${telephonyMediaSummary.failed}/${telephonyMediaSummary.carriers} failing`,
       actions: telephonyMediaSummary.status === "pass" ? [] : [
+        ...firstOperationsRecordHref(operationsRecords.telephonyMedia) ? [
+          {
+            description: "Open the exact call/session operations record for the first telephony media lifecycle issue.",
+            href: firstOperationsRecordHref(operationsRecords.telephonyMedia),
+            label: "Open telephony media operations record"
+          }
+        ] : [],
         {
           description: "Open telephony media proof and inspect carrier media lifecycle sequencing, payload parsing, MediaFrame shape, byte flow, and outbound envelope serialization.",
           href: options.links?.telephonyMedia ?? "/voice/telephony-media",
@@ -35518,6 +35605,7 @@ export {
   hasVoiceOpsTaskSLABreach,
   getVoiceLiveOpsControlStatus,
   getVoiceCampaignDialerProofStatus,
+  getLatestVoiceTelephonyMediaReport,
   getLatestVoiceBrowserMediaReport,
   formatVoiceProofTrendAge,
   filterVoiceTraceEvents,

package/dist/productionReadiness.d.ts

@@ -351,6 +351,7 @@ export type VoiceProductionReadinessOperationsRecordLinks = {
     failingLatency: VoiceProductionReadinessOperationsRecordLink[];
     mediaQuality: VoiceProductionReadinessOperationsRecordLink[];
     providerErrors: VoiceProductionReadinessOperationsRecordLink[];
+    telephonyMedia: VoiceProductionReadinessOperationsRecordLink[];
 };
 export type VoiceProductionReadinessAuditRequirement = {
     label?: string;

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

@@ -118,6 +118,13 @@ export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceR
                 readonly sessionId: string;
                 readonly status: import("..").VoiceProductionReadinessStatus;
             }[];
+            readonly telephonyMedia: readonly {
+                readonly detail?: string | undefined;
+                readonly href: string;
+                readonly label: string;
+                readonly sessionId: string;
+                readonly status: import("..").VoiceProductionReadinessStatus;
+            }[];
         } | undefined;
         readonly status: import("..").VoiceProductionReadinessStatus;
         readonly summary: {
@@ -543,6 +550,13 @@ export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceR
                 readonly sessionId: string;
                 readonly status: import("..").VoiceProductionReadinessStatus;
             }[];
+            readonly telephonyMedia: readonly {
+                readonly detail?: string | undefined;
+                readonly href: string;
+                readonly label: string;
+                readonly sessionId: string;
+                readonly status: import("..").VoiceProductionReadinessStatus;
+            }[];
         } | undefined;
         readonly status: import("..").VoiceProductionReadinessStatus;
         readonly summary: {

package/package.json

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