@absolutejs/voice 0.0.22-beta.410 → 0.0.22-beta.411

package/dist/index.d.ts

@@ -206,6 +206,6 @@ export type { PlivoInboundMessage, PlivoMediaStreamBridge, PlivoMediaStreamBridg
 export type { VoiceTelephonyCarrierMatrix, VoiceTelephonyCarrierMatrixEntry, VoiceTelephonyCarrierMatrixInput, VoiceTelephonyCarrierMatrixOptions, VoiceTelephonyCarrierMatrixRoutesOptions, VoiceTelephonyCarrierMatrixStatus } from './telephony/matrix';
 export { shapeTelephonyAssistantText } from './telephony/response';
 export type { TelephonyResponseShapeMode, TelephonyResponseShapeOptions } from './telephony/response';
-export { buildVoiceProofPack, buildVoiceProofPackFromObservabilityExport, createVoiceProofPackArtifacts, createVoiceProofPackRoutes, renderVoiceProofPackMarkdown, writeVoiceProofPack } from './proofPack';
+export { buildVoiceProofPack, buildVoiceProofPackFromObservabilityExport, createVoiceProofPackArtifacts, createVoiceProofPackOperationsRecordSection, createVoiceProofPackProductionReadinessSection, createVoiceProofPackProviderSloSection, createVoiceProofPackRoutes, createVoiceProofPackSupportBundleSection, renderVoiceProofPackMarkdown, writeVoiceProofPack } from './proofPack';
 export type { VoiceProofPack, VoiceProofPackEvidence, VoiceProofPackInput, VoiceProofPackRoutesOptions, VoiceProofPackSection, VoiceProofPackStatus, VoiceProofPackWriteResult } from './proofPack';
 export * from './types';

package/dist/index.js

@@ -39882,6 +39882,176 @@ var summarizeProofPackSections = (sections) => {
   }
   return { fail, pass, sections: sections.length, warn };
 };
