ttp-agent-sdk 2.48.18 → 2.48.21

package/dist/agent-widget.dev.js

@@ -12129,7 +12129,7 @@ var TextChatSDK = /*#__PURE__*/function (_EventEmitter) {
 
       // SDK build time for debugging
       if (true) {
-        helloMessage.lastBuildTime = "2026-08-27T12:25:20.756Z";
+        helloMessage.lastBuildTime = "2026-08-27T17:29:05.172Z";
       }
       try {
         this.ws.send(JSON.stringify(helloMessage));
@@ -21439,8 +21439,8 @@ var VoiceSDK = _v2_VoiceSDK_js__WEBPACK_IMPORTED_MODULE_0__["default"];
 
 
 // Version - injected at build time from package.json via webpack DefinePlugin
-var VERSION = "2.48.18";
-var BUILD_TIME = "2026-08-27T12:25:20.756Z";
+var VERSION = "2.48.21";
+var BUILD_TIME = "2026-08-27T17:29:05.172Z";
 console.log("%c TTP Agent SDK v".concat(VERSION, " (").concat(BUILD_TIME, ") "), 'background: #4f46e5; color: white; font-size: 12px; font-weight: bold; padding: 2px 6px; border-radius: 4px;');
 
 // Named exports
@@ -25616,6 +25616,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _codecs_PCMUCodec_js__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./codecs/PCMUCodec.js */ "./src/v2/codecs/PCMUCodec.js");
 /* harmony import */ var _codecs_PCMACodec_js__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ./codecs/PCMACodec.js */ "./src/v2/codecs/PCMACodec.js");
 /* harmony import */ var _hopPlatform_js__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! ./hopPlatform.js */ "./src/v2/hopPlatform.js");
+/* harmony import */ var _loopbackAec_js__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(/*! ./loopbackAec.js */ "./src/v2/loopbackAec.js");
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
@@ -25648,6 +25649,7 @@ function _setPrototypeOf(t, e) { return _setPrototypeOf = Object.setPrototypeOf
 
 
 
+
 // iOS FIX: Shared AudioContext for playback that persists across AudioPlayer instances.
 // iOS WebKit doesn't release audio hardware synchronously when AudioContext.close() is called,
 // so creating a new AudioContext immediately after closing the old one can fail silently.
@@ -25749,6 +25751,18 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
     _this._htmlAudioPlayOk = false;
     _this._htmlAudioPlayWatchdog = null;
     _this._loggedHopResample = false;
+    // Loopback AEC route (opt-in): the same MediaStream, but pushed through a
+    // pair of local RTCPeerConnections first, because Chrome's echo canceller
+    // only cancels peer-connection audio — a hidden <audio> is invisible to it.
+    // See loopbackAec.js. Off unless asked for; the hop above is unchanged.
+    _this._loopbackDest = null;
+    _this._loopbackEl = null;
+    _this._loopbackClose = null;
+    _this._loopbackReady = false;
+    _this._loopbackPending = false;
+    _this._loopbackFailed = false;
+    _this._loopbackPlayOk = false;
+    _this._loopbackWanted = undefined; // memoized by wantsLoopbackAec()
     // Greeting (and other bursts) fire many playChunk()s without await.
     // Serialize context creation so they cannot open two AudioContexts
     // at different rates in the middle of a sentence.
@@ -27022,6 +27036,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
         this.gainNode = null;
       }
       this._teardownHtmlAudioRoute();
+      this._teardownLoopbackRoute();
       if (this.audioContext === _sharedPlayerContext) {
         _sharedPlayerContext = null;
         _sharedPlayerSampleRate = null;
@@ -27221,7 +27236,10 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
   }, {
     key: "_htmlHopNeedsHardwareRate",
     value: function _htmlHopNeedsHardwareRate() {
-      return this.wantsHtmlAudioPlayback();
+      // The loopback ends in the same live-MediaStream <audio> the hop does, so
+      // it inherits the same device-rate requirement: a 24 kHz context makes
+      // Chrome clock that stream wrong and play speech ~2x.
+      return this.wantsHtmlAudioPlayback() || this.wantsLoopbackAec();
     }
   }, {
     key: "_isHardwarePlaybackRate",
@@ -27256,13 +27274,76 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
         sampleRate: audioDataSampleRate
       };
     }
