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

package/README.md

@@ -1504,6 +1504,21 @@ 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

@@ -4571,11 +4571,13 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
     {
       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"
     }
   ];
@@ -4589,11 +4591,13 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
     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"
     });
   }
@@ -4601,6 +4605,7 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
     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"
     });
   }
@@ -4608,6 +4613,7 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
     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"
     });
   }
@@ -4615,6 +4621,7 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
     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"
     });
   }
@@ -5217,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, 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 { 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, VoiceRealCallProfileRecoveryActionOptions, 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

@@ -16040,11 +16040,13 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
     {
       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"
     }
   ];
@@ -16058,11 +16060,13 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
     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"
     });
   }
@@ -16070,6 +16074,7 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
     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"
     });
   }
@@ -16077,6 +16082,7 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
     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"
     });
   }
@@ -16084,6 +16090,7 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
     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"
     });
   }
@@ -16686,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({
@@ -38757,6 +38834,7 @@ export {
   createVoiceRealtimeProviderContractRoutes,
   createVoiceRealtimeProviderContractMatrixPreset,
   createVoiceRealtimeChannelRoutes,
+  createVoiceRealCallProfileRecoveryActionRoutes,
   createVoiceRealCallProfileHistoryRoutes,
   createVoiceReadinessProfile,
   createVoiceQualityRoutes,

package/dist/proofTrends.d.ts

@@ -356,6 +356,10 @@ 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;
@@ -373,6 +377,22 @@ export type VoiceRealCallProfileReadinessCheckOptions = {
     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;
@@ -406,7 +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) => VoiceProductionReadinessAction[];
+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;
@@ -473,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

@@ -2158,11 +2158,13 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
     {
       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"
     }
   ];
@@ -2176,11 +2178,13 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
     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"
     });
   }
@@ -2188,6 +2192,7 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
     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"
     });
   }
@@ -2195,6 +2200,7 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
     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"
     });
   }
@@ -2202,6 +2208,7 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
     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"
     });
   }
@@ -2804,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

@@ -2079,11 +2079,13 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
     {
       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"
     }
   ];
@@ -2097,11 +2099,13 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
     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"
     });
   }
@@ -2109,6 +2113,7 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
     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"
     });
   }
@@ -2116,6 +2121,7 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
     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"
     });
   }
@@ -2123,6 +2129,7 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
     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"
     });
   }
@@ -2725,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.371",
+	"version": "0.0.22-beta.372",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",