@livekit/agents 0.0.0-20260120144724

package/dist/voice/index.cjs

@@ -0,0 +1,49 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var voice_exports = {};
+__export(voice_exports, {
+  Agent: () => import_agent.Agent,
+  AgentSession: () => import_agent_session.AgentSession,
+  RunContext: () => import_run_context.RunContext,
+  StopResponse: () => import_agent.StopResponse
+});
+module.exports = __toCommonJS(voice_exports);
+var import_agent = require("./agent.cjs");
+var import_agent_session = require("./agent_session.cjs");
+__reExport(voice_exports, require("./avatar/index.cjs"), module.exports);
+__reExport(voice_exports, require("./background_audio.cjs"), module.exports);
+__reExport(voice_exports, require("./events.cjs"), module.exports);
+var import_io = require("./io.cjs");
+__reExport(voice_exports, require("./report.cjs"), module.exports);
+__reExport(voice_exports, require("./room_io/index.cjs"), module.exports);
+var import_run_context = require("./run_context.cjs");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Agent,
+  AgentSession,
+  RunContext,
+  StopResponse,
+  ...require("./avatar/index.cjs"),
+  ...require("./background_audio.cjs"),
+  ...require("./events.cjs"),
+  ...require("./report.cjs"),
+  ...require("./room_io/index.cjs")
+});
+//# sourceMappingURL=index.cjs.map

package/dist/voice/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/voice/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport { Agent, StopResponse, type AgentOptions, type ModelSettings } from './agent.js';\nexport { AgentSession, type AgentSessionOptions } from './agent_session.js';\nexport * from './avatar/index.js';\nexport * from './background_audio.js';\nexport * from './events.js';\nexport { type TimedString } from './io.js';\nexport * from './report.js';\nexport * from './room_io/index.js';\nexport { RunContext } from './run_context.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,mBAA2E;AAC3E,2BAAuD;AACvD,0BAAc,8BALd;AAMA,0BAAc,kCANd;AAOA,0BAAc,wBAPd;AAQA,gBAAiC;AACjC,0BAAc,wBATd;AAUA,0BAAc,+BAVd;AAWA,yBAA2B;","names":[]}

package/dist/voice/index.d.cts

@@ -0,0 +1,10 @@
+export { Agent, StopResponse, type AgentOptions, type ModelSettings } from './agent.js';
+export { AgentSession, type AgentSessionOptions } from './agent_session.js';
+export * from './avatar/index.js';
+export * from './background_audio.js';
+export * from './events.js';
+export { type TimedString } from './io.js';
+export * from './report.js';
+export * from './room_io/index.js';
+export { RunContext } from './run_context.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/voice/index.d.ts

@@ -0,0 +1,10 @@
+export { Agent, StopResponse, type AgentOptions, type ModelSettings } from './agent.js';
+export { AgentSession, type AgentSessionOptions } from './agent_session.js';
+export * from './avatar/index.js';
+export * from './background_audio.js';
+export * from './events.js';
+export { type TimedString } from './io.js';
+export * from './report.js';
+export * from './room_io/index.js';
+export { RunContext } from './run_context.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/voice/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/voice/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/voice/index.js

@@ -0,0 +1,16 @@
+import { Agent, StopResponse } from "./agent.js";
+import { AgentSession } from "./agent_session.js";
+export * from "./avatar/index.js";
+export * from "./background_audio.js";
+export * from "./events.js";
+import {} from "./io.js";
+export * from "./report.js";
+export * from "./room_io/index.js";
+import { RunContext } from "./run_context.js";
+export {
+  Agent,
+  AgentSession,
+  RunContext,
+  StopResponse
+};
+//# sourceMappingURL=index.js.map

package/dist/voice/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/voice/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport { Agent, StopResponse, type AgentOptions, type ModelSettings } from './agent.js';\nexport { AgentSession, type AgentSessionOptions } from './agent_session.js';\nexport * from './avatar/index.js';\nexport * from './background_audio.js';\nexport * from './events.js';\nexport { type TimedString } from './io.js';\nexport * from './report.js';\nexport * from './room_io/index.js';\nexport { RunContext } from './run_context.js';\n"],"mappings":"AAGA,SAAS,OAAO,oBAA2D;AAC3E,SAAS,oBAA8C;AACvD,cAAc;AACd,cAAc;AACd,cAAc;AACd,eAAiC;AACjC,cAAc;AACd,cAAc;AACd,SAAS,kBAAkB;","names":[]}

