@librechat/agents 3.3.8 → 3.3.9

package/dist/cjs/graphs/Graph.cjs

@@ -1,15 +1,14 @@
 const require_langfuseConfig = require("../langfuseConfig.cjs");
 const require_langfuseRuntimeScope = require("../langfuseRuntimeScope.cjs");
 const require_langfuse = require("../langfuse.cjs");
-const require_langfuseToolOutputTracing = require("../langfuseToolOutputTracing.cjs");
-const require_callbacks = require("../utils/callbacks.cjs");
 const require_constants = require("../common/constants.cjs");
 const require_enum = require("../common/enum.cjs");
 require("../common/index.cjs");
+const require_langfuseToolOutputTracing = require("../langfuseToolOutputTracing.cjs");
+const require_callbacks = require("../utils/callbacks.cjs");
 const require_truncation = require("../utils/truncation.cjs");
 const require_toolContent = require("../utils/toolContent.cjs");
 const require_tokens = require("../utils/tokens.cjs");
-const require_preempt = require("../llm/preempt.cjs");
 const require_instrumentation = require("../instrumentation.cjs");
 const require_cache = require("../messages/cache.cjs");
 const require_core = require("../messages/core.cjs");
@@ -27,14 +26,15 @@ 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_handlers = require("../tools/handlers.cjs");
 const require_toolOutputReferences = require("../tools/toolOutputReferences.cjs");
+const require_toolCache = require("../llm/bedrock/toolCache.cjs");
+const require_preempt = require("../llm/preempt.cjs");
+const require_handlers = require("../tools/handlers.cjs");
+const require_llm = require("../utils/llm.cjs");
+const require_graph = require("../utils/graph.cjs");
 const require_events$1 = require("../events.cjs");
 const require_run = require("../utils/run.cjs");
 require("../utils/index.cjs");
-const require_toolCache = require("../llm/bedrock/toolCache.cjs");
 const require_init = require("../llm/init.cjs");
 const require_invoke = require("../llm/invoke.cjs");
 const require_contextOverflowRecovery = require("../llm/contextOverflowRecovery.cjs");
@@ -56,12 +56,12 @@ const require_node = require("../summarization/node.cjs");
 const require_schema = require("../tools/schema.cjs");
 const require_AgentContext = require("../agents/AgentContext.cjs");
 const require_fake = require("../llm/fake.cjs");
+let nanoid = require("nanoid");
 let _langchain_core_messages = require("@langchain/core/messages");
 let _langchain_langgraph = require("@langchain/langgraph");
 let _langchain_core_tools = require("@langchain/core/tools");
-let nanoid = require("nanoid");
-let _langchain_core_errors = require("@langchain/core/errors");
 let uuid = require("uuid");
