@absolutejs/voice 0.0.22-beta.94 → 0.0.22-beta.95

package/dist/index.js

@@ -11168,10 +11168,113 @@ var createVoiceToolContractRoutes = (options) => {
   }
   return routes;
 };
-// src/turnQuality.ts
+// src/turnLatency.ts
 import { Elysia as Elysia18 } from "elysia";
-var DEFAULT_CONFIDENCE_WARN_THRESHOLD = 0.72;
+var DEFAULT_WARN_AFTER_MS = 1800;
+var DEFAULT_FAIL_AFTER_MS = 3200;
 var escapeHtml19 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var firstNumber2 = (values) => values.filter((value) => typeof value === "number").sort((left, right) => left - right)[0];
+var summarizeTurn = (sessionId, turn, options) => {
+  const firstTranscriptAt = firstNumber2(turn.transcripts.map((transcript) => transcript.endedAtMs ?? transcript.startedAtMs));
+  const finalTranscriptAt = firstNumber2(turn.transcripts.filter((transcript) => transcript.isFinal).map((transcript) => transcript.endedAtMs ?? transcript.startedAtMs));
+  const commitAfterFirstMs = firstTranscriptAt === undefined ? undefined : Math.max(0, turn.committedAt - firstTranscriptAt);
+  const commitAfterFinalMs = finalTranscriptAt === undefined ? undefined : Math.max(0, turn.committedAt - finalTranscriptAt);
+  const assistantTextStartedAt = turn.assistantText ? turn.committedAt : undefined;
+  const totalMs = commitAfterFirstMs;
+  const status = totalMs === undefined ? "warn" : totalMs > options.failAfterMs ? "fail" : totalMs > options.warnAfterMs ? "warn" : "pass";
+  return {
+    assistantTextStartedAt,
+    committedAt: turn.committedAt,
+    finalTranscriptAt,
+    firstTranscriptAt,
+    sessionId,
+    stages: [
+      { label: "Speech to commit", valueMs: commitAfterFirstMs },
+      { label: "Final transcript to commit", valueMs: commitAfterFinalMs },
+      {
+        label: "Commit to assistant text",
+        valueMs: assistantTextStartedAt === undefined ? undefined : 0
+      }
+    ],
+    status,
+    text: turn.text,
+    totalMs,
+    turnId: turn.id
+  };
+};
+var resolveSessions = async (options) => {
+  if (options.sessions) {
+    return options.sessions;
+  }
+  if (!options.store) {
+    return [];
+  }
+  const summaries = await options.store.list();
+  const ids = options.sessionIds ?? summaries.map((summary) => summary.id);
+  const hydrated = await Promise.all(ids.slice(0, options.limit ?? 25).map((id) => options.store?.get(id)));
+  const sessions = [];
+  for (const session of hydrated) {
+    if (session) {
+      sessions.push(session);
+    }
+  }
+  return sessions;
+};
+var summarizeVoiceTurnLatency = async (options) => {
+  const sessions = await resolveSessions(options);
+  const warnAfterMs = options.warnAfterMs ?? DEFAULT_WARN_AFTER_MS;
+  const failAfterMs = options.failAfterMs ?? DEFAULT_FAIL_AFTER_MS;
+  const turns = sessions.flatMap((session) => session.turns.map((turn) => summarizeTurn(session.id, turn, { failAfterMs, warnAfterMs }))).sort((left, right) => right.committedAt - left.committedAt);
+  const totals = turns.map((turn) => turn.totalMs).filter((value) => typeof value === "number");
+  const failed = turns.filter((turn) => turn.status === "fail").length;
+  const warnings = turns.filter((turn) => turn.status === "warn").length;
+  return {
+    averageTotalMs: totals.length > 0 ? Math.round(totals.reduce((total, value) => total + value, 0) / totals.length) : undefined,
+    checkedAt: Date.now(),
+    failed,
+    sessions: sessions.length,
+    status: turns.length === 0 ? "empty" : failed > 0 ? "fail" : warnings > 0 ? "warn" : "pass",
+    total: turns.length,
+    turns,
+    warnings
+  };
+};
+var formatMs2 = (value) => typeof value === "number" ? `${Math.round(value)}ms` : "n/a";
+var renderVoiceTurnLatencyHTML = (report, options = {}) => {
+  const title = options.title ?? "Voice Turn Latency";
+  const turns = report.turns.map((turn) => `<article class="turn ${escapeHtml19(turn.status)}">
+  <header><div><p class="eyebrow">${escapeHtml19(turn.sessionId)} \xB7 ${escapeHtml19(turn.turnId)}</p><h2>${escapeHtml19(turn.text || "Empty turn")}</h2></div><strong>${escapeHtml19(turn.status)}</strong></header>
+  <dl>${turn.stages.map((stage) => `<div><dt>${escapeHtml19(stage.label)}</dt><dd>${escapeHtml19(formatMs2(stage.valueMs))}</dd></div>`).join("")}</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>${escapeHtml19(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(94,234,212,.16),rgba(251,191,36,.1))}.eyebrow{color:#5eead4;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,.empty{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{font-weight:900;margin:0}@media(max-width:800px){main{padding:18px}.turn header{display:block}}</style></head><body><main><section class="hero"><p class="eyebrow">End-to-end responsiveness</p><h1>${escapeHtml19(title)}</h1><div class="summary"><span class="pill ${escapeHtml19(report.status)}">${escapeHtml19(report.status)}</span><span class="pill">${String(report.total)} turns</span><span class="pill">avg ${escapeHtml19(formatMs2(report.averageTotalMs))}</span><span class="pill">${String(report.warnings)} warnings</span><span class="pill">${String(report.failed)} failed</span></div></section>${turns || '<section class="turn"><p>No committed turns found.</p></section>'}</main></body></html>`;
+};
+var createVoiceTurnLatencyJSONHandler = (options) => async () => summarizeVoiceTurnLatency(options);
+var createVoiceTurnLatencyHTMLHandler = (options) => async () => {
+  const report = await summarizeVoiceTurnLatency(options);
+  const render = options.render ?? ((input) => renderVoiceTurnLatencyHTML(input, options));
+  const body = await render(report);
+  return new Response(body, {
+    headers: {
+      "Content-Type": "text/html; charset=utf-8",
+      ...options.headers
+    }
+  });
+};
+var createVoiceTurnLatencyRoutes = (options) => {
+  const path = options.path ?? "/api/turn-latency";
+  const htmlPath = options.htmlPath === undefined ? `${path}/htmx` : options.htmlPath;
+  const routes = new Elysia18({
+    name: options.name ?? "absolutejs-voice-turn-latency"
+  }).get(path, createVoiceTurnLatencyJSONHandler(options));
+  if (htmlPath) {
+    routes.get(htmlPath, createVoiceTurnLatencyHTMLHandler(options));
+  }
+  return routes;
+};
+// src/turnQuality.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 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) {
@@ -11179,7 +11282,7 @@ var getTurnLatencyMs = (turn) => {
   }
   return Math.max(0, turn.committedAt - firstTranscriptAt);
 };
