@librechat/agents 4.0.1 → 4.0.2

package/dist/esm/decisions/presets.mjs

@@ -0,0 +1,77 @@
+import { createHttpDecisionModel } from "./http.mjs";
+//#region src/decisions/presets.ts
+const DEFAULT_API_KEY_ENV = "DECISION_API_KEY";
+const DECISION_PRESETS = Object.freeze({
+	http: Object.freeze({
+		dialect: "port",
+		requiresAuth: true,
+		apiKeyEnv: DEFAULT_API_KEY_ENV
+	}),
+	typesafe: Object.freeze({
+		baseURL: "https://api.typesafe.ai/v1/systemone",
+		model: "jev-latest",
+		dialect: "systemone",
+		requiresAuth: true,
+		apiKeyEnv: "TYPESAFE_API_KEY"
+	}),
+	laya: Object.freeze({
+		dialect: "systemone",
+		requiresAuth: false
+	}),
+	clickhouse: Object.freeze({
+		baseURL: "https://inference-internal.clickhouse.cloud/v1/systemone",
+		model: "jev-latest",
+		dialect: "systemone",
+		requiresAuth: true,
+		apiKeyEnv: "CHAI_AUTH_TOKEN"
+	}),
+	openrouter: Object.freeze({
+		baseURL: "https://openrouter.ai/api/alpha/decisions",
+		model: "~typesafe/jev-latest",
+		dialect: "systemone",
+		requiresAuth: true,
+		apiKeyEnv: "OPENROUTER_KEY"
+	}),
+	cloudflare: Object.freeze({
+		model: "typesafe/jev",
+		dialect: "systemone",
+		requestKey: "input",
+		responseKey: "result",
+		requiresAuth: true,
+		apiKeyEnv: "CLOUDFLARE_API_TOKEN"
+	})
+});
+function decisionPreset(name) {
+	if (name == null || name === "") return null;
+	return Object.hasOwn(DECISION_PRESETS, name) ? { ...DECISION_PRESETS[name] } : null;
+}
+function mergeDecisionSettings(preset, configured) {
+	return {
+		...preset ?? {},
+		...configured ?? {},
+		...preset?.requiresAuth === true ? { requiresAuth: true } : {}
+	};
+}
+function decisionProviderNames() {
+	return Object.keys(DECISION_PRESETS);
+}
+function createDecisionModel(settings, apiKey, options) {
+	return createHttpDecisionModel({
+		providerId: options?.providerId,
+		apiKey,
+		requiresAuth: settings.requiresAuth,
+		endpoint: settings.baseURL ?? "",
+		model: settings.model,
+		dialect: settings.dialect,
+		requestKey: settings.requestKey,
+		responseKey: settings.responseKey,
+		timeoutMs: settings.timeoutMs,
+		maxRetries: settings.maxRetries,
+		fetch: options?.fetch,
+		onAnswered: options?.onAnswered
+	});
+}
+//#endregion
+export { DECISION_PRESETS, DEFAULT_API_KEY_ENV, createDecisionModel, decisionPreset, decisionProviderNames, mergeDecisionSettings };
+
+//# sourceMappingURL=presets.mjs.map

