@absolutejs/voice 0.0.22-beta.17 → 0.0.22-beta.170

package/dist/liveLatency.d.ts

@@ -0,0 +1,78 @@
+import { Elysia } from 'elysia';
+import type { VoiceTraceEventStore } from './trace';
+export type VoiceLiveLatencyStatus = 'empty' | 'fail' | 'pass' | 'warn';
+export type VoiceLiveLatencySample = {
+    at: number;
+    latencyMs: number;
+    sessionId: string;
+    status?: string;
+    traceId?: string;
+};
+export type VoiceLiveLatencyReport = {
+    averageLatencyMs?: number;
+    checkedAt: number;
+    failed: number;
+    p50LatencyMs?: number;
+    p95LatencyMs?: number;
+    recent: VoiceLiveLatencySample[];
+    status: VoiceLiveLatencyStatus;
+    total: number;
+    warnings: number;
+};
+export type VoiceLiveLatencyOptions = {
+    failAfterMs?: number;
+    limit?: number;
+    store: VoiceTraceEventStore;
+    warnAfterMs?: number;
+};
+export type VoiceLiveLatencyRoutesOptions = VoiceLiveLatencyOptions & {
+    headers?: HeadersInit;
+    htmlPath?: false | string;
+    name?: string;
+    path?: string;
+    title?: string;
+};
+export declare const summarizeVoiceLiveLatency: (options: VoiceLiveLatencyOptions) => Promise<VoiceLiveLatencyReport>;
+export declare const renderVoiceLiveLatencyHTML: (report: VoiceLiveLatencyReport, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceLiveLatencyRoutes: (options: VoiceLiveLatencyRoutesOptions) => 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: VoiceLiveLatencyReport;
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/modelAdapters.d.ts

@@ -36,9 +36,11 @@ export type GeminiVoiceAssistantModelOptions = {
 };
 export type VoiceProviderRouterEvent<TProvider extends string = string> = {
     at: number;
+    attempt: number;
     elapsedMs: number;
     error?: string;
     fallbackProvider?: TProvider;
+    latencyBudgetMs?: number;
     provider: TProvider;
     providerHealth?: VoiceProviderRouterProviderHealth<TProvider>;
     rateLimited?: boolean;
@@ -47,18 +49,35 @@ export type VoiceProviderRouterEvent<TProvider extends string = string> = {
     suppressionRemainingMs?: number;
     suppressedUntil?: number;
     status: 'error' | 'fallback' | 'success';
+    timedOut?: boolean;
 };
 export type VoiceProviderRouterFallbackMode = 'never' | 'provider-error' | 'rate-limit';
-export type VoiceProviderRouterPolicy<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TProvider extends string = string> = 'ordered' | 'prefer-cheapest' | 'prefer-fastest' | 'prefer-selected' | {
+export type VoiceProviderRouterStrategy = 'balanced' | 'ordered' | 'prefer-cheapest' | 'prefer-fastest' | 'prefer-selected' | 'quality-first';
+export type VoiceProviderRouterPolicyPreset = 'balanced' | 'cost-cap' | 'cost-first' | 'latency-first' | 'quality-first';
+export type VoiceProviderRouterPolicyWeights = {
+    cost?: number;
+    latencyMs?: number;
+    priority?: number;
+    quality?: number;
+};
+export type VoiceProviderRouterPolicy<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TProvider extends string = string> = VoiceProviderRouterStrategy | VoiceProviderRouterPolicyPreset | {
     allowProviders?: readonly TProvider[] | ((input: VoiceAgentModelInput<TContext, TSession>) => readonly TProvider[] | Promise<readonly TProvider[]>);
     fallbackMode?: VoiceProviderRouterFallbackMode;
-    strategy?: 'ordered' | 'prefer-cheapest' | 'prefer-fastest' | 'prefer-selected';
+    maxCost?: number;
+    maxLatencyMs?: number;
+    minQuality?: number;
+    scoreProvider?: (provider: TProvider, profile: VoiceProviderRouterProviderProfile | undefined) => number;
+    strategy?: VoiceProviderRouterStrategy;
+    weights?: VoiceProviderRouterPolicyWeights;
 };
 export type VoiceProviderRouterProviderProfile = {
     cost?: number;
     latencyMs?: number;
     priority?: number;
+    quality?: number;
+    timeoutMs?: number;
 };
+export declare const resolveVoiceProviderRoutingPolicyPreset: <TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TProvider extends string = string>(preset: VoiceProviderRouterPolicyPreset, options?: Omit<Extract<VoiceProviderRouterPolicy<TContext, TSession, TProvider>, Record<string, unknown>>, "strategy">) => Extract<VoiceProviderRouterPolicy<TContext, TSession, TProvider>, Record<string, unknown>>;
 export type VoiceProviderRouterHealthOptions = {
     cooldownMs?: number;
     failureThreshold?: number;
@@ -79,10 +98,12 @@ export type VoiceProviderRouterOptions<TContext = unknown, TSession extends Voic
     fallbackMode?: VoiceProviderRouterFallbackMode;
     isProviderError?: (error: unknown, provider: TProvider) => boolean;
     isRateLimitError?: (error: unknown, provider: TProvider) => boolean;
+    isTimeoutError?: (error: unknown, provider: TProvider) => boolean;
     onProviderEvent?: (event: VoiceProviderRouterEvent<TProvider>, input: VoiceAgentModelInput<TContext, TSession>) => Promise<void> | void;
     policy?: VoiceProviderRouterPolicy<TContext, TSession, TProvider>;
     providerHealth?: boolean | VoiceProviderRouterHealthOptions;
     providerProfiles?: Partial<Record<TProvider, VoiceProviderRouterProviderProfile>>;
+    timeoutMs?: number;
     providers: Partial<Record<TProvider, VoiceAgentModel<TContext, TSession, TResult>>>;
     selectProvider?: (input: VoiceAgentModelInput<TContext, TSession>) => TProvider | undefined | Promise<TProvider | undefined>;
 };

package/dist/openaiRealtime.d.ts

@@ -0,0 +1,27 @@
+import type { RealtimeAdapter } from './types';
+export type OpenAIRealtimeModel = 'gpt-realtime' | 'gpt-realtime-mini' | 'gpt-4o-realtime-preview' | 'gpt-4o-mini-realtime-preview' | (string & {});
+export type OpenAIRealtimeVoice = 'alloy' | 'ash' | 'ballad' | 'cedar' | 'coral' | 'echo' | 'marin' | 'sage' | 'shimmer' | 'verse' | {
+    id: string;
+} | (string & {});
+export type OpenAIRealtimeTranscriptionModel = 'gpt-4o-mini-transcribe' | 'gpt-4o-transcribe' | 'whisper-1' | (string & {});
+export type OpenAIRealtimeNoiseReduction = 'near_field' | 'far_field';
+export type OpenAIRealtimeResponseMode = 'audio' | 'text';
+export type OpenAIRealtimeAdapterOptions = {
+    apiKey: string;
+    autoCommitSilenceMs?: number;
+    baseUrl?: string;
+    emitResponseTranscripts?: boolean;
+    inputTranscriptionLanguage?: string;
+    inputTranscriptionModel?: OpenAIRealtimeTranscriptionModel | null;
+    inputTranscriptionPrompt?: string;
+    instructions?: string;
+    maxOutputTokens?: number | 'inf';
+    model?: OpenAIRealtimeModel;
+    noiseReduction?: OpenAIRealtimeNoiseReduction;
+    responseMode?: OpenAIRealtimeResponseMode;
+    speed?: number;
+    temperature?: number;
+    voice?: OpenAIRealtimeVoice;
+    webSocket?: typeof WebSocket;
+};
+export declare const createOpenAIRealtimeAdapter: (options: OpenAIRealtimeAdapterOptions) => RealtimeAdapter;

package/dist/openaiTTS.d.ts

@@ -0,0 +1,18 @@
+import type { TTSAdapter, TTSAdapterOpenOptions, VoiceLexiconEntry } from './types';
+export type OpenAIVoiceTTSVoice = 'alloy' | 'ash' | 'ballad' | 'cedar' | 'coral' | 'echo' | 'fable' | 'marin' | 'nova' | 'onyx' | 'sage' | 'shimmer' | 'verse' | (string & {});
+export type OpenAIVoiceTTSOptions = {
+    apiKey: string;
+    baseUrl?: string;
+    fetch?: typeof fetch;
+    instructions?: string | ((input: {
+        lexicon?: VoiceLexiconEntry[];
+        sessionId: string;
+        text: string;
+    }) => Promise<string | undefined> | string | undefined);
+    model?: 'gpt-4o-mini-tts' | 'tts-1' | 'tts-1-hd' | (string & {});
+    speed?: number;
+    voice?: OpenAIVoiceTTSVoice | {
+        id: string;
+    };
+};
+export declare const createOpenAIVoiceTTS: (options: OpenAIVoiceTTSOptions) => TTSAdapter<TTSAdapterOpenOptions>;

package/dist/opsActionAuditRoutes.d.ts

@@ -0,0 +1,99 @@
+import { Elysia } from 'elysia';
+import { type StoredVoiceAuditEvent, type VoiceAuditEventStore } from './audit';
+import { type VoiceTraceEventStore } from './trace';
+export type VoiceOpsActionAuditRecord = {
+    actionId: string;
+    body?: unknown;
+    error?: string;
+    ok: boolean;
+    ranAt: number;
+    status: number;
+};
+export type VoiceOpsActionAuditRoutesOptions = {
+    audit?: VoiceAuditEventStore;
+    historyHtmlPath?: false | string;
+    historyPath?: false | string;
+    name?: string;
+    path?: string;
+    trace?: VoiceTraceEventStore;
+};
+export type VoiceOpsActionHistoryEntry = {
+    actionId: string;
+    at: number;
+    error?: string;
+    eventId: string;
+    ok: boolean;
+    status?: number;
+    traceId?: string;
+};
+export type VoiceOpsActionHistoryReport = {
+    checkedAt: number;
+    entries: VoiceOpsActionHistoryEntry[];
+    failed: number;
+    passed: number;
+    total: number;
+};
+export declare const recordVoiceOpsActionAudit: (record: VoiceOpsActionAuditRecord, options: Pick<VoiceOpsActionAuditRoutesOptions, "audit" | "trace">) => Promise<{
+    audit: StoredVoiceAuditEvent<Record<string, unknown>> | (Omit<import("./audit").VoiceAuditEvent<Record<string, unknown>>, "at" | "id"> & {
+        at: number;
+        id: string;
+    }) | undefined;
+    ok: boolean;
+    trace: (import("./trace").VoiceTraceEvent<Record<string, unknown>> & {
+        id: string;
+    }) | undefined;
+}>;
+export declare const createVoiceOpsActionAuditRoutes: (options: VoiceOpsActionAuditRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    [x: string]: {
+        post: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: {
+                    audit: StoredVoiceAuditEvent<Record<string, unknown>> | (Omit<import("./audit").VoiceAuditEvent<Record<string, unknown>>, "at" | "id"> & {
+                        at: number;
+                        id: string;
+                    }) | undefined;
+                    ok: boolean;
+                    trace: (import("./trace").VoiceTraceEvent<Record<string, unknown>> & {
+                        id: string;
+                    }) | undefined;
+                } | {
+                    error: string;
+                    ok: boolean;
+                };
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;
+export declare const buildVoiceOpsActionHistoryReport: (options: Pick<VoiceOpsActionAuditRoutesOptions, "audit">) => Promise<VoiceOpsActionHistoryReport>;
+export declare const renderVoiceOpsActionHistoryHTML: (report: VoiceOpsActionHistoryReport) => string;

package/dist/opsConsoleRoutes.d.ts

@@ -0,0 +1,80 @@
+import { Elysia } from 'elysia';
+import { type VoiceDeliverySinkReport, type VoiceDeliverySinkRoutesOptions } from './deliverySinkRoutes';
+import { type VoiceQualityReport } from './qualityRoutes';
+import { type VoiceRoutingEvent } from './resilienceRoutes';
+import { type VoiceSessionListItem } from './sessionReplay';
+import { summarizeVoiceTrace, type VoiceTraceEventStore } from './trace';
+export type VoiceOpsConsoleLink = {
+    description?: string;
+    href: string;
+    label: string;
+    statusHref?: string;
+};
+export type VoiceOpsConsoleReport = {
+    checkedAt: number;
+    eventCount: number;
+    handoffs: {
+        failed: number;
+        total: number;
+    };
+    links: VoiceOpsConsoleLink[];
+    deliverySinks?: VoiceDeliverySinkReport;
+    providers: {
+        degraded: number;
+        healthy: number;
+        total: number;
+    };
+    quality: VoiceQualityReport;
+    recentRoutingEvents: VoiceRoutingEvent[];
+    recentSessions: VoiceSessionListItem[];
+    sessions: {
+        failed: number;
+        healthy: number;
+        total: number;
+    };
+    trace: ReturnType<typeof summarizeVoiceTrace>;
+};
+export type VoiceOpsConsoleRoutesOptions = {
+    headers?: HeadersInit;
+    deliverySinks?: false | VoiceDeliverySinkRoutesOptions;
+    links?: VoiceOpsConsoleLink[];
+    llmProviders?: readonly string[];
+    name?: string;
+    path?: string;
+    store: VoiceTraceEventStore;
+    sttProviders?: readonly string[];
+    title?: string;
+    ttsProviders?: readonly string[];
+};
+export declare const buildVoiceOpsConsoleReport: (options: VoiceOpsConsoleRoutesOptions) => Promise<VoiceOpsConsoleReport>;
+export declare const renderVoiceOpsConsoleHTML: (report: VoiceOpsConsoleReport, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceOpsConsoleRoutes: (options: VoiceOpsConsoleRoutesOptions) => 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/opsStatus.d.ts

@@ -0,0 +1,76 @@
+import { type VoiceEvalLink, type VoiceEvalRoutesOptions } from './evalRoutes';
+import { type VoiceDeliverySinkRoutesOptions } from './deliverySinkRoutes';
+import { type VoiceQualityRoutesOptions } from './qualityRoutes';
+import { type VoiceProviderFallbackRecoverySummary } from './sessionReplay';
+import { type VoiceTraceEventStore } from './trace';
+export type VoiceOpsStatus = 'pass' | 'fail';
+export type VoiceOpsStatusLink = VoiceEvalLink & {
+    description?: string;
+    statusHref?: string;
+};
+export type VoiceOpsStatusOptions<TProvider extends string = string> = {
+    deliverySinks?: false | VoiceDeliverySinkRoutesOptions;
+    evals?: false | Partial<VoiceEvalRoutesOptions>;
+    include?: {
+        deliverySinks?: boolean;
+        handoffs?: boolean;
+        providers?: boolean;
+        providerRecovery?: boolean;
+        quality?: boolean;
+        sessions?: boolean;
+        workflows?: boolean;
+    };
+    links?: VoiceOpsStatusLink[];
+    llmProviders?: readonly TProvider[];
+    preferFixtureWorkflows?: boolean;
+    quality?: false | Partial<VoiceQualityRoutesOptions>;
+    store: VoiceTraceEventStore;
+    sttProviders?: readonly string[];
+    ttsProviders?: readonly string[];
+};
+export type VoiceOpsStatusReport = {
+    checkedAt: number;
+    failed: number;
+    links: VoiceOpsStatusLink[];
+    passed: number;
+    status: VoiceOpsStatus;
+    surfaces: {
+        handoffs?: {
+            failed: number;
+            status: VoiceOpsStatus;
+            total: number;
+        };
+        deliverySinks?: {
+            auditTotal: number;
+            status: VoiceOpsStatus;
+            traceTotal: number;
+        };
+        providers?: {
+            degraded: number;
+            status: VoiceOpsStatus;
+            total: number;
+        };
+        providerRecovery?: VoiceProviderFallbackRecoverySummary;
+        quality?: {
+            status: VoiceOpsStatus;
+        };
+        sessions?: {
+            failed: number;
+            status: VoiceOpsStatus;
+            total: number;
+        };
+        workflows?: {
+            failed: number;
+            source: 'fixtures' | 'live';
+            status: VoiceOpsStatus;
+            total: number;
+        };
+    };
+    total: number;
+};
+export type VoiceOpsStatusRoutesOptions<TProvider extends string = string> = VoiceOpsStatusOptions<TProvider> & {
+    headers?: HeadersInit;
+    name?: string;
+    path?: string;
+};
+export declare const summarizeVoiceOpsStatus: <TProvider extends string = string>(options: VoiceOpsStatusOptions<TProvider>) => Promise<VoiceOpsStatusReport>;

package/dist/opsStatusRoutes.d.ts

@@ -0,0 +1,33 @@
+import { Elysia } from 'elysia';
+import { type VoiceOpsStatusReport, type VoiceOpsStatusRoutesOptions } from './opsStatus';
+export declare const renderVoiceOpsStatusHTML: (report: VoiceOpsStatusReport, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceOpsStatusRoutes: (options: VoiceOpsStatusRoutesOptions) => 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/opsWebhook.d.ts

@@ -0,0 +1,126 @@
+import { Elysia } from 'elysia';
+import type { StoredVoiceIntegrationEvent, VoiceIntegrationEventType } from './ops';
+import type { VoiceIntegrationHTTPSinkOptions, VoiceIntegrationSink } from './opsSinks';
+type MaybePromise<T> = T | Promise<T>;
+export type VoiceOpsWebhookLinkResolver = string | ((input: {
+    event: StoredVoiceIntegrationEvent;
+}) => MaybePromise<string | undefined>);
+export type VoiceOpsWebhookEntity = {
+    disposition?: string;
+    outcome?: string;
+    priority?: string;
+    queue?: string;
+    reviewId?: string;
+    scenarioId?: string;
+    sessionId?: string;
+    status?: string;
+    target?: string;
+    taskId?: string;
+};
+export type VoiceOpsWebhookEnvelope = {
+    entity: VoiceOpsWebhookEntity;
+    event: {
+        createdAt: number;
+        id: string;
+        payload: Record<string, unknown>;
+        type: VoiceIntegrationEventType;
+    };
+    links?: {
+        event?: string;
+        replay?: string;
+        review?: string;
+        task?: string;
+    };
+    schemaVersion: 1;
+    source: 'absolutejs-voice';
+};
+export type VoiceOpsWebhookSinkOptions = Omit<VoiceIntegrationHTTPSinkOptions<VoiceOpsWebhookEnvelope>, 'body'> & {
+    baseUrl?: string;
+    eventHref?: VoiceOpsWebhookLinkResolver;
+    replayHref?: VoiceOpsWebhookLinkResolver;
+    reviewHref?: VoiceOpsWebhookLinkResolver;
+    taskHref?: VoiceOpsWebhookLinkResolver;
+};
+export type VoiceOpsWebhookVerificationResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: 'invalid-signature' | 'missing-secret' | 'missing-signature' | 'missing-timestamp' | 'stale-timestamp' | 'unsupported-algorithm';
+};
+export type VoiceOpsWebhookReceiverRoutesOptions = {
+    onEnvelope?: (input: {
+        envelope: VoiceOpsWebhookEnvelope;
+        request: Request;
+    }) => MaybePromise<void>;
+    path?: string;
+    signingSecret?: string;
+    toleranceMs?: number;
+};
+export declare const createVoiceOpsWebhookEnvelope: (input: {
+    baseUrl?: string;
+    event: StoredVoiceIntegrationEvent;
+    eventHref?: VoiceOpsWebhookLinkResolver;
+    replayHref?: VoiceOpsWebhookLinkResolver;
+    reviewHref?: VoiceOpsWebhookLinkResolver;
+    taskHref?: VoiceOpsWebhookLinkResolver;
+}) => Promise<VoiceOpsWebhookEnvelope>;
+export declare const createVoiceOpsWebhookSink: (options: VoiceOpsWebhookSinkOptions) => VoiceIntegrationSink;
+export declare const verifyVoiceOpsWebhookSignature: (input: {
+    body: string;
+    now?: number;
+    secret?: string;
+    signature?: string | null;
+    timestamp?: string | null;
+    toleranceMs?: number;
+}) => Promise<VoiceOpsWebhookVerificationResult>;
+export declare const createVoiceOpsWebhookReceiverRoutes: (options?: VoiceOpsWebhookReceiverRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    [x: string]: {
+        post: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: {
+                    ok: boolean;
+                    reason: "invalid-signature" | "missing-secret" | "missing-signature" | "missing-timestamp" | "stale-timestamp" | "unsupported-algorithm";
+                    eventId?: undefined;
+                    type?: undefined;
+                } | {
+                    eventId: string;
+                    ok: boolean;
+                    type: VoiceIntegrationEventType;
+                    reason?: undefined;
+                };
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;
+export {};