package/dist/voice/interruption_detection.test.cjs

@@ -0,0 +1,114 @@
+"use strict";
+var import_vitest = require("vitest");
+var import_word = require("../tokenize/basic/word.cjs");
+(0, import_vitest.describe)("Interruption Detection - Word Counting", () => {
+  (0, import_vitest.describe)("Word Splitting Behavior", () => {
+    (0, import_vitest.it)("should count empty string as 0 words", () => {
+      const text = "";
+      const wordCount = (0, import_word.splitWords)(text, true).length;
+      (0, import_vitest.expect)(wordCount).toBe(0);
+    });
+    (0, import_vitest.it)("should count single word correctly", () => {
+      const text = "hello";
+      const wordCount = (0, import_word.splitWords)(text, true).length;
+      (0, import_vitest.expect)(wordCount).toBe(1);
+    });
+    (0, import_vitest.it)("should count two words correctly", () => {
+      const text = "hello world";
+      const wordCount = (0, import_word.splitWords)(text, true).length;
+      (0, import_vitest.expect)(wordCount).toBe(2);
+    });
+    (0, import_vitest.it)("should count multiple words correctly", () => {
+      const text = "hello this is a full sentence";
+      const wordCount = (0, import_word.splitWords)(text, true).length;
+      (0, import_vitest.expect)(wordCount).toBe(6);
+    });
+    (0, import_vitest.it)("should handle punctuation correctly", () => {
+      const text = "hello, world!";
+      const wordCount = (0, import_word.splitWords)(text, true).length;
+      (0, import_vitest.expect)(wordCount).toBe(2);
+    });
+    (0, import_vitest.it)("should handle multiple spaces between words", () => {
+      const text = "hello  world";
+      const wordCount = (0, import_word.splitWords)(text, true).length;
+      (0, import_vitest.expect)(wordCount).toBe(2);
+    });
+    (0, import_vitest.it)("should count whitespace-only string as 0 words", () => {
+      const text = "   ";
+      const wordCount = (0, import_word.splitWords)(text, true).length;
+      (0, import_vitest.expect)(wordCount).toBe(0);
+    });
+    (0, import_vitest.it)("should handle leading and trailing whitespace", () => {
+      const text = "  hello world  ";
+      const wordCount = (0, import_word.splitWords)(text, true).length;
+      (0, import_vitest.expect)(wordCount).toBe(2);
+    });
+  });
+  (0, import_vitest.describe)("Integration: Full Interruption Check Logic", () => {
+    (0, import_vitest.it)("should block interruption for empty transcript with threshold 2", () => {
+      const text = "";
+      const minInterruptionWords = 2;
+      const normalizedText = text ?? "";
+      const wordCount = (0, import_word.splitWords)(normalizedText, true).length;
+      const shouldBlock = wordCount < minInterruptionWords;
+      (0, import_vitest.expect)(normalizedText).toBe("");
+      (0, import_vitest.expect)(wordCount).toBe(0);
+      (0, import_vitest.expect)(shouldBlock).toBe(true);
+    });
+    (0, import_vitest.it)("should block interruption for undefined transcript with threshold 2", () => {
+      const text = void 0;
+      const minInterruptionWords = 2;
+      const normalizedText = text ?? "";
+      const wordCount = (0, import_word.splitWords)(normalizedText, true).length;
+      const shouldBlock = wordCount < minInterruptionWords;
+      (0, import_vitest.expect)(normalizedText).toBe("");
+      (0, import_vitest.expect)(wordCount).toBe(0);
+      (0, import_vitest.expect)(shouldBlock).toBe(true);
+    });
+    (0, import_vitest.it)("should block interruption for single word with threshold 2", () => {
+      const text = "hello";
+      const minInterruptionWords = 2;
+      const normalizedText = text ?? "";
+      const wordCount = (0, import_word.splitWords)(normalizedText, true).length;
+      const shouldBlock = wordCount < minInterruptionWords;
+      (0, import_vitest.expect)(normalizedText).toBe("hello");
+      (0, import_vitest.expect)(wordCount).toBe(1);
+      (0, import_vitest.expect)(shouldBlock).toBe(true);
+    });
+    (0, import_vitest.it)("should allow interruption when word count exactly meets threshold", () => {
+      const text = "hello world";
+      const minInterruptionWords = 2;
+      const normalizedText = text ?? "";
+      const wordCount = (0, import_word.splitWords)(normalizedText, true).length;
+      const shouldBlock = wordCount < minInterruptionWords;
+      (0, import_vitest.expect)(normalizedText).toBe("hello world");
+      (0, import_vitest.expect)(wordCount).toBe(2);
+      (0, import_vitest.expect)(shouldBlock).toBe(false);
+    });
+    (0, import_vitest.it)("should allow interruption when word count exceeds threshold", () => {
+      const text = "hello this is a full sentence";
+      const minInterruptionWords = 2;
+      const normalizedText = text ?? "";
+      const wordCount = (0, import_word.splitWords)(normalizedText, true).length;
+      const shouldBlock = wordCount < minInterruptionWords;
+      (0, import_vitest.expect)(normalizedText).toBe("hello this is a full sentence");
+      (0, import_vitest.expect)(wordCount).toBe(6);
+      (0, import_vitest.expect)(shouldBlock).toBe(false);
+    });
+    (0, import_vitest.it)("should apply consistent word counting logic in both methods", () => {
+      const transcripts = ["", "hello", "hello world", "this is a longer sentence"];
+      const threshold = 2;
+      transcripts.forEach((transcript) => {
+        const text1 = transcript;
+        const normalizedText1 = text1 ?? "";
+        const wordCount1 = (0, import_word.splitWords)(normalizedText1, true).length;
+        const shouldBlock1 = wordCount1 < threshold;
+        const wordCount2 = (0, import_word.splitWords)(transcript, true).length;
+        const shouldBlock2 = wordCount2 < threshold;
+        (0, import_vitest.expect)(wordCount1).toBe(wordCount2);
+        (0, import_vitest.expect)(shouldBlock1).toBe(shouldBlock2);
+      });
+    });
+  });
+});
+//# sourceMappingURL=interruption_detection.test.cjs.map

