@absolutejs/voice 0.0.22-beta.231 → 0.0.22-beta.233

package/README.md

@@ -2758,14 +2758,40 @@ Every export manifest and artifact index includes a stable schema contract:
 ```ts
 import {
 	assertVoiceObservabilityExportSchema,
+	validateVoiceObservabilityExportRecord,
 	voiceObservabilityExportSchemaId,
 	voiceObservabilityExportSchemaVersion
 } from '@absolutejs/voice';
 
 assertVoiceObservabilityExportSchema(exportReport);
+const validation = validateVoiceObservabilityExportRecord(exportReport);
+if (!validation.ok) {
+	throw new Error(validation.issues.map((issue) => issue.message).join('\n'));
+}
 console.log(voiceObservabilityExportSchemaId, voiceObservabilityExportSchemaVersion);
 ```
 
+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,

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 { buildVoiceObservabilityArtifactIndex, buildVoiceObservabilityExportDeliveryHistory, buildVoiceObservabilityExport, assertVoiceObservabilityExportSchema, createVoiceObservabilityExportSchema, createVoiceFileObservabilityExportDeliveryReceiptStore, createVoiceMemoryObservabilityExportDeliveryReceiptStore, createVoiceObservabilityExportRoutes, deliverVoiceObservabilityExport, renderVoiceObservabilityExportMarkdown, 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, VoiceObservabilityExportRedactionSummary, VoiceObservabilityExportReport, VoiceObservabilityExportRoutesOptions, VoiceObservabilityExportSchema, VoiceObservabilityExportStatus } 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

@@ -22998,6 +22998,265 @@ var assertVoiceObservabilityExportSchema = (input) => {
     throw new Error(`Unsupported voice observability export schema: ${input.schema?.id ?? "missing"}@${input.schema?.version ?? "missing"}`);
   }
 };
