@absolutejs/voice 0.0.22-beta.348 → 0.0.22-beta.349

package/dist/client/index.js

@@ -4087,6 +4087,84 @@ var buildVoiceProofTrendReportFromRealCallProfiles = (options) => {
   });
 };
 var flattenProofTrendCycles = (reports) => reports.flatMap((report) => report.cycles ?? []);
+var withLatencyHeadroom = (value, options) => typeof value === "number" && Number.isFinite(value) ? Math.ceil(value * (options.latencyBudgetHeadroomRatio ?? 1.2) + (options.latencyBudgetHeadroomMs ?? 50)) : undefined;
+var buildProviderRouteDefaults = (providers) => {
+  const routes = {};
+  for (const provider of providers) {
+    routes[provider.role ?? provider.id] = provider.id;
+  }
+  return routes;
+};
+var buildVoiceRealCallProfileDefaults = (input, options = {}) => {
+  const trend = "trend" in input ? input.trend : input;
+  const source = "source" in input ? input.source : trend.source;
+  const recommendationReport = "recommendations" in input ? input.recommendations : buildVoiceProofTrendRecommendationReport(trend, options);
+  const requiredProviderRoles = [
+    ...options.requiredProviderRoles ?? ["llm", "stt", "tts"]
+  ];
+  const profileRecommendationsById = new Map(recommendationReport.profiles.map((profile) => [profile.id, profile]));
+  const profiles = (trend.summary.profiles ?? []).map((profile) => {
+    const recommendation = profileRecommendationsById.get(profile.id);
+    const providers = recommendation?.bestProviders ?? [];
+    const providerRoutes = buildProviderRouteDefaults(providers);
+    const missingRoles = requiredProviderRoles.filter((role) => providerRoutes[role] === undefined);
+    const status2 = recommendation?.status === "fail" ? "fail" : missingRoles.length > 0 ? "warn" : recommendation?.status ?? "warn";
+    return {
+      evidence: {
+        liveP95Ms: profile.maxLiveP95Ms,
+        providerP95Ms: profile.maxProviderP95Ms,
+        turnP95Ms: profile.maxTurnP95Ms
+      },
+      label: profile.label,
+      latencyBudgets: {
+        maxLiveP95Ms: withLatencyHeadroom(profile.maxLiveP95Ms, options),
+        maxProviderP95Ms: withLatencyHeadroom(profile.maxProviderP95Ms, options),
+        maxTurnP95Ms: withLatencyHeadroom(profile.maxTurnP95Ms, options)
+      },
+      nextMove: missingRoles.length > 0 ? `Collect passing provider evidence for ${missingRoles.join(", ")} before using this as a complete default profile.` : recommendation?.nextMove ?? `Use these measured defaults for ${profile.label ?? profile.id}.`,
+      profileId: profile.id,
+      providerRoutes,
+      providers,
+      runtimeChannel: profile.runtimeChannel ? {
+        maxBackpressureEvents: profile.runtimeChannel.maxBackpressureEvents,
+        maxFirstAudioLatencyMs: withLatencyHeadroom(profile.runtimeChannel.maxFirstAudioLatencyMs, options),
+        maxInterruptionP95Ms: withLatencyHeadroom(profile.runtimeChannel.maxInterruptionP95Ms, options),
+        maxJitterMs: withLatencyHeadroom(profile.runtimeChannel.maxJitterMs, options),
+        maxTimestampDriftMs: withLatencyHeadroom(profile.runtimeChannel.maxTimestampDriftMs, options)
+      } : undefined,
+      status: status2
+    };
+  });
+  const issues = [
+    ...profiles.length === 0 ? ["No real-call profiles were available to derive defaults."] : [],
+    ...profiles.flatMap((profile) => {
+      const missingRoles = requiredProviderRoles.filter((role) => profile.providerRoutes[role] === undefined);
+      return missingRoles.length > 0 ? [
+        `${profile.label ?? profile.profileId} is missing provider defaults for ${missingRoles.join(", ")}.`
+      ] : [];
+    })
+  ];
+  const status = issues.length > 0 ? "warn" : worstRecommendationStatus(profiles.map((profile) => ({
+    evidence: {},
+    nextMove: profile.nextMove,
+    recommendation: profile.label ?? profile.profileId,
+    status: profile.status,
+    surface: "provider-path"
+  })));
+  return {
+    generatedAt: new Date().toISOString(),
+    issues,
+    ok: status !== "fail",
+    profiles,
+    source,
+    status,
+    summary: {
+      actionableProfiles: profiles.filter((profile) => requiredProviderRoles.every((role) => profile.providerRoutes[role] !== undefined) && profile.status === "pass").length,
+      profileCount: profiles.length,
+      requiredProviderRoles
+    }
+  };
+};
 var buildVoiceRealCallProfileHistoryReport = (options = {}) => {
   const generatedAt = options.generatedAt ?? (options.now instanceof Date ? options.now.toISOString() : typeof options.now === "number" ? new Date(options.now).toISOString() : typeof options.now === "string" ? new Date(options.now).toISOString() : new Date().toISOString());
   const evidenceReport = options.evidence && options.evidence.length > 0 ? buildVoiceProofTrendReportFromRealCallProfiles({
@@ -4127,12 +4205,14 @@ var buildVoiceRealCallProfileHistoryReport = (options = {}) => {
     summary
   });
   const recommendations = buildVoiceProofTrendRecommendationReport(trend, options);
+  const defaults = buildVoiceRealCallProfileDefaults(trend, options);
   const issues = [
     ...recommendationHistory.length === 0 ? ["No passing real-call profile reports were present."] : [],
     ...profiles.length === 0 ? ["No benchmark profiles were present."] : [],
     ...recommendations.issues
   ];
   return {
+    defaults,
     generatedAt,
     history,
     issues,
@@ -4541,6 +4621,12 @@ var renderVoiceRealCallProfileHistoryMarkdown = (report, title = "Voice Real-Cal
   "",
   ...report.recommendations.recommendations.map((recommendation) => `- ${recommendation.status}: ${recommendation.recommendation} ${recommendation.nextMove}`),
   "",
+  "## Actionable Defaults",
+  "",
+  "| Profile | Status | Provider routes | Live budget | Provider budget | Turn budget |",
+  "| --- | --- | --- | ---: | ---: | ---: |",
+  ...report.defaults.profiles.length ? report.defaults.profiles.map((profile) => `| ${escapeMarkdown(profile.label ?? profile.profileId)} | ${profile.status} | ${escapeMarkdown(Object.entries(profile.providerRoutes).map(([role, provider]) => `${role}: ${provider}`).join(", ") || "n/a")} | ${profile.latencyBudgets.maxLiveP95Ms ?? "n/a"} | ${profile.latencyBudgets.maxProviderP95Ms ?? "n/a"} | ${profile.latencyBudgets.maxTurnP95Ms ?? "n/a"} |`) : ["| n/a | n/a | n/a | n/a | n/a | n/a |"],
+  "",
   "## Issues",
   "",
   ...report.issues.length ? report.issues.map((issue) => `- ${issue}`) : ["- None"]
@@ -4548,9 +4634,10 @@ var renderVoiceRealCallProfileHistoryMarkdown = (report, title = "Voice Real-Cal
 `);
 var renderVoiceRealCallProfileHistoryHTML = (report, title = "Voice Real-Call Profile History") => {
   const profileRows = report.summary.profiles?.length ? report.summary.profiles.map((profile) => `<tr><td>${escapeHtml3(profile.label ?? profile.id)}</td><td>${escapeHtml3(profile.status ?? "unknown")}</td><td>${escapeHtml3(profile.maxLiveP95Ms ?? "n/a")}</td><td>${escapeHtml3(profile.maxProviderP95Ms ?? "n/a")}</td><td>${escapeHtml3(profile.maxTurnP95Ms ?? "n/a")}</td><td>${escapeHtml3(formatProviderMix(profile.providers ?? []))}</td></tr>`).join("") : '<tr><td colspan="6">No profiles present.</td></tr>';
+  const defaultRows = report.defaults.profiles.length > 0 ? report.defaults.profiles.map((profile) => `<tr><td>${escapeHtml3(profile.label ?? profile.profileId)}</td><td>${escapeHtml3(profile.status)}</td><td>${escapeHtml3(Object.entries(profile.providerRoutes).map(([role, provider]) => `${role}: ${provider}`).join(", ") || "n/a")}</td><td>${escapeHtml3(profile.latencyBudgets.maxLiveP95Ms ?? "n/a")}</td><td>${escapeHtml3(profile.latencyBudgets.maxProviderP95Ms ?? "n/a")}</td><td>${escapeHtml3(profile.latencyBudgets.maxTurnP95Ms ?? "n/a")}</td></tr>`).join("") : '<tr><td colspan="6">No actionable defaults present.</td></tr>';
   const recommendations = report.recommendations.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></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:#111510;color:#f6f0dd;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.hero,article,.card{background:#182117;border:1px solid #32412d;border-radius:24px;margin-bottom:16px;padding:22px}.hero{background:linear-gradient(135deg,rgba(132,204,22,.16),rgba(20,184,166,.12))}.eyebrow{color:#bef264;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 #52624b;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)}table{border-collapse:collapse;width:100%}td,th{border-bottom:1px solid #32412d;padding:10px;text-align:left}</style></head><body><main><section class="hero"><p class="eyebrow">Real-call benchmark history</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">Reports ${String(report.reports)}</span><span class="pill">Profiles ${String(report.summary.profileCount)}</span><span class="pill">Cycles ${String(report.summary.cycles ?? 0)}</span><span class="pill">Best mix ${escapeHtml3(formatProviderMix(report.recommendations.bestProviders))}</span></div></section><section class="card"><h2>Profiles</h2><table><thead><tr><th>Profile</th><th>Status</th><th>Live p95</th><th>Provider p95</th><th>Turn p95</th><th>Provider mix</th></tr></thead><tbody>${profileRows}</tbody></table></section>${recommendations}<section class="card"><h2>Issues</h2><ul>${issues}</ul></section></main></body></html>`;
+  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:#111510;color:#f6f0dd;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.hero,article,.card{background:#182117;border:1px solid #32412d;border-radius:24px;margin-bottom:16px;padding:22px}.hero{background:linear-gradient(135deg,rgba(132,204,22,.16),rgba(20,184,166,.12))}.eyebrow{color:#bef264;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 #52624b;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)}table{border-collapse:collapse;width:100%}td,th{border-bottom:1px solid #32412d;padding:10px;text-align:left}</style></head><body><main><section class="hero"><p class="eyebrow">Real-call benchmark history</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">Reports ${String(report.reports)}</span><span class="pill">Profiles ${String(report.summary.profileCount)}</span><span class="pill">Defaults ${String(report.defaults.summary.actionableProfiles)}/${String(report.defaults.summary.profileCount)}</span><span class="pill">Cycles ${String(report.summary.cycles ?? 0)}</span><span class="pill">Best mix ${escapeHtml3(formatProviderMix(report.recommendations.bestProviders))}</span></div></section><section class="card"><h2>Profiles</h2><table><thead><tr><th>Profile</th><th>Status</th><th>Live p95</th><th>Provider p95</th><th>Turn p95</th><th>Provider mix</th></tr></thead><tbody>${profileRows}</tbody></table></section><section class="card"><h2>Actionable Defaults</h2><table><thead><tr><th>Profile</th><th>Status</th><th>Provider routes</th><th>Live budget</th><th>Provider budget</th><th>Turn budget</th></tr></thead><tbody>${defaultRows}</tbody></table></section>${recommendations}<section class="card"><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

@@ -30,10 +30,10 @@ export { assertVoicePlatformCoverage, buildVoicePlatformCoverageSummary, createV
 export { assertVoiceCompetitiveCoverage, buildVoiceCompetitiveCoverageReport, createVoiceCompetitiveCoverageRoutes, evaluateVoiceCompetitiveCoverage, renderVoiceCompetitiveCoverageHTML, renderVoiceCompetitiveCoverageMarkdown } from './competitiveCoverage';
 export type { VoiceCompetitiveCoverageAssertionInput, VoiceCompetitiveCoverageAssertionReport, VoiceCompetitiveCoverageIssue, VoiceCompetitiveCoverageLevel, VoiceCompetitiveCoverageReport, VoiceCompetitiveCoverageReportInput, VoiceCompetitiveCoverageRoutesOptions, VoiceCompetitiveCoverageStatus, VoiceCompetitiveCoverageSummary, VoiceCompetitiveDepthLevel, VoiceCompetitiveEvidence, VoiceCompetitiveSurface } from './competitiveCoverage';
 export type { VoicePlatformCoverageAssertionInput, VoicePlatformCoverageAssertionReport, VoicePlatformCoverageEvidence, VoicePlatformCoverageRoutesOptions, VoicePlatformCoverageStatus, VoicePlatformCoverageSummary, VoicePlatformCoverageSummaryInput, VoicePlatformCoverageSurface } from './platformCoverage';
-export { assertVoiceProofTrendEvidence, buildEmptyVoiceProofTrendReport, buildVoiceProofTrendProfileSummaries, buildVoiceProofTrendRecommendationReport, buildVoiceProofTrendReportFromRealCallProfiles, buildVoiceProofTrendReport, 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 } from './proofTrends';
+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 } 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, VoiceProofTrendProfileDefinition, VoiceProofTrendProfileRecommendation, VoiceProofTrendProfileSummaryOptions, VoiceProofTrendProfileSummary, VoiceProofTrendProviderRecommendation, VoiceProofTrendProviderSummary, VoiceProofTrendRecommendation, VoiceProofTrendRecommendationOptions, VoiceProofTrendRecommendationReport, VoiceProofTrendRecommendationRoutesOptions, VoiceProofTrendRecommendationStatus, VoiceProofTrendRecommendationSurface, VoiceProofTrendRealCallProfileEvidence, VoiceProofTrendRealCallProfileReportOptions, VoiceProofTrendReport, VoiceProofTrendReportInput, VoiceProofTrendRoutesOptions, VoiceProofTrendRuntimeChannelSummary, VoiceProofTrendStatus, VoiceProofTrendSummary, VoiceRealCallProfileHistoryOptions, VoiceRealCallProfileHistoryReport, VoiceRealCallProfileHistoryRoutesOptions } from './proofTrends';
+export type { VoiceProofTrendAssertionInput, VoiceProofTrendAssertionReport, VoiceProofTrendCycle, VoiceProofTrendProfileDefinition, VoiceProofTrendProfileRecommendation, VoiceProofTrendProfileSummaryOptions, VoiceProofTrendProfileSummary, VoiceProofTrendProviderRecommendation, VoiceProofTrendProviderSummary, VoiceProofTrendRecommendation, VoiceProofTrendRecommendationOptions, VoiceProofTrendRecommendationReport, VoiceProofTrendRecommendationRoutesOptions, VoiceProofTrendRecommendationStatus, VoiceProofTrendRecommendationSurface, VoiceProofTrendRealCallProfileEvidence, VoiceProofTrendRealCallProfileReportOptions, VoiceProofTrendReport, VoiceProofTrendReportInput, VoiceProofTrendRoutesOptions, VoiceProofTrendRuntimeChannelSummary, VoiceProofTrendStatus, VoiceProofTrendSummary, VoiceRealCallProfileDefault, VoiceRealCallProfileDefaultsOptions, VoiceRealCallProfileDefaultsReport, VoiceRealCallProfileHistoryOptions, VoiceRealCallProfileHistoryReport, VoiceRealCallProfileHistoryRoutesOptions } 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

@@ -14989,6 +14989,84 @@ var buildVoiceProofTrendReportFromRealCallProfiles = (options) => {
   });
 };
 var flattenProofTrendCycles = (reports) => reports.flatMap((report) => report.cycles ?? []);
+var withLatencyHeadroom = (value, options) => typeof value === "number" && Number.isFinite(value) ? Math.ceil(value * (options.latencyBudgetHeadroomRatio ?? 1.2) + (options.latencyBudgetHeadroomMs ?? 50)) : undefined;
+var buildProviderRouteDefaults = (providers) => {
+  const routes = {};
+  for (const provider of providers) {
+    routes[provider.role ?? provider.id] = provider.id;
+  }
+  return routes;
+};
+var buildVoiceRealCallProfileDefaults = (input, options = {}) => {
+  const trend = "trend" in input ? input.trend : input;
+  const source = "source" in input ? input.source : trend.source;
+  const recommendationReport = "recommendations" in input ? input.recommendations : buildVoiceProofTrendRecommendationReport(trend, options);
+  const requiredProviderRoles = [
+    ...options.requiredProviderRoles ?? ["llm", "stt", "tts"]
+  ];
+  const profileRecommendationsById = new Map(recommendationReport.profiles.map((profile) => [profile.id, profile]));
+  const profiles = (trend.summary.profiles ?? []).map((profile) => {
+    const recommendation = profileRecommendationsById.get(profile.id);
+    const providers = recommendation?.bestProviders ?? [];
+    const providerRoutes = buildProviderRouteDefaults(providers);
+    const missingRoles = requiredProviderRoles.filter((role) => providerRoutes[role] === undefined);
+    const status2 = recommendation?.status === "fail" ? "fail" : missingRoles.length > 0 ? "warn" : recommendation?.status ?? "warn";
+    return {
+      evidence: {
+        liveP95Ms: profile.maxLiveP95Ms,
+        providerP95Ms: profile.maxProviderP95Ms,
+        turnP95Ms: profile.maxTurnP95Ms
+      },
+      label: profile.label,
+      latencyBudgets: {
+        maxLiveP95Ms: withLatencyHeadroom(profile.maxLiveP95Ms, options),
+        maxProviderP95Ms: withLatencyHeadroom(profile.maxProviderP95Ms, options),
+        maxTurnP95Ms: withLatencyHeadroom(profile.maxTurnP95Ms, options)
+      },
+      nextMove: missingRoles.length > 0 ? `Collect passing provider evidence for ${missingRoles.join(", ")} before using this as a complete default profile.` : recommendation?.nextMove ?? `Use these measured defaults for ${profile.label ?? profile.id}.`,
+      profileId: profile.id,
+      providerRoutes,
+      providers,
+      runtimeChannel: profile.runtimeChannel ? {
+        maxBackpressureEvents: profile.runtimeChannel.maxBackpressureEvents,
+        maxFirstAudioLatencyMs: withLatencyHeadroom(profile.runtimeChannel.maxFirstAudioLatencyMs, options),
+        maxInterruptionP95Ms: withLatencyHeadroom(profile.runtimeChannel.maxInterruptionP95Ms, options),
+        maxJitterMs: withLatencyHeadroom(profile.runtimeChannel.maxJitterMs, options),
+        maxTimestampDriftMs: withLatencyHeadroom(profile.runtimeChannel.maxTimestampDriftMs, options)
+      } : undefined,
+      status: status2
+    };
+  });
+  const issues = [
+    ...profiles.length === 0 ? ["No real-call profiles were available to derive defaults."] : [],
+    ...profiles.flatMap((profile) => {
+      const missingRoles = requiredProviderRoles.filter((role) => profile.providerRoutes[role] === undefined);
+      return missingRoles.length > 0 ? [
+        `${profile.label ?? profile.profileId} is missing provider defaults for ${missingRoles.join(", ")}.`
+      ] : [];
+    })
+  ];
+  const status = issues.length > 0 ? "warn" : worstRecommendationStatus(profiles.map((profile) => ({
+    evidence: {},
+    nextMove: profile.nextMove,
+    recommendation: profile.label ?? profile.profileId,
+    status: profile.status,
+    surface: "provider-path"
+  })));
+  return {
+    generatedAt: new Date().toISOString(),
+    issues,
+    ok: status !== "fail",
+    profiles,
+    source,
+    status,
+    summary: {
+      actionableProfiles: profiles.filter((profile) => requiredProviderRoles.every((role) => profile.providerRoutes[role] !== undefined) && profile.status === "pass").length,
+      profileCount: profiles.length,
+      requiredProviderRoles
+    }
+  };
+};
 var buildVoiceRealCallProfileHistoryReport = (options = {}) => {
   const generatedAt = options.generatedAt ?? (options.now instanceof Date ? options.now.toISOString() : typeof options.now === "number" ? new Date(options.now).toISOString() : typeof options.now === "string" ? new Date(options.now).toISOString() : new Date().toISOString());
   const evidenceReport = options.evidence && options.evidence.length > 0 ? buildVoiceProofTrendReportFromRealCallProfiles({
@@ -15029,12 +15107,14 @@ var buildVoiceRealCallProfileHistoryReport = (options = {}) => {
     summary
   });
   const recommendations = buildVoiceProofTrendRecommendationReport(trend, options);
+  const defaults = buildVoiceRealCallProfileDefaults(trend, options);
   const issues = [
     ...recommendationHistory.length === 0 ? ["No passing real-call profile reports were present."] : [],
     ...profiles.length === 0 ? ["No benchmark profiles were present."] : [],
     ...recommendations.issues
   ];
   return {
+    defaults,
     generatedAt,
     history,
     issues,
@@ -15443,6 +15523,12 @@ var renderVoiceRealCallProfileHistoryMarkdown = (report, title = "Voice Real-Cal
   "",
   ...report.recommendations.recommendations.map((recommendation) => `- ${recommendation.status}: ${recommendation.recommendation} ${recommendation.nextMove}`),
   "",
+  "## Actionable Defaults",
+  "",
+  "| Profile | Status | Provider routes | Live budget | Provider budget | Turn budget |",
+  "| --- | --- | --- | ---: | ---: | ---: |",
+  ...report.defaults.profiles.length ? report.defaults.profiles.map((profile) => `| ${escapeMarkdown2(profile.label ?? profile.profileId)} | ${profile.status} | ${escapeMarkdown2(Object.entries(profile.providerRoutes).map(([role, provider]) => `${role}: ${provider}`).join(", ") || "n/a")} | ${profile.latencyBudgets.maxLiveP95Ms ?? "n/a"} | ${profile.latencyBudgets.maxProviderP95Ms ?? "n/a"} | ${profile.latencyBudgets.maxTurnP95Ms ?? "n/a"} |`) : ["| n/a | n/a | n/a | n/a | n/a | n/a |"],
+  "",
   "## Issues",
   "",
   ...report.issues.length ? report.issues.map((issue) => `- ${issue}`) : ["- None"]
@@ -15450,9 +15536,10 @@ var renderVoiceRealCallProfileHistoryMarkdown = (report, title = "Voice Real-Cal
 `);
 var renderVoiceRealCallProfileHistoryHTML = (report, title = "Voice Real-Call Profile History") => {
   const profileRows = report.summary.profiles?.length ? report.summary.profiles.map((profile) => `<tr><td>${escapeHtml23(profile.label ?? profile.id)}</td><td>${escapeHtml23(profile.status ?? "unknown")}</td><td>${escapeHtml23(profile.maxLiveP95Ms ?? "n/a")}</td><td>${escapeHtml23(profile.maxProviderP95Ms ?? "n/a")}</td><td>${escapeHtml23(profile.maxTurnP95Ms ?? "n/a")}</td><td>${escapeHtml23(formatProviderMix(profile.providers ?? []))}</td></tr>`).join("") : '<tr><td colspan="6">No profiles present.</td></tr>';
+  const defaultRows = report.defaults.profiles.length > 0 ? report.defaults.profiles.map((profile) => `<tr><td>${escapeHtml23(profile.label ?? profile.profileId)}</td><td>${escapeHtml23(profile.status)}</td><td>${escapeHtml23(Object.entries(profile.providerRoutes).map(([role, provider]) => `${role}: ${provider}`).join(", ") || "n/a")}</td><td>${escapeHtml23(profile.latencyBudgets.maxLiveP95Ms ?? "n/a")}</td><td>${escapeHtml23(profile.latencyBudgets.maxProviderP95Ms ?? "n/a")}</td><td>${escapeHtml23(profile.latencyBudgets.maxTurnP95Ms ?? "n/a")}</td></tr>`).join("") : '<tr><td colspan="6">No actionable defaults present.</td></tr>';
   const recommendations = report.recommendations.recommendations.map((recommendation) => `<article class="${escapeHtml23(recommendation.status)}"><p class="eyebrow">${escapeHtml23(recommendation.surface)} \xB7 ${escapeHtml23(recommendation.status)}</p><h2>${escapeHtml23(recommendation.recommendation)}</h2><p>${escapeHtml23(recommendation.nextMove)}</p></article>`).join("");
   const issues = report.issues.length === 0 ? "<li>None</li>" : report.issues.map((issue) => `<li>${escapeHtml23(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>${escapeHtml23(title)}</title><style>body{background:#111510;color:#f6f0dd;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.hero,article,.card{background:#182117;border:1px solid #32412d;border-radius:24px;margin-bottom:16px;padding:22px}.hero{background:linear-gradient(135deg,rgba(132,204,22,.16),rgba(20,184,166,.12))}.eyebrow{color:#bef264;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 #52624b;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)}table{border-collapse:collapse;width:100%}td,th{border-bottom:1px solid #32412d;padding:10px;text-align:left}</style></head><body><main><section class="hero"><p class="eyebrow">Real-call benchmark history</p><h1>${escapeHtml23(title)}</h1><p>Generated ${escapeHtml23(report.generatedAt)} from ${escapeHtml23(report.source)}.</p><div class="summary"><span class="pill">Status ${escapeHtml23(report.status)}</span><span class="pill">Reports ${String(report.reports)}</span><span class="pill">Profiles ${String(report.summary.profileCount)}</span><span class="pill">Cycles ${String(report.summary.cycles ?? 0)}</span><span class="pill">Best mix ${escapeHtml23(formatProviderMix(report.recommendations.bestProviders))}</span></div></section><section class="card"><h2>Profiles</h2><table><thead><tr><th>Profile</th><th>Status</th><th>Live p95</th><th>Provider p95</th><th>Turn p95</th><th>Provider mix</th></tr></thead><tbody>${profileRows}</tbody></table></section>${recommendations}<section class="card"><h2>Issues</h2><ul>${issues}</ul></section></main></body></html>`;
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width,initial-scale=1" /><title>${escapeHtml23(title)}</title><style>body{background:#111510;color:#f6f0dd;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.hero,article,.card{background:#182117;border:1px solid #32412d;border-radius:24px;margin-bottom:16px;padding:22px}.hero{background:linear-gradient(135deg,rgba(132,204,22,.16),rgba(20,184,166,.12))}.eyebrow{color:#bef264;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 #52624b;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)}table{border-collapse:collapse;width:100%}td,th{border-bottom:1px solid #32412d;padding:10px;text-align:left}</style></head><body><main><section class="hero"><p class="eyebrow">Real-call benchmark history</p><h1>${escapeHtml23(title)}</h1><p>Generated ${escapeHtml23(report.generatedAt)} from ${escapeHtml23(report.source)}.</p><div class="summary"><span class="pill">Status ${escapeHtml23(report.status)}</span><span class="pill">Reports ${String(report.reports)}</span><span class="pill">Profiles ${String(report.summary.profileCount)}</span><span class="pill">Defaults ${String(report.defaults.summary.actionableProfiles)}/${String(report.defaults.summary.profileCount)}</span><span class="pill">Cycles ${String(report.summary.cycles ?? 0)}</span><span class="pill">Best mix ${escapeHtml23(formatProviderMix(report.recommendations.bestProviders))}</span></div></section><section class="card"><h2>Profiles</h2><table><thead><tr><th>Profile</th><th>Status</th><th>Live p95</th><th>Provider p95</th><th>Turn p95</th><th>Provider mix</th></tr></thead><tbody>${profileRows}</tbody></table></section><section class="card"><h2>Actionable Defaults</h2><table><thead><tr><th>Profile</th><th>Status</th><th>Provider routes</th><th>Live budget</th><th>Provider budget</th><th>Turn budget</th></tr></thead><tbody>${defaultRows}</tbody></table></section>${recommendations}<section class="card"><h2>Issues</h2><ul>${issues}</ul></section></main></body></html>`;
 };
 var createVoiceProofTrendRecommendationRoutes = (options) => {
   const path = options.path ?? "/api/voice/proof-trend-recommendations";
@@ -37574,6 +37661,7 @@ export {
   buildVoiceRealtimeChannelRuntimeSamplesFromTrace,
   buildVoiceRealtimeChannelReport,
   buildVoiceRealCallProfileHistoryReport,
+  buildVoiceRealCallProfileDefaults,
   buildVoiceProviderSloReport,
   buildVoiceProviderOrchestrationReport,
   buildVoiceProviderDecisionTraceReport,

package/dist/proofTrends.d.ts

@@ -258,6 +258,7 @@ export type VoiceProofTrendRecommendationRoutesOptions = VoiceProofTrendRecommen
     title?: string;
 };
 export type VoiceRealCallProfileHistoryReport = {
+    defaults: VoiceRealCallProfileDefaultsReport;
     generatedAt: string;
     history: VoiceProofTrendReport[];
     issues: string[];
@@ -281,6 +282,49 @@ export type VoiceRealCallProfileHistoryOptions = VoiceProofTrendProfileSummaryOp
     reports?: readonly (VoiceProofTrendReport | VoiceProofTrendReportInput)[];
     source?: string;
 };
+export type VoiceRealCallProfileDefault = {
+    evidence: {
+        liveP95Ms?: number;
+        providerP95Ms?: number;
+        turnP95Ms?: number;
+    };
+    label?: string;
+    latencyBudgets: {
+        maxLiveP95Ms?: number;
+        maxProviderP95Ms?: number;
+        maxTurnP95Ms?: number;
+    };
+    nextMove: string;
+    profileId: string;
+    providerRoutes: Record<string, string>;
+    providers: VoiceProofTrendProviderRecommendation[];
+    runtimeChannel?: {
+        maxBackpressureEvents?: number;
+        maxFirstAudioLatencyMs?: number;
+        maxInterruptionP95Ms?: number;
+        maxJitterMs?: number;
+        maxTimestampDriftMs?: number;
+    };
+    status: VoiceProofTrendRecommendationStatus;
+};
+export type VoiceRealCallProfileDefaultsReport = {
+    generatedAt: string;
+    issues: string[];
+    ok: boolean;
+    profiles: VoiceRealCallProfileDefault[];
+    source: string;
+    status: VoiceProofTrendRecommendationStatus;
+    summary: {
+        actionableProfiles: number;
+        profileCount: number;
+        requiredProviderRoles: string[];
+    };
+};
+export type VoiceRealCallProfileDefaultsOptions = VoiceProofTrendRecommendationOptions & {
+    latencyBudgetHeadroomMs?: number;
+    latencyBudgetHeadroomRatio?: number;
+    requiredProviderRoles?: readonly string[];
+};
 export type VoiceRealCallProfileHistoryRoutesOptions = Omit<VoiceRealCallProfileHistoryOptions, 'source'> & {
     headers?: HeadersInit;
     htmlPath?: false | string;
@@ -320,6 +364,7 @@ export declare const readVoiceProofTrendReportFile: (path: string, options?: {
 }) => Promise<VoiceProofTrendReport>;
 export declare const buildVoiceProofTrendProfileSummaries: (input: VoiceProofTrendReport | readonly VoiceProofTrendReport[], options?: VoiceProofTrendProfileSummaryOptions) => VoiceProofTrendProfileSummary[];
 export declare const buildVoiceProofTrendReportFromRealCallProfiles: (options: VoiceProofTrendRealCallProfileReportOptions) => VoiceProofTrendReport;
+export declare const buildVoiceRealCallProfileDefaults: (input: VoiceRealCallProfileHistoryReport | VoiceProofTrendReport, options?: VoiceRealCallProfileDefaultsOptions) => VoiceRealCallProfileDefaultsReport;
 export declare const buildVoiceRealCallProfileHistoryReport: (options?: VoiceRealCallProfileHistoryOptions) => VoiceRealCallProfileHistoryReport;
 export declare const evaluateVoiceProofTrendEvidence: (report: VoiceProofTrendReport, input?: VoiceProofTrendAssertionInput) => VoiceProofTrendAssertionReport;
 export declare const assertVoiceProofTrendEvidence: (report: VoiceProofTrendReport, input?: VoiceProofTrendAssertionInput) => VoiceProofTrendAssertionReport;

package/dist/react/index.js

@@ -1835,6 +1835,84 @@ var buildVoiceProofTrendReportFromRealCallProfiles = (options) => {
   });
 };
 var flattenProofTrendCycles = (reports) => reports.flatMap((report) => report.cycles ?? []);
+var withLatencyHeadroom = (value, options) => typeof value === "number" && Number.isFinite(value) ? Math.ceil(value * (options.latencyBudgetHeadroomRatio ?? 1.2) + (options.latencyBudgetHeadroomMs ?? 50)) : undefined;
+var buildProviderRouteDefaults = (providers) => {
+  const routes = {};
+  for (const provider of providers) {
+    routes[provider.role ?? provider.id] = provider.id;
+  }
+  return routes;
+};
+var buildVoiceRealCallProfileDefaults = (input, options = {}) => {
+  const trend = "trend" in input ? input.trend : input;
+  const source = "source" in input ? input.source : trend.source;
+  const recommendationReport = "recommendations" in input ? input.recommendations : buildVoiceProofTrendRecommendationReport(trend, options);
+  const requiredProviderRoles = [
+    ...options.requiredProviderRoles ?? ["llm", "stt", "tts"]
+  ];
+  const profileRecommendationsById = new Map(recommendationReport.profiles.map((profile) => [profile.id, profile]));
+  const profiles = (trend.summary.profiles ?? []).map((profile) => {
+    const recommendation = profileRecommendationsById.get(profile.id);
+    const providers = recommendation?.bestProviders ?? [];
+    const providerRoutes = buildProviderRouteDefaults(providers);
+    const missingRoles = requiredProviderRoles.filter((role) => providerRoutes[role] === undefined);
+    const status2 = recommendation?.status === "fail" ? "fail" : missingRoles.length > 0 ? "warn" : recommendation?.status ?? "warn";
+    return {
+      evidence: {
+        liveP95Ms: profile.maxLiveP95Ms,
+        providerP95Ms: profile.maxProviderP95Ms,
+        turnP95Ms: profile.maxTurnP95Ms
+      },
+      label: profile.label,
+      latencyBudgets: {
+        maxLiveP95Ms: withLatencyHeadroom(profile.maxLiveP95Ms, options),
+        maxProviderP95Ms: withLatencyHeadroom(profile.maxProviderP95Ms, options),
+        maxTurnP95Ms: withLatencyHeadroom(profile.maxTurnP95Ms, options)
+      },
+      nextMove: missingRoles.length > 0 ? `Collect passing provider evidence for ${missingRoles.join(", ")} before using this as a complete default profile.` : recommendation?.nextMove ?? `Use these measured defaults for ${profile.label ?? profile.id}.`,
+      profileId: profile.id,
+      providerRoutes,
+      providers,
+      runtimeChannel: profile.runtimeChannel ? {
+        maxBackpressureEvents: profile.runtimeChannel.maxBackpressureEvents,
+        maxFirstAudioLatencyMs: withLatencyHeadroom(profile.runtimeChannel.maxFirstAudioLatencyMs, options),
+        maxInterruptionP95Ms: withLatencyHeadroom(profile.runtimeChannel.maxInterruptionP95Ms, options),
+        maxJitterMs: withLatencyHeadroom(profile.runtimeChannel.maxJitterMs, options),
+        maxTimestampDriftMs: withLatencyHeadroom(profile.runtimeChannel.maxTimestampDriftMs, options)
+      } : undefined,
+      status: status2
+    };
+  });
+  const issues = [
+    ...profiles.length === 0 ? ["No real-call profiles were available to derive defaults."] : [],
+    ...profiles.flatMap((profile) => {
+      const missingRoles = requiredProviderRoles.filter((role) => profile.providerRoutes[role] === undefined);
+      return missingRoles.length > 0 ? [
+        `${profile.label ?? profile.profileId} is missing provider defaults for ${missingRoles.join(", ")}.`
+      ] : [];
+    })
+  ];
+  const status = issues.length > 0 ? "warn" : worstRecommendationStatus(profiles.map((profile) => ({
+    evidence: {},
+    nextMove: profile.nextMove,
+    recommendation: profile.label ?? profile.profileId,
+    status: profile.status,
+    surface: "provider-path"
+  })));
+  return {
+    generatedAt: new Date().toISOString(),
+    issues,
+    ok: status !== "fail",
+    profiles,
+    source,
+    status,
+    summary: {
+      actionableProfiles: profiles.filter((profile) => requiredProviderRoles.every((role) => profile.providerRoutes[role] !== undefined) && profile.status === "pass").length,
+      profileCount: profiles.length,
+      requiredProviderRoles
+    }
+  };
+};
 var buildVoiceRealCallProfileHistoryReport = (options = {}) => {
   const generatedAt = options.generatedAt ?? (options.now instanceof Date ? options.now.toISOString() : typeof options.now === "number" ? new Date(options.now).toISOString() : typeof options.now === "string" ? new Date(options.now).toISOString() : new Date().toISOString());
   const evidenceReport = options.evidence && options.evidence.length > 0 ? buildVoiceProofTrendReportFromRealCallProfiles({
@@ -1875,12 +1953,14 @@ var buildVoiceRealCallProfileHistoryReport = (options = {}) => {
     summary
   });
   const recommendations = buildVoiceProofTrendRecommendationReport(trend, options);
+  const defaults = buildVoiceRealCallProfileDefaults(trend, options);
   const issues = [
     ...recommendationHistory.length === 0 ? ["No passing real-call profile reports were present."] : [],
     ...profiles.length === 0 ? ["No benchmark profiles were present."] : [],
     ...recommendations.issues
   ];
   return {
+    defaults,
     generatedAt,
     history,
     issues,
@@ -2289,6 +2369,12 @@ var renderVoiceRealCallProfileHistoryMarkdown = (report, title = "Voice Real-Cal
   "",
   ...report.recommendations.recommendations.map((recommendation) => `- ${recommendation.status}: ${recommendation.recommendation} ${recommendation.nextMove}`),
   "",
+  "## Actionable Defaults",
+  "",
+  "| Profile | Status | Provider routes | Live budget | Provider budget | Turn budget |",
+  "| --- | --- | --- | ---: | ---: | ---: |",
+  ...report.defaults.profiles.length ? report.defaults.profiles.map((profile) => `| ${escapeMarkdown(profile.label ?? profile.profileId)} | ${profile.status} | ${escapeMarkdown(Object.entries(profile.providerRoutes).map(([role, provider]) => `${role}: ${provider}`).join(", ") || "n/a")} | ${profile.latencyBudgets.maxLiveP95Ms ?? "n/a"} | ${profile.latencyBudgets.maxProviderP95Ms ?? "n/a"} | ${profile.latencyBudgets.maxTurnP95Ms ?? "n/a"} |`) : ["| n/a | n/a | n/a | n/a | n/a | n/a |"],
+  "",
   "## Issues",
   "",
   ...report.issues.length ? report.issues.map((issue) => `- ${issue}`) : ["- None"]
@@ -2296,9 +2382,10 @@ var renderVoiceRealCallProfileHistoryMarkdown = (report, title = "Voice Real-Cal
 `);
 var renderVoiceRealCallProfileHistoryHTML = (report, title = "Voice Real-Call Profile History") => {
   const profileRows = report.summary.profiles?.length ? report.summary.profiles.map((profile) => `<tr><td>${escapeHtml5(profile.label ?? profile.id)}</td><td>${escapeHtml5(profile.status ?? "unknown")}</td><td>${escapeHtml5(profile.maxLiveP95Ms ?? "n/a")}</td><td>${escapeHtml5(profile.maxProviderP95Ms ?? "n/a")}</td><td>${escapeHtml5(profile.maxTurnP95Ms ?? "n/a")}</td><td>${escapeHtml5(formatProviderMix(profile.providers ?? []))}</td></tr>`).join("") : '<tr><td colspan="6">No profiles present.</td></tr>';
+  const defaultRows = report.defaults.profiles.length > 0 ? report.defaults.profiles.map((profile) => `<tr><td>${escapeHtml5(profile.label ?? profile.profileId)}</td><td>${escapeHtml5(profile.status)}</td><td>${escapeHtml5(Object.entries(profile.providerRoutes).map(([role, provider]) => `${role}: ${provider}`).join(", ") || "n/a")}</td><td>${escapeHtml5(profile.latencyBudgets.maxLiveP95Ms ?? "n/a")}</td><td>${escapeHtml5(profile.latencyBudgets.maxProviderP95Ms ?? "n/a")}</td><td>${escapeHtml5(profile.latencyBudgets.maxTurnP95Ms ?? "n/a")}</td></tr>`).join("") : '<tr><td colspan="6">No actionable defaults present.</td></tr>';
   const recommendations = report.recommendations.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></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:#111510;color:#f6f0dd;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.hero,article,.card{background:#182117;border:1px solid #32412d;border-radius:24px;margin-bottom:16px;padding:22px}.hero{background:linear-gradient(135deg,rgba(132,204,22,.16),rgba(20,184,166,.12))}.eyebrow{color:#bef264;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 #52624b;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)}table{border-collapse:collapse;width:100%}td,th{border-bottom:1px solid #32412d;padding:10px;text-align:left}</style></head><body><main><section class="hero"><p class="eyebrow">Real-call benchmark history</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">Reports ${String(report.reports)}</span><span class="pill">Profiles ${String(report.summary.profileCount)}</span><span class="pill">Cycles ${String(report.summary.cycles ?? 0)}</span><span class="pill">Best mix ${escapeHtml5(formatProviderMix(report.recommendations.bestProviders))}</span></div></section><section class="card"><h2>Profiles</h2><table><thead><tr><th>Profile</th><th>Status</th><th>Live p95</th><th>Provider p95</th><th>Turn p95</th><th>Provider mix</th></tr></thead><tbody>${profileRows}</tbody></table></section>${recommendations}<section class="card"><h2>Issues</h2><ul>${issues}</ul></section></main></body></html>`;
+  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:#111510;color:#f6f0dd;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.hero,article,.card{background:#182117;border:1px solid #32412d;border-radius:24px;margin-bottom:16px;padding:22px}.hero{background:linear-gradient(135deg,rgba(132,204,22,.16),rgba(20,184,166,.12))}.eyebrow{color:#bef264;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 #52624b;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)}table{border-collapse:collapse;width:100%}td,th{border-bottom:1px solid #32412d;padding:10px;text-align:left}</style></head><body><main><section class="hero"><p class="eyebrow">Real-call benchmark history</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">Reports ${String(report.reports)}</span><span class="pill">Profiles ${String(report.summary.profileCount)}</span><span class="pill">Defaults ${String(report.defaults.summary.actionableProfiles)}/${String(report.defaults.summary.profileCount)}</span><span class="pill">Cycles ${String(report.summary.cycles ?? 0)}</span><span class="pill">Best mix ${escapeHtml5(formatProviderMix(report.recommendations.bestProviders))}</span></div></section><section class="card"><h2>Profiles</h2><table><thead><tr><th>Profile</th><th>Status</th><th>Live p95</th><th>Provider p95</th><th>Turn p95</th><th>Provider mix</th></tr></thead><tbody>${profileRows}</tbody></table></section><section class="card"><h2>Actionable Defaults</h2><table><thead><tr><th>Profile</th><th>Status</th><th>Provider routes</th><th>Live budget</th><th>Provider budget</th><th>Turn budget</th></tr></thead><tbody>${defaultRows}</tbody></table></section>${recommendations}<section class="card"><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

@@ -1756,6 +1756,84 @@ var buildVoiceProofTrendReportFromRealCallProfiles = (options) => {
   });
 };
 var flattenProofTrendCycles = (reports) => reports.flatMap((report) => report.cycles ?? []);
+var withLatencyHeadroom = (value, options) => typeof value === "number" && Number.isFinite(value) ? Math.ceil(value * (options.latencyBudgetHeadroomRatio ?? 1.2) + (options.latencyBudgetHeadroomMs ?? 50)) : undefined;
+var buildProviderRouteDefaults = (providers) => {
+  const routes = {};
+  for (const provider of providers) {
+    routes[provider.role ?? provider.id] = provider.id;
+  }
+  return routes;
+};
+var buildVoiceRealCallProfileDefaults = (input, options = {}) => {
+  const trend = "trend" in input ? input.trend : input;
+  const source = "source" in input ? input.source : trend.source;
+  const recommendationReport = "recommendations" in input ? input.recommendations : buildVoiceProofTrendRecommendationReport(trend, options);
+  const requiredProviderRoles = [
+    ...options.requiredProviderRoles ?? ["llm", "stt", "tts"]
+  ];
+  const profileRecommendationsById = new Map(recommendationReport.profiles.map((profile) => [profile.id, profile]));
+  const profiles = (trend.summary.profiles ?? []).map((profile) => {
+    const recommendation = profileRecommendationsById.get(profile.id);
+    const providers = recommendation?.bestProviders ?? [];
+    const providerRoutes = buildProviderRouteDefaults(providers);
+    const missingRoles = requiredProviderRoles.filter((role) => providerRoutes[role] === undefined);
+    const status2 = recommendation?.status === "fail" ? "fail" : missingRoles.length > 0 ? "warn" : recommendation?.status ?? "warn";
+    return {
+      evidence: {
+        liveP95Ms: profile.maxLiveP95Ms,
+        providerP95Ms: profile.maxProviderP95Ms,
+        turnP95Ms: profile.maxTurnP95Ms
+      },
+      label: profile.label,
+      latencyBudgets: {
+        maxLiveP95Ms: withLatencyHeadroom(profile.maxLiveP95Ms, options),
+        maxProviderP95Ms: withLatencyHeadroom(profile.maxProviderP95Ms, options),
+        maxTurnP95Ms: withLatencyHeadroom(profile.maxTurnP95Ms, options)
+      },
+      nextMove: missingRoles.length > 0 ? `Collect passing provider evidence for ${missingRoles.join(", ")} before using this as a complete default profile.` : recommendation?.nextMove ?? `Use these measured defaults for ${profile.label ?? profile.id}.`,
+      profileId: profile.id,
+      providerRoutes,
+      providers,
+      runtimeChannel: profile.runtimeChannel ? {
+        maxBackpressureEvents: profile.runtimeChannel.maxBackpressureEvents,
+        maxFirstAudioLatencyMs: withLatencyHeadroom(profile.runtimeChannel.maxFirstAudioLatencyMs, options),
+        maxInterruptionP95Ms: withLatencyHeadroom(profile.runtimeChannel.maxInterruptionP95Ms, options),
+        maxJitterMs: withLatencyHeadroom(profile.runtimeChannel.maxJitterMs, options),
+        maxTimestampDriftMs: withLatencyHeadroom(profile.runtimeChannel.maxTimestampDriftMs, options)
+      } : undefined,
+      status: status2
+    };
+  });
+  const issues = [
+    ...profiles.length === 0 ? ["No real-call profiles were available to derive defaults."] : [],
+    ...profiles.flatMap((profile) => {
+      const missingRoles = requiredProviderRoles.filter((role) => profile.providerRoutes[role] === undefined);
+      return missingRoles.length > 0 ? [
+        `${profile.label ?? profile.profileId} is missing provider defaults for ${missingRoles.join(", ")}.`
+      ] : [];
+    })
+  ];
+  const status = issues.length > 0 ? "warn" : worstRecommendationStatus(profiles.map((profile) => ({
+    evidence: {},
+    nextMove: profile.nextMove,
+    recommendation: profile.label ?? profile.profileId,
+    status: profile.status,
+    surface: "provider-path"
+  })));
+  return {
+    generatedAt: new Date().toISOString(),
+    issues,
+    ok: status !== "fail",
+    profiles,
+    source,
+    status,
+    summary: {
+      actionableProfiles: profiles.filter((profile) => requiredProviderRoles.every((role) => profile.providerRoutes[role] !== undefined) && profile.status === "pass").length,
+      profileCount: profiles.length,
+      requiredProviderRoles
+    }
+  };
+};
 var buildVoiceRealCallProfileHistoryReport = (options = {}) => {
   const generatedAt = options.generatedAt ?? (options.now instanceof Date ? options.now.toISOString() : typeof options.now === "number" ? new Date(options.now).toISOString() : typeof options.now === "string" ? new Date(options.now).toISOString() : new Date().toISOString());
   const evidenceReport = options.evidence && options.evidence.length > 0 ? buildVoiceProofTrendReportFromRealCallProfiles({
@@ -1796,12 +1874,14 @@ var buildVoiceRealCallProfileHistoryReport = (options = {}) => {
     summary
   });
   const recommendations = buildVoiceProofTrendRecommendationReport(trend, options);
+  const defaults = buildVoiceRealCallProfileDefaults(trend, options);
   const issues = [
     ...recommendationHistory.length === 0 ? ["No passing real-call profile reports were present."] : [],
     ...profiles.length === 0 ? ["No benchmark profiles were present."] : [],
     ...recommendations.issues
   ];
   return {
+    defaults,
     generatedAt,
     history,
     issues,
@@ -2210,6 +2290,12 @@ var renderVoiceRealCallProfileHistoryMarkdown = (report, title = "Voice Real-Cal
   "",
   ...report.recommendations.recommendations.map((recommendation) => `- ${recommendation.status}: ${recommendation.recommendation} ${recommendation.nextMove}`),
   "",
+  "## Actionable Defaults",
+  "",
+  "| Profile | Status | Provider routes | Live budget | Provider budget | Turn budget |",
+  "| --- | --- | --- | ---: | ---: | ---: |",
+  ...report.defaults.profiles.length ? report.defaults.profiles.map((profile) => `| ${escapeMarkdown(profile.label ?? profile.profileId)} | ${profile.status} | ${escapeMarkdown(Object.entries(profile.providerRoutes).map(([role, provider]) => `${role}: ${provider}`).join(", ") || "n/a")} | ${profile.latencyBudgets.maxLiveP95Ms ?? "n/a"} | ${profile.latencyBudgets.maxProviderP95Ms ?? "n/a"} | ${profile.latencyBudgets.maxTurnP95Ms ?? "n/a"} |`) : ["| n/a | n/a | n/a | n/a | n/a | n/a |"],
+  "",
   "## Issues",
   "",
   ...report.issues.length ? report.issues.map((issue) => `- ${issue}`) : ["- None"]
@@ -2217,9 +2303,10 @@ var renderVoiceRealCallProfileHistoryMarkdown = (report, title = "Voice Real-Cal
 `);
 var renderVoiceRealCallProfileHistoryHTML = (report, title = "Voice Real-Call Profile History") => {
   const profileRows = report.summary.profiles?.length ? report.summary.profiles.map((profile) => `<tr><td>${escapeHtml5(profile.label ?? profile.id)}</td><td>${escapeHtml5(profile.status ?? "unknown")}</td><td>${escapeHtml5(profile.maxLiveP95Ms ?? "n/a")}</td><td>${escapeHtml5(profile.maxProviderP95Ms ?? "n/a")}</td><td>${escapeHtml5(profile.maxTurnP95Ms ?? "n/a")}</td><td>${escapeHtml5(formatProviderMix(profile.providers ?? []))}</td></tr>`).join("") : '<tr><td colspan="6">No profiles present.</td></tr>';
+  const defaultRows = report.defaults.profiles.length > 0 ? report.defaults.profiles.map((profile) => `<tr><td>${escapeHtml5(profile.label ?? profile.profileId)}</td><td>${escapeHtml5(profile.status)}</td><td>${escapeHtml5(Object.entries(profile.providerRoutes).map(([role, provider]) => `${role}: ${provider}`).join(", ") || "n/a")}</td><td>${escapeHtml5(profile.latencyBudgets.maxLiveP95Ms ?? "n/a")}</td><td>${escapeHtml5(profile.latencyBudgets.maxProviderP95Ms ?? "n/a")}</td><td>${escapeHtml5(profile.latencyBudgets.maxTurnP95Ms ?? "n/a")}</td></tr>`).join("") : '<tr><td colspan="6">No actionable defaults present.</td></tr>';
   const recommendations = report.recommendations.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></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:#111510;color:#f6f0dd;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.hero,article,.card{background:#182117;border:1px solid #32412d;border-radius:24px;margin-bottom:16px;padding:22px}.hero{background:linear-gradient(135deg,rgba(132,204,22,.16),rgba(20,184,166,.12))}.eyebrow{color:#bef264;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 #52624b;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)}table{border-collapse:collapse;width:100%}td,th{border-bottom:1px solid #32412d;padding:10px;text-align:left}</style></head><body><main><section class="hero"><p class="eyebrow">Real-call benchmark history</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">Reports ${String(report.reports)}</span><span class="pill">Profiles ${String(report.summary.profileCount)}</span><span class="pill">Cycles ${String(report.summary.cycles ?? 0)}</span><span class="pill">Best mix ${escapeHtml5(formatProviderMix(report.recommendations.bestProviders))}</span></div></section><section class="card"><h2>Profiles</h2><table><thead><tr><th>Profile</th><th>Status</th><th>Live p95</th><th>Provider p95</th><th>Turn p95</th><th>Provider mix</th></tr></thead><tbody>${profileRows}</tbody></table></section>${recommendations}<section class="card"><h2>Issues</h2><ul>${issues}</ul></section></main></body></html>`;
+  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:#111510;color:#f6f0dd;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.hero,article,.card{background:#182117;border:1px solid #32412d;border-radius:24px;margin-bottom:16px;padding:22px}.hero{background:linear-gradient(135deg,rgba(132,204,22,.16),rgba(20,184,166,.12))}.eyebrow{color:#bef264;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 #52624b;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)}table{border-collapse:collapse;width:100%}td,th{border-bottom:1px solid #32412d;padding:10px;text-align:left}</style></head><body><main><section class="hero"><p class="eyebrow">Real-call benchmark history</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">Reports ${String(report.reports)}</span><span class="pill">Profiles ${String(report.summary.profileCount)}</span><span class="pill">Defaults ${String(report.defaults.summary.actionableProfiles)}/${String(report.defaults.summary.profileCount)}</span><span class="pill">Cycles ${String(report.summary.cycles ?? 0)}</span><span class="pill">Best mix ${escapeHtml5(formatProviderMix(report.recommendations.bestProviders))}</span></div></section><section class="card"><h2>Profiles</h2><table><thead><tr><th>Profile</th><th>Status</th><th>Live p95</th><th>Provider p95</th><th>Turn p95</th><th>Provider mix</th></tr></thead><tbody>${profileRows}</tbody></table></section><section class="card"><h2>Actionable Defaults</h2><table><thead><tr><th>Profile</th><th>Status</th><th>Provider routes</th><th>Live budget</th><th>Provider budget</th><th>Turn budget</th></tr></thead><tbody>${defaultRows}</tbody></table></section>${recommendations}<section class="card"><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.348",
+	"version": "0.0.22-beta.349",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",