@absolutejs/voice 0.0.22-beta.376 → 0.0.22-beta.378

package/README.md

@@ -1547,6 +1547,20 @@ const recoveryJobs = createVoiceSQLiteRealCallProfileRecoveryJobStore({
 
 Recovery routes expose recent persisted jobs at `${path}/actions/jobs`. Stores can implement `list({ limit, actionId, status })`; the bundled memory and SQLite stores both support it.
 
+Use `buildVoiceRealCallProfileRecoveryJobHistoryCheck(...)` in production readiness to prove recovery jobs are persisted and inspectable:
+
+```ts
+additionalChecks: async () => [
+	await buildVoiceRealCallProfileRecoveryJobHistoryCheck(recoveryJobs)
+];
+```
+
+Use `buildVoiceReadinessRecoveryActions(...)` when a UI or API needs a compact plan of actions attached to failed or warning readiness checks:
+
+```ts
+const recoveryPlan = buildVoiceReadinessRecoveryActions(readinessReport);
+```
+
 Use `createVoiceProfileTraceTagger(...)` when the app already has a trace store and needs every appended trace to carry a benchmark profile label. It wraps any `VoiceTraceEventStore`, preserves the underlying store behavior, and adds `profileId`/`benchmarkProfileId` metadata and payload fields that real-call profile history can ingest later.
 
 ```ts

package/dist/client/index.js

@@ -4760,6 +4760,94 @@ var buildVoiceRealCallProfileReadinessCheck = (report, options = {}) => {
     value: `${String(report.defaults.summary.actionableProfiles)}/${String(report.summary.profileCount)} actionable`
   };
 };
+var buildVoiceRealCallProfileRecoveryJobHistoryCheck = async (store, options = {}) => {
+  const href = options.href ?? "/voice/real-call-profile-recovery";
+  const sourceHref = options.sourceHref ?? "/api/voice/real-call-profile-history/actions/jobs";
+  const minCompletedJobs = options.minCompletedJobs ?? 1;
+  const label = options.label ?? "Real-call recovery job history";
+  if (!store?.list) {
+    return {
+      actions: [
+        {
+          description: "Configure a recovery job store with list support so operators can inspect proof repair history.",
+          href,
+          label: "Configure recovery job history"
+        }
+      ],
+      detail: "No real-call profile recovery job store with list support is configured.",
+      gateExplanation: {
+        evidenceHref: sourceHref,
+        observed: "missing",
+        remediation: "Use the bundled memory or SQLite recovery job store, or implement list() on the custom store.",
+        sourceHref,
+        threshold: "list support",
+        thresholdLabel: "Inspectable recovery jobs",
+        unit: "status"
+      },
+      href,
+      label,
+      status: "fail",
+      value: "missing"
+    };
+  }
+  const jobs = await store.list({ limit: 50 });
+  const now = Date.now();
+  const recentJobs = options.maxAgeMs === undefined ? jobs : jobs.filter((job) => now - Date.parse(job.updatedAt) <= options.maxAgeMs);
+  const completedJobs = recentJobs.filter((job) => job.status === "pass" || job.status === "fail");
+  const failedJobs = recentJobs.filter((job) => job.status === "fail");
+  const runningJobs = recentJobs.filter((job) => job.status === "queued" || job.status === "running");
+  const issues = [];
+  const warnings = [];
+  if (completedJobs.length < minCompletedJobs) {
+    issues.push(`Expected at least ${String(minCompletedJobs)} completed recovery job(s), found ${String(completedJobs.length)}.`);
+  }
+  if (!options.allowFailedJobs && failedJobs.length > 0) {
+    issues.push(`${String(failedJobs.length)} recent recovery job(s) failed.`);
+  }
+  if (runningJobs.length > 0) {
+    const message = `${String(runningJobs.length)} recovery job(s) are still queued or running.`;
+    if (options.failOnRunningJobs) {
+      issues.push(message);
+    } else {
+      warnings.push(message);
+    }
+  }
+  const status = issues.length > 0 ? "fail" : warnings.length > 0 ? "warn" : "pass";
+  const detail = status === "pass" ? `${String(completedJobs.length)} completed recovery job(s), ${String(failedJobs.length)} failed, ${String(runningJobs.length)} running.` : [...issues, ...warnings].join(" ");
+  return {
+    actions: [
+      {
+        description: "Open the recovery job UI and run or inspect proof repair jobs.",
+        href,
+        label: "Open recovery job history"
+      },
+      {
+        description: "Open the recovery job history API.",
+        href: sourceHref,
+        label: "Open recovery jobs API"
+      }
+    ],
+    detail,
+    gateExplanation: {
+      evidenceHref: sourceHref,
+      observed: completedJobs.length,
+      remediation: "Run a browser or phone recovery proof job and ensure recent recovery jobs complete without failure.",
+      sourceHref,
+      threshold: minCompletedJobs,
+      thresholdLabel: "Minimum completed recovery jobs",
+      unit: "count"
+    },
+    href,
+    label,
+    proofSource: {
+      href: sourceHref,
+      source: "recovery-job-store",
+      sourceLabel: "Real-call recovery jobs"
+    },
+    status,
+    value: `${String(completedJobs.length)} completed / ${String(failedJobs.length)} failed / ${String(runningJobs.length)} running`
+  };
+};
 var resolveVoiceRealCallProfileProviderRoute = (options) => {
   const defaults = readRealCallProfileDefaultsReport(options.defaults);
   const profile = defaults.profiles.find((item) => item.profileId === options.profileId) ?? defaults.profiles.find((item) => item.status === "pass") ?? defaults.profiles[0];

package/dist/index.d.ts

@@ -30,12 +30,12 @@ export { assertVoicePlatformCoverage, buildVoicePlatformCoverageSummary, createV
 export { assertVoiceCompetitiveCoverage, buildVoiceCompetitiveCoverageReport, createVoiceCompetitiveCoverageRoutes, evaluateVoiceCompetitiveCoverage, renderVoiceCompetitiveCoverageHTML, renderVoiceCompetitiveCoverageMarkdown } from './competitiveCoverage';
 export type { VoiceCompetitiveCoverageAssertionInput, VoiceCompetitiveCoverageAssertionReport, VoiceCompetitiveCoverageIssue, VoiceCompetitiveCoverageLevel, VoiceCompetitiveCoverageReport, VoiceCompetitiveCoverageReportInput, VoiceCompetitiveCoverageRoutesOptions, VoiceCompetitiveCoverageStatus, VoiceCompetitiveCoverageSummary, VoiceCompetitiveDepthLevel, VoiceCompetitiveEvidence, VoiceCompetitiveSurface } from './competitiveCoverage';
 export type { VoicePlatformCoverageAssertionInput, VoicePlatformCoverageAssertionReport, VoicePlatformCoverageEvidence, VoicePlatformCoverageRoutesOptions, VoicePlatformCoverageStatus, VoicePlatformCoverageSummary, VoicePlatformCoverageSummaryInput, VoicePlatformCoverageSurface } from './platformCoverage';
-export { assertVoiceProofTrendEvidence, buildEmptyVoiceProofTrendReport, buildVoiceProofTrendProfileSummaries, buildVoiceProofTrendRecommendationReport, buildVoiceProofTrendReportFromRealCallProfiles, buildVoiceProofTrendReport, buildVoiceRealCallProfileEvidenceFromTraceEvents, buildVoiceRealCallProfileDefaults, buildVoiceRealCallProfileHistoryReport, buildVoiceRealCallProfileReadinessCheck, buildVoiceRealCallProfileRecoveryActions, createVoiceInMemoryRealCallProfileRecoveryJobStore, createVoiceSQLiteRealCallProfileRecoveryJobStore, createVoiceProofTrendRecommendationRoutes, createVoiceProofTrendRoutes, createVoiceRealCallProfileHistoryRoutes, createVoiceRealCallProfileRecoveryActionRoutes, DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS, DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS, evaluateVoiceProofTrendEvidence, formatVoiceProofTrendAge, loadVoiceRealCallProfileEvidenceFromTraceStore, normalizeVoiceProofTrendReport, readVoiceProofTrendReportFile, renderVoiceProofTrendRecommendationHTML, renderVoiceProofTrendRecommendationMarkdown, renderVoiceRealCallProfileHistoryHTML, renderVoiceRealCallProfileHistoryMarkdown, resolveVoiceRealCallProfileProviderRoute } from './proofTrends';
+export { assertVoiceProofTrendEvidence, buildEmptyVoiceProofTrendReport, buildVoiceProofTrendProfileSummaries, buildVoiceProofTrendRecommendationReport, buildVoiceProofTrendReportFromRealCallProfiles, buildVoiceProofTrendReport, buildVoiceRealCallProfileEvidenceFromTraceEvents, buildVoiceRealCallProfileDefaults, buildVoiceRealCallProfileHistoryReport, buildVoiceRealCallProfileReadinessCheck, buildVoiceRealCallProfileRecoveryJobHistoryCheck, buildVoiceRealCallProfileRecoveryActions, createVoiceInMemoryRealCallProfileRecoveryJobStore, createVoiceSQLiteRealCallProfileRecoveryJobStore, createVoiceProofTrendRecommendationRoutes, createVoiceProofTrendRoutes, createVoiceRealCallProfileHistoryRoutes, createVoiceRealCallProfileRecoveryActionRoutes, DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS, DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS, evaluateVoiceProofTrendEvidence, formatVoiceProofTrendAge, loadVoiceRealCallProfileEvidenceFromTraceStore, normalizeVoiceProofTrendReport, readVoiceProofTrendReportFile, renderVoiceProofTrendRecommendationHTML, renderVoiceProofTrendRecommendationMarkdown, renderVoiceRealCallProfileHistoryHTML, renderVoiceRealCallProfileHistoryMarkdown, resolveVoiceRealCallProfileProviderRoute } from './proofTrends';
 export { applyVoiceProfileSwitchGuard, buildVoiceProfileSwitchReadinessReport, buildVoiceProfileSwitchLiveDecisionReport, createVoiceProfileSwitchLiveDecisionRoutes, createVoiceProfileSwitchPolicyProofRoutes, createVoiceProfileSwitchReadinessRoutes, recommendVoiceProfileSwitch, renderVoiceProfileSwitchLiveDecisionHTML, renderVoiceProfileSwitchPolicyProofHTML, renderVoiceProfileSwitchReadinessHTML, runVoiceProfileSwitchPolicyProof } from './profileSwitchRecommendation';
 export type { VoiceProfileSwitchGuardAction, VoiceProfileSwitchGuardDecision, VoiceProfileSwitchGuardMode, VoiceProfileSwitchGuardOptions, VoiceProfileSwitchObservedSignals, VoiceProfileSwitchLiveDecisionEvidence, VoiceProfileSwitchLiveDecisionReport, VoiceProfileSwitchLiveDecisionReportOptions, VoiceProfileSwitchLiveDecisionRoutesOptions, VoiceProfileSwitchLiveDecisionSession, VoiceProfileSwitchPolicyProofCase, VoiceProfileSwitchPolicyProofCaseResult, VoiceProfileSwitchPolicyProofOptions, VoiceProfileSwitchPolicyProofReport, VoiceProfileSwitchPolicyProofRoutesOptions, VoiceProfileSwitchReadinessIssue, VoiceProfileSwitchReadinessOptions, VoiceProfileSwitchReadinessReport, VoiceProfileSwitchReadinessRoutesOptions, VoiceProfileSwitchReadinessStatus, VoiceProfileSwitchRecommendation, VoiceProfileSwitchRecommendationOptions } from './profileSwitchRecommendation';
 export { buildVoiceProviderDecisionTraceReport, createVoiceProviderDecisionTraceEvent, createVoiceProviderDecisionTraceRoutes, listVoiceProviderDecisionTraces, renderVoiceProviderDecisionTraceHTML, renderVoiceProviderDecisionTraceMarkdown } from './providerDecisionTraces';
 export type { VoiceProviderDecisionStatus, VoiceProviderDecisionSurfaceReport, VoiceProviderDecisionTrace, VoiceProviderDecisionTraceInput, VoiceProviderDecisionTraceIssue, VoiceProviderDecisionTraceReport, VoiceProviderDecisionTraceReportOptions, VoiceProviderDecisionTraceRoutesOptions } from './providerDecisionTraces';
-export type { VoiceProofTrendAssertionInput, VoiceProofTrendAssertionReport, VoiceProofTrendCycle, VoiceProofTrendProfileDefinition, VoiceProofTrendProfileRecommendation, VoiceProofTrendProfileSummaryOptions, VoiceProofTrendProfileSummary, VoiceProofTrendProviderRecommendation, VoiceProofTrendProviderSummary, VoiceProofTrendRecommendation, VoiceProofTrendRecommendationOptions, VoiceProofTrendRecommendationReport, VoiceProofTrendRecommendationRoutesOptions, VoiceProofTrendRecommendationStatus, VoiceProofTrendRecommendationSurface, VoiceProofTrendRealCallProfileEvidence, VoiceProofTrendRealCallProfileReportOptions, VoiceProofTrendReport, VoiceProofTrendReportInput, VoiceProofTrendRoutesOptions, VoiceProofTrendRuntimeChannelSummary, VoiceProofTrendStatus, VoiceProofTrendSummary, VoiceRealCallProfileDefault, VoiceRealCallProfileDefaultsOptions, VoiceRealCallProfileDefaultsReport, VoiceRealCallProfileHistoryOptions, VoiceRealCallProfileHistoryReport, VoiceRealCallProfileHistoryRoutesOptions, VoiceRealCallProfileProviderRouteOptions, VoiceRealCallProfileReadinessCheckOptions, VoiceRealCallProfileRecoveryActionOptions, VoiceRealCallProfileRecoveryAction, VoiceRealCallProfileRecoveryActionHandler, VoiceRealCallProfileRecoveryActionHandlerInput, VoiceRealCallProfileRecoveryActionId, VoiceRealCallProfileRecoveryActionResult, VoiceRealCallProfileRecoveryActionRoutesOptions, VoiceRealCallProfileRecoveryJob, VoiceRealCallProfileRecoveryJobCreateInput, VoiceRealCallProfileRecoveryJobListOptions, VoiceRealCallProfileRecoveryJobStatus, VoiceRealCallProfileRecoveryJobStore, VoiceRealCallProfileRecoveryJobUpdate, VoiceSQLiteRealCallProfileRecoveryJobStoreOptions, VoiceRealCallProfileTraceEvidenceOptions, VoiceRealCallProfileTraceStoreEvidenceOptions } from './proofTrends';
+export type { VoiceProofTrendAssertionInput, VoiceProofTrendAssertionReport, VoiceProofTrendCycle, VoiceProofTrendProfileDefinition, VoiceProofTrendProfileRecommendation, VoiceProofTrendProfileSummaryOptions, VoiceProofTrendProfileSummary, VoiceProofTrendProviderRecommendation, VoiceProofTrendProviderSummary, VoiceProofTrendRecommendation, VoiceProofTrendRecommendationOptions, VoiceProofTrendRecommendationReport, VoiceProofTrendRecommendationRoutesOptions, VoiceProofTrendRecommendationStatus, VoiceProofTrendRecommendationSurface, VoiceProofTrendRealCallProfileEvidence, VoiceProofTrendRealCallProfileReportOptions, VoiceProofTrendReport, VoiceProofTrendReportInput, VoiceProofTrendRoutesOptions, VoiceProofTrendRuntimeChannelSummary, VoiceProofTrendStatus, VoiceProofTrendSummary, VoiceRealCallProfileDefault, VoiceRealCallProfileDefaultsOptions, VoiceRealCallProfileDefaultsReport, VoiceRealCallProfileHistoryOptions, VoiceRealCallProfileHistoryReport, VoiceRealCallProfileHistoryRoutesOptions, VoiceRealCallProfileProviderRouteOptions, VoiceRealCallProfileReadinessCheckOptions, VoiceRealCallProfileRecoveryActionOptions, VoiceRealCallProfileRecoveryAction, VoiceRealCallProfileRecoveryActionHandler, VoiceRealCallProfileRecoveryActionHandlerInput, VoiceRealCallProfileRecoveryActionId, VoiceRealCallProfileRecoveryJobHistoryCheckOptions, VoiceRealCallProfileRecoveryActionResult, VoiceRealCallProfileRecoveryActionRoutesOptions, VoiceRealCallProfileRecoveryJob, VoiceRealCallProfileRecoveryJobCreateInput, VoiceRealCallProfileRecoveryJobListOptions, VoiceRealCallProfileRecoveryJobStatus, VoiceRealCallProfileRecoveryJobStore, VoiceRealCallProfileRecoveryJobUpdate, VoiceSQLiteRealCallProfileRecoveryJobStoreOptions, VoiceRealCallProfileTraceEvidenceOptions, VoiceRealCallProfileTraceStoreEvidenceOptions } from './proofTrends';
 export { assertVoiceSloCalibration, buildVoiceSloCalibrationReport, buildVoiceSloReadinessThresholdReport, createVoiceSloReadinessThresholdOptions, createVoiceSloReadinessThresholdRoutes, createVoiceSloThresholdProfile, createVoiceSloCalibrationRoutes, renderVoiceSloCalibrationMarkdown, renderVoiceSloReadinessThresholdHTML, renderVoiceSloReadinessThresholdMarkdown } from './sloCalibration';
 export type { VoiceSloCalibrationMetricKey, VoiceSloCalibrationOptions, VoiceSloCalibrationReport, VoiceSloCalibrationRoutesOptions, VoiceSloCalibrationSample, VoiceSloCalibrationStatus, VoiceSloCalibrationThreshold, VoiceSloCalibrationThresholds, VoiceSloReadinessThresholdReport, VoiceSloReadinessThresholdReportOptions, VoiceSloReadinessThresholdOptions, VoiceSloReadinessThresholdRoutesOptions, VoiceSloThresholdProfile } from './sloCalibration';
 export { assertVoiceLiveOpsControlEvidence, assertVoiceLiveOpsEvidence, buildVoiceLiveOpsControlState, createVoiceLiveOpsController, createVoiceLiveOpsRoutes, createVoiceMemoryLiveOpsControlStore, evaluateVoiceLiveOpsControlEvidence, evaluateVoiceLiveOpsEvidence, getVoiceLiveOpsControlStatus, VOICE_LIVE_OPS_ACTIONS } from './liveOps';
@@ -72,7 +72,7 @@ export { buildVoiceProviderOrchestrationReport, createVoiceProviderOrchestration
 export { assertVoiceProviderRoutingContractEvidence, assertVoiceProviderRoutingContract, evaluateVoiceProviderRoutingContractEvidence, runVoiceProviderRoutingContract } from './providerRoutingContract';
 export { assertVoiceProviderSloEvidence, buildVoiceProviderSloReport, createVoiceProviderSloRoutes, evaluateVoiceProviderSloEvidence, renderVoiceProviderSloHTML, renderVoiceProviderSloMarkdown } from './providerSlo';
 export { createVoicePhoneAgentProductionSmokeHTMLHandler, createVoicePhoneAgentProductionSmokeJSONHandler, createVoicePhoneAgentProductionSmokeRoutes, renderVoicePhoneAgentProductionSmokeHTML, runVoicePhoneAgentProductionSmokeContract } from './phoneAgentProductionSmoke';
-export { assertVoiceProductionReadinessEvidence, buildVoiceProductionReadinessGate, buildVoiceProductionReadinessReport, createVoiceProductionReadinessProofRuntime, createVoiceProductionReadinessRoutes, evaluateVoiceProductionReadinessEvidence, renderVoiceProductionReadinessHTML, summarizeVoiceProductionReadinessGate } from './productionReadiness';
+export { assertVoiceProductionReadinessEvidence, buildVoiceProductionReadinessGate, buildVoiceProductionReadinessReport, buildVoiceReadinessRecoveryActions, createVoiceProductionReadinessProofRuntime, createVoiceProductionReadinessRoutes, evaluateVoiceProductionReadinessEvidence, renderVoiceProductionReadinessHTML, summarizeVoiceProductionReadinessGate } from './productionReadiness';
 export { acknowledgeVoiceMonitorIssue, buildVoiceMonitorRunReport, createVoiceMemoryMonitorIssueStore, createVoiceMemoryMonitorNotifierDeliveryReceiptStore, createVoiceMonitorRoutes, createVoiceMonitorRunner, createVoiceMonitorRunnerRoutes, createVoiceMonitorWebhookNotifier, deliverVoiceMonitorIssueNotifications, muteVoiceMonitorIssue, renderVoiceMonitorHTML, renderVoiceMonitorMarkdown, resolveVoiceMonitorIssue } from './voiceMonitoring';
 export { createVoiceReadinessProfile, recommendVoiceReadinessProfile } from './readinessProfiles';
 export { assertVoiceProviderContractMatrixEvidence, assertVoiceProviderStackEvidence, buildVoiceProviderContractMatrix, createVoiceProviderContractMatrixHTMLHandler, createVoiceProviderContractMatrixJSONHandler, createVoiceProviderContractMatrixPreset, createVoiceProviderContractMatrixRoutes, evaluateVoiceProviderContractMatrixEvidence, evaluateVoiceProviderStackEvidence, evaluateVoiceProviderStackGaps, renderVoiceProviderContractMatrixHTML, recommendVoiceProviderStack } from './providerStackRecommendations';
@@ -142,7 +142,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, VoiceProductionReadinessAssertionInput, VoiceProductionReadinessAssertionReport, VoiceProductionReadinessCheck, VoiceProductionReadinessGateExplanation, VoiceProductionReadinessGateIssue, VoiceProductionReadinessGateOptions, VoiceProductionReadinessGateProfile, VoiceProductionReadinessGateProfileSurface, VoiceProductionReadinessGateReport, VoiceProductionReadinessOpsActionHistoryOptions, VoiceProductionReadinessOpsActionHistorySummary, VoiceProductionReadinessOperationsRecordLink, VoiceProductionReadinessOperationsRecordLinks, VoiceProductionReadinessProfileExplanation, VoiceProductionReadinessProfileSurface, VoiceProductionReadinessProofMetadata, VoiceProductionReadinessProofRuntime, VoiceProductionReadinessProofRuntimeOptions, VoiceProductionReadinessProofRuntimeSeedOptions, VoiceProductionReadinessProofSource, VoiceProductionReadinessReport, VoiceProductionReadinessRouteInput, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessTraceDeliverySummary, VoiceProductionReadinessAuditDeliveryOptions, VoiceProductionReadinessAuditDeliverySummary, VoiceProductionReadinessTraceDeliveryOptions, VoiceProductionReadinessStatus } from './productionReadiness';
+export type { VoiceProductionReadinessAction, VoiceProductionReadinessAuditOptions, VoiceProductionReadinessAuditRequirement, VoiceProductionReadinessAuditSummary, VoiceProductionReadinessAssertionInput, VoiceProductionReadinessAssertionReport, VoiceProductionReadinessCheck, VoiceProductionReadinessGateExplanation, VoiceProductionReadinessGateIssue, VoiceProductionReadinessGateOptions, VoiceProductionReadinessGateProfile, VoiceProductionReadinessGateProfileSurface, VoiceProductionReadinessGateReport, VoiceProductionReadinessOpsActionHistoryOptions, VoiceProductionReadinessOpsActionHistorySummary, VoiceProductionReadinessOperationsRecordLink, VoiceProductionReadinessOperationsRecordLinks, VoiceProductionReadinessProfileExplanation, VoiceProductionReadinessProfileSurface, VoiceProductionReadinessProofMetadata, VoiceProductionReadinessProofRuntime, VoiceProductionReadinessProofRuntimeOptions, VoiceProductionReadinessProofRuntimeSeedOptions, VoiceProductionReadinessProofSource, VoiceProductionReadinessReport, VoiceProductionReadinessRouteInput, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessTraceDeliverySummary, VoiceReadinessRecoveryAction, VoiceReadinessRecoveryActionOptions, VoiceReadinessRecoveryActionPlan, VoiceProductionReadinessAuditDeliveryOptions, VoiceProductionReadinessAuditDeliverySummary, VoiceProductionReadinessTraceDeliveryOptions, VoiceProductionReadinessStatus } from './productionReadiness';
 export type { VoiceMonitorDefinition, VoiceMonitorEvaluation, VoiceMonitorEvaluationInput, VoiceMonitorIssue, VoiceMonitorIssueStatus, VoiceMonitorIssueStore, VoiceMonitorNotifier, VoiceMonitorNotifierDeliveryInput, VoiceMonitorNotifierDeliveryOptions, VoiceMonitorNotifierDeliveryReceipt, VoiceMonitorNotifierDeliveryReceiptStore, VoiceMonitorNotifierDeliveryReport, VoiceMonitorNotifierDeliveryResult, VoiceMonitorRoutesOptions, VoiceMonitorRun, VoiceMonitorRunOptions, VoiceMonitorRunReport, VoiceMonitorRunner, VoiceMonitorRunnerOptions, VoiceMonitorRunnerRoutesOptions, VoiceMonitorRunnerTickResult, VoiceMonitorSeverity, VoiceMonitorStatus, VoiceMonitorWebhookNotifierOptions } from './voiceMonitoring';
 export type { VoiceReadinessProfileName, VoiceReadinessProfileOptions, VoiceReadinessProfileRecommendation, VoiceReadinessProfileRecommendationScore, VoiceReadinessProfileRoutesOptions } from './readinessProfiles';
 export type { VoiceProviderStackChoice, VoiceProviderStackCapabilities, VoiceProviderStackCapabilityGap, VoiceProviderStackCapabilityGapInput, VoiceProviderStackCapabilityGapReport, VoiceProviderContractCheck, VoiceProviderContractCheckStatus, VoiceProviderContractDefinition, VoiceProviderContractMatrixAssertionInput, VoiceProviderContractMatrixAssertionReport, VoiceProviderContractMatrixHandlerOptions, VoiceProviderContractMatrixHTMLHandlerOptions, VoiceProviderContractMatrixInput, VoiceProviderContractMatrixPresetOptions, VoiceProviderContractMatrixReport, VoiceProviderContractMatrixRoutesOptions, VoiceProviderContractMatrixRow, VoiceProviderStackAssertionInput, VoiceProviderStackAssertionReport, VoiceProviderStackInput, VoiceProviderStackKind, VoiceProviderStackRecommendation } from './providerStackRecommendations';

package/dist/index.js

@@ -16229,6 +16229,94 @@ var buildVoiceRealCallProfileReadinessCheck = (report, options = {}) => {
     value: `${String(report.defaults.summary.actionableProfiles)}/${String(report.summary.profileCount)} actionable`
   };
 };
+var buildVoiceRealCallProfileRecoveryJobHistoryCheck = async (store, options = {}) => {
+  const href = options.href ?? "/voice/real-call-profile-recovery";
+  const sourceHref = options.sourceHref ?? "/api/voice/real-call-profile-history/actions/jobs";
+  const minCompletedJobs = options.minCompletedJobs ?? 1;
+  const label = options.label ?? "Real-call recovery job history";
+  if (!store?.list) {
+    return {
+      actions: [
+        {
+          description: "Configure a recovery job store with list support so operators can inspect proof repair history.",
+          href,
+          label: "Configure recovery job history"
+        }
+      ],
+      detail: "No real-call profile recovery job store with list support is configured.",
+      gateExplanation: {
+        evidenceHref: sourceHref,
+        observed: "missing",
+        remediation: "Use the bundled memory or SQLite recovery job store, or implement list() on the custom store.",
+        sourceHref,
+        threshold: "list support",
+        thresholdLabel: "Inspectable recovery jobs",
+        unit: "status"
+      },
+      href,
+      label,
+      status: "fail",
+      value: "missing"
+    };
+  }
+  const jobs = await store.list({ limit: 50 });
+  const now = Date.now();
+  const recentJobs = options.maxAgeMs === undefined ? jobs : jobs.filter((job) => now - Date.parse(job.updatedAt) <= options.maxAgeMs);
+  const completedJobs = recentJobs.filter((job) => job.status === "pass" || job.status === "fail");
+  const failedJobs = recentJobs.filter((job) => job.status === "fail");
+  const runningJobs = recentJobs.filter((job) => job.status === "queued" || job.status === "running");
+  const issues = [];
+  const warnings = [];
+  if (completedJobs.length < minCompletedJobs) {
+    issues.push(`Expected at least ${String(minCompletedJobs)} completed recovery job(s), found ${String(completedJobs.length)}.`);
+  }
+  if (!options.allowFailedJobs && failedJobs.length > 0) {
+    issues.push(`${String(failedJobs.length)} recent recovery job(s) failed.`);
+  }
+  if (runningJobs.length > 0) {
+    const message = `${String(runningJobs.length)} recovery job(s) are still queued or running.`;
+    if (options.failOnRunningJobs) {
+      issues.push(message);
+    } else {
+      warnings.push(message);
+    }
+  }
+  const status = issues.length > 0 ? "fail" : warnings.length > 0 ? "warn" : "pass";
+  const detail = status === "pass" ? `${String(completedJobs.length)} completed recovery job(s), ${String(failedJobs.length)} failed, ${String(runningJobs.length)} running.` : [...issues, ...warnings].join(" ");
+  return {
+    actions: [
+      {
+        description: "Open the recovery job UI and run or inspect proof repair jobs.",
+        href,
+        label: "Open recovery job history"
+      },
+      {
+        description: "Open the recovery job history API.",
+        href: sourceHref,
+        label: "Open recovery jobs API"
+      }
+    ],
+    detail,
+    gateExplanation: {
+      evidenceHref: sourceHref,
+      observed: completedJobs.length,
+      remediation: "Run a browser or phone recovery proof job and ensure recent recovery jobs complete without failure.",
+      sourceHref,
+      threshold: minCompletedJobs,
+      thresholdLabel: "Minimum completed recovery jobs",
+      unit: "count"
+    },
+    href,
+    label,
+    proofSource: {
+      href: sourceHref,
+      source: "recovery-job-store",
+      sourceLabel: "Real-call recovery jobs"
+    },
+    status,
+    value: `${String(completedJobs.length)} completed / ${String(failedJobs.length)} failed / ${String(runningJobs.length)} running`
+  };
+};
 var resolveVoiceRealCallProfileProviderRoute = (options) => {
   const defaults = readRealCallProfileDefaultsReport(options.defaults);
   const profile = defaults.profiles.find((item) => item.profileId === options.profileId) ?? defaults.profiles.find((item) => item.status === "pass") ?? defaults.profiles[0];
@@ -32465,6 +32553,36 @@ var createVoiceObservabilityExportRoutes = (options = {}) => {
 };
 
 // src/productionReadiness.ts
+var buildVoiceReadinessRecoveryActions = (input, options = {}) => {
+  const checks = "checks" in input ? input.checks : input;
+  const includeWarnings = options.includeWarnings ?? true;
+  const sourceChecks = checks.filter((check) => check.status === "fail" || includeWarnings && check.status === "warn");
+  const seen = new Set;
+  const actions = sourceChecks.flatMap((check) => (check.actions ?? []).flatMap((action) => {
+    const method = action.method ?? "GET";
+    const key = `${method}:${action.href}:${check.label}`;
+    if (seen.has(key)) {
+      return [];
+    }
+    seen.add(key);
+    return [
+      {
+        ...action,
+        key,
+        method,
+        sourceCheckDetail: check.detail,
+        sourceCheckHref: check.href,
+        sourceCheckLabel: check.label,
+        sourceStatus: check.status
+      }
+    ];
+  }));
+  return {
+    actions,
+    generatedAt: (options.now ?? (() => new Date))().toISOString(),
+    sourceChecks: sourceChecks.length
+  };
+};
 var escapeHtml52 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var formatVoiceProofFreshnessDuration = (valueMs) => {
   if (valueMs < 1000) {
@@ -39274,11 +39392,13 @@ export {
   buildVoiceRealtimeProviderContractMatrix,
   buildVoiceRealtimeChannelRuntimeSamplesFromTrace,
   buildVoiceRealtimeChannelReport,
+  buildVoiceRealCallProfileRecoveryJobHistoryCheck,
   buildVoiceRealCallProfileRecoveryActions,
   buildVoiceRealCallProfileReadinessCheck,
   buildVoiceRealCallProfileHistoryReport,
   buildVoiceRealCallProfileEvidenceFromTraceEvents,
   buildVoiceRealCallProfileDefaults,
+  buildVoiceReadinessRecoveryActions,
   buildVoiceProviderSloReport,
   buildVoiceProviderOrchestrationReport,
   buildVoiceProviderDecisionTraceReport,

package/dist/productionReadiness.d.ts

@@ -56,6 +56,22 @@ export type VoiceProductionReadinessCheck = {
     status: VoiceProductionReadinessStatus;
     value?: number | string;
 };
+export type VoiceReadinessRecoveryAction = VoiceProductionReadinessAction & {
+    key: string;
+    sourceCheckDetail?: string;
+    sourceCheckHref?: string;
+    sourceCheckLabel: string;
+    sourceStatus: Exclude<VoiceProductionReadinessStatus, 'pass'>;
+};
+export type VoiceReadinessRecoveryActionPlan = {
+    actions: VoiceReadinessRecoveryAction[];
+    generatedAt: string;
+    sourceChecks: number;
+};
+export type VoiceReadinessRecoveryActionOptions = {
+    includeWarnings?: boolean;
+    now?: () => Date;
+};
 export type VoiceProductionReadinessGateIssue = {
     code: string;
     detail?: string;
@@ -67,6 +83,7 @@ export type VoiceProductionReadinessGateIssue = {
 export type VoiceProductionReadinessGateOptions = {
     failOnWarnings?: boolean;
 };
+export declare const buildVoiceReadinessRecoveryActions: (input: VoiceProductionReadinessReport | readonly VoiceProductionReadinessCheck[], options?: VoiceReadinessRecoveryActionOptions) => VoiceReadinessRecoveryActionPlan;
 export type VoiceProductionReadinessGateReport = {
     checkedAt: number;
     failures: VoiceProductionReadinessGateIssue[];

package/dist/proofTrends.d.ts

@@ -378,6 +378,15 @@ export type VoiceRealCallProfileReadinessCheckOptions = {
     sourceHref?: string;
 };
 export type VoiceRealCallProfileRecoveryActionOptions = VoiceRealCallProfileReadinessCheckOptions;
+export type VoiceRealCallProfileRecoveryJobHistoryCheckOptions = {
+    allowFailedJobs?: boolean;
+    failOnRunningJobs?: boolean;
+    href?: string;
+    label?: string;
+    maxAgeMs?: number;
+    minCompletedJobs?: number;
+    sourceHref?: string;
+};
 export type VoiceRealCallProfileRecoveryActionHandlerInput = {
     actionId: VoiceRealCallProfileRecoveryActionId;
     report: VoiceRealCallProfileHistoryReport;
@@ -478,6 +487,7 @@ export declare const createVoiceInMemoryRealCallProfileRecoveryJobStore: (option
 }) => VoiceRealCallProfileRecoveryJobStore;
 export declare const createVoiceSQLiteRealCallProfileRecoveryJobStore: (options?: VoiceSQLiteRealCallProfileRecoveryJobStoreOptions) => VoiceRealCallProfileRecoveryJobStore;
 export declare const buildVoiceRealCallProfileReadinessCheck: (report: VoiceRealCallProfileHistoryReport, options?: VoiceRealCallProfileReadinessCheckOptions) => VoiceProductionReadinessCheck;
+export declare const buildVoiceRealCallProfileRecoveryJobHistoryCheck: (store: Pick<VoiceRealCallProfileRecoveryJobStore, "list"> | undefined, options?: VoiceRealCallProfileRecoveryJobHistoryCheckOptions) => Promise<VoiceProductionReadinessCheck>;
 export declare const resolveVoiceRealCallProfileProviderRoute: <TProvider extends string = string>(options: VoiceRealCallProfileProviderRouteOptions<TProvider>) => TProvider | undefined;
 export declare const buildVoiceRealCallProfileHistoryReport: (options?: VoiceRealCallProfileHistoryOptions) => VoiceRealCallProfileHistoryReport;
 export declare const evaluateVoiceProofTrendEvidence: (report: VoiceProofTrendReport, input?: VoiceProofTrendAssertionInput) => VoiceProofTrendAssertionReport;

package/dist/react/index.js

@@ -2347,6 +2347,94 @@ var buildVoiceRealCallProfileReadinessCheck = (report, options = {}) => {
     value: `${String(report.defaults.summary.actionableProfiles)}/${String(report.summary.profileCount)} actionable`
   };
 };
+var buildVoiceRealCallProfileRecoveryJobHistoryCheck = async (store, options = {}) => {
+  const href = options.href ?? "/voice/real-call-profile-recovery";
+  const sourceHref = options.sourceHref ?? "/api/voice/real-call-profile-history/actions/jobs";
+  const minCompletedJobs = options.minCompletedJobs ?? 1;
+  const label = options.label ?? "Real-call recovery job history";
+  if (!store?.list) {
+    return {
+      actions: [
+        {
+          description: "Configure a recovery job store with list support so operators can inspect proof repair history.",
+          href,
+          label: "Configure recovery job history"
+        }
+      ],
+      detail: "No real-call profile recovery job store with list support is configured.",
+      gateExplanation: {
+        evidenceHref: sourceHref,
+        observed: "missing",
+        remediation: "Use the bundled memory or SQLite recovery job store, or implement list() on the custom store.",
+        sourceHref,
+        threshold: "list support",
+        thresholdLabel: "Inspectable recovery jobs",
+        unit: "status"
+      },
+      href,
+      label,
+      status: "fail",
+      value: "missing"
+    };
+  }
+  const jobs = await store.list({ limit: 50 });
+  const now = Date.now();
+  const recentJobs = options.maxAgeMs === undefined ? jobs : jobs.filter((job) => now - Date.parse(job.updatedAt) <= options.maxAgeMs);
+  const completedJobs = recentJobs.filter((job) => job.status === "pass" || job.status === "fail");
+  const failedJobs = recentJobs.filter((job) => job.status === "fail");
+  const runningJobs = recentJobs.filter((job) => job.status === "queued" || job.status === "running");
+  const issues = [];
+  const warnings = [];
+  if (completedJobs.length < minCompletedJobs) {
+    issues.push(`Expected at least ${String(minCompletedJobs)} completed recovery job(s), found ${String(completedJobs.length)}.`);
+  }
+  if (!options.allowFailedJobs && failedJobs.length > 0) {
+    issues.push(`${String(failedJobs.length)} recent recovery job(s) failed.`);
+  }
+  if (runningJobs.length > 0) {
+    const message = `${String(runningJobs.length)} recovery job(s) are still queued or running.`;
+    if (options.failOnRunningJobs) {
+      issues.push(message);
+    } else {
+      warnings.push(message);
+    }
+  }
+  const status = issues.length > 0 ? "fail" : warnings.length > 0 ? "warn" : "pass";
+  const detail = status === "pass" ? `${String(completedJobs.length)} completed recovery job(s), ${String(failedJobs.length)} failed, ${String(runningJobs.length)} running.` : [...issues, ...warnings].join(" ");
+  return {
+    actions: [
+      {
+        description: "Open the recovery job UI and run or inspect proof repair jobs.",
+        href,
+        label: "Open recovery job history"
+      },
+      {
+        description: "Open the recovery job history API.",
+        href: sourceHref,
+        label: "Open recovery jobs API"
+      }
+    ],
+    detail,
+    gateExplanation: {
+      evidenceHref: sourceHref,
+      observed: completedJobs.length,
+      remediation: "Run a browser or phone recovery proof job and ensure recent recovery jobs complete without failure.",
+      sourceHref,
+      threshold: minCompletedJobs,
+      thresholdLabel: "Minimum completed recovery jobs",
+      unit: "count"
+    },
+    href,
+    label,
+    proofSource: {
+      href: sourceHref,
+      source: "recovery-job-store",
+      sourceLabel: "Real-call recovery jobs"
+    },
+    status,
+    value: `${String(completedJobs.length)} completed / ${String(failedJobs.length)} failed / ${String(runningJobs.length)} running`
+  };
+};
 var resolveVoiceRealCallProfileProviderRoute = (options) => {
   const defaults = readRealCallProfileDefaultsReport(options.defaults);
   const profile = defaults.profiles.find((item) => item.profileId === options.profileId) ?? defaults.profiles.find((item) => item.status === "pass") ?? defaults.profiles[0];

package/dist/vue/index.js

@@ -2268,6 +2268,94 @@ var buildVoiceRealCallProfileReadinessCheck = (report, options = {}) => {
     value: `${String(report.defaults.summary.actionableProfiles)}/${String(report.summary.profileCount)} actionable`
   };
 };
+var buildVoiceRealCallProfileRecoveryJobHistoryCheck = async (store, options = {}) => {
+  const href = options.href ?? "/voice/real-call-profile-recovery";
+  const sourceHref = options.sourceHref ?? "/api/voice/real-call-profile-history/actions/jobs";
+  const minCompletedJobs = options.minCompletedJobs ?? 1;
+  const label = options.label ?? "Real-call recovery job history";
+  if (!store?.list) {
+    return {
+      actions: [
+        {
+          description: "Configure a recovery job store with list support so operators can inspect proof repair history.",
+          href,
+          label: "Configure recovery job history"
+        }
+      ],
+      detail: "No real-call profile recovery job store with list support is configured.",
+      gateExplanation: {
+        evidenceHref: sourceHref,
+        observed: "missing",
+        remediation: "Use the bundled memory or SQLite recovery job store, or implement list() on the custom store.",
+        sourceHref,
+        threshold: "list support",
+        thresholdLabel: "Inspectable recovery jobs",
+        unit: "status"
+      },
+      href,
+      label,
+      status: "fail",
+      value: "missing"
+    };
+  }
+  const jobs = await store.list({ limit: 50 });
+  const now = Date.now();
+  const recentJobs = options.maxAgeMs === undefined ? jobs : jobs.filter((job) => now - Date.parse(job.updatedAt) <= options.maxAgeMs);
+  const completedJobs = recentJobs.filter((job) => job.status === "pass" || job.status === "fail");
+  const failedJobs = recentJobs.filter((job) => job.status === "fail");
+  const runningJobs = recentJobs.filter((job) => job.status === "queued" || job.status === "running");
+  const issues = [];
+  const warnings = [];
+  if (completedJobs.length < minCompletedJobs) {
+    issues.push(`Expected at least ${String(minCompletedJobs)} completed recovery job(s), found ${String(completedJobs.length)}.`);
+  }
+  if (!options.allowFailedJobs && failedJobs.length > 0) {
+    issues.push(`${String(failedJobs.length)} recent recovery job(s) failed.`);
+  }
+  if (runningJobs.length > 0) {
+    const message = `${String(runningJobs.length)} recovery job(s) are still queued or running.`;
+    if (options.failOnRunningJobs) {
+      issues.push(message);
+    } else {
+      warnings.push(message);
+    }
+  }
+  const status = issues.length > 0 ? "fail" : warnings.length > 0 ? "warn" : "pass";
+  const detail = status === "pass" ? `${String(completedJobs.length)} completed recovery job(s), ${String(failedJobs.length)} failed, ${String(runningJobs.length)} running.` : [...issues, ...warnings].join(" ");
+  return {
+    actions: [
+      {
+        description: "Open the recovery job UI and run or inspect proof repair jobs.",
+        href,
+        label: "Open recovery job history"
+      },
+      {
+        description: "Open the recovery job history API.",
+        href: sourceHref,
+        label: "Open recovery jobs API"
+      }
+    ],
+    detail,
+    gateExplanation: {
+      evidenceHref: sourceHref,
+      observed: completedJobs.length,
+      remediation: "Run a browser or phone recovery proof job and ensure recent recovery jobs complete without failure.",
+      sourceHref,
+      threshold: minCompletedJobs,
+      thresholdLabel: "Minimum completed recovery jobs",
+      unit: "count"
+    },
+    href,
+    label,
+    proofSource: {
+      href: sourceHref,
+      source: "recovery-job-store",
+      sourceLabel: "Real-call recovery jobs"
+    },
+    status,
+    value: `${String(completedJobs.length)} completed / ${String(failedJobs.length)} failed / ${String(runningJobs.length)} running`
+  };
+};
 var resolveVoiceRealCallProfileProviderRoute = (options) => {
   const defaults = readRealCallProfileDefaultsReport(options.defaults);
   const profile = defaults.profiles.find((item) => item.profileId === options.profileId) ?? defaults.profiles.find((item) => item.status === "pass") ?? defaults.profiles[0];

package/package.json

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