@librechat/agents 3.1.75 → 3.1.76

package/dist/types/types/graph.d.ts

@@ -1,4 +1,4 @@
-import type { START, StateType, UpdateType, StateGraph, StateGraphArgs, StateDefinition, CompiledStateGraph, BinaryOperatorAggregate } from '@langchain/langgraph';
+import type { START, StateGraph, StateGraphArgs } from '@langchain/langgraph';
 import type { BindToolsInput } from '@langchain/core/language_models/chat_models';
 import type { BaseMessage, AIMessageChunk, SystemMessage } from '@langchain/core/messages';
 import type { RunnableConfig, Runnable } from '@langchain/core/runnables';
@@ -51,51 +51,36 @@ export interface EventHandler {
 }
 export type GraphStateChannels<T extends BaseGraphState> = StateGraphArgs<T>['channels'];
 export type Workflow<T extends BaseGraphState = BaseGraphState, U extends Partial<T> = Partial<T>, N extends string = string> = StateGraph<T, U, N>;
-export type CompiledWorkflow<T extends BaseGraphState = BaseGraphState, U extends Partial<T> = Partial<T>, N extends string = string> = CompiledStateGraph<T, U, N>;
-export type CompiledStateWorkflow = CompiledStateGraph<StateType<{
-    messages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
-}>, UpdateType<{
-    messages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
-}>, string, {
-    messages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
-}, {
-    messages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
-}, StateDefinition>;
-export type CompiledMultiAgentWorkflow = CompiledStateGraph<StateType<{
-    messages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
-    agentMessages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
-}>, UpdateType<{
-    messages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
-    agentMessages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
-}>, string, {
-    messages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
-    agentMessages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
-}, {
-    messages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
-    agentMessages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
-}, StateDefinition>;
-export type CompiledAgentWorfklow = CompiledStateGraph<AgentSubgraphState, Partial<AgentSubgraphState>, '__start__' | `agent=${string}` | `tools=${string}` | `summarize=${string}`, {
-    messages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
-    summarizationRequest: BinaryOperatorAggregate<SummarizationNodeInput | undefined, SummarizationNodeInput | undefined>;
-}, {
-    messages: BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
-    summarizationRequest: BinaryOperatorAggregate<SummarizationNodeInput | undefined, SummarizationNodeInput | undefined>;
-}, StateDefinition, {
-    [x: `agent=${string}`]: Partial<BaseGraphState>;
-    [x: `tools=${string}`]: any;
-    [x: `summarize=${string}`]: any;
-}>;
+type LangChainEventStreamCallbackHandlerInput = NonNullable<Parameters<Runnable['streamEvents']>[2]>;
+export type EventStreamCallbackHandlerInput = LangChainEventStreamCallbackHandlerInput & {
+    autoClose?: boolean;
+    raiseError?: boolean;
+    ignoreCustomEvent?: boolean;
+};
+export type WorkflowValuesStreamConfig = RunnableConfig & {
+    streamMode: 'values';
+};
+/**
+ * LangGraph stream output is mode-dependent (`values`, `updates`, SSE, etc.).
+ * Keep the base Runnable stream output as unknown and narrow at callsites that
+ * choose a concrete streamMode.
+ */
+export type CompiledWorkflow<TInput extends BaseGraphState = BaseGraphState, TOutput extends BaseGraphState = TInput> = Omit<Runnable<TInput, unknown>, 'invoke'> & {
+    invoke(input: TInput, config?: RunnableConfig): Promise<TOutput>;
+};
+export type CompiledStateWorkflow = CompiledWorkflow;
+export type CompiledMultiAgentWorkflow = CompiledWorkflow<MultiAgentGraphState>;
+export type CompiledAgentWorfklow = CompiledWorkflow<AgentSubgraphState, AgentSubgraphState>;
 export type SystemRunnable = Runnable<BaseMessage[], (BaseMessage | SystemMessage)[], RunnableConfig<Record<string, unknown>>> | undefined;
 /**
  * Optional compile options passed to workflow.compile().
  * These are intentionally untyped to avoid coupling to library internals.
  */
 export type CompileOptions = {
-    checkpointer?: any;
+    checkpointer?: unknown;
     interruptBefore?: string[];
     interruptAfter?: string[];
 };
