@livekit/agents 1.1.0 → 1.2.0

package/dist/voice/turn_config/interruption.cjs

@@ -0,0 +1,37 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var interruption_exports = {};
+__export(interruption_exports, {
+  defaultInterruptionOptions: () => defaultInterruptionOptions
+});
+module.exports = __toCommonJS(interruption_exports);
+const defaultInterruptionOptions = {
+  enabled: true,
+  mode: void 0,
+  discardAudioIfUninterruptible: true,
+  minDuration: 500,
+  minWords: 0,
+  falseInterruptionTimeout: 2e3,
+  resumeFalseInterruption: true
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defaultInterruptionOptions
+});
+//# sourceMappingURL=interruption.cjs.map

package/dist/voice/turn_config/interruption.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/voice/turn_config/interruption.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n/**\n * Configuration for interruption handling.\n */\nexport interface InterruptionOptions {\n  /**\n   * Whether interruptions are enabled.\n   * @defaultValue true\n   */\n  enabled: boolean;\n  /**\n   * Interruption handling strategy. `\"adaptive\"` for ML-based detection, `\"vad\"` for simple\n   * voice-activity detection. `undefined` means auto-detect.\n   * @defaultValue undefined\n   */\n  mode: 'adaptive' | 'vad' | undefined;\n  /**\n   * When `true`, buffered audio is dropped while the agent is speaking and cannot be interrupted.\n   * @defaultValue true\n   */\n  discardAudioIfUninterruptible: boolean;\n  /**\n   * Minimum speech length in milliseconds to register as an interruption.\n   * @defaultValue 500\n   */\n  minDuration: number;\n  /**\n   * Minimum number of words to consider an interruption, only used if STT is enabled.\n   * @defaultValue 0\n   */\n  minWords: number;\n  /**\n   * If set, emit an `agentFalseInterruption` event after this amount of time if the user is\n   * silent and no user transcript is detected after the interruption. Set to `undefined` to\n   * disable. The value is in milliseconds.\n   * @defaultValue 2000\n   */\n  falseInterruptionTimeout: number;\n  /**\n   * Whether to resume the false interruption after the `falseInterruptionTimeout`.\n   * @defaultValue true\n   */\n  resumeFalseInterruption: boolean;\n}\n\nexport const defaultInterruptionOptions = {\n  enabled: true,\n  mode: undefined,\n  discardAudioIfUninterruptible: true,\n  minDuration: 500,\n  minWords: 0,\n  falseInterruptionTimeout: 2000,\n  resumeFalseInterruption: true,\n} as const satisfies InterruptionOptions;\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA+CO,MAAM,6BAA6B;AAAA,EACxC,SAAS;AAAA,EACT,MAAM;AAAA,EACN,+BAA+B;AAAA,EAC/B,aAAa;AAAA,EACb,UAAU;AAAA,EACV,0BAA0B;AAAA,EAC1B,yBAAyB;AAC3B;","names":[]}

package/dist/voice/turn_config/interruption.d.cts

@@ -0,0 +1,53 @@
+/**
+ * Configuration for interruption handling.
+ */
+export interface InterruptionOptions {
+    /**
+     * Whether interruptions are enabled.
+     * @defaultValue true
+     */
+    enabled: boolean;
+    /**
+     * Interruption handling strategy. `"adaptive"` for ML-based detection, `"vad"` for simple
+     * voice-activity detection. `undefined` means auto-detect.
+     * @defaultValue undefined
+     */
+    mode: 'adaptive' | 'vad' | undefined;
+    /**
+     * When `true`, buffered audio is dropped while the agent is speaking and cannot be interrupted.
+     * @defaultValue true
+     */
+    discardAudioIfUninterruptible: boolean;
+    /**
+     * Minimum speech length in milliseconds to register as an interruption.
+     * @defaultValue 500
+     */
+    minDuration: number;
+    /**
+     * Minimum number of words to consider an interruption, only used if STT is enabled.
+     * @defaultValue 0
+     */
+    minWords: number;
+    /**
+     * If set, emit an `agentFalseInterruption` event after this amount of time if the user is
+     * silent and no user transcript is detected after the interruption. Set to `undefined` to
+     * disable. The value is in milliseconds.
+     * @defaultValue 2000
+     */
+    falseInterruptionTimeout: number;
+    /**
+     * Whether to resume the false interruption after the `falseInterruptionTimeout`.
+     * @defaultValue true
+     */
+    resumeFalseInterruption: boolean;
+}
+export declare const defaultInterruptionOptions: {
+    readonly enabled: true;
+    readonly mode: undefined;
+    readonly discardAudioIfUninterruptible: true;
+    readonly minDuration: 500;
+    readonly minWords: 0;
+    readonly falseInterruptionTimeout: 2000;
+    readonly resumeFalseInterruption: true;
+};
+//# sourceMappingURL=interruption.d.ts.map

