@aigne/core 1.72.0 → 1.74.0-beta

package/dist/utils/mcp-utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-utils.d.mts","names":[],"sources":["../../src/utils/mcp-utils.ts"],"mappings":";;;;iBAegB,eAAA,CAAA,IAAA,EAAsB,eAAA,mBAAA,OAAA,EAA2C,cAAA,GAAc,OAAA;AAAA,iBAY/E,mBAAA,CAAA,MAAA,EACN,iBAAA,qBAAA,OAAA,EACC,cAAA,GAAc,SAAA;AAAA,iBAmBT,uBAAA,CAAA,QAAA,EAEV,mBAAA,wBACA,2BAAA,+BAAA,OAAA,EACK,cAAA,GAAc,WAAA"}

package/dist/utils/mcp-utils.mjs

@@ -0,0 +1,51 @@
+import { isEmpty } from "./type-utils.mjs";
+import { MCPPrompt, MCPResource, MCPTool } from "../agents/mcp-agent.mjs";
+import { z as z$1 } from "zod";
+import { jsonSchemaToZod } from "@aigne/json-schema-to-zod";
+import { UriTemplate } from "@modelcontextprotocol/sdk/shared/uriTemplate.js";
+import { CallToolResultSchema, GetPromptResultSchema, ReadResourceResultSchema } from "@modelcontextprotocol/sdk/types.js";
+
+//#region src/utils/mcp-utils.ts
+function toolFromMCPTool(tool, options) {
+	return new MCPTool({
+		...options,
+		name: tool.name,
+		description: tool.description,
+		inputSchema: isEmpty(tool.inputSchema.properties) ? z$1.object({}) : jsonSchemaToZod(tool.inputSchema),
+		outputSchema: CallToolResultSchema
+	});
+}
+function promptFromMCPPrompt(prompt, options) {
+	return new MCPPrompt({
+		...options,
+		name: prompt.name,
+		description: prompt.description,
+		inputSchema: jsonSchemaToZod({
+			type: "object",
+			properties: prompt.arguments && Object.fromEntries(prompt.arguments.map((i) => [i.name, {
+				type: "string",
+				description: i.description
+			}])),
+			required: prompt.arguments?.filter((i) => i.required).map((i) => i.name)
+		}),
+		outputSchema: GetPromptResultSchema
+	});
+}
+function resourceFromMCPResource(resource, options) {
+	const [uri, variables] = isResourceTemplate(resource) ? [resource.uriTemplate, new UriTemplate(resource.uriTemplate).variableNames] : [resource.uri, []];
+	return new MCPResource({
+		...options,
+		name: resource.name,
+		uri,
+		description: resource.description,
+		inputSchema: z$1.object(Object.fromEntries(variables.map((i) => [i, z$1.string()]))),
+		outputSchema: ReadResourceResultSchema
+	});
+}
+function isResourceTemplate(resource) {
+	return "uriTemplate" in resource && typeof resource.uriTemplate === "string";
+}
+
+//#endregion
+export { promptFromMCPPrompt, resourceFromMCPResource, toolFromMCPTool };
+//# sourceMappingURL=mcp-utils.mjs.map

