@absolutejs/voice 0.0.22-beta.353 → 0.0.22-beta.355

package/dist/client/profileSwitchRecommendation.d.ts

@@ -0,0 +1,19 @@
+import type { VoiceProfileSwitchRecommendation } from '../profileSwitchRecommendation';
+export type VoiceProfileSwitchRecommendationClientOptions = {
+    fetch?: typeof fetch;
+    intervalMs?: number;
+};
+export type VoiceProfileSwitchRecommendationSnapshot = {
+    error: string | null;
+    isLoading: boolean;
+    recommendation?: VoiceProfileSwitchRecommendation;
+    updatedAt?: number;
+};
+export declare const fetchVoiceProfileSwitchRecommendation: (path?: string, options?: Pick<VoiceProfileSwitchRecommendationClientOptions, "fetch">) => Promise<VoiceProfileSwitchRecommendation>;
+export declare const createVoiceProfileSwitchRecommendationStore: (path?: string, options?: VoiceProfileSwitchRecommendationClientOptions) => {
+    close: () => void;
+    getServerSnapshot: () => VoiceProfileSwitchRecommendationSnapshot;
+    getSnapshot: () => VoiceProfileSwitchRecommendationSnapshot;
+    refresh: () => Promise<VoiceProfileSwitchRecommendation | undefined>;
+    subscribe: (listener: () => void) => () => void;
+};

package/dist/client/profileSwitchRecommendationWidget.d.ts

@@ -0,0 +1,12 @@
+import { type VoiceProfileSwitchRecommendationClientOptions, type VoiceProfileSwitchRecommendationSnapshot } from './profileSwitchRecommendation';
+export type VoiceProfileSwitchRecommendationWidgetOptions = VoiceProfileSwitchRecommendationClientOptions & {
+    description?: string;
+    title?: string;
+};
+export declare const renderVoiceProfileSwitchRecommendationHTML: (snapshot: VoiceProfileSwitchRecommendationSnapshot, options?: VoiceProfileSwitchRecommendationWidgetOptions) => string;
+export declare const getVoiceProfileSwitchRecommendationCSS: () => string;
+export declare const mountVoiceProfileSwitchRecommendation: (element: Element, path?: string, options?: VoiceProfileSwitchRecommendationWidgetOptions) => {
+    close: () => void;
+    refresh: () => Promise<import("..").VoiceProfileSwitchRecommendation | undefined>;
+};
+export declare const defineVoiceProfileSwitchRecommendationElement: (tagName?: string) => void;

package/dist/index.d.ts

