@absolutejs/voice 0.0.22-beta.360 → 0.0.22-beta.362

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, createVoiceProfileSwitchPolicyProofRoutes, recommendVoiceProfileSwitch, renderVoiceProfileSwitchPolicyProofHTML, runVoiceProfileSwitchPolicyProof } from './profileSwitchRecommendation';
-export type { VoiceProfileSwitchGuardAction, VoiceProfileSwitchGuardDecision, VoiceProfileSwitchGuardMode, VoiceProfileSwitchGuardOptions, VoiceProfileSwitchObservedSignals, 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

@@ -5681,6 +5681,289 @@ var createVoiceProfileSwitchPolicyProofRoutes = (options) => {
   }
   return routes;
 };
+var readStringField = (record, key) => typeof record?.[key] === "string" ? record[key] : undefined;
+var readNumberField = (record, key) => typeof record?.[key] === "number" && Number.isFinite(record[key]) ? record[key] : undefined;
+var readBooleanField = (record, key) => typeof record?.[key] === "boolean" ? record[key] : undefined;
+var auditEventToLiveDecision = (event) => {
+  if (event.type !== "profile.switch" || !event.sessionId) {
+    return;
+  }
+  const payload = event.payload;
+  return {
+    action: readStringField(payload, "action") ?? event.action.replace(/^profile\.switch\./, ""),
+    at: event.at,
+    auditEventId: event.id,
+    autoApplied: readBooleanField(payload, "autoApplied"),
+    autoSwitchCount: readNumberField(payload, "autoSwitchCount"),
+    blockedByPolicy: readStringField(payload, "blockedByPolicy"),
+    confidence: readNumberField(payload, "confidence"),
+    maxAutoSwitchesPerSession: readNumberField(payload, "maxAutoSwitchesPerSession"),
+    minConfidence: readNumberField(payload, "minConfidence"),
+    mode: readStringField(payload, "mode"),
+    outcome: event.outcome,
+    previousProfileId: readStringField(payload, "previousProfileId"),
+    recommendedProfileId: readStringField(payload, "recommendedProfileId"),
+    selectedProfileId: readStringField(payload, "selectedProfileId") ?? event.resource?.id,
+    sessionId: event.sessionId,
+    source: "audit",
+    status: readStringField(payload, "status"),
+    traceId: event.traceId
+  };
+};
+var traceEventToLiveDecision = (event) => {
+  if (event.type !== "provider.decision" || event.metadata?.source !== "profile-switch-guard") {
+    return;
+  }
+  const payload = event.payload;
+  return {
+    action: readStringField(payload, "action"),
+    at: event.at,
+    autoApplied: readBooleanField(payload, "autoApplied"),
+    autoSwitchCount: readNumberField(payload, "autoSwitchCount"),
+    blockedByPolicy: readStringField(payload, "blockedByPolicy"),
+    confidence: readNumberField(payload, "confidence"),
+    maxAutoSwitchesPerSession: readNumberField(payload, "maxAutoSwitchesPerSession"),
+    minConfidence: readNumberField(payload, "minConfidence"),
+    mode: readStringField(payload, "mode"),
+    previousProfileId: readStringField(payload, "previousProfileId"),
+    reason: readStringField(payload, "reason"),
+    recommendedProfileId: readStringField(payload, "recommendedProfileId"),
+    scenarioId: event.scenarioId,
+    selectedProfileId: readStringField(payload, "selectedProfileId"),
+    sessionId: event.sessionId,
+    source: "trace",
+    status: readStringField(payload, "status"),
+    traceEventId: event.id,
+    traceId: event.traceId
+  };
+};
+var buildVoiceProfileSwitchLiveDecisionReport = async (options) => {
+  const [auditEvents, traceEvents] = await Promise.all([
+    options.audit?.list({
+      limit: options.limit,
+      sessionId: options.sessionId,
+      type: "profile.switch"
+    }) ?? [],
+    options.trace?.list({
+      limit: options.limit,
+      sessionId: options.sessionId,
+      type: "provider.decision"
+    }) ?? []
+  ]);
+  const decisions = [
+    ...auditEvents.map(auditEventToLiveDecision).filter((decision) => Boolean(decision)),
+    ...traceEvents.map(traceEventToLiveDecision).filter((decision) => Boolean(decision))
+  ].sort((left, right) => right.at - left.at).slice(0, options.limit);
+  const sessions = Array.from(decisions.reduce((map, decision) => {
+    const existing = map.get(decision.sessionId) ?? {
+      actionCounts: {},
+      actions: [],
+      autoApplied: 0,
+      blockedByPolicy: [],
+      decisions: [],
+      firstSeenAt: decision.at,
+      lastSeenAt: decision.at,
+      sessionId: decision.sessionId
+    };
+    existing.decisions.push(decision);
+    existing.firstSeenAt = Math.min(existing.firstSeenAt, decision.at);
+    existing.lastSeenAt = Math.max(existing.lastSeenAt, decision.at);
+    if (decision.action) {
+      existing.actionCounts[decision.action] = (existing.actionCounts[decision.action] ?? 0) + 1;
+    }
+    if (decision.autoApplied) {
+      existing.autoApplied += 1;
+    }
+    if (decision.blockedByPolicy && !existing.blockedByPolicy.includes(decision.blockedByPolicy)) {
+      existing.blockedByPolicy.push(decision.blockedByPolicy);
+    }
+    map.set(decision.sessionId, existing);
+    return map;
+  }, new Map)).map(([, session]) => ({
+    ...session,
+    actions: Object.keys(session.actionCounts).sort(),
+    decisions: session.decisions.sort((left, right) => right.at - left.at),
+    lastDecision: session.decisions.sort((left, right) => right.at - left.at)[0]
+  }));
+  const actionCount = (action) => decisions.filter((decision) => decision.action === action).length;
+  return {
+    generatedAt: new Date().toISOString(),
+    ok: decisions.length > 0,
+    sessions: sessions.sort((left, right) => right.lastSeenAt - left.lastSeenAt),
+    summary: {
+      auditEvents: auditEvents.length,
+      autoApplied: decisions.filter((decision) => decision.autoApplied).length,
+      blocked: actionCount("blocked"),
+      decisions: decisions.length,
+      recommendations: actionCount("recommend"),
+      sessions: sessions.length,
+      switches: actionCount("switch"),
+      traceEvents: traceEvents.length
+    }
+  };
+};
+var renderVoiceProfileSwitchLiveDecisionHTML = (report, options = {}) => {
+  const title = options.title ?? "Voice Profile Switch Live Decisions";
+  const rows = report.sessions.flatMap((session) => session.decisions.map((decision) => `<tr>
+  <td><strong>${escapeHtml3(decision.sessionId)}</strong><p>${escapeHtml3(new Date(decision.at).toISOString())}</p></td>
+  <td>${escapeHtml3(decision.source)}</td>
+  <td>${escapeHtml3(decision.action ?? "unknown")}</td>
+  <td>${escapeHtml3(decision.selectedProfileId ?? "none")}</td>
+  <td>${escapeHtml3(decision.blockedByPolicy ?? "none")}</td>
+  <td>${typeof decision.confidence === "number" ? `${Math.round(decision.confidence * 100)}%` : "n/a"}</td>
+  <td>${escapeHtml3(decision.reason ?? decision.outcome ?? "recorded")}</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:#11100b;color:#fff7ed;font-family:ui-sans-serif,system-ui,sans-serif}body{margin:0;padding:32px;background:radial-gradient(circle at top right,rgba(251,146,60,.18),transparent 34%),#11100b}main{max-width:1180px;margin:0 auto}.hero,.card{border:1px solid rgba(251,191,36,.24);border-radius:24px;background:rgba(28,25,23,.78);box-shadow:0 24px 90px rgba(0,0,0,.24);padding:24px;margin-bottom:18px}.metric-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(160px,1fr));gap:12px}.metric{border:1px solid rgba(251,191,36,.22);border-radius:18px;padding:16px;background:rgba(120,53,15,.26)}.metric span{display:block;color:#fed7aa;font-size:.75rem;text-transform:uppercase;letter-spacing:.08em}.metric strong{display:block;margin-top:8px;font-size:1.7rem}table{width:100%;border-collapse:collapse}th,td{padding:13px;text-align:left;border-bottom:1px solid rgba(251,191,36,.18);vertical-align:top}th{color:#fde68a;text-transform:uppercase;font-size:.74rem;letter-spacing:.08em}td p{margin:.35rem 0 0;color:#fdba74}pre{white-space:pre-wrap;overflow:auto;border-radius:18px;background:#020617;padding:18px;color:#ffedd5}.empty{color:#fdba74}</style></head><body><main><section class="hero"><h1>${escapeHtml3(title)}</h1><p>This page summarizes real profile switch guard evidence from audit and trace stores. Use it beside policy proof to show bounded policy plus actual session decisions.</p><div class="metric-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>Switches</span><strong>${String(report.summary.switches)}</strong></div><div class="metric"><span>Blocked</span><strong>${String(report.summary.blocked)}</strong></div><div class="metric"><span>Auto applied</span><strong>${String(report.summary.autoApplied)}</strong></div></div></section><section class="card"><h2>Live Guard Decisions</h2>${rows ? `<table><thead><tr><th>Session</th><th>Source</th><th>Action</th><th>Selected</th><th>Blocked by</th><th>Confidence</th><th>Reason</th></tr></thead><tbody>${rows}</tbody></table>` : '<p class="empty">No profile switch guard decisions recorded yet. Start a voice session with profileSwitchGuard enabled.</p>'}</section><section class="card"><h2>Raw Report</h2><pre>${stringifyForHtml(report)}</pre></section></main></body></html>`;
+};
+var createVoiceProfileSwitchLiveDecisionRoutes = (options) => {
+  const path = options.path ?? "/api/voice/profile-switch-live-decisions";
+  const htmlPath = options.htmlPath === undefined ? "/voice/profile-switch-live-decisions" : options.htmlPath;
+  const routes = new Elysia({
+    name: options.name ?? "absolutejs-voice-profile-switch-live-decisions"
+  }).get(path, async ({ query }) => buildVoiceProfileSwitchLiveDecisionReport({
+    audit: options.audit,
+    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,
+    trace: options.trace
+  }));
+  if (htmlPath) {
+    routes.get(htmlPath, async ({ query }) => {
+      const report = await buildVoiceProfileSwitchLiveDecisionReport({
+        audit: options.audit,
+        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,
+        trace: options.trace
+      });
+      const render = options.render ?? ((input) => renderVoiceProfileSwitchLiveDecisionHTML(input, {
+        title: options.title
+      }));
+      return new Response(await render(report), {
+        headers: { "Content-Type": "text/html; charset=utf-8" }
+      });
+    });
+  }
+  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) => {
@@ -37661,7 +37944,9 @@ export {
   renderVoiceProviderCapabilityHTML,
   renderVoiceProofTrendRecommendationMarkdown,
   renderVoiceProofTrendRecommendationHTML,
+  renderVoiceProfileSwitchReadinessHTML,
   renderVoiceProfileSwitchPolicyProofHTML,
+  renderVoiceProfileSwitchLiveDecisionHTML,
   renderVoiceProductionReadinessHTML,
   renderVoicePostCallAnalysisMarkdown,
   renderVoicePhoneAgentProductionSmokeHTML,
@@ -37915,7 +38200,9 @@ export {
   createVoiceProviderCapabilityHTMLHandler,
   createVoiceProofTrendRoutes,
   createVoiceProofTrendRecommendationRoutes,
+  createVoiceProfileSwitchReadinessRoutes,
   createVoiceProfileSwitchPolicyProofRoutes,
+  createVoiceProfileSwitchLiveDecisionRoutes,
   createVoiceProductionReadinessRoutes,
   createVoicePostgresTraceSinkDeliveryStore,
   createVoicePostgresTraceEventStore,
@@ -38116,6 +38403,8 @@ export {
   buildVoiceProofTrendReport,
   buildVoiceProofTrendRecommendationReport,
   buildVoiceProofTrendProfileSummaries,
+  buildVoiceProfileSwitchReadinessReport,
+  buildVoiceProfileSwitchLiveDecisionReport,
   buildVoiceProductionReadinessReport,
   buildVoiceProductionReadinessGate,
   buildVoicePostCallAnalysisReport,

package/dist/profileSwitchRecommendation.d.ts

@@ -1,6 +1,7 @@
 import { Elysia } from 'elysia';
 import type { VoiceRealCallProfileDefault, VoiceRealCallProfileDefaultsReport, VoiceRealCallProfileHistoryReport } from './proofTrends';
 import { type StoredVoiceAuditEvent, type VoiceAuditActor, type VoiceAuditEventStore } from './audit';
+import type { VoiceTraceEventStore } from './trace';
 export type VoiceProfileSwitchObservedSignals = {
     currentProfileId?: string;
     fallbackUsed?: boolean;
@@ -110,6 +111,109 @@ export type VoiceProfileSwitchPolicyProofRoutesOptions = VoiceProfileSwitchPolic
     path?: string;
     render?: (report: VoiceProfileSwitchPolicyProofReport) => string | Promise<string>;
 };
+export type VoiceProfileSwitchLiveDecisionEvidence = {
+    action?: VoiceProfileSwitchGuardAction | string;
+    at: number;
+    auditEventId?: string;
+    autoApplied?: boolean;
+    autoSwitchCount?: number;
+    blockedByPolicy?: string;
+    confidence?: number;
+    maxAutoSwitchesPerSession?: number;
+    minConfidence?: number;
+    mode?: VoiceProfileSwitchGuardMode | string;
+    outcome?: string;
+    previousProfileId?: string;
+    reason?: string;
+    recommendedProfileId?: string;
+    scenarioId?: string;
+    selectedProfileId?: string;
+    sessionId: string;
+    source: 'audit' | 'trace';
+    status?: string;
+    traceEventId?: string;
+    traceId?: string;
+};
+export type VoiceProfileSwitchLiveDecisionSession = {
+    actionCounts: Record<string, number>;
+    actions: string[];
+    autoApplied: number;
+    blockedByPolicy: string[];
+    decisions: VoiceProfileSwitchLiveDecisionEvidence[];
+    firstSeenAt: number;
+    lastDecision?: VoiceProfileSwitchLiveDecisionEvidence;
+    lastSeenAt: number;
+    sessionId: string;
+};
+export type VoiceProfileSwitchLiveDecisionReport = {
+    generatedAt: string;
+    ok: boolean;
+    sessions: VoiceProfileSwitchLiveDecisionSession[];
+    summary: {
+        auditEvents: number;
+        autoApplied: number;
+        blocked: number;
+        decisions: number;
+        recommendations: number;
+        sessions: number;
+        switches: number;
+        traceEvents: number;
+    };
+};
+export type VoiceProfileSwitchLiveDecisionReportOptions = {
+    audit?: VoiceAuditEventStore;
+    limit?: number;
+    sessionId?: string;
+    trace?: VoiceTraceEventStore;
+};
+export type VoiceProfileSwitchLiveDecisionRoutesOptions = VoiceProfileSwitchLiveDecisionReportOptions & {
+    htmlPath?: false | string;
+    name?: string;
+    path?: string;
+    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>;
@@ -156,3 +260,91 @@ export declare const createVoiceProfileSwitchPolicyProofRoutes: (options: VoiceP
     standaloneSchema: {};
     response: {};
 }>;
+export declare const buildVoiceProfileSwitchLiveDecisionReport: (options: VoiceProfileSwitchLiveDecisionReportOptions) => Promise<VoiceProfileSwitchLiveDecisionReport>;
+export declare const renderVoiceProfileSwitchLiveDecisionHTML: (report: VoiceProfileSwitchLiveDecisionReport, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceProfileSwitchLiveDecisionRoutes: (options: VoiceProfileSwitchLiveDecisionRoutesOptions) => 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: VoiceProfileSwitchLiveDecisionReport;
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    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/package.json

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