@librechat/agents 3.1.91 → 3.1.93

package/dist/cjs/instrumentation.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"instrumentation.cjs","sources":["../../src/instrumentation.ts"],"sourcesContent":["import { NodeSDK } from '@opentelemetry/sdk-node';\nimport { LangfuseSpanProcessor } from '@langfuse/otel';\nimport { isPresent } from '@/utils/misc';\n\nif (\n  isPresent(process.env.LANGFUSE_SECRET_KEY) &&\n  isPresent(process.env.LANGFUSE_PUBLIC_KEY) &&\n  isPresent(process.env.LANGFUSE_BASE_URL)\n) {\n  const langfuseSpanProcessor = new LangfuseSpanProcessor({\n    publicKey: process.env.LANGFUSE_PUBLIC_KEY,\n    secretKey: process.env.LANGFUSE_SECRET_KEY,\n    baseUrl: process.env.LANGFUSE_BASE_URL,\n    environment: process.env.LANGFUSE_TRACING_ENVIRONMENT ?? process.env.NODE_ENV ?? 'development',\n  });\n\n  const sdk = new NodeSDK({\n    spanProcessors: [langfuseSpanProcessor],\n  });\n\n  sdk.start();\n}\n"],"names":["isPresent","LangfuseSpanProcessor","NodeSDK"],"mappings":";;;;;;AAIA,IACEA,cAAS,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;AAC1C,IAAAA,cAAS,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAC1CA,cAAS,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,EACxC;AACA,IAAA,MAAM,qBAAqB,GAAG,IAAIC,0BAAqB,CAAC;AACtD,QAAA,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;AAC1C,QAAA,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;AAC1C,QAAA,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;AACtC,QAAA,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa;AAC/F,KAAA,CAAC;AAEF,IAAA,MAAM,GAAG,GAAG,IAAIC,eAAO,CAAC;QACtB,cAAc,EAAE,CAAC,qBAAqB,CAAC;AACxC,KAAA,CAAC;IAEF,GAAG,CAAC,KAAK,EAAE;AACb;;"}
+{"version":3,"file":"instrumentation.cjs","sources":["../../src/instrumentation.ts"],"sourcesContent":["import { NodeSDK } from '@opentelemetry/sdk-node';\nimport { LangfuseSpanProcessor } from '@langfuse/otel';\nimport { isPresent } from '@/utils/misc';\n\nif (\n  isPresent(process.env.LANGFUSE_SECRET_KEY) &&\n  isPresent(process.env.LANGFUSE_PUBLIC_KEY) &&\n  isPresent(process.env.LANGFUSE_BASE_URL ?? process.env.LANGFUSE_BASEURL)\n) {\n  const langfuseSpanProcessor = new LangfuseSpanProcessor();\n\n  const sdk = new NodeSDK({\n    spanProcessors: [langfuseSpanProcessor],\n  });\n\n  sdk.start();\n}\n"],"names":["isPresent","LangfuseSpanProcessor","NodeSDK"],"mappings":";;;;;;AAIA,IACEA,cAAS,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;AAC1C,IAAAA,cAAS,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;AAC1C,IAAAA,cAAS,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,EACxE;AACA,IAAA,MAAM,qBAAqB,GAAG,IAAIC,0BAAqB,EAAE;AAEzD,IAAA,MAAM,GAAG,GAAG,IAAIC,eAAO,CAAC;QACtB,cAAc,EAAE,CAAC,qBAAqB,CAAC;AACxC,KAAA,CAAC;IAEF,GAAG,CAAC,KAAK,EAAE;AACb;;"}

package/dist/cjs/langfuse.cjs

@@ -8,6 +8,34 @@ var sdkTraceBase = require('@opentelemetry/sdk-trace-base');
 var api = require('@opentelemetry/api');
 var misc = require('./utils/misc.cjs');
 
