@absolutejs/voice 0.0.22-beta.227 → 0.0.22-beta.229

package/README.md

@@ -2753,6 +2753,19 @@ Readiness emits the stable `voice.readiness.ops_recovery` gate code when unresol
 
 Use observability exports when a buyer wants the hosted-dashboard evidence graph, but inside their own storage, warehouse, SIEM, incident flow, or release notes. The export manifest links traces, audits, operations records, delivery queues, provider SLOs, readiness reports, screenshots, and proof-pack artifacts without making AbsoluteJS Voice the dashboard.
 
+Every export manifest and artifact index includes a stable schema contract:
+
+```ts
+import {
+	assertVoiceObservabilityExportSchema,
+	voiceObservabilityExportSchemaId,
+	voiceObservabilityExportSchemaVersion
+} from '@absolutejs/voice';
+
+assertVoiceObservabilityExportSchema(exportReport);
+console.log(voiceObservabilityExportSchemaId, voiceObservabilityExportSchemaVersion);
+```
+
 ```ts
 import {
 	buildVoiceObservabilityExport,
@@ -2781,6 +2794,19 @@ app.use(
 				keyPrefix: 'voice/observability-exports',
 				kind: 's3',
 				label: 'S3 customer-owned observability archive'
+			},
+			{
+				kind: 'sqlite',
+				path: '.voice-runtime/observability-exports.sqlite',
+				tableName: 'voice_observability_exports',
+				label: 'SQLite customer-owned observability warehouse'
+			},
+			{
+				connectionString: process.env.VOICE_OBSERVABILITY_EXPORT_POSTGRES_URL,
+				kind: 'postgres',
+				schemaName: 'voice',
+				tableName: 'observability_exports',
+				label: 'Postgres customer-owned observability warehouse'
 			}
 		],
 		deliveryReceipts: observabilityReceipts,
@@ -2819,7 +2845,7 @@ const exportReport = await buildVoiceObservabilityExport({
 });
 ```
 
