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

package/dist/index.d.ts

@@ -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

@@ -21722,12 +21722,35 @@ var createTwilioSocketAdapter = (socket, getState) => ({
     }
     if (message.type === "audio") {
       const payload = transcodePCMToTwilioOutboundPayload(Uint8Array.from(Buffer4.from(message.chunkBase64, "base64")), message.format);
+      const outboundMessage = {
+        event: "media",
+        media: {
+          payload,
+          track: "outbound"
+        },
+        streamSid: state.streamSid
+      };
       state.hasOutboundAudioSinceLastInbound = true;
       state.reviewRecorder?.recordTwilioOutbound({
         bytes: payload.length,
         event: "media",
         track: "outbound"
       });
+      await state.trace?.append({
+        at: Date.now(),
+        payload: {
+          audioBytes: Buffer4.from(payload, "base64").byteLength,
+          callSid: state.callSid ?? undefined,
+          carrier: state.carrier,
+          direction: "outbound",
+          envelope: outboundMessage,
+          event: "media",
+          streamId: state.streamSid
+        },
+        scenarioId: state.scenarioId ?? undefined,
+        sessionId: state.sessionId ?? state.streamSid,
+        type: "client.telephony_media"
+      });
       await Promise.resolve(socket.send(JSON.stringify({
         event: "media",
         media: {
@@ -21738,17 +21761,32 @@ var createTwilioSocketAdapter = (socket, getState) => ({
       return;
     }
     if (message.type === "assistant" && message.turnId) {
-      state.reviewRecorder?.recordTwilioOutbound({
-        event: "mark",
-        name: `assistant:${message.turnId}`
-      });
-      await Promise.resolve(socket.send(JSON.stringify({
+      const outboundMessage = {
         event: "mark",
         mark: {
           name: `assistant:${message.turnId}`
         },
         streamSid: state.streamSid
-      })));
+      };
+      state.reviewRecorder?.recordTwilioOutbound({
+        event: "mark",
+        name: `assistant:${message.turnId}`
+      });
+      await state.trace?.append({
+        at: Date.now(),
+        payload: {
+          callSid: state.callSid ?? undefined,
+          carrier: state.carrier,
+          direction: "outbound",
+          envelope: outboundMessage,
+          event: "mark",
+          streamId: state.streamSid
+        },
+        scenarioId: state.scenarioId ?? undefined,
+        sessionId: state.sessionId ?? state.streamSid,
+        type: "client.telephony_media"
+      });
+      await Promise.resolve(socket.send(JSON.stringify(outboundMessage)));
     }
   }
 });
@@ -21771,6 +21809,7 @@ var createTwilioMediaStreamBridge = (socket, options) => {
   };
   const bridgeState = {
     callSid: null,
+    carrier: options.telephonyMediaCarrier ?? "twilio",
     hasOutboundAudioSinceLastInbound: false,
     onVoiceMessage: options.onVoiceMessage,
     reviewRecorder: options.review ? createVoiceCallReviewRecorder({
@@ -21790,11 +21829,12 @@ var createTwilioMediaStreamBridge = (socket, options) => {
     }) : undefined,
     scenarioId: options.scenarioId ?? null,
     sessionId: options.sessionId ?? null,
-    streamSid: null
+    streamSid: null,
+    trace: options.trace
   };
   let sessionHandle = null;
   let reviewArtifactDelivered = false;
-  const telephonyMediaCarrier = options.telephonyMediaCarrier ?? "twilio";
+  const telephonyMediaCarrier = bridgeState.carrier;
   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");
@@ -21928,13 +21968,28 @@ var createTwilioMediaStreamBridge = (socket, options) => {
             track: message.media.track
           });
           if (options.clearOnInboundMedia !== false && bridgeState.hasOutboundAudioSinceLastInbound && bridgeState.streamSid) {
+            const outboundMessage = {
+              event: "clear",
+              streamSid: bridgeState.streamSid
+            };
             bridgeState.reviewRecorder?.recordTwilioOutbound({
               event: "clear"
             });
-            await Promise.resolve(socket.send(JSON.stringify({
-              event: "clear",
-              streamSid: bridgeState.streamSid
-            })));
+            await options.trace?.append({
+              at: Date.now(),
+              payload: {
+                callSid: bridgeState.callSid ?? undefined,
+                carrier: telephonyMediaCarrier,
+                direction: "outbound",
+                envelope: outboundMessage,
+                event: "clear",
+                streamId: bridgeState.streamSid
+              },
+              scenarioId: bridgeState.scenarioId ?? undefined,
+              sessionId: bridgeState.sessionId ?? bridgeState.streamSid,
+              type: "client.telephony_media"
+            });
+            await Promise.resolve(socket.send(JSON.stringify(outboundMessage)));
           }
           bridgeState.hasOutboundAudioSinceLastInbound = false;
           await appendTelephonyMediaTrace(message, {
@@ -27765,6 +27820,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) => {
@@ -27823,6 +27879,60 @@ 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)),
+    clears: eventNames.filter((event) => event === "clear").length,
+    errors: eventNames.filter((event) => event === "error").length,
+    events: mediaEvents,
+    inbound: mediaEvents.filter((event) => event.direction === "inbound").length,
+    marks: eventNames.filter((event) => event === "mark").length,
+    media: eventNames.filter((event) => event === "media").length,
+    outbound: mediaEvents.filter((event) => event.direction === "outbound").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";
@@ -27970,6 +28080,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,
@@ -28174,6 +28285,31 @@ 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)}`,
+    `inbound=${String(record.telephonyMedia.inbound)}`,
+    `outbound=${String(record.telephonyMedia.outbound)}`,
+    `marks=${String(record.telephonyMedia.marks)}`,
+    `clears=${String(record.telephonyMedia.clears)}`,
+    `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}`,
     "",
@@ -28187,11 +28323,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",
@@ -28234,6 +28375,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,
@@ -28250,7 +28402,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.inbound)} inbound / ${String(record.telephonyMedia.outbound)} outbound / ${String(record.telephonyMedia.clears)} clears</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")}. Inbound: ${String(record.telephonyMedia.inbound)}. Outbound: ${String(record.telephonyMedia.outbound)}. Marks: ${String(record.telephonyMedia.marks)}. Clears: ${String(record.telephonyMedia.clears)}.</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";
@@ -28323,7 +28475,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)) {
@@ -28347,7 +28499,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",

package/dist/operationsRecord.d.ts

@@ -118,6 +118,31 @@ 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[];
+    clears: number;
+    errors: number;
+    events: VoiceOperationsRecordTelephonyMediaEvent[];
+    inbound: number;
+    marks: number;
+    media: number;
+    outbound: number;
+    starts: number;
+    stops: number;
+    streamIds: string[];
+    total: number;
+};
 export type VoiceOperationsRecordGuardrailAssertionInput = {
     minBlocked?: number;
     minDecisions?: number;
@@ -186,6 +211,7 @@ export type VoiceOperationsRecord = {
     status: VoiceOperationsRecordStatus;
     summary: VoiceTraceSummary;
     tasks?: VoiceOperationsRecordTaskSummary;
+    telephonyMedia: VoiceOperationsRecordTelephonyMediaSummary;
     timeline: VoiceTraceTimelineEvent[];
     tools: VoiceOperationsRecordTool[];
     traceEvents: StoredVoiceTraceEvent[];

package/dist/testing/index.js

@@ -10130,12 +10130,35 @@ var createTwilioSocketAdapter = (socket, getState) => ({
     }
     if (message.type === "audio") {
       const payload = transcodePCMToTwilioOutboundPayload(Uint8Array.from(Buffer3.from(message.chunkBase64, "base64")), message.format);
+      const outboundMessage = {
+        event: "media",
+        media: {
+          payload,
+          track: "outbound"
+        },
+        streamSid: state.streamSid
+      };
       state.hasOutboundAudioSinceLastInbound = true;
       state.reviewRecorder?.recordTwilioOutbound({
         bytes: payload.length,
         event: "media",
         track: "outbound"
       });
+      await state.trace?.append({
+        at: Date.now(),
+        payload: {
+          audioBytes: Buffer3.from(payload, "base64").byteLength,
+          callSid: state.callSid ?? undefined,
+          carrier: state.carrier,
+          direction: "outbound",
+          envelope: outboundMessage,
+          event: "media",
+          streamId: state.streamSid
+        },
+        scenarioId: state.scenarioId ?? undefined,
+        sessionId: state.sessionId ?? state.streamSid,
+        type: "client.telephony_media"
+      });
       await Promise.resolve(socket.send(JSON.stringify({
         event: "media",
         media: {
@@ -10146,17 +10169,32 @@ var createTwilioSocketAdapter = (socket, getState) => ({
       return;
     }
     if (message.type === "assistant" && message.turnId) {
-      state.reviewRecorder?.recordTwilioOutbound({
-        event: "mark",
-        name: `assistant:${message.turnId}`
-      });
-      await Promise.resolve(socket.send(JSON.stringify({
+      const outboundMessage = {
         event: "mark",
         mark: {
           name: `assistant:${message.turnId}`
         },
         streamSid: state.streamSid
-      })));
+      };
+      state.reviewRecorder?.recordTwilioOutbound({
+        event: "mark",
+        name: `assistant:${message.turnId}`
+      });
+      await state.trace?.append({
+        at: Date.now(),
+        payload: {
+          callSid: state.callSid ?? undefined,
+          carrier: state.carrier,
+          direction: "outbound",
+          envelope: outboundMessage,
+          event: "mark",
+          streamId: state.streamSid
+        },
+        scenarioId: state.scenarioId ?? undefined,
+        sessionId: state.sessionId ?? state.streamSid,
+        type: "client.telephony_media"
+      });
+      await Promise.resolve(socket.send(JSON.stringify(outboundMessage)));
     }
   }
 });
@@ -10179,6 +10217,7 @@ var createTwilioMediaStreamBridge = (socket, options) => {
   };
   const bridgeState = {
     callSid: null,
+    carrier: options.telephonyMediaCarrier ?? "twilio",
     hasOutboundAudioSinceLastInbound: false,
     onVoiceMessage: options.onVoiceMessage,
     reviewRecorder: options.review ? createVoiceCallReviewRecorder({
@@ -10198,11 +10237,12 @@ var createTwilioMediaStreamBridge = (socket, options) => {
     }) : undefined,
     scenarioId: options.scenarioId ?? null,
     sessionId: options.sessionId ?? null,
-    streamSid: null
+    streamSid: null,
+    trace: options.trace
   };
   let sessionHandle = null;
   let reviewArtifactDelivered = false;
-  const telephonyMediaCarrier = options.telephonyMediaCarrier ?? "twilio";
+  const telephonyMediaCarrier = bridgeState.carrier;
   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");
@@ -10336,13 +10376,28 @@ var createTwilioMediaStreamBridge = (socket, options) => {
             track: message.media.track
           });
           if (options.clearOnInboundMedia !== false && bridgeState.hasOutboundAudioSinceLastInbound && bridgeState.streamSid) {
+            const outboundMessage = {
+              event: "clear",
+              streamSid: bridgeState.streamSid
+            };
             bridgeState.reviewRecorder?.recordTwilioOutbound({
               event: "clear"
             });
-            await Promise.resolve(socket.send(JSON.stringify({
-              event: "clear",
-              streamSid: bridgeState.streamSid
-            })));
+            await options.trace?.append({
+              at: Date.now(),
+              payload: {
+                callSid: bridgeState.callSid ?? undefined,
+                carrier: telephonyMediaCarrier,
+                direction: "outbound",
+                envelope: outboundMessage,
+                event: "clear",
+                streamId: bridgeState.streamSid
+              },
+              scenarioId: bridgeState.scenarioId ?? undefined,
+              sessionId: bridgeState.sessionId ?? bridgeState.streamSid,
+              type: "client.telephony_media"
+            });
+            await Promise.resolve(socket.send(JSON.stringify(outboundMessage)));
           }
           bridgeState.hasOutboundAudioSinceLastInbound = false;
           await appendTelephonyMediaTrace(message, {

package/package.json

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