package/dist/utils/mcp-utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-utils.mjs","names":["z"],"sources":["../../src/utils/mcp-utils.ts"],"sourcesContent":["import { type JsonSchema, jsonSchemaToZod } from \"@aigne/json-schema-to-zod\";\nimport { UriTemplate } from \"@modelcontextprotocol/sdk/shared/uriTemplate.js\";\nimport {\n  CallToolResultSchema,\n  GetPromptResultSchema,\n  type ListPromptsResult,\n  type ListResourcesResult,\n  type ListResourceTemplatesResult,\n  type ListToolsResult,\n  ReadResourceResultSchema,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport { type ZodObject, type ZodType, z } from \"zod\";\nimport { type MCPBaseOptions, MCPPrompt, MCPResource, MCPTool } from \"../agents/mcp-agent.js\";\nimport { isEmpty } from \"./type-utils.js\";\n\nexport function toolFromMCPTool(tool: ListToolsResult[\"tools\"][number], options: MCPBaseOptions) {\n  return new MCPTool({\n    ...options,\n    name: tool.name,\n    description: tool.description,\n    inputSchema: isEmpty(tool.inputSchema.properties)\n      ? z.object({})\n      : jsonSchemaToZod<ZodObject<Record<string, ZodType>>>(tool.inputSchema as JsonSchema),\n    outputSchema: CallToolResultSchema as ZodType<any>,\n  });\n}\n\nexport function promptFromMCPPrompt(\n  prompt: ListPromptsResult[\"prompts\"][number],\n  options: MCPBaseOptions,\n) {\n  return new MCPPrompt({\n    ...options,\n    name: prompt.name,\n    description: prompt.description,\n    inputSchema: jsonSchemaToZod<ZodObject<Record<string, ZodType>>>({\n      type: \"object\",\n      properties:\n        prompt.arguments &&\n        Object.fromEntries(\n          prompt.arguments.map((i) => [i.name, { type: \"string\", description: i.description }]),\n        ),\n      required: prompt.arguments?.filter((i) => i.required).map((i) => i.name),\n    }),\n    outputSchema: GetPromptResultSchema,\n  });\n}\n\nexport function resourceFromMCPResource(\n  resource:\n    | ListResourcesResult[\"resources\"][number]\n    | ListResourceTemplatesResult[\"resourceTemplates\"][number],\n  options: MCPBaseOptions,\n) {\n  const [uri, variables] = isResourceTemplate(resource)\n    ? [resource.uriTemplate, new UriTemplate(resource.uriTemplate).variableNames]\n    : [resource.uri, []];\n\n  return new MCPResource({\n    ...options,\n    name: resource.name,\n    uri,\n    description: resource.description,\n    inputSchema: z.object(Object.fromEntries(variables.map((i) => [i, z.string()]))),\n    outputSchema: ReadResourceResultSchema,\n  });\n}\n\nfunction isResourceTemplate(\n  resource:\n    | ListResourcesResult[\"resources\"][number]\n    | ListResourceTemplatesResult[\"resourceTemplates\"][number],\n): resource is ListResourceTemplatesResult[\"resourceTemplates\"][number] {\n  return \"uriTemplate\" in resource && typeof resource.uriTemplate === \"string\";\n}\n"],"mappings":";;;;;;;;AAeA,SAAgB,gBAAgB,MAAwC,SAAyB;AAC/F,QAAO,IAAI,QAAQ;EACjB,GAAG;EACH,MAAM,KAAK;EACX,aAAa,KAAK;EAClB,aAAa,QAAQ,KAAK,YAAY,WAAW,GAC7CA,IAAE,OAAO,EAAE,CAAC,GACZ,gBAAoD,KAAK,YAA0B;EACvF,cAAc;EACf,CAAC;;AAGJ,SAAgB,oBACd,QACA,SACA;AACA,QAAO,IAAI,UAAU;EACnB,GAAG;EACH,MAAM,OAAO;EACb,aAAa,OAAO;EACpB,aAAa,gBAAoD;GAC/D,MAAM;GACN,YACE,OAAO,aACP,OAAO,YACL,OAAO,UAAU,KAAK,MAAM,CAAC,EAAE,MAAM;IAAE,MAAM;IAAU,aAAa,EAAE;IAAa,CAAC,CAAC,CACtF;GACH,UAAU,OAAO,WAAW,QAAQ,MAAM,EAAE,SAAS,CAAC,KAAK,MAAM,EAAE,KAAK;GACzE,CAAC;EACF,cAAc;EACf,CAAC;;AAGJ,SAAgB,wBACd,UAGA,SACA;CACA,MAAM,CAAC,KAAK,aAAa,mBAAmB,SAAS,GACjD,CAAC,SAAS,aAAa,IAAI,YAAY,SAAS,YAAY,CAAC,cAAc,GAC3E,CAAC,SAAS,KAAK,EAAE,CAAC;AAEtB,QAAO,IAAI,YAAY;EACrB,GAAG;EACH,MAAM,SAAS;EACf;EACA,aAAa,SAAS;EACtB,aAAaA,IAAE,OAAO,OAAO,YAAY,UAAU,KAAK,MAAM,CAAC,GAAGA,IAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;EAChF,cAAc;EACf,CAAC;;AAGJ,SAAS,mBACP,UAGsE;AACtE,QAAO,iBAAiB,YAAY,OAAO,SAAS,gBAAgB"}

package/dist/utils/model-utils.cjs

@@ -0,0 +1,12 @@
+
+//#region src/utils/model-utils.ts
+function mergeUsage(...usages) {
+	return {
+		inputTokens: usages.reduce((acc, usage) => usage ? acc + usage.inputTokens : acc, 0),
+		outputTokens: usages.reduce((acc, usage) => usage ? acc + usage.outputTokens : acc, 0),
+		aigneHubCredits: usages.reduce((acc, usage) => usage?.aigneHubCredits ? acc + usage.aigneHubCredits : acc, 0)
+	};
+}
+
+//#endregion
+exports.mergeUsage = mergeUsage;

package/dist/utils/model-utils.d.cts

