@absolutejs/voice 0.0.22-beta.221 → 0.0.22-beta.222

package/README.md

@@ -2791,7 +2791,7 @@ const exportReport = await buildVoiceObservabilityExport({
 });
 ```
 
-The route helper exposes JSON at `/api/voice/observability-export`, Markdown at `/voice/observability-export.md`, and HTML at `/voice/observability-export`. Path-backed artifacts are hashed with SHA-256 by default, include byte size and freshness metadata, and can fail the export when required evidence is missing or stale. Failed trace/audit deliveries fail the export report, pending deliveries warn, and every trace/audit envelope includes the linked operations-record URL when one is configured. This is the primitive to use when customers ask how voice evidence leaves the app without going through a hosted vendor dashboard.
+The route helper exposes JSON at `/api/voice/observability-export`, an artifact index at `/api/voice/observability-export/artifacts`, per-artifact downloads at `/api/voice/observability-export/artifacts/:artifactId`, Markdown at `/voice/observability-export.md`, and HTML at `/voice/observability-export`. Path-backed artifacts are hashed with SHA-256 by default, include byte size and freshness metadata, and can fail the export when required evidence is missing or stale. Failed trace/audit deliveries fail the export report, pending deliveries warn, and every trace/audit envelope includes the linked operations-record URL when one is configured. This is the primitive to use when customers ask how voice evidence leaves the app without going through a hosted vendor dashboard.
 
 Pass the same report into production readiness when export health should block deploys:
 

package/dist/index.d.ts

@@ -53,7 +53,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, renderVoiceOperationsRecordIncidentMarkdown } from './operationsRecord';
-export { buildVoiceObservabilityExport, createVoiceObservabilityExportRoutes, renderVoiceObservabilityExportMarkdown } from './observabilityExport';
+export { buildVoiceObservabilityArtifactIndex, buildVoiceObservabilityExport, createVoiceObservabilityExportRoutes, renderVoiceObservabilityExportMarkdown } from './observabilityExport';
 export { buildVoiceOpsRecoveryReadinessCheck, buildVoiceOpsRecoveryReport, createVoiceOpsRecoveryRoutes, renderVoiceOpsRecoveryHTML, renderVoiceOpsRecoveryMarkdown } from './opsRecovery';
 export { buildVoiceIncidentBundle, createStoredVoiceIncidentBundleArtifact, createVoiceIncidentBundleRoutes, createVoiceMemoryIncidentBundleStore, pruneVoiceIncidentBundleArtifacts, saveVoiceIncidentBundleArtifact } from './incidentBundle';
 export { summarizeVoiceOpsStatus } from './opsStatus';
@@ -118,7 +118,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, VoiceOperationsRecordIntegrationEventSummary, VoiceOperationsRecordOptions, VoiceOperationsRecordOutcome, VoiceOperationsRecordProviderDecision, VoiceOperationsRecordReviewSummary, VoiceOperationsRecordRoutesOptions, VoiceOperationsRecordStatus, VoiceOperationsRecordTaskSummary, VoiceOperationsRecordTranscriptTurn, VoiceOperationsRecordTool } from './operationsRecord';
-export type { VoiceObservabilityExportArtifact, VoiceObservabilityExportArtifactKind, VoiceObservabilityExportDeliverySummary, VoiceObservabilityExportEnvelope, VoiceObservabilityExportIssue, VoiceObservabilityExportIssueCode, VoiceObservabilityExportOptions, VoiceObservabilityExportRedactionSummary, VoiceObservabilityExportReport, VoiceObservabilityExportRoutesOptions, VoiceObservabilityExportStatus } from './observabilityExport';
+export type { VoiceObservabilityExportArtifact, VoiceObservabilityExportArtifactChecksum, VoiceObservabilityExportArtifactFreshness, VoiceObservabilityExportArtifactIndex, VoiceObservabilityExportArtifactIndexItem, VoiceObservabilityExportArtifactKind, VoiceObservabilityExportDeliverySummary, VoiceObservabilityExportEnvelope, VoiceObservabilityExportIssue, VoiceObservabilityExportIssueCode, VoiceObservabilityExportOptions, VoiceObservabilityExportRedactionSummary, VoiceObservabilityExportReport, VoiceObservabilityExportRoutesOptions, VoiceObservabilityExportStatus } from './observabilityExport';
 export type { VoiceOpsRecoveryFailedSession, VoiceOpsRecoveryInterventionSummary, VoiceOpsRecoveryIssue, VoiceOpsRecoveryIssueCode, VoiceOpsRecoveryLinks, VoiceOpsRecoveryProviderSummary, VoiceOpsRecoveryReport, VoiceOpsRecoveryReportOptions, VoiceOpsRecoveryRoutesOptions, VoiceOpsRecoveryStatus } from './opsRecovery';
 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';

package/dist/index.js

@@ -24982,6 +24982,36 @@ var checksumFile = async (path) => {
   const buffer = await readFile2(path);
   return createHash("sha256").update(buffer).digest("hex");
 };
+var inferContentType = (artifact) => {
+  if (artifact.contentType) {
+    return artifact.contentType;
+  }
+  const path = artifact.path ? stripArtifactPathAnchor(artifact.path) : "";
+  if (path.endsWith(".json")) {
+    return "application/json; charset=utf-8";
+  }
+  if (path.endsWith(".md") || path.endsWith(".markdown")) {
+    return "text/markdown; charset=utf-8";
+  }
+  if (path.endsWith(".html")) {
+    return "text/html; charset=utf-8";
+  }
+  if (path.endsWith(".png")) {
+    return "image/png";
+  }
+  if (path.endsWith(".jpg") || path.endsWith(".jpeg")) {
+    return "image/jpeg";
+  }
+  if (path.endsWith(".txt") || path.endsWith(".log")) {
+    return "text/plain; charset=utf-8";
+  }
+  return "application/octet-stream";
+};
+var addArtifactDownloadHrefs = (artifacts, links) => artifacts.map((artifact) => ({
+  ...artifact,
+  contentType: artifact.contentType ?? inferContentType(artifact),
+  downloadHref: artifact.downloadHref ?? (artifact.path ? links?.artifactDownload?.(artifact) : undefined)
+}));
 var verifyArtifact = async (artifact, options) => {
   const now = options.now ?? Date.now();
   const maxAgeMs = artifact.maxAgeMs ?? options.maxAgeMs;
@@ -25171,7 +25201,7 @@ var buildVoiceObservabilityExport = async (options = {}) => {
   const traceDeliverySummary = traceDeliveries ? await summarizeVoiceTraceSinkDeliveries(traceDeliveries) : undefined;
   const auditDeliverySummary = auditDeliveries ? await summarizeVoiceAuditSinkDeliveries(auditDeliveries) : undefined;
   const operationArtifacts = operationsRecords.map((record) => createOperationArtifact(record, options.links?.operationsRecord?.(record.sessionId)));
-  const artifacts = await verifyArtifacts([...operationArtifacts, ...options.artifacts ?? []], options.artifactIntegrity);
+  const artifacts = addArtifactDownloadHrefs(await verifyArtifacts([...operationArtifacts, ...options.artifacts ?? []], options.artifactIntegrity), options.links);
   const operationHrefBySessionId = new Map(sessionIds.map((sessionId) => [
     sessionId,
     options.links?.operationsRecord?.(sessionId)
@@ -25252,19 +25282,87 @@ ${artifacts}
 ${issues}
 `;
 };