+
+    /**
+     * Read-only playback-route telemetry for hello (`client`) and client_audio_info.
+     * Does not influence route selection — mirrors flags set by _connectGainToOutput.
+     */
+  }, {
+    key: "getPlaybackRouteReport",
+    value: function getPlaybackRouteReport() {
+      var htmlAudioPlayback = this.wantsHtmlAudioPlayback();
+      var loopbackWanted = this.wantsLoopbackAec();
+      var playbackRoute = this._reportEffectivePlaybackRoute();
+      return {
+        htmlAudioPlayback: htmlAudioPlayback,
+        playbackRoute: playbackRoute,
+        loopbackAttach: this._reportLoopbackAttach(loopbackWanted, playbackRoute),
+        // Legacy booleans — kept for downstream consumers that predated tri-state.
+        htmlAudioRouteActive: this._htmlAudioRouteActive,
+        htmlAudioPlayOk: this._htmlAudioPlayOk,
+        loopbackAec: loopbackWanted,
+        loopbackRouteActive: this._loopbackReady,
+        loopbackPlayOk: this._loopbackPlayOk
+      };
+    }
   }, {
     key: "getHtmlAudioPlaybackInfo",
     value: function getHtmlAudioPlaybackInfo() {
+      return this.getPlaybackRouteReport();
+    }
+
+    /** Effective last-hop route from established player state (not config intent). */
+  }, {
+    key: "_reportEffectivePlaybackRoute",
+    value: function _reportEffectivePlaybackRoute() {
+      if (this._loopbackReady && !this._loopbackFailed) {
+        return 'loopback';
+      }
+      if (this._htmlAudioRouteActive) {
+        return 'htmlHop';
+      }
+      return 'destination';
+    }
+  }, {
+    key: "_reportLoopbackAttach",
+    value: function _reportLoopbackAttach(loopbackWanted, playbackRoute) {
+      if (!loopbackWanted) {
+        return {
+          outcome: 'not_attempted'
+        };
+      }
+      if (this._loopbackFailed) {
+        return {
+          outcome: 'failed',
+          fallbackTo: playbackRoute
+        };
+      }
+      if (this._loopbackReady && this._loopbackPlayOk) {
+        return {
+          outcome: 'success'
+        };
+      }
+      if (this._loopbackReady && !this._loopbackPlayOk) {
+        // Peer path is up; element play() not yet confirmed.
+        return {
+          outcome: 'pending'
+        };
+      }
+      // Negotiation in flight — audio may be on an interim hop/destination route.
       return {
-        htmlAudioPlayback: this.wantsHtmlAudioPlayback(),
-        htmlAudioRouteActive: this._htmlAudioRouteActive,
-        htmlAudioPlayOk: this._htmlAudioPlayOk
+        outcome: 'pending',
+        fallbackTo: playbackRoute
       };
     }
 
@@ -27279,6 +27360,18 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
       try {
         this.gainNode.disconnect();
       } catch (_) {/* ignore */}
+
+      // Loopback first when asked for. It returns null until the peer connections
+      // are up (negotiation is async), and we deliberately fall through to a
+      // normal audible route in the meantime rather than holding audio: the
+      // establishment is re-entrant and calls back here when it completes.
+      if (this.wantsLoopbackAec()) {
+        var loopbackDest = this._ensureLoopbackRoute();
+        if (loopbackDest) {
+          this.gainNode.connect(loopbackDest);
+          return;
+        }
+      }
       if (this.wantsHtmlAudioPlayback() && this._ensureHtmlAudioRoute()) {
         this.gainNode.connect(this._mediaStreamDest);
         return;
@@ -27303,16 +27396,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
       }
       try {
         this._mediaStreamDest = this.audioContext.createMediaStreamDestination();
-        var el = document.createElement('audio');
-        el.setAttribute('playsinline', '');
-        el.setAttribute('webkit-playsinline', '');
-        el.autoplay = true;
-        el.controls = false;
-        el.preload = 'auto';
-        el.playbackRate = 1;
-        el.style.display = 'none';
-        el.srcObject = this._mediaStreamDest.stream;
-        document.body.appendChild(el);
+        var el = this._createHiddenAudioEl(this._mediaStreamDest.stream);
         this._htmlAudioEl = el;
         this._htmlAudioRouteActive = true;
         this._ensureHtmlAudioPlaying();
@@ -27393,6 +27477,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
         this.gainNode.disconnect();
       } catch (_) {/* ignore */}
       this._teardownHtmlAudioRoute();
+      this._teardownLoopbackRoute();
       this.gainNode.connect(this.audioContext.destination);
       console.warn("\u26A0\uFE0F AudioPlayer: Fell back to AudioContext.destination (".concat(reason, ")"));
       this.emit('htmlAudioRoute', {
@@ -27420,29 +27505,216 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
       this._htmlAudioRouteActive = false;
     }
 
+    /**
+     * Shared factory for the hidden playback element. Both last-hop routes need
+     * exactly this: autoplay, inline on iOS, invisible, rate pinned to 1 so a
+     * page-level playbackRate can't stretch TTS under us.
+     */
+  }, {
+    key: "_createHiddenAudioEl",
+    value: function _createHiddenAudioEl(stream) {
+      var el = document.createElement('audio');
+      el.setAttribute('playsinline', '');
+      el.setAttribute('webkit-playsinline', '');
+      el.autoplay = true;
+      el.controls = false;
+      el.preload = 'auto';
+      el.playbackRate = 1;
+      el.style.display = 'none';
+      el.srcObject = stream;
+      document.body.appendChild(el);
+      return el;
+    }
+
+    /**
+     * Opt-in loopback route. Default OFF: this is an unproven replacement for the
+     * hop running on live customer sites, so it ships dark and is turned on per
+     * machine (?ttp_loopback=1 / localStorage) or per integration (config).
+     */
+  }, {
+    key: "wantsLoopbackAec",
+    value: function wantsLoopbackAec() {
+      // Memoized per player: _htmlHopNeedsHardwareRate() consults this from
+      // _honestRateSamples, i.e. once per audio chunk, and reading it live would
+      // put a synchronous storage hit on the hot path for every machine where
+      // the hop is off (there the || cannot short-circuit). Changing the flag
+      // requires a reload anyway — that is how it is documented and tested.
+      if (this._loopbackWanted === undefined) {
+        var override = (0,_loopbackAec_js__WEBPACK_IMPORTED_MODULE_5__.readTtpLoopbackOverride)(typeof window !== 'undefined' ? window : null);
+        this._loopbackWanted = override !== null ? override : typeof this.config.loopbackAec === 'boolean' ? this.config.loopbackAec : false;
+        if (this._loopbackWanted) {
+          console.log('🔊 AudioPlayer: loopback AEC requested — TTS will play via a local peer connection');
+        }
+      }
+      return this._loopbackWanted;
+    }
+
+    /**
+     * Returns the MediaStreamDestination to play into once the loopback is up,
+     * or null while it is not. Never blocks: the caller routes audio somewhere
+     * audible in the meantime and we re-route from _establishLoopback.
+     */
+  }, {
+    key: "_ensureLoopbackRoute",
+    value: function _ensureLoopbackRoute() {
+      var _this9 = this;
+      if (this._loopbackReady && this._loopbackDest) {
+        this._ensureLoopbackPlaying();
+        return this._loopbackDest;
+      }
+      if (this._loopbackFailed || this._loopbackPending) return null;
+      if (!this.audioContext || typeof this.audioContext.createMediaStreamDestination !== 'function') {
+        this._failLoopback('no_media_stream_destination');
+        return null;
+      }
+      if (!(0,_loopbackAec_js__WEBPACK_IMPORTED_MODULE_5__.isLoopbackAecSupported)(typeof window !== 'undefined' ? window : null)) {
+        this._failLoopback('no_peer_connection');
+        return null;
+      }
+      this._loopbackPending = true;
+      this._establishLoopback().catch(function (e) {
+        console.warn('⚠️ AudioPlayer: loopback AEC route unavailable, keeping existing playback route:', e && e.message);
+        _this9._failLoopback('negotiation_failed');
+      });
+      return null;
+    }
+  }, {
+    key: "_establishLoopback",
+    value: function () {
+      var _establishLoopback2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee7() {
+        var gen, dest, _yield$createAecLoopb, remoteStream, close;
+        return _regenerator().w(function (_context8) {
+          while (1) switch (_context8.n) {
+            case 0:
+              // Generation token: a teardown (call end, context rebuild) while we are
+              // negotiating must not resurrect a route into a dead AudioContext.
+              gen = this._loopbackGen = (this._loopbackGen || 0) + 1;
+              dest = this.audioContext.createMediaStreamDestination();
+              _context8.n = 1;
+              return (0,_loopbackAec_js__WEBPACK_IMPORTED_MODULE_5__.createAecLoopback)({
+                stream: dest.stream
+              });
+            case 1:
+              _yield$createAecLoopb = _context8.v;
+              remoteStream = _yield$createAecLoopb.remoteStream;
+              close = _yield$createAecLoopb.close;
+              if (!(gen !== this._loopbackGen || !this.audioContext)) {
+                _context8.n = 2;
+                break;
+              }
+              try {
+                close();
+              } catch (_) {/* ignore */}
+              return _context8.a(2);
+            case 2:
+              // Drop the transitional hop element if one was built while we negotiated,
+              // or it keeps playing a destination nothing is connected to any more.
+              this._teardownHtmlAudioRoute();
+              this._loopbackDest = dest;
+              this._loopbackClose = close;
+              this._loopbackEl = this._createHiddenAudioEl(remoteStream);
+              this._loopbackReady = true;
+              this._loopbackPending = false;
+              this._ensureLoopbackPlaying();
+              this._connectGainToOutput();
+              console.log('🔊 AudioPlayer: Playback last-hop is a local WebRTC loopback (Chrome-cancellable AEC far-end)');
+              this.emit('htmlAudioRoute', {
+                state: 'loopback_established'
+              });
+            case 3:
+              return _context8.a(2);
+          }
+        }, _callee7, this);
+      }));
+      function _establishLoopback() {
+        return _establishLoopback2.apply(this, arguments);
+      }
+      return _establishLoopback;
+    }()
+  }, {
+    key: "_ensureLoopbackPlaying",
+    value: function _ensureLoopbackPlaying() {
+      var _this0 = this;
+      var el = this._loopbackEl;
+      if (!el) return;
+      if (!el.paused && this._loopbackPlayOk) return;
+      var playResult = el.play();
+      if (playResult && typeof playResult.then === 'function') {
+        playResult.then(function () {
+          _this0._loopbackPlayOk = true;
+        }).catch(function (err) {
+          if (_this0._loopbackPlayOk || !el.paused) return;
+          console.warn('⚠️ AudioPlayer: loopback element play() rejected — reverting to the previous route:', err);
+          _this0._failLoopback('play_rejected');
+          _this0._connectGainToOutput();
+        });
+      }
+    }
+
+    /** One-way latch: once the loopback is off for this player it stays off,
+     *  rather than retrying every reconnect and stuttering the route. */
+  }, {
+    key: "_failLoopback",
+    value: function _failLoopback(reason) {
+      this._loopbackFailed = true;
+      this._loopbackPending = false;
+      this._teardownLoopbackRoute();
+      this.emit('htmlAudioRoute', {
+        state: 'loopback_fallback',
+        reason: reason
+      });
+    }
+  }, {
+    key: "_teardownLoopbackRoute",
+    value: function _teardownLoopbackRoute() {
+      this._loopbackGen = (this._loopbackGen || 0) + 1;
+      if (this._loopbackEl) {
+        try {
+          this._loopbackEl.pause();
+        } catch (_) {/* ignore */}
+        try {
+          this._loopbackEl.srcObject = null;
+        } catch (_) {/* ignore */}
+        if (this._loopbackEl.parentNode) {
+          this._loopbackEl.parentNode.removeChild(this._loopbackEl);
+        }
+        this._loopbackEl = null;
+      }
+      if (this._loopbackClose) {
+        try {
+          this._loopbackClose();
+        } catch (_) {/* ignore */}
+        this._loopbackClose = null;
+      }
+      this._loopbackDest = null;
+      this._loopbackReady = false;
+      this._loopbackPending = false;
+      this._loopbackPlayOk = false;
+    }
+
     /**
      * Initialize audio context with correct sample rate
      */
   }, {
     key: "initializeAudioContext",
     value: (function () {
-      var _initializeAudioContext = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee7() {
-        var _this9 = this;
-        return _regenerator().w(function (_context8) {
-          while (1) switch (_context8.n) {
+      var _initializeAudioContext = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee8() {
+        var _this1 = this;
+        return _regenerator().w(function (_context9) {
+          while (1) switch (_context9.n) {
             case 0:
               if (!this._audioContextInitPromise) {
-                _context8.n = 1;
+                _context9.n = 1;
                 break;
               }
-              return _context8.a(2, this._audioContextInitPromise);
+              return _context9.a(2, this._audioContextInitPromise);
             case 1:
               this._audioContextInitPromise = this._initializeAudioContextImpl().finally(function () {
-                _this9._audioContextInitPromise = null;
+                _this1._audioContextInitPromise = null;
               });
-              return _context8.a(2, this._audioContextInitPromise);
+              return _context9.a(2, this._audioContextInitPromise);
           }
-        }, _callee7, this);
+        }, _callee8, this);
       }));
       function initializeAudioContext() {
         return _initializeAudioContext.apply(this, arguments);
@@ -27452,11 +27724,11 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
   }, {
     key: "_initializeAudioContextImpl",
     value: function () {
-      var _initializeAudioContextImpl2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee8() {
-        var _this0 = this;
+      var _initializeAudioContextImpl2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee9() {
+        var _this10 = this;
         var ttsSampleRate, useHardwareRate, desiredSampleRate, contextFits, canReuseShared, setupAfterResume, ctxOpts, _t4;
-        return _regenerator().w(function (_context9) {
-          while (1) switch (_context9.p = _context9.n) {
+        return _regenerator().w(function (_context0) {
+          while (1) switch (_context0.p = _context0.n) {
             case 0:
               ttsSampleRate = this._ttsSampleRate();
               useHardwareRate = this._htmlHopNeedsHardwareRate(); // Destination path: match TTS (24 kHz). HTML last-hop: request the standard
@@ -27474,27 +27746,27 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
                 _sharedPlayerSampleRate = null;
               }
               contextFits = function contextFits(rate) {
-                if (useHardwareRate) return _this0._isHardwarePlaybackRate(rate);
+                if (useHardwareRate) return _this10._isHardwarePlaybackRate(rate);
                 return Math.abs(rate - desiredSampleRate) <= 100;
               }; // Check if current instance AudioContext exists and matches
               if (!this.audioContext) {
-                _context9.n = 3;
+                _context0.n = 3;
                 break;
               }
               if (!(this.audioContext.state === 'closed')) {
-                _context9.n = 1;
+                _context0.n = 1;
                 break;
               }
               this._invalidateClosedAudioContext();
-              _context9.n = 3;
+              _context0.n = 3;
               break;
             case 1:
               if (!contextFits(this.audioContext.sampleRate)) {
-                _context9.n = 2;
+                _context0.n = 2;
                 break;
               }
               this._ensureHtmlAudioPlaying();
-              return _context9.a(2);
+              return _context0.a(2);
             case 2:
               console.warn("\u26A0\uFE0F AudioPlayer: AudioContext sample rate (".concat(this.audioContext.sampleRate, "Hz) doesn't match playback hop, recreating..."));
               this.stopImmediate();
@@ -27505,44 +27777,44 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
               // causing newly created AudioContexts to fail silently.
               canReuseShared = _sharedPlayerContext && _sharedPlayerContext.state !== 'closed' && contextFits(_sharedPlayerContext.sampleRate);
               if (!canReuseShared) {
-                _context9.n = 8;
+                _context0.n = 8;
                 break;
               }
               console.log("\u267B\uFE0F AudioPlayer: Reusing shared AudioContext at ".concat(_sharedPlayerContext.sampleRate, "Hz (iOS-safe)"));
               this.audioContext = _sharedPlayerContext;
               setupAfterResume = function setupAfterResume() {
-                _this0.setupAudioContextStateMonitoring();
-                if (_this0.gainNode) {
+                _this10.setupAudioContextStateMonitoring();
+                if (_this10.gainNode) {
                   try {
-                    _this0.gainNode.disconnect();
+                    _this10.gainNode.disconnect();
                   } catch (e) {
                     console.warn('⚠️ AudioPlayer: Error disconnecting old GainNode:', e);
                   }
                 }
-                _this0.gainNode = _this0.audioContext.createGain();
-                _this0.gainNode.gain.value = 1.0;
-                _this0._connectGainToOutput();
-                if (!_this0._audioContextPrimed) {
-                  _this0._primeAudioContext();
+                _this10.gainNode = _this10.audioContext.createGain();
+                _this10.gainNode.gain.value = 1.0;
+                _this10._connectGainToOutput();
+                if (!_this10._audioContextPrimed) {
+                  _this10._primeAudioContext();
                 }
               };
               if (!(this.audioContext.state === 'suspended')) {
-                _context9.n = 7;
+                _context0.n = 7;
                 break;
               }
-              _context9.p = 4;
-              _context9.n = 5;
+              _context0.p = 4;
+              _context0.n = 5;
               return this.audioContext.resume();
             case 5:
-              _context9.n = 7;
+              _context0.n = 7;
               break;
             case 6:
-              _context9.p = 6;
-              _t4 = _context9.v;
+              _context0.p = 6;
+              _t4 = _context0.v;
               console.warn('⚠️ AudioPlayer: Error resuming shared context:', _t4);
             case 7:
               setupAfterResume();
-              return _context9.a(2);
+              return _context0.a(2);
             case 8:
               console.log("\uD83C\uDFB5 AudioPlayer: Creating AudioContext (tts=".concat(ttsSampleRate, "Hz, htmlHop=").concat(useHardwareRate, ", requested=").concat(desiredSampleRate, "Hz)"));
 
@@ -27595,9 +27867,9 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
                 this._primeAudioContext();
               }
             case 9:
-              return _context9.a(2);
+              return _context0.a(2);
           }
-        }, _callee8, this, [[4, 6]]);
+        }, _callee9, this, [[4, 6]]);
       }));
       function _initializeAudioContextImpl() {
         return _initializeAudioContextImpl2.apply(this, arguments);
@@ -27611,17 +27883,17 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
   }, {
     key: "_primeAudioContext",
     value: (function () {
-      var _primeAudioContext2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee9() {
+      var _primeAudioContext2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee0() {
         var sampleRate, silentBuffer, source, _t5;
-        return _regenerator().w(function (_context0) {
-          while (1) switch (_context0.p = _context0.n) {
+        return _regenerator().w(function (_context1) {
+          while (1) switch (_context1.p = _context1.n) {
             case 0:
-              _context0.p = 0;
+              _context1.p = 0;
               if (!(!this.audioContext || this._audioContextPrimed)) {
-                _context0.n = 1;
+                _context1.n = 1;
                 break;
               }
-              return _context0.a(2);
+              return _context1.a(2);
             case 1:
               sampleRate = this.audioContext.sampleRate;
               silentBuffer = this.audioContext.createBuffer(1, sampleRate * 0.15, sampleRate);
@@ -27632,23 +27904,23 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
               source.connect(this.gainNode || this.audioContext.destination);
               source.start();
               this._ensureHtmlAudioPlaying();
-              _context0.n = 2;
+              _context1.n = 2;
               return new Promise(function (resolve) {
                 return setTimeout(resolve, 150);
               });
             case 2:
               this._audioContextPrimed = true;
               console.log('✅ AudioPlayer: Audio hardware primed with silent buffer');
-              _context0.n = 4;
+              _context1.n = 4;
               break;
             case 3:
-              _context0.p = 3;
-              _t5 = _context0.v;
+              _context1.p = 3;
+              _t5 = _context1.v;
               console.error('❌ AudioPlayer: Audio priming failed:', _t5);
             case 4:
-              return _context0.a(2);
+              return _context1.a(2);
           }
-        }, _callee9, this, [[0, 3]]);
+        }, _callee0, this, [[0, 3]]);
       }));
       function _primeAudioContext() {
         return _primeAudioContext2.apply(this, arguments);
@@ -27675,6 +27947,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
         this.gainNode = null;
       }
       this._teardownHtmlAudioRoute();
+      this._teardownLoopbackRoute();
 
       // Remove state change listener first
       if (this._audioContextStateChangeHandler && this.audioContext) {
@@ -27715,7 +27988,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
      * Handles mic permission grants, tab switching, browser suspension, etc.
      */
     function setupAudioContextStateMonitoring() {
-      var _this1 = this;
+      var _this11 = this;
       if (!this.audioContext) {
         return;
       }
@@ -27728,38 +28001,38 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
       // Create handler that references this.audioContext dynamically
       this._audioContextStateChangeHandler = function () {
         // Null check required because audioContext may be cleaned up while handler is queued
-        if (!_this1.audioContext) {
+        if (!_this11.audioContext) {
           console.warn('⚠️ AudioPlayer: State change handler fired but AudioContext is null');
           return;
         }
-        console.log("\uD83C\uDFB5 AudioPlayer: AudioContext state changed to: ".concat(_this1.audioContext.state));
-        if (_this1.audioContext.state === 'running') {
-          _this1._ensureHtmlAudioPlaying();
+        console.log("\uD83C\uDFB5 AudioPlayer: AudioContext state changed to: ".concat(_this11.audioContext.state));
+        if (_this11.audioContext.state === 'running') {
+          _this11._ensureHtmlAudioPlaying();
         }
-        if (_this1.audioContext.state === 'suspended' && _this1.isPlaying) {
+        if (_this11.audioContext.state === 'suspended' && _this11.isPlaying) {
           // AudioContext was suspended during playback (tab switch, mic permission, etc.)
           console.warn('⚠️ AudioPlayer: AudioContext suspended during playback');
           // Note: Playback will pause automatically, but we should handle queue processing
           // The state change will be handled when we try to process next frame
-        } else if (_this1.audioContext.state === 'running' && !_this1.isPlaying && (_this1.audioQueue.length > 0 || _this1.pcmChunkQueue.length > 0 || _this1.preparedBuffer.length > 0)) {
+        } else if (_this11.audioContext.state === 'running' && !_this11.isPlaying && (_this11.audioQueue.length > 0 || _this11.pcmChunkQueue.length > 0 || _this11.preparedBuffer.length > 0)) {
           // AudioContext resumed and we have queued frames
           // This handles: mic permission grant, tab switching back, browser resume, etc.
           console.log('✅ AudioPlayer: AudioContext resumed - resuming queue processing');
 
           // Resume queue processing if we have frames
-          if (_this1.audioQueue.length > 0 && !_this1.isProcessingQueue) {
+          if (_this11.audioQueue.length > 0 && !_this11.isProcessingQueue) {
             setTimeout(function () {
-              return _this1.processQueue();
+              return _this11.processQueue();
             }, 50);
           }
-          if (_this1.pcmChunkQueue.length > 0 && !_this1.isProcessingPcmQueue) {
+          if (_this11.pcmChunkQueue.length > 0 && !_this11.isProcessingPcmQueue) {
             setTimeout(function () {
-              return _this1.processPcmQueue();
+              return _this11.processPcmQueue();
             }, 50);
           }
-          if (_this1.preparedBuffer.length > 0 && !_this1.isSchedulingFrames) {
+          if (_this11.preparedBuffer.length > 0 && !_this11.isSchedulingFrames) {
             setTimeout(function () {
-              return _this1.scheduleFrames();
+              return _this11.scheduleFrames();
             }, 50);
           }
         }
@@ -27777,49 +28050,49 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
   }, {
     key: "processQueue",
     value: (function () {
-      var _processQueue = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee0() {
-        var _this10 = this;
+      var _processQueue = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee1() {
+        var _this12 = this;
         var audioBlob, wasFirstPlay, audioContext, arrayBuffer, audioBuffer, shouldEmitStart, source, _t6;
-        return _regenerator().w(function (_context1) {
-          while (1) switch (_context1.p = _context1.n) {
+        return _regenerator().w(function (_context10) {
+          while (1) switch (_context10.p = _context10.n) {
             case 0:
               if (!this._isStopped) {
-                _context1.n = 1;
+                _context10.n = 1;
                 break;
               }
               console.log('🛑 AudioPlayer: Not processing queue - playback was stopped (barge-in)');
-              return _context1.a(2);
+              return _context10.a(2);
             case 1:
               if (!(this.isProcessingQueue || this.audioQueue.length === 0)) {
-                _context1.n = 2;
+                _context10.n = 2;
                 break;
               }
-              return _context1.a(2);
+              return _context10.a(2);
             case 2:
               this.isProcessingQueue = true;
               this._ensureHtmlAudioPlaying();
               audioBlob = this.audioQueue.shift();
               if (audioBlob) {
-                _context1.n = 3;
+                _context10.n = 3;
                 break;
               }
               this.isProcessingQueue = false;
-              return _context1.a(2);
+              return _context10.a(2);
             case 3:
-              _context1.p = 3;
+              _context10.p = 3;
               wasFirstPlay = !this.isPlaying && this.currentSource === null; // Ensure context exists and is running (handles lazy init + suspended shared context)
-              _context1.n = 4;
+              _context10.n = 4;
               return this.waitForAudioContextReady();
             case 4:
               audioContext = this.audioContext; // Decode audio
-              _context1.n = 5;
+              _context10.n = 5;
               return audioBlob.arrayBuffer();
             case 5:
-              arrayBuffer = _context1.v;
-              _context1.n = 6;
+              arrayBuffer = _context10.v;
+              _context10.n = 6;
               return audioContext.decodeAudioData(arrayBuffer);
             case 6:
-              audioBuffer = _context1.v;
+              audioBuffer = _context10.v;
               shouldEmitStart = wasFirstPlay && !this.isPlaying && this.currentSource === null; // Create source
               source = audioContext.createBufferSource();
               source.buffer = audioBuffer;
@@ -27838,22 +28111,22 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
               // Handle end
 
               source.onended = function () {
-                _this10.currentSource = null;
-                _this10.isProcessingQueue = false;
+                _this12.currentSource = null;
+                _this12.isProcessingQueue = false;
 
                 // Process next chunk
 
-                if (_this10.audioQueue.length > 0) {
+                if (_this12.audioQueue.length > 0) {
                   setTimeout(function () {
-                    return _this10.processQueue();
+                    return _this12.processQueue();
                   }, 50);
                 } else {
                   // No more chunks - stop after delay
 
                   setTimeout(function () {
-                    if (_this10.audioQueue.length === 0 && !_this10.currentSource) {
-                      _this10.isPlaying = false;
-                      _this10.emit('playbackStopped');
+                    if (_this12.audioQueue.length === 0 && !_this12.currentSource) {
+                      _this12.isPlaying = false;
+                      _this12.emit('playbackStopped');
                     }
                   }, 100);
                 }
@@ -27862,11 +28135,11 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
               // Start playback - AudioContext should now be fully ready
 
               source.start();
-              _context1.n = 8;
+              _context10.n = 8;
               break;
             case 7:
-              _context1.p = 7;
-              _t6 = _context1.v;
+              _context10.p = 7;
+              _t6 = _context10.v;
               console.error('❌ AudioPlayer v2: Error processing queue:', _t6);
               this.currentSource = null;
               this.emit('playbackError', _t6);
@@ -27876,7 +28149,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
               if (this.audioQueue.length > 0) {
                 this.isProcessingQueue = false;
                 setTimeout(function () {
-                  return _this10.processQueue();
+                  return _this12.processQueue();
                 }, 100);
               } else {
                 this.isPlaying = false;
@@ -27884,9 +28157,9 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
                 this.emit('playbackStopped');
               }
             case 8:
-              return _context1.a(2);
+              return _context10.a(2);
           }
-        }, _callee0, this, [[3, 7]]);
+        }, _callee1, this, [[3, 7]]);
       }));
       function processQueue() {
         return _processQueue.apply(this, arguments);
@@ -28099,7 +28372,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
   }, {
     key: "markNewSentence",
     value: function markNewSentence(text, synced, segmentId) {
-      var _this11 = this;
+      var _this13 = this;
       var wasStopped = this._isStopped;
       var isCurrentlyPlaying = this.isPlaying || this.scheduledSources.size > 0;
 
@@ -28158,34 +28431,34 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
       var sentenceText = text; // Capture for timeout callback
       this._emptySentenceTimeout = setTimeout(function () {
         // Check if this sentence still has no chunks after timeout
-        if (_this11.pendingSentenceText === sentenceText && _this11.scheduledBuffers === 0 && _this11.preparedBuffer.length === 0 && _this11.pcmChunkQueue.length === 0 && !_this11._isStopped) {
+        if (_this13.pendingSentenceText === sentenceText && _this13.scheduledBuffers === 0 && _this13.preparedBuffer.length === 0 && _this13.pcmChunkQueue.length === 0 && !_this13._isStopped) {
           console.warn("\u26A0\uFE0F AudioPlayer: Empty sentence detected after 5s timeout - no chunks received for: \"".concat(sentenceText.substring(0, 40), "...\""));
           // If this empty sentence carried a segment id, report it done (nothing was heard) and
           // adopt it as current so the coarse stop below matches the backend's last-sent id.
-          if (_this11.pendingSegmentId != null) {
-            var emptySegId = _this11.pendingSegmentId;
-            _this11.currentSegmentId = emptySegId;
-            _this11.pendingSegmentId = null;
-            _this11.emit('segmentDone', {
+          if (_this13.pendingSegmentId != null) {
+            var emptySegId = _this13.pendingSegmentId;
+            _this13.currentSegmentId = emptySegId;
+            _this13.pendingSegmentId = null;
+            _this13.emit('segmentDone', {
               segmentId: emptySegId,
               status: 'finished',
               playedMs: 0
             });
           }
           // Clear pending sentence to unblock next sentence
-          if (_this11.pendingSentenceText === sentenceText) {
-            _this11.pendingSentenceText = null;
+          if (_this13.pendingSentenceText === sentenceText) {
+            _this13.pendingSentenceText = null;
           }
           // Emit playbackStopped to allow next sentence to start
           // Only if we're not currently playing (to avoid interrupting real playback)
-          if (!_this11.isPlaying && _this11.scheduledSources.size === 0) {
+          if (!_this13.isPlaying && _this13.scheduledSources.size === 0) {
             console.log('🛑 AudioPlayer: Emitting playbackStopped for empty sentence timeout');
-            _this11.emit('playbackStopped', {
-              segmentId: _this11.currentSegmentId
+            _this13.emit('playbackStopped', {
+              segmentId: _this13.currentSegmentId
             });
           }
         }
-        _this11._emptySentenceTimeout = null;
+        _this13._emptySentenceTimeout = null;
       }, 5000); // 5 second timeout - adjust based on expected chunk arrival rate
     }
 
@@ -28195,14 +28468,14 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
   }, {
     key: "startTranscriptChecker",
     value: function startTranscriptChecker() {
-      var _this12 = this;
+      var _this14 = this;
       if (this.isCheckingTranscripts) return;
       this.isCheckingTranscripts = true;
       console.log('📝 AudioPlayer: Transcript checker started');
       var _checkLoop = function checkLoop() {
-        if (!_this12.isCheckingTranscripts || !_this12.audioContext) return;
-        var currentTime = _this12.audioContext.currentTime;
-        var _iterator2 = _createForOfIteratorHelper(_this12.sentenceTimings),
+        if (!_this14.isCheckingTranscripts || !_this14.audioContext) return;
+        var currentTime = _this14.audioContext.currentTime;
+        var _iterator2 = _createForOfIteratorHelper(_this14.sentenceTimings),
           _step2;
         try {
           for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
@@ -28216,13 +28489,13 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
                 eventData.synced = _timing.synced;
               }
               console.log("\uD83D\uDCDD AudioPlayer: Display transcript at ".concat(currentTime.toFixed(3), "s: \"").concat(_timing.text.substring(0, 40), "...\" (synced: ").concat(_timing.synced ? _timing.synced.length : 0, ")"));
-              _this12.emit('transcriptDisplay', eventData);
+              _this14.emit('transcriptDisplay', eventData);
             }
             // Per-segment natural finish: this segment's audio window has fully elapsed.
             if (!_timing.doneReported && _timing.endTime != null && currentTime >= _timing.endTime) {
               _timing.doneReported = true;
               var _playedMs = Math.round((_timing.endTime - _timing.startTime) * 1000);
-              _this12.emit('segmentDone', {
+              _this14.emit('segmentDone', {
                 segmentId: _timing.segmentId,
                 status: 'finished',
                 playedMs: _playedMs
@@ -28234,12 +28507,12 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
         } finally {
           _iterator2.f();
         }
-        if (_this12.isPlaying || _this12.scheduledBuffers > 0) {
+        if (_this14.isPlaying || _this14.scheduledBuffers > 0) {
           requestAnimationFrame(_checkLoop);
         } else {
           // Playback drained naturally — flush any segment whose finish tick we may have missed
           // (the last buffer's onended can flip isPlaying=false before this loop's next tick).
-          var _iterator3 = _createForOfIteratorHelper(_this12.sentenceTimings),
+          var _iterator3 = _createForOfIteratorHelper(_this14.sentenceTimings),
             _step3;
           try {
             for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
@@ -28248,7 +28521,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
                 timing.doneReported = true;
                 var end = timing.endTime != null ? timing.endTime : timing.startTime;
                 var playedMs = Math.round((end - timing.startTime) * 1000);
-                _this12.emit('segmentDone', {
+                _this14.emit('segmentDone', {
                   segmentId: timing.segmentId,
                   status: 'finished',
                   playedMs: playedMs
@@ -28260,7 +28533,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
           } finally {
             _iterator3.f();
           }
-          _this12.isCheckingTranscripts = false;
+          _this14.isCheckingTranscripts = false;
           console.log('📝 AudioPlayer: Transcript checker stopped');
         }
       };
@@ -28291,43 +28564,43 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
   }, {
     key: "resumeAudioContext",
     value: (function () {
-      var _resumeAudioContext = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee1() {
+      var _resumeAudioContext = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee10() {
         var _t7;
-        return _regenerator().w(function (_context10) {
-          while (1) switch (_context10.p = _context10.n) {
+        return _regenerator().w(function (_context11) {
+          while (1) switch (_context11.p = _context11.n) {
             case 0:
               if (!(!this.audioContext || this.audioContext.state === 'closed')) {
-                _context10.n = 2;
+                _context11.n = 2;
                 break;
               }
-              _context10.n = 1;
+              _context11.n = 1;
               return this.initializeAudioContext();
             case 1:
-              _context10.n = 6;
+              _context11.n = 6;
               break;
             case 2:
               if (!(this.audioContext.state === 'suspended')) {
-                _context10.n = 6;
+                _context11.n = 6;
                 break;
               }
-              _context10.p = 3;
-              _context10.n = 4;
+              _context11.p = 3;
+              _context11.n = 4;
               return this.audioContext.resume();
             case 4:
               console.log('✅ AudioPlayer v2: AudioContext resumed after mic permission');
-              _context10.n = 6;
+              _context11.n = 6;
               break;
             case 5:
-              _context10.p = 5;
-              _t7 = _context10.v;
+              _context11.p = 5;
+              _t7 = _context11.v;
               console.warn('⚠️ AudioPlayer v2: Failed to resume AudioContext:', _t7);
             case 6:
-              _context10.n = 7;
+              _context11.n = 7;
               return this.waitForAudioContextReady();
             case 7:
-              return _context10.a(2);
+              return _context11.a(2);
           }
-        }, _callee1, this, [[3, 5]]);
+        }, _callee10, this, [[3, 5]]);
       }));
       function resumeAudioContext() {
         return _resumeAudioContext.apply(this, arguments);
@@ -28578,6 +28851,11 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
         // Pass through undefined so AudioPlayer applies the platform default
         return config.htmlAudioPlayback;
       }(),
+      // Opt-in: play TTS through a pair of local RTCPeerConnections so Chrome's
+      // echo canceller can actually see it as a far-end reference (it ignores
+      // <audio> elements). Default off — AudioPlayer also honours
+      // ?ttp_loopback=1 / localStorage 'ttp_loopback' on its own.
+      loopbackAec: config.loopbackAec,
       // Protocol version
 
       protocolVersion: config.protocolVersion || 2,
@@ -28650,6 +28928,9 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
     _this.pendingInjections = new Map(); // Maps correlationId to { resolve, reject, timeout }
     _this.injectionCounter = 0; // Counter for generating unique correlation IDs
 
+    // One settled playback-route report per call (first segment audible).
+    _this._playbackRouteSettledSent = false;
+
     // Barge-in detection is handled by the backend, not the frontend
     // The backend analyzes the audio stream and sends 'barge_in' message when user interrupts
     // Frontend only responds to backend barge-in messages
@@ -29062,6 +29343,18 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
         }
         _this3.emit('playbackStarted');
 
+        // Unconditional settled playback-route report on first audible segment —
+        // even when the route matches hello-time telemetry and no htmlAudioRoute
+        // event fired afterward (e.g. loopback succeeded quietly).
+        if (!_this3._playbackRouteSettledSent) {
+          var _info$segmentId;
+          _this3._playbackRouteSettledSent = true;
+          _this3._sendClientAudioInfo(null, {
+            settled: true,
+            segmentId: (_info$segmentId = info === null || info === void 0 ? void 0 : info.segmentId) !== null && _info$segmentId !== void 0 ? _info$segmentId : null
+          });
+        }
+
         // Transcripts are displayed when they arrive (between sentences)
         // No need to handle transcript display here - it's handled in handleTranscript()
 
@@ -29351,6 +29644,7 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
                   _this5.isConnected = false;
                   _this5.helloAckReceived = false;
                   _this5.disclaimersPending = false;
+                  _this5._playbackRouteSettledSent = false;
 
                   // Discard any audio still held by the first-playback gate
                   _this5._dropPlaybackGate();
@@ -29468,7 +29762,7 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
     key: "_buildClientEnv",
     value: function _buildClientEnv() {
       try {
-        var _uaData$mobile, _window$screen, _window$screen2;
+        var _uaData$mobile, _window$screen, _window$screen2, _this$audioPlayer, _this$audioPlayer$get;
         var ua = navigator.userAgent || '';
         var uaData = navigator.userAgentData;
         var conn = navigator.connection || navigator.mozConnection || navigator.webkitConnection;
@@ -29477,8 +29771,8 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
         // Webview heuristic: Android WebView marks itself with "; wv)" or "Version/x.x Chrome";
         // iOS in-app webviews lack "Safari" in the UA (real Safari always has it).
         var webview = isAndroid && (/\bwv\b/.test(ua) || /Version\/[\d.]+.*Chrome/.test(ua)) || isIos && !/Safari/i.test(ua) || false;
-        var env = {
-          sdkVersion:  true ? "2.48.18" : 0,
+        var env = _objectSpread({
+          sdkVersion:  true ? "2.48.21" : 0,
           ua: ua,
           platform: (uaData === null || uaData === void 0 ? void 0 : uaData.platform) || navigator.platform || '',
           mobile: (_uaData$mobile = uaData === null || uaData === void 0 ? void 0 : uaData.mobile) !== null && _uaData$mobile !== void 0 ? _uaData$mobile : isAndroid || isIos,
@@ -29488,34 +29782,43 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
           cores: navigator.hardwareConcurrency || null,
           memoryGb: navigator.deviceMemory || null,
           connection: (conn === null || conn === void 0 ? void 0 : conn.effectiveType) || null
-        };
+        }, ((_this$audioPlayer = this.audioPlayer) === null || _this$audioPlayer === void 0 || (_this$audioPlayer$get = _this$audioPlayer.getPlaybackRouteReport) === null || _this$audioPlayer$get === void 0 ? void 0 : _this$audioPlayer$get.call(_this$audioPlayer)) || {
+          htmlAudioPlayback: null,
+          playbackRoute: 'destination',
+          loopbackAttach: {
+            outcome: 'not_attempted'
+          }
+        });
         return env;
       } catch (e) {
         console.warn('⚠️ VoiceSDK v2: Failed to build client env:', e);
         return {
-          sdkVersion:  true ? "2.48.18" : 0
+          sdkVersion:  true ? "2.48.21" : 0
         };
       }
     }
 
     /**
-     * One-shot telemetry sent right after recording starts (t:'client_audio_info').
-     * Reports the capture track's ACTUAL settings from getSettings() — echoCancellation /
-     * noiseSuppression / autoGainControl as the browser really applied them (not what we
-     * requested), which is the ground truth for diagnosing speakerphone echo barge-in —
-     * plus mic label, AudioContext rates, and whether the minimal-constraints fallback fired.
+     * Telemetry sent as t:'client_audio_info'. Interim snapshots (capture start,
+     * htmlAudioRoute transitions) use routeReportKind:'interim'. The first audible
+     * segment emits routeReportKind:'settled' exactly once per connection.
      */
   }, {
     key: "_sendClientAudioInfo",
     value: function _sendClientAudioInfo(routeUpdate) {
+      var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
       try {
-        var _this$audioRecorder, _this$audioRecorder$g, _s$echoCancellation, _s$noiseSuppression, _s$autoGainControl, _s$voiceIsolation, _s$sampleRate, _s$channelCount, _this$audioRecorder2, _this$audioPlayer, _this$audioRecorder3, _this$audioPlayer2, _this$audioPlayer2$ge;
+        var _this$audioRecorder, _this$audioRecorder$g, _s$echoCancellation, _s$noiseSuppression, _s$autoGainControl, _s$voiceIsolation, _s$sampleRate, _s$channelCount, _this$audioRecorder2, _this$audioPlayer2, _this$audioRecorder3, _this$audioPlayer3, _this$audioPlayer3$ge;
+        var settled = options.settled === true;
         var track = (_this$audioRecorder = this.audioRecorder) === null || _this$audioRecorder === void 0 || (_this$audioRecorder = _this$audioRecorder.mediaStream) === null || _this$audioRecorder === void 0 || (_this$audioRecorder$g = _this$audioRecorder.getAudioTracks) === null || _this$audioRecorder$g === void 0 ? void 0 : _this$audioRecorder$g.call(_this$audioRecorder)[0];
         // Route updates must go out even before the mic track exists — the hop
-        // state is the whole point of the follow-up.
-        if (!track && !routeUpdate) return;
+        // state is the whole point of the follow-up. Settled reports go out even
+        // if capture never started (monitor / playback-only paths).
+        if (!track && !routeUpdate && !settled) return;
         var s = track && track.getSettings ? track.getSettings() : {};
         var audio = _objectSpread({
+          sdkVersion:  true ? "2.48.21" : 0,
+          routeReportKind: settled ? 'settled' : 'interim',
           aec: (_s$echoCancellation = s.echoCancellation) !== null && _s$echoCancellation !== void 0 ? _s$echoCancellation : null,
           ns: (_s$noiseSuppression = s.noiseSuppression) !== null && _s$noiseSuppression !== void 0 ? _s$noiseSuppression : null,
           agc: (_s$autoGainControl = s.autoGainControl) !== null && _s$autoGainControl !== void 0 ? _s$autoGainControl : null,
@@ -29524,18 +29827,21 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
           channels: (_s$channelCount = s.channelCount) !== null && _s$channelCount !== void 0 ? _s$channelCount : null,
           mic: track ? track.label || null : null,
           captureCtxRate: ((_this$audioRecorder2 = this.audioRecorder) === null || _this$audioRecorder2 === void 0 || (_this$audioRecorder2 = _this$audioRecorder2.audioContext) === null || _this$audioRecorder2 === void 0 ? void 0 : _this$audioRecorder2.sampleRate) || null,
-          playbackCtxRate: ((_this$audioPlayer = this.audioPlayer) === null || _this$audioPlayer === void 0 || (_this$audioPlayer = _this$audioPlayer.audioContext) === null || _this$audioPlayer === void 0 ? void 0 : _this$audioPlayer.sampleRate) || null,
+          playbackCtxRate: ((_this$audioPlayer2 = this.audioPlayer) === null || _this$audioPlayer2 === void 0 || (_this$audioPlayer2 = _this$audioPlayer2.audioContext) === null || _this$audioPlayer2 === void 0 ? void 0 : _this$audioPlayer2.sampleRate) || null,
           constraintsFallback: ((_this$audioRecorder3 = this.audioRecorder) === null || _this$audioRecorder3 === void 0 || (_this$audioRecorder3 = _this$audioRecorder3.mediaStream) === null || _this$audioRecorder3 === void 0 ? void 0 : _this$audioRecorder3._ttpConstraintsFallback) === true
-        }, ((_this$audioPlayer2 = this.audioPlayer) === null || _this$audioPlayer2 === void 0 || (_this$audioPlayer2$ge = _this$audioPlayer2.getHtmlAudioPlaybackInfo) === null || _this$audioPlayer2$ge === void 0 ? void 0 : _this$audioPlayer2$ge.call(_this$audioPlayer2)) || {});
+        }, ((_this$audioPlayer3 = this.audioPlayer) === null || _this$audioPlayer3 === void 0 || (_this$audioPlayer3$ge = _this$audioPlayer3.getPlaybackRouteReport) === null || _this$audioPlayer3$ge === void 0 ? void 0 : _this$audioPlayer3$ge.call(_this$audioPlayer3)) || {});
+        if (settled && options.segmentId != null) {
+          audio.settledAtSegmentId = options.segmentId;
+        }
         if (routeUpdate && routeUpdate.state) {
-          audio.routeUpdate = routeUpdate.state; // 'established' | 'fallback' | 'play_pending'
+          audio.routeUpdate = routeUpdate.state; // 'established' | 'fallback' | 'play_pending' | ...
           if (routeUpdate.reason) audio.routeFallbackReason = routeUpdate.reason;
         }
         this.sendMessage({
           t: 'client_audio_info',
           audio: audio
         });
-        console.log('🎛️ VoiceSDK v2: Sent client_audio_info:', audio);
+        console.log("\uD83C\uDF9B\uFE0F VoiceSDK v2: Sent client_audio_info (".concat(audio.routeReportKind, "):"), audio);
       } catch (e) {
         console.warn('⚠️ VoiceSDK v2: Failed to send client_audio_info:', e);
       }
@@ -29641,7 +29947,7 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
 
               // Include SDK build time for debugging
               if (true) {
-                helloMessage.lastBuildTime = "2026-08-27T12:25:20.756Z";
+                helloMessage.lastBuildTime = "2026-08-27T17:29:05.172Z";
               }
 
               // Client environment (device/browser/webview) for backend logs + Langfuse metadata
@@ -32359,6 +32665,283 @@ function readTtpHopOverride(win) {
 
 /***/ }),
 
+/***/ "./src/v2/loopbackAec.js":
+/*!*******************************!*\
+  !*** ./src/v2/loopbackAec.js ***!
+  \*******************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   TTP_LOOPBACK_SESSION_KEY: () => (/* binding */ TTP_LOOPBACK_SESSION_KEY),
+/* harmony export */   createAecLoopback: () => (/* binding */ createAecLoopback),
+/* harmony export */   isLoopbackAecSupported: () => (/* binding */ isLoopbackAecSupported),
+/* harmony export */   preferHighQualityOpus: () => (/* binding */ preferHighQualityOpus),
+/* harmony export */   readTtpLoopbackOverride: () => (/* binding */ readTtpLoopbackOverride)
+/* harmony export */ });
+function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i.return) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
+function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
+/**
+ * Local WebRTC loopback for echo cancellation.
+ *
+ * WHY THIS EXISTS. Chrome's echo canceller only cancels audio that arrived
+ * through a WebRTC peer connection — not <audio> elements, not Web Audio.
+ * (Firefox/Safari/Edge consider all browser audio; Chrome does not.) That is
+ * why the HTML hop — AudioContext → MediaStreamDestination → hidden <audio> —
+ * never reliably fixed speaker echo on Chrome: where it appeared to work, what
+ * actually helped was Chrome-wide echo cancellation, a separate system-level
+ * feature that is not always available. Two people at the same customer, same
+ * OS class, both on speakers, got opposite results from the same build.
+ *
+ * The fix is to make TTS *actually be* peer-connection audio: wire two
+ * RTCPeerConnections together inside this tab and push playback through them.
+ * The remote track is then far-end reference material Chrome's AEC will
+ * cancel. No server, no SFU, no TURN, no ports — both ends are local and ICE
+ * never leaves the host.
+ *
+ * Cost is one Opus encode/decode (~20-40 ms added latency, and lossy
+ * compression of TTS that was already lossy over the wire). Bitrate is munged
+ * up because the "link" is a memcpy; see preferHighQualityOpus.
+ *
+ * Kept free of AudioPlayer state and injectable so the peer-connection dance
+ * is unit-testable without a browser: see test/loopback-aec.test.mjs.
+ */
+
+/** sessionStorage key mirroring an explicit ?ttp_loopback= URL value. */
+var TTP_LOOPBACK_SESSION_KEY = 'ttp_loopback_pref';
+
+/**
+ * QA/rollout override for the loopback route. true (force on), false (force
+ * off), or null (no override — apply config, which defaults off).
+ *
+ * Precedence and the sessionStorage mirror match readTtpHopOverride for the
+ * same reason: Borusan's navigate_to_form does window.location.href = '/path',
+ * a same-origin full load that drops the query string mid-call (call
+ * 84b5af7d). Without the mirror the route would silently revert on the very
+ * navigation the tester is exercising.
+ */
+function readTtpLoopbackOverride(win) {
+  var w = win || (typeof window !== 'undefined' ? window : null);
+  if (!w) return null;
+  var flag = null;
+  try {
+    flag = new URLSearchParams(w.location.search).get('ttp_loopback');
+  } catch (e) {/* no location in this env */}
+  if (flag === '0' || flag === '1') {
+    try {
+      w.sessionStorage.setItem(TTP_LOOPBACK_SESSION_KEY, flag);
+    } catch (e) {/* storage blocked */}
+    return flag === '1';
+  }
+  var mirrored = null;
+  try {
+    mirrored = w.sessionStorage.getItem(TTP_LOOPBACK_SESSION_KEY);
+  } catch (e) {/* storage blocked */}
+  if (mirrored === '0' || mirrored === '1') return mirrored === '1';
+  var stored = null;
+  try {
+    stored = w.localStorage.getItem('ttp_loopback');
+  } catch (e) {/* storage blocked */}
+  if (stored === '0' || stored === '1') return stored === '1';
+  return null;
+}
+function isLoopbackAecSupported(win) {
+  var w = win || (typeof window !== 'undefined' ? window : null);
+  if (!w) return false;
+  return typeof w.RTCPeerConnection === 'function' && typeof w.MediaStream === 'function';
+}
+
+/**
+ * Raise Opus quality on a loopback that has no bandwidth cost, and disable the
+ * two features that are wrong for synthesized speech on a local link:
+ *
+ *  - usedtx=0: discontinuous transmission replaces "silence" with comfort
+ *    noise. TTS leading/trailing silence is real audio the segment ledger
+ *    accounts for; letting the codec invent it would desynchronize playedMs.
+ *  - maxaveragebitrate: the default ~32 kbps is chosen for real networks. This
+ *    link is a memcpy, so spend bits instead of degrading a voice the customer
+ *    is paying for.
+ *
+ * Returns the SDP unchanged if there is no Opus line to munge — never throws,
+ * because a failed munge must not cost us the route.
+ */
+function preferHighQualityOpus(sdp) {
+  var bitrate = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 128000;
+  if (typeof sdp !== 'string' || !sdp) return sdp;
+  var rtpmap = sdp.match(/^a=rtpmap:(\d+)\s+opus\/48000(?:\/2)?/mi);
+  if (!rtpmap) return sdp;
+  var pt = rtpmap[1];
+  var params = "stereo=0;useinbandfec=1;usedtx=0;maxaveragebitrate=".concat(bitrate);
+  var fmtpRe = new RegExp("^a=fmtp:".concat(pt, " (.*)$"), 'mi');
+  if (fmtpRe.test(sdp)) {
+    return sdp.replace(fmtpRe, function (line, existing) {
+      // Drop any key we are about to set, keep everything else the browser chose.
+      var kept = existing.split(';').filter(function (kv) {
+        return !/^\s*(stereo|useinbandfec|usedtx|maxaveragebitrate)\s*=/i.test(kv);
+      }).filter(function (kv) {
+        return kv.trim().length > 0;
+      });
+      return "a=fmtp:".concat(pt, " ").concat(kept.concat(params.split(';')).join(';'));
+    });
+  }
+  return sdp.replace(rtpmap[0], "".concat(rtpmap[0], "\r\na=fmtp:").concat(pt, " ").concat(params));
+}
+
+/**
+ * Wire two peer connections together in this tab and return the remote end of
+ * the given stream.
+ *
+ * Resolves { remoteStream, close } once the receiving side reports connected
+ * AND a track has arrived — both, because either alone has been seen without
+ * audible audio. Rejects on timeout so a stalled negotiation degrades to the
+ * caller's existing route rather than leaving the call silent.
+ *
+ * Dependencies are injected (win) so this runs under node --test.
+ */
+function createAecLoopback() {
+  var _ref = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {},
+    stream = _ref.stream,
+    win = _ref.win,
+    _ref$timeoutMs = _ref.timeoutMs,
+    timeoutMs = _ref$timeoutMs === void 0 ? 4000 : _ref$timeoutMs,
+    _ref$bitrate = _ref.bitrate,
+    bitrate = _ref$bitrate === void 0 ? 128000 : _ref$bitrate;
+  var w = win || (typeof window !== 'undefined' ? window : null);
+  if (!w) return Promise.reject(new Error('loopback: no window'));
+  if (!isLoopbackAecSupported(w)) return Promise.reject(new Error('loopback: RTCPeerConnection unavailable'));
+  var tracks = stream && typeof stream.getAudioTracks === 'function' ? stream.getAudioTracks() : [];
+  if (!tracks.length) return Promise.reject(new Error('loopback: source stream has no audio track'));
+
+  // No ICE servers: both ends are in this process, so host candidates are the
+  // only ones that can possibly be useful. Asking for STUN would leak the
+  // user's IP to a third party for a connection that never leaves the tab.
+  var pcSend = new w.RTCPeerConnection({
+    iceServers: []
+  });
+  var pcRecv = new w.RTCPeerConnection({
+    iceServers: []
+  });
+  var settled = false;
+  var timer = null;
+  var remoteStream = new w.MediaStream();
+  var close = function close() {
+    if (timer) {
+      clearTimeout(timer);
+      timer = null;
+    }
+    try {
+      pcSend.close();
+    } catch (e) {/* already closed */}
+    try {
+      pcRecv.close();
+    } catch (e) {/* already closed */}
+  };
+  return new Promise(function (resolve, reject) {
+    var fail = function fail(err) {
+      if (settled) return;
+      settled = true;
+      close();
+      reject(err instanceof Error ? err : new Error(String(err)));
+    };
+    var maybeResolve = function maybeResolve() {
+      if (settled) return;
+      if (!remoteStream.getAudioTracks().length) return;
+      var state = pcRecv.connectionState || pcRecv.iceConnectionState;
+      if (state !== 'connected' && state !== 'completed') return;
+      settled = true;
+      if (timer) {
+        clearTimeout(timer);
+        timer = null;
+      }
+      resolve({
+        remoteStream: remoteStream,
+        close: close,
+        pcSend: pcSend,
+        pcRecv: pcRecv
+      });
+    };
+    timer = setTimeout(function () {
+      return fail(new Error('loopback: negotiation timed out'));
+    }, timeoutMs);
+    pcSend.onicecandidate = function (e) {
+      if (e.candidate) {
+        try {
+          pcRecv.addIceCandidate(e.candidate);
+        } catch (err) {/* late candidate */}
+      }
+    };
+    pcRecv.onicecandidate = function (e) {
+      if (e.candidate) {
+        try {
+          pcSend.addIceCandidate(e.candidate);
+        } catch (err) {/* late candidate */}
+      }
+    };
+    pcRecv.ontrack = function (e) {
+      var track = e.track || e.streams && e.streams[0] && e.streams[0].getAudioTracks()[0];
+      if (track) remoteStream.addTrack(track);
+      maybeResolve();
+    };
+    pcRecv.onconnectionstatechange = function () {
+      var s = pcRecv.connectionState;
+      if (s === 'failed' || s === 'closed') return fail(new Error("loopback: receiver ".concat(s)));
+      maybeResolve();
+    };
+    pcRecv.oniceconnectionstatechange = function () {
+      var s = pcRecv.iceConnectionState;
+      if (s === 'failed') return fail(new Error('loopback: ice failed'));
+      maybeResolve();
+    };
+    _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee() {
+      var offer, tunedOffer, answer, tunedAnswer;
+      return _regenerator().w(function (_context) {
+        while (1) switch (_context.n) {
+          case 0:
+            tracks.forEach(function (t) {
+              return pcSend.addTrack(t, stream);
+            });
+            _context.n = 1;
+            return pcSend.createOffer();
+          case 1:
+            offer = _context.v;
+            tunedOffer = {
+              type: offer.type,
+              sdp: preferHighQualityOpus(offer.sdp, bitrate)
+            };
+            _context.n = 2;
+            return pcSend.setLocalDescription(tunedOffer);
+          case 2:
+            _context.n = 3;
+            return pcRecv.setRemoteDescription(tunedOffer);
+          case 3:
+            _context.n = 4;
+            return pcRecv.createAnswer();
+          case 4:
+            answer = _context.v;
+            tunedAnswer = {
+              type: answer.type,
+              sdp: preferHighQualityOpus(answer.sdp, bitrate)
+            };
+            _context.n = 5;
+            return pcRecv.setLocalDescription(tunedAnswer);
+          case 5:
+            _context.n = 6;
+            return pcSend.setRemoteDescription(tunedAnswer);
+          case 6:
+            maybeResolve();
+          case 7:
+            return _context.a(2);
+        }
+      }, _callee);
+    }))().catch(fail);
+  });
+}
+
+/***/ }),
+
 /***/ "./src/v2/utils/AudioFormatConverter.js":
 /*!**********************************************!*\
   !*** ./src/v2/utils/AudioFormatConverter.js ***!
@@ -35963,7 +36546,7 @@ var TTPChatWidget = /*#__PURE__*/function () {
         return;
       }
       this._ensureAboutStyles();
-      var version =  true ? "2.48.18" : 0;
+      var version =  true ? "2.48.21" : 0;
       var convId = this._getLastConversationId();
       var t = function t(k, fb) {
         try {