@absolutejs/voice 0.0.22-beta.88 → 0.0.22-beta.89

package/dist/index.d.ts

@@ -62,7 +62,7 @@ export type { VoiceTurnQualityHTMLHandlerOptions, VoiceTurnQualityItem, VoiceTur
 export type { VoiceOutcomeContractDefinition, VoiceOutcomeContractHTMLHandlerOptions, VoiceOutcomeContractIssue, VoiceOutcomeContractOptions, VoiceOutcomeContractReport, VoiceOutcomeContractRoutesOptions, VoiceOutcomeContractStatus, VoiceOutcomeContractSuiteReport } from './outcomeContract';
 export type { VoiceTelephonyOutcomeAction, VoiceTelephonyOutcomeDecision, VoiceTelephonyOutcomePolicy, VoiceTelephonyOutcomeProviderEvent, VoiceTelephonyOutcomeRouteResult, VoiceTelephonyOutcomeStatusDecision, VoiceTelephonyWebhookDecision, VoiceTelephonyWebhookHandlerOptions, VoiceTelephonyWebhookIdempotencyStore, VoiceTelephonyWebhookParseInput, VoiceTelephonyWebhookProvider, VoiceTelephonyWebhookRoutesOptions, VoiceTelephonyWebhookVerificationResult, StoredVoiceTelephonyWebhookDecision } from './telephonyOutcome';
 export type { VoiceOpsConsoleLink, VoiceOpsConsoleReport, VoiceOpsConsoleRoutesOptions } from './opsConsoleRoutes';
-export type { VoiceProductionReadinessCheck, VoiceProductionReadinessReport, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessStatus } from './productionReadiness';
+export type { VoiceProductionReadinessAction, VoiceProductionReadinessCheck, VoiceProductionReadinessReport, VoiceProductionReadinessRoutesOptions, 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

@@ -9641,35 +9641,82 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       href: options.links?.quality ?? "/quality",
       label: "Quality gates",
       status: quality.status,
-      value: quality.status
+      value: quality.status,
+      actions: quality.status === "pass" ? [] : [
+        {
+          description: "Open the quality report to inspect failing gates.",
+          href: options.links?.quality ?? "/quality",
+          label: "Inspect quality gates"
+        }
+      ]
     },
     {
       detail: degradedProviders === 0 ? "No configured providers are currently degraded." : `${degradedProviders} provider(s) are degraded, suppressed, or rate-limited.`,
       href: options.links?.resilience ?? "/resilience",
       label: "Provider health",
       status: degradedProviders > 0 ? "fail" : "pass",
-      value: degradedProviders
+      value: degradedProviders,
+      actions: degradedProviders > 0 ? [
+        {
+          description: "Open provider health, fallback state, and recovery controls.",
+          href: options.links?.resilience ?? "/resilience",
+          label: "Open provider recovery"
+        }
+      ] : []
     },
     {
       detail: failedSessions === 0 ? sessions.length > 0 ? "Recent sessions have no recorded provider/session failures." : "No sessions have been recorded yet; run a smoke or live session for proof." : `${failedSessions} recent session(s) have failures.`,
       href: options.links?.sessions ?? "/sessions",
       label: "Session health",
       status: failedSessions > 0 ? "fail" : sessions.length === 0 ? "warn" : "pass",
-      value: `${sessions.length - failedSessions}/${sessions.length}`
+      value: `${sessions.length - failedSessions}/${sessions.length}`,
+      actions: failedSessions > 0 ? [
+        {
+          description: "Open failed sessions and replay traces.",
+          href: `${options.links?.sessions ?? "/sessions"}?status=failed`,
+          label: "Replay failed sessions"
+        }
+      ] : sessions.length === 0 ? [
+        {
+          description: "Open sessions after running a smoke or live call.",
+          href: options.links?.sessions ?? "/sessions",
+          label: "Open sessions"
+        }
+      ] : []
     },
     {
       detail: handoffs.failed === 0 ? "No failed handoff deliveries are recorded." : `${handoffs.failed} handoff delivery failure(s) are recorded.`,
       href: options.links?.handoffs ?? "/handoffs",
       label: "Handoff delivery",
       status: handoffs.failed > 0 ? "fail" : "pass",
-      value: `${handoffs.total - handoffs.failed}/${handoffs.total}`
+      value: `${handoffs.total - handoffs.failed}/${handoffs.total}`,
+      actions: handoffs.failed > 0 ? [
+        {
+          description: "Retry queued or failed handoff deliveries.",
+          href: options.links?.handoffRetry ?? "/api/voice-handoffs/retry",
+          label: "Retry handoff deliveries",
+          method: "POST"
+        },
+        {
+          description: "Inspect handoff queue and delivery errors.",
+          href: options.links?.handoffs ?? "/handoffs",
+          label: "Open handoff queue"
+        }
+      ] : []
     },
     {
       detail: routingEvents.length > 0 ? `${routingSessions.length} session(s) have provider routing evidence.` : "No provider routing traces are recorded yet.",
       href: options.links?.resilience ?? "/resilience",
       label: "Routing evidence",
       status: routingEvents.length > 0 ? "pass" : "warn",
-      value: routingEvents.length
+      value: routingEvents.length,
+      actions: routingEvents.length > 0 ? [] : [
+        {
+          description: "Open provider routing and run a smoke or simulation to create evidence.",
+          href: options.links?.resilience ?? "/resilience",
+          label: "Open routing evidence"
+        }
+      ]
     }
   ];
   const carrierSummary = carriers ? {
@@ -9685,7 +9732,14 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       href: options.links?.carriers ?? "/carriers",
       label: "Carrier readiness",
       status: carrierSummary.status,
-      value: `${carrierSummary.ready}/${carrierSummary.providers}`
+      value: `${carrierSummary.ready}/${carrierSummary.providers}`,
+      actions: carrierSummary.status === "pass" ? [] : [
+        {
+          description: "Open the carrier matrix for exact missing env, signing, and URL issues.",
+          href: options.links?.carriers ?? "/carriers",
+          label: "Open carrier matrix"
+        }
+      ]
     });
   }
   return {
@@ -9694,6 +9748,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     links: {
       carriers: "/carriers",
       handoffs: "/handoffs",
+      handoffRetry: "/api/voice-handoffs/retry",
       quality: "/quality",
       resilience: "/resilience",
       sessions: "/sessions",
@@ -9726,16 +9781,20 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
 };
 var renderVoiceProductionReadinessHTML = (report, options = {}) => {
   const title = options.title ?? "AbsoluteJS Voice Production Readiness";
-  const checks = report.checks.map((check) => `<article class="check ${escapeHtml15(check.status)}">
+  const checks = report.checks.map((check, index) => {
+    const actions = (check.actions ?? []).map((action) => action.method === "POST" ? `<button type="button" data-readiness-action="${index}" data-action-url="${escapeHtml15(action.href)}">${escapeHtml15(action.label)}</button>` : `<a href="${escapeHtml15(action.href)}">${escapeHtml15(action.label)}</a>`).join("");
+    return `<article class="check ${escapeHtml15(check.status)}">
         <div>
           <span>${escapeHtml15(check.status.toUpperCase())}</span>
           <h2>${escapeHtml15(check.label)}</h2>
           ${check.detail ? `<p>${escapeHtml15(check.detail)}</p>` : ""}
+          ${actions ? `<p class="actions">${actions}</p>` : ""}
         </div>
         <strong>${escapeHtml15(String(check.value ?? check.status))}</strong>
         ${check.href ? `<a href="${escapeHtml15(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>${escapeHtml15(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}.check a,a{color:#fbbf24}@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>${escapeHtml15(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 ${escapeHtml15(report.status)}">Overall: ${escapeHtml15(report.status.toUpperCase())}</p><p>Checked ${escapeHtml15(new Date(report.checkedAt).toLocaleString())}</p></section><section class="checks">${checks}</section></main></body></html>`;
+      </article>`;
+  }).join("");
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml15(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>${escapeHtml15(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 ${escapeHtml15(report.status)}">Overall: ${escapeHtml15(report.status.toUpperCase())}</p><p>Checked ${escapeHtml15(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

@@ -2,7 +2,14 @@ import { Elysia } from 'elysia';
 import { type VoiceTelephonyCarrierMatrixInput } from './telephony/matrix';
 import type { VoiceTraceEventStore } from './trace';
 export type VoiceProductionReadinessStatus = 'fail' | 'pass' | 'warn';
+export type VoiceProductionReadinessAction = {
+    description?: string;
+    href: string;
+    label: string;
+    method?: 'GET' | 'POST';
+};
 export type VoiceProductionReadinessCheck = {
+    actions?: VoiceProductionReadinessAction[];
     detail?: string;
     href?: string;
     label: string;
@@ -15,6 +22,7 @@ export type VoiceProductionReadinessReport = {
     links: {
         carriers?: string;
         handoffs?: string;
+        handoffRetry?: string;
         quality?: string;
         resilience?: string;
         sessions?: string;

package/package.json

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