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

package/dist/incidentBundle.d.ts

@@ -0,0 +1,66 @@
+import { Elysia } from 'elysia';
+import { type VoiceOperationsRecord, type VoiceOperationsRecordOptions } from './operationsRecord';
+import { type VoiceTraceRedactionConfig } from './trace';
+export type VoiceIncidentBundleFormat = 'json' | 'markdown';
+export type VoiceIncidentBundle = {
+    auditMarkdown?: string;
+    exportedAt: number;
+    formatVersion: 1;
+    markdown: string;
+    record: VoiceOperationsRecord;
+    redacted: boolean;
+    sessionId: string;
+    summary: VoiceIncidentBundleSummary;
+    traceMarkdown: string;
+};
+export type VoiceIncidentBundleSummary = {
+    auditEvents: number;
+    durationMs?: number;
+    errors: number;
+    handoffs: number;
+    providers: string[];
+    sessionId: string;
+    status: VoiceOperationsRecord['status'];
+    tools: number;
+    traceEvents: number;
+    turns: number;
+};
+export type VoiceIncidentBundleOptions = VoiceOperationsRecordOptions & {
+    redact?: VoiceTraceRedactionConfig;
+    title?: string;
+};
+export type VoiceIncidentBundleRoutesOptions = Omit<VoiceIncidentBundleOptions, 'sessionId'> & {
+    headers?: HeadersInit;
+    markdownPath?: false | string;
+    name?: string;
+    path?: string;
+};
+export declare const buildVoiceIncidentBundle: (options: VoiceIncidentBundleOptions) => Promise<VoiceIncidentBundle>;
+export declare const createVoiceIncidentBundleRoutes: (options: VoiceIncidentBundleRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/index.d.ts

@@ -49,6 +49,7 @@ export { createVoiceReadinessProfile, recommendVoiceReadinessProfile } from './r
 export { buildVoiceProviderContractMatrix, createVoiceProviderContractMatrixHTMLHandler, createVoiceProviderContractMatrixJSONHandler, createVoiceProviderContractMatrixPreset, createVoiceProviderContractMatrixRoutes, evaluateVoiceProviderStackGaps, renderVoiceProviderContractMatrixHTML, recommendVoiceProviderStack } from './providerStackRecommendations';
 export { buildVoiceOpsConsoleReport, createVoiceOpsConsoleRoutes, renderVoiceOpsConsoleHTML } from './opsConsoleRoutes';
 export { buildVoiceOperationsRecord, createVoiceOperationsRecordRoutes, renderVoiceOperationsRecordHTML } from './operationsRecord';
+export { buildVoiceIncidentBundle, createVoiceIncidentBundleRoutes } from './incidentBundle';
 export { summarizeVoiceOpsStatus } from './opsStatus';
 export { createVoiceOpsStatusRoutes, renderVoiceOpsStatusHTML } from './opsStatusRoutes';
 export { createVoiceQualityRoutes, evaluateVoiceQuality, renderVoiceQualityHTML } from './qualityRoutes';
@@ -105,10 +106,11 @@ export type { VoicePhoneAgentCarrier, VoicePhoneAgentCarrierSummary, VoicePhoneA
 export type { VoicePhoneAgentProductionSmokeIssue, VoicePhoneAgentProductionSmokeHandlerOptions, VoicePhoneAgentProductionSmokeHTMLHandlerOptions, VoicePhoneAgentProductionSmokeOptions, VoicePhoneAgentProductionSmokeReport, VoicePhoneAgentProductionSmokeRoutesOptions, VoicePhoneAgentProductionSmokeRequirement } from './phoneAgentProductionSmoke';
 export type { VoiceOpsConsoleLink, VoiceOpsConsoleReport, VoiceOpsConsoleRoutesOptions } from './opsConsoleRoutes';
 export type { VoiceOpsStatus, VoiceOpsStatusLink, VoiceOpsStatusOptions, VoiceOpsStatusReport, VoiceOpsStatusRoutesOptions } from './opsStatus';
-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 { VoiceProductionReadinessAction, VoiceProductionReadinessAuditOptions, VoiceProductionReadinessAuditRequirement, VoiceProductionReadinessAuditSummary, VoiceProductionReadinessCheck, VoiceProductionReadinessGateIssue, VoiceProductionReadinessGateOptions, VoiceProductionReadinessGateProfile, VoiceProductionReadinessGateProfileSurface, VoiceProductionReadinessGateReport, VoiceProductionReadinessOpsActionHistoryOptions, VoiceProductionReadinessOpsActionHistorySummary, VoiceProductionReadinessOperationsRecordLink, VoiceProductionReadinessOperationsRecordLinks, 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 { VoiceIncidentBundle, VoiceIncidentBundleFormat, VoiceIncidentBundleOptions, VoiceIncidentBundleRoutesOptions, VoiceIncidentBundleSummary } from './incidentBundle';
 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

@@ -20482,6 +20482,7 @@ var readinessGateCodes = {
   "Delivery runtime": "voice.readiness.delivery_runtime",
   "Handoff delivery": "voice.readiness.handoff_delivery",
   "Live latency proof": "voice.readiness.live_latency",
+  "Operations records": "voice.readiness.operations_records",
   "Operator action history": "voice.readiness.operator_action_history",
   "Phone agent production smoke": "voice.readiness.phone_agent_smoke",
   "Provider contract matrix": "voice.readiness.provider_contract_matrix",
@@ -20810,6 +20811,46 @@ var summarizeLiveLatency = (events, options) => {
     warnings
   };
 };
+var getString12 = (value) => typeof value === "string" ? value : undefined;
+var getNumber7 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
+var voiceOperationsRecordHref = (base, sessionId) => {
+  const encoded = encodeURIComponent(sessionId);
+  if (base.includes(":sessionId")) {
+    return base.replace(":sessionId", encoded);
+  }
+  return `${base.replace(/\/+$/, "")}/${encoded}`;
+};
+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: getString12(event.payload.error),
+    href: voiceOperationsRecordHref(input.base, event.sessionId),
+    label: "Open provider error operations record",
+    sessionId: event.sessionId,
+    status: "fail"
+  }));
+  const failingLatency = input.events.filter((event) => event.type === "client.live_latency").map((event) => ({
+    event,
+    latencyMs: getNumber7(event.payload.latencyMs) ?? getNumber7(event.payload.elapsedMs)
+  })).filter((entry) => entry.latencyMs !== undefined && entry.latencyMs > input.liveLatencyWarnAfterMs).map(({ event, latencyMs }) => ({
+    detail: `${latencyMs}ms live latency`,
+    href: voiceOperationsRecordHref(input.base, event.sessionId),
+    label: "Open latency operations record",
+    sessionId: event.sessionId,
+    status: latencyMs > input.liveLatencyFailAfterMs ? "fail" : "warn"
+  }));
+  return {
+    failedSessions: input.failedSessionIds.map((sessionId) => ({
+      href: voiceOperationsRecordHref(input.base, sessionId),
+      label: "Open failed session operations record",
+      sessionId,
+      status: failedSessionSet.has(sessionId) ? "fail" : "warn"
+    })),
+    failingLatency,
+    providerErrors
+  };
+};
+var firstOperationsRecordHref = (links) => links[0]?.href;
 var buildVoiceProductionReadinessReport = async (options, input = {}) => {
   const request = input.request ?? new Request("http://localhost/");
   const query = input.query ?? {};
@@ -20873,6 +20914,14 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
   const deliveryRuntime = summarizeDeliveryRuntime(deliveryRuntimeSummary);
   const degradedProviders = providers.filter((provider) => provider.status === "degraded" || provider.status === "rate-limited" || provider.status === "suppressed").length;
   const failedSessions = sessions.filter((session) => session.status === "failed").length;
+  const failedSessionItems = sessions.filter((session) => session.status === "failed");
+  const operationsRecords = buildOperationsRecordLinks({
+    base: options.links?.operationsRecords ?? "/voice-operations",
+    events,
+    failedSessionIds: failedSessionItems.map((session) => session.sessionId),
+    liveLatencyFailAfterMs: options.liveLatencyFailAfterMs ?? 3200,
+    liveLatencyWarnAfterMs: options.liveLatencyWarnAfterMs ?? 1800
+  });
   const checks = [
     {
       detail: quality.status === "pass" ? "Quality gates are passing." : "Quality gates need attention.",
@@ -20904,11 +20953,18 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     },
     {
       detail: providerRecovery.unresolvedErrors > 0 ? `${providerRecovery.unresolvedErrors} provider error(s) have no recovered fallback evidence.` : providerRecovery.recovered > 0 ? `${providerRecovery.recovered} provider fallback recovery event(s) kept sessions healthy.` : "No provider fallback recovery was needed in the current trace window.",
-      href: options.links?.resilience ?? "/resilience",
+      href: firstOperationsRecordHref(operationsRecords.providerErrors) ?? options.links?.resilience ?? "/resilience",
       label: "Provider fallback recovery",
       status: providerRecovery.status,
       value: providerRecovery.total === 0 ? "0 events" : `${providerRecovery.recovered}/${providerRecovery.total}`,
       actions: providerRecovery.status === "pass" ? [] : [
+        ...firstOperationsRecordHref(operationsRecords.providerErrors) ? [
+          {
+            description: "Open the exact call/session operations record for the first unresolved provider error.",
+            href: firstOperationsRecordHref(operationsRecords.providerErrors),
+            label: "Open failing operations record"
+          }
+        ] : [],
         {
           description: "Open provider resilience traces and inspect unresolved provider errors.",
           href: options.links?.resilience ?? "/resilience",
@@ -20918,11 +20974,18 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     },
     {
       detail: failedSessions === 0 ? sessions.length > 0 ? "Recent sessions have no recorded provider/session failures." : "No sessions have been recorded yet; run a smoke or live session for proof." : `${failedSessions} recent session(s) have failures.`,
-      href: options.links?.sessions ?? "/sessions",
+      href: firstOperationsRecordHref(operationsRecords.failedSessions) ?? options.links?.sessions ?? "/sessions",
       label: "Session health",
       status: failedSessions > 0 ? "fail" : sessions.length === 0 ? "warn" : "pass",
       value: `${sessions.length - failedSessions}/${sessions.length}`,
       actions: failedSessions > 0 ? [
+        ...firstOperationsRecordHref(operationsRecords.failedSessions) ? [
+          {
+            description: "Open the exact failed call/session operations record.",
+            href: firstOperationsRecordHref(operationsRecords.failedSessions),
+            label: "Open failed operations record"
+          }
+        ] : [],
         {
           description: "Open failed sessions and replay traces.",
           href: `${options.links?.sessions ?? "/sessions"}?status=failed`,
@@ -20974,12 +21037,19 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
   const proofSource = (...keys) => keys.map((key) => proofSources?.[key]).find((source) => source !== undefined);
   checks.push({
     detail: liveLatency.total === 0 ? "No browser live-latency measurements are recorded yet." : liveLatency.status === "pass" ? `Live browser turn latency averages ${liveLatency.averageLatencyMs}ms.` : `${liveLatency.failed} failed and ${liveLatency.warnings} warned live-latency measurement(s).`,
-    href: options.links?.liveLatency ?? "/traces",
+    href: firstOperationsRecordHref(operationsRecords.failingLatency) ?? options.links?.liveLatency ?? "/traces",
     label: "Live latency proof",
     proofSource: proofSource("liveLatency", "liveLatencyProof"),
     status: liveLatency.status,
     value: liveLatency.averageLatencyMs === undefined ? `${liveLatency.total} samples` : `${liveLatency.averageLatencyMs}ms avg`,
     actions: liveLatency.status === "pass" ? [] : [
+      ...firstOperationsRecordHref(operationsRecords.failingLatency) ? [
+        {
+          description: "Open the exact call/session operations record for the slow live turn.",
+          href: firstOperationsRecordHref(operationsRecords.failingLatency),
+          label: "Open latency operations record"
+        }
+      ] : [],
       {
         description: "Run a live browser voice turn and inspect the persisted latency trace.",
         href: options.links?.liveLatency ?? "/traces",
@@ -21260,6 +21330,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       handoffs: "/handoffs",
       handoffRetry: "/api/voice-handoffs/retry",
       liveLatency: "/traces",
+      operationsRecords: "/voice-operations",
       opsActions: "/voice/ops-actions",
       phoneAgentSmoke: "/sessions",
       providerContracts: "/provider-contracts",
@@ -21272,6 +21343,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       ...options.links
     },
     profile: options.profile || undefined,
+    operationsRecords,
     proofSources,
     status: rollupStatus2(checks),
     summary: {
@@ -22193,11 +22265,11 @@ 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 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 = getString12(payload[key]);
+    const value = getString13(payload[key]);
     if (value) {
       return value;
     }
@@ -22206,7 +22278,7 @@ var firstString3 = (payload, keys) => {
 };
 var firstNumber3 = (payload, keys) => {
   for (const key of keys) {
-    const value = getNumber7(payload[key]);
+    const value = getNumber8(payload[key]);
     if (value !== undefined) {
       return value;
     }
@@ -22234,15 +22306,15 @@ var timelineLabel = (event) => {
     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)})` : ""}`;
+      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 ${getString12(event.payload.toolName) ?? "call"}`;
+      return `Tool ${getString13(event.payload.toolName) ?? "call"}`;
     case "agent.handoff":
-      return `Agent handoff${getString12(event.payload.targetAgentId) ? ` to ${getString12(event.payload.targetAgentId)}` : ""}`;
+      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":
@@ -22252,11 +22324,11 @@ var timelineLabel = (event) => {
     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)}` : ""}`;
+      return `Error${getString13(event.payload.error) ? `: ${getString13(event.payload.error)}` : ""}`;
     case "turn.cost":
       return "Cost telemetry";
     case "turn_latency.stage":
-      return `Latency ${getString12(event.payload.stage) ?? "stage"}`;
+      return `Latency ${getString13(event.payload.stage) ?? "stage"}`;
     case "workflow.contract":
       return `Workflow contract ${eventStatus(event) ?? ""}`.trim();
     default:
@@ -22449,26 +22521,26 @@ var createVoiceTraceTimelineRoutes = (options) => {
 };
 
 // src/operationsRecord.ts
-var getString13 = (value) => typeof value === "string" ? value : undefined;
-var getNumber8 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
+var getString14 = (value) => typeof value === "string" ? value : undefined;
+var getNumber9 = (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),
+  fromAgentId: getString14(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),
+  reason: getString14(event.payload.reason),
+  status: getString14(event.payload.status),
+  summary: getString14(event.payload.summary),
+  targetAgentId: getString14(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),
+  elapsedMs: getNumber9(event.payload.elapsedMs),
+  error: getString14(event.payload.error),
+  status: getString14(event.payload.status),
+  toolCallId: getString14(event.payload.toolCallId),
+  toolName: getString14(event.payload.toolName),
   turnId: event.turnId
 });
 var resolveOutcome4 = (events) => {
@@ -22572,6 +22644,159 @@ var createVoiceOperationsRecordRoutes = (options) => {
   }
   return routes;
 };
+// src/incidentBundle.ts
+import { Elysia as Elysia38 } from "elysia";
+var buildSummary = (record) => ({
+  auditEvents: record.audit?.total ?? 0,
+  durationMs: record.summary.callDurationMs,
+  errors: record.summary.errorCount,
+  handoffs: record.handoffs.length,
+  providers: record.providers.map((provider) => provider.provider),
+  sessionId: record.sessionId,
+  status: record.status,
+  tools: record.tools.length,
+  traceEvents: record.traceEvents.length,
+  turns: record.summary.turnCount
+});
+var renderIncidentMarkdown = (input) => {
+  const lines = [
+    `# ${input.title ?? `Voice Incident ${input.summary.sessionId}`}`,
+    "",
+    `Session: ${input.summary.sessionId}`,
+    `Status: ${input.summary.status}`,
+    `Trace events: ${input.summary.traceEvents}`,
+    `Audit events: ${input.summary.auditEvents}`,
+    `Turns: ${input.summary.turns}`,
+    `Errors: ${input.summary.errors}`,
+    `Handoffs: ${input.summary.handoffs}`,
+    `Tools: ${input.summary.tools}`,
+    `Providers: ${input.summary.providers.join(", ") || "none"}`,
+    input.summary.durationMs === undefined ? undefined : `Duration: ${input.summary.durationMs}ms`,
+    "",
+    "## Outcome",
+    "",
+    `- Assistant replies: ${input.record.outcome.assistantReplies}`,
+    `- Complete: ${input.record.outcome.complete ? "yes" : "no"}`,
+    `- Escalated: ${input.record.outcome.escalated ? "yes" : "no"}`,
+    `- Transferred: ${input.record.outcome.transferred ? "yes" : "no"}`,
+    `- Voicemail: ${input.record.outcome.voicemail ? "yes" : "no"}`,
+    `- No answer: ${input.record.outcome.noAnswer ? "yes" : "no"}`,
+    "",
+    "## Handoffs",
+    "",
+    ...input.record.handoffs.length ? input.record.handoffs.map((handoff) => `- ${handoff.fromAgentId ?? "unknown"} -> ${handoff.targetAgentId ?? "unknown"} ${handoff.status ?? ""} ${handoff.summary ?? handoff.reason ?? ""}`.trim()) : ["- none"],
+    "",
+    "## Tools",
+    "",
+    ...input.record.tools.length ? input.record.tools.map((tool) => `- ${tool.toolName ?? "tool"} ${tool.status ?? ""} ${tool.elapsedMs === undefined ? "" : `${tool.elapsedMs}ms`} ${tool.error ?? ""}`.trim()) : ["- none"],
+    "",
+    "## Trace Evidence",
+    "",
+    input.traceMarkdown,
+    ""
+  ].filter((line) => line !== undefined);
+  if (input.auditMarkdown) {
+    lines.push("## Audit Evidence", "", input.auditMarkdown);
+  }
+  return lines.join(`
+`);
+};
+var redactRecordValue = (value, redactedEvents, redact) => {
+  if (!redact) {
+    return value;
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => redactRecordValue(item, redactedEvents, redact));
+  }
+  if (typeof value === "string") {
+    return redactVoiceTraceText(value, redact);
+  }
+  if (typeof value === "object" && value) {
+    return Object.fromEntries(Object.entries(value).map(([key, entryValue]) => [
+      key,
+      key === "events" || key === "traceEvents" ? redactedEvents : redactRecordValue(entryValue, redactedEvents, redact)
+    ]));
+  }
+  return value;
+};
+var redactOperationsRecord = (record, input) => ({
+  ...redactRecordValue(record, input.traceEvents, input.redact),
+  audit: record.audit ? {
+    ...record.audit,
+    events: input.auditEvents ?? []
+  } : undefined,
+  traceEvents: input.traceEvents
+});
+var buildVoiceIncidentBundle = async (options) => {
+  const record = await buildVoiceOperationsRecord(options);
+  const redactedTraceEvents = options.redact ? redactVoiceTraceEvents(record.traceEvents, options.redact) : record.traceEvents;
+  const redactedAuditEvents = options.redact && record.audit ? redactVoiceAuditEvents(record.audit.events, options.redact) : record.audit?.events;
+  const redactedRecord = redactOperationsRecord(record, {
+    auditEvents: redactedAuditEvents,
+    redact: options.redact,
+    traceEvents: redactedTraceEvents
+  });
+  const summary = buildSummary(redactedRecord);
+  const traceMarkdown = renderVoiceTraceMarkdown(record.traceEvents, {
+    evaluation: options.evaluation,
+    redact: options.redact,
+    title: `Voice Incident Trace ${options.sessionId}`
+  });
+  const auditMarkdown = record.audit ? renderVoiceAuditMarkdown(record.audit.events, {
+    redact: options.redact,
+    title: `Voice Incident Audit ${options.sessionId}`
+  }) : undefined;
+  const markdown = renderIncidentMarkdown({
+    auditMarkdown,
+    record: redactedRecord,
+    summary,
+    title: options.title,
+    traceMarkdown
+  });
+  return {
+    auditMarkdown,
+    exportedAt: Date.now(),
+    formatVersion: 1,
+    markdown,
+    record: redactedRecord,
+    redacted: Boolean(options.redact),
+    sessionId: options.sessionId,
+    summary,
+    traceMarkdown
+  };
+};
+var createVoiceIncidentBundleRoutes = (options) => {
+  const path = options.path ?? "/api/voice-incidents/:sessionId";
+  const markdownPath = options.markdownPath === undefined ? "/voice-incidents/:sessionId/markdown" : options.markdownPath;
+  const routes = new Elysia38({
+    name: options.name ?? "absolutejs-voice-incident-bundle"
+  });
+  const getSessionId = (params) => params.sessionId ?? "";
+  const buildBundle = (sessionId) => buildVoiceIncidentBundle({
+    audit: options.audit,
+    evaluation: options.evaluation,
+    events: options.events,
+    redact: options.redact,
+    sessionId,
+    store: options.store,
+    title: options.title
+  });
+  routes.get(path, async ({ params }) => Response.json(await buildBundle(getSessionId(params)), {
+    headers: options.headers
+  }));
+  if (markdownPath) {
+    routes.get(markdownPath, async ({ params }) => {
+      const bundle = await buildBundle(getSessionId(params));
+      return new Response(bundle.markdown, {
+        headers: {
+          "Content-Type": "text/markdown; charset=utf-8",
+          ...options.headers
+        }
+      });
+    });
+  }
+  return routes;
+};
 // src/opsStatus.ts
 var DEFAULT_LINKS2 = [
   {
@@ -22744,7 +22969,7 @@ var summarizeVoiceOpsStatus = async (options) => {
   };
 };
 // src/opsStatusRoutes.ts
-import { Elysia as Elysia38 } from "elysia";
+import { Elysia as Elysia39 } 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";
@@ -22756,7 +22981,7 @@ var renderVoiceOpsStatusHTML = (report, options = {}) => {
 };
 var createVoiceOpsStatusRoutes = (options) => {
   const path = options.path ?? "/api/voice/ops-status";
-  const routes = new Elysia38({
+  const routes = new Elysia39({
     name: options.name ?? "absolutejs-voice-ops-status"
   });
   routes.get(path, async () => summarizeVoiceOpsStatus(options));
@@ -23189,10 +23414,10 @@ var createVoiceTTSProviderRouter = (options) => {
   };
 };
 // src/traceDeliveryRoutes.ts
-import { Elysia as Elysia39 } from "elysia";
+import { Elysia as Elysia40 } 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) => {
+var getString15 = (value) => typeof value === "string" && value.trim() ? value.trim() : undefined;
+var getNumber10 = (value) => {
   if (typeof value === "number" && Number.isFinite(value)) {
     return value;
   }
@@ -23203,13 +23428,13 @@ var getNumber9 = (value) => {
   return;
 };
 var parseStatus2 = (value) => {
-  const text = getString14(value);
+  const text = getString15(value);
   return text === "pending" || text === "delivered" || text === "failed" || text === "skipped" || text === "all" ? text : undefined;
 };
 var resolveVoiceTraceDeliveryFilter = (query = {}, base = {}) => ({
   ...base,
-  limit: getNumber9(query.limit) ?? base.limit,
-  q: getString14(query.q) ?? base.q,
+  limit: getNumber10(query.limit) ?? base.limit,
+  q: getString15(query.q) ?? base.q,
   status: parseStatus2(query.status) ?? base.status
 });
 var deliverySearchText2 = (delivery) => [
@@ -23298,7 +23523,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 Elysia39({
+  const routes = new Elysia40({
     name: options.name ?? "absolutejs-voice-trace-deliveries"
   }).get(path, createVoiceTraceDeliveryJSONHandler(options));
   if (htmlPath !== false) {
@@ -23922,7 +24147,7 @@ var createVoiceMemoryStore = () => {
   return { get, getOrCreate, list, remove, set };
 };
 // src/opsWebhook.ts
-import { Elysia as Elysia40 } from "elysia";
+import { Elysia as Elysia41 } from "elysia";
 var toHex6 = (bytes) => Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
 var signVoiceOpsWebhookBody = async (input) => {
   const encoder = new TextEncoder;
@@ -24052,7 +24277,7 @@ var verifyVoiceOpsWebhookSignature = async (input) => {
 };
 var createVoiceOpsWebhookReceiverRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice-ops/webhook";
-  return new Elysia40().post(path, async ({ body, request, set }) => {
+  return new Elysia41().post(path, async ({ body, request, set }) => {
     const bodyText = typeof body === "string" ? body : JSON.stringify(body);
     if (options.signingSecret) {
       const verification = await verifyVoiceOpsWebhookSignature({
@@ -25200,6 +25425,7 @@ export {
   createVoiceIntegrationSinkWorker,
   createVoiceIntegrationHTTPSink,
   createVoiceIntegrationEvent,
+  createVoiceIncidentBundleRoutes,
   createVoiceHubSpotTaskUpdateSink,
   createVoiceHubSpotTaskSyncSinks,
   createVoiceHubSpotTaskSink,
@@ -25309,6 +25535,7 @@ export {
   buildVoiceOpsConsoleReport,
   buildVoiceOpsActionHistoryReport,
   buildVoiceOperationsRecord,
+  buildVoiceIncidentBundle,
   buildVoiceDiagnosticsMarkdown,
   buildVoiceDemoReadyReport,
   buildVoiceDeliverySinkReport,

package/dist/productionReadiness.d.ts

@@ -86,6 +86,7 @@ export type VoiceProductionReadinessReport = {
         handoffs?: string;
         handoffRetry?: string;
         liveLatency?: string;
+        operationsRecords?: string;
         opsActions?: string;
         phoneAgentSmoke?: string;
         providerContracts?: string;
@@ -98,6 +99,7 @@ export type VoiceProductionReadinessReport = {
     };
     profile?: VoiceProductionReadinessProfileExplanation;
     proofSources?: Record<string, VoiceProductionReadinessProofSource>;
+    operationsRecords?: VoiceProductionReadinessOperationsRecordLinks;
     status: VoiceProductionReadinessStatus;
     summary: {
         agentSquadContracts?: {
@@ -174,6 +176,18 @@ export type VoiceProductionReadinessReport = {
         traceDeliveries?: VoiceProductionReadinessTraceDeliverySummary;
     };
 };
+export type VoiceProductionReadinessOperationsRecordLink = {
+    detail?: string;
+    href: string;
+    label: string;
+    sessionId: string;
+    status: VoiceProductionReadinessStatus;
+};
+export type VoiceProductionReadinessOperationsRecordLinks = {
+    failedSessions: VoiceProductionReadinessOperationsRecordLink[];
+    failingLatency: VoiceProductionReadinessOperationsRecordLink[];
+    providerErrors: VoiceProductionReadinessOperationsRecordLink[];
+};
 export type VoiceProductionReadinessAuditRequirement = {
     label?: string;
     maxAgeMs?: number;

package/package.json

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