+var buildVoiceObservabilityArtifactIndex = (report) => {
+  const artifacts = report.artifacts.map((artifact) => ({
+    bytes: artifact.bytes,
+    checksum: artifact.checksum,
+    contentType: artifact.contentType,
+    downloadHref: artifact.downloadHref,
+    freshness: artifact.freshness,
+    href: artifact.href,
+    id: artifact.id,
+    kind: artifact.kind,
+    label: artifact.label,
+    required: artifact.required,
+    sessionId: artifact.sessionId,
+    status: artifact.status
+  }));
+  return {
+    artifacts,
+    checkedAt: report.checkedAt,
+    status: report.status,
+    summary: {
+      downloadable: artifacts.filter((artifact) => artifact.downloadHref).length,
+      failed: artifacts.filter((artifact) => artifact.status === "fail").length,
+      required: artifacts.filter((artifact) => artifact.required).length,
+      total: artifacts.length,
+      warn: artifacts.filter((artifact) => artifact.status === "warn").length
+    }
+  };
+};
 var createVoiceObservabilityExportRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice/observability-export";
+  const artifactIndexPath = options.artifactIndexPath ?? `${path}/artifacts`;
+  const artifactDownloadPath = options.artifactDownloadPath ?? `${path}/artifacts`;
   const markdownPath = options.markdownPath ?? "/voice/observability-export.md";
   const htmlPath = options.htmlPath ?? "/voice/observability-export";
   const headers = {
     "cache-control": "no-store",
     ...options.headers ?? {}
   };
-  const buildReport = () => buildVoiceObservabilityExport(options);
+  const buildReport = () => buildVoiceObservabilityExport({
+    ...options,
+    links: {
+      ...options.links,
+      artifactDownload: options.links?.artifactDownload ?? (artifactDownloadPath ? (artifact) => `${artifactDownloadPath}/${encodeURIComponent(artifact.id)}` : undefined)
+    }
+  });
   const app = new Elysia42({
     name: options.name ?? "absolute-voice-observability-export"
   });
   app.get(path, async () => Response.json(await buildReport(), { headers }));
