@livekit/agents 0.7.9 → 1.0.0-next.0

package/dist/stream/deferred_stream.cjs

@@ -0,0 +1,98 @@
+"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 deferred_stream_exports = {};
+__export(deferred_stream_exports, {
+  DeferredReadableStream: () => DeferredReadableStream,
+  isStreamReaderReleaseError: () => isStreamReaderReleaseError
+});
+module.exports = __toCommonJS(deferred_stream_exports);
+var import_identity_transform = require("./identity_transform.cjs");
+function isStreamReaderReleaseError(e) {
+  const allowedMessages = [
+    "Invalid state: Releasing reader",
+    "Invalid state: The reader is not attached to a stream"
+  ];
+  if (e instanceof TypeError) {
+    return allowedMessages.some((message) => e.message.includes(message));
+  }
+  return false;
+}
+class DeferredReadableStream {
+  transform;
+  writer;
+  sourceReader;
+  constructor() {
+    this.transform = new import_identity_transform.IdentityTransform();
+    this.writer = this.transform.writable.getWriter();
+  }
+  get stream() {
+    return this.transform.readable;
+  }
+  get isSourceSet() {
+    return !!this.sourceReader;
+  }
+  /**
+   * Call once the actual source is ready.
+   */
+  setSource(source) {
+    if (this.isSourceSet) {
+      throw new Error("Stream source already set");
+    }
+    this.sourceReader = source.getReader();
+    this.pump();
+  }
+  async pump() {
+    let sourceError;
+    try {
+      while (true) {
+        const { done, value } = await this.sourceReader.read();
+        if (done) break;
+        await this.writer.write(value);
+      }
+    } catch (e) {
+      if (isStreamReaderReleaseError(e)) return;
+      sourceError = e;
+    } finally {
+      if (sourceError) {
+        this.writer.abort(sourceError);
+        return;
+      }
+      this.writer.releaseLock();
+      try {
+        await this.transform.writable.close();
+      } catch (e) {
+      }
+    }
+  }
+  /**
+   * Detach the source stream and clean up resources.
+   */
+  async detachSource() {
+    if (!this.isSourceSet) {
+      throw new Error("Source not set");
+    }
+    this.sourceReader.releaseLock();
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DeferredReadableStream,
+  isStreamReaderReleaseError
+});
+//# sourceMappingURL=deferred_stream.cjs.map

