@absolutejs/voice 0.0.22-beta.361 → 0.0.22-beta.363

package/dist/index.d.ts

@@ -31,8 +31,8 @@ export { assertVoiceCompetitiveCoverage, buildVoiceCompetitiveCoverageReport, cr
 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, buildVoiceRealCallProfileDefaults, buildVoiceRealCallProfileHistoryReport, createVoiceProofTrendRecommendationRoutes, createVoiceProofTrendRoutes, createVoiceRealCallProfileHistoryRoutes, DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS, DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS, evaluateVoiceProofTrendEvidence, formatVoiceProofTrendAge, normalizeVoiceProofTrendReport, readVoiceProofTrendReportFile, renderVoiceProofTrendRecommendationHTML, renderVoiceProofTrendRecommendationMarkdown, renderVoiceRealCallProfileHistoryHTML, renderVoiceRealCallProfileHistoryMarkdown, resolveVoiceRealCallProfileProviderRoute } from './proofTrends';
-export { applyVoiceProfileSwitchGuard, buildVoiceProfileSwitchLiveDecisionReport, createVoiceProfileSwitchLiveDecisionRoutes, createVoiceProfileSwitchPolicyProofRoutes, recommendVoiceProfileSwitch, renderVoiceProfileSwitchLiveDecisionHTML, renderVoiceProfileSwitchPolicyProofHTML, runVoiceProfileSwitchPolicyProof } from './profileSwitchRecommendation';
-export type { VoiceProfileSwitchGuardAction, VoiceProfileSwitchGuardDecision, VoiceProfileSwitchGuardMode, VoiceProfileSwitchGuardOptions, VoiceProfileSwitchObservedSignals, VoiceProfileSwitchLiveDecisionEvidence, VoiceProfileSwitchLiveDecisionReport, VoiceProfileSwitchLiveDecisionReportOptions, VoiceProfileSwitchLiveDecisionRoutesOptions, VoiceProfileSwitchLiveDecisionSession, VoiceProfileSwitchPolicyProofCase, VoiceProfileSwitchPolicyProofCaseResult, VoiceProfileSwitchPolicyProofOptions, VoiceProfileSwitchPolicyProofReport, VoiceProfileSwitchPolicyProofRoutesOptions, VoiceProfileSwitchRecommendation, VoiceProfileSwitchRecommendationOptions } from './profileSwitchRecommendation';
+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 } from './proofTrends';

package/dist/index.js

@@ -5844,6 +5844,126 @@ var createVoiceProfileSwitchLiveDecisionRoutes = (options) => {
   }
   return routes;
 };
