@livekit/agents 1.1.0-dev.0 → 1.2.0

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

@@ -1 +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  defaultSessionOptions,\n} from '../agent_session.js';\nimport { defaultEndpointingOptions } from './endpointing.js';\nimport { defaultInterruptionOptions } from './interruption.js';\nimport { type TurnHandlingOptions, defaultTurnHandlingOptions } from './turn_handling.js';\n\nexport function migrateLegacyOptions<UserData>(\n  legacyOptions: AgentSessionOptions<UserData>,\n): AgentSessionOptions<UserData> & { options: InternalSessionOptions } {\n  const logger = log();\n  const { voiceOptions, turnDetection, options: sessionOptions, ...rest } = legacyOptions;\n\n  if (voiceOptions !== undefined && sessionOptions !== undefined) {\n    logger.warn(\n      'Both voiceOptions and options have been supplied as part of the AgentSessionOptions, voiceOptions will be merged with options taking precedence',\n    );\n  }\n\n  // Preserve turnDetection before cloning since structuredClone converts class instances to plain objects\n  const originalTurnDetection =\n    sessionOptions?.turnHandling?.turnDetection ??\n    voiceOptions?.turnHandling?.turnDetection ??\n    turnDetection;\n\n  // Exclude potentially non-cloneable turnDetection objects before structuredClone.\n  // They are restored from originalTurnDetection below.\n  const cloneableVoiceOptions = voiceOptions\n    ? {\n        ...voiceOptions,\n        turnHandling: voiceOptions.turnHandling\n          ? { ...voiceOptions.turnHandling, turnDetection: undefined }\n          : voiceOptions.turnHandling,\n      }\n    : voiceOptions;\n  const cloneableSessionOptions = sessionOptions\n    ? {\n        ...sessionOptions,\n        turnHandling: sessionOptions.turnHandling\n          ? { ...sessionOptions.turnHandling, turnDetection: undefined }\n          : sessionOptions.turnHandling,\n      }\n    : sessionOptions;\n\n  const mergedOptions = structuredClone({ ...cloneableVoiceOptions, ...cloneableSessionOptions });\n\n  const turnHandling: TurnHandlingOptions = {\n    interruption: {\n      discardAudioIfUninterruptible: mergedOptions?.discardAudioIfUninterruptible,\n      minDuration: mergedOptions?.minInterruptionDuration,\n      minWords: mergedOptions?.minInterruptionWords,\n    },\n    endpointing: {\n      minDelay: mergedOptions?.minEndpointingDelay,\n      maxDelay: mergedOptions?.maxEndpointingDelay,\n    },\n\n    ...mergedOptions.turnHandling,\n    // Restore original turnDetection after spread to preserve class instance with methods\n    // (structuredClone converts class instances to plain objects, losing prototype methods)\n    turnDetection: originalTurnDetection,\n  } as const;\n\n  if (mergedOptions?.allowInterruptions === false) {\n    turnHandling.interruption.enabled = false;\n  }\n\n  const optionsWithDefaults = {\n    ...defaultSessionOptions,\n    ...mergedOptions,\n    turnHandling: mergeWithDefaults(turnHandling),\n  };\n\n  const newAgentSessionOptions: AgentSessionOptions<UserData> & {\n    options: InternalSessionOptions;\n  } = {\n    ...rest,\n    options: optionsWithDefaults,\n    voiceOptions: optionsWithDefaults,\n    turnDetection: turnHandling.turnDetection,\n  };\n\n  return newAgentSessionOptions;\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"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,iBAAoB;AACpB,2BAIO;AACP,yBAA0C;AAC1C,0BAA2C;AAC3C,2BAAqE;AAE9D,SAAS,qBACd,eACqE;AAfvE;AAgBE,QAAM,aAAS,gBAAI;AACnB,QAAM,EAAE,cAAc,eAAe,SAAS,gBAAgB,GAAG,KAAK,IAAI;AAE1E,MAAI,iBAAiB,UAAa,mBAAmB,QAAW;AAC9D,WAAO;AAAA,MACL;AAAA,IACF;AAAA,EACF;AAGA,QAAM,0BACJ,sDAAgB,iBAAhB,mBAA8B,oBAC9B,kDAAc,iBAAd,mBAA4B,kBAC5B;AAIF,QAAM,wBAAwB,eAC1B;AAAA,IACE,GAAG;AAAA,IACH,cAAc,aAAa,eACvB,EAAE,GAAG,aAAa,cAAc,eAAe,OAAU,IACzD,aAAa;AAAA,EACnB,IACA;AACJ,QAAM,0BAA0B,iBAC5B;AAAA,IACE,GAAG;AAAA,IACH,cAAc,eAAe,eACzB,EAAE,GAAG,eAAe,cAAc,eAAe,OAAU,IAC3D,eAAe;AAAA,EACrB,IACA;AAEJ,QAAM,gBAAgB,gBAAgB,EAAE,GAAG,uBAAuB,GAAG,wBAAwB,CAAC;AAE9F,QAAM,eAAoC;AAAA,IACxC,cAAc;AAAA,MACZ,+BAA+B,+CAAe;AAAA,MAC9C,aAAa,+CAAe;AAAA,MAC5B,UAAU,+CAAe;AAAA,IAC3B;AAAA,IACA,aAAa;AAAA,MACX,UAAU,+CAAe;AAAA,MACzB,UAAU,+CAAe;AAAA,IAC3B;AAAA,IAEA,GAAG,cAAc;AAAA;AAAA;AAAA,IAGjB,eAAe;AAAA,EACjB;AAEA,OAAI,+CAAe,wBAAuB,OAAO;AAC/C,iBAAa,aAAa,UAAU;AAAA,EACtC;AAEA,QAAM,sBAAsB;AAAA,IAC1B,GAAG;AAAA,IACH,GAAG;AAAA,IACH,cAAc,kBAAkB,YAAY;AAAA,EAC9C;AAEA,QAAM,yBAEF;AAAA,IACF,GAAG;AAAA,IACH,SAAS;AAAA,IACT,cAAc;AAAA,IACd,eAAe,aAAa;AAAA,EAC9B;AAEA,SAAO;AACT;AAGO,SAAS,eAAiC,KAAoB;AACnE,SAAO,OAAO,YAAY,OAAO,QAAQ,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,MAAM,MAAS,CAAC;AAClF;AAEO,SAAS,kBAAkB,QAA6B;AAC7D,SAAO;AAAA,IACL,eAAe,OAAO,iBAAiB,gDAA2B;AAAA,IAClE,aAAa,EAAE,GAAG,8CAA2B,GAAG,eAAe,OAAO,WAAW,EAAE;AAAA,IACnF,cAAc,EAAE,GAAG,gDAA4B,GAAG,eAAe,OAAO,YAAY,EAAE;AAAA,EACxF;AACF;","names":[]}
+{"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":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,iBAAoB;AACpB,2BAKO;AACP,yBAA0C;AAC1C,0BAA2C;AAC3C,2BAAqE;AAErE,MAAM,wBAAwB;AAAA,EAC5B,cAAc;AAAA,EACd,sBAAsB;AAAA,EACtB,iBAAiB;AAAA,EACjB,mBAAmB;AAAA,EACnB,cAAc,CAAC;AAAA,EACf,yBAAyB;AAC3B;AAEA,MAAM,4BAA0C;AAAA,EAC9C,qBAAqB,gDAA2B,YAAY;AAAA,EAC5D,qBAAqB,gDAA2B,YAAY;AAAA,EAC5D,cAAc,sBAAsB;AAAA,EACpC,sBAAsB,sBAAsB;AAC9C;AAEO,SAAS,qBAA+B,eAG7C;AAjCF;AAkCE,QAAM,aAAS,gBAAI;AACnB,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAG;AAAA,EACL,IAAI;AAEJ,MAAI,iBAAiB,QAAW;AAC9B,WAAO;AAAA,MACL;AAAA,IACF;AAAA,EACF;AAEA,QAAM,eAAoC;AAAA,IACxC,cAAc;AAAA,MACZ,+BAA+B,6CAAc;AAAA,MAC7C,aAAa,6CAAc;AAAA,MAC3B,UAAU,6CAAc;AAAA,MACxB,IAAG,oBAAe,iBAAf,mBAA6B;AAAA,IAClC;AAAA,IACA,aAAa;AAAA,MACX,UAAU,6CAAc;AAAA,MACxB,UAAU,6CAAc;AAAA,MACxB,IAAG,oBAAe,iBAAf,mBAA6B;AAAA,IAClC;AAAA,IAEA,iBAAe,sDAAgB,iBAAhB,mBAA8B,kBAAiB;AAAA,EAChE;AAEA,OACE,6CAAc,wBAAuB,SACrC,aAAa,aAAa,YAAY,QACtC;AACA,iBAAa,aAAa,UAAU;AAAA,EACtC;AAEA,QAAM,uBAAsD,CAAC;AAE7D,OAAI,6CAAc,kBAAiB,QAAW;AAC5C,yBAAqB,eAAe,aAAa;AAAA,EACnD;AACA,OAAI,6CAAc,0BAAyB,QAAW;AACpD,yBAAqB,uBAAuB,aAAa;AAAA,EAC3D;AACA,OAAI,6CAAc,qBAAoB,QAAW;AAC/C,yBAAqB,kBAAkB,aAAa;AAAA,EACtD;AAEA,QAAM,qBAAqB,EAAE,GAAG,2BAA2B,GAAG,aAAa;AAE3E,QAAM,sBAAsB;AAAA,IAC1B;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,IACH,cAAc,kBAAkB,YAAY;AAAA;AAAA,IAE5C,cAAc;AAAA,EAChB;AAEA,SAAO,EAAE,qBAAqB,mBAAmB;AACnD;AAGO,SAAS,eAAiC,KAAoB;AACnE,SAAO,OAAO,YAAY,OAAO,QAAQ,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,MAAM,MAAS,CAAC;AAClF;AAEO,SAAS,kBAAkB,QAA6B;AAC7D,SAAO;AAAA,IACL,eAAe,OAAO,iBAAiB,gDAA2B;AAAA,IAClE,aAAa,EAAE,GAAG,8CAA2B,GAAG,eAAe,OAAO,WAAW,EAAE;AAAA,IACnF,cAAc,EAAE,GAAG,gDAA4B,GAAG,eAAe,OAAO,YAAY,EAAE;AAAA,EACxF;AACF;AAMO,SAAS,oBAAoB,MAMH;AAC/B,MAAI,KAAK,iBAAiB,QAAW;AACnC,WAAO,KAAK;AAAA,EACd;AAEA,QAAM,WAAyC,CAAC;AAEhD,QAAM,cAA2D,CAAC;AAClE,MAAI,KAAK,wBAAwB,QAAW;AAC1C,gBAAY,WAAW,KAAK;AAAA,EAC9B;AACA,MAAI,KAAK,wBAAwB,QAAW;AAC1C,gBAAY,WAAW,KAAK;AAAA,EAC9B;AACA,MAAI,OAAO,KAAK,WAAW,EAAE,SAAS,GAAG;AACvC,aAAS,cAAc;AAAA,EACzB;AAEA,QAAM,eAA6D,CAAC;AACpE,MAAI,KAAK,uBAAuB,OAAO;AACrC,iBAAa,UAAU;AAAA,EACzB;AACA,MAAI,OAAO,KAAK,YAAY,EAAE,SAAS,GAAG;AACxC,aAAS,eAAe;AAAA,EAC1B;AAEA,MAAI,KAAK,kBAAkB,QAAW;AACpC,aAAS,gBAAgB,KAAK;AAAA,EAChC;AAEA,SAAO;AAAA,IACL,GAAI,SAAS,cAAc,EAAE,aAAa,SAAS,YAAY,IAAI,CAAC;AAAA,IACpE,GAAI,SAAS,eAAe,EAAE,cAAc,SAAS,aAAa,IAAI,CAAC;AAAA,IACvE,GAAI,SAAS,kBAAkB,SAAY,EAAE,eAAe,SAAS,cAAc,IAAI,CAAC;AAAA,EAC1F;AACF;","names":[]}

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

@@ -1,12 +1,13 @@
-import { type AgentSessionOptions, type InternalSessionOptions } from '../agent_session.js';
+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<UserData> & {
-    options: InternalSessionOptions;
+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: import("../agent_session.js").TurnDetectionMode | undefined;
+    readonly turnDetection: TurnDetectionMode | undefined;
     readonly endpointing: {
         mode: "fixed" | "dynamic";
         minDelay: number;
@@ -14,7 +15,7 @@ export declare function mergeWithDefaults(config: TurnHandlingOptions): {
     };
     readonly interruption: {
         enabled: boolean;
-        mode: false | "vad" | "adaptive" | undefined;
+        mode: "vad" | "adaptive" | undefined;
         discardAudioIfUninterruptible: boolean;
         minDuration: number;
         minWords: number;
@@ -22,4 +23,15 @@ export declare function mergeWithDefaults(config: TurnHandlingOptions): {
         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

@@ -1,12 +1,13 @@
-import { type AgentSessionOptions, type InternalSessionOptions } from '../agent_session.js';
+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<UserData> & {
-    options: InternalSessionOptions;
+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: import("../agent_session.js").TurnDetectionMode | undefined;
+    readonly turnDetection: TurnDetectionMode | undefined;
     readonly endpointing: {
         mode: "fixed" | "dynamic";
         minDelay: number;
@@ -14,7 +15,7 @@ export declare function mergeWithDefaults(config: TurnHandlingOptions): {
     };
     readonly interruption: {
         enabled: boolean;
-        mode: false | "vad" | "adaptive" | undefined;
+        mode: "vad" | "adaptive" | undefined;
         discardAudioIfUninterruptible: boolean;
         minDuration: number;
         minWords: number;
@@ -22,4 +23,15 @@ export declare function mergeWithDefaults(config: TurnHandlingOptions): {
         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

@@ -1 +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,EAE5B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,KAAK,mBAAmB,EAA8B,MAAM,oBAAoB,CAAC;AAE1F,wBAAgB,oBAAoB,CAAC,QAAQ,EAC3C,aAAa,EAAE,mBAAmB,CAAC,QAAQ,CAAC,GAC3C,mBAAmB,CAAC,QAAQ,CAAC,GAAG;IAAE,OAAO,EAAE,sBAAsB,CAAA;CAAE,CA0ErE;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"}
+{"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"}

package/dist/voice/turn_config/utils.js

@@ -1,59 +1,85 @@
 import { log } from "../../log.js";
 import {
-  defaultSessionOptions
 } from "../agent_session.js";
 import { defaultEndpointingOptions } from "./endpointing.js";
 import { defaultInterruptionOptions } from "./interruption.js";
 import { defaultTurnHandlingOptions } from "./turn_handling.js";
+const defaultSessionOptions = {
+  maxToolSteps: 3,
+  preemptiveGeneration: true,
+  userAwayTimeout: 15,
+  aecWarmupDuration: 3e3,
+  turnHandling: {},
+  useTtsAlignedTranscript: true
+};
+const defaultLegacyVoiceOptions = {
+  minEndpointingDelay: defaultTurnHandlingOptions.endpointing.minDelay,
+  maxEndpointingDelay: defaultTurnHandlingOptions.endpointing.maxDelay,
+  maxToolSteps: defaultSessionOptions.maxToolSteps,
+  preemptiveGeneration: defaultSessionOptions.preemptiveGeneration
+};
 function migrateLegacyOptions(legacyOptions) {
-  var _a, _b;
+  var _a, _b, _c;
   const logger = log();
-  const { voiceOptions, turnDetection, options: sessionOptions, ...rest } = legacyOptions;
-  if (voiceOptions !== void 0 && sessionOptions !== void 0) {
+  const {
+    voiceOptions,
+    turnDetection,
+    stt,
+    vad,
+    llm,
+    tts,
+    userData,
+    connOptions,
+    ...sessionOptions
+  } = legacyOptions;
+  if (voiceOptions !== void 0) {
     logger.warn(
-      "Both voiceOptions and options have been supplied as part of the AgentSessionOptions, voiceOptions will be merged with options taking precedence"
+      "voiceOptions is deprecated, use top-level SessionOptions fields on AgentSessionOptions instead"
     );
   }
-  const originalTurnDetection = ((_a = sessionOptions == null ? void 0 : sessionOptions.turnHandling) == null ? void 0 : _a.turnDetection) ?? ((_b = voiceOptions == null ? void 0 : voiceOptions.turnHandling) == null ? void 0 : _b.turnDetection) ?? turnDetection;
-  const cloneableVoiceOptions = voiceOptions ? {
-    ...voiceOptions,
-    turnHandling: voiceOptions.turnHandling ? { ...voiceOptions.turnHandling, turnDetection: void 0 } : voiceOptions.turnHandling
-  } : voiceOptions;
-  const cloneableSessionOptions = sessionOptions ? {
-    ...sessionOptions,
-    turnHandling: sessionOptions.turnHandling ? { ...sessionOptions.turnHandling, turnDetection: void 0 } : sessionOptions.turnHandling
-  } : sessionOptions;
-  const mergedOptions = structuredClone({ ...cloneableVoiceOptions, ...cloneableSessionOptions });
   const turnHandling = {
     interruption: {
-      discardAudioIfUninterruptible: mergedOptions == null ? void 0 : mergedOptions.discardAudioIfUninterruptible,
-      minDuration: mergedOptions == null ? void 0 : mergedOptions.minInterruptionDuration,
-      minWords: mergedOptions == null ? void 0 : mergedOptions.minInterruptionWords
+      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: mergedOptions == null ? void 0 : mergedOptions.minEndpointingDelay,
-      maxDelay: mergedOptions == null ? void 0 : mergedOptions.maxEndpointingDelay
+      minDelay: voiceOptions == null ? void 0 : voiceOptions.minEndpointingDelay,
+      maxDelay: voiceOptions == null ? void 0 : voiceOptions.maxEndpointingDelay,
+      ...(_b = sessionOptions.turnHandling) == null ? void 0 : _b.endpointing
     },
-    ...mergedOptions.turnHandling,
-    // Restore original turnDetection after spread to preserve class instance with methods
-    // (structuredClone converts class instances to plain objects, losing prototype methods)
-    turnDetection: originalTurnDetection
+    turnDetection: ((_c = sessionOptions == null ? void 0 : sessionOptions.turnHandling) == null ? void 0 : _c.turnDetection) ?? turnDetection
   };
-  if ((mergedOptions == null ? void 0 : mergedOptions.allowInterruptions) === false) {
+  if ((voiceOptions == null ? void 0 : voiceOptions.allowInterruptions) === false && turnHandling.interruption.enabled === void 0) {
     turnHandling.interruption.enabled = false;
   }
-  const optionsWithDefaults = {
+  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,
-    ...mergedOptions,
-    turnHandling: mergeWithDefaults(turnHandling)
-  };
-  const newAgentSessionOptions = {
-    ...rest,
-    options: optionsWithDefaults,
-    voiceOptions: optionsWithDefaults,
-    turnDetection: turnHandling.turnDetection
+    ...migratedVoiceOptions,
+    ...sessionOptions,
+    turnHandling: mergeWithDefaults(turnHandling),
+    // repopulate the deprecated voice options with migrated options for backwards compatibility
+    voiceOptions: legacyVoiceOptions
   };
-  return newAgentSessionOptions;
+  return { agentSessionOptions, legacyVoiceOptions };
 }
 function stripUndefined(obj) {
   return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== void 0));
@@ -65,9 +91,41 @@ function mergeWithDefaults(config) {
     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 } : {}
+  };
+}
 export {
   mergeWithDefaults,
   migrateLegacyOptions,
+  migrateTurnHandling,
   stripUndefined
 };
 //# sourceMappingURL=utils.js.map

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

@@ -1 +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  defaultSessionOptions,\n} from '../agent_session.js';\nimport { defaultEndpointingOptions } from './endpointing.js';\nimport { defaultInterruptionOptions } from './interruption.js';\nimport { type TurnHandlingOptions, defaultTurnHandlingOptions } from './turn_handling.js';\n\nexport function migrateLegacyOptions<UserData>(\n  legacyOptions: AgentSessionOptions<UserData>,\n): AgentSessionOptions<UserData> & { options: InternalSessionOptions } {\n  const logger = log();\n  const { voiceOptions, turnDetection, options: sessionOptions, ...rest } = legacyOptions;\n\n  if (voiceOptions !== undefined && sessionOptions !== undefined) {\n    logger.warn(\n      'Both voiceOptions and options have been supplied as part of the AgentSessionOptions, voiceOptions will be merged with options taking precedence',\n    );\n  }\n\n  // Preserve turnDetection before cloning since structuredClone converts class instances to plain objects\n  const originalTurnDetection =\n    sessionOptions?.turnHandling?.turnDetection ??\n    voiceOptions?.turnHandling?.turnDetection ??\n    turnDetection;\n\n  // Exclude potentially non-cloneable turnDetection objects before structuredClone.\n  // They are restored from originalTurnDetection below.\n  const cloneableVoiceOptions = voiceOptions\n    ? {\n        ...voiceOptions,\n        turnHandling: voiceOptions.turnHandling\n          ? { ...voiceOptions.turnHandling, turnDetection: undefined }\n          : voiceOptions.turnHandling,\n      }\n    : voiceOptions;\n  const cloneableSessionOptions = sessionOptions\n    ? {\n        ...sessionOptions,\n        turnHandling: sessionOptions.turnHandling\n          ? { ...sessionOptions.turnHandling, turnDetection: undefined }\n          : sessionOptions.turnHandling,\n      }\n    : sessionOptions;\n\n  const mergedOptions = structuredClone({ ...cloneableVoiceOptions, ...cloneableSessionOptions });\n\n  const turnHandling: TurnHandlingOptions = {\n    interruption: {\n      discardAudioIfUninterruptible: mergedOptions?.discardAudioIfUninterruptible,\n      minDuration: mergedOptions?.minInterruptionDuration,\n      minWords: mergedOptions?.minInterruptionWords,\n    },\n    endpointing: {\n      minDelay: mergedOptions?.minEndpointingDelay,\n      maxDelay: mergedOptions?.maxEndpointingDelay,\n    },\n\n    ...mergedOptions.turnHandling,\n    // Restore original turnDetection after spread to preserve class instance with methods\n    // (structuredClone converts class instances to plain objects, losing prototype methods)\n    turnDetection: originalTurnDetection,\n  } as const;\n\n  if (mergedOptions?.allowInterruptions === false) {\n    turnHandling.interruption.enabled = false;\n  }\n\n  const optionsWithDefaults = {\n    ...defaultSessionOptions,\n    ...mergedOptions,\n    turnHandling: mergeWithDefaults(turnHandling),\n  };\n\n  const newAgentSessionOptions: AgentSessionOptions<UserData> & {\n    options: InternalSessionOptions;\n  } = {\n    ...rest,\n    options: optionsWithDefaults,\n    voiceOptions: optionsWithDefaults,\n    turnDetection: turnHandling.turnDetection,\n  };\n\n  return newAgentSessionOptions;\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"],"mappings":"AAGA,SAAS,WAAW;AACpB;AAAA,EAGE;AAAA,OACK;AACP,SAAS,iCAAiC;AAC1C,SAAS,kCAAkC;AAC3C,SAAmC,kCAAkC;AAE9D,SAAS,qBACd,eACqE;AAfvE;AAgBE,QAAM,SAAS,IAAI;AACnB,QAAM,EAAE,cAAc,eAAe,SAAS,gBAAgB,GAAG,KAAK,IAAI;AAE1E,MAAI,iBAAiB,UAAa,mBAAmB,QAAW;AAC9D,WAAO;AAAA,MACL;AAAA,IACF;AAAA,EACF;AAGA,QAAM,0BACJ,sDAAgB,iBAAhB,mBAA8B,oBAC9B,kDAAc,iBAAd,mBAA4B,kBAC5B;AAIF,QAAM,wBAAwB,eAC1B;AAAA,IACE,GAAG;AAAA,IACH,cAAc,aAAa,eACvB,EAAE,GAAG,aAAa,cAAc,eAAe,OAAU,IACzD,aAAa;AAAA,EACnB,IACA;AACJ,QAAM,0BAA0B,iBAC5B;AAAA,IACE,GAAG;AAAA,IACH,cAAc,eAAe,eACzB,EAAE,GAAG,eAAe,cAAc,eAAe,OAAU,IAC3D,eAAe;AAAA,EACrB,IACA;AAEJ,QAAM,gBAAgB,gBAAgB,EAAE,GAAG,uBAAuB,GAAG,wBAAwB,CAAC;AAE9F,QAAM,eAAoC;AAAA,IACxC,cAAc;AAAA,MACZ,+BAA+B,+CAAe;AAAA,MAC9C,aAAa,+CAAe;AAAA,MAC5B,UAAU,+CAAe;AAAA,IAC3B;AAAA,IACA,aAAa;AAAA,MACX,UAAU,+CAAe;AAAA,MACzB,UAAU,+CAAe;AAAA,IAC3B;AAAA,IAEA,GAAG,cAAc;AAAA;AAAA;AAAA,IAGjB,eAAe;AAAA,EACjB;AAEA,OAAI,+CAAe,wBAAuB,OAAO;AAC/C,iBAAa,aAAa,UAAU;AAAA,EACtC;AAEA,QAAM,sBAAsB;AAAA,IAC1B,GAAG;AAAA,IACH,GAAG;AAAA,IACH,cAAc,kBAAkB,YAAY;AAAA,EAC9C;AAEA,QAAM,yBAEF;AAAA,IACF,GAAG;AAAA,IACH,SAAS;AAAA,IACT,cAAc;AAAA,IACd,eAAe,aAAa;AAAA,EAC9B;AAEA,SAAO;AACT;AAGO,SAAS,eAAiC,KAAoB;AACnE,SAAO,OAAO,YAAY,OAAO,QAAQ,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,MAAM,MAAS,CAAC;AAClF;AAEO,SAAS,kBAAkB,QAA6B;AAC7D,SAAO;AAAA,IACL,eAAe,OAAO,iBAAiB,2BAA2B;AAAA,IAClE,aAAa,EAAE,GAAG,2BAA2B,GAAG,eAAe,OAAO,WAAW,EAAE;AAAA,IACnF,cAAc,EAAE,GAAG,4BAA4B,GAAG,eAAe,OAAO,YAAY,EAAE;AAAA,EACxF;AACF;","names":[]}
+{"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.test.cjs

@@ -1,6 +1,7 @@
 "use strict";
 var import_vitest = require("vitest");
 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");
@@ -10,18 +11,18 @@ var import_utils = require("./utils.cjs");
 });
 (0, import_vitest.describe)("migrateLegacyOptions", () => {
   (0, import_vitest.it)("should return all defaults when no options are provided", () => {
-    const result = (0, import_utils.migrateLegacyOptions)({});
-    (0, import_vitest.expect)(result.options.turnHandling).toEqual({
+    const { agentSessionOptions: result } = (0, import_utils.migrateLegacyOptions)({});
+    (0, import_vitest.expect)(result.turnHandling).toEqual({
       turnDetection: import_turn_handling.defaultTurnHandlingOptions.turnDetection,
       endpointing: import_endpointing.defaultEndpointingOptions,
       interruption: import_interruption.defaultInterruptionOptions
     });
-    (0, import_vitest.expect)(result.options.maxToolSteps).toBe(3);
-    (0, import_vitest.expect)(result.options.preemptiveGeneration).toBe(false);
-    (0, import_vitest.expect)(result.options.userAwayTimeout).toBe(15);
+    (0, import_vitest.expect)(result.maxToolSteps).toBe(import_agent_session.defaultAgentSessionOptions.maxToolSteps);
+    (0, import_vitest.expect)(result.preemptiveGeneration).toBe(import_agent_session.defaultAgentSessionOptions.preemptiveGeneration);
+    (0, import_vitest.expect)(result.userAwayTimeout).toBe(import_agent_session.defaultAgentSessionOptions.userAwayTimeout);
   });
   (0, import_vitest.it)("should migrate legacy flat fields into nested turnHandling config", () => {
-    const result = (0, import_utils.migrateLegacyOptions)({
+    const { agentSessionOptions: result } = (0, import_utils.migrateLegacyOptions)({
       voiceOptions: {
         minInterruptionDuration: 1e3,
         minInterruptionWords: 3,
@@ -30,57 +31,98 @@ var import_utils = require("./utils.cjs");
         maxEndpointingDelay: 5e3
       }
     });
-    (0, import_vitest.expect)(result.options.turnHandling.interruption.minDuration).toBe(1e3);
-    (0, import_vitest.expect)(result.options.turnHandling.interruption.minWords).toBe(3);
-    (0, import_vitest.expect)(result.options.turnHandling.interruption.discardAudioIfUninterruptible).toBe(false);
-    (0, import_vitest.expect)(result.options.turnHandling.endpointing.minDelay).toBe(800);
-    (0, import_vitest.expect)(result.options.turnHandling.endpointing.maxDelay).toBe(5e3);
+    (0, import_vitest.expect)(result.turnHandling.interruption.minDuration).toBe(1e3);
+    (0, import_vitest.expect)(result.turnHandling.interruption.minWords).toBe(3);
+    (0, import_vitest.expect)(result.turnHandling.interruption.discardAudioIfUninterruptible).toBe(false);
+    (0, import_vitest.expect)(result.turnHandling.endpointing.minDelay).toBe(800);
+    (0, import_vitest.expect)(result.turnHandling.endpointing.maxDelay).toBe(5e3);
   });
   (0, import_vitest.it)("should set interruption.enabled to false when allowInterruptions is false", () => {
-    const result = (0, import_utils.migrateLegacyOptions)({
-      options: {
-        allowInterruptions: false
-      }
+    const { agentSessionOptions: result } = (0, import_utils.migrateLegacyOptions)({
+      voiceOptions: { allowInterruptions: false }
     });
-    (0, import_vitest.expect)(result.options.turnHandling.interruption.enabled).toBe(false);
+    (0, import_vitest.expect)(result.turnHandling.interruption.enabled).toBe(false);
   });
-  (0, import_vitest.it)("should give options precedence over voiceOptions when both are provided", () => {
-    const result = (0, import_utils.migrateLegacyOptions)({
+  (0, import_vitest.it)("should give top-level fields precedence over voiceOptions", () => {
+    const { agentSessionOptions: result } = (0, import_utils.migrateLegacyOptions)({
       voiceOptions: {
         minInterruptionDuration: 1e3,
         maxEndpointingDelay: 5e3,
         maxToolSteps: 10
       },
-      options: {
-        minInterruptionDuration: 2e3,
-        maxEndpointingDelay: 8e3,
-        maxToolSteps: 5
-      }
-    });
-    (0, import_vitest.expect)(result.options.turnHandling.interruption.minDuration).toBe(2e3);
-    (0, import_vitest.expect)(result.options.turnHandling.endpointing.maxDelay).toBe(8e3);
-    (0, import_vitest.expect)(result.options.maxToolSteps).toBe(5);
-  });
-  (0, import_vitest.it)("should let explicit turnHandling override legacy flat fields", () => {
-    const result = (0, import_utils.migrateLegacyOptions)({
-      options: {
-        minInterruptionDuration: 1e3,
-        minEndpointingDelay: 800,
-        turnHandling: {
-          interruption: { minDuration: 3e3 },
-          endpointing: { minDelay: 2e3 }
+      turnHandling: {
+        interruption: {
+          minDuration: 2e3
+        },
+        endpointing: {
+          maxDelay: 8e3
         }
-      }
+      },
+      maxToolSteps: 5
     });
-    (0, import_vitest.expect)(result.options.turnHandling.interruption.minDuration).toBe(3e3);
-    (0, import_vitest.expect)(result.options.turnHandling.endpointing.minDelay).toBe(2e3);
+    (0, import_vitest.expect)(result.turnHandling.interruption.minDuration).toBe(2e3);
+    (0, import_vitest.expect)(result.turnHandling.endpointing.maxDelay).toBe(8e3);
+    (0, import_vitest.expect)(result.maxToolSteps).toBe(5);
   });
   (0, import_vitest.it)("should preserve top-level turnDetection in the result", () => {
-    const result = (0, import_utils.migrateLegacyOptions)({
+    const { agentSessionOptions: result } = (0, import_utils.migrateLegacyOptions)({
       turnDetection: "vad"
     });
+    (0, import_vitest.expect)(result.turnHandling.turnDetection).toBe("vad");
+  });
+});
+(0, import_vitest.describe)("migrateTurnHandling", () => {
+  (0, import_vitest.it)("should return empty partial when no deprecated Agent fields are given", () => {
+    const result = (0, import_utils.migrateTurnHandling)({});
+    (0, import_vitest.expect)(result).toEqual({});
+  });
+  (0, import_vitest.it)("should set interruption.enabled to false when allowInterruptions is false", () => {
+    const result = (0, import_utils.migrateTurnHandling)({ allowInterruptions: false });
+    (0, import_vitest.expect)(result.interruption).toEqual({ enabled: false });
+    (0, import_vitest.expect)(result.endpointing).toBeUndefined();
+    (0, import_vitest.expect)(result.turnDetection).toBeUndefined();
+  });
+  (0, import_vitest.it)("should not set interruption when allowInterruptions is true or undefined", () => {
+    (0, import_vitest.expect)((0, import_utils.migrateTurnHandling)({ allowInterruptions: true })).toEqual({});
+    (0, import_vitest.expect)((0, import_utils.migrateTurnHandling)({ allowInterruptions: void 0 })).toEqual({});
+  });
+  (0, import_vitest.it)("should map minEndpointingDelay to endpointing.minDelay", () => {
+    const result = (0, import_utils.migrateTurnHandling)({ minEndpointingDelay: 800 });
+    (0, import_vitest.expect)(result.endpointing).toEqual({ minDelay: 800 });
+  });
+  (0, import_vitest.it)("should map maxEndpointingDelay to endpointing.maxDelay", () => {
+    const result = (0, import_utils.migrateTurnHandling)({ maxEndpointingDelay: 5e3 });
+    (0, import_vitest.expect)(result.endpointing).toEqual({ maxDelay: 5e3 });
+  });
+  (0, import_vitest.it)("should pass through turnDetection", () => {
+    const result = (0, import_utils.migrateTurnHandling)({ turnDetection: "vad" });
     (0, import_vitest.expect)(result.turnDetection).toBe("vad");
-    (0, import_vitest.expect)(result.options.turnHandling.turnDetection).toBe("vad");
+  });
+  (0, import_vitest.it)("should combine all deprecated Agent fields", () => {
+    const result = (0, import_utils.migrateTurnHandling)({
+      turnDetection: "stt",
+      allowInterruptions: false,
+      minEndpointingDelay: 400,
+      maxEndpointingDelay: 3e3
+    });
+    (0, import_vitest.expect)(result.turnDetection).toBe("stt");
+    (0, import_vitest.expect)(result.interruption).toEqual({ enabled: false });
+    (0, import_vitest.expect)(result.endpointing).toEqual({ minDelay: 400, maxDelay: 3e3 });
+  });
+  (0, import_vitest.it)("should ignore deprecated Agent fields when explicit turnHandling is provided", () => {
+    const turnHandling = {
+      endpointing: { minDelay: 999, maxDelay: 4e3 },
+      interruption: { enabled: true },
+      turnDetection: "vad"
+    };
+    const result = (0, import_utils.migrateTurnHandling)({
+      turnHandling,
+      turnDetection: "stt",
+      allowInterruptions: false,
+      minEndpointingDelay: 100,
+      maxEndpointingDelay: 200
+    });
+    (0, import_vitest.expect)(result).toEqual(turnHandling);
   });
 });
 //# sourceMappingURL=utils.test.cjs.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/voice/turn_config/utils.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { beforeAll, describe, expect, it } from 'vitest';\nimport { initializeLogger } from '../../log.js';\nimport { defaultEndpointingOptions } from './endpointing.js';\nimport { defaultInterruptionOptions } from './interruption.js';\nimport { defaultTurnHandlingOptions } from './turn_handling.js';\nimport { migrateLegacyOptions } from './utils.js';\n\nbeforeAll(() => {\n  initializeLogger({ pretty: true, level: 'info' });\n});\n\ndescribe('migrateLegacyOptions', () => {\n  it('should return all defaults when no options are provided', () => {\n    const result = migrateLegacyOptions({});\n\n    expect(result.options.turnHandling).toEqual({\n      turnDetection: defaultTurnHandlingOptions.turnDetection,\n      endpointing: defaultEndpointingOptions,\n      interruption: defaultInterruptionOptions,\n    });\n    expect(result.options.maxToolSteps).toBe(3);\n    expect(result.options.preemptiveGeneration).toBe(false);\n    expect(result.options.userAwayTimeout).toBe(15.0);\n  });\n\n  it('should migrate legacy flat fields into nested turnHandling config', () => {\n    const result = migrateLegacyOptions({\n      voiceOptions: {\n        minInterruptionDuration: 1000,\n        minInterruptionWords: 3,\n        discardAudioIfUninterruptible: false,\n        minEndpointingDelay: 800,\n        maxEndpointingDelay: 5000,\n      },\n    });\n\n    expect(result.options.turnHandling.interruption!.minDuration).toBe(1000);\n    expect(result.options.turnHandling.interruption!.minWords).toBe(3);\n    expect(result.options.turnHandling.interruption!.discardAudioIfUninterruptible).toBe(false);\n    expect(result.options.turnHandling.endpointing!.minDelay).toBe(800);\n    expect(result.options.turnHandling.endpointing!.maxDelay).toBe(5000);\n  });\n\n  it('should set interruption.enabled to false when allowInterruptions is false', () => {\n    const result = migrateLegacyOptions({\n      options: {\n        allowInterruptions: false,\n      },\n    });\n\n    expect(result.options.turnHandling.interruption!.enabled).toBe(false);\n  });\n\n  it('should give options precedence over voiceOptions when both are provided', () => {\n    const result = migrateLegacyOptions({\n      voiceOptions: {\n        minInterruptionDuration: 1000,\n        maxEndpointingDelay: 5000,\n        maxToolSteps: 10,\n      },\n      options: {\n        minInterruptionDuration: 2000,\n        maxEndpointingDelay: 8000,\n        maxToolSteps: 5,\n      },\n    });\n\n    expect(result.options.turnHandling.interruption!.minDuration).toBe(2000);\n    expect(result.options.turnHandling.endpointing!.maxDelay).toBe(8000);\n    expect(result.options.maxToolSteps).toBe(5);\n  });\n\n  it('should let explicit turnHandling override legacy flat fields', () => {\n    const result = migrateLegacyOptions({\n      options: {\n        minInterruptionDuration: 1000,\n        minEndpointingDelay: 800,\n        turnHandling: {\n          interruption: { minDuration: 3000 },\n          endpointing: { minDelay: 2000 },\n        },\n      },\n    });\n\n    expect(result.options.turnHandling.interruption!.minDuration).toBe(3000);\n    expect(result.options.turnHandling.endpointing!.minDelay).toBe(2000);\n  });\n\n  it('should preserve top-level turnDetection in the result', () => {\n    const result = migrateLegacyOptions({\n      turnDetection: 'vad',\n    });\n\n    expect(result.turnDetection).toBe('vad');\n    expect(result.options.turnHandling.turnDetection).toBe('vad');\n  });\n});\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/voice/turn_config/utils.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { beforeAll, describe, expect, it } from 'vitest';\nimport { initializeLogger } from '../../log.js';\nimport { defaultAgentSessionOptions } from '../agent_session.js';\nimport { defaultEndpointingOptions } from './endpointing.js';\nimport { defaultInterruptionOptions } from './interruption.js';\nimport { defaultTurnHandlingOptions } from './turn_handling.js';\nimport { migrateLegacyOptions, migrateTurnHandling } from './utils.js';\n\nbeforeAll(() => {\n  initializeLogger({ pretty: true, level: 'info' });\n});\n\ndescribe('migrateLegacyOptions', () => {\n  it('should return all defaults when no options are provided', () => {\n    const { agentSessionOptions: result } = migrateLegacyOptions({});\n\n    expect(result.turnHandling).toEqual({\n      turnDetection: defaultTurnHandlingOptions.turnDetection,\n      endpointing: defaultEndpointingOptions,\n      interruption: defaultInterruptionOptions,\n    });\n    expect(result.maxToolSteps).toBe(defaultAgentSessionOptions.maxToolSteps);\n    expect(result.preemptiveGeneration).toBe(defaultAgentSessionOptions.preemptiveGeneration);\n    expect(result.userAwayTimeout).toBe(defaultAgentSessionOptions.userAwayTimeout);\n  });\n\n  it('should migrate legacy flat fields into nested turnHandling config', () => {\n    const { agentSessionOptions: result } = migrateLegacyOptions({\n      voiceOptions: {\n        minInterruptionDuration: 1000,\n        minInterruptionWords: 3,\n        discardAudioIfUninterruptible: false,\n        minEndpointingDelay: 800,\n        maxEndpointingDelay: 5000,\n      },\n    });\n\n    expect(result.turnHandling.interruption!.minDuration).toBe(1000);\n    expect(result.turnHandling.interruption!.minWords).toBe(3);\n    expect(result.turnHandling.interruption!.discardAudioIfUninterruptible).toBe(false);\n    expect(result.turnHandling.endpointing!.minDelay).toBe(800);\n    expect(result.turnHandling.endpointing!.maxDelay).toBe(5000);\n  });\n\n  it('should set interruption.enabled to false when allowInterruptions is false', () => {\n    const { agentSessionOptions: result } = migrateLegacyOptions({\n      voiceOptions: { allowInterruptions: false },\n    });\n\n    expect(result.turnHandling.interruption!.enabled).toBe(false);\n  });\n\n  it('should give top-level fields precedence over voiceOptions', () => {\n    const { agentSessionOptions: result } = migrateLegacyOptions({\n      voiceOptions: {\n        minInterruptionDuration: 1000,\n        maxEndpointingDelay: 5000,\n        maxToolSteps: 10,\n      },\n      turnHandling: {\n        interruption: {\n          minDuration: 2000,\n        },\n        endpointing: {\n          maxDelay: 8000,\n        },\n      },\n      maxToolSteps: 5,\n    });\n\n    expect(result.turnHandling.interruption!.minDuration).toBe(2000);\n    expect(result.turnHandling.endpointing!.maxDelay).toBe(8000);\n    expect(result.maxToolSteps).toBe(5);\n  });\n\n  it('should preserve top-level turnDetection in the result', () => {\n    const { agentSessionOptions: result } = migrateLegacyOptions({\n      turnDetection: 'vad',\n    });\n\n    expect(result.turnHandling.turnDetection).toBe('vad');\n  });\n});\n\ndescribe('migrateTurnHandling', () => {\n  it('should return empty partial when no deprecated Agent fields are given', () => {\n    const result = migrateTurnHandling({});\n    expect(result).toEqual({});\n  });\n\n  it('should set interruption.enabled to false when allowInterruptions is false', () => {\n    const result = migrateTurnHandling({ allowInterruptions: false });\n    expect(result.interruption).toEqual({ enabled: false });\n    expect(result.endpointing).toBeUndefined();\n    expect(result.turnDetection).toBeUndefined();\n  });\n\n  it('should not set interruption when allowInterruptions is true or undefined', () => {\n    expect(migrateTurnHandling({ allowInterruptions: true })).toEqual({});\n    expect(migrateTurnHandling({ allowInterruptions: undefined })).toEqual({});\n  });\n\n  it('should map minEndpointingDelay to endpointing.minDelay', () => {\n    const result = migrateTurnHandling({ minEndpointingDelay: 800 });\n    expect(result.endpointing).toEqual({ minDelay: 800 });\n  });\n\n  it('should map maxEndpointingDelay to endpointing.maxDelay', () => {\n    const result = migrateTurnHandling({ maxEndpointingDelay: 5000 });\n    expect(result.endpointing).toEqual({ maxDelay: 5000 });\n  });\n\n  it('should pass through turnDetection', () => {\n    const result = migrateTurnHandling({ turnDetection: 'vad' });\n    expect(result.turnDetection).toBe('vad');\n  });\n\n  it('should combine all deprecated Agent fields', () => {\n    const result = migrateTurnHandling({\n      turnDetection: 'stt',\n      allowInterruptions: false,\n      minEndpointingDelay: 400,\n      maxEndpointingDelay: 3000,\n    });\n    expect(result.turnDetection).toBe('stt');\n    expect(result.interruption).toEqual({ enabled: false });\n    expect(result.endpointing).toEqual({ minDelay: 400, maxDelay: 3000 });\n  });\n\n  it('should ignore deprecated Agent fields when explicit turnHandling is provided', () => {\n    const turnHandling = {\n      endpointing: { minDelay: 999, maxDelay: 4000 },\n      interruption: { enabled: true },\n      turnDetection: 'vad' as const,\n    };\n    const result = migrateTurnHandling({\n      turnHandling,\n      turnDetection: 'stt',\n      allowInterruptions: false,\n      minEndpointingDelay: 100,\n      maxEndpointingDelay: 200,\n    });\n    expect(result).toEqual(turnHandling);\n  });\n});\n"],"mappings":"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","names":[]}