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

package/dist/react/useVoiceReadinessFailures.d.ts

@@ -0,0 +1,8 @@
+import { type VoiceReadinessFailuresClientOptions } from '../client/readinessFailures';
+export declare const useVoiceReadinessFailures: (path?: string, options?: VoiceReadinessFailuresClientOptions) => {
+    refresh: () => Promise<import("..").VoiceProductionReadinessReport | undefined>;
+    error: string | null;
+    isLoading: boolean;
+    report?: import("..").VoiceProductionReadinessReport;
+    updatedAt?: number;
+};

package/dist/svelte/createVoiceReadinessFailures.d.ts

@@ -0,0 +1,7 @@
+import type { VoiceReadinessFailuresClientOptions } from '../client/readinessFailures';
+export declare const createVoiceReadinessFailures: (path?: string, options?: VoiceReadinessFailuresClientOptions) => {
+    close: () => void;
+    getSnapshot: () => import("../client").VoiceReadinessFailuresSnapshot;
+    refresh: () => Promise<import("..").VoiceProductionReadinessReport | undefined>;
+    subscribe: (listener: () => void) => () => void;
+};

package/dist/svelte/index.d.ts

@@ -5,6 +5,7 @@ export { createVoiceLiveOps } from './createVoiceLiveOps';
 export { createVoiceOpsStatus } from './createVoiceOpsStatus';
 export { createVoicePlatformCoverage } from './createVoicePlatformCoverage';
 export { createVoiceProofTrends } from './createVoiceProofTrends';
+export { createVoiceReadinessFailures } from './createVoiceReadinessFailures';
 export { createVoiceProviderSimulationControls } from './createVoiceProviderSimulationControls';
 export { createVoiceProviderCapabilities } from './createVoiceProviderCapabilities';
 export { createVoiceProviderContracts } from './createVoiceProviderContracts';

package/dist/svelte/index.js

@@ -2588,6 +2588,91 @@ var createVoiceProofTrends = (path = "/api/voice/proof-trends", options = {}) =>
     subscribe: store.subscribe
   };
 };
+// src/client/readinessFailures.ts
+var fetchVoiceReadinessFailures = async (path = "/api/production-readiness", options = {}) => {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const response = await fetchImpl(path);
+  if (!response.ok) {
+    throw new Error(`Voice readiness failed: HTTP ${response.status}`);
+  }
+  return await response.json();
+};
+var createVoiceReadinessFailuresStore = (path = "/api/production-readiness", options = {}) => {
+  const listeners = new Set;
+  let closed = false;
+  let timer;
+  let snapshot = {
+    error: null,
+    isLoading: false
+  };
+  const emit = () => {
+    for (const listener of listeners) {
+      listener();
+    }
+  };
+  const refresh = async () => {
+    if (closed) {
+      return snapshot.report;
+    }
+    snapshot = { ...snapshot, error: null, isLoading: true };
+    emit();
+    try {
+      const report = await fetchVoiceReadinessFailures(path, options);
+      snapshot = {
+        error: null,
+        isLoading: false,
+        report,
+        updatedAt: Date.now()
+      };
+      emit();
+      return report;
+    } catch (error) {
+      snapshot = {
+        ...snapshot,
+        error: error instanceof Error ? error.message : String(error),
+        isLoading: false
+      };
+      emit();
+      throw error;
+    }
+  };
+  const close = () => {
+    closed = true;
+    if (timer) {
+      clearInterval(timer);
+      timer = undefined;
+    }
+    listeners.clear();
+  };
+  if (typeof window !== "undefined" && options.intervalMs && options.intervalMs > 0) {
+    timer = setInterval(() => {
+      refresh().catch(() => {});
+    }, options.intervalMs);
+  }
+  return {
+    close,
+    getServerSnapshot: () => snapshot,
+    getSnapshot: () => snapshot,
+    refresh,
+    subscribe: (listener) => {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+  };
+};
+
+// src/svelte/createVoiceReadinessFailures.ts
+var createVoiceReadinessFailures = (path = "/api/production-readiness", options = {}) => {
+  const store = createVoiceReadinessFailuresStore(path, options);
+  return {
+    close: store.close,
+    getSnapshot: store.getSnapshot,
+    refresh: store.refresh,
+    subscribe: store.subscribe
+  };
+};
 // src/client/providerSimulationControls.ts
 var postSimulation = async (pathPrefix, mode, provider, fetchImpl) => {
   const response = await fetchImpl(`${pathPrefix}/${mode}?provider=${encodeURIComponent(provider)}`, { method: "POST" });
@@ -5704,6 +5789,7 @@ export {
   createVoiceTraceTimeline,
   createVoiceStream2 as createVoiceStream,
   createVoiceRoutingStatus,
+  createVoiceReadinessFailures,
   createVoiceProviderStatus,
   createVoiceProviderSimulationControls,
   createVoiceProviderContracts,

package/dist/testing/index.js

@@ -3791,6 +3791,7 @@ var createVoiceIOProviderFailureSimulator = (options) => {
   };
 };
 // 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":
@@ -3832,6 +3833,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: {
@@ -3999,19 +4069,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) => {
@@ -4077,12 +4151,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;
     }
@@ -4095,7 +4169,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);
     }
@@ -4107,8 +4181,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);
       }
@@ -4123,7 +4197,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));

package/dist/vue/VoiceReadinessFailures.d.ts

@@ -0,0 +1,21 @@
+export declare const VoiceReadinessFailures: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    description: StringConstructor;
+    intervalMs: NumberConstructor;
+    path: {
+        default: string;
+        type: StringConstructor;
+    };
+    title: StringConstructor;
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    description: StringConstructor;
+    intervalMs: NumberConstructor;
+    path: {
+        default: string;
+        type: StringConstructor;
+    };
+    title: StringConstructor;
+}>> & Readonly<{}>, {
+    path: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/vue/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';
@@ -14,6 +15,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';