@@ -0,0 +1,8 @@
+import { Nullish } from "./type-utils.cjs";
+import { ChatModelOutputUsage } from "../agents/chat-model.cjs";
+
+//#region src/utils/model-utils.d.ts
+declare function mergeUsage(...usages: Nullish<ChatModelOutputUsage>[]): ChatModelOutputUsage;
+//#endregion
+export { mergeUsage };
+//# sourceMappingURL=model-utils.d.cts.map

package/dist/utils/model-utils.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-utils.d.cts","names":[],"sources":["../../src/utils/model-utils.ts"],"mappings":";;;;iBAGgB,UAAA,CAAA,GAAA,MAAA,EAAsB,OAAA,CAAQ,oBAAA,MAA0B,oBAAA"}

package/dist/utils/model-utils.d.mts

@@ -0,0 +1,8 @@
+import { Nullish } from "./type-utils.mjs";
+import { ChatModelOutputUsage } from "../agents/chat-model.mjs";
+
+//#region src/utils/model-utils.d.ts
+declare function mergeUsage(...usages: Nullish<ChatModelOutputUsage>[]): ChatModelOutputUsage;
+//#endregion
+export { mergeUsage };
+//# sourceMappingURL=model-utils.d.mts.map

package/dist/utils/model-utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-utils.d.mts","names":[],"sources":["../../src/utils/model-utils.ts"],"mappings":";;;;iBAGgB,UAAA,CAAA,GAAA,MAAA,EAAsB,OAAA,CAAQ,oBAAA,MAA0B,oBAAA"}

package/dist/utils/model-utils.mjs

@@ -0,0 +1,12 @@
+//#region src/utils/model-utils.ts
+function mergeUsage(...usages) {
+	return {
+		inputTokens: usages.reduce((acc, usage) => usage ? acc + usage.inputTokens : acc, 0),
+		outputTokens: usages.reduce((acc, usage) => usage ? acc + usage.outputTokens : acc, 0),
+		aigneHubCredits: usages.reduce((acc, usage) => usage?.aigneHubCredits ? acc + usage.aigneHubCredits : acc, 0)
+	};
+}
+
+//#endregion
+export { mergeUsage };
+//# sourceMappingURL=model-utils.mjs.map

package/dist/utils/model-utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-utils.mjs","names":[],"sources":["../../src/utils/model-utils.ts"],"sourcesContent":["import type { ChatModelOutputUsage } from \"../agents/chat-model.js\";\nimport type { Nullish } from \"./type-utils.js\";\n\nexport function mergeUsage(...usages: Nullish<ChatModelOutputUsage>[]): ChatModelOutputUsage {\n  return {\n    inputTokens: usages.reduce((acc, usage) => (usage ? acc + usage.inputTokens : acc), 0),\n    outputTokens: usages.reduce((acc, usage) => (usage ? acc + usage.outputTokens : acc), 0),\n    aigneHubCredits: usages.reduce(\n      (acc, usage) => (usage?.aigneHubCredits ? acc + usage.aigneHubCredits : acc),\n      0,\n    ),\n  };\n}\n"],"mappings":";AAGA,SAAgB,WAAW,GAAG,QAA+D;AAC3F,QAAO;EACL,aAAa,OAAO,QAAQ,KAAK,UAAW,QAAQ,MAAM,MAAM,cAAc,KAAM,EAAE;EACtF,cAAc,OAAO,QAAQ,KAAK,UAAW,QAAQ,MAAM,MAAM,eAAe,KAAM,EAAE;EACxF,iBAAiB,OAAO,QACrB,KAAK,UAAW,OAAO,kBAAkB,MAAM,MAAM,kBAAkB,KACxE,EACD;EACF"}

package/dist/utils/promise.cjs

@@ -0,0 +1,17 @@
+
+//#region src/utils/promise.ts
+function promiseWithResolvers() {
+	let resolve;
+	let reject;
+	return {
+		promise: new Promise((res, rej) => {
+			resolve = res;
+			reject = rej;
+		}),
+		resolve,
+		reject
+	};
+}
+
+//#endregion
+exports.promiseWithResolvers = promiseWithResolvers;

package/dist/utils/promise.d.cts

@@ -0,0 +1,10 @@
+//#region src/utils/promise.d.ts
+interface PromiseWithResolvers<T> {
+  promise: Promise<T>;
+  resolve: (value: T | PromiseLike<T>) => void;
+  reject: (reason?: unknown) => void;
+}
+declare function promiseWithResolvers<T = void>(): PromiseWithResolvers<T>;
+//#endregion
+export { PromiseWithResolvers, promiseWithResolvers };
+//# sourceMappingURL=promise.d.cts.map

