@absolutejs/voice 0.0.22-beta.198 → 0.0.22-beta.199

package/dist/index.js

@@ -24226,6 +24226,34 @@ var toTool = (event) => ({
   toolName: getString17(event.payload.toolName),
   turnId: event.turnId
 });
+var toProviderDecision = (event) => {
+  const provider = getString17(event.payload.provider) ?? getString17(event.payload.selectedProvider) ?? getString17(event.payload.fallbackProvider) ?? getString17(event.payload.variantId);
+  const status = getString17(event.payload.providerStatus) ?? getString17(event.payload.status) ?? getString17(event.payload.reason);
+  const error = getString17(event.payload.error);
+  const elapsedMs = getNumber10(event.payload.elapsedMs) ?? getNumber10(event.payload.latencyMs) ?? getNumber10(event.payload.durationMs);
+  if (!provider && !status && !error && elapsedMs === undefined) {
+    return;
+  }
+  return {
+    at: event.at,
+    elapsedMs,
+    error,
+    fallbackProvider: getString17(event.payload.fallbackProvider),
+    provider,
+    reason: getString17(event.payload.reason),
+    selectedProvider: getString17(event.payload.selectedProvider),
+    status,
+    type: event.type,
+    turnId: event.turnId
+  };
+};
+var buildTranscript = (replay) => replay.turns.map((turn) => ({
+  assistantReplies: turn.assistantReplies,
+  committedText: turn.committedText,
+  errors: turn.errors.map((error) => getString17(error.error) ?? JSON.stringify(error)).filter((error) => typeof error === "string"),
+  id: turn.id,
+  transcripts: turn.transcripts.map((transcript) => transcript.text).filter((text) => typeof text === "string" && text.length > 0)
+})).filter((turn) => turn.committedText || turn.assistantReplies.length > 0 || turn.transcripts.length > 0 || turn.errors.length > 0);
 var resolveOutcome4 = (events) => {
   const agentResults = events.filter((event) => event.type === "agent.result");
   return {
@@ -24281,6 +24309,7 @@ var buildVoiceOperationsRecord = async (options) => {
       total: integrationEvents.length
     } : undefined,
     outcome: resolveOutcome4(traceEvents),
+    providerDecisions: traceEvents.map(toProviderDecision).filter((decision) => decision !== undefined),
     providers: timelineSession?.providers ?? [],
     replay,
     reviews: reviews ? {
@@ -24301,13 +24330,46 @@ var buildVoiceOperationsRecord = async (options) => {
     } : undefined,
     timeline: timelineSession?.events ?? [],
     tools: traceEvents.filter((event) => event.type === "agent.tool").map(toTool),
-    traceEvents
+    traceEvents,
+    transcript: buildTranscript(replay)
   };
 };
 var escapeHtml41 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var formatMs4 = (value) => value === undefined ? "n/a" : `${String(value)}ms`;
+var outcomeLabels = (outcome) => [
+  outcome.complete ? "complete" : undefined,
+  outcome.escalated ? "escalated" : undefined,
+  outcome.transferred ? "transferred" : undefined,
+  outcome.voicemail ? "voicemail" : undefined,
+  outcome.noAnswer ? "no-answer" : undefined
+].filter((label) => label !== undefined);
+var renderIncidentHandoffMarkdown = (record) => {
+  const outcomes = outcomeLabels(record.outcome);
+  const topErrors = record.traceEvents.filter((event) => event.type === "session.error").map((event) => getString17(event.payload.error)).filter((error) => typeof error === "string").slice(0, 3);
+  const openTasks = record.tasks?.tasks.filter((task) => task.status !== "done").map((task) => task.title).slice(0, 3) ?? [];
+  return [
+    `# Voice incident handoff: ${record.sessionId}`,
+    "",
+    `- Status: ${record.status}`,
+    `- Duration: ${formatMs4(record.summary.callDurationMs)}`,
+    `- Turns: ${String(record.summary.turnCount)}`,
+    `- Errors: ${String(record.summary.errorCount)}`,
+    `- Outcome: ${outcomes.join(", ") || "unknown"}`,
+    `- Providers: ${record.providers.map((provider) => provider.provider).join(", ") || "none recorded"}`,
+    `- Open tasks: ${openTasks.join("; ") || "none"}`,
+    `- Top errors: ${topErrors.join("; ") || "none"}`,
+    "",
+    "## Next checks",
+    "- Review provider decisions and fallback status.",
+    "- Review transcript and assistant replies.",
+    "- Review handoffs, tools, audit, tasks, and integration delivery."
+  ].join(`
+`);
+};
 var renderVoiceOperationsRecordHTML = (record, options = {}) => {
   const providers = record.providers.length ? record.providers.map((provider) => `<article><strong>${escapeHtml41(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 transcript = record.transcript.length ? record.transcript.map((turn) => `<li><strong>${escapeHtml41(turn.id)}</strong>${turn.committedText ? `<p><span class="label">Caller</span>${escapeHtml41(turn.committedText)}</p>` : ""}${turn.assistantReplies.map((reply) => `<p><span class="label">Assistant</span>${escapeHtml41(reply)}</p>`).join("")}${turn.errors.map((error) => `<p class="error"><span class="label">Error</span>${escapeHtml41(error)}</p>`).join("")}</li>`).join("") : "<li>No transcript turns recorded.</li>";
+  const providerDecisions = record.providerDecisions.length ? record.providerDecisions.map((decision) => `<li><strong>${escapeHtml41(decision.provider ?? decision.selectedProvider ?? decision.fallbackProvider ?? "provider")}</strong> <span>${escapeHtml41(decision.status ?? decision.type)}</span> ${formatMs4(decision.elapsedMs)}${decision.fallbackProvider ? `<p>Fallback: ${escapeHtml41(decision.fallbackProvider)}</p>` : ""}${decision.error ? `<p class="error">${escapeHtml41(decision.error)}</p>` : ""}${decision.reason ? `<p>${escapeHtml41(decision.reason)}</p>` : ""}</li>`).join("") : "<li>No provider decisions recorded.</li>";
   const handoffs = record.handoffs.length ? record.handoffs.map((handoff) => `<li><strong>${escapeHtml41(handoff.fromAgentId ?? "unknown")}</strong> to <strong>${escapeHtml41(handoff.targetAgentId ?? "unknown")}</strong> <span>${escapeHtml41(handoff.status ?? "")}</span><p>${escapeHtml41(handoff.summary ?? handoff.reason ?? "")}</p></li>`).join("") : "<li>No agent handoffs recorded.</li>";
   const tools = record.tools.length ? record.tools.map((tool) => `<li><strong>${escapeHtml41(tool.toolName ?? "tool")}</strong> <span>${escapeHtml41(tool.status ?? "")}</span> ${formatMs4(tool.elapsedMs)} ${tool.error ? `<p>${escapeHtml41(tool.error)}</p>` : ""}</li>`).join("") : "<li>No tool calls recorded.</li>";
   const reviews = record.reviews?.reviews.length ? record.reviews.reviews.map((review) => `<li><strong>${escapeHtml41(review.title)}</strong> <span>${escapeHtml41(review.summary.outcome ?? "")}</span><p>${escapeHtml41(review.postCall?.summary ?? review.transcript.actual)}</p></li>`).join("") : "<li>No call reviews recorded.</li>";
@@ -24327,7 +24389,8 @@ var renderVoiceOperationsRecordHTML = (record, options = {}) => {
 		tasks: opsTasks
 	})
 );`);
-  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml41(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>${escapeHtml41(options.title ?? "Voice Operations Record")}</h1><p class="status ${escapeHtml41(record.status)}">${escapeHtml41(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><div class="card"><span>Reviews</span><strong>${String(record.reviews?.total ?? 0)}</strong></div><div class="card"><span>Tasks</span><strong>${String(record.tasks?.total ?? 0)}</strong></div><div class="card"><span>Integrations</span><strong>${String(record.integrationEvents?.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, replay, reviews, tasks, and webhook delivery.</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><section><h2>Reviews</h2><ul>${reviews}</ul></section><section><h2>Tasks</h2><ul>${tasks}</ul></section><section><h2>Integration Events</h2><ul>${integrationEvents}</ul></section></main></body></html>`;
+  const incidentMarkdown = escapeHtml41(renderIncidentHandoffMarkdown(record));
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml41(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,.label{color:#a9b4bd}.label{display:block;font-size:.72rem;font-weight:900;letter-spacing:.12em;text-transform:uppercase}.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}.hero-actions{display:flex;flex-wrap:wrap;gap:10px;margin-top:16px}.hero-actions a{background:#fbbf24;border-radius:999px;color:#111827;font-weight:900;padding:10px 14px;text-decoration:none}.two-column{display:grid;gap:18px;grid-template-columns:minmax(0,1.15fr) minmax(280px,.85fr)}@media(max-width:860px){main{padding:20px}.two-column{grid-template-columns:1fr}}</style></head><body><main><p class="eyebrow">Call log replacement</p><h1>${escapeHtml41(options.title ?? "Voice Operations Record")}</h1><p class="status ${escapeHtml41(record.status)}">${escapeHtml41(record.status)}</p><div class="hero-actions"><a href="#transcript">Transcript</a><a href="#provider-decisions">Provider decisions</a><a href="#incident-handoff">Incident handoff</a></div><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><div class="card"><span>Reviews</span><strong>${String(record.reviews?.total ?? 0)}</strong></div><div class="card"><span>Tasks</span><strong>${String(record.tasks?.total ?? 0)}</strong></div><div class="card"><span>Integrations</span><strong>${String(record.integrationEvents?.total ?? 0)}</strong></div></section><section class="two-column"><div><h2 id="transcript">Transcript</h2><ul>${transcript}</ul></div><div><h2 id="provider-decisions">Provider Decisions</h2><ul>${providerDecisions}</ul></div></section><section id="incident-handoff"><h2>Copyable Incident Handoff</h2><p class="muted">Paste this into Slack, Linear, Zendesk, or an incident review.</p><pre><code>${incidentMarkdown}</code></pre></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, replay, reviews, tasks, and webhook delivery.</p><pre><code>${snippet}</code></pre></section><section><h2>Provider Summary</h2><div class="grid">${providers}</div></section><section><h2>Handoffs</h2><ul>${handoffs}</ul></section><section><h2>Tools</h2><ul>${tools}</ul></section><section><h2>Reviews</h2><ul>${reviews}</ul></section><section><h2>Tasks</h2><ul>${tasks}</ul></section><section><h2>Integration Events</h2><ul>${integrationEvents}</ul></section></main></body></html>`;
 };
 var createVoiceOperationsRecordRoutes = (options) => {
   const path = options.path ?? "/api/voice-operations/:sessionId";

package/dist/operationsRecord.d.ts

@@ -33,6 +33,25 @@ export type VoiceOperationsRecordTool = {
     toolName?: string;
     turnId?: string;
 };
+export type VoiceOperationsRecordTranscriptTurn = {
+    assistantReplies: string[];
+    committedText?: string;
+    errors: string[];
+    id: string;
+    transcripts: string[];
+};
+export type VoiceOperationsRecordProviderDecision = {
+    at: number;
+    elapsedMs?: number;
+    error?: string;
+    fallbackProvider?: string;
+    provider?: string;
+    reason?: string;
+    selectedProvider?: string;
+    status?: string;
+    type: StoredVoiceTraceEvent['type'];
+    turnId?: string;
+};
 export type VoiceOperationsRecordAuditSummary = {
     error: number;
     events: StoredVoiceAuditEvent[];
@@ -68,6 +87,7 @@ export type VoiceOperationsRecord = {
     handoffs: VoiceOperationsRecordAgentHandoff[];
     integrationEvents?: VoiceOperationsRecordIntegrationEventSummary;
     outcome: VoiceOperationsRecordOutcome;
+    providerDecisions: VoiceOperationsRecordProviderDecision[];
     providers: VoiceTraceTimelineProviderSummary[];
     replay: VoiceSessionReplay;
     reviews?: VoiceOperationsRecordReviewSummary;
@@ -78,6 +98,7 @@ export type VoiceOperationsRecord = {
     timeline: VoiceTraceTimelineEvent[];
     tools: VoiceOperationsRecordTool[];
     traceEvents: StoredVoiceTraceEvent[];
+    transcript: VoiceOperationsRecordTranscriptTurn[];
 };
 export type VoiceOperationsRecordOptions = {
     audit?: VoiceAuditEventStore;

package/package.json

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