@librechat/agents 3.2.43 → 3.2.45

package/dist/esm/instrumentation.mjs

@@ -1,9 +1,10 @@
+import { traceIdFromSeed } from "./langfuseRuntimeContext.mjs";
 import { isPresent } from "./utils/misc.mjs";
-import { hasLangfuseConfigCredentials, hasLangfuseEnvConfig, hasLangfuseEnvCredentials } from "./langfuse.mjs";
-import { createLangfuseSpanProcessor, getContextLangfuseConfig } from "./langfuseToolOutputTracing.mjs";
-import { setLangfuseTracerProvider } from "@langfuse/tracing";
-import { AsyncLocalStorage } from "node:async_hooks";
+import { resolveLangfuseConfigForSpan, resolveTraceIdSeedForSpan } from "./langfuseRuntimeScope.mjs";
+import { createLibreChatTraceAttributes, hasLangfuseConfigCredentials, hasLangfuseEnvConfig, hasLangfuseEnvCredentials } from "./langfuse.mjs";
+import { createLangfuseSpanProcessor } from "./langfuseToolOutputTracing.mjs";
 import { ROOT_CONTEXT, context, createContextKey } from "@opentelemetry/api";
+import { setLangfuseTracerProvider } from "@langfuse/tracing";
 import { createHash, randomBytes } from "node:crypto";
 import { BasicTracerProvider } from "@opentelemetry/sdk-trace-base";
 import { AsyncLocalStorageContextManager } from "@opentelemetry/context-async-hooks";
@@ -11,24 +12,17 @@ import { AsyncLocalStorageContextManager } from "@opentelemetry/context-async-ho
 /**
 * Per-run seed for deterministic Langfuse trace ids. When a run opts in
 * (`LangfuseConfig.deterministicTraceId`), it executes its stream inside
-* `runWithTraceIdSeed(runId, …)` and the IdGenerator below derives the root
-* trace id from that seed instead of a random one. This lets external systems
-* (e.g. a host app recording user feedback after the fact) attach scores or
-* observations to the trace by regenerating the same id from the run/message
-* id — no trace lookup required. With no active seed it falls back to random
-* ids, so default behavior is unchanged.
+* `runWithTraceIdSeed(runId, ...)` from `./langfuseRuntimeContext`, and the
+* IdGenerator below derives the root trace id from that seed instead of a
+* random one. This lets external systems (e.g. a host app recording user
+* feedback after the fact) attach scores or observations to the trace by
+* regenerating the same id from the run/message id; no trace lookup required.
+* With no active seed it falls back to random ids, so default behavior is
+* unchanged.
 */