package/dist/utils/promise.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise.d.cts","names":[],"sources":["../../src/utils/promise.ts"],"mappings":";UAAiB,oBAAA;EAAA,OAAA,EACN,OAAA,CAAQ,CAAA;EAAA,OAAA,GAAA,KAAA,EACA,CAAA,GAAI,WAAA,CAAY,CAAA;EAAA,MAAA,GAAA,MAAA;AAAA;AAAA,iBAInB,oBAAA,UAAA,CAAA,GAAkC,oBAAA,CAAqB,CAAA"}

package/dist/utils/promise.d.mts

@@ -0,0 +1,10 @@
+//#region src/utils/promise.d.ts
+interface PromiseWithResolvers<T> {
+  promise: Promise<T>;
+  resolve: (value: T | PromiseLike<T>) => void;
+  reject: (reason?: unknown) => void;
+}
+declare function promiseWithResolvers<T = void>(): PromiseWithResolvers<T>;
+//#endregion
+export { PromiseWithResolvers, promiseWithResolvers };
+//# sourceMappingURL=promise.d.mts.map

package/dist/utils/promise.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise.d.mts","names":[],"sources":["../../src/utils/promise.ts"],"mappings":";UAAiB,oBAAA;EAAA,OAAA,EACN,OAAA,CAAQ,CAAA;EAAA,OAAA,GAAA,KAAA,EACA,CAAA,GAAI,WAAA,CAAY,CAAA;EAAA,MAAA,GAAA,MAAA;AAAA;AAAA,iBAInB,oBAAA,UAAA,CAAA,GAAkC,oBAAA,CAAqB,CAAA"}

package/dist/utils/promise.mjs

@@ -0,0 +1,17 @@
+//#region src/utils/promise.ts
+function promiseWithResolvers() {
+	let resolve;
+	let reject;
+	return {
+		promise: new Promise((res, rej) => {
+			resolve = res;
+			reject = rej;
+		}),
+		resolve,
+		reject
+	};
+}
+
+//#endregion
+export { promiseWithResolvers };
+//# sourceMappingURL=promise.mjs.map

package/dist/utils/promise.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise.mjs","names":[],"sources":["../../src/utils/promise.ts"],"sourcesContent":["export interface PromiseWithResolvers<T> {\n  promise: Promise<T>;\n  resolve: (value: T | PromiseLike<T>) => void;\n  reject: (reason?: unknown) => void;\n}\n\nexport function promiseWithResolvers<T = void>(): PromiseWithResolvers<T> {\n  let resolve!: (value: T | PromiseLike<T>) => void;\n  let reject!: (reason?: unknown) => void;\n\n  const promise = new Promise<T>((res, rej) => {\n    resolve = res;\n    reject = rej;\n  });\n\n  return { promise, resolve, reject };\n}\n"],"mappings":";AAMA,SAAgB,uBAA0D;CACxE,IAAI;CACJ,IAAI;AAOJ,QAAO;EAAE,SALO,IAAI,SAAY,KAAK,QAAQ;AAC3C,aAAU;AACV,YAAS;IACT;EAEgB;EAAS;EAAQ"}

package/dist/utils/prompts.cjs

@@ -0,0 +1,19 @@
+
+//#region src/utils/prompts.ts
+function buildJsonPrompt(schema, firstLine) {
+	let prompt = firstLine;
+	if (typeof schema === "string") prompt += `\n<json_fields>\n${schema}\n</json_fields>`;
+	else prompt += `\n<json_fields>\n${JSON.stringify(schema)}\n</json_fields>`;
+	prompt += "\nDo not include any explanations, comments, or Markdown formatting (such as triple backticks). Return only the raw JSON.";
+	return prompt;
+}
+function getJsonOutputPrompt(schema) {
+	return buildJsonPrompt(schema, "Output must be a JSON object containing the following fields only.");
+}
+function getJsonToolInputPrompt(schema) {
+	return buildJsonPrompt(schema, "Tool input must be a JSON object containing the following fields only.");
+}
+
+//#endregion
+exports.getJsonOutputPrompt = getJsonOutputPrompt;
+exports.getJsonToolInputPrompt = getJsonToolInputPrompt;

package/dist/utils/prompts.d.cts

@@ -0,0 +1,6 @@
+//#region src/utils/prompts.d.ts
+declare function getJsonOutputPrompt(schema: Record<string, unknown> | string): string;
+declare function getJsonToolInputPrompt(schema: Record<string, unknown> | string): string;
+//#endregion
+export { getJsonOutputPrompt, getJsonToolInputPrompt };
+//# sourceMappingURL=prompts.d.cts.map

package/dist/utils/prompts.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.cts","names":[],"sources":["../../src/utils/prompts.ts"],"mappings":";iBAYgB,mBAAA,CAAA,MAAA,EAA4B,MAAA;AAAA,iBAO5B,sBAAA,CAAA,MAAA,EAA+B,MAAA"}

