@absolutejs/voice 0.0.22-beta.144 → 0.0.22-beta.146

package/dist/auditSinks.d.ts

@@ -1,3 +1,4 @@
+import type { S3Client, S3Options } from 'bun';
 import type { StoredVoiceAuditEvent, VoiceAuditEventStore, VoiceAuditEventType } from './audit';
 import type { VoiceIdempotencyStore, VoiceRedisTaskLeaseCoordinator } from './queue';
 import type { VoiceTraceRedactionConfig } from './trace';
@@ -59,6 +60,22 @@ export type VoiceAuditHTTPSinkOptions<TBody extends Record<string, unknown> = Re
     timeoutMs?: number;
     url: string;
 };
+export type VoiceS3AuditSinkFile = {
+    write: (data: string, options?: BlobPropertyBag) => Promise<number> | number;
+};
+export type VoiceS3AuditSinkClient = Pick<S3Client, 'file'>;
+export type VoiceAuditS3SinkOptions<TBody extends Record<string, unknown> = Record<string, unknown>> = S3Options & {
+    body?: (input: {
+        events: StoredVoiceAuditEvent[];
+        key: string;
+    }) => Promise<TBody> | TBody;
+    client?: VoiceS3AuditSinkClient;
+    contentType?: string;
+    eventTypes?: VoiceAuditEventType[];
+    id: string;
+    keyPrefix?: string;
+    kind?: string;
+};
 export type VoiceAuditSinkStoreOptions<TEvent extends StoredVoiceAuditEvent = StoredVoiceAuditEvent> = {
     awaitDelivery?: boolean;
     deliveryQueue?: VoiceAuditSinkDeliveryStore;
@@ -117,6 +134,7 @@ export declare const createVoiceAuditSinkDeliveryRecord: (input: {
     id?: string;
 } & Partial<Omit<VoiceAuditSinkDeliveryRecord, "createdAt" | "events" | "id">>) => VoiceAuditSinkDeliveryRecord;
 export declare const createVoiceAuditHTTPSink: <TBody extends Record<string, unknown> = Record<string, unknown>>(options: VoiceAuditHTTPSinkOptions<TBody>) => VoiceAuditSink;
+export declare const createVoiceAuditS3Sink: <TBody extends Record<string, unknown> = Record<string, unknown>>(options: VoiceAuditS3SinkOptions<TBody>) => VoiceAuditSink;
 export declare const deliverVoiceAuditEventsToSinks: (input: {
     events: StoredVoiceAuditEvent[];
     redact?: VoiceTraceRedactionConfig;

package/dist/deliverySinkRoutes.d.ts

@@ -9,6 +9,29 @@ export type VoiceDeliverySinkDescriptor = {
     id: string;
     kind: VoiceDeliverySinkKind;
     label: string;
+    mode?: string;
+    target?: string;
+};
+export type VoiceDeliverySinkDescriptorInput = {
+    description?: string;
+    href?: string;
+    id?: string;
+    kind: VoiceDeliverySinkKind;
+    label?: string;
+    mode?: string;
+    target?: string;
+};
+export type VoiceDeliverySinkPairOptions = {
+    auditHref?: string;
+    auditId?: string;
+    auditLabel?: string;
+    description?: string;
+    kind: VoiceDeliverySinkKind;
+    mode?: string;
+    target?: string;
+    traceHref?: string;
+    traceId?: string;
+    traceLabel?: string;
 };
 export type VoiceDeliverySinkReport = {
     auditDeliveries?: VoiceTraceDeliverySinkSurface<VoiceAuditSinkDeliveryQueueSummary>;
@@ -41,6 +64,13 @@ export type VoiceDeliverySinkRoutesOptions = {
         store: VoiceTraceSinkDeliveryStore;
     };
 };
+export declare const createVoiceDeliverySinkDescriptor: (input: VoiceDeliverySinkDescriptorInput) => VoiceDeliverySinkDescriptor;
+export declare const createVoiceFileDeliverySink: (input?: Omit<VoiceDeliverySinkDescriptorInput, "kind">) => VoiceDeliverySinkDescriptor;
+export declare const createVoiceWebhookDeliverySink: (input?: Omit<VoiceDeliverySinkDescriptorInput, "kind">) => VoiceDeliverySinkDescriptor;
+export declare const createVoiceS3DeliverySink: (input?: Omit<VoiceDeliverySinkDescriptorInput, "kind">) => VoiceDeliverySinkDescriptor;
+export declare const createVoicePostgresDeliverySink: (input?: Omit<VoiceDeliverySinkDescriptorInput, "kind">) => VoiceDeliverySinkDescriptor;
+export declare const createVoiceSQLiteDeliverySink: (input?: Omit<VoiceDeliverySinkDescriptorInput, "kind">) => VoiceDeliverySinkDescriptor;
+export declare const createVoiceDeliverySinkPair: (options: VoiceDeliverySinkPairOptions) => VoiceDeliverySinkDescriptor[];
 export declare const buildVoiceDeliverySinkReport: (options: VoiceDeliverySinkRoutesOptions) => Promise<VoiceDeliverySinkReport>;
 export declare const renderVoiceDeliverySinkHTML: (report: VoiceDeliverySinkReport, options?: {
     title?: string;

package/dist/index.d.ts

@@ -6,17 +6,17 @@ export { createVoiceAssistantHealthHTMLHandler, createVoiceAssistantHealthJSONHa
 export { createVoiceAuditEvent, createVoiceAuditLogger, createVoiceMemoryAuditEventStore, filterVoiceAuditEvents, recordVoiceAuditEvent, recordVoiceHandoffAuditEvent, recordVoiceOperatorAuditEvent, recordVoiceProviderAuditEvent, recordVoiceRetentionAuditEvent, recordVoiceToolAuditEvent } from './audit';
 export { buildVoiceAuditTrailReport, createVoiceAuditTrailRoutes, renderVoiceAuditTrailHTML, resolveVoiceAuditTrailFilter, summarizeVoiceAuditTrail } from './auditRoutes';
 export { buildVoiceAuditExport, exportVoiceAuditTrail, redactVoiceAuditEvent, redactVoiceAuditEvents, renderVoiceAuditHTML, renderVoiceAuditMarkdown } from './auditExport';
-export { createVoiceAuditHTTPSink, createVoiceAuditSinkDeliveryId, createVoiceAuditSinkDeliveryRecord, createVoiceAuditSinkDeliveryWorker, createVoiceAuditSinkDeliveryWorkerLoop, createVoiceAuditSinkStore, createVoiceMemoryAuditSinkDeliveryStore, deliverVoiceAuditEventsToSinks, summarizeVoiceAuditSinkDeliveries } from './auditSinks';
+export { createVoiceAuditHTTPSink, createVoiceAuditS3Sink, createVoiceAuditSinkDeliveryId, createVoiceAuditSinkDeliveryRecord, createVoiceAuditSinkDeliveryWorker, createVoiceAuditSinkDeliveryWorkerLoop, createVoiceAuditSinkStore, createVoiceMemoryAuditSinkDeliveryStore, deliverVoiceAuditEventsToSinks, summarizeVoiceAuditSinkDeliveries } from './auditSinks';
 export { buildVoiceAuditDeliveryReport, createVoiceAuditDeliveryHTMLHandler, createVoiceAuditDeliveryJSONHandler, createVoiceAuditDeliveryRoutes, renderVoiceAuditDeliveryHTML, resolveVoiceAuditDeliveryFilter } from './auditDeliveryRoutes';
 export { createVoiceBargeInRoutes, renderVoiceBargeInHTML, summarizeVoiceBargeIn } from './bargeInRoutes';
 export { createVoiceReconnectContractRoutes, renderVoiceReconnectContractHTML, summarizeVoiceReconnectContractSnapshots, runVoiceReconnectContract } from './reconnectContract';
 export { buildVoiceDiagnosticsMarkdown, createVoiceDiagnosticsRoutes, resolveVoiceDiagnosticsTraceFilter } from './diagnosticsRoutes';
 export { buildVoiceDemoReadyReport, createVoiceDemoReadyRoutes, renderVoiceDemoReadyHTML } from './demoReadyRoutes';
-export { buildVoiceDeliverySinkReport, createVoiceDeliverySinkRoutes, renderVoiceDeliverySinkHTML } from './deliverySinkRoutes';
+export { buildVoiceDeliverySinkReport, createVoiceDeliverySinkDescriptor, createVoiceDeliverySinkPair, createVoiceDeliverySinkRoutes, createVoiceFileDeliverySink, createVoicePostgresDeliverySink, createVoiceS3DeliverySink, createVoiceSQLiteDeliverySink, createVoiceWebhookDeliverySink, renderVoiceDeliverySinkHTML } from './deliverySinkRoutes';
 export { applyVoiceDataRetentionPolicy, buildVoiceDataRetentionPlan } from './dataControl';
 export type { VoiceDataRetentionPolicy, VoiceDataRetentionReport, VoiceDataRetentionScope, VoiceDataRetentionScopeReport, VoiceDataRetentionStores } from './dataControl';
 export type { VoiceDemoReadyReport, VoiceDemoReadyRoutesOptions, VoiceDemoReadySection, VoiceDemoReadyStatus } from './demoReadyRoutes';
-export type { VoiceDeliverySinkDescriptor, VoiceDeliverySinkKind, VoiceDeliverySinkReport, VoiceDeliverySinkRoutesOptions, VoiceTraceDeliverySinkSurface } from './deliverySinkRoutes';
+export type { VoiceDeliverySinkDescriptor, VoiceDeliverySinkDescriptorInput, VoiceDeliverySinkKind, VoiceDeliverySinkPairOptions, VoiceDeliverySinkReport, VoiceDeliverySinkRoutesOptions, VoiceTraceDeliverySinkSurface } from './deliverySinkRoutes';
 export { compareVoiceEvalBaseline, createVoiceFileEvalBaselineStore, createVoiceFileScenarioFixtureStore, createVoiceEvalRoutes, renderVoiceEvalBaselineHTML, renderVoiceEvalHTML, renderVoiceScenarioEvalHTML, renderVoiceScenarioFixtureEvalHTML, runVoiceScenarioEvals, runVoiceScenarioFixtureEvals, runVoiceSessionEvals } from './evalRoutes';
 export { createVoiceSimulationSuiteRoutes, renderVoiceSimulationSuiteHTML, runVoiceSimulationSuite } from './simulationSuite';
 export { createVoiceWorkflowContract, createVoiceWorkflowContractHandler, createVoiceWorkflowContractPreset, createVoiceWorkflowScenario, recordVoiceWorkflowContractTrace, validateVoiceWorkflowRouteResult } from './workflowContract';
@@ -47,7 +47,7 @@ export { createVoiceOpsStatusRoutes, renderVoiceOpsStatusHTML } from './opsStatu
 export { createVoiceQualityRoutes, evaluateVoiceQuality, renderVoiceQualityHTML } from './qualityRoutes';
 export { createVoiceResilienceRoutes, createVoiceRoutingDecisionSummary, listVoiceRoutingEvents, renderVoiceResilienceHTML, summarizeVoiceRoutingDecision, summarizeVoiceRoutingSessions } from './resilienceRoutes';
 export { createVoiceSTTProviderRouter, createVoiceTTSProviderRouter } from './providerAdapters';
-export { buildVoiceTraceReplay, createVoiceMemoryTraceSinkDeliveryStore, createVoiceTraceHTTPSink, createVoiceMemoryTraceEventStore, createVoiceTraceSinkDeliveryId, createVoiceTraceSinkDeliveryRecord, createVoiceTraceSinkStore, createVoiceTraceEvent, createVoiceTraceEventId, deliverVoiceTraceEventsToSinks, evaluateVoiceTrace, exportVoiceTrace, filterVoiceTraceEvents, pruneVoiceTraceEvents, redactVoiceTraceEvent, redactVoiceTraceEvents, redactVoiceTraceText, renderVoiceTraceHTML, renderVoiceTraceMarkdown, resolveVoiceTraceRedactionOptions, selectVoiceTraceEventsForPrune, summarizeVoiceTrace } from './trace';
+export { buildVoiceTraceReplay, createVoiceMemoryTraceSinkDeliveryStore, createVoiceTraceHTTPSink, createVoiceTraceS3Sink, createVoiceMemoryTraceEventStore, createVoiceTraceSinkDeliveryId, createVoiceTraceSinkDeliveryRecord, createVoiceTraceSinkStore, createVoiceTraceEvent, createVoiceTraceEventId, deliverVoiceTraceEventsToSinks, evaluateVoiceTrace, exportVoiceTrace, filterVoiceTraceEvents, pruneVoiceTraceEvents, redactVoiceTraceEvent, redactVoiceTraceEvents, redactVoiceTraceText, renderVoiceTraceHTML, renderVoiceTraceMarkdown, resolveVoiceTraceRedactionOptions, selectVoiceTraceEventsForPrune, summarizeVoiceTrace } from './trace';
 export { buildVoiceTraceDeliveryReport, createVoiceTraceDeliveryHTMLHandler, createVoiceTraceDeliveryJSONHandler, createVoiceTraceDeliveryRoutes, renderVoiceTraceDeliveryHTML, resolveVoiceTraceDeliveryFilter } from './traceDeliveryRoutes';
 export { createVoiceTraceTimelineRoutes, renderVoiceTraceTimelineHTML, renderVoiceTraceTimelineSessionHTML, summarizeVoiceTraceTimeline } from './traceTimeline';
 export { createVoiceSQLiteAuditEventStore, createVoiceSQLiteAuditSinkDeliveryStore, createVoiceSQLiteCampaignStore, createVoiceSQLiteExternalObjectMapStore, createVoiceSQLiteIntegrationEventStore, createVoiceSQLiteReviewStore, createVoiceSQLiteRuntimeStorage, createVoiceSQLiteSessionStore, createVoiceSQLiteTaskStore, createVoiceSQLiteTelephonyWebhookIdempotencyStore, createVoiceSQLiteTraceSinkDeliveryStore, createVoiceSQLiteTraceEventStore } from './sqliteStore';
@@ -117,10 +117,10 @@ export type { StoredVoiceCallReviewArtifact, VoiceCallReviewArtifact, VoiceCallR
 export type { StoredVoiceAuditEvent, VoiceAuditActor, VoiceAuditEvent, VoiceAuditEventFilter, VoiceAuditEventStore, VoiceAuditEventType, VoiceAuditLogger, VoiceAuditOutcome, VoiceAuditResource, VoiceHandoffAuditEventInput, VoiceOperatorAuditEventInput, VoiceProviderAuditEventInput, VoiceRetentionAuditEventInput, VoiceToolAuditEventInput } from './audit';
 export type { VoiceAuditTrailOptions, VoiceAuditTrailReport, VoiceAuditTrailRoutesOptions, VoiceAuditTrailSummary } from './auditRoutes';
 export type { VoiceAuditExport } from './auditExport';
-export type { VoiceAuditHTTPSinkOptions, VoiceAuditSink, VoiceAuditSinkDeliveryQueueStatus, VoiceAuditSinkDeliveryQueueSummary, VoiceAuditSinkDeliveryRecord, VoiceAuditSinkDeliveryResult, VoiceAuditSinkDeliveryStatus, VoiceAuditSinkDeliveryStore, VoiceAuditSinkDeliveryWorkerLoop, VoiceAuditSinkDeliveryWorkerLoopOptions, VoiceAuditSinkDeliveryWorkerOptions, VoiceAuditSinkDeliveryWorkerResult, VoiceAuditSinkFanoutResult, VoiceAuditSinkStoreOptions } from './auditSinks';
+export type { VoiceAuditHTTPSinkOptions, VoiceAuditS3SinkOptions, VoiceS3AuditSinkClient, VoiceS3AuditSinkFile, VoiceAuditSink, VoiceAuditSinkDeliveryQueueStatus, VoiceAuditSinkDeliveryQueueSummary, VoiceAuditSinkDeliveryRecord, VoiceAuditSinkDeliveryResult, VoiceAuditSinkDeliveryStatus, VoiceAuditSinkDeliveryStore, VoiceAuditSinkDeliveryWorkerLoop, VoiceAuditSinkDeliveryWorkerLoopOptions, VoiceAuditSinkDeliveryWorkerOptions, VoiceAuditSinkDeliveryWorkerResult, VoiceAuditSinkFanoutResult, VoiceAuditSinkStoreOptions } from './auditSinks';
 export type { VoiceAuditDeliveryDrainReport, VoiceAuditDeliveryDrainWorker, VoiceAuditDeliveryFilter, VoiceAuditDeliveryReport, VoiceAuditDeliveryRoutesOptions } from './auditDeliveryRoutes';
 export type { VoiceFileRuntimeStorage, VoiceFileStoreOptions } from './fileStore';
-export type { StoredVoiceTraceEvent, VoiceTraceEvaluation, VoiceTraceEvaluationOptions, VoiceTraceEvent, VoiceTraceEventFilter, VoiceTraceEventStore, VoiceTraceEventType, VoiceTraceIssue, VoiceTraceIssueSeverity, VoiceTraceHTTPSinkOptions, VoiceTracePruneFilter, VoiceTracePruneOptions, VoiceTracePruneResult, VoiceTraceRedactionConfig, VoiceTraceRedactionOptions, VoiceTraceRedactionReplacement, VoiceResolvedTraceRedactionOptions, VoiceTraceSink, VoiceTraceSinkDeliveryQueueStatus, VoiceTraceSinkDeliveryRecord, VoiceTraceSinkDeliveryResult, VoiceTraceSinkDeliveryStatus, VoiceTraceSinkDeliveryStore, VoiceTraceSinkFanoutResult, VoiceTraceSinkStoreOptions, VoiceTraceSummary } from './trace';
+export type { StoredVoiceTraceEvent, VoiceTraceEvaluation, VoiceTraceEvaluationOptions, VoiceTraceEvent, VoiceTraceEventFilter, VoiceTraceEventStore, VoiceTraceEventType, VoiceTraceIssue, VoiceTraceIssueSeverity, VoiceTraceHTTPSinkOptions, VoiceTraceS3SinkOptions, VoiceTracePruneFilter, VoiceTracePruneOptions, VoiceTracePruneResult, VoiceTraceRedactionConfig, VoiceTraceRedactionOptions, VoiceTraceRedactionReplacement, VoiceResolvedTraceRedactionOptions, VoiceTraceSink, VoiceTraceSinkDeliveryQueueStatus, VoiceTraceSinkDeliveryRecord, VoiceTraceSinkDeliveryResult, VoiceTraceSinkDeliveryStatus, VoiceTraceSinkDeliveryStore, VoiceTraceSinkFanoutResult, VoiceTraceSinkStoreOptions, VoiceTraceSummary, VoiceS3TraceSinkClient, VoiceS3TraceSinkFile } from './trace';
 export type { VoiceTraceDeliveryDrainReport, VoiceTraceDeliveryDrainWorker, VoiceTraceDeliveryFilter, VoiceTraceDeliveryReport, VoiceTraceDeliveryRoutesOptions } from './traceDeliveryRoutes';
 export type { VoiceTraceTimelineEvent, VoiceTraceTimelineProviderSummary, VoiceTraceTimelineReport, VoiceTraceTimelineRoutesOptions, VoiceTraceTimelineSession } from './traceTimeline';
 export type { VoicePostgresClient, VoicePostgresRuntimeStorage, VoicePostgresStoreOptions } from './postgresStore';

package/dist/index.js

@@ -8534,6 +8534,17 @@ var createVoiceTraceSinkDeliveryError = (input) => {
   }
   return `Attempt ${input.attempt} failed: ${String(input.error)}`;
 };
+var normalizeVoiceTraceS3KeyPrefix = (prefix) => prefix?.trim().replace(/^\/+|\/+$/g, "") ?? "voice/trace-deliveries";
+var createVoiceTraceS3ObjectKey = (prefix, events) => {
+  const firstEvent = events[0];
+  const safeSessionId = encodeURIComponent(firstEvent?.sessionId ?? "trace");
+  const safeEventId = encodeURIComponent(firstEvent?.id ?? crypto.randomUUID());
+  return `${prefix}/${safeSessionId}/${Date.now()}-${safeEventId}.json`;
+};
+var resolveVoiceS3DeliveredTo = (options, key) => {
+  const bucket = options.bucket;
+  return bucket ? `s3://${bucket}/${key}` : `s3://${key}`;
+};
 var aggregateVoiceTraceSinkDeliveryStatus = (deliveries) => {
   const statuses = Object.values(deliveries).map((delivery) => delivery.status);
   if (statuses.length === 0 || statuses.every((status) => status === "skipped")) {
@@ -8639,6 +8650,46 @@ var createVoiceTraceHTTPSink = (options) => ({
   id: options.id,
   kind: options.kind ?? "http"
 });
+var createVoiceTraceS3Sink = (options) => {
+  const client = options.client ?? new Bun.S3Client(options);
+  const keyPrefix = normalizeVoiceTraceS3KeyPrefix(options.keyPrefix);
+  return {
+    deliver: async ({ events }) => {
+      const key = createVoiceTraceS3ObjectKey(keyPrefix, events);
+      const payload = options.body ? await options.body({ events, key }) : {
+        eventCount: events.length,
+        events,
+        key,
+        source: "absolutejs-voice"
+      };
+      try {
+        const file = client.file(key, options);
+        await file.write(JSON.stringify(payload), {
+          type: options.contentType ?? "application/json"
+        });
+        return {
+          attempts: 1,
+          deliveredAt: Date.now(),
+          deliveredTo: resolveVoiceS3DeliveredTo(options, key),
+          eventCount: events.length,
+          responseBody: { key },
+          status: "delivered"
+        };
+      } catch (error) {
+        return {
+          attempts: 1,
+          deliveredTo: resolveVoiceS3DeliveredTo(options, key),
+          error: error instanceof Error ? error.message : String(error),
+          eventCount: events.length,
+          status: "failed"
+        };
+      }
+    },
+    eventTypes: options.eventTypes,
+    id: options.id,
+    kind: options.kind ?? "s3"
+  };
+};
 var deliverVoiceTraceEventsToSinks = async (input) => {
   const events = input.redact ? redactVoiceTraceEvents(input.events, input.redact) : input.events;
   const sinkDeliveries = {};
@@ -9431,6 +9482,17 @@ var createVoiceAuditSinkDeliveryError = (input) => {
   }
   return `Attempt ${input.attempt} failed: ${String(input.error)}`;
 };
+var normalizeVoiceAuditS3KeyPrefix = (prefix) => prefix?.trim().replace(/^\/+|\/+$/g, "") ?? "voice/audit-deliveries";
+var createVoiceAuditS3ObjectKey = (prefix, events) => {
+  const firstEvent = events[0];
+  const safeSessionId = encodeURIComponent(firstEvent?.sessionId ?? "audit");
+  const safeEventId = encodeURIComponent(firstEvent?.id ?? crypto.randomUUID());
+  return `${prefix}/${safeSessionId}/${Date.now()}-${safeEventId}.json`;
+};
+var resolveVoiceS3DeliveredTo2 = (options, key) => {
+  const bucket = options.bucket;
+  return bucket ? `s3://${bucket}/${key}` : `s3://${key}`;
+};
 var aggregateVoiceAuditSinkDeliveryStatus = (deliveries) => {
   const statuses = Object.values(deliveries).map((delivery) => delivery.status);
   if (statuses.length === 0 || statuses.every((status) => status === "skipped")) {
@@ -9559,6 +9621,46 @@ var createVoiceAuditHTTPSink = (options) => ({
   id: options.id,
   kind: options.kind ?? "http"
 });
+var createVoiceAuditS3Sink = (options) => {
+  const client = options.client ?? new Bun.S3Client(options);
+  const keyPrefix = normalizeVoiceAuditS3KeyPrefix(options.keyPrefix);
+  return {
+    deliver: async ({ events }) => {
+      const key = createVoiceAuditS3ObjectKey(keyPrefix, events);
+      const payload = options.body ? await options.body({ events, key }) : {
+        eventCount: events.length,
+        events,
+        key,
+        source: "absolutejs-voice"
+      };
+      try {
+        const file = client.file(key, options);
+        await file.write(JSON.stringify(payload), {
+          type: options.contentType ?? "application/json"
+        });
+        return {
+          attempts: 1,
+          deliveredAt: Date.now(),
+          deliveredTo: resolveVoiceS3DeliveredTo2(options, key),
+          eventCount: events.length,
+          responseBody: { key },
+          status: "delivered"
+        };
+      } catch (error) {
+        return {
+          attempts: 1,
+          deliveredTo: resolveVoiceS3DeliveredTo2(options, key),
+          error: error instanceof Error ? error.message : String(error),
+          eventCount: events.length,
+          status: "failed"
+        };
+      }
+    },
+    eventTypes: options.eventTypes,
+    id: options.id,
+    kind: options.kind ?? "s3"
+  };
+};
 var deliverVoiceAuditEventsToSinks = async (input) => {
   const events = input.redact === false ? input.events : redactVoiceAuditEvents(input.events, input.redact ?? true);
   const sinkDeliveries = {};
@@ -11348,6 +11450,56 @@ var rollupDeliverySinkStatus = (report) => {
   ];
   return statuses.includes("fail") ? "fail" : statuses.includes("warn") ? "warn" : "pass";
 };
+var deliverySinkLabel = (kind) => `${String(kind).replaceAll(/[-_]+/g, " ")} sink`;
+var createVoiceDeliverySinkDescriptor = (input) => ({
+  description: input.description,
+  href: input.href,
+  id: input.id ?? `${input.kind}-sink`,
+  kind: input.kind,
+  label: input.label ?? deliverySinkLabel(input.kind),
+  mode: input.mode,
+  target: input.target
+});
+var createVoiceFileDeliverySink = (input = {}) => createVoiceDeliverySinkDescriptor({
+  ...input,
+  kind: "file"
+});
+var createVoiceWebhookDeliverySink = (input = {}) => createVoiceDeliverySinkDescriptor({
+  ...input,
+  kind: "webhook"
+});
+var createVoiceS3DeliverySink = (input = {}) => createVoiceDeliverySinkDescriptor({
+  ...input,
+  kind: "s3"
+});
+var createVoicePostgresDeliverySink = (input = {}) => createVoiceDeliverySinkDescriptor({
+  ...input,
+  kind: "postgres"
+});
+var createVoiceSQLiteDeliverySink = (input = {}) => createVoiceDeliverySinkDescriptor({
+  ...input,
+  kind: "sqlite"
+});
+var createVoiceDeliverySinkPair = (options) => [
+  createVoiceDeliverySinkDescriptor({
+    description: options.description,
+    href: options.auditHref,
+    id: options.auditId ?? `${options.kind}-audit-sink`,
+    kind: options.kind,
+    label: options.auditLabel ?? `${deliverySinkLabel(options.kind)} audit`,
+    mode: options.mode,
+    target: options.target
+  }),
+  createVoiceDeliverySinkDescriptor({
+    description: options.description,
+    href: options.traceHref,
+    id: options.traceId ?? `${options.kind}-trace-sink`,
+    kind: options.kind,
+    label: options.traceLabel ?? `${deliverySinkLabel(options.kind)} trace`,
+    mode: options.mode,
+    target: options.target
+  })
+];
 var buildVoiceDeliverySinkReport = async (options) => {
   const [auditSummary, traceSummary] = await Promise.all([
     options.auditDeliveries ? Promise.resolve(options.auditDeliveries.store.list()).then((deliveries) => summarizeVoiceAuditSinkDeliveries(deliveries)) : undefined,
@@ -11382,11 +11534,14 @@ var renderSurfaceCard = (surface) => {
 };
 var renderVoiceDeliverySinkHTML = (report, options = {}) => {
   const title = options.title ?? "AbsoluteJS Voice Delivery Sinks";
-  const sinks = report.sinks.length ? report.sinks.map((sink) => `<article><span>${escapeHtml14(sink.kind)}</span><strong style="font-size:1.5rem">${escapeHtml14(sink.label)}</strong>${sink.description ? `<p class="muted">${escapeHtml14(sink.description)}</p>` : ""}${sink.href ? `<p><a href="${escapeHtml14(sink.href)}">Open sink</a></p>` : ""}</article>`).join("") : '<article><span>Sink</span><strong style="font-size:1.5rem">Not described</strong><p class="muted">Pass sink descriptors to document your file, webhook, S3, SQLite, or Postgres targets.</p></article>';
+  const sinks = report.sinks.length ? report.sinks.map((sink) => `<article><span>${escapeHtml14(sink.kind)}</span><strong style="font-size:1.5rem">${escapeHtml14(sink.label)}</strong>${sink.description ? `<p class="muted">${escapeHtml14(sink.description)}</p>` : ""}${sink.mode ? `<p class="muted">Mode: ${escapeHtml14(sink.mode)}</p>` : ""}${sink.target ? `<p class="muted">Target: <code>${escapeHtml14(sink.target)}</code></p>` : ""}${sink.href ? `<p><a href="${escapeHtml14(sink.href)}">Open sink</a></p>` : ""}</article>`).join("") : '<article><span>Sink</span><strong style="font-size:1.5rem">Not described</strong><p class="muted">Pass sink descriptors to document your file, webhook, S3, SQLite, or Postgres targets.</p></article>';
   return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml14(title)}</title><style>body{background:#11120d;color:#fbf7e8;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{max-width:1120px;margin:auto;padding:32px}a{color:#fde68a;text-decoration:none}.hero{background:linear-gradient(135deg,rgba(253,230,138,.2),rgba(34,197,94,.14));border:1px solid #3a3420;border-radius:30px;margin-bottom:18px;padding:28px}.eyebrow{color:#fde68a;font-weight:900;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(2.4rem,6vw,4.8rem);line-height:.9;margin:.2rem 0 1rem}.status{border:1px solid #575030;border-radius:999px;display:inline-flex;font-weight:900;padding:8px 12px}.status.pass{border-color:rgba(34,197,94,.65)}.status.warn{border-color:rgba(245,158,11,.65)}.status.fail{border-color:rgba(239,68,68,.75)}.muted{color:#b8b093}.grid{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));margin:18px 0}article,.card{background:#191a13;border:1px solid #33311f;border-radius:22px;padding:18px}article span{color:#b8b093;display:block;font-weight:800}article strong{display:block;font-size:2.4rem;margin-top:8px}pre{background:#0c0d09;border:1px solid #33311f;border-radius:18px;color:#fef3c7;overflow:auto;padding:16px}code{color:#fef3c7}</style></head><body><main><p><a href="/production-readiness">Production readiness</a></p><section class="hero"><p class="eyebrow">Composable sink primitive</p><h1>${escapeHtml14(title)}</h1><p class="muted">Delivery queues prove audit and trace exports without owning your infrastructure. Swap file, webhook, S3, SQLite, or Postgres sinks behind the same readiness surface.</p><p class="status ${escapeHtml14(report.status)}">Overall: ${escapeHtml14(report.status.toUpperCase())}</p><p class="muted">Checked ${escapeHtml14(new Date(report.checkedAt).toLocaleString())}</p></section><section class="grid">${renderSurfaceCard(report.auditDeliveries)}${renderSurfaceCard(report.traceDeliveries)}${sinks}</section><section class="card"><h2>Primitive shape</h2><p class="muted">Mount delivery sink routes beside audit and trace delivery queues. Production readiness can consume the same stores for pass/fail evidence.</p><pre>createVoiceDeliverySinkRoutes({
   auditDeliveries: { store: runtimeStorage.auditDeliveries },
   traceDeliveries: { store: runtimeStorage.traceDeliveries },
-  sinks: [{ id: "audit-file", kind: "file", label: "Audit file sink" }]
+  sinks: createVoiceDeliverySinkPair({
+    kind: "file",
+    target: "file://.voice-runtime/voice-demo"
+  })
 })</pre></section></main></body></html>`;
 };
 var createVoiceDeliverySinkRoutes = (options) => {
@@ -23062,6 +23217,7 @@ export {
   createVoiceWebhookHandoffAdapter,
   createVoiceWebhookDeliveryWorkerLoop,
   createVoiceWebhookDeliveryWorker,
+  createVoiceWebhookDeliverySink,
   createVoiceTwilioRedirectHandoffAdapter,
   createVoiceTwilioCampaignDialer,
   createVoiceTurnQualityRoutes,
@@ -23076,6 +23232,7 @@ export {
   createVoiceTraceSinkDeliveryWorker,
   createVoiceTraceSinkDeliveryRecord,
   createVoiceTraceSinkDeliveryId,
+  createVoiceTraceS3Sink,
   createVoiceTraceHTTPSink,
   createVoiceTraceEventId,
   createVoiceTraceEvent,
@@ -23119,10 +23276,12 @@ export {
   createVoiceSQLiteReviewStore,
   createVoiceSQLiteIntegrationEventStore,
   createVoiceSQLiteExternalObjectMapStore,
+  createVoiceSQLiteDeliverySink,
   createVoiceSQLiteCampaignStore,
   createVoiceSQLiteAuditSinkDeliveryStore,
   createVoiceSQLiteAuditEventStore,
   createVoiceS3ReviewStore,
+  createVoiceS3DeliverySink,
   createVoiceRoutingDecisionSummary,
   createVoiceReviewSavedEvent,
   createVoiceResilienceRoutes,
@@ -23148,6 +23307,7 @@ export {
   createVoicePostgresReviewStore,
   createVoicePostgresIntegrationEventStore,
   createVoicePostgresExternalObjectMapStore,
+  createVoicePostgresDeliverySink,
   createVoicePostgresCampaignStore,
   createVoicePostgresAuditSinkDeliveryStore,
   createVoicePostgresAuditEventStore,
@@ -23204,6 +23364,7 @@ export {
   createVoiceFileIntegrationEventStore,
   createVoiceFileExternalObjectMapStore,
   createVoiceFileEvalBaselineStore,
+  createVoiceFileDeliverySink,
   createVoiceFileCampaignStore,
   createVoiceFileAuditSinkDeliveryStore,
   createVoiceFileAuditEventStore,
@@ -23215,6 +23376,8 @@ export {
   createVoiceDiagnosticsRoutes,
   createVoiceDemoReadyRoutes,
   createVoiceDeliverySinkRoutes,
+  createVoiceDeliverySinkPair,
+  createVoiceDeliverySinkDescriptor,
   createVoiceCampaignWorkerLoop,
   createVoiceCampaignWorker,
   createVoiceCampaignTelephonyOutcomeHandler,
@@ -23232,6 +23395,7 @@ export {
   createVoiceAuditSinkDeliveryWorker,
   createVoiceAuditSinkDeliveryRecord,
   createVoiceAuditSinkDeliveryId,
+  createVoiceAuditS3Sink,
   createVoiceAuditLogger,
   createVoiceAuditHTTPSink,
   createVoiceAuditEvent,

package/dist/trace.d.ts

@@ -1,3 +1,4 @@
+import type { S3Client, S3Options } from 'bun';
 export type VoiceTraceEventType = 'assistant.guardrail' | 'assistant.memory' | 'assistant.run' | 'agent.handoff' | 'agent.model' | 'agent.result' | 'agent.tool' | 'call.handoff' | 'call.lifecycle' | 'client.barge_in' | 'client.live_latency' | 'client.reconnect' | 'session.error' | 'turn.assistant' | 'turn.committed' | 'turn.cost' | 'turn_latency.stage' | 'turn.transcript' | 'workflow.contract';
 export type VoiceTraceEvent<TPayload extends Record<string, unknown> = Record<string, unknown>> = {
     at: number;
@@ -101,6 +102,22 @@ export type VoiceTraceHTTPSinkOptions<TBody extends Record<string, unknown> = Re
     timeoutMs?: number;
     url: string;
 };
+export type VoiceS3TraceSinkFile = {
+    write: (data: string, options?: BlobPropertyBag) => Promise<number> | number;
+};
+export type VoiceS3TraceSinkClient = Pick<S3Client, 'file'>;
+export type VoiceTraceS3SinkOptions<TBody extends Record<string, unknown> = Record<string, unknown>> = S3Options & {
+    body?: (input: {
+        events: StoredVoiceTraceEvent[];
+        key: string;
+    }) => Promise<TBody> | TBody;
+    client?: VoiceS3TraceSinkClient;
+    contentType?: string;
+    eventTypes?: VoiceTraceEventType[];
+    id: string;
+    keyPrefix?: string;
+    kind?: string;
+};
 export type VoiceTraceSinkStoreOptions<TEvent extends StoredVoiceTraceEvent = StoredVoiceTraceEvent> = {
     awaitDelivery?: boolean;
     deliveryQueue?: VoiceTraceSinkDeliveryStore;
@@ -187,6 +204,7 @@ export declare const filterVoiceTraceEvents: <TEvent extends StoredVoiceTraceEve
 export declare const selectVoiceTraceEventsForPrune: <TEvent extends StoredVoiceTraceEvent = StoredVoiceTraceEvent>(events: TEvent[], options?: Omit<VoiceTracePruneOptions, "store">) => TEvent[];
 export declare const pruneVoiceTraceEvents: (options: VoiceTracePruneOptions) => Promise<VoiceTracePruneResult>;
 export declare const createVoiceTraceHTTPSink: <TBody extends Record<string, unknown> = Record<string, unknown>>(options: VoiceTraceHTTPSinkOptions<TBody>) => VoiceTraceSink;
+export declare const createVoiceTraceS3Sink: <TBody extends Record<string, unknown> = Record<string, unknown>>(options: VoiceTraceS3SinkOptions<TBody>) => VoiceTraceSink;
 export declare const deliverVoiceTraceEventsToSinks: (input: {
     events: StoredVoiceTraceEvent[];
     redact?: VoiceTraceRedactionConfig;

package/package.json

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