@absolutejs/voice 0.0.22-beta.323 → 0.0.22-beta.325

package/dist/angular/index.js

@@ -1471,6 +1471,29 @@ var telephonyDirection = (track) => {
   return "unknown";
 };
 var telephonyFrameKind = (direction) => direction === "outbound" ? "assistant-audio" : "input-audio";
+var telephonyEventKind = (envelope) => {
+  const raw = firstString([envelope], ["event", "type", "eventType"]) ?? firstString([unknownRecord(envelope.message)], ["event", "type"]);
+  const normalized = raw?.toLowerCase().replace(/[_\s-]+/g, "-");
+  if (!normalized) {
+    return "unknown";
+  }
+  if (normalized.includes("connected")) {
+    return "connected";
+  }
+  if (normalized.includes("start")) {
+    return "start";
+  }
+  if (normalized.includes("media")) {
+    return "media";
+  }
+  if (normalized.includes("stop") || normalized.includes("closed")) {
+    return "stop";
+  }
+  if (normalized.includes("error") || normalized.includes("failed")) {
+    return "error";
+  }
+  return "unknown";
+};
 var normalizeWebRTCStat = (stat) => {
   const sample = {};
   for (const [key, value] of Object.entries(stat)) {
@@ -1587,6 +1610,86 @@ var createTelephonyMediaSerializer = (input) => {
     })
   };
 };
