@librechat/agents 3.4.0 → 3.4.2

package/dist/cjs/main.cjs

@@ -22,27 +22,37 @@ const require_handoffCue = require("./messages/handoffCue.cjs");
 const require_reducer = require("./messages/reducer.cjs");
 const require_recency = require("./messages/recency.cjs");
 require("./messages/index.cjs");
+const require_graph = require("./utils/graph.cjs");
+const require_llm = require("./utils/llm.cjs");
+const require_proxy = require("./utils/proxy.cjs");
 const require_handlers = require("./tools/handlers.cjs");
 const require_streamLimits = require("./llm/streamLimits.cjs");
 const require_intentArg = require("./tools/intentArg.cjs");
-const require_llm = require("./utils/llm.cjs");
 const require_stream = require("./stream.cjs");
-const require_smoother = require("./llm/stream/smoother.cjs");
-const require_index$2 = require("./llm/mistral/index.cjs");
-const require_index$3 = require("./llm/openai/index.cjs");
-const require_index$4 = require("./llm/openrouter/index.cjs");
-const require_providers = require("./llm/providers.cjs");
-const require_errors = require("./utils/errors.cjs");
-const require_preempt = require("./llm/preempt.cjs");
-const require_graph = require("./utils/graph.cjs");
-const require_proxy = require("./utils/proxy.cjs");
 const require_events = require("./events.cjs");
 const require_handlers$1 = require("./utils/handlers.cjs");
 const require_run = require("./utils/run.cjs");
 const require_schema = require("./utils/schema.cjs");
+const require_errors = require("./utils/errors.cjs");
 require("./utils/index.cjs");
+const require_smoother = require("./llm/stream/smoother.cjs");
+const require_index$3 = require("./llm/mistral/index.cjs");
+const require_index$4 = require("./llm/openai/index.cjs");
+const require_index$5 = require("./llm/openrouter/index.cjs");
+const require_providers = require("./llm/providers.cjs");
+const require_preempt = require("./llm/preempt.cjs");
 const require_init = require("./llm/init.cjs");
 const require_invoke = require("./llm/invoke.cjs");
+const require_HookRegistry = require("./hooks/HookRegistry.cjs");
+const require_matchers = require("./hooks/matchers.cjs");
+const require_executeHooks = require("./hooks/executeHooks.cjs");
+const require_createToolPolicyHook = require("./hooks/createToolPolicyHook.cjs");
+const require_createWorkspacePolicyHook = require("./hooks/createWorkspacePolicyHook.cjs");
+const require_types = require("./hooks/types.cjs");
+const require_index$6 = require("./hooks/index.cjs");
+const require_childGraphConfig = require("./tools/subagent/childGraphConfig.cjs");
+const require_SubagentExecutor = require("./tools/subagent/SubagentExecutor.cjs");
+require("./tools/subagent/index.cjs");
 const require_bashAst = require("./tools/local/bashAst.cjs");
 const require_LocalExecutionEngine = require("./tools/local/LocalExecutionEngine.cjs");
 const require_CompileCheckTool = require("./tools/local/CompileCheckTool.cjs");
