@absolutejs/voice 0.0.22-beta.330 → 0.0.22-beta.332

package/dist/competitiveCoverage.d.ts

@@ -4,7 +4,7 @@ export type VoiceCompetitiveCoverageLevel = 'covered' | 'intentional-gap' | 'mis
 export type VoiceCompetitiveDepthLevel = 'advantage' | 'covered' | 'intentional-gap' | 'lag' | 'parity';
 export type VoiceCompetitiveEvidence = {
     href?: string;
-    kind?: 'docs' | 'example' | 'operations-record' | 'proof' | 'readiness' | 'route' | 'test';
+    kind?: 'docs' | 'example' | 'failure-replay' | 'operations-record' | 'proof' | 'readiness' | 'route' | 'test';
     name: string;
     required?: boolean;
     status?: 'fail' | 'pass' | 'warn';

package/dist/index.d.ts

@@ -73,7 +73,7 @@ export { acknowledgeVoiceMonitorIssue, buildVoiceMonitorRunReport, createVoiceMe
 export { createVoiceReadinessProfile, recommendVoiceReadinessProfile } from './readinessProfiles';
 export { assertVoiceProviderContractMatrixEvidence, assertVoiceProviderStackEvidence, buildVoiceProviderContractMatrix, createVoiceProviderContractMatrixHTMLHandler, createVoiceProviderContractMatrixJSONHandler, createVoiceProviderContractMatrixPreset, createVoiceProviderContractMatrixRoutes, evaluateVoiceProviderContractMatrixEvidence, evaluateVoiceProviderStackEvidence, evaluateVoiceProviderStackGaps, renderVoiceProviderContractMatrixHTML, recommendVoiceProviderStack } from './providerStackRecommendations';
 export { buildVoiceOpsConsoleReport, createVoiceOpsConsoleRoutes, renderVoiceOpsConsoleHTML } from './opsConsoleRoutes';
-export { assertVoiceOperationsRecordGuardrails, assertVoiceOperationsRecordProviderRecovery, buildVoiceOperationsRecord, createVoiceOperationsRecordRoutes, evaluateVoiceOperationsRecordGuardrails, evaluateVoiceOperationsRecordProviderRecovery, renderVoiceOperationsRecordGuardrailMarkdown, renderVoiceOperationsRecordHTML, renderVoiceOperationsRecordIncidentMarkdown } from './operationsRecord';
+export { assertVoiceOperationsRecordGuardrails, assertVoiceOperationsRecordProviderRecovery, buildVoiceFailureReplay, buildVoiceOperationsRecord, createVoiceOperationsRecordRoutes, evaluateVoiceOperationsRecordGuardrails, evaluateVoiceOperationsRecordProviderRecovery, renderVoiceFailureReplayMarkdown, renderVoiceOperationsRecordGuardrailMarkdown, renderVoiceOperationsRecordHTML, renderVoiceOperationsRecordIncidentMarkdown } from './operationsRecord';
 export { assertVoiceObservabilityExportDeliveryEvidence, assertVoiceObservabilityExportRecord, assertVoiceObservabilityExportReplayEvidence, buildVoiceObservabilityArtifactIndex, buildVoiceObservabilityExportDeliveryHistory, buildVoiceObservabilityExportReplayReport, buildVoiceObservabilityExport, assertVoiceObservabilityExportSchema, createVoiceObservabilityExportSchema, createVoiceFileObservabilityExportDeliveryReceiptStore, createVoiceMemoryObservabilityExportDeliveryReceiptStore, createVoiceObservabilityExportRoutes, createVoiceObservabilityExportReplayRoutes, deliverVoiceObservabilityExport, evaluateVoiceObservabilityExportDeliveryEvidence, evaluateVoiceObservabilityExportReplayEvidence, loadVoiceObservabilityExportReplaySource, replayVoiceObservabilityExport, renderVoiceObservabilityExportReplayHTML, renderVoiceObservabilityExportMarkdown, validateVoiceObservabilityExportRecord, voiceObservabilityExportSchemaId, voiceObservabilityExportSchemaVersion } from './observabilityExport';
 export { buildVoiceOpsRecoveryReadinessCheck, buildVoiceOpsRecoveryReport, createVoiceOpsRecoveryRoutes, renderVoiceOpsRecoveryHTML, renderVoiceOpsRecoveryMarkdown } from './opsRecovery';
 export { buildVoiceIncidentBundle, createStoredVoiceIncidentBundleArtifact, createVoiceIncidentBundleRoutes, createVoiceMemoryIncidentBundleStore, pruneVoiceIncidentBundleArtifacts, saveVoiceIncidentBundleArtifact } from './incidentBundle';
@@ -142,7 +142,7 @@ export type { VoiceProductionReadinessAction, VoiceProductionReadinessAuditOptio
 export type { VoiceMonitorDefinition, VoiceMonitorEvaluation, VoiceMonitorEvaluationInput, VoiceMonitorIssue, VoiceMonitorIssueStatus, VoiceMonitorIssueStore, VoiceMonitorNotifier, VoiceMonitorNotifierDeliveryInput, VoiceMonitorNotifierDeliveryOptions, VoiceMonitorNotifierDeliveryReceipt, VoiceMonitorNotifierDeliveryReceiptStore, VoiceMonitorNotifierDeliveryReport, VoiceMonitorNotifierDeliveryResult, VoiceMonitorRoutesOptions, VoiceMonitorRun, VoiceMonitorRunOptions, VoiceMonitorRunReport, VoiceMonitorRunner, VoiceMonitorRunnerOptions, VoiceMonitorRunnerRoutesOptions, VoiceMonitorRunnerTickResult, VoiceMonitorSeverity, VoiceMonitorStatus, VoiceMonitorWebhookNotifierOptions } from './voiceMonitoring';
 export type { VoiceReadinessProfileName, VoiceReadinessProfileOptions, VoiceReadinessProfileRecommendation, VoiceReadinessProfileRecommendationScore, VoiceReadinessProfileRoutesOptions } from './readinessProfiles';
 export type { VoiceProviderStackChoice, VoiceProviderStackCapabilities, VoiceProviderStackCapabilityGap, VoiceProviderStackCapabilityGapInput, VoiceProviderStackCapabilityGapReport, VoiceProviderContractCheck, VoiceProviderContractCheckStatus, VoiceProviderContractDefinition, VoiceProviderContractMatrixAssertionInput, VoiceProviderContractMatrixAssertionReport, VoiceProviderContractMatrixHandlerOptions, VoiceProviderContractMatrixHTMLHandlerOptions, VoiceProviderContractMatrixInput, VoiceProviderContractMatrixPresetOptions, VoiceProviderContractMatrixReport, VoiceProviderContractMatrixRoutesOptions, VoiceProviderContractMatrixRow, VoiceProviderStackAssertionInput, VoiceProviderStackAssertionReport, VoiceProviderStackInput, VoiceProviderStackKind, VoiceProviderStackRecommendation } from './providerStackRecommendations';
-export type { VoiceOperationsRecord, VoiceOperationsRecordAgentHandoff, VoiceOperationsRecordAuditSummary, VoiceOperationsRecordGuardrailAssertionInput, VoiceOperationsRecordGuardrailAssertionReport, VoiceOperationsRecordGuardrailDecision, VoiceOperationsRecordGuardrailFinding, VoiceOperationsRecordGuardrailSummary, VoiceOperationsRecordIntegrationEventSummary, VoiceOperationsRecordOptions, VoiceOperationsRecordOutcome, VoiceOperationsRecordProviderDecision, VoiceOperationsRecordProviderDecisionRecoveryStatus, VoiceOperationsRecordProviderDecisionSummary, VoiceOperationsRecordProviderRecoveryAssertionInput, VoiceOperationsRecordProviderRecoveryAssertionReport, VoiceOperationsRecordReviewSummary, VoiceOperationsRecordRoutesOptions, VoiceOperationsRecordStatus, VoiceOperationsRecordTaskSummary, VoiceOperationsRecordTelephonyMediaEvent, VoiceOperationsRecordTelephonyMediaSummary, VoiceOperationsRecordTranscriptTurn, VoiceOperationsRecordTool } from './operationsRecord';
+export type { VoiceFailureReplayMediaStep, VoiceFailureReplayOptions, VoiceFailureReplayProviderStep, VoiceFailureReplayReport, VoiceFailureReplayStatus, VoiceFailureReplayTurn, VoiceOperationsRecord, VoiceOperationsRecordAgentHandoff, VoiceOperationsRecordAuditSummary, VoiceOperationsRecordGuardrailAssertionInput, VoiceOperationsRecordGuardrailAssertionReport, VoiceOperationsRecordGuardrailDecision, VoiceOperationsRecordGuardrailFinding, VoiceOperationsRecordGuardrailSummary, VoiceOperationsRecordIntegrationEventSummary, VoiceOperationsRecordOptions, VoiceOperationsRecordOutcome, VoiceOperationsRecordProviderDecision, VoiceOperationsRecordProviderDecisionRecoveryStatus, VoiceOperationsRecordProviderDecisionSummary, VoiceOperationsRecordProviderRecoveryAssertionInput, VoiceOperationsRecordProviderRecoveryAssertionReport, VoiceOperationsRecordReviewSummary, VoiceOperationsRecordRoutesOptions, VoiceOperationsRecordStatus, VoiceOperationsRecordTaskSummary, VoiceOperationsRecordTelephonyMediaEvent, VoiceOperationsRecordTelephonyMediaSummary, VoiceOperationsRecordTranscriptTurn, VoiceOperationsRecordTool } from './operationsRecord';
 export type { VoiceObservabilityExportArtifact, VoiceObservabilityExportArtifactChecksum, VoiceObservabilityExportArtifactFreshness, VoiceObservabilityExportArtifactIndex, VoiceObservabilityExportArtifactIndexItem, VoiceObservabilityExportArtifactKind, VoiceObservabilityExportDeliveryAssertionInput, VoiceObservabilityExportDeliveryAssertionReport, VoiceObservabilityExportDeliverySummary, VoiceObservabilityExportDeliveryDestination, VoiceObservabilityExportDeliveryDestinationResult, VoiceObservabilityExportDeliveryHistory, VoiceObservabilityExportDeliveryOptions, VoiceObservabilityExportDeliveryReceipt, VoiceObservabilityExportDeliveryReceiptStore, VoiceObservabilityExportDeliveryReport, VoiceObservabilityExportEnvelope, VoiceObservabilityExportIssue, VoiceObservabilityExportIssueCode, VoiceObservabilityExportOptions, VoiceObservabilityExportIngestedRecordKind, VoiceObservabilityExportRedactionSummary, VoiceObservabilityExportRecordValidationOptions, VoiceObservabilityExportReplayIssue, VoiceObservabilityExportReplayIssueCode, VoiceObservabilityExportReplayAssertionInput, VoiceObservabilityExportReplayAssertionReport, VoiceObservabilityExportReplayRecords, VoiceObservabilityExportReplayReport, VoiceObservabilityExportReplayRoutesOptions, VoiceObservabilityExportReplaySource, VoiceObservabilityExportReport, VoiceObservabilityExportRoutesOptions, VoiceObservabilityExportSchema, VoiceObservabilityExportStatus, VoiceObservabilityExportValidationIssue, VoiceObservabilityExportValidationResult } from './observabilityExport';
 export type { VoiceOpsRecoveryFailedSession, VoiceOpsRecoveryInterventionSummary, VoiceOpsRecoveryIssue, VoiceOpsRecoveryIssueCode, VoiceOpsRecoveryLinks, VoiceOpsRecoveryProviderSummary, VoiceOpsRecoveryReport, VoiceOpsRecoveryReportOptions, VoiceOpsRecoveryRoutesOptions, VoiceOpsRecoveryStatus } from './opsRecovery';
 export type { StoredVoiceIncidentBundleArtifact, VoiceIncidentBundle, VoiceIncidentBundleArtifactOptions, VoiceIncidentBundleFormat, VoiceIncidentBundleOptions, VoiceIncidentBundleRetentionOptions, VoiceIncidentBundleRetentionReport, VoiceIncidentBundleRoutesOptions, VoiceIncidentBundleStore, VoiceIncidentBundleStoreFilter, VoiceIncidentBundleSummary } from './incidentBundle';

package/dist/index.js

@@ -27838,6 +27838,7 @@ var pushMissingValuesIssue = (input) => {
   }
 };
 var resolveRoutePath = (path, sessionId) => path.replace(":sessionId", encodeURIComponent(sessionId));
+var resolveOperationsRecordHref = (href, record) => typeof href === "function" ? href({ record, sessionId: record.sessionId }) : href;
 var toHandoff = (event) => ({
   at: event.at,
   fromAgentId: getString17(event.payload.fromAgentId),
@@ -28252,6 +28253,150 @@ var assertVoiceOperationsRecordProviderRecovery = (record, input = {}) => {
   }
   return report;
 };
+var getAssistantRepliesForTurn = (record, turnId) => turnId ? record.transcript.find((turn) => turn.id === turnId)?.assistantReplies ?? [] : [];
+var mediaIssueForStep = (step) => {
+  const event = step.event.toLowerCase();
+  if (event === "error") {
+    return "Carrier media stream emitted an error.";
+  }
+  if (event === "media" && step.audioBytes <= 0) {
+    return "Carrier media packet had no audio bytes.";
+  }
+  return;
+};
+var buildVoiceFailureReplay = (record, options = {}) => {
+  const providerSteps = record.providerDecisions.filter((decision) => ["degraded", "error", "fallback", "selected", "success"].includes(decision.status ?? "")).map((decision) => ({
+    at: decision.at,
+    elapsedMs: decision.elapsedMs,
+    error: decision.error,
+    fallbackProvider: decision.fallbackProvider,
+    kind: decision.kind,
+    provider: decision.provider,
+    reason: decision.reason,
+    selectedProvider: decision.selectedProvider,
+    status: decision.status,
+    surface: decision.surface,
+    turnId: decision.turnId,
+    userHeard: getAssistantRepliesForTurn(record, decision.turnId)
+  }));
+  const mediaSteps = record.telephonyMedia.events.map((event) => {
+    const step = {
+      at: event.at,
+      audioBytes: event.audioBytes,
+      carrier: event.carrier,
+      direction: event.direction,
+      event: event.event,
+      streamId: event.streamId
+    };
+    return {
+      ...step,
+      issue: mediaIssueForStep(step)
+    };
+  });
+  const providerIssues = providerSteps.filter((step) => step.status === "error" || step.status === "fallback" || step.status === "degraded").map((step) => {
+    const provider = step.provider ?? step.selectedProvider ?? "provider";
+    const recovery = step.status === "fallback" ? `recovered through ${step.fallbackProvider ?? step.selectedProvider ?? "fallback"}` : step.status === "degraded" ? `degraded to ${step.fallbackProvider ?? step.selectedProvider ?? "fallback"}` : "failed before recovery";
+    return `${provider} ${recovery}${step.reason ? `: ${step.reason}` : ""}`;
+  });
+  const mediaIssues = [
+    ...mediaSteps.map((step) => step.issue).filter((issue) => typeof issue === "string"),
+    record.telephonyMedia.total > 0 && record.telephonyMedia.inbound === 0 ? "Carrier stream has no inbound media evidence." : undefined,
+    record.telephonyMedia.total > 0 && record.telephonyMedia.outbound === 0 ? "Carrier stream has no outbound assistant media/control evidence." : undefined
+  ].filter((issue) => typeof issue === "string");
+  const userHeard = [
+    ...new Set(record.transcript.flatMap((turn) => turn.assistantReplies))
+  ];
+  const status = record.providerDecisionSummary.errors > 0 || record.telephonyMedia.errors > 0 ? "failed" : record.providerDecisionSummary.degraded > 0 ? "degraded" : record.providerDecisionSummary.fallbacks > 0 || mediaIssues.length > 0 ? "recovered" : "healthy";
+  const turns = record.transcript.map((turn) => ({
+    ...turn,
+    media: mediaSteps.filter((step) => record.traceEvents.some((event) => event.turnId === turn.id && event.type === "client.telephony_media" && event.at === step.at)),
+    providers: providerSteps.filter((step) => step.turnId === turn.id)
+  }));
+  const issues = [...providerIssues, ...mediaIssues];
+  const reportBase = {
+    media: {
+      audioBytes: record.telephonyMedia.audioBytes,
+      clears: record.telephonyMedia.clears,
+      errors: record.telephonyMedia.errors,
+      issues: mediaIssues,
+      steps: mediaSteps,
+      total: record.telephonyMedia.total
+    },
+    ok: status === "healthy" || status === "recovered",
+    operationsRecordHref: resolveOperationsRecordHref(options.operationsRecordHref, record),
+    providers: {
+      degraded: record.providerDecisionSummary.degraded,
+      errors: record.providerDecisionSummary.errors,
+      fallbacks: record.providerDecisionSummary.fallbacks,
+      recoveryStatus: record.providerDecisionSummary.recoveryStatus,
+      selected: record.providerDecisionSummary.selected,
+      steps: providerSteps,
+      total: record.providerDecisionSummary.total
+    },
+    sessionId: record.sessionId,
+    status,
+    summary: {
+      callDurationMs: record.summary.callDurationMs,
+      issues,
+      userHeard
+    },
+    turns
+  };
+  return {
+    ...reportBase,
+    incidentMarkdown: renderVoiceFailureReplayMarkdown(reportBase)
+  };
+};
+var renderVoiceFailureReplayMarkdown = (report) => {
+  const heard = report.summary.userHeard.length ? report.summary.userHeard.map((text) => `- ${text}`).join(`
+`) : "- none recorded";
+  const providerSteps = report.providers.steps.length ? report.providers.steps.slice(0, 8).map((step) => {
+    const provider = step.provider ?? step.selectedProvider ?? "provider";
+    const parts = [
+      step.status ? `status=${step.status}` : undefined,
+      step.selectedProvider ? `selected=${step.selectedProvider}` : undefined,
+      step.fallbackProvider ? `fallback=${step.fallbackProvider}` : undefined,
+      step.elapsedMs !== undefined ? `elapsed=${step.elapsedMs}ms` : undefined,
+      step.reason
+    ].filter((part) => typeof part === "string");
+    return `- ${provider}: ${parts.join("; ")}`;
+  }).join(`
+`) : "- none recorded";
+  const mediaSteps = report.media.steps.length ? report.media.steps.slice(0, 8).map((step) => {
+    const parts = [
+      step.carrier,
+      step.event,
+      step.direction,
+      step.streamId ? `stream=${step.streamId}` : undefined,
+      `audioBytes=${String(step.audioBytes)}`,
+      step.issue
+    ].filter((part) => typeof part === "string");
+    return `- ${parts.join("; ")}`;
+  }).join(`
+`) : "- none recorded";
+  const issues = report.summary.issues.length ? report.summary.issues.map((issue) => `- ${issue}`).join(`
+`) : "- none";
+  return [
+    `# Voice Failure Replay: ${report.sessionId}`,
+    "",
+    `Status: ${report.status}`,
+    `Operations record: ${report.operationsRecordHref ?? "not linked"}`,
+    `Duration: ${formatMs5(report.summary.callDurationMs)}`,
+    "",
+    "## What Failed Or Recovered",
+    issues,
+    "",
+    "## Provider Path",
+    providerSteps,
+    "",
+    "## Media Path",
+    mediaSteps,
+    "",
+    "## What The User Heard",
+    heard
+  ].join(`
+`);
+};
 var escapeHtml48 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var formatMs5 = (value) => value === undefined ? "n/a" : `${String(value)}ms`;
 var outcomeLabels = (outcome) => [
@@ -35656,7 +35801,7 @@ var createFakeTTSAdapter = (chunkCount, chunkDelayMs) => ({
 var defaultOperationsRecordHref = ({
   sessionId
 }) => `/voice-operations/${encodeURIComponent(sessionId)}`;
-var resolveOperationsRecordHref = (href, input) => typeof href === "function" ? href(input) : href === undefined ? defaultOperationsRecordHref(input) : href;
+var resolveOperationsRecordHref2 = (href, input) => typeof href === "function" ? href(input) : href === undefined ? defaultOperationsRecordHref(input) : href;
 var runVoiceTelephonyMediaOperationsSmoke = async (options = {}) => {
   const timeoutMs = options.timeoutMs ?? 5000;
   const sessionId = options.sessionId ?? `telephony-media-ops-${Date.now()}`;
@@ -35744,7 +35889,7 @@ var runVoiceTelephonyMediaOperationsSmoke = async (options = {}) => {
     issues,
     ok: issues.length === 0,
     operationsRecord,
-    operationsRecordHref: resolveOperationsRecordHref(options.operationsRecordHref, { sessionId, streamSid }),
+    operationsRecordHref: resolveOperationsRecordHref2(options.operationsRecordHref, { sessionId, streamSid }),
     sentEvents: sentEvents.map((message) => message.event).filter((event) => typeof event === "string"),
     sessionId,
     streamSid,
@@ -36068,6 +36213,7 @@ export {
   renderVoiceLatencySLOMarkdown,
   renderVoiceHandoffHealthHTML,
   renderVoiceGuardrailMarkdown,
+  renderVoiceFailureReplayMarkdown,
   renderVoiceEvalHTML,
   renderVoiceEvalBaselineHTML,
   renderVoiceDemoReadyHTML,
@@ -36507,6 +36653,7 @@ export {
   buildVoiceLatencySLOGate,
   buildVoiceIncidentBundle,
   buildVoiceGuardrailReport,
+  buildVoiceFailureReplay,
   buildVoiceDiagnosticsMarkdown,
   buildVoiceDemoReadyReport,
   buildVoiceDeliverySinkReport,

package/dist/operationsRecord.d.ts

@@ -217,6 +217,75 @@ export type VoiceOperationsRecord = {
     traceEvents: StoredVoiceTraceEvent[];
     transcript: VoiceOperationsRecordTranscriptTurn[];
 };
+export type VoiceFailureReplayStatus = 'degraded' | 'failed' | 'healthy' | 'recovered';
+export type VoiceFailureReplayProviderStep = {
+    at: number;
+    elapsedMs?: number;
+    error?: string;
+    fallbackProvider?: string;
+    kind?: string;
+    provider?: string;
+    reason?: string;
+    selectedProvider?: string;
+    status?: string;
+    surface?: string;
+    turnId?: string;
+    userHeard: string[];
+};
+export type VoiceFailureReplayMediaStep = {
+    at: number;
+    audioBytes: number;
+    carrier?: string;
+    direction?: string;
+    event: string;
+    issue?: string;
+    streamId?: string;
+};
+export type VoiceFailureReplayTurn = {
+    assistantReplies: string[];
+    committedText?: string;
+    errors: string[];
+    id: string;
+    media: VoiceFailureReplayMediaStep[];
+    providers: VoiceFailureReplayProviderStep[];
+    transcripts: string[];
+};
+export type VoiceFailureReplayReport = {
+    incidentMarkdown: string;
+    media: {
+        audioBytes: number;
+        clears: number;
+        errors: number;
+        issues: string[];
+        steps: VoiceFailureReplayMediaStep[];
+        total: number;
+    };
+    ok: boolean;
+    operationsRecordHref?: string;
+    providers: {
+        degraded: number;
+        errors: number;
+        fallbacks: number;
+        recoveryStatus: VoiceOperationsRecordProviderDecisionRecoveryStatus;
+        selected: number;
+        steps: VoiceFailureReplayProviderStep[];
+        total: number;
+    };
+    sessionId: string;
+    status: VoiceFailureReplayStatus;
+    summary: {
+        callDurationMs?: number;
+        issues: string[];
+        userHeard: string[];
+    };
+    turns: VoiceFailureReplayTurn[];
+};
+export type VoiceFailureReplayOptions = {
+    operationsRecordHref?: string | ((input: {
+        record: VoiceOperationsRecord;
+        sessionId: string;
+    }) => string);
+};
 export type VoiceOperationsRecordOptions = {
     audit?: VoiceAuditEventStore;
     evaluation?: VoiceTraceEvaluationOptions;
@@ -244,6 +313,8 @@ export declare const evaluateVoiceOperationsRecordGuardrails: (record: VoiceOper
 export declare const assertVoiceOperationsRecordGuardrails: (record: VoiceOperationsRecord, input?: VoiceOperationsRecordGuardrailAssertionInput) => VoiceOperationsRecordGuardrailAssertionReport;
 export declare const evaluateVoiceOperationsRecordProviderRecovery: (record: VoiceOperationsRecord, input?: VoiceOperationsRecordProviderRecoveryAssertionInput) => VoiceOperationsRecordProviderRecoveryAssertionReport;
 export declare const assertVoiceOperationsRecordProviderRecovery: (record: VoiceOperationsRecord, input?: VoiceOperationsRecordProviderRecoveryAssertionInput) => VoiceOperationsRecordProviderRecoveryAssertionReport;
+export declare const buildVoiceFailureReplay: (record: VoiceOperationsRecord, options?: VoiceFailureReplayOptions) => VoiceFailureReplayReport;
+export declare const renderVoiceFailureReplayMarkdown: (report: Omit<VoiceFailureReplayReport, "incidentMarkdown"> | VoiceFailureReplayReport) => string;
 export declare const renderVoiceOperationsRecordIncidentMarkdown: (record: VoiceOperationsRecord) => string;
 export declare const renderVoiceOperationsRecordGuardrailMarkdown: (record: VoiceOperationsRecord) => string;
 export declare const renderVoiceOperationsRecordHTML: (record: VoiceOperationsRecord, options?: {

package/dist/testing/index.js

@@ -10780,6 +10780,7 @@ var pushMissingValuesIssue = (input) => {
   }
 };
 var resolveRoutePath = (path, sessionId) => path.replace(":sessionId", encodeURIComponent(sessionId));
+var resolveOperationsRecordHref = (href, record) => typeof href === "function" ? href({ record, sessionId: record.sessionId }) : href;
 var toHandoff = (event) => ({
   at: event.at,
   fromAgentId: getString4(event.payload.fromAgentId),
@@ -11194,6 +11195,150 @@ var assertVoiceOperationsRecordProviderRecovery = (record, input = {}) => {
   }
   return report;
 };
+var getAssistantRepliesForTurn = (record, turnId) => turnId ? record.transcript.find((turn) => turn.id === turnId)?.assistantReplies ?? [] : [];
+var mediaIssueForStep = (step) => {
+  const event = step.event.toLowerCase();
+  if (event === "error") {
+    return "Carrier media stream emitted an error.";
+  }
+  if (event === "media" && step.audioBytes <= 0) {
+    return "Carrier media packet had no audio bytes.";
+  }
+  return;
+};
+var buildVoiceFailureReplay = (record, options = {}) => {
+  const providerSteps = record.providerDecisions.filter((decision) => ["degraded", "error", "fallback", "selected", "success"].includes(decision.status ?? "")).map((decision) => ({
+    at: decision.at,
+    elapsedMs: decision.elapsedMs,
+    error: decision.error,
+    fallbackProvider: decision.fallbackProvider,
+    kind: decision.kind,
+    provider: decision.provider,
+    reason: decision.reason,
+    selectedProvider: decision.selectedProvider,
+    status: decision.status,
+    surface: decision.surface,
+    turnId: decision.turnId,
+    userHeard: getAssistantRepliesForTurn(record, decision.turnId)
+  }));
+  const mediaSteps = record.telephonyMedia.events.map((event) => {
+    const step = {
+      at: event.at,
+      audioBytes: event.audioBytes,
+      carrier: event.carrier,
+      direction: event.direction,
+      event: event.event,
+      streamId: event.streamId
+    };
+    return {
+      ...step,
+      issue: mediaIssueForStep(step)
+    };
+  });
+  const providerIssues = providerSteps.filter((step) => step.status === "error" || step.status === "fallback" || step.status === "degraded").map((step) => {
+    const provider = step.provider ?? step.selectedProvider ?? "provider";
+    const recovery = step.status === "fallback" ? `recovered through ${step.fallbackProvider ?? step.selectedProvider ?? "fallback"}` : step.status === "degraded" ? `degraded to ${step.fallbackProvider ?? step.selectedProvider ?? "fallback"}` : "failed before recovery";
+    return `${provider} ${recovery}${step.reason ? `: ${step.reason}` : ""}`;
+  });
+  const mediaIssues = [
+    ...mediaSteps.map((step) => step.issue).filter((issue) => typeof issue === "string"),
+    record.telephonyMedia.total > 0 && record.telephonyMedia.inbound === 0 ? "Carrier stream has no inbound media evidence." : undefined,
+    record.telephonyMedia.total > 0 && record.telephonyMedia.outbound === 0 ? "Carrier stream has no outbound assistant media/control evidence." : undefined
+  ].filter((issue) => typeof issue === "string");
+  const userHeard = [
+    ...new Set(record.transcript.flatMap((turn) => turn.assistantReplies))
+  ];
+  const status = record.providerDecisionSummary.errors > 0 || record.telephonyMedia.errors > 0 ? "failed" : record.providerDecisionSummary.degraded > 0 ? "degraded" : record.providerDecisionSummary.fallbacks > 0 || mediaIssues.length > 0 ? "recovered" : "healthy";
+  const turns = record.transcript.map((turn) => ({
+    ...turn,
+    media: mediaSteps.filter((step) => record.traceEvents.some((event) => event.turnId === turn.id && event.type === "client.telephony_media" && event.at === step.at)),
+    providers: providerSteps.filter((step) => step.turnId === turn.id)
+  }));
+  const issues = [...providerIssues, ...mediaIssues];
+  const reportBase = {
+    media: {
+      audioBytes: record.telephonyMedia.audioBytes,
+      clears: record.telephonyMedia.clears,
+      errors: record.telephonyMedia.errors,
+      issues: mediaIssues,
+      steps: mediaSteps,
+      total: record.telephonyMedia.total
+    },
+    ok: status === "healthy" || status === "recovered",
+    operationsRecordHref: resolveOperationsRecordHref(options.operationsRecordHref, record),
+    providers: {
+      degraded: record.providerDecisionSummary.degraded,
+      errors: record.providerDecisionSummary.errors,
+      fallbacks: record.providerDecisionSummary.fallbacks,
+      recoveryStatus: record.providerDecisionSummary.recoveryStatus,
+      selected: record.providerDecisionSummary.selected,
+      steps: providerSteps,
+      total: record.providerDecisionSummary.total
+    },
+    sessionId: record.sessionId,
+    status,
+    summary: {
+      callDurationMs: record.summary.callDurationMs,
+      issues,
+      userHeard
+    },
+    turns
+  };
+  return {
+    ...reportBase,
+    incidentMarkdown: renderVoiceFailureReplayMarkdown(reportBase)
+  };
+};
+var renderVoiceFailureReplayMarkdown = (report) => {
+  const heard = report.summary.userHeard.length ? report.summary.userHeard.map((text) => `- ${text}`).join(`
+`) : "- none recorded";
+  const providerSteps = report.providers.steps.length ? report.providers.steps.slice(0, 8).map((step) => {
+    const provider = step.provider ?? step.selectedProvider ?? "provider";
+    const parts = [
+      step.status ? `status=${step.status}` : undefined,
+      step.selectedProvider ? `selected=${step.selectedProvider}` : undefined,
+      step.fallbackProvider ? `fallback=${step.fallbackProvider}` : undefined,
+      step.elapsedMs !== undefined ? `elapsed=${step.elapsedMs}ms` : undefined,
+      step.reason
+    ].filter((part) => typeof part === "string");
+    return `- ${provider}: ${parts.join("; ")}`;
+  }).join(`
+`) : "- none recorded";
+  const mediaSteps = report.media.steps.length ? report.media.steps.slice(0, 8).map((step) => {
+    const parts = [
+      step.carrier,
+      step.event,
+      step.direction,
+      step.streamId ? `stream=${step.streamId}` : undefined,
+      `audioBytes=${String(step.audioBytes)}`,
+      step.issue
+    ].filter((part) => typeof part === "string");
+    return `- ${parts.join("; ")}`;
+  }).join(`
+`) : "- none recorded";
+  const issues = report.summary.issues.length ? report.summary.issues.map((issue) => `- ${issue}`).join(`
+`) : "- none";
+  return [
+    `# Voice Failure Replay: ${report.sessionId}`,
+    "",
+    `Status: ${report.status}`,
+    `Operations record: ${report.operationsRecordHref ?? "not linked"}`,
+    `Duration: ${formatMs2(report.summary.callDurationMs)}`,
+    "",
+    "## What Failed Or Recovered",
+    issues,
+    "",
+    "## Provider Path",
+    providerSteps,
+    "",
+    "## Media Path",
+    mediaSteps,
+    "",
+    "## What The User Heard",
+    heard
+  ].join(`
+`);
+};
 var escapeHtml7 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var formatMs2 = (value) => value === undefined ? "n/a" : `${String(value)}ms`;
 var outcomeLabels = (outcome) => [
@@ -13130,7 +13275,7 @@ var createFakeTTSAdapter = (chunkCount, chunkDelayMs) => ({
 var defaultOperationsRecordHref = ({
   sessionId
 }) => `/voice-operations/${encodeURIComponent(sessionId)}`;
-var resolveOperationsRecordHref = (href, input) => typeof href === "function" ? href(input) : href === undefined ? defaultOperationsRecordHref(input) : href;
+var resolveOperationsRecordHref2 = (href, input) => typeof href === "function" ? href(input) : href === undefined ? defaultOperationsRecordHref(input) : href;
 var runVoiceTelephonyMediaOperationsSmoke = async (options = {}) => {
   const timeoutMs = options.timeoutMs ?? 5000;
   const sessionId = options.sessionId ?? `telephony-media-ops-${Date.now()}`;
@@ -13218,7 +13363,7 @@ var runVoiceTelephonyMediaOperationsSmoke = async (options = {}) => {
     issues,
     ok: issues.length === 0,
     operationsRecord,
-    operationsRecordHref: resolveOperationsRecordHref(options.operationsRecordHref, { sessionId, streamSid }),
+    operationsRecordHref: resolveOperationsRecordHref2(options.operationsRecordHref, { sessionId, streamSid }),
     sentEvents: sentEvents.map((message) => message.event).filter((event) => typeof event === "string"),
     sessionId,
     streamSid,

package/package.json

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