@absolutejs/voice 0.0.22-beta.384 → 0.0.22-beta.385

package/dist/client/index.js

@@ -4686,6 +4686,136 @@ var appendRealCallRecoveryActionQuery = (href, query) => {
   const search = new URLSearchParams(entries).toString();
   return `${base}${separator}${search}${hash ? `#${hash}` : ""}`;
 };
+var sleepVoiceRealCallProfileRecoveryLoop = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var describeVoiceRealCallProfileRecoveryLoopAction = (action) => [
+  action.label ?? action.id ?? "recovery action",
+  action.profileId ? `profile=${action.profileId}` : undefined,
+  action.href
+].filter(Boolean).join(" ");
+var defaultVoiceRealCallProfileRecoveryLoopActionFilter = (action, readinessCheckLabel) => action.method?.toUpperCase() === "POST" && action.sourceCheckLabel === readinessCheckLabel && typeof action.href === "string" && action.href.length > 0;
+var uniqueVoiceRealCallProfileRecoveryLoopActions = (actions) => {
+  const seen = new Set;
+  return actions.filter((action) => {
+    const key = `${action.method?.toUpperCase() ?? "GET"} ${action.href ?? ""}`;
+    if (seen.has(key)) {
+      return false;
+    }
+    seen.add(key);
+    return true;
+  });
+};
+var runVoiceRealCallProfileRecoveryLoop = async (options) => {
+  const baseUrl = options.baseUrl.replace(/\/$/, "");
+  const requestTimeoutMs = options.requestTimeoutMs ?? 5000;
+  const jobPollMs = options.jobPollMs ?? 1200;
+  const jobTimeoutMs = options.jobTimeoutMs ?? 600000;
+  const readinessCheckLabel = options.readinessCheckLabel ?? "Real-call profile history";
+  const fetchImpl = options.fetch ?? fetch;
+  const recoveryActionsHref = options.recoveryActionsHref ?? "/api/production-readiness/recovery-actions";
+  const readinessHref = options.readinessHref ?? "/api/production-readiness";
+  const refreshHref = options.refreshHref === undefined ? "/api/voice/real-call-profile-history/refresh" : options.refreshHref;
+  const jobHref = options.jobHref ?? "/api/voice/real-call-profile-history/actions";
+  const toAbsoluteUrl = (href) => new URL(href, baseUrl).toString();
+  const parseJson = async (response) => {
+    const text = await response.text();
+    try {
+      return JSON.parse(text);
+    } catch (error) {
+      throw new Error(`Expected JSON from ${response.url}, got: ${text.slice(0, 300)}`, { cause: error });
+    }
+  };
+  const fetchJson = async (href, init) => {
+    const response = await fetchImpl(toAbsoluteUrl(href), {
+      headers: { accept: "application/json", ...init?.headers },
+      ...init,
+      signal: init?.signal ?? AbortSignal.timeout(requestTimeoutMs)
+    });
+    if (!response.ok) {
+      throw new Error(`${href} returned HTTP ${String(response.status)}.`);
+    }
+    return parseJson(response);
+  };
+  const resolveJobHref = (jobId) => typeof jobHref === "function" ? jobHref(jobId) : `${jobHref.replace(/\/$/, "")}/${jobId}`;
+  const getGate = async (fresh = false) => {
+    const href = fresh ? `${readinessHref}${readinessHref.includes("?") ? "&" : "?"}voiceRecoveryLoopFresh=${String(Date.now())}` : readinessHref;
+    const readiness = await fetchJson(href);
+    return readiness.checks?.find((check) => check.label === readinessCheckLabel) ?? null;
+  };
+  const actionsResponse = await fetchJson(recoveryActionsHref);
+  const actionFilter = options.actionFilter ?? ((action) => defaultVoiceRealCallProfileRecoveryLoopActionFilter(action, readinessCheckLabel));
+  const actions = uniqueVoiceRealCallProfileRecoveryLoopActions((actionsResponse.actions ?? []).filter(actionFilter));
+  if (actions.length === 0) {
+    const realCallProfileGate2 = await getGate();
+    return {
+      actionCount: 0,
+      actions,
+      jobs: [],
+      ok: realCallProfileGate2?.status === "pass",
+      realCallProfileGate: realCallProfileGate2,
+      startFailures: []
+    };
+  }
+  options.logger?.log(`Running ${String(actions.length)} real-call profile recovery action(s) in parallel.`);
+  for (const action of actions) {
+    options.logger?.log(`- ${describeVoiceRealCallProfileRecoveryLoopAction(action)}`);
+  }
+  const starts = await Promise.allSettled(actions.map(async (action) => {
+    if (!action.href) {
+      throw new Error("Recovery action is missing href.");
+    }
+    const body = await fetchJson(action.href, { method: "POST" });
+    return { action, ...body };
+  }));
+  const startedJobs = starts.flatMap((result) => {
+    if (result.status === "rejected") {
+      return [];
+    }
+    return result.value.jobId ? [result.value] : [];
+  });
+  const startFailures = starts.flatMap((result, index) => result.status === "rejected" ? [
+    {
+      action: describeVoiceRealCallProfileRecoveryLoopAction(actions[index] ?? {}),
+      error: result.reason instanceof Error ? result.reason.message : String(result.reason)
+    }
+  ] : []);
+  const pollJob = async (jobId) => {
+    const deadline = Date.now() + jobTimeoutMs;
+    while (Date.now() < deadline) {
+      const body = await fetchJson(resolveJobHref(jobId));
+      const job = body.job;
+      if (!job) {
+        throw new Error(`Recovery job ${jobId} was not found.`);
+      }
+      if (job.status === "pass" || job.status === "fail") {
+        return job;
+      }
+      await sleepVoiceRealCallProfileRecoveryLoop(jobPollMs);
+    }
+    throw new Error(`Timed out waiting ${String(jobTimeoutMs)}ms for recovery job ${jobId}.`);
+  };
+  options.logger?.log(`Polling ${String(startedJobs.length)} recovery job(s) in parallel.`);
+  const jobResults = await Promise.allSettled(startedJobs.map((start) => pollJob(start.jobId)));
+  const jobs = jobResults.map((result, index) => ({
+    action: describeVoiceRealCallProfileRecoveryLoopAction(startedJobs[index]?.action ?? {}),
+    jobId: startedJobs[index]?.jobId,
+    result: result.status === "fulfilled" ? result.value : {
+      error: result.reason instanceof Error ? result.reason.message : String(result.reason),
+      status: "fail"
+    }
+  }));
+  if (refreshHref !== false) {
+    await fetchJson(refreshHref, { method: "POST" });
+  }
+  const realCallProfileGate = await getGate(true);
+  return {
+    actionCount: actions.length,
+    actions,
+    jobs,
+    ok: startFailures.length === 0 && jobs.every((job) => job.result.status === "pass") && realCallProfileGate?.status === "pass",
+    realCallProfileGate,
+    startFailures
+  };
+};
 var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
   const actions = [
     {

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, buildVoiceRealCallProfileRecoveryJobHistoryCheck, buildVoiceRealCallProfileRecoveryActions, createVoiceInMemoryRealCallProfileRecoveryJobStore, createVoiceRealCallProfileTraceCollector, 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 { assertVoiceProofTrendEvidence, buildEmptyVoiceProofTrendReport, buildVoiceProofTrendProfileSummaries, buildVoiceProofTrendRecommendationReport, buildVoiceProofTrendReportFromRealCallProfiles, buildVoiceProofTrendReport, buildVoiceRealCallProfileEvidenceFromTraceEvents, buildVoiceRealCallProfileDefaults, buildVoiceRealCallProfileHistoryReport, buildVoiceRealCallProfileReadinessCheck, buildVoiceRealCallProfileRecoveryJobHistoryCheck, buildVoiceRealCallProfileRecoveryActions, createVoiceInMemoryRealCallProfileRecoveryJobStore, createVoiceRealCallProfileTraceCollector, 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, runVoiceRealCallProfileRecoveryLoop, 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, VoiceRealCallProfileRecoveryJobHistoryCheckOptions, VoiceRealCallProfileRecoveryActionResult, VoiceRealCallProfileRecoveryActionRoutesOptions, VoiceRealCallProfileRecoveryJob, VoiceRealCallProfileRecoveryJobCreateInput, VoiceRealCallProfileRecoveryJobListOptions, VoiceRealCallProfileRecoveryJobStatus, VoiceRealCallProfileRecoveryJobStore, VoiceRealCallProfileRecoveryJobUpdate, VoiceSQLiteRealCallProfileRecoveryJobStoreOptions, VoiceRealCallProfileTraceCollector, VoiceRealCallProfileTraceCollectorEvidenceOptions, VoiceRealCallProfileTraceCollectorOptions, 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, VoiceRealCallProfileRecoveryJobHistoryCheckOptions, VoiceRealCallProfileRecoveryActionResult, VoiceRealCallProfileRecoveryActionRoutesOptions, VoiceRealCallProfileRecoveryJob, VoiceRealCallProfileRecoveryJobCreateInput, VoiceRealCallProfileRecoveryJobListOptions, VoiceRealCallProfileRecoveryJobStatus, VoiceRealCallProfileRecoveryJobStore, VoiceRealCallProfileRecoveryJobUpdate, VoiceRealCallProfileRecoveryLoopAction, VoiceRealCallProfileRecoveryLoopJob, VoiceRealCallProfileRecoveryLoopJobResult, VoiceRealCallProfileRecoveryLoopOptions, VoiceRealCallProfileRecoveryLoopReport, VoiceRealCallProfileRecoveryLoopStartFailure, VoiceSQLiteRealCallProfileRecoveryJobStoreOptions, VoiceRealCallProfileTraceCollector, VoiceRealCallProfileTraceCollectorEvidenceOptions, VoiceRealCallProfileTraceCollectorOptions, 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

@@ -16155,6 +16155,136 @@ var appendRealCallRecoveryActionQuery = (href, query) => {
   const search = new URLSearchParams(entries).toString();
   return `${base}${separator}${search}${hash ? `#${hash}` : ""}`;
 };
+var sleepVoiceRealCallProfileRecoveryLoop = (ms) => new Promise((resolve2) => setTimeout(resolve2, ms));
+var describeVoiceRealCallProfileRecoveryLoopAction = (action) => [
+  action.label ?? action.id ?? "recovery action",
+  action.profileId ? `profile=${action.profileId}` : undefined,
+  action.href
+].filter(Boolean).join(" ");
+var defaultVoiceRealCallProfileRecoveryLoopActionFilter = (action, readinessCheckLabel) => action.method?.toUpperCase() === "POST" && action.sourceCheckLabel === readinessCheckLabel && typeof action.href === "string" && action.href.length > 0;
+var uniqueVoiceRealCallProfileRecoveryLoopActions = (actions) => {
+  const seen = new Set;
+  return actions.filter((action) => {
+    const key = `${action.method?.toUpperCase() ?? "GET"} ${action.href ?? ""}`;
+    if (seen.has(key)) {
+      return false;
+    }
+    seen.add(key);
+    return true;
+  });
+};
+var runVoiceRealCallProfileRecoveryLoop = async (options) => {
+  const baseUrl = options.baseUrl.replace(/\/$/, "");
+  const requestTimeoutMs = options.requestTimeoutMs ?? 5000;
+  const jobPollMs = options.jobPollMs ?? 1200;
+  const jobTimeoutMs = options.jobTimeoutMs ?? 600000;
+  const readinessCheckLabel = options.readinessCheckLabel ?? "Real-call profile history";
+  const fetchImpl = options.fetch ?? fetch;
+  const recoveryActionsHref = options.recoveryActionsHref ?? "/api/production-readiness/recovery-actions";
+  const readinessHref = options.readinessHref ?? "/api/production-readiness";
+  const refreshHref = options.refreshHref === undefined ? "/api/voice/real-call-profile-history/refresh" : options.refreshHref;
+  const jobHref = options.jobHref ?? "/api/voice/real-call-profile-history/actions";
+  const toAbsoluteUrl = (href) => new URL(href, baseUrl).toString();
+  const parseJson = async (response) => {
+    const text = await response.text();
+    try {
+      return JSON.parse(text);
+    } catch (error) {
+      throw new Error(`Expected JSON from ${response.url}, got: ${text.slice(0, 300)}`, { cause: error });
+    }
+  };
+  const fetchJson = async (href, init) => {
+    const response = await fetchImpl(toAbsoluteUrl(href), {
+      headers: { accept: "application/json", ...init?.headers },
+      ...init,
+      signal: init?.signal ?? AbortSignal.timeout(requestTimeoutMs)
+    });
+    if (!response.ok) {
+      throw new Error(`${href} returned HTTP ${String(response.status)}.`);
+    }
+    return parseJson(response);
+  };
+  const resolveJobHref = (jobId) => typeof jobHref === "function" ? jobHref(jobId) : `${jobHref.replace(/\/$/, "")}/${jobId}`;
+  const getGate = async (fresh = false) => {
+    const href = fresh ? `${readinessHref}${readinessHref.includes("?") ? "&" : "?"}voiceRecoveryLoopFresh=${String(Date.now())}` : readinessHref;
+    const readiness = await fetchJson(href);
+    return readiness.checks?.find((check) => check.label === readinessCheckLabel) ?? null;
+  };
+  const actionsResponse = await fetchJson(recoveryActionsHref);
+  const actionFilter = options.actionFilter ?? ((action) => defaultVoiceRealCallProfileRecoveryLoopActionFilter(action, readinessCheckLabel));
+  const actions = uniqueVoiceRealCallProfileRecoveryLoopActions((actionsResponse.actions ?? []).filter(actionFilter));
+  if (actions.length === 0) {
+    const realCallProfileGate2 = await getGate();
+    return {
+      actionCount: 0,
+      actions,
+      jobs: [],
+      ok: realCallProfileGate2?.status === "pass",
+      realCallProfileGate: realCallProfileGate2,
+      startFailures: []
+    };
+  }
+  options.logger?.log(`Running ${String(actions.length)} real-call profile recovery action(s) in parallel.`);
+  for (const action of actions) {
+    options.logger?.log(`- ${describeVoiceRealCallProfileRecoveryLoopAction(action)}`);
+  }
+  const starts = await Promise.allSettled(actions.map(async (action) => {
+    if (!action.href) {
+      throw new Error("Recovery action is missing href.");
+    }
+    const body = await fetchJson(action.href, { method: "POST" });
+    return { action, ...body };
+  }));
+  const startedJobs = starts.flatMap((result) => {
+    if (result.status === "rejected") {
+      return [];
+    }
+    return result.value.jobId ? [result.value] : [];
+  });
+  const startFailures = starts.flatMap((result, index) => result.status === "rejected" ? [
+    {
+      action: describeVoiceRealCallProfileRecoveryLoopAction(actions[index] ?? {}),
+      error: result.reason instanceof Error ? result.reason.message : String(result.reason)
+    }
+  ] : []);
+  const pollJob = async (jobId) => {
+    const deadline = Date.now() + jobTimeoutMs;
+    while (Date.now() < deadline) {
+      const body = await fetchJson(resolveJobHref(jobId));
+      const job = body.job;
+      if (!job) {
+        throw new Error(`Recovery job ${jobId} was not found.`);
+      }
+      if (job.status === "pass" || job.status === "fail") {
+        return job;
+      }
+      await sleepVoiceRealCallProfileRecoveryLoop(jobPollMs);
+    }
+    throw new Error(`Timed out waiting ${String(jobTimeoutMs)}ms for recovery job ${jobId}.`);
+  };
+  options.logger?.log(`Polling ${String(startedJobs.length)} recovery job(s) in parallel.`);
+  const jobResults = await Promise.allSettled(startedJobs.map((start) => pollJob(start.jobId)));
+  const jobs = jobResults.map((result, index) => ({
+    action: describeVoiceRealCallProfileRecoveryLoopAction(startedJobs[index]?.action ?? {}),
+    jobId: startedJobs[index]?.jobId,
+    result: result.status === "fulfilled" ? result.value : {
+      error: result.reason instanceof Error ? result.reason.message : String(result.reason),
+      status: "fail"
+    }
+  }));
+  if (refreshHref !== false) {
+    await fetchJson(refreshHref, { method: "POST" });
+  }
+  const realCallProfileGate = await getGate(true);
+  return {
+    actionCount: actions.length,
+    actions,
+    jobs,
+    ok: startFailures.length === 0 && jobs.every((job) => job.result.status === "pass") && realCallProfileGate?.status === "pass",
+    realCallProfileGate,
+    startFailures
+  };
+};
 var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
   const actions = [
     {
@@ -39019,6 +39149,7 @@ export {
   runVoiceScenarioFixtureEvals,
   runVoiceScenarioEvals,
   runVoiceReconnectContract,
+  runVoiceRealCallProfileRecoveryLoop,
   runVoiceProviderRoutingContract,
   runVoiceProfileSwitchPolicyProof,
   runVoicePhoneAgentProductionSmokeContract,

package/dist/proofTrends.d.ts

@@ -1,6 +1,6 @@
 import { Elysia } from 'elysia';
 import type { Database } from 'bun:sqlite';
-import type { VoiceProductionReadinessAction, VoiceProductionReadinessCheck } from './productionReadiness';
+import type { VoiceProductionReadinessAction, VoiceProductionReadinessCheck, VoiceReadinessRecoveryAction } from './productionReadiness';
 import type { StoredVoiceTraceEvent, VoiceTraceEventStore } from './trace';
 export type VoiceProofTrendStatus = 'empty' | 'fail' | 'pass' | 'stale';
 export type VoiceProofTrendSummary = {
@@ -469,6 +469,46 @@ export type VoiceRealCallProfileRecoveryActionRoutesOptions = VoiceRealCallProfi
     handlers?: Partial<Record<VoiceRealCallProfileRecoveryActionId, VoiceRealCallProfileRecoveryActionHandler>>;
     jobStore?: VoiceRealCallProfileRecoveryJobStore;
 };
+export type VoiceRealCallProfileRecoveryLoopAction = Partial<VoiceReadinessRecoveryAction> & Partial<VoiceRealCallProfileRecoveryAction> & {
+    href?: string;
+    method?: string;
+};
+export type VoiceRealCallProfileRecoveryLoopJob = Partial<VoiceRealCallProfileRecoveryJob> & {
+    error?: string;
+    id?: string;
+    status?: string;
+};
+export type VoiceRealCallProfileRecoveryLoopJobResult = {
+    action: string;
+    jobId?: string;
+    result: VoiceRealCallProfileRecoveryLoopJob;
+};
+export type VoiceRealCallProfileRecoveryLoopStartFailure = {
+    action: string;
+    error: string;
+};
+export type VoiceRealCallProfileRecoveryLoopReport = {
+    actionCount: number;
+    actions: VoiceRealCallProfileRecoveryLoopAction[];
+    jobs: VoiceRealCallProfileRecoveryLoopJobResult[];
+    ok: boolean;
+    realCallProfileGate: VoiceProductionReadinessCheck | null;
+    startFailures: VoiceRealCallProfileRecoveryLoopStartFailure[];
+};
+export type VoiceRealCallProfileRecoveryLoopOptions = {
+    actionFilter?: (action: VoiceRealCallProfileRecoveryLoopAction) => boolean;
+    baseUrl: string;
+    fetch?: typeof fetch;
+    jobHref?: string | ((jobId: string) => string);
+    jobPollMs?: number;
+    jobTimeoutMs?: number;
+    logger?: Pick<Console, 'log'>;
+    readinessCheckLabel?: string;
+    readinessHref?: string;
+    recoveryActionsHref?: string;
+    refreshHref?: false | string;
+    requestTimeoutMs?: number;
+};
 export declare const DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS: number;
 export declare const DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS: ({
     description: string;
@@ -503,6 +543,7 @@ export declare const createVoiceRealCallProfileTraceCollector: <TEvent extends S
 export declare const buildVoiceProofTrendProfileSummaries: (input: VoiceProofTrendReport | readonly VoiceProofTrendReport[], options?: VoiceProofTrendProfileSummaryOptions) => VoiceProofTrendProfileSummary[];
 export declare const buildVoiceProofTrendReportFromRealCallProfiles: (options: VoiceProofTrendRealCallProfileReportOptions) => VoiceProofTrendReport;
 export declare const buildVoiceRealCallProfileDefaults: (input: VoiceRealCallProfileHistoryReport | VoiceProofTrendReport, options?: VoiceRealCallProfileDefaultsOptions) => VoiceRealCallProfileDefaultsReport;
+export declare const runVoiceRealCallProfileRecoveryLoop: (options: VoiceRealCallProfileRecoveryLoopOptions) => Promise<VoiceRealCallProfileRecoveryLoopReport>;
 export declare const buildVoiceRealCallProfileRecoveryActions: (report: VoiceRealCallProfileHistoryReport, options?: VoiceRealCallProfileRecoveryActionOptions) => VoiceRealCallProfileRecoveryAction[];
 export declare const createVoiceInMemoryRealCallProfileRecoveryJobStore: (options?: {
     idPrefix?: string;

package/dist/react/index.js

@@ -2273,6 +2273,136 @@ var appendRealCallRecoveryActionQuery = (href, query) => {
   const search = new URLSearchParams(entries).toString();
   return `${base}${separator}${search}${hash ? `#${hash}` : ""}`;
 };
+var sleepVoiceRealCallProfileRecoveryLoop = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var describeVoiceRealCallProfileRecoveryLoopAction = (action) => [
+  action.label ?? action.id ?? "recovery action",
+  action.profileId ? `profile=${action.profileId}` : undefined,
+  action.href
+].filter(Boolean).join(" ");
+var defaultVoiceRealCallProfileRecoveryLoopActionFilter = (action, readinessCheckLabel) => action.method?.toUpperCase() === "POST" && action.sourceCheckLabel === readinessCheckLabel && typeof action.href === "string" && action.href.length > 0;
+var uniqueVoiceRealCallProfileRecoveryLoopActions = (actions) => {
+  const seen = new Set;
+  return actions.filter((action) => {
+    const key = `${action.method?.toUpperCase() ?? "GET"} ${action.href ?? ""}`;
+    if (seen.has(key)) {
+      return false;
+    }
+    seen.add(key);
+    return true;
+  });
+};
+var runVoiceRealCallProfileRecoveryLoop = async (options) => {
+  const baseUrl = options.baseUrl.replace(/\/$/, "");
+  const requestTimeoutMs = options.requestTimeoutMs ?? 5000;
+  const jobPollMs = options.jobPollMs ?? 1200;
+  const jobTimeoutMs = options.jobTimeoutMs ?? 600000;
+  const readinessCheckLabel = options.readinessCheckLabel ?? "Real-call profile history";
+  const fetchImpl = options.fetch ?? fetch;
+  const recoveryActionsHref = options.recoveryActionsHref ?? "/api/production-readiness/recovery-actions";
+  const readinessHref = options.readinessHref ?? "/api/production-readiness";
+  const refreshHref = options.refreshHref === undefined ? "/api/voice/real-call-profile-history/refresh" : options.refreshHref;
+  const jobHref = options.jobHref ?? "/api/voice/real-call-profile-history/actions";
+  const toAbsoluteUrl = (href) => new URL(href, baseUrl).toString();
+  const parseJson = async (response) => {
+    const text = await response.text();
+    try {
+      return JSON.parse(text);
+    } catch (error) {
+      throw new Error(`Expected JSON from ${response.url}, got: ${text.slice(0, 300)}`, { cause: error });
+    }
+  };
+  const fetchJson = async (href, init) => {
+    const response = await fetchImpl(toAbsoluteUrl(href), {
+      headers: { accept: "application/json", ...init?.headers },
+      ...init,
+      signal: init?.signal ?? AbortSignal.timeout(requestTimeoutMs)
+    });
+    if (!response.ok) {
+      throw new Error(`${href} returned HTTP ${String(response.status)}.`);
+    }
+    return parseJson(response);
+  };
+  const resolveJobHref = (jobId) => typeof jobHref === "function" ? jobHref(jobId) : `${jobHref.replace(/\/$/, "")}/${jobId}`;
+  const getGate = async (fresh = false) => {
+    const href = fresh ? `${readinessHref}${readinessHref.includes("?") ? "&" : "?"}voiceRecoveryLoopFresh=${String(Date.now())}` : readinessHref;
+    const readiness = await fetchJson(href);
+    return readiness.checks?.find((check) => check.label === readinessCheckLabel) ?? null;
+  };
+  const actionsResponse = await fetchJson(recoveryActionsHref);
+  const actionFilter = options.actionFilter ?? ((action) => defaultVoiceRealCallProfileRecoveryLoopActionFilter(action, readinessCheckLabel));
+  const actions = uniqueVoiceRealCallProfileRecoveryLoopActions((actionsResponse.actions ?? []).filter(actionFilter));
+  if (actions.length === 0) {
+    const realCallProfileGate2 = await getGate();
+    return {
+      actionCount: 0,
+      actions,
+      jobs: [],
+      ok: realCallProfileGate2?.status === "pass",
+      realCallProfileGate: realCallProfileGate2,
+      startFailures: []
+    };
+  }
+  options.logger?.log(`Running ${String(actions.length)} real-call profile recovery action(s) in parallel.`);
+  for (const action of actions) {
+    options.logger?.log(`- ${describeVoiceRealCallProfileRecoveryLoopAction(action)}`);
+  }
+  const starts = await Promise.allSettled(actions.map(async (action) => {
+    if (!action.href) {
+      throw new Error("Recovery action is missing href.");
+    }
+    const body = await fetchJson(action.href, { method: "POST" });
+    return { action, ...body };
+  }));
+  const startedJobs = starts.flatMap((result) => {
+    if (result.status === "rejected") {
+      return [];
+    }
+    return result.value.jobId ? [result.value] : [];
+  });
+  const startFailures = starts.flatMap((result, index) => result.status === "rejected" ? [
+    {
+      action: describeVoiceRealCallProfileRecoveryLoopAction(actions[index] ?? {}),
+      error: result.reason instanceof Error ? result.reason.message : String(result.reason)
+    }
+  ] : []);
+  const pollJob = async (jobId) => {
+    const deadline = Date.now() + jobTimeoutMs;
+    while (Date.now() < deadline) {
+      const body = await fetchJson(resolveJobHref(jobId));
+      const job = body.job;
+      if (!job) {
+        throw new Error(`Recovery job ${jobId} was not found.`);
+      }
+      if (job.status === "pass" || job.status === "fail") {
+        return job;
+      }
+      await sleepVoiceRealCallProfileRecoveryLoop(jobPollMs);
+    }
+    throw new Error(`Timed out waiting ${String(jobTimeoutMs)}ms for recovery job ${jobId}.`);
+  };
+  options.logger?.log(`Polling ${String(startedJobs.length)} recovery job(s) in parallel.`);
+  const jobResults = await Promise.allSettled(startedJobs.map((start) => pollJob(start.jobId)));
+  const jobs = jobResults.map((result, index) => ({
+    action: describeVoiceRealCallProfileRecoveryLoopAction(startedJobs[index]?.action ?? {}),
+    jobId: startedJobs[index]?.jobId,
+    result: result.status === "fulfilled" ? result.value : {
+      error: result.reason instanceof Error ? result.reason.message : String(result.reason),
+      status: "fail"
+    }
+  }));
+  if (refreshHref !== false) {
+    await fetchJson(refreshHref, { method: "POST" });
+  }
+  const realCallProfileGate = await getGate(true);
+  return {
+    actionCount: actions.length,
+    actions,
+    jobs,
+    ok: startFailures.length === 0 && jobs.every((job) => job.result.status === "pass") && realCallProfileGate?.status === "pass",
+    realCallProfileGate,
+    startFailures
+  };
+};
 var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
   const actions = [
     {

package/dist/vue/index.js

@@ -2194,6 +2194,136 @@ var appendRealCallRecoveryActionQuery = (href, query) => {
   const search = new URLSearchParams(entries).toString();
   return `${base}${separator}${search}${hash ? `#${hash}` : ""}`;
 };
+var sleepVoiceRealCallProfileRecoveryLoop = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var describeVoiceRealCallProfileRecoveryLoopAction = (action) => [
+  action.label ?? action.id ?? "recovery action",
+  action.profileId ? `profile=${action.profileId}` : undefined,
+  action.href
+].filter(Boolean).join(" ");
+var defaultVoiceRealCallProfileRecoveryLoopActionFilter = (action, readinessCheckLabel) => action.method?.toUpperCase() === "POST" && action.sourceCheckLabel === readinessCheckLabel && typeof action.href === "string" && action.href.length > 0;
+var uniqueVoiceRealCallProfileRecoveryLoopActions = (actions) => {
+  const seen = new Set;
+  return actions.filter((action) => {
+    const key = `${action.method?.toUpperCase() ?? "GET"} ${action.href ?? ""}`;
+    if (seen.has(key)) {
+      return false;
+    }
+    seen.add(key);
+    return true;
+  });
+};
+var runVoiceRealCallProfileRecoveryLoop = async (options) => {
+  const baseUrl = options.baseUrl.replace(/\/$/, "");
+  const requestTimeoutMs = options.requestTimeoutMs ?? 5000;
+  const jobPollMs = options.jobPollMs ?? 1200;
+  const jobTimeoutMs = options.jobTimeoutMs ?? 600000;
+  const readinessCheckLabel = options.readinessCheckLabel ?? "Real-call profile history";
+  const fetchImpl = options.fetch ?? fetch;
+  const recoveryActionsHref = options.recoveryActionsHref ?? "/api/production-readiness/recovery-actions";
+  const readinessHref = options.readinessHref ?? "/api/production-readiness";
+  const refreshHref = options.refreshHref === undefined ? "/api/voice/real-call-profile-history/refresh" : options.refreshHref;
+  const jobHref = options.jobHref ?? "/api/voice/real-call-profile-history/actions";
+  const toAbsoluteUrl = (href) => new URL(href, baseUrl).toString();
+  const parseJson = async (response) => {
+    const text = await response.text();
+    try {
+      return JSON.parse(text);
+    } catch (error) {
+      throw new Error(`Expected JSON from ${response.url}, got: ${text.slice(0, 300)}`, { cause: error });
+    }
+  };
+  const fetchJson = async (href, init) => {
+    const response = await fetchImpl(toAbsoluteUrl(href), {
+      headers: { accept: "application/json", ...init?.headers },
+      ...init,
+      signal: init?.signal ?? AbortSignal.timeout(requestTimeoutMs)
+    });
+    if (!response.ok) {
+      throw new Error(`${href} returned HTTP ${String(response.status)}.`);
+    }
+    return parseJson(response);
+  };
+  const resolveJobHref = (jobId) => typeof jobHref === "function" ? jobHref(jobId) : `${jobHref.replace(/\/$/, "")}/${jobId}`;
+  const getGate = async (fresh = false) => {
+    const href = fresh ? `${readinessHref}${readinessHref.includes("?") ? "&" : "?"}voiceRecoveryLoopFresh=${String(Date.now())}` : readinessHref;
+    const readiness = await fetchJson(href);
+    return readiness.checks?.find((check) => check.label === readinessCheckLabel) ?? null;
+  };
+  const actionsResponse = await fetchJson(recoveryActionsHref);
+  const actionFilter = options.actionFilter ?? ((action) => defaultVoiceRealCallProfileRecoveryLoopActionFilter(action, readinessCheckLabel));
+  const actions = uniqueVoiceRealCallProfileRecoveryLoopActions((actionsResponse.actions ?? []).filter(actionFilter));
+  if (actions.length === 0) {
+    const realCallProfileGate2 = await getGate();
+    return {
+      actionCount: 0,
+      actions,
+      jobs: [],
+      ok: realCallProfileGate2?.status === "pass",
+      realCallProfileGate: realCallProfileGate2,
+      startFailures: []
+    };
+  }
+  options.logger?.log(`Running ${String(actions.length)} real-call profile recovery action(s) in parallel.`);
+  for (const action of actions) {
+    options.logger?.log(`- ${describeVoiceRealCallProfileRecoveryLoopAction(action)}`);
+  }
+  const starts = await Promise.allSettled(actions.map(async (action) => {
+    if (!action.href) {
+      throw new Error("Recovery action is missing href.");
+    }
+    const body = await fetchJson(action.href, { method: "POST" });
+    return { action, ...body };
+  }));
+  const startedJobs = starts.flatMap((result) => {
+    if (result.status === "rejected") {
+      return [];
+    }
+    return result.value.jobId ? [result.value] : [];
+  });
+  const startFailures = starts.flatMap((result, index) => result.status === "rejected" ? [
+    {
+      action: describeVoiceRealCallProfileRecoveryLoopAction(actions[index] ?? {}),
+      error: result.reason instanceof Error ? result.reason.message : String(result.reason)
+    }
+  ] : []);
+  const pollJob = async (jobId) => {
+    const deadline = Date.now() + jobTimeoutMs;
+    while (Date.now() < deadline) {
+      const body = await fetchJson(resolveJobHref(jobId));
+      const job = body.job;
+      if (!job) {
+        throw new Error(`Recovery job ${jobId} was not found.`);
+      }
+      if (job.status === "pass" || job.status === "fail") {
+        return job;
+      }
+      await sleepVoiceRealCallProfileRecoveryLoop(jobPollMs);
+    }
+    throw new Error(`Timed out waiting ${String(jobTimeoutMs)}ms for recovery job ${jobId}.`);
+  };
+  options.logger?.log(`Polling ${String(startedJobs.length)} recovery job(s) in parallel.`);
+  const jobResults = await Promise.allSettled(startedJobs.map((start) => pollJob(start.jobId)));
+  const jobs = jobResults.map((result, index) => ({
+    action: describeVoiceRealCallProfileRecoveryLoopAction(startedJobs[index]?.action ?? {}),
+    jobId: startedJobs[index]?.jobId,
+    result: result.status === "fulfilled" ? result.value : {
+      error: result.reason instanceof Error ? result.reason.message : String(result.reason),
+      status: "fail"
+    }
+  }));
+  if (refreshHref !== false) {
+    await fetchJson(refreshHref, { method: "POST" });
+  }
+  const realCallProfileGate = await getGate(true);
+  return {
+    actionCount: actions.length,
+    actions,
+    jobs,
+    ok: startFailures.length === 0 && jobs.every((job) => job.result.status === "pass") && realCallProfileGate?.status === "pass",
+    realCallProfileGate,
+    startFailures
+  };
+};
 var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
   const actions = [
     {

package/package.json

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