@glydeunity/voice-sdk 1.5.18 → 1.5.21

package/dist/index.d.ts

@@ -323,6 +323,15 @@ export declare const componentStyles: {
     };
 };
 
+/**
+ * Payload when the server requests a context switch (e.g. screening -> candidate_discover or after create_application).
+ * contextType may be any server-returned context (e.g. 'screening', 'candidate_discover').
+ */
+export declare interface ContextSwitchPayload {
+    contextType: string;
+    contextId: string;
+}
+
 /**
  * Conversation summary from Unity API
  */
@@ -647,6 +656,10 @@ export declare class GlydeVoice {
     private readonly inputSampleRate;
     private isAgentSpeaking;
     private agentAudioDoneReceived;
+    /** Pending context reinit after context_switch; run when agent stops speaking or after fallback timeout */
+    private pendingContextReinit;
+    private pendingContextReinitFallbackTimer;
+    private static readonly PENDING_REINIT_FALLBACK_MS;
     private conversationHistory;
     private sessionContext;
     /**
@@ -786,6 +799,20 @@ export declare class GlydeVoice {
         contextType?: VoiceContextType_2;
         currentJobUuid?: string;
     }): void;
+    /**
+     * If a context reinit was pending (after context_switch), run it now. Called when the agent
+     * stops speaking (playback buffer empty) or when the fallback timeout fires.
+     */
+    private tryFlushPendingContextReinit;
+    /**
+     * Reinitialize the voice session with a new context (e.g. after context_switch from the server).
+     * Stops the current session, updates config and session context, then starts a new session
+     * so chat history is stored under the correct application/placeholder.
+     *
+     * @param contextType - New voice context type (e.g. 'screening', 'candidate_discover')
+     * @param contextId - New context ID (e.g. application_uuid, candidate_uuid)
+     */
+    reinitializeWithContext(contextType: VoiceContextType_2, contextId: string): Promise<void>;
 }
 
 /**
@@ -845,7 +872,7 @@ declare interface GlydeVoiceConfig_2 {
     /** DOM element to render the widget UI (optional) */
     container?: HTMLElement | string;
     /** Event callback for voice agent events */
-    onEvent?: (event: VoiceEvent_2) => void;
+    onEvent?: (event: VoiceEvent) => void;
     /** Transcript callback for conversation text */
     onTranscript?: (text: string, role: 'user' | 'agent') => void;
     /** Previous conversation history to continue the conversation */
@@ -1250,52 +1277,6 @@ declare interface VoiceConfig_2 {
  */
 export declare type VoiceContextType = 'screening' | 'recruiter' | 'custom' | 'phone';
 
-/**
- * GlydeVoice SDK - Voice Agent Client for GLYDE Unity
- *
- * Provides voice interaction capabilities with GLYDE AI agents through Deepgram Voice API.
- * Supports multiple authentication methods: publishableKey, apiKey, and JWT token.
- *
- * Context Types:
- * - screening: Known candidate with application_uuid - screening interview
- * - recruiter: Internal recruiter copilot
- * - custom: Custom context with overridden prompts
- * - phone: Phone agent context
- * - discovery: Unknown candidate, no job - guide to opportunities (publishable_key only)
- * - job_apply: Unknown candidate, known job - apply to specific job (contextId = job_uuid)
- * - candidate_discover: Known candidate (OTP verified), no job - explore opportunities (contextId = candidate_uuid)
- * - candidate_apply: Known candidate, known job - apply and start screening (contextId = candidate_uuid:job_uuid)
- *
- * @example
- * // Screening interview for existing application
- * const voice = new GlydeVoice({
- *   publishableKey: 'pk_...',
- *   contextType: 'screening',
- *   contextId: 'application-uuid'
- * });
- *
- * @example
- * // Discovery mode - unknown candidate exploring opportunities
- * const voice = new GlydeVoice({
- *   publishableKey: 'pk_...',
- *   contextType: 'discovery'
- * });
- *
- * @example
- * // Job apply - unknown candidate applying to specific job
- * const voice = new GlydeVoice({
- *   publishableKey: 'pk_...',
- *   contextType: 'job_apply',
- *   contextId: 'job-uuid'
- * });
- *
- * @example
- * // Using JWT token (GLYDEBuddy Teams app)
- * const voice = new GlydeVoice({
- *   authToken: userSession.accessToken,
- *   contextType: 'recruiter'
- * });
- */
 /**
  * Voice context types supported by the voice agent
  * - screening: Known candidate with application_uuid - screening interview
@@ -1313,15 +1294,7 @@ declare type VoiceContextType_2 = 'screening' | 'recruiter' | 'custom' | 'phone'
  * Voice events emitted by the agent
  */
 export declare interface VoiceEvent {
-    type: 'open' | 'close' | 'error' | 'ready' | 'user_speaking' | 'agent_speaking' | 'microphone_ready' | 'transcript' | 'agent_audio';
-    payload?: unknown;
-}
-
-/**
- * Voice events emitted by the agent
- */
-declare interface VoiceEvent_2 {
-    type: 'open' | 'close' | 'error' | 'ready' | 'user_speaking' | 'agent_speaking' | 'microphone_ready' | 'transcript' | 'agent_audio';
+    type: 'open' | 'close' | 'error' | 'ready' | 'user_speaking' | 'agent_speaking' | 'microphone_ready' | 'transcript' | 'agent_audio' | 'context_switch';
     payload?: unknown;
 }