package/dist/voice/interruption_detection.test.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/voice/interruption_detection.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Unit tests for interruption detection logic in AgentActivity.\n *\n * Tests the refactored minInterruptionWords check which ensures:\n * - Consistent word count filtering across all speech scenarios\n * - Proper handling of empty strings, undefined, and short speech\n * - Interruptions allowed only when word count meets or exceeds minInterruptionWords threshold\n */\nimport { describe, expect, it } from 'vitest';\nimport { splitWords } from '../tokenize/basic/word.js';\n\ndescribe('Interruption Detection - Word Counting', () => {\n  describe('Word Splitting Behavior', () => {\n    it('should count empty string as 0 words', () => {\n      const text = '';\n      const wordCount = splitWords(text, true).length;\n      expect(wordCount).toBe(0);\n    });\n\n    it('should count single word correctly', () => {\n      const text = 'hello';\n      const wordCount = splitWords(text, true).length;\n      expect(wordCount).toBe(1);\n    });\n\n    it('should count two words correctly', () => {\n      const text = 'hello world';\n      const wordCount = splitWords(text, true).length;\n      expect(wordCount).toBe(2);\n    });\n\n    it('should count multiple words correctly', () => {\n      const text = 'hello this is a full sentence';\n      const wordCount = splitWords(text, true).length;\n      expect(wordCount).toBe(6);\n    });\n\n    it('should handle punctuation correctly', () => {\n      const text = 'hello, world!';\n      const wordCount = splitWords(text, true).length;\n      expect(wordCount).toBe(2);\n    });\n\n    it('should handle multiple spaces between words', () => {\n      const text = 'hello  world';\n      const wordCount = splitWords(text, true).length;\n      expect(wordCount).toBe(2);\n    });\n\n    it('should count whitespace-only string as 0 words', () => {\n      const text = '   ';\n      const wordCount = splitWords(text, true).length;\n      expect(wordCount).toBe(0);\n    });\n\n    it('should handle leading and trailing whitespace', () => {\n      const text = '  hello world  ';\n      const wordCount = splitWords(text, true).length;\n      expect(wordCount).toBe(2);\n    });\n  });\n\n  describe('Integration: Full Interruption Check Logic', () => {\n    it('should block interruption for empty transcript with threshold 2', () => {\n      const text = '';\n      const minInterruptionWords = 2;\n\n      const normalizedText = text ?? '';\n      const wordCount = splitWords(normalizedText, true).length;\n      const shouldBlock = wordCount < minInterruptionWords;\n\n      expect(normalizedText).toBe('');\n      expect(wordCount).toBe(0);\n      expect(shouldBlock).toBe(true);\n    });\n\n    it('should block interruption for undefined transcript with threshold 2', () => {\n      const text: string | undefined = undefined;\n      const minInterruptionWords = 2;\n\n      const normalizedText = text ?? '';\n      const wordCount = splitWords(normalizedText, true).length;\n      const shouldBlock = wordCount < minInterruptionWords;\n\n      expect(normalizedText).toBe('');\n      expect(wordCount).toBe(0);\n      expect(shouldBlock).toBe(true);\n    });\n\n    it('should block interruption for single word with threshold 2', () => {\n      const text = 'hello';\n      const minInterruptionWords = 2;\n\n      const normalizedText = text ?? '';\n      const wordCount = splitWords(normalizedText, true).length;\n      const shouldBlock = wordCount < minInterruptionWords;\n\n      expect(normalizedText).toBe('hello');\n      expect(wordCount).toBe(1);\n      expect(shouldBlock).toBe(true);\n    });\n\n    it('should allow interruption when word count exactly meets threshold', () => {\n      const text = 'hello world';\n      const minInterruptionWords = 2;\n\n      const normalizedText = text ?? '';\n      const wordCount = splitWords(normalizedText, true).length;\n      const shouldBlock = wordCount < minInterruptionWords;\n\n      expect(normalizedText).toBe('hello world');\n      expect(wordCount).toBe(2);\n      expect(shouldBlock).toBe(false);\n    });\n\n    it('should allow interruption when word count exceeds threshold', () => {\n      const text = 'hello this is a full sentence';\n      const minInterruptionWords = 2;\n\n      const normalizedText = text ?? '';\n      const wordCount = splitWords(normalizedText, true).length;\n      const shouldBlock = wordCount < minInterruptionWords;\n\n      expect(normalizedText).toBe('hello this is a full sentence');\n      expect(wordCount).toBe(6);\n      expect(shouldBlock).toBe(false);\n    });\n\n    it('should apply consistent word counting logic in both methods', () => {\n      const transcripts = ['', 'hello', 'hello world', 'this is a longer sentence'];\n      const threshold = 2;\n\n      transcripts.forEach((transcript) => {\n        const text1 = transcript;\n        const normalizedText1 = text1 ?? '';\n        const wordCount1 = splitWords(normalizedText1, true).length;\n        const shouldBlock1 = wordCount1 < threshold;\n\n        const wordCount2 = splitWords(transcript, true).length;\n        const shouldBlock2 = wordCount2 < threshold;\n\n        expect(wordCount1).toBe(wordCount2);\n        expect(shouldBlock1).toBe(shouldBlock2);\n      });\n    });\n  });\n});\n"],"mappings":"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","names":[]}

