@librechat/agents 3.1.61 → 3.1.63

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/summarization/node.ts

@@ -31,7 +31,7 @@ const SUMMARY_WRAPPER_OVERHEAD_TOKENS = 33;
 /** Structured checkpoint prompt for fresh summarization (no prior summary). */
 export const DEFAULT_SUMMARIZATION_PROMPT = `Hold on, before you continue I need you to write me a checkpoint of everything so far. Your context window is filling up and this checkpoint replaces the messages above, so capture everything you need to pick right back up.
 
-Don't second-guess or fact-check anything you did, your tool results reflect exactly what happened. Just record what you did and what you observed. Only the checkpoint, don't respond to me or continue the conversation.
+Don't second-guess or fact-check anything you did, your tool results reflect exactly what happened. If a tool result appears truncated, that's just a display artifact from context management: the tool executed fully. Just record what you did and what you observed. Only the checkpoint, don't respond to me or continue the conversation.
 
 ## Checkpoint
 
@@ -69,7 +69,7 @@ export const DEFAULT_UPDATE_SUMMARIZATION_PROMPT = `Hold on again, update your c
 
 Keep it roughly the same length as your last checkpoint. Compress older details to make room for what's new, don't just append. Give recent actions more detail, compress older items to one-liners.
 
-Don't fact-check or second-guess anything, your tool results are ground truth. Only the checkpoint, don't respond to me or continue the conversation.
+Don't fact-check or second-guess anything, your tool results are ground truth. If a tool result appears truncated, that's just a display artifact: the tool executed fully. Only the checkpoint, don't respond to me or continue the conversation.
 
 Rules:
 - Merge new progress into existing sections, don't duplicate headers

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 {