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

package/README.md

@@ -1519,6 +1519,32 @@ 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 the SQLite job store when recovery jobs should survive restarts:
+
+```ts
+const recoveryJobs = createVoiceSQLiteRealCallProfileRecoveryJobStore({
+	path: '.voice-runtime/real-call-recovery/jobs.sqlite'
+});
+```
+
 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

@@ -3907,6 +3907,7 @@ var defineVoicePlatformCoverageElement = (tagName = "absolute-voice-platform-cov
 };
 // src/proofTrends.ts
 import { Elysia } from "elysia";
+import { Database } from "bun:sqlite";
 var DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS = 24 * 60 * 60 * 1000;
 var DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS = [
   {
@@ -4627,6 +4628,98 @@ 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 normalizeRealCallRecoveryJobTableName = (value) => value.trim().replace(/[^a-zA-Z0-9_]+/g, "_").replace(/^_+|_+$/g, "") || "voice_real_call_profile_recovery_jobs";
+var createVoiceSQLiteRealCallProfileRecoveryJobStore = (options = {}) => {
+  const database = options.database ?? new Database(options.path ?? ":memory:", {
+    create: true
+  });
+  const tableName = normalizeRealCallRecoveryJobTableName(options.tableName ?? "voice_real_call_profile_recovery_jobs");
+  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)}`;
+  database.exec("PRAGMA journal_mode = WAL;");
+  database.exec("PRAGMA synchronous = NORMAL;");
+  database.exec("PRAGMA busy_timeout = 5000;");
+  database.exec(`CREATE TABLE IF NOT EXISTS "${tableName}" (
+			id TEXT PRIMARY KEY,
+			sort_at INTEGER NOT NULL,
+			payload TEXT NOT NULL
+		)`);
+  const selectStatement = database.query(`SELECT payload FROM "${tableName}" WHERE id = ?1 LIMIT 1`);
+  const upsertStatement = database.query(`INSERT INTO "${tableName}" (id, sort_at, payload)
+		 VALUES (?1, ?2, ?3)
+		 ON CONFLICT(id) DO UPDATE SET sort_at = excluded.sort_at, payload = excluded.payload`);
+  const writeJob = (job) => {
+    upsertStatement.run(job.id, Date.parse(job.updatedAt) || Date.now(), JSON.stringify(job));
+    return job;
+  };
+  const readJob = (id) => {
+    const row = selectStatement.get(id);
+    return row ? JSON.parse(row.payload) : undefined;
+  };
+  return {
+    create(input) {
+      const createdAt = input.createdAt ?? now();
+      return writeJob({
+        actionId: input.actionId,
+        createdAt,
+        id: input.id ?? createId(),
+        message: input.message,
+        status: input.status ?? "queued",
+        updatedAt: createdAt
+      });
+    },
+    get(id) {
+      return readJob(id);
+    },
+    update(id, update) {
+      const existing = readJob(id);
+      if (!existing) {
+        return;
+      }
+      return writeJob({
+        ...existing,
+        ...update,
+        updatedAt: update.updatedAt ?? now()
+      });
+    }
+  };
+};
 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 +5338,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 +5354,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 +5427,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 +5447,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, createVoiceSQLiteRealCallProfileRecoveryJobStore, 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, VoiceSQLiteRealCallProfileRecoveryJobStoreOptions, 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

@@ -15376,6 +15376,7 @@ var createVoiceCompetitiveCoverageRoutes = (options) => {
 };
 // src/proofTrends.ts
 import { Elysia as Elysia22 } from "elysia";
+import { Database } from "bun:sqlite";
 var DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS = 24 * 60 * 60 * 1000;
 var DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS = [
   {
@@ -16096,6 +16097,98 @@ 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 normalizeRealCallRecoveryJobTableName = (value) => value.trim().replace(/[^a-zA-Z0-9_]+/g, "_").replace(/^_+|_+$/g, "") || "voice_real_call_profile_recovery_jobs";
+var createVoiceSQLiteRealCallProfileRecoveryJobStore = (options = {}) => {
+  const database = options.database ?? new Database(options.path ?? ":memory:", {
+    create: true
+  });
+  const tableName = normalizeRealCallRecoveryJobTableName(options.tableName ?? "voice_real_call_profile_recovery_jobs");
+  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)}`;
+  database.exec("PRAGMA journal_mode = WAL;");
+  database.exec("PRAGMA synchronous = NORMAL;");
+  database.exec("PRAGMA busy_timeout = 5000;");
+  database.exec(`CREATE TABLE IF NOT EXISTS "${tableName}" (
+			id TEXT PRIMARY KEY,
+			sort_at INTEGER NOT NULL,
+			payload TEXT NOT NULL
+		)`);
+  const selectStatement = database.query(`SELECT payload FROM "${tableName}" WHERE id = ?1 LIMIT 1`);
+  const upsertStatement = database.query(`INSERT INTO "${tableName}" (id, sort_at, payload)
+		 VALUES (?1, ?2, ?3)
+		 ON CONFLICT(id) DO UPDATE SET sort_at = excluded.sort_at, payload = excluded.payload`);
+  const writeJob = (job) => {
+    upsertStatement.run(job.id, Date.parse(job.updatedAt) || Date.now(), JSON.stringify(job));
+    return job;
+  };
+  const readJob = (id) => {
+    const row = selectStatement.get(id);
+    return row ? JSON.parse(row.payload) : undefined;
+  };
+  return {
+    create(input) {
+      const createdAt = input.createdAt ?? now();
+      return writeJob({
+        actionId: input.actionId,
+        createdAt,
+        id: input.id ?? createId3(),
+        message: input.message,
+        status: input.status ?? "queued",
+        updatedAt: createdAt
+      });
+    },
+    get(id) {
+      return readJob(id);
+    },
+    update(id, update) {
+      const existing = readJob(id);
+      if (!existing) {
+        return;
+      }
+      return writeJob({
+        ...existing,
+        ...update,
+        updatedAt: update.updatedAt ?? now()
+      });
+    }
+  };
+};
 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 +16807,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 +16823,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 +16896,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 +16916,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);