package/dist/voice/interruption_detection.test.js

@@ -0,0 +1,113 @@
+import { describe, expect, it } from "vitest";
+import { splitWords } from "../tokenize/basic/word.js";
+describe("Interruption Detection - Word Counting", () => {
+  describe("Word Splitting Behavior", () => {
+    it("should count empty string as 0 words", () => {
+      const text = "";
+      const wordCount = splitWords(text, true).length;
+      expect(wordCount).toBe(0);
+    });
+    it("should count single word correctly", () => {
+      const text = "hello";
+      const wordCount = splitWords(text, true).length;
+      expect(wordCount).toBe(1);
+    });
+    it("should count two words correctly", () => {
+      const text = "hello world";
+      const wordCount = splitWords(text, true).length;
+      expect(wordCount).toBe(2);
+    });
+    it("should count multiple words correctly", () => {
+      const text = "hello this is a full sentence";
+      const wordCount = splitWords(text, true).length;
+      expect(wordCount).toBe(6);
+    });
+    it("should handle punctuation correctly", () => {
+      const text = "hello, world!";
+      const wordCount = splitWords(text, true).length;
+      expect(wordCount).toBe(2);
+    });
+    it("should handle multiple spaces between words", () => {
+      const text = "hello  world";
+      const wordCount = splitWords(text, true).length;
+      expect(wordCount).toBe(2);
+    });
+    it("should count whitespace-only string as 0 words", () => {
+      const text = "   ";
+      const wordCount = splitWords(text, true).length;
+      expect(wordCount).toBe(0);
+    });
+    it("should handle leading and trailing whitespace", () => {
+      const text = "  hello world  ";
+      const wordCount = splitWords(text, true).length;
+      expect(wordCount).toBe(2);
+    });
+  });
+  describe("Integration: Full Interruption Check Logic", () => {
+    it("should block interruption for empty transcript with threshold 2", () => {
+      const text = "";
+      const minInterruptionWords = 2;
+      const normalizedText = text ?? "";
+      const wordCount = splitWords(normalizedText, true).length;
+      const shouldBlock = wordCount < minInterruptionWords;
+      expect(normalizedText).toBe("");
+      expect(wordCount).toBe(0);
+      expect(shouldBlock).toBe(true);
+    });
+    it("should block interruption for undefined transcript with threshold 2", () => {
+      const text = void 0;
+      const minInterruptionWords = 2;
+      const normalizedText = text ?? "";
+      const wordCount = splitWords(normalizedText, true).length;
+      const shouldBlock = wordCount < minInterruptionWords;
+      expect(normalizedText).toBe("");
+      expect(wordCount).toBe(0);
+      expect(shouldBlock).toBe(true);
+    });
+    it("should block interruption for single word with threshold 2", () => {
+      const text = "hello";
+      const minInterruptionWords = 2;
+      const normalizedText = text ?? "";
+      const wordCount = splitWords(normalizedText, true).length;
+      const shouldBlock = wordCount < minInterruptionWords;
+      expect(normalizedText).toBe("hello");
+      expect(wordCount).toBe(1);
+      expect(shouldBlock).toBe(true);
+    });
+    it("should allow interruption when word count exactly meets threshold", () => {
+      const text = "hello world";
+      const minInterruptionWords = 2;
+      const normalizedText = text ?? "";
+      const wordCount = splitWords(normalizedText, true).length;
+      const shouldBlock = wordCount < minInterruptionWords;
+      expect(normalizedText).toBe("hello world");
+      expect(wordCount).toBe(2);
+      expect(shouldBlock).toBe(false);
+    });
+    it("should allow interruption when word count exceeds threshold", () => {
+      const text = "hello this is a full sentence";
+      const minInterruptionWords = 2;
+      const normalizedText = text ?? "";
+      const wordCount = splitWords(normalizedText, true).length;
+      const shouldBlock = wordCount < minInterruptionWords;
+      expect(normalizedText).toBe("hello this is a full sentence");
+      expect(wordCount).toBe(6);
+      expect(shouldBlock).toBe(false);
+    });
+    it("should apply consistent word counting logic in both methods", () => {
+      const transcripts = ["", "hello", "hello world", "this is a longer sentence"];
+      const threshold = 2;
+      transcripts.forEach((transcript) => {
+        const text1 = transcript;
+        const normalizedText1 = text1 ?? "";
+        const wordCount1 = splitWords(normalizedText1, true).length;
+        const shouldBlock1 = wordCount1 < threshold;
+        const wordCount2 = splitWords(transcript, true).length;
+        const shouldBlock2 = wordCount2 < threshold;
+        expect(wordCount1).toBe(wordCount2);
+        expect(shouldBlock1).toBe(shouldBlock2);
+      });
+    });
+  });
+});
+//# sourceMappingURL=interruption_detection.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/voice/interruption_detection.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Unit tests for interruption detection logic in AgentActivity.\n *\n * Tests the refactored minInterruptionWords check which ensures:\n * - Consistent word count filtering across all speech scenarios\n * - Proper handling of empty strings, undefined, and short speech\n * - Interruptions allowed only when word count meets or exceeds minInterruptionWords threshold\n */\nimport { describe, expect, it } from 'vitest';\nimport { splitWords } from '../tokenize/basic/word.js';\n\ndescribe('Interruption Detection - Word Counting', () => {\n  describe('Word Splitting Behavior', () => {\n    it('should count empty string as 0 words', () => {\n      const text = '';\n      const wordCount = splitWords(text, true).length;\n      expect(wordCount).toBe(0);\n    });\n\n    it('should count single word correctly', () => {\n      const text = 'hello';\n      const wordCount = splitWords(text, true).length;\n      expect(wordCount).toBe(1);\n    });\n\n    it('should count two words correctly', () => {\n      const text = 'hello world';\n      const wordCount = splitWords(text, true).length;\n      expect(wordCount).toBe(2);\n    });\n\n    it('should count multiple words correctly', () => {\n      const text = 'hello this is a full sentence';\n      const wordCount = splitWords(text, true).length;\n      expect(wordCount).toBe(6);\n    });\n\n    it('should handle punctuation correctly', () => {\n      const text = 'hello, world!';\n      const wordCount = splitWords(text, true).length;\n      expect(wordCount).toBe(2);\n    });\n\n    it('should handle multiple spaces between words', () => {\n      const text = 'hello  world';\n      const wordCount = splitWords(text, true).length;\n      expect(wordCount).toBe(2);\n    });\n\n    it('should count whitespace-only string as 0 words', () => {\n      const text = '   ';\n      const wordCount = splitWords(text, true).length;\n      expect(wordCount).toBe(0);\n    });\n\n    it('should handle leading and trailing whitespace', () => {\n      const text = '  hello world  ';\n      const wordCount = splitWords(text, true).length;\n      expect(wordCount).toBe(2);\n    });\n  });\n\n  describe('Integration: Full Interruption Check Logic', () => {\n    it('should block interruption for empty transcript with threshold 2', () => {\n      const text = '';\n      const minInterruptionWords = 2;\n\n      const normalizedText = text ?? '';\n      const wordCount = splitWords(normalizedText, true).length;\n      const shouldBlock = wordCount < minInterruptionWords;\n\n      expect(normalizedText).toBe('');\n      expect(wordCount).toBe(0);\n      expect(shouldBlock).toBe(true);\n    });\n\n    it('should block interruption for undefined transcript with threshold 2', () => {\n      const text: string | undefined = undefined;\n      const minInterruptionWords = 2;\n\n      const normalizedText = text ?? '';\n      const wordCount = splitWords(normalizedText, true).length;\n      const shouldBlock = wordCount < minInterruptionWords;\n\n      expect(normalizedText).toBe('');\n      expect(wordCount).toBe(0);\n      expect(shouldBlock).toBe(true);\n    });\n\n    it('should block interruption for single word with threshold 2', () => {\n      const text = 'hello';\n      const minInterruptionWords = 2;\n\n      const normalizedText = text ?? '';\n      const wordCount = splitWords(normalizedText, true).length;\n      const shouldBlock = wordCount < minInterruptionWords;\n\n      expect(normalizedText).toBe('hello');\n      expect(wordCount).toBe(1);\n      expect(shouldBlock).toBe(true);\n    });\n\n    it('should allow interruption when word count exactly meets threshold', () => {\n      const text = 'hello world';\n      const minInterruptionWords = 2;\n\n      const normalizedText = text ?? '';\n      const wordCount = splitWords(normalizedText, true).length;\n      const shouldBlock = wordCount < minInterruptionWords;\n\n      expect(normalizedText).toBe('hello world');\n      expect(wordCount).toBe(2);\n      expect(shouldBlock).toBe(false);\n    });\n\n    it('should allow interruption when word count exceeds threshold', () => {\n      const text = 'hello this is a full sentence';\n      const minInterruptionWords = 2;\n\n      const normalizedText = text ?? '';\n      const wordCount = splitWords(normalizedText, true).length;\n      const shouldBlock = wordCount < minInterruptionWords;\n\n      expect(normalizedText).toBe('hello this is a full sentence');\n      expect(wordCount).toBe(6);\n      expect(shouldBlock).toBe(false);\n    });\n\n    it('should apply consistent word counting logic in both methods', () => {\n      const transcripts = ['', 'hello', 'hello world', 'this is a longer sentence'];\n      const threshold = 2;\n\n      transcripts.forEach((transcript) => {\n        const text1 = transcript;\n        const normalizedText1 = text1 ?? '';\n        const wordCount1 = splitWords(normalizedText1, true).length;\n        const shouldBlock1 = wordCount1 < threshold;\n\n        const wordCount2 = splitWords(transcript, true).length;\n        const shouldBlock2 = wordCount2 < threshold;\n\n        expect(wordCount1).toBe(wordCount2);\n        expect(shouldBlock1).toBe(shouldBlock2);\n      });\n    });\n  });\n});\n"],"mappings":"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","names":[]}

