ttp-agent-sdk 2.48.14 → 2.48.18

package/dist/agent-widget.dev.js

@@ -9170,7 +9170,7 @@ if (false) // removed by dead control flow
 /***/ ((module) => {
 
 "use strict";
-module.exports = "/**\n * AudioProcessor - AudioWorklet for real-time audio processing\n * \n * This AudioWorklet processes audio data in real-time and sends it to the main thread\n * for transmission to the WebSocket server.\n */\n\nclass AudioProcessor extends AudioWorkletProcessor {\n  constructor(options) {\n    super();\n    \n    // Configuration\n    this.config = options.processorOptions || {};\n    // Use AudioContext sampleRate (available as global 'sampleRate' in AudioWorkletProcessor)\n    // Fall back to config if sampleRate not available, default to 24 kHz to match typical server/TTS output\n    this.sampleRate = typeof sampleRate !== 'undefined' ? sampleRate : (this.config.sampleRate || this.config.outputSampleRate || 24000);\n    this.bufferSize = 128; // Process 128 samples at a time (256 bytes = 8ms at 16kHz)\n    this.buffer = new Float32Array(this.bufferSize);\n    this.bufferIndex = 0;\n    \n    // VAD (Voice Activity Detection) parameters\n    this.silenceThreshold = 0.02; // Base RMS threshold for voice detection (scaled by micSensitivity below)\n    this.VOICE_FRAMES_REQUIRED = 2; // Require 2 consecutive frames above threshold before activating\n    this.minVoiceDuration = 100; // ms - minimum speech duration\n    this.pauseThreshold = 3000; // ms - longer pause before processing\n\n    // Mic sensitivity: user/agent-adjustable multiplier on the VAD energy gate.\n    // 1.0 = default; 2.0 = twice as sensitive (half the RMS floor); 0.5 = half as\n    // sensitive (double the floor — only close/loud speech triggers, e.g. TV in the room).\n    this.micSensitivity = (typeof this.config.micSensitivity === 'number' && this.config.micSensitivity > 0)\n      ? this.config.micSensitivity : 1.0;\n    // While agent audio plays, the gate rises by this factor (stricter barge-in: background\n    // TV/chatter must not interrupt playback). The SDK main thread tracks playback state.\n    this.playbackActive = false;\n    this.PLAYBACK_GATE_FACTOR = 1.6;\n    // Hysteresis: once voice is active the floor drops, so a borderline signal isn't\n    // chopped on every frame (quiet speech tails stay under the trigger level).\n    this.HYSTERESIS_FACTOR = 0.75;\n    \n    // VAD state\n    this.isVoiceActive = false;\n    this.voiceStartTime = 0;\n    this.lastVoiceTime = 0;\n    this.consecutiveSilenceFrames = 0;\n    this.silenceFramesThreshold = 5; // More frames needed for silence detection\n    this.voiceFrameCount = 0; // Count consecutive frames above threshold\n    \n    // Audio quality tracking\n    this.frameCount = 0;\n    this.lastLogTime = 0;\n    \n    // Continuous recording mode\n    this.continuousMode = true; // Always send audio when voice is detected\n    this.forceContinuous = true; // Force continuous for toggle button behavior\n    this.isCurrentlyStreaming = false; // Track if we're currently sending audio\n    \n    // Batching buffer\n    this.sendBuffer = null;\n    this.sendBufferBytes = 0;\n\n    // Start true so the first process() call cannot terminate the worklet before\n    // the main thread posts setForceContinuous (WebKit/iOS often renders audio before port messages are handled).\n    this.isProcessing = true;\n    \n    // Handle messages from main thread\n    this.port.onmessage = (event) => {\n      const { type, data } = event.data;\n      \n      switch (type) {\n        case 'start':\n          this.isProcessing = true;\n          this.isCurrentlyStreaming = true;\n          break;\n          \n        case 'stop':\n          this.isProcessing = false;\n          this.isCurrentlyStreaming = false;\n          this.isVoiceActive = false;\n          this.forceContinuous = false;\n          this.voiceFrameCount = 0; // Reset voice frame count\n          // Flush any remaining data\n          this.flushBuffer();\n          break;\n          \n        case 'setForceContinuous':\n          this.forceContinuous = data.enabled;\n          this.isProcessing = true;\n          // iOS: bypass client VAD - always send. Desktop: keep VAD (saves bandwidth, reduces noise).\n          this.isCurrentlyStreaming = data.enabled && (data.bypassVad === true);\n          break;\n\n        case 'setMicSensitivity': {\n          const v = Number(data && data.value);\n          if (isFinite(v) && v > 0) {\n            this.micSensitivity = Math.max(0.25, Math.min(4.0, v));\n          }\n          break;\n        }\n\n        case 'setPlaybackActive':\n          this.playbackActive = !!(data && data.active);\n          break;\n          \n        case 'flush':\n          this.flushBuffer();\n          break;\n          \n        case 'config':\n          Object.assign(this.config, data);\n          break;\n      }\n    };\n  }\n  \n  /**\n   * Process audio data\n   */\n  process(inputs, outputs, parameters) {\n    // CRITICAL: If processing is stopped, terminate the processor\n    if (!this.isProcessing) {\n      // Return false to terminate the AudioWorklet processor\n      // This stops all VAD processing immediately\n      return false;\n    }\n    \n    const input = inputs[0];\n    const output = outputs[0];\n    \n    // Copy input to output (pass-through)\n    if (input.length > 0 && output.length > 0) {\n      output[0].set(input[0]);\n    }\n    \n    // Process audio for PCM recording and VAD\n    if (input.length > 0 && input[0].length > 0) {\n      this.processAudioData(input[0]);\n    }\n    \n    // Keep the processor alive\n    return true;\n  }\n  \n  processAudioData(audioData) {\n    // CRITICAL: Early return if processing is stopped\n    // This prevents VAD calculations and logging when stopped\n    if (!this.isProcessing) {\n      return;\n    }\n    \n    this.frameCount++;\n    \n    // Process audio in consistent 128-sample chunks (256 bytes)\n    for (let i = 0; i < audioData.length; i += this.bufferSize) {\n      const chunkSize = Math.min(this.bufferSize, audioData.length - i);\n      \n      // Copy chunk to buffer\n      for (let j = 0; j < chunkSize; j++) {\n        this.buffer[j] = audioData[i + j];\n      }\n      \n      // Pad with zeros if needed\n      for (let j = chunkSize; j < this.bufferSize; j++) {\n        this.buffer[j] = 0;\n      }\n      \n      // Calculate RMS for VAD on this chunk\n      let sum = 0;\n      for (let j = 0; j < this.bufferSize; j++) {\n        sum += this.buffer[j] * this.buffer[j];\n      }\n      const rms = Math.sqrt(sum / this.bufferSize);\n      \n      // Calculate additional features for better VAD\n      let variation = 0;\n      let highFreqCount = 0;\n      for (let j = 1; j < this.bufferSize; j++) {\n        const diff = Math.abs(this.buffer[j] - this.buffer[j-1]);\n        variation += diff;\n        if (diff > 0.1) highFreqCount++;\n      }\n      variation = variation / this.bufferSize;\n      const highFreqRatio = highFreqCount / this.bufferSize;\n      \n      const currentTime = Date.now();\n\n      // Effective VAD floor: base threshold scaled by the mic-sensitivity multiplier,\n      // raised during agent playback (stricter barge-in), lowered while voice is\n      // already active (hysteresis, so speech tails aren't clipped).\n      let effectiveThreshold = this.silenceThreshold / this.micSensitivity;\n      if (this.playbackActive) effectiveThreshold *= this.PLAYBACK_GATE_FACTOR;\n      if (this.isVoiceActive) effectiveThreshold *= this.HYSTERESIS_FACTOR;\n\n      // VAD with reduced sensitivity - require consecutive frames above threshold\n      let hasVoice = rms > effectiveThreshold;\n      // Calculate time since last voice detection\n      const timeSinceLastVoice = currentTime - this.lastVoiceTime;\n\n      // Voice detection logic - require consecutive frames above threshold\n      if (hasVoice) {\n        this.consecutiveSilenceFrames = 0;\n        this.voiceFrameCount++; // Increment consecutive voice frame count\n\n        // Only activate streaming after required consecutive frames\n        if (this.voiceFrameCount >= this.VOICE_FRAMES_REQUIRED) {\n          // Start voice if needed\n          if (!this.isVoiceActive) {\n            this.isVoiceActive = true;\n            this.voiceStartTime = currentTime;\n            this.isCurrentlyStreaming = true;\n            // Log voice detection (every 50 frames = ~400ms to avoid spam)\n            if (this.frameCount % 50 === 0) {\n              console.log(`🎤 VAD: VOICE DETECTED (RMS: ${rms.toFixed(4)}, frames: ${this.voiceFrameCount})`);\n            }\n          }\n        }\n\n        this.lastVoiceTime = currentTime;\n      } else {\n        // Silence detected - reset voice frame count\n        this.voiceFrameCount = 0;\n        this.consecutiveSilenceFrames++;\n        \n        // In continuous mode, we still use VAD but require longer silence before stopping\n        // In non-continuous mode, stop quickly\n        const silenceThreshold = this.forceContinuous ? 3000 : 200; // 3s for continuous, 200ms otherwise\n        \n        // FIXED: Stop condition - also check isCurrentlyStreaming (not just isVoiceActive)\n        // This handles case where setForceContinuous set streaming=true but no voice was detected yet\n        if (!hasVoice && (this.isVoiceActive || this.isCurrentlyStreaming) && timeSinceLastVoice >= silenceThreshold) {\n          this.isVoiceActive = false;\n          this.isCurrentlyStreaming = false;\n          this.voiceStartTime = 0;\n          this.lastVoiceTime = 0;\n          this.consecutiveSilenceFrames = 0;\n          this.voiceFrameCount = 0; // Reset voice frame count\n          // Log silence detection\n          console.log(`🔇 VAD: SILENCE DETECTED (${timeSinceLastVoice}ms silence, RMS: ${rms.toFixed(4)})`);\n        }\n      }\n\n      // Send PCM **only if streaming and processing** - hard gate\n      // This ensures we only send audio when voice is detected, even in continuous mode\n      if (this.isCurrentlyStreaming && this.isProcessing) {\n        // Log occasionally when sending (every 200 frames = ~1.6 seconds to avoid spam)\n        if (this.frameCount % 200 === 0) {\n          console.log(`📤 VAD: Sending audio (isVoiceActive: ${this.isVoiceActive}, RMS: ${rms.toFixed(4)})`);\n        }\n        this.sendPCMAudioData(this.buffer);\n      } else {\n        // Log occasionally when blocking (every 200 frames)\n        if (this.frameCount % 200 === 0 && this.isProcessing) {\n          console.log(`🚫 VAD: Blocking audio (isCurrentlyStreaming: ${this.isCurrentlyStreaming}, RMS: ${rms.toFixed(4)})`);\n        }\n      }\n    }\n  }\n  \n  sendPCMAudioData(float32Data) {\n    // Convert Float32Array (-1.0 to 1.0) to Int16Array (-32768 to 32767)\n    const pcmData = new Int16Array(float32Data.length);\n    \n    for (let i = 0; i < float32Data.length; i++) {\n      // Clamp and convert to 16-bit PCM\n      const sample = Math.max(-1.0, Math.min(1.0, float32Data[i]));\n      pcmData[i] = Math.round(sample * 32767);\n    }\n    \n    // Initialize send buffer if not exists\n    if (!this.sendBuffer) {\n      this.sendBuffer = [];\n      this.sendBufferBytes = 0;\n    }\n    \n    // Accumulate chunks in buffer\n    this.sendBuffer.push(pcmData);\n    this.sendBufferBytes += pcmData.byteLength;\n    \n    // Send in ~4 KB batches (≈128 ms of audio at 16kHz)\n    // Use sliding window approach to maintain continuous flow\n    while (this.sendBufferBytes >= 4096) {\n      // Calculate how many chunks we need for ~4KB\n      let chunksToSend = 0;\n      let bytesToSend = 0;\n      \n      for (let i = 0; i < this.sendBuffer.length; i++) {\n        const chunkBytes = this.sendBuffer[i].byteLength;\n        if (bytesToSend + chunkBytes <= 4096) {\n          chunksToSend++;\n          bytesToSend += chunkBytes;\n        } else {\n          break;\n        }\n      }\n\n      // Create merged buffer from selected chunks\n      const chunksForBatch = this.sendBuffer.slice(0, chunksToSend);\n      const totalSamples = chunksForBatch.reduce((a, b) => a + b.length, 0);\n      const merged = new Int16Array(totalSamples);\n      let offset = 0;\n      \n      for (const chunk of chunksForBatch) {\n        merged.set(chunk, offset);\n        offset += chunk.length;\n      }\n      \n      // Send batched PCM data to main thread\n      this.port.postMessage({\n        type: 'pcm_audio_data',\n        data: merged, // Send the Int16Array directly, not the buffer\n        sampleRate: this.sampleRate,\n        channelCount: 1,\n        frameCount: this.frameCount,\n        batchSize: chunksToSend,\n        totalBytes: merged.byteLength\n      });\n      \n      // Remove sent chunks from buffer (sliding window)\n      this.sendBuffer = this.sendBuffer.slice(chunksToSend);\n      this.sendBufferBytes -= bytesToSend;\n    }\n  }\n  \n  // Flush any remaining buffered data\n  flushBuffer() {\n    if (this.sendBuffer && this.sendBuffer.length > 0) {\n      // Merge remaining chunks\n      const totalSamples = this.sendBuffer.reduce((a, b) => a + b.length, 0);\n      const merged = new Int16Array(totalSamples);\n      let offset = 0;\n      \n      for (const chunk of this.sendBuffer) {\n        merged.set(chunk, offset);\n        offset += chunk.length;\n      }\n      \n      // Send remaining data\n      this.port.postMessage({\n        type: 'pcm_audio_data',\n        data: merged, // Send the Int16Array directly, not the buffer\n        sampleRate: this.sampleRate,\n        channelCount: 1,\n        frameCount: this.frameCount,\n        batchSize: this.sendBuffer.length,\n        totalBytes: merged.byteLength,\n        isFlush: true\n      });\n      \n      // Reset buffer\n      this.sendBuffer = [];\n      this.sendBufferBytes = 0;\n    }\n  }\n}\n\n// Register the processor\nregisterProcessor('audio-processor', AudioProcessor);\n";
+module.exports = "/**\n * AudioProcessor - AudioWorklet for real-time audio processing\n * \n * This AudioWorklet processes audio data in real-time and sends it to the main thread\n * for transmission to the WebSocket server.\n */\n\nclass AudioProcessor extends AudioWorkletProcessor {\n  constructor(options) {\n    super();\n    \n    // Configuration\n    this.config = options.processorOptions || {};\n    // Use AudioContext sampleRate (available as global 'sampleRate' in AudioWorkletProcessor)\n    // Fall back to config if sampleRate not available, default to 24 kHz to match typical server/TTS output\n    this.sampleRate = typeof sampleRate !== 'undefined' ? sampleRate : (this.config.sampleRate || this.config.outputSampleRate || 24000);\n    this.bufferSize = 128; // Process 128 samples at a time (256 bytes = 8ms at 16kHz)\n    this.buffer = new Float32Array(this.bufferSize);\n    this.bufferIndex = 0;\n    \n    // VAD (Voice Activity Detection) parameters\n    this.silenceThreshold = 0.02; // Base RMS threshold for voice detection (scaled by micSensitivity below)\n    this.VOICE_FRAMES_REQUIRED = 2; // Require 2 consecutive frames above threshold before activating\n    this.minVoiceDuration = 100; // ms - minimum speech duration\n    this.pauseThreshold = 3000; // ms - longer pause before processing\n\n    // Mic sensitivity: user/agent-adjustable multiplier on the VAD energy gate.\n    // 1.0 = default; 2.0 = twice as sensitive (half the RMS floor); 0.5 = half as\n    // sensitive (double the floor — only close/loud speech triggers, e.g. TV in the room).\n    this.micSensitivity = (typeof this.config.micSensitivity === 'number' && this.config.micSensitivity > 0)\n      ? this.config.micSensitivity : 1.0;\n    // While agent audio plays, the gate rises by this factor (stricter barge-in: background\n    // TV/chatter must not interrupt playback). The SDK main thread tracks playback state.\n    this.playbackActive = false;\n    this.PLAYBACK_GATE_FACTOR = 1.6;\n    // Hysteresis: once voice is active the floor drops, so a borderline signal isn't\n    // chopped on every frame (quiet speech tails stay under the trigger level).\n    this.HYSTERESIS_FACTOR = 0.75;\n    \n    // VAD state\n    this.isVoiceActive = false;\n    this.voiceStartTime = 0;\n    this.lastVoiceTime = 0;\n    this.consecutiveSilenceFrames = 0;\n    this.silenceFramesThreshold = 5; // More frames needed for silence detection\n    this.voiceFrameCount = 0; // Count consecutive frames above threshold\n    \n    // Audio quality tracking\n    this.frameCount = 0;\n    this.lastLogTime = 0;\n    \n    // Continuous recording mode\n    this.continuousMode = true; // Always send audio when voice is detected\n    this.forceContinuous = true; // Force continuous for toggle button behavior\n    this.isCurrentlyStreaming = false; // Track if we're currently sending audio\n    \n    // Batching buffer\n    this.sendBuffer = null;\n    this.sendBufferBytes = 0;\n\n    // Start true so the first process() call cannot terminate the worklet before\n    // the main thread posts setForceContinuous (WebKit/iOS often renders audio before port messages are handled).\n    this.isProcessing = true;\n    \n    // Handle messages from main thread\n    this.port.onmessage = (event) => {\n      const { type, data } = event.data;\n      \n      switch (type) {\n        case 'start':\n          this.isProcessing = true;\n          this.isCurrentlyStreaming = true;\n          break;\n          \n        case 'stop':\n          this.isProcessing = false;\n          this.isCurrentlyStreaming = false;\n          this.isVoiceActive = false;\n          this.forceContinuous = false;\n          this.voiceFrameCount = 0; // Reset voice frame count\n          // Flush any remaining data\n          this.flushBuffer();\n          break;\n          \n        case 'setForceContinuous':\n          this.forceContinuous = data.enabled;\n          this.isProcessing = true;\n          // iOS: bypass client VAD - always send. Desktop: keep VAD (saves bandwidth, reduces noise).\n          this.isCurrentlyStreaming = data.enabled && (data.bypassVad === true);\n          break;\n\n        case 'setMicSensitivity': {\n          const v = Number(data && data.value);\n          if (isFinite(v) && v > 0) {\n            this.micSensitivity = Math.max(0.25, Math.min(4.0, v));\n          }\n          break;\n        }\n\n        case 'setPlaybackActive':\n          this.playbackActive = !!(data && data.active);\n          break;\n          \n        case 'flush':\n          this.flushBuffer();\n          break;\n          \n        case 'config':\n          Object.assign(this.config, data);\n          break;\n      }\n    };\n  }\n  \n  /**\n   * Process audio data\n   */\n  process(inputs, outputs, parameters) {\n    // CRITICAL: If processing is stopped, terminate the processor\n    if (!this.isProcessing) {\n      // Return false to terminate the AudioWorklet processor\n      // This stops all VAD processing immediately\n      return false;\n    }\n    \n    const input = inputs[0];\n    const output = outputs[0];\n    \n    // Copy input to output (pass-through)\n    if (input.length > 0 && output.length > 0) {\n      output[0].set(input[0]);\n    }\n    \n    // Process audio for PCM recording and VAD\n    if (input.length > 0 && input[0].length > 0) {\n      this.processAudioData(input[0]);\n    }\n    \n    // Keep the processor alive\n    return true;\n  }\n  \n  processAudioData(audioData) {\n    // CRITICAL: Early return if processing is stopped\n    // This prevents VAD calculations and logging when stopped\n    if (!this.isProcessing) {\n      return;\n    }\n    \n    this.frameCount++;\n    \n    // Process audio in consistent 128-sample chunks (256 bytes)\n    for (let i = 0; i < audioData.length; i += this.bufferSize) {\n      const chunkSize = Math.min(this.bufferSize, audioData.length - i);\n      \n      // Copy chunk to buffer\n      for (let j = 0; j < chunkSize; j++) {\n        this.buffer[j] = audioData[i + j];\n      }\n      \n      // Pad with zeros if needed\n      for (let j = chunkSize; j < this.bufferSize; j++) {\n        this.buffer[j] = 0;\n      }\n      \n      // Calculate RMS for VAD on this chunk\n      let sum = 0;\n      for (let j = 0; j < this.bufferSize; j++) {\n        sum += this.buffer[j] * this.buffer[j];\n      }\n      const rms = Math.sqrt(sum / this.bufferSize);\n      \n      // Calculate additional features for better VAD\n      let variation = 0;\n      let highFreqCount = 0;\n      for (let j = 1; j < this.bufferSize; j++) {\n        const diff = Math.abs(this.buffer[j] - this.buffer[j-1]);\n        variation += diff;\n        if (diff > 0.1) highFreqCount++;\n      }\n      variation = variation / this.bufferSize;\n      const highFreqRatio = highFreqCount / this.bufferSize;\n      \n      const currentTime = Date.now();\n\n      // Effective VAD floor: base threshold scaled by the mic-sensitivity multiplier —\n      // QUADRATIC below 1.0 so the strict end actually bites (0.5 → 0.08 floor, not\n      // 0.04: a linear ±6dB band is imperceptible, and browser AGC flattens level\n      // differences before we see them). Raised during agent playback (stricter\n      // barge-in), lowered while voice is already active (hysteresis, so speech\n      // tails aren't clipped).\n      const sens = this.micSensitivity;\n      let effectiveThreshold = sens >= 1\n        ? this.silenceThreshold / sens\n        : this.silenceThreshold / (sens * sens);\n      if (this.playbackActive) effectiveThreshold *= this.PLAYBACK_GATE_FACTOR;\n      if (this.isVoiceActive) effectiveThreshold *= this.HYSTERESIS_FACTOR;\n\n      // VAD with reduced sensitivity - require consecutive frames above threshold\n      let hasVoice = rms > effectiveThreshold;\n      // Calculate time since last voice detection\n      const timeSinceLastVoice = currentTime - this.lastVoiceTime;\n\n      // Voice detection logic - require consecutive frames above threshold\n      if (hasVoice) {\n        this.consecutiveSilenceFrames = 0;\n        this.voiceFrameCount++; // Increment consecutive voice frame count\n\n        // Only activate streaming after required consecutive frames\n        if (this.voiceFrameCount >= this.VOICE_FRAMES_REQUIRED) {\n          // Start voice if needed\n          if (!this.isVoiceActive) {\n            this.isVoiceActive = true;\n            this.voiceStartTime = currentTime;\n            this.isCurrentlyStreaming = true;\n            // Log voice detection (every 50 frames = ~400ms to avoid spam)\n            if (this.frameCount % 50 === 0) {\n              console.log(`🎤 VAD: VOICE DETECTED (RMS: ${rms.toFixed(4)}, frames: ${this.voiceFrameCount})`);\n            }\n          }\n        }\n\n        this.lastVoiceTime = currentTime;\n      } else {\n        // Silence detected - reset voice frame count\n        this.voiceFrameCount = 0;\n        this.consecutiveSilenceFrames++;\n        \n        // In continuous mode, we still use VAD but require longer silence before stopping\n        // In non-continuous mode, stop quickly\n        const silenceThreshold = this.forceContinuous ? 3000 : 200; // 3s for continuous, 200ms otherwise\n        \n        // FIXED: Stop condition - also check isCurrentlyStreaming (not just isVoiceActive)\n        // This handles case where setForceContinuous set streaming=true but no voice was detected yet\n        if (!hasVoice && (this.isVoiceActive || this.isCurrentlyStreaming) && timeSinceLastVoice >= silenceThreshold) {\n          this.isVoiceActive = false;\n          this.isCurrentlyStreaming = false;\n          this.voiceStartTime = 0;\n          this.lastVoiceTime = 0;\n          this.consecutiveSilenceFrames = 0;\n          this.voiceFrameCount = 0; // Reset voice frame count\n          // Log silence detection\n          console.log(`🔇 VAD: SILENCE DETECTED (${timeSinceLastVoice}ms silence, RMS: ${rms.toFixed(4)})`);\n        }\n      }\n\n      // Send PCM **only if streaming and processing** - hard gate\n      // This ensures we only send audio when voice is detected, even in continuous mode\n      if (this.isCurrentlyStreaming && this.isProcessing) {\n        // Log occasionally when sending (every 200 frames = ~1.6 seconds to avoid spam)\n        if (this.frameCount % 200 === 0) {\n          console.log(`📤 VAD: Sending audio (isVoiceActive: ${this.isVoiceActive}, RMS: ${rms.toFixed(4)})`);\n        }\n        this.sendPCMAudioData(this.buffer);\n      } else {\n        // Log occasionally when blocking (every 200 frames)\n        if (this.frameCount % 200 === 0 && this.isProcessing) {\n          console.log(`🚫 VAD: Blocking audio (isCurrentlyStreaming: ${this.isCurrentlyStreaming}, RMS: ${rms.toFixed(4)})`);\n        }\n      }\n    }\n  }\n  \n  sendPCMAudioData(float32Data) {\n    // Convert Float32Array (-1.0 to 1.0) to Int16Array (-32768 to 32767)\n    const pcmData = new Int16Array(float32Data.length);\n    \n    for (let i = 0; i < float32Data.length; i++) {\n      // Clamp and convert to 16-bit PCM\n      const sample = Math.max(-1.0, Math.min(1.0, float32Data[i]));\n      pcmData[i] = Math.round(sample * 32767);\n    }\n    \n    // Initialize send buffer if not exists\n    if (!this.sendBuffer) {\n      this.sendBuffer = [];\n      this.sendBufferBytes = 0;\n    }\n    \n    // Accumulate chunks in buffer\n    this.sendBuffer.push(pcmData);\n    this.sendBufferBytes += pcmData.byteLength;\n    \n    // Send in ~4 KB batches (≈128 ms of audio at 16kHz)\n    // Use sliding window approach to maintain continuous flow\n    while (this.sendBufferBytes >= 4096) {\n      // Calculate how many chunks we need for ~4KB\n      let chunksToSend = 0;\n      let bytesToSend = 0;\n      \n      for (let i = 0; i < this.sendBuffer.length; i++) {\n        const chunkBytes = this.sendBuffer[i].byteLength;\n        if (bytesToSend + chunkBytes <= 4096) {\n          chunksToSend++;\n          bytesToSend += chunkBytes;\n        } else {\n          break;\n        }\n      }\n\n      // Create merged buffer from selected chunks\n      const chunksForBatch = this.sendBuffer.slice(0, chunksToSend);\n      const totalSamples = chunksForBatch.reduce((a, b) => a + b.length, 0);\n      const merged = new Int16Array(totalSamples);\n      let offset = 0;\n      \n      for (const chunk of chunksForBatch) {\n        merged.set(chunk, offset);\n        offset += chunk.length;\n      }\n      \n      // Send batched PCM data to main thread\n      this.port.postMessage({\n        type: 'pcm_audio_data',\n        data: merged, // Send the Int16Array directly, not the buffer\n        sampleRate: this.sampleRate,\n        channelCount: 1,\n        frameCount: this.frameCount,\n        batchSize: chunksToSend,\n        totalBytes: merged.byteLength\n      });\n      \n      // Remove sent chunks from buffer (sliding window)\n      this.sendBuffer = this.sendBuffer.slice(chunksToSend);\n      this.sendBufferBytes -= bytesToSend;\n    }\n  }\n  \n  // Flush any remaining buffered data\n  flushBuffer() {\n    if (this.sendBuffer && this.sendBuffer.length > 0) {\n      // Merge remaining chunks\n      const totalSamples = this.sendBuffer.reduce((a, b) => a + b.length, 0);\n      const merged = new Int16Array(totalSamples);\n      let offset = 0;\n      \n      for (const chunk of this.sendBuffer) {\n        merged.set(chunk, offset);\n        offset += chunk.length;\n      }\n      \n      // Send remaining data\n      this.port.postMessage({\n        type: 'pcm_audio_data',\n        data: merged, // Send the Int16Array directly, not the buffer\n        sampleRate: this.sampleRate,\n        channelCount: 1,\n        frameCount: this.frameCount,\n        batchSize: this.sendBuffer.length,\n        totalBytes: merged.byteLength,\n        isFlush: true\n      });\n      \n      // Reset buffer\n      this.sendBuffer = [];\n      this.sendBufferBytes = 0;\n    }\n  }\n}\n\n// Register the processor\nregisterProcessor('audio-processor', AudioProcessor);\n";
 
 /***/ }),
 
