@absolutejs/voice 0.0.22-beta.292 → 0.0.22-beta.294

package/dist/productionReadiness.d.ts

@@ -15,6 +15,7 @@ import type { VoiceAuditEventStore, VoiceAuditEventType, VoiceAuditOutcome } fro
 import { type VoiceAuditSinkDeliveryStore } from './auditSinks';
 import type { VoiceProviderContractMatrixReport, VoiceProviderStackCapabilityGapReport } from './providerStackRecommendations';
 import { type VoiceProviderSloReport, type VoiceProviderSloReportOptions } from './providerSlo';
+import type { VoiceProviderOrchestrationReport } from './providerOrchestration';
 import type { VoiceCampaignReadinessProofReport } from './campaign';
 import { type VoiceOpsRecoveryReport } from './opsRecovery';
 import { type VoiceObservabilityExportDeliveryHistory, type VoiceObservabilityExportDeliveryReceiptStore, type VoiceObservabilityExportReplayReport, type VoiceObservabilityExportReplaySource, type VoiceObservabilityExportReport } from './observabilityExport';
@@ -136,6 +137,7 @@ export type VoiceProductionReadinessReport = {
         phoneAgentSmoke?: string;
         telephonyWebhookSecurity?: string;
         providerContracts?: string;
+        providerOrchestration?: string;
         providerRoutingContracts?: string;
         providerSlo?: string;
         quality?: string;
@@ -243,6 +245,15 @@ export type VoiceProductionReadinessReport = {
         };
         providerStack?: VoiceProviderStackCapabilityGapReport;
         providerContractMatrix?: VoiceProviderContractMatrixReport;
+        providerOrchestration?: {
+            failed: number;
+            issues: number;
+            passed: number;
+            providers: number;
+            status: VoiceProductionReadinessStatus;
+            surfaces: number;
+            warned: number;
+        };
         providerRecovery: VoiceProviderFallbackRecoverySummary;
         phoneAgentSmokes?: {
             failed: number;
@@ -469,6 +480,10 @@ export type VoiceProductionReadinessRoutesOptions = {
         query: Record<string, unknown>;
         request: Request;
     }) => Promise<VoiceProviderSloReport | VoiceProviderSloReportOptions> | VoiceProviderSloReport | VoiceProviderSloReportOptions);
