ttp-agent-sdk 2.48.20 → 2.48.21

package/dist/agent-widget.dev.js

@@ -12129,7 +12129,7 @@ var TextChatSDK = /*#__PURE__*/function (_EventEmitter) {
 
       // SDK build time for debugging
       if (true) {
-        helloMessage.lastBuildTime = "2026-08-27T16:45:39.666Z";
+        helloMessage.lastBuildTime = "2026-08-27T17:29:05.172Z";
       }
       try {
         this.ws.send(JSON.stringify(helloMessage));
@@ -21439,8 +21439,8 @@ var VoiceSDK = _v2_VoiceSDK_js__WEBPACK_IMPORTED_MODULE_0__["default"];
 
 
 // Version - injected at build time from package.json via webpack DefinePlugin
-var VERSION = "2.48.20";
-var BUILD_TIME = "2026-08-27T16:45:39.666Z";
+var VERSION = "2.48.21";
+var BUILD_TIME = "2026-08-27T17:29:05.172Z";
 console.log("%c TTP Agent SDK v".concat(VERSION, " (").concat(BUILD_TIME, ") "), 'background: #4f46e5; color: white; font-size: 12px; font-weight: bold; padding: 2px 6px; border-radius: 4px;');
 
 // Named exports
@@ -27274,18 +27274,78 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
         sampleRate: audioDataSampleRate
       };
     }