-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`, delivery at `POST /api/voice/observability-export/deliveries`, delivery history at `GET /api/voice/observability-export/deliveries`, 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. File delivery writes `manifest.json`, `artifact-index.json`, and artifact files into a customer-owned archive directory; webhook delivery posts the manifest and artifact index to a buyer-owned collector, SIEM bridge, or warehouse endpoint; S3 delivery writes the same manifest, index, and artifact files through Bun's native S3 client. Delivery receipt stores persist run id, destinations, status, and target history so operators can prove exports have been continuously healthy. 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`, delivery at `POST /api/voice/observability-export/deliveries`, delivery history at `GET /api/voice/observability-export/deliveries`, 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. File delivery writes `manifest.json`, `artifact-index.json`, and artifact files into a customer-owned archive directory; webhook delivery posts the manifest and artifact index to a buyer-owned collector, SIEM bridge, or warehouse endpoint; S3 delivery writes the same manifest, index, and artifact files through Bun's native S3 client; SQLite and Postgres delivery persist the schema id/version, manifest, artifact index, checksum metadata, status, run id, and timestamps into buyer-owned database tables. Delivery receipt stores persist run id, destinations, status, schema, and target history so operators can prove exports have been continuously healthy. 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 { buildVoiceObservabilityArtifactIndex, buildVoiceObservabilityExportDeliveryHistory, buildVoiceObservabilityExport, createVoiceFileObservabilityExportDeliveryReceiptStore, createVoiceMemoryObservabilityExportDeliveryReceiptStore, createVoiceObservabilityExportRoutes, deliverVoiceObservabilityExport, renderVoiceObservabilityExportMarkdown } from './observabilityExport';
+export { buildVoiceObservabilityArtifactIndex, buildVoiceObservabilityExportDeliveryHistory, buildVoiceObservabilityExport, assertVoiceObservabilityExportSchema, createVoiceObservabilityExportSchema, createVoiceFileObservabilityExportDeliveryReceiptStore, createVoiceMemoryObservabilityExportDeliveryReceiptStore, createVoiceObservabilityExportRoutes, deliverVoiceObservabilityExport, renderVoiceObservabilityExportMarkdown, voiceObservabilityExportSchemaId, voiceObservabilityExportSchemaVersion } 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, VoiceObservabilityExportArtifactChecksum, VoiceObservabilityExportArtifactFreshness, VoiceObservabilityExportArtifactIndex, VoiceObservabilityExportArtifactIndexItem, VoiceObservabilityExportArtifactKind, VoiceObservabilityExportDeliverySummary, VoiceObservabilityExportDeliveryDestination, VoiceObservabilityExportDeliveryDestinationResult, VoiceObservabilityExportDeliveryHistory, VoiceObservabilityExportDeliveryOptions, VoiceObservabilityExportDeliveryReceipt, VoiceObservabilityExportDeliveryReceiptStore, VoiceObservabilityExportDeliveryReport, VoiceObservabilityExportEnvelope, VoiceObservabilityExportIssue, VoiceObservabilityExportIssueCode, VoiceObservabilityExportOptions, VoiceObservabilityExportRedactionSummary, VoiceObservabilityExportReport, VoiceObservabilityExportRoutesOptions, VoiceObservabilityExportStatus } from './observabilityExport';
+export type { VoiceObservabilityExportArtifact, VoiceObservabilityExportArtifactChecksum, VoiceObservabilityExportArtifactFreshness, VoiceObservabilityExportArtifactIndex, VoiceObservabilityExportArtifactIndexItem, VoiceObservabilityExportArtifactKind, VoiceObservabilityExportDeliverySummary, VoiceObservabilityExportDeliveryDestination, VoiceObservabilityExportDeliveryDestinationResult, VoiceObservabilityExportDeliveryHistory, VoiceObservabilityExportDeliveryOptions, VoiceObservabilityExportDeliveryReceipt, VoiceObservabilityExportDeliveryReceiptStore, VoiceObservabilityExportDeliveryReport, VoiceObservabilityExportEnvelope, VoiceObservabilityExportIssue, VoiceObservabilityExportIssueCode, VoiceObservabilityExportOptions, VoiceObservabilityExportRedactionSummary, VoiceObservabilityExportReport, VoiceObservabilityExportRoutesOptions, VoiceObservabilityExportSchema, 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

@@ -22448,6 +22448,7 @@ var createVoiceOpsRecoveryRoutes = (options = {}) => {
 
 // src/observabilityExport.ts
 import { Elysia as Elysia39 } from "elysia";
+import { Database } from "bun:sqlite";
 import { createHash } from "crypto";
 import { mkdir as mkdir4, readFile as readFile2, stat, unlink } from "fs/promises";
 import { join as join3 } from "path";
@@ -22986,6 +22987,17 @@ var createVoiceOperationsRecordRoutes = (options) => {
 };
 
 // src/observabilityExport.ts
+var voiceObservabilityExportSchemaVersion = "1.0.0";
+var voiceObservabilityExportSchemaId = "com.absolutejs.voice.observability-export";
+var createVoiceObservabilityExportSchema = () => ({
+  id: voiceObservabilityExportSchemaId,
+  version: voiceObservabilityExportSchemaVersion
+});
+var assertVoiceObservabilityExportSchema = (input) => {
+  if (input.schema?.id !== voiceObservabilityExportSchemaId || input.schema?.version !== voiceObservabilityExportSchemaVersion) {
+    throw new Error(`Unsupported voice observability export schema: ${input.schema?.id ?? "missing"}@${input.schema?.version ?? "missing"}`);
+  }
+};
 var isDeliveryStore = (value) => !Array.isArray(value) && typeof value.list === "function";
 var getString17 = (value) => typeof value === "string" ? value : undefined;
 var getProviderKind = (payload) => getString17(payload.kind) ?? getString17(payload.providerKind);
@@ -23038,6 +23050,117 @@ var writeS3Object = async (input) => {
     type: input.contentType
   });
 };
