ttp-agent-sdk 2.48.12 → 2.48.16

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,22 @@ class AudioProcessor extends AudioWorkletProcessor {
       const highFreqRatio = highFreqCount / this.bufferSize;
       
       const currentTime = Date.now();
-      
+
+      // Effective VAD floor: base threshold scaled by the mic-sensitivity multiplier —
+      // QUADRATIC below 1.0 so the strict end actually bites (0.5 → 0.08 floor, not
+      // 0.04: a linear ±6dB band is imperceptible, and browser AGC flattens level
+      // differences before we see them). Raised during agent playback (stricter
+      // barge-in), lowered while voice is already active (hysteresis, so speech
+      // tails aren't clipped).
+      const sens = this.micSensitivity;
+      let effectiveThreshold = sens >= 1
+        ? this.silenceThreshold / sens
+        : this.silenceThreshold / (sens * sens);
+      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.15</p>
           </div>
         </div>
       </div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ttp-agent-sdk",
-  "version": "2.48.12",
+  "version": "2.48.16",
   "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",