@absolutejs/voice 0.0.22-beta.435 → 0.0.22-beta.437

package/dist/incidentBundle.d.ts

@@ -1,5 +1,6 @@
 import { Elysia } from 'elysia';
 import { type VoiceOperationsRecord, type VoiceOperationsRecordOptions } from './operationsRecord';
+import type { VoiceIncidentRecoveryOutcomeReport } from './incidentTimeline';
 import { type VoiceTraceRedactionConfig } from './trace';
 export type VoiceIncidentBundleFormat = 'json' | 'markdown';
 export type VoiceIncidentBundle = {
@@ -8,6 +9,7 @@ export type VoiceIncidentBundle = {
     formatVersion: 1;
     markdown: string;
     record: VoiceOperationsRecord;
+    recoveryOutcomes?: VoiceIncidentRecoveryOutcomeReport;
     redacted: boolean;
     sessionId: string;
     summary: VoiceIncidentBundleSummary;
@@ -46,6 +48,7 @@ export type VoiceIncidentBundleSummary = {
 };
 export type VoiceIncidentBundleOptions = VoiceOperationsRecordOptions & {
     redact?: VoiceTraceRedactionConfig;
+    recoveryOutcomes?: VoiceIncidentRecoveryOutcomeReport;
     title?: string;
 };
 export type VoiceIncidentBundleRoutesOptions = Omit<VoiceIncidentBundleOptions, 'sessionId'> & {

package/dist/incidentTimeline.d.ts

@@ -38,6 +38,31 @@ export type VoiceIncidentRecoveryActionHandlerInput = {
     request: Request;
 };
 export type VoiceIncidentRecoveryActionHandler = (input: VoiceIncidentRecoveryActionHandlerInput) => Promise<VoiceIncidentRecoveryActionResult> | VoiceIncidentRecoveryActionResult;
+export type VoiceIncidentRecoveryOutcome = 'failed' | 'improved' | 'regressed' | 'unchanged';
+export type VoiceIncidentRecoveryOutcomeEntry = {
+    actionId: string;
+    afterStatus?: VoiceIncidentTimelineStatus;
+    at: number;
+    beforeStatus?: VoiceIncidentTimelineStatus;
+    detail?: string;
+    eventId: string;
+    outcome: VoiceIncidentRecoveryOutcome;
+    status?: number;
+    traceId?: string;
+};
+export type VoiceIncidentRecoveryOutcomeReport = {
+    checkedAt: number;
+    entries: VoiceIncidentRecoveryOutcomeEntry[];
+    failed: number;
+    improved: number;
+    regressed: number;
+    total: number;
+    unchanged: number;
+};
+export type VoiceIncidentRecoveryOutcomeOptions = {
+    audit?: VoiceAuditEventStore;
+    limit?: number;
+};
 export type VoiceIncidentTimelineEvent = {
     action?: VoiceIncidentTimelineAction;
     at: number;
@@ -102,9 +127,15 @@ export type VoiceIncidentTimelineRoutesOptions = VoiceIncidentTimelineOptions &
     name?: string;
     path?: string;
     render?: (report: VoiceIncidentTimelineReport) => string | Promise<string>;
+    recoveryOutcomeHtmlPath?: false | string;
+    recoveryOutcomePath?: false | string;
     title?: string;
     trace?: VoiceTraceEventStore;
 };
+export declare const buildVoiceIncidentRecoveryOutcomeReport: (options: VoiceIncidentRecoveryOutcomeOptions) => Promise<VoiceIncidentRecoveryOutcomeReport>;
+export declare const renderVoiceIncidentRecoveryOutcomeHTML: (report: VoiceIncidentRecoveryOutcomeReport, options?: {
+    title?: string;
+}) => string;
 export declare const buildVoiceIncidentTimelineReport: (options: VoiceIncidentTimelineOptions) => Promise<VoiceIncidentTimelineReport>;
 export declare const renderVoiceIncidentTimelineMarkdown: (report: VoiceIncidentTimelineReport, options?: {
     title?: string;

package/dist/index.d.ts

@@ -52,7 +52,7 @@ export { assertVoiceLiveOpsControlEvidence, assertVoiceLiveOpsEvidence, buildVoi
 export type { VoiceLiveOpsAction, VoiceLiveOpsActionInput, VoiceLiveOpsActionResult, VoiceLiveOpsControllerOptions, VoiceLiveOpsControlState, VoiceLiveOpsControlStatus, VoiceLiveOpsControlStore, VoiceLiveOpsControlEvidenceInput, VoiceLiveOpsControlEvidenceReport, VoiceLiveOpsEvidenceInput, VoiceLiveOpsEvidenceReport, VoiceLiveOpsRoutesOptions } from './liveOps';
 export { buildVoiceDeliveryRuntimeReport, createVoiceDeliveryRuntime, createVoiceDeliveryRuntimePresetConfig, createVoiceDeliveryRuntimeRoutes, renderVoiceDeliveryRuntimeHTML } from './deliveryRuntime';
 export { buildVoiceOperationalStatusReport, createVoiceOperationalStatusRoutes, renderVoiceOperationalStatusHTML } from './operationalStatus';
-export { buildVoiceIncidentTimelineReport, createVoiceIncidentTimelineRoutes, renderVoiceIncidentTimelineHTML, renderVoiceIncidentTimelineMarkdown } from './incidentTimeline';
+export { buildVoiceIncidentRecoveryOutcomeReport, buildVoiceIncidentTimelineReport, createVoiceIncidentTimelineRoutes, renderVoiceIncidentRecoveryOutcomeHTML, renderVoiceIncidentTimelineHTML, renderVoiceIncidentTimelineMarkdown } from './incidentTimeline';
 export { applyVoiceDataRetentionPolicy, assertVoiceDataControlEvidence, buildVoiceDataControlReport, buildVoiceDataRetentionPlan, createVoiceDataControlRoutes, createVoiceZeroRetentionPolicy, evaluateVoiceDataControlEvidence, renderVoiceDataControlHTML, renderVoiceDataControlMarkdown, voiceComplianceRedactionDefaults } from './dataControl';
 export type { VoiceDataControlAssertionInput, VoiceDataControlAssertionReport, VoiceDataControlProviderKeySurface, VoiceDataControlReport, VoiceDataControlRoutesOptions, VoiceDataControlStorageSurface, VoiceDataRetentionPolicy, VoiceDataRetentionReport, VoiceDataRetentionScope, VoiceDataRetentionScopeReport, VoiceDataRetentionStores } from './dataControl';
 export type { VoiceDemoReadyReport, VoiceDemoReadyRoutesOptions, VoiceDemoReadySection, VoiceDemoReadyStatus } from './demoReadyRoutes';
@@ -60,7 +60,7 @@ export type { VoiceDeliverySinkDescriptor, VoiceDeliverySinkDescriptorInput, Voi
 export type { VoiceOpsActionAuditRecord, VoiceOpsActionAuditRoutesOptions, VoiceOpsActionHistoryEntry, VoiceOpsActionHistoryReport } from './opsActionAuditRoutes';
 export type { VoiceDeliveryRuntime, VoiceDeliveryRuntimeAuditConfig, VoiceDeliveryRuntimeConfig, VoiceDeliveryRuntimeFilePresetOptions, VoiceDeliveryRuntimePresetLeaseConfig, VoiceDeliveryRuntimePresetMode, VoiceDeliveryRuntimePresetOptions, VoiceDeliveryRuntimeReport, VoiceDeliveryRuntimeRoutesOptions, VoiceDeliveryRuntimeS3PresetOptions, VoiceDeliveryRuntimeSummary, VoiceDeliveryRuntimeTickResult, VoiceDeliveryRuntimeTraceConfig, VoiceDeliveryRuntimeWebhookPresetOptions } from './deliveryRuntime';
 export type { VoiceOperationalStatus, VoiceOperationalStatusCheck, VoiceOperationalStatusOptions, VoiceOperationalStatusReport, VoiceOperationalStatusRoutesOptions, VoiceOperationalStatusValue } from './operationalStatus';
-export type { VoiceIncidentRecoveryAction, VoiceIncidentRecoveryActionHandler, VoiceIncidentRecoveryActionHandlerInput, VoiceIncidentRecoveryActionResult, VoiceIncidentTimelineAction, VoiceIncidentTimelineEvent, VoiceIncidentTimelineLinks, VoiceIncidentTimelineOptions, VoiceIncidentTimelineReport, VoiceIncidentTimelineRoutesOptions, VoiceIncidentTimelineSeverity, VoiceIncidentTimelineStatus, VoiceIncidentTimelineValue } from './incidentTimeline';
+export type { VoiceIncidentRecoveryAction, VoiceIncidentRecoveryActionHandler, VoiceIncidentRecoveryActionHandlerInput, VoiceIncidentRecoveryActionResult, VoiceIncidentRecoveryOutcome, VoiceIncidentRecoveryOutcomeEntry, VoiceIncidentRecoveryOutcomeOptions, VoiceIncidentRecoveryOutcomeReport, VoiceIncidentTimelineAction, VoiceIncidentTimelineEvent, VoiceIncidentTimelineLinks, VoiceIncidentTimelineOptions, VoiceIncidentTimelineReport, VoiceIncidentTimelineRoutesOptions, VoiceIncidentTimelineSeverity, VoiceIncidentTimelineStatus, VoiceIncidentTimelineValue } from './incidentTimeline';
 export { compareVoiceEvalBaseline, createVoiceFileEvalBaselineStore, createVoiceFileScenarioFixtureStore, createVoiceEvalRoutes, renderVoiceEvalBaselineHTML, renderVoiceEvalHTML, renderVoiceScenarioEvalHTML, renderVoiceScenarioFixtureEvalHTML, runVoiceScenarioEvals, runVoiceScenarioFixtureEvals, runVoiceSessionEvals } from './evalRoutes';
 export { assertVoiceSimulationSuiteEvidence, createVoiceSimulationSuiteRoutes, evaluateVoiceSimulationSuiteEvidence, renderVoiceSimulationSuiteHTML, runVoiceSimulationSuite } from './simulationSuite';
 export { createVoiceWorkflowContract, createVoiceWorkflowContractHandler, createVoiceWorkflowContractPreset, createVoiceWorkflowScenario, recordVoiceWorkflowContractTrace, validateVoiceWorkflowRouteResult } from './workflowContract';

package/dist/index.js

@@ -26759,6 +26759,41 @@ var createCallDebuggerArtifact = (report, href) => ({
   sessionId: report.sessionId,
   status: "pass"
 });
+var createIncidentBundleArtifact = (bundle) => ({
+  generatedAt: bundle.exportedAt,
+  id: `incident-bundle:${bundle.sessionId}`,
+  kind: "incident",
+  label: `Incident bundle ${bundle.sessionId}`,
+  metadata: {
+    errors: bundle.summary.errors,
+    recoveryOutcomes: bundle.recoveryOutcomes ? {
+      failed: bundle.recoveryOutcomes.failed,
+      improved: bundle.recoveryOutcomes.improved,
+      regressed: bundle.recoveryOutcomes.regressed,
+      total: bundle.recoveryOutcomes.total,
+      unchanged: bundle.recoveryOutcomes.unchanged
+    } : undefined,
+    status: bundle.summary.status
+  },
+  required: true,
+  sessionId: bundle.sessionId,
+  status: bundle.summary.status === "failed" ? "fail" : bundle.summary.status === "warning" ? "warn" : "pass"
+});
+var createIncidentRecoveryOutcomeArtifact = (report) => ({
+  generatedAt: report.checkedAt,
+  id: `incident-recovery-outcomes:${report.checkedAt}`,
+  kind: "incident-recovery-outcomes",
+  label: "Incident recovery outcomes",
+  metadata: {
+    failed: report.failed,
+    improved: report.improved,
+    regressed: report.regressed,
+    total: report.total,
+    unchanged: report.unchanged
+  },
+  required: true,
+  status: report.failed > 0 || report.regressed > 0 ? "fail" : report.unchanged > 0 ? "warn" : "pass"
+});
 var unique2 = (values) => [...new Set(values)].sort();
 var stripArtifactPathAnchor = (path) => path.split("#")[0] ?? path;
 var toEpochMs = (value) => {
@@ -27419,6 +27454,7 @@ var collectSessionIds = (input) => unique2([
   ...input.events.map((event) => event.sessionId),
   ...input.auditEvents.map((event) => event.sessionId).filter((sessionId) => Boolean(sessionId)),
   ...input.operationsRecords.map((record) => record.sessionId),
+  ...input.incidentBundles.map((bundle) => bundle.sessionId),
   ...input.sessionSnapshots.map((snapshot) => snapshot.sessionId),
   ...input.callDebuggerReports.map((report) => report.sessionId)
 ]);
@@ -27443,6 +27479,15 @@ var collectIssues = (input) => {
     });
   }
   for (const artifact of input.artifacts) {
+    if (artifact.required && (artifact.status === "fail" || artifact.status === "warn")) {
+      issues.push({
+        code: "voice.observability.artifact_failed",
+        detail: `${artifact.label} reported ${artifact.status}.`,
+        label: "Artifact status",
+        severity: artifact.status,
+        value: artifact.id
+      });
+    }
     if (artifact.path && artifact.status !== "pass" && artifact.required && artifact.bytes === undefined && artifact.freshness?.ageMs === undefined) {
       issues.push({
         code: "voice.observability.artifact_missing",
@@ -27541,14 +27586,22 @@ var buildVoiceObservabilityExport = async (options = {}) => {
   const events = await time("events", async () => options.events ?? await options.store?.list() ?? []);
   const auditEvents = await time("auditEvents", async () => options.audit ? await options.audit.list() : []);
   const baseOperationsRecords = options.operationsRecords ?? [];
-  const [sessionSnapshots, callDebuggerReports] = await time("supportArtifacts", () => Promise.all([
+  const [
+    sessionSnapshots,
+    callDebuggerReports,
+    incidentBundles,
+    incidentRecoveryOutcomeReports
+  ] = await time("supportArtifacts", () => Promise.all([
     resolveObservabilityExportList(options.sessionSnapshots),
-    resolveObservabilityExportList(options.callDebuggerReports)
+    resolveObservabilityExportList(options.callDebuggerReports),
+    resolveObservabilityExportList(options.incidentBundles),
+    resolveObservabilityExportList(options.incidentRecoveryOutcomeReports)
   ]));
   const sessionIds = await time("sessionIds", () => collectSessionIds({
     auditEvents,
     callDebuggerReports,
     events,
+    incidentBundles,
     operationsRecords: baseOperationsRecords,
     sessionIds: options.sessionIds,
     sessionSnapshots
@@ -27575,10 +27628,14 @@ var buildVoiceObservabilityExport = async (options = {}) => {
   const operationArtifacts = await time("operationArtifacts", () => operationsRecords.map((record) => createOperationArtifact(record, options.links?.operationsRecord?.(record.sessionId))));
   const sessionSnapshotArtifacts = await time("sessionSnapshotArtifacts", () => sessionSnapshots.map((snapshot) => createSessionSnapshotArtifact(snapshot, options.links?.sessionSnapshot?.(snapshot.sessionId))));
   const callDebuggerArtifacts = await time("callDebuggerArtifacts", () => callDebuggerReports.map((report) => createCallDebuggerArtifact(report, options.links?.callDebugger?.(report.sessionId))));
+  const incidentBundleArtifacts = await time("incidentBundleArtifacts", () => incidentBundles.map(createIncidentBundleArtifact));
+  const incidentRecoveryOutcomeArtifacts = await time("incidentRecoveryOutcomeArtifacts", () => incidentRecoveryOutcomeReports.map(createIncidentRecoveryOutcomeArtifact));
   const artifacts = await time("artifacts", async () => addArtifactDownloadHrefs(await verifyArtifacts([
     ...operationArtifacts,
     ...sessionSnapshotArtifacts,
     ...callDebuggerArtifacts,
+    ...incidentBundleArtifacts,
+    ...incidentRecoveryOutcomeArtifacts,
     ...options.artifacts ?? []
   ], options.artifactIntegrity), options.links));
   const operationHrefBySessionId = new Map(sessionIds.map((sessionId) => [
@@ -30183,6 +30240,62 @@ var defaultIncidentRecoveryActions = (events, links) => {
   return actions;
 };
 var worstStatus3 = (statuses) => statuses.includes("fail") ? "fail" : statuses.includes("warn") ? "warn" : "pass";
+var statusRank6 = (status) => status === "fail" ? 3 : status === "warn" ? 2 : status === "pass" ? 1 : 0;
+var isRecord4 = (value) => Boolean(value && typeof value === "object" && !Array.isArray(value));
+var getIncidentRecoveryBody = (event) => {
+  const payload = isRecord4(event.payload) ? event.payload : {};
+  return isRecord4(payload.body) ? payload.body : {};
+};
+var getIncidentRecoveryStatus = (value) => value === "fail" || value === "pass" || value === "warn" ? value : undefined;
+var getIncidentRecoveryDetail = (event) => {
+  const payload = isRecord4(event.payload) ? event.payload : {};
+  const body = getIncidentRecoveryBody(event);
+  const result = isRecord4(body.result) ? body.result : {};
+  const detail = result.detail ?? payload.error;
+  return typeof detail === "string" ? detail : undefined;
+};
+var toIncidentRecoveryOutcomeEntry = (event) => {
+  const body = getIncidentRecoveryBody(event);
+  const beforeStatus = getIncidentRecoveryStatus(body.beforeStatus);
+  const afterStatus = getIncidentRecoveryStatus(body.afterStatus);
+  const beforeRank = statusRank6(beforeStatus);
+  const afterRank = statusRank6(afterStatus);
+  const outcome = event.outcome === "error" ? "failed" : beforeRank > 0 && afterRank > 0 && afterRank < beforeRank ? "improved" : beforeRank > 0 && afterRank > beforeRank ? "regressed" : "unchanged";
+  const payload = isRecord4(event.payload) ? event.payload : {};
+  return {
+    actionId: event.action.replace(/^incident\./, ""),
+    afterStatus,
+    at: event.at,
+    beforeStatus,
+    detail: getIncidentRecoveryDetail(event),
+    eventId: event.id,
+    outcome,
+    status: typeof payload.status === "number" ? payload.status : undefined,
+    traceId: event.traceId
+  };
+};
+var buildVoiceIncidentRecoveryOutcomeReport = async (options) => {
+  const events = options.audit ? await options.audit.list({
+    limit: options.limit ?? 50,
+    resourceType: "voice.ops.action",
+    type: "operator.action"
+  }) : [];
+  const entries = events.filter((event) => event.action.startsWith("incident.")).map(toIncidentRecoveryOutcomeEntry).sort((left, right) => right.at - left.at);
+  return {
+    checkedAt: Date.now(),
+    entries,
+    failed: entries.filter((entry) => entry.outcome === "failed").length,
+    improved: entries.filter((entry) => entry.outcome === "improved").length,
+    regressed: entries.filter((entry) => entry.outcome === "regressed").length,
+    total: entries.length,
+    unchanged: entries.filter((entry) => entry.outcome === "unchanged").length
+  };
+};
+var renderVoiceIncidentRecoveryOutcomeHTML = (report, options = {}) => {
+  const title = options.title ?? "AbsoluteJS Voice Incident Recovery Outcomes";
+  const rows = report.entries.map((entry) => `<article class="${escapeHtml43(entry.outcome)}"><span>${escapeHtml43(entry.outcome.toUpperCase())}</span><h2>${escapeHtml43(entry.actionId)}</h2><p>${escapeHtml43(new Date(entry.at).toLocaleString())}</p><strong>${escapeHtml43(entry.beforeStatus ?? "unknown")} -> ${escapeHtml43(entry.afterStatus ?? "unknown")}</strong>${entry.detail ? `<p>${escapeHtml43(entry.detail)}</p>` : ""}</article>`).join("");
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml43(title)}</title><style>body{background:#10120d;color:#fbf4df;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:980px;padding:32px}.hero,article{background:#181711;border:1px solid #39301d;border-radius:24px;padding:20px}.hero{margin-bottom:16px}h1{font-size:clamp(2rem,6vw,4.5rem);line-height:.95}.summary{display:flex;flex-wrap:wrap;gap:10px}.summary span{border:1px solid #4a3f23;border-radius:999px;padding:8px 12px}section{display:grid;gap:12px}article.improved{border-color:rgba(34,197,94,.65)}article.failed,article.regressed{border-color:rgba(239,68,68,.8)}article.unchanged{border-color:rgba(245,158,11,.7)}article span{color:#fcd34d;font-weight:900;letter-spacing:.08em}article strong{display:block;font-size:1.4rem;margin:.5rem 0}p{color:#cfc5a8}</style></head><body><main><section class="hero"><span>Recovery proof</span><h1>${escapeHtml43(title)}</h1><div class="summary"><span>${String(report.improved)} improved</span><span>${String(report.unchanged)} unchanged</span><span>${String(report.regressed)} regressed</span><span>${String(report.failed)} failed</span><span>${String(report.total)} total</span></div></section><section>${rows || "<p>No incident recovery actions have been recorded.</p>"}</section></main></body></html>`;
+};
 var pushOperationalStatusEvents = (events, report, links) => {
   if (!report) {
     return;
@@ -30429,6 +30542,8 @@ var createVoiceIncidentTimelineRoutes = (options) => {
   const htmlPath = options.htmlPath === undefined ? "/voice/incident-timeline" : options.htmlPath;
   const markdownPath = options.markdownPath === undefined ? "/voice/incident-timeline.md" : options.markdownPath;
   const actionPath = options.actionPath === undefined ? "/api/voice/incident-timeline/actions" : options.actionPath;
+  const recoveryOutcomePath = options.recoveryOutcomePath === undefined ? "/api/voice/incident-timeline/recovery-outcomes" : options.recoveryOutcomePath;
+  const recoveryOutcomeHtmlPath = options.recoveryOutcomeHtmlPath === undefined ? "/voice/incident-recovery-outcomes" : options.recoveryOutcomeHtmlPath;
   const routes = new Elysia46({
     name: options.name ?? "absolutejs-voice-incident-timeline"
   }).get(path, async () => {
@@ -30552,6 +30667,34 @@ var createVoiceIncidentTimelineRoutes = (options) => {
       });
     });
   }
+  if (recoveryOutcomePath !== false) {
+    routes.get(recoveryOutcomePath, async () => {
+      const report = await buildVoiceIncidentRecoveryOutcomeReport({
+        audit: options.audit
+      });
+      return new Response(JSON.stringify(report), {
+        headers: {
+          "Content-Type": "application/json; charset=utf-8",
+          ...options.headers
+        }
+      });
+    });
+  }
+  if (recoveryOutcomeHtmlPath !== false) {
+    routes.get(recoveryOutcomeHtmlPath, async () => {
+      const report = await buildVoiceIncidentRecoveryOutcomeReport({
+        audit: options.audit
+      });
+      return new Response(renderVoiceIncidentRecoveryOutcomeHTML(report, {
+        title: `${options.title ?? "AbsoluteJS Voice Incident Timeline"} Recovery Outcomes`
+      }), {
+        headers: {
+          "Content-Type": "text/html; charset=utf-8",
+          ...options.headers
+        }
+      });
+    });
+  }
   return routes;
 };
 // src/dataControl.ts
@@ -36062,7 +36205,7 @@ var defaultRequirement = {
   requireFallback: false,
   requireTimeoutBudget: false
 };
-var statusRank6 = {
+var statusRank7 = {
   pass: 0,
   warn: 1,
   fail: 2
@@ -36078,7 +36221,7 @@ var surfaceProviderNames = (surface) => uniqueSorted8([
   ...isProviderList(surface.fallback) ? surface.fallback : [],
   ...isProviderList(surface.allowProviders) ? surface.allowProviders : []
 ]);
-var surfaceStatus = (issues) => issues.reduce((status, issue) => statusRank6[issue.status] > statusRank6[status] ? issue.status : status, "pass");
+var surfaceStatus = (issues) => issues.reduce((status, issue) => statusRank7[issue.status] > statusRank7[status] ? issue.status : status, "pass");
 var resolvedRequirement = (surface, options) => ({
   ...defaultRequirement,
   ...options.defaultRequirement ?? {},
@@ -37222,12 +37365,12 @@ var recommendVoiceProviderStack = (input) => {
   };
 };
 var rollupContractStatus = (checks) => checks.some((check) => check.status === "fail") ? "fail" : checks.some((check) => check.status === "warn") ? "warn" : "pass";
-var statusRank7 = {
+var statusRank8 = {
   pass: 0,
   warn: 1,
   fail: 2
 };
-var statusExceeds2 = (actual, max2) => statusRank7[actual] > statusRank7[max2];
+var statusExceeds2 = (actual, max2) => statusRank8[actual] > statusRank8[max2];
 var buildVoiceProviderContractMatrix = (input) => {
   const rows = input.contracts.map((contract) => {
     const configured = contract.configured !== false;
@@ -37817,6 +37960,7 @@ var buildSummary = (record) => ({
   turns: record.summary.turnCount
 });
 var renderIncidentMarkdown = (input) => {
+  const recoveryOutcomes = input.recoveryOutcomes;
   const lines = [
     `# ${input.title ?? `Voice Incident ${input.summary.sessionId}`}`,
     "",
@@ -37848,6 +37992,18 @@ var renderIncidentMarkdown = (input) => {
     "",
     ...input.record.tools.length ? input.record.tools.map((tool) => `- ${tool.toolName ?? "tool"} ${tool.status ?? ""} ${tool.elapsedMs === undefined ? "" : `${tool.elapsedMs}ms`} ${tool.error ?? ""}`.trim()) : ["- none"],
     "",
+    "## Recovery Outcomes",
+    "",
+    ...recoveryOutcomes ? [
+      `- Improved: ${recoveryOutcomes.improved}`,
+      `- Unchanged: ${recoveryOutcomes.unchanged}`,
+      `- Regressed: ${recoveryOutcomes.regressed}`,
+      `- Failed: ${recoveryOutcomes.failed}`,
+      `- Total actions: ${recoveryOutcomes.total}`,
+      "",
+      ...recoveryOutcomes.entries.length ? recoveryOutcomes.entries.map((entry) => `- ${entry.outcome}: ${entry.actionId} ${entry.beforeStatus ?? "unknown"} -> ${entry.afterStatus ?? "unknown"}${entry.detail ? ` - ${entry.detail}` : ""}`) : ["- no recovery actions recorded"]
+    ] : ["- no recovery outcome report attached"],
+    "",
     renderVoiceOperationsRecordGuardrailMarkdown(input.record),
     "",
     "## Trace Evidence",
@@ -37897,6 +38053,7 @@ var buildVoiceIncidentBundle = async (options) => {
     traceEvents: redactedTraceEvents
   });
   const summary = buildSummary(redactedRecord);
+  const recoveryOutcomes = options.recoveryOutcomes ? redactRecordValue(options.recoveryOutcomes, redactedTraceEvents, options.redact) : undefined;
   const traceMarkdown = renderVoiceTraceMarkdown(record.traceEvents, {
     evaluation: options.evaluation,
     redact: options.redact,
@@ -37909,6 +38066,7 @@ var buildVoiceIncidentBundle = async (options) => {
   const markdown = renderIncidentMarkdown({
     auditMarkdown,
     record: redactedRecord,
+    recoveryOutcomes,
     summary,
     title: options.title,
     traceMarkdown
@@ -37919,6 +38077,7 @@ var buildVoiceIncidentBundle = async (options) => {
     formatVersion: 1,
     markdown,
     record: redactedRecord,
+    recoveryOutcomes,
     redacted: Boolean(options.redact),
     sessionId: options.sessionId,
     summary,
@@ -41402,6 +41561,7 @@ export {
   renderVoiceLatencySLOMarkdown,
   renderVoiceIncidentTimelineMarkdown,
   renderVoiceIncidentTimelineHTML,
+  renderVoiceIncidentRecoveryOutcomeHTML,
   renderVoiceHandoffHealthHTML,
   renderVoiceGuardrailMarkdown,
   renderVoiceFailureReplayMarkdown,
@@ -41903,6 +42063,7 @@ export {
   buildVoiceLiveOpsControlState,
   buildVoiceLatencySLOGate,
   buildVoiceIncidentTimelineReport,
+  buildVoiceIncidentRecoveryOutcomeReport,
   buildVoiceIncidentBundle,
   buildVoiceIOProviderRouterTraceEvent,
   buildVoiceGuardrailReport,

package/dist/observabilityExport.d.ts

@@ -4,6 +4,8 @@ import { Database } from 'bun:sqlite';
 import { type VoiceAuditSinkDeliveryQueueSummary, type VoiceAuditSinkDeliveryRecord, type VoiceAuditSinkDeliveryStore } from './auditSinks';
 import type { VoiceAuditEventStore, VoiceAuditEventType } from './audit';
 import type { VoiceCallDebuggerReport } from './callDebugger';
+import type { VoiceIncidentBundle } from './incidentBundle';
+import type { VoiceIncidentRecoveryOutcomeReport } from './incidentTimeline';
 import { type VoiceOperationsRecord } from './operationsRecord';
 import type { VoiceSessionSnapshot } from './sessionSnapshot';
 import { type VoiceTraceSinkDeliveryQueueSummary } from './queue';
@@ -43,7 +45,7 @@ export type VoiceObservabilityExportRecordValidationOptions = {
 };
 export declare const validateVoiceObservabilityExportRecord: (input: unknown, options?: VoiceObservabilityExportRecordValidationOptions) => VoiceObservabilityExportValidationResult;
 export declare const assertVoiceObservabilityExportRecord: (input: unknown, options?: VoiceObservabilityExportRecordValidationOptions) => VoiceObservabilityExportValidationResult;
-export type VoiceObservabilityExportArtifactKind = 'call-debugger' | 'incident' | 'markdown' | 'operations-record' | 'proof-pack' | 'readiness' | 'screenshot' | 'session-snapshot' | 'slo' | 'trace' | 'audit' | 'custom';
+export type VoiceObservabilityExportArtifactKind = 'call-debugger' | 'incident' | 'incident-recovery-outcomes' | 'markdown' | 'operations-record' | 'proof-pack' | 'readiness' | 'screenshot' | 'session-snapshot' | 'slo' | 'trace' | 'audit' | 'custom';
 export type VoiceObservabilityExportArtifactChecksum = {
     algorithm: 'sha256';
     value: string;
@@ -86,7 +88,7 @@ export type VoiceObservabilityExportEnvelope = {
     severity: VoiceObservabilityExportStatus;
     traceId?: string;
 };
-export type VoiceObservabilityExportIssueCode = 'voice.observability.no_evidence' | 'voice.observability.operation_failed' | 'voice.observability.artifact_missing' | 'voice.observability.artifact_stale' | 'voice.observability.audit_delivery_failed' | 'voice.observability.audit_delivery_pending' | 'voice.observability.trace_delivery_failed' | 'voice.observability.trace_delivery_pending';
+export type VoiceObservabilityExportIssueCode = 'voice.observability.no_evidence' | 'voice.observability.operation_failed' | 'voice.observability.artifact_failed' | 'voice.observability.artifact_missing' | 'voice.observability.artifact_stale' | 'voice.observability.audit_delivery_failed' | 'voice.observability.audit_delivery_pending' | 'voice.observability.trace_delivery_failed' | 'voice.observability.trace_delivery_pending';
 export type VoiceObservabilityExportIssue = {
     code: VoiceObservabilityExportIssueCode;
     detail?: string;
@@ -389,6 +391,8 @@ export type VoiceObservabilityExportOptions = {
         sessionSnapshot?: (sessionId: string) => string;
     };
     callDebuggerReports?: VoiceCallDebuggerReport[] | (() => VoiceCallDebuggerReport[] | Promise<VoiceCallDebuggerReport[]>);
+    incidentBundles?: VoiceIncidentBundle[] | (() => VoiceIncidentBundle[] | Promise<VoiceIncidentBundle[]>);
+    incidentRecoveryOutcomeReports?: VoiceIncidentRecoveryOutcomeReport[] | (() => VoiceIncidentRecoveryOutcomeReport[] | Promise<VoiceIncidentRecoveryOutcomeReport[]>);
     operationsRecords?: VoiceOperationsRecord[];
     onTiming?: (timing: VoiceObservabilityExportTiming) => void;
     redact?: VoiceTraceRedactionConfig;

package/package.json

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