+var quoteObservabilityIdentifier = (value) => `"${value.replace(/"/g, '""')}"`;
+var normalizeObservabilityIdentifier = (value) => value?.trim().replace(/[^a-zA-Z0-9_]+/g, "_").replace(/^_+|_+$/g, "") || "voice_observability_exports";
+var buildObservabilityExportDatabaseRecord = (input) => ({
+  artifactCount: input.artifactIndex.summary.total,
+  artifactIndex: input.artifactIndex,
+  checkedAt: input.checkedAt,
+  exportStatus: input.report.status,
+  manifest: input.report,
+  runId: input.runId,
+  schema: input.report.schema,
+  status: input.report.status
+});
+var deliverObservabilityExportToSQLite = async (input) => {
+  if (!input.destination.database && !input.destination.path) {
+    throw new Error("SQLite observability export delivery requires destination.database or destination.path.");
+  }
+  const database = input.destination.database ?? new Database(input.destination.path, { create: true });
+  const table = quoteObservabilityIdentifier(normalizeObservabilityIdentifier(input.destination.tableName));
+  const record = buildObservabilityExportDatabaseRecord(input);
+  database.exec(`CREATE TABLE IF NOT EXISTS ${table} (
+			run_id TEXT PRIMARY KEY,
+			checked_at INTEGER NOT NULL,
+			status TEXT NOT NULL,
+			export_status TEXT NOT NULL,
+			artifact_count INTEGER NOT NULL,
+			manifest_json TEXT NOT NULL,
+			artifact_index_json TEXT NOT NULL,
+			payload_json TEXT NOT NULL
+		)`);
+  database.query(`INSERT INTO ${table}
+			 (run_id, checked_at, status, export_status, artifact_count, manifest_json, artifact_index_json, payload_json)
+			 VALUES ($runId, $checkedAt, $status, $exportStatus, $artifactCount, $manifest, $artifactIndex, $payload)
+			 ON CONFLICT(run_id) DO UPDATE SET
+				checked_at = excluded.checked_at,
+				status = excluded.status,
+				export_status = excluded.export_status,
+				artifact_count = excluded.artifact_count,
+				manifest_json = excluded.manifest_json,
+				artifact_index_json = excluded.artifact_index_json,
+				payload_json = excluded.payload_json`).run({
+    $artifactCount: input.artifactIndex.summary.total,
+    $artifactIndex: input.index,
+    $checkedAt: input.checkedAt,
+    $exportStatus: input.report.status,
+    $manifest: input.manifest,
+    $payload: JSON.stringify(record),
+    $runId: input.runId,
+    $status: input.report.status
+  });
+  return input.destination.path ? `sqlite://${input.destination.path}/${table.replaceAll('"', "")}` : `sqlite://memory/${table.replaceAll('"', "")}`;
+};
+var deliverObservabilityExportToPostgres = async (input) => {
+  const sql = input.destination.sql ?? (input.destination.connectionString ? (() => {
+    const client = new Bun.SQL(input.destination.connectionString);
+    return { unsafe: client.unsafe.bind(client) };
+  })() : undefined);
+  if (!sql) {
+    throw new Error("Postgres observability export delivery requires destination.sql or destination.connectionString.");
+  }
+  const schema = normalizeObservabilityIdentifier(input.destination.schemaName ?? "public");
+  const table = normalizeObservabilityIdentifier(input.destination.tableName);
+  const qualifiedTable = `${quoteObservabilityIdentifier(schema)}.${quoteObservabilityIdentifier(table)}`;
+  const record = buildObservabilityExportDatabaseRecord(input);
+  await sql.unsafe(`CREATE SCHEMA IF NOT EXISTS ${quoteObservabilityIdentifier(schema)}`);
+  await sql.unsafe(`CREATE TABLE IF NOT EXISTS ${qualifiedTable} (
+			run_id TEXT PRIMARY KEY,
+			checked_at BIGINT NOT NULL,
+			status TEXT NOT NULL,
+			export_status TEXT NOT NULL,
+			artifact_count INTEGER NOT NULL,
+			manifest_json JSONB NOT NULL,
+			artifact_index_json JSONB NOT NULL,
+			payload JSONB NOT NULL
+		)`);
+  await sql.unsafe(`INSERT INTO ${qualifiedTable}
+		 (run_id, checked_at, status, export_status, artifact_count, manifest_json, artifact_index_json, payload)
+		 VALUES ($1, $2, $3, $4, $5, $6::jsonb, $7::jsonb, $8::jsonb)
+		 ON CONFLICT (run_id) DO UPDATE SET
+			checked_at = EXCLUDED.checked_at,
+			status = EXCLUDED.status,
+			export_status = EXCLUDED.export_status,
+			artifact_count = EXCLUDED.artifact_count,
+			manifest_json = EXCLUDED.manifest_json,
+			artifact_index_json = EXCLUDED.artifact_index_json,
+			payload = EXCLUDED.payload`, [
+    input.runId,
+    input.checkedAt,
+    input.report.status,
+    input.report.status,
+    input.artifactIndex.summary.total,
+    input.manifest,
+    input.index,
+    JSON.stringify(record)
+  ]);
+  return `postgres://${schema}/${table}`;
+};
+var observabilityExportDeliveryFailureTarget = (destination) => {
+  if (destination.kind === "file") {
+    return destination.directory;
+  }
+  if (destination.kind === "s3") {
+    return destination.bucket ? `s3://${destination.bucket}/${normalizeExportS3KeyPrefix(destination.keyPrefix)}` : normalizeExportS3KeyPrefix(destination.keyPrefix);
+  }
+  if (destination.kind === "sqlite") {
+    return destination.path ?? "sqlite://memory";
+  }
+  if (destination.kind === "postgres") {
+    return destination.connectionString ?? "postgres://configured-client";
+  }
+  return destination.url;
+};
 var createVoiceMemoryObservabilityExportDeliveryReceiptStore = () => {
   const receipts = new Map;
   return {
@@ -23349,6 +23472,7 @@ var buildVoiceObservabilityExport = async (options = {}) => {
       enabled: Boolean(options.redact),
       mode: options.redact ? "redacted" : "none"
     },
+    schema: createVoiceObservabilityExportSchema(),
     sessionIds,
     status,
     summary: {
@@ -23417,6 +23541,7 @@ var buildVoiceObservabilityArtifactIndex = (report) => {
   return {
     artifacts,
     checkedAt: report.checkedAt,
+    schema: report.schema,
     status: report.status,
     summary: {
       downloadable: artifacts.filter((artifact) => artifact.downloadHref).length,
@@ -23437,7 +23562,7 @@ var deliverVoiceObservabilityExport = async (options) => {
 `;
   const destinations = await Promise.all(options.destinations.map(async (destination) => {
     const destinationId = destination.id ?? `${destination.kind}-${destination.label ?? "export"}`;
-    const label = destination.label ?? (destination.kind === "file" ? "File observability export" : "Webhook observability export");
+    const label = destination.label ?? (destination.kind === "file" ? "File observability export" : destination.kind === "s3" ? "S3 observability export" : destination.kind === "sqlite" ? "SQLite observability export" : destination.kind === "postgres" ? "Postgres observability export" : "Webhook observability export");
     try {
       if (destination.kind === "file") {
         const target = join3(destination.directory, runId);
@@ -23459,6 +23584,7 @@ var deliverVoiceObservabilityExport = async (options) => {
           destinationKind: destination.kind,
           label,
           manifestBytes: byteLength(manifest),
+          schema: options.report.schema,
           status: "delivered",
           target
         };
@@ -23503,10 +23629,55 @@ var deliverVoiceObservabilityExport = async (options) => {
           destinationKind: destination.kind,
           label,
           manifestBytes: byteLength(manifest),
+          schema: options.report.schema,
           status: "delivered",
           target: destination.bucket ? `s3://${destination.bucket}/${rootKey}` : rootKey
         };
       }
+      if (destination.kind === "sqlite") {
+        const target = await deliverObservabilityExportToSQLite({
+          artifactIndex,
+          checkedAt,
+          destination,
+          index,
+          manifest,
+          report: options.report,
+          runId
+        });
+        return {
+          artifactCount: artifactIndex.summary.total,
+          deliveredAt: Date.now(),
+          destinationId,
+          destinationKind: destination.kind,
+          label,
+          manifestBytes: byteLength(manifest),
+          schema: options.report.schema,
+          status: "delivered",
+          target
+        };
+      }
+      if (destination.kind === "postgres") {
+        const target = await deliverObservabilityExportToPostgres({
+          artifactIndex,
+          checkedAt,
+          destination,
+          index,
+          manifest,
+          report: options.report,
+          runId
+        });
+        return {
+          artifactCount: artifactIndex.summary.total,
+          deliveredAt: Date.now(),
+          destinationId,
+          destinationKind: destination.kind,
+          label,
+          manifestBytes: byteLength(manifest),
+          schema: options.report.schema,
+          status: "delivered",
+          target
+        };
+      }
       const controller = new AbortController;
       const timeout = setTimeout(() => controller.abort(), destination.timeoutMs ?? 1e4);
       try {
@@ -23538,6 +23709,7 @@ var deliverVoiceObservabilityExport = async (options) => {
         destinationKind: destination.kind,
         label,
         manifestBytes: byteLength(manifest),
+        schema: options.report.schema,
         status: "delivered",
         target: destination.url
       };
@@ -23550,8 +23722,9 @@ var deliverVoiceObservabilityExport = async (options) => {
         error: error instanceof Error ? error.message : String(error),
         label,
         manifestBytes: byteLength(manifest),
+        schema: options.report.schema,
         status: "failed",
-        target: destination.kind === "file" ? destination.directory : destination.kind === "s3" ? destination.bucket ? `s3://${destination.bucket}/${normalizeExportS3KeyPrefix(destination.keyPrefix)}` : normalizeExportS3KeyPrefix(destination.keyPrefix) : destination.url
+        target: observabilityExportDeliveryFailureTarget(destination)
       };
     }
   }));
@@ -26701,7 +26874,7 @@ var createVoiceTraceDeliveryRoutes = (options) => {
   return routes;
 };
 // src/sqliteStore.ts
-import { Database } from "bun:sqlite";
+import { Database as Database2 } from "bun:sqlite";
 var normalizeTableNameSegment = (value) => value.trim().replace(/[^a-zA-Z0-9_]+/g, "_").replace(/^_+|_+$/g, "") || "voice";
 var resolveTableName = (input) => {
   if (input.options.tableName) {
@@ -26712,7 +26885,7 @@ var resolveTableName = (input) => {
   return `${prefix}_${fallback}`;
 };
 var openVoiceSQLiteDatabase = (path) => {
-  const database = new Database(path, {
+  const database = new Database2(path, {
     create: true
   });
   database.exec("PRAGMA journal_mode = WAL;");
@@ -28281,6 +28454,8 @@ export {
   withVoiceOpsTaskId,
   withVoiceIntegrationEventId,
   voiceTelephonyOutcomeToRouteResult,
+  voiceObservabilityExportSchemaVersion,
+  voiceObservabilityExportSchemaId,
   voiceComplianceRedactionDefaults,
   voice,
   verifyVoiceTwilioWebhookSignature,
@@ -28588,6 +28763,7 @@ export {
   createVoiceOpsConsoleRoutes,
   createVoiceOpsActionAuditRoutes,
   createVoiceOperationsRecordRoutes,
+  createVoiceObservabilityExportSchema,
   createVoiceObservabilityExportRoutes,
   createVoiceMemoryTraceSinkDeliveryStore,
   createVoiceMemoryTraceEventStore,
@@ -28745,6 +28921,7 @@ export {
   buildVoiceAuditDeliveryReport,
   assignVoiceOpsTask,
   assertVoiceProviderRoutingContract,
+  assertVoiceObservabilityExportSchema,
   assertVoiceLatencySLOGate,
   assertVoiceAgentSquadContract,
   applyVoiceTelephonyOutcome,

package/dist/observabilityExport.d.ts

@@ -1,11 +1,23 @@
 import { Elysia } from 'elysia';
 import type { S3Client, S3Options } from 'bun';
+import { Database } from 'bun:sqlite';
 import { type VoiceAuditSinkDeliveryQueueSummary, type VoiceAuditSinkDeliveryRecord, type VoiceAuditSinkDeliveryStore } from './auditSinks';
 import type { VoiceAuditEventStore, VoiceAuditEventType } from './audit';
 import { type VoiceOperationsRecord } from './operationsRecord';
 import { type VoiceTraceSinkDeliveryQueueSummary } from './queue';
 import { type StoredVoiceTraceEvent, type VoiceTraceEventStore, type VoiceTraceEventType, type VoiceTraceRedactionConfig, type VoiceTraceSinkDeliveryRecord, type VoiceTraceSinkDeliveryStore, type VoiceTraceSummary } from './trace';
+import type { VoicePostgresClient } from './postgresStore';
 export type VoiceObservabilityExportStatus = 'fail' | 'pass' | 'warn';
+export declare const voiceObservabilityExportSchemaVersion = "1.0.0";
+export declare const voiceObservabilityExportSchemaId = "com.absolutejs.voice.observability-export";
+export type VoiceObservabilityExportSchema = {
+    id: typeof voiceObservabilityExportSchemaId;
+    version: typeof voiceObservabilityExportSchemaVersion;
+};
+export declare const createVoiceObservabilityExportSchema: () => VoiceObservabilityExportSchema;
+export declare const assertVoiceObservabilityExportSchema: (input: {
+    schema?: Partial<VoiceObservabilityExportSchema>;
+}) => void;
 export type VoiceObservabilityExportArtifactKind = 'incident' | 'markdown' | 'operations-record' | 'proof-pack' | 'readiness' | 'screenshot' | 'slo' | 'trace' | 'audit' | 'custom';
 export type VoiceObservabilityExportArtifactChecksum = {
     algorithm: 'sha256';
@@ -72,6 +84,7 @@ export type VoiceObservabilityExportReport = {
     issues: VoiceObservabilityExportIssue[];
     operationsRecords: VoiceOperationsRecord[];
     redaction: VoiceObservabilityExportRedactionSummary;
+    schema: VoiceObservabilityExportSchema;
     sessionIds: string[];
     status: VoiceObservabilityExportStatus;
     summary: {
@@ -99,6 +112,7 @@ export type VoiceObservabilityExportArtifactIndexItem = {
 export type VoiceObservabilityExportArtifactIndex = {
     artifacts: VoiceObservabilityExportArtifactIndexItem[];
     checkedAt: number;
+    schema: VoiceObservabilityExportSchema;
     status: VoiceObservabilityExportStatus;
     summary: {
         downloadable: number;
@@ -123,6 +137,21 @@ export type VoiceObservabilityExportDeliveryDestination = {
     kind: 's3';
     label?: string;
 }) | {
+    database?: Database;
+    id?: string;
+    kind: 'sqlite';
+    label?: string;
+    path?: string;
+    tableName?: string;
+} | {
+    connectionString?: string;
+    id?: string;
+    kind: 'postgres';
+    label?: string;
+    schemaName?: string;
+    sql?: VoicePostgresClient;
+    tableName?: string;
+} | {
     fetch?: typeof fetch;
     headers?: Record<string, string>;
     id?: string;
@@ -140,6 +169,7 @@ export type VoiceObservabilityExportDeliveryDestinationResult = {
     error?: string;
     label: string;
     manifestBytes: number;
+    schema: VoiceObservabilityExportSchema;
     status: 'delivered' | 'failed';
     target: string;
 };

package/package.json

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