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

package/dist/appKit.d.ts

@@ -6,11 +6,12 @@ import { type VoiceHandoffHealthRoutesOptions } from './handoffHealth';
 import { type VoiceOpsConsoleRoutesOptions } from './opsConsoleRoutes';
 import { type VoiceProviderHealthRoutesOptions } from './providerHealth';
 import { type VoiceProviderCapabilityRoutesOptions } from './providerCapabilities';
+import { type VoiceProductionReadinessRoutesOptions } from './productionReadiness';
 import { type VoiceQualityRoutesOptions } from './qualityRoutes';
 import { type VoiceResilienceRoutesOptions } from './resilienceRoutes';
 import { type VoiceSessionListRoutesOptions, type VoiceSessionReplayRoutesOptions } from './sessionReplay';
 import { type VoiceTraceEventStore } from './trace';
-export type VoiceAppKitSurface = 'assistantHealth' | 'diagnostics' | 'evals' | 'handoffs' | 'opsConsole' | 'providerCapabilities' | 'providerHealth' | 'quality' | 'resilience' | 'sessionReplay' | 'sessions';
+export type VoiceAppKitSurface = 'assistantHealth' | 'diagnostics' | 'evals' | 'handoffs' | 'opsConsole' | 'providerCapabilities' | 'providerHealth' | 'productionReadiness' | 'quality' | 'resilience' | 'sessionReplay' | 'sessions';
 export type VoiceAppKitLink = VoiceEvalLink & {
     description?: string;
     statusHref?: string;
@@ -28,6 +29,7 @@ export type VoiceAppKitRoutesOptions<TProvider extends string = string> = {
     opsConsole?: false | Partial<VoiceOpsConsoleRoutesOptions>;
     providerCapabilities?: false | Partial<VoiceProviderCapabilityRoutesOptions<TProvider>>;
     providerHealth?: false | Partial<VoiceProviderHealthRoutesOptions<TProvider>>;
+    productionReadiness?: false | Partial<VoiceProductionReadinessRoutesOptions>;
     quality?: false | Partial<VoiceQualityRoutesOptions>;
     resilience?: false | Partial<VoiceResilienceRoutesOptions>;
     sessionReplay?: false | Partial<VoiceSessionReplayRoutesOptions>;

package/dist/client/opsStatusWidget.d.ts

@@ -29,7 +29,7 @@ export type VoiceOpsStatusWidgetOptions = VoiceAppKitStatusClientOptions & {
     includeLinks?: boolean;
     title?: string;
 };
-export declare const getVoiceOpsStatusLabel: (report?: VoiceAppKitStatusReport | null, error?: string | null) => "Passing" | "Needs attention" | "Unavailable" | "Checking";
+export declare const getVoiceOpsStatusLabel: (report?: VoiceAppKitStatusReport | null, error?: string | null) => "Needs attention" | "Passing" | "Unavailable" | "Checking";
 export declare const createVoiceOpsStatusViewModel: (snapshot: VoiceAppKitStatusSnapshot, options?: VoiceOpsStatusWidgetOptions) => VoiceOpsStatusViewModel;
 export declare const renderVoiceOpsStatusHTML: (snapshot: VoiceAppKitStatusSnapshot, options?: VoiceOpsStatusWidgetOptions) => string;
 export declare const getVoiceOpsStatusCSS: () => string;

package/dist/index.d.ts

@@ -18,6 +18,7 @@ export { createAnthropicVoiceAssistantModel, createGeminiVoiceAssistantModel, cr
 export { createOpenAIVoiceTTS } from './openaiTTS';
 export { createVoiceProviderHealthHTMLHandler, createVoiceProviderHealthJSONHandler, createVoiceProviderHealthRoutes, renderVoiceProviderHealthHTML, summarizeVoiceProviderHealth } from './providerHealth';
 export { createVoiceProviderCapabilityHTMLHandler, createVoiceProviderCapabilityJSONHandler, createVoiceProviderCapabilityRoutes, renderVoiceProviderCapabilityHTML, summarizeVoiceProviderCapabilities } from './providerCapabilities';
+export { buildVoiceProductionReadinessReport, createVoiceProductionReadinessRoutes, renderVoiceProductionReadinessHTML } from './productionReadiness';
 export { buildVoiceOpsConsoleReport, createVoiceOpsConsoleRoutes, renderVoiceOpsConsoleHTML } from './opsConsoleRoutes';
 export { createVoiceQualityRoutes, evaluateVoiceQuality, renderVoiceQualityHTML } from './qualityRoutes';
 export { createVoiceResilienceRoutes, createVoiceRoutingDecisionSummary, listVoiceRoutingEvents, renderVoiceResilienceHTML, summarizeVoiceRoutingDecision, summarizeVoiceRoutingSessions } from './resilienceRoutes';
@@ -61,6 +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 { 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

@@ -5474,7 +5474,7 @@ var voice = (config) => {
   }).use(htmxRoutes());
 };
 // src/appKit.ts
-import { Elysia as Elysia12 } from "elysia";
+import { Elysia as Elysia14 } from "elysia";
 
 // src/assistantHealth.ts
 import { Elysia as Elysia3 } from "elysia";
@@ -9403,6 +9403,424 @@ var createVoiceProviderCapabilityRoutes = (options) => {
   return routes;
 };
 
+// src/productionReadiness.ts
+import { Elysia as Elysia13 } from "elysia";
+
+// src/telephony/matrix.ts
+import { Elysia as Elysia12 } from "elysia";
+
+// src/telephony/contract.ts
+var DEFAULT_REQUIREMENTS = [
+  "stream-url",
+  "wss-stream",
+  "webhook-url",
+  "signed-webhook",
+  "smoke-pass"
+];
+var hasFailingSmokeCheck = (smoke) => smoke?.checks.some((check) => check.status === "fail") ?? false;
+var evaluateVoiceTelephonyContract = (input) => {
+  const requirements = input.options?.requirements ?? DEFAULT_REQUIREMENTS;
+  const issues = [];
+  const hasRequirement = (requirement) => requirements.includes(requirement);
+  if (hasRequirement("stream-url") && !input.setup.urls.stream) {
+    issues.push({
+      message: "Missing media stream URL.",
+      requirement: "stream-url",
+      severity: "error"
+    });
+  }
+  if (hasRequirement("wss-stream") && !input.setup.urls.stream.startsWith("wss://")) {
+    issues.push({
+      message: "Media stream URL must use wss://.",
+      requirement: "wss-stream",
+      severity: "error"
+    });
+  }
+  if (hasRequirement("webhook-url") && !input.setup.urls.webhook) {
+    issues.push({
+      message: "Missing carrier webhook URL.",
+      requirement: "webhook-url",
+      severity: "error"
+    });
+  }
+  if (hasRequirement("signed-webhook") && !input.setup.signing.configured) {
+    issues.push({
+      message: "Carrier webhook signature verification is not configured.",
+      requirement: "signed-webhook",
+      severity: "error"
+    });
+  }
+  if (hasRequirement("smoke-pass")) {
+    if (!input.smoke) {
+      issues.push({
+        message: "Missing telephony smoke test report.",
+        requirement: "smoke-pass",
+        severity: "error"
+      });
+    } else if (!input.smoke.pass || hasFailingSmokeCheck(input.smoke)) {
+      issues.push({
+        message: "Telephony smoke test did not pass.",
+        requirement: "smoke-pass",
+        severity: "error"
+      });
+    }
+  }
+  for (const warning of input.setup.warnings) {
+    issues.push({
+      message: warning,
+      requirement: "stream-url",
+      severity: "warning"
+    });
+  }
+  for (const name of input.setup.missing) {
+    issues.push({
+      message: `${name} is missing.`,
+      requirement: "webhook-url",
+      severity: "error"
+    });
+  }
+  return {
+    issues,
+    pass: issues.every((issue) => issue.severity !== "error"),
+    provider: input.setup.provider,
+    requirements,
+    setup: input.setup,
+    smoke: input.smoke
+  };
+};
+
+// src/telephony/matrix.ts
+var escapeHtml14 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+var labelForProvider = (provider) => provider.split("-").map((part) => `${part.slice(0, 1).toUpperCase()}${part.slice(1)}`).join(" ");
+var resolveEntryStatus = (contract, setup, smoke) => {
+  if (!contract.pass || !setup.ready || smoke?.pass === false) {
+    return "fail";
+  }
+  if (contract.issues.some((issue) => issue.severity === "warning") || setup.warnings.length > 0 || smoke?.checks.some((check) => check.status === "warn")) {
+    return "warn";
+  }
+  return "pass";
+};
+var createVoiceTelephonyCarrierMatrix = (options) => {
+  const entries = options.providers.map((provider) => {
+    const contract = provider.contract ?? evaluateVoiceTelephonyContract({
+      options: options.contract,
+      setup: provider.setup,
+      smoke: provider.smoke
+    });
+    const failures = provider.smoke?.checks.filter((check) => check.status === "fail").length ?? 0;
+    const warnings = contract.issues.filter((issue) => issue.severity === "warning").length + (provider.smoke?.checks.filter((check) => check.status === "warn").length ?? 0);
+    const errors = contract.issues.filter((issue) => issue.severity === "error").length;
+    const status = resolveEntryStatus(contract, provider.setup, provider.smoke);
+    return {
+      contract,
+      issues: contract.issues,
+      name: provider.name ?? labelForProvider(provider.setup.provider),
+      provider: provider.setup.provider,
+      ready: provider.setup.ready,
+      setup: provider.setup,
+      smoke: provider.smoke,
+      status,
+      summary: {
+        errors,
+        failures,
+        missing: provider.setup.missing.length,
+        warnings
+      }
+    };
+  });
+  const summary = {
+    contractsPassing: entries.filter((entry) => entry.contract.pass).length,
+    failing: entries.filter((entry) => entry.status === "fail").length,
+    providers: entries.length,
+    ready: entries.filter((entry) => entry.ready).length,
+    smokePassing: entries.filter((entry) => entry.smoke?.pass).length,
+    warnings: entries.reduce((total, entry) => total + entry.summary.warnings, 0)
+  };
+  return {
+    entries,
+    generatedAt: options.generatedAt ?? Date.now(),
+    pass: entries.length > 0 && entries.every((entry) => entry.status !== "fail"),
+    summary
+  };
+};
+var badgeStyles = {
+  fail: "background:#fee2e2;color:#991b1b;border-color:#fecaca;",
+  pass: "background:#dcfce7;color:#166534;border-color:#bbf7d0;",
+  warn: "background:#fef3c7;color:#92400e;border-color:#fde68a;"
+};
+var renderVoiceTelephonyCarrierMatrixHTML = (matrix, options = {}) => `<main style="font-family: ui-sans-serif, system-ui; max-width: 1040px; margin: 40px auto; padding: 0 20px; color: #172033;">
+<p style="letter-spacing: .12em; text-transform: uppercase; color: #52606d;">Carrier matrix</p>
+<h1 style="font-size: 34px; margin: 0 0 8px;">${escapeHtml14(options.title ?? "AbsoluteJS Voice Carrier Matrix")}</h1>
+<p style="color:#52606d; margin: 0 0 24px;">${matrix.summary.ready}/${matrix.summary.providers} ready, ${matrix.summary.contractsPassing}/${matrix.summary.providers} contract passing, ${matrix.summary.smokePassing}/${matrix.summary.providers} smoke passing.</p>
+<section style="display:grid; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); gap: 16px;">
+${matrix.entries.map((entry) => `<article style="border:1px solid #d9e2ec; border-radius:18px; padding:18px; background:#fff; box-shadow:0 18px 48px rgba(15,23,42,.08);">
+<div style="display:flex; justify-content:space-between; gap:12px; align-items:center;">
+<h2 style="margin:0; font-size:20px;">${escapeHtml14(entry.name)}</h2>
+<span style="border:1px solid; border-radius:999px; padding:4px 10px; font-size:12px; font-weight:700; ${badgeStyles[entry.status]}">${escapeHtml14(entry.status.toUpperCase())}</span>
+</div>
+<dl style="display:grid; grid-template-columns: 1fr 1fr; gap:8px 12px; margin:16px 0;">
+<dt style="color:#64748b;">Setup</dt><dd style="margin:0; font-weight:700;">${entry.ready ? "Ready" : "Needs attention"}</dd>
+<dt style="color:#64748b;">Signing</dt><dd style="margin:0; font-weight:700;">${entry.setup.signing.configured ? entry.setup.signing.mode : "missing"}</dd>
+<dt style="color:#64748b;">Smoke</dt><dd style="margin:0; font-weight:700;">${entry.smoke ? entry.smoke.pass ? "Pass" : "Fail" : "Missing"}</dd>
+<dt style="color:#64748b;">Contract</dt><dd style="margin:0; font-weight:700;">${entry.contract.pass ? "Pass" : "Fail"}</dd>
+</dl>
+<p style="margin:0 0 8px; color:#475569;"><strong>Stream:</strong> <code>${escapeHtml14(entry.setup.urls.stream || "missing")}</code></p>
+<p style="margin:0 0 12px; color:#475569;"><strong>Webhook:</strong> <code>${escapeHtml14(entry.setup.urls.webhook || "missing")}</code></p>
+${entry.issues.length ? `<ul style="margin:12px 0 0; padding-left:18px;">${entry.issues.map((issue) => `<li>${escapeHtml14(issue.severity)}: ${escapeHtml14(issue.message)}</li>`).join("")}</ul>` : '<p style="margin:12px 0 0; color:#166534;">No contract issues.</p>'}
+</article>`).join("")}
+</section>
+</main>`;
+var createVoiceTelephonyCarrierMatrixRoutes = (options) => {
+  const path = options.path ?? "/api/voice/telephony/carriers";
+  return new Elysia12({
+    name: options.name ?? "absolutejs-voice-telephony-carrier-matrix"
+  }).get(path, async ({ query, request }) => {
+    const providers = await options.load({ query, request });
+    const matrix = createVoiceTelephonyCarrierMatrix({
+      contract: options.contract,
+      providers
+    });
+    if (query.format === "html") {
+      return new Response(renderVoiceTelephonyCarrierMatrixHTML(matrix, {
+        title: options.title
+      }), {
+        headers: {
+          "content-type": "text/html; charset=utf-8"
+        }
+      });
+    }
+    return matrix;
+  });
+};
+
+// src/productionReadiness.ts
+var escapeHtml15 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var rollupStatus = (checks) => checks.some((check) => check.status === "fail") ? "fail" : checks.some((check) => check.status === "warn") ? "warn" : "pass";
+var carrierStatus = (matrix) => matrix.summary.failing > 0 ? "fail" : matrix.summary.warnings > 0 || matrix.summary.ready < matrix.summary.providers ? "warn" : "pass";
+var resolveCarriers = async (options, input) => {
+  if (options.carriers === false || options.carriers === undefined) {
+    return;
+  }
+  const providers = typeof options.carriers === "function" ? await options.carriers(input) : options.carriers;
+  return createVoiceTelephonyCarrierMatrix({
+    providers: [...providers]
+  });
+};
+var buildVoiceProductionReadinessReport = async (options, input = {}) => {
+  const request = input.request ?? new Request("http://localhost/");
+  const query = input.query ?? {};
+  const events = await options.store.list();
+  const routingEvents = listVoiceRoutingEvents(events);
+  const routingSessions = summarizeVoiceRoutingSessions(routingEvents);
+  const [quality, providers, sessions, handoffs, carriers] = await Promise.all([
+    evaluateVoiceQuality({ events }),
+    Promise.all([
+      summarizeVoiceProviderHealth({
+        events,
+        providers: options.llmProviders ?? []
+      }),
+      summarizeVoiceProviderHealth({
+        events: events.filter((event) => event.payload.kind === "stt"),
+        providers: options.sttProviders ?? []
+      }),
+      summarizeVoiceProviderHealth({
+        events: events.filter((event) => event.payload.kind === "tts"),
+        providers: options.ttsProviders ?? []
+      })
+    ]).then((groups) => groups.flat()),
+    summarizeVoiceSessions({ events, status: "all" }),
+    summarizeVoiceHandoffHealth({ events }),
+    resolveCarriers(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;
+  const checks = [
+    {
+      detail: quality.status === "pass" ? "Quality gates are passing." : "Quality gates need attention.",
+      href: options.links?.quality ?? "/quality",
+      label: "Quality gates",
+      status: 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,
+      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}`,
+      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}`,
+      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,
+      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 ? {
+    failing: carriers.summary.failing,
+    providers: carriers.summary.providers,
+    ready: carriers.summary.ready,
+    status: carrierStatus(carriers),
+    warnings: carriers.summary.warnings
+  } : undefined;
+  if (carriers && carrierSummary) {
+    checks.push({
+      detail: carrierSummary.status === "pass" ? "Configured carrier setup and contract checks are passing." : `${carrierSummary.failing} carrier(s) failing, ${carrierSummary.warnings} warning(s).`,
+      href: options.links?.carriers ?? "/carriers",
+      label: "Carrier readiness",
+      status: carrierSummary.status,
+      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 {
+    checkedAt: Date.now(),
+    checks,
+    links: {
+      carriers: "/carriers",
+      handoffs: "/handoffs",
+      handoffRetry: "/api/voice-handoffs/retry",
+      quality: "/quality",
+      resilience: "/resilience",
+      sessions: "/sessions",
+      ...options.links
+    },
+    status: rollupStatus(checks),
+    summary: {
+      carriers: carrierSummary,
+      handoffs: {
+        failed: handoffs.failed,
+        total: handoffs.total
+      },
+      providers: {
+        degraded: degradedProviders,
+        total: providers.length
+      },
+      quality: {
+        status: quality.status
+      },
+      routing: {
+        events: routingEvents.length,
+        sessions: routingSessions.length
+      },
+      sessions: {
+        failed: failedSessions,
+        total: sessions.length
+      }
+    }
+  };
+};
+var renderVoiceProductionReadinessHTML = (report, options = {}) => {
+  const title = options.title ?? "AbsoluteJS Voice Production Readiness";
+  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}.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";
+  const htmlPath = options.htmlPath ?? "/production-readiness";
+  const routes = new Elysia13({
+    name: options.name ?? "absolutejs-voice-production-readiness"
+  });
+  routes.get(path, async ({ query, request }) => buildVoiceProductionReadinessReport(options, { query, request }));
+  if (htmlPath !== false) {
+    routes.get(htmlPath, async ({ query, request }) => {
+      const report = await buildVoiceProductionReadinessReport(options, {
+        query,
+        request
+      });
+      const body = await (options.render ?? renderVoiceProductionReadinessHTML)(report);
+      return new Response(body, {
+        headers: {
+          "Content-Type": "text/html; charset=utf-8",
+          ...options.headers
+        }
+      });
+    });
+  }
+  return routes;
+};
+
 // src/appKit.ts
 var DEFAULT_LINKS2 = [
   {
@@ -9427,6 +9845,12 @@ var DEFAULT_LINKS2 = [
     href: "/resilience",
     label: "Resilience"
   },
+  {
+    description: "One JSON/HTML production readiness rollup.",
+    href: "/production-readiness",
+    label: "Production Readiness",
+    statusHref: "/api/production-readiness"
+  },
   {
     description: "Recent sessions and replay links.",
     href: "/sessions",
@@ -9559,7 +9983,7 @@ var summarizeVoiceAppKitStatus = async (options) => {
   };
 };
 var createVoiceAppKitRoutes = (options) => {
-  const routes = new Elysia12({
+  const routes = new Elysia14({
     name: options.name ?? "absolutejs-voice-app-kit"
   });
   const links = resolveLinks(options.links);
@@ -9666,6 +10090,23 @@ var createVoiceAppKitRoutes = (options) => {
       ...options.resilience
     }));
   }
+  if (options.productionReadiness !== false) {
+    surfaces.push("productionReadiness");
+    routes.use(createVoiceProductionReadinessRoutes({
+      ...common,
+      links: {
+        handoffs: "/handoffs",
+        quality: "/quality",
+        resilience: "/resilience",
+        sessions: "/sessions"
+      },
+      llmProviders: options.llmProviders,
+      sttProviders: options.sttProviders,
+      title: options.title ? `${options.title} Production Readiness` : undefined,
+      ttsProviders: options.ttsProviders,
+      ...options.productionReadiness
+    }));
+  }
   if (options.opsConsole !== false) {
     surfaces.push("opsConsole");
     routes.use(createVoiceOpsConsoleRoutes({
@@ -10177,7 +10618,7 @@ var createVoiceToolIdempotencyKey = (input) => {
   ].join(":");
 };
 // src/toolContract.ts
-import { Elysia as Elysia13 } from "elysia";
+import { Elysia as Elysia15 } from "elysia";
 var createDefaultSession = (contractId, caseId) => createVoiceSessionRecord(`tool-contract-${contractId}-${caseId}`);
 var createDefaultTurn = (caseId) => ({
   committedAt: Date.now(),
@@ -10187,7 +10628,7 @@ var createDefaultTurn = (caseId) => ({
 });
 var defaultApi = {};
 var sameJSON = (left, right) => JSON.stringify(left) === JSON.stringify(right);
-var escapeHtml14 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var escapeHtml16 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var evaluateExpectation = (input) => {
   const issues = [];
   const expect = input.expect;
@@ -10353,19 +10794,19 @@ var renderVoiceToolContractHTML = (report, options = {}) => {
   const title = options.title ?? "Voice Tool Contracts";
   const contracts = report.contracts.map((contract) => {
     const cases = contract.cases.map((testCase) => `<tr>
-  <td>${escapeHtml14(testCase.label ?? testCase.caseId)}</td>
+  <td>${escapeHtml16(testCase.label ?? testCase.caseId)}</td>
   <td class="${testCase.pass ? "pass" : "fail"}">${testCase.pass ? "pass" : "fail"}</td>
-  <td>${escapeHtml14(testCase.status)}</td>
+  <td>${escapeHtml16(testCase.status)}</td>
   <td>${String(testCase.attempts)}</td>
   <td>${String(testCase.elapsedMs)}ms</td>
   <td>${testCase.timedOut ? "yes" : "no"}</td>
-  <td>${escapeHtml14(testCase.issues.map((issue) => issue.message).join(" ") || testCase.error || "")}</td>
+  <td>${escapeHtml16(testCase.issues.map((issue) => issue.message).join(" ") || testCase.error || "")}</td>
 </tr>`).join("");
     return `<section class="contract ${contract.pass ? "pass" : "fail"}">
   <div class="contract-header">
     <div>
-      <p class="eyebrow">${escapeHtml14(contract.toolName)}</p>
-      <h2>${escapeHtml14(contract.label ?? contract.contractId)}</h2>
+      <p class="eyebrow">${escapeHtml16(contract.toolName)}</p>
+      <h2>${escapeHtml16(contract.label ?? contract.contractId)}</h2>
     </div>
     <strong class="${contract.pass ? "pass" : "fail"}">${contract.pass ? "Passing" : "Failing"}</strong>
   </div>
@@ -10375,7 +10816,7 @@ var renderVoiceToolContractHTML = (report, options = {}) => {
   </table>
 </section>`;
   }).join("");
-  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml14(title)}</title><style>body{background:#101316;color:#f6f2e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1180px;padding:32px}.hero,.contract{background:#181d22;border:1px solid #2a323a;border-radius:20px;margin-bottom:16px;padding:20px}.hero{background:linear-gradient(135deg,rgba(34,197,94,.14),rgba(245,158,11,.12))}.eyebrow{color:#fbbf24;font-size:.78rem;font-weight:900;letter-spacing:.08em;text-transform:uppercase}h1{font-size:clamp(2.3rem,6vw,5rem);letter-spacing:-.06em;line-height:.9;margin:.2rem 0 1rem}.summary{display:flex;flex-wrap:wrap;gap:10px}.pill{background:#0f1217;border:1px solid #3f3f46;border-radius:999px;padding:7px 10px}.contract-header{align-items:flex-start;display:flex;gap:16px;justify-content:space-between}h2{margin:.2rem 0 1rem}.pass{color:#86efac}.fail{color:#fca5a5}.contract.fail{border-color:rgba(248,113,113,.45)}table{border-collapse:collapse;width:100%}td,th{border-bottom:1px solid #2a323a;padding:12px;text-align:left;vertical-align:top}th{color:#a8b0b8;font-size:.82rem}@media(max-width:800px){main{padding:18px}table{display:block;overflow:auto}.contract-header{display:block}}</style></head><body><main><section class="hero"><p class="eyebrow">Tool Reliability</p><h1>${escapeHtml14(title)}</h1><div class="summary"><span class="pill ${report.status === "pass" ? "pass" : "fail"}">${escapeHtml14(report.status)}</span><span class="pill">${String(report.passed)} passing</span><span class="pill">${String(report.failed)} failing</span><span class="pill">${String(report.total)} contracts</span></div></section>${contracts || '<section class="contract"><p>No tool contracts configured.</p></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>${escapeHtml16(title)}</title><style>body{background:#101316;color:#f6f2e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1180px;padding:32px}.hero,.contract{background:#181d22;border:1px solid #2a323a;border-radius:20px;margin-bottom:16px;padding:20px}.hero{background:linear-gradient(135deg,rgba(34,197,94,.14),rgba(245,158,11,.12))}.eyebrow{color:#fbbf24;font-size:.78rem;font-weight:900;letter-spacing:.08em;text-transform:uppercase}h1{font-size:clamp(2.3rem,6vw,5rem);letter-spacing:-.06em;line-height:.9;margin:.2rem 0 1rem}.summary{display:flex;flex-wrap:wrap;gap:10px}.pill{background:#0f1217;border:1px solid #3f3f46;border-radius:999px;padding:7px 10px}.contract-header{align-items:flex-start;display:flex;gap:16px;justify-content:space-between}h2{margin:.2rem 0 1rem}.pass{color:#86efac}.fail{color:#fca5a5}.contract.fail{border-color:rgba(248,113,113,.45)}table{border-collapse:collapse;width:100%}td,th{border-bottom:1px solid #2a323a;padding:12px;text-align:left;vertical-align:top}th{color:#a8b0b8;font-size:.82rem}@media(max-width:800px){main{padding:18px}table{display:block;overflow:auto}.contract-header{display:block}}</style></head><body><main><section class="hero"><p class="eyebrow">Tool Reliability</p><h1>${escapeHtml16(title)}</h1><div class="summary"><span class="pill ${report.status === "pass" ? "pass" : "fail"}">${escapeHtml16(report.status)}</span><span class="pill">${String(report.passed)} passing</span><span class="pill">${String(report.failed)} failing</span><span class="pill">${String(report.total)} contracts</span></div></section>${contracts || '<section class="contract"><p>No tool contracts configured.</p></section>'}</main></body></html>`;
 };
 var createVoiceToolContractJSONHandler = (options) => () => runVoiceToolContractSuite(options);
 var createVoiceToolContractHTMLHandler = (options) => async () => {
@@ -10392,7 +10833,7 @@ var createVoiceToolContractHTMLHandler = (options) => async () => {
 var createVoiceToolContractRoutes = (options) => {
   const path = options.path ?? "/api/tool-contracts";
   const htmlPath = options.htmlPath === undefined ? `${path}/htmx` : options.htmlPath;
-  const routes = new Elysia13({
+  const routes = new Elysia15({
     name: options.name ?? "absolutejs-voice-tool-contracts"
   }).get(path, createVoiceToolContractJSONHandler(options));
   if (htmlPath) {
@@ -10401,9 +10842,9 @@ var createVoiceToolContractRoutes = (options) => {
   return routes;
 };
 // src/turnQuality.ts
-import { Elysia as Elysia14 } from "elysia";
+import { Elysia as Elysia16 } from "elysia";
 var DEFAULT_CONFIDENCE_WARN_THRESHOLD = 0.72;
-var escapeHtml15 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var escapeHtml17 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var getTurnLatencyMs = (turn) => {
   const firstTranscriptAt = turn.transcripts.map((transcript) => transcript.endedAtMs ?? transcript.startedAtMs).filter((value) => typeof value === "number").sort((left, right) => left - right)[0];
   if (firstTranscriptAt === undefined) {
@@ -10474,24 +10915,24 @@ var summarizeVoiceTurnQuality = async (options) => {
 };
 var renderVoiceTurnQualityHTML = (report, options = {}) => {
   const title = options.title ?? "Voice Turn Quality";
-  const turns = report.turns.map((turn) => `<article class="turn ${escapeHtml15(turn.status)}">
+  const turns = report.turns.map((turn) => `<article class="turn ${escapeHtml17(turn.status)}">
   <div class="turn-header">
     <div>
-      <p class="eyebrow">${escapeHtml15(turn.sessionId)} \xB7 ${escapeHtml15(turn.turnId)}</p>
-      <h2>${escapeHtml15(turn.text || "Empty turn")}</h2>
+      <p class="eyebrow">${escapeHtml17(turn.sessionId)} \xB7 ${escapeHtml17(turn.turnId)}</p>
+      <h2>${escapeHtml17(turn.text || "Empty turn")}</h2>
     </div>
-    <strong>${escapeHtml15(turn.status)}</strong>
+    <strong>${escapeHtml17(turn.status)}</strong>
   </div>
   <dl>
-    <div><dt>Source</dt><dd>${escapeHtml15(turn.source ?? "unknown")}</dd></div>
+    <div><dt>Source</dt><dd>${escapeHtml17(turn.source ?? "unknown")}</dd></div>
     <div><dt>Confidence</dt><dd>${turn.averageConfidence === undefined ? "n/a" : `${Math.round(turn.averageConfidence * 100)}%`}</dd></div>
-    <div><dt>Fallback</dt><dd>${turn.fallbackUsed ? `yes (${escapeHtml15(turn.fallbackSelectionReason ?? "selected")})` : "no"}</dd></div>
-    <div><dt>Correction</dt><dd>${turn.correctionChanged ? `changed${turn.correctionProvider ? ` by ${escapeHtml15(turn.correctionProvider)}` : ""}` : "none"}</dd></div>
+    <div><dt>Fallback</dt><dd>${turn.fallbackUsed ? `yes (${escapeHtml17(turn.fallbackSelectionReason ?? "selected")})` : "no"}</dd></div>
+    <div><dt>Correction</dt><dd>${turn.correctionChanged ? `changed${turn.correctionProvider ? ` by ${escapeHtml17(turn.correctionProvider)}` : ""}` : "none"}</dd></div>
     <div><dt>Transcripts</dt><dd>${String(turn.selectedTranscriptCount)} selected \xB7 ${String(turn.finalTranscriptCount)} final \xB7 ${String(turn.partialTranscriptCount)} partial</dd></div>
     <div><dt>Cost</dt><dd>${turn.costUnits === undefined ? "n/a" : String(turn.costUnits)}</dd></div>
   </dl>
 </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:#101316;color:#f6f2e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1180px;padding:32px}.hero,.turn{background:#181d22;border:1px solid #2a323a;border-radius:20px;margin-bottom:16px;padding:20px}.hero{background:linear-gradient(135deg,rgba(251,191,36,.16),rgba(34,197,94,.1))}.eyebrow{color:#fbbf24;font-size:.78rem;font-weight:900;letter-spacing:.08em;text-transform:uppercase}h1{font-size:clamp(2.3rem,6vw,5rem);letter-spacing:-.06em;line-height:.9;margin:.2rem 0 1rem}h2{margin:.2rem 0 1rem}.summary{display:flex;flex-wrap:wrap;gap:10px}.pill{background:#0f1217;border:1px solid #3f3f46;border-radius:999px;padding:7px 10px}.turn-header{align-items:flex-start;display:flex;gap:16px;justify-content:space-between}.pass{color:#86efac}.warn,.unknown{color:#fde68a}.fail{color:#fca5a5}.turn.fail{border-color:rgba(248,113,113,.45)}dl{display:grid;gap:8px;grid-template-columns:repeat(auto-fit,minmax(160px,1fr))}dt{color:#a8b0b8;font-size:.8rem}dd{margin:0}@media(max-width:800px){main{padding:18px}.turn-header{display:block}}</style></head><body><main><section class="hero"><p class="eyebrow">Realtime STT Debugging</p><h1>${escapeHtml15(title)}</h1><div class="summary"><span class="pill ${escapeHtml15(report.status)}">${escapeHtml15(report.status)}</span><span class="pill">${String(report.total)} turns</span><span class="pill">${String(report.warnings)} warnings</span><span class="pill">${String(report.failed)} failed</span><span class="pill">${String(report.sessions)} sessions</span></div></section>${turns || '<section class="turn"><p>No committed turns found.</p></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>${escapeHtml17(title)}</title><style>body{background:#101316;color:#f6f2e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1180px;padding:32px}.hero,.turn{background:#181d22;border:1px solid #2a323a;border-radius:20px;margin-bottom:16px;padding:20px}.hero{background:linear-gradient(135deg,rgba(251,191,36,.16),rgba(34,197,94,.1))}.eyebrow{color:#fbbf24;font-size:.78rem;font-weight:900;letter-spacing:.08em;text-transform:uppercase}h1{font-size:clamp(2.3rem,6vw,5rem);letter-spacing:-.06em;line-height:.9;margin:.2rem 0 1rem}h2{margin:.2rem 0 1rem}.summary{display:flex;flex-wrap:wrap;gap:10px}.pill{background:#0f1217;border:1px solid #3f3f46;border-radius:999px;padding:7px 10px}.turn-header{align-items:flex-start;display:flex;gap:16px;justify-content:space-between}.pass{color:#86efac}.warn,.unknown{color:#fde68a}.fail{color:#fca5a5}.turn.fail{border-color:rgba(248,113,113,.45)}dl{display:grid;gap:8px;grid-template-columns:repeat(auto-fit,minmax(160px,1fr))}dt{color:#a8b0b8;font-size:.8rem}dd{margin:0}@media(max-width:800px){main{padding:18px}.turn-header{display:block}}</style></head><body><main><section class="hero"><p class="eyebrow">Realtime STT Debugging</p><h1>${escapeHtml17(title)}</h1><div class="summary"><span class="pill ${escapeHtml17(report.status)}">${escapeHtml17(report.status)}</span><span class="pill">${String(report.total)} turns</span><span class="pill">${String(report.warnings)} warnings</span><span class="pill">${String(report.failed)} failed</span><span class="pill">${String(report.sessions)} sessions</span></div></section>${turns || '<section class="turn"><p>No committed turns found.</p></section>'}</main></body></html>`;
 };
 var createVoiceTurnQualityJSONHandler = (options) => async () => summarizeVoiceTurnQuality(options);
 var createVoiceTurnQualityHTMLHandler = (options) => async () => {
@@ -10508,7 +10949,7 @@ var createVoiceTurnQualityHTMLHandler = (options) => async () => {
 var createVoiceTurnQualityRoutes = (options) => {
   const path = options.path ?? "/api/turn-quality";
   const htmlPath = options.htmlPath === undefined ? `${path}/htmx` : options.htmlPath;
-  const routes = new Elysia14({
+  const routes = new Elysia16({
     name: options.name ?? "absolutejs-voice-turn-quality"
   }).get(path, createVoiceTurnQualityJSONHandler(options));
   if (htmlPath) {
@@ -10517,8 +10958,8 @@ var createVoiceTurnQualityRoutes = (options) => {
   return routes;
 };
 // src/outcomeContract.ts
-import { Elysia as Elysia15 } from "elysia";
-var escapeHtml16 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+import { Elysia as Elysia17 } from "elysia";
+var escapeHtml18 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var getPayloadString = (event, key) => typeof event.payload[key] === "string" ? event.payload[key] : undefined;
 var toList = async (input) => Array.isArray(input) ? input : await input?.list() ?? [];
 var hydrateSessions = async (input) => {
@@ -10626,9 +11067,9 @@ var renderVoiceOutcomeContractHTML = (report, options = {}) => {
   const contracts = report.contracts.map((contract) => `<section class="contract ${contract.pass ? "pass" : "fail"}">
   <div class="contract-header">
     <div>
-      <p class="eyebrow">${escapeHtml16(contract.contractId)}</p>
-      <h2>${escapeHtml16(contract.label ?? contract.contractId)}</h2>
-      ${contract.description ? `<p>${escapeHtml16(contract.description)}</p>` : ""}
+      <p class="eyebrow">${escapeHtml18(contract.contractId)}</p>
+      <h2>${escapeHtml18(contract.label ?? contract.contractId)}</h2>
+      ${contract.description ? `<p>${escapeHtml18(contract.description)}</p>` : ""}
     </div>
     <strong>${contract.pass ? "pass" : "fail"}</strong>
   </div>
@@ -10639,9 +11080,9 @@ var renderVoiceOutcomeContractHTML = (report, options = {}) => {
     <span>handoffs ${String(contract.matched.handoffs)}</span>
     <span>events ${String(contract.matched.integrationEvents)}</span>
   </div>
-  ${contract.issues.length ? `<ul>${contract.issues.map((issue) => `<li>${escapeHtml16(issue.message)}</li>`).join("")}</ul>` : ""}
+  ${contract.issues.length ? `<ul>${contract.issues.map((issue) => `<li>${escapeHtml18(issue.message)}</li>`).join("")}</ul>` : ""}
 </section>`).join("");
-  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml16(title)}</title><style>body{background:#101316;color:#f6f2e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1180px;padding:32px}.hero,.contract{background:#181d22;border:1px solid #2a323a;border-radius:20px;margin-bottom:16px;padding:20px}.hero{background:linear-gradient(135deg,rgba(34,197,94,.14),rgba(14,165,233,.12))}.eyebrow{color:#7dd3fc;font-size:.78rem;font-weight:900;letter-spacing:.08em;text-transform:uppercase}h1{font-size:clamp(2.3rem,6vw,5rem);letter-spacing:-.06em;line-height:.9;margin:.2rem 0 1rem}h2{margin:.2rem 0}.summary,.grid{display:flex;flex-wrap:wrap;gap:10px}.pill,.grid span{background:#0f1217;border:1px solid #3f3f46;border-radius:999px;padding:7px 10px}.contract-header{display:flex;gap:16px;justify-content:space-between}.pass{color:#86efac}.fail{color:#fca5a5}.contract.fail{border-color:rgba(248,113,113,.45)}li{margin:8px 0}@media(max-width:800px){main{padding:18px}.contract-header{display:block}}</style></head><body><main><section class="hero"><p class="eyebrow">Business Outcome Verification</p><h1>${escapeHtml16(title)}</h1><div class="summary"><span class="pill ${report.status}">${report.status}</span><span class="pill">${String(report.passed)} passing</span><span class="pill">${String(report.failed)} failing</span><span class="pill">${String(report.total)} contracts</span></div></section>${contracts || '<section class="contract"><p>No outcome contracts configured.</p></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>${escapeHtml18(title)}</title><style>body{background:#101316;color:#f6f2e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1180px;padding:32px}.hero,.contract{background:#181d22;border:1px solid #2a323a;border-radius:20px;margin-bottom:16px;padding:20px}.hero{background:linear-gradient(135deg,rgba(34,197,94,.14),rgba(14,165,233,.12))}.eyebrow{color:#7dd3fc;font-size:.78rem;font-weight:900;letter-spacing:.08em;text-transform:uppercase}h1{font-size:clamp(2.3rem,6vw,5rem);letter-spacing:-.06em;line-height:.9;margin:.2rem 0 1rem}h2{margin:.2rem 0}.summary,.grid{display:flex;flex-wrap:wrap;gap:10px}.pill,.grid span{background:#0f1217;border:1px solid #3f3f46;border-radius:999px;padding:7px 10px}.contract-header{display:flex;gap:16px;justify-content:space-between}.pass{color:#86efac}.fail{color:#fca5a5}.contract.fail{border-color:rgba(248,113,113,.45)}li{margin:8px 0}@media(max-width:800px){main{padding:18px}.contract-header{display:block}}</style></head><body><main><section class="hero"><p class="eyebrow">Business Outcome Verification</p><h1>${escapeHtml18(title)}</h1><div class="summary"><span class="pill ${report.status}">${report.status}</span><span class="pill">${String(report.passed)} passing</span><span class="pill">${String(report.failed)} failing</span><span class="pill">${String(report.total)} contracts</span></div></section>${contracts || '<section class="contract"><p>No outcome contracts configured.</p></section>'}</main></body></html>`;
 };
 var createVoiceOutcomeContractJSONHandler = (options) => async () => runVoiceOutcomeContractSuite(options);
 var createVoiceOutcomeContractHTMLHandler = (options) => async () => {
@@ -10657,7 +11098,7 @@ var createVoiceOutcomeContractHTMLHandler = (options) => async () => {
 var createVoiceOutcomeContractRoutes = (options) => {
   const path = options.path ?? "/api/outcome-contracts";
   const htmlPath = options.htmlPath === undefined ? `${path}/htmx` : options.htmlPath;
-  const routes = new Elysia15({
+  const routes = new Elysia17({
     name: options.name ?? "absolutejs-voice-outcome-contracts"
   }).get(path, createVoiceOutcomeContractJSONHandler(options));
   if (htmlPath) {
@@ -10666,7 +11107,7 @@ var createVoiceOutcomeContractRoutes = (options) => {
   return routes;
 };
 // src/telephonyOutcome.ts
-import { Elysia as Elysia16 } from "elysia";
+import { Elysia as Elysia18 } from "elysia";
 var DEFAULT_COMPLETED_STATUSES = [
   "answered",
   "completed",
@@ -11313,7 +11754,7 @@ var createVoiceTelephonyWebhookHandler = (options = {}) => async (input) => {
 var createVoiceTelephonyWebhookRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice/telephony/webhook";
   const handler = createVoiceTelephonyWebhookHandler(options);
-  return new Elysia16({
+  return new Elysia18({
     name: options.name ?? "absolutejs-voice-telephony-webhooks"
   }).post(path, async ({ query, request }) => {
     try {
@@ -13581,7 +14022,7 @@ var createVoiceMemoryStore = () => {
   return { get, getOrCreate, list, remove, set };
 };
 // src/opsWebhook.ts
-import { Elysia as Elysia17 } from "elysia";
+import { Elysia as Elysia19 } from "elysia";
 var toHex5 = (bytes) => Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
 var signVoiceOpsWebhookBody = async (input) => {
   const encoder = new TextEncoder;
@@ -13711,7 +14152,7 @@ var verifyVoiceOpsWebhookSignature = async (input) => {
 };
 var createVoiceOpsWebhookReceiverRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice-ops/webhook";
-  return new Elysia17().post(path, async ({ body, request, set }) => {
+  return new Elysia19().post(path, async ({ body, request, set }) => {
     const bodyText = typeof body === "string" ? body : JSON.stringify(body);
     if (options.signingSecret) {
       const verification = await verifyVoiceOpsWebhookSignature({
@@ -15440,7 +15881,7 @@ var createVoiceSTTRoutingCorrectionHandler = (mode = "generic") => {
 };
 // src/telephony/twilio.ts
 import { Buffer as Buffer3 } from "buffer";
-import { Elysia as Elysia18 } from "elysia";
+import { Elysia as Elysia20 } from "elysia";
 var TWILIO_MULAW_SAMPLE_RATE = 8000;
 var VOICE_PCM_SAMPLE_RATE = 16000;
 var escapeXml2 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&apos;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
@@ -15470,7 +15911,7 @@ var resolveTwilioStreamParameters = async (parameters, input) => {
   return parameters;
 };
 var joinUrlPath = (origin, path) => `${origin.replace(/\/$/, "")}${path.startsWith("/") ? path : `/${path}`}`;
-var escapeHtml17 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+var escapeHtml19 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
 var getWebhookVerificationUrl = (webhook, input) => {
   if (!webhook?.verificationUrl) {
     return;
@@ -15513,23 +15954,23 @@ var buildTwilioVoiceSetupStatus = async (options, input) => {
 };
 var renderTwilioVoiceSetupHTML = (status, title) => `<main style="font-family: ui-sans-serif, system-ui; max-width: 860px; margin: 40px auto; padding: 0 20px;">
 <p style="letter-spacing: .12em; text-transform: uppercase; color: #52606d;">Twilio setup</p>
-<h1>${escapeHtml17(title)}</h1>
+<h1>${escapeHtml19(title)}</h1>
 <p><strong>Status:</strong> ${status.ready ? "Ready" : "Needs attention"}</p>
 <section>
 <h2>URLs</h2>
 <ul>
-<li><strong>TwiML:</strong> <code>${escapeHtml17(status.urls.twiml)}</code></li>
-<li><strong>Media stream:</strong> <code>${escapeHtml17(status.urls.stream)}</code></li>
-<li><strong>Status webhook:</strong> <code>${escapeHtml17(status.urls.webhook)}</code></li>
+<li><strong>TwiML:</strong> <code>${escapeHtml19(status.urls.twiml)}</code></li>
+<li><strong>Media stream:</strong> <code>${escapeHtml19(status.urls.stream)}</code></li>
+<li><strong>Status webhook:</strong> <code>${escapeHtml19(status.urls.webhook)}</code></li>
 </ul>
 </section>
 <section>
 <h2>Signing</h2>
 <p>Mode: <code>${status.signing.mode}</code></p>
-${status.signing.verificationUrl ? `<p>Verification URL: <code>${escapeHtml17(status.signing.verificationUrl)}</code></p>` : ""}
+${status.signing.verificationUrl ? `<p>Verification URL: <code>${escapeHtml19(status.signing.verificationUrl)}</code></p>` : ""}
 </section>
-${status.missing.length ? `<section><h2>Missing env</h2><ul>${status.missing.map((name) => `<li><code>${escapeHtml17(name)}</code></li>`).join("")}</ul></section>` : ""}
-${status.warnings.length ? `<section><h2>Warnings</h2><ul>${status.warnings.map((warning) => `<li>${escapeHtml17(warning)}</li>`).join("")}</ul></section>` : ""}
+${status.missing.length ? `<section><h2>Missing env</h2><ul>${status.missing.map((name) => `<li><code>${escapeHtml19(name)}</code></li>`).join("")}</ul></section>` : ""}
+${status.warnings.length ? `<section><h2>Warnings</h2><ul>${status.warnings.map((warning) => `<li>${escapeHtml19(warning)}</li>`).join("")}</ul></section>` : ""}
 </main>`;
 var extractTwilioStreamUrl = (twiml) => twiml.match(/<Stream\b[^>]*\surl="([^"]+)"/i)?.[1]?.replaceAll("&amp;", "&");
 var createSmokeCheck = (name, status, message, details) => ({
@@ -15540,20 +15981,20 @@ var createSmokeCheck = (name, status, message, details) => ({
 });
 var renderTwilioVoiceSmokeHTML = (report, title) => `<main style="font-family: ui-sans-serif, system-ui; max-width: 860px; margin: 40px auto; padding: 0 20px;">
 <p style="letter-spacing: .12em; text-transform: uppercase; color: #52606d;">Twilio smoke test</p>
-<h1>${escapeHtml17(title)}</h1>
+<h1>${escapeHtml19(title)}</h1>
 <p><strong>Status:</strong> ${report.pass ? "Pass" : "Fail"}</p>
 <section>
 <h2>Checks</h2>
 <ul>
-${report.checks.map((check) => `<li><strong>${escapeHtml17(check.name)}</strong>: ${escapeHtml17(check.status)}${check.message ? ` - ${escapeHtml17(check.message)}` : ""}</li>`).join("")}
+${report.checks.map((check) => `<li><strong>${escapeHtml19(check.name)}</strong>: ${escapeHtml19(check.status)}${check.message ? ` - ${escapeHtml19(check.message)}` : ""}</li>`).join("")}
 </ul>
 </section>
 <section>
 <h2>Observed URLs</h2>
 <ul>
-<li><strong>TwiML:</strong> <code>${escapeHtml17(report.setup.urls.twiml)}</code></li>
-<li><strong>Stream:</strong> <code>${escapeHtml17(report.twiml?.streamUrl ?? report.setup.urls.stream)}</code></li>
-<li><strong>Webhook:</strong> <code>${escapeHtml17(report.setup.urls.webhook)}</code></li>
+<li><strong>TwiML:</strong> <code>${escapeHtml19(report.setup.urls.twiml)}</code></li>
+<li><strong>Stream:</strong> <code>${escapeHtml19(report.twiml?.streamUrl ?? report.setup.urls.stream)}</code></li>
+<li><strong>Webhook:</strong> <code>${escapeHtml19(report.setup.urls.webhook)}</code></li>
 </ul>
 </section>
 </main>`;
@@ -16013,7 +16454,7 @@ var createTwilioVoiceRoutes = (options) => {
   const smokePath = options.smoke?.path === false ? false : options.smoke?.path ?? "/api/voice/twilio/smoke";
   const bridges = new WeakMap;
   const webhookPolicy = options.webhook?.policy ?? options.outcomePolicy ?? createVoiceTelephonyOutcomePolicy();
-  const app = new Elysia18({
+  const app = new Elysia20({
     name: options.name ?? "absolutejs-voice-twilio"
   }).get(twimlPath, async ({ query, request }) => {
     const streamUrl = await resolveTwilioStreamUrl(options, {
@@ -16147,90 +16588,11 @@ var createTwilioVoiceRoutes = (options) => {
     return report;
   });
 };
-// src/telephony/contract.ts
-var DEFAULT_REQUIREMENTS = [
-  "stream-url",
-  "wss-stream",
-  "webhook-url",
-  "signed-webhook",
-  "smoke-pass"
-];
-var hasFailingSmokeCheck = (smoke) => smoke?.checks.some((check) => check.status === "fail") ?? false;
-var evaluateVoiceTelephonyContract = (input) => {
-  const requirements = input.options?.requirements ?? DEFAULT_REQUIREMENTS;
-  const issues = [];
-  const hasRequirement = (requirement) => requirements.includes(requirement);
-  if (hasRequirement("stream-url") && !input.setup.urls.stream) {
-    issues.push({
-      message: "Missing media stream URL.",
-      requirement: "stream-url",
-      severity: "error"
-    });
-  }
-  if (hasRequirement("wss-stream") && !input.setup.urls.stream.startsWith("wss://")) {
-    issues.push({
-      message: "Media stream URL must use wss://.",
-      requirement: "wss-stream",
-      severity: "error"
-    });
-  }
-  if (hasRequirement("webhook-url") && !input.setup.urls.webhook) {
-    issues.push({
-      message: "Missing carrier webhook URL.",
-      requirement: "webhook-url",
-      severity: "error"
-    });
-  }
-  if (hasRequirement("signed-webhook") && !input.setup.signing.configured) {
-    issues.push({
-      message: "Carrier webhook signature verification is not configured.",
-      requirement: "signed-webhook",
-      severity: "error"
-    });
-  }
-  if (hasRequirement("smoke-pass")) {
-    if (!input.smoke) {
-      issues.push({
-        message: "Missing telephony smoke test report.",
-        requirement: "smoke-pass",
-        severity: "error"
-      });
-    } else if (!input.smoke.pass || hasFailingSmokeCheck(input.smoke)) {
-      issues.push({
-        message: "Telephony smoke test did not pass.",
-        requirement: "smoke-pass",
-        severity: "error"
-      });
-    }
-  }
-  for (const warning of input.setup.warnings) {
-    issues.push({
-      message: warning,
-      requirement: "stream-url",
-      severity: "warning"
-    });
-  }
-  for (const name of input.setup.missing) {
-    issues.push({
-      message: `${name} is missing.`,
-      requirement: "webhook-url",
-      severity: "error"
-    });
-  }
-  return {
-    issues,
-    pass: issues.every((issue) => issue.severity !== "error"),
-    provider: input.setup.provider,
-    requirements,
-    setup: input.setup,
-    smoke: input.smoke
-  };
-};
 // src/telephony/telnyx.ts
 import { Buffer as Buffer4 } from "buffer";
-import { Elysia as Elysia19 } from "elysia";
+import { Elysia as Elysia21 } from "elysia";
 var escapeXml3 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&apos;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
-var escapeHtml18 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+var escapeHtml20 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
 var joinUrlPath2 = (origin, path) => `${origin.replace(/\/$/, "")}${path.startsWith("/") ? path : `/${path}`}`;
 var resolveRequestOrigin2 = (request) => {
   const url = new URL(request.url);
@@ -16431,21 +16793,21 @@ var buildTelnyxVoiceSetupStatus = async (options, input) => {
 };
 var renderTelnyxSetupHTML = (status, title) => `<main style="font-family: ui-sans-serif, system-ui; max-width: 860px; margin: 40px auto; padding: 0 20px;">
 <p style="letter-spacing: .12em; text-transform: uppercase; color: #52606d;">Telnyx setup</p>
-<h1>${escapeHtml18(title)}</h1>
+<h1>${escapeHtml20(title)}</h1>
 <p><strong>Status:</strong> ${status.ready ? "Ready" : "Needs attention"}</p>
 <ul>
-<li><strong>TeXML:</strong> <code>${escapeHtml18(status.urls.texml)}</code></li>
-<li><strong>Media stream:</strong> <code>${escapeHtml18(status.urls.stream)}</code></li>
-<li><strong>Status webhook:</strong> <code>${escapeHtml18(status.urls.webhook)}</code></li>
+<li><strong>TeXML:</strong> <code>${escapeHtml20(status.urls.texml)}</code></li>
+<li><strong>Media stream:</strong> <code>${escapeHtml20(status.urls.stream)}</code></li>
+<li><strong>Status webhook:</strong> <code>${escapeHtml20(status.urls.webhook)}</code></li>
 </ul>
-${status.missing.length ? `<h2>Missing env</h2><ul>${status.missing.map((name) => `<li><code>${escapeHtml18(name)}</code></li>`).join("")}</ul>` : ""}
-${status.warnings.length ? `<h2>Warnings</h2><ul>${status.warnings.map((warning) => `<li>${escapeHtml18(warning)}</li>`).join("")}</ul>` : ""}
+${status.missing.length ? `<h2>Missing env</h2><ul>${status.missing.map((name) => `<li><code>${escapeHtml20(name)}</code></li>`).join("")}</ul>` : ""}
+${status.warnings.length ? `<h2>Warnings</h2><ul>${status.warnings.map((warning) => `<li>${escapeHtml20(warning)}</li>`).join("")}</ul>` : ""}
 </main>`;
 var renderTelnyxSmokeHTML = (report, title) => `<main style="font-family: ui-sans-serif, system-ui; max-width: 860px; margin: 40px auto; padding: 0 20px;">
 <p style="letter-spacing: .12em; text-transform: uppercase; color: #52606d;">Telnyx smoke test</p>
-<h1>${escapeHtml18(title)}</h1>
+<h1>${escapeHtml20(title)}</h1>
 <p><strong>Status:</strong> ${report.pass ? "Pass" : "Fail"}</p>
-<ul>${report.checks.map((check) => `<li><strong>${escapeHtml18(check.name)}</strong>: ${escapeHtml18(check.status)}${check.message ? ` - ${escapeHtml18(check.message)}` : ""}</li>`).join("")}</ul>
+<ul>${report.checks.map((check) => `<li><strong>${escapeHtml20(check.name)}</strong>: ${escapeHtml20(check.status)}${check.message ? ` - ${escapeHtml20(check.message)}` : ""}</li>`).join("")}</ul>
 </main>`;
 var runTelnyxSmokeTest = async (input) => {
   const setup = await buildTelnyxVoiceSetupStatus(input.options, input);
@@ -16539,7 +16901,7 @@ var createTelnyxVoiceRoutes = (options = {}) => {
     publicKey: options.webhook?.publicKey,
     toleranceSeconds: options.webhook?.toleranceSeconds
   }) : undefined);
-  const app = new Elysia19({
+  const app = new Elysia21({
     name: options.name ?? "absolutejs-voice-telnyx"
   }).get(texmlPath, async ({ query, request }) => {
     const streamUrl = await resolveTelnyxStreamUrl(options, {
@@ -16649,9 +17011,9 @@ var createTelnyxVoiceRoutes = (options = {}) => {
 };
 // src/telephony/plivo.ts
 import { Buffer as Buffer5 } from "buffer";
-import { Elysia as Elysia20 } from "elysia";
+import { Elysia as Elysia22 } from "elysia";
 var escapeXml4 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&apos;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
-var escapeHtml19 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+var escapeHtml21 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
 var joinUrlPath3 = (origin, path) => `${origin.replace(/\/$/, "")}${path.startsWith("/") ? path : `/${path}`}`;
 var resolveRequestOrigin3 = (request) => {
   const url = new URL(request.url);
@@ -16902,21 +17264,21 @@ var buildPlivoVoiceSetupStatus = async (options, input) => {
 };
 var renderPlivoSetupHTML = (status, title) => `<main style="font-family: ui-sans-serif, system-ui; max-width: 860px; margin: 40px auto; padding: 0 20px;">
 <p style="letter-spacing: .12em; text-transform: uppercase; color: #52606d;">Plivo setup</p>
-<h1>${escapeHtml19(title)}</h1>
+<h1>${escapeHtml21(title)}</h1>
 <p><strong>Status:</strong> ${status.ready ? "Ready" : "Needs attention"}</p>
 <ul>
-<li><strong>Answer XML:</strong> <code>${escapeHtml19(status.urls.answer)}</code></li>
-<li><strong>Audio stream:</strong> <code>${escapeHtml19(status.urls.stream)}</code></li>
-<li><strong>Status webhook:</strong> <code>${escapeHtml19(status.urls.webhook)}</code></li>
+<li><strong>Answer XML:</strong> <code>${escapeHtml21(status.urls.answer)}</code></li>
+<li><strong>Audio stream:</strong> <code>${escapeHtml21(status.urls.stream)}</code></li>
+<li><strong>Status webhook:</strong> <code>${escapeHtml21(status.urls.webhook)}</code></li>
 </ul>
-${status.missing.length ? `<h2>Missing env</h2><ul>${status.missing.map((name) => `<li><code>${escapeHtml19(name)}</code></li>`).join("")}</ul>` : ""}
-${status.warnings.length ? `<h2>Warnings</h2><ul>${status.warnings.map((warning) => `<li>${escapeHtml19(warning)}</li>`).join("")}</ul>` : ""}
+${status.missing.length ? `<h2>Missing env</h2><ul>${status.missing.map((name) => `<li><code>${escapeHtml21(name)}</code></li>`).join("")}</ul>` : ""}
+${status.warnings.length ? `<h2>Warnings</h2><ul>${status.warnings.map((warning) => `<li>${escapeHtml21(warning)}</li>`).join("")}</ul>` : ""}
 </main>`;
 var renderPlivoSmokeHTML = (report, title) => `<main style="font-family: ui-sans-serif, system-ui; max-width: 860px; margin: 40px auto; padding: 0 20px;">
 <p style="letter-spacing: .12em; text-transform: uppercase; color: #52606d;">Plivo smoke test</p>
-<h1>${escapeHtml19(title)}</h1>
+<h1>${escapeHtml21(title)}</h1>
 <p><strong>Status:</strong> ${report.pass ? "Pass" : "Fail"}</p>
-<ul>${report.checks.map((check) => `<li><strong>${escapeHtml19(check.name)}</strong>: ${escapeHtml19(check.status)}${check.message ? ` - ${escapeHtml19(check.message)}` : ""}</li>`).join("")}</ul>
+<ul>${report.checks.map((check) => `<li><strong>${escapeHtml21(check.name)}</strong>: ${escapeHtml21(check.status)}${check.message ? ` - ${escapeHtml21(check.message)}` : ""}</li>`).join("")}</ul>
 </main>`;
 var runPlivoSmokeTest = async (input) => {
   const setup = await buildPlivoVoiceSetupStatus(input.options, input);
@@ -17011,7 +17373,7 @@ var createPlivoVoiceRoutes = (options = {}) => {
       request: input.request
     }) : verificationUrl ?? input.request.url
   }) : undefined);
-  const app = new Elysia20({
+  const app = new Elysia22({
     name: options.name ?? "absolutejs-voice-plivo"
   }).get(answerPath, async ({ query, request }) => {
     const streamUrl = await resolvePlivoStreamUrl(options, {
@@ -17119,111 +17481,6 @@ var createPlivoVoiceRoutes = (options = {}) => {
     return report;
   });
 };
-// src/telephony/matrix.ts
-import { Elysia as Elysia21 } from "elysia";
-var escapeHtml20 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
-var labelForProvider = (provider) => provider.split("-").map((part) => `${part.slice(0, 1).toUpperCase()}${part.slice(1)}`).join(" ");
-var resolveEntryStatus = (contract, setup, smoke) => {
-  if (!contract.pass || !setup.ready || smoke?.pass === false) {
-    return "fail";
-  }
-  if (contract.issues.some((issue) => issue.severity === "warning") || setup.warnings.length > 0 || smoke?.checks.some((check) => check.status === "warn")) {
-    return "warn";
-  }
-  return "pass";
-};
-var createVoiceTelephonyCarrierMatrix = (options) => {
-  const entries = options.providers.map((provider) => {
-    const contract = provider.contract ?? evaluateVoiceTelephonyContract({
-      options: options.contract,
-      setup: provider.setup,
-      smoke: provider.smoke
-    });
-    const failures = provider.smoke?.checks.filter((check) => check.status === "fail").length ?? 0;
-    const warnings = contract.issues.filter((issue) => issue.severity === "warning").length + (provider.smoke?.checks.filter((check) => check.status === "warn").length ?? 0);
-    const errors = contract.issues.filter((issue) => issue.severity === "error").length;
-    const status = resolveEntryStatus(contract, provider.setup, provider.smoke);
-    return {
-      contract,
-      issues: contract.issues,
-      name: provider.name ?? labelForProvider(provider.setup.provider),
-      provider: provider.setup.provider,
-      ready: provider.setup.ready,
-      setup: provider.setup,
-      smoke: provider.smoke,
-      status,
-      summary: {
-        errors,
-        failures,
-        missing: provider.setup.missing.length,
-        warnings
-      }
-    };
-  });
-  const summary = {
-    contractsPassing: entries.filter((entry) => entry.contract.pass).length,
-    failing: entries.filter((entry) => entry.status === "fail").length,
-    providers: entries.length,
-    ready: entries.filter((entry) => entry.ready).length,
-    smokePassing: entries.filter((entry) => entry.smoke?.pass).length,
-    warnings: entries.reduce((total, entry) => total + entry.summary.warnings, 0)
-  };
-  return {
-    entries,
-    generatedAt: options.generatedAt ?? Date.now(),
-    pass: entries.length > 0 && entries.every((entry) => entry.status !== "fail"),
-    summary
-  };
-};
-var badgeStyles = {
-  fail: "background:#fee2e2;color:#991b1b;border-color:#fecaca;",
-  pass: "background:#dcfce7;color:#166534;border-color:#bbf7d0;",
-  warn: "background:#fef3c7;color:#92400e;border-color:#fde68a;"
-};
-var renderVoiceTelephonyCarrierMatrixHTML = (matrix, options = {}) => `<main style="font-family: ui-sans-serif, system-ui; max-width: 1040px; margin: 40px auto; padding: 0 20px; color: #172033;">
-<p style="letter-spacing: .12em; text-transform: uppercase; color: #52606d;">Carrier matrix</p>
-<h1 style="font-size: 34px; margin: 0 0 8px;">${escapeHtml20(options.title ?? "AbsoluteJS Voice Carrier Matrix")}</h1>
-<p style="color:#52606d; margin: 0 0 24px;">${matrix.summary.ready}/${matrix.summary.providers} ready, ${matrix.summary.contractsPassing}/${matrix.summary.providers} contract passing, ${matrix.summary.smokePassing}/${matrix.summary.providers} smoke passing.</p>
-<section style="display:grid; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); gap: 16px;">
-${matrix.entries.map((entry) => `<article style="border:1px solid #d9e2ec; border-radius:18px; padding:18px; background:#fff; box-shadow:0 18px 48px rgba(15,23,42,.08);">
-<div style="display:flex; justify-content:space-between; gap:12px; align-items:center;">
-<h2 style="margin:0; font-size:20px;">${escapeHtml20(entry.name)}</h2>
-<span style="border:1px solid; border-radius:999px; padding:4px 10px; font-size:12px; font-weight:700; ${badgeStyles[entry.status]}">${escapeHtml20(entry.status.toUpperCase())}</span>
-</div>
-<dl style="display:grid; grid-template-columns: 1fr 1fr; gap:8px 12px; margin:16px 0;">
-<dt style="color:#64748b;">Setup</dt><dd style="margin:0; font-weight:700;">${entry.ready ? "Ready" : "Needs attention"}</dd>
-<dt style="color:#64748b;">Signing</dt><dd style="margin:0; font-weight:700;">${entry.setup.signing.configured ? entry.setup.signing.mode : "missing"}</dd>
-<dt style="color:#64748b;">Smoke</dt><dd style="margin:0; font-weight:700;">${entry.smoke ? entry.smoke.pass ? "Pass" : "Fail" : "Missing"}</dd>
-<dt style="color:#64748b;">Contract</dt><dd style="margin:0; font-weight:700;">${entry.contract.pass ? "Pass" : "Fail"}</dd>
-</dl>
-<p style="margin:0 0 8px; color:#475569;"><strong>Stream:</strong> <code>${escapeHtml20(entry.setup.urls.stream || "missing")}</code></p>
-<p style="margin:0 0 12px; color:#475569;"><strong>Webhook:</strong> <code>${escapeHtml20(entry.setup.urls.webhook || "missing")}</code></p>
-${entry.issues.length ? `<ul style="margin:12px 0 0; padding-left:18px;">${entry.issues.map((issue) => `<li>${escapeHtml20(issue.severity)}: ${escapeHtml20(issue.message)}</li>`).join("")}</ul>` : '<p style="margin:12px 0 0; color:#166534;">No contract issues.</p>'}
-</article>`).join("")}
-</section>
-</main>`;
-var createVoiceTelephonyCarrierMatrixRoutes = (options) => {
-  const path = options.path ?? "/api/voice/telephony/carriers";
-  return new Elysia21({
-    name: options.name ?? "absolutejs-voice-telephony-carrier-matrix"
-  }).get(path, async ({ query, request }) => {
-    const providers = await options.load({ query, request });
-    const matrix = createVoiceTelephonyCarrierMatrix({
-      contract: options.contract,
-      providers
-    });
-    if (query.format === "html") {
-      return new Response(renderVoiceTelephonyCarrierMatrixHTML(matrix, {
-        title: options.title
-      }), {
-        headers: {
-          "content-type": "text/html; charset=utf-8"
-        }
-      });
-    }
-    return matrix;
-  });
-};
 // src/telephony/response.ts
 var normalizeWhitespace = (value) => value.replace(/\s+/g, " ").trim();
 var DEFAULT_MAX_WORDS = 12;
@@ -17345,6 +17602,7 @@ export {
   renderVoiceQualityHTML,
   renderVoiceProviderHealthHTML,
   renderVoiceProviderCapabilityHTML,
+  renderVoiceProductionReadinessHTML,
   renderVoiceOutcomeContractHTML,
   renderVoiceOpsConsoleHTML,
   renderVoiceHandoffHealthHTML,
@@ -17453,6 +17711,7 @@ export {
   createVoiceProviderCapabilityRoutes,
   createVoiceProviderCapabilityJSONHandler,
   createVoiceProviderCapabilityHTMLHandler,
+  createVoiceProductionReadinessRoutes,
   createVoicePostgresTraceSinkDeliveryStore,
   createVoicePostgresTraceEventStore,
   createVoicePostgresTelephonyWebhookIdempotencyStore,
@@ -17556,6 +17815,7 @@ export {
   compareVoiceEvalBaseline,
   claimVoiceOpsTask,
   buildVoiceTraceReplay,
+  buildVoiceProductionReadinessReport,
   buildVoiceOpsTaskFromSLABreach,
   buildVoiceOpsTaskFromReview,
   buildVoiceOpsConsoleReport,

package/dist/productionReadiness.d.ts

@@ -0,0 +1,111 @@
+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;
+    status: VoiceProductionReadinessStatus;
+    value?: number | string;
+};
+export type VoiceProductionReadinessReport = {
+    checkedAt: number;
+    checks: VoiceProductionReadinessCheck[];
+    links: {
+        carriers?: string;
+        handoffs?: string;
+        handoffRetry?: string;
+        quality?: string;
+        resilience?: string;
+        sessions?: string;
+    };
+    status: VoiceProductionReadinessStatus;
+    summary: {
+        carriers?: {
+            failing: number;
+            providers: number;
+            ready: number;
+            status: VoiceProductionReadinessStatus;
+            warnings: number;
+        };
+        handoffs: {
+            failed: number;
+            total: number;
+        };
+        providers: {
+            degraded: number;
+            total: number;
+        };
+        quality: {
+            status: 'fail' | 'pass';
+        };
+        routing: {
+            events: number;
+            sessions: number;
+        };
+        sessions: {
+            failed: number;
+            total: number;
+        };
+    };
+};
+export type VoiceProductionReadinessRoutesOptions = {
+    carriers?: false | readonly VoiceTelephonyCarrierMatrixInput[] | ((input: {
+        query: Record<string, unknown>;
+        request: Request;
+    }) => Promise<readonly VoiceTelephonyCarrierMatrixInput[]> | readonly VoiceTelephonyCarrierMatrixInput[]);
+    headers?: HeadersInit;
+    htmlPath?: false | string;
+    links?: VoiceProductionReadinessReport['links'];
+    llmProviders?: readonly string[];
+    name?: string;
+    path?: string;
+    render?: (report: VoiceProductionReadinessReport) => string | Promise<string>;
+    store: VoiceTraceEventStore;
+    sttProviders?: readonly string[];
+    title?: string;
+    ttsProviders?: readonly string[];
+};
+export declare const buildVoiceProductionReadinessReport: (options: VoiceProductionReadinessRoutesOptions, input?: {
+    query?: Record<string, unknown>;
+    request?: Request;
+}) => Promise<VoiceProductionReadinessReport>;
+export declare const renderVoiceProductionReadinessHTML: (report: VoiceProductionReadinessReport, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceProductionReadinessRoutes: (options: VoiceProductionReadinessRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/package.json

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