-export type EventStreamCallbackHandlerInput = Parameters<CompiledWorkflow['streamEvents']>[2] extends Omit<infer T, 'autoClose'> ? T : never;
 export type StreamChunk = (ChatGenerationChunk & {
     message: AIMessageChunk;
 }) | AIMessageChunk;
@@ -372,3 +357,4 @@ export interface ContextPruningConfig {
         placeholder?: string;
     };
 }
+export {};

package/dist/types/types/llm.d.ts

@@ -3,7 +3,7 @@ import type { BindToolsInput, BaseChatModelParams } from '@langchain/core/langua
 import type { OpenAIChatInput, ChatOpenAIFields, AzureOpenAIInput, ClientOptions as OAIClientOptions } from '@langchain/openai';
 import type { GoogleGenerativeAIChatInput } from '@langchain/google-genai';
 import type { ChatVertexAIInput } from '@langchain/google-vertexai';
-import type { ChatDeepSeekCallOptions } from '@langchain/deepseek';
+import type { ChatDeepSeekInput } from '@langchain/deepseek';
 import type { ChatOpenRouterCallOptions } from '@/llm/openrouter';
 import type { ChatBedrockConverseInput } from '@langchain/aws';
 import type { ChatMistralAIInput } from '@langchain/mistralai';
