modelfusion 0.132.0 → 0.134.0

package/tool/generate-tool-calls/generateToolCalls.d.ts

@@ -1,39 +0,0 @@
-import { FunctionOptions } from "../../core/FunctionOptions.js";
-import { ModelCallMetadata } from "../../model-function/ModelCallMetadata.js";
-import { ToolDefinition } from "../ToolDefinition.js";
-import { ToolCallsGenerationModel, ToolCallsGenerationModelSettings } from "./ToolCallsGenerationModel.js";
-type ToolCallDefinitionArray<T extends ToolDefinition<any, any>[]> = T;
-type ToToolCallDefinitionMap<T extends ToolCallDefinitionArray<ToolDefinition<any, any>[]>> = {
-    [K in T[number]["name"]]: Extract<T[number], ToolDefinition<K, any>>;
-};
-type ToToolCallUnion<T> = {
-    [KEY in keyof T]: T[KEY] extends ToolDefinition<any, infer PARAMETERS> ? {
-        id: string;
-        name: KEY;
-        args: PARAMETERS;
-    } : never;
-}[keyof T];
-type ToOutputValue<TOOL_CALLS extends ToolCallDefinitionArray<ToolDefinition<any, any>[]>> = ToToolCallUnion<ToToolCallDefinitionMap<TOOL_CALLS>>;
-export declare function generateToolCalls<TOOLS extends Array<ToolDefinition<any, any>>, PROMPT>(params: {
-    model: ToolCallsGenerationModel<PROMPT, ToolCallsGenerationModelSettings>;
-    tools: TOOLS;
-    prompt: PROMPT | ((tools: TOOLS) => PROMPT);
-    fullResponse?: false;
-} & FunctionOptions): Promise<{
-    text: string | null;
-    toolCalls: Array<ToOutputValue<TOOLS>> | null;
-}>;
-export declare function generateToolCalls<TOOLS extends ToolDefinition<any, any>[], PROMPT>(params: {
-    model: ToolCallsGenerationModel<PROMPT, ToolCallsGenerationModelSettings>;
-    tools: TOOLS;
-    prompt: PROMPT | ((tools: TOOLS) => PROMPT);
-    fullResponse: true;
-} & FunctionOptions): Promise<{
-    value: {
-        text: string | null;
-        toolCalls: Array<ToOutputValue<TOOLS>>;
-    };
-    rawResponse: unknown;
-    metadata: ModelCallMetadata;
-}>;
-export {};

package/tool/generate-tool-calls/generateToolCalls.js

@@ -1,59 +0,0 @@
-import { executeStandardCall } from "../../model-function/executeStandardCall.js";
-import { NoSuchToolDefinitionError } from "../NoSuchToolDefinitionError.js";
-import { ToolCallArgumentsValidationError } from "../ToolCallArgumentsValidationError.js";
-export async function generateToolCalls({ model, tools, prompt, fullResponse, ...options }) {
-    // Note: PROMPT must not be a function.
-    const expandedPrompt = typeof prompt === "function"
-        ? prompt(tools)
-        : prompt;
-    const callResponse = await executeStandardCall({
-        functionType: "generate-tool-calls",
-        input: expandedPrompt,
-        model,
-        options,
-        generateResponse: async (options) => {
-            const result = await model.doGenerateToolCalls(tools, expandedPrompt, options);
-            const { text, toolCalls: rawToolCalls } = result;
-            // no tool calls:
-            if (rawToolCalls == null) {
-                return {
-                    rawResponse: result.rawResponse,
-                    extractedValue: { text, toolCalls: null },
-                    usage: result.usage,
-                };
-            }
-            // map tool calls:
-            const toolCalls = rawToolCalls.map((rawToolCall) => {
-                const tool = tools.find((tool) => tool.name === rawToolCall.name);
-                if (tool == undefined) {
-                    throw new NoSuchToolDefinitionError({
-                        toolName: rawToolCall.name,
-                        parameters: rawToolCall.args,
-                    });
-                }
-                const parseResult = tool.parameters.validate(rawToolCall.args);
-                if (!parseResult.success) {
-                    throw new ToolCallArgumentsValidationError({
-                        toolName: tool.name,
-                        args: rawToolCall.args,
-                        cause: parseResult.error,
-                    });
-                }
-                return {
-                    id: rawToolCall.id,
-                    name: tool.name,
-                    args: parseResult.value,
-                };
-            });
-            return {
-                rawResponse: result.rawResponse,
-                extractedValue: {
-                    text,
-                    toolCalls: toolCalls,
-                },
-                usage: result.usage,
-            };
-        },
-    });
-    return fullResponse ? callResponse : callResponse.value;
-}

