@absolutejs/voice 0.0.22-beta.219 → 0.0.22-beta.220

package/README.md

@@ -2786,6 +2786,22 @@ const exportReport = await buildVoiceObservabilityExport({
 
 The route helper exposes JSON at `/api/voice/observability-export`, Markdown at `/voice/observability-export.md`, and HTML at `/voice/observability-export`. Failed trace/audit deliveries fail the export report, pending deliveries warn, and every trace/audit envelope includes the linked operations-record URL when one is configured. This is the primitive to use when customers ask how voice evidence leaves the app without going through a hosted vendor dashboard.
 
+Pass the same report into production readiness when export health should block deploys:
+
+```ts
+app.use(
+	createVoiceProductionReadinessRoutes({
+		links: {
+			observabilityExport: '/voice/observability-export'
+		},
+		observabilityExport: exportReport,
+		store: runtimeStorage.traces
+	})
+);
+```
+
+Readiness adds an `Observability export` check. Failed export deliveries fail the deploy gate; pending or missing evidence can warn through the export report instead of becoming an untracked dashboard task.
+
 ## Production Voice Ops
 
 The recommended production pattern is:

package/dist/index.js

@@ -22728,6 +22728,15 @@ var resolveOpsRecovery = async (options, input) => {
   }
   return options.opsRecovery;
 };
+var resolveObservabilityExport = async (options, input) => {
+  if (!options.observabilityExport) {
+    return;
+  }
+  if (typeof options.observabilityExport === "function") {
+    return options.observabilityExport(input);
+  }
+  return options.observabilityExport;
+};
 var summarizeTraceDeliveries = async (options) => {
   if (!options.traceDeliveries) {
     return;
@@ -22886,6 +22895,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     bargeInReports,
     campaignReadiness,
     opsRecovery,
+    observabilityExport,
     proofSources
   ] = await Promise.all([
     evaluateVoiceQuality({ events }),
@@ -22921,6 +22931,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     resolveBargeInReports(options, { query, request }),
     resolveCampaignReadiness(options, { query, request }),
     resolveOpsRecovery(options, { query, request }),
+    resolveObservabilityExport(options, { query, request }),
     resolveProofSources(options, { query, request })
   ]);
   const deliveryRuntime = summarizeDeliveryRuntime(deliveryRuntimeSummary);
@@ -23140,6 +23151,14 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     status: campaignReadiness.ok ? "pass" : "fail",
     total: campaignReadiness.checks.length
   } : undefined;
+  const observabilityExportSummary = observabilityExport ? {
+    artifacts: observabilityExport.artifacts.length,
+    auditEvents: observabilityExport.summary.auditEvents,
+    envelopes: observabilityExport.envelopes.length,
+    issues: observabilityExport.issues.length,
+    status: observabilityExport.status,
+    traceEvents: observabilityExport.summary.traceEvents
+  } : 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.`,
@@ -23198,6 +23217,24 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       ]
     });
   }
+  if (observabilityExportSummary && observabilityExport) {
+    const firstIssue = observabilityExport.issues[0];
+    checks.push({
+      detail: observabilityExportSummary.status === "pass" ? `${observabilityExportSummary.envelopes} observability envelope(s), ${observabilityExportSummary.artifacts} artifact(s), and no export issues are ready for customer-owned storage.` : firstIssue?.detail ?? `${observabilityExportSummary.issues} observability export issue(s) need review.`,
+      href: options.links?.observabilityExport ?? "/voice/observability-export",
+      label: "Observability export",
+      proofSource: proofSource("observabilityExport", "observability"),
+      status: observabilityExportSummary.status,
+      value: `${observabilityExportSummary.envelopes}/${observabilityExportSummary.artifacts}`,
+      actions: observabilityExportSummary.status === "pass" ? [] : [
+        {
+          description: "Open the customer-owned observability export manifest and inspect trace, audit, delivery, operations-record, and proof-pack evidence.",
+          href: options.links?.observabilityExport ?? "/voice/observability-export",
+          label: "Open observability export"
+        }
+      ]
+    });
+  }
   if (providerStack) {
     const missingLanes = providerStack.gaps.filter((gap) => gap.status !== "pass");
     checks.push({
@@ -23420,6 +23457,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       handoffRetry: "/api/voice-handoffs/retry",
       liveLatency: "/traces",
       operationsRecords: "/voice-operations",
+      observabilityExport: "/voice/observability-export",
       opsActions: "/voice/ops-actions",
       opsRecovery: "/ops-recovery",
       phoneAgentSmoke: "/sessions",
@@ -23457,6 +23495,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
         status: opsRecovery.status,
         unresolvedProviderFailures: opsRecovery.providers.unresolvedFailures
       } : undefined,
+      observabilityExport: observabilityExportSummary,
       providers: {
         degraded: degradedProviders,
         total: providers.length

package/dist/productionReadiness.d.ts

@@ -15,6 +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 { VoiceObservabilityExportReport } from './observabilityExport';
 export type VoiceProductionReadinessStatus = 'fail' | 'pass' | 'warn';
 export type VoiceProductionReadinessAction = {
     description?: string;
@@ -91,6 +92,7 @@ export type VoiceProductionReadinessReport = {
         handoffRetry?: string;
         liveLatency?: string;
         operationsRecords?: string;
+        observabilityExport?: string;
         opsActions?: string;
         opsRecovery?: string;
         phoneAgentSmoke?: string;
@@ -155,6 +157,14 @@ export type VoiceProductionReadinessReport = {
             status: VoiceProductionReadinessStatus;
             unresolvedProviderFailures: number;
         };
+        observabilityExport?: {
+            artifacts: number;
+            auditEvents: number;
+            envelopes: number;
+            issues: number;
+            status: VoiceProductionReadinessStatus;
+            traceEvents: number;
+        };
         providers: {
             degraded: number;
             total: number;
@@ -338,6 +348,10 @@ export type VoiceProductionReadinessRoutesOptions = {
         query: Record<string, unknown>;
         request: Request;
     }) => Promise<VoiceOpsRecoveryReport> | VoiceOpsRecoveryReport);
+    observabilityExport?: false | VoiceObservabilityExportReport | ((input: {
+        query: Record<string, unknown>;
+        request: Request;
+    }) => Promise<VoiceObservabilityExportReport> | VoiceObservabilityExportReport);
     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.219",
+	"version": "0.0.22-beta.220",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",