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

package/dist/incidentBundle.d.ts

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

package/dist/index.d.ts

@@ -49,6 +49,7 @@ export { createVoiceReadinessProfile, recommendVoiceReadinessProfile } from './r
 export { buildVoiceProviderContractMatrix, createVoiceProviderContractMatrixHTMLHandler, createVoiceProviderContractMatrixJSONHandler, createVoiceProviderContractMatrixPreset, createVoiceProviderContractMatrixRoutes, evaluateVoiceProviderStackGaps, renderVoiceProviderContractMatrixHTML, recommendVoiceProviderStack } from './providerStackRecommendations';
 export { buildVoiceOpsConsoleReport, createVoiceOpsConsoleRoutes, renderVoiceOpsConsoleHTML } from './opsConsoleRoutes';
 export { buildVoiceOperationsRecord, createVoiceOperationsRecordRoutes, renderVoiceOperationsRecordHTML } from './operationsRecord';
+export { buildVoiceIncidentBundle, createVoiceIncidentBundleRoutes } from './incidentBundle';
 export { summarizeVoiceOpsStatus } from './opsStatus';
 export { createVoiceOpsStatusRoutes, renderVoiceOpsStatusHTML } from './opsStatusRoutes';
 export { createVoiceQualityRoutes, evaluateVoiceQuality, renderVoiceQualityHTML } from './qualityRoutes';
@@ -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 { VoiceIncidentBundle, VoiceIncidentBundleFormat, VoiceIncidentBundleOptions, VoiceIncidentBundleRoutesOptions, VoiceIncidentBundleSummary } from './incidentBundle';
 export type { VoiceQualityLink, VoiceQualityMetric, VoiceQualityReport, VoiceQualityRoutesOptions, VoiceQualityStatus, VoiceQualityThresholds } from './qualityRoutes';
 export type { VoiceResilienceIOSimulator, VoiceResilienceLink, VoiceResiliencePageData, VoiceResilienceRoutesOptions, VoiceResilienceSimulationProvider, VoiceRoutingKindSummary, VoiceRoutingDecisionSummary, VoiceRoutingDecisionSummaryOptions, VoiceRoutingEvent, VoiceRoutingEventKind, VoiceRoutingSessionSummary, VoiceRoutingSessionSummaryOptions } from './resilienceRoutes';
 export type { VoiceIOProviderRouterEvent, VoiceIOProviderRouterOptions, VoiceIOProviderRouterPolicy, VoiceIOProviderRouterPolicyConfig, VoiceSTTProviderRouterOptions, VoiceTTSProviderRouterOptions } from './providerAdapters';

package/dist/index.js

@@ -22644,6 +22644,159 @@ var createVoiceOperationsRecordRoutes = (options) => {
   }
   return routes;
 };