package/tool/generate-tool-calls/index.cjs

@@ -1,22 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./TextGenerationToolCallsModel.cjs"), exports);
-__exportStar(require("./ToolCallsGenerationEvent.cjs"), exports);
-__exportStar(require("./ToolCallsGenerationModel.cjs"), exports);
-__exportStar(require("./ToolCallsPromptTemplate.cjs"), exports);
-__exportStar(require("./ToolCallsParseError.cjs"), exports);
-__exportStar(require("./generateToolCalls.cjs"), exports);

package/tool/generate-tool-calls/index.d.ts

@@ -1,6 +0,0 @@
-export * from "./TextGenerationToolCallsModel.js";
-export * from "./ToolCallsGenerationEvent.js";
-export * from "./ToolCallsGenerationModel.js";
-export * from "./ToolCallsPromptTemplate.js";
-export * from "./ToolCallsParseError.js";
-export * from "./generateToolCalls.js";

package/tool/generate-tool-calls/index.js

@@ -1,6 +0,0 @@
-export * from "./TextGenerationToolCallsModel.js";
-export * from "./ToolCallsGenerationEvent.js";
-export * from "./ToolCallsGenerationModel.js";
-export * from "./ToolCallsPromptTemplate.js";
-export * from "./ToolCallsParseError.js";
-export * from "./generateToolCalls.js";

package/tool/index.cjs

@@ -1,31 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./NoSuchToolDefinitionError.cjs"), exports);
-__exportStar(require("./Tool.cjs"), exports);
-__exportStar(require("./ToolCall.cjs"), exports);
-__exportStar(require("./ToolCallArgumentsValidationError.cjs"), exports);
-__exportStar(require("./ToolCallError.cjs"), exports);
-__exportStar(require("./ToolCallGenerationError.cjs"), exports);
-__exportStar(require("./ToolCallResult.cjs"), exports);
-__exportStar(require("./ToolDefinition.cjs"), exports);
-__exportStar(require("./ToolExecutionError.cjs"), exports);
-__exportStar(require("./WebSearchTool.cjs"), exports);
-__exportStar(require("./execute-tool/index.cjs"), exports);
-__exportStar(require("./generate-tool-call/index.cjs"), exports);
-__exportStar(require("./generate-tool-calls/index.cjs"), exports);
-__exportStar(require("./run-tool/index.cjs"), exports);
-__exportStar(require("./run-tools/index.cjs"), exports);

package/tool/index.d.ts

@@ -1,15 +0,0 @@
-export * from "./NoSuchToolDefinitionError.js";
-export * from "./Tool.js";
-export * from "./ToolCall.js";
-export * from "./ToolCallArgumentsValidationError.js";
-export * from "./ToolCallError.js";
-export * from "./ToolCallGenerationError.js";
-export * from "./ToolCallResult.js";
-export * from "./ToolDefinition.js";
-export * from "./ToolExecutionError.js";
-export * from "./WebSearchTool.js";
-export * from "./execute-tool/index.js";
-export * from "./generate-tool-call/index.js";
-export * from "./generate-tool-calls/index.js";
-export * from "./run-tool/index.js";
-export * from "./run-tools/index.js";