@@ -49,7 +49,7 @@ export type AnthropicReasoning = {
 export type GoogleThinkingConfig = {
     thinkingBudget?: number;
     includeThoughts?: boolean;
-    thinkingLevel?: string;
+    thinkingLevel?: 'THINKING_LEVEL_UNSPECIFIED' | 'LOW' | 'MEDIUM' | 'HIGH';
 };
 export type OpenAIClientOptions = ChatOpenAIFields;
 export type AnthropicClientOptions = Omit<AnthropicInput, 'thinking'> & {
@@ -71,7 +71,7 @@ export type GoogleClientOptions = GoogleGenerativeAIChatInput & {
     customHeaders?: RequestOptions['customHeaders'];
     thinkingConfig?: GoogleThinkingConfig;
 };
-export type DeepSeekClientOptions = ChatDeepSeekCallOptions;
+export type DeepSeekClientOptions = Partial<ChatDeepSeekInput>;
 export type XAIClientOptions = ChatXAIInput;
 export type ClientOptions = OpenAIClientOptions | AzureClientOptions | AnthropicClientOptions | MistralAIClientOptions | VertexAIClientOptions | BedrockConverseClientOptions | GoogleClientOptions | DeepSeekClientOptions | XAIClientOptions;
 export type SharedLLMConfig = {

package/dist/types/types/stream.d.ts

@@ -138,7 +138,7 @@ export interface ExtendedMessageContent {
     type?: string;
     text?: string;
     input?: string;
-    index?: number;
+    index?: string | number;
     id?: string;
     name?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@librechat/agents",
-  "version": "3.1.75",
+  "version": "3.1.76",
   "main": "./dist/cjs/main.cjs",
   "module": "./dist/esm/main.mjs",
   "types": "./dist/types/index.d.ts",
@@ -9,6 +9,66 @@
       "import": "./dist/esm/main.mjs",
       "require": "./dist/cjs/main.cjs",
       "types": "./dist/types/index.d.ts"
+    },
+    "./langchain": {
+      "import": "./dist/esm/langchain/index.mjs",
+      "require": "./dist/cjs/langchain/index.cjs",
+      "types": "./dist/types/langchain/index.d.ts"
+    },
+    "./langchain/language_models/chat_models": {
+      "import": "./dist/esm/langchain/language_models/chat_models.mjs",
+      "require": "./dist/cjs/langchain/language_models/chat_models.cjs",
+      "types": "./dist/types/langchain/language_models/chat_models.d.ts"
+    },
+    "./langchain/messages": {
+      "import": "./dist/esm/langchain/messages.mjs",
+      "require": "./dist/cjs/langchain/messages.cjs",
+      "types": "./dist/types/langchain/messages.d.ts"
+    },
+    "./langchain/messages/tool": {
+      "import": "./dist/esm/langchain/messages/tool.mjs",
+      "require": "./dist/cjs/langchain/messages/tool.cjs",
+      "types": "./dist/types/langchain/messages/tool.d.ts"
+    },
+    "./langchain/google-common": {
+      "import": "./dist/esm/langchain/google-common.mjs",
+      "require": "./dist/cjs/langchain/google-common.cjs",
+      "types": "./dist/types/langchain/google-common.d.ts"
+    },
+    "./langchain/openai": {
+      "import": "./dist/esm/langchain/openai.mjs",
+      "require": "./dist/cjs/langchain/openai.cjs",
+      "types": "./dist/types/langchain/openai.d.ts"
+    },
+    "./langchain/prompts": {
+      "import": "./dist/esm/langchain/prompts.mjs",
+      "require": "./dist/cjs/langchain/prompts.cjs",
+      "types": "./dist/types/langchain/prompts.d.ts"
+    },
+    "./langchain/runnables": {
+      "import": "./dist/esm/langchain/runnables.mjs",
+      "require": "./dist/cjs/langchain/runnables.cjs",
+      "types": "./dist/types/langchain/runnables.d.ts"
+    },
+    "./langchain/tools": {
+      "import": "./dist/esm/langchain/tools.mjs",
+      "require": "./dist/cjs/langchain/tools.cjs",
+      "types": "./dist/types/langchain/tools.d.ts"
+    },
+    "./langchain/utils/env": {
+      "import": "./dist/esm/langchain/utils/env.mjs",
+      "require": "./dist/cjs/langchain/utils/env.cjs",
+      "types": "./dist/types/langchain/utils/env.d.ts"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "langchain": [
+        "dist/types/langchain/index.d.ts"
+      ],
+      "langchain/*": [
+        "dist/types/langchain/*"
+      ]
     }
   },
   "type": "module",
@@ -27,7 +87,7 @@
   ],
   "packageManager": "npm@10.5.2",
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=20.0.0"
   },
   "files": [
     "dist",
@@ -111,29 +171,31 @@
     "format": "prettier --write ."
   },
   "overrides": {
-    "@langchain/openai": "0.5.18",
+    "@langchain/openai": "1.4.5",
     "@anthropic-ai/sdk": "$@anthropic-ai/sdk",
     "@browserbasehq/stagehand": {
       "openai": "$openai"
     },
-    "fast-xml-parser": "5.5.7",
+    "fast-xml-parser": "5.7.2",
     "ajv": "6.14.0",
     "minimatch": "3.1.4"
   },
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.73.0",
+    "@anthropic-ai/sdk": "^0.92.0",
     "@aws-sdk/client-bedrock-runtime": "^3.1013.0",
-    "@langchain/anthropic": "^0.3.26",
-    "@langchain/aws": "^0.1.15",
-    "@langchain/core": "^0.3.80",
-    "@langchain/deepseek": "^0.0.2",
-    "@langchain/google-genai": "^0.2.18",
-    "@langchain/google-vertexai": "^0.2.18",
-    "@langchain/langgraph": "^0.4.9",
-    "@langchain/mistralai": "^0.2.1",
-    "@langchain/openai": "0.5.18",
-    "@langchain/textsplitters": "^0.1.0",
-    "@langchain/xai": "^0.0.3",
+    "@langchain/anthropic": "^1.3.28",
+    "@langchain/aws": "^1.3.5",
+    "@langchain/core": "1.1.44",
+    "@langchain/deepseek": "^1.0.25",
+    "@langchain/google-common": "2.1.30",
+    "@langchain/google-gauth": "2.1.30",
+    "@langchain/google-genai": "2.1.30",
+    "@langchain/google-vertexai": "2.1.30",
+    "@langchain/langgraph": "^1.2.9",
+    "@langchain/mistralai": "^1.0.8",
+    "@langchain/openai": "1.4.5",
+    "@langchain/textsplitters": "^1.0.1",
+    "@langchain/xai": "^1.3.17",
     "@langfuse/langchain": "^4.3.0",
     "@langfuse/otel": "^4.3.0",
     "@langfuse/tracing": "^4.3.0",