+const TRACE_METADATA_MAX_LENGTH = 200;
+const LANGFUSE_TRACER_NAME = 'langfuse-sdk';
+function getEnvLangfuseBaseUrl() {
+    return process.env.LANGFUSE_BASE_URL ?? process.env.LANGFUSE_BASEURL;
+}
+function createTraceMetadata(metadata) {
+    const traceMetadata = {};
+    for (const [key, value] of Object.entries(metadata)) {
+        if (value == null) {
+            continue;
+        }
+        const stringValue = typeof value === 'string' ? value : String(value);
+        if (stringValue.trim() === '' ||
+            stringValue.length > TRACE_METADATA_MAX_LENGTH) {
+            continue;
+        }
+        traceMetadata[key] = stringValue;
+    }
+    return traceMetadata;
+}
+function createLangfuseTraceMetadata({ messageId, parentMessageId, agentId, agentName, }) {
+    return createTraceMetadata({
+        messageId,
+        parentMessageId,
+        agentId,
+        agentName,
+    });
+}
 function getModelName(serialized) {
     const serializedRecord = serialized;
     const kwargs = serializedRecord.kwargs;
@@ -53,11 +81,27 @@ function getUsageDetails(output) {
         ? Object.fromEntries(usageEntries)
         : undefined;
 }
-function getTraceName(traceMetadata) {
+function getLangfuseTraceName(traceMetadata, fallback = 'LibreChat Agent') {
     const agentName = traceMetadata?.agentName;
-    return typeof agentName === 'string' && agentName.trim() !== ''
-        ? `LibreChat Agent: ${agentName}`
-        : 'LibreChat Agent';
+    return misc.isPresent(agentName) ? `${fallback}: ${agentName}` : fallback;
+}
+function getTraceAttributes({ userId, sessionId, traceMetadata, tags, }) {
+    const attributes = {
+        [tracing.LangfuseOtelSpanAttributes.TRACE_NAME]: getLangfuseTraceName(traceMetadata),
+    };
+    if (misc.isPresent(userId)) {
+        attributes[tracing.LangfuseOtelSpanAttributes.TRACE_USER_ID] = userId;
+    }
+    if (misc.isPresent(sessionId)) {
+        attributes[tracing.LangfuseOtelSpanAttributes.TRACE_SESSION_ID] = sessionId;
+    }
+    if (tags != null && tags.length > 0) {
+        attributes[tracing.LangfuseOtelSpanAttributes.TRACE_TAGS] = tags;
+    }
+    for (const [key, value] of Object.entries(traceMetadata ?? {})) {
+        attributes[`${tracing.LangfuseOtelSpanAttributes.TRACE_METADATA}.${key}`] = value;
+    }
+    return attributes;
 }
 class LangfuseAgentCallbackHandler extends base.BaseCallbackHandler {
     name = 'librechat_langfuse_agent_handler';
@@ -66,12 +110,14 @@ class LangfuseAgentCallbackHandler extends base.BaseCallbackHandler {
     userId;
     sessionId;
     traceMetadata;
+    tags;
     spans = new Map();
-    constructor({ langfuse, userId, sessionId, traceMetadata, }) {
+    constructor({ langfuse, userId, sessionId, traceMetadata, tags, }) {
         super();
         this.userId = userId;
         this.sessionId = sessionId;
         this.traceMetadata = traceMetadata;
+        this.tags = tags;
         this.processor = new otel.LangfuseSpanProcessor({
             publicKey: langfuse.publicKey,
             secretKey: langfuse.secretKey,
@@ -80,6 +126,8 @@ class LangfuseAgentCallbackHandler extends base.BaseCallbackHandler {
                 process.env.NODE_ENV ??
                 'development',
             exportMode: 'immediate',
+            shouldExportSpan: ({ otelSpan }) => otel.isDefaultExportSpan(otelSpan) ||
+                otelSpan.instrumentationScope.name === LANGFUSE_TRACER_NAME,
         });
         this.provider = new sdkTraceBase.BasicTracerProvider({
             spanProcessors: [this.processor],
@@ -89,15 +137,15 @@ class LangfuseAgentCallbackHandler extends base.BaseCallbackHandler {
         if (this.spans.has(runId)) {
             return;
         }
-        const tracer = this.provider.getTracer('librechat-agents-langfuse');
+        const tracer = this.provider.getTracer(LANGFUSE_TRACER_NAME);
         const spanName = typeof name === 'string' && name.trim() !== '' ? name : getModelName(llm);
         const span = tracer.startSpan(spanName, {
             attributes: {
-                ...tracing.createTraceAttributes({
-                    name: getTraceName(this.traceMetadata),
+                ...getTraceAttributes({
                     userId: this.userId,
                     sessionId: this.sessionId,
-                    metadata: this.traceMetadata,
+                    traceMetadata: this.traceMetadata,
+                    tags: this.tags,
                 }),
                 ...tracing.createObservationAttributes('generation', {
                     input,
@@ -190,7 +238,7 @@ function hasRequiredLangfuseConfig(langfuse) {
 function createLegacyLangfuseHandler(params) {
     return new langchain.CallbackHandler(params);
 }
-function createLangfuseHandler({ langfuse, userId, sessionId, traceMetadata, }) {
+function createLangfuseHandler({ langfuse, userId, sessionId, traceMetadata, tags, }) {
     if (!hasRequiredLangfuseConfig(langfuse)) {
         return undefined;
     }
@@ -199,6 +247,7 @@ function createLangfuseHandler({ langfuse, userId, sessionId, traceMetadata, })
         userId,
         sessionId,
         traceMetadata,
+        tags,
     });
 }
 function hasExplicitLangfuseConfig(contexts) {
@@ -212,7 +261,7 @@ function hasExplicitLangfuseConfig(contexts) {
 function hasLangfuseEnvConfig() {
     return (misc.isPresent(process.env.LANGFUSE_SECRET_KEY) &&
         misc.isPresent(process.env.LANGFUSE_PUBLIC_KEY) &&
-        misc.isPresent(process.env.LANGFUSE_BASE_URL));
+        misc.isPresent(getEnvLangfuseBaseUrl()));
 }
 function isLangfuseCallbackHandler(value) {
     return (value instanceof langchain.CallbackHandler ||
@@ -226,8 +275,10 @@ async function disposeLangfuseHandler(value) {
 
 exports.LangfuseAgentCallbackHandler = LangfuseAgentCallbackHandler;
 exports.createLangfuseHandler = createLangfuseHandler;
+exports.createLangfuseTraceMetadata = createLangfuseTraceMetadata;
 exports.createLegacyLangfuseHandler = createLegacyLangfuseHandler;
 exports.disposeLangfuseHandler = disposeLangfuseHandler;
+exports.getLangfuseTraceName = getLangfuseTraceName;
 exports.hasExplicitLangfuseConfig = hasExplicitLangfuseConfig;
 exports.hasLangfuseEnvConfig = hasLangfuseEnvConfig;
 exports.isLangfuseCallbackHandler = isLangfuseCallbackHandler;

package/dist/cjs/langfuse.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"langfuse.cjs","sources":["../../src/langfuse.ts"],"sourcesContent":["import { CallbackHandler } from '@langfuse/langchain';\nimport { LangfuseSpanProcessor } from '@langfuse/otel';\nimport {\n  createObservationAttributes,\n  createTraceAttributes,\n} from '@langfuse/tracing';\nimport { BaseCallbackHandler } from '@langchain/core/callbacks/base';\nimport { BasicTracerProvider } from '@opentelemetry/sdk-trace-base';\nimport { SpanStatusCode } from '@opentelemetry/api';\nimport type { Serialized } from '@langchain/core/load/serializable';\nimport type { BaseMessage } from '@langchain/core/messages';\nimport type { LLMResult } from '@langchain/core/outputs';\nimport type { Span } from '@opentelemetry/api';\nimport type * as t from '@/types';\nimport { isPresent } from '@/utils/misc';\n\ntype TraceMetadata = Record<string, unknown>;\n\ntype LangfuseHandlerParams = {\n  userId?: string;\n  sessionId?: string;\n  traceMetadata?: TraceMetadata;\n};\n\ntype AgentLangfuseHandlerParams = LangfuseHandlerParams & {\n  langfuse?: t.LangfuseConfig;\n};\n\ntype ResolvedLangfuseConfig = t.LangfuseConfig & {\n  enabled: true;\n  publicKey: string;\n  secretKey: string;\n};\n\nfunction getModelName(serialized: Serialized): string {\n  const serializedRecord = serialized as unknown as Record<string, unknown>;\n  const kwargs = serializedRecord.kwargs as Record<string, unknown> | undefined;\n  const modelName =\n    kwargs?.model ??\n    kwargs?.model_name ??\n    kwargs?.modelName ??\n    kwargs?.model_id ??\n    kwargs?.modelId ??\n    serializedRecord.name;\n\n  if (typeof modelName === 'string' && modelName.trim() !== '') {\n    return modelName;\n  }\n\n  if (Array.isArray(serializedRecord.id) && serializedRecord.id.length > 0) {\n    return String(serializedRecord.id[serializedRecord.id.length - 1]);\n  }\n\n  return 'ChatModel';\n}\n\nfunction getModelParameters(\n  extraParams?: Record<string, unknown>\n): Record<string, string | number> {\n  const invocationParams = extraParams?.invocation_params;\n  const params =\n    invocationParams != null && typeof invocationParams === 'object'\n      ? (invocationParams as Record<string, unknown>)\n      : (extraParams ?? {});\n\n  return Object.fromEntries(\n    Object.entries(params).filter(([, value]) => {\n      return typeof value === 'string' || typeof value === 'number';\n    })\n  ) as Record<string, string | number>;\n}\n\nfunction getOutput(output: LLMResult): unknown {\n  return output.generations.map((generation) =>\n    generation.map((item) => {\n      if ('message' in item && item.message != null) {\n        return (item.message as { content?: unknown }).content;\n      }\n      return item.text;\n    })\n  );\n}\n\nfunction getUsageDetails(\n  output: LLMResult\n): Record<string, number> | undefined {\n  const llmOutput = output.llmOutput as Record<string, unknown> | undefined;\n  const usage = llmOutput?.tokenUsage ?? llmOutput?.usage;\n  if (usage == null || typeof usage !== 'object') {\n    return undefined;\n  }\n\n  const usageEntries = Object.entries(usage as Record<string, unknown>).filter(\n    ([, value]) => typeof value === 'number'\n  );\n\n  return usageEntries.length > 0\n    ? (Object.fromEntries(usageEntries) as Record<string, number>)\n    : undefined;\n}\n\nfunction getTraceName(traceMetadata?: TraceMetadata): string {\n  const agentName = traceMetadata?.agentName;\n  return typeof agentName === 'string' && agentName.trim() !== ''\n    ? `LibreChat Agent: ${agentName}`\n    : 'LibreChat Agent';\n}\n\nexport class LangfuseAgentCallbackHandler extends BaseCallbackHandler {\n  name = 'librechat_langfuse_agent_handler';\n\n  private readonly provider: BasicTracerProvider;\n  private readonly processor: LangfuseSpanProcessor;\n  private readonly userId?: string;\n  private readonly sessionId?: string;\n  private readonly traceMetadata?: TraceMetadata;\n  private readonly spans = new Map<string, Span>();\n\n  constructor({\n    langfuse,\n    userId,\n    sessionId,\n    traceMetadata,\n  }: LangfuseHandlerParams & { langfuse: ResolvedLangfuseConfig }) {\n    super();\n    this.userId = userId;\n    this.sessionId = sessionId;\n    this.traceMetadata = traceMetadata;\n    this.processor = new LangfuseSpanProcessor({\n      publicKey: langfuse.publicKey,\n      secretKey: langfuse.secretKey,\n      ...(isPresent(langfuse.baseUrl) ? { baseUrl: langfuse.baseUrl } : {}),\n      environment:\n        process.env.LANGFUSE_TRACING_ENVIRONMENT ??\n        process.env.NODE_ENV ??\n        'development',\n      exportMode: 'immediate',\n    });\n    this.provider = new BasicTracerProvider({\n      spanProcessors: [this.processor],\n    });\n  }\n\n  private startGenerationSpan({\n    llm,\n    input,\n    runId,\n    extraParams,\n    metadata,\n    name,\n  }: {\n    llm: Serialized;\n    input: unknown;\n    runId: string;\n    extraParams?: Record<string, unknown>;\n    metadata?: Record<string, unknown>;\n    name?: string;\n  }): void {\n    if (this.spans.has(runId)) {\n      return;\n    }\n\n    const tracer = this.provider.getTracer('librechat-agents-langfuse');\n    const spanName =\n      typeof name === 'string' && name.trim() !== '' ? name : getModelName(llm);\n    const span = tracer.startSpan(spanName, {\n      attributes: {\n        ...createTraceAttributes({\n          name: getTraceName(this.traceMetadata),\n          userId: this.userId,\n          sessionId: this.sessionId,\n          metadata: this.traceMetadata,\n        }),\n        ...createObservationAttributes('generation', {\n          input,\n          model: getModelName(llm),\n          modelParameters: getModelParameters(extraParams),\n          metadata: {\n            ...metadata,\n            ...this.traceMetadata,\n          },\n        }),\n      },\n    });\n    this.spans.set(runId, span);\n  }\n\n  async handleChatModelStart(\n    llm: Serialized,\n    messages: BaseMessage[][],\n    runId: string,\n    _parentRunId?: string,\n    extraParams?: Record<string, unknown>,\n    _tags?: string[],\n    metadata?: Record<string, unknown>,\n    name?: string\n  ): Promise<void> {\n    this.startGenerationSpan({\n      llm,\n      input: messages,\n      runId,\n      extraParams,\n      metadata,\n      name,\n    });\n  }\n\n  async handleLLMStart(\n    llm: Serialized,\n    prompts: string[],\n    runId: string,\n    _parentRunId?: string,\n    extraParams?: Record<string, unknown>,\n    _tags?: string[],\n    metadata?: Record<string, unknown>,\n    name?: string\n  ): Promise<void> {\n    this.startGenerationSpan({\n      llm,\n      input: prompts,\n      runId,\n      extraParams,\n      metadata,\n      name,\n    });\n  }\n\n  async handleLLMEnd(output: LLMResult, runId: string): Promise<void> {\n    const span = this.spans.get(runId);\n    if (!span) {\n      return;\n    }\n\n    span.setAttributes(\n      createObservationAttributes('generation', {\n        output: getOutput(output),\n        usageDetails: getUsageDetails(output),\n      })\n    );\n    span.end();\n    this.spans.delete(runId);\n    await this.flush();\n  }\n\n  async handleLLMError(err: unknown, runId: string): Promise<void> {\n    const span = this.spans.get(runId);\n    if (!span) {\n      return;\n    }\n\n    const message = err instanceof Error ? err.message : String(err);\n    span.setStatus({ code: SpanStatusCode.ERROR, message });\n    span.setAttributes(\n      createObservationAttributes('generation', {\n        level: 'ERROR',\n        statusMessage: message,\n      })\n    );\n    span.end();\n    this.spans.delete(runId);\n    await this.flush();\n  }\n\n  private async flush(): Promise<void> {\n    try {\n      await this.provider.forceFlush();\n    } catch (error) {\n      process.emitWarning(\n        `[LangfuseAgentCallbackHandler] Failed to flush Langfuse spans: ${\n          error instanceof Error ? error.message : String(error)\n        }`\n      );\n    }\n  }\n\n  async dispose(): Promise<void> {\n    for (const span of this.spans.values()) {\n      span.end();\n    }\n    this.spans.clear();\n    await this.flush();\n    try {\n      await this.provider.shutdown();\n    } catch (error) {\n      process.emitWarning(\n        `[LangfuseAgentCallbackHandler] Failed to shut down Langfuse provider: ${\n          error instanceof Error ? error.message : String(error)\n        }`\n      );\n    }\n  }\n}\n\nfunction hasRequiredLangfuseConfig(\n  langfuse?: t.LangfuseConfig\n): langfuse is ResolvedLangfuseConfig {\n  return (\n    langfuse?.enabled === true &&\n    isPresent(langfuse.publicKey) &&\n    isPresent(langfuse.secretKey)\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}: AgentLangfuseHandlerParams): LangfuseAgentCallbackHandler | undefined {\n  if (!hasRequiredLangfuseConfig(langfuse)) {\n    return undefined;\n  }\n\n  return new LangfuseAgentCallbackHandler({\n    langfuse,\n    userId,\n    sessionId,\n    traceMetadata,\n  });\n}\n\nexport function hasExplicitLangfuseConfig(\n  contexts: Iterable<{ langfuse?: t.LangfuseConfig }>\n): boolean {\n  for (const context of contexts) {\n    if (context.langfuse != null) {\n      return true;\n    }\n  }\n  return false;\n}\n\nexport function hasLangfuseEnvConfig(): boolean {\n  return (\n    isPresent(process.env.LANGFUSE_SECRET_KEY) &&\n    isPresent(process.env.LANGFUSE_PUBLIC_KEY) &&\n    isPresent(process.env.LANGFUSE_BASE_URL)\n  );\n}\n\nexport function isLangfuseCallbackHandler(value: unknown): boolean {\n  return (\n    value instanceof CallbackHandler ||\n    value instanceof LangfuseAgentCallbackHandler\n  );\n}\n\nexport async function disposeLangfuseHandler(value: unknown): Promise<void> {\n  if (value instanceof LangfuseAgentCallbackHandler) {\n    await value.dispose();\n  }\n}\n"],"names":["BaseCallbackHandler","LangfuseSpanProcessor","isPresent","BasicTracerProvider","createTraceAttributes","createObservationAttributes","SpanStatusCode","CallbackHandler"],"mappings":"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"}
+{"version":3,"file":"langfuse.cjs","sources":["../../src/langfuse.ts"],"sourcesContent":["import { CallbackHandler } from '@langfuse/langchain';\nimport { isDefaultExportSpan, LangfuseSpanProcessor } from '@langfuse/otel';\nimport {\n  LangfuseOtelSpanAttributes,\n  createObservationAttributes,\n} from '@langfuse/tracing';\nimport { BaseCallbackHandler } from '@langchain/core/callbacks/base';\nimport { BasicTracerProvider } from '@opentelemetry/sdk-trace-base';\nimport { SpanStatusCode } from '@opentelemetry/api';\nimport type { Serialized } from '@langchain/core/load/serializable';\nimport type { BaseMessage } from '@langchain/core/messages';\nimport type { LLMResult } from '@langchain/core/outputs';\nimport type { Attributes, Span } from '@opentelemetry/api';\nimport type * as t from '@/types';\nimport { isPresent } from '@/utils/misc';\n\nconst TRACE_METADATA_MAX_LENGTH = 200;\nconst LANGFUSE_TRACER_NAME = 'langfuse-sdk';\n\nexport type LangfuseTraceMetadata = Record<string, string>;\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 ResolvedLangfuseConfig = t.LangfuseConfig & {\n  enabled: true;\n  publicKey: string;\n  secretKey: string;\n};\n\nfunction getEnvLangfuseBaseUrl(): string | undefined {\n  return process.env.LANGFUSE_BASE_URL ?? process.env.LANGFUSE_BASEURL;\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 getModelName(serialized: Serialized): string {\n  const serializedRecord = serialized as unknown as Record<string, unknown>;\n  const kwargs = serializedRecord.kwargs as Record<string, unknown> | undefined;\n  const modelName =\n    kwargs?.model ??\n    kwargs?.model_name ??\n    kwargs?.modelName ??\n    kwargs?.model_id ??\n    kwargs?.modelId ??\n    serializedRecord.name;\n\n  if (typeof modelName === 'string' && modelName.trim() !== '') {\n    return modelName;\n  }\n\n  if (Array.isArray(serializedRecord.id) && serializedRecord.id.length > 0) {\n    return String(serializedRecord.id[serializedRecord.id.length - 1]);\n  }\n\n  return 'ChatModel';\n}\n\nfunction getModelParameters(\n  extraParams?: Record<string, unknown>\n): Record<string, string | number> {\n  const invocationParams = extraParams?.invocation_params;\n  const params =\n    invocationParams != null && typeof invocationParams === 'object'\n      ? (invocationParams as Record<string, unknown>)\n      : (extraParams ?? {});\n\n  return Object.fromEntries(\n    Object.entries(params).filter(([, value]) => {\n      return typeof value === 'string' || typeof value === 'number';\n    })\n  ) as Record<string, string | number>;\n}\n\nfunction getOutput(output: LLMResult): unknown {\n  return output.generations.map((generation) =>\n    generation.map((item) => {\n      if ('message' in item && item.message != null) {\n        return (item.message as { content?: unknown }).content;\n      }\n      return item.text;\n    })\n  );\n}\n\nfunction getUsageDetails(\n  output: LLMResult\n): Record<string, number> | undefined {\n  const llmOutput = output.llmOutput as Record<string, unknown> | undefined;\n  const usage = llmOutput?.tokenUsage ?? llmOutput?.usage;\n  if (usage == null || typeof usage !== 'object') {\n    return undefined;\n  }\n\n  const usageEntries = Object.entries(usage as Record<string, unknown>).filter(\n    ([, value]) => typeof value === 'number'\n  );\n\n  return usageEntries.length > 0\n    ? (Object.fromEntries(usageEntries) as Record<string, number>)\n    : 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\nfunction getTraceAttributes({\n  userId,\n  sessionId,\n  traceMetadata,\n  tags,\n}: LangfuseHandlerParams): Attributes {\n  const attributes: Attributes = {\n    [LangfuseOtelSpanAttributes.TRACE_NAME]:\n      getLangfuseTraceName(traceMetadata),\n  };\n\n  if (isPresent(userId)) {\n    attributes[LangfuseOtelSpanAttributes.TRACE_USER_ID] = userId;\n  }\n  if (isPresent(sessionId)) {\n    attributes[LangfuseOtelSpanAttributes.TRACE_SESSION_ID] = sessionId;\n  }\n  if (tags != null && tags.length > 0) {\n    attributes[LangfuseOtelSpanAttributes.TRACE_TAGS] = tags;\n  }\n  for (const [key, value] of Object.entries(traceMetadata ?? {})) {\n    attributes[`${LangfuseOtelSpanAttributes.TRACE_METADATA}.${key}`] = value;\n  }\n\n  return attributes;\n}\n\nexport class LangfuseAgentCallbackHandler extends BaseCallbackHandler {\n  name = 'librechat_langfuse_agent_handler';\n\n  private readonly provider: BasicTracerProvider;\n  private readonly processor: LangfuseSpanProcessor;\n  private readonly userId?: string;\n  private readonly sessionId?: string;\n  private readonly traceMetadata?: LangfuseTraceMetadata;\n  private readonly tags?: string[];\n  private readonly spans = new Map<string, Span>();\n\n  constructor({\n    langfuse,\n    userId,\n    sessionId,\n    traceMetadata,\n    tags,\n  }: LangfuseHandlerParams & { langfuse: ResolvedLangfuseConfig }) {\n    super();\n    this.userId = userId;\n    this.sessionId = sessionId;\n    this.traceMetadata = traceMetadata;\n    this.tags = tags;\n    this.processor = new LangfuseSpanProcessor({\n      publicKey: langfuse.publicKey,\n      secretKey: langfuse.secretKey,\n      ...(isPresent(langfuse.baseUrl) ? { baseUrl: langfuse.baseUrl } : {}),\n      environment:\n        process.env.LANGFUSE_TRACING_ENVIRONMENT ??\n        process.env.NODE_ENV ??\n        'development',\n      exportMode: 'immediate',\n      shouldExportSpan: ({ otelSpan }): boolean =>\n        isDefaultExportSpan(otelSpan) ||\n        otelSpan.instrumentationScope.name === LANGFUSE_TRACER_NAME,\n    });\n    this.provider = new BasicTracerProvider({\n      spanProcessors: [this.processor],\n    });\n  }\n\n  private startGenerationSpan({\n    llm,\n    input,\n    runId,\n    extraParams,\n    metadata,\n    name,\n  }: {\n    llm: Serialized;\n    input: unknown;\n    runId: string;\n    extraParams?: Record<string, unknown>;\n    metadata?: Record<string, unknown>;\n    name?: string;\n  }): void {\n    if (this.spans.has(runId)) {\n      return;\n    }\n\n    const tracer = this.provider.getTracer(LANGFUSE_TRACER_NAME);\n    const spanName =\n      typeof name === 'string' && name.trim() !== '' ? name : getModelName(llm);\n    const span = tracer.startSpan(spanName, {\n      attributes: {\n        ...getTraceAttributes({\n          userId: this.userId,\n          sessionId: this.sessionId,\n          traceMetadata: this.traceMetadata,\n          tags: this.tags,\n        }),\n        ...createObservationAttributes('generation', {\n          input,\n          model: getModelName(llm),\n          modelParameters: getModelParameters(extraParams),\n          metadata: {\n            ...metadata,\n            ...this.traceMetadata,\n          },\n        }),\n      },\n    });\n    this.spans.set(runId, span);\n  }\n\n  async handleChatModelStart(\n    llm: Serialized,\n    messages: BaseMessage[][],\n    runId: string,\n    _parentRunId?: string,\n    extraParams?: Record<string, unknown>,\n    _tags?: string[],\n    metadata?: Record<string, unknown>,\n    name?: string\n  ): Promise<void> {\n    this.startGenerationSpan({\n      llm,\n      input: messages,\n      runId,\n      extraParams,\n      metadata,\n      name,\n    });\n  }\n\n  async handleLLMStart(\n    llm: Serialized,\n    prompts: string[],\n    runId: string,\n    _parentRunId?: string,\n    extraParams?: Record<string, unknown>,\n    _tags?: string[],\n    metadata?: Record<string, unknown>,\n    name?: string\n  ): Promise<void> {\n    this.startGenerationSpan({\n      llm,\n      input: prompts,\n      runId,\n      extraParams,\n      metadata,\n      name,\n    });\n  }\n\n  async handleLLMEnd(output: LLMResult, runId: string): Promise<void> {\n    const span = this.spans.get(runId);\n    if (!span) {\n      return;\n    }\n\n    span.setAttributes(\n      createObservationAttributes('generation', {\n        output: getOutput(output),\n        usageDetails: getUsageDetails(output),\n      })\n    );\n    span.end();\n    this.spans.delete(runId);\n    await this.flush();\n  }\n\n  async handleLLMError(err: unknown, runId: string): Promise<void> {\n    const span = this.spans.get(runId);\n    if (!span) {\n      return;\n    }\n\n    const message = err instanceof Error ? err.message : String(err);\n    span.setStatus({ code: SpanStatusCode.ERROR, message });\n    span.setAttributes(\n      createObservationAttributes('generation', {\n        level: 'ERROR',\n        statusMessage: message,\n      })\n    );\n    span.end();\n    this.spans.delete(runId);\n    await this.flush();\n  }\n\n  private async flush(): Promise<void> {\n    try {\n      await this.provider.forceFlush();\n    } catch (error) {\n      process.emitWarning(\n        `[LangfuseAgentCallbackHandler] Failed to flush Langfuse spans: ${\n          error instanceof Error ? error.message : String(error)\n        }`\n      );\n    }\n  }\n\n  async dispose(): Promise<void> {\n    for (const span of this.spans.values()) {\n      span.end();\n    }\n    this.spans.clear();\n    await this.flush();\n    try {\n      await this.provider.shutdown();\n    } catch (error) {\n      process.emitWarning(\n        `[LangfuseAgentCallbackHandler] Failed to shut down Langfuse provider: ${\n          error instanceof Error ? error.message : String(error)\n        }`\n      );\n    }\n  }\n}\n\nfunction hasRequiredLangfuseConfig(\n  langfuse?: t.LangfuseConfig\n): langfuse is ResolvedLangfuseConfig {\n  return (\n    langfuse?.enabled === true &&\n    isPresent(langfuse.publicKey) &&\n    isPresent(langfuse.secretKey)\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): LangfuseAgentCallbackHandler | undefined {\n  if (!hasRequiredLangfuseConfig(langfuse)) {\n    return undefined;\n  }\n\n  return new LangfuseAgentCallbackHandler({\n    langfuse,\n    userId,\n    sessionId,\n    traceMetadata,\n    tags,\n  });\n}\n\nexport function hasExplicitLangfuseConfig(\n  contexts: Iterable<{ langfuse?: t.LangfuseConfig }>\n): boolean {\n  for (const context of contexts) {\n    if (context.langfuse != null) {\n      return true;\n    }\n  }\n  return false;\n}\n\nexport function hasLangfuseEnvConfig(): boolean {\n  return (\n    isPresent(process.env.LANGFUSE_SECRET_KEY) &&\n    isPresent(process.env.LANGFUSE_PUBLIC_KEY) &&\n    isPresent(getEnvLangfuseBaseUrl())\n  );\n}\n\nexport function isLangfuseCallbackHandler(value: unknown): boolean {\n  return (\n    value instanceof CallbackHandler ||\n    value instanceof LangfuseAgentCallbackHandler\n  );\n}\n\nexport async function disposeLangfuseHandler(value: unknown): Promise<void> {\n  if (value instanceof LangfuseAgentCallbackHandler) {\n    await value.dispose();\n  }\n}\n"],"names":["isPresent","LangfuseOtelSpanAttributes","BaseCallbackHandler","LangfuseSpanProcessor","isDefaultExportSpan","BasicTracerProvider","createObservationAttributes","SpanStatusCode","CallbackHandler"],"mappings":"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"}

package/dist/cjs/run.cjs

@@ -17,6 +17,7 @@ var events = require('./events.cjs');
 var executeHooks = require('./hooks/executeHooks.cjs');
 require('./hooks/createWorkspacePolicyHook.cjs');
 var llm = require('./utils/llm.cjs');
+var callbacks = require('./utils/callbacks.cjs');
 var langfuse = require('./langfuse.cjs');
 
 // src/run.ts
@@ -462,33 +463,36 @@ class Run {
         this.hookRegistry?.clearHaltSignal(this.id);
         /** Custom event callback to intercept and handle custom events */
         const customEventCallback = this.createCustomEventCallback();
-        const baseCallbacks = config.callbacks ?? [];
         const streamCallbacks = streamOptions?.callbacks
             ? this.getCallbacks(streamOptions.callbacks)
-            : [];
+            : undefined;
         const customHandler = base.BaseCallbackHandler.fromMethods({
             [_enum.Callback.CUSTOM_EVENT]: customEventCallback,
         });
         customHandler.awaitHandlers = true;
-        config.callbacks = baseCallbacks
-            .concat(streamCallbacks)
-            .concat(customHandler);
+        config.callbacks = callbacks.appendCallbacks(config.callbacks, streamCallbacks ? [streamCallbacks, customHandler] : [customHandler]);
         if (langfuse.hasLangfuseEnvConfig() &&
             !langfuse.hasExplicitLangfuseConfig(this.Graph.agentContexts.values())) {
-            const userId = config.configurable?.user_id;
-            const sessionId = config.configurable?.thread_id;
+            const userId = typeof config.configurable?.user_id === 'string'
+                ? config.configurable.user_id
+                : undefined;
+            const sessionId = typeof config.configurable?.thread_id === 'string'
+                ? config.configurable.thread_id
+                : undefined;
             const primaryContext = this.Graph.agentContexts.get(this.Graph.defaultAgentId);
-            const traceMetadata = {
+            const traceMetadata = langfuse.createLangfuseTraceMetadata({
                 messageId: this.id,
                 parentMessageId: config.configurable?.requestBody?.parentMessageId,
                 agentName: primaryContext?.name,
-            };
+            });
             const handler = langfuse.createLegacyLangfuseHandler({
                 userId,
                 sessionId,
                 traceMetadata,
+                tags: ['librechat', 'agent'],
             });
-            config.callbacks = (config.callbacks ?? []).concat([handler]);
+            config.runName = config.runName ?? langfuse.getLangfuseTraceName(traceMetadata);
+            config.callbacks = callbacks.appendCallbacks(config.callbacks, [handler]);
         }
         if (!this.id) {
             throw new Error('Run ID not provided');
@@ -888,14 +892,21 @@ class Run {
     }
     async generateTitle({ provider, inputText, contentParts, titlePrompt, clientOptions, chainOptions, skipLanguage, titleMethod = _enum.TitleMethod.COMPLETION, titlePromptTemplate, }) {
         let titleLangfuseHandler;
+        const titleContext = this.Graph == null
+            ? undefined
+            : this.Graph.agentContexts.get(this.Graph.defaultAgentId);
+        const traceMetadata = langfuse.createLangfuseTraceMetadata({
+            messageId: 'title-' + this.id,
+            agentName: titleContext?.name,
+        });
+        const titleRunName = langfuse.getLangfuseTraceName(traceMetadata, 'LibreChat Title');
         if (chainOptions != null) {
-            const userId = chainOptions.configurable?.user_id;
-            const sessionId = chainOptions.configurable?.thread_id;
-            const titleContext = this.Graph?.agentContexts.get(this.Graph.defaultAgentId);
-            const traceMetadata = {
-                messageId: 'title-' + this.id,
-                agentName: titleContext?.name,
-            };
+            const userId = typeof chainOptions.configurable?.user_id === 'string'
+                ? chainOptions.configurable.user_id
+                : undefined;
+            const sessionId = typeof chainOptions.configurable?.thread_id === 'string'
+                ? chainOptions.configurable.thread_id
+                : undefined;
             const hasExplicitLangfuse = this.Graph != null &&
                 langfuse.hasExplicitLangfuseConfig(this.Graph.agentContexts.values());
             if (titleContext?.langfuse != null) {
@@ -904,6 +915,7 @@ class Run {
                     userId,
                     sessionId,
                     traceMetadata,
+                    tags: ['librechat', 'title'],
                 });
             }
             else if (langfuse.hasLangfuseEnvConfig() && !hasExplicitLangfuse) {
@@ -911,10 +923,11 @@ class Run {
                     userId,
                     sessionId,
                     traceMetadata,
+                    tags: ['librechat', 'title'],
                 });
             }
             if (titleLangfuseHandler != null) {
-                chainOptions.callbacks = (chainOptions.callbacks ?? []).concat([
+                chainOptions.callbacks = callbacks.appendCallbacks(chainOptions.callbacks, [
                     titleLangfuseHandler,
                 ]);
             }
@@ -961,6 +974,7 @@ class Run {
         const invokeConfig = Object.assign({}, chainOptions, {
             run_id: this.id,
             runId: this.id,
+            runName: chainOptions?.runName ?? titleRunName,
         });
         try {
             try {
@@ -969,7 +983,7 @@ class Run {
             catch (_e) {
                 // Fallback: strip callbacks to avoid EventStream tracer errors in certain environments
                 // but preserve Langfuse tracing if it exists.
-                const langfuseHandler = invokeConfig.callbacks?.find(langfuse.isLangfuseCallbackHandler);
+                const langfuseHandler = callbacks.findCallback(invokeConfig.callbacks, langfuse.isLangfuseCallbackHandler);
                 const { callbacks: _cb, ...rest } = invokeConfig;
                 const safeConfig = Object.assign({}, rest, {
                     callbacks: langfuseHandler ? [langfuseHandler] : [],