ttp-agent-sdk 2.48.11 → 2.48.14

package/dist/audio-processor.js

@@ -19,10 +19,23 @@ class AudioProcessor extends AudioWorkletProcessor {
     this.bufferIndex = 0;
     
     // VAD (Voice Activity Detection) parameters
-    this.silenceThreshold = 0.02; // RMS threshold for voice detection (increased to reduce ambient noise sensitivity)
+    this.silenceThreshold = 0.02; // Base RMS threshold for voice detection (scaled by micSensitivity below)
     this.VOICE_FRAMES_REQUIRED = 2; // Require 2 consecutive frames above threshold before activating
     this.minVoiceDuration = 100; // ms - minimum speech duration
     this.pauseThreshold = 3000; // ms - longer pause before processing
+
+    // Mic sensitivity: user/agent-adjustable multiplier on the VAD energy gate.
+    // 1.0 = default; 2.0 = twice as sensitive (half the RMS floor); 0.5 = half as
+    // sensitive (double the floor — only close/loud speech triggers, e.g. TV in the room).
+    this.micSensitivity = (typeof this.config.micSensitivity === 'number' && this.config.micSensitivity > 0)
+      ? this.config.micSensitivity : 1.0;
+    // While agent audio plays, the gate rises by this factor (stricter barge-in: background
+    // TV/chatter must not interrupt playback). The SDK main thread tracks playback state.
+    this.playbackActive = false;
+    this.PLAYBACK_GATE_FACTOR = 1.6;
+    // Hysteresis: once voice is active the floor drops, so a borderline signal isn't
+    // chopped on every frame (quiet speech tails stay under the trigger level).
+    this.HYSTERESIS_FACTOR = 0.75;
     
     // VAD state
     this.isVoiceActive = false;
@@ -75,6 +88,18 @@ class AudioProcessor extends AudioWorkletProcessor {
           // iOS: bypass client VAD - always send. Desktop: keep VAD (saves bandwidth, reduces noise).
           this.isCurrentlyStreaming = data.enabled && (data.bypassVad === true);
           break;
+
+        case 'setMicSensitivity': {
+          const v = Number(data && data.value);
+          if (isFinite(v) && v > 0) {
+            this.micSensitivity = Math.max(0.25, Math.min(4.0, v));
+          }
+          break;
+        }
+
+        case 'setPlaybackActive':
+          this.playbackActive = !!(data && data.active);
+          break;
           
         case 'flush':
           this.flushBuffer();
@@ -157,9 +182,16 @@ class AudioProcessor extends AudioWorkletProcessor {
       const highFreqRatio = highFreqCount / this.bufferSize;
       
       const currentTime = Date.now();
-      
+
+      // Effective VAD floor: base threshold scaled by the mic-sensitivity multiplier,
+      // raised during agent playback (stricter barge-in), lowered while voice is
+      // already active (hysteresis, so speech tails aren't clipped).
+      let effectiveThreshold = this.silenceThreshold / this.micSensitivity;
+      if (this.playbackActive) effectiveThreshold *= this.PLAYBACK_GATE_FACTOR;
+      if (this.isVoiceActive) effectiveThreshold *= this.HYSTERESIS_FACTOR;
+
       // VAD with reduced sensitivity - require consecutive frames above threshold
-      let hasVoice = rms > this.silenceThreshold;
+      let hasVoice = rms > effectiveThreshold;
       // Calculate time since last voice detection
       const timeSinceLastVoice = currentTime - this.lastVoiceTime;
 

package/dist/index.html

@@ -23,7 +23,7 @@
           <img src="https://talktopc.com/logo192.png" alt="TTP Logo" style="width: 40px; height: 40px; border-radius: 8px;">
           <div>
             <h1 style="margin: 0; font-size: 1.4rem;">TTP Agent SDK</h1>
-            <p class="version" style="margin: 0;">v2.48.6</p>
+            <p class="version" style="margin: 0;">v2.48.13</p>
           </div>
         </div>
       </div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ttp-agent-sdk",
-  "version": "2.48.11",
+  "version": "2.48.14",
   "description": "Comprehensive Voice Agent SDK with Customizable Widget - Real-time audio, WebSocket communication, React components, and extensive customization options",
   "main": "dist/agent-widget.js",
   "module": "dist/agent-widget.esm.js",