@livekit/agents 1.0.48 → 1.1.0-dev.0

package/dist/inference/interruption/interruption_detector.cjs

@@ -0,0 +1,181 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var interruption_detector_exports = {};
+__export(interruption_detector_exports, {
+  AdaptiveInterruptionDetector: () => AdaptiveInterruptionDetector
+});
+module.exports = __toCommonJS(interruption_detector_exports);
+var import_events = __toESM(require("events"), 1);
+var import_log = require("../../log.cjs");
+var import_utils = require("../utils.cjs");
+var import_defaults = require("./defaults.cjs");
+var import_interruption_stream = require("./interruption_stream.cjs");
+class AdaptiveInterruptionDetector extends import_events.default {
+  options;
+  _label;
+  logger = (0, import_log.log)();
+  // Use Set instead of WeakSet to allow iteration for propagating option updates
+  streams = /* @__PURE__ */ new Set();
+  constructor(options = {}) {
+    super();
+    const {
+      maxAudioDurationInS,
+      baseUrl,
+      apiKey,
+      apiSecret,
+      audioPrefixDurationInS,
+      threshold,
+      detectionIntervalInS,
+      inferenceTimeout,
+      minInterruptionDurationInS
+    } = { ...import_defaults.interruptionOptionDefaults, ...options };
+    if (maxAudioDurationInS > 3) {
+      throw new RangeError("maxAudioDurationInS must be less than or equal to 3.0 seconds");
+    }
+    const lkBaseUrl = baseUrl ?? process.env.LIVEKIT_REMOTE_EOT_URL ?? (0, import_utils.getDefaultInferenceUrl)();
+    let lkApiKey = apiKey ?? "";
+    let lkApiSecret = apiSecret ?? "";
+    let useProxy;
+    const isInferenceUrl = lkBaseUrl === import_utils.DEFAULT_INFERENCE_URL || lkBaseUrl === import_utils.STAGING_INFERENCE_URL;
+    if (isInferenceUrl) {
+      lkApiKey = apiKey ?? process.env.LIVEKIT_INFERENCE_API_KEY ?? process.env.LIVEKIT_API_KEY ?? "";
+      if (!lkApiKey) {
+        throw new TypeError(
+          "apiKey is required, either as argument or set LIVEKIT_API_KEY environmental variable"
+        );
+      }
+      lkApiSecret = apiSecret ?? process.env.LIVEKIT_INFERENCE_API_SECRET ?? process.env.LIVEKIT_API_SECRET ?? "";
+      if (!lkApiSecret) {
+        throw new TypeError(
+          "apiSecret is required, either as argument or set LIVEKIT_API_SECRET environmental variable"
+        );
+      }
+      useProxy = true;
+    } else {
+      useProxy = false;
+    }
+    this.options = {
+      sampleRate: import_defaults.SAMPLE_RATE,
+      threshold,
+      minFrames: Math.ceil(minInterruptionDurationInS * import_defaults.FRAMES_PER_SECOND),
+      maxAudioDurationInS,
+      audioPrefixDurationInS,
+      detectionIntervalInS,
+      inferenceTimeout,
+      baseUrl: lkBaseUrl,
+      apiKey: lkApiKey,
+      apiSecret: lkApiSecret,
+      useProxy,
+      minInterruptionDurationInS
+    };
+    this._label = `${this.constructor.name}`;
+    this.logger.debug(
+      {
+        baseUrl: this.options.baseUrl,
+        detectionIntervalInS: this.options.detectionIntervalInS,
+        audioPrefixDurationInS: this.options.audioPrefixDurationInS,
+        maxAudioDurationInS: this.options.maxAudioDurationInS,
+        minFrames: this.options.minFrames,
+        threshold: this.options.threshold,
+        inferenceTimeout: this.options.inferenceTimeout,
+        useProxy: this.options.useProxy
+      },
+      "adaptive interruption detector initialized"
+    );
+  }
+  /**
+   * The model identifier for this detector.
+   */
+  get model() {
+    return "adaptive interruption";
+  }
+  /**
+   * The provider identifier for this detector.
+   */
+  get provider() {
+    return "livekit";
+  }
+  /**
+   * The label for this detector instance.
+   */
+  get label() {
+    return this._label;
+  }
+  /**
+   * The sample rate used for audio processing.
+   */
+  get sampleRate() {
+    return this.options.sampleRate;
+  }
+  /**
+   * Emit an error event from the detector.
+   */
+  emitError(error) {
+    this.emit("error", error);
+  }
+  /**
+   * Creates a new InterruptionStreamBase for internal use.
+   * The stream can receive audio frames and sentinels via pushFrame().
+   * Use this when you need direct access to the stream for pushing frames.
+   */
+  createStream() {
+    const streamBase = new import_interruption_stream.InterruptionStreamBase(this, {});
+    this.streams.add(streamBase);
+    return streamBase;
+  }
+  /**
+   * Remove a stream from tracking (called when stream is closed).
+   */
+  removeStream(stream) {
+    this.streams.delete(stream);
+  }
+  /**
+   * Update options for the detector and propagate to all active streams.
+   * For WebSocket streams, this triggers a reconnection with new settings.
+   */
+  async updateOptions(options) {
+    if (options.threshold !== void 0) {
+      this.options.threshold = options.threshold;
+    }
+    if (options.minInterruptionDurationInS !== void 0) {
+      this.options.minInterruptionDurationInS = options.minInterruptionDurationInS;
+      this.options.minFrames = Math.ceil(options.minInterruptionDurationInS * import_defaults.FRAMES_PER_SECOND);
+    }
+    const updatePromises = [];
+    for (const stream of this.streams) {
+      updatePromises.push(stream.updateOptions(options));
+    }
+    await Promise.all(updatePromises);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AdaptiveInterruptionDetector
+});
+//# sourceMappingURL=interruption_detector.cjs.map