package/dist/voice/turn_config/interruption.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Configuration for interruption handling.
+ */
+export interface InterruptionOptions {
+    /**
+     * Whether interruptions are enabled.
+     * @defaultValue true
+     */
+    enabled: boolean;
+    /**
+     * Interruption handling strategy. `"adaptive"` for ML-based detection, `"vad"` for simple
+     * voice-activity detection. `undefined` means auto-detect.
+     * @defaultValue undefined
+     */
+    mode: 'adaptive' | 'vad' | undefined;
+    /**
+     * When `true`, buffered audio is dropped while the agent is speaking and cannot be interrupted.
+     * @defaultValue true
+     */
+    discardAudioIfUninterruptible: boolean;
+    /**
+     * Minimum speech length in milliseconds to register as an interruption.
+     * @defaultValue 500
+     */
+    minDuration: number;
+    /**
+     * Minimum number of words to consider an interruption, only used if STT is enabled.
+     * @defaultValue 0
+     */
+    minWords: number;
+    /**
+     * If set, emit an `agentFalseInterruption` event after this amount of time if the user is
+     * silent and no user transcript is detected after the interruption. Set to `undefined` to
+     * disable. The value is in milliseconds.
+     * @defaultValue 2000
+     */
+    falseInterruptionTimeout: number;
+    /**
+     * Whether to resume the false interruption after the `falseInterruptionTimeout`.
+     * @defaultValue true
+     */
+    resumeFalseInterruption: boolean;
+}
+export declare const defaultInterruptionOptions: {
+    readonly enabled: true;
+    readonly mode: undefined;
+    readonly discardAudioIfUninterruptible: true;
+    readonly minDuration: 500;
+    readonly minWords: 0;
+    readonly falseInterruptionTimeout: 2000;
+    readonly resumeFalseInterruption: true;
+};
+//# sourceMappingURL=interruption.d.ts.map

package/dist/voice/turn_config/interruption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interruption.d.ts","sourceRoot":"","sources":["../../../src/voice/turn_config/interruption.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,IAAI,EAAE,UAAU,GAAG,KAAK,GAAG,SAAS,CAAC;IACrC;;;OAGG;IACH,6BAA6B,EAAE,OAAO,CAAC;IACvC;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,wBAAwB,EAAE,MAAM,CAAC;IACjC;;;OAGG;IACH,uBAAuB,EAAE,OAAO,CAAC;CAClC;AAED,eAAO,MAAM,0BAA0B;;;;;;;;CAQC,CAAC"}

package/dist/voice/turn_config/interruption.js

@@ -0,0 +1,13 @@
+const defaultInterruptionOptions = {
+  enabled: true,
+  mode: void 0,
+  discardAudioIfUninterruptible: true,
+  minDuration: 500,
+  minWords: 0,
+  falseInterruptionTimeout: 2e3,
+  resumeFalseInterruption: true
+};
+export {
+  defaultInterruptionOptions
+};
+//# sourceMappingURL=interruption.js.map

package/dist/voice/turn_config/interruption.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/voice/turn_config/interruption.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n/**\n * Configuration for interruption handling.\n */\nexport interface InterruptionOptions {\n  /**\n   * Whether interruptions are enabled.\n   * @defaultValue true\n   */\n  enabled: boolean;\n  /**\n   * Interruption handling strategy. `\"adaptive\"` for ML-based detection, `\"vad\"` for simple\n   * voice-activity detection. `undefined` means auto-detect.\n   * @defaultValue undefined\n   */\n  mode: 'adaptive' | 'vad' | undefined;\n  /**\n   * When `true`, buffered audio is dropped while the agent is speaking and cannot be interrupted.\n   * @defaultValue true\n   */\n  discardAudioIfUninterruptible: boolean;\n  /**\n   * Minimum speech length in milliseconds to register as an interruption.\n   * @defaultValue 500\n   */\n  minDuration: number;\n  /**\n   * Minimum number of words to consider an interruption, only used if STT is enabled.\n   * @defaultValue 0\n   */\n  minWords: number;\n  /**\n   * If set, emit an `agentFalseInterruption` event after this amount of time if the user is\n   * silent and no user transcript is detected after the interruption. Set to `undefined` to\n   * disable. The value is in milliseconds.\n   * @defaultValue 2000\n   */\n  falseInterruptionTimeout: number;\n  /**\n   * Whether to resume the false interruption after the `falseInterruptionTimeout`.\n   * @defaultValue true\n   */\n  resumeFalseInterruption: boolean;\n}\n\nexport const defaultInterruptionOptions = {\n  enabled: true,\n  mode: undefined,\n  discardAudioIfUninterruptible: true,\n  minDuration: 500,\n  minWords: 0,\n  falseInterruptionTimeout: 2000,\n  resumeFalseInterruption: true,\n} as const satisfies InterruptionOptions;\n"],"mappings":"AA+CO,MAAM,6BAA6B;AAAA,EACxC,SAAS;AAAA,EACT,MAAM;AAAA,EACN,+BAA+B;AAAA,EAC/B,aAAa;AAAA,EACb,UAAU;AAAA,EACV,0BAA0B;AAAA,EAC1B,yBAAyB;AAC3B;","names":[]}

