@absolutejs/voice 0.0.22-beta.232 → 0.0.22-beta.234

package/README.md

@@ -2773,6 +2773,25 @@ console.log(voiceObservabilityExportSchemaId, voiceObservabilityExportSchemaVers
 
 Use `validateVoiceObservabilityExportRecord(...)` or `assertVoiceObservabilityExportRecord(...)` when reading customer-owned records back from SQLite, Postgres, S3, a webhook collector, a warehouse, or a SIEM. The validator accepts manifests, artifact indexes, delivery reports, delivery receipts, delivery histories, and database payload records, then checks the stable schema id/version plus the minimum shape required for safe ingestion.
 
+Use `replayVoiceObservabilityExport(...)` when you need to prove an already-delivered evidence bundle is still usable:
+
+```ts
+import { replayVoiceObservabilityExport } from '@absolutejs/voice';
+
+const replay = await replayVoiceObservabilityExport({
+	kind: 'sqlite',
+	path: '.voice-runtime/observability-exports.sqlite',
+	runId: '2026-04-29T17-20-51.032Z',
+	tableName: 'voice_observability_exports'
+});
+
+if (replay.status !== 'pass') {
+	console.error(replay.issues);
+}
+```
+
+Replay sources support supplied records plus file, S3, SQLite, and Postgres delivery targets. The replay report re-validates the manifest/index/database payload, counts artifacts and delivery destinations, flags failed artifacts or destinations, and gives a readiness-style `pass`, `warn`, or `fail` result for customer-owned evidence pipelines.
+
 ```ts
 import {
 	buildVoiceObservabilityExport,
@@ -2876,12 +2895,18 @@ app.use(
 			maxAgeMs: 60 * 60 * 1000,
 			store: observabilityExportDeliveryReceipts
 		},
+		observabilityExportReplay: {
+			kind: 'sqlite',
+			path: '.voice-runtime/observability-exports.sqlite',
+			runId: 'latest-proof-pack',
+			tableName: 'voice_observability_exports'
+		},
 		store: runtimeStorage.traces
 	})
 );
 ```
 
-Readiness adds `Observability export` and `Observability export delivery` checks. Failed export manifests fail the deploy gate, and delivery receipt history can fail or warn when no successful delivery exists or the latest success is older than your configured freshness window.
+Readiness adds `Observability export`, `Observability export delivery`, and `Observability export replay` checks. Failed export manifests fail the deploy gate, delivery receipt history can fail or warn when no successful delivery exists or the latest success is older than your configured freshness window, and replay health can fail the gate when customer-owned evidence cannot be read back cleanly from file, S3, SQLite, or Postgres.
 
 ## Production Voice Ops
 

package/dist/index.d.ts

@@ -53,7 +53,7 @@ export { createVoiceReadinessProfile, recommendVoiceReadinessProfile } from './r
 export { buildVoiceProviderContractMatrix, createVoiceProviderContractMatrixHTMLHandler, createVoiceProviderContractMatrixJSONHandler, createVoiceProviderContractMatrixPreset, createVoiceProviderContractMatrixRoutes, evaluateVoiceProviderStackGaps, renderVoiceProviderContractMatrixHTML, recommendVoiceProviderStack } from './providerStackRecommendations';
 export { buildVoiceOpsConsoleReport, createVoiceOpsConsoleRoutes, renderVoiceOpsConsoleHTML } from './opsConsoleRoutes';
 export { buildVoiceOperationsRecord, createVoiceOperationsRecordRoutes, renderVoiceOperationsRecordHTML, renderVoiceOperationsRecordIncidentMarkdown } from './operationsRecord';
-export { assertVoiceObservabilityExportRecord, buildVoiceObservabilityArtifactIndex, buildVoiceObservabilityExportDeliveryHistory, buildVoiceObservabilityExport, assertVoiceObservabilityExportSchema, createVoiceObservabilityExportSchema, createVoiceFileObservabilityExportDeliveryReceiptStore, createVoiceMemoryObservabilityExportDeliveryReceiptStore, createVoiceObservabilityExportRoutes, deliverVoiceObservabilityExport, renderVoiceObservabilityExportMarkdown, validateVoiceObservabilityExportRecord, voiceObservabilityExportSchemaId, voiceObservabilityExportSchemaVersion } from './observabilityExport';
+export { assertVoiceObservabilityExportRecord, buildVoiceObservabilityArtifactIndex, buildVoiceObservabilityExportDeliveryHistory, buildVoiceObservabilityExportReplayReport, buildVoiceObservabilityExport, assertVoiceObservabilityExportSchema, createVoiceObservabilityExportSchema, createVoiceFileObservabilityExportDeliveryReceiptStore, createVoiceMemoryObservabilityExportDeliveryReceiptStore, createVoiceObservabilityExportRoutes, deliverVoiceObservabilityExport, loadVoiceObservabilityExportReplaySource, replayVoiceObservabilityExport, renderVoiceObservabilityExportMarkdown, validateVoiceObservabilityExportRecord, voiceObservabilityExportSchemaId, voiceObservabilityExportSchemaVersion } from './observabilityExport';
 export { buildVoiceOpsRecoveryReadinessCheck, buildVoiceOpsRecoveryReport, createVoiceOpsRecoveryRoutes, renderVoiceOpsRecoveryHTML, renderVoiceOpsRecoveryMarkdown } from './opsRecovery';
 export { buildVoiceIncidentBundle, createStoredVoiceIncidentBundleArtifact, createVoiceIncidentBundleRoutes, createVoiceMemoryIncidentBundleStore, pruneVoiceIncidentBundleArtifacts, saveVoiceIncidentBundleArtifact } from './incidentBundle';
 export { summarizeVoiceOpsStatus } from './opsStatus';
@@ -118,7 +118,7 @@ export type { VoiceProductionReadinessAction, VoiceProductionReadinessAuditOptio
 export type { VoiceReadinessProfileName, VoiceReadinessProfileOptions, VoiceReadinessProfileRecommendation, VoiceReadinessProfileRecommendationScore, VoiceReadinessProfileRoutesOptions } from './readinessProfiles';
 export type { VoiceProviderStackChoice, VoiceProviderStackCapabilities, VoiceProviderStackCapabilityGap, VoiceProviderStackCapabilityGapInput, VoiceProviderStackCapabilityGapReport, VoiceProviderContractCheck, VoiceProviderContractCheckStatus, VoiceProviderContractDefinition, VoiceProviderContractMatrixHandlerOptions, VoiceProviderContractMatrixHTMLHandlerOptions, VoiceProviderContractMatrixInput, VoiceProviderContractMatrixPresetOptions, VoiceProviderContractMatrixReport, VoiceProviderContractMatrixRoutesOptions, VoiceProviderContractMatrixRow, VoiceProviderStackInput, VoiceProviderStackKind, VoiceProviderStackRecommendation } from './providerStackRecommendations';
 export type { VoiceOperationsRecord, VoiceOperationsRecordAgentHandoff, VoiceOperationsRecordAuditSummary, VoiceOperationsRecordIntegrationEventSummary, VoiceOperationsRecordOptions, VoiceOperationsRecordOutcome, VoiceOperationsRecordProviderDecision, VoiceOperationsRecordReviewSummary, VoiceOperationsRecordRoutesOptions, VoiceOperationsRecordStatus, VoiceOperationsRecordTaskSummary, VoiceOperationsRecordTranscriptTurn, VoiceOperationsRecordTool } from './operationsRecord';
-export type { VoiceObservabilityExportArtifact, VoiceObservabilityExportArtifactChecksum, VoiceObservabilityExportArtifactFreshness, VoiceObservabilityExportArtifactIndex, VoiceObservabilityExportArtifactIndexItem, VoiceObservabilityExportArtifactKind, VoiceObservabilityExportDeliverySummary, VoiceObservabilityExportDeliveryDestination, VoiceObservabilityExportDeliveryDestinationResult, VoiceObservabilityExportDeliveryHistory, VoiceObservabilityExportDeliveryOptions, VoiceObservabilityExportDeliveryReceipt, VoiceObservabilityExportDeliveryReceiptStore, VoiceObservabilityExportDeliveryReport, VoiceObservabilityExportEnvelope, VoiceObservabilityExportIssue, VoiceObservabilityExportIssueCode, VoiceObservabilityExportOptions, VoiceObservabilityExportIngestedRecordKind, VoiceObservabilityExportRedactionSummary, VoiceObservabilityExportRecordValidationOptions, VoiceObservabilityExportReport, VoiceObservabilityExportRoutesOptions, VoiceObservabilityExportSchema, VoiceObservabilityExportStatus, VoiceObservabilityExportValidationIssue, VoiceObservabilityExportValidationResult } from './observabilityExport';
+export type { VoiceObservabilityExportArtifact, VoiceObservabilityExportArtifactChecksum, VoiceObservabilityExportArtifactFreshness, VoiceObservabilityExportArtifactIndex, VoiceObservabilityExportArtifactIndexItem, VoiceObservabilityExportArtifactKind, VoiceObservabilityExportDeliverySummary, VoiceObservabilityExportDeliveryDestination, VoiceObservabilityExportDeliveryDestinationResult, VoiceObservabilityExportDeliveryHistory, VoiceObservabilityExportDeliveryOptions, VoiceObservabilityExportDeliveryReceipt, VoiceObservabilityExportDeliveryReceiptStore, VoiceObservabilityExportDeliveryReport, VoiceObservabilityExportEnvelope, VoiceObservabilityExportIssue, VoiceObservabilityExportIssueCode, VoiceObservabilityExportOptions, VoiceObservabilityExportIngestedRecordKind, VoiceObservabilityExportRedactionSummary, VoiceObservabilityExportRecordValidationOptions, VoiceObservabilityExportReplayIssue, VoiceObservabilityExportReplayIssueCode, VoiceObservabilityExportReplayRecords, VoiceObservabilityExportReplayReport, 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';
 export type { VoiceQualityLink, VoiceQualityMetric, VoiceQualityReport, VoiceQualityRoutesOptions, VoiceQualityStatus, VoiceQualityThresholds } from './qualityRoutes';

package/dist/index.js

@@ -23309,6 +23309,10 @@ var writeS3Object = async (input) => {
     type: input.contentType
   });
 };
+var readS3ObjectText = async (input) => {
+  const file = input.client.file(input.key, input.options);
+  return await file.text();
+};
 var quoteObservabilityIdentifier = (value) => `"${value.replace(/"/g, '""')}"`;
 var normalizeObservabilityIdentifier = (value) => value?.trim().replace(/[^a-zA-Z0-9_]+/g, "_").replace(/^_+|_+$/g, "") || "voice_observability_exports";
 var buildObservabilityExportDatabaseRecord = (input) => ({
@@ -23321,6 +23325,190 @@ var buildObservabilityExportDatabaseRecord = (input) => ({
   schema: input.report.schema,
   status: input.report.status
 });
+var parseObservabilityExportJson = (value) => typeof value === "string" ? JSON.parse(value) : value;
+var collectReplayDeliveryDestinations = (value) => {
+  if (!isRecord2(value)) {
+    return [];
+  }
+  if (Array.isArray(value.destinations)) {
+    return value.destinations.filter((destination) => isRecord2(destination));
+  }
+  if (Array.isArray(value.receipts)) {
+    return value.receipts.flatMap((receipt) => collectReplayDeliveryDestinations(receipt));
+  }
+  return [];
+};
+var replayIssueSeverity = (status) => status === "fail" ? "fail" : "warn";
+var buildVoiceObservabilityExportReplayReport = (records) => {
+  const manifest = records.manifest ?? (isRecord2(records.databaseRecord) ? records.databaseRecord.manifest : undefined);
+  const artifactIndex = records.artifactIndex ?? (isRecord2(records.databaseRecord) ? records.databaseRecord.artifactIndex : undefined);
+  const validations = {
+    artifactIndex: validateVoiceObservabilityExportRecord(artifactIndex, {
+      kind: "artifact-index"
+    }),
+    databaseRecord: records.databaseRecord ? validateVoiceObservabilityExportRecord(records.databaseRecord, {
+      kind: "database-record"
+    }) : undefined,
+    deliveryHistory: records.deliveryHistory ? validateVoiceObservabilityExportRecord(records.deliveryHistory, {
+      kind: "delivery-history"
+    }) : undefined,
+    deliveryReceipt: records.deliveryReceipt ? validateVoiceObservabilityExportRecord(records.deliveryReceipt, {
+      kind: "delivery-receipt"
+    }) : undefined,
+    deliveryReport: records.deliveryReport ? validateVoiceObservabilityExportRecord(records.deliveryReport, {
+      kind: "delivery-report"
+    }) : undefined,
+    manifest: validateVoiceObservabilityExportRecord(manifest, {
+      kind: "manifest"
+    })
+  };
+  const validationIssues = Object.entries(validations).flatMap(([kind, result]) => result?.issues.map((issue) => ({
+    kind,
+    issue
+  })) ?? []);
+  const manifestRecord = isRecord2(manifest) ? manifest : undefined;
+  const artifactIndexRecord = isRecord2(artifactIndex) ? artifactIndex : undefined;
+  const artifacts = [
+    ...Array.isArray(manifestRecord?.artifacts) ? manifestRecord.artifacts : [],
+    ...Array.isArray(artifactIndexRecord?.artifacts) ? artifactIndexRecord.artifacts : []
+  ].filter((artifact) => isRecord2(artifact));
+  const failedArtifacts = artifacts.filter((artifact) => artifact.status === "fail");
+  const deliveryDestinations = [
+    ...collectReplayDeliveryDestinations(records.deliveryReport),
+    ...collectReplayDeliveryDestinations(records.deliveryReceipt),
+    ...collectReplayDeliveryDestinations(records.deliveryHistory)
+  ];
+  const failedDeliveryDestinations = deliveryDestinations.filter((destination) => destination.status === "failed");
+  const issues = [
+    ...!records.manifest && !isRecord2(records.databaseRecord) ? [
+      {
+        code: "voice.observability.export_replay.missing_record",
+        label: "Export manifest",
+        severity: "fail",
+        value: "manifest"
+      }
+    ] : [],
+    ...!records.artifactIndex && !isRecord2(records.databaseRecord) ? [
+      {
+        code: "voice.observability.export_replay.missing_record",
+        label: "Artifact index",
+        severity: "fail",
+        value: "artifact-index"
+      }
+    ] : [],
+    ...validationIssues.map(({ kind, issue }) => ({
+      code: "voice.observability.export_replay.validation_failed",
+      detail: issue.message,
+      label: `Invalid ${kind}`,
+      severity: "fail",
+      value: issue.path
+    })),
+    ...manifestRecord && (manifestRecord.status === "fail" || manifestRecord.status === "warn") ? [
+      {
+        code: "voice.observability.export_replay.export_failed",
+        label: "Export manifest status",
+        severity: replayIssueSeverity(manifestRecord.status),
+        value: manifestRecord.status
+      }
+    ] : [],
+    ...failedArtifacts.map((artifact) => ({
+      code: "voice.observability.export_replay.artifact_failed",
+      label: "Export artifact status",
+      severity: "fail",
+      value: artifact.id
+    })),
+    ...failedDeliveryDestinations.map((destination) => ({
+      code: "voice.observability.export_replay.delivery_failed",
+      label: "Export delivery destination",
+      severity: "fail",
+      value: destination.destinationId
+    }))
+  ];
+  return {
+    checkedAt: Date.now(),
+    issues,
+    records: validations,
+    status: issues.some((issue) => issue.severity === "fail") ? "fail" : issues.some((issue) => issue.severity === "warn") ? "warn" : "pass",
+    summary: {
+      artifacts: new Set(artifacts.map((artifact) => artifact.id)).size,
+      deliveryDestinations: deliveryDestinations.length,
+      failedArtifacts: failedArtifacts.length,
+      failedDeliveryDestinations: failedDeliveryDestinations.length,
+      validationIssues: validationIssues.length
+    }
+  };
+};
+var loadVoiceObservabilityExportReplaySource = async (source) => {
+  if (source.kind === "records") {
+    return source;
+  }
+  if (source.kind === "file") {
+    const root = join3(source.directory, source.runId);
+    const receiptPath = source.receiptDirectory ? join3(source.receiptDirectory, `${encodeURIComponent(deliveryReceiptId(source.runId))}.json`) : undefined;
+    const deliveryReceipt = receiptPath ? await Bun.file(receiptPath).text().then(JSON.parse).catch(() => {
+      return;
+    }) : undefined;
+    return {
+      artifactIndex: JSON.parse(await Bun.file(join3(root, "artifact-index.json")).text()),
+      deliveryReceipt,
+      manifest: JSON.parse(await Bun.file(join3(root, "manifest.json")).text())
+    };
+  }
+  if (source.kind === "s3") {
+    const client = source.client ?? new Bun.S3Client(source);
+    const s3Options = source;
+    const rootKey = joinS3Key(normalizeExportS3KeyPrefix(source.keyPrefix), source.runId);
+    return {
+      artifactIndex: JSON.parse(await readS3ObjectText({
+        client,
+        key: joinS3Key(rootKey, "artifact-index.json"),
+        options: s3Options
+      })),
+      manifest: JSON.parse(await readS3ObjectText({
+        client,
+        key: joinS3Key(rootKey, "manifest.json"),
+        options: s3Options
+      }))
+    };
+  }
+  if (source.kind === "sqlite") {
+    if (!source.database && !source.path) {
+      throw new Error("SQLite observability export replay requires source.database or source.path.");
+    }
+    const database = source.database ?? new Database(source.path, { create: false });
+    const table2 = quoteObservabilityIdentifier(normalizeObservabilityIdentifier(source.tableName));
+    const row2 = database.query(`SELECT manifest_json, artifact_index_json, payload_json FROM ${table2} WHERE run_id = $runId`).get({ $runId: source.runId });
+    if (!row2) {
+      throw new Error(`No observability export found for run ${source.runId}.`);
+    }
+    return {
+      artifactIndex: parseObservabilityExportJson(row2.artifact_index_json),
+      databaseRecord: parseObservabilityExportJson(row2.payload_json),
+      manifest: parseObservabilityExportJson(row2.manifest_json)
+    };
+  }
+  const sql = source.sql ?? (source.connectionString ? (() => {
+    const client = new Bun.SQL(source.connectionString);
+    return { unsafe: client.unsafe.bind(client) };
+  })() : undefined);
+  if (!sql) {
+    throw new Error("Postgres observability export replay requires source.sql or source.connectionString.");
+  }
+  const schema = normalizeObservabilityIdentifier(source.schemaName ?? "public");
+  const table = normalizeObservabilityIdentifier(source.tableName);
+  const qualifiedTable = `${quoteObservabilityIdentifier(schema)}.${quoteObservabilityIdentifier(table)}`;
+  const rows = await sql.unsafe(`SELECT manifest_json, artifact_index_json, payload FROM ${qualifiedTable} WHERE run_id = $1`, [source.runId]);
+  const row = rows[0];
+  if (!row) {
+    throw new Error(`No observability export found for run ${source.runId}.`);
+  }
+  return {
+    artifactIndex: parseObservabilityExportJson(row.artifact_index_json),
+    databaseRecord: parseObservabilityExportJson(row.payload),
+    manifest: parseObservabilityExportJson(row.manifest_json)
+  };
+};
+var replayVoiceObservabilityExport = async (source) => buildVoiceObservabilityExportReplayReport(await loadVoiceObservabilityExportReplaySource(source));
 var deliverObservabilityExportToSQLite = async (input) => {
   if (!input.destination.database && !input.destination.path) {
     throw new Error("SQLite observability export delivery requires destination.database or destination.path.");
@@ -24121,6 +24309,7 @@ var readinessGateCodes = {
   "Operator action history": "voice.readiness.operator_action_history",
   "Ops recovery": "voice.readiness.ops_recovery",
   "Observability export delivery": "voice.readiness.observability_export_delivery",
+  "Observability export replay": "voice.readiness.observability_export_replay",
   "Phone agent production smoke": "voice.readiness.phone_agent_smoke",
   "Provider contract matrix": "voice.readiness.provider_contract_matrix",
   "Provider fallback recovery": "voice.readiness.provider_fallback_recovery",
@@ -24429,6 +24618,14 @@ var resolveObservabilityExportDeliveryHistory = async (options, input) => {
   }
   return;
 };
+var isVoiceObservabilityExportReplayReport = (value) => typeof value.checkedAt === "number" && Array.isArray(value.issues) && typeof value.status === "string" && ("summary" in value);
+var resolveObservabilityExportReplay = async (options, input) => {
+  if (!options.observabilityExportReplay) {
+    return;
+  }
+  const source = typeof options.observabilityExportReplay === "function" ? await options.observabilityExportReplay(input) : options.observabilityExportReplay;
+  return isVoiceObservabilityExportReplayReport(source) ? source : replayVoiceObservabilityExport(source);
+};
 var summarizeTraceDeliveries = async (options) => {
   if (!options.traceDeliveries) {
     return;
@@ -24589,6 +24786,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     opsRecovery,
     observabilityExport,
     observabilityExportDeliveryHistory,
+    observabilityExportReplay,
     proofSources
   ] = await Promise.all([
     evaluateVoiceQuality({ events }),
@@ -24626,6 +24824,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     resolveOpsRecovery(options, { query, request }),
     resolveObservabilityExport(options, { query, request }),
     resolveObservabilityExportDeliveryHistory(options, { query, request }),
+    resolveObservabilityExportReplay(options, { query, request }),
     resolveProofSources(options, { query, request })
   ]);
   const deliveryRuntime = summarizeDeliveryRuntime(deliveryRuntimeSummary);
@@ -24868,6 +25067,15 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       totalDestinations: observabilityExportDeliveryHistory.history.summary.totalDestinations
     };
   })() : undefined;
+  const observabilityExportReplaySummary = observabilityExportReplay ? {
+    artifacts: observabilityExportReplay.summary.artifacts,
+    deliveryDestinations: observabilityExportReplay.summary.deliveryDestinations,
+    failedArtifacts: observabilityExportReplay.summary.failedArtifacts,
+    failedDeliveryDestinations: observabilityExportReplay.summary.failedDeliveryDestinations,
+    issues: observabilityExportReplay.issues.length,
+    status: observabilityExportReplay.status,
+    validationIssues: observabilityExportReplay.summary.validationIssues
+  } : undefined;
   if (agentSquadContractSummary) {
     checks.push({
       detail: agentSquadContractSummary.status === "pass" ? `${agentSquadContractSummary.passed} agent squad contract(s) are passing.` : agentSquadContractSummary.total === 0 ? "No agent squad contracts are configured." : `${agentSquadContractSummary.failed} agent squad contract(s) failed.`,
@@ -24964,6 +25172,25 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       ]
     });
   }
+  if (observabilityExportReplaySummary && observabilityExportReplay) {
+    const firstIssue = observabilityExportReplay.issues[0];
+    const href = options.links?.observabilityExportDeliveries ?? options.links?.observabilityExport ?? "/api/voice/observability-export/deliveries";
+    checks.push({
+      detail: observabilityExportReplaySummary.status === "pass" ? `${observabilityExportReplaySummary.artifacts} exported artifact(s) and ${observabilityExportReplaySummary.deliveryDestinations} delivery destination(s) replay from customer-owned evidence.` : firstIssue?.detail ?? `${observabilityExportReplaySummary.issues} observability export replay issue(s) need review.`,
+      href,
+      label: "Observability export replay",
+      proofSource: proofSource("observabilityExportReplay", "observabilityExportDeliveryHistory", "observability"),
+      status: observabilityExportReplaySummary.status,
+      value: `${observabilityExportReplaySummary.validationIssues} validation issue(s)`,
+      actions: observabilityExportReplaySummary.status === "pass" ? [] : [
+        {
+          description: "Replay the customer-owned observability export from file, S3, SQLite, or Postgres and inspect validation, artifact, or delivery failures.",
+          href,
+          label: "Open export replay evidence"
+        }
+      ]
+    });
+  }
   if (providerStack) {
     const missingLanes = providerStack.gaps.filter((gap) => gap.status !== "pass");
     checks.push({
@@ -25227,6 +25454,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       } : undefined,
       observabilityExport: observabilityExportSummary,
       observabilityExportDeliveryHistory: observabilityExportDeliveryHistorySummary,
+      observabilityExportReplay: observabilityExportReplaySummary,
       providers: {
         degraded: degradedProviders,
         total: providers.length
@@ -28791,6 +29019,7 @@ export {
   resolveTurnDetectionConfig,
   resolveAudioConditioningConfig,
   requeueVoiceOpsTask,
+  replayVoiceObservabilityExport,
   reopenVoiceOpsTask,
   renderVoiceTurnQualityHTML,
   renderVoiceTurnLatencyHTML,
@@ -28865,6 +29094,7 @@ export {
   parseVoiceTelephonyWebhookEvent,
   matchesVoiceOpsTaskAssignmentRule,
   markVoiceOpsTaskSLABreached,
+  loadVoiceObservabilityExportReplaySource,
   listVoiceRoutingEvents,
   listVoiceOpsTasks,
   isVoiceOpsTaskOverdue,
@@ -29163,6 +29393,7 @@ export {
   buildVoiceOpsConsoleReport,
   buildVoiceOpsActionHistoryReport,
   buildVoiceOperationsRecord,
+  buildVoiceObservabilityExportReplayReport,
   buildVoiceObservabilityExportDeliveryHistory,
   buildVoiceObservabilityExport,
   buildVoiceObservabilityArtifactIndex,

package/dist/observabilityExport.d.ts

@@ -233,6 +233,74 @@ export type VoiceObservabilityExportDeliveryHistory = {
         totalDestinations: number;
     };
 };
+export type VoiceObservabilityExportReplayIssueCode = 'voice.observability.export_replay.artifact_failed' | 'voice.observability.export_replay.delivery_failed' | 'voice.observability.export_replay.export_failed' | 'voice.observability.export_replay.missing_record' | 'voice.observability.export_replay.validation_failed';
+export type VoiceObservabilityExportReplayIssue = {
+    code: VoiceObservabilityExportReplayIssueCode;
+    detail?: string;
+    label: string;
+    severity: Exclude<VoiceObservabilityExportStatus, 'pass'>;
+    value?: number | string;
+};
+export type VoiceObservabilityExportReplayRecords = {
+    artifactIndex?: unknown;
+    databaseRecord?: unknown;
+    deliveryHistory?: unknown;
+    deliveryReceipt?: unknown;
+    deliveryReport?: unknown;
+    manifest?: unknown;
+};
+export type VoiceObservabilityExportReplayReport = {
+    checkedAt: number;
+    issues: VoiceObservabilityExportReplayIssue[];
+    records: {
+        artifactIndex: VoiceObservabilityExportValidationResult;
+        databaseRecord?: VoiceObservabilityExportValidationResult;
+        deliveryHistory?: VoiceObservabilityExportValidationResult;
+        deliveryReceipt?: VoiceObservabilityExportValidationResult;
+        deliveryReport?: VoiceObservabilityExportValidationResult;
+        manifest: VoiceObservabilityExportValidationResult;
+    };
+    status: VoiceObservabilityExportStatus;
+    summary: {
+        artifacts: number;
+        deliveryDestinations: number;
+        failedArtifacts: number;
+        failedDeliveryDestinations: number;
+        validationIssues: number;
+    };
+};
+export type VoiceObservabilityExportReplaySource = {
+    artifactIndex?: unknown;
+    databaseRecord?: unknown;
+    deliveryHistory?: unknown;
+    deliveryReceipt?: unknown;
+    deliveryReport?: unknown;
+    kind: 'records';
+    manifest?: unknown;
+} | {
+    directory: string;
+    kind: 'file';
+    receiptDirectory?: string;
+    runId: string;
+} | (S3Options & {
+    client?: Pick<S3Client, 'file'>;
+    keyPrefix?: string;
+    kind: 's3';
+    runId: string;
+}) | {
+    database?: Database;
+    kind: 'sqlite';
+    path?: string;
+    runId: string;
+    tableName?: string;
+} | {
+    connectionString?: string;
+    kind: 'postgres';
+    runId: string;
+    schemaName?: string;
+    sql?: VoicePostgresClient;
+    tableName?: string;
+};
 export type VoiceObservabilityExportDeliveryOptions = {
     destinations: VoiceObservabilityExportDeliveryDestination[];
     report: VoiceObservabilityExportReport;
@@ -276,6 +344,9 @@ export type VoiceObservabilityExportRoutesOptions = VoiceObservabilityExportOpti
     render?: (report: VoiceObservabilityExportReport) => string | Promise<string>;
     title?: string;
 };
+export declare const buildVoiceObservabilityExportReplayReport: (records: VoiceObservabilityExportReplayRecords) => VoiceObservabilityExportReplayReport;
+export declare const loadVoiceObservabilityExportReplaySource: (source: VoiceObservabilityExportReplaySource) => Promise<VoiceObservabilityExportReplayRecords>;
+export declare const replayVoiceObservabilityExport: (source: VoiceObservabilityExportReplaySource) => Promise<VoiceObservabilityExportReplayReport>;
 export declare const createVoiceMemoryObservabilityExportDeliveryReceiptStore: () => VoiceObservabilityExportDeliveryReceiptStore;
 export declare const createVoiceFileObservabilityExportDeliveryReceiptStore: (options: {
     directory: string;

package/dist/productionReadiness.d.ts

@@ -15,7 +15,7 @@ import type { VoiceProviderContractMatrixReport, VoiceProviderStackCapabilityGap
 import { type VoiceProviderSloReport, type VoiceProviderSloReportOptions } from './providerSlo';
 import type { VoiceCampaignReadinessProofReport } from './campaign';
 import { type VoiceOpsRecoveryReport } from './opsRecovery';
-import { type VoiceObservabilityExportDeliveryHistory, type VoiceObservabilityExportDeliveryReceiptStore, type VoiceObservabilityExportReport } from './observabilityExport';
+import { type VoiceObservabilityExportDeliveryHistory, type VoiceObservabilityExportDeliveryReceiptStore, type VoiceObservabilityExportReplayReport, type VoiceObservabilityExportReplaySource, type VoiceObservabilityExportReport } from './observabilityExport';
 export type VoiceProductionReadinessObservabilityExportDeliveryHistoryOptions = {
     failOnMissing?: boolean;
     failOnStale?: boolean;
@@ -181,6 +181,15 @@ export type VoiceProductionReadinessReport = {
             status: VoiceProductionReadinessStatus;
             totalDestinations: number;
         };
+        observabilityExportReplay?: {
+            artifacts: number;
+            deliveryDestinations: number;
+            failedArtifacts: number;
+            failedDeliveryDestinations: number;
+            issues: number;
+            status: VoiceProductionReadinessStatus;
+            validationIssues: number;
+        };
         providers: {
             degraded: number;
             total: number;
@@ -372,6 +381,10 @@ export type VoiceProductionReadinessRoutesOptions = {
         query: Record<string, unknown>;
         request: Request;
     }) => Promise<VoiceObservabilityExportDeliveryHistory | VoiceObservabilityExportDeliveryReceiptStore | VoiceProductionReadinessObservabilityExportDeliveryHistoryOptions> | VoiceObservabilityExportDeliveryHistory | VoiceObservabilityExportDeliveryReceiptStore | VoiceProductionReadinessObservabilityExportDeliveryHistoryOptions);
+    observabilityExportReplay?: false | VoiceObservabilityExportReplayReport | VoiceObservabilityExportReplaySource | ((input: {
+        query: Record<string, unknown>;
+        request: Request;
+    }) => Promise<VoiceObservabilityExportReplayReport | VoiceObservabilityExportReplaySource> | VoiceObservabilityExportReplayReport | VoiceObservabilityExportReplaySource);
     path?: string;
     phoneAgentSmokes?: false | readonly VoicePhoneAgentProductionSmokeReport[] | ((input: {
         query: Record<string, unknown>;

package/package.json

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