@@ -51,13 +61,6 @@ const require_CodeSessionFileSummary = require("./tools/CodeSessionFileSummary.c
 const require_CodeExecutor = require("./tools/CodeExecutor.cjs");
 const require_ProgrammaticToolCalling = require("./tools/ProgrammaticToolCalling.cjs");
 const require_BashProgrammaticToolCalling = require("./tools/BashProgrammaticToolCalling.cjs");
-const require_HookRegistry = require("./hooks/HookRegistry.cjs");
-const require_matchers = require("./hooks/matchers.cjs");
-const require_executeHooks = require("./hooks/executeHooks.cjs");
-const require_createToolPolicyHook = require("./hooks/createToolPolicyHook.cjs");
-const require_createWorkspacePolicyHook = require("./hooks/createWorkspacePolicyHook.cjs");
-const require_types = require("./hooks/types.cjs");
-const require_index$6 = require("./hooks/index.cjs");
 const require_LocalProgrammaticToolCalling = require("./tools/local/LocalProgrammaticToolCalling.cjs");
 const require_BashExecutor = require("./tools/BashExecutor.cjs");
 const require_LocalExecutionTools = require("./tools/local/LocalExecutionTools.cjs");
@@ -74,8 +77,6 @@ require("./tools/cloudflare/index.cjs");
 const require_resolveLocalExecutionTools = require("./tools/local/resolveLocalExecutionTools.cjs");
 require("./tools/local/index.cjs");
 const require_ToolNode = require("./tools/ToolNode.cjs");
-const require_SubagentExecutor = require("./tools/subagent/SubagentExecutor.cjs");
-require("./tools/subagent/index.cjs");
 const require_SubagentTool = require("./tools/SubagentTool.cjs");
 const require_index$10 = require("./summarization/index.cjs");
 const require_request = require("./llm/request.cjs");
@@ -83,6 +84,7 @@ const require_schema$1 = require("./tools/schema.cjs");
 const require_fake = require("./llm/fake.cjs");
 const require_Graph = require("./graphs/Graph.cjs");
 const require_MultiAgentGraph = require("./graphs/MultiAgentGraph.cjs");
+const require_createGraph = require("./graphs/createGraph.cjs");
 const require_run$1 = require("./run.cjs");
 require("./graphs/index.cjs");
 const require_projection = require("./agents/projection.cjs");
@@ -167,7 +169,7 @@ exports.CalculatorToolDescription = require_Calculator.CalculatorToolDescription
 exports.CalculatorToolName = require_Calculator.CalculatorToolName;
 exports.Callback = require_enum.Callback;
 exports.ChatModelStreamHandler = require_stream.ChatModelStreamHandler;
-exports.ChatOpenRouter = require_index$4.ChatOpenRouter;
+exports.ChatOpenRouter = require_index$5.ChatOpenRouter;
 exports.CloudflareBashExecutionToolDescription = require_CloudflareSandboxTools.CloudflareBashExecutionToolDescription;
 exports.CloudflareCodeExecutionToolDescription = require_CloudflareSandboxTools.CloudflareCodeExecutionToolDescription;
 exports.CodeApiRequestError = require_CodeExecutor.CodeApiRequestError;
@@ -185,8 +187,8 @@ exports.CommonEvents = require_enum.CommonEvents;
 exports.CompileCheckToolName = require_CompileCheckTool.CompileCheckToolName;
 exports.Constants = require_enum.Constants;
 exports.ContentTypes = require_enum.ContentTypes;
-exports.CustomChatMistralAI = require_index$2.CustomChatMistralAI;
-exports.CustomOpenAIClient = require_index$3.CustomOpenAIClient;
+exports.CustomChatMistralAI = require_index$3.CustomChatMistralAI;
+exports.CustomOpenAIClient = require_index$4.CustomOpenAIClient;
 exports.DATE_RANGE = require_schema$2.DATE_RANGE;
 exports.DEFAULT_CONTEXT_PRUNING_SETTINGS = require_contextPruningSettings.DEFAULT_CONTEXT_PRUNING_SETTINGS;
 exports.DEFAULT_COUNTRY_DESCRIPTION = require_schema$2.DEFAULT_COUNTRY_DESCRIPTION;
@@ -199,6 +201,7 @@ exports.DEFAULT_RECURSION_LIMIT = require_constants.DEFAULT_RECURSION_LIMIT;
 exports.DEFAULT_RESERVE_RATIO = require_prune.DEFAULT_RESERVE_RATIO;
 exports.DEFAULT_RETAIN_RECENT_TURNS = require_recency.DEFAULT_RETAIN_RECENT_TURNS;
 exports.DEFAULT_STREAM_DELAY = require_smoother.DEFAULT_STREAM_DELAY;
+exports.DEFAULT_SUBAGENT_DESCRIPTION = require_SubagentExecutor.DEFAULT_SUBAGENT_DESCRIPTION;
 exports.DEFAULT_TOOL_TOKEN_MULTIPLIER = require_constants.DEFAULT_TOOL_TOKEN_MULTIPLIER;
 Object.defineProperty(exports, "DynamicStructuredTool", {
 	enumerable: true,
@@ -338,6 +341,7 @@ Object.defineProperty(exports, "SystemMessage", {
 	}
 });
 exports.TMP_SCRATCH_OUTPUT_REMINDER = require_CodeExecutor.TMP_SCRATCH_OUTPUT_REMINDER;
+exports.TOOL_APPROVAL_EXECUTION_SCOPE_CONFIG_KEY = require_types.TOOL_APPROVAL_EXECUTION_SCOPE_CONFIG_KEY;
 exports.TestChatStreamHandler = require_events.TestChatStreamHandler;
 exports.TestLLMStreamHandler = require_events.TestLLMStreamHandler;
 exports.TitleMethod = require_enum.TitleMethod;
@@ -392,7 +396,7 @@ exports.buildAnthropicCacheControl = require_cache.buildAnthropicCacheControl;
 exports.buildBashExecutionToolDescription = require_BashExecutor.buildBashExecutionToolDescription;
 exports.buildBashExecutionToolSchema = require_BashExecutor.buildBashExecutionToolSchema;
 exports.buildBedrockCachePoint = require_cache.buildBedrockCachePoint;
-exports.buildChildInputs = require_SubagentExecutor.buildChildInputs;
+exports.buildChildInputs = require_childGraphConfig.buildChildInputs;
 exports.buildCodeApiExecutionErrorMessage = require_CodeExecutor.buildCodeApiExecutionErrorMessage;
 exports.buildCodeApiHttpErrorMessage = require_CodeExecutor.buildCodeApiHttpErrorMessage;
 exports.buildCodeExecutionToolDescription = require_CodeExecutor.buildCodeExecutionToolDescription;
@@ -437,6 +441,7 @@ exports.createCompileCheckTool = require_CompileCheckTool.createCompileCheckTool
 exports.createCompileCheckToolDefinition = require_CompileCheckTool.createCompileCheckToolDefinition;
 exports.createContentAggregator = require_stream.createContentAggregator;
 exports.createFakeStreamingLLM = require_fake.createFakeStreamingLLM;
+exports.createGraph = require_createGraph.createGraph;
 exports.createHandlers = require_handlers$1.createHandlers;
 exports.createLocalBashExecutionTool = require_LocalExecutionTools.createLocalBashExecutionTool;
 exports.createLocalBashProgrammaticToolCallingTool = require_LocalProgrammaticToolCalling.createLocalBashProgrammaticToolCallingTool;
@@ -502,6 +507,7 @@ exports.extractUsedBashToolNames = require_BashProgrammaticToolCalling.extractUs
 exports.extractUsedToolNames = require_ProgrammaticToolCalling.extractUsedToolNames;
 exports.fetchSessionFiles = require_ProgrammaticToolCalling.fetchSessionFiles;
 exports.filterBashToolsByUsage = require_BashProgrammaticToolCalling.filterBashToolsByUsage;
+exports.filterGraphSubagentResult = require_SubagentExecutor.filterGraphSubagentResult;
 exports.filterSubagentResult = require_SubagentExecutor.filterSubagentResult;
 exports.filterToolsByUsage = require_ProgrammaticToolCalling.filterToolsByUsage;
 exports.findLastIndex = require_core.findLastIndex;
@@ -579,6 +585,7 @@ exports.isDangerousPattern = require_ToolSearch.isDangerousPattern;
 exports.isFromAnyMcpServer = require_ToolSearch.isFromAnyMcpServer;
 exports.isFromMcpServer = require_ToolSearch.isFromMcpServer;
 exports.isGoogleLike = require_llm.isGoogleLike;
+exports.isGraphSubagentConfig = require_childGraphConfig.isGraphSubagentConfig;
 exports.isIntentLabelProperty = require_intentArg.isIntentLabelProperty;
 Object.defineProperty(exports, "isInterrupted", {
 	enumerable: true,
@@ -612,6 +619,8 @@ exports.newsSchema = require_schema$2.newsSchema;
 exports.normalizeBashToolResultsForReplay = require_BashProgrammaticToolCalling.normalizeBashToolResultsForReplay;
 exports.normalizeCodeApiRequestError = require_CodeExecutor.normalizeCodeApiRequestError;
 exports.normalizeServerFilter = require_ToolSearch.normalizeServerFilter;
+exports.normalizeSubagentConfigEntries = require_childGraphConfig.normalizeSubagentConfigEntries;
+exports.normalizeSubagentConfigs = require_childGraphConfig.normalizeSubagentConfigs;
 exports.normalizeToBashIdentifier = require_BashProgrammaticToolCalling.normalizeToBashIdentifier;
 exports.normalizeToPythonIdentifier = require_ProgrammaticToolCalling.normalizeToPythonIdentifier;
 exports.outcomeFieldsFromResult = require_intentArg.outcomeFieldsFromResult;
@@ -652,7 +661,8 @@ exports.resolvePromptCacheTtl = require_cache.resolvePromptCacheTtl;
 exports.resolveSearchOutcome = require_tool.resolveSearchOutcome;
 exports.resolveStreamDelay = require_smoother.resolveStreamDelay;
 exports.resolveStreamLimits = require_streamLimits.resolveStreamLimits;
-exports.resolveSubagentConfigs = require_SubagentExecutor.resolveSubagentConfigs;
+exports.resolveSubagentConfigEntries = require_childGraphConfig.resolveSubagentConfigEntries;
+exports.resolveSubagentConfigs = require_childGraphConfig.resolveSubagentConfigs;
 exports.resolveToolOutcome = require_intentArg.resolveToolOutcome;
 exports.resolveWorkspacePath = require_LocalExecutionEngine.resolveWorkspacePath;
 exports.resolveWorkspacePathSafe = require_LocalExecutionEngine.resolveWorkspacePathSafe;

package/dist/cjs/messages/format.cjs

@@ -202,6 +202,10 @@ function endsWithSteerMessage(formatted) {
 */
 function formatAssistantMessage(message, options) {
 	const formattedMessages = [];
+	const appendFormattedMessage = (formattedMessage) => {
+		stampSourceMessageIdentity(formattedMessage, options?.sourceMessageId, formattedMessages.length);
+		formattedMessages.push(formattedMessage);
+	};
 	let currentContent = [];
 	let lastAIMessage = null;
 	let hasReasoning = false;
@@ -270,7 +274,7 @@ function formatAssistantMessage(message, options) {
 					if (currentContent.some((content) => content.type !== "text")) {
 						currentContent.push(part);
 						lastAIMessage = createAIMessage(require_langchain.toLangChainContent(currentContent));
-						formattedMessages.push(lastAIMessage);
+						appendFormattedMessage(lastAIMessage);
 						currentContent = [];
 						continue;
 					}
@@ -280,12 +284,12 @@ function formatAssistantMessage(message, options) {
 					}, "");
 					content = `${content}\n${getTextContent(part)}`.trim();
 					lastAIMessage = createAIMessage(content);
-					formattedMessages.push(lastAIMessage);
+					appendFormattedMessage(lastAIMessage);
 					currentContent = [];
 					continue;
 				}
 				lastAIMessage = createAIMessage(getTextContent(part));
-				formattedMessages.push(lastAIMessage);
+				appendFormattedMessage(lastAIMessage);
 			} else if (part.type === "tool_call") {
 				if (part.tool_call == null) continue;
 				const toolCallId = getToolCallId(part);
@@ -305,7 +309,7 @@ function formatAssistantMessage(message, options) {
 				}
 				if (!lastAIMessage) {
 					lastAIMessage = createAIMessage("");
-					formattedMessages.push(lastAIMessage);
+					appendFormattedMessage(lastAIMessage);
 				} else attachPendingReasoningContent(lastAIMessage);
 				const tool_call = _tool_call;
 				let args = _args;
@@ -328,7 +332,7 @@ function formatAssistantMessage(message, options) {
 					if (!lastAIMessage.tool_calls) lastAIMessage.tool_calls = [];
 					lastAIMessage.tool_calls.push(tool_call);
 				}
-				formattedMessages.push(withMessageRole(new _langchain_core_messages.ToolMessage({
+				appendFormattedMessage(withMessageRole(new _langchain_core_messages.ToolMessage({
 					tool_call_id: tool_call.id ?? "",
 					name: tool_call.name,
 					content: formatToolCallOutput(output)
@@ -341,12 +345,12 @@ function formatAssistantMessage(message, options) {
 				if (currentContent.length > 0) {
 					if (currentContent.some((content) => content.type !== "text")) {
 						lastAIMessage = createAIMessage(require_langchain.toLangChainContent(currentContent));
-						formattedMessages.push(lastAIMessage);
+						appendFormattedMessage(lastAIMessage);
 					} else {
 						const flushed = currentContent.reduce((acc, curr) => `${acc}${getTextContent(curr)}\n`, "").trim();
 						if (flushed.length > 0) {
 							lastAIMessage = createAIMessage(flushed);
-							formattedMessages.push(lastAIMessage);
+							appendFormattedMessage(lastAIMessage);
 						}
 					}
 					currentContent = [];
@@ -359,12 +363,11 @@ function formatAssistantMessage(message, options) {
 					* assistant reasoning silently vanishes on replay.
 					*/
 					lastAIMessage = createAIMessage("");
-					formattedMessages.push(lastAIMessage);
+					appendFormattedMessage(lastAIMessage);
 				}
 				const steerPart = part;
-				const steerContent = Array.isArray(steerPart.media) && steerPart.media.length > 0 ? require_langchain.toLangChainContent(steerPart.media) : steerPart.steer ?? "";
-				formattedMessages.push(withMessageRole(new _langchain_core_messages.HumanMessage({
-					content: steerContent,
+				appendFormattedMessage(withMessageRole(new _langchain_core_messages.HumanMessage({
+					content: Array.isArray(steerPart.media) && steerPart.media.length > 0 ? require_langchain.toLangChainContent(steerPart.media) : steerPart.steer ?? "",
 					additional_kwargs: {
 						role: "user",
 						source: "steer"
@@ -388,14 +391,14 @@ function formatAssistantMessage(message, options) {
 		let content = "";
 		for (const part of currentContent) {
 			if (part.type !== "text") {
-				formattedMessages.push(createAIMessage(require_langchain.toLangChainContent(currentContent)));
+				appendFormattedMessage(createAIMessage(require_langchain.toLangChainContent(currentContent)));
 				return formattedMessages;
 			}
 			content += `${getTextContent(part)}\n`;
 		}
 		content = content.trim();
-		if (content) formattedMessages.push(createAIMessage(content));
-	} else if (currentContent.length > 0) formattedMessages.push(createAIMessage(require_langchain.toLangChainContent(currentContent)));
+		if (content) appendFormattedMessage(createAIMessage(content));
+	} else if (currentContent.length > 0) appendFormattedMessage(createAIMessage(require_langchain.toLangChainContent(currentContent)));
 	return formattedMessages;
 }
 function getSourceMessageId(message) {
@@ -405,6 +408,20 @@ function getSourceMessageId(message) {
 	return normalized.length > 0 ? normalized : void 0;
 }
 /**
+* Keeps the first formatted message backward-compatible with its persisted
+* source id and preserves source correlation on every derived message.
+* Derived ids remain unset so the reducer can assign collision-free identities
+* during its existing pass. This also prevents invented provider-shaped ids
+* from leaking into provider request payloads.
+*/
+function stampSourceMessageIdentity(message, sourceMessageId, derivedIndex = 0) {
+	if (sourceMessageId == null) return;
+	message.additional_kwargs.sourceMessageId = sourceMessageId;
+	if (derivedIndex !== 0) return;
+	message.id = sourceMessageId;
+	message.lc_kwargs.id = sourceMessageId;
+}
+/**
 * Labels all agent content for parallel patterns (fan-out/fan-in)
 * Groups consecutive content by agent and wraps with clear labels
 */
@@ -748,7 +765,7 @@ const formatAgentMessages = (payload, indexTokenCountMap, tools, skills, options
 				message,
 				langChain: true
 			});
-			if (sourceMessageId != null && sourceMessageId !== "") formattedMessage.id = sourceMessageId;
+			stampSourceMessageIdentity(formattedMessage, sourceMessageId);
 			flushSteerAnchor(formattedMessage);
 			messages.push(formattedMessage);
 			indexMapping[i] = [messages.length - 1];
@@ -850,9 +867,9 @@ const formatAgentMessages = (payload, indexTokenCountMap, tools, skills, options
 		const formattedMessages = formatAssistantMessage(processedMessage, {
 			preserveUnpairedServerToolUses: i === payload.length - 1,
 			preserveReasoningContent: options?.preserveReasoningContent ?? options?.provider === "deepseek",
-			provider: options?.provider
+			provider: options?.provider,
+			sourceMessageId
 		});
-		if (sourceMessageId != null && sourceMessageId !== "") for (const formattedMessage of formattedMessages) formattedMessage.id = sourceMessageId;
 		/**
 		* A steer that ends an assistant message leaves the replay on a
 		* `HumanMessage`. The next payload message is itself a user turn, so the
@@ -876,12 +893,12 @@ const formatAgentMessages = (payload, indexTokenCountMap, tools, skills, options
 		* the model may simply never answer. So the intent is recorded and flushed
 		* only when a message actually follows.
 		*
-		* Pushed AFTER the id stamping above, deliberately. `messagesStateReducer`
-		* treats a repeated id as replace-in-place, so an anchor carrying the
-		* shared `sourceMessageId` would overwrite the steer it exists to protect.
-		* Left unstamped, it reaches the reducer with a null id and is assigned a
-		* fresh one. `endsWithSteerMessage` reads only `additional_kwargs.source`,
-		* so the deferral cannot change which messages get anchored.
+		* Pushed AFTER source identity stamping above, deliberately. The anchor is
+		* synthetic rather than derived from the persisted assistant entry, so it
+		* must not claim that entry's source metadata. Left unstamped, it reaches
+		* the reducer with a null id and is assigned a fresh one.
+		* `endsWithSteerMessage` reads only `additional_kwargs.source`, so the
+		* deferral cannot change which messages get anchored.
 		*/
 		/**
 		* Guarded on emission: an assistant entry whose blocks all filtered away