ttp-agent-sdk 2.48.16 → 2.48.18

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-27T12:25:20.756Z";
       }
       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.18";
+var BUILD_TIME = "2026-08-27T12:25:20.756Z";
 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,7 @@ __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");
 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 +25647,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.
@@ -25745,6 +25747,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
     _this._mediaStreamDest = null;
     _this._htmlAudioRouteActive = false;
     _this._htmlAudioPlayOk = false;
+    _this._htmlAudioPlayWatchdog = null;
     _this._loggedHopResample = false;
     // Greeting (and other bursts) fire many playChunk()s without await.
     // Serialize context creation so they cannot open two AudioContexts
@@ -27164,37 +27167,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;
       }
@@ -27289,6 +27295,10 @@ 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 {
@@ -27306,31 +27316,72 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
         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');
         });
       }
     }
@@ -27344,10 +27395,15 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
       this._teardownHtmlAudioRoute();
       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();
@@ -27371,7 +27427,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
     key: "initializeAudioContext",
     value: (function () {
       var _initializeAudioContext = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee7() {
-        var _this8 = this;
+        var _this9 = this;
         return _regenerator().w(function (_context8) {
           while (1) switch (_context8.n) {
             case 0:
@@ -27382,7 +27438,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
               return _context8.a(2, this._audioContextInitPromise);
             case 1:
               this._audioContextInitPromise = this._initializeAudioContextImpl().finally(function () {
-                _this8._audioContextInitPromise = null;
+                _this9._audioContextInitPromise = null;
               });
               return _context8.a(2, this._audioContextInitPromise);
           }
@@ -27397,7 +27453,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
     key: "_initializeAudioContextImpl",
     value: function () {
       var _initializeAudioContextImpl2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee8() {
-        var _this9 = this;
+        var _this0 = this;
         var ttsSampleRate, useHardwareRate, desiredSampleRate, contextFits, canReuseShared, setupAfterResume, ctxOpts, _t4;
         return _regenerator().w(function (_context9) {
           while (1) switch (_context9.p = _context9.n) {
@@ -27418,7 +27474,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
                 _sharedPlayerSampleRate = null;
               }
               contextFits = function contextFits(rate) {
-                if (useHardwareRate) return _this9._isHardwarePlaybackRate(rate);
+                if (useHardwareRate) return _this0._isHardwarePlaybackRate(rate);
                 return Math.abs(rate - desiredSampleRate) <= 100;
               }; // Check if current instance AudioContext exists and matches
               if (!this.audioContext) {
@@ -27455,19 +27511,19 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
               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) {
+                _this0.setupAudioContextStateMonitoring();
+                if (_this0.gainNode) {
                   try {
-                    _this9.gainNode.disconnect();
+                    _this0.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();
+                _this0.gainNode = _this0.audioContext.createGain();
+                _this0.gainNode.gain.value = 1.0;
+                _this0._connectGainToOutput();
+                if (!_this0._audioContextPrimed) {
+                  _this0._primeAudioContext();
                 }
               };
               if (!(this.audioContext.state === 'suspended')) {
@@ -27659,7 +27715,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
      * Handles mic permission grants, tab switching, browser suspension, etc.
      */
     function setupAudioContextStateMonitoring() {
-      var _this0 = this;
+      var _this1 = this;
       if (!this.audioContext) {
         return;
       }
@@ -27672,38 +27728,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 (!_this1.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(_this1.audioContext.state));
+        if (_this1.audioContext.state === 'running') {
+          _this1._ensureHtmlAudioPlaying();
         }
-        if (_this0.audioContext.state === 'suspended' && _this0.isPlaying) {
+        if (_this1.audioContext.state === 'suspended' && _this1.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 (_this1.audioContext.state === 'running' && !_this1.isPlaying && (_this1.audioQueue.length > 0 || _this1.pcmChunkQueue.length > 0 || _this1.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 (_this1.audioQueue.length > 0 && !_this1.isProcessingQueue) {
             setTimeout(function () {
-              return _this0.processQueue();
+              return _this1.processQueue();
             }, 50);
           }
-          if (_this0.pcmChunkQueue.length > 0 && !_this0.isProcessingPcmQueue) {
+          if (_this1.pcmChunkQueue.length > 0 && !_this1.isProcessingPcmQueue) {
             setTimeout(function () {
-              return _this0.processPcmQueue();
+              return _this1.processPcmQueue();
             }, 50);
           }
-          if (_this0.preparedBuffer.length > 0 && !_this0.isSchedulingFrames) {
+          if (_this1.preparedBuffer.length > 0 && !_this1.isSchedulingFrames) {
             setTimeout(function () {
-              return _this0.scheduleFrames();
+              return _this1.scheduleFrames();
             }, 50);
           }
         }
@@ -27722,7 +27778,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
     key: "processQueue",
     value: (function () {
       var _processQueue = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee0() {
-        var _this1 = this;
+        var _this10 = this;
         var audioBlob, wasFirstPlay, audioContext, arrayBuffer, audioBuffer, shouldEmitStart, source, _t6;
         return _regenerator().w(function (_context1) {
           while (1) switch (_context1.p = _context1.n) {
@@ -27782,22 +27838,22 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
               // Handle end
 
               source.onended = function () {
-                _this1.currentSource = null;
-                _this1.isProcessingQueue = false;
+                _this10.currentSource = null;
+                _this10.isProcessingQueue = false;
 
                 // Process next chunk
 
-                if (_this1.audioQueue.length > 0) {
+                if (_this10.audioQueue.length > 0) {
                   setTimeout(function () {
-                    return _this1.processQueue();
+                    return _this10.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 (_this10.audioQueue.length === 0 && !_this10.currentSource) {
+                      _this10.isPlaying = false;
+                      _this10.emit('playbackStopped');
                     }
                   }, 100);
                 }
@@ -27820,7 +27876,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
               if (this.audioQueue.length > 0) {
                 this.isProcessingQueue = false;
                 setTimeout(function () {
-                  return _this1.processQueue();
+                  return _this10.processQueue();
                 }, 100);
               } else {
                 this.isPlaying = false;
@@ -28043,7 +28099,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
   }, {
     key: "markNewSentence",
     value: function markNewSentence(text, synced, segmentId) {
-      var _this10 = this;
+      var _this11 = this;
       var wasStopped = this._isStopped;
       var isCurrentlyPlaying = this.isPlaying || this.scheduledSources.size > 0;
 
@@ -28102,34 +28158,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 (_this11.pendingSentenceText === sentenceText && _this11.scheduledBuffers === 0 && _this11.preparedBuffer.length === 0 && _this11.pcmChunkQueue.length === 0 && !_this11._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 (_this11.pendingSegmentId != null) {
+            var emptySegId = _this11.pendingSegmentId;
+            _this11.currentSegmentId = emptySegId;
+            _this11.pendingSegmentId = null;
+            _this11.emit('segmentDone', {
               segmentId: emptySegId,
               status: 'finished',
               playedMs: 0
             });
           }
           // Clear pending sentence to unblock next sentence
-          if (_this10.pendingSentenceText === sentenceText) {
-            _this10.pendingSentenceText = null;
+          if (_this11.pendingSentenceText === sentenceText) {
+            _this11.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 (!_this11.isPlaying && _this11.scheduledSources.size === 0) {
             console.log('🛑 AudioPlayer: Emitting playbackStopped for empty sentence timeout');
-            _this10.emit('playbackStopped', {
-              segmentId: _this10.currentSegmentId
+            _this11.emit('playbackStopped', {
+              segmentId: _this11.currentSegmentId
             });
           }
         }
-        _this10._emptySentenceTimeout = null;
+        _this11._emptySentenceTimeout = null;
       }, 5000); // 5 second timeout - adjust based on expected chunk arrival rate
     }
 
@@ -28139,14 +28195,14 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
   }, {
     key: "startTranscriptChecker",
     value: function startTranscriptChecker() {
-      var _this11 = this;
+      var _this12 = 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 (!_this12.isCheckingTranscripts || !_this12.audioContext) return;
+        var currentTime = _this12.audioContext.currentTime;
+        var _iterator2 = _createForOfIteratorHelper(_this12.sentenceTimings),
           _step2;
         try {
           for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
@@ -28160,13 +28216,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);
+              _this12.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', {
+              _this12.emit('segmentDone', {
                 segmentId: _timing.segmentId,
                 status: 'finished',
                 playedMs: _playedMs
@@ -28178,12 +28234,12 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
         } finally {
           _iterator2.f();
         }
-        if (_this11.isPlaying || _this11.scheduledBuffers > 0) {
+        if (_this12.isPlaying || _this12.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(_this12.sentenceTimings),
             _step3;
           try {
             for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
@@ -28192,7 +28248,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', {
+                _this12.emit('segmentDone', {
                   segmentId: timing.segmentId,
                   status: 'finished',
                   playedMs: playedMs
@@ -28204,7 +28260,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
           } finally {
             _iterator3.f();
           }
-          _this11.isCheckingTranscripts = false;
+          _this12.isCheckingTranscripts = false;
           console.log('📝 AudioPlayer: Transcript checker stopped');
         }
       };
@@ -28368,8 +28424,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 +28462,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 
 
 
+
 /**
 
  * VoiceSDK v2 - Multi-codec speech-to-speech SDK
@@ -28502,23 +28560,20 @@ 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;
@@ -28665,7 +28720,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 +29046,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 +29478,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.18" : 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 +29493,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.18" : 0
         };
       }
     }
@@ -29446,12 +29507,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 +29522,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 +29641,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-27T12:25:20.756Z";
               }
 
               // Client environment (device/browser/webview) for backend logs + Langfuse metadata
@@ -29818,7 +29885,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 +29906,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 +32266,99 @@ 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/utils/AudioFormatConverter.js":
 /*!**********************************************!*\
   !*** ./src/v2/utils/AudioFormatConverter.js ***!
@@ -35803,7 +35963,7 @@ var TTPChatWidget = /*#__PURE__*/function () {
         return;
       }
       this._ensureAboutStyles();
-      var version =  true ? "2.48.16" : 0;
+      var version =  true ? "2.48.18" : 0;
       var convId = this._getLastConversationId();
       var t = function t(k, fb) {
         try {