@langchain/langgraph 0.4.9 → 1.0.0-alpha.1

package/dist/prebuilt/react_agent_executor.js

@@ -1,492 +1,342 @@
-import { isAIMessage, isBaseMessage, isToolMessage, SystemMessage, } from "@langchain/core/messages";
-import { Runnable, RunnableLambda, RunnableSequence, RunnableBinding, } from "@langchain/core/runnables";
-import { StateGraph, } from "../graph/index.js";
-import { ToolNode } from "./tool_node.js";
 import { Annotation } from "../graph/annotation.js";
+import { END, START, Send } from "../constants.js";
+import { StateGraph } from "../graph/state.js";
 import { messagesStateReducer } from "../graph/message.js";
-import { END, Send, START } from "../constants.js";
+import "../graph/index.js";
+import { ToolNode } from "./tool_node.js";
 import { withAgentName } from "./agentName.js";
+import { Runnable, RunnableBinding, RunnableLambda, RunnableSequence } from "@langchain/core/runnables";
+import { SystemMessage, isAIMessage, isBaseMessage, isToolMessage } from "@langchain/core/messages";
+
+//#region src/prebuilt/react_agent_executor.ts
 function _convertMessageModifierToPrompt(messageModifier) {
-    // Handle string or SystemMessage
-    if (typeof messageModifier === "string" ||
-        (isBaseMessage(messageModifier) && messageModifier._getType() === "system")) {
-        return messageModifier;
-    }
-    // Handle callable function
-    if (typeof messageModifier === "function") {
-        return async (state) => messageModifier(state.messages);
-    }
-    // Handle Runnable
-    if (Runnable.isRunnable(messageModifier)) {
-        return RunnableLambda.from((state) => state.messages).pipe(messageModifier);
-    }
-    throw new Error(`Unexpected type for messageModifier: ${typeof messageModifier}`);
+	if (typeof messageModifier === "string" || isBaseMessage(messageModifier) && messageModifier._getType() === "system") return messageModifier;
+	if (typeof messageModifier === "function") return async (state) => messageModifier(state.messages);
+	if (Runnable.isRunnable(messageModifier)) return RunnableLambda.from((state) => state.messages).pipe(messageModifier);
+	throw new Error(`Unexpected type for messageModifier: ${typeof messageModifier}`);
 }
 const PROMPT_RUNNABLE_NAME = "prompt";
 function _getPromptRunnable(prompt) {
-    let promptRunnable;
-    if (prompt == null) {
-        promptRunnable = RunnableLambda.from((state) => state.messages).withConfig({ runName: PROMPT_RUNNABLE_NAME });
-    }
-    else if (typeof prompt === "string") {
-        const systemMessage = new SystemMessage(prompt);
-        promptRunnable = RunnableLambda.from((state) => {
-            return [systemMessage, ...(state.messages ?? [])];
-        }).withConfig({ runName: PROMPT_RUNNABLE_NAME });
-    }
-    else if (isBaseMessage(prompt) && prompt._getType() === "system") {
-        promptRunnable = RunnableLambda.from((state) => [prompt, ...state.messages]).withConfig({ runName: PROMPT_RUNNABLE_NAME });
-    }
-    else if (typeof prompt === "function") {
-        promptRunnable = RunnableLambda.from(prompt).withConfig({
-            runName: PROMPT_RUNNABLE_NAME,
-        });
-    }
-    else if (Runnable.isRunnable(prompt)) {
-        promptRunnable = prompt;
-    }
-    else {
-        throw new Error(`Got unexpected type for 'prompt': ${typeof prompt}`);
-    }
-    return promptRunnable;
+	let promptRunnable;
+	if (prompt == null) promptRunnable = RunnableLambda.from((state) => state.messages).withConfig({ runName: PROMPT_RUNNABLE_NAME });
+	else if (typeof prompt === "string") {
+		const systemMessage = new SystemMessage(prompt);
+		promptRunnable = RunnableLambda.from((state) => {
+			return [systemMessage, ...state.messages ?? []];
+		}).withConfig({ runName: PROMPT_RUNNABLE_NAME });
+	} else if (isBaseMessage(prompt) && prompt._getType() === "system") promptRunnable = RunnableLambda.from((state) => [prompt, ...state.messages]).withConfig({ runName: PROMPT_RUNNABLE_NAME });
+	else if (typeof prompt === "function") promptRunnable = RunnableLambda.from(prompt).withConfig({ runName: PROMPT_RUNNABLE_NAME });
+	else if (Runnable.isRunnable(prompt)) promptRunnable = prompt;
+	else throw new Error(`Got unexpected type for 'prompt': ${typeof prompt}`);
+	return promptRunnable;
 }
 function isClientTool(tool) {
-    return Runnable.isRunnable(tool);
+	return Runnable.isRunnable(tool);
 }
 function _getPrompt(prompt, stateModifier, messageModifier) {
-    // Check if multiple modifiers exist
-    const definedCount = [prompt, stateModifier, messageModifier].filter((x) => x != null).length;
-    if (definedCount > 1) {
-        throw new Error("Expected only one of prompt, stateModifier, or messageModifier, got multiple values");
-    }
-    let finalPrompt = prompt;
-    if (stateModifier != null) {
-        finalPrompt = stateModifier;
-    }
-    else if (messageModifier != null) {
-        finalPrompt = _convertMessageModifierToPrompt(messageModifier);
-    }
-    return _getPromptRunnable(finalPrompt);
+	const definedCount = [
+		prompt,
+		stateModifier,
+		messageModifier
+	].filter((x) => x != null).length;
+	if (definedCount > 1) throw new Error("Expected only one of prompt, stateModifier, or messageModifier, got multiple values");
+	let finalPrompt = prompt;
+	if (stateModifier != null) finalPrompt = stateModifier;
+	else if (messageModifier != null) finalPrompt = _convertMessageModifierToPrompt(messageModifier);
+	return _getPromptRunnable(finalPrompt);
 }
 function _isBaseChatModel(model) {
-    return ("invoke" in model &&
-        typeof model.invoke === "function" &&
-        "_modelType" in model);
+	return "invoke" in model && typeof model.invoke === "function" && "_modelType" in model;
 }
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 function _isConfigurableModel(model) {
-    return ("_queuedMethodOperations" in model &&
-        "_model" in model &&
-        typeof model._model === "function");
+	return "_queuedMethodOperations" in model && "_model" in model && typeof model._model === "function";
 }
 function _isChatModelWithBindTools(llm) {
-    if (!_isBaseChatModel(llm))
-        return false;
-    return "bindTools" in llm && typeof llm.bindTools === "function";
+	if (!_isBaseChatModel(llm)) return false;
+	return "bindTools" in llm && typeof llm.bindTools === "function";
 }