+var isRecord2 = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
+var isStatus2 = (value) => value === "fail" || value === "pass" || value === "warn";
+var getRecord = (value, key) => isRecord2(value) && isRecord2(value[key]) ? value[key] : undefined;
+var getRecordArray = (value, key) => isRecord2(value) && Array.isArray(value[key]) ? value[key] : undefined;
+var inferVoiceObservabilityExportRecordKind = (record) => {
+  if (isRecord2(record.manifest) && isRecord2(record.artifactIndex)) {
+    return "database-record";
+  }
+  if (Array.isArray(record.receipts)) {
+    return "delivery-history";
+  }
+  if (typeof record.runId === "string" && Array.isArray(record.destinations)) {
+    return "delivery-receipt";
+  }
+  if (Array.isArray(record.destinations) && isRecord2(record.summary) && typeof record.exportStatus === "string") {
+    return "delivery-report";
+  }
+  if (Array.isArray(record.artifacts) && isRecord2(record.summary)) {
+    return Array.isArray(record.envelopes) ? "manifest" : "artifact-index";
+  }
+  return;
+};
+var pushValidationIssue = (issues, issue) => {
+  issues.push(issue);
+};
+var requireRecordSchema = (issues, record, path) => {
+  const schema = getRecord(record, "schema");
+  if (schema?.id !== voiceObservabilityExportSchemaId || schema?.version !== voiceObservabilityExportSchemaVersion) {
+    pushValidationIssue(issues, {
+      code: "voice.observability.export.unsupported_schema",
+      message: `Unsupported voice observability export schema: ${schema?.id ?? "missing"}@${schema?.version ?? "missing"}`,
+      path: `${path}.schema`
+    });
+  }
+  return schema;
+};
+var requireArrayField = (issues, record, key, path) => {
+  if (!Array.isArray(record[key])) {
+    pushValidationIssue(issues, {
+      code: "voice.observability.export.missing_field",
+      message: `${path}.${key} must be an array.`,
+      path: `${path}.${key}`
+    });
+  }
+};
+var requireNumberField = (issues, record, key, path) => {
+  if (typeof record[key] !== "number") {
+    pushValidationIssue(issues, {
+      code: "voice.observability.export.missing_field",
+      message: `${path}.${key} must be a number.`,
+      path: `${path}.${key}`
+    });
+  }
+};
+var requireStatusField = (issues, record, key, path) => {
+  if (!isStatus2(record[key])) {
+    pushValidationIssue(issues, {
+      code: "voice.observability.export.missing_field",
+      message: `${path}.${key} must be pass, warn, or fail.`,
+      path: `${path}.${key}`
+    });
+  }
+};
+var requireDeliveryDestinationStatusField = (issues, record, key, path) => {
+  if (record[key] !== "delivered" && record[key] !== "failed") {
+    pushValidationIssue(issues, {
+      code: "voice.observability.export.missing_field",
+      message: `${path}.${key} must be delivered or failed.`,
+      path: `${path}.${key}`
+    });
+  }
+};
+var validateDeliveryDestinations = (issues, destinations, path) => {
+  if (!destinations) {
+    pushValidationIssue(issues, {
+      code: "voice.observability.export.missing_field",
+      message: `${path} must be an array.`,
+      path
+    });
+    return;
+  }
+  destinations.forEach((destination, index) => {
+    const destinationPath = `${path}.${index}`;
+    if (!isRecord2(destination)) {
+      pushValidationIssue(issues, {
+        code: "voice.observability.export.invalid_shape",
+        message: `${destinationPath} must be an object.`,
+        path: destinationPath
+      });
+      return;
+    }
+    requireRecordSchema(issues, destination, destinationPath);
+    requireDeliveryDestinationStatusField(issues, destination, "status", destinationPath);
+    if (typeof destination.destinationKind !== "string") {
+      pushValidationIssue(issues, {
+        code: "voice.observability.export.missing_field",
+        message: `${destinationPath}.destinationKind must be a string.`,
+        path: `${destinationPath}.destinationKind`
+      });
+    }
+  });
+};
+var validateVoiceObservabilityExportRecord = (input, options = {}) => {
+  const issues = [];
+  if (!isRecord2(input)) {
+    return {
+      issues: [
+        {
+          code: "voice.observability.export.invalid_shape",
+          message: "Voice observability export record must be an object.",
+          path: "$"
+        }
+      ],
+      ok: false
+    };
+  }
+  const kind = options.kind ?? inferVoiceObservabilityExportRecordKind(input);
+  if (!kind) {
+    return {
+      issues: [
+        {
+          code: "voice.observability.export.invalid_shape",
+          message: "Voice observability export record kind could not be inferred.",
+          path: "$"
+        }
+      ],
+      ok: false
+    };
+  }
+  let schema;
+  if (kind === "manifest") {
+    schema = requireRecordSchema(issues, input, "$");
+    requireArrayField(issues, input, "artifacts", "$");
+    requireArrayField(issues, input, "envelopes", "$");
+    requireArrayField(issues, input, "issues", "$");
+    requireArrayField(issues, input, "operationsRecords", "$");
+    requireArrayField(issues, input, "sessionIds", "$");
+    requireNumberField(issues, input, "checkedAt", "$");
+    requireStatusField(issues, input, "status", "$");
+    if (!isRecord2(input.deliveries)) {
+      pushValidationIssue(issues, {
+        code: "voice.observability.export.missing_field",
+        message: "$.deliveries must be an object.",
+        path: "$.deliveries"
+      });
+    }
+    if (!isRecord2(input.redaction)) {
+      pushValidationIssue(issues, {
+        code: "voice.observability.export.missing_field",
+        message: "$.redaction must be an object.",
+        path: "$.redaction"
+      });
+    }
+    if (!isRecord2(input.summary)) {
+      pushValidationIssue(issues, {
+        code: "voice.observability.export.missing_field",
+        message: "$.summary must be an object.",
+        path: "$.summary"
+      });
+    }
+  } else if (kind === "artifact-index") {
+    schema = requireRecordSchema(issues, input, "$");
+    requireArrayField(issues, input, "artifacts", "$");
+    requireNumberField(issues, input, "checkedAt", "$");
+    requireStatusField(issues, input, "status", "$");
+    if (!isRecord2(input.summary)) {
+      pushValidationIssue(issues, {
+        code: "voice.observability.export.missing_field",
+        message: "$.summary must be an object.",
+        path: "$.summary"
+      });
+    }
+  } else if (kind === "database-record") {
+    schema = requireRecordSchema(issues, input, "$");
+    requireNumberField(issues, input, "checkedAt", "$");
+    requireStatusField(issues, input, "status", "$");
+    requireStatusField(issues, input, "exportStatus", "$");
+    if (!isRecord2(input.manifest)) {
+      pushValidationIssue(issues, {
+        code: "voice.observability.export.missing_field",
+        message: "$.manifest must be an object.",
+        path: "$.manifest"
+      });
+    } else {
+      issues.push(...validateVoiceObservabilityExportRecord(input.manifest, {
+        kind: "manifest"
+      }).issues.map((issue) => ({
+        ...issue,
+        path: `$.manifest${issue.path.slice(1)}`
+      })));
+    }
+    if (!isRecord2(input.artifactIndex)) {
+      pushValidationIssue(issues, {
+        code: "voice.observability.export.missing_field",
+        message: "$.artifactIndex must be an object.",
+        path: "$.artifactIndex"
+      });
+    } else {
+      issues.push(...validateVoiceObservabilityExportRecord(input.artifactIndex, {
+        kind: "artifact-index"
+      }).issues.map((issue) => ({
+        ...issue,
+        path: `$.artifactIndex${issue.path.slice(1)}`
+      })));
+    }
+  } else if (kind === "delivery-report") {
+    requireNumberField(issues, input, "checkedAt", "$");
+    requireStatusField(issues, input, "status", "$");
+    requireStatusField(issues, input, "exportStatus", "$");
+    validateDeliveryDestinations(issues, getRecordArray(input, "destinations"), "$.destinations");
+  } else if (kind === "delivery-receipt") {
+    requireNumberField(issues, input, "checkedAt", "$");
+    requireStatusField(issues, input, "status", "$");
+    requireStatusField(issues, input, "exportStatus", "$");
+    if (typeof input.runId !== "string") {
+      pushValidationIssue(issues, {
+        code: "voice.observability.export.missing_field",
+        message: "$.runId must be a string.",
+        path: "$.runId"
+      });
+    }
+    validateDeliveryDestinations(issues, getRecordArray(input, "destinations"), "$.destinations");
+  } else if (kind === "delivery-history") {
+    requireNumberField(issues, input, "checkedAt", "$");
+    requireStatusField(issues, input, "status", "$");
+    const receipts = getRecordArray(input, "receipts");
+    if (!receipts) {
+      pushValidationIssue(issues, {
+        code: "voice.observability.export.missing_field",
+        message: "$.receipts must be an array.",
+        path: "$.receipts"
+      });
+    } else {
+      receipts.forEach((receipt, index) => {
+        const result = validateVoiceObservabilityExportRecord(receipt, {
+          kind: "delivery-receipt"
+        });
+        issues.push(...result.issues.map((issue) => ({
+          ...issue,
+          path: `$.receipts.${index}${issue.path.slice(1)}`
+        })));
+      });
+    }
+  }
+  return {
+    issues,
+    kind,
+    ok: issues.length === 0,
+    schema
+  };
+};
+var assertVoiceObservabilityExportRecord = (input, options) => {
+  const result = validateVoiceObservabilityExportRecord(input, options);
+  if (!result.ok) {
+    const firstIssue = result.issues[0];
+    throw new Error(`Invalid voice observability export record: ${firstIssue?.path ?? "$"} ${firstIssue?.message ?? "unknown validation failure"}`);
+  }
+  return result;
+};
 var isDeliveryStore = (value) => !Array.isArray(value) && typeof value.list === "function";
 var getString17 = (value) => typeof value === "string" ? value : undefined;
 var getProviderKind = (payload) => getString17(payload.kind) ?? getString17(payload.providerKind);
