@absolutejs/voice 0.0.22-beta.436 → 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/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) => [
@@ -37903,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}`}`,
     "",
@@ -37934,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",
@@ -37983,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,
@@ -37995,6 +38066,7 @@ var buildVoiceIncidentBundle = async (options) => {
   const markdown = renderIncidentMarkdown({
     auditMarkdown,
     record: redactedRecord,
+    recoveryOutcomes,
     summary,
     title: options.title,
     traceMarkdown
@@ -38005,6 +38077,7 @@ var buildVoiceIncidentBundle = async (options) => {
     formatVersion: 1,
     markdown,
     record: redactedRecord,
+    recoveryOutcomes,
     redacted: Boolean(options.redact),
     sessionId: options.sessionId,
     summary,

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.436",
+	"version": "0.0.22-beta.437",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",