@absolutejs/voice 0.0.22-beta.250 → 0.0.22-beta.251

package/README.md

@@ -1386,6 +1386,21 @@ app.use(
 );
 ```
 
+Use `evaluateVoiceProductionReadinessEvidence(...)` or `assertVoiceProductionReadinessEvidence(...)` when a proof pack should check the readiness JSON directly. This keeps release gates tied to structured evidence instead of route text:
+
+```ts
+const readiness = await buildVoiceProductionReadinessReport({
+	store: runtime.traces,
+	providerSlo,
+	opsRecovery
+});
+
+assertVoiceProductionReadinessEvidence(readiness, {
+	requireStatus: 'pass',
+	requiredChecks: ['Provider SLO gates', 'Session health', 'Turn quality']
+});
+```
+
 Built-in profiles:
 
 - `meeting-recorder`: live latency, session health, provider fallback, routing contracts, reconnect proof, and barge-in interruption proof.
@@ -2874,6 +2889,21 @@ 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 `evaluateVoicePlatformCoverage(...)` or `assertVoicePlatformCoverage(...)` when the product needs a structured "Vapi replacement surface coverage" gate. The assertion checks required buyer surfaces, evidence artifact names, total surface count, and failed-surface count:
+
+```ts
+const coverage = buildVoicePlatformCoverageSummary({
+	coverage: latestProofPack.vapiCoverage,
+	runId: latestProofPack.runId
+});
+
+assertVoicePlatformCoverage(coverage, {
+	minSurfaces: 12,
+	requiredEvidence: ['productionReadiness', 'operationsRecord', 'providerSlo'],
+	requiredSurfaces: ['Web voice assistant', 'Call logs and incident handoff']
+});
+```
+
 Use `replayVoiceObservabilityExport(...)` when you need to prove an already-delivered evidence bundle is still usable:
 
 ```ts

package/dist/index.d.ts

