@absolutejs/voice 0.0.22-beta.354 → 0.0.22-beta.356

package/dist/audit.d.ts

@@ -1,4 +1,4 @@
-export type VoiceAuditEventType = 'handoff' | 'operator.action' | 'provider.call' | 'retention.policy' | 'tool.call';
+export type VoiceAuditEventType = 'handoff' | 'operator.action' | 'profile.switch' | 'provider.call' | 'retention.policy' | 'tool.call';
 export type VoiceAuditActor = {
     id: string;
     kind: 'agent' | 'operator' | 'system' | 'worker';

package/dist/index.d.ts

@@ -31,8 +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 { applyVoiceProfileSwitchGuard, recommendVoiceProfileSwitch } from './profileSwitchRecommendation';
+export type { VoiceProfileSwitchGuardAction, VoiceProfileSwitchGuardDecision, VoiceProfileSwitchGuardMode, VoiceProfileSwitchGuardOptions, 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

@@ -15707,6 +15707,32 @@ var scoreProfile = (profile, observed) => {
   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 clampConfidence = (value) => Math.max(0, Math.min(0.99, Number(value.toFixed(2))));
+var estimateSwitchConfidence = (recommendation) => {
+  if (!recommendation.ok || recommendation.status !== "switch") {
+    return recommendation.status === "stay" && recommendation.ok ? 0.99 : 0;
+  }
+  const observed = recommendation.observed;
+  const currentStatus = recommendation.currentProfile?.status;
+  const recommendedStatus = recommendation.recommendedProfile?.status;
+  let confidence = 0.58;
+  if (currentStatus && currentStatus !== "pass") {
+    confidence += 0.12;
+  }
+  if (recommendedStatus === "pass") {
+    confidence += 0.1;
+  }
+  if (observed.fallbackUsed) {
+    confidence += 0.08;
+  }
+  if ((observed.turnWarnings ?? 0) > 0) {
+    confidence += 0.08;
+  }
+  if (recommendation.reasons.some((reason) => /budget|strongest measured fit/i.test(reason))) {
+    confidence += 0.08;
+  }
+  return clampConfidence(confidence);
+};
 var recommendVoiceProfileSwitch = (options) => {
   const defaults = readDefaults(options.defaults);
   const observed = options.observed ?? {};
@@ -15760,6 +15786,62 @@ var recommendVoiceProfileSwitch = (options) => {
     status: issues.length > 0 ? "warn" : shouldSwitch ? "switch" : "stay"
   };
 };
+var applyVoiceProfileSwitchGuard = async (options) => {
+  const mode = options.mode ?? "recommend";
+  const minConfidence = options.minConfidence ?? 0.75;
+  const recommendation = recommendVoiceProfileSwitch(options);
+  const confidence = estimateSwitchConfidence(recommendation);
+  const previousProfileId = recommendation.currentProfile?.profileId;
+  const recommendedProfileId = recommendation.recommendedProfile?.profileId;
+  const canSwitch = recommendation.status === "switch" && recommendation.ok && Boolean(recommendedProfileId) && confidence >= minConfidence;
+  const action = recommendation.status === "stay" ? "stay" : canSwitch ? mode === "auto" ? "switch" : "recommend" : "blocked";
+  const selectedProfileId = action === "switch" ? recommendedProfileId : previousProfileId ?? recommendedProfileId;
+  const reason = action === "switch" ? `Auto-switched from ${previousProfileId ?? "unknown"} to ${recommendedProfileId}.` : action === "recommend" ? `Recommended ${recommendedProfileId} but left selection unchanged because mode is recommend.` : action === "blocked" ? `Blocked profile switch because confidence ${confidence} is below ${minConfidence} or evidence is incomplete.` : "Kept current profile because measured evidence does not require a switch.";
+  const decision = {
+    action,
+    autoApplied: action === "switch",
+    confidence,
+    minConfidence,
+    mode,
+    previousProfileId,
+    reason,
+    recommendation,
+    recommendedProfileId,
+    selectedProfileId
+  };
+  if (options.audit) {
+    const auditEvent = await options.audit.append(createVoiceAuditEvent({
+      action: `profile.switch.${action}`,
+      actor: options.actor ?? {
+        id: "absolutejs-voice-profile-switch-guard",
+        kind: "system",
+        name: "AbsoluteJS Voice Profile Switch Guard"
+      },
+      metadata: options.metadata,
+      outcome: action === "blocked" ? "skipped" : "success",
+      payload: {
+        autoApplied: decision.autoApplied,
+        confidence,
+        minConfidence,
+        mode,
+        previousProfileId,
+        reasons: recommendation.reasons,
+        recommendedProfileId,
+        selectedProfileId,
+        status: recommendation.status
+      },
+      resource: {
+        id: selectedProfileId,
+        type: "voice-profile"
+      },
+      sessionId: options.sessionId,
+      traceId: options.traceId,
+      type: "profile.switch"
+    }));
+    decision.auditEvent = auditEvent;
+  }
+  return decision;
+};
 // src/providerDecisionTraces.ts
 import { Elysia as Elysia23 } from "elysia";
 
@@ -37846,6 +37928,7 @@ export {
   assertVoiceAgentSquadContractEvidence,
   assertVoiceAgentSquadContract,
   applyVoiceTelephonyOutcome,
+  applyVoiceProfileSwitchGuard,
   applyVoiceOpsTaskPolicy,
   applyVoiceOpsTaskAssignmentRule,
   applyVoiceHandoffDeliveryResult,

package/dist/profileSwitchRecommendation.d.ts

@@ -1,4 +1,5 @@
 import type { VoiceRealCallProfileDefault, VoiceRealCallProfileDefaultsReport, VoiceRealCallProfileHistoryReport } from './proofTrends';
+import { type StoredVoiceAuditEvent, type VoiceAuditActor, type VoiceAuditEventStore } from './audit';
 export type VoiceProfileSwitchObservedSignals = {
     currentProfileId?: string;
     fallbackUsed?: boolean;
@@ -35,4 +36,29 @@ export type VoiceProfileSwitchRecommendationOptions = {
     minImprovementMs?: number;
     observed?: VoiceProfileSwitchObservedSignals;
 };
+export type VoiceProfileSwitchGuardMode = 'auto' | 'recommend';
+export type VoiceProfileSwitchGuardAction = 'blocked' | 'recommend' | 'stay' | 'switch';
+export type VoiceProfileSwitchGuardDecision = {
+    action: VoiceProfileSwitchGuardAction;
+    auditEvent?: StoredVoiceAuditEvent;
+    autoApplied: boolean;
+    confidence: number;
+    minConfidence: number;
+    mode: VoiceProfileSwitchGuardMode;
+    previousProfileId?: string;
+    reason: string;
+    recommendation: VoiceProfileSwitchRecommendation;
+    recommendedProfileId?: string;
+    selectedProfileId?: string;
+};
+export type VoiceProfileSwitchGuardOptions = VoiceProfileSwitchRecommendationOptions & {
+    actor?: VoiceAuditActor;
+    audit?: VoiceAuditEventStore;
+    metadata?: Record<string, unknown>;
+    minConfidence?: number;
+    mode?: VoiceProfileSwitchGuardMode;
+    sessionId?: string;
+    traceId?: string;
+};
 export declare const recommendVoiceProfileSwitch: (options: VoiceProfileSwitchRecommendationOptions) => VoiceProfileSwitchRecommendation;
+export declare const applyVoiceProfileSwitchGuard: (options: VoiceProfileSwitchGuardOptions) => Promise<VoiceProfileSwitchGuardDecision>;

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';