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

package/dist/client/readinessFailures.d.ts

@@ -0,0 +1,19 @@
+import type { VoiceProductionReadinessReport } from '../productionReadiness';
+export type VoiceReadinessFailuresClientOptions = {
+    fetch?: typeof fetch;
+    intervalMs?: number;
+};
+export type VoiceReadinessFailuresSnapshot = {
+    error: string | null;
+    isLoading: boolean;
+    report?: VoiceProductionReadinessReport;
+    updatedAt?: number;
+};
+export declare const fetchVoiceReadinessFailures: (path?: string, options?: Pick<VoiceReadinessFailuresClientOptions, "fetch">) => Promise<VoiceProductionReadinessReport>;
+export declare const createVoiceReadinessFailuresStore: (path?: string, options?: VoiceReadinessFailuresClientOptions) => {
+    close: () => void;
+    getServerSnapshot: () => VoiceReadinessFailuresSnapshot;
+    getSnapshot: () => VoiceReadinessFailuresSnapshot;
+    refresh: () => Promise<VoiceProductionReadinessReport | undefined>;
+    subscribe: (listener: () => void) => () => void;
+};

package/dist/client/readinessFailuresWidget.d.ts

@@ -0,0 +1,42 @@
+import type { VoiceProductionReadinessCheck } from '../productionReadiness';
+import { type VoiceReadinessFailuresClientOptions, type VoiceReadinessFailuresSnapshot } from './readinessFailures';
+export type VoiceReadinessFailureView = {
+    evidenceHref?: string;
+    label: string;
+    observed: string;
+    remediation: string;
+    sourceHref?: string;
+    status: VoiceProductionReadinessCheck['status'];
+    threshold: string;
+    thresholdLabel: string;
+};
+export type VoiceReadinessFailuresViewModel = {
+    description: string;
+    error: string | null;
+    failures: VoiceReadinessFailureView[];
+    isLoading: boolean;
+    label: string;
+    links: Array<{
+        href: string;
+        label: string;
+    }>;
+    status: 'empty' | 'error' | 'loading' | 'ready' | 'warning';
+    title: string;
+    updatedAt?: number;
+};
+export type VoiceReadinessFailuresWidgetOptions = VoiceReadinessFailuresClientOptions & {
+    description?: string;
+    links?: Array<{
+        href: string;
+        label: string;
+    }>;
+    title?: string;
+};
+export declare const createVoiceReadinessFailuresViewModel: (snapshot: VoiceReadinessFailuresSnapshot, options?: VoiceReadinessFailuresWidgetOptions) => VoiceReadinessFailuresViewModel;
+export declare const renderVoiceReadinessFailuresHTML: (snapshot: VoiceReadinessFailuresSnapshot, options?: VoiceReadinessFailuresWidgetOptions) => string;
+export declare const getVoiceReadinessFailuresCSS: () => string;
+export declare const mountVoiceReadinessFailures: (element: Element, path?: string, options?: VoiceReadinessFailuresWidgetOptions) => {
+    close: () => void;
+    refresh: () => Promise<import("..").VoiceProductionReadinessReport | undefined>;
+};
+export declare const defineVoiceReadinessFailuresElement: (tagName?: string) => void;

package/dist/index.d.ts