package/dist/esm/decisions/presets.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.mjs","names":[],"sources":["../../../src/decisions/presets.ts"],"mappings":";;AAQA,MAAa,sBAAsB;AAMnC,MAAa,mBAET,OAAO,OAAO;CAChB,MAAM,OAAO,OAAO;EAClB,SAAS;EACT,cAAc;EACd,WAAW;CACb,CAAC;CACD,UAAU,OAAO,OAAO;EACtB,SAAS;EACT,OAAO;EACP,SAAS;EACT,cAAc;EACd,WAAW;CACb,CAAC;CACD,MAAM,OAAO,OAAO;EAElB,SAAS;EACT,cAAc;CAChB,CAAC;CACD,YAAY,OAAO,OAAO;EAExB,SAAS;EACT,OAAO;EACP,SAAS;EACT,cAAc;EACd,WAAW;CACb,CAAC;CACD,YAAY,OAAO,OAAO;EACxB,SAAS;EACT,OAAO;EACP,SAAS;EACT,cAAc;EACd,WAAW;CACb,CAAC;CACD,YAAY,OAAO,OAAO;EAExB,OAAO;EACP,SAAS;EACT,YAAY;EACZ,aAAa;EACb,cAAc;EACd,WAAW;CACb,CAAC;AACH,CAAC;AAED,SAAgB,eACd,MACiC;CACjC,IAAI,QAAQ,QAAQ,SAAS,IAC3B,OAAO;CAET,OAAO,OAAO,OAAO,kBAAkB,IAAI,IACvC,EAAE,GAAG,iBAAiB,MAAM,IAC5B;AACN;AAGA,SAAgB,sBACd,QACA,YAC0B;CAC1B,OAAO;EACL,GAAI,UAAU,CAAC;EACf,GAAI,cAAc,CAAC;EACnB,GAAI,QAAQ,iBAAiB,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;CAChE;AACF;AAEA,SAAgB,wBAAkC;CAChD,OAAO,OAAO,KAAK,gBAAgB;AACrC;AAEA,SAAgB,oBACd,UACA,QACA,SAKe;CACf,OAAO,wBAAwB;EAC7B,YAAY,SAAS;EACrB;EACA,cAAc,SAAS;EACvB,UAAU,SAAS,WAAW;EAC9B,OAAO,SAAS;EAChB,SAAS,SAAS;EAClB,YAAY,SAAS;EACrB,aAAa,SAAS;EACtB,WAAW,SAAS;EACpB,YAAY,SAAS;EACrB,OAAO,SAAS;EAChB,YAAY,SAAS;CACvB,CAAC;AACH"}

package/dist/esm/decisions/questions.mjs

@@ -0,0 +1,67 @@
+import { DecisionError, isDecisionObject } from "./types.mjs";
+//#region src/decisions/questions.ts
+function validQuestionId(id) {
+	if (id.length === 0 || id.length > 128) return false;
+	for (let index = 0; index < id.length; index++) if (id.charCodeAt(index) < 32) return false;
+	return true;
+}
+function validBooleanCriteria(criteria) {
+	if (criteria === void 0 || typeof criteria === "string") return true;
+	if (!isDecisionObject(criteria)) return false;
+	for (const [side, description] of Object.entries(criteria)) if (side !== "true" && side !== "false" || description !== void 0 && typeof description !== "string" && !Array.isArray(description) && !isDecisionObject(description)) return false;
+	return true;
+}
+function validateDecisionQuestions(questions, provider) {
+	if (!isDecisionObject(questions)) throw new DecisionError("bad_request", "invalid decision model questions", { provider });
+	const supplied = Object.entries(questions);
+	if (supplied.length === 0) throw new DecisionError("bad_request", "decision model requires questions", { provider });
+	const entries = [];
+	for (const [id, question] of supplied) {
+		if (!validQuestionId(id) || !isDecisionObject(question) || ![
+			"boolean",
+			"choice",
+			"score"
+		].includes(question.type) || question.type === "boolean" && !validBooleanCriteria(question.criteria) || question.type === "choice" && (!isDecisionObject(question.criteria) || Object.keys(question.criteria).length === 0) || question.type === "score" && (!Array.isArray(question.criteria) || question.criteria.length < 2)) throw new DecisionError("bad_request", "invalid decision model question", { provider });
+		if (question.type === "choice") entries.push([id, {
+			...question,
+			criteria: { ...question.criteria }
+		}]);
+		else if (question.type === "score") entries.push([id, {
+			...question,
+			criteria: [...question.criteria]
+		}]);
+		else entries.push([id, {
+			...question,
+			...isDecisionObject(question.criteria) ? { criteria: { ...question.criteria } } : {}
+		}]);
+	}
+	return entries;
+}
+function booleanQuestion(instructions, criteria) {
+	return criteria == null ? {
+		type: "boolean",
+		instructions
+	} : {
+		type: "boolean",
+		instructions,
+		criteria
+	};
+}
+function choiceQuestion(instructions, criteria) {
+	return {
+		type: "choice",
+		instructions,
+		criteria
+	};
+}
+function scoreQuestion(instructions, levels) {
+	return {
+		type: "score",
+		instructions,
+		criteria: levels
+	};
+}
+//#endregion
+export { booleanQuestion, choiceQuestion, scoreQuestion, validateDecisionQuestions };
+
+//# sourceMappingURL=questions.mjs.map