package/tool/index.js

@@ -1,15 +0,0 @@
-export * from "./NoSuchToolDefinitionError.js";
-export * from "./Tool.js";
-export * from "./ToolCall.js";
-export * from "./ToolCallArgumentsValidationError.js";
-export * from "./ToolCallError.js";
-export * from "./ToolCallGenerationError.js";
-export * from "./ToolCallResult.js";
-export * from "./ToolDefinition.js";
-export * from "./ToolExecutionError.js";
-export * from "./WebSearchTool.js";
-export * from "./execute-tool/index.js";
-export * from "./generate-tool-call/index.js";
-export * from "./generate-tool-calls/index.js";
-export * from "./run-tool/index.js";
-export * from "./run-tools/index.js";

package/tool/run-tool/RunToolEvent.cjs

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/tool/run-tool/RunToolEvent.d.ts

@@ -1,7 +0,0 @@
-import { BaseFunctionFinishedEvent, BaseFunctionStartedEvent } from "../../core/FunctionEvent.js";
-export interface runToolStartedEvent extends BaseFunctionStartedEvent {
-    functionType: "run-tool";
-}
-export interface runToolFinishedEvent extends BaseFunctionFinishedEvent {
-    functionType: "run-tool";
-}

package/tool/run-tool/RunToolEvent.js

@@ -1 +0,0 @@
-export {};

package/tool/run-tool/index.cjs

@@ -1,18 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./RunToolEvent.cjs"), exports);
-__exportStar(require("./runTool.cjs"), exports);

package/tool/run-tool/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./RunToolEvent.js";
-export * from "./runTool.js";

package/tool/run-tool/index.js

@@ -1,2 +0,0 @@
-export * from "./RunToolEvent.js";
-export * from "./runTool.js";

package/tool/run-tool/runTool.cjs

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runTool = void 0;
-const executeFunctionCall_js_1 = require("../../core/executeFunctionCall.cjs");
-const safeExecuteToolCall_js_1 = require("../execute-tool/safeExecuteToolCall.cjs");
-const generateToolCall_js_1 = require("../generate-tool-call/generateToolCall.cjs");
-/**
- * `runTool` uses `generateToolCall` to generate parameters for a tool and
- * then executes the tool with the parameters using `executeTool`.
- *
- * @returns The result contains the name of the tool (`tool` property),
- * the parameters (`parameters` property, typed),
- * and the result of the tool execution (`result` property, typed).
- *
- * @see {@link generateToolCall}
- * @see {@link executeTool}
- */
-async function runTool({ model, tool, prompt, ...options }) {
-    // Note: PROMPT must not be a function.
-    const expandedPrompt = typeof prompt === "function"
-        ? prompt(tool)
-        : prompt;
-    return (0, executeFunctionCall_js_1.executeFunctionCall)({
-        options,
-        input: expandedPrompt,
-        functionType: "run-tool",
-        execute: async (options) => (0, safeExecuteToolCall_js_1.safeExecuteToolCall)(tool, await (0, generateToolCall_js_1.generateToolCall)({ model, tool, prompt: expandedPrompt, ...options }), options),
-    });
-}
-exports.runTool = runTool;

package/tool/run-tool/runTool.d.ts

