@librechat/agents 3.1.62 → 3.1.63

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@librechat/agents",
-  "version": "3.1.62",
+  "version": "3.1.63",
   "main": "./dist/cjs/main.cjs",
   "module": "./dist/esm/main.mjs",
   "types": "./dist/types/index.d.ts",
@@ -136,7 +136,7 @@
     "@opentelemetry/sdk-node": "^0.207.0",
     "@scarf/scarf": "^1.4.0",
     "ai-tokenizer": "^1.0.6",
-    "axios": "^1.13.5",
+    "axios": "1.13.6",
     "cheerio": "^1.0.0",
     "dotenv": "^16.4.7",
     "https-proxy-agent": "^7.0.6",
@@ -153,7 +153,7 @@
     "@anthropic-ai/vertex-sdk": "^0.12.0",
     "@eslint/compat": "^1.2.7",
     "@rollup/plugin-alias": "^5.1.0",
-    "@rollup/plugin-commonjs": "^28.0.3",
+    "@rollup/plugin-commonjs": "^29.0.2",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^15.2.3",
     "@rollup/plugin-typescript": "^12.1.2",
@@ -170,11 +170,11 @@
     "husky": "^9.1.7",
     "jest": "^30.2.0",
     "jest-util": "^30.2.0",
-    "lint-staged": "^15.2.7",
+    "lint-staged": "^16.4.0",
     "prettier": "^3.6.2",
     "rollup": "^4.59.0",
     "rollup-plugin-cleandir": "^2.0.0",
-    "ts-jest": "^29.4.5",
+    "ts-jest": "^29.4.6",
     "ts-node": "^10.9.2",
     "tsc-alias": "^1.8.10",
     "tsconfig-paths": "^4.2.0",

package/src/agents/AgentContext.ts

@@ -7,29 +7,19 @@ import type {
   BaseMessageFields,
 } from '@langchain/core/messages';
 import type { RunnableConfig, Runnable } from '@langchain/core/runnables';
-import type * as t from '@/types';
 import type { createPruneMessages } from '@/messages';
+import type * as t from '@/types';
+import {
+  ANTHROPIC_TOOL_TOKEN_MULTIPLIER,
+  DEFAULT_TOOL_TOKEN_MULTIPLIER,
+  ContentTypes,
+  Providers,
+} from '@/common';
 import { createSchemaOnlyTools } from '@/tools/schema';
 import { addCacheControl } from '@/messages/cache';
-import { ContentTypes, Providers } from '@/common';
 import { DEFAULT_RESERVE_RATIO } from '@/messages';
 import { toJsonSchema } from '@/utils/schema';
 
-/**
- * Anthropic direct API tool schema overhead multiplier.
- * Empirically calibrated against real MCP tool sets (29 tools).
- * Accounts for Anthropic's internal XML-like tool encoding plus
- * a ~300-token hidden tool-system preamble.
- */
-const ANTHROPIC_TOOL_TOKEN_MULTIPLIER = 2.6;
-
-/**
- * Default tool schema overhead multiplier for all non-Anthropic providers.
- * Covers OpenAI function-calling format, Bedrock, and other providers.
- * Empirically calibrated at ~1.4× the raw JSON token count.
- */
-const DEFAULT_TOOL_TOKEN_MULTIPLIER = 1.4;
-
 /**
  * Encapsulates agent-specific state that can vary between agents in a multi-agent system
  */