package/dist/esm/decisions/questions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"questions.mjs","names":[],"sources":["../../../src/decisions/questions.ts"],"mappings":";;AAUA,SAAS,gBAAgB,IAAqB;CAC5C,IAAI,GAAG,WAAW,KAAK,GAAG,SAAS,KACjC,OAAO;CAET,KAAK,IAAI,QAAQ,GAAG,QAAQ,GAAG,QAAQ,SACrC,IAAI,GAAG,WAAW,KAAK,IAAI,IACzB,OAAO;CAGX,OAAO;AACT;AAEA,SAAS,qBAAqB,UAAgD;CAC5E,IAAI,aAAa,KAAA,KAAa,OAAO,aAAa,UAChD,OAAO;CAET,IAAI,CAAC,iBAAiB,QAAQ,GAC5B,OAAO;CAET,KAAK,MAAM,CAAC,MAAM,gBAAgB,OAAO,QAAQ,QAAQ,GACvD,IACG,SAAS,UAAU,SAAS,WAC5B,gBAAgB,KAAA,KACf,OAAO,gBAAgB,YACvB,CAAC,MAAM,QAAQ,WAAW,KAC1B,CAAC,iBAAiB,WAAW,GAE/B,OAAO;CAGX,OAAO;AACT;AAEA,SAAgB,0BACd,WACA,UACmC;CACnC,IAAI,CAAC,iBAAiB,SAAS,GAC7B,MAAM,IAAI,cAAc,eAAe,oCAAoC,EACzE,SACF,CAAC;CAEH,MAAM,WAAW,OAAO,QAAQ,SAAS;CACzC,IAAI,SAAS,WAAW,GACtB,MAAM,IAAI,cACR,eACA,qCACA,EACE,SACF,CACF;CAEF,MAAM,UAA6C,CAAC;CACpD,KAAK,MAAM,CAAC,IAAI,aAAa,UAAU;EACrC,IACE,CAAC,gBAAgB,EAAE,KACnB,CAAC,iBAAiB,QAAQ,KAC1B,CAAC;GAAC;GAAW;GAAU;EAAO,CAAC,CAAC,SAAS,SAAS,IAAI,KACrD,SAAS,SAAS,aACjB,CAAC,qBAAqB,SAAS,QAAQ,KACxC,SAAS,SAAS,aAChB,CAAC,iBAAiB,SAAS,QAAQ,KAClC,OAAO,KAAK,SAAS,QAAQ,CAAC,CAAC,WAAW,MAC7C,SAAS,SAAS,YAChB,CAAC,MAAM,QAAQ,SAAS,QAAQ,KAAK,SAAS,SAAS,SAAS,IAEnE,MAAM,IAAI,cACR,eACA,mCACA,EACE,SACF,CACF;EAEF,IAAI,SAAS,SAAS,UACpB,QAAQ,KAAK,CAAC,IAAI;GAAE,GAAG;GAAU,UAAU,EAAE,GAAG,SAAS,SAAS;EAAE,CAAC,CAAC;OACjE,IAAI,SAAS,SAAS,SAC3B,QAAQ,KAAK,CAAC,IAAI;GAAE,GAAG;GAAU,UAAU,CAAC,GAAG,SAAS,QAAQ;EAAE,CAAC,CAAC;OAEpE,QAAQ,KAAK,CACX,IACA;GACE,GAAG;GACH,GAAI,iBAAiB,SAAS,QAAQ,IAClC,EAAE,UAAU,EAAE,GAAG,SAAS,SAAS,EAAE,IACrC,CAAC;EACP,CACF,CAAC;CAEL;CACA,OAAO;AACT;AAGA,SAAgB,gBACd,cACA,UACiB;CACjB,OAAO,YAAY,OACf;EAAE,MAAM;EAAW;CAAa,IAChC;EAAE,MAAM;EAAW;EAAc;CAAS;AAChD;AAGA,SAAgB,eACd,cACA,UACgB;CAChB,OAAO;EAAE,MAAM;EAAU;EAAc;CAAS;AAClD;AAGA,SAAgB,cACd,cACA,QACe;CACf,OAAO;EAAE,MAAM;EAAS;EAAc,UAAU;CAAO;AACzD"}

package/dist/esm/decisions/structuredChat.mjs

