@livekit/agents 1.0.45 → 1.0.46

package/dist/stream/index.cjs

@@ -20,6 +20,7 @@ var stream_exports = {};
 __export(stream_exports, {
   DeferredReadableStream: () => import_deferred_stream.DeferredReadableStream,
   IdentityTransform: () => import_identity_transform.IdentityTransform,
+  MultiInputStream: () => import_multi_input_stream.MultiInputStream,
   createStreamChannel: () => import_stream_channel.createStreamChannel,
   mergeReadableStreams: () => import_merge_readable_streams.mergeReadableStreams
 });
@@ -27,11 +28,13 @@ module.exports = __toCommonJS(stream_exports);
 var import_deferred_stream = require("./deferred_stream.cjs");
 var import_identity_transform = require("./identity_transform.cjs");
 var import_merge_readable_streams = require("./merge_readable_streams.cjs");
+var import_multi_input_stream = require("./multi_input_stream.cjs");
 var import_stream_channel = require("./stream_channel.cjs");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DeferredReadableStream,
   IdentityTransform,
+  MultiInputStream,
   createStreamChannel,
   mergeReadableStreams
 });

package/dist/stream/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/stream/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport { DeferredReadableStream } from './deferred_stream.js';\nexport { IdentityTransform } from './identity_transform.js';\nexport { mergeReadableStreams } from './merge_readable_streams.js';\nexport { createStreamChannel, type StreamChannel } from './stream_channel.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,6BAAuC;AACvC,gCAAkC;AAClC,oCAAqC;AACrC,4BAAwD;","names":[]}
+{"version":3,"sources":["../../src/stream/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport { DeferredReadableStream } from './deferred_stream.js';\nexport { IdentityTransform } from './identity_transform.js';\nexport { mergeReadableStreams } from './merge_readable_streams.js';\nexport { MultiInputStream } from './multi_input_stream.js';\nexport { createStreamChannel, type StreamChannel } from './stream_channel.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,6BAAuC;AACvC,gCAAkC;AAClC,oCAAqC;AACrC,gCAAiC;AACjC,4BAAwD;","names":[]}

package/dist/stream/index.d.cts

@@ -1,5 +1,6 @@
 export { DeferredReadableStream } from './deferred_stream.js';
 export { IdentityTransform } from './identity_transform.js';
 export { mergeReadableStreams } from './merge_readable_streams.js';
+export { MultiInputStream } from './multi_input_stream.js';
 export { createStreamChannel, type StreamChannel } from './stream_channel.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/stream/index.d.ts

@@ -1,5 +1,6 @@
 export { DeferredReadableStream } from './deferred_stream.js';
 export { IdentityTransform } from './identity_transform.js';
 export { mergeReadableStreams } from './merge_readable_streams.js';
+export { MultiInputStream } from './multi_input_stream.js';
 export { createStreamChannel, type StreamChannel } from './stream_channel.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stream/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stream/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/stream/index.js

@@ -1,10 +1,12 @@
 import { DeferredReadableStream } from "./deferred_stream.js";
 import { IdentityTransform } from "./identity_transform.js";
 import { mergeReadableStreams } from "./merge_readable_streams.js";
+import { MultiInputStream } from "./multi_input_stream.js";
 import { createStreamChannel } from "./stream_channel.js";
 export {
   DeferredReadableStream,
   IdentityTransform,
+  MultiInputStream,
   createStreamChannel,
   mergeReadableStreams
 };

package/dist/stream/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/stream/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport { DeferredReadableStream } from './deferred_stream.js';\nexport { IdentityTransform } from './identity_transform.js';\nexport { mergeReadableStreams } from './merge_readable_streams.js';\nexport { createStreamChannel, type StreamChannel } from './stream_channel.js';\n"],"mappings":"AAGA,SAAS,8BAA8B;AACvC,SAAS,yBAAyB;AAClC,SAAS,4BAA4B;AACrC,SAAS,2BAA+C;","names":[]}
+{"version":3,"sources":["../../src/stream/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport { DeferredReadableStream } from './deferred_stream.js';\nexport { IdentityTransform } from './identity_transform.js';\nexport { mergeReadableStreams } from './merge_readable_streams.js';\nexport { MultiInputStream } from './multi_input_stream.js';\nexport { createStreamChannel, type StreamChannel } from './stream_channel.js';\n"],"mappings":"AAGA,SAAS,8BAA8B;AACvC,SAAS,yBAAyB;AAClC,SAAS,4BAA4B;AACrC,SAAS,wBAAwB;AACjC,SAAS,2BAA+C;","names":[]}

package/dist/stream/multi_input_stream.cjs

@@ -0,0 +1,139 @@
+"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 multi_input_stream_exports = {};
+__export(multi_input_stream_exports, {
+  MultiInputStream: () => MultiInputStream
+});
+module.exports = __toCommonJS(multi_input_stream_exports);
+var import_log = require("../log.cjs");
+var import_deferred_stream = require("./deferred_stream.cjs");
+var import_identity_transform = require("./identity_transform.cjs");
+class MultiInputStream {
+  transform;
+  writer;
+  inputs = /* @__PURE__ */ new Map();
+  pumpPromises = /* @__PURE__ */ new Map();
+  nextId = 0;
+  _closed = false;
+  logger = (0, import_log.log)();
+  constructor() {
+    this.transform = new import_identity_transform.IdentityTransform();
+    this.writer = this.transform.writable.getWriter();
+  }
+  /** The single output stream that consumers read from. */
+  get stream() {
+    return this.transform.readable;
+  }
+  /** Number of currently active input streams. */
+  get inputCount() {
+    return this.inputs.size;
+  }
+  /** Whether {@link close} has been called. */
+  get isClosed() {
+    return this._closed;
+  }
+  /**
+   * Add an input {@link ReadableStream} that will be pumped into the output.
+   *
+   * @returns A unique identifier that can be passed to {@link removeInputStream}.
+   * @throws If the stream has already been closed.
+   */
+  addInputStream(source) {
+    if (this._closed) {
+      throw new Error("MultiInputStream is closed");
+    }
+    const id = `input-${this.nextId++}`;
+    const reader = source.getReader();
+    this.inputs.set(id, reader);
+    const pumpDone = this.pumpInput(id, reader);
+    this.pumpPromises.set(id, pumpDone);
+    return id;
+  }
+  /**
+   * Detach an input stream by its ID and release the reader lock so the
+   * source stream can be reused elsewhere.
+   *
+   * No-op if the ID does not exist (e.g. the input already ended or was removed).
+   */
+  async removeInputStream(id) {
+    const reader = this.inputs.get(id);
+    if (!reader) return;
+    this.inputs.delete(id);
+    reader.releaseLock();
+    const pump = this.pumpPromises.get(id);
+    if (pump) {
+      await pump;
+      this.pumpPromises.delete(id);
+    }
+  }
+  /**
+   * Close the output stream and detach all inputs.
+   *
+   * Idempotent — calling more than once is a no-op.
+   */
+  async close() {
+    if (this._closed) return;
+    this._closed = true;
+    for (const reader of this.inputs.values()) {
+      reader.releaseLock();
+    }
+    this.inputs.clear();
+    await Promise.allSettled([...this.pumpPromises.values()]);
+    this.pumpPromises.clear();
+    try {
+      this.writer.releaseLock();
+    } catch {
+    }
+    try {
+      await this.transform.writable.close();
+    } catch {
+    }
+  }
+  shouldStopPumping(id) {
+    return this._closed || !this.inputs.has(id);
+  }
+  async pumpInput(id, reader) {
+    try {
+      while (true) {
+        if (this.shouldStopPumping(id)) break;
+        const { done, value } = await reader.read();
+        if (done) break;
+        if (this.shouldStopPumping(id)) break;
+        await this.writer.write(value);
+      }
+    } catch (e) {
+      if ((0, import_deferred_stream.isStreamReaderReleaseError)(e)) {
+        return;
+      }
+      this.logger.error({ error: e }, "Error pumping input stream from MultiInputStream");
+    } finally {
+      try {
+        reader.releaseLock();
+      } catch {
+      }
+      this.inputs.delete(id);
+      this.pumpPromises.delete(id);
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MultiInputStream
+});
+//# sourceMappingURL=multi_input_stream.cjs.map

package/dist/stream/multi_input_stream.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/stream/multi_input_stream.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type {\n  ReadableStream,\n  ReadableStreamDefaultReader,\n  WritableStreamDefaultWriter,\n} from 'node:stream/web';\nimport { log } from '../log.js';\nimport { isStreamReaderReleaseError } from './deferred_stream.js';\nimport { IdentityTransform } from './identity_transform.js';\n\n/**\n * A fan-in multiplexer that merges multiple {@link ReadableStream} inputs into\n * a single output {@link ReadableStream}. Inputs can be dynamically added and\n * removed at any time while the stream is open.\n *\n * Unlike {@link DeferredReadableStream} which supports a single readable source,\n * `MultiInputStream` allows N concurrent input streams to pump data into one output.\n *\n * Key behaviors:\n * - An error in one input removes that input but does **not** kill the output.\n * - When all inputs end or are removed, the output stays open (waiting for new inputs).\n * - The output only closes when {@link close} is called explicitly.\n * - {@link removeInputStream} releases the reader lock so the source can be reused.\n */\nexport class MultiInputStream<T> {\n  private transform: IdentityTransform<T>;\n  private writer: WritableStreamDefaultWriter<T>;\n  private inputs: Map<string, ReadableStreamDefaultReader<T>> = new Map();\n  private pumpPromises: Map<string, Promise<void>> = new Map();\n  private nextId = 0;\n  private _closed = false;\n  private logger = log();\n\n  constructor() {\n    this.transform = new IdentityTransform<T>();\n    this.writer = this.transform.writable.getWriter();\n  }\n\n  /** The single output stream that consumers read from. */\n  get stream(): ReadableStream<T> {\n    return this.transform.readable;\n  }\n\n  /** Number of currently active input streams. */\n  get inputCount(): number {\n    return this.inputs.size;\n  }\n\n  /** Whether {@link close} has been called. */\n  get isClosed(): boolean {\n    return this._closed;\n  }\n\n  /**\n   * Add an input {@link ReadableStream} that will be pumped into the output.\n   *\n   * @returns A unique identifier that can be passed to {@link removeInputStream}.\n   * @throws If the stream has already been closed.\n   */\n  addInputStream(source: ReadableStream<T>): string {\n    if (this._closed) {\n      throw new Error('MultiInputStream is closed');\n    }\n\n    const id = `input-${this.nextId++}`;\n    const reader = source.getReader();\n    this.inputs.set(id, reader);\n\n    const pumpDone = this.pumpInput(id, reader);\n    this.pumpPromises.set(id, pumpDone);\n\n    return id;\n  }\n\n  /**\n   * Detach an input stream by its ID and release the reader lock so the\n   * source stream can be reused elsewhere.\n   *\n   * No-op if the ID does not exist (e.g. the input already ended or was removed).\n   */\n  async removeInputStream(id: string): Promise<void> {\n    const reader = this.inputs.get(id);\n    if (!reader) return;\n\n    // Delete first so the pump's finally-block is a harmless no-op.\n    this.inputs.delete(id);\n\n    // Releasing the lock causes any pending reader.read() inside pump to throw\n    // a TypeError, which is caught by isStreamReaderReleaseError.\n    reader.releaseLock();\n\n    // Wait for the pump to finish so the caller knows cleanup is complete.\n    const pump = this.pumpPromises.get(id);\n    if (pump) {\n      await pump;\n      this.pumpPromises.delete(id);\n    }\n  }\n\n  /**\n   * Close the output stream and detach all inputs.\n   *\n   * Idempotent — calling more than once is a no-op.\n   */\n  async close(): Promise<void> {\n    if (this._closed) return;\n    this._closed = true;\n\n    // Release every input reader to unblock pending reads inside pumps.\n    for (const reader of this.inputs.values()) {\n      reader.releaseLock();\n    }\n    this.inputs.clear();\n\n    // Wait for every pump loop to finish before touching the writer.\n    await Promise.allSettled([...this.pumpPromises.values()]);\n    this.pumpPromises.clear();\n\n    // Close the output writer + writable side of the transform.\n    try {\n      this.writer.releaseLock();\n    } catch {\n      // ignore if already released\n    }\n\n    try {\n      await this.transform.writable.close();\n    } catch {\n      // ignore if already closed\n    }\n  }\n\n  private shouldStopPumping(id: string): boolean {\n    return this._closed || !this.inputs.has(id);\n  }\n\n  private async pumpInput(id: string, reader: ReadableStreamDefaultReader<T>): Promise<void> {\n    try {\n      while (true) {\n        // If the stream was closed or the input was removed while we were\n        // awaiting the previous write, bail out immediately.\n        if (this.shouldStopPumping(id)) break;\n\n        const { done, value } = await reader.read();\n        if (done) break;\n\n        // Double-check after the (potentially long) read.\n        if (this.shouldStopPumping(id)) break;\n\n        await this.writer.write(value);\n      }\n    } catch (e) {\n      // TypeErrors from releaseLock() during removeInputStream / close are expected.\n      if (isStreamReaderReleaseError(e)) {\n        return;\n      }\n\n      this.logger.error({ error: e }, 'Error pumping input stream from MultiInputStream');\n    } finally {\n      try {\n        reader.releaseLock();\n      } catch {\n        // ignore if already released\n      }\n\n      this.inputs.delete(id);\n      this.pumpPromises.delete(id);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,iBAAoB;AACpB,6BAA2C;AAC3C,gCAAkC;AAgB3B,MAAM,iBAAoB;AAAA,EACvB;AAAA,EACA;AAAA,EACA,SAAsD,oBAAI,IAAI;AAAA,EAC9D,eAA2C,oBAAI,IAAI;AAAA,EACnD,SAAS;AAAA,EACT,UAAU;AAAA,EACV,aAAS,gBAAI;AAAA,EAErB,cAAc;AACZ,SAAK,YAAY,IAAI,4CAAqB;AAC1C,SAAK,SAAS,KAAK,UAAU,SAAS,UAAU;AAAA,EAClD;AAAA;AAAA,EAGA,IAAI,SAA4B;AAC9B,WAAO,KAAK,UAAU;AAAA,EACxB;AAAA;AAAA,EAGA,IAAI,aAAqB;AACvB,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA;AAAA,EAGA,IAAI,WAAoB;AACtB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,eAAe,QAAmC;AAChD,QAAI,KAAK,SAAS;AAChB,YAAM,IAAI,MAAM,4BAA4B;AAAA,IAC9C;AAEA,UAAM,KAAK,SAAS,KAAK,QAAQ;AACjC,UAAM,SAAS,OAAO,UAAU;AAChC,SAAK,OAAO,IAAI,IAAI,MAAM;AAE1B,UAAM,WAAW,KAAK,UAAU,IAAI,MAAM;AAC1C,SAAK,aAAa,IAAI,IAAI,QAAQ;AAElC,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,kBAAkB,IAA2B;AACjD,UAAM,SAAS,KAAK,OAAO,IAAI,EAAE;AACjC,QAAI,CAAC,OAAQ;AAGb,SAAK,OAAO,OAAO,EAAE;AAIrB,WAAO,YAAY;AAGnB,UAAM,OAAO,KAAK,aAAa,IAAI,EAAE;AACrC,QAAI,MAAM;AACR,YAAM;AACN,WAAK,aAAa,OAAO,EAAE;AAAA,IAC7B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,QAAuB;AAC3B,QAAI,KAAK,QAAS;AAClB,SAAK,UAAU;AAGf,eAAW,UAAU,KAAK,OAAO,OAAO,GAAG;AACzC,aAAO,YAAY;AAAA,IACrB;AACA,SAAK,OAAO,MAAM;AAGlB,UAAM,QAAQ,WAAW,CAAC,GAAG,KAAK,aAAa,OAAO,CAAC,CAAC;AACxD,SAAK,aAAa,MAAM;AAGxB,QAAI;AACF,WAAK,OAAO,YAAY;AAAA,IAC1B,QAAQ;AAAA,IAER;AAEA,QAAI;AACF,YAAM,KAAK,UAAU,SAAS,MAAM;AAAA,IACtC,QAAQ;AAAA,IAER;AAAA,EACF;AAAA,EAEQ,kBAAkB,IAAqB;AAC7C,WAAO,KAAK,WAAW,CAAC,KAAK,OAAO,IAAI,EAAE;AAAA,EAC5C;AAAA,EAEA,MAAc,UAAU,IAAY,QAAuD;AACzF,QAAI;AACF,aAAO,MAAM;AAGX,YAAI,KAAK,kBAAkB,EAAE,EAAG;AAEhC,cAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAC1C,YAAI,KAAM;AAGV,YAAI,KAAK,kBAAkB,EAAE,EAAG;AAEhC,cAAM,KAAK,OAAO,MAAM,KAAK;AAAA,MAC/B;AAAA,IACF,SAAS,GAAG;AAEV,cAAI,mDAA2B,CAAC,GAAG;AACjC;AAAA,MACF;AAEA,WAAK,OAAO,MAAM,EAAE,OAAO,EAAE,GAAG,kDAAkD;AAAA,IACpF,UAAE;AACA,UAAI;AACF,eAAO,YAAY;AAAA,MACrB,QAAQ;AAAA,MAER;AAEA,WAAK,OAAO,OAAO,EAAE;AACrB,WAAK,aAAa,OAAO,EAAE;AAAA,IAC7B;AAAA,EACF;AACF;","names":[]}

package/dist/stream/multi_input_stream.d.cts

@@ -0,0 +1,55 @@
+/// <reference types="node" resolution-mode="require"/>
+import type { ReadableStream } from 'node:stream/web';
+/**
+ * A fan-in multiplexer that merges multiple {@link ReadableStream} inputs into
+ * a single output {@link ReadableStream}. Inputs can be dynamically added and
+ * removed at any time while the stream is open.
+ *
+ * Unlike {@link DeferredReadableStream} which supports a single readable source,
+ * `MultiInputStream` allows N concurrent input streams to pump data into one output.
+ *
+ * Key behaviors:
+ * - An error in one input removes that input but does **not** kill the output.
+ * - When all inputs end or are removed, the output stays open (waiting for new inputs).
+ * - The output only closes when {@link close} is called explicitly.
+ * - {@link removeInputStream} releases the reader lock so the source can be reused.
+ */
+export declare class MultiInputStream<T> {
+    private transform;
+    private writer;
+    private inputs;
+    private pumpPromises;
+    private nextId;
+    private _closed;
+    private logger;
+    constructor();
+    /** The single output stream that consumers read from. */
+    get stream(): ReadableStream<T>;
+    /** Number of currently active input streams. */
+    get inputCount(): number;
+    /** Whether {@link close} has been called. */
+    get isClosed(): boolean;
+    /**
+     * Add an input {@link ReadableStream} that will be pumped into the output.
+     *
+     * @returns A unique identifier that can be passed to {@link removeInputStream}.
+     * @throws If the stream has already been closed.
+     */
+    addInputStream(source: ReadableStream<T>): string;
+    /**
+     * Detach an input stream by its ID and release the reader lock so the
+     * source stream can be reused elsewhere.
+     *
+     * No-op if the ID does not exist (e.g. the input already ended or was removed).
+     */
+    removeInputStream(id: string): Promise<void>;
+    /**
+     * Close the output stream and detach all inputs.
+     *
+     * Idempotent — calling more than once is a no-op.
+     */
+    close(): Promise<void>;
+    private shouldStopPumping;
+    private pumpInput;
+}
+//# sourceMappingURL=multi_input_stream.d.ts.map

package/dist/stream/multi_input_stream.d.ts

@@ -0,0 +1,55 @@
+/// <reference types="node" resolution-mode="require"/>
+import type { ReadableStream } from 'node:stream/web';
+/**
+ * A fan-in multiplexer that merges multiple {@link ReadableStream} inputs into
+ * a single output {@link ReadableStream}. Inputs can be dynamically added and
+ * removed at any time while the stream is open.
+ *
+ * Unlike {@link DeferredReadableStream} which supports a single readable source,
+ * `MultiInputStream` allows N concurrent input streams to pump data into one output.
+ *
+ * Key behaviors:
+ * - An error in one input removes that input but does **not** kill the output.
+ * - When all inputs end or are removed, the output stays open (waiting for new inputs).
+ * - The output only closes when {@link close} is called explicitly.
+ * - {@link removeInputStream} releases the reader lock so the source can be reused.
+ */
+export declare class MultiInputStream<T> {
+    private transform;
+    private writer;
+    private inputs;
+    private pumpPromises;
+    private nextId;
+    private _closed;
+    private logger;
+    constructor();
+    /** The single output stream that consumers read from. */
+    get stream(): ReadableStream<T>;
+    /** Number of currently active input streams. */
+    get inputCount(): number;
+    /** Whether {@link close} has been called. */
+    get isClosed(): boolean;
+    /**
+     * Add an input {@link ReadableStream} that will be pumped into the output.
+     *
+     * @returns A unique identifier that can be passed to {@link removeInputStream}.
+     * @throws If the stream has already been closed.
+     */
+    addInputStream(source: ReadableStream<T>): string;
+    /**
+     * Detach an input stream by its ID and release the reader lock so the
+     * source stream can be reused elsewhere.
+     *
+     * No-op if the ID does not exist (e.g. the input already ended or was removed).
+     */
+    removeInputStream(id: string): Promise<void>;
+    /**
+     * Close the output stream and detach all inputs.
+     *
+     * Idempotent — calling more than once is a no-op.
+     */
+    close(): Promise<void>;
+    private shouldStopPumping;
+    private pumpInput;
+}
+//# sourceMappingURL=multi_input_stream.d.ts.map

package/dist/stream/multi_input_stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi_input_stream.d.ts","sourceRoot":"","sources":["../../src/stream/multi_input_stream.ts"],"names":[],"mappings":";AAGA,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,iBAAiB,CAAC;AAKzB;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAgB,CAAC,CAAC;IAC7B,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,MAAM,CAA0D;IACxE,OAAO,CAAC,YAAY,CAAyC;IAC7D,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;;IAOvB,yDAAyD;IACzD,IAAI,MAAM,IAAI,cAAc,CAAC,CAAC,CAAC,CAE9B;IAED,gDAAgD;IAChD,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,6CAA6C;IAC7C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;;OAKG;IACH,cAAc,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,MAAM;IAejD;;;;;OAKG;IACG,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBlD;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B5B,OAAO,CAAC,iBAAiB;YAIX,SAAS;CAiCxB"}

package/dist/stream/multi_input_stream.js

@@ -0,0 +1,115 @@
+import { log } from "../log.js";
+import { isStreamReaderReleaseError } from "./deferred_stream.js";
+import { IdentityTransform } from "./identity_transform.js";
+class MultiInputStream {
+  transform;
+  writer;
+  inputs = /* @__PURE__ */ new Map();
+  pumpPromises = /* @__PURE__ */ new Map();
+  nextId = 0;
+  _closed = false;
+  logger = log();
+  constructor() {
+    this.transform = new IdentityTransform();
+    this.writer = this.transform.writable.getWriter();
+  }
+  /** The single output stream that consumers read from. */
+  get stream() {
+    return this.transform.readable;
+  }
+  /** Number of currently active input streams. */
+  get inputCount() {
+    return this.inputs.size;
+  }
+  /** Whether {@link close} has been called. */
+  get isClosed() {
+    return this._closed;
+  }
+  /**
+   * Add an input {@link ReadableStream} that will be pumped into the output.
+   *
+   * @returns A unique identifier that can be passed to {@link removeInputStream}.
+   * @throws If the stream has already been closed.
+   */
+  addInputStream(source) {
+    if (this._closed) {
+      throw new Error("MultiInputStream is closed");
+    }
+    const id = `input-${this.nextId++}`;
+    const reader = source.getReader();
+    this.inputs.set(id, reader);
+    const pumpDone = this.pumpInput(id, reader);
+    this.pumpPromises.set(id, pumpDone);
+    return id;
+  }
+  /**
+   * Detach an input stream by its ID and release the reader lock so the
+   * source stream can be reused elsewhere.
+   *
+   * No-op if the ID does not exist (e.g. the input already ended or was removed).
+   */
+  async removeInputStream(id) {
+    const reader = this.inputs.get(id);
+    if (!reader) return;
+    this.inputs.delete(id);
+    reader.releaseLock();
+    const pump = this.pumpPromises.get(id);
+    if (pump) {
+      await pump;
+      this.pumpPromises.delete(id);
+    }
+  }
+  /**
+   * Close the output stream and detach all inputs.
+   *
+   * Idempotent — calling more than once is a no-op.
+   */
+  async close() {
+    if (this._closed) return;
+    this._closed = true;
+    for (const reader of this.inputs.values()) {
+      reader.releaseLock();
+    }
+    this.inputs.clear();
+    await Promise.allSettled([...this.pumpPromises.values()]);
+    this.pumpPromises.clear();
+    try {
+      this.writer.releaseLock();
+    } catch {
+    }
+    try {
+      await this.transform.writable.close();
+    } catch {
+    }
+  }
+  shouldStopPumping(id) {
+    return this._closed || !this.inputs.has(id);
+  }
+  async pumpInput(id, reader) {
+    try {
+      while (true) {
+        if (this.shouldStopPumping(id)) break;
+        const { done, value } = await reader.read();
+        if (done) break;
+        if (this.shouldStopPumping(id)) break;
+        await this.writer.write(value);
+      }
+    } catch (e) {
+      if (isStreamReaderReleaseError(e)) {
+        return;
+      }
+      this.logger.error({ error: e }, "Error pumping input stream from MultiInputStream");
+    } finally {
+      try {
+        reader.releaseLock();
+      } catch {
+      }
+      this.inputs.delete(id);
+      this.pumpPromises.delete(id);
+    }
+  }
+}
+export {
+  MultiInputStream
+};
+//# sourceMappingURL=multi_input_stream.js.map

package/dist/stream/multi_input_stream.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/stream/multi_input_stream.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type {\n  ReadableStream,\n  ReadableStreamDefaultReader,\n  WritableStreamDefaultWriter,\n} from 'node:stream/web';\nimport { log } from '../log.js';\nimport { isStreamReaderReleaseError } from './deferred_stream.js';\nimport { IdentityTransform } from './identity_transform.js';\n\n/**\n * A fan-in multiplexer that merges multiple {@link ReadableStream} inputs into\n * a single output {@link ReadableStream}. Inputs can be dynamically added and\n * removed at any time while the stream is open.\n *\n * Unlike {@link DeferredReadableStream} which supports a single readable source,\n * `MultiInputStream` allows N concurrent input streams to pump data into one output.\n *\n * Key behaviors:\n * - An error in one input removes that input but does **not** kill the output.\n * - When all inputs end or are removed, the output stays open (waiting for new inputs).\n * - The output only closes when {@link close} is called explicitly.\n * - {@link removeInputStream} releases the reader lock so the source can be reused.\n */\nexport class MultiInputStream<T> {\n  private transform: IdentityTransform<T>;\n  private writer: WritableStreamDefaultWriter<T>;\n  private inputs: Map<string, ReadableStreamDefaultReader<T>> = new Map();\n  private pumpPromises: Map<string, Promise<void>> = new Map();\n  private nextId = 0;\n  private _closed = false;\n  private logger = log();\n\n  constructor() {\n    this.transform = new IdentityTransform<T>();\n    this.writer = this.transform.writable.getWriter();\n  }\n\n  /** The single output stream that consumers read from. */\n  get stream(): ReadableStream<T> {\n    return this.transform.readable;\n  }\n\n  /** Number of currently active input streams. */\n  get inputCount(): number {\n    return this.inputs.size;\n  }\n\n  /** Whether {@link close} has been called. */\n  get isClosed(): boolean {\n    return this._closed;\n  }\n\n  /**\n   * Add an input {@link ReadableStream} that will be pumped into the output.\n   *\n   * @returns A unique identifier that can be passed to {@link removeInputStream}.\n   * @throws If the stream has already been closed.\n   */\n  addInputStream(source: ReadableStream<T>): string {\n    if (this._closed) {\n      throw new Error('MultiInputStream is closed');\n    }\n\n    const id = `input-${this.nextId++}`;\n    const reader = source.getReader();\n    this.inputs.set(id, reader);\n\n    const pumpDone = this.pumpInput(id, reader);\n    this.pumpPromises.set(id, pumpDone);\n\n    return id;\n  }\n\n  /**\n   * Detach an input stream by its ID and release the reader lock so the\n   * source stream can be reused elsewhere.\n   *\n   * No-op if the ID does not exist (e.g. the input already ended or was removed).\n   */\n  async removeInputStream(id: string): Promise<void> {\n    const reader = this.inputs.get(id);\n    if (!reader) return;\n\n    // Delete first so the pump's finally-block is a harmless no-op.\n    this.inputs.delete(id);\n\n    // Releasing the lock causes any pending reader.read() inside pump to throw\n    // a TypeError, which is caught by isStreamReaderReleaseError.\n    reader.releaseLock();\n\n    // Wait for the pump to finish so the caller knows cleanup is complete.\n    const pump = this.pumpPromises.get(id);\n    if (pump) {\n      await pump;\n      this.pumpPromises.delete(id);\n    }\n  }\n\n  /**\n   * Close the output stream and detach all inputs.\n   *\n   * Idempotent — calling more than once is a no-op.\n   */\n  async close(): Promise<void> {\n    if (this._closed) return;\n    this._closed = true;\n\n    // Release every input reader to unblock pending reads inside pumps.\n    for (const reader of this.inputs.values()) {\n      reader.releaseLock();\n    }\n    this.inputs.clear();\n\n    // Wait for every pump loop to finish before touching the writer.\n    await Promise.allSettled([...this.pumpPromises.values()]);\n    this.pumpPromises.clear();\n\n    // Close the output writer + writable side of the transform.\n    try {\n      this.writer.releaseLock();\n    } catch {\n      // ignore if already released\n    }\n\n    try {\n      await this.transform.writable.close();\n    } catch {\n      // ignore if already closed\n    }\n  }\n\n  private shouldStopPumping(id: string): boolean {\n    return this._closed || !this.inputs.has(id);\n  }\n\n  private async pumpInput(id: string, reader: ReadableStreamDefaultReader<T>): Promise<void> {\n    try {\n      while (true) {\n        // If the stream was closed or the input was removed while we were\n        // awaiting the previous write, bail out immediately.\n        if (this.shouldStopPumping(id)) break;\n\n        const { done, value } = await reader.read();\n        if (done) break;\n\n        // Double-check after the (potentially long) read.\n        if (this.shouldStopPumping(id)) break;\n\n        await this.writer.write(value);\n      }\n    } catch (e) {\n      // TypeErrors from releaseLock() during removeInputStream / close are expected.\n      if (isStreamReaderReleaseError(e)) {\n        return;\n      }\n\n      this.logger.error({ error: e }, 'Error pumping input stream from MultiInputStream');\n    } finally {\n      try {\n        reader.releaseLock();\n      } catch {\n        // ignore if already released\n      }\n\n      this.inputs.delete(id);\n      this.pumpPromises.delete(id);\n    }\n  }\n}\n"],"mappings":"AAQA,SAAS,WAAW;AACpB,SAAS,kCAAkC;AAC3C,SAAS,yBAAyB;AAgB3B,MAAM,iBAAoB;AAAA,EACvB;AAAA,EACA;AAAA,EACA,SAAsD,oBAAI,IAAI;AAAA,EAC9D,eAA2C,oBAAI,IAAI;AAAA,EACnD,SAAS;AAAA,EACT,UAAU;AAAA,EACV,SAAS,IAAI;AAAA,EAErB,cAAc;AACZ,SAAK,YAAY,IAAI,kBAAqB;AAC1C,SAAK,SAAS,KAAK,UAAU,SAAS,UAAU;AAAA,EAClD;AAAA;AAAA,EAGA,IAAI,SAA4B;AAC9B,WAAO,KAAK,UAAU;AAAA,EACxB;AAAA;AAAA,EAGA,IAAI,aAAqB;AACvB,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA;AAAA,EAGA,IAAI,WAAoB;AACtB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,eAAe,QAAmC;AAChD,QAAI,KAAK,SAAS;AAChB,YAAM,IAAI,MAAM,4BAA4B;AAAA,IAC9C;AAEA,UAAM,KAAK,SAAS,KAAK,QAAQ;AACjC,UAAM,SAAS,OAAO,UAAU;AAChC,SAAK,OAAO,IAAI,IAAI,MAAM;AAE1B,UAAM,WAAW,KAAK,UAAU,IAAI,MAAM;AAC1C,SAAK,aAAa,IAAI,IAAI,QAAQ;AAElC,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,kBAAkB,IAA2B;AACjD,UAAM,SAAS,KAAK,OAAO,IAAI,EAAE;AACjC,QAAI,CAAC,OAAQ;AAGb,SAAK,OAAO,OAAO,EAAE;AAIrB,WAAO,YAAY;AAGnB,UAAM,OAAO,KAAK,aAAa,IAAI,EAAE;AACrC,QAAI,MAAM;AACR,YAAM;AACN,WAAK,aAAa,OAAO,EAAE;AAAA,IAC7B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,QAAuB;AAC3B,QAAI,KAAK,QAAS;AAClB,SAAK,UAAU;AAGf,eAAW,UAAU,KAAK,OAAO,OAAO,GAAG;AACzC,aAAO,YAAY;AAAA,IACrB;AACA,SAAK,OAAO,MAAM;AAGlB,UAAM,QAAQ,WAAW,CAAC,GAAG,KAAK,aAAa,OAAO,CAAC,CAAC;AACxD,SAAK,aAAa,MAAM;AAGxB,QAAI;AACF,WAAK,OAAO,YAAY;AAAA,IAC1B,QAAQ;AAAA,IAER;AAEA,QAAI;AACF,YAAM,KAAK,UAAU,SAAS,MAAM;AAAA,IACtC,QAAQ;AAAA,IAER;AAAA,EACF;AAAA,EAEQ,kBAAkB,IAAqB;AAC7C,WAAO,KAAK,WAAW,CAAC,KAAK,OAAO,IAAI,EAAE;AAAA,EAC5C;AAAA,EAEA,MAAc,UAAU,IAAY,QAAuD;AACzF,QAAI;AACF,aAAO,MAAM;AAGX,YAAI,KAAK,kBAAkB,EAAE,EAAG;AAEhC,cAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAC1C,YAAI,KAAM;AAGV,YAAI,KAAK,kBAAkB,EAAE,EAAG;AAEhC,cAAM,KAAK,OAAO,MAAM,KAAK;AAAA,MAC/B;AAAA,IACF,SAAS,GAAG;AAEV,UAAI,2BAA2B,CAAC,GAAG;AACjC;AAAA,MACF;AAEA,WAAK,OAAO,MAAM,EAAE,OAAO,EAAE,GAAG,kDAAkD;AAAA,IACpF,UAAE;AACA,UAAI;AACF,eAAO,YAAY;AAAA,MACrB,QAAQ;AAAA,MAER;AAEA,WAAK,OAAO,OAAO,EAAE;AACrB,WAAK,aAAa,OAAO,EAAE;AAAA,IAC7B;AAAA,EACF;AACF;","names":[]}