@absolutejs/voice 0.0.22-beta.182 → 0.0.22-beta.183

package/dist/index.d.ts

@@ -48,6 +48,7 @@ export { buildVoiceProductionReadinessGate, buildVoiceProductionReadinessReport,
 export { createVoiceReadinessProfile, recommendVoiceReadinessProfile } from './readinessProfiles';
 export { buildVoiceProviderContractMatrix, createVoiceProviderContractMatrixHTMLHandler, createVoiceProviderContractMatrixJSONHandler, createVoiceProviderContractMatrixPreset, createVoiceProviderContractMatrixRoutes, evaluateVoiceProviderStackGaps, renderVoiceProviderContractMatrixHTML, recommendVoiceProviderStack } from './providerStackRecommendations';
 export { buildVoiceOpsConsoleReport, createVoiceOpsConsoleRoutes, renderVoiceOpsConsoleHTML } from './opsConsoleRoutes';
+export { buildVoiceOperationsRecord, createVoiceOperationsRecordRoutes, renderVoiceOperationsRecordHTML } from './operationsRecord';
 export { summarizeVoiceOpsStatus } from './opsStatus';
 export { createVoiceOpsStatusRoutes, renderVoiceOpsStatusHTML } from './opsStatusRoutes';
 export { createVoiceQualityRoutes, evaluateVoiceQuality, renderVoiceQualityHTML } from './qualityRoutes';
@@ -107,6 +108,7 @@ export type { VoiceOpsStatus, VoiceOpsStatusLink, VoiceOpsStatusOptions, VoiceOp
 export type { VoiceProductionReadinessAction, VoiceProductionReadinessAuditOptions, VoiceProductionReadinessAuditRequirement, VoiceProductionReadinessAuditSummary, VoiceProductionReadinessCheck, VoiceProductionReadinessGateIssue, VoiceProductionReadinessGateOptions, VoiceProductionReadinessGateProfile, VoiceProductionReadinessGateProfileSurface, VoiceProductionReadinessGateReport, VoiceProductionReadinessOpsActionHistoryOptions, VoiceProductionReadinessOpsActionHistorySummary, VoiceProductionReadinessProfileExplanation, VoiceProductionReadinessProfileSurface, VoiceProductionReadinessProofSource, VoiceProductionReadinessReport, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessTraceDeliverySummary, VoiceProductionReadinessAuditDeliveryOptions, VoiceProductionReadinessAuditDeliverySummary, VoiceProductionReadinessTraceDeliveryOptions, VoiceProductionReadinessStatus } from './productionReadiness';
 export type { VoiceReadinessProfileName, VoiceReadinessProfileOptions, VoiceReadinessProfileRecommendation, VoiceReadinessProfileRecommendationScore, VoiceReadinessProfileRoutesOptions } from './readinessProfiles';
 export type { VoiceProviderStackChoice, VoiceProviderStackCapabilities, VoiceProviderStackCapabilityGap, VoiceProviderStackCapabilityGapInput, VoiceProviderStackCapabilityGapReport, VoiceProviderContractCheck, VoiceProviderContractCheckStatus, VoiceProviderContractDefinition, VoiceProviderContractMatrixHandlerOptions, VoiceProviderContractMatrixHTMLHandlerOptions, VoiceProviderContractMatrixInput, VoiceProviderContractMatrixPresetOptions, VoiceProviderContractMatrixReport, VoiceProviderContractMatrixRoutesOptions, VoiceProviderContractMatrixRow, VoiceProviderStackInput, VoiceProviderStackKind, VoiceProviderStackRecommendation } from './providerStackRecommendations';
+export type { VoiceOperationsRecord, VoiceOperationsRecordAgentHandoff, VoiceOperationsRecordAuditSummary, VoiceOperationsRecordOptions, VoiceOperationsRecordOutcome, VoiceOperationsRecordRoutesOptions, VoiceOperationsRecordStatus, VoiceOperationsRecordTool } from './operationsRecord';
 export type { VoiceQualityLink, VoiceQualityMetric, VoiceQualityReport, VoiceQualityRoutesOptions, VoiceQualityStatus, VoiceQualityThresholds } from './qualityRoutes';
 export type { VoiceResilienceIOSimulator, VoiceResilienceLink, VoiceResiliencePageData, VoiceResilienceRoutesOptions, VoiceResilienceSimulationProvider, VoiceRoutingKindSummary, VoiceRoutingDecisionSummary, VoiceRoutingDecisionSummaryOptions, VoiceRoutingEvent, VoiceRoutingEventKind, VoiceRoutingSessionSummary, VoiceRoutingSessionSummaryOptions } from './resilienceRoutes';
 export type { VoiceIOProviderRouterEvent, VoiceIOProviderRouterOptions, VoiceIOProviderRouterPolicy, VoiceIOProviderRouterPolicyConfig, VoiceSTTProviderRouterOptions, VoiceTTSProviderRouterOptions } from './providerAdapters';

package/dist/index.js

@@ -22187,6 +22187,391 @@ var createVoiceOpsConsoleRoutes = (options) => {
   routes.get(`${path}/json`, async () => getReport());
   return routes;
 };
+// src/operationsRecord.ts
+import { Elysia as Elysia37 } from "elysia";
+
+// src/traceTimeline.ts
+import { Elysia as Elysia36 } from "elysia";
+var escapeHtml38 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var getString12 = (value) => typeof value === "string" && value.trim() ? value : undefined;
+var getNumber7 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
+var firstString3 = (payload, keys) => {
+  for (const key of keys) {
+    const value = getString12(payload[key]);
+    if (value) {
+      return value;
+    }
+  }
+  return;
+};
+var firstNumber3 = (payload, keys) => {
+  for (const key of keys) {
+    const value = getNumber7(payload[key]);
+    if (value !== undefined) {
+      return value;
+    }
+  }
+  return;
+};
+var eventProvider = (event) => firstString3(event.payload, [
+  "provider",
+  "selectedProvider",
+  "fallbackProvider",
+  "variantId"
+]);
+var eventStatus = (event) => firstString3(event.payload, [
+  "providerStatus",
+  "status",
+  "disposition",
+  "type",
+  "reason"
+]);
+var eventElapsedMs = (event) => firstNumber3(event.payload, ["elapsedMs", "latencyMs", "durationMs"]);
+var timelineLabel = (event) => {
+  switch (event.type) {
+    case "call.lifecycle":
+      return `Call ${eventStatus(event) ?? "lifecycle"}`;
+    case "turn.transcript":
+      return event.payload.isFinal === true ? "Final transcript" : "Partial transcript";
+    case "turn.committed":
+      return `Committed turn${getString12(event.payload.reason) ? ` (${getString12(event.payload.reason)})` : ""}`;
+    case "turn.assistant":
+      return "Assistant reply";
+    case "agent.model":
+      return `Model call${eventProvider(event) ? ` via ${eventProvider(event)}` : ""}`;
+    case "agent.tool":
+      return `Tool ${getString12(event.payload.toolName) ?? "call"}`;
+    case "agent.handoff":
+      return `Agent handoff${getString12(event.payload.targetAgentId) ? ` to ${getString12(event.payload.targetAgentId)}` : ""}`;
+    case "assistant.run":
+      return `Assistant run${eventProvider(event) ? ` via ${eventProvider(event)}` : ""}`;
+    case "assistant.guardrail":
+      return `Guardrail ${eventStatus(event) ?? "check"}`;
+    case "call.handoff":
+      return `Call handoff ${eventStatus(event) ?? ""}`.trim();
+    case "client.live_latency":
+      return `Live latency${eventElapsedMs(event) !== undefined ? ` ${eventElapsedMs(event)}ms` : ""}`;
+    case "session.error":
+      return `Error${getString12(event.payload.error) ? `: ${getString12(event.payload.error)}` : ""}`;
+    case "turn.cost":
+      return "Cost telemetry";
+    case "turn_latency.stage":
+      return `Latency ${getString12(event.payload.stage) ?? "stage"}`;
+    case "workflow.contract":
+      return `Workflow contract ${eventStatus(event) ?? ""}`.trim();
+    default:
+      return event.type;
+  }
+};
+var summarizeProviders = (events) => {
+  const entries = new Map;
+  const getEntry = (provider) => {
+    const existing = entries.get(provider);
+    if (existing) {
+      return existing;
+    }
+    const entry = {
+      elapsed: [],
+      errorCount: 0,
+      eventCount: 0,
+      fallbackCount: 0,
+      successCount: 0,
+      timeoutCount: 0
+    };
+    entries.set(provider, entry);
+    return entry;
+  };
+  for (const event of events) {
+    const provider = eventProvider(event);
+    if (!provider) {
+      continue;
+    }
+    const entry = getEntry(provider);
+    const status = eventStatus(event);
+    const elapsedMs = eventElapsedMs(event);
+    entry.eventCount += 1;
+    if (elapsedMs !== undefined) {
+      entry.elapsed.push(elapsedMs);
+    }
+    if (status === "success") {
+      entry.successCount += 1;
+    }
+    if (status === "fallback") {
+      entry.fallbackCount += 1;
+    }
+    if (status === "error") {
+      entry.errorCount += 1;
+    }
+    if (status === "timeout") {
+      entry.timeoutCount += 1;
+    }
+  }
+  return [...entries.entries()].map(([provider, entry]) => ({
+    averageElapsedMs: entry.elapsed.length > 0 ? Math.round(entry.elapsed.reduce((total, value) => total + value, 0) / entry.elapsed.length) : undefined,
+    errorCount: entry.errorCount,
+    eventCount: entry.eventCount,
+    fallbackCount: entry.fallbackCount,
+    maxElapsedMs: entry.elapsed.length > 0 ? Math.max(...entry.elapsed) : undefined,
+    provider,
+    successCount: entry.successCount,
+    timeoutCount: entry.timeoutCount
+  })).sort((left, right) => right.eventCount - left.eventCount);
+};
+var summarizeVoiceTraceTimeline = (events, options = {}) => {
+  const source = options.redact ? redactVoiceTraceEvents(events, options.redact) : events;
+  const grouped = new Map;
+  for (const event of filterVoiceTraceEvents(source)) {
+    grouped.set(event.sessionId, [...grouped.get(event.sessionId) ?? [], event]);
+  }
+  const sessions = [...grouped.entries()].map(([sessionId, sessionEvents]) => {
+    const sorted = filterVoiceTraceEvents(sessionEvents);
+    const summary = summarizeVoiceTrace(sorted);
+    const evaluation = evaluateVoiceTrace(sorted, options.evaluation);
+    const startedAt = summary.startedAt ?? sorted[0]?.at ?? 0;
+    const status = summary.failed ? "failed" : evaluation.issues.length > 0 ? "warning" : "healthy";
+    return {
+      endedAt: summary.endedAt,
+      evaluation,
+      events: sorted.map((event) => ({
+        at: event.at,
+        elapsedMs: eventElapsedMs(event),
+        id: event.id,
+        label: timelineLabel(event),
+        offsetMs: Math.max(0, event.at - startedAt),
+        provider: eventProvider(event),
+        status: eventStatus(event),
+        turnId: event.turnId,
+        type: event.type
+      })),
+      lastEventAt: sorted.at(-1)?.at,
+      providers: summarizeProviders(sorted),
+      sessionId,
+      startedAt: summary.startedAt,
+      status,
+      summary
+    };
+  }).sort((left, right) => (right.lastEventAt ?? 0) - (left.lastEventAt ?? 0)).slice(0, options.limit ?? 50);
+  return {
+    checkedAt: Date.now(),
+    failed: sessions.filter((session) => session.status === "failed").length,
+    sessions,
+    total: sessions.length,
+    warnings: sessions.filter((session) => session.status === "warning").length
+  };
+};
+var formatMs3 = (value) => value === undefined ? "n/a" : `${String(value)}ms`;
+var renderProviderCards2 = (session) => session.providers.length === 0 ? '<p class="muted">No provider events recorded for this session.</p>' : `<div class="providers">${session.providers.map((provider) => `<article><strong>${escapeHtml38(provider.provider)}</strong><dl><div><dt>Events</dt><dd>${String(provider.eventCount)}</dd></div><div><dt>Avg</dt><dd>${formatMs3(provider.averageElapsedMs)}</dd></div><div><dt>Max</dt><dd>${formatMs3(provider.maxElapsedMs)}</dd></div><div><dt>Errors</dt><dd>${String(provider.errorCount)}</dd></div><div><dt>Fallbacks</dt><dd>${String(provider.fallbackCount)}</dd></div><div><dt>Timeouts</dt><dd>${String(provider.timeoutCount)}</dd></div></dl></article>`).join("")}</div>`;
+var renderVoiceTraceTimelineSessionHTML = (session, options = {}) => {
+  const events = session.events.map((event) => `<tr class="${escapeHtml38(event.status ?? "")}"><td>+${String(event.offsetMs)}ms</td><td>${escapeHtml38(event.type)}</td><td>${escapeHtml38(event.label)}</td><td>${escapeHtml38(event.provider ?? "")}</td><td>${escapeHtml38(event.status ?? "")}</td><td>${formatMs3(event.elapsedMs)}</td></tr>`).join("");
+  const issues = session.evaluation.issues.length ? session.evaluation.issues.map((issue) => `<li class="${escapeHtml38(issue.severity)}">${escapeHtml38(issue.code)}: ${escapeHtml38(issue.message)}</li>`).join("") : "<li>none</li>";
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml38(options.title ?? "Voice Trace Timeline")}</title><style>${timelineCSS}</style></head><body><main><a href="/traces">Back to traces</a><header><p class="eyebrow">Call timeline</p><h1>${escapeHtml38(session.sessionId)}</h1><p class="status ${escapeHtml38(session.status)}">${escapeHtml38(session.status)}</p></header><section class="metrics"><article><span>Events</span><strong>${String(session.summary.eventCount)}</strong></article><article><span>Turns</span><strong>${String(session.summary.turnCount)}</strong></article><article><span>Errors</span><strong>${String(session.summary.errorCount)}</strong></article><article><span>Duration</span><strong>${formatMs3(session.summary.callDurationMs)}</strong></article></section><section><h2>Providers</h2>${renderProviderCards2(session)}</section><section><h2>Issues</h2><ul>${issues}</ul></section><section><h2>Timeline</h2><table><thead><tr><th>Offset</th><th>Type</th><th>Event</th><th>Provider</th><th>Status</th><th>Latency</th></tr></thead><tbody>${events}</tbody></table></section></main></body></html>`;
+};
+var renderSessionRows = (report) => report.sessions.length === 0 ? '<tr><td colspan="7">No trace events recorded yet.</td></tr>' : report.sessions.map((session) => `<tr class="${escapeHtml38(session.status)}"><td><a href="/traces/${encodeURIComponent(session.sessionId)}">${escapeHtml38(session.sessionId)}</a></td><td>${escapeHtml38(session.status)}</td><td>${String(session.summary.eventCount)}</td><td>${String(session.summary.turnCount)}</td><td>${String(session.summary.errorCount)}</td><td>${formatMs3(session.summary.callDurationMs)}</td><td>${session.providers.map((provider) => escapeHtml38(provider.provider)).join(", ")}</td></tr>`).join("");
+var timelineCSS = "body{background:#0f1318;color:#f6f2e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1180px;padding:32px}a{color:#fbbf24}.eyebrow{color:#fbbf24;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.4rem,6vw,4.5rem);line-height:.92;margin:.2rem 0 1rem}.status{border:1px solid #475569;border-radius:999px;display:inline-flex;padding:8px 12px}.healthy{color:#86efac}.warning{color:#fbbf24}.failed,.error{color:#fca5a5}.metrics,.providers{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(170px,1fr));margin:20px 0}.metrics article,.providers article{background:#181f27;border:1px solid #2b3642;border-radius:20px;padding:16px}.metrics span,dt,.muted{color:#a8b0b8}.metrics strong{display:block;font-size:2rem}dl{display:grid;gap:8px;grid-template-columns:repeat(2,minmax(0,1fr));margin:12px 0 0}dd{font-weight:800;margin:4px 0 0}table{background:#181f27;border-collapse:collapse;border-radius:18px;overflow:hidden;width:100%}td,th{border-bottom:1px solid #2b3642;padding:12px;text-align:left}section{margin-top:28px}@media(max-width:760px){main{padding:20px}table{font-size:.9rem}}";
+var renderVoiceTraceTimelineHTML = (report, options = {}) => {
+  const snippet = escapeHtml38(`const traceStore = createVoiceTraceSinkStore({
+	store: runtimeStorage.traces,
+	sinks: [
+		createVoiceTraceHTTPSink({
+			endpoint: process.env.VOICE_TRACE_WEBHOOK_URL
+		})
+	]
+});
+
+app.use(
+	createVoiceTraceTimelineRoutes({
+		htmlPath: '/traces',
+		path: '/api/voice-traces',
+		redact: {
+			keys: ['authorization', 'apiKey', 'token']
+		},
+		store: traceStore
+	})
+);
+
+app.use(
+	createVoiceProductionReadinessRoutes({
+		store: traceStore,
+		traceDeliveries: runtimeStorage.traceDeliveries
+	})
+);`);
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml38(options.title ?? "Voice Trace Timelines")}</title><style>${timelineCSS}.primitive{background:#181f27;border:1px solid #334155;border-radius:20px;margin:20px 0;padding:18px}.primitive p{line-height:1.55}.primitive pre{background:#0b1118;border:1px solid #2b3642;border-radius:16px;color:#dbeafe;overflow:auto;padding:14px}.primitive code{color:#bfdbfe}</style></head><body><main><header><p class="eyebrow">Self-hosted voice debugging</p><h1>${escapeHtml38(options.title ?? "Voice Trace Timelines")}</h1><p class="muted">Per-call event timelines with provider latency, fallback, timeout, handoff, and error context.</p></header><section class="metrics"><article><span>Sessions</span><strong>${String(report.total)}</strong></article><article><span>Failed</span><strong>${String(report.failed)}</strong></article><article><span>Warnings</span><strong>${String(report.warnings)}</strong></article></section><section class="primitive"><p class="eyebrow">Copy into your app</p><h2><code>createVoiceTraceTimelineRoutes(...)</code> makes traces the proof backbone</h2><p class="muted">Mount trace timelines from the same trace store used by readiness, simulations, provider recovery, delivery sinks, and phone-agent smoke proof.</p><pre><code>${snippet}</code></pre></section><table><thead><tr><th>Session</th><th>Status</th><th>Events</th><th>Turns</th><th>Errors</th><th>Duration</th><th>Providers</th></tr></thead><tbody>${renderSessionRows(report)}</tbody></table></main></body></html>`;
+};
+var createVoiceTraceTimelineRoutes = (options) => {
+  const path = options.path ?? "/api/voice-traces";
+  const htmlPath = options.htmlPath ?? "/traces";
+  const title = options.title ?? "AbsoluteJS Voice Trace Timelines";
+  const routes = new Elysia36({
+    name: options.name ?? "absolutejs-voice-trace-timelines"
+  });
+  const buildReport = async () => summarizeVoiceTraceTimeline(await options.store.list(), {
+    evaluation: options.evaluation,
+    limit: options.limit,
+    redact: options.redact
+  });
+  const findSession = async (sessionId) => {
+    const report = summarizeVoiceTraceTimeline(await options.store.list({ sessionId }), {
+      evaluation: options.evaluation,
+      limit: 1,
+      redact: options.redact
+    });
+    return report.sessions[0];
+  };
+  routes.get(path, async () => Response.json(await buildReport()));
+  routes.get(`${path}/:sessionId`, async ({ params }) => {
+    const session = await findSession(params.sessionId);
+    return session ? Response.json(session) : Response.json({ error: "Voice trace session not found." }, { status: 404 });
+  });
+  routes.get(htmlPath, async () => {
+    const report = await buildReport();
+    const body = await (options.render ?? ((input) => renderVoiceTraceTimelineHTML(input, { title })))(report);
+    return new Response(body, {
+      headers: {
+        "Content-Type": "text/html; charset=utf-8",
+        ...options.headers
+      }
+    });
+  });
+  routes.get(`${htmlPath}/:sessionId`, async ({ params }) => {
+    const session = await findSession(params.sessionId);
+    if (!session) {
+      return Response.json({ error: "Voice trace session not found." }, { status: 404 });
+    }
+    const body = await (options.renderSession ?? ((input) => renderVoiceTraceTimelineSessionHTML(input, { title })))(session);
+    return new Response(body, {
+      headers: {
+        "Content-Type": "text/html; charset=utf-8",
+        ...options.headers
+      }
+    });
+  });
+  return routes;
+};
+
+// src/operationsRecord.ts
+var getString13 = (value) => typeof value === "string" ? value : undefined;
+var getNumber8 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
+var countOutcome = (events, outcome) => events.filter((event) => event.outcome === outcome).length;
+var toHandoff = (event) => ({
+  at: event.at,
+  fromAgentId: getString13(event.payload.fromAgentId),
+  metadata: event.payload.metadata && typeof event.payload.metadata === "object" && !Array.isArray(event.payload.metadata) ? event.payload.metadata : undefined,
+  reason: getString13(event.payload.reason),
+  status: getString13(event.payload.status),
+  summary: getString13(event.payload.summary),
+  targetAgentId: getString13(event.payload.targetAgentId),
+  turnId: event.turnId
+});
+var toTool = (event) => ({
+  at: event.at,
+  elapsedMs: getNumber8(event.payload.elapsedMs),
+  error: getString13(event.payload.error),
+  status: getString13(event.payload.status),
+  toolCallId: getString13(event.payload.toolCallId),
+  toolName: getString13(event.payload.toolName),
+  turnId: event.turnId
+});
+var resolveOutcome4 = (events) => {
+  const agentResults = events.filter((event) => event.type === "agent.result");
+  return {
+    assistantReplies: events.filter((event) => event.type === "turn.assistant").length,
+    complete: agentResults.some((event) => event.payload.complete === true),
+    escalated: agentResults.some((event) => event.payload.escalated === true),
+    noAnswer: agentResults.some((event) => event.payload.noAnswer === true),
+    transferred: agentResults.some((event) => event.payload.transferred === true),
+    voicemail: agentResults.some((event) => event.payload.voicemail === true)
+  };
+};
+var buildVoiceOperationsRecord = async (options) => {
+  const sourceEvents = options.events ?? await options.store?.list({ sessionId: options.sessionId }) ?? [];
+  const traceEvents = filterVoiceTraceEvents(sourceEvents, {
+    sessionId: options.sessionId
+  });
+  const timelineReport = summarizeVoiceTraceTimeline(traceEvents, {
+    evaluation: options.evaluation,
+    limit: 1,
+    redact: options.redact
+  });
+  const timelineSession = timelineReport.sessions[0];
+  const replay = await summarizeVoiceSessionReplay({
+    evaluation: options.evaluation,
+    events: traceEvents,
+    redact: options.redact,
+    sessionId: options.sessionId
+  });
+  const auditEvents = options.audit ? filterVoiceAuditEvents(await options.audit.list({ sessionId: options.sessionId })) : undefined;
+  return {
+    audit: auditEvents ? {
+      error: countOutcome(auditEvents, "error"),
+      events: auditEvents,
+      skipped: countOutcome(auditEvents, "skipped"),
+      success: countOutcome(auditEvents, "success"),
+      total: auditEvents.length
+    } : undefined,
+    checkedAt: Date.now(),
+    handoffs: traceEvents.filter((event) => event.type === "agent.handoff").map(toHandoff),
+    outcome: resolveOutcome4(traceEvents),
+    providers: timelineSession?.providers ?? [],
+    replay,
+    sessionId: options.sessionId,
+    status: timelineSession?.status ?? "healthy",
+    summary: timelineSession?.summary ?? replay.summary,
+    timeline: timelineSession?.events ?? [],
+    tools: traceEvents.filter((event) => event.type === "agent.tool").map(toTool),
+    traceEvents
+  };
+};
+var escapeHtml39 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var formatMs4 = (value) => value === undefined ? "n/a" : `${String(value)}ms`;
+var renderVoiceOperationsRecordHTML = (record, options = {}) => {
+  const providers = record.providers.length ? record.providers.map((provider) => `<article><strong>${escapeHtml39(provider.provider)}</strong><span>${String(provider.eventCount)} events</span><span>${formatMs4(provider.averageElapsedMs)} avg</span><span>${String(provider.errorCount)} errors</span></article>`).join("") : '<p class="muted">No provider events recorded.</p>';
+  const handoffs = record.handoffs.length ? record.handoffs.map((handoff) => `<li><strong>${escapeHtml39(handoff.fromAgentId ?? "unknown")}</strong> to <strong>${escapeHtml39(handoff.targetAgentId ?? "unknown")}</strong> <span>${escapeHtml39(handoff.status ?? "")}</span><p>${escapeHtml39(handoff.summary ?? handoff.reason ?? "")}</p></li>`).join("") : "<li>No agent handoffs recorded.</li>";
+  const tools = record.tools.length ? record.tools.map((tool) => `<li><strong>${escapeHtml39(tool.toolName ?? "tool")}</strong> <span>${escapeHtml39(tool.status ?? "")}</span> ${formatMs4(tool.elapsedMs)} ${tool.error ? `<p>${escapeHtml39(tool.error)}</p>` : ""}</li>`).join("") : "<li>No tool calls recorded.</li>";
+  const snippet = escapeHtml39(`app.use(
+	createVoiceOperationsRecordRoutes({
+		audit: auditStore,
+		htmlPath: '/voice-ops/:sessionId',
+		path: '/api/voice-ops/:sessionId',
+		redact: {
+			keys: ['authorization', 'apiKey', 'token']
+		},
+		store: traceStore
+	})
+);`);
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml39(options.title ?? "Voice Operations Record")}</title><style>body{background:#101417;color:#f9f4e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1120px;padding:32px}.eyebrow{color:#fbbf24;font-size:.8rem;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 #475569;border-radius:999px;display:inline-flex;padding:8px 12px}.healthy{color:#86efac}.warning{color:#fbbf24}.failed,.error{color:#fca5a5}.grid{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));margin:20px 0}.card,.primitive{background:#182025;border:1px solid #2d3a43;border-radius:20px;padding:16px}.card span,.muted{color:#a9b4bd}.card strong{display:block;font-size:2rem}section{margin-top:28px}article{display:grid;gap:8px}ul{display:grid;gap:10px;list-style:none;padding:0}li{background:#182025;border:1px solid #2d3a43;border-radius:16px;padding:14px}pre{background:#080d10;border:1px solid #2d3a43;border-radius:16px;color:#dbeafe;overflow:auto;padding:14px}</style></head><body><main><p class="eyebrow">Portable production proof</p><h1>${escapeHtml39(options.title ?? "Voice Operations Record")}</h1><p class="status ${escapeHtml39(record.status)}">${escapeHtml39(record.status)}</p><section class="grid"><div class="card"><span>Events</span><strong>${String(record.summary.eventCount)}</strong></div><div class="card"><span>Turns</span><strong>${String(record.summary.turnCount)}</strong></div><div class="card"><span>Errors</span><strong>${String(record.summary.errorCount)}</strong></div><div class="card"><span>Duration</span><strong>${formatMs4(record.summary.callDurationMs)}</strong></div><div class="card"><span>Audit</span><strong>${String(record.audit?.total ?? 0)}</strong></div></section><section class="primitive"><p class="eyebrow">Copy into your app</p><h2><code>createVoiceOperationsRecordRoutes(...)</code> gives every call one debuggable object</h2><p class="muted">Use this as the support/debug payload across traces, provider routing, tools, handoffs, audit, latency, and replay.</p><pre><code>${snippet}</code></pre></section><section><h2>Providers</h2><div class="grid">${providers}</div></section><section><h2>Handoffs</h2><ul>${handoffs}</ul></section><section><h2>Tools</h2><ul>${tools}</ul></section></main></body></html>`;
+};
+var createVoiceOperationsRecordRoutes = (options) => {
+  const path = options.path ?? "/api/voice-operations/:sessionId";
+  const htmlPath = options.htmlPath === undefined ? "/voice-operations/:sessionId" : options.htmlPath;
+  const routes = new Elysia37({
+    name: options.name ?? "absolutejs-voice-operations-record"
+  });
+  const buildRecord = (sessionId) => buildVoiceOperationsRecord({
+    audit: options.audit,
+    evaluation: options.evaluation,
+    events: options.events,
+    redact: options.redact,
+    sessionId,
+    store: options.store
+  });
+  const getSessionId = (params) => params.sessionId ?? "";
+  routes.get(path, async ({ params }) => Response.json(await buildRecord(getSessionId(params))));
+  if (htmlPath) {
+    routes.get(htmlPath, async ({ params }) => {
+      const record = await buildRecord(getSessionId(params));
+      const body = await (options.render ?? ((input) => renderVoiceOperationsRecordHTML(input, {
+        title: options.title
+      })))(record);
+      return new Response(body, {
+        headers: {
+          "Content-Type": "text/html; charset=utf-8",
+          ...options.headers
+        }
+      });
+    });
+  }
+  return routes;
+};
 // src/opsStatus.ts
 var DEFAULT_LINKS2 = [
   {
@@ -22359,19 +22744,19 @@ var summarizeVoiceOpsStatus = async (options) => {
   };
 };
 // src/opsStatusRoutes.ts
-import { Elysia as Elysia36 } from "elysia";
-var escapeHtml38 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+import { Elysia as Elysia38 } from "elysia";
+var escapeHtml40 = (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 ${escapeHtml38(surface.status)}"><span>${escapeHtml38(surface.status.toUpperCase())}</span><h2>${escapeHtml38(key)}</h2><strong>${escapeHtml38(value)}</strong></article>`;
+    return `<article class="surface ${escapeHtml40(surface.status)}"><span>${escapeHtml40(surface.status.toUpperCase())}</span><h2>${escapeHtml40(key)}</h2><strong>${escapeHtml40(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>${escapeHtml38(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>${escapeHtml38(title)}</h1><p>Compact pass/fail status for framework widgets, demos, and small customer-facing health badges.</p><p class="status ${escapeHtml38(report.status)}">Overall: ${escapeHtml38(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>${escapeHtml40(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>${escapeHtml40(title)}</h1><p>Compact pass/fail status for framework widgets, demos, and small customer-facing health badges.</p><p class="status ${escapeHtml40(report.status)}">Overall: ${escapeHtml40(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 Elysia36({
+  const routes = new Elysia38({
     name: options.name ?? "absolutejs-voice-ops-status"
   });
   routes.get(path, async () => summarizeVoiceOpsStatus(options));
@@ -22804,10 +23189,10 @@ var createVoiceTTSProviderRouter = (options) => {
   };
 };
 // src/traceDeliveryRoutes.ts
-import { Elysia as Elysia37 } from "elysia";
-var escapeHtml39 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var getString12 = (value) => typeof value === "string" && value.trim() ? value.trim() : undefined;
-var getNumber7 = (value) => {
+import { Elysia as Elysia39 } from "elysia";
+var escapeHtml41 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var getString14 = (value) => typeof value === "string" && value.trim() ? value.trim() : undefined;
+var getNumber9 = (value) => {
   if (typeof value === "number" && Number.isFinite(value)) {
     return value;
   }
@@ -22818,13 +23203,13 @@ var getNumber7 = (value) => {
   return;
 };
 var parseStatus2 = (value) => {
-  const text = getString12(value);
+  const text = getString14(value);
   return text === "pending" || text === "delivered" || text === "failed" || text === "skipped" || text === "all" ? text : undefined;
 };
 var resolveVoiceTraceDeliveryFilter = (query = {}, base = {}) => ({
   ...base,
-  limit: getNumber7(query.limit) ?? base.limit,
-  q: getString12(query.q) ?? base.q,
+  limit: getNumber9(query.limit) ?? base.limit,
+  q: getString14(query.q) ?? base.q,
   status: parseStatus2(query.status) ?? base.status
 });
 var deliverySearchText2 = (delivery) => [
@@ -22886,14 +23271,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>${escapeHtml39(sinkId)}</strong>: ${escapeHtml39(result.status)}${result.deliveredTo ? ` to ${escapeHtml39(result.deliveredTo)}` : ""}${result.error ? ` (${escapeHtml39(result.error)})` : ""}</li>`).join("")}</ul>`;
+  return `<ul>${entries.map(([sinkId, result]) => `<li><strong>${escapeHtml41(sinkId)}</strong>: ${escapeHtml41(result.status)}${result.deliveredTo ? ` to ${escapeHtml41(result.deliveredTo)}` : ""}${result.error ? ` (${escapeHtml41(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>${escapeHtml39(event.type)} <small>${escapeHtml39(event.id)}</small>${event.sessionId ? ` session=${escapeHtml39(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>${escapeHtml41(event.type)} <small>${escapeHtml41(event.id)}</small>${event.sessionId ? ` session=${escapeHtml41(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="${escapeHtml39(options.workerPath ?? "/api/voice-trace-deliveries/drain")}"><button type="submit">Drain trace deliveries</button></form>`;
-  const rows = report.deliveries.map((delivery) => `<article class="delivery ${escapeHtml39(delivery.deliveryStatus)}"><div class="head"><div><span>${escapeHtml39(delivery.deliveryStatus)}</span><h2>${escapeHtml39(delivery.id)}</h2><p>${escapeHtml39(new Date(delivery.createdAt).toLocaleString())}${delivery.deliveredAt ? ` \xB7 delivered ${escapeHtml39(new Date(delivery.deliveredAt).toLocaleString())}` : ""}</p></div><strong>${String(delivery.deliveryAttempts ?? 0)} attempt(s)</strong></div>${delivery.deliveryError ? `<p class="error">${escapeHtml39(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>${escapeHtml39(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>${escapeHtml39(title)}</h1><p>Checked ${escapeHtml39(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="${escapeHtml41(options.workerPath ?? "/api/voice-trace-deliveries/drain")}"><button type="submit">Drain trace deliveries</button></form>`;
+  const rows = report.deliveries.map((delivery) => `<article class="delivery ${escapeHtml41(delivery.deliveryStatus)}"><div class="head"><div><span>${escapeHtml41(delivery.deliveryStatus)}</span><h2>${escapeHtml41(delivery.id)}</h2><p>${escapeHtml41(new Date(delivery.createdAt).toLocaleString())}${delivery.deliveredAt ? ` \xB7 delivered ${escapeHtml41(new Date(delivery.deliveredAt).toLocaleString())}` : ""}</p></div><strong>${String(delivery.deliveryAttempts ?? 0)} attempt(s)</strong></div>${delivery.deliveryError ? `<p class="error">${escapeHtml41(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>${escapeHtml41(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>${escapeHtml41(title)}</h1><p>Checked ${escapeHtml41(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 }) => {
@@ -22913,7 +23298,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 Elysia37({
+  const routes = new Elysia39({
     name: options.name ?? "absolutejs-voice-trace-deliveries"
   }).get(path, createVoiceTraceDeliveryJSONHandler(options));
   if (htmlPath !== false) {
@@ -22930,263 +23315,6 @@ var createVoiceTraceDeliveryRoutes = (options) => {
   }
   return routes;
 };
-// src/traceTimeline.ts
-import { Elysia as Elysia38 } from "elysia";
-var escapeHtml40 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var getString13 = (value) => typeof value === "string" && value.trim() ? value : undefined;
-var getNumber8 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
-var firstString3 = (payload, keys) => {
-  for (const key of keys) {
-    const value = getString13(payload[key]);
-    if (value) {
-      return value;
-    }
-  }
-  return;
-};
-var firstNumber3 = (payload, keys) => {
-  for (const key of keys) {
-    const value = getNumber8(payload[key]);
-    if (value !== undefined) {
-      return value;
-    }
-  }
-  return;
-};
-var eventProvider = (event) => firstString3(event.payload, [
-  "provider",
-  "selectedProvider",
-  "fallbackProvider",
-  "variantId"
-]);
-var eventStatus = (event) => firstString3(event.payload, [
-  "providerStatus",
-  "status",
-  "disposition",
-  "type",
-  "reason"
-]);
-var eventElapsedMs = (event) => firstNumber3(event.payload, ["elapsedMs", "latencyMs", "durationMs"]);
-var timelineLabel = (event) => {
-  switch (event.type) {
-    case "call.lifecycle":
-      return `Call ${eventStatus(event) ?? "lifecycle"}`;
-    case "turn.transcript":
-      return event.payload.isFinal === true ? "Final transcript" : "Partial transcript";
-    case "turn.committed":
-      return `Committed turn${getString13(event.payload.reason) ? ` (${getString13(event.payload.reason)})` : ""}`;
-    case "turn.assistant":
-      return "Assistant reply";
-    case "agent.model":
-      return `Model call${eventProvider(event) ? ` via ${eventProvider(event)}` : ""}`;
-    case "agent.tool":
-      return `Tool ${getString13(event.payload.toolName) ?? "call"}`;
-    case "agent.handoff":
-      return `Agent handoff${getString13(event.payload.targetAgentId) ? ` to ${getString13(event.payload.targetAgentId)}` : ""}`;
-    case "assistant.run":
-      return `Assistant run${eventProvider(event) ? ` via ${eventProvider(event)}` : ""}`;
-    case "assistant.guardrail":
-      return `Guardrail ${eventStatus(event) ?? "check"}`;
-    case "call.handoff":
-      return `Call handoff ${eventStatus(event) ?? ""}`.trim();
-    case "client.live_latency":
-      return `Live latency${eventElapsedMs(event) !== undefined ? ` ${eventElapsedMs(event)}ms` : ""}`;
-    case "session.error":
-      return `Error${getString13(event.payload.error) ? `: ${getString13(event.payload.error)}` : ""}`;
-    case "turn.cost":
-      return "Cost telemetry";
-    case "turn_latency.stage":
-      return `Latency ${getString13(event.payload.stage) ?? "stage"}`;
-    case "workflow.contract":
-      return `Workflow contract ${eventStatus(event) ?? ""}`.trim();
-    default:
-      return event.type;
-  }
-};
-var summarizeProviders = (events) => {
-  const entries = new Map;
-  const getEntry = (provider) => {
-    const existing = entries.get(provider);
-    if (existing) {
-      return existing;
-    }
-    const entry = {
-      elapsed: [],
-      errorCount: 0,
-      eventCount: 0,
-      fallbackCount: 0,
-      successCount: 0,
-      timeoutCount: 0
-    };
-    entries.set(provider, entry);
-    return entry;
-  };
-  for (const event of events) {
-    const provider = eventProvider(event);
-    if (!provider) {
-      continue;
-    }
-    const entry = getEntry(provider);
-    const status = eventStatus(event);
-    const elapsedMs = eventElapsedMs(event);
-    entry.eventCount += 1;
-    if (elapsedMs !== undefined) {
-      entry.elapsed.push(elapsedMs);
-    }
-    if (status === "success") {
-      entry.successCount += 1;
-    }
-    if (status === "fallback") {
-      entry.fallbackCount += 1;
-    }
-    if (status === "error") {
-      entry.errorCount += 1;
-    }
-    if (status === "timeout") {
-      entry.timeoutCount += 1;
-    }
-  }
-  return [...entries.entries()].map(([provider, entry]) => ({
-    averageElapsedMs: entry.elapsed.length > 0 ? Math.round(entry.elapsed.reduce((total, value) => total + value, 0) / entry.elapsed.length) : undefined,
-    errorCount: entry.errorCount,
-    eventCount: entry.eventCount,
-    fallbackCount: entry.fallbackCount,
-    maxElapsedMs: entry.elapsed.length > 0 ? Math.max(...entry.elapsed) : undefined,
-    provider,
-    successCount: entry.successCount,
-    timeoutCount: entry.timeoutCount
-  })).sort((left, right) => right.eventCount - left.eventCount);
-};
-var summarizeVoiceTraceTimeline = (events, options = {}) => {
-  const source = options.redact ? redactVoiceTraceEvents(events, options.redact) : events;
-  const grouped = new Map;
-  for (const event of filterVoiceTraceEvents(source)) {
-    grouped.set(event.sessionId, [...grouped.get(event.sessionId) ?? [], event]);
-  }
-  const sessions = [...grouped.entries()].map(([sessionId, sessionEvents]) => {
-    const sorted = filterVoiceTraceEvents(sessionEvents);
-    const summary = summarizeVoiceTrace(sorted);
-    const evaluation = evaluateVoiceTrace(sorted, options.evaluation);
-    const startedAt = summary.startedAt ?? sorted[0]?.at ?? 0;
-    const status = summary.failed ? "failed" : evaluation.issues.length > 0 ? "warning" : "healthy";
-    return {
-      endedAt: summary.endedAt,
-      evaluation,
-      events: sorted.map((event) => ({
-        at: event.at,
-        elapsedMs: eventElapsedMs(event),
-        id: event.id,
-        label: timelineLabel(event),
-        offsetMs: Math.max(0, event.at - startedAt),
-        provider: eventProvider(event),
-        status: eventStatus(event),
-        turnId: event.turnId,
-        type: event.type
-      })),
-      lastEventAt: sorted.at(-1)?.at,
-      providers: summarizeProviders(sorted),
-      sessionId,
-      startedAt: summary.startedAt,
-      status,
-      summary
-    };
-  }).sort((left, right) => (right.lastEventAt ?? 0) - (left.lastEventAt ?? 0)).slice(0, options.limit ?? 50);
-  return {
-    checkedAt: Date.now(),
-    failed: sessions.filter((session) => session.status === "failed").length,
-    sessions,
-    total: sessions.length,
-    warnings: sessions.filter((session) => session.status === "warning").length
-  };
-};
-var formatMs3 = (value) => value === undefined ? "n/a" : `${String(value)}ms`;
-var renderProviderCards2 = (session) => session.providers.length === 0 ? '<p class="muted">No provider events recorded for this session.</p>' : `<div class="providers">${session.providers.map((provider) => `<article><strong>${escapeHtml40(provider.provider)}</strong><dl><div><dt>Events</dt><dd>${String(provider.eventCount)}</dd></div><div><dt>Avg</dt><dd>${formatMs3(provider.averageElapsedMs)}</dd></div><div><dt>Max</dt><dd>${formatMs3(provider.maxElapsedMs)}</dd></div><div><dt>Errors</dt><dd>${String(provider.errorCount)}</dd></div><div><dt>Fallbacks</dt><dd>${String(provider.fallbackCount)}</dd></div><div><dt>Timeouts</dt><dd>${String(provider.timeoutCount)}</dd></div></dl></article>`).join("")}</div>`;
-var renderVoiceTraceTimelineSessionHTML = (session, options = {}) => {
-  const events = session.events.map((event) => `<tr class="${escapeHtml40(event.status ?? "")}"><td>+${String(event.offsetMs)}ms</td><td>${escapeHtml40(event.type)}</td><td>${escapeHtml40(event.label)}</td><td>${escapeHtml40(event.provider ?? "")}</td><td>${escapeHtml40(event.status ?? "")}</td><td>${formatMs3(event.elapsedMs)}</td></tr>`).join("");
-  const issues = session.evaluation.issues.length ? session.evaluation.issues.map((issue) => `<li class="${escapeHtml40(issue.severity)}">${escapeHtml40(issue.code)}: ${escapeHtml40(issue.message)}</li>`).join("") : "<li>none</li>";
-  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml40(options.title ?? "Voice Trace Timeline")}</title><style>${timelineCSS}</style></head><body><main><a href="/traces">Back to traces</a><header><p class="eyebrow">Call timeline</p><h1>${escapeHtml40(session.sessionId)}</h1><p class="status ${escapeHtml40(session.status)}">${escapeHtml40(session.status)}</p></header><section class="metrics"><article><span>Events</span><strong>${String(session.summary.eventCount)}</strong></article><article><span>Turns</span><strong>${String(session.summary.turnCount)}</strong></article><article><span>Errors</span><strong>${String(session.summary.errorCount)}</strong></article><article><span>Duration</span><strong>${formatMs3(session.summary.callDurationMs)}</strong></article></section><section><h2>Providers</h2>${renderProviderCards2(session)}</section><section><h2>Issues</h2><ul>${issues}</ul></section><section><h2>Timeline</h2><table><thead><tr><th>Offset</th><th>Type</th><th>Event</th><th>Provider</th><th>Status</th><th>Latency</th></tr></thead><tbody>${events}</tbody></table></section></main></body></html>`;
-};
-var renderSessionRows = (report) => report.sessions.length === 0 ? '<tr><td colspan="7">No trace events recorded yet.</td></tr>' : report.sessions.map((session) => `<tr class="${escapeHtml40(session.status)}"><td><a href="/traces/${encodeURIComponent(session.sessionId)}">${escapeHtml40(session.sessionId)}</a></td><td>${escapeHtml40(session.status)}</td><td>${String(session.summary.eventCount)}</td><td>${String(session.summary.turnCount)}</td><td>${String(session.summary.errorCount)}</td><td>${formatMs3(session.summary.callDurationMs)}</td><td>${session.providers.map((provider) => escapeHtml40(provider.provider)).join(", ")}</td></tr>`).join("");
-var timelineCSS = "body{background:#0f1318;color:#f6f2e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1180px;padding:32px}a{color:#fbbf24}.eyebrow{color:#fbbf24;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.4rem,6vw,4.5rem);line-height:.92;margin:.2rem 0 1rem}.status{border:1px solid #475569;border-radius:999px;display:inline-flex;padding:8px 12px}.healthy{color:#86efac}.warning{color:#fbbf24}.failed,.error{color:#fca5a5}.metrics,.providers{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(170px,1fr));margin:20px 0}.metrics article,.providers article{background:#181f27;border:1px solid #2b3642;border-radius:20px;padding:16px}.metrics span,dt,.muted{color:#a8b0b8}.metrics strong{display:block;font-size:2rem}dl{display:grid;gap:8px;grid-template-columns:repeat(2,minmax(0,1fr));margin:12px 0 0}dd{font-weight:800;margin:4px 0 0}table{background:#181f27;border-collapse:collapse;border-radius:18px;overflow:hidden;width:100%}td,th{border-bottom:1px solid #2b3642;padding:12px;text-align:left}section{margin-top:28px}@media(max-width:760px){main{padding:20px}table{font-size:.9rem}}";
-var renderVoiceTraceTimelineHTML = (report, options = {}) => {
-  const snippet = escapeHtml40(`const traceStore = createVoiceTraceSinkStore({
-	store: runtimeStorage.traces,
-	sinks: [
-		createVoiceTraceHTTPSink({
-			endpoint: process.env.VOICE_TRACE_WEBHOOK_URL
-		})
-	]
-});
-
-app.use(
-	createVoiceTraceTimelineRoutes({
-		htmlPath: '/traces',
-		path: '/api/voice-traces',
-		redact: {
-			keys: ['authorization', 'apiKey', 'token']
-		},
-		store: traceStore
-	})
-);
-
-app.use(
-	createVoiceProductionReadinessRoutes({
-		store: traceStore,
-		traceDeliveries: runtimeStorage.traceDeliveries
-	})
-);`);
-  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml40(options.title ?? "Voice Trace Timelines")}</title><style>${timelineCSS}.primitive{background:#181f27;border:1px solid #334155;border-radius:20px;margin:20px 0;padding:18px}.primitive p{line-height:1.55}.primitive pre{background:#0b1118;border:1px solid #2b3642;border-radius:16px;color:#dbeafe;overflow:auto;padding:14px}.primitive code{color:#bfdbfe}</style></head><body><main><header><p class="eyebrow">Self-hosted voice debugging</p><h1>${escapeHtml40(options.title ?? "Voice Trace Timelines")}</h1><p class="muted">Per-call event timelines with provider latency, fallback, timeout, handoff, and error context.</p></header><section class="metrics"><article><span>Sessions</span><strong>${String(report.total)}</strong></article><article><span>Failed</span><strong>${String(report.failed)}</strong></article><article><span>Warnings</span><strong>${String(report.warnings)}</strong></article></section><section class="primitive"><p class="eyebrow">Copy into your app</p><h2><code>createVoiceTraceTimelineRoutes(...)</code> makes traces the proof backbone</h2><p class="muted">Mount trace timelines from the same trace store used by readiness, simulations, provider recovery, delivery sinks, and phone-agent smoke proof.</p><pre><code>${snippet}</code></pre></section><table><thead><tr><th>Session</th><th>Status</th><th>Events</th><th>Turns</th><th>Errors</th><th>Duration</th><th>Providers</th></tr></thead><tbody>${renderSessionRows(report)}</tbody></table></main></body></html>`;
-};
-var createVoiceTraceTimelineRoutes = (options) => {
-  const path = options.path ?? "/api/voice-traces";
-  const htmlPath = options.htmlPath ?? "/traces";
-  const title = options.title ?? "AbsoluteJS Voice Trace Timelines";
-  const routes = new Elysia38({
-    name: options.name ?? "absolutejs-voice-trace-timelines"
-  });
-  const buildReport = async () => summarizeVoiceTraceTimeline(await options.store.list(), {
-    evaluation: options.evaluation,
-    limit: options.limit,
-    redact: options.redact
-  });
-  const findSession = async (sessionId) => {
-    const report = summarizeVoiceTraceTimeline(await options.store.list({ sessionId }), {
-      evaluation: options.evaluation,
-      limit: 1,
-      redact: options.redact
-    });
-    return report.sessions[0];
-  };
-  routes.get(path, async () => Response.json(await buildReport()));
-  routes.get(`${path}/:sessionId`, async ({ params }) => {
-    const session = await findSession(params.sessionId);
-    return session ? Response.json(session) : Response.json({ error: "Voice trace session not found." }, { status: 404 });
-  });
-  routes.get(htmlPath, async () => {
-    const report = await buildReport();
-    const body = await (options.render ?? ((input) => renderVoiceTraceTimelineHTML(input, { title })))(report);
-    return new Response(body, {
-      headers: {
-        "Content-Type": "text/html; charset=utf-8",
-        ...options.headers
-      }
-    });
-  });
-  routes.get(`${htmlPath}/:sessionId`, async ({ params }) => {
-    const session = await findSession(params.sessionId);
-    if (!session) {
-      return Response.json({ error: "Voice trace session not found." }, { status: 404 });
-    }
-    const body = await (options.renderSession ?? ((input) => renderVoiceTraceTimelineSessionHTML(input, { title })))(session);
-    return new Response(body, {
-      headers: {
-        "Content-Type": "text/html; charset=utf-8",
-        ...options.headers
-      }
-    });
-  });
-  return routes;
-};
 // src/sqliteStore.ts
 import { Database } from "bun:sqlite";
 var normalizeTableNameSegment = (value) => value.trim().replace(/[^a-zA-Z0-9_]+/g, "_").replace(/^_+|_+$/g, "") || "voice";
@@ -23794,7 +23922,7 @@ var createVoiceMemoryStore = () => {
   return { get, getOrCreate, list, remove, set };
 };
 // src/opsWebhook.ts
-import { Elysia as Elysia39 } from "elysia";
+import { Elysia as Elysia40 } from "elysia";
 var toHex6 = (bytes) => Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
 var signVoiceOpsWebhookBody = async (input) => {
   const encoder = new TextEncoder;
@@ -23924,7 +24052,7 @@ var verifyVoiceOpsWebhookSignature = async (input) => {
 };
 var createVoiceOpsWebhookReceiverRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice-ops/webhook";
-  return new Elysia39().post(path, async ({ body, request, set }) => {
+  return new Elysia40().post(path, async ({ body, request, set }) => {
     const bodyText = typeof body === "string" ? body : JSON.stringify(body);
     if (options.signingSecret) {
       const verification = await verifyVoiceOpsWebhookSignature({
@@ -24866,6 +24994,7 @@ export {
   renderVoiceOpsStatusHTML,
   renderVoiceOpsConsoleHTML,
   renderVoiceOpsActionHistoryHTML,
+  renderVoiceOperationsRecordHTML,
   renderVoiceLiveLatencyHTML,
   renderVoiceHandoffHealthHTML,
   renderVoiceEvalHTML,
@@ -25054,6 +25183,7 @@ export {
   createVoiceOpsRuntime,
   createVoiceOpsConsoleRoutes,
   createVoiceOpsActionAuditRoutes,
+  createVoiceOperationsRecordRoutes,
   createVoiceMemoryTraceSinkDeliveryStore,
   createVoiceMemoryTraceEventStore,
   createVoiceMemoryStore,
@@ -25178,6 +25308,7 @@ export {
   buildVoiceOpsTaskFromReview,
   buildVoiceOpsConsoleReport,
   buildVoiceOpsActionHistoryReport,
+  buildVoiceOperationsRecord,
   buildVoiceDiagnosticsMarkdown,
   buildVoiceDemoReadyReport,
   buildVoiceDeliverySinkReport,

package/dist/operationsRecord.d.ts

@@ -0,0 +1,102 @@
+import { Elysia } from 'elysia';
+import { type StoredVoiceAuditEvent, type VoiceAuditEventStore } from './audit';
+import { type VoiceSessionReplay } from './sessionReplay';
+import { type VoiceTraceTimelineEvent, type VoiceTraceTimelineProviderSummary } from './traceTimeline';
+import { type StoredVoiceTraceEvent, type VoiceTraceEvaluationOptions, type VoiceTraceEventStore, type VoiceTraceRedactionConfig, type VoiceTraceSummary } from './trace';
+export type VoiceOperationsRecordStatus = 'failed' | 'healthy' | 'warning';
+export type VoiceOperationsRecordOutcome = {
+    assistantReplies: number;
+    complete: boolean;
+    escalated: boolean;
+    noAnswer: boolean;
+    transferred: boolean;
+    voicemail: boolean;
+};
+export type VoiceOperationsRecordAgentHandoff = {
+    at: number;
+    fromAgentId?: string;
+    metadata?: Record<string, unknown>;
+    reason?: string;
+    status?: string;
+    summary?: string;
+    targetAgentId?: string;
+    turnId?: string;
+};
+export type VoiceOperationsRecordTool = {
+    at: number;
+    elapsedMs?: number;
+    error?: string;
+    status?: string;
+    toolCallId?: string;
+    toolName?: string;
+    turnId?: string;
+};
+export type VoiceOperationsRecordAuditSummary = {
+    error: number;
+    events: StoredVoiceAuditEvent[];
+    skipped: number;
+    success: number;
+    total: number;
+};
+export type VoiceOperationsRecord = {
+    audit?: VoiceOperationsRecordAuditSummary;
+    checkedAt: number;
+    handoffs: VoiceOperationsRecordAgentHandoff[];
+    outcome: VoiceOperationsRecordOutcome;
+    providers: VoiceTraceTimelineProviderSummary[];
+    replay: VoiceSessionReplay;
+    sessionId: string;
+    status: VoiceOperationsRecordStatus;
+    summary: VoiceTraceSummary;
+    timeline: VoiceTraceTimelineEvent[];
+    tools: VoiceOperationsRecordTool[];
+    traceEvents: StoredVoiceTraceEvent[];
+};
+export type VoiceOperationsRecordOptions = {
+    audit?: VoiceAuditEventStore;
+    evaluation?: VoiceTraceEvaluationOptions;
+    events?: StoredVoiceTraceEvent[];
+    redact?: VoiceTraceRedactionConfig;
+    sessionId: string;
+    store?: VoiceTraceEventStore;
+};
+export type VoiceOperationsRecordRoutesOptions = Omit<VoiceOperationsRecordOptions, 'sessionId'> & {
+    headers?: HeadersInit;
+    htmlPath?: false | string;
+    name?: string;
+    path?: string;
+    render?: (record: VoiceOperationsRecord) => string | Promise<string>;
+    title?: string;
+};
+export declare const buildVoiceOperationsRecord: (options: VoiceOperationsRecordOptions) => Promise<VoiceOperationsRecord>;
+export declare const renderVoiceOperationsRecordHTML: (record: VoiceOperationsRecord, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceOperationsRecordRoutes: (options: VoiceOperationsRecordRoutesOptions) => 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.182",
+	"version": "0.0.22-beta.183",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",