@@ -0,0 +1,178 @@
+import { DECISION_PROMPT_PREFIX } from "./traceMarker.mjs";
+import { DecisionError, isDecisionObject, readDecisionUsage } from "./types.mjs";
+import { validateDecisionQuestions } from "./questions.mjs";
+import { withDecisionDeadline } from "./deadline.mjs";
+import { failureForStatus, retryAfterMs } from "./transport.mjs";
+import { HumanMessage, SystemMessage } from "@langchain/core/messages";
+//#region src/decisions/structuredChat.ts
+const MAX_QUESTIONS = 32;
+const MAX_CHOICE_OPTIONS = 128;
+const DEFAULT_TIMEOUT_MS = 2e4;
+const PROVIDER_ID = "structured-chat";
+function readChatUsage(raw) {
+	if (!isDecisionObject(raw)) return null;
+	const usage = readDecisionUsage(raw.usage_metadata);
+	const response = isDecisionObject(raw.response_metadata) ? raw.response_metadata : null;
+	const nested = isDecisionObject(response?.metadata) ? response.metadata : null;
+	const bedrock = isDecisionObject(nested?.usage) ? nested.usage : response?.usage;
+	if (usage?.inputTokens === void 0 || !isDecisionObject(bedrock) || usage.inputTokens !== bedrock.inputTokens) return usage;
+	const read = bedrock.cacheReadInputTokens;
+	const write = bedrock.cacheWriteInputTokens;
+	if (read != null && (typeof read !== "number" || !Number.isSafeInteger(read) || read < 0) || write != null && (typeof write !== "number" || !Number.isSafeInteger(write) || write < 0)) return usage;
+	const inputTokens = usage.inputTokens + (typeof read === "number" ? read : 0) + (typeof write === "number" ? write : 0);
+	return Number.isSafeInteger(inputTokens) ? {
+		...usage,
+		inputTokens
+	} : usage;
+}
+function providerFailure(error, provider) {
+	const details = isDecisionObject(error) ? error : null;
+	const metadata = isDecisionObject(details?.$metadata) ? details.$metadata : null;
+	const rawStatus = details?.status ?? details?.statusCode ?? metadata?.httpStatusCode;
+	const status = typeof rawStatus === "number" && Number.isInteger(rawStatus) && rawStatus >= 100 && rawStatus <= 599 ? rawStatus : void 0;
+	const failure = new DecisionError(status == null ? "network" : failureForStatus(status), "structured decision model request failed", {
+		provider,
+		status
+	});
+	const headers = details?.headers;
+	if (headers instanceof Headers) failure.retryAfterMs = retryAfterMs(headers.get("retry-after"));
+	return failure;
+}
+function decisionSchema(entries) {
+	const properties = Object.create(null);
+	for (const [id, question] of entries) {
+		if (question.type === "boolean") {
+			properties[id] = {
+				type: "object",
+				properties: { decision: { type: "boolean" } },
+				required: ["decision"],
+				additionalProperties: false
+			};
+			continue;
+		}
+		properties[id] = {
+			type: "object",
+			properties: { choice: {
+				type: "string",
+				enum: Object.keys(question.criteria)
+			} },
+			required: ["choice"],
+			additionalProperties: false
+		};
+	}
+	return {
+		type: "object",
+		properties: { answers: {
+			type: "object",
+			properties,
+			required: entries.map(([id]) => id),
+			additionalProperties: false
+		} },
+		required: ["answers"],
+		additionalProperties: false
+	};
+}
+function readDecisions(parsed, entries, provider) {
+	const invalid = () => new DecisionError("malformed_response", "invalid structured decision model answer", { provider });
+	if (!isDecisionObject(parsed) || Object.keys(parsed).length !== 1 || !isDecisionObject(parsed.answers) || Object.keys(parsed.answers).length !== entries.length) throw invalid();
+	const answers = Object.create(null);
+	for (const [id, question] of entries) {
+		if (!Object.hasOwn(parsed.answers, id)) throw invalid();
+		const raw = parsed.answers[id];
+		if (!isDecisionObject(raw) || Object.keys(raw).length !== 1) throw invalid();
+		if (question.type === "boolean") {
+			if (typeof raw.decision !== "boolean") throw invalid();
+			answers[id] = {
+				type: "boolean",
+				decision: raw.decision,
+				probability: null
+			};
+			continue;
+		}
+		if (question.type !== "choice" || typeof raw.choice !== "string" || !Object.hasOwn(question.criteria, raw.choice)) throw invalid();
+		answers[id] = {
+			type: "choice",
+			choice: raw.choice,
+			confidence: null,
+			probabilities: null
+		};
+	}
+	return answers;
+}
+function questionsForChat(questions, provider, maxQuestions) {
+	const entries = validateDecisionQuestions(questions, provider);
+	let choices = 0;
+	for (const [, question] of entries) {
+		if (question.type === "score") throw new DecisionError("unsupported_question", "chat decision cannot score expected values", { provider });
+		if (question.type === "choice") choices += Object.keys(question.criteria).length;
+	}
+	if (entries.length > maxQuestions || choices > MAX_CHOICE_OPTIONS) throw new DecisionError("unsupported_question", "decision model question batch too large", { provider });
+	return entries;
+}
+function createStructuredChatDecisionModel(options) {
+	const provider = options.providerId ?? PROVIDER_ID;
+	if (!["jsonSchema", "functionCalling"].includes(options.method)) throw new DecisionError("unsupported_mode", "unsupported structured decision model mode", { provider });
+	if (!options.modelId.trim()) throw new DecisionError("bad_request", "decision model requires a model id", { provider });
+	const maxQuestions = options.maxQuestions ?? MAX_QUESTIONS;
+	if (!Number.isSafeInteger(maxQuestions) || maxQuestions < 1 || maxQuestions > MAX_QUESTIONS) throw new DecisionError("bad_request", "invalid decision model question limit", { provider });
+	const { model, method } = options;
+	const modelId = options.modelId.trim();
+	const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+	const onAnswered = options.onAnswered;
+	return {
+		id: provider,
+		model: modelId,
+		async decide(request) {
+			const started = performance.now();
+			return withDecisionDeadline(provider, request.timeoutMs ?? timeoutMs, request.signal, async (signal, waitFor) => {
+				let entries;
+				let input;
+				try {
+					entries = questionsForChat(request.questions, provider, maxQuestions);
+					input = DECISION_PROMPT_PREFIX + JSON.stringify({
+						state: request.state,
+						questions: Object.fromEntries(entries)
+					});
+				} catch (error) {
+					if (error instanceof DecisionError) throw error;
+					throw new DecisionError("bad_request", "invalid decision model request", { provider });
+				}
+				let structured;
+				try {
+					const adapter = model._llmType();
+					if (adapter !== "openai" && (adapter !== "anthropic" || method !== "functionCalling")) throw new Error("unverified strict decision model adapter");
+					structured = model.withStructuredOutput(decisionSchema(entries), {
+						name: "DecideQuestions",
+						method,
+						strict: true,
+						includeRaw: true
+					});
+				} catch {
+					throw new DecisionError("unsupported_mode", "model cannot enforce the requested strict mode", { provider });
+				}
+				await waitFor(Promise.resolve());
+				let output;
+				try {
+					output = await waitFor(structured.invoke([new SystemMessage("Classify the state using the questions. Return only the required decisions. Do not estimate probabilities, confidence, or token usage."), new HumanMessage(input)], { signal }));
+				} catch (error) {
+					if (error instanceof DecisionError) throw error;
+					throw providerFailure(error, provider);
+				}
+				const result = {
+					model: modelId,
+					answers: readDecisions(output.parsed, entries, provider),
+					usage: readChatUsage(output.raw)
+				};
+				await waitFor(Promise.resolve());
+				try {
+					onAnswered?.(request.label ?? "decide", performance.now() - started);
+				} catch {}
+				return result;
+			});
+		}
+	};
+}
+//#endregion
+export { createStructuredChatDecisionModel };
+
+//# sourceMappingURL=structuredChat.mjs.map

