@livekit/agents 0.0.0-20260120144724

package/dist/stream/stream_channel.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/stream/stream_channel.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type { ReadableStream } from 'node:stream/web';\nimport { IdentityTransform } from './identity_transform.js';\n\nexport interface StreamChannel<T, E extends Error = Error> {\n  write(chunk: T): Promise<void>;\n  close(): Promise<void>;\n  stream(): ReadableStream<T>;\n  abort(error: E): Promise<void>;\n  readonly closed: boolean;\n}\n\nexport function createStreamChannel<T, E extends Error = Error>(): StreamChannel<T, E> {\n  const transform = new IdentityTransform<T>();\n  const writer = transform.writable.getWriter();\n  let isClosed = false;\n\n  return {\n    write: (chunk: T) => writer.write(chunk),\n    stream: () => transform.readable,\n    abort: (error: E) => {\n      return writer.abort(error);\n    },\n    close: async () => {\n      try {\n        const result = await writer.close();\n        isClosed = true;\n        return result;\n      } catch (e) {\n        if (e instanceof Error && e.name === 'TypeError') {\n          // Ignore error if the stream is already closed\n          isClosed = true;\n          return;\n        }\n        throw e;\n      }\n    },\n    get closed() {\n      return isClosed;\n    },\n  };\n}\n"],"mappings":"AAIA,SAAS,yBAAyB;AAU3B,SAAS,sBAAuE;AACrF,QAAM,YAAY,IAAI,kBAAqB;AAC3C,QAAM,SAAS,UAAU,SAAS,UAAU;AAC5C,MAAI,WAAW;AAEf,SAAO;AAAA,IACL,OAAO,CAAC,UAAa,OAAO,MAAM,KAAK;AAAA,IACvC,QAAQ,MAAM,UAAU;AAAA,IACxB,OAAO,CAAC,UAAa;AACnB,aAAO,OAAO,MAAM,KAAK;AAAA,IAC3B;AAAA,IACA,OAAO,YAAY;AACjB,UAAI;AACF,cAAM,SAAS,MAAM,OAAO,MAAM;AAClC,mBAAW;AACX,eAAO;AAAA,MACT,SAAS,GAAG;AACV,YAAI,aAAa,SAAS,EAAE,SAAS,aAAa;AAEhD,qBAAW;AACX;AAAA,QACF;AACA,cAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,IAAI,SAAS;AACX,aAAO;AAAA,IACT;AAAA,EACF;AACF;","names":[]}

package/dist/stream/stream_channel.test.cjs

@@ -0,0 +1,124 @@
+"use strict";
+var import_vitest = require("vitest");
+var import_stream_channel = require("./stream_channel.cjs");
+(0, import_vitest.describe)("StreamChannel", () => {
+  (0, import_vitest.it)("should write and read a single value", async () => {
+    const channel = (0, import_stream_channel.createStreamChannel)();
+    const reader = channel.stream().getReader();
+    await channel.write("test value");
+    await channel.close();
+    const result = await reader.read();
+    (0, import_vitest.expect)(result.done).toBe(false);
+    (0, import_vitest.expect)(result.value).toBe("test value");
+    const nextResult = await reader.read();
+    (0, import_vitest.expect)(nextResult.done).toBe(true);
+  });
+  (0, import_vitest.it)("should write and read multiple values in sequence", async () => {
+    const channel = (0, import_stream_channel.createStreamChannel)();
+    const reader = channel.stream().getReader();
+    const testValues = ["first", "second", "third"];
+    for (const value of testValues) {
+      await channel.write(value);
+    }
+    await channel.close();
+    const results = [];
+    let result = await reader.read();
+    while (!result.done) {
+      results.push(result.value);
+      result = await reader.read();
+    }
+    (0, import_vitest.expect)(results).toEqual(testValues);
+  });
+  (0, import_vitest.it)("should handle arrays", async () => {
+    const channel = (0, import_stream_channel.createStreamChannel)();
+    const reader = channel.stream().getReader();
+    const testArray = [1, 2, 3, 4, 5];
+    await channel.write(testArray);
+    await channel.close();
+    const result = await reader.read();
+    (0, import_vitest.expect)(result.value).toEqual(testArray);
+    (0, import_vitest.expect)(result.value).toBe(testArray);
+  });
+  (0, import_vitest.it)("should work with concurrent writing and reading", async () => {
+    const channel = (0, import_stream_channel.createStreamChannel)();
+    const reader = channel.stream().getReader();
+    const testData = ["chunk1", "chunk2", "chunk3"];
+    const results = [];
+    const readPromise = (async () => {
+      let result = await reader.read();
+      while (!result.done) {
+        results.push(result.value);
+        result = await reader.read();
+      }
+    })();
+    for (const chunk of testData) {
+      await channel.write(chunk);
+    }
+    await channel.close();
+    await readPromise;
+    (0, import_vitest.expect)(results).toEqual(testData);
+  });
+  (0, import_vitest.it)("should handle empty stream", async () => {
+    const channel = (0, import_stream_channel.createStreamChannel)();
+    const reader = channel.stream().getReader();
+    await channel.close();
+    const result = await reader.read();
+    (0, import_vitest.expect)(result.done).toBe(true);
+  });
+  (0, import_vitest.it)("should handle non-awaited sequential writes", async () => {
+    const channel = (0, import_stream_channel.createStreamChannel)();
+    const reader = channel.stream().getReader();
+    const testNumbers = Array.from({ length: 100 }, (_, i) => i);
+    for (const num of testNumbers) {
+      channel.write(num);
+    }
+    channel.close();
+    const results = [];
+    let result = await reader.read();
+    while (!result.done) {
+      results.push(result.value);
+      result = await reader.read();
+    }
+    (0, import_vitest.expect)(results).toEqual(testNumbers);
+  });
+  (0, import_vitest.it)("should handle double closing without error", async () => {
+    const channel = (0, import_stream_channel.createStreamChannel)();
+    const reader = channel.stream().getReader();
+    await channel.write("test");
+    await channel.close();
+    await (0, import_vitest.expect)(channel.close()).resolves.toBeUndefined();
+    const result = await reader.read();
+    (0, import_vitest.expect)(result.done).toBe(false);
+    (0, import_vitest.expect)(result.value).toBe("test");
+    const nextResult = await reader.read();
+    (0, import_vitest.expect)(nextResult.done).toBe(true);
+  });
+  (0, import_vitest.it)("should gracefully handle close while read is pending", async () => {
+    const channel = (0, import_stream_channel.createStreamChannel)();
+    const reader = channel.stream().getReader();
+    const readPromise = reader.read();
+    await channel.close();
+    const result = await readPromise;
+    (0, import_vitest.expect)(result.done).toBe(true);
+    (0, import_vitest.expect)(result.value).toBeUndefined();
+  });
+  (0, import_vitest.it)("should complete all pending reads when closed", async () => {
+    const channel = (0, import_stream_channel.createStreamChannel)();
+    const reader = channel.stream().getReader();
+    const read1 = reader.read();
+    const read2 = reader.read();
+    const read3 = reader.read();
+    await channel.write(42);
+    await channel.write(43);
+    await channel.close();
+    const result1 = await read1;
+    (0, import_vitest.expect)(result1.done).toBe(false);
+    (0, import_vitest.expect)(result1.value).toBe(42);
+    const result2 = await read2;
+    (0, import_vitest.expect)(result2.done).toBe(false);
+    (0, import_vitest.expect)(result2.value).toBe(43);
+    const result3 = await read3;
+    (0, import_vitest.expect)(result3.done).toBe(true);
+  });
+});
+//# sourceMappingURL=stream_channel.test.cjs.map

package/dist/stream/stream_channel.test.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/stream/stream_channel.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { describe, expect, it } from 'vitest';\nimport { createStreamChannel } from './stream_channel.js';\n\ndescribe('StreamChannel', () => {\n  it('should write and read a single value', async () => {\n    const channel = createStreamChannel<string>();\n    const reader = channel.stream().getReader();\n\n    await channel.write('test value');\n    await channel.close();\n\n    const result = await reader.read();\n    expect(result.done).toBe(false);\n    expect(result.value).toBe('test value');\n\n    const nextResult = await reader.read();\n    expect(nextResult.done).toBe(true);\n  });\n\n  it('should write and read multiple values in sequence', async () => {\n    const channel = createStreamChannel<string>();\n    const reader = channel.stream().getReader();\n\n    const testValues = ['first', 'second', 'third'];\n\n    for (const value of testValues) {\n      await channel.write(value);\n    }\n    await channel.close();\n\n    const results: string[] = [];\n    let result = await reader.read();\n    while (!result.done) {\n      results.push(result.value);\n      result = await reader.read();\n    }\n\n    expect(results).toEqual(testValues);\n  });\n\n  it('should handle arrays', async () => {\n    const channel = createStreamChannel<number[]>();\n    const reader = channel.stream().getReader();\n\n    const testArray = [1, 2, 3, 4, 5];\n    await channel.write(testArray);\n    await channel.close();\n\n    const result = await reader.read();\n    expect(result.value).toEqual(testArray);\n    expect(result.value).toBe(testArray);\n  });\n\n  it('should work with concurrent writing and reading', async () => {\n    const channel = createStreamChannel<string>();\n    const reader = channel.stream().getReader();\n\n    const testData = ['chunk1', 'chunk2', 'chunk3'];\n    const results: string[] = [];\n\n    const readPromise = (async () => {\n      let result = await reader.read();\n      while (!result.done) {\n        results.push(result.value);\n        result = await reader.read();\n      }\n    })();\n\n    for (const chunk of testData) {\n      await channel.write(chunk);\n    }\n    await channel.close();\n\n    await readPromise;\n    expect(results).toEqual(testData);\n  });\n\n  it('should handle empty stream', async () => {\n    const channel = createStreamChannel<string>();\n    const reader = channel.stream().getReader();\n\n    await channel.close();\n\n    const result = await reader.read();\n    expect(result.done).toBe(true);\n  });\n\n  it('should handle non-awaited sequential writes', async () => {\n    const channel = createStreamChannel<number>();\n    const reader = channel.stream().getReader();\n\n    const testNumbers = Array.from({ length: 100 }, (_, i) => i);\n\n    for (const num of testNumbers) {\n      channel.write(num);\n    }\n    channel.close();\n\n    const results: number[] = [];\n    let result = await reader.read();\n    while (!result.done) {\n      results.push(result.value);\n      result = await reader.read();\n    }\n\n    expect(results).toEqual(testNumbers);\n  });\n\n  it('should handle double closing without error', async () => {\n    const channel = createStreamChannel<string>();\n    const reader = channel.stream().getReader();\n\n    await channel.write('test');\n\n    await channel.close();\n    // Close again - should not throw\n    await expect(channel.close()).resolves.toBeUndefined();\n\n    const result = await reader.read();\n    expect(result.done).toBe(false);\n    expect(result.value).toBe('test');\n\n    const nextResult = await reader.read();\n    expect(nextResult.done).toBe(true);\n  });\n\n  it('should gracefully handle close while read is pending', async () => {\n    const channel = createStreamChannel<string>();\n    const reader = channel.stream().getReader();\n\n    const readPromise = reader.read();\n\n    await channel.close();\n\n    const result = await readPromise;\n    expect(result.done).toBe(true);\n    expect(result.value).toBeUndefined();\n  });\n\n  it('should complete all pending reads when closed', async () => {\n    const channel = createStreamChannel<number>();\n    const reader = channel.stream().getReader();\n\n    const read1 = reader.read();\n    const read2 = reader.read();\n    const read3 = reader.read();\n\n    await channel.write(42);\n    await channel.write(43);\n    await channel.close();\n\n    const result1 = await read1;\n    expect(result1.done).toBe(false);\n    expect(result1.value).toBe(42);\n\n    const result2 = await read2;\n    expect(result2.done).toBe(false);\n    expect(result2.value).toBe(43);\n\n    const result3 = await read3;\n    expect(result3.done).toBe(true);\n  });\n});\n"],"mappings":"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","names":[]}

package/dist/stream/stream_channel.test.js

@@ -0,0 +1,123 @@
+import { describe, expect, it } from "vitest";
+import { createStreamChannel } from "./stream_channel.js";
+describe("StreamChannel", () => {
+  it("should write and read a single value", async () => {
+    const channel = createStreamChannel();
+    const reader = channel.stream().getReader();
+    await channel.write("test value");
+    await channel.close();
+    const result = await reader.read();
+    expect(result.done).toBe(false);
+    expect(result.value).toBe("test value");
+    const nextResult = await reader.read();
+    expect(nextResult.done).toBe(true);
+  });
+  it("should write and read multiple values in sequence", async () => {
+    const channel = createStreamChannel();
+    const reader = channel.stream().getReader();
+    const testValues = ["first", "second", "third"];
+    for (const value of testValues) {
+      await channel.write(value);
+    }
+    await channel.close();
+    const results = [];
+    let result = await reader.read();
+    while (!result.done) {
+      results.push(result.value);
+      result = await reader.read();
+    }
+    expect(results).toEqual(testValues);
+  });
+  it("should handle arrays", async () => {
+    const channel = createStreamChannel();
+    const reader = channel.stream().getReader();
+    const testArray = [1, 2, 3, 4, 5];
+    await channel.write(testArray);
+    await channel.close();
+    const result = await reader.read();
+    expect(result.value).toEqual(testArray);
+    expect(result.value).toBe(testArray);
+  });
+  it("should work with concurrent writing and reading", async () => {
+    const channel = createStreamChannel();
+    const reader = channel.stream().getReader();
+    const testData = ["chunk1", "chunk2", "chunk3"];
+    const results = [];
+    const readPromise = (async () => {
+      let result = await reader.read();
+      while (!result.done) {
+        results.push(result.value);
+        result = await reader.read();
+      }
+    })();
+    for (const chunk of testData) {
+      await channel.write(chunk);
+    }
+    await channel.close();
+    await readPromise;
+    expect(results).toEqual(testData);
+  });
+  it("should handle empty stream", async () => {
+    const channel = createStreamChannel();
+    const reader = channel.stream().getReader();
+    await channel.close();
+    const result = await reader.read();
+    expect(result.done).toBe(true);
+  });
+  it("should handle non-awaited sequential writes", async () => {
+    const channel = createStreamChannel();
+    const reader = channel.stream().getReader();
+    const testNumbers = Array.from({ length: 100 }, (_, i) => i);
+    for (const num of testNumbers) {
+      channel.write(num);
+    }
+    channel.close();
+    const results = [];
+    let result = await reader.read();
+    while (!result.done) {
+      results.push(result.value);
+      result = await reader.read();
+    }
+    expect(results).toEqual(testNumbers);
+  });
+  it("should handle double closing without error", async () => {
+    const channel = createStreamChannel();
+    const reader = channel.stream().getReader();
+    await channel.write("test");
+    await channel.close();
+    await expect(channel.close()).resolves.toBeUndefined();
+    const result = await reader.read();
+    expect(result.done).toBe(false);
+    expect(result.value).toBe("test");
+    const nextResult = await reader.read();
+    expect(nextResult.done).toBe(true);
+  });
+  it("should gracefully handle close while read is pending", async () => {
+    const channel = createStreamChannel();
+    const reader = channel.stream().getReader();
+    const readPromise = reader.read();
+    await channel.close();
+    const result = await readPromise;
+    expect(result.done).toBe(true);
+    expect(result.value).toBeUndefined();
+  });
+  it("should complete all pending reads when closed", async () => {
+    const channel = createStreamChannel();
+    const reader = channel.stream().getReader();
+    const read1 = reader.read();
+    const read2 = reader.read();
+    const read3 = reader.read();
+    await channel.write(42);
+    await channel.write(43);
+    await channel.close();
+    const result1 = await read1;
+    expect(result1.done).toBe(false);
+    expect(result1.value).toBe(42);
+    const result2 = await read2;
+    expect(result2.done).toBe(false);
+    expect(result2.value).toBe(43);
+    const result3 = await read3;
+    expect(result3.done).toBe(true);
+  });
+});
+//# sourceMappingURL=stream_channel.test.js.map

package/dist/stream/stream_channel.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/stream/stream_channel.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { describe, expect, it } from 'vitest';\nimport { createStreamChannel } from './stream_channel.js';\n\ndescribe('StreamChannel', () => {\n  it('should write and read a single value', async () => {\n    const channel = createStreamChannel<string>();\n    const reader = channel.stream().getReader();\n\n    await channel.write('test value');\n    await channel.close();\n\n    const result = await reader.read();\n    expect(result.done).toBe(false);\n    expect(result.value).toBe('test value');\n\n    const nextResult = await reader.read();\n    expect(nextResult.done).toBe(true);\n  });\n\n  it('should write and read multiple values in sequence', async () => {\n    const channel = createStreamChannel<string>();\n    const reader = channel.stream().getReader();\n\n    const testValues = ['first', 'second', 'third'];\n\n    for (const value of testValues) {\n      await channel.write(value);\n    }\n    await channel.close();\n\n    const results: string[] = [];\n    let result = await reader.read();\n    while (!result.done) {\n      results.push(result.value);\n      result = await reader.read();\n    }\n\n    expect(results).toEqual(testValues);\n  });\n\n  it('should handle arrays', async () => {\n    const channel = createStreamChannel<number[]>();\n    const reader = channel.stream().getReader();\n\n    const testArray = [1, 2, 3, 4, 5];\n    await channel.write(testArray);\n    await channel.close();\n\n    const result = await reader.read();\n    expect(result.value).toEqual(testArray);\n    expect(result.value).toBe(testArray);\n  });\n\n  it('should work with concurrent writing and reading', async () => {\n    const channel = createStreamChannel<string>();\n    const reader = channel.stream().getReader();\n\n    const testData = ['chunk1', 'chunk2', 'chunk3'];\n    const results: string[] = [];\n\n    const readPromise = (async () => {\n      let result = await reader.read();\n      while (!result.done) {\n        results.push(result.value);\n        result = await reader.read();\n      }\n    })();\n\n    for (const chunk of testData) {\n      await channel.write(chunk);\n    }\n    await channel.close();\n\n    await readPromise;\n    expect(results).toEqual(testData);\n  });\n\n  it('should handle empty stream', async () => {\n    const channel = createStreamChannel<string>();\n    const reader = channel.stream().getReader();\n\n    await channel.close();\n\n    const result = await reader.read();\n    expect(result.done).toBe(true);\n  });\n\n  it('should handle non-awaited sequential writes', async () => {\n    const channel = createStreamChannel<number>();\n    const reader = channel.stream().getReader();\n\n    const testNumbers = Array.from({ length: 100 }, (_, i) => i);\n\n    for (const num of testNumbers) {\n      channel.write(num);\n    }\n    channel.close();\n\n    const results: number[] = [];\n    let result = await reader.read();\n    while (!result.done) {\n      results.push(result.value);\n      result = await reader.read();\n    }\n\n    expect(results).toEqual(testNumbers);\n  });\n\n  it('should handle double closing without error', async () => {\n    const channel = createStreamChannel<string>();\n    const reader = channel.stream().getReader();\n\n    await channel.write('test');\n\n    await channel.close();\n    // Close again - should not throw\n    await expect(channel.close()).resolves.toBeUndefined();\n\n    const result = await reader.read();\n    expect(result.done).toBe(false);\n    expect(result.value).toBe('test');\n\n    const nextResult = await reader.read();\n    expect(nextResult.done).toBe(true);\n  });\n\n  it('should gracefully handle close while read is pending', async () => {\n    const channel = createStreamChannel<string>();\n    const reader = channel.stream().getReader();\n\n    const readPromise = reader.read();\n\n    await channel.close();\n\n    const result = await readPromise;\n    expect(result.done).toBe(true);\n    expect(result.value).toBeUndefined();\n  });\n\n  it('should complete all pending reads when closed', async () => {\n    const channel = createStreamChannel<number>();\n    const reader = channel.stream().getReader();\n\n    const read1 = reader.read();\n    const read2 = reader.read();\n    const read3 = reader.read();\n\n    await channel.write(42);\n    await channel.write(43);\n    await channel.close();\n\n    const result1 = await read1;\n    expect(result1.done).toBe(false);\n    expect(result1.value).toBe(42);\n\n    const result2 = await read2;\n    expect(result2.done).toBe(false);\n    expect(result2.value).toBe(43);\n\n    const result3 = await read3;\n    expect(result3.done).toBe(true);\n  });\n});\n"],"mappings":"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","names":[]}

package/dist/stt/index.cjs

@@ -0,0 +1,38 @@
+"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 stt_exports = {};
+__export(stt_exports, {
+  STT: () => import_stt.STT,
+  SpeechEventType: () => import_stt.SpeechEventType,
+  SpeechStream: () => import_stt.SpeechStream,
+  StreamAdapter: () => import_stream_adapter.StreamAdapter,
+  StreamAdapterWrapper: () => import_stream_adapter.StreamAdapterWrapper
+});
+module.exports = __toCommonJS(stt_exports);
+var import_stt = require("./stt.cjs");
+var import_stream_adapter = require("./stream_adapter.cjs");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  STT,
+  SpeechEventType,
+  SpeechStream,
+  StreamAdapter,
+  StreamAdapterWrapper
+});
+//# sourceMappingURL=index.cjs.map

package/dist/stt/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/stt/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\nexport {\n  type SpeechEvent,\n  type SpeechData,\n  type STTCapabilities,\n  type RecognitionUsage,\n  type STTCallbacks,\n  SpeechEventType,\n  STT,\n  SpeechStream,\n} from './stt.js';\nexport { StreamAdapter, StreamAdapterWrapper } from './stream_adapter.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,iBASO;AACP,4BAAoD;","names":[]}

package/dist/stt/index.d.cts

@@ -0,0 +1,3 @@
+export { type SpeechEvent, type SpeechData, type STTCapabilities, type RecognitionUsage, type STTCallbacks, SpeechEventType, STT, SpeechStream, } from './stt.js';
+export { StreamAdapter, StreamAdapterWrapper } from './stream_adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/stt/index.d.ts

@@ -0,0 +1,3 @@
+export { type SpeechEvent, type SpeechData, type STTCapabilities, type RecognitionUsage, type STTCallbacks, SpeechEventType, STT, SpeechStream, } from './stt.js';
+export { StreamAdapter, StreamAdapterWrapper } from './stream_adapter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stt/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,eAAe,EACf,GAAG,EACH,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/stt/index.js

@@ -0,0 +1,14 @@
+import {
+  SpeechEventType,
+  STT,
+  SpeechStream
+} from "./stt.js";
+import { StreamAdapter, StreamAdapterWrapper } from "./stream_adapter.js";
+export {
+  STT,
+  SpeechEventType,
+  SpeechStream,
+  StreamAdapter,
+  StreamAdapterWrapper
+};
+//# sourceMappingURL=index.js.map

package/dist/stt/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/stt/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\nexport {\n  type SpeechEvent,\n  type SpeechData,\n  type STTCapabilities,\n  type RecognitionUsage,\n  type STTCallbacks,\n  SpeechEventType,\n  STT,\n  SpeechStream,\n} from './stt.js';\nexport { StreamAdapter, StreamAdapterWrapper } from './stream_adapter.js';\n"],"mappings":"AAIA;AAAA,EAME;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,eAAe,4BAA4B;","names":[]}

package/dist/stt/stream_adapter.cjs

@@ -0,0 +1,115 @@
+"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 stream_adapter_exports = {};
+__export(stream_adapter_exports, {
+  StreamAdapter: () => StreamAdapter,
+  StreamAdapterWrapper: () => StreamAdapterWrapper
+});
+module.exports = __toCommonJS(stream_adapter_exports);
+var import_log = require("../log.cjs");
+var import_vad = require("../vad.cjs");
+var import_stt = require("./stt.cjs");
+class StreamAdapter extends import_stt.STT {
+  #stt;
+  #vad;
+  label;
+  constructor(stt, vad) {
+    super({ streaming: true, interimResults: false });
+    this.#stt = stt;
+    this.#vad = vad;
+    this.label = `stt.StreamAdapter<${this.#stt.label}>`;
+    this.#stt.on("metrics_collected", (metrics) => {
+      this.emit("metrics_collected", metrics);
+    });
+    this.#stt.on("error", (error) => {
+      this.emit("error", error);
+    });
+  }
+  _recognize(frame, abortSignal) {
+    return this.#stt.recognize(frame, abortSignal);
+  }
+  stream(options) {
+    return new StreamAdapterWrapper(this.#stt, this.#vad, options == null ? void 0 : options.connOptions);
+  }
+}
+class StreamAdapterWrapper extends import_stt.SpeechStream {
+  #stt;
+  #vadStream;
+  label;
+  constructor(stt, vad, connOptions) {
+    super(stt, void 0, connOptions);
+    this.#stt = stt;
+    this.#vadStream = vad.stream();
+    this.label = `stt.StreamAdapterWrapper<${this.#stt.label}>`;
+  }
+  close() {
+    super.close();
+    this.#vadStream.close();
+  }
+  async monitorMetrics() {
+    return;
+  }
+  async run() {
+    const forwardInput = async () => {
+      for await (const input of this.input) {
+        if (input === import_stt.SpeechStream.FLUSH_SENTINEL) {
+          this.#vadStream.flush();
+        } else {
+          this.#vadStream.pushFrame(input);
+        }
+      }
+      this.#vadStream.endInput();
+    };
+    const recognize = async () => {
+      for await (const ev of this.#vadStream) {
+        switch (ev.type) {
+          case import_vad.VADEventType.START_OF_SPEECH:
+            this.output.put({ type: import_stt.SpeechEventType.START_OF_SPEECH });
+            break;
+          case import_vad.VADEventType.END_OF_SPEECH:
+            this.output.put({ type: import_stt.SpeechEventType.END_OF_SPEECH });
+            try {
+              const event = await this.#stt.recognize(ev.frames, this.abortSignal);
+              if (!event.alternatives[0].text) {
+                continue;
+              }
+              this.output.put(event);
+              break;
+            } catch (error) {
+              let logger = (0, import_log.log)();
+              if (error instanceof Error) {
+                logger = logger.child({ error: error.message });
+              } else {
+                logger = logger.child({ error });
+              }
+              logger.error(`${this.label}: provider recognize task failed`);
+              continue;
+            }
+        }
+      }
+    };
+    await Promise.all([forwardInput(), recognize()]);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  StreamAdapter,
+  StreamAdapterWrapper
+});
+//# sourceMappingURL=stream_adapter.cjs.map

package/dist/stt/stream_adapter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/stt/stream_adapter.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type { AudioFrame } from '@livekit/rtc-node';\nimport { log } from '../log.js';\nimport type { APIConnectOptions } from '../types.js';\nimport type { VAD, VADStream } from '../vad.js';\nimport { VADEventType } from '../vad.js';\nimport type { SpeechEvent } from './stt.js';\nimport { STT, SpeechEventType, SpeechStream } from './stt.js';\n\nexport class StreamAdapter extends STT {\n  #stt: STT;\n  #vad: VAD;\n  label: string;\n\n  constructor(stt: STT, vad: VAD) {\n    super({ streaming: true, interimResults: false });\n    this.#stt = stt;\n    this.#vad = vad;\n    this.label = `stt.StreamAdapter<${this.#stt.label}>`;\n\n    this.#stt.on('metrics_collected', (metrics) => {\n      this.emit('metrics_collected', metrics);\n    });\n\n    this.#stt.on('error', (error) => {\n      this.emit('error', error);\n    });\n  }\n\n  _recognize(frame: AudioFrame, abortSignal?: AbortSignal): Promise<SpeechEvent> {\n    return this.#stt.recognize(frame, abortSignal);\n  }\n\n  stream(options?: { connOptions?: APIConnectOptions }): StreamAdapterWrapper {\n    return new StreamAdapterWrapper(this.#stt, this.#vad, options?.connOptions);\n  }\n}\n\nexport class StreamAdapterWrapper extends SpeechStream {\n  #stt: STT;\n  #vadStream: VADStream;\n  label: string;\n\n  constructor(stt: STT, vad: VAD, connOptions?: APIConnectOptions) {\n    super(stt, undefined, connOptions);\n    this.#stt = stt;\n    this.#vadStream = vad.stream();\n    this.label = `stt.StreamAdapterWrapper<${this.#stt.label}>`;\n  }\n\n  close() {\n    super.close();\n    this.#vadStream.close();\n  }\n\n  async monitorMetrics() {\n    return; // do nothing\n  }\n\n  protected async run() {\n    const forwardInput = async () => {\n      for await (const input of this.input) {\n        if (input === SpeechStream.FLUSH_SENTINEL) {\n          this.#vadStream.flush();\n        } else {\n          this.#vadStream.pushFrame(input);\n        }\n      }\n      this.#vadStream.endInput();\n    };\n\n    const recognize = async () => {\n      for await (const ev of this.#vadStream) {\n        switch (ev.type) {\n          case VADEventType.START_OF_SPEECH:\n            this.output.put({ type: SpeechEventType.START_OF_SPEECH });\n            break;\n          case VADEventType.END_OF_SPEECH:\n            this.output.put({ type: SpeechEventType.END_OF_SPEECH });\n\n            try {\n              const event = await this.#stt.recognize(ev.frames, this.abortSignal);\n              if (!event.alternatives![0].text) {\n                continue;\n              }\n\n              this.output.put(event);\n              break;\n            } catch (error) {\n              let logger = log();\n              if (error instanceof Error) {\n                logger = logger.child({ error: error.message });\n              } else {\n                logger = logger.child({ error });\n              }\n              logger.error(`${this.label}: provider recognize task failed`);\n              continue;\n            }\n        }\n      }\n    };\n\n    await Promise.all([forwardInput(), recognize()]);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,iBAAoB;AAGpB,iBAA6B;AAE7B,iBAAmD;AAE5C,MAAM,sBAAsB,eAAI;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,KAAU,KAAU;AAC9B,UAAM,EAAE,WAAW,MAAM,gBAAgB,MAAM,CAAC;AAChD,SAAK,OAAO;AACZ,SAAK,OAAO;AACZ,SAAK,QAAQ,qBAAqB,KAAK,KAAK,KAAK;AAEjD,SAAK,KAAK,GAAG,qBAAqB,CAAC,YAAY;AAC7C,WAAK,KAAK,qBAAqB,OAAO;AAAA,IACxC,CAAC;AAED,SAAK,KAAK,GAAG,SAAS,CAAC,UAAU;AAC/B,WAAK,KAAK,SAAS,KAAK;AAAA,IAC1B,CAAC;AAAA,EACH;AAAA,EAEA,WAAW,OAAmB,aAAiD;AAC7E,WAAO,KAAK,KAAK,UAAU,OAAO,WAAW;AAAA,EAC/C;AAAA,EAEA,OAAO,SAAqE;AAC1E,WAAO,IAAI,qBAAqB,KAAK,MAAM,KAAK,MAAM,mCAAS,WAAW;AAAA,EAC5E;AACF;AAEO,MAAM,6BAA6B,wBAAa;AAAA,EACrD;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,KAAU,KAAU,aAAiC;AAC/D,UAAM,KAAK,QAAW,WAAW;AACjC,SAAK,OAAO;AACZ,SAAK,aAAa,IAAI,OAAO;AAC7B,SAAK,QAAQ,4BAA4B,KAAK,KAAK,KAAK;AAAA,EAC1D;AAAA,EAEA,QAAQ;AACN,UAAM,MAAM;AACZ,SAAK,WAAW,MAAM;AAAA,EACxB;AAAA,EAEA,MAAM,iBAAiB;AACrB;AAAA,EACF;AAAA,EAEA,MAAgB,MAAM;AACpB,UAAM,eAAe,YAAY;AAC/B,uBAAiB,SAAS,KAAK,OAAO;AACpC,YAAI,UAAU,wBAAa,gBAAgB;AACzC,eAAK,WAAW,MAAM;AAAA,QACxB,OAAO;AACL,eAAK,WAAW,UAAU,KAAK;AAAA,QACjC;AAAA,MACF;AACA,WAAK,WAAW,SAAS;AAAA,IAC3B;AAEA,UAAM,YAAY,YAAY;AAC5B,uBAAiB,MAAM,KAAK,YAAY;AACtC,gBAAQ,GAAG,MAAM;AAAA,UACf,KAAK,wBAAa;AAChB,iBAAK,OAAO,IAAI,EAAE,MAAM,2BAAgB,gBAAgB,CAAC;AACzD;AAAA,UACF,KAAK,wBAAa;AAChB,iBAAK,OAAO,IAAI,EAAE,MAAM,2BAAgB,cAAc,CAAC;AAEvD,gBAAI;AACF,oBAAM,QAAQ,MAAM,KAAK,KAAK,UAAU,GAAG,QAAQ,KAAK,WAAW;AACnE,kBAAI,CAAC,MAAM,aAAc,CAAC,EAAE,MAAM;AAChC;AAAA,cACF;AAEA,mBAAK,OAAO,IAAI,KAAK;AACrB;AAAA,YACF,SAAS,OAAO;AACd,kBAAI,aAAS,gBAAI;AACjB,kBAAI,iBAAiB,OAAO;AAC1B,yBAAS,OAAO,MAAM,EAAE,OAAO,MAAM,QAAQ,CAAC;AAAA,cAChD,OAAO;AACL,yBAAS,OAAO,MAAM,EAAE,MAAM,CAAC;AAAA,cACjC;AACA,qBAAO,MAAM,GAAG,KAAK,KAAK,kCAAkC;AAC5D;AAAA,YACF;AAAA,QACJ;AAAA,MACF;AAAA,IACF;AAEA,UAAM,QAAQ,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,CAAC;AAAA,EACjD;AACF;","names":[]}

package/dist/stt/stream_adapter.d.cts

@@ -0,0 +1,23 @@
+import type { AudioFrame } from '@livekit/rtc-node';
+import type { APIConnectOptions } from '../types.js';
+import type { VAD } from '../vad.js';
+import type { SpeechEvent } from './stt.js';
+import { STT, SpeechStream } from './stt.js';
+export declare class StreamAdapter extends STT {
+    #private;
+    label: string;
+    constructor(stt: STT, vad: VAD);
+    _recognize(frame: AudioFrame, abortSignal?: AbortSignal): Promise<SpeechEvent>;
+    stream(options?: {
+        connOptions?: APIConnectOptions;
+    }): StreamAdapterWrapper;
+}
+export declare class StreamAdapterWrapper extends SpeechStream {
+    #private;
+    label: string;
+    constructor(stt: STT, vad: VAD, connOptions?: APIConnectOptions);
+    close(): void;
+    monitorMetrics(): Promise<void>;
+    protected run(): Promise<void>;
+}
+//# sourceMappingURL=stream_adapter.d.ts.map

package/dist/stt/stream_adapter.d.ts

@@ -0,0 +1,23 @@
+import type { AudioFrame } from '@livekit/rtc-node';
+import type { APIConnectOptions } from '../types.js';
+import type { VAD } from '../vad.js';
+import type { SpeechEvent } from './stt.js';
+import { STT, SpeechStream } from './stt.js';
+export declare class StreamAdapter extends STT {
+    #private;
+    label: string;
+    constructor(stt: STT, vad: VAD);
+    _recognize(frame: AudioFrame, abortSignal?: AbortSignal): Promise<SpeechEvent>;
+    stream(options?: {
+        connOptions?: APIConnectOptions;
+    }): StreamAdapterWrapper;
+}
+export declare class StreamAdapterWrapper extends SpeechStream {
+    #private;
+    label: string;
+    constructor(stt: STT, vad: VAD, connOptions?: APIConnectOptions);
+    close(): void;
+    monitorMetrics(): Promise<void>;
+    protected run(): Promise<void>;
+}
+//# sourceMappingURL=stream_adapter.d.ts.map

package/dist/stt/stream_adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream_adapter.d.ts","sourceRoot":"","sources":["../../src/stt/stream_adapter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,GAAG,EAAa,MAAM,WAAW,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAmB,YAAY,EAAE,MAAM,UAAU,CAAC;AAE9D,qBAAa,aAAc,SAAQ,GAAG;;IAGpC,KAAK,EAAE,MAAM,CAAC;gBAEF,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAe9B,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAI9E,MAAM,CAAC,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,iBAAiB,CAAA;KAAE,GAAG,oBAAoB;CAG5E;AAED,qBAAa,oBAAqB,SAAQ,YAAY;;IAGpD,KAAK,EAAE,MAAM,CAAC;gBAEF,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,iBAAiB;IAO/D,KAAK;IAKC,cAAc;cAIJ,GAAG;CA6CpB"}

package/dist/stt/stream_adapter.js

@@ -0,0 +1,90 @@
+import { log } from "../log.js";
+import { VADEventType } from "../vad.js";
+import { STT, SpeechEventType, SpeechStream } from "./stt.js";
+class StreamAdapter extends STT {
+  #stt;
+  #vad;
+  label;
+  constructor(stt, vad) {
+    super({ streaming: true, interimResults: false });
+    this.#stt = stt;
+    this.#vad = vad;
+    this.label = `stt.StreamAdapter<${this.#stt.label}>`;
+    this.#stt.on("metrics_collected", (metrics) => {
+      this.emit("metrics_collected", metrics);
+    });
+    this.#stt.on("error", (error) => {
+      this.emit("error", error);
+    });
+  }
+  _recognize(frame, abortSignal) {
+    return this.#stt.recognize(frame, abortSignal);
+  }
+  stream(options) {
+    return new StreamAdapterWrapper(this.#stt, this.#vad, options == null ? void 0 : options.connOptions);
+  }
+}
+class StreamAdapterWrapper extends SpeechStream {
+  #stt;
+  #vadStream;
+  label;
+  constructor(stt, vad, connOptions) {
+    super(stt, void 0, connOptions);
+    this.#stt = stt;
+    this.#vadStream = vad.stream();
+    this.label = `stt.StreamAdapterWrapper<${this.#stt.label}>`;
+  }
+  close() {
+    super.close();
+    this.#vadStream.close();
+  }
+  async monitorMetrics() {
+    return;
+  }
+  async run() {
+    const forwardInput = async () => {
+      for await (const input of this.input) {
+        if (input === SpeechStream.FLUSH_SENTINEL) {
+          this.#vadStream.flush();
+        } else {
+          this.#vadStream.pushFrame(input);
+        }
+      }
+      this.#vadStream.endInput();
+    };
+    const recognize = async () => {
+      for await (const ev of this.#vadStream) {
+        switch (ev.type) {
+          case VADEventType.START_OF_SPEECH:
+            this.output.put({ type: SpeechEventType.START_OF_SPEECH });
+            break;
+          case VADEventType.END_OF_SPEECH:
+            this.output.put({ type: SpeechEventType.END_OF_SPEECH });
+            try {
+              const event = await this.#stt.recognize(ev.frames, this.abortSignal);
+              if (!event.alternatives[0].text) {
+                continue;
+              }
+              this.output.put(event);
+              break;
+            } catch (error) {
+              let logger = log();
+              if (error instanceof Error) {
+                logger = logger.child({ error: error.message });
+              } else {
+                logger = logger.child({ error });
+              }
+              logger.error(`${this.label}: provider recognize task failed`);
+              continue;
+            }
+        }
+      }
+    };
+    await Promise.all([forwardInput(), recognize()]);
+  }
+}
+export {
+  StreamAdapter,
+  StreamAdapterWrapper
+};
+//# sourceMappingURL=stream_adapter.js.map

package/dist/stt/stream_adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/stt/stream_adapter.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type { AudioFrame } from '@livekit/rtc-node';\nimport { log } from '../log.js';\nimport type { APIConnectOptions } from '../types.js';\nimport type { VAD, VADStream } from '../vad.js';\nimport { VADEventType } from '../vad.js';\nimport type { SpeechEvent } from './stt.js';\nimport { STT, SpeechEventType, SpeechStream } from './stt.js';\n\nexport class StreamAdapter extends STT {\n  #stt: STT;\n  #vad: VAD;\n  label: string;\n\n  constructor(stt: STT, vad: VAD) {\n    super({ streaming: true, interimResults: false });\n    this.#stt = stt;\n    this.#vad = vad;\n    this.label = `stt.StreamAdapter<${this.#stt.label}>`;\n\n    this.#stt.on('metrics_collected', (metrics) => {\n      this.emit('metrics_collected', metrics);\n    });\n\n    this.#stt.on('error', (error) => {\n      this.emit('error', error);\n    });\n  }\n\n  _recognize(frame: AudioFrame, abortSignal?: AbortSignal): Promise<SpeechEvent> {\n    return this.#stt.recognize(frame, abortSignal);\n  }\n\n  stream(options?: { connOptions?: APIConnectOptions }): StreamAdapterWrapper {\n    return new StreamAdapterWrapper(this.#stt, this.#vad, options?.connOptions);\n  }\n}\n\nexport class StreamAdapterWrapper extends SpeechStream {\n  #stt: STT;\n  #vadStream: VADStream;\n  label: string;\n\n  constructor(stt: STT, vad: VAD, connOptions?: APIConnectOptions) {\n    super(stt, undefined, connOptions);\n    this.#stt = stt;\n    this.#vadStream = vad.stream();\n    this.label = `stt.StreamAdapterWrapper<${this.#stt.label}>`;\n  }\n\n  close() {\n    super.close();\n    this.#vadStream.close();\n  }\n\n  async monitorMetrics() {\n    return; // do nothing\n  }\n\n  protected async run() {\n    const forwardInput = async () => {\n      for await (const input of this.input) {\n        if (input === SpeechStream.FLUSH_SENTINEL) {\n          this.#vadStream.flush();\n        } else {\n          this.#vadStream.pushFrame(input);\n        }\n      }\n      this.#vadStream.endInput();\n    };\n\n    const recognize = async () => {\n      for await (const ev of this.#vadStream) {\n        switch (ev.type) {\n          case VADEventType.START_OF_SPEECH:\n            this.output.put({ type: SpeechEventType.START_OF_SPEECH });\n            break;\n          case VADEventType.END_OF_SPEECH:\n            this.output.put({ type: SpeechEventType.END_OF_SPEECH });\n\n            try {\n              const event = await this.#stt.recognize(ev.frames, this.abortSignal);\n              if (!event.alternatives![0].text) {\n                continue;\n              }\n\n              this.output.put(event);\n              break;\n            } catch (error) {\n              let logger = log();\n              if (error instanceof Error) {\n                logger = logger.child({ error: error.message });\n              } else {\n                logger = logger.child({ error });\n              }\n              logger.error(`${this.label}: provider recognize task failed`);\n              continue;\n            }\n        }\n      }\n    };\n\n    await Promise.all([forwardInput(), recognize()]);\n  }\n}\n"],"mappings":"AAIA,SAAS,WAAW;AAGpB,SAAS,oBAAoB;AAE7B,SAAS,KAAK,iBAAiB,oBAAoB;AAE5C,MAAM,sBAAsB,IAAI;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,KAAU,KAAU;AAC9B,UAAM,EAAE,WAAW,MAAM,gBAAgB,MAAM,CAAC;AAChD,SAAK,OAAO;AACZ,SAAK,OAAO;AACZ,SAAK,QAAQ,qBAAqB,KAAK,KAAK,KAAK;AAEjD,SAAK,KAAK,GAAG,qBAAqB,CAAC,YAAY;AAC7C,WAAK,KAAK,qBAAqB,OAAO;AAAA,IACxC,CAAC;AAED,SAAK,KAAK,GAAG,SAAS,CAAC,UAAU;AAC/B,WAAK,KAAK,SAAS,KAAK;AAAA,IAC1B,CAAC;AAAA,EACH;AAAA,EAEA,WAAW,OAAmB,aAAiD;AAC7E,WAAO,KAAK,KAAK,UAAU,OAAO,WAAW;AAAA,EAC/C;AAAA,EAEA,OAAO,SAAqE;AAC1E,WAAO,IAAI,qBAAqB,KAAK,MAAM,KAAK,MAAM,mCAAS,WAAW;AAAA,EAC5E;AACF;AAEO,MAAM,6BAA6B,aAAa;AAAA,EACrD;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,KAAU,KAAU,aAAiC;AAC/D,UAAM,KAAK,QAAW,WAAW;AACjC,SAAK,OAAO;AACZ,SAAK,aAAa,IAAI,OAAO;AAC7B,SAAK,QAAQ,4BAA4B,KAAK,KAAK,KAAK;AAAA,EAC1D;AAAA,EAEA,QAAQ;AACN,UAAM,MAAM;AACZ,SAAK,WAAW,MAAM;AAAA,EACxB;AAAA,EAEA,MAAM,iBAAiB;AACrB;AAAA,EACF;AAAA,EAEA,MAAgB,MAAM;AACpB,UAAM,eAAe,YAAY;AAC/B,uBAAiB,SAAS,KAAK,OAAO;AACpC,YAAI,UAAU,aAAa,gBAAgB;AACzC,eAAK,WAAW,MAAM;AAAA,QACxB,OAAO;AACL,eAAK,WAAW,UAAU,KAAK;AAAA,QACjC;AAAA,MACF;AACA,WAAK,WAAW,SAAS;AAAA,IAC3B;AAEA,UAAM,YAAY,YAAY;AAC5B,uBAAiB,MAAM,KAAK,YAAY;AACtC,gBAAQ,GAAG,MAAM;AAAA,UACf,KAAK,aAAa;AAChB,iBAAK,OAAO,IAAI,EAAE,MAAM,gBAAgB,gBAAgB,CAAC;AACzD;AAAA,UACF,KAAK,aAAa;AAChB,iBAAK,OAAO,IAAI,EAAE,MAAM,gBAAgB,cAAc,CAAC;AAEvD,gBAAI;AACF,oBAAM,QAAQ,MAAM,KAAK,KAAK,UAAU,GAAG,QAAQ,KAAK,WAAW;AACnE,kBAAI,CAAC,MAAM,aAAc,CAAC,EAAE,MAAM;AAChC;AAAA,cACF;AAEA,mBAAK,OAAO,IAAI,KAAK;AACrB;AAAA,YACF,SAAS,OAAO;AACd,kBAAI,SAAS,IAAI;AACjB,kBAAI,iBAAiB,OAAO;AAC1B,yBAAS,OAAO,MAAM,EAAE,OAAO,MAAM,QAAQ,CAAC;AAAA,cAChD,OAAO;AACL,yBAAS,OAAO,MAAM,EAAE,MAAM,CAAC;AAAA,cACjC;AACA,qBAAO,MAAM,GAAG,KAAK,KAAK,kCAAkC;AAC5D;AAAA,YACF;AAAA,QACJ;AAAA,MACF;AAAA,IACF;AAEA,UAAM,QAAQ,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,CAAC;AAAA,EACjD;AACF;","names":[]}