+var parseTelephonyStreamEvent = (input) => {
+  const envelope = input.envelope;
+  const media = unknownRecord(envelope.media);
+  const start = unknownRecord(envelope.start);
+  const stop = unknownRecord(envelope.stop);
+  const errorRecord = unknownRecord(envelope.error);
+  const kind = telephonyEventKind(envelope);
+  const carrier = input.carrier ?? firstString([envelope], ["provider", "carrier"]) ?? "telephony";
+  const frame = kind === "media" ? parseTelephonyMediaFrame({
+    carrier,
+    envelope,
+    format: input.format,
+    sessionId: input.sessionId
+  }) : undefined;
+  const streamId = firstString([media, start, stop, envelope], ["streamSid", "stream_id", "streamId", "callSid", "call_id"]) ?? input.sessionId;
+  const sequenceNumber = firstString([media, envelope], ["sequenceNumber", "sequence_number", "chunk"]);
+  const track = firstString([media, envelope], ["track", "direction"]);
+  return {
+    audioBytes: frame?.audio ? frame.audio instanceof ArrayBuffer ? frame.audio.byteLength : frame.audio.byteLength : 0,
+    at: frame?.at ?? firstNumber([media, start, stop, envelope], ["timestamp", "time", "startedAt"]),
+    carrier,
+    direction: telephonyDirection(track),
+    error: firstString([errorRecord, envelope], ["message", "error", "reason"]),
+    kind,
+    sequenceNumber,
+    streamId
+  };
+};
+var buildMediaTelephonyStreamLifecycleReport = (input = {}) => {
+  const envelopes = input.envelopes ?? [];
+  const events = envelopes.map((envelope) => parseTelephonyStreamEvent({
+    carrier: input.carrier,
+    envelope
+  }));
+  const issues = [];
+  const startedIndex = events.findIndex((event) => event.kind === "start");
+  const firstMediaIndex = events.findIndex((event) => event.kind === "media");
+  const stoppedIndex = events.findIndex((event) => event.kind === "stop");
+  const started = startedIndex >= 0;
+  const stopped = stoppedIndex >= 0;
+  const mediaEvents = events.filter((event) => event.kind === "media");
+  const audioBytes = events.reduce((total, event) => total + event.audioBytes, 0);
+  const minAudioBytes = input.minAudioBytes ?? 1;
+  const streamIds = Array.from(new Set(events.map((event) => event.streamId).filter(Boolean)));
+  if ((input.requireStart ?? true) && !started) {
+    pushIssue(issues, "error", "media.telephony_missing_start", "Telephony media stream did not include a start event.");
+  }
+  if ((input.requireMedia ?? true) && mediaEvents.length === 0) {
+    pushIssue(issues, "error", "media.telephony_missing_media", "Telephony media stream did not include media payload events.");
+  }
+  if ((input.requireStop ?? true) && !stopped) {
+    pushIssue(issues, input.maxMissingStop === false ? "warning" : "error", "media.telephony_missing_stop", "Telephony media stream did not include a stop event.");
+  }
+  if (started && firstMediaIndex >= 0 && firstMediaIndex < startedIndex) {
+    pushIssue(issues, "error", "media.telephony_media_before_start", "Telephony media payload arrived before the stream start event.");
+  }
+  if (stopped && firstMediaIndex >= 0 && stoppedIndex < firstMediaIndex) {
+    pushIssue(issues, "error", "media.telephony_stop_before_media", "Telephony media stream stopped before any media payload arrived.");
+  }
+  if (mediaEvents.length > 0 && audioBytes < minAudioBytes) {
+    pushIssue(issues, "error", "media.telephony_no_audio_bytes", `Telephony media stream parsed ${String(audioBytes)} audio byte(s), below required ${String(minAudioBytes)}.`);
+  }
+  for (const event of events) {
+    if (event.kind === "error") {
+      pushIssue(issues, "error", "media.telephony_stream_error", event.error ?? "Telephony media stream emitted an error event.");
+    }
+  }
+  return {
+    audioBytes,
+    carrier: input.carrier,
+    checkedAt: Date.now(),
+    events,
+    issues,
+    mediaEvents: mediaEvents.length,
+    started,
+    status: issues.some((issue) => issue.severity === "error") ? "fail" : issues.length > 0 ? "warn" : "pass",
+    stopped,
+    streamIds
+  };
+};
 var buildMediaResamplingPlan = (input) => {
   const required = !formatMatches(input.inputFormat, input.outputFormat);
   return {

package/dist/client/index.js

@@ -864,6 +864,29 @@ var telephonyDirection = (track) => {
   return "unknown";
 };
 var telephonyFrameKind = (direction) => direction === "outbound" ? "assistant-audio" : "input-audio";
+var telephonyEventKind = (envelope) => {
+  const raw = firstString([envelope], ["event", "type", "eventType"]) ?? firstString([unknownRecord(envelope.message)], ["event", "type"]);
+  const normalized = raw?.toLowerCase().replace(/[_\s-]+/g, "-");
+  if (!normalized) {
+    return "unknown";
+  }
+  if (normalized.includes("connected")) {
+    return "connected";
+  }
+  if (normalized.includes("start")) {
+    return "start";
+  }
+  if (normalized.includes("media")) {
+    return "media";
+  }
+  if (normalized.includes("stop") || normalized.includes("closed")) {
+    return "stop";
+  }
+  if (normalized.includes("error") || normalized.includes("failed")) {
+    return "error";
+  }
+  return "unknown";
+};
 var normalizeWebRTCStat = (stat) => {
   const sample = {};
   for (const [key, value] of Object.entries(stat)) {
@@ -980,6 +1003,86 @@ var createTelephonyMediaSerializer = (input) => {
     })
   };
 };
+var parseTelephonyStreamEvent = (input) => {
+  const envelope = input.envelope;
+  const media = unknownRecord(envelope.media);
+  const start = unknownRecord(envelope.start);
+  const stop = unknownRecord(envelope.stop);
+  const errorRecord = unknownRecord(envelope.error);
+  const kind = telephonyEventKind(envelope);
+  const carrier = input.carrier ?? firstString([envelope], ["provider", "carrier"]) ?? "telephony";
+  const frame = kind === "media" ? parseTelephonyMediaFrame({
+    carrier,
+    envelope,
+    format: input.format,
+    sessionId: input.sessionId
+  }) : undefined;
+  const streamId = firstString([media, start, stop, envelope], ["streamSid", "stream_id", "streamId", "callSid", "call_id"]) ?? input.sessionId;
+  const sequenceNumber = firstString([media, envelope], ["sequenceNumber", "sequence_number", "chunk"]);
+  const track = firstString([media, envelope], ["track", "direction"]);
+  return {
+    audioBytes: frame?.audio ? frame.audio instanceof ArrayBuffer ? frame.audio.byteLength : frame.audio.byteLength : 0,
+    at: frame?.at ?? firstNumber([media, start, stop, envelope], ["timestamp", "time", "startedAt"]),
+    carrier,
+    direction: telephonyDirection(track),
+    error: firstString([errorRecord, envelope], ["message", "error", "reason"]),
+    kind,
+    sequenceNumber,
+    streamId
+  };
+};
+var buildMediaTelephonyStreamLifecycleReport = (input = {}) => {
+  const envelopes = input.envelopes ?? [];
+  const events = envelopes.map((envelope) => parseTelephonyStreamEvent({
+    carrier: input.carrier,
+    envelope
+  }));
+  const issues = [];
+  const startedIndex = events.findIndex((event) => event.kind === "start");
+  const firstMediaIndex = events.findIndex((event) => event.kind === "media");
+  const stoppedIndex = events.findIndex((event) => event.kind === "stop");
+  const started = startedIndex >= 0;
+  const stopped = stoppedIndex >= 0;
+  const mediaEvents = events.filter((event) => event.kind === "media");
+  const audioBytes = events.reduce((total, event) => total + event.audioBytes, 0);
+  const minAudioBytes = input.minAudioBytes ?? 1;
+  const streamIds = Array.from(new Set(events.map((event) => event.streamId).filter(Boolean)));
+  if ((input.requireStart ?? true) && !started) {
+    pushIssue(issues, "error", "media.telephony_missing_start", "Telephony media stream did not include a start event.");
+  }
+  if ((input.requireMedia ?? true) && mediaEvents.length === 0) {
+    pushIssue(issues, "error", "media.telephony_missing_media", "Telephony media stream did not include media payload events.");
+  }
+  if ((input.requireStop ?? true) && !stopped) {
+    pushIssue(issues, input.maxMissingStop === false ? "warning" : "error", "media.telephony_missing_stop", "Telephony media stream did not include a stop event.");
+  }
+  if (started && firstMediaIndex >= 0 && firstMediaIndex < startedIndex) {
+    pushIssue(issues, "error", "media.telephony_media_before_start", "Telephony media payload arrived before the stream start event.");
+  }
+  if (stopped && firstMediaIndex >= 0 && stoppedIndex < firstMediaIndex) {
+    pushIssue(issues, "error", "media.telephony_stop_before_media", "Telephony media stream stopped before any media payload arrived.");
+  }
+  if (mediaEvents.length > 0 && audioBytes < minAudioBytes) {
+    pushIssue(issues, "error", "media.telephony_no_audio_bytes", `Telephony media stream parsed ${String(audioBytes)} audio byte(s), below required ${String(minAudioBytes)}.`);
+  }
+  for (const event of events) {
+    if (event.kind === "error") {
+      pushIssue(issues, "error", "media.telephony_stream_error", event.error ?? "Telephony media stream emitted an error event.");
+    }
+  }
+  return {
+    audioBytes,
+    carrier: input.carrier,
+    checkedAt: Date.now(),
+    events,
+    issues,
+    mediaEvents: mediaEvents.length,
+    started,
+    status: issues.some((issue) => issue.severity === "error") ? "fail" : issues.length > 0 ? "warn" : "pass",
+    stopped,
+    streamIds
+  };
+};
 var buildMediaResamplingPlan = (input) => {
   const required = !formatMatches(input.inputFormat, input.outputFormat);
   return {

package/dist/index.js

@@ -11696,6 +11696,29 @@ var telephonyDirection = (track) => {
   return "unknown";
 };
 var telephonyFrameKind = (direction) => direction === "outbound" ? "assistant-audio" : "input-audio";
+var telephonyEventKind = (envelope) => {
+  const raw = firstString2([envelope], ["event", "type", "eventType"]) ?? firstString2([unknownRecord(envelope.message)], ["event", "type"]);
+  const normalized = raw?.toLowerCase().replace(/[_\s-]+/g, "-");
+  if (!normalized) {
+    return "unknown";
+  }
+  if (normalized.includes("connected")) {
+    return "connected";
+  }
+  if (normalized.includes("start")) {
+    return "start";
+  }
+  if (normalized.includes("media")) {
+    return "media";
+  }
+  if (normalized.includes("stop") || normalized.includes("closed")) {
+    return "stop";
+  }
+  if (normalized.includes("error") || normalized.includes("failed")) {
+    return "error";
+  }
+  return "unknown";
+};
 var normalizeWebRTCStat = (stat) => {
   const sample = {};
   for (const [key, value] of Object.entries(stat)) {
@@ -11812,6 +11835,86 @@ var createTelephonyMediaSerializer = (input) => {
     })
   };
 };
+var parseTelephonyStreamEvent = (input) => {
+  const envelope = input.envelope;
+  const media = unknownRecord(envelope.media);
+  const start = unknownRecord(envelope.start);
+  const stop = unknownRecord(envelope.stop);
+  const errorRecord = unknownRecord(envelope.error);
+  const kind = telephonyEventKind(envelope);
+  const carrier = input.carrier ?? firstString2([envelope], ["provider", "carrier"]) ?? "telephony";
+  const frame = kind === "media" ? parseTelephonyMediaFrame({
+    carrier,
+    envelope,
+    format: input.format,
+    sessionId: input.sessionId
+  }) : undefined;
+  const streamId = firstString2([media, start, stop, envelope], ["streamSid", "stream_id", "streamId", "callSid", "call_id"]) ?? input.sessionId;
+  const sequenceNumber = firstString2([media, envelope], ["sequenceNumber", "sequence_number", "chunk"]);
+  const track = firstString2([media, envelope], ["track", "direction"]);
+  return {
+    audioBytes: frame?.audio ? frame.audio instanceof ArrayBuffer ? frame.audio.byteLength : frame.audio.byteLength : 0,
+    at: frame?.at ?? firstNumber([media, start, stop, envelope], ["timestamp", "time", "startedAt"]),
+    carrier,
+    direction: telephonyDirection(track),
+    error: firstString2([errorRecord, envelope], ["message", "error", "reason"]),
+    kind,
+    sequenceNumber,
+    streamId
+  };
+};
+var buildMediaTelephonyStreamLifecycleReport = (input = {}) => {
+  const envelopes = input.envelopes ?? [];
+  const events = envelopes.map((envelope) => parseTelephonyStreamEvent({
+    carrier: input.carrier,
+    envelope
+  }));
+  const issues = [];
+  const startedIndex = events.findIndex((event) => event.kind === "start");
+  const firstMediaIndex = events.findIndex((event) => event.kind === "media");
+  const stoppedIndex = events.findIndex((event) => event.kind === "stop");
+  const started = startedIndex >= 0;
+  const stopped = stoppedIndex >= 0;
+  const mediaEvents = events.filter((event) => event.kind === "media");
+  const audioBytes = events.reduce((total, event) => total + event.audioBytes, 0);
+  const minAudioBytes = input.minAudioBytes ?? 1;
+  const streamIds = Array.from(new Set(events.map((event) => event.streamId).filter(Boolean)));
+  if ((input.requireStart ?? true) && !started) {
+    pushIssue(issues, "error", "media.telephony_missing_start", "Telephony media stream did not include a start event.");
+  }
+  if ((input.requireMedia ?? true) && mediaEvents.length === 0) {
+    pushIssue(issues, "error", "media.telephony_missing_media", "Telephony media stream did not include media payload events.");
+  }
+  if ((input.requireStop ?? true) && !stopped) {
+    pushIssue(issues, input.maxMissingStop === false ? "warning" : "error", "media.telephony_missing_stop", "Telephony media stream did not include a stop event.");
+  }
+  if (started && firstMediaIndex >= 0 && firstMediaIndex < startedIndex) {
+    pushIssue(issues, "error", "media.telephony_media_before_start", "Telephony media payload arrived before the stream start event.");
+  }
+  if (stopped && firstMediaIndex >= 0 && stoppedIndex < firstMediaIndex) {
+    pushIssue(issues, "error", "media.telephony_stop_before_media", "Telephony media stream stopped before any media payload arrived.");
+  }
+  if (mediaEvents.length > 0 && audioBytes < minAudioBytes) {
+    pushIssue(issues, "error", "media.telephony_no_audio_bytes", `Telephony media stream parsed ${String(audioBytes)} audio byte(s), below required ${String(minAudioBytes)}.`);
+  }
+  for (const event of events) {
+    if (event.kind === "error") {
+      pushIssue(issues, "error", "media.telephony_stream_error", event.error ?? "Telephony media stream emitted an error event.");
+    }
+  }
+  return {
+    audioBytes,
+    carrier: input.carrier,
+    checkedAt: Date.now(),
+    events,
+    issues,
+    mediaEvents: mediaEvents.length,
+    started,
+    status: issues.some((issue) => issue.severity === "error") ? "fail" : issues.length > 0 ? "warn" : "pass",
+    stopped,
+    streamIds
+  };
+};
 var buildMediaResamplingPlan = (input) => {
   const required = !formatMatches2(input.inputFormat, input.outputFormat);
   return {
@@ -12453,6 +12556,49 @@ var demoEnvelope = (carrier) => {
     streamId: "proof-plivo-media"
   };
 };
+var demoLifecycleEnvelopes = (carrier) => {
+  if (carrier === "twilio") {
+    return [
+      {
+        event: "start",
+        start: {
+          streamSid: "proof-twilio-media"
+        }
+      },
+      demoEnvelope(carrier),
+      {
+        event: "stop",
+        stop: {
+          streamSid: "proof-twilio-media"
+        }
+      }
+    ];
+  }
+  if (carrier === "telnyx") {
+    return [
+      {
+        event: "start",
+        stream_id: "proof-telnyx-media"
+      },
+      demoEnvelope(carrier),
+      {
+        event: "stop",
+        stream_id: "proof-telnyx-media"
+      }
+    ];
+  }
+  return [
+    {
+      event: "start",
+      streamId: "proof-plivo-media"
+    },
+    demoEnvelope(carrier),
+    {
+      event: "stop",
+      streamId: "proof-plivo-media"
+    }
+  ];
+};
 var byteLength = (audio) => {
   if (!audio) {
     return 0;
@@ -12478,6 +12624,10 @@ var buildVoiceTelephonyMediaReport = (input = {}) => {
       carrier: entry.carrier,
       frame
     }) : undefined;
+    const lifecycle = buildMediaTelephonyStreamLifecycleReport({
+      carrier: entry.carrier,
+      envelopes: entry.lifecycleEnvelopes ?? demoLifecycleEnvelopes(entry.carrier)
+    });
     const audioBytes = byteLength(frame?.audio);
     const issues2 = [];
     if (!frame) {
@@ -12495,11 +12645,15 @@ var buildVoiceTelephonyMediaReport = (input = {}) => {
     if (!serialized || typeof serialized !== "object") {
       issues2.push("MediaFrame did not serialize back into a carrier envelope.");
     }
+    for (const issue of lifecycle.issues) {
+      issues2.push(issue.message);
+    }
     return {
       audioBytes,
       carrier: entry.carrier,
       frame,
       issues: issues2,
+      lifecycle,
       serialized,
       status: issues2.length === 0 ? "pass" : "fail"
     };
@@ -12514,8 +12668,8 @@ var buildVoiceTelephonyMediaReport = (input = {}) => {
 };
 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>${escapeHtml16(carrier.frame?.kind ?? "missing")}</td><td>${escapeHtml16(carrier.frame?.format?.encoding ?? "missing")}</td><td>${escapeHtml16(carrier.issues.join(" ") || "none")}</td></tr>`).join("");
-  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml16(title)}</title><style>body{background:#111827;color:#e5e7eb;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:980px;padding:32px}.hero,table{background:#0f172a;border:1px solid #334155;border-radius:20px;margin-bottom:16px}.hero{padding:22px}.eyebrow{color:#67e8f9;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.2rem,6vw,4.5rem);line-height:.92;margin:.2rem 0 1rem}.status{border:1px solid #64748b;border-radius:999px;display:inline-flex;font-weight:900;padding:8px 12px}.pass{color:#86efac}.fail{color:#fecaca}code{color:#bfdbfe}table{border-collapse:collapse;overflow:hidden;width:100%}td,th{border-bottom:1px solid #334155;padding:10px;text-align:left}</style></head><body><main><section class="hero"><p class="eyebrow">Carrier media serializer proof</p><h1>${escapeHtml16(title)}</h1><p class="status ${escapeHtml16(report.status)}">Status: ${escapeHtml16(report.status)}</p><p>Twilio, Telnyx, and Plivo media payload envelopes are parsed into generic <code>MediaFrame</code> objects and serialized back into carrier envelopes by <code>@absolutejs/media</code>.</p></section><table><thead><tr><th>Carrier</th><th>Status</th><th>Audio bytes</th><th>Frame kind</th><th>Encoding</th><th>Issues</th></tr></thead><tbody>${rows}</tbody></table></main></body></html>`;
+  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("");
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml16(title)}</title><style>body{background:#111827;color:#e5e7eb;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:980px;padding:32px}.hero,table{background:#0f172a;border:1px solid #334155;border-radius:20px;margin-bottom:16px}.hero{padding:22px}.eyebrow{color:#67e8f9;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.2rem,6vw,4.5rem);line-height:.92;margin:.2rem 0 1rem}.status{border:1px solid #64748b;border-radius:999px;display:inline-flex;font-weight:900;padding:8px 12px}.pass{color:#86efac}.fail{color:#fecaca}code{color:#bfdbfe}table{border-collapse:collapse;overflow:hidden;width:100%}td,th{border-bottom:1px solid #334155;padding:10px;text-align:left}</style></head><body><main><section class="hero"><p class="eyebrow">Carrier media serializer proof</p><h1>${escapeHtml16(title)}</h1><p class="status ${escapeHtml16(report.status)}">Status: ${escapeHtml16(report.status)}</p><p>Twilio, Telnyx, and Plivo media payload envelopes are parsed into generic <code>MediaFrame</code> objects, serialized back into carrier envelopes, and checked for start/media/stop lifecycle sequencing by <code>@absolutejs/media</code>.</p></section><table><thead><tr><th>Carrier</th><th>Status</th><th>Audio bytes</th><th>Media events</th><th>Started</th><th>Stopped</th><th>Frame kind</th><th>Encoding</th><th>Issues</th></tr></thead><tbody>${rows}</tbody></table></main></body></html>`;
 };
 var createVoiceTelephonyMediaRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice/telephony/media";
@@ -29776,6 +29930,12 @@ var resolveBrowserMedia = async (options, input) => {
   }
   return typeof options.browserMedia === "function" ? await options.browserMedia(input) : options.browserMedia;
 };
+var resolveTelephonyMedia = async (options, input) => {
+  if (options.telephonyMedia === false || options.telephonyMedia === undefined) {
+    return;
+  }
+  return typeof options.telephonyMedia === "function" ? await options.telephonyMedia(input) : options.telephonyMedia;
+};
 var isVoiceTelephonyWebhookSecurityReport = (value) => typeof value.generatedAt === "number" && Array.isArray(value.providers) && typeof value.status === "string";
 var resolveTelephonyWebhookSecurity = async (options, input) => {
   if (options.telephonyWebhookSecurity === false || options.telephonyWebhookSecurity === undefined) {
@@ -30161,6 +30321,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     monitoringNotifierDelivery,
     mediaPipeline,
     browserMedia,
+    telephonyMedia,
     telephonyWebhookSecurity,
     reconnectContracts,
     bargeInReports,
@@ -30205,6 +30366,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     resolveMonitoringNotifierDelivery(options, { query, request }),
     resolveMediaPipeline(options, { query, request }),
     resolveBrowserMedia(options, { query, request }),
+    resolveTelephonyMedia(options, { query, request }),
     resolveTelephonyWebhookSecurity(options, { query, request }),
     resolveReconnectContracts(options, { query, request }),
     resolveBargeInReports(options, { query, request }),
@@ -30403,6 +30565,16 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     roundTripTimeMs: browserMedia.roundTripTimeMs,
     status: browserMedia.status === "pass" ? "pass" : "fail"
   } : undefined;
+  const telephonyMediaSummary = telephonyMedia ? {
+    audioBytes: telephonyMedia.carriers.reduce((total, carrier) => total + carrier.audioBytes, 0),
+    carriers: telephonyMedia.carriers.length,
+    failed: telephonyMedia.carriers.filter((carrier) => carrier.status !== "pass").length,
+    issues: telephonyMedia.issues.length,
+    lifecycleFailures: telephonyMedia.carriers.filter((carrier) => carrier.lifecycle.status !== "pass").length,
+    mediaEvents: telephonyMedia.carriers.reduce((total, carrier) => total + carrier.lifecycle.mediaEvents, 0),
+    passed: telephonyMedia.carriers.filter((carrier) => carrier.status === "pass").length,
+    status: telephonyMedia.status === "pass" ? "pass" : "fail"
+  } : undefined;
   checks.push({
     detail: liveLatency.total === 0 ? "No browser live-latency measurements are recorded yet." : liveLatency.status === "pass" ? `Live browser turn latency averages ${liveLatency.averageLatencyMs}ms.` : `${liveLatency.failed} failed and ${liveLatency.warnings} warned live-latency measurement(s).`,
     href: firstOperationsRecordHref(operationsRecords.failingLatency) ?? options.links?.liveLatency ?? "/traces",
@@ -30495,6 +30667,31 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       ]
     });
   }
+  if (telephonyMedia && telephonyMediaSummary) {
+    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",
+      label: "Telephony media serializers",
+      proofSource: proofSource("telephonyMedia", "carrierMediaSerializers"),
+      gateExplanation: telephonyMediaSummary.status === "pass" ? undefined : {
+        evidenceHref: 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",
+        unit: "status"
+      },
+      status: telephonyMediaSummary.status,
+      value: telephonyMediaSummary.status === "pass" ? `${telephonyMediaSummary.passed}/${telephonyMediaSummary.carriers}` : `${telephonyMediaSummary.failed}/${telephonyMediaSummary.carriers} failing`,
+      actions: telephonyMediaSummary.status === "pass" ? [] : [
+        {
+          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",
+          label: "Open telephony media proof"
+        }
+      ]
+    });
+  }
   const carrierSummary = carriers ? {
     failing: carriers.summary.failing,
     providers: carriers.summary.providers,
@@ -31071,6 +31268,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       opsActions: "/voice/ops-actions",
       opsRecovery: "/ops-recovery",
       phoneAgentSmoke: "/sessions",
+      telephonyMedia: "/voice/telephony-media",
       telephonyWebhookSecurity: "/api/voice/telephony/webhook-security",
       providerContracts: "/provider-contracts",
       providerOrchestration: "/voice/provider-orchestration",
@@ -31124,6 +31322,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       providerOrchestration: providerOrchestrationSummary,
       providerRecovery,
       phoneAgentSmokes: phoneAgentSmokeSummary,
+      telephonyMedia: telephonyMediaSummary,
       telephonyWebhookSecurity: telephonyWebhookSecuritySummary,
       providerRoutingContracts: providerRoutingContractSummary,
       providerSlo: providerSloSummary,

package/dist/productionReadiness.d.ts

@@ -20,6 +20,7 @@ import type { VoiceCampaignReadinessProofReport } from './campaign';
 import { type VoiceOpsRecoveryReport } from './opsRecovery';
 import { type VoiceObservabilityExportDeliveryHistory, type VoiceObservabilityExportDeliveryReceiptStore, type VoiceObservabilityExportReplayReport, type VoiceObservabilityExportReplaySource, type VoiceObservabilityExportReport } from './observabilityExport';
 import type { VoiceMediaPipelineReport } from './mediaPipelineRoutes';
+import type { VoiceTelephonyMediaReport } from './telephonyMediaRoutes';
 import type { MediaWebRTCStatsReport } from '@absolutejs/media';
 export type VoiceProductionReadinessObservabilityExportDeliveryHistoryOptions = {
     failOnMissing?: boolean;
@@ -140,6 +141,7 @@ export type VoiceProductionReadinessReport = {
         opsRecovery?: string;
         phoneAgentSmoke?: string;
         telephonyWebhookSecurity?: string;
+        telephonyMedia?: string;
         providerContracts?: string;
         providerOrchestration?: string;
         providerRoutingContracts?: string;
@@ -294,6 +296,16 @@ export type VoiceProductionReadinessReport = {
             status: VoiceProductionReadinessStatus;
             warned: number;
         };
+        telephonyMedia?: {
+            audioBytes: number;
+            carriers: number;
+            failed: number;
+            issues: number;
+            lifecycleFailures: number;
+            mediaEvents: number;
+            passed: number;
+            status: VoiceProductionReadinessStatus;
+        };
         providerRoutingContracts?: {
             failed: number;
             passed: number;
@@ -481,6 +493,10 @@ export type VoiceProductionReadinessRoutesOptions = {
         query: Record<string, unknown>;
         request: Request;
     }) => Promise<MediaWebRTCStatsReport> | MediaWebRTCStatsReport);
+    telephonyMedia?: false | VoiceTelephonyMediaReport | ((input: {
+        query: Record<string, unknown>;
+        request: Request;
+    }) => Promise<VoiceTelephonyMediaReport> | VoiceTelephonyMediaReport);
     opsActionHistory?: false | VoiceProductionReadinessOpsActionHistoryOptions;
     opsRecovery?: false | VoiceOpsRecoveryReport | ((input: {
         query: Record<string, unknown>;

package/dist/react/index.js

@@ -5107,6 +5107,29 @@ var telephonyDirection = (track) => {
   return "unknown";
 };
 var telephonyFrameKind = (direction) => direction === "outbound" ? "assistant-audio" : "input-audio";
+var telephonyEventKind = (envelope) => {
+  const raw = firstString([envelope], ["event", "type", "eventType"]) ?? firstString([unknownRecord(envelope.message)], ["event", "type"]);
+  const normalized = raw?.toLowerCase().replace(/[_\s-]+/g, "-");
+  if (!normalized) {
+    return "unknown";
+  }
+  if (normalized.includes("connected")) {
+    return "connected";
+  }
+  if (normalized.includes("start")) {
+    return "start";
+  }
+  if (normalized.includes("media")) {
+    return "media";
+  }
+  if (normalized.includes("stop") || normalized.includes("closed")) {
+    return "stop";
+  }
+  if (normalized.includes("error") || normalized.includes("failed")) {
+    return "error";
+  }
+  return "unknown";
+};
 var normalizeWebRTCStat = (stat) => {
   const sample = {};
   for (const [key, value] of Object.entries(stat)) {
@@ -5223,6 +5246,86 @@ var createTelephonyMediaSerializer = (input) => {
     })
   };
 };
+var parseTelephonyStreamEvent = (input) => {
+  const envelope = input.envelope;
+  const media = unknownRecord(envelope.media);
+  const start = unknownRecord(envelope.start);
+  const stop = unknownRecord(envelope.stop);
+  const errorRecord = unknownRecord(envelope.error);
+  const kind = telephonyEventKind(envelope);
+  const carrier = input.carrier ?? firstString([envelope], ["provider", "carrier"]) ?? "telephony";
+  const frame = kind === "media" ? parseTelephonyMediaFrame({
+    carrier,
+    envelope,
+    format: input.format,
+    sessionId: input.sessionId
+  }) : undefined;
+  const streamId = firstString([media, start, stop, envelope], ["streamSid", "stream_id", "streamId", "callSid", "call_id"]) ?? input.sessionId;
+  const sequenceNumber = firstString([media, envelope], ["sequenceNumber", "sequence_number", "chunk"]);
+  const track = firstString([media, envelope], ["track", "direction"]);
+  return {
+    audioBytes: frame?.audio ? frame.audio instanceof ArrayBuffer ? frame.audio.byteLength : frame.audio.byteLength : 0,
+    at: frame?.at ?? firstNumber([media, start, stop, envelope], ["timestamp", "time", "startedAt"]),
+    carrier,
+    direction: telephonyDirection(track),
+    error: firstString([errorRecord, envelope], ["message", "error", "reason"]),
+    kind,
+    sequenceNumber,
+    streamId
+  };
+};
+var buildMediaTelephonyStreamLifecycleReport = (input = {}) => {
+  const envelopes = input.envelopes ?? [];
+  const events = envelopes.map((envelope) => parseTelephonyStreamEvent({
+    carrier: input.carrier,
+    envelope
+  }));
+  const issues = [];
+  const startedIndex = events.findIndex((event) => event.kind === "start");
+  const firstMediaIndex = events.findIndex((event) => event.kind === "media");
+  const stoppedIndex = events.findIndex((event) => event.kind === "stop");
+  const started = startedIndex >= 0;
+  const stopped = stoppedIndex >= 0;
+  const mediaEvents = events.filter((event) => event.kind === "media");
+  const audioBytes = events.reduce((total, event) => total + event.audioBytes, 0);
+  const minAudioBytes = input.minAudioBytes ?? 1;
+  const streamIds = Array.from(new Set(events.map((event) => event.streamId).filter(Boolean)));
+  if ((input.requireStart ?? true) && !started) {
+    pushIssue(issues, "error", "media.telephony_missing_start", "Telephony media stream did not include a start event.");
+  }
+  if ((input.requireMedia ?? true) && mediaEvents.length === 0) {
+    pushIssue(issues, "error", "media.telephony_missing_media", "Telephony media stream did not include media payload events.");
+  }
+  if ((input.requireStop ?? true) && !stopped) {
+    pushIssue(issues, input.maxMissingStop === false ? "warning" : "error", "media.telephony_missing_stop", "Telephony media stream did not include a stop event.");
+  }
+  if (started && firstMediaIndex >= 0 && firstMediaIndex < startedIndex) {
+    pushIssue(issues, "error", "media.telephony_media_before_start", "Telephony media payload arrived before the stream start event.");
+  }
+  if (stopped && firstMediaIndex >= 0 && stoppedIndex < firstMediaIndex) {
+    pushIssue(issues, "error", "media.telephony_stop_before_media", "Telephony media stream stopped before any media payload arrived.");
+  }
+  if (mediaEvents.length > 0 && audioBytes < minAudioBytes) {
+    pushIssue(issues, "error", "media.telephony_no_audio_bytes", `Telephony media stream parsed ${String(audioBytes)} audio byte(s), below required ${String(minAudioBytes)}.`);
+  }
+  for (const event of events) {
+    if (event.kind === "error") {
+      pushIssue(issues, "error", "media.telephony_stream_error", event.error ?? "Telephony media stream emitted an error event.");
+    }
+  }
+  return {
+    audioBytes,
+    carrier: input.carrier,
+    checkedAt: Date.now(),
+    events,
+    issues,
+    mediaEvents: mediaEvents.length,
+    started,
+    status: issues.some((issue) => issue.severity === "error") ? "fail" : issues.length > 0 ? "warn" : "pass",
+    stopped,
+    streamIds
+  };
+};
 var buildMediaResamplingPlan = (input) => {
   const required = !formatMatches(input.inputFormat, input.outputFormat);
   return {

package/dist/svelte/index.js

@@ -3441,6 +3441,29 @@ var telephonyDirection = (track) => {
   return "unknown";
 };
 var telephonyFrameKind = (direction) => direction === "outbound" ? "assistant-audio" : "input-audio";
+var telephonyEventKind = (envelope) => {
+  const raw = firstString([envelope], ["event", "type", "eventType"]) ?? firstString([unknownRecord(envelope.message)], ["event", "type"]);
+  const normalized = raw?.toLowerCase().replace(/[_\s-]+/g, "-");
+  if (!normalized) {
+    return "unknown";
+  }
+  if (normalized.includes("connected")) {
+    return "connected";
+  }
+  if (normalized.includes("start")) {
+    return "start";
+  }
+  if (normalized.includes("media")) {
+    return "media";
+  }
+  if (normalized.includes("stop") || normalized.includes("closed")) {
+    return "stop";
+  }
+  if (normalized.includes("error") || normalized.includes("failed")) {
+    return "error";
+  }
+  return "unknown";
+};
 var normalizeWebRTCStat = (stat) => {
   const sample = {};
   for (const [key, value] of Object.entries(stat)) {
@@ -3557,6 +3580,86 @@ var createTelephonyMediaSerializer = (input) => {
     })
   };
 };
+var parseTelephonyStreamEvent = (input) => {
+  const envelope = input.envelope;
+  const media = unknownRecord(envelope.media);
+  const start = unknownRecord(envelope.start);
+  const stop = unknownRecord(envelope.stop);
+  const errorRecord = unknownRecord(envelope.error);
+  const kind = telephonyEventKind(envelope);
+  const carrier = input.carrier ?? firstString([envelope], ["provider", "carrier"]) ?? "telephony";
+  const frame = kind === "media" ? parseTelephonyMediaFrame({
+    carrier,
+    envelope,
+    format: input.format,
+    sessionId: input.sessionId
+  }) : undefined;
+  const streamId = firstString([media, start, stop, envelope], ["streamSid", "stream_id", "streamId", "callSid", "call_id"]) ?? input.sessionId;
+  const sequenceNumber = firstString([media, envelope], ["sequenceNumber", "sequence_number", "chunk"]);
+  const track = firstString([media, envelope], ["track", "direction"]);
+  return {
+    audioBytes: frame?.audio ? frame.audio instanceof ArrayBuffer ? frame.audio.byteLength : frame.audio.byteLength : 0,
+    at: frame?.at ?? firstNumber([media, start, stop, envelope], ["timestamp", "time", "startedAt"]),
+    carrier,
+    direction: telephonyDirection(track),
+    error: firstString([errorRecord, envelope], ["message", "error", "reason"]),
+    kind,
+    sequenceNumber,
+    streamId
+  };
+};
+var buildMediaTelephonyStreamLifecycleReport = (input = {}) => {
+  const envelopes = input.envelopes ?? [];
+  const events = envelopes.map((envelope) => parseTelephonyStreamEvent({
+    carrier: input.carrier,
+    envelope
+  }));
+  const issues = [];
+  const startedIndex = events.findIndex((event) => event.kind === "start");
+  const firstMediaIndex = events.findIndex((event) => event.kind === "media");
+  const stoppedIndex = events.findIndex((event) => event.kind === "stop");
+  const started = startedIndex >= 0;
+  const stopped = stoppedIndex >= 0;
+  const mediaEvents = events.filter((event) => event.kind === "media");
+  const audioBytes = events.reduce((total, event) => total + event.audioBytes, 0);
+  const minAudioBytes = input.minAudioBytes ?? 1;
+  const streamIds = Array.from(new Set(events.map((event) => event.streamId).filter(Boolean)));
+  if ((input.requireStart ?? true) && !started) {
+    pushIssue(issues, "error", "media.telephony_missing_start", "Telephony media stream did not include a start event.");
+  }
+  if ((input.requireMedia ?? true) && mediaEvents.length === 0) {
+    pushIssue(issues, "error", "media.telephony_missing_media", "Telephony media stream did not include media payload events.");
+  }
+  if ((input.requireStop ?? true) && !stopped) {
+    pushIssue(issues, input.maxMissingStop === false ? "warning" : "error", "media.telephony_missing_stop", "Telephony media stream did not include a stop event.");
+  }
+  if (started && firstMediaIndex >= 0 && firstMediaIndex < startedIndex) {
+    pushIssue(issues, "error", "media.telephony_media_before_start", "Telephony media payload arrived before the stream start event.");
+  }
+  if (stopped && firstMediaIndex >= 0 && stoppedIndex < firstMediaIndex) {
+    pushIssue(issues, "error", "media.telephony_stop_before_media", "Telephony media stream stopped before any media payload arrived.");
+  }
+  if (mediaEvents.length > 0 && audioBytes < minAudioBytes) {
+    pushIssue(issues, "error", "media.telephony_no_audio_bytes", `Telephony media stream parsed ${String(audioBytes)} audio byte(s), below required ${String(minAudioBytes)}.`);
+  }
+  for (const event of events) {
+    if (event.kind === "error") {
+      pushIssue(issues, "error", "media.telephony_stream_error", event.error ?? "Telephony media stream emitted an error event.");
+    }
+  }
+  return {
+    audioBytes,
+    carrier: input.carrier,
+    checkedAt: Date.now(),
+    events,
+    issues,
+    mediaEvents: mediaEvents.length,
+    started,
+    status: issues.some((issue) => issue.severity === "error") ? "fail" : issues.length > 0 ? "warn" : "pass",
+    stopped,
+    streamIds
+  };
+};
 var buildMediaResamplingPlan = (input) => {
   const required = !formatMatches(input.inputFormat, input.outputFormat);
   return {

package/dist/telephonyMediaRoutes.d.ts

@@ -1,15 +1,17 @@
 import { Elysia } from 'elysia';
-import type { MediaFrame, MediaTelephonyCarrier, MediaTelephonyEnvelope } from '@absolutejs/media';
+import type { MediaFrame, MediaTelephonyCarrier, MediaTelephonyEnvelope, MediaTelephonyStreamLifecycleReport } from '@absolutejs/media';
 export type VoiceTelephonyMediaStatus = 'fail' | 'pass';
 export type VoiceTelephonyMediaCarrierInput = {
     carrier: MediaTelephonyCarrier;
     envelope?: MediaTelephonyEnvelope;
+    lifecycleEnvelopes?: readonly MediaTelephonyEnvelope[];
 };
 export type VoiceTelephonyMediaCarrierReport = {
     audioBytes: number;
     carrier: MediaTelephonyCarrier;
     frame?: MediaFrame;
     issues: string[];
+    lifecycle: MediaTelephonyStreamLifecycleReport;
     serialized?: MediaTelephonyEnvelope;
     status: VoiceTelephonyMediaStatus;
 };

package/dist/testing/index.js

@@ -2243,6 +2243,29 @@ var telephonyDirection = (track) => {
   return "unknown";
 };
 var telephonyFrameKind = (direction) => direction === "outbound" ? "assistant-audio" : "input-audio";
+var telephonyEventKind = (envelope) => {
+  const raw = firstString([envelope], ["event", "type", "eventType"]) ?? firstString([unknownRecord(envelope.message)], ["event", "type"]);
+  const normalized = raw?.toLowerCase().replace(/[_\s-]+/g, "-");
+  if (!normalized) {
+    return "unknown";
+  }
+  if (normalized.includes("connected")) {
+    return "connected";
+  }
+  if (normalized.includes("start")) {
+    return "start";
+  }
+  if (normalized.includes("media")) {
+    return "media";
+  }
+  if (normalized.includes("stop") || normalized.includes("closed")) {
+    return "stop";
+  }
+  if (normalized.includes("error") || normalized.includes("failed")) {
+    return "error";
+  }
+  return "unknown";
+};
 var normalizeWebRTCStat = (stat) => {
   const sample = {};
   for (const [key, value] of Object.entries(stat)) {
@@ -2359,6 +2382,86 @@ var createTelephonyMediaSerializer = (input) => {
     })
   };
 };
+var parseTelephonyStreamEvent = (input) => {
+  const envelope = input.envelope;
+  const media = unknownRecord(envelope.media);
+  const start = unknownRecord(envelope.start);
+  const stop = unknownRecord(envelope.stop);
+  const errorRecord = unknownRecord(envelope.error);
+  const kind = telephonyEventKind(envelope);
+  const carrier = input.carrier ?? firstString([envelope], ["provider", "carrier"]) ?? "telephony";
+  const frame = kind === "media" ? parseTelephonyMediaFrame({
+    carrier,
+    envelope,
+    format: input.format,
+    sessionId: input.sessionId
+  }) : undefined;
+  const streamId = firstString([media, start, stop, envelope], ["streamSid", "stream_id", "streamId", "callSid", "call_id"]) ?? input.sessionId;
+  const sequenceNumber = firstString([media, envelope], ["sequenceNumber", "sequence_number", "chunk"]);
+  const track = firstString([media, envelope], ["track", "direction"]);
+  return {
+    audioBytes: frame?.audio ? frame.audio instanceof ArrayBuffer ? frame.audio.byteLength : frame.audio.byteLength : 0,
+    at: frame?.at ?? firstNumber([media, start, stop, envelope], ["timestamp", "time", "startedAt"]),
+    carrier,
+    direction: telephonyDirection(track),
+    error: firstString([errorRecord, envelope], ["message", "error", "reason"]),
+    kind,
+    sequenceNumber,
+    streamId
+  };
+};
+var buildMediaTelephonyStreamLifecycleReport = (input = {}) => {
+  const envelopes = input.envelopes ?? [];
+  const events = envelopes.map((envelope) => parseTelephonyStreamEvent({
+    carrier: input.carrier,
+    envelope
+  }));
+  const issues = [];
+  const startedIndex = events.findIndex((event) => event.kind === "start");
+  const firstMediaIndex = events.findIndex((event) => event.kind === "media");
+  const stoppedIndex = events.findIndex((event) => event.kind === "stop");
+  const started = startedIndex >= 0;
+  const stopped = stoppedIndex >= 0;
+  const mediaEvents = events.filter((event) => event.kind === "media");
+  const audioBytes = events.reduce((total, event) => total + event.audioBytes, 0);
+  const minAudioBytes = input.minAudioBytes ?? 1;
+  const streamIds = Array.from(new Set(events.map((event) => event.streamId).filter(Boolean)));
+  if ((input.requireStart ?? true) && !started) {
+    pushIssue(issues, "error", "media.telephony_missing_start", "Telephony media stream did not include a start event.");
+  }
+  if ((input.requireMedia ?? true) && mediaEvents.length === 0) {
+    pushIssue(issues, "error", "media.telephony_missing_media", "Telephony media stream did not include media payload events.");
+  }
+  if ((input.requireStop ?? true) && !stopped) {
+    pushIssue(issues, input.maxMissingStop === false ? "warning" : "error", "media.telephony_missing_stop", "Telephony media stream did not include a stop event.");
+  }
+  if (started && firstMediaIndex >= 0 && firstMediaIndex < startedIndex) {
+    pushIssue(issues, "error", "media.telephony_media_before_start", "Telephony media payload arrived before the stream start event.");
+  }
+  if (stopped && firstMediaIndex >= 0 && stoppedIndex < firstMediaIndex) {
+    pushIssue(issues, "error", "media.telephony_stop_before_media", "Telephony media stream stopped before any media payload arrived.");
+  }
+  if (mediaEvents.length > 0 && audioBytes < minAudioBytes) {
+    pushIssue(issues, "error", "media.telephony_no_audio_bytes", `Telephony media stream parsed ${String(audioBytes)} audio byte(s), below required ${String(minAudioBytes)}.`);
+  }
+  for (const event of events) {
+    if (event.kind === "error") {
+      pushIssue(issues, "error", "media.telephony_stream_error", event.error ?? "Telephony media stream emitted an error event.");
+    }
+  }
+  return {
+    audioBytes,
+    carrier: input.carrier,
+    checkedAt: Date.now(),
+    events,
+    issues,
+    mediaEvents: mediaEvents.length,
+    started,
+    status: issues.some((issue) => issue.severity === "error") ? "fail" : issues.length > 0 ? "warn" : "pass",
+    stopped,
+    streamIds
+  };
+};
 var buildMediaResamplingPlan = (input) => {
   const required = !formatMatches(input.inputFormat, input.outputFormat);
   return {

package/dist/vue/index.js

@@ -4825,6 +4825,29 @@ var telephonyDirection = (track) => {
   return "unknown";
 };
 var telephonyFrameKind = (direction) => direction === "outbound" ? "assistant-audio" : "input-audio";
+var telephonyEventKind = (envelope) => {
+  const raw = firstString([envelope], ["event", "type", "eventType"]) ?? firstString([unknownRecord(envelope.message)], ["event", "type"]);
+  const normalized = raw?.toLowerCase().replace(/[_\s-]+/g, "-");
+  if (!normalized) {
+    return "unknown";
+  }
+  if (normalized.includes("connected")) {
+    return "connected";
+  }
+  if (normalized.includes("start")) {
+    return "start";
+  }
+  if (normalized.includes("media")) {
+    return "media";
+  }
+  if (normalized.includes("stop") || normalized.includes("closed")) {
+    return "stop";
+  }
+  if (normalized.includes("error") || normalized.includes("failed")) {
+    return "error";
+  }
+  return "unknown";
+};
 var normalizeWebRTCStat = (stat) => {
   const sample = {};
   for (const [key, value] of Object.entries(stat)) {
@@ -4941,6 +4964,86 @@ var createTelephonyMediaSerializer = (input) => {
     })
   };
 };
+var parseTelephonyStreamEvent = (input) => {
+  const envelope = input.envelope;
+  const media = unknownRecord(envelope.media);
+  const start = unknownRecord(envelope.start);
+  const stop = unknownRecord(envelope.stop);
+  const errorRecord = unknownRecord(envelope.error);
+  const kind = telephonyEventKind(envelope);
+  const carrier = input.carrier ?? firstString([envelope], ["provider", "carrier"]) ?? "telephony";
+  const frame = kind === "media" ? parseTelephonyMediaFrame({
+    carrier,
+    envelope,
+    format: input.format,
+    sessionId: input.sessionId
+  }) : undefined;
+  const streamId = firstString([media, start, stop, envelope], ["streamSid", "stream_id", "streamId", "callSid", "call_id"]) ?? input.sessionId;
+  const sequenceNumber = firstString([media, envelope], ["sequenceNumber", "sequence_number", "chunk"]);
+  const track = firstString([media, envelope], ["track", "direction"]);
+  return {
+    audioBytes: frame?.audio ? frame.audio instanceof ArrayBuffer ? frame.audio.byteLength : frame.audio.byteLength : 0,
+    at: frame?.at ?? firstNumber([media, start, stop, envelope], ["timestamp", "time", "startedAt"]),
+    carrier,
+    direction: telephonyDirection(track),
+    error: firstString([errorRecord, envelope], ["message", "error", "reason"]),
+    kind,
+    sequenceNumber,
+    streamId
+  };
+};
+var buildMediaTelephonyStreamLifecycleReport = (input = {}) => {
+  const envelopes = input.envelopes ?? [];
+  const events = envelopes.map((envelope) => parseTelephonyStreamEvent({
+    carrier: input.carrier,
+    envelope
+  }));
+  const issues = [];
+  const startedIndex = events.findIndex((event) => event.kind === "start");
+  const firstMediaIndex = events.findIndex((event) => event.kind === "media");
+  const stoppedIndex = events.findIndex((event) => event.kind === "stop");
+  const started = startedIndex >= 0;
+  const stopped = stoppedIndex >= 0;
+  const mediaEvents = events.filter((event) => event.kind === "media");
+  const audioBytes = events.reduce((total, event) => total + event.audioBytes, 0);
+  const minAudioBytes = input.minAudioBytes ?? 1;
+  const streamIds = Array.from(new Set(events.map((event) => event.streamId).filter(Boolean)));
+  if ((input.requireStart ?? true) && !started) {
+    pushIssue(issues, "error", "media.telephony_missing_start", "Telephony media stream did not include a start event.");
+  }
+  if ((input.requireMedia ?? true) && mediaEvents.length === 0) {
+    pushIssue(issues, "error", "media.telephony_missing_media", "Telephony media stream did not include media payload events.");
+  }
+  if ((input.requireStop ?? true) && !stopped) {
+    pushIssue(issues, input.maxMissingStop === false ? "warning" : "error", "media.telephony_missing_stop", "Telephony media stream did not include a stop event.");
+  }
+  if (started && firstMediaIndex >= 0 && firstMediaIndex < startedIndex) {
+    pushIssue(issues, "error", "media.telephony_media_before_start", "Telephony media payload arrived before the stream start event.");
+  }
+  if (stopped && firstMediaIndex >= 0 && stoppedIndex < firstMediaIndex) {
+    pushIssue(issues, "error", "media.telephony_stop_before_media", "Telephony media stream stopped before any media payload arrived.");
+  }
+  if (mediaEvents.length > 0 && audioBytes < minAudioBytes) {
+    pushIssue(issues, "error", "media.telephony_no_audio_bytes", `Telephony media stream parsed ${String(audioBytes)} audio byte(s), below required ${String(minAudioBytes)}.`);
+  }
+  for (const event of events) {
+    if (event.kind === "error") {
+      pushIssue(issues, "error", "media.telephony_stream_error", event.error ?? "Telephony media stream emitted an error event.");
+    }
+  }
+  return {
+    audioBytes,
+    carrier: input.carrier,
+    checkedAt: Date.now(),
+    events,
+    issues,
+    mediaEvents: mediaEvents.length,
+    started,
+    status: issues.some((issue) => issue.severity === "error") ? "fail" : issues.length > 0 ? "warn" : "pass",
+    stopped,
+    streamIds
+  };
+};
 var buildMediaResamplingPlan = (input) => {
   const required = !formatMatches(input.inputFormat, input.outputFormat);
   return {

package/dist/vue/useVoiceReadinessFailures.d.ts

@@ -57,6 +57,7 @@ export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceR
             readonly opsRecovery?: string | undefined;
             readonly phoneAgentSmoke?: string | undefined;
             readonly telephonyWebhookSecurity?: string | undefined;
+            readonly telephonyMedia?: string | undefined;
             readonly providerContracts?: string | undefined;
             readonly providerOrchestration?: string | undefined;
             readonly providerRoutingContracts?: string | undefined;
@@ -373,6 +374,16 @@ export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceR
                 readonly status: import("..").VoiceProductionReadinessStatus;
                 readonly warned: number;
             } | undefined;
+            readonly telephonyMedia?: {
+                readonly audioBytes: number;
+                readonly carriers: number;
+                readonly failed: number;
+                readonly issues: number;
+                readonly lifecycleFailures: number;
+                readonly mediaEvents: number;
+                readonly passed: number;
+                readonly status: import("..").VoiceProductionReadinessStatus;
+            } | undefined;
             readonly providerRoutingContracts?: {
                 readonly failed: number;
                 readonly passed: number;
@@ -471,6 +482,7 @@ export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceR
             readonly opsRecovery?: string | undefined;
             readonly phoneAgentSmoke?: string | undefined;
             readonly telephonyWebhookSecurity?: string | undefined;
+            readonly telephonyMedia?: string | undefined;
             readonly providerContracts?: string | undefined;
             readonly providerOrchestration?: string | undefined;
             readonly providerRoutingContracts?: string | undefined;
@@ -787,6 +799,16 @@ export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceR
                 readonly status: import("..").VoiceProductionReadinessStatus;
                 readonly warned: number;
             } | undefined;
+            readonly telephonyMedia?: {
+                readonly audioBytes: number;
+                readonly carriers: number;
+                readonly failed: number;
+                readonly issues: number;
+                readonly lifecycleFailures: number;
+                readonly mediaEvents: number;
+                readonly passed: number;
+                readonly status: import("..").VoiceProductionReadinessStatus;
+            } | undefined;
             readonly providerRoutingContracts?: {
                 readonly failed: number;
                 readonly passed: number;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@absolutejs/voice",
-	"version": "0.0.22-beta.323",
+	"version": "0.0.22-beta.325",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",
@@ -246,7 +246,7 @@
 		}
 	},
 	"dependencies": {
-		"@absolutejs/media": "0.0.1-beta.6"
+		"@absolutejs/media": "0.0.1-beta.7"
 	},
 	"devDependencies": {
 		"@absolutejs/absolute": "0.19.0-beta.646",