ttp-agent-sdk 2.48.16 → 2.48.20

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-21T10:43:17.433Z";
+        helloMessage.lastBuildTime = "2026-08-27T16:45:39.666Z";
       }
       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.16";
-var BUILD_TIME = "2026-08-21T10:43:17.433Z";
+var VERSION = "2.48.20";
+var BUILD_TIME = "2026-08-27T16:45:39.666Z";
 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
@@ -25615,6 +25615,8 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _codecs_PCMCodec_js__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./codecs/PCMCodec.js */ "./src/v2/codecs/PCMCodec.js");
 /* 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; }
@@ -25646,6 +25648,8 @@ 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.
@@ -25745,7 +25749,20 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
     _this._mediaStreamDest = null;
     _this._htmlAudioRouteActive = false;
     _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.
@@ -27019,6 +27036,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
         this.gainNode = null;
       }
       this._teardownHtmlAudioRoute();
+      this._teardownLoopbackRoute();
       if (this.audioContext === _sharedPlayerContext) {
         _sharedPlayerContext = null;
         _sharedPlayerSampleRate = null;
@@ -27164,37 +27182,40 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
   }, {
     key: "wantsHtmlAudioPlayback",
     value: function wantsHtmlAudioPlayback() {
-      // Debug/QA override: ?ttp_hop=0|1 or localStorage 'ttp_hop' forces the route
-      // at the decision point, regardless of which config object reached us.
-      try {
-        var _URLSearchParams$get;
-        var flag = (_URLSearchParams$get = new URLSearchParams(window.location.search).get('ttp_hop')) !== null && _URLSearchParams$get !== void 0 ? _URLSearchParams$get : window.localStorage.getItem('ttp_hop');
-        if (flag === '0' || flag === '1') {
-          return flag === '1';
-        }
-      } catch (e) {/* non-browser env */}
+      // Debug/QA override: ?ttp_hop=0|1, its sessionStorage mirror (survives
+      // same-origin full page loads that drop the query string — Borusan's
+      // navigate_to_form), or localStorage 'ttp_hop'. Wins over config.
+      var override = (0,_hopPlatform_js__WEBPACK_IMPORTED_MODULE_4__.readTtpHopOverride)(typeof window !== 'undefined' ? window : null);
+      if (override !== null) {
+        return override;
+      }
       if (typeof this.config.htmlAudioPlayback === 'boolean') {
         return this.config.htmlAudioPlayback;
       }
-      // Default: the hop (AudioContext → MediaStreamDestination → HTMLAudioElement)
-      // gives Chrome's AEC a far-end reference, but Chrome plays that live stream
-      // with adaptive jitter-buffer speed control, which audibly wobbles on
-      // desktop Linux (PipeWire/PulseAudio). Off there, on elsewhere.
-      var hopOn = !this._isDesktopLinux();
+      // Default: HTML hop (AudioContext → MediaStreamDestination → <audio>) gives
+      // Safari/Chrome a far-end AEC reference on Apple mobile + macOS where Web
+      // Audio → destination is not in the echo-cancellation loop. On Windows and
+      // Linux desktop, Chrome-wide AEC already covers speaker echo; the hop only
+      // adds adaptive live-stream speed wobble — keep it off there (same as Linux).
+      var hopOn = this._needsHtmlAudioHopForAec();
       if (!this._hopDefaultLogged) {
         this._hopDefaultLogged = true;
-        console.log("\uD83D\uDD0A AudioPlayer: htmlAudioPlayback default \u2192 ".concat(hopOn ? 'on (AEC far-end route)' : 'off (desktop Linux: hop causes playback speed wobble)'));
+        var reason = hopOn ? 'on (mobile / macOS: AEC far-end route)' : 'off (desktop Windows/Linux: stable direct Web Audio playback)';
+        console.log("\uD83D\uDD0A AudioPlayer: htmlAudioPlayback default \u2192 ".concat(reason));
       }
       return hopOn;
     }