@@ -23050,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) => ({
@@ -23062,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.");
@@ -28463,6 +28910,7 @@ export {
   verifyVoicePlivoWebhookSignature,
   verifyVoiceOpsWebhookSignature,
   validateVoiceWorkflowRouteResult,
+  validateVoiceObservabilityExportRecord,
   transcodeTwilioInboundPayloadToPCM16,
   transcodePCMToTwilioOutboundPayload,
   summarizeVoiceTurnQuality,
@@ -28531,6 +28979,7 @@ export {
   resolveTurnDetectionConfig,
   resolveAudioConditioningConfig,
   requeueVoiceOpsTask,
+  replayVoiceObservabilityExport,
   reopenVoiceOpsTask,
   renderVoiceTurnQualityHTML,
   renderVoiceTurnLatencyHTML,
@@ -28605,6 +29054,7 @@ export {
   parseVoiceTelephonyWebhookEvent,
   matchesVoiceOpsTaskAssignmentRule,
   markVoiceOpsTaskSLABreached,
+  loadVoiceObservabilityExportReplaySource,
   listVoiceRoutingEvents,
   listVoiceOpsTasks,
   isVoiceOpsTaskOverdue,
@@ -28903,6 +29353,7 @@ export {
   buildVoiceOpsConsoleReport,
   buildVoiceOpsActionHistoryReport,
   buildVoiceOperationsRecord,
+  buildVoiceObservabilityExportReplayReport,
   buildVoiceObservabilityExportDeliveryHistory,
   buildVoiceObservabilityExport,
   buildVoiceObservabilityArtifactIndex,
@@ -28922,6 +29373,7 @@ export {
   assignVoiceOpsTask,
   assertVoiceProviderRoutingContract,
   assertVoiceObservabilityExportSchema,
+  assertVoiceObservabilityExportRecord,
   assertVoiceLatencySLOGate,
   assertVoiceAgentSquadContract,
   applyVoiceTelephonyOutcome,

package/dist/observabilityExport.d.ts

@@ -21,6 +21,26 @@ export declare const assertVoiceObservabilityExportSchema: (input: {
         version?: string;
     };
 }) => void;
+export type VoiceObservabilityExportIngestedRecordKind = 'artifact-index' | 'database-record' | 'delivery-history' | 'delivery-receipt' | 'delivery-report' | 'manifest';
+export type VoiceObservabilityExportValidationIssue = {
+    code: 'voice.observability.export.invalid_shape' | 'voice.observability.export.missing_field' | 'voice.observability.export.unsupported_schema';
+    message: string;
+    path: string;
+};
+export type VoiceObservabilityExportValidationResult = {
+    issues: VoiceObservabilityExportValidationIssue[];
+    kind?: VoiceObservabilityExportIngestedRecordKind;
+    ok: boolean;
+    schema?: {
+        id?: string;
+        version?: string;
+    };
+};
+export type VoiceObservabilityExportRecordValidationOptions = {
+    kind?: VoiceObservabilityExportIngestedRecordKind;
+};
+export declare const validateVoiceObservabilityExportRecord: (input: unknown, options?: VoiceObservabilityExportRecordValidationOptions) => VoiceObservabilityExportValidationResult;
+export declare const assertVoiceObservabilityExportRecord: (input: unknown, options?: VoiceObservabilityExportRecordValidationOptions) => VoiceObservabilityExportValidationResult;
 export type VoiceObservabilityExportArtifactKind = 'incident' | 'markdown' | 'operations-record' | 'proof-pack' | 'readiness' | 'screenshot' | 'slo' | 'trace' | 'audit' | 'custom';
 export type VoiceObservabilityExportArtifactChecksum = {
     algorithm: 'sha256';
@@ -213,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;
@@ -256,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/package.json

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