@@ -147,7 +209,8 @@
     "mathjs": "^15.2.0",
     "nanoid": "^3.3.7",
     "okapibm25": "^1.4.1",
-    "openai": "5.8.2"
+    "openai": "^6.35.0",
+    "uuid": "^11.1.1"
   },
   "imports": {
     "@/*": "./src/*",

package/src/graphs/Graph.ts

@@ -399,12 +399,25 @@ export class StandardGraph extends Graph<t.BaseGraphState, t.GraphNode> {
   ): (string | number | undefined)[] {
     if (!metadata) return [];
 
+    const configurable = this.config?.configurable;
+    const runId =
+      (metadata.run_id as string | undefined) ??
+      (configurable?.run_id as string | undefined) ??
+      this.runId;
+    const threadId =
+      (metadata.thread_id as string | undefined) ??
+      (configurable?.thread_id as string | undefined) ??
+      runId;
+    const checkpointNs =
+      (metadata.checkpoint_ns as string | undefined) ??
+      (metadata.langgraph_checkpoint_ns as string | undefined) ??
+      '';
     const keyList = [
-      metadata.run_id as string,
-      metadata.thread_id as string,
+      runId,
+      threadId,
       metadata.langgraph_node as string,
       metadata.langgraph_step as number,
-      metadata.checkpoint_ns as string,
+      checkpointNs,
     ];
 
     const agentContext = this.getAgentContext(metadata);
@@ -1461,7 +1474,14 @@ export class StandardGraph extends Graph<t.BaseGraphState, t.GraphNode> {
       }),
     });
     const workflow = new StateGraph(StateAnnotation)
-      .addNode(this.defaultAgentId, agentNode, { ends: [END] })
+      .addNode(
+        this.defaultAgentId,
+        agentNode as Runnable<
+          t.AgentSubgraphState,
+          Partial<t.AgentSubgraphState>
+        >,
+        { ends: [END] }
+      )
       .addEdge(START, this.defaultAgentId)
       // LangGraph compile() types are overly strict for opt-in options
       .compile(this.compileOptions as unknown as never);

package/src/graphs/__tests__/composition.smoke.test.ts

