@absolutejs/voice 0.0.22-beta.102 → 0.0.22-beta.103

package/dist/index.d.ts

@@ -11,6 +11,7 @@ export { createVoiceAgent, createVoiceAgentSquad, createVoiceAgentTool } from '.
 export { createVoiceToolIdempotencyKey, createVoiceToolRuntime } from './toolRuntime';
 export { createVoiceToolContract, createVoiceToolContractHTMLHandler, createVoiceToolContractJSONHandler, createVoiceToolContractRoutes, createVoiceToolRuntimeContractDefaults, renderVoiceToolContractHTML, runVoiceToolContractSuite, runVoiceToolContract } from './toolContract';
 export { createVoiceTurnLatencyHTMLHandler, createVoiceTurnLatencyJSONHandler, createVoiceTurnLatencyRoutes, renderVoiceTurnLatencyHTML, summarizeVoiceTurnLatency } from './turnLatency';
+export { createVoiceLiveLatencyRoutes, renderVoiceLiveLatencyHTML, summarizeVoiceLiveLatency } from './liveLatency';
 export { createVoiceTurnQualityHTMLHandler, createVoiceTurnQualityJSONHandler, createVoiceTurnQualityRoutes, renderVoiceTurnQualityHTML, summarizeVoiceTurnQuality } from './turnQuality';
 export { createVoiceOutcomeContractHTMLHandler, createVoiceOutcomeContractJSONHandler, createVoiceOutcomeContractRoutes, renderVoiceOutcomeContractHTML, runVoiceOutcomeContractSuite } from './outcomeContract';
 export { applyVoiceTelephonyOutcome, createMemoryVoiceTelephonyWebhookIdempotencyStore, createVoiceTelephonyOutcomePolicy, createVoiceTelephonyWebhookHandler, createVoiceTelephonyWebhookRoutes, parseVoiceTelephonyWebhookEvent, resolveVoiceTelephonyOutcome, signVoiceTwilioWebhook, verifyVoiceTwilioWebhookSignature, voiceTelephonyOutcomeToRouteResult } from './telephonyOutcome';
@@ -63,6 +64,7 @@ export type { OpenAIVoiceTTSOptions, OpenAIVoiceTTSVoice } from './openaiTTS';
 export type { VoiceProviderHealthStatus, VoiceProviderHealthSummary, VoiceProviderHealthSummaryOptions } from './providerHealth';
 export type { VoiceProviderCapabilityDefinition, VoiceProviderCapabilityHandlerOptions, VoiceProviderCapabilityHTMLHandlerOptions, VoiceProviderCapabilityKind, VoiceProviderCapabilityOptions, VoiceProviderCapabilityReport, VoiceProviderCapabilityRoutesOptions, VoiceProviderCapabilitySummary } from './providerCapabilities';
 export type { VoiceTurnLatencyHTMLHandlerOptions, VoiceTurnLatencyItem, VoiceTurnLatencyOptions, VoiceTurnLatencyReport, VoiceTurnLatencyRoutesOptions, VoiceTurnLatencyStage, VoiceTurnLatencyStatus } from './turnLatency';
+export type { VoiceLiveLatencyOptions, VoiceLiveLatencyReport, VoiceLiveLatencyRoutesOptions, VoiceLiveLatencySample, VoiceLiveLatencyStatus } from './liveLatency';
 export type { VoiceTurnQualityHTMLHandlerOptions, VoiceTurnQualityItem, VoiceTurnQualityOptions, VoiceTurnQualityReport, VoiceTurnQualityRoutesOptions, VoiceTurnQualityStatus } from './turnQuality';
 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';

package/dist/index.js

@@ -11407,10 +11407,82 @@ var createVoiceTurnLatencyRoutes = (options) => {
   }
   return routes;
 };
-// src/turnQuality.ts
+// src/liveLatency.ts
 import { Elysia as Elysia19 } from "elysia";
