@absolutejs/voice 0.0.22-beta.334 → 0.0.22-beta.336

package/dist/client/index.js

@@ -3821,7 +3821,7 @@ var maxNumber = (values) => {
   return finite.length > 0 ? Math.max(...finite) : undefined;
 };
 var readProofTrendMaxLiveP95 = (report) => report.summary.maxLiveP95Ms ?? maxNumber(report.cycles.map((cycle) => cycle.liveLatency?.p95Ms));
-var readProofTrendMaxProviderP95 = (report) => report.summary.maxProviderP95Ms;
+var readProofTrendMaxProviderP95 = (report) => report.summary.maxProviderP95Ms ?? maxNumber((report.summary.providers ?? []).map((provider) => provider.p95Ms)) ?? maxNumber(report.cycles.flatMap((cycle) => (cycle.providers ?? []).map((provider) => provider.p95Ms)));
 var readProofTrendMaxTurnP95 = (report) => report.summary.maxTurnP95Ms ?? maxNumber(report.cycles.map((cycle) => cycle.turnLatency?.p95Ms));
 var readRuntimeChannelMetric = (report, key) => {
   const summaryValue = report.summary.runtimeChannel?.[key];
@@ -3839,6 +3839,103 @@ var readProofTrendRuntimeChannel = (report) => ({
   samples: report.summary.runtimeChannel?.samples ?? maxNumber(report.cycles.map((cycle) => cycle.runtimeChannel?.samples)),
   status: report.summary.runtimeChannel?.status
 });
+var normalizeProviderStatus = (status) => status === "pass" ? "pass" : status === "fail" ? "fail" : "warn";
+var providerSortScore = (provider) => [
+  recommendationStatusRank[provider.status],
+  provider.p95Ms ?? Number.POSITIVE_INFINITY,
+  provider.averageMs ?? Number.POSITIVE_INFINITY,
+  provider.samples === undefined ? Number.POSITIVE_INFINITY : -provider.samples,
+  provider.id
+];
+var compareProviders = (left, right) => {
+  const leftScore = providerSortScore(left);
+  const rightScore = providerSortScore(right);
+  for (let index = 0;index < leftScore.length; index += 1) {
+    const leftValue = leftScore[index];
+    const rightValue = rightScore[index];
+    if (typeof leftValue === "number" && typeof rightValue === "number") {
+      if (leftValue !== rightValue) {
+        return leftValue - rightValue;
+      }
+      continue;
+    }
+    const compared = String(leftValue).localeCompare(String(rightValue));
+    if (compared !== 0) {
+      return compared;
+    }
+  }
+  return 0;
+};
+var summarizeProofTrendProviders = (report, budgetMs) => {
+  const sourceProviders = report.summary.providers && report.summary.providers.length > 0 ? report.summary.providers : undefined;
+  const providersById = new Map;
+  if (sourceProviders) {
+    for (const provider of sourceProviders) {
+      if (provider.id) {
+        providersById.set(provider.id, provider);
+      }
+    }
+  } else {
+    for (const cycle of report.cycles) {
+      for (const provider of cycle.providers ?? []) {
+        if (!provider.id) {
+          continue;
+        }
+        const existing = providersById.get(provider.id);
+        providersById.set(provider.id, {
+          averageMs: maxNumber([existing?.averageMs, provider.averageMs]),
+          id: provider.id,
+          label: existing?.label ?? provider.label,
+          p50Ms: maxNumber([existing?.p50Ms, provider.p50Ms]),
+          p95Ms: maxNumber([existing?.p95Ms, provider.p95Ms]),
+          role: existing?.role ?? provider.role,
+          samples: (existing?.samples ?? 0) + (provider.samples ?? 0),
+          status: existing?.status === "fail" || provider.status === "fail" ? "fail" : existing?.status === "warn" || provider.status === "warn" ? "warn" : provider.status ?? existing?.status
+        });
+      }
+    }
+  }
+  return [...providersById.values()].map((provider) => {
+    const status = provider.p95Ms === undefined ? normalizeProviderStatus(provider.status) : withinBudget(provider.p95Ms, budgetMs) ? normalizeProviderStatus(provider.status) === "fail" ? "fail" : "pass" : normalizeProviderStatus(provider.status) === "fail" ? "fail" : "warn";
+    return {
+      averageMs: provider.averageMs,
+      id: provider.id,
+      label: provider.label,
+      nextMove: status === "pass" ? "Eligible for latency-sensitive routing based on sustained proof." : provider.p95Ms === undefined ? "Collect provider-specific latency samples before routing latency-sensitive traffic here." : "Keep as fallback or tune provider/model/runtime budgets before using for latency-sensitive routing.",
+      p50Ms: provider.p50Ms,
+      p95Ms: provider.p95Ms,
+      rank: 0,
+      role: provider.role,
+      samples: provider.samples,
+      status
+    };
+  }).sort(compareProviders).map((provider, index) => ({ ...provider, rank: index + 1 }));
+};
+var shouldSwitchProvider = (current, best, options) => {
+  if (!current || !best || current.id === best.id || best.status !== "pass") {
+    return false;
+  }
+  if (current.p95Ms === undefined || best.p95Ms === undefined) {
+    return false;
+  }
+  const minImprovementMs = options.providerSwitchMinImprovementMs ?? 100;
+  const minImprovementRatio = options.providerSwitchMinImprovementRatio ?? 0.1;
+  const improvementMs = current.p95Ms - best.p95Ms;
+  const improvementRatio = current.p95Ms > 0 ? improvementMs / current.p95Ms : 0;
+  return improvementMs >= minImprovementMs || improvementRatio >= minImprovementRatio;
+};
+var bestProviderByRole = (providers) => {
+  const best = new Map;
+  for (const provider of providers) {
+    const role = provider.role ?? provider.id;
+    const existing = best.get(role);
+    if (!existing || compareProviders(provider, existing) < 0) {
+      best.set(role, provider);
+    }
+  }
+  return [...best.values()].sort((left, right) => String(left.role ?? left.id).localeCompare(String(right.role ?? right.id)));
+};
+var formatProviderMix = (providers) => providers.length === 0 ? "n/a" : providers.map((provider) => provider.role ? `${provider.role.toUpperCase()} ${provider.label ?? provider.id}` : provider.label ?? provider.id).join(", ");
 var evaluateVoiceProofTrendEvidence = (report, input = {}) => {
   const issues = [];
   const requiredStatus = input.requireStatus ?? "pass";
@@ -3953,6 +4050,12 @@ var buildVoiceProofTrendRecommendationReport = (report, options = {}) => {
   const maxProviderP95Ms = readProofTrendMaxProviderP95(report);
   const maxTurnP95Ms = readProofTrendMaxTurnP95(report);
   const runtimeChannel = readProofTrendRuntimeChannel(report);
+  const providers = summarizeProofTrendProviders(report, budgets.maxProviderP95Ms);
+  const bestProvider = providers.find((provider) => provider.status === "pass") ?? providers[0];
+  const bestProviders = bestProviderByRole(providers).filter((provider) => provider.status === "pass");
+  const currentProvider = options.currentProviderId ? providers.find((provider) => provider.id === options.currentProviderId) : undefined;
+  const bestComparableProvider = currentProvider?.role ? bestProviders.find((provider) => provider.role === currentProvider.role) : bestProvider;
+  const providerSwitchRecommended = shouldSwitchProvider(currentProvider, bestComparableProvider, options);
   const recommendations = [];
   const issues = [];
   if (report.ok !== true) {
@@ -3960,12 +4063,20 @@ var buildVoiceProofTrendRecommendationReport = (report, options = {}) => {
   }
   recommendations.push({
     evidence: {
+      bestProviderId: bestComparableProvider?.id ?? bestProvider?.id,
+      bestProviderMix: formatProviderMix(bestProviders),
+      bestProviderP95Ms: bestComparableProvider?.p95Ms ?? bestProvider?.p95Ms,
       budgetMs: budgets.maxProviderP95Ms,
+      currentProviderId: currentProvider?.id ?? options.currentProviderId,
+      currentProviderP95Ms: currentProvider?.p95Ms,
+      providerComparisonCount: providers.length,
       providerP95Ms: maxProviderP95Ms
     },
-    nextMove: withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "Keep the current provider route for latency-sensitive turns and keep collecting sustained proof." : "Route latency-sensitive turns to a faster provider profile or tighten fallback/circuit-breaker budgets before promotion.",
-    recommendation: withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "Keep current provider path" : "Change provider routing for latency-sensitive traffic",
-    status: withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "pass" : maxProviderP95Ms === undefined ? "fail" : "warn",
+    nextMove: providers.length > 0 ? providerSwitchRecommended ? `Route latency-sensitive ${currentProvider?.role ?? "provider"} traffic to ${bestComparableProvider?.label ?? bestComparableProvider?.id} for this call profile and keep the current path as fallback.` : bestProviders.length > 0 ? `Use the fastest proven provider mix for this call profile: ${formatProviderMix(bestProviders)}.` : "Collect provider-specific sustained samples before making provider-specific routing decisions." : withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "Keep the current provider route for latency-sensitive turns and keep collecting sustained proof." : "Route latency-sensitive turns to a faster provider profile or tighten fallback/circuit-breaker budgets before promotion.",
+    providerId: providerSwitchRecommended ? bestComparableProvider?.id : bestProviders.length === 1 ? bestProviders[0]?.id : undefined,
+    recommendation: providers.length > 0 ? providerSwitchRecommended ? `Switch latency-sensitive ${currentProvider?.role ?? "provider"} routing to ${bestComparableProvider?.label ?? bestComparableProvider?.id}` : bestProviders.length > 0 ? "Prefer the fastest proven provider mix for this call profile" : "Collect provider-specific latency samples" : withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "Keep current provider path" : "Change provider routing for latency-sensitive traffic",
+    role: bestComparableProvider?.role,
+    status: providers.length > 0 ? providerSwitchRecommended ? "warn" : bestProviders.length > 0 ? "pass" : bestProvider?.status ?? "fail" : withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "pass" : maxProviderP95Ms === undefined ? "fail" : "warn",
     surface: "provider-path"
   });
   const runtimePass = withinBudget(runtimeChannel.maxFirstAudioLatencyMs, budgets.maxRuntimeFirstAudioLatencyMs) && withinBudget(runtimeChannel.maxInterruptionP95Ms, budgets.maxRuntimeInterruptionP95Ms) && withinBudget(runtimeChannel.maxJitterMs, budgets.maxRuntimeJitterMs) && withinBudget(runtimeChannel.maxTimestampDriftMs, budgets.maxRuntimeTimestampDriftMs) && withinBudget(runtimeChannel.maxBackpressureEvents, budgets.maxRuntimeBackpressureEvents);
@@ -4008,16 +4119,21 @@ var buildVoiceProofTrendRecommendationReport = (report, options = {}) => {
   });
   const status = issues.length > 0 ? "fail" : worstRecommendationStatus(recommendations);
   return {
+    bestProvider,
+    bestProviders,
     generatedAt: new Date().toISOString(),
     issues,
     ok: status !== "fail",
+    providers,
     recommendations,
     source: report.source || report.outputDir || report.runId || "proof-trends",
     status,
     summary: {
-      keepCurrentProviderPath: recommendations.find((item) => item.surface === "provider-path")?.status === "pass",
+      keepCurrentProviderPath: !providerSwitchRecommended && recommendations.find((item) => item.surface === "provider-path")?.status !== "fail",
       keepCurrentRuntimeChannel: recommendations.find((item) => item.surface === "runtime-channel")?.status === "pass",
-      recommendedActions: recommendations.filter((item) => item.status !== "pass").length
+      providerComparisonCount: providers.length,
+      recommendedActions: recommendations.filter((item) => item.status !== "pass").length,
+      switchRecommended: providerSwitchRecommended
     }
   };
 };
@@ -4028,12 +4144,20 @@ var renderVoiceProofTrendRecommendationMarkdown = (report, title = "Voice Provid
   "",
   `- Status: ${report.status}`,
   `- Source: ${report.source}`,
+  `- Best provider mix: ${formatProviderMix(report.bestProviders)}`,
+  `- Provider comparisons: ${String(report.summary.providerComparisonCount)}`,
   `- Recommended actions: ${String(report.summary.recommendedActions)}`,
   "",
   "| Surface | Status | Recommendation | Next move |",
   "| --- | --- | --- | --- |",
   ...report.recommendations.map((recommendation) => `| ${escapeMarkdown(recommendation.surface)} | ${recommendation.status} | ${escapeMarkdown(recommendation.recommendation)} | ${escapeMarkdown(recommendation.nextMove)} |`),
   "",
+  "## Provider Comparison",
+  "",
+  "| Rank | Provider | Role | Status | P95 | Samples | Next move |",
+  "| ---: | --- | --- | --- | ---: | ---: | --- |",
+  ...report.providers.length ? report.providers.map((provider) => `| ${String(provider.rank)} | ${escapeMarkdown(provider.label ?? provider.id)} | ${escapeMarkdown(provider.role ?? "n/a")} | ${provider.status} | ${provider.p95Ms === undefined ? "n/a" : String(provider.p95Ms)} | ${provider.samples === undefined ? "n/a" : String(provider.samples)} | ${escapeMarkdown(provider.nextMove)} |`) : ["| n/a | n/a | n/a | n/a | n/a | n/a | No provider-specific samples were present. |"],
+  "",
   "## Issues",
   "",
   ...report.issues.length ? report.issues.map((issue) => `- ${issue}`) : ["- None"]
@@ -4042,7 +4166,8 @@ var renderVoiceProofTrendRecommendationMarkdown = (report, title = "Voice Provid
 var renderVoiceProofTrendRecommendationHTML = (report, title = "Voice Provider Runtime Recommendations") => {
   const cards = report.recommendations.map((recommendation) => `<article class="${escapeHtml3(recommendation.status)}"><p class="eyebrow">${escapeHtml3(recommendation.surface)} \xB7 ${escapeHtml3(recommendation.status)}</p><h2>${escapeHtml3(recommendation.recommendation)}</h2><p>${escapeHtml3(recommendation.nextMove)}</p><pre>${escapeHtml3(JSON.stringify(recommendation.evidence, null, 2))}</pre></article>`).join("");
   const issues = report.issues.length === 0 ? "<li>None</li>" : report.issues.map((issue) => `<li>${escapeHtml3(issue)}</li>`).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>body{background:#101418;color:#f7f3e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.hero,article{background:#17201d;border:1px solid #2e3d36;border-radius:24px;margin-bottom:16px;padding:22px}.hero{background:linear-gradient(135deg,rgba(20,184,166,.18),rgba(245,158,11,.12))}.eyebrow{color:#5eead4;font-weight:900;letter-spacing:.1em;text-transform:uppercase}h1{font-size:clamp(2.2rem,6vw,4.7rem);letter-spacing:-.06em;line-height:.92;margin:.2rem 0 1rem}.summary{display:flex;flex-wrap:wrap;gap:10px}.pill{border:1px solid #42534a;border-radius:999px;padding:8px 12px}.pass{border-color:rgba(34,197,94,.55)}.warn{border-color:rgba(245,158,11,.7)}.fail{border-color:rgba(239,68,68,.75)}pre{background:#0b1110;border-radius:14px;overflow:auto;padding:12px}a{color:#5eead4}</style></head><body><main><section class="hero"><p class="eyebrow">Sustained proof recommendations</p><h1>${escapeHtml3(title)}</h1><p>Generated ${escapeHtml3(report.generatedAt)} from ${escapeHtml3(report.source)}.</p><div class="summary"><span class="pill">Status ${escapeHtml3(report.status)}</span><span class="pill">Provider ${report.summary.keepCurrentProviderPath ? "keep" : "change"}</span><span class="pill">Runtime ${report.summary.keepCurrentRuntimeChannel ? "keep" : "tune"}</span><span class="pill">${String(report.summary.recommendedActions)} action(s)</span></div></section>${cards}<section class="hero"><h2>Issues</h2><ul>${issues}</ul></section></main></body></html>`;
+  const providerRows = report.providers.length === 0 ? "<li>No provider-specific samples were present.</li>" : report.providers.map((provider) => `<li><strong>#${String(provider.rank)} ${escapeHtml3(provider.label ?? provider.id)}</strong><span>${escapeHtml3(provider.role ?? "provider")} \xB7 ${escapeHtml3(provider.status)} \xB7 p95 ${escapeHtml3(provider.p95Ms ?? "n/a")}ms \xB7 ${escapeHtml3(provider.samples ?? "n/a")} sample(s)</span><small>${escapeHtml3(provider.nextMove)}</small></li>`).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>body{background:#101418;color:#f7f3e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.hero,article{background:#17201d;border:1px solid #2e3d36;border-radius:24px;margin-bottom:16px;padding:22px}.hero{background:linear-gradient(135deg,rgba(20,184,166,.18),rgba(245,158,11,.12))}.eyebrow{color:#5eead4;font-weight:900;letter-spacing:.1em;text-transform:uppercase}h1{font-size:clamp(2.2rem,6vw,4.7rem);letter-spacing:-.06em;line-height:.92;margin:.2rem 0 1rem}.summary{display:flex;flex-wrap:wrap;gap:10px}.pill{border:1px solid #42534a;border-radius:999px;padding:8px 12px}.pass{border-color:rgba(34,197,94,.55)}.warn{border-color:rgba(245,158,11,.7)}.fail{border-color:rgba(239,68,68,.75)}pre{background:#0b1110;border-radius:14px;overflow:auto;padding:12px}a{color:#5eead4}li{margin:.45rem 0}li span,li small{display:block;color:#c9d3ca}</style></head><body><main><section class="hero"><p class="eyebrow">Sustained proof recommendations</p><h1>${escapeHtml3(title)}</h1><p>Generated ${escapeHtml3(report.generatedAt)} from ${escapeHtml3(report.source)}.</p><div class="summary"><span class="pill">Status ${escapeHtml3(report.status)}</span><span class="pill">Provider ${report.summary.keepCurrentProviderPath ? "keep" : "change"}</span><span class="pill">Best mix ${escapeHtml3(formatProviderMix(report.bestProviders))}</span><span class="pill">Runtime ${report.summary.keepCurrentRuntimeChannel ? "keep" : "tune"}</span><span class="pill">${String(report.summary.recommendedActions)} action(s)</span></div></section>${cards}<section class="hero"><h2>Provider Comparison</h2><ul>${providerRows}</ul></section><section class="hero"><h2>Issues</h2><ul>${issues}</ul></section></main></body></html>`;
 };
 var createVoiceProofTrendRecommendationRoutes = (options) => {
   const path = options.path ?? "/api/voice/proof-trend-recommendations";

package/dist/index.d.ts

@@ -31,7 +31,7 @@ export type { VoicePlatformCoverageAssertionInput, VoicePlatformCoverageAssertio
 export { assertVoiceProofTrendEvidence, buildEmptyVoiceProofTrendReport, buildVoiceProofTrendRecommendationReport, buildVoiceProofTrendReport, createVoiceProofTrendRecommendationRoutes, createVoiceProofTrendRoutes, DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS, evaluateVoiceProofTrendEvidence, formatVoiceProofTrendAge, normalizeVoiceProofTrendReport, readVoiceProofTrendReportFile, renderVoiceProofTrendRecommendationHTML, renderVoiceProofTrendRecommendationMarkdown } from './proofTrends';
 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, VoiceProofTrendRecommendation, VoiceProofTrendRecommendationOptions, VoiceProofTrendRecommendationReport, VoiceProofTrendRecommendationRoutesOptions, VoiceProofTrendRecommendationStatus, VoiceProofTrendRecommendationSurface, VoiceProofTrendReport, VoiceProofTrendReportInput, VoiceProofTrendRoutesOptions, VoiceProofTrendStatus, VoiceProofTrendSummary } from './proofTrends';
+export type { VoiceProofTrendAssertionInput, VoiceProofTrendAssertionReport, VoiceProofTrendCycle, VoiceProofTrendProviderRecommendation, VoiceProofTrendProviderSummary, VoiceProofTrendRecommendation, VoiceProofTrendRecommendationOptions, VoiceProofTrendRecommendationReport, VoiceProofTrendRecommendationRoutesOptions, VoiceProofTrendRecommendationStatus, VoiceProofTrendRecommendationSurface, VoiceProofTrendReport, VoiceProofTrendReportInput, VoiceProofTrendRoutesOptions, VoiceProofTrendStatus, VoiceProofTrendSummary } 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

@@ -14538,7 +14538,7 @@ var maxNumber = (values) => {
   return finite.length > 0 ? Math.max(...finite) : undefined;
 };
 var readProofTrendMaxLiveP95 = (report) => report.summary.maxLiveP95Ms ?? maxNumber(report.cycles.map((cycle) => cycle.liveLatency?.p95Ms));
-var readProofTrendMaxProviderP95 = (report) => report.summary.maxProviderP95Ms;
+var readProofTrendMaxProviderP95 = (report) => report.summary.maxProviderP95Ms ?? maxNumber((report.summary.providers ?? []).map((provider) => provider.p95Ms)) ?? maxNumber(report.cycles.flatMap((cycle) => (cycle.providers ?? []).map((provider) => provider.p95Ms)));
 var readProofTrendMaxTurnP95 = (report) => report.summary.maxTurnP95Ms ?? maxNumber(report.cycles.map((cycle) => cycle.turnLatency?.p95Ms));
 var readRuntimeChannelMetric = (report, key) => {
   const summaryValue = report.summary.runtimeChannel?.[key];
@@ -14556,6 +14556,103 @@ var readProofTrendRuntimeChannel = (report) => ({
   samples: report.summary.runtimeChannel?.samples ?? maxNumber(report.cycles.map((cycle) => cycle.runtimeChannel?.samples)),
   status: report.summary.runtimeChannel?.status
 });
+var normalizeProviderStatus = (status) => status === "pass" ? "pass" : status === "fail" ? "fail" : "warn";
+var providerSortScore = (provider) => [
+  recommendationStatusRank[provider.status],
+  provider.p95Ms ?? Number.POSITIVE_INFINITY,
+  provider.averageMs ?? Number.POSITIVE_INFINITY,
+  provider.samples === undefined ? Number.POSITIVE_INFINITY : -provider.samples,
+  provider.id
+];
+var compareProviders = (left, right) => {
+  const leftScore = providerSortScore(left);
+  const rightScore = providerSortScore(right);
+  for (let index = 0;index < leftScore.length; index += 1) {
+    const leftValue = leftScore[index];
+    const rightValue = rightScore[index];
+    if (typeof leftValue === "number" && typeof rightValue === "number") {
+      if (leftValue !== rightValue) {
+        return leftValue - rightValue;
+      }
+      continue;
+    }
+    const compared = String(leftValue).localeCompare(String(rightValue));
+    if (compared !== 0) {
+      return compared;
+    }
+  }
+  return 0;
+};
+var summarizeProofTrendProviders = (report, budgetMs) => {
+  const sourceProviders = report.summary.providers && report.summary.providers.length > 0 ? report.summary.providers : undefined;
+  const providersById = new Map;
+  if (sourceProviders) {
+    for (const provider of sourceProviders) {
+      if (provider.id) {
+        providersById.set(provider.id, provider);
+      }
+    }
+  } else {
+    for (const cycle of report.cycles) {
+      for (const provider of cycle.providers ?? []) {
+        if (!provider.id) {
+          continue;
+        }
+        const existing = providersById.get(provider.id);
+        providersById.set(provider.id, {
+          averageMs: maxNumber([existing?.averageMs, provider.averageMs]),
+          id: provider.id,
+          label: existing?.label ?? provider.label,
+          p50Ms: maxNumber([existing?.p50Ms, provider.p50Ms]),
+          p95Ms: maxNumber([existing?.p95Ms, provider.p95Ms]),
+          role: existing?.role ?? provider.role,
+          samples: (existing?.samples ?? 0) + (provider.samples ?? 0),
+          status: existing?.status === "fail" || provider.status === "fail" ? "fail" : existing?.status === "warn" || provider.status === "warn" ? "warn" : provider.status ?? existing?.status
+        });
+      }
+    }
+  }
+  return [...providersById.values()].map((provider) => {
+    const status = provider.p95Ms === undefined ? normalizeProviderStatus(provider.status) : withinBudget(provider.p95Ms, budgetMs) ? normalizeProviderStatus(provider.status) === "fail" ? "fail" : "pass" : normalizeProviderStatus(provider.status) === "fail" ? "fail" : "warn";
+    return {
+      averageMs: provider.averageMs,
+      id: provider.id,
+      label: provider.label,
+      nextMove: status === "pass" ? "Eligible for latency-sensitive routing based on sustained proof." : provider.p95Ms === undefined ? "Collect provider-specific latency samples before routing latency-sensitive traffic here." : "Keep as fallback or tune provider/model/runtime budgets before using for latency-sensitive routing.",
+      p50Ms: provider.p50Ms,
+      p95Ms: provider.p95Ms,
+      rank: 0,
+      role: provider.role,
+      samples: provider.samples,
+      status
+    };
+  }).sort(compareProviders).map((provider, index) => ({ ...provider, rank: index + 1 }));
+};
+var shouldSwitchProvider = (current, best, options) => {
+  if (!current || !best || current.id === best.id || best.status !== "pass") {
+    return false;
+  }
+  if (current.p95Ms === undefined || best.p95Ms === undefined) {
+    return false;
+  }
+  const minImprovementMs = options.providerSwitchMinImprovementMs ?? 100;
+  const minImprovementRatio = options.providerSwitchMinImprovementRatio ?? 0.1;
+  const improvementMs = current.p95Ms - best.p95Ms;
+  const improvementRatio = current.p95Ms > 0 ? improvementMs / current.p95Ms : 0;
+  return improvementMs >= minImprovementMs || improvementRatio >= minImprovementRatio;
+};
+var bestProviderByRole = (providers) => {
+  const best = new Map;
+  for (const provider of providers) {
+    const role = provider.role ?? provider.id;
+    const existing = best.get(role);
+    if (!existing || compareProviders(provider, existing) < 0) {
+      best.set(role, provider);
+    }
+  }
+  return [...best.values()].sort((left, right) => String(left.role ?? left.id).localeCompare(String(right.role ?? right.id)));
+};
+var formatProviderMix = (providers) => providers.length === 0 ? "n/a" : providers.map((provider) => provider.role ? `${provider.role.toUpperCase()} ${provider.label ?? provider.id}` : provider.label ?? provider.id).join(", ");
 var evaluateVoiceProofTrendEvidence = (report, input = {}) => {
   const issues = [];
   const requiredStatus = input.requireStatus ?? "pass";
@@ -14670,6 +14767,12 @@ var buildVoiceProofTrendRecommendationReport = (report, options = {}) => {
   const maxProviderP95Ms = readProofTrendMaxProviderP95(report);
   const maxTurnP95Ms = readProofTrendMaxTurnP95(report);
   const runtimeChannel = readProofTrendRuntimeChannel(report);
+  const providers = summarizeProofTrendProviders(report, budgets.maxProviderP95Ms);
+  const bestProvider = providers.find((provider) => provider.status === "pass") ?? providers[0];
+  const bestProviders = bestProviderByRole(providers).filter((provider) => provider.status === "pass");
+  const currentProvider = options.currentProviderId ? providers.find((provider) => provider.id === options.currentProviderId) : undefined;
+  const bestComparableProvider = currentProvider?.role ? bestProviders.find((provider) => provider.role === currentProvider.role) : bestProvider;
+  const providerSwitchRecommended = shouldSwitchProvider(currentProvider, bestComparableProvider, options);
   const recommendations = [];
   const issues = [];
   if (report.ok !== true) {
@@ -14677,12 +14780,20 @@ var buildVoiceProofTrendRecommendationReport = (report, options = {}) => {
   }
   recommendations.push({
     evidence: {
+      bestProviderId: bestComparableProvider?.id ?? bestProvider?.id,
+      bestProviderMix: formatProviderMix(bestProviders),
+      bestProviderP95Ms: bestComparableProvider?.p95Ms ?? bestProvider?.p95Ms,
       budgetMs: budgets.maxProviderP95Ms,
+      currentProviderId: currentProvider?.id ?? options.currentProviderId,
+      currentProviderP95Ms: currentProvider?.p95Ms,
+      providerComparisonCount: providers.length,
       providerP95Ms: maxProviderP95Ms
     },
-    nextMove: withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "Keep the current provider route for latency-sensitive turns and keep collecting sustained proof." : "Route latency-sensitive turns to a faster provider profile or tighten fallback/circuit-breaker budgets before promotion.",
-    recommendation: withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "Keep current provider path" : "Change provider routing for latency-sensitive traffic",
-    status: withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "pass" : maxProviderP95Ms === undefined ? "fail" : "warn",
+    nextMove: providers.length > 0 ? providerSwitchRecommended ? `Route latency-sensitive ${currentProvider?.role ?? "provider"} traffic to ${bestComparableProvider?.label ?? bestComparableProvider?.id} for this call profile and keep the current path as fallback.` : bestProviders.length > 0 ? `Use the fastest proven provider mix for this call profile: ${formatProviderMix(bestProviders)}.` : "Collect provider-specific sustained samples before making provider-specific routing decisions." : withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "Keep the current provider route for latency-sensitive turns and keep collecting sustained proof." : "Route latency-sensitive turns to a faster provider profile or tighten fallback/circuit-breaker budgets before promotion.",
+    providerId: providerSwitchRecommended ? bestComparableProvider?.id : bestProviders.length === 1 ? bestProviders[0]?.id : undefined,
+    recommendation: providers.length > 0 ? providerSwitchRecommended ? `Switch latency-sensitive ${currentProvider?.role ?? "provider"} routing to ${bestComparableProvider?.label ?? bestComparableProvider?.id}` : bestProviders.length > 0 ? "Prefer the fastest proven provider mix for this call profile" : "Collect provider-specific latency samples" : withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "Keep current provider path" : "Change provider routing for latency-sensitive traffic",
+    role: bestComparableProvider?.role,
+    status: providers.length > 0 ? providerSwitchRecommended ? "warn" : bestProviders.length > 0 ? "pass" : bestProvider?.status ?? "fail" : withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "pass" : maxProviderP95Ms === undefined ? "fail" : "warn",
     surface: "provider-path"
   });
   const runtimePass = withinBudget(runtimeChannel.maxFirstAudioLatencyMs, budgets.maxRuntimeFirstAudioLatencyMs) && withinBudget(runtimeChannel.maxInterruptionP95Ms, budgets.maxRuntimeInterruptionP95Ms) && withinBudget(runtimeChannel.maxJitterMs, budgets.maxRuntimeJitterMs) && withinBudget(runtimeChannel.maxTimestampDriftMs, budgets.maxRuntimeTimestampDriftMs) && withinBudget(runtimeChannel.maxBackpressureEvents, budgets.maxRuntimeBackpressureEvents);
@@ -14725,16 +14836,21 @@ var buildVoiceProofTrendRecommendationReport = (report, options = {}) => {
   });
   const status = issues.length > 0 ? "fail" : worstRecommendationStatus(recommendations);
   return {
+    bestProvider,
+    bestProviders,
     generatedAt: new Date().toISOString(),
     issues,
     ok: status !== "fail",
+    providers,
     recommendations,
     source: report.source || report.outputDir || report.runId || "proof-trends",
     status,
     summary: {
-      keepCurrentProviderPath: recommendations.find((item) => item.surface === "provider-path")?.status === "pass",
+      keepCurrentProviderPath: !providerSwitchRecommended && recommendations.find((item) => item.surface === "provider-path")?.status !== "fail",
       keepCurrentRuntimeChannel: recommendations.find((item) => item.surface === "runtime-channel")?.status === "pass",
-      recommendedActions: recommendations.filter((item) => item.status !== "pass").length
+      providerComparisonCount: providers.length,
+      recommendedActions: recommendations.filter((item) => item.status !== "pass").length,
+      switchRecommended: providerSwitchRecommended
     }
   };
 };
@@ -14745,12 +14861,20 @@ var renderVoiceProofTrendRecommendationMarkdown = (report, title = "Voice Provid
   "",
   `- Status: ${report.status}`,
   `- Source: ${report.source}`,
+  `- Best provider mix: ${formatProviderMix(report.bestProviders)}`,
+  `- Provider comparisons: ${String(report.summary.providerComparisonCount)}`,
   `- Recommended actions: ${String(report.summary.recommendedActions)}`,
   "",
   "| Surface | Status | Recommendation | Next move |",
   "| --- | --- | --- | --- |",
   ...report.recommendations.map((recommendation) => `| ${escapeMarkdown2(recommendation.surface)} | ${recommendation.status} | ${escapeMarkdown2(recommendation.recommendation)} | ${escapeMarkdown2(recommendation.nextMove)} |`),
   "",
+  "## Provider Comparison",
+  "",
+  "| Rank | Provider | Role | Status | P95 | Samples | Next move |",
+  "| ---: | --- | --- | --- | ---: | ---: | --- |",
+  ...report.providers.length ? report.providers.map((provider) => `| ${String(provider.rank)} | ${escapeMarkdown2(provider.label ?? provider.id)} | ${escapeMarkdown2(provider.role ?? "n/a")} | ${provider.status} | ${provider.p95Ms === undefined ? "n/a" : String(provider.p95Ms)} | ${provider.samples === undefined ? "n/a" : String(provider.samples)} | ${escapeMarkdown2(provider.nextMove)} |`) : ["| n/a | n/a | n/a | n/a | n/a | n/a | No provider-specific samples were present. |"],
+  "",
   "## Issues",
   "",
   ...report.issues.length ? report.issues.map((issue) => `- ${issue}`) : ["- None"]
@@ -14759,7 +14883,8 @@ var renderVoiceProofTrendRecommendationMarkdown = (report, title = "Voice Provid
 var renderVoiceProofTrendRecommendationHTML = (report, title = "Voice Provider Runtime Recommendations") => {
   const cards = report.recommendations.map((recommendation) => `<article class="${escapeHtml22(recommendation.status)}"><p class="eyebrow">${escapeHtml22(recommendation.surface)} \xB7 ${escapeHtml22(recommendation.status)}</p><h2>${escapeHtml22(recommendation.recommendation)}</h2><p>${escapeHtml22(recommendation.nextMove)}</p><pre>${escapeHtml22(JSON.stringify(recommendation.evidence, null, 2))}</pre></article>`).join("");
   const issues = report.issues.length === 0 ? "<li>None</li>" : report.issues.map((issue) => `<li>${escapeHtml22(issue)}</li>`).join("");
-  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width,initial-scale=1" /><title>${escapeHtml22(title)}</title><style>body{background:#101418;color:#f7f3e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.hero,article{background:#17201d;border:1px solid #2e3d36;border-radius:24px;margin-bottom:16px;padding:22px}.hero{background:linear-gradient(135deg,rgba(20,184,166,.18),rgba(245,158,11,.12))}.eyebrow{color:#5eead4;font-weight:900;letter-spacing:.1em;text-transform:uppercase}h1{font-size:clamp(2.2rem,6vw,4.7rem);letter-spacing:-.06em;line-height:.92;margin:.2rem 0 1rem}.summary{display:flex;flex-wrap:wrap;gap:10px}.pill{border:1px solid #42534a;border-radius:999px;padding:8px 12px}.pass{border-color:rgba(34,197,94,.55)}.warn{border-color:rgba(245,158,11,.7)}.fail{border-color:rgba(239,68,68,.75)}pre{background:#0b1110;border-radius:14px;overflow:auto;padding:12px}a{color:#5eead4}</style></head><body><main><section class="hero"><p class="eyebrow">Sustained proof recommendations</p><h1>${escapeHtml22(title)}</h1><p>Generated ${escapeHtml22(report.generatedAt)} from ${escapeHtml22(report.source)}.</p><div class="summary"><span class="pill">Status ${escapeHtml22(report.status)}</span><span class="pill">Provider ${report.summary.keepCurrentProviderPath ? "keep" : "change"}</span><span class="pill">Runtime ${report.summary.keepCurrentRuntimeChannel ? "keep" : "tune"}</span><span class="pill">${String(report.summary.recommendedActions)} action(s)</span></div></section>${cards}<section class="hero"><h2>Issues</h2><ul>${issues}</ul></section></main></body></html>`;
+  const providerRows = report.providers.length === 0 ? "<li>No provider-specific samples were present.</li>" : report.providers.map((provider) => `<li><strong>#${String(provider.rank)} ${escapeHtml22(provider.label ?? provider.id)}</strong><span>${escapeHtml22(provider.role ?? "provider")} \xB7 ${escapeHtml22(provider.status)} \xB7 p95 ${escapeHtml22(provider.p95Ms ?? "n/a")}ms \xB7 ${escapeHtml22(provider.samples ?? "n/a")} sample(s)</span><small>${escapeHtml22(provider.nextMove)}</small></li>`).join("");
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width,initial-scale=1" /><title>${escapeHtml22(title)}</title><style>body{background:#101418;color:#f7f3e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.hero,article{background:#17201d;border:1px solid #2e3d36;border-radius:24px;margin-bottom:16px;padding:22px}.hero{background:linear-gradient(135deg,rgba(20,184,166,.18),rgba(245,158,11,.12))}.eyebrow{color:#5eead4;font-weight:900;letter-spacing:.1em;text-transform:uppercase}h1{font-size:clamp(2.2rem,6vw,4.7rem);letter-spacing:-.06em;line-height:.92;margin:.2rem 0 1rem}.summary{display:flex;flex-wrap:wrap;gap:10px}.pill{border:1px solid #42534a;border-radius:999px;padding:8px 12px}.pass{border-color:rgba(34,197,94,.55)}.warn{border-color:rgba(245,158,11,.7)}.fail{border-color:rgba(239,68,68,.75)}pre{background:#0b1110;border-radius:14px;overflow:auto;padding:12px}a{color:#5eead4}li{margin:.45rem 0}li span,li small{display:block;color:#c9d3ca}</style></head><body><main><section class="hero"><p class="eyebrow">Sustained proof recommendations</p><h1>${escapeHtml22(title)}</h1><p>Generated ${escapeHtml22(report.generatedAt)} from ${escapeHtml22(report.source)}.</p><div class="summary"><span class="pill">Status ${escapeHtml22(report.status)}</span><span class="pill">Provider ${report.summary.keepCurrentProviderPath ? "keep" : "change"}</span><span class="pill">Best mix ${escapeHtml22(formatProviderMix(report.bestProviders))}</span><span class="pill">Runtime ${report.summary.keepCurrentRuntimeChannel ? "keep" : "tune"}</span><span class="pill">${String(report.summary.recommendedActions)} action(s)</span></div></section>${cards}<section class="hero"><h2>Provider Comparison</h2><ul>${providerRows}</ul></section><section class="hero"><h2>Issues</h2><ul>${issues}</ul></section></main></body></html>`;
 };
 var createVoiceProofTrendRecommendationRoutes = (options) => {
   const path = options.path ?? "/api/voice/proof-trend-recommendations";

package/dist/proofTrends.d.ts

@@ -4,9 +4,20 @@ export type VoiceProofTrendSummary = {
     cycles?: number;
     maxLiveP95Ms?: number;
     maxProviderP95Ms?: number;
+    providers?: VoiceProofTrendProviderSummary[];
     runtimeChannel?: VoiceProofTrendRuntimeChannelSummary;
     maxTurnP95Ms?: number;
 };
+export type VoiceProofTrendProviderSummary = {
+    averageMs?: number;
+    id: string;
+    label?: string;
+    p50Ms?: number;
+    p95Ms?: number;
+    role?: string;
+    samples?: number;
+    status?: string;
+};
 export type VoiceProofTrendRuntimeChannelSummary = {
     maxBackpressureEvents?: number;
     maxFirstAudioLatencyMs?: number;
@@ -36,6 +47,7 @@ export type VoiceProofTrendCycle = {
         eventsWithLatency?: number;
         status?: string;
     };
+    providers?: VoiceProofTrendProviderSummary[];
     runtimeChannel?: VoiceProofTrendRuntimeChannelSummary;
     turnLatency?: {
         p95Ms?: number;
@@ -113,24 +125,44 @@ export type VoiceProofTrendRecommendationSurface = 'live-latency' | 'provider-pa
 export type VoiceProofTrendRecommendation = {
     evidence: Record<string, number | string | undefined>;
     nextMove: string;
+    providerId?: string;
+    role?: string;
     recommendation: string;
     status: VoiceProofTrendRecommendationStatus;
     surface: VoiceProofTrendRecommendationSurface;
 };
+export type VoiceProofTrendProviderRecommendation = {
+    averageMs?: number;
+    id: string;
+    label?: string;
+    nextMove: string;
+    p50Ms?: number;
+    p95Ms?: number;
+    rank: number;
+    role?: string;
+    samples?: number;
+    status: VoiceProofTrendRecommendationStatus;
+};
 export type VoiceProofTrendRecommendationReport = {
+    bestProvider?: VoiceProofTrendProviderRecommendation;
+    bestProviders: VoiceProofTrendProviderRecommendation[];
     generatedAt: string;
     issues: string[];
     ok: boolean;
+    providers: VoiceProofTrendProviderRecommendation[];
     recommendations: VoiceProofTrendRecommendation[];
     source: string;
     status: VoiceProofTrendRecommendationStatus;
     summary: {
         keepCurrentProviderPath: boolean;
         keepCurrentRuntimeChannel: boolean;
+        providerComparisonCount: number;
         recommendedActions: number;
+        switchRecommended: boolean;
     };
 };
 export type VoiceProofTrendRecommendationOptions = {
+    currentProviderId?: string;
     maxLiveP95Ms?: number;
     maxProviderP95Ms?: number;
     maxRuntimeBackpressureEvents?: number;
@@ -139,6 +171,8 @@ export type VoiceProofTrendRecommendationOptions = {
     maxRuntimeJitterMs?: number;
     maxRuntimeTimestampDriftMs?: number;
     maxTurnP95Ms?: number;
+    providerSwitchMinImprovementMs?: number;
+    providerSwitchMinImprovementRatio?: number;
 };
 export type VoiceProofTrendRecommendationRoutesOptions = VoiceProofTrendRecommendationOptions & {
     headers?: HeadersInit;

package/dist/react/index.js

@@ -1569,7 +1569,7 @@ var maxNumber = (values) => {
   return finite.length > 0 ? Math.max(...finite) : undefined;
 };
 var readProofTrendMaxLiveP95 = (report) => report.summary.maxLiveP95Ms ?? maxNumber(report.cycles.map((cycle) => cycle.liveLatency?.p95Ms));
-var readProofTrendMaxProviderP95 = (report) => report.summary.maxProviderP95Ms;
+var readProofTrendMaxProviderP95 = (report) => report.summary.maxProviderP95Ms ?? maxNumber((report.summary.providers ?? []).map((provider) => provider.p95Ms)) ?? maxNumber(report.cycles.flatMap((cycle) => (cycle.providers ?? []).map((provider) => provider.p95Ms)));
 var readProofTrendMaxTurnP95 = (report) => report.summary.maxTurnP95Ms ?? maxNumber(report.cycles.map((cycle) => cycle.turnLatency?.p95Ms));
 var readRuntimeChannelMetric = (report, key) => {
   const summaryValue = report.summary.runtimeChannel?.[key];
@@ -1587,6 +1587,103 @@ var readProofTrendRuntimeChannel = (report) => ({
   samples: report.summary.runtimeChannel?.samples ?? maxNumber(report.cycles.map((cycle) => cycle.runtimeChannel?.samples)),
   status: report.summary.runtimeChannel?.status
 });
+var normalizeProviderStatus = (status) => status === "pass" ? "pass" : status === "fail" ? "fail" : "warn";
+var providerSortScore = (provider) => [
+  recommendationStatusRank[provider.status],
+  provider.p95Ms ?? Number.POSITIVE_INFINITY,
+  provider.averageMs ?? Number.POSITIVE_INFINITY,
+  provider.samples === undefined ? Number.POSITIVE_INFINITY : -provider.samples,
+  provider.id
+];
+var compareProviders = (left, right) => {
+  const leftScore = providerSortScore(left);
+  const rightScore = providerSortScore(right);
+  for (let index = 0;index < leftScore.length; index += 1) {
+    const leftValue = leftScore[index];
+    const rightValue = rightScore[index];
+    if (typeof leftValue === "number" && typeof rightValue === "number") {
+      if (leftValue !== rightValue) {
+        return leftValue - rightValue;
+      }
+      continue;
+    }
+    const compared = String(leftValue).localeCompare(String(rightValue));
+    if (compared !== 0) {
+      return compared;
+    }
+  }
+  return 0;
+};
+var summarizeProofTrendProviders = (report, budgetMs) => {
+  const sourceProviders = report.summary.providers && report.summary.providers.length > 0 ? report.summary.providers : undefined;
+  const providersById = new Map;
+  if (sourceProviders) {
+    for (const provider of sourceProviders) {
+      if (provider.id) {
+        providersById.set(provider.id, provider);
+      }
+    }
+  } else {
+    for (const cycle of report.cycles) {
+      for (const provider of cycle.providers ?? []) {
+        if (!provider.id) {
+          continue;
+        }
+        const existing = providersById.get(provider.id);
+        providersById.set(provider.id, {
+          averageMs: maxNumber([existing?.averageMs, provider.averageMs]),
+          id: provider.id,
+          label: existing?.label ?? provider.label,
+          p50Ms: maxNumber([existing?.p50Ms, provider.p50Ms]),
+          p95Ms: maxNumber([existing?.p95Ms, provider.p95Ms]),
+          role: existing?.role ?? provider.role,
+          samples: (existing?.samples ?? 0) + (provider.samples ?? 0),
+          status: existing?.status === "fail" || provider.status === "fail" ? "fail" : existing?.status === "warn" || provider.status === "warn" ? "warn" : provider.status ?? existing?.status
+        });
+      }
+    }
+  }
+  return [...providersById.values()].map((provider) => {
+    const status = provider.p95Ms === undefined ? normalizeProviderStatus(provider.status) : withinBudget(provider.p95Ms, budgetMs) ? normalizeProviderStatus(provider.status) === "fail" ? "fail" : "pass" : normalizeProviderStatus(provider.status) === "fail" ? "fail" : "warn";
+    return {
+      averageMs: provider.averageMs,
+      id: provider.id,
+      label: provider.label,
+      nextMove: status === "pass" ? "Eligible for latency-sensitive routing based on sustained proof." : provider.p95Ms === undefined ? "Collect provider-specific latency samples before routing latency-sensitive traffic here." : "Keep as fallback or tune provider/model/runtime budgets before using for latency-sensitive routing.",
+      p50Ms: provider.p50Ms,
+      p95Ms: provider.p95Ms,
+      rank: 0,
+      role: provider.role,
+      samples: provider.samples,
+      status
+    };
+  }).sort(compareProviders).map((provider, index) => ({ ...provider, rank: index + 1 }));
+};
+var shouldSwitchProvider = (current, best, options) => {
+  if (!current || !best || current.id === best.id || best.status !== "pass") {
+    return false;
+  }
+  if (current.p95Ms === undefined || best.p95Ms === undefined) {
+    return false;
+  }
+  const minImprovementMs = options.providerSwitchMinImprovementMs ?? 100;
+  const minImprovementRatio = options.providerSwitchMinImprovementRatio ?? 0.1;
+  const improvementMs = current.p95Ms - best.p95Ms;
+  const improvementRatio = current.p95Ms > 0 ? improvementMs / current.p95Ms : 0;
+  return improvementMs >= minImprovementMs || improvementRatio >= minImprovementRatio;
+};
+var bestProviderByRole = (providers) => {
+  const best = new Map;
+  for (const provider of providers) {
+    const role = provider.role ?? provider.id;
+    const existing = best.get(role);
+    if (!existing || compareProviders(provider, existing) < 0) {
+      best.set(role, provider);
+    }
+  }
+  return [...best.values()].sort((left, right) => String(left.role ?? left.id).localeCompare(String(right.role ?? right.id)));
+};
+var formatProviderMix = (providers) => providers.length === 0 ? "n/a" : providers.map((provider) => provider.role ? `${provider.role.toUpperCase()} ${provider.label ?? provider.id}` : provider.label ?? provider.id).join(", ");
 var evaluateVoiceProofTrendEvidence = (report, input = {}) => {
   const issues = [];
   const requiredStatus = input.requireStatus ?? "pass";
@@ -1701,6 +1798,12 @@ var buildVoiceProofTrendRecommendationReport = (report, options = {}) => {
   const maxProviderP95Ms = readProofTrendMaxProviderP95(report);
   const maxTurnP95Ms = readProofTrendMaxTurnP95(report);
   const runtimeChannel = readProofTrendRuntimeChannel(report);
+  const providers = summarizeProofTrendProviders(report, budgets.maxProviderP95Ms);
+  const bestProvider = providers.find((provider) => provider.status === "pass") ?? providers[0];
+  const bestProviders = bestProviderByRole(providers).filter((provider) => provider.status === "pass");
+  const currentProvider = options.currentProviderId ? providers.find((provider) => provider.id === options.currentProviderId) : undefined;
+  const bestComparableProvider = currentProvider?.role ? bestProviders.find((provider) => provider.role === currentProvider.role) : bestProvider;
+  const providerSwitchRecommended = shouldSwitchProvider(currentProvider, bestComparableProvider, options);
   const recommendations = [];
   const issues = [];
   if (report.ok !== true) {
@@ -1708,12 +1811,20 @@ var buildVoiceProofTrendRecommendationReport = (report, options = {}) => {
   }
   recommendations.push({
     evidence: {
+      bestProviderId: bestComparableProvider?.id ?? bestProvider?.id,
+      bestProviderMix: formatProviderMix(bestProviders),
+      bestProviderP95Ms: bestComparableProvider?.p95Ms ?? bestProvider?.p95Ms,
       budgetMs: budgets.maxProviderP95Ms,
+      currentProviderId: currentProvider?.id ?? options.currentProviderId,
+      currentProviderP95Ms: currentProvider?.p95Ms,
+      providerComparisonCount: providers.length,
       providerP95Ms: maxProviderP95Ms
     },
-    nextMove: withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "Keep the current provider route for latency-sensitive turns and keep collecting sustained proof." : "Route latency-sensitive turns to a faster provider profile or tighten fallback/circuit-breaker budgets before promotion.",
-    recommendation: withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "Keep current provider path" : "Change provider routing for latency-sensitive traffic",
-    status: withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "pass" : maxProviderP95Ms === undefined ? "fail" : "warn",
+    nextMove: providers.length > 0 ? providerSwitchRecommended ? `Route latency-sensitive ${currentProvider?.role ?? "provider"} traffic to ${bestComparableProvider?.label ?? bestComparableProvider?.id} for this call profile and keep the current path as fallback.` : bestProviders.length > 0 ? `Use the fastest proven provider mix for this call profile: ${formatProviderMix(bestProviders)}.` : "Collect provider-specific sustained samples before making provider-specific routing decisions." : withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "Keep the current provider route for latency-sensitive turns and keep collecting sustained proof." : "Route latency-sensitive turns to a faster provider profile or tighten fallback/circuit-breaker budgets before promotion.",
+    providerId: providerSwitchRecommended ? bestComparableProvider?.id : bestProviders.length === 1 ? bestProviders[0]?.id : undefined,
+    recommendation: providers.length > 0 ? providerSwitchRecommended ? `Switch latency-sensitive ${currentProvider?.role ?? "provider"} routing to ${bestComparableProvider?.label ?? bestComparableProvider?.id}` : bestProviders.length > 0 ? "Prefer the fastest proven provider mix for this call profile" : "Collect provider-specific latency samples" : withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "Keep current provider path" : "Change provider routing for latency-sensitive traffic",
+    role: bestComparableProvider?.role,
+    status: providers.length > 0 ? providerSwitchRecommended ? "warn" : bestProviders.length > 0 ? "pass" : bestProvider?.status ?? "fail" : withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "pass" : maxProviderP95Ms === undefined ? "fail" : "warn",
     surface: "provider-path"
   });
   const runtimePass = withinBudget(runtimeChannel.maxFirstAudioLatencyMs, budgets.maxRuntimeFirstAudioLatencyMs) && withinBudget(runtimeChannel.maxInterruptionP95Ms, budgets.maxRuntimeInterruptionP95Ms) && withinBudget(runtimeChannel.maxJitterMs, budgets.maxRuntimeJitterMs) && withinBudget(runtimeChannel.maxTimestampDriftMs, budgets.maxRuntimeTimestampDriftMs) && withinBudget(runtimeChannel.maxBackpressureEvents, budgets.maxRuntimeBackpressureEvents);
@@ -1756,16 +1867,21 @@ var buildVoiceProofTrendRecommendationReport = (report, options = {}) => {
   });
   const status = issues.length > 0 ? "fail" : worstRecommendationStatus(recommendations);
   return {
+    bestProvider,
+    bestProviders,
     generatedAt: new Date().toISOString(),
     issues,
     ok: status !== "fail",
+    providers,
     recommendations,
     source: report.source || report.outputDir || report.runId || "proof-trends",
     status,
     summary: {
-      keepCurrentProviderPath: recommendations.find((item) => item.surface === "provider-path")?.status === "pass",
+      keepCurrentProviderPath: !providerSwitchRecommended && recommendations.find((item) => item.surface === "provider-path")?.status !== "fail",
       keepCurrentRuntimeChannel: recommendations.find((item) => item.surface === "runtime-channel")?.status === "pass",
-      recommendedActions: recommendations.filter((item) => item.status !== "pass").length
+      providerComparisonCount: providers.length,
+      recommendedActions: recommendations.filter((item) => item.status !== "pass").length,
+      switchRecommended: providerSwitchRecommended
     }
   };
 };
@@ -1776,12 +1892,20 @@ var renderVoiceProofTrendRecommendationMarkdown = (report, title = "Voice Provid
   "",
   `- Status: ${report.status}`,
   `- Source: ${report.source}`,
+  `- Best provider mix: ${formatProviderMix(report.bestProviders)}`,
+  `- Provider comparisons: ${String(report.summary.providerComparisonCount)}`,
   `- Recommended actions: ${String(report.summary.recommendedActions)}`,
   "",
   "| Surface | Status | Recommendation | Next move |",
   "| --- | --- | --- | --- |",
   ...report.recommendations.map((recommendation) => `| ${escapeMarkdown(recommendation.surface)} | ${recommendation.status} | ${escapeMarkdown(recommendation.recommendation)} | ${escapeMarkdown(recommendation.nextMove)} |`),
   "",
+  "## Provider Comparison",
+  "",
+  "| Rank | Provider | Role | Status | P95 | Samples | Next move |",
+  "| ---: | --- | --- | --- | ---: | ---: | --- |",
+  ...report.providers.length ? report.providers.map((provider) => `| ${String(provider.rank)} | ${escapeMarkdown(provider.label ?? provider.id)} | ${escapeMarkdown(provider.role ?? "n/a")} | ${provider.status} | ${provider.p95Ms === undefined ? "n/a" : String(provider.p95Ms)} | ${provider.samples === undefined ? "n/a" : String(provider.samples)} | ${escapeMarkdown(provider.nextMove)} |`) : ["| n/a | n/a | n/a | n/a | n/a | n/a | No provider-specific samples were present. |"],
+  "",
   "## Issues",
   "",
   ...report.issues.length ? report.issues.map((issue) => `- ${issue}`) : ["- None"]
@@ -1790,7 +1914,8 @@ var renderVoiceProofTrendRecommendationMarkdown = (report, title = "Voice Provid
 var renderVoiceProofTrendRecommendationHTML = (report, title = "Voice Provider Runtime Recommendations") => {
   const cards = report.recommendations.map((recommendation) => `<article class="${escapeHtml5(recommendation.status)}"><p class="eyebrow">${escapeHtml5(recommendation.surface)} \xB7 ${escapeHtml5(recommendation.status)}</p><h2>${escapeHtml5(recommendation.recommendation)}</h2><p>${escapeHtml5(recommendation.nextMove)}</p><pre>${escapeHtml5(JSON.stringify(recommendation.evidence, null, 2))}</pre></article>`).join("");
   const issues = report.issues.length === 0 ? "<li>None</li>" : report.issues.map((issue) => `<li>${escapeHtml5(issue)}</li>`).join("");
-  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width,initial-scale=1" /><title>${escapeHtml5(title)}</title><style>body{background:#101418;color:#f7f3e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.hero,article{background:#17201d;border:1px solid #2e3d36;border-radius:24px;margin-bottom:16px;padding:22px}.hero{background:linear-gradient(135deg,rgba(20,184,166,.18),rgba(245,158,11,.12))}.eyebrow{color:#5eead4;font-weight:900;letter-spacing:.1em;text-transform:uppercase}h1{font-size:clamp(2.2rem,6vw,4.7rem);letter-spacing:-.06em;line-height:.92;margin:.2rem 0 1rem}.summary{display:flex;flex-wrap:wrap;gap:10px}.pill{border:1px solid #42534a;border-radius:999px;padding:8px 12px}.pass{border-color:rgba(34,197,94,.55)}.warn{border-color:rgba(245,158,11,.7)}.fail{border-color:rgba(239,68,68,.75)}pre{background:#0b1110;border-radius:14px;overflow:auto;padding:12px}a{color:#5eead4}</style></head><body><main><section class="hero"><p class="eyebrow">Sustained proof recommendations</p><h1>${escapeHtml5(title)}</h1><p>Generated ${escapeHtml5(report.generatedAt)} from ${escapeHtml5(report.source)}.</p><div class="summary"><span class="pill">Status ${escapeHtml5(report.status)}</span><span class="pill">Provider ${report.summary.keepCurrentProviderPath ? "keep" : "change"}</span><span class="pill">Runtime ${report.summary.keepCurrentRuntimeChannel ? "keep" : "tune"}</span><span class="pill">${String(report.summary.recommendedActions)} action(s)</span></div></section>${cards}<section class="hero"><h2>Issues</h2><ul>${issues}</ul></section></main></body></html>`;
+  const providerRows = report.providers.length === 0 ? "<li>No provider-specific samples were present.</li>" : report.providers.map((provider) => `<li><strong>#${String(provider.rank)} ${escapeHtml5(provider.label ?? provider.id)}</strong><span>${escapeHtml5(provider.role ?? "provider")} \xB7 ${escapeHtml5(provider.status)} \xB7 p95 ${escapeHtml5(provider.p95Ms ?? "n/a")}ms \xB7 ${escapeHtml5(provider.samples ?? "n/a")} sample(s)</span><small>${escapeHtml5(provider.nextMove)}</small></li>`).join("");
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width,initial-scale=1" /><title>${escapeHtml5(title)}</title><style>body{background:#101418;color:#f7f3e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.hero,article{background:#17201d;border:1px solid #2e3d36;border-radius:24px;margin-bottom:16px;padding:22px}.hero{background:linear-gradient(135deg,rgba(20,184,166,.18),rgba(245,158,11,.12))}.eyebrow{color:#5eead4;font-weight:900;letter-spacing:.1em;text-transform:uppercase}h1{font-size:clamp(2.2rem,6vw,4.7rem);letter-spacing:-.06em;line-height:.92;margin:.2rem 0 1rem}.summary{display:flex;flex-wrap:wrap;gap:10px}.pill{border:1px solid #42534a;border-radius:999px;padding:8px 12px}.pass{border-color:rgba(34,197,94,.55)}.warn{border-color:rgba(245,158,11,.7)}.fail{border-color:rgba(239,68,68,.75)}pre{background:#0b1110;border-radius:14px;overflow:auto;padding:12px}a{color:#5eead4}li{margin:.45rem 0}li span,li small{display:block;color:#c9d3ca}</style></head><body><main><section class="hero"><p class="eyebrow">Sustained proof recommendations</p><h1>${escapeHtml5(title)}</h1><p>Generated ${escapeHtml5(report.generatedAt)} from ${escapeHtml5(report.source)}.</p><div class="summary"><span class="pill">Status ${escapeHtml5(report.status)}</span><span class="pill">Provider ${report.summary.keepCurrentProviderPath ? "keep" : "change"}</span><span class="pill">Best mix ${escapeHtml5(formatProviderMix(report.bestProviders))}</span><span class="pill">Runtime ${report.summary.keepCurrentRuntimeChannel ? "keep" : "tune"}</span><span class="pill">${String(report.summary.recommendedActions)} action(s)</span></div></section>${cards}<section class="hero"><h2>Provider Comparison</h2><ul>${providerRows}</ul></section><section class="hero"><h2>Issues</h2><ul>${issues}</ul></section></main></body></html>`;
 };
 var createVoiceProofTrendRecommendationRoutes = (options) => {
   const path = options.path ?? "/api/voice/proof-trend-recommendations";

package/dist/vue/index.js

@@ -1490,7 +1490,7 @@ var maxNumber = (values) => {
   return finite.length > 0 ? Math.max(...finite) : undefined;
 };
 var readProofTrendMaxLiveP95 = (report) => report.summary.maxLiveP95Ms ?? maxNumber(report.cycles.map((cycle) => cycle.liveLatency?.p95Ms));
-var readProofTrendMaxProviderP95 = (report) => report.summary.maxProviderP95Ms;
+var readProofTrendMaxProviderP95 = (report) => report.summary.maxProviderP95Ms ?? maxNumber((report.summary.providers ?? []).map((provider) => provider.p95Ms)) ?? maxNumber(report.cycles.flatMap((cycle) => (cycle.providers ?? []).map((provider) => provider.p95Ms)));
 var readProofTrendMaxTurnP95 = (report) => report.summary.maxTurnP95Ms ?? maxNumber(report.cycles.map((cycle) => cycle.turnLatency?.p95Ms));
 var readRuntimeChannelMetric = (report, key) => {
   const summaryValue = report.summary.runtimeChannel?.[key];
@@ -1508,6 +1508,103 @@ var readProofTrendRuntimeChannel = (report) => ({
   samples: report.summary.runtimeChannel?.samples ?? maxNumber(report.cycles.map((cycle) => cycle.runtimeChannel?.samples)),
   status: report.summary.runtimeChannel?.status
 });
+var normalizeProviderStatus = (status) => status === "pass" ? "pass" : status === "fail" ? "fail" : "warn";
+var providerSortScore = (provider) => [
+  recommendationStatusRank[provider.status],
+  provider.p95Ms ?? Number.POSITIVE_INFINITY,
+  provider.averageMs ?? Number.POSITIVE_INFINITY,
+  provider.samples === undefined ? Number.POSITIVE_INFINITY : -provider.samples,
+  provider.id
+];
+var compareProviders = (left, right) => {
+  const leftScore = providerSortScore(left);
+  const rightScore = providerSortScore(right);
+  for (let index = 0;index < leftScore.length; index += 1) {
+    const leftValue = leftScore[index];
+    const rightValue = rightScore[index];
+    if (typeof leftValue === "number" && typeof rightValue === "number") {
+      if (leftValue !== rightValue) {
+        return leftValue - rightValue;
+      }
+      continue;
+    }
+    const compared = String(leftValue).localeCompare(String(rightValue));
+    if (compared !== 0) {
+      return compared;
+    }
+  }
+  return 0;
+};
+var summarizeProofTrendProviders = (report, budgetMs) => {
+  const sourceProviders = report.summary.providers && report.summary.providers.length > 0 ? report.summary.providers : undefined;
+  const providersById = new Map;
+  if (sourceProviders) {
+    for (const provider of sourceProviders) {
+      if (provider.id) {
+        providersById.set(provider.id, provider);
+      }
+    }
+  } else {
+    for (const cycle of report.cycles) {
+      for (const provider of cycle.providers ?? []) {
+        if (!provider.id) {
+          continue;
+        }
+        const existing = providersById.get(provider.id);
+        providersById.set(provider.id, {
+          averageMs: maxNumber([existing?.averageMs, provider.averageMs]),
+          id: provider.id,
+          label: existing?.label ?? provider.label,
+          p50Ms: maxNumber([existing?.p50Ms, provider.p50Ms]),
+          p95Ms: maxNumber([existing?.p95Ms, provider.p95Ms]),
+          role: existing?.role ?? provider.role,
+          samples: (existing?.samples ?? 0) + (provider.samples ?? 0),
+          status: existing?.status === "fail" || provider.status === "fail" ? "fail" : existing?.status === "warn" || provider.status === "warn" ? "warn" : provider.status ?? existing?.status
+        });
+      }
+    }
+  }
+  return [...providersById.values()].map((provider) => {
+    const status = provider.p95Ms === undefined ? normalizeProviderStatus(provider.status) : withinBudget(provider.p95Ms, budgetMs) ? normalizeProviderStatus(provider.status) === "fail" ? "fail" : "pass" : normalizeProviderStatus(provider.status) === "fail" ? "fail" : "warn";
+    return {
+      averageMs: provider.averageMs,
+      id: provider.id,
+      label: provider.label,
+      nextMove: status === "pass" ? "Eligible for latency-sensitive routing based on sustained proof." : provider.p95Ms === undefined ? "Collect provider-specific latency samples before routing latency-sensitive traffic here." : "Keep as fallback or tune provider/model/runtime budgets before using for latency-sensitive routing.",
+      p50Ms: provider.p50Ms,
+      p95Ms: provider.p95Ms,
+      rank: 0,
+      role: provider.role,
+      samples: provider.samples,
+      status
+    };
+  }).sort(compareProviders).map((provider, index) => ({ ...provider, rank: index + 1 }));
+};
+var shouldSwitchProvider = (current, best, options) => {
+  if (!current || !best || current.id === best.id || best.status !== "pass") {
+    return false;
+  }
+  if (current.p95Ms === undefined || best.p95Ms === undefined) {
+    return false;
+  }
+  const minImprovementMs = options.providerSwitchMinImprovementMs ?? 100;
+  const minImprovementRatio = options.providerSwitchMinImprovementRatio ?? 0.1;
+  const improvementMs = current.p95Ms - best.p95Ms;
+  const improvementRatio = current.p95Ms > 0 ? improvementMs / current.p95Ms : 0;
+  return improvementMs >= minImprovementMs || improvementRatio >= minImprovementRatio;
+};
+var bestProviderByRole = (providers) => {
+  const best = new Map;
+  for (const provider of providers) {
+    const role = provider.role ?? provider.id;
+    const existing = best.get(role);
+    if (!existing || compareProviders(provider, existing) < 0) {
+      best.set(role, provider);
+    }
+  }
+  return [...best.values()].sort((left, right) => String(left.role ?? left.id).localeCompare(String(right.role ?? right.id)));
+};
+var formatProviderMix = (providers) => providers.length === 0 ? "n/a" : providers.map((provider) => provider.role ? `${provider.role.toUpperCase()} ${provider.label ?? provider.id}` : provider.label ?? provider.id).join(", ");
 var evaluateVoiceProofTrendEvidence = (report, input = {}) => {
   const issues = [];
   const requiredStatus = input.requireStatus ?? "pass";
@@ -1622,6 +1719,12 @@ var buildVoiceProofTrendRecommendationReport = (report, options = {}) => {
   const maxProviderP95Ms = readProofTrendMaxProviderP95(report);
   const maxTurnP95Ms = readProofTrendMaxTurnP95(report);
   const runtimeChannel = readProofTrendRuntimeChannel(report);
+  const providers = summarizeProofTrendProviders(report, budgets.maxProviderP95Ms);
+  const bestProvider = providers.find((provider) => provider.status === "pass") ?? providers[0];
+  const bestProviders = bestProviderByRole(providers).filter((provider) => provider.status === "pass");
+  const currentProvider = options.currentProviderId ? providers.find((provider) => provider.id === options.currentProviderId) : undefined;
+  const bestComparableProvider = currentProvider?.role ? bestProviders.find((provider) => provider.role === currentProvider.role) : bestProvider;
+  const providerSwitchRecommended = shouldSwitchProvider(currentProvider, bestComparableProvider, options);
   const recommendations = [];
   const issues = [];
   if (report.ok !== true) {
@@ -1629,12 +1732,20 @@ var buildVoiceProofTrendRecommendationReport = (report, options = {}) => {
   }
   recommendations.push({
     evidence: {
+      bestProviderId: bestComparableProvider?.id ?? bestProvider?.id,
+      bestProviderMix: formatProviderMix(bestProviders),
+      bestProviderP95Ms: bestComparableProvider?.p95Ms ?? bestProvider?.p95Ms,
       budgetMs: budgets.maxProviderP95Ms,
+      currentProviderId: currentProvider?.id ?? options.currentProviderId,
+      currentProviderP95Ms: currentProvider?.p95Ms,
+      providerComparisonCount: providers.length,
       providerP95Ms: maxProviderP95Ms
     },
-    nextMove: withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "Keep the current provider route for latency-sensitive turns and keep collecting sustained proof." : "Route latency-sensitive turns to a faster provider profile or tighten fallback/circuit-breaker budgets before promotion.",
-    recommendation: withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "Keep current provider path" : "Change provider routing for latency-sensitive traffic",
-    status: withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "pass" : maxProviderP95Ms === undefined ? "fail" : "warn",
+    nextMove: providers.length > 0 ? providerSwitchRecommended ? `Route latency-sensitive ${currentProvider?.role ?? "provider"} traffic to ${bestComparableProvider?.label ?? bestComparableProvider?.id} for this call profile and keep the current path as fallback.` : bestProviders.length > 0 ? `Use the fastest proven provider mix for this call profile: ${formatProviderMix(bestProviders)}.` : "Collect provider-specific sustained samples before making provider-specific routing decisions." : withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "Keep the current provider route for latency-sensitive turns and keep collecting sustained proof." : "Route latency-sensitive turns to a faster provider profile or tighten fallback/circuit-breaker budgets before promotion.",
+    providerId: providerSwitchRecommended ? bestComparableProvider?.id : bestProviders.length === 1 ? bestProviders[0]?.id : undefined,
+    recommendation: providers.length > 0 ? providerSwitchRecommended ? `Switch latency-sensitive ${currentProvider?.role ?? "provider"} routing to ${bestComparableProvider?.label ?? bestComparableProvider?.id}` : bestProviders.length > 0 ? "Prefer the fastest proven provider mix for this call profile" : "Collect provider-specific latency samples" : withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "Keep current provider path" : "Change provider routing for latency-sensitive traffic",
+    role: bestComparableProvider?.role,
+    status: providers.length > 0 ? providerSwitchRecommended ? "warn" : bestProviders.length > 0 ? "pass" : bestProvider?.status ?? "fail" : withinBudget(maxProviderP95Ms, budgets.maxProviderP95Ms) ? "pass" : maxProviderP95Ms === undefined ? "fail" : "warn",
     surface: "provider-path"
   });
   const runtimePass = withinBudget(runtimeChannel.maxFirstAudioLatencyMs, budgets.maxRuntimeFirstAudioLatencyMs) && withinBudget(runtimeChannel.maxInterruptionP95Ms, budgets.maxRuntimeInterruptionP95Ms) && withinBudget(runtimeChannel.maxJitterMs, budgets.maxRuntimeJitterMs) && withinBudget(runtimeChannel.maxTimestampDriftMs, budgets.maxRuntimeTimestampDriftMs) && withinBudget(runtimeChannel.maxBackpressureEvents, budgets.maxRuntimeBackpressureEvents);
@@ -1677,16 +1788,21 @@ var buildVoiceProofTrendRecommendationReport = (report, options = {}) => {
   });
   const status = issues.length > 0 ? "fail" : worstRecommendationStatus(recommendations);
   return {
+    bestProvider,
+    bestProviders,
     generatedAt: new Date().toISOString(),
     issues,
     ok: status !== "fail",
+    providers,
     recommendations,
     source: report.source || report.outputDir || report.runId || "proof-trends",
     status,
     summary: {
-      keepCurrentProviderPath: recommendations.find((item) => item.surface === "provider-path")?.status === "pass",
+      keepCurrentProviderPath: !providerSwitchRecommended && recommendations.find((item) => item.surface === "provider-path")?.status !== "fail",
       keepCurrentRuntimeChannel: recommendations.find((item) => item.surface === "runtime-channel")?.status === "pass",
-      recommendedActions: recommendations.filter((item) => item.status !== "pass").length
+      providerComparisonCount: providers.length,
+      recommendedActions: recommendations.filter((item) => item.status !== "pass").length,
+      switchRecommended: providerSwitchRecommended
     }
   };
 };
@@ -1697,12 +1813,20 @@ var renderVoiceProofTrendRecommendationMarkdown = (report, title = "Voice Provid
   "",
   `- Status: ${report.status}`,
   `- Source: ${report.source}`,
+  `- Best provider mix: ${formatProviderMix(report.bestProviders)}`,
+  `- Provider comparisons: ${String(report.summary.providerComparisonCount)}`,
   `- Recommended actions: ${String(report.summary.recommendedActions)}`,
   "",
   "| Surface | Status | Recommendation | Next move |",
   "| --- | --- | --- | --- |",
   ...report.recommendations.map((recommendation) => `| ${escapeMarkdown(recommendation.surface)} | ${recommendation.status} | ${escapeMarkdown(recommendation.recommendation)} | ${escapeMarkdown(recommendation.nextMove)} |`),
   "",
+  "## Provider Comparison",
+  "",
+  "| Rank | Provider | Role | Status | P95 | Samples | Next move |",
+  "| ---: | --- | --- | --- | ---: | ---: | --- |",
+  ...report.providers.length ? report.providers.map((provider) => `| ${String(provider.rank)} | ${escapeMarkdown(provider.label ?? provider.id)} | ${escapeMarkdown(provider.role ?? "n/a")} | ${provider.status} | ${provider.p95Ms === undefined ? "n/a" : String(provider.p95Ms)} | ${provider.samples === undefined ? "n/a" : String(provider.samples)} | ${escapeMarkdown(provider.nextMove)} |`) : ["| n/a | n/a | n/a | n/a | n/a | n/a | No provider-specific samples were present. |"],
+  "",
   "## Issues",
   "",
   ...report.issues.length ? report.issues.map((issue) => `- ${issue}`) : ["- None"]
@@ -1711,7 +1835,8 @@ var renderVoiceProofTrendRecommendationMarkdown = (report, title = "Voice Provid
 var renderVoiceProofTrendRecommendationHTML = (report, title = "Voice Provider Runtime Recommendations") => {
   const cards = report.recommendations.map((recommendation) => `<article class="${escapeHtml5(recommendation.status)}"><p class="eyebrow">${escapeHtml5(recommendation.surface)} \xB7 ${escapeHtml5(recommendation.status)}</p><h2>${escapeHtml5(recommendation.recommendation)}</h2><p>${escapeHtml5(recommendation.nextMove)}</p><pre>${escapeHtml5(JSON.stringify(recommendation.evidence, null, 2))}</pre></article>`).join("");
   const issues = report.issues.length === 0 ? "<li>None</li>" : report.issues.map((issue) => `<li>${escapeHtml5(issue)}</li>`).join("");
-  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width,initial-scale=1" /><title>${escapeHtml5(title)}</title><style>body{background:#101418;color:#f7f3e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.hero,article{background:#17201d;border:1px solid #2e3d36;border-radius:24px;margin-bottom:16px;padding:22px}.hero{background:linear-gradient(135deg,rgba(20,184,166,.18),rgba(245,158,11,.12))}.eyebrow{color:#5eead4;font-weight:900;letter-spacing:.1em;text-transform:uppercase}h1{font-size:clamp(2.2rem,6vw,4.7rem);letter-spacing:-.06em;line-height:.92;margin:.2rem 0 1rem}.summary{display:flex;flex-wrap:wrap;gap:10px}.pill{border:1px solid #42534a;border-radius:999px;padding:8px 12px}.pass{border-color:rgba(34,197,94,.55)}.warn{border-color:rgba(245,158,11,.7)}.fail{border-color:rgba(239,68,68,.75)}pre{background:#0b1110;border-radius:14px;overflow:auto;padding:12px}a{color:#5eead4}</style></head><body><main><section class="hero"><p class="eyebrow">Sustained proof recommendations</p><h1>${escapeHtml5(title)}</h1><p>Generated ${escapeHtml5(report.generatedAt)} from ${escapeHtml5(report.source)}.</p><div class="summary"><span class="pill">Status ${escapeHtml5(report.status)}</span><span class="pill">Provider ${report.summary.keepCurrentProviderPath ? "keep" : "change"}</span><span class="pill">Runtime ${report.summary.keepCurrentRuntimeChannel ? "keep" : "tune"}</span><span class="pill">${String(report.summary.recommendedActions)} action(s)</span></div></section>${cards}<section class="hero"><h2>Issues</h2><ul>${issues}</ul></section></main></body></html>`;
+  const providerRows = report.providers.length === 0 ? "<li>No provider-specific samples were present.</li>" : report.providers.map((provider) => `<li><strong>#${String(provider.rank)} ${escapeHtml5(provider.label ?? provider.id)}</strong><span>${escapeHtml5(provider.role ?? "provider")} \xB7 ${escapeHtml5(provider.status)} \xB7 p95 ${escapeHtml5(provider.p95Ms ?? "n/a")}ms \xB7 ${escapeHtml5(provider.samples ?? "n/a")} sample(s)</span><small>${escapeHtml5(provider.nextMove)}</small></li>`).join("");
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width,initial-scale=1" /><title>${escapeHtml5(title)}</title><style>body{background:#101418;color:#f7f3e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.hero,article{background:#17201d;border:1px solid #2e3d36;border-radius:24px;margin-bottom:16px;padding:22px}.hero{background:linear-gradient(135deg,rgba(20,184,166,.18),rgba(245,158,11,.12))}.eyebrow{color:#5eead4;font-weight:900;letter-spacing:.1em;text-transform:uppercase}h1{font-size:clamp(2.2rem,6vw,4.7rem);letter-spacing:-.06em;line-height:.92;margin:.2rem 0 1rem}.summary{display:flex;flex-wrap:wrap;gap:10px}.pill{border:1px solid #42534a;border-radius:999px;padding:8px 12px}.pass{border-color:rgba(34,197,94,.55)}.warn{border-color:rgba(245,158,11,.7)}.fail{border-color:rgba(239,68,68,.75)}pre{background:#0b1110;border-radius:14px;overflow:auto;padding:12px}a{color:#5eead4}li{margin:.45rem 0}li span,li small{display:block;color:#c9d3ca}</style></head><body><main><section class="hero"><p class="eyebrow">Sustained proof recommendations</p><h1>${escapeHtml5(title)}</h1><p>Generated ${escapeHtml5(report.generatedAt)} from ${escapeHtml5(report.source)}.</p><div class="summary"><span class="pill">Status ${escapeHtml5(report.status)}</span><span class="pill">Provider ${report.summary.keepCurrentProviderPath ? "keep" : "change"}</span><span class="pill">Best mix ${escapeHtml5(formatProviderMix(report.bestProviders))}</span><span class="pill">Runtime ${report.summary.keepCurrentRuntimeChannel ? "keep" : "tune"}</span><span class="pill">${String(report.summary.recommendedActions)} action(s)</span></div></section>${cards}<section class="hero"><h2>Provider Comparison</h2><ul>${providerRows}</ul></section><section class="hero"><h2>Issues</h2><ul>${issues}</ul></section></main></body></html>`;
 };
 var createVoiceProofTrendRecommendationRoutes = (options) => {
   const path = options.path ?? "/api/voice/proof-trend-recommendations";

package/package.json

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