+var statusFromIssues = (issues) => issues.some((issue) => issue.status === "fail") ? "fail" : issues.length > 0 ? "warn" : "pass";
+var buildVoiceProfileSwitchReadinessReport = async (options) => {
+  const live = await buildVoiceProfileSwitchLiveDecisionReport(options);
+  const policy = options.policyProof === false || options.policyProof === undefined ? undefined : await runVoiceProfileSwitchPolicyProof(options.policyProof);
+  const issues = [];
+  const requireLiveDecisions = options.requireLiveDecisions ?? true;
+  const requireAudit = options.requireAudit ?? Boolean(options.autoMode);
+  const requireTrace = options.requireTrace ?? true;
+  const requirePolicyProof = options.requirePolicyProof ?? Boolean(options.policyProof);
+  const requireAllowedProfilePolicy = options.requireAllowedProfilePolicy ?? Boolean(options.autoMode);
+  const maxBlockedRatio = options.maxBlockedRatio ?? 0.5;
+  const maxAutoAppliedRatio = options.maxAutoAppliedRatio ?? 0.75;
+  const decisions = live.summary.decisions;
+  const blockedRatio = decisions > 0 ? live.summary.blocked / decisions : 0;
+  const autoAppliedRatio = decisions > 0 ? live.summary.autoApplied / decisions : 0;
+  if (requireLiveDecisions && decisions === 0) {
+    issues.push({
+      code: "voice.profile_switch.live_decisions_missing",
+      message: "No live profile switch guard decisions have been recorded.",
+      status: "fail"
+    });
+  }
+  if (requireAudit && live.summary.auditEvents === 0) {
+    issues.push({
+      code: "voice.profile_switch.audit_missing",
+      message: "Profile switch guard readiness requires audit evidence.",
+      status: "fail"
+    });
+  }
+  if (requireTrace && live.summary.traceEvents === 0) {
+    issues.push({
+      code: "voice.profile_switch.trace_missing",
+      message: "Profile switch guard readiness requires trace evidence.",
+      status: "warn"
+    });
+  }
+  if (requirePolicyProof && !policy) {
+    issues.push({
+      code: "voice.profile_switch.policy_proof_missing",
+      message: "Profile switch policy proof was not configured.",
+      status: "fail"
+    });
+  }
+  if (policy && !policy.ok) {
+    issues.push({
+      code: "voice.profile_switch.policy_proof_failed",
+      message: "Profile switch policy proof has failing cases.",
+      status: "fail"
+    });
+  }
+  if (requireAllowedProfilePolicy && (options.policyProof === false || !options.policyProof?.allowedProfileIds || options.policyProof.allowedProfileIds.length === 0)) {
+    issues.push({
+      code: "voice.profile_switch.allowed_policy_missing",
+      message: "Auto profile switching should declare an allowedProfileIds policy.",
+      status: "warn"
+    });
+  }
+  if (decisions > 0 && blockedRatio > maxBlockedRatio) {
+    issues.push({
+      code: "voice.profile_switch.blocked_ratio_high",
+      message: `Blocked profile switch decisions are ${Math.round(blockedRatio * 100)}%, above the ${Math.round(maxBlockedRatio * 100)}% threshold.`,
+      status: "warn"
+    });
+  }
+  if (decisions > 0 && autoAppliedRatio > maxAutoAppliedRatio) {
+    issues.push({
+      code: "voice.profile_switch.auto_applied_ratio_high",
+      message: `Auto-applied profile switch decisions are ${Math.round(autoAppliedRatio * 100)}%, above the ${Math.round(maxAutoAppliedRatio * 100)}% threshold.`,
+      status: "warn"
+    });
+  }
+  return {
+    generatedAt: new Date().toISOString(),
+    issues,
+    live,
+    policy,
+    status: statusFromIssues(issues),
+    summary: {
+      auditEvents: live.summary.auditEvents,
+      autoApplied: live.summary.autoApplied,
+      blocked: live.summary.blocked,
+      decisions,
+      policyCases: policy?.summary.total,
+      sessions: live.summary.sessions,
+      switches: live.summary.switches,
+      traceEvents: live.summary.traceEvents
+    }
+  };
+};
+var renderVoiceProfileSwitchReadinessHTML = (report, options = {}) => {
+  const title = options.title ?? "Voice Profile Switch Readiness";
+  const issues = report.issues.map((issue) => `<li class="${escapeHtml3(issue.status)}"><strong>${escapeHtml3(issue.code)}</strong><p>${escapeHtml3(issue.message)}</p></li>`).join("");
+  const sessions = report.live.sessions.map((session) => `<tr><td>${escapeHtml3(session.sessionId)}</td><td>${escapeHtml3(session.actions.join(", ") || "none")}</td><td>${String(session.decisions.length)}</td><td>${String(session.autoApplied)}</td><td>${escapeHtml3(session.blockedByPolicy.join(", ") || "none")}</td></tr>`).join("");
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml3(title)}</title><style>:root{color-scheme:dark;background:#0b1020;color:#eff6ff;font-family:ui-sans-serif,system-ui,sans-serif}body{margin:0;padding:32px;background:radial-gradient(circle at top left,rgba(59,130,246,.2),transparent 34%),#0b1020}main{max-width:1140px;margin:0 auto}.hero,.card{background:rgba(15,23,42,.82);border:1px solid rgba(147,197,253,.24);border-radius:24px;margin-bottom:18px;padding:24px}.status{border-radius:999px;display:inline-flex;font-weight:900;padding:8px 12px}.pass{background:rgba(34,197,94,.18);color:#bbf7d0}.warn{background:rgba(245,158,11,.18);color:#fde68a}.fail{background:rgba(239,68,68,.18);color:#fecaca}.grid{display:grid;gap:12px;grid-template-columns:repeat(auto-fit,minmax(160px,1fr));margin-top:16px}.metric{background:#0f172a;border:1px solid rgba(147,197,253,.2);border-radius:18px;padding:16px}.metric span{color:#93c5fd;display:block;font-size:.75rem;font-weight:900;letter-spacing:.08em;text-transform:uppercase}.metric strong{display:block;font-size:1.8rem;margin-top:8px}ul{display:grid;gap:10px;list-style:none;padding:0}li{border-radius:16px;padding:14px}li p{margin:.35rem 0 0}table{border-collapse:collapse;width:100%}td,th{border-bottom:1px solid rgba(147,197,253,.18);padding:12px;text-align:left}pre{background:#020617;border-radius:18px;color:#dbeafe;overflow:auto;padding:18px}</style></head><body><main><section class="hero"><h1>${escapeHtml3(title)}</h1><p>Deploy-facing readiness for profile switching: policy proof, audit evidence, trace evidence, and live session behavior.</p><p class="status ${escapeHtml3(report.status)}">${escapeHtml3(report.status.toUpperCase())}</p><div class="grid"><div class="metric"><span>Sessions</span><strong>${String(report.summary.sessions)}</strong></div><div class="metric"><span>Decisions</span><strong>${String(report.summary.decisions)}</strong></div><div class="metric"><span>Policy cases</span><strong>${String(report.summary.policyCases ?? 0)}</strong></div><div class="metric"><span>Audit</span><strong>${String(report.summary.auditEvents)}</strong></div><div class="metric"><span>Trace</span><strong>${String(report.summary.traceEvents)}</strong></div></div></section><section class="card"><h2>Issues</h2>${issues ? `<ul>${issues}</ul>` : '<p class="pass status">No readiness issues.</p>'}</section><section class="card"><h2>Live Sessions</h2>${sessions ? `<table><thead><tr><th>Session</th><th>Actions</th><th>Decisions</th><th>Auto applied</th><th>Blocked by</th></tr></thead><tbody>${sessions}</tbody></table>` : "<p>No live guard sessions found.</p>"}</section><section class="card"><h2>Raw Report</h2><pre>${stringifyForHtml(report)}</pre></section></main></body></html>`;
+};
+var createVoiceProfileSwitchReadinessRoutes = (options) => {
+  const path = options.path ?? "/api/voice/profile-switch-readiness";
+  const htmlPath = options.htmlPath === undefined ? "/voice/profile-switch-readiness" : options.htmlPath;
+  const routes = new Elysia({
+    name: options.name ?? "absolutejs-voice-profile-switch-readiness"
+  }).get(path, async ({ query }) => buildVoiceProfileSwitchReadinessReport({
+    ...options,
+    limit: typeof query.limit === "string" && Number.isFinite(Number(query.limit)) ? Number(query.limit) : options.limit,
+    sessionId: typeof query.sessionId === "string" && query.sessionId.trim() ? query.sessionId.trim() : options.sessionId
+  }));
+  if (htmlPath) {
+    routes.get(htmlPath, async ({ query }) => {
+      const report = await buildVoiceProfileSwitchReadinessReport({
+        ...options,
+        limit: typeof query.limit === "string" && Number.isFinite(Number(query.limit)) ? Number(query.limit) : options.limit,
+        sessionId: typeof query.sessionId === "string" && query.sessionId.trim() ? query.sessionId.trim() : options.sessionId
+      });
+      const render = options.render ?? ((input) => renderVoiceProfileSwitchReadinessHTML(input, { title: options.title }));
+      return new Response(await render(report), {
+        headers: { "Content-Type": "text/html; charset=utf-8" }
+      });
+    });
+  }
+  return routes;
+};
 
 // src/plugin.ts
 var resolveQueryScenario = (query) => {
@@ -31866,6 +31986,14 @@ var resolveProviderOrchestration = async (options, input) => {
   }
   return typeof options.providerOrchestration === "function" ? await options.providerOrchestration(input) : options.providerOrchestration;
 };
