langchain 0.0.130 → 0.0.132

package/dist/callbacks/handlers/console.cjs

@@ -27,6 +27,11 @@ function elapsed(run) {
     return `${(elapsed / 1000).toFixed(2)}s`;
 }
 const { color } = ansi_styles_1.default;
+/**
+ * A tracer that logs all events to the console. It extends from the
+ * `BaseTracer` class and overrides its methods to provide custom logging
+ * functionality.
+ */
 class ConsoleCallbackHandler extends tracer_js_1.BaseTracer {
     constructor() {
         super(...arguments);
@@ -37,10 +42,21 @@ class ConsoleCallbackHandler extends tracer_js_1.BaseTracer {
             value: "console_callback_handler"
         });
     }
+    /**
+     * Method used to persist the run. In this case, it simply returns a
+     * resolved promise as there's no persistence logic.
+     * @param _run The run to persist.
+     * @returns A resolved promise.
+     */
     persistRun(_run) {
         return Promise.resolve();
     }
     // utility methods
+    /**
+     * Method used to get all the parent runs of a given run.
+     * @param run The run whose parents are to be retrieved.
+     * @returns An array of parent runs.
+     */
     getParents(run) {
         const parents = [];
         let currentRun = run;
@@ -56,6 +72,12 @@ class ConsoleCallbackHandler extends tracer_js_1.BaseTracer {
         }
         return parents;
     }
