@absolutejs/voice 0.0.22-beta.434 → 0.0.22-beta.436

package/dist/incidentTimeline.d.ts

@@ -2,6 +2,8 @@ import { Elysia } from 'elysia';
 import type { VoiceFailureReplayReport, VoiceOperationsRecord } from './operationsRecord';
 import type { VoiceOperationalStatusReport } from './operationalStatus';
 import type { VoiceOpsRecoveryReport } from './opsRecovery';
+import type { VoiceAuditEventStore } from './audit';
+import type { VoiceTraceEventStore } from './trace';
 import type { VoiceMonitorIssue } from './voiceMonitoring';
 export type VoiceIncidentTimelineStatus = 'fail' | 'pass' | 'warn';
 export type VoiceIncidentTimelineSeverity = 'critical' | 'info' | 'warn';
@@ -22,6 +24,8 @@ export type VoiceIncidentRecoveryAction = {
 };
 export type VoiceIncidentRecoveryActionResult = {
     actionId: string;
+    afterStatus?: VoiceIncidentTimelineStatus;
+    beforeStatus?: VoiceIncidentTimelineStatus;
     detail?: string;
     href?: string;
     ok: boolean;
@@ -34,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;
@@ -91,14 +120,22 @@ export type VoiceIncidentTimelineOptions = {
 export type VoiceIncidentTimelineRoutesOptions = VoiceIncidentTimelineOptions & {
     actionHandlers?: Record<string, VoiceIncidentRecoveryActionHandler>;
     actionPath?: false | string;
+    audit?: VoiceAuditEventStore;
     headers?: HeadersInit;
     htmlPath?: false | string;
     markdownPath?: false | string;
     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

@@ -30183,6 +30183,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 +30485,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 () => {
@@ -30519,12 +30577,64 @@ var createVoiceIncidentTimelineRoutes = (options) => {
         report,
         request
       });
-      return new Response(JSON.stringify(result), {
+      const status = result.ok ? 200 : 500;
+      const afterReport = await buildVoiceIncidentTimelineReport(options);
+      const resultWithStatus = {
+        ...result,
+        afterStatus: result.afterStatus ?? afterReport.status,
+        beforeStatus: result.beforeStatus ?? report.status
+      };
+      await recordVoiceOpsActionAudit({
+        actionId: `incident.${actionId}`,
+        body: {
+          action,
+          afterStatus: resultWithStatus.afterStatus,
+          beforeStatus: resultWithStatus.beforeStatus,
+          eventIds: report.events.map((event) => event.id),
+          result
+        },
+        error: result.ok ? undefined : result.detail ?? result.status,
+        ok: result.ok,
+        ranAt: Date.now(),
+        status
+      }, {
+        audit: options.audit,
+        trace: options.trace
+      });
+      return new Response(JSON.stringify(resultWithStatus), {
         headers: {
           "Content-Type": "application/json; charset=utf-8",
           ...options.headers
         },
-        status: result.ok ? 200 : 500
+        status
+      });
+    });
+  }
+  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
+        }
       });
     });
   }
@@ -36038,7 +36148,7 @@ var defaultRequirement = {
   requireFallback: false,
   requireTimeoutBudget: false
 };
-var statusRank6 = {
+var statusRank7 = {
   pass: 0,
   warn: 1,
   fail: 2
@@ -36054,7 +36164,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 ?? {},
@@ -37198,12 +37308,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;
@@ -41378,6 +41488,7 @@ export {
   renderVoiceLatencySLOMarkdown,
   renderVoiceIncidentTimelineMarkdown,
   renderVoiceIncidentTimelineHTML,
+  renderVoiceIncidentRecoveryOutcomeHTML,
   renderVoiceHandoffHealthHTML,
   renderVoiceGuardrailMarkdown,
   renderVoiceFailureReplayMarkdown,
@@ -41879,6 +41990,7 @@ export {
   buildVoiceLiveOpsControlState,
   buildVoiceLatencySLOGate,
   buildVoiceIncidentTimelineReport,
+  buildVoiceIncidentRecoveryOutcomeReport,
   buildVoiceIncidentBundle,
   buildVoiceIOProviderRouterTraceEvent,
   buildVoiceGuardrailReport,

package/package.json

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