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

package/README.md

@@ -1502,6 +1502,23 @@ 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."
+
+Mount `createVoiceRealCallProfileRecoveryActionRoutes(...)` when those actions should be executable. The package owns the route contract and result shape; the app supplies safe handlers:
+
+```ts
+app.use(
+	createVoiceRealCallProfileRecoveryActionRoutes({
+		handlers: {
+			'collect-browser-proof': async () => runBrowserProfileProof(),
+			'collect-phone-proof': async () => runPhoneProfileProof(),
+			refresh: async () => refreshReadinessProof()
+		},
+		source: buildRealCallHistory
+	})
+);
+```
+
 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,84 @@ 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",
+      id: "refresh",
+      label: "Open real-call profile history"
+    },
+    {
+      description: "Refresh production readiness after collecting or replaying profile evidence.",
+      href: options.productionReadinessHref ?? "/production-readiness",
+      id: "refresh",
+      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",
+      id: "collect-browser-proof",
+      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",
+      id: "collect-phone-proof",
+      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",
+      id: "collect-browser-proof",
+      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",
+      id: "collect-provider-role-evidence",
+      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",
+      id: "refresh",
+      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",
@@ -5151,6 +5224,76 @@ var createVoiceRealCallProfileHistoryRoutes = (options = {}) => {
   }
   return routes;
 };