package/dist/stream/deferred_stream.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/stream/deferred_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 { IdentityTransform } from './identity_transform.js';\n\n/**\n * Check if error is related to reader.read after release lock\n *\n * Invalid state: Releasing reader\n * Invalid state: The reader is not attached to a stream\n */\nexport function isStreamReaderReleaseError(e: unknown) {\n  const allowedMessages = [\n    'Invalid state: Releasing reader',\n    'Invalid state: The reader is not attached to a stream',\n  ];\n\n  if (e instanceof TypeError) {\n    return allowedMessages.some((message) => e.message.includes(message));\n  }\n\n  return false;\n}\nexport class DeferredReadableStream<T> {\n  private transform: IdentityTransform<T>;\n  private writer: WritableStreamDefaultWriter<T>;\n  private sourceReader?: ReadableStreamDefaultReader<T>;\n\n  constructor() {\n    this.transform = new IdentityTransform<T>();\n    this.writer = this.transform.writable.getWriter();\n  }\n\n  get stream() {\n    return this.transform.readable;\n  }\n\n  get isSourceSet() {\n    return !!this.sourceReader;\n  }\n\n  /**\n   * Call once the actual source is ready.\n   */\n  setSource(source: ReadableStream<T>) {\n    if (this.isSourceSet) {\n      throw new Error('Stream source already set');\n    }\n\n    this.sourceReader = source.getReader();\n    this.pump();\n  }\n\n  private async pump() {\n    let sourceError: unknown;\n\n    try {\n      while (true) {\n        const { done, value } = await this.sourceReader!.read();\n        if (done) break;\n        await this.writer.write(value);\n      }\n    } catch (e) {\n      // skip source detach related errors\n      if (isStreamReaderReleaseError(e)) return;\n      sourceError = e;\n    } finally {\n      // any other error from source will be propagated to the consumer\n      if (sourceError) {\n        this.writer.abort(sourceError);\n        return;\n      }\n\n      // release lock so this.stream.getReader().read() will terminate with done: true\n      this.writer.releaseLock();\n\n      // we only close the writable stream after done\n      try {\n        await this.transform.writable.close();\n        // NOTE: we do not cancel this.transform.readable as there might be access to\n        // this.transform.readable.getReader() outside that blocks this cancellation\n        // hence, user is responsible for canceling reader on their own\n      } catch (e) {\n        // ignore TypeError: Invalid state: WritableStream is closed\n        // in case stream reader is already closed, this will throw\n        // but we ignore it as we are closing the stream anyway\n      }\n    }\n  }\n\n  /**\n   * Detach the source stream and clean up resources.\n   */\n  async detachSource() {\n    if (!this.isSourceSet) {\n      throw new Error('Source not set');\n    }\n\n    // release lock will make any pending read() throw TypeError\n    // which are expected, and we intentionally catch those error\n    // using isStreamReaderReleaseError\n    // this will unblock any pending read() inside the async for loop\n    this.sourceReader!.releaseLock();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,gCAAkC;AAQ3B,SAAS,2BAA2B,GAAY;AACrD,QAAM,kBAAkB;AAAA,IACtB;AAAA,IACA;AAAA,EACF;AAEA,MAAI,aAAa,WAAW;AAC1B,WAAO,gBAAgB,KAAK,CAAC,YAAY,EAAE,QAAQ,SAAS,OAAO,CAAC;AAAA,EACtE;AAEA,SAAO;AACT;AACO,MAAM,uBAA0B;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EAER,cAAc;AACZ,SAAK,YAAY,IAAI,4CAAqB;AAC1C,SAAK,SAAS,KAAK,UAAU,SAAS,UAAU;AAAA,EAClD;AAAA,EAEA,IAAI,SAAS;AACX,WAAO,KAAK,UAAU;AAAA,EACxB;AAAA,EAEA,IAAI,cAAc;AAChB,WAAO,CAAC,CAAC,KAAK;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,UAAU,QAA2B;AACnC,QAAI,KAAK,aAAa;AACpB,YAAM,IAAI,MAAM,2BAA2B;AAAA,IAC7C;AAEA,SAAK,eAAe,OAAO,UAAU;AACrC,SAAK,KAAK;AAAA,EACZ;AAAA,EAEA,MAAc,OAAO;AACnB,QAAI;AAEJ,QAAI;AACF,aAAO,MAAM;AACX,cAAM,EAAE,MAAM,MAAM,IAAI,MAAM,KAAK,aAAc,KAAK;AACtD,YAAI,KAAM;AACV,cAAM,KAAK,OAAO,MAAM,KAAK;AAAA,MAC/B;AAAA,IACF,SAAS,GAAG;AAEV,UAAI,2BAA2B,CAAC,EAAG;AACnC,oBAAc;AAAA,IAChB,UAAE;AAEA,UAAI,aAAa;AACf,aAAK,OAAO,MAAM,WAAW;AAC7B;AAAA,MACF;AAGA,WAAK,OAAO,YAAY;AAGxB,UAAI;AACF,cAAM,KAAK,UAAU,SAAS,MAAM;AAAA,MAItC,SAAS,GAAG;AAAA,MAIZ;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,eAAe;AACnB,QAAI,CAAC,KAAK,aAAa;AACrB,YAAM,IAAI,MAAM,gBAAgB;AAAA,IAClC;AAMA,SAAK,aAAc,YAAY;AAAA,EACjC;AACF;","names":[]}

package/dist/stream/deferred_stream.d.cts

@@ -0,0 +1,27 @@
+/// <reference types="node" resolution-mode="require"/>
+import type { ReadableStream } from 'node:stream/web';
+/**
+ * Check if error is related to reader.read after release lock
+ *
+ * Invalid state: Releasing reader
+ * Invalid state: The reader is not attached to a stream
+ */
+export declare function isStreamReaderReleaseError(e: unknown): boolean;
+export declare class DeferredReadableStream<T> {
+    private transform;
+    private writer;
+    private sourceReader?;
+    constructor();
+    get stream(): ReadableStream<T>;
+    get isSourceSet(): boolean;
+    /**
+     * Call once the actual source is ready.
+     */
+    setSource(source: ReadableStream<T>): void;
+    private pump;
+    /**
+     * Detach the source stream and clean up resources.
+     */
+    detachSource(): Promise<void>;
+}
+//# sourceMappingURL=deferred_stream.d.ts.map

package/dist/stream/deferred_stream.d.ts

@@ -0,0 +1,27 @@
+/// <reference types="node" resolution-mode="require"/>
+import type { ReadableStream } from 'node:stream/web';
+/**
+ * Check if error is related to reader.read after release lock
+ *
+ * Invalid state: Releasing reader
+ * Invalid state: The reader is not attached to a stream
+ */
+export declare function isStreamReaderReleaseError(e: unknown): boolean;
+export declare class DeferredReadableStream<T> {
+    private transform;
+    private writer;
+    private sourceReader?;
+    constructor();
+    get stream(): ReadableStream<T>;
+    get isSourceSet(): boolean;
+    /**
+     * Call once the actual source is ready.
+     */
+    setSource(source: ReadableStream<T>): void;
+    private pump;
+    /**
+     * Detach the source stream and clean up resources.
+     */
+    detachSource(): Promise<void>;
+}
+//# sourceMappingURL=deferred_stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deferred_stream.d.ts","sourceRoot":"","sources":["../../src/stream/deferred_stream.ts"],"names":[],"mappings":";AAGA,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,iBAAiB,CAAC;AAGzB;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,OAAO,WAWpD;AACD,qBAAa,sBAAsB,CAAC,CAAC;IACnC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,YAAY,CAAC,CAAiC;;IAOtD,IAAI,MAAM,sBAET;IAED,IAAI,WAAW,YAEd;IAED;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;YASrB,IAAI;IAqClB;;OAEG;IACG,YAAY;CAWnB"}

package/dist/stream/deferred_stream.js

@@ -0,0 +1,73 @@
+import { IdentityTransform } from "./identity_transform.js";
+function isStreamReaderReleaseError(e) {
+  const allowedMessages = [
+    "Invalid state: Releasing reader",
+    "Invalid state: The reader is not attached to a stream"
+  ];
+  if (e instanceof TypeError) {
+    return allowedMessages.some((message) => e.message.includes(message));
+  }
+  return false;
+}
+class DeferredReadableStream {
+  transform;
+  writer;
+  sourceReader;
+  constructor() {
+    this.transform = new IdentityTransform();
+    this.writer = this.transform.writable.getWriter();
+  }
+  get stream() {
+    return this.transform.readable;
+  }
+  get isSourceSet() {
+    return !!this.sourceReader;
+  }
+  /**
+   * Call once the actual source is ready.
+   */
+  setSource(source) {
+    if (this.isSourceSet) {
+      throw new Error("Stream source already set");
+    }
+    this.sourceReader = source.getReader();
+    this.pump();
+  }
+  async pump() {
+    let sourceError;
+    try {
+      while (true) {
+        const { done, value } = await this.sourceReader.read();
+        if (done) break;
+        await this.writer.write(value);
+      }
+    } catch (e) {
+      if (isStreamReaderReleaseError(e)) return;
+      sourceError = e;
+    } finally {
+      if (sourceError) {
+        this.writer.abort(sourceError);
+        return;
+      }
+      this.writer.releaseLock();
+      try {
+        await this.transform.writable.close();
+      } catch (e) {
+      }
+    }
+  }
+  /**
+   * Detach the source stream and clean up resources.
+   */
+  async detachSource() {
+    if (!this.isSourceSet) {
+      throw new Error("Source not set");
+    }
+    this.sourceReader.releaseLock();
+  }
+}
+export {
+  DeferredReadableStream,
+  isStreamReaderReleaseError
+};
+//# sourceMappingURL=deferred_stream.js.map

package/dist/stream/deferred_stream.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/stream/deferred_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 { IdentityTransform } from './identity_transform.js';\n\n/**\n * Check if error is related to reader.read after release lock\n *\n * Invalid state: Releasing reader\n * Invalid state: The reader is not attached to a stream\n */\nexport function isStreamReaderReleaseError(e: unknown) {\n  const allowedMessages = [\n    'Invalid state: Releasing reader',\n    'Invalid state: The reader is not attached to a stream',\n  ];\n\n  if (e instanceof TypeError) {\n    return allowedMessages.some((message) => e.message.includes(message));\n  }\n\n  return false;\n}\nexport class DeferredReadableStream<T> {\n  private transform: IdentityTransform<T>;\n  private writer: WritableStreamDefaultWriter<T>;\n  private sourceReader?: ReadableStreamDefaultReader<T>;\n\n  constructor() {\n    this.transform = new IdentityTransform<T>();\n    this.writer = this.transform.writable.getWriter();\n  }\n\n  get stream() {\n    return this.transform.readable;\n  }\n\n  get isSourceSet() {\n    return !!this.sourceReader;\n  }\n\n  /**\n   * Call once the actual source is ready.\n   */\n  setSource(source: ReadableStream<T>) {\n    if (this.isSourceSet) {\n      throw new Error('Stream source already set');\n    }\n\n    this.sourceReader = source.getReader();\n    this.pump();\n  }\n\n  private async pump() {\n    let sourceError: unknown;\n\n    try {\n      while (true) {\n        const { done, value } = await this.sourceReader!.read();\n        if (done) break;\n        await this.writer.write(value);\n      }\n    } catch (e) {\n      // skip source detach related errors\n      if (isStreamReaderReleaseError(e)) return;\n      sourceError = e;\n    } finally {\n      // any other error from source will be propagated to the consumer\n      if (sourceError) {\n        this.writer.abort(sourceError);\n        return;\n      }\n\n      // release lock so this.stream.getReader().read() will terminate with done: true\n      this.writer.releaseLock();\n\n      // we only close the writable stream after done\n      try {\n        await this.transform.writable.close();\n        // NOTE: we do not cancel this.transform.readable as there might be access to\n        // this.transform.readable.getReader() outside that blocks this cancellation\n        // hence, user is responsible for canceling reader on their own\n      } catch (e) {\n        // ignore TypeError: Invalid state: WritableStream is closed\n        // in case stream reader is already closed, this will throw\n        // but we ignore it as we are closing the stream anyway\n      }\n    }\n  }\n\n  /**\n   * Detach the source stream and clean up resources.\n   */\n  async detachSource() {\n    if (!this.isSourceSet) {\n      throw new Error('Source not set');\n    }\n\n    // release lock will make any pending read() throw TypeError\n    // which are expected, and we intentionally catch those error\n    // using isStreamReaderReleaseError\n    // this will unblock any pending read() inside the async for loop\n    this.sourceReader!.releaseLock();\n  }\n}\n"],"mappings":"AAQA,SAAS,yBAAyB;AAQ3B,SAAS,2BAA2B,GAAY;AACrD,QAAM,kBAAkB;AAAA,IACtB;AAAA,IACA;AAAA,EACF;AAEA,MAAI,aAAa,WAAW;AAC1B,WAAO,gBAAgB,KAAK,CAAC,YAAY,EAAE,QAAQ,SAAS,OAAO,CAAC;AAAA,EACtE;AAEA,SAAO;AACT;AACO,MAAM,uBAA0B;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EAER,cAAc;AACZ,SAAK,YAAY,IAAI,kBAAqB;AAC1C,SAAK,SAAS,KAAK,UAAU,SAAS,UAAU;AAAA,EAClD;AAAA,EAEA,IAAI,SAAS;AACX,WAAO,KAAK,UAAU;AAAA,EACxB;AAAA,EAEA,IAAI,cAAc;AAChB,WAAO,CAAC,CAAC,KAAK;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,UAAU,QAA2B;AACnC,QAAI,KAAK,aAAa;AACpB,YAAM,IAAI,MAAM,2BAA2B;AAAA,IAC7C;AAEA,SAAK,eAAe,OAAO,UAAU;AACrC,SAAK,KAAK;AAAA,EACZ;AAAA,EAEA,MAAc,OAAO;AACnB,QAAI;AAEJ,QAAI;AACF,aAAO,MAAM;AACX,cAAM,EAAE,MAAM,MAAM,IAAI,MAAM,KAAK,aAAc,KAAK;AACtD,YAAI,KAAM;AACV,cAAM,KAAK,OAAO,MAAM,KAAK;AAAA,MAC/B;AAAA,IACF,SAAS,GAAG;AAEV,UAAI,2BAA2B,CAAC,EAAG;AACnC,oBAAc;AAAA,IAChB,UAAE;AAEA,UAAI,aAAa;AACf,aAAK,OAAO,MAAM,WAAW;AAC7B;AAAA,MACF;AAGA,WAAK,OAAO,YAAY;AAGxB,UAAI;AACF,cAAM,KAAK,UAAU,SAAS,MAAM;AAAA,MAItC,SAAS,GAAG;AAAA,MAIZ;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,eAAe;AACnB,QAAI,CAAC,KAAK,aAAa;AACrB,YAAM,IAAI,MAAM,gBAAgB;AAAA,IAClC;AAMA,SAAK,aAAc,YAAY;AAAA,EACjC;AACF;","names":[]}