package/dist/utils/prompts.d.mts

@@ -0,0 +1,6 @@
+//#region src/utils/prompts.d.ts
+declare function getJsonOutputPrompt(schema: Record<string, unknown> | string): string;
+declare function getJsonToolInputPrompt(schema: Record<string, unknown> | string): string;
+//#endregion
+export { getJsonOutputPrompt, getJsonToolInputPrompt };
+//# sourceMappingURL=prompts.d.mts.map

package/dist/utils/prompts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.mts","names":[],"sources":["../../src/utils/prompts.ts"],"mappings":";iBAYgB,mBAAA,CAAA,MAAA,EAA4B,MAAA;AAAA,iBAO5B,sBAAA,CAAA,MAAA,EAA+B,MAAA"}

package/dist/utils/prompts.mjs

@@ -0,0 +1,18 @@
+//#region src/utils/prompts.ts
+function buildJsonPrompt(schema, firstLine) {
+	let prompt = firstLine;
+	if (typeof schema === "string") prompt += `\n<json_fields>\n${schema}\n</json_fields>`;
+	else prompt += `\n<json_fields>\n${JSON.stringify(schema)}\n</json_fields>`;
+	prompt += "\nDo not include any explanations, comments, or Markdown formatting (such as triple backticks). Return only the raw JSON.";
+	return prompt;
+}
+function getJsonOutputPrompt(schema) {
+	return buildJsonPrompt(schema, "Output must be a JSON object containing the following fields only.");
+}
+function getJsonToolInputPrompt(schema) {
+	return buildJsonPrompt(schema, "Tool input must be a JSON object containing the following fields only.");
+}
+
+//#endregion
+export { getJsonOutputPrompt, getJsonToolInputPrompt };
+//# sourceMappingURL=prompts.mjs.map

package/dist/utils/prompts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.mjs","names":[],"sources":["../../src/utils/prompts.ts"],"sourcesContent":["function buildJsonPrompt(schema: Record<string, unknown> | string, firstLine: string) {\n  let prompt = firstLine;\n  if (typeof schema === \"string\") {\n    prompt += `\\n<json_fields>\\n${schema}\\n</json_fields>`;\n  } else {\n    prompt += `\\n<json_fields>\\n${JSON.stringify(schema)}\\n</json_fields>`;\n  }\n  prompt +=\n    \"\\nDo not include any explanations, comments, or Markdown formatting (such as triple backticks). Return only the raw JSON.\";\n  return prompt;\n}\n\nexport function getJsonOutputPrompt(schema: Record<string, unknown> | string) {\n  return buildJsonPrompt(\n    schema,\n    \"Output must be a JSON object containing the following fields only.\",\n  );\n}\n\nexport function getJsonToolInputPrompt(schema: Record<string, unknown> | string) {\n  return buildJsonPrompt(\n    schema,\n    \"Tool input must be a JSON object containing the following fields only.\",\n  );\n}\n"],"mappings":";AAAA,SAAS,gBAAgB,QAA0C,WAAmB;CACpF,IAAI,SAAS;AACb,KAAI,OAAO,WAAW,SACpB,WAAU,oBAAoB,OAAO;KAErC,WAAU,oBAAoB,KAAK,UAAU,OAAO,CAAC;AAEvD,WACE;AACF,QAAO;;AAGT,SAAgB,oBAAoB,QAA0C;AAC5E,QAAO,gBACL,QACA,qEACD;;AAGH,SAAgB,uBAAuB,QAA0C;AAC/E,QAAO,gBACL,QACA,yEACD"}

package/dist/utils/queue.cjs

