@absolutejs/voice 0.0.22-beta.9 → 0.0.22-beta.91

package/dist/providerCapabilities.d.ts

@@ -0,0 +1,92 @@
+import { Elysia } from 'elysia';
+import { type VoiceProviderHealthStatus, type VoiceProviderHealthSummary, type VoiceProviderHealthSummaryOptions } from './providerHealth';
+export type VoiceProviderCapabilityKind = 'llm' | 'stt' | 'tts' | 'custom';
+export type VoiceProviderCapabilityDefinition<TProvider extends string = string> = {
+    configured?: boolean;
+    description?: string;
+    features?: string[];
+    kind: VoiceProviderCapabilityKind;
+    label?: string;
+    model?: string;
+    provider: TProvider;
+    selected?: boolean;
+};
+export type VoiceProviderCapabilitySummary<TProvider extends string = string> = VoiceProviderCapabilityDefinition<TProvider> & {
+    configured: boolean;
+    health?: VoiceProviderHealthSummary<TProvider>;
+    status: VoiceProviderHealthStatus | 'selected' | 'unconfigured';
+};
+export type VoiceProviderCapabilityReport<TProvider extends string = string> = {
+    capabilities: VoiceProviderCapabilitySummary<TProvider>[];
+    checkedAt: number;
+    configured: number;
+    selected: number;
+    total: number;
+    unconfigured: number;
+};
+export type VoiceProviderCapabilityOptions<TProvider extends string = string> = VoiceProviderHealthSummaryOptions<TProvider> & {
+    features?: Partial<Record<TProvider, string[]>>;
+    llmProviders?: readonly TProvider[];
+    models?: Partial<Record<TProvider, string>>;
+    providers?: readonly VoiceProviderCapabilityDefinition<TProvider>[];
+    selected?: Partial<Record<VoiceProviderCapabilityKind, TProvider>>;
+    sttProviders?: readonly TProvider[];
+    ttsProviders?: readonly TProvider[];
+};
+export type VoiceProviderCapabilityHandlerOptions<TProvider extends string = string> = VoiceProviderCapabilityOptions<TProvider>;
+export type VoiceProviderCapabilityHTMLHandlerOptions<TProvider extends string = string> = VoiceProviderCapabilityHandlerOptions<TProvider> & {
+    headers?: HeadersInit;
+    render?: (report: VoiceProviderCapabilityReport<TProvider>) => string | Promise<string>;
+    title?: string;
+};
+export type VoiceProviderCapabilityRoutesOptions<TProvider extends string = string> = VoiceProviderCapabilityHTMLHandlerOptions<TProvider> & {
+    htmlPath?: false | string;
+    name?: string;
+    path?: string;
+};
+export declare const summarizeVoiceProviderCapabilities: <TProvider extends string = string>(options: VoiceProviderCapabilityOptions<TProvider>) => Promise<VoiceProviderCapabilityReport<TProvider>>;
+export declare const renderVoiceProviderCapabilityHTML: <TProvider extends string = string>(report: VoiceProviderCapabilityReport<TProvider>, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceProviderCapabilityJSONHandler: <TProvider extends string = string>(options: VoiceProviderCapabilityHandlerOptions<TProvider>) => () => Promise<VoiceProviderCapabilityReport<TProvider>>;
+export declare const createVoiceProviderCapabilityHTMLHandler: <TProvider extends string = string>(options: VoiceProviderCapabilityHTMLHandlerOptions<TProvider>) => () => Promise<Response>;
+export declare const createVoiceProviderCapabilityRoutes: <TProvider extends string = string>(options: VoiceProviderCapabilityRoutesOptions<TProvider>) => 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: VoiceProviderCapabilityReport<TProvider>;
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/providerHealth.d.ts

@@ -0,0 +1,79 @@
+import { Elysia } from 'elysia';
+import type { StoredVoiceTraceEvent, VoiceTraceEventStore } from './trace';
+export type VoiceProviderHealthStatus = 'healthy' | 'idle' | 'rate-limited' | 'degraded' | 'recoverable' | 'suppressed';
+export type VoiceProviderHealthSummary<TProvider extends string = string> = {
+    averageElapsedMs?: number;
+    errorCount: number;
+    fallbackCount: number;
+    lastError?: string;
+    lastErrorAt?: number;
+    lastSuccessAt?: number;
+    provider: TProvider;
+    rateLimited: boolean;
+    recommended: boolean;
+    runCount: number;
+    status: VoiceProviderHealthStatus;
+    suppressionRemainingMs?: number;
+    suppressedUntil?: number;
+    timeoutCount: number;
+};
+export type VoiceProviderHealthSummaryOptions<TProvider extends string = string> = {
+    events?: StoredVoiceTraceEvent[];
+    now?: number;
+    providers?: readonly TProvider[];
+    store?: VoiceTraceEventStore;
+};
+export type VoiceProviderHealthHandlerOptions<TProvider extends string = string> = VoiceProviderHealthSummaryOptions<TProvider>;
+export type VoiceProviderHealthHTMLHandlerOptions<TProvider extends string = string> = VoiceProviderHealthHandlerOptions<TProvider> & {
+    headers?: HeadersInit;
+    render?: (providers: VoiceProviderHealthSummary<TProvider>[]) => string | Promise<string>;
+};
+export type VoiceProviderHealthRoutesOptions<TProvider extends string = string> = VoiceProviderHealthHTMLHandlerOptions<TProvider> & {
+    htmlPath?: false | string;
+    name?: string;
+    path?: string;
+};
+export declare const summarizeVoiceProviderHealth: <TProvider extends string = string>(input: StoredVoiceTraceEvent[] | VoiceProviderHealthSummaryOptions<TProvider>) => Promise<VoiceProviderHealthSummary<TProvider>[]>;
+export declare const renderVoiceProviderHealthHTML: (providers: VoiceProviderHealthSummary[]) => string;
+export declare const createVoiceProviderHealthJSONHandler: <TProvider extends string = string>(options: VoiceProviderHealthHandlerOptions<TProvider>) => () => Promise<VoiceProviderHealthSummary<TProvider>[]>;
+export declare const createVoiceProviderHealthHTMLHandler: <TProvider extends string = string>(options: VoiceProviderHealthHTMLHandlerOptions<TProvider>) => () => Promise<Response>;
+export declare const createVoiceProviderHealthRoutes: <TProvider extends string = string>(options: VoiceProviderHealthRoutesOptions<TProvider>) => 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: VoiceProviderHealthSummary<TProvider>[];
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/qualityRoutes.d.ts

@@ -0,0 +1,76 @@
+import { Elysia } from 'elysia';
+import { type StoredVoiceTraceEvent, type VoiceTraceEventStore } from './trace';
+export type VoiceQualityStatus = 'pass' | 'fail';
+export type VoiceQualityThresholds = {
+    maxDuplicateTurnRate?: number;
+    maxEmptyTurnRate?: number;
+    maxHandoffFailureRate?: number;
+    maxMissingAssistantReplyRate?: number;
+    maxProviderAverageLatencyMs?: number;
+    maxProviderErrorRate?: number;
+    maxProviderFallbackRate?: number;
+    maxProviderTimeoutRate?: number;
+};
+export type VoiceQualityMetric = {
+    actual: number;
+    label: string;
+    pass: boolean;
+    threshold: number;
+    unit: 'count' | 'ms' | 'rate';
+};
+export type VoiceQualityReport = {
+    checkedAt: number;
+    eventCount: number;
+    metrics: Record<string, VoiceQualityMetric>;
+    status: VoiceQualityStatus;
+    thresholds: Required<VoiceQualityThresholds>;
+};
+export type VoiceQualityLink = {
+    href: string;
+    label: string;
+};
+export type VoiceQualityRoutesOptions = {
+    events?: StoredVoiceTraceEvent[];
+    headers?: HeadersInit;
+    links?: VoiceQualityLink[];
+    name?: string;
+    path?: string;
+    store?: VoiceTraceEventStore;
+    thresholds?: VoiceQualityThresholds;
+};
+export declare const evaluateVoiceQuality: (input: {
+    events?: StoredVoiceTraceEvent[];
+    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: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/queue.d.ts

@@ -1,6 +1,8 @@
 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;
@@ -44,6 +46,13 @@ export type VoiceRedisIdempotencyStoreOptions = {
     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>;
@@ -159,6 +168,50 @@ export type VoiceTraceSinkDeliveryQueueSummary = {
     skipped: number;
     total: number;
 };
+export type VoiceHandoffDeliveryWorkerOptions<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown, TDelivery extends StoredVoiceHandoffDelivery<TContext, TSession, TResult> = StoredVoiceHandoffDelivery<TContext, TSession, TResult>> = {
+    adapters: VoiceHandoffAdapter<TContext, TSession, TResult>[];
+    api: VoiceSessionHandle<TContext, TSession, TResult>;
+    deadLetters?: VoiceHandoffDeliveryStore<TDelivery>;
+    deliveries: VoiceHandoffDeliveryStore<TDelivery>;
+    failMode?: 'record' | 'throw';
+    idempotency?: VoiceIdempotencyStore;
+    idempotencyTtlSeconds?: number;
+    leaseMs?: number;
+    leases: VoiceRedisTaskLeaseCoordinator;
+    maxFailures?: number;
+    onDeadLetter?: (delivery: TDelivery) => Promise<void> | void;
+    statuses?: VoiceHandoffDeliveryQueueStatus[];
+    workerId: string;
+};
+export type VoiceHandoffDeliveryWorkerResult = {
+    alreadyProcessed: number;
+    attempted: number;
+    deadLettered: number;
+    delivered: number;
+    failed: number;
+    skipped: number;
+};
+export type VoiceHandoffDeliveryWorkerLoopOptions<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown, TDelivery extends StoredVoiceHandoffDelivery<TContext, TSession, TResult> = StoredVoiceHandoffDelivery<TContext, TSession, TResult>> = {
+    onError?: (error: unknown) => Promise<void> | void;
+    pollIntervalMs?: number;
+    worker: ReturnType<typeof createVoiceHandoffDeliveryWorker<TContext, TSession, TResult, TDelivery>>;
+};
+export type VoiceHandoffDeliveryWorkerLoop = {
+    isRunning: () => boolean;
+    start: () => void;
+    stop: () => void;
+    tick: () => Promise<VoiceHandoffDeliveryWorkerResult>;
+};
+export type VoiceHandoffDeliveryQueueSummary = {
+    byAction: Array<[StoredVoiceHandoffDelivery['action'], number]>;
+    deadLettered: number;
+    delivered: number;
+    failed: number;
+    pending: number;
+    retryEligible: number;
+    skipped: number;
+    total: number;
+};
 export type VoiceOpsTaskWorkerOptions<TTask extends StoredVoiceOpsTask = StoredVoiceOpsTask> = {
     leaseMs?: number;
     leases: VoiceRedisTaskLeaseCoordinator;
@@ -252,11 +305,15 @@ export declare const summarizeVoiceIntegrationEvents: <TEvent extends StoredVoic
 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 createVoiceRedisTelephonyWebhookIdempotencyStore: <TResult = unknown>(options?: VoiceRedisTelephonyWebhookIdempotencyStoreOptions) => VoiceTelephonyWebhookIdempotencyStore<TResult>;
 export declare const createVoiceWebhookDeliveryWorker: <TEvent extends StoredVoiceIntegrationEvent = StoredVoiceIntegrationEvent>(options: VoiceWebhookDeliveryWorkerOptions<TEvent>) => {
     drain: () => Promise<VoiceWebhookDeliveryWorkerResult>;
 };
@@ -269,6 +326,10 @@ export declare const createVoiceTraceSinkDeliveryWorker: <TDelivery extends Voic
     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>;

package/dist/react/VoiceOpsStatus.d.ts

@@ -0,0 +1,6 @@
+import { type VoiceOpsStatusWidgetOptions } from '../client/opsStatusWidget';
+export type VoiceOpsStatusProps = VoiceOpsStatusWidgetOptions & {
+    className?: string;
+    path?: string;
+};
+export declare const VoiceOpsStatus: ({ className, path, ...options }: VoiceOpsStatusProps) => import("react/jsx-runtime").JSX.Element;

package/dist/react/VoiceProviderCapabilities.d.ts

@@ -0,0 +1,6 @@
+import { type VoiceProviderCapabilitiesWidgetOptions } from '../client/providerCapabilitiesWidget';
+export type VoiceProviderCapabilitiesProps = VoiceProviderCapabilitiesWidgetOptions & {
+    className?: string;
+    path?: string;
+};
+export declare const VoiceProviderCapabilities: ({ className, path, ...options }: VoiceProviderCapabilitiesProps) => import("react/jsx-runtime").JSX.Element;

package/dist/react/VoiceProviderSimulationControls.d.ts

@@ -0,0 +1,5 @@
+import type { VoiceProviderSimulationControlsOptions } from '../client/providerSimulationControls';
+export type VoiceProviderSimulationControlsProps<TProvider extends string = string> = VoiceProviderSimulationControlsOptions<TProvider> & {
+    className?: string;
+};
+export declare const VoiceProviderSimulationControls: <TProvider extends string = string>({ className, ...options }: VoiceProviderSimulationControlsProps<TProvider>) => import("react/jsx-runtime").JSX.Element;

package/dist/react/VoiceProviderStatus.d.ts

@@ -0,0 +1,6 @@
+import { type VoiceProviderStatusWidgetOptions } from '../client/providerStatusWidget';
+export type VoiceProviderStatusProps = VoiceProviderStatusWidgetOptions & {
+    className?: string;
+    path?: string;
+};
+export declare const VoiceProviderStatus: ({ className, path, ...options }: VoiceProviderStatusProps) => import("react/jsx-runtime").JSX.Element;

package/dist/react/VoiceRoutingStatus.d.ts

@@ -0,0 +1,6 @@
+import { type VoiceRoutingStatusWidgetOptions } from '../client/routingStatusWidget';
+export type VoiceRoutingStatusProps = VoiceRoutingStatusWidgetOptions & {
+    className?: string;
+    path?: string;
+};
+export declare const VoiceRoutingStatus: ({ className, path, ...options }: VoiceRoutingStatusProps) => import("react/jsx-runtime").JSX.Element;

package/dist/react/VoiceTraceTimeline.d.ts

@@ -0,0 +1,6 @@
+import { type VoiceTraceTimelineWidgetOptions } from '../client/traceTimelineWidget';
+export type VoiceTraceTimelineProps = VoiceTraceTimelineWidgetOptions & {
+    className?: string;
+    path?: string;
+};
+export declare const VoiceTraceTimeline: ({ className, path, ...options }: VoiceTraceTimelineProps) => import("react/jsx-runtime").JSX.Element;

package/dist/react/VoiceTurnQuality.d.ts

@@ -0,0 +1,6 @@
+import { type VoiceTurnQualityWidgetOptions } from '../client/turnQualityWidget';
+export type VoiceTurnQualityProps = VoiceTurnQualityWidgetOptions & {
+    className?: string;
+    path?: string;
+};
+export declare const VoiceTurnQuality: ({ className, path, ...options }: VoiceTurnQualityProps) => import("react/jsx-runtime").JSX.Element;

package/dist/react/index.d.ts

@@ -1,2 +1,17 @@
+export { VoiceOpsStatus } from './VoiceOpsStatus';
+export { VoiceProviderSimulationControls } from './VoiceProviderSimulationControls';
+export { VoiceProviderCapabilities } from './VoiceProviderCapabilities';
+export { VoiceProviderStatus } from './VoiceProviderStatus';
+export { VoiceRoutingStatus } from './VoiceRoutingStatus';
+export { VoiceTraceTimeline } from './VoiceTraceTimeline';
+export { VoiceTurnQuality } from './VoiceTurnQuality';
+export { useVoiceAppKitStatus } from './useVoiceAppKitStatus';
 export { useVoiceStream } from './useVoiceStream';
 export { useVoiceController } from './useVoiceController';
+export { useVoiceProviderStatus } from './useVoiceProviderStatus';
+export { useVoiceProviderCapabilities } from './useVoiceProviderCapabilities';
+export { useVoiceProviderSimulationControls } from './useVoiceProviderSimulationControls';
+export { useVoiceRoutingStatus } from './useVoiceRoutingStatus';
+export { useVoiceTraceTimeline } from './useVoiceTraceTimeline';
+export { useVoiceTurnQuality } from './useVoiceTurnQuality';
+export { useVoiceWorkflowStatus } from './useVoiceWorkflowStatus';