@@ -46,7 +46,7 @@ export { applyVoiceTelephonyOutcome, assertVoiceTelephonyWebhookNormalizationEvi
 export { assertVoicePhoneCallControlEvidence, assertVoicePhoneAssistantEvidence, createVoicePhoneAgent, evaluateVoicePhoneCallControlEvidence, evaluateVoicePhoneAssistantEvidence } from './phoneAgent';
 export { createStoredVoiceCallReviewArtifact, createStoredVoiceExternalObjectMap, createStoredVoiceIntegrationEvent, createStoredVoiceOpsTask, createVoiceFileIncidentBundleStore, createVoiceFileExternalObjectMapStore, createVoiceFileAssistantMemoryStore, createVoiceFileAuditEventStore, createVoiceFileAuditSinkDeliveryStore, createVoiceFileCampaignStore, createVoiceFileIntegrationEventStore, createVoiceFileReviewStore, createVoiceFileRuntimeStorage, createVoiceFileSessionStore, createVoiceFileTaskStore, createVoiceFileTraceSinkDeliveryStore, createVoiceFileTraceEventStore } from './fileStore';
 export { createVoiceAssistantMemoryHandle, createVoiceAssistantMemoryRecord, createVoiceMemoryAssistantMemoryStore, resolveVoiceAssistantMemoryNamespace } from './assistantMemory';
-export { createAnthropicVoiceAssistantModel, createGeminiVoiceAssistantModel, createJSONVoiceAssistantModel, createOpenAIVoiceAssistantModel, resolveVoiceProviderRoutingPolicyPreset, createVoiceProviderRouter } from './modelAdapters';
+export { createAnthropicVoiceAssistantModel, createGeminiVoiceAssistantModel, createJSONVoiceAssistantModel, createOpenAIVoiceAssistantModel, createVoiceProviderOrchestrationProfile, resolveVoiceProviderRoutingPolicyPreset, createVoiceProviderRouter } from './modelAdapters';
 export { createOpenAIRealtimeAdapter } from './openaiRealtime';
 export { createOpenAIVoiceTTS } from './openaiTTS';
 export { createVoiceProviderHealthHTMLHandler, createVoiceProviderHealthJSONHandler, createVoiceProviderHealthRoutes, renderVoiceProviderHealthHTML, summarizeVoiceProviderHealth } from './providerHealth';
@@ -106,7 +106,7 @@ export type { VoiceEvalBaselineComparison, VoiceEvalBaselineComparisonOptions, V
 export type { VoiceSimulationSuiteAssertionInput, VoiceSimulationSuiteAssertionReport, VoiceSimulationSuiteEvalRoutesOptions, VoiceSimulationSuiteOptions, VoiceSimulationSuiteReport, VoiceSimulationSuiteRoutesOptions, VoiceSimulationSuiteSection, VoiceSimulationSuiteSectionSummary, VoiceSimulationSuiteStatus } from './simulationSuite';
 export type { VoiceWorkflowContract, VoiceWorkflowContractDefinition, VoiceWorkflowContractField, VoiceWorkflowContractFieldMatch, VoiceWorkflowContractPresetName, VoiceWorkflowContractPresetOptions, VoiceWorkflowContractTracePayload, VoiceWorkflowContractValidation, VoiceWorkflowContractValidationIssue, VoiceWorkflowOutcome } from './workflowContract';
 export type { VoiceSessionListHTMLHandlerOptions, VoiceSessionListItem, VoiceSessionListOptions, VoiceSessionListRoutesOptions, VoiceSessionListStatus, VoiceProviderFallbackRecoverySummary, VoiceSessionReplay, VoiceSessionReplayHTMLHandlerOptions, VoiceSessionReplayOptions, VoiceSessionReplayRoutesOptions, VoiceSessionReplayTurn } from './sessionReplay';
-export type { AnthropicVoiceAssistantModelOptions, GeminiVoiceAssistantModelOptions, OpenAIVoiceAssistantModelOptions, VoiceProviderRouterEvent, VoiceProviderRouterFallbackMode, VoiceProviderRouterHealthOptions, VoiceProviderRouterOptions, VoiceProviderRouterPolicy, VoiceProviderRouterPolicyPreset, VoiceProviderRouterPolicyWeights, VoiceProviderRouterProviderHealth, VoiceProviderRouterProviderProfile, VoiceProviderRouterStrategy, VoiceJSONAssistantModelHandler, VoiceJSONAssistantModelOptions } from './modelAdapters';
+export type { AnthropicVoiceAssistantModelOptions, GeminiVoiceAssistantModelOptions, OpenAIVoiceAssistantModelOptions, VoiceProviderRouterEvent, VoiceProviderRouterFallbackMode, VoiceProviderRouterHealthOptions, VoiceProviderRouterOptions, VoiceProviderOrchestrationProfile, VoiceProviderOrchestrationProfileOptions, VoiceProviderOrchestrationResolvedSurface, VoiceProviderOrchestrationSurface, VoiceProviderRouterPolicy, VoiceProviderRouterPolicyPreset, VoiceProviderRouterPolicyWeights, VoiceProviderRouterProviderHealth, VoiceProviderRouterProviderProfile, VoiceProviderRouterStrategy, VoiceJSONAssistantModelHandler, VoiceJSONAssistantModelOptions } from './modelAdapters';
 export type { OpenAIVoiceTTSOptions, OpenAIVoiceTTSVoice } from './openaiTTS';
 export type { OpenAIRealtimeAdapterOptions, OpenAIRealtimeModel, OpenAIRealtimeNoiseReduction, OpenAIRealtimeResponseMode, OpenAIRealtimeTranscriptionModel, OpenAIRealtimeVoice } from './openaiRealtime';
 export type { VoiceProviderHealthStatus, VoiceProviderHealthSummary, VoiceProviderHealthSummaryOptions } from './providerHealth';
@@ -123,7 +123,7 @@ export type { VoicePhoneAgentCarrier, VoicePhoneAgentCarrierSummary, VoicePhoneA
 export type { VoicePhoneAgentProductionSmokeIssue, VoicePhoneAgentProductionSmokeHandlerOptions, VoicePhoneAgentProductionSmokeHTMLHandlerOptions, VoicePhoneAgentProductionSmokeOptions, VoicePhoneAgentProductionSmokeReport, VoicePhoneAgentProductionSmokeRoutesOptions, VoicePhoneAgentProductionSmokeRequirement } from './phoneAgentProductionSmoke';
 export type { VoiceOpsConsoleLink, VoiceOpsConsoleReport, VoiceOpsConsoleRoutesOptions } from './opsConsoleRoutes';
 export type { VoiceOpsStatus, VoiceOpsStatusLink, VoiceOpsStatusOptions, VoiceOpsStatusReport, VoiceOpsStatusRoutesOptions } from './opsStatus';
-export type { VoiceProductionReadinessAction, VoiceProductionReadinessAuditOptions, VoiceProductionReadinessAuditRequirement, VoiceProductionReadinessAuditSummary, VoiceProductionReadinessAssertionInput, VoiceProductionReadinessAssertionReport, VoiceProductionReadinessCheck, VoiceProductionReadinessGateIssue, VoiceProductionReadinessGateOptions, VoiceProductionReadinessGateProfile, VoiceProductionReadinessGateProfileSurface, VoiceProductionReadinessGateReport, VoiceProductionReadinessOpsActionHistoryOptions, VoiceProductionReadinessOpsActionHistorySummary, VoiceProductionReadinessOperationsRecordLink, VoiceProductionReadinessOperationsRecordLinks, VoiceProductionReadinessProfileExplanation, VoiceProductionReadinessProfileSurface, VoiceProductionReadinessProofSource, VoiceProductionReadinessReport, VoiceProductionReadinessRouteInput, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessTraceDeliverySummary, VoiceProductionReadinessAuditDeliveryOptions, VoiceProductionReadinessAuditDeliverySummary, VoiceProductionReadinessTraceDeliveryOptions, VoiceProductionReadinessStatus } from './productionReadiness';
+export type { VoiceProductionReadinessAction, VoiceProductionReadinessAuditOptions, VoiceProductionReadinessAuditRequirement, VoiceProductionReadinessAuditSummary, VoiceProductionReadinessAssertionInput, VoiceProductionReadinessAssertionReport, VoiceProductionReadinessCheck, VoiceProductionReadinessGateExplanation, VoiceProductionReadinessGateIssue, VoiceProductionReadinessGateOptions, VoiceProductionReadinessGateProfile, VoiceProductionReadinessGateProfileSurface, VoiceProductionReadinessGateReport, VoiceProductionReadinessOpsActionHistoryOptions, VoiceProductionReadinessOpsActionHistorySummary, VoiceProductionReadinessOperationsRecordLink, VoiceProductionReadinessOperationsRecordLinks, VoiceProductionReadinessProfileExplanation, VoiceProductionReadinessProfileSurface, VoiceProductionReadinessProofSource, VoiceProductionReadinessReport, VoiceProductionReadinessRouteInput, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessTraceDeliverySummary, VoiceProductionReadinessAuditDeliveryOptions, VoiceProductionReadinessAuditDeliverySummary, VoiceProductionReadinessTraceDeliveryOptions, VoiceProductionReadinessStatus } from './productionReadiness';
 export type { VoiceMonitorDefinition, VoiceMonitorEvaluation, VoiceMonitorEvaluationInput, VoiceMonitorIssue, VoiceMonitorIssueStatus, VoiceMonitorIssueStore, VoiceMonitorNotifier, VoiceMonitorNotifierDeliveryInput, VoiceMonitorNotifierDeliveryOptions, VoiceMonitorNotifierDeliveryReceipt, VoiceMonitorNotifierDeliveryReceiptStore, VoiceMonitorNotifierDeliveryReport, VoiceMonitorNotifierDeliveryResult, VoiceMonitorRoutesOptions, VoiceMonitorRun, VoiceMonitorRunOptions, VoiceMonitorRunReport, VoiceMonitorRunner, VoiceMonitorRunnerOptions, VoiceMonitorRunnerRoutesOptions, VoiceMonitorRunnerTickResult, VoiceMonitorSeverity, VoiceMonitorStatus, VoiceMonitorWebhookNotifierOptions } from './voiceMonitoring';
 export type { VoiceReadinessProfileName, VoiceReadinessProfileOptions, VoiceReadinessProfileRecommendation, VoiceReadinessProfileRecommendationScore, VoiceReadinessProfileRoutesOptions } from './readinessProfiles';
 export type { VoiceProviderStackChoice, VoiceProviderStackCapabilities, VoiceProviderStackCapabilityGap, VoiceProviderStackCapabilityGapInput, VoiceProviderStackCapabilityGapReport, VoiceProviderContractCheck, VoiceProviderContractCheckStatus, VoiceProviderContractDefinition, VoiceProviderContractMatrixAssertionInput, VoiceProviderContractMatrixAssertionReport, VoiceProviderContractMatrixHandlerOptions, VoiceProviderContractMatrixHTMLHandlerOptions, VoiceProviderContractMatrixInput, VoiceProviderContractMatrixPresetOptions, VoiceProviderContractMatrixReport, VoiceProviderContractMatrixRoutesOptions, VoiceProviderContractMatrixRow, VoiceProviderStackAssertionInput, VoiceProviderStackAssertionReport, VoiceProviderStackInput, VoiceProviderStackKind, VoiceProviderStackRecommendation } from './providerStackRecommendations';

package/dist/index.js

@@ -21650,6 +21650,7 @@ var createStoredVoiceExternalObjectMap = (mapping) => createVoiceExternalObjectM
   sourceType: mapping.sourceType
 });
 // src/modelAdapters.ts
+var isVoiceProviderRoutingPolicyPreset = (value) => value === "balanced" || value === "cost-cap" || value === "cost-first" || value === "latency-first" || value === "quality-first";
 var resolveVoiceProviderRoutingPolicyPreset = (preset, options = {}) => {
   switch (preset) {
     case "balanced":
@@ -21691,6 +21692,75 @@ var resolveVoiceProviderRoutingPolicyPreset = (preset, options = {}) => {
       };
   }
 };
+var resolveVoiceProviderRoutingPolicy = (policy) => {
+  if (!policy) {
+    return;
+  }
+  if (typeof policy === "string") {
+    return isVoiceProviderRoutingPolicyPreset(policy) ? resolveVoiceProviderRoutingPolicyPreset(policy) : {
+      strategy: policy
+    };
+  }
+  return policy;
+};
+var mergeDefinedProviderPolicyFields = (base, surface) => {
+  const next = {
+    ...base ?? {}
+  };
+  if (surface.allowProviders !== undefined) {
+    next.allowProviders = surface.allowProviders;
+  }
+  if (surface.fallbackMode !== undefined) {
+    next.fallbackMode = surface.fallbackMode;
+  }
+  if (surface.maxCost !== undefined) {
+    next.maxCost = surface.maxCost;
+  }
+  if (surface.maxLatencyMs !== undefined) {
+    next.maxLatencyMs = surface.maxLatencyMs;
+  }
+  if (surface.minQuality !== undefined) {
+    next.minQuality = surface.minQuality;
+  }
+  if (surface.strategy !== undefined) {
+    next.strategy = surface.strategy;
+  }
+  if (surface.weights !== undefined) {
+    next.weights = {
+      ...base?.weights ?? {},
+      ...surface.weights
+    };
+  }
+  return next;
+};
+var createVoiceProviderOrchestrationProfile = (options) => {
+  const surfaceNames = Object.keys(options.surfaces);
+  const defaultSurface = options.defaultSurface ?? surfaceNames[0];
+  if (!defaultSurface || !options.surfaces[defaultSurface]) {
+    throw new Error("Voice provider orchestration profile has no surfaces.");
+  }
+  return {
+    defaultSurface,
+    id: options.id,
+    resolve: (surface = defaultSurface) => {
+      const config = options.surfaces[surface];
+      if (!config) {
+        throw new Error(`Voice provider orchestration profile ${options.id} has no surface "${surface}".`);
+      }
+      const policy = mergeDefinedProviderPolicyFields(resolveVoiceProviderRoutingPolicy(config.policy), config);
+      return {
+        allowProviders: config.allowProviders,
+        fallback: config.fallback,
+        fallbackMode: config.fallbackMode,
+        policy,
+        providerHealth: config.providerHealth,
+        providerProfiles: config.providerProfiles,
+        timeoutMs: config.timeoutMs
+      };
+    },
+    surfaces: options.surfaces
+  };
+};
 var OUTPUT_SCHEMA = {
   additionalProperties: false,
   properties: {
@@ -21858,19 +21928,23 @@ var createJSONVoiceAssistantModel = (options) => ({
 var createVoiceProviderRouter = (options) => {
   const providerIds = Object.keys(options.providers);
   const firstProvider = providerIds[0];
-  const policy = typeof options.policy === "string" ? options.policy === "balanced" || options.policy === "cost-cap" || options.policy === "cost-first" || options.policy === "latency-first" || options.policy === "quality-first" ? resolveVoiceProviderRoutingPolicyPreset(options.policy) : {
-    strategy: options.policy
-  } : options.policy;
+  const orchestrationSurface = options.orchestrationProfile?.resolve(options.orchestrationSurface);
+  const policy = resolveVoiceProviderRoutingPolicy(options.policy) ?? resolveVoiceProviderRoutingPolicy(orchestrationSurface?.policy);
   const strategy = policy?.strategy ?? "prefer-selected";
-  const fallbackMode = policy?.fallbackMode ?? options.fallbackMode ?? "provider-error";
-  const healthOptions = typeof options.providerHealth === "object" ? options.providerHealth : options.providerHealth ? {} : undefined;
+  const fallbackMode = policy?.fallbackMode ?? options.fallbackMode ?? orchestrationSurface?.fallbackMode ?? "provider-error";
+  const providerProfiles = {
+    ...orchestrationSurface?.providerProfiles ?? {},
+    ...options.providerProfiles ?? {}
+  };
+  const providerHealthOption = options.providerHealth ?? orchestrationSurface?.providerHealth;
+  const healthOptions = typeof providerHealthOption === "object" ? providerHealthOption : providerHealthOption ? {} : undefined;
   const healthState = new Map;
   const now = () => healthOptions?.now?.() ?? Date.now();
   const failureThreshold = Math.max(1, healthOptions?.failureThreshold ?? 1);
   const cooldownMs = Math.max(0, healthOptions?.cooldownMs ?? 30000);
   const rateLimitCooldownMs = Math.max(0, healthOptions?.rateLimitCooldownMs ?? 60000);
   const getProviderTimeoutMs = (provider) => {
-    const timeoutMs = options.providerProfiles?.[provider]?.timeoutMs ?? options.timeoutMs;
+    const timeoutMs = providerProfiles[provider]?.timeoutMs ?? options.timeoutMs ?? orchestrationSurface?.timeoutMs;
     return typeof timeoutMs === "number" && Number.isFinite(timeoutMs) && timeoutMs > 0 ? timeoutMs : undefined;
   };
   const getHealth = (provider) => {
@@ -21936,12 +22010,12 @@ var createVoiceProviderRouter = (options) => {
     return cloneHealth(provider);
   };
   const resolveAllowedProviders = async (input) => {
-    const allowProviders = policy?.allowProviders ?? options.allowProviders;
+    const allowProviders = policy?.allowProviders ?? options.allowProviders ?? orchestrationSurface?.allowProviders;
     const allowed = typeof allowProviders === "function" ? await allowProviders(input) : allowProviders;
     return new Set(allowed ?? providerIds);
   };
   const passesBudgetFilters = (provider) => {
-    const profile = options.providerProfiles?.[provider];
+    const profile = providerProfiles[provider];
     if (typeof policy?.maxCost === "number" && typeof profile?.cost === "number" && profile.cost > policy.maxCost) {
       return false;
     }
@@ -21954,7 +22028,7 @@ var createVoiceProviderRouter = (options) => {
     return true;
   };
   const getBalancedScore = (provider) => {
-    const profile = options.providerProfiles?.[provider];
+    const profile = providerProfiles[provider];
     if (policy?.scoreProvider) {
       return policy.scoreProvider(provider, profile);
     }
@@ -21966,8 +22040,8 @@ var createVoiceProviderRouter = (options) => {
       return providers;
     }
     return [...providers].sort((left, right) => {
-      const leftProfile = options.providerProfiles?.[left];
-      const rightProfile = options.providerProfiles?.[right];
+      const leftProfile = providerProfiles[left];
+      const rightProfile = providerProfiles[right];
       if (strategy === "quality-first") {
         return (rightProfile?.quality ?? Number.MIN_SAFE_INTEGER) - (leftProfile?.quality ?? Number.MIN_SAFE_INTEGER) || (leftProfile?.priority ?? Number.MAX_SAFE_INTEGER) - (rightProfile?.priority ?? Number.MAX_SAFE_INTEGER) || (leftProfile?.latencyMs ?? Number.MAX_SAFE_INTEGER) - (rightProfile?.latencyMs ?? Number.MAX_SAFE_INTEGER) || (leftProfile?.cost ?? Number.MAX_SAFE_INTEGER) - (rightProfile?.cost ?? Number.MAX_SAFE_INTEGER);
       }
@@ -21982,7 +22056,8 @@ var createVoiceProviderRouter = (options) => {
   const resolveOrder = async (input) => {
     const selectedProvider = await options.selectProvider?.(input);
     const allowedProviders = await resolveAllowedProviders(input);
-    const fallbackOrder = typeof options.fallback === "function" ? await options.fallback(input) : options.fallback;
+    const fallbackSource = options.fallback ?? orchestrationSurface?.fallback;
+    const fallbackOrder = typeof fallbackSource === "function" ? await fallbackSource(input) : fallbackSource;
     const allowedRankedProviders = sortProviders([
       ...fallbackOrder ?? providerIds
     ]).filter((provider) => allowedProviders.has(provider));
@@ -30823,11 +30898,11 @@ var withTimeout2 = async (input) => {
     }
   }
 };
-var isVoiceProviderRoutingPolicyPreset = (policy) => policy === "balanced" || policy === "cost-cap" || policy === "cost-first" || policy === "latency-first" || policy === "quality-first";
+var isVoiceProviderRoutingPolicyPreset2 = (policy) => policy === "balanced" || policy === "cost-cap" || policy === "cost-first" || policy === "latency-first" || policy === "quality-first";
 var createResolver = (options) => {
   const providerIds = Object.keys(options.adapters);
   const firstProvider = providerIds[0];
-  const policy = typeof options.policy === "string" ? isVoiceProviderRoutingPolicyPreset(options.policy) ? resolveVoiceProviderRoutingPolicyPreset(options.policy) : {
+  const policy = typeof options.policy === "string" ? isVoiceProviderRoutingPolicyPreset2(options.policy) ? resolveVoiceProviderRoutingPolicyPreset(options.policy) : {
     strategy: options.policy
   } : options.policy;
   const strategy = policy?.strategy ?? "prefer-selected";
@@ -33231,6 +33306,7 @@ export {
   createVoiceQualityRoutes,
   createVoiceProviderSloRoutes,
   createVoiceProviderRouter,
+  createVoiceProviderOrchestrationProfile,
   createVoiceProviderHealthRoutes,
   createVoiceProviderHealthJSONHandler,
   createVoiceProviderHealthHTMLHandler,

package/dist/modelAdapters.d.ts

@@ -92,6 +92,41 @@ export type VoiceProviderRouterProviderHealth<TProvider extends string = string>
     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[]>);
@@ -100,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/react/VoiceReadinessFailures.d.ts

@@ -0,0 +1,6 @@
+import { type VoiceReadinessFailuresWidgetOptions } from '../client/readinessFailuresWidget';
+export type VoiceReadinessFailuresProps = VoiceReadinessFailuresWidgetOptions & {
+    className?: string;
+    path?: string;
+};
+export declare const VoiceReadinessFailures: ({ className, path, ...options }: VoiceReadinessFailuresProps) => import("react/jsx-runtime").JSX.Element;

package/dist/react/index.d.ts

@@ -3,6 +3,7 @@ export { VoiceOpsActionCenter } from './VoiceOpsActionCenter';
 export { VoiceDeliveryRuntime } from './VoiceDeliveryRuntime';
 export { VoicePlatformCoverage } from './VoicePlatformCoverage';
 export { VoiceProofTrends } from './VoiceProofTrends';
+export { VoiceReadinessFailures } from './VoiceReadinessFailures';
 export { VoiceProviderSimulationControls } from './VoiceProviderSimulationControls';
 export { VoiceProviderCapabilities } from './VoiceProviderCapabilities';
 export { VoiceProviderContracts } from './VoiceProviderContracts';
@@ -15,6 +16,7 @@ export { VoiceTurnQuality } from './VoiceTurnQuality';
 export { useVoiceOpsStatus } from './useVoiceOpsStatus';
 export { useVoicePlatformCoverage } from './useVoicePlatformCoverage';
 export { useVoiceProofTrends } from './useVoiceProofTrends';
+export { useVoiceReadinessFailures } from './useVoiceReadinessFailures';
 export { useVoiceOpsActionCenter } from './useVoiceOpsActionCenter';
 export { useVoiceLiveOps } from './useVoiceLiveOps';
 export { useVoiceDeliveryRuntime } from './useVoiceDeliveryRuntime';