@@ -0,0 +1,273 @@
+Object.defineProperty(exports, '__esModule', { value: true });
+
+//#region src/utils/queue.ts
+const nextTick = (() => {
+	if (typeof process !== "undefined" && process.nextTick) return process.nextTick;
+	if (typeof setImmediate !== "undefined") return setImmediate;
+	return (callback) => setTimeout(callback, 0);
+})();
+function createObjectPool(factory) {
+	const pool = [];
+	return {
+		get() {
+			return pool.pop() || factory();
+		},
+		release(obj) {
+			pool.push(obj);
+		}
+	};
+}
+function noop() {}
+function createTask() {
+	const task = {
+		value: null,
+		callback: noop,
+		next: null,
+		release: noop,
+		context: null,
+		errorHandler: null,
+		worked: function worked(err, result) {
+			const callback = task.callback;
+			const errorHandler = task.errorHandler;
+			const val = task.value;
+			task.value = null;
+			task.callback = noop;
+			if (task.errorHandler && err) errorHandler(err, val);
+			callback.call(task.context, err, result);
+			task.release(task);
+		}
+	};
+	return task;
+}
+function fastq(contextOrWorker, workerOrConcurrency, _concurrency) {
+	let context = null;
+	let worker;
+	let concurrency;
+	if (typeof contextOrWorker === "function") {
+		context = null;
+		worker = contextOrWorker;
+		concurrency = workerOrConcurrency;
+	} else {
+		context = contextOrWorker;
+		worker = workerOrConcurrency;
+		concurrency = _concurrency;
+	}
+	if (!(concurrency >= 1)) throw new Error("fastq concurrency must be equal to or greater than 1");
+	const cache = createObjectPool(() => createTask());
+	let queueHead = null;
+	let queueTail = null;
+	let _running = 0;
+	let errorHandler = null;
+	const self = {
+		push,
+		drain: noop,
+		saturated: noop,
+		pause,
+		paused: false,
+		get concurrency() {
+			return concurrency;
+		},
+		set concurrency(value) {
+			if (!(value >= 1)) throw new Error("fastq concurrency must be equal to or greater than 1");
+			concurrency = value;
+			if (self.paused) return;
+			for (; queueHead && _running < concurrency;) {
+				_running++;
+				release();
+			}
+		},
+		running,
+		resume,
+		idle,
+		length,
+		getQueue,
+		unshift,
+		empty: noop,
+		kill,
+		killAndDrain,
+		error
+	};
+	return self;
+	function running() {
+		return _running;
+	}
+	function pause() {
+		self.paused = true;
+	}
+	function length() {
+		let current = queueHead;
+		let counter = 0;
+		while (current) {
+			current = current.next;
+			counter++;
+		}
+		return counter;
+	}
+	function getQueue() {
+		let current = queueHead;
+		const tasks = [];
+		while (current) {
+			if (current.value !== null) tasks.push(current.value);
+			current = current.next;
+		}
+		return tasks;
+	}
+	function resume() {
+		if (!self.paused) return;
+		self.paused = false;
+		for (; queueHead && _running < concurrency;) {
+			_running++;
+			release();
+		}
+	}
+	function idle() {
+		return _running === 0 && self.length() === 0;
+	}
+	function push(value, done) {
+		const current = cache.get();
+		current.context = context;
+		current.release = release;
+		current.value = value;
+		current.callback = done || noop;
+		current.errorHandler = errorHandler;
+		if (_running >= concurrency || self.paused) if (queueTail) {
+			queueTail.next = current;
+			queueTail = current;
+		} else {
+			queueHead = current;
+			queueTail = current;
+			self.saturated();
+		}
+		else {
+			_running++;
+			worker.call(context, current.value, current.worked);
+		}
+	}
+	function unshift(value, done) {
+		const current = cache.get();
+		current.context = context;
+		current.release = release;
+		current.value = value;
+		current.callback = done || noop;
+		current.errorHandler = errorHandler;
+		if (_running >= concurrency || self.paused) if (queueHead) {
+			current.next = queueHead;
+			queueHead = current;
+		} else {
+			queueHead = current;
+			queueTail = current;
+			self.saturated();
+		}
+		else {
+			_running++;
+			worker.call(context, current.value, current.worked);
+		}
+	}
+	function release(holder) {
+		if (holder) cache.release(holder);
+		const next = queueHead;
+		if (next) if (!self.paused) {
+			if (queueTail === queueHead) queueTail = null;
+			queueHead = next.next;
+			next.next = null;
+			worker.call(context, next.value, next.worked);
+			if (queueTail === null) self.empty();
+		} else _running--;
+		else if (--_running === 0) self.drain();
+	}
+	function kill() {
+		queueHead = null;
+		queueTail = null;
+		self.drain = noop;
+	}
+	function killAndDrain() {
+		queueHead = null;
+		queueTail = null;
+		self.drain();
+		self.drain = noop;
+	}
+	function error(handler) {
+		errorHandler = handler;
+	}
+}
+function queueAsPromised(contextOrWorker, workerOrConcurrency, _concurrency) {
+	let context = null;
+	let worker;
+	let concurrency;
+	if (typeof contextOrWorker === "function") {
+		context = null;
+		worker = contextOrWorker;
+		concurrency = workerOrConcurrency;
+	} else {
+		context = contextOrWorker;
+		worker = workerOrConcurrency;
+		concurrency = _concurrency;
+	}
+	function asyncWrapper(arg, cb) {
+		worker.call(context, arg).then((res) => cb(null, res), (err) => cb(err));
+	}
+	const queue = fastq(context, asyncWrapper, concurrency);
+	const pushCb = queue.push;
+	const unshiftCb = queue.unshift;
+	const promiseQueue = {
+		...queue,
+		push,
+		unshift,
+		drained
+	};
+	Object.defineProperty(promiseQueue, "drain", {
+		get: () => queue.drain,
+		set: (value) => {
+			queue.drain = value;
+		}
+	});
+	return promiseQueue;
+	function push(value) {
+		const p = new Promise((resolve, reject) => {
+			pushCb(value, (err, result) => {
+				if (err) {
+					reject(err);
+					return;
+				}
+				resolve(result);
+			});
+		});
+		p.catch(noop);
+		return p;
+	}
+	function unshift(value) {
+		const p = new Promise((resolve, reject) => {
+			unshiftCb(value, (err, result) => {
+				if (err) {
+					reject(err);
+					return;
+				}
+				resolve(result);
+			});
+		});
+		p.catch(noop);
+		return p;
+	}
+	function drained() {
+		return new Promise((resolve) => {
+			nextTick(() => {
+				if (queue.idle()) resolve();
+				else {
+					const previousDrain = queue.drain;
+					queue.drain = () => {
+						if (typeof previousDrain === "function" && previousDrain !== noop) previousDrain();
+						resolve();
+						queue.drain = previousDrain;
+					};
+				}
+			});
+		});
+	}
+}
+fastq.promise = queueAsPromised;
+var queue_default = fastq;
+const promise = queueAsPromised;
+
+//#endregion
+exports.default = queue_default;
+exports.promise = promise;

