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

package/README.md

@@ -1504,6 +1504,39 @@ 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
+	})
+);
+```
+
+For longer-running proof collection, add a job store and mark selected actions async. The POST returns a `jobId` with `jobStatus: "queued"`, and the app can poll `${path}/actions/:jobId`:
+
+```ts
+const recoveryJobs = createVoiceInMemoryRealCallProfileRecoveryJobStore();
+
+app.use(
+	createVoiceRealCallProfileRecoveryActionRoutes({
+		asyncActionIds: ['collect-browser-proof', 'collect-phone-proof'],
+		handlers: {
+			'collect-browser-proof': async () => runBrowserProfileProof(),
+			'collect-phone-proof': async () => runPhoneProfileProof()
+		},
+		jobStore: recoveryJobs,
+		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,11 +4621,48 @@ 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"
     });
   }
   return uniqueRealCallProfileActions(actions);
 };
+var createVoiceInMemoryRealCallProfileRecoveryJobStore = (options = {}) => {
+  const jobs = new Map;
+  const now = () => (options.now ?? (() => new Date))().toISOString();
+  const createId = () => `${options.idPrefix ?? "voice-recovery-job"}-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+  return {
+    create(input) {
+      const createdAt = input.createdAt ?? now();
+      const job = {
+        actionId: input.actionId,
+        createdAt,
+        id: input.id ?? createId(),
+        message: input.message,
+        status: input.status ?? "queued",
+        updatedAt: createdAt
+      };
+      jobs.set(job.id, job);
+      return job;
+    },
+    get(id) {
+      return jobs.get(id);
+    },
+    update(id, update) {
+      const existing = jobs.get(id);
+      if (!existing) {
+        return;
+      }
+      const next = {
+        ...existing,
+        ...update,
+        updatedAt: update.updatedAt ?? now()
+      };
+      jobs.set(id, next);
+      return next;
+    }
+  };
+};
 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";
@@ -5217,6 +5260,165 @@ 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 asyncActionIds = new Set(options.asyncActionIds ?? []);
+  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 runActionHandler = async (actionId, report) => {
+    const handler = options.handlers?.[actionId];
+    if (!handler) {
+      return;
+    }
+    return await handler({ actionId, report });
+  };
+  const runActionAsJob = async (actionId, report) => {
+    const job = await options.jobStore?.create({
+      actionId,
+      message: `Queued real-call profile recovery action: ${actionId}.`,
+      status: "queued"
+    });
+    if (!job) {
+      return;
+    }
+    queueMicrotask(() => {
+      (async () => {
+        const startedAt = new Date().toISOString();
+        await options.jobStore?.update(job.id, {
+          message: `Running real-call profile recovery action: ${actionId}.`,
+          startedAt,
+          status: "running",
+          updatedAt: startedAt
+        });
+        try {
+          const result = await runActionHandler(actionId, report);
+          const completedAt = new Date().toISOString();
+          const ok = result?.ok ?? true;
+          const status = result?.jobStatus ?? (result?.status === "fail" || ok === false ? "fail" : "pass");
+          await options.jobStore?.update(job.id, {
+            completedAt,
+            message: result?.message ?? `Completed real-call profile recovery action: ${actionId}.`,
+            ok,
+            report: result?.report,
+            status,
+            updatedAt: completedAt
+          });
+        } catch (error) {
+          const completedAt = new Date().toISOString();
+          await options.jobStore?.update(job.id, {
+            completedAt,
+            message: error instanceof Error ? error.message : `Failed real-call profile recovery action: ${actionId}.`,
+            ok: false,
+            status: "fail",
+            updatedAt: completedAt
+          });
+        }
+      })();
+    });
+    return {
+      actionId,
+      generatedAt: new Date().toISOString(),
+      job,
+      jobId: job.id,
+      jobStatus: job.status,
+      message: job.message,
+      ok: true,
+      status: "pass"
+    };
+  };
+  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"
+      };
+    }
+    if (options.jobStore && asyncActionIds.has(actionId)) {
+      const queued = await runActionAsJob(actionId, report);
+      if (queued) {
+        return queued;
+      }
+    }
+    const result = await runActionHandler(actionId, report);
+    return {
+      actionId,
+      generatedAt: new Date().toISOString(),
+      job: result?.job,
+      jobId: result?.jobId,
+      jobStatus: result?.jobStatus,
+      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 }));
+  routes.get(`${path}/actions/:jobId`, async ({
+    params,
+    set
+  }) => {
+    const jobId = params.jobId ?? "";
+    const job = await options.jobStore?.get(jobId);
+    if (!job) {
+      set.status = 404;
+      return Response.json({
+        jobId,
+        message: `No real-call profile recovery job found for id: ${jobId}.`,
+        ok: false
+      }, { headers: options.headers });
+    }
+    return Response.json({ job, ok: job.ok ?? job.status !== "fail" }, {
+      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, createVoiceInMemoryRealCallProfileRecoveryJobStore, 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, VoiceRealCallProfileRecoveryJob, VoiceRealCallProfileRecoveryJobCreateInput, VoiceRealCallProfileRecoveryJobStatus, VoiceRealCallProfileRecoveryJobStore, VoiceRealCallProfileRecoveryJobUpdate, 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,11 +16090,48 @@ 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"
     });
   }
   return uniqueRealCallProfileActions(actions);
 };
+var createVoiceInMemoryRealCallProfileRecoveryJobStore = (options = {}) => {
+  const jobs = new Map;
+  const now = () => (options.now ?? (() => new Date))().toISOString();
+  const createId3 = () => `${options.idPrefix ?? "voice-recovery-job"}-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+  return {
+    create(input) {
+      const createdAt = input.createdAt ?? now();
+      const job = {
+        actionId: input.actionId,
+        createdAt,
+        id: input.id ?? createId3(),
+        message: input.message,
+        status: input.status ?? "queued",
+        updatedAt: createdAt
+      };
+      jobs.set(job.id, job);
+      return job;
+    },
+    get(id) {
+      return jobs.get(id);
+    },
+    update(id, update) {
+      const existing = jobs.get(id);
+      if (!existing) {
+        return;
+      }
+      const next = {
+        ...existing,
+        ...update,
+        updatedAt: update.updatedAt ?? now()
+      };
+      jobs.set(id, next);
+      return next;
+    }
+  };
+};
 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";