@@ -10073,6 +10073,15 @@ var AudioRecorder = /*#__PURE__*/function (_EventEmitter) {
             case 8:
               this.mediaStream = _context4.v;
             case 9:
+              // Fresh track: it always starts with the getUserMedia defaults (AGC on), so a
+              // persisted low sensitivity must re-apply its AGC-off constraint on it.
+              if (typeof this.config.micSensitivity === 'number' && this.config.micSensitivity < 0.999) {
+                this._agcApplied = undefined;
+                this._applyAgcForSensitivity(this.config.micSensitivity);
+              }
+
+              // CRITICAL: Check connection status AFTER getting permission but BEFORE creating AudioWorkletNode
+              // Server might have rejected during the async permission request
               if (!(this.config.checkConnection && typeof this.config.checkConnection === 'function')) {
                 _context4.n = 10;
                 break;
@@ -10354,6 +10363,39 @@ var AudioRecorder = /*#__PURE__*/function (_EventEmitter) {
           }
         });
       }
+      this._applyAgcForSensitivity(clamped);
+    }
+
+    /**
+     * AGC fights the sensitivity gate: it re-amplifies quiet background noise (a TV
+     * across the room) toward speech level before the worklet's VAD ever measures it,
+     * so a lower floor alone changes nothing. Below sensitivity 1.0 we disable auto
+     * gain control on the live track (Chrome supports applyConstraints without a
+     * stream restart); at/above 1.0 the platform default (AGC on) is restored.
+     */
+  }, {
+    key: "_applyAgcForSensitivity",
+    value: function _applyAgcForSensitivity(sensitivity) {
+      var _this$mediaStream,
+        _this$mediaStream$get,
+        _track$getCapabilitie,
+        _this3 = this;
+      var wantAgc = !(typeof sensitivity === 'number' && sensitivity < 0.999);
+      if (this._agcApplied === wantAgc) return;
+      var track = (_this$mediaStream = this.mediaStream) === null || _this$mediaStream === void 0 || (_this$mediaStream$get = _this$mediaStream.getAudioTracks) === null || _this$mediaStream$get === void 0 ? void 0 : _this$mediaStream$get.call(_this$mediaStream)[0];
+      if (!track || track.readyState !== 'live' || typeof track.applyConstraints !== 'function') return;
+      var caps = (_track$getCapabilitie = track.getCapabilities) === null || _track$getCapabilitie === void 0 ? void 0 : _track$getCapabilitie.call(track);
+      if (caps !== null && caps !== void 0 && caps.autoGainControl && !caps.autoGainControl.includes(wantAgc)) return;
+      // Mark before the async call so rapid slider moves don't stack constraint calls.
+      this._agcApplied = wantAgc;
+      track.applyConstraints({
+        autoGainControl: wantAgc
+      }).then(function () {
+        return console.log("\uD83C\uDF99\uFE0F AudioRecorder: autoGainControl ".concat(wantAgc ? 'ON (default)' : 'OFF (low mic sensitivity)'));
+      }).catch(function (e) {
+        _this3._agcApplied = undefined;
+        console.warn('⚠️ AudioRecorder: applyConstraints(autoGainControl) failed:', e);
+      });
     }
 
     /**
@@ -12087,7 +12129,7 @@ var TextChatSDK = /*#__PURE__*/function (_EventEmitter) {
 
       // SDK build time for debugging
       if (true) {
-        helloMessage.lastBuildTime = "2026-08-21T10:23:43.383Z";
+        helloMessage.lastBuildTime = "2026-08-27T12:25:20.756Z";
       }
       try {
         this.ws.send(JSON.stringify(helloMessage));
@@ -21397,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.14";
-var BUILD_TIME = "2026-08-21T10:23:43.383Z";
+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
@@ -25573,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; }
@@ -25604,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.
@@ -25703,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
@@ -27122,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;
       }
@@ -27247,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 {
@@ -27264,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');
         });
       }
     }
