@librechat/agents 3.3.8 → 3.3.10

package/dist/esm/prompts/activityLabel.mjs

@@ -31,8 +31,8 @@ function truncateForLabel(value, maxLength) {
 * Reduces a committed label to bounded single-line data.
 *
 * Sections in this prompt are delimited by blank lines, so a label carrying
-* embedded newlines could otherwise forge an apparent `Tool calls:` or
-* `Label:` section. Unlike every other input here, previous labels re-enter
+* embedded newlines could otherwise forge an apparent entries section or
+* `Header:` cue. Unlike every other input here, previous labels re-enter
 * the prompt on EVERY later batch, so one malformed result — plain model
 * noncompliance, or injection surfacing through a tool result — would
 * persistently steer unrelated later labels rather than affecting one. The
@@ -109,17 +109,29 @@ function buildActivityLabelPrompt({ entries, charLimit, thinkingExcerpts, lastAs
 	if (entries.length > 0) {
 		const shown = entries.slice(0, MAX_PROMPT_ENTRIES);
 		const omitted = entries.length - shown.length;
-		sections.push("Tool calls:\n" + shown.map((entry) => {
-			const input = clip(serializeForLabel(entry.toolInput, charLimit), charLimit);
-			const redacted = redaction != null && shouldRedactTool(entry.toolName, redaction);
-			let outcome;
-			if (redacted) outcome = redaction.redactionText;
-			else if (entry.status === "error") outcome = `ERROR: ${clip(entry.error ?? "unknown error", charLimit)}`;
-			else outcome = clip(serializeForLabel(entry.toolOutput, charLimit), charLimit);
-			return `- ${entry.toolName}(${input}) → ${outcome}`;
-		}).join("\n") + (omitted > 0 ? `\n- …and ${omitted} more tool ${omitted === 1 ? "call" : "calls"}` : ""));
+		sections.push(
+			/** Frames the list as reference material, not the thing to
+			*  transcribe. Ported from LibreChat's fallback builder (its
+			*  runtime.ts documents that without this the model "hands back a
+			*  transcription" of the list) after the eval harness measured it
+			*  across three independent sweeps: fewer template-redundancy and
+			*  length violations than a bare `Tool calls:` heading, with no
+			*  per-case regressions (agents #360). */
+			"What it called, and what came back (do not restate these):\n" + shown.map((entry) => {
+				const input = clip(serializeForLabel(entry.toolInput, charLimit), charLimit);
+				const redacted = redaction != null && shouldRedactTool(entry.toolName, redaction);
+				let outcome;
+				if (redacted) outcome = redaction.redactionText;
+				else if (entry.status === "error") outcome = `ERROR: ${clip(entry.error ?? "unknown error", charLimit)}`;
+				else outcome = clip(serializeForLabel(entry.toolOutput, charLimit), charLimit);
+				return `- ${entry.toolName}(${input}) → ${outcome}`;
+			}).join("\n") + (omitted > 0 ? `\n- …and ${omitted} more tool ${omitted === 1 ? "call" : "calls"}` : "")
+		);
 	}
-	sections.push("Label:");
+	/** The fallback builder's terminal cue, measured alongside the heading
+	*  (same sweeps). The default system prompt already describes the
+	*  output as "the header of a collapsed activity group". */
+	sections.push("Header:");
 	return sections.join("\n\n");
 }
 //#endregion

package/dist/esm/prompts/activityLabel.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"activityLabel.mjs","names":[],"sources":["../../../src/prompts/activityLabel.ts"],"sourcesContent":["import type { ResolvedLangfuseToolOutputTracingConfig } from '@/langfuseRuntimeContext';\nimport type { ActivityLabelToolEntry } from '@/types/activityLabel';\nimport { shouldRedactTool } from '@/langfuseToolOutputTracing';\n\n/**\n * Default system prompt for fast-model activity labeling.\n *\n * Style synthesized from Claude Code's tool-use summary prompt (git-subject\n * register, past tense, distinctive nouns) and claude.ai's observed group\n * headers (5–9 words describing a mixed reasoning + tool block, e.g.\n * \"Synthesized version data and curated comparative framework\").\n */\nexport const ACTIVITY_LABEL_PROMPT = `Write a short label describing what this block of agent activity accomplished. It appears as the header of a collapsed activity group in a chat UI.\n\nRules:\n- 5 to 9 words, past-tense verb first\n- Name the most distinctive subject (file, API, topic); drop articles and filler\n- Describe outcomes, not mechanics; if something failed, say so plainly\n- Output only the label — no quotes, no punctuation at the end, no preamble\n\nExamples:\n- Searched Node.js release notes and changelogs\n- Compared runtime versions across official sources\n- Fixed failing auth middleware tests\n- Read project config and dependency manifests\n- Attempted database migration, hit permission errors`;\n\n/** Truncates a serialized value for the label prompt. */\nexport function truncateForLabel(value: string, maxLength: number): string {\n  if (value.length <= maxLength) {\n    return value;\n  }\n  return value.slice(0, Math.max(0, maxLength - 1)) + '…';\n}\n\n/**\n * Reduces a committed label to bounded single-line data.\n *\n * Sections in this prompt are delimited by blank lines, so a label carrying\n * embedded newlines could otherwise forge an apparent `Tool calls:` or\n * `Label:` section. Unlike every other input here, previous labels re-enter\n * the prompt on EVERY later batch, so one malformed result — plain model\n * noncompliance, or injection surfacing through a tool result — would\n * persistently steer unrelated later labels rather than affecting one. The\n * clip bounds the same way `lastAssistantText` and reasoning excerpts are\n * bounded: oversized headers must not inflate later requests past the fast\n * model's window and starve the run of labels entirely.\n */\nfunction sanitizePreviousLabel(label: string): string {\n  return truncateForLabel(label.replace(/\\s+/g, ' ').trim(), PREVIOUS_LABEL_LIMIT);\n}\n\nconst ABORT_SERIALIZATION = Symbol('abort-label-serialization');\n\n/**\n * Serializes a tool value for the prompt WITHOUT materializing huge JSON:\n * the output is clipped to a few hundred characters anyway, so a multi-\n * megabyte tool result must not be stringified in full on the label path.\n * Strings clip immediately; structured values serialize under a character\n * budget and degrade to a shape summary once it is exhausted.\n */\nfunction serializeForLabel(value: unknown, limit: number): string {\n  if (value == null) {\n    return '';\n  }\n  if (typeof value === 'string') {\n    return value.length > limit ? value.slice(0, limit + 1) : value;\n  }\n  let budget = limit * 4;\n  try {\n    return (\n      JSON.stringify(value, (_key, nested: unknown) => {\n        if (budget <= 0) {\n          throw ABORT_SERIALIZATION;\n        }\n        if (typeof nested === 'string') {\n          const clipped =\n            nested.length > limit ? nested.slice(0, limit) : nested;\n          budget -= clipped.length;\n          return clipped;\n        }\n        budget -= 8;\n        return nested;\n      }) ?? ''\n    );\n  } catch (error) {\n    if (error === ABORT_SERIALIZATION) {\n      return Array.isArray(value) ? `[Array(${value.length})]` : '[Object]';\n    }\n    return String(value);\n  }\n}\n\nconst INPUT_CONTEXT_LIMIT = 200;\nconst MAX_THINKING_EXCERPTS = 4;\nconst MAX_PREVIOUS_LABELS = 3;\n/** Per-label bound. A header is 5-9 words; anything past this is\n *  noncompliance or payload, and previous labels are the one input that\n *  RE-ENTERS the prompt on every later batch of the run. */\nconst PREVIOUS_LABEL_LIMIT = 200;\n/** A label is 5-9 words; no batch needs more than this many entries to\n *  produce one, and the cap keeps a 200-call programmatic batch from\n *  building an enormous prompt out of per-field-bounded pieces. */\nconst MAX_PROMPT_ENTRIES = 12;\n\nexport type BuildActivityLabelPromptParams = {\n  entries: ActivityLabelToolEntry[];\n  charLimit: number;\n  thinkingExcerpts?: string[];\n  lastAssistantText?: string;\n  /**\n   * Headers already committed for earlier batches in this run, in run order\n   * with the most recent last. Rendered ahead of the block context so the\n   * label continues the run's story instead of restating a line the user is\n   * already reading. Capped at {@link MAX_PREVIOUS_LABELS}.\n   */\n  previousLabels?: string[];\n  /**\n   * Resolved tool-output tracing policy. The label prompt becomes Langfuse\n   * generation input, so outputs/errors excluded from tracing (global\n   * disable or `redactedToolNames`) must never appear in it — the same\n   * redaction the span processor applies to structured tool observations.\n   */\n  redaction?: ResolvedLangfuseToolOutputTracingConfig;\n};\n\n/**\n * Builds the user prompt for a fast-model activity label. Pure — exported\n * for direct testing of redaction and truncation behavior.\n */\nexport function buildActivityLabelPrompt({\n  entries,\n  charLimit,\n  thinkingExcerpts,\n  lastAssistantText,\n  previousLabels,\n  redaction,\n}: BuildActivityLabelPromptParams): string {\n  const clip = truncateForLabel;\n  /** Reasoning and intent text can quote tool output verbatim — including\n   *  output from EARLIER calls to a redacted tool that this batch does not\n   *  contain — so any active policy (global disable or a configured\n   *  redacted-name list) drops both wholesale. There is no reliable way to\n   *  scrub a quoted fragment out of free-form model prose. */\n  const excerptsRedacted =\n    redaction != null &&\n    (redaction.enabled === false || redaction.redactedToolNames.size > 0);\n  const sections: string[] = [];\n  /** Previous labels are free-form model prose too, and per-agent overlays\n   *  mean an earlier header may have been generated under ANOTHER agent's\n   *  weaker policy — so they share the excerpts' wholesale drop rather than\n   *  letting a handoff leak a looser agent's phrasing into this trace. */\n  if (!excerptsRedacted && previousLabels != null && previousLabels.length > 0) {\n    const recent = previousLabels\n      .slice(-MAX_PREVIOUS_LABELS)\n      .map(sanitizePreviousLabel)\n      /** A label that sanitizes to nothing carries no story to continue;\n       *  rendering it would leave a bare bullet implying a missing header. */\n      .filter((label) => label.length > 0);\n    if (recent.length > 0) {\n      sections.push(\n        'Previous headers in this run (most recent last):\\n' +\n          recent.map((label) => `- ${label}`).join('\\n')\n      );\n    }\n  }\n  /** Intent text is free-form assistant prose that can quote a redacted\n   *  tool result just as reasoning can, so it shares the excerpts' fate. */\n  if (\n    !excerptsRedacted &&\n    lastAssistantText != null &&\n    lastAssistantText.length > 0\n  ) {\n    sections.push(\n      `Intent (assistant's last message): ${clip(lastAssistantText, INPUT_CONTEXT_LIMIT)}`\n    );\n  }\n  if (\n    !excerptsRedacted &&\n    thinkingExcerpts != null &&\n    thinkingExcerpts.length > 0\n  ) {\n    sections.push(\n      'Reasoning excerpts:\\n' +\n        thinkingExcerpts\n          .slice(0, MAX_THINKING_EXCERPTS)\n          .map((excerpt) => `- ${clip(excerpt, charLimit)}`)\n          .join('\\n')\n    );\n  }\n  if (entries.length > 0) {\n    const shown = entries.slice(0, MAX_PROMPT_ENTRIES);\n    const omitted = entries.length - shown.length;\n    sections.push(\n      'Tool calls:\\n' +\n        shown\n          .map((entry) => {\n            const input = clip(\n              serializeForLabel(entry.toolInput, charLimit),\n              charLimit\n            );\n            const redacted =\n              redaction != null && shouldRedactTool(entry.toolName, redaction);\n            let outcome: string;\n            if (redacted) {\n              outcome = redaction.redactionText;\n            } else if (entry.status === 'error') {\n              outcome = `ERROR: ${clip(entry.error ?? 'unknown error', charLimit)}`;\n            } else {\n              outcome = clip(\n                serializeForLabel(entry.toolOutput, charLimit),\n                charLimit\n              );\n            }\n            return `- ${entry.toolName}(${input}) → ${outcome}`;\n          })\n          .join('\\n') +\n        (omitted > 0\n          ? `\\n- …and ${omitted} more tool ${omitted === 1 ? 'call' : 'calls'}`\n          : '')\n    );\n  }\n  sections.push('Label:');\n  return sections.join('\\n\\n');\n}\n"],"mappings":"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"}
+{"version":3,"file":"activityLabel.mjs","names":[],"sources":["../../../src/prompts/activityLabel.ts"],"sourcesContent":["import type { ResolvedLangfuseToolOutputTracingConfig } from '@/langfuseRuntimeContext';\nimport type { ActivityLabelToolEntry } from '@/types/activityLabel';\nimport { shouldRedactTool } from '@/langfuseToolOutputTracing';\n\n/**\n * Default system prompt for fast-model activity labeling.\n *\n * Style synthesized from Claude Code's tool-use summary prompt (git-subject\n * register, past tense, distinctive nouns) and claude.ai's observed group\n * headers (5–9 words describing a mixed reasoning + tool block, e.g.\n * \"Synthesized version data and curated comparative framework\").\n */\nexport const ACTIVITY_LABEL_PROMPT = `Write a short label describing what this block of agent activity accomplished. It appears as the header of a collapsed activity group in a chat UI.\n\nRules:\n- 5 to 9 words, past-tense verb first\n- Name the most distinctive subject (file, API, topic); drop articles and filler\n- Describe outcomes, not mechanics; if something failed, say so plainly\n- Output only the label — no quotes, no punctuation at the end, no preamble\n\nExamples:\n- Searched Node.js release notes and changelogs\n- Compared runtime versions across official sources\n- Fixed failing auth middleware tests\n- Read project config and dependency manifests\n- Attempted database migration, hit permission errors`;\n\n/** Truncates a serialized value for the label prompt. */\nexport function truncateForLabel(value: string, maxLength: number): string {\n  if (value.length <= maxLength) {\n    return value;\n  }\n  return value.slice(0, Math.max(0, maxLength - 1)) + '…';\n}\n\n/**\n * Reduces a committed label to bounded single-line data.\n *\n * Sections in this prompt are delimited by blank lines, so a label carrying\n * embedded newlines could otherwise forge an apparent entries section or\n * `Header:` cue. Unlike every other input here, previous labels re-enter\n * the prompt on EVERY later batch, so one malformed result — plain model\n * noncompliance, or injection surfacing through a tool result — would\n * persistently steer unrelated later labels rather than affecting one. The\n * clip bounds the same way `lastAssistantText` and reasoning excerpts are\n * bounded: oversized headers must not inflate later requests past the fast\n * model's window and starve the run of labels entirely.\n */\nfunction sanitizePreviousLabel(label: string): string {\n  return truncateForLabel(\n    label.replace(/\\s+/g, ' ').trim(),\n    PREVIOUS_LABEL_LIMIT\n  );\n}\n\nconst ABORT_SERIALIZATION = Symbol('abort-label-serialization');\n\n/**\n * Serializes a tool value for the prompt WITHOUT materializing huge JSON:\n * the output is clipped to a few hundred characters anyway, so a multi-\n * megabyte tool result must not be stringified in full on the label path.\n * Strings clip immediately; structured values serialize under a character\n * budget and degrade to a shape summary once it is exhausted.\n */\nfunction serializeForLabel(value: unknown, limit: number): string {\n  if (value == null) {\n    return '';\n  }\n  if (typeof value === 'string') {\n    return value.length > limit ? value.slice(0, limit + 1) : value;\n  }\n  let budget = limit * 4;\n  try {\n    return (\n      JSON.stringify(value, (_key, nested: unknown) => {\n        if (budget <= 0) {\n          throw ABORT_SERIALIZATION;\n        }\n        if (typeof nested === 'string') {\n          const clipped =\n            nested.length > limit ? nested.slice(0, limit) : nested;\n          budget -= clipped.length;\n          return clipped;\n        }\n        budget -= 8;\n        return nested;\n      }) ?? ''\n    );\n  } catch (error) {\n    if (error === ABORT_SERIALIZATION) {\n      return Array.isArray(value) ? `[Array(${value.length})]` : '[Object]';\n    }\n    return String(value);\n  }\n}\n\nconst INPUT_CONTEXT_LIMIT = 200;\nconst MAX_THINKING_EXCERPTS = 4;\nconst MAX_PREVIOUS_LABELS = 3;\n/** Per-label bound. A header is 5-9 words; anything past this is\n *  noncompliance or payload, and previous labels are the one input that\n *  RE-ENTERS the prompt on every later batch of the run. */\nconst PREVIOUS_LABEL_LIMIT = 200;\n/** A label is 5-9 words; no batch needs more than this many entries to\n *  produce one, and the cap keeps a 200-call programmatic batch from\n *  building an enormous prompt out of per-field-bounded pieces. */\nconst MAX_PROMPT_ENTRIES = 12;\n\nexport type BuildActivityLabelPromptParams = {\n  entries: ActivityLabelToolEntry[];\n  charLimit: number;\n  thinkingExcerpts?: string[];\n  lastAssistantText?: string;\n  /**\n   * Headers already committed for earlier batches in this run, in run order\n   * with the most recent last. Rendered ahead of the block context so the\n   * label continues the run's story instead of restating a line the user is\n   * already reading. Capped at {@link MAX_PREVIOUS_LABELS}.\n   */\n  previousLabels?: string[];\n  /**\n   * Resolved tool-output tracing policy. The label prompt becomes Langfuse\n   * generation input, so outputs/errors excluded from tracing (global\n   * disable or `redactedToolNames`) must never appear in it — the same\n   * redaction the span processor applies to structured tool observations.\n   */\n  redaction?: ResolvedLangfuseToolOutputTracingConfig;\n};\n\n/**\n * Builds the user prompt for a fast-model activity label. Pure — exported\n * for direct testing of redaction and truncation behavior.\n */\nexport function buildActivityLabelPrompt({\n  entries,\n  charLimit,\n  thinkingExcerpts,\n  lastAssistantText,\n  previousLabels,\n  redaction,\n}: BuildActivityLabelPromptParams): string {\n  const clip = truncateForLabel;\n  /** Reasoning and intent text can quote tool output verbatim — including\n   *  output from EARLIER calls to a redacted tool that this batch does not\n   *  contain — so any active policy (global disable or a configured\n   *  redacted-name list) drops both wholesale. There is no reliable way to\n   *  scrub a quoted fragment out of free-form model prose. */\n  const excerptsRedacted =\n    redaction != null &&\n    (redaction.enabled === false || redaction.redactedToolNames.size > 0);\n  const sections: string[] = [];\n  /** Previous labels are free-form model prose too, and per-agent overlays\n   *  mean an earlier header may have been generated under ANOTHER agent's\n   *  weaker policy — so they share the excerpts' wholesale drop rather than\n   *  letting a handoff leak a looser agent's phrasing into this trace. */\n  if (\n    !excerptsRedacted &&\n    previousLabels != null &&\n    previousLabels.length > 0\n  ) {\n    const recent = previousLabels\n      .slice(-MAX_PREVIOUS_LABELS)\n      .map(sanitizePreviousLabel)\n      /** A label that sanitizes to nothing carries no story to continue;\n       *  rendering it would leave a bare bullet implying a missing header. */\n      .filter((label) => label.length > 0);\n    if (recent.length > 0) {\n      sections.push(\n        'Previous headers in this run (most recent last):\\n' +\n          recent.map((label) => `- ${label}`).join('\\n')\n      );\n    }\n  }\n  /** Intent text is free-form assistant prose that can quote a redacted\n   *  tool result just as reasoning can, so it shares the excerpts' fate. */\n  if (\n    !excerptsRedacted &&\n    lastAssistantText != null &&\n    lastAssistantText.length > 0\n  ) {\n    sections.push(\n      `Intent (assistant's last message): ${clip(lastAssistantText, INPUT_CONTEXT_LIMIT)}`\n    );\n  }\n  if (\n    !excerptsRedacted &&\n    thinkingExcerpts != null &&\n    thinkingExcerpts.length > 0\n  ) {\n    sections.push(\n      'Reasoning excerpts:\\n' +\n        thinkingExcerpts\n          .slice(0, MAX_THINKING_EXCERPTS)\n          .map((excerpt) => `- ${clip(excerpt, charLimit)}`)\n          .join('\\n')\n    );\n  }\n  if (entries.length > 0) {\n    const shown = entries.slice(0, MAX_PROMPT_ENTRIES);\n    const omitted = entries.length - shown.length;\n    sections.push(\n      /** Frames the list as reference material, not the thing to\n       *  transcribe. Ported from LibreChat's fallback builder (its\n       *  runtime.ts documents that without this the model \"hands back a\n       *  transcription\" of the list) after the eval harness measured it\n       *  across three independent sweeps: fewer template-redundancy and\n       *  length violations than a bare `Tool calls:` heading, with no\n       *  per-case regressions (agents #360). */\n      'What it called, and what came back (do not restate these):\\n' +\n        shown\n          .map((entry) => {\n            const input = clip(\n              serializeForLabel(entry.toolInput, charLimit),\n              charLimit\n            );\n            const redacted =\n              redaction != null && shouldRedactTool(entry.toolName, redaction);\n            let outcome: string;\n            if (redacted) {\n              outcome = redaction.redactionText;\n            } else if (entry.status === 'error') {\n              outcome = `ERROR: ${clip(entry.error ?? 'unknown error', charLimit)}`;\n            } else {\n              outcome = clip(\n                serializeForLabel(entry.toolOutput, charLimit),\n                charLimit\n              );\n            }\n            return `- ${entry.toolName}(${input}) → ${outcome}`;\n          })\n          .join('\\n') +\n        (omitted > 0\n          ? `\\n- …and ${omitted} more tool ${omitted === 1 ? 'call' : 'calls'}`\n          : '')\n    );\n  }\n  /** The fallback builder's terminal cue, measured alongside the heading\n   *  (same sweeps). The default system prompt already describes the\n   *  output as \"the header of a collapsed activity group\". */\n  sections.push('Header:');\n  return sections.join('\\n\\n');\n}\n"],"mappings":"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"}

package/dist/esm/run.mjs

@@ -2,15 +2,15 @@ import { getTraceIdSeed } from "./langfuseRuntimeContext.mjs";
 import { hasToolOutputTracingConfig, resolveLangfuseConfig, resolveToolOutputTracingConfig } from "./langfuseConfig.mjs";
 import { resolveLangfuseRuntimeScope, withLangfuseRuntimeScope } from "./langfuseRuntimeScope.mjs";
 import { createLangfuseHandler, createLangfuseTraceMetadata, disposeLangfuseHandler, getLangfuseTraceName, isLangfuseCallbackHandler, withLangfuseAttributes } from "./langfuse.mjs";
-import { ACTIVITY_LABEL_PROMPT, buildActivityLabelPrompt } from "./prompts/activityLabel.mjs";
-import { appendCallbacks, findCallback } from "./utils/callbacks.mjs";
 import "./common/constants.mjs";
 import "./common/enum.mjs";
 import "./common/index.mjs";
+import { ACTIVITY_LABEL_PROMPT, buildActivityLabelPrompt } from "./prompts/activityLabel.mjs";
+import { appendCallbacks, findCallback } from "./utils/callbacks.mjs";
 import { createCompletionTitleRunnable, createTitleRunnable } from "./utils/title.mjs";
 import { createTokenCounter, encodingForModel } from "./utils/tokens.mjs";
-import { resolveMaxSeals } from "./llm/preempt.mjs";
 import { initializeLangfuseTracing } from "./instrumentation.mjs";
+import { resolveMaxSeals } from "./llm/preempt.mjs";
 import { isOpenAILike } from "./utils/llm.mjs";
 import { HandlerRegistry } from "./events.mjs";
 import { initializeModel } from "./llm/init.mjs";
@@ -18,6 +18,7 @@ import { executeHooks } from "./hooks/executeHooks.mjs";
 import "./hooks/index.mjs";
 import { StandardGraph } from "./graphs/Graph.mjs";
 import { MultiAgentGraph } from "./graphs/MultiAgentGraph.mjs";
+import { nanoid } from "nanoid";
 import { PromptTemplate } from "@langchain/core/prompts";
 import { RunnableLambda } from "@langchain/core/runnables";
 import { AzureChatOpenAI, ChatOpenAI } from "@langchain/openai";
@@ -376,6 +377,16 @@ var Run = class Run {
 		return this.Graph.getRunMessages();
 	}
 	/**
+	* Returns a defensive snapshot of tools discovered by the current run.
+	* Pass an agent id for that context, or omit it for the ordered union across
+	* contexts. Interrupted state is available immediately for host persistence;
+	* completed runs retain their final snapshot through graph cleanup.
+	*/
+	getDiscoveredTools(agentId) {
+		if (!this.Graph) throw new Error("Graph not initialized. Make sure to use Run.create() to instantiate the Run.");
+		return this.Graph.getDiscoveredTools(agentId);
+	}
+	/**
 	* Returns the current calibration ratio (EMA of provider-vs-estimate token ratios).
 	* Hosts should persist this value and pass it back as `RunConfig.calibrationRatio`
 	* on the next run for the same conversation so the pruner starts with an accurate
@@ -540,13 +551,22 @@ var Run = class Run {
 		const traceName = config.runName ?? getLangfuseTraceName(traceMetadata);
 		const streamLangfuseConfig = this.getStreamLangfuseConfig(graph);
 		initializeLangfuseTracing(streamLangfuseConfig);
+		const streamRuntimeScope = resolveLangfuseRuntimeScope({
+			runLangfuse: streamLangfuseConfig,
+			langfuseOverlay: this.getStreamToolOutputTracingLangfuseConfig(graph),
+			traceIdSeed: streamLangfuseConfig?.deterministicTraceId === true ? this.id : void 0,
+			runId: graph.langfuseScopeRunId
+		});
 		const langfuseHandler = createLangfuseHandler({
 			langfuse: streamLangfuseConfig,
 			userId,
 			sessionId,
 			traceMetadata,
 			tags: ["librechat", "agent"],
-			traceIdSeed: streamLangfuseConfig?.deterministicTraceId === true ? this.id : void 0
+			traceIdSeed: streamLangfuseConfig?.deterministicTraceId === true ? this.id : void 0,
+			runId: graph.langfuseScopeRunId,
+			toolOutputTracing: streamRuntimeScope.toolOutputTracing,
+			traceName
 		});
 		if (langfuseHandler != null) {
 			config.runName = traceName;
@@ -710,11 +730,7 @@ var Run = class Run {
 			else if (this._haltedReason == null && graph.preemptIncomplete) this._haltedReason = "preempt_incomplete";
 		};
 		try {
-			await withLangfuseRuntimeScope(resolveLangfuseRuntimeScope({
-				runLangfuse: streamLangfuseConfig,
-				langfuseOverlay: this.getStreamToolOutputTracingLangfuseConfig(graph),
-				traceIdSeed: streamLangfuseConfig?.deterministicTraceId === true ? this.id : void 0
-			}), () => withLangfuseAttributes({
+			await withLangfuseRuntimeScope(streamRuntimeScope, () => withLangfuseAttributes({
 				langfuse: streamLangfuseConfig,
 				userId,
 				sessionId,
@@ -967,19 +983,35 @@ var Run = class Run {
 	}
 	async generateTitle({ provider, inputText, contentParts, titlePrompt, clientOptions, chainOptions, skipLanguage, titleMethod = "completion", titlePromptTemplate }) {
 		let titleLangfuseHandler;
-		let titleLangfuseConfig;
 		let titleUserId;
 		let titleSessionId;
 		const titleContext = this.Graph == null ? void 0 : this.Graph.agentContexts.get(this.Graph.defaultAgentId);
+		const titleLangfuseConfig = resolveLangfuseConfig(this.langfuse, titleContext?.langfuse);
 		const traceMetadata = createLangfuseTraceMetadata({
 			messageId: "title-" + this.id,
 			agentName: titleContext?.name
 		});
 		const titleRunName = getLangfuseTraceName(traceMetadata, "LibreChat Title");
+		/** Scope identity carries an opaque per-execution component: public run
+		*  ids are unrestricted, so a purely derived id (`title-<runId>`) could
+		*  collide with an ordinary concurrent run literally named that way and
+		*  defeat foreign-scope rejection. */
+		const titleScopeRunId = `title:${this.id}:${nanoid()}`;
+		/** Seed policy mirrors `generateActivityLabel`:
+		*  `runWithLangfuseRuntimeContext` SPREADS the surrounding context, so an
+		*  absent seed INHERITS an active parent run's and collapses the title
+		*  into that run's trace. Seeded when determinism is opted into OR a
+		*  parent seed is live; otherwise unseeded, matching the other paths. */
+		const inheritedTraceSeed = getTraceIdSeed();
+		const titleRuntimeScope = resolveLangfuseRuntimeScope({
+			runLangfuse: this.langfuse,
+			langfuseOverlay: titleContext?.langfuse,
+			traceIdSeed: titleLangfuseConfig?.deterministicTraceId === true || inheritedTraceSeed != null ? "title-" + this.id : void 0,
+			runId: titleScopeRunId
+		});
 		if (chainOptions != null) {
 			titleUserId = typeof chainOptions.configurable?.user_id === "string" ? chainOptions.configurable.user_id : void 0;
 			titleSessionId = typeof chainOptions.configurable?.thread_id === "string" ? chainOptions.configurable.thread_id : void 0;
-			titleLangfuseConfig = resolveLangfuseConfig(this.langfuse, titleContext?.langfuse);
 			initializeLangfuseTracing(titleLangfuseConfig);
 			titleLangfuseHandler = createLangfuseHandler({
 				langfuse: titleLangfuseConfig,
@@ -987,7 +1019,10 @@ var Run = class Run {
 				sessionId: titleSessionId,
 				traceMetadata,
 				tags: ["librechat", "title"],
-				traceIdSeed: titleLangfuseConfig?.deterministicTraceId === true ? "title-" + this.id : void 0
+				traceIdSeed: titleLangfuseConfig?.deterministicTraceId === true ? "title-" + this.id : void 0,
+				runId: titleScopeRunId,
+				toolOutputTracing: titleRuntimeScope.toolOutputTracing,
+				traceName: chainOptions.runName ?? titleRunName
 			});
 			if (titleLangfuseHandler != null) chainOptions.callbacks = appendCallbacks(chainOptions.callbacks, [titleLangfuseHandler]);
 		}
@@ -1033,18 +1068,12 @@ var Run = class Run {
 		}, runtimeConfig));
 		try {
 			try {
-				return await withLangfuseRuntimeScope(resolveLangfuseRuntimeScope({
-					runLangfuse: this.langfuse,
-					langfuseOverlay: titleContext?.langfuse
-				}), () => invokeTitleChain(invokeConfig));
+				return await withLangfuseRuntimeScope(titleRuntimeScope, () => invokeTitleChain(invokeConfig));
 			} catch (_e) {
 				const langfuseHandler = findCallback(invokeConfig.callbacks, isLangfuseCallbackHandler);
 				const { callbacks: _cb, ...rest } = invokeConfig;
 				const safeConfig = Object.assign({}, rest, { callbacks: langfuseHandler ? [langfuseHandler] : [] });
-				return await withLangfuseRuntimeScope(resolveLangfuseRuntimeScope({
-					runLangfuse: this.langfuse,
-					langfuseOverlay: titleContext?.langfuse
-				}), () => invokeTitleChain(safeConfig));
+				return await withLangfuseRuntimeScope(titleRuntimeScope, () => invokeTitleChain(safeConfig));
 			}
 		} finally {
 			await disposeLangfuseHandler(titleLangfuseHandler);
@@ -1096,10 +1125,13 @@ var Run = class Run {
 		*  otherwise unseeded, matching the other generation paths. */
 		const inheritedTraceSeed = getTraceIdSeed();
 		const labelTraceSeed = labelLangfuseConfig?.deterministicTraceId === true || inheritedTraceSeed != null ? traceSeed ?? `activity-label-${this.id}-${labelSeq}` : void 0;
+		/** Opaque per-execution component: see `titleScopeRunId`. */
+		const labelScopeRunId = `activity-label:${this.id}:${labelSeq}:${nanoid()}`;
 		const labelRuntimeScope = resolveLangfuseRuntimeScope({
 			runLangfuse: this.langfuse,
 			langfuseOverlay: labelContext?.langfuse,
-			traceIdSeed: labelTraceSeed
+			traceIdSeed: labelTraceSeed,
+			runId: labelScopeRunId
 		});
 		/** Handler only when a session id resolved from
 		*  `chainOptions.configurable.thread_id`: without it the label call has
@@ -1115,7 +1147,10 @@ var Run = class Run {
 			sessionId: labelSessionId,
 			traceMetadata,
 			tags: ["librechat", "activity-label"],
-			traceIdSeed: labelLangfuseConfig?.deterministicTraceId === true ? labelTraceSeed : void 0
+			traceIdSeed: labelLangfuseConfig?.deterministicTraceId === true ? labelTraceSeed : void 0,
+			runId: labelScopeRunId,
+			toolOutputTracing: labelRuntimeScope.toolOutputTracing,
+			traceName: labelChainOptions.runName ?? labelRunName
 		});
 		if (labelLangfuseHandler != null) labelChainOptions.callbacks = appendCallbacks(labelChainOptions.callbacks, [labelLangfuseHandler]);
 		/** The label prompt becomes Langfuse generation input, so the resolved