@absolutejs/voice 0.0.22-beta.145 → 0.0.22-beta.147

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/deliveryRuntime.d.ts

@@ -0,0 +1,35 @@
+import { createVoiceAuditSinkDeliveryWorker, type VoiceAuditSinkDeliveryQueueSummary, type VoiceAuditSinkDeliveryRecord, type VoiceAuditSinkDeliveryWorkerOptions, type VoiceAuditSinkDeliveryWorkerResult } from './auditSinks';
+import { createVoiceTraceSinkDeliveryWorker, type VoiceTraceSinkDeliveryQueueSummary, type VoiceTraceSinkDeliveryWorkerOptions, type VoiceTraceSinkDeliveryWorkerResult } from './queue';
+import type { VoiceTraceSinkDeliveryRecord } from './trace';
+export type VoiceDeliveryRuntimeAuditConfig<TDelivery extends VoiceAuditSinkDeliveryRecord = VoiceAuditSinkDeliveryRecord> = VoiceAuditSinkDeliveryWorkerOptions<TDelivery> & {
+    autoStart?: boolean;
+    onError?: (error: unknown) => Promise<void> | void;
+    pollIntervalMs?: number;
+};
+export type VoiceDeliveryRuntimeTraceConfig<TDelivery extends VoiceTraceSinkDeliveryRecord = VoiceTraceSinkDeliveryRecord> = VoiceTraceSinkDeliveryWorkerOptions<TDelivery> & {
+    autoStart?: boolean;
+    onError?: (error: unknown) => Promise<void> | void;
+    pollIntervalMs?: number;
+};
+export type VoiceDeliveryRuntimeConfig<TAuditDelivery extends VoiceAuditSinkDeliveryRecord = VoiceAuditSinkDeliveryRecord, TTraceDelivery extends VoiceTraceSinkDeliveryRecord = VoiceTraceSinkDeliveryRecord> = {
+    audit?: VoiceDeliveryRuntimeAuditConfig<TAuditDelivery>;
+    trace?: VoiceDeliveryRuntimeTraceConfig<TTraceDelivery>;
+};
+export type VoiceDeliveryRuntimeTickResult = {
+    audit?: VoiceAuditSinkDeliveryWorkerResult;
+    trace?: VoiceTraceSinkDeliveryWorkerResult;
+};
+export type VoiceDeliveryRuntimeSummary = {
+    audit?: VoiceAuditSinkDeliveryQueueSummary;
+    trace?: VoiceTraceSinkDeliveryQueueSummary;
+};
+export type VoiceDeliveryRuntime = {
+    audit?: ReturnType<typeof createVoiceAuditSinkDeliveryWorker>;
+    isRunning: () => boolean;
+    start: () => void;
+    stop: () => void;
+    summarize: () => Promise<VoiceDeliveryRuntimeSummary>;
+    tick: () => Promise<VoiceDeliveryRuntimeTickResult>;
+    trace?: ReturnType<typeof createVoiceTraceSinkDeliveryWorker>;
+};
+export declare const createVoiceDeliveryRuntime: <TAuditDelivery extends VoiceAuditSinkDeliveryRecord = VoiceAuditSinkDeliveryRecord, TTraceDelivery extends VoiceTraceSinkDeliveryRecord = VoiceTraceSinkDeliveryRecord>(config: VoiceDeliveryRuntimeConfig<TAuditDelivery, TTraceDelivery>) => VoiceDeliveryRuntime;

package/dist/index.d.ts

@@ -6,17 +6,19 @@ 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, createVoiceDeliverySinkDescriptor, createVoiceDeliverySinkPair, createVoiceDeliverySinkRoutes, createVoiceFileDeliverySink, createVoicePostgresDeliverySink, createVoiceS3DeliverySink, createVoiceSQLiteDeliverySink, createVoiceWebhookDeliverySink, renderVoiceDeliverySinkHTML } from './deliverySinkRoutes';
+export { createVoiceDeliveryRuntime } from './deliveryRuntime';
 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, VoiceDeliverySinkDescriptorInput, VoiceDeliverySinkKind, VoiceDeliverySinkPairOptions, VoiceDeliverySinkReport, VoiceDeliverySinkRoutesOptions, VoiceTraceDeliverySinkSurface } from './deliverySinkRoutes';