@@ -16686,6 +16729,165 @@ 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 asyncActionIds = new Set(options.asyncActionIds ?? []);
+  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 runActionHandler = async (actionId, report) => {
+    const handler = options.handlers?.[actionId];
+    if (!handler) {
+      return;
+    }
+    return await handler({ actionId, report });
+  };
+  const runActionAsJob = async (actionId, report) => {
+    const job = await options.jobStore?.create({
+      actionId,
+      message: `Queued real-call profile recovery action: ${actionId}.`,
+      status: "queued"
+    });
+    if (!job) {
+      return;
+    }
+    queueMicrotask(() => {
+      (async () => {
+        const startedAt = new Date().toISOString();
+        await options.jobStore?.update(job.id, {
+          message: `Running real-call profile recovery action: ${actionId}.`,
+          startedAt,
+          status: "running",
+          updatedAt: startedAt
+        });
+        try {
+          const result = await runActionHandler(actionId, report);
+          const completedAt = new Date().toISOString();
+          const ok = result?.ok ?? true;
+          const status = result?.jobStatus ?? (result?.status === "fail" || ok === false ? "fail" : "pass");
+          await options.jobStore?.update(job.id, {
+            completedAt,
+            message: result?.message ?? `Completed real-call profile recovery action: ${actionId}.`,
+            ok,
+            report: result?.report,
+            status,
+            updatedAt: completedAt
+          });
+        } catch (error) {
+          const completedAt = new Date().toISOString();
+          await options.jobStore?.update(job.id, {
+            completedAt,
+            message: error instanceof Error ? error.message : `Failed real-call profile recovery action: ${actionId}.`,
+            ok: false,
+            status: "fail",
+            updatedAt: completedAt
+          });
+        }
+      })();
+    });
+    return {
+      actionId,
+      generatedAt: new Date().toISOString(),
+      job,
+      jobId: job.id,
+      jobStatus: job.status,
+      message: job.message,
+      ok: true,
+      status: "pass"
+    };
+  };
+  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"
+      };
+    }
+    if (options.jobStore && asyncActionIds.has(actionId)) {
+      const queued = await runActionAsJob(actionId, report);
+      if (queued) {
+        return queued;
+      }
+    }
+    const result = await runActionHandler(actionId, report);
+    return {
+      actionId,
+      generatedAt: new Date().toISOString(),
+      job: result?.job,
+      jobId: result?.jobId,
+      jobStatus: result?.jobStatus,
+      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 }));
+  routes.get(`${path}/actions/:jobId`, async ({
+    params,
+    set
+  }) => {
+    const jobId = params.jobId ?? "";
+    const job = await options.jobStore?.get(jobId);
+    if (!job) {
+      set.status = 404;
+      return Response.json({
+        jobId,
+        message: `No real-call profile recovery job found for id: ${jobId}.`,
+        ok: false
+      }, { headers: options.headers });
+    }
+    return Response.json({ job, ok: job.ok ?? job.status !== "fail" }, {
+      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 +38959,7 @@ export {
   createVoiceRealtimeProviderContractRoutes,
   createVoiceRealtimeProviderContractMatrixPreset,
   createVoiceRealtimeChannelRoutes,
+  createVoiceRealCallProfileRecoveryActionRoutes,
   createVoiceRealCallProfileHistoryRoutes,
   createVoiceReadinessProfile,
   createVoiceQualityRoutes,
@@ -38854,6 +39057,7 @@ export {
   createVoiceIntegrationHTTPSink,
   createVoiceIntegrationEvent,
   createVoiceIncidentBundleRoutes,
+  createVoiceInMemoryRealCallProfileRecoveryJobStore,
   createVoiceHubSpotTaskUpdateSink,
   createVoiceHubSpotTaskSyncSinks,
   createVoiceHubSpotTaskSink,

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,53 @@ export type VoiceRealCallProfileReadinessCheckOptions = {
     sourceHref?: string;
 };
 export type VoiceRealCallProfileRecoveryActionOptions = VoiceRealCallProfileReadinessCheckOptions;
+export type VoiceRealCallProfileRecoveryActionHandlerInput = {
+    actionId: VoiceRealCallProfileRecoveryActionId;
+    report: VoiceRealCallProfileHistoryReport;
+};
+export type VoiceRealCallProfileRecoveryActionResult = {
+    actionId: VoiceRealCallProfileRecoveryActionId;
+    generatedAt: string;
+    job?: VoiceRealCallProfileRecoveryJob;
+    jobId?: string;
+    jobStatus?: VoiceRealCallProfileRecoveryJobStatus;
+    message?: string;
+    ok: boolean;
+    report?: VoiceRealCallProfileHistoryReport;
+    status: VoiceProofTrendStatus;
+};
+export type VoiceRealCallProfileRecoveryJobStatus = 'fail' | 'pass' | 'queued' | 'running';
+export type VoiceRealCallProfileRecoveryJob = {
+    actionId: VoiceRealCallProfileRecoveryActionId;
+    completedAt?: string;
+    createdAt: string;
+    id: string;
+    message?: string;
+    ok?: boolean;
+    report?: VoiceRealCallProfileHistoryReport;
+    startedAt?: string;
+    status: VoiceRealCallProfileRecoveryJobStatus;
+    updatedAt: string;
+};
+export type VoiceRealCallProfileRecoveryJobCreateInput = {
+    actionId: VoiceRealCallProfileRecoveryActionId;
+    createdAt?: string;
+    id?: string;
+    message?: string;
+    status?: VoiceRealCallProfileRecoveryJobStatus;
+};
+export type VoiceRealCallProfileRecoveryJobUpdate = Partial<Pick<VoiceRealCallProfileRecoveryJob, 'completedAt' | 'message' | 'ok' | 'report' | 'startedAt' | 'status' | 'updatedAt'>>;
+export type VoiceRealCallProfileRecoveryJobStore = {
+    create(input: VoiceRealCallProfileRecoveryJobCreateInput): Promise<VoiceRealCallProfileRecoveryJob> | VoiceRealCallProfileRecoveryJob;
+    get(id: string): Promise<VoiceRealCallProfileRecoveryJob | undefined> | VoiceRealCallProfileRecoveryJob | undefined;
+    update(id: string, update: VoiceRealCallProfileRecoveryJobUpdate): Promise<VoiceRealCallProfileRecoveryJob | undefined> | VoiceRealCallProfileRecoveryJob | undefined;
+};
+export type VoiceRealCallProfileRecoveryActionHandler = (input: VoiceRealCallProfileRecoveryActionHandlerInput) => Promise<Partial<VoiceRealCallProfileRecoveryActionResult> | void> | Partial<VoiceRealCallProfileRecoveryActionResult> | void;
+export type VoiceRealCallProfileRecoveryActionRoutesOptions = VoiceRealCallProfileRecoveryActionOptions & Omit<VoiceRealCallProfileHistoryRoutesOptions, 'htmlPath' | 'markdownPath'> & {
+    asyncActionIds?: readonly VoiceRealCallProfileRecoveryActionId[];
+    handlers?: Partial<Record<VoiceRealCallProfileRecoveryActionId, VoiceRealCallProfileRecoveryActionHandler>>;
+    jobStore?: VoiceRealCallProfileRecoveryJobStore;
+};
 export declare const DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS: number;
 export declare const DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS: ({
     description: string;
@@ -406,7 +457,11 @@ 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 createVoiceInMemoryRealCallProfileRecoveryJobStore: (options?: {
+    idPrefix?: string;
+    now?: () => Date;
+}) => VoiceRealCallProfileRecoveryJobStore;
 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 +528,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,11 +2208,48 @@ 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"
     });
   }
   return uniqueRealCallProfileActions(actions);
 };
+var createVoiceInMemoryRealCallProfileRecoveryJobStore = (options = {}) => {
+  const jobs = new Map;
+  const now = () => (options.now ?? (() => new Date))().toISOString();
+  const createId = () => `${options.idPrefix ?? "voice-recovery-job"}-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+  return {
+    create(input) {
+      const createdAt = input.createdAt ?? now();
+      const job = {
+        actionId: input.actionId,
+        createdAt,
+        id: input.id ?? createId(),
+        message: input.message,
+        status: input.status ?? "queued",
+        updatedAt: createdAt
+      };
+      jobs.set(job.id, job);
+      return job;
+    },
+    get(id) {
+      return jobs.get(id);
+    },
+    update(id, update) {
+      const existing = jobs.get(id);
+      if (!existing) {
+        return;
+      }
+      const next = {
+        ...existing,
+        ...update,
+        updatedAt: update.updatedAt ?? now()
+      };
+      jobs.set(id, next);
+      return next;
+    }
+  };
+};
 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";
@@ -2804,6 +2847,165 @@ 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 asyncActionIds = new Set(options.asyncActionIds ?? []);
+  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 runActionHandler = async (actionId, report) => {
+    const handler = options.handlers?.[actionId];
+    if (!handler) {
+      return;
+    }
+    return await handler({ actionId, report });
+  };
+  const runActionAsJob = async (actionId, report) => {
+    const job = await options.jobStore?.create({
+      actionId,
+      message: `Queued real-call profile recovery action: ${actionId}.`,
+      status: "queued"
+    });
+    if (!job) {
+      return;
+    }
+    queueMicrotask(() => {
+      (async () => {
+        const startedAt = new Date().toISOString();
+        await options.jobStore?.update(job.id, {
+          message: `Running real-call profile recovery action: ${actionId}.`,
+          startedAt,
+          status: "running",
+          updatedAt: startedAt
+        });
+        try {
+          const result = await runActionHandler(actionId, report);
+          const completedAt = new Date().toISOString();
+          const ok = result?.ok ?? true;
+          const status = result?.jobStatus ?? (result?.status === "fail" || ok === false ? "fail" : "pass");
+          await options.jobStore?.update(job.id, {
+            completedAt,
+            message: result?.message ?? `Completed real-call profile recovery action: ${actionId}.`,
+            ok,
+            report: result?.report,
+            status,
+            updatedAt: completedAt
+          });
+        } catch (error) {
+          const completedAt = new Date().toISOString();
+          await options.jobStore?.update(job.id, {
+            completedAt,
+            message: error instanceof Error ? error.message : `Failed real-call profile recovery action: ${actionId}.`,
+            ok: false,
+            status: "fail",
+            updatedAt: completedAt
+          });
+        }
+      })();
+    });
+    return {
+      actionId,
+      generatedAt: new Date().toISOString(),
+      job,
+      jobId: job.id,
+      jobStatus: job.status,
+      message: job.message,
+      ok: true,
+      status: "pass"
+    };
+  };
+  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"
+      };
+    }
+    if (options.jobStore && asyncActionIds.has(actionId)) {
+      const queued = await runActionAsJob(actionId, report);
+      if (queued) {
+        return queued;
+      }
+    }
+    const result = await runActionHandler(actionId, report);
+    return {
+      actionId,
+      generatedAt: new Date().toISOString(),
+      job: result?.job,
+      jobId: result?.jobId,
+      jobStatus: result?.jobStatus,
+      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 }));
+  routes.get(`${path}/actions/:jobId`, async ({
+    params,
+    set
+  }) => {
+    const jobId = params.jobId ?? "";
+    const job = await options.jobStore?.get(jobId);
+    if (!job) {
+      set.status = 404;
+      return Response.json({
+        jobId,
+        message: `No real-call profile recovery job found for id: ${jobId}.`,
+        ok: false
+      }, { headers: options.headers });
+    }
+    return Response.json({ job, ok: job.ok ?? job.status !== "fail" }, {
+      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,11 +2129,48 @@ 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"
     });
   }
   return uniqueRealCallProfileActions(actions);
 };
+var createVoiceInMemoryRealCallProfileRecoveryJobStore = (options = {}) => {
+  const jobs = new Map;
+  const now = () => (options.now ?? (() => new Date))().toISOString();
+  const createId = () => `${options.idPrefix ?? "voice-recovery-job"}-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+  return {
+    create(input) {
+      const createdAt = input.createdAt ?? now();
+      const job = {
+        actionId: input.actionId,
+        createdAt,
+        id: input.id ?? createId(),
+        message: input.message,
+        status: input.status ?? "queued",
+        updatedAt: createdAt
+      };
+      jobs.set(job.id, job);
+      return job;
+    },
+    get(id) {
+      return jobs.get(id);
+    },
+    update(id, update) {
+      const existing = jobs.get(id);
+      if (!existing) {
+        return;
+      }
+      const next = {
+        ...existing,
+        ...update,
+        updatedAt: update.updatedAt ?? now()
+      };
+      jobs.set(id, next);
+      return next;
+    }
+  };
+};
 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";
@@ -2725,6 +2768,165 @@ 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 asyncActionIds = new Set(options.asyncActionIds ?? []);
+  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 runActionHandler = async (actionId, report) => {
+    const handler = options.handlers?.[actionId];
+    if (!handler) {
+      return;
+    }
+    return await handler({ actionId, report });
+  };
+  const runActionAsJob = async (actionId, report) => {
+    const job = await options.jobStore?.create({
+      actionId,
+      message: `Queued real-call profile recovery action: ${actionId}.`,
+      status: "queued"
+    });
+    if (!job) {
+      return;
+    }
+    queueMicrotask(() => {
+      (async () => {
+        const startedAt = new Date().toISOString();
+        await options.jobStore?.update(job.id, {
+          message: `Running real-call profile recovery action: ${actionId}.`,
+          startedAt,
+          status: "running",
+          updatedAt: startedAt
+        });
+        try {
+          const result = await runActionHandler(actionId, report);
+          const completedAt = new Date().toISOString();
+          const ok = result?.ok ?? true;
+          const status = result?.jobStatus ?? (result?.status === "fail" || ok === false ? "fail" : "pass");
+          await options.jobStore?.update(job.id, {
+            completedAt,
+            message: result?.message ?? `Completed real-call profile recovery action: ${actionId}.`,
+            ok,
+            report: result?.report,
+            status,
+            updatedAt: completedAt
+          });
+        } catch (error) {
+          const completedAt = new Date().toISOString();
+          await options.jobStore?.update(job.id, {
+            completedAt,
+            message: error instanceof Error ? error.message : `Failed real-call profile recovery action: ${actionId}.`,
+            ok: false,
+            status: "fail",
+            updatedAt: completedAt
+          });
+        }
+      })();
+    });
+    return {
+      actionId,
+      generatedAt: new Date().toISOString(),
+      job,
+      jobId: job.id,
+      jobStatus: job.status,
+      message: job.message,
+      ok: true,
+      status: "pass"
+    };
+  };
+  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"
+      };
+    }
+    if (options.jobStore && asyncActionIds.has(actionId)) {
+      const queued = await runActionAsJob(actionId, report);
+      if (queued) {
+        return queued;
+      }
+    }
+    const result = await runActionHandler(actionId, report);
+    return {
+      actionId,
+      generatedAt: new Date().toISOString(),
+      job: result?.job,
+      jobId: result?.jobId,
+      jobStatus: result?.jobStatus,
+      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 }));
+  routes.get(`${path}/actions/:jobId`, async ({
+    params,
+    set
+  }) => {
+    const jobId = params.jobId ?? "";
+    const job = await options.jobStore?.get(jobId);
+    if (!job) {
+      set.status = 404;
+      return Response.json({
+        jobId,
+        message: `No real-call profile recovery job found for id: ${jobId}.`,
+        ok: false
+      }, { headers: options.headers });
+    }
+    return Response.json({ job, ok: job.ok ?? job.status !== "fail" }, {
+      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.373",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",