package/dist/esm/decisions/structuredChat.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"structuredChat.mjs","names":[],"sources":["../../../src/decisions/structuredChat.ts"],"mappings":"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"}

package/dist/esm/decisions/traceMarker.mjs

@@ -0,0 +1,6 @@
+//#region src/decisions/traceMarker.ts
+const DECISION_PROMPT_PREFIX = "librechat-decision-state:";
+//#endregion
+export { DECISION_PROMPT_PREFIX };
+
+//# sourceMappingURL=traceMarker.mjs.map

package/dist/esm/decisions/traceMarker.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceMarker.mjs","names":[],"sources":["../../../src/decisions/traceMarker.ts"],"mappings":";AACA,MAAa,yBAAyB"}

package/dist/esm/decisions/transport.mjs

@@ -0,0 +1,164 @@
+import { DecisionError } from "./types.mjs";
+import { withDecisionDeadline } from "./deadline.mjs";
+//#region src/decisions/transport.ts
+const DEFAULT_TIMEOUT_MS = 4e3;
+const DEFAULT_MAX_RETRIES = 2;
+const MAX_RESPONSE_BYTES = 256 * 1024;
+const BACKOFF_MS = [
+	250,
+	750,
+	1500,
+	3e3,
+	6e3
+];
+const MAX_RETRY_AFTER_MS = 1e4;
+function failureForStatus(status) {
+	if (status === 401 || status === 403) return "unauthorized";
+	if (status === 429) return "rate_limited";
+	if (status >= 500) return "server_error";
+	return "bad_request";
+}
+function retryAfterMs(header) {
+	if (header == null || header === "") return;
+	const seconds = Number(header);
+	if (Number.isFinite(seconds) && seconds >= 0) return Math.min(seconds * 1e3, MAX_RETRY_AFTER_MS);
+	const at = Date.parse(header);
+	return Number.isFinite(at) ? Math.min(Math.max(at - Date.now(), 0), MAX_RETRY_AFTER_MS) : void 0;
+}
+function defaultSleep(ms, signal) {
+	if (signal?.aborted === true) return Promise.resolve();
+	return new Promise((resolve) => {
+		const done = () => {
+			clearTimeout(timer);
+			signal?.removeEventListener("abort", done);
+			resolve();
+		};
+		const timer = setTimeout(done, ms);
+		signal?.addEventListener("abort", done, { once: true });
+	});
+}
+async function readResponse(body, waitFor, provider) {
+	if (!body) return "";
+	const reader = body.getReader();
+	const decoder = new TextDecoder();
+	let bytes = 0;
+	let text = "";
+	try {
+		for (;;) {
+			const chunk = await waitFor(reader.read());
+			if (chunk.done) return text + decoder.decode();
+			bytes += chunk.value.byteLength;
+			if (bytes > MAX_RESPONSE_BYTES) throw new DecisionError("malformed_response", "decision model response too large", { provider });
+			text += decoder.decode(chunk.value, { stream: true });
+		}
+	} catch (error) {
+		reader.cancel().catch(() => {});
+		throw error;
+	} finally {
+		try {
+			reader.releaseLock();
+		} catch {}
+	}
+}
+function createTransport(options) {
+	const { providerId } = options;
+	const credential = options.apiKey;
+	if (options.requiresAuth !== false && (credential == null || typeof credential === "string" && credential.trim() === "")) throw new DecisionError("unauthorized", "decision model requires an API key", { provider: providerId });
+	const endpoint = options.endpoint.trim();
+	if (!endpoint) throw new DecisionError("bad_request", "decision model requires an endpoint", { provider: providerId });
+	const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+	const maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+	const sleep = options.sleep ?? defaultSleep;
+	const onAnswered = options.onAnswered;
+	if (!Number.isSafeInteger(maxRetries) || maxRetries < 0 || maxRetries > 5) throw new DecisionError("bad_request", "invalid decision model retry limit", { provider: providerId });
+	const fetchImpl = options.fetch ?? globalThis.fetch;
+	if (typeof fetchImpl !== "function") throw new DecisionError("network", "no fetch implementation available", { provider: providerId });
+	async function resolveKey(refresh, signal) {
+		if (typeof credential === "string") return credential.trim() || null;
+		if (!credential) return null;
+		const minted = await credential({
+			refresh,
+			signal
+		});
+		const token = typeof minted === "string" ? minted.trim() : "";
+		if (!token) throw new DecisionError("unauthorized", "credential function returned no token", { provider: providerId });
+		return token;
+	}
+	return async function send(prepare, callerSignal, label, timeoutOverrideMs) {
+		const started = performance.now();
+		return withDecisionDeadline(providerId, timeoutOverrideMs ?? timeoutMs, callerSignal, async (signal, waitFor) => {
+			let prepared;
+			try {
+				prepared = prepare();
+			} catch (error) {
+				if (error instanceof DecisionError) throw error;
+				throw new DecisionError("bad_request", "invalid decision model request", { provider: providerId });
+			}
+			const { payload, parse } = prepared;
+			await waitFor(Promise.resolve());
+			const wasAborted = () => signal.aborted;
+			const interrupted = () => new DecisionError(callerSignal?.aborted === true ? "aborted" : "timeout", "decision model request interrupted", { provider: providerId });
+			let refreshed = false;
+			let key;
+			let lastError;
+			for (let attemptNo = 0; attemptNo <= maxRetries; attemptNo++) {
+				if (wasAborted()) throw interrupted();
+				try {
+					if (key === void 0) key = await waitFor(resolveKey(refreshed, signal));
+					const response = await waitFor(fetchImpl(endpoint, {
+						method: "POST",
+						headers: {
+							...key !== null ? { Authorization: `Bearer ${key}` } : {},
+							"Content-Type": "application/json"
+						},
+						body: payload,
+						signal,
+						redirect: "error"
+					}));
+					if (!response.ok) {
+						response.body?.cancel().catch(() => {});
+						const error = new DecisionError(failureForStatus(response.status), `decision model returned HTTP ${response.status}`, {
+							provider: providerId,
+							status: response.status
+						});
+						error.retryAfterMs = retryAfterMs(response.headers.get("retry-after"));
+						throw error;
+					}
+					const body = await readResponse(response.body, waitFor, providerId);
+					const result = await waitFor(Promise.resolve(parse(body)));
+					try {
+						onAnswered?.(label, performance.now() - started);
+					} catch {}
+					return result;
+				} catch (error) {
+					if (wasAborted()) throw interrupted();
+					if (error instanceof DecisionError) lastError = error;
+					else lastError = new DecisionError("network", "decision model request failed", { provider: providerId });
+					if (lastError.status === 401 && typeof credential === "function" && !refreshed) {
+						refreshed = true;
+						key = void 0;
+						attemptNo -= 1;
+						continue;
+					}
+					if (attemptNo === maxRetries || ![
+						"rate_limited",
+						"server_error",
+						"network"
+					].includes(lastError.failure)) break;
+					const wait = lastError.retryAfterMs ?? BACKOFF_MS[Math.min(attemptNo, BACKOFF_MS.length - 1)];
+					try {
+						await waitFor(sleep(wait, signal));
+					} catch (error) {
+						if (error instanceof DecisionError) throw error;
+						throw new DecisionError("network", "decision model backoff failed", { provider: providerId });
+					}
+				}
+			}
+			throw lastError ?? new DecisionError("network", "decision model request failed", { provider: providerId });
+		});
+	};
+}
+//#endregion
+export { createTransport, failureForStatus, retryAfterMs };
+
+//# sourceMappingURL=transport.mjs.map

