Append session settings to messages array

packages/react/src/lib/VoiceProvider.tsx

@@ -353,6 +353,17 @@ export const VoiceProvider: FC<VoiceProviderProps> = ({
         toolStatus,
       ],
     ),
+    onSessionSettings: useCallback(
+      (sessionSettings: Hume.empathicVoice.SessionSettings) => {
+        if (checkIsDisconnecting() || checkIsDisconnected()) {
+          // disconnection in progress, and resources are being cleaned up.
+          // ignore the message
+          return;
+        }
+        messageStore.createSessionSettingsMessage(sessionSettings);
+      },
+      [checkIsDisconnected, checkIsDisconnecting, messageStore],
+    ),
     onClientError,
     onToolCallError: useCallback(
       (message: string, err?: Error) => {

packages/react/src/lib/connection-message.ts

@@ -1,3 +1,4 @@
+import type { Hume } from 'hume';
 import type { CloseEvent } from 'hume/core';
 
 export type ConnectionMessage =
@@ -10,4 +11,9 @@ export type ConnectionMessage =
       code: CloseEvent['code'];
       reason: CloseEvent['reason'];
       receivedAt: Date;
+    }
+  | {
+      type: 'session_settings';
+      sessionSettings: Hume.empathicVoice.SessionSettings;
+      receivedAt: Date;
     };

packages/react/src/lib/useMessages.ts

@@ -1,3 +1,4 @@
+import type { Hume } from 'hume';
 import type { CloseEvent } from 'hume/core';
 import { useCallback, useState } from 'react';
 
@@ -49,6 +50,21 @@ export const useMessages = ({
     );
   }, []);
 
+  const createSessionSettingsMessage = useCallback(
+    (sessionSettings: Hume.empathicVoice.SessionSettings) => {
+      setMessages((prev) =>
+        prev.concat([
+          {
+            type: 'session_settings',
+            sessionSettings,
+            receivedAt: new Date(),
+          },
+        ]),
+      );
+    },
+    [],
+  );
+
   const createDisconnectMessage = useCallback((event: CloseEvent) => {
     setMessages((prev) =>
       prev.concat([
@@ -221,6 +237,7 @@ export const useMessages = ({
   return {
     createConnectMessage,
     createDisconnectMessage,
+    createSessionSettingsMessage,
     onMessage,
     onPlayAudio,
     clearMessages,

packages/react/src/lib/useVoiceClient.ts

@@ -88,6 +88,7 @@
 export const useVoiceClient = (props: {
   onAudioMessage?: (message: AudioOutputMessage) => void;
   onMessage?: (message: JSONMessage) => void;
+  onSessionSettings?: (sessionSettings: Hume.empathicVoice.SessionSettings) => void;
   onToolCall?: ToolCallHandler;
   onToolCallError?: (message: string, error?: Error) => void;
   onClientError?: (message: string, error?: Error) => void;
@@ -112,6 +113,9 @@
   const onMessage = useRef<typeof props.onMessage>(props.onMessage);
   onMessage.current = props.onMessage;
 
+  const onSessionSettings = useRef<typeof props.onSessionSettings>(props.onSessionSettings);
+  onSessionSettings.current = props.onSessionSettings;
+
   const onToolCall = useRef<typeof props.onToolCall>(props.onToolCall);
   onToolCall.current = props.onToolCall;
 
@@ -198,6 +202,7 @@
             signal.removeEventListener('abort', abortHandler);
             if (postConnectSettings) {
               socket.sendSessionSettings(postConnectSettings);
+              onSessionSettings.current?.(postConnectSettings);
             }
             resolve(VoiceReadyState.OPEN);
           }
@@ -320,6 +325,7 @@
         return;
       }
       client.current?.sendSessionSettings(sessionSettings);
+      onSessionSettings.current?.(sessionSettings);
     },
     [readyState],
   );