@absolutejs/voice 0.0.22-beta.13 → 0.0.22-beta.130

package/dist/phoneAgentProductionSmoke.d.ts

@@ -0,0 +1,115 @@
+import { Elysia } from 'elysia';
+import type { StoredVoiceTraceEvent, VoiceTraceEventStore } from './trace';
+import type { VoiceTelephonyContractReport, VoiceTelephonyProvider } from './telephony/contract';
+export type VoicePhoneAgentProductionSmokeRequirement = 'assistant-response' | 'carrier-contract' | 'fresh-trace' | 'lifecycle-outcome' | 'media-started' | 'no-session-error' | 'transcript';
+export type VoicePhoneAgentProductionSmokeIssue = {
+    message: string;
+    requirement: VoicePhoneAgentProductionSmokeRequirement;
+    severity: 'error' | 'warning';
+};
+export type VoicePhoneAgentProductionSmokeReport<TProvider extends VoiceTelephonyProvider = VoiceTelephonyProvider> = {
+    contract?: VoiceTelephonyContractReport<TProvider>;
+    contractId: string;
+    generatedAt: number;
+    issues: VoicePhoneAgentProductionSmokeIssue[];
+    maxAgeMs?: number;
+    observed: {
+        assistantResponses: number;
+        carrierContract?: boolean;
+        lifecycleOutcomes: string[];
+        latestEventAt?: number;
+        mediaStarts: number;
+        sessionErrors: number;
+        transcripts: number;
+    };
+    pass: boolean;
+    provider?: TProvider;
+    required: VoicePhoneAgentProductionSmokeRequirement[];
+    scenarioId?: string;
+    sessionId?: string;
+    traceId?: string;
+};
+export type VoicePhoneAgentProductionSmokeOptions<TProvider extends VoiceTelephonyProvider = VoiceTelephonyProvider> = {
+    contract?: VoiceTelephonyContractReport<TProvider>;
+    contractId?: string;
+    events?: readonly StoredVoiceTraceEvent[];
+    maxAgeMs?: number;
+    now?: number;
+    provider?: TProvider;
+    required?: readonly VoicePhoneAgentProductionSmokeRequirement[];
+    scenarioId?: string;
+    sessionId?: string;
+    store?: VoiceTraceEventStore;
+    traceId?: string;
+};
+export type VoicePhoneAgentProductionSmokeHandlerOptions<TProvider extends VoiceTelephonyProvider = VoiceTelephonyProvider> = Omit<VoicePhoneAgentProductionSmokeOptions<TProvider>, 'events' | 'scenarioId' | 'sessionId' | 'traceId'> & {
+    getContract?: (input: {
+        query: Record<string, unknown>;
+        request: Request;
+    }) => Promise<VoiceTelephonyContractReport<TProvider> | undefined> | VoiceTelephonyContractReport<TProvider> | undefined;
+    scenarioId?: string;
+    sessionId?: string;
+    traceId?: string;
+};
+export type VoicePhoneAgentProductionSmokeHTMLHandlerOptions<TProvider extends VoiceTelephonyProvider = VoiceTelephonyProvider> = VoicePhoneAgentProductionSmokeHandlerOptions<TProvider> & {
+    headers?: HeadersInit;
+    render?: (report: VoicePhoneAgentProductionSmokeReport<TProvider>) => Promise<string> | string;
+    title?: string;
+};
+export type VoicePhoneAgentProductionSmokeRoutesOptions<TProvider extends VoiceTelephonyProvider = VoiceTelephonyProvider> = VoicePhoneAgentProductionSmokeHTMLHandlerOptions<TProvider> & {
+    htmlPath?: false | string;
+    name?: string;
+    path?: string;
+};
+export declare const runVoicePhoneAgentProductionSmokeContract: <TProvider extends VoiceTelephonyProvider = VoiceTelephonyProvider>(options: VoicePhoneAgentProductionSmokeOptions<TProvider>) => Promise<VoicePhoneAgentProductionSmokeReport<TProvider>>;
+export declare const renderVoicePhoneAgentProductionSmokeHTML: <TProvider extends VoiceTelephonyProvider = VoiceTelephonyProvider>(report: VoicePhoneAgentProductionSmokeReport<TProvider>, options?: {
+    title?: string;
+}) => string;
+export declare const createVoicePhoneAgentProductionSmokeJSONHandler: <TProvider extends VoiceTelephonyProvider = VoiceTelephonyProvider>(options: VoicePhoneAgentProductionSmokeHandlerOptions<TProvider>) => ({ query, request }: {
+    query: Record<string, unknown>;
+    request: Request;
+}) => Promise<VoicePhoneAgentProductionSmokeReport<TProvider>>;
+export declare const createVoicePhoneAgentProductionSmokeHTMLHandler: <TProvider extends VoiceTelephonyProvider = VoiceTelephonyProvider>(options: VoicePhoneAgentProductionSmokeHTMLHandlerOptions<TProvider>) => ({ query, request }: {
+    query: Record<string, unknown>;
+    request: Request;
+}) => Promise<Response>;
+export declare const createVoicePhoneAgentProductionSmokeRoutes: <TProvider extends VoiceTelephonyProvider = VoiceTelephonyProvider>(options: VoicePhoneAgentProductionSmokeRoutesOptions<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: VoicePhoneAgentProductionSmokeReport<TProvider>;
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/postgresStore.d.ts

@@ -1,6 +1,10 @@
 import { type StoredVoiceTraceEvent, type VoiceTraceSinkDeliveryRecord, type VoiceTraceSinkDeliveryStore, type VoiceTraceEventStore } from './trace';
+import { type StoredVoiceAuditEvent, type VoiceAuditEventStore } from './audit';
+import type { VoiceAuditSinkDeliveryRecord, VoiceAuditSinkDeliveryStore } from './auditSinks';
 import type { StoredVoiceIntegrationEvent, StoredVoiceExternalObjectMap, StoredVoiceOpsTask, VoiceExternalObjectMapStore, VoiceIntegrationEventStore, VoiceOpsTaskStore } from './ops';
 import type { StoredVoiceCallReviewArtifact, VoiceCallReviewStore } from './testing/review';
+import type { VoiceTelephonyWebhookIdempotencyStore } from './telephonyOutcome';
+import type { VoiceCampaignStore } from './campaign';
 import type { VoiceSessionRecord, VoiceSessionStore } from './types';
 export type VoicePostgresClient = {
     unsafe: <TRow extends Record<string, unknown> = Record<string, unknown>>(query: string, parameters?: unknown[]) => Promise<TRow[]>;
@@ -12,7 +16,10 @@ export type VoicePostgresStoreOptions = {
     tableName?: string;
     tablePrefix?: string;
 };
-export type VoicePostgresRuntimeStorage<TSession extends VoiceSessionRecord = VoiceSessionRecord, TReview extends StoredVoiceCallReviewArtifact = StoredVoiceCallReviewArtifact, TTask extends StoredVoiceOpsTask = StoredVoiceOpsTask, TEvent extends StoredVoiceIntegrationEvent = StoredVoiceIntegrationEvent, TMapping extends StoredVoiceExternalObjectMap = StoredVoiceExternalObjectMap, TTrace extends StoredVoiceTraceEvent = StoredVoiceTraceEvent, TTraceDelivery extends VoiceTraceSinkDeliveryRecord = VoiceTraceSinkDeliveryRecord> = {
+export type VoicePostgresRuntimeStorage<TSession extends VoiceSessionRecord = VoiceSessionRecord, TReview extends StoredVoiceCallReviewArtifact = StoredVoiceCallReviewArtifact, TTask extends StoredVoiceOpsTask = StoredVoiceOpsTask, TEvent extends StoredVoiceIntegrationEvent = StoredVoiceIntegrationEvent, TMapping extends StoredVoiceExternalObjectMap = StoredVoiceExternalObjectMap, TTrace extends StoredVoiceTraceEvent = StoredVoiceTraceEvent, TTraceDelivery extends VoiceTraceSinkDeliveryRecord = VoiceTraceSinkDeliveryRecord, TAudit extends StoredVoiceAuditEvent = StoredVoiceAuditEvent, TAuditDelivery extends VoiceAuditSinkDeliveryRecord = VoiceAuditSinkDeliveryRecord> = {
+    audit: VoiceAuditEventStore<TAudit>;
+    auditDeliveries: VoiceAuditSinkDeliveryStore<TAuditDelivery>;
+    campaigns: VoiceCampaignStore;
     events: VoiceIntegrationEventStore<TEvent>;
     externalObjects: VoiceExternalObjectMapStore<TMapping>;
     reviews: VoiceCallReviewStore<TReview>;
@@ -28,4 +35,8 @@ export declare const createVoicePostgresIntegrationEventStore: <TEvent extends S
 export declare const createVoicePostgresExternalObjectMapStore: <TMapping extends StoredVoiceExternalObjectMap = StoredVoiceExternalObjectMap>(options: VoicePostgresStoreOptions) => VoiceExternalObjectMapStore<TMapping>;
 export declare const createVoicePostgresTraceEventStore: <TEvent extends StoredVoiceTraceEvent = StoredVoiceTraceEvent>(options: VoicePostgresStoreOptions) => VoiceTraceEventStore<TEvent>;
 export declare const createVoicePostgresTraceSinkDeliveryStore: <TDelivery extends VoiceTraceSinkDeliveryRecord = VoiceTraceSinkDeliveryRecord>(options: VoicePostgresStoreOptions) => VoiceTraceSinkDeliveryStore<TDelivery>;
-export declare const createVoicePostgresRuntimeStorage: <TSession extends VoiceSessionRecord = VoiceSessionRecord, TReview extends StoredVoiceCallReviewArtifact = StoredVoiceCallReviewArtifact, TTask extends StoredVoiceOpsTask = StoredVoiceOpsTask, TEvent extends StoredVoiceIntegrationEvent = StoredVoiceIntegrationEvent, TMapping extends StoredVoiceExternalObjectMap = StoredVoiceExternalObjectMap, TTrace extends StoredVoiceTraceEvent = StoredVoiceTraceEvent, TTraceDelivery extends VoiceTraceSinkDeliveryRecord = VoiceTraceSinkDeliveryRecord>(options: VoicePostgresStoreOptions) => VoicePostgresRuntimeStorage<TSession, TReview, TTask, TEvent, TMapping, TTrace, TTraceDelivery>;
+export declare const createVoicePostgresAuditEventStore: <TEvent extends StoredVoiceAuditEvent = StoredVoiceAuditEvent>(options: VoicePostgresStoreOptions) => VoiceAuditEventStore<TEvent>;
+export declare const createVoicePostgresAuditSinkDeliveryStore: <TDelivery extends VoiceAuditSinkDeliveryRecord = VoiceAuditSinkDeliveryRecord>(options: VoicePostgresStoreOptions) => VoiceAuditSinkDeliveryStore<TDelivery>;
+export declare const createVoicePostgresTelephonyWebhookIdempotencyStore: <TResult = unknown>(options: VoicePostgresStoreOptions) => VoiceTelephonyWebhookIdempotencyStore<TResult>;
+export declare const createVoicePostgresCampaignStore: (options: VoicePostgresStoreOptions) => VoiceCampaignStore;
+export declare const createVoicePostgresRuntimeStorage: <TSession extends VoiceSessionRecord = VoiceSessionRecord, TReview extends StoredVoiceCallReviewArtifact = StoredVoiceCallReviewArtifact, TTask extends StoredVoiceOpsTask = StoredVoiceOpsTask, TEvent extends StoredVoiceIntegrationEvent = StoredVoiceIntegrationEvent, TMapping extends StoredVoiceExternalObjectMap = StoredVoiceExternalObjectMap, TTrace extends StoredVoiceTraceEvent = StoredVoiceTraceEvent, TTraceDelivery extends VoiceTraceSinkDeliveryRecord = VoiceTraceSinkDeliveryRecord, TAudit extends StoredVoiceAuditEvent = StoredVoiceAuditEvent, TAuditDelivery extends VoiceAuditSinkDeliveryRecord = VoiceAuditSinkDeliveryRecord>(options: VoicePostgresStoreOptions) => VoicePostgresRuntimeStorage<TSession, TReview, TTask, TEvent, TMapping, TTrace, TTraceDelivery, TAudit, TAuditDelivery>;

package/dist/productionReadiness.d.ts

@@ -0,0 +1,227 @@
+import { Elysia } from 'elysia';
+import { type VoiceTelephonyCarrierMatrixInput } from './telephony/matrix';
+import type { VoiceTraceEventStore } from './trace';
+import type { VoiceTraceSinkDeliveryStore } from './trace';
+import type { VoiceAgentSquadContractReport } from './agentSquadContract';
+import type { VoiceProviderRoutingContractReport } from './providerRoutingContract';
+import type { VoicePhoneAgentProductionSmokeReport } from './phoneAgentProductionSmoke';
+import type { VoiceAuditEventStore, VoiceAuditEventType, VoiceAuditOutcome } from './audit';
+import { type VoiceAuditSinkDeliveryStore } from './auditSinks';
+export type VoiceProductionReadinessStatus = 'fail' | 'pass' | 'warn';
+export type VoiceProductionReadinessAction = {
+    description?: string;
+    href: string;
+    label: string;
+    method?: 'GET' | 'POST';
+};
+export type VoiceProductionReadinessCheck = {
+    actions?: VoiceProductionReadinessAction[];
+    detail?: string;
+    href?: string;
+    label: string;
+    status: VoiceProductionReadinessStatus;
+    value?: number | string;
+};
+export type VoiceProductionReadinessReport = {
+    checkedAt: number;
+    checks: VoiceProductionReadinessCheck[];
+    links: {
+        agentSquadContracts?: string;
+        audit?: string;
+        auditDeliveries?: string;
+        carriers?: string;
+        handoffs?: string;
+        handoffRetry?: string;
+        liveLatency?: string;
+        phoneAgentSmoke?: string;
+        providerRoutingContracts?: string;
+        quality?: string;
+        resilience?: string;
+        sessions?: string;
+        traceDeliveries?: string;
+    };
+    status: VoiceProductionReadinessStatus;
+    summary: {
+        agentSquadContracts?: {
+            failed: number;
+            passed: number;
+            status: VoiceProductionReadinessStatus;
+            total: number;
+        };
+        audit?: VoiceProductionReadinessAuditSummary;
+        auditDeliveries?: VoiceProductionReadinessAuditDeliverySummary;
+        carriers?: {
+            failing: number;
+            providers: number;
+            ready: number;
+            status: VoiceProductionReadinessStatus;
+            warnings: number;
+        };
+        handoffs: {
+            failed: number;
+            total: number;
+        };
+        liveLatency: {
+            averageLatencyMs?: number;
+            failed: number;
+            status: VoiceProductionReadinessStatus;
+            total: number;
+            warnings: number;
+        };
+        providers: {
+            degraded: number;
+            total: number;
+        };
+        phoneAgentSmokes?: {
+            failed: number;
+            passed: number;
+            status: VoiceProductionReadinessStatus;
+            total: number;
+        };
+        providerRoutingContracts?: {
+            failed: number;
+            passed: number;
+            status: VoiceProductionReadinessStatus;
+            total: number;
+        };
+        quality: {
+            status: 'fail' | 'pass';
+        };
+        routing: {
+            events: number;
+            sessions: number;
+        };
+        sessions: {
+            failed: number;
+            total: number;
+        };
+        traceDeliveries?: VoiceProductionReadinessTraceDeliverySummary;
+    };
+};
+export type VoiceProductionReadinessAuditRequirement = {
+    label?: string;
+    maxAgeMs?: number;
+    outcomes?: VoiceAuditOutcome[];
+    status?: VoiceProductionReadinessStatus;
+    type: VoiceAuditEventType;
+};
+export type VoiceProductionReadinessAuditSummary = {
+    events: number;
+    missing: VoiceProductionReadinessAuditRequirement[];
+    present: Record<VoiceAuditEventType, number>;
+    required: VoiceProductionReadinessAuditRequirement[];
+    status: VoiceProductionReadinessStatus;
+};
+export type VoiceProductionReadinessAuditDeliverySummary = {
+    deadLettered: number;
+    delivered: number;
+    failed: number;
+    failPendingAfterMs: number;
+    pending: number;
+    retryEligible: number;
+    skipped: number;
+    staleFailing: number;
+    staleWarning: number;
+    status: VoiceProductionReadinessStatus;
+    total: number;
+    warnPendingAfterMs: number;
+};
+export type VoiceProductionReadinessTraceDeliverySummary = {
+    deadLettered: number;
+    delivered: number;
+    failed: number;
+    failPendingAfterMs: number;
+    pending: number;
+    retryEligible: number;
+    skipped: number;
+    staleFailing: number;
+    staleWarning: number;
+    status: VoiceProductionReadinessStatus;
+    total: number;
+    warnPendingAfterMs: number;
+};
+export type VoiceProductionReadinessAuditOptions = VoiceAuditEventStore | {
+    require?: readonly (VoiceAuditEventType | VoiceProductionReadinessAuditRequirement)[];
+    store: VoiceAuditEventStore;
+};
+export type VoiceProductionReadinessAuditDeliveryOptions = VoiceAuditSinkDeliveryStore | {
+    deadLetters?: VoiceAuditSinkDeliveryStore;
+    failPendingAfterMs?: number;
+    store: VoiceAuditSinkDeliveryStore;
+    warnPendingAfterMs?: number;
+};
+export type VoiceProductionReadinessTraceDeliveryOptions = VoiceTraceSinkDeliveryStore | {
+    deadLetters?: VoiceTraceSinkDeliveryStore;
+    failPendingAfterMs?: number;
+    store: VoiceTraceSinkDeliveryStore;
+    warnPendingAfterMs?: number;
+};
+export type VoiceProductionReadinessRoutesOptions = {
+    agentSquadContracts?: false | readonly VoiceAgentSquadContractReport[] | ((input: {
+        query: Record<string, unknown>;
+        request: Request;
+    }) => Promise<readonly VoiceAgentSquadContractReport[]> | readonly VoiceAgentSquadContractReport[]);
+    audit?: false | VoiceProductionReadinessAuditOptions;
+    auditDeliveries?: false | VoiceProductionReadinessAuditDeliveryOptions;
+    carriers?: false | readonly VoiceTelephonyCarrierMatrixInput[] | ((input: {
+        query: Record<string, unknown>;
+        request: Request;
+    }) => Promise<readonly VoiceTelephonyCarrierMatrixInput[]> | readonly VoiceTelephonyCarrierMatrixInput[]);
+    headers?: HeadersInit;
+    htmlPath?: false | string;
+    links?: VoiceProductionReadinessReport['links'];
+    llmProviders?: readonly string[];
+    name?: string;
+    path?: string;
+    phoneAgentSmokes?: false | readonly VoicePhoneAgentProductionSmokeReport[] | ((input: {
+        query: Record<string, unknown>;
+        request: Request;
+    }) => Promise<readonly VoicePhoneAgentProductionSmokeReport[]> | readonly VoicePhoneAgentProductionSmokeReport[]);
+    providerRoutingContracts?: false | readonly VoiceProviderRoutingContractReport[] | ((input: {
+        query: Record<string, unknown>;
+        request: Request;
+    }) => Promise<readonly VoiceProviderRoutingContractReport[]> | readonly VoiceProviderRoutingContractReport[]);
+    render?: (report: VoiceProductionReadinessReport) => string | Promise<string>;
+    store: VoiceTraceEventStore;
+    sttProviders?: readonly string[];
+    title?: string;
+    traceDeliveries?: false | VoiceProductionReadinessTraceDeliveryOptions;
+    ttsProviders?: readonly string[];
+    liveLatencyWarnAfterMs?: number;
+    liveLatencyFailAfterMs?: number;
+};
+export declare const buildVoiceProductionReadinessReport: (options: VoiceProductionReadinessRoutesOptions, input?: {
+    query?: Record<string, unknown>;
+    request?: Request;
+}) => Promise<VoiceProductionReadinessReport>;
+export declare const renderVoiceProductionReadinessHTML: (report: VoiceProductionReadinessReport, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceProductionReadinessRoutes: (options: VoiceProductionReadinessRoutesOptions) => 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/providerAdapters.d.ts

@@ -0,0 +1,48 @@
+import type { STTAdapter, STTAdapterOpenOptions, TTSAdapter, TTSAdapterOpenOptions } from './types';
+import type { VoiceProviderRouterHealthOptions, VoiceProviderRouterProviderHealth, VoiceProviderRouterProviderProfile, VoiceProviderRouterPolicyPreset, VoiceProviderRouterPolicyWeights, VoiceProviderRouterStrategy } from './modelAdapters';
+type MaybePromise<T> = T | Promise<T>;
+type VoiceIOProviderKind = 'stt' | 'tts';
+type VoiceIOProviderStatus = 'error' | 'fallback' | 'success';
+export type VoiceIOProviderRouterEvent<TProvider extends string = string> = {
+    at: number;
+    attempt: number;
+    elapsedMs: number;
+    error?: string;
+    fallbackProvider?: TProvider;
+    kind: VoiceIOProviderKind;
+    latencyBudgetMs?: number;
+    operation: 'open' | 'send';
+    provider: TProvider;
+    providerHealth?: VoiceProviderRouterProviderHealth<TProvider>;
+    selectedProvider: TProvider;
+    status: VoiceIOProviderStatus;
+    suppressionRemainingMs?: number;
+    suppressedUntil?: number;
+    timedOut?: boolean;
+};
+export type VoiceIOProviderRouterPolicyConfig<TOpenOptions = unknown, TProvider extends string = string> = {
+    allowProviders?: readonly TProvider[] | ((input: TOpenOptions) => MaybePromise<readonly TProvider[]>);
+    maxCost?: number;
+    maxLatencyMs?: number;
+    minQuality?: number;
+    scoreProvider?: (provider: TProvider, profile: VoiceProviderRouterProviderProfile | undefined) => number;
+    strategy?: VoiceProviderRouterStrategy;
+    weights?: VoiceProviderRouterPolicyWeights;
+};
+export type VoiceIOProviderRouterPolicy<TOpenOptions = unknown, TProvider extends string = string> = VoiceProviderRouterStrategy | VoiceProviderRouterPolicyPreset | VoiceIOProviderRouterPolicyConfig<TOpenOptions, TProvider>;
+export type VoiceIOProviderRouterOptions<TProvider extends string, TAdapter, TOpenOptions> = {
+    adapters: Partial<Record<TProvider, TAdapter>>;
+    fallback?: readonly TProvider[] | ((input: TOpenOptions) => MaybePromise<readonly TProvider[]>);
+    isProviderError?: (error: unknown, provider: TProvider) => boolean;
+    onProviderEvent?: (event: VoiceIOProviderRouterEvent<TProvider>, input: TOpenOptions) => Promise<void> | void;
+    policy?: VoiceIOProviderRouterPolicy<TOpenOptions, TProvider>;
+    providerHealth?: boolean | VoiceProviderRouterHealthOptions;
+    providerProfiles?: Partial<Record<TProvider, VoiceProviderRouterProviderProfile>>;
+    selectProvider?: (input: TOpenOptions) => MaybePromise<TProvider | undefined>;
+    timeoutMs?: number;
+};
+export type VoiceSTTProviderRouterOptions<TProvider extends string = string, TOptions extends STTAdapterOpenOptions = STTAdapterOpenOptions> = VoiceIOProviderRouterOptions<TProvider, STTAdapter<TOptions>, TOptions>;
+export type VoiceTTSProviderRouterOptions<TProvider extends string = string, TOptions extends TTSAdapterOpenOptions = TTSAdapterOpenOptions> = VoiceIOProviderRouterOptions<TProvider, TTSAdapter<TOptions>, TOptions>;
+export declare const createVoiceSTTProviderRouter: <TProvider extends string = string, TOptions extends STTAdapterOpenOptions = STTAdapterOpenOptions>(options: VoiceSTTProviderRouterOptions<TProvider, TOptions>) => STTAdapter<TOptions>;
+export declare const createVoiceTTSProviderRouter: <TProvider extends string = string, TOptions extends TTSAdapterOpenOptions = TTSAdapterOpenOptions>(options: VoiceTTSProviderRouterOptions<TProvider, TOptions>) => TTSAdapter<TOptions>;
+export {};

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/providerRoutingContract.d.ts

@@ -0,0 +1,38 @@
+import { type VoiceRoutingEvent, type VoiceRoutingEventKind } from './resilienceRoutes';
+import type { StoredVoiceTraceEvent, VoiceTraceEventStore } from './trace';
+export type VoiceProviderRoutingStatus = 'error' | 'fallback' | 'success';
+export type VoiceProviderRoutingExpectation = {
+    fallbackProvider?: string;
+    kind?: VoiceRoutingEventKind;
+    operation?: string;
+    provider?: string;
+    selectedProvider?: string;
+    status?: VoiceProviderRoutingStatus;
+};
+export type VoiceProviderRoutingContractDefinition = {
+    description?: string;
+    expect: VoiceProviderRoutingExpectation[];
+    id: string;
+    label?: string;
+    scenarioId?: string;
+    sessionId?: string;
+};
+export type VoiceProviderRoutingContractIssue = {
+    code: string;
+    message: string;
+};
+export type VoiceProviderRoutingContractReport = {
+    contractId: string;
+    events: VoiceRoutingEvent[];
+    issues: VoiceProviderRoutingContractIssue[];
+    pass: boolean;
+    scenarioId?: string;
+    sessionId?: string;
+};
+export type VoiceProviderRoutingContractRunOptions = {
+    contract: VoiceProviderRoutingContractDefinition;
+    events?: StoredVoiceTraceEvent[] | VoiceRoutingEvent[];
+    store?: VoiceTraceEventStore;
+};
+export declare const runVoiceProviderRoutingContract: (options: VoiceProviderRoutingContractRunOptions) => Promise<VoiceProviderRoutingContractReport>;
+export declare const assertVoiceProviderRoutingContract: (options: VoiceProviderRoutingContractRunOptions) => Promise<VoiceProviderRoutingContractReport>;