+
+    /** Hop default on only where Web Audio destination lacks AEC far-end reference.
+     *  Policy lives in hopPlatform.js (pure, unit-tested); this only supplies the
+     *  environment strings. */
   }, {
-    key: "_isDesktopLinux",
-    value: function _isDesktopLinux() {
+    key: "_needsHtmlAudioHopForAec",
+    value: function _needsHtmlAudioHopForAec() {
       try {
         var ua = navigator.userAgent || '';
-        if (/Android|iPhone|iPad|iPod/i.test(ua)) return false;
         var platform = navigator.userAgentData && navigator.userAgentData.platform || navigator.platform || '';
-        return /linux/i.test(platform) || /Linux|X11/i.test(ua);
+        return (0,_hopPlatform_js__WEBPACK_IMPORTED_MODULE_4__.needsHtmlAudioHopForAec)(ua, platform);
       } catch (e) {
         return false;
       }
@@ -27215,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,7 +27280,10 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
       return {
         htmlAudioPlayback: this.wantsHtmlAudioPlayback(),
         htmlAudioRouteActive: this._htmlAudioRouteActive,
-        htmlAudioPlayOk: this._htmlAudioPlayOk
+        htmlAudioPlayOk: this._htmlAudioPlayOk,
+        loopbackAec: this.wantsLoopbackAec(),
+        loopbackRouteActive: this._loopbackReady,
+        loopbackPlayOk: this._loopbackPlayOk
       };
     }
 
@@ -27273,6 +27300,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;
@@ -27289,48 +27328,84 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
       }
       if (!this.audioContext || typeof this.audioContext.createMediaStreamDestination !== 'function') {
         console.warn('⚠️ AudioPlayer: MediaStreamDestination unavailable — using AudioContext.destination');
+        this.emit('htmlAudioRoute', {
+          state: 'fallback',
+          reason: 'no_media_stream_destination'
+        });
         return false;
       }
       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();
+        this._armHtmlAudioPlayWatchdog(el);
         console.log('🔊 AudioPlayer: Playback last-hop is HTMLAudioElement (AEC far-end route)');
         return true;
       } catch (e) {
         console.warn('⚠️ AudioPlayer: HTML audio route failed, falling back to destination:', e);
         this._teardownHtmlAudioRoute();
+        this.emit('htmlAudioRoute', {
+          state: 'fallback',
+          reason: 'route_init_failed'
+        });
         return false;
       }
     }
