@absolutejs/voice 0.0.22-beta.377 → 0.0.22-beta.379

package/README.md

@@ -1555,6 +1555,12 @@ additionalChecks: async () => [
 ];
 ```
 
+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

@@ -4237,6 +4237,68 @@ var buildVoiceRealCallProfileEvidenceFromTraceEvents = (events, options = {}) =>
   }).filter((evidence) => evidence !== undefined);
 };
 var loadVoiceRealCallProfileEvidenceFromTraceStore = async (options) => buildVoiceRealCallProfileEvidenceFromTraceEvents(await options.store.list({ limit: options.limit ?? 5000 }), options);
+var realCallProfileTraceSignalTypes = new Set([
+  "client.barge_in",
+  "client.browser_media",
+  "client.live_latency",
+  "client.telephony_media",
+  "provider.decision",
+  "session.error",
+  "turn_latency.stage"
+]);
+var hasTraceProfileMetadata = (event, options) => Boolean(readTraceProfileId([event], options));
+var mergeRealCallProfileCollectorOptions = (base, override = {}) => ({
+  defaultProfileId: override.defaultProfileId ?? base.defaultProfileId,
+  defaultProfileLabel: override.defaultProfileLabel ?? base.defaultProfileLabel,
+  limit: override.limit ?? base.limit,
+  maxProviderP95Ms: override.maxProviderP95Ms ?? base.maxProviderP95Ms,
+  profileDescriptions: {
+    ...base.profileDescriptions ?? {},
+    ...override.profileDescriptions ?? {}
+  },
+  profileLabels: {
+    ...base.profileLabels ?? {},
+    ...override.profileLabels ?? {}
+  },
+  sessionIds: override.sessionIds ?? base.sessionIds
+});
+var createVoiceRealCallProfileTraceCollector = (options) => {
+  const capturedSessionIds = new Set(options.sessionIds ?? []);
+  const capture = (event) => {
+    if (realCallProfileTraceSignalTypes.has(event.type) && hasTraceProfileMetadata(event, options)) {
+      capturedSessionIds.add(event.sessionId);
+    }
+  };
+  return {
+    append: async (event) => {
+      const stored = await options.store.append(event);
+      capture(stored);
+      return stored;
+    },
+    buildHistoryReport: async (historyOptions = {}) => {
+      const evidence = await buildRealCallProfileCollectorEvidence(options, capturedSessionIds, historyOptions.evidenceOptions);
+      return buildVoiceRealCallProfileHistoryReport({
+        ...historyOptions,
+        evidence
+      });
+    },
+    get: (id) => options.store.get(id),
+    list: (filter) => options.store.list(filter),
+    listCapturedSessionIds: () => [...capturedSessionIds],
+    listEvidence: (evidenceOptions) => buildRealCallProfileCollectorEvidence(options, capturedSessionIds, evidenceOptions),
+    remove: async (id) => {
+      await options.store.remove(id);
+    }
+  };
+};
+var buildRealCallProfileCollectorEvidence = async (baseOptions, capturedSessionIds, evidenceOptions) => {
+  const merged = mergeRealCallProfileCollectorOptions(baseOptions, evidenceOptions);
+  const requestedSessionIds = merged.sessionIds ?? [...capturedSessionIds];
+  return buildVoiceRealCallProfileEvidenceFromTraceEvents(await baseOptions.store.list({ limit: merged.limit ?? 5000 }), {
+    ...merged,
+    sessionIds: requestedSessionIds
+  });
+};
 var readProofTrendProviders = (reports) => aggregateProofTrendProviders(reports.flatMap((report) => report.summary.providers && report.summary.providers.length > 0 ? report.summary.providers : report.cycles.flatMap((cycle) => cycle.providers ?? [])));
 var exceedsProofTrendBudget = (value, budget) => value !== undefined && (!Number.isFinite(value) || value > budget);
 var readProofTrendProfileStatus = (profile, budgets) => {

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, 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 { assertVoiceProofTrendEvidence, buildEmptyVoiceProofTrendReport, buildVoiceProofTrendProfileSummaries, buildVoiceProofTrendRecommendationReport, buildVoiceProofTrendReportFromRealCallProfiles, buildVoiceProofTrendReport, buildVoiceRealCallProfileEvidenceFromTraceEvents, buildVoiceRealCallProfileDefaults, buildVoiceRealCallProfileHistoryReport, buildVoiceRealCallProfileReadinessCheck, buildVoiceRealCallProfileRecoveryJobHistoryCheck, buildVoiceRealCallProfileRecoveryActions, createVoiceInMemoryRealCallProfileRecoveryJobStore, createVoiceRealCallProfileTraceCollector, 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, VoiceRealCallProfileRecoveryJobHistoryCheckOptions, 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, VoiceRealCallProfileTraceCollector, VoiceRealCallProfileTraceCollectorEvidenceOptions, VoiceRealCallProfileTraceCollectorOptions, 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

@@ -15706,6 +15706,68 @@ var buildVoiceRealCallProfileEvidenceFromTraceEvents = (events, options = {}) =>
   }).filter((evidence) => evidence !== undefined);
 };
 var loadVoiceRealCallProfileEvidenceFromTraceStore = async (options) => buildVoiceRealCallProfileEvidenceFromTraceEvents(await options.store.list({ limit: options.limit ?? 5000 }), options);
+var realCallProfileTraceSignalTypes = new Set([
+  "client.barge_in",
+  "client.browser_media",
+  "client.live_latency",
+  "client.telephony_media",
+  "provider.decision",
+  "session.error",
+  "turn_latency.stage"
+]);
+var hasTraceProfileMetadata = (event, options) => Boolean(readTraceProfileId([event], options));
+var mergeRealCallProfileCollectorOptions = (base, override = {}) => ({
+  defaultProfileId: override.defaultProfileId ?? base.defaultProfileId,
+  defaultProfileLabel: override.defaultProfileLabel ?? base.defaultProfileLabel,
+  limit: override.limit ?? base.limit,
+  maxProviderP95Ms: override.maxProviderP95Ms ?? base.maxProviderP95Ms,
+  profileDescriptions: {
+    ...base.profileDescriptions ?? {},
+    ...override.profileDescriptions ?? {}
+  },
+  profileLabels: {
+    ...base.profileLabels ?? {},
+    ...override.profileLabels ?? {}
+  },
+  sessionIds: override.sessionIds ?? base.sessionIds
+});
+var createVoiceRealCallProfileTraceCollector = (options) => {
+  const capturedSessionIds = new Set(options.sessionIds ?? []);
+  const capture = (event) => {
+    if (realCallProfileTraceSignalTypes.has(event.type) && hasTraceProfileMetadata(event, options)) {
+      capturedSessionIds.add(event.sessionId);
+    }
+  };
+  return {
+    append: async (event) => {
+      const stored = await options.store.append(event);
+      capture(stored);
+      return stored;
+    },
+    buildHistoryReport: async (historyOptions = {}) => {
+      const evidence = await buildRealCallProfileCollectorEvidence(options, capturedSessionIds, historyOptions.evidenceOptions);
+      return buildVoiceRealCallProfileHistoryReport({
+        ...historyOptions,
+        evidence
+      });
+    },
+    get: (id) => options.store.get(id),
+    list: (filter) => options.store.list(filter),
+    listCapturedSessionIds: () => [...capturedSessionIds],
+    listEvidence: (evidenceOptions) => buildRealCallProfileCollectorEvidence(options, capturedSessionIds, evidenceOptions),
+    remove: async (id) => {
+      await options.store.remove(id);
+    }
+  };
+};
+var buildRealCallProfileCollectorEvidence = async (baseOptions, capturedSessionIds, evidenceOptions) => {
+  const merged = mergeRealCallProfileCollectorOptions(baseOptions, evidenceOptions);
+  const requestedSessionIds = merged.sessionIds ?? [...capturedSessionIds];
+  return buildVoiceRealCallProfileEvidenceFromTraceEvents(await baseOptions.store.list({ limit: merged.limit ?? 5000 }), {
+    ...merged,
+    sessionIds: requestedSessionIds
+  });
+};
 var readProofTrendProviders = (reports) => aggregateProofTrendProviders(reports.flatMap((report) => report.summary.providers && report.summary.providers.length > 0 ? report.summary.providers : report.cycles.flatMap((cycle) => cycle.providers ?? [])));
 var exceedsProofTrendBudget = (value, budget) => value !== undefined && (!Number.isFinite(value) || value > budget);
 var readProofTrendProfileStatus = (profile, budgets) => {
@@ -32553,6 +32615,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) {
@@ -39144,6 +39236,7 @@ export {
   createVoiceRealtimeProviderContractRoutes,
   createVoiceRealtimeProviderContractMatrixPreset,
   createVoiceRealtimeChannelRoutes,
+  createVoiceRealCallProfileTraceCollector,
   createVoiceRealCallProfileRecoveryActionRoutes,
   createVoiceRealCallProfileHistoryRoutes,
   createVoiceReadinessProfile,
@@ -39368,6 +39461,7 @@ export {
   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

@@ -149,6 +149,19 @@ export type VoiceRealCallProfileTraceStoreEvidenceOptions = VoiceRealCallProfile
     limit?: number;
     store: VoiceTraceEventStore;
 };
+export type VoiceRealCallProfileTraceCollectorEvidenceOptions = VoiceRealCallProfileTraceEvidenceOptions & {
+    limit?: number;
+};
+export type VoiceRealCallProfileTraceCollectorOptions<TEvent extends StoredVoiceTraceEvent = StoredVoiceTraceEvent> = VoiceRealCallProfileTraceCollectorEvidenceOptions & {
+    store: VoiceTraceEventStore<TEvent>;
+};
+export type VoiceRealCallProfileTraceCollector<TEvent extends StoredVoiceTraceEvent = StoredVoiceTraceEvent> = VoiceTraceEventStore<TEvent> & {
+    buildHistoryReport: (options?: Omit<VoiceRealCallProfileHistoryOptions, 'evidence'> & {
+        evidenceOptions?: VoiceRealCallProfileTraceCollectorEvidenceOptions;
+    }) => Promise<VoiceRealCallProfileHistoryReport>;
+    listCapturedSessionIds: () => string[];
+    listEvidence: (options?: VoiceRealCallProfileTraceCollectorEvidenceOptions) => Promise<VoiceProofTrendRealCallProfileEvidence[]>;
+};
 export type VoiceProofTrendRealCallProfileReportOptions = VoiceProofTrendProfileSummaryOptions & {
     baseUrl?: string;
     evidence: readonly VoiceProofTrendRealCallProfileEvidence[];
@@ -477,6 +490,7 @@ export declare const readVoiceProofTrendReportFile: (path: string, options?: {
 }) => Promise<VoiceProofTrendReport>;
 export declare const buildVoiceRealCallProfileEvidenceFromTraceEvents: (events: readonly StoredVoiceTraceEvent[], options?: VoiceRealCallProfileTraceEvidenceOptions) => VoiceProofTrendRealCallProfileEvidence[];
 export declare const loadVoiceRealCallProfileEvidenceFromTraceStore: (options: VoiceRealCallProfileTraceStoreEvidenceOptions) => Promise<VoiceProofTrendRealCallProfileEvidence[]>;
+export declare const createVoiceRealCallProfileTraceCollector: <TEvent extends StoredVoiceTraceEvent = StoredVoiceTraceEvent>(options: VoiceRealCallProfileTraceCollectorOptions<TEvent>) => VoiceRealCallProfileTraceCollector<TEvent>;
 export declare const buildVoiceProofTrendProfileSummaries: (input: VoiceProofTrendReport | readonly VoiceProofTrendReport[], options?: VoiceProofTrendProfileSummaryOptions) => VoiceProofTrendProfileSummary[];
 export declare const buildVoiceProofTrendReportFromRealCallProfiles: (options: VoiceProofTrendRealCallProfileReportOptions) => VoiceProofTrendReport;
 export declare const buildVoiceRealCallProfileDefaults: (input: VoiceRealCallProfileHistoryReport | VoiceProofTrendReport, options?: VoiceRealCallProfileDefaultsOptions) => VoiceRealCallProfileDefaultsReport;

package/dist/react/index.js

@@ -1824,6 +1824,68 @@ var buildVoiceRealCallProfileEvidenceFromTraceEvents = (events, options = {}) =>
   }).filter((evidence) => evidence !== undefined);
 };
 var loadVoiceRealCallProfileEvidenceFromTraceStore = async (options) => buildVoiceRealCallProfileEvidenceFromTraceEvents(await options.store.list({ limit: options.limit ?? 5000 }), options);
+var realCallProfileTraceSignalTypes = new Set([
+  "client.barge_in",
+  "client.browser_media",
+  "client.live_latency",
+  "client.telephony_media",
+  "provider.decision",
+  "session.error",
+  "turn_latency.stage"
+]);
+var hasTraceProfileMetadata = (event, options) => Boolean(readTraceProfileId([event], options));
+var mergeRealCallProfileCollectorOptions = (base, override = {}) => ({
+  defaultProfileId: override.defaultProfileId ?? base.defaultProfileId,
+  defaultProfileLabel: override.defaultProfileLabel ?? base.defaultProfileLabel,
+  limit: override.limit ?? base.limit,
+  maxProviderP95Ms: override.maxProviderP95Ms ?? base.maxProviderP95Ms,
+  profileDescriptions: {
+    ...base.profileDescriptions ?? {},
+    ...override.profileDescriptions ?? {}
+  },
+  profileLabels: {
+    ...base.profileLabels ?? {},
+    ...override.profileLabels ?? {}
+  },
+  sessionIds: override.sessionIds ?? base.sessionIds
+});
+var createVoiceRealCallProfileTraceCollector = (options) => {
+  const capturedSessionIds = new Set(options.sessionIds ?? []);
+  const capture = (event) => {
+    if (realCallProfileTraceSignalTypes.has(event.type) && hasTraceProfileMetadata(event, options)) {
+      capturedSessionIds.add(event.sessionId);
+    }
+  };
+  return {
+    append: async (event) => {
+      const stored = await options.store.append(event);
+      capture(stored);
+      return stored;
+    },
+    buildHistoryReport: async (historyOptions = {}) => {
+      const evidence = await buildRealCallProfileCollectorEvidence(options, capturedSessionIds, historyOptions.evidenceOptions);
+      return buildVoiceRealCallProfileHistoryReport({
+        ...historyOptions,
+        evidence
+      });
+    },
+    get: (id) => options.store.get(id),
+    list: (filter) => options.store.list(filter),
+    listCapturedSessionIds: () => [...capturedSessionIds],
+    listEvidence: (evidenceOptions) => buildRealCallProfileCollectorEvidence(options, capturedSessionIds, evidenceOptions),
+    remove: async (id) => {
+      await options.store.remove(id);
+    }
+  };
+};
+var buildRealCallProfileCollectorEvidence = async (baseOptions, capturedSessionIds, evidenceOptions) => {
+  const merged = mergeRealCallProfileCollectorOptions(baseOptions, evidenceOptions);
+  const requestedSessionIds = merged.sessionIds ?? [...capturedSessionIds];
+  return buildVoiceRealCallProfileEvidenceFromTraceEvents(await baseOptions.store.list({ limit: merged.limit ?? 5000 }), {
+    ...merged,
+    sessionIds: requestedSessionIds
+  });
+};
 var readProofTrendProviders = (reports) => aggregateProofTrendProviders(reports.flatMap((report) => report.summary.providers && report.summary.providers.length > 0 ? report.summary.providers : report.cycles.flatMap((cycle) => cycle.providers ?? [])));
 var exceedsProofTrendBudget = (value, budget) => value !== undefined && (!Number.isFinite(value) || value > budget);
 var readProofTrendProfileStatus = (profile, budgets) => {

package/dist/vue/index.js

@@ -1745,6 +1745,68 @@ var buildVoiceRealCallProfileEvidenceFromTraceEvents = (events, options = {}) =>
   }).filter((evidence) => evidence !== undefined);
 };
 var loadVoiceRealCallProfileEvidenceFromTraceStore = async (options) => buildVoiceRealCallProfileEvidenceFromTraceEvents(await options.store.list({ limit: options.limit ?? 5000 }), options);
+var realCallProfileTraceSignalTypes = new Set([
+  "client.barge_in",
+  "client.browser_media",
+  "client.live_latency",
+  "client.telephony_media",
+  "provider.decision",
+  "session.error",
+  "turn_latency.stage"
+]);
+var hasTraceProfileMetadata = (event, options) => Boolean(readTraceProfileId([event], options));
+var mergeRealCallProfileCollectorOptions = (base, override = {}) => ({
+  defaultProfileId: override.defaultProfileId ?? base.defaultProfileId,
+  defaultProfileLabel: override.defaultProfileLabel ?? base.defaultProfileLabel,
+  limit: override.limit ?? base.limit,
+  maxProviderP95Ms: override.maxProviderP95Ms ?? base.maxProviderP95Ms,
+  profileDescriptions: {
+    ...base.profileDescriptions ?? {},
+    ...override.profileDescriptions ?? {}
+  },
+  profileLabels: {
+    ...base.profileLabels ?? {},
+    ...override.profileLabels ?? {}
+  },
+  sessionIds: override.sessionIds ?? base.sessionIds
+});
+var createVoiceRealCallProfileTraceCollector = (options) => {
+  const capturedSessionIds = new Set(options.sessionIds ?? []);
+  const capture = (event) => {
+    if (realCallProfileTraceSignalTypes.has(event.type) && hasTraceProfileMetadata(event, options)) {
+      capturedSessionIds.add(event.sessionId);
+    }
+  };
+  return {
+    append: async (event) => {
+      const stored = await options.store.append(event);
+      capture(stored);
+      return stored;
+    },
+    buildHistoryReport: async (historyOptions = {}) => {
+      const evidence = await buildRealCallProfileCollectorEvidence(options, capturedSessionIds, historyOptions.evidenceOptions);
+      return buildVoiceRealCallProfileHistoryReport({
+        ...historyOptions,
+        evidence
+      });
+    },
+    get: (id) => options.store.get(id),
+    list: (filter) => options.store.list(filter),
+    listCapturedSessionIds: () => [...capturedSessionIds],
+    listEvidence: (evidenceOptions) => buildRealCallProfileCollectorEvidence(options, capturedSessionIds, evidenceOptions),
+    remove: async (id) => {
+      await options.store.remove(id);
+    }
+  };
+};
+var buildRealCallProfileCollectorEvidence = async (baseOptions, capturedSessionIds, evidenceOptions) => {
+  const merged = mergeRealCallProfileCollectorOptions(baseOptions, evidenceOptions);
+  const requestedSessionIds = merged.sessionIds ?? [...capturedSessionIds];
+  return buildVoiceRealCallProfileEvidenceFromTraceEvents(await baseOptions.store.list({ limit: merged.limit ?? 5000 }), {
+    ...merged,
+    sessionIds: requestedSessionIds
+  });
+};
 var readProofTrendProviders = (reports) => aggregateProofTrendProviders(reports.flatMap((report) => report.summary.providers && report.summary.providers.length > 0 ? report.summary.providers : report.cycles.flatMap((cycle) => cycle.providers ?? [])));
 var exceedsProofTrendBudget = (value, budget) => value !== undefined && (!Number.isFinite(value) || value > budget);
 var readProofTrendProfileStatus = (profile, budgets) => {

package/package.json

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