@absolutejs/voice 0.0.22-beta.358 → 0.0.22-beta.359

package/dist/index.js

@@ -5467,18 +5467,26 @@ var recommendVoiceProfileSwitch = (options) => {
 var applyVoiceProfileSwitchGuard = async (options) => {
   const mode = options.mode ?? "recommend";
   const minConfidence = options.minConfidence ?? 0.75;
+  const maxAutoSwitchesPerSession = Math.max(0, Math.floor(options.maxAutoSwitchesPerSession ?? 1));
+  const autoSwitchCount = Math.max(0, Math.floor(options.autoSwitchCount ?? 0));
   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 isRecommendedAllowed = !recommendedProfileId || !options.allowedProfileIds || options.allowedProfileIds.length === 0 || options.allowedProfileIds.includes(recommendedProfileId);
+  const isRecommendedBlocked = recommendedProfileId ? Boolean(options.blockedProfileIds?.includes(recommendedProfileId)) : false;
+  const blockedByPolicy = !isRecommendedAllowed ? "allowed-profiles" : isRecommendedBlocked ? "blocked-profiles" : mode === "auto" && autoSwitchCount >= maxAutoSwitchesPerSession ? "max-switches" : undefined;
+  const canSwitch = mode !== "off" && recommendation.status === "switch" && recommendation.ok && Boolean(recommendedProfileId) && confidence >= minConfidence && !blockedByPolicy;
+  const action = mode === "off" ? "disabled" : 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 reason = action === "disabled" ? "Profile switch guard is disabled by policy." : action === "switch" ? `Auto-switched from ${previousProfileId ?? "unknown"} to ${recommendedProfileId}.` : action === "recommend" ? `Recommended ${recommendedProfileId} but left selection unchanged because mode is recommend.` : action === "blocked" ? blockedByPolicy === "allowed-profiles" ? `Blocked profile switch because ${recommendedProfileId} is not in the allowed profile list.` : blockedByPolicy === "blocked-profiles" ? `Blocked profile switch because ${recommendedProfileId} is in the blocked profile list.` : blockedByPolicy === "max-switches" ? `Blocked profile switch because the session already used ${autoSwitchCount} of ${maxAutoSwitchesPerSession} allowed automatic switch(es).` : `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",
+    autoSwitchCount,
+    blockedByPolicy,
     confidence,
+    maxAutoSwitchesPerSession,
     minConfidence,
     mode,
     previousProfileId,
@@ -5496,10 +5504,13 @@ var applyVoiceProfileSwitchGuard = async (options) => {
         name: "AbsoluteJS Voice Profile Switch Guard"
       },
       metadata: options.metadata,
-      outcome: action === "blocked" ? "skipped" : "success",
+      outcome: action === "blocked" || action === "disabled" ? "skipped" : "success",
       payload: {
         autoApplied: decision.autoApplied,
+        autoSwitchCount,
+        blockedByPolicy,
         confidence,
+        maxAutoSwitchesPerSession,
         minConfidence,
         mode,
         previousProfileId,
@@ -5732,12 +5743,19 @@ var resolveProfileSwitchGuard = async (config, runtime, input) => {
   const currentProfileId = await resolveMaybeFunction(guard.currentProfileId, resolverInput);
   const metadata = await resolveMaybeFunction(guard.metadata, resolverInput);
   const minConfidence = await resolveMaybeFunction(guard.minConfidence, resolverInput);
+  const maxAutoSwitchesPerSession = await resolveMaybeFunction(guard.maxAutoSwitchesPerSession, resolverInput);
+  const allowedProfileIds = await resolveMaybeFunction(guard.allowedProfileIds, resolverInput);
+  const blockedProfileIds = await resolveMaybeFunction(guard.blockedProfileIds, resolverInput);
   const mode = await resolveMaybeFunction(guard.mode, resolverInput);
   const decision = await applyVoiceProfileSwitchGuard({
     actor: guard.actor,
+    allowedProfileIds,
     audit: guard.audit,
+    autoSwitchCount: runtime.profileSwitchGuardAutoSwitchCounts.get(input.sessionId) ?? 0,
+    blockedProfileIds,
     defaultProfileId: guard.defaultProfileId,
     defaults,
+    maxAutoSwitchesPerSession,
     metadata,
     minConfidence,
     mode,
@@ -5747,6 +5765,9 @@ var resolveProfileSwitchGuard = async (config, runtime, input) => {
     },
     sessionId: input.sessionId
   });
+  if (decision.autoApplied) {
+    runtime.profileSwitchGuardAutoSwitchCounts.set(input.sessionId, decision.autoSwitchCount + 1);
+  }
   await guard.onDecision?.({
     context: input.context,
     decision,
@@ -5764,7 +5785,10 @@ var resolveProfileSwitchGuard = async (config, runtime, input) => {
       payload: {
         action: decision.action,
         autoApplied: decision.autoApplied,
+        autoSwitchCount: decision.autoSwitchCount,
+        blockedByPolicy: decision.blockedByPolicy,
         confidence: decision.confidence,
+        maxAutoSwitchesPerSession: decision.maxAutoSwitchesPerSession,
         minConfidence: decision.minConfidence,
         mode: decision.mode,
         previousProfileId: decision.previousProfileId,
@@ -5787,6 +5811,7 @@ var voice = (config) => {
   const runtime = {
     activeSessions: new Map,
     logger: resolveLogger(config.logger),
+    profileSwitchGuardAutoSwitchCounts: new Map,
     profileSwitchGuardedSessions: new Set,
     socketSessions: new WeakMap
   };

package/dist/profileSwitchRecommendation.d.ts

@@ -36,15 +36,18 @@ export type VoiceProfileSwitchRecommendationOptions = {
     minImprovementMs?: number;
     observed?: VoiceProfileSwitchObservedSignals;
 };
-export type VoiceProfileSwitchGuardMode = 'auto' | 'recommend';
-export type VoiceProfileSwitchGuardAction = 'blocked' | 'recommend' | 'stay' | 'switch';
+export type VoiceProfileSwitchGuardMode = 'auto' | 'off' | 'recommend';
+export type VoiceProfileSwitchGuardAction = 'blocked' | 'disabled' | 'recommend' | 'stay' | 'switch';
 export type VoiceProfileSwitchGuardDecision = {
     action: VoiceProfileSwitchGuardAction;
     auditEvent?: StoredVoiceAuditEvent;
     autoApplied: boolean;
+    autoSwitchCount: number;
+    blockedByPolicy?: 'allowed-profiles' | 'blocked-profiles' | 'max-switches';
     confidence: number;
     minConfidence: number;
     mode: VoiceProfileSwitchGuardMode;
+    maxAutoSwitchesPerSession: number;
     previousProfileId?: string;
     reason: string;
     recommendation: VoiceProfileSwitchRecommendation;
@@ -53,7 +56,11 @@ export type VoiceProfileSwitchGuardDecision = {
 };
 export type VoiceProfileSwitchGuardOptions = VoiceProfileSwitchRecommendationOptions & {
     actor?: VoiceAuditActor;
+    allowedProfileIds?: string[];
     audit?: VoiceAuditEventStore;
+    autoSwitchCount?: number;
+    blockedProfileIds?: string[];
+    maxAutoSwitchesPerSession?: number;
     metadata?: Record<string, unknown>;
     minConfidence?: number;
     mode?: VoiceProfileSwitchGuardMode;

package/dist/types.d.ts

@@ -624,12 +624,15 @@ export type VoiceProfileSwitchGuardResolverInput<TContext = unknown> = {
 };
 export type VoicePluginProfileSwitchGuardConfig<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = {
     actor?: VoiceAuditActor;
+    allowedProfileIds?: string[] | ((input: VoiceProfileSwitchGuardResolverInput<TContext>) => Promise<string[] | undefined> | string[] | undefined);
     audit?: VoiceAuditEventStore;
+    blockedProfileIds?: string[] | ((input: VoiceProfileSwitchGuardResolverInput<TContext>) => Promise<string[] | undefined> | string[] | undefined);
     currentProfileId?: string | ((input: VoiceProfileSwitchGuardResolverInput<TContext>) => Promise<string | undefined> | string | undefined);
     defaultProfileId?: string;
     defaults: VoiceRealCallProfileDefaultsReport | VoiceRealCallProfileHistoryReport | ((input: VoiceProfileSwitchGuardResolverInput<TContext>) => Promise<VoiceRealCallProfileDefaultsReport | VoiceRealCallProfileHistoryReport> | VoiceRealCallProfileDefaultsReport | VoiceRealCallProfileHistoryReport);
     metadata?: Record<string, unknown> | ((input: VoiceProfileSwitchGuardResolverInput<TContext>) => Promise<Record<string, unknown> | undefined> | Record<string, unknown> | undefined);
     minConfidence?: number | ((input: VoiceProfileSwitchGuardResolverInput<TContext>) => Promise<number | undefined> | number | undefined);
+    maxAutoSwitchesPerSession?: number | ((input: VoiceProfileSwitchGuardResolverInput<TContext>) => Promise<number | undefined> | number | undefined);
     mode?: VoiceProfileSwitchGuardMode | ((input: VoiceProfileSwitchGuardResolverInput<TContext>) => Promise<VoiceProfileSwitchGuardMode | undefined> | VoiceProfileSwitchGuardMode | undefined);
     observed?: VoiceProfileSwitchObservedSignals | ((input: VoiceProfileSwitchGuardResolverInput<TContext>) => Promise<VoiceProfileSwitchObservedSignals | undefined> | VoiceProfileSwitchObservedSignals | undefined);
     onDecision?: (input: {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@absolutejs/voice",
-	"version": "0.0.22-beta.358",
+	"version": "0.0.22-beta.359",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",