@absolutejs/voice 0.0.22-beta.184 → 0.0.22-beta.186

package/dist/dataControl.d.ts

@@ -2,13 +2,15 @@ import type { VoiceCampaignStore } from './campaign';
 import { type VoiceAuditActor, type VoiceAuditEventStore } from './audit';
 import type { VoiceAuditSinkDeliveryStore } from './auditSinks';
 import type { VoiceIntegrationEventStore, VoiceOpsTaskStore } from './ops';
+import type { VoiceIncidentBundleStore } from './incidentBundle';
 import type { VoiceCallReviewStore } from './testing/review';
 import type { VoiceTraceEventStore, VoiceTracePruneFilter, VoiceTraceSinkDeliveryStore } from './trace';
 import type { VoiceSessionStore } from './types';
-export type VoiceDataRetentionScope = 'auditDeliveries' | 'campaigns' | 'events' | 'reviews' | 'sessions' | 'tasks' | 'traceDeliveries' | 'traces';
+export type VoiceDataRetentionScope = 'auditDeliveries' | 'campaigns' | 'events' | 'incidentBundles' | 'reviews' | 'sessions' | 'tasks' | 'traceDeliveries' | 'traces';
 export type VoiceDataRetentionStores = {
     campaigns?: VoiceCampaignStore;
     events?: VoiceIntegrationEventStore;
+    incidentBundles?: VoiceIncidentBundleStore;
     reviews?: VoiceCallReviewStore;
     session?: VoiceSessionStore;
     sessions?: VoiceSessionStore;

package/dist/fileStore.d.ts

@@ -2,6 +2,7 @@ import { type StoredVoiceAuditEvent, type VoiceAuditEventStore } from './audit';
 import type { VoiceAuditSinkDeliveryRecord, VoiceAuditSinkDeliveryStore } from './auditSinks';
 import type { VoiceCampaignStore } from './campaign';
 import { type VoiceAssistantMemoryRecord, type VoiceAssistantMemoryStore } from './assistantMemory';
+import type { StoredVoiceIncidentBundleArtifact, VoiceIncidentBundleStore } from './incidentBundle';
 import { type StoredVoiceTraceEvent, type VoiceTraceSinkDeliveryRecord, type VoiceTraceSinkDeliveryStore, type VoiceTraceEventStore } from './trace';
 import type { StoredVoiceIntegrationEvent, StoredVoiceExternalObjectMap, StoredVoiceOpsTask, VoiceExternalObjectMap, VoiceExternalObjectMapStore, VoiceIntegrationEvent, VoiceIntegrationEventStore, VoiceOpsTask, VoiceOpsTaskStore } from './ops';
 import type { StoredVoiceCallReviewArtifact, VoiceCallReviewArtifact, VoiceCallReviewStore } from './testing/review';
@@ -10,12 +11,13 @@ export type VoiceFileStoreOptions = {
     directory: string;
     pretty?: boolean;
 };
-export type VoiceFileRuntimeStorage<TSession extends VoiceSessionRecord = VoiceSessionRecord, TReview extends StoredVoiceCallReviewArtifact = StoredVoiceCallReviewArtifact, TTask extends StoredVoiceOpsTask = StoredVoiceOpsTask, TEvent extends StoredVoiceIntegrationEvent = StoredVoiceIntegrationEvent, TMapping extends StoredVoiceExternalObjectMap = StoredVoiceExternalObjectMap, TTrace extends StoredVoiceTraceEvent = StoredVoiceTraceEvent, TTraceDelivery extends VoiceTraceSinkDeliveryRecord = VoiceTraceSinkDeliveryRecord, TAudit extends StoredVoiceAuditEvent = StoredVoiceAuditEvent, TAuditDelivery extends VoiceAuditSinkDeliveryRecord = VoiceAuditSinkDeliveryRecord, TMemory extends VoiceAssistantMemoryRecord = VoiceAssistantMemoryRecord> = {
+export type VoiceFileRuntimeStorage<TSession extends VoiceSessionRecord = VoiceSessionRecord, TReview extends StoredVoiceCallReviewArtifact = StoredVoiceCallReviewArtifact, TTask extends StoredVoiceOpsTask = StoredVoiceOpsTask, TEvent extends StoredVoiceIntegrationEvent = StoredVoiceIntegrationEvent, TMapping extends StoredVoiceExternalObjectMap = StoredVoiceExternalObjectMap, TTrace extends StoredVoiceTraceEvent = StoredVoiceTraceEvent, TTraceDelivery extends VoiceTraceSinkDeliveryRecord = VoiceTraceSinkDeliveryRecord, TAudit extends StoredVoiceAuditEvent = StoredVoiceAuditEvent, TAuditDelivery extends VoiceAuditSinkDeliveryRecord = VoiceAuditSinkDeliveryRecord, TIncident extends StoredVoiceIncidentBundleArtifact = StoredVoiceIncidentBundleArtifact, TMemory extends VoiceAssistantMemoryRecord = VoiceAssistantMemoryRecord> = {
     audit: VoiceAuditEventStore<TAudit>;
     auditDeliveries: VoiceAuditSinkDeliveryStore<TAuditDelivery>;
     campaigns: VoiceCampaignStore;
     events: VoiceIntegrationEventStore<TEvent>;
     externalObjects: VoiceExternalObjectMapStore<TMapping>;
+    incidentBundles: VoiceIncidentBundleStore<TIncident>;
     memories: VoiceAssistantMemoryStore<TMemory>;
     reviews: VoiceCallReviewStore<TReview>;
     session: VoiceSessionStore<TSession>;
@@ -34,7 +36,8 @@ export declare const createVoiceFileTraceSinkDeliveryStore: <TDelivery extends V
 export declare const createVoiceFileAuditEventStore: <TEvent extends StoredVoiceAuditEvent = StoredVoiceAuditEvent>(options: VoiceFileStoreOptions) => VoiceAuditEventStore<TEvent>;
 export declare const createVoiceFileAuditSinkDeliveryStore: <TDelivery extends VoiceAuditSinkDeliveryRecord = VoiceAuditSinkDeliveryRecord>(options: VoiceFileStoreOptions) => VoiceAuditSinkDeliveryStore<TDelivery>;
 export declare const createVoiceFileAssistantMemoryStore: <TRecord extends VoiceAssistantMemoryRecord = VoiceAssistantMemoryRecord>(options: VoiceFileStoreOptions) => VoiceAssistantMemoryStore<TRecord>;
-export declare const createVoiceFileRuntimeStorage: <TSession extends VoiceSessionRecord = VoiceSessionRecord, TReview extends StoredVoiceCallReviewArtifact = StoredVoiceCallReviewArtifact, TTask extends StoredVoiceOpsTask = StoredVoiceOpsTask, TEvent extends StoredVoiceIntegrationEvent = StoredVoiceIntegrationEvent, TMapping extends StoredVoiceExternalObjectMap = StoredVoiceExternalObjectMap, TTrace extends StoredVoiceTraceEvent = StoredVoiceTraceEvent, TTraceDelivery extends VoiceTraceSinkDeliveryRecord = VoiceTraceSinkDeliveryRecord, TAudit extends StoredVoiceAuditEvent = StoredVoiceAuditEvent, TAuditDelivery extends VoiceAuditSinkDeliveryRecord = VoiceAuditSinkDeliveryRecord, TMemory extends VoiceAssistantMemoryRecord = VoiceAssistantMemoryRecord>(options: VoiceFileStoreOptions) => VoiceFileRuntimeStorage<TSession, TReview, TTask, TEvent, TMapping, TTrace, TTraceDelivery, TAudit, TAuditDelivery, TMemory>;
+export declare const createVoiceFileIncidentBundleStore: <TArtifact extends StoredVoiceIncidentBundleArtifact = StoredVoiceIncidentBundleArtifact>(options: VoiceFileStoreOptions) => VoiceIncidentBundleStore<TArtifact>;
+export declare const createVoiceFileRuntimeStorage: <TSession extends VoiceSessionRecord = VoiceSessionRecord, TReview extends StoredVoiceCallReviewArtifact = StoredVoiceCallReviewArtifact, TTask extends StoredVoiceOpsTask = StoredVoiceOpsTask, TEvent extends StoredVoiceIntegrationEvent = StoredVoiceIntegrationEvent, TMapping extends StoredVoiceExternalObjectMap = StoredVoiceExternalObjectMap, TTrace extends StoredVoiceTraceEvent = StoredVoiceTraceEvent, TTraceDelivery extends VoiceTraceSinkDeliveryRecord = VoiceTraceSinkDeliveryRecord, TAudit extends StoredVoiceAuditEvent = StoredVoiceAuditEvent, TAuditDelivery extends VoiceAuditSinkDeliveryRecord = VoiceAuditSinkDeliveryRecord, TIncident extends StoredVoiceIncidentBundleArtifact = StoredVoiceIncidentBundleArtifact, TMemory extends VoiceAssistantMemoryRecord = VoiceAssistantMemoryRecord>(options: VoiceFileStoreOptions) => VoiceFileRuntimeStorage<TSession, TReview, TTask, TEvent, TMapping, TTrace, TTraceDelivery, TAudit, TAuditDelivery, TIncident, TMemory>;
 export declare const createStoredVoiceCallReviewArtifact: <TArtifact extends VoiceCallReviewArtifact = VoiceCallReviewArtifact>(id: string, artifact: TArtifact) => TArtifact & {
     id: string;
 };

package/dist/incidentBundle.d.ts

@@ -0,0 +1,116 @@
+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 StoredVoiceIncidentBundleArtifact = {
+    bundle: VoiceIncidentBundle;
+    createdAt: number;
+    expiresAt?: number;
+    id: string;
+    metadata?: Record<string, unknown>;
+    redacted: boolean;
+    sessionId: string;
+};
+export type VoiceIncidentBundleStoreFilter = {
+    expiredAt?: number;
+    sessionId?: string;
+};
+export type VoiceIncidentBundleStore<TArtifact extends StoredVoiceIncidentBundleArtifact = StoredVoiceIncidentBundleArtifact> = {
+    get: (id: string) => Promise<TArtifact | undefined> | TArtifact | undefined;
+    list: (filter?: VoiceIncidentBundleStoreFilter) => Promise<TArtifact[]> | TArtifact[];
+    remove: (id: string) => Promise<void> | void;
+    set: (id: string, artifact: TArtifact) => Promise<void> | void;
+};
+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 type VoiceIncidentBundleArtifactOptions = {
+    createdAt?: number;
+    expiresAt?: number;
+    id?: string;
+    metadata?: Record<string, unknown>;
+    ttlMs?: number;
+};
+export type VoiceIncidentBundleRetentionOptions = {
+    before?: number;
+    beforeOrAt?: number;
+    dryRun?: boolean;
+    expiredAt?: number;
+    keepNewest?: number;
+    limit?: number;
+    store: VoiceIncidentBundleStore;
+};
+export type VoiceIncidentBundleRetentionReport = {
+    deleted: StoredVoiceIncidentBundleArtifact[];
+    deletedCount: number;
+    deletedIds: string[];
+    dryRun: boolean;
+    scannedCount: number;
+};
+export declare const createVoiceMemoryIncidentBundleStore: <TArtifact extends StoredVoiceIncidentBundleArtifact = StoredVoiceIncidentBundleArtifact>() => VoiceIncidentBundleStore<TArtifact>;
+export declare const createStoredVoiceIncidentBundleArtifact: (bundle: VoiceIncidentBundle, options?: VoiceIncidentBundleArtifactOptions) => StoredVoiceIncidentBundleArtifact;
+export declare const saveVoiceIncidentBundleArtifact: (input: {
+    bundle: VoiceIncidentBundle;
+    options?: VoiceIncidentBundleArtifactOptions;
+    store: VoiceIncidentBundleStore;
+}) => Promise<StoredVoiceIncidentBundleArtifact>;
+export declare const pruneVoiceIncidentBundleArtifacts: (options: VoiceIncidentBundleRetentionOptions) => Promise<VoiceIncidentBundleRetentionReport>;
+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

@@ -35,7 +35,7 @@ export { createVoiceTurnQualityHTMLHandler, createVoiceTurnQualityJSONHandler, c
 export { createVoiceOutcomeContractHTMLHandler, createVoiceOutcomeContractJSONHandler, createVoiceOutcomeContractRoutes, renderVoiceOutcomeContractHTML, runVoiceOutcomeContractSuite } from './outcomeContract';
 export { applyVoiceTelephonyOutcome, createMemoryVoiceTelephonyWebhookIdempotencyStore, createVoiceTelephonyOutcomePolicy, createVoiceTelephonyWebhookHandler, createVoiceTelephonyWebhookRoutes, parseVoiceTelephonyWebhookEvent, resolveVoiceTelephonyOutcome, signVoiceTwilioWebhook, verifyVoiceTwilioWebhookSignature, voiceTelephonyOutcomeToRouteResult } from './telephonyOutcome';
 export { createVoicePhoneAgent } from './phoneAgent';
-export { createStoredVoiceCallReviewArtifact, createStoredVoiceExternalObjectMap, createStoredVoiceIntegrationEvent, createStoredVoiceOpsTask, createVoiceFileExternalObjectMapStore, createVoiceFileAssistantMemoryStore, createVoiceFileAuditEventStore, createVoiceFileAuditSinkDeliveryStore, createVoiceFileCampaignStore, createVoiceFileIntegrationEventStore, createVoiceFileReviewStore, createVoiceFileRuntimeStorage, createVoiceFileSessionStore, createVoiceFileTaskStore, createVoiceFileTraceSinkDeliveryStore, createVoiceFileTraceEventStore } from './fileStore';
+export { createStoredVoiceCallReviewArtifact, createStoredVoiceExternalObjectMap, createStoredVoiceIntegrationEvent, createStoredVoiceOpsTask, createVoiceFileIncidentBundleStore, createVoiceFileExternalObjectMapStore, createVoiceFileAssistantMemoryStore, createVoiceFileAuditEventStore, createVoiceFileAuditSinkDeliveryStore, createVoiceFileCampaignStore, createVoiceFileIntegrationEventStore, createVoiceFileReviewStore, createVoiceFileRuntimeStorage, createVoiceFileSessionStore, createVoiceFileTaskStore, createVoiceFileTraceSinkDeliveryStore, createVoiceFileTraceEventStore } from './fileStore';
 export { createVoiceAssistantMemoryHandle, createVoiceAssistantMemoryRecord, createVoiceMemoryAssistantMemoryStore, resolveVoiceAssistantMemoryNamespace } from './assistantMemory';
 export { createAnthropicVoiceAssistantModel, createGeminiVoiceAssistantModel, createJSONVoiceAssistantModel, createOpenAIVoiceAssistantModel, resolveVoiceProviderRoutingPolicyPreset, createVoiceProviderRouter } from './modelAdapters';
 export { createOpenAIRealtimeAdapter } from './openaiRealtime';
@@ -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, createStoredVoiceIncidentBundleArtifact, createVoiceIncidentBundleRoutes, createVoiceMemoryIncidentBundleStore, pruneVoiceIncidentBundleArtifacts, saveVoiceIncidentBundleArtifact } from './incidentBundle';
 export { summarizeVoiceOpsStatus } from './opsStatus';
 export { createVoiceOpsStatusRoutes, renderVoiceOpsStatusHTML } from './opsStatusRoutes';
 export { createVoiceQualityRoutes, evaluateVoiceQuality, renderVoiceQualityHTML } from './qualityRoutes';
@@ -109,6 +110,7 @@ export type { VoiceProductionReadinessAction, VoiceProductionReadinessAuditOptio
 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 { StoredVoiceIncidentBundleArtifact, VoiceIncidentBundle, VoiceIncidentBundleArtifactOptions, VoiceIncidentBundleFormat, VoiceIncidentBundleOptions, VoiceIncidentBundleRetentionOptions, VoiceIncidentBundleRetentionReport, VoiceIncidentBundleRoutesOptions, VoiceIncidentBundleStore, VoiceIncidentBundleStoreFilter, 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

@@ -12063,6 +12063,7 @@ var allRetentionScopes = [
   "auditDeliveries",
   "campaigns",
   "events",
+  "incidentBundles",
   "reviews",
   "sessions",
   "tasks",
@@ -12123,6 +12124,10 @@ var getEventRetentionRecord = (record) => ({
   at: record.createdAt,
   id: record.id
 });
+var getIncidentBundleRetentionRecord = (record) => ({
+  at: record.expiresAt ?? record.createdAt,
+  id: record.id
+});
 var getReviewRetentionRecord = (record) => ({
   at: record.generatedAt ?? 0,
   id: record.id
@@ -12215,6 +12220,13 @@ var applyVoiceDataRetentionPolicy = async (options) => {
         toRecord: getEventRetentionRecord
       }) : reportSkippedScope(scope, dryRun, "missing-store");
     }
+    if (scope === "incidentBundles") {
+      return options.incidentBundles ? runRetentionScope({
+        ...common,
+        store: options.incidentBundles,
+        toRecord: getIncidentBundleRetentionRecord
+      }) : reportSkippedScope(scope, dryRun, "missing-store");
+    }
     if (scope === "reviews") {
       return options.reviews ? runRetentionScope({
         ...common,
@@ -18265,6 +18277,44 @@ var createVoiceFileAssistantMemoryStore = (options) => {
   };
   return { delete: remove, get, list, set };
 };
+var createVoiceFileIncidentBundleStore = (options) => {
+  const get = async (id) => {
+    const path = resolveFilePath(options.directory, id);
+    try {
+      return await readJsonFile(path);
+    } catch (error) {
+      if (error.code === "ENOENT") {
+        return;
+      }
+      throw error;
+    }
+  };
+  const list = async (filter = {}) => {
+    const files = await listJsonFiles(options.directory);
+    const artifacts = await Promise.all(files.map((file) => readJsonFile(file)));
+    return artifacts.filter((artifact) => {
+      if (filter.sessionId && artifact.sessionId !== filter.sessionId) {
+        return false;
+      }
+      if (typeof filter.expiredAt === "number" && (artifact.expiresAt === undefined || artifact.expiresAt > filter.expiredAt)) {
+        return false;
+      }
+      return true;
+    }).sort((left, right) => right.createdAt - left.createdAt || left.id.localeCompare(right.id));
+  };
+  const set = async (id, artifact) => {
+    await writeJsonFile(resolveFilePath(options.directory, id), {
+      ...artifact,
+      id
+    }, options);
+  };
+  const remove = async (id) => {
+    await rm(resolveFilePath(options.directory, id), {
+      force: true
+    });
+  };
+  return { get, list, remove, set };
+};
 var createVoiceFileRuntimeStorage = (options) => ({
   audit: createVoiceFileAuditEventStore({
     ...options,
@@ -18286,6 +18336,10 @@ var createVoiceFileRuntimeStorage = (options) => ({
     ...options,
     directory: join2(options.directory, "external-objects")
   }),
+  incidentBundles: createVoiceFileIncidentBundleStore({
+    ...options,
+    directory: join2(options.directory, "incident-bundles")
+  }),
   memories: createVoiceFileAssistantMemoryStore({
     ...options,
     directory: join2(options.directory, "memories")
@@ -22644,6 +22698,235 @@ var createVoiceOperationsRecordRoutes = (options) => {
   }
   return routes;
 };
+// src/incidentBundle.ts
+import { Elysia as Elysia38 } from "elysia";
+var filterIncidentBundleArtifacts = (artifacts, filter = {}) => artifacts.filter((artifact) => {
+  if (filter.sessionId && artifact.sessionId !== filter.sessionId) {
+    return false;
+  }
+  if (typeof filter.expiredAt === "number" && (artifact.expiresAt === undefined || artifact.expiresAt > filter.expiredAt)) {
+    return false;
+  }
+  return true;
+}).sort((left, right) => right.createdAt - left.createdAt || left.id.localeCompare(right.id));
+var createVoiceMemoryIncidentBundleStore = () => {
+  const artifacts = new Map;
+  return {
+    get: (id) => artifacts.get(id),
+    list: (filter) => filterIncidentBundleArtifacts([...artifacts.values()], filter),
+    remove: (id) => {
+      artifacts.delete(id);
+    },
+    set: (id, artifact) => {
+      artifacts.set(id, {
+        ...artifact,
+        id
+      });
+    }
+  };
+};
+var createStoredVoiceIncidentBundleArtifact = (bundle, options = {}) => {
+  const createdAt = options.createdAt ?? Date.now();
+  return {
+    bundle,
+    createdAt,
+    expiresAt: options.expiresAt ?? (typeof options.ttlMs === "number" ? createdAt + options.ttlMs : undefined),
+    id: options.id ?? `voice-incident:${bundle.sessionId}:${bundle.exportedAt}:${crypto.randomUUID()}`,
+    metadata: options.metadata,
+    redacted: bundle.redacted,
+    sessionId: bundle.sessionId
+  };
+};
+var saveVoiceIncidentBundleArtifact = async (input) => {
+  const artifact = createStoredVoiceIncidentBundleArtifact(input.bundle, input.options);
+  await input.store.set(artifact.id, artifact);
+  return artifact;
+};
+var retentionTimeMatch = (artifact, options) => {
+  if (typeof options.expiredAt === "number" && (artifact.expiresAt === undefined || artifact.expiresAt > options.expiredAt)) {
+    return false;
+  }
+  if (typeof options.before === "number" && artifact.createdAt >= options.before) {
+    return false;
+  }
+  if (typeof options.beforeOrAt === "number" && artifact.createdAt > options.beforeOrAt) {
+    return false;
+  }
+  return true;
+};
+var pruneVoiceIncidentBundleArtifacts = async (options) => {
+  const dryRun = Boolean(options.dryRun);
+  const artifacts = await options.store.list();
+  let selected = artifacts.filter((artifact) => retentionTimeMatch(artifact, options)).sort((left, right) => left.createdAt - right.createdAt || left.id.localeCompare(right.id));
+  if (typeof options.keepNewest === "number" && options.keepNewest >= 0) {
+    const newest = new Set([...selected].sort((left, right) => right.createdAt - left.createdAt || right.id.localeCompare(left.id)).slice(0, options.keepNewest).map((artifact) => artifact.id));
+    selected = selected.filter((artifact) => !newest.has(artifact.id));
+  }
+  if (typeof options.limit === "number" && options.limit >= 0) {
+    selected = selected.slice(0, options.limit);
+  }
+  if (!dryRun) {
+    await Promise.all(selected.map((artifact) => options.store.remove(artifact.id)));
+  }
+  return {
+    deleted: selected,
+    deletedCount: selected.length,
+    deletedIds: selected.map((artifact) => artifact.id),
+    dryRun,
+    scannedCount: artifacts.length
+  };
+};
+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 = [
   {
@@ -22816,7 +23099,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";
@@ -22828,7 +23111,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));
@@ -23261,7 +23544,7 @@ 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 getString15 = (value) => typeof value === "string" && value.trim() ? value.trim() : undefined;
 var getNumber10 = (value) => {
@@ -23370,7 +23653,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) {
@@ -23994,7 +24277,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;
@@ -24124,7 +24407,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({
@@ -25009,6 +25292,7 @@ export {
   signVoicePlivoWebhook,
   shapeTelephonyAssistantText,
   selectVoiceTraceEventsForPrune,
+  saveVoiceIncidentBundleArtifact,
   runVoiceToolContractSuite,
   runVoiceToolContract,
   runVoiceSimulationSuite,
@@ -25101,6 +25385,7 @@ export {
   recommendVoiceReadinessProfile,
   recommendVoiceProviderStack,
   pruneVoiceTraceEvents,
+  pruneVoiceIncidentBundleArtifacts,
   parseVoiceTelephonyWebhookEvent,
   matchesVoiceOpsTaskAssignmentRule,
   markVoiceOpsTaskSLABreached,
@@ -25259,6 +25544,7 @@ export {
   createVoiceMemoryTraceSinkDeliveryStore,
   createVoiceMemoryTraceEventStore,
   createVoiceMemoryStore,
+  createVoiceMemoryIncidentBundleStore,
   createVoiceMemoryHandoffDeliveryStore,
   createVoiceMemoryCampaignStore,
   createVoiceMemoryAuditSinkDeliveryStore,
@@ -25272,6 +25558,7 @@ export {
   createVoiceIntegrationSinkWorker,
   createVoiceIntegrationHTTPSink,
   createVoiceIntegrationEvent,
+  createVoiceIncidentBundleRoutes,
   createVoiceHubSpotTaskUpdateSink,
   createVoiceHubSpotTaskSyncSinks,
   createVoiceHubSpotTaskSink,
@@ -25290,6 +25577,7 @@ export {
   createVoiceFileRuntimeStorage,
   createVoiceFileReviewStore,
   createVoiceFileIntegrationEventStore,
+  createVoiceFileIncidentBundleStore,
   createVoiceFileExternalObjectMapStore,
   createVoiceFileEvalBaselineStore,
   createVoiceFileDeliverySink,
@@ -25350,6 +25638,7 @@ export {
   createTelnyxMediaStreamBridge,
   createStoredVoiceOpsTask,
   createStoredVoiceIntegrationEvent,
+  createStoredVoiceIncidentBundleArtifact,
   createStoredVoiceExternalObjectMap,
   createStoredVoiceCallReviewArtifact,
   createRiskyTurnCorrectionHandler,
@@ -25381,6 +25670,7 @@ export {
   buildVoiceOpsConsoleReport,
   buildVoiceOpsActionHistoryReport,
   buildVoiceOperationsRecord,
+  buildVoiceIncidentBundle,
   buildVoiceDiagnosticsMarkdown,
   buildVoiceDemoReadyReport,
   buildVoiceDeliverySinkReport,

package/package.json

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