@absolutejs/voice 0.0.22-beta.139 → 0.0.22-beta.140

package/dist/index.d.ts

@@ -96,7 +96,7 @@ export type { VoicePhoneAgentCarrier, VoicePhoneAgentCarrierSummary, VoicePhoneA
 export type { VoicePhoneAgentProductionSmokeIssue, VoicePhoneAgentProductionSmokeHandlerOptions, VoicePhoneAgentProductionSmokeHTMLHandlerOptions, VoicePhoneAgentProductionSmokeOptions, VoicePhoneAgentProductionSmokeReport, VoicePhoneAgentProductionSmokeRoutesOptions, VoicePhoneAgentProductionSmokeRequirement } from './phoneAgentProductionSmoke';
 export type { VoiceOpsConsoleLink, VoiceOpsConsoleReport, VoiceOpsConsoleRoutesOptions } from './opsConsoleRoutes';
 export type { VoiceOpsStatus, VoiceOpsStatusLink, VoiceOpsStatusOptions, VoiceOpsStatusReport, VoiceOpsStatusRoutesOptions } from './opsStatus';
-export type { VoiceProductionReadinessAction, VoiceProductionReadinessAuditOptions, VoiceProductionReadinessAuditRequirement, VoiceProductionReadinessAuditSummary, VoiceProductionReadinessCheck, VoiceProductionReadinessReport, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessTraceDeliverySummary, VoiceProductionReadinessAuditDeliveryOptions, VoiceProductionReadinessAuditDeliverySummary, VoiceProductionReadinessTraceDeliveryOptions, VoiceProductionReadinessStatus } from './productionReadiness';
+export type { VoiceProductionReadinessAction, VoiceProductionReadinessAuditOptions, VoiceProductionReadinessAuditRequirement, VoiceProductionReadinessAuditSummary, VoiceProductionReadinessCheck, VoiceProductionReadinessProofSource, VoiceProductionReadinessReport, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessTraceDeliverySummary, VoiceProductionReadinessAuditDeliveryOptions, VoiceProductionReadinessAuditDeliverySummary, VoiceProductionReadinessTraceDeliveryOptions, VoiceProductionReadinessStatus } from './productionReadiness';
 export type { VoiceQualityLink, VoiceQualityMetric, VoiceQualityReport, VoiceQualityRoutesOptions, VoiceQualityStatus, VoiceQualityThresholds } from './qualityRoutes';
 export type { VoiceResilienceIOSimulator, VoiceResilienceLink, VoiceResiliencePageData, VoiceResilienceRoutesOptions, VoiceResilienceSimulationProvider, VoiceRoutingKindSummary, VoiceRoutingDecisionSummary, VoiceRoutingDecisionSummaryOptions, VoiceRoutingEvent, VoiceRoutingEventKind, VoiceRoutingSessionSummary, VoiceRoutingSessionSummaryOptions } from './resilienceRoutes';
 export type { VoiceIOProviderRouterEvent, VoiceIOProviderRouterOptions, VoiceIOProviderRouterPolicy, VoiceIOProviderRouterPolicyConfig, VoiceSTTProviderRouterOptions, VoiceTTSProviderRouterOptions } from './providerAdapters';

package/dist/index.js

@@ -19531,6 +19531,12 @@ var resolveBargeInReports = async (options, input) => {
   }
   return typeof options.bargeInReports === "function" ? await options.bargeInReports(input) : options.bargeInReports;
 };
+var resolveProofSources = async (options, input) => {
+  if (options.proofSources === false || options.proofSources === undefined) {
+    return;
+  }
+  return typeof options.proofSources === "function" ? await options.proofSources(input) : options.proofSources;
+};
 var defaultAuditRequirements = [
   {
     label: "Provider-call audit",
@@ -19691,7 +19697,8 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     providerRoutingContracts,
     phoneAgentSmokes,
     reconnectContracts,
-    bargeInReports
+    bargeInReports,
+    proofSources
   ] = await Promise.all([
     evaluateVoiceQuality({ events }),
     Promise.all([
@@ -19718,7 +19725,8 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     resolveProviderRoutingContracts(options, { query, request }),
     resolvePhoneAgentSmokes(options, { query, request }),
     resolveReconnectContracts(options, { query, request }),
-    resolveBargeInReports(options, { query, request })
+    resolveBargeInReports(options, { query, request }),
+    resolveProofSources(options, { query, request })
   ]);
   const degradedProviders = providers.filter((provider) => provider.status === "degraded" || provider.status === "rate-limited" || provider.status === "suppressed").length;
   const failedSessions = sessions.filter((session) => session.status === "failed").length;
@@ -19820,6 +19828,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       ]
     }
   ];
