uneeq-js 3.6.9 → 3.6.11

package/dist/deepgram-stt.d.ts

@@ -19,9 +19,17 @@ export interface DeepgramSTTOptions {
     fillerWords?: boolean;
     endpointing?: number;
     interruptionWordThreshold?: number;
+    /**
+     * Safety net timeout in milliseconds.
+     * Triggers if no Deepgram events (transcripts/VAD) are received while the user is speaking.
+     * This prevents the STT engine from getting "stuck" when Deepgram fails to detect end-of-speech.
+     * Recommended: 3000ms - 10000ms. Defaults to 5000ms.
+     */
+    safetyNetTimeoutMs?: number;
     echoCancellation?: boolean;
     noiseSuppression?: boolean;
     autoGainControl?: boolean;
+    microphoneDeviceId?: string;
     promptMetadata: PromptMetadata;
     messages: Subject<UneeqMessage>;
     sendMessage: (msg: DataChannelMessage) => void;
@@ -29,10 +37,8 @@ export interface DeepgramSTTOptions {
 export declare class DeepgramSTT implements SpeechRecognitionInterface {
     private readonly options;
     private connection;
-    private isConnected;
-    private isPaused;
+    private state;
     private shouldReconnect;
-    private isConnecting;
     private microphone;
     private stream;
     private reconnectAttempts;
@@ -62,7 +68,35 @@ export declare class DeepgramSTT implements SpeechRecognitionInterface {
     private stopMicrophone;
     private setupEventHandlers;
     private handleAppMessages;
+    /**
+     * Primary handler for incoming Deepgram transcript events.
+     * Extracts transcript data, processes chunks, and updates speaking states.
+     * @param data - The live transcription response from Deepgram
+     */
     private handleTranscript;
+    /**
+     * Processes a single transcript chunk, accumulating text and confidence scores.
+     * @param transcript - The transcript text from the current chunk
+     * @param confidence - The confidence score for the current chunk
+     * @param isFinal - Whether Deepgram has marked this chunk as final
+     * @param speechFinal - Whether Deepgram has detected the end of a speech segment
+     */
+    private processTranscriptChunk;
+    /**
+     * Evaluates whether the user's speech should trigger an interruption of the digital human
+     * and updates the internal speaking states for Renny and the UI.
+     * @param transcript - The current transcript text
+     * @param speechFinal - Whether the current segment is marked as speech_final
+     */
+    private updateSpeakingAndInterruptionState;
+    /**
+     * Emits transcription results to the client (for closed captions) and sends
+     * chat prompts to Renny if the utterance has reached a final state.
+     * @param transcript - The current segment transcript
+     * @param confidence - The confidence score for the current segment
+     * @param speechFinal - Whether the segment is speech_final
+     */
+    private emitTranscriptionResult;
     /**
      * Handle UtteranceEnd event from Deepgram.
      * This fires when Deepgram detects a gap in word timings, even in noisy environments
@@ -75,7 +109,7 @@ export declare class DeepgramSTT implements SpeechRecognitionInterface {
      */
     private resetSafetyNetTimeout;
     /**
-     * Safety net trigger - called when no Deepgram events received for SAFETY_NET_TIMEOUT_MS
+     * Safety net trigger - called when no Deepgram events received for safetyNetTimeoutMs
      * while in a speaking state with accumulated transcript. This handles truly stuck states.
      */
     private triggerSafetyNet;
@@ -85,6 +119,12 @@ export declare class DeepgramSTT implements SpeechRecognitionInterface {
      * @param source - Description of what triggered this (for logging)
      */
     private sendAccumulatedTranscript;
+    /**
+     * Check if a string ends with sentence-ending punctuation.
+     * @param text - The text to check
+     * @returns true if the text ends with punctuation (. ! ? etc.)
+     */
+    private endsWithPunctuation;
     /**
      * Reset accumulated transcript and confidence state.
      */