@livekit/agents 1.0.47 → 1.1.0-dev.0

package/dist/voice/agent_activity.cjs

@@ -19,7 +19,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var agent_activity_exports = {};
 __export(agent_activity_exports, {
   AgentActivity: () => AgentActivity,
-  agentActivityStorage: () => agentActivityStorage
+  agentActivityStorage: () => agentActivityStorage,
+  onEnterStorage: () => onEnterStorage
 });
 module.exports = __toCommonJS(agent_activity_exports);
 var import_mutex = require("@livekit/mutex");
@@ -27,6 +28,7 @@ var import_api = require("@opentelemetry/api");
 var import_heap_js = require("heap-js");
 var import_node_async_hooks = require("node:async_hooks");
 var import_web = require("node:stream/web");
+var import_interruption_detector = require("../inference/interruption/interruption_detector.cjs");
 var import_chat_context = require("../llm/chat_context.cjs");
 var import_llm = require("../llm/index.cjs");
 var import_tool_context = require("../llm/tool_context.cjs");
@@ -46,6 +48,7 @@ var import_generation = require("./generation.cjs");
 var import_speech_handle = require("./speech_handle.cjs");
 var import_utils2 = require("./utils.cjs");
 const agentActivityStorage = new import_node_async_hooks.AsyncLocalStorage();