+var isVoiceProfileSwitchReadinessReport = (value) => typeof value.status === "string" && typeof value.generatedAt === "string" && typeof value.summary === "object";
+var resolveProfileSwitchReadiness = async (options, input) => {
+  if (options.profileSwitchReadiness === false || options.profileSwitchReadiness === undefined) {
+    return;
+  }
+  const value = typeof options.profileSwitchReadiness === "function" ? await options.profileSwitchReadiness(input) : options.profileSwitchReadiness;
+  return isVoiceProfileSwitchReadinessReport(value) ? value : buildVoiceProfileSwitchReadinessReport(value);
+};
 var resolveProviderStack = async (options, input) => {
   if (options.providerStack === false || options.providerStack === undefined) {
     return;
@@ -32314,6 +32442,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     providerRoutingContracts,
     providerSlo,
     providerOrchestration,
+    profileSwitchReadiness,
     providerStack,
     providerContractMatrix,
     phoneAgentSmokes,
@@ -32360,6 +32489,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     resolveProviderRoutingContracts(options, { query, request }),
     resolveProviderSlo(options, { query, request }),
     resolveProviderOrchestration(options, { query, request }),
+    resolveProfileSwitchReadiness(options, { query, request }),
     resolveProviderStack(options, { query, request }),
     resolveProviderContractMatrix(options, { query, request }),
     resolvePhoneAgentSmokes(options, { query, request }),
@@ -33088,6 +33218,28 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       ]
     });
   }
