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

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";
@@ -30124,6 +30278,21 @@ var buildOperationsRecordLinks = (input) => {
     sessionId,
     status: "fail"
   })) : [];
+  const telephonyMedia = input.telephonyMedia && input.telephonyMedia.status !== "pass" ? input.telephonyMedia.carriers.filter((carrier) => carrier.status !== "pass").flatMap((carrier) => {
+    const sessionIds = [
+      ...carrier.lifecycle.streamIds,
+      carrier.frame?.sessionId
+    ].filter((value, index, values) => typeof value === "string" && value.length > 0 && values.indexOf(value) === index);
+    const fallbackSessionId = `${carrier.carrier}-telephony-media`;
+    const ids = sessionIds.length > 0 ? sessionIds : [fallbackSessionId];
+    return ids.map((sessionId) => ({
+      detail: carrier.issues[0] ?? `${carrier.lifecycle.issues.length} telephony media lifecycle issue(s)`,
+      href: voiceOperationsRecordHref(input.base, sessionId),
+      label: "Open telephony media operations record",
+      sessionId,
+      status: "fail"
+    }));
+  }) : [];
   return {
     failedSessions: input.failedSessionIds.map((sessionId) => ({
       href: voiceOperationsRecordHref(input.base, sessionId),
@@ -30133,7 +30302,8 @@ var buildOperationsRecordLinks = (input) => {
     })),
     failingLatency,
     mediaQuality,
-    providerErrors
+    providerErrors,
+    telephonyMedia
   };
 };
 var firstOperationsRecordHref = (links) => links[0]?.href;
@@ -30234,7 +30404,8 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     liveLatencyFailAfterMs: options.liveLatencyFailAfterMs ?? 3200,
     liveLatencyMaxAgeMs: options.liveLatencyMaxAgeMs,
     liveLatencyWarnAfterMs: options.liveLatencyWarnAfterMs ?? 1800,
-    mediaPipeline
+    mediaPipeline,
+    telephonyMedia
   });
   const checks = [
     {
@@ -30416,6 +30587,8 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     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;
@@ -30514,22 +30687,29 @@ 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) parsed into MediaFrame objects.` : firstIssue ?? `${telephonyMediaSummary.issues} telephony media serializer issue(s) need review.`,
-      href: options.links?.telephonyMedia ?? "/voice/telephony-media",
+      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: firstOperationsRecordHref(operationsRecords.telephonyMedia) ?? options.links?.telephonyMedia ?? "/voice/telephony-media",
       label: "Telephony media serializers",
       proofSource: proofSource("telephonyMedia", "carrierMediaSerializers"),
       gateExplanation: telephonyMediaSummary.status === "pass" ? undefined : {
-        evidenceHref: options.links?.telephonyMedia ?? "/voice/telephony-media",
+        evidenceHref: firstOperationsRecordHref(operationsRecords.telephonyMedia) ?? options.links?.telephonyMedia ?? "/voice/telephony-media",
         observed: firstIssue ?? `${telephonyMediaSummary.issues} issue(s)`,
-        remediation: "Inspect carrier media serializer proof, fix payload parsing or outbound envelope serialization, then rerun readiness proof.",
-        thresholdLabel: "Telephony media serializer status",
+        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" ? [] : [
+        ...firstOperationsRecordHref(operationsRecords.telephonyMedia) ? [
+          {
+            description: "Open the exact call/session operations record for the first telephony media lifecycle issue.",
+            href: firstOperationsRecordHref(operationsRecords.telephonyMedia),
+            label: "Open telephony media operations record"
+          }
+        ] : [],
         {
-          description: "Open telephony media proof and inspect carrier media payload parsing, MediaFrame shape, and outbound envelope serialization.",
+          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"
         }

package/dist/productionReadiness.d.ts

@@ -301,6 +301,8 @@ export type VoiceProductionReadinessReport = {
             carriers: number;
             failed: number;
             issues: number;
+            lifecycleFailures: number;
+            mediaEvents: number;
             passed: number;
             status: VoiceProductionReadinessStatus;
         };
@@ -349,6 +351,7 @@ export type VoiceProductionReadinessOperationsRecordLinks = {
     failingLatency: VoiceProductionReadinessOperationsRecordLink[];
     mediaQuality: VoiceProductionReadinessOperationsRecordLink[];
     providerErrors: VoiceProductionReadinessOperationsRecordLink[];
+    telephonyMedia: VoiceProductionReadinessOperationsRecordLink[];
 };
 export type VoiceProductionReadinessAuditRequirement = {
     label?: string;

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

@@ -118,6 +118,13 @@ export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceR
                 readonly sessionId: string;
                 readonly status: import("..").VoiceProductionReadinessStatus;
             }[];
+            readonly telephonyMedia: readonly {
+                readonly detail?: string | undefined;
+                readonly href: string;
+                readonly label: string;
+                readonly sessionId: string;
+                readonly status: import("..").VoiceProductionReadinessStatus;
+            }[];
         } | undefined;
         readonly status: import("..").VoiceProductionReadinessStatus;
         readonly summary: {
@@ -379,6 +386,8 @@ export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceR
                 readonly carriers: number;
                 readonly failed: number;
                 readonly issues: number;
+                readonly lifecycleFailures: number;
+                readonly mediaEvents: number;
                 readonly passed: number;
                 readonly status: import("..").VoiceProductionReadinessStatus;
             } | undefined;
@@ -541,6 +550,13 @@ export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceR
                 readonly sessionId: string;
                 readonly status: import("..").VoiceProductionReadinessStatus;
             }[];
+            readonly telephonyMedia: readonly {
+                readonly detail?: string | undefined;
+                readonly href: string;
+                readonly label: string;
+                readonly sessionId: string;
+                readonly status: import("..").VoiceProductionReadinessStatus;
+            }[];
         } | undefined;
         readonly status: import("..").VoiceProductionReadinessStatus;
         readonly summary: {
@@ -802,6 +818,8 @@ export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceR
                 readonly carriers: number;
                 readonly failed: number;
                 readonly issues: number;
+                readonly lifecycleFailures: number;
+                readonly mediaEvents: number;
                 readonly passed: number;
                 readonly status: import("..").VoiceProductionReadinessStatus;
             } | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@absolutejs/voice",
-	"version": "0.0.22-beta.324",
+	"version": "0.0.22-beta.326",
 	"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",