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

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';
@@ -141,7 +141,7 @@ export type { VoiceProductionReadinessAction, VoiceProductionReadinessAuditOptio
 export type { VoiceMonitorDefinition, VoiceMonitorEvaluation, VoiceMonitorEvaluationInput, VoiceMonitorIssue, VoiceMonitorIssueStatus, VoiceMonitorIssueStore, VoiceMonitorNotifier, VoiceMonitorNotifierDeliveryInput, VoiceMonitorNotifierDeliveryOptions, VoiceMonitorNotifierDeliveryReceipt, VoiceMonitorNotifierDeliveryReceiptStore, VoiceMonitorNotifierDeliveryReport, VoiceMonitorNotifierDeliveryResult, VoiceMonitorRoutesOptions, VoiceMonitorRun, VoiceMonitorRunOptions, VoiceMonitorRunReport, VoiceMonitorRunner, VoiceMonitorRunnerOptions, VoiceMonitorRunnerRoutesOptions, VoiceMonitorRunnerTickResult, VoiceMonitorSeverity, VoiceMonitorStatus, VoiceMonitorWebhookNotifierOptions } from './voiceMonitoring';
 export type { VoiceReadinessProfileName, VoiceReadinessProfileOptions, VoiceReadinessProfileRecommendation, VoiceReadinessProfileRecommendationScore, VoiceReadinessProfileRoutesOptions } from './readinessProfiles';
 export type { VoiceProviderStackChoice, VoiceProviderStackCapabilities, VoiceProviderStackCapabilityGap, VoiceProviderStackCapabilityGapInput, VoiceProviderStackCapabilityGapReport, VoiceProviderContractCheck, VoiceProviderContractCheckStatus, VoiceProviderContractDefinition, VoiceProviderContractMatrixAssertionInput, VoiceProviderContractMatrixAssertionReport, VoiceProviderContractMatrixHandlerOptions, VoiceProviderContractMatrixHTMLHandlerOptions, VoiceProviderContractMatrixInput, VoiceProviderContractMatrixPresetOptions, VoiceProviderContractMatrixReport, VoiceProviderContractMatrixRoutesOptions, VoiceProviderContractMatrixRow, VoiceProviderStackAssertionInput, VoiceProviderStackAssertionReport, VoiceProviderStackInput, VoiceProviderStackKind, VoiceProviderStackRecommendation } from './providerStackRecommendations';
-export type { VoiceOperationsRecord, VoiceOperationsRecordAgentHandoff, VoiceOperationsRecordAuditSummary, VoiceOperationsRecordGuardrailAssertionInput, VoiceOperationsRecordGuardrailAssertionReport, VoiceOperationsRecordGuardrailDecision, VoiceOperationsRecordGuardrailFinding, VoiceOperationsRecordGuardrailSummary, VoiceOperationsRecordIntegrationEventSummary, VoiceOperationsRecordOptions, VoiceOperationsRecordOutcome, VoiceOperationsRecordProviderDecision, VoiceOperationsRecordProviderDecisionRecoveryStatus, VoiceOperationsRecordProviderDecisionSummary, VoiceOperationsRecordProviderRecoveryAssertionInput, VoiceOperationsRecordProviderRecoveryAssertionReport, VoiceOperationsRecordReviewSummary, VoiceOperationsRecordRoutesOptions, VoiceOperationsRecordStatus, VoiceOperationsRecordTaskSummary, VoiceOperationsRecordTranscriptTurn, VoiceOperationsRecordTool } from './operationsRecord';
+export type { VoiceOperationsRecord, VoiceOperationsRecordAgentHandoff, VoiceOperationsRecordAuditSummary, VoiceOperationsRecordGuardrailAssertionInput, VoiceOperationsRecordGuardrailAssertionReport, VoiceOperationsRecordGuardrailDecision, VoiceOperationsRecordGuardrailFinding, VoiceOperationsRecordGuardrailSummary, VoiceOperationsRecordIntegrationEventSummary, VoiceOperationsRecordOptions, VoiceOperationsRecordOutcome, VoiceOperationsRecordProviderDecision, VoiceOperationsRecordProviderDecisionRecoveryStatus, VoiceOperationsRecordProviderDecisionSummary, VoiceOperationsRecordProviderRecoveryAssertionInput, VoiceOperationsRecordProviderRecoveryAssertionReport, VoiceOperationsRecordReviewSummary, VoiceOperationsRecordRoutesOptions, VoiceOperationsRecordStatus, VoiceOperationsRecordTaskSummary, VoiceOperationsRecordTelephonyMediaEvent, VoiceOperationsRecordTelephonyMediaSummary, VoiceOperationsRecordTranscriptTurn, VoiceOperationsRecordTool } from './operationsRecord';
 export type { VoiceObservabilityExportArtifact, VoiceObservabilityExportArtifactChecksum, VoiceObservabilityExportArtifactFreshness, VoiceObservabilityExportArtifactIndex, VoiceObservabilityExportArtifactIndexItem, VoiceObservabilityExportArtifactKind, VoiceObservabilityExportDeliveryAssertionInput, VoiceObservabilityExportDeliveryAssertionReport, VoiceObservabilityExportDeliverySummary, VoiceObservabilityExportDeliveryDestination, VoiceObservabilityExportDeliveryDestinationResult, VoiceObservabilityExportDeliveryHistory, VoiceObservabilityExportDeliveryOptions, VoiceObservabilityExportDeliveryReceipt, VoiceObservabilityExportDeliveryReceiptStore, VoiceObservabilityExportDeliveryReport, VoiceObservabilityExportEnvelope, VoiceObservabilityExportIssue, VoiceObservabilityExportIssueCode, VoiceObservabilityExportOptions, VoiceObservabilityExportIngestedRecordKind, VoiceObservabilityExportRedactionSummary, VoiceObservabilityExportRecordValidationOptions, VoiceObservabilityExportReplayIssue, VoiceObservabilityExportReplayIssueCode, VoiceObservabilityExportReplayAssertionInput, VoiceObservabilityExportReplayAssertionReport, VoiceObservabilityExportReplayRecords, VoiceObservabilityExportReplayReport, VoiceObservabilityExportReplayRoutesOptions, VoiceObservabilityExportReplaySource, VoiceObservabilityExportReport, VoiceObservabilityExportRoutesOptions, VoiceObservabilityExportSchema, VoiceObservabilityExportStatus, VoiceObservabilityExportValidationIssue, VoiceObservabilityExportValidationResult } from './observabilityExport';
 export type { VoiceOpsRecoveryFailedSession, VoiceOpsRecoveryInterventionSummary, VoiceOpsRecoveryIssue, VoiceOpsRecoveryIssueCode, VoiceOpsRecoveryLinks, VoiceOpsRecoveryProviderSummary, VoiceOpsRecoveryReport, VoiceOpsRecoveryReportOptions, VoiceOpsRecoveryRoutesOptions, VoiceOpsRecoveryStatus } from './opsRecovery';
 export type { StoredVoiceIncidentBundleArtifact, VoiceIncidentBundle, VoiceIncidentBundleArtifactOptions, VoiceIncidentBundleFormat, VoiceIncidentBundleOptions, VoiceIncidentBundleRetentionOptions, VoiceIncidentBundleRetentionReport, VoiceIncidentBundleRoutesOptions, VoiceIncidentBundleStore, VoiceIncidentBundleStoreFilter, VoiceIncidentBundleSummary } from './incidentBundle';

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,
@@ -27702,6 +27765,7 @@ var createVoiceTraceTimelineRoutes = (options) => {
 var getString17 = (value) => typeof value === "string" ? value : undefined;
 var getNumber10 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
 var getBoolean3 = (value) => typeof value === "boolean" ? value : undefined;
+var getRecord = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : undefined;
 var countOutcome = (events, outcome) => events.filter((event) => event.outcome === outcome).length;
 var matchesSessionScopedId = (id, sessionId) => id === sessionId || id.startsWith(`${sessionId}:`);
 var hasPayloadValue = (payload, key, values) => {
@@ -27760,6 +27824,56 @@ var toGuardrailDecision = (event) => ({
   toolName: getString17(event.payload.toolName),
   turnId: event.turnId
 });
+var decodeBase64Bytes = (value) => {
+  if (typeof value !== "string") {
+    return 0;
+  }
+  try {
+    return Buffer.from(value, "base64").byteLength;
+  } catch {
+    return 0;
+  }
+};
+var toTelephonyMediaEvent = (event) => {
+  if (event.type !== "client.telephony_media") {
+    return;
+  }
+  const envelope = getRecord(event.payload.envelope);
+  const start = getRecord(envelope?.start);
+  const media = getRecord(envelope?.media);
+  const stop = getRecord(envelope?.stop);
+  const error = getRecord(envelope?.error);
+  const eventName = getString17(event.payload.event) ?? getString17(envelope?.event) ?? getString17(event.payload.kind) ?? "unknown";
+  const streamId = getString17(event.payload.streamId) ?? getString17(envelope?.streamSid) ?? getString17(start?.streamSid);
+  const callSid = getString17(event.payload.callSid) ?? getString17(start?.callSid) ?? getString17(stop?.callSid);
+  const sequenceNumber = getString17(media?.sequenceNumber) ?? getString17(envelope?.sequenceNumber);
+  const direction = getString17(media?.track) ?? getString17(media?.direction) ?? getString17(event.payload.direction);
+  return {
+    at: event.at,
+    audioBytes: getNumber10(event.payload.audioBytes) ?? getNumber10(media?.audioBytes) ?? decodeBase64Bytes(media?.payload),
+    callSid,
+    carrier: getString17(event.payload.carrier),
+    direction,
+    event: eventName,
+    sequenceNumber,
+    streamId
+  };
+};
+var summarizeTelephonyMedia = (events) => {
+  const mediaEvents = events.map(toTelephonyMediaEvent).filter((event) => event !== undefined);
+  const eventNames = mediaEvents.map((event) => event.event.toLowerCase());
+  return {
+    audioBytes: mediaEvents.reduce((total, event) => total + event.audioBytes, 0),
+    carriers: uniqueSorted8(mediaEvents.map((event) => event.carrier)),
+    errors: eventNames.filter((event) => event === "error").length,
+    events: mediaEvents,
+    media: eventNames.filter((event) => event === "media").length,
+    starts: eventNames.filter((event) => event === "start").length,
+    stops: eventNames.filter((event) => event === "stop").length,
+    streamIds: uniqueSorted8(mediaEvents.map((event) => event.streamId)),
+    total: mediaEvents.length
+  };
+};
 var summarizeGuardrails = (events) => {
   const decisions = events.filter((event) => event.type === "assistant.guardrail").map(toGuardrailDecision);
   const isBlocked = (decision) => decision.allowed === false || decision.status === "fail";
@@ -27907,6 +28021,7 @@ var buildVoiceOperationsRecord = async (options) => {
       tasks,
       total: tasks.length
     } : undefined,
+    telephonyMedia: summarizeTelephonyMedia(traceEvents),
     timeline: timelineSession?.events ?? [],
     tools: traceEvents.filter((event) => event.type === "agent.tool").map(toTool),
     traceEvents,
@@ -28111,6 +28226,27 @@ var renderVoiceOperationsRecordIncidentMarkdown = (record) => {
     `degraded=${String(providerDecisionSummary.degraded)}`,
     `errors=${String(providerDecisionSummary.errors)}`
   ].join("; ");
+  const telephonyMediaLine = [
+    `events=${String(record.telephonyMedia.total)}`,
+    `starts=${String(record.telephonyMedia.starts)}`,
+    `media=${String(record.telephonyMedia.media)}`,
+    `stops=${String(record.telephonyMedia.stops)}`,
+    `errors=${String(record.telephonyMedia.errors)}`,
+    `audioBytes=${String(record.telephonyMedia.audioBytes)}`,
+    `carriers=${record.telephonyMedia.carriers.join(", ") || "none"}`,
+    `streams=${record.telephonyMedia.streamIds.join(", ") || "none"}`
+  ].join("; ");
+  const telephonyMediaLines = record.telephonyMedia.events.length ? record.telephonyMedia.events.slice(0, 12).map((event) => {
+    const parts = [
+      event.carrier ? `carrier=${event.carrier}` : undefined,
+      event.streamId ? `stream=${event.streamId}` : undefined,
+      event.callSid ? `call=${event.callSid}` : undefined,
+      event.direction ? `direction=${event.direction}` : undefined,
+      event.sequenceNumber ? `seq=${event.sequenceNumber}` : undefined,
+      `audioBytes=${String(event.audioBytes)}`
+    ].filter((part) => typeof part === "string");
+    return `- ${event.event}: ${parts.join("; ")}`;
+  }) : ["- none recorded"];
   return [
     `# Voice incident handoff: ${record.sessionId}`,
     "",
@@ -28124,11 +28260,16 @@ var renderVoiceOperationsRecordIncidentMarkdown = (record) => {
     `- Top errors: ${topErrors.join("; ") || "none"}`,
     `- Guardrails: ${String(record.guardrails.blocked)} blocked / ${String(record.guardrails.warned)} warned / ${String(record.guardrails.total)} decisions`,
     `- Provider recovery: ${providerRecoveryLine}`,
+    `- Telephony media: ${telephonyMediaLine}`,
     "",
     "## Provider decisions",
     "",
     ...providerDecisionLines,
     "",
+    "## Telephony media",
+    "",
+    ...telephonyMediaLines,
+    "",
     renderVoiceOperationsRecordGuardrailMarkdown(record),
     "",
     "## Next checks",
@@ -28171,6 +28312,17 @@ var renderVoiceOperationsRecordHTML = (record, options = {}) => {
     const findings = decision.findings.map((finding) => finding.label ?? finding.ruleId ?? finding.action).filter((value) => typeof value === "string").join(", ") || "none";
     return `<li><strong>assistant.guardrail ${escapeHtml48(decision.stage ?? "unknown")}</strong> <span>${escapeHtml48(decision.status ?? "")}</span><p>Allowed: ${escapeHtml48(String(decision.allowed ?? "unknown"))} \xB7 Proof: ${escapeHtml48(decision.proof ?? "runtime")}${decision.turnId ? ` \xB7 Turn: ${escapeHtml48(decision.turnId)}` : ""}</p><p>${escapeHtml48(findings)}</p></li>`;
   }).join("") : "<li>No assistant.guardrail events recorded.</li>";
+  const telephonyMedia = record.telephonyMedia.events.length ? record.telephonyMedia.events.slice(0, 50).map((event) => {
+    const details = [
+      event.carrier ? `Carrier: ${event.carrier}` : undefined,
+      event.streamId ? `Stream: ${event.streamId}` : undefined,
+      event.callSid ? `Call: ${event.callSid}` : undefined,
+      event.direction ? `Direction: ${event.direction}` : undefined,
+      event.sequenceNumber ? `Seq: ${event.sequenceNumber}` : undefined,
+      `Audio bytes: ${String(event.audioBytes)}`
+    ].filter((detail) => typeof detail === "string");
+    return `<li><strong>${escapeHtml48(event.event)}</strong> <span>${escapeHtml48(new Date(event.at).toLocaleString())}</span><p>${escapeHtml48(details.join(" \xB7 "))}</p></li>`;
+  }).join("") : "<li>No telephony media trace events recorded.</li>";
   const snippet = escapeHtml48(`app.use(
 	createVoiceOperationsRecordRoutes({
 		audit: auditStore,
@@ -28187,7 +28339,7 @@ var renderVoiceOperationsRecordHTML = (record, options = {}) => {
 );`);
   const incidentMarkdown = escapeHtml48(renderVoiceOperationsRecordIncidentMarkdown(record));
   const incidentLink = options.incidentHref ? `<a href="${escapeHtml48(options.incidentHref)}">Download incident.md</a>` : "";
-  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml48(options.title ?? "Voice Operations Record")}</title><style>body{background:#101417;color:#f9f4e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.eyebrow{color:#fbbf24;font-size:.8rem;font-weight:900;letter-spacing:.14em;text-transform:uppercase}h1{font-size:clamp(2.4rem,6vw,4.8rem);line-height:.9;margin:.2rem 0 1rem}.status{border:1px solid #475569;border-radius:999px;display:inline-flex;padding:8px 12px}.healthy{color:#86efac}.warning{color:#fbbf24}.failed,.error{color:#fca5a5}.grid{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));margin:20px 0}.card,.primitive{background:#182025;border:1px solid #2d3a43;border-radius:20px;padding:16px}.card span,.muted,.label{color:#a9b4bd}.label{display:block;font-size:.72rem;font-weight:900;letter-spacing:.12em;text-transform:uppercase}.card strong{display:block;font-size:2rem}section{margin-top:28px}article{display:grid;gap:8px}ul{display:grid;gap:10px;list-style:none;padding:0}li{background:#182025;border:1px solid #2d3a43;border-radius:16px;padding:14px}pre{background:#080d10;border:1px solid #2d3a43;border-radius:16px;color:#dbeafe;overflow:auto;padding:14px}.hero-actions{display:flex;flex-wrap:wrap;gap:10px;margin-top:16px}.hero-actions a{background:#fbbf24;border-radius:999px;color:#111827;font-weight:900;padding:10px 14px;text-decoration:none}.two-column{display:grid;gap:18px;grid-template-columns:minmax(0,1.15fr) minmax(280px,.85fr)}@media(max-width:860px){main{padding:20px}.two-column{grid-template-columns:1fr}}</style></head><body><main><p class="eyebrow">Call log replacement</p><h1>${escapeHtml48(options.title ?? "Voice Operations Record")}</h1><p class="status ${escapeHtml48(record.status)}">${escapeHtml48(record.status)}</p><div class="hero-actions"><a href="#transcript">Transcript</a><a href="#provider-decisions">Provider decisions</a><a href="#guardrails">Guardrails</a><a href="#incident-handoff">Incident handoff</a>${incidentLink}</div><section class="grid"><div class="card"><span>Events</span><strong>${String(record.summary.eventCount)}</strong></div><div class="card"><span>Turns</span><strong>${String(record.summary.turnCount)}</strong></div><div class="card"><span>Errors</span><strong>${String(record.summary.errorCount)}</strong></div><div class="card"><span>Duration</span><strong>${formatMs5(record.summary.callDurationMs)}</strong></div><div class="card"><span>Provider recovery</span><strong>${escapeHtml48(providerDecisionSummary.recoveryStatus)}</strong><span>${String(providerDecisionSummary.fallbacks)} fallback / ${String(providerDecisionSummary.degraded)} degraded / ${String(providerDecisionSummary.errors)} errors</span></div><div class="card"><span>Guardrails</span><strong>${String(record.guardrails.blocked)}</strong></div><div class="card"><span>Audit</span><strong>${String(record.audit?.total ?? 0)}</strong></div><div class="card"><span>Reviews</span><strong>${String(record.reviews?.total ?? 0)}</strong></div><div class="card"><span>Tasks</span><strong>${String(record.tasks?.total ?? 0)}</strong></div><div class="card"><span>Integrations</span><strong>${String(record.integrationEvents?.total ?? 0)}</strong></div></section><section class="two-column"><div><h2 id="transcript">Transcript</h2><ul>${transcript}</ul></div><div><h2 id="provider-decisions">Provider Decisions</h2><ul>${providerDecisions}</ul></div></section><section id="guardrails"><h2>Guardrail Evidence</h2><p class="muted">Live <code>assistant.guardrail</code> decisions attached to this session.</p><ul>${guardrails}</ul></section><section id="incident-handoff"><h2>Copyable Incident Handoff</h2><p class="muted">Paste this into Slack, Linear, Zendesk, or an incident review. ${incidentLink}</p><pre><code>${incidentMarkdown}</code></pre></section><section class="primitive"><p class="eyebrow">Copy into your app</p><h2><code>createVoiceOperationsRecordRoutes(...)</code> gives every call one debuggable object</h2><p class="muted">Use this as the support/debug payload across traces, provider routing, tools, handoffs, guardrails, audit, latency, replay, reviews, tasks, and webhook delivery.</p><pre><code>${snippet}</code></pre></section><section><h2>Provider Summary</h2><div class="grid">${providers}</div></section><section><h2>Handoffs</h2><ul>${handoffs}</ul></section><section><h2>Tools</h2><ul>${tools}</ul></section><section><h2>Reviews</h2><ul>${reviews}</ul></section><section><h2>Tasks</h2><ul>${tasks}</ul></section><section><h2>Integration Events</h2><ul>${integrationEvents}</ul></section></main></body></html>`;
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml48(options.title ?? "Voice Operations Record")}</title><style>body{background:#101417;color:#f9f4e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.eyebrow{color:#fbbf24;font-size:.8rem;font-weight:900;letter-spacing:.14em;text-transform:uppercase}h1{font-size:clamp(2.4rem,6vw,4.8rem);line-height:.9;margin:.2rem 0 1rem}.status{border:1px solid #475569;border-radius:999px;display:inline-flex;padding:8px 12px}.healthy{color:#86efac}.warning{color:#fbbf24}.failed,.error{color:#fca5a5}.grid{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));margin:20px 0}.card,.primitive{background:#182025;border:1px solid #2d3a43;border-radius:20px;padding:16px}.card span,.muted,.label{color:#a9b4bd}.label{display:block;font-size:.72rem;font-weight:900;letter-spacing:.12em;text-transform:uppercase}.card strong{display:block;font-size:2rem}section{margin-top:28px}article{display:grid;gap:8px}ul{display:grid;gap:10px;list-style:none;padding:0}li{background:#182025;border:1px solid #2d3a43;border-radius:16px;padding:14px}pre{background:#080d10;border:1px solid #2d3a43;border-radius:16px;color:#dbeafe;overflow:auto;padding:14px}.hero-actions{display:flex;flex-wrap:wrap;gap:10px;margin-top:16px}.hero-actions a{background:#fbbf24;border-radius:999px;color:#111827;font-weight:900;padding:10px 14px;text-decoration:none}.two-column{display:grid;gap:18px;grid-template-columns:minmax(0,1.15fr) minmax(280px,.85fr)}@media(max-width:860px){main{padding:20px}.two-column{grid-template-columns:1fr}}</style></head><body><main><p class="eyebrow">Call log replacement</p><h1>${escapeHtml48(options.title ?? "Voice Operations Record")}</h1><p class="status ${escapeHtml48(record.status)}">${escapeHtml48(record.status)}</p><div class="hero-actions"><a href="#transcript">Transcript</a><a href="#provider-decisions">Provider decisions</a><a href="#telephony-media">Telephony media</a><a href="#guardrails">Guardrails</a><a href="#incident-handoff">Incident handoff</a>${incidentLink}</div><section class="grid"><div class="card"><span>Events</span><strong>${String(record.summary.eventCount)}</strong></div><div class="card"><span>Turns</span><strong>${String(record.summary.turnCount)}</strong></div><div class="card"><span>Errors</span><strong>${String(record.summary.errorCount)}</strong></div><div class="card"><span>Duration</span><strong>${formatMs5(record.summary.callDurationMs)}</strong></div><div class="card"><span>Provider recovery</span><strong>${escapeHtml48(providerDecisionSummary.recoveryStatus)}</strong><span>${String(providerDecisionSummary.fallbacks)} fallback / ${String(providerDecisionSummary.degraded)} degraded / ${String(providerDecisionSummary.errors)} errors</span></div><div class="card"><span>Telephony media</span><strong>${String(record.telephonyMedia.media)}</strong><span>${String(record.telephonyMedia.starts)} start / ${String(record.telephonyMedia.stops)} stop / ${String(record.telephonyMedia.errors)} errors</span></div><div class="card"><span>Guardrails</span><strong>${String(record.guardrails.blocked)}</strong></div><div class="card"><span>Audit</span><strong>${String(record.audit?.total ?? 0)}</strong></div><div class="card"><span>Reviews</span><strong>${String(record.reviews?.total ?? 0)}</strong></div><div class="card"><span>Tasks</span><strong>${String(record.tasks?.total ?? 0)}</strong></div><div class="card"><span>Integrations</span><strong>${String(record.integrationEvents?.total ?? 0)}</strong></div></section><section class="two-column"><div><h2 id="transcript">Transcript</h2><ul>${transcript}</ul></div><div><h2 id="provider-decisions">Provider Decisions</h2><ul>${providerDecisions}</ul></div></section><section id="telephony-media"><h2>Telephony Media</h2><p class="muted">Live <code>client.telephony_media</code> stream lifecycle evidence attached to this session. Carriers: ${escapeHtml48(record.telephonyMedia.carriers.join(", ") || "none")}. Streams: ${escapeHtml48(record.telephonyMedia.streamIds.join(", ") || "none")}.</p><ul>${telephonyMedia}</ul></section><section id="guardrails"><h2>Guardrail Evidence</h2><p class="muted">Live <code>assistant.guardrail</code> decisions attached to this session.</p><ul>${guardrails}</ul></section><section id="incident-handoff"><h2>Copyable Incident Handoff</h2><p class="muted">Paste this into Slack, Linear, Zendesk, or an incident review. ${incidentLink}</p><pre><code>${incidentMarkdown}</code></pre></section><section class="primitive"><p class="eyebrow">Copy into your app</p><h2><code>createVoiceOperationsRecordRoutes(...)</code> gives every call one debuggable object</h2><p class="muted">Use this as the support/debug payload across traces, provider routing, tools, handoffs, guardrails, audit, latency, replay, reviews, tasks, media streams, and webhook delivery.</p><pre><code>${snippet}</code></pre></section><section><h2>Provider Summary</h2><div class="grid">${providers}</div></section><section><h2>Handoffs</h2><ul>${handoffs}</ul></section><section><h2>Tools</h2><ul>${tools}</ul></section><section><h2>Reviews</h2><ul>${reviews}</ul></section><section><h2>Tasks</h2><ul>${tasks}</ul></section><section><h2>Integration Events</h2><ul>${integrationEvents}</ul></section></main></body></html>`;
 };
 var createVoiceOperationsRecordRoutes = (options) => {
   const path = options.path ?? "/api/voice-operations/:sessionId";
@@ -28260,7 +28412,7 @@ var assertVoiceObservabilityExportSchema = (input) => {
 };
 var isRecord2 = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
 var isStatus2 = (value) => value === "fail" || value === "pass" || value === "warn";
-var getRecord = (value, key) => isRecord2(value) && isRecord2(value[key]) ? value[key] : undefined;
+var getRecord2 = (value, key) => isRecord2(value) && isRecord2(value[key]) ? value[key] : undefined;
 var getRecordArray = (value, key) => isRecord2(value) && Array.isArray(value[key]) ? value[key] : undefined;
 var inferVoiceObservabilityExportRecordKind = (record) => {
   if (isRecord2(record.manifest) && isRecord2(record.artifactIndex)) {
@@ -28284,7 +28436,7 @@ var pushValidationIssue = (issues, issue) => {
   issues.push(issue);
 };
 var requireRecordSchema = (issues, record, path) => {
-  const schema = getRecord(record, "schema");
+  const schema = getRecord2(record, "schema");
   if (schema?.id !== voiceObservabilityExportSchemaId || schema?.version !== voiceObservabilityExportSchemaVersion) {
     pushValidationIssue(issues, {
       code: "voice.observability.export.unsupported_schema",
@@ -35542,6 +35694,7 @@ export {
   hasVoiceOpsTaskSLABreach,
   getVoiceLiveOpsControlStatus,
   getVoiceCampaignDialerProofStatus,
+  getLatestVoiceTelephonyMediaReport,
   getLatestVoiceBrowserMediaReport,
   formatVoiceProofTrendAge,
   filterVoiceTraceEvents,

package/dist/operationsRecord.d.ts

@@ -118,6 +118,27 @@ export type VoiceOperationsRecordGuardrailSummary = {
     total: number;
     warned: number;
 };
+export type VoiceOperationsRecordTelephonyMediaEvent = {
+    at: number;
+    audioBytes: number;
+    callSid?: string;
+    carrier?: string;
+    direction?: string;
+    event: string;
+    sequenceNumber?: string;
+    streamId?: string;
+};
+export type VoiceOperationsRecordTelephonyMediaSummary = {
+    audioBytes: number;
+    carriers: string[];
+    errors: number;
+    events: VoiceOperationsRecordTelephonyMediaEvent[];
+    media: number;
+    starts: number;
+    stops: number;
+    streamIds: string[];
+    total: number;
+};
 export type VoiceOperationsRecordGuardrailAssertionInput = {
     minBlocked?: number;
     minDecisions?: number;
@@ -186,6 +207,7 @@ export type VoiceOperationsRecord = {
     status: VoiceOperationsRecordStatus;
     summary: VoiceTraceSummary;
     tasks?: VoiceOperationsRecordTaskSummary;
+    telephonyMedia: VoiceOperationsRecordTelephonyMediaSummary;
     timeline: VoiceTraceTimelineEvent[];
     tools: VoiceOperationsRecordTool[];
     traceEvents: StoredVoiceTraceEvent[];

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.328",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",