+    /**
+     * Method used to get a string representation of the run's lineage, which
+     * is used in logging.
+     * @param run The run whose lineage is to be retrieved.
+     * @returns A string representation of the run's lineage.
+     */
     getBreadcrumbs(run) {
         const parents = this.getParents(run).reverse();
         const string = [...parents, run]
@@ -67,18 +89,38 @@ class ConsoleCallbackHandler extends tracer_js_1.BaseTracer {
         return wrap(color.grey, string);
     }
     // logging methods
+    /**
+     * Method used to log the start of a chain run.
+     * @param run The chain run that has started.
+     * @returns void
+     */
     onChainStart(run) {
         const crumbs = this.getBreadcrumbs(run);
         console.log(`${wrap(color.green, "[chain/start]")} [${crumbs}] Entering Chain run with input: ${tryJsonStringify(run.inputs, "[inputs]")}`);
     }
+    /**
+     * Method used to log the end of a chain run.
+     * @param run The chain run that has ended.
+     * @returns void
+     */
     onChainEnd(run) {
         const crumbs = this.getBreadcrumbs(run);
         console.log(`${wrap(color.cyan, "[chain/end]")} [${crumbs}] [${elapsed(run)}] Exiting Chain run with output: ${tryJsonStringify(run.outputs, "[outputs]")}`);
     }
+    /**
+     * Method used to log any errors of a chain run.
+     * @param run The chain run that has errored.
+     * @returns void
+     */
     onChainError(run) {
         const crumbs = this.getBreadcrumbs(run);
         console.log(`${wrap(color.red, "[chain/error]")} [${crumbs}] [${elapsed(run)}] Chain run errored with error: ${tryJsonStringify(run.error, "[error]")}`);
     }
+    /**
+     * Method used to log the start of an LLM run.
+     * @param run The LLM run that has started.
+     * @returns void
+     */
     onLLMStart(run) {
         const crumbs = this.getBreadcrumbs(run);
         const inputs = "prompts" in run.inputs
@@ -86,38 +128,83 @@ class ConsoleCallbackHandler extends tracer_js_1.BaseTracer {
             : run.inputs;
         console.log(`${wrap(color.green, "[llm/start]")} [${crumbs}] Entering LLM run with input: ${tryJsonStringify(inputs, "[inputs]")}`);
     }
+    /**
+     * Method used to log the end of an LLM run.
+     * @param run The LLM run that has ended.
+     * @returns void
+     */
     onLLMEnd(run) {
         const crumbs = this.getBreadcrumbs(run);
         console.log(`${wrap(color.cyan, "[llm/end]")} [${crumbs}] [${elapsed(run)}] Exiting LLM run with output: ${tryJsonStringify(run.outputs, "[response]")}`);
     }
+    /**
+     * Method used to log any errors of an LLM run.
+     * @param run The LLM run that has errored.
+     * @returns void
+     */
     onLLMError(run) {
         const crumbs = this.getBreadcrumbs(run);
         console.log(`${wrap(color.red, "[llm/error]")} [${crumbs}] [${elapsed(run)}] LLM run errored with error: ${tryJsonStringify(run.error, "[error]")}`);
     }
+    /**
+     * Method used to log the start of a tool run.
+     * @param run The tool run that has started.
+     * @returns void
+     */
     onToolStart(run) {
         const crumbs = this.getBreadcrumbs(run);
         console.log(`${wrap(color.green, "[tool/start]")} [${crumbs}] Entering Tool run with input: "${run.inputs.input?.trim()}"`);
     }
+    /**
+     * Method used to log the end of a tool run.
+     * @param run The tool run that has ended.
+     * @returns void
+     */
     onToolEnd(run) {
         const crumbs = this.getBreadcrumbs(run);
         console.log(`${wrap(color.cyan, "[tool/end]")} [${crumbs}] [${elapsed(run)}] Exiting Tool run with output: "${run.outputs?.output?.trim()}"`);
     }
+    /**
+     * Method used to log any errors of a tool run.
+     * @param run The tool run that has errored.
+     * @returns void
+     */
     onToolError(run) {
         const crumbs = this.getBreadcrumbs(run);
         console.log(`${wrap(color.red, "[tool/error]")} [${crumbs}] [${elapsed(run)}] Tool run errored with error: ${tryJsonStringify(run.error, "[error]")}`);
     }
+    /**
+     * Method used to log the start of a retriever run.
+     * @param run The retriever run that has started.
+     * @returns void
+     */
     onRetrieverStart(run) {
         const crumbs = this.getBreadcrumbs(run);
         console.log(`${wrap(color.green, "[retriever/start]")} [${crumbs}] Entering Retriever run with input: ${tryJsonStringify(run.inputs, "[inputs]")}`);
     }
+    /**
+     * Method used to log the end of a retriever run.
+     * @param run The retriever run that has ended.
+     * @returns void
+     */
     onRetrieverEnd(run) {
         const crumbs = this.getBreadcrumbs(run);
         console.log(`${wrap(color.cyan, "[retriever/end]")} [${crumbs}] [${elapsed(run)}] Exiting Retriever run with output: ${tryJsonStringify(run.outputs, "[outputs]")}`);
     }
+    /**
+     * Method used to log any errors of a retriever run.
+     * @param run The retriever run that has errored.
+     * @returns void
+     */
     onRetrieverError(run) {
         const crumbs = this.getBreadcrumbs(run);
         console.log(`${wrap(color.red, "[retriever/error]")} [${crumbs}] [${elapsed(run)}] Retriever run errored with error: ${tryJsonStringify(run.error, "[error]")}`);
     }
+    /**
+     * Method used to log the action selected by the agent.
+     * @param run The run in which the agent action occurred.
+     * @returns void
+     */
     onAgentAction(run) {
         const agentRun = run;
         const crumbs = this.getBreadcrumbs(run);

package/dist/callbacks/handlers/console.d.ts

@@ -1,20 +1,107 @@
 import { BaseTracer, Run } from "./tracer.js";
+/**
+ * A tracer that logs all events to the console. It extends from the
+ * `BaseTracer` class and overrides its methods to provide custom logging
+ * functionality.
+ */
 export declare class ConsoleCallbackHandler extends BaseTracer {
     name: "console_callback_handler";
+    /**
+     * Method used to persist the run. In this case, it simply returns a
+     * resolved promise as there's no persistence logic.
+     * @param _run The run to persist.
+     * @returns A resolved promise.
+     */
     protected persistRun(_run: Run): Promise<void>;
+    /**
+     * Method used to get all the parent runs of a given run.
+     * @param run The run whose parents are to be retrieved.
+     * @returns An array of parent runs.
+     */
     getParents(run: Run): Run[];
+    /**
+     * Method used to get a string representation of the run's lineage, which
+     * is used in logging.
+     * @param run The run whose lineage is to be retrieved.
+     * @returns A string representation of the run's lineage.
+     */
     getBreadcrumbs(run: Run): string;
+    /**
+     * Method used to log the start of a chain run.
+     * @param run The chain run that has started.
+     * @returns void
+     */
     onChainStart(run: Run): void;
+    /**
+     * Method used to log the end of a chain run.
+     * @param run The chain run that has ended.
+     * @returns void
+     */
     onChainEnd(run: Run): void;
+    /**
+     * Method used to log any errors of a chain run.
+     * @param run The chain run that has errored.
+     * @returns void
+     */
     onChainError(run: Run): void;
+    /**
+     * Method used to log the start of an LLM run.
+     * @param run The LLM run that has started.
+     * @returns void
+     */
     onLLMStart(run: Run): void;
+    /**
+     * Method used to log the end of an LLM run.
+     * @param run The LLM run that has ended.
+     * @returns void
+     */
     onLLMEnd(run: Run): void;
+    /**
+     * Method used to log any errors of an LLM run.
+     * @param run The LLM run that has errored.
+     * @returns void
+     */
     onLLMError(run: Run): void;
+    /**
+     * Method used to log the start of a tool run.
+     * @param run The tool run that has started.
+     * @returns void
+     */
     onToolStart(run: Run): void;
+    /**
+     * Method used to log the end of a tool run.
+     * @param run The tool run that has ended.
+     * @returns void
+     */
     onToolEnd(run: Run): void;
+    /**
+     * Method used to log any errors of a tool run.
+     * @param run The tool run that has errored.
+     * @returns void
+     */
     onToolError(run: Run): void;
+    /**
+     * Method used to log the start of a retriever run.
+     * @param run The retriever run that has started.
+     * @returns void
+     */
     onRetrieverStart(run: Run): void;
+    /**
+     * Method used to log the end of a retriever run.
+     * @param run The retriever run that has ended.
+     * @returns void
+     */
     onRetrieverEnd(run: Run): void;
+    /**
+     * Method used to log any errors of a retriever run.
+     * @param run The retriever run that has errored.
+     * @returns void
+     */
     onRetrieverError(run: Run): void;
+    /**
+     * Method used to log the action selected by the agent.
+     * @param run The run in which the agent action occurred.
+     * @returns void
+     */
     onAgentAction(run: Run): void;
 }

package/dist/callbacks/handlers/console.js

@@ -21,6 +21,11 @@ function elapsed(run) {
     return `${(elapsed / 1000).toFixed(2)}s`;
 }
 const { color } = styles;
+/**
+ * A tracer that logs all events to the console. It extends from the
+ * `BaseTracer` class and overrides its methods to provide custom logging
+ * functionality.
+ */
 export class ConsoleCallbackHandler extends BaseTracer {
     constructor() {
         super(...arguments);
@@ -31,10 +36,21 @@ export class ConsoleCallbackHandler extends BaseTracer {
             value: "console_callback_handler"
         });
     }
+    /**
+     * Method used to persist the run. In this case, it simply returns a
+     * resolved promise as there's no persistence logic.
+     * @param _run The run to persist.
+     * @returns A resolved promise.
+     */
     persistRun(_run) {
         return Promise.resolve();
     }
     // utility methods
+    /**
+     * Method used to get all the parent runs of a given run.
+     * @param run The run whose parents are to be retrieved.
+     * @returns An array of parent runs.
+     */
     getParents(run) {
         const parents = [];
         let currentRun = run;
@@ -50,6 +66,12 @@ export class ConsoleCallbackHandler extends BaseTracer {
         }
         return parents;
     }
+    /**
+     * Method used to get a string representation of the run's lineage, which
+     * is used in logging.
+     * @param run The run whose lineage is to be retrieved.
+     * @returns A string representation of the run's lineage.
+     */
     getBreadcrumbs(run) {
         const parents = this.getParents(run).reverse();
         const string = [...parents, run]
@@ -61,18 +83,38 @@ export class ConsoleCallbackHandler extends BaseTracer {
         return wrap(color.grey, string);
     }
     // logging methods
+    /**
+     * Method used to log the start of a chain run.
+     * @param run The chain run that has started.
+     * @returns void
+     */
     onChainStart(run) {
         const crumbs = this.getBreadcrumbs(run);
         console.log(`${wrap(color.green, "[chain/start]")} [${crumbs}] Entering Chain run with input: ${tryJsonStringify(run.inputs, "[inputs]")}`);
     }
+    /**
+     * Method used to log the end of a chain run.
+     * @param run The chain run that has ended.
+     * @returns void
+     */
     onChainEnd(run) {
         const crumbs = this.getBreadcrumbs(run);
         console.log(`${wrap(color.cyan, "[chain/end]")} [${crumbs}] [${elapsed(run)}] Exiting Chain run with output: ${tryJsonStringify(run.outputs, "[outputs]")}`);
     }
+    /**
+     * Method used to log any errors of a chain run.
+     * @param run The chain run that has errored.
+     * @returns void
+     */
     onChainError(run) {
         const crumbs = this.getBreadcrumbs(run);
         console.log(`${wrap(color.red, "[chain/error]")} [${crumbs}] [${elapsed(run)}] Chain run errored with error: ${tryJsonStringify(run.error, "[error]")}`);
     }
+    /**
+     * Method used to log the start of an LLM run.
+     * @param run The LLM run that has started.
+     * @returns void
+     */
     onLLMStart(run) {
         const crumbs = this.getBreadcrumbs(run);
         const inputs = "prompts" in run.inputs
@@ -80,38 +122,83 @@ export class ConsoleCallbackHandler extends BaseTracer {
             : run.inputs;
         console.log(`${wrap(color.green, "[llm/start]")} [${crumbs}] Entering LLM run with input: ${tryJsonStringify(inputs, "[inputs]")}`);
     }
+    /**
+     * Method used to log the end of an LLM run.
+     * @param run The LLM run that has ended.
+     * @returns void
+     */
     onLLMEnd(run) {
         const crumbs = this.getBreadcrumbs(run);
         console.log(`${wrap(color.cyan, "[llm/end]")} [${crumbs}] [${elapsed(run)}] Exiting LLM run with output: ${tryJsonStringify(run.outputs, "[response]")}`);
     }
+    /**
+     * Method used to log any errors of an LLM run.
+     * @param run The LLM run that has errored.
+     * @returns void
+     */
     onLLMError(run) {
         const crumbs = this.getBreadcrumbs(run);
         console.log(`${wrap(color.red, "[llm/error]")} [${crumbs}] [${elapsed(run)}] LLM run errored with error: ${tryJsonStringify(run.error, "[error]")}`);
     }
+    /**
+     * Method used to log the start of a tool run.
+     * @param run The tool run that has started.
+     * @returns void
+     */
     onToolStart(run) {
         const crumbs = this.getBreadcrumbs(run);
         console.log(`${wrap(color.green, "[tool/start]")} [${crumbs}] Entering Tool run with input: "${run.inputs.input?.trim()}"`);
     }
+    /**
+     * Method used to log the end of a tool run.
+     * @param run The tool run that has ended.
+     * @returns void
+     */
     onToolEnd(run) {
         const crumbs = this.getBreadcrumbs(run);
         console.log(`${wrap(color.cyan, "[tool/end]")} [${crumbs}] [${elapsed(run)}] Exiting Tool run with output: "${run.outputs?.output?.trim()}"`);
     }
+    /**
+     * Method used to log any errors of a tool run.
+     * @param run The tool run that has errored.
+     * @returns void
+     */
     onToolError(run) {
         const crumbs = this.getBreadcrumbs(run);
         console.log(`${wrap(color.red, "[tool/error]")} [${crumbs}] [${elapsed(run)}] Tool run errored with error: ${tryJsonStringify(run.error, "[error]")}`);
     }
+    /**
+     * Method used to log the start of a retriever run.
+     * @param run The retriever run that has started.
+     * @returns void
+     */
     onRetrieverStart(run) {
         const crumbs = this.getBreadcrumbs(run);
         console.log(`${wrap(color.green, "[retriever/start]")} [${crumbs}] Entering Retriever run with input: ${tryJsonStringify(run.inputs, "[inputs]")}`);
     }
+    /**
+     * Method used to log the end of a retriever run.
+     * @param run The retriever run that has ended.
+     * @returns void
+     */
     onRetrieverEnd(run) {
         const crumbs = this.getBreadcrumbs(run);
         console.log(`${wrap(color.cyan, "[retriever/end]")} [${crumbs}] [${elapsed(run)}] Exiting Retriever run with output: ${tryJsonStringify(run.outputs, "[outputs]")}`);
     }
+    /**
+     * Method used to log any errors of a retriever run.
+     * @param run The retriever run that has errored.
+     * @returns void
+     */
     onRetrieverError(run) {
         const crumbs = this.getBreadcrumbs(run);
         console.log(`${wrap(color.red, "[retriever/error]")} [${crumbs}] [${elapsed(run)}] Retriever run errored with error: ${tryJsonStringify(run.error, "[error]")}`);
     }
+    /**
+     * Method used to log the action selected by the agent.
+     * @param run The run in which the agent action occurred.
+     * @returns void
+     */
     onAgentAction(run) {
         const agentRun = run;
         const crumbs = this.getBreadcrumbs(run);

package/dist/callbacks/handlers/initialize.cjs

@@ -3,6 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getTracingV2CallbackHandler = exports.getTracingCallbackHandler = void 0;
 const tracer_langchain_js_1 = require("./tracer_langchain.cjs");
 const tracer_langchain_v1_js_1 = require("./tracer_langchain_v1.cjs");
+/**
+ * Function that returns an instance of `LangChainTracerV1`. If a session
+ * is provided, it loads that session into the tracer; otherwise, it loads
+ * a default session.
+ * @param session Optional session to load into the tracer.
+ * @returns An instance of `LangChainTracerV1`.
+ */
 async function getTracingCallbackHandler(session) {
     const tracer = new tracer_langchain_v1_js_1.LangChainTracerV1();
     if (session) {
@@ -14,6 +21,11 @@ async function getTracingCallbackHandler(session) {
     return tracer;
 }
 exports.getTracingCallbackHandler = getTracingCallbackHandler;
+/**
+ * Function that returns an instance of `LangChainTracer`. It does not
+ * load any session data.
+ * @returns An instance of `LangChainTracer`.
+ */
 async function getTracingV2CallbackHandler() {
     return new tracer_langchain_js_1.LangChainTracer();
 }

package/dist/callbacks/handlers/initialize.d.ts

@@ -1,4 +1,16 @@
 import { LangChainTracer } from "./tracer_langchain.js";
 import { LangChainTracerV1 } from "./tracer_langchain_v1.js";
+/**
+ * Function that returns an instance of `LangChainTracerV1`. If a session
+ * is provided, it loads that session into the tracer; otherwise, it loads
+ * a default session.
+ * @param session Optional session to load into the tracer.
+ * @returns An instance of `LangChainTracerV1`.
+ */
 export declare function getTracingCallbackHandler(session?: string): Promise<LangChainTracerV1>;
+/**
+ * Function that returns an instance of `LangChainTracer`. It does not
+ * load any session data.
+ * @returns An instance of `LangChainTracer`.
+ */
 export declare function getTracingV2CallbackHandler(): Promise<LangChainTracer>;

package/dist/callbacks/handlers/initialize.js

@@ -1,5 +1,12 @@
 import { LangChainTracer } from "./tracer_langchain.js";
 import { LangChainTracerV1 } from "./tracer_langchain_v1.js";
+/**
+ * Function that returns an instance of `LangChainTracerV1`. If a session
+ * is provided, it loads that session into the tracer; otherwise, it loads
+ * a default session.
+ * @param session Optional session to load into the tracer.
+ * @returns An instance of `LangChainTracerV1`.
+ */
 export async function getTracingCallbackHandler(session) {
     const tracer = new LangChainTracerV1();
     if (session) {
@@ -10,6 +17,11 @@ export async function getTracingCallbackHandler(session) {
     }
     return tracer;
 }
+/**
+ * Function that returns an instance of `LangChainTracer`. It does not
+ * load any session data.
+ * @returns An instance of `LangChainTracer`.
+ */
 export async function getTracingV2CallbackHandler() {
     return new LangChainTracer();
 }

package/dist/callbacks/manager.cjs

@@ -21,12 +21,18 @@ function parseCallbackConfigArg(arg) {
     }
 }
 exports.parseCallbackConfigArg = parseCallbackConfigArg;
+/**
+ * Manage callbacks from different components of LangChain.
+ */
 class BaseCallbackManager {
     setHandler(handler) {
         return this.setHandlers([handler]);
     }
 }
 exports.BaseCallbackManager = BaseCallbackManager;
+/**
+ * Base class for run manager in LangChain.
+ */
 class BaseRunManager {
     constructor(runId, handlers, inheritableHandlers, tags, inheritableTags, metadata, inheritableMetadata, _parentRunId) {
         Object.defineProperty(this, "runId", {
@@ -89,6 +95,9 @@ class BaseRunManager {
         }, handler.awaitHandlers)));
     }
 }
+/**
+ * Manages callbacks for retriever runs.
+ */
 class CallbackManagerForRetrieverRun extends BaseRunManager {
     getChild(tag) {
         // eslint-disable-next-line @typescript-eslint/no-use-before-define

package/dist/callbacks/manager.d.ts

@@ -29,12 +29,18 @@ export interface BaseCallbackConfig {
     callbacks?: Callbacks;
 }
 export declare function parseCallbackConfigArg(arg: Callbacks | BaseCallbackConfig | undefined): BaseCallbackConfig;
+/**
+ * Manage callbacks from different components of LangChain.
+ */
 export declare abstract class BaseCallbackManager {
     abstract addHandler(handler: BaseCallbackHandler): void;
     abstract removeHandler(handler: BaseCallbackHandler): void;
     abstract setHandlers(handlers: BaseCallbackHandler[]): void;
     setHandler(handler: BaseCallbackHandler): void;
 }
+/**
+ * Base class for run manager in LangChain.
+ */
 declare class BaseRunManager {
     readonly runId: string;
     protected readonly handlers: BaseCallbackHandler[];
@@ -47,6 +53,9 @@ declare class BaseRunManager {
     constructor(runId: string, handlers: BaseCallbackHandler[], inheritableHandlers: BaseCallbackHandler[], tags: string[], inheritableTags: string[], metadata: Record<string, unknown>, inheritableMetadata: Record<string, unknown>, _parentRunId?: string | undefined);
     handleText(text: string): Promise<void>;
 }
+/**
+ * Manages callbacks for retriever runs.
+ */
 export declare class CallbackManagerForRetrieverRun extends BaseRunManager implements BaseCallbackManagerMethods {
     getChild(tag?: string): CallbackManager;
     handleRetrieverEnd(documents: Document[]): Promise<void>;

package/dist/callbacks/manager.js

@@ -17,11 +17,17 @@ export function parseCallbackConfigArg(arg) {
         return arg;
     }
 }
+/**
+ * Manage callbacks from different components of LangChain.
+ */
 export class BaseCallbackManager {
     setHandler(handler) {
         return this.setHandlers([handler]);
     }
 }
+/**
+ * Base class for run manager in LangChain.
+ */
 class BaseRunManager {
     constructor(runId, handlers, inheritableHandlers, tags, inheritableTags, metadata, inheritableMetadata, _parentRunId) {
         Object.defineProperty(this, "runId", {
@@ -84,6 +90,9 @@ class BaseRunManager {
         }, handler.awaitHandlers)));
     }
 }
+/**
+ * Manages callbacks for retriever runs.
+ */
 export class CallbackManagerForRetrieverRun extends BaseRunManager {
     getChild(tag) {
         // eslint-disable-next-line @typescript-eslint/no-use-before-define

package/dist/callbacks/promises.cjs

@@ -6,6 +6,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.awaitAllCallbacks = exports.consumeCallback = void 0;
 const p_queue_1 = __importDefault(require("p-queue"));
 let queue;
+/**
+ * Creates a queue using the p-queue library. The queue is configured to
+ * auto-start and has a concurrency of 1, meaning it will process tasks
+ * one at a time.
+ */
 function createQueue() {
     const PQueue = "default" in p_queue_1.default ? p_queue_1.default.default : p_queue_1.default;
     return new PQueue({
@@ -30,6 +35,10 @@ async function consumeCallback(promiseFn, wait) {
     }
 }
 exports.consumeCallback = consumeCallback;
+/**
+ * Waits for all promises in the queue to resolve. If the queue is
+ * undefined, it immediately resolves a promise.
+ */
 function awaitAllCallbacks() {
     return typeof queue !== "undefined" ? queue.onIdle() : Promise.resolve();
 }

package/dist/callbacks/promises.d.ts

@@ -4,4 +4,8 @@
  * @param wait Whether to wait for the promise to resolve or resolve immediately
  */
 export declare function consumeCallback<T>(promiseFn: () => Promise<T> | T | void, wait: boolean): Promise<void>;
+/**
+ * Waits for all promises in the queue to resolve. If the queue is
+ * undefined, it immediately resolves a promise.
+ */
 export declare function awaitAllCallbacks(): Promise<void>;

package/dist/callbacks/promises.js

@@ -1,5 +1,10 @@
 import PQueueMod from "p-queue";
 let queue;
+/**
+ * Creates a queue using the p-queue library. The queue is configured to
+ * auto-start and has a concurrency of 1, meaning it will process tasks
+ * one at a time.
+ */
 function createQueue() {
     const PQueue = "default" in PQueueMod ? PQueueMod.default : PQueueMod;
     return new PQueue({
@@ -23,6 +28,10 @@ export async function consumeCallback(promiseFn, wait) {
         void queue.add(promiseFn);
     }
 }
+/**
+ * Waits for all promises in the queue to resolve. If the queue is
+ * undefined, it immediately resolves a promise.
+ */
 export function awaitAllCallbacks() {
     return typeof queue !== "undefined" ? queue.onIdle() : Promise.resolve();
 }

package/dist/chains/analyze_documents_chain.cjs

@@ -9,6 +9,9 @@ const text_splitter_js_1 = require("../text_splitter.cjs");
  * @augments StuffDocumentsChainInput
  */
 class AnalyzeDocumentChain extends base_js_1.BaseChain {
+    static lc_name() {
+        return "AnalyzeDocumentChain";
+    }
     constructor(fields) {
         super(fields);
         Object.defineProperty(this, "inputKey", {