@@ -31,6 +31,8 @@ export { assertVoiceCompetitiveCoverage, buildVoiceCompetitiveCoverageReport, cr
 export type { VoiceCompetitiveCoverageAssertionInput, VoiceCompetitiveCoverageAssertionReport, VoiceCompetitiveCoverageIssue, VoiceCompetitiveCoverageLevel, VoiceCompetitiveCoverageReport, VoiceCompetitiveCoverageReportInput, VoiceCompetitiveCoverageRoutesOptions, VoiceCompetitiveCoverageStatus, VoiceCompetitiveCoverageSummary, VoiceCompetitiveDepthLevel, VoiceCompetitiveEvidence, VoiceCompetitiveSurface } from './competitiveCoverage';
 export type { VoicePlatformCoverageAssertionInput, VoicePlatformCoverageAssertionReport, VoicePlatformCoverageEvidence, VoicePlatformCoverageRoutesOptions, VoicePlatformCoverageStatus, VoicePlatformCoverageSummary, VoicePlatformCoverageSummaryInput, VoicePlatformCoverageSurface } from './platformCoverage';
 export { assertVoiceProofTrendEvidence, buildEmptyVoiceProofTrendReport, buildVoiceProofTrendProfileSummaries, buildVoiceProofTrendRecommendationReport, buildVoiceProofTrendReportFromRealCallProfiles, buildVoiceProofTrendReport, buildVoiceRealCallProfileDefaults, buildVoiceRealCallProfileHistoryReport, createVoiceProofTrendRecommendationRoutes, createVoiceProofTrendRoutes, createVoiceRealCallProfileHistoryRoutes, DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS, DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS, evaluateVoiceProofTrendEvidence, formatVoiceProofTrendAge, normalizeVoiceProofTrendReport, readVoiceProofTrendReportFile, renderVoiceProofTrendRecommendationHTML, renderVoiceProofTrendRecommendationMarkdown, renderVoiceRealCallProfileHistoryHTML, renderVoiceRealCallProfileHistoryMarkdown, resolveVoiceRealCallProfileProviderRoute } from './proofTrends';
+export { recommendVoiceProfileSwitch } from './profileSwitchRecommendation';
+export type { VoiceProfileSwitchObservedSignals, VoiceProfileSwitchRecommendation, VoiceProfileSwitchRecommendationOptions } from './profileSwitchRecommendation';
 export { buildVoiceProviderDecisionTraceReport, createVoiceProviderDecisionTraceEvent, createVoiceProviderDecisionTraceRoutes, listVoiceProviderDecisionTraces, renderVoiceProviderDecisionTraceHTML, renderVoiceProviderDecisionTraceMarkdown } from './providerDecisionTraces';
 export type { VoiceProviderDecisionStatus, VoiceProviderDecisionSurfaceReport, VoiceProviderDecisionTrace, VoiceProviderDecisionTraceInput, VoiceProviderDecisionTraceIssue, VoiceProviderDecisionTraceReport, VoiceProviderDecisionTraceReportOptions, VoiceProviderDecisionTraceRoutesOptions } from './providerDecisionTraces';
 export type { VoiceProofTrendAssertionInput, VoiceProofTrendAssertionReport, VoiceProofTrendCycle, VoiceProofTrendProfileDefinition, VoiceProofTrendProfileRecommendation, VoiceProofTrendProfileSummaryOptions, VoiceProofTrendProfileSummary, VoiceProofTrendProviderRecommendation, VoiceProofTrendProviderSummary, VoiceProofTrendRecommendation, VoiceProofTrendRecommendationOptions, VoiceProofTrendRecommendationReport, VoiceProofTrendRecommendationRoutesOptions, VoiceProofTrendRecommendationStatus, VoiceProofTrendRecommendationSurface, VoiceProofTrendRealCallProfileEvidence, VoiceProofTrendRealCallProfileReportOptions, VoiceProofTrendReport, VoiceProofTrendReportInput, VoiceProofTrendRoutesOptions, VoiceProofTrendRuntimeChannelSummary, VoiceProofTrendStatus, VoiceProofTrendSummary, VoiceRealCallProfileDefault, VoiceRealCallProfileDefaultsOptions, VoiceRealCallProfileDefaultsReport, VoiceRealCallProfileHistoryOptions, VoiceRealCallProfileHistoryReport, VoiceRealCallProfileHistoryRoutesOptions, VoiceRealCallProfileProviderRouteOptions } from './proofTrends';

package/dist/index.js

@@ -15694,6 +15694,72 @@ var formatVoiceProofTrendAge = (ageMs) => {
   const days = Math.floor(hours / 24);
   return `${days}d ${hours % 24}h`;
 };
+// src/profileSwitchRecommendation.ts
+var readDefaults = (input) => ("defaults" in input) ? input.defaults : input;
+var isNumber = (value) => typeof value === "number" && Number.isFinite(value);
+var exceeds = (observed, budget) => isNumber(observed) && isNumber(budget) && observed > budget;
+var scoreProfile = (profile, observed) => {
+  const evidence = profile.evidence;
+  const live = evidence.liveP95Ms ?? observed.liveP95Ms ?? 0;
+  const provider = evidence.providerP95Ms ?? observed.providerP95Ms ?? 0;
+  const turn = evidence.turnP95Ms ?? observed.turnP95Ms ?? 0;
+  const statusPenalty = profile.status === "pass" ? 0 : profile.status === "warn" ? 1e4 : 25000;
+  const noisyBonus = (observed.fallbackUsed || (observed.turnWarnings ?? 0) > 0) && /noisy|phone/i.test(`${profile.profileId} ${profile.label ?? ""}`) ? -1000 : 0;
+  return live + provider + turn + statusPenalty + noisyBonus;
+};
+var recommendVoiceProfileSwitch = (options) => {
+  const defaults = readDefaults(options.defaults);
+  const observed = options.observed ?? {};
+  const currentProfileId = observed.currentProfileId ?? options.defaultProfileId ?? defaults.profiles[0]?.profileId;
+  const currentProfile = defaults.profiles.find((profile) => profile.profileId === currentProfileId);
+  const candidates = defaults.profiles.filter((profile) => profile.status !== "fail");
+  const recommended = candidates.slice().sort((left, right) => scoreProfile(left, observed) - scoreProfile(right, observed))[0];
+  const issues = [
+    ...defaults.profiles.length === 0 ? ["No measured profile defaults are available."] : [],
+    ...!currentProfile && currentProfileId ? [`Current profile ${currentProfileId} is not present in measured defaults.`] : [],
+    ...!recommended ? ["No non-failing measured profile can be recommended."] : []
+  ];
+  const currentOverBudget = currentProfile ? [
+    exceeds(observed.liveP95Ms, currentProfile.latencyBudgets.maxLiveP95Ms) ? "live p95 exceeds this profile budget" : undefined,
+    exceeds(observed.providerP95Ms, currentProfile.latencyBudgets.maxProviderP95Ms) ? "provider p95 exceeds this profile budget" : undefined,
+    exceeds(observed.turnP95Ms, currentProfile.latencyBudgets.maxTurnP95Ms) ? "turn p95 exceeds this profile budget" : undefined
+  ].filter((reason) => Boolean(reason)) : [];
+  const minImprovementMs = options.minImprovementMs ?? 250;
+  const currentScore = currentProfile ? scoreProfile(currentProfile, observed) : Number.POSITIVE_INFINITY;
+  const recommendedScore = recommended ? scoreProfile(recommended, observed) : Number.POSITIVE_INFINITY;
+  const shouldSwitch = Boolean(recommended) && recommended?.profileId !== currentProfile?.profileId && (!currentProfile || currentProfile.status !== "pass" || currentOverBudget.length > 0 || currentScore - recommendedScore >= minImprovementMs);
+  const reasons = [
+    ...currentOverBudget,
+    ...currentProfile?.status && currentProfile.status !== "pass" ? [`current profile is ${currentProfile.status}`] : [],
+    ...observed.fallbackUsed ? ["current session used provider fallback"] : [],
+    ...(observed.turnWarnings ?? 0) > 0 ? [`${observed.turnWarnings} turn quality warning(s) observed`] : [],
+    ...shouldSwitch && recommended ? [
+      `${recommended.label ?? recommended.profileId} has the strongest measured fit for these signals`
+    ] : []
+  ];
+  return {
+    currentProfile: currentProfile ? {
+      label: currentProfile.label,
+      profileId: currentProfile.profileId,
+      status: currentProfile.status
+    } : undefined,
+    generatedAt: new Date().toISOString(),
+    issues,
+    nextMove: issues.length > 0 ? "Collect fresh real-call profile evidence before switching automatically." : shouldSwitch && recommended ? `Switch to ${recommended.label ?? recommended.profileId} for this session profile.` : "Keep the current measured profile unless new session evidence drifts.",
+    ok: issues.length === 0,
+    observed,
+    reasons: reasons.length > 0 ? reasons : ["current profile matches measured defaults and observed budgets"],
+    recommendedProfile: recommended ? {
+      evidence: recommended.evidence,
+      label: recommended.label,
+      latencyBudgets: recommended.latencyBudgets,
+      profileId: recommended.profileId,
+      providerRoutes: recommended.providerRoutes,
+      status: recommended.status
+    } : undefined,
+    status: issues.length > 0 ? "warn" : shouldSwitch ? "switch" : "stay"
+  };
+};
 // src/providerDecisionTraces.ts
 import { Elysia as Elysia23 } from "elysia";
 
@@ -37316,6 +37382,7 @@ export {
   recordVoiceAuditEvent,
   recommendVoiceReadinessProfile,
   recommendVoiceProviderStack,
+  recommendVoiceProfileSwitch,
   readVoiceProofTrendReportFile,
   pruneVoiceTraceEvents,
   pruneVoiceIncidentBundleArtifacts,

package/dist/profileSwitchRecommendation.d.ts

@@ -0,0 +1,38 @@
+import type { VoiceRealCallProfileDefault, VoiceRealCallProfileDefaultsReport, VoiceRealCallProfileHistoryReport } from './proofTrends';
+export type VoiceProfileSwitchObservedSignals = {
+    currentProfileId?: string;
+    fallbackUsed?: boolean;
+    liveP95Ms?: number;
+    providerP95Ms?: number;
+    turnP95Ms?: number;
+    turnWarnings?: number;
+};
+export type VoiceProfileSwitchRecommendation = {
+    currentProfile?: {
+        label?: string;
+        profileId: string;
+        status: string;
+    };
+    generatedAt: string;
+    issues: string[];
+    nextMove: string;
+    ok: boolean;
+    observed: VoiceProfileSwitchObservedSignals;
+    reasons: string[];
+    recommendedProfile?: {
+        evidence: VoiceRealCallProfileDefault['evidence'];
+        label?: string;
+        latencyBudgets: VoiceRealCallProfileDefault['latencyBudgets'];
+        profileId: string;
+        providerRoutes: Record<string, string>;
+        status: string;
+    };
+    status: 'stay' | 'switch' | 'warn';
+};
+export type VoiceProfileSwitchRecommendationOptions = {
+    defaultProfileId?: string;
+    defaults: VoiceRealCallProfileDefaultsReport | VoiceRealCallProfileHistoryReport;
+    minImprovementMs?: number;
+    observed?: VoiceProfileSwitchObservedSignals;
+};
+export declare const recommendVoiceProfileSwitch: (options: VoiceProfileSwitchRecommendationOptions) => VoiceProfileSwitchRecommendation;

package/dist/react/VoiceProfileSwitchRecommendation.d.ts

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

package/dist/react/index.d.ts

@@ -4,6 +4,7 @@ export { VoiceDeliveryRuntime } from './VoiceDeliveryRuntime';
 export { VoicePlatformCoverage } from './VoicePlatformCoverage';
 export { VoiceProofTrends } from './VoiceProofTrends';
 export { VoiceProfileComparison } from './VoiceProfileComparison';
+export { VoiceProfileSwitchRecommendation } from './VoiceProfileSwitchRecommendation';
 export { VoiceReadinessFailures } from './VoiceReadinessFailures';
 export { VoiceProviderSimulationControls } from './VoiceProviderSimulationControls';
 export { VoiceProviderCapabilities } from './VoiceProviderCapabilities';
@@ -18,6 +19,7 @@ export { useVoiceOpsStatus } from './useVoiceOpsStatus';
 export { useVoicePlatformCoverage } from './useVoicePlatformCoverage';
 export { useVoiceProofTrends } from './useVoiceProofTrends';
 export { useVoiceProfileComparison } from './useVoiceProfileComparison';
+export { useVoiceProfileSwitchRecommendation } from './useVoiceProfileSwitchRecommendation';
 export { useVoiceReadinessFailures } from './useVoiceReadinessFailures';
 export { useVoiceOpsActionCenter } from './useVoiceOpsActionCenter';
 export { useVoiceLiveOps } from './useVoiceLiveOps';