+const onEnterStorage = new import_node_async_hooks.AsyncLocalStorage();
 class AgentActivity {
   agent;
   agentSession;
@@ -70,16 +73,34 @@ class AgentActivity {
   // default to null as None, which maps to the default provider tool choice value
   toolChoice = null;
   _preemptiveGeneration;
-  /** @internal */
-  _mainTask;
-  _onEnterTask;
-  _onExitTask;
-  _userTurnCompletedTask;
+  interruptionDetector;
+  isInterruptionDetectionEnabled;
+  isInterruptionByAudioActivityEnabled;
+  isDefaultInterruptionByAudioActivityEnabled;
   onRealtimeGenerationCreated = (ev) => this.onGenerationCreated(ev);
   onRealtimeInputSpeechStarted = (ev) => this.onInputSpeechStarted(ev);
   onRealtimeInputSpeechStopped = (ev) => this.onInputSpeechStopped(ev);
   onRealtimeInputAudioTranscriptionCompleted = (ev) => this.onInputAudioTranscriptionCompleted(ev);
   onModelError = (ev) => this.onError(ev);
+  onInterruptionOverlappingSpeech = (ev) => {
+    this.agentSession.emit(import_events.AgentSessionEventTypes.UserOverlappingSpeech, ev);
+  };
+  onInterruptionMetricsCollected = (ev) => {
+    this.agentSession.emit(
+      import_events.AgentSessionEventTypes.MetricsCollected,
+      (0, import_events.createMetricsCollectedEvent)({ metrics: ev })
+    );
+  };
+  onInterruptionError = (ev) => {
+    const errorEvent = (0, import_events.createErrorEvent)(ev, this.interruptionDetector);
+    this.agentSession.emit(import_events.AgentSessionEventTypes.Error, errorEvent);
+    this.agentSession._onError(ev);
+  };
+  /** @internal */
+  _mainTask;
+  _onEnterTask;
+  _onExitTask;
+  _userTurnCompletedTask;
   constructor(agent, agentSession) {
     this.agent = agent;
     this.agentSession = agentSession;
@@ -138,6 +159,10 @@ class AgentActivity {
         "VAD is not set. Enabling VAD is recommended when using LLM and non-streaming STT for more responsive interruption handling."
       );
     }
+    this.interruptionDetector = this.resolveInterruptionDetector();
+    this.isInterruptionDetectionEnabled = !!this.interruptionDetector;
+    this.isInterruptionByAudioActivityEnabled = this.turnDetectionMode !== "manual" && this.turnDetectionMode !== "realtime_llm";
+    this.isDefaultInterruptionByAudioActivityEnabled = this.isInterruptionByAudioActivityEnabled;
   }
   async start() {
     const unlock = await this.lock.lock();
@@ -230,8 +255,9 @@ class AgentActivity {
       vad: this.vad,
       turnDetector: typeof this.turnDetection === "string" ? void 0 : this.turnDetection,
       turnDetectionMode: this.turnDetectionMode,
-      minEndpointingDelay: this.agentSession.options.minEndpointingDelay,
-      maxEndpointingDelay: this.agentSession.options.maxEndpointingDelay,
+      interruptionDetection: this.interruptionDetector,
+      minEndpointingDelay: this.agentSession.options.turnHandling.endpointing.minDelay,
+      maxEndpointingDelay: this.agentSession.options.turnHandling.endpointing.maxDelay,
       rootSpanContext: this.agentSession.rootSpanContext,
       sttModel: (_a = this.stt) == null ? void 0 : _a.label,
       sttProvider: this.getSttProvider(),
@@ -245,11 +271,14 @@ class AgentActivity {
     this._resumeSchedulingTask();
     if (runOnEnter) {
       this._onEnterTask = this.createSpeechTask({
-        taskFn: () => import_telemetry.tracer.startActiveSpan(async () => this.agent.onEnter(), {
-          name: "on_enter",
-          context: import_api.trace.setSpan(import_api.ROOT_CONTEXT, startSpan),
-          attributes: { [import_telemetry.traceTypes.ATTR_AGENT_LABEL]: this.agent.id }
-        }),
+        taskFn: () => onEnterStorage.run(
+          { session: this.agentSession, agent: this.agent },
+          () => import_telemetry.tracer.startActiveSpan(async () => this.agent.onEnter(), {
+            name: "on_enter",
+            context: import_api.trace.setSpan(import_api.ROOT_CONTEXT, startSpan),
+            attributes: { [import_telemetry.traceTypes.ATTR_AGENT_LABEL]: this.agent.id }
+          })
+        ),
         inlineTask: true,
         name: "AgentActivity_onEnter"
       });
@@ -290,7 +319,8 @@ class AgentActivity {
     return this.realtimeSession;
   }
   get allowInterruptions() {
-    return this.agentSession.options.allowInterruptions;
+    var _a;
+    return ((_a = this.agentSession.options.turnHandling.interruption) == null ? void 0 : _a.mode) !== false;
   }
   get useTtsAlignedTranscript() {
     return this.agent.useTtsAlignedTranscript ?? this.agentSession.useTtsAlignedTranscript;
@@ -301,6 +331,11 @@ class AgentActivity {
   get toolCtx() {
     return this.agent.toolCtx;
   }
+  /** @internal */
+  get inputStartedAt() {
+    var _a;
+    return (_a = this.audioRecognition) == null ? void 0 : _a.inputStartedAt;
+  }
   async updateChatCtx(chatCtx) {
     chatCtx = chatCtx.copy({ toolCtx: this.toolCtx });
     this.agent._chatCtx = chatCtx;
@@ -315,19 +350,50 @@ class AgentActivity {
       });
     }
   }
-  updateOptions({ toolChoice }) {
+  // TODO: Add when AgentConfigUpdate is ported to ChatContext.
+  async updateTools(tools) {
+    this.agent._tools = { ...tools };
+    if (this.realtimeSession) {
+      await this.realtimeSession.updateTools(tools);
+    }
+    if (this.llm instanceof import_llm.LLM) {
+      await this.updateChatCtx(this.agent._chatCtx.copy({ toolCtx: tools }));
+    }
+  }
+  updateOptions({
+    toolChoice,
+    turnDetection
+  }) {
     if (toolChoice !== void 0) {
       this.toolChoice = toolChoice;
     }
     if (this.realtimeSession) {
       this.realtimeSession.updateOptions({ toolChoice: this.toolChoice });
     }
+    if (turnDetection !== void 0) {
+      this.turnDetectionMode = turnDetection;
+      this.isDefaultInterruptionByAudioActivityEnabled = this.turnDetectionMode !== "manual" && this.turnDetectionMode !== "realtime_llm";
+      if (this.agentSession.agentState !== "speaking") {
+        this.isInterruptionByAudioActivityEnabled = this.isDefaultInterruptionByAudioActivityEnabled;
+      }
+    }
+    if (this.audioRecognition) {
+      this.audioRecognition.updateOptions({ turnDetection: this.turnDetectionMode });
+    }
   }
   attachAudioInput(audioStream) {
     void this.audioStream.close();
     this.audioStream = new import_multi_input_stream.MultiInputStream();
+    const aecWarmupAudioFilter = new import_web.TransformStream({
+      transform: (frame, controller) => {
+        const shouldDiscardForAecWarmup = this.agentSession.agentState === "speaking" && this.agentSession._aecWarmupRemaining > 0;
+        if (!shouldDiscardForAecWarmup) {
+          controller.enqueue(frame);
+        }
+      }
+    });
     this.audioStreamId = this.audioStream.addInputStream(audioStream);
-    const [realtimeAudioStream, recognitionAudioStream] = this.audioStream.stream.tee();
+    const [realtimeAudioStream, recognitionAudioStream] = this.audioStream.stream.pipeThrough(aecWarmupAudioFilter).tee();
     if (this.realtimeSession) {
       this.realtimeSession.setInputAudioStream(realtimeAudioStream);
     }
@@ -433,6 +499,13 @@ class AgentActivity {
     this.logger.info("onInputSpeechStarted");
     if (!this.vad) {
       this.agentSession._updateUserState("speaking");
+      if (this.isInterruptionDetectionEnabled && this.audioRecognition) {
+        this.audioRecognition.onStartOfOverlapSpeech(
+          0,
+          Date.now(),
+          this.agentSession._userSpeakingSpan
+        );
+      }
     }
     try {
       this.interrupt();
@@ -446,6 +519,9 @@ class AgentActivity {
   onInputSpeechStopped(ev) {
     this.logger.info(ev, "onInputSpeechStopped");
     if (!this.vad) {
+      if (this.isInterruptionDetectionEnabled && this.audioRecognition) {
+        this.audioRecognition.onEndOfOverlapSpeech(Date.now(), this.agentSession._userSpeakingSpan);
+      }
       this.agentSession._updateUserState("listening");
     }
     if (ev.userTranscriptionEnabled) {
@@ -507,48 +583,75 @@ class AgentActivity {
   onStartOfSpeech(ev) {
     let speechStartTime = Date.now();
     if (ev) {
-      speechStartTime = speechStartTime - ev.speechDuration;
+      speechStartTime = speechStartTime - ev.speechDuration - ev.inferenceDuration;
     }
     this.agentSession._updateUserState("speaking", speechStartTime);
+    if (this.isInterruptionDetectionEnabled && this.audioRecognition) {
+      this.audioRecognition.onStartOfOverlapSpeech(
+        ev.speechDuration,
+        speechStartTime,
+        this.agentSession._userSpeakingSpan
+      );
+    }
   }
   onEndOfSpeech(ev) {
     let speechEndTime = Date.now();
     if (ev) {
-      speechEndTime = speechEndTime - ev.silenceDuration;
+      speechEndTime = speechEndTime - ev.silenceDuration - ev.inferenceDuration;
+    }
+    if (this.isInterruptionDetectionEnabled && this.audioRecognition) {
+      this.audioRecognition.onEndOfOverlapSpeech(
+        speechEndTime,
+        this.agentSession._userSpeakingSpan
+      );
     }
     this.agentSession._updateUserState("listening", speechEndTime);
   }
   onVADInferenceDone(ev) {
+    var _a;
     if (this.turnDetection === "manual" || this.turnDetection === "realtime_llm") {
       return;
     }
-    if (ev.speechDuration >= this.agentSession.options.minInterruptionDuration) {
+    if (ev.speechDuration >= ((_a = this.agentSession.options.turnHandling.interruption) == null ? void 0 : _a.minDuration)) {
       this.interruptByAudioActivity();
     }
   }
   interruptByAudioActivity() {
-    var _a, _b;
+    var _a, _b, _c, _d;
+    if (!this.isInterruptionByAudioActivityEnabled) {
+      return;
+    }
+    if (this.agentSession._aecWarmupRemaining > 0) {
+      return;
+    }
     if (this.llm instanceof import_llm.RealtimeModel && this.llm.capabilities.turnDetection) {
       return;
     }
-    if (this.stt && this.agentSession.options.minInterruptionWords > 0 && this.audioRecognition) {
+    if (this.stt && ((_a = this.agentSession.options.turnHandling.interruption) == null ? void 0 : _a.minWords) > 0 && this.audioRecognition) {
       const text = this.audioRecognition.currentTranscript;
       const normalizedText = text ?? "";
       const wordCount = (0, import_word.splitWords)(normalizedText, true).length;
-      if (wordCount < this.agentSession.options.minInterruptionWords) {
+      if (wordCount < ((_b = this.agentSession.options.turnHandling.interruption) == null ? void 0 : _b.minWords)) {
         return;
       }
     }
-    (_a = this.realtimeSession) == null ? void 0 : _a.startUserActivity();
+    (_c = this.realtimeSession) == null ? void 0 : _c.startUserActivity();
     if (this._currentSpeech && !this._currentSpeech.interrupted && this._currentSpeech.allowInterruptions) {
       this.logger.info(
         { "speech id": this._currentSpeech.id },
         "speech interrupted by audio activity"
       );
-      (_b = this.realtimeSession) == null ? void 0 : _b.interrupt();
+      (_d = this.realtimeSession) == null ? void 0 : _d.interrupt();
       this._currentSpeech.interrupt();
     }
   }
+  onInterruption(ev) {
+    this.restoreInterruptionByAudioActivity();
+    this.interruptByAudioActivity();
+    if (this.audioRecognition) {
+      this.audioRecognition.onEndOfAgentSpeech(ev.overlapStartedAt || ev.timestamp);
+    }
+  }
   onInterimTranscript(ev) {
     if (this.llm instanceof import_llm.RealtimeModel && this.llm.capabilities.userTranscription) {
       return;
@@ -597,7 +700,8 @@ class AgentActivity {
     );
     const userMessage = import_chat_context.ChatMessage.create({
       role: "user",
-      content: info.newTranscript
+      content: info.newTranscript,
+      transcriptConfidence: info.transcriptConfidence
     });
     const chatCtx = this.agent.chatCtx.copy();
     const speechHandle = this.generateReply({
@@ -655,6 +759,7 @@ class AgentActivity {
     return task;
   }
   async onEndOfTurn(info) {
+    var _a, _b;
     if (this.schedulingPaused) {
       this.cancelPreemptiveGeneration();
       this.logger.warn(
@@ -663,14 +768,14 @@ class AgentActivity {
       );
       return true;
     }
-    if (this.stt && this.turnDetection !== "manual" && this._currentSpeech && this._currentSpeech.allowInterruptions && !this._currentSpeech.interrupted && this.agentSession.options.minInterruptionWords > 0) {
+    if (this.stt && this.turnDetection !== "manual" && this._currentSpeech && this._currentSpeech.allowInterruptions && !this._currentSpeech.interrupted && ((_a = this.agentSession.options.turnHandling.interruption) == null ? void 0 : _a.minWords) > 0) {
       const wordCount = (0, import_word.splitWords)(info.newTranscript, true).length;
-      if (wordCount < this.agentSession.options.minInterruptionWords) {
+      if (wordCount < ((_b = this.agentSession.options.turnHandling.interruption) == null ? void 0 : _b.minWords)) {
         this.cancelPreemptiveGeneration();
         this.logger.info(
           {
             wordCount,
-            minInterruptionWords: this.agentSession.options.minInterruptionWords
+            minInterruptionWords: this.agentSession.options.turnHandling.interruption.minWords
           },
           "skipping user input, word count below minimum interruption threshold"
         );
@@ -806,11 +911,18 @@ class AgentActivity {
         instructions = `${this.agent.instructions}
 ${instructions}`;
       }
+      const onEnterData = onEnterStorage.getStore();
+      const shouldFilterTools = (onEnterData == null ? void 0 : onEnterData.agent) === this.agent && (onEnterData == null ? void 0 : onEnterData.session) === this.agentSession;
+      const tools = shouldFilterTools ? Object.fromEntries(
+        Object.entries(this.agent.toolCtx).filter(
+          ([, fnTool]) => !(fnTool.flags & import_llm.ToolFlag.IGNORE_ON_ENTER)
+        )
+      ) : this.agent.toolCtx;
       const task = this.createSpeechTask({
         taskFn: (abortController) => this.pipelineReplyTask(
           handle,
           chatCtx ?? this.agent.chatCtx,
-          this.agent.toolCtx,
+          tools,
           {
             toolChoice: toOaiToolChoice(toolChoice !== void 0 ? toolChoice : this.toolChoice)
           },
@@ -882,7 +994,8 @@ ${instructions}`;
     }
     let userMessage = import_chat_context.ChatMessage.create({
       role: "user",
-      content: info.newTranscript
+      content: info.newTranscript,
+      transcriptConfidence: info.transcriptConfidence
     });
     const chatCtx = this.agent.chatCtx.copy();
     const startTime = Date.now();
@@ -900,11 +1013,32 @@ ${instructions}`;
     } else if (this.llm === void 0) {
       return;
     }
+    const userMetricsReport = {};
+    if (info.startedSpeakingAt !== void 0) {
+      userMetricsReport.startedSpeakingAt = info.startedSpeakingAt / 1e3;
+    }
+    if (info.stoppedSpeakingAt !== void 0) {
+      userMetricsReport.stoppedSpeakingAt = info.stoppedSpeakingAt / 1e3;
+    }
+    if (info.transcriptionDelay !== void 0) {
+      userMetricsReport.transcriptionDelay = info.transcriptionDelay / 1e3;
+    }
+    if (info.endOfUtteranceDelay !== void 0) {
+      userMetricsReport.endOfTurnDelay = info.endOfUtteranceDelay / 1e3;
+    }
+    userMetricsReport.onUserTurnCompletedDelay = callbackDuration / 1e3;
+    if (userMessage) {
+      userMessage.metrics = userMetricsReport;
+    }
     let speechHandle;
     if (this._preemptiveGeneration !== void 0) {
       const preemptive = this._preemptiveGeneration;
       if (preemptive.info.newTranscript === (userMessage == null ? void 0 : userMessage.textContent) && preemptive.chatCtx.isEquivalent(chatCtx) && (0, import_tool_context.isSameToolContext)(preemptive.tools, this.tools) && (0, import_tool_context.isSameToolChoice)(preemptive.toolChoice, this.toolChoice)) {
         speechHandle = preemptive.speechHandle;
+        if (preemptive.userMessage && userMessage) {
+          preemptive.userMessage.metrics = userMetricsReport;
+          preemptive.userMessage.transcriptConfidence = userMessage.transcriptConfidence;
+        }
         this.scheduleSpeech(speechHandle, import_speech_handle.SpeechHandle.SPEECH_PRIORITY_NORMAL);
         this.logger.debug(
           {
@@ -938,6 +1072,7 @@ ${instructions}`;
     );
   }
   async ttsTask(speechHandle, text, addToChatCtx, modelSettings, replyAbortController, audio) {
+    var _a, _b;
     speechHandle._agentTurnContext = import_api.context.active();
     import_agent.speechHandleStorage.enterWith(speechHandle);
     const transcriptionOutput = this.agentSession.output.transcriptionEnabled ? this.agentSession.output.transcription : null;
@@ -970,11 +1105,18 @@ ${instructions}`;
       textOut = _textOut;
       tasks.push(textForwardTask);
     }
+    let replyStartedSpeakingAt;
+    let replyTtsGenData = null;
     const onFirstFrame = (startedSpeakingAt) => {
+      replyStartedSpeakingAt = startedSpeakingAt ?? Date.now();
       this.agentSession._updateAgentState("speaking", {
         startTime: startedSpeakingAt,
         otelContext: speechHandle._agentTurnContext
       });
+      if (this.isInterruptionDetectionEnabled && this.audioRecognition) {
+        this.audioRecognition.onStartOfAgentSpeech();
+        this.isInterruptionByAudioActivityEnabled = false;
+      }
     };
     if (!audioOutput) {
       if (textOut) {
@@ -987,9 +1129,12 @@ ${instructions}`;
           (...args) => this.agent.ttsNode(...args),
           audioSource,
           modelSettings,
-          replyAbortController
+          replyAbortController,
+          (_a = this.tts) == null ? void 0 : _a.model,
+          (_b = this.tts) == null ? void 0 : _b.provider
         );
         tasks.push(ttsTask);
+        replyTtsGenData = ttsGenData;
         const [forwardTask, _audioOut] = (0, import_generation.performAudioForwarding)(
           ttsGenData.audioStream,
           audioOutput,
@@ -1021,16 +1166,30 @@ ${instructions}`;
       }
     }
     if (addToChatCtx) {
+      const replyStoppedSpeakingAt = Date.now();
+      const replyAssistantMetrics = {};
+      if ((replyTtsGenData == null ? void 0 : replyTtsGenData.ttfb) !== void 0) {
+        replyAssistantMetrics.ttsNodeTtfb = replyTtsGenData.ttfb;
+      }
+      if (replyStartedSpeakingAt !== void 0) {
+        replyAssistantMetrics.startedSpeakingAt = replyStartedSpeakingAt / 1e3;
+        replyAssistantMetrics.stoppedSpeakingAt = replyStoppedSpeakingAt / 1e3;
+      }
       const message = import_chat_context.ChatMessage.create({
         role: "assistant",
         content: (textOut == null ? void 0 : textOut.text) || "",
-        interrupted: speechHandle.interrupted
+        interrupted: speechHandle.interrupted,
+        metrics: replyAssistantMetrics
       });
       this.agent._chatCtx.insert(message);
       this.agentSession._conversationItemAdded(message);
     }
     if (this.agentSession.agentState === "speaking") {
       this.agentSession._updateAgentState("listening");
+      if (this.isInterruptionDetectionEnabled && this.audioRecognition) {
+        this.audioRecognition.onEndOfAgentSpeech(Date.now());
+      }
+      this.restoreInterruptionByAudioActivity();
     }
   }
   _pipelineReplyTaskImpl = async ({
@@ -1042,9 +1201,10 @@ ${instructions}`;
     instructions,
     newMessage,
     toolsMessages,
-    span
+    span,
+    _previousUserMetrics
   }) => {
-    var _a, _b;
+    var _a, _b, _c, _d, _e, _f;
     speechHandle._agentTurnContext = import_api.context.active();
     span.setAttribute(import_telemetry.traceTypes.ATTR_SPEECH_ID, speechHandle.id);
     if (instructions) {
@@ -1082,7 +1242,9 @@ ${instructions}`;
       chatCtx,
       toolCtx,
       modelSettings,
-      replyAbortController
+      replyAbortController,
+      (_b = this.llm) == null ? void 0 : _b.model,
+      (_c = this.llm) == null ? void 0 : _c.provider
     );
     tasks.push(llmTask);
     let ttsTask = null;
@@ -1095,16 +1257,20 @@ ${instructions}`;
         (...args) => this.agent.ttsNode(...args),
         ttsTextInput,
         modelSettings,
-        replyAbortController
+        replyAbortController,
+        (_d = this.tts) == null ? void 0 : _d.model,
+        (_e = this.tts) == null ? void 0 : _e.provider
       );
       tasks.push(ttsTask);
     } else {
       llmOutput = llmGenData.textStream;
     }
     await speechHandle.waitIfNotInterrupted([speechHandle._waitForScheduled()]);
+    let userMetrics = _previousUserMetrics;
     if (newMessage && speechHandle.scheduled) {
       this.agent._chatCtx.insert(newMessage);
       this.agentSession._conversationItemAdded(newMessage);
+      userMetrics = newMessage.metrics;
     }
     if (speechHandle.interrupted) {
       replyAbortController.abort();
@@ -1116,7 +1282,7 @@ ${instructions}`;
     speechHandle._clearAuthorization();
     const replyStartedAt = Date.now();
     let transcriptionInput = llmOutput;
-    if (this.useTtsAlignedTranscript && ((_b = this.tts) == null ? void 0 : _b.capabilities.alignedTranscript) && ttsGenData) {
+    if (this.useTtsAlignedTranscript && ((_f = this.tts) == null ? void 0 : _f.capabilities.alignedTranscript) && ttsGenData) {
       const timedTextsStream = await Promise.race([
         ttsGenData.timedTextsFut.await,
         (ttsTask == null ? void 0 : ttsTask.result.catch(
@@ -1139,11 +1305,17 @@ ${instructions}`;
       tasks.push(textForwardTask);
       textOut = _textOut;
     }
+    let agentStartedSpeakingAt;
     const onFirstFrame = (startedSpeakingAt) => {
+      agentStartedSpeakingAt = startedSpeakingAt ?? Date.now();
       this.agentSession._updateAgentState("speaking", {
         startTime: startedSpeakingAt,
         otelContext: speechHandle._agentTurnContext
       });
+      if (this.isInterruptionDetectionEnabled && this.audioRecognition) {
+        this.audioRecognition.onStartOfAgentSpeech();
+        this.isInterruptionByAudioActivityEnabled = false;
+      }
     };
     let audioOut = null;
     if (audioOutput) {
@@ -1186,6 +1358,25 @@ ${instructions}`;
     if (audioOutput) {
       await speechHandle.waitIfNotInterrupted([audioOutput.waitForPlayout()]);
     }
+    const agentStoppedSpeakingAt = Date.now();
+    const assistantMetrics = {};
+    if (llmGenData.ttft !== void 0) {
+      assistantMetrics.llmNodeTtft = llmGenData.ttft;
+    }
+    if ((ttsGenData == null ? void 0 : ttsGenData.ttfb) !== void 0) {
+      assistantMetrics.ttsNodeTtfb = ttsGenData.ttfb;
+    }
+    if (agentStartedSpeakingAt !== void 0) {
+      assistantMetrics.startedSpeakingAt = agentStartedSpeakingAt / 1e3;
+      assistantMetrics.stoppedSpeakingAt = agentStoppedSpeakingAt / 1e3;
+      if ((userMetrics == null ? void 0 : userMetrics.stoppedSpeakingAt) !== void 0) {
+        const e2eLatency = agentStartedSpeakingAt / 1e3 - userMetrics.stoppedSpeakingAt;
+        assistantMetrics.e2eLatency = e2eLatency;
+        span.setAttribute(import_telemetry.traceTypes.ATTR_E2E_LATENCY, e2eLatency);
+      }
+    }
+    span.setAttribute(import_telemetry.traceTypes.ATTR_SPEECH_INTERRUPTED, speechHandle.interrupted);
+    let hasSpeechMessage = false;
     if (toolsMessages) {
       for (const msg of toolsMessages) {
         msg.createdAt = replyStartedAt;
@@ -1226,20 +1417,27 @@ ${instructions}`;
         }
       }
       if (forwardedText) {
+        hasSpeechMessage = true;
         const message = import_chat_context.ChatMessage.create({
           role: "assistant",
           content: forwardedText,
           id: llmGenData.id,
           interrupted: true,
-          createdAt: replyStartedAt
+          createdAt: replyStartedAt,
+          metrics: assistantMetrics
         });
         chatCtx.insert(message);
         this.agent._chatCtx.insert(message);
         speechHandle._itemAdded([message]);
         this.agentSession._conversationItemAdded(message);
+        span.setAttribute(import_telemetry.traceTypes.ATTR_RESPONSE_TEXT, forwardedText);
       }
       if (this.agentSession.agentState === "speaking") {
         this.agentSession._updateAgentState("listening");
+        if (this.isInterruptionDetectionEnabled && this.audioRecognition) {
+          this.audioRecognition.onEndOfAgentSpeech(Date.now());
+          this.restoreInterruptionByAudioActivity();
+        }
       }
       this.logger.info(
         { speech_id: speechHandle.id, message: forwardedText },
@@ -1250,17 +1448,20 @@ ${instructions}`;
       return;
     }
     if (textOut && textOut.text) {
+      hasSpeechMessage = true;
       const message = import_chat_context.ChatMessage.create({
         role: "assistant",
         id: llmGenData.id,
         interrupted: false,
         createdAt: replyStartedAt,
-        content: textOut.text
+        content: textOut.text,
+        metrics: assistantMetrics
       });
       chatCtx.insert(message);
       this.agent._chatCtx.insert(message);
       speechHandle._itemAdded([message]);
       this.agentSession._conversationItemAdded(message);
+      span.setAttribute(import_telemetry.traceTypes.ATTR_RESPONSE_TEXT, textOut.text);
       this.logger.info(
         { speech_id: speechHandle.id, message: textOut.text },
         "playout completed without interruption"
@@ -1270,6 +1471,12 @@ ${instructions}`;
       this.agentSession._updateAgentState("thinking");
     } else if (this.agentSession.agentState === "speaking") {
       this.agentSession._updateAgentState("listening");
+      if (this.isInterruptionDetectionEnabled && this.audioRecognition) {
+        {
+          this.audioRecognition.onEndOfAgentSpeech(Date.now());
+          this.restoreInterruptionByAudioActivity();
+        }
+      }
     }
     speechHandle._markGenerationDone();
     await executeToolsTask.result;
@@ -1309,7 +1516,8 @@ ${instructions}`;
           replyAbortController,
           instructions,
           void 0,
-          toolMessages
+          toolMessages,
+          hasSpeechMessage ? void 0 : userMetrics
         ),
         ownedSpeechHandle: speechHandle,
         name: "AgentActivity.pipelineReply"
@@ -1329,7 +1537,7 @@ ${instructions}`;
       }
     }
   };
-  pipelineReplyTask = async (speechHandle, chatCtx, toolCtx, modelSettings, replyAbortController, instructions, newMessage, toolsMessages) => import_telemetry.tracer.startActiveSpan(
+  pipelineReplyTask = async (speechHandle, chatCtx, toolCtx, modelSettings, replyAbortController, instructions, newMessage, toolsMessages, _previousUserMetrics) => import_telemetry.tracer.startActiveSpan(
     async (span) => this._pipelineReplyTaskImpl({
       speechHandle,
       chatCtx,
@@ -1339,7 +1547,8 @@ ${instructions}`;
       instructions,
       newMessage,
       toolsMessages,
-      span
+      span,
+      _previousUserMetrics
     }),
     {
       name: "agent_turn",
@@ -1405,6 +1614,7 @@ ${instructions}`;
       });
     };
     const readMessages = async (abortController, outputs) => {
+      var _a2, _b;
       replyAbortController.signal.addEventListener("abort", () => abortController.abort(), {
         once: true
       });
@@ -1451,7 +1661,9 @@ ${instructions}`;
                 (...args) => this.agent.ttsNode(...args),
                 ttsTextInput,
                 modelSettings,
-                abortController
+                abortController,
+                (_a2 = this.tts) == null ? void 0 : _a2.model,
+                (_b = this.tts) == null ? void 0 : _b.provider
               );
               tasks.push(ttsTask);
               realtimeAudioResult = ttsGenData.audioStream;
@@ -1843,11 +2055,46 @@ ${instructions}`;
       if (this._mainTask) {
         await this._mainTask.cancelAndWait();
       }
+      if (this.interruptionDetector) {
+        this.interruptionDetector.off(
+          "user_overlapping_speech",
+          this.onInterruptionOverlappingSpeech
+        );
+        this.interruptionDetector.off("metrics_collected", this.onInterruptionMetricsCollected);
+        this.interruptionDetector.off("error", this.onInterruptionError);
+      }
       this.agent._agentActivity = void 0;
     } finally {
       unlock();
     }
   }
+  resolveInterruptionDetector() {
+    const interruptionDetection = this.agent.interruptionDetection ?? this.agentSession.interruptionDetection;
+    if (!(this.stt && this.stt.capabilities.alignedTranscript && this.stt.capabilities.streaming && this.vad && this.turnDetection !== "manual" && this.turnDetection !== "realtime_llm" && !(this.llm instanceof import_llm.RealtimeModel))) {
+      if (interruptionDetection === "adaptive") {
+        this.logger.warn(
+          "interruptionDetection is provided, but it's not compatible with the current configuration and will be disabled"
+        );
+        return void 0;
+      }
+    }
+    if (interruptionDetection !== void 0 && interruptionDetection === false || interruptionDetection === "vad") {
+      return void 0;
+    }
+    try {
+      const detector = new import_interruption_detector.AdaptiveInterruptionDetector();
+      detector.on("user_overlapping_speech", this.onInterruptionOverlappingSpeech);
+      detector.on("metrics_collected", this.onInterruptionMetricsCollected);
+      detector.on("error", this.onInterruptionError);
+      return detector;
+    } catch (error) {
+      this.logger.warn({ error }, "could not instantiate AdaptiveInterruptionDetector");
+    }
+    return void 0;
+  }
+  restoreInterruptionByAudioActivity() {
+    this.isInterruptionByAudioActivityEnabled = this.isDefaultInterruptionByAudioActivityEnabled;
+  }
   async _closeSessionResources() {
     var _a, _b, _c;
     if (this.llm instanceof import_llm.LLM) {
@@ -1890,6 +2137,7 @@ function toOaiToolChoice(toolChoice) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AgentActivity,
-  agentActivityStorage
+  agentActivityStorage,
+  onEnterStorage
 });
 //# sourceMappingURL=agent_activity.cjs.map