@@ -1,20 +0,0 @@
-import { FunctionOptions } from "../../core/FunctionOptions.js";
-import { Tool } from "../Tool.js";
-import { ToolCallResult } from "../ToolCallResult.js";
-import { ToolCallGenerationModel, ToolCallGenerationModelSettings } from "../generate-tool-call/ToolCallGenerationModel.js";
-/**
- * `runTool` uses `generateToolCall` to generate parameters for a tool and
- * then executes the tool with the parameters using `executeTool`.
- *
- * @returns The result contains the name of the tool (`tool` property),
- * the parameters (`parameters` property, typed),
- * and the result of the tool execution (`result` property, typed).
- *
- * @see {@link generateToolCall}
- * @see {@link executeTool}
- */
-export declare function runTool<PROMPT, TOOL extends Tool<string, any, any>>({ model, tool, prompt, ...options }: {
-    model: ToolCallGenerationModel<PROMPT, ToolCallGenerationModelSettings>;
-    tool: TOOL;
-    prompt: PROMPT | ((tool: TOOL) => PROMPT);
-} & FunctionOptions): Promise<ToolCallResult<TOOL["name"], TOOL["parameters"], Awaited<ReturnType<TOOL["execute"]>>>>;

package/tool/run-tool/runTool.js

@@ -1,26 +0,0 @@
-import { executeFunctionCall } from "../../core/executeFunctionCall.js";
-import { safeExecuteToolCall } from "../execute-tool/safeExecuteToolCall.js";
-import { generateToolCall } from "../generate-tool-call/generateToolCall.js";
-/**
- * `runTool` uses `generateToolCall` to generate parameters for a tool and
- * then executes the tool with the parameters using `executeTool`.
- *
- * @returns The result contains the name of the tool (`tool` property),
- * the parameters (`parameters` property, typed),
- * and the result of the tool execution (`result` property, typed).
- *
- * @see {@link generateToolCall}
- * @see {@link executeTool}
- */
-export async function runTool({ model, tool, prompt, ...options }) {
-    // Note: PROMPT must not be a function.
-    const expandedPrompt = typeof prompt === "function"
-        ? prompt(tool)
-        : prompt;
-    return executeFunctionCall({
-        options,
-        input: expandedPrompt,
-        functionType: "run-tool",
-        execute: async (options) => safeExecuteToolCall(tool, await generateToolCall({ model, tool, prompt: expandedPrompt, ...options }), options),
-    });
-}

package/tool/run-tools/RunToolsEvent.cjs

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/tool/run-tools/RunToolsEvent.d.ts

@@ -1,7 +0,0 @@
-import { BaseFunctionFinishedEvent, BaseFunctionStartedEvent } from "../../core/FunctionEvent.js";
-export interface runToolsStartedEvent extends BaseFunctionStartedEvent {
-    functionType: "run-tools";
-}
-export interface runToolsFinishedEvent extends BaseFunctionFinishedEvent {
-    functionType: "run-tools";
-}

package/tool/run-tools/RunToolsEvent.js

@@ -1 +0,0 @@
-export {};

package/tool/run-tools/index.cjs

@@ -1,18 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./RunToolsEvent.cjs"), exports);
-__exportStar(require("./runTools.cjs"), exports);

package/tool/run-tools/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./RunToolsEvent.js";
-export * from "./runTools.js";

package/tool/run-tools/index.js

@@ -1,2 +0,0 @@
-export * from "./RunToolsEvent.js";
-export * from "./runTools.js";

package/tool/run-tools/runTools.cjs

