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

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/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/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.293",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",