package/dist/inference/interruption/interruption_detector.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/inference/interruption/interruption_detector.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type { TypedEventEmitter } from '@livekit/typed-emitter';\nimport EventEmitter from 'events';\nimport { log } from '../../log.js';\nimport type { InterruptionMetrics } from '../../metrics/base.js';\nimport { DEFAULT_INFERENCE_URL, STAGING_INFERENCE_URL, getDefaultInferenceUrl } from '../utils.js';\nimport { FRAMES_PER_SECOND, SAMPLE_RATE, interruptionOptionDefaults } from './defaults.js';\nimport type { InterruptionDetectionError } from './errors.js';\nimport { InterruptionStreamBase } from './interruption_stream.js';\nimport type { InterruptionOptions, OverlappingSpeechEvent } from './types.js';\n\ntype InterruptionCallbacks = {\n  user_overlapping_speech: (event: OverlappingSpeechEvent) => void;\n  metrics_collected: (metrics: InterruptionMetrics) => void;\n  error: (error: InterruptionDetectionError) => void;\n};\n\nexport type AdaptiveInterruptionDetectorOptions = Omit<Partial<InterruptionOptions>, 'useProxy'>;\n\nexport class AdaptiveInterruptionDetector extends (EventEmitter as new () => TypedEventEmitter<InterruptionCallbacks>) {\n  options: InterruptionOptions;\n  private readonly _label: string;\n  private logger = log();\n  // Use Set instead of WeakSet to allow iteration for propagating option updates\n  private streams: Set<InterruptionStreamBase> = new Set();\n\n  constructor(options: AdaptiveInterruptionDetectorOptions = {}) {\n    super();\n\n    const {\n      maxAudioDurationInS,\n      baseUrl,\n      apiKey,\n      apiSecret,\n      audioPrefixDurationInS,\n      threshold,\n      detectionIntervalInS,\n      inferenceTimeout,\n      minInterruptionDurationInS,\n    } = { ...interruptionOptionDefaults, ...options };\n\n    if (maxAudioDurationInS > 3.0) {\n      throw new RangeError('maxAudioDurationInS must be less than or equal to 3.0 seconds');\n    }\n\n    const lkBaseUrl = baseUrl ?? process.env.LIVEKIT_REMOTE_EOT_URL ?? getDefaultInferenceUrl();\n    let lkApiKey = apiKey ?? '';\n    let lkApiSecret = apiSecret ?? '';\n    let useProxy: boolean;\n\n    // Use LiveKit credentials if using the inference service (production or staging)\n    const isInferenceUrl =\n      lkBaseUrl === DEFAULT_INFERENCE_URL || lkBaseUrl === STAGING_INFERENCE_URL;\n    if (isInferenceUrl) {\n      lkApiKey =\n        apiKey ?? process.env.LIVEKIT_INFERENCE_API_KEY ?? process.env.LIVEKIT_API_KEY ?? '';\n      if (!lkApiKey) {\n        throw new TypeError(\n          'apiKey is required, either as argument or set LIVEKIT_API_KEY environmental variable',\n        );\n      }\n\n      lkApiSecret =\n        apiSecret ??\n        process.env.LIVEKIT_INFERENCE_API_SECRET ??\n        process.env.LIVEKIT_API_SECRET ??\n        '';\n      if (!lkApiSecret) {\n        throw new TypeError(\n          'apiSecret is required, either as argument or set LIVEKIT_API_SECRET environmental variable',\n        );\n      }\n      useProxy = true;\n    } else {\n      useProxy = false;\n    }\n\n    this.options = {\n      sampleRate: SAMPLE_RATE,\n      threshold,\n      minFrames: Math.ceil(minInterruptionDurationInS * FRAMES_PER_SECOND),\n      maxAudioDurationInS,\n      audioPrefixDurationInS,\n      detectionIntervalInS,\n      inferenceTimeout,\n      baseUrl: lkBaseUrl,\n      apiKey: lkApiKey,\n      apiSecret: lkApiSecret,\n      useProxy,\n      minInterruptionDurationInS,\n    };\n\n    this._label = `${this.constructor.name}`;\n\n    this.logger.debug(\n      {\n        baseUrl: this.options.baseUrl,\n        detectionIntervalInS: this.options.detectionIntervalInS,\n        audioPrefixDurationInS: this.options.audioPrefixDurationInS,\n        maxAudioDurationInS: this.options.maxAudioDurationInS,\n        minFrames: this.options.minFrames,\n        threshold: this.options.threshold,\n        inferenceTimeout: this.options.inferenceTimeout,\n        useProxy: this.options.useProxy,\n      },\n      'adaptive interruption detector initialized',\n    );\n  }\n\n  /**\n   * The model identifier for this detector.\n   */\n  get model(): string {\n    return 'adaptive interruption';\n  }\n\n  /**\n   * The provider identifier for this detector.\n   */\n  get provider(): string {\n    return 'livekit';\n  }\n\n  /**\n   * The label for this detector instance.\n   */\n  get label(): string {\n    return this._label;\n  }\n\n  /**\n   * The sample rate used for audio processing.\n   */\n  get sampleRate(): number {\n    return this.options.sampleRate;\n  }\n\n  /**\n   * Emit an error event from the detector.\n   */\n  emitError(error: InterruptionDetectionError): void {\n    this.emit('error', error);\n  }\n\n  /**\n   * Creates a new InterruptionStreamBase for internal use.\n   * The stream can receive audio frames and sentinels via pushFrame().\n   * Use this when you need direct access to the stream for pushing frames.\n   */\n  createStream(): InterruptionStreamBase {\n    const streamBase = new InterruptionStreamBase(this, {});\n    this.streams.add(streamBase);\n    return streamBase;\n  }\n\n  /**\n   * Remove a stream from tracking (called when stream is closed).\n   */\n  removeStream(stream: InterruptionStreamBase): void {\n    this.streams.delete(stream);\n  }\n\n  /**\n   * Update options for the detector and propagate to all active streams.\n   * For WebSocket streams, this triggers a reconnection with new settings.\n   */\n  async updateOptions(options: {\n    threshold?: number;\n    minInterruptionDurationInS?: number;\n  }): Promise<void> {\n    if (options.threshold !== undefined) {\n      this.options.threshold = options.threshold;\n    }\n    if (options.minInterruptionDurationInS !== undefined) {\n      this.options.minInterruptionDurationInS = options.minInterruptionDurationInS;\n      this.options.minFrames = Math.ceil(options.minInterruptionDurationInS * FRAMES_PER_SECOND);\n    }\n\n    // Propagate option updates to all active streams (matching Python behavior)\n    const updatePromises: Promise<void>[] = [];\n    for (const stream of this.streams) {\n      updatePromises.push(stream.updateOptions(options));\n    }\n    await Promise.all(updatePromises);\n  }\n}\n"],"mappings":"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","names":["EventEmitter"]}

package/dist/inference/interruption/interruption_detector.d.cts

@@ -0,0 +1,59 @@
+import type { TypedEventEmitter } from '@livekit/typed-emitter';
+import type { InterruptionMetrics } from '../../metrics/base.js';
+import type { InterruptionDetectionError } from './errors.js';
+import { InterruptionStreamBase } from './interruption_stream.js';
+import type { InterruptionOptions, OverlappingSpeechEvent } from './types.js';
+type InterruptionCallbacks = {
+    user_overlapping_speech: (event: OverlappingSpeechEvent) => void;
+    metrics_collected: (metrics: InterruptionMetrics) => void;
+    error: (error: InterruptionDetectionError) => void;
+};
+export type AdaptiveInterruptionDetectorOptions = Omit<Partial<InterruptionOptions>, 'useProxy'>;
+declare const AdaptiveInterruptionDetector_base: new () => TypedEventEmitter<InterruptionCallbacks>;
+export declare class AdaptiveInterruptionDetector extends AdaptiveInterruptionDetector_base {
+    options: InterruptionOptions;
+    private readonly _label;
+    private logger;
+    private streams;
+    constructor(options?: AdaptiveInterruptionDetectorOptions);
+    /**
+     * The model identifier for this detector.
+     */
+    get model(): string;
+    /**
+     * The provider identifier for this detector.
+     */
+    get provider(): string;
+    /**
+     * The label for this detector instance.
+     */
+    get label(): string;
+    /**
+     * The sample rate used for audio processing.
+     */
+    get sampleRate(): number;
+    /**
+     * Emit an error event from the detector.
+     */
+    emitError(error: InterruptionDetectionError): void;
+    /**
+     * Creates a new InterruptionStreamBase for internal use.
+     * The stream can receive audio frames and sentinels via pushFrame().
+     * Use this when you need direct access to the stream for pushing frames.
+     */
+    createStream(): InterruptionStreamBase;
+    /**
+     * Remove a stream from tracking (called when stream is closed).
+     */
+    removeStream(stream: InterruptionStreamBase): void;
+    /**
+     * Update options for the detector and propagate to all active streams.
+     * For WebSocket streams, this triggers a reconnection with new settings.
+     */
+    updateOptions(options: {
+        threshold?: number;
+        minInterruptionDurationInS?: number;
+    }): Promise<void>;
+}
+export {};
+//# sourceMappingURL=interruption_detector.d.ts.map

package/dist/inference/interruption/interruption_detector.d.ts

@@ -0,0 +1,59 @@
+import type { TypedEventEmitter } from '@livekit/typed-emitter';
+import type { InterruptionMetrics } from '../../metrics/base.js';
+import type { InterruptionDetectionError } from './errors.js';
+import { InterruptionStreamBase } from './interruption_stream.js';
+import type { InterruptionOptions, OverlappingSpeechEvent } from './types.js';
+type InterruptionCallbacks = {
+    user_overlapping_speech: (event: OverlappingSpeechEvent) => void;
+    metrics_collected: (metrics: InterruptionMetrics) => void;
+    error: (error: InterruptionDetectionError) => void;
+};
+export type AdaptiveInterruptionDetectorOptions = Omit<Partial<InterruptionOptions>, 'useProxy'>;
+declare const AdaptiveInterruptionDetector_base: new () => TypedEventEmitter<InterruptionCallbacks>;
+export declare class AdaptiveInterruptionDetector extends AdaptiveInterruptionDetector_base {
+    options: InterruptionOptions;
+    private readonly _label;
+    private logger;
+    private streams;
+    constructor(options?: AdaptiveInterruptionDetectorOptions);
+    /**
+     * The model identifier for this detector.
+     */
+    get model(): string;
+    /**
+     * The provider identifier for this detector.
+     */
+    get provider(): string;
+    /**
+     * The label for this detector instance.
+     */
+    get label(): string;
+    /**
+     * The sample rate used for audio processing.
+     */
+    get sampleRate(): number;
+    /**
+     * Emit an error event from the detector.
+     */
+    emitError(error: InterruptionDetectionError): void;
+    /**
+     * Creates a new InterruptionStreamBase for internal use.
+     * The stream can receive audio frames and sentinels via pushFrame().
+     * Use this when you need direct access to the stream for pushing frames.
+     */
+    createStream(): InterruptionStreamBase;
+    /**
+     * Remove a stream from tracking (called when stream is closed).
+     */
+    removeStream(stream: InterruptionStreamBase): void;
+    /**
+     * Update options for the detector and propagate to all active streams.
+     * For WebSocket streams, this triggers a reconnection with new settings.
+     */
+    updateOptions(options: {
+        threshold?: number;
+        minInterruptionDurationInS?: number;
+    }): Promise<void>;
+}
+export {};
+//# sourceMappingURL=interruption_detector.d.ts.map

package/dist/inference/interruption/interruption_detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interruption_detector.d.ts","sourceRoot":"","sources":["../../../src/inference/interruption/interruption_detector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGjE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAE9E,KAAK,qBAAqB,GAAG;IAC3B,uBAAuB,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACjE,iBAAiB,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC1D,KAAK,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,UAAU,CAAC,CAAC;2DAEpB,kBAAkB,qBAAqB,CAAC;AAArH,qBAAa,4BAA6B,SAAQ,iCAAoE;IACpH,OAAO,EAAE,mBAAmB,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO,CAAC,OAAO,CAA0C;gBAE7C,OAAO,GAAE,mCAAwC;IAmF7D;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,0BAA0B,GAAG,IAAI;IAIlD;;;;OAIG;IACH,YAAY,IAAI,sBAAsB;IAMtC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI;IAIlD;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE;QAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,0BAA0B,CAAC,EAAE,MAAM,CAAC;KACrC,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBlB"}

package/dist/inference/interruption/interruption_detector.js

@@ -0,0 +1,147 @@
+import EventEmitter from "events";
+import { log } from "../../log.js";
+import { DEFAULT_INFERENCE_URL, STAGING_INFERENCE_URL, getDefaultInferenceUrl } from "../utils.js";
+import { FRAMES_PER_SECOND, SAMPLE_RATE, interruptionOptionDefaults } from "./defaults.js";
+import { InterruptionStreamBase } from "./interruption_stream.js";
+class AdaptiveInterruptionDetector extends EventEmitter {
+  options;
+  _label;
+  logger = log();
+  // Use Set instead of WeakSet to allow iteration for propagating option updates
+  streams = /* @__PURE__ */ new Set();
+  constructor(options = {}) {
+    super();
+    const {
+      maxAudioDurationInS,
+      baseUrl,
+      apiKey,
+      apiSecret,
+      audioPrefixDurationInS,
+      threshold,
+      detectionIntervalInS,
+      inferenceTimeout,
+      minInterruptionDurationInS
+    } = { ...interruptionOptionDefaults, ...options };
+    if (maxAudioDurationInS > 3) {
+      throw new RangeError("maxAudioDurationInS must be less than or equal to 3.0 seconds");
+    }
+    const lkBaseUrl = baseUrl ?? process.env.LIVEKIT_REMOTE_EOT_URL ?? getDefaultInferenceUrl();
+    let lkApiKey = apiKey ?? "";
+    let lkApiSecret = apiSecret ?? "";
+    let useProxy;
+    const isInferenceUrl = lkBaseUrl === DEFAULT_INFERENCE_URL || lkBaseUrl === STAGING_INFERENCE_URL;
+    if (isInferenceUrl) {
+      lkApiKey = apiKey ?? process.env.LIVEKIT_INFERENCE_API_KEY ?? process.env.LIVEKIT_API_KEY ?? "";
+      if (!lkApiKey) {
+        throw new TypeError(
+          "apiKey is required, either as argument or set LIVEKIT_API_KEY environmental variable"
+        );
+      }
+      lkApiSecret = apiSecret ?? process.env.LIVEKIT_INFERENCE_API_SECRET ?? process.env.LIVEKIT_API_SECRET ?? "";
+      if (!lkApiSecret) {
+        throw new TypeError(
+          "apiSecret is required, either as argument or set LIVEKIT_API_SECRET environmental variable"
+        );
+      }
+      useProxy = true;
+    } else {
+      useProxy = false;
+    }
+    this.options = {
+      sampleRate: SAMPLE_RATE,
+      threshold,
+      minFrames: Math.ceil(minInterruptionDurationInS * FRAMES_PER_SECOND),
+      maxAudioDurationInS,
+      audioPrefixDurationInS,
+      detectionIntervalInS,
+      inferenceTimeout,
+      baseUrl: lkBaseUrl,
+      apiKey: lkApiKey,
+      apiSecret: lkApiSecret,
+      useProxy,
+      minInterruptionDurationInS
+    };
+    this._label = `${this.constructor.name}`;
+    this.logger.debug(
+      {
+        baseUrl: this.options.baseUrl,
+        detectionIntervalInS: this.options.detectionIntervalInS,
+        audioPrefixDurationInS: this.options.audioPrefixDurationInS,
+        maxAudioDurationInS: this.options.maxAudioDurationInS,
+        minFrames: this.options.minFrames,
+        threshold: this.options.threshold,
+        inferenceTimeout: this.options.inferenceTimeout,
+        useProxy: this.options.useProxy
+      },
+      "adaptive interruption detector initialized"
+    );
+  }
+  /**
+   * The model identifier for this detector.
+   */
+  get model() {
+    return "adaptive interruption";
+  }
+  /**
+   * The provider identifier for this detector.
+   */
+  get provider() {
+    return "livekit";
+  }
+  /**
+   * The label for this detector instance.
+   */
+  get label() {
+    return this._label;
+  }
+  /**
+   * The sample rate used for audio processing.
+   */
+  get sampleRate() {
+    return this.options.sampleRate;
+  }
+  /**
+   * Emit an error event from the detector.
+   */
+  emitError(error) {
+    this.emit("error", error);
+  }
+  /**
+   * Creates a new InterruptionStreamBase for internal use.
+   * The stream can receive audio frames and sentinels via pushFrame().
+   * Use this when you need direct access to the stream for pushing frames.
+   */
+  createStream() {
+    const streamBase = new InterruptionStreamBase(this, {});
+    this.streams.add(streamBase);
+    return streamBase;
+  }
+  /**
+   * Remove a stream from tracking (called when stream is closed).
+   */
+  removeStream(stream) {
+    this.streams.delete(stream);
+  }
+  /**
+   * Update options for the detector and propagate to all active streams.
+   * For WebSocket streams, this triggers a reconnection with new settings.
+   */
+  async updateOptions(options) {
+    if (options.threshold !== void 0) {
+      this.options.threshold = options.threshold;
+    }
+    if (options.minInterruptionDurationInS !== void 0) {
+      this.options.minInterruptionDurationInS = options.minInterruptionDurationInS;
+      this.options.minFrames = Math.ceil(options.minInterruptionDurationInS * FRAMES_PER_SECOND);
+    }
+    const updatePromises = [];
+    for (const stream of this.streams) {
+      updatePromises.push(stream.updateOptions(options));
+    }
+    await Promise.all(updatePromises);
+  }
+}
+export {
+  AdaptiveInterruptionDetector
+};
+//# sourceMappingURL=interruption_detector.js.map

package/dist/inference/interruption/interruption_detector.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/inference/interruption/interruption_detector.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type { TypedEventEmitter } from '@livekit/typed-emitter';\nimport EventEmitter from 'events';\nimport { log } from '../../log.js';\nimport type { InterruptionMetrics } from '../../metrics/base.js';\nimport { DEFAULT_INFERENCE_URL, STAGING_INFERENCE_URL, getDefaultInferenceUrl } from '../utils.js';\nimport { FRAMES_PER_SECOND, SAMPLE_RATE, interruptionOptionDefaults } from './defaults.js';\nimport type { InterruptionDetectionError } from './errors.js';\nimport { InterruptionStreamBase } from './interruption_stream.js';\nimport type { InterruptionOptions, OverlappingSpeechEvent } from './types.js';\n\ntype InterruptionCallbacks = {\n  user_overlapping_speech: (event: OverlappingSpeechEvent) => void;\n  metrics_collected: (metrics: InterruptionMetrics) => void;\n  error: (error: InterruptionDetectionError) => void;\n};\n\nexport type AdaptiveInterruptionDetectorOptions = Omit<Partial<InterruptionOptions>, 'useProxy'>;\n\nexport class AdaptiveInterruptionDetector extends (EventEmitter as new () => TypedEventEmitter<InterruptionCallbacks>) {\n  options: InterruptionOptions;\n  private readonly _label: string;\n  private logger = log();\n  // Use Set instead of WeakSet to allow iteration for propagating option updates\n  private streams: Set<InterruptionStreamBase> = new Set();\n\n  constructor(options: AdaptiveInterruptionDetectorOptions = {}) {\n    super();\n\n    const {\n      maxAudioDurationInS,\n      baseUrl,\n      apiKey,\n      apiSecret,\n      audioPrefixDurationInS,\n      threshold,\n      detectionIntervalInS,\n      inferenceTimeout,\n      minInterruptionDurationInS,\n    } = { ...interruptionOptionDefaults, ...options };\n\n    if (maxAudioDurationInS > 3.0) {\n      throw new RangeError('maxAudioDurationInS must be less than or equal to 3.0 seconds');\n    }\n\n    const lkBaseUrl = baseUrl ?? process.env.LIVEKIT_REMOTE_EOT_URL ?? getDefaultInferenceUrl();\n    let lkApiKey = apiKey ?? '';\n    let lkApiSecret = apiSecret ?? '';\n    let useProxy: boolean;\n\n    // Use LiveKit credentials if using the inference service (production or staging)\n    const isInferenceUrl =\n      lkBaseUrl === DEFAULT_INFERENCE_URL || lkBaseUrl === STAGING_INFERENCE_URL;\n    if (isInferenceUrl) {\n      lkApiKey =\n        apiKey ?? process.env.LIVEKIT_INFERENCE_API_KEY ?? process.env.LIVEKIT_API_KEY ?? '';\n      if (!lkApiKey) {\n        throw new TypeError(\n          'apiKey is required, either as argument or set LIVEKIT_API_KEY environmental variable',\n        );\n      }\n\n      lkApiSecret =\n        apiSecret ??\n        process.env.LIVEKIT_INFERENCE_API_SECRET ??\n        process.env.LIVEKIT_API_SECRET ??\n        '';\n      if (!lkApiSecret) {\n        throw new TypeError(\n          'apiSecret is required, either as argument or set LIVEKIT_API_SECRET environmental variable',\n        );\n      }\n      useProxy = true;\n    } else {\n      useProxy = false;\n    }\n\n    this.options = {\n      sampleRate: SAMPLE_RATE,\n      threshold,\n      minFrames: Math.ceil(minInterruptionDurationInS * FRAMES_PER_SECOND),\n      maxAudioDurationInS,\n      audioPrefixDurationInS,\n      detectionIntervalInS,\n      inferenceTimeout,\n      baseUrl: lkBaseUrl,\n      apiKey: lkApiKey,\n      apiSecret: lkApiSecret,\n      useProxy,\n      minInterruptionDurationInS,\n    };\n\n    this._label = `${this.constructor.name}`;\n\n    this.logger.debug(\n      {\n        baseUrl: this.options.baseUrl,\n        detectionIntervalInS: this.options.detectionIntervalInS,\n        audioPrefixDurationInS: this.options.audioPrefixDurationInS,\n        maxAudioDurationInS: this.options.maxAudioDurationInS,\n        minFrames: this.options.minFrames,\n        threshold: this.options.threshold,\n        inferenceTimeout: this.options.inferenceTimeout,\n        useProxy: this.options.useProxy,\n      },\n      'adaptive interruption detector initialized',\n    );\n  }\n\n  /**\n   * The model identifier for this detector.\n   */\n  get model(): string {\n    return 'adaptive interruption';\n  }\n\n  /**\n   * The provider identifier for this detector.\n   */\n  get provider(): string {\n    return 'livekit';\n  }\n\n  /**\n   * The label for this detector instance.\n   */\n  get label(): string {\n    return this._label;\n  }\n\n  /**\n   * The sample rate used for audio processing.\n   */\n  get sampleRate(): number {\n    return this.options.sampleRate;\n  }\n\n  /**\n   * Emit an error event from the detector.\n   */\n  emitError(error: InterruptionDetectionError): void {\n    this.emit('error', error);\n  }\n\n  /**\n   * Creates a new InterruptionStreamBase for internal use.\n   * The stream can receive audio frames and sentinels via pushFrame().\n   * Use this when you need direct access to the stream for pushing frames.\n   */\n  createStream(): InterruptionStreamBase {\n    const streamBase = new InterruptionStreamBase(this, {});\n    this.streams.add(streamBase);\n    return streamBase;\n  }\n\n  /**\n   * Remove a stream from tracking (called when stream is closed).\n   */\n  removeStream(stream: InterruptionStreamBase): void {\n    this.streams.delete(stream);\n  }\n\n  /**\n   * Update options for the detector and propagate to all active streams.\n   * For WebSocket streams, this triggers a reconnection with new settings.\n   */\n  async updateOptions(options: {\n    threshold?: number;\n    minInterruptionDurationInS?: number;\n  }): Promise<void> {\n    if (options.threshold !== undefined) {\n      this.options.threshold = options.threshold;\n    }\n    if (options.minInterruptionDurationInS !== undefined) {\n      this.options.minInterruptionDurationInS = options.minInterruptionDurationInS;\n      this.options.minFrames = Math.ceil(options.minInterruptionDurationInS * FRAMES_PER_SECOND);\n    }\n\n    // Propagate option updates to all active streams (matching Python behavior)\n    const updatePromises: Promise<void>[] = [];\n    for (const stream of this.streams) {\n      updatePromises.push(stream.updateOptions(options));\n    }\n    await Promise.all(updatePromises);\n  }\n}\n"],"mappings":"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","names":[]}