+    providerOrchestration?: false | VoiceProviderOrchestrationReport | ((input: {
+        query: Record<string, unknown>;
+        request: Request;
+    }) => Promise<VoiceProviderOrchestrationReport> | VoiceProviderOrchestrationReport);
     providerStack?: false | VoiceProviderStackCapabilityGapReport | ((input: {
         query: Record<string, unknown>;
         request: Request;

package/dist/providerDecisionTraces.d.ts

@@ -0,0 +1,122 @@
+import { Elysia } from 'elysia';
+import { type VoiceRoutingEventKind } from './resilienceRoutes';
+import type { StoredVoiceTraceEvent, VoiceTraceEvent, VoiceTraceEventStore } from './trace';
+export type VoiceProviderDecisionStatus = 'error' | 'fallback' | 'selected' | 'skipped' | 'success';
+export type VoiceProviderDecisionTrace = {
+    at: number;
+    elapsedMs?: number;
+    error?: string;
+    fallbackProvider?: string;
+    kind?: VoiceRoutingEventKind;
+    latencyBudgetMs?: number;
+    provider: string;
+    reason: string;
+    scenarioId?: string;
+    selectedProvider?: string;
+    sessionId: string;
+    status: VoiceProviderDecisionStatus;
+    surface: string;
+    turnId?: string;
+};
+export type VoiceProviderDecisionTraceInput = Omit<VoiceProviderDecisionTrace, 'at' | 'reason' | 'sessionId' | 'surface'> & {
+    at?: number;
+    reason?: string;
+    sessionId?: string;
+    surface?: string;
+};
+export type VoiceProviderDecisionTraceIssue = {
+    code: string;
+    message: string;
+    status: 'fail' | 'warn';
+    surface?: string;
+};
+export type VoiceProviderDecisionSurfaceReport = {
+    decisions: number;
+    errors: number;
+    fallbacks: number;
+    issues: VoiceProviderDecisionTraceIssue[];
+    latestAt?: number;
+    providers: string[];
+    reasons: string[];
+    selected: number;
+    status: 'fail' | 'pass' | 'warn';
+    surface: string;
+};
+export type VoiceProviderDecisionTraceReport = {
+    checkedAt: number;
+    decisions: VoiceProviderDecisionTrace[];
+    issues: VoiceProviderDecisionTraceIssue[];
+    status: 'fail' | 'pass' | 'warn';
+    summary: {
+        decisions: number;
+        errors: number;
+        fallbacks: number;
+        providers: number;
+        selected: number;
+        surfaces: number;
+    };
+    surfaces: VoiceProviderDecisionSurfaceReport[];
+};
+export type VoiceProviderDecisionTraceReportOptions = {
+    events?: StoredVoiceTraceEvent[] | VoiceProviderDecisionTrace[];
+    maxAgeMs?: number;
+    minDecisions?: number;
+    now?: number;
+    requiredSurfaces?: readonly string[];
+    sessionId?: string;
+    store?: VoiceTraceEventStore;
+};
+export type VoiceProviderDecisionTraceRoutesOptions = VoiceProviderDecisionTraceReportOptions & {
+    headers?: HeadersInit;
+    htmlPath?: false | string;
+    markdownPath?: false | string;
+    name?: string;
+    path?: string;
+    render?: (report: VoiceProviderDecisionTraceReport) => string | Promise<string>;
+    title?: string;
+};
+export declare const createVoiceProviderDecisionTraceEvent: (input: VoiceProviderDecisionTraceInput) => VoiceTraceEvent;
+export declare const listVoiceProviderDecisionTraces: (events: StoredVoiceTraceEvent[] | VoiceProviderDecisionTrace[]) => VoiceProviderDecisionTrace[];
+export declare const buildVoiceProviderDecisionTraceReport: (options: VoiceProviderDecisionTraceReportOptions) => Promise<VoiceProviderDecisionTraceReport>;
+export declare const renderVoiceProviderDecisionTraceMarkdown: (report: VoiceProviderDecisionTraceReport) => string;
+export declare const renderVoiceProviderDecisionTraceHTML: (report: VoiceProviderDecisionTraceReport, title?: string) => string;
+export declare const createVoiceProviderDecisionTraceRoutes: (options: VoiceProviderDecisionTraceRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    [x: string]: {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: Response;
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/providerOrchestration.d.ts

@@ -0,0 +1,109 @@
+import { Elysia } from 'elysia';
+import type { VoiceProviderOrchestrationProfile, VoiceProviderRouterProviderProfile } from './modelAdapters';
+import type { VoiceSessionRecord } from './types';
+export type VoiceProviderOrchestrationStatus = 'fail' | 'pass' | 'warn';
+export type VoiceProviderOrchestrationRequirement = {
+    minProviders?: number;
+    requireBudgetPolicy?: boolean;
+    requireCircuitBreaker?: boolean;
+    requireFallback?: boolean;
+    requireTimeoutBudget?: boolean;
+};
+export type VoiceProviderOrchestrationIssue = {
+    code: string;
+    message: string;
+    status: Exclude<VoiceProviderOrchestrationStatus, 'pass'>;
+    surface?: string;
+};
+export type VoiceProviderOrchestrationSurfaceReport = {
+    allowProviders: string[];
+    budgetPolicy: {
+        maxCost?: number;
+        maxLatencyMs?: number;
+        minQuality?: number;
+    };
+    circuitBreaker: boolean;
+    fallbackMode?: string;
+    fallbackProviders: string[];
+    issues: VoiceProviderOrchestrationIssue[];
+    providerProfiles: Record<string, VoiceProviderRouterProviderProfile>;
+    providers: string[];
+    status: VoiceProviderOrchestrationStatus;
+    strategy?: string;
+    surface: string;
+    timeoutBudget: boolean;
+    timeoutMs?: number;
+};
+export type VoiceProviderOrchestrationReport = {
+    checkedAt: number;
+    issues: VoiceProviderOrchestrationIssue[];
+    profileId: string;
+    status: VoiceProviderOrchestrationStatus;
+    summary: {
+        failed: number;
+        passed: number;
+        providers: number;
+        surfaces: number;
+        warned: number;
+    };
+    surfaces: VoiceProviderOrchestrationSurfaceReport[];
+};
+export type VoiceProviderOrchestrationReportOptions<TProvider extends string = string, TSurface extends string = string> = {
+    defaultRequirement?: VoiceProviderOrchestrationRequirement;
+    profile: VoiceProviderOrchestrationProfile<unknown, VoiceSessionRecord, TProvider, TSurface>;
+    requirements?: Partial<Record<TSurface, VoiceProviderOrchestrationRequirement>>;
+};
+export type VoiceProviderOrchestrationRoutesOptions<TProvider extends string = string, TSurface extends string = string> = VoiceProviderOrchestrationReportOptions<TProvider, TSurface> & {
+    headers?: HeadersInit;
+    htmlPath?: false | string;
+    markdownPath?: false | string;
+    name?: string;
+    path?: string;
+    render?: (report: VoiceProviderOrchestrationReport) => string | Promise<string>;
+    title?: string;
+};
+export declare const buildVoiceProviderOrchestrationReport: <TProvider extends string = string, TSurface extends string = string>(options: VoiceProviderOrchestrationReportOptions<TProvider, TSurface>) => VoiceProviderOrchestrationReport;
+export declare const renderVoiceProviderOrchestrationMarkdown: (report: VoiceProviderOrchestrationReport) => string;
+export declare const renderVoiceProviderOrchestrationHTML: (report: VoiceProviderOrchestrationReport, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceProviderOrchestrationRoutes: <TProvider extends string = string, TSurface extends string = string>(options: VoiceProviderOrchestrationRoutesOptions<TProvider, TSurface>) => 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: VoiceProviderOrchestrationReport;
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/trace.d.ts

@@ -1,5 +1,5 @@
 import type { S3Client, S3Options } from 'bun';
-export type VoiceTraceEventType = 'assistant.guardrail' | 'assistant.memory' | 'assistant.run' | 'agent.context' | 'agent.handoff' | 'agent.model' | 'agent.result' | 'agent.tool' | 'call.handoff' | 'call.lifecycle' | 'client.barge_in' | 'client.live_latency' | 'client.reconnect' | 'operator.action' | 'session.error' | 'turn.assistant' | 'turn.committed' | 'turn.cost' | 'turn_latency.stage' | 'turn.transcript' | 'workflow.contract';
+export type VoiceTraceEventType = 'assistant.guardrail' | 'assistant.memory' | 'assistant.run' | 'agent.context' | 'agent.handoff' | 'agent.model' | 'agent.result' | 'agent.tool' | 'call.handoff' | 'call.lifecycle' | 'client.barge_in' | 'client.live_latency' | 'client.reconnect' | 'operator.action' | 'provider.decision' | 'session.error' | 'turn.assistant' | 'turn.committed' | 'turn.cost' | 'turn_latency.stage' | 'turn.transcript' | 'workflow.contract';
 export type VoiceTraceEvent<TPayload extends Record<string, unknown> = Record<string, unknown>> = {
     at: number;
     id?: string;

package/dist/vue/useVoiceReadinessFailures.d.ts

@@ -56,6 +56,7 @@ export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceR
             readonly phoneAgentSmoke?: string | undefined;
             readonly telephonyWebhookSecurity?: string | undefined;
             readonly providerContracts?: string | undefined;
+            readonly providerOrchestration?: string | undefined;
             readonly providerRoutingContracts?: string | undefined;
             readonly providerSlo?: string | undefined;
             readonly quality?: string | undefined;
@@ -310,6 +311,15 @@ export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceR
                 readonly total: number;
                 readonly warned: number;
             } | undefined;
+            readonly providerOrchestration?: {
+                readonly failed: number;
+                readonly issues: number;
+                readonly passed: number;
+                readonly providers: number;
+                readonly status: import("..").VoiceProductionReadinessStatus;
+                readonly surfaces: number;
+                readonly warned: number;
+            } | undefined;
             readonly providerRecovery: {
                 readonly recovered: number;
                 readonly recoveredSessions: number;
@@ -429,6 +439,7 @@ export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceR
             readonly phoneAgentSmoke?: string | undefined;
             readonly telephonyWebhookSecurity?: string | undefined;
             readonly providerContracts?: string | undefined;
+            readonly providerOrchestration?: string | undefined;
             readonly providerRoutingContracts?: string | undefined;
             readonly providerSlo?: string | undefined;
             readonly quality?: string | undefined;
@@ -683,6 +694,15 @@ export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceR
                 readonly total: number;
                 readonly warned: number;
             } | undefined;
+            readonly providerOrchestration?: {
+                readonly failed: number;
+                readonly issues: number;
+                readonly passed: number;
+                readonly providers: number;
+                readonly status: import("..").VoiceProductionReadinessStatus;
+                readonly surfaces: number;
+                readonly warned: number;
+            } | undefined;
             readonly providerRecovery: {
                 readonly recovered: number;
                 readonly recoveredSessions: number;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@absolutejs/voice",
-	"version": "0.0.22-beta.292",
+	"version": "0.0.22-beta.294",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",