npm - @absolutejs/voice - Versions diffs - 0.0.22-beta.197 → 0.0.22-beta.199 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/dist/campaign.d.ts +7 -3
package/dist/index.js +218 -98
package/dist/operationsRecord.d.ts +21 -0
package/dist/sessionReplay.d.ts +2 -0
package/dist/traceTimeline.d.ts +3 -0
package/package.json +1 -1

package/dist/campaign.d.ts CHANGED Viewed

@@ -241,6 +241,12 @@ export type VoiceCampaignRoutesOptions = VoiceCampaignRuntimeOptions & {
     headers?: HeadersInit;
     htmlPath?: false | string;
     observability?: VoiceCampaignObservabilityOptions;
+    operationsRecordHref?: false | string | ((input: {
+        attempt: VoiceCampaignAttempt;
+        campaign: VoiceCampaign;
+        recipient?: VoiceCampaignRecipient;
+        sessionId?: string;
+    }) => string | undefined);
     name?: string;
     path?: string;
     title?: string;
@@ -375,9 +381,7 @@ export declare const applyVoiceCampaignTelephonyOutcome: <TResult = unknown>(inp
 export declare const createVoiceCampaignTelephonyOutcomeHandler: <TResult = unknown>(options: VoiceCampaignTelephonyOutcomeOptions<TResult>) => (input: VoiceTelephonyWebhookDecision<TResult>) => Promise<VoiceCampaignTelephonyOutcomeResult>;
 export declare const runVoiceCampaignProof: (options?: VoiceCampaignProofOptions) => Promise<VoiceCampaignProofReport>;
 export declare const runVoiceCampaignReadinessProof: (options?: VoiceCampaignReadinessProofOptions) => Promise<VoiceCampaignReadinessProofReport>;
-export declare const renderVoiceCampaignsHTML: (records: VoiceCampaignRecord[], options?: {
-    title?: string;
-}) => string;
+export declare const renderVoiceCampaignsHTML: (records: VoiceCampaignRecord[], options?: Pick<VoiceCampaignRoutesOptions, "operationsRecordHref" | "title">) => string;
 export declare const renderVoiceCampaignObservabilityHTML: (report: VoiceCampaignObservabilityReport, options?: {
     title?: string;
 }) => string;

package/dist/index.js CHANGED Viewed

@@ -6662,11 +6662,37 @@ recipient-no-consent,Barbara,+15550001004,no,delta`,
   };
 };
 var escapeHtml3 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var getString = (value) => typeof value === "string" && value.length > 0 ? value : undefined;
+var campaignAttemptSessionId = (attempt) => getString(attempt.metadata?.sessionId) ?? getString(attempt.metadata?.voiceSessionId) ?? getString(attempt.metadata?.callSessionId);
+var resolveCampaignOperationsRecordHref = (value, input) => {
+  if (value === false || !input.sessionId) {
+    return;
+  }
+  if (typeof value === "function") {
+    return value(input);
+  }
+  if (typeof value === "string") {
+    const encoded = encodeURIComponent(input.sessionId);
+    return value.includes(":sessionId") ? value.replace(":sessionId", encoded) : `${value.replace(/\/$/, "")}/${encoded}`;
+  }
+  return;
+};
 var renderVoiceCampaignsHTML = (records, options = {}) => {
   const title = options.title ?? "Voice Campaigns";
   const rows = records.map((record) => `<tr><td>${escapeHtml3(record.campaign.name)}</td><td>${escapeHtml3(record.campaign.status)}</td><td>${String(record.recipients.length)}</td><td>${String(record.attempts.length)}</td><td>${new Date(record.campaign.updatedAt).toLocaleString()}</td></tr>`).join("");
   const summary = summarizeVoiceCampaigns(records);
-  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml3(title)}</title><style>body{background:#111827;color:#f9fafb;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1080px;padding:32px}.hero{background:linear-gradient(135deg,rgba(251,146,60,.18),rgba(45,212,191,.12));border:1px solid #334155;border-radius:28px;margin-bottom:18px;padding:28px}.eyebrow{color:#fdba74;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.4rem,6vw,5rem);line-height:.9;margin:.2rem 0 1rem}.grid{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(160px,1fr));margin:18px 0}.grid article,table{background:#172033;border:1px solid #334155;border-radius:18px}.grid article{padding:16px}.grid span{color:#aab5c0}.grid strong{display:block;font-size:2rem;margin:.25rem 0}table{border-collapse:collapse;overflow:hidden;width:100%}td,th{border-bottom:1px solid #334155;padding:12px;text-align:left}</style></head><body><main><section class="hero"><p class="eyebrow">Self-hosted outbound</p><h1>${escapeHtml3(title)}</h1><p>Campaign orchestration, recipients, attempts, retries, and outcomes without a hosted dialer dashboard.</p><section class="grid"><article><span>Campaigns</span><strong>${String(summary.campaigns.total)}</strong></article><article><span>Recipients</span><strong>${String(summary.recipients.total)}</strong></article><article><span>Attempts</span><strong>${String(summary.attempts.total)}</strong></article><article><span>Running</span><strong>${String(summary.campaigns.running)}</strong></article></section></section><table><thead><tr><th>Name</th><th>Status</th><th>Recipients</th><th>Attempts</th><th>Updated</th></tr></thead><tbody>${rows || '<tr><td colspan="5">No campaigns yet.</td></tr>'}</tbody></table></main></body></html>`;
+  const attemptRows = records.flatMap((record) => record.attempts.slice(-8).reverse().map((attempt) => {
+    const recipient = record.recipients.find((item) => item.id === attempt.recipientId);
+    const sessionId = campaignAttemptSessionId(attempt);
+    const href = resolveCampaignOperationsRecordHref(options.operationsRecordHref, {
+      attempt,
+      campaign: record.campaign,
+      recipient,
+      sessionId
+    });
+    return `<tr><td>${escapeHtml3(record.campaign.name)}</td><td>${escapeHtml3(attempt.status)}</td><td>${escapeHtml3(recipient?.phone ?? attempt.recipientId)}</td><td>${escapeHtml3(sessionId ?? "")}</td><td>${href ? `<a href="${escapeHtml3(href)}">Open operations record</a>` : ""}</td></tr>`;
+  })).slice(0, 20).join("");
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml3(title)}</title><style>body{background:#111827;color:#f9fafb;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:1080px;padding:32px}.hero{background:linear-gradient(135deg,rgba(251,146,60,.18),rgba(45,212,191,.12));border:1px solid #334155;border-radius:28px;margin-bottom:18px;padding:28px}.eyebrow{color:#fdba74;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.4rem,6vw,5rem);line-height:.9;margin:.2rem 0 1rem}.grid{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(160px,1fr));margin:18px 0}.grid article,table{background:#172033;border:1px solid #334155;border-radius:18px}.grid article{padding:16px}.grid span{color:#aab5c0}.grid strong{display:block;font-size:2rem;margin:.25rem 0}table{border-collapse:collapse;margin-top:18px;overflow:hidden;width:100%}td,th{border-bottom:1px solid #334155;padding:12px;text-align:left}a{color:#fdba74}</style></head><body><main><section class="hero"><p class="eyebrow">Self-hosted outbound</p><h1>${escapeHtml3(title)}</h1><p>Campaign orchestration, recipients, attempts, retries, and outcomes without a hosted dialer dashboard.</p><section class="grid"><article><span>Campaigns</span><strong>${String(summary.campaigns.total)}</strong></article><article><span>Recipients</span><strong>${String(summary.recipients.total)}</strong></article><article><span>Attempts</span><strong>${String(summary.attempts.total)}</strong></article><article><span>Running</span><strong>${String(summary.campaigns.running)}</strong></article></section></section><table><thead><tr><th>Name</th><th>Status</th><th>Recipients</th><th>Attempts</th><th>Updated</th></tr></thead><tbody>${rows || '<tr><td colspan="5">No campaigns yet.</td></tr>'}</tbody></table><h2>Recent attempts</h2><table><thead><tr><th>Campaign</th><th>Status</th><th>Recipient</th><th>Session</th><th>Debug</th></tr></thead><tbody>${attemptRows || '<tr><td colspan="5">No attempts yet.</td></tr>'}</tbody></table></main></body></html>`;
 };
 var renderVoiceCampaignObservabilityHTML = (report, options = {}) => {
   const title = options.title ?? "Voice Campaign Observability";
@@ -8634,7 +8660,7 @@ import { Elysia as Elysia4 } from "elysia";
 // src/providerHealth.ts
 import { Elysia as Elysia3 } from "elysia";
-var getString = (value) => typeof value === "string" ? value : undefined;
+var getString2 = (value) => typeof value === "string" ? value : undefined;
 var getNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
 var isProviderStatus = (value) => value === "success" || value === "fallback" || value === "error";
 var summarizeVoiceProviderHealth = async (input) => {
@@ -8740,7 +8766,7 @@ var summarizeVoiceProviderHealth = async (input) => {
     if (event.payload.timedOut === true) {
       entry.timeoutCount += 1;
     }
-    entry.lastError = getString(event.payload.error);
+    entry.lastError = getString2(event.payload.error);
     entry.lastErrorAt = event.at;
     entry.rateLimited ||= event.payload.rateLimited === true;
   }
@@ -8836,16 +8862,16 @@ var renderCountMap = (values) => {
     "</div>"
   ].join("");
 };
-var getString2 = (value) => typeof value === "string" ? value : undefined;
+var getString3 = (value) => typeof value === "string" ? value : undefined;
 var getRecentFailures = (events, maxFailures, replayHref) => events.filter((event) => event.type === "session.error" && (event.payload.providerStatus === "error" || typeof event.payload.error === "string") || event.type === "assistant.guardrail" && event.payload.action === "blocked").toReversed().slice(0, maxFailures).map((event) => {
   const failure = {
     at: event.at,
-    assistantId: getString2(event.payload.assistantId),
-    error: getString2(event.payload.error),
-    provider: getString2(event.payload.provider),
+    assistantId: getString3(event.payload.assistantId),
+    error: getString3(event.payload.error),
+    provider: getString3(event.payload.provider),
     rateLimited: event.payload.rateLimited === true ? true : undefined,
     sessionId: event.sessionId,
-    status: getString2(event.payload.providerStatus),
+    status: getString3(event.payload.providerStatus),
     turnId: event.turnId,
     type: event.type
   };
@@ -9783,7 +9809,7 @@ var buildVoiceAuditExport = (events, options = {}) => {
 // src/auditRoutes.ts
 var escapeHtml8 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var getString3 = (value) => typeof value === "string" && value.trim() ? value.trim() : undefined;
+var getString4 = (value) => typeof value === "string" && value.trim() ? value.trim() : undefined;
 var getNumber2 = (value) => {
   if (typeof value === "number" && Number.isFinite(value)) {
     return value;
@@ -9795,7 +9821,7 @@ var getNumber2 = (value) => {
   return;
 };
 var parseType = (value) => {
-  const text = getString3(value);
+  const text = getString4(value);
   return text && [
     "handoff",
     "operator.action",
@@ -9805,11 +9831,11 @@ var parseType = (value) => {
   ].includes(text) ? text : undefined;
 };
 var parseOutcome = (value) => {
-  const text = getString3(value);
+  const text = getString4(value);
   return text && ["error", "skipped", "success"].includes(text) ? text : undefined;
 };
 var parseBoolean = (value, fallback = false) => {
-  const text = getString3(value)?.toLowerCase();
+  const text = getString4(value)?.toLowerCase();
   if (["1", "true", "yes"].includes(text ?? "")) {
     return true;
   }
@@ -9819,7 +9845,7 @@ var parseBoolean = (value, fallback = false) => {
   return fallback;
 };
 var parseExportFormat = (value) => {
-  const text = getString3(value)?.toLowerCase();
+  const text = getString4(value)?.toLowerCase();
   return text === "markdown" || text === "md" ? "markdown" : text === "html" ? "html" : "json";
 };
 var increment2 = (counts, key) => {
@@ -9831,17 +9857,17 @@ var increment2 = (counts, key) => {
 var sortedCounts = (counts) => [...counts.entries()].sort(([leftKey, leftCount], [rightKey, rightCount]) => rightCount - leftCount || leftKey.localeCompare(rightKey));
 var resolveVoiceAuditTrailFilter = (query = {}, base = {}) => ({
   ...base,
-  actorId: getString3(query.actorId) ?? base.actorId,
+  actorId: getString4(query.actorId) ?? base.actorId,
   after: getNumber2(query.after) ?? base.after,
   afterOrAt: getNumber2(query.afterOrAt) ?? base.afterOrAt,
   before: getNumber2(query.before) ?? base.before,
   beforeOrAt: getNumber2(query.beforeOrAt) ?? base.beforeOrAt,
   limit: getNumber2(query.limit) ?? base.limit,
   outcome: parseOutcome(query.outcome) ?? base.outcome,
-  resourceId: getString3(query.resourceId) ?? base.resourceId,
-  resourceType: getString3(query.resourceType) ?? base.resourceType,
-  sessionId: getString3(query.sessionId) ?? base.sessionId,
-  traceId: getString3(query.traceId) ?? base.traceId,
+  resourceId: getString4(query.resourceId) ?? base.resourceId,
+  resourceType: getString4(query.resourceType) ?? base.resourceType,
+  sessionId: getString4(query.sessionId) ?? base.sessionId,
+  traceId: getString4(query.traceId) ?? base.traceId,
   type: parseType(query.type) ?? base.type
 });
 var summarizeVoiceAuditTrail = (events) => {
@@ -10416,7 +10442,7 @@ var createVoiceAuditSinkDeliveryWorkerLoop = (options) => {
 // src/auditDeliveryRoutes.ts
 import { Elysia as Elysia6 } from "elysia";
 var escapeHtml9 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var getString4 = (value) => typeof value === "string" && value.trim() ? value.trim() : undefined;
+var getString5 = (value) => typeof value === "string" && value.trim() ? value.trim() : undefined;
 var getNumber3 = (value) => {
   if (typeof value === "number" && Number.isFinite(value)) {
     return value;
@@ -10428,13 +10454,13 @@ var getNumber3 = (value) => {
   return;
 };
 var parseStatus = (value) => {
-  const text = getString4(value);
+  const text = getString5(value);
   return text === "pending" || text === "delivered" || text === "failed" || text === "skipped" || text === "all" ? text : undefined;
 };
 var resolveVoiceAuditDeliveryFilter = (query = {}, base = {}) => ({
   ...base,
   limit: getNumber3(query.limit) ?? base.limit,
-  q: getString4(query.q) ?? base.q,
+  q: getString5(query.q) ?? base.q,
   status: parseStatus(query.status) ?? base.status
 });
 var deliverySearchText = (delivery) => [
@@ -10779,7 +10805,7 @@ var createVoiceReconnectContractRoutes = (options) => {
 // src/diagnosticsRoutes.ts
 import { Elysia as Elysia9 } from "elysia";
 var escapeHtml12 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var getString5 = (value) => typeof value === "string" && value.trim() ? value : undefined;
+var getString6 = (value) => typeof value === "string" && value.trim() ? value : undefined;
 var getNumber4 = (value) => {
   const parsed = typeof value === "number" ? value : typeof value === "string" ? Number(value) : undefined;
   return typeof parsed === "number" && Number.isFinite(parsed) ? parsed : undefined;
@@ -10794,15 +10820,15 @@ var parseTraceTypeFilter = (value) => {
 };
 var resolveVoiceDiagnosticsTraceFilter = (query) => ({
   limit: getNumber4(query.limit),
-  scenarioId: getString5(query.scenarioId),
-  sessionId: getString5(query.sessionId),
-  traceId: getString5(query.traceId),
-  turnId: getString5(query.turnId),
+  scenarioId: getString6(query.scenarioId),
+  sessionId: getString6(query.sessionId),
+  traceId: getString6(query.traceId),
+  turnId: getString6(query.turnId),
   type: parseTraceTypeFilter(query.type)
 });
 var filterByDiagnosticsQuery = (events, query) => {
-  const provider = getString5(query.provider);
-  const status = getString5(query.status);
+  const provider = getString6(query.provider);
+  const status = getString6(query.status);
   const since = getNumber4(query.since);
   const until = getNumber4(query.until);
   return filterVoiceTraceEvents(events, resolveVoiceDiagnosticsTraceFilter(query)).filter((event) => (!provider || event.payload.provider === provider) && (!status || event.payload.providerStatus === status || event.payload.status === status) && (since === undefined || event.at >= since) && (until === undefined || event.at <= until));
@@ -13202,7 +13228,7 @@ import { Elysia as Elysia17 } from "elysia";
 // src/handoffHealth.ts
 import { Elysia as Elysia16 } from "elysia";
 var escapeHtml18 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var getString6 = (value) => typeof value === "string" && value.length > 0 ? value : undefined;
+var getString7 = (value) => typeof value === "string" && value.length > 0 ? value : undefined;
 var isStatus = (value) => value === "delivered" || value === "failed" || value === "skipped";
 var increment3 = (record, key) => {
   record[key] = (record[key] ?? 0) + 1;
@@ -13210,11 +13236,11 @@ var increment3 = (record, key) => {
 var normalizeDelivery = (adapterId, value) => {
   const record = value && typeof value === "object" ? value : {};
   return {
-    adapterId: getString6(record.adapterId) ?? adapterId,
-    adapterKind: getString6(record.adapterKind),
+    adapterId: getString7(record.adapterId) ?? adapterId,
+    adapterKind: getString7(record.adapterKind),
     deliveredAt: typeof record.deliveredAt === "number" ? record.deliveredAt : undefined,
-    deliveredTo: getString6(record.deliveredTo),
-    error: getString6(record.error),
+    deliveredTo: getString7(record.deliveredTo),
+    error: getString7(record.error),
     status: isStatus(record.status) ? record.status : "failed"
   };
 };
@@ -13248,13 +13274,13 @@ var summarizeVoiceHandoffHealth = async (options = {}) => {
     const status = isStatus(event.payload.status) ? event.payload.status : "failed";
     const deliveries = normalizeDeliveries(event.payload);
     const item = {
-      action: getString6(event.payload.action),
+      action: getString7(event.payload.action),
       at: event.at,
       deliveries,
-      reason: getString6(event.payload.reason),
+      reason: getString7(event.payload.reason),
       sessionId: event.sessionId,
       status,
-      target: getString6(event.payload.target)
+      target: getString7(event.payload.target)
     };
     return {
       ...item,
@@ -13403,7 +13429,7 @@ var DEFAULT_THRESHOLDS = {
   maxProviderFallbackRate: 0.25,
   maxProviderTimeoutRate: 0.03
 };
-var getString7 = (value) => typeof value === "string" ? value : undefined;
+var getString8 = (value) => typeof value === "string" ? value : undefined;
 var getNumber5 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
 var rate = (count, total) => count / Math.max(1, total);
 var roundMetric2 = (value) => Math.round(value * 1e4) / 1e4;
@@ -13422,11 +13448,11 @@ var evaluateVoiceQuality = async (input) => {
   const assistantReplies = events.filter((event) => event.type === "turn.assistant");
   const sessionIdsWithAssistantReply = new Set(assistantReplies.map((event) => event.sessionId));
   const sessionsWithTurns = new Set(committedTurns.map((event) => event.sessionId));
-  const emptyTurns = committedTurns.filter((event) => !getString7(event.payload.text)?.trim());
+  const emptyTurns = committedTurns.filter((event) => !getString8(event.payload.text)?.trim());
   const turnTextsBySession = new Map;
   let duplicateTurns = 0;
   for (const turn of committedTurns) {
-    const normalized = getString7(turn.payload.text)?.trim().toLowerCase();
+    const normalized = getString8(turn.payload.text)?.trim().toLowerCase();
     if (!normalized) {
       continue;
     }
@@ -13546,7 +13572,7 @@ var createVoiceQualityRoutes = (options) => {
 var escapeHtml20 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var rate2 = (count, total) => count / Math.max(1, total);
 var normalizeSearchText = (value) => value.trim().toLowerCase();
-var getString8 = (value) => typeof value === "string" ? value : undefined;
+var getString9 = (value) => typeof value === "string" ? value : undefined;
 var getObject = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : undefined;
 var getPathValue = (value, path) => {
   let current = value;
@@ -13633,16 +13659,16 @@ var runVoiceSessionEvals = async (options = {}) => {
     trend: buildTrend(limitedSessions)
   };
 };
-var getSessionText = (events, type) => events.filter((event) => event.type === type).map((event) => getString8(event.payload.text)).filter((text) => Boolean(text?.trim())).join(`
+var getSessionText = (events, type) => events.filter((event) => event.type === type).map((event) => getString9(event.payload.text)).filter((text) => Boolean(text?.trim())).join(`
 `);
 var countProviderErrors = (events) => events.filter((event) => event.type === "session.error" && (event.payload.providerStatus === "error" || typeof event.payload.provider === "string")).length;
 var evaluateScenarioSession = (scenario, sessionId, events) => {
   const issues = [];
   const committedText = getSessionText(events, "turn.committed");
   const assistantText = getSessionText(events, "turn.assistant");
-  const lifecycleTypes = events.filter((event) => event.type === "call.lifecycle").map((event) => getString8(event.payload.type)).filter((type) => Boolean(type));
-  const dispositions = events.filter((event) => event.type === "call.lifecycle").map((event) => getString8(event.payload.disposition)).filter((disposition) => Boolean(disposition));
-  const handoffActions = events.filter((event) => event.type === "call.handoff").map((event) => getString8(event.payload.action)).filter((action) => Boolean(action));
+  const lifecycleTypes = events.filter((event) => event.type === "call.lifecycle").map((event) => getString9(event.payload.type)).filter((type) => Boolean(type));
+  const dispositions = events.filter((event) => event.type === "call.lifecycle").map((event) => getString9(event.payload.disposition)).filter((disposition) => Boolean(disposition));
+  const handoffActions = events.filter((event) => event.type === "call.handoff").map((event) => getString9(event.payload.action)).filter((action) => Boolean(action));
   const turnCount = events.filter((event) => event.type === "turn.committed").length;
   const sessionErrorCount = events.filter((event) => event.type === "session.error").length;
   const providerErrorCount = countProviderErrors(events);
@@ -13691,12 +13717,12 @@ var evaluateScenarioSession = (scenario, sessionId, events) => {
     }
   }
   for (const contractId of scenario.requiredWorkflowContracts ?? []) {
-    const matching = workflowContractEvents.filter((event) => getString8(event.payload.contractId) === contractId);
+    const matching = workflowContractEvents.filter((event) => getString9(event.payload.contractId) === contractId);
     if (matching.length === 0) {
       issues.push(`Missing workflow contract: ${contractId}`);
       continue;
     }
-    if (matching.some((event) => getString8(event.payload.status) !== "pass")) {
+    if (matching.some((event) => getString9(event.payload.status) !== "pass")) {
       issues.push(`Workflow contract failed: ${contractId}`);
     }
   }
@@ -15139,11 +15165,24 @@ var createVoiceWorkflowContractHandler = (input) => {
 };
 // src/sessionReplay.ts
 import { Elysia as Elysia22 } from "elysia";
-var getString9 = (value) => typeof value === "string" ? value : undefined;
+var getString10 = (value) => typeof value === "string" ? value : undefined;
 var escapeHtml24 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var increment4 = (record, key) => {
   record[key] = (record[key] ?? 0) + 1;
 };
+var resolveSessionHref = (value, session) => {
+  if (value === false) {
+    return;
+  }
+  if (typeof value === "function") {
+    return value(session);
+  }
+  if (typeof value === "string") {
+    const encoded = encodeURIComponent(session.sessionId);
+    return value.includes(":sessionId") ? value.replace(":sessionId", encoded) : `${value.replace(/\/$/, "")}/${encoded}`;
+  }
+  return;
+};
 var isProviderErrorEvent = (event) => event.type === "session.error" && (event.payload.providerStatus === "error" || typeof event.payload.error === "string");
 var isRecoveredProviderFallbackEvent = (event) => event.type === "session.error" && (event.payload.providerStatus === "fallback" || event.payload.status === "fallback") && event.payload.recovered === true;
 var turnRecoveryKey = (event) => event.turnId ?? `session:${event.sessionId}`;
@@ -15189,14 +15228,14 @@ var buildReplayTurns = (events) => {
       case "turn.transcript":
         turn.transcripts.push({
           isFinal: event.payload.isFinal === true,
-          text: getString9(event.payload.text)
+          text: getString10(event.payload.text)
         });
         break;
       case "turn.committed":
-        turn.committedText = getString9(event.payload.text);
+        turn.committedText = getString10(event.payload.text);
         break;
       case "turn.assistant": {
-        const text = getString9(event.payload.text);
+        const text = getString10(event.payload.text);
         if (text) {
           turn.assistantReplies.push(text);
         }
@@ -15266,7 +15305,7 @@ var summarizeVoiceSessions = async (options = {}) => {
     let errorCount = 0;
     const recoveredTurns = new Set(sorted.filter(isRecoveredProviderFallbackEvent).map((event) => turnRecoveryKey(event)));
     for (const event of sorted) {
-      const provider = getString9(event.payload.provider);
+      const provider = getString10(event.payload.provider);
       if (provider) {
         providers.add(provider);
       }
@@ -15274,7 +15313,7 @@ var summarizeVoiceSessions = async (options = {}) => {
         errorCount += 1;
         increment4(providerErrors, provider ?? "unknown");
       }
-      const outcome = getString9(event.payload.outcome);
+      const outcome = getString10(event.payload.outcome);
       if (outcome) {
         latestOutcome = outcome;
       }
@@ -15295,6 +15334,7 @@ var summarizeVoiceSessions = async (options = {}) => {
     const replayHref = options.replayHref === false ? "" : typeof options.replayHref === "function" ? options.replayHref(item) : `${options.replayHref ?? "/api/voice-sessions"}/${encodeURIComponent(sessionId)}/replay/htmx`;
     return {
       ...item,
+      operationsRecordHref: resolveSessionHref(options.operationsRecordHref, item),
       replayHref
     };
   });
@@ -15333,7 +15373,7 @@ var renderVoiceSessionsHTML = (sessions) => sessions.length === 0 ? '<p class="v
     "</dl>",
     session.latestOutcome ? `<p>Outcome: ${escapeHtml24(session.latestOutcome)}</p>` : "",
     session.providers.length ? `<p>Providers: ${session.providers.map(escapeHtml24).join(", ")}</p>` : "",
-    session.replayHref ? `<p><a href="${escapeHtml24(session.replayHref)}">Open replay</a></p>` : "",
+    session.replayHref ? `<p>${session.operationsRecordHref ? `<a href="${escapeHtml24(session.operationsRecordHref)}">Open operations record</a> \xB7 ` : ""}<a href="${escapeHtml24(session.replayHref)}">Open replay</a></p>` : "",
     "</article>"
   ].join("")),
   "</div>"
@@ -15626,14 +15666,14 @@ var DEFAULT_WARN_AFTER_MS = 1800;
 var DEFAULT_FAIL_AFTER_MS = 3200;
 var escapeHtml25 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var firstNumber = (values) => values.filter((value) => typeof value === "number").sort((left, right) => left - right)[0];
-var getString10 = (value) => typeof value === "string" && value.trim() ? value : undefined;
+var getString11 = (value) => typeof value === "string" && value.trim() ? value : undefined;
 var createTraceStageIndex = (events) => {
   const index = new Map;
   for (const event of events) {
     if (event.type !== "turn_latency.stage" || !event.turnId) {
       continue;
     }
-    const stage = getString10(event.payload.stage);
+    const stage = getString11(event.payload.stage);
     if (!stage) {
       continue;
     }
@@ -15900,7 +15940,7 @@ var TRACE_TYPES = [
   "turn_latency.stage"
 ];
 var getNumber6 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
-var getString11 = (value) => typeof value === "string" && value.trim() ? value : undefined;
+var getString12 = (value) => typeof value === "string" && value.trim() ? value : undefined;
 var percentile2 = (values, percentileValue) => {
   if (values.length === 0) {
     return;
@@ -15937,7 +15977,7 @@ var providerStageForEvent = (event) => {
   if (event.type === "turn.transcript") {
     return "provider_stt";
   }
-  const kind = getString11(event.payload.providerKind) ?? getString11(event.payload.kind) ?? getString11(event.payload.lane);
+  const kind = getString12(event.payload.providerKind) ?? getString12(event.payload.kind) ?? getString12(event.payload.lane);
   if (kind === "llm" || kind === "model") {
     return "provider_llm";
   }
@@ -15956,7 +15996,7 @@ var collectTraceStageMeasurements = (events, options) => {
     if (event.type !== "turn_latency.stage" || !event.turnId) {
       continue;
     }
-    const stage = getString11(event.payload.stage);
+    const stage = getString12(event.payload.stage);
     if (!stage) {
       continue;
     }
@@ -16085,7 +16125,7 @@ var collectDirectMeasurements = (events, options) => {
         at: event.at,
         budget: resolveBudget(providerStage, options),
         latencyMs: eventElapsedMs(event),
-        provider: getString11(event.payload.provider),
+        provider: getString12(event.payload.provider),
         sessionId: event.sessionId,
         stage: providerStage,
         turnId: event.turnId
@@ -21226,7 +21266,7 @@ var createVoiceProviderCapabilityRoutes = (options) => {
 // src/resilienceRoutes.ts
 import { Elysia as Elysia34 } from "elysia";
 var escapeHtml35 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var getString12 = (value) => typeof value === "string" ? value : undefined;
+var getString13 = (value) => typeof value === "string" ? value : undefined;
 var getNumber7 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
 var getBoolean2 = (value) => value === true;
 var isProviderStatus2 = (value) => value === "error" || value === "fallback" || value === "success";
@@ -21236,24 +21276,24 @@ var listVoiceRoutingEvents = (events) => {
     if (event.type !== "session.error") {
       continue;
     }
-    const provider = getString12(event.payload.provider);
+    const provider = getString13(event.payload.provider);
     const providerStatus = isProviderStatus2(event.payload.providerStatus) ? event.payload.providerStatus : undefined;
     if (!provider || !providerStatus) {
       continue;
     }
-    const kind = getString12(event.payload.kind);
+    const kind = getString13(event.payload.kind);
     routingEvents.push({
       at: event.at,
       attempt: getNumber7(event.payload.attempt),
       elapsedMs: getNumber7(event.payload.elapsedMs),
-      error: getString12(event.payload.error),
-      fallbackProvider: getString12(event.payload.fallbackProvider),
+      error: getString13(event.payload.error),
+      fallbackProvider: getString13(event.payload.fallbackProvider),
       kind: kind === "stt" || kind === "tts" ? kind : "llm",
       latencyBudgetMs: getNumber7(event.payload.latencyBudgetMs),
-      operation: getString12(event.payload.operation),
+      operation: getString13(event.payload.operation),
       provider,
-      routing: getString12(event.payload.routing),
-      selectedProvider: getString12(event.payload.selectedProvider),
+      routing: getString13(event.payload.routing),
+      selectedProvider: getString13(event.payload.selectedProvider),
       sessionId: event.sessionId,
       status: providerStatus,
       suppressionRemainingMs: getNumber7(event.payload.suppressionRemainingMs),
@@ -21750,7 +21790,7 @@ import { Elysia as Elysia36 } from "elysia";
 // src/opsRecovery.ts
 import { Elysia as Elysia35 } from "elysia";
 var escapeHtml36 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var getString13 = (value) => typeof value === "string" && value.trim() ? value.trim() : undefined;
+var getString14 = (value) => typeof value === "string" && value.trim() ? value.trim() : undefined;
 var hrefForSession = (value, sessionId) => {
   if (typeof value === "function") {
     return value(sessionId);
@@ -21775,9 +21815,9 @@ var collectFailedSessions = (events, limit, links) => events.filter((event) => {
   return providerStatus !== "success" && providerStatus !== "fallback";
 }).sort((left, right) => right.at - left.at).slice(0, limit).map((event) => ({
   at: event.at,
-  error: getString13(event.payload.error),
+  error: getString14(event.payload.error),
   operationsRecordHref: operationsRecordHrefForSession(links, event.sessionId),
-  provider: getString13(event.payload.provider),
+  provider: getString14(event.payload.provider),
   sessionId: event.sessionId,
   traceId: event.traceId
 }));
@@ -21785,9 +21825,9 @@ var collectInterventions = (events, limit) => {
   const interventionEvents = events.filter((event) => event.type === "operator.action").sort((left, right) => right.at - left.at);
   return {
     events: interventionEvents.slice(0, limit).map((event) => ({
-      action: getString13(event.payload.action),
+      action: getString14(event.payload.action),
       at: event.at,
-      operatorId: getString13(event.payload.operatorId) ?? getString13(event.payload.actorId),
+      operatorId: getString14(event.payload.operatorId) ?? getString14(event.payload.actorId),
       sessionId: event.sessionId,
       traceId: event.traceId
     })),
@@ -22362,7 +22402,7 @@ var summarizeLiveLatency = (events, options) => {
     warnings
   };
 };
-var getString14 = (value) => typeof value === "string" ? value : undefined;
+var getString15 = (value) => typeof value === "string" ? value : undefined;
 var getNumber8 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
 var voiceOperationsRecordHref = (base, sessionId) => {
   const encoded = encodeURIComponent(sessionId);
@@ -22374,7 +22414,7 @@ var voiceOperationsRecordHref = (base, sessionId) => {
 var buildOperationsRecordLinks = (input) => {
   const failedSessionSet = new Set(input.failedSessionIds);
   const providerErrors = input.events.filter((event) => event.type === "session.error" && (event.payload.providerStatus === "error" || typeof event.payload.error === "string")).map((event) => ({
-    detail: getString14(event.payload.error),
+    detail: getString15(event.payload.error),
     href: voiceOperationsRecordHref(input.base, event.sessionId),
     label: "Open provider error operations record",
     sessionId: event.sessionId,
@@ -23885,11 +23925,11 @@ import { Elysia as Elysia40 } from "elysia";
 // src/traceTimeline.ts
 import { Elysia as Elysia39 } from "elysia";
 var escapeHtml40 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var getString15 = (value) => typeof value === "string" && value.trim() ? value : undefined;
+var getString16 = (value) => typeof value === "string" && value.trim() ? value : undefined;
 var getNumber9 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
 var firstString3 = (payload, keys) => {
   for (const key of keys) {
-    const value = getString15(payload[key]);
+    const value = getString16(payload[key]);
     if (value) {
       return value;
     }
@@ -23919,6 +23959,19 @@ var eventStatus = (event) => firstString3(event.payload, [
   "reason"
 ]);
 var eventElapsedMs2 = (event) => firstNumber3(event.payload, ["elapsedMs", "latencyMs", "durationMs"]);
+var resolveSessionHref2 = (value, sessionId) => {
+  if (value === false) {
+    return;
+  }
+  if (typeof value === "function") {
+    return value(sessionId);
+  }
+  if (typeof value === "string") {
+    const encoded = encodeURIComponent(sessionId);
+    return value.includes(":sessionId") ? value.replace(":sessionId", encoded) : `${value.replace(/\/$/, "")}/${encoded}`;
+  }
+  return;
+};
 var timelineLabel = (event) => {
   switch (event.type) {
     case "call.lifecycle":
@@ -23926,15 +23979,15 @@ var timelineLabel = (event) => {
     case "turn.transcript":
       return event.payload.isFinal === true ? "Final transcript" : "Partial transcript";
     case "turn.committed":
-      return `Committed turn${getString15(event.payload.reason) ? ` (${getString15(event.payload.reason)})` : ""}`;
+      return `Committed turn${getString16(event.payload.reason) ? ` (${getString16(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 ${getString15(event.payload.toolName) ?? "call"}`;
+      return `Tool ${getString16(event.payload.toolName) ?? "call"}`;
     case "agent.handoff":
-      return `Agent handoff${getString15(event.payload.targetAgentId) ? ` to ${getString15(event.payload.targetAgentId)}` : ""}`;
+      return `Agent handoff${getString16(event.payload.targetAgentId) ? ` to ${getString16(event.payload.targetAgentId)}` : ""}`;
     case "assistant.run":
       return `Assistant run${eventProvider(event) ? ` via ${eventProvider(event)}` : ""}`;
     case "assistant.guardrail":
@@ -23944,11 +23997,11 @@ var timelineLabel = (event) => {
     case "client.live_latency":
       return `Live latency${eventElapsedMs2(event) !== undefined ? ` ${eventElapsedMs2(event)}ms` : ""}`;
     case "session.error":
-      return `Error${getString15(event.payload.error) ? `: ${getString15(event.payload.error)}` : ""}`;
+      return `Error${getString16(event.payload.error) ? `: ${getString16(event.payload.error)}` : ""}`;
     case "turn.cost":
       return "Cost telemetry";
     case "turn_latency.stage":
-      return `Latency ${getString15(event.payload.stage) ?? "stage"}`;
+      return `Latency ${getString16(event.payload.stage) ?? "stage"}`;
     case "workflow.contract":
       return `Workflow contract ${eventStatus(event) ?? ""}`.trim();
     default:
@@ -24036,6 +24089,7 @@ var summarizeVoiceTraceTimeline = (events, options = {}) => {
         type: event.type
       })),
       lastEventAt: sorted.at(-1)?.at,
+      operationsRecordHref: resolveSessionHref2(options.operationsRecordHref, sessionId),
       providers: summarizeProviders(sorted),
       sessionId,
       startedAt: summary.startedAt,
@@ -24056,9 +24110,10 @@ var renderProviderCards2 = (session) => session.providers.length === 0 ? '<p cla
 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>`;
+  const supportLinks = session.operationsRecordHref ? `<p><a href="${escapeHtml40(session.operationsRecordHref)}">Open operations record</a></p>` : "";
+  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>${supportLinks}</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 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>${session.operationsRecordHref ? `<a href="${escapeHtml40(session.operationsRecordHref)}">${escapeHtml40(session.sessionId)}</a>` : `<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({
@@ -24099,12 +24154,14 @@ var createVoiceTraceTimelineRoutes = (options) => {
   const buildReport = async () => summarizeVoiceTraceTimeline(await options.store.list(), {
     evaluation: options.evaluation,
     limit: options.limit,
+    operationsRecordHref: options.operationsRecordHref,
     redact: options.redact
   });
   const findSession = async (sessionId) => {
     const report = summarizeVoiceTraceTimeline(await options.store.list({ sessionId }), {
       evaluation: options.evaluation,
       limit: 1,
+      operationsRecordHref: options.operationsRecordHref,
       redact: options.redact
     });
     return report.sessions[0];
@@ -24141,7 +24198,7 @@ var createVoiceTraceTimelineRoutes = (options) => {
 };
 // src/operationsRecord.ts
-var getString16 = (value) => typeof value === "string" ? value : undefined;
+var getString17 = (value) => typeof value === "string" ? value : undefined;
 var getNumber10 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
 var countOutcome = (events, outcome) => events.filter((event) => event.outcome === outcome).length;
 var matchesSessionScopedId = (id, sessionId) => id === sessionId || id.startsWith(`${sessionId}:`);
@@ -24152,23 +24209,51 @@ var hasPayloadValue = (payload, key, values) => {
 var countIntegrationDeliveryStatus = (events, status) => events.filter((event) => event.deliveryStatus === status).length;
 var toHandoff = (event) => ({
   at: event.at,
-  fromAgentId: getString16(event.payload.fromAgentId),
+  fromAgentId: getString17(event.payload.fromAgentId),
   metadata: event.payload.metadata && typeof event.payload.metadata === "object" && !Array.isArray(event.payload.metadata) ? event.payload.metadata : undefined,
-  reason: getString16(event.payload.reason),
-  status: getString16(event.payload.status),
-  summary: getString16(event.payload.summary),
-  targetAgentId: getString16(event.payload.targetAgentId),
+  reason: getString17(event.payload.reason),
+  status: getString17(event.payload.status),
+  summary: getString17(event.payload.summary),
+  targetAgentId: getString17(event.payload.targetAgentId),
   turnId: event.turnId
 });
 var toTool = (event) => ({
   at: event.at,
   elapsedMs: getNumber10(event.payload.elapsedMs),
-  error: getString16(event.payload.error),
-  status: getString16(event.payload.status),
-  toolCallId: getString16(event.payload.toolCallId),
-  toolName: getString16(event.payload.toolName),
+  error: getString17(event.payload.error),
+  status: getString17(event.payload.status),
+  toolCallId: getString17(event.payload.toolCallId),
+  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 {
@@ -24224,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 ? {
@@ -24244,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>";
@@ -24270,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";
@@ -25155,7 +25275,7 @@ var createVoiceTTSProviderRouter = (options) => {
 // src/traceDeliveryRoutes.ts
 import { Elysia as Elysia43 } from "elysia";
 var escapeHtml43 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var getString17 = (value) => typeof value === "string" && value.trim() ? value.trim() : undefined;
+var getString18 = (value) => typeof value === "string" && value.trim() ? value.trim() : undefined;
 var getNumber11 = (value) => {
   if (typeof value === "number" && Number.isFinite(value)) {
     return value;
@@ -25167,13 +25287,13 @@ var getNumber11 = (value) => {
   return;
 };
 var parseStatus2 = (value) => {
-  const text = getString17(value);
+  const text = getString18(value);
   return text === "pending" || text === "delivered" || text === "failed" || text === "skipped" || text === "all" ? text : undefined;
 };
 var resolveVoiceTraceDeliveryFilter = (query = {}, base = {}) => ({
   ...base,
   limit: getNumber11(query.limit) ?? base.limit,
-  q: getString17(query.q) ?? base.q,
+  q: getString18(query.q) ?? base.q,
   status: parseStatus2(query.status) ?? base.status
 });
 var deliverySearchText2 = (delivery) => [

package/dist/operationsRecord.d.ts CHANGED Viewed

@@ -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/dist/sessionReplay.d.ts CHANGED Viewed

@@ -34,6 +34,7 @@ export type VoiceSessionListItem = {
     errorCount: number;
     eventCount: number;
     latestOutcome?: string;
+    operationsRecordHref?: string;
     providerErrors: Record<string, number>;
     providers: string[];
     replayHref: string;
@@ -55,6 +56,7 @@ export type VoiceProviderFallbackRecoverySummary = {
 export type VoiceSessionListOptions = {
     events?: StoredVoiceTraceEvent[];
     limit?: number;
+    operationsRecordHref?: false | string | ((session: Omit<VoiceSessionListItem, 'operationsRecordHref' | 'replayHref'>) => string);
     provider?: string;
     q?: string;
     replayHref?: false | string | ((session: Omit<VoiceSessionListItem, 'replayHref'>) => string);

package/dist/traceTimeline.d.ts CHANGED Viewed

@@ -26,6 +26,7 @@ export type VoiceTraceTimelineSession = {
     evaluation: ReturnType<typeof evaluateVoiceTrace>;
     events: VoiceTraceTimelineEvent[];
     lastEventAt?: number;
+    operationsRecordHref?: string;
     providers: VoiceTraceTimelineProviderSummary[];
     sessionId: string;
     startedAt?: number;
@@ -45,6 +46,7 @@ export type VoiceTraceTimelineRoutesOptions = {
     htmlPath?: string;
     limit?: number;
     name?: string;
+    operationsRecordHref?: false | string | ((sessionId: string) => string);
     path?: string;
     redact?: VoiceTraceRedactionConfig;
     render?: (report: VoiceTraceTimelineReport) => string | Promise<string>;
@@ -55,6 +57,7 @@ export type VoiceTraceTimelineRoutesOptions = {
 export declare const summarizeVoiceTraceTimeline: (events: StoredVoiceTraceEvent[], options?: {
     evaluation?: VoiceTraceEvaluationOptions;
     limit?: number;
+    operationsRecordHref?: false | string | ((sessionId: string) => string);
     redact?: VoiceTraceRedactionConfig;
 }) => VoiceTraceTimelineReport;
 export declare const renderVoiceTraceTimelineSessionHTML: (session: VoiceTraceTimelineSession, options?: {

package/package.json CHANGED Viewed

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