@glydeunity/voice-sdk 1.6.26 → 1.6.27

package/dist/index.d.ts

@@ -39,6 +39,21 @@ import { default as default_2 } from 'react';
  */
 export declare const ActivityIcon: default_2.FC<IconProps>;
 
+/**
+ * Agent metadata returned by the voice config endpoint.
+ * Used to populate dynamic headers in both VoiceChat and TextChat.
+ */
+export declare interface AgentMetadata {
+    /** Display name for the AI agent (e.g. "Chris") */
+    agent_name?: string;
+    /** Company or staffing agency name (e.g. "Acme Staffing") */
+    company_name?: string;
+    /** Job title when in a job-specific context */
+    job_title?: string;
+    /** Greeting phrase (server-controlled first message) */
+    greeting?: string;
+}
+
 /**
  * Authentication method used by the client
  */
@@ -720,6 +735,7 @@ export declare class GlydeText extends BaseGlydeClient<GlydeTextConfig, TextChat
     private conversationSummary;
     private contextSwitchManager;
     private currentContextType;
+    private agentMetadata;
     /**
      * Create a new GlydeText instance
      * @param config - Configuration options
@@ -805,6 +821,16 @@ export declare class GlydeText extends BaseGlydeClient<GlydeTextConfig, TextChat
      * Get the current context type
      */
     getContextType(): VoiceContextType;
+    /**
+     * Fetch agent metadata from the voice config endpoint.
+     * Populates `agentMetadata` with agent name, company, job title, and greeting.
+     * Called during initialize(); failures are non-fatal.
+     */
+    fetchMetadata(): Promise<AgentMetadata | null>;
+    /**
+     * Get the agent metadata (available after initialize or fetchMetadata)
+     */
+    getAgentMetadata(): AgentMetadata | null;
     /**
      * Perform smooth context update (no full reinit)
      * For text chat, this just updates internal state
@@ -1228,8 +1254,6 @@ export declare interface TextChatProps {
     unityApiUrl?: string;
     /** Fixed height for the component */
     height?: string | number;
-    /** Header title */
-    title?: string;
     /** Placeholder text for input */
     placeholder?: string;
     /** Auto-initialize chat on mount */
@@ -1238,6 +1262,8 @@ export declare interface TextChatProps {
     onMessage?: (message: ChatMessage) => void;
     /** Callback when error occurs */
     onError?: (error: Error) => void;
+    /** Callback when context switches (e.g. screening -> candidate_discover) */
+    onContextSwitch?: (contextType: string, contextId: string) => void;
 }
 
 /**
@@ -1337,6 +1363,8 @@ export declare function useTextChat(config: UseTextChatConfig): UseTextChatRetur
 export declare interface UseTextChatConfig extends Omit<GlydeTextConfig, 'onEvent' | 'onMessage' | 'onTyping'> {
     /** Auto-initialize the chat on mount */
     autoInit?: boolean;
+    /** Callback when context switches (e.g. screening -> candidate_discover) */
+    onContextSwitch?: (payload: ContextSwitchPayload) => void;
 }
 
 /**
@@ -1351,6 +1379,8 @@ export declare interface UseTextChatReturn {
     isLoading: boolean;
     /** Error message if status is 'error' */
     errorMessage: string | null;
+    /** Agent metadata from voice config (agent_name, company_name, etc.) */
+    agentMetadata: AgentMetadata | null;
     /** Initialize the chat session */
     initialize: () => Promise<void>;
     /** Send a message */
@@ -1393,6 +1423,8 @@ export declare interface UseVoiceAgentReturn {
     isMuted: boolean;
     /** Error message if status is 'error' */
     errorMessage: string | null;
+    /** Agent metadata from voice config (agent_name, company_name, etc.) */
+    agentMetadata: AgentMetadata | null;
     /** Start the voice session */
     start: () => Promise<void>;
     /** Stop the voice session */
@@ -1466,6 +1498,8 @@ export declare interface VoiceConfig {
         type: VoiceContextType;
         id: string | null;
     };
+    /** Agent/company metadata for dynamic UI headers */
+    metadata?: AgentMetadata;
 }
 
 /**