langchain 0.1.32 → 0.1.33

package/dist/agents/agent.cjs

@@ -246,7 +246,8 @@ class RunnableMultiActionAgent extends BaseMultiActionAgent {
         });
         this.runnable = fields.runnable;
         this.stop = fields.stop;
-        this.defaultRunName = fields.defaultRunName ?? this.defaultRunName;
+        this.defaultRunName =
+            fields.defaultRunName ?? this.runnable.name ?? this.defaultRunName;
         this.streamRunnable = fields.streamRunnable ?? this.streamRunnable;
     }
     async plan(steps, inputs, callbackManager, config) {

package/dist/agents/agent.js

@@ -237,7 +237,8 @@ export class RunnableMultiActionAgent extends BaseMultiActionAgent {
         });
         this.runnable = fields.runnable;
         this.stop = fields.stop;
-        this.defaultRunName = fields.defaultRunName ?? this.defaultRunName;
+        this.defaultRunName =
+            fields.defaultRunName ?? this.runnable.name ?? this.defaultRunName;
         this.streamRunnable = fields.streamRunnable ?? this.streamRunnable;
     }
     async plan(steps, inputs, callbackManager, config) {

package/dist/agents/format_scratchpad/openai_tools.cjs

@@ -1,19 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatToOpenAIToolMessages = void 0;
-const messages_1 = require("@langchain/core/messages");
-function formatToOpenAIToolMessages(steps) {
-    return steps.flatMap(({ action, observation }) => {
-        if ("messageLog" in action && action.messageLog !== undefined) {
-            const log = action.messageLog;
-            return log.concat(new messages_1.ToolMessage({
-                content: observation,
-                tool_call_id: action.toolCallId,
-            }));
-        }
-        else {
-            return [new messages_1.AIMessage(action.log)];
-        }
-    });
-}
-exports.formatToOpenAIToolMessages = formatToOpenAIToolMessages;
+const tool_calling_js_1 = require("./tool_calling.cjs");
+Object.defineProperty(exports, "formatToOpenAIToolMessages", { enumerable: true, get: function () { return tool_calling_js_1.formatToToolMessages; } });

package/dist/agents/format_scratchpad/openai_tools.d.ts

@@ -1,3 +1,2 @@
-import { type BaseMessage } from "@langchain/core/messages";
-import type { ToolsAgentStep } from "../openai/output_parser.js";
-export declare function formatToOpenAIToolMessages(steps: ToolsAgentStep[]): BaseMessage[];
+import { formatToToolMessages as formatToOpenAIToolMessages } from "./tool_calling.js";
+export { formatToOpenAIToolMessages };

package/dist/agents/format_scratchpad/openai_tools.js

@@ -1,15 +1,2 @@
-import { ToolMessage, AIMessage, } from "@langchain/core/messages";
-export function formatToOpenAIToolMessages(steps) {
-    return steps.flatMap(({ action, observation }) => {
-        if ("messageLog" in action && action.messageLog !== undefined) {
-            const log = action.messageLog;
-            return log.concat(new ToolMessage({
-                content: observation,
-                tool_call_id: action.toolCallId,
-            }));
-        }
-        else {
-            return [new AIMessage(action.log)];
-        }
-    });
-}
+import { formatToToolMessages as formatToOpenAIToolMessages } from "./tool_calling.js";
+export { formatToOpenAIToolMessages };

package/dist/agents/format_scratchpad/tool_calling.cjs

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatToToolMessages = exports._createToolMessage = void 0;
+const messages_1 = require("@langchain/core/messages");
+/**
+ * Convert agent action and observation into a function message.
+ * @param agentAction - The tool invocation request from the agent
+ * @param observation - The result of the tool invocation
+ * @returns FunctionMessage that corresponds to the original tool invocation
+ */
+function _createToolMessage(step) {
+    return new messages_1.ToolMessage({
+        tool_call_id: step.action.toolCallId,
+        content: step.observation,
+        additional_kwargs: { name: step.action.tool },
+    });
+}
+exports._createToolMessage = _createToolMessage;
+function formatToToolMessages(steps) {
+    return steps.flatMap(({ action, observation }) => {
+        if ("messageLog" in action && action.messageLog !== undefined) {
+            const log = action.messageLog;
+            return log.concat(_createToolMessage({ action, observation }));
+        }
+        else {
+            return [new messages_1.AIMessage(action.log)];
+        }
+    });
+}
+exports.formatToToolMessages = formatToToolMessages;

package/dist/agents/format_scratchpad/tool_calling.d.ts

@@ -0,0 +1,10 @@
+import { BaseMessage, ToolMessage } from "@langchain/core/messages";
+import { ToolsAgentStep } from "../tool_calling/output_parser.js";
+/**
+ * Convert agent action and observation into a function message.
+ * @param agentAction - The tool invocation request from the agent
+ * @param observation - The result of the tool invocation
+ * @returns FunctionMessage that corresponds to the original tool invocation
+ */
+export declare function _createToolMessage(step: ToolsAgentStep): ToolMessage;
+export declare function formatToToolMessages(steps: ToolsAgentStep[]): BaseMessage[];

package/dist/agents/format_scratchpad/tool_calling.js

@@ -0,0 +1,25 @@
+import { AIMessage, ToolMessage } from "@langchain/core/messages";
+/**
+ * Convert agent action and observation into a function message.
+ * @param agentAction - The tool invocation request from the agent
+ * @param observation - The result of the tool invocation
+ * @returns FunctionMessage that corresponds to the original tool invocation
+ */
+export function _createToolMessage(step) {
+    return new ToolMessage({
+        tool_call_id: step.action.toolCallId,
+        content: step.observation,
+        additional_kwargs: { name: step.action.tool },
+    });
+}
+export function formatToToolMessages(steps) {
+    return steps.flatMap(({ action, observation }) => {
+        if ("messageLog" in action && action.messageLog !== undefined) {
+            const log = action.messageLog;
+            return log.concat(_createToolMessage({ action, observation }));
+        }
+        else {
+            return [new AIMessage(action.log)];
+        }
+    });
+}

package/dist/agents/index.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createReactAgent = exports.createXmlAgent = exports.XMLAgent = exports.createOpenAIToolsAgent = exports.createOpenAIFunctionsAgent = exports.OpenAIAgent = exports.StructuredChatOutputParserWithRetries = exports.StructuredChatOutputParser = exports.createStructuredChatAgent = exports.StructuredChatAgent = exports.AgentActionOutputParser = exports.ZeroShotAgentOutputParser = exports.ZeroShotAgent = exports.initializeAgentExecutorWithOptions = exports.initializeAgentExecutor = exports.AgentExecutor = exports.ChatConversationalAgentOutputParserWithRetries = exports.ChatConversationalAgentOutputParser = exports.ChatConversationalAgent = exports.ChatAgentOutputParser = exports.ChatAgent = exports.Toolkit = exports.createVectorStoreRouterAgent = exports.createVectorStoreAgent = exports.createOpenApiAgent = exports.createJsonAgent = exports.ZapierToolKit = exports.VectorStoreToolkit = exports.VectorStoreRouterToolkit = exports.RequestsToolkit = exports.OpenApiToolkit = exports.JsonToolkit = exports.LLMSingleActionAgent = exports.RunnableAgent = exports.BaseMultiActionAgent = exports.BaseSingleActionAgent = exports.Agent = void 0;
+exports.createReactAgent = exports.createXmlAgent = exports.XMLAgent = exports.createToolCallingAgent = exports.createOpenAIToolsAgent = exports.createOpenAIFunctionsAgent = exports.OpenAIAgent = exports.StructuredChatOutputParserWithRetries = exports.StructuredChatOutputParser = exports.createStructuredChatAgent = exports.StructuredChatAgent = exports.AgentActionOutputParser = exports.ZeroShotAgentOutputParser = exports.ZeroShotAgent = exports.initializeAgentExecutorWithOptions = exports.initializeAgentExecutor = exports.AgentExecutor = exports.ChatConversationalAgentOutputParserWithRetries = exports.ChatConversationalAgentOutputParser = exports.ChatConversationalAgent = exports.ChatAgentOutputParser = exports.ChatAgent = exports.Toolkit = exports.createVectorStoreRouterAgent = exports.createVectorStoreAgent = exports.createOpenApiAgent = exports.createJsonAgent = exports.ZapierToolKit = exports.VectorStoreToolkit = exports.VectorStoreRouterToolkit = exports.RequestsToolkit = exports.OpenApiToolkit = exports.JsonToolkit = exports.LLMSingleActionAgent = exports.RunnableAgent = exports.BaseMultiActionAgent = exports.BaseSingleActionAgent = exports.Agent = void 0;
 var agent_js_1 = require("./agent.cjs");
 Object.defineProperty(exports, "Agent", { enumerable: true, get: function () { return agent_js_1.Agent; } });
 Object.defineProperty(exports, "BaseSingleActionAgent", { enumerable: true, get: function () { return agent_js_1.BaseSingleActionAgent; } });
@@ -51,8 +51,10 @@ Object.defineProperty(exports, "OpenAIAgent", { enumerable: true, get: function
 Object.defineProperty(exports, "createOpenAIFunctionsAgent", { enumerable: true, get: function () { return index_js_6.createOpenAIFunctionsAgent; } });
 var index_js_7 = require("./openai_tools/index.cjs");
 Object.defineProperty(exports, "createOpenAIToolsAgent", { enumerable: true, get: function () { return index_js_7.createOpenAIToolsAgent; } });
-var index_js_8 = require("./xml/index.cjs");
-Object.defineProperty(exports, "XMLAgent", { enumerable: true, get: function () { return index_js_8.XMLAgent; } });
-Object.defineProperty(exports, "createXmlAgent", { enumerable: true, get: function () { return index_js_8.createXmlAgent; } });
-var index_js_9 = require("./react/index.cjs");
-Object.defineProperty(exports, "createReactAgent", { enumerable: true, get: function () { return index_js_9.createReactAgent; } });
+var index_js_8 = require("./tool_calling/index.cjs");
+Object.defineProperty(exports, "createToolCallingAgent", { enumerable: true, get: function () { return index_js_8.createToolCallingAgent; } });
+var index_js_9 = require("./xml/index.cjs");
+Object.defineProperty(exports, "XMLAgent", { enumerable: true, get: function () { return index_js_9.XMLAgent; } });
+Object.defineProperty(exports, "createXmlAgent", { enumerable: true, get: function () { return index_js_9.createXmlAgent; } });
+var index_js_10 = require("./react/index.cjs");
+Object.defineProperty(exports, "createReactAgent", { enumerable: true, get: function () { return index_js_10.createReactAgent; } });

package/dist/agents/index.d.ts

@@ -14,6 +14,7 @@ export { StructuredChatAgent, type StructuredChatAgentInput, type StructuredChat
 export { StructuredChatOutputParser, type StructuredChatOutputParserArgs, StructuredChatOutputParserWithRetries, } from "./structured_chat/outputParser.js";
 export { OpenAIAgent, type OpenAIAgentInput, type OpenAIAgentCreatePromptArgs, type CreateOpenAIFunctionsAgentParams, createOpenAIFunctionsAgent, } from "./openai_functions/index.js";
 export { type CreateOpenAIToolsAgentParams, createOpenAIToolsAgent, } from "./openai_tools/index.js";
+export { type CreateToolCallingAgentParams, createToolCallingAgent, } from "./tool_calling/index.js";
 export { XMLAgent, type XMLAgentInput, type CreateXmlAgentParams, createXmlAgent, } from "./xml/index.js";
 export { type CreateReactAgentParams, createReactAgent, } from "./react/index.js";
 export type { AgentAction, AgentFinish, AgentStep, } from "@langchain/core/agents";

package/dist/agents/index.js

@@ -14,5 +14,6 @@ export { StructuredChatAgent, createStructuredChatAgent, } from "./structured_ch
 export { StructuredChatOutputParser, StructuredChatOutputParserWithRetries, } from "./structured_chat/outputParser.js";
 export { OpenAIAgent, createOpenAIFunctionsAgent, } from "./openai_functions/index.js";
 export { createOpenAIToolsAgent, } from "./openai_tools/index.js";
+export { createToolCallingAgent, } from "./tool_calling/index.js";
 export { XMLAgent, createXmlAgent, } from "./xml/index.js";
 export { createReactAgent, } from "./react/index.js";

package/dist/agents/openai_tools/index.cjs

@@ -4,7 +4,7 @@ exports.createOpenAIToolsAgent = exports.OpenAIToolsAgentOutputParser = void 0;
 const runnables_1 = require("@langchain/core/runnables");
 const function_calling_1 = require("@langchain/core/utils/function_calling");
 const openai_tools_js_1 = require("../format_scratchpad/openai_tools.cjs");
-const output_parser_js_1 = require("../openai/output_parser.cjs");
+const output_parser_js_1 = require("./output_parser.cjs");
 Object.defineProperty(exports, "OpenAIToolsAgentOutputParser", { enumerable: true, get: function () { return output_parser_js_1.OpenAIToolsAgentOutputParser; } });
 const agent_js_1 = require("../agent.cjs");
 /**

package/dist/agents/openai_tools/index.d.ts

@@ -2,7 +2,7 @@ import type { StructuredToolInterface } from "@langchain/core/tools";
 import type { BaseChatModel, BaseChatModelCallOptions } from "@langchain/core/language_models/chat_models";
 import { ChatPromptTemplate } from "@langchain/core/prompts";
 import { OpenAIClient } from "@langchain/openai";
-import { OpenAIToolsAgentOutputParser, type ToolsAgentStep } from "../openai/output_parser.js";
+import { OpenAIToolsAgentOutputParser, type ToolsAgentStep } from "./output_parser.js";
 import { AgentRunnableSequence } from "../agent.js";
 export { OpenAIToolsAgentOutputParser, type ToolsAgentStep };
 /**

package/dist/agents/openai_tools/index.js

@@ -1,7 +1,7 @@
 import { RunnablePassthrough } from "@langchain/core/runnables";
 import { convertToOpenAITool } from "@langchain/core/utils/function_calling";
 import { formatToOpenAIToolMessages } from "../format_scratchpad/openai_tools.js";
-import { OpenAIToolsAgentOutputParser, } from "../openai/output_parser.js";
+import { OpenAIToolsAgentOutputParser, } from "./output_parser.js";
 import { AgentRunnableSequence } from "../agent.js";
 export { OpenAIToolsAgentOutputParser };
 /**

package/dist/agents/openai_tools/output_parser.cjs

@@ -7,7 +7,6 @@ const types_js_1 = require("../types.cjs");
 /**
  * @example
  * ```typescript
- *
  * const prompt = ChatPromptTemplate.fromMessages([
  *   ["ai", "You are a helpful assistant"],
  *   ["human", "{input}"],
@@ -32,7 +31,6 @@ const types_js_1 = require("../types.cjs");
  *   input:
  *     "What is the sum of the current temperature in San Francisco, New York, and Tokyo?",
  * });
- *
  * ```
  */
 class OpenAIToolsAgentOutputParser extends types_js_1.AgentMultiActionOutputParser {

package/dist/agents/openai_tools/output_parser.d.ts

@@ -1,21 +1,12 @@
-import { AgentAction, AgentFinish, AgentStep } from "@langchain/core/agents";
+import { AgentAction, AgentFinish } from "@langchain/core/agents";
 import { BaseMessage } from "@langchain/core/messages";
 import { ChatGeneration } from "@langchain/core/outputs";
 import { AgentMultiActionOutputParser } from "../types.js";
-/**
- * Type that represents an agent action with an optional message log.
- */
-export type ToolsAgentAction = AgentAction & {
-    toolCallId: string;
-    messageLog?: BaseMessage[];
-};
-export type ToolsAgentStep = AgentStep & {
-    action: ToolsAgentAction;
-};
+import { ToolsAgentAction, ToolsAgentStep } from "../tool_calling/output_parser.js";
+export type { ToolsAgentAction, ToolsAgentStep };
 /**
  * @example
  * ```typescript
- *
  * const prompt = ChatPromptTemplate.fromMessages([
  *   ["ai", "You are a helpful assistant"],
  *   ["human", "{input}"],
@@ -40,7 +31,6 @@ export type ToolsAgentStep = AgentStep & {
  *   input:
  *     "What is the sum of the current temperature in San Francisco, New York, and Tokyo?",
  * });
- *
  * ```
  */
 export declare class OpenAIToolsAgentOutputParser extends AgentMultiActionOutputParser {

package/dist/agents/openai_tools/output_parser.js

@@ -4,7 +4,6 @@ import { AgentMultiActionOutputParser } from "../types.js";
 /**
  * @example
  * ```typescript
- *
  * const prompt = ChatPromptTemplate.fromMessages([
  *   ["ai", "You are a helpful assistant"],
  *   ["human", "{input}"],
@@ -29,7 +28,6 @@ import { AgentMultiActionOutputParser } from "../types.js";
  *   input:
  *     "What is the sum of the current temperature in San Francisco, New York, and Tokyo?",
  * });
- *
  * ```
  */
 export class OpenAIToolsAgentOutputParser extends AgentMultiActionOutputParser {

package/dist/agents/tool_calling/index.cjs

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createToolCallingAgent = void 0;
+const runnables_1 = require("@langchain/core/runnables");
+const agent_js_1 = require("../agent.cjs");
+const output_parser_js_1 = require("./output_parser.cjs");
+const tool_calling_js_1 = require("../format_scratchpad/tool_calling.cjs");
+/**
+ * Create an agent that uses tools.
+ * @param params Params required to create the agent. Includes an LLM, tools, and prompt.
+ * @returns A runnable sequence representing an agent. It takes as input all the same input
+ *     variables as the prompt passed in does. It returns as output either an
+ *     AgentAction or AgentFinish.
+ * @example
+ * ```typescript
+ * import { ChatAnthropic } from "@langchain/anthropic";
+ * import { ChatPromptTemplate, MessagesPlaceholder } from "@langchain/core/prompts";
+ * import { AgentExecutor, createToolCallingAgent } from "langchain/agents";
+ *
+ * const prompt = ChatPromptTemplate.fromMessages(
+ *   [
+ *     ["system", "You are a helpful assistant"],
+ *     ["placeholder", "{chat_history}"],
+ *     ["human", "{input}"],
+ *     ["placeholder", "{agent_scratchpad}"],
+ *   ]
+ * );
+ *
+ *
+ * const llm = new ChatAnthropic({
+ *   modelName: "claude-3-opus-20240229",
+ *   temperature: 0,
+ * });
+ *
+ * // Define the tools the agent will have access to.
+ * const tools = [...];
+ *
+ * const agent = createToolCallingAgent({ llm, tools, prompt });
+ *
+ * const agentExecutor = new AgentExecutor({ agent, tools });
+ *
+ * const result = await agentExecutor.invoke({input: "what is LangChain?"});
+ *
+ * // Using with chat history
+ * import { AIMessage, HumanMessage } from "@langchain/core/messages";
+ *
+ * const result2 = await agentExecutor.invoke(
+ *   {
+ *     input: "what's my name?",
+ *     chat_history: [
+ *       new HumanMessage({content: "hi! my name is bob"}),
+ *       new AIMessage({content: "Hello Bob! How can I assist you today?"}),
+ *     ],
+ *   }
+ * );
+ * ```
+ */
+function createToolCallingAgent({ llm, tools, prompt, streamRunnable, }) {
+    if (!prompt.inputVariables.includes("agent_scratchpad")) {
+        throw new Error([
+            `Prompt must have an input variable named "agent_scratchpad".`,
+            `Found ${JSON.stringify(prompt.inputVariables)} instead.`,
+        ].join("\n"));
+    }
+    if (llm.bindTools === undefined) {
+        throw new Error(`This agent requires that the "bind_tools()" method be implemented on the input model.`);
+    }
+    const modelWithTools = llm.bindTools(tools);
+    const agent = agent_js_1.AgentRunnableSequence.fromRunnables([
+        runnables_1.RunnablePassthrough.assign({
+            agent_scratchpad: (input) => (0, tool_calling_js_1.formatToToolMessages)(input.steps),
+        }),
+        prompt,
+        modelWithTools,
+        new output_parser_js_1.ToolCallingAgentOutputParser(),
+    ], {
+        name: "ToolCallingAgent",
+        streamRunnable,
+        singleAction: false,
+    });
+    return agent;
+}
+exports.createToolCallingAgent = createToolCallingAgent;

package/dist/agents/tool_calling/index.d.ts

@@ -0,0 +1,78 @@
+import { BaseChatModel } from "@langchain/core/language_models/chat_models";
+import { ChatPromptTemplate } from "@langchain/core/prompts";
+import { StructuredToolInterface } from "@langchain/core/tools";
+import { AgentRunnableSequence } from "../agent.js";
+import { ToolsAgentStep } from "./output_parser.js";
+/**
+ * Params used by the createOpenAIToolsAgent function.
+ */
+export type CreateToolCallingAgentParams = {
+    /**
+     * LLM to use as the agent. Should work with OpenAI tool calling,
+     * so must either be an OpenAI model that supports that or a wrapper of
+     * a different model that adds in equivalent support.
+     */
+    llm: BaseChatModel;
+    /** Tools this agent has access to. */
+    tools: StructuredToolInterface[];
+    /** The prompt to use, must have an input key of `agent_scratchpad`. */
+    prompt: ChatPromptTemplate;
+    /**
+     * Whether to invoke the underlying model in streaming mode,
+     * allowing streaming of intermediate steps. Defaults to true.
+     */
+    streamRunnable?: boolean;
+};
+/**
+ * Create an agent that uses tools.
+ * @param params Params required to create the agent. Includes an LLM, tools, and prompt.
+ * @returns A runnable sequence representing an agent. It takes as input all the same input
+ *     variables as the prompt passed in does. It returns as output either an
+ *     AgentAction or AgentFinish.
+ * @example
+ * ```typescript
+ * import { ChatAnthropic } from "@langchain/anthropic";
+ * import { ChatPromptTemplate, MessagesPlaceholder } from "@langchain/core/prompts";
+ * import { AgentExecutor, createToolCallingAgent } from "langchain/agents";
+ *
+ * const prompt = ChatPromptTemplate.fromMessages(
+ *   [
+ *     ["system", "You are a helpful assistant"],
+ *     ["placeholder", "{chat_history}"],
+ *     ["human", "{input}"],
+ *     ["placeholder", "{agent_scratchpad}"],
+ *   ]
+ * );
+ *
+ *
+ * const llm = new ChatAnthropic({
+ *   modelName: "claude-3-opus-20240229",
+ *   temperature: 0,
+ * });
+ *
+ * // Define the tools the agent will have access to.
+ * const tools = [...];
+ *
+ * const agent = createToolCallingAgent({ llm, tools, prompt });
+ *
+ * const agentExecutor = new AgentExecutor({ agent, tools });
+ *
+ * const result = await agentExecutor.invoke({input: "what is LangChain?"});
+ *
+ * // Using with chat history
+ * import { AIMessage, HumanMessage } from "@langchain/core/messages";
+ *
+ * const result2 = await agentExecutor.invoke(
+ *   {
+ *     input: "what's my name?",
+ *     chat_history: [
+ *       new HumanMessage({content: "hi! my name is bob"}),
+ *       new AIMessage({content: "Hello Bob! How can I assist you today?"}),
+ *     ],
+ *   }
+ * );
+ * ```
+ */
+export declare function createToolCallingAgent({ llm, tools, prompt, streamRunnable, }: CreateToolCallingAgentParams): AgentRunnableSequence<{
+    steps: ToolsAgentStep[];
+}, import("@langchain/core/agents").AgentFinish | import("@langchain/core/agents").AgentAction[]>;

package/dist/agents/tool_calling/index.js

@@ -0,0 +1,79 @@
+import { RunnablePassthrough } from "@langchain/core/runnables";
+import { AgentRunnableSequence } from "../agent.js";
+import { ToolCallingAgentOutputParser, } from "./output_parser.js";
+import { formatToToolMessages } from "../format_scratchpad/tool_calling.js";
+/**
+ * Create an agent that uses tools.
+ * @param params Params required to create the agent. Includes an LLM, tools, and prompt.
+ * @returns A runnable sequence representing an agent. It takes as input all the same input
+ *     variables as the prompt passed in does. It returns as output either an
+ *     AgentAction or AgentFinish.
+ * @example
+ * ```typescript
+ * import { ChatAnthropic } from "@langchain/anthropic";
+ * import { ChatPromptTemplate, MessagesPlaceholder } from "@langchain/core/prompts";
+ * import { AgentExecutor, createToolCallingAgent } from "langchain/agents";
+ *
+ * const prompt = ChatPromptTemplate.fromMessages(
+ *   [
+ *     ["system", "You are a helpful assistant"],
+ *     ["placeholder", "{chat_history}"],
+ *     ["human", "{input}"],
+ *     ["placeholder", "{agent_scratchpad}"],
+ *   ]
+ * );
+ *
+ *
+ * const llm = new ChatAnthropic({
+ *   modelName: "claude-3-opus-20240229",
+ *   temperature: 0,
+ * });
+ *
+ * // Define the tools the agent will have access to.
+ * const tools = [...];
+ *
+ * const agent = createToolCallingAgent({ llm, tools, prompt });
+ *
+ * const agentExecutor = new AgentExecutor({ agent, tools });
+ *
+ * const result = await agentExecutor.invoke({input: "what is LangChain?"});
+ *
+ * // Using with chat history
+ * import { AIMessage, HumanMessage } from "@langchain/core/messages";
+ *
+ * const result2 = await agentExecutor.invoke(
+ *   {
+ *     input: "what's my name?",
+ *     chat_history: [
+ *       new HumanMessage({content: "hi! my name is bob"}),
+ *       new AIMessage({content: "Hello Bob! How can I assist you today?"}),
+ *     ],
+ *   }
+ * );
+ * ```
+ */
+export function createToolCallingAgent({ llm, tools, prompt, streamRunnable, }) {
+    if (!prompt.inputVariables.includes("agent_scratchpad")) {
+        throw new Error([
+            `Prompt must have an input variable named "agent_scratchpad".`,
+            `Found ${JSON.stringify(prompt.inputVariables)} instead.`,
+        ].join("\n"));
+    }
+    if (llm.bindTools === undefined) {
+        throw new Error(`This agent requires that the "bind_tools()" method be implemented on the input model.`);
+    }
+    const modelWithTools = llm.bindTools(tools);
+    const agent = AgentRunnableSequence.fromRunnables([
+        RunnablePassthrough.assign({
+            agent_scratchpad: (input) => formatToToolMessages(input.steps),
+        }),
+        prompt,
+        modelWithTools,
+        new ToolCallingAgentOutputParser(),
+    ], {
+        name: "ToolCallingAgent",
+        streamRunnable,
+        singleAction: false,
+    });
+    return agent;
+}

package/dist/agents/tool_calling/output_parser.cjs

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolCallingAgentOutputParser = exports.parseAIMessageToToolAction = void 0;
+const messages_1 = require("@langchain/core/messages");
+const output_parsers_1 = require("@langchain/core/output_parsers");
+const types_js_1 = require("../types.cjs");
+function parseAIMessageToToolAction(message) {
+    const stringifiedMessageContent = typeof message.content === "string"
+        ? message.content
+        : JSON.stringify(message.content);
+    let toolCalls = [];
+    if (message.tool_calls !== undefined && message.tool_calls.length > 0) {
+        toolCalls = message.tool_calls;
+    }
+    else {
+        if (message.additional_kwargs.tool_calls === undefined ||
+            message.additional_kwargs.tool_calls.length === 0) {
+            return {
+                returnValues: { output: message.content },
+                log: stringifiedMessageContent,
+            };
+        }
+        // Best effort parsing
+        for (const toolCall of message.additional_kwargs.tool_calls ?? []) {
+            const functionName = toolCall.function?.name;
+            try {
+                const args = JSON.parse(toolCall.function.arguments);
+                toolCalls.push({ name: functionName, args, id: toolCall.id });
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            }
+            catch (e) {
+                throw new output_parsers_1.OutputParserException(`Failed to parse tool arguments from chat model response. Text: "${JSON.stringify(toolCalls)}". ${e}`);
+            }
+        }
+    }
+    return toolCalls.map((toolCall, i) => {
+        const messageLog = i === 0 ? [message] : [];
+        const log = `Invoking "${toolCall.name}" with ${JSON.stringify(toolCall.args ?? {})}\n${stringifiedMessageContent}`;
+        return {
+            tool: toolCall.name,
+            toolInput: toolCall.args,
+            toolCallId: toolCall.id ?? "",
+            log,
+            messageLog,
+        };
+    });
+}
+exports.parseAIMessageToToolAction = parseAIMessageToToolAction;
+class ToolCallingAgentOutputParser extends types_js_1.AgentMultiActionOutputParser {
+    constructor() {
+        super(...arguments);
+        Object.defineProperty(this, "lc_namespace", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: ["langchain", "agents", "tool_calling"]
+        });
+    }
+    static lc_name() {
+        return "ToolCallingAgentOutputParser";
+    }
+    async parse(text) {
+        throw new Error(`ToolCallingAgentOutputParser can only parse messages.\nPassed input: ${text}`);
+    }
+    async parseResult(generations) {
+        if ("message" in generations[0] && (0, messages_1.isBaseMessage)(generations[0].message)) {
+            return parseAIMessageToToolAction(generations[0].message);
+        }
+        throw new Error("parseResult on ToolCallingAgentOutputParser only works on ChatGeneration output");
+    }
+    getFormatInstructions() {
+        throw new Error("getFormatInstructions not implemented inside ToolCallingAgentOutputParser.");
+    }
+}
+exports.ToolCallingAgentOutputParser = ToolCallingAgentOutputParser;

package/dist/agents/tool_calling/output_parser.d.ts

@@ -0,0 +1,22 @@
+import { AgentAction, AgentFinish, AgentStep } from "@langchain/core/agents";
+import { AIMessage, BaseMessage } from "@langchain/core/messages";
+import { ChatGeneration } from "@langchain/core/outputs";
+import { AgentMultiActionOutputParser } from "../types.js";
+/**
+ * Type that represents an agent action with an optional message log.
+ */
+export type ToolsAgentAction = AgentAction & {
+    toolCallId: string;
+    messageLog?: BaseMessage[];
+};
+export type ToolsAgentStep = AgentStep & {
+    action: ToolsAgentAction;
+};
+export declare function parseAIMessageToToolAction(message: AIMessage): ToolsAgentAction[] | AgentFinish;
+export declare class ToolCallingAgentOutputParser extends AgentMultiActionOutputParser {
+    lc_namespace: string[];
+    static lc_name(): string;
+    parse(text: string): Promise<AgentAction[] | AgentFinish>;
+    parseResult(generations: ChatGeneration[]): Promise<AgentFinish | ToolsAgentAction[]>;
+    getFormatInstructions(): string;
+}

package/dist/agents/tool_calling/output_parser.js

@@ -0,0 +1,70 @@
+import { isBaseMessage, } from "@langchain/core/messages";
+import { OutputParserException } from "@langchain/core/output_parsers";
+import { AgentMultiActionOutputParser } from "../types.js";
+export function parseAIMessageToToolAction(message) {
+    const stringifiedMessageContent = typeof message.content === "string"
+        ? message.content
+        : JSON.stringify(message.content);
+    let toolCalls = [];
+    if (message.tool_calls !== undefined && message.tool_calls.length > 0) {
+        toolCalls = message.tool_calls;
+    }
+    else {
+        if (message.additional_kwargs.tool_calls === undefined ||
+            message.additional_kwargs.tool_calls.length === 0) {
+            return {
+                returnValues: { output: message.content },
+                log: stringifiedMessageContent,
+            };
+        }
+        // Best effort parsing
+        for (const toolCall of message.additional_kwargs.tool_calls ?? []) {
+            const functionName = toolCall.function?.name;
+            try {
+                const args = JSON.parse(toolCall.function.arguments);
+                toolCalls.push({ name: functionName, args, id: toolCall.id });
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            }
+            catch (e) {
+                throw new OutputParserException(`Failed to parse tool arguments from chat model response. Text: "${JSON.stringify(toolCalls)}". ${e}`);
+            }
+        }
+    }
+    return toolCalls.map((toolCall, i) => {
+        const messageLog = i === 0 ? [message] : [];
+        const log = `Invoking "${toolCall.name}" with ${JSON.stringify(toolCall.args ?? {})}\n${stringifiedMessageContent}`;
+        return {
+            tool: toolCall.name,
+            toolInput: toolCall.args,
+            toolCallId: toolCall.id ?? "",
+            log,
+            messageLog,
+        };
+    });
+}
+export class ToolCallingAgentOutputParser extends AgentMultiActionOutputParser {
+    constructor() {
+        super(...arguments);
+        Object.defineProperty(this, "lc_namespace", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: ["langchain", "agents", "tool_calling"]
+        });
+    }
+    static lc_name() {
+        return "ToolCallingAgentOutputParser";
+    }
+    async parse(text) {
+        throw new Error(`ToolCallingAgentOutputParser can only parse messages.\nPassed input: ${text}`);
+    }
+    async parseResult(generations) {
+        if ("message" in generations[0] && isBaseMessage(generations[0].message)) {
+            return parseAIMessageToToolAction(generations[0].message);
+        }
+        throw new Error("parseResult on ToolCallingAgentOutputParser only works on ChatGeneration output");
+    }
+    getFormatInstructions() {
+        throw new Error("getFormatInstructions not implemented inside ToolCallingAgentOutputParser.");
+    }
+}

package/dist/chains/openai_functions/extraction.d.ts

@@ -10,7 +10,7 @@ import { LLMChain } from "../llm_chain.js";
  * @param llm Must be a ChatOpenAI or AnthropicFunctions model that supports function calling.
  * @returns A LLMChain instance configured to return data matching the schema.
  */
-export declare function createExtractionChain(schema: FunctionParameters, llm: BaseChatModel<BaseFunctionCallOptions>): LLMChain<object, BaseChatModel<BaseFunctionCallOptions>>;
+export declare function createExtractionChain(schema: FunctionParameters, llm: BaseChatModel<BaseFunctionCallOptions>): LLMChain<object, BaseChatModel<BaseFunctionCallOptions, import("@langchain/core/messages").BaseMessageChunk>>;
 /**
  * Function that creates an extraction chain from a Zod schema. It
  * converts the Zod schema to a JSON schema using zod-to-json-schema
@@ -19,4 +19,4 @@ export declare function createExtractionChain(schema: FunctionParameters, llm: B
  * @param llm Must be a ChatOpenAI or AnthropicFunctions model that supports function calling.
  * @returns A LLMChain instance configured to return data matching the schema.
  */
-export declare function createExtractionChainFromZod(schema: z.ZodObject<any, any, any, any>, llm: BaseChatModel<BaseFunctionCallOptions>): LLMChain<object, BaseChatModel<BaseFunctionCallOptions>>;
+export declare function createExtractionChainFromZod(schema: z.ZodObject<any, any, any, any>, llm: BaseChatModel<BaseFunctionCallOptions>): LLMChain<object, BaseChatModel<BaseFunctionCallOptions, import("@langchain/core/messages").BaseMessageChunk>>;

package/dist/chains/openai_functions/structured_output.d.ts

@@ -55,6 +55,6 @@ export declare class FunctionCallStructuredOutputParser<T extends z.AnyZodObject
  * as well as an additional required "outputSchema" JSON Schema object.
  * @returns OpenAPIChain
  */
-export declare function createStructuredOutputChain<T extends z.AnyZodObject = z.AnyZodObject>(input: StructuredOutputChainInput<T>): LLMChain<any, BaseChatModel<BaseFunctionCallOptions> | ChatOpenAI<BaseFunctionCallOptions>>;
+export declare function createStructuredOutputChain<T extends z.AnyZodObject = z.AnyZodObject>(input: StructuredOutputChainInput<T>): LLMChain<any, BaseChatModel<BaseFunctionCallOptions, import("@langchain/core/messages").BaseMessageChunk> | ChatOpenAI<BaseFunctionCallOptions>>;
 /** @deprecated Use {@link https://api.js.langchain.com/functions/langchain_chains_openai_functions.createStructuredOutputRunnable.html | createStructuredOutputRunnable} instead */
-export declare function createStructuredOutputChainFromZod<T extends z.AnyZodObject>(zodSchema: T, input: Omit<StructuredOutputChainInput<T>, "outputSchema">): LLMChain<any, BaseChatModel<BaseFunctionCallOptions> | ChatOpenAI<BaseFunctionCallOptions>>;
+export declare function createStructuredOutputChainFromZod<T extends z.AnyZodObject>(zodSchema: T, input: Omit<StructuredOutputChainInput<T>, "outputSchema">): LLMChain<any, BaseChatModel<BaseFunctionCallOptions, import("@langchain/core/messages").BaseMessageChunk> | ChatOpenAI<BaseFunctionCallOptions>>;

package/dist/chains/openai_functions/tagging.d.ts

@@ -23,7 +23,7 @@ export type TaggingChainOptions = {
  * Switch to expression language: https://js.langchain.com/docs/expression_language/
  * Will be removed in 0.2.0
  */
-export declare function createTaggingChain(schema: FunctionParameters, llm: BaseChatModel<BaseFunctionCallOptions>, options?: TaggingChainOptions): LLMChain<object, BaseChatModel<BaseFunctionCallOptions>>;
+export declare function createTaggingChain(schema: FunctionParameters, llm: BaseChatModel<BaseFunctionCallOptions>, options?: TaggingChainOptions): LLMChain<object, BaseChatModel<BaseFunctionCallOptions, import("@langchain/core/messages").BaseMessageChunk>>;
 /**
  * Function that creates a tagging chain from a Zod schema. It converts
  * the Zod schema to a JSON schema using the zodToJsonSchema function and
@@ -37,4 +37,4 @@ export declare function createTaggingChain(schema: FunctionParameters, llm: Base
  * Switch to expression language: https://js.langchain.com/docs/expression_language/
  * Will be removed in 0.2.0
  */
-export declare function createTaggingChainFromZod(schema: z.ZodObject<any, any, any, any>, llm: BaseChatModel<BaseFunctionCallOptions>, options?: TaggingChainOptions): LLMChain<object, BaseChatModel<BaseFunctionCallOptions>>;
+export declare function createTaggingChainFromZod(schema: z.ZodObject<any, any, any, any>, llm: BaseChatModel<BaseFunctionCallOptions>, options?: TaggingChainOptions): LLMChain<object, BaseChatModel<BaseFunctionCallOptions, import("@langchain/core/messages").BaseMessageChunk>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langchain",
-  "version": "0.1.32",
+  "version": "0.1.33",
   "description": "Typescript bindings for langchain",
   "type": "module",
   "engines": {
@@ -1190,7 +1190,7 @@
   "homepage": "https://github.com/langchain-ai/langchainjs/tree/main/langchain/",
   "scripts": {
     "build": "yarn run build:deps && yarn clean && yarn build:esm && yarn build:cjs && yarn build:scripts",
-    "build:deps": "yarn run turbo:command build --filter=@langchain/anthropic --filter=@langchain/openai --filter=@langchain/community --concurrency=1",
+    "build:deps": "yarn run turbo:command build --filter=@langchain/openai --filter=@langchain/community --concurrency=1",
     "build:esm": "NODE_OPTIONS=--max-old-space-size=4096 tsc --outDir dist/ && rimraf dist/tests dist/**/tests",
     "build:cjs": "NODE_OPTIONS=--max-old-space-size=4096 tsc --outDir dist-cjs/ -p tsconfig.cjs.json && yarn move-cjs-to-dist && rimraf dist-cjs",
     "build:watch": "yarn create-entrypoints && tsc --outDir dist/ --watch",
@@ -1512,9 +1512,9 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.9.1",
-    "@langchain/community": "~0.0.41",
-    "@langchain/core": "~0.1.44",
-    "@langchain/openai": "~0.0.26",
+    "@langchain/community": "~0.0.47",
+    "@langchain/core": "~0.1.56",
+    "@langchain/openai": "~0.0.28",
     "binary-extensions": "^2.2.0",
     "js-tiktoken": "^1.0.7",
     "js-yaml": "^4.1.0",