package/dist/utils/queue.d.cts

@@ -0,0 +1,60 @@
+//#region src/utils/queue.d.ts
+/** biome-ignore-all lint/style/noNonNullAssertion lint/complexity/useOptionalChain: <!> */
+declare namespace fastq {
+  type worker<C, T = any, R = any> = (this: C, task: T, cb: fastq.done<R>) => void;
+  type asyncWorker<C, T = any, R = any> = (this: C, task: T) => Promise<R>;
+  type done<R = any> = (err: Error | null, result?: R) => void;
+  type errorHandler<T = any> = (err: Error, task: T) => void;
+  interface queue<T = any, R = any> {
+    /** Add a task at the end of the queue. `done(err, result)` will be called when the task was processed. */
+    push(task: T, done?: done<R>): void;
+    /** Add a task at the beginning of the queue. `done(err, result)` will be called when the task was processed. */
+    unshift(task: T, done?: done<R>): void;
+    /** Pause the processing of tasks. Currently worked tasks are not stopped. */
+    pause(): any;
+    /** Resume the processing of tasks. */
+    resume(): any;
+    running(): number;
+    /** Returns `false` if there are tasks being processed or waiting to be processed. `true` otherwise. */
+    idle(): boolean;
+    /** Returns the number of tasks waiting to be processed (in the queue). */
+    length(): number;
+    /** Returns all the tasks be processed (in the queue). Returns empty array when there are no tasks */
+    getQueue(): T[];
+    /** Removes all tasks waiting to be processed, and reset `drain` to an empty function. */
+    kill(): any;
+    /** Same than `kill` but the `drain` function will be called before reset to empty. */
+    killAndDrain(): any;
+    /** Set a global error handler. `handler(err, task)` will be called each time a task is completed, `err` will be not null if the task has thrown an error. */
+    error(handler: errorHandler<T>): void;
+    /** Property that returns the number of concurrent tasks that could be executed in parallel. It can be altered at runtime. */
+    concurrency: number;
+    /** Property that returns `true` when the queue is in a paused state. */
+    paused: boolean;
+    /** Function that will be called when the last item from the queue has been processed by a worker. It can be altered at runtime. */
+    drain(): any;
+    /** Function that will be called when the last item from the queue has been assigned to a worker. It can be altered at runtime. */
+    empty: () => void;
+    /** Function that will be called when the queue hits the concurrency limit. It can be altered at runtime. */
+    saturated: () => void;
+  }
+  interface queueAsPromised<T = any, R = any> extends queue<T, R> {
+    /** Add a task at the end of the queue. The returned `Promise` will be fulfilled (rejected) when the task is completed successfully (unsuccessfully). */
+    push(task: T): Promise<R>;
+    /** Add a task at the beginning of the queue. The returned `Promise` will be fulfilled (rejected) when the task is completed successfully (unsuccessfully). */
+    unshift(task: T): Promise<R>;
+    /** Wait for the queue to be drained. The returned `Promise` will be resolved when all tasks in the queue have been processed by a worker. */
+    drained(): Promise<void>;
+  }
+}
+declare function fastq<C, T = any, R = any>(context: C, worker: fastq.worker<C, T, R>, _concurrency: number): fastq.queue<T, R>;
+declare function fastq<C, T = any, R = any>(worker: fastq.worker<C, T, R>, _concurrency: number): fastq.queue<T, R>;
+declare namespace fastq {
+  var promise: typeof queueAsPromised;
+}
+declare function queueAsPromised<C, T = any, R = any>(context: C, worker: fastq.asyncWorker<C, T, R>, _concurrency: number): fastq.queueAsPromised<T, R>;
+declare function queueAsPromised<C, T = any, R = any>(worker: fastq.asyncWorker<C, T, R>, _concurrency: number): fastq.queueAsPromised<T, R>;
+declare const promise: typeof queueAsPromised;
+//#endregion
+export { fastq as default, promise };
+//# sourceMappingURL=queue.d.cts.map