package/dist/esm/decisions/transport.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.mjs","names":[],"sources":["../../../src/decisions/transport.ts"],"mappings":"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"}

package/dist/esm/decisions/types.mjs

@@ -0,0 +1,39 @@
+//#region src/decisions/types.ts
+var DecisionError = class extends Error {
+	failure;
+	provider;
+	status;
+	retryAfterMs;
+	constructor(failure, message, options) {
+		super(message);
+		this.name = "DecisionError";
+		this.failure = failure;
+		this.provider = options?.provider ?? "unknown";
+		this.status = options?.status;
+	}
+};
+function isDecisionObject(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function readDecisionUsage(raw) {
+	if (!isDecisionObject(raw)) return null;
+	const input = raw.input_tokens;
+	const output = raw.output_tokens;
+	const usage = {};
+	if (typeof input === "number" && Number.isSafeInteger(input) && input >= 0) usage.inputTokens = input;
+	if (typeof output === "number" && Number.isSafeInteger(output) && output >= 0) usage.outputTokens = output;
+	return Object.keys(usage).length > 0 ? usage : null;
+}
+function isBooleanAnswer(answer) {
+	return answer?.type === "boolean";
+}
+function isChoiceAnswer(answer) {
+	return answer?.type === "choice";
+}
+function isScoreAnswer(answer) {
+	return answer?.type === "score";
+}
+//#endregion
+export { DecisionError, isBooleanAnswer, isChoiceAnswer, isDecisionObject, isScoreAnswer, readDecisionUsage };
+
+//# sourceMappingURL=types.mjs.map

package/dist/esm/decisions/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","names":[],"sources":["../../../src/decisions/types.ts"],"mappings":";AAkIA,IAAa,gBAAb,cAAmC,MAAM;CACvC;CACA;CACA;CACA;CAEA,YACE,SACA,SACA,SACA;EACA,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,KAAK,UAAU;EACf,KAAK,WAAW,SAAS,YAAY;EACrC,KAAK,SAAS,SAAS;CACzB;AACF;AAGA,SAAgB,iBACd,OACqC;CACrC,OAAO,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAgB,kBAAkB,KAAoC;CACpE,IAAI,CAAC,iBAAiB,GAAG,GACvB,OAAO;CAET,MAAM,QAAQ,IAAI;CAClB,MAAM,SAAS,IAAI;CACnB,MAAM,QAAuB,CAAC;CAC9B,IAAI,OAAO,UAAU,YAAY,OAAO,cAAc,KAAK,KAAK,SAAS,GACvE,MAAM,cAAc;CAEtB,IACE,OAAO,WAAW,YAClB,OAAO,cAAc,MAAM,KAC3B,UAAU,GAEV,MAAM,eAAe;CAEvB,OAAO,OAAO,KAAK,KAAK,CAAC,CAAC,SAAS,IAAI,QAAQ;AACjD;AAEA,SAAgB,gBACd,QACyB;CACzB,OAAO,QAAQ,SAAS;AAC1B;AAEA,SAAgB,eACd,QACwB;CACxB,OAAO,QAAQ,SAAS;AAC1B;AAEA,SAAgB,cACd,QACuB;CACvB,OAAO,QAAQ,SAAS;AAC1B"}

package/dist/esm/graphs/Graph.mjs

@@ -558,6 +558,7 @@ var StandardGraph = class StandardGraph extends Graph {
 	subagentTasks;
 	subagentExecutionContext;
 	subagentContext;
+	onSubagentResolutionFailure;
 	preemption;
 	streamLimits;
 	streamedToolCallArgTallies = /* @__PURE__ */ new Map();
@@ -585,7 +586,7 @@ var StandardGraph = class StandardGraph extends Graph {
 	preemptHaltReason;
 	pendingPreemptReturn = /* @__PURE__ */ new Set();
 	preemptRestartPending = /* @__PURE__ */ new Set();
-	constructor({ runId, signal, agents, langfuse, tokenCounter, indexTokenCountMap, calibrationRatio, fadingTier, fadingTiers, subagentUsageSink, subagentTasks, subagentScope, subagentExecutionContext, subagentContext, preemption, streamLimits, toolExecution, clientDelegatedToolNames }, dependencies) {
+	constructor({ runId, signal, agents, langfuse, tokenCounter, indexTokenCountMap, calibrationRatio, fadingTier, fadingTiers, subagentUsageSink, subagentTasks, subagentScope, subagentExecutionContext, subagentContext, onSubagentResolutionFailure, preemption, streamLimits, toolExecution, clientDelegatedToolNames }, dependencies) {
 		super();
 		this.supportsMultiAgentChildren = dependencies != null;
 		this.graphFactory = dependencies?.graphFactory ?? ((request) => {
@@ -601,6 +602,7 @@ var StandardGraph = class StandardGraph extends Graph {
 		this.subagentScope = subagentScope === true;
 		this.subagentExecutionContext = subagentExecutionContext;
 		this.subagentContext = subagentContext;
+		this.onSubagentResolutionFailure = onSubagentResolutionFailure;
 		this.preemption = preemption;
 		this.streamLimits = resolveStreamLimits(streamLimits);
 		this.toolExecution = toolExecution;
@@ -2235,6 +2237,7 @@ var StandardGraph = class StandardGraph extends Graph {
 					usageSink: this.subagentUsageSink,
 					taskConfig: this.subagentTasks,
 					subagentContext: this.subagentContext,
+					onResolutionFailure: this.onSubagentResolutionFailure,
 					streamLimits: this.streamLimits,
 					humanInTheLoop: this.humanInTheLoop,
 					checkpointer: this.compileOptions?.checkpointer,