+  if (artifactIndexPath !== false) {
+    app.get(artifactIndexPath, async () => Response.json(buildVoiceObservabilityArtifactIndex(await buildReport()), { headers }));
+  }
+  if (artifactDownloadPath !== false) {
+    app.get(`${artifactDownloadPath}/:artifactId`, async ({ params }) => {
+      const artifactId = decodeURIComponent(params.artifactId);
+      const report = await buildReport();
+      const artifact = report.artifacts.find((item) => item.id === artifactId);
+      if (!artifact?.path) {
+        return Response.json({ error: "Artifact is not downloadable.", artifactId }, { headers, status: 404 });
+      }
+      try {
+        const body = await readFile2(stripArtifactPathAnchor(artifact.path));
+        return new Response(body, {
+          headers: {
+            ...headers,
+            "content-disposition": `attachment; filename="${encodeURIComponent(artifact.id)}"`,
+            "content-type": artifact.contentType ?? inferContentType(artifact),
+            ...artifact.checksum ? {
+              "x-absolute-voice-artifact-sha256": artifact.checksum.value
+            } : {},
+            "x-absolute-voice-artifact-id": artifact.id,
+            ...artifact.freshness ? {
+              "x-absolute-voice-artifact-freshness": artifact.freshness.status
+            } : {}
+          }
+        });
+      } catch {
+        return Response.json({ error: "Artifact file is not available.", artifactId }, { headers, status: 404 });
+      }
+    });
+  }
   if (markdownPath !== false) {
     app.get(markdownPath, async () => {
       const report = await buildReport();
@@ -28291,6 +28389,7 @@ export {
   buildVoiceOpsActionHistoryReport,
   buildVoiceOperationsRecord,
   buildVoiceObservabilityExport,
+  buildVoiceObservabilityArtifactIndex,
   buildVoiceLiveOpsControlState,
   buildVoiceLatencySLOGate,
   buildVoiceIncidentBundle,

package/dist/observabilityExport.d.ts

@@ -21,6 +21,7 @@ export type VoiceObservabilityExportArtifact = {
     bytes?: number;
     checksum?: VoiceObservabilityExportArtifactChecksum;
     contentType?: string;
+    downloadHref?: string;
     freshness?: VoiceObservabilityExportArtifactFreshness;
     generatedAt?: number | string;
     href?: string;
@@ -80,6 +81,32 @@ export type VoiceObservabilityExportReport = {
         traceEvents: number;
     };
 };
+export type VoiceObservabilityExportArtifactIndexItem = {
+    bytes?: number;
+    checksum?: VoiceObservabilityExportArtifactChecksum;
+    contentType?: string;
+    downloadHref?: string;
+    freshness?: VoiceObservabilityExportArtifactFreshness;
+    href?: string;
+    id: string;
+    kind: VoiceObservabilityExportArtifactKind;
+    label: string;
+    required?: boolean;
+    sessionId?: string;
+    status?: VoiceObservabilityExportStatus;
+};
+export type VoiceObservabilityExportArtifactIndex = {
+    artifacts: VoiceObservabilityExportArtifactIndexItem[];
+    checkedAt: number;
+    status: VoiceObservabilityExportStatus;
+    summary: {
+        downloadable: number;
+        failed: number;
+        required: number;
+        total: number;
+        warn: number;
+    };
+};
 export type VoiceObservabilityExportOptions = {
     artifacts?: VoiceObservabilityExportArtifact[];
     artifactIntegrity?: {
@@ -94,6 +121,7 @@ export type VoiceObservabilityExportOptions = {
     events?: StoredVoiceTraceEvent[];
     includeOperationsRecords?: boolean;
     links?: {
+        artifactDownload?: (artifact: VoiceObservabilityExportArtifact) => string;
         operationsRecord?: (sessionId: string) => string;
     };
     operationsRecords?: VoiceOperationsRecord[];
@@ -104,6 +132,8 @@ export type VoiceObservabilityExportOptions = {
 };
 export type VoiceObservabilityExportRoutesOptions = VoiceObservabilityExportOptions & {
     headers?: HeadersInit;
+    artifactDownloadPath?: false | string;
+    artifactIndexPath?: false | string;
     htmlPath?: false | string;
     markdownPath?: false | string;
     name?: string;
@@ -115,6 +145,7 @@ export declare const buildVoiceObservabilityExport: (options?: VoiceObservabilit
 export declare const renderVoiceObservabilityExportMarkdown: (report: VoiceObservabilityExportReport, options?: {
     title?: string;
 }) => string;
+export declare const buildVoiceObservabilityArtifactIndex: (report: VoiceObservabilityExportReport) => VoiceObservabilityExportArtifactIndex;
 export declare const createVoiceObservabilityExportRoutes: (options?: VoiceObservabilityExportRoutesOptions) => Elysia<"", {
     decorator: {};
     store: {};

package/package.json

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