package/dist/voice/io.cjs

@@ -0,0 +1,270 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var io_exports = {};
+__export(io_exports, {
+  AgentInput: () => AgentInput,
+  AgentOutput: () => AgentOutput,
+  AudioInput: () => AudioInput,
+  AudioOutput: () => AudioOutput,
+  TextOutput: () => TextOutput
+});
+module.exports = __toCommonJS(io_exports);
+var import_node_events = require("node:events");
+var import_log = require("../log.cjs");
+var import_deferred_stream = require("../stream/deferred_stream.cjs");
+var import_utils = require("../utils.cjs");
+class AudioInput {
+  deferredStream = new import_deferred_stream.DeferredReadableStream();
+  get stream() {
+    return this.deferredStream.stream;
+  }
+  onAttached() {
+  }
+  onDetached() {
+  }
+}
+class AudioOutput extends import_node_events.EventEmitter {
+  constructor(sampleRate, nextInChain, capabilities = { pause: false }) {
+    super();
+    this.sampleRate = sampleRate;
+    this.nextInChain = nextInChain;
+    this.capabilities = capabilities;
+    if (this.nextInChain) {
+      this.nextInChain.on(
+        AudioOutput.EVENT_PLAYBACK_FINISHED,
+        (ev) => this.onPlaybackFinished(ev)
+      );
+    }
+  }
+  static EVENT_PLAYBACK_FINISHED = "playbackFinished";
+  playbackFinishedFuture = new import_utils.Future();
+  _capturing = false;
+  playbackFinishedCount = 0;
+  playbackSegmentsCount = 0;
+  lastPlaybackEvent = {
+    playbackPosition: 0,
+    interrupted: false
+  };
+  logger = (0, import_log.log)();
+  capabilities;
+  /**
+   * Whether this output and all outputs in the chain support pause/resume.
+   */
+  get canPause() {
+    var _a;
+    return this.capabilities.pause && (((_a = this.nextInChain) == null ? void 0 : _a.canPause) ?? true);
+  }
+  /**
+   * Capture an audio frame for playback, frames can be pushed faster than real-time
+   */
+  async captureFrame(_frame) {
+    if (!this._capturing) {
+      this._capturing = true;
+      this.playbackSegmentsCount++;
+    }
+  }
+  /**
+   * Wait for the past audio segments to finish playing out.
+   *
+   * @returns The event that was emitted when the audio finished playing out (only the last segment information)
+   */
+  async waitForPlayout() {
+    const target = this.playbackSegmentsCount;
+    while (this.playbackFinishedCount < target) {
+      await this.playbackFinishedFuture.await;
+      this.playbackFinishedFuture = new import_utils.Future();
+    }
+    return this.lastPlaybackEvent;
+  }
+  /**
+   * Developers building audio sinks must call this method when a playback/segment is finished.
+   * Segments are segmented by calls to flush() or clearBuffer()
+   */
+  onPlaybackFinished(options) {
+    if (this.playbackFinishedCount >= this.playbackSegmentsCount) {
+      this.logger.warn("playback_finished called more times than playback segments were captured");
+      return;
+    }
+    this.lastPlaybackEvent = options;
+    this.playbackFinishedCount++;
+    this.playbackFinishedFuture.resolve();
+    this.emit(AudioOutput.EVENT_PLAYBACK_FINISHED, options);
+  }
+  flush() {
+    this._capturing = false;
+  }
+  onAttached() {
+    if (this.nextInChain) {
+      this.nextInChain.onAttached();
+    }
+  }
+  onDetached() {
+    if (this.nextInChain) {
+      this.nextInChain.onDetached();
+    }
+  }
+  /**
+   * Pause the audio playback
+   */
+  pause() {
+    if (this.nextInChain) {
+      this.nextInChain.pause();
+    }
+  }
+  /**
+   * Resume the audio playback
+   */
+  resume() {
+    if (this.nextInChain) {
+      this.nextInChain.resume();
+    }
+  }
+}
+class TextOutput {
+  constructor(nextInChain) {
+    this.nextInChain = nextInChain;
+  }
+  onAttached() {
+    if (this.nextInChain) {
+      this.nextInChain.onAttached();
+    }
+  }
+  onDetached() {
+    if (this.nextInChain) {
+      this.nextInChain.onDetached();
+    }
+  }
+}
+class AgentInput {
+  constructor(audioChanged) {
+    this.audioChanged = audioChanged;
+  }
+  _audioStream = null;
+  // enabled by default
+  _audioEnabled = true;
+  setAudioEnabled(enable) {
+    if (enable === this._audioEnabled) {
+      return;
+    }
+    this._audioEnabled = enable;
+    if (!this._audioStream) {
+      return;
+    }
+    if (enable) {
+      this._audioStream.onAttached();
+    } else {
+      this._audioStream.onDetached();
+    }
+  }
+  get audioEnabled() {
+    return this._audioEnabled;
+  }
+  get audio() {
+    return this._audioStream;
+  }
+  set audio(stream) {
+    this._audioStream = stream;
+    this.audioChanged();
+  }
+}
+class AgentOutput {
+  constructor(audioChanged, transcriptionChanged) {
+    this.audioChanged = audioChanged;
+    this.transcriptionChanged = transcriptionChanged;
+  }
+  _audioSink = null;
+  _transcriptionSink = null;
+  _audioEnabled = true;
+  _transcriptionEnabled = true;
+  setAudioEnabled(enabled) {
+    if (enabled === this._audioEnabled) {
+      return;
+    }
+    this._audioEnabled = enabled;
+    if (!this._audioSink) {
+      return;
+    }
+    if (enabled) {
+      this._audioSink.onAttached();
+    } else {
+      this._audioSink.onDetached();
+    }
+  }
+  setTranscriptionEnabled(enabled) {
+    if (enabled === this._transcriptionEnabled) {
+      return;
+    }
+    this._transcriptionEnabled = enabled;
+    if (!this._transcriptionSink) {
+      return;
+    }
+    if (enabled) {
+      this._transcriptionSink.onAttached();
+    } else {
+      this._transcriptionSink.onDetached();
+    }
+  }
+  get audioEnabled() {
+    return this._audioEnabled;
+  }
+  get transcriptionEnabled() {
+    return this._transcriptionEnabled;
+  }
+  get audio() {
+    return this._audioSink;
+  }
+  set audio(sink) {
+    if (sink === this._audioSink) {
+      return;
+    }
+    if (this._audioSink) {
+      this._audioSink.onDetached();
+    }
+    this._audioSink = sink;
+    this.audioChanged();
+    if (this._audioSink) {
+      this._audioSink.onAttached();
+    }
+  }
+  get transcription() {
+    return this._transcriptionSink;
+  }
+  set transcription(sink) {
+    if (sink === this._transcriptionSink) {
+      return;
+    }
+    if (this._transcriptionSink) {
+      this._transcriptionSink.onDetached();
+    }
+    this._transcriptionSink = sink;
+    this.transcriptionChanged();
+    if (this._transcriptionSink) {
+      this._transcriptionSink.onAttached();
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AgentInput,
+  AgentOutput,
+  AudioInput,
+  AudioOutput,
+  TextOutput
+});
+//# sourceMappingURL=io.cjs.map