package/dist/voice/turn_config/turn_handling.cjs

@@ -0,0 +1,35 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var turn_handling_exports = {};
+__export(turn_handling_exports, {
+  defaultTurnHandlingOptions: () => defaultTurnHandlingOptions
+});
+module.exports = __toCommonJS(turn_handling_exports);
+var import_endpointing = require("./endpointing.cjs");
+var import_interruption = require("./interruption.cjs");
+const defaultTurnHandlingOptions = {
+  turnDetection: void 0,
+  interruption: import_interruption.defaultInterruptionOptions,
+  endpointing: import_endpointing.defaultEndpointingOptions
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defaultTurnHandlingOptions
+});
+//# sourceMappingURL=turn_handling.cjs.map

package/dist/voice/turn_config/turn_handling.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/voice/turn_config/turn_handling.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type { TurnDetectionMode } from '../agent_session.js';\nimport { type EndpointingOptions, defaultEndpointingOptions } from './endpointing.js';\nimport { type InterruptionOptions, defaultInterruptionOptions } from './interruption.js';\n\n/**\n * Configuration for the turn handling system. Used to configure the turn taking behavior of the\n * session.\n */\nexport interface TurnHandlingOptions {\n  /**\n   * Strategy for deciding when the user has finished speaking.\n   *\n   * - `\"stt\"` – rely on speech-to-text end-of-utterance cues\n   * - `\"vad\"` – rely on Voice Activity Detection start/stop cues\n   * - `\"realtime_llm\"` – use server-side detection from a realtime LLM\n   * - `\"manual\"` – caller controls turn boundaries explicitly\n   *\n   * If not set, the session chooses the best available mode in priority order\n   * `realtime_llm → vad → stt → manual`; it automatically falls back if the necessary model\n   * is missing.\n   */\n  turnDetection: TurnDetectionMode | undefined;\n  /**\n   * Configuration for endpointing.\n   */\n  endpointing: Partial<EndpointingOptions>;\n  /**\n   * Configuration for interruption handling.\n   */\n  interruption: Partial<InterruptionOptions>;\n}\n\nexport interface InternalTurnHandlingOptions extends TurnHandlingOptions {\n  endpointing: EndpointingOptions;\n  interruption: InterruptionOptions;\n}\n\nexport const defaultTurnHandlingOptions: InternalTurnHandlingOptions = {\n  turnDetection: undefined,\n  interruption: defaultInterruptionOptions,\n  endpointing: defaultEndpointingOptions,\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,yBAAmE;AACnE,0BAAqE;AAmC9D,MAAM,6BAA0D;AAAA,EACrE,eAAe;AAAA,EACf,cAAc;AAAA,EACd,aAAa;AACf;","names":[]}

package/dist/voice/turn_config/turn_handling.d.cts

@@ -0,0 +1,36 @@
+import type { TurnDetectionMode } from '../agent_session.js';
+import { type EndpointingOptions } from './endpointing.js';
+import { type InterruptionOptions } from './interruption.js';
+/**
+ * Configuration for the turn handling system. Used to configure the turn taking behavior of the
+ * session.
+ */
+export interface TurnHandlingOptions {
+    /**
+     * Strategy for deciding when the user has finished speaking.
+     *
+     * - `"stt"` – rely on speech-to-text end-of-utterance cues
+     * - `"vad"` – rely on Voice Activity Detection start/stop cues
+     * - `"realtime_llm"` – use server-side detection from a realtime LLM
+     * - `"manual"` – caller controls turn boundaries explicitly
+     *
+     * If not set, the session chooses the best available mode in priority order
+     * `realtime_llm → vad → stt → manual`; it automatically falls back if the necessary model
+     * is missing.
+     */
+    turnDetection: TurnDetectionMode | undefined;
+    /**
+     * Configuration for endpointing.
+     */
+    endpointing: Partial<EndpointingOptions>;
+    /**
+     * Configuration for interruption handling.
+     */
+    interruption: Partial<InterruptionOptions>;
+}
+export interface InternalTurnHandlingOptions extends TurnHandlingOptions {
+    endpointing: EndpointingOptions;
+    interruption: InterruptionOptions;
+}
+export declare const defaultTurnHandlingOptions: InternalTurnHandlingOptions;
+//# sourceMappingURL=turn_handling.d.ts.map

package/dist/voice/turn_config/turn_handling.d.ts

@@ -0,0 +1,36 @@
+import type { TurnDetectionMode } from '../agent_session.js';
+import { type EndpointingOptions } from './endpointing.js';
+import { type InterruptionOptions } from './interruption.js';
+/**
+ * Configuration for the turn handling system. Used to configure the turn taking behavior of the
+ * session.
+ */
+export interface TurnHandlingOptions {
+    /**
+     * Strategy for deciding when the user has finished speaking.
+     *
+     * - `"stt"` – rely on speech-to-text end-of-utterance cues
+     * - `"vad"` – rely on Voice Activity Detection start/stop cues
+     * - `"realtime_llm"` – use server-side detection from a realtime LLM
+     * - `"manual"` – caller controls turn boundaries explicitly
+     *
+     * If not set, the session chooses the best available mode in priority order
+     * `realtime_llm → vad → stt → manual`; it automatically falls back if the necessary model
+     * is missing.
+     */
+    turnDetection: TurnDetectionMode | undefined;
+    /**
+     * Configuration for endpointing.
+     */
+    endpointing: Partial<EndpointingOptions>;
+    /**
+     * Configuration for interruption handling.
+     */
+    interruption: Partial<InterruptionOptions>;
+}
+export interface InternalTurnHandlingOptions extends TurnHandlingOptions {
+    endpointing: EndpointingOptions;
+    interruption: InterruptionOptions;
+}
+export declare const defaultTurnHandlingOptions: InternalTurnHandlingOptions;
+//# sourceMappingURL=turn_handling.d.ts.map

package/dist/voice/turn_config/turn_handling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn_handling.d.ts","sourceRoot":"","sources":["../../../src/voice/turn_config/turn_handling.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,KAAK,kBAAkB,EAA6B,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,KAAK,mBAAmB,EAA8B,MAAM,mBAAmB,CAAC;AAEzF;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;OAWG;IACH,aAAa,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC7C;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACzC;;OAEG;IACH,YAAY,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;IACtE,WAAW,EAAE,kBAAkB,CAAC;IAChC,YAAY,EAAE,mBAAmB,CAAC;CACnC;AAED,eAAO,MAAM,0BAA0B,EAAE,2BAIxC,CAAC"}

package/dist/voice/turn_config/turn_handling.js

@@ -0,0 +1,11 @@
+import { defaultEndpointingOptions } from "./endpointing.js";
+import { defaultInterruptionOptions } from "./interruption.js";
+const defaultTurnHandlingOptions = {
+  turnDetection: void 0,
+  interruption: defaultInterruptionOptions,
+  endpointing: defaultEndpointingOptions
+};
+export {
+  defaultTurnHandlingOptions
+};
+//# sourceMappingURL=turn_handling.js.map

package/dist/voice/turn_config/turn_handling.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/voice/turn_config/turn_handling.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type { TurnDetectionMode } from '../agent_session.js';\nimport { type EndpointingOptions, defaultEndpointingOptions } from './endpointing.js';\nimport { type InterruptionOptions, defaultInterruptionOptions } from './interruption.js';\n\n/**\n * Configuration for the turn handling system. Used to configure the turn taking behavior of the\n * session.\n */\nexport interface TurnHandlingOptions {\n  /**\n   * Strategy for deciding when the user has finished speaking.\n   *\n   * - `\"stt\"` – rely on speech-to-text end-of-utterance cues\n   * - `\"vad\"` – rely on Voice Activity Detection start/stop cues\n   * - `\"realtime_llm\"` – use server-side detection from a realtime LLM\n   * - `\"manual\"` – caller controls turn boundaries explicitly\n   *\n   * If not set, the session chooses the best available mode in priority order\n   * `realtime_llm → vad → stt → manual`; it automatically falls back if the necessary model\n   * is missing.\n   */\n  turnDetection: TurnDetectionMode | undefined;\n  /**\n   * Configuration for endpointing.\n   */\n  endpointing: Partial<EndpointingOptions>;\n  /**\n   * Configuration for interruption handling.\n   */\n  interruption: Partial<InterruptionOptions>;\n}\n\nexport interface InternalTurnHandlingOptions extends TurnHandlingOptions {\n  endpointing: EndpointingOptions;\n  interruption: InterruptionOptions;\n}\n\nexport const defaultTurnHandlingOptions: InternalTurnHandlingOptions = {\n  turnDetection: undefined,\n  interruption: defaultInterruptionOptions,\n  endpointing: defaultEndpointingOptions,\n};\n"],"mappings":"AAIA,SAAkC,iCAAiC;AACnE,SAAmC,kCAAkC;AAmC9D,MAAM,6BAA0D;AAAA,EACrE,eAAe;AAAA,EACf,cAAc;AAAA,EACd,aAAa;AACf;","names":[]}

package/dist/voice/turn_config/utils.cjs

@@ -0,0 +1,157 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var utils_exports = {};
+__export(utils_exports, {
+  mergeWithDefaults: () => mergeWithDefaults,
+  migrateLegacyOptions: () => migrateLegacyOptions,
+  migrateTurnHandling: () => migrateTurnHandling,
+  stripUndefined: () => stripUndefined
+});
+module.exports = __toCommonJS(utils_exports);
+var import_log = require("../../log.cjs");
+var import_agent_session = require("../agent_session.cjs");
+var import_endpointing = require("./endpointing.cjs");
+var import_interruption = require("./interruption.cjs");
+var import_turn_handling = require("./turn_handling.cjs");
+const defaultSessionOptions = {
+  maxToolSteps: 3,
+  preemptiveGeneration: true,
+  userAwayTimeout: 15,
+  aecWarmupDuration: 3e3,
+  turnHandling: {},
+  useTtsAlignedTranscript: true
+};
+const defaultLegacyVoiceOptions = {
+  minEndpointingDelay: import_turn_handling.defaultTurnHandlingOptions.endpointing.minDelay,
+  maxEndpointingDelay: import_turn_handling.defaultTurnHandlingOptions.endpointing.maxDelay,
+  maxToolSteps: defaultSessionOptions.maxToolSteps,
+  preemptiveGeneration: defaultSessionOptions.preemptiveGeneration
+};
+function migrateLegacyOptions(legacyOptions) {
+  var _a, _b, _c;
+  const logger = (0, import_log.log)();
+  const {
+    voiceOptions,
+    turnDetection,
+    stt,
+    vad,
+    llm,
+    tts,
+    userData,
+    connOptions,
+    ...sessionOptions
+  } = legacyOptions;
+  if (voiceOptions !== void 0) {
+    logger.warn(
+      "voiceOptions is deprecated, use top-level SessionOptions fields on AgentSessionOptions instead"
+    );
+  }
+  const turnHandling = {
+    interruption: {
+      discardAudioIfUninterruptible: voiceOptions == null ? void 0 : voiceOptions.discardAudioIfUninterruptible,
+      minDuration: voiceOptions == null ? void 0 : voiceOptions.minInterruptionDuration,
+      minWords: voiceOptions == null ? void 0 : voiceOptions.minInterruptionWords,
+      ...(_a = sessionOptions.turnHandling) == null ? void 0 : _a.interruption
+    },
+    endpointing: {
+      minDelay: voiceOptions == null ? void 0 : voiceOptions.minEndpointingDelay,
+      maxDelay: voiceOptions == null ? void 0 : voiceOptions.maxEndpointingDelay,
+      ...(_b = sessionOptions.turnHandling) == null ? void 0 : _b.endpointing
+    },
+    turnDetection: ((_c = sessionOptions == null ? void 0 : sessionOptions.turnHandling) == null ? void 0 : _c.turnDetection) ?? turnDetection
+  };
+  if ((voiceOptions == null ? void 0 : voiceOptions.allowInterruptions) === false && turnHandling.interruption.enabled === void 0) {
+    turnHandling.interruption.enabled = false;
+  }
+  const migratedVoiceOptions = {};
+  if ((voiceOptions == null ? void 0 : voiceOptions.maxToolSteps) !== void 0) {
+    migratedVoiceOptions.maxToolSteps = voiceOptions.maxToolSteps;
+  }
+  if ((voiceOptions == null ? void 0 : voiceOptions.preemptiveGeneration) !== void 0) {
+    migratedVoiceOptions.preemptiveGeneration = voiceOptions.preemptiveGeneration;
+  }
+  if ((voiceOptions == null ? void 0 : voiceOptions.userAwayTimeout) !== void 0) {
+    migratedVoiceOptions.userAwayTimeout = voiceOptions.userAwayTimeout;
+  }
+  const legacyVoiceOptions = { ...defaultLegacyVoiceOptions, ...voiceOptions };
+  const agentSessionOptions = {
+    stt,
+    vad,
+    llm,
+    tts,
+    userData,
+    connOptions,
+    ...defaultSessionOptions,
+    ...migratedVoiceOptions,
+    ...sessionOptions,
+    turnHandling: mergeWithDefaults(turnHandling),
+    // repopulate the deprecated voice options with migrated options for backwards compatibility
+    voiceOptions: legacyVoiceOptions
+  };
+  return { agentSessionOptions, legacyVoiceOptions };
+}
+function stripUndefined(obj) {
+  return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== void 0));
+}
+function mergeWithDefaults(config) {
+  return {
+    turnDetection: config.turnDetection ?? import_turn_handling.defaultTurnHandlingOptions.turnDetection,
+    endpointing: { ...import_endpointing.defaultEndpointingOptions, ...stripUndefined(config.endpointing) },
+    interruption: { ...import_interruption.defaultInterruptionOptions, ...stripUndefined(config.interruption) }
+  };
+}
+function migrateTurnHandling(opts) {
+  if (opts.turnHandling !== void 0) {
+    return opts.turnHandling;
+  }
+  const migrated = {};
+  const endpointing = {};
+  if (opts.minEndpointingDelay !== void 0) {
+    endpointing.minDelay = opts.minEndpointingDelay;
+  }
+  if (opts.maxEndpointingDelay !== void 0) {
+    endpointing.maxDelay = opts.maxEndpointingDelay;
+  }
+  if (Object.keys(endpointing).length > 0) {
+    migrated.endpointing = endpointing;
+  }
+  const interruption = {};
+  if (opts.allowInterruptions === false) {
+    interruption.enabled = false;
+  }
+  if (Object.keys(interruption).length > 0) {
+    migrated.interruption = interruption;
+  }
+  if (opts.turnDetection !== void 0) {
+    migrated.turnDetection = opts.turnDetection;
+  }
+  return {
+    ...migrated.endpointing ? { endpointing: migrated.endpointing } : {},
+    ...migrated.interruption ? { interruption: migrated.interruption } : {},
+    ...migrated.turnDetection !== void 0 ? { turnDetection: migrated.turnDetection } : {}
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  mergeWithDefaults,
+  migrateLegacyOptions,
+  migrateTurnHandling,
+  stripUndefined
+});
+//# sourceMappingURL=utils.cjs.map