+  const proofSource = (...keys) => keys.map((key) => proofSources?.[key]).find((source) => source !== undefined);
   checks.push({
     detail: liveLatency.total === 0 ? "No browser live-latency measurements are recorded yet." : liveLatency.status === "pass" ? `Live browser turn latency averages ${liveLatency.averageLatencyMs}ms.` : `${liveLatency.failed} failed and ${liveLatency.warnings} warned live-latency measurement(s).`,
     href: options.links?.liveLatency ?? "/traces",
@@ -19925,6 +19934,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       detail: reconnectContractSummary.status === "pass" ? `${reconnectContractSummary.passed} reconnect contract(s) are passing.` : reconnectContractSummary.total === 0 ? "No reconnect contracts are configured." : `${reconnectContractSummary.failed} reconnect contract(s) failed.`,
       href: options.links?.reconnectContracts ?? options.links?.sessions ?? "/sessions",
       label: "Reconnect recovery contracts",
+      proofSource: proofSource("reconnectContracts", "reconnect"),
       status: reconnectContractSummary.status,
       value: `${reconnectContractSummary.passed}/${reconnectContractSummary.total}`,
       actions: reconnectContractSummary.status === "pass" ? [] : [
@@ -19941,6 +19951,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       detail: bargeInSummary.status === "pass" ? `${bargeInSummary.passed} barge-in interruption(s) stopped within threshold.` : bargeInSummary.total === 0 ? "No barge-in interruption proof is recorded yet." : bargeInSummary.status === "fail" ? `${bargeInSummary.failed} barge-in interruption(s) exceeded threshold.` : `${bargeInSummary.warnings} barge-in proof report(s) have warnings.`,
       href: options.links?.bargeIn ?? "/barge-in",
       label: "Barge-in interruption proof",
+      proofSource: proofSource("bargeInReports", "bargeIn"),
       status: bargeInSummary.status,
       value: `${bargeInSummary.passed}/${bargeInSummary.total}`,
       actions: bargeInSummary.status === "pass" ? [] : [
@@ -20038,6 +20049,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       traceDeliveries: "/traces/deliveries",
       ...options.links
     },
+    proofSources,
     status: rollupStatus2(checks),
     summary: {
       agentSquadContracts: agentSquadContractSummary,
@@ -20082,13 +20094,14 @@ var renderVoiceProductionReadinessHTML = (report, options = {}) => {
           <span>${escapeHtml32(check.status.toUpperCase())}</span>
           <h2>${escapeHtml32(check.label)}</h2>
           ${check.detail ? `<p>${escapeHtml32(check.detail)}</p>` : ""}
+          ${check.proofSource ? `<p class="proof-source">Proof source: ${check.proofSource.href ? `<a href="${escapeHtml32(check.proofSource.href)}">${escapeHtml32(check.proofSource.sourceLabel)}</a>` : escapeHtml32(check.proofSource.sourceLabel)}${check.proofSource.detail ? ` \xB7 ${escapeHtml32(check.proofSource.detail)}` : ""}</p>` : ""}
           ${actions ? `<p class="actions">${actions}</p>` : ""}
         </div>
         <strong>${escapeHtml32(String(check.value ?? check.status))}</strong>
         ${check.href ? `<a href="${escapeHtml32(check.href)}">Open surface</a>` : ""}
       </article>`;
   }).join("");
-  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml32(title)}</title><style>body{background:#0c0f14;color:#f6f2e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1060px;padding:32px}.hero{background:linear-gradient(135deg,rgba(20,184,166,.18),rgba(245,158,11,.12));border:1px solid #26313d;border-radius:28px;margin-bottom:18px;padding:28px}.eyebrow{color:#fbbf24;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.4rem,6vw,5rem);line-height:.9;margin:.2rem 0 1rem}.status{display:inline-flex;border:1px solid #3f3f46;border-radius:999px;padding:8px 12px}.status.pass,.check.pass{border-color:rgba(34,197,94,.55)}.status.warn,.check.warn{border-color:rgba(245,158,11,.65)}.status.fail,.check.fail{border-color:rgba(239,68,68,.75)}.checks{display:grid;gap:14px}.check{align-items:center;background:#141922;border:1px solid #26313d;border-radius:22px;display:grid;gap:16px;grid-template-columns:1fr auto auto;padding:18px}.check span{color:#a8b0b8;font-size:.78rem;font-weight:900;letter-spacing:.08em}.check h2{margin:.2rem 0}.check p{color:#b9c0c8;margin:.2rem 0 0}.check strong{font-size:1.5rem}.actions{display:flex;flex-wrap:wrap;gap:10px}.check a,a{color:#fbbf24}button{background:#fbbf24;border:0;border-radius:999px;color:#111827;cursor:pointer;font-weight:800;padding:9px 12px}button:disabled{cursor:wait;opacity:.65}@media(max-width:760px){main{padding:20px}.check{grid-template-columns:1fr}}</style></head><body><main><section class="hero"><p class="eyebrow">Self-hosted readiness</p><h1>${escapeHtml32(title)}</h1><p>One deployable pass/fail report for quality gates, provider failover, session health, handoffs, routing evidence, and optional carrier readiness.</p><p class="status ${escapeHtml32(report.status)}">Overall: ${escapeHtml32(report.status.toUpperCase())}</p><p>Checked ${escapeHtml32(new Date(report.checkedAt).toLocaleString())}</p></section><section class="checks">${checks}</section></main><script>document.querySelectorAll("[data-readiness-action]").forEach((button)=>{button.addEventListener("click",async()=>{const url=button.getAttribute("data-action-url");if(!url)return;button.disabled=true;const original=button.textContent;button.textContent="Running...";try{const response=await fetch(url,{method:"POST"});button.textContent=response.ok?"Done. Reloading...":"Failed";if(response.ok)setTimeout(()=>location.reload(),500)}catch{button.textContent="Failed"}finally{setTimeout(()=>{button.disabled=false;button.textContent=original},1500)}})});</script></body></html>`;
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml32(title)}</title><style>body{background:#0c0f14;color:#f6f2e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1060px;padding:32px}.hero{background:linear-gradient(135deg,rgba(20,184,166,.18),rgba(245,158,11,.12));border:1px solid #26313d;border-radius:28px;margin-bottom:18px;padding:28px}.eyebrow{color:#fbbf24;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.4rem,6vw,5rem);line-height:.9;margin:.2rem 0 1rem}.status{display:inline-flex;border:1px solid #3f3f46;border-radius:999px;padding:8px 12px}.status.pass,.check.pass{border-color:rgba(34,197,94,.55)}.status.warn,.check.warn{border-color:rgba(245,158,11,.65)}.status.fail,.check.fail{border-color:rgba(239,68,68,.75)}.checks{display:grid;gap:14px}.check{align-items:center;background:#141922;border:1px solid #26313d;border-radius:22px;display:grid;gap:16px;grid-template-columns:1fr auto auto;padding:18px}.check span{color:#a8b0b8;font-size:.78rem;font-weight:900;letter-spacing:.08em}.check h2{margin:.2rem 0}.check p{color:#b9c0c8;margin:.2rem 0 0}.check .proof-source{color:#f9d77e;font-weight:800}.check strong{font-size:1.5rem}.actions{display:flex;flex-wrap:wrap;gap:10px}.check a,a{color:#fbbf24}button{background:#fbbf24;border:0;border-radius:999px;color:#111827;cursor:pointer;font-weight:800;padding:9px 12px}button:disabled{cursor:wait;opacity:.65}@media(max-width:760px){main{padding:20px}.check{grid-template-columns:1fr}}</style></head><body><main><section class="hero"><p class="eyebrow">Self-hosted readiness</p><h1>${escapeHtml32(title)}</h1><p>One deployable pass/fail report for quality gates, provider failover, session health, handoffs, routing evidence, and optional carrier readiness.</p><p class="status ${escapeHtml32(report.status)}">Overall: ${escapeHtml32(report.status.toUpperCase())}</p><p>Checked ${escapeHtml32(new Date(report.checkedAt).toLocaleString())}</p></section><section class="checks">${checks}</section></main><script>document.querySelectorAll("[data-readiness-action]").forEach((button)=>{button.addEventListener("click",async()=>{const url=button.getAttribute("data-action-url");if(!url)return;button.disabled=true;const original=button.textContent;button.textContent="Running...";try{const response=await fetch(url,{method:"POST"});button.textContent=response.ok?"Done. Reloading...":"Failed";if(response.ok)setTimeout(()=>location.reload(),500)}catch{button.textContent="Failed"}finally{setTimeout(()=>{button.disabled=false;button.textContent=original},1500)}})});</script></body></html>`;
 };
 var createVoiceProductionReadinessRoutes = (options) => {
   const path = options.path ?? "/api/production-readiness";

package/dist/productionReadiness.d.ts

@@ -22,9 +22,17 @@ export type VoiceProductionReadinessCheck = {
     detail?: string;
     href?: string;
     label: string;
+    proofSource?: VoiceProductionReadinessProofSource;
     status: VoiceProductionReadinessStatus;
     value?: number | string;
 };
+export type VoiceProductionReadinessProofSource = {
+    detail?: string;
+    href?: string;
+    label?: string;
+    source: string;
+    sourceLabel: string;
+};
 export type VoiceProductionReadinessReport = {
     checkedAt: number;
     checks: VoiceProductionReadinessCheck[];
@@ -45,6 +53,7 @@ export type VoiceProductionReadinessReport = {
         sessions?: string;
         traceDeliveries?: string;
     };
+    proofSources?: Record<string, VoiceProductionReadinessProofSource>;
     status: VoiceProductionReadinessStatus;
     summary: {
         agentSquadContracts?: {
@@ -208,6 +217,10 @@ export type VoiceProductionReadinessRoutesOptions = {
         query: Record<string, unknown>;
         request: Request;
     }) => Promise<readonly VoiceReconnectContractReport[]> | readonly VoiceReconnectContractReport[]);
+    proofSources?: false | Record<string, VoiceProductionReadinessProofSource> | ((input: {
+        query: Record<string, unknown>;
+        request: Request;
+    }) => Promise<Record<string, VoiceProductionReadinessProofSource>> | Record<string, VoiceProductionReadinessProofSource>);
     render?: (report: VoiceProductionReadinessReport) => string | Promise<string>;
     store: VoiceTraceEventStore;
     sttProviders?: readonly string[];

package/package.json

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