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

package/dist/angular/index.js

@@ -1486,6 +1486,7 @@ var serverMessageToAction = (message) => {
         partial: message.partial,
         scenarioId: message.scenarioId,
         sessionId: message.sessionId,
+        sessionMetadata: message.sessionMetadata,
         status: message.status,
         turns: message.turns,
         type: "replay"
@@ -1493,6 +1494,7 @@ var serverMessageToAction = (message) => {
     case "session":
       return {
         sessionId: message.sessionId,
+        sessionMetadata: message.sessionMetadata,
         scenarioId: message.scenarioId,
         status: message.status,
         type: "session"
@@ -2518,6 +2520,7 @@ var createInitialState = () => ({
   call: null,
   error: null,
   isConnected: false,
+  sessionMetadata: null,
   scenarioId: null,
   partial: "",
   reconnect: createInitialReconnectState(),
@@ -2633,6 +2636,7 @@ var createVoiceStreamStore = () => {
           } : state.reconnect,
           scenarioId: action.scenarioId ?? state.scenarioId,
           sessionId: action.sessionId,
+          sessionMetadata: action.sessionMetadata ?? state.sessionMetadata,
           status: action.status,
           turns: [...action.turns]
         };
@@ -2644,6 +2648,7 @@ var createVoiceStreamStore = () => {
           scenarioId: action.scenarioId ?? state.scenarioId,
           isConnected: action.status === "active",
           sessionId: action.sessionId,
+          sessionMetadata: action.sessionMetadata ?? state.sessionMetadata,
           status: action.status
         };
         break;
@@ -2750,6 +2755,9 @@ var createVoiceStream = (path, options = {}) => {
     get scenarioId() {
       return store.getSnapshot().scenarioId;
     },
+    get sessionMetadata() {
+      return store.getSnapshot().sessionMetadata;
+    },
     start,
     get partial() {
       return store.getSnapshot().partial;
@@ -2804,6 +2812,7 @@ class VoiceStreamService {
     const partialSignal = signal10("");
     const reconnectSignal = signal10(stream.reconnect);
     const sessionIdSignal = signal10(stream.sessionId);
+    const sessionMetadataSignal = signal10(stream.sessionMetadata);
     const statusSignal = signal10(stream.status);
     const turnsSignal = signal10([]);
     const sync = () => {
@@ -2815,6 +2824,7 @@ class VoiceStreamService {
       partialSignal.set(stream.partial);
       reconnectSignal.set(stream.reconnect);
       sessionIdSignal.set(stream.sessionId);
+      sessionMetadataSignal.set(stream.sessionMetadata);
       statusSignal.set(stream.status);
       turnsSignal.set([...stream.turns]);
     };
@@ -2836,6 +2846,7 @@ class VoiceStreamService {
       reconnect: computed10(() => reconnectSignal()),
       sendAudio: (audio) => stream.sendAudio(audio),
       sessionId: computed10(() => sessionIdSignal()),
+      sessionMetadata: computed10(() => sessionMetadataSignal()),
       status: computed10(() => statusSignal()),
       turns: computed10(() => turnsSignal())
     };
@@ -3318,6 +3329,7 @@ var createInitialState2 = (stream) => ({
   reconnect: stream.reconnect,
   recordingError: null,
   sessionId: stream.sessionId,
+  sessionMetadata: stream.sessionMetadata,
   scenarioId: stream.scenarioId,
   status: stream.status,
   turns: [...stream.turns]
@@ -3347,6 +3359,7 @@ var createVoiceController = (path, options = {}) => {
       partial: stream.partial,
       reconnect: stream.reconnect,
       sessionId: stream.sessionId,
+      sessionMetadata: stream.sessionMetadata,
       scenarioId: stream.scenarioId,
       status: stream.status,
       turns: [...stream.turns]
@@ -3453,6 +3466,9 @@ var createVoiceController = (path, options = {}) => {
     get sessionId() {
       return state.sessionId;
     },
+    get sessionMetadata() {
+      return state.sessionMetadata;
+    },
     get scenarioId() {
       return state.scenarioId;
     },

package/dist/angular/voice-stream.service.d.ts

@@ -18,6 +18,7 @@ export declare class VoiceStreamService {
         reconnect: import("@angular/core").Signal<import("..").VoiceReconnectClientState>;
         sendAudio: (audio: Uint8Array | ArrayBuffer) => void;
         sessionId: import("@angular/core").Signal<string | null>;
+        sessionMetadata: import("@angular/core").Signal<Record<string, unknown> | null>;
         status: import("@angular/core").Signal<import("..").VoiceSessionStatus | "idle">;
         turns: import("@angular/core").Signal<VoiceTurnRecord<TResult>[]>;
     };

package/dist/client/actions.d.ts

@@ -15,6 +15,7 @@ export declare const serverMessageToAction: <TResult = unknown>(message: VoiceSe
     call?: undefined;
     partial?: undefined;
     scenarioId?: undefined;
+    sessionMetadata?: undefined;
     status?: undefined;
     turns?: undefined;
     turn?: undefined;
@@ -34,6 +35,7 @@ export declare const serverMessageToAction: <TResult = unknown>(message: VoiceSe
     call?: undefined;
     partial?: undefined;
     scenarioId?: undefined;
+    sessionMetadata?: undefined;
     status?: undefined;
     turns?: undefined;
     turn?: undefined;
@@ -53,6 +55,7 @@ export declare const serverMessageToAction: <TResult = unknown>(message: VoiceSe
     call?: undefined;
     partial?: undefined;
     scenarioId?: undefined;
+    sessionMetadata?: undefined;
     status?: undefined;
     turns?: undefined;
     turn?: undefined;
@@ -72,6 +75,7 @@ export declare const serverMessageToAction: <TResult = unknown>(message: VoiceSe
     call?: undefined;
     partial?: undefined;
     scenarioId?: undefined;
+    sessionMetadata?: undefined;
     status?: undefined;
     turns?: undefined;
     turn?: undefined;
@@ -91,6 +95,7 @@ export declare const serverMessageToAction: <TResult = unknown>(message: VoiceSe
     call?: undefined;
     partial?: undefined;
     scenarioId?: undefined;
+    sessionMetadata?: undefined;
     status?: undefined;
     turns?: undefined;
     turn?: undefined;
@@ -110,6 +115,7 @@ export declare const serverMessageToAction: <TResult = unknown>(message: VoiceSe
     call?: undefined;
     partial?: undefined;
     scenarioId?: undefined;
+    sessionMetadata?: undefined;
     status?: undefined;
     turns?: undefined;
     turn?: undefined;
@@ -129,6 +135,7 @@ export declare const serverMessageToAction: <TResult = unknown>(message: VoiceSe
     call?: undefined;
     partial?: undefined;
     scenarioId?: undefined;
+    sessionMetadata?: undefined;
     status?: undefined;
     turns?: undefined;
     turn?: undefined;
@@ -148,6 +155,7 @@ export declare const serverMessageToAction: <TResult = unknown>(message: VoiceSe
     call?: undefined;
     partial?: undefined;
     scenarioId?: undefined;
+    sessionMetadata?: undefined;
     status?: undefined;
     turns?: undefined;
     turn?: undefined;
@@ -157,6 +165,7 @@ export declare const serverMessageToAction: <TResult = unknown>(message: VoiceSe
     partial: string;
     scenarioId: string | undefined;
     sessionId: string;
+    sessionMetadata: Record<string, unknown> | undefined;
     status: import("..").VoiceSessionStatus;
     turns: import("..").VoiceTurnRecord<TResult>[];
     type: "replay";
@@ -172,6 +181,7 @@ export declare const serverMessageToAction: <TResult = unknown>(message: VoiceSe
     turn?: undefined;
 } | {
     sessionId: string;
+    sessionMetadata: Record<string, unknown> | undefined;
     scenarioId: string | undefined;
     status: import("..").VoiceSessionStatus;
     type: "session";
@@ -206,6 +216,7 @@ export declare const serverMessageToAction: <TResult = unknown>(message: VoiceSe
     call?: undefined;
     partial?: undefined;
     scenarioId?: undefined;
+    sessionMetadata?: undefined;
     status?: undefined;
     turns?: undefined;
 } | null;

package/dist/client/htmxBootstrap.js

@@ -221,6 +221,7 @@ var serverMessageToAction = (message) => {
         partial: message.partial,
         scenarioId: message.scenarioId,
         sessionId: message.sessionId,
+        sessionMetadata: message.sessionMetadata,
         status: message.status,
         turns: message.turns,
         type: "replay"
@@ -228,6 +229,7 @@ var serverMessageToAction = (message) => {
     case "session":
       return {
         sessionId: message.sessionId,
+        sessionMetadata: message.sessionMetadata,
         scenarioId: message.scenarioId,
         status: message.status,
         type: "session"
@@ -744,6 +746,7 @@ var createInitialState = () => ({
   call: null,
   error: null,
   isConnected: false,
+  sessionMetadata: null,
   scenarioId: null,
   partial: "",
   reconnect: createInitialReconnectState(),
@@ -859,6 +862,7 @@ var createVoiceStreamStore = () => {
           } : state.reconnect,
           scenarioId: action.scenarioId ?? state.scenarioId,
           sessionId: action.sessionId,
+          sessionMetadata: action.sessionMetadata ?? state.sessionMetadata,
           status: action.status,
           turns: [...action.turns]
         };
@@ -870,6 +874,7 @@ var createVoiceStreamStore = () => {
           scenarioId: action.scenarioId ?? state.scenarioId,
           isConnected: action.status === "active",
           sessionId: action.sessionId,
+          sessionMetadata: action.sessionMetadata ?? state.sessionMetadata,
           status: action.status
         };
         break;
@@ -976,6 +981,9 @@ var createVoiceStream = (path, options = {}) => {
     get scenarioId() {
       return store.getSnapshot().scenarioId;
     },
+    get sessionMetadata() {
+      return store.getSnapshot().sessionMetadata;
+    },
     start,
     get partial() {
       return store.getSnapshot().partial;
@@ -1304,6 +1312,7 @@ var createInitialState2 = (stream) => ({
   reconnect: stream.reconnect,
   recordingError: null,
   sessionId: stream.sessionId,
+  sessionMetadata: stream.sessionMetadata,
   scenarioId: stream.scenarioId,
   status: stream.status,
   turns: [...stream.turns]
@@ -1333,6 +1342,7 @@ var createVoiceController = (path, options = {}) => {
       partial: stream.partial,
       reconnect: stream.reconnect,
       sessionId: stream.sessionId,
+      sessionMetadata: stream.sessionMetadata,
       scenarioId: stream.scenarioId,
       status: stream.status,
       turns: [...stream.turns]
@@ -1439,6 +1449,9 @@ var createVoiceController = (path, options = {}) => {
     get sessionId() {
       return state.sessionId;
     },
+    get sessionMetadata() {
+      return state.sessionMetadata;
+    },
     get scenarioId() {
       return state.scenarioId;
     },

package/dist/client/index.js

@@ -759,6 +759,7 @@ var serverMessageToAction = (message) => {
         partial: message.partial,
         scenarioId: message.scenarioId,
         sessionId: message.sessionId,
+        sessionMetadata: message.sessionMetadata,
         status: message.status,
         turns: message.turns,
         type: "replay"
@@ -766,6 +767,7 @@ var serverMessageToAction = (message) => {
     case "session":
       return {
         sessionId: message.sessionId,
+        sessionMetadata: message.sessionMetadata,
         scenarioId: message.scenarioId,
         status: message.status,
         type: "session"
@@ -1527,6 +1529,7 @@ var createInitialState2 = () => ({
   call: null,
   error: null,
   isConnected: false,
+  sessionMetadata: null,
   scenarioId: null,
   partial: "",
   reconnect: createInitialReconnectState(),
@@ -1642,6 +1645,7 @@ var createVoiceStreamStore = () => {
           } : state.reconnect,
           scenarioId: action.scenarioId ?? state.scenarioId,
           sessionId: action.sessionId,
+          sessionMetadata: action.sessionMetadata ?? state.sessionMetadata,
           status: action.status,
           turns: [...action.turns]
         };
@@ -1653,6 +1657,7 @@ var createVoiceStreamStore = () => {
           scenarioId: action.scenarioId ?? state.scenarioId,
           isConnected: action.status === "active",
           sessionId: action.sessionId,
+          sessionMetadata: action.sessionMetadata ?? state.sessionMetadata,
           status: action.status
         };
         break;
@@ -1759,6 +1764,9 @@ var createVoiceStream = (path, options = {}) => {
     get scenarioId() {
       return store.getSnapshot().scenarioId;
     },
+    get sessionMetadata() {
+      return store.getSnapshot().sessionMetadata;
+    },
     start,
     get partial() {
       return store.getSnapshot().partial;
@@ -2265,6 +2273,7 @@ var createInitialState3 = (stream) => ({
   reconnect: stream.reconnect,
   recordingError: null,
   sessionId: stream.sessionId,
+  sessionMetadata: stream.sessionMetadata,
   scenarioId: stream.scenarioId,
   status: stream.status,
   turns: [...stream.turns]
@@ -2294,6 +2303,7 @@ var createVoiceController = (path, options = {}) => {
       partial: stream.partial,
       reconnect: stream.reconnect,
       sessionId: stream.sessionId,
+      sessionMetadata: stream.sessionMetadata,
       scenarioId: stream.scenarioId,
       status: stream.status,
       turns: [...stream.turns]
@@ -2400,6 +2410,9 @@ var createVoiceController = (path, options = {}) => {
     get sessionId() {
       return state.sessionId;
     },
+    get sessionMetadata() {
+      return state.sessionMetadata;
+    },
     get scenarioId() {
       return state.scenarioId;
     },

package/dist/index.js

@@ -3703,6 +3703,7 @@ var createVoiceSession = (options) => {
       partial: session.currentTurn.partialText,
       scenarioId: session.scenarioId,
       sessionId: options.id,
+      sessionMetadata: session.metadata && typeof session.metadata === "object" ? session.metadata : undefined,
       status: session.status,
       turns: session.turns,
       type: "replay"
@@ -5048,6 +5049,7 @@ var createVoiceSession = (options) => {
     await send({
       sessionId: options.id,
       status: session.status,
+      sessionMetadata: session.metadata && typeof session.metadata === "object" ? session.metadata : undefined,
       scenarioId: session.scenarioId,
       type: "session"
     });
@@ -5465,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,
@@ -5494,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,
@@ -5730,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,
@@ -5745,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,
@@ -5762,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,
@@ -5785,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/react/index.js

@@ -6363,6 +6363,7 @@ var serverMessageToAction = (message) => {
         partial: message.partial,
         scenarioId: message.scenarioId,
         sessionId: message.sessionId,
+        sessionMetadata: message.sessionMetadata,
         status: message.status,
         turns: message.turns,
         type: "replay"
@@ -6370,6 +6371,7 @@ var serverMessageToAction = (message) => {
     case "session":
       return {
         sessionId: message.sessionId,
+        sessionMetadata: message.sessionMetadata,
         scenarioId: message.scenarioId,
         status: message.status,
         type: "session"
@@ -7395,6 +7397,7 @@ var createInitialState = () => ({
   call: null,
   error: null,
   isConnected: false,
+  sessionMetadata: null,
   scenarioId: null,
   partial: "",
   reconnect: createInitialReconnectState(),
@@ -7510,6 +7513,7 @@ var createVoiceStreamStore = () => {
           } : state.reconnect,
           scenarioId: action.scenarioId ?? state.scenarioId,
           sessionId: action.sessionId,
+          sessionMetadata: action.sessionMetadata ?? state.sessionMetadata,
           status: action.status,
           turns: [...action.turns]
         };
@@ -7521,6 +7525,7 @@ var createVoiceStreamStore = () => {
           scenarioId: action.scenarioId ?? state.scenarioId,
           isConnected: action.status === "active",
           sessionId: action.sessionId,
+          sessionMetadata: action.sessionMetadata ?? state.sessionMetadata,
           status: action.status
         };
         break;
@@ -7627,6 +7632,9 @@ var createVoiceStream = (path, options = {}) => {
     get scenarioId() {
       return store.getSnapshot().scenarioId;
     },
+    get sessionMetadata() {
+      return store.getSnapshot().sessionMetadata;
+    },
     start,
     get partial() {
       return store.getSnapshot().partial;
@@ -7678,6 +7686,7 @@ var EMPTY_SNAPSHOT = {
     status: "idle"
   },
   sessionId: "",
+  sessionMetadata: null,
   status: "idle",
   turns: []
 };
@@ -8170,6 +8179,7 @@ var createInitialState2 = (stream) => ({
   reconnect: stream.reconnect,
   recordingError: null,
   sessionId: stream.sessionId,
+  sessionMetadata: stream.sessionMetadata,
   scenarioId: stream.scenarioId,
   status: stream.status,
   turns: [...stream.turns]
@@ -8199,6 +8209,7 @@ var createVoiceController = (path, options = {}) => {
       partial: stream.partial,
       reconnect: stream.reconnect,
       sessionId: stream.sessionId,
+      sessionMetadata: stream.sessionMetadata,
       scenarioId: stream.scenarioId,
       status: stream.status,
       turns: [...stream.turns]
@@ -8305,6 +8316,9 @@ var createVoiceController = (path, options = {}) => {
     get sessionId() {
       return state.sessionId;
     },
+    get sessionMetadata() {
+      return state.sessionMetadata;
+    },
     get scenarioId() {
       return state.scenarioId;
     },

package/dist/react/useVoiceController.d.ts

@@ -9,6 +9,7 @@ export declare const useVoiceController: <TResult = unknown>(path: string, optio
     stopRecording: () => void;
     toggleRecording: () => Promise<void>;
     call: import("..").VoiceCallLifecycleState | null;
+    sessionMetadata: Record<string, unknown> | null;
     sessionId: string | null;
     scenarioId: string | null;
     status: import("..").VoiceSessionStatus | "idle";

package/dist/react/useVoiceStream.d.ts

@@ -5,6 +5,7 @@ export declare const useVoiceStream: <TResult = unknown>(path: string, options?:
     endTurn: () => void;
     sendAudio: (audio: Uint8Array | ArrayBuffer) => void;
     call: import("..").VoiceCallLifecycleState | null;
+    sessionMetadata: Record<string, unknown> | null;
     sessionId: string | null;
     scenarioId: string | null;
     status: import("..").VoiceSessionStatus | "idle";

package/dist/svelte/index.js

@@ -3421,6 +3421,7 @@ var serverMessageToAction = (message) => {
         partial: message.partial,
         scenarioId: message.scenarioId,
         sessionId: message.sessionId,
+        sessionMetadata: message.sessionMetadata,
         status: message.status,
         turns: message.turns,
         type: "replay"
@@ -3428,6 +3429,7 @@ var serverMessageToAction = (message) => {
     case "session":
       return {
         sessionId: message.sessionId,
+        sessionMetadata: message.sessionMetadata,
         scenarioId: message.scenarioId,
         status: message.status,
         type: "session"
@@ -4453,6 +4455,7 @@ var createInitialState = () => ({
   call: null,
   error: null,
   isConnected: false,
+  sessionMetadata: null,
   scenarioId: null,
   partial: "",
   reconnect: createInitialReconnectState(),
@@ -4568,6 +4571,7 @@ var createVoiceStreamStore = () => {
           } : state.reconnect,
           scenarioId: action.scenarioId ?? state.scenarioId,
           sessionId: action.sessionId,
+          sessionMetadata: action.sessionMetadata ?? state.sessionMetadata,
           status: action.status,
           turns: [...action.turns]
         };
@@ -4579,6 +4583,7 @@ var createVoiceStreamStore = () => {
           scenarioId: action.scenarioId ?? state.scenarioId,
           isConnected: action.status === "active",
           sessionId: action.sessionId,
+          sessionMetadata: action.sessionMetadata ?? state.sessionMetadata,
           status: action.status
         };
         break;
@@ -4685,6 +4690,9 @@ var createVoiceStream = (path, options = {}) => {
     get scenarioId() {
       return store.getSnapshot().scenarioId;
     },
+    get sessionMetadata() {
+      return store.getSnapshot().sessionMetadata;
+    },
     start,
     get partial() {
       return store.getSnapshot().partial;
@@ -6489,6 +6497,7 @@ var createInitialState2 = (stream) => ({
   reconnect: stream.reconnect,
   recordingError: null,
   sessionId: stream.sessionId,
+  sessionMetadata: stream.sessionMetadata,
   scenarioId: stream.scenarioId,
   status: stream.status,
   turns: [...stream.turns]
@@ -6518,6 +6527,7 @@ var createVoiceController = (path, options = {}) => {
       partial: stream.partial,
       reconnect: stream.reconnect,
       sessionId: stream.sessionId,
+      sessionMetadata: stream.sessionMetadata,
       scenarioId: stream.scenarioId,
       status: stream.status,
       turns: [...stream.turns]
@@ -6624,6 +6634,9 @@ var createVoiceController = (path, options = {}) => {
     get sessionId() {
       return state.sessionId;
     },
+    get sessionMetadata() {
+      return state.sessionMetadata;
+    },
     get scenarioId() {
       return state.scenarioId;
     },

package/dist/testing/index.js

@@ -2138,6 +2138,7 @@ var serverMessageToAction = (message) => {
         partial: message.partial,
         scenarioId: message.scenarioId,
         sessionId: message.sessionId,
+        sessionMetadata: message.sessionMetadata,
         status: message.status,
         turns: message.turns,
         type: "replay"
@@ -2145,6 +2146,7 @@ var serverMessageToAction = (message) => {
     case "session":
       return {
         sessionId: message.sessionId,
+        sessionMetadata: message.sessionMetadata,
         scenarioId: message.scenarioId,
         status: message.status,
         type: "session"
@@ -3170,6 +3172,7 @@ var createInitialState2 = () => ({
   call: null,
   error: null,
   isConnected: false,
+  sessionMetadata: null,
   scenarioId: null,
   partial: "",
   reconnect: createInitialReconnectState(),
@@ -3285,6 +3288,7 @@ var createVoiceStreamStore = () => {
           } : state.reconnect,
           scenarioId: action.scenarioId ?? state.scenarioId,
           sessionId: action.sessionId,
+          sessionMetadata: action.sessionMetadata ?? state.sessionMetadata,
           status: action.status,
           turns: [...action.turns]
         };
@@ -3296,6 +3300,7 @@ var createVoiceStreamStore = () => {
           scenarioId: action.scenarioId ?? state.scenarioId,
           isConnected: action.status === "active",
           sessionId: action.sessionId,
+          sessionMetadata: action.sessionMetadata ?? state.sessionMetadata,
           status: action.status
         };
         break;
@@ -3402,6 +3407,9 @@ var createVoiceStream = (path, options = {}) => {
     get scenarioId() {
       return store.getSnapshot().scenarioId;
     },
+    get sessionMetadata() {
+      return store.getSnapshot().sessionMetadata;
+    },
     start,
     get partial() {
       return store.getSnapshot().partial;
@@ -3767,6 +3775,7 @@ var createInitialState3 = (stream) => ({
   reconnect: stream.reconnect,
   recordingError: null,
   sessionId: stream.sessionId,
+  sessionMetadata: stream.sessionMetadata,
   scenarioId: stream.scenarioId,
   status: stream.status,
   turns: [...stream.turns]
@@ -3796,6 +3805,7 @@ var createVoiceController = (path, options = {}) => {
       partial: stream.partial,
       reconnect: stream.reconnect,
       sessionId: stream.sessionId,
+      sessionMetadata: stream.sessionMetadata,
       scenarioId: stream.scenarioId,
       status: stream.status,
       turns: [...stream.turns]
@@ -3902,6 +3912,9 @@ var createVoiceController = (path, options = {}) => {
     get sessionId() {
       return state.sessionId;
     },
+    get sessionMetadata() {
+      return state.sessionMetadata;
+    },
     get scenarioId() {
       return state.scenarioId;
     },
@@ -6272,6 +6285,7 @@ var createVoiceSession = (options) => {
       partial: session.currentTurn.partialText,
       scenarioId: session.scenarioId,
       sessionId: options.id,
+      sessionMetadata: session.metadata && typeof session.metadata === "object" ? session.metadata : undefined,
       status: session.status,
       turns: session.turns,
       type: "replay"
@@ -7617,6 +7631,7 @@ var createVoiceSession = (options) => {
     await send({
       sessionId: options.id,
       status: session.status,
+      sessionMetadata: session.metadata && typeof session.metadata === "object" ? session.metadata : undefined,
       scenarioId: session.scenarioId,
       type: "session"
     });

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: {
@@ -734,6 +737,7 @@ export type VoiceServerSessionMessage = {
     sessionId: string;
     status: VoiceSessionStatus;
     scenarioId?: string;
+    sessionMetadata?: Record<string, unknown>;
 };
 export type VoiceServerReplayMessage<TResult = unknown> = {
     type: 'replay';
@@ -742,6 +746,7 @@ export type VoiceServerReplayMessage<TResult = unknown> = {
     partial: string;
     scenarioId?: string;
     sessionId: string;
+    sessionMetadata?: Record<string, unknown>;
     status: VoiceSessionStatus;
     turns: VoiceTurnRecord<TResult>[];
 };
@@ -931,6 +936,7 @@ export type VoiceHTMXOptions<TSession extends VoiceSessionRecord = VoiceSessionR
 export type VoiceHTMXConfig<TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = VoiceHTMXRenderer<TSession, TResult> | VoiceHTMXOptions<TSession, TResult>;
 export type VoiceStreamState<TResult = unknown> = {
     call: VoiceCallLifecycleState | null;
+    sessionMetadata: Record<string, unknown> | null;
     sessionId: string | null;
     scenarioId: string | null;
     status: VoiceSessionStatus | 'idle';
@@ -964,6 +970,7 @@ export type VoiceStream<TResult = unknown> = {
     reconnect: VoiceReconnectClientState;
     sendAudio: (audio: Uint8Array | ArrayBuffer) => void;
     sessionId: string | null;
+    sessionMetadata: Record<string, unknown> | null;
     scenarioId: string | null;
     status: VoiceSessionStatus | 'idle';
     subscribe: (subscriber: () => void) => () => void;
@@ -1035,6 +1042,7 @@ export type VoiceController<TResult = unknown> = {
     recordingError: string | null;
     sendAudio: (audio: Uint8Array | ArrayBuffer) => void;
     sessionId: string | null;
+    sessionMetadata: Record<string, unknown> | null;
     scenarioId: string | null;
     startRecording: () => Promise<void>;
     status: VoiceSessionStatus | 'idle';
@@ -1063,6 +1071,7 @@ export type VoiceHTMXBindingOptions = {
 export type VoiceStoreAction<TResult = unknown> = {
     type: 'session';
     sessionId: string;
+    sessionMetadata?: Record<string, unknown>;
     scenarioId?: string;
     status: VoiceSessionStatus;
 } | {
@@ -1072,6 +1081,7 @@ export type VoiceStoreAction<TResult = unknown> = {
     partial: string;
     scenarioId?: string;
     sessionId: string;
+    sessionMetadata?: Record<string, unknown>;
     status: VoiceSessionStatus;
     turns: VoiceTurnRecord<TResult>[];
 } | {

package/dist/vue/index.js

@@ -5743,6 +5743,7 @@ var serverMessageToAction = (message) => {
         partial: message.partial,
         scenarioId: message.scenarioId,
         sessionId: message.sessionId,
+        sessionMetadata: message.sessionMetadata,
         status: message.status,
         turns: message.turns,
         type: "replay"
@@ -5750,6 +5751,7 @@ var serverMessageToAction = (message) => {
     case "session":
       return {
         sessionId: message.sessionId,
+        sessionMetadata: message.sessionMetadata,
         scenarioId: message.scenarioId,
         status: message.status,
         type: "session"
@@ -6775,6 +6777,7 @@ var createInitialState = () => ({
   call: null,
   error: null,
   isConnected: false,
+  sessionMetadata: null,
   scenarioId: null,
   partial: "",
   reconnect: createInitialReconnectState(),
@@ -6890,6 +6893,7 @@ var createVoiceStreamStore = () => {
           } : state.reconnect,
           scenarioId: action.scenarioId ?? state.scenarioId,
           sessionId: action.sessionId,
+          sessionMetadata: action.sessionMetadata ?? state.sessionMetadata,
           status: action.status,
           turns: [...action.turns]
         };
@@ -6901,6 +6905,7 @@ var createVoiceStreamStore = () => {
           scenarioId: action.scenarioId ?? state.scenarioId,
           isConnected: action.status === "active",
           sessionId: action.sessionId,
+          sessionMetadata: action.sessionMetadata ?? state.sessionMetadata,
           status: action.status
         };
         break;
@@ -7007,6 +7012,9 @@ var createVoiceStream = (path, options = {}) => {
     get scenarioId() {
       return store.getSnapshot().scenarioId;
     },
+    get sessionMetadata() {
+      return store.getSnapshot().sessionMetadata;
+    },
     start,
     get partial() {
       return store.getSnapshot().partial;
@@ -7055,6 +7063,7 @@ function useVoiceStream(path, options = {}) {
   const partial = ref13("");
   const reconnect = shallowRef16(stream.reconnect);
   const sessionId = ref13(stream.sessionId);
+  const sessionMetadata = shallowRef16(stream.sessionMetadata);
   const status = ref13(stream.status);
   const turns = shallowRef16([]);
   const sync = () => {
@@ -7066,6 +7075,7 @@ function useVoiceStream(path, options = {}) {
     partial.value = stream.partial;
     reconnect.value = stream.reconnect;
     sessionId.value = stream.sessionId;
+    sessionMetadata.value = stream.sessionMetadata;
     status.value = stream.status;
     turns.value = [...stream.turns];
   };
@@ -7089,6 +7099,7 @@ function useVoiceStream(path, options = {}) {
     reconnect,
     sendAudio: (audio) => stream.sendAudio(audio),
     sessionId,
+    sessionMetadata,
     status,
     turns
   };
@@ -7566,6 +7577,7 @@ var createInitialState2 = (stream) => ({
   reconnect: stream.reconnect,
   recordingError: null,
   sessionId: stream.sessionId,
+  sessionMetadata: stream.sessionMetadata,
   scenarioId: stream.scenarioId,
   status: stream.status,
   turns: [...stream.turns]
@@ -7595,6 +7607,7 @@ var createVoiceController = (path, options = {}) => {
       partial: stream.partial,
       reconnect: stream.reconnect,
       sessionId: stream.sessionId,
+      sessionMetadata: stream.sessionMetadata,
       scenarioId: stream.scenarioId,
       status: stream.status,
       turns: [...stream.turns]
@@ -7701,6 +7714,9 @@ var createVoiceController = (path, options = {}) => {
     get sessionId() {
       return state.sessionId;
     },
+    get sessionMetadata() {
+      return state.sessionMetadata;
+    },
     get scenarioId() {
       return state.scenarioId;
     },

package/dist/vue/useVoiceStream.d.ts

@@ -22,6 +22,7 @@ export declare function useVoiceStream<TResult = unknown>(path: string, options?
     reconnect: import("vue").ShallowRef<import("..").VoiceReconnectClientState, import("..").VoiceReconnectClientState>;
     sendAudio: (audio: Uint8Array | ArrayBuffer) => void;
     sessionId: import("vue").Ref<string | null, string | null>;
+    sessionMetadata: import("vue").ShallowRef<Record<string, unknown> | null, Record<string, unknown> | null>;
     status: import("vue").Ref<import("..").VoiceSessionStatus | "idle", import("..").VoiceSessionStatus | "idle">;
     turns: import("vue").ShallowRef<VoiceTurnRecord<TResult>[], VoiceTurnRecord<TResult>[]>;
 };

package/package.json

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