@@ -0,0 +1,188 @@
+import { HumanMessage } from '@langchain/core/messages';
+import type { ToolCall } from '@langchain/core/messages/tool';
+import type { RunnableConfig } from '@langchain/core/runnables';
+import type * as t from '@/types';
+import { MultiAgentGraph } from '../MultiAgentGraph';
+import { Constants, Providers } from '@/common';
+import { StandardGraph } from '../Graph';
+
+const makeAgent = (agentId: string): t.AgentInputs => ({
+  agentId,
+  provider: Providers.OPENAI,
+  instructions: `You are ${agentId}.`,
+});
+
+const makeConfig = (threadId: string): RunnableConfig => ({
+  configurable: {
+    thread_id: threadId,
+  },
+});
+
+const makeStreamConfig = (threadId: string): t.WorkflowValuesStreamConfig => ({
+  ...makeConfig(threadId),
+  streamMode: 'values' as const,
+});
+
+const getAiContents = (messages: t.BaseGraphState['messages']): string[] =>
+  messages
+    .filter((message) => message.getType() === 'ai')
+    .map((message) => message.content)
+    .filter((content): content is string => typeof content === 'string');
+
+const expectCompiledWorkflow = (
+  workflow: t.CompiledWorkflow | t.CompiledMultiAgentWorkflow
+): void => {
+  expect(typeof workflow.invoke).toBe('function');
+  expect(typeof workflow.stream).toBe('function');
+};
+
+describe('LangGraph composition smoke tests', () => {
+  it('compiles and invokes the standard single-agent graph', async () => {
+    const graph = new StandardGraph({
+      runId: 'standard-smoke',
+      agents: [makeAgent('agent')],
+    });
+    graph.overrideTestModel(['standard ok']);
+
+    const workflow = graph.createWorkflow();
+    expectCompiledWorkflow(workflow);
+
+    const result = await workflow.invoke(
+      { messages: [new HumanMessage('hello')] },
+      makeConfig('standard-smoke')
+    );
+
+    expect(getAiContents(result.messages)).toEqual(['standard ok']);
+  });
+
+  it('streams values from the standard single-agent graph', async () => {
+    const graph = new StandardGraph({
+      runId: 'standard-stream-smoke',
+      agents: [makeAgent('agent')],
+    });
+    graph.overrideTestModel(['standard stream ok']);
+
+    const workflow = graph.createWorkflow();
+    const stream = (await workflow.stream(
+      { messages: [new HumanMessage('hello')] },
+      makeStreamConfig('standard-stream-smoke')
+    )) as AsyncIterable<t.BaseGraphState>;
+    const chunks: t.BaseGraphState[] = [];
+
+    for await (const chunk of stream) {
+      chunks.push(chunk);
+    }
+
+    expect(chunks.length).toBeGreaterThan(0);
+    expect(
+      chunks.some((chunk) =>
+        getAiContents(chunk.messages).includes('standard stream ok')
+      )
+    ).toBe(true);
+  });
+
+  it('compiles and invokes a multi-agent graph with one agent and no edges', async () => {
+    const graph = new MultiAgentGraph({
+      runId: 'multi-single-smoke',
+      agents: [makeAgent('A')],
+      edges: [],
+    });
+    graph.overrideTestModel(['multi ok']);
+
+    const workflow = graph.createWorkflow();
+    expectCompiledWorkflow(workflow);
+
+    const result = await workflow.invoke(
+      { messages: [new HumanMessage('hello')] },
+      makeConfig('multi-single-smoke')
+    );
+
+    expect(getAiContents(result.messages)).toEqual(['multi ok']);
+  });
+
+  it('compiles and invokes direct sequential edges', async () => {
+    const graph = new MultiAgentGraph({
+      runId: 'direct-chain-smoke',
+      agents: [makeAgent('A'), makeAgent('B')],
+      edges: [{ from: 'A', to: 'B', edgeType: 'direct' }],
+    });
+    graph.overrideTestModel(['from A', 'from B']);
+
+    const workflow = graph.createWorkflow();
+    expectCompiledWorkflow(workflow);
+
+    const result = await workflow.invoke(
+      { messages: [new HumanMessage('start')] },
+      makeConfig('direct-chain-smoke')
+    );
+
+    expect(getAiContents(result.messages)).toEqual(['from A', 'from B']);
+  });
+
+  it('compiles and invokes a handoff edge using graph-managed transfer tools', async () => {
+    const transferToolCall: ToolCall = {
+      id: 'call_transfer_to_B',
+      name: `${Constants.LC_TRANSFER_TO_}B`,
+      args: { instructions: 'Take over from here.' },
+      type: 'tool_call',
+    };
+    const graph = new MultiAgentGraph({
+      runId: 'handoff-smoke',
+      agents: [makeAgent('A'), makeAgent('B')],
+      edges: [{ from: 'A', to: 'B', edgeType: 'handoff' }],
+    });
+    graph.overrideTestModel(['routing to B', 'handoff complete'], undefined, [
+      transferToolCall,
+    ]);
+
+    const workflow = graph.createWorkflow();
+    expectCompiledWorkflow(workflow);
+
+    const result = await workflow.invoke(
+      { messages: [new HumanMessage('start')] },
+      makeConfig('handoff-smoke')
+    );
+
+    expect(getAiContents(result.messages)).toContain('handoff complete');
+  });
+
+  it('compiles fan-out/fan-in direct composition with prompt wrapping', () => {
+    const graph = new MultiAgentGraph({
+      runId: 'fan-in-smoke',
+      agents: [
+        makeAgent('root'),
+        makeAgent('left'),
+        makeAgent('right'),
+        makeAgent('final'),
+      ],
+      edges: [
+        { from: 'root', to: ['left', 'right'], edgeType: 'direct' },
+        {
+          from: ['left', 'right'],
+          to: 'final',
+          edgeType: 'direct',
+          prompt: 'Summarize these results:\n{results}',
+        },
+      ],
+    });
+
+    expectCompiledWorkflow(graph.createWorkflow());
+    expect(graph.getParallelGroupId('root')).toBeUndefined();
+    expect(graph.getParallelGroupId('left')).toBe(1);
+    expect(graph.getParallelGroupId('right')).toBe(1);
+    expect(graph.getParallelGroupId('final')).toBeUndefined();
+  });
+
+  it('compiles mixed handoff and direct routing from the same agent', () => {
+    const graph = new MultiAgentGraph({
+      runId: 'mixed-routing-smoke',
+      agents: [makeAgent('router'), makeAgent('handoff'), makeAgent('direct')],
+      edges: [
+        { from: 'router', to: 'handoff', edgeType: 'handoff' },
+        { from: 'router', to: 'direct', edgeType: 'direct' },
+      ],
+    });
+
+    expectCompiledWorkflow(graph.createWorkflow());
+  });
+});