package/dist/voice/turn_config/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/voice/turn_config/utils.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { log } from '../../log.js';\nimport {\n  type AgentSessionOptions,\n  type InternalSessionOptions,\n  type TurnDetectionMode,\n  type VoiceOptions,\n} from '../agent_session.js';\nimport { defaultEndpointingOptions } from './endpointing.js';\nimport { defaultInterruptionOptions } from './interruption.js';\nimport { type TurnHandlingOptions, defaultTurnHandlingOptions } from './turn_handling.js';\n\nconst defaultSessionOptions = {\n  maxToolSteps: 3,\n  preemptiveGeneration: true,\n  userAwayTimeout: 15.0,\n  aecWarmupDuration: 3000,\n  turnHandling: {},\n  useTtsAlignedTranscript: true,\n} as const satisfies AgentSessionOptions;\n\nconst defaultLegacyVoiceOptions: VoiceOptions = {\n  minEndpointingDelay: defaultTurnHandlingOptions.endpointing.minDelay,\n  maxEndpointingDelay: defaultTurnHandlingOptions.endpointing.maxDelay,\n  maxToolSteps: defaultSessionOptions.maxToolSteps,\n  preemptiveGeneration: defaultSessionOptions.preemptiveGeneration,\n};\n\nexport function migrateLegacyOptions<UserData>(legacyOptions: AgentSessionOptions<UserData>): {\n  agentSessionOptions: InternalSessionOptions<UserData>;\n  legacyVoiceOptions: VoiceOptions;\n} {\n  const logger = log();\n  const {\n    voiceOptions,\n    turnDetection,\n    stt,\n    vad,\n    llm,\n    tts,\n    userData,\n    connOptions,\n    ...sessionOptions\n  } = legacyOptions;\n\n  if (voiceOptions !== undefined) {\n    logger.warn(\n      'voiceOptions is deprecated, use top-level SessionOptions fields on AgentSessionOptions instead',\n    );\n  }\n\n  const turnHandling: TurnHandlingOptions = {\n    interruption: {\n      discardAudioIfUninterruptible: voiceOptions?.discardAudioIfUninterruptible,\n      minDuration: voiceOptions?.minInterruptionDuration,\n      minWords: voiceOptions?.minInterruptionWords,\n      ...sessionOptions.turnHandling?.interruption,\n    },\n    endpointing: {\n      minDelay: voiceOptions?.minEndpointingDelay,\n      maxDelay: voiceOptions?.maxEndpointingDelay,\n      ...sessionOptions.turnHandling?.endpointing,\n    },\n\n    turnDetection: sessionOptions?.turnHandling?.turnDetection ?? turnDetection,\n  } as const;\n\n  if (\n    voiceOptions?.allowInterruptions === false &&\n    turnHandling.interruption.enabled === undefined\n  ) {\n    turnHandling.interruption.enabled = false;\n  }\n\n  const migratedVoiceOptions: AgentSessionOptions<UserData> = {};\n\n  if (voiceOptions?.maxToolSteps !== undefined) {\n    migratedVoiceOptions.maxToolSteps = voiceOptions.maxToolSteps;\n  }\n  if (voiceOptions?.preemptiveGeneration !== undefined) {\n    migratedVoiceOptions.preemptiveGeneration = voiceOptions.preemptiveGeneration;\n  }\n  if (voiceOptions?.userAwayTimeout !== undefined) {\n    migratedVoiceOptions.userAwayTimeout = voiceOptions.userAwayTimeout;\n  }\n\n  const legacyVoiceOptions = { ...defaultLegacyVoiceOptions, ...voiceOptions };\n\n  const agentSessionOptions = {\n    stt,\n    vad,\n    llm,\n    tts,\n    userData,\n    connOptions,\n    ...defaultSessionOptions,\n    ...migratedVoiceOptions,\n    ...sessionOptions,\n    turnHandling: mergeWithDefaults(turnHandling),\n    // repopulate the deprecated voice options with migrated options for backwards compatibility\n    voiceOptions: legacyVoiceOptions,\n  };\n\n  return { agentSessionOptions, legacyVoiceOptions };\n}\n\n/** Remove keys whose value is `undefined` so they don't shadow defaults when spread. */\nexport function stripUndefined<T extends object>(obj: T): Partial<T> {\n  return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== undefined)) as Partial<T>;\n}\n\nexport function mergeWithDefaults(config: TurnHandlingOptions) {\n  return {\n    turnDetection: config.turnDetection ?? defaultTurnHandlingOptions.turnDetection,\n    endpointing: { ...defaultEndpointingOptions, ...stripUndefined(config.endpointing) },\n    interruption: { ...defaultInterruptionOptions, ...stripUndefined(config.interruption) },\n  } as const;\n}\n\n/**\n * Build a partial {@link TurnHandlingOptions} from deprecated Agent constructor fields.\n * Mirrors the Python Agent compatibility path, but keeps the JS API surface explicit.\n */\nexport function migrateTurnHandling(opts: {\n  turnDetection?: TurnDetectionMode;\n  allowInterruptions?: boolean;\n  minEndpointingDelay?: number;\n  maxEndpointingDelay?: number;\n  turnHandling?: TurnHandlingOptions;\n}): Partial<TurnHandlingOptions> {\n  if (opts.turnHandling !== undefined) {\n    return opts.turnHandling;\n  }\n\n  const migrated: Partial<TurnHandlingOptions> = {};\n\n  const endpointing: Partial<TurnHandlingOptions['endpointing']> = {};\n  if (opts.minEndpointingDelay !== undefined) {\n    endpointing.minDelay = opts.minEndpointingDelay;\n  }\n  if (opts.maxEndpointingDelay !== undefined) {\n    endpointing.maxDelay = opts.maxEndpointingDelay;\n  }\n  if (Object.keys(endpointing).length > 0) {\n    migrated.endpointing = endpointing;\n  }\n\n  const interruption: Partial<TurnHandlingOptions['interruption']> = {};\n  if (opts.allowInterruptions === false) {\n    interruption.enabled = false;\n  }\n  if (Object.keys(interruption).length > 0) {\n    migrated.interruption = interruption;\n  }\n\n  if (opts.turnDetection !== undefined) {\n    migrated.turnDetection = opts.turnDetection;\n  }\n\n  return {\n    ...(migrated.endpointing ? { endpointing: migrated.endpointing } : {}),\n    ...(migrated.interruption ? { interruption: migrated.interruption } : {}),\n    ...(migrated.turnDetection !== undefined ? { turnDetection: migrated.turnDetection } : {}),\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/voice/turn_config/utils.d.cts

@@ -0,0 +1,37 @@
+import { type AgentSessionOptions, type InternalSessionOptions, type TurnDetectionMode, type VoiceOptions } from '../agent_session.js';
+import { type TurnHandlingOptions } from './turn_handling.js';
+export declare function migrateLegacyOptions<UserData>(legacyOptions: AgentSessionOptions<UserData>): {
+    agentSessionOptions: InternalSessionOptions<UserData>;
+    legacyVoiceOptions: VoiceOptions;
+};
+/** Remove keys whose value is `undefined` so they don't shadow defaults when spread. */
+export declare function stripUndefined<T extends object>(obj: T): Partial<T>;
+export declare function mergeWithDefaults(config: TurnHandlingOptions): {
+    readonly turnDetection: TurnDetectionMode | undefined;
+    readonly endpointing: {
+        mode: "fixed" | "dynamic";
+        minDelay: number;
+        maxDelay: number;
+    };
+    readonly interruption: {
+        enabled: boolean;
+        mode: "vad" | "adaptive" | undefined;
+        discardAudioIfUninterruptible: boolean;
+        minDuration: number;
+        minWords: number;
+        falseInterruptionTimeout: number;
+        resumeFalseInterruption: boolean;
+    };
+};
+/**
+ * Build a partial {@link TurnHandlingOptions} from deprecated Agent constructor fields.
+ * Mirrors the Python Agent compatibility path, but keeps the JS API surface explicit.
+ */
+export declare function migrateTurnHandling(opts: {
+    turnDetection?: TurnDetectionMode;
+    allowInterruptions?: boolean;
+    minEndpointingDelay?: number;
+    maxEndpointingDelay?: number;
+    turnHandling?: TurnHandlingOptions;
+}): Partial<TurnHandlingOptions>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/voice/turn_config/utils.d.ts

@@ -0,0 +1,37 @@
+import { type AgentSessionOptions, type InternalSessionOptions, type TurnDetectionMode, type VoiceOptions } from '../agent_session.js';
+import { type TurnHandlingOptions } from './turn_handling.js';
+export declare function migrateLegacyOptions<UserData>(legacyOptions: AgentSessionOptions<UserData>): {
+    agentSessionOptions: InternalSessionOptions<UserData>;
+    legacyVoiceOptions: VoiceOptions;
+};
+/** Remove keys whose value is `undefined` so they don't shadow defaults when spread. */
+export declare function stripUndefined<T extends object>(obj: T): Partial<T>;
+export declare function mergeWithDefaults(config: TurnHandlingOptions): {
+    readonly turnDetection: TurnDetectionMode | undefined;
+    readonly endpointing: {
+        mode: "fixed" | "dynamic";
+        minDelay: number;
+        maxDelay: number;
+    };
+    readonly interruption: {
+        enabled: boolean;
+        mode: "vad" | "adaptive" | undefined;
+        discardAudioIfUninterruptible: boolean;
+        minDuration: number;
+        minWords: number;
+        falseInterruptionTimeout: number;
+        resumeFalseInterruption: boolean;
+    };
+};
+/**
+ * Build a partial {@link TurnHandlingOptions} from deprecated Agent constructor fields.
+ * Mirrors the Python Agent compatibility path, but keeps the JS API surface explicit.
+ */
+export declare function migrateTurnHandling(opts: {
+    turnDetection?: TurnDetectionMode;
+    allowInterruptions?: boolean;
+    minEndpointingDelay?: number;
+    maxEndpointingDelay?: number;
+    turnHandling?: TurnHandlingOptions;
+}): Partial<TurnHandlingOptions>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/voice/turn_config/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/voice/turn_config/utils.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,KAAK,mBAAmB,EAA8B,MAAM,oBAAoB,CAAC;AAkB1F,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,aAAa,EAAE,mBAAmB,CAAC,QAAQ,CAAC,GAAG;IAC5F,mBAAmB,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IACtD,kBAAkB,EAAE,YAAY,CAAC;CAClC,CAyEA;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEnE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,mBAAmB;;;;;;;;;;;;;;;;EAM5D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAmC/B"}