@@ -1,54 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runTools = void 0;
-const executeFunctionCall_js_1 = require("../../core/executeFunctionCall.cjs");
-const ToolCallError_js_1 = require("../ToolCallError.cjs");
-const safeExecuteToolCall_js_1 = require("../execute-tool/safeExecuteToolCall.cjs");
-const generateToolCalls_js_1 = require("../generate-tool-calls/generateToolCalls.cjs");
-async function runTools({ model, tools, prompt, ...options }) {
-    // Note: PROMPT must not be a function.
-    const expandedPrompt = typeof prompt === "function"
-        ? prompt(tools)
-        : prompt;
-    return (0, executeFunctionCall_js_1.executeFunctionCall)({
-        options,
-        input: expandedPrompt,
-        functionType: "run-tools",
-        execute: async (options) => {
-            const modelResponse = await (0, generateToolCalls_js_1.generateToolCalls)({
-                model,
-                tools,
-                prompt: expandedPrompt,
-                fullResponse: false,
-                ...options,
-            });
-            const { toolCalls, text } = modelResponse;
-            // no tool calls:
-            if (toolCalls == null) {
-                return { text, toolResults: null };
-            }
-            // execute tools in parallel:
-            const toolResults = await Promise.all(toolCalls.map(async (toolCall) => {
-                const tool = tools.find((tool) => tool.name === toolCall.name);
-                if (tool == null) {
-                    return {
-                        tool: toolCall.name,
-                        toolCall,
-                        args: toolCall.args,
-                        ok: false,
-                        result: new ToolCallError_js_1.ToolCallError({
-                            message: `No tool with name '${toolCall.name}' found.`,
-                            toolCall,
-                        }),
-                    };
-                }
-                return await (0, safeExecuteToolCall_js_1.safeExecuteToolCall)(tool, toolCall, options);
-            }));
-            return {
-                text,
-                toolResults: toolResults,
-            };
-        },
-    });
-}
-exports.runTools = runTools;

package/tool/run-tools/runTools.d.ts

@@ -1,22 +0,0 @@
-import { FunctionOptions } from "../../core/FunctionOptions.js";
-import { Tool } from "../Tool.js";
-import { ToolCallResult } from "../ToolCallResult.js";
-import { ToolCallsGenerationModel, ToolCallsGenerationModelSettings } from "../generate-tool-calls/ToolCallsGenerationModel.js";
-type ToolArray<T extends Tool<any, any, any>[]> = T;
-type ToToolMap<T extends ToolArray<Tool<any, any, any>[]>> = {
-    [K in T[number]["name"]]: Extract<T[number], Tool<K, any, any>>;
-};
-type StringKeys<T> = Extract<keyof T, string>;
-type ToToolCallUnion<T> = {
-    [KEY in StringKeys<T>]: T[KEY] extends Tool<any, infer PARAMETERS, infer OUTPUT> ? ToolCallResult<KEY, PARAMETERS, OUTPUT> : never;
-}[StringKeys<T>];
-type ToOutputValue<TOOLS extends ToolArray<Tool<any, any, any>[]>> = ToToolCallUnion<ToToolMap<TOOLS>>;
-export declare function runTools<PROMPT, TOOLS extends Array<Tool<any, any, any>>>({ model, tools, prompt, ...options }: {
-    model: ToolCallsGenerationModel<PROMPT, ToolCallsGenerationModelSettings>;
-    tools: TOOLS;
-    prompt: PROMPT | ((tools: TOOLS) => PROMPT);
-} & FunctionOptions): Promise<{
-    text: string | null;
-    toolResults: Array<ToOutputValue<TOOLS>> | null;
-}>;
-export {};

package/tool/run-tools/runTools.js

@@ -1,50 +0,0 @@
-import { executeFunctionCall } from "../../core/executeFunctionCall.js";
-import { ToolCallError } from "../ToolCallError.js";
-import { safeExecuteToolCall } from "../execute-tool/safeExecuteToolCall.js";
-import { generateToolCalls } from "../generate-tool-calls/generateToolCalls.js";
-export async function runTools({ model, tools, prompt, ...options }) {
-    // Note: PROMPT must not be a function.
-    const expandedPrompt = typeof prompt === "function"
-        ? prompt(tools)
-        : prompt;
-    return executeFunctionCall({
-        options,
-        input: expandedPrompt,
-        functionType: "run-tools",
-        execute: async (options) => {
-            const modelResponse = await generateToolCalls({
-                model,
-                tools,
-                prompt: expandedPrompt,
-                fullResponse: false,
-                ...options,
-            });
-            const { toolCalls, text } = modelResponse;
-            // no tool calls:
-            if (toolCalls == null) {
-                return { text, toolResults: null };
-            }
-            // execute tools in parallel:
-            const toolResults = await Promise.all(toolCalls.map(async (toolCall) => {
-                const tool = tools.find((tool) => tool.name === toolCall.name);
-                if (tool == null) {
-                    return {
-                        tool: toolCall.name,
-                        toolCall,
-                        args: toolCall.args,
-                        ok: false,
-                        result: new ToolCallError({
-                            message: `No tool with name '${toolCall.name}' found.`,
-                            toolCall,
-                        }),
-                    };
-                }
-                return await safeExecuteToolCall(tool, toolCall, options);
-            }));
-            return {
-                text,
-                toolResults: toolResults,
-            };
-        },
-    });
-}