+// src/incidentBundle.ts
+import { Elysia as Elysia38 } from "elysia";
+var buildSummary = (record) => ({
+  auditEvents: record.audit?.total ?? 0,
+  durationMs: record.summary.callDurationMs,
+  errors: record.summary.errorCount,
+  handoffs: record.handoffs.length,
+  providers: record.providers.map((provider) => provider.provider),
+  sessionId: record.sessionId,
+  status: record.status,
+  tools: record.tools.length,
+  traceEvents: record.traceEvents.length,
+  turns: record.summary.turnCount
+});
+var renderIncidentMarkdown = (input) => {
+  const lines = [
+    `# ${input.title ?? `Voice Incident ${input.summary.sessionId}`}`,
+    "",
+    `Session: ${input.summary.sessionId}`,
+    `Status: ${input.summary.status}`,
+    `Trace events: ${input.summary.traceEvents}`,
+    `Audit events: ${input.summary.auditEvents}`,
+    `Turns: ${input.summary.turns}`,
+    `Errors: ${input.summary.errors}`,
+    `Handoffs: ${input.summary.handoffs}`,
+    `Tools: ${input.summary.tools}`,
+    `Providers: ${input.summary.providers.join(", ") || "none"}`,
+    input.summary.durationMs === undefined ? undefined : `Duration: ${input.summary.durationMs}ms`,
+    "",
+    "## Outcome",
+    "",
+    `- Assistant replies: ${input.record.outcome.assistantReplies}`,
+    `- Complete: ${input.record.outcome.complete ? "yes" : "no"}`,
+    `- Escalated: ${input.record.outcome.escalated ? "yes" : "no"}`,
+    `- Transferred: ${input.record.outcome.transferred ? "yes" : "no"}`,
+    `- Voicemail: ${input.record.outcome.voicemail ? "yes" : "no"}`,
+    `- No answer: ${input.record.outcome.noAnswer ? "yes" : "no"}`,
+    "",
+    "## Handoffs",
+    "",
+    ...input.record.handoffs.length ? input.record.handoffs.map((handoff) => `- ${handoff.fromAgentId ?? "unknown"} -> ${handoff.targetAgentId ?? "unknown"} ${handoff.status ?? ""} ${handoff.summary ?? handoff.reason ?? ""}`.trim()) : ["- none"],
+    "",
+    "## Tools",
+    "",
+    ...input.record.tools.length ? input.record.tools.map((tool) => `- ${tool.toolName ?? "tool"} ${tool.status ?? ""} ${tool.elapsedMs === undefined ? "" : `${tool.elapsedMs}ms`} ${tool.error ?? ""}`.trim()) : ["- none"],
+    "",
+    "## Trace Evidence",
+    "",
+    input.traceMarkdown,
+    ""
+  ].filter((line) => line !== undefined);
+  if (input.auditMarkdown) {
+    lines.push("## Audit Evidence", "", input.auditMarkdown);
+  }
+  return lines.join(`
+`);
+};
+var redactRecordValue = (value, redactedEvents, redact) => {
+  if (!redact) {
+    return value;
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => redactRecordValue(item, redactedEvents, redact));
+  }
+  if (typeof value === "string") {
+    return redactVoiceTraceText(value, redact);
+  }
+  if (typeof value === "object" && value) {
+    return Object.fromEntries(Object.entries(value).map(([key, entryValue]) => [
+      key,
+      key === "events" || key === "traceEvents" ? redactedEvents : redactRecordValue(entryValue, redactedEvents, redact)
+    ]));
+  }
+  return value;
+};
+var redactOperationsRecord = (record, input) => ({
+  ...redactRecordValue(record, input.traceEvents, input.redact),
+  audit: record.audit ? {
+    ...record.audit,
+    events: input.auditEvents ?? []
+  } : undefined,
+  traceEvents: input.traceEvents
+});
+var buildVoiceIncidentBundle = async (options) => {
+  const record = await buildVoiceOperationsRecord(options);
+  const redactedTraceEvents = options.redact ? redactVoiceTraceEvents(record.traceEvents, options.redact) : record.traceEvents;
+  const redactedAuditEvents = options.redact && record.audit ? redactVoiceAuditEvents(record.audit.events, options.redact) : record.audit?.events;
+  const redactedRecord = redactOperationsRecord(record, {
+    auditEvents: redactedAuditEvents,
+    redact: options.redact,
+    traceEvents: redactedTraceEvents
+  });
+  const summary = buildSummary(redactedRecord);
+  const traceMarkdown = renderVoiceTraceMarkdown(record.traceEvents, {
+    evaluation: options.evaluation,
+    redact: options.redact,
+    title: `Voice Incident Trace ${options.sessionId}`
+  });
+  const auditMarkdown = record.audit ? renderVoiceAuditMarkdown(record.audit.events, {
+    redact: options.redact,
+    title: `Voice Incident Audit ${options.sessionId}`
+  }) : undefined;
+  const markdown = renderIncidentMarkdown({
+    auditMarkdown,
+    record: redactedRecord,
+    summary,
+    title: options.title,
+    traceMarkdown
+  });
+  return {
+    auditMarkdown,
+    exportedAt: Date.now(),
+    formatVersion: 1,
+    markdown,
+    record: redactedRecord,
+    redacted: Boolean(options.redact),
+    sessionId: options.sessionId,
+    summary,
+    traceMarkdown
+  };
+};
+var createVoiceIncidentBundleRoutes = (options) => {
+  const path = options.path ?? "/api/voice-incidents/:sessionId";
+  const markdownPath = options.markdownPath === undefined ? "/voice-incidents/:sessionId/markdown" : options.markdownPath;
+  const routes = new Elysia38({
+    name: options.name ?? "absolutejs-voice-incident-bundle"
+  });
+  const getSessionId = (params) => params.sessionId ?? "";
+  const buildBundle = (sessionId) => buildVoiceIncidentBundle({
+    audit: options.audit,
+    evaluation: options.evaluation,
+    events: options.events,
+    redact: options.redact,
+    sessionId,
+    store: options.store,
+    title: options.title
+  });
+  routes.get(path, async ({ params }) => Response.json(await buildBundle(getSessionId(params)), {
+    headers: options.headers
+  }));
+  if (markdownPath) {
+    routes.get(markdownPath, async ({ params }) => {
+      const bundle = await buildBundle(getSessionId(params));
+      return new Response(bundle.markdown, {
+        headers: {
+          "Content-Type": "text/markdown; charset=utf-8",
+          ...options.headers
+        }
+      });
+    });
+  }
+  return routes;
+};
 // src/opsStatus.ts
 var DEFAULT_LINKS2 = [
   {
@@ -22816,7 +22969,7 @@ var summarizeVoiceOpsStatus = async (options) => {
   };
 };
 // src/opsStatusRoutes.ts
-import { Elysia as Elysia38 } from "elysia";
+import { Elysia as Elysia39 } from "elysia";
 var escapeHtml40 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var renderVoiceOpsStatusHTML = (report, options = {}) => {
   const title = options.title ?? "AbsoluteJS Voice Ops Status";
@@ -22828,7 +22981,7 @@ var renderVoiceOpsStatusHTML = (report, options = {}) => {
 };
 var createVoiceOpsStatusRoutes = (options) => {
   const path = options.path ?? "/api/voice/ops-status";
-  const routes = new Elysia38({
+  const routes = new Elysia39({
     name: options.name ?? "absolutejs-voice-ops-status"
   });
   routes.get(path, async () => summarizeVoiceOpsStatus(options));
@@ -23261,7 +23414,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 +23523,7 @@ var createVoiceTraceDeliveryRoutes = (options) => {
   const path = options.path ?? "/api/voice-trace-deliveries";
   const htmlPath = options.htmlPath === undefined ? "/traces/deliveries" : options.htmlPath;
   const workerPath = options.workerPath === undefined ? `${path}/drain` : options.workerPath;
-  const routes = new Elysia39({
+  const routes = new Elysia40({
     name: options.name ?? "absolutejs-voice-trace-deliveries"
   }).get(path, createVoiceTraceDeliveryJSONHandler(options));
   if (htmlPath !== false) {
@@ -23994,7 +24147,7 @@ var createVoiceMemoryStore = () => {
   return { get, getOrCreate, list, remove, set };
 };
 // src/opsWebhook.ts
-import { Elysia as Elysia40 } from "elysia";
+import { Elysia as Elysia41 } from "elysia";
 var toHex6 = (bytes) => Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
 var signVoiceOpsWebhookBody = async (input) => {
   const encoder = new TextEncoder;
@@ -24124,7 +24277,7 @@ var verifyVoiceOpsWebhookSignature = async (input) => {
 };
 var createVoiceOpsWebhookReceiverRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice-ops/webhook";
-  return new Elysia40().post(path, async ({ body, request, set }) => {
+  return new Elysia41().post(path, async ({ body, request, set }) => {
     const bodyText = typeof body === "string" ? body : JSON.stringify(body);
     if (options.signingSecret) {
       const verification = await verifyVoiceOpsWebhookSignature({
@@ -25272,6 +25425,7 @@ export {
   createVoiceIntegrationSinkWorker,
   createVoiceIntegrationHTTPSink,
   createVoiceIntegrationEvent,
+  createVoiceIncidentBundleRoutes,
   createVoiceHubSpotTaskUpdateSink,
   createVoiceHubSpotTaskSyncSinks,
   createVoiceHubSpotTaskSink,
@@ -25381,6 +25535,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.185",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",