+var realCallProfileActionPaths = {
+  "collect-browser-proof": "/collect-browser-proof",
+  "collect-phone-proof": "/collect-phone-proof",
+  "collect-provider-role-evidence": "/collect-provider-role-evidence",
+  refresh: "/refresh"
+};
+var loadVoiceRealCallProfileHistoryRouteReport = async (options) => {
+  const { source, ...routeOptions } = options;
+  const sourceOptions = source === undefined ? routeOptions : typeof source === "function" ? await source() : source;
+  return buildVoiceRealCallProfileHistoryReport({
+    ...routeOptions,
+    ...sourceOptions
+  });
+};
+var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
+  const path = options.path ?? "/api/voice/real-call-profile-history";
+  const routes = new Elysia({
+    name: options.name ?? "absolutejs-voice-real-call-profile-recovery-actions"
+  });
+  const actionPath = (actionId) => `${path}${realCallProfileActionPaths[actionId]}`;
+  const loadReport = () => loadVoiceRealCallProfileHistoryRouteReport(options);
+  const listActions = async () => {
+    const report = await loadReport();
+    const actions = buildVoiceRealCallProfileRecoveryActions(report, {
+      ...options,
+      browserProofHref: options.browserProofHref ?? actionPath("collect-browser-proof"),
+      phoneProofHref: options.phoneProofHref ?? actionPath("collect-phone-proof"),
+      sourceHref: options.sourceHref ?? actionPath("collect-provider-role-evidence"),
+      productionReadinessHref: options.productionReadinessHref ?? actionPath("refresh")
+    }).map((action) => ({
+      ...action,
+      href: action.id === "collect-browser-proof" ? actionPath("collect-browser-proof") : action.id === "collect-phone-proof" ? actionPath("collect-phone-proof") : action.id === "collect-provider-role-evidence" ? actionPath("collect-provider-role-evidence") : action.href,
+      method: action.id === "refresh" && (action.label === "Open real-call profile history" || action.label === "Open operations records") ? "GET" : "POST"
+    }));
+    return { actions, generatedAt: new Date().toISOString(), report };
+  };
+  const runAction = async (actionId) => {
+    const report = await loadReport();
+    const handler = options.handlers?.[actionId];
+    if (!handler) {
+      return {
+        actionId,
+        generatedAt: new Date().toISOString(),
+        message: `No handler configured for real-call profile recovery action: ${actionId}.`,
+        ok: false,
+        status: "fail"
+      };
+    }
+    const result = await handler({ actionId, report });
+    return {
+      actionId,
+      generatedAt: new Date().toISOString(),
+      message: result?.message,
+      ok: result?.ok ?? true,
+      report: result?.report,
+      status: result?.status ?? "pass"
+    };
+  };
+  routes.get(`${path}/actions`, async () => Response.json(await listActions(), { headers: options.headers }));
+  for (const actionId of Object.keys(realCallProfileActionPaths)) {
+    routes.post(actionPath(actionId), async ({ set }) => {
+      const result = await runAction(actionId);
+      if (!result.ok) {
+        set.status = 501;
+      }
+      return Response.json(result, { headers: options.headers });
+    });
+  }
+  return routes;
+};
 var createVoiceProofTrendRoutes = (options) => {
   const path = options.path ?? "/api/voice/proof-trends";
   const routes = new Elysia({

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, 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, 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, VoiceRealCallProfileRecoveryActionResult, VoiceRealCallProfileRecoveryActionRoutesOptions, 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,84 @@ 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",
+      id: "refresh",
+      label: "Open real-call profile history"
+    },
+    {
+      description: "Refresh production readiness after collecting or replaying profile evidence.",
+      href: options.productionReadinessHref ?? "/production-readiness",
+      id: "refresh",
+      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",
+      id: "collect-browser-proof",
+      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",
+      id: "collect-phone-proof",
+      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",
+      id: "collect-browser-proof",
+      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",
+      id: "collect-provider-role-evidence",
+      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",
+      id: "refresh",
+      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",
@@ -16620,6 +16693,76 @@ var createVoiceRealCallProfileHistoryRoutes = (options = {}) => {
   }
   return routes;
 };
+var realCallProfileActionPaths = {
+  "collect-browser-proof": "/collect-browser-proof",
+  "collect-phone-proof": "/collect-phone-proof",
+  "collect-provider-role-evidence": "/collect-provider-role-evidence",
+  refresh: "/refresh"
+};
+var loadVoiceRealCallProfileHistoryRouteReport = async (options) => {
+  const { source, ...routeOptions } = options;
+  const sourceOptions = source === undefined ? routeOptions : typeof source === "function" ? await source() : source;
+  return buildVoiceRealCallProfileHistoryReport({
+    ...routeOptions,
+    ...sourceOptions
+  });
+};
+var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
+  const path = options.path ?? "/api/voice/real-call-profile-history";
+  const routes = new Elysia22({
+    name: options.name ?? "absolutejs-voice-real-call-profile-recovery-actions"
+  });
+  const actionPath = (actionId) => `${path}${realCallProfileActionPaths[actionId]}`;
+  const loadReport = () => loadVoiceRealCallProfileHistoryRouteReport(options);
+  const listActions = async () => {
+    const report = await loadReport();
+    const actions = buildVoiceRealCallProfileRecoveryActions(report, {
+      ...options,
+      browserProofHref: options.browserProofHref ?? actionPath("collect-browser-proof"),
+      phoneProofHref: options.phoneProofHref ?? actionPath("collect-phone-proof"),
+      sourceHref: options.sourceHref ?? actionPath("collect-provider-role-evidence"),
+      productionReadinessHref: options.productionReadinessHref ?? actionPath("refresh")
+    }).map((action) => ({
+      ...action,
+      href: action.id === "collect-browser-proof" ? actionPath("collect-browser-proof") : action.id === "collect-phone-proof" ? actionPath("collect-phone-proof") : action.id === "collect-provider-role-evidence" ? actionPath("collect-provider-role-evidence") : action.href,
+      method: action.id === "refresh" && (action.label === "Open real-call profile history" || action.label === "Open operations records") ? "GET" : "POST"
+    }));
+    return { actions, generatedAt: new Date().toISOString(), report };
+  };
+  const runAction = async (actionId) => {
+    const report = await loadReport();
+    const handler = options.handlers?.[actionId];
+    if (!handler) {
+      return {
+        actionId,
+        generatedAt: new Date().toISOString(),
+        message: `No handler configured for real-call profile recovery action: ${actionId}.`,
+        ok: false,
+        status: "fail"
+      };
+    }
+    const result = await handler({ actionId, report });
+    return {
+      actionId,
+      generatedAt: new Date().toISOString(),
+      message: result?.message,
+      ok: result?.ok ?? true,
+      report: result?.report,
+      status: result?.status ?? "pass"
+    };
+  };
+  routes.get(`${path}/actions`, async () => Response.json(await listActions(), { headers: options.headers }));
+  for (const actionId of Object.keys(realCallProfileActionPaths)) {
+    routes.post(actionPath(actionId), async ({ set }) => {
+      const result = await runAction(actionId);
+      if (!result.ok) {
+        set.status = 501;
+      }
+      return Response.json(result, { headers: options.headers });
+    });
+  }
+  return routes;
+};
 var createVoiceProofTrendRoutes = (options) => {
   const path = options.path ?? "/api/voice/proof-trends";
   const routes = new Elysia22({
@@ -38691,6 +38834,7 @@ export {
   createVoiceRealtimeProviderContractRoutes,
   createVoiceRealtimeProviderContractMatrixPreset,
   createVoiceRealtimeChannelRoutes,
+  createVoiceRealCallProfileRecoveryActionRoutes,
   createVoiceRealCallProfileHistoryRoutes,
   createVoiceReadinessProfile,
   createVoiceQualityRoutes,
@@ -38907,6 +39051,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 = {
@@ -356,7 +356,12 @@ export type VoiceRealCallProfileHistoryRoutesOptions = Omit<VoiceRealCallProfile
     source?: (() => Promise<VoiceRealCallProfileHistoryOptions> | VoiceRealCallProfileHistoryOptions) | VoiceRealCallProfileHistoryOptions;
     title?: string;
 };
+export type VoiceRealCallProfileRecoveryActionId = 'collect-browser-proof' | 'collect-phone-proof' | 'collect-provider-role-evidence' | 'refresh';
+export type VoiceRealCallProfileRecoveryAction = VoiceProductionReadinessAction & {
+    id: VoiceRealCallProfileRecoveryActionId;
+};
 export type VoiceRealCallProfileReadinessCheckOptions = {
+    browserProofHref?: string;
     failOnWarnings?: boolean;
     href?: string;
     label?: string;
@@ -366,8 +371,28 @@ export type VoiceRealCallProfileReadinessCheckOptions = {
     minProfiles?: number;
     requiredProfileIds?: readonly string[];
     requiredProviderRoles?: readonly string[];
+    operationsRecordsHref?: string;
+    phoneProofHref?: string;
+    productionReadinessHref?: string;
     sourceHref?: string;
 };
+export type VoiceRealCallProfileRecoveryActionOptions = VoiceRealCallProfileReadinessCheckOptions;
+export type VoiceRealCallProfileRecoveryActionHandlerInput = {
+    actionId: VoiceRealCallProfileRecoveryActionId;
+    report: VoiceRealCallProfileHistoryReport;
+};
+export type VoiceRealCallProfileRecoveryActionResult = {
+    actionId: VoiceRealCallProfileRecoveryActionId;
+    generatedAt: string;
+    message?: string;
+    ok: boolean;
+    report?: VoiceRealCallProfileHistoryReport;
+    status: VoiceProofTrendStatus;
+};
+export type VoiceRealCallProfileRecoveryActionHandler = (input: VoiceRealCallProfileRecoveryActionHandlerInput) => Promise<Partial<VoiceRealCallProfileRecoveryActionResult> | void> | Partial<VoiceRealCallProfileRecoveryActionResult> | void;
+export type VoiceRealCallProfileRecoveryActionRoutesOptions = VoiceRealCallProfileRecoveryActionOptions & Omit<VoiceRealCallProfileHistoryRoutesOptions, 'htmlPath' | 'markdownPath'> & {
+    handlers?: Partial<Record<VoiceRealCallProfileRecoveryActionId, VoiceRealCallProfileRecoveryActionHandler>>;
+};
 export declare const DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS: number;
 export declare const DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS: ({
     description: string;
@@ -401,6 +426,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) => VoiceRealCallProfileRecoveryAction[];
 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;
@@ -467,6 +493,34 @@ export declare const createVoiceRealCallProfileHistoryRoutes: (options?: VoiceRe
     standaloneSchema: {};
     response: {};
 }>;
+export declare const createVoiceRealCallProfileRecoveryActionRoutes: (options?: VoiceRealCallProfileRecoveryActionRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;
 export declare const createVoiceProofTrendRoutes: (options: VoiceProofTrendRoutesOptions) => Elysia<"", {
     decorator: {};
     store: {};

package/dist/react/index.js

@@ -2142,11 +2142,84 @@ 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",
+      id: "refresh",
+      label: "Open real-call profile history"
+    },
+    {
+      description: "Refresh production readiness after collecting or replaying profile evidence.",
+      href: options.productionReadinessHref ?? "/production-readiness",
+      id: "refresh",
+      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",
+      id: "collect-browser-proof",
+      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",
+      id: "collect-phone-proof",
+      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",
+      id: "collect-browser-proof",
+      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",
+      id: "collect-provider-role-evidence",
+      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",
+      id: "refresh",
+      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",
@@ -2738,6 +2811,76 @@ var createVoiceRealCallProfileHistoryRoutes = (options = {}) => {
   }
   return routes;
 };
+var realCallProfileActionPaths = {
+  "collect-browser-proof": "/collect-browser-proof",
+  "collect-phone-proof": "/collect-phone-proof",
+  "collect-provider-role-evidence": "/collect-provider-role-evidence",
+  refresh: "/refresh"
+};
+var loadVoiceRealCallProfileHistoryRouteReport = async (options) => {
+  const { source, ...routeOptions } = options;
+  const sourceOptions = source === undefined ? routeOptions : typeof source === "function" ? await source() : source;
+  return buildVoiceRealCallProfileHistoryReport({
+    ...routeOptions,
+    ...sourceOptions
+  });
+};
+var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
+  const path = options.path ?? "/api/voice/real-call-profile-history";
+  const routes = new Elysia({
+    name: options.name ?? "absolutejs-voice-real-call-profile-recovery-actions"
+  });
+  const actionPath = (actionId) => `${path}${realCallProfileActionPaths[actionId]}`;
+  const loadReport = () => loadVoiceRealCallProfileHistoryRouteReport(options);
+  const listActions = async () => {
+    const report = await loadReport();
+    const actions = buildVoiceRealCallProfileRecoveryActions(report, {
+      ...options,
+      browserProofHref: options.browserProofHref ?? actionPath("collect-browser-proof"),
+      phoneProofHref: options.phoneProofHref ?? actionPath("collect-phone-proof"),
+      sourceHref: options.sourceHref ?? actionPath("collect-provider-role-evidence"),
+      productionReadinessHref: options.productionReadinessHref ?? actionPath("refresh")
+    }).map((action) => ({
+      ...action,
+      href: action.id === "collect-browser-proof" ? actionPath("collect-browser-proof") : action.id === "collect-phone-proof" ? actionPath("collect-phone-proof") : action.id === "collect-provider-role-evidence" ? actionPath("collect-provider-role-evidence") : action.href,
+      method: action.id === "refresh" && (action.label === "Open real-call profile history" || action.label === "Open operations records") ? "GET" : "POST"
+    }));
+    return { actions, generatedAt: new Date().toISOString(), report };
+  };
+  const runAction = async (actionId) => {
+    const report = await loadReport();
+    const handler = options.handlers?.[actionId];
+    if (!handler) {
+      return {
+        actionId,
+        generatedAt: new Date().toISOString(),
+        message: `No handler configured for real-call profile recovery action: ${actionId}.`,
+        ok: false,
+        status: "fail"
+      };
+    }
+    const result = await handler({ actionId, report });
+    return {
+      actionId,
+      generatedAt: new Date().toISOString(),
+      message: result?.message,
+      ok: result?.ok ?? true,
+      report: result?.report,
+      status: result?.status ?? "pass"
+    };
+  };
+  routes.get(`${path}/actions`, async () => Response.json(await listActions(), { headers: options.headers }));
+  for (const actionId of Object.keys(realCallProfileActionPaths)) {
+    routes.post(actionPath(actionId), async ({ set }) => {
+      const result = await runAction(actionId);
+      if (!result.ok) {
+        set.status = 501;
+      }
+      return Response.json(result, { headers: options.headers });
+    });
+  }
+  return routes;
+};
 var createVoiceProofTrendRoutes = (options) => {
   const path = options.path ?? "/api/voice/proof-trends";
   const routes = new Elysia({

package/dist/vue/index.js

@@ -2063,11 +2063,84 @@ 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",
+      id: "refresh",
+      label: "Open real-call profile history"
+    },
+    {
+      description: "Refresh production readiness after collecting or replaying profile evidence.",
+      href: options.productionReadinessHref ?? "/production-readiness",
+      id: "refresh",
+      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",
+      id: "collect-browser-proof",
+      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",
+      id: "collect-phone-proof",
+      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",
+      id: "collect-browser-proof",
+      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",
+      id: "collect-provider-role-evidence",
+      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",
+      id: "refresh",
+      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",
@@ -2659,6 +2732,76 @@ var createVoiceRealCallProfileHistoryRoutes = (options = {}) => {
   }
   return routes;
 };
+var realCallProfileActionPaths = {
+  "collect-browser-proof": "/collect-browser-proof",
+  "collect-phone-proof": "/collect-phone-proof",
+  "collect-provider-role-evidence": "/collect-provider-role-evidence",
+  refresh: "/refresh"
+};
+var loadVoiceRealCallProfileHistoryRouteReport = async (options) => {
+  const { source, ...routeOptions } = options;
+  const sourceOptions = source === undefined ? routeOptions : typeof source === "function" ? await source() : source;
+  return buildVoiceRealCallProfileHistoryReport({
+    ...routeOptions,
+    ...sourceOptions
+  });
+};
+var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
+  const path = options.path ?? "/api/voice/real-call-profile-history";
+  const routes = new Elysia({
+    name: options.name ?? "absolutejs-voice-real-call-profile-recovery-actions"
+  });
+  const actionPath = (actionId) => `${path}${realCallProfileActionPaths[actionId]}`;
+  const loadReport = () => loadVoiceRealCallProfileHistoryRouteReport(options);
+  const listActions = async () => {
+    const report = await loadReport();
+    const actions = buildVoiceRealCallProfileRecoveryActions(report, {
+      ...options,
+      browserProofHref: options.browserProofHref ?? actionPath("collect-browser-proof"),
+      phoneProofHref: options.phoneProofHref ?? actionPath("collect-phone-proof"),
+      sourceHref: options.sourceHref ?? actionPath("collect-provider-role-evidence"),
+      productionReadinessHref: options.productionReadinessHref ?? actionPath("refresh")
+    }).map((action) => ({
+      ...action,
+      href: action.id === "collect-browser-proof" ? actionPath("collect-browser-proof") : action.id === "collect-phone-proof" ? actionPath("collect-phone-proof") : action.id === "collect-provider-role-evidence" ? actionPath("collect-provider-role-evidence") : action.href,
+      method: action.id === "refresh" && (action.label === "Open real-call profile history" || action.label === "Open operations records") ? "GET" : "POST"
+    }));
+    return { actions, generatedAt: new Date().toISOString(), report };
+  };
+  const runAction = async (actionId) => {
+    const report = await loadReport();
+    const handler = options.handlers?.[actionId];
+    if (!handler) {
+      return {
+        actionId,
+        generatedAt: new Date().toISOString(),
+        message: `No handler configured for real-call profile recovery action: ${actionId}.`,
+        ok: false,
+        status: "fail"
+      };
+    }
+    const result = await handler({ actionId, report });
+    return {
+      actionId,
+      generatedAt: new Date().toISOString(),
+      message: result?.message,
+      ok: result?.ok ?? true,
+      report: result?.report,
+      status: result?.status ?? "pass"
+    };
+  };
+  routes.get(`${path}/actions`, async () => Response.json(await listActions(), { headers: options.headers }));
+  for (const actionId of Object.keys(realCallProfileActionPaths)) {
+    routes.post(actionPath(actionId), async ({ set }) => {
+      const result = await runAction(actionId);
+      if (!result.ok) {
+        set.status = 501;
+      }
+      return Response.json(result, { headers: options.headers });
+    });
+  }
+  return routes;
+};
 var createVoiceProofTrendRoutes = (options) => {
   const path = options.path ?? "/api/voice/proof-trends";
   const routes = new Elysia({

package/package.json

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