-var DEFAULT_CONFIDENCE_WARN_THRESHOLD = 0.72;
 var escapeHtml20 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var percentile = (values, percentileValue) => {
+  if (values.length === 0) {
+    return;
+  }
+  const sorted = [...values].sort((left, right) => left - right);
+  const index = Math.min(sorted.length - 1, Math.max(0, Math.ceil(percentileValue / 100 * sorted.length) - 1));
+  return Math.round(sorted[index] ?? 0);
+};
+var getLatency = (payload) => typeof payload.latencyMs === "number" ? payload.latencyMs : typeof payload.elapsedMs === "number" ? payload.elapsedMs : undefined;
+var summarizeVoiceLiveLatency = async (options) => {
+  const warnAfterMs = options.warnAfterMs ?? 1800;
+  const failAfterMs = options.failAfterMs ?? 3200;
+  const events = await options.store.list({
+    limit: options.limit ?? 100,
+    type: "client.live_latency"
+  });
+  const recent = events.map((event) => {
+    const latencyMs = getLatency(event.payload);
+    if (latencyMs === undefined) {
+      return;
+    }
+    return {
+      at: event.at,
+      latencyMs,
+      sessionId: event.sessionId,
+      status: typeof event.payload.status === "string" ? event.payload.status : undefined,
+      traceId: event.traceId
+    };
+  }).filter((sample) => Boolean(sample)).sort((left, right) => right.at - left.at);
+  const latencies = recent.map((sample) => sample.latencyMs);
+  const failed = latencies.filter((value) => value > failAfterMs).length;
+  const warnings = latencies.filter((value) => value > warnAfterMs && value <= failAfterMs).length;
+  return {
+    averageLatencyMs: latencies.length > 0 ? Math.round(latencies.reduce((total, value) => total + value, 0) / latencies.length) : undefined,
+    checkedAt: Date.now(),
+    failed,
+    p50LatencyMs: percentile(latencies, 50),
+    p95LatencyMs: percentile(latencies, 95),
+    recent,
+    status: latencies.length === 0 ? "empty" : failed > 0 ? "fail" : warnings > 0 ? "warn" : "pass",
+    total: latencies.length,
+    warnings
+  };
+};
+var formatMs3 = (value) => typeof value === "number" ? `${Math.round(value)}ms` : "n/a";
+var renderVoiceLiveLatencyHTML = (report, options = {}) => {
+  const title = options.title ?? "Voice Live Latency";
+  const rows = report.recent.map((sample) => `<tr><td>${escapeHtml20(sample.sessionId)}</td><td>${escapeHtml20(formatMs3(sample.latencyMs))}</td><td>${escapeHtml20(sample.status ?? "unknown")}</td><td>${escapeHtml20(new Date(sample.at).toLocaleString())}</td></tr>`).join("");
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml20(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(94,234,212,.16),rgba(245,158,11,.1));border:1px solid #26313d;border-radius:28px;margin-bottom:18px;padding:28px}.eyebrow{color:#5eead4;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{border:1px solid #3f3f46;border-radius:999px;display:inline-flex;padding:8px 12px}.pass{color:#86efac}.warn,.empty{color:#fbbf24}.fail{color:#fca5a5}.metrics{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(160px,1fr));margin:18px 0}.metrics article,table{background:#141922;border:1px solid #26313d;border-radius:18px}.metrics article{padding:16px}.metrics span{color:#a8b0b8}.metrics strong{display:block;font-size:2rem;margin-top:.25rem}table{border-collapse:collapse;overflow:hidden;width:100%}td,th{border-bottom:1px solid #26313d;padding:12px;text-align:left}@media(max-width:760px){main{padding:20px}}</style></head><body><main><section class="hero"><p class="eyebrow">Browser proof</p><h1>${escapeHtml20(title)}</h1><p>Recent real browser speech-to-assistant response measurements from persisted <code>client.live_latency</code> traces.</p><p class="status ${escapeHtml20(report.status)}">Status: ${escapeHtml20(report.status)}</p><section class="metrics"><article><span>p50</span><strong>${escapeHtml20(formatMs3(report.p50LatencyMs))}</strong></article><article><span>p95</span><strong>${escapeHtml20(formatMs3(report.p95LatencyMs))}</strong></article><article><span>Average</span><strong>${escapeHtml20(formatMs3(report.averageLatencyMs))}</strong></article><article><span>Samples</span><strong>${String(report.total)}</strong></article></section></section><table><thead><tr><th>Session</th><th>Latency</th><th>Status</th><th>Measured</th></tr></thead><tbody>${rows || '<tr><td colspan="4">No live latency samples yet.</td></tr>'}</tbody></table></main></body></html>`;
+};
+var createVoiceLiveLatencyRoutes = (options) => {
+  const path = options.path ?? "/api/live-latency";
+  const htmlPath = options.htmlPath === undefined ? "/live-latency" : options.htmlPath;
+  const routes = new Elysia19({
+    name: options.name ?? "absolutejs-voice-live-latency"
+  }).get(path, () => summarizeVoiceLiveLatency(options));
+  if (htmlPath) {
+    routes.get(htmlPath, async () => {
+      const report = await summarizeVoiceLiveLatency(options);
+      return new Response(renderVoiceLiveLatencyHTML(report, options), {
+        headers: {
+          "content-type": "text/html; charset=utf-8",
+          ...options.headers
+        }
+      });
+    });
+  }
+  return routes;
+};
+// src/turnQuality.ts
+import { Elysia as Elysia20 } from "elysia";
+var DEFAULT_CONFIDENCE_WARN_THRESHOLD = 0.72;
+var escapeHtml21 = (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) {
@@ -11481,24 +11553,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 ${escapeHtml20(turn.status)}">
+  const turns = report.turns.map((turn) => `<article class="turn ${escapeHtml21(turn.status)}">
   <div class="turn-header">
     <div>
-      <p class="eyebrow">${escapeHtml20(turn.sessionId)} \xB7 ${escapeHtml20(turn.turnId)}</p>
-      <h2>${escapeHtml20(turn.text || "Empty turn")}</h2>
+      <p class="eyebrow">${escapeHtml21(turn.sessionId)} \xB7 ${escapeHtml21(turn.turnId)}</p>
+      <h2>${escapeHtml21(turn.text || "Empty turn")}</h2>
     </div>
-    <strong>${escapeHtml20(turn.status)}</strong>
+    <strong>${escapeHtml21(turn.status)}</strong>
   </div>
   <dl>
-    <div><dt>Source</dt><dd>${escapeHtml20(turn.source ?? "unknown")}</dd></div>
+    <div><dt>Source</dt><dd>${escapeHtml21(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 (${escapeHtml20(turn.fallbackSelectionReason ?? "selected")})` : "no"}</dd></div>
-    <div><dt>Correction</dt><dd>${turn.correctionChanged ? `changed${turn.correctionProvider ? ` by ${escapeHtml20(turn.correctionProvider)}` : ""}` : "none"}</dd></div>
+    <div><dt>Fallback</dt><dd>${turn.fallbackUsed ? `yes (${escapeHtml21(turn.fallbackSelectionReason ?? "selected")})` : "no"}</dd></div>
+    <div><dt>Correction</dt><dd>${turn.correctionChanged ? `changed${turn.correctionProvider ? ` by ${escapeHtml21(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>${escapeHtml20(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>${escapeHtml20(title)}</h1><div class="summary"><span class="pill ${escapeHtml20(report.status)}">${escapeHtml20(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>${escapeHtml21(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>${escapeHtml21(title)}</h1><div class="summary"><span class="pill ${escapeHtml21(report.status)}">${escapeHtml21(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 () => {
@@ -11515,7 +11587,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 Elysia19({
+  const routes = new Elysia20({
     name: options.name ?? "absolutejs-voice-turn-quality"
   }).get(path, createVoiceTurnQualityJSONHandler(options));
   if (htmlPath) {
@@ -11524,8 +11596,8 @@ var createVoiceTurnQualityRoutes = (options) => {
   return routes;
 };
 // src/outcomeContract.ts
-import { Elysia as Elysia20 } from "elysia";
-var escapeHtml21 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+import { Elysia as Elysia21 } from "elysia";
+var escapeHtml22 = (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) => {
@@ -11633,9 +11705,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">${escapeHtml21(contract.contractId)}</p>
-      <h2>${escapeHtml21(contract.label ?? contract.contractId)}</h2>
-      ${contract.description ? `<p>${escapeHtml21(contract.description)}</p>` : ""}
+      <p class="eyebrow">${escapeHtml22(contract.contractId)}</p>
+      <h2>${escapeHtml22(contract.label ?? contract.contractId)}</h2>
+      ${contract.description ? `<p>${escapeHtml22(contract.description)}</p>` : ""}
     </div>
     <strong>${contract.pass ? "pass" : "fail"}</strong>
   </div>
@@ -11646,9 +11718,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>${escapeHtml21(issue.message)}</li>`).join("")}</ul>` : ""}
+  ${contract.issues.length ? `<ul>${contract.issues.map((issue) => `<li>${escapeHtml22(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>${escapeHtml21(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>${escapeHtml21(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>${escapeHtml22(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>${escapeHtml22(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 () => {
@@ -11664,7 +11736,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 Elysia20({
+  const routes = new Elysia21({
     name: options.name ?? "absolutejs-voice-outcome-contracts"
   }).get(path, createVoiceOutcomeContractJSONHandler(options));
   if (htmlPath) {
@@ -11673,7 +11745,7 @@ var createVoiceOutcomeContractRoutes = (options) => {
   return routes;
 };
 // src/telephonyOutcome.ts
-import { Elysia as Elysia21 } from "elysia";
+import { Elysia as Elysia22 } from "elysia";
 var DEFAULT_COMPLETED_STATUSES = [
   "answered",
   "completed",
@@ -12320,7 +12392,7 @@ var createVoiceTelephonyWebhookHandler = (options = {}) => async (input) => {
 var createVoiceTelephonyWebhookRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice/telephony/webhook";
   const handler = createVoiceTelephonyWebhookHandler(options);
-  return new Elysia21({
+  return new Elysia22({
     name: options.name ?? "absolutejs-voice-telephony-webhooks"
   }).post(path, async ({ query, request }) => {
     try {
@@ -14588,7 +14660,7 @@ var createVoiceMemoryStore = () => {
   return { get, getOrCreate, list, remove, set };
 };
 // src/opsWebhook.ts
-import { Elysia as Elysia22 } from "elysia";
+import { Elysia as Elysia23 } from "elysia";
 var toHex5 = (bytes) => Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
 var signVoiceOpsWebhookBody = async (input) => {
   const encoder = new TextEncoder;
@@ -14718,7 +14790,7 @@ var verifyVoiceOpsWebhookSignature = async (input) => {
 };
 var createVoiceOpsWebhookReceiverRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice-ops/webhook";
-  return new Elysia22().post(path, async ({ body, request, set }) => {
+  return new Elysia23().post(path, async ({ body, request, set }) => {
     const bodyText = typeof body === "string" ? body : JSON.stringify(body);
     if (options.signingSecret) {
       const verification = await verifyVoiceOpsWebhookSignature({
@@ -16447,7 +16519,7 @@ var createVoiceSTTRoutingCorrectionHandler = (mode = "generic") => {
 };
 // src/telephony/twilio.ts
 import { Buffer as Buffer3 } from "buffer";
-import { Elysia as Elysia23 } from "elysia";
+import { Elysia as Elysia24 } 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;");
@@ -16477,7 +16549,7 @@ var resolveTwilioStreamParameters = async (parameters, input) => {
   return parameters;
 };
 var joinUrlPath = (origin, path) => `${origin.replace(/\/$/, "")}${path.startsWith("/") ? path : `/${path}`}`;
-var escapeHtml22 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+var escapeHtml23 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
 var getWebhookVerificationUrl = (webhook, input) => {
   if (!webhook?.verificationUrl) {
     return;
@@ -16520,23 +16592,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>${escapeHtml22(title)}</h1>
+<h1>${escapeHtml23(title)}</h1>
 <p><strong>Status:</strong> ${status.ready ? "Ready" : "Needs attention"}</p>
 <section>
 <h2>URLs</h2>
 <ul>
-<li><strong>TwiML:</strong> <code>${escapeHtml22(status.urls.twiml)}</code></li>
-<li><strong>Media stream:</strong> <code>${escapeHtml22(status.urls.stream)}</code></li>
-<li><strong>Status webhook:</strong> <code>${escapeHtml22(status.urls.webhook)}</code></li>
+<li><strong>TwiML:</strong> <code>${escapeHtml23(status.urls.twiml)}</code></li>
+<li><strong>Media stream:</strong> <code>${escapeHtml23(status.urls.stream)}</code></li>
+<li><strong>Status webhook:</strong> <code>${escapeHtml23(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>${escapeHtml22(status.signing.verificationUrl)}</code></p>` : ""}
+${status.signing.verificationUrl ? `<p>Verification URL: <code>${escapeHtml23(status.signing.verificationUrl)}</code></p>` : ""}
 </section>
-${status.missing.length ? `<section><h2>Missing env</h2><ul>${status.missing.map((name) => `<li><code>${escapeHtml22(name)}</code></li>`).join("")}</ul></section>` : ""}
-${status.warnings.length ? `<section><h2>Warnings</h2><ul>${status.warnings.map((warning) => `<li>${escapeHtml22(warning)}</li>`).join("")}</ul></section>` : ""}
+${status.missing.length ? `<section><h2>Missing env</h2><ul>${status.missing.map((name) => `<li><code>${escapeHtml23(name)}</code></li>`).join("")}</ul></section>` : ""}
+${status.warnings.length ? `<section><h2>Warnings</h2><ul>${status.warnings.map((warning) => `<li>${escapeHtml23(warning)}</li>`).join("")}</ul></section>` : ""}
 </main>`;
 var extractTwilioStreamUrl = (twiml) => twiml.match(/<Stream\b[^>]*\surl="([^"]+)"/i)?.[1]?.replaceAll("&amp;", "&");
 var createSmokeCheck = (name, status, message, details) => ({
@@ -16547,20 +16619,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>${escapeHtml22(title)}</h1>
+<h1>${escapeHtml23(title)}</h1>
 <p><strong>Status:</strong> ${report.pass ? "Pass" : "Fail"}</p>
 <section>
 <h2>Checks</h2>
 <ul>
-${report.checks.map((check) => `<li><strong>${escapeHtml22(check.name)}</strong>: ${escapeHtml22(check.status)}${check.message ? ` - ${escapeHtml22(check.message)}` : ""}</li>`).join("")}
+${report.checks.map((check) => `<li><strong>${escapeHtml23(check.name)}</strong>: ${escapeHtml23(check.status)}${check.message ? ` - ${escapeHtml23(check.message)}` : ""}</li>`).join("")}
 </ul>
 </section>
 <section>
 <h2>Observed URLs</h2>
 <ul>
-<li><strong>TwiML:</strong> <code>${escapeHtml22(report.setup.urls.twiml)}</code></li>
-<li><strong>Stream:</strong> <code>${escapeHtml22(report.twiml?.streamUrl ?? report.setup.urls.stream)}</code></li>
-<li><strong>Webhook:</strong> <code>${escapeHtml22(report.setup.urls.webhook)}</code></li>
+<li><strong>TwiML:</strong> <code>${escapeHtml23(report.setup.urls.twiml)}</code></li>
+<li><strong>Stream:</strong> <code>${escapeHtml23(report.twiml?.streamUrl ?? report.setup.urls.stream)}</code></li>
+<li><strong>Webhook:</strong> <code>${escapeHtml23(report.setup.urls.webhook)}</code></li>
 </ul>
 </section>
 </main>`;
@@ -17020,7 +17092,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 Elysia23({
+  const app = new Elysia24({
     name: options.name ?? "absolutejs-voice-twilio"
   }).get(twimlPath, async ({ query, request }) => {
     const streamUrl = await resolveTwilioStreamUrl(options, {
@@ -17156,9 +17228,9 @@ var createTwilioVoiceRoutes = (options) => {
 };
 // src/telephony/telnyx.ts
 import { Buffer as Buffer4 } from "buffer";
-import { Elysia as Elysia24 } from "elysia";
+import { Elysia as Elysia25 } from "elysia";
 var escapeXml3 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&apos;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
-var escapeHtml23 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+var escapeHtml24 = (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);
@@ -17359,21 +17431,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>${escapeHtml23(title)}</h1>
+<h1>${escapeHtml24(title)}</h1>
 <p><strong>Status:</strong> ${status.ready ? "Ready" : "Needs attention"}</p>
 <ul>
-<li><strong>TeXML:</strong> <code>${escapeHtml23(status.urls.texml)}</code></li>
-<li><strong>Media stream:</strong> <code>${escapeHtml23(status.urls.stream)}</code></li>
-<li><strong>Status webhook:</strong> <code>${escapeHtml23(status.urls.webhook)}</code></li>
+<li><strong>TeXML:</strong> <code>${escapeHtml24(status.urls.texml)}</code></li>
+<li><strong>Media stream:</strong> <code>${escapeHtml24(status.urls.stream)}</code></li>
+<li><strong>Status webhook:</strong> <code>${escapeHtml24(status.urls.webhook)}</code></li>
 </ul>
-${status.missing.length ? `<h2>Missing env</h2><ul>${status.missing.map((name) => `<li><code>${escapeHtml23(name)}</code></li>`).join("")}</ul>` : ""}
-${status.warnings.length ? `<h2>Warnings</h2><ul>${status.warnings.map((warning) => `<li>${escapeHtml23(warning)}</li>`).join("")}</ul>` : ""}
+${status.missing.length ? `<h2>Missing env</h2><ul>${status.missing.map((name) => `<li><code>${escapeHtml24(name)}</code></li>`).join("")}</ul>` : ""}
+${status.warnings.length ? `<h2>Warnings</h2><ul>${status.warnings.map((warning) => `<li>${escapeHtml24(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>${escapeHtml23(title)}</h1>
+<h1>${escapeHtml24(title)}</h1>
 <p><strong>Status:</strong> ${report.pass ? "Pass" : "Fail"}</p>
-<ul>${report.checks.map((check) => `<li><strong>${escapeHtml23(check.name)}</strong>: ${escapeHtml23(check.status)}${check.message ? ` - ${escapeHtml23(check.message)}` : ""}</li>`).join("")}</ul>
+<ul>${report.checks.map((check) => `<li><strong>${escapeHtml24(check.name)}</strong>: ${escapeHtml24(check.status)}${check.message ? ` - ${escapeHtml24(check.message)}` : ""}</li>`).join("")}</ul>
 </main>`;
 var runTelnyxSmokeTest = async (input) => {
   const setup = await buildTelnyxVoiceSetupStatus(input.options, input);
@@ -17467,7 +17539,7 @@ var createTelnyxVoiceRoutes = (options = {}) => {
     publicKey: options.webhook?.publicKey,
     toleranceSeconds: options.webhook?.toleranceSeconds
   }) : undefined);
-  const app = new Elysia24({
+  const app = new Elysia25({
     name: options.name ?? "absolutejs-voice-telnyx"
   }).get(texmlPath, async ({ query, request }) => {
     const streamUrl = await resolveTelnyxStreamUrl(options, {
@@ -17577,9 +17649,9 @@ var createTelnyxVoiceRoutes = (options = {}) => {
 };
 // src/telephony/plivo.ts
 import { Buffer as Buffer5 } from "buffer";
-import { Elysia as Elysia25 } from "elysia";
+import { Elysia as Elysia26 } from "elysia";
 var escapeXml4 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&apos;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
-var escapeHtml24 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+var escapeHtml25 = (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);
@@ -17830,21 +17902,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>${escapeHtml24(title)}</h1>
+<h1>${escapeHtml25(title)}</h1>
 <p><strong>Status:</strong> ${status.ready ? "Ready" : "Needs attention"}</p>
 <ul>
-<li><strong>Answer XML:</strong> <code>${escapeHtml24(status.urls.answer)}</code></li>
-<li><strong>Audio stream:</strong> <code>${escapeHtml24(status.urls.stream)}</code></li>
-<li><strong>Status webhook:</strong> <code>${escapeHtml24(status.urls.webhook)}</code></li>
+<li><strong>Answer XML:</strong> <code>${escapeHtml25(status.urls.answer)}</code></li>
+<li><strong>Audio stream:</strong> <code>${escapeHtml25(status.urls.stream)}</code></li>
+<li><strong>Status webhook:</strong> <code>${escapeHtml25(status.urls.webhook)}</code></li>
 </ul>
-${status.missing.length ? `<h2>Missing env</h2><ul>${status.missing.map((name) => `<li><code>${escapeHtml24(name)}</code></li>`).join("")}</ul>` : ""}
-${status.warnings.length ? `<h2>Warnings</h2><ul>${status.warnings.map((warning) => `<li>${escapeHtml24(warning)}</li>`).join("")}</ul>` : ""}
+${status.missing.length ? `<h2>Missing env</h2><ul>${status.missing.map((name) => `<li><code>${escapeHtml25(name)}</code></li>`).join("")}</ul>` : ""}
+${status.warnings.length ? `<h2>Warnings</h2><ul>${status.warnings.map((warning) => `<li>${escapeHtml25(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>${escapeHtml24(title)}</h1>
+<h1>${escapeHtml25(title)}</h1>
 <p><strong>Status:</strong> ${report.pass ? "Pass" : "Fail"}</p>
-<ul>${report.checks.map((check) => `<li><strong>${escapeHtml24(check.name)}</strong>: ${escapeHtml24(check.status)}${check.message ? ` - ${escapeHtml24(check.message)}` : ""}</li>`).join("")}</ul>
+<ul>${report.checks.map((check) => `<li><strong>${escapeHtml25(check.name)}</strong>: ${escapeHtml25(check.status)}${check.message ? ` - ${escapeHtml25(check.message)}` : ""}</li>`).join("")}</ul>
 </main>`;
 var runPlivoSmokeTest = async (input) => {
   const setup = await buildPlivoVoiceSetupStatus(input.options, input);
@@ -17939,7 +18011,7 @@ var createPlivoVoiceRoutes = (options = {}) => {
       request: input.request
     }) : verificationUrl ?? input.request.url
   }) : undefined);
-  const app = new Elysia25({
+  const app = new Elysia26({
     name: options.name ?? "absolutejs-voice-plivo"
   }).get(answerPath, async ({ query, request }) => {
     const streamUrl = await resolvePlivoStreamUrl(options, {
@@ -18125,6 +18197,7 @@ export {
   summarizeVoiceOpsTasks,
   summarizeVoiceOpsTaskQueue,
   summarizeVoiceOpsTaskAnalytics,
+  summarizeVoiceLiveLatency,
   summarizeVoiceIntegrationEvents,
   summarizeVoiceHandoffHealth,
   summarizeVoiceHandoffDeliveries,
@@ -18177,6 +18250,7 @@ export {
   renderVoiceProductionReadinessHTML,
   renderVoiceOutcomeContractHTML,
   renderVoiceOpsConsoleHTML,
+  renderVoiceLiveLatencyHTML,
   renderVoiceHandoffHealthHTML,
   renderVoiceEvalHTML,
   renderVoiceEvalBaselineHTML,
@@ -18314,6 +18388,7 @@ export {
   createVoiceMemoryStore,
   createVoiceMemoryHandoffDeliveryStore,
   createVoiceMemoryAssistantMemoryStore,
+  createVoiceLiveLatencyRoutes,
   createVoiceLinearIssueUpdateSink,
   createVoiceLinearIssueSyncSinks,
   createVoiceLinearIssueSink,

package/dist/liveLatency.d.ts

@@ -0,0 +1,78 @@
+import { Elysia } from 'elysia';
+import type { VoiceTraceEventStore } from './trace';
+export type VoiceLiveLatencyStatus = 'empty' | 'fail' | 'pass' | 'warn';
+export type VoiceLiveLatencySample = {
+    at: number;
+    latencyMs: number;
+    sessionId: string;
+    status?: string;
+    traceId?: string;
+};
+export type VoiceLiveLatencyReport = {
+    averageLatencyMs?: number;
+    checkedAt: number;
+    failed: number;
+    p50LatencyMs?: number;
+    p95LatencyMs?: number;
+    recent: VoiceLiveLatencySample[];
+    status: VoiceLiveLatencyStatus;
+    total: number;
+    warnings: number;
+};
+export type VoiceLiveLatencyOptions = {
+    failAfterMs?: number;
+    limit?: number;
+    store: VoiceTraceEventStore;
+    warnAfterMs?: number;
+};
+export type VoiceLiveLatencyRoutesOptions = VoiceLiveLatencyOptions & {
+    headers?: HeadersInit;
+    htmlPath?: false | string;
+    name?: string;
+    path?: string;
+    title?: string;
+};
+export declare const summarizeVoiceLiveLatency: (options: VoiceLiveLatencyOptions) => Promise<VoiceLiveLatencyReport>;
+export declare const renderVoiceLiveLatencyHTML: (report: VoiceLiveLatencyReport, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceLiveLatencyRoutes: (options: VoiceLiveLatencyRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    [x: string]: {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: VoiceLiveLatencyReport;
+            };
+        };
+    };
+}, {
+    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.102",
+	"version": "0.0.22-beta.103",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",