+  if (profileSwitchReadiness) {
+    const issueLabels = profileSwitchReadiness.issues.map((issue) => issue.code);
+    checks.push({
+      detail: profileSwitchReadiness.status === "pass" ? `${profileSwitchReadiness.summary.decisions} profile switch guard decision(s) are backed by readiness evidence.` : issueLabels.length > 0 ? `Profile switch readiness issues: ${issueLabels.join(", ")}.` : "Profile switch readiness needs attention.",
+      href: options.links?.profileSwitchReadiness ?? "/voice/profile-switch-readiness",
+      label: "Profile switch readiness",
+      status: profileSwitchReadiness.status,
+      value: `${profileSwitchReadiness.summary.sessions}/${profileSwitchReadiness.summary.decisions}`,
+      actions: profileSwitchReadiness.status === "pass" ? [] : [
+        {
+          description: "Open profile switch readiness to inspect policy proof, audit evidence, trace evidence, and live decisions.",
+          href: options.links?.profileSwitchReadiness ?? "/voice/profile-switch-readiness",
+          label: "Open profile readiness"
+        },
+        {
+          description: "Open live profile switch decisions recorded from audit and trace stores.",
+          href: options.links?.profileSwitchLiveDecisions ?? "/voice/profile-switch-live-decisions",
+          label: "Open live decisions"
+        }
+      ]
+    });
+  }
   if (audit) {
     const missingLabels = audit.missing.map((requirement) => requirement.label ?? requirement.type);
     checks.push({
@@ -33279,6 +33431,9 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       opsActions: "/voice/ops-actions",
       opsRecovery: "/ops-recovery",
       phoneAgentSmoke: "/sessions",
+      profileSwitchLiveDecisions: "/voice/profile-switch-live-decisions",
+      profileSwitchPolicy: "/voice/profile-switch-policy",
+      profileSwitchReadiness: "/voice/profile-switch-readiness",
       telephonyMedia: "/voice/telephony-media",
       telephonyWebhookSecurity: "/api/voice/telephony/webhook-security",
       providerContracts: "/provider-contracts",
@@ -33332,6 +33487,15 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       providerContractMatrix,
       providerOrchestration: providerOrchestrationSummary,
       providerRecovery,
+      profileSwitchReadiness: profileSwitchReadiness ? {
+        auditEvents: profileSwitchReadiness.summary.auditEvents,
+        decisions: profileSwitchReadiness.summary.decisions,
+        issues: profileSwitchReadiness.issues.length,
+        policyCases: profileSwitchReadiness.summary.policyCases,
+        sessions: profileSwitchReadiness.summary.sessions,
+        status: profileSwitchReadiness.status,
+        traceEvents: profileSwitchReadiness.summary.traceEvents
+      } : undefined,
       phoneAgentSmokes: phoneAgentSmokeSummary,
       telephonyMedia: telephonyMediaSummary,
       telephonyWebhookSecurity: telephonyWebhookSecuritySummary,
@@ -37824,6 +37988,7 @@ export {
   renderVoiceProviderCapabilityHTML,
   renderVoiceProofTrendRecommendationMarkdown,
   renderVoiceProofTrendRecommendationHTML,
+  renderVoiceProfileSwitchReadinessHTML,
   renderVoiceProfileSwitchPolicyProofHTML,
   renderVoiceProfileSwitchLiveDecisionHTML,
   renderVoiceProductionReadinessHTML,
@@ -38079,6 +38244,7 @@ export {
   createVoiceProviderCapabilityHTMLHandler,
   createVoiceProofTrendRoutes,
   createVoiceProofTrendRecommendationRoutes,
+  createVoiceProfileSwitchReadinessRoutes,
   createVoiceProfileSwitchPolicyProofRoutes,
   createVoiceProfileSwitchLiveDecisionRoutes,
   createVoiceProductionReadinessRoutes,
@@ -38281,6 +38447,7 @@ export {
   buildVoiceProofTrendReport,
   buildVoiceProofTrendRecommendationReport,
   buildVoiceProofTrendProfileSummaries,
+  buildVoiceProfileSwitchReadinessReport,
   buildVoiceProfileSwitchLiveDecisionReport,
   buildVoiceProductionReadinessReport,
   buildVoiceProductionReadinessGate,

package/dist/productionReadiness.d.ts

@@ -22,6 +22,7 @@ import { type VoiceObservabilityExportDeliveryHistory, type VoiceObservabilityEx
 import type { VoiceMediaPipelineReport } from './mediaPipelineRoutes';
 import type { VoiceTelephonyMediaReport } from './telephonyMediaRoutes';
 import type { MediaWebRTCStatsReport } from '@absolutejs/media';
+import { type VoiceProfileSwitchReadinessOptions, type VoiceProfileSwitchReadinessReport } from './profileSwitchRecommendation';
 export type VoiceProductionReadinessObservabilityExportDeliveryHistoryOptions = {
     failOnMissing?: boolean;
     failOnStale?: boolean;
@@ -140,6 +141,9 @@ export type VoiceProductionReadinessReport = {
         opsActions?: string;
         opsRecovery?: string;
         phoneAgentSmoke?: string;
+        profileSwitchLiveDecisions?: string;
+        profileSwitchPolicy?: string;
+        profileSwitchReadiness?: string;
         telephonyWebhookSecurity?: string;
         telephonyMedia?: string;
         providerContracts?: string;
@@ -283,6 +287,15 @@ export type VoiceProductionReadinessReport = {
             warned: number;
         };
         providerRecovery: VoiceProviderFallbackRecoverySummary;
+        profileSwitchReadiness?: {
+            auditEvents: number;
+            decisions: number;
+            issues: number;
+            policyCases?: number;
+            sessions: number;
+            status: VoiceProductionReadinessStatus;
+            traceEvents: number;
+        };
         phoneAgentSmokes?: {
             failed: number;
             passed: number;
@@ -540,6 +553,10 @@ export type VoiceProductionReadinessRoutesOptions = {
         query: Record<string, unknown>;
         request: Request;
     }) => Promise<VoiceProviderOrchestrationReport> | VoiceProviderOrchestrationReport);
+    profileSwitchReadiness?: false | VoiceProfileSwitchReadinessReport | VoiceProfileSwitchReadinessOptions | ((input: {
+        query: Record<string, unknown>;
+        request: Request;
+    }) => Promise<VoiceProfileSwitchReadinessReport | VoiceProfileSwitchReadinessOptions> | VoiceProfileSwitchReadinessReport | VoiceProfileSwitchReadinessOptions);
     providerStack?: false | VoiceProviderStackCapabilityGapReport | ((input: {
         query: Record<string, unknown>;
         request: Request;

package/dist/profileSwitchRecommendation.d.ts

@@ -173,6 +173,47 @@ export type VoiceProfileSwitchLiveDecisionRoutesOptions = VoiceProfileSwitchLive
     render?: (report: VoiceProfileSwitchLiveDecisionReport) => string | Promise<string>;
     title?: string;
 };
+export type VoiceProfileSwitchReadinessStatus = 'fail' | 'pass' | 'warn';
+export type VoiceProfileSwitchReadinessIssue = {
+    code: string;
+    message: string;
+    status: Exclude<VoiceProfileSwitchReadinessStatus, 'pass'>;
+};
+export type VoiceProfileSwitchReadinessReport = {
+    generatedAt: string;
+    issues: VoiceProfileSwitchReadinessIssue[];
+    live: VoiceProfileSwitchLiveDecisionReport;
+    policy?: VoiceProfileSwitchPolicyProofReport;
+    status: VoiceProfileSwitchReadinessStatus;
+    summary: {
+        auditEvents: number;
+        autoApplied: number;
+        blocked: number;
+        decisions: number;
+        policyCases?: number;
+        sessions: number;
+        switches: number;
+        traceEvents: number;
+    };
+};
+export type VoiceProfileSwitchReadinessOptions = VoiceProfileSwitchLiveDecisionReportOptions & {
+    autoMode?: boolean;
+    maxBlockedRatio?: number;
+    maxAutoAppliedRatio?: number;
+    policyProof?: false | VoiceProfileSwitchPolicyProofOptions;
+    requireAudit?: boolean;
+    requireAllowedProfilePolicy?: boolean;
+    requireLiveDecisions?: boolean;
+    requirePolicyProof?: boolean;
+    requireTrace?: boolean;
+};
+export type VoiceProfileSwitchReadinessRoutesOptions = VoiceProfileSwitchReadinessOptions & {
+    htmlPath?: false | string;
+    name?: string;
+    path?: string;
+    render?: (report: VoiceProfileSwitchReadinessReport) => string | Promise<string>;
+    title?: string;
+};
 export declare const recommendVoiceProfileSwitch: (options: VoiceProfileSwitchRecommendationOptions) => VoiceProfileSwitchRecommendation;
 export declare const applyVoiceProfileSwitchGuard: (options: VoiceProfileSwitchGuardOptions) => Promise<VoiceProfileSwitchGuardDecision>;
 export declare const runVoiceProfileSwitchPolicyProof: (options: VoiceProfileSwitchPolicyProofOptions) => Promise<VoiceProfileSwitchPolicyProofReport>;
@@ -263,3 +304,47 @@ export declare const createVoiceProfileSwitchLiveDecisionRoutes: (options: Voice
     standaloneSchema: {};
     response: {};
 }>;
+export declare const buildVoiceProfileSwitchReadinessReport: (options: VoiceProfileSwitchReadinessOptions) => Promise<VoiceProfileSwitchReadinessReport>;
+export declare const renderVoiceProfileSwitchReadinessHTML: (report: VoiceProfileSwitchReadinessReport, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceProfileSwitchReadinessRoutes: (options: VoiceProfileSwitchReadinessRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    [x: string]: {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: VoiceProfileSwitchReadinessReport;
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/vue/useVoiceReadinessFailures.d.ts

@@ -56,6 +56,9 @@ export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceR
             readonly opsActions?: string | undefined;
             readonly opsRecovery?: string | undefined;
             readonly phoneAgentSmoke?: string | undefined;
+            readonly profileSwitchLiveDecisions?: string | undefined;
+            readonly profileSwitchPolicy?: string | undefined;
+            readonly profileSwitchReadiness?: string | undefined;
             readonly telephonyWebhookSecurity?: string | undefined;
             readonly telephonyMedia?: string | undefined;
             readonly providerContracts?: string | undefined;
@@ -369,6 +372,15 @@ export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceR
                 readonly unresolvedErrors: number;
                 readonly unresolvedSessions: number;
             };
+            readonly profileSwitchReadiness?: {
+                readonly auditEvents: number;
+                readonly decisions: number;
+                readonly issues: number;
+                readonly policyCases?: number | undefined;
+                readonly sessions: number;
+                readonly status: import("..").VoiceProductionReadinessStatus;
+                readonly traceEvents: number;
+            } | undefined;
             readonly phoneAgentSmokes?: {
                 readonly failed: number;
                 readonly passed: number;
@@ -489,6 +501,9 @@ export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceR
             readonly opsActions?: string | undefined;
             readonly opsRecovery?: string | undefined;
             readonly phoneAgentSmoke?: string | undefined;
+            readonly profileSwitchLiveDecisions?: string | undefined;
+            readonly profileSwitchPolicy?: string | undefined;
+            readonly profileSwitchReadiness?: string | undefined;
             readonly telephonyWebhookSecurity?: string | undefined;
             readonly telephonyMedia?: string | undefined;
             readonly providerContracts?: string | undefined;
@@ -802,6 +817,15 @@ export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceR
                 readonly unresolvedErrors: number;
                 readonly unresolvedSessions: number;
             };
+            readonly profileSwitchReadiness?: {
+                readonly auditEvents: number;
+                readonly decisions: number;
+                readonly issues: number;
+                readonly policyCases?: number | undefined;
+                readonly sessions: number;
+                readonly status: import("..").VoiceProductionReadinessStatus;
+                readonly traceEvents: number;
+            } | undefined;
             readonly phoneAgentSmokes?: {
                 readonly failed: number;
                 readonly passed: number;

package/package.json

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