-var summarizeTurn = (sessionId, turn, options) => {
+var summarizeTurn2 = (sessionId, turn, options) => {
   const quality = turn.quality;
   const correctionChanged = quality?.correction?.changed === true;
   const fallbackUsed = quality?.fallbackUsed === true;
@@ -11206,7 +11309,7 @@ var summarizeTurn = (sessionId, turn, options) => {
     turnId: turn.id
   };
 };
-var resolveSessions = async (options) => {
+var resolveSessions2 = async (options) => {
   if (options.sessions) {
     return options.sessions;
   }
@@ -11225,9 +11328,9 @@ var resolveSessions = async (options) => {
   return sessions;
 };
 var summarizeVoiceTurnQuality = async (options) => {
-  const sessions = await resolveSessions(options);
+  const sessions = await resolveSessions2(options);
   const confidenceWarnThreshold = options.confidenceWarnThreshold ?? DEFAULT_CONFIDENCE_WARN_THRESHOLD;
-  const turns = sessions.flatMap((session) => session.turns.map((turn) => summarizeTurn(session.id, turn, { confidenceWarnThreshold }))).sort((left, right) => right.committedAt - left.committedAt);
+  const turns = sessions.flatMap((session) => session.turns.map((turn) => summarizeTurn2(session.id, turn, { confidenceWarnThreshold }))).sort((left, right) => right.committedAt - left.committedAt);
   const failed = turns.filter((turn) => turn.status === "fail").length;
   const warnings = turns.filter((turn) => turn.status === "warn").length;
   return {
@@ -11242,24 +11345,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 ${escapeHtml19(turn.status)}">
+  const turns = report.turns.map((turn) => `<article class="turn ${escapeHtml20(turn.status)}">
   <div class="turn-header">
     <div>
-      <p class="eyebrow">${escapeHtml19(turn.sessionId)} \xB7 ${escapeHtml19(turn.turnId)}</p>
-      <h2>${escapeHtml19(turn.text || "Empty turn")}</h2>
+      <p class="eyebrow">${escapeHtml20(turn.sessionId)} \xB7 ${escapeHtml20(turn.turnId)}</p>
+      <h2>${escapeHtml20(turn.text || "Empty turn")}</h2>
     </div>
-    <strong>${escapeHtml19(turn.status)}</strong>
+    <strong>${escapeHtml20(turn.status)}</strong>
   </div>
   <dl>
-    <div><dt>Source</dt><dd>${escapeHtml19(turn.source ?? "unknown")}</dd></div>
+    <div><dt>Source</dt><dd>${escapeHtml20(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 (${escapeHtml19(turn.fallbackSelectionReason ?? "selected")})` : "no"}</dd></div>
-    <div><dt>Correction</dt><dd>${turn.correctionChanged ? `changed${turn.correctionProvider ? ` by ${escapeHtml19(turn.correctionProvider)}` : ""}` : "none"}</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>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>${escapeHtml19(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>${escapeHtml19(title)}</h1><div class="summary"><span class="pill ${escapeHtml19(report.status)}">${escapeHtml19(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>${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>`;
 };
 var createVoiceTurnQualityJSONHandler = (options) => async () => summarizeVoiceTurnQuality(options);
 var createVoiceTurnQualityHTMLHandler = (options) => async () => {
@@ -11276,7 +11379,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 Elysia18({
+  const routes = new Elysia19({
     name: options.name ?? "absolutejs-voice-turn-quality"
   }).get(path, createVoiceTurnQualityJSONHandler(options));
   if (htmlPath) {
@@ -11285,8 +11388,8 @@ var createVoiceTurnQualityRoutes = (options) => {
   return routes;
 };
 // src/outcomeContract.ts
-import { Elysia as Elysia19 } from "elysia";
-var escapeHtml20 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+import { Elysia as Elysia20 } from "elysia";
+var escapeHtml21 = (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) => {
@@ -11394,9 +11497,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">${escapeHtml20(contract.contractId)}</p>
-      <h2>${escapeHtml20(contract.label ?? contract.contractId)}</h2>
-      ${contract.description ? `<p>${escapeHtml20(contract.description)}</p>` : ""}
+      <p class="eyebrow">${escapeHtml21(contract.contractId)}</p>
+      <h2>${escapeHtml21(contract.label ?? contract.contractId)}</h2>
+      ${contract.description ? `<p>${escapeHtml21(contract.description)}</p>` : ""}
     </div>
     <strong>${contract.pass ? "pass" : "fail"}</strong>
   </div>
@@ -11407,9 +11510,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>${escapeHtml20(issue.message)}</li>`).join("")}</ul>` : ""}
+  ${contract.issues.length ? `<ul>${contract.issues.map((issue) => `<li>${escapeHtml21(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>${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,.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>${escapeHtml20(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>${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>`;
 };
 var createVoiceOutcomeContractJSONHandler = (options) => async () => runVoiceOutcomeContractSuite(options);
 var createVoiceOutcomeContractHTMLHandler = (options) => async () => {
@@ -11425,7 +11528,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 Elysia19({
+  const routes = new Elysia20({
     name: options.name ?? "absolutejs-voice-outcome-contracts"
   }).get(path, createVoiceOutcomeContractJSONHandler(options));
   if (htmlPath) {
@@ -11434,7 +11537,7 @@ var createVoiceOutcomeContractRoutes = (options) => {
   return routes;
 };
 // src/telephonyOutcome.ts
-import { Elysia as Elysia20 } from "elysia";
+import { Elysia as Elysia21 } from "elysia";
 var DEFAULT_COMPLETED_STATUSES = [
   "answered",
   "completed",
@@ -11505,7 +11608,7 @@ var firstString2 = (source, keys) => {
     }
   }
 };
-var firstNumber2 = (source, keys) => {
+var firstNumber3 = (source, keys) => {
   for (const key of keys) {
     const value = source[key];
     if (typeof value === "number" && Number.isFinite(value)) {
@@ -11877,7 +11980,7 @@ var parseVoiceTelephonyWebhookEvent = (input) => {
     "event_type",
     "type"
   ]);
-  const durationMs = firstNumber2(payload, ["durationMs", "duration_ms"]) ?? durationMsFromSeconds(firstNumber2(payload, [
+  const durationMs = firstNumber3(payload, ["durationMs", "duration_ms"]) ?? durationMsFromSeconds(firstNumber3(payload, [
     "CallDuration",
     "call_duration",
     "callDuration",
@@ -11885,7 +11988,7 @@ var parseVoiceTelephonyWebhookEvent = (input) => {
     "dial_call_duration",
     "duration"
   ]));
-  const sipCode = firstNumber2(payload, [
+  const sipCode = firstNumber3(payload, [
     "SipResponseCode",
     "sip_response_code",
     "sipCode",
@@ -12081,7 +12184,7 @@ var createVoiceTelephonyWebhookHandler = (options = {}) => async (input) => {
 var createVoiceTelephonyWebhookRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice/telephony/webhook";
   const handler = createVoiceTelephonyWebhookHandler(options);
-  return new Elysia20({
+  return new Elysia21({
     name: options.name ?? "absolutejs-voice-telephony-webhooks"
   }).post(path, async ({ query, request }) => {
     try {
@@ -14349,7 +14452,7 @@ var createVoiceMemoryStore = () => {
   return { get, getOrCreate, list, remove, set };
 };
 // src/opsWebhook.ts
-import { Elysia as Elysia21 } from "elysia";
+import { Elysia as Elysia22 } from "elysia";
 var toHex5 = (bytes) => Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
 var signVoiceOpsWebhookBody = async (input) => {
   const encoder = new TextEncoder;
@@ -14479,7 +14582,7 @@ var verifyVoiceOpsWebhookSignature = async (input) => {
 };
 var createVoiceOpsWebhookReceiverRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice-ops/webhook";
-  return new Elysia21().post(path, async ({ body, request, set }) => {
+  return new Elysia22().post(path, async ({ body, request, set }) => {
     const bodyText = typeof body === "string" ? body : JSON.stringify(body);
     if (options.signingSecret) {
       const verification = await verifyVoiceOpsWebhookSignature({
@@ -16208,7 +16311,7 @@ var createVoiceSTTRoutingCorrectionHandler = (mode = "generic") => {
 };
 // src/telephony/twilio.ts
 import { Buffer as Buffer3 } from "buffer";
-import { Elysia as Elysia22 } from "elysia";
+import { Elysia as Elysia23 } 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;");
@@ -16238,7 +16341,7 @@ var resolveTwilioStreamParameters = async (parameters, input) => {
   return parameters;
 };
 var joinUrlPath = (origin, path) => `${origin.replace(/\/$/, "")}${path.startsWith("/") ? path : `/${path}`}`;
-var escapeHtml21 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+var escapeHtml22 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
 var getWebhookVerificationUrl = (webhook, input) => {
   if (!webhook?.verificationUrl) {
     return;
@@ -16281,23 +16384,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>${escapeHtml21(title)}</h1>
+<h1>${escapeHtml22(title)}</h1>
 <p><strong>Status:</strong> ${status.ready ? "Ready" : "Needs attention"}</p>
 <section>
 <h2>URLs</h2>
 <ul>
-<li><strong>TwiML:</strong> <code>${escapeHtml21(status.urls.twiml)}</code></li>
-<li><strong>Media stream:</strong> <code>${escapeHtml21(status.urls.stream)}</code></li>
-<li><strong>Status webhook:</strong> <code>${escapeHtml21(status.urls.webhook)}</code></li>
+<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>
 </ul>
 </section>
 <section>
 <h2>Signing</h2>
 <p>Mode: <code>${status.signing.mode}</code></p>
-${status.signing.verificationUrl ? `<p>Verification URL: <code>${escapeHtml21(status.signing.verificationUrl)}</code></p>` : ""}
+${status.signing.verificationUrl ? `<p>Verification URL: <code>${escapeHtml22(status.signing.verificationUrl)}</code></p>` : ""}
 </section>
-${status.missing.length ? `<section><h2>Missing env</h2><ul>${status.missing.map((name) => `<li><code>${escapeHtml21(name)}</code></li>`).join("")}</ul></section>` : ""}
-${status.warnings.length ? `<section><h2>Warnings</h2><ul>${status.warnings.map((warning) => `<li>${escapeHtml21(warning)}</li>`).join("")}</ul></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>` : ""}
 </main>`;
 var extractTwilioStreamUrl = (twiml) => twiml.match(/<Stream\b[^>]*\surl="([^"]+)"/i)?.[1]?.replaceAll("&amp;", "&");
 var createSmokeCheck = (name, status, message, details) => ({
@@ -16308,20 +16411,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>${escapeHtml21(title)}</h1>
+<h1>${escapeHtml22(title)}</h1>
 <p><strong>Status:</strong> ${report.pass ? "Pass" : "Fail"}</p>
 <section>
 <h2>Checks</h2>
 <ul>
-${report.checks.map((check) => `<li><strong>${escapeHtml21(check.name)}</strong>: ${escapeHtml21(check.status)}${check.message ? ` - ${escapeHtml21(check.message)}` : ""}</li>`).join("")}
+${report.checks.map((check) => `<li><strong>${escapeHtml22(check.name)}</strong>: ${escapeHtml22(check.status)}${check.message ? ` - ${escapeHtml22(check.message)}` : ""}</li>`).join("")}
 </ul>
 </section>
 <section>
 <h2>Observed URLs</h2>
 <ul>
-<li><strong>TwiML:</strong> <code>${escapeHtml21(report.setup.urls.twiml)}</code></li>
-<li><strong>Stream:</strong> <code>${escapeHtml21(report.twiml?.streamUrl ?? report.setup.urls.stream)}</code></li>
-<li><strong>Webhook:</strong> <code>${escapeHtml21(report.setup.urls.webhook)}</code></li>
+<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>
 </ul>
 </section>
 </main>`;
@@ -16781,7 +16884,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 Elysia22({
+  const app = new Elysia23({
     name: options.name ?? "absolutejs-voice-twilio"
   }).get(twimlPath, async ({ query, request }) => {
     const streamUrl = await resolveTwilioStreamUrl(options, {
@@ -16917,9 +17020,9 @@ var createTwilioVoiceRoutes = (options) => {
 };
 // src/telephony/telnyx.ts
 import { Buffer as Buffer4 } from "buffer";
-import { Elysia as Elysia23 } from "elysia";
+import { Elysia as Elysia24 } from "elysia";
 var escapeXml3 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&apos;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
-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 joinUrlPath2 = (origin, path) => `${origin.replace(/\/$/, "")}${path.startsWith("/") ? path : `/${path}`}`;
 var resolveRequestOrigin2 = (request) => {
   const url = new URL(request.url);
@@ -17120,21 +17223,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>${escapeHtml22(title)}</h1>
+<h1>${escapeHtml23(title)}</h1>
 <p><strong>Status:</strong> ${status.ready ? "Ready" : "Needs attention"}</p>
 <ul>
-<li><strong>TeXML:</strong> <code>${escapeHtml22(status.urls.texml)}</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>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>
 </ul>
-${status.missing.length ? `<h2>Missing env</h2><ul>${status.missing.map((name) => `<li><code>${escapeHtml22(name)}</code></li>`).join("")}</ul>` : ""}
-${status.warnings.length ? `<h2>Warnings</h2><ul>${status.warnings.map((warning) => `<li>${escapeHtml22(warning)}</li>`).join("")}</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>` : ""}
 </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>${escapeHtml22(title)}</h1>
+<h1>${escapeHtml23(title)}</h1>
 <p><strong>Status:</strong> ${report.pass ? "Pass" : "Fail"}</p>
-<ul>${report.checks.map((check) => `<li><strong>${escapeHtml22(check.name)}</strong>: ${escapeHtml22(check.status)}${check.message ? ` - ${escapeHtml22(check.message)}` : ""}</li>`).join("")}</ul>
+<ul>${report.checks.map((check) => `<li><strong>${escapeHtml23(check.name)}</strong>: ${escapeHtml23(check.status)}${check.message ? ` - ${escapeHtml23(check.message)}` : ""}</li>`).join("")}</ul>
 </main>`;
 var runTelnyxSmokeTest = async (input) => {
   const setup = await buildTelnyxVoiceSetupStatus(input.options, input);
@@ -17228,7 +17331,7 @@ var createTelnyxVoiceRoutes = (options = {}) => {
     publicKey: options.webhook?.publicKey,
     toleranceSeconds: options.webhook?.toleranceSeconds
   }) : undefined);
-  const app = new Elysia23({
+  const app = new Elysia24({
     name: options.name ?? "absolutejs-voice-telnyx"
   }).get(texmlPath, async ({ query, request }) => {
     const streamUrl = await resolveTelnyxStreamUrl(options, {
@@ -17338,9 +17441,9 @@ var createTelnyxVoiceRoutes = (options = {}) => {
 };
 // src/telephony/plivo.ts
 import { Buffer as Buffer5 } from "buffer";
-import { Elysia as Elysia24 } from "elysia";
+import { Elysia as Elysia25 } from "elysia";
 var escapeXml4 = (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 joinUrlPath3 = (origin, path) => `${origin.replace(/\/$/, "")}${path.startsWith("/") ? path : `/${path}`}`;
 var resolveRequestOrigin3 = (request) => {
   const url = new URL(request.url);
@@ -17591,21 +17694,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>${escapeHtml23(title)}</h1>
+<h1>${escapeHtml24(title)}</h1>
 <p><strong>Status:</strong> ${status.ready ? "Ready" : "Needs attention"}</p>
 <ul>
-<li><strong>Answer XML:</strong> <code>${escapeHtml23(status.urls.answer)}</code></li>
-<li><strong>Audio stream:</strong> <code>${escapeHtml23(status.urls.stream)}</code></li>
-<li><strong>Status webhook:</strong> <code>${escapeHtml23(status.urls.webhook)}</code></li>
+<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>
 </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 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>${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 runPlivoSmokeTest = async (input) => {
   const setup = await buildPlivoVoiceSetupStatus(input.options, input);
@@ -17700,7 +17803,7 @@ var createPlivoVoiceRoutes = (options = {}) => {
       request: input.request
     }) : verificationUrl ?? input.request.url
   }) : undefined);
-  const app = new Elysia24({
+  const app = new Elysia25({
     name: options.name ?? "absolutejs-voice-plivo"
   }).get(answerPath, async ({ query, request }) => {
     const streamUrl = await resolvePlivoStreamUrl(options, {
@@ -17873,6 +17976,7 @@ export {
   transcodeTwilioInboundPayloadToPCM16,
   transcodePCMToTwilioOutboundPayload,
   summarizeVoiceTurnQuality,
+  summarizeVoiceTurnLatency,
   summarizeVoiceTraceTimeline,
   summarizeVoiceTraceSinkDeliveries,
   summarizeVoiceTrace,
@@ -17920,6 +18024,7 @@ export {
   requeueVoiceOpsTask,
   reopenVoiceOpsTask,
   renderVoiceTurnQualityHTML,
+  renderVoiceTurnLatencyHTML,
   renderVoiceTraceTimelineSessionHTML,
   renderVoiceTraceTimelineHTML,
   renderVoiceTraceMarkdown,
@@ -17985,6 +18090,9 @@ export {
   createVoiceTurnQualityRoutes,
   createVoiceTurnQualityJSONHandler,
   createVoiceTurnQualityHTMLHandler,
+  createVoiceTurnLatencyRoutes,
+  createVoiceTurnLatencyJSONHandler,
+  createVoiceTurnLatencyHTMLHandler,
   createVoiceTraceTimelineRoutes,
   createVoiceTraceSinkStore,
   createVoiceTraceSinkDeliveryWorkerLoop,

package/dist/react/VoiceTurnLatency.d.ts

@@ -0,0 +1,6 @@
+import { type VoiceTurnLatencyWidgetOptions } from '../client/turnLatencyWidget';
+export type VoiceTurnLatencyProps = VoiceTurnLatencyWidgetOptions & {
+    className?: string;
+    path?: string;
+};
+export declare const VoiceTurnLatency: ({ className, path, ...options }: VoiceTurnLatencyProps) => import("react/jsx-runtime").JSX.Element;

package/dist/react/index.d.ts

@@ -4,6 +4,7 @@ export { VoiceProviderCapabilities } from './VoiceProviderCapabilities';
 export { VoiceProviderStatus } from './VoiceProviderStatus';
 export { VoiceRoutingStatus } from './VoiceRoutingStatus';
 export { VoiceTraceTimeline } from './VoiceTraceTimeline';
+export { VoiceTurnLatency } from './VoiceTurnLatency';
 export { VoiceTurnQuality } from './VoiceTurnQuality';
 export { useVoiceAppKitStatus } from './useVoiceAppKitStatus';
 export { useVoiceStream } from './useVoiceStream';
@@ -13,5 +14,6 @@ export { useVoiceProviderCapabilities } from './useVoiceProviderCapabilities';
 export { useVoiceProviderSimulationControls } from './useVoiceProviderSimulationControls';
 export { useVoiceRoutingStatus } from './useVoiceRoutingStatus';
 export { useVoiceTraceTimeline } from './useVoiceTraceTimeline';
+export { useVoiceTurnLatency } from './useVoiceTurnLatency';
 export { useVoiceTurnQuality } from './useVoiceTurnQuality';
 export { useVoiceWorkflowStatus } from './useVoiceWorkflowStatus';