langchain 0.3.30 → 1.0.0-alpha.1

package/dist/_virtual/rolldown_runtime.cjs

@@ -0,0 +1,38 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function() {
+	return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __export = (target, all) => {
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+exports.__commonJS = __commonJS;
+exports.__export = __export;
+exports.__reExport = __reExport;
+exports.__toESM = __toESM;

package/dist/_virtual/rolldown_runtime.js

@@ -0,0 +1,34 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function() {
+	return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __export = (target, all) => {
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+export { __commonJS, __export, __reExport, __toESM };

package/dist/agents/ReactAgent.cjs

@@ -0,0 +1,247 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_annotation = require('./annotation.cjs');
+const require_utils = require('./utils.cjs');
+const require_AgentNode = require('./nodes/AgentNode.cjs');
+const require_ToolNode = require('./nodes/ToolNode.cjs');
+const __langchain_core_messages = require_rolldown_runtime.__toESM(require("@langchain/core/messages"));
+const __langchain_langgraph = require_rolldown_runtime.__toESM(require("@langchain/langgraph"));
+
+//#region src/agents/ReactAgent.ts
+var ReactAgent = class {
+	#graph;
+	#inputSchema;
+	#toolBehaviorVersion = "v2";
+	constructor(options) {
+		this.options = options;
+		this.#toolBehaviorVersion = options.version ?? this.#toolBehaviorVersion;
+		/**
+		* Check if the LLM already has bound tools and throw if it does.
+		*/
+		if (options.llm && typeof options.llm !== "function") require_utils.validateLLMHasNoBoundTools(options.llm);
+		/**
+		* validate that model and llm options are not provided together
+		*/
+		if (options.llm && options.model) throw new Error("Cannot provide both `model` and `llm` options.");
+		/**
+		* validate that either model or llm option is provided
+		*/
+		if (!options.llm && !options.model) throw new Error("Either `model` or `llm` option must be provided to create an agent.");
+		const toolClasses = Array.isArray(options.tools) ? options.tools : options.tools.tools;
+		/**
+		* 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(require_utils.isClientTool).filter((tool) => "returnDirect" in tool && tool.returnDirect).map((tool) => tool.name));
+		const schema = this.options.stateSchema ?? require_annotation.createReactAgentAnnotationConditional(this.options.responseFormat !== void 0);
+		const workflow = new __langchain_langgraph.StateGraph(schema, this.options.contextSchema);
+		const allNodeWorkflows = workflow;
+		/**
+		* Add Nodes
+		*/
+		allNodeWorkflows.addNode("agent", new require_AgentNode.AgentNode({
+			llm: this.options.llm,
+			model: this.options.model,
+			prompt: this.options.prompt,
+			includeAgentName: this.options.includeAgentName,
+			name: this.options.name,
+			responseFormat: this.options.responseFormat,
+			toolClasses,
+			shouldReturnDirect,
+			signal: this.options.signal
+		}), { input: this.#inputSchema });
+		/**
+		* add single tool node for all tools
+		*/
+		if (toolClasses.length > 0) {
+			const toolNode = new require_ToolNode.ToolNode(toolClasses.filter(require_utils.isClientTool), { signal: this.options.signal });
+			allNodeWorkflows.addNode("tools", toolNode);
+		}
+		/**
+		* setup preModelHook
+		*/
+		if (options.preModelHook) allNodeWorkflows.addNode("pre_model_hook", options.preModelHook);
+		/**
+		* setup postModelHook
+		*/
+		if (options.postModelHook) allNodeWorkflows.addNode("post_model_hook", options.postModelHook);
+		/**
+		* Add Edges
+		*/
+		allNodeWorkflows.addEdge(__langchain_langgraph.START, this.#getEntryPoint());
+		if (this.options.preModelHook) allNodeWorkflows.addEdge("pre_model_hook", "agent");
+		if (this.options.postModelHook) {
+			allNodeWorkflows.addEdge("agent", "post_model_hook");
+			const postHookPaths = this.#getPostModelHookPaths(toolClasses.filter(require_utils.isClientTool));
+			if (postHookPaths.length === 1) allNodeWorkflows.addEdge("post_model_hook", postHookPaths[0]);
+			else allNodeWorkflows.addConditionalEdges("post_model_hook", this.#createPostModelHookRouter(), postHookPaths);
+		} else {
+			const modelPaths = this.#getModelPaths(toolClasses.filter(require_utils.isClientTool));
+			if (modelPaths.length === 1) allNodeWorkflows.addEdge("agent", modelPaths[0]);
+			else allNodeWorkflows.addConditionalEdges("agent", this.#createModelRouter(), modelPaths);
+		}
+		/**
+		* add edges for tools node
+		*/
+		if (toolClasses.length > 0) if (shouldReturnDirect.size > 0) allNodeWorkflows.addConditionalEdges("tools", this.#createToolsRouter(shouldReturnDirect), [this.#getEntryPoint(), __langchain_langgraph.END]);
+		else allNodeWorkflows.addEdge("tools", this.#getEntryPoint());
+		/**
+		* compile the graph
+		*/
+		this.#graph = allNodeWorkflows.compile({
+			checkpointer: this.options.checkpointer ?? this.options.checkpointSaver,
+			interruptBefore: this.options.interruptBefore,
+			interruptAfter: this.options.interruptAfter,
+			store: this.options.store,
+			name: this.options.name,
+			description: this.options.description
+		});
+	}
+	/**
+	* Get the compiled graph.
+	*/
+	get graph() {
+		return this.#graph;
+	}
+	#getEntryPoint() {
+		const entryPoint = this.options.preModelHook ? "pre_model_hook" : "agent";
+		return entryPoint;
+	}
+	/**
+	* Get possible edge destinations from post_model_hook node.
+	*/
+	#getPostModelHookPaths(toolClasses) {
+		const paths = [];
+		if (toolClasses.length > 0) paths.push(this.#getEntryPoint(), "tools");
+		paths.push(__langchain_langgraph.END);
+		return paths;
+	}
+	#createPostModelHookRouter() {
+		return (state) => {
+			const messages = state.messages;
+			const toolMessages = messages.filter(__langchain_core_messages.isToolMessage);
+			const lastAiMessage = messages.filter(__langchain_core_messages.isAIMessage).at(-1);
+			const pendingToolCalls = lastAiMessage?.tool_calls?.filter((call) => !toolMessages.some((m) => m.tool_call_id === call.id));
+			if (pendingToolCalls && pendingToolCalls.length > 0) {
+				/**
+				* The tool node processes a single message.
+				* All tool calls in the message are executed in parallel within the tool node.
+				* @deprecated likely to be removed in the next version of the agent
+				*/
+				if (this.#toolBehaviorVersion === "v1") return "tools";
+				/**
+				* The tool node processes a single tool call. Tool calls are distributed across
+				* multiple instances of the tool node using the Send API.
+				*/
+				return pendingToolCalls.map((toolCall) => new __langchain_langgraph.Send("tools", {
+					...state,
+					lg_tool_call: toolCall
+				}));
+			}
+			if (messages.at(-1) instanceof __langchain_core_messages.ToolMessage) return this.#getEntryPoint();
+			return __langchain_langgraph.END;
+		};
+	}
+	/**
+	* Get possible edge destinations from model node.
+	* @param toolClasses names of tools to call
+	* @returns list of possible edge destinations
+	*/
+	#getModelPaths(toolClasses) {
+		const paths = [];
+		if (toolClasses.length > 0) paths.push("tools");
+		paths.push(__langchain_langgraph.END);
+		return paths;
+	}
+	/**
+	* Create routing function for model node conditional edges.
+	*/
+	#createModelRouter() {
+		/**
+		* determine if the agent should continue or not
+		*/
+		return (state) => {
+			const messages = state.messages;
+			const lastMessage = messages.at(-1);
+			if (!(lastMessage instanceof __langchain_core_messages.AIMessage) || !lastMessage.tool_calls || lastMessage.tool_calls.length === 0) {
+				if (this.options.postModelHook) return "post_model_hook";
+				return __langchain_langgraph.END;
+			}
+			if (this.options.postModelHook) return "post_model_hook";
+			/**
+			* The tool node processes a single message.
+			*/
+			if (this.#toolBehaviorVersion === "v1") return "tools";
+			/**
+			* Route to tools node
+			*/
+			return lastMessage.tool_calls.map((toolCall) => new __langchain_langgraph.Send("tools", {
+				...state,
+				lg_tool_call: toolCall
+			}));
+		};
+	}
+	/**
+	* Create routing function for tools node conditional edges.
+	*/
+	#createToolsRouter(shouldReturnDirect) {
+		return (state) => {
+			const messages = state.messages;
+			const lastMessage = messages[messages.length - 1];
+			if (lastMessage instanceof __langchain_core_messages.ToolMessage && lastMessage.name && shouldReturnDirect.has(lastMessage.name)) return this.options.responseFormat ? this.#getEntryPoint() : __langchain_langgraph.END;
+			return this.#getEntryPoint();
+		};
+	}
+	/**
+	* @inheritdoc
+	*/
+	get invoke() {
+		return this.#graph.invoke.bind(this.#graph);
+	}
+	/**
+	* @inheritdoc
+	*/
+	get stream() {
+		return this.#graph.stream.bind(this.#graph);
+	}
+	/**
+	* @inheritdoc
+	*/
+	get streamEvents() {
+		return this.#graph.streamEvents.bind(this.#graph);
+	}
+	/**
+	* Visualize the graph as a PNG image.
+	* @param params - Parameters for the drawMermaidPng method.
+	* @param params.withStyles - Whether to include styles in the graph.
+	* @param params.curveStyle - The style of the graph's curves.
+	* @param params.nodeColors - The colors of the graph's nodes.
+	* @param params.wrapLabelNWords - The maximum number of words to wrap in a node's label.
+	* @param params.backgroundColor - The background color of the graph.
+	* @returns PNG image as a buffer
+	*/
+	async drawMermaidPng(params) {
+		const representation = await this.#graph.getGraphAsync();
+		const image = await representation.drawMermaidPng(params);
+		const arrayBuffer = await image.arrayBuffer();
+		const buffer = new Uint8Array(arrayBuffer);
+		return buffer;
+	}
+	/**
+	* Draw the graph as a Mermaid string.
+	* @param params - Parameters for the drawMermaid method.
+	* @param params.withStyles - Whether to include styles in the graph.
+	* @param params.curveStyle - The style of the graph's curves.
+	* @param params.nodeColors - The colors of the graph's nodes.
+	* @param params.wrapLabelNWords - The maximum number of words to wrap in a node's label.
+	* @param params.backgroundColor - The background color of the graph.
+	* @returns Mermaid string
+	*/
+	async drawMermaid(params) {
+		const representation = await this.#graph.getGraphAsync();
+		return representation.drawMermaid(params);
+	}
+};
+
+//#endregion
+exports.ReactAgent = ReactAgent;
+//# sourceMappingURL=ReactAgent.cjs.map

package/dist/agents/ReactAgent.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactAgent.cjs","names":["options: CreateReactAgentParams<\n      StateSchema,\n      StructuredResponseFormat,\n      ContextSchema\n    >","#toolBehaviorVersion","validateLLMHasNoBoundTools","isClientTool","createReactAgentAnnotationConditional","StateGraph","AgentNode","#inputSchema","ToolNode","START","#getEntryPoint","#getPostModelHookPaths","#createPostModelHookRouter","#getModelPaths","#createModelRouter","#createToolsRouter","END","#graph","toolClasses: (ClientTool | ServerTool)[]","paths: (typeof END | \"agent\" | \"pre_model_hook\" | \"tools\")[]","state: InternalAgentState<StructuredResponseFormat>","isToolMessage","isAIMessage","Send","ToolMessage","paths: (\"tools\" | typeof END)[]","AIMessage","shouldReturnDirect: Set<string>","params?: {\n    withStyles?: boolean;\n    curveStyle?: string;\n    nodeColors?: Record<string, string>;\n    wrapLabelNWords?: number;\n    backgroundColor?: string;\n  }"],"sources":["../../src/agents/ReactAgent.ts"],"sourcesContent":["/* eslint-disable prefer-destructuring, no-instanceof/no-instanceof */\nimport { InteropZodObject } from \"@langchain/core/utils/types\";\nimport {\n  AnnotationRoot,\n  StateGraph,\n  END,\n  START,\n  Send,\n  CompiledStateGraph,\n  MessagesAnnotation,\n} from \"@langchain/langgraph\";\nimport {\n  isToolMessage,\n  isAIMessage,\n  ToolMessage,\n  AIMessage,\n} from \"@langchain/core/messages\";\n\nimport {\n  createReactAgentAnnotationConditional,\n  ReactAgentAnnotation,\n} from \"./annotation.js\";\nimport { isClientTool, validateLLMHasNoBoundTools } from \"./utils.js\";\nimport { AgentNode } from \"./nodes/AgentNode.js\";\nimport { ToolNode } from \"./nodes/ToolNode.js\";\nimport type {\n  CreateReactAgentParams,\n  ClientTool,\n  ServerTool,\n  InternalAgentState,\n  WithStateGraphNodes,\n} from \"./types.js\";\nimport type { AnyAnnotationRoot, ToAnnotationRoot } from \"./annotation.js\";\nimport type { ResponseFormatUndefined } from \"./responses.js\";\n\ntype AgentGraph<\n  StateSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot,\n  StructuredResponseFormat extends\n    | Record<string, any>\n    | ResponseFormatUndefined = Record<string, any>,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot\n> = CompiledStateGraph<\n  ToAnnotationRoot<StateSchema>[\"State\"],\n  ToAnnotationRoot<StateSchema>[\"Update\"],\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any,\n  typeof MessagesAnnotation.spec & ToAnnotationRoot<StateSchema>[\"spec\"],\n  ReactAgentAnnotation<StructuredResponseFormat>[\"spec\"] &\n    ToAnnotationRoot<StateSchema>[\"spec\"],\n  ToAnnotationRoot<ContextSchema>[\"spec\"],\n  unknown\n>;\n\nexport class ReactAgent<\n  StateSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot,\n  StructuredResponseFormat extends\n    | Record<string, any>\n    | ResponseFormatUndefined = Record<string, any>,\n  ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot\n> {\n  #graph: AgentGraph<StateSchema, StructuredResponseFormat, ContextSchema>;\n\n  #inputSchema?: AnnotationRoot<ToAnnotationRoot<StateSchema>[\"spec\"]>;\n\n  #toolBehaviorVersion: \"v1\" | \"v2\" = \"v2\";\n\n  constructor(\n    public options: CreateReactAgentParams<\n      StateSchema,\n      StructuredResponseFormat,\n      ContextSchema\n    >\n  ) {\n    this.#toolBehaviorVersion = options.version ?? this.#toolBehaviorVersion;\n\n    /**\n     * Check if the LLM already has bound tools and throw if it does.\n     */\n    if (options.llm && typeof options.llm !== \"function\") {\n      validateLLMHasNoBoundTools(options.llm);\n    }\n\n    /**\n     * validate that model and llm options are not provided together\n     */\n    if (options.llm && options.model) {\n      throw new Error(\"Cannot provide both `model` and `llm` options.\");\n    }\n\n    /**\n     * validate that either model or llm option is provided\n     */\n    if (!options.llm && !options.model) {\n      throw new Error(\n        \"Either `model` or `llm` option must be provided to create an agent.\"\n      );\n    }\n\n    const toolClasses = Array.isArray(options.tools)\n      ? options.tools\n      : options.tools.tools;\n\n    /**\n     * If any of the tools are configured to return_directly after running,\n     * our graph needs to check if these were called\n     */\n    const shouldReturnDirect = new Set(\n      toolClasses\n        .filter(isClientTool)\n        .filter((tool) => \"returnDirect\" in tool && tool.returnDirect)\n        .map((tool) => tool.name)\n    );\n\n    const schema = (this.options.stateSchema ??\n      createReactAgentAnnotationConditional<StructuredResponseFormat>(\n        this.options.responseFormat !== undefined\n      )) as AnyAnnotationRoot;\n\n    const workflow = new StateGraph(schema, this.options.contextSchema);\n\n    const allNodeWorkflows = workflow as WithStateGraphNodes<\n      \"pre_model_hook\" | \"post_model_hook\" | \"tools\" | \"agent\",\n      typeof workflow\n    >;\n\n    /**\n     * Add Nodes\n     */\n    allNodeWorkflows.addNode(\n      \"agent\",\n      new AgentNode({\n        llm: this.options.llm,\n        model: this.options.model,\n        prompt: this.options.prompt,\n        includeAgentName: this.options.includeAgentName,\n        name: this.options.name,\n        responseFormat: this.options.responseFormat,\n        toolClasses,\n        shouldReturnDirect,\n        signal: this.options.signal,\n      }),\n      {\n        input: this.#inputSchema,\n      }\n    );\n\n    /**\n     * add single tool node for all tools\n     */\n    if (toolClasses.length > 0) {\n      const toolNode = new ToolNode(toolClasses.filter(isClientTool), {\n        signal: this.options.signal,\n      });\n      allNodeWorkflows.addNode(\"tools\", toolNode);\n    }\n\n    /**\n     * setup preModelHook\n     */\n    if (options.preModelHook) {\n      allNodeWorkflows.addNode(\"pre_model_hook\", options.preModelHook);\n    }\n\n    /**\n     * setup postModelHook\n     */\n    if (options.postModelHook) {\n      allNodeWorkflows.addNode(\"post_model_hook\", options.postModelHook);\n    }\n\n    /**\n     * Add Edges\n     */\n    allNodeWorkflows.addEdge(START, this.#getEntryPoint());\n\n    if (this.options.preModelHook) {\n      allNodeWorkflows.addEdge(\"pre_model_hook\", \"agent\");\n    }\n\n    if (this.options.postModelHook) {\n      allNodeWorkflows.addEdge(\"agent\", \"post_model_hook\");\n      const postHookPaths = this.#getPostModelHookPaths(\n        toolClasses.filter(isClientTool)\n      );\n      if (postHookPaths.length === 1) {\n        allNodeWorkflows.addEdge(\"post_model_hook\", postHookPaths[0]);\n      } else {\n        allNodeWorkflows.addConditionalEdges(\n          \"post_model_hook\",\n          this.#createPostModelHookRouter(),\n          postHookPaths\n        );\n      }\n    } else {\n      const modelPaths = this.#getModelPaths(toolClasses.filter(isClientTool));\n      if (modelPaths.length === 1) {\n        allNodeWorkflows.addEdge(\"agent\", modelPaths[0]);\n      } else {\n        allNodeWorkflows.addConditionalEdges(\n          \"agent\",\n          this.#createModelRouter(),\n          modelPaths\n        );\n      }\n    }\n\n    /**\n     * add edges for tools node\n     */\n    if (toolClasses.length > 0) {\n      if (shouldReturnDirect.size > 0) {\n        allNodeWorkflows.addConditionalEdges(\n          \"tools\",\n          this.#createToolsRouter(shouldReturnDirect),\n          [this.#getEntryPoint(), END]\n        );\n      } else {\n        allNodeWorkflows.addEdge(\"tools\", this.#getEntryPoint());\n      }\n    }\n\n    /**\n     * compile the graph\n     */\n    this.#graph = allNodeWorkflows.compile({\n      checkpointer: this.options.checkpointer ?? this.options.checkpointSaver,\n      interruptBefore: this.options.interruptBefore,\n      interruptAfter: this.options.interruptAfter,\n      store: this.options.store,\n      name: this.options.name,\n      description: this.options.description,\n    });\n  }\n\n  /**\n   * Get the compiled graph.\n   */\n  get graph(): AgentGraph<\n    StateSchema,\n    StructuredResponseFormat,\n    ContextSchema\n  > {\n    return this.#graph;\n  }\n\n  #getEntryPoint() {\n    const entryPoint = this.options.preModelHook ? \"pre_model_hook\" : \"agent\";\n    return entryPoint;\n  }\n\n  /**\n   * Get possible edge destinations from post_model_hook node.\n   */\n  #getPostModelHookPaths(toolClasses: (ClientTool | ServerTool)[]) {\n    const paths: (typeof END | \"agent\" | \"pre_model_hook\" | \"tools\")[] = [];\n    if (toolClasses.length > 0) {\n      paths.push(this.#getEntryPoint(), \"tools\");\n    }\n    paths.push(END);\n    return paths;\n  }\n\n  #createPostModelHookRouter() {\n    return (state: InternalAgentState<StructuredResponseFormat>) => {\n      const messages = state.messages;\n      const toolMessages = messages.filter(isToolMessage);\n      const lastAiMessage = messages.filter(isAIMessage).at(-1);\n      const pendingToolCalls = lastAiMessage?.tool_calls?.filter(\n        (call) => !toolMessages.some((m) => m.tool_call_id === call.id)\n      );\n\n      if (pendingToolCalls && pendingToolCalls.length > 0) {\n        /**\n         * The tool node processes a single message.\n         * All tool calls in the message are executed in parallel within the tool node.\n         * @deprecated likely to be removed in the next version of the agent\n         */\n        if (this.#toolBehaviorVersion === \"v1\") {\n          return \"tools\";\n        }\n\n        /**\n         * The tool node processes a single tool call. Tool calls are distributed across\n         * multiple instances of the tool node using the Send API.\n         */\n        return pendingToolCalls.map(\n          (toolCall) => new Send(\"tools\", { ...state, lg_tool_call: toolCall })\n        );\n      }\n\n      if (messages.at(-1) instanceof ToolMessage) {\n        return this.#getEntryPoint();\n      }\n\n      return END;\n    };\n  }\n\n  /**\n   * Get possible edge destinations from model node.\n   * @param toolClasses names of tools to call\n   * @returns list of possible edge destinations\n   */\n  #getModelPaths(\n    toolClasses: (ClientTool | ServerTool)[]\n  ): (\"tools\" | typeof END)[] {\n    const paths: (\"tools\" | typeof END)[] = [];\n    if (toolClasses.length > 0) {\n      paths.push(\"tools\");\n    }\n\n    paths.push(END);\n\n    return paths;\n  }\n\n  /**\n   * Create routing function for model node conditional edges.\n   */\n  #createModelRouter() {\n    /**\n     * determine if the agent should continue or not\n     */\n    return (state: InternalAgentState<StructuredResponseFormat>) => {\n      const messages = state.messages;\n      const lastMessage = messages.at(-1);\n\n      if (\n        !(lastMessage instanceof AIMessage) ||\n        !lastMessage.tool_calls ||\n        lastMessage.tool_calls.length === 0\n      ) {\n        if (this.options.postModelHook) {\n          return \"post_model_hook\";\n        }\n\n        return END;\n      }\n\n      if (this.options.postModelHook) {\n        return \"post_model_hook\";\n      }\n\n      /**\n       * The tool node processes a single message.\n       */\n      if (this.#toolBehaviorVersion === \"v1\") {\n        return \"tools\";\n      }\n\n      /**\n       * Route to tools node\n       */\n      return lastMessage.tool_calls.map(\n        (toolCall) => new Send(\"tools\", { ...state, lg_tool_call: toolCall })\n      );\n    };\n  }\n\n  /**\n   * Create routing function for tools node conditional edges.\n   */\n  #createToolsRouter(shouldReturnDirect: Set<string>) {\n    return (state: InternalAgentState<StructuredResponseFormat>) => {\n      const messages = state.messages;\n      const lastMessage = messages[messages.length - 1];\n\n      // Check if we just executed a returnDirect tool\n      if (\n        lastMessage instanceof ToolMessage &&\n        lastMessage.name &&\n        shouldReturnDirect.has(lastMessage.name)\n      ) {\n        // If we have a response format, route to agent to generate structured response\n        // Otherwise, return directly\n        return this.options.responseFormat ? this.#getEntryPoint() : END;\n      }\n\n      // For non-returnDirect tools, always route back to agent\n      return this.#getEntryPoint();\n    };\n  }\n\n  /**\n   * @inheritdoc\n   */\n  get invoke(): AgentGraph<StateSchema, StructuredResponseFormat>[\"invoke\"] {\n    return this.#graph.invoke.bind(this.#graph);\n  }\n\n  /**\n   * @inheritdoc\n   */\n  get stream(): AgentGraph<StateSchema, StructuredResponseFormat>[\"stream\"] {\n    return this.#graph.stream.bind(this.#graph);\n  }\n\n  /**\n   * @inheritdoc\n   */\n  get streamEvents(): AgentGraph<\n    StateSchema,\n    StructuredResponseFormat\n  >[\"streamEvents\"] {\n    return this.#graph.streamEvents.bind(this.#graph);\n  }\n\n  /**\n   * Visualize the graph as a PNG image.\n   * @param params - Parameters for the drawMermaidPng method.\n   * @param params.withStyles - Whether to include styles in the graph.\n   * @param params.curveStyle - The style of the graph's curves.\n   * @param params.nodeColors - The colors of the graph's nodes.\n   * @param params.wrapLabelNWords - The maximum number of words to wrap in a node's label.\n   * @param params.backgroundColor - The background color of the graph.\n   * @returns PNG image as a buffer\n   */\n  async drawMermaidPng(params?: {\n    withStyles?: boolean;\n    curveStyle?: string;\n    nodeColors?: Record<string, string>;\n    wrapLabelNWords?: number;\n    backgroundColor?: string;\n  }) {\n    const representation = await this.#graph.getGraphAsync();\n    const image = await representation.drawMermaidPng(params);\n    const arrayBuffer = await image.arrayBuffer();\n    const buffer = new Uint8Array(arrayBuffer);\n    return buffer;\n  }\n\n  /**\n   * Draw the graph as a Mermaid string.\n   * @param params - Parameters for the drawMermaid method.\n   * @param params.withStyles - Whether to include styles in the graph.\n   * @param params.curveStyle - The style of the graph's curves.\n   * @param params.nodeColors - The colors of the graph's nodes.\n   * @param params.wrapLabelNWords - The maximum number of words to wrap in a node's label.\n   * @param params.backgroundColor - The background color of the graph.\n   * @returns Mermaid string\n   */\n  async drawMermaid(params?: {\n    withStyles?: boolean;\n    curveStyle?: string;\n    nodeColors?: Record<string, string>;\n    wrapLabelNWords?: number;\n    backgroundColor?: string;\n  }) {\n    const representation = await this.#graph.getGraphAsync();\n    return representation.drawMermaid(params);\n  }\n}\n"],"mappings":"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"}

package/dist/agents/ReactAgent.d.cts

@@ -0,0 +1,68 @@
+import { ResponseFormatUndefined } from "./responses.cjs";
+import { AnyAnnotationRoot, ReactAgentAnnotation, ToAnnotationRoot } from "./annotation.cjs";
+import { CreateReactAgentParams } from "./types.cjs";
+import { InteropZodObject } from "@langchain/core/utils/types";
+import { CompiledStateGraph, MessagesAnnotation } from "@langchain/langgraph";
+
+//#region src/agents/ReactAgent.d.ts
+type AgentGraph<StateSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, StructuredResponseFormat extends Record<string, any> | ResponseFormatUndefined = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot> = CompiledStateGraph<ToAnnotationRoot<StateSchema>["State"], ToAnnotationRoot<StateSchema>["Update"],
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+any, typeof MessagesAnnotation.spec & ToAnnotationRoot<StateSchema>["spec"], ReactAgentAnnotation<StructuredResponseFormat>["spec"] & ToAnnotationRoot<StateSchema>["spec"], ToAnnotationRoot<ContextSchema>["spec"], unknown>;
+declare class ReactAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, StructuredResponseFormat extends Record<string, any> | ResponseFormatUndefined = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot> {
+  #private;
+  options: CreateReactAgentParams<StateSchema, StructuredResponseFormat, ContextSchema>;
+  constructor(options: CreateReactAgentParams<StateSchema, StructuredResponseFormat, ContextSchema>);
+  /**
+   * Get the compiled graph.
+   */
+  get graph(): AgentGraph<StateSchema, StructuredResponseFormat, ContextSchema>;
+  /**
+   * @inheritdoc
+   */
+  get invoke(): AgentGraph<StateSchema, StructuredResponseFormat>["invoke"];
+  /**
+   * @inheritdoc
+   */
+  get stream(): AgentGraph<StateSchema, StructuredResponseFormat>["stream"];
+  /**
+   * @inheritdoc
+   */
+  get streamEvents(): AgentGraph<StateSchema, StructuredResponseFormat>["streamEvents"];
+  /**
+   * Visualize the graph as a PNG image.
+   * @param params - Parameters for the drawMermaidPng method.
+   * @param params.withStyles - Whether to include styles in the graph.
+   * @param params.curveStyle - The style of the graph's curves.
+   * @param params.nodeColors - The colors of the graph's nodes.
+   * @param params.wrapLabelNWords - The maximum number of words to wrap in a node's label.
+   * @param params.backgroundColor - The background color of the graph.
+   * @returns PNG image as a buffer
+   */
+  drawMermaidPng(params?: {
+    withStyles?: boolean;
+    curveStyle?: string;
+    nodeColors?: Record<string, string>;
+    wrapLabelNWords?: number;
+    backgroundColor?: string;
+  }): Promise<Uint8Array<ArrayBuffer>>;
+  /**
+   * Draw the graph as a Mermaid string.
+   * @param params - Parameters for the drawMermaid method.
+   * @param params.withStyles - Whether to include styles in the graph.
+   * @param params.curveStyle - The style of the graph's curves.
+   * @param params.nodeColors - The colors of the graph's nodes.
+   * @param params.wrapLabelNWords - The maximum number of words to wrap in a node's label.
+   * @param params.backgroundColor - The background color of the graph.
+   * @returns Mermaid string
+   */
+  drawMermaid(params?: {
+    withStyles?: boolean;
+    curveStyle?: string;
+    nodeColors?: Record<string, string>;
+    wrapLabelNWords?: number;
+    backgroundColor?: string;
+  }): Promise<string>;
+}
+//#endregion
+export { ReactAgent };
+//# sourceMappingURL=ReactAgent.d.cts.map

package/dist/agents/ReactAgent.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactAgent.d.cts","names":["InteropZodObject","CompiledStateGraph","MessagesAnnotation","ReactAgentAnnotation","CreateReactAgentParams","AnyAnnotationRoot","ToAnnotationRoot","ResponseFormatUndefined","AgentGraph","Record","StateSchema","spec","StructuredResponseFormat","ContextSchema","ReactAgent","ArrayBuffer","Uint8Array","Promise"],"sources":["../../src/agents/ReactAgent.d.ts"],"sourcesContent":["/* eslint-disable prefer-destructuring, no-instanceof/no-instanceof */\nimport { InteropZodObject } from \"@langchain/core/utils/types\";\nimport { CompiledStateGraph, MessagesAnnotation } from \"@langchain/langgraph\";\nimport { ReactAgentAnnotation } from \"./annotation.js\";\nimport type { CreateReactAgentParams } from \"./types.js\";\nimport type { AnyAnnotationRoot, ToAnnotationRoot } from \"./annotation.js\";\nimport type { ResponseFormatUndefined } from \"./responses.js\";\ntype AgentGraph<StateSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, StructuredResponseFormat extends Record<string, any> | ResponseFormatUndefined = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot> = CompiledStateGraph<ToAnnotationRoot<StateSchema>[\"State\"], ToAnnotationRoot<StateSchema>[\"Update\"], \n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nany, typeof MessagesAnnotation.spec & ToAnnotationRoot<StateSchema>[\"spec\"], ReactAgentAnnotation<StructuredResponseFormat>[\"spec\"] & ToAnnotationRoot<StateSchema>[\"spec\"], ToAnnotationRoot<ContextSchema>[\"spec\"], unknown>;\nexport declare class ReactAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, StructuredResponseFormat extends Record<string, any> | ResponseFormatUndefined = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot> {\n    #private;\n    options: CreateReactAgentParams<StateSchema, StructuredResponseFormat, ContextSchema>;\n    constructor(options: CreateReactAgentParams<StateSchema, StructuredResponseFormat, ContextSchema>);\n    /**\n     * Get the compiled graph.\n     */\n    get graph(): AgentGraph<StateSchema, StructuredResponseFormat, ContextSchema>;\n    /**\n     * @inheritdoc\n     */\n    get invoke(): AgentGraph<StateSchema, StructuredResponseFormat>[\"invoke\"];\n    /**\n     * @inheritdoc\n     */\n    get stream(): AgentGraph<StateSchema, StructuredResponseFormat>[\"stream\"];\n    /**\n     * @inheritdoc\n     */\n    get streamEvents(): AgentGraph<StateSchema, StructuredResponseFormat>[\"streamEvents\"];\n    /**\n     * Visualize the graph as a PNG image.\n     * @param params - Parameters for the drawMermaidPng method.\n     * @param params.withStyles - Whether to include styles in the graph.\n     * @param params.curveStyle - The style of the graph's curves.\n     * @param params.nodeColors - The colors of the graph's nodes.\n     * @param params.wrapLabelNWords - The maximum number of words to wrap in a node's label.\n     * @param params.backgroundColor - The background color of the graph.\n     * @returns PNG image as a buffer\n     */\n    drawMermaidPng(params?: {\n        withStyles?: boolean;\n        curveStyle?: string;\n        nodeColors?: Record<string, string>;\n        wrapLabelNWords?: number;\n        backgroundColor?: string;\n    }): Promise<Uint8Array<ArrayBuffer>>;\n    /**\n     * Draw the graph as a Mermaid string.\n     * @param params - Parameters for the drawMermaid method.\n     * @param params.withStyles - Whether to include styles in the graph.\n     * @param params.curveStyle - The style of the graph's curves.\n     * @param params.nodeColors - The colors of the graph's nodes.\n     * @param params.wrapLabelNWords - The maximum number of words to wrap in a node's label.\n     * @param params.backgroundColor - The background color of the graph.\n     * @returns Mermaid string\n     */\n    drawMermaid(params?: {\n        withStyles?: boolean;\n        curveStyle?: string;\n        nodeColors?: Record<string, string>;\n        wrapLabelNWords?: number;\n        backgroundColor?: string;\n    }): Promise<string>;\n}\nexport {};\n"],"mappings":"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"}

package/dist/agents/ReactAgent.d.ts

@@ -0,0 +1,68 @@
+import { ResponseFormatUndefined } from "./responses.js";
+import { AnyAnnotationRoot, ReactAgentAnnotation, ToAnnotationRoot } from "./annotation.js";
+import { CreateReactAgentParams } from "./types.js";
+import { CompiledStateGraph, MessagesAnnotation } from "@langchain/langgraph";
+import { InteropZodObject } from "@langchain/core/utils/types";
+
+//#region src/agents/ReactAgent.d.ts
+type AgentGraph<StateSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, StructuredResponseFormat extends Record<string, any> | ResponseFormatUndefined = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot> = CompiledStateGraph<ToAnnotationRoot<StateSchema>["State"], ToAnnotationRoot<StateSchema>["Update"],
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+any, typeof MessagesAnnotation.spec & ToAnnotationRoot<StateSchema>["spec"], ReactAgentAnnotation<StructuredResponseFormat>["spec"] & ToAnnotationRoot<StateSchema>["spec"], ToAnnotationRoot<ContextSchema>["spec"], unknown>;
+declare class ReactAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, StructuredResponseFormat extends Record<string, any> | ResponseFormatUndefined = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot> {
+  #private;
+  options: CreateReactAgentParams<StateSchema, StructuredResponseFormat, ContextSchema>;
+  constructor(options: CreateReactAgentParams<StateSchema, StructuredResponseFormat, ContextSchema>);
+  /**
+   * Get the compiled graph.
+   */
+  get graph(): AgentGraph<StateSchema, StructuredResponseFormat, ContextSchema>;
+  /**
+   * @inheritdoc
+   */
+  get invoke(): AgentGraph<StateSchema, StructuredResponseFormat>["invoke"];
+  /**
+   * @inheritdoc
+   */
+  get stream(): AgentGraph<StateSchema, StructuredResponseFormat>["stream"];
+  /**
+   * @inheritdoc
+   */
+  get streamEvents(): AgentGraph<StateSchema, StructuredResponseFormat>["streamEvents"];
+  /**
+   * Visualize the graph as a PNG image.
+   * @param params - Parameters for the drawMermaidPng method.
+   * @param params.withStyles - Whether to include styles in the graph.
+   * @param params.curveStyle - The style of the graph's curves.
+   * @param params.nodeColors - The colors of the graph's nodes.
+   * @param params.wrapLabelNWords - The maximum number of words to wrap in a node's label.
+   * @param params.backgroundColor - The background color of the graph.
+   * @returns PNG image as a buffer
+   */
+  drawMermaidPng(params?: {
+    withStyles?: boolean;
+    curveStyle?: string;
+    nodeColors?: Record<string, string>;
+    wrapLabelNWords?: number;
+    backgroundColor?: string;
+  }): Promise<Uint8Array<ArrayBuffer>>;
+  /**
+   * Draw the graph as a Mermaid string.
+   * @param params - Parameters for the drawMermaid method.
+   * @param params.withStyles - Whether to include styles in the graph.
+   * @param params.curveStyle - The style of the graph's curves.
+   * @param params.nodeColors - The colors of the graph's nodes.
+   * @param params.wrapLabelNWords - The maximum number of words to wrap in a node's label.
+   * @param params.backgroundColor - The background color of the graph.
+   * @returns Mermaid string
+   */
+  drawMermaid(params?: {
+    withStyles?: boolean;
+    curveStyle?: string;
+    nodeColors?: Record<string, string>;
+    wrapLabelNWords?: number;
+    backgroundColor?: string;
+  }): Promise<string>;
+}
+//#endregion
+export { ReactAgent };
+//# sourceMappingURL=ReactAgent.d.ts.map

package/dist/agents/ReactAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactAgent.d.ts","names":["InteropZodObject","CompiledStateGraph","MessagesAnnotation","ReactAgentAnnotation","CreateReactAgentParams","AnyAnnotationRoot","ToAnnotationRoot","ResponseFormatUndefined","AgentGraph","Record","StateSchema","spec","StructuredResponseFormat","ContextSchema","ReactAgent","ArrayBuffer","Uint8Array","Promise"],"sources":["../../src/agents/ReactAgent.d.ts"],"sourcesContent":["/* eslint-disable prefer-destructuring, no-instanceof/no-instanceof */\nimport { InteropZodObject } from \"@langchain/core/utils/types\";\nimport { CompiledStateGraph, MessagesAnnotation } from \"@langchain/langgraph\";\nimport { ReactAgentAnnotation } from \"./annotation.js\";\nimport type { CreateReactAgentParams } from \"./types.js\";\nimport type { AnyAnnotationRoot, ToAnnotationRoot } from \"./annotation.js\";\nimport type { ResponseFormatUndefined } from \"./responses.js\";\ntype AgentGraph<StateSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, StructuredResponseFormat extends Record<string, any> | ResponseFormatUndefined = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot> = CompiledStateGraph<ToAnnotationRoot<StateSchema>[\"State\"], ToAnnotationRoot<StateSchema>[\"Update\"], \n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nany, typeof MessagesAnnotation.spec & ToAnnotationRoot<StateSchema>[\"spec\"], ReactAgentAnnotation<StructuredResponseFormat>[\"spec\"] & ToAnnotationRoot<StateSchema>[\"spec\"], ToAnnotationRoot<ContextSchema>[\"spec\"], unknown>;\nexport declare class ReactAgent<StateSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot, StructuredResponseFormat extends Record<string, any> | ResponseFormatUndefined = Record<string, any>, ContextSchema extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot> {\n    #private;\n    options: CreateReactAgentParams<StateSchema, StructuredResponseFormat, ContextSchema>;\n    constructor(options: CreateReactAgentParams<StateSchema, StructuredResponseFormat, ContextSchema>);\n    /**\n     * Get the compiled graph.\n     */\n    get graph(): AgentGraph<StateSchema, StructuredResponseFormat, ContextSchema>;\n    /**\n     * @inheritdoc\n     */\n    get invoke(): AgentGraph<StateSchema, StructuredResponseFormat>[\"invoke\"];\n    /**\n     * @inheritdoc\n     */\n    get stream(): AgentGraph<StateSchema, StructuredResponseFormat>[\"stream\"];\n    /**\n     * @inheritdoc\n     */\n    get streamEvents(): AgentGraph<StateSchema, StructuredResponseFormat>[\"streamEvents\"];\n    /**\n     * Visualize the graph as a PNG image.\n     * @param params - Parameters for the drawMermaidPng method.\n     * @param params.withStyles - Whether to include styles in the graph.\n     * @param params.curveStyle - The style of the graph's curves.\n     * @param params.nodeColors - The colors of the graph's nodes.\n     * @param params.wrapLabelNWords - The maximum number of words to wrap in a node's label.\n     * @param params.backgroundColor - The background color of the graph.\n     * @returns PNG image as a buffer\n     */\n    drawMermaidPng(params?: {\n        withStyles?: boolean;\n        curveStyle?: string;\n        nodeColors?: Record<string, string>;\n        wrapLabelNWords?: number;\n        backgroundColor?: string;\n    }): Promise<Uint8Array<ArrayBuffer>>;\n    /**\n     * Draw the graph as a Mermaid string.\n     * @param params - Parameters for the drawMermaid method.\n     * @param params.withStyles - Whether to include styles in the graph.\n     * @param params.curveStyle - The style of the graph's curves.\n     * @param params.nodeColors - The colors of the graph's nodes.\n     * @param params.wrapLabelNWords - The maximum number of words to wrap in a node's label.\n     * @param params.backgroundColor - The background color of the graph.\n     * @returns Mermaid string\n     */\n    drawMermaid(params?: {\n        withStyles?: boolean;\n        curveStyle?: string;\n        nodeColors?: Record<string, string>;\n        wrapLabelNWords?: number;\n        backgroundColor?: string;\n    }): Promise<string>;\n}\nexport {};\n"],"mappings":"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"}