@absolutejs/voice 0.0.22-beta.370 → 0.0.22-beta.371

package/README.md

@@ -1502,6 +1502,8 @@ createVoiceProductionReadinessRoutes({
 });
 ```
 
+The readiness check includes recovery actions from `buildVoiceRealCallProfileRecoveryActions(...)`, so failed gates can point operators at the profile history report, browser/phone proof, missing provider-role evidence, operations records, and production-readiness refresh instead of only saying "failed."
+
 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

@@ -4555,11 +4555,77 @@ var buildRealCallProfileReadinessIssues = (report, options) => {
   }
   return { issues, warnings };
 };
+var uniqueRealCallProfileActions = (actions) => {
+  const seen = new Set;
+  return actions.filter((action) => {
+    const key = `${action.method ?? "GET"}:${action.href}:${action.label}`;
+    if (seen.has(key)) {
+      return false;
+    }
+    seen.add(key);
+    return true;
+  });
+};
+var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
+  const actions = [
+    {
+      description: "Open the current real-call profile history report and profile defaults.",
+      href: options.href ?? "/voice/real-call-profile-history",
+      label: "Open real-call profile history"
+    },
+    {
+      description: "Refresh production readiness after collecting or replaying profile evidence.",
+      href: options.productionReadinessHref ?? "/production-readiness",
+      label: "Refresh production readiness"
+    }
+  ];
+  const requiredProfiles = new Set(options.requiredProfileIds ?? []);
+  const profilesById = new Map(report.defaults.profiles.map((profile) => [profile.profileId, profile]));
+  const missingProfiles = [...requiredProfiles].filter((profileId) => !profilesById.has(profileId));
+  const warningProfiles = report.defaults.profiles.filter((profile) => (requiredProfiles.size === 0 || requiredProfiles.has(profile.profileId)) && profile.status !== "pass");
+  const missingRoleProfiles = report.defaults.profiles.filter((profile) => (options.requiredProviderRoles ?? []).some((role) => !profile.providerRoutes[role]));
+  const ageMs = report.trend.ageMs ?? (report.generatedAt ? Date.now() - new Date(report.generatedAt).getTime() : undefined);
+  if (missingProfiles.length > 0 || warningProfiles.length > 0 || missingRoleProfiles.length > 0 || options.minCycles !== undefined && (report.summary.cycles ?? 0) < options.minCycles || options.minActionableProfiles !== undefined && report.defaults.summary.actionableProfiles < options.minActionableProfiles) {
+    actions.push({
+      description: "Run browser profile proof to collect microphone, WebSocket, live-latency, and provider traces for missing profiles.",
+      href: options.browserProofHref ?? "/voice/browser-call-profiles",
+      label: "Run browser profile proof"
+    });
+    actions.push({
+      description: "Run phone profile proof when required profiles depend on carrier, telephony media, or noisy-call evidence.",
+      href: options.phoneProofHref ?? "/api/voice/phone/smoke",
+      label: "Run phone profile proof"
+    });
+  }
+  if (options.maxAgeMs !== undefined && (ageMs === undefined || ageMs > options.maxAgeMs)) {
+    actions.push({
+      description: "Collect fresh real-call profile traces because the current history artifact is stale.",
+      href: options.browserProofHref ?? "/voice/browser-call-profiles",
+      label: "Collect fresh profile evidence"
+    });
+  }
+  if (missingRoleProfiles.length > 0 || report.defaults.summary.actionableProfiles < (options.minActionableProfiles ?? 1)) {
+    actions.push({
+      description: "Collect missing LLM/STT/TTS provider-role evidence so profile defaults can become actionable.",
+      href: options.sourceHref ?? "/api/voice/real-call-profile-history",
+      label: "Collect missing provider-role evidence"
+    });
+  }
+  if (report.recommendations.profiles.some((profile) => profile.status !== "pass") || report.defaults.profiles.some((profile) => profile.status !== "pass")) {
+    actions.push({
+      description: "Open operations records to inspect the sessions behind failing or warning profile evidence.",
+      href: options.operationsRecordsHref ?? "/voice-operations",
+      label: "Open operations records"
+    });
+  }
+  return uniqueRealCallProfileActions(actions);
+};
 var buildVoiceRealCallProfileReadinessCheck = (report, options = {}) => {
   const { issues, warnings } = buildRealCallProfileReadinessIssues(report, options);
   const status = issues.length > 0 ? "fail" : warnings.length > 0 && options.failOnWarnings === true ? "fail" : warnings.length > 0 ? "warn" : "pass";
   const detail = status === "pass" ? `${String(report.summary.profileCount)} profile(s), ${String(report.summary.cycles ?? 0)} cycle(s), ${String(report.defaults.summary.actionableProfiles)} actionable default(s).` : [...issues, ...warnings].join(" ");
   return {
+    actions: buildVoiceRealCallProfileRecoveryActions(report, options),
     detail,
     gateExplanation: {
       evidenceHref: options.href ?? "/api/voice/real-call-profile-history",

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, createVoiceProofTrendRecommendationRoutes, createVoiceProofTrendRoutes, createVoiceRealCallProfileHistoryRoutes, 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, buildVoiceRealCallProfileRecoveryActions, createVoiceProofTrendRecommendationRoutes, createVoiceProofTrendRoutes, createVoiceRealCallProfileHistoryRoutes, 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, 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, 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';

package/dist/index.js

@@ -16024,11 +16024,77 @@ var buildRealCallProfileReadinessIssues = (report, options) => {
   }
   return { issues, warnings };
 };
+var uniqueRealCallProfileActions = (actions) => {
+  const seen = new Set;
+  return actions.filter((action) => {
+    const key = `${action.method ?? "GET"}:${action.href}:${action.label}`;
+    if (seen.has(key)) {
+      return false;
+    }
+    seen.add(key);
+    return true;
+  });
+};
+var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
+  const actions = [
+    {
+      description: "Open the current real-call profile history report and profile defaults.",
+      href: options.href ?? "/voice/real-call-profile-history",
+      label: "Open real-call profile history"
+    },
+    {
+      description: "Refresh production readiness after collecting or replaying profile evidence.",
+      href: options.productionReadinessHref ?? "/production-readiness",
+      label: "Refresh production readiness"
+    }
+  ];
+  const requiredProfiles = new Set(options.requiredProfileIds ?? []);
+  const profilesById = new Map(report.defaults.profiles.map((profile) => [profile.profileId, profile]));
+  const missingProfiles = [...requiredProfiles].filter((profileId) => !profilesById.has(profileId));
+  const warningProfiles = report.defaults.profiles.filter((profile) => (requiredProfiles.size === 0 || requiredProfiles.has(profile.profileId)) && profile.status !== "pass");
+  const missingRoleProfiles = report.defaults.profiles.filter((profile) => (options.requiredProviderRoles ?? []).some((role) => !profile.providerRoutes[role]));
+  const ageMs = report.trend.ageMs ?? (report.generatedAt ? Date.now() - new Date(report.generatedAt).getTime() : undefined);
+  if (missingProfiles.length > 0 || warningProfiles.length > 0 || missingRoleProfiles.length > 0 || options.minCycles !== undefined && (report.summary.cycles ?? 0) < options.minCycles || options.minActionableProfiles !== undefined && report.defaults.summary.actionableProfiles < options.minActionableProfiles) {
+    actions.push({
+      description: "Run browser profile proof to collect microphone, WebSocket, live-latency, and provider traces for missing profiles.",
+      href: options.browserProofHref ?? "/voice/browser-call-profiles",
+      label: "Run browser profile proof"
+    });
+    actions.push({
+      description: "Run phone profile proof when required profiles depend on carrier, telephony media, or noisy-call evidence.",
+      href: options.phoneProofHref ?? "/api/voice/phone/smoke",
+      label: "Run phone profile proof"
+    });
+  }
+  if (options.maxAgeMs !== undefined && (ageMs === undefined || ageMs > options.maxAgeMs)) {
+    actions.push({
+      description: "Collect fresh real-call profile traces because the current history artifact is stale.",
+      href: options.browserProofHref ?? "/voice/browser-call-profiles",
+      label: "Collect fresh profile evidence"
+    });
+  }
+  if (missingRoleProfiles.length > 0 || report.defaults.summary.actionableProfiles < (options.minActionableProfiles ?? 1)) {
+    actions.push({
+      description: "Collect missing LLM/STT/TTS provider-role evidence so profile defaults can become actionable.",
+      href: options.sourceHref ?? "/api/voice/real-call-profile-history",
+      label: "Collect missing provider-role evidence"
+    });
+  }
+  if (report.recommendations.profiles.some((profile) => profile.status !== "pass") || report.defaults.profiles.some((profile) => profile.status !== "pass")) {
+    actions.push({
+      description: "Open operations records to inspect the sessions behind failing or warning profile evidence.",
+      href: options.operationsRecordsHref ?? "/voice-operations",
+      label: "Open operations records"
+    });
+  }
+  return uniqueRealCallProfileActions(actions);
+};
 var buildVoiceRealCallProfileReadinessCheck = (report, options = {}) => {
   const { issues, warnings } = buildRealCallProfileReadinessIssues(report, options);
   const status = issues.length > 0 ? "fail" : warnings.length > 0 && options.failOnWarnings === true ? "fail" : warnings.length > 0 ? "warn" : "pass";
   const detail = status === "pass" ? `${String(report.summary.profileCount)} profile(s), ${String(report.summary.cycles ?? 0)} cycle(s), ${String(report.defaults.summary.actionableProfiles)} actionable default(s).` : [...issues, ...warnings].join(" ");
   return {
+    actions: buildVoiceRealCallProfileRecoveryActions(report, options),
     detail,
     gateExplanation: {
       evidenceHref: options.href ?? "/api/voice/real-call-profile-history",
@@ -38907,6 +38973,7 @@ export {
   buildVoiceRealtimeProviderContractMatrix,
   buildVoiceRealtimeChannelRuntimeSamplesFromTrace,
   buildVoiceRealtimeChannelReport,
+  buildVoiceRealCallProfileRecoveryActions,
   buildVoiceRealCallProfileReadinessCheck,
   buildVoiceRealCallProfileHistoryReport,
   buildVoiceRealCallProfileEvidenceFromTraceEvents,

package/dist/proofTrends.d.ts

@@ -1,5 +1,5 @@
 import { Elysia } from 'elysia';
-import type { VoiceProductionReadinessCheck } from './productionReadiness';
+import type { VoiceProductionReadinessAction, VoiceProductionReadinessCheck } from './productionReadiness';
 import type { StoredVoiceTraceEvent, VoiceTraceEventStore } from './trace';
 export type VoiceProofTrendStatus = 'empty' | 'fail' | 'pass' | 'stale';
 export type VoiceProofTrendSummary = {
@@ -357,6 +357,7 @@ export type VoiceRealCallProfileHistoryRoutesOptions = Omit<VoiceRealCallProfile
     title?: string;
 };
 export type VoiceRealCallProfileReadinessCheckOptions = {
+    browserProofHref?: string;
     failOnWarnings?: boolean;
     href?: string;
     label?: string;
@@ -366,8 +367,12 @@ export type VoiceRealCallProfileReadinessCheckOptions = {
     minProfiles?: number;
     requiredProfileIds?: readonly string[];
     requiredProviderRoles?: readonly string[];
+    operationsRecordsHref?: string;
+    phoneProofHref?: string;
+    productionReadinessHref?: string;
     sourceHref?: string;
 };
+export type VoiceRealCallProfileRecoveryActionOptions = VoiceRealCallProfileReadinessCheckOptions;
 export declare const DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS: number;
 export declare const DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS: ({
     description: string;
@@ -401,6 +406,7 @@ export declare const loadVoiceRealCallProfileEvidenceFromTraceStore: (options: V
 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;
+export declare const buildVoiceRealCallProfileRecoveryActions: (report: VoiceRealCallProfileHistoryReport, options?: VoiceRealCallProfileRecoveryActionOptions) => VoiceProductionReadinessAction[];
 export declare const buildVoiceRealCallProfileReadinessCheck: (report: VoiceRealCallProfileHistoryReport, options?: VoiceRealCallProfileReadinessCheckOptions) => VoiceProductionReadinessCheck;
 export declare const resolveVoiceRealCallProfileProviderRoute: <TProvider extends string = string>(options: VoiceRealCallProfileProviderRouteOptions<TProvider>) => TProvider | undefined;
 export declare const buildVoiceRealCallProfileHistoryReport: (options?: VoiceRealCallProfileHistoryOptions) => VoiceRealCallProfileHistoryReport;

package/dist/react/index.js

@@ -2142,11 +2142,77 @@ var buildRealCallProfileReadinessIssues = (report, options) => {
   }
   return { issues, warnings };
 };
+var uniqueRealCallProfileActions = (actions) => {
+  const seen = new Set;
+  return actions.filter((action) => {
+    const key = `${action.method ?? "GET"}:${action.href}:${action.label}`;
+    if (seen.has(key)) {
+      return false;
+    }
+    seen.add(key);
+    return true;
+  });
+};
+var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
+  const actions = [
+    {
+      description: "Open the current real-call profile history report and profile defaults.",
+      href: options.href ?? "/voice/real-call-profile-history",
+      label: "Open real-call profile history"
+    },
+    {
+      description: "Refresh production readiness after collecting or replaying profile evidence.",
+      href: options.productionReadinessHref ?? "/production-readiness",
+      label: "Refresh production readiness"
+    }
+  ];
+  const requiredProfiles = new Set(options.requiredProfileIds ?? []);
+  const profilesById = new Map(report.defaults.profiles.map((profile) => [profile.profileId, profile]));
+  const missingProfiles = [...requiredProfiles].filter((profileId) => !profilesById.has(profileId));
+  const warningProfiles = report.defaults.profiles.filter((profile) => (requiredProfiles.size === 0 || requiredProfiles.has(profile.profileId)) && profile.status !== "pass");
+  const missingRoleProfiles = report.defaults.profiles.filter((profile) => (options.requiredProviderRoles ?? []).some((role) => !profile.providerRoutes[role]));
+  const ageMs = report.trend.ageMs ?? (report.generatedAt ? Date.now() - new Date(report.generatedAt).getTime() : undefined);
+  if (missingProfiles.length > 0 || warningProfiles.length > 0 || missingRoleProfiles.length > 0 || options.minCycles !== undefined && (report.summary.cycles ?? 0) < options.minCycles || options.minActionableProfiles !== undefined && report.defaults.summary.actionableProfiles < options.minActionableProfiles) {
+    actions.push({
+      description: "Run browser profile proof to collect microphone, WebSocket, live-latency, and provider traces for missing profiles.",
+      href: options.browserProofHref ?? "/voice/browser-call-profiles",
+      label: "Run browser profile proof"
+    });
+    actions.push({
+      description: "Run phone profile proof when required profiles depend on carrier, telephony media, or noisy-call evidence.",
+      href: options.phoneProofHref ?? "/api/voice/phone/smoke",
+      label: "Run phone profile proof"
+    });
+  }
+  if (options.maxAgeMs !== undefined && (ageMs === undefined || ageMs > options.maxAgeMs)) {
+    actions.push({
+      description: "Collect fresh real-call profile traces because the current history artifact is stale.",
+      href: options.browserProofHref ?? "/voice/browser-call-profiles",
+      label: "Collect fresh profile evidence"
+    });
+  }
+  if (missingRoleProfiles.length > 0 || report.defaults.summary.actionableProfiles < (options.minActionableProfiles ?? 1)) {
+    actions.push({
+      description: "Collect missing LLM/STT/TTS provider-role evidence so profile defaults can become actionable.",
+      href: options.sourceHref ?? "/api/voice/real-call-profile-history",
+      label: "Collect missing provider-role evidence"
+    });
+  }
+  if (report.recommendations.profiles.some((profile) => profile.status !== "pass") || report.defaults.profiles.some((profile) => profile.status !== "pass")) {
+    actions.push({
+      description: "Open operations records to inspect the sessions behind failing or warning profile evidence.",
+      href: options.operationsRecordsHref ?? "/voice-operations",
+      label: "Open operations records"
+    });
+  }
+  return uniqueRealCallProfileActions(actions);
+};
 var buildVoiceRealCallProfileReadinessCheck = (report, options = {}) => {
   const { issues, warnings } = buildRealCallProfileReadinessIssues(report, options);
   const status = issues.length > 0 ? "fail" : warnings.length > 0 && options.failOnWarnings === true ? "fail" : warnings.length > 0 ? "warn" : "pass";
   const detail = status === "pass" ? `${String(report.summary.profileCount)} profile(s), ${String(report.summary.cycles ?? 0)} cycle(s), ${String(report.defaults.summary.actionableProfiles)} actionable default(s).` : [...issues, ...warnings].join(" ");
   return {
+    actions: buildVoiceRealCallProfileRecoveryActions(report, options),
     detail,
     gateExplanation: {
       evidenceHref: options.href ?? "/api/voice/real-call-profile-history",

package/dist/vue/index.js

@@ -2063,11 +2063,77 @@ var buildRealCallProfileReadinessIssues = (report, options) => {
   }
   return { issues, warnings };
 };
+var uniqueRealCallProfileActions = (actions) => {
+  const seen = new Set;
+  return actions.filter((action) => {
+    const key = `${action.method ?? "GET"}:${action.href}:${action.label}`;
+    if (seen.has(key)) {
+      return false;
+    }
+    seen.add(key);
+    return true;
+  });
+};
+var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
+  const actions = [
+    {
+      description: "Open the current real-call profile history report and profile defaults.",
+      href: options.href ?? "/voice/real-call-profile-history",
+      label: "Open real-call profile history"
+    },
+    {
+      description: "Refresh production readiness after collecting or replaying profile evidence.",
+      href: options.productionReadinessHref ?? "/production-readiness",
+      label: "Refresh production readiness"
+    }
+  ];
+  const requiredProfiles = new Set(options.requiredProfileIds ?? []);
+  const profilesById = new Map(report.defaults.profiles.map((profile) => [profile.profileId, profile]));
+  const missingProfiles = [...requiredProfiles].filter((profileId) => !profilesById.has(profileId));
+  const warningProfiles = report.defaults.profiles.filter((profile) => (requiredProfiles.size === 0 || requiredProfiles.has(profile.profileId)) && profile.status !== "pass");
+  const missingRoleProfiles = report.defaults.profiles.filter((profile) => (options.requiredProviderRoles ?? []).some((role) => !profile.providerRoutes[role]));
+  const ageMs = report.trend.ageMs ?? (report.generatedAt ? Date.now() - new Date(report.generatedAt).getTime() : undefined);
+  if (missingProfiles.length > 0 || warningProfiles.length > 0 || missingRoleProfiles.length > 0 || options.minCycles !== undefined && (report.summary.cycles ?? 0) < options.minCycles || options.minActionableProfiles !== undefined && report.defaults.summary.actionableProfiles < options.minActionableProfiles) {
+    actions.push({
+      description: "Run browser profile proof to collect microphone, WebSocket, live-latency, and provider traces for missing profiles.",
+      href: options.browserProofHref ?? "/voice/browser-call-profiles",
+      label: "Run browser profile proof"
+    });
+    actions.push({
+      description: "Run phone profile proof when required profiles depend on carrier, telephony media, or noisy-call evidence.",
+      href: options.phoneProofHref ?? "/api/voice/phone/smoke",
+      label: "Run phone profile proof"
+    });
+  }
+  if (options.maxAgeMs !== undefined && (ageMs === undefined || ageMs > options.maxAgeMs)) {
+    actions.push({
+      description: "Collect fresh real-call profile traces because the current history artifact is stale.",
+      href: options.browserProofHref ?? "/voice/browser-call-profiles",
+      label: "Collect fresh profile evidence"
+    });
+  }
+  if (missingRoleProfiles.length > 0 || report.defaults.summary.actionableProfiles < (options.minActionableProfiles ?? 1)) {
+    actions.push({
+      description: "Collect missing LLM/STT/TTS provider-role evidence so profile defaults can become actionable.",
+      href: options.sourceHref ?? "/api/voice/real-call-profile-history",
+      label: "Collect missing provider-role evidence"
+    });
+  }
+  if (report.recommendations.profiles.some((profile) => profile.status !== "pass") || report.defaults.profiles.some((profile) => profile.status !== "pass")) {
+    actions.push({
+      description: "Open operations records to inspect the sessions behind failing or warning profile evidence.",
+      href: options.operationsRecordsHref ?? "/voice-operations",
+      label: "Open operations records"
+    });
+  }
+  return uniqueRealCallProfileActions(actions);
+};
 var buildVoiceRealCallProfileReadinessCheck = (report, options = {}) => {
   const { issues, warnings } = buildRealCallProfileReadinessIssues(report, options);
   const status = issues.length > 0 ? "fail" : warnings.length > 0 && options.failOnWarnings === true ? "fail" : warnings.length > 0 ? "warn" : "pass";
   const detail = status === "pass" ? `${String(report.summary.profileCount)} profile(s), ${String(report.summary.cycles ?? 0)} cycle(s), ${String(report.defaults.summary.actionableProfiles)} actionable default(s).` : [...issues, ...warnings].join(" ");
   return {
+    actions: buildVoiceRealCallProfileRecoveryActions(report, options),
     detail,
     gateExplanation: {
       evidenceHref: options.href ?? "/api/voice/real-call-profile-history",

package/package.json

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