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

package/README.md

@@ -1519,6 +1519,24 @@ app.use(
 );
 ```
 
+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

@@ -4627,6 +4627,42 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
   }
   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";
@@ -5245,6 +5281,7 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
   });
   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, {
@@ -5260,6 +5297,67 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
     }));
     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];
@@ -5272,10 +5370,19 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
         status: "fail"
       };
     }
-    const result = await handler({ actionId, report });
+    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,
@@ -5283,6 +5390,24 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
     };
   };
   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);

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, createVoiceRealCallProfileRecoveryActionRoutes, DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS, DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS, evaluateVoiceProofTrendEvidence, formatVoiceProofTrendAge, loadVoiceRealCallProfileEvidenceFromTraceStore, normalizeVoiceProofTrendReport, readVoiceProofTrendReportFile, renderVoiceProofTrendRecommendationHTML, renderVoiceProofTrendRecommendationMarkdown, renderVoiceRealCallProfileHistoryHTML, renderVoiceRealCallProfileHistoryMarkdown, resolveVoiceRealCallProfileProviderRoute } from './proofTrends';
+export { assertVoiceProofTrendEvidence, buildEmptyVoiceProofTrendReport, buildVoiceProofTrendProfileSummaries, buildVoiceProofTrendRecommendationReport, buildVoiceProofTrendReportFromRealCallProfiles, buildVoiceProofTrendReport, buildVoiceRealCallProfileEvidenceFromTraceEvents, buildVoiceRealCallProfileDefaults, buildVoiceRealCallProfileHistoryReport, buildVoiceRealCallProfileReadinessCheck, 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, VoiceRealCallProfileRecoveryAction, VoiceRealCallProfileRecoveryActionHandler, VoiceRealCallProfileRecoveryActionHandlerInput, VoiceRealCallProfileRecoveryActionId, VoiceRealCallProfileRecoveryActionResult, VoiceRealCallProfileRecoveryActionRoutesOptions, 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

@@ -16096,6 +16096,42 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
   }
   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";
@@ -16714,6 +16750,7 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
   });
   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, {
@@ -16729,6 +16766,67 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
     }));
     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];
@@ -16741,10 +16839,19 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
         status: "fail"
       };
     }
-    const result = await handler({ actionId, report });
+    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,
@@ -16752,6 +16859,24 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
     };
   };
   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);
@@ -38932,6 +39057,7 @@ export {
   createVoiceIntegrationHTTPSink,
   createVoiceIntegrationEvent,
   createVoiceIncidentBundleRoutes,
+  createVoiceInMemoryRealCallProfileRecoveryJobStore,
   createVoiceHubSpotTaskUpdateSink,
   createVoiceHubSpotTaskSyncSinks,
   createVoiceHubSpotTaskSink,

package/dist/proofTrends.d.ts

@@ -384,14 +384,45 @@ export type VoiceRealCallProfileRecoveryActionHandlerInput = {
 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: ({
@@ -427,6 +458,10 @@ export declare const buildVoiceProofTrendProfileSummaries: (input: VoiceProofTre
 export declare const buildVoiceProofTrendReportFromRealCallProfiles: (options: VoiceProofTrendRealCallProfileReportOptions) => VoiceProofTrendReport;
 export declare const buildVoiceRealCallProfileDefaults: (input: VoiceRealCallProfileHistoryReport | VoiceProofTrendReport, options?: VoiceRealCallProfileDefaultsOptions) => VoiceRealCallProfileDefaultsReport;
 export declare const buildVoiceRealCallProfileRecoveryActions: (report: VoiceRealCallProfileHistoryReport, options?: VoiceRealCallProfileRecoveryActionOptions) => VoiceRealCallProfileRecoveryAction[];
+export declare const 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;

package/dist/react/index.js

@@ -2214,6 +2214,42 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
   }
   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";
@@ -2832,6 +2868,7 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
   });
   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, {
@@ -2847,6 +2884,67 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
     }));
     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];
@@ -2859,10 +2957,19 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
         status: "fail"
       };
     }
-    const result = await handler({ actionId, report });
+    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,
@@ -2870,6 +2977,24 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
     };
   };
   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);

package/dist/vue/index.js

@@ -2135,6 +2135,42 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
   }
   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";
@@ -2753,6 +2789,7 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
   });
   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, {
@@ -2768,6 +2805,67 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
     }));
     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];
@@ -2780,10 +2878,19 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
         status: "fail"
       };
     }
-    const result = await handler({ actionId, report });
+    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,
@@ -2791,6 +2898,24 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
     };
   };
   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);

package/package.json

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