@livekit/agents 1.0.36-dev.0 → 1.0.37

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (176) hide show
  1. package/dist/index.cjs +1 -3
  2. package/dist/index.cjs.map +1 -1
  3. package/dist/index.d.cts +0 -1
  4. package/dist/index.d.ts +0 -1
  5. package/dist/index.d.ts.map +1 -1
  6. package/dist/index.js +0 -1
  7. package/dist/index.js.map +1 -1
  8. package/dist/inference/utils.cjs +2 -15
  9. package/dist/inference/utils.cjs.map +1 -1
  10. package/dist/inference/utils.d.cts +0 -1
  11. package/dist/inference/utils.d.ts +0 -1
  12. package/dist/inference/utils.d.ts.map +1 -1
  13. package/dist/inference/utils.js +1 -13
  14. package/dist/inference/utils.js.map +1 -1
  15. package/dist/stream/stream_channel.cjs +0 -3
  16. package/dist/stream/stream_channel.cjs.map +1 -1
  17. package/dist/stream/stream_channel.d.cts +2 -3
  18. package/dist/stream/stream_channel.d.ts +2 -3
  19. package/dist/stream/stream_channel.d.ts.map +1 -1
  20. package/dist/stream/stream_channel.js +0 -3
  21. package/dist/stream/stream_channel.js.map +1 -1
  22. package/dist/telemetry/trace_types.cjs +0 -15
  23. package/dist/telemetry/trace_types.cjs.map +1 -1
  24. package/dist/telemetry/trace_types.d.cts +0 -5
  25. package/dist/telemetry/trace_types.d.ts +0 -5
  26. package/dist/telemetry/trace_types.d.ts.map +1 -1
  27. package/dist/telemetry/trace_types.js +0 -10
  28. package/dist/telemetry/trace_types.js.map +1 -1
  29. package/dist/voice/agent_activity.cjs +19 -68
  30. package/dist/voice/agent_activity.cjs.map +1 -1
  31. package/dist/voice/agent_activity.d.cts +0 -14
  32. package/dist/voice/agent_activity.d.ts +0 -14
  33. package/dist/voice/agent_activity.d.ts.map +1 -1
  34. package/dist/voice/agent_activity.js +19 -68
  35. package/dist/voice/agent_activity.js.map +1 -1
  36. package/dist/voice/agent_session.cjs +65 -37
  37. package/dist/voice/agent_session.cjs.map +1 -1
  38. package/dist/voice/agent_session.d.cts +25 -4
  39. package/dist/voice/agent_session.d.ts +25 -4
  40. package/dist/voice/agent_session.d.ts.map +1 -1
  41. package/dist/voice/agent_session.js +65 -37
  42. package/dist/voice/agent_session.js.map +1 -1
  43. package/dist/voice/audio_recognition.cjs +2 -124
  44. package/dist/voice/audio_recognition.cjs.map +1 -1
  45. package/dist/voice/audio_recognition.d.cts +1 -32
  46. package/dist/voice/audio_recognition.d.ts +1 -32
  47. package/dist/voice/audio_recognition.d.ts.map +1 -1
  48. package/dist/voice/audio_recognition.js +2 -127
  49. package/dist/voice/audio_recognition.js.map +1 -1
  50. package/dist/voice/index.cjs +14 -1
  51. package/dist/voice/index.cjs.map +1 -1
  52. package/dist/voice/index.d.cts +1 -0
  53. package/dist/voice/index.d.ts +1 -0
  54. package/dist/voice/index.d.ts.map +1 -1
  55. package/dist/voice/index.js +3 -1
  56. package/dist/voice/index.js.map +1 -1
  57. package/dist/voice/room_io/room_io.cjs +1 -0
  58. package/dist/voice/room_io/room_io.cjs.map +1 -1
  59. package/dist/voice/room_io/room_io.d.ts.map +1 -1
  60. package/dist/voice/room_io/room_io.js +1 -0
  61. package/dist/voice/room_io/room_io.js.map +1 -1
  62. package/dist/voice/speech_handle.cjs +12 -3
  63. package/dist/voice/speech_handle.cjs.map +1 -1
  64. package/dist/voice/speech_handle.d.cts +12 -2
  65. package/dist/voice/speech_handle.d.ts +12 -2
  66. package/dist/voice/speech_handle.d.ts.map +1 -1
  67. package/dist/voice/speech_handle.js +10 -2
  68. package/dist/voice/speech_handle.js.map +1 -1
  69. package/dist/voice/testing/index.cjs +54 -0
  70. package/dist/voice/testing/index.cjs.map +1 -0
  71. package/dist/voice/testing/index.d.cts +20 -0
  72. package/dist/voice/testing/index.d.ts +20 -0
  73. package/dist/voice/testing/index.d.ts.map +1 -0
  74. package/dist/voice/testing/index.js +33 -0
  75. package/dist/voice/testing/index.js.map +1 -0
  76. package/dist/voice/testing/run_result.cjs +766 -0
  77. package/dist/voice/testing/run_result.cjs.map +1 -0
  78. package/dist/voice/testing/run_result.d.cts +374 -0
  79. package/dist/voice/testing/run_result.d.ts +374 -0
  80. package/dist/voice/testing/run_result.d.ts.map +1 -0
  81. package/dist/voice/testing/run_result.js +739 -0
  82. package/dist/voice/testing/run_result.js.map +1 -0
  83. package/dist/{inference/interruption/index.cjs → voice/testing/types.cjs} +24 -12
  84. package/dist/voice/testing/types.cjs.map +1 -0
  85. package/dist/voice/testing/types.d.cts +83 -0
  86. package/dist/voice/testing/types.d.ts +83 -0
  87. package/dist/voice/testing/types.d.ts.map +1 -0
  88. package/dist/voice/testing/types.js +19 -0
  89. package/dist/voice/testing/types.js.map +1 -0
  90. package/package.json +3 -4
  91. package/src/index.ts +0 -2
  92. package/src/inference/utils.ts +0 -15
  93. package/src/stream/stream_channel.ts +2 -6
  94. package/src/telemetry/trace_types.ts +0 -7
  95. package/src/voice/agent_activity.ts +24 -83
  96. package/src/voice/agent_session.ts +74 -49
  97. package/src/voice/audio_recognition.ts +1 -161
  98. package/src/voice/index.ts +1 -0
  99. package/src/voice/room_io/room_io.ts +1 -0
  100. package/src/voice/speech_handle.ts +24 -4
  101. package/src/voice/testing/index.ts +50 -0
  102. package/src/voice/testing/run_result.ts +937 -0
  103. package/src/voice/testing/types.ts +118 -0
  104. package/dist/inference/interruption/AdaptiveInterruptionDetector.cjs +0 -152
  105. package/dist/inference/interruption/AdaptiveInterruptionDetector.cjs.map +0 -1
  106. package/dist/inference/interruption/AdaptiveInterruptionDetector.d.cts +0 -50
  107. package/dist/inference/interruption/AdaptiveInterruptionDetector.d.ts +0 -50
  108. package/dist/inference/interruption/AdaptiveInterruptionDetector.d.ts.map +0 -1
  109. package/dist/inference/interruption/AdaptiveInterruptionDetector.js +0 -125
  110. package/dist/inference/interruption/AdaptiveInterruptionDetector.js.map +0 -1
  111. package/dist/inference/interruption/InterruptionStream.cjs +0 -310
  112. package/dist/inference/interruption/InterruptionStream.cjs.map +0 -1
  113. package/dist/inference/interruption/InterruptionStream.d.cts +0 -57
  114. package/dist/inference/interruption/InterruptionStream.d.ts +0 -57
  115. package/dist/inference/interruption/InterruptionStream.d.ts.map +0 -1
  116. package/dist/inference/interruption/InterruptionStream.js +0 -288
  117. package/dist/inference/interruption/InterruptionStream.js.map +0 -1
  118. package/dist/inference/interruption/defaults.cjs +0 -76
  119. package/dist/inference/interruption/defaults.cjs.map +0 -1
  120. package/dist/inference/interruption/defaults.d.cts +0 -14
  121. package/dist/inference/interruption/defaults.d.ts +0 -14
  122. package/dist/inference/interruption/defaults.d.ts.map +0 -1
  123. package/dist/inference/interruption/defaults.js +0 -42
  124. package/dist/inference/interruption/defaults.js.map +0 -1
  125. package/dist/inference/interruption/errors.cjs +0 -2
  126. package/dist/inference/interruption/errors.cjs.map +0 -1
  127. package/dist/inference/interruption/errors.d.cts +0 -2
  128. package/dist/inference/interruption/errors.d.ts +0 -2
  129. package/dist/inference/interruption/errors.d.ts.map +0 -1
  130. package/dist/inference/interruption/errors.js +0 -1
  131. package/dist/inference/interruption/errors.js.map +0 -1
  132. package/dist/inference/interruption/http_transport.cjs +0 -57
  133. package/dist/inference/interruption/http_transport.cjs.map +0 -1
  134. package/dist/inference/interruption/http_transport.d.cts +0 -23
  135. package/dist/inference/interruption/http_transport.d.ts +0 -23
  136. package/dist/inference/interruption/http_transport.d.ts.map +0 -1
  137. package/dist/inference/interruption/http_transport.js +0 -33
  138. package/dist/inference/interruption/http_transport.js.map +0 -1
  139. package/dist/inference/interruption/index.cjs.map +0 -1
  140. package/dist/inference/interruption/index.d.cts +0 -5
  141. package/dist/inference/interruption/index.d.ts +0 -5
  142. package/dist/inference/interruption/index.d.ts.map +0 -1
  143. package/dist/inference/interruption/index.js +0 -7
  144. package/dist/inference/interruption/index.js.map +0 -1
  145. package/dist/inference/interruption/interruption.cjs +0 -85
  146. package/dist/inference/interruption/interruption.cjs.map +0 -1
  147. package/dist/inference/interruption/interruption.d.cts +0 -48
  148. package/dist/inference/interruption/interruption.d.ts +0 -48
  149. package/dist/inference/interruption/interruption.d.ts.map +0 -1
  150. package/dist/inference/interruption/interruption.js +0 -59
  151. package/dist/inference/interruption/interruption.js.map +0 -1
  152. package/dist/inference/utils.test.cjs +0 -20
  153. package/dist/inference/utils.test.cjs.map +0 -1
  154. package/dist/inference/utils.test.js +0 -19
  155. package/dist/inference/utils.test.js.map +0 -1
  156. package/dist/utils/ws_transport.cjs +0 -51
  157. package/dist/utils/ws_transport.cjs.map +0 -1
  158. package/dist/utils/ws_transport.d.cts +0 -9
  159. package/dist/utils/ws_transport.d.ts +0 -9
  160. package/dist/utils/ws_transport.d.ts.map +0 -1
  161. package/dist/utils/ws_transport.js +0 -17
  162. package/dist/utils/ws_transport.js.map +0 -1
  163. package/dist/utils/ws_transport.test.cjs +0 -212
  164. package/dist/utils/ws_transport.test.cjs.map +0 -1
  165. package/dist/utils/ws_transport.test.js +0 -211
  166. package/dist/utils/ws_transport.test.js.map +0 -1
  167. package/src/inference/interruption/AdaptiveInterruptionDetector.ts +0 -166
  168. package/src/inference/interruption/InterruptionStream.ts +0 -397
  169. package/src/inference/interruption/defaults.ts +0 -33
  170. package/src/inference/interruption/errors.ts +0 -0
  171. package/src/inference/interruption/http_transport.ts +0 -61
  172. package/src/inference/interruption/index.ts +0 -4
  173. package/src/inference/interruption/interruption.ts +0 -88
  174. package/src/inference/utils.test.ts +0 -31
  175. package/src/utils/ws_transport.test.ts +0 -282
  176. package/src/utils/ws_transport.ts +0 -22
