@volley/recognition-client-sdk 0.1.296 → 0.1.381

package/src/simplified-vgf-recognition-client.ts

@@ -150,34 +150,44 @@ export class SimplifiedVGFRecognitionClient implements ISimplifiedVGFRecognition
     private state: RecognitionState;
     private isRecordingAudio: boolean = false;
     private stateChangeCallback: ((state: RecognitionState) => void) | undefined;
+    private expectedUuid: string;
+    private logger: IRecognitionClientConfig['logger'];
 
     constructor(config: SimplifiedVGFClientConfig) {
         const { onStateChange, initialState, ...clientConfig } = config;
         this.stateChangeCallback = onStateChange;
+        this.logger = clientConfig.logger;
 
         // Use provided initial state or create from config
         if (initialState) {
-            // If previous session is in terminal state (ABORTED/FINALIZED), force new UUID
-            // This prevents server from attaching to completed session which silently drops audio
-            if (initialState.transcriptionStatus === TranscriptionStatus.ABORTED ||
-                initialState.transcriptionStatus === TranscriptionStatus.FINALIZED) {
+            // Check if initial state has a valid UUID
+            const needsNewUuid = !initialState.audioUtteranceId ||
+                                initialState.audioUtteranceId === '' ||
+                                initialState.transcriptionStatus === TranscriptionStatus.ABORTED ||
+                                initialState.transcriptionStatus === TranscriptionStatus.FINALIZED;
 
+            if (needsNewUuid) {
                 // Generate new UUID for fresh session
                 const newUUID = crypto.randomUUID();
 
                 if (clientConfig.logger) {
-                    clientConfig.logger('info', `Terminal session detected (${initialState.transcriptionStatus}), generating new UUID: ${newUUID}`);
+                    const reason = !initialState.audioUtteranceId ? 'Missing UUID' :
+                                 initialState.audioUtteranceId === '' ? 'Empty UUID' :
+                                 `Terminal session (${initialState.transcriptionStatus})`;
+                    clientConfig.logger('info', `${reason} detected, generating new UUID: ${newUUID}`);
                 }
 
-                // Update state with new UUID and reset session-specific fields
+                // Update state with new UUID and reset session-specific fields if terminal
                 this.state = {
                     ...initialState,
                     audioUtteranceId: newUUID,
-                    // Reset status fields for fresh session
-                    transcriptionStatus: TranscriptionStatus.NOT_STARTED,
-                    startRecordingStatus: RecordingStatus.READY,
-                    // Clear previous session's transcript
-                    finalTranscript: undefined
+                    // Reset status fields for fresh session if terminal state
+                    ...(initialState.transcriptionStatus === TranscriptionStatus.ABORTED ||
+                        initialState.transcriptionStatus === TranscriptionStatus.FINALIZED ? {
+                        transcriptionStatus: TranscriptionStatus.NOT_STARTED,
+                        startRecordingStatus: RecordingStatus.READY,
+                        finalTranscript: undefined
+                    } : {})
                 };
 
                 // Use new UUID in client config
@@ -188,7 +198,7 @@ export class SimplifiedVGFRecognitionClient implements ISimplifiedVGFRecognition
                     onStateChange(this.state);
                 }
             } else {
-                // Non-terminal state - safe to reuse UUID (e.g., reconnecting to IN_PROGRESS session)
+                // Non-terminal state with valid UUID - safe to reuse (e.g., reconnecting to IN_PROGRESS session)
                 this.state = initialState;
                 // Override audioUtteranceId in config if state has one
                 if (initialState.audioUtteranceId && !clientConfig.audioUtteranceId) {
@@ -203,6 +213,9 @@ export class SimplifiedVGFRecognitionClient implements ISimplifiedVGFRecognition
         // Client is immediately ready to accept audio (will buffer if not connected)
         this.state = { ...this.state, startRecordingStatus: 'READY' };
 
+        // Track the expected UUID for this session
+        this.expectedUuid = this.state.audioUtteranceId;
+
         // If VGF state has promptSlotMap, configure gameContext to use it
         if (this.state.promptSlotMap) {
             // Set useContext=true in ASR config to enable context processing
@@ -229,6 +242,20 @@ export class SimplifiedVGFRecognitionClient implements ISimplifiedVGFRecognition
 
             // These callbacks ONLY update the VGF state sink
             onTranscript: (result) => {
+                // Skip update if UUID doesn't match (stale callback from previous session)
+                if (result.audioUtteranceId && result.audioUtteranceId !== this.expectedUuid) {
+                    if (this.logger) {
+                        this.logger('warn',
+                            `[VGF] Skipping transcript update: UUID mismatch (expected: ${this.expectedUuid}, got: ${result.audioUtteranceId})`
+                        );
+                    }
+                    // Still call original callback if provided
+                    if (clientConfig.onTranscript) {
+                        clientConfig.onTranscript(result);
+                    }
+                    return;
+                }
+
                 // Update VGF state based on transcript
                 this.state = mapTranscriptionResultToState(this.state, result, this.isRecordingAudio);
                 this.notifyStateChange();
@@ -240,6 +267,20 @@ export class SimplifiedVGFRecognitionClient implements ISimplifiedVGFRecognition
             },
 
             onMetadata: (metadata) => {
+                // Skip update if UUID doesn't match (stale callback from previous session)
+                if (metadata.audioUtteranceId && metadata.audioUtteranceId !== this.expectedUuid) {
+                    if (this.logger) {
+                        this.logger('warn',
+                            `[VGF] Skipping metadata update: UUID mismatch (expected: ${this.expectedUuid}, got: ${metadata.audioUtteranceId})`
+                        );
+                    }
+                    // Still call original callback if provided
+                    if (clientConfig.onMetadata) {
+                        clientConfig.onMetadata(metadata);
+                    }
+                    return;
+                }
+
                 this.state = mapMetadataToState(this.state, metadata);
                 this.notifyStateChange();
 
@@ -256,6 +297,20 @@ export class SimplifiedVGFRecognitionClient implements ISimplifiedVGFRecognition
             },
 
             onError: (error) => {
+                // Skip update if UUID doesn't match (stale callback from previous session)
+                if (error.audioUtteranceId && error.audioUtteranceId !== this.expectedUuid) {
+                    if (this.logger) {
+                        this.logger('warn',
+                            `[VGF] Skipping error update: UUID mismatch (expected: ${this.expectedUuid}, got: ${error.audioUtteranceId})`
+                        );
+                    }
+                    // Still call original callback if provided
+                    if (clientConfig.onError) {
+                        clientConfig.onError(error);
+                    }
+                    return;
+                }
+
                 this.isRecordingAudio = false; // Reset on error
                 this.state = mapErrorToState(this.state, error);
                 this.notifyStateChange();
@@ -382,6 +437,7 @@ export class SimplifiedVGFRecognitionClient implements ISimplifiedVGFRecognition
     }
 
     private notifyStateChange(): void {
+        // State has already been validated for correct UUID before this is called
         if (this.stateChangeCallback) {
             this.stateChangeCallback({ ...this.state });
         }

package/src/vgf-recognition-state.ts

@@ -39,6 +39,9 @@ export const RecognitionVGFStateSchema = z.object({
 
     // Support for prompt slot mapping - passed to recognition context when present
     promptSlotMap: z.record(z.string(), z.array(z.string())).optional(), // Optional map of slot names to prompt values for recognition context
+
+    // Recognition action processing state - managed externally, SDK preserves but never modifies
+    recognitionActionProcessingState: z.string().optional(), // "NOT_STARTED", "IN_PROGRESS", "COMPLETED"
 })
 
 export type RecognitionState = z.infer<typeof RecognitionVGFStateSchema>
@@ -63,6 +66,14 @@ export const TranscriptionStatus = {
 
 export type TranscriptionStatusType = typeof TranscriptionStatus[keyof typeof TranscriptionStatus]
 
+export const RecognitionActionProcessingState = {
+    NOT_STARTED: "NOT_STARTED",
+    IN_PROGRESS: "IN_PROGRESS",
+    COMPLETED: "COMPLETED",
+} as const
+
+export type RecognitionActionProcessingStateType = typeof RecognitionActionProcessingState[keyof typeof RecognitionActionProcessingState]
+
 // Helper function to create initial state
 export function createInitialRecognitionState(audioUtteranceId: string): RecognitionState {
     return {
@@ -70,6 +81,7 @@ export function createInitialRecognitionState(audioUtteranceId: string): Recogni
         startRecordingStatus: RecordingStatus.NOT_READY,
         transcriptionStatus: TranscriptionStatus.NOT_STARTED,
         pendingTranscript: "",
+        recognitionActionProcessingState: RecognitionActionProcessingState.NOT_STARTED,
     }
 }