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

package/dist/core/mediaPipelineSurfaces.d.ts

@@ -0,0 +1,48 @@
+import { type MediaProcessorGraphSummary, type MediaQualitySummary, type MediaTransportSummary } from "@absolutejs/media";
+import type { VoiceIncidentTimelineEvent } from "./incidentTimeline";
+import type { VoiceMediaPipelineReport } from "./mediaPipelineRoutes";
+import type { VoiceProductionReadinessCheck } from "./productionReadiness";
+export type VoiceMediaPipelineIssueSource = "calibration" | "interruption" | "processor-graph" | "quality" | "transport";
+export type VoiceMediaPipelineIssueEntry = {
+    code: string;
+    message: string;
+    severity: "error" | "warning";
+    source: VoiceMediaPipelineIssueSource;
+    surface: string;
+};
+export declare const extractVoiceMediaPipelineIssueEntries: (report: VoiceMediaPipelineReport) => readonly VoiceMediaPipelineIssueEntry[];
+export type VoiceMediaPipelineReadinessOptions = {
+    baseHref?: string;
+    label?: string;
+};
+export declare const buildVoiceMediaPipelineReadinessChecks: (report: VoiceMediaPipelineReport, options?: VoiceMediaPipelineReadinessOptions) => readonly VoiceProductionReadinessCheck[];
+export type VoiceMediaPipelineIncidentOptions = {
+    baseHref?: string;
+    category?: VoiceIncidentTimelineEvent["category"];
+    now?: () => number;
+    source?: string;
+};
+export declare const buildVoiceMediaPipelineIncidentEvents: (report: VoiceMediaPipelineReport, options?: VoiceMediaPipelineIncidentOptions) => readonly VoiceIncidentTimelineEvent[];
+export type VoiceMediaPipelineArtifactKind = "processor-graph" | "quality" | "transport";
+export type VoiceMediaPipelineArtifactRecord = {
+    href?: string;
+    jsonPath: string;
+    kind: VoiceMediaPipelineArtifactKind;
+    markdownPath: string;
+    summary: MediaProcessorGraphSummary | MediaQualitySummary | MediaTransportSummary;
+};
+export type VoiceMediaPipelineArtifactWriteOptions = {
+    dir: string;
+    hrefBase?: string;
+    report: VoiceMediaPipelineReport;
+    slugPrefix?: string;
+};
+export type VoiceMediaPipelineArtifactWriteResult = {
+    artifacts: VoiceMediaPipelineArtifactRecord[];
+    hrefs: {
+        processorGraph?: string;
+        quality?: string;
+        transport?: string;
+    };
+};
+export declare const writeVoiceMediaPipelineArtifacts: (options: VoiceMediaPipelineArtifactWriteOptions) => Promise<VoiceMediaPipelineArtifactWriteResult>;

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

@@ -1,2 +1,2 @@
-import type { VoiceSessionRecord, VoiceSessionStore } from './types';
+import type { VoiceSessionRecord, VoiceSessionStore } from "./types";
 export declare const createVoiceMemoryStore: <TSession extends VoiceSessionRecord = VoiceSessionRecord>() => VoiceSessionStore<TSession>;

package/dist/core/midCallSummary.d.ts

@@ -0,0 +1,27 @@
+import type { VoiceSessionRecord, VoiceTurnRecord } from "./types";
+import type { VoiceLLMJudgeCompletion } from "./llmJudge";
+type MidCallSummary = {
+    generatedAt: number;
+    summary: string;
+    topicalShift?: boolean;
+    turnCount: number;
+};
+export type CreateMidCallSummarizerOptions = {
+    completion: VoiceLLMJudgeCompletion;
+    /** Force a summary every N turns. Default 6. */
+    everyTurns?: number;
+    /** Force a summary at most every M ms. Default 60_000. */
+    minIntervalMs?: number;
+    /** Maximum chars to include in the system prompt. Default 600. */
+    summaryMaxChars?: number;
+    systemPrompt?: string;
+};
+export type MidCallSummarizer = {
+    evaluate: (input: {
+        session: VoiceSessionRecord;
+        turn?: VoiceTurnRecord;
+    }) => Promise<MidCallSummary | undefined>;
+    latest: () => MidCallSummary | undefined;
+};
+export declare const createMidCallSummarizer: (options: CreateMidCallSummarizerOptions) => MidCallSummarizer;
+export {};

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

