@absolutejs/voice 0.0.22-beta.54 → 0.0.22-beta.540

package/dist/core/providerStackRecommendations.d.ts

@@ -0,0 +1,188 @@
+import { Elysia } from "elysia";
+import type { VoiceReadinessProfileName } from "./readinessProfiles";
+export type VoiceProviderStackKind = "llm" | "stt" | "tts";
+export type VoiceProviderStackInput<TProvider extends string = string> = {
+    profile: VoiceReadinessProfileName;
+    providers: Partial<Record<VoiceProviderStackKind, readonly TProvider[]>>;
+};
+export type VoiceProviderStackChoice<TProvider extends string = string> = {
+    alternatives: TProvider[];
+    provider?: TProvider;
+    reasons: string[];
+};
+export type VoiceProviderStackRecommendation<TProvider extends string = string> = {
+    profile: VoiceReadinessProfileName;
+    reasons: string[];
+    recommended: Partial<Record<VoiceProviderStackKind, TProvider>>;
+    stacks: Partial<Record<VoiceProviderStackKind, VoiceProviderStackChoice<TProvider>>>;
+};
+export type VoiceProviderStackCapabilities<TProvider extends string = string> = Partial<Record<VoiceProviderStackKind, Partial<Record<TProvider, readonly string[]>>>>;
+export type VoiceProviderStackCapabilityGap<TProvider extends string = string> = {
+    kind: VoiceProviderStackKind;
+    missing: string[];
+    present: string[];
+    provider?: TProvider;
+    required: string[];
+    status: "fail" | "pass" | "warn";
+};
+export type VoiceProviderStackCapabilityGapReport<TProvider extends string = string> = {
+    gaps: VoiceProviderStackCapabilityGap<TProvider>[];
+    missing: number;
+    profile: VoiceReadinessProfileName;
+    status: "fail" | "pass" | "warn";
+};
+export type VoiceProviderStackAssertionInput<TProvider extends string = string> = {
+    maxMissing?: number;
+    maxStatus?: VoiceProviderContractCheckStatus;
+    requireProviders?: boolean;
+    requiredKinds?: VoiceProviderStackKind[];
+    requiredProviders?: TProvider[];
+    requiredCapabilities?: Partial<Record<VoiceProviderStackKind, readonly string[]>>;
+};
+export type VoiceProviderStackAssertionReport<TProvider extends string = string> = {
+    issues: string[];
+    kinds: VoiceProviderStackKind[];
+    missing: number;
+    ok: boolean;
+    providers: TProvider[];
+    status: VoiceProviderContractCheckStatus;
+};
+export type VoiceProviderStackCapabilityGapInput<TProvider extends string = string> = VoiceProviderStackInput<TProvider> & {
+    capabilities?: VoiceProviderStackCapabilities<TProvider>;
+    recommendation?: VoiceProviderStackRecommendation<TProvider>;
+    required?: Partial<Record<VoiceProviderStackKind, readonly string[]>>;
+};
+export type VoiceProviderContractCheckStatus = "fail" | "pass" | "warn";
+type VoiceProviderContractRemediation = {
+    code: string;
+    detail: string;
+    href?: string;
+    label: string;
+};
+export type VoiceProviderContractCheck = {
+    detail?: string;
+    key: string;
+    label: string;
+    remediation?: VoiceProviderContractRemediation;
+    status: VoiceProviderContractCheckStatus;
+};
+export type VoiceProviderContractDefinition<TProvider extends string = string> = {
+    capabilities?: readonly string[];
+    configured?: boolean;
+    env?: Record<string, string | undefined>;
+    fallbackProviders?: readonly TProvider[];
+    kind: VoiceProviderStackKind;
+    latencyBudgetMs?: number;
+    provider: TProvider;
+    requiredCapabilities?: readonly string[];
+    requiredEnv?: readonly string[];
+    remediationHref?: string;
+    selected?: boolean;
+    streaming?: boolean;
+};
+export type VoiceProviderContractMatrixInput<TProvider extends string = string> = {
+    contracts: readonly VoiceProviderContractDefinition<TProvider>[];
+};
+export type VoiceProviderContractMatrixPresetOptions<TProvider extends string = string> = {
+    capabilities?: VoiceProviderStackCapabilities<TProvider>;
+    configured?: Partial<Record<TProvider, boolean>>;
+    env?: Record<string, string | undefined>;
+    fallbackProviders?: Partial<Record<VoiceProviderStackKind, readonly TProvider[]>>;
+    latencyBudgets?: Partial<Record<TProvider, number>>;
+    providers: Partial<Record<VoiceProviderStackKind, readonly TProvider[]>>;
+    remediationHref?: string;
+    selected?: Partial<Record<VoiceProviderStackKind, TProvider>>;
+    streaming?: Partial<Record<TProvider, boolean>>;
+};
+export type VoiceProviderContractMatrixHandlerOptions<TProvider extends string = string> = VoiceProviderContractMatrixInput<TProvider> | (() => Promise<VoiceProviderContractMatrixInput<TProvider>> | VoiceProviderContractMatrixInput<TProvider>);
+export type VoiceProviderContractMatrixHTMLHandlerOptions<TProvider extends string = string> = {
+    matrix: VoiceProviderContractMatrixHandlerOptions<TProvider>;
+    render?: (report: VoiceProviderContractMatrixReport<TProvider>) => string | Promise<string>;
+    title?: string;
+};
+export type VoiceProviderContractMatrixRoutesOptions<TProvider extends string = string> = VoiceProviderContractMatrixHTMLHandlerOptions<TProvider> & {
+    headers?: HeadersInit;
+    htmlPath?: false | string;
+    name?: string;
+    path?: string;
+};
+export type VoiceProviderContractMatrixRow<TProvider extends string = string> = {
+    checks: VoiceProviderContractCheck[];
+    configured: boolean;
+    kind: VoiceProviderStackKind;
+    provider: TProvider;
+    selected: boolean;
+    status: VoiceProviderContractCheckStatus;
+};
+export type VoiceProviderContractMatrixReport<TProvider extends string = string> = {
+    failed: number;
+    passed: number;
+    rows: VoiceProviderContractMatrixRow<TProvider>[];
+    status: VoiceProviderContractCheckStatus;
+    total: number;
+    warned: number;
+};
+export type VoiceProviderContractMatrixAssertionInput<TProvider extends string = string> = {
+    maxFailed?: number;
+    maxStatus?: VoiceProviderContractCheckStatus;
+    maxWarned?: number;
+    minRows?: number;
+    requireAllSelected?: boolean;
+    requiredCheckKeys?: string[];
+    requiredKinds?: VoiceProviderStackKind[];
+    requiredProviders?: TProvider[];
+    selectedKinds?: VoiceProviderStackKind[];
+};
+export type VoiceProviderContractMatrixAssertionReport<TProvider extends string = string> = {
+    failed: number;
+    issues: string[];
+    kinds: VoiceProviderStackKind[];
+    ok: boolean;
+    providers: TProvider[];
+    selectedKinds: VoiceProviderStackKind[];
+    status: VoiceProviderContractCheckStatus;
+    total: number;
+    warned: number;
+};
+export declare const recommendVoiceProviderStack: <TProvider extends string = string>(input: VoiceProviderStackInput<TProvider>) => VoiceProviderStackRecommendation<TProvider>;
+export declare const assertVoiceProviderContractMatrixEvidence: <TProvider extends string = string>(report: VoiceProviderContractMatrixReport<TProvider>, input?: VoiceProviderContractMatrixAssertionInput<TProvider>) => VoiceProviderContractMatrixAssertionReport<TProvider>;
+export declare const buildVoiceProviderContractMatrix: <TProvider extends string = string>(input: VoiceProviderContractMatrixInput<TProvider>) => VoiceProviderContractMatrixReport<TProvider>;
+export declare const createVoiceProviderContractMatrixPreset: <TProvider extends string = string>(profile: VoiceReadinessProfileName, options: VoiceProviderContractMatrixPresetOptions<TProvider>) => VoiceProviderContractMatrixInput<TProvider>;
+export declare const evaluateVoiceProviderContractMatrixEvidence: <TProvider extends string = string>(report: VoiceProviderContractMatrixReport<TProvider>, input?: VoiceProviderContractMatrixAssertionInput<TProvider>) => VoiceProviderContractMatrixAssertionReport<TProvider>;
+export declare const createVoiceProviderContractMatrixHTMLHandler: <TProvider extends string = string>(options: VoiceProviderContractMatrixHTMLHandlerOptions<TProvider>) => () => Promise<Response>;
+export declare const createVoiceProviderContractMatrixJSONHandler: <TProvider extends string = string>(matrix: VoiceProviderContractMatrixHandlerOptions<TProvider>) => () => Promise<VoiceProviderContractMatrixReport<TProvider>>;
+export declare const createVoiceProviderContractMatrixRoutes: <TProvider extends string = string>(options: VoiceProviderContractMatrixRoutesOptions<TProvider>) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;
+export declare const renderVoiceProviderContractMatrixHTML: <TProvider extends string = string>(report: VoiceProviderContractMatrixReport<TProvider>, options?: {
+    title?: string;
+}) => string;
+export declare const assertVoiceProviderStackEvidence: <TProvider extends string = string>(report: VoiceProviderStackCapabilityGapReport<TProvider>, input?: VoiceProviderStackAssertionInput<TProvider>) => VoiceProviderStackAssertionReport<TProvider>;
+export declare const evaluateVoiceProviderStackEvidence: <TProvider extends string = string>(report: VoiceProviderStackCapabilityGapReport<TProvider>, input?: VoiceProviderStackAssertionInput<TProvider>) => VoiceProviderStackAssertionReport<TProvider>;
+export declare const evaluateVoiceProviderStackGaps: <TProvider extends string = string>(input: VoiceProviderStackCapabilityGapInput<TProvider>) => VoiceProviderStackCapabilityGapReport<TProvider>;
+export {};

