@livekit/agents 1.1.0-dev.0 → 1.2.0

package/dist/voice/agent.test.js

@@ -4,7 +4,10 @@ import { tool } from "../llm/index.js";
 import { initializeLogger } from "../log.js";
 import { Task } from "../utils.js";
 import { Agent, AgentTask, _setActivityTaskInfo } from "./agent.js";
-import { agentActivityStorage } from "./agent_activity.js";
+import { AgentActivity, agentActivityStorage } from "./agent_activity.js";
+import { defaultEndpointingOptions } from "./turn_config/endpointing.js";
+import { defaultInterruptionOptions } from "./turn_config/interruption.js";
+vi.mock("ofetch", () => ({ ofetch: vi.fn() }));
 initializeLogger({ pretty: false, level: "error" });
 describe("Agent", () => {
   it("should create agent with basic instructions", () => {
@@ -176,5 +179,196 @@ describe("Agent", () => {
     await expect(wrapper.result).resolves.toBe("ok");
     expect(closeOldActivity).toHaveBeenCalledTimes(1);
   });
+  describe("Agent constructor option migration", () => {
+    it("should set allowInterruptions to false via deprecated constructor field", () => {
+      var _a, _b;
+      const agent = new Agent({ instructions: "test", allowInterruptions: false });
+      expect((_b = (_a = agent.turnHandling) == null ? void 0 : _a.interruption) == null ? void 0 : _b.enabled).toBe(false);
+    });
+    it("should not set derived properties when no compatibility fields are provided", () => {
+      const agent = new Agent({ instructions: "test" });
+      expect(agent.turnHandling).toBeUndefined();
+    });
+    it("should expose minConsecutiveSpeechDelay", () => {
+      const agent = new Agent({ instructions: "test", minConsecutiveSpeechDelay: 1.5 });
+      expect(agent.minConsecutiveSpeechDelay).toBe(1.5);
+    });
+    it("should ignore deprecated constructor fields when turnHandling is provided", () => {
+      var _a, _b, _c, _d, _e, _f, _g;
+      const agent = new Agent({
+        instructions: "test",
+        turnHandling: {
+          endpointing: { minDelay: 999 },
+          interruption: {},
+          turnDetection: "vad"
+        },
+        allowInterruptions: false
+      });
+      expect((_b = (_a = agent.turnHandling) == null ? void 0 : _a.endpointing) == null ? void 0 : _b.minDelay).toBe(999);
+      expect((_d = (_c = agent.turnHandling) == null ? void 0 : _c.endpointing) == null ? void 0 : _d.maxDelay).toBeUndefined();
+      expect((_f = (_e = agent.turnHandling) == null ? void 0 : _e.interruption) == null ? void 0 : _f.enabled).toBeUndefined();
+      expect((_g = agent.turnHandling) == null ? void 0 : _g.turnDetection).toBe("vad");
+    });
+    it("should let turnHandling override deprecated constructor fields on conflicts", () => {
+      var _a, _b, _c, _d, _e, _f, _g;
+      const agent = new Agent({
+        instructions: "test",
+        turnHandling: {
+          endpointing: { minDelay: 999, maxDelay: 4e3 },
+          interruption: { enabled: true },
+          turnDetection: "vad"
+        },
+        allowInterruptions: false,
+        turnDetection: "stt"
+      });
+      expect((_b = (_a = agent.turnHandling) == null ? void 0 : _a.endpointing) == null ? void 0 : _b.minDelay).toBe(999);
+      expect((_d = (_c = agent.turnHandling) == null ? void 0 : _c.endpointing) == null ? void 0 : _d.maxDelay).toBe(4e3);
+      expect((_f = (_e = agent.turnHandling) == null ? void 0 : _e.interruption) == null ? void 0 : _f.enabled).toBe(true);
+      expect((_g = agent.turnHandling) == null ? void 0 : _g.turnDetection).toBe("vad");
+    });
+    it("should set interruptionDetection from turnHandling.interruption.mode", () => {
+      var _a, _b;
+      const agent = new Agent({
+        instructions: "test",
+        turnHandling: {
+          interruption: { mode: "adaptive" },
+          endpointing: {},
+          turnDetection: void 0
+        }
+      });
+      expect((_b = (_a = agent.turnHandling) == null ? void 0 : _a.interruption) == null ? void 0 : _b.mode).toBe("adaptive");
+    });
+    it("should let AgentActivity prefer agent-level overrides over session defaults", () => {
+      var _a, _b;
+      const agent = new Agent({
+        instructions: "test",
+        turnHandling: {
+          endpointing: { minDelay: 111, maxDelay: 222 },
+          interruption: { enabled: false },
+          turnDetection: "manual"
+        }
+      });
+      const session = {
+        options: {
+          turnHandling: {
+            endpointing: defaultEndpointingOptions,
+            interruption: defaultInterruptionOptions
+          }
+        },
+        turnDetection: "stt",
+        useTtsAlignedTranscript: true,
+        vad: void 0,
+        stt: void 0,
+        llm: void 0,
+        tts: void 0,
+        interruptionDetection: void 0
+      };
+      const activity = new AgentActivity(agent, session);
+      expect(activity.allowInterruptions).toBe(false);
+      expect(activity.turnDetection).toBe("manual");
+      expect((_a = activity.turnHandling.endpointing) == null ? void 0 : _a.minDelay).toBe(111);
+      expect((_b = activity.turnHandling.endpointing) == null ? void 0 : _b.maxDelay).toBe(222);
+    });
+    it("should disable adaptive interruption detection in default mode when prerequisites are missing", () => {
+      const previousRemoteEotUrl = process.env.LIVEKIT_REMOTE_EOT_URL;
+      process.env.LIVEKIT_REMOTE_EOT_URL = "http://localhost:9999";
+      try {
+        const agent = new Agent({ instructions: "test" });
+        const session = {
+          options: {
+            turnHandling: {
+              endpointing: defaultEndpointingOptions,
+              interruption: defaultInterruptionOptions
+            }
+          },
+          sessionOptions: {
+            turnHandling: {
+              endpointing: defaultEndpointingOptions,
+              interruption: defaultInterruptionOptions
+            }
+          },
+          turnDetection: "manual",
+          useTtsAlignedTranscript: true,
+          vad: {},
+          stt: {
+            capabilities: {
+              alignedTranscript: true,
+              streaming: true
+            }
+          },
+          llm: void 0,
+          tts: void 0,
+          interruptionDetection: void 0
+        };
+        const activity = new AgentActivity(agent, session);
+        expect(activity.interruptionDetector).toBeUndefined();
+      } finally {
+        if (previousRemoteEotUrl === void 0) {
+          delete process.env.LIVEKIT_REMOTE_EOT_URL;
+        } else {
+          process.env.LIVEKIT_REMOTE_EOT_URL = previousRemoteEotUrl;
+        }
+      }
+    });
+    it("should warn when session explicitly requests adaptive detection even if agent overrides it", () => {
+      const activity = Object.create(AgentActivity.prototype);
+      activity.agent = {
+        turnHandling: { interruption: { mode: "vad" } },
+        turnDetection: void 0
+      };
+      activity.agentSession = {
+        interruptionDetection: "adaptive",
+        turnDetection: "manual"
+      };
+      activity.logger = { warn: vi.fn() };
+      expect(activity.resolveInterruptionDetector()).toBeUndefined();
+      expect(activity.logger.warn).toHaveBeenCalledWith(
+        "interruptionDetection is provided, but it's not compatible with the current configuration and will be disabled"
+      );
+    });
+    it("should disable adaptive interruption detection when interruptions are disabled", () => {
+      const previousRemoteEotUrl = process.env.LIVEKIT_REMOTE_EOT_URL;
+      process.env.LIVEKIT_REMOTE_EOT_URL = "http://localhost:9999";
+      try {
+        const activity = Object.create(AgentActivity.prototype);
+        activity.agent = {
+          turnHandling: {
+            interruption: { enabled: false }
+          },
+          turnDetection: void 0,
+          stt: void 0,
+          vad: void 0,
+          llm: void 0
+        };
+        activity.agentSession = {
+          interruptionDetection: void 0,
+          turnDetection: "stt",
+          sessionOptions: {
+            turnHandling: {
+              interruption: defaultInterruptionOptions,
+              endpointing: defaultEndpointingOptions
+            }
+          },
+          stt: {
+            capabilities: {
+              alignedTranscript: true,
+              streaming: true
+            }
+          },
+          vad: {},
+          llm: void 0
+        };
+        activity.logger = { warn: vi.fn() };
+        expect(activity.resolveInterruptionDetector()).toBeUndefined();
+        expect(activity.logger.warn).not.toHaveBeenCalled();
+      } finally {
+        if (previousRemoteEotUrl === void 0) {
+          delete process.env.LIVEKIT_REMOTE_EOT_URL;
+        } else {
+          process.env.LIVEKIT_REMOTE_EOT_URL = previousRemoteEotUrl;
+        }
+      }
+    });
+  });
 });
 //# sourceMappingURL=agent.test.js.map

package/dist/voice/agent.test.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/voice/agent.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { describe, expect, it, vi } from 'vitest';\nimport { z } from 'zod';\nimport { tool } from '../llm/index.js';\nimport { initializeLogger } from '../log.js';\nimport { Task } from '../utils.js';\nimport { Agent, AgentTask, _setActivityTaskInfo } from './agent.js';\nimport { agentActivityStorage } from './agent_activity.js';\n\ninitializeLogger({ pretty: false, level: 'error' });\n\ndescribe('Agent', () => {\n  it('should create agent with basic instructions', () => {\n    const instructions = 'You are a helpful assistant';\n    const agent = new Agent({ instructions });\n\n    expect(agent).toBeDefined();\n    expect(agent.instructions).toBe(instructions);\n  });\n\n  it('should create agent with instructions and tools', () => {\n    const instructions = 'You are a helpful assistant with tools';\n\n    // Create mock tools using the tool function\n    const mockTool1 = tool({\n      description: 'First test tool',\n      parameters: z.object({}),\n      execute: async () => 'tool1 result',\n    });\n\n    const mockTool2 = tool({\n      description: 'Second test tool',\n      parameters: z.object({\n        input: z.string().describe('Input parameter'),\n      }),\n      execute: async ({ input }) => `tool2: ${input}`,\n    });\n\n    const agent = new Agent({\n      instructions,\n      tools: {\n        getTool1: mockTool1,\n        getTool2: mockTool2,\n      },\n    });\n\n    expect(agent).toBeDefined();\n    expect(agent.instructions).toBe(instructions);\n\n    // Assert tools are set correctly\n    const agentTools = agent.toolCtx;\n    expect(Object.keys(agentTools)).toHaveLength(2);\n    expect(agentTools).toHaveProperty('getTool1');\n    expect(agentTools).toHaveProperty('getTool2');\n\n    // Verify tool properties with proper checks\n    expect(agentTools.getTool1?.description).toBe('First test tool');\n    expect(agentTools.getTool2?.description).toBe('Second test tool');\n  });\n\n  it('should return a copy of tools, not the original reference', () => {\n    const instructions = 'You are a helpful assistant';\n    const mockTool = tool({\n      description: 'Test tool',\n      parameters: z.object({}),\n      execute: async () => 'result',\n    });\n\n    const tools = { testTool: mockTool };\n    const agent = new Agent({ instructions, tools });\n\n    const tools1 = agent.toolCtx;\n    const tools2 = agent.toolCtx;\n\n    // Should return different object references\n    expect(tools1).not.toBe(tools2);\n    expect(tools1).not.toBe(tools);\n\n    // Should contain the same set of tools\n    expect(tools1).toEqual(tools2);\n    expect(tools1).toEqual(tools);\n  });\n\n  it('should require AgentTask to run inside task context', async () => {\n    class TestTask extends AgentTask<string> {\n      constructor() {\n        super({ instructions: 'test task' });\n      }\n    }\n\n    const task = new TestTask();\n    await expect(task.run()).rejects.toThrow('must be executed inside a Task context');\n  });\n\n  it('should require AgentTask to run inside inline task context', async () => {\n    class TestTask extends AgentTask<string> {\n      constructor() {\n        super({ instructions: 'test task' });\n      }\n    }\n\n    const task = new TestTask();\n    const wrapper = Task.from(async () => {\n      return await task.run();\n    });\n\n    await expect(wrapper.result).rejects.toThrow(\n      'should only be awaited inside function tools or the onEnter/onExit methods of an Agent',\n    );\n  });\n\n  it('should allow AgentTask run from inline task context', async () => {\n    class TestTask extends AgentTask<string> {\n      constructor() {\n        super({ instructions: 'test task' });\n      }\n    }\n\n    const task = new TestTask();\n    const oldAgent = new Agent({ instructions: 'old agent' });\n    const mockSession = {\n      currentAgent: oldAgent,\n      _globalRunState: undefined,\n      _updateActivity: async (agent: Agent) => {\n        if (agent === task) {\n          task.complete('ok');\n        }\n      },\n    };\n\n    const mockActivity = {\n      agent: oldAgent,\n      agentSession: mockSession,\n      _onEnterTask: undefined,\n      llm: undefined,\n      close: async () => {},\n    };\n\n    const wrapper = Task.from(async () => {\n      const currentTask = Task.current();\n      if (!currentTask) {\n        throw new Error('expected task context');\n      }\n      _setActivityTaskInfo(currentTask, { inlineTask: true });\n      return await agentActivityStorage.run(mockActivity as any, () => task.run());\n    });\n\n    await expect(wrapper.result).resolves.toBe('ok');\n  });\n\n  it('should require AgentTask to run inside AgentActivity context', async () => {\n    class TestTask extends AgentTask<string> {\n      constructor() {\n        super({ instructions: 'test task' });\n      }\n    }\n\n    const task = new TestTask();\n    const wrapper = Task.from(async () => {\n      const currentTask = Task.current();\n      if (!currentTask) {\n        throw new Error('expected task context');\n      }\n      _setActivityTaskInfo(currentTask, { inlineTask: true });\n      return await task.run();\n    });\n\n    await expect(wrapper.result).rejects.toThrow(\n      'must be executed inside an AgentActivity context',\n    );\n  });\n\n  it('should close old activity when current agent changes while AgentTask is pending', async () => {\n    class TestTask extends AgentTask<string> {\n      constructor() {\n        super({ instructions: 'test task' });\n      }\n    }\n\n    const task = new TestTask();\n    const oldAgent = new Agent({ instructions: 'old agent' });\n    const switchedAgent = new Agent({ instructions: 'switched agent' });\n    const closeOldActivity = vi.fn(async () => {});\n\n    const mockSession = {\n      currentAgent: oldAgent as Agent,\n      _globalRunState: undefined,\n      _updateActivity: async (agent: Agent) => {\n        if (agent === task) {\n          mockSession.currentAgent = switchedAgent;\n          task.complete('ok');\n        }\n      },\n    };\n\n    const mockActivity = {\n      agent: oldAgent,\n      agentSession: mockSession,\n      _onEnterTask: undefined,\n      llm: undefined,\n      close: closeOldActivity,\n    };\n\n    const wrapper = Task.from(async () => {\n      const currentTask = Task.current();\n      if (!currentTask) {\n        throw new Error('expected task context');\n      }\n      _setActivityTaskInfo(currentTask, { inlineTask: true });\n      return await agentActivityStorage.run(mockActivity as any, () => task.run());\n    });\n\n    await expect(wrapper.result).resolves.toBe('ok');\n    expect(closeOldActivity).toHaveBeenCalledTimes(1);\n  });\n});\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/voice/agent.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { describe, expect, it, vi } from 'vitest';\nimport { z } from 'zod';\nimport { tool } from '../llm/index.js';\nimport { initializeLogger } from '../log.js';\nimport { Task } from '../utils.js';\nimport { Agent, AgentTask, _setActivityTaskInfo } from './agent.js';\nimport { AgentActivity, agentActivityStorage } from './agent_activity.js';\nimport { defaultEndpointingOptions } from './turn_config/endpointing.js';\nimport { defaultInterruptionOptions } from './turn_config/interruption.js';\n\nvi.mock('ofetch', () => ({ ofetch: vi.fn() }));\n\ninitializeLogger({ pretty: false, level: 'error' });\n\ndescribe('Agent', () => {\n  it('should create agent with basic instructions', () => {\n    const instructions = 'You are a helpful assistant';\n    const agent = new Agent({ instructions });\n\n    expect(agent).toBeDefined();\n    expect(agent.instructions).toBe(instructions);\n  });\n\n  it('should create agent with instructions and tools', () => {\n    const instructions = 'You are a helpful assistant with tools';\n\n    // Create mock tools using the tool function\n    const mockTool1 = tool({\n      description: 'First test tool',\n      parameters: z.object({}),\n      execute: async () => 'tool1 result',\n    });\n\n    const mockTool2 = tool({\n      description: 'Second test tool',\n      parameters: z.object({\n        input: z.string().describe('Input parameter'),\n      }),\n      execute: async ({ input }) => `tool2: ${input}`,\n    });\n\n    const agent = new Agent({\n      instructions,\n      tools: {\n        getTool1: mockTool1,\n        getTool2: mockTool2,\n      },\n    });\n\n    expect(agent).toBeDefined();\n    expect(agent.instructions).toBe(instructions);\n\n    // Assert tools are set correctly\n    const agentTools = agent.toolCtx;\n    expect(Object.keys(agentTools)).toHaveLength(2);\n    expect(agentTools).toHaveProperty('getTool1');\n    expect(agentTools).toHaveProperty('getTool2');\n\n    // Verify tool properties with proper checks\n    expect(agentTools.getTool1?.description).toBe('First test tool');\n    expect(agentTools.getTool2?.description).toBe('Second test tool');\n  });\n\n  it('should return a copy of tools, not the original reference', () => {\n    const instructions = 'You are a helpful assistant';\n    const mockTool = tool({\n      description: 'Test tool',\n      parameters: z.object({}),\n      execute: async () => 'result',\n    });\n\n    const tools = { testTool: mockTool };\n    const agent = new Agent({ instructions, tools });\n\n    const tools1 = agent.toolCtx;\n    const tools2 = agent.toolCtx;\n\n    // Should return different object references\n    expect(tools1).not.toBe(tools2);\n    expect(tools1).not.toBe(tools);\n\n    // Should contain the same set of tools\n    expect(tools1).toEqual(tools2);\n    expect(tools1).toEqual(tools);\n  });\n\n  it('should require AgentTask to run inside task context', async () => {\n    class TestTask extends AgentTask<string> {\n      constructor() {\n        super({ instructions: 'test task' });\n      }\n    }\n\n    const task = new TestTask();\n    await expect(task.run()).rejects.toThrow('must be executed inside a Task context');\n  });\n\n  it('should require AgentTask to run inside inline task context', async () => {\n    class TestTask extends AgentTask<string> {\n      constructor() {\n        super({ instructions: 'test task' });\n      }\n    }\n\n    const task = new TestTask();\n    const wrapper = Task.from(async () => {\n      return await task.run();\n    });\n\n    await expect(wrapper.result).rejects.toThrow(\n      'should only be awaited inside function tools or the onEnter/onExit methods of an Agent',\n    );\n  });\n\n  it('should allow AgentTask run from inline task context', async () => {\n    class TestTask extends AgentTask<string> {\n      constructor() {\n        super({ instructions: 'test task' });\n      }\n    }\n\n    const task = new TestTask();\n    const oldAgent = new Agent({ instructions: 'old agent' });\n    const mockSession = {\n      currentAgent: oldAgent,\n      _globalRunState: undefined,\n      _updateActivity: async (agent: Agent) => {\n        if (agent === task) {\n          task.complete('ok');\n        }\n      },\n    };\n\n    const mockActivity = {\n      agent: oldAgent,\n      agentSession: mockSession,\n      _onEnterTask: undefined,\n      llm: undefined,\n      close: async () => {},\n    };\n\n    const wrapper = Task.from(async () => {\n      const currentTask = Task.current();\n      if (!currentTask) {\n        throw new Error('expected task context');\n      }\n      _setActivityTaskInfo(currentTask, { inlineTask: true });\n      return await agentActivityStorage.run(mockActivity as any, () => task.run());\n    });\n\n    await expect(wrapper.result).resolves.toBe('ok');\n  });\n\n  it('should require AgentTask to run inside AgentActivity context', async () => {\n    class TestTask extends AgentTask<string> {\n      constructor() {\n        super({ instructions: 'test task' });\n      }\n    }\n\n    const task = new TestTask();\n    const wrapper = Task.from(async () => {\n      const currentTask = Task.current();\n      if (!currentTask) {\n        throw new Error('expected task context');\n      }\n      _setActivityTaskInfo(currentTask, { inlineTask: true });\n      return await task.run();\n    });\n\n    await expect(wrapper.result).rejects.toThrow(\n      'must be executed inside an AgentActivity context',\n    );\n  });\n\n  it('should close old activity when current agent changes while AgentTask is pending', async () => {\n    class TestTask extends AgentTask<string> {\n      constructor() {\n        super({ instructions: 'test task' });\n      }\n    }\n\n    const task = new TestTask();\n    const oldAgent = new Agent({ instructions: 'old agent' });\n    const switchedAgent = new Agent({ instructions: 'switched agent' });\n    const closeOldActivity = vi.fn(async () => {});\n\n    const mockSession = {\n      currentAgent: oldAgent as Agent,\n      _globalRunState: undefined,\n      _updateActivity: async (agent: Agent) => {\n        if (agent === task) {\n          mockSession.currentAgent = switchedAgent;\n          task.complete('ok');\n        }\n      },\n    };\n\n    const mockActivity = {\n      agent: oldAgent,\n      agentSession: mockSession,\n      _onEnterTask: undefined,\n      llm: undefined,\n      close: closeOldActivity,\n    };\n\n    const wrapper = Task.from(async () => {\n      const currentTask = Task.current();\n      if (!currentTask) {\n        throw new Error('expected task context');\n      }\n      _setActivityTaskInfo(currentTask, { inlineTask: true });\n      return await agentActivityStorage.run(mockActivity as any, () => task.run());\n    });\n\n    await expect(wrapper.result).resolves.toBe('ok');\n    expect(closeOldActivity).toHaveBeenCalledTimes(1);\n  });\n\n  describe('Agent constructor option migration', () => {\n    it('should set allowInterruptions to false via deprecated constructor field', () => {\n      const agent = new Agent({ instructions: 'test', allowInterruptions: false });\n      expect(agent.turnHandling?.interruption?.enabled).toBe(false);\n    });\n\n    it('should not set derived properties when no compatibility fields are provided', () => {\n      const agent = new Agent({ instructions: 'test' });\n      expect(agent.turnHandling).toBeUndefined();\n    });\n\n    it('should expose minConsecutiveSpeechDelay', () => {\n      const agent = new Agent({ instructions: 'test', minConsecutiveSpeechDelay: 1.5 });\n      expect(agent.minConsecutiveSpeechDelay).toBe(1.5);\n    });\n\n    it('should ignore deprecated constructor fields when turnHandling is provided', () => {\n      const agent = new Agent({\n        instructions: 'test',\n        turnHandling: {\n          endpointing: { minDelay: 999 },\n          interruption: {},\n          turnDetection: 'vad',\n        },\n        allowInterruptions: false,\n      });\n      expect(agent.turnHandling?.endpointing?.minDelay).toBe(999);\n      expect(agent.turnHandling?.endpointing?.maxDelay).toBeUndefined();\n      expect(agent.turnHandling?.interruption?.enabled).toBeUndefined();\n      expect(agent.turnHandling?.turnDetection).toBe('vad');\n    });\n\n    it('should let turnHandling override deprecated constructor fields on conflicts', () => {\n      const agent = new Agent({\n        instructions: 'test',\n        turnHandling: {\n          endpointing: { minDelay: 999, maxDelay: 4000 },\n          interruption: { enabled: true },\n          turnDetection: 'vad',\n        },\n        allowInterruptions: false,\n        turnDetection: 'stt',\n      });\n      expect(agent.turnHandling?.endpointing?.minDelay).toBe(999);\n      expect(agent.turnHandling?.endpointing?.maxDelay).toBe(4000);\n      expect(agent.turnHandling?.interruption?.enabled).toBe(true);\n      expect(agent.turnHandling?.turnDetection).toBe('vad');\n    });\n\n    it('should set interruptionDetection from turnHandling.interruption.mode', () => {\n      const agent = new Agent({\n        instructions: 'test',\n        turnHandling: {\n          interruption: { mode: 'adaptive' },\n          endpointing: {},\n          turnDetection: undefined,\n        },\n      });\n      expect(agent.turnHandling?.interruption?.mode).toBe('adaptive');\n    });\n\n    it('should let AgentActivity prefer agent-level overrides over session defaults', () => {\n      const agent = new Agent({\n        instructions: 'test',\n        turnHandling: {\n          endpointing: { minDelay: 111, maxDelay: 222 },\n          interruption: { enabled: false },\n          turnDetection: 'manual',\n        },\n      });\n      const session = {\n        options: {\n          turnHandling: {\n            endpointing: defaultEndpointingOptions,\n            interruption: defaultInterruptionOptions,\n          },\n        },\n        turnDetection: 'stt',\n        useTtsAlignedTranscript: true,\n        vad: undefined,\n        stt: undefined,\n        llm: undefined,\n        tts: undefined,\n        interruptionDetection: undefined,\n      } as any;\n\n      const activity = new AgentActivity(agent as any, session);\n\n      expect(activity.allowInterruptions).toBe(false);\n      expect(activity.turnDetection).toBe('manual');\n      expect(activity.turnHandling.endpointing?.minDelay).toBe(111);\n      expect(activity.turnHandling.endpointing?.maxDelay).toBe(222);\n    });\n\n    it('should disable adaptive interruption detection in default mode when prerequisites are missing', () => {\n      const previousRemoteEotUrl = process.env.LIVEKIT_REMOTE_EOT_URL;\n      process.env.LIVEKIT_REMOTE_EOT_URL = 'http://localhost:9999';\n\n      try {\n        const agent = new Agent({ instructions: 'test' });\n        const session = {\n          options: {\n            turnHandling: {\n              endpointing: defaultEndpointingOptions,\n              interruption: defaultInterruptionOptions,\n            },\n          },\n          sessionOptions: {\n            turnHandling: {\n              endpointing: defaultEndpointingOptions,\n              interruption: defaultInterruptionOptions,\n            },\n          },\n          turnDetection: 'manual',\n          useTtsAlignedTranscript: true,\n          vad: {},\n          stt: {\n            capabilities: {\n              alignedTranscript: true,\n              streaming: true,\n            },\n          },\n          llm: undefined,\n          tts: undefined,\n          interruptionDetection: undefined,\n        } as any;\n\n        const activity = new AgentActivity(agent as any, session);\n        expect((activity as any).interruptionDetector).toBeUndefined();\n      } finally {\n        if (previousRemoteEotUrl === undefined) {\n          delete process.env.LIVEKIT_REMOTE_EOT_URL;\n        } else {\n          process.env.LIVEKIT_REMOTE_EOT_URL = previousRemoteEotUrl;\n        }\n      }\n    });\n\n    it('should warn when session explicitly requests adaptive detection even if agent overrides it', () => {\n      const activity = Object.create(AgentActivity.prototype) as any;\n      activity.agent = {\n        turnHandling: { interruption: { mode: 'vad' } },\n        turnDetection: undefined,\n      };\n      activity.agentSession = {\n        interruptionDetection: 'adaptive',\n        turnDetection: 'manual',\n      };\n      activity.logger = { warn: vi.fn() };\n\n      expect(activity.resolveInterruptionDetector()).toBeUndefined();\n      expect(activity.logger.warn).toHaveBeenCalledWith(\n        \"interruptionDetection is provided, but it's not compatible with the current configuration and will be disabled\",\n      );\n    });\n\n    it('should disable adaptive interruption detection when interruptions are disabled', () => {\n      const previousRemoteEotUrl = process.env.LIVEKIT_REMOTE_EOT_URL;\n      process.env.LIVEKIT_REMOTE_EOT_URL = 'http://localhost:9999';\n\n      try {\n        const activity = Object.create(AgentActivity.prototype) as any;\n        activity.agent = {\n          turnHandling: {\n            interruption: { enabled: false },\n          },\n          turnDetection: undefined,\n          stt: undefined,\n          vad: undefined,\n          llm: undefined,\n        };\n        activity.agentSession = {\n          interruptionDetection: undefined,\n          turnDetection: 'stt',\n          sessionOptions: {\n            turnHandling: {\n              interruption: defaultInterruptionOptions,\n              endpointing: defaultEndpointingOptions,\n            },\n          },\n          stt: {\n            capabilities: {\n              alignedTranscript: true,\n              streaming: true,\n            },\n          },\n          vad: {},\n          llm: undefined,\n        };\n        activity.logger = { warn: vi.fn() };\n\n        expect(activity.resolveInterruptionDetector()).toBeUndefined();\n        expect(activity.logger.warn).not.toHaveBeenCalled();\n      } finally {\n        if (previousRemoteEotUrl === undefined) {\n          delete process.env.LIVEKIT_REMOTE_EOT_URL;\n        } else {\n          process.env.LIVEKIT_REMOTE_EOT_URL = previousRemoteEotUrl;\n        }\n      }\n    });\n  });\n});\n"],"mappings":"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","names":[]}

package/dist/voice/agent_activity.cjs

@@ -83,9 +83,10 @@ class AgentActivity {
   onRealtimeInputAudioTranscriptionCompleted = (ev) => this.onInputAudioTranscriptionCompleted(ev);
   onModelError = (ev) => this.onError(ev);
   onInterruptionOverlappingSpeech = (ev) => {
-    this.agentSession.emit(import_events.AgentSessionEventTypes.UserOverlappingSpeech, ev);
+    this.agentSession.emit(import_events.AgentSessionEventTypes.OverlappingSpeech, ev);
   };
   onInterruptionMetricsCollected = (ev) => {
+    this.agentSession._usageCollector.collect(ev);
     this.agentSession.emit(
       import_events.AgentSessionEventTypes.MetricsCollected,
       (0, import_events.createMetricsCollectedEvent)({ metrics: ev })
@@ -94,6 +95,11 @@ class AgentActivity {
   onInterruptionError = (ev) => {
     const errorEvent = (0, import_events.createErrorEvent)(ev, this.interruptionDetector);
     this.agentSession.emit(import_events.AgentSessionEventTypes.Error, errorEvent);
+    if (!ev.recoverable) {
+      this.agentSession._onError(ev);
+      this.fallbackToVadInterruption();
+      return;
+    }
     this.agentSession._onError(ev);
   };
   /** @internal */
@@ -181,7 +187,7 @@ class AgentActivity {
     }
   }
   async _startSession(options) {
-    var _a;
+    var _a, _b, _c, _d, _e;
     const { spanName, runOnEnter } = options;
     const startSpan = import_telemetry.tracer.startSpan({
       name: spanName,
@@ -256,10 +262,10 @@ class AgentActivity {
       turnDetector: typeof this.turnDetection === "string" ? void 0 : this.turnDetection,
       turnDetectionMode: this.turnDetectionMode,
       interruptionDetection: this.interruptionDetector,
-      minEndpointingDelay: this.agentSession.options.turnHandling.endpointing.minDelay,
-      maxEndpointingDelay: this.agentSession.options.turnHandling.endpointing.maxDelay,
+      minEndpointingDelay: ((_b = (_a = this.agent.turnHandling) == null ? void 0 : _a.endpointing) == null ? void 0 : _b.minDelay) ?? this.agentSession.sessionOptions.turnHandling.endpointing.minDelay,
+      maxEndpointingDelay: ((_d = (_c = this.agent.turnHandling) == null ? void 0 : _c.endpointing) == null ? void 0 : _d.maxDelay) ?? this.agentSession.sessionOptions.turnHandling.endpointing.maxDelay,
       rootSpanContext: this.agentSession.rootSpanContext,
-      sttModel: (_a = this.stt) == null ? void 0 : _a.label,
+      sttModel: (_e = this.stt) == null ? void 0 : _e.label,
       sttProvider: this.getSttProvider(),
       getLinkedParticipant: () => {
         var _a2;
@@ -319,15 +325,31 @@ class AgentActivity {
     return this.realtimeSession;
   }
   get allowInterruptions() {
-    var _a;
-    return ((_a = this.agentSession.options.turnHandling.interruption) == null ? void 0 : _a.mode) !== false;
+    var _a, _b;
+    return ((_b = (_a = this.agent.turnHandling) == null ? void 0 : _a.interruption) == null ? void 0 : _b.enabled) ?? this.agentSession.sessionOptions.turnHandling.interruption.enabled;
   }
   get useTtsAlignedTranscript() {
     return this.agent.useTtsAlignedTranscript ?? this.agentSession.useTtsAlignedTranscript;
   }
   get turnDetection() {
-    return this.agentSession.turnDetection;
-  }
+    var _a;
+    return ((_a = this.agent.turnHandling) == null ? void 0 : _a.turnDetection) ?? this.agentSession.turnDetection;
+  }
+  get turnHandling() {
+    return this.agent.turnHandling ?? this.agentSession.sessionOptions.turnHandling;
+  }
+  // get minEndpointingDelay(): number {
+  //   return (
+  //     this.agent.turnHandling?.endpointing?.minDelay ??
+  //     this.agentSession.sessionOptions.turnHandling.endpointing.minDelay
+  //   );
+  // }
+  // get maxEndpointingDelay(): number {
+  //   return (
+  //     this.agent.turnHandling?.endpointing?.maxDelay ??
+  //     this.agentSession.sessionOptions.turnHandling.endpointing.maxDelay
+  //   );
+  // }
   get toolCtx() {
     return this.agent.toolCtx;
   }
@@ -393,12 +415,18 @@ class AgentActivity {
       }
     });
     this.audioStreamId = this.audioStream.addInputStream(audioStream);
-    const [realtimeAudioStream, recognitionAudioStream] = this.audioStream.stream.pipeThrough(aecWarmupAudioFilter).tee();
-    if (this.realtimeSession) {
+    if (this.realtimeSession && this.audioRecognition) {
+      const [realtimeAudioStream, recognitionAudioStream] = this.audioStream.stream.pipeThrough(aecWarmupAudioFilter).tee();
       this.realtimeSession.setInputAudioStream(realtimeAudioStream);
-    }
-    if (this.audioRecognition) {
       this.audioRecognition.setInputAudioStream(recognitionAudioStream);
+    } else if (this.realtimeSession) {
+      this.realtimeSession.setInputAudioStream(
+        this.audioStream.stream.pipeThrough(aecWarmupAudioFilter)
+      );
+    } else if (this.audioRecognition) {
+      this.audioRecognition.setInputAudioStream(
+        this.audioStream.stream.pipeThrough(aecWarmupAudioFilter)
+      );
     }
   }
   detachAudioInput() {
@@ -473,6 +501,7 @@ class AgentActivity {
         this.realtimeSpans.delete(ev.requestId);
       }
     }
+    this.agentSession._usageCollector.collect(ev);
     this.agentSession.emit(
       import_events.AgentSessionEventTypes.MetricsCollected,
       (0, import_events.createMetricsCollectedEvent)({ metrics: ev })
@@ -585,7 +614,10 @@ class AgentActivity {
     if (ev) {
       speechStartTime = speechStartTime - ev.speechDuration - ev.inferenceDuration;
     }
-    this.agentSession._updateUserState("speaking", speechStartTime);
+    this.agentSession._updateUserState("speaking", {
+      lastSpeakingTime: speechStartTime,
+      otelContext: import_api.context.active()
+    });
     if (this.isInterruptionDetectionEnabled && this.audioRecognition) {
       this.audioRecognition.onStartOfOverlapSpeech(
         ev.speechDuration,
@@ -605,14 +637,17 @@ class AgentActivity {
         this.agentSession._userSpeakingSpan
       );
     }
-    this.agentSession._updateUserState("listening", speechEndTime);
+    this.agentSession._updateUserState("listening", {
+      lastSpeakingTime: speechEndTime,
+      otelContext: import_api.context.active()
+    });
   }
   onVADInferenceDone(ev) {
     var _a;
     if (this.turnDetection === "manual" || this.turnDetection === "realtime_llm") {
       return;
     }
-    if (ev.speechDuration >= ((_a = this.agentSession.options.turnHandling.interruption) == null ? void 0 : _a.minDuration)) {
+    if (ev.speechDuration >= ((_a = this.agentSession.sessionOptions.turnHandling.interruption) == null ? void 0 : _a.minDuration)) {
       this.interruptByAudioActivity();
     }
   }
@@ -627,11 +662,11 @@ class AgentActivity {
     if (this.llm instanceof import_llm.RealtimeModel && this.llm.capabilities.turnDetection) {
       return;
     }
-    if (this.stt && ((_a = this.agentSession.options.turnHandling.interruption) == null ? void 0 : _a.minWords) > 0 && this.audioRecognition) {
+    if (this.stt && ((_a = this.agentSession.sessionOptions.turnHandling.interruption) == null ? void 0 : _a.minWords) > 0 && this.audioRecognition) {
       const text = this.audioRecognition.currentTranscript;
       const normalizedText = text ?? "";
       const wordCount = (0, import_word.splitWords)(normalizedText, true).length;
-      if (wordCount < ((_b = this.agentSession.options.turnHandling.interruption) == null ? void 0 : _b.minWords)) {
+      if (wordCount < ((_b = this.agentSession.sessionOptions.turnHandling.interruption) == null ? void 0 : _b.minWords)) {
         return;
       }
     }
@@ -649,7 +684,7 @@ class AgentActivity {
     this.restoreInterruptionByAudioActivity();
     this.interruptByAudioActivity();
     if (this.audioRecognition) {
-      this.audioRecognition.onEndOfAgentSpeech(ev.overlapStartedAt || ev.timestamp);
+      this.audioRecognition.onEndOfAgentSpeech(ev.overlapStartedAt || ev.detectedAt);
     }
   }
   onInterimTranscript(ev) {
@@ -687,7 +722,7 @@ class AgentActivity {
     }
   }
   onPreemptiveGeneration(info) {
-    if (!this.agentSession.options.preemptiveGeneration || this.schedulingPaused || this._currentSpeech !== void 0 && !this._currentSpeech.interrupted || !(this.llm instanceof import_llm.LLM)) {
+    if (!this.agentSession.sessionOptions.preemptiveGeneration || this.schedulingPaused || this._currentSpeech !== void 0 && !this._currentSpeech.interrupted || !(this.llm instanceof import_llm.LLM)) {
       return;
     }
     this.cancelPreemptiveGeneration();
@@ -768,14 +803,14 @@ class AgentActivity {
       );
       return true;
     }
-    if (this.stt && this.turnDetection !== "manual" && this._currentSpeech && this._currentSpeech.allowInterruptions && !this._currentSpeech.interrupted && ((_a = this.agentSession.options.turnHandling.interruption) == null ? void 0 : _a.minWords) > 0) {
+    if (this.stt && this.turnDetection !== "manual" && this._currentSpeech && this._currentSpeech.allowInterruptions && !this._currentSpeech.interrupted && ((_a = this.agentSession.sessionOptions.turnHandling.interruption) == null ? void 0 : _a.minWords) > 0) {
       const wordCount = (0, import_word.splitWords)(info.newTranscript, true).length;
-      if (wordCount < ((_b = this.agentSession.options.turnHandling.interruption) == null ? void 0 : _b.minWords)) {
+      if (wordCount < ((_b = this.agentSession.sessionOptions.turnHandling.interruption) == null ? void 0 : _b.minWords)) {
         this.cancelPreemptiveGeneration();
         this.logger.info(
           {
             wordCount,
-            minInterruptionWords: this.agentSession.options.turnHandling.interruption.minWords
+            minInterruptionWords: this.agentSession.sessionOptions.turnHandling.interruption.minWords
           },
           "skipping user input, word count below minimum interruption threshold"
         );
@@ -809,9 +844,12 @@ class AgentActivity {
           throw new Error("Speech queue is empty");
         }
         const speechHandle = heapItem[2];
+        if (speechHandle.interrupted || speechHandle.done()) {
+          continue;
+        }
         this._currentSpeech = speechHandle;
         speechHandle._authorizeGeneration();
-        await speechHandle._waitForGeneration();
+        await speechHandle.waitIfNotInterrupted([speechHandle._waitForGeneration()]);
         this._currentSpeech = void 0;
       }
       const toWait = this.getDrainPendingSpeechTasks();
@@ -951,7 +989,16 @@ ${instructions}`;
       speech.interrupt(force);
     }
     (_a = this.realtimeSession) == null ? void 0 : _a.interrupt();
-    if (currentSpeech === void 0) {
+    if (force) {
+      for (const task of this.speechTasks) {
+        task.cancel();
+      }
+      if (currentSpeech && !currentSpeech.done()) {
+        currentSpeech._markDone();
+      }
+      this.speechQueue.clear();
+      future.resolve();
+    } else if (currentSpeech === void 0) {
       future.resolve();
     } else {
       currentSpeech.addDoneCallback(() => {
@@ -1398,9 +1445,7 @@ ${instructions}`;
         audioOutput.clearBuffer();
       }
       replyAbortController.abort();
-      await Promise.allSettled(
-        tasks.map((task) => task.cancelAndWait(AgentActivity.REPLY_TASK_CANCEL_TIMEOUT))
-      );
+      await (0, import_utils.cancelAndWait)(tasks, AgentActivity.REPLY_TASK_CANCEL_TIMEOUT);
       let forwardedText = (textOut == null ? void 0 : textOut.text) || "";
       if (audioOutput) {
         const playbackEv = await audioOutput.waitForPlayout();
@@ -1481,7 +1526,7 @@ ${instructions}`;
     speechHandle._markGenerationDone();
     await executeToolsTask.result;
     if (toolOutput.output.length === 0) return;
-    const { maxToolSteps } = this.agentSession.options;
+    const { maxToolSteps } = this.agentSession.sessionOptions;
     if (speechHandle.numSteps >= maxToolSteps) {
       this.logger.warn(
         { speech_id: speechHandle.id, max_tool_steps: maxToolSteps },
@@ -1832,7 +1877,7 @@ ${instructions}`;
     if (toolOutput.output.length === 0) {
       return;
     }
-    const { maxToolSteps } = this.agentSession.options;
+    const { maxToolSteps } = this.agentSession.sessionOptions;
     if (speechHandle.numSteps >= maxToolSteps) {
       this.logger.warn(
         { speech_id: speechHandle.id, max_tool_steps: maxToolSteps },
@@ -2051,15 +2096,16 @@ ${instructions}`;
     const unlock = await this.lock.lock();
     try {
       this.cancelPreemptiveGeneration();
+      await (0, import_utils.cancelAndWait)(Array.from(this.speechTasks), AgentActivity.REPLY_TASK_CANCEL_TIMEOUT);
+      if (this._currentSpeech && !this._currentSpeech.done()) {
+        this._currentSpeech._markDone();
+      }
       await this._closeSessionResources();
       if (this._mainTask) {
         await this._mainTask.cancelAndWait();
       }
       if (this.interruptionDetector) {
-        this.interruptionDetector.off(
-          "user_overlapping_speech",
-          this.onInterruptionOverlappingSpeech
-        );
+        this.interruptionDetector.off("overlapping_speech", this.onInterruptionOverlappingSpeech);
         this.interruptionDetector.off("metrics_collected", this.onInterruptionMetricsCollected);
         this.interruptionDetector.off("error", this.onInterruptionError);
       }
@@ -2069,21 +2115,33 @@ ${instructions}`;
     }
   }
   resolveInterruptionDetector() {
-    const interruptionDetection = this.agent.interruptionDetection ?? this.agentSession.interruptionDetection;
+    var _a, _b;
+    const agentInterruptionDetection = (_b = (_a = this.agent.turnHandling) == null ? void 0 : _a.interruption) == null ? void 0 : _b.mode;
+    const sessionInterruptionDetection = this.agentSession.interruptionDetection;
     if (!(this.stt && this.stt.capabilities.alignedTranscript && this.stt.capabilities.streaming && this.vad && this.turnDetection !== "manual" && this.turnDetection !== "realtime_llm" && !(this.llm instanceof import_llm.RealtimeModel))) {
-      if (interruptionDetection === "adaptive") {
+      if (agentInterruptionDetection === "adaptive" || sessionInterruptionDetection === "adaptive") {
         this.logger.warn(
           "interruptionDetection is provided, but it's not compatible with the current configuration and will be disabled"
         );
-        return void 0;
       }
+      return void 0;
+    }
+    if (!this.allowInterruptions) {
+      return void 0;
+    }
+    if (agentInterruptionDetection === "vad") {
+      return void 0;
     }
-    if (interruptionDetection !== void 0 && interruptionDetection === false || interruptionDetection === "vad") {
+    if (sessionInterruptionDetection === "vad") {
+      return void 0;
+    }
+    if (agentInterruptionDetection === void 0 && sessionInterruptionDetection === void 0 && !(0, import_utils.isHosted)() && !(0, import_utils.isDevMode)()) {
+      this.logger.info("adaptive interruption is disabled by default in production mode");
       return void 0;
     }
     try {
       const detector = new import_interruption_detector.AdaptiveInterruptionDetector();
-      detector.on("user_overlapping_speech", this.onInterruptionOverlappingSpeech);
+      detector.on("overlapping_speech", this.onInterruptionOverlappingSpeech);
       detector.on("metrics_collected", this.onInterruptionMetricsCollected);
       detector.on("error", this.onInterruptionError);
       return detector;
@@ -2095,6 +2153,25 @@ ${instructions}`;
   restoreInterruptionByAudioActivity() {
     this.isInterruptionByAudioActivityEnabled = this.isDefaultInterruptionByAudioActivityEnabled;
   }
+  fallbackToVadInterruption() {
+    if (!this.isInterruptionDetectionEnabled) return;
+    this.isInterruptionDetectionEnabled = false;
+    this.restoreInterruptionByAudioActivity();
+    if (this.interruptionDetector) {
+      this.interruptionDetector.off("overlapping_speech", this.onInterruptionOverlappingSpeech);
+      this.interruptionDetector.off("metrics_collected", this.onInterruptionMetricsCollected);
+      this.interruptionDetector.off("error", this.onInterruptionError);
+      this.interruptionDetector = void 0;
+    }
+    if (this.audioRecognition) {
+      this.audioRecognition.disableInterruptionDetection().catch((err) => {
+        this.logger.warn({ err }, "error while disabling interruption detection");
+      });
+    }
+    this.logger.warn(
+      "adaptive interruption disabled due to unrecoverable error, falling back to VAD-based interruption"
+    );
+  }
   async _closeSessionResources() {
     var _a, _b, _c;
     if (this.llm instanceof import_llm.LLM) {