@livekit/agents 1.0.47 → 1.1.0-dev.0

package/dist/voice/turn_config/utils.js

@@ -0,0 +1,73 @@
+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";
+function migrateLegacyOptions(legacyOptions) {
+  var _a, _b;
+  const logger = log();
+  const { voiceOptions, turnDetection, options: sessionOptions, ...rest } = legacyOptions;
+  if (voiceOptions !== void 0 && sessionOptions !== void 0) {
+    logger.warn(
+      "Both voiceOptions and options have been supplied as part of the AgentSessionOptions, voiceOptions will be merged with options taking precedence"
+    );
+  }
+  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
+    },
+    endpointing: {
+      minDelay: mergedOptions == null ? void 0 : mergedOptions.minEndpointingDelay,
+      maxDelay: mergedOptions == null ? void 0 : mergedOptions.maxEndpointingDelay
+    },
+    ...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
+  };
+  if ((mergedOptions == null ? void 0 : mergedOptions.allowInterruptions) === false) {
+    turnHandling.interruption.enabled = false;
+  }
+  const optionsWithDefaults = {
+    ...defaultSessionOptions,
+    ...mergedOptions,
+    turnHandling: mergeWithDefaults(turnHandling)
+  };
+  const newAgentSessionOptions = {
+    ...rest,
+    options: optionsWithDefaults,
+    voiceOptions: optionsWithDefaults,
+    turnDetection: turnHandling.turnDetection
+  };
+  return newAgentSessionOptions;
+}
+function stripUndefined(obj) {
+  return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== void 0));
+}
+function mergeWithDefaults(config) {
+  return {
+    turnDetection: config.turnDetection ?? defaultTurnHandlingOptions.turnDetection,
+    endpointing: { ...defaultEndpointingOptions, ...stripUndefined(config.endpointing) },
+    interruption: { ...defaultInterruptionOptions, ...stripUndefined(config.interruption) }
+  };
+}
+export {
+  mergeWithDefaults,
+  migrateLegacyOptions,
+  stripUndefined
+};
+//# sourceMappingURL=utils.js.map

package/dist/voice/turn_config/utils.js.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  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":[]}

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

@@ -0,0 +1,86 @@
+"use strict";
+var import_vitest = require("vitest");
+var import_log = require("../../log.cjs");
+var import_endpointing = require("./endpointing.cjs");
+var import_interruption = require("./interruption.cjs");
+var import_turn_handling = require("./turn_handling.cjs");
+var import_utils = require("./utils.cjs");
+(0, import_vitest.beforeAll)(() => {
+  (0, import_log.initializeLogger)({ pretty: true, level: "info" });
+});
+(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({
+      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.it)("should migrate legacy flat fields into nested turnHandling config", () => {
+    const result = (0, import_utils.migrateLegacyOptions)({
+      voiceOptions: {
+        minInterruptionDuration: 1e3,
+        minInterruptionWords: 3,
+        discardAudioIfUninterruptible: false,
+        minEndpointingDelay: 800,
+        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.it)("should set interruption.enabled to false when allowInterruptions is false", () => {
+    const result = (0, import_utils.migrateLegacyOptions)({
+      options: {
+        allowInterruptions: false
+      }
+    });
+    (0, import_vitest.expect)(result.options.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)({
+      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 }
+        }
+      }
+    });
+    (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.it)("should preserve top-level turnDetection in the result", () => {
+    const result = (0, import_utils.migrateLegacyOptions)({
+      turnDetection: "vad"
+    });
+    (0, import_vitest.expect)(result.turnDetection).toBe("vad");
+    (0, import_vitest.expect)(result.options.turnHandling.turnDetection).toBe("vad");
+  });
+});
+//# sourceMappingURL=utils.test.cjs.map

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

@@ -0,0 +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":[]}

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

@@ -0,0 +1,85 @@
+import { beforeAll, describe, expect, it } from "vitest";
+import { initializeLogger } from "../../log.js";
+import { defaultEndpointingOptions } from "./endpointing.js";
+import { defaultInterruptionOptions } from "./interruption.js";
+import { defaultTurnHandlingOptions } from "./turn_handling.js";
+import { migrateLegacyOptions } from "./utils.js";
+beforeAll(() => {
+  initializeLogger({ pretty: true, level: "info" });
+});
+describe("migrateLegacyOptions", () => {
+  it("should return all defaults when no options are provided", () => {
+    const result = migrateLegacyOptions({});
+    expect(result.options.turnHandling).toEqual({
+      turnDetection: defaultTurnHandlingOptions.turnDetection,
+      endpointing: defaultEndpointingOptions,
+      interruption: defaultInterruptionOptions
+    });
+    expect(result.options.maxToolSteps).toBe(3);
+    expect(result.options.preemptiveGeneration).toBe(false);
+    expect(result.options.userAwayTimeout).toBe(15);
+  });
+  it("should migrate legacy flat fields into nested turnHandling config", () => {
+    const result = migrateLegacyOptions({
+      voiceOptions: {
+        minInterruptionDuration: 1e3,
+        minInterruptionWords: 3,
+        discardAudioIfUninterruptible: false,
+        minEndpointingDelay: 800,
+        maxEndpointingDelay: 5e3
+      }
+    });
+    expect(result.options.turnHandling.interruption.minDuration).toBe(1e3);
+    expect(result.options.turnHandling.interruption.minWords).toBe(3);
+    expect(result.options.turnHandling.interruption.discardAudioIfUninterruptible).toBe(false);
+    expect(result.options.turnHandling.endpointing.minDelay).toBe(800);
+    expect(result.options.turnHandling.endpointing.maxDelay).toBe(5e3);
+  });
+  it("should set interruption.enabled to false when allowInterruptions is false", () => {
+    const result = migrateLegacyOptions({
+      options: {
+        allowInterruptions: false
+      }
+    });
+    expect(result.options.turnHandling.interruption.enabled).toBe(false);
+  });
+  it("should give options precedence over voiceOptions when both are provided", () => {
+    const result = migrateLegacyOptions({
+      voiceOptions: {
+        minInterruptionDuration: 1e3,
+        maxEndpointingDelay: 5e3,
+        maxToolSteps: 10
+      },
+      options: {
+        minInterruptionDuration: 2e3,
+        maxEndpointingDelay: 8e3,
+        maxToolSteps: 5
+      }
+    });
+    expect(result.options.turnHandling.interruption.minDuration).toBe(2e3);
+    expect(result.options.turnHandling.endpointing.maxDelay).toBe(8e3);
+    expect(result.options.maxToolSteps).toBe(5);
+  });
+  it("should let explicit turnHandling override legacy flat fields", () => {
+    const result = migrateLegacyOptions({
+      options: {
+        minInterruptionDuration: 1e3,
+        minEndpointingDelay: 800,
+        turnHandling: {
+          interruption: { minDuration: 3e3 },
+          endpointing: { minDelay: 2e3 }
+        }
+      }
+    });
+    expect(result.options.turnHandling.interruption.minDuration).toBe(3e3);
+    expect(result.options.turnHandling.endpointing.minDelay).toBe(2e3);
+  });
+  it("should preserve top-level turnDetection in the result", () => {
+    const result = migrateLegacyOptions({
+      turnDetection: "vad"
+    });
+    expect(result.turnDetection).toBe("vad");
+    expect(result.options.turnHandling.turnDetection).toBe("vad");
+  });
+});
+//# sourceMappingURL=utils.test.js.map

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

@@ -0,0 +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":[]}