@absolutejs/voice 0.0.22-beta.458 → 0.0.22-beta.459

package/dist/index.d.ts

@@ -93,6 +93,8 @@ export { createVoiceReadinessProfile, recommendVoiceReadinessProfile, } from "./
 export { assertVoiceProviderContractMatrixEvidence, assertVoiceProviderStackEvidence, buildVoiceProviderContractMatrix, createVoiceProviderContractMatrixHTMLHandler, createVoiceProviderContractMatrixJSONHandler, createVoiceProviderContractMatrixPreset, createVoiceProviderContractMatrixRoutes, evaluateVoiceProviderContractMatrixEvidence, evaluateVoiceProviderStackEvidence, evaluateVoiceProviderStackGaps, renderVoiceProviderContractMatrixHTML, recommendVoiceProviderStack, } from "./providerStackRecommendations";
 export { buildVoiceOpsConsoleReport, createVoiceOpsConsoleRoutes, renderVoiceOpsConsoleHTML, } from "./opsConsoleRoutes";
 export { assertVoiceOperationsRecordGuardrails, assertVoiceOperationsRecordProviderRecovery, buildVoiceFailureReplay, buildVoiceOperationsRecord, createVoiceOperationsRecordRoutes, evaluateVoiceOperationsRecordGuardrails, evaluateVoiceOperationsRecordProviderRecovery, renderVoiceFailureReplayMarkdown, renderVoiceOperationsRecordGuardrailMarkdown, renderVoiceOperationsRecordHTML, renderVoiceOperationsRecordIncidentMarkdown, } from "./operationsRecord";
+export { buildVoiceSessionObservabilityReport, createVoiceSessionObservabilityRoutes, renderVoiceSessionObservabilityHTML, renderVoiceSessionObservabilityMarkdown, } from "./sessionObservability";
+export type { VoiceSessionObservabilityLink, VoiceSessionObservabilityReport, VoiceSessionObservabilityReportOptions, VoiceSessionObservabilityRoutesOptions, VoiceSessionObservabilityStage, VoiceSessionObservabilityStatus, VoiceSessionObservabilityTurn, } from "./sessionObservability";
 export { assertVoiceObservabilityExportDeliveryEvidence, assertVoiceObservabilityExportRecord, assertVoiceObservabilityExportReplayEvidence, buildVoiceObservabilityArtifactIndex, buildVoiceObservabilityExportDeliveryHistory, buildVoiceObservabilityExportReplayReport, buildVoiceObservabilityExport, assertVoiceObservabilityExportSchema, createVoiceObservabilityExportSchema, createVoiceFileObservabilityExportDeliveryReceiptStore, createVoiceMemoryObservabilityExportDeliveryReceiptStore, createVoiceObservabilityExportRoutes, createVoiceObservabilityExportReplayRoutes, deliverVoiceObservabilityExport, evaluateVoiceObservabilityExportDeliveryEvidence, evaluateVoiceObservabilityExportReplayEvidence, loadVoiceObservabilityExportReplaySource, replayVoiceObservabilityExport, renderVoiceObservabilityExportReplayHTML, renderVoiceObservabilityExportMarkdown, validateVoiceObservabilityExportRecord, voiceObservabilityExportSchemaId, voiceObservabilityExportSchemaVersion, } from "./observabilityExport";
 export { buildVoiceOpsRecoveryReadinessCheck, buildVoiceOpsRecoveryReport, createVoiceOpsRecoveryRoutes, renderVoiceOpsRecoveryHTML, renderVoiceOpsRecoveryMarkdown, } from "./opsRecovery";
 export { buildVoiceIncidentBundle, createStoredVoiceIncidentBundleArtifact, createVoiceIncidentBundleRoutes, createVoiceMemoryIncidentBundleStore, pruneVoiceIncidentBundleArtifacts, saveVoiceIncidentBundleArtifact, } from "./incidentBundle";

package/dist/index.js

@@ -39075,8 +39075,248 @@ var createVoiceOpsConsoleRoutes = (options) => {
   routes.get(`${path}/json`, async () => getReport());
   return routes;
 };
-// src/incidentBundle.ts
+// src/sessionObservability.ts
 import { Elysia as Elysia62 } from "elysia";