+
+    /**
+     * Read-only playback-route telemetry for hello (`client`) and client_audio_info.
+     * Does not influence route selection — mirrors flags set by _connectGainToOutput.
+     */
   }, {
-    key: "getHtmlAudioPlaybackInfo",
-    value: function getHtmlAudioPlaybackInfo() {
+    key: "getPlaybackRouteReport",
+    value: function getPlaybackRouteReport() {
+      var htmlAudioPlayback = this.wantsHtmlAudioPlayback();
+      var loopbackWanted = this.wantsLoopbackAec();
+      var playbackRoute = this._reportEffectivePlaybackRoute();
       return {
-        htmlAudioPlayback: this.wantsHtmlAudioPlayback(),
+        htmlAudioPlayback: htmlAudioPlayback,
+        playbackRoute: playbackRoute,
+        loopbackAttach: this._reportLoopbackAttach(loopbackWanted, playbackRoute),
+        // Legacy booleans — kept for downstream consumers that predated tri-state.
         htmlAudioRouteActive: this._htmlAudioRouteActive,
         htmlAudioPlayOk: this._htmlAudioPlayOk,
-        loopbackAec: this.wantsLoopbackAec(),
+        loopbackAec: loopbackWanted,
         loopbackRouteActive: this._loopbackReady,
         loopbackPlayOk: this._loopbackPlayOk
       };
     }
+  }, {
+    key: "getHtmlAudioPlaybackInfo",
+    value: function getHtmlAudioPlaybackInfo() {
+      return this.getPlaybackRouteReport();
+    }
+
+    /** Effective last-hop route from established player state (not config intent). */
+  }, {
+    key: "_reportEffectivePlaybackRoute",
+    value: function _reportEffectivePlaybackRoute() {
+      if (this._loopbackReady && !this._loopbackFailed) {
+        return 'loopback';
+      }
+      if (this._htmlAudioRouteActive) {
+        return 'htmlHop';
+      }
+      return 'destination';
+    }
+  }, {
+    key: "_reportLoopbackAttach",
+    value: function _reportLoopbackAttach(loopbackWanted, playbackRoute) {
+      if (!loopbackWanted) {
+        return {
+          outcome: 'not_attempted'
+        };
+      }
+      if (this._loopbackFailed) {
+        return {
+          outcome: 'failed',
+          fallbackTo: playbackRoute
+        };
+      }
+      if (this._loopbackReady && this._loopbackPlayOk) {
+        return {
+          outcome: 'success'
+        };
+      }
+      if (this._loopbackReady && !this._loopbackPlayOk) {
+        // Peer path is up; element play() not yet confirmed.
+        return {
+          outcome: 'pending'
+        };
+      }
+      // Negotiation in flight — audio may be on an interim hop/destination route.
+      return {
+        outcome: 'pending',
+        fallbackTo: playbackRoute
+      };
+    }
 
     /**
      * Last hop: GainNode → MediaStreamDestination → hidden <audio>.
@@ -28868,6 +28928,9 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
     _this.pendingInjections = new Map(); // Maps correlationId to { resolve, reject, timeout }
     _this.injectionCounter = 0; // Counter for generating unique correlation IDs
 
+    // One settled playback-route report per call (first segment audible).
+    _this._playbackRouteSettledSent = false;
+
     // Barge-in detection is handled by the backend, not the frontend
     // The backend analyzes the audio stream and sends 'barge_in' message when user interrupts
     // Frontend only responds to backend barge-in messages
@@ -29280,6 +29343,18 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
         }
         _this3.emit('playbackStarted');
 
+        // Unconditional settled playback-route report on first audible segment —
+        // even when the route matches hello-time telemetry and no htmlAudioRoute
+        // event fired afterward (e.g. loopback succeeded quietly).
+        if (!_this3._playbackRouteSettledSent) {
+          var _info$segmentId;
+          _this3._playbackRouteSettledSent = true;
+          _this3._sendClientAudioInfo(null, {
+            settled: true,
+            segmentId: (_info$segmentId = info === null || info === void 0 ? void 0 : info.segmentId) !== null && _info$segmentId !== void 0 ? _info$segmentId : null
+          });
+        }
+
         // Transcripts are displayed when they arrive (between sentences)
         // No need to handle transcript display here - it's handled in handleTranscript()
 
@@ -29569,6 +29644,7 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
                   _this5.isConnected = false;
                   _this5.helloAckReceived = false;
                   _this5.disclaimersPending = false;
+                  _this5._playbackRouteSettledSent = false;
 
                   // Discard any audio still held by the first-playback gate
                   _this5._dropPlaybackGate();
@@ -29686,7 +29762,7 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
     key: "_buildClientEnv",
     value: function _buildClientEnv() {
       try {
-        var _uaData$mobile, _window$screen, _window$screen2;
+        var _uaData$mobile, _window$screen, _window$screen2, _this$audioPlayer, _this$audioPlayer$get;
         var ua = navigator.userAgent || '';
         var uaData = navigator.userAgentData;
         var conn = navigator.connection || navigator.mozConnection || navigator.webkitConnection;
@@ -29695,8 +29771,8 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
         // Webview heuristic: Android WebView marks itself with "; wv)" or "Version/x.x Chrome";
         // iOS in-app webviews lack "Safari" in the UA (real Safari always has it).
         var webview = isAndroid && (/\bwv\b/.test(ua) || /Version\/[\d.]+.*Chrome/.test(ua)) || isIos && !/Safari/i.test(ua) || false;
-        var env = {
-          sdkVersion:  true ? "2.48.20" : 0,
+        var env = _objectSpread({
+          sdkVersion:  true ? "2.48.21" : 0,
           ua: ua,
           platform: (uaData === null || uaData === void 0 ? void 0 : uaData.platform) || navigator.platform || '',
           mobile: (_uaData$mobile = uaData === null || uaData === void 0 ? void 0 : uaData.mobile) !== null && _uaData$mobile !== void 0 ? _uaData$mobile : isAndroid || isIos,
@@ -29706,34 +29782,43 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
           cores: navigator.hardwareConcurrency || null,
           memoryGb: navigator.deviceMemory || null,
           connection: (conn === null || conn === void 0 ? void 0 : conn.effectiveType) || null
-        };
+        }, ((_this$audioPlayer = this.audioPlayer) === null || _this$audioPlayer === void 0 || (_this$audioPlayer$get = _this$audioPlayer.getPlaybackRouteReport) === null || _this$audioPlayer$get === void 0 ? void 0 : _this$audioPlayer$get.call(_this$audioPlayer)) || {
+          htmlAudioPlayback: null,
+          playbackRoute: 'destination',
+          loopbackAttach: {
+            outcome: 'not_attempted'
+          }
+        });
         return env;
       } catch (e) {
         console.warn('⚠️ VoiceSDK v2: Failed to build client env:', e);
         return {
-          sdkVersion:  true ? "2.48.20" : 0
+          sdkVersion:  true ? "2.48.21" : 0
         };
       }
     }
 
     /**
-     * One-shot telemetry sent right after recording starts (t:'client_audio_info').
-     * Reports the capture track's ACTUAL settings from getSettings() — echoCancellation /
-     * noiseSuppression / autoGainControl as the browser really applied them (not what we
-     * requested), which is the ground truth for diagnosing speakerphone echo barge-in —
-     * plus mic label, AudioContext rates, and whether the minimal-constraints fallback fired.
+     * Telemetry sent as t:'client_audio_info'. Interim snapshots (capture start,
+     * htmlAudioRoute transitions) use routeReportKind:'interim'. The first audible
+     * segment emits routeReportKind:'settled' exactly once per connection.
      */
   }, {
     key: "_sendClientAudioInfo",
     value: function _sendClientAudioInfo(routeUpdate) {
+      var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
       try {
-        var _this$audioRecorder, _this$audioRecorder$g, _s$echoCancellation, _s$noiseSuppression, _s$autoGainControl, _s$voiceIsolation, _s$sampleRate, _s$channelCount, _this$audioRecorder2, _this$audioPlayer, _this$audioRecorder3, _this$audioPlayer2, _this$audioPlayer2$ge;
+        var _this$audioRecorder, _this$audioRecorder$g, _s$echoCancellation, _s$noiseSuppression, _s$autoGainControl, _s$voiceIsolation, _s$sampleRate, _s$channelCount, _this$audioRecorder2, _this$audioPlayer2, _this$audioRecorder3, _this$audioPlayer3, _this$audioPlayer3$ge;
+        var settled = options.settled === true;
         var track = (_this$audioRecorder = this.audioRecorder) === null || _this$audioRecorder === void 0 || (_this$audioRecorder = _this$audioRecorder.mediaStream) === null || _this$audioRecorder === void 0 || (_this$audioRecorder$g = _this$audioRecorder.getAudioTracks) === null || _this$audioRecorder$g === void 0 ? void 0 : _this$audioRecorder$g.call(_this$audioRecorder)[0];
         // Route updates must go out even before the mic track exists — the hop
-        // state is the whole point of the follow-up.
-        if (!track && !routeUpdate) return;
+        // state is the whole point of the follow-up. Settled reports go out even
+        // if capture never started (monitor / playback-only paths).
+        if (!track && !routeUpdate && !settled) return;
         var s = track && track.getSettings ? track.getSettings() : {};
         var audio = _objectSpread({
+          sdkVersion:  true ? "2.48.21" : 0,
+          routeReportKind: settled ? 'settled' : 'interim',
           aec: (_s$echoCancellation = s.echoCancellation) !== null && _s$echoCancellation !== void 0 ? _s$echoCancellation : null,
           ns: (_s$noiseSuppression = s.noiseSuppression) !== null && _s$noiseSuppression !== void 0 ? _s$noiseSuppression : null,
           agc: (_s$autoGainControl = s.autoGainControl) !== null && _s$autoGainControl !== void 0 ? _s$autoGainControl : null,
@@ -29742,18 +29827,21 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
           channels: (_s$channelCount = s.channelCount) !== null && _s$channelCount !== void 0 ? _s$channelCount : null,
           mic: track ? track.label || null : null,
           captureCtxRate: ((_this$audioRecorder2 = this.audioRecorder) === null || _this$audioRecorder2 === void 0 || (_this$audioRecorder2 = _this$audioRecorder2.audioContext) === null || _this$audioRecorder2 === void 0 ? void 0 : _this$audioRecorder2.sampleRate) || null,
-          playbackCtxRate: ((_this$audioPlayer = this.audioPlayer) === null || _this$audioPlayer === void 0 || (_this$audioPlayer = _this$audioPlayer.audioContext) === null || _this$audioPlayer === void 0 ? void 0 : _this$audioPlayer.sampleRate) || null,
+          playbackCtxRate: ((_this$audioPlayer2 = this.audioPlayer) === null || _this$audioPlayer2 === void 0 || (_this$audioPlayer2 = _this$audioPlayer2.audioContext) === null || _this$audioPlayer2 === void 0 ? void 0 : _this$audioPlayer2.sampleRate) || null,
           constraintsFallback: ((_this$audioRecorder3 = this.audioRecorder) === null || _this$audioRecorder3 === void 0 || (_this$audioRecorder3 = _this$audioRecorder3.mediaStream) === null || _this$audioRecorder3 === void 0 ? void 0 : _this$audioRecorder3._ttpConstraintsFallback) === true
-        }, ((_this$audioPlayer2 = this.audioPlayer) === null || _this$audioPlayer2 === void 0 || (_this$audioPlayer2$ge = _this$audioPlayer2.getHtmlAudioPlaybackInfo) === null || _this$audioPlayer2$ge === void 0 ? void 0 : _this$audioPlayer2$ge.call(_this$audioPlayer2)) || {});
+        }, ((_this$audioPlayer3 = this.audioPlayer) === null || _this$audioPlayer3 === void 0 || (_this$audioPlayer3$ge = _this$audioPlayer3.getPlaybackRouteReport) === null || _this$audioPlayer3$ge === void 0 ? void 0 : _this$audioPlayer3$ge.call(_this$audioPlayer3)) || {});
+        if (settled && options.segmentId != null) {
+          audio.settledAtSegmentId = options.segmentId;
+        }
         if (routeUpdate && routeUpdate.state) {
-          audio.routeUpdate = routeUpdate.state; // 'established' | 'fallback' | 'play_pending'
+          audio.routeUpdate = routeUpdate.state; // 'established' | 'fallback' | 'play_pending' | ...
           if (routeUpdate.reason) audio.routeFallbackReason = routeUpdate.reason;
         }
         this.sendMessage({
           t: 'client_audio_info',
           audio: audio
         });
-        console.log('🎛️ VoiceSDK v2: Sent client_audio_info:', audio);
+        console.log("\uD83C\uDF9B\uFE0F VoiceSDK v2: Sent client_audio_info (".concat(audio.routeReportKind, "):"), audio);
       } catch (e) {
         console.warn('⚠️ VoiceSDK v2: Failed to send client_audio_info:', e);
       }
@@ -29859,7 +29947,7 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
 
               // Include SDK build time for debugging
               if (true) {
-                helloMessage.lastBuildTime = "2026-08-27T16:45:39.666Z";
+                helloMessage.lastBuildTime = "2026-08-27T17:29:05.172Z";
               }
 
               // Client environment (device/browser/webview) for backend logs + Langfuse metadata
@@ -36458,7 +36546,7 @@ var TTPChatWidget = /*#__PURE__*/function () {
         return;
       }
       this._ensureAboutStyles();
-      var version =  true ? "2.48.20" : 0;
+      var version =  true ? "2.48.21" : 0;
       var convId = this._getLastConversationId();
       var t = function t(k, fb) {
         try {