package/src/index.ts

@@ -38,6 +38,9 @@ export * from './hooks';
 /* Types */
 export type * from './types';
 
+/* LangChain compatibility facade */
+export * from './langchain';
+
 /* LLM */
 export { CustomOpenAIClient } from './llm/openai';
 export { ChatOpenRouter } from './llm/openrouter';

package/src/langchain/google-common.ts

@@ -0,0 +1 @@
+export type { GoogleAIToolType } from '@langchain/google-common';

package/src/langchain/index.ts

@@ -0,0 +1,8 @@
+export * from './messages';
+export * from './prompts';
+export * from './runnables';
+export * from './tools';
+export * from './google-common';
+export * from './language_models/chat_models';
+export * from './messages/tool';
+export * from './openai';

package/src/langchain/language_models/chat_models.ts

@@ -0,0 +1 @@
+export type { BindToolsInput } from '@langchain/core/language_models/chat_models';

package/src/langchain/messages/tool.ts

@@ -0,0 +1,5 @@
+export type {
+  InvalidToolCall,
+  ToolCall,
+  ToolCallChunk,
+} from '@langchain/core/messages/tool';

package/src/langchain/messages.ts

@@ -0,0 +1,21 @@
+export {
+  AIMessage,
+  AIMessageChunk,
+  BaseMessage,
+  BaseMessageChunk,
+  HumanMessage,
+  SystemMessage,
+  ToolMessage,
+  getBufferString,
+  isAIMessage,
+  isBaseMessage,
+  isToolMessage,
+} from '@langchain/core/messages';
+
+export type {
+  BaseMessageFields,
+  MessageContent,
+  MessageContentText,
+  MessageContentImageUrl,
+  UsageMetadata,
+} from '@langchain/core/messages';

package/src/langchain/openai.ts

@@ -0,0 +1 @@
+export type { AzureOpenAIInput } from '@langchain/openai';

package/src/langchain/prompts.ts

@@ -0,0 +1 @@
+export { PromptTemplate } from '@langchain/core/prompts';

package/src/langchain/runnables.ts

@@ -0,0 +1,7 @@
+export {
+  Runnable,
+  RunnableLambda,
+  RunnableSequence,
+} from '@langchain/core/runnables';
+
+export type { RunnableConfig } from '@langchain/core/runnables';

package/src/langchain/tools.ts

@@ -0,0 +1,8 @@
+export {
+  DynamicStructuredTool,
+  StructuredTool,
+  Tool,
+  tool,
+} from '@langchain/core/tools';
+
+export type { StructuredToolInterface } from '@langchain/core/tools';

package/src/langchain/utils/env.ts

@@ -0,0 +1 @@
+export { getEnvironmentVariable } from '@langchain/core/utils/env';