@absolutejs/voice 0.0.22-beta.149 → 0.0.22-beta.150

package/dist/deliveryRuntime.d.ts

@@ -1,7 +1,8 @@
 import { Elysia } from 'elysia';
-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';
+import { createVoiceAuditSinkDeliveryWorker, type VoiceAuditSinkDeliveryQueueSummary, type VoiceAuditSinkDeliveryRecord, type VoiceAuditSinkDeliveryStore, type VoiceAuditSinkDeliveryWorkerOptions, type VoiceAuditSinkDeliveryWorkerResult, type VoiceS3AuditSinkClient } from './auditSinks';
+import { createVoiceTraceSinkDeliveryWorker, type VoiceRedisTaskLeaseCoordinator, type VoiceTraceSinkDeliveryQueueSummary, type VoiceTraceSinkDeliveryWorkerOptions, type VoiceTraceSinkDeliveryWorkerResult } from './queue';
+import { type StoredVoiceTraceEvent, type VoiceS3TraceSinkClient, VoiceTraceSinkDeliveryRecord, VoiceTraceSinkDeliveryStore } from './trace';
+import type { StoredVoiceAuditEvent } from './audit';
 export type VoiceDeliveryRuntimeAuditConfig<TDelivery extends VoiceAuditSinkDeliveryRecord = VoiceAuditSinkDeliveryRecord> = VoiceAuditSinkDeliveryWorkerOptions<TDelivery> & {
     autoStart?: boolean;
     onError?: (error: unknown) => Promise<void> | void;
@@ -48,6 +49,55 @@ export type VoiceDeliveryRuntimeRoutesOptions = {
     tickPath?: false | string;
     title?: string;
 };
+export type VoiceDeliveryRuntimePresetMode = 'file' | 's3' | 'webhook';
+export type VoiceDeliveryRuntimePresetLeaseConfig = VoiceRedisTaskLeaseCoordinator | {
+    audit: VoiceRedisTaskLeaseCoordinator;
+    trace: VoiceRedisTaskLeaseCoordinator;
+};
+export type VoiceDeliveryRuntimePresetBaseOptions = {
+    auditDeliveries: VoiceAuditSinkDeliveryStore;
+    auditSinkId?: string;
+    auditWorkerId?: string;
+    autoStart?: boolean;
+    failures?: {
+        maxFailures?: number;
+    };
+    leases: VoiceDeliveryRuntimePresetLeaseConfig;
+    pollIntervalMs?: number;
+    traceDeliveries: VoiceTraceSinkDeliveryStore;
+    traceSinkId?: string;
+    traceWorkerId?: string;
+};
+export type VoiceDeliveryRuntimeWebhookPresetOptions = VoiceDeliveryRuntimePresetBaseOptions & {
+    backoffMs?: number;
+    body?: {
+        audit?: (input: {
+            events: StoredVoiceAuditEvent[];
+        }) => Promise<Record<string, unknown>> | Record<string, unknown>;
+        trace?: (input: {
+            events: StoredVoiceTraceEvent[];
+        }) => Promise<Record<string, unknown>> | Record<string, unknown>;
+    };
+    fetch?: typeof fetch;
+    headers?: Record<string, string>;
+    mode: 'webhook';
+    retries?: number;
+    signingSecret?: string;
+    timeoutMs?: number;
+    url: string;
+};
+export type VoiceDeliveryRuntimeS3PresetOptions = VoiceDeliveryRuntimePresetBaseOptions & {
+    bucket?: string;
+    client?: VoiceS3AuditSinkClient & VoiceS3TraceSinkClient;
+    keyPrefix?: string;
+    mode: 's3';
+};
+export type VoiceDeliveryRuntimeFilePresetOptions = VoiceDeliveryRuntimePresetBaseOptions & {
+    directory: string;
+    mode: 'file';
+};
+export type VoiceDeliveryRuntimePresetOptions = VoiceDeliveryRuntimeFilePresetOptions | VoiceDeliveryRuntimeS3PresetOptions | VoiceDeliveryRuntimeWebhookPresetOptions;
+export declare const createVoiceDeliveryRuntimePresetConfig: (options: VoiceDeliveryRuntimePresetOptions) => VoiceDeliveryRuntimeConfig;
 export declare const createVoiceDeliveryRuntime: <TAuditDelivery extends VoiceAuditSinkDeliveryRecord = VoiceAuditSinkDeliveryRecord, TTraceDelivery extends VoiceTraceSinkDeliveryRecord = VoiceTraceSinkDeliveryRecord>(config: VoiceDeliveryRuntimeConfig<TAuditDelivery, TTraceDelivery>) => VoiceDeliveryRuntime;
 export declare const buildVoiceDeliveryRuntimeReport: (runtime: VoiceDeliveryRuntime) => Promise<VoiceDeliveryRuntimeReport>;
 export declare const renderVoiceDeliveryRuntimeHTML: (report: VoiceDeliveryRuntimeReport, options?: {

package/dist/index.d.ts

@@ -13,12 +13,12 @@ export { createVoiceReconnectContractRoutes, renderVoiceReconnectContractHTML, s
 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 { buildVoiceDeliveryRuntimeReport, createVoiceDeliveryRuntime, createVoiceDeliveryRuntimeRoutes, renderVoiceDeliveryRuntimeHTML } from './deliveryRuntime';
+export { buildVoiceDeliveryRuntimeReport, createVoiceDeliveryRuntime, createVoiceDeliveryRuntimePresetConfig, createVoiceDeliveryRuntimeRoutes, renderVoiceDeliveryRuntimeHTML } 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, VoiceDeliveryRuntimeReport, VoiceDeliveryRuntimeRoutesOptions, VoiceDeliveryRuntimeSummary, VoiceDeliveryRuntimeTickResult, VoiceDeliveryRuntimeTraceConfig } from './deliveryRuntime';
+export type { VoiceDeliveryRuntime, VoiceDeliveryRuntimeAuditConfig, VoiceDeliveryRuntimeConfig, VoiceDeliveryRuntimeFilePresetOptions, VoiceDeliveryRuntimePresetLeaseConfig, VoiceDeliveryRuntimePresetMode, VoiceDeliveryRuntimePresetOptions, VoiceDeliveryRuntimeReport, VoiceDeliveryRuntimeRoutesOptions, VoiceDeliveryRuntimeS3PresetOptions, VoiceDeliveryRuntimeSummary, VoiceDeliveryRuntimeTickResult, VoiceDeliveryRuntimeTraceConfig, VoiceDeliveryRuntimeWebhookPresetOptions } 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';

package/dist/index.js

@@ -11566,6 +11566,8 @@ var createVoiceDeliverySinkRoutes = (options) => {
 };
 // src/deliveryRuntime.ts
 import { Elysia as Elysia12 } from "elysia";
+import { mkdir } from "fs/promises";
+import { dirname, join } from "path";
 var escapeHtml15 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var renderSummaryCard = (label, summary) => {
   if (!summary) {
@@ -11573,6 +11575,115 @@ var renderSummaryCard = (label, summary) => {
   }
   return `<article><span>${escapeHtml15(label)}</span><strong>${String(summary.delivered)}/${String(summary.total)}</strong><p class="muted">${String(summary.pending)} pending &middot; ${String(summary.failed)} failed &middot; ${String(summary.deadLettered)} dead-lettered</p></article>`;
 };
+var resolvePresetLeases = (leases) => ("claim" in leases) ? {
+  audit: leases,
+  trace: leases
+} : leases;
+var createDeliveryRuntimeFileSink = (input) => ({
+  deliver: async ({ events }) => {
+    const firstEvent = events[0];
+    const fileName = `${Date.now()}-${encodeURIComponent(firstEvent?.id ?? crypto.randomUUID())}.json`;
+    const path = join(input.directory, input.kind, fileName);
+    await mkdir(dirname(path), { recursive: true });
+    await Bun.write(path, JSON.stringify({
+      eventCount: events.length,
+      events,
+      source: "absolutejs-voice"
+    }, null, 2));
+    return {
+      attempts: 1,
+      deliveredAt: Date.now(),
+      deliveredTo: `file://${path}`,
+      eventCount: events.length,
+      responseBody: { path },
+      status: "delivered"
+    };
+  },
+  id: input.id,
+  kind: "file"
+});
+var createPresetSinks = (options) => {
+  const auditSinkId = options.auditSinkId ?? `voice-${options.mode}-audit-sink`;
+  const traceSinkId = options.traceSinkId ?? `voice-${options.mode}-trace-sink`;
+  if (options.mode === "webhook") {
+    return {
+      audit: createVoiceAuditHTTPSink({
+        backoffMs: options.backoffMs,
+        body: options.body?.audit,
+        fetch: options.fetch,
+        headers: options.headers,
+        id: auditSinkId,
+        retries: options.retries,
+        signingSecret: options.signingSecret,
+        timeoutMs: options.timeoutMs,
+        url: options.url
+      }),
+      trace: createVoiceTraceHTTPSink({
+        backoffMs: options.backoffMs,
+        body: options.body?.trace,
+        fetch: options.fetch,
+        headers: options.headers,
+        id: traceSinkId,
+        retries: options.retries,
+        signingSecret: options.signingSecret,
+        timeoutMs: options.timeoutMs,
+        url: options.url
+      })
+    };
+  }
+  if (options.mode === "s3") {
+    return {
+      audit: createVoiceAuditS3Sink({
+        bucket: options.bucket,
+        client: options.client,
+        id: auditSinkId,
+        keyPrefix: `${options.keyPrefix ?? "voice/deliveries"}/audit`
+      }),
+      trace: createVoiceTraceS3Sink({
+        bucket: options.bucket,
+        client: options.client,
+        id: traceSinkId,
+        keyPrefix: `${options.keyPrefix ?? "voice/deliveries"}/trace`
+      })
+    };
+  }
+  return {
+    audit: createDeliveryRuntimeFileSink({
+      directory: options.directory,
+      id: auditSinkId,
+      kind: "audit"
+    }),
+    trace: createDeliveryRuntimeFileSink({
+      directory: options.directory,
+      id: traceSinkId,
+      kind: "trace"
+    })
+  };
+};
+var createVoiceDeliveryRuntimePresetConfig = (options) => {
+  const leases = resolvePresetLeases(options.leases);
+  const sinks = createPresetSinks(options);
+  return {
+    audit: {
+      autoStart: options.autoStart,
+      deliveries: options.auditDeliveries,
+      leases: leases.audit,
+      maxFailures: options.failures?.maxFailures,
+      pollIntervalMs: options.pollIntervalMs,
+      sinks: [sinks.audit],
+      workerId: options.auditWorkerId ?? `voice-${options.mode}-audit-worker`
+    },
+    trace: {
+      autoStart: options.autoStart,
+      deliveries: options.traceDeliveries,
+      leases: leases.trace,
+      maxFailures: options.failures?.maxFailures,
+      pollIntervalMs: options.pollIntervalMs,
+      sinks: [sinks.trace],
+      workerId: options.traceWorkerId ?? `voice-${options.mode}-trace-worker`
+    }
+  };
+};
 var createVoiceDeliveryRuntime = (config) => {
   const audit = config.audit ? createVoiceAuditSinkDeliveryWorker(config.audit) : undefined;
   const trace = config.trace ? createVoiceTraceSinkDeliveryWorker(config.trace) : undefined;
@@ -11882,8 +11993,8 @@ var applyVoiceDataRetentionPolicy = async (options) => {
 var buildVoiceDataRetentionPlan = (options) => applyVoiceDataRetentionPolicy({ ...options, dryRun: true });
 // src/evalRoutes.ts
 import { Elysia as Elysia15 } from "elysia";
-import { mkdir } from "fs/promises";
-import { dirname } from "path";
+import { mkdir as mkdir2 } from "fs/promises";
+import { dirname as dirname2 } from "path";
 
 // src/qualityRoutes.ts
 import { Elysia as Elysia14 } from "elysia";
@@ -12519,7 +12630,7 @@ var createVoiceFileEvalBaselineStore = (filePath) => ({
     return text.trim() ? JSON.parse(text) : undefined;
   },
   set: async (report) => {
-    await mkdir(dirname(filePath), { recursive: true });
+    await mkdir2(dirname2(filePath), { recursive: true });
     await Bun.write(filePath, JSON.stringify(report, null, 2));
   }
 });
@@ -17325,14 +17436,14 @@ var createVoicePhoneAgent = (options) => {
   };
 };
 // src/fileStore.ts
-import { mkdir as mkdir2, readFile, readdir, rename, rm, writeFile } from "fs/promises";
-import { join } from "path";
+import { mkdir as mkdir3, readFile, readdir, rename, rm, writeFile } from "fs/promises";
+import { join as join2 } from "path";
 var listJsonFiles = async (directory) => {
   try {
     const entries = await readdir(directory, {
       withFileTypes: true
     });
-    return entries.filter((entry) => entry.isFile() && entry.name.endsWith(".json")).map((entry) => join(directory, entry.name));
+    return entries.filter((entry) => entry.isFile() && entry.name.endsWith(".json")).map((entry) => join2(directory, entry.name));
   } catch (error) {
     if (error.code === "ENOENT") {
       return [];
@@ -17341,11 +17452,11 @@ var listJsonFiles = async (directory) => {
   }
 };
 var encodeStoreId = (id) => `${encodeURIComponent(id)}.json`;
-var resolveFilePath = (directory, id) => join(directory, encodeStoreId(id));
+var resolveFilePath = (directory, id) => join2(directory, encodeStoreId(id));
 var createMemoryStoreId = (input) => `${input.assistantId}:${input.namespace}:${input.key}`;
 var readJsonFile = async (path) => JSON.parse(await readFile(path, "utf8"));
 var writeJsonFile = async (path, value, options) => {
-  await mkdir2(options.directory, {
+  await mkdir3(options.directory, {
     recursive: true
   });
   const tempPath = `${path}.${crypto.randomUUID()}.tmp`;
@@ -17680,47 +17791,47 @@ var createVoiceFileAssistantMemoryStore = (options) => {
 var createVoiceFileRuntimeStorage = (options) => ({
   audit: createVoiceFileAuditEventStore({
     ...options,
-    directory: join(options.directory, "audit")
+    directory: join2(options.directory, "audit")
   }),
   auditDeliveries: createVoiceFileAuditSinkDeliveryStore({
     ...options,
-    directory: join(options.directory, "audit-deliveries")
+    directory: join2(options.directory, "audit-deliveries")
   }),
   campaigns: createVoiceFileCampaignStore({
     ...options,
-    directory: join(options.directory, "campaigns")
+    directory: join2(options.directory, "campaigns")
   }),
   events: createVoiceFileIntegrationEventStore({
     ...options,
-    directory: join(options.directory, "events")
+    directory: join2(options.directory, "events")
   }),
   externalObjects: createVoiceFileExternalObjectMapStore({
     ...options,
-    directory: join(options.directory, "external-objects")
+    directory: join2(options.directory, "external-objects")
   }),
   memories: createVoiceFileAssistantMemoryStore({
     ...options,
-    directory: join(options.directory, "memories")
+    directory: join2(options.directory, "memories")
   }),
   reviews: createVoiceFileReviewStore({
     ...options,
-    directory: join(options.directory, "reviews")
+    directory: join2(options.directory, "reviews")
   }),
   session: createVoiceFileSessionStore({
     ...options,
-    directory: join(options.directory, "sessions")
+    directory: join2(options.directory, "sessions")
   }),
   tasks: createVoiceFileTaskStore({
     ...options,
-    directory: join(options.directory, "tasks")
+    directory: join2(options.directory, "tasks")
   }),
   traceDeliveries: createVoiceFileTraceSinkDeliveryStore({
     ...options,
-    directory: join(options.directory, "trace-deliveries")
+    directory: join2(options.directory, "trace-deliveries")
   }),
   traces: createVoiceFileTraceEventStore({
     ...options,
-    directory: join(options.directory, "traces")
+    directory: join2(options.directory, "traces")
   })
 });
 var createStoredVoiceCallReviewArtifact = (id, artifact) => withVoiceCallReviewId(id, artifact);
@@ -23566,6 +23677,7 @@ export {
   createVoiceDeliverySinkPair,
   createVoiceDeliverySinkDescriptor,
   createVoiceDeliveryRuntimeRoutes,
+  createVoiceDeliveryRuntimePresetConfig,
   createVoiceDeliveryRuntime,
   createVoiceCampaignWorkerLoop,
   createVoiceCampaignWorker,

package/package.json

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