package/dist/core/qualityDriftDetector.d.ts

@@ -0,0 +1,44 @@
+import type { VoiceScorecard } from "./callScorecard";
+export type VoiceQualityDriftSeverity = "ok" | "watch" | "regression";
+export type VoiceQualityDriftCriterionAlert = {
+    criterionId: string;
+    baselineAverage: number;
+    currentAverage: number;
+    delta: number;
+    severity: VoiceQualityDriftSeverity;
+};
+export type VoiceQualityDriftReport = {
+    rubricId: string;
+    scope: {
+        from: number;
+        to: number;
+    };
+    baselineWindow: {
+        from: number;
+        to: number;
+        sampleSize: number;
+    };
+    currentWindow: {
+        from: number;
+        to: number;
+        sampleSize: number;
+    };
+    overall: {
+        baselineAverage: number;
+        currentAverage: number;
+        delta: number;
+        severity: VoiceQualityDriftSeverity;
+    };
+    criteria: VoiceQualityDriftCriterionAlert[];
+    alertCount: number;
+};
+export type DetectVoiceQualityDriftInput = {
+    rubricId: string;
+    scorecards: VoiceScorecard[];
+    baselineWindowMs?: number;
+    currentWindowMs?: number;
+    now?: () => number;
+    watchThreshold?: number;
+    regressionThreshold?: number;
+};
+export declare const detectVoiceQualityDrift: (input: DetectVoiceQualityDriftInput) => VoiceQualityDriftReport;