+var toProofPackStatus = (status) => {
+  if (status === "fail" || status === "failed") {
+    return "fail";
+  }
+  if (status === "warn" || status === "warning" || status === "degraded" || status === "stale") {
+    return "warn";
+  }
+  return "pass";
+};
+var numberEvidence = (label, value, options = {}) => {
+  const safeValue = value ?? 0;
+  const status = options.failWhenPositive ? safeValue > 0 ? "fail" : "pass" : options.passWhenPositive ? safeValue > 0 ? "pass" : "warn" : "pass";
+  return {
+    label,
+    status,
+    value: safeValue
+  };
+};
+var createVoiceProofPackProviderSloSection = (report, options = {}) => ({
+  evidence: [
+    {
+      href: options.href,
+      label: "Provider SLO status",
+      status: toProofPackStatus(report.status),
+      value: report.status
+    },
+    numberEvidence("Provider routing events", report.events, {
+      passWhenPositive: true
+    }),
+    numberEvidence("Latency samples", report.eventsWithLatency, {
+      passWhenPositive: true
+    }),
+    numberEvidence("Provider SLO issues", report.issues.length, {
+      failWhenPositive: true
+    })
+  ],
+  status: toProofPackStatus(report.status),
+  summary: "Provider latency, timeout, fallback, and unresolved error evidence.",
+  title: options.title ?? "Provider SLO"
+});
+var createVoiceProofPackProductionReadinessSection = (report, options = {}) => {
+  const checkFailures = report.checks.filter((check) => check.status === "fail").length;
+  const checkWarnings = report.checks.filter((check) => check.status === "warn").length;
+  return {
+    evidence: [
+      {
+        label: "Production readiness status",
+        status: toProofPackStatus(report.status),
+        value: report.status
+      },
+      numberEvidence("Readiness checks", report.checks.length, {
+        passWhenPositive: true
+      }),
+      numberEvidence("Failed readiness checks", checkFailures, {
+        failWhenPositive: true
+      }),
+      {
+        label: "Warning readiness checks",
+        status: checkWarnings > 0 ? "warn" : "pass",
+        value: checkWarnings
+      },
+      ...report.summary.providerSlo ? [
+        {
+          href: report.links.providerSlo,
+          label: "Provider SLO samples",
+          status: toProofPackStatus(report.summary.providerSlo.status),
+          value: report.summary.providerSlo.eventsWithLatency
+        }
+      ] : [],
+      ...report.summary.traceDeliveries ? [
+        {
+          href: report.links.traceDeliveries,
+          label: "Trace delivery status",
+          status: toProofPackStatus(report.summary.traceDeliveries.status),
+          value: report.summary.traceDeliveries.pending
+        }
+      ] : []
+    ],
+    status: toProofPackStatus(report.status),
+    summary: "Production readiness gates and linked proof surfaces.",
+    title: options.title ?? "Production readiness"
+  };
+};
+var createVoiceProofPackOperationsRecordSection = (records, options = {}) => {
+  const failed = records.filter((record) => record.status === "failed").length;
+  const warnings = records.filter((record) => record.status === "warning").length;
+  const errors = records.reduce((total, record) => total + record.summary.errorCount, 0);
+  const fallbacks = records.reduce((total, record) => total + record.providerDecisionSummary.fallbacks, 0);
+  return {
+    evidence: [
+      numberEvidence("Operations records", records.length, {
+        passWhenPositive: true
+      }),
+      numberEvidence("Failed operations records", failed, {
+        failWhenPositive: true
+      }),
+      {
+        label: "Warning operations records",
+        status: warnings > 0 ? "warn" : "pass",
+        value: warnings
+      },
+      numberEvidence("Trace errors", errors, { failWhenPositive: true }),
+      {
+        label: "Provider fallbacks",
+        status: fallbacks > 0 ? "warn" : "pass",
+        value: fallbacks
+      },
+      ...records.slice(0, 5).map((record) => ({
+        href: options.href?.(record.sessionId),
+        label: `Session ${record.sessionId}`,
+        status: toProofPackStatus(record.status),
+        value: record.status
+      }))
+    ],
+    status: failed > 0 || errors > 0 ? "fail" : warnings > 0 || fallbacks > 0 ? "warn" : "pass",
+    summary: "Per-call operations records, trace errors, and provider recovery.",
+    title: options.title ?? "Operations records"
+  };
+};
+var createVoiceProofPackSupportBundleSection = (input) => {
+  const snapshots = input.sessionSnapshots ?? [];
+  const debuggerReports = input.callDebuggerReports ?? [];
+  const failedSnapshots = snapshots.filter((snapshot) => snapshot.status === "fail").length;
+  const failedDebuggerReports = debuggerReports.filter((report) => report.status === "failed").length;
+  const warnings = snapshots.filter((snapshot) => snapshot.status === "warn").length + debuggerReports.filter((report) => report.status === "warning").length;
+  return {
+    evidence: [
+      numberEvidence("Session snapshots", snapshots.length, {
+        passWhenPositive: true
+      }),
+      numberEvidence("Call debugger reports", debuggerReports.length, {
+        passWhenPositive: true
+      }),
+      numberEvidence("Failed snapshots", failedSnapshots, {
+        failWhenPositive: true
+      }),
+      numberEvidence("Failed debugger reports", failedDebuggerReports, {
+        failWhenPositive: true
+      }),
+      {
+        label: "Warning support artifacts",
+        status: warnings > 0 ? "warn" : "pass",
+        value: warnings
+      }
+    ],
+    status: failedSnapshots > 0 || failedDebuggerReports > 0 ? "fail" : warnings > 0 ? "warn" : "pass",
+    summary: "Support artifacts that make the latest call debuggable.",
+    title: input.title ?? "Support bundle"
+  };
+};
+var buildDerivedProofPackSections = (input) => [
+  ...input.productionReadiness ? [createVoiceProofPackProductionReadinessSection(input.productionReadiness)] : [],
+  ...input.providerSlo ? [
+    createVoiceProofPackProviderSloSection(input.providerSlo, {
+      href: input.productionReadiness?.links.providerSlo
+    })
+  ] : [],
+  ...input.operationsRecords && input.operationsRecords.length > 0 ? [
+    createVoiceProofPackOperationsRecordSection(input.operationsRecords, {
+      href: (sessionId) => input.productionReadiness?.links.operationsRecords ? `${input.productionReadiness.links.operationsRecords}/${encodeURIComponent(sessionId)}` : undefined
+    })
+  ] : [],
+  ...input.sessionSnapshots?.length || input.callDebuggerReports?.length ? [
+    createVoiceProofPackSupportBundleSection({
+      callDebuggerReports: input.callDebuggerReports,
+      sessionSnapshots: input.sessionSnapshots
+    })
+  ] : [],
+  ...input.observabilityExport ? buildVoiceProofPackFromObservabilityExport(input.observabilityExport).sections : []
+];
 var resolveProofPack = async (source) => {
   const input = typeof source === "function" ? await source() : source;
   return buildVoiceProofPack(input);
@@ -39890,7 +40060,7 @@ var buildVoiceProofPack = (input) => {
   if ("status" in input && "ok" in input && "summary" in input && Array.isArray(input.sections)) {
     return input;
   }
-  const sections = input.sections ?? [];
+  const sections = [...buildDerivedProofPackSections(input), ...input.sections ?? []];
   const summary = summarizeProofPackSections(sections);
   const status = summary.fail > 0 ? "fail" : summary.warn > 0 ? "warn" : "pass";
   return {
@@ -40462,7 +40632,11 @@ export {
   createVoiceProviderCapabilityHTMLHandler,
   createVoiceProofTrendRoutes,
   createVoiceProofTrendRecommendationRoutes,
+  createVoiceProofPackSupportBundleSection,
   createVoiceProofPackRoutes,
+  createVoiceProofPackProviderSloSection,
+  createVoiceProofPackProductionReadinessSection,
+  createVoiceProofPackOperationsRecordSection,
   createVoiceProofPackArtifacts,
   createVoiceProofAssertion,
   createVoiceProfileTraceTagger,

package/dist/proofPack.d.ts

@@ -1,5 +1,10 @@
 import { Elysia } from 'elysia';
 import type { VoiceObservabilityExportArtifact, VoiceObservabilityExportReport } from './observabilityExport';
+import type { VoiceCallDebuggerReport } from './callDebugger';
+import type { VoiceOperationsRecord } from './operationsRecord';
+import type { VoiceProductionReadinessReport } from './productionReadiness';
+import type { VoiceProviderSloReport } from './providerSlo';
+import type { VoiceSessionSnapshot } from './sessionSnapshot';
 export type VoiceProofPackStatus = 'fail' | 'pass' | 'warn';
 export type VoiceProofPackEvidence = {
     detail?: string;
@@ -31,10 +36,16 @@ export type VoiceProofPack = {
 };
 export type VoiceProofPackInput = {
     artifacts?: VoiceObservabilityExportArtifact[];
+    callDebuggerReports?: VoiceCallDebuggerReport[];
     generatedAt?: number | string;
+    observabilityExport?: VoiceObservabilityExportReport;
+    operationsRecords?: VoiceOperationsRecord[];
     outputDir?: string;
+    productionReadiness?: VoiceProductionReadinessReport;
+    providerSlo?: VoiceProviderSloReport;
     runId?: string;
     sections?: VoiceProofPackSection[];
+    sessionSnapshots?: VoiceSessionSnapshot[];
 };
 export type VoiceProofPackWriteResult = {
     artifacts: VoiceObservabilityExportArtifact[];
@@ -49,6 +60,22 @@ export type VoiceProofPackRoutesOptions = {
     name?: string;
     source: VoiceProofPack | VoiceProofPackInput | (() => VoiceProofPack | VoiceProofPackInput | Promise<VoiceProofPack | VoiceProofPackInput>);
 };
+export declare const createVoiceProofPackProviderSloSection: (report: VoiceProviderSloReport, options?: {
+    href?: string;
+    title?: string;
+}) => VoiceProofPackSection;
+export declare const createVoiceProofPackProductionReadinessSection: (report: VoiceProductionReadinessReport, options?: {
+    title?: string;
+}) => VoiceProofPackSection;
+export declare const createVoiceProofPackOperationsRecordSection: (records: readonly VoiceOperationsRecord[], options?: {
+    href?: (sessionId: string) => string | undefined;
+    title?: string;
+}) => VoiceProofPackSection;
+export declare const createVoiceProofPackSupportBundleSection: (input: {
+    callDebuggerReports?: readonly VoiceCallDebuggerReport[];
+    sessionSnapshots?: readonly VoiceSessionSnapshot[];
+    title?: string;
+}) => VoiceProofPackSection;
 export declare const buildVoiceProofPack: (input: VoiceProofPackInput | VoiceProofPack) => VoiceProofPack;
 export declare const buildVoiceProofPackFromObservabilityExport: (report: VoiceObservabilityExportReport, input?: Omit<VoiceProofPackInput, "artifacts" | "sections">) => VoiceProofPack;
 export declare const renderVoiceProofPackMarkdown: (proofPack: VoiceProofPack) => string;

package/package.json

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