@@ -27302,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();
@@ -27329,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:
@@ -27340,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);
           }
@@ -27355,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) {
@@ -27376,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) {
@@ -27413,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')) {
@@ -27617,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;
       }
@@ -27630,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);
           }
         }
@@ -27680,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) {
@@ -27740,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);
                 }
@@ -27778,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;
@@ -28001,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;
 
@@ -28060,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
     }
 
@@ -28097,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;) {
@@ -28118,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
@@ -28136,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;) {
@@ -28150,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
@@ -28162,7 +28260,7 @@ var AudioPlayer = /*#__PURE__*/function (_EventEmitter) {
           } finally {
             _iterator3.f();
           }
-          _this11.isCheckingTranscripts = false;
+          _this12.isCheckingTranscripts = false;
           console.log('📝 AudioPlayer: Transcript checker stopped');
         }
       };
@@ -28326,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; } }
@@ -28363,6 +28462,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 
 
 
+
 /**
 
  * VoiceSDK v2 - Multi-codec speech-to-speech SDK
@@ -28460,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;
@@ -28623,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);
@@ -28949,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;
 
@@ -29375,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.14" : 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,
@@ -29390,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.14" : 0
+          sdkVersion:  true ? "2.48.18" : 0
         };
       }
     }
@@ -29404,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,
@@ -29417,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
@@ -29532,7 +29641,7 @@ var VoiceSDK_v2 = /*#__PURE__*/function (_EventEmitter) {
 
               // Include SDK build time for debugging
               if (true) {
-                helloMessage.lastBuildTime = "2026-08-21T10:23:43.383Z";
+                helloMessage.lastBuildTime = "2026-08-27T12:25:20.756Z";
               }
 
               // Client environment (device/browser/webview) for backend logs + Langfuse metadata
@@ -29776,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',
@@ -29797,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: {
@@ -32157,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 ***!
@@ -35761,7 +35963,7 @@ var TTPChatWidget = /*#__PURE__*/function () {
         return;
       }
       this._ensureAboutStyles();
-      var version =  true ? "2.48.14" : 0;
+      var version =  true ? "2.48.18" : 0;
       var convId = this._getLastConversationId();
       var t = function t(k, fb) {
         try {