@@ -23437,7 +23619,7 @@ import { Elysia as Elysia45 } from "elysia";
 
 // src/telephony/plivo.ts
 import { Buffer as Buffer5 } from "buffer";
-import { Database } from "bun:sqlite";
+import { Database as Database2 } from "bun:sqlite";
 import { Elysia as Elysia41 } from "elysia";
 
 // src/telephony/contract.ts
@@ -24564,7 +24746,7 @@ var resolvePlivoNonceTableName = (input) => {
 };
 var getPlivoNonceExpiresAt = (ttlSeconds) => typeof ttlSeconds === "number" && ttlSeconds > 0 ? Date.now() + Math.ceil(ttlSeconds * 1000) : null;
 var createVoiceSQLitePlivoWebhookNonceStore = (options) => {
-  const database = options.database ?? new Database(options.path ?? ":memory:", {
+  const database = options.database ?? new Database2(options.path ?? ":memory:", {
     create: true
   });
   const tableName = resolvePlivoNonceTableName({
@@ -24964,7 +25146,7 @@ var createPlivoVoiceRoutes = (options = {}) => {
 
 // src/telephony/telnyx.ts
 import { Buffer as Buffer6 } from "buffer";
-import { Database as Database2 } from "bun:sqlite";
+import { Database as Database3 } from "bun:sqlite";
 import { Elysia as Elysia42 } from "elysia";
 var escapeXml4 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&apos;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
 var escapeHtml42 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
@@ -25164,7 +25346,7 @@ var resolveTelnyxEventTableName = (input) => {
 };
 var getTelnyxEventExpiresAt = (ttlSeconds) => typeof ttlSeconds === "number" && ttlSeconds > 0 ? Date.now() + Math.ceil(ttlSeconds * 1000) : null;
 var createVoiceSQLiteTelnyxWebhookEventStore = (options) => {
-  const database = options.database ?? new Database2(options.path ?? ":memory:", {
+  const database = options.database ?? new Database3(options.path ?? ":memory:", {
     create: true
   });
   const tableName = resolveTelnyxEventTableName({
@@ -28895,7 +29077,7 @@ var createVoicePostgresRuntimeStorage = (options) => {
 };
 
 // src/sqliteStore.ts
-import { Database as Database3 } from "bun:sqlite";
+import { Database as Database4 } from "bun:sqlite";
 var normalizeTableNameSegment = (value) => value.trim().replace(/[^a-zA-Z0-9_]+/g, "_").replace(/^_+|_+$/g, "") || "voice";
 var resolveTableName = (input) => {
   if (input.options.tableName) {
@@ -28906,7 +29088,7 @@ var resolveTableName = (input) => {
   return `${prefix}_${fallback}`;
 };
 var openVoiceSQLiteDatabase = (path) => {
-  const database = new Database3(path, {
+  const database = new Database4(path, {
     create: true
   });
   database.exec("PRAGMA journal_mode = WAL;");
@@ -29685,7 +29867,7 @@ var createVoiceOpsRecoveryRoutes = (options = {}) => {
 
 // src/observabilityExport.ts
 import { Elysia as Elysia53 } from "elysia";
-import { Database as Database4 } from "bun:sqlite";
+import { Database as Database5 } from "bun:sqlite";
 import { createHash } from "crypto";
 import { mkdir as mkdir4, readFile as readFile2, stat, unlink } from "fs/promises";
 import { join as join3 } from "path";
@@ -31304,7 +31486,7 @@ var loadVoiceObservabilityExportReplaySource = async (source) => {
     if (!source.database && !source.path) {
       throw new Error("SQLite observability export replay requires source.database or source.path.");
     }
-    const database = source.database ?? new Database4(source.path, { create: false });
+    const database = source.database ?? new Database5(source.path, { create: false });
     const table2 = quoteObservabilityIdentifier(normalizeObservabilityIdentifier(source.tableName));
     const row2 = database.query(`SELECT manifest_json, artifact_index_json, payload_json FROM ${table2} WHERE run_id = $runId`).get({ $runId: source.runId });
     if (!row2) {
@@ -31381,7 +31563,7 @@ var deliverObservabilityExportToSQLite = async (input) => {
   if (!input.destination.database && !input.destination.path) {
     throw new Error("SQLite observability export delivery requires destination.database or destination.path.");
   }
-  const database = input.destination.database ?? new Database4(input.destination.path, { create: true });
+  const database = input.destination.database ?? new Database5(input.destination.path, { create: true });
   const table = quoteObservabilityIdentifier(normalizeObservabilityIdentifier(input.destination.tableName));
   const record = buildObservabilityExportDatabaseRecord(input);
   database.exec(`CREATE TABLE IF NOT EXISTS ${table} (
@@ -38813,6 +38995,7 @@ export {
   createVoiceSQLiteSessionStore,
   createVoiceSQLiteRuntimeStorage,
   createVoiceSQLiteReviewStore,
+  createVoiceSQLiteRealCallProfileRecoveryJobStore,
   createVoiceSQLitePlivoWebhookNonceStore,
   createVoiceSQLiteIntegrationEventStore,
   createVoiceSQLiteExternalObjectMapStore,
@@ -38932,6 +39115,7 @@ export {
   createVoiceIntegrationHTTPSink,
   createVoiceIntegrationEvent,
   createVoiceIncidentBundleRoutes,
+  createVoiceInMemoryRealCallProfileRecoveryJobStore,
   createVoiceHubSpotTaskUpdateSink,
   createVoiceHubSpotTaskSyncSinks,
   createVoiceHubSpotTaskSink,

package/dist/proofTrends.d.ts

@@ -1,4 +1,5 @@
 import { Elysia } from 'elysia';
+import { Database } from 'bun:sqlite';
 import type { VoiceProductionReadinessAction, VoiceProductionReadinessCheck } from './productionReadiness';
 import type { StoredVoiceTraceEvent, VoiceTraceEventStore } from './trace';
 export type VoiceProofTrendStatus = 'empty' | 'fail' | 'pass' | 'stale';
@@ -384,14 +385,52 @@ 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 VoiceSQLiteRealCallProfileRecoveryJobStoreOptions = {
+    database?: Database;
+    idPrefix?: string;
+    now?: () => Date;
+    path?: string;
+    tableName?: string;
+};
 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 +466,11 @@ 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 createVoiceSQLiteRealCallProfileRecoveryJobStore: (options?: VoiceSQLiteRealCallProfileRecoveryJobStoreOptions) => 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

@@ -1494,6 +1494,7 @@ var useVoiceProofTrends = (path = "/api/voice/proof-trends", options = {}) => {
 
 // src/proofTrends.ts
 import { Elysia } from "elysia";
+import { Database } from "bun:sqlite";
 var DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS = 24 * 60 * 60 * 1000;
 var DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS = [
   {
@@ -2214,6 +2215,98 @@ 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 normalizeRealCallRecoveryJobTableName = (value) => value.trim().replace(/[^a-zA-Z0-9_]+/g, "_").replace(/^_+|_+$/g, "") || "voice_real_call_profile_recovery_jobs";
+var createVoiceSQLiteRealCallProfileRecoveryJobStore = (options = {}) => {
+  const database = options.database ?? new Database(options.path ?? ":memory:", {
+    create: true
+  });
+  const tableName = normalizeRealCallRecoveryJobTableName(options.tableName ?? "voice_real_call_profile_recovery_jobs");
+  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)}`;
+  database.exec("PRAGMA journal_mode = WAL;");
+  database.exec("PRAGMA synchronous = NORMAL;");
+  database.exec("PRAGMA busy_timeout = 5000;");
+  database.exec(`CREATE TABLE IF NOT EXISTS "${tableName}" (
+			id TEXT PRIMARY KEY,
+			sort_at INTEGER NOT NULL,
+			payload TEXT NOT NULL
+		)`);
+  const selectStatement = database.query(`SELECT payload FROM "${tableName}" WHERE id = ?1 LIMIT 1`);
+  const upsertStatement = database.query(`INSERT INTO "${tableName}" (id, sort_at, payload)
+		 VALUES (?1, ?2, ?3)
+		 ON CONFLICT(id) DO UPDATE SET sort_at = excluded.sort_at, payload = excluded.payload`);
+  const writeJob = (job) => {
+    upsertStatement.run(job.id, Date.parse(job.updatedAt) || Date.now(), JSON.stringify(job));
+    return job;
+  };
+  const readJob = (id) => {
+    const row = selectStatement.get(id);
+    return row ? JSON.parse(row.payload) : undefined;
+  };
+  return {
+    create(input) {
+      const createdAt = input.createdAt ?? now();
+      return writeJob({
+        actionId: input.actionId,
+        createdAt,
+        id: input.id ?? createId(),
+        message: input.message,
+        status: input.status ?? "queued",
+        updatedAt: createdAt
+      });
+    },
+    get(id) {
+      return readJob(id);
+    },
+    update(id, update) {
+      const existing = readJob(id);
+      if (!existing) {
+        return;
+      }
+      return writeJob({
+        ...existing,
+        ...update,
+        updatedAt: update.updatedAt ?? now()
+      });
+    }
+  };
+};
 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 +2925,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 +2941,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 +3014,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 +3034,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

@@ -1415,6 +1415,7 @@ import { defineComponent as defineComponent5, h as h5 } from "vue";
 
 // src/proofTrends.ts
 import { Elysia } from "elysia";
+import { Database } from "bun:sqlite";
 var DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS = 24 * 60 * 60 * 1000;
 var DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS = [
   {
@@ -2135,6 +2136,98 @@ 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 normalizeRealCallRecoveryJobTableName = (value) => value.trim().replace(/[^a-zA-Z0-9_]+/g, "_").replace(/^_+|_+$/g, "") || "voice_real_call_profile_recovery_jobs";
+var createVoiceSQLiteRealCallProfileRecoveryJobStore = (options = {}) => {
+  const database = options.database ?? new Database(options.path ?? ":memory:", {
+    create: true
+  });
+  const tableName = normalizeRealCallRecoveryJobTableName(options.tableName ?? "voice_real_call_profile_recovery_jobs");
+  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)}`;
+  database.exec("PRAGMA journal_mode = WAL;");
+  database.exec("PRAGMA synchronous = NORMAL;");
+  database.exec("PRAGMA busy_timeout = 5000;");
+  database.exec(`CREATE TABLE IF NOT EXISTS "${tableName}" (
+			id TEXT PRIMARY KEY,
+			sort_at INTEGER NOT NULL,
+			payload TEXT NOT NULL
+		)`);
+  const selectStatement = database.query(`SELECT payload FROM "${tableName}" WHERE id = ?1 LIMIT 1`);
+  const upsertStatement = database.query(`INSERT INTO "${tableName}" (id, sort_at, payload)
+		 VALUES (?1, ?2, ?3)
+		 ON CONFLICT(id) DO UPDATE SET sort_at = excluded.sort_at, payload = excluded.payload`);
+  const writeJob = (job) => {
+    upsertStatement.run(job.id, Date.parse(job.updatedAt) || Date.now(), JSON.stringify(job));
+    return job;
+  };
+  const readJob = (id) => {
+    const row = selectStatement.get(id);
+    return row ? JSON.parse(row.payload) : undefined;
+  };
+  return {
+    create(input) {
+      const createdAt = input.createdAt ?? now();
+      return writeJob({
+        actionId: input.actionId,
+        createdAt,
+        id: input.id ?? createId(),
+        message: input.message,
+        status: input.status ?? "queued",
+        updatedAt: createdAt
+      });
+    },
+    get(id) {
+      return readJob(id);
+    },
+    update(id, update) {
+      const existing = readJob(id);
+      if (!existing) {
+        return;
+      }
+      return writeJob({
+        ...existing,
+        ...update,
+        updatedAt: update.updatedAt ?? now()
+      });
+    }
+  };
+};
 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 +2846,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 +2862,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 +2935,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 +2955,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.374",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",