+var escapeHtml59 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var formatMs6 = (value) => value === undefined ? "n/a" : `${String(value)}ms`;
+var resolveHref = (href, sessionId) => {
+  if (href === false) {
+    return;
+  }
+  if (typeof href === "function") {
+    return href(sessionId);
+  }
+  if (typeof href === "string") {
+    return href.includes(":sessionId") ? href.replaceAll(":sessionId", encodeURIComponent(sessionId)) : `${href.replace(/\/$/, "")}/${encodeURIComponent(sessionId)}`;
+  }
+  return;
+};
+var buildLinks = (options) => {
+  const links = [];
+  const add = (rel, label, href) => {
+    if (href) {
+      links.push({ href, label, rel });
+    }
+  };
+  add("operations-record", "Open operations record", resolveHref(options.operationsRecordHref, options.sessionId));
+  add("trace-timeline", "Open trace timeline", resolveHref(options.traceTimelineHref, options.sessionId));
+  add("call-debugger", "Open call debugger", resolveHref(options.callDebuggerHref, options.sessionId));
+  add("incident-markdown", "Download incident Markdown", resolveHref(options.incidentMarkdownHref, options.sessionId));
+  return [...links, ...options.customLinks ?? []];
+};
+var buildTurnWaterfalls = (record) => {
+  const byTurn = new Map;
+  const getTurn = (turnId) => {
+    const existing = byTurn.get(turnId);
+    if (existing) {
+      return existing;
+    }
+    const turn = {
+      assistantReplies: 0,
+      errors: 0,
+      providerDecisions: 0,
+      stages: [],
+      toolCalls: 0,
+      transcripts: 0
+    };
+    byTurn.set(turnId, turn);
+    return turn;
+  };
+  for (const event of record.timeline) {
+    if (!event.turnId) {
+      continue;
+    }
+    const turn = getTurn(event.turnId);
+    turn.stages.push({
+      at: event.at,
+      elapsedMs: event.elapsedMs,
+      label: event.label,
+      offsetMs: event.offsetMs,
+      provider: event.provider,
+      status: event.status,
+      type: event.type
+    });
+    if (event.type === "turn.transcript") {
+      turn.transcripts += 1;
+    }
+    if (event.type === "turn.assistant") {
+      turn.assistantReplies += 1;
+    }
+    if (event.type === "agent.tool") {
+      turn.toolCalls += 1;
+    }
+    if (event.type === "provider.decision") {
+      turn.providerDecisions += 1;
+    }
+    if (event.type === "session.error" || event.status === "error") {
+      turn.errors += 1;
+    }
+  }
+  for (const transcript of record.transcript) {
+    const turn = getTurn(transcript.id);
+    turn.assistantReplies = Math.max(turn.assistantReplies, transcript.assistantReplies.length);
+    turn.errors += transcript.errors.length;
+    turn.transcripts = Math.max(turn.transcripts, transcript.transcripts.length);
+  }
+  return [...byTurn.entries()].map(([turnId, turn]) => {
+    const startedAt = turn.stages[0]?.at;
+    const endedAt = turn.stages.at(-1)?.at;
+    return {
+      assistantReplies: turn.assistantReplies,
+      durationMs: startedAt !== undefined && endedAt !== undefined ? Math.max(0, endedAt - startedAt) : undefined,
+      endedAt,
+      errors: turn.errors,
+      providerDecisions: turn.providerDecisions,
+      stages: turn.stages,
+      startedAt,
+      toolCalls: turn.toolCalls,
+      transcripts: turn.transcripts,
+      turnId
+    };
+  }).sort((left, right) => (left.startedAt ?? 0) - (right.startedAt ?? 0));
+};
+var buildVoiceSessionObservabilityReport = async (options) => {
+  const record = await buildVoiceOperationsRecord({
+    audit: options.audit,
+    evaluation: options.evaluation,
+    events: options.events,
+    integrationEvents: options.integrationEvents,
+    redact: options.redact,
+    reviews: options.reviews,
+    sessionId: options.sessionId,
+    store: options.store,
+    tasks: options.tasks
+  });
+  const failureReplay = buildVoiceFailureReplay(record, {
+    operationsRecordHref: resolveHref(options.operationsRecordHref, options.sessionId)
+  });
+  const incidentMarkdown = renderVoiceOperationsRecordIncidentMarkdown(record);
+  const statuses = [
+    record.status,
+    failureReplay.status === "failed" ? "failed" : failureReplay.status === "degraded" ? "warning" : "healthy"
+  ];
+  const status = statuses.includes("failed") ? "failed" : statuses.includes("warning") ? "warning" : "healthy";
+  return {
+    checkedAt: Date.now(),
+    failureReplay,
+    incidentMarkdown,
+    links: buildLinks(options),
+    record,
+    sessionId: options.sessionId,
+    status,
+    summary: {
+      durationMs: record.summary.callDurationMs,
+      errors: record.summary.errorCount,
+      events: record.summary.eventCount,
+      fallbacks: record.providerDecisionSummary.fallbacks,
+      guardrailBlocks: record.guardrails.blocked,
+      handoffs: record.handoffs.length,
+      providerRecoveryStatus: record.providerDecisionSummary.recoveryStatus,
+      providers: record.providerDecisionSummary.providers,
+      telephonyMediaEvents: record.telephonyMedia.total,
+      toolCalls: record.tools.length,
+      turns: record.summary.turnCount
+    },
+    turns: buildTurnWaterfalls(record)
+  };
+};
+var renderLinks = (links) => links.length === 0 ? "" : `<div class="actions">${links.map((link) => `<a href="${escapeHtml59(link.href)}">${escapeHtml59(link.label)}</a>`).join("")}</div>`;
+var renderTurns = (turns) => turns.length === 0 ? '<p class="muted">No turn-level events recorded yet.</p>' : turns.map((turn) => `<article class="turn"><header><strong>${escapeHtml59(turn.turnId)}</strong><span>${formatMs6(turn.durationMs)}</span></header><dl><div><dt>Transcripts</dt><dd>${String(turn.transcripts)}</dd></div><div><dt>Assistant</dt><dd>${String(turn.assistantReplies)}</dd></div><div><dt>Tools</dt><dd>${String(turn.toolCalls)}</dd></div><div><dt>Providers</dt><dd>${String(turn.providerDecisions)}</dd></div><div><dt>Errors</dt><dd>${String(turn.errors)}</dd></div></dl><table><thead><tr><th>Offset</th><th>Type</th><th>Stage</th><th>Provider</th><th>Status</th><th>Latency</th></tr></thead><tbody>${turn.stages.map((stage) => `<tr><td>+${String(stage.offsetMs)}ms</td><td>${escapeHtml59(stage.type)}</td><td>${escapeHtml59(stage.label)}</td><td>${escapeHtml59(stage.provider ?? "")}</td><td>${escapeHtml59(stage.status ?? "")}</td><td>${formatMs6(stage.elapsedMs)}</td></tr>`).join("")}</tbody></table></article>`).join("");
+var renderVoiceSessionObservabilityMarkdown = (report) => `# Voice session observability: ${report.sessionId}
+
+Status: ${report.status}
+
+- Events: ${report.summary.events}
+- Turns: ${report.summary.turns}
+- Errors: ${report.summary.errors}
+- Duration: ${formatMs6(report.summary.durationMs)}
+- Providers: ${report.summary.providers.join(", ") || "none"}
+- Provider recovery: ${report.summary.providerRecoveryStatus}
+- Fallbacks: ${report.summary.fallbacks}
+- Tool calls: ${report.summary.toolCalls}
+- Handoffs: ${report.summary.handoffs}
+- Guardrail blocks: ${report.summary.guardrailBlocks}
+- Telephony media events: ${report.summary.telephonyMediaEvents}
+
+## Links
+
+${report.links.length ? report.links.map((link) => `- [${link.label}](${link.href})`).join(`
+`) : "- none"}
+
+## Turn Waterfalls
+
+${report.turns.length ? report.turns.map((turn) => `### ${turn.turnId}
+
+- Duration: ${formatMs6(turn.durationMs)}
+- Transcripts: ${turn.transcripts}
+- Assistant replies: ${turn.assistantReplies}
+- Tool calls: ${turn.toolCalls}
+- Provider decisions: ${turn.providerDecisions}
+- Errors: ${turn.errors}
+
+${turn.stages.map((stage) => `- +${stage.offsetMs}ms ${stage.type}: ${stage.label}${stage.provider ? ` (${stage.provider})` : ""}${stage.status ? ` [${stage.status}]` : ""}`).join(`
+`)}`).join(`
+
+`) : "No turn-level events recorded."}
+
+## Incident Handoff
+
+${report.incidentMarkdown}`;
+var renderVoiceSessionObservabilityHTML = (report, options = {}) => `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml59(options.title ?? "Voice Session Observability")}</title><style>body{background:#0d1412;color:#f7f2e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1180px;padding:32px}.eyebrow{color:#fbbf24;font-size:.78rem;font-weight:900;letter-spacing:.14em;text-transform:uppercase}h1{font-size:clamp(2.4rem,6vw,4.8rem);line-height:.9;margin:.2rem 0 1rem}.status{border:1px solid #425046;border-radius:999px;display:inline-flex;padding:8px 12px}.healthy{color:#86efac}.warning{color:#fbbf24}.failed,.error{color:#fca5a5}.actions{display:flex;flex-wrap:wrap;gap:10px;margin:18px 0}.actions a{background:#fbbf24;border-radius:999px;color:#111827;font-weight:900;padding:10px 14px;text-decoration:none}.grid{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(170px,1fr));margin:22px 0}.card,.turn,.incident{background:#17201c;border:1px solid #2e3c35;border-radius:20px;padding:16px}.card span,.muted,dt{color:#a8b4ad}.card strong{display:block;font-size:2rem}section{margin-top:30px}.turn{margin:16px 0}.turn header{align-items:center;display:flex;justify-content:space-between;gap:14px}dl{display:grid;gap:10px;grid-template-columns:repeat(auto-fit,minmax(120px,1fr));margin:14px 0}dd{font-weight:900;margin:3px 0 0}table{border-collapse:collapse;margin-top:14px;width:100%}td,th{border-top:1px solid #2e3c35;padding:10px;text-align:left}pre{background:#08100d;border:1px solid #2e3c35;border-radius:16px;color:#d9f99d;overflow:auto;padding:14px}@media(max-width:760px){main{padding:20px}table{font-size:.9rem}}</style></head><body><main><header><p class="eyebrow">Session observability</p><h1>${escapeHtml59(report.sessionId)}</h1><p class="status ${escapeHtml59(report.status)}">${escapeHtml59(report.status)}</p>${renderLinks(report.links)}<p class="muted">One support/debug report across trace timeline, operations record, provider recovery, turn waterfalls, guardrails, tools, handoffs, failure replay, and incident handoff.</p></header><section class="grid"><article class="card"><span>Events</span><strong>${String(report.summary.events)}</strong></article><article class="card"><span>Turns</span><strong>${String(report.summary.turns)}</strong></article><article class="card"><span>Errors</span><strong>${String(report.summary.errors)}</strong></article><article class="card"><span>Duration</span><strong>${formatMs6(report.summary.durationMs)}</strong></article><article class="card"><span>Fallbacks</span><strong>${String(report.summary.fallbacks)}</strong></article><article class="card"><span>Tools</span><strong>${String(report.summary.toolCalls)}</strong></article><article class="card"><span>Handoffs</span><strong>${String(report.summary.handoffs)}</strong></article><article class="card"><span>Guardrails blocked</span><strong>${String(report.summary.guardrailBlocks)}</strong></article><article class="card"><span>Telephony media</span><strong>${String(report.summary.telephonyMediaEvents)}</strong></article></section><section><h2>Turn Waterfalls</h2>${renderTurns(report.turns)}</section><section class="incident"><h2>Incident Handoff</h2><pre><code>${escapeHtml59(report.incidentMarkdown)}</code></pre></section></main></body></html>`;
+var routeSessionId = (params) => typeof params.sessionId === "string" ? params.sessionId : "";
+var createVoiceSessionObservabilityRoutes = (options) => {
+  const path = options.path ?? "/api/voice/session-observability/:sessionId";
+  const htmlPath = options.htmlPath ?? "/voice/session-observability/:sessionId";
+  const incidentPath = options.incidentPath ?? "/api/voice/session-observability/:sessionId/incident.md";
+  const title = options.title ?? "AbsoluteJS Voice Session Observability";
+  const routes = new Elysia62({
+    name: options.name ?? "absolutejs-voice-session-observability"
+  });
+  const build = (sessionId) => buildVoiceSessionObservabilityReport({
+    audit: options.audit,
+    callDebuggerHref: options.callDebuggerHref,
+    customLinks: options.customLinks,
+    evaluation: options.evaluation,
+    events: options.events,
+    incidentMarkdownHref: options.incidentMarkdownHref ?? (incidentPath === false ? false : incidentPath),
+    integrationEvents: options.integrationEvents,
+    operationsRecordHref: options.operationsRecordHref,
+    redact: options.redact,
+    reviews: options.reviews,
+    sessionId,
+    store: options.store,
+    tasks: options.tasks,
+    traceTimelineHref: options.traceTimelineHref
+  });
+  routes.get(path, async ({ params }) => Response.json(await build(routeSessionId(params))));
+  if (htmlPath !== false) {
+    routes.get(htmlPath, async ({ params }) => {
+      const report = await build(routeSessionId(params));
+      const body = await (options.render ?? ((input) => renderVoiceSessionObservabilityHTML(input, { title })))(report);
+      return new Response(body, {
+        headers: {
+          "content-type": "text/html; charset=utf-8",
+          ...options.headers
+        }
+      });
+    });
+  }
+  if (incidentPath !== false) {
+    routes.get(incidentPath, async ({ params }) => {
+      const report = await build(routeSessionId(params));
+      const body = await (options.renderIncidentMarkdown ?? renderVoiceSessionObservabilityMarkdown)(report);
+      return new Response(body, {
+        headers: {
+          "content-type": "text/markdown; charset=utf-8",
+          ...options.headers
+        }
+      });
+    });
+  }
+  return routes;
+};
+// src/incidentBundle.ts
+import { Elysia as Elysia63 } from "elysia";
 var filterIncidentBundleArtifacts = (artifacts, filter = {}) => artifacts.filter((artifact) => {
   if (filter.sessionId && artifact.sessionId !== filter.sessionId) {
     return false;
@@ -39293,7 +39533,7 @@ var buildVoiceIncidentBundle = async (options) => {
 var createVoiceIncidentBundleRoutes = (options) => {
   const path = options.path ?? "/api/voice-incidents/:sessionId";
   const markdownPath = options.markdownPath === undefined ? "/voice-incidents/:sessionId/markdown" : options.markdownPath;
-  const routes = new Elysia62({
+  const routes = new Elysia63({
     name: options.name ?? "absolutejs-voice-incident-bundle"
   });
   const getSessionId = (params) => params.sessionId ?? "";
@@ -39494,19 +39734,19 @@ var summarizeVoiceOpsStatus = async (options) => {
   };
 };
 // src/opsStatusRoutes.ts
-import { Elysia as Elysia63 } from "elysia";
-var escapeHtml59 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+import { Elysia as Elysia64 } from "elysia";
+var escapeHtml60 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var renderVoiceOpsStatusHTML = (report, options = {}) => {
   const title = options.title ?? "AbsoluteJS Voice Ops Status";
   const surfaces = Object.entries(report.surfaces).map(([key, surface]) => {
     const value = "recovered" in surface ? surface.total === 0 ? "0 events" : `${surface.recovered}/${surface.total}` : ("auditTotal" in surface) ? `${surface.auditTotal + surface.traceTotal} deliveries` : ("total" in surface) ? `${Math.max(surface.total - ("failed" in surface ? surface.failed : ("degraded" in surface) ? surface.degraded : 0), 0)}/${surface.total}` : surface.status;
-    return `<article class="surface ${escapeHtml59(surface.status)}"><span>${escapeHtml59(surface.status.toUpperCase())}</span><h2>${escapeHtml59(key)}</h2><strong>${escapeHtml59(value)}</strong></article>`;
+    return `<article class="surface ${escapeHtml60(surface.status)}"><span>${escapeHtml60(surface.status.toUpperCase())}</span><h2>${escapeHtml60(key)}</h2><strong>${escapeHtml60(value)}</strong></article>`;
   }).join("");
-  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml59(title)}</title><style>body{background:#0d141b;color:#f8f3e7;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:980px;padding:32px}.hero{background:linear-gradient(135deg,rgba(20,184,166,.2),rgba(245,158,11,.12));border:1px solid #283544;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;font-weight:900;padding:8px 12px}.surfaces{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(180px,1fr))}.surface{background:#151d26;border:1px solid #283544;border-radius:20px;padding:18px}.surface span{color:#aab5c0;font-size:.78rem;font-weight:900;letter-spacing:.08em}.surface strong{font-size:1.5rem}.pass{border-color:rgba(34,197,94,.55)}.fail{border-color:rgba(239,68,68,.75)}a{color:#5eead4}</style></head><body><main><section class="hero"><p class="eyebrow">Ops status</p><h1>${escapeHtml59(title)}</h1><p>Compact pass/fail status for framework widgets, demos, and small customer-facing health badges.</p><p class="status ${escapeHtml59(report.status)}">Overall: ${escapeHtml59(report.status.toUpperCase())}</p><p>${report.passed}/${report.total} checks passing</p></section><section class="surfaces">${surfaces || '<article class="surface pass"><span>PASS</span><h2>No checks configured</h2><strong>0/0</strong></article>'}</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>${escapeHtml60(title)}</title><style>body{background:#0d141b;color:#f8f3e7;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:980px;padding:32px}.hero{background:linear-gradient(135deg,rgba(20,184,166,.2),rgba(245,158,11,.12));border:1px solid #283544;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;font-weight:900;padding:8px 12px}.surfaces{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(180px,1fr))}.surface{background:#151d26;border:1px solid #283544;border-radius:20px;padding:18px}.surface span{color:#aab5c0;font-size:.78rem;font-weight:900;letter-spacing:.08em}.surface strong{font-size:1.5rem}.pass{border-color:rgba(34,197,94,.55)}.fail{border-color:rgba(239,68,68,.75)}a{color:#5eead4}</style></head><body><main><section class="hero"><p class="eyebrow">Ops status</p><h1>${escapeHtml60(title)}</h1><p>Compact pass/fail status for framework widgets, demos, and small customer-facing health badges.</p><p class="status ${escapeHtml60(report.status)}">Overall: ${escapeHtml60(report.status.toUpperCase())}</p><p>${report.passed}/${report.total} checks passing</p></section><section class="surfaces">${surfaces || '<article class="surface pass"><span>PASS</span><h2>No checks configured</h2><strong>0/0</strong></article>'}</section></main></body></html>`;
 };
 var createVoiceOpsStatusRoutes = (options) => {
   const path = options.path ?? "/api/voice/ops-status";
-  const routes = new Elysia63({
+  const routes = new Elysia64({
     name: options.name ?? "absolutejs-voice-ops-status"
   });
   routes.get(path, async () => summarizeVoiceOpsStatus(options));
@@ -39939,8 +40179,8 @@ var createVoiceTTSProviderRouter = (options) => {
   };
 };
 // src/traceDeliveryRoutes.ts
-import { Elysia as Elysia64 } from "elysia";
-var escapeHtml60 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+import { Elysia as Elysia65 } from "elysia";
+var escapeHtml61 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var getString20 = (value) => typeof value === "string" && value.trim() ? value.trim() : undefined;
 var getNumber12 = (value) => {
   if (typeof value === "number" && Number.isFinite(value)) {
@@ -40021,14 +40261,14 @@ var renderSinkResults2 = (delivery) => {
   if (entries.length === 0) {
     return "<p>No sink delivery attempts recorded yet.</p>";
   }
-  return `<ul>${entries.map(([sinkId, result]) => `<li><strong>${escapeHtml60(sinkId)}</strong>: ${escapeHtml60(result.status)}${result.deliveredTo ? ` to ${escapeHtml60(result.deliveredTo)}` : ""}${result.error ? ` (${escapeHtml60(result.error)})` : ""}</li>`).join("")}</ul>`;
+  return `<ul>${entries.map(([sinkId, result]) => `<li><strong>${escapeHtml61(sinkId)}</strong>: ${escapeHtml61(result.status)}${result.deliveredTo ? ` to ${escapeHtml61(result.deliveredTo)}` : ""}${result.error ? ` (${escapeHtml61(result.error)})` : ""}</li>`).join("")}</ul>`;
 };
-var renderEventList2 = (delivery) => delivery.events.length === 0 ? "<p>No trace events in this delivery.</p>" : `<ul>${delivery.events.map((event) => `<li>${escapeHtml60(event.type)} <small>${escapeHtml60(event.id)}</small>${event.sessionId ? ` session=${escapeHtml60(event.sessionId)}` : ""}</li>`).join("")}</ul>`;
+var renderEventList2 = (delivery) => delivery.events.length === 0 ? "<p>No trace events in this delivery.</p>" : `<ul>${delivery.events.map((event) => `<li>${escapeHtml61(event.type)} <small>${escapeHtml61(event.id)}</small>${event.sessionId ? ` session=${escapeHtml61(event.sessionId)}` : ""}</li>`).join("")}</ul>`;
 var renderVoiceTraceDeliveryHTML = (report, options = {}) => {
   const title = options.title ?? "AbsoluteJS Voice Trace Deliveries";
-  const drainAction = options.workerPath === false ? "" : `<form method="post" action="${escapeHtml60(options.workerPath ?? "/api/voice-trace-deliveries/drain")}"><button type="submit">Drain trace deliveries</button></form>`;
-  const rows = report.deliveries.map((delivery) => `<article class="delivery ${escapeHtml60(delivery.deliveryStatus)}"><div class="head"><div><span>${escapeHtml60(delivery.deliveryStatus)}</span><h2>${escapeHtml60(delivery.id)}</h2><p>${escapeHtml60(new Date(delivery.createdAt).toLocaleString())}${delivery.deliveredAt ? ` \xB7 delivered ${escapeHtml60(new Date(delivery.deliveredAt).toLocaleString())}` : ""}</p></div><strong>${String(delivery.deliveryAttempts ?? 0)} attempt(s)</strong></div>${delivery.deliveryError ? `<p class="error">${escapeHtml60(delivery.deliveryError)}</p>` : ""}<h3>Sinks</h3>${renderSinkResults2(delivery)}<h3>Events</h3>${renderEventList2(delivery)}</article>`).join("");
-  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml60(title)}</title><style>body{background:#0f1318;color:#f4efe1;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.hero{background:linear-gradient(135deg,rgba(34,197,94,.16),rgba(14,165,233,.14));border:1px solid #26313d;border-radius:28px;margin-bottom:18px;padding:28px}.eyebrow{color:#86efac;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.2rem,5vw,4.8rem);line-height:.92;margin:.2rem 0 1rem}.grid{display:grid;gap:12px;grid-template-columns:repeat(4,1fr);margin-bottom:16px}.grid article,.delivery{background:#151b22;border:1px solid #26313d;border-radius:22px;padding:18px}.grid span,.delivery span{color:#86efac;font-size:.78rem;font-weight:900;letter-spacing:.08em;text-transform:uppercase}.grid strong{display:block;font-size:2rem}.deliveries{display:grid;gap:14px}.delivery.failed{border-color:rgba(239,68,68,.75)}.delivery.pending{border-color:rgba(245,158,11,.7)}.delivery.delivered{border-color:rgba(34,197,94,.55)}.delivery.skipped{border-color:rgba(148,163,184,.6)}.head{align-items:start;display:flex;gap:14px;justify-content:space-between}.delivery h2{font-size:1.05rem;margin:.3rem 0;overflow-wrap:anywhere}.delivery h3{margin:1rem 0 .3rem}.delivery p,.delivery li{color:#c8d0d8}.error{color:#fecaca!important}button{background:#86efac;border:0;border-radius:999px;color:#07111f;cursor:pointer;font-weight:900;margin-top:12px;padding:10px 14px}@media(max-width:760px){main{padding:20px}.grid{grid-template-columns:1fr 1fr}.head{display:block}}</style></head><body><main><section class="hero"><p class="eyebrow">Trace export health</p><h1>${escapeHtml60(title)}</h1><p>Checked ${escapeHtml60(new Date(report.checkedAt).toLocaleString())}. Showing ${String(report.deliveries.length)} delivery item(s).</p>${drainAction}</section>${renderMetricGrid3(report)}<section class="deliveries">${rows || "<p>No trace deliveries match this filter.</p>"}</section></main></body></html>`;
+  const drainAction = options.workerPath === false ? "" : `<form method="post" action="${escapeHtml61(options.workerPath ?? "/api/voice-trace-deliveries/drain")}"><button type="submit">Drain trace deliveries</button></form>`;
+  const rows = report.deliveries.map((delivery) => `<article class="delivery ${escapeHtml61(delivery.deliveryStatus)}"><div class="head"><div><span>${escapeHtml61(delivery.deliveryStatus)}</span><h2>${escapeHtml61(delivery.id)}</h2><p>${escapeHtml61(new Date(delivery.createdAt).toLocaleString())}${delivery.deliveredAt ? ` \xB7 delivered ${escapeHtml61(new Date(delivery.deliveredAt).toLocaleString())}` : ""}</p></div><strong>${String(delivery.deliveryAttempts ?? 0)} attempt(s)</strong></div>${delivery.deliveryError ? `<p class="error">${escapeHtml61(delivery.deliveryError)}</p>` : ""}<h3>Sinks</h3>${renderSinkResults2(delivery)}<h3>Events</h3>${renderEventList2(delivery)}</article>`).join("");
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml61(title)}</title><style>body{background:#0f1318;color:#f4efe1;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.hero{background:linear-gradient(135deg,rgba(34,197,94,.16),rgba(14,165,233,.14));border:1px solid #26313d;border-radius:28px;margin-bottom:18px;padding:28px}.eyebrow{color:#86efac;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.2rem,5vw,4.8rem);line-height:.92;margin:.2rem 0 1rem}.grid{display:grid;gap:12px;grid-template-columns:repeat(4,1fr);margin-bottom:16px}.grid article,.delivery{background:#151b22;border:1px solid #26313d;border-radius:22px;padding:18px}.grid span,.delivery span{color:#86efac;font-size:.78rem;font-weight:900;letter-spacing:.08em;text-transform:uppercase}.grid strong{display:block;font-size:2rem}.deliveries{display:grid;gap:14px}.delivery.failed{border-color:rgba(239,68,68,.75)}.delivery.pending{border-color:rgba(245,158,11,.7)}.delivery.delivered{border-color:rgba(34,197,94,.55)}.delivery.skipped{border-color:rgba(148,163,184,.6)}.head{align-items:start;display:flex;gap:14px;justify-content:space-between}.delivery h2{font-size:1.05rem;margin:.3rem 0;overflow-wrap:anywhere}.delivery h3{margin:1rem 0 .3rem}.delivery p,.delivery li{color:#c8d0d8}.error{color:#fecaca!important}button{background:#86efac;border:0;border-radius:999px;color:#07111f;cursor:pointer;font-weight:900;margin-top:12px;padding:10px 14px}@media(max-width:760px){main{padding:20px}.grid{grid-template-columns:1fr 1fr}.head{display:block}}</style></head><body><main><section class="hero"><p class="eyebrow">Trace export health</p><h1>${escapeHtml61(title)}</h1><p>Checked ${escapeHtml61(new Date(report.checkedAt).toLocaleString())}. Showing ${String(report.deliveries.length)} delivery item(s).</p>${drainAction}</section>${renderMetricGrid3(report)}<section class="deliveries">${rows || "<p>No trace deliveries match this filter.</p>"}</section></main></body></html>`;
 };
 var createVoiceTraceDeliveryJSONHandler = (options) => async ({ query }) => buildVoiceTraceDeliveryReport(options, resolveVoiceTraceDeliveryFilter(query, options.filter));
 var createVoiceTraceDeliveryHTMLHandler = (options) => async ({ query }) => {
@@ -40048,7 +40288,7 @@ var createVoiceTraceDeliveryRoutes = (options) => {
   const path = options.path ?? "/api/voice-trace-deliveries";
   const htmlPath = options.htmlPath === undefined ? "/traces/deliveries" : options.htmlPath;
   const workerPath = options.workerPath === undefined ? `${path}/drain` : options.workerPath;
-  const routes = new Elysia64({
+  const routes = new Elysia65({
     name: options.name ?? "absolutejs-voice-trace-deliveries"
   }).get(path, createVoiceTraceDeliveryJSONHandler(options));
   if (htmlPath !== false) {
@@ -40145,7 +40385,7 @@ var createVoiceMemoryStore = () => {
   return { get, getOrCreate, list, remove, set };
 };
 // src/opsWebhook.ts
-import { Elysia as Elysia65 } from "elysia";
+import { Elysia as Elysia66 } from "elysia";
 var toHex6 = (bytes) => Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
 var signVoiceOpsWebhookBody = async (input) => {
   const encoder2 = new TextEncoder;
@@ -40275,7 +40515,7 @@ var verifyVoiceOpsWebhookSignature = async (input) => {
 };
 var createVoiceOpsWebhookReceiverRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice-ops/webhook";
-  return new Elysia65().post(path, async ({ body, request, set }) => {
+  return new Elysia66().post(path, async ({ body, request, set }) => {
     const bodyText = typeof body === "string" ? body : JSON.stringify(body);
     if (options.signingSecret) {
       const verification = await verifyVoiceOpsWebhookSignature({
@@ -40730,7 +40970,7 @@ var resolveVoiceOpsPreset = (name, overrides = {}) => {
   };
 };
 // src/postCallAnalysis.ts
-import { Elysia as Elysia66 } from "elysia";
+import { Elysia as Elysia67 } from "elysia";
 var isStore = (value) => Boolean(value) && typeof value === "object" && value !== null && ("list" in value);
 var asArray = async (value) => Array.isArray(value) ? value : isStore(value) ? await value.list() : [];
 var getPathValue3 = (source, path) => {
@@ -40909,7 +41149,7 @@ var resolvePostCallAnalysisReport = async (options, input) => {
 };
 var createVoicePostCallAnalysisRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice/post-call-analysis";
-  const routes = new Elysia66({
+  const routes = new Elysia67({
     name: options.name ?? "absolutejs-voice-post-call-analysis"
   });
   routes.get(path, async ({ query }) => {
@@ -40934,7 +41174,7 @@ var createVoicePostCallAnalysisRoutes = (options = {}) => {
   return routes;
 };
 // src/guardrails.ts
-import { Elysia as Elysia67 } from "elysia";
+import { Elysia as Elysia68 } from "elysia";
 var stringifyContent = (value) => typeof value === "string" ? value : JSON.stringify(value) ?? "";
 var appliesToStage = (rule, stage) => !rule.stages || rule.stages.length === 0 || rule.stages.includes(stage);
 var matchesRule = async (rule, input) => {
@@ -41236,7 +41476,7 @@ var resolveGuardrailReport = async (options, input) => {
 };
 var createVoiceGuardrailRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice/guardrails";
-  const routes = new Elysia67({
+  const routes = new Elysia68({
     name: options.name ?? "absolutejs-voice-guardrails"
   });
   routes.all(path, async ({ request }) => {
@@ -42015,7 +42255,7 @@ var shapeTelephonyAssistantText = (text, options = {}) => {
   return ensureTerminalPunctuation(normalizeWhitespace(limitedChars));
 };
 // src/proofPack.ts
-import { Elysia as Elysia68 } from "elysia";
+import { Elysia as Elysia69 } from "elysia";
 import { mkdir as mkdir5 } from "fs/promises";
 import { dirname as dirname3, join as join4 } from "path";
 var toGeneratedAt = (value) => value === undefined ? new Date().toISOString() : typeof value === "number" ? new Date(value).toISOString() : value;
@@ -42581,7 +42821,7 @@ var createVoiceProofPackArtifacts = (input) => [
 var createVoiceProofPackRoutes = (options) => {
   const jsonPath = options.jsonPath ?? "/api/voice/proof-pack";
   const markdownPath = options.markdownPath ?? "/voice/proof-pack.md";
-  const app = new Elysia68({ name: options.name ?? "voice-proof-pack" });
+  const app = new Elysia69({ name: options.name ?? "voice-proof-pack" });
   if (jsonPath !== false) {
     app.get(jsonPath, async () => new Response(JSON.stringify(await resolveProofPack(options.source), null, 2), {
       headers: {
@@ -42716,6 +42956,8 @@ export {
   renderVoiceSloCalibrationMarkdown,
   renderVoiceSimulationSuiteHTML,
   renderVoiceSessionsHTML,
+  renderVoiceSessionObservabilityMarkdown,
+  renderVoiceSessionObservabilityHTML,
   renderVoiceScenarioFixtureEvalHTML,
   renderVoiceScenarioEvalHTML,
   renderVoiceResilienceHTML,
@@ -42956,6 +43198,7 @@ export {
   createVoiceSessionReplayJSONHandler,
   createVoiceSessionReplayHTMLHandler,
   createVoiceSessionRecord,
+  createVoiceSessionObservabilityRoutes,
   createVoiceSessionListRoutes,
   createVoiceSession,
   createVoiceScopedTraceEventStore,
@@ -43232,6 +43475,7 @@ export {
   buildVoiceSloCalibrationReport,
   buildVoiceSessionSnapshotStatus,
   buildVoiceSessionSnapshot,
+  buildVoiceSessionObservabilityReport,
   buildVoiceReconnectProofReport,
   buildVoiceReconnectProfileEvidenceSummary,
   buildVoiceRealtimeProviderContractMatrix,

package/dist/sessionObservability.d.ts

@@ -0,0 +1,104 @@
+import { Elysia } from "elysia";
+import { type VoiceFailureReplayReport, type VoiceOperationsRecord, type VoiceOperationsRecordOptions } from "./operationsRecord";
+import type { StoredVoiceTraceEvent } from "./trace";
+export type VoiceSessionObservabilityStatus = "failed" | "healthy" | "warning";
+export type VoiceSessionObservabilityLink = {
+    href: string;
+    label: string;
+    rel: "call-debugger" | "incident-markdown" | "operations-record" | "trace-timeline" | "custom";
+};
+export type VoiceSessionObservabilityStage = {
+    at: number;
+    elapsedMs?: number;
+    label: string;
+    offsetMs: number;
+    provider?: string;
+    status?: string;
+    type: StoredVoiceTraceEvent["type"];
+};
+export type VoiceSessionObservabilityTurn = {
+    assistantReplies: number;
+    durationMs?: number;
+    endedAt?: number;
+    errors: number;
+    providerDecisions: number;
+    stages: VoiceSessionObservabilityStage[];
+    startedAt?: number;
+    toolCalls: number;
+    transcripts: number;
+    turnId: string;
+};
+export type VoiceSessionObservabilityReport = {
+    checkedAt: number;
+    failureReplay: VoiceFailureReplayReport;
+    incidentMarkdown: string;
+    links: VoiceSessionObservabilityLink[];
+    record: VoiceOperationsRecord;
+    sessionId: string;
+    status: VoiceSessionObservabilityStatus;
+    summary: {
+        durationMs?: number;
+        errors: number;
+        events: number;
+        fallbacks: number;
+        guardrailBlocks: number;
+        handoffs: number;
+        providerRecoveryStatus: VoiceOperationsRecord["providerDecisionSummary"]["recoveryStatus"];
+        providers: string[];
+        telephonyMediaEvents: number;
+        toolCalls: number;
+        turns: number;
+    };
+    turns: VoiceSessionObservabilityTurn[];
+};
+export type VoiceSessionObservabilityReportOptions = Omit<VoiceOperationsRecordOptions, "sessionId"> & {
+    callDebuggerHref?: false | string | ((sessionId: string) => string);
+    customLinks?: readonly VoiceSessionObservabilityLink[];
+    incidentMarkdownHref?: false | string | ((sessionId: string) => string);
+    operationsRecordHref?: false | string | ((sessionId: string) => string);
+    sessionId: string;
+    traceTimelineHref?: false | string | ((sessionId: string) => string);
+};
+export type VoiceSessionObservabilityRoutesOptions = Omit<VoiceSessionObservabilityReportOptions, "sessionId"> & {
+    headers?: HeadersInit;
+    htmlPath?: false | string;
+    incidentPath?: false | string;
+    name?: string;
+    path?: string;
+    render?: (report: VoiceSessionObservabilityReport) => Promise<string> | string;
+    renderIncidentMarkdown?: (report: VoiceSessionObservabilityReport) => Promise<string> | string;
+    title?: string;
+};
+export declare const buildVoiceSessionObservabilityReport: (options: VoiceSessionObservabilityReportOptions) => Promise<VoiceSessionObservabilityReport>;
+export declare const renderVoiceSessionObservabilityMarkdown: (report: VoiceSessionObservabilityReport) => string;
+export declare const renderVoiceSessionObservabilityHTML: (report: VoiceSessionObservabilityReport, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceSessionObservabilityRoutes: (options: VoiceSessionObservabilityRoutesOptions) => 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.458",
+  "version": "0.0.22-beta.459",
   "description": "Voice primitives and Elysia plugin for AbsoluteJS",
   "repository": {
     "type": "git",