-export async function _shouldBindTools(llm, tools) {
-    // If model is a RunnableSequence, find a RunnableBinding or BaseChatModel in its steps
-    let model = llm;
-    if (RunnableSequence.isRunnableSequence(model)) {
-        model =
-            model.steps.find((step) => RunnableBinding.isRunnableBinding(step) ||
-                _isBaseChatModel(step) ||
-                _isConfigurableModel(step)) || model;
-    }
-    if (_isConfigurableModel(model)) {
-        model = await model._model();
-    }
-    // If not a RunnableBinding, we should bind tools
-    if (!RunnableBinding.isRunnableBinding(model)) {
-        return true;
-    }
-    let boundTools = (() => {
-        // check if model.kwargs contain the tools key
-        if (model.kwargs != null &&
-            typeof model.kwargs === "object" &&
-            "tools" in model.kwargs &&
-            Array.isArray(model.kwargs.tools)) {
-            return (model.kwargs.tools ?? null);
-        }
-        // Some models can bind the tools via `withConfig()` instead of `bind()`
-        if (model.config != null &&
-            typeof model.config === "object" &&
-            "tools" in model.config &&
-            Array.isArray(model.config.tools)) {
-            return (model.config.tools ?? null);
-        }
-        return null;
-    })();
-    // google-style
-    if (boundTools != null &&
-        boundTools.length === 1 &&
-        "functionDeclarations" in boundTools[0]) {
-        boundTools = boundTools[0].functionDeclarations;
-    }
-    // If no tools in kwargs, we should bind tools
-    if (boundTools == null)
-        return true;
-    // Check if tools count matches
-    if (tools.length !== boundTools.length) {
-        throw new Error("Number of tools in the model.bindTools() and tools passed to createReactAgent must match");
-    }
-    const toolNames = new Set(tools.flatMap((tool) => (isClientTool(tool) ? tool.name : [])));
-    const boundToolNames = new Set();
-    for (const boundTool of boundTools) {
-        let boundToolName;
-        // OpenAI-style tool
-        if ("type" in boundTool && boundTool.type === "function") {
-            boundToolName = boundTool.function.name;
-        }
-        // Anthropic or Google-style tool
-        else if ("name" in boundTool) {
-            boundToolName = boundTool.name;
-        }
-        // Bedrock-style tool
-        else if ("toolSpec" in boundTool && "name" in boundTool.toolSpec) {
-            boundToolName = boundTool.toolSpec.name;
-        }
-        // unknown tool type so we'll ignore it
-        else {
-            continue;
-        }
-        if (boundToolName) {
-            boundToolNames.add(boundToolName);
-        }
-    }
-    const missingTools = [...toolNames].filter((x) => !boundToolNames.has(x));
-    if (missingTools.length > 0) {
-        throw new Error(`Missing tools '${missingTools}' in the model.bindTools().` +
-            `Tools in the model.bindTools() must match the tools passed to createReactAgent.`);
-    }
-    return false;
+async function _shouldBindTools(llm, tools) {
+	let model = llm;
+	if (RunnableSequence.isRunnableSequence(model)) model = model.steps.find((step) => RunnableBinding.isRunnableBinding(step) || _isBaseChatModel(step) || _isConfigurableModel(step)) || model;
+	if (_isConfigurableModel(model)) model = await model._model();
+	if (!RunnableBinding.isRunnableBinding(model)) return true;
+	let boundTools = (() => {
+		if (model.kwargs != null && typeof model.kwargs === "object" && "tools" in model.kwargs && Array.isArray(model.kwargs.tools)) return model.kwargs.tools ?? null;
+		if (model.config != null && typeof model.config === "object" && "tools" in model.config && Array.isArray(model.config.tools)) return model.config.tools ?? null;
+		return null;
+	})();
+	if (boundTools != null && boundTools.length === 1 && "functionDeclarations" in boundTools[0]) boundTools = boundTools[0].functionDeclarations;
+	if (boundTools == null) return true;
+	if (tools.length !== boundTools.length) throw new Error("Number of tools in the model.bindTools() and tools passed to createReactAgent must match");
+	const toolNames = new Set(tools.flatMap((tool) => isClientTool(tool) ? tool.name : []));
+	const boundToolNames = /* @__PURE__ */ new Set();
+	for (const boundTool of boundTools) {
+		let boundToolName;
+		if ("type" in boundTool && boundTool.type === "function") boundToolName = boundTool.function.name;
+		else if ("name" in boundTool) boundToolName = boundTool.name;
+		else if ("toolSpec" in boundTool && "name" in boundTool.toolSpec) boundToolName = boundTool.toolSpec.name;
+		else continue;
+		if (boundToolName) boundToolNames.add(boundToolName);
+	}
+	const missingTools = [...toolNames].filter((x) => !boundToolNames.has(x));
+	if (missingTools.length > 0) throw new Error(`Missing tools '${missingTools}' in the model.bindTools().Tools in the model.bindTools() must match the tools passed to createReactAgent.`);
+	return false;
 }
 const _simpleBindTools = (llm, toolClasses) => {
-    if (_isChatModelWithBindTools(llm)) {
-        return llm.bindTools(toolClasses);
-    }
-    if (RunnableBinding.isRunnableBinding(llm) &&
-        _isChatModelWithBindTools(llm.bound)) {
-        const newBound = llm.bound.bindTools(toolClasses);
-        if (RunnableBinding.isRunnableBinding(newBound)) {
-            return new RunnableBinding({
-                bound: newBound.bound,
-                config: { ...llm.config, ...newBound.config },
-                kwargs: { ...llm.kwargs, ...newBound.kwargs },
-                configFactories: newBound.configFactories ?? llm.configFactories,
-            });
-        }
-        return new RunnableBinding({
-            bound: newBound,
-            config: llm.config,
-            kwargs: llm.kwargs,
-            configFactories: llm.configFactories,
-        });
-    }
-    return null;
+	if (_isChatModelWithBindTools(llm)) return llm.bindTools(toolClasses);
+	if (RunnableBinding.isRunnableBinding(llm) && _isChatModelWithBindTools(llm.bound)) {
+		const newBound = llm.bound.bindTools(toolClasses);
+		if (RunnableBinding.isRunnableBinding(newBound)) return new RunnableBinding({
+			bound: newBound.bound,
+			config: {
+				...llm.config,
+				...newBound.config
+			},
+			kwargs: {
+				...llm.kwargs,
+				...newBound.kwargs
+			},
+			configFactories: newBound.configFactories ?? llm.configFactories
+		});
+		return new RunnableBinding({
+			bound: newBound,
+			config: llm.config,
+			kwargs: llm.kwargs,
+			configFactories: llm.configFactories
+		});
+	}
+	return null;
 };
-export async function _bindTools(llm, toolClasses) {
-    const model = _simpleBindTools(llm, toolClasses);
-    if (model)
-        return model;
-    if (_isConfigurableModel(llm)) {
-        const model = _simpleBindTools(await llm._model(), toolClasses);
-        if (model)
-            return model;
-    }
-    if (RunnableSequence.isRunnableSequence(llm)) {
-        const modelStep = llm.steps.findIndex((step) => RunnableBinding.isRunnableBinding(step) ||
-            _isBaseChatModel(step) ||
-            _isConfigurableModel(step));
-        if (modelStep >= 0) {
-            const model = _simpleBindTools(llm.steps[modelStep], toolClasses);
-            if (model) {
-                const nextSteps = llm.steps.slice();
-                nextSteps.splice(modelStep, 1, model);
-                return RunnableSequence.from(nextSteps);
-            }
-        }
-    }
-    throw new Error(`llm ${llm} must define bindTools method.`);
+async function _bindTools(llm, toolClasses) {
+	const model = _simpleBindTools(llm, toolClasses);
+	if (model) return model;
+	if (_isConfigurableModel(llm)) {
+		const model$1 = _simpleBindTools(await llm._model(), toolClasses);
+		if (model$1) return model$1;
+	}
+	if (RunnableSequence.isRunnableSequence(llm)) {
+		const modelStep = llm.steps.findIndex((step) => RunnableBinding.isRunnableBinding(step) || _isBaseChatModel(step) || _isConfigurableModel(step));
+		if (modelStep >= 0) {
+			const model$1 = _simpleBindTools(llm.steps[modelStep], toolClasses);
+			if (model$1) {
+				const nextSteps = llm.steps.slice();
+				nextSteps.splice(modelStep, 1, model$1);
+				return RunnableSequence.from(nextSteps);
+			}
+		}
+	}
+	throw new Error(`llm ${llm} must define bindTools method.`);
 }
-export async function _getModel(llm) {
-    // If model is a RunnableSequence, find a RunnableBinding or BaseChatModel in its steps
-    let model = llm;
-    if (RunnableSequence.isRunnableSequence(model)) {
-        model =
-            model.steps.find((step) => RunnableBinding.isRunnableBinding(step) ||
-                _isBaseChatModel(step) ||
-                _isConfigurableModel(step)) || model;
-    }
-    if (_isConfigurableModel(model)) {
-        model = await model._model();
-    }
-    // Get the underlying model from a RunnableBinding
-    if (RunnableBinding.isRunnableBinding(model)) {
-        model = model.bound;
-    }
-    if (!_isBaseChatModel(model)) {
-        throw new Error(`Expected \`llm\` to be a ChatModel or RunnableBinding (e.g. llm.bind_tools(...)) with invoke() and generate() methods, got ${model.constructor.name}`);
-    }
-    return model;
+async function _getModel(llm) {
+	let model = llm;
+	if (RunnableSequence.isRunnableSequence(model)) model = model.steps.find((step) => RunnableBinding.isRunnableBinding(step) || _isBaseChatModel(step) || _isConfigurableModel(step)) || model;
+	if (_isConfigurableModel(model)) model = await model._model();
+	if (RunnableBinding.isRunnableBinding(model)) model = model.bound;
+	if (!_isBaseChatModel(model)) throw new Error(`Expected \`llm\` to be a ChatModel or RunnableBinding (e.g. llm.bind_tools(...)) with invoke() and generate() methods, got ${model.constructor.name}`);
+	return model;
 }
-export const createReactAgentAnnotation = () => Annotation.Root({
-    messages: Annotation({
-        reducer: messagesStateReducer,
-        default: () => [],
-    }),
-    structuredResponse: (Annotation),
-});
-const PreHookAnnotation = Annotation.Root({
-    llmInputMessages: Annotation({
-        reducer: (_, update) => messagesStateReducer([], update),
-        default: () => [],
-    }),
+const createReactAgentAnnotation = () => Annotation.Root({
+	messages: Annotation({
+		reducer: messagesStateReducer,
+		default: () => []
+	}),
+	structuredResponse: Annotation
 });
+const PreHookAnnotation = Annotation.Root({ llmInputMessages: Annotation({
+	reducer: (_, update) => messagesStateReducer([], update),
+	default: () => []
+}) });
 /**
- * Creates a StateGraph agent that relies on a chat model utilizing tool calling.
- *
- * @example
- * ```ts
- * import { ChatOpenAI } from "@langchain/openai";
- * import { tool } from "@langchain/core/tools";
- * import { z } from "zod";
- * import { createReactAgent } from "@langchain/langgraph/prebuilt";
- *
- * const model = new ChatOpenAI({
- *   model: "gpt-4o",
- * });
- *
- * const getWeather = tool((input) => {
- *   if (["sf", "san francisco"].includes(input.location.toLowerCase())) {
- *     return "It's 60 degrees and foggy.";
- *   } else {
- *     return "It's 90 degrees and sunny.";
- *   }
- * }, {
- *   name: "get_weather",
- *   description: "Call to get the current weather.",
- *   schema: z.object({
- *     location: z.string().describe("Location to get the weather for."),
- *   })
- * })
- *
- * const agent = createReactAgent({ llm: model, tools: [getWeather] });
- *
- * const inputs = {
- *   messages: [{ role: "user", content: "what is the weather in SF?" }],
- * };
- *
- * const stream = await agent.stream(inputs, { streamMode: "values" });
- *
- * for await (const { messages } of stream) {
- *   console.log(messages);
- * }
- * // Returns the messages in the state at each step of execution
- * ```
- */
-export function createReactAgent(params) {
-    const { llm, tools, messageModifier, stateModifier, prompt, stateSchema, contextSchema, checkpointSaver, checkpointer, interruptBefore, interruptAfter, store, responseFormat, preModelHook, postModelHook, name, description, version = "v1", includeAgentName, } = params;
-    let toolClasses;
-    let toolNode;
-    if (!Array.isArray(tools)) {
-        toolClasses = tools.tools;
-        toolNode = tools;
-    }
-    else {
-        toolClasses = tools;
-        toolNode = new ToolNode(toolClasses.filter(isClientTool));
-    }
-    let cachedStaticModel = null;
-    const _getStaticModel = async (llm) => {
-        if (cachedStaticModel)
-            return cachedStaticModel;
-        let modelWithTools;
-        if (await _shouldBindTools(llm, toolClasses)) {
-            modelWithTools = await _bindTools(llm, toolClasses);
-        }
-        else {
-            modelWithTools = llm;
-        }
-        const promptRunnable = _getPrompt(prompt, stateModifier, messageModifier);
-        const modelRunnable = includeAgentName === "inline"
-            ? withAgentName(modelWithTools, includeAgentName)
-            : modelWithTools;
-        cachedStaticModel = promptRunnable.pipe(modelRunnable);
-        return cachedStaticModel;
-    };
-    const _getDynamicModel = async (llm, state, config) => {
-        const model = await llm(state, config);
-        return _getPrompt(prompt, stateModifier, messageModifier).pipe(includeAgentName === "inline"
-            ? withAgentName(model, includeAgentName)
-            : model);
-    };
-    // If any of the tools are configured to return_directly after running,
-    // our graph needs to check if these were called
-    const shouldReturnDirect = new Set(toolClasses
-        .filter(isClientTool)
-        .filter((tool) => "returnDirect" in tool && tool.returnDirect)
-        .map((tool) => tool.name));
-    function getModelInputState(state) {
-        const { messages, llmInputMessages, ...rest } = state;
-        if (llmInputMessages != null && llmInputMessages.length > 0) {
-            return { messages: llmInputMessages, ...rest };
-        }
-        return { messages, ...rest };
-    }
-    const generateStructuredResponse = async (state, config) => {
-        if (responseFormat == null) {
-            throw new Error("Attempted to generate structured output with no passed response schema. Please contact us for help.");
-        }
-        const messages = [...state.messages];
-        let modelWithStructuredOutput;
-        const model = typeof llm === "function"
-            ? await llm(state, config)
-            : await _getModel(llm);
-        if (!_isBaseChatModel(model)) {
-            throw new Error(`Expected \`llm\` to be a ChatModel with .withStructuredOutput() method, got ${model.constructor.name}`);
-        }
-        if (typeof responseFormat === "object" && "schema" in responseFormat) {
-            const { prompt, schema, ...options } = responseFormat;
-            modelWithStructuredOutput = model.withStructuredOutput(schema, options);
-            if (prompt != null) {
-                messages.unshift(new SystemMessage({ content: prompt }));
-            }
-        }
-        else {
-            modelWithStructuredOutput = model.withStructuredOutput(responseFormat);
-        }
-        const response = await modelWithStructuredOutput.invoke(messages, config);
-        return { structuredResponse: response };
-    };
-    const callModel = async (state, config) => {
-        // NOTE: we're dynamically creating the model runnable here
-        // to ensure that we can validate ConfigurableModel properly
-        const modelRunnable = typeof llm === "function"
-            ? await _getDynamicModel(llm, state, config)
-            : await _getStaticModel(llm);
-        // TODO: Auto-promote streaming.
-        const response = (await modelRunnable.invoke(getModelInputState(state), config));
-        // add agent name to the AIMessage
-        // TODO: figure out if we can avoid mutating the message directly
-        response.name = name;
-        response.lc_kwargs.name = name;
-        return { messages: [response] };
-    };
-    const schema = stateSchema ?? createReactAgentAnnotation();
-    const workflow = new StateGraph(schema, contextSchema).addNode("tools", toolNode);
-    if (!("messages" in workflow._schemaDefinition)) {
-        throw new Error("Missing required `messages` key in state schema.");
-    }
-    const allNodeWorkflows = workflow;
-    const conditionalMap = (map) => {
-        return Object.fromEntries(Object.entries(map).filter(([_, v]) => v != null));
-    };
-    let entrypoint = "agent";
-    let inputSchema;
-    if (preModelHook != null) {
-        allNodeWorkflows
-            .addNode("pre_model_hook", preModelHook)
-            .addEdge("pre_model_hook", "agent");
-        entrypoint = "pre_model_hook";
-        inputSchema = Annotation.Root({
-            ...workflow._schemaDefinition,
-            ...PreHookAnnotation.spec,
-        });
-    }
-    else {
-        entrypoint = "agent";
-    }
-    allNodeWorkflows
-        .addNode("agent", callModel, { input: inputSchema })
-        .addEdge(START, entrypoint);
-    if (postModelHook != null) {
-        allNodeWorkflows
-            .addNode("post_model_hook", postModelHook)
-            .addEdge("agent", "post_model_hook")
-            .addConditionalEdges("post_model_hook", (state) => {
-            const { messages } = state;
-            const toolMessageIds = new Set(messages.filter(isToolMessage).map((msg) => msg.tool_call_id));
-            let lastAiMessage;
-            for (let i = messages.length - 1; i >= 0; i -= 1) {
-                const message = messages[i];
-                if (isAIMessage(message)) {
-                    lastAiMessage = message;
-                    break;
-                }
-            }
-            const pendingToolCalls = lastAiMessage?.tool_calls?.filter((i) => i.id == null || !toolMessageIds.has(i.id)) ?? [];
-            const lastMessage = messages.at(-1);
-            if (pendingToolCalls.length > 0) {
-                if (version === "v2") {
-                    return pendingToolCalls.map((toolCall) => new Send("tools", { ...state, lg_tool_call: toolCall }));
-                }
-                return "tools";
-            }
-            if (lastMessage && isToolMessage(lastMessage))
-                return entrypoint;
-            if (responseFormat != null)
-                return "generate_structured_response";
-            return END;
-        }, conditionalMap({
-            tools: "tools",
-            [entrypoint]: entrypoint,
-            generate_structured_response: responseFormat != null ? "generate_structured_response" : null,
-            [END]: responseFormat != null ? null : END,
-        }));
-    }
-    if (responseFormat !== undefined) {
-        workflow
-            .addNode("generate_structured_response", generateStructuredResponse)
-            .addEdge("generate_structured_response", END);
-    }
-    if (postModelHook == null) {
-        allNodeWorkflows.addConditionalEdges("agent", (state) => {
-            const { messages } = state;
-            const lastMessage = messages[messages.length - 1];
-            // if there's no function call, we finish
-            if (!isAIMessage(lastMessage) || !lastMessage.tool_calls?.length) {
-                if (responseFormat != null)
-                    return "generate_structured_response";
-                return END;
-            }
-            // there are function calls, we continue
-            if (version === "v2") {
-                return lastMessage.tool_calls.map((toolCall) => new Send("tools", { ...state, lg_tool_call: toolCall }));
-            }
-            return "tools";
-        }, conditionalMap({
-            tools: "tools",
-            generate_structured_response: responseFormat != null ? "generate_structured_response" : null,
-            [END]: responseFormat != null ? null : END,
-        }));
-    }
-    if (shouldReturnDirect.size > 0) {
-        allNodeWorkflows.addConditionalEdges("tools", (state) => {
-            // Check the last consecutive tool calls
-            for (let i = state.messages.length - 1; i >= 0; i -= 1) {
-                const message = state.messages[i];
-                if (!isToolMessage(message))
-                    break;
-                // Check if this tool is configured to return directly
-                if (message.name !== undefined &&
-                    shouldReturnDirect.has(message.name)) {
-                    return END;
-                }
-            }
-            return entrypoint;
-        }, conditionalMap({ [entrypoint]: entrypoint, [END]: END }));
-    }
-    else {
-        allNodeWorkflows.addEdge("tools", entrypoint);
-    }
-    return allNodeWorkflows.compile({
-        checkpointer: checkpointer ?? checkpointSaver,
-        interruptBefore,
-        interruptAfter,
-        store,
-        name,
-        description,
-    });
+* @deprecated `createReactAgent` has been moved to {@link https://www.npmjs.com/package/langchain langchain} package.
+* Update your import to `import { createAgent } from "langchain";`
+*
+* Creates a StateGraph agent that relies on a chat model utilizing tool calling.
+*
+* @example
+* ```ts
+* import { ChatOpenAI } from "@langchain/openai";
+* import { tool } from "@langchain/core/tools";
+* import { z } from "zod";
+* import { createReactAgent } from "@langchain/langgraph/prebuilt";
+*
+* const model = new ChatOpenAI({
+*   model: "gpt-4o",
+* });
+*
+* const getWeather = tool((input) => {
+*   if (["sf", "san francisco"].includes(input.location.toLowerCase())) {
+*     return "It's 60 degrees and foggy.";
+*   } else {
+*     return "It's 90 degrees and sunny.";
+*   }
+* }, {
+*   name: "get_weather",
+*   description: "Call to get the current weather.",
+*   schema: z.object({
+*     location: z.string().describe("Location to get the weather for."),
+*   })
+* })
+*
+* const agent = createReactAgent({ llm: model, tools: [getWeather] });
+*
+* const inputs = {
+*   messages: [{ role: "user", content: "what is the weather in SF?" }],
+* };
+*
+* const stream = await agent.stream(inputs, { streamMode: "values" });
+*
+* for await (const { messages } of stream) {
+*   console.log(messages);
+* }
+* // Returns the messages in the state at each step of execution
+* ```
+*/
+function createReactAgent(params) {
+	const { llm, tools, messageModifier, stateModifier, prompt, stateSchema, contextSchema, checkpointSaver, checkpointer, interruptBefore, interruptAfter, store, responseFormat, preModelHook, postModelHook, name, description, version = "v1", includeAgentName } = params;
+	let toolClasses;
+	let toolNode;
+	if (!Array.isArray(tools)) {
+		toolClasses = tools.tools;
+		toolNode = tools;
+	} else {
+		toolClasses = tools;
+		toolNode = new ToolNode(toolClasses.filter(isClientTool));
+	}
+	let cachedStaticModel = null;
+	const _getStaticModel = async (llm$1) => {
+		if (cachedStaticModel) return cachedStaticModel;
+		let modelWithTools;
+		if (await _shouldBindTools(llm$1, toolClasses)) modelWithTools = await _bindTools(llm$1, toolClasses);
+		else modelWithTools = llm$1;
+		const promptRunnable = _getPrompt(prompt, stateModifier, messageModifier);
+		const modelRunnable = includeAgentName === "inline" ? withAgentName(modelWithTools, includeAgentName) : modelWithTools;
+		cachedStaticModel = promptRunnable.pipe(modelRunnable);
+		return cachedStaticModel;
+	};
+	const _getDynamicModel = async (llm$1, state, config) => {
+		const model = await llm$1(state, config);
+		return _getPrompt(prompt, stateModifier, messageModifier).pipe(includeAgentName === "inline" ? withAgentName(model, includeAgentName) : model);
+	};
+	const shouldReturnDirect = new Set(toolClasses.filter(isClientTool).filter((tool) => "returnDirect" in tool && tool.returnDirect).map((tool) => tool.name));
+	function getModelInputState(state) {
+		const { messages, llmInputMessages,...rest } = state;
+		if (llmInputMessages != null && llmInputMessages.length > 0) return {
+			messages: llmInputMessages,
+			...rest
+		};
+		return {
+			messages,
+			...rest
+		};
+	}
+	const generateStructuredResponse = async (state, config) => {
+		if (responseFormat == null) throw new Error("Attempted to generate structured output with no passed response schema. Please contact us for help.");
+		const messages = [...state.messages];
+		let modelWithStructuredOutput;
+		const model = typeof llm === "function" ? await llm(state, config) : await _getModel(llm);
+		if (!_isBaseChatModel(model)) throw new Error(`Expected \`llm\` to be a ChatModel with .withStructuredOutput() method, got ${model.constructor.name}`);
+		if (typeof responseFormat === "object" && "schema" in responseFormat) {
+			const { prompt: prompt$1, schema: schema$1,...options } = responseFormat;
+			modelWithStructuredOutput = model.withStructuredOutput(schema$1, options);
+			if (prompt$1 != null) messages.unshift(new SystemMessage({ content: prompt$1 }));
+		} else modelWithStructuredOutput = model.withStructuredOutput(responseFormat);
+		const response = await modelWithStructuredOutput.invoke(messages, config);
+		return { structuredResponse: response };
+	};
+	const callModel = async (state, config) => {
+		const modelRunnable = typeof llm === "function" ? await _getDynamicModel(llm, state, config) : await _getStaticModel(llm);
+		const response = await modelRunnable.invoke(getModelInputState(state), config);
+		response.name = name;
+		response.lc_kwargs.name = name;
+		return { messages: [response] };
+	};
+	const schema = stateSchema ?? createReactAgentAnnotation();
+	const workflow = new StateGraph(schema, contextSchema).addNode("tools", toolNode);
+	if (!("messages" in workflow._schemaDefinition)) throw new Error("Missing required `messages` key in state schema.");
+	const allNodeWorkflows = workflow;
+	const conditionalMap = (map) => {
+		return Object.fromEntries(Object.entries(map).filter(([_, v]) => v != null));
+	};
+	let entrypoint = "agent";
+	let inputSchema;
+	if (preModelHook != null) {
+		allNodeWorkflows.addNode("pre_model_hook", preModelHook).addEdge("pre_model_hook", "agent");
+		entrypoint = "pre_model_hook";
+		inputSchema = Annotation.Root({
+			...workflow._schemaDefinition,
+			...PreHookAnnotation.spec
+		});
+	} else entrypoint = "agent";
+	allNodeWorkflows.addNode("agent", callModel, { input: inputSchema }).addEdge(START, entrypoint);
+	if (postModelHook != null) allNodeWorkflows.addNode("post_model_hook", postModelHook).addEdge("agent", "post_model_hook").addConditionalEdges("post_model_hook", (state) => {
+		const { messages } = state;
+		const toolMessageIds = new Set(messages.filter(isToolMessage).map((msg) => msg.tool_call_id));
+		let lastAiMessage;
+		for (let i = messages.length - 1; i >= 0; i -= 1) {
+			const message = messages[i];
+			if (isAIMessage(message)) {
+				lastAiMessage = message;
+				break;
+			}
+		}
+		const pendingToolCalls = lastAiMessage?.tool_calls?.filter((i) => i.id == null || !toolMessageIds.has(i.id)) ?? [];
+		const lastMessage = messages.at(-1);
+		if (pendingToolCalls.length > 0) {
+			if (version === "v2") return pendingToolCalls.map((toolCall) => new Send("tools", {
+				...state,
+				lg_tool_call: toolCall
+			}));
+			return "tools";
+		}
+		if (lastMessage && isToolMessage(lastMessage)) return entrypoint;
+		if (responseFormat != null) return "generate_structured_response";
+		return END;
+	}, conditionalMap({
+		tools: "tools",
+		[entrypoint]: entrypoint,
+		generate_structured_response: responseFormat != null ? "generate_structured_response" : null,
+		[END]: responseFormat != null ? null : END
+	}));
+	if (responseFormat !== void 0) workflow.addNode("generate_structured_response", generateStructuredResponse).addEdge("generate_structured_response", END);
+	if (postModelHook == null) allNodeWorkflows.addConditionalEdges("agent", (state) => {
+		const { messages } = state;
+		const lastMessage = messages[messages.length - 1];
+		if (!isAIMessage(lastMessage) || !lastMessage.tool_calls?.length) {
+			if (responseFormat != null) return "generate_structured_response";
+			return END;
+		}
+		if (version === "v2") return lastMessage.tool_calls.map((toolCall) => new Send("tools", {
+			...state,
+			lg_tool_call: toolCall
+		}));
+		return "tools";
+	}, conditionalMap({
+		tools: "tools",
+		generate_structured_response: responseFormat != null ? "generate_structured_response" : null,
+		[END]: responseFormat != null ? null : END
+	}));
+	if (shouldReturnDirect.size > 0) allNodeWorkflows.addConditionalEdges("tools", (state) => {
+		for (let i = state.messages.length - 1; i >= 0; i -= 1) {
+			const message = state.messages[i];
+			if (!isToolMessage(message)) break;
+			if (message.name !== void 0 && shouldReturnDirect.has(message.name)) return END;
+		}
+		return entrypoint;
+	}, conditionalMap({
+		[entrypoint]: entrypoint,
+		[END]: END
+	}));
+	else allNodeWorkflows.addEdge("tools", entrypoint);
+	return allNodeWorkflows.compile({
+		checkpointer: checkpointer ?? checkpointSaver,
+		interruptBefore,
+		interruptAfter,
+		store,
+		name,
+		description
+	});
 }
+
+//#endregion
+export { createReactAgent, createReactAgentAnnotation };
 //# sourceMappingURL=react_agent_executor.js.map