@@ -1,5 +1,5 @@
-import type { VoiceAgentModel, VoiceAgentModelInput, VoiceAgentModelOutput } from './agent';
-import type { VoiceSessionRecord } from './types';
+import type { VoiceAgentModel, VoiceAgentModelInput, VoiceAgentModelOutput } from "./agent";
+import type { VoiceSessionRecord } from "./types";
 export type VoiceJSONAssistantModelHandler<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = (input: VoiceAgentModelInput<TContext, TSession>) => Promise<Record<string, unknown> | VoiceAgentModelOutput<TResult>> | Record<string, unknown> | VoiceAgentModelOutput<TResult>;
 export type VoiceJSONAssistantModelOptions<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = {
     generate: VoiceJSONAssistantModelHandler<TContext, TSession, TResult>;
@@ -48,21 +48,36 @@ export type VoiceProviderRouterEvent<TProvider extends string = string> = {
     selectedProvider: TProvider;
     suppressionRemainingMs?: number;
     suppressedUntil?: number;
-    status: 'error' | 'fallback' | 'success';
+    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 VoiceProviderRouterFallbackMode = "never" | "provider-error" | "rate-limit";
+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;
@@ -74,9 +89,44 @@ export type VoiceProviderRouterProviderHealth<TProvider extends string = string>
     lastFailureAt?: number;
     lastRateLimitedAt?: number;
     provider: TProvider;
-    status: 'healthy' | 'suppressed';
+    status: "healthy" | "suppressed";
     suppressedUntil?: number;
 };
+export type VoiceProviderOrchestrationSurface<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TProvider extends string = string> = {
+    allowProviders?: readonly TProvider[] | ((input: VoiceAgentModelInput<TContext, TSession>) => readonly TProvider[] | Promise<readonly TProvider[]>);
+    fallback?: readonly TProvider[] | ((input: VoiceAgentModelInput<TContext, TSession>) => readonly TProvider[] | Promise<readonly TProvider[]>);
+    fallbackMode?: VoiceProviderRouterFallbackMode;
+    maxCost?: number;
+    maxLatencyMs?: number;
+    minQuality?: number;
+    policy?: VoiceProviderRouterPolicy<TContext, TSession, TProvider>;
+    providerHealth?: boolean | VoiceProviderRouterHealthOptions;
+    providerProfiles?: Partial<Record<TProvider, VoiceProviderRouterProviderProfile>>;
+    strategy?: VoiceProviderRouterStrategy;
+    timeoutMs?: number;
+    weights?: VoiceProviderRouterPolicyWeights;
+};
+export type VoiceProviderOrchestrationProfile<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TProvider extends string = string, TSurface extends string = string> = {
+    defaultSurface?: TSurface;
+    id: string;
+    resolve: (surface?: TSurface) => VoiceProviderOrchestrationResolvedSurface<TContext, TSession, TProvider>;
+    surfaces: Record<TSurface, VoiceProviderOrchestrationSurface<TContext, TSession, TProvider>>;
+};
+export type VoiceProviderOrchestrationProfileOptions<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TProvider extends string = string, TSurface extends string = string> = {
+    defaultSurface?: TSurface;
+    id: string;
+    surfaces: Record<TSurface, VoiceProviderOrchestrationSurface<TContext, TSession, TProvider>>;
+};
+export type VoiceProviderOrchestrationResolvedSurface<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TProvider extends string = string> = {
+    allowProviders?: VoiceProviderOrchestrationSurface<TContext, TSession, TProvider>["allowProviders"];
+    fallback?: VoiceProviderOrchestrationSurface<TContext, TSession, TProvider>["fallback"];
+    fallbackMode?: VoiceProviderRouterFallbackMode;
+    policy?: VoiceProviderRouterPolicy<TContext, TSession, TProvider>;
+    providerHealth?: boolean | VoiceProviderRouterHealthOptions;
+    providerProfiles?: Partial<Record<TProvider, VoiceProviderRouterProviderProfile>>;
+    timeoutMs?: number;
+};
+export declare const createVoiceProviderOrchestrationProfile: <TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TProvider extends string = string, TSurface extends string = string>(options: VoiceProviderOrchestrationProfileOptions<TContext, TSession, TProvider, TSurface>) => VoiceProviderOrchestrationProfile<TContext, TSession, TProvider, TSurface>;
 export type VoiceProviderRouterOptions<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown, TProvider extends string = string> = {
     allowProviders?: readonly TProvider[] | ((input: VoiceAgentModelInput<TContext, TSession>) => readonly TProvider[] | Promise<readonly TProvider[]>);
     fallback?: TProvider[] | ((input: VoiceAgentModelInput<TContext, TSession>) => readonly TProvider[] | Promise<readonly TProvider[]>);
@@ -85,6 +135,8 @@ export type VoiceProviderRouterOptions<TContext = unknown, TSession extends Voic
     isRateLimitError?: (error: unknown, provider: TProvider) => boolean;
     isTimeoutError?: (error: unknown, provider: TProvider) => boolean;
     onProviderEvent?: (event: VoiceProviderRouterEvent<TProvider>, input: VoiceAgentModelInput<TContext, TSession>) => Promise<void> | void;
+    orchestrationProfile?: VoiceProviderOrchestrationProfile<TContext, TSession, TProvider>;
+    orchestrationSurface?: string;
     policy?: VoiceProviderRouterPolicy<TContext, TSession, TProvider>;
     providerHealth?: boolean | VoiceProviderRouterHealthOptions;
     providerProfiles?: Partial<Record<TProvider, VoiceProviderRouterProviderProfile>>;

package/dist/core/monitor.d.ts

@@ -0,0 +1,148 @@
+import { Elysia } from "elysia";
+import type { AudioFormat, VoiceMonitorRuntimeBinding, VoiceSessionHandle, VoiceSessionRecord } from "./types";
+export type VoiceMonitorAudioSource = "assistant" | "caller" | (string & {});
+export type VoiceMonitorAudioEvent = {
+    at: number;
+    chunk: Uint8Array;
+    format: AudioFormat;
+    source: VoiceMonitorAudioSource;
+};
+export type VoiceMonitorSessionRecord = {
+    handle: VoiceSessionHandle<unknown, VoiceSessionRecord, unknown>;
+    metadata?: Record<string, unknown>;
+    onAudio: (handler: (event: VoiceMonitorAudioEvent) => void) => () => void;
+    onClose: (handler: (reason?: string) => void) => () => void;
+    sessionId: string;
+};
+export type VoiceMonitorRegistry = {
+    get: (sessionId: string) => VoiceMonitorSessionRecord | undefined;
+    list: () => readonly {
+        sessionId: string;
+    }[];
+};
+export type VoiceMonitorMutableRegistry = VoiceMonitorRegistry & {
+    emit: (sessionId: string, event: VoiceMonitorAudioEvent) => void;
+    emitClose: (sessionId: string, reason?: string) => void;
+    /**
+     * Deregister a session by id. No-op if the id isn't registered. The
+     * `reason` flows into the close fan-out exactly once.
+     */
+    deregister: (sessionId: string, reason?: string) => void;
+    register: (record: VoiceMonitorSessionRecord) => (reason?: string) => void;
+};
+export type VoiceMonitorRegistryRegisterInput = {
+    handle: VoiceSessionHandle<unknown, VoiceSessionRecord, unknown>;
+    metadata?: Record<string, unknown>;
+    sessionId: string;
+};
+export declare const createVoiceInMemoryMonitorRegistry: () => VoiceMonitorMutableRegistry;
+export declare const createVoiceMonitorSession: (input: VoiceMonitorRegistryRegisterInput) => VoiceMonitorSessionRecord & {
+    emit: (event: VoiceMonitorAudioEvent) => void;
+    emitClose: (reason?: string) => void;
+};
+export type VoiceMonitorControlMessage = {
+    metadata?: Record<string, unknown>;
+    reason?: string;
+    target: string;
+    type: "transfer";
+} | {
+    reason?: string;
+    type: "hangup";
+} | {
+    metadata?: Record<string, unknown>;
+    reason?: string;
+    type: "escalate";
+} | {
+    metadata?: Record<string, unknown>;
+    type: "voicemail";
+} | {
+    metadata?: Record<string, unknown>;
+    type: "no-answer";
+} | {
+    muted: boolean;
+    target: "assistant" | "caller";
+    type: "mute";
+} | {
+    interrupt?: boolean;
+    text: string;
+    type: "say";
+} | {
+    role: "assistant" | "system" | "user";
+    text: string;
+    type: "inject";
+};
+export type VoiceMonitorControlAck = {
+    detail?: string;
+    ok: true;
+    type: VoiceMonitorControlMessage["type"];
+} | {
+    error: string;
+    ok: false;
+    type: VoiceMonitorControlMessage["type"];
+};
+export type VoiceMonitorControlHandlerInput = {
+    message: VoiceMonitorControlMessage;
+    raw: unknown;
+    session: VoiceMonitorSessionRecord;
+};
+export type VoiceMonitorControlHandler = (input: VoiceMonitorControlHandlerInput) => Promise<VoiceMonitorControlAck> | VoiceMonitorControlAck;
+export type VoiceMonitorAuthenticateInput = {
+    request: unknown;
+    route: "control" | "listen";
+    sessionId: string;
+};
+export type VoiceMonitorAuthenticate = (input: VoiceMonitorAuthenticateInput) => boolean | Promise<boolean>;
+export type VoiceLiveMonitorRoutesOptions = {
+    authenticate?: VoiceMonitorAuthenticate;
+    basePath?: string;
+    controlHandlers?: Partial<Record<VoiceMonitorControlMessage["type"], VoiceMonitorControlHandler>>;
+    controlPath?: false | string;
+    htmlPath?: false | string;
+    listenPath?: false | string;
+    registry: VoiceMonitorRegistry;
+};
+export type VoiceMonitorPlanInput = {
+    basePath?: string;
+    baseUrl: string;
+    controlPath?: string;
+    listenPath?: string;
+    sessionId: string;
+};
+export type VoiceMonitorPlan = {
+    controlUrl: string;
+    listenUrl: string;
+};
+export declare const buildVoiceMonitorPlan: (input: VoiceMonitorPlanInput) => VoiceMonitorPlan;
+export type VoiceMonitorRuntimeBindingOptions = {
+    audioFormat?: AudioFormat;
+    defaultSource?: VoiceMonitorAudioSource;
+};
+export declare const createVoiceMonitorRuntimeBinding: (registry: VoiceMonitorMutableRegistry, options?: VoiceMonitorRuntimeBindingOptions) => VoiceMonitorRuntimeBinding;
+export declare const createVoiceLiveMonitorRoutes: (options: VoiceLiveMonitorRoutesOptions) => 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/core/multilingualProof.d.ts

@@ -0,0 +1,77 @@
+import type { STTAdapter } from "./types";
+import { type VoiceTestFixture } from "../testing/fixtures";
+import { type VoiceSTTBenchmarkOptions, type VoiceSTTBenchmarkReport } from "../testing/benchmark";
+export type VoiceMultilingualLanguageCode = string;
+export type VoiceMultilingualProofLanguageThresholds = {
+    label?: string;
+    language: VoiceMultilingualLanguageCode;
+    maxAverageWordErrorRate?: number;
+    minAverageWordAccuracyRate?: number;
+    minPassRate?: number;
+    minTermRecall?: number;
+};
+export type VoiceMultilingualProofDefaultThresholds = Omit<VoiceMultilingualProofLanguageThresholds, "label" | "language">;
+export type VoiceMultilingualProofAdapterEntry = {
+    adapter: STTAdapter;
+    adapterId: string;
+    benchmarkOptions?: VoiceSTTBenchmarkOptions;
+};
+export type VoiceMultilingualProofOptions = {
+    adapters: readonly VoiceMultilingualProofAdapterEntry[];
+    defaultThresholds?: VoiceMultilingualProofDefaultThresholds;
+    filter?: (fixture: VoiceTestFixture) => boolean;
+    fixtureDirectories?: string | readonly string[];
+    fixtures?: readonly VoiceTestFixture[];
+    perLanguage?: readonly VoiceMultilingualProofLanguageThresholds[];
+};
+export type VoiceMultilingualProofLanguageMetrics = {
+    averageTermRecall: number;
+    averageWordAccuracyRate: number;
+    averageWordErrorRate: number;
+    fixtureCount: number;
+    passCount: number;
+    passRate: number;
+};
+export type VoiceMultilingualProofLanguageReport = {
+    applied: VoiceMultilingualProofLanguageThresholds;
+    failures: readonly string[];
+    fixtureIds: readonly string[];
+    label?: string;
+    language: VoiceMultilingualLanguageCode;
+    metrics: VoiceMultilingualProofLanguageMetrics;
+    passes: boolean;
+};
+export type VoiceMultilingualProofAdapterReport = {
+    adapterId: string;
+    benchmark: VoiceSTTBenchmarkReport;
+    failures: readonly string[];
+    fixtureCount: number;
+    languageReports: readonly VoiceMultilingualProofLanguageReport[];
+    overall: VoiceMultilingualProofLanguageMetrics;
+    passes: boolean;
+};
+export type VoiceMultilingualProofReport = {
+    adapters: readonly VoiceMultilingualProofAdapterReport[];
+    generatedAt: number;
+    passes: boolean;
+    summary: {
+        adapterCount: number;
+        failedAdapters: readonly string[];
+        fixtureCount: number;
+        languageCount: number;
+    };
+};
+export declare const renderVoiceMultilingualProofMarkdown: (report: VoiceMultilingualProofReport) => string;
+export declare const runVoiceMultilingualProof: (options: VoiceMultilingualProofOptions) => Promise<VoiceMultilingualProofReport>;
+export type VoiceMultilingualProofReadinessOptions = {
+    baseHref?: string;
+    label?: string;
+};
+export type VoiceMultilingualProofReadinessCheck = {
+    detail: string;
+    href?: string;
+    label: string;
+    status: "fail" | "pass" | "warn";
+    value?: number | string;
+};
+export declare const buildVoiceMultilingualProofReadinessCheck: (report: VoiceMultilingualProofReport, options?: VoiceMultilingualProofReadinessOptions) => VoiceMultilingualProofReadinessCheck;

package/dist/core/noShowPredictor.d.ts

@@ -0,0 +1,46 @@
+export type VoiceNoShowHistoricalRecord = {
+    appointmentId: string;
+    scheduledStartMs: number;
+    outcome: "kept" | "no-show" | "cancelled" | "rescheduled";
+};
+export type VoiceNoShowSignal = {
+    kind: "lead-time-hours";
+    value: number;
+} | {
+    kind: "weekday";
+    value: number;
+} | {
+    kind: "hour-of-day";
+    value: number;
+} | {
+    kind: "prior-no-show-count";
+    value: number;
+} | {
+    kind: "prior-kept-count";
+    value: number;
+} | {
+    kind: "reminder-confirmed";
+    value: boolean;
+} | {
+    kind: "callback-distance-hours";
+    value: number;
+} | {
+    kind: "weather-disruption";
+    value: boolean;
+};
+export type VoiceNoShowScoreInput = {
+    appointmentStartMs: number;
+    bookedAtMs: number;
+    history?: VoiceNoShowHistoricalRecord[];
+    reminderConfirmed?: boolean;
+    weatherDisruption?: boolean;
+    callbackDistanceHours?: number;
+    now?: () => number;
+};
+export type VoiceNoShowVerdict = {
+    score: number;
+    band: "low" | "moderate" | "high";
+    drivers: VoiceNoShowSignal[];
+};
+export declare const scoreVoiceNoShowRisk: (input: VoiceNoShowScoreInput) => VoiceNoShowVerdict;
+export declare const summarizeVoiceNoShowVerdict: (verdict: VoiceNoShowVerdict) => string;

package/dist/core/oauth2TokenSource.d.ts

@@ -0,0 +1,21 @@
+export type VoiceOAuth2TokenResponse = {
+    access_token: string;
+    expires_in?: number;
+    token_type?: string;
+};
+export type VoiceOAuth2TokenSource = {
+    invalidate: () => void;
+    token: () => Promise<string>;
+};
+export type CreateVoiceOAuth2TokenSourceOptions = {
+    audience?: string;
+    clientId: string;
+    clientSecret: string;
+    fetch?: typeof fetch;
+    grantType?: "client_credentials";
+    /** seconds remaining before expiry to refresh proactively, default 60 */
+    refreshSkewSeconds?: number;
+    scope?: string;
+    tokenUrl: string;
+};
+export declare const createVoiceOAuth2TokenSource: (options: CreateVoiceOAuth2TokenSourceOptions) => VoiceOAuth2TokenSource;