package/dist/utils/queue.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.cts","names":[],"sources":["../../src/utils/queue.ts"],"mappings":";;kBAmBkB,KAAA;EAAA,KAAA,MAAA,yBAAA,IAAA,EAC0B,CAAA,EAAA,IAAA,EAAS,CAAA,EAAA,EAAA,EAAO,KAAA,CAAM,IAAA,CAAK,CAAA;EAAA,KAAA,WAAA,yBAAA,IAAA,EACtB,CAAA,EAAA,IAAA,EAAS,CAAA,KAAM,OAAA,CAAQ,CAAA;EAAA,KAAA,IAAA,aAAA,GAAA,EAC3C,KAAA,SAAA,MAAA,GAAuB,CAAA;EAAA,KAAA,YAAA,aAAA,GAAA,EACf,KAAA,EAAA,IAAA,EAAa,CAAA;EAAA,UAAA,KAAA;IAAA;IAAA,IAAA,CAAA,IAAA,EAInC,CAAA,EAAA,IAAA,GAAU,IAAA,CAAK,CAAA;IAAA;IAAA,OAAA,CAAA,IAAA,EAEZ,CAAA,EAAA,IAAA,GAAU,IAAA,CAAK,CAAA;IAAA;IAAA,KAAA;IAAA;IAAA,MAAA;IAAA,OAAA;IAAA;IAAA,IAAA;IAAA;IAAA,MAAA;IAAA;IAAA,QAAA,IAWjB,CAAA;IAAA;IAAA,IAAA;IAAA;IAAA,YAAA;IAAA;IAAA,KAAA,CAAA,OAAA,EAMG,YAAA,CAAa,CAAA;IAAA;IAAA,WAAA;IAAA;IAAA,MAAA;IAAA;IAAA,KAAA;IAAA;IAAA,KAAA;IAAA;IAAA,SAAA;EAAA;EAAA,UAAA,eAAA,2BAasB,KAAA,CAAM,CAAA,EAAG,CAAA;IAAA;IAAA,IAAA,CAAA,IAAA,EAEhD,CAAA,GAAI,OAAA,CAAQ,CAAA;IAAA;IAAA,OAAA,CAAA,IAAA,EAET,CAAA,GAAI,OAAA,CAAQ,CAAA;IAAA;IAAA,OAAA,IAEf,OAAA;EAAA;AAAA;AAAA,iBAwDN,KAAA,qBAAA,CAAA,OAAA,EACE,CAAA,EAAA,MAAA,EACD,KAAA,CAAM,MAAA,CAAO,CAAA,EAAG,CAAA,EAAG,CAAA,GAAA,YAAA,WAE1B,KAAA,CAAM,KAAA,CAAM,CAAA,EAAG,CAAA;AAAA,iBACT,KAAA,qBAAA,CAAA,MAAA,EACC,KAAA,CAAM,MAAA,CAAO,CAAA,EAAG,CAAA,EAAG,CAAA,GAAA,YAAA,WAE1B,KAAA,CAAM,KAAA,CAAM,CAAA,EAAG,CAAA;AAAA,kBAHT,KAAA;EAAA,IAAA,OAAA,SAAK,eAAA;AAAA;AAAA,iBAgNL,eAAA,qBAAA,CAAA,OAAA,EACE,CAAA,EAAA,MAAA,EACD,KAAA,CAAM,WAAA,CAAY,CAAA,EAAG,CAAA,EAAG,CAAA,GAAA,YAAA,WAE/B,KAAA,CAAM,eAAA,CAAgB,CAAA,EAAG,CAAA;AAAA,iBACnB,eAAA,qBAAA,CAAA,MAAA,EACC,KAAA,CAAM,WAAA,CAAY,CAAA,EAAG,CAAA,EAAG,CAAA,GAAA,YAAA,WAE/B,KAAA,CAAM,eAAA,CAAgB,CAAA,EAAG,CAAA;AAAA,cA4Gf,OAAA,SAAO,eAAA"}