package/util/AsyncQueue.cjs

@@ -1,121 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AsyncQueue = void 0;
-/**
- * `AsyncQueue` is a class that represents an asynchronous queue.
- * It allows values to be pushed onto it and consumed (pulled) by an iterator.
- * The queue is async-iterable, making it compatible with async/await syntax.
- *
- * @template T The type of elements contained in the queue.
- * @example
- * const queue = new AsyncQueue<number>();
- * queue.push(1);
- * (async () => {
- *   for await (const value of queue) {
- *     console.log(value);
- *   }
- * })();
- */
-class AsyncQueue {
-    constructor() {
-        Object.defineProperty(this, "values", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: Array()
-        });
-        Object.defineProperty(this, "pendingResolvers", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: []
-        });
-        Object.defineProperty(this, "closed", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: false
-        });
-    }
-    processPendingResolvers() {
-        while (this.pendingResolvers.length > 0) {
-            this.pendingResolvers.shift()?.();
-        }
-    }
-    /**
-     * Pushes an element onto the queue. If the queue is closed, an error is thrown.
-     *
-     * @param {T} value - The element to add to the queue.
-     * @throws {Error} Throws an error if the queue is closed.
-     * @example
-     * queue.push(2);
-     */
-    push(value) {
-        if (this.closed) {
-            throw new Error("Cannot push value to closed queue.");
-        }
-        this.values.push({ type: "value", value });
-        this.processPendingResolvers();
-    }
-    error(error) {
-        if (this.closed) {
-            throw new Error("Cannot push error to closed queue.");
-        }
-        this.values.push({ type: "error", error });
-        this.processPendingResolvers();
-    }
-    /**
-     * Closes the queue, preventing more elements from being pushed onto it.
-     *
-     * @example
-     * queue.close();
-     */
-    close() {
-        this.closed = true;
-        this.processPendingResolvers();
-    }
-    /**
-     * Creates and returns an async iterator that allows the queue to be consumed.
-     * You can create multiple iterators for the same queue.
-     *
-     * @returns {AsyncIterator<T>} An async iterator for the queue.
-     * @example
-     * (async () => {
-     *   for await (const value of queue) {
-     *     console.log(value);
-     *   }
-     * })();
-     */
-    [Symbol.asyncIterator]() {
-        let position = 0;
-        return {
-            next: () => new Promise((resolve, reject) => {
-                const attemptResolve = () => {
-                    if (position < this.values.length) {
-                        const entry = this.values[position++];
-                        switch (entry.type) {
-                            case "value":
-                                resolve({ value: entry.value, done: false });
-                                break;
-                            case "error":
-                                reject(entry.error);
-                                break;
-                        }
-                    }
-                    else if (this.closed) {
-                        // The queue is closed, and there are no more values. Complete the iteration.
-                        resolve({ value: undefined, done: true }); // eslint-disable-line @typescript-eslint/no-explicit-any
-                    }
-                    else {
-                        // No values are currently available, and the queue is not closed.
-                        // The consumer is now pending and will be resolved when a new value is pushed
-                        // or when the queue is closed.
-                        this.pendingResolvers.push(attemptResolve);
-                    }
-                };
-                attemptResolve();
-            }),
-        };
-    }
-}
-exports.AsyncQueue = AsyncQueue;