+export type { VoiceDeliveryRuntime, VoiceDeliveryRuntimeAuditConfig, VoiceDeliveryRuntimeConfig, VoiceDeliveryRuntimeSummary, VoiceDeliveryRuntimeTickResult, VoiceDeliveryRuntimeTraceConfig } from './deliveryRuntime';
 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 +49,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 +119,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 = {};
@@ -11462,6 +11564,68 @@ var createVoiceDeliverySinkRoutes = (options) => {
   }
   return routes;
 };
+// src/deliveryRuntime.ts
+var createVoiceDeliveryRuntime = (config) => {
+  const audit = config.audit ? createVoiceAuditSinkDeliveryWorker(config.audit) : undefined;
+  const trace = config.trace ? createVoiceTraceSinkDeliveryWorker(config.trace) : undefined;
+  let auditLoop;
+  let traceLoop;
+  if (audit && config.audit) {
+    auditLoop = createVoiceAuditSinkDeliveryWorkerLoop({
+      onError: config.audit.onError,
+      pollIntervalMs: config.audit.pollIntervalMs,
+      worker: audit
+    });
+  }
+  if (trace && config.trace) {
+    traceLoop = createVoiceTraceSinkDeliveryWorkerLoop({
+      onError: config.trace.onError,
+      pollIntervalMs: config.trace.pollIntervalMs,
+      worker: trace
+    });
+  }
+  return {
+    audit,
+    isRunning: () => Boolean(auditLoop?.isRunning() || traceLoop?.isRunning()),
+    start: () => {
+      if (config.audit?.autoStart) {
+        auditLoop?.start();
+      }
+      if (config.trace?.autoStart) {
+        traceLoop?.start();
+      }
+    },
+    stop: () => {
+      auditLoop?.stop();
+      traceLoop?.stop();
+    },
+    summarize: async () => {
+      const summary = {};
+      if (config.audit) {
+        summary.audit = await summarizeVoiceAuditSinkDeliveries(await config.audit.deliveries.list(), {
+          deadLetters: config.audit.deadLetters
+        });
+      }
+      if (config.trace) {
+        summary.trace = await summarizeVoiceTraceSinkDeliveries(await config.trace.deliveries.list(), {
+          deadLetters: config.trace.deadLetters
+        });
+      }
+      return summary;
+    },
+    tick: async () => {
+      const result = {};
+      if (auditLoop) {
+        result.audit = await auditLoop.tick();
+      }
+      if (traceLoop) {
+        result.trace = await traceLoop.tick();
+      }
+      return result;
+    },
+    trace
+  };
+};
 // src/dataControl.ts
 var allRetentionScopes = [
   "auditDeliveries",
@@ -23130,6 +23294,7 @@ export {
   createVoiceTraceSinkDeliveryWorker,
   createVoiceTraceSinkDeliveryRecord,
   createVoiceTraceSinkDeliveryId,
+  createVoiceTraceS3Sink,
   createVoiceTraceHTTPSink,
   createVoiceTraceEventId,
   createVoiceTraceEvent,
@@ -23275,6 +23440,7 @@ export {
   createVoiceDeliverySinkRoutes,
   createVoiceDeliverySinkPair,
   createVoiceDeliverySinkDescriptor,
+  createVoiceDeliveryRuntime,
   createVoiceCampaignWorkerLoop,
   createVoiceCampaignWorker,
   createVoiceCampaignTelephonyOutcomeHandler,
@@ -23292,6 +23458,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.145",
+	"version": "0.0.22-beta.147",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",