@@ -14,8 +14,8 @@ export { buildVoiceDiagnosticsMarkdown, createVoiceDiagnosticsRoutes, resolveVoi
 export { buildVoiceDemoReadyReport, createVoiceDemoReadyRoutes, renderVoiceDemoReadyHTML } from './demoReadyRoutes';
 export { buildVoiceDeliverySinkReport, createVoiceDeliverySinkDescriptor, createVoiceDeliverySinkPair, createVoiceDeliverySinkRoutes, createVoiceFileDeliverySink, createVoicePostgresDeliverySink, createVoiceS3DeliverySink, createVoiceSQLiteDeliverySink, createVoiceWebhookDeliverySink, renderVoiceDeliverySinkHTML } from './deliverySinkRoutes';
 export { buildVoiceOpsActionHistoryReport, createVoiceOpsActionAuditRoutes, recordVoiceOpsActionAudit, renderVoiceOpsActionHistoryHTML } from './opsActionAuditRoutes';
-export { buildVoicePlatformCoverageSummary, createVoicePlatformCoverageRoutes } from './platformCoverage';
-export type { VoicePlatformCoverageEvidence, VoicePlatformCoverageRoutesOptions, VoicePlatformCoverageStatus, VoicePlatformCoverageSummary, VoicePlatformCoverageSummaryInput, VoicePlatformCoverageSurface } from './platformCoverage';
+export { assertVoicePlatformCoverage, buildVoicePlatformCoverageSummary, createVoicePlatformCoverageRoutes, evaluateVoicePlatformCoverage } from './platformCoverage';
+export type { VoicePlatformCoverageAssertionInput, VoicePlatformCoverageAssertionReport, VoicePlatformCoverageEvidence, VoicePlatformCoverageRoutesOptions, VoicePlatformCoverageStatus, VoicePlatformCoverageSummary, VoicePlatformCoverageSummaryInput, VoicePlatformCoverageSurface } from './platformCoverage';
 export { buildEmptyVoiceProofTrendReport, buildVoiceProofTrendReport, createVoiceProofTrendRoutes, DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS, formatVoiceProofTrendAge, normalizeVoiceProofTrendReport, readVoiceProofTrendReportFile } from './proofTrends';
 export type { VoiceProofTrendCycle, VoiceProofTrendReport, VoiceProofTrendReportInput, VoiceProofTrendRoutesOptions, VoiceProofTrendStatus, VoiceProofTrendSummary } from './proofTrends';
 export { buildVoiceLiveOpsControlState, createVoiceLiveOpsController, createVoiceLiveOpsRoutes, createVoiceMemoryLiveOpsControlStore, getVoiceLiveOpsControlStatus, VOICE_LIVE_OPS_ACTIONS } from './liveOps';
@@ -52,7 +52,7 @@ export { createVoiceProviderCapabilityHTMLHandler, createVoiceProviderCapability
 export { assertVoiceProviderRoutingContract, runVoiceProviderRoutingContract } from './providerRoutingContract';
 export { assertVoiceProviderSloEvidence, buildVoiceProviderSloReport, createVoiceProviderSloRoutes, evaluateVoiceProviderSloEvidence, renderVoiceProviderSloHTML, renderVoiceProviderSloMarkdown } from './providerSlo';
 export { createVoicePhoneAgentProductionSmokeHTMLHandler, createVoicePhoneAgentProductionSmokeJSONHandler, createVoicePhoneAgentProductionSmokeRoutes, renderVoicePhoneAgentProductionSmokeHTML, runVoicePhoneAgentProductionSmokeContract } from './phoneAgentProductionSmoke';
-export { buildVoiceProductionReadinessGate, buildVoiceProductionReadinessReport, createVoiceProductionReadinessRoutes, renderVoiceProductionReadinessHTML, summarizeVoiceProductionReadinessGate } from './productionReadiness';
+export { assertVoiceProductionReadinessEvidence, buildVoiceProductionReadinessGate, buildVoiceProductionReadinessReport, createVoiceProductionReadinessRoutes, evaluateVoiceProductionReadinessEvidence, renderVoiceProductionReadinessHTML, summarizeVoiceProductionReadinessGate } from './productionReadiness';
 export { createVoiceReadinessProfile, recommendVoiceReadinessProfile } from './readinessProfiles';
 export { buildVoiceProviderContractMatrix, createVoiceProviderContractMatrixHTMLHandler, createVoiceProviderContractMatrixJSONHandler, createVoiceProviderContractMatrixPreset, createVoiceProviderContractMatrixRoutes, evaluateVoiceProviderStackGaps, renderVoiceProviderContractMatrixHTML, recommendVoiceProviderStack } from './providerStackRecommendations';
 export { buildVoiceOpsConsoleReport, createVoiceOpsConsoleRoutes, renderVoiceOpsConsoleHTML } from './opsConsoleRoutes';
@@ -120,7 +120,7 @@ export type { VoicePhoneAgentCarrier, VoicePhoneAgentCarrierSummary, VoicePhoneA
 export type { VoicePhoneAgentProductionSmokeIssue, VoicePhoneAgentProductionSmokeHandlerOptions, VoicePhoneAgentProductionSmokeHTMLHandlerOptions, VoicePhoneAgentProductionSmokeOptions, VoicePhoneAgentProductionSmokeReport, VoicePhoneAgentProductionSmokeRoutesOptions, VoicePhoneAgentProductionSmokeRequirement } from './phoneAgentProductionSmoke';
 export type { VoiceOpsConsoleLink, VoiceOpsConsoleReport, VoiceOpsConsoleRoutesOptions } from './opsConsoleRoutes';
 export type { VoiceOpsStatus, VoiceOpsStatusLink, VoiceOpsStatusOptions, VoiceOpsStatusReport, VoiceOpsStatusRoutesOptions } from './opsStatus';
-export type { VoiceProductionReadinessAction, VoiceProductionReadinessAuditOptions, VoiceProductionReadinessAuditRequirement, VoiceProductionReadinessAuditSummary, VoiceProductionReadinessCheck, VoiceProductionReadinessGateIssue, VoiceProductionReadinessGateOptions, VoiceProductionReadinessGateProfile, VoiceProductionReadinessGateProfileSurface, VoiceProductionReadinessGateReport, VoiceProductionReadinessOpsActionHistoryOptions, VoiceProductionReadinessOpsActionHistorySummary, VoiceProductionReadinessOperationsRecordLink, VoiceProductionReadinessOperationsRecordLinks, VoiceProductionReadinessProfileExplanation, VoiceProductionReadinessProfileSurface, VoiceProductionReadinessProofSource, VoiceProductionReadinessReport, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessTraceDeliverySummary, VoiceProductionReadinessAuditDeliveryOptions, VoiceProductionReadinessAuditDeliverySummary, VoiceProductionReadinessTraceDeliveryOptions, VoiceProductionReadinessStatus } from './productionReadiness';
+export type { VoiceProductionReadinessAction, VoiceProductionReadinessAuditOptions, VoiceProductionReadinessAuditRequirement, VoiceProductionReadinessAuditSummary, VoiceProductionReadinessAssertionInput, VoiceProductionReadinessAssertionReport, VoiceProductionReadinessCheck, VoiceProductionReadinessGateIssue, VoiceProductionReadinessGateOptions, VoiceProductionReadinessGateProfile, VoiceProductionReadinessGateProfileSurface, VoiceProductionReadinessGateReport, VoiceProductionReadinessOpsActionHistoryOptions, VoiceProductionReadinessOpsActionHistorySummary, VoiceProductionReadinessOperationsRecordLink, VoiceProductionReadinessOperationsRecordLinks, VoiceProductionReadinessProfileExplanation, VoiceProductionReadinessProfileSurface, VoiceProductionReadinessProofSource, VoiceProductionReadinessReport, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessTraceDeliverySummary, VoiceProductionReadinessAuditDeliveryOptions, VoiceProductionReadinessAuditDeliverySummary, VoiceProductionReadinessTraceDeliveryOptions, VoiceProductionReadinessStatus } from './productionReadiness';
 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, VoiceOperationsRecordGuardrailAssertionInput, VoiceOperationsRecordGuardrailAssertionReport, VoiceOperationsRecordGuardrailDecision, VoiceOperationsRecordGuardrailFinding, VoiceOperationsRecordGuardrailSummary, VoiceOperationsRecordIntegrationEventSummary, VoiceOperationsRecordOptions, VoiceOperationsRecordOutcome, VoiceOperationsRecordProviderDecision, VoiceOperationsRecordReviewSummary, VoiceOperationsRecordRoutesOptions, VoiceOperationsRecordStatus, VoiceOperationsRecordTaskSummary, VoiceOperationsRecordTranscriptTurn, VoiceOperationsRecordTool } from './operationsRecord';

package/dist/index.js

@@ -12277,6 +12277,48 @@ var buildVoicePlatformCoverageSummary = (input) => {
     total: coverage.length
   };
 };
+var evaluateVoicePlatformCoverage = (summary, input = {}) => {
+  const issues = [];
+  const surfaces = summary.coverage.map((surface) => surface.surface).sort();
+  const failed = summary.coverage.filter((surface) => surface.status !== "pass").length;
+  const missing = summary.coverage.reduce((total, surface) => total + (surface.missing ?? 0), 0);
+  const evidenceNames = new Set(summary.coverage.flatMap((surface) => surface.evidence.map((evidence) => evidence.name)));
+  if ((input.requirePass ?? true) && !summary.ok) {
+    issues.push(`Expected platform coverage to pass, found ${summary.status}.`);
+  }
+  if (input.minSurfaces !== undefined && summary.total < input.minSurfaces) {
+    issues.push(`Expected at least ${String(input.minSurfaces)} platform coverage surfaces, found ${String(summary.total)}.`);
+  }
+  if (input.maxFailedSurfaces !== undefined && failed > input.maxFailedSurfaces) {
+    issues.push(`Expected at most ${String(input.maxFailedSurfaces)} failing platform coverage surfaces, found ${String(failed)}.`);
+  }
+  for (const surface of input.requiredSurfaces ?? []) {
+    if (!surfaces.includes(surface)) {
+      issues.push(`Missing platform coverage surface: ${surface}.`);
+    }
+  }
+  for (const evidence of input.requiredEvidence ?? []) {
+    if (!evidenceNames.has(evidence)) {
+      issues.push(`Missing platform coverage evidence: ${evidence}.`);
+    }
+  }
+  return {
+    failed,
+    issues,
+    missing,
+    ok: issues.length === 0,
+    status: summary.status,
+    surfaces,
+    total: summary.total
+  };
+};
+var assertVoicePlatformCoverage = (summary, input = {}) => {
+  const report = evaluateVoicePlatformCoverage(summary, input);
+  if (!report.ok) {
+    throw new Error(`Voice platform coverage assertion failed: ${report.issues.join(" ")}`);
+  }
+  return report;
+};
 var normalizeCoverageSummary = (value) => ("status" in value) && ("total" in value) && ("coverage" in value) ? value : buildVoicePlatformCoverageSummary(value);
 var createVoicePlatformCoverageRoutes = (options) => {
   const path = options.path ?? "/api/voice/platform-coverage";
@@ -24776,6 +24818,48 @@ var summarizeVoiceProductionReadinessGate = (report, options = {}) => {
     warnings
   };
 };
+var evaluateVoiceProductionReadinessEvidence = (report, input = {}) => {
+  const gate = summarizeVoiceProductionReadinessGate(report);
+  const issues = [];
+  const checks = report.checks.map((check) => check.label).sort();
+  const requiredStatus = input.requireStatus ?? "pass";
+  const requireGateOk = input.requireGateOk ?? true;
+  const maxFailures = input.maxFailures ?? 0;
+  const maxWarnings = input.maxWarnings;
+  if (report.status !== requiredStatus) {
+    issues.push(`Expected production readiness status ${requiredStatus}, found ${report.status}.`);
+  }
+  if (requireGateOk && !gate.ok) {
+    issues.push(`Expected production readiness gate to pass, found ${gate.status}.`);
+  }
+  if (gate.failures.length > maxFailures) {
+    issues.push(`Expected at most ${String(maxFailures)} production readiness failures, found ${String(gate.failures.length)}.`);
+  }
+  if (maxWarnings !== undefined && gate.warnings.length > maxWarnings) {
+    issues.push(`Expected at most ${String(maxWarnings)} production readiness warnings, found ${String(gate.warnings.length)}.`);
+  }
+  for (const check of input.requiredChecks ?? []) {
+    if (!checks.includes(check)) {
+      issues.push(`Missing production readiness check: ${check}.`);
+    }
+  }
+  return {
+    checks,
+    failures: gate.failures.length,
+    gateOk: gate.ok,
+    issues,
+    ok: issues.length === 0,
+    status: report.status,
+    warnings: gate.warnings.length
+  };
+};
+var assertVoiceProductionReadinessEvidence = (report, input = {}) => {
+  const assertion = evaluateVoiceProductionReadinessEvidence(report, input);
+  if (!assertion.ok) {
+    throw new Error(`Voice production readiness assertion failed: ${assertion.issues.join(" ")}`);
+  }
+  return assertion;
+};
 var carrierStatus = (matrix) => matrix.summary.failing > 0 ? "fail" : matrix.summary.warnings > 0 || matrix.summary.ready < matrix.summary.providers ? "warn" : "pass";
 var resolveCarriers = async (options, input) => {
   if (options.carriers === false || options.carriers === undefined) {
@@ -30074,6 +30158,8 @@ export {
   evaluateVoiceQuality,
   evaluateVoiceProviderStackGaps,
   evaluateVoiceProviderSloEvidence,
+  evaluateVoiceProductionReadinessEvidence,
+  evaluateVoicePlatformCoverage,
   evaluateVoiceOperationsRecordGuardrails,
   evaluateVoiceGuardrailPolicy,
   encodeTwilioMulawBase64,
@@ -30389,6 +30475,8 @@ export {
   assignVoiceOpsTask,
   assertVoiceProviderSloEvidence,
   assertVoiceProviderRoutingContract,
+  assertVoiceProductionReadinessEvidence,
+  assertVoicePlatformCoverage,
   assertVoiceOperationsRecordGuardrails,
   assertVoiceObservabilityExportSchema,
   assertVoiceObservabilityExportRecord,

package/dist/platformCoverage.d.ts

@@ -42,7 +42,25 @@ export type VoicePlatformCoverageRoutesOptions = {
     path?: string;
     source: (() => Promise<VoicePlatformCoverageSummary | VoicePlatformCoverageSummaryInput> | VoicePlatformCoverageSummary | VoicePlatformCoverageSummaryInput) | VoicePlatformCoverageSummary | VoicePlatformCoverageSummaryInput;
 };
+export type VoicePlatformCoverageAssertionInput = {
+    maxFailedSurfaces?: number;
+    minSurfaces?: number;
+    requiredEvidence?: string[];
+    requiredSurfaces?: string[];
+    requirePass?: boolean;
+};
+export type VoicePlatformCoverageAssertionReport = {
+    failed: number;
+    issues: string[];
+    missing: number;
+    ok: boolean;
+    status: VoicePlatformCoverageStatus;
+    surfaces: string[];
+    total: number;
+};
 export declare const buildVoicePlatformCoverageSummary: (input: VoicePlatformCoverageSummaryInput) => VoicePlatformCoverageSummary;
+export declare const evaluateVoicePlatformCoverage: (summary: VoicePlatformCoverageSummary, input?: VoicePlatformCoverageAssertionInput) => VoicePlatformCoverageAssertionReport;
+export declare const assertVoicePlatformCoverage: (summary: VoicePlatformCoverageSummary, input?: VoicePlatformCoverageAssertionInput) => VoicePlatformCoverageAssertionReport;
 export declare const createVoicePlatformCoverageRoutes: (options: VoicePlatformCoverageRoutesOptions) => Elysia<"", {
     decorator: {};
     store: {};

package/dist/productionReadiness.d.ts

@@ -58,6 +58,22 @@ export type VoiceProductionReadinessGateReport = {
     status: VoiceProductionReadinessStatus;
     warnings: VoiceProductionReadinessGateIssue[];
 };
+export type VoiceProductionReadinessAssertionInput = {
+    maxFailures?: number;
+    maxWarnings?: number;
+    requiredChecks?: string[];
+    requireGateOk?: boolean;
+    requireStatus?: VoiceProductionReadinessStatus;
+};
+export type VoiceProductionReadinessAssertionReport = {
+    checks: string[];
+    failures: number;
+    gateOk: boolean;
+    issues: string[];
+    ok: boolean;
+    status: VoiceProductionReadinessStatus;
+    warnings: number;
+};
 export type VoiceProductionReadinessProofSource = {
     detail?: string;
     href?: string;
@@ -425,6 +441,8 @@ export type VoiceProductionReadinessRoutesOptions = {
     liveLatencyFailAfterMs?: number;
 };
 export declare const summarizeVoiceProductionReadinessGate: (report: VoiceProductionReadinessReport, options?: VoiceProductionReadinessGateOptions) => VoiceProductionReadinessGateReport;
+export declare const evaluateVoiceProductionReadinessEvidence: (report: VoiceProductionReadinessReport, input?: VoiceProductionReadinessAssertionInput) => VoiceProductionReadinessAssertionReport;
+export declare const assertVoiceProductionReadinessEvidence: (report: VoiceProductionReadinessReport, input?: VoiceProductionReadinessAssertionInput) => VoiceProductionReadinessAssertionReport;
 export declare const buildVoiceProductionReadinessReport: (options: VoiceProductionReadinessRoutesOptions, input?: {
     query?: Record<string, unknown>;
     request?: Request;

package/package.json

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