+
+    /**
+     * play() on a MediaStream-backed element can stay pending forever on some
+     * WebKit builds — neither resolving nor rejecting. If the element is still
+     * paused shortly after route creation, report it: the hop never engaged and
+     * AEC has no far-end reference, but audio still reaches the user via the
+     * (silent-failure) direct path only if a fallback happened — so this state
+     * means "route exists, playback through it unconfirmed".
+     */
+  }, {
+    key: "_armHtmlAudioPlayWatchdog",
+    value: function _armHtmlAudioPlayWatchdog(el) {
+      var _this7 = this;
+      this._clearHtmlAudioPlayWatchdog();
+      this._htmlAudioPlayWatchdog = setTimeout(function () {
+        _this7._htmlAudioPlayWatchdog = null;
+        if (_this7._htmlAudioRouteActive && _this7._htmlAudioEl === el && !_this7._htmlAudioPlayOk && el.paused) {
+          console.warn('⚠️ AudioPlayer: HTMLAudioElement.play() still pending after 2.5s — hop engagement unconfirmed');
+          _this7.emit('htmlAudioRoute', {
+            state: 'play_pending'
+          });
+        }
+      }, 2500);
+    }
+  }, {
+    key: "_clearHtmlAudioPlayWatchdog",
+    value: function _clearHtmlAudioPlayWatchdog() {
+      if (this._htmlAudioPlayWatchdog) {
+        clearTimeout(this._htmlAudioPlayWatchdog);
+        this._htmlAudioPlayWatchdog = null;
+      }
+    }
   }, {
     key: "_ensureHtmlAudioPlaying",
     value: function _ensureHtmlAudioPlaying() {
-      var _this7 = this;
+      var _this8 = this;
       var el = this._htmlAudioEl;
       if (!el) return;
       if (!el.paused && this._htmlAudioPlayOk) return;
       var playResult = el.play();
       if (playResult && typeof playResult.then === 'function') {
         playResult.then(function () {
-          _this7._htmlAudioPlayOk = true;
+          _this8._htmlAudioPlayOk = true;
+          _this8._clearHtmlAudioPlayWatchdog();
+          _this8.emit('htmlAudioRoute', {
+            state: 'established'
+          });
         }).catch(function (err) {
-          if (_this7._htmlAudioPlayOk || !el.paused) {
+          if (_this8._htmlAudioPlayOk || !el.paused) {
             return;
           }
           console.warn('⚠️ AudioPlayer: HTMLAudioElement.play() rejected — falling back to destination:', err);
-          _this7._fallbackToDestination('play_rejected');
+          _this8._fallbackToDestination('play_rejected');
         });
       }
     }
@@ -27342,12 +27417,18 @@ 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', {
+        state: 'fallback',
+        reason: reason
+      });
     }
   }, {
     key: "_teardownHtmlAudioRoute",
     value: function _teardownHtmlAudioRoute() {
+      this._clearHtmlAudioPlayWatchdog();
       if (this._htmlAudioEl) {
         try {
           this._htmlAudioEl.pause();
@@ -27364,29 +27445,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 _this8 = 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 () {
-                _this8._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);
@@ -27396,11 +27664,11 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
   }, {
     key: "_initializeAudioContextImpl",
     value: function () {
-      var _initializeAudioContextImpl2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee8() {
-        var _this9 = 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
@@ -27418,27 +27686,27 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
                 _sharedPlayerSampleRate = null;
               }
               contextFits = function contextFits(rate) {
-                if (useHardwareRate) return _this9._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();
@@ -27449,44 +27717,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() {
-                _this9.setupAudioContextStateMonitoring();
-                if (_this9.gainNode) {
+                _this10.setupAudioContextStateMonitoring();
+                if (_this10.gainNode) {
                   try {
-                    _this9.gainNode.disconnect();
+                    _this10.gainNode.disconnect();
                   } catch (e) {
                     console.warn('⚠️ AudioPlayer: Error disconnecting old GainNode:', e);
                   }
                 }
-                _this9.gainNode = _this9.audioContext.createGain();
-                _this9.gainNode.gain.value = 1.0;
-                _this9._connectGainToOutput();
-                if (!_this9._audioContextPrimed) {
-                  _this9._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)"));
 
@@ -27539,9 +27807,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);
@@ -27555,17 +27823,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);
@@ -27576,23 +27844,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);
@@ -27619,6 +27887,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
         this.gainNode = null;
       }
       this._teardownHtmlAudioRoute();
+      this._teardownLoopbackRoute();
 
       // Remove state change listener first
       if (this._audioContextStateChangeHandler && this.audioContext) {
@@ -27659,7 +27928,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
      * Handles mic permission grants, tab switching, browser suspension, etc.
      */
     function setupAudioContextStateMonitoring() {
-      var _this0 = this;
+      var _this11 = this;
       if (!this.audioContext) {
         return;
       }
@@ -27672,38 +27941,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 (!_this0.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(_this0.audioContext.state));
-        if (_this0.audioContext.state === 'running') {
-          _this0._ensureHtmlAudioPlaying();
+        console.log("\uD83C\uDFB5 AudioPlayer: AudioContext state changed to: ".concat(_this11.audioContext.state));
+        if (_this11.audioContext.state === 'running') {
+          _this11._ensureHtmlAudioPlaying();
         }
-        if (_this0.audioContext.state === 'suspended' && _this0.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 (_this0.audioContext.state === 'running' && !_this0.isPlaying && (_this0.audioQueue.length > 0 || _this0.pcmChunkQueue.length > 0 || _this0.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 (_this0.audioQueue.length > 0 && !_this0.isProcessingQueue) {
+          if (_this11.audioQueue.length > 0 && !_this11.isProcessingQueue) {
             setTimeout(function () {
-              return _this0.processQueue();
+              return _this11.processQueue();
             }, 50);
           }
-          if (_this0.pcmChunkQueue.length > 0 && !_this0.isProcessingPcmQueue) {
+          if (_this11.pcmChunkQueue.length > 0 && !_this11.isProcessingPcmQueue) {
             setTimeout(function () {
-              return _this0.processPcmQueue();
+              return _this11.processPcmQueue();
             }, 50);
           }
-          if (_this0.preparedBuffer.length > 0 && !_this0.isSchedulingFrames) {
+          if (_this11.preparedBuffer.length > 0 && !_this11.isSchedulingFrames) {
             setTimeout(function () {
-              return _this0.scheduleFrames();
+              return _this11.scheduleFrames();
             }, 50);
           }
         }
@@ -27721,49 +27990,49 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
   }, {
     key: "processQueue",
     value: (function () {
-      var _processQueue = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee0() {
-        var _this1 = 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;
@@ -27782,22 +28051,22 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
               // Handle end
 
               source.onended = function () {
-                _this1.currentSource = null;
-                _this1.isProcessingQueue = false;
+                _this12.currentSource = null;
+                _this12.isProcessingQueue = false;
 
                 // Process next chunk
 
-                if (_this1.audioQueue.length > 0) {
+                if (_this12.audioQueue.length > 0) {
                   setTimeout(function () {
-                    return _this1.processQueue();
+                    return _this12.processQueue();
                   }, 50);
                 } else {
                   // No more chunks - stop after delay
 
                   setTimeout(function () {
-                    if (_this1.audioQueue.length === 0 && !_this1.currentSource) {
-                      _this1.isPlaying = false;
-                      _this1.emit('playbackStopped');
+                    if (_this12.audioQueue.length === 0 && !_this12.currentSource) {
+                      _this12.isPlaying = false;
+                      _this12.emit('playbackStopped');
                     }
                   }, 100);
                 }
@@ -27806,11 +28075,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);
@@ -27820,7 +28089,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
               if (this.audioQueue.length > 0) {
                 this.isProcessingQueue = false;
                 setTimeout(function () {
-                  return _this1.processQueue();
+                  return _this12.processQueue();
                 }, 100);
               } else {
                 this.isPlaying = false;
@@ -27828,9 +28097,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);
@@ -28043,7 +28312,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
   }, {
     key: "markNewSentence",
     value: function markNewSentence(text, synced, segmentId) {
-      var _this10 = this;
+      var _this13 = this;
       var wasStopped = this._isStopped;
       var isCurrentlyPlaying = this.isPlaying || this.scheduledSources.size > 0;
 
@@ -28102,34 +28371,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 (_this10.pendingSentenceText === sentenceText && _this10.scheduledBuffers === 0 && _this10.preparedBuffer.length === 0 && _this10.pcmChunkQueue.length === 0 && !_this10._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 (_this10.pendingSegmentId != null) {
-            var emptySegId = _this10.pendingSegmentId;
-            _this10.currentSegmentId = emptySegId;
-            _this10.pendingSegmentId = null;
-            _this10.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 (_this10.pendingSentenceText === sentenceText) {
-            _this10.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 (!_this10.isPlaying && _this10.scheduledSources.size === 0) {
+          if (!_this13.isPlaying && _this13.scheduledSources.size === 0) {
             console.log('🛑 AudioPlayer: Emitting playbackStopped for empty sentence timeout');
-            _this10.emit('playbackStopped', {
-              segmentId: _this10.currentSegmentId
+            _this13.emit('playbackStopped', {
+              segmentId: _this13.currentSegmentId
             });
           }
         }
-        _this10._emptySentenceTimeout = null;
+        _this13._emptySentenceTimeout = null;
       }, 5000); // 5 second timeout - adjust based on expected chunk arrival rate
     }
 
@@ -28139,14 +28408,14 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
   }, {
     key: "startTranscriptChecker",
     value: function startTranscriptChecker() {
-      var _this11 = this;
+      var _this14 = this;
       if (this.isCheckingTranscripts) return;
       this.isCheckingTranscripts = true;
       console.log('📝 AudioPlayer: Transcript checker started');
       var _checkLoop = function checkLoop() {
-        if (!_this11.isCheckingTranscripts || !_this11.audioContext) return;
-        var currentTime = _this11.audioContext.currentTime;
-        var _iterator2 = _createForOfIteratorHelper(_this11.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;) {
@@ -28160,13 +28429,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, ")"));
-              _this11.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);
-              _this11.emit('segmentDone', {
+              _this14.emit('segmentDone', {
                 segmentId: _timing.segmentId,
                 status: 'finished',
                 playedMs: _playedMs
@@ -28178,12 +28447,12 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
         } finally {
           _iterator2.f();
         }
-        if (_this11.isPlaying || _this11.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(_this11.sentenceTimings),
+          var _iterator3 = _createForOfIteratorHelper(_this14.sentenceTimings),
             _step3;
           try {
             for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
@@ -28192,7 +28461,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);
-                _this11.emit('segmentDone', {
+                _this14.emit('segmentDone', {
                   segmentId: timing.segmentId,
                   status: 'finished',
                   playedMs: playedMs
@@ -28204,7 +28473,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
           } finally {
             _iterator3.f();
           }
-          _this11.isCheckingTranscripts = false;
+          _this14.isCheckingTranscripts = false;
           console.log('📝 AudioPlayer: Transcript checker stopped');
         }
       };
@@ -28235,43 +28504,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);
@@ -28368,8 +28637,9 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _core_ClientToolsRegistry_js__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! ../core/ClientToolsRegistry.js */ "./src/core/ClientToolsRegistry.js");
 /* harmony import */ var _core_ClientScriptManager_js__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(/*! ../core/ClientScriptManager.js */ "./src/core/ClientScriptManager.js");
 /* harmony import */ var _core_helloFlavor_js__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(/*! ../core/helloFlavor.js */ "./src/core/helloFlavor.js");
-/* harmony import */ var _utils_screenshot_js__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(/*! ../utils/screenshot.js */ "./src/utils/screenshot.js");
-/* harmony import */ var _utils_visual_tools_js__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(/*! ../utils/visual-tools.js */ "./src/utils/visual-tools.js");
+/* harmony import */ var _hopPlatform_js__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(/*! ./hopPlatform.js */ "./src/v2/hopPlatform.js");
+/* harmony import */ var _utils_screenshot_js__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(/*! ../utils/screenshot.js */ "./src/utils/screenshot.js");
+/* harmony import */ var _utils_visual_tools_js__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(/*! ../utils/visual-tools.js */ "./src/utils/visual-tools.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 _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t.return || t.return(); } finally { if (u) throw o; } } }; }
 function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
@@ -28405,6 +28675,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 
 
 
+
 /**
 
  * VoiceSDK v2 - Multi-codec speech-to-speech SDK
@@ -28502,27 +28773,29 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
       // Audio constraints for getUserMedia (optional)
       // If not provided, defaults will be used: echoCancellation: true, noiseSuppression: true, autoGainControl: true
       audioConstraints: config.audioConstraints || null,
-      // Last-hop TTS playback via hidden <audio> (AEC far-end). Default on.
-      // Set false to fall back to AudioContext.destination (old path).
-      // QA/debug override wins over config: ?ttp_hop=0 / localStorage ttp_hop=0
-      // forces AudioContext.destination; =1 forces the HTML hop.
+      // Last-hop TTS playback via hidden <audio> (AEC far-end). Platform default
+      // (hop on mobile/macOS only) applies when unset; set explicitly to force.
+      // QA/debug override wins over config: ?ttp_hop=0|1 — mirrored to
+      // sessionStorage 'ttp_hop_pref' so it survives same-origin full page loads
+      // (Borusan navigate_to_form) — then localStorage 'ttp_hop'.
       htmlAudioPlayback: function () {
         try {
-          var _URLSearchParams$get;
-          var flag = (_URLSearchParams$get = new URLSearchParams(window.location.search).get('ttp_hop')) !== null && _URLSearchParams$get !== void 0 ? _URLSearchParams$get : window.localStorage.getItem('ttp_hop');
-          if (flag === '0' || flag === '1') {
-            console.log("\uD83D\uDD27 VoiceSDK v2: ttp_hop override=".concat(flag, " \u2192 htmlAudioPlayback=").concat(flag === '1'));
-            return flag === '1';
-          }
-          if (flag !== null && flag !== undefined) {
-            console.log("\uD83D\uDD27 VoiceSDK v2: ttp_hop ignored (value '".concat(flag, "', expected '0' or '1')"));
+          var override = (0,_hopPlatform_js__WEBPACK_IMPORTED_MODULE_7__.readTtpHopOverride)(typeof window !== 'undefined' ? window : null);
+          if (override !== null) {
+            console.log("\uD83D\uDD27 VoiceSDK v2: ttp_hop override \u2192 htmlAudioPlayback=".concat(override));
+            return override;
           }
         } catch (e) {
-          console.log('🔧 VoiceSDK v2: ttp_hop check threw (storage blocked?):', e && e.message);
+          console.log('🔧 VoiceSDK v2: ttp_hop check threw:', e && e.message);
         }
         // 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,
@@ -28665,7 +28938,7 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
     key: "_registerBuiltInTools",
     value: function _registerBuiltInTools() {
       try {
-        (0,_utils_visual_tools_js__WEBPACK_IMPORTED_MODULE_8__.registerVisualTools)(this.clientToolsRegistry);
+        (0,_utils_visual_tools_js__WEBPACK_IMPORTED_MODULE_9__.registerVisualTools)(this.clientToolsRegistry);
       } catch (error) {
         console.error('❌ VoiceSDK: Error registering built-in tools:', error);
         console.error('   Error details:', error.message, error.stack);
@@ -28991,6 +29264,12 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
     key: "setupAudioPlayerEvents",
     value: function setupAudioPlayerEvents() {
       var _this3 = this;
+      // The initial client_audio_info snapshot (at recordingStarted) predates
+      // HTML-hop establishment, so its htmlAudioRouteActive/htmlAudioPlayOk are
+      // always false. Re-report once the route outcome is known.
+      this.audioPlayer.on('htmlAudioRoute', function (info) {
+        _this3._sendClientAudioInfo(info);
+      });
       this.audioPlayer.on('playbackStarted', function (info) {
         _this3.isPlaying = true;
 
@@ -29417,7 +29696,7 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
         // 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.16" : 0,
+          sdkVersion:  true ? "2.48.20" : 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,
@@ -29432,7 +29711,7 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
       } catch (e) {
         console.warn('⚠️ VoiceSDK v2: Failed to build client env:', e);
         return {
-          sdkVersion:  true ? "2.48.16" : 0
+          sdkVersion:  true ? "2.48.20" : 0
         };
       }
     }
@@ -29446,12 +29725,14 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
      */
   }, {
     key: "_sendClientAudioInfo",
-    value: function _sendClientAudioInfo() {
+    value: function _sendClientAudioInfo(routeUpdate) {
       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 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];
-        if (!track) return;
-        var s = track.getSettings ? track.getSettings() : {};
+        // 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;
+        var s = track && track.getSettings ? track.getSettings() : {};
         var audio = _objectSpread({
           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,
@@ -29459,11 +29740,15 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
           voiceIsolation: (_s$voiceIsolation = s.voiceIsolation) !== null && _s$voiceIsolation !== void 0 ? _s$voiceIsolation : null,
           trackRate: (_s$sampleRate = s.sampleRate) !== null && _s$sampleRate !== void 0 ? _s$sampleRate : null,
           channels: (_s$channelCount = s.channelCount) !== null && _s$channelCount !== void 0 ? _s$channelCount : null,
-          mic: track.label || 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,
           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)) || {});
+        if (routeUpdate && routeUpdate.state) {
+          audio.routeUpdate = routeUpdate.state; // 'established' | 'fallback' | 'play_pending'
+          if (routeUpdate.reason) audio.routeFallbackReason = routeUpdate.reason;
+        }
         this.sendMessage({
           t: 'client_audio_info',
           audio: audio
@@ -29574,7 +29859,7 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
 
               // Include SDK build time for debugging
               if (true) {
-                helloMessage.lastBuildTime = "2026-08-21T10:43:17.433Z";
+                helloMessage.lastBuildTime = "2026-08-27T16:45:39.666Z";
               }
 
               // Client environment (device/browser/webview) for backend logs + Langfuse metadata
@@ -29818,7 +30103,7 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
           case 'get_page_context':
             // Handle get_page_context request from backend
             console.log('📖 [VISUAL ASSISTANT] Backend requested page context');
-            (0,_utils_visual_tools_js__WEBPACK_IMPORTED_MODULE_8__.extractPageContext)().then(function (pageContext) {
+            (0,_utils_visual_tools_js__WEBPACK_IMPORTED_MODULE_9__.extractPageContext)().then(function (pageContext) {
               // Use existing DOM scanner
               _this6.sendMessage({
                 t: 'page_context',
@@ -29839,7 +30124,7 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
             console.log('📸 [VISUAL ASSISTANT] Backend requested screenshot');
             try {
               // Use existing screenshot capture function
-              (0,_utils_screenshot_js__WEBPACK_IMPORTED_MODULE_7__.captureScreenshot)().then(function (screenshot) {
+              (0,_utils_screenshot_js__WEBPACK_IMPORTED_MODULE_8__.captureScreenshot)().then(function (screenshot) {
                 _this6.sendMessage({
                   t: 'screenshot',
                   screenshot: {
@@ -32199,6 +32484,376 @@ var PCMUCodec = /*#__PURE__*/function () {
 
 /***/ }),
 
+/***/ "./src/v2/hopPlatform.js":
+/*!*******************************!*\
+  !*** ./src/v2/hopPlatform.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_HOP_SESSION_KEY: () => (/* binding */ TTP_HOP_SESSION_KEY),
+/* harmony export */   isMacDesktopUa: () => (/* binding */ isMacDesktopUa),
+/* harmony export */   isMobileUa: () => (/* binding */ isMobileUa),
+/* harmony export */   needsHtmlAudioHopForAec: () => (/* binding */ needsHtmlAudioHopForAec),
+/* harmony export */   readTtpHopOverride: () => (/* binding */ readTtpHopOverride)
+/* harmony export */ });
+/**
+ * HTML-audio-hop platform policy + the ttp_hop QA override.
+ *
+ * The "hop" is AudioContext → MediaStreamDestination → hidden <audio>, used so
+ * the browser's echo canceller sees agent TTS as a far-end reference. Chrome
+ * renders that live stream with adaptive jitter-buffer speed control, which
+ * audibly wobbles on Windows/Linux desktop — so the hop defaults ON only where
+ * Web Audio → destination genuinely lacks an AEC reference (mobile + macOS).
+ *
+ * Kept DOM-free (all inputs passed in) so the policy is unit-testable without
+ * a browser: see test/hop-platform.test.mjs.
+ */
+
+/** sessionStorage key mirroring an explicit ?ttp_hop= URL value (see readTtpHopOverride). */
+var TTP_HOP_SESSION_KEY = 'ttp_hop_pref';
+function isMobileUa(ua) {
+  return /Android|iPhone|iPad|iPod/i.test(ua || '');
+}
+function isMacDesktopUa(ua, platform) {
+  if (/iPhone|iPad|iPod/i.test(ua || '')) return false;
+  return /mac/i.test(platform || '') || /Mac OS X/i.test(ua || '');
+}
+
+/**
+ * Hop default: on only where Web Audio destination lacks an AEC far-end
+ * reference (mobile + macOS). Windows/Linux/ChromeOS desktop: off — Chrome-wide
+ * AEC already covers speaker echo there, and the hop only adds speed wobble.
+ * Unknown/empty environment: off (fail toward the stable direct path).
+ */
+function needsHtmlAudioHopForAec(ua, platform) {
+  return isMobileUa(ua) || isMacDesktopUa(ua, platform);
+}
+
+/**
+ * QA/debug override for the hop route. Returns true (force hop on), false
+ * (force off), or null (no override — apply config/platform default).
+ *
+ * Precedence: URL ?ttp_hop=0|1 → sessionStorage mirror → localStorage 'ttp_hop'.
+ *
+ * An explicit URL value is mirrored into sessionStorage (TTP_HOP_SESSION_KEY)
+ * so it survives same-origin full page loads that drop the query string —
+ * Borusan's navigate_to_form does window.location.href = '/path' (call
+ * 84b5af7d), which used to silently re-apply the platform default mid-call.
+ * The mirror dies with the tab; localStorage remains the sticky manual knob
+ * and ranks below the mirror because the URL value is the more recent intent.
+ *
+ * Every storage touch is individually guarded: browsers can block one storage
+ * area but not another, and a blocked sessionStorage must not cost us the
+ * localStorage fallback.
+ */
+function readTtpHopOverride(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_hop');
+  } catch (e) {/* no location in this env */}
+  if (flag === '0' || flag === '1') {
+    try {
+      w.sessionStorage.setItem(TTP_HOP_SESSION_KEY, flag);
+    } catch (e) {/* storage blocked */}
+    return flag === '1';
+  }
+  var mirrored = null;
+  try {
+    mirrored = w.sessionStorage.getItem(TTP_HOP_SESSION_KEY);
+  } catch (e) {/* storage blocked */}
+  if (mirrored === '0' || mirrored === '1') return mirrored === '1';
+  var stored = null;
+  try {
+    stored = w.localStorage.getItem('ttp_hop');
+  } catch (e) {/* storage blocked */}
+  if (stored === '0' || stored === '1') return stored === '1';
+  return null;
+}
+
+/***/ }),
+
+/***/ "./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 ***!
@@ -35803,7 +36458,7 @@ var TTPChatWidget = /*#__PURE__*/function () {
         return;
       }
       this._ensureAboutStyles();
-      var version =  true ? "2.48.16" : 0;
+      var version =  true ? "2.48.20" : 0;
       var convId = this._getLastConversationId();
       var t = function t(k, fb) {
         try {