package/dist/{qualityRoutes.d.ts → core/qualityRoutes.d.ts}

@@ -1,6 +1,6 @@
-import { Elysia } from 'elysia';
-import { type StoredVoiceTraceEvent, type VoiceTraceEventStore } from './trace';
-export type VoiceQualityStatus = 'pass' | 'fail';
+import { Elysia } from "elysia";
+import { type StoredVoiceTraceEvent, type VoiceTraceEventStore } from "./trace";
+export type VoiceQualityStatus = "pass" | "fail";
 export type VoiceQualityThresholds = {
     maxDuplicateTurnRate?: number;
     maxEmptyTurnRate?: number;
@@ -16,7 +16,7 @@ export type VoiceQualityMetric = {
     label: string;
     pass: boolean;
     threshold: number;
-    unit: 'count' | 'ms' | 'rate';
+    unit: "count" | "ms" | "rate";
 };
 export type VoiceQualityReport = {
     checkedAt: number;
@@ -43,9 +43,6 @@ export declare const evaluateVoiceQuality: (input: {
     store?: VoiceTraceEventStore;
     thresholds?: VoiceQualityThresholds;
 }) => Promise<VoiceQualityReport>;
-export declare const renderVoiceQualityHTML: (report: VoiceQualityReport, options?: {
-    links?: VoiceQualityLink[];
-}) => string;
 export declare const createVoiceQualityRoutes: (options: VoiceQualityRoutesOptions) => Elysia<"", {
     decorator: {};
     store: {};
@@ -74,3 +71,6 @@ export declare const createVoiceQualityRoutes: (options: VoiceQualityRoutesOptio
     standaloneSchema: {};
     response: {};
 }>;
+export declare const renderVoiceQualityHTML: (report: VoiceQualityReport, options?: {
+    links?: VoiceQualityLink[];
+}) => string;

package/dist/{queue.d.ts → core/queue.d.ts}

@@ -1,14 +1,15 @@
-import type { RedisClient } from 'bun';
-import type { VoiceIntegrationSink } from './opsSinks';
-import type { VoiceTraceRedactionConfig, VoiceTraceSink, VoiceTraceSinkDeliveryRecord, VoiceTraceSinkDeliveryStore, VoiceTraceSinkDeliveryQueueStatus } from './trace';
-import type { StoredVoiceHandoffDelivery, VoiceHandoffAdapter, VoiceHandoffDeliveryQueueStatus, VoiceHandoffDeliveryStore, VoiceSessionHandle, VoiceSessionRecord } from './types';
-import type { VoiceOpsTaskPriority, StoredVoiceOpsTask, StoredVoiceIntegrationEvent, VoiceIntegrationDeliveryStatus, VoiceIntegrationEventStore, VoiceIntegrationWebhookConfig, VoiceOpsTaskKind, VoiceOpsTaskStatus, VoiceOpsTaskStore } from './ops';
+import type { RedisClient } from "bun";
+import type { VoiceIntegrationSink } from "./opsSinks";
+import type { VoiceTraceRedactionConfig, VoiceTraceSink, VoiceTraceSinkDeliveryRecord, VoiceTraceSinkDeliveryStore, VoiceTraceSinkDeliveryQueueStatus } from "./trace";
+import type { VoiceTelephonyWebhookIdempotencyStore } from "./telephonyOutcome";
+import type { StoredVoiceHandoffDelivery, VoiceHandoffAdapter, VoiceHandoffDeliveryQueueStatus, VoiceHandoffDeliveryStore, VoiceSessionHandle, VoiceSessionRecord } from "./types";
+import type { VoiceOpsTaskPriority, StoredVoiceOpsTask, StoredVoiceIntegrationEvent, VoiceIntegrationDeliveryStatus, VoiceIntegrationEventStore, VoiceIntegrationWebhookConfig, VoiceOpsTaskKind, VoiceOpsTaskStatus, VoiceOpsTaskStore } from "./ops";
 export type VoiceOpsTaskLease = {
     expiresAt: number;
     taskId: string;
     workerId: string;
 };
-export type VoiceRedisTaskLeaseClient = Pick<RedisClient, 'get' | 'send' | 'set'>;
+export type VoiceRedisTaskLeaseClient = Pick<RedisClient, "get" | "send" | "set">;
 export type VoiceRedisTaskLeaseCoordinatorOptions = {
     client?: VoiceRedisTaskLeaseClient;
     keyPrefix?: string;
@@ -38,13 +39,20 @@ export type VoiceIdempotencyStore = {
         ttlSeconds?: number;
     }) => Promise<void> | void;
 };
-export type VoiceRedisIdempotencyClient = Pick<RedisClient, 'del' | 'exists' | 'set'>;
+export type VoiceRedisIdempotencyClient = Pick<RedisClient, "del" | "exists" | "set">;
 export type VoiceRedisIdempotencyStoreOptions = {
     client?: VoiceRedisIdempotencyClient;
     keyPrefix?: string;
     ttlSeconds?: number;
     url?: string;
 };
+export type VoiceRedisTelephonyWebhookIdempotencyClient = Pick<RedisClient, "get" | "set">;
+export type VoiceRedisTelephonyWebhookIdempotencyStoreOptions = {
+    client?: VoiceRedisTelephonyWebhookIdempotencyClient;
+    keyPrefix?: string;
+    ttlSeconds?: number;
+    url?: string;
+};
 export type VoiceWebhookDeliveryWorkerOptions<TEvent extends StoredVoiceIntegrationEvent = StoredVoiceIntegrationEvent> = {
     deadLetters?: VoiceIntegrationEventStore<TEvent>;
     events: VoiceIntegrationEventStore<TEvent>;
@@ -67,7 +75,7 @@ export type VoiceWebhookDeliveryWorkerResult = {
     skipped: number;
 };
 export type VoiceIntegrationEventQueueSummary = {
-    byType: Array<[StoredVoiceIntegrationEvent['type'], number]>;
+    byType: Array<[StoredVoiceIntegrationEvent["type"], number]>;
     deadLettered: number;
     delivered: number;
     failed: number;
@@ -165,7 +173,7 @@ export type VoiceHandoffDeliveryWorkerOptions<TContext = unknown, TSession exten
     api: VoiceSessionHandle<TContext, TSession, TResult>;
     deadLetters?: VoiceHandoffDeliveryStore<TDelivery>;
     deliveries: VoiceHandoffDeliveryStore<TDelivery>;
-    failMode?: 'record' | 'throw';
+    failMode?: "record" | "throw";
     idempotency?: VoiceIdempotencyStore;
     idempotencyTtlSeconds?: number;
     leaseMs?: number;
@@ -195,7 +203,7 @@ export type VoiceHandoffDeliveryWorkerLoop = {
     tick: () => Promise<VoiceHandoffDeliveryWorkerResult>;
 };
 export type VoiceHandoffDeliveryQueueSummary = {
-    byAction: Array<[StoredVoiceHandoffDelivery['action'], number]>;
+    byAction: Array<[StoredVoiceHandoffDelivery["action"], number]>;
     deadLettered: number;
     delivered: number;
     failed: number;
@@ -262,11 +270,11 @@ export type VoiceOpsTaskProcessorWorkerOptions<TTask extends StoredVoiceOpsTask
     maxFailures?: number;
     onDeadLetter?: (task: TTask) => Promise<void> | void;
     onError?: (error: unknown, task: TTask) => Promise<void> | void;
-    process: (task: TTask) => Promise<void | 'complete' | 'requeue' | {
-        action?: 'complete' | 'requeue';
+    process: (task: TTask) => Promise<void | "complete" | "requeue" | {
+        action?: "complete" | "requeue";
         detail?: string;
-    }> | void | 'complete' | 'requeue' | {
-        action?: 'complete' | 'requeue';
+    }> | void | "complete" | "requeue" | {
+        action?: "complete" | "requeue";
         detail?: string;
     };
     tasks: VoiceOpsTaskStore<TTask>;
@@ -291,38 +299,39 @@ export type VoiceOpsTaskProcessorWorkerLoop = {
     stop: () => void;
     tick: () => Promise<VoiceOpsTaskProcessorWorkerResult>;
 };
-export declare const summarizeVoiceIntegrationEvents: <TEvent extends StoredVoiceIntegrationEvent = StoredVoiceIntegrationEvent>(events: TEvent[], input?: {
-    deadLetters?: VoiceIntegrationEventStore<TEvent>;
-}) => Promise<VoiceIntegrationEventQueueSummary> | VoiceIntegrationEventQueueSummary;
-export declare const summarizeVoiceTraceSinkDeliveries: <TDelivery extends VoiceTraceSinkDeliveryRecord = VoiceTraceSinkDeliveryRecord>(deliveries: TDelivery[], input?: {
-    deadLetters?: VoiceTraceSinkDeliveryStore<TDelivery>;
-}) => Promise<VoiceTraceSinkDeliveryQueueSummary> | VoiceTraceSinkDeliveryQueueSummary;
-export declare const summarizeVoiceHandoffDeliveries: <TDelivery extends StoredVoiceHandoffDelivery = StoredVoiceHandoffDelivery>(deliveries: TDelivery[], input?: {
-    deadLetters?: VoiceHandoffDeliveryStore<TDelivery>;
-}) => Promise<VoiceHandoffDeliveryQueueSummary> | VoiceHandoffDeliveryQueueSummary;
-export declare const summarizeVoiceOpsTaskQueue: <TTask extends StoredVoiceOpsTask = StoredVoiceOpsTask>(tasks: TTask[], input?: {
-    deadLetters?: VoiceOpsTaskStore<TTask>;
-}) => Promise<VoiceOpsTaskQueueSummary> | VoiceOpsTaskQueueSummary;
-export declare const createVoiceRedisTaskLeaseCoordinator: (options?: VoiceRedisTaskLeaseCoordinatorOptions) => VoiceRedisTaskLeaseCoordinator;
-export declare const createVoiceRedisIdempotencyStore: (options?: VoiceRedisIdempotencyStoreOptions) => VoiceIdempotencyStore;
-export declare const createVoiceWebhookDeliveryWorker: <TEvent extends StoredVoiceIntegrationEvent = StoredVoiceIntegrationEvent>(options: VoiceWebhookDeliveryWorkerOptions<TEvent>) => {
-    drain: () => Promise<VoiceWebhookDeliveryWorkerResult>;
+export declare const createVoiceHandoffDeliveryWorker: <TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown, TDelivery extends StoredVoiceHandoffDelivery<TContext, TSession, TResult> = StoredVoiceHandoffDelivery<TContext, TSession, TResult>>(options: VoiceHandoffDeliveryWorkerOptions<TContext, TSession, TResult, TDelivery>) => {
+    drain: () => Promise<VoiceHandoffDeliveryWorkerResult>;
 };
-export declare const createVoiceWebhookDeliveryWorkerLoop: <TEvent extends StoredVoiceIntegrationEvent = StoredVoiceIntegrationEvent>(options: VoiceWebhookDeliveryWorkerLoopOptions<TEvent>) => VoiceWebhookDeliveryWorkerLoop;
+export declare const createVoiceHandoffDeliveryWorkerLoop: <TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown, TDelivery extends StoredVoiceHandoffDelivery<TContext, TSession, TResult> = StoredVoiceHandoffDelivery<TContext, TSession, TResult>>(options: VoiceHandoffDeliveryWorkerLoopOptions<TContext, TSession, TResult, TDelivery>) => VoiceHandoffDeliveryWorkerLoop;
 export declare const createVoiceIntegrationSinkWorker: <TEvent extends StoredVoiceIntegrationEvent = StoredVoiceIntegrationEvent>(options: VoiceIntegrationSinkWorkerOptions<TEvent>) => {
     drain: () => Promise<VoiceIntegrationSinkWorkerResult>;
 };
 export declare const createVoiceIntegrationSinkWorkerLoop: <TEvent extends StoredVoiceIntegrationEvent = StoredVoiceIntegrationEvent>(options: VoiceIntegrationSinkWorkerLoopOptions<TEvent>) => VoiceIntegrationSinkWorkerLoop;
+export declare const createVoiceOpsTaskProcessorWorker: <TTask extends StoredVoiceOpsTask = StoredVoiceOpsTask>(options: VoiceOpsTaskProcessorWorkerOptions<TTask>) => {
+    drain: () => Promise<VoiceOpsTaskProcessorWorkerResult>;
+};
+export declare const createVoiceOpsTaskProcessorWorkerLoop: <TTask extends StoredVoiceOpsTask = StoredVoiceOpsTask>(options: VoiceOpsTaskProcessorWorkerLoopOptions<TTask>) => VoiceOpsTaskProcessorWorkerLoop;
+export declare const createVoiceOpsTaskWorker: <TTask extends StoredVoiceOpsTask = StoredVoiceOpsTask>(options: VoiceOpsTaskWorkerOptions<TTask>) => VoiceOpsTaskWorker<TTask>;
+export declare const createVoiceRedisIdempotencyStore: (options?: VoiceRedisIdempotencyStoreOptions) => VoiceIdempotencyStore;
+export declare const createVoiceRedisTaskLeaseCoordinator: (options?: VoiceRedisTaskLeaseCoordinatorOptions) => VoiceRedisTaskLeaseCoordinator;
+export declare const createVoiceRedisTelephonyWebhookIdempotencyStore: <TResult = unknown>(options?: VoiceRedisTelephonyWebhookIdempotencyStoreOptions) => VoiceTelephonyWebhookIdempotencyStore<TResult>;
 export declare const createVoiceTraceSinkDeliveryWorker: <TDelivery extends VoiceTraceSinkDeliveryRecord = VoiceTraceSinkDeliveryRecord>(options: VoiceTraceSinkDeliveryWorkerOptions<TDelivery>) => {
     drain: () => Promise<VoiceTraceSinkDeliveryWorkerResult>;
 };
 export declare const createVoiceTraceSinkDeliveryWorkerLoop: <TDelivery extends VoiceTraceSinkDeliveryRecord = VoiceTraceSinkDeliveryRecord>(options: VoiceTraceSinkDeliveryWorkerLoopOptions<TDelivery>) => VoiceTraceSinkDeliveryWorkerLoop;
-export declare const createVoiceHandoffDeliveryWorker: <TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown, TDelivery extends StoredVoiceHandoffDelivery<TContext, TSession, TResult> = StoredVoiceHandoffDelivery<TContext, TSession, TResult>>(options: VoiceHandoffDeliveryWorkerOptions<TContext, TSession, TResult, TDelivery>) => {
-    drain: () => Promise<VoiceHandoffDeliveryWorkerResult>;
-};
-export declare const createVoiceHandoffDeliveryWorkerLoop: <TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown, TDelivery extends StoredVoiceHandoffDelivery<TContext, TSession, TResult> = StoredVoiceHandoffDelivery<TContext, TSession, TResult>>(options: VoiceHandoffDeliveryWorkerLoopOptions<TContext, TSession, TResult, TDelivery>) => VoiceHandoffDeliveryWorkerLoop;
-export declare const createVoiceOpsTaskWorker: <TTask extends StoredVoiceOpsTask = StoredVoiceOpsTask>(options: VoiceOpsTaskWorkerOptions<TTask>) => VoiceOpsTaskWorker<TTask>;
-export declare const createVoiceOpsTaskProcessorWorker: <TTask extends StoredVoiceOpsTask = StoredVoiceOpsTask>(options: VoiceOpsTaskProcessorWorkerOptions<TTask>) => {
-    drain: () => Promise<VoiceOpsTaskProcessorWorkerResult>;
+export declare const createVoiceWebhookDeliveryWorker: <TEvent extends StoredVoiceIntegrationEvent = StoredVoiceIntegrationEvent>(options: VoiceWebhookDeliveryWorkerOptions<TEvent>) => {
+    drain: () => Promise<VoiceWebhookDeliveryWorkerResult>;
 };
-export declare const createVoiceOpsTaskProcessorWorkerLoop: <TTask extends StoredVoiceOpsTask = StoredVoiceOpsTask>(options: VoiceOpsTaskProcessorWorkerLoopOptions<TTask>) => VoiceOpsTaskProcessorWorkerLoop;
+export declare const createVoiceWebhookDeliveryWorkerLoop: <TEvent extends StoredVoiceIntegrationEvent = StoredVoiceIntegrationEvent>(options: VoiceWebhookDeliveryWorkerLoopOptions<TEvent>) => VoiceWebhookDeliveryWorkerLoop;
+export declare const summarizeVoiceHandoffDeliveries: <TDelivery extends StoredVoiceHandoffDelivery = StoredVoiceHandoffDelivery>(deliveries: TDelivery[], input?: {
+    deadLetters?: VoiceHandoffDeliveryStore<TDelivery>;
+}) => Promise<VoiceHandoffDeliveryQueueSummary> | VoiceHandoffDeliveryQueueSummary;
+export declare const summarizeVoiceIntegrationEvents: <TEvent extends StoredVoiceIntegrationEvent = StoredVoiceIntegrationEvent>(events: TEvent[], input?: {
+    deadLetters?: VoiceIntegrationEventStore<TEvent>;
+}) => Promise<VoiceIntegrationEventQueueSummary> | VoiceIntegrationEventQueueSummary;
+export declare const summarizeVoiceOpsTaskQueue: <TTask extends StoredVoiceOpsTask = StoredVoiceOpsTask>(tasks: TTask[], input?: {
+    deadLetters?: VoiceOpsTaskStore<TTask>;
+}) => Promise<VoiceOpsTaskQueueSummary> | VoiceOpsTaskQueueSummary;
+export declare const summarizeVoiceTraceSinkDeliveries: <TDelivery extends VoiceTraceSinkDeliveryRecord = VoiceTraceSinkDeliveryRecord>(deliveries: TDelivery[], input?: {
+    deadLetters?: VoiceTraceSinkDeliveryStore<TDelivery>;
+}) => Promise<VoiceTraceSinkDeliveryQueueSummary> | VoiceTraceSinkDeliveryQueueSummary;

package/dist/core/ragTool.d.ts

@@ -0,0 +1,52 @@
+import { type VoiceAgentTool } from "./agent";
+import type { VoiceSessionRecord, VoiceTurnCitation } from "./types";
+export type VoiceRAGQueryResult = {
+    chunkId: string;
+    chunkText: string;
+    score: number;
+    source?: string;
+    title?: string;
+    metadata?: Record<string, unknown>;
+};
+export type VoiceRAGSearchInput = {
+    filter?: Record<string, unknown>;
+    query: string;
+    scoreThreshold?: number;
+    signal?: AbortSignal;
+    topK?: number;
+};
+export type VoiceRAGCollectionLike = {
+    search: (input: VoiceRAGSearchInput) => Promise<readonly VoiceRAGQueryResult[]> | readonly VoiceRAGQueryResult[];
+};
+export type VoiceRAGToolArgs = {
+    filter?: Record<string, unknown>;
+    query: string;
+    topK?: number;
+};
+export type VoiceRAGToolResult = {
+    citations: VoiceRAGQueryResult[];
+    message: string;
+    query: string;
+    topK: number;
+};
+export type VoiceRAGCitationSummary = VoiceTurnCitation;
+export declare const extractVoiceRAGCitations: (toolResults: ReadonlyArray<{
+    result?: unknown;
+    toolName: string;
+}>, toolName?: string) => VoiceRAGCitationSummary[];
+export type VoiceRAGToolOptions<TContext = unknown> = {
+    allowedFilterKeys?: readonly string[];
+    description?: string;
+    fixedFilter?: Record<string, unknown> | ((input: {
+        context: TContext;
+    }) => Record<string, unknown> | undefined);
+    formatResult?: (citations: readonly VoiceRAGQueryResult[], args: VoiceRAGToolArgs) => string;
+    maxChunkChars?: number;
+    maxTopK?: number;
+    name?: string;
+    parameters?: Record<string, unknown>;
+    resultToMessage?: (result: VoiceRAGToolResult) => string;
+    scoreThreshold?: number;
+    topK?: number;
+};
+export declare const createVoiceRAGTool: <TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord>(collection: VoiceRAGCollectionLike, options?: VoiceRAGToolOptions<TContext>) => VoiceAgentTool<TContext, TSession, VoiceRAGToolArgs, VoiceRAGToolResult>;

package/dist/core/readinessProfiles.d.ts

@@ -0,0 +1,45 @@
+import type { VoiceProductionReadinessAuditOptions, VoiceProductionReadinessAuditDeliveryOptions, VoiceProductionReadinessOpsActionHistoryOptions, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessTraceDeliveryOptions } from "./productionReadiness";
+export type VoiceReadinessProfileName = "meeting-recorder" | "ops-heavy" | "phone-agent";
+export type VoiceReadinessProfileOptions = {
+    audit?: VoiceProductionReadinessAuditOptions;
+    auditDeliveries?: VoiceProductionReadinessAuditDeliveryOptions;
+    bargeInReports?: VoiceProductionReadinessRoutesOptions["bargeInReports"];
+    campaignReadiness?: VoiceProductionReadinessRoutesOptions["campaignReadiness"];
+    carriers?: VoiceProductionReadinessRoutesOptions["carriers"];
+    deliveryRuntime?: VoiceProductionReadinessRoutesOptions["deliveryRuntime"];
+    explain?: boolean;
+    gate?: VoiceProductionReadinessRoutesOptions["gate"];
+    links?: VoiceProductionReadinessRoutesOptions["links"];
+    observabilityExportDeliveryHistory?: VoiceProductionReadinessRoutesOptions["observabilityExportDeliveryHistory"];
+    opsActionHistory?: VoiceProductionReadinessOpsActionHistoryOptions;
+    phoneAgentSmokes?: VoiceProductionReadinessRoutesOptions["phoneAgentSmokes"];
+    proofSources?: VoiceProductionReadinessRoutesOptions["proofSources"];
+    providerRoutingContracts?: VoiceProductionReadinessRoutesOptions["providerRoutingContracts"];
+    reconnectContracts?: VoiceProductionReadinessRoutesOptions["reconnectContracts"];
+    reconnectContractsMinCount?: VoiceProductionReadinessRoutesOptions["reconnectContractsMinCount"];
+    reconnectContractsMinSnapshotsPerContract?: VoiceProductionReadinessRoutesOptions["reconnectContractsMinSnapshotsPerContract"];
+    telephonyMediaMinCarriers?: VoiceProductionReadinessRoutesOptions["telephonyMediaMinCarriers"];
+    telephonyMediaMinMediaEvents?: VoiceProductionReadinessRoutesOptions["telephonyMediaMinMediaEvents"];
+    browserMediaMinActiveCandidatePairs?: VoiceProductionReadinessRoutesOptions["browserMediaMinActiveCandidatePairs"];
+    browserMediaMinLiveAudioTracks?: VoiceProductionReadinessRoutesOptions["browserMediaMinLiveAudioTracks"];
+    browserMediaMinTotalStats?: VoiceProductionReadinessRoutesOptions["browserMediaMinTotalStats"];
+    telephonyWebhookSecurity?: VoiceProductionReadinessRoutesOptions["telephonyWebhookSecurity"];
+    traceDeliveries?: VoiceProductionReadinessTraceDeliveryOptions;
+};
+export type VoiceReadinessProfileRoutesOptions = Partial<Omit<VoiceProductionReadinessRoutesOptions, "store">>;
+export type VoiceReadinessProfileRecommendationScore = {
+    configured: string[];
+    confidence: number;
+    missing: string[];
+    profile: VoiceReadinessProfileName;
+    reasons: string[];
+};
+export type VoiceReadinessProfileRecommendation = {
+    confidence: number;
+    missing: string[];
+    profile: VoiceReadinessProfileName;
+    reasons: string[];
+    scores: VoiceReadinessProfileRecommendationScore[];
+};
+export declare const createVoiceReadinessProfile: (profile: VoiceReadinessProfileName, options?: VoiceReadinessProfileOptions) => VoiceReadinessProfileRoutesOptions;
+export declare const recommendVoiceReadinessProfile: (options: VoiceReadinessProfileOptions) => VoiceReadinessProfileRecommendation;

package/dist/core/realtimeChannel.d.ts

@@ -0,0 +1,136 @@
+import { Elysia } from "elysia";
+import type { AudioFormat } from "./types";
+import type { StoredVoiceTraceEvent } from "./trace";
+export type VoiceRealtimeChannelStatus = "fail" | "pass" | "warn";
+export type VoiceRealtimeChannelRuntimeSample = {
+    format?: AudioFormat;
+    observedAt?: number;
+    kind: "assistant-audio" | "browser-capture" | "input-audio" | "reconnect" | "turn-commit";
+    latencyMs?: number;
+    ok?: boolean;
+    sessionId?: string;
+    source?: string;
+    turnId?: string;
+};
+export type VoiceRealtimeChannelBrowserCapture = {
+    audioContextSampleRateHz?: number;
+    channelCount?: 1 | 2;
+    processorBufferSize?: number;
+    sampleRateHz?: number;
+};
+export type VoiceRealtimeChannelReportOptions = {
+    browserCapture?: VoiceRealtimeChannelBrowserCapture;
+    expectedInputFormat?: AudioFormat;
+    expectedOutputFormat?: AudioFormat;
+    inputFormat?: AudioFormat;
+    maxFirstAudioLatencyMs?: number;
+    minAssistantAudioSamples?: number;
+    minInputAudioSamples?: number;
+    operationsRecordHref?: string;
+    outputFormat?: AudioFormat;
+    provider: string;
+    readinessHref?: string;
+    runtimeSamples?: VoiceRealtimeChannelRuntimeSample[];
+    surface?: string;
+};
+export type VoiceRealtimeChannelIssue = {
+    code: string;
+    message: string;
+    severity: "error" | "warning";
+};
+export type VoiceRealtimeChannelReport = {
+    browserCapture?: VoiceRealtimeChannelBrowserCapture & {
+        resamplingRequired: boolean;
+        resamplingTargetHz?: number;
+    };
+    checkedAt: number;
+    inputFormat: AudioFormat;
+    issues: VoiceRealtimeChannelIssue[];
+    operationsRecordHref?: string;
+    outputFormat: AudioFormat;
+    provider: string;
+    readinessHref?: string;
+    runtime: {
+        assistantAudioSamples: number;
+        firstAudioLatencyMs?: number;
+        inputAudioSamples: number;
+        samples: VoiceRealtimeChannelRuntimeSample[];
+    };
+    status: VoiceRealtimeChannelStatus;
+    surface: string;
+};
+export type VoiceRealtimeChannelAssertionInput = {
+    maxFirstAudioLatencyMs?: number;
+    minAssistantAudioSamples?: number;
+    minInputAudioSamples?: number;
+    requireBrowserCapture?: boolean;
+    requireOperationsRecordHref?: boolean;
+    requirePass?: boolean;
+    requireReadinessHref?: boolean;
+};
+export type VoiceRealtimeChannelAssertionReport = {
+    issues: string[];
+    ok: boolean;
+    provider: string;
+    status: VoiceRealtimeChannelStatus;
+    surface: string;
+};
+export type VoiceRealtimeChannelRoutesOptions = VoiceRealtimeChannelReportOptions & {
+    headers?: HeadersInit;
+    htmlPath?: false | string;
+    markdownPath?: false | string;
+    name?: string;
+    path?: string;
+    render?: (report: VoiceRealtimeChannelReport) => Promise<string> | string;
+    source?: (() => Promise<VoiceRealtimeChannelReportOptions> | VoiceRealtimeChannelReportOptions) | VoiceRealtimeChannelReportOptions;
+    title?: string;
+};
+export declare const assertVoiceRealtimeChannelEvidence: (report: VoiceRealtimeChannelReport, input?: VoiceRealtimeChannelAssertionInput) => VoiceRealtimeChannelAssertionReport;
+export declare const buildVoiceRealtimeChannelReport: (options: VoiceRealtimeChannelReportOptions) => VoiceRealtimeChannelReport;
+export declare const buildVoiceRealtimeChannelRuntimeSamplesFromTrace: (events: readonly StoredVoiceTraceEvent[], options?: {
+    format?: AudioFormat;
+    source?: string;
+}) => VoiceRealtimeChannelRuntimeSample[];
+export declare const createVoiceRealtimeChannelRoutes: (options: VoiceRealtimeChannelRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    [x: string]: {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: Response;
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;
+export declare const evaluateVoiceRealtimeChannelEvidence: (report: VoiceRealtimeChannelReport, input?: VoiceRealtimeChannelAssertionInput) => VoiceRealtimeChannelAssertionReport;
+export declare const renderVoiceRealtimeChannelHTML: (report: VoiceRealtimeChannelReport, title?: string) => string;
+export declare const renderVoiceRealtimeChannelMarkdown: (report: VoiceRealtimeChannelReport) => string;