+let _langchain_core_errors = require("@langchain/core/errors");
 //#region src/graphs/Graph.ts
 const { AGENT, TOOLS, SUMMARIZE } = require_enum.GraphNodeKeys;
 const EMPTY_PREEMPT_BOUNDARY = {
@@ -354,6 +354,15 @@ var Graph = class {
 	eagerEventToolUsageCountsByAgentId = /* @__PURE__ */ new Map();
 	eagerEventToolCallChunks = /* @__PURE__ */ new Map();
 	/**
+	* Per-run eager prestart circuit breaker, shared by reference with every
+	* ToolNode this graph compiles. When a prestarted execution's args turn
+	* out to differ from the final request, ToolNode records the tool name
+	* here and the stream handler stops prestarting that tool for the rest of
+	* the run — the retry then executes normally instead of re-diverging in a
+	* loop (LibreChat#14371).
+	*/
+	eagerEventToolSuppressions = /* @__PURE__ */ new Set();
+	/**
 	* Run-scoped execution backend for built-in code tools. Defaults to the
 	* remote Code API sandbox when unset.
 	*/
@@ -401,6 +410,7 @@ var Graph = class {
 		this.eagerEventToolExecutions.clear();
 		this.clearEagerEventToolUsageCounts();
 		this.eagerEventToolCallChunks.clear();
+		this.eagerEventToolSuppressions.clear();
 		this.toolExecution = void 0;
 		this.handlerDispatchedEventCounts.clear();
 		/**
@@ -525,6 +535,16 @@ var StandardGraph = class StandardGraph extends Graph {
 	originalToolContentCheckpointScope;
 	runId;
 	/**
+	* Identity used to stamp Langfuse runtime scopes and handlers (see
+	* `LangfuseRuntimeContext.runId`). Carries an opaque per-instance
+	* component: public run ids are unrestricted and may repeat across
+	* concurrently executing runs (retries, duplicate submissions,
+	* tenant-local message ids), and equal stamps would let those runs adopt
+	* each other's scopes. One graph instance = one execution's stamp, shared
+	* by the stream handler and every graph-level scope of that execution.
+	*/
+	langfuseScopeRunId;
+	/**
 	* Boundary between historical messages (loaded from conversation state)
 	* and messages produced during the current run.  Set once in the state
 	* reducer when messages first arrive.  Used by `getRunMessages()` and
@@ -596,6 +616,7 @@ var StandardGraph = class StandardGraph extends Graph {
 	constructor({ runId, signal, agents, langfuse, tokenCounter, indexTokenCountMap, calibrationRatio, subagentUsageSink, subagentScope, preemption }) {
 		super();
 		this.runId = runId;
+		this.langfuseScopeRunId = `${runId ?? "graph"}:${(0, nanoid.nanoid)()}`;
 		this.signal = signal;
 		this.langfuse = langfuse;
 		this.subagentUsageSink = subagentUsageSink;
@@ -629,6 +650,7 @@ var StandardGraph = class StandardGraph extends Graph {
 		this.eagerEventToolExecutions.clear();
 		this.clearEagerEventToolUsageCounts();
 		this.eagerEventToolCallChunks.clear();
+		this.eagerEventToolSuppressions.clear();
 		this.handlerDispatchedStepIds = require_graph.resetIfNotEmpty(this.handlerDispatchedStepIds, /* @__PURE__ */ new Set());
 		this.handlerDispatchedEventCounts = require_graph.resetIfNotEmpty(this.handlerDispatchedEventCounts, /* @__PURE__ */ new Map());
 		this.messageIdsByStepKey = require_graph.resetIfNotEmpty(this.messageIdsByStepKey, /* @__PURE__ */ new Map());
@@ -930,6 +952,7 @@ var StandardGraph = class StandardGraph extends Graph {
 				codeSessionToolNames: this.codeSessionToolNames,
 				eagerEventToolExecutions: this.eagerEventToolExecutions,
 				eagerEventToolUsageCount: this.getEagerEventToolUsageCount(agentContext?.agentId),
+				eagerEventToolSuppressions: this.eagerEventToolSuppressions,
 				toolExecution: this.toolExecution,
 				directToolNames: directToolNames.size > 0 ? directToolNames : void 0,
 				interruptingToolNames: this.interruptingToolNames != null && this.interruptingToolNames.length > 0 ? new Set(this.interruptingToolNames) : void 0,
@@ -1630,7 +1653,12 @@ var StandardGraph = class StandardGraph extends Graph {
 				...config,
 				metadata: {
 					...config.metadata ?? {},
-					...traceMetadata
+					...traceMetadata,
+					/** Canonical agent identity, stamped OUTSIDE trace-metadata
+					*  filtering: `createLangfuseTraceMetadata` drops values over its
+					*  length cap, but scope trust (`isForeignScope`) needs the id
+					*  verbatim regardless of length. */
+					agentId
 				}
 			};
 			require_instrumentation.initializeLangfuseTracing(langfuse);
@@ -1641,7 +1669,9 @@ var StandardGraph = class StandardGraph extends Graph {
 					sessionId: config.configurable?.thread_id,
 					traceMetadata,
 					tags: ["librechat", "agent"],
-					traceIdSeed: langfuse?.deterministicTraceId === true ? this.runId : void 0
+					traceIdSeed: langfuse?.deterministicTraceId === true ? this.runId : void 0,
+					runId: this.langfuseScopeRunId,
+					toolOutputTracing: require_langfuseConfig.hasToolOutputTracingConfig(this.langfuse, agentContext.langfuse) ? require_langfuseConfig.resolveToolOutputTracingConfig(this.langfuse, agentContext.langfuse) : void 0
 				});
 				if (langfuseHandler != null) invokeConfig = {
 					...invokeConfig,
@@ -1653,7 +1683,9 @@ var StandardGraph = class StandardGraph extends Graph {
 				if (preInvokeContextOverflowError != null) throw preInvokeContextOverflowError;
 				result = await require_langfuseRuntimeScope.withLangfuseRuntimeScope(require_langfuseRuntimeScope.resolveLangfuseRuntimeScope({
 					runLangfuse: this.langfuse,
-					langfuseOverlay: agentContext.langfuse
+					langfuseOverlay: agentContext.langfuse,
+					runId: this.langfuseScopeRunId,
+					agentId
 				}), () => require_invoke.attemptInvoke({
 					model: this.overrideModel ?? model,
 					messages: finalMessages,
@@ -1746,7 +1778,9 @@ var StandardGraph = class StandardGraph extends Graph {
 				try {
 					result = await require_langfuseRuntimeScope.withLangfuseRuntimeScope(require_langfuseRuntimeScope.resolveLangfuseRuntimeScope({
 						runLangfuse: this.langfuse,
-						langfuseOverlay: agentContext.langfuse
+						langfuseOverlay: agentContext.langfuse,
+						runId: this.langfuseScopeRunId,
+						agentId
 					}), () => require_invoke.tryFallbackProviders({
 						fallbacks,
 						tools: agentContext.tools,