-const traceIdSeedStore = new AsyncLocalStorage();
-function runWithTraceIdSeed(seed, fn) {
-	return isPresent(seed) ? traceIdSeedStore.run(seed, fn) : fn();
-}
-/** sha256(seed) → first 32 hex chars; matches `@langfuse/tracing` `createTraceId`. */
-function traceIdFromSeed(seed) {
-	return createHash("sha256").update(seed, "utf8").digest("hex").slice(0, 32);
-}
 var SeededTraceIdGenerator = class {
 	generateTraceId() {
-		const seed = traceIdSeedStore.getStore();
+		const seed = resolveTraceIdSeedForSpan(context.active());
 		return isPresent(seed) ? traceIdFromSeed(seed) : randomBytes(16).toString("hex");
 	}
 	generateSpanId() {
@@ -68,10 +62,13 @@ function getLangfuseSpanProcessorParams(langfuse) {
 		baseUrl: langfuse.baseUrl
 	};
 }
+function hashCacheKeyValue(value) {
+	return isPresent(value) ? createHash("sha256").update(value, "utf8").digest("hex") : void 0;
+}
 function getLangfuseTracerProviderKey(params, langfuse) {
 	return JSON.stringify({
 		publicKey: params.publicKey,
-		secretKey: params.secretKey,
+		secretKeyHash: hashCacheKeyValue(params.secretKey),
 		baseUrl: params.baseUrl,
 		environment: params.environment,
 		toolOutputTracing: langfuse?.toolOutputTracing
@@ -91,8 +88,11 @@ var RoutingLangfuseSpanProcessor = class {
 		return processor;
 	}
 	onStart(span, parentContext) {
-		const processor = this.ensureProcessor(getContextLangfuseConfig(parentContext));
+		const langfuse = resolveLangfuseConfigForSpan(parentContext);
+		const processor = this.ensureProcessor(langfuse);
 		if (processor == null) return;
+		const librechatTraceAttributes = createLibreChatTraceAttributes(langfuse?.librechatTraceAttributes ?? {});
+		if (Object.keys(librechatTraceAttributes).length > 0) span.setAttributes(librechatTraceAttributes);
 		this.spanProcessors.set(span, processor);
 		processor.onStart(span, parentContext);
 	}
@@ -127,6 +127,6 @@ function initializeLangfuseTracingFromEnv() {
 }
 initializeLangfuseTracingFromEnv();
 //#endregion
-export { initializeLangfuseTracing, runWithTraceIdSeed };
+export { initializeLangfuseTracing };
 
 //# sourceMappingURL=instrumentation.mjs.map

package/dist/esm/instrumentation.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"instrumentation.mjs","names":[],"sources":["../../src/instrumentation.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\nimport { createHash, randomBytes } from 'node:crypto';\nimport { setLangfuseTracerProvider } from '@langfuse/tracing';\nimport { BasicTracerProvider } from '@opentelemetry/sdk-trace-base';\nimport { context, ROOT_CONTEXT, createContextKey } from '@opentelemetry/api';\nimport { AsyncLocalStorageContextManager } from '@opentelemetry/context-async-hooks';\nimport type {\n  IdGenerator,\n  ReadableSpan,\n  Span,\n  SpanProcessor,\n} from '@opentelemetry/sdk-trace-base';\nimport type { LangfuseSpanProcessorParams } from '@langfuse/otel';\nimport type { Context } from '@opentelemetry/api';\nimport type * as t from '@/types';\nimport {\n  hasLangfuseConfigCredentials,\n  hasLangfuseEnvCredentials,\n  hasLangfuseEnvConfig,\n} from '@/langfuse';\nimport {\n  createLangfuseSpanProcessor,\n  getContextLangfuseConfig,\n} from '@/langfuseToolOutputTracing';\nimport { isPresent } from '@/utils/misc';\n\n/**\n * Per-run seed for deterministic Langfuse trace ids. When a run opts in\n * (`LangfuseConfig.deterministicTraceId`), it executes its stream inside\n * `runWithTraceIdSeed(runId, …)` and the IdGenerator below derives the root\n * trace id from that seed instead of a random one. This lets external systems\n * (e.g. a host app recording user feedback after the fact) attach scores or\n * observations to the trace by regenerating the same id from the run/message\n * id — no trace lookup required. With no active seed it falls back to random\n * ids, so default behavior is unchanged.\n */\nconst traceIdSeedStore = new AsyncLocalStorage<string>();\n\nexport function runWithTraceIdSeed<T>(\n  seed: string | undefined,\n  fn: () => T\n): T {\n  return isPresent(seed) ? traceIdSeedStore.run(seed, fn) : fn();\n}\n\n/** sha256(seed) → first 32 hex chars; matches `@langfuse/tracing` `createTraceId`. */\nfunction traceIdFromSeed(seed: string): string {\n  return createHash('sha256').update(seed, 'utf8').digest('hex').slice(0, 32);\n}\n\nclass SeededTraceIdGenerator implements IdGenerator {\n  generateTraceId(): string {\n    const seed = traceIdSeedStore.getStore();\n    return isPresent(seed)\n      ? traceIdFromSeed(seed)\n      : randomBytes(16).toString('hex');\n  }\n\n  generateSpanId(): string {\n    return randomBytes(8).toString('hex');\n  }\n}\n\nlet langfuseTracerProvider: BasicTracerProvider | undefined;\nlet langfuseRoutingSpanProcessor: RoutingLangfuseSpanProcessor | undefined;\nconst contextManagerProbeKey = createContextKey(\n  'langfuse-context-manager-probe'\n);\n\nfunction hasActiveContextManager(): boolean {\n  return context.with(\n    ROOT_CONTEXT.setValue(contextManagerProbeKey, true),\n    () => context.active().getValue(contextManagerProbeKey) === true\n  );\n}\n\nexport function ensureOpenTelemetryContextManager(): void {\n  if (hasActiveContextManager()) {\n    return;\n  }\n\n  const contextManager = new AsyncLocalStorageContextManager();\n  contextManager.enable();\n  if (!context.setGlobalContextManager(contextManager)) {\n    contextManager.disable();\n  }\n}\n\nfunction getLangfuseSpanProcessorParams(\n  langfuse?: t.LangfuseConfig\n): LangfuseSpanProcessorParams | undefined {\n  if (langfuse?.enabled === false) {\n    return undefined;\n  }\n  if (hasLangfuseConfigCredentials(langfuse)) {\n    return {\n      publicKey: langfuse.publicKey,\n      secretKey: langfuse.secretKey,\n      ...(isPresent(langfuse.baseUrl) ? { baseUrl: langfuse.baseUrl } : {}),\n    };\n  }\n  if (hasLangfuseEnvConfig()) {\n    const baseUrl =\n      langfuse?.baseUrl ??\n      process.env.LANGFUSE_BASE_URL ??\n      process.env.LANGFUSE_BASEURL;\n    return {\n      publicKey: process.env.LANGFUSE_PUBLIC_KEY as string,\n      secretKey: process.env.LANGFUSE_SECRET_KEY as string,\n      ...(isPresent(baseUrl) ? { baseUrl } : {}),\n    };\n  }\n  if (isPresent(langfuse?.baseUrl) && hasLangfuseEnvCredentials()) {\n    return {\n      publicKey: process.env.LANGFUSE_PUBLIC_KEY as string,\n      secretKey: process.env.LANGFUSE_SECRET_KEY as string,\n      baseUrl: langfuse.baseUrl,\n    };\n  }\n  return undefined;\n}\n\nfunction getLangfuseTracerProviderKey(\n  params: LangfuseSpanProcessorParams,\n  langfuse?: t.LangfuseConfig\n): string {\n  return JSON.stringify({\n    publicKey: params.publicKey,\n    secretKey: params.secretKey,\n    baseUrl: params.baseUrl,\n    environment: params.environment,\n    toolOutputTracing: langfuse?.toolOutputTracing,\n  });\n}\n\nclass RoutingLangfuseSpanProcessor implements SpanProcessor {\n  private readonly processors = new Map<string, SpanProcessor>();\n  private readonly spanProcessors = new WeakMap<object, SpanProcessor>();\n\n  ensureProcessor(langfuse?: t.LangfuseConfig): SpanProcessor | undefined {\n    const params = getLangfuseSpanProcessorParams(langfuse);\n    if (params == null) {\n      return undefined;\n    }\n\n    const processorKey = getLangfuseTracerProviderKey(params, langfuse);\n    const existing = this.processors.get(processorKey);\n    if (existing != null) {\n      return existing;\n    }\n\n    const processor = createLangfuseSpanProcessor(params, langfuse);\n    this.processors.set(processorKey, processor);\n    return processor;\n  }\n\n  onStart(span: Span, parentContext: Context): void {\n    const processor = this.ensureProcessor(\n      getContextLangfuseConfig(parentContext)\n    );\n    if (processor == null) {\n      return;\n    }\n\n    this.spanProcessors.set(span, processor);\n    processor.onStart(span, parentContext);\n  }\n\n  onEnd(span: ReadableSpan): void {\n    this.spanProcessors.get(span)?.onEnd(span);\n  }\n\n  async forceFlush(): Promise<void> {\n    await Promise.all(\n      Array.from(this.processors.values(), (processor) =>\n        processor.forceFlush()\n      )\n    );\n  }\n\n  async shutdown(): Promise<void> {\n    await Promise.all(\n      Array.from(this.processors.values(), (processor) => processor.shutdown())\n    );\n  }\n}\n\nexport function initializeLangfuseTracing(\n  langfuse?: t.LangfuseConfig\n): BasicTracerProvider | undefined {\n  const params = getLangfuseSpanProcessorParams(langfuse);\n  if (params == null) {\n    return undefined;\n  }\n\n  if (langfuseTracerProvider != null) {\n    langfuseRoutingSpanProcessor?.ensureProcessor(langfuse);\n    return langfuseTracerProvider;\n  }\n\n  ensureOpenTelemetryContextManager();\n  langfuseRoutingSpanProcessor = new RoutingLangfuseSpanProcessor();\n  langfuseRoutingSpanProcessor.ensureProcessor(langfuse);\n  langfuseTracerProvider = new BasicTracerProvider({\n    spanProcessors: [langfuseRoutingSpanProcessor],\n    idGenerator: new SeededTraceIdGenerator(),\n  });\n\n  setLangfuseTracerProvider(langfuseTracerProvider);\n  return langfuseTracerProvider;\n}\n\nexport function initializeLangfuseTracingFromEnv():\n  | BasicTracerProvider\n  | undefined {\n  return initializeLangfuseTracing();\n}\n\ninitializeLangfuseTracingFromEnv();\n"],"mappings":"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"}
+{"version":3,"file":"instrumentation.mjs","names":[],"sources":["../../src/instrumentation.ts"],"sourcesContent":["import { createHash, randomBytes } from 'node:crypto';\nimport { setLangfuseTracerProvider } from '@langfuse/tracing';\nimport { BasicTracerProvider } from '@opentelemetry/sdk-trace-base';\nimport { context, ROOT_CONTEXT, createContextKey } from '@opentelemetry/api';\nimport { AsyncLocalStorageContextManager } from '@opentelemetry/context-async-hooks';\nimport type {\n  IdGenerator,\n  ReadableSpan,\n  Span,\n  SpanProcessor,\n} from '@opentelemetry/sdk-trace-base';\nimport type { LangfuseSpanProcessorParams } from '@langfuse/otel';\nimport type { Context } from '@opentelemetry/api';\nimport type * as t from '@/types';\nimport {\n  createLibreChatTraceAttributes,\n  hasLangfuseConfigCredentials,\n  hasLangfuseEnvCredentials,\n  hasLangfuseEnvConfig,\n} from '@/langfuse';\nimport {\n  resolveLangfuseConfigForSpan,\n  resolveTraceIdSeedForSpan,\n} from '@/langfuseRuntimeScope';\nimport { createLangfuseSpanProcessor } from '@/langfuseToolOutputTracing';\nimport { traceIdFromSeed } from '@/langfuseRuntimeContext';\nimport { isPresent } from '@/utils/misc';\n\n/**\n * Per-run seed for deterministic Langfuse trace ids. When a run opts in\n * (`LangfuseConfig.deterministicTraceId`), it executes its stream inside\n * `runWithTraceIdSeed(runId, ...)` from `./langfuseRuntimeContext`, and the\n * IdGenerator below derives the root trace id from that seed instead of a\n * random one. This lets external systems (e.g. a host app recording user\n * feedback after the fact) attach scores or observations to the trace by\n * regenerating the same id from the run/message id; no trace lookup required.\n * With no active seed it falls back to random ids, so default behavior is\n * unchanged.\n */\nclass SeededTraceIdGenerator implements IdGenerator {\n  generateTraceId(): string {\n    const seed = resolveTraceIdSeedForSpan(context.active());\n    return isPresent(seed)\n      ? traceIdFromSeed(seed)\n      : randomBytes(16).toString('hex');\n  }\n\n  generateSpanId(): string {\n    return randomBytes(8).toString('hex');\n  }\n}\n\nlet langfuseTracerProvider: BasicTracerProvider | undefined;\nlet langfuseRoutingSpanProcessor: RoutingLangfuseSpanProcessor | undefined;\nconst contextManagerProbeKey = createContextKey(\n  'langfuse-context-manager-probe'\n);\n\nfunction hasActiveContextManager(): boolean {\n  return context.with(\n    ROOT_CONTEXT.setValue(contextManagerProbeKey, true),\n    () => context.active().getValue(contextManagerProbeKey) === true\n  );\n}\n\nexport function ensureOpenTelemetryContextManager(): void {\n  if (hasActiveContextManager()) {\n    return;\n  }\n\n  const contextManager = new AsyncLocalStorageContextManager();\n  contextManager.enable();\n  if (!context.setGlobalContextManager(contextManager)) {\n    contextManager.disable();\n  }\n}\n\nfunction getLangfuseSpanProcessorParams(\n  langfuse?: t.LangfuseConfig\n): LangfuseSpanProcessorParams | undefined {\n  if (langfuse?.enabled === false) {\n    return undefined;\n  }\n  if (hasLangfuseConfigCredentials(langfuse)) {\n    return {\n      publicKey: langfuse.publicKey,\n      secretKey: langfuse.secretKey,\n      ...(isPresent(langfuse.baseUrl) ? { baseUrl: langfuse.baseUrl } : {}),\n    };\n  }\n  if (hasLangfuseEnvConfig()) {\n    const baseUrl =\n      langfuse?.baseUrl ??\n      process.env.LANGFUSE_BASE_URL ??\n      process.env.LANGFUSE_BASEURL;\n    return {\n      publicKey: process.env.LANGFUSE_PUBLIC_KEY as string,\n      secretKey: process.env.LANGFUSE_SECRET_KEY as string,\n      ...(isPresent(baseUrl) ? { baseUrl } : {}),\n    };\n  }\n  if (isPresent(langfuse?.baseUrl) && hasLangfuseEnvCredentials()) {\n    return {\n      publicKey: process.env.LANGFUSE_PUBLIC_KEY as string,\n      secretKey: process.env.LANGFUSE_SECRET_KEY as string,\n      baseUrl: langfuse.baseUrl,\n    };\n  }\n  return undefined;\n}\n\nfunction hashCacheKeyValue(value: string | undefined): string | undefined {\n  return isPresent(value)\n    ? createHash('sha256').update(value, 'utf8').digest('hex')\n    : undefined;\n}\n\nfunction getLangfuseTracerProviderKey(\n  params: LangfuseSpanProcessorParams,\n  langfuse?: t.LangfuseConfig\n): string {\n  return JSON.stringify({\n    publicKey: params.publicKey,\n    secretKeyHash: hashCacheKeyValue(params.secretKey),\n    baseUrl: params.baseUrl,\n    environment: params.environment,\n    toolOutputTracing: langfuse?.toolOutputTracing,\n  });\n}\n\nclass RoutingLangfuseSpanProcessor implements SpanProcessor {\n  // Processors live for the process lifetime. LibreChat tenant Langfuse\n  // destinations are expected to be a bounded admin-managed set, and shutdown\n  // drains every cached processor when the provider is disposed.\n  private readonly processors = new Map<string, SpanProcessor>();\n  private readonly spanProcessors = new WeakMap<object, SpanProcessor>();\n\n  ensureProcessor(langfuse?: t.LangfuseConfig): SpanProcessor | undefined {\n    const params = getLangfuseSpanProcessorParams(langfuse);\n    if (params == null) {\n      return undefined;\n    }\n\n    const processorKey = getLangfuseTracerProviderKey(params, langfuse);\n    const existing = this.processors.get(processorKey);\n    if (existing != null) {\n      return existing;\n    }\n\n    const processor = createLangfuseSpanProcessor(params, langfuse);\n    this.processors.set(processorKey, processor);\n    return processor;\n  }\n\n  onStart(span: Span, parentContext: Context): void {\n    const langfuse = resolveLangfuseConfigForSpan(parentContext);\n    const processor = this.ensureProcessor(langfuse);\n    if (processor == null) {\n      return;\n    }\n\n    const librechatTraceAttributes = createLibreChatTraceAttributes(\n      langfuse?.librechatTraceAttributes ?? {}\n    );\n    if (Object.keys(librechatTraceAttributes).length > 0) {\n      span.setAttributes(librechatTraceAttributes);\n    }\n\n    this.spanProcessors.set(span, processor);\n    processor.onStart(span, parentContext);\n  }\n\n  onEnd(span: ReadableSpan): void {\n    this.spanProcessors.get(span)?.onEnd(span);\n  }\n\n  async forceFlush(): Promise<void> {\n    await Promise.all(\n      Array.from(this.processors.values(), (processor) =>\n        processor.forceFlush()\n      )\n    );\n  }\n\n  async shutdown(): Promise<void> {\n    await Promise.all(\n      Array.from(this.processors.values(), (processor) => processor.shutdown())\n    );\n  }\n}\n\nexport function initializeLangfuseTracing(\n  langfuse?: t.LangfuseConfig\n): BasicTracerProvider | undefined {\n  const params = getLangfuseSpanProcessorParams(langfuse);\n  if (params == null) {\n    return undefined;\n  }\n\n  if (langfuseTracerProvider != null) {\n    langfuseRoutingSpanProcessor?.ensureProcessor(langfuse);\n    return langfuseTracerProvider;\n  }\n\n  ensureOpenTelemetryContextManager();\n  langfuseRoutingSpanProcessor = new RoutingLangfuseSpanProcessor();\n  langfuseRoutingSpanProcessor.ensureProcessor(langfuse);\n  langfuseTracerProvider = new BasicTracerProvider({\n    spanProcessors: [langfuseRoutingSpanProcessor],\n    idGenerator: new SeededTraceIdGenerator(),\n  });\n\n  setLangfuseTracerProvider(langfuseTracerProvider);\n  return langfuseTracerProvider;\n}\n\nexport function initializeLangfuseTracingFromEnv():\n  | BasicTracerProvider\n  | undefined {\n  return initializeLangfuseTracing();\n}\n\ninitializeLangfuseTracingFromEnv();\n"],"mappings":"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"}

package/dist/esm/langfuse.mjs

@@ -1,18 +1,54 @@
-import { isPresent } from "./utils/misc.mjs";
+import { isPresent, parseBooleanEnv } from "./utils/misc.mjs";
+import { resolveLangfuseConfigForSpan, resolveTraceIdSeedForSpan, withLangfuseRuntimeScope } from "./langfuseRuntimeScope.mjs";
 import { CallbackHandler } from "@langfuse/langchain";
+import { context } from "@opentelemetry/api";
 import { getLangfuseTracerProvider, propagateAttributes } from "@langfuse/tracing";
 //#region src/langfuse.ts
 const TRACE_METADATA_MAX_LENGTH = 200;
 const LANGFUSE_FORCE_FLUSH_ON_DISPOSE = "LANGFUSE_FORCE_FLUSH_ON_DISPOSE";
-function parseBooleanEnv(value) {
-	if (value == null) return false;
-	return [
-		"1",
-		"true",
-		"yes",
-		"on"
-	].includes(value.trim().toLowerCase());
-}
+var ScopedLangfuseCallbackHandler = class extends CallbackHandler {
+	langfuse;
+	traceIdSeed;
+	constructor(params) {
+		const { langfuse, traceIdSeed, ...handlerParams } = params ?? {};
+		super(handlerParams);
+		this.langfuse = langfuse;
+		this.traceIdSeed = traceIdSeed;
+	}
+	getDeterministicTraceSeed() {
+		return this.langfuse?.deterministicTraceId === true ? this.traceIdSeed : void 0;
+	}
+	withRuntimeContext(action) {
+		const activeContext = context.active();
+		const langfuse = resolveLangfuseConfigForSpan(activeContext) ?? this.langfuse;
+		const seed = this.getDeterministicTraceSeed();
+		return withLangfuseRuntimeScope({
+			langfuse,
+			traceIdSeed: resolveTraceIdSeedForSpan(activeContext) ?? seed
+		}, action);
+	}
+	handleChainStart(...args) {
+		return this.withRuntimeContext(() => super.handleChainStart(...args));
+	}
+	handleAgentAction(...args) {
+		return this.withRuntimeContext(() => super.handleAgentAction(...args));
+	}
+	handleGenerationStart(...args) {
+		return this.withRuntimeContext(() => super.handleGenerationStart(...args));
+	}
+	handleChatModelStart(...args) {
+		return this.withRuntimeContext(() => super.handleChatModelStart(...args));
+	}
+	handleLLMStart(...args) {
+		return this.withRuntimeContext(() => super.handleLLMStart(...args));
+	}
+	handleToolStart(...args) {
+		return this.withRuntimeContext(() => super.handleToolStart(...args));
+	}
+	handleRetrieverStart(...args) {
+		return this.withRuntimeContext(() => super.handleRetrieverStart(...args));
+	}
+};
 function hasLangfuseConfigCredentials(langfuse) {
 	return langfuse != null && isPresent(langfuse.publicKey) && isPresent(langfuse.secretKey);
 }
@@ -29,6 +65,19 @@ function createTraceMetadata(metadata) {
 	}
 	return traceMetadata;
 }
+function createLibreChatTraceAttributes(attributes) {
+	const librechatTraceAttributes = {};
+	for (const [key, value] of Object.entries(attributes)) {
+		if (value == null || key.trim() === "") continue;
+		if (typeof value === "string") {
+			if (value.trim() === "" || value.length > TRACE_METADATA_MAX_LENGTH) continue;
+			librechatTraceAttributes[key] = value;
+			continue;
+		}
+		librechatTraceAttributes[key] = value;
+	}
+	return librechatTraceAttributes;
+}
 function createLangfuseTraceMetadata({ messageId, parentMessageId, agentId, agentName }) {
 	return createTraceMetadata({
 		messageId,
@@ -62,13 +111,15 @@ function shouldCreateLangfuseHandler(langfuse) {
 	if (langfuse?.enabled === false) return false;
 	return hasLangfuseEnvConfig() || hasLangfuseConfigCredentials(langfuse) || hasLangfuseConfigBaseUrl(langfuse) && hasLangfuseEnvCredentials();
 }
-function createLangfuseHandler({ langfuse, userId, sessionId, traceMetadata, tags }) {
+function createLangfuseHandler({ langfuse, userId, sessionId, traceMetadata, tags, traceIdSeed }) {
 	if (!shouldCreateLangfuseHandler(langfuse)) return;
-	return new CallbackHandler({
+	return new ScopedLangfuseCallbackHandler({
 		userId,
 		sessionId,
 		traceMetadata: mergeLangfuseTraceMetadata(traceMetadata, langfuse?.metadata),
-		tags: mergeLangfuseTags(tags, langfuse?.tags)
+		tags: mergeLangfuseTags(tags, langfuse?.tags),
+		langfuse,
+		traceIdSeed
 	});
 }
 function createPropagateAttributeParams({ langfuse, userId, sessionId, traceMetadata, traceName, tags }) {
@@ -92,6 +143,6 @@ async function disposeLangfuseHandler(value) {
 	await getLangfuseTracerProvider().forceFlush?.();
 }
 //#endregion
-export { createLangfuseHandler, createLangfuseTraceMetadata, disposeLangfuseHandler, getLangfuseTraceName, hasLangfuseConfigCredentials, hasLangfuseEnvConfig, hasLangfuseEnvCredentials, isLangfuseCallbackHandler, withLangfuseAttributes };
+export { createLangfuseHandler, createLangfuseTraceMetadata, createLibreChatTraceAttributes, disposeLangfuseHandler, getLangfuseTraceName, hasLangfuseConfigCredentials, hasLangfuseEnvConfig, hasLangfuseEnvCredentials, isLangfuseCallbackHandler, withLangfuseAttributes };
 
 //# sourceMappingURL=langfuse.mjs.map

package/dist/esm/langfuse.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"langfuse.mjs","names":[],"sources":["../../src/langfuse.ts"],"sourcesContent":["import { CallbackHandler } from '@langfuse/langchain';\nimport {\n  getLangfuseTracerProvider,\n  propagateAttributes,\n} from '@langfuse/tracing';\nimport type { PropagateAttributesParams } from '@langfuse/tracing';\nimport type * as t from '@/types';\nimport { isPresent } from '@/utils/misc';\n\nconst TRACE_METADATA_MAX_LENGTH = 200;\nconst LANGFUSE_FORCE_FLUSH_ON_DISPOSE = 'LANGFUSE_FORCE_FLUSH_ON_DISPOSE';\n\nexport type LangfuseTraceMetadata = Record<string, string>;\ntype LangfuseMetadata = NonNullable<t.LangfuseConfig['metadata']>;\n\ntype LangfuseHandlerParams = {\n  userId?: string;\n  sessionId?: string;\n  traceMetadata?: LangfuseTraceMetadata;\n  tags?: string[];\n};\n\ntype AgentLangfuseHandlerParams = LangfuseHandlerParams & {\n  langfuse?: t.LangfuseConfig;\n};\n\ntype LangfuseAttributeParams = AgentLangfuseHandlerParams & {\n  traceName?: string;\n};\n\ntype FlushableTracerProvider = {\n  forceFlush?: () => Promise<void> | void;\n};\n\nfunction parseBooleanEnv(value?: string): boolean {\n  if (value == null) {\n    return false;\n  }\n  return ['1', 'true', 'yes', 'on'].includes(value.trim().toLowerCase());\n}\n\nfunction hasLangfuseTracingConfig(langfuse?: t.LangfuseConfig): boolean {\n  return (\n    langfuse?.toolNodeTracing != null || langfuse?.toolOutputTracing != null\n  );\n}\n\nfunction hasLangfuseTraceAttributes(langfuse?: t.LangfuseConfig): boolean {\n  return (\n    Object.keys(createTraceMetadata(langfuse?.metadata ?? {})).length > 0 ||\n    (mergeLangfuseTags(undefined, langfuse?.tags)?.length ?? 0) > 0\n  );\n}\n\nexport function hasLangfuseConfigCredentials(\n  langfuse?: t.LangfuseConfig\n): langfuse is t.LangfuseConfig & {\n  publicKey: string;\n  secretKey: string;\n} {\n  return (\n    langfuse != null &&\n    isPresent(langfuse.publicKey) &&\n    isPresent(langfuse.secretKey)\n  );\n}\n\nfunction hasLangfuseConfigBaseUrl(langfuse?: t.LangfuseConfig): boolean {\n  return isPresent(langfuse?.baseUrl);\n}\n\nexport function isExplicitLangfuseConfig(langfuse?: t.LangfuseConfig): boolean {\n  return (\n    langfuse?.enabled != null ||\n    isPresent(langfuse?.publicKey) ||\n    isPresent(langfuse?.secretKey) ||\n    isPresent(langfuse?.baseUrl) ||\n    hasLangfuseTraceAttributes(langfuse) ||\n    hasLangfuseTracingConfig(langfuse)\n  );\n}\n\nfunction createTraceMetadata(\n  metadata: Record<string, unknown>\n): LangfuseTraceMetadata {\n  const traceMetadata: LangfuseTraceMetadata = {};\n  for (const [key, value] of Object.entries(metadata)) {\n    if (value == null) {\n      continue;\n    }\n    const stringValue = typeof value === 'string' ? value : String(value);\n    if (\n      stringValue.trim() === '' ||\n      stringValue.length > TRACE_METADATA_MAX_LENGTH\n    ) {\n      continue;\n    }\n    traceMetadata[key] = stringValue;\n  }\n  return traceMetadata;\n}\n\nexport function createLangfuseTraceMetadata({\n  messageId,\n  parentMessageId,\n  agentId,\n  agentName,\n}: {\n  messageId?: unknown;\n  parentMessageId?: unknown;\n  agentId?: unknown;\n  agentName?: unknown;\n}): LangfuseTraceMetadata {\n  return createTraceMetadata({\n    messageId,\n    parentMessageId,\n    agentId,\n    agentName,\n  });\n}\n\nfunction mergeLangfuseTraceMetadata(\n  traceMetadata?: LangfuseTraceMetadata,\n  metadata?: LangfuseMetadata\n): LangfuseTraceMetadata | undefined {\n  const merged = createTraceMetadata({\n    ...(metadata ?? {}),\n    ...(traceMetadata ?? {}),\n  });\n  return Object.keys(merged).length > 0 ? merged : undefined;\n}\n\nfunction mergeLangfuseTags(\n  tags?: string[],\n  configTags?: string[]\n): string[] | undefined {\n  const merged = [...(tags ?? []), ...(configTags ?? [])].filter(\n    (tag) => tag.trim() !== ''\n  );\n  return merged.length > 0 ? [...new Set(merged)] : undefined;\n}\n\nexport function getLangfuseTraceName(\n  traceMetadata?: LangfuseTraceMetadata,\n  fallback: string = 'LibreChat Agent'\n): string {\n  const agentName = traceMetadata?.agentName;\n  return isPresent(agentName) ? `${fallback}: ${agentName}` : fallback;\n}\n\nexport function hasLangfuseEnvConfig(): boolean {\n  return hasLangfuseEnvCredentials();\n}\n\nexport function hasLangfuseEnvCredentials(): boolean {\n  return (\n    isPresent(process.env.LANGFUSE_SECRET_KEY) &&\n    isPresent(process.env.LANGFUSE_PUBLIC_KEY)\n  );\n}\n\nexport function shouldCreateLangfuseHandler(\n  langfuse?: t.LangfuseConfig\n): boolean {\n  if (langfuse?.enabled === false) {\n    return false;\n  }\n  return (\n    hasLangfuseEnvConfig() ||\n    hasLangfuseConfigCredentials(langfuse) ||\n    (hasLangfuseConfigBaseUrl(langfuse) && hasLangfuseEnvCredentials())\n  );\n}\n\nexport function createLegacyLangfuseHandler(\n  params: LangfuseHandlerParams\n): CallbackHandler {\n  return new CallbackHandler(params);\n}\n\nexport function createLangfuseHandler({\n  langfuse,\n  userId,\n  sessionId,\n  traceMetadata,\n  tags,\n}: AgentLangfuseHandlerParams): CallbackHandler | undefined {\n  if (!shouldCreateLangfuseHandler(langfuse)) {\n    return undefined;\n  }\n  return new CallbackHandler({\n    userId,\n    sessionId,\n    traceMetadata: mergeLangfuseTraceMetadata(\n      traceMetadata,\n      langfuse?.metadata\n    ),\n    tags: mergeLangfuseTags(tags, langfuse?.tags),\n  });\n}\n\nfunction createPropagateAttributeParams({\n  langfuse,\n  userId,\n  sessionId,\n  traceMetadata,\n  traceName,\n  tags,\n}: LangfuseAttributeParams): PropagateAttributesParams {\n  return {\n    userId,\n    sessionId,\n    traceName,\n    tags: mergeLangfuseTags(tags, langfuse?.tags),\n    metadata: mergeLangfuseTraceMetadata(traceMetadata, langfuse?.metadata),\n  };\n}\n\nexport function withLangfuseAttributes<T>(\n  params: LangfuseAttributeParams,\n  action: () => T\n): T {\n  if (!shouldCreateLangfuseHandler(params.langfuse)) {\n    return action();\n  }\n  return propagateAttributes(createPropagateAttributeParams(params), action);\n}\n\nexport function hasExplicitLangfuseConfig(\n  contexts: Iterable<{ langfuse?: t.LangfuseConfig }>\n): boolean {\n  for (const context of contexts) {\n    if (isExplicitLangfuseConfig(context.langfuse)) {\n      return true;\n    }\n  }\n  return false;\n}\n\nexport function isLangfuseCallbackHandler(value: unknown): boolean {\n  return value instanceof CallbackHandler;\n}\n\nexport async function disposeLangfuseHandler(value: unknown): Promise<void> {\n  if (\n    value == null ||\n    !parseBooleanEnv(process.env[LANGFUSE_FORCE_FLUSH_ON_DISPOSE])\n  ) {\n    return;\n  }\n  const provider = getLangfuseTracerProvider() as FlushableTracerProvider;\n  await provider.forceFlush?.();\n}\n"],"mappings":"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"}
+{"version":3,"file":"langfuse.mjs","names":["otelContext"],"sources":["../../src/langfuse.ts"],"sourcesContent":["import { CallbackHandler } from '@langfuse/langchain';\nimport { context as otelContext } from '@opentelemetry/api';\nimport {\n  getLangfuseTracerProvider,\n  propagateAttributes,\n} from '@langfuse/tracing';\nimport type { PropagateAttributesParams } from '@langfuse/tracing';\nimport type * as t from '@/types';\nimport {\n  resolveLangfuseConfigForSpan,\n  resolveTraceIdSeedForSpan,\n  withLangfuseRuntimeScope,\n} from '@/langfuseRuntimeScope';\nimport { isPresent, parseBooleanEnv } from '@/utils/misc';\n\nconst TRACE_METADATA_MAX_LENGTH = 200;\nconst LANGFUSE_FORCE_FLUSH_ON_DISPOSE = 'LANGFUSE_FORCE_FLUSH_ON_DISPOSE';\n\nexport type LangfuseTraceMetadata = Record<string, string>;\nexport type LangfuseTraceAttributes = Record<string, string | number | boolean>;\ntype LangfuseMetadata = NonNullable<t.LangfuseConfig['metadata']>;\ntype LangfuseConfigTraceAttributes = NonNullable<\n  t.LangfuseConfig['librechatTraceAttributes']\n>;\n\ntype LangfuseHandlerParams = {\n  userId?: string;\n  sessionId?: string;\n  traceMetadata?: LangfuseTraceMetadata;\n  tags?: string[];\n  traceIdSeed?: string;\n};\n\ntype AgentLangfuseHandlerParams = LangfuseHandlerParams & {\n  langfuse?: t.LangfuseConfig;\n};\n\ntype LangfuseAttributeParams = AgentLangfuseHandlerParams & {\n  traceName?: string;\n};\n\ntype FlushableTracerProvider = {\n  forceFlush?: () => Promise<void> | void;\n};\n\nclass ScopedLangfuseCallbackHandler extends CallbackHandler {\n  private readonly langfuse?: t.LangfuseConfig;\n  private readonly traceIdSeed?: string;\n\n  constructor(params?: AgentLangfuseHandlerParams) {\n    const { langfuse, traceIdSeed, ...handlerParams } = params ?? {};\n    super(handlerParams);\n    this.langfuse = langfuse;\n    this.traceIdSeed = traceIdSeed;\n  }\n\n  private getDeterministicTraceSeed(): string | undefined {\n    return this.langfuse?.deterministicTraceId === true\n      ? this.traceIdSeed\n      : undefined;\n  }\n\n  private withRuntimeContext<T>(action: () => T): T {\n    const activeContext = otelContext.active();\n    const langfuse =\n      resolveLangfuseConfigForSpan(activeContext) ?? this.langfuse;\n    const seed = this.getDeterministicTraceSeed();\n    return withLangfuseRuntimeScope(\n      {\n        langfuse,\n        traceIdSeed: resolveTraceIdSeedForSpan(activeContext) ?? seed,\n      },\n      action\n    );\n  }\n\n  // LangChain may invoke callback handlers outside the caller's OTEL context.\n  // Re-enter tenant scope only for callbacks that start Langfuse observations;\n  // end/error/token callbacks use spans already bound to a processor at start.\n  override handleChainStart(\n    ...args: Parameters<CallbackHandler['handleChainStart']>\n  ): ReturnType<CallbackHandler['handleChainStart']> {\n    return this.withRuntimeContext(() => super.handleChainStart(...args));\n  }\n\n  override handleAgentAction(\n    ...args: Parameters<CallbackHandler['handleAgentAction']>\n  ): ReturnType<CallbackHandler['handleAgentAction']> {\n    return this.withRuntimeContext(() => super.handleAgentAction(...args));\n  }\n\n  override handleGenerationStart(\n    ...args: Parameters<CallbackHandler['handleGenerationStart']>\n  ): ReturnType<CallbackHandler['handleGenerationStart']> {\n    return this.withRuntimeContext(() => super.handleGenerationStart(...args));\n  }\n\n  override handleChatModelStart(\n    ...args: Parameters<CallbackHandler['handleChatModelStart']>\n  ): ReturnType<CallbackHandler['handleChatModelStart']> {\n    return this.withRuntimeContext(() => super.handleChatModelStart(...args));\n  }\n\n  override handleLLMStart(\n    ...args: Parameters<CallbackHandler['handleLLMStart']>\n  ): ReturnType<CallbackHandler['handleLLMStart']> {\n    return this.withRuntimeContext(() => super.handleLLMStart(...args));\n  }\n\n  override handleToolStart(\n    ...args: Parameters<CallbackHandler['handleToolStart']>\n  ): ReturnType<CallbackHandler['handleToolStart']> {\n    return this.withRuntimeContext(() => super.handleToolStart(...args));\n  }\n\n  override handleRetrieverStart(\n    ...args: Parameters<CallbackHandler['handleRetrieverStart']>\n  ): ReturnType<CallbackHandler['handleRetrieverStart']> {\n    return this.withRuntimeContext(() => super.handleRetrieverStart(...args));\n  }\n}\n\nfunction hasLangfuseTracingConfig(langfuse?: t.LangfuseConfig): boolean {\n  return (\n    langfuse?.toolNodeTracing != null || langfuse?.toolOutputTracing != null\n  );\n}\n\nfunction hasLangfuseTraceAttributes(langfuse?: t.LangfuseConfig): boolean {\n  return (\n    Object.keys(createTraceMetadata(langfuse?.metadata ?? {})).length > 0 ||\n    Object.keys(\n      createLibreChatTraceAttributes(langfuse?.librechatTraceAttributes ?? {})\n    ).length > 0 ||\n    (mergeLangfuseTags(undefined, langfuse?.tags)?.length ?? 0) > 0\n  );\n}\n\nexport function hasLangfuseConfigCredentials(\n  langfuse?: t.LangfuseConfig\n): langfuse is t.LangfuseConfig & {\n  publicKey: string;\n  secretKey: string;\n} {\n  return (\n    langfuse != null &&\n    isPresent(langfuse.publicKey) &&\n    isPresent(langfuse.secretKey)\n  );\n}\n\nfunction hasLangfuseConfigBaseUrl(langfuse?: t.LangfuseConfig): boolean {\n  return isPresent(langfuse?.baseUrl);\n}\n\nexport function isExplicitLangfuseConfig(langfuse?: t.LangfuseConfig): boolean {\n  return (\n    langfuse?.enabled != null ||\n    isPresent(langfuse?.publicKey) ||\n    isPresent(langfuse?.secretKey) ||\n    isPresent(langfuse?.baseUrl) ||\n    hasLangfuseTraceAttributes(langfuse) ||\n    hasLangfuseTracingConfig(langfuse)\n  );\n}\n\nfunction createTraceMetadata(\n  metadata: Record<string, unknown>\n): LangfuseTraceMetadata {\n  const traceMetadata: LangfuseTraceMetadata = {};\n  for (const [key, value] of Object.entries(metadata)) {\n    if (value == null) {\n      continue;\n    }\n    const stringValue = typeof value === 'string' ? value : String(value);\n    if (\n      stringValue.trim() === '' ||\n      stringValue.length > TRACE_METADATA_MAX_LENGTH\n    ) {\n      continue;\n    }\n    traceMetadata[key] = stringValue;\n  }\n  return traceMetadata;\n}\n\nexport function createLibreChatTraceAttributes(\n  attributes: LangfuseConfigTraceAttributes\n): LangfuseTraceAttributes {\n  const librechatTraceAttributes: LangfuseTraceAttributes = {};\n  for (const [key, value] of Object.entries(attributes)) {\n    if (value == null || key.trim() === '') {\n      continue;\n    }\n    if (typeof value === 'string') {\n      if (value.trim() === '' || value.length > TRACE_METADATA_MAX_LENGTH) {\n        continue;\n      }\n      librechatTraceAttributes[key] = value;\n      continue;\n    }\n    librechatTraceAttributes[key] = value;\n  }\n  return librechatTraceAttributes;\n}\n\nexport function createLangfuseTraceMetadata({\n  messageId,\n  parentMessageId,\n  agentId,\n  agentName,\n}: {\n  messageId?: unknown;\n  parentMessageId?: unknown;\n  agentId?: unknown;\n  agentName?: unknown;\n}): LangfuseTraceMetadata {\n  return createTraceMetadata({\n    messageId,\n    parentMessageId,\n    agentId,\n    agentName,\n  });\n}\n\nfunction mergeLangfuseTraceMetadata(\n  traceMetadata?: LangfuseTraceMetadata,\n  metadata?: LangfuseMetadata\n): LangfuseTraceMetadata | undefined {\n  const merged = createTraceMetadata({\n    ...(metadata ?? {}),\n    ...(traceMetadata ?? {}),\n  });\n  return Object.keys(merged).length > 0 ? merged : undefined;\n}\n\nfunction mergeLangfuseTags(\n  tags?: string[],\n  configTags?: string[]\n): string[] | undefined {\n  const merged = [...(tags ?? []), ...(configTags ?? [])].filter(\n    (tag) => tag.trim() !== ''\n  );\n  return merged.length > 0 ? [...new Set(merged)] : undefined;\n}\n\nexport function getLangfuseTraceName(\n  traceMetadata?: LangfuseTraceMetadata,\n  fallback: string = 'LibreChat Agent'\n): string {\n  const agentName = traceMetadata?.agentName;\n  return isPresent(agentName) ? `${fallback}: ${agentName}` : fallback;\n}\n\nexport function hasLangfuseEnvConfig(): boolean {\n  return hasLangfuseEnvCredentials();\n}\n\nexport function hasLangfuseEnvCredentials(): boolean {\n  return (\n    isPresent(process.env.LANGFUSE_SECRET_KEY) &&\n    isPresent(process.env.LANGFUSE_PUBLIC_KEY)\n  );\n}\n\nexport function shouldCreateLangfuseHandler(\n  langfuse?: t.LangfuseConfig\n): boolean {\n  if (langfuse?.enabled === false) {\n    return false;\n  }\n  return (\n    hasLangfuseEnvConfig() ||\n    hasLangfuseConfigCredentials(langfuse) ||\n    (hasLangfuseConfigBaseUrl(langfuse) && hasLangfuseEnvCredentials())\n  );\n}\n\nexport function createLegacyLangfuseHandler(\n  params: LangfuseHandlerParams\n): CallbackHandler {\n  return new ScopedLangfuseCallbackHandler(params);\n}\n\nexport function createLangfuseHandler({\n  langfuse,\n  userId,\n  sessionId,\n  traceMetadata,\n  tags,\n  traceIdSeed,\n}: AgentLangfuseHandlerParams): CallbackHandler | undefined {\n  if (!shouldCreateLangfuseHandler(langfuse)) {\n    return undefined;\n  }\n  return new ScopedLangfuseCallbackHandler({\n    userId,\n    sessionId,\n    traceMetadata: mergeLangfuseTraceMetadata(\n      traceMetadata,\n      langfuse?.metadata\n    ),\n    tags: mergeLangfuseTags(tags, langfuse?.tags),\n    langfuse,\n    traceIdSeed,\n  });\n}\n\nfunction createPropagateAttributeParams({\n  langfuse,\n  userId,\n  sessionId,\n  traceMetadata,\n  traceName,\n  tags,\n}: LangfuseAttributeParams): PropagateAttributesParams {\n  return {\n    userId,\n    sessionId,\n    traceName,\n    tags: mergeLangfuseTags(tags, langfuse?.tags),\n    metadata: mergeLangfuseTraceMetadata(traceMetadata, langfuse?.metadata),\n  };\n}\n\nexport function withLangfuseAttributes<T>(\n  params: LangfuseAttributeParams,\n  action: () => T\n): T {\n  if (!shouldCreateLangfuseHandler(params.langfuse)) {\n    return action();\n  }\n  return propagateAttributes(createPropagateAttributeParams(params), action);\n}\n\nexport function hasExplicitLangfuseConfig(\n  contexts: Iterable<{ langfuse?: t.LangfuseConfig }>\n): boolean {\n  for (const context of contexts) {\n    if (isExplicitLangfuseConfig(context.langfuse)) {\n      return true;\n    }\n  }\n  return false;\n}\n\nexport function isLangfuseCallbackHandler(value: unknown): boolean {\n  return value instanceof CallbackHandler;\n}\n\nexport async function disposeLangfuseHandler(value: unknown): Promise<void> {\n  if (\n    value == null ||\n    !parseBooleanEnv(process.env[LANGFUSE_FORCE_FLUSH_ON_DISPOSE])\n  ) {\n    return;\n  }\n  const provider = getLangfuseTracerProvider() as FlushableTracerProvider;\n  await provider.forceFlush?.();\n}\n"],"mappings":";;;;;;AAeA,MAAM,4BAA4B;AAClC,MAAM,kCAAkC;AA6BxC,IAAM,gCAAN,cAA4C,gBAAgB;CAC1D;CACA;CAEA,YAAY,QAAqC;EAC/C,MAAM,EAAE,UAAU,aAAa,GAAG,kBAAkB,UAAU,CAAC;EAC/D,MAAM,aAAa;EACnB,KAAK,WAAW;EAChB,KAAK,cAAc;CACrB;CAEA,4BAAwD;EACtD,OAAO,KAAK,UAAU,yBAAyB,OAC3C,KAAK,cACL,KAAA;CACN;CAEA,mBAA8B,QAAoB;EAChD,MAAM,gBAAgBA,QAAY,OAAO;EACzC,MAAM,WACJ,6BAA6B,aAAa,KAAK,KAAK;EACtD,MAAM,OAAO,KAAK,0BAA0B;EAC5C,OAAO,yBACL;GACE;GACA,aAAa,0BAA0B,aAAa,KAAK;EAC3D,GACA,MACF;CACF;CAKA,iBACE,GAAG,MAC8C;EACjD,OAAO,KAAK,yBAAyB,MAAM,iBAAiB,GAAG,IAAI,CAAC;CACtE;CAEA,kBACE,GAAG,MAC+C;EAClD,OAAO,KAAK,yBAAyB,MAAM,kBAAkB,GAAG,IAAI,CAAC;CACvE;CAEA,sBACE,GAAG,MACmD;EACtD,OAAO,KAAK,yBAAyB,MAAM,sBAAsB,GAAG,IAAI,CAAC;CAC3E;CAEA,qBACE,GAAG,MACkD;EACrD,OAAO,KAAK,yBAAyB,MAAM,qBAAqB,GAAG,IAAI,CAAC;CAC1E;CAEA,eACE,GAAG,MAC4C;EAC/C,OAAO,KAAK,yBAAyB,MAAM,eAAe,GAAG,IAAI,CAAC;CACpE;CAEA,gBACE,GAAG,MAC6C;EAChD,OAAO,KAAK,yBAAyB,MAAM,gBAAgB,GAAG,IAAI,CAAC;CACrE;CAEA,qBACE,GAAG,MACkD;EACrD,OAAO,KAAK,yBAAyB,MAAM,qBAAqB,GAAG,IAAI,CAAC;CAC1E;AACF;AAkBA,SAAgB,6BACd,UAIA;CACA,OACE,YAAY,QACZ,UAAU,SAAS,SAAS,KAC5B,UAAU,SAAS,SAAS;AAEhC;AAEA,SAAS,yBAAyB,UAAsC;CACtE,OAAO,UAAU,UAAU,OAAO;AACpC;AAaA,SAAS,oBACP,UACuB;CACvB,MAAM,gBAAuC,CAAC;CAC9C,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,GAAG;EACnD,IAAI,SAAS,MACX;EAEF,MAAM,cAAc,OAAO,UAAU,WAAW,QAAQ,OAAO,KAAK;EACpE,IACE,YAAY,KAAK,MAAM,MACvB,YAAY,SAAS,2BAErB;EAEF,cAAc,OAAO;CACvB;CACA,OAAO;AACT;AAEA,SAAgB,+BACd,YACyB;CACzB,MAAM,2BAAoD,CAAC;CAC3D,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,UAAU,GAAG;EACrD,IAAI,SAAS,QAAQ,IAAI,KAAK,MAAM,IAClC;EAEF,IAAI,OAAO,UAAU,UAAU;GAC7B,IAAI,MAAM,KAAK,MAAM,MAAM,MAAM,SAAS,2BACxC;GAEF,yBAAyB,OAAO;GAChC;EACF;EACA,yBAAyB,OAAO;CAClC;CACA,OAAO;AACT;AAEA,SAAgB,4BAA4B,EAC1C,WACA,iBACA,SACA,aAMwB;CACxB,OAAO,oBAAoB;EACzB;EACA;EACA;EACA;CACF,CAAC;AACH;AAEA,SAAS,2BACP,eACA,UACmC;CACnC,MAAM,SAAS,oBAAoB;EACjC,GAAI,YAAY,CAAC;EACjB,GAAI,iBAAiB,CAAC;CACxB,CAAC;CACD,OAAO,OAAO,KAAK,MAAM,CAAC,CAAC,SAAS,IAAI,SAAS,KAAA;AACnD;AAEA,SAAS,kBACP,MACA,YACsB;CACtB,MAAM,SAAS,CAAC,GAAI,QAAQ,CAAC,GAAI,GAAI,cAAc,CAAC,CAAE,CAAC,CAAC,QACrD,QAAQ,IAAI,KAAK,MAAM,EAC1B;CACA,OAAO,OAAO,SAAS,IAAI,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,IAAI,KAAA;AACpD;AAEA,SAAgB,qBACd,eACA,WAAmB,mBACX;CACR,MAAM,YAAY,eAAe;CACjC,OAAO,UAAU,SAAS,IAAI,GAAG,SAAS,IAAI,cAAc;AAC9D;AAEA,SAAgB,uBAAgC;CAC9C,OAAO,0BAA0B;AACnC;AAEA,SAAgB,4BAAqC;CACnD,OACE,UAAU,QAAQ,IAAI,mBAAmB,KACzC,UAAU,QAAQ,IAAI,mBAAmB;AAE7C;AAEA,SAAgB,4BACd,UACS;CACT,IAAI,UAAU,YAAY,OACxB,OAAO;CAET,OACE,qBAAqB,KACrB,6BAA6B,QAAQ,KACpC,yBAAyB,QAAQ,KAAK,0BAA0B;AAErE;AAQA,SAAgB,sBAAsB,EACpC,UACA,QACA,WACA,eACA,MACA,eAC0D;CAC1D,IAAI,CAAC,4BAA4B,QAAQ,GACvC;CAEF,OAAO,IAAI,8BAA8B;EACvC;EACA;EACA,eAAe,2BACb,eACA,UAAU,QACZ;EACA,MAAM,kBAAkB,MAAM,UAAU,IAAI;EAC5C;EACA;CACF,CAAC;AACH;AAEA,SAAS,+BAA+B,EACtC,UACA,QACA,WACA,eACA,WACA,QACqD;CACrD,OAAO;EACL;EACA;EACA;EACA,MAAM,kBAAkB,MAAM,UAAU,IAAI;EAC5C,UAAU,2BAA2B,eAAe,UAAU,QAAQ;CACxE;AACF;AAEA,SAAgB,uBACd,QACA,QACG;CACH,IAAI,CAAC,4BAA4B,OAAO,QAAQ,GAC9C,OAAO,OAAO;CAEhB,OAAO,oBAAoB,+BAA+B,MAAM,GAAG,MAAM;AAC3E;AAaA,SAAgB,0BAA0B,OAAyB;CACjE,OAAO,iBAAiB;AAC1B;AAEA,eAAsB,uBAAuB,OAA+B;CAC1E,IACE,SAAS,QACT,CAAC,gBAAgB,QAAQ,IAAI,gCAAgC,GAE7D;CAGF,MADiB,0BACJ,CAAC,CAAC,aAAa;AAC9B"}

package/dist/esm/langfuseConfig.mjs

@@ -0,0 +1,102 @@
+import { parseBooleanEnv } from "./utils/misc.mjs";
+//#region src/langfuseConfig.ts
+const LANGFUSE_TOOL_OUTPUT_REDACTION_TEXT = "[tool output redacted]";
+function isPresent(value) {
+	return typeof value === "string" && value.trim() !== "";
+}
+function normalizeToolName(name) {
+	return name.trim().toLowerCase();
+}
+function normalizeToolNames(names) {
+	const normalized = /* @__PURE__ */ new Set();
+	for (const name of names ?? []) if (isPresent(name)) normalized.add(normalizeToolName(name));
+	return normalized;
+}
+function parseToolNames(value) {
+	if (!isPresent(value)) return;
+	return value.split(",").map((name) => name.trim()).filter((name) => name !== "");
+}
+function getEnvToolOutputTracingEnabled() {
+	const traceToolOutputs = parseBooleanEnv(process.env.LANGFUSE_TRACE_TOOL_OUTPUTS);
+	if (traceToolOutputs != null) return traceToolOutputs;
+	const redactToolOutputs = parseBooleanEnv(process.env.LANGFUSE_REDACT_TOOL_OUTPUTS);
+	if (redactToolOutputs != null) return !redactToolOutputs;
+	return parseBooleanEnv(process.env.LANGFUSE_TOOL_OUTPUT_TRACING_ENABLED);
+}
+function getEnvRedactedToolNames() {
+	return parseToolNames(process.env.LANGFUSE_REDACT_TOOL_OUTPUT_NAMES) ?? parseToolNames(process.env.LANGFUSE_REDACT_TOOL_NAMES);
+}
+function getEnvRedactionText() {
+	return isPresent(process.env.LANGFUSE_TOOL_OUTPUT_REDACTION_TEXT) ? process.env.LANGFUSE_TOOL_OUTPUT_REDACTION_TEXT : void 0;
+}
+function getEnvToolNameMatchMode() {
+	const mode = (process.env.LANGFUSE_REDACT_TOOL_OUTPUT_NAME_MATCH_MODE ?? process.env.LANGFUSE_REDACT_TOOL_NAME_MATCH_MODE)?.trim().toLowerCase();
+	if (mode === "exact" || mode === "partial") return mode;
+}
+function hasEnvToolOutputTracingConfig() {
+	return getEnvToolOutputTracingEnabled() != null || getEnvRedactedToolNames() != null || getEnvRedactionText() != null || getEnvToolNameMatchMode() != null;
+}
+function resolveToolOutputTracingEnabled(runConfig, agentConfig) {
+	return agentConfig?.enabled ?? runConfig?.enabled ?? getEnvToolOutputTracingEnabled() ?? true;
+}
+function resolveRedactedToolNames(runConfig, agentConfig) {
+	return normalizeToolNames([
+		...getEnvRedactedToolNames() ?? [],
+		...runConfig?.redactedToolNames ?? [],
+		...agentConfig?.redactedToolNames ?? []
+	]);
+}
+function resolveToolNameMatchMode(runConfig, agentConfig) {
+	return [
+		getEnvToolNameMatchMode(),
+		runConfig?.redactedToolNameMatchMode,
+		agentConfig?.redactedToolNameMatchMode
+	].includes("partial") ? "partial" : "exact";
+}
+function hasToolOutputTracingConfig(runLangfuse, agentLangfuse) {
+	return runLangfuse?.toolOutputTracing != null || agentLangfuse?.toolOutputTracing != null || hasEnvToolOutputTracingConfig();
+}
+function resolveToolOutputTracingConfig(runLangfuse, agentLangfuse) {
+	const runConfig = runLangfuse?.toolOutputTracing;
+	const agentConfig = agentLangfuse?.toolOutputTracing;
+	return {
+		enabled: resolveToolOutputTracingEnabled(runConfig, agentConfig),
+		redactedToolNames: resolveRedactedToolNames(runConfig, agentConfig),
+		redactedToolNameMatchMode: resolveToolNameMatchMode(runConfig, agentConfig),
+		redactionText: agentConfig?.redactionText ?? runConfig?.redactionText ?? getEnvRedactionText() ?? "[tool output redacted]"
+	};
+}
+function resolveLangfuseConfig(runLangfuse, agentLangfuse) {
+	if (runLangfuse == null) return agentLangfuse;
+	if (agentLangfuse == null) return runLangfuse;
+	const toolNodeTracing = runLangfuse.toolNodeTracing != null || agentLangfuse.toolNodeTracing != null ? {
+		...runLangfuse.toolNodeTracing,
+		...agentLangfuse.toolNodeTracing
+	} : void 0;
+	const toolOutputTracing = runLangfuse.toolOutputTracing != null || agentLangfuse.toolOutputTracing != null ? {
+		...runLangfuse.toolOutputTracing,
+		...agentLangfuse.toolOutputTracing
+	} : void 0;
+	const metadata = runLangfuse.metadata != null || agentLangfuse.metadata != null ? {
+		...runLangfuse.metadata,
+		...agentLangfuse.metadata
+	} : void 0;
+	const librechatTraceAttributes = runLangfuse.librechatTraceAttributes != null || agentLangfuse.librechatTraceAttributes != null ? {
+		...runLangfuse.librechatTraceAttributes,
+		...agentLangfuse.librechatTraceAttributes
+	} : void 0;
+	const tags = runLangfuse.tags != null || agentLangfuse.tags != null ? [...new Set([...runLangfuse.tags ?? [], ...agentLangfuse.tags ?? []])] : void 0;
+	return {
+		...runLangfuse,
+		...agentLangfuse,
+		...metadata != null ? { metadata } : {},
+		...librechatTraceAttributes != null ? { librechatTraceAttributes } : {},
+		...tags != null ? { tags } : {},
+		...toolNodeTracing != null ? { toolNodeTracing } : {},
+		...toolOutputTracing != null ? { toolOutputTracing } : {}
+	};
+}
+//#endregion
+export { LANGFUSE_TOOL_OUTPUT_REDACTION_TEXT, hasToolOutputTracingConfig, normalizeToolName, resolveLangfuseConfig, resolveToolOutputTracingConfig };
+
+//# sourceMappingURL=langfuseConfig.mjs.map

package/dist/esm/langfuseConfig.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"langfuseConfig.mjs","names":[],"sources":["../../src/langfuseConfig.ts"],"sourcesContent":["import type { ResolvedLangfuseToolOutputTracingConfig } from '@/langfuseRuntimeContext';\nimport type * as t from '@/types';\nimport { parseBooleanEnv } from '@/utils/misc';\n\nexport const LANGFUSE_TOOL_OUTPUT_REDACTION_TEXT = '[tool output redacted]';\n\nfunction isPresent(value: unknown): value is string {\n  return typeof value === 'string' && value.trim() !== '';\n}\n\nexport function normalizeToolName(name: string): string {\n  return name.trim().toLowerCase();\n}\n\nfunction normalizeToolNames(names: string[] | undefined): Set<string> {\n  const normalized = new Set<string>();\n  for (const name of names ?? []) {\n    if (isPresent(name)) {\n      normalized.add(normalizeToolName(name));\n    }\n  }\n  return normalized;\n}\n\nfunction parseToolNames(value: string | undefined): string[] | undefined {\n  if (!isPresent(value)) {\n    return undefined;\n  }\n\n  return value\n    .split(',')\n    .map((name) => name.trim())\n    .filter((name) => name !== '');\n}\n\nfunction getEnvToolOutputTracingEnabled(): boolean | undefined {\n  const traceToolOutputs = parseBooleanEnv(\n    process.env.LANGFUSE_TRACE_TOOL_OUTPUTS\n  );\n  if (traceToolOutputs != null) {\n    return traceToolOutputs;\n  }\n\n  const redactToolOutputs = parseBooleanEnv(\n    process.env.LANGFUSE_REDACT_TOOL_OUTPUTS\n  );\n  if (redactToolOutputs != null) {\n    return !redactToolOutputs;\n  }\n\n  return parseBooleanEnv(process.env.LANGFUSE_TOOL_OUTPUT_TRACING_ENABLED);\n}\n\nfunction getEnvRedactedToolNames(): string[] | undefined {\n  return (\n    parseToolNames(process.env.LANGFUSE_REDACT_TOOL_OUTPUT_NAMES) ??\n    parseToolNames(process.env.LANGFUSE_REDACT_TOOL_NAMES)\n  );\n}\n\nfunction getEnvRedactionText(): string | undefined {\n  return isPresent(process.env.LANGFUSE_TOOL_OUTPUT_REDACTION_TEXT)\n    ? process.env.LANGFUSE_TOOL_OUTPUT_REDACTION_TEXT\n    : undefined;\n}\n\nfunction getEnvToolNameMatchMode(): 'exact' | 'partial' | undefined {\n  const mode = (\n    process.env.LANGFUSE_REDACT_TOOL_OUTPUT_NAME_MATCH_MODE ??\n    process.env.LANGFUSE_REDACT_TOOL_NAME_MATCH_MODE\n  )\n    ?.trim()\n    .toLowerCase();\n  if (mode === 'exact' || mode === 'partial') {\n    return mode;\n  }\n  return undefined;\n}\n\nfunction hasEnvToolOutputTracingConfig(): boolean {\n  return (\n    getEnvToolOutputTracingEnabled() != null ||\n    getEnvRedactedToolNames() != null ||\n    getEnvRedactionText() != null ||\n    getEnvToolNameMatchMode() != null\n  );\n}\n\nfunction resolveToolOutputTracingEnabled(\n  runConfig?: t.LangfuseToolOutputTracingConfig,\n  agentConfig?: t.LangfuseToolOutputTracingConfig\n): boolean {\n  return (\n    agentConfig?.enabled ??\n    runConfig?.enabled ??\n    getEnvToolOutputTracingEnabled() ??\n    true\n  );\n}\n\nfunction resolveRedactedToolNames(\n  runConfig?: t.LangfuseToolOutputTracingConfig,\n  agentConfig?: t.LangfuseToolOutputTracingConfig\n): Set<string> {\n  return normalizeToolNames([\n    ...(getEnvRedactedToolNames() ?? []),\n    ...(runConfig?.redactedToolNames ?? []),\n    ...(agentConfig?.redactedToolNames ?? []),\n  ]);\n}\n\nfunction resolveToolNameMatchMode(\n  runConfig?: t.LangfuseToolOutputTracingConfig,\n  agentConfig?: t.LangfuseToolOutputTracingConfig\n): 'exact' | 'partial' {\n  const modes = [\n    getEnvToolNameMatchMode(),\n    runConfig?.redactedToolNameMatchMode,\n    agentConfig?.redactedToolNameMatchMode,\n  ];\n  return modes.includes('partial') ? 'partial' : 'exact';\n}\n\nexport function hasToolOutputTracingConfig(\n  runLangfuse?: t.LangfuseConfig,\n  agentLangfuse?: t.LangfuseConfig\n): boolean {\n  return (\n    runLangfuse?.toolOutputTracing != null ||\n    agentLangfuse?.toolOutputTracing != null ||\n    hasEnvToolOutputTracingConfig()\n  );\n}\n\nexport function resolveToolOutputTracingConfig(\n  runLangfuse?: t.LangfuseConfig,\n  agentLangfuse?: t.LangfuseConfig\n): ResolvedLangfuseToolOutputTracingConfig {\n  const runConfig = runLangfuse?.toolOutputTracing;\n  const agentConfig = agentLangfuse?.toolOutputTracing;\n\n  return {\n    enabled: resolveToolOutputTracingEnabled(runConfig, agentConfig),\n    redactedToolNames: resolveRedactedToolNames(runConfig, agentConfig),\n    redactedToolNameMatchMode: resolveToolNameMatchMode(runConfig, agentConfig),\n    redactionText:\n      agentConfig?.redactionText ??\n      runConfig?.redactionText ??\n      getEnvRedactionText() ??\n      LANGFUSE_TOOL_OUTPUT_REDACTION_TEXT,\n  };\n}\n\nexport function resolveLangfuseConfig(\n  runLangfuse?: t.LangfuseConfig,\n  agentLangfuse?: t.LangfuseConfig\n): t.LangfuseConfig | undefined {\n  if (runLangfuse == null) {\n    return agentLangfuse;\n  }\n  if (agentLangfuse == null) {\n    return runLangfuse;\n  }\n\n  const toolNodeTracing =\n    runLangfuse.toolNodeTracing != null || agentLangfuse.toolNodeTracing != null\n      ? {\n        ...runLangfuse.toolNodeTracing,\n        ...agentLangfuse.toolNodeTracing,\n      }\n      : undefined;\n  const toolOutputTracing =\n    runLangfuse.toolOutputTracing != null ||\n    agentLangfuse.toolOutputTracing != null\n      ? {\n        ...runLangfuse.toolOutputTracing,\n        ...agentLangfuse.toolOutputTracing,\n      }\n      : undefined;\n  const metadata =\n    runLangfuse.metadata != null || agentLangfuse.metadata != null\n      ? {\n        ...runLangfuse.metadata,\n        ...agentLangfuse.metadata,\n      }\n      : undefined;\n  const librechatTraceAttributes =\n    runLangfuse.librechatTraceAttributes != null ||\n    agentLangfuse.librechatTraceAttributes != null\n      ? {\n        ...runLangfuse.librechatTraceAttributes,\n        ...agentLangfuse.librechatTraceAttributes,\n      }\n      : undefined;\n  const tags =\n    runLangfuse.tags != null || agentLangfuse.tags != null\n      ? [\n        ...new Set([\n          ...(runLangfuse.tags ?? []),\n          ...(agentLangfuse.tags ?? []),\n        ]),\n      ]\n      : undefined;\n\n  return {\n    ...runLangfuse,\n    ...agentLangfuse,\n    ...(metadata != null ? { metadata } : {}),\n    ...(librechatTraceAttributes != null ? { librechatTraceAttributes } : {}),\n    ...(tags != null ? { tags } : {}),\n    ...(toolNodeTracing != null ? { toolNodeTracing } : {}),\n    ...(toolOutputTracing != null ? { toolOutputTracing } : {}),\n  };\n}\n"],"mappings":"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"}

package/dist/esm/langfuseRuntimeContext.mjs

@@ -0,0 +1,44 @@
+import { createHash } from "node:crypto";
+import { AsyncLocalStorage } from "node:async_hooks";
+//#region src/langfuseRuntimeContext.ts
+const langfuseRuntimeContextStore = new AsyncLocalStorage();
+function hasText(value) {
+	return value != null && value.trim() !== "";
+}
+function hasLangfuseRuntimeContextValue(context) {
+	return context.langfuse != null || hasText(context.traceIdSeed) || context.toolOutputTracing != null;
+}
+/** sha256(seed) -> first 32 hex chars; matches `@langfuse/tracing` `createTraceId`. */
+function traceIdFromSeed(seed) {
+	return createHash("sha256").update(seed, "utf8").digest("hex").slice(0, 32);
+}
+function getLangfuseRuntimeContext() {
+	return langfuseRuntimeContextStore.getStore();
+}
+function getLangfuseRuntimeConfig() {
+	return getLangfuseRuntimeContext()?.langfuse;
+}
+function getTraceIdSeed() {
+	return getLangfuseRuntimeContext()?.traceIdSeed;
+}
+function getLangfuseRuntimeToolOutputTracingConfig() {
+	return getLangfuseRuntimeContext()?.toolOutputTracing;
+}
+/**
+* Runs `fn` with a merged Langfuse runtime context. Undefined fields inherit
+* from the parent scope; callers intentionally cannot clear parent values by
+* passing `undefined`.
+*/
+function runWithLangfuseRuntimeContext(context, fn) {
+	const next = {
+		...getLangfuseRuntimeContext() ?? {},
+		...context.langfuse !== void 0 ? { langfuse: context.langfuse } : {},
+		...hasText(context.traceIdSeed) ? { traceIdSeed: context.traceIdSeed } : {},
+		...context.toolOutputTracing !== void 0 ? { toolOutputTracing: context.toolOutputTracing } : {}
+	};
+	return hasLangfuseRuntimeContextValue(next) ? langfuseRuntimeContextStore.run(next, fn) : fn();
+}
+//#endregion
+export { getLangfuseRuntimeConfig, getLangfuseRuntimeToolOutputTracingConfig, getTraceIdSeed, hasLangfuseRuntimeContextValue, runWithLangfuseRuntimeContext, traceIdFromSeed };
+
+//# sourceMappingURL=langfuseRuntimeContext.mjs.map

package/dist/esm/langfuseRuntimeContext.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"langfuseRuntimeContext.mjs","names":[],"sources":["../../src/langfuseRuntimeContext.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { AsyncLocalStorage } from 'node:async_hooks';\nimport type * as t from '@/types';\n\nexport type ResolvedLangfuseToolOutputTracingConfig = {\n  enabled: boolean;\n  redactedToolNames: Set<string>;\n  redactedToolNameMatchMode: 'exact' | 'partial';\n  redactionText: string;\n};\n\nexport type LangfuseRuntimeContext = {\n  langfuse?: t.LangfuseConfig;\n  traceIdSeed?: string;\n  toolOutputTracing?: ResolvedLangfuseToolOutputTracingConfig;\n};\n\nconst langfuseRuntimeContextStore =\n  new AsyncLocalStorage<LangfuseRuntimeContext>();\n\nfunction hasText(value: string | undefined): value is string {\n  return value != null && value.trim() !== '';\n}\n\nexport function hasLangfuseRuntimeContextValue(\n  context: LangfuseRuntimeContext\n): boolean {\n  return (\n    context.langfuse != null ||\n    hasText(context.traceIdSeed) ||\n    context.toolOutputTracing != null\n  );\n}\n\n/** sha256(seed) -> first 32 hex chars; matches `@langfuse/tracing` `createTraceId`. */\nexport function traceIdFromSeed(seed: string): string {\n  return createHash('sha256').update(seed, 'utf8').digest('hex').slice(0, 32);\n}\n\nexport function getLangfuseRuntimeContext():\n  | LangfuseRuntimeContext\n  | undefined {\n  return langfuseRuntimeContextStore.getStore();\n}\n\nexport function getLangfuseRuntimeConfig(): t.LangfuseConfig | undefined {\n  return getLangfuseRuntimeContext()?.langfuse;\n}\n\nexport function getTraceIdSeed(): string | undefined {\n  return getLangfuseRuntimeContext()?.traceIdSeed;\n}\n\nexport function getLangfuseRuntimeToolOutputTracingConfig():\n  | ResolvedLangfuseToolOutputTracingConfig\n  | undefined {\n  return getLangfuseRuntimeContext()?.toolOutputTracing;\n}\n\n/**\n * Runs `fn` with a merged Langfuse runtime context. Undefined fields inherit\n * from the parent scope; callers intentionally cannot clear parent values by\n * passing `undefined`.\n */\nexport function runWithLangfuseRuntimeContext<T>(\n  context: LangfuseRuntimeContext,\n  fn: () => T\n): T {\n  const current = getLangfuseRuntimeContext();\n  const next = {\n    ...(current ?? {}),\n    ...(context.langfuse !== undefined ? { langfuse: context.langfuse } : {}),\n    ...(hasText(context.traceIdSeed)\n      ? { traceIdSeed: context.traceIdSeed }\n      : {}),\n    ...(context.toolOutputTracing !== undefined\n      ? { toolOutputTracing: context.toolOutputTracing }\n      : {}),\n  };\n\n  return hasLangfuseRuntimeContextValue(next)\n    ? langfuseRuntimeContextStore.run(next, fn)\n    : fn();\n}\n\nexport function runWithTraceIdSeed<T>(\n  seed: string | undefined,\n  fn: () => T\n): T {\n  return hasText(seed)\n    ? runWithLangfuseRuntimeContext({ traceIdSeed: seed }, fn)\n    : fn();\n}\n"],"mappings":";;;AAiBA,MAAM,8BACJ,IAAI,kBAA0C;AAEhD,SAAS,QAAQ,OAA4C;CAC3D,OAAO,SAAS,QAAQ,MAAM,KAAK,MAAM;AAC3C;AAEA,SAAgB,+BACd,SACS;CACT,OACE,QAAQ,YAAY,QACpB,QAAQ,QAAQ,WAAW,KAC3B,QAAQ,qBAAqB;AAEjC;;AAGA,SAAgB,gBAAgB,MAAsB;CACpD,OAAO,WAAW,QAAQ,CAAC,CAAC,OAAO,MAAM,MAAM,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,GAAG,EAAE;AAC5E;AAEA,SAAgB,4BAEF;CACZ,OAAO,4BAA4B,SAAS;AAC9C;AAEA,SAAgB,2BAAyD;CACvE,OAAO,0BAA0B,CAAC,EAAE;AACtC;AAEA,SAAgB,iBAAqC;CACnD,OAAO,0BAA0B,CAAC,EAAE;AACtC;AAEA,SAAgB,4CAEF;CACZ,OAAO,0BAA0B,CAAC,EAAE;AACtC;;;;;;AAOA,SAAgB,8BACd,SACA,IACG;CAEH,MAAM,OAAO;EACX,GAFc,0BAEJ,KAAK,CAAC;EAChB,GAAI,QAAQ,aAAa,KAAA,IAAY,EAAE,UAAU,QAAQ,SAAS,IAAI,CAAC;EACvE,GAAI,QAAQ,QAAQ,WAAW,IAC3B,EAAE,aAAa,QAAQ,YAAY,IACnC,CAAC;EACL,GAAI,QAAQ,sBAAsB,KAAA,IAC9B,EAAE,mBAAmB,QAAQ,kBAAkB,IAC/C,CAAC;CACP;CAEA,OAAO,+BAA+B,IAAI,IACtC,4BAA4B,IAAI,MAAM,EAAE,IACxC,GAAG;AACT"}

package/dist/esm/langfuseRuntimeScope.mjs

@@ -0,0 +1,53 @@
+import { getLangfuseRuntimeConfig, getLangfuseRuntimeToolOutputTracingConfig, getTraceIdSeed, hasLangfuseRuntimeContextValue, runWithLangfuseRuntimeContext } from "./langfuseRuntimeContext.mjs";
+import { hasToolOutputTracingConfig, resolveLangfuseConfig, resolveToolOutputTracingConfig } from "./langfuseConfig.mjs";
+import { context, createContextKey } from "@opentelemetry/api";
+//#region src/langfuseRuntimeScope.ts
+const langfuseToolOutputTracingConfigKey = createContextKey("librechat.langfuse.tool-output-tracing");
+const langfuseConfigKey = createContextKey("librechat.langfuse.config");
+const langfuseTraceIdSeedKey = createContextKey("librechat.langfuse.trace-id-seed");
+function isRecord(value) {
+	return value != null && typeof value === "object" && !Array.isArray(value);
+}
+function hasText(value) {
+	return value != null && value.trim() !== "";
+}
+function getOtelLangfuseConfig(activeContext) {
+	const value = activeContext.getValue(langfuseConfigKey);
+	return isRecord(value) ? value : void 0;
+}
+function getOtelTraceIdSeed(activeContext) {
+	const value = activeContext.getValue(langfuseTraceIdSeedKey);
+	return typeof value === "string" && value.trim() !== "" ? value : void 0;
+}
+function getOtelToolOutputTracingConfig(activeContext) {
+	const value = activeContext.getValue(langfuseToolOutputTracingConfigKey);
+	return isRecord(value) ? value : void 0;
+}
+function resolveLangfuseConfigForSpan(activeContext) {
+	return getLangfuseRuntimeConfig() ?? getOtelLangfuseConfig(activeContext);
+}
+function resolveTraceIdSeedForSpan(activeContext) {
+	return getTraceIdSeed() ?? getOtelTraceIdSeed(activeContext);
+}
+function resolveToolOutputTracingConfigForSpan(activeContext) {
+	return getLangfuseRuntimeToolOutputTracingConfig() ?? getOtelToolOutputTracingConfig(activeContext);
+}
+function withLangfuseRuntimeScope(scope, action) {
+	if (!hasLangfuseRuntimeContextValue(scope)) return action();
+	let activeContext = context.active();
+	if (scope.langfuse != null) activeContext = activeContext.setValue(langfuseConfigKey, scope.langfuse);
+	if (scope.toolOutputTracing != null) activeContext = activeContext.setValue(langfuseToolOutputTracingConfigKey, scope.toolOutputTracing);
+	if (hasText(scope.traceIdSeed)) activeContext = activeContext.setValue(langfuseTraceIdSeedKey, scope.traceIdSeed);
+	return runWithLangfuseRuntimeContext(scope, () => context.with(activeContext, action));
+}
+function resolveLangfuseRuntimeScope({ runLangfuse, langfuseOverlay, traceIdSeed }) {
+	return {
+		langfuse: resolveLangfuseConfig(runLangfuse, langfuseOverlay),
+		traceIdSeed,
+		toolOutputTracing: !hasToolOutputTracingConfig(runLangfuse, langfuseOverlay) ? void 0 : resolveToolOutputTracingConfig(runLangfuse, langfuseOverlay)
+	};
+}
+//#endregion
+export { resolveLangfuseConfigForSpan, resolveLangfuseRuntimeScope, resolveToolOutputTracingConfigForSpan, resolveTraceIdSeedForSpan, withLangfuseRuntimeScope };
+
+//# sourceMappingURL=langfuseRuntimeScope.mjs.map

package/dist/esm/langfuseRuntimeScope.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"langfuseRuntimeScope.mjs","names":[],"sources":["../../src/langfuseRuntimeScope.ts"],"sourcesContent":["import { context, createContextKey } from '@opentelemetry/api';\nimport type { Context } from '@opentelemetry/api';\nimport type {\n  LangfuseRuntimeContext,\n  ResolvedLangfuseToolOutputTracingConfig,\n} from '@/langfuseRuntimeContext';\nimport type * as t from '@/types';\nimport {\n  getLangfuseRuntimeConfig,\n  getLangfuseRuntimeToolOutputTracingConfig,\n  getTraceIdSeed,\n  hasLangfuseRuntimeContextValue,\n  runWithLangfuseRuntimeContext,\n} from '@/langfuseRuntimeContext';\nimport {\n  hasToolOutputTracingConfig,\n  resolveLangfuseConfig,\n  resolveToolOutputTracingConfig,\n} from '@/langfuseConfig';\n\nexport type LangfuseRuntimeScope = LangfuseRuntimeContext;\n\nexport type ResolveLangfuseRuntimeScopeParams = {\n  runLangfuse?: t.LangfuseConfig;\n  langfuseOverlay?: t.LangfuseConfig;\n  traceIdSeed?: string;\n};\n\nconst langfuseToolOutputTracingConfigKey = createContextKey(\n  'librechat.langfuse.tool-output-tracing'\n);\nconst langfuseConfigKey = createContextKey('librechat.langfuse.config');\nconst langfuseTraceIdSeedKey = createContextKey(\n  'librechat.langfuse.trace-id-seed'\n);\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value != null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction hasText(value: string | undefined): value is string {\n  return value != null && value.trim() !== '';\n}\n\nexport function getOtelLangfuseConfig(\n  activeContext: Context\n): t.LangfuseConfig | undefined {\n  const value = activeContext.getValue(langfuseConfigKey);\n  return isRecord(value) ? (value as t.LangfuseConfig) : undefined;\n}\n\nexport function getOtelTraceIdSeed(activeContext: Context): string | undefined {\n  const value = activeContext.getValue(langfuseTraceIdSeedKey);\n  return typeof value === 'string' && value.trim() !== '' ? value : undefined;\n}\n\nexport function getOtelToolOutputTracingConfig(\n  activeContext: Context\n): ResolvedLangfuseToolOutputTracingConfig | undefined {\n  const value = activeContext.getValue(langfuseToolOutputTracingConfigKey);\n  return isRecord(value)\n    ? (value as ResolvedLangfuseToolOutputTracingConfig)\n    : undefined;\n}\n\nexport function resolveLangfuseConfigForSpan(\n  activeContext: Context\n): t.LangfuseConfig | undefined {\n  return getLangfuseRuntimeConfig() ?? getOtelLangfuseConfig(activeContext);\n}\n\nexport function resolveTraceIdSeedForSpan(\n  activeContext: Context\n): string | undefined {\n  return getTraceIdSeed() ?? getOtelTraceIdSeed(activeContext);\n}\n\nexport function resolveToolOutputTracingConfigForSpan(\n  activeContext: Context\n): ResolvedLangfuseToolOutputTracingConfig | undefined {\n  return (\n    getLangfuseRuntimeToolOutputTracingConfig() ??\n    getOtelToolOutputTracingConfig(activeContext)\n  );\n}\n\nexport function withLangfuseRuntimeScope<T>(\n  scope: LangfuseRuntimeScope,\n  action: () => T\n): T {\n  if (!hasLangfuseRuntimeContextValue(scope)) {\n    return action();\n  }\n\n  let activeContext = context.active();\n  if (scope.langfuse != null) {\n    activeContext = activeContext.setValue(langfuseConfigKey, scope.langfuse);\n  }\n  if (scope.toolOutputTracing != null) {\n    activeContext = activeContext.setValue(\n      langfuseToolOutputTracingConfigKey,\n      scope.toolOutputTracing\n    );\n  }\n  if (hasText(scope.traceIdSeed)) {\n    activeContext = activeContext.setValue(\n      langfuseTraceIdSeedKey,\n      scope.traceIdSeed\n    );\n  }\n\n  // Span processors receive the OTel parent context in `onStart`, while\n  // LangChain callback handlers may run outside that context and need ALS.\n  // The trace id generator reads the seed from ALS or OTel context so SDK\n  // callbacks that preserve only one of those contexts still keep trace/score\n  // cohesion.\n  return runWithLangfuseRuntimeContext(scope, () =>\n    context.with(activeContext, action)\n  );\n}\n\nexport function resolveLangfuseRuntimeScope({\n  runLangfuse,\n  langfuseOverlay,\n  traceIdSeed,\n}: ResolveLangfuseRuntimeScopeParams): LangfuseRuntimeScope {\n  const langfuse = resolveLangfuseConfig(runLangfuse, langfuseOverlay);\n  const toolOutputTracing = !hasToolOutputTracingConfig(\n    runLangfuse,\n    langfuseOverlay\n  )\n    ? undefined\n    : resolveToolOutputTracingConfig(runLangfuse, langfuseOverlay);\n  return { langfuse, traceIdSeed, toolOutputTracing };\n}\n"],"mappings":";;;;AA4BA,MAAM,qCAAqC,iBACzC,wCACF;AACA,MAAM,oBAAoB,iBAAiB,2BAA2B;AACtE,MAAM,yBAAyB,iBAC7B,kCACF;AAEA,SAAS,SAAS,OAAkD;CAClE,OAAO,SAAS,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAC3E;AAEA,SAAS,QAAQ,OAA4C;CAC3D,OAAO,SAAS,QAAQ,MAAM,KAAK,MAAM;AAC3C;AAEA,SAAgB,sBACd,eAC8B;CAC9B,MAAM,QAAQ,cAAc,SAAS,iBAAiB;CACtD,OAAO,SAAS,KAAK,IAAK,QAA6B,KAAA;AACzD;AAEA,SAAgB,mBAAmB,eAA4C;CAC7E,MAAM,QAAQ,cAAc,SAAS,sBAAsB;CAC3D,OAAO,OAAO,UAAU,YAAY,MAAM,KAAK,MAAM,KAAK,QAAQ,KAAA;AACpE;AAEA,SAAgB,+BACd,eACqD;CACrD,MAAM,QAAQ,cAAc,SAAS,kCAAkC;CACvE,OAAO,SAAS,KAAK,IAChB,QACD,KAAA;AACN;AAEA,SAAgB,6BACd,eAC8B;CAC9B,OAAO,yBAAyB,KAAK,sBAAsB,aAAa;AAC1E;AAEA,SAAgB,0BACd,eACoB;CACpB,OAAO,eAAe,KAAK,mBAAmB,aAAa;AAC7D;AAEA,SAAgB,sCACd,eACqD;CACrD,OACE,0CAA0C,KAC1C,+BAA+B,aAAa;AAEhD;AAEA,SAAgB,yBACd,OACA,QACG;CACH,IAAI,CAAC,+BAA+B,KAAK,GACvC,OAAO,OAAO;CAGhB,IAAI,gBAAgB,QAAQ,OAAO;CACnC,IAAI,MAAM,YAAY,MACpB,gBAAgB,cAAc,SAAS,mBAAmB,MAAM,QAAQ;CAE1E,IAAI,MAAM,qBAAqB,MAC7B,gBAAgB,cAAc,SAC5B,oCACA,MAAM,iBACR;CAEF,IAAI,QAAQ,MAAM,WAAW,GAC3B,gBAAgB,cAAc,SAC5B,wBACA,MAAM,WACR;CAQF,OAAO,8BAA8B,aACnC,QAAQ,KAAK,eAAe,MAAM,CACpC;AACF;AAEA,SAAgB,4BAA4B,EAC1C,aACA,iBACA,eAC0D;CAQ1D,OAAO;EAAE,UAPQ,sBAAsB,aAAa,eAOpC;EAAG;EAAa,mBANN,CAAC,2BACzB,aACA,eACF,IACI,KAAA,IACA,+BAA+B,aAAa,eAAe;CACb;AACpD"}