@@ -64,6 +54,7 @@ export class AgentContext {
       initialSummary,
       contextPruningConfig,
       maxToolResultChars,
+      toolSchemaTokens,
     } = agentConfig;
 
     const agentContext = new AgentContext({
@@ -104,14 +95,22 @@ export class AgentContext {
       const tokenMap = indexTokenCountMap || {};
       agentContext.baseIndexTokenCountMap = { ...tokenMap };
       agentContext.indexTokenCountMap = tokenMap;
-      agentContext.tokenCalculationPromise = agentContext
-        .calculateInstructionTokens(tokenCounter)
-        .then(() => {
-          agentContext.updateTokenMapWithInstructions(tokenMap);
-        })
-        .catch((err) => {
-          console.error('Error calculating instruction tokens:', err);
-        });
+
+      if (toolSchemaTokens != null && toolSchemaTokens > 0) {
+        /** Use pre-computed (cached) tool schema tokens — skip calculateInstructionTokens */
+        agentContext.toolSchemaTokens = toolSchemaTokens;
+        agentContext.tokenCalculationPromise = Promise.resolve();
+        agentContext.updateTokenMapWithInstructions(tokenMap);
+      } else {
+        agentContext.tokenCalculationPromise = agentContext
+          .calculateInstructionTokens(tokenCounter)
+          .then(() => {
+            agentContext.updateTokenMapWithInstructions(tokenMap);
+          })
+          .catch((err) => {
+            console.error('Error calculating instruction tokens:', err);
+          });
+      }
     } else if (indexTokenCountMap) {
       agentContext.baseIndexTokenCountMap = { ...indexTokenCountMap };
       agentContext.indexTokenCountMap = indexTokenCountMap;

package/src/common/constants.ts

@@ -0,0 +1,14 @@
+/**
+ * Anthropic direct API tool schema overhead multiplier.
+ * Empirically calibrated against real MCP tool sets (29 tools).
+ * Accounts for Anthropic's internal XML-like tool encoding plus
+ * a ~300-token hidden tool-system preamble.
+ */
+export const ANTHROPIC_TOOL_TOKEN_MULTIPLIER = 2.6;
+
+/**
+ * Default tool schema overhead multiplier for all non-Anthropic providers.
+ * Covers OpenAI function-calling format, Bedrock, and other providers.
+ * Empirically calibrated at ~1.4× the raw JSON token count.
+ */
+export const DEFAULT_TOOL_TOKEN_MULTIPLIER = 1.4;

package/src/common/index.ts

@@ -1,2 +1,3 @@
 // src/common/index.ts
-export * from './enum';
+export * from './constants';
+export * from './enum';

package/src/run.ts

@@ -305,9 +305,13 @@ export class Run<_T extends t.BaseGraphState> {
     ) {
       const userId = config.configurable?.user_id;
       const sessionId = config.configurable?.thread_id;
+      const primaryContext = this.Graph.agentContexts.get(
+        this.Graph.defaultAgentId
+      );
       const traceMetadata = {
         messageId: this.id,
         parentMessageId: config.configurable?.requestBody?.parentMessageId,
+        agentName: primaryContext?.name,
       };
       const handler = new CallbackHandler({
         userId,
@@ -453,8 +457,12 @@ export class Run<_T extends t.BaseGraphState> {
     ) {
       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 handler = new CallbackHandler({
         userId,

package/src/specs/langfuse-metadata.test.ts

@@ -0,0 +1,91 @@
+import { CallbackHandler } from '@langfuse/langchain';
+import { Providers } from '@/common';
+import { Run } from '@/run';
+
+jest.mock('@langfuse/langchain', () => ({
+  CallbackHandler: jest.fn().mockImplementation(() => ({})),
+}));
+
+const MockedCallbackHandler = CallbackHandler as jest.MockedClass<
+  typeof CallbackHandler
+>;
+
+async function createTestRun(agentName?: string): Promise<Run<never>> {
+  const run = await Run.create({
+    runId: 'test-run-id',
+    graphConfig: {
+      type: 'standard',
+      agents: [
+        {
+          agentId: 'agent_abc123',
+          ...(agentName != null && { name: agentName }),
+          provider: Providers.OPENAI,
+          clientOptions: { model: 'gpt-4' },
+          tools: [],
+        },
+      ],
+    },
+  });
+
+  const emptyStream = (async function* (): AsyncGenerator {
+    /* no events */
+  })();
+  run.graphRunnable = { streamEvents: () => emptyStream } as never;
+
+  return run;
+}
+
+describe('Langfuse trace metadata includes agentName', () => {
+  const originalEnv = process.env;
+
+  beforeEach(() => {
+    jest.clearAllMocks();
+    process.env = {
+      ...originalEnv,
+      LANGFUSE_SECRET_KEY: 'sk-test',
+      LANGFUSE_PUBLIC_KEY: 'pk-test',
+      LANGFUSE_BASE_URL: 'https://langfuse.test',
+    };
+  });
+
+  afterEach(() => {
+    process.env = originalEnv;
+  });
+
+  it('passes agentName in processStream traceMetadata when agent has a name', async () => {
+    const run = await createTestRun('DWAINE');
+    await run.processStream(
+      { messages: [] },
+      { configurable: { thread_id: 't1', user_id: 'u1' }, version: 'v2' }
+    );
+
+    expect(MockedCallbackHandler).toHaveBeenCalledTimes(1);
+    const ctorArgs = MockedCallbackHandler.mock.calls[0][0];
+    expect(ctorArgs?.traceMetadata).toMatchObject({ agentName: 'DWAINE' });
+  });
+
+  it('falls back to agentId when agent has no explicit name', async () => {
+    const run = await createTestRun();
+    await run.processStream(
+      { messages: [] },
+      { configurable: { thread_id: 't1', user_id: 'u1' }, version: 'v2' }
+    );
+
+    expect(MockedCallbackHandler).toHaveBeenCalledTimes(1);
+    const ctorArgs = MockedCallbackHandler.mock.calls[0][0];
+    expect(ctorArgs?.traceMetadata).toMatchObject({
+      agentName: 'agent_abc123',
+    });
+  });
+
+  it('does not create CallbackHandler when Langfuse env vars are missing', async () => {
+    delete process.env.LANGFUSE_SECRET_KEY;
+    const run = await createTestRun('MAIA');
+    await run.processStream(
+      { messages: [] },
+      { configurable: { thread_id: 't1', user_id: 'u1' }, version: 'v2' }
+    );
+
+    expect(MockedCallbackHandler).not.toHaveBeenCalled();
+  });
+});

package/src/types/graph.ts

@@ -429,6 +429,8 @@ export interface AgentInputs {
   initialSummary?: { text: string; tokenCount: number };
   contextPruningConfig?: ContextPruningConfig;
   maxToolResultChars?: number;
+  /** Pre-computed tool schema token count (from cache). Skips recalculation when provided. */
+  toolSchemaTokens?: number;
 }
 
 export interface ContextPruningConfig {