@absolutejs/voice 0.0.22-beta.145 → 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/index.d.ts

@@ -6,7 +6,7 @@ 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';
@@ -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 = {};
@@ -23130,6 +23232,7 @@ export {
   createVoiceTraceSinkDeliveryWorker,
   createVoiceTraceSinkDeliveryRecord,
   createVoiceTraceSinkDeliveryId,
+  createVoiceTraceS3Sink,
   createVoiceTraceHTTPSink,
   createVoiceTraceEventId,
   createVoiceTraceEvent,
@@ -23292,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.145",
+	"version": "0.0.22-beta.146",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",