@@ -1,212 +0,0 @@
1
- "use strict";
2
- var import_vitest = require("vitest");
3
- var import_ws = require("ws");
4
- var import_ws_transport = require("./ws_transport.cjs");
5
- (0, import_vitest.describe)("webSocketStream", () => {
6
- (0, import_vitest.describe)("readable stream", () => {
7
- (0, import_vitest.it)("receives messages from the WebSocket", async () => {
8
- const wss = await new Promise((resolve) => {
9
- const server = new import_ws.WebSocketServer({ port: 0 }, () => resolve(server));
10
- });
11
- const port = wss.address().port;
12
- wss.on("connection", (serverWs) => {
13
- serverWs.send("hello");
14
- serverWs.send("world");
15
- serverWs.close();
16
- });
17
- const { readable } = (0, import_ws_transport.webSocketStream)(`ws://localhost:${port}`);
18
- const reader = readable.getReader();
19
- const messages = [];
20
- try {
21
- while (true) {
22
- const { done, value } = await reader.read();
23
- if (done) break;
24
- messages.push(Buffer.from(value).toString());
25
- }
26
- } finally {
27
- reader.releaseLock();
28
- }
29
- (0, import_vitest.expect)(messages).toEqual(["hello", "world"]);
30
- wss.close();
31
- });
32
- (0, import_vitest.it)("handles binary messages", async () => {
33
- const wss = await new Promise((resolve) => {
34
- const server = new import_ws.WebSocketServer({ port: 0 }, () => resolve(server));
35
- });
36
- const port = wss.address().port;
37
- const binaryData = new Uint8Array([1, 2, 3, 4, 5]);
38
- wss.on("connection", (serverWs) => {
39
- serverWs.send(binaryData);
40
- serverWs.close();
41
- });
42
- const { readable } = (0, import_ws_transport.webSocketStream)(`ws://localhost:${port}`);
43
- const reader = readable.getReader();
44
- const chunks = [];
45
- try {
46
- while (true) {
47
- const { done, value } = await reader.read();
48
- if (done) break;
49
- chunks.push(new Uint8Array(value));
50
- }
51
- } finally {
52
- reader.releaseLock();
53
- }
54
- (0, import_vitest.expect)(chunks).toHaveLength(1);
55
- (0, import_vitest.expect)(Array.from(chunks[0])).toEqual([1, 2, 3, 4, 5]);
56
- wss.close();
57
- });
58
- (0, import_vitest.it)("handles empty stream when connection closes immediately", async () => {
59
- const wss = await new Promise((resolve) => {
60
- const server = new import_ws.WebSocketServer({ port: 0 }, () => resolve(server));
61
- });
62
- const port = wss.address().port;
63
- wss.on("connection", (serverWs) => {
64
- serverWs.close();
65
- });
66
- const { readable } = (0, import_ws_transport.webSocketStream)(`ws://localhost:${port}`);
67
- const reader = readable.getReader();
68
- const chunks = [];
69
- try {
70
- while (true) {
71
- const { done, value } = await reader.read();
72
- if (done) break;
73
- chunks.push(value);
74
- }
75
- } finally {
76
- reader.releaseLock();
77
- }
78
- (0, import_vitest.expect)(chunks).toEqual([]);
79
- wss.close();
80
- });
81
- });
82
- (0, import_vitest.describe)("writable stream", () => {
83
- (0, import_vitest.it)("sends messages through the WebSocket", async () => {
84
- const wss = await new Promise((resolve) => {
85
- const server = new import_ws.WebSocketServer({ port: 0 }, () => resolve(server));
86
- });
87
- const port = wss.address().port;
88
- const ws = new import_ws.WebSocket(`ws://localhost:${port}`);
89
- const connected = new Promise((resolve) => {
90
- ws.on("open", resolve);
91
- });
92
- const messagesReceived = [];
93
- const serverClosed = new Promise((resolve) => {
94
- wss.on("connection", (serverWs) => {
95
- serverWs.on("message", (data) => {
96
- messagesReceived.push(data.toString());
97
- });
98
- serverWs.on("close", resolve);
99
- });
100
- });
101
- await connected;
102
- const { writable } = (0, import_ws_transport.webSocketStream)(`ws://localhost:${port}`);
103
- const writer = writable.getWriter();
104
- await writer.write(new TextEncoder().encode("hello"));
105
- await writer.write(new TextEncoder().encode("world"));
106
- await writer.close();
107
- await serverClosed;
108
- (0, import_vitest.expect)(messagesReceived).toEqual(["hello", "world"]);
109
- wss.close();
110
- });
111
- (0, import_vitest.it)("sends binary data through the WebSocket", async () => {
112
- const wss = await new Promise((resolve) => {
113
- const server = new import_ws.WebSocketServer({ port: 0 }, () => resolve(server));
114
- });
115
- const port = wss.address().port;
116
- const chunksReceived = [];
117
- const serverClosed = new Promise((resolve) => {
118
- wss.on("connection", (serverWs) => {
119
- serverWs.on("message", (data) => {
120
- chunksReceived.push(Buffer.from(data));
121
- });
122
- serverWs.on("close", resolve);
123
- });
124
- });
125
- const { writable } = (0, import_ws_transport.webSocketStream)(`ws://localhost:${port}`);
126
- const writer = writable.getWriter();
127
- const binaryData = new Uint8Array([10, 20, 30, 40, 50]);
128
- await writer.write(binaryData);
129
- await writer.close();
130
- await serverClosed;
131
- (0, import_vitest.expect)(chunksReceived).toHaveLength(1);
132
- (0, import_vitest.expect)(Array.from(chunksReceived[0])).toEqual([10, 20, 30, 40, 50]);
133
- wss.close();
134
- });
135
- (0, import_vitest.it)("buffers writes if readyState is CONNECTING", async () => {
136
- const wss = await new Promise((resolve) => {
137
- const server = new import_ws.WebSocketServer({ port: 0 }, () => resolve(server));
138
- });
139
- const port = wss.address().port;
140
- const { writable } = (0, import_ws_transport.webSocketStream)(`ws://localhost:${port}`);
141
- const writer = writable.getWriter();
142
- const messagesReceived = [];
143
- const serverClosed = new Promise((resolve) => {
144
- wss.on("connection", (serverWs) => {
145
- serverWs.on("message", (data) => {
146
- messagesReceived.push(data.toString());
147
- });
148
- serverWs.on("close", resolve);
149
- });
150
- });
151
- await writer.write(new TextEncoder().encode("buffered message"));
152
- await writer.close();
153
- await serverClosed;
154
- (0, import_vitest.expect)(messagesReceived).toEqual(["buffered message"]);
155
- wss.close();
156
- });
157
- });
158
- (0, import_vitest.describe)("bidirectional communication", () => {
159
- (0, import_vitest.it)("supports echo pattern with readable and writable", async () => {
160
- const wss = await new Promise((resolve) => {
161
- const server = new import_ws.WebSocketServer({ port: 0 }, () => resolve(server));
162
- });
163
- const port = wss.address().port;
164
- wss.on("connection", (serverWs) => {
165
- serverWs.on("message", (data) => {
166
- serverWs.send(data);
167
- });
168
- });
169
- const { readable, writable } = (0, import_ws_transport.webSocketStream)(`ws://localhost:${port}`);
170
- const writer = writable.getWriter();
171
- const reader = readable.getReader();
172
- await writer.write(new TextEncoder().encode("ping1"));
173
- await writer.write(new TextEncoder().encode("ping2"));
174
- const { value: response1 } = await reader.read();
175
- const { value: response2 } = await reader.read();
176
- (0, import_vitest.expect)(Buffer.from(response1).toString()).toBe("ping1");
177
- (0, import_vitest.expect)(Buffer.from(response2).toString()).toBe("ping2");
178
- reader.releaseLock();
179
- await writer.close();
180
- wss.close();
181
- });
182
- });
183
- (0, import_vitest.describe)("error handling", () => {
184
- (0, import_vitest.it)("readable stream ends when WebSocket closes unexpectedly", async () => {
185
- const wss = await new Promise((resolve) => {
186
- const server = new import_ws.WebSocketServer({ port: 0 }, () => resolve(server));
187
- });
188
- const port = wss.address().port;
189
- wss.on("connection", (serverWs) => {
190
- serverWs.send("before close");
191
- serverWs.terminate();
192
- });
193
- const { readable } = (0, import_ws_transport.webSocketStream)(`ws://localhost:${port}`);
194
- const reader = readable.getReader();
195
- const chunks = [];
196
- try {
197
- while (true) {
198
- const { done, value } = await reader.read();
199
- if (done) break;
200
- chunks.push(Buffer.from(value).toString());
201
- }
202
- } catch (error) {
203
- console.error(error);
204
- } finally {
205
- reader.releaseLock();
206
- }
207
- (0, import_vitest.expect)(chunks).toContain("before close");
208
- wss.close();
209
- });
210
- });
211
- });
212
- //# sourceMappingURL=ws_transport.test.cjs.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../../src/utils/ws_transport.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { describe, expect, it } from 'vitest';\nimport { WebSocket, WebSocketServer } from 'ws';\nimport { webSocketStream } from './ws_transport.js';\n\ndescribe('webSocketStream', () => {\n describe('readable stream', () => {\n it('receives messages from the WebSocket', async () => {\n const wss = await new Promise<WebSocketServer>((resolve) => {\n const server: WebSocketServer = new WebSocketServer({ port: 0 }, () => resolve(server));\n });\n\n const port = (wss.address() as { port: number }).port;\n\n wss.on('connection', (serverWs) => {\n serverWs.send('hello');\n serverWs.send('world');\n serverWs.close();\n });\n\n const { readable } = webSocketStream(`ws://localhost:${port}`);\n const reader = readable.getReader();\n\n const messages: string[] = [];\n try {\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n messages.push(Buffer.from(value).toString());\n }\n } finally {\n reader.releaseLock();\n }\n\n expect(messages).toEqual(['hello', 'world']);\n\n wss.close();\n });\n\n it('handles binary messages', async () => {\n const wss = await new Promise<WebSocketServer>((resolve) => {\n const server: WebSocketServer = new WebSocketServer({ port: 0 }, () => resolve(server));\n });\n\n const port = (wss.address() as { port: number }).port;\n\n const binaryData = new Uint8Array([1, 2, 3, 4, 5]);\n\n wss.on('connection', (serverWs) => {\n serverWs.send(binaryData);\n serverWs.close();\n });\n\n const { readable } = webSocketStream(`ws://localhost:${port}`);\n const reader = readable.getReader();\n\n const chunks: Uint8Array[] = [];\n try {\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n chunks.push(new Uint8Array(value));\n }\n } finally {\n reader.releaseLock();\n }\n\n expect(chunks).toHaveLength(1);\n expect(Array.from(chunks[0]!)).toEqual([1, 2, 3, 4, 5]);\n\n wss.close();\n });\n\n it('handles empty stream when connection closes immediately', async () => {\n const wss = await new Promise<WebSocketServer>((resolve) => {\n const server: WebSocketServer = new WebSocketServer({ port: 0 }, () => resolve(server));\n });\n\n const port = (wss.address() as { port: number }).port;\n\n wss.on('connection', (serverWs) => {\n serverWs.close();\n });\n const { readable } = webSocketStream(`ws://localhost:${port}`);\n const reader = readable.getReader();\n\n const chunks: Uint8Array[] = [];\n try {\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n chunks.push(value);\n }\n } finally {\n reader.releaseLock();\n }\n\n expect(chunks).toEqual([]);\n\n wss.close();\n });\n });\n\n describe('writable stream', () => {\n it('sends messages through the WebSocket', async () => {\n const wss = await new Promise<WebSocketServer>((resolve) => {\n const server: WebSocketServer = new WebSocketServer({ port: 0 }, () => resolve(server));\n });\n\n const port = (wss.address() as { port: number }).port;\n const ws = new WebSocket(`ws://localhost:${port}`);\n\n const connected = new Promise<void>((resolve) => {\n ws.on('open', resolve);\n });\n\n const messagesReceived: string[] = [];\n const serverClosed = new Promise<void>((resolve) => {\n wss.on('connection', (serverWs) => {\n serverWs.on('message', (data) => {\n messagesReceived.push(data.toString());\n });\n serverWs.on('close', resolve);\n });\n });\n\n await connected;\n const { writable } = webSocketStream(`ws://localhost:${port}`);\n const writer = writable.getWriter();\n\n await writer.write(new TextEncoder().encode('hello'));\n await writer.write(new TextEncoder().encode('world'));\n await writer.close();\n\n await serverClosed;\n\n expect(messagesReceived).toEqual(['hello', 'world']);\n\n wss.close();\n });\n\n it('sends binary data through the WebSocket', async () => {\n const wss = await new Promise<WebSocketServer>((resolve) => {\n const server: WebSocketServer = new WebSocketServer({ port: 0 }, () => resolve(server));\n });\n\n const port = (wss.address() as { port: number }).port;\n\n const chunksReceived: Buffer[] = [];\n const serverClosed = new Promise<void>((resolve) => {\n wss.on('connection', (serverWs) => {\n serverWs.on('message', (data) => {\n chunksReceived.push(Buffer.from(data as Buffer));\n });\n serverWs.on('close', resolve);\n });\n });\n\n const { writable } = webSocketStream(`ws://localhost:${port}`);\n const writer = writable.getWriter();\n\n const binaryData = new Uint8Array([10, 20, 30, 40, 50]);\n await writer.write(binaryData);\n await writer.close();\n\n await serverClosed;\n\n expect(chunksReceived).toHaveLength(1);\n expect(Array.from(chunksReceived[0]!)).toEqual([10, 20, 30, 40, 50]);\n\n wss.close();\n });\n\n it('buffers writes if readyState is CONNECTING', async () => {\n const wss = await new Promise<WebSocketServer>((resolve) => {\n const server: WebSocketServer = new WebSocketServer({ port: 0 }, () => resolve(server));\n });\n\n const port = (wss.address() as { port: number }).port;\n\n const { writable } = webSocketStream(`ws://localhost:${port}`);\n const writer = writable.getWriter();\n\n const messagesReceived: string[] = [];\n const serverClosed = new Promise<void>((resolve) => {\n wss.on('connection', (serverWs) => {\n serverWs.on('message', (data) => {\n messagesReceived.push(data.toString());\n });\n serverWs.on('close', resolve);\n });\n });\n\n // These writes should be buffered\n await writer.write(new TextEncoder().encode('buffered message'));\n await writer.close();\n\n await serverClosed;\n\n expect(messagesReceived).toEqual(['buffered message']);\n\n wss.close();\n });\n });\n\n describe('bidirectional communication', () => {\n it('supports echo pattern with readable and writable', async () => {\n const wss = await new Promise<WebSocketServer>((resolve) => {\n const server: WebSocketServer = new WebSocketServer({ port: 0 }, () => resolve(server));\n });\n\n const port = (wss.address() as { port: number }).port;\n\n // Server echoes messages back\n wss.on('connection', (serverWs) => {\n serverWs.on('message', (data) => {\n serverWs.send(data);\n });\n });\n\n const { readable, writable } = webSocketStream(`ws://localhost:${port}`);\n const writer = writable.getWriter();\n const reader = readable.getReader();\n\n // Send messages\n await writer.write(new TextEncoder().encode('ping1'));\n await writer.write(new TextEncoder().encode('ping2'));\n\n // Read echoed responses\n const { value: response1 } = await reader.read();\n const { value: response2 } = await reader.read();\n\n expect(Buffer.from(response1!).toString()).toBe('ping1');\n expect(Buffer.from(response2!).toString()).toBe('ping2');\n\n reader.releaseLock();\n await writer.close();\n\n wss.close();\n });\n });\n\n describe('error handling', () => {\n it('readable stream ends when WebSocket closes unexpectedly', async () => {\n const wss = await new Promise<WebSocketServer>((resolve) => {\n const server: WebSocketServer = new WebSocketServer({ port: 0 }, () => resolve(server));\n });\n\n const port = (wss.address() as { port: number }).port;\n\n wss.on('connection', (serverWs) => {\n serverWs.send('before close');\n // Terminate connection abruptly\n serverWs.terminate();\n });\n\n const { readable } = webSocketStream(`ws://localhost:${port}`);\n const reader = readable.getReader();\n\n const chunks: string[] = [];\n try {\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n chunks.push(Buffer.from(value).toString());\n }\n } catch (error) {\n console.error(error);\n // Connection terminated, stream may error\n } finally {\n reader.releaseLock();\n }\n\n // Should have received the message sent before termination\n expect(chunks).toContain('before close');\n\n wss.close();\n });\n });\n});\n"],"mappings":"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","names":[]}
@@ -1,211 +0,0 @@
1
- import { describe, expect, it } from "vitest";
2
- import { WebSocket, WebSocketServer } from "ws";
3
- import { webSocketStream } from "./ws_transport.js";
4
- describe("webSocketStream", () => {
5
- describe("readable stream", () => {
6
- it("receives messages from the WebSocket", async () => {
7
- const wss = await new Promise((resolve) => {
8
- const server = new WebSocketServer({ port: 0 }, () => resolve(server));
9
- });
10
- const port = wss.address().port;
11
- wss.on("connection", (serverWs) => {
12
- serverWs.send("hello");
13
- serverWs.send("world");
14
- serverWs.close();
15
- });
16
- const { readable } = webSocketStream(`ws://localhost:${port}`);
17
- const reader = readable.getReader();
18
- const messages = [];
19
- try {
20
- while (true) {
21
- const { done, value } = await reader.read();
22
- if (done) break;
23
- messages.push(Buffer.from(value).toString());
24
- }
25
- } finally {
26
- reader.releaseLock();
27
- }
28
- expect(messages).toEqual(["hello", "world"]);
29
- wss.close();
30
- });
31
- it("handles binary messages", async () => {
32
- const wss = await new Promise((resolve) => {
33
- const server = new WebSocketServer({ port: 0 }, () => resolve(server));
34
- });
35
- const port = wss.address().port;
36
- const binaryData = new Uint8Array([1, 2, 3, 4, 5]);
37
- wss.on("connection", (serverWs) => {
38
- serverWs.send(binaryData);
39
- serverWs.close();
40
- });
41
- const { readable } = webSocketStream(`ws://localhost:${port}`);
42
- const reader = readable.getReader();
43
- const chunks = [];
44
- try {
45
- while (true) {
46
- const { done, value } = await reader.read();
47
- if (done) break;
48
- chunks.push(new Uint8Array(value));
49
- }
50
- } finally {
51
- reader.releaseLock();
52
- }
53
- expect(chunks).toHaveLength(1);
54
- expect(Array.from(chunks[0])).toEqual([1, 2, 3, 4, 5]);
55
- wss.close();
56
- });
57
- it("handles empty stream when connection closes immediately", async () => {
58
- const wss = await new Promise((resolve) => {
59
- const server = new WebSocketServer({ port: 0 }, () => resolve(server));
60
- });
61
- const port = wss.address().port;
62
- wss.on("connection", (serverWs) => {
63
- serverWs.close();
64
- });
65
- const { readable } = webSocketStream(`ws://localhost:${port}`);
66
- const reader = readable.getReader();
67
- const chunks = [];
68
- try {
69
- while (true) {
70
- const { done, value } = await reader.read();
71
- if (done) break;
72
- chunks.push(value);
73
- }
74
- } finally {
75
- reader.releaseLock();
76
- }
77
- expect(chunks).toEqual([]);
78
- wss.close();
79
- });
80
- });
81
- describe("writable stream", () => {
82
- it("sends messages through the WebSocket", async () => {
83
- const wss = await new Promise((resolve) => {
84
- const server = new WebSocketServer({ port: 0 }, () => resolve(server));
85
- });
86
- const port = wss.address().port;
87
- const ws = new WebSocket(`ws://localhost:${port}`);
88
- const connected = new Promise((resolve) => {
89
- ws.on("open", resolve);
90
- });
91
- const messagesReceived = [];
92
- const serverClosed = new Promise((resolve) => {
93
- wss.on("connection", (serverWs) => {
94
- serverWs.on("message", (data) => {
95
- messagesReceived.push(data.toString());
96
- });
97
- serverWs.on("close", resolve);
98
- });
99
- });
100
- await connected;
101
- const { writable } = webSocketStream(`ws://localhost:${port}`);
102
- const writer = writable.getWriter();
103
- await writer.write(new TextEncoder().encode("hello"));
104
- await writer.write(new TextEncoder().encode("world"));
105
- await writer.close();
106
- await serverClosed;
107
- expect(messagesReceived).toEqual(["hello", "world"]);
108
- wss.close();
109
- });
110
- it("sends binary data through the WebSocket", async () => {
111
- const wss = await new Promise((resolve) => {
112
- const server = new WebSocketServer({ port: 0 }, () => resolve(server));
113
- });
114
- const port = wss.address().port;
115
- const chunksReceived = [];
116
- const serverClosed = new Promise((resolve) => {
117
- wss.on("connection", (serverWs) => {
118
- serverWs.on("message", (data) => {
119
- chunksReceived.push(Buffer.from(data));
120
- });
121
- serverWs.on("close", resolve);
122
- });
123
- });
124
- const { writable } = webSocketStream(`ws://localhost:${port}`);
125
- const writer = writable.getWriter();
126
- const binaryData = new Uint8Array([10, 20, 30, 40, 50]);
127
- await writer.write(binaryData);
128
- await writer.close();
129
- await serverClosed;
130
- expect(chunksReceived).toHaveLength(1);
131
- expect(Array.from(chunksReceived[0])).toEqual([10, 20, 30, 40, 50]);
132
- wss.close();
133
- });
134
- it("buffers writes if readyState is CONNECTING", async () => {
135
- const wss = await new Promise((resolve) => {
136
- const server = new WebSocketServer({ port: 0 }, () => resolve(server));
137
- });
138
- const port = wss.address().port;
139
- const { writable } = webSocketStream(`ws://localhost:${port}`);
140
- const writer = writable.getWriter();
141
- const messagesReceived = [];
142
- const serverClosed = new Promise((resolve) => {
143
- wss.on("connection", (serverWs) => {
144
- serverWs.on("message", (data) => {
145
- messagesReceived.push(data.toString());
146
- });
147
- serverWs.on("close", resolve);
148
- });
149
- });
150
- await writer.write(new TextEncoder().encode("buffered message"));
151
- await writer.close();
152
- await serverClosed;
153
- expect(messagesReceived).toEqual(["buffered message"]);
154
- wss.close();
155
- });
156
- });
157
- describe("bidirectional communication", () => {
158
- it("supports echo pattern with readable and writable", async () => {
159
- const wss = await new Promise((resolve) => {
160
- const server = new WebSocketServer({ port: 0 }, () => resolve(server));
161
- });
162
- const port = wss.address().port;
163
- wss.on("connection", (serverWs) => {
164
- serverWs.on("message", (data) => {
165
- serverWs.send(data);
166
- });
167
- });
168
- const { readable, writable } = webSocketStream(`ws://localhost:${port}`);
169
- const writer = writable.getWriter();
170
- const reader = readable.getReader();
171
- await writer.write(new TextEncoder().encode("ping1"));
172
- await writer.write(new TextEncoder().encode("ping2"));
173
- const { value: response1 } = await reader.read();
174
- const { value: response2 } = await reader.read();
175
- expect(Buffer.from(response1).toString()).toBe("ping1");
176
- expect(Buffer.from(response2).toString()).toBe("ping2");
177
- reader.releaseLock();
178
- await writer.close();
179
- wss.close();
180
- });
181
- });
182
- describe("error handling", () => {
183
- it("readable stream ends when WebSocket closes unexpectedly", async () => {
184
- const wss = await new Promise((resolve) => {
185
- const server = new WebSocketServer({ port: 0 }, () => resolve(server));
186
- });
187
- const port = wss.address().port;
188
- wss.on("connection", (serverWs) => {
189
- serverWs.send("before close");
190
- serverWs.terminate();
191
- });
192
- const { readable } = webSocketStream(`ws://localhost:${port}`);
193
- const reader = readable.getReader();
194
- const chunks = [];
195
- try {
196
- while (true) {
197
- const { done, value } = await reader.read();
198
- if (done) break;
199
- chunks.push(Buffer.from(value).toString());
200
- }
201
- } catch (error) {
202
- console.error(error);
203
- } finally {
204
- reader.releaseLock();
205
- }
206
- expect(chunks).toContain("before close");
207
- wss.close();
208
- });
209
- });
210
- });
211
- //# sourceMappingURL=ws_transport.test.js.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../../src/utils/ws_transport.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { describe, expect, it } from 'vitest';\nimport { WebSocket, WebSocketServer } from 'ws';\nimport { webSocketStream } from './ws_transport.js';\n\ndescribe('webSocketStream', () => {\n describe('readable stream', () => {\n it('receives messages from the WebSocket', async () => {\n const wss = await new Promise<WebSocketServer>((resolve) => {\n const server: WebSocketServer = new WebSocketServer({ port: 0 }, () => resolve(server));\n });\n\n const port = (wss.address() as { port: number }).port;\n\n wss.on('connection', (serverWs) => {\n serverWs.send('hello');\n serverWs.send('world');\n serverWs.close();\n });\n\n const { readable } = webSocketStream(`ws://localhost:${port}`);\n const reader = readable.getReader();\n\n const messages: string[] = [];\n try {\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n messages.push(Buffer.from(value).toString());\n }\n } finally {\n reader.releaseLock();\n }\n\n expect(messages).toEqual(['hello', 'world']);\n\n wss.close();\n });\n\n it('handles binary messages', async () => {\n const wss = await new Promise<WebSocketServer>((resolve) => {\n const server: WebSocketServer = new WebSocketServer({ port: 0 }, () => resolve(server));\n });\n\n const port = (wss.address() as { port: number }).port;\n\n const binaryData = new Uint8Array([1, 2, 3, 4, 5]);\n\n wss.on('connection', (serverWs) => {\n serverWs.send(binaryData);\n serverWs.close();\n });\n\n const { readable } = webSocketStream(`ws://localhost:${port}`);\n const reader = readable.getReader();\n\n const chunks: Uint8Array[] = [];\n try {\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n chunks.push(new Uint8Array(value));\n }\n } finally {\n reader.releaseLock();\n }\n\n expect(chunks).toHaveLength(1);\n expect(Array.from(chunks[0]!)).toEqual([1, 2, 3, 4, 5]);\n\n wss.close();\n });\n\n it('handles empty stream when connection closes immediately', async () => {\n const wss = await new Promise<WebSocketServer>((resolve) => {\n const server: WebSocketServer = new WebSocketServer({ port: 0 }, () => resolve(server));\n });\n\n const port = (wss.address() as { port: number }).port;\n\n wss.on('connection', (serverWs) => {\n serverWs.close();\n });\n const { readable } = webSocketStream(`ws://localhost:${port}`);\n const reader = readable.getReader();\n\n const chunks: Uint8Array[] = [];\n try {\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n chunks.push(value);\n }\n } finally {\n reader.releaseLock();\n }\n\n expect(chunks).toEqual([]);\n\n wss.close();\n });\n });\n\n describe('writable stream', () => {\n it('sends messages through the WebSocket', async () => {\n const wss = await new Promise<WebSocketServer>((resolve) => {\n const server: WebSocketServer = new WebSocketServer({ port: 0 }, () => resolve(server));\n });\n\n const port = (wss.address() as { port: number }).port;\n const ws = new WebSocket(`ws://localhost:${port}`);\n\n const connected = new Promise<void>((resolve) => {\n ws.on('open', resolve);\n });\n\n const messagesReceived: string[] = [];\n const serverClosed = new Promise<void>((resolve) => {\n wss.on('connection', (serverWs) => {\n serverWs.on('message', (data) => {\n messagesReceived.push(data.toString());\n });\n serverWs.on('close', resolve);\n });\n });\n\n await connected;\n const { writable } = webSocketStream(`ws://localhost:${port}`);\n const writer = writable.getWriter();\n\n await writer.write(new TextEncoder().encode('hello'));\n await writer.write(new TextEncoder().encode('world'));\n await writer.close();\n\n await serverClosed;\n\n expect(messagesReceived).toEqual(['hello', 'world']);\n\n wss.close();\n });\n\n it('sends binary data through the WebSocket', async () => {\n const wss = await new Promise<WebSocketServer>((resolve) => {\n const server: WebSocketServer = new WebSocketServer({ port: 0 }, () => resolve(server));\n });\n\n const port = (wss.address() as { port: number }).port;\n\n const chunksReceived: Buffer[] = [];\n const serverClosed = new Promise<void>((resolve) => {\n wss.on('connection', (serverWs) => {\n serverWs.on('message', (data) => {\n chunksReceived.push(Buffer.from(data as Buffer));\n });\n serverWs.on('close', resolve);\n });\n });\n\n const { writable } = webSocketStream(`ws://localhost:${port}`);\n const writer = writable.getWriter();\n\n const binaryData = new Uint8Array([10, 20, 30, 40, 50]);\n await writer.write(binaryData);\n await writer.close();\n\n await serverClosed;\n\n expect(chunksReceived).toHaveLength(1);\n expect(Array.from(chunksReceived[0]!)).toEqual([10, 20, 30, 40, 50]);\n\n wss.close();\n });\n\n it('buffers writes if readyState is CONNECTING', async () => {\n const wss = await new Promise<WebSocketServer>((resolve) => {\n const server: WebSocketServer = new WebSocketServer({ port: 0 }, () => resolve(server));\n });\n\n const port = (wss.address() as { port: number }).port;\n\n const { writable } = webSocketStream(`ws://localhost:${port}`);\n const writer = writable.getWriter();\n\n const messagesReceived: string[] = [];\n const serverClosed = new Promise<void>((resolve) => {\n wss.on('connection', (serverWs) => {\n serverWs.on('message', (data) => {\n messagesReceived.push(data.toString());\n });\n serverWs.on('close', resolve);\n });\n });\n\n // These writes should be buffered\n await writer.write(new TextEncoder().encode('buffered message'));\n await writer.close();\n\n await serverClosed;\n\n expect(messagesReceived).toEqual(['buffered message']);\n\n wss.close();\n });\n });\n\n describe('bidirectional communication', () => {\n it('supports echo pattern with readable and writable', async () => {\n const wss = await new Promise<WebSocketServer>((resolve) => {\n const server: WebSocketServer = new WebSocketServer({ port: 0 }, () => resolve(server));\n });\n\n const port = (wss.address() as { port: number }).port;\n\n // Server echoes messages back\n wss.on('connection', (serverWs) => {\n serverWs.on('message', (data) => {\n serverWs.send(data);\n });\n });\n\n const { readable, writable } = webSocketStream(`ws://localhost:${port}`);\n const writer = writable.getWriter();\n const reader = readable.getReader();\n\n // Send messages\n await writer.write(new TextEncoder().encode('ping1'));\n await writer.write(new TextEncoder().encode('ping2'));\n\n // Read echoed responses\n const { value: response1 } = await reader.read();\n const { value: response2 } = await reader.read();\n\n expect(Buffer.from(response1!).toString()).toBe('ping1');\n expect(Buffer.from(response2!).toString()).toBe('ping2');\n\n reader.releaseLock();\n await writer.close();\n\n wss.close();\n });\n });\n\n describe('error handling', () => {\n it('readable stream ends when WebSocket closes unexpectedly', async () => {\n const wss = await new Promise<WebSocketServer>((resolve) => {\n const server: WebSocketServer = new WebSocketServer({ port: 0 }, () => resolve(server));\n });\n\n const port = (wss.address() as { port: number }).port;\n\n wss.on('connection', (serverWs) => {\n serverWs.send('before close');\n // Terminate connection abruptly\n serverWs.terminate();\n });\n\n const { readable } = webSocketStream(`ws://localhost:${port}`);\n const reader = readable.getReader();\n\n const chunks: string[] = [];\n try {\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n chunks.push(Buffer.from(value).toString());\n }\n } catch (error) {\n console.error(error);\n // Connection terminated, stream may error\n } finally {\n reader.releaseLock();\n }\n\n // Should have received the message sent before termination\n expect(chunks).toContain('before close');\n\n wss.close();\n });\n });\n});\n"],"mappings":"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","names":[]}
@@ -1,166 +0,0 @@
1
- import type { TypedEventEmitter } from '@livekit/typed-emitter';
2
- import EventEmitter from 'events';
3
- import { type ReadableStream, TransformStream } from 'stream/web';
4
- import { InterruptionStreamBase } from './InterruptionStream.js';
5
- import {
6
- DEFAULT_BASE_URL,
7
- FRAMES_PER_SECOND,
8
- SAMPLE_RATE,
9
- interruptionOptionDefaults,
10
- } from './defaults.js';
11
- import {
12
- type InterruptionDetectionError,
13
- type InterruptionEvent,
14
- InterruptionEventType,
15
- } from './interruption.js';
16
-
17
- type InterruptionCallbacks = {
18
- interruptionDetected: () => void;
19
- overlapSpeechDetected: () => void;
20
- error: (error: InterruptionDetectionError) => void;
21
- };
22
-
23
- export interface InterruptionOptions {
24
- sampleRate: number;
25
- threshold: number;
26
- minFrames: number;
27
- maxAudioDuration: number;
28
- audioPrefixDuration: number;
29
- detectionInterval: number;
30
- inferenceTimeout: number;
31
- minInterruptionDuration: number;
32
- baseUrl: string;
33
- apiKey: string;
34
- apiSecret: string;
35
- useProxy: boolean;
36
- }
37
-
38
- export type AdaptiveInterruptionDetectorOptions = Partial<InterruptionOptions>;
39
-
40
- export class AdaptiveInterruptionDetector extends (EventEmitter as new () => TypedEventEmitter<InterruptionCallbacks>) {
41
- options: InterruptionOptions;
42
- private label: string;
43
- private streams: WeakSet<object>; // TODO: Union of InterruptionHttpStream | InterruptionWebSocketStream
44
-
45
- constructor(options: AdaptiveInterruptionDetectorOptions = {}) {
46
- super();
47
-
48
- const {
49
- maxAudioDuration,
50
- baseUrl,
51
- apiKey,
52
- apiSecret,
53
- useProxy: useProxyArg,
54
- audioPrefixDuration,
55
- threshold,
56
- detectionInterval,
57
- inferenceTimeout,
58
- minInterruptionDuration,
59
- } = { ...interruptionOptionDefaults, ...options };
60
-
61
- if (maxAudioDuration > 3.0) {
62
- throw new Error('maxAudioDuration must be less than or equal to 3.0 seconds');
63
- }
64
-
65
- const lkBaseUrl = baseUrl ?? process.env.LIVEKIT_REMOTE_EOT_URL ?? DEFAULT_BASE_URL;
66
- let lkApiKey = apiKey ?? '';
67
- let lkApiSecret = apiSecret ?? '';
68
- let useProxy: boolean;
69
-
70
- // use LiveKit credentials if using the default base URL (inference)
71
- if (lkBaseUrl === DEFAULT_BASE_URL) {
72
- lkApiKey =
73
- apiKey ?? process.env.LIVEKIT_INFERENCE_API_KEY ?? process.env.LIVEKIT_API_KEY ?? '';
74
- if (!lkApiKey) {
75
- throw new Error(
76
- 'apiKey is required, either as argument or set LIVEKIT_API_KEY environmental variable',
77
- );
78
- }
79
-
80
- lkApiSecret =
81
- apiSecret ??
82
- process.env.LIVEKIT_INFERENCE_API_SECRET ??
83
- process.env.LIVEKIT_API_SECRET ??
84
- '';
85
- if (!lkApiSecret) {
86
- throw new Error(
87
- 'apiSecret is required, either as argument or set LIVEKIT_API_SECRET environmental variable',
88
- );
89
- }
90
-
91
- useProxy = true;
92
- } else {
93
- useProxy = useProxyArg ?? false;
94
- }
95
-
96
- this.options = {
97
- sampleRate: SAMPLE_RATE,
98
- threshold,
99
- minFrames: Math.ceil(minInterruptionDuration * FRAMES_PER_SECOND),
100
- maxAudioDuration,
101
- audioPrefixDuration,
102
- detectionInterval,
103
- inferenceTimeout,
104
- baseUrl: lkBaseUrl,
105
- apiKey: lkApiKey,
106
- apiSecret: lkApiSecret,
107
- useProxy,
108
- minInterruptionDuration,
109
- };
110
-
111
- this.label = `${this.constructor.name}`;
112
- this.streams = new WeakSet();
113
-
114
- console.info('adaptive interruption detector initialized', {
115
- baseUrl: this.options.baseUrl,
116
- detectionInterval: this.options.detectionInterval,
117
- audioPrefixDuration: this.options.audioPrefixDuration,
118
- maxAudioDuration: this.options.maxAudioDuration,
119
- minFrames: this.options.minFrames,
120
- threshold: this.options.threshold,
121
- inferenceTimeout: this.options.inferenceTimeout,
122
- useProxy: this.options.useProxy,
123
- });
124
- }
125
-
126
- /**
127
- * Creates a new InterruptionStreamBase for internal use.
128
- * The stream can receive audio frames and sentinels via pushFrame().
129
- * Use this when you need direct access to the stream for pushing frames.
130
- */
131
- createStream(): InterruptionStreamBase {
132
- const stream = new InterruptionStreamBase(this, {});
133
- this.streams.add(stream);
134
- return stream;
135
- }
136
-
137
- /**
138
- * Creates a new interruption stream and returns a ReadableStream of InterruptionEvents.
139
- * This is a convenience method for consuming interruption events without needing
140
- * to manage the underlying stream directly.
141
- */
142
- stream(): ReadableStream<InterruptionEvent> {
143
- const httpStream = this.createStream();
144
- const transformer = new TransformStream<InterruptionEvent, InterruptionEvent>({
145
- transform: (chunk, controller) => {
146
- if (chunk.type === InterruptionEventType.INTERRUPTION) {
147
- this.emit('interruptionDetected'); // TODO payload
148
- } else if (chunk.type === InterruptionEventType.OVERLAP_SPEECH_ENDED) {
149
- this.emit('overlapSpeechDetected'); // TODO payload
150
- }
151
- controller.enqueue(chunk);
152
- },
153
- });
154
- const stream = httpStream.stream.pipeThrough(transformer);
155
- return stream;
156
- }
157
-
158
- updateOptions(options: { threshold?: number; minInterruptionDuration?: number }): void {
159
- if (options.threshold !== undefined) {
160
- this.options.threshold = options.threshold;
161
- }
162
- if (options.minInterruptionDuration !== undefined) {
163
- this.options.minFrames = Math.ceil(options.minInterruptionDuration * FRAMES_PER_SECOND);
164
- }
165
- }
166
- }