langchain 1.3.3 → 1.3.5

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # langchain
 
+## 1.3.5
+
+### Patch Changes
+
+- [#10776](https://github.com/langchain-ai/langchainjs/pull/10776) [`20a9abe`](https://github.com/langchain-ai/langchainjs/commit/20a9abea23ffacf4ae8dc9a7aeec217143bbdeb6) Thanks [@hntrl](https://github.com/hntrl)! - fix(deps): remediate uuid vulnerability by removing direct uuid usage
+
+- Updated dependencies [[`20a9abe`](https://github.com/langchain-ai/langchainjs/commit/20a9abea23ffacf4ae8dc9a7aeec217143bbdeb6)]:
+  - @langchain/core@1.1.42
+
+## 1.3.4
+
+### Patch Changes
+
+- [#10713](https://github.com/langchain-ai/langchainjs/pull/10713) [`49ac9e7`](https://github.com/langchain-ai/langchainjs/commit/49ac9e7404e5a9269b9ac047711ee96dd928b231) Thanks [@jacoblee93](https://github.com/jacoblee93)! - feat(langchain): Adds ls_agent_type to create agent runs as tracing metadata
+
+- Updated dependencies [[`589f29c`](https://github.com/langchain-ai/langchainjs/commit/589f29ce844eb252c2d5e6b0f8d26de37763a0d7), [`2e9e696`](https://github.com/langchain-ai/langchainjs/commit/2e9e6969e248a53ede0659a41d0ac8dbaf291ab4)]:
+  - @langchain/core@1.1.41
+
 ## 1.3.3
 
 ### Patch Changes

package/dist/agents/ReactAgent.cjs

@@ -48,7 +48,10 @@ var ReactAgent = class ReactAgent {
 	#defaultConfig;
 	constructor(options, defaultConfig) {
 		this.options = options;
-		this.#defaultConfig = (0, _langchain_core_runnables.mergeConfigs)(defaultConfig ?? {}, { metadata: { ls_integration: "langchain_create_agent" } });
+		this.#defaultConfig = (0, _langchain_core_runnables.mergeConfigs)(defaultConfig ?? {}, {
+			metadata: { ls_integration: "langchain_create_agent" },
+			configurable: { ls_agent_type: "root" }
+		});
 		if (options.name) this.#defaultConfig = (0, _langchain_core_runnables.mergeConfigs)(this.#defaultConfig, { metadata: { lc_agent_name: options.name } });
 		this.#toolBehaviorVersion = options.version ?? this.#toolBehaviorVersion;
 		/**

package/dist/agents/ReactAgent.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ReactAgent.cjs","names":["#defaultConfig","#toolBehaviorVersion","isClientTool","createAgentState","StateGraph","#agentNode","AgentNode","normalizeSystemPrompt","BeforeAgentNode","getHookConstraint","BeforeModelNode","AfterModelNode","AfterAgentNode","AGENT_NODE_NAME","ToolNode","wrapToolCall","TOOLS_NODE_NAME","END","START","parseJumpToTarget","#createBeforeAgentRouter","#createBeforeModelRouter","#getModelPaths","#createModelRouter","#createAfterModelSequenceRouter","#createAfterModelRouter","#createToolsRouter","#graph","ToolMessage","AIMessage","Send","#initializeMiddlewareStates","Command","initializeMiddlewareStates"],"sources":["../../src/agents/ReactAgent.ts"],"sourcesContent":["/* oxlint-disable no-instanceof/no-instanceof */\n/* oxlint-disable @typescript-eslint/no-explicit-any */\nimport { InteropZodObject } from \"@langchain/core/utils/types\";\n\nimport {\n  StateGraph,\n  END,\n  START,\n  Send,\n  Command,\n  CompiledStateGraph,\n  type GetStateOptions,\n  type LangGraphRunnableConfig,\n  type StreamMode,\n  type StreamOutputMap,\n  type PregelOptions,\n} from \"@langchain/langgraph\";\nimport type {\n  BaseCheckpointSaver,\n  BaseStore,\n  CheckpointListOptions,\n} from \"@langchain/langgraph-checkpoint\";\nimport {\n  ToolMessage,\n  AIMessage,\n  MessageStructure,\n} from \"@langchain/core/messages\";\nimport { IterableReadableStream } from \"@langchain/core/utils/stream\";\nimport {\n  mergeConfigs,\n  type Runnable,\n  type RunnableConfig,\n} from \"@langchain/core/runnables\";\nimport type { StreamEvent } from \"@langchain/core/tracers/log_stream\";\nimport type { ClientTool, ServerTool } from \"@langchain/core/tools\";\nimport { createAgentState } from \"./annotation.js\";\nimport {\n  isClientTool,\n  validateLLMHasNoBoundTools,\n  wrapToolCall,\n  normalizeSystemPrompt,\n} from \"./utils.js\";\n\nimport { AgentNode, AGENT_NODE_NAME } from \"./nodes/AgentNode.js\";\nimport { ToolNode, TOOLS_NODE_NAME } from \"./nodes/ToolNode.js\";\nimport { BeforeAgentNode } from \"./nodes/BeforeAgentNode.js\";\nimport { BeforeModelNode } from \"./nodes/BeforeModelNode.js\";\nimport { AfterModelNode } from \"./nodes/AfterModelNode.js\";\nimport { AfterAgentNode } from \"./nodes/AfterAgentNode.js\";\nimport {\n  initializeMiddlewareStates,\n  parseJumpToTarget,\n} from \"./nodes/utils.js\";\n\nimport type {\n  WithStateGraphNodes,\n  AgentTypeConfig,\n  CreateAgentParams,\n  ToolsToMessageToolSet,\n} from \"./types.js\";\n\nimport type { BuiltInState, JumpTo, UserInput } from \"./types.js\";\nimport type { InvokeConfiguration, StreamConfiguration } from \"./runtime.js\";\nimport type {\n  AgentMiddleware,\n  InferMiddlewareContextInputs,\n  InferMiddlewareStates,\n  InferMiddlewareInputStates,\n  InferContextInput,\n  AnyAnnotationRoot,\n  InferSchemaValue,\n  ToAnnotationRoot,\n} from \"./middleware/types.js\";\nimport { type ResponseFormatUndefined } from \"./responses.js\";\nimport { getHookConstraint } from \"./middleware/utils.js\";\n\n/**\n * In the ReAct pattern we have three main nodes:\n * - model_request: The node that makes the model call.\n * - tools: The node that calls the tools.\n * - END: The end of the graph.\n *\n * These are the only nodes that can be jumped to from other nodes.\n */\ntype BaseGraphDestination =\n  | typeof TOOLS_NODE_NAME\n  | typeof AGENT_NODE_NAME\n  | typeof END;\n\n// Helper type to get the state definition with middleware states\ntype MergedAgentState<Types extends AgentTypeConfig> = InferSchemaValue<\n  Types[\"State\"]\n> &\n  (Types[\"Response\"] extends ResponseFormatUndefined\n    ? Omit<\n        BuiltInState<MessageStructure<ToolsToMessageToolSet<Types[\"Tools\"]>>>,\n        \"jumpTo\"\n      >\n    : Omit<\n        BuiltInState<MessageStructure<ToolsToMessageToolSet<Types[\"Tools\"]>>>,\n        \"jumpTo\"\n      > & {\n        structuredResponse: Types[\"Response\"];\n      }) &\n  InferMiddlewareStates<Types[\"Middleware\"]>;\n\ntype InvokeStateParameter<Types extends AgentTypeConfig> =\n  | (UserInput<Types[\"State\"]> &\n      InferMiddlewareInputStates<Types[\"Middleware\"]>)\n  | Command<any, any, any>\n  | null;\n\ntype AgentGraph<Types extends AgentTypeConfig> = CompiledStateGraph<\n  any,\n  any,\n  any,\n  any,\n  MergedAgentState<Types>,\n  ToAnnotationRoot<\n    Types[\"Context\"] extends AnyAnnotationRoot | InteropZodObject\n      ? Types[\"Context\"]\n      : AnyAnnotationRoot\n  >[\"spec\"],\n  unknown\n>;\n\n/**\n * ReactAgent is a production-ready ReAct (Reasoning + Acting) agent that combines\n * language models with tools and middleware.\n *\n * The agent is parameterized by a single type bag `Types` that encapsulates all\n * type information:\n *\n * @typeParam Types - An {@link AgentTypeConfig} that bundles:\n *   - `Response`: The structured response type\n *   - `State`: The custom state schema type\n *   - `Context`: The context schema type\n *   - `Middleware`: The middleware array type\n *   - `Tools`: The combined tools type from agent and middleware\n *\n * @example\n * ```typescript\n * // Using the type bag pattern\n * type MyTypes = AgentTypeConfig<\n *   { name: string },  // Response\n *   typeof myState,    // State\n *   typeof myContext,  // Context\n *   typeof middleware, // Middleware\n *   typeof tools       // Tools\n * >;\n *\n * const agent: ReactAgent<MyTypes> = createAgent({ ... });\n * ```\n */\nexport class ReactAgent<\n  Types extends AgentTypeConfig = AgentTypeConfig<\n    Record<string, any>,\n    undefined,\n    AnyAnnotationRoot,\n    readonly AgentMiddleware[],\n    readonly (ClientTool | ServerTool)[]\n  >,\n> {\n  /**\n   * Type marker for extracting the AgentTypeConfig from a ReactAgent instance.\n   * This is a phantom property used only for type inference.\n   * @internal\n   */\n  declare readonly \"~agentTypes\": Types;\n\n  #graph: AgentGraph<Types>;\n\n  #toolBehaviorVersion: \"v1\" | \"v2\" = \"v2\";\n\n  #agentNode: AgentNode<any, AnyAnnotationRoot>;\n\n  #defaultConfig: RunnableConfig;\n\n  constructor(\n    public options: CreateAgentParams<\n      Types[\"Response\"],\n      Types[\"State\"],\n      Types[\"Context\"]\n    >,\n    defaultConfig?: RunnableConfig\n  ) {\n    this.#defaultConfig = mergeConfigs(defaultConfig ?? {}, {\n      metadata: { ls_integration: \"langchain_create_agent\" },\n    });\n    if (options.name) {\n      this.#defaultConfig = mergeConfigs(this.#defaultConfig, {\n        metadata: { lc_agent_name: options.name },\n      });\n    }\n    this.#toolBehaviorVersion = options.version ?? this.#toolBehaviorVersion;\n\n    /**\n     * validate that model option is provided\n     */\n    if (!options.model) {\n      throw new Error(\"`model` option is required to create an agent.\");\n    }\n\n    /**\n     * Check if the LLM already has bound tools and throw if it does.\n     */\n    if (typeof options.model !== \"string\") {\n      validateLLMHasNoBoundTools(options.model);\n    }\n\n    /**\n     * define complete list of tools based on options and middleware\n     */\n    const middlewareTools = (this.options.middleware\n      ?.filter((m) => m.tools)\n      .flatMap((m) => m.tools) ?? []) as (ClientTool | ServerTool)[];\n    const toolClasses = [...(options.tools ?? []), ...middlewareTools];\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    /**\n     * Create a schema that merges agent base schema with middleware state schemas\n     * Using Zod with withLangGraph ensures LangGraph Studio gets proper metadata\n     */\n    const hasDynamicStructuredResponse = Boolean(\n      this.options.middleware?.some((middleware) => middleware.wrapModelCall)\n    );\n    const { state, input, output } = createAgentState<\n      Types[\"State\"],\n      Types[\"Middleware\"]\n    >(\n      this.options.responseFormat !== undefined || hasDynamicStructuredResponse,\n      this.options.stateSchema as Types[\"State\"],\n      this.options.middleware as Types[\"Middleware\"]\n    );\n\n    const workflow = new StateGraph(state, {\n      input,\n      output,\n      context: this.options.contextSchema,\n    });\n\n    const allNodeWorkflows = workflow as WithStateGraphNodes<\n      typeof TOOLS_NODE_NAME | typeof AGENT_NODE_NAME | string,\n      typeof workflow\n    >;\n\n    // Generate node names for middleware nodes that have hooks\n    const beforeAgentNodes: {\n      index: number;\n      name: string;\n      allowed?: string[];\n    }[] = [];\n    const beforeModelNodes: {\n      index: number;\n      name: string;\n      allowed?: string[];\n    }[] = [];\n    const afterModelNodes: {\n      index: number;\n      name: string;\n      allowed?: string[];\n    }[] = [];\n    const afterAgentNodes: {\n      index: number;\n      name: string;\n      allowed?: string[];\n    }[] = [];\n    const wrapModelCallHookMiddleware: AgentMiddleware[] = [];\n\n    this.#agentNode = new AgentNode({\n      model: this.options.model,\n      systemMessage: normalizeSystemPrompt(this.options.systemPrompt),\n      includeAgentName: this.options.includeAgentName,\n      name: this.options.name,\n      responseFormat: this.options.responseFormat,\n      middleware: this.options.middleware,\n      toolClasses,\n      shouldReturnDirect,\n      signal: this.options.signal,\n      wrapModelCallHookMiddleware,\n    });\n\n    const middlewareNames = new Set<string>();\n    const middleware = this.options.middleware ?? [];\n    for (let i = 0; i < middleware.length; i++) {\n      let beforeAgentNode: BeforeAgentNode | undefined;\n      let beforeModelNode: BeforeModelNode | undefined;\n      let afterModelNode: AfterModelNode | undefined;\n      let afterAgentNode: AfterAgentNode | undefined;\n      const m = middleware[i];\n      if (middlewareNames.has(m.name)) {\n        throw new Error(`Middleware ${m.name} is defined multiple times`);\n      }\n\n      middlewareNames.add(m.name);\n      if (m.beforeAgent) {\n        beforeAgentNode = new BeforeAgentNode(m);\n        const name = `${m.name}.before_agent`;\n        beforeAgentNodes.push({\n          index: i,\n          name,\n          allowed: getHookConstraint(m.beforeAgent),\n        });\n        allNodeWorkflows.addNode(\n          name,\n          beforeAgentNode,\n          beforeAgentNode.nodeOptions\n        );\n      }\n      if (m.beforeModel) {\n        beforeModelNode = new BeforeModelNode(m);\n        const name = `${m.name}.before_model`;\n        beforeModelNodes.push({\n          index: i,\n          name,\n          allowed: getHookConstraint(m.beforeModel),\n        });\n        allNodeWorkflows.addNode(\n          name,\n          beforeModelNode,\n          beforeModelNode.nodeOptions\n        );\n      }\n      if (m.afterModel) {\n        afterModelNode = new AfterModelNode(m);\n        const name = `${m.name}.after_model`;\n        afterModelNodes.push({\n          index: i,\n          name,\n          allowed: getHookConstraint(m.afterModel),\n        });\n        allNodeWorkflows.addNode(\n          name,\n          afterModelNode,\n          afterModelNode.nodeOptions\n        );\n      }\n      if (m.afterAgent) {\n        afterAgentNode = new AfterAgentNode(m);\n        const name = `${m.name}.after_agent`;\n        afterAgentNodes.push({\n          index: i,\n          name,\n          allowed: getHookConstraint(m.afterAgent),\n        });\n        allNodeWorkflows.addNode(\n          name,\n          afterAgentNode,\n          afterAgentNode.nodeOptions\n        );\n      }\n\n      if (m.wrapModelCall) {\n        wrapModelCallHookMiddleware.push(m);\n      }\n    }\n\n    /**\n     * Add Nodes\n     */\n    allNodeWorkflows.addNode(AGENT_NODE_NAME, this.#agentNode);\n\n    /**\n     * Check if any middleware has wrapToolCall defined.\n     * If so, we need to create a ToolNode even without pre-registered tools\n     * to allow middleware to handle dynamically registered tools.\n     */\n    const hasWrapToolCallMiddleware = middleware.some((m) => m.wrapToolCall);\n    const clientTools = toolClasses.filter(isClientTool);\n\n    /**\n     * Create ToolNode if we have client-side tools OR if middleware defines wrapToolCall\n     * (which may handle dynamically registered tools)\n     */\n    if (clientTools.length > 0 || hasWrapToolCallMiddleware) {\n      const toolNode = new ToolNode(clientTools, {\n        signal: this.options.signal,\n        wrapToolCall: wrapToolCall(middleware),\n      });\n      allNodeWorkflows.addNode(TOOLS_NODE_NAME, toolNode);\n    }\n\n    /**\n     * Add Edges\n     */\n    // Determine the entry node (runs once at start): before_agent -> before_model -> model_request\n    let entryNode: string;\n    if (beforeAgentNodes.length > 0) {\n      entryNode = beforeAgentNodes[0].name;\n    } else if (beforeModelNodes.length > 0) {\n      entryNode = beforeModelNodes[0].name;\n    } else {\n      entryNode = AGENT_NODE_NAME;\n    }\n\n    // Determine the loop entry node (beginning of agent loop, excludes before_agent)\n    // This is where tools will loop back to for the next iteration\n    const loopEntryNode =\n      beforeModelNodes.length > 0 ? beforeModelNodes[0].name : AGENT_NODE_NAME;\n\n    // Determine the exit node (runs once at end): after_agent or END\n    const exitNode =\n      afterAgentNodes.length > 0\n        ? afterAgentNodes[afterAgentNodes.length - 1].name\n        : END;\n\n    allNodeWorkflows.addEdge(START, entryNode);\n\n    /**\n     * Determine if we have tools available for routing.\n     * This includes both registered client tools AND dynamic tools via middleware.\n     */\n    const hasToolsAvailable =\n      clientTools.length > 0 || hasWrapToolCallMiddleware;\n\n    // Connect beforeAgent nodes (run once at start)\n    for (let i = 0; i < beforeAgentNodes.length; i++) {\n      const node = beforeAgentNodes[i];\n      const current = node.name;\n      const isLast = i === beforeAgentNodes.length - 1;\n      const nextDefault = isLast ? loopEntryNode : beforeAgentNodes[i + 1].name;\n\n      if (node.allowed && node.allowed.length > 0) {\n        const allowedMapped = node.allowed\n          .map((t) => parseJumpToTarget(t))\n          .filter((dest) => dest !== TOOLS_NODE_NAME || hasToolsAvailable);\n        // Replace END with exitNode (which could be an afterAgent node)\n        const destinations = Array.from(\n          new Set([\n            nextDefault,\n            ...allowedMapped.map((dest) => (dest === END ? exitNode : dest)),\n          ])\n        ) as BaseGraphDestination[];\n\n        allNodeWorkflows.addConditionalEdges(\n          current,\n          this.#createBeforeAgentRouter(\n            clientTools,\n            nextDefault,\n            exitNode,\n            hasToolsAvailable\n          ),\n          destinations\n        );\n      } else {\n        allNodeWorkflows.addEdge(current, nextDefault);\n      }\n    }\n\n    // Connect beforeModel nodes; add conditional routing ONLY if allowed jumps are specified\n    for (let i = 0; i < beforeModelNodes.length; i++) {\n      const node = beforeModelNodes[i];\n      const current = node.name;\n      const isLast = i === beforeModelNodes.length - 1;\n      const nextDefault = isLast\n        ? AGENT_NODE_NAME\n        : beforeModelNodes[i + 1].name;\n\n      if (node.allowed && node.allowed.length > 0) {\n        const allowedMapped = node.allowed\n          .map((t) => parseJumpToTarget(t))\n          .filter((dest) => dest !== TOOLS_NODE_NAME || hasToolsAvailable);\n        const destinations = Array.from(\n          new Set([nextDefault, ...allowedMapped])\n        ) as BaseGraphDestination[];\n\n        allNodeWorkflows.addConditionalEdges(\n          current,\n          this.#createBeforeModelRouter(\n            clientTools,\n            nextDefault,\n            hasToolsAvailable\n          ),\n          destinations\n        );\n      } else {\n        allNodeWorkflows.addEdge(current, nextDefault);\n      }\n    }\n\n    // Connect agent to last afterModel node (for reverse order execution)\n    const lastAfterModelNode = afterModelNodes.at(-1);\n    if (afterModelNodes.length > 0 && lastAfterModelNode) {\n      allNodeWorkflows.addEdge(AGENT_NODE_NAME, lastAfterModelNode.name);\n    } else {\n      // If no afterModel nodes, connect model_request directly to model paths\n      const modelPaths = this.#getModelPaths(\n        clientTools,\n        false,\n        hasToolsAvailable\n      );\n      // Replace END with exitNode in destinations, since exitNode might be an afterAgent node\n      const destinations = modelPaths.map((p) =>\n        p === END ? exitNode : p\n      ) as BaseGraphDestination[];\n      if (destinations.length === 1) {\n        allNodeWorkflows.addEdge(AGENT_NODE_NAME, destinations[0]);\n      } else {\n        allNodeWorkflows.addConditionalEdges(\n          AGENT_NODE_NAME,\n          this.#createModelRouter(exitNode),\n          destinations\n        );\n      }\n    }\n\n    // Connect afterModel nodes in reverse sequence; add conditional routing ONLY if allowed jumps are specified per node\n    for (let i = afterModelNodes.length - 1; i > 0; i--) {\n      const node = afterModelNodes[i];\n      const current = node.name;\n      const nextDefault = afterModelNodes[i - 1].name;\n\n      if (node.allowed && node.allowed.length > 0) {\n        const allowedMapped = node.allowed\n          .map((t) => parseJumpToTarget(t))\n          .filter((dest) => dest !== TOOLS_NODE_NAME || hasToolsAvailable);\n        const destinations = Array.from(\n          new Set([nextDefault, ...allowedMapped])\n        ) as BaseGraphDestination[];\n\n        allNodeWorkflows.addConditionalEdges(\n          current,\n          this.#createAfterModelSequenceRouter(\n            clientTools,\n            node.allowed,\n            nextDefault,\n            hasToolsAvailable\n          ),\n          destinations\n        );\n      } else {\n        allNodeWorkflows.addEdge(current, nextDefault);\n      }\n    }\n\n    // Connect first afterModel node (last to execute) to model paths with jumpTo support\n    if (afterModelNodes.length > 0) {\n      const firstAfterModel = afterModelNodes[0];\n      const firstAfterModelNode = firstAfterModel.name;\n\n      // Include exitNode in the paths since afterModel should be able to route to after_agent or END\n      const modelPaths = this.#getModelPaths(\n        clientTools,\n        true,\n        hasToolsAvailable\n      ).filter((p) => p !== TOOLS_NODE_NAME || hasToolsAvailable);\n\n      const allowJump = Boolean(\n        firstAfterModel.allowed && firstAfterModel.allowed.length > 0\n      );\n\n      // Replace END with exitNode in destinations, since exitNode might be an afterAgent node\n      const destinations = modelPaths.map((p) =>\n        p === END ? exitNode : p\n      ) as BaseGraphDestination[];\n\n      allNodeWorkflows.addConditionalEdges(\n        firstAfterModelNode,\n        this.#createAfterModelRouter(\n          clientTools,\n          allowJump,\n          exitNode,\n          hasToolsAvailable\n        ),\n        destinations\n      );\n    }\n\n    // Connect afterAgent nodes (run once at end, in reverse order like afterModel)\n    for (let i = afterAgentNodes.length - 1; i > 0; i--) {\n      const node = afterAgentNodes[i];\n      const current = node.name;\n      const nextDefault = afterAgentNodes[i - 1].name;\n\n      if (node.allowed && node.allowed.length > 0) {\n        const allowedMapped = node.allowed\n          .map((t) => parseJumpToTarget(t))\n          .filter((dest) => dest !== TOOLS_NODE_NAME || hasToolsAvailable);\n        const destinations = Array.from(\n          new Set([nextDefault, ...allowedMapped])\n        ) as BaseGraphDestination[];\n\n        allNodeWorkflows.addConditionalEdges(\n          current,\n          this.#createAfterModelSequenceRouter(\n            clientTools,\n            node.allowed,\n            nextDefault,\n            hasToolsAvailable\n          ),\n          destinations\n        );\n      } else {\n        allNodeWorkflows.addEdge(current, nextDefault);\n      }\n    }\n\n    // Connect the first afterAgent node (last to execute) to END\n    if (afterAgentNodes.length > 0) {\n      const firstAfterAgent = afterAgentNodes[0];\n      const firstAfterAgentNode = firstAfterAgent.name;\n\n      if (firstAfterAgent.allowed && firstAfterAgent.allowed.length > 0) {\n        const allowedMapped = firstAfterAgent.allowed\n          .map((t) => parseJumpToTarget(t))\n          .filter((dest) => dest !== TOOLS_NODE_NAME || hasToolsAvailable);\n\n        /**\n         * For after_agent, only use explicitly allowed destinations (don't add loopEntryNode)\n         * The default destination (when no jump occurs) should be END\n         */\n        const destinations = Array.from(\n          new Set([END, ...allowedMapped])\n        ) as BaseGraphDestination[];\n\n        allNodeWorkflows.addConditionalEdges(\n          firstAfterAgentNode,\n          this.#createAfterModelSequenceRouter(\n            clientTools,\n            firstAfterAgent.allowed,\n            END as string,\n            hasToolsAvailable\n          ),\n          destinations\n        );\n      } else {\n        allNodeWorkflows.addEdge(firstAfterAgentNode, END);\n      }\n    }\n\n    /**\n     * add edges for tools node (includes both registered tools and dynamic tools via middleware)\n     */\n    if (hasToolsAvailable) {\n      // Tools should return to loop entry node (not including before_agent)\n      const toolReturnTarget = loopEntryNode;\n\n      if (shouldReturnDirect.size > 0) {\n        allNodeWorkflows.addConditionalEdges(\n          TOOLS_NODE_NAME,\n          this.#createToolsRouter(\n            shouldReturnDirect,\n            exitNode,\n            toolReturnTarget\n          ),\n          [toolReturnTarget, exitNode as string]\n        );\n      } else {\n        allNodeWorkflows.addEdge(TOOLS_NODE_NAME, toolReturnTarget);\n      }\n    }\n\n    /**\n     * compile the graph\n     */\n    this.#graph = allNodeWorkflows.compile({\n      checkpointer: this.options.checkpointer,\n      store: this.options.store,\n      name: this.options.name,\n      description: this.options.description,\n    }) as unknown as AgentGraph<Types>;\n  }\n\n  /**\n   * Get the compiled {@link https://docs.langchain.com/oss/javascript/langgraph/use-graph-api | StateGraph}.\n   */\n  get graph(): AgentGraph<Types> {\n    return this.#graph;\n  }\n\n  get checkpointer(): BaseCheckpointSaver | boolean | undefined {\n    return this.#graph.checkpointer;\n  }\n\n  set checkpointer(value: BaseCheckpointSaver | boolean | undefined) {\n    this.#graph.checkpointer = value;\n  }\n\n  get store(): BaseStore | undefined {\n    return this.#graph.store;\n  }\n\n  set store(value: BaseStore | undefined) {\n    this.#graph.store = value;\n  }\n\n  /**\n   * Creates a new ReactAgent with the given config merged into the existing config.\n   * Follows the same pattern as LangGraph's Pregel.withConfig().\n   *\n   * The merged config is applied as a default that gets merged with any config\n   * passed at invocation time (invoke/stream). Invocation-time config takes precedence.\n   *\n   * @param config - Configuration to merge with existing config\n   * @returns A new ReactAgent instance with the merged configuration\n   *\n   * @example\n   * ```typescript\n   * const agent = createAgent({ model: \"gpt-4o\", tools: [...] });\n   *\n   * // Set a default recursion limit\n   * const configuredAgent = agent.withConfig({ recursionLimit: 1000 });\n   *\n   * // Chain multiple configs\n   * const debugAgent = agent\n   *   .withConfig({ recursionLimit: 1000 })\n   *   .withConfig({ tags: [\"debug\"] });\n   * ```\n   */\n  withConfig(\n    config: Omit<RunnableConfig, \"store\" | \"writer\" | \"interrupt\">\n  ): ReactAgent<Types> {\n    return new ReactAgent(\n      this.options,\n      mergeConfigs(this.#defaultConfig, config)\n    );\n  }\n\n  /**\n   * Get possible edge destinations from model node.\n   * @param toolClasses names of tools to call\n   * @param includeModelRequest whether to include \"model_request\" as a valid path (for jumpTo routing)\n   * @param hasToolsAvailable whether tools are available (includes dynamic tools via middleware)\n   * @returns list of possible edge destinations\n   */\n  #getModelPaths(\n    toolClasses: (ClientTool | ServerTool)[],\n    includeModelRequest: boolean = false,\n    hasToolsAvailable: boolean = toolClasses.length > 0\n  ): BaseGraphDestination[] {\n    const paths: BaseGraphDestination[] = [];\n    if (hasToolsAvailable) {\n      paths.push(TOOLS_NODE_NAME);\n    }\n\n    if (includeModelRequest) {\n      paths.push(AGENT_NODE_NAME);\n    }\n\n    paths.push(END);\n\n    return paths;\n  }\n\n  /**\n   * Create routing function for tools node conditional edges.\n   */\n  #createToolsRouter(\n    shouldReturnDirect: Set<string>,\n    exitNode: string | typeof END,\n    toolReturnTarget: string\n  ) {\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as BuiltInState;\n      const messages = builtInState.messages;\n      const lastMessage = messages[messages.length - 1];\n\n      // Check if we just executed a returnDirect tool\n      if (\n        ToolMessage.isInstance(lastMessage) &&\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 to exit node (could be after_agent or END)\n        return this.options.responseFormat ? toolReturnTarget : exitNode;\n      }\n\n      // For non-returnDirect tools, route back to loop entry node (could be middleware or agent)\n      return toolReturnTarget;\n    };\n  }\n\n  /**\n   * Create routing function for model node conditional edges.\n   * @param exitNode - The exit node to route to (could be after_agent or END)\n   */\n  #createModelRouter(exitNode: string | typeof END = END) {\n    /**\n     * determine if the agent should continue or not\n     */\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as BuiltInState;\n      const messages = builtInState.messages;\n      const lastMessage = messages.at(-1);\n\n      if (\n        !AIMessage.isInstance(lastMessage) ||\n        !lastMessage.tool_calls ||\n        lastMessage.tool_calls.length === 0\n      ) {\n        return exitNode;\n      }\n\n      // Check if all tool calls are for structured response extraction\n      const hasOnlyStructuredResponseCalls = lastMessage.tool_calls.every(\n        (toolCall) => toolCall.name.startsWith(\"extract-\")\n      );\n\n      if (hasOnlyStructuredResponseCalls) {\n        // If all tool calls are for structured response extraction, go to exit node\n        // The AgentNode will handle these internally and return the structured response\n        return exitNode;\n      }\n\n      /**\n       * The tool node processes a single message.\n       */\n      if (this.#toolBehaviorVersion === \"v1\") {\n        return TOOLS_NODE_NAME;\n      }\n\n      /**\n       * Route to tools node (filter out any structured response tool calls)\n       */\n      const regularToolCalls = lastMessage.tool_calls.filter(\n        (toolCall) => !toolCall.name.startsWith(\"extract-\")\n      );\n\n      if (regularToolCalls.length === 0) {\n        return exitNode;\n      }\n\n      return regularToolCalls.map(\n        (toolCall) =>\n          new Send(TOOLS_NODE_NAME, { ...state, lg_tool_call: toolCall })\n      );\n    };\n  }\n\n  /**\n   * Create routing function for jumpTo functionality after afterModel hooks.\n   *\n   * This router checks if the `jumpTo` property is set in the state after afterModel middleware\n   * execution. If set, it routes to the specified target (\"model_request\" or \"tools\").\n   * If not set, it falls back to the normal model routing logic for afterModel context.\n   *\n   * The jumpTo property is automatically cleared after use to prevent infinite loops.\n   *\n   * @param toolClasses - Available tool classes for validation\n   * @param allowJump - Whether jumping is allowed\n   * @param exitNode - The exit node to route to (could be after_agent or END)\n   * @param hasToolsAvailable - Whether tools are available (includes dynamic tools via middleware)\n   * @returns Router function that handles jumpTo logic and normal routing\n   */\n  #createAfterModelRouter(\n    toolClasses: (ClientTool | ServerTool)[],\n    allowJump: boolean,\n    exitNode: string | typeof END,\n    hasToolsAvailable: boolean = toolClasses.length > 0\n  ) {\n    const hasStructuredResponse = Boolean(this.options.responseFormat);\n\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as Omit<BuiltInState, \"jumpTo\"> & {\n        jumpTo?: JumpTo;\n      };\n      // First, check if we just processed a structured response\n      // If so, ignore any existing jumpTo and go to exitNode\n      const messages = builtInState.messages;\n      const lastMessage = messages.at(-1);\n      if (\n        AIMessage.isInstance(lastMessage) &&\n        (!lastMessage.tool_calls || lastMessage.tool_calls.length === 0)\n      ) {\n        return exitNode;\n      }\n\n      // Check if jumpTo is set in the state and allowed\n      if (allowJump && builtInState.jumpTo) {\n        const destination = parseJumpToTarget(builtInState.jumpTo);\n        if (destination === END) {\n          return exitNode;\n        }\n        if (destination === TOOLS_NODE_NAME) {\n          // If trying to jump to tools but no tools are available, go to exitNode\n          if (!hasToolsAvailable) {\n            return exitNode;\n          }\n          return new Send(TOOLS_NODE_NAME, { ...state, jumpTo: undefined });\n        }\n        // destination === \"model_request\"\n        return new Send(AGENT_NODE_NAME, { ...state, jumpTo: undefined });\n      }\n\n      // check if there are pending tool calls\n      const toolMessages = messages.filter(ToolMessage.isInstance);\n      const lastAiMessage = messages.filter(AIMessage.isInstance).at(-1);\n      const pendingToolCalls = lastAiMessage?.tool_calls?.filter(\n        (call) => !toolMessages.some((m) => m.tool_call_id === call.id)\n      );\n      if (pendingToolCalls && pendingToolCalls.length > 0) {\n        /**\n         * v1: route the full message to the ToolNode; it filters already-processed\n         * calls internally and runs the remaining ones via Promise.all.\n         * v2: dispatch each pending call as a separate Send task.\n         */\n        if (this.#toolBehaviorVersion === \"v1\") {\n          return TOOLS_NODE_NAME;\n        }\n        return pendingToolCalls.map(\n          (toolCall) =>\n            new Send(TOOLS_NODE_NAME, { ...state, lg_tool_call: toolCall })\n        );\n      }\n\n      // if we exhausted all tool calls, but still have no structured response tool calls,\n      // go back to model_request\n      const hasStructuredResponseCalls = lastAiMessage?.tool_calls?.some(\n        (toolCall) => toolCall.name.startsWith(\"extract-\")\n      );\n\n      if (\n        pendingToolCalls &&\n        pendingToolCalls.length === 0 &&\n        !hasStructuredResponseCalls &&\n        hasStructuredResponse\n      ) {\n        return AGENT_NODE_NAME;\n      }\n\n      if (\n        !AIMessage.isInstance(lastMessage) ||\n        !lastMessage.tool_calls ||\n        lastMessage.tool_calls.length === 0\n      ) {\n        return exitNode;\n      }\n\n      // Check if all tool calls are for structured response extraction\n      const hasOnlyStructuredResponseCalls = lastMessage.tool_calls.every(\n        (toolCall) => toolCall.name.startsWith(\"extract-\")\n      );\n\n      // Check if there are any regular tool calls (non-structured response)\n      const hasRegularToolCalls = lastMessage.tool_calls.some(\n        (toolCall) => !toolCall.name.startsWith(\"extract-\")\n      );\n\n      if (hasOnlyStructuredResponseCalls || !hasRegularToolCalls) {\n        return exitNode;\n      }\n\n      /**\n       * v1: route the full AIMessage to a single ToolNode invocation so all\n       * tool calls run concurrently via Promise.all.\n       *\n       * v2: dispatch each regular tool call as a separate Send task, matching\n       * the behaviour of #createModelRouter when no afterModel middleware is\n       * present.\n       */\n      if (this.#toolBehaviorVersion === \"v1\") {\n        return TOOLS_NODE_NAME;\n      }\n\n      const regularToolCalls = (lastMessage as AIMessage).tool_calls!.filter(\n        (toolCall) => !toolCall.name.startsWith(\"extract-\")\n      );\n\n      if (regularToolCalls.length === 0) {\n        return exitNode;\n      }\n\n      return regularToolCalls.map(\n        (toolCall) =>\n          new Send(TOOLS_NODE_NAME, { ...state, lg_tool_call: toolCall })\n      );\n    };\n  }\n\n  /**\n   * Router for afterModel sequence nodes (connecting later middlewares to earlier ones),\n   * honoring allowed jump targets and defaulting to the next node.\n   * @param toolClasses - Available tool classes for validation\n   * @param allowed - List of allowed jump targets\n   * @param nextDefault - Default node to route to\n   * @param hasToolsAvailable - Whether tools are available (includes dynamic tools via middleware)\n   */\n  #createAfterModelSequenceRouter(\n    toolClasses: (ClientTool | ServerTool)[],\n    allowed: string[],\n    nextDefault: string,\n    hasToolsAvailable: boolean = toolClasses.length > 0\n  ) {\n    const allowedSet = new Set(allowed.map((t) => parseJumpToTarget(t)));\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as BuiltInState;\n      if (builtInState.jumpTo) {\n        const dest = parseJumpToTarget(builtInState.jumpTo);\n        if (dest === END && allowedSet.has(END)) {\n          return END;\n        }\n        if (dest === TOOLS_NODE_NAME && allowedSet.has(TOOLS_NODE_NAME)) {\n          if (!hasToolsAvailable) return END;\n          return new Send(TOOLS_NODE_NAME, { ...state, jumpTo: undefined });\n        }\n        if (dest === AGENT_NODE_NAME && allowedSet.has(AGENT_NODE_NAME)) {\n          return new Send(AGENT_NODE_NAME, { ...state, jumpTo: undefined });\n        }\n      }\n      return nextDefault;\n    };\n  }\n\n  /**\n   * Create routing function for jumpTo functionality after beforeAgent hooks.\n   * Falls back to the default next node if no jumpTo is present.\n   * When jumping to END, routes to exitNode (which could be an afterAgent node).\n   * @param toolClasses - Available tool classes for validation\n   * @param nextDefault - Default node to route to\n   * @param exitNode - Exit node to route to (could be after_agent or END)\n   * @param hasToolsAvailable - Whether tools are available (includes dynamic tools via middleware)\n   */\n  #createBeforeAgentRouter(\n    toolClasses: (ClientTool | ServerTool)[],\n    nextDefault: string,\n    exitNode: string | typeof END,\n    hasToolsAvailable: boolean = toolClasses.length > 0\n  ) {\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as BuiltInState;\n      if (!builtInState.jumpTo) {\n        return nextDefault;\n      }\n      const destination = parseJumpToTarget(builtInState.jumpTo);\n      if (destination === END) {\n        /**\n         * When beforeAgent jumps to END, route to exitNode (first afterAgent node)\n         */\n        return exitNode;\n      }\n      if (destination === TOOLS_NODE_NAME) {\n        if (!hasToolsAvailable) {\n          return exitNode;\n        }\n        return new Send(TOOLS_NODE_NAME, { ...state, jumpTo: undefined });\n      }\n      return new Send(AGENT_NODE_NAME, { ...state, jumpTo: undefined });\n    };\n  }\n\n  /**\n   * Create routing function for jumpTo functionality after beforeModel hooks.\n   * Falls back to the default next node if no jumpTo is present.\n   * @param toolClasses - Available tool classes for validation\n   * @param nextDefault - Default node to route to\n   * @param hasToolsAvailable - Whether tools are available (includes dynamic tools via middleware)\n   */\n  #createBeforeModelRouter(\n    toolClasses: (ClientTool | ServerTool)[],\n    nextDefault: string,\n    hasToolsAvailable: boolean = toolClasses.length > 0\n  ) {\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as BuiltInState;\n      if (!builtInState.jumpTo) {\n        return nextDefault;\n      }\n      const destination = parseJumpToTarget(builtInState.jumpTo);\n      if (destination === END) {\n        return END;\n      }\n      if (destination === TOOLS_NODE_NAME) {\n        if (!hasToolsAvailable) {\n          return END;\n        }\n        return new Send(TOOLS_NODE_NAME, { ...state, jumpTo: undefined });\n      }\n      return new Send(AGENT_NODE_NAME, { ...state, jumpTo: undefined });\n    };\n  }\n\n  /**\n   * Initialize middleware states if not already present in the input state.\n   */\n  async #initializeMiddlewareStates(\n    state: InvokeStateParameter<Types>,\n    config: RunnableConfig\n  ): Promise<InvokeStateParameter<Types>> {\n    if (\n      !this.options.middleware ||\n      this.options.middleware.length === 0 ||\n      state instanceof Command ||\n      !state\n    ) {\n      return state;\n    }\n\n    const defaultStates = await initializeMiddlewareStates(\n      this.options.middleware,\n      state\n    );\n    const threadState = await this.#graph\n      .getState(config)\n      .catch(() => ({ values: {} }));\n    const updatedState = {\n      ...threadState.values,\n      ...state,\n    } as InvokeStateParameter<Types>;\n    if (!updatedState) {\n      return updatedState;\n    }\n\n    // Only add defaults for keys that don't exist in current state\n    for (const [key, value] of Object.entries(defaultStates)) {\n      if (!(key in updatedState)) {\n        updatedState[key as keyof typeof updatedState] = value;\n      }\n    }\n\n    return updatedState;\n  }\n\n  /**\n   * Executes the agent with the given state and returns the final state after all processing.\n   *\n   * This method runs the agent's entire workflow synchronously, including:\n   * - Processing the input messages through any configured middleware\n   * - Calling the language model to generate responses\n   * - Executing any tool calls made by the model\n   * - Running all middleware hooks (beforeModel, afterModel, etc.)\n   *\n   * @param state - The initial state for the agent execution. Can be:\n   *   - An object containing `messages` array and any middleware-specific state properties\n   *   - A Command object for more advanced control flow\n   *\n   * @param config - Optional runtime configuration including:\n   * @param config.context - The context for the agent execution.\n   * @param config.configurable - LangGraph configuration options like `thread_id`, `run_id`, etc.\n   * @param config.store - The store for the agent execution for persisting state, see more in {@link https://docs.langchain.com/oss/javascript/langgraph/memory#memory-storage | Memory storage}.\n   * @param config.signal - An optional {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | `AbortSignal`} for the agent execution.\n   * @param config.recursionLimit - The recursion limit for the agent execution.\n   *\n   * @returns A Promise that resolves to the final agent state after execution completes.\n   *          The returned state includes:\n   *          - a `messages` property containing an array with all messages (input, AI responses, tool calls/results)\n   *          - a `structuredResponse` property containing the structured response (if configured)\n   *          - all state values defined in the middleware\n   *\n   * @example\n   * ```typescript\n   * const agent = new ReactAgent({\n   *   llm: myModel,\n   *   tools: [calculator, webSearch],\n   *   responseFormat: z.object({\n   *     weather: z.string(),\n   *   }),\n   * });\n   *\n   * const result = await agent.invoke({\n   *   messages: [{ role: \"human\", content: \"What's the weather in Paris?\" }]\n   * });\n   *\n   * console.log(result.structuredResponse.weather); // outputs: \"It's sunny and 75°F.\"\n   * ```\n   */\n  async invoke(\n    state: InvokeStateParameter<Types>,\n    config?: InvokeConfiguration<\n      InferContextInput<\n        Types[\"Context\"] extends AnyAnnotationRoot | InteropZodObject\n          ? Types[\"Context\"]\n          : AnyAnnotationRoot\n      > &\n        InferMiddlewareContextInputs<Types[\"Middleware\"]>\n    >\n  ) {\n    type FullState = MergedAgentState<Types>;\n    const mergedConfig = mergeConfigs(this.#defaultConfig, config);\n    const initializedState = await this.#initializeMiddlewareStates(\n      state,\n      mergedConfig as RunnableConfig\n    );\n\n    return this.#graph.invoke(\n      initializedState,\n      mergedConfig as unknown as InferContextInput<\n        Types[\"Context\"] extends AnyAnnotationRoot | InteropZodObject\n          ? Types[\"Context\"]\n          : AnyAnnotationRoot\n      > &\n        InferMiddlewareContextInputs<Types[\"Middleware\"]>\n    ) as Promise<FullState>;\n  }\n\n  /**\n   * Executes the agent with streaming, returning an async iterable of state updates as they occur.\n   *\n   * This method runs the agent's workflow similar to `invoke`, but instead of waiting for\n   * completion, it streams high-level state updates in real-time. This allows you to:\n   * - Display intermediate results to users as they're generated\n   * - Monitor the agent's progress through each step\n   * - React to state changes as nodes complete\n   *\n   * For more granular event-level streaming (like individual LLM tokens), use `streamEvents` instead.\n   *\n   * @param state - The initial state for the agent execution. Can be:\n   *   - An object containing `messages` array and any middleware-specific state properties\n   *   - A Command object for more advanced control flow\n   *\n   * @param config - Optional runtime configuration including:\n   * @param config.context - The context for the agent execution.\n   * @param config.configurable - LangGraph configuration options like `thread_id`, `run_id`, etc.\n   * @param config.store - The store for the agent execution for persisting state, see more in {@link https://docs.langchain.com/oss/javascript/langgraph/memory#memory-storage | Memory storage}.\n   * @param config.signal - An optional {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | `AbortSignal`} for the agent execution.\n   * @param config.streamMode - The streaming mode for the agent execution, see more in {@link https://docs.langchain.com/oss/javascript/langgraph/streaming#supported-stream-modes | Supported stream modes}.\n   * @param config.recursionLimit - The recursion limit for the agent execution.\n   *\n   * @returns A Promise that resolves to an IterableReadableStream of state updates.\n   *          Each update contains the current state after a node completes.\n   *\n   * @example\n   * ```typescript\n   * const agent = new ReactAgent({\n   *   llm: myModel,\n   *   tools: [calculator, webSearch]\n   * });\n   *\n   * const stream = await agent.stream({\n   *   messages: [{ role: \"human\", content: \"What's 2+2 and the weather in NYC?\" }]\n   * });\n   *\n   * for await (const chunk of stream) {\n   *   console.log(chunk); // State update from each node\n   * }\n   * ```\n   */\n  async stream<\n    TStreamMode extends StreamMode | StreamMode[] | undefined,\n    TSubgraphs extends boolean,\n    TEncoding extends \"text/event-stream\" | undefined,\n  >(\n    state: InvokeStateParameter<Types>,\n    config?: StreamConfiguration<\n      InferContextInput<\n        Types[\"Context\"] extends AnyAnnotationRoot | InteropZodObject\n          ? Types[\"Context\"]\n          : AnyAnnotationRoot\n      > &\n        InferMiddlewareContextInputs<Types[\"Middleware\"]>,\n      TStreamMode,\n      TSubgraphs,\n      TEncoding\n    >\n  ) {\n    const mergedConfig = mergeConfigs(this.#defaultConfig, config);\n    const initializedState = await this.#initializeMiddlewareStates(\n      state,\n      mergedConfig as RunnableConfig\n    );\n    return this.#graph.stream(\n      initializedState,\n      mergedConfig as Record<string, any>\n    ) as Promise<\n      IterableReadableStream<\n        StreamOutputMap<\n          TStreamMode,\n          TSubgraphs,\n          MergedAgentState<Types>,\n          MergedAgentState<Types>,\n          string,\n          unknown,\n          unknown,\n          TEncoding\n        >\n      >\n    >;\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  /**\n   * The following are internal methods to enable support for LangGraph Platform.\n   * They are not part of the createAgent public API.\n   *\n   * Note: we intentionally return as `never` to avoid type errors due to type inference.\n   */\n\n  /**\n   * @internal\n   */\n  streamEvents(\n    state: InvokeStateParameter<Types>,\n    config?: StreamConfiguration<\n      InferContextInput<\n        Types[\"Context\"] extends AnyAnnotationRoot | InteropZodObject\n          ? Types[\"Context\"]\n          : AnyAnnotationRoot\n      > &\n        InferMiddlewareContextInputs<Types[\"Middleware\"]>,\n      StreamMode | StreamMode[] | undefined,\n      boolean,\n      \"text/event-stream\" | undefined\n    > & { version?: \"v1\" | \"v2\" },\n    streamOptions?: Parameters<Runnable[\"streamEvents\"]>[2]\n  ): IterableReadableStream<StreamEvent> {\n    const mergedConfig = mergeConfigs(this.#defaultConfig, config);\n    return this.#graph.streamEvents(\n      state,\n      {\n        ...(mergedConfig as Partial<\n          PregelOptions<\n            any,\n            any,\n            any,\n            StreamMode | StreamMode[] | undefined,\n            boolean,\n            \"text/event-stream\"\n          >\n        >),\n        version: config?.version ?? \"v2\",\n      },\n      streamOptions\n    );\n  }\n  /**\n   * @internal\n   */\n  getGraphAsync(config?: RunnableConfig) {\n    return this.#graph.getGraphAsync(config) as never;\n  }\n  /**\n   * @internal\n   */\n  getState(config: RunnableConfig, options?: GetStateOptions) {\n    return this.#graph.getState(config, options) as never;\n  }\n  /**\n   * @internal\n   */\n  getStateHistory(config: RunnableConfig, options?: CheckpointListOptions) {\n    return this.#graph.getStateHistory(config, options) as never;\n  }\n  /**\n   * @internal\n   */\n  getSubgraphs(namespace?: string, recurse?: boolean) {\n    return this.#graph.getSubgraphs(namespace, recurse) as never;\n  }\n  /**\n   * @internal\n   */\n  getSubgraphsAsync(namespace?: string, recurse?: boolean) {\n    return this.#graph.getSubgraphsAsync(namespace, recurse) as never;\n  }\n  /**\n   * @internal\n   */\n  updateState(\n    inputConfig: LangGraphRunnableConfig,\n    values: Record<string, unknown> | unknown,\n    asNode?: string\n  ) {\n    return this.#graph.updateState(inputConfig, values, asNode) as never;\n  }\n\n  /**\n   * @internal\n   */\n  get builder() {\n    return this.#graph.builder;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"ReactAgent.cjs","names":["#defaultConfig","#toolBehaviorVersion","isClientTool","createAgentState","StateGraph","#agentNode","AgentNode","normalizeSystemPrompt","BeforeAgentNode","getHookConstraint","BeforeModelNode","AfterModelNode","AfterAgentNode","AGENT_NODE_NAME","ToolNode","wrapToolCall","TOOLS_NODE_NAME","END","START","parseJumpToTarget","#createBeforeAgentRouter","#createBeforeModelRouter","#getModelPaths","#createModelRouter","#createAfterModelSequenceRouter","#createAfterModelRouter","#createToolsRouter","#graph","ToolMessage","AIMessage","Send","#initializeMiddlewareStates","Command","initializeMiddlewareStates"],"sources":["../../src/agents/ReactAgent.ts"],"sourcesContent":["/* oxlint-disable no-instanceof/no-instanceof */\n/* oxlint-disable @typescript-eslint/no-explicit-any */\nimport { InteropZodObject } from \"@langchain/core/utils/types\";\n\nimport {\n  StateGraph,\n  END,\n  START,\n  Send,\n  Command,\n  CompiledStateGraph,\n  type GetStateOptions,\n  type LangGraphRunnableConfig,\n  type StreamMode,\n  type StreamOutputMap,\n  type PregelOptions,\n} from \"@langchain/langgraph\";\nimport type {\n  BaseCheckpointSaver,\n  BaseStore,\n  CheckpointListOptions,\n} from \"@langchain/langgraph-checkpoint\";\nimport {\n  ToolMessage,\n  AIMessage,\n  MessageStructure,\n} from \"@langchain/core/messages\";\nimport { IterableReadableStream } from \"@langchain/core/utils/stream\";\nimport {\n  mergeConfigs,\n  type Runnable,\n  type RunnableConfig,\n} from \"@langchain/core/runnables\";\nimport type { StreamEvent } from \"@langchain/core/tracers/log_stream\";\nimport type { ClientTool, ServerTool } from \"@langchain/core/tools\";\nimport { createAgentState } from \"./annotation.js\";\nimport {\n  isClientTool,\n  validateLLMHasNoBoundTools,\n  wrapToolCall,\n  normalizeSystemPrompt,\n} from \"./utils.js\";\n\nimport { AgentNode, AGENT_NODE_NAME } from \"./nodes/AgentNode.js\";\nimport { ToolNode, TOOLS_NODE_NAME } from \"./nodes/ToolNode.js\";\nimport { BeforeAgentNode } from \"./nodes/BeforeAgentNode.js\";\nimport { BeforeModelNode } from \"./nodes/BeforeModelNode.js\";\nimport { AfterModelNode } from \"./nodes/AfterModelNode.js\";\nimport { AfterAgentNode } from \"./nodes/AfterAgentNode.js\";\nimport {\n  initializeMiddlewareStates,\n  parseJumpToTarget,\n} from \"./nodes/utils.js\";\n\nimport type {\n  WithStateGraphNodes,\n  AgentTypeConfig,\n  CreateAgentParams,\n  ToolsToMessageToolSet,\n} from \"./types.js\";\n\nimport type { BuiltInState, JumpTo, UserInput } from \"./types.js\";\nimport type { InvokeConfiguration, StreamConfiguration } from \"./runtime.js\";\nimport type {\n  AgentMiddleware,\n  InferMiddlewareContextInputs,\n  InferMiddlewareStates,\n  InferMiddlewareInputStates,\n  InferContextInput,\n  AnyAnnotationRoot,\n  InferSchemaValue,\n  ToAnnotationRoot,\n} from \"./middleware/types.js\";\nimport { type ResponseFormatUndefined } from \"./responses.js\";\nimport { getHookConstraint } from \"./middleware/utils.js\";\n\n/**\n * In the ReAct pattern we have three main nodes:\n * - model_request: The node that makes the model call.\n * - tools: The node that calls the tools.\n * - END: The end of the graph.\n *\n * These are the only nodes that can be jumped to from other nodes.\n */\ntype BaseGraphDestination =\n  | typeof TOOLS_NODE_NAME\n  | typeof AGENT_NODE_NAME\n  | typeof END;\n\n// Helper type to get the state definition with middleware states\ntype MergedAgentState<Types extends AgentTypeConfig> = InferSchemaValue<\n  Types[\"State\"]\n> &\n  (Types[\"Response\"] extends ResponseFormatUndefined\n    ? Omit<\n        BuiltInState<MessageStructure<ToolsToMessageToolSet<Types[\"Tools\"]>>>,\n        \"jumpTo\"\n      >\n    : Omit<\n        BuiltInState<MessageStructure<ToolsToMessageToolSet<Types[\"Tools\"]>>>,\n        \"jumpTo\"\n      > & {\n        structuredResponse: Types[\"Response\"];\n      }) &\n  InferMiddlewareStates<Types[\"Middleware\"]>;\n\ntype InvokeStateParameter<Types extends AgentTypeConfig> =\n  | (UserInput<Types[\"State\"]> &\n      InferMiddlewareInputStates<Types[\"Middleware\"]>)\n  | Command<any, any, any>\n  | null;\n\ntype AgentGraph<Types extends AgentTypeConfig> = CompiledStateGraph<\n  any,\n  any,\n  any,\n  any,\n  MergedAgentState<Types>,\n  ToAnnotationRoot<\n    Types[\"Context\"] extends AnyAnnotationRoot | InteropZodObject\n      ? Types[\"Context\"]\n      : AnyAnnotationRoot\n  >[\"spec\"],\n  unknown\n>;\n\n/**\n * ReactAgent is a production-ready ReAct (Reasoning + Acting) agent that combines\n * language models with tools and middleware.\n *\n * The agent is parameterized by a single type bag `Types` that encapsulates all\n * type information:\n *\n * @typeParam Types - An {@link AgentTypeConfig} that bundles:\n *   - `Response`: The structured response type\n *   - `State`: The custom state schema type\n *   - `Context`: The context schema type\n *   - `Middleware`: The middleware array type\n *   - `Tools`: The combined tools type from agent and middleware\n *\n * @example\n * ```typescript\n * // Using the type bag pattern\n * type MyTypes = AgentTypeConfig<\n *   { name: string },  // Response\n *   typeof myState,    // State\n *   typeof myContext,  // Context\n *   typeof middleware, // Middleware\n *   typeof tools       // Tools\n * >;\n *\n * const agent: ReactAgent<MyTypes> = createAgent({ ... });\n * ```\n */\nexport class ReactAgent<\n  Types extends AgentTypeConfig = AgentTypeConfig<\n    Record<string, any>,\n    undefined,\n    AnyAnnotationRoot,\n    readonly AgentMiddleware[],\n    readonly (ClientTool | ServerTool)[]\n  >,\n> {\n  /**\n   * Type marker for extracting the AgentTypeConfig from a ReactAgent instance.\n   * This is a phantom property used only for type inference.\n   * @internal\n   */\n  declare readonly \"~agentTypes\": Types;\n\n  #graph: AgentGraph<Types>;\n\n  #toolBehaviorVersion: \"v1\" | \"v2\" = \"v2\";\n\n  #agentNode: AgentNode<any, AnyAnnotationRoot>;\n\n  #defaultConfig: RunnableConfig;\n\n  constructor(\n    public options: CreateAgentParams<\n      Types[\"Response\"],\n      Types[\"State\"],\n      Types[\"Context\"]\n    >,\n    defaultConfig?: RunnableConfig\n  ) {\n    this.#defaultConfig = mergeConfigs(defaultConfig ?? {}, {\n      metadata: { ls_integration: \"langchain_create_agent\" },\n      configurable: { ls_agent_type: \"root\" },\n    });\n    if (options.name) {\n      this.#defaultConfig = mergeConfigs(this.#defaultConfig, {\n        metadata: { lc_agent_name: options.name },\n      });\n    }\n    this.#toolBehaviorVersion = options.version ?? this.#toolBehaviorVersion;\n\n    /**\n     * validate that model option is provided\n     */\n    if (!options.model) {\n      throw new Error(\"`model` option is required to create an agent.\");\n    }\n\n    /**\n     * Check if the LLM already has bound tools and throw if it does.\n     */\n    if (typeof options.model !== \"string\") {\n      validateLLMHasNoBoundTools(options.model);\n    }\n\n    /**\n     * define complete list of tools based on options and middleware\n     */\n    const middlewareTools = (this.options.middleware\n      ?.filter((m) => m.tools)\n      .flatMap((m) => m.tools) ?? []) as (ClientTool | ServerTool)[];\n    const toolClasses = [...(options.tools ?? []), ...middlewareTools];\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    /**\n     * Create a schema that merges agent base schema with middleware state schemas\n     * Using Zod with withLangGraph ensures LangGraph Studio gets proper metadata\n     */\n    const hasDynamicStructuredResponse = Boolean(\n      this.options.middleware?.some((middleware) => middleware.wrapModelCall)\n    );\n    const { state, input, output } = createAgentState<\n      Types[\"State\"],\n      Types[\"Middleware\"]\n    >(\n      this.options.responseFormat !== undefined || hasDynamicStructuredResponse,\n      this.options.stateSchema as Types[\"State\"],\n      this.options.middleware as Types[\"Middleware\"]\n    );\n\n    const workflow = new StateGraph(state, {\n      input,\n      output,\n      context: this.options.contextSchema,\n    });\n\n    const allNodeWorkflows = workflow as WithStateGraphNodes<\n      typeof TOOLS_NODE_NAME | typeof AGENT_NODE_NAME | string,\n      typeof workflow\n    >;\n\n    // Generate node names for middleware nodes that have hooks\n    const beforeAgentNodes: {\n      index: number;\n      name: string;\n      allowed?: string[];\n    }[] = [];\n    const beforeModelNodes: {\n      index: number;\n      name: string;\n      allowed?: string[];\n    }[] = [];\n    const afterModelNodes: {\n      index: number;\n      name: string;\n      allowed?: string[];\n    }[] = [];\n    const afterAgentNodes: {\n      index: number;\n      name: string;\n      allowed?: string[];\n    }[] = [];\n    const wrapModelCallHookMiddleware: AgentMiddleware[] = [];\n\n    this.#agentNode = new AgentNode({\n      model: this.options.model,\n      systemMessage: normalizeSystemPrompt(this.options.systemPrompt),\n      includeAgentName: this.options.includeAgentName,\n      name: this.options.name,\n      responseFormat: this.options.responseFormat,\n      middleware: this.options.middleware,\n      toolClasses,\n      shouldReturnDirect,\n      signal: this.options.signal,\n      wrapModelCallHookMiddleware,\n    });\n\n    const middlewareNames = new Set<string>();\n    const middleware = this.options.middleware ?? [];\n    for (let i = 0; i < middleware.length; i++) {\n      let beforeAgentNode: BeforeAgentNode | undefined;\n      let beforeModelNode: BeforeModelNode | undefined;\n      let afterModelNode: AfterModelNode | undefined;\n      let afterAgentNode: AfterAgentNode | undefined;\n      const m = middleware[i];\n      if (middlewareNames.has(m.name)) {\n        throw new Error(`Middleware ${m.name} is defined multiple times`);\n      }\n\n      middlewareNames.add(m.name);\n      if (m.beforeAgent) {\n        beforeAgentNode = new BeforeAgentNode(m);\n        const name = `${m.name}.before_agent`;\n        beforeAgentNodes.push({\n          index: i,\n          name,\n          allowed: getHookConstraint(m.beforeAgent),\n        });\n        allNodeWorkflows.addNode(\n          name,\n          beforeAgentNode,\n          beforeAgentNode.nodeOptions\n        );\n      }\n      if (m.beforeModel) {\n        beforeModelNode = new BeforeModelNode(m);\n        const name = `${m.name}.before_model`;\n        beforeModelNodes.push({\n          index: i,\n          name,\n          allowed: getHookConstraint(m.beforeModel),\n        });\n        allNodeWorkflows.addNode(\n          name,\n          beforeModelNode,\n          beforeModelNode.nodeOptions\n        );\n      }\n      if (m.afterModel) {\n        afterModelNode = new AfterModelNode(m);\n        const name = `${m.name}.after_model`;\n        afterModelNodes.push({\n          index: i,\n          name,\n          allowed: getHookConstraint(m.afterModel),\n        });\n        allNodeWorkflows.addNode(\n          name,\n          afterModelNode,\n          afterModelNode.nodeOptions\n        );\n      }\n      if (m.afterAgent) {\n        afterAgentNode = new AfterAgentNode(m);\n        const name = `${m.name}.after_agent`;\n        afterAgentNodes.push({\n          index: i,\n          name,\n          allowed: getHookConstraint(m.afterAgent),\n        });\n        allNodeWorkflows.addNode(\n          name,\n          afterAgentNode,\n          afterAgentNode.nodeOptions\n        );\n      }\n\n      if (m.wrapModelCall) {\n        wrapModelCallHookMiddleware.push(m);\n      }\n    }\n\n    /**\n     * Add Nodes\n     */\n    allNodeWorkflows.addNode(AGENT_NODE_NAME, this.#agentNode);\n\n    /**\n     * Check if any middleware has wrapToolCall defined.\n     * If so, we need to create a ToolNode even without pre-registered tools\n     * to allow middleware to handle dynamically registered tools.\n     */\n    const hasWrapToolCallMiddleware = middleware.some((m) => m.wrapToolCall);\n    const clientTools = toolClasses.filter(isClientTool);\n\n    /**\n     * Create ToolNode if we have client-side tools OR if middleware defines wrapToolCall\n     * (which may handle dynamically registered tools)\n     */\n    if (clientTools.length > 0 || hasWrapToolCallMiddleware) {\n      const toolNode = new ToolNode(clientTools, {\n        signal: this.options.signal,\n        wrapToolCall: wrapToolCall(middleware),\n      });\n      allNodeWorkflows.addNode(TOOLS_NODE_NAME, toolNode);\n    }\n\n    /**\n     * Add Edges\n     */\n    // Determine the entry node (runs once at start): before_agent -> before_model -> model_request\n    let entryNode: string;\n    if (beforeAgentNodes.length > 0) {\n      entryNode = beforeAgentNodes[0].name;\n    } else if (beforeModelNodes.length > 0) {\n      entryNode = beforeModelNodes[0].name;\n    } else {\n      entryNode = AGENT_NODE_NAME;\n    }\n\n    // Determine the loop entry node (beginning of agent loop, excludes before_agent)\n    // This is where tools will loop back to for the next iteration\n    const loopEntryNode =\n      beforeModelNodes.length > 0 ? beforeModelNodes[0].name : AGENT_NODE_NAME;\n\n    // Determine the exit node (runs once at end): after_agent or END\n    const exitNode =\n      afterAgentNodes.length > 0\n        ? afterAgentNodes[afterAgentNodes.length - 1].name\n        : END;\n\n    allNodeWorkflows.addEdge(START, entryNode);\n\n    /**\n     * Determine if we have tools available for routing.\n     * This includes both registered client tools AND dynamic tools via middleware.\n     */\n    const hasToolsAvailable =\n      clientTools.length > 0 || hasWrapToolCallMiddleware;\n\n    // Connect beforeAgent nodes (run once at start)\n    for (let i = 0; i < beforeAgentNodes.length; i++) {\n      const node = beforeAgentNodes[i];\n      const current = node.name;\n      const isLast = i === beforeAgentNodes.length - 1;\n      const nextDefault = isLast ? loopEntryNode : beforeAgentNodes[i + 1].name;\n\n      if (node.allowed && node.allowed.length > 0) {\n        const allowedMapped = node.allowed\n          .map((t) => parseJumpToTarget(t))\n          .filter((dest) => dest !== TOOLS_NODE_NAME || hasToolsAvailable);\n        // Replace END with exitNode (which could be an afterAgent node)\n        const destinations = Array.from(\n          new Set([\n            nextDefault,\n            ...allowedMapped.map((dest) => (dest === END ? exitNode : dest)),\n          ])\n        ) as BaseGraphDestination[];\n\n        allNodeWorkflows.addConditionalEdges(\n          current,\n          this.#createBeforeAgentRouter(\n            clientTools,\n            nextDefault,\n            exitNode,\n            hasToolsAvailable\n          ),\n          destinations\n        );\n      } else {\n        allNodeWorkflows.addEdge(current, nextDefault);\n      }\n    }\n\n    // Connect beforeModel nodes; add conditional routing ONLY if allowed jumps are specified\n    for (let i = 0; i < beforeModelNodes.length; i++) {\n      const node = beforeModelNodes[i];\n      const current = node.name;\n      const isLast = i === beforeModelNodes.length - 1;\n      const nextDefault = isLast\n        ? AGENT_NODE_NAME\n        : beforeModelNodes[i + 1].name;\n\n      if (node.allowed && node.allowed.length > 0) {\n        const allowedMapped = node.allowed\n          .map((t) => parseJumpToTarget(t))\n          .filter((dest) => dest !== TOOLS_NODE_NAME || hasToolsAvailable);\n        const destinations = Array.from(\n          new Set([nextDefault, ...allowedMapped])\n        ) as BaseGraphDestination[];\n\n        allNodeWorkflows.addConditionalEdges(\n          current,\n          this.#createBeforeModelRouter(\n            clientTools,\n            nextDefault,\n            hasToolsAvailable\n          ),\n          destinations\n        );\n      } else {\n        allNodeWorkflows.addEdge(current, nextDefault);\n      }\n    }\n\n    // Connect agent to last afterModel node (for reverse order execution)\n    const lastAfterModelNode = afterModelNodes.at(-1);\n    if (afterModelNodes.length > 0 && lastAfterModelNode) {\n      allNodeWorkflows.addEdge(AGENT_NODE_NAME, lastAfterModelNode.name);\n    } else {\n      // If no afterModel nodes, connect model_request directly to model paths\n      const modelPaths = this.#getModelPaths(\n        clientTools,\n        false,\n        hasToolsAvailable\n      );\n      // Replace END with exitNode in destinations, since exitNode might be an afterAgent node\n      const destinations = modelPaths.map((p) =>\n        p === END ? exitNode : p\n      ) as BaseGraphDestination[];\n      if (destinations.length === 1) {\n        allNodeWorkflows.addEdge(AGENT_NODE_NAME, destinations[0]);\n      } else {\n        allNodeWorkflows.addConditionalEdges(\n          AGENT_NODE_NAME,\n          this.#createModelRouter(exitNode),\n          destinations\n        );\n      }\n    }\n\n    // Connect afterModel nodes in reverse sequence; add conditional routing ONLY if allowed jumps are specified per node\n    for (let i = afterModelNodes.length - 1; i > 0; i--) {\n      const node = afterModelNodes[i];\n      const current = node.name;\n      const nextDefault = afterModelNodes[i - 1].name;\n\n      if (node.allowed && node.allowed.length > 0) {\n        const allowedMapped = node.allowed\n          .map((t) => parseJumpToTarget(t))\n          .filter((dest) => dest !== TOOLS_NODE_NAME || hasToolsAvailable);\n        const destinations = Array.from(\n          new Set([nextDefault, ...allowedMapped])\n        ) as BaseGraphDestination[];\n\n        allNodeWorkflows.addConditionalEdges(\n          current,\n          this.#createAfterModelSequenceRouter(\n            clientTools,\n            node.allowed,\n            nextDefault,\n            hasToolsAvailable\n          ),\n          destinations\n        );\n      } else {\n        allNodeWorkflows.addEdge(current, nextDefault);\n      }\n    }\n\n    // Connect first afterModel node (last to execute) to model paths with jumpTo support\n    if (afterModelNodes.length > 0) {\n      const firstAfterModel = afterModelNodes[0];\n      const firstAfterModelNode = firstAfterModel.name;\n\n      // Include exitNode in the paths since afterModel should be able to route to after_agent or END\n      const modelPaths = this.#getModelPaths(\n        clientTools,\n        true,\n        hasToolsAvailable\n      ).filter((p) => p !== TOOLS_NODE_NAME || hasToolsAvailable);\n\n      const allowJump = Boolean(\n        firstAfterModel.allowed && firstAfterModel.allowed.length > 0\n      );\n\n      // Replace END with exitNode in destinations, since exitNode might be an afterAgent node\n      const destinations = modelPaths.map((p) =>\n        p === END ? exitNode : p\n      ) as BaseGraphDestination[];\n\n      allNodeWorkflows.addConditionalEdges(\n        firstAfterModelNode,\n        this.#createAfterModelRouter(\n          clientTools,\n          allowJump,\n          exitNode,\n          hasToolsAvailable\n        ),\n        destinations\n      );\n    }\n\n    // Connect afterAgent nodes (run once at end, in reverse order like afterModel)\n    for (let i = afterAgentNodes.length - 1; i > 0; i--) {\n      const node = afterAgentNodes[i];\n      const current = node.name;\n      const nextDefault = afterAgentNodes[i - 1].name;\n\n      if (node.allowed && node.allowed.length > 0) {\n        const allowedMapped = node.allowed\n          .map((t) => parseJumpToTarget(t))\n          .filter((dest) => dest !== TOOLS_NODE_NAME || hasToolsAvailable);\n        const destinations = Array.from(\n          new Set([nextDefault, ...allowedMapped])\n        ) as BaseGraphDestination[];\n\n        allNodeWorkflows.addConditionalEdges(\n          current,\n          this.#createAfterModelSequenceRouter(\n            clientTools,\n            node.allowed,\n            nextDefault,\n            hasToolsAvailable\n          ),\n          destinations\n        );\n      } else {\n        allNodeWorkflows.addEdge(current, nextDefault);\n      }\n    }\n\n    // Connect the first afterAgent node (last to execute) to END\n    if (afterAgentNodes.length > 0) {\n      const firstAfterAgent = afterAgentNodes[0];\n      const firstAfterAgentNode = firstAfterAgent.name;\n\n      if (firstAfterAgent.allowed && firstAfterAgent.allowed.length > 0) {\n        const allowedMapped = firstAfterAgent.allowed\n          .map((t) => parseJumpToTarget(t))\n          .filter((dest) => dest !== TOOLS_NODE_NAME || hasToolsAvailable);\n\n        /**\n         * For after_agent, only use explicitly allowed destinations (don't add loopEntryNode)\n         * The default destination (when no jump occurs) should be END\n         */\n        const destinations = Array.from(\n          new Set([END, ...allowedMapped])\n        ) as BaseGraphDestination[];\n\n        allNodeWorkflows.addConditionalEdges(\n          firstAfterAgentNode,\n          this.#createAfterModelSequenceRouter(\n            clientTools,\n            firstAfterAgent.allowed,\n            END as string,\n            hasToolsAvailable\n          ),\n          destinations\n        );\n      } else {\n        allNodeWorkflows.addEdge(firstAfterAgentNode, END);\n      }\n    }\n\n    /**\n     * add edges for tools node (includes both registered tools and dynamic tools via middleware)\n     */\n    if (hasToolsAvailable) {\n      // Tools should return to loop entry node (not including before_agent)\n      const toolReturnTarget = loopEntryNode;\n\n      if (shouldReturnDirect.size > 0) {\n        allNodeWorkflows.addConditionalEdges(\n          TOOLS_NODE_NAME,\n          this.#createToolsRouter(\n            shouldReturnDirect,\n            exitNode,\n            toolReturnTarget\n          ),\n          [toolReturnTarget, exitNode as string]\n        );\n      } else {\n        allNodeWorkflows.addEdge(TOOLS_NODE_NAME, toolReturnTarget);\n      }\n    }\n\n    /**\n     * compile the graph\n     */\n    this.#graph = allNodeWorkflows.compile({\n      checkpointer: this.options.checkpointer,\n      store: this.options.store,\n      name: this.options.name,\n      description: this.options.description,\n    }) as unknown as AgentGraph<Types>;\n  }\n\n  /**\n   * Get the compiled {@link https://docs.langchain.com/oss/javascript/langgraph/use-graph-api | StateGraph}.\n   */\n  get graph(): AgentGraph<Types> {\n    return this.#graph;\n  }\n\n  get checkpointer(): BaseCheckpointSaver | boolean | undefined {\n    return this.#graph.checkpointer;\n  }\n\n  set checkpointer(value: BaseCheckpointSaver | boolean | undefined) {\n    this.#graph.checkpointer = value;\n  }\n\n  get store(): BaseStore | undefined {\n    return this.#graph.store;\n  }\n\n  set store(value: BaseStore | undefined) {\n    this.#graph.store = value;\n  }\n\n  /**\n   * Creates a new ReactAgent with the given config merged into the existing config.\n   * Follows the same pattern as LangGraph's Pregel.withConfig().\n   *\n   * The merged config is applied as a default that gets merged with any config\n   * passed at invocation time (invoke/stream). Invocation-time config takes precedence.\n   *\n   * @param config - Configuration to merge with existing config\n   * @returns A new ReactAgent instance with the merged configuration\n   *\n   * @example\n   * ```typescript\n   * const agent = createAgent({ model: \"gpt-4o\", tools: [...] });\n   *\n   * // Set a default recursion limit\n   * const configuredAgent = agent.withConfig({ recursionLimit: 1000 });\n   *\n   * // Chain multiple configs\n   * const debugAgent = agent\n   *   .withConfig({ recursionLimit: 1000 })\n   *   .withConfig({ tags: [\"debug\"] });\n   * ```\n   */\n  withConfig(\n    config: Omit<RunnableConfig, \"store\" | \"writer\" | \"interrupt\">\n  ): ReactAgent<Types> {\n    return new ReactAgent(\n      this.options,\n      mergeConfigs(this.#defaultConfig, config)\n    );\n  }\n\n  /**\n   * Get possible edge destinations from model node.\n   * @param toolClasses names of tools to call\n   * @param includeModelRequest whether to include \"model_request\" as a valid path (for jumpTo routing)\n   * @param hasToolsAvailable whether tools are available (includes dynamic tools via middleware)\n   * @returns list of possible edge destinations\n   */\n  #getModelPaths(\n    toolClasses: (ClientTool | ServerTool)[],\n    includeModelRequest: boolean = false,\n    hasToolsAvailable: boolean = toolClasses.length > 0\n  ): BaseGraphDestination[] {\n    const paths: BaseGraphDestination[] = [];\n    if (hasToolsAvailable) {\n      paths.push(TOOLS_NODE_NAME);\n    }\n\n    if (includeModelRequest) {\n      paths.push(AGENT_NODE_NAME);\n    }\n\n    paths.push(END);\n\n    return paths;\n  }\n\n  /**\n   * Create routing function for tools node conditional edges.\n   */\n  #createToolsRouter(\n    shouldReturnDirect: Set<string>,\n    exitNode: string | typeof END,\n    toolReturnTarget: string\n  ) {\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as BuiltInState;\n      const messages = builtInState.messages;\n      const lastMessage = messages[messages.length - 1];\n\n      // Check if we just executed a returnDirect tool\n      if (\n        ToolMessage.isInstance(lastMessage) &&\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 to exit node (could be after_agent or END)\n        return this.options.responseFormat ? toolReturnTarget : exitNode;\n      }\n\n      // For non-returnDirect tools, route back to loop entry node (could be middleware or agent)\n      return toolReturnTarget;\n    };\n  }\n\n  /**\n   * Create routing function for model node conditional edges.\n   * @param exitNode - The exit node to route to (could be after_agent or END)\n   */\n  #createModelRouter(exitNode: string | typeof END = END) {\n    /**\n     * determine if the agent should continue or not\n     */\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as BuiltInState;\n      const messages = builtInState.messages;\n      const lastMessage = messages.at(-1);\n\n      if (\n        !AIMessage.isInstance(lastMessage) ||\n        !lastMessage.tool_calls ||\n        lastMessage.tool_calls.length === 0\n      ) {\n        return exitNode;\n      }\n\n      // Check if all tool calls are for structured response extraction\n      const hasOnlyStructuredResponseCalls = lastMessage.tool_calls.every(\n        (toolCall) => toolCall.name.startsWith(\"extract-\")\n      );\n\n      if (hasOnlyStructuredResponseCalls) {\n        // If all tool calls are for structured response extraction, go to exit node\n        // The AgentNode will handle these internally and return the structured response\n        return exitNode;\n      }\n\n      /**\n       * The tool node processes a single message.\n       */\n      if (this.#toolBehaviorVersion === \"v1\") {\n        return TOOLS_NODE_NAME;\n      }\n\n      /**\n       * Route to tools node (filter out any structured response tool calls)\n       */\n      const regularToolCalls = lastMessage.tool_calls.filter(\n        (toolCall) => !toolCall.name.startsWith(\"extract-\")\n      );\n\n      if (regularToolCalls.length === 0) {\n        return exitNode;\n      }\n\n      return regularToolCalls.map(\n        (toolCall) =>\n          new Send(TOOLS_NODE_NAME, { ...state, lg_tool_call: toolCall })\n      );\n    };\n  }\n\n  /**\n   * Create routing function for jumpTo functionality after afterModel hooks.\n   *\n   * This router checks if the `jumpTo` property is set in the state after afterModel middleware\n   * execution. If set, it routes to the specified target (\"model_request\" or \"tools\").\n   * If not set, it falls back to the normal model routing logic for afterModel context.\n   *\n   * The jumpTo property is automatically cleared after use to prevent infinite loops.\n   *\n   * @param toolClasses - Available tool classes for validation\n   * @param allowJump - Whether jumping is allowed\n   * @param exitNode - The exit node to route to (could be after_agent or END)\n   * @param hasToolsAvailable - Whether tools are available (includes dynamic tools via middleware)\n   * @returns Router function that handles jumpTo logic and normal routing\n   */\n  #createAfterModelRouter(\n    toolClasses: (ClientTool | ServerTool)[],\n    allowJump: boolean,\n    exitNode: string | typeof END,\n    hasToolsAvailable: boolean = toolClasses.length > 0\n  ) {\n    const hasStructuredResponse = Boolean(this.options.responseFormat);\n\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as Omit<BuiltInState, \"jumpTo\"> & {\n        jumpTo?: JumpTo;\n      };\n      // First, check if we just processed a structured response\n      // If so, ignore any existing jumpTo and go to exitNode\n      const messages = builtInState.messages;\n      const lastMessage = messages.at(-1);\n      if (\n        AIMessage.isInstance(lastMessage) &&\n        (!lastMessage.tool_calls || lastMessage.tool_calls.length === 0)\n      ) {\n        return exitNode;\n      }\n\n      // Check if jumpTo is set in the state and allowed\n      if (allowJump && builtInState.jumpTo) {\n        const destination = parseJumpToTarget(builtInState.jumpTo);\n        if (destination === END) {\n          return exitNode;\n        }\n        if (destination === TOOLS_NODE_NAME) {\n          // If trying to jump to tools but no tools are available, go to exitNode\n          if (!hasToolsAvailable) {\n            return exitNode;\n          }\n          return new Send(TOOLS_NODE_NAME, { ...state, jumpTo: undefined });\n        }\n        // destination === \"model_request\"\n        return new Send(AGENT_NODE_NAME, { ...state, jumpTo: undefined });\n      }\n\n      // check if there are pending tool calls\n      const toolMessages = messages.filter(ToolMessage.isInstance);\n      const lastAiMessage = messages.filter(AIMessage.isInstance).at(-1);\n      const pendingToolCalls = lastAiMessage?.tool_calls?.filter(\n        (call) => !toolMessages.some((m) => m.tool_call_id === call.id)\n      );\n      if (pendingToolCalls && pendingToolCalls.length > 0) {\n        /**\n         * v1: route the full message to the ToolNode; it filters already-processed\n         * calls internally and runs the remaining ones via Promise.all.\n         * v2: dispatch each pending call as a separate Send task.\n         */\n        if (this.#toolBehaviorVersion === \"v1\") {\n          return TOOLS_NODE_NAME;\n        }\n        return pendingToolCalls.map(\n          (toolCall) =>\n            new Send(TOOLS_NODE_NAME, { ...state, lg_tool_call: toolCall })\n        );\n      }\n\n      // if we exhausted all tool calls, but still have no structured response tool calls,\n      // go back to model_request\n      const hasStructuredResponseCalls = lastAiMessage?.tool_calls?.some(\n        (toolCall) => toolCall.name.startsWith(\"extract-\")\n      );\n\n      if (\n        pendingToolCalls &&\n        pendingToolCalls.length === 0 &&\n        !hasStructuredResponseCalls &&\n        hasStructuredResponse\n      ) {\n        return AGENT_NODE_NAME;\n      }\n\n      if (\n        !AIMessage.isInstance(lastMessage) ||\n        !lastMessage.tool_calls ||\n        lastMessage.tool_calls.length === 0\n      ) {\n        return exitNode;\n      }\n\n      // Check if all tool calls are for structured response extraction\n      const hasOnlyStructuredResponseCalls = lastMessage.tool_calls.every(\n        (toolCall) => toolCall.name.startsWith(\"extract-\")\n      );\n\n      // Check if there are any regular tool calls (non-structured response)\n      const hasRegularToolCalls = lastMessage.tool_calls.some(\n        (toolCall) => !toolCall.name.startsWith(\"extract-\")\n      );\n\n      if (hasOnlyStructuredResponseCalls || !hasRegularToolCalls) {\n        return exitNode;\n      }\n\n      /**\n       * v1: route the full AIMessage to a single ToolNode invocation so all\n       * tool calls run concurrently via Promise.all.\n       *\n       * v2: dispatch each regular tool call as a separate Send task, matching\n       * the behaviour of #createModelRouter when no afterModel middleware is\n       * present.\n       */\n      if (this.#toolBehaviorVersion === \"v1\") {\n        return TOOLS_NODE_NAME;\n      }\n\n      const regularToolCalls = (lastMessage as AIMessage).tool_calls!.filter(\n        (toolCall) => !toolCall.name.startsWith(\"extract-\")\n      );\n\n      if (regularToolCalls.length === 0) {\n        return exitNode;\n      }\n\n      return regularToolCalls.map(\n        (toolCall) =>\n          new Send(TOOLS_NODE_NAME, { ...state, lg_tool_call: toolCall })\n      );\n    };\n  }\n\n  /**\n   * Router for afterModel sequence nodes (connecting later middlewares to earlier ones),\n   * honoring allowed jump targets and defaulting to the next node.\n   * @param toolClasses - Available tool classes for validation\n   * @param allowed - List of allowed jump targets\n   * @param nextDefault - Default node to route to\n   * @param hasToolsAvailable - Whether tools are available (includes dynamic tools via middleware)\n   */\n  #createAfterModelSequenceRouter(\n    toolClasses: (ClientTool | ServerTool)[],\n    allowed: string[],\n    nextDefault: string,\n    hasToolsAvailable: boolean = toolClasses.length > 0\n  ) {\n    const allowedSet = new Set(allowed.map((t) => parseJumpToTarget(t)));\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as BuiltInState;\n      if (builtInState.jumpTo) {\n        const dest = parseJumpToTarget(builtInState.jumpTo);\n        if (dest === END && allowedSet.has(END)) {\n          return END;\n        }\n        if (dest === TOOLS_NODE_NAME && allowedSet.has(TOOLS_NODE_NAME)) {\n          if (!hasToolsAvailable) return END;\n          return new Send(TOOLS_NODE_NAME, { ...state, jumpTo: undefined });\n        }\n        if (dest === AGENT_NODE_NAME && allowedSet.has(AGENT_NODE_NAME)) {\n          return new Send(AGENT_NODE_NAME, { ...state, jumpTo: undefined });\n        }\n      }\n      return nextDefault;\n    };\n  }\n\n  /**\n   * Create routing function for jumpTo functionality after beforeAgent hooks.\n   * Falls back to the default next node if no jumpTo is present.\n   * When jumping to END, routes to exitNode (which could be an afterAgent node).\n   * @param toolClasses - Available tool classes for validation\n   * @param nextDefault - Default node to route to\n   * @param exitNode - Exit node to route to (could be after_agent or END)\n   * @param hasToolsAvailable - Whether tools are available (includes dynamic tools via middleware)\n   */\n  #createBeforeAgentRouter(\n    toolClasses: (ClientTool | ServerTool)[],\n    nextDefault: string,\n    exitNode: string | typeof END,\n    hasToolsAvailable: boolean = toolClasses.length > 0\n  ) {\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as BuiltInState;\n      if (!builtInState.jumpTo) {\n        return nextDefault;\n      }\n      const destination = parseJumpToTarget(builtInState.jumpTo);\n      if (destination === END) {\n        /**\n         * When beforeAgent jumps to END, route to exitNode (first afterAgent node)\n         */\n        return exitNode;\n      }\n      if (destination === TOOLS_NODE_NAME) {\n        if (!hasToolsAvailable) {\n          return exitNode;\n        }\n        return new Send(TOOLS_NODE_NAME, { ...state, jumpTo: undefined });\n      }\n      return new Send(AGENT_NODE_NAME, { ...state, jumpTo: undefined });\n    };\n  }\n\n  /**\n   * Create routing function for jumpTo functionality after beforeModel hooks.\n   * Falls back to the default next node if no jumpTo is present.\n   * @param toolClasses - Available tool classes for validation\n   * @param nextDefault - Default node to route to\n   * @param hasToolsAvailable - Whether tools are available (includes dynamic tools via middleware)\n   */\n  #createBeforeModelRouter(\n    toolClasses: (ClientTool | ServerTool)[],\n    nextDefault: string,\n    hasToolsAvailable: boolean = toolClasses.length > 0\n  ) {\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as BuiltInState;\n      if (!builtInState.jumpTo) {\n        return nextDefault;\n      }\n      const destination = parseJumpToTarget(builtInState.jumpTo);\n      if (destination === END) {\n        return END;\n      }\n      if (destination === TOOLS_NODE_NAME) {\n        if (!hasToolsAvailable) {\n          return END;\n        }\n        return new Send(TOOLS_NODE_NAME, { ...state, jumpTo: undefined });\n      }\n      return new Send(AGENT_NODE_NAME, { ...state, jumpTo: undefined });\n    };\n  }\n\n  /**\n   * Initialize middleware states if not already present in the input state.\n   */\n  async #initializeMiddlewareStates(\n    state: InvokeStateParameter<Types>,\n    config: RunnableConfig\n  ): Promise<InvokeStateParameter<Types>> {\n    if (\n      !this.options.middleware ||\n      this.options.middleware.length === 0 ||\n      state instanceof Command ||\n      !state\n    ) {\n      return state;\n    }\n\n    const defaultStates = await initializeMiddlewareStates(\n      this.options.middleware,\n      state\n    );\n    const threadState = await this.#graph\n      .getState(config)\n      .catch(() => ({ values: {} }));\n    const updatedState = {\n      ...threadState.values,\n      ...state,\n    } as InvokeStateParameter<Types>;\n    if (!updatedState) {\n      return updatedState;\n    }\n\n    // Only add defaults for keys that don't exist in current state\n    for (const [key, value] of Object.entries(defaultStates)) {\n      if (!(key in updatedState)) {\n        updatedState[key as keyof typeof updatedState] = value;\n      }\n    }\n\n    return updatedState;\n  }\n\n  /**\n   * Executes the agent with the given state and returns the final state after all processing.\n   *\n   * This method runs the agent's entire workflow synchronously, including:\n   * - Processing the input messages through any configured middleware\n   * - Calling the language model to generate responses\n   * - Executing any tool calls made by the model\n   * - Running all middleware hooks (beforeModel, afterModel, etc.)\n   *\n   * @param state - The initial state for the agent execution. Can be:\n   *   - An object containing `messages` array and any middleware-specific state properties\n   *   - A Command object for more advanced control flow\n   *\n   * @param config - Optional runtime configuration including:\n   * @param config.context - The context for the agent execution.\n   * @param config.configurable - LangGraph configuration options like `thread_id`, `run_id`, etc.\n   * @param config.store - The store for the agent execution for persisting state, see more in {@link https://docs.langchain.com/oss/javascript/langgraph/memory#memory-storage | Memory storage}.\n   * @param config.signal - An optional {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | `AbortSignal`} for the agent execution.\n   * @param config.recursionLimit - The recursion limit for the agent execution.\n   *\n   * @returns A Promise that resolves to the final agent state after execution completes.\n   *          The returned state includes:\n   *          - a `messages` property containing an array with all messages (input, AI responses, tool calls/results)\n   *          - a `structuredResponse` property containing the structured response (if configured)\n   *          - all state values defined in the middleware\n   *\n   * @example\n   * ```typescript\n   * const agent = new ReactAgent({\n   *   llm: myModel,\n   *   tools: [calculator, webSearch],\n   *   responseFormat: z.object({\n   *     weather: z.string(),\n   *   }),\n   * });\n   *\n   * const result = await agent.invoke({\n   *   messages: [{ role: \"human\", content: \"What's the weather in Paris?\" }]\n   * });\n   *\n   * console.log(result.structuredResponse.weather); // outputs: \"It's sunny and 75°F.\"\n   * ```\n   */\n  async invoke(\n    state: InvokeStateParameter<Types>,\n    config?: InvokeConfiguration<\n      InferContextInput<\n        Types[\"Context\"] extends AnyAnnotationRoot | InteropZodObject\n          ? Types[\"Context\"]\n          : AnyAnnotationRoot\n      > &\n        InferMiddlewareContextInputs<Types[\"Middleware\"]>\n    >\n  ) {\n    type FullState = MergedAgentState<Types>;\n    const mergedConfig = mergeConfigs(this.#defaultConfig, config);\n    const initializedState = await this.#initializeMiddlewareStates(\n      state,\n      mergedConfig as RunnableConfig\n    );\n\n    return this.#graph.invoke(\n      initializedState,\n      mergedConfig as unknown as InferContextInput<\n        Types[\"Context\"] extends AnyAnnotationRoot | InteropZodObject\n          ? Types[\"Context\"]\n          : AnyAnnotationRoot\n      > &\n        InferMiddlewareContextInputs<Types[\"Middleware\"]>\n    ) as Promise<FullState>;\n  }\n\n  /**\n   * Executes the agent with streaming, returning an async iterable of state updates as they occur.\n   *\n   * This method runs the agent's workflow similar to `invoke`, but instead of waiting for\n   * completion, it streams high-level state updates in real-time. This allows you to:\n   * - Display intermediate results to users as they're generated\n   * - Monitor the agent's progress through each step\n   * - React to state changes as nodes complete\n   *\n   * For more granular event-level streaming (like individual LLM tokens), use `streamEvents` instead.\n   *\n   * @param state - The initial state for the agent execution. Can be:\n   *   - An object containing `messages` array and any middleware-specific state properties\n   *   - A Command object for more advanced control flow\n   *\n   * @param config - Optional runtime configuration including:\n   * @param config.context - The context for the agent execution.\n   * @param config.configurable - LangGraph configuration options like `thread_id`, `run_id`, etc.\n   * @param config.store - The store for the agent execution for persisting state, see more in {@link https://docs.langchain.com/oss/javascript/langgraph/memory#memory-storage | Memory storage}.\n   * @param config.signal - An optional {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | `AbortSignal`} for the agent execution.\n   * @param config.streamMode - The streaming mode for the agent execution, see more in {@link https://docs.langchain.com/oss/javascript/langgraph/streaming#supported-stream-modes | Supported stream modes}.\n   * @param config.recursionLimit - The recursion limit for the agent execution.\n   *\n   * @returns A Promise that resolves to an IterableReadableStream of state updates.\n   *          Each update contains the current state after a node completes.\n   *\n   * @example\n   * ```typescript\n   * const agent = new ReactAgent({\n   *   llm: myModel,\n   *   tools: [calculator, webSearch]\n   * });\n   *\n   * const stream = await agent.stream({\n   *   messages: [{ role: \"human\", content: \"What's 2+2 and the weather in NYC?\" }]\n   * });\n   *\n   * for await (const chunk of stream) {\n   *   console.log(chunk); // State update from each node\n   * }\n   * ```\n   */\n  async stream<\n    TStreamMode extends StreamMode | StreamMode[] | undefined,\n    TSubgraphs extends boolean,\n    TEncoding extends \"text/event-stream\" | undefined,\n  >(\n    state: InvokeStateParameter<Types>,\n    config?: StreamConfiguration<\n      InferContextInput<\n        Types[\"Context\"] extends AnyAnnotationRoot | InteropZodObject\n          ? Types[\"Context\"]\n          : AnyAnnotationRoot\n      > &\n        InferMiddlewareContextInputs<Types[\"Middleware\"]>,\n      TStreamMode,\n      TSubgraphs,\n      TEncoding\n    >\n  ) {\n    const mergedConfig = mergeConfigs(this.#defaultConfig, config);\n    const initializedState = await this.#initializeMiddlewareStates(\n      state,\n      mergedConfig as RunnableConfig\n    );\n    return this.#graph.stream(\n      initializedState,\n      mergedConfig as Record<string, any>\n    ) as Promise<\n      IterableReadableStream<\n        StreamOutputMap<\n          TStreamMode,\n          TSubgraphs,\n          MergedAgentState<Types>,\n          MergedAgentState<Types>,\n          string,\n          unknown,\n          unknown,\n          TEncoding\n        >\n      >\n    >;\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  /**\n   * The following are internal methods to enable support for LangGraph Platform.\n   * They are not part of the createAgent public API.\n   *\n   * Note: we intentionally return as `never` to avoid type errors due to type inference.\n   */\n\n  /**\n   * @internal\n   */\n  streamEvents(\n    state: InvokeStateParameter<Types>,\n    config?: StreamConfiguration<\n      InferContextInput<\n        Types[\"Context\"] extends AnyAnnotationRoot | InteropZodObject\n          ? Types[\"Context\"]\n          : AnyAnnotationRoot\n      > &\n        InferMiddlewareContextInputs<Types[\"Middleware\"]>,\n      StreamMode | StreamMode[] | undefined,\n      boolean,\n      \"text/event-stream\" | undefined\n    > & { version?: \"v1\" | \"v2\" },\n    streamOptions?: Parameters<Runnable[\"streamEvents\"]>[2]\n  ): IterableReadableStream<StreamEvent> {\n    const mergedConfig = mergeConfigs(this.#defaultConfig, config);\n    return this.#graph.streamEvents(\n      state,\n      {\n        ...(mergedConfig as Partial<\n          PregelOptions<\n            any,\n            any,\n            any,\n            StreamMode | StreamMode[] | undefined,\n            boolean,\n            \"text/event-stream\"\n          >\n        >),\n        version: config?.version ?? \"v2\",\n      },\n      streamOptions\n    );\n  }\n  /**\n   * @internal\n   */\n  getGraphAsync(config?: RunnableConfig) {\n    return this.#graph.getGraphAsync(config) as never;\n  }\n  /**\n   * @internal\n   */\n  getState(config: RunnableConfig, options?: GetStateOptions) {\n    return this.#graph.getState(config, options) as never;\n  }\n  /**\n   * @internal\n   */\n  getStateHistory(config: RunnableConfig, options?: CheckpointListOptions) {\n    return this.#graph.getStateHistory(config, options) as never;\n  }\n  /**\n   * @internal\n   */\n  getSubgraphs(namespace?: string, recurse?: boolean) {\n    return this.#graph.getSubgraphs(namespace, recurse) as never;\n  }\n  /**\n   * @internal\n   */\n  getSubgraphsAsync(namespace?: string, recurse?: boolean) {\n    return this.#graph.getSubgraphsAsync(namespace, recurse) as never;\n  }\n  /**\n   * @internal\n   */\n  updateState(\n    inputConfig: LangGraphRunnableConfig,\n    values: Record<string, unknown> | unknown,\n    asNode?: string\n  ) {\n    return this.#graph.updateState(inputConfig, values, asNode) as never;\n  }\n\n  /**\n   * @internal\n   */\n  get builder() {\n    return this.#graph.builder;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0JA,IAAa,aAAb,MAAa,WAQX;CAQA;CAEA,uBAAoC;CAEpC;CAEA;CAEA,YACE,SAKA,eACA;AANO,OAAA,UAAA;AAOP,QAAA,iBAAKA,GAAAA,0BAAAA,cAA8B,iBAAiB,EAAE,EAAE;GACtD,UAAU,EAAE,gBAAgB,0BAA0B;GACtD,cAAc,EAAE,eAAe,QAAQ;GACxC,CAAC;AACF,MAAI,QAAQ,KACV,OAAA,iBAAKA,GAAAA,0BAAAA,cAA8B,MAAA,eAAqB,EACtD,UAAU,EAAE,eAAe,QAAQ,MAAM,EAC1C,CAAC;AAEJ,QAAA,sBAA4B,QAAQ,WAAW,MAAA;;;;AAK/C,MAAI,CAAC,QAAQ,MACX,OAAM,IAAI,MAAM,iDAAiD;;;;AAMnE,MAAI,OAAO,QAAQ,UAAU,SAC3B,eAAA,2BAA2B,QAAQ,MAAM;;;;EAM3C,MAAM,kBAAmB,KAAK,QAAQ,YAClC,QAAQ,MAAM,EAAE,MAAM,CACvB,SAAS,MAAM,EAAE,MAAM,IAAI,EAAE;EAChC,MAAM,cAAc,CAAC,GAAI,QAAQ,SAAS,EAAE,EAAG,GAAG,gBAAgB;;;;;EAMlE,MAAM,qBAAqB,IAAI,IAC7B,YACG,OAAOE,cAAAA,aAAa,CACpB,QAAQ,SAAS,kBAAkB,QAAQ,KAAK,aAAa,CAC7D,KAAK,SAAS,KAAK,KAAK,CAC5B;;;;;EAMD,MAAM,+BAA+B,QACnC,KAAK,QAAQ,YAAY,MAAM,eAAe,WAAW,cAAc,CACxE;EACD,MAAM,EAAE,OAAO,OAAO,WAAWC,mBAAAA,iBAI/B,KAAK,QAAQ,mBAAmB,KAAA,KAAa,8BAC7C,KAAK,QAAQ,aACb,KAAK,QAAQ,WACd;EAQD,MAAM,mBANW,IAAIC,qBAAAA,WAAW,OAAO;GACrC;GACA;GACA,SAAS,KAAK,QAAQ;GACvB,CAAC;EAQF,MAAM,mBAIA,EAAE;EACR,MAAM,mBAIA,EAAE;EACR,MAAM,kBAIA,EAAE;EACR,MAAM,kBAIA,EAAE;EACR,MAAM,8BAAiD,EAAE;AAEzD,QAAA,YAAkB,IAAIE,kBAAAA,UAAU;GAC9B,OAAO,KAAK,QAAQ;GACpB,eAAeC,cAAAA,sBAAsB,KAAK,QAAQ,aAAa;GAC/D,kBAAkB,KAAK,QAAQ;GAC/B,MAAM,KAAK,QAAQ;GACnB,gBAAgB,KAAK,QAAQ;GAC7B,YAAY,KAAK,QAAQ;GACzB;GACA;GACA,QAAQ,KAAK,QAAQ;GACrB;GACD,CAAC;EAEF,MAAM,kCAAkB,IAAI,KAAa;EACzC,MAAM,aAAa,KAAK,QAAQ,cAAc,EAAE;AAChD,OAAK,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,KAAK;GAC1C,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,MAAM,IAAI,WAAW;AACrB,OAAI,gBAAgB,IAAI,EAAE,KAAK,CAC7B,OAAM,IAAI,MAAM,cAAc,EAAE,KAAK,4BAA4B;AAGnE,mBAAgB,IAAI,EAAE,KAAK;AAC3B,OAAI,EAAE,aAAa;AACjB,sBAAkB,IAAIC,wBAAAA,gBAAgB,EAAE;IACxC,MAAM,OAAO,GAAG,EAAE,KAAK;AACvB,qBAAiB,KAAK;KACpB,OAAO;KACP;KACA,SAASC,gBAAAA,kBAAkB,EAAE,YAAY;KAC1C,CAAC;AACF,qBAAiB,QACf,MACA,iBACA,gBAAgB,YACjB;;AAEH,OAAI,EAAE,aAAa;AACjB,sBAAkB,IAAIC,wBAAAA,gBAAgB,EAAE;IACxC,MAAM,OAAO,GAAG,EAAE,KAAK;AACvB,qBAAiB,KAAK;KACpB,OAAO;KACP;KACA,SAASD,gBAAAA,kBAAkB,EAAE,YAAY;KAC1C,CAAC;AACF,qBAAiB,QACf,MACA,iBACA,gBAAgB,YACjB;;AAEH,OAAI,EAAE,YAAY;AAChB,qBAAiB,IAAIE,uBAAAA,eAAe,EAAE;IACtC,MAAM,OAAO,GAAG,EAAE,KAAK;AACvB,oBAAgB,KAAK;KACnB,OAAO;KACP;KACA,SAASF,gBAAAA,kBAAkB,EAAE,WAAW;KACzC,CAAC;AACF,qBAAiB,QACf,MACA,gBACA,eAAe,YAChB;;AAEH,OAAI,EAAE,YAAY;AAChB,qBAAiB,IAAIG,uBAAAA,eAAe,EAAE;IACtC,MAAM,OAAO,GAAG,EAAE,KAAK;AACvB,oBAAgB,KAAK;KACnB,OAAO;KACP;KACA,SAASH,gBAAAA,kBAAkB,EAAE,WAAW;KACzC,CAAC;AACF,qBAAiB,QACf,MACA,gBACA,eAAe,YAChB;;AAGH,OAAI,EAAE,cACJ,6BAA4B,KAAK,EAAE;;;;;AAOvC,mBAAiB,QAAQI,kBAAAA,iBAAiB,MAAA,UAAgB;;;;;;EAO1D,MAAM,4BAA4B,WAAW,MAAM,MAAM,EAAE,aAAa;EACxE,MAAM,cAAc,YAAY,OAAOX,cAAAA,aAAa;;;;;AAMpD,MAAI,YAAY,SAAS,KAAK,2BAA2B;GACvD,MAAM,WAAW,IAAIY,iBAAAA,SAAS,aAAa;IACzC,QAAQ,KAAK,QAAQ;IACrB,cAAcC,cAAAA,aAAa,WAAW;IACvC,CAAC;AACF,oBAAiB,QAAQC,iBAAAA,iBAAiB,SAAS;;;;;EAOrD,IAAI;AACJ,MAAI,iBAAiB,SAAS,EAC5B,aAAY,iBAAiB,GAAG;WACvB,iBAAiB,SAAS,EACnC,aAAY,iBAAiB,GAAG;MAEhC,aAAYH,kBAAAA;EAKd,MAAM,gBACJ,iBAAiB,SAAS,IAAI,iBAAiB,GAAG,OAAOA,kBAAAA;EAG3D,MAAM,WACJ,gBAAgB,SAAS,IACrB,gBAAgB,gBAAgB,SAAS,GAAG,OAC5CI,qBAAAA;AAEN,mBAAiB,QAAQC,qBAAAA,OAAO,UAAU;;;;;EAM1C,MAAM,oBACJ,YAAY,SAAS,KAAK;AAG5B,OAAK,IAAI,IAAI,GAAG,IAAI,iBAAiB,QAAQ,KAAK;GAChD,MAAM,OAAO,iBAAiB;GAC9B,MAAM,UAAU,KAAK;GAErB,MAAM,cADS,MAAM,iBAAiB,SAAS,IAClB,gBAAgB,iBAAiB,IAAI,GAAG;AAErE,OAAI,KAAK,WAAW,KAAK,QAAQ,SAAS,GAAG;IAC3C,MAAM,gBAAgB,KAAK,QACxB,KAAK,MAAMC,gBAAAA,kBAAkB,EAAE,CAAC,CAChC,QAAQ,SAAS,SAAA,WAA4B,kBAAkB;IAElE,MAAM,eAAe,MAAM,KACzB,IAAI,IAAI,CACN,aACA,GAAG,cAAc,KAAK,SAAU,SAASF,qBAAAA,MAAM,WAAW,KAAM,CACjE,CAAC,CACH;AAED,qBAAiB,oBACf,SACA,MAAA,wBACE,aACA,aACA,UACA,kBACD,EACD,aACD;SAED,kBAAiB,QAAQ,SAAS,YAAY;;AAKlD,OAAK,IAAI,IAAI,GAAG,IAAI,iBAAiB,QAAQ,KAAK;GAChD,MAAM,OAAO,iBAAiB;GAC9B,MAAM,UAAU,KAAK;GAErB,MAAM,cADS,MAAM,iBAAiB,SAAS,IAE3CJ,kBAAAA,kBACA,iBAAiB,IAAI,GAAG;AAE5B,OAAI,KAAK,WAAW,KAAK,QAAQ,SAAS,GAAG;IAC3C,MAAM,gBAAgB,KAAK,QACxB,KAAK,MAAMM,gBAAAA,kBAAkB,EAAE,CAAC,CAChC,QAAQ,SAAS,SAAA,WAA4B,kBAAkB;IAClE,MAAM,eAAe,MAAM,KACzB,IAAI,IAAI,CAAC,aAAa,GAAG,cAAc,CAAC,CACzC;AAED,qBAAiB,oBACf,SACA,MAAA,wBACE,aACA,aACA,kBACD,EACD,aACD;SAED,kBAAiB,QAAQ,SAAS,YAAY;;EAKlD,MAAM,qBAAqB,gBAAgB,GAAG,GAAG;AACjD,MAAI,gBAAgB,SAAS,KAAK,mBAChC,kBAAiB,QAAQN,kBAAAA,iBAAiB,mBAAmB,KAAK;OAC7D;GAQL,MAAM,eANa,MAAA,cACjB,aACA,OACA,kBACD,CAE+B,KAAK,MACnC,MAAMI,qBAAAA,MAAM,WAAW,EACxB;AACD,OAAI,aAAa,WAAW,EAC1B,kBAAiB,QAAQJ,kBAAAA,iBAAiB,aAAa,GAAG;OAE1D,kBAAiB,oBACfA,kBAAAA,iBACA,MAAA,kBAAwB,SAAS,EACjC,aACD;;AAKL,OAAK,IAAI,IAAI,gBAAgB,SAAS,GAAG,IAAI,GAAG,KAAK;GACnD,MAAM,OAAO,gBAAgB;GAC7B,MAAM,UAAU,KAAK;GACrB,MAAM,cAAc,gBAAgB,IAAI,GAAG;AAE3C,OAAI,KAAK,WAAW,KAAK,QAAQ,SAAS,GAAG;IAC3C,MAAM,gBAAgB,KAAK,QACxB,KAAK,MAAMM,gBAAAA,kBAAkB,EAAE,CAAC,CAChC,QAAQ,SAAS,SAAA,WAA4B,kBAAkB;IAClE,MAAM,eAAe,MAAM,KACzB,IAAI,IAAI,CAAC,aAAa,GAAG,cAAc,CAAC,CACzC;AAED,qBAAiB,oBACf,SACA,MAAA,+BACE,aACA,KAAK,SACL,aACA,kBACD,EACD,aACD;SAED,kBAAiB,QAAQ,SAAS,YAAY;;AAKlD,MAAI,gBAAgB,SAAS,GAAG;GAC9B,MAAM,kBAAkB,gBAAgB;GACxC,MAAM,sBAAsB,gBAAgB;GAG5C,MAAM,aAAa,MAAA,cACjB,aACA,MACA,kBACD,CAAC,QAAQ,MAAM,MAAA,WAAyB,kBAAkB;GAE3D,MAAM,YAAY,QAChB,gBAAgB,WAAW,gBAAgB,QAAQ,SAAS,EAC7D;GAGD,MAAM,eAAe,WAAW,KAAK,MACnC,MAAMF,qBAAAA,MAAM,WAAW,EACxB;AAED,oBAAiB,oBACf,qBACA,MAAA,uBACE,aACA,WACA,UACA,kBACD,EACD,aACD;;AAIH,OAAK,IAAI,IAAI,gBAAgB,SAAS,GAAG,IAAI,GAAG,KAAK;GACnD,MAAM,OAAO,gBAAgB;GAC7B,MAAM,UAAU,KAAK;GACrB,MAAM,cAAc,gBAAgB,IAAI,GAAG;AAE3C,OAAI,KAAK,WAAW,KAAK,QAAQ,SAAS,GAAG;IAC3C,MAAM,gBAAgB,KAAK,QACxB,KAAK,MAAME,gBAAAA,kBAAkB,EAAE,CAAC,CAChC,QAAQ,SAAS,SAAA,WAA4B,kBAAkB;IAClE,MAAM,eAAe,MAAM,KACzB,IAAI,IAAI,CAAC,aAAa,GAAG,cAAc,CAAC,CACzC;AAED,qBAAiB,oBACf,SACA,MAAA,+BACE,aACA,KAAK,SACL,aACA,kBACD,EACD,aACD;SAED,kBAAiB,QAAQ,SAAS,YAAY;;AAKlD,MAAI,gBAAgB,SAAS,GAAG;GAC9B,MAAM,kBAAkB,gBAAgB;GACxC,MAAM,sBAAsB,gBAAgB;AAE5C,OAAI,gBAAgB,WAAW,gBAAgB,QAAQ,SAAS,GAAG;IACjE,MAAM,gBAAgB,gBAAgB,QACnC,KAAK,MAAMA,gBAAAA,kBAAkB,EAAE,CAAC,CAChC,QAAQ,SAAS,SAAA,WAA4B,kBAAkB;;;;;IAMlE,MAAM,eAAe,MAAM,KACzB,IAAI,IAAI,CAACF,qBAAAA,KAAK,GAAG,cAAc,CAAC,CACjC;AAED,qBAAiB,oBACf,qBACA,MAAA,+BACE,aACA,gBAAgB,SAChBA,qBAAAA,KACA,kBACD,EACD,aACD;SAED,kBAAiB,QAAQ,qBAAqBA,qBAAAA,IAAI;;;;;AAOtD,MAAI,mBAAmB;GAErB,MAAM,mBAAmB;AAEzB,OAAI,mBAAmB,OAAO,EAC5B,kBAAiB,oBACfD,iBAAAA,iBACA,MAAA,kBACE,oBACA,UACA,iBACD,EACD,CAAC,kBAAkB,SAAmB,CACvC;OAED,kBAAiB,QAAQA,iBAAAA,iBAAiB,iBAAiB;;;;;AAO/D,QAAA,QAAc,iBAAiB,QAAQ;GACrC,cAAc,KAAK,QAAQ;GAC3B,OAAO,KAAK,QAAQ;GACpB,MAAM,KAAK,QAAQ;GACnB,aAAa,KAAK,QAAQ;GAC3B,CAAC;;;;;CAMJ,IAAI,QAA2B;AAC7B,SAAO,MAAA;;CAGT,IAAI,eAA0D;AAC5D,SAAO,MAAA,MAAY;;CAGrB,IAAI,aAAa,OAAkD;AACjE,QAAA,MAAY,eAAe;;CAG7B,IAAI,QAA+B;AACjC,SAAO,MAAA,MAAY;;CAGrB,IAAI,MAAM,OAA8B;AACtC,QAAA,MAAY,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;CA0BtB,WACE,QACmB;AACnB,SAAO,IAAI,WACT,KAAK,UAAA,GAAA,0BAAA,cACQ,MAAA,eAAqB,OAAO,CAC1C;;;;;;;;;CAUH,eACE,aACA,sBAA+B,OAC/B,oBAA6B,YAAY,SAAS,GAC1B;EACxB,MAAM,QAAgC,EAAE;AACxC,MAAI,kBACF,OAAM,KAAKA,iBAAAA,gBAAgB;AAG7B,MAAI,oBACF,OAAM,KAAKH,kBAAAA,gBAAgB;AAG7B,QAAM,KAAKI,qBAAAA,IAAI;AAEf,SAAO;;;;;CAMT,mBACE,oBACA,UACA,kBACA;AACA,UAAQ,UAAmC;GAEzC,MAAM,WADe,MACS;GAC9B,MAAM,cAAc,SAAS,SAAS,SAAS;AAG/C,OACEW,yBAAAA,YAAY,WAAW,YAAY,IACnC,YAAY,QACZ,mBAAmB,IAAI,YAAY,KAAK,CAIxC,QAAO,KAAK,QAAQ,iBAAiB,mBAAmB;AAI1D,UAAO;;;;;;;CAQX,mBAAmB,WAAgCX,qBAAAA,KAAK;;;;AAItD,UAAQ,UAAmC;GAGzC,MAAM,cAFe,MACS,SACD,GAAG,GAAG;AAEnC,OACE,CAACY,yBAAAA,UAAU,WAAW,YAAY,IAClC,CAAC,YAAY,cACb,YAAY,WAAW,WAAW,EAElC,QAAO;AAQT,OAJuC,YAAY,WAAW,OAC3D,aAAa,SAAS,KAAK,WAAW,WAAW,CACnD,CAKC,QAAO;;;;AAMT,OAAI,MAAA,wBAA8B,KAChC,QAAOb,iBAAAA;;;;GAMT,MAAM,mBAAmB,YAAY,WAAW,QAC7C,aAAa,CAAC,SAAS,KAAK,WAAW,WAAW,CACpD;AAED,OAAI,iBAAiB,WAAW,EAC9B,QAAO;AAGT,UAAO,iBAAiB,KACrB,aACC,IAAIc,qBAAAA,KAAKd,iBAAAA,iBAAiB;IAAE,GAAG;IAAO,cAAc;IAAU,CAAC,CAClE;;;;;;;;;;;;;;;;;;CAmBL,wBACE,aACA,WACA,UACA,oBAA6B,YAAY,SAAS,GAClD;EACA,MAAM,wBAAwB,QAAQ,KAAK,QAAQ,eAAe;AAElE,UAAQ,UAAmC;GACzC,MAAM,eAAe;GAKrB,MAAM,WAAW,aAAa;GAC9B,MAAM,cAAc,SAAS,GAAG,GAAG;AACnC,OACEa,yBAAAA,UAAU,WAAW,YAAY,KAChC,CAAC,YAAY,cAAc,YAAY,WAAW,WAAW,GAE9D,QAAO;AAIT,OAAI,aAAa,aAAa,QAAQ;IACpC,MAAM,cAAcV,gBAAAA,kBAAkB,aAAa,OAAO;AAC1D,QAAI,gBAAgBF,qBAAAA,IAClB,QAAO;AAET,QAAI,gBAAA,SAAiC;AAEnC,SAAI,CAAC,kBACH,QAAO;AAET,YAAO,IAAIa,qBAAAA,KAAKd,iBAAAA,iBAAiB;MAAE,GAAG;MAAO,QAAQ,KAAA;MAAW,CAAC;;AAGnE,WAAO,IAAIc,qBAAAA,KAAKjB,kBAAAA,iBAAiB;KAAE,GAAG;KAAO,QAAQ,KAAA;KAAW,CAAC;;GAInE,MAAM,eAAe,SAAS,OAAOe,yBAAAA,YAAY,WAAW;GAC5D,MAAM,gBAAgB,SAAS,OAAOC,yBAAAA,UAAU,WAAW,CAAC,GAAG,GAAG;GAClE,MAAM,mBAAmB,eAAe,YAAY,QACjD,SAAS,CAAC,aAAa,MAAM,MAAM,EAAE,iBAAiB,KAAK,GAAG,CAChE;AACD,OAAI,oBAAoB,iBAAiB,SAAS,GAAG;;;;;;AAMnD,QAAI,MAAA,wBAA8B,KAChC,QAAOb,iBAAAA;AAET,WAAO,iBAAiB,KACrB,aACC,IAAIc,qBAAAA,KAAKd,iBAAAA,iBAAiB;KAAE,GAAG;KAAO,cAAc;KAAU,CAAC,CAClE;;GAKH,MAAM,6BAA6B,eAAe,YAAY,MAC3D,aAAa,SAAS,KAAK,WAAW,WAAW,CACnD;AAED,OACE,oBACA,iBAAiB,WAAW,KAC5B,CAAC,8BACD,sBAEA,QAAOH,kBAAAA;AAGT,OACE,CAACgB,yBAAAA,UAAU,WAAW,YAAY,IAClC,CAAC,YAAY,cACb,YAAY,WAAW,WAAW,EAElC,QAAO;GAIT,MAAM,iCAAiC,YAAY,WAAW,OAC3D,aAAa,SAAS,KAAK,WAAW,WAAW,CACnD;GAGD,MAAM,sBAAsB,YAAY,WAAW,MAChD,aAAa,CAAC,SAAS,KAAK,WAAW,WAAW,CACpD;AAED,OAAI,kCAAkC,CAAC,oBACrC,QAAO;;;;;;;;;AAWT,OAAI,MAAA,wBAA8B,KAChC,QAAOb,iBAAAA;GAGT,MAAM,mBAAoB,YAA0B,WAAY,QAC7D,aAAa,CAAC,SAAS,KAAK,WAAW,WAAW,CACpD;AAED,OAAI,iBAAiB,WAAW,EAC9B,QAAO;AAGT,UAAO,iBAAiB,KACrB,aACC,IAAIc,qBAAAA,KAAKd,iBAAAA,iBAAiB;IAAE,GAAG;IAAO,cAAc;IAAU,CAAC,CAClE;;;;;;;;;;;CAYL,gCACE,aACA,SACA,aACA,oBAA6B,YAAY,SAAS,GAClD;EACA,MAAM,aAAa,IAAI,IAAI,QAAQ,KAAK,MAAMG,gBAAAA,kBAAkB,EAAE,CAAC,CAAC;AACpE,UAAQ,UAAmC;GACzC,MAAM,eAAe;AACrB,OAAI,aAAa,QAAQ;IACvB,MAAM,OAAOA,gBAAAA,kBAAkB,aAAa,OAAO;AACnD,QAAI,SAASF,qBAAAA,OAAO,WAAW,IAAIA,qBAAAA,IAAI,CACrC,QAAOA,qBAAAA;AAET,QAAI,SAAA,WAA4B,WAAW,IAAA,QAAoB,EAAE;AAC/D,SAAI,CAAC,kBAAmB,QAAOA,qBAAAA;AAC/B,YAAO,IAAIa,qBAAAA,KAAKd,iBAAAA,iBAAiB;MAAE,GAAG;MAAO,QAAQ,KAAA;MAAW,CAAC;;AAEnE,QAAI,SAAA,mBAA4B,WAAW,IAAA,gBAAoB,CAC7D,QAAO,IAAIc,qBAAAA,KAAKjB,kBAAAA,iBAAiB;KAAE,GAAG;KAAO,QAAQ,KAAA;KAAW,CAAC;;AAGrE,UAAO;;;;;;;;;;;;CAaX,yBACE,aACA,aACA,UACA,oBAA6B,YAAY,SAAS,GAClD;AACA,UAAQ,UAAmC;GACzC,MAAM,eAAe;AACrB,OAAI,CAAC,aAAa,OAChB,QAAO;GAET,MAAM,cAAcM,gBAAAA,kBAAkB,aAAa,OAAO;AAC1D,OAAI,gBAAgBF,qBAAAA;;;;AAIlB,UAAO;AAET,OAAI,gBAAA,SAAiC;AACnC,QAAI,CAAC,kBACH,QAAO;AAET,WAAO,IAAIa,qBAAAA,KAAKd,iBAAAA,iBAAiB;KAAE,GAAG;KAAO,QAAQ,KAAA;KAAW,CAAC;;AAEnE,UAAO,IAAIc,qBAAAA,KAAKjB,kBAAAA,iBAAiB;IAAE,GAAG;IAAO,QAAQ,KAAA;IAAW,CAAC;;;;;;;;;;CAWrE,yBACE,aACA,aACA,oBAA6B,YAAY,SAAS,GAClD;AACA,UAAQ,UAAmC;GACzC,MAAM,eAAe;AACrB,OAAI,CAAC,aAAa,OAChB,QAAO;GAET,MAAM,cAAcM,gBAAAA,kBAAkB,aAAa,OAAO;AAC1D,OAAI,gBAAgBF,qBAAAA,IAClB,QAAOA,qBAAAA;AAET,OAAI,gBAAA,SAAiC;AACnC,QAAI,CAAC,kBACH,QAAOA,qBAAAA;AAET,WAAO,IAAIa,qBAAAA,KAAKd,iBAAAA,iBAAiB;KAAE,GAAG;KAAO,QAAQ,KAAA;KAAW,CAAC;;AAEnE,UAAO,IAAIc,qBAAAA,KAAKjB,kBAAAA,iBAAiB;IAAE,GAAG;IAAO,QAAQ,KAAA;IAAW,CAAC;;;;;;CAOrE,OAAA,2BACE,OACA,QACsC;AACtC,MACE,CAAC,KAAK,QAAQ,cACd,KAAK,QAAQ,WAAW,WAAW,KACnC,iBAAiBmB,qBAAAA,WACjB,CAAC,MAED,QAAO;EAGT,MAAM,gBAAgB,MAAMC,gBAAAA,2BAC1B,KAAK,QAAQ,YACb,MACD;EAID,MAAM,eAAe;GACnB,IAJkB,MAAM,MAAA,MACvB,SAAS,OAAO,CAChB,aAAa,EAAE,QAAQ,EAAE,EAAE,EAAE,EAEf;GACf,GAAG;GACJ;AACD,MAAI,CAAC,aACH,QAAO;AAIT,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,cAAc,CACtD,KAAI,EAAE,OAAO,cACX,cAAa,OAAoC;AAIrD,SAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CT,MAAM,OACJ,OACA,QAQA;EAEA,MAAM,gBAAA,GAAA,0BAAA,cAA4B,MAAA,eAAqB,OAAO;EAC9D,MAAM,mBAAmB,MAAM,MAAA,2BAC7B,OACA,aACD;AAED,SAAO,MAAA,MAAY,OACjB,kBACA,aAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6CH,MAAM,OAKJ,OACA,QAWA;EACA,MAAM,gBAAA,GAAA,0BAAA,cAA4B,MAAA,eAAqB,OAAO;EAC9D,MAAM,mBAAmB,MAAM,MAAA,2BAC7B,OACA,aACD;AACD,SAAO,MAAA,MAAY,OACjB,kBACA,aACD;;;;;;;;;;;;CA0BH,MAAM,eAAe,QAMlB;EAGD,MAAM,cAAc,OADN,OADS,MAAM,MAAA,MAAY,eAAe,EACrB,eAAe,OAAO,EACzB,aAAa;AAE7C,SADe,IAAI,WAAW,YAAY;;;;;;;;;;;;CAc5C,MAAM,YAAY,QAMf;AAED,UADuB,MAAM,MAAA,MAAY,eAAe,EAClC,YAAY,OAAO;;;;;;;;;;;CAa3C,aACE,OACA,QAWA,eACqC;EACrC,MAAM,gBAAA,GAAA,0BAAA,cAA4B,MAAA,eAAqB,OAAO;AAC9D,SAAO,MAAA,MAAY,aACjB,OACA;GACE,GAAI;GAUJ,SAAS,QAAQ,WAAW;GAC7B,EACD,cACD;;;;;CAKH,cAAc,QAAyB;AACrC,SAAO,MAAA,MAAY,cAAc,OAAO;;;;;CAK1C,SAAS,QAAwB,SAA2B;AAC1D,SAAO,MAAA,MAAY,SAAS,QAAQ,QAAQ;;;;;CAK9C,gBAAgB,QAAwB,SAAiC;AACvE,SAAO,MAAA,MAAY,gBAAgB,QAAQ,QAAQ;;;;;CAKrD,aAAa,WAAoB,SAAmB;AAClD,SAAO,MAAA,MAAY,aAAa,WAAW,QAAQ;;;;;CAKrD,kBAAkB,WAAoB,SAAmB;AACvD,SAAO,MAAA,MAAY,kBAAkB,WAAW,QAAQ;;;;;CAK1D,YACE,aACA,QACA,QACA;AACA,SAAO,MAAA,MAAY,YAAY,aAAa,QAAQ,OAAO;;;;;CAM7D,IAAI,UAAU;AACZ,SAAO,MAAA,MAAY"}

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

@@ -1 +1 @@
-{"version":3,"file":"ReactAgent.d.cts","names":[],"sources":["../../src/agents/ReactAgent.ts"],"mappings":"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"}
+{"version":3,"file":"ReactAgent.d.cts","names":[],"sources":["../../src/agents/ReactAgent.ts"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"ReactAgent.d.ts","names":[],"sources":["../../src/agents/ReactAgent.ts"],"mappings":"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"}
+{"version":3,"file":"ReactAgent.d.ts","names":[],"sources":["../../src/agents/ReactAgent.ts"],"mappings":";;;;;;;;;;;;;;KA0FK,gBAAA,eAA+B,eAAA,IAAmB,gBAAA,CACrD,KAAA,cAEC,KAAA,qBAA0B,uBAAA,GACvB,IAAA,CACE,YAAA,CAAa,gBAAA,CAAiB,qBAAA,CAAsB,KAAA,0BAGtD,IAAA,CACE,YAAA,CAAa,gBAAA,CAAiB,qBAAA,CAAsB,KAAA;EAGpD,kBAAA,EAAoB,KAAA;AAAA,KAE1B,qBAAA,CAAsB,KAAA;AAAA,KAEnB,oBAAA,eAAmC,eAAA,KACnC,SAAA,CAAU,KAAA,aACT,0BAAA,CAA2B,KAAA,mBAC7B,OAAA;AAAA,KAGC,UAAA,eAAyB,eAAA,IAAmB,kBAAA,qBAK/C,gBAAA,CAAiB,KAAA,GACjB,gBAAA,CACE,KAAA,oBAAyB,iBAAA,GAAoB,gBAAA,GACzC,KAAA,cACA,iBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAiCK,UAAA,eACG,eAAA,GAAkB,eAAA,CAC9B,MAAA,0BAEA,iBAAA,WACS,eAAA,cACC,UAAA,GAAa,UAAA;EAAA;EAmBhB,OAAA,EAAS,iBAAA,CACd,KAAA,cACA,KAAA,WACA,KAAA;EAnFE;;;;;EAAA,wBAqE0B,KAAA;EAUhC,WAAA,CACS,OAAA,EAAS,iBAAA,CACd,KAAA,cACA,KAAA,WACA,KAAA,cAEF,aAAA,GAAgB,cAAA;EAhFI;;;EAAA,IA6jBlB,KAAA,CAAA,GAAS,UAAA,CAAW,KAAA;EAAA,IAIpB,YAAA,CAAA,GAAgB,mBAAA;EAAA,IAIhB,YAAA,CAAa,KAAA,EAAO,mBAAA;EAAA,IAIpB,KAAA,CAAA,GAAS,SAAA;EAAA,IAIT,KAAA,CAAM,KAAA,EAAO,SAAA;EA1kBd;;;;;;;;;;;;;;;AAEM;;;;;;;;EAmmBT,UAAA,CACE,MAAA,EAAQ,IAAA,CAAK,cAAA,sCACZ,UAAA,CAAW,KAAA;EA1lBR;;;;;;;;;;;;;;;;;;;AAkCR;;;;;;;;;;;;;;;;;;;;;;;;EAq/BQ,MAAA,CACJ,KAAA,EAAO,oBAAA,CAAqB,KAAA,GAC5B,MAAA,GAAS,mBAAA,CACP,iBAAA,CACE,KAAA,oBAAyB,iBAAA,GAAoB,gBAAA,GACzC,KAAA,cACA,iBAAA,IAEJ,4BAAA,CAA6B,KAAA,mBAChC,OAAA,CAAA,gBAAA,CAAA,KAAA;EAnec;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiiBX,MAAA,qBACgB,UAAA,GAAa,UAAA,8FAAA,CAIjC,KAAA,EAAO,oBAAA,CAAqB,KAAA,GAC5B,MAAA,GAAS,mBAAA,CACP,iBAAA,CACE,KAAA,oBAAyB,iBAAA,GAAoB,gBAAA,GACzC,KAAA,cACA,iBAAA,IAEJ,4BAAA,CAA6B,KAAA,iBAC/B,WAAA,EACA,UAAA,EACA,SAAA,IACD,OAAA,CAAA,sBAAA,CAAA,eAAA,CAAA,WAAA,EAAA,UAAA,EAAA,gBAAA,CAAA,KAAA,GAAA,gBAAA,CAAA,KAAA,6BAAA,SAAA;EAAA;;;;;;;;;;EAoCG,cAAA,CAAe,MAAA;IACnB,UAAA;IACA,UAAA;IACA,UAAA,GAAa,MAAA;IACb,eAAA;IACA,eAAA;EAAA,IACD,OAAA,CAAA,UAAA,CAAA,WAAA;EA+CK;;;;;;;;;;EA7BA,WAAA,CAAY,MAAA;IAChB,UAAA;IACA,UAAA;IACA,UAAA,GAAa,MAAA;IACb,eAAA;IACA,eAAA;EAAA,IACD,OAAA;EA6FU;;;;;;EAAA;;;EA9EX,YAAA,CACE,KAAA,EAAO,oBAAA,CAAqB,KAAA,GAC5B,MAAA,GAAS,mBAAA,CACP,iBAAA,CACE,KAAA,oBAAyB,iBAAA,GAAoB,gBAAA,GACzC,KAAA,cACA,iBAAA,IAEJ,4BAAA,CAA6B,KAAA,iBAC/B,UAAA,GAAa,UAAA;IAGT,OAAA;EAAA,GACN,aAAA,GAAgB,UAAA,CAAW,QAAA,uBAC1B,sBAAA,CAAuB,WAAA;EAzqCxB;;;EAgsCF,aAAA,CAAc,MAAA,GAAS,cAAA;EA5rCE;;;EAksCzB,QAAA,CAAS,MAAA,EAAQ,cAAA,EAAgB,OAAA,GAAU,eAAA;EA9qCvC;;;EAorCJ,eAAA,CAAgB,MAAA,EAAQ,cAAA,EAAgB,OAAA,GAAU,qBAAA;EAtrClD;;;EA4rCA,YAAA,CAAa,SAAA,WAAoB,OAAA;EAxrC7B;;;EA8rCJ,iBAAA,CAAkB,SAAA,WAAoB,OAAA;EA/sBlC;;;EAqtBJ,WAAA,CACE,WAAA,EAAa,uBAAA,EACb,MAAA,EAAQ,MAAA,6BACR,MAAA;EAptBkB;;;EAAA,IA4tBhB,OAAA,CAAA,GAAO,UAAA,8BAAA,gBAAA,CAAA,KAAA,GAAA,gBAAA,CAAA,KAAA,oBAAA,iBAAA,GAAA,gBAAA,GAAA,KAAA,cAAA,iBAAA;AAAA"}

package/dist/agents/ReactAgent.js

@@ -47,7 +47,10 @@ var ReactAgent = class ReactAgent {
 	#defaultConfig;
 	constructor(options, defaultConfig) {
 		this.options = options;
-		this.#defaultConfig = mergeConfigs(defaultConfig ?? {}, { metadata: { ls_integration: "langchain_create_agent" } });
+		this.#defaultConfig = mergeConfigs(defaultConfig ?? {}, {
+			metadata: { ls_integration: "langchain_create_agent" },
+			configurable: { ls_agent_type: "root" }
+		});
 		if (options.name) this.#defaultConfig = mergeConfigs(this.#defaultConfig, { metadata: { lc_agent_name: options.name } });
 		this.#toolBehaviorVersion = options.version ?? this.#toolBehaviorVersion;
 		/**

package/dist/agents/ReactAgent.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReactAgent.js","names":["#defaultConfig","#toolBehaviorVersion","#agentNode","#createBeforeAgentRouter","#createBeforeModelRouter","#getModelPaths","#createModelRouter","#createAfterModelSequenceRouter","#createAfterModelRouter","#createToolsRouter","#graph","#initializeMiddlewareStates"],"sources":["../../src/agents/ReactAgent.ts"],"sourcesContent":["/* oxlint-disable no-instanceof/no-instanceof */\n/* oxlint-disable @typescript-eslint/no-explicit-any */\nimport { InteropZodObject } from \"@langchain/core/utils/types\";\n\nimport {\n  StateGraph,\n  END,\n  START,\n  Send,\n  Command,\n  CompiledStateGraph,\n  type GetStateOptions,\n  type LangGraphRunnableConfig,\n  type StreamMode,\n  type StreamOutputMap,\n  type PregelOptions,\n} from \"@langchain/langgraph\";\nimport type {\n  BaseCheckpointSaver,\n  BaseStore,\n  CheckpointListOptions,\n} from \"@langchain/langgraph-checkpoint\";\nimport {\n  ToolMessage,\n  AIMessage,\n  MessageStructure,\n} from \"@langchain/core/messages\";\nimport { IterableReadableStream } from \"@langchain/core/utils/stream\";\nimport {\n  mergeConfigs,\n  type Runnable,\n  type RunnableConfig,\n} from \"@langchain/core/runnables\";\nimport type { StreamEvent } from \"@langchain/core/tracers/log_stream\";\nimport type { ClientTool, ServerTool } from \"@langchain/core/tools\";\nimport { createAgentState } from \"./annotation.js\";\nimport {\n  isClientTool,\n  validateLLMHasNoBoundTools,\n  wrapToolCall,\n  normalizeSystemPrompt,\n} from \"./utils.js\";\n\nimport { AgentNode, AGENT_NODE_NAME } from \"./nodes/AgentNode.js\";\nimport { ToolNode, TOOLS_NODE_NAME } from \"./nodes/ToolNode.js\";\nimport { BeforeAgentNode } from \"./nodes/BeforeAgentNode.js\";\nimport { BeforeModelNode } from \"./nodes/BeforeModelNode.js\";\nimport { AfterModelNode } from \"./nodes/AfterModelNode.js\";\nimport { AfterAgentNode } from \"./nodes/AfterAgentNode.js\";\nimport {\n  initializeMiddlewareStates,\n  parseJumpToTarget,\n} from \"./nodes/utils.js\";\n\nimport type {\n  WithStateGraphNodes,\n  AgentTypeConfig,\n  CreateAgentParams,\n  ToolsToMessageToolSet,\n} from \"./types.js\";\n\nimport type { BuiltInState, JumpTo, UserInput } from \"./types.js\";\nimport type { InvokeConfiguration, StreamConfiguration } from \"./runtime.js\";\nimport type {\n  AgentMiddleware,\n  InferMiddlewareContextInputs,\n  InferMiddlewareStates,\n  InferMiddlewareInputStates,\n  InferContextInput,\n  AnyAnnotationRoot,\n  InferSchemaValue,\n  ToAnnotationRoot,\n} from \"./middleware/types.js\";\nimport { type ResponseFormatUndefined } from \"./responses.js\";\nimport { getHookConstraint } from \"./middleware/utils.js\";\n\n/**\n * In the ReAct pattern we have three main nodes:\n * - model_request: The node that makes the model call.\n * - tools: The node that calls the tools.\n * - END: The end of the graph.\n *\n * These are the only nodes that can be jumped to from other nodes.\n */\ntype BaseGraphDestination =\n  | typeof TOOLS_NODE_NAME\n  | typeof AGENT_NODE_NAME\n  | typeof END;\n\n// Helper type to get the state definition with middleware states\ntype MergedAgentState<Types extends AgentTypeConfig> = InferSchemaValue<\n  Types[\"State\"]\n> &\n  (Types[\"Response\"] extends ResponseFormatUndefined\n    ? Omit<\n        BuiltInState<MessageStructure<ToolsToMessageToolSet<Types[\"Tools\"]>>>,\n        \"jumpTo\"\n      >\n    : Omit<\n        BuiltInState<MessageStructure<ToolsToMessageToolSet<Types[\"Tools\"]>>>,\n        \"jumpTo\"\n      > & {\n        structuredResponse: Types[\"Response\"];\n      }) &\n  InferMiddlewareStates<Types[\"Middleware\"]>;\n\ntype InvokeStateParameter<Types extends AgentTypeConfig> =\n  | (UserInput<Types[\"State\"]> &\n      InferMiddlewareInputStates<Types[\"Middleware\"]>)\n  | Command<any, any, any>\n  | null;\n\ntype AgentGraph<Types extends AgentTypeConfig> = CompiledStateGraph<\n  any,\n  any,\n  any,\n  any,\n  MergedAgentState<Types>,\n  ToAnnotationRoot<\n    Types[\"Context\"] extends AnyAnnotationRoot | InteropZodObject\n      ? Types[\"Context\"]\n      : AnyAnnotationRoot\n  >[\"spec\"],\n  unknown\n>;\n\n/**\n * ReactAgent is a production-ready ReAct (Reasoning + Acting) agent that combines\n * language models with tools and middleware.\n *\n * The agent is parameterized by a single type bag `Types` that encapsulates all\n * type information:\n *\n * @typeParam Types - An {@link AgentTypeConfig} that bundles:\n *   - `Response`: The structured response type\n *   - `State`: The custom state schema type\n *   - `Context`: The context schema type\n *   - `Middleware`: The middleware array type\n *   - `Tools`: The combined tools type from agent and middleware\n *\n * @example\n * ```typescript\n * // Using the type bag pattern\n * type MyTypes = AgentTypeConfig<\n *   { name: string },  // Response\n *   typeof myState,    // State\n *   typeof myContext,  // Context\n *   typeof middleware, // Middleware\n *   typeof tools       // Tools\n * >;\n *\n * const agent: ReactAgent<MyTypes> = createAgent({ ... });\n * ```\n */\nexport class ReactAgent<\n  Types extends AgentTypeConfig = AgentTypeConfig<\n    Record<string, any>,\n    undefined,\n    AnyAnnotationRoot,\n    readonly AgentMiddleware[],\n    readonly (ClientTool | ServerTool)[]\n  >,\n> {\n  /**\n   * Type marker for extracting the AgentTypeConfig from a ReactAgent instance.\n   * This is a phantom property used only for type inference.\n   * @internal\n   */\n  declare readonly \"~agentTypes\": Types;\n\n  #graph: AgentGraph<Types>;\n\n  #toolBehaviorVersion: \"v1\" | \"v2\" = \"v2\";\n\n  #agentNode: AgentNode<any, AnyAnnotationRoot>;\n\n  #defaultConfig: RunnableConfig;\n\n  constructor(\n    public options: CreateAgentParams<\n      Types[\"Response\"],\n      Types[\"State\"],\n      Types[\"Context\"]\n    >,\n    defaultConfig?: RunnableConfig\n  ) {\n    this.#defaultConfig = mergeConfigs(defaultConfig ?? {}, {\n      metadata: { ls_integration: \"langchain_create_agent\" },\n    });\n    if (options.name) {\n      this.#defaultConfig = mergeConfigs(this.#defaultConfig, {\n        metadata: { lc_agent_name: options.name },\n      });\n    }\n    this.#toolBehaviorVersion = options.version ?? this.#toolBehaviorVersion;\n\n    /**\n     * validate that model option is provided\n     */\n    if (!options.model) {\n      throw new Error(\"`model` option is required to create an agent.\");\n    }\n\n    /**\n     * Check if the LLM already has bound tools and throw if it does.\n     */\n    if (typeof options.model !== \"string\") {\n      validateLLMHasNoBoundTools(options.model);\n    }\n\n    /**\n     * define complete list of tools based on options and middleware\n     */\n    const middlewareTools = (this.options.middleware\n      ?.filter((m) => m.tools)\n      .flatMap((m) => m.tools) ?? []) as (ClientTool | ServerTool)[];\n    const toolClasses = [...(options.tools ?? []), ...middlewareTools];\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    /**\n     * Create a schema that merges agent base schema with middleware state schemas\n     * Using Zod with withLangGraph ensures LangGraph Studio gets proper metadata\n     */\n    const hasDynamicStructuredResponse = Boolean(\n      this.options.middleware?.some((middleware) => middleware.wrapModelCall)\n    );\n    const { state, input, output } = createAgentState<\n      Types[\"State\"],\n      Types[\"Middleware\"]\n    >(\n      this.options.responseFormat !== undefined || hasDynamicStructuredResponse,\n      this.options.stateSchema as Types[\"State\"],\n      this.options.middleware as Types[\"Middleware\"]\n    );\n\n    const workflow = new StateGraph(state, {\n      input,\n      output,\n      context: this.options.contextSchema,\n    });\n\n    const allNodeWorkflows = workflow as WithStateGraphNodes<\n      typeof TOOLS_NODE_NAME | typeof AGENT_NODE_NAME | string,\n      typeof workflow\n    >;\n\n    // Generate node names for middleware nodes that have hooks\n    const beforeAgentNodes: {\n      index: number;\n      name: string;\n      allowed?: string[];\n    }[] = [];\n    const beforeModelNodes: {\n      index: number;\n      name: string;\n      allowed?: string[];\n    }[] = [];\n    const afterModelNodes: {\n      index: number;\n      name: string;\n      allowed?: string[];\n    }[] = [];\n    const afterAgentNodes: {\n      index: number;\n      name: string;\n      allowed?: string[];\n    }[] = [];\n    const wrapModelCallHookMiddleware: AgentMiddleware[] = [];\n\n    this.#agentNode = new AgentNode({\n      model: this.options.model,\n      systemMessage: normalizeSystemPrompt(this.options.systemPrompt),\n      includeAgentName: this.options.includeAgentName,\n      name: this.options.name,\n      responseFormat: this.options.responseFormat,\n      middleware: this.options.middleware,\n      toolClasses,\n      shouldReturnDirect,\n      signal: this.options.signal,\n      wrapModelCallHookMiddleware,\n    });\n\n    const middlewareNames = new Set<string>();\n    const middleware = this.options.middleware ?? [];\n    for (let i = 0; i < middleware.length; i++) {\n      let beforeAgentNode: BeforeAgentNode | undefined;\n      let beforeModelNode: BeforeModelNode | undefined;\n      let afterModelNode: AfterModelNode | undefined;\n      let afterAgentNode: AfterAgentNode | undefined;\n      const m = middleware[i];\n      if (middlewareNames.has(m.name)) {\n        throw new Error(`Middleware ${m.name} is defined multiple times`);\n      }\n\n      middlewareNames.add(m.name);\n      if (m.beforeAgent) {\n        beforeAgentNode = new BeforeAgentNode(m);\n        const name = `${m.name}.before_agent`;\n        beforeAgentNodes.push({\n          index: i,\n          name,\n          allowed: getHookConstraint(m.beforeAgent),\n        });\n        allNodeWorkflows.addNode(\n          name,\n          beforeAgentNode,\n          beforeAgentNode.nodeOptions\n        );\n      }\n      if (m.beforeModel) {\n        beforeModelNode = new BeforeModelNode(m);\n        const name = `${m.name}.before_model`;\n        beforeModelNodes.push({\n          index: i,\n          name,\n          allowed: getHookConstraint(m.beforeModel),\n        });\n        allNodeWorkflows.addNode(\n          name,\n          beforeModelNode,\n          beforeModelNode.nodeOptions\n        );\n      }\n      if (m.afterModel) {\n        afterModelNode = new AfterModelNode(m);\n        const name = `${m.name}.after_model`;\n        afterModelNodes.push({\n          index: i,\n          name,\n          allowed: getHookConstraint(m.afterModel),\n        });\n        allNodeWorkflows.addNode(\n          name,\n          afterModelNode,\n          afterModelNode.nodeOptions\n        );\n      }\n      if (m.afterAgent) {\n        afterAgentNode = new AfterAgentNode(m);\n        const name = `${m.name}.after_agent`;\n        afterAgentNodes.push({\n          index: i,\n          name,\n          allowed: getHookConstraint(m.afterAgent),\n        });\n        allNodeWorkflows.addNode(\n          name,\n          afterAgentNode,\n          afterAgentNode.nodeOptions\n        );\n      }\n\n      if (m.wrapModelCall) {\n        wrapModelCallHookMiddleware.push(m);\n      }\n    }\n\n    /**\n     * Add Nodes\n     */\n    allNodeWorkflows.addNode(AGENT_NODE_NAME, this.#agentNode);\n\n    /**\n     * Check if any middleware has wrapToolCall defined.\n     * If so, we need to create a ToolNode even without pre-registered tools\n     * to allow middleware to handle dynamically registered tools.\n     */\n    const hasWrapToolCallMiddleware = middleware.some((m) => m.wrapToolCall);\n    const clientTools = toolClasses.filter(isClientTool);\n\n    /**\n     * Create ToolNode if we have client-side tools OR if middleware defines wrapToolCall\n     * (which may handle dynamically registered tools)\n     */\n    if (clientTools.length > 0 || hasWrapToolCallMiddleware) {\n      const toolNode = new ToolNode(clientTools, {\n        signal: this.options.signal,\n        wrapToolCall: wrapToolCall(middleware),\n      });\n      allNodeWorkflows.addNode(TOOLS_NODE_NAME, toolNode);\n    }\n\n    /**\n     * Add Edges\n     */\n    // Determine the entry node (runs once at start): before_agent -> before_model -> model_request\n    let entryNode: string;\n    if (beforeAgentNodes.length > 0) {\n      entryNode = beforeAgentNodes[0].name;\n    } else if (beforeModelNodes.length > 0) {\n      entryNode = beforeModelNodes[0].name;\n    } else {\n      entryNode = AGENT_NODE_NAME;\n    }\n\n    // Determine the loop entry node (beginning of agent loop, excludes before_agent)\n    // This is where tools will loop back to for the next iteration\n    const loopEntryNode =\n      beforeModelNodes.length > 0 ? beforeModelNodes[0].name : AGENT_NODE_NAME;\n\n    // Determine the exit node (runs once at end): after_agent or END\n    const exitNode =\n      afterAgentNodes.length > 0\n        ? afterAgentNodes[afterAgentNodes.length - 1].name\n        : END;\n\n    allNodeWorkflows.addEdge(START, entryNode);\n\n    /**\n     * Determine if we have tools available for routing.\n     * This includes both registered client tools AND dynamic tools via middleware.\n     */\n    const hasToolsAvailable =\n      clientTools.length > 0 || hasWrapToolCallMiddleware;\n\n    // Connect beforeAgent nodes (run once at start)\n    for (let i = 0; i < beforeAgentNodes.length; i++) {\n      const node = beforeAgentNodes[i];\n      const current = node.name;\n      const isLast = i === beforeAgentNodes.length - 1;\n      const nextDefault = isLast ? loopEntryNode : beforeAgentNodes[i + 1].name;\n\n      if (node.allowed && node.allowed.length > 0) {\n        const allowedMapped = node.allowed\n          .map((t) => parseJumpToTarget(t))\n          .filter((dest) => dest !== TOOLS_NODE_NAME || hasToolsAvailable);\n        // Replace END with exitNode (which could be an afterAgent node)\n        const destinations = Array.from(\n          new Set([\n            nextDefault,\n            ...allowedMapped.map((dest) => (dest === END ? exitNode : dest)),\n          ])\n        ) as BaseGraphDestination[];\n\n        allNodeWorkflows.addConditionalEdges(\n          current,\n          this.#createBeforeAgentRouter(\n            clientTools,\n            nextDefault,\n            exitNode,\n            hasToolsAvailable\n          ),\n          destinations\n        );\n      } else {\n        allNodeWorkflows.addEdge(current, nextDefault);\n      }\n    }\n\n    // Connect beforeModel nodes; add conditional routing ONLY if allowed jumps are specified\n    for (let i = 0; i < beforeModelNodes.length; i++) {\n      const node = beforeModelNodes[i];\n      const current = node.name;\n      const isLast = i === beforeModelNodes.length - 1;\n      const nextDefault = isLast\n        ? AGENT_NODE_NAME\n        : beforeModelNodes[i + 1].name;\n\n      if (node.allowed && node.allowed.length > 0) {\n        const allowedMapped = node.allowed\n          .map((t) => parseJumpToTarget(t))\n          .filter((dest) => dest !== TOOLS_NODE_NAME || hasToolsAvailable);\n        const destinations = Array.from(\n          new Set([nextDefault, ...allowedMapped])\n        ) as BaseGraphDestination[];\n\n        allNodeWorkflows.addConditionalEdges(\n          current,\n          this.#createBeforeModelRouter(\n            clientTools,\n            nextDefault,\n            hasToolsAvailable\n          ),\n          destinations\n        );\n      } else {\n        allNodeWorkflows.addEdge(current, nextDefault);\n      }\n    }\n\n    // Connect agent to last afterModel node (for reverse order execution)\n    const lastAfterModelNode = afterModelNodes.at(-1);\n    if (afterModelNodes.length > 0 && lastAfterModelNode) {\n      allNodeWorkflows.addEdge(AGENT_NODE_NAME, lastAfterModelNode.name);\n    } else {\n      // If no afterModel nodes, connect model_request directly to model paths\n      const modelPaths = this.#getModelPaths(\n        clientTools,\n        false,\n        hasToolsAvailable\n      );\n      // Replace END with exitNode in destinations, since exitNode might be an afterAgent node\n      const destinations = modelPaths.map((p) =>\n        p === END ? exitNode : p\n      ) as BaseGraphDestination[];\n      if (destinations.length === 1) {\n        allNodeWorkflows.addEdge(AGENT_NODE_NAME, destinations[0]);\n      } else {\n        allNodeWorkflows.addConditionalEdges(\n          AGENT_NODE_NAME,\n          this.#createModelRouter(exitNode),\n          destinations\n        );\n      }\n    }\n\n    // Connect afterModel nodes in reverse sequence; add conditional routing ONLY if allowed jumps are specified per node\n    for (let i = afterModelNodes.length - 1; i > 0; i--) {\n      const node = afterModelNodes[i];\n      const current = node.name;\n      const nextDefault = afterModelNodes[i - 1].name;\n\n      if (node.allowed && node.allowed.length > 0) {\n        const allowedMapped = node.allowed\n          .map((t) => parseJumpToTarget(t))\n          .filter((dest) => dest !== TOOLS_NODE_NAME || hasToolsAvailable);\n        const destinations = Array.from(\n          new Set([nextDefault, ...allowedMapped])\n        ) as BaseGraphDestination[];\n\n        allNodeWorkflows.addConditionalEdges(\n          current,\n          this.#createAfterModelSequenceRouter(\n            clientTools,\n            node.allowed,\n            nextDefault,\n            hasToolsAvailable\n          ),\n          destinations\n        );\n      } else {\n        allNodeWorkflows.addEdge(current, nextDefault);\n      }\n    }\n\n    // Connect first afterModel node (last to execute) to model paths with jumpTo support\n    if (afterModelNodes.length > 0) {\n      const firstAfterModel = afterModelNodes[0];\n      const firstAfterModelNode = firstAfterModel.name;\n\n      // Include exitNode in the paths since afterModel should be able to route to after_agent or END\n      const modelPaths = this.#getModelPaths(\n        clientTools,\n        true,\n        hasToolsAvailable\n      ).filter((p) => p !== TOOLS_NODE_NAME || hasToolsAvailable);\n\n      const allowJump = Boolean(\n        firstAfterModel.allowed && firstAfterModel.allowed.length > 0\n      );\n\n      // Replace END with exitNode in destinations, since exitNode might be an afterAgent node\n      const destinations = modelPaths.map((p) =>\n        p === END ? exitNode : p\n      ) as BaseGraphDestination[];\n\n      allNodeWorkflows.addConditionalEdges(\n        firstAfterModelNode,\n        this.#createAfterModelRouter(\n          clientTools,\n          allowJump,\n          exitNode,\n          hasToolsAvailable\n        ),\n        destinations\n      );\n    }\n\n    // Connect afterAgent nodes (run once at end, in reverse order like afterModel)\n    for (let i = afterAgentNodes.length - 1; i > 0; i--) {\n      const node = afterAgentNodes[i];\n      const current = node.name;\n      const nextDefault = afterAgentNodes[i - 1].name;\n\n      if (node.allowed && node.allowed.length > 0) {\n        const allowedMapped = node.allowed\n          .map((t) => parseJumpToTarget(t))\n          .filter((dest) => dest !== TOOLS_NODE_NAME || hasToolsAvailable);\n        const destinations = Array.from(\n          new Set([nextDefault, ...allowedMapped])\n        ) as BaseGraphDestination[];\n\n        allNodeWorkflows.addConditionalEdges(\n          current,\n          this.#createAfterModelSequenceRouter(\n            clientTools,\n            node.allowed,\n            nextDefault,\n            hasToolsAvailable\n          ),\n          destinations\n        );\n      } else {\n        allNodeWorkflows.addEdge(current, nextDefault);\n      }\n    }\n\n    // Connect the first afterAgent node (last to execute) to END\n    if (afterAgentNodes.length > 0) {\n      const firstAfterAgent = afterAgentNodes[0];\n      const firstAfterAgentNode = firstAfterAgent.name;\n\n      if (firstAfterAgent.allowed && firstAfterAgent.allowed.length > 0) {\n        const allowedMapped = firstAfterAgent.allowed\n          .map((t) => parseJumpToTarget(t))\n          .filter((dest) => dest !== TOOLS_NODE_NAME || hasToolsAvailable);\n\n        /**\n         * For after_agent, only use explicitly allowed destinations (don't add loopEntryNode)\n         * The default destination (when no jump occurs) should be END\n         */\n        const destinations = Array.from(\n          new Set([END, ...allowedMapped])\n        ) as BaseGraphDestination[];\n\n        allNodeWorkflows.addConditionalEdges(\n          firstAfterAgentNode,\n          this.#createAfterModelSequenceRouter(\n            clientTools,\n            firstAfterAgent.allowed,\n            END as string,\n            hasToolsAvailable\n          ),\n          destinations\n        );\n      } else {\n        allNodeWorkflows.addEdge(firstAfterAgentNode, END);\n      }\n    }\n\n    /**\n     * add edges for tools node (includes both registered tools and dynamic tools via middleware)\n     */\n    if (hasToolsAvailable) {\n      // Tools should return to loop entry node (not including before_agent)\n      const toolReturnTarget = loopEntryNode;\n\n      if (shouldReturnDirect.size > 0) {\n        allNodeWorkflows.addConditionalEdges(\n          TOOLS_NODE_NAME,\n          this.#createToolsRouter(\n            shouldReturnDirect,\n            exitNode,\n            toolReturnTarget\n          ),\n          [toolReturnTarget, exitNode as string]\n        );\n      } else {\n        allNodeWorkflows.addEdge(TOOLS_NODE_NAME, toolReturnTarget);\n      }\n    }\n\n    /**\n     * compile the graph\n     */\n    this.#graph = allNodeWorkflows.compile({\n      checkpointer: this.options.checkpointer,\n      store: this.options.store,\n      name: this.options.name,\n      description: this.options.description,\n    }) as unknown as AgentGraph<Types>;\n  }\n\n  /**\n   * Get the compiled {@link https://docs.langchain.com/oss/javascript/langgraph/use-graph-api | StateGraph}.\n   */\n  get graph(): AgentGraph<Types> {\n    return this.#graph;\n  }\n\n  get checkpointer(): BaseCheckpointSaver | boolean | undefined {\n    return this.#graph.checkpointer;\n  }\n\n  set checkpointer(value: BaseCheckpointSaver | boolean | undefined) {\n    this.#graph.checkpointer = value;\n  }\n\n  get store(): BaseStore | undefined {\n    return this.#graph.store;\n  }\n\n  set store(value: BaseStore | undefined) {\n    this.#graph.store = value;\n  }\n\n  /**\n   * Creates a new ReactAgent with the given config merged into the existing config.\n   * Follows the same pattern as LangGraph's Pregel.withConfig().\n   *\n   * The merged config is applied as a default that gets merged with any config\n   * passed at invocation time (invoke/stream). Invocation-time config takes precedence.\n   *\n   * @param config - Configuration to merge with existing config\n   * @returns A new ReactAgent instance with the merged configuration\n   *\n   * @example\n   * ```typescript\n   * const agent = createAgent({ model: \"gpt-4o\", tools: [...] });\n   *\n   * // Set a default recursion limit\n   * const configuredAgent = agent.withConfig({ recursionLimit: 1000 });\n   *\n   * // Chain multiple configs\n   * const debugAgent = agent\n   *   .withConfig({ recursionLimit: 1000 })\n   *   .withConfig({ tags: [\"debug\"] });\n   * ```\n   */\n  withConfig(\n    config: Omit<RunnableConfig, \"store\" | \"writer\" | \"interrupt\">\n  ): ReactAgent<Types> {\n    return new ReactAgent(\n      this.options,\n      mergeConfigs(this.#defaultConfig, config)\n    );\n  }\n\n  /**\n   * Get possible edge destinations from model node.\n   * @param toolClasses names of tools to call\n   * @param includeModelRequest whether to include \"model_request\" as a valid path (for jumpTo routing)\n   * @param hasToolsAvailable whether tools are available (includes dynamic tools via middleware)\n   * @returns list of possible edge destinations\n   */\n  #getModelPaths(\n    toolClasses: (ClientTool | ServerTool)[],\n    includeModelRequest: boolean = false,\n    hasToolsAvailable: boolean = toolClasses.length > 0\n  ): BaseGraphDestination[] {\n    const paths: BaseGraphDestination[] = [];\n    if (hasToolsAvailable) {\n      paths.push(TOOLS_NODE_NAME);\n    }\n\n    if (includeModelRequest) {\n      paths.push(AGENT_NODE_NAME);\n    }\n\n    paths.push(END);\n\n    return paths;\n  }\n\n  /**\n   * Create routing function for tools node conditional edges.\n   */\n  #createToolsRouter(\n    shouldReturnDirect: Set<string>,\n    exitNode: string | typeof END,\n    toolReturnTarget: string\n  ) {\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as BuiltInState;\n      const messages = builtInState.messages;\n      const lastMessage = messages[messages.length - 1];\n\n      // Check if we just executed a returnDirect tool\n      if (\n        ToolMessage.isInstance(lastMessage) &&\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 to exit node (could be after_agent or END)\n        return this.options.responseFormat ? toolReturnTarget : exitNode;\n      }\n\n      // For non-returnDirect tools, route back to loop entry node (could be middleware or agent)\n      return toolReturnTarget;\n    };\n  }\n\n  /**\n   * Create routing function for model node conditional edges.\n   * @param exitNode - The exit node to route to (could be after_agent or END)\n   */\n  #createModelRouter(exitNode: string | typeof END = END) {\n    /**\n     * determine if the agent should continue or not\n     */\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as BuiltInState;\n      const messages = builtInState.messages;\n      const lastMessage = messages.at(-1);\n\n      if (\n        !AIMessage.isInstance(lastMessage) ||\n        !lastMessage.tool_calls ||\n        lastMessage.tool_calls.length === 0\n      ) {\n        return exitNode;\n      }\n\n      // Check if all tool calls are for structured response extraction\n      const hasOnlyStructuredResponseCalls = lastMessage.tool_calls.every(\n        (toolCall) => toolCall.name.startsWith(\"extract-\")\n      );\n\n      if (hasOnlyStructuredResponseCalls) {\n        // If all tool calls are for structured response extraction, go to exit node\n        // The AgentNode will handle these internally and return the structured response\n        return exitNode;\n      }\n\n      /**\n       * The tool node processes a single message.\n       */\n      if (this.#toolBehaviorVersion === \"v1\") {\n        return TOOLS_NODE_NAME;\n      }\n\n      /**\n       * Route to tools node (filter out any structured response tool calls)\n       */\n      const regularToolCalls = lastMessage.tool_calls.filter(\n        (toolCall) => !toolCall.name.startsWith(\"extract-\")\n      );\n\n      if (regularToolCalls.length === 0) {\n        return exitNode;\n      }\n\n      return regularToolCalls.map(\n        (toolCall) =>\n          new Send(TOOLS_NODE_NAME, { ...state, lg_tool_call: toolCall })\n      );\n    };\n  }\n\n  /**\n   * Create routing function for jumpTo functionality after afterModel hooks.\n   *\n   * This router checks if the `jumpTo` property is set in the state after afterModel middleware\n   * execution. If set, it routes to the specified target (\"model_request\" or \"tools\").\n   * If not set, it falls back to the normal model routing logic for afterModel context.\n   *\n   * The jumpTo property is automatically cleared after use to prevent infinite loops.\n   *\n   * @param toolClasses - Available tool classes for validation\n   * @param allowJump - Whether jumping is allowed\n   * @param exitNode - The exit node to route to (could be after_agent or END)\n   * @param hasToolsAvailable - Whether tools are available (includes dynamic tools via middleware)\n   * @returns Router function that handles jumpTo logic and normal routing\n   */\n  #createAfterModelRouter(\n    toolClasses: (ClientTool | ServerTool)[],\n    allowJump: boolean,\n    exitNode: string | typeof END,\n    hasToolsAvailable: boolean = toolClasses.length > 0\n  ) {\n    const hasStructuredResponse = Boolean(this.options.responseFormat);\n\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as Omit<BuiltInState, \"jumpTo\"> & {\n        jumpTo?: JumpTo;\n      };\n      // First, check if we just processed a structured response\n      // If so, ignore any existing jumpTo and go to exitNode\n      const messages = builtInState.messages;\n      const lastMessage = messages.at(-1);\n      if (\n        AIMessage.isInstance(lastMessage) &&\n        (!lastMessage.tool_calls || lastMessage.tool_calls.length === 0)\n      ) {\n        return exitNode;\n      }\n\n      // Check if jumpTo is set in the state and allowed\n      if (allowJump && builtInState.jumpTo) {\n        const destination = parseJumpToTarget(builtInState.jumpTo);\n        if (destination === END) {\n          return exitNode;\n        }\n        if (destination === TOOLS_NODE_NAME) {\n          // If trying to jump to tools but no tools are available, go to exitNode\n          if (!hasToolsAvailable) {\n            return exitNode;\n          }\n          return new Send(TOOLS_NODE_NAME, { ...state, jumpTo: undefined });\n        }\n        // destination === \"model_request\"\n        return new Send(AGENT_NODE_NAME, { ...state, jumpTo: undefined });\n      }\n\n      // check if there are pending tool calls\n      const toolMessages = messages.filter(ToolMessage.isInstance);\n      const lastAiMessage = messages.filter(AIMessage.isInstance).at(-1);\n      const pendingToolCalls = lastAiMessage?.tool_calls?.filter(\n        (call) => !toolMessages.some((m) => m.tool_call_id === call.id)\n      );\n      if (pendingToolCalls && pendingToolCalls.length > 0) {\n        /**\n         * v1: route the full message to the ToolNode; it filters already-processed\n         * calls internally and runs the remaining ones via Promise.all.\n         * v2: dispatch each pending call as a separate Send task.\n         */\n        if (this.#toolBehaviorVersion === \"v1\") {\n          return TOOLS_NODE_NAME;\n        }\n        return pendingToolCalls.map(\n          (toolCall) =>\n            new Send(TOOLS_NODE_NAME, { ...state, lg_tool_call: toolCall })\n        );\n      }\n\n      // if we exhausted all tool calls, but still have no structured response tool calls,\n      // go back to model_request\n      const hasStructuredResponseCalls = lastAiMessage?.tool_calls?.some(\n        (toolCall) => toolCall.name.startsWith(\"extract-\")\n      );\n\n      if (\n        pendingToolCalls &&\n        pendingToolCalls.length === 0 &&\n        !hasStructuredResponseCalls &&\n        hasStructuredResponse\n      ) {\n        return AGENT_NODE_NAME;\n      }\n\n      if (\n        !AIMessage.isInstance(lastMessage) ||\n        !lastMessage.tool_calls ||\n        lastMessage.tool_calls.length === 0\n      ) {\n        return exitNode;\n      }\n\n      // Check if all tool calls are for structured response extraction\n      const hasOnlyStructuredResponseCalls = lastMessage.tool_calls.every(\n        (toolCall) => toolCall.name.startsWith(\"extract-\")\n      );\n\n      // Check if there are any regular tool calls (non-structured response)\n      const hasRegularToolCalls = lastMessage.tool_calls.some(\n        (toolCall) => !toolCall.name.startsWith(\"extract-\")\n      );\n\n      if (hasOnlyStructuredResponseCalls || !hasRegularToolCalls) {\n        return exitNode;\n      }\n\n      /**\n       * v1: route the full AIMessage to a single ToolNode invocation so all\n       * tool calls run concurrently via Promise.all.\n       *\n       * v2: dispatch each regular tool call as a separate Send task, matching\n       * the behaviour of #createModelRouter when no afterModel middleware is\n       * present.\n       */\n      if (this.#toolBehaviorVersion === \"v1\") {\n        return TOOLS_NODE_NAME;\n      }\n\n      const regularToolCalls = (lastMessage as AIMessage).tool_calls!.filter(\n        (toolCall) => !toolCall.name.startsWith(\"extract-\")\n      );\n\n      if (regularToolCalls.length === 0) {\n        return exitNode;\n      }\n\n      return regularToolCalls.map(\n        (toolCall) =>\n          new Send(TOOLS_NODE_NAME, { ...state, lg_tool_call: toolCall })\n      );\n    };\n  }\n\n  /**\n   * Router for afterModel sequence nodes (connecting later middlewares to earlier ones),\n   * honoring allowed jump targets and defaulting to the next node.\n   * @param toolClasses - Available tool classes for validation\n   * @param allowed - List of allowed jump targets\n   * @param nextDefault - Default node to route to\n   * @param hasToolsAvailable - Whether tools are available (includes dynamic tools via middleware)\n   */\n  #createAfterModelSequenceRouter(\n    toolClasses: (ClientTool | ServerTool)[],\n    allowed: string[],\n    nextDefault: string,\n    hasToolsAvailable: boolean = toolClasses.length > 0\n  ) {\n    const allowedSet = new Set(allowed.map((t) => parseJumpToTarget(t)));\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as BuiltInState;\n      if (builtInState.jumpTo) {\n        const dest = parseJumpToTarget(builtInState.jumpTo);\n        if (dest === END && allowedSet.has(END)) {\n          return END;\n        }\n        if (dest === TOOLS_NODE_NAME && allowedSet.has(TOOLS_NODE_NAME)) {\n          if (!hasToolsAvailable) return END;\n          return new Send(TOOLS_NODE_NAME, { ...state, jumpTo: undefined });\n        }\n        if (dest === AGENT_NODE_NAME && allowedSet.has(AGENT_NODE_NAME)) {\n          return new Send(AGENT_NODE_NAME, { ...state, jumpTo: undefined });\n        }\n      }\n      return nextDefault;\n    };\n  }\n\n  /**\n   * Create routing function for jumpTo functionality after beforeAgent hooks.\n   * Falls back to the default next node if no jumpTo is present.\n   * When jumping to END, routes to exitNode (which could be an afterAgent node).\n   * @param toolClasses - Available tool classes for validation\n   * @param nextDefault - Default node to route to\n   * @param exitNode - Exit node to route to (could be after_agent or END)\n   * @param hasToolsAvailable - Whether tools are available (includes dynamic tools via middleware)\n   */\n  #createBeforeAgentRouter(\n    toolClasses: (ClientTool | ServerTool)[],\n    nextDefault: string,\n    exitNode: string | typeof END,\n    hasToolsAvailable: boolean = toolClasses.length > 0\n  ) {\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as BuiltInState;\n      if (!builtInState.jumpTo) {\n        return nextDefault;\n      }\n      const destination = parseJumpToTarget(builtInState.jumpTo);\n      if (destination === END) {\n        /**\n         * When beforeAgent jumps to END, route to exitNode (first afterAgent node)\n         */\n        return exitNode;\n      }\n      if (destination === TOOLS_NODE_NAME) {\n        if (!hasToolsAvailable) {\n          return exitNode;\n        }\n        return new Send(TOOLS_NODE_NAME, { ...state, jumpTo: undefined });\n      }\n      return new Send(AGENT_NODE_NAME, { ...state, jumpTo: undefined });\n    };\n  }\n\n  /**\n   * Create routing function for jumpTo functionality after beforeModel hooks.\n   * Falls back to the default next node if no jumpTo is present.\n   * @param toolClasses - Available tool classes for validation\n   * @param nextDefault - Default node to route to\n   * @param hasToolsAvailable - Whether tools are available (includes dynamic tools via middleware)\n   */\n  #createBeforeModelRouter(\n    toolClasses: (ClientTool | ServerTool)[],\n    nextDefault: string,\n    hasToolsAvailable: boolean = toolClasses.length > 0\n  ) {\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as BuiltInState;\n      if (!builtInState.jumpTo) {\n        return nextDefault;\n      }\n      const destination = parseJumpToTarget(builtInState.jumpTo);\n      if (destination === END) {\n        return END;\n      }\n      if (destination === TOOLS_NODE_NAME) {\n        if (!hasToolsAvailable) {\n          return END;\n        }\n        return new Send(TOOLS_NODE_NAME, { ...state, jumpTo: undefined });\n      }\n      return new Send(AGENT_NODE_NAME, { ...state, jumpTo: undefined });\n    };\n  }\n\n  /**\n   * Initialize middleware states if not already present in the input state.\n   */\n  async #initializeMiddlewareStates(\n    state: InvokeStateParameter<Types>,\n    config: RunnableConfig\n  ): Promise<InvokeStateParameter<Types>> {\n    if (\n      !this.options.middleware ||\n      this.options.middleware.length === 0 ||\n      state instanceof Command ||\n      !state\n    ) {\n      return state;\n    }\n\n    const defaultStates = await initializeMiddlewareStates(\n      this.options.middleware,\n      state\n    );\n    const threadState = await this.#graph\n      .getState(config)\n      .catch(() => ({ values: {} }));\n    const updatedState = {\n      ...threadState.values,\n      ...state,\n    } as InvokeStateParameter<Types>;\n    if (!updatedState) {\n      return updatedState;\n    }\n\n    // Only add defaults for keys that don't exist in current state\n    for (const [key, value] of Object.entries(defaultStates)) {\n      if (!(key in updatedState)) {\n        updatedState[key as keyof typeof updatedState] = value;\n      }\n    }\n\n    return updatedState;\n  }\n\n  /**\n   * Executes the agent with the given state and returns the final state after all processing.\n   *\n   * This method runs the agent's entire workflow synchronously, including:\n   * - Processing the input messages through any configured middleware\n   * - Calling the language model to generate responses\n   * - Executing any tool calls made by the model\n   * - Running all middleware hooks (beforeModel, afterModel, etc.)\n   *\n   * @param state - The initial state for the agent execution. Can be:\n   *   - An object containing `messages` array and any middleware-specific state properties\n   *   - A Command object for more advanced control flow\n   *\n   * @param config - Optional runtime configuration including:\n   * @param config.context - The context for the agent execution.\n   * @param config.configurable - LangGraph configuration options like `thread_id`, `run_id`, etc.\n   * @param config.store - The store for the agent execution for persisting state, see more in {@link https://docs.langchain.com/oss/javascript/langgraph/memory#memory-storage | Memory storage}.\n   * @param config.signal - An optional {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | `AbortSignal`} for the agent execution.\n   * @param config.recursionLimit - The recursion limit for the agent execution.\n   *\n   * @returns A Promise that resolves to the final agent state after execution completes.\n   *          The returned state includes:\n   *          - a `messages` property containing an array with all messages (input, AI responses, tool calls/results)\n   *          - a `structuredResponse` property containing the structured response (if configured)\n   *          - all state values defined in the middleware\n   *\n   * @example\n   * ```typescript\n   * const agent = new ReactAgent({\n   *   llm: myModel,\n   *   tools: [calculator, webSearch],\n   *   responseFormat: z.object({\n   *     weather: z.string(),\n   *   }),\n   * });\n   *\n   * const result = await agent.invoke({\n   *   messages: [{ role: \"human\", content: \"What's the weather in Paris?\" }]\n   * });\n   *\n   * console.log(result.structuredResponse.weather); // outputs: \"It's sunny and 75°F.\"\n   * ```\n   */\n  async invoke(\n    state: InvokeStateParameter<Types>,\n    config?: InvokeConfiguration<\n      InferContextInput<\n        Types[\"Context\"] extends AnyAnnotationRoot | InteropZodObject\n          ? Types[\"Context\"]\n          : AnyAnnotationRoot\n      > &\n        InferMiddlewareContextInputs<Types[\"Middleware\"]>\n    >\n  ) {\n    type FullState = MergedAgentState<Types>;\n    const mergedConfig = mergeConfigs(this.#defaultConfig, config);\n    const initializedState = await this.#initializeMiddlewareStates(\n      state,\n      mergedConfig as RunnableConfig\n    );\n\n    return this.#graph.invoke(\n      initializedState,\n      mergedConfig as unknown as InferContextInput<\n        Types[\"Context\"] extends AnyAnnotationRoot | InteropZodObject\n          ? Types[\"Context\"]\n          : AnyAnnotationRoot\n      > &\n        InferMiddlewareContextInputs<Types[\"Middleware\"]>\n    ) as Promise<FullState>;\n  }\n\n  /**\n   * Executes the agent with streaming, returning an async iterable of state updates as they occur.\n   *\n   * This method runs the agent's workflow similar to `invoke`, but instead of waiting for\n   * completion, it streams high-level state updates in real-time. This allows you to:\n   * - Display intermediate results to users as they're generated\n   * - Monitor the agent's progress through each step\n   * - React to state changes as nodes complete\n   *\n   * For more granular event-level streaming (like individual LLM tokens), use `streamEvents` instead.\n   *\n   * @param state - The initial state for the agent execution. Can be:\n   *   - An object containing `messages` array and any middleware-specific state properties\n   *   - A Command object for more advanced control flow\n   *\n   * @param config - Optional runtime configuration including:\n   * @param config.context - The context for the agent execution.\n   * @param config.configurable - LangGraph configuration options like `thread_id`, `run_id`, etc.\n   * @param config.store - The store for the agent execution for persisting state, see more in {@link https://docs.langchain.com/oss/javascript/langgraph/memory#memory-storage | Memory storage}.\n   * @param config.signal - An optional {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | `AbortSignal`} for the agent execution.\n   * @param config.streamMode - The streaming mode for the agent execution, see more in {@link https://docs.langchain.com/oss/javascript/langgraph/streaming#supported-stream-modes | Supported stream modes}.\n   * @param config.recursionLimit - The recursion limit for the agent execution.\n   *\n   * @returns A Promise that resolves to an IterableReadableStream of state updates.\n   *          Each update contains the current state after a node completes.\n   *\n   * @example\n   * ```typescript\n   * const agent = new ReactAgent({\n   *   llm: myModel,\n   *   tools: [calculator, webSearch]\n   * });\n   *\n   * const stream = await agent.stream({\n   *   messages: [{ role: \"human\", content: \"What's 2+2 and the weather in NYC?\" }]\n   * });\n   *\n   * for await (const chunk of stream) {\n   *   console.log(chunk); // State update from each node\n   * }\n   * ```\n   */\n  async stream<\n    TStreamMode extends StreamMode | StreamMode[] | undefined,\n    TSubgraphs extends boolean,\n    TEncoding extends \"text/event-stream\" | undefined,\n  >(\n    state: InvokeStateParameter<Types>,\n    config?: StreamConfiguration<\n      InferContextInput<\n        Types[\"Context\"] extends AnyAnnotationRoot | InteropZodObject\n          ? Types[\"Context\"]\n          : AnyAnnotationRoot\n      > &\n        InferMiddlewareContextInputs<Types[\"Middleware\"]>,\n      TStreamMode,\n      TSubgraphs,\n      TEncoding\n    >\n  ) {\n    const mergedConfig = mergeConfigs(this.#defaultConfig, config);\n    const initializedState = await this.#initializeMiddlewareStates(\n      state,\n      mergedConfig as RunnableConfig\n    );\n    return this.#graph.stream(\n      initializedState,\n      mergedConfig as Record<string, any>\n    ) as Promise<\n      IterableReadableStream<\n        StreamOutputMap<\n          TStreamMode,\n          TSubgraphs,\n          MergedAgentState<Types>,\n          MergedAgentState<Types>,\n          string,\n          unknown,\n          unknown,\n          TEncoding\n        >\n      >\n    >;\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  /**\n   * The following are internal methods to enable support for LangGraph Platform.\n   * They are not part of the createAgent public API.\n   *\n   * Note: we intentionally return as `never` to avoid type errors due to type inference.\n   */\n\n  /**\n   * @internal\n   */\n  streamEvents(\n    state: InvokeStateParameter<Types>,\n    config?: StreamConfiguration<\n      InferContextInput<\n        Types[\"Context\"] extends AnyAnnotationRoot | InteropZodObject\n          ? Types[\"Context\"]\n          : AnyAnnotationRoot\n      > &\n        InferMiddlewareContextInputs<Types[\"Middleware\"]>,\n      StreamMode | StreamMode[] | undefined,\n      boolean,\n      \"text/event-stream\" | undefined\n    > & { version?: \"v1\" | \"v2\" },\n    streamOptions?: Parameters<Runnable[\"streamEvents\"]>[2]\n  ): IterableReadableStream<StreamEvent> {\n    const mergedConfig = mergeConfigs(this.#defaultConfig, config);\n    return this.#graph.streamEvents(\n      state,\n      {\n        ...(mergedConfig as Partial<\n          PregelOptions<\n            any,\n            any,\n            any,\n            StreamMode | StreamMode[] | undefined,\n            boolean,\n            \"text/event-stream\"\n          >\n        >),\n        version: config?.version ?? \"v2\",\n      },\n      streamOptions\n    );\n  }\n  /**\n   * @internal\n   */\n  getGraphAsync(config?: RunnableConfig) {\n    return this.#graph.getGraphAsync(config) as never;\n  }\n  /**\n   * @internal\n   */\n  getState(config: RunnableConfig, options?: GetStateOptions) {\n    return this.#graph.getState(config, options) as never;\n  }\n  /**\n   * @internal\n   */\n  getStateHistory(config: RunnableConfig, options?: CheckpointListOptions) {\n    return this.#graph.getStateHistory(config, options) as never;\n  }\n  /**\n   * @internal\n   */\n  getSubgraphs(namespace?: string, recurse?: boolean) {\n    return this.#graph.getSubgraphs(namespace, recurse) as never;\n  }\n  /**\n   * @internal\n   */\n  getSubgraphsAsync(namespace?: string, recurse?: boolean) {\n    return this.#graph.getSubgraphsAsync(namespace, recurse) as never;\n  }\n  /**\n   * @internal\n   */\n  updateState(\n    inputConfig: LangGraphRunnableConfig,\n    values: Record<string, unknown> | unknown,\n    asNode?: string\n  ) {\n    return this.#graph.updateState(inputConfig, values, asNode) as never;\n  }\n\n  /**\n   * @internal\n   */\n  get builder() {\n    return this.#graph.builder;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"ReactAgent.js","names":["#defaultConfig","#toolBehaviorVersion","#agentNode","#createBeforeAgentRouter","#createBeforeModelRouter","#getModelPaths","#createModelRouter","#createAfterModelSequenceRouter","#createAfterModelRouter","#createToolsRouter","#graph","#initializeMiddlewareStates"],"sources":["../../src/agents/ReactAgent.ts"],"sourcesContent":["/* oxlint-disable no-instanceof/no-instanceof */\n/* oxlint-disable @typescript-eslint/no-explicit-any */\nimport { InteropZodObject } from \"@langchain/core/utils/types\";\n\nimport {\n  StateGraph,\n  END,\n  START,\n  Send,\n  Command,\n  CompiledStateGraph,\n  type GetStateOptions,\n  type LangGraphRunnableConfig,\n  type StreamMode,\n  type StreamOutputMap,\n  type PregelOptions,\n} from \"@langchain/langgraph\";\nimport type {\n  BaseCheckpointSaver,\n  BaseStore,\n  CheckpointListOptions,\n} from \"@langchain/langgraph-checkpoint\";\nimport {\n  ToolMessage,\n  AIMessage,\n  MessageStructure,\n} from \"@langchain/core/messages\";\nimport { IterableReadableStream } from \"@langchain/core/utils/stream\";\nimport {\n  mergeConfigs,\n  type Runnable,\n  type RunnableConfig,\n} from \"@langchain/core/runnables\";\nimport type { StreamEvent } from \"@langchain/core/tracers/log_stream\";\nimport type { ClientTool, ServerTool } from \"@langchain/core/tools\";\nimport { createAgentState } from \"./annotation.js\";\nimport {\n  isClientTool,\n  validateLLMHasNoBoundTools,\n  wrapToolCall,\n  normalizeSystemPrompt,\n} from \"./utils.js\";\n\nimport { AgentNode, AGENT_NODE_NAME } from \"./nodes/AgentNode.js\";\nimport { ToolNode, TOOLS_NODE_NAME } from \"./nodes/ToolNode.js\";\nimport { BeforeAgentNode } from \"./nodes/BeforeAgentNode.js\";\nimport { BeforeModelNode } from \"./nodes/BeforeModelNode.js\";\nimport { AfterModelNode } from \"./nodes/AfterModelNode.js\";\nimport { AfterAgentNode } from \"./nodes/AfterAgentNode.js\";\nimport {\n  initializeMiddlewareStates,\n  parseJumpToTarget,\n} from \"./nodes/utils.js\";\n\nimport type {\n  WithStateGraphNodes,\n  AgentTypeConfig,\n  CreateAgentParams,\n  ToolsToMessageToolSet,\n} from \"./types.js\";\n\nimport type { BuiltInState, JumpTo, UserInput } from \"./types.js\";\nimport type { InvokeConfiguration, StreamConfiguration } from \"./runtime.js\";\nimport type {\n  AgentMiddleware,\n  InferMiddlewareContextInputs,\n  InferMiddlewareStates,\n  InferMiddlewareInputStates,\n  InferContextInput,\n  AnyAnnotationRoot,\n  InferSchemaValue,\n  ToAnnotationRoot,\n} from \"./middleware/types.js\";\nimport { type ResponseFormatUndefined } from \"./responses.js\";\nimport { getHookConstraint } from \"./middleware/utils.js\";\n\n/**\n * In the ReAct pattern we have three main nodes:\n * - model_request: The node that makes the model call.\n * - tools: The node that calls the tools.\n * - END: The end of the graph.\n *\n * These are the only nodes that can be jumped to from other nodes.\n */\ntype BaseGraphDestination =\n  | typeof TOOLS_NODE_NAME\n  | typeof AGENT_NODE_NAME\n  | typeof END;\n\n// Helper type to get the state definition with middleware states\ntype MergedAgentState<Types extends AgentTypeConfig> = InferSchemaValue<\n  Types[\"State\"]\n> &\n  (Types[\"Response\"] extends ResponseFormatUndefined\n    ? Omit<\n        BuiltInState<MessageStructure<ToolsToMessageToolSet<Types[\"Tools\"]>>>,\n        \"jumpTo\"\n      >\n    : Omit<\n        BuiltInState<MessageStructure<ToolsToMessageToolSet<Types[\"Tools\"]>>>,\n        \"jumpTo\"\n      > & {\n        structuredResponse: Types[\"Response\"];\n      }) &\n  InferMiddlewareStates<Types[\"Middleware\"]>;\n\ntype InvokeStateParameter<Types extends AgentTypeConfig> =\n  | (UserInput<Types[\"State\"]> &\n      InferMiddlewareInputStates<Types[\"Middleware\"]>)\n  | Command<any, any, any>\n  | null;\n\ntype AgentGraph<Types extends AgentTypeConfig> = CompiledStateGraph<\n  any,\n  any,\n  any,\n  any,\n  MergedAgentState<Types>,\n  ToAnnotationRoot<\n    Types[\"Context\"] extends AnyAnnotationRoot | InteropZodObject\n      ? Types[\"Context\"]\n      : AnyAnnotationRoot\n  >[\"spec\"],\n  unknown\n>;\n\n/**\n * ReactAgent is a production-ready ReAct (Reasoning + Acting) agent that combines\n * language models with tools and middleware.\n *\n * The agent is parameterized by a single type bag `Types` that encapsulates all\n * type information:\n *\n * @typeParam Types - An {@link AgentTypeConfig} that bundles:\n *   - `Response`: The structured response type\n *   - `State`: The custom state schema type\n *   - `Context`: The context schema type\n *   - `Middleware`: The middleware array type\n *   - `Tools`: The combined tools type from agent and middleware\n *\n * @example\n * ```typescript\n * // Using the type bag pattern\n * type MyTypes = AgentTypeConfig<\n *   { name: string },  // Response\n *   typeof myState,    // State\n *   typeof myContext,  // Context\n *   typeof middleware, // Middleware\n *   typeof tools       // Tools\n * >;\n *\n * const agent: ReactAgent<MyTypes> = createAgent({ ... });\n * ```\n */\nexport class ReactAgent<\n  Types extends AgentTypeConfig = AgentTypeConfig<\n    Record<string, any>,\n    undefined,\n    AnyAnnotationRoot,\n    readonly AgentMiddleware[],\n    readonly (ClientTool | ServerTool)[]\n  >,\n> {\n  /**\n   * Type marker for extracting the AgentTypeConfig from a ReactAgent instance.\n   * This is a phantom property used only for type inference.\n   * @internal\n   */\n  declare readonly \"~agentTypes\": Types;\n\n  #graph: AgentGraph<Types>;\n\n  #toolBehaviorVersion: \"v1\" | \"v2\" = \"v2\";\n\n  #agentNode: AgentNode<any, AnyAnnotationRoot>;\n\n  #defaultConfig: RunnableConfig;\n\n  constructor(\n    public options: CreateAgentParams<\n      Types[\"Response\"],\n      Types[\"State\"],\n      Types[\"Context\"]\n    >,\n    defaultConfig?: RunnableConfig\n  ) {\n    this.#defaultConfig = mergeConfigs(defaultConfig ?? {}, {\n      metadata: { ls_integration: \"langchain_create_agent\" },\n      configurable: { ls_agent_type: \"root\" },\n    });\n    if (options.name) {\n      this.#defaultConfig = mergeConfigs(this.#defaultConfig, {\n        metadata: { lc_agent_name: options.name },\n      });\n    }\n    this.#toolBehaviorVersion = options.version ?? this.#toolBehaviorVersion;\n\n    /**\n     * validate that model option is provided\n     */\n    if (!options.model) {\n      throw new Error(\"`model` option is required to create an agent.\");\n    }\n\n    /**\n     * Check if the LLM already has bound tools and throw if it does.\n     */\n    if (typeof options.model !== \"string\") {\n      validateLLMHasNoBoundTools(options.model);\n    }\n\n    /**\n     * define complete list of tools based on options and middleware\n     */\n    const middlewareTools = (this.options.middleware\n      ?.filter((m) => m.tools)\n      .flatMap((m) => m.tools) ?? []) as (ClientTool | ServerTool)[];\n    const toolClasses = [...(options.tools ?? []), ...middlewareTools];\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    /**\n     * Create a schema that merges agent base schema with middleware state schemas\n     * Using Zod with withLangGraph ensures LangGraph Studio gets proper metadata\n     */\n    const hasDynamicStructuredResponse = Boolean(\n      this.options.middleware?.some((middleware) => middleware.wrapModelCall)\n    );\n    const { state, input, output } = createAgentState<\n      Types[\"State\"],\n      Types[\"Middleware\"]\n    >(\n      this.options.responseFormat !== undefined || hasDynamicStructuredResponse,\n      this.options.stateSchema as Types[\"State\"],\n      this.options.middleware as Types[\"Middleware\"]\n    );\n\n    const workflow = new StateGraph(state, {\n      input,\n      output,\n      context: this.options.contextSchema,\n    });\n\n    const allNodeWorkflows = workflow as WithStateGraphNodes<\n      typeof TOOLS_NODE_NAME | typeof AGENT_NODE_NAME | string,\n      typeof workflow\n    >;\n\n    // Generate node names for middleware nodes that have hooks\n    const beforeAgentNodes: {\n      index: number;\n      name: string;\n      allowed?: string[];\n    }[] = [];\n    const beforeModelNodes: {\n      index: number;\n      name: string;\n      allowed?: string[];\n    }[] = [];\n    const afterModelNodes: {\n      index: number;\n      name: string;\n      allowed?: string[];\n    }[] = [];\n    const afterAgentNodes: {\n      index: number;\n      name: string;\n      allowed?: string[];\n    }[] = [];\n    const wrapModelCallHookMiddleware: AgentMiddleware[] = [];\n\n    this.#agentNode = new AgentNode({\n      model: this.options.model,\n      systemMessage: normalizeSystemPrompt(this.options.systemPrompt),\n      includeAgentName: this.options.includeAgentName,\n      name: this.options.name,\n      responseFormat: this.options.responseFormat,\n      middleware: this.options.middleware,\n      toolClasses,\n      shouldReturnDirect,\n      signal: this.options.signal,\n      wrapModelCallHookMiddleware,\n    });\n\n    const middlewareNames = new Set<string>();\n    const middleware = this.options.middleware ?? [];\n    for (let i = 0; i < middleware.length; i++) {\n      let beforeAgentNode: BeforeAgentNode | undefined;\n      let beforeModelNode: BeforeModelNode | undefined;\n      let afterModelNode: AfterModelNode | undefined;\n      let afterAgentNode: AfterAgentNode | undefined;\n      const m = middleware[i];\n      if (middlewareNames.has(m.name)) {\n        throw new Error(`Middleware ${m.name} is defined multiple times`);\n      }\n\n      middlewareNames.add(m.name);\n      if (m.beforeAgent) {\n        beforeAgentNode = new BeforeAgentNode(m);\n        const name = `${m.name}.before_agent`;\n        beforeAgentNodes.push({\n          index: i,\n          name,\n          allowed: getHookConstraint(m.beforeAgent),\n        });\n        allNodeWorkflows.addNode(\n          name,\n          beforeAgentNode,\n          beforeAgentNode.nodeOptions\n        );\n      }\n      if (m.beforeModel) {\n        beforeModelNode = new BeforeModelNode(m);\n        const name = `${m.name}.before_model`;\n        beforeModelNodes.push({\n          index: i,\n          name,\n          allowed: getHookConstraint(m.beforeModel),\n        });\n        allNodeWorkflows.addNode(\n          name,\n          beforeModelNode,\n          beforeModelNode.nodeOptions\n        );\n      }\n      if (m.afterModel) {\n        afterModelNode = new AfterModelNode(m);\n        const name = `${m.name}.after_model`;\n        afterModelNodes.push({\n          index: i,\n          name,\n          allowed: getHookConstraint(m.afterModel),\n        });\n        allNodeWorkflows.addNode(\n          name,\n          afterModelNode,\n          afterModelNode.nodeOptions\n        );\n      }\n      if (m.afterAgent) {\n        afterAgentNode = new AfterAgentNode(m);\n        const name = `${m.name}.after_agent`;\n        afterAgentNodes.push({\n          index: i,\n          name,\n          allowed: getHookConstraint(m.afterAgent),\n        });\n        allNodeWorkflows.addNode(\n          name,\n          afterAgentNode,\n          afterAgentNode.nodeOptions\n        );\n      }\n\n      if (m.wrapModelCall) {\n        wrapModelCallHookMiddleware.push(m);\n      }\n    }\n\n    /**\n     * Add Nodes\n     */\n    allNodeWorkflows.addNode(AGENT_NODE_NAME, this.#agentNode);\n\n    /**\n     * Check if any middleware has wrapToolCall defined.\n     * If so, we need to create a ToolNode even without pre-registered tools\n     * to allow middleware to handle dynamically registered tools.\n     */\n    const hasWrapToolCallMiddleware = middleware.some((m) => m.wrapToolCall);\n    const clientTools = toolClasses.filter(isClientTool);\n\n    /**\n     * Create ToolNode if we have client-side tools OR if middleware defines wrapToolCall\n     * (which may handle dynamically registered tools)\n     */\n    if (clientTools.length > 0 || hasWrapToolCallMiddleware) {\n      const toolNode = new ToolNode(clientTools, {\n        signal: this.options.signal,\n        wrapToolCall: wrapToolCall(middleware),\n      });\n      allNodeWorkflows.addNode(TOOLS_NODE_NAME, toolNode);\n    }\n\n    /**\n     * Add Edges\n     */\n    // Determine the entry node (runs once at start): before_agent -> before_model -> model_request\n    let entryNode: string;\n    if (beforeAgentNodes.length > 0) {\n      entryNode = beforeAgentNodes[0].name;\n    } else if (beforeModelNodes.length > 0) {\n      entryNode = beforeModelNodes[0].name;\n    } else {\n      entryNode = AGENT_NODE_NAME;\n    }\n\n    // Determine the loop entry node (beginning of agent loop, excludes before_agent)\n    // This is where tools will loop back to for the next iteration\n    const loopEntryNode =\n      beforeModelNodes.length > 0 ? beforeModelNodes[0].name : AGENT_NODE_NAME;\n\n    // Determine the exit node (runs once at end): after_agent or END\n    const exitNode =\n      afterAgentNodes.length > 0\n        ? afterAgentNodes[afterAgentNodes.length - 1].name\n        : END;\n\n    allNodeWorkflows.addEdge(START, entryNode);\n\n    /**\n     * Determine if we have tools available for routing.\n     * This includes both registered client tools AND dynamic tools via middleware.\n     */\n    const hasToolsAvailable =\n      clientTools.length > 0 || hasWrapToolCallMiddleware;\n\n    // Connect beforeAgent nodes (run once at start)\n    for (let i = 0; i < beforeAgentNodes.length; i++) {\n      const node = beforeAgentNodes[i];\n      const current = node.name;\n      const isLast = i === beforeAgentNodes.length - 1;\n      const nextDefault = isLast ? loopEntryNode : beforeAgentNodes[i + 1].name;\n\n      if (node.allowed && node.allowed.length > 0) {\n        const allowedMapped = node.allowed\n          .map((t) => parseJumpToTarget(t))\n          .filter((dest) => dest !== TOOLS_NODE_NAME || hasToolsAvailable);\n        // Replace END with exitNode (which could be an afterAgent node)\n        const destinations = Array.from(\n          new Set([\n            nextDefault,\n            ...allowedMapped.map((dest) => (dest === END ? exitNode : dest)),\n          ])\n        ) as BaseGraphDestination[];\n\n        allNodeWorkflows.addConditionalEdges(\n          current,\n          this.#createBeforeAgentRouter(\n            clientTools,\n            nextDefault,\n            exitNode,\n            hasToolsAvailable\n          ),\n          destinations\n        );\n      } else {\n        allNodeWorkflows.addEdge(current, nextDefault);\n      }\n    }\n\n    // Connect beforeModel nodes; add conditional routing ONLY if allowed jumps are specified\n    for (let i = 0; i < beforeModelNodes.length; i++) {\n      const node = beforeModelNodes[i];\n      const current = node.name;\n      const isLast = i === beforeModelNodes.length - 1;\n      const nextDefault = isLast\n        ? AGENT_NODE_NAME\n        : beforeModelNodes[i + 1].name;\n\n      if (node.allowed && node.allowed.length > 0) {\n        const allowedMapped = node.allowed\n          .map((t) => parseJumpToTarget(t))\n          .filter((dest) => dest !== TOOLS_NODE_NAME || hasToolsAvailable);\n        const destinations = Array.from(\n          new Set([nextDefault, ...allowedMapped])\n        ) as BaseGraphDestination[];\n\n        allNodeWorkflows.addConditionalEdges(\n          current,\n          this.#createBeforeModelRouter(\n            clientTools,\n            nextDefault,\n            hasToolsAvailable\n          ),\n          destinations\n        );\n      } else {\n        allNodeWorkflows.addEdge(current, nextDefault);\n      }\n    }\n\n    // Connect agent to last afterModel node (for reverse order execution)\n    const lastAfterModelNode = afterModelNodes.at(-1);\n    if (afterModelNodes.length > 0 && lastAfterModelNode) {\n      allNodeWorkflows.addEdge(AGENT_NODE_NAME, lastAfterModelNode.name);\n    } else {\n      // If no afterModel nodes, connect model_request directly to model paths\n      const modelPaths = this.#getModelPaths(\n        clientTools,\n        false,\n        hasToolsAvailable\n      );\n      // Replace END with exitNode in destinations, since exitNode might be an afterAgent node\n      const destinations = modelPaths.map((p) =>\n        p === END ? exitNode : p\n      ) as BaseGraphDestination[];\n      if (destinations.length === 1) {\n        allNodeWorkflows.addEdge(AGENT_NODE_NAME, destinations[0]);\n      } else {\n        allNodeWorkflows.addConditionalEdges(\n          AGENT_NODE_NAME,\n          this.#createModelRouter(exitNode),\n          destinations\n        );\n      }\n    }\n\n    // Connect afterModel nodes in reverse sequence; add conditional routing ONLY if allowed jumps are specified per node\n    for (let i = afterModelNodes.length - 1; i > 0; i--) {\n      const node = afterModelNodes[i];\n      const current = node.name;\n      const nextDefault = afterModelNodes[i - 1].name;\n\n      if (node.allowed && node.allowed.length > 0) {\n        const allowedMapped = node.allowed\n          .map((t) => parseJumpToTarget(t))\n          .filter((dest) => dest !== TOOLS_NODE_NAME || hasToolsAvailable);\n        const destinations = Array.from(\n          new Set([nextDefault, ...allowedMapped])\n        ) as BaseGraphDestination[];\n\n        allNodeWorkflows.addConditionalEdges(\n          current,\n          this.#createAfterModelSequenceRouter(\n            clientTools,\n            node.allowed,\n            nextDefault,\n            hasToolsAvailable\n          ),\n          destinations\n        );\n      } else {\n        allNodeWorkflows.addEdge(current, nextDefault);\n      }\n    }\n\n    // Connect first afterModel node (last to execute) to model paths with jumpTo support\n    if (afterModelNodes.length > 0) {\n      const firstAfterModel = afterModelNodes[0];\n      const firstAfterModelNode = firstAfterModel.name;\n\n      // Include exitNode in the paths since afterModel should be able to route to after_agent or END\n      const modelPaths = this.#getModelPaths(\n        clientTools,\n        true,\n        hasToolsAvailable\n      ).filter((p) => p !== TOOLS_NODE_NAME || hasToolsAvailable);\n\n      const allowJump = Boolean(\n        firstAfterModel.allowed && firstAfterModel.allowed.length > 0\n      );\n\n      // Replace END with exitNode in destinations, since exitNode might be an afterAgent node\n      const destinations = modelPaths.map((p) =>\n        p === END ? exitNode : p\n      ) as BaseGraphDestination[];\n\n      allNodeWorkflows.addConditionalEdges(\n        firstAfterModelNode,\n        this.#createAfterModelRouter(\n          clientTools,\n          allowJump,\n          exitNode,\n          hasToolsAvailable\n        ),\n        destinations\n      );\n    }\n\n    // Connect afterAgent nodes (run once at end, in reverse order like afterModel)\n    for (let i = afterAgentNodes.length - 1; i > 0; i--) {\n      const node = afterAgentNodes[i];\n      const current = node.name;\n      const nextDefault = afterAgentNodes[i - 1].name;\n\n      if (node.allowed && node.allowed.length > 0) {\n        const allowedMapped = node.allowed\n          .map((t) => parseJumpToTarget(t))\n          .filter((dest) => dest !== TOOLS_NODE_NAME || hasToolsAvailable);\n        const destinations = Array.from(\n          new Set([nextDefault, ...allowedMapped])\n        ) as BaseGraphDestination[];\n\n        allNodeWorkflows.addConditionalEdges(\n          current,\n          this.#createAfterModelSequenceRouter(\n            clientTools,\n            node.allowed,\n            nextDefault,\n            hasToolsAvailable\n          ),\n          destinations\n        );\n      } else {\n        allNodeWorkflows.addEdge(current, nextDefault);\n      }\n    }\n\n    // Connect the first afterAgent node (last to execute) to END\n    if (afterAgentNodes.length > 0) {\n      const firstAfterAgent = afterAgentNodes[0];\n      const firstAfterAgentNode = firstAfterAgent.name;\n\n      if (firstAfterAgent.allowed && firstAfterAgent.allowed.length > 0) {\n        const allowedMapped = firstAfterAgent.allowed\n          .map((t) => parseJumpToTarget(t))\n          .filter((dest) => dest !== TOOLS_NODE_NAME || hasToolsAvailable);\n\n        /**\n         * For after_agent, only use explicitly allowed destinations (don't add loopEntryNode)\n         * The default destination (when no jump occurs) should be END\n         */\n        const destinations = Array.from(\n          new Set([END, ...allowedMapped])\n        ) as BaseGraphDestination[];\n\n        allNodeWorkflows.addConditionalEdges(\n          firstAfterAgentNode,\n          this.#createAfterModelSequenceRouter(\n            clientTools,\n            firstAfterAgent.allowed,\n            END as string,\n            hasToolsAvailable\n          ),\n          destinations\n        );\n      } else {\n        allNodeWorkflows.addEdge(firstAfterAgentNode, END);\n      }\n    }\n\n    /**\n     * add edges for tools node (includes both registered tools and dynamic tools via middleware)\n     */\n    if (hasToolsAvailable) {\n      // Tools should return to loop entry node (not including before_agent)\n      const toolReturnTarget = loopEntryNode;\n\n      if (shouldReturnDirect.size > 0) {\n        allNodeWorkflows.addConditionalEdges(\n          TOOLS_NODE_NAME,\n          this.#createToolsRouter(\n            shouldReturnDirect,\n            exitNode,\n            toolReturnTarget\n          ),\n          [toolReturnTarget, exitNode as string]\n        );\n      } else {\n        allNodeWorkflows.addEdge(TOOLS_NODE_NAME, toolReturnTarget);\n      }\n    }\n\n    /**\n     * compile the graph\n     */\n    this.#graph = allNodeWorkflows.compile({\n      checkpointer: this.options.checkpointer,\n      store: this.options.store,\n      name: this.options.name,\n      description: this.options.description,\n    }) as unknown as AgentGraph<Types>;\n  }\n\n  /**\n   * Get the compiled {@link https://docs.langchain.com/oss/javascript/langgraph/use-graph-api | StateGraph}.\n   */\n  get graph(): AgentGraph<Types> {\n    return this.#graph;\n  }\n\n  get checkpointer(): BaseCheckpointSaver | boolean | undefined {\n    return this.#graph.checkpointer;\n  }\n\n  set checkpointer(value: BaseCheckpointSaver | boolean | undefined) {\n    this.#graph.checkpointer = value;\n  }\n\n  get store(): BaseStore | undefined {\n    return this.#graph.store;\n  }\n\n  set store(value: BaseStore | undefined) {\n    this.#graph.store = value;\n  }\n\n  /**\n   * Creates a new ReactAgent with the given config merged into the existing config.\n   * Follows the same pattern as LangGraph's Pregel.withConfig().\n   *\n   * The merged config is applied as a default that gets merged with any config\n   * passed at invocation time (invoke/stream). Invocation-time config takes precedence.\n   *\n   * @param config - Configuration to merge with existing config\n   * @returns A new ReactAgent instance with the merged configuration\n   *\n   * @example\n   * ```typescript\n   * const agent = createAgent({ model: \"gpt-4o\", tools: [...] });\n   *\n   * // Set a default recursion limit\n   * const configuredAgent = agent.withConfig({ recursionLimit: 1000 });\n   *\n   * // Chain multiple configs\n   * const debugAgent = agent\n   *   .withConfig({ recursionLimit: 1000 })\n   *   .withConfig({ tags: [\"debug\"] });\n   * ```\n   */\n  withConfig(\n    config: Omit<RunnableConfig, \"store\" | \"writer\" | \"interrupt\">\n  ): ReactAgent<Types> {\n    return new ReactAgent(\n      this.options,\n      mergeConfigs(this.#defaultConfig, config)\n    );\n  }\n\n  /**\n   * Get possible edge destinations from model node.\n   * @param toolClasses names of tools to call\n   * @param includeModelRequest whether to include \"model_request\" as a valid path (for jumpTo routing)\n   * @param hasToolsAvailable whether tools are available (includes dynamic tools via middleware)\n   * @returns list of possible edge destinations\n   */\n  #getModelPaths(\n    toolClasses: (ClientTool | ServerTool)[],\n    includeModelRequest: boolean = false,\n    hasToolsAvailable: boolean = toolClasses.length > 0\n  ): BaseGraphDestination[] {\n    const paths: BaseGraphDestination[] = [];\n    if (hasToolsAvailable) {\n      paths.push(TOOLS_NODE_NAME);\n    }\n\n    if (includeModelRequest) {\n      paths.push(AGENT_NODE_NAME);\n    }\n\n    paths.push(END);\n\n    return paths;\n  }\n\n  /**\n   * Create routing function for tools node conditional edges.\n   */\n  #createToolsRouter(\n    shouldReturnDirect: Set<string>,\n    exitNode: string | typeof END,\n    toolReturnTarget: string\n  ) {\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as BuiltInState;\n      const messages = builtInState.messages;\n      const lastMessage = messages[messages.length - 1];\n\n      // Check if we just executed a returnDirect tool\n      if (\n        ToolMessage.isInstance(lastMessage) &&\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 to exit node (could be after_agent or END)\n        return this.options.responseFormat ? toolReturnTarget : exitNode;\n      }\n\n      // For non-returnDirect tools, route back to loop entry node (could be middleware or agent)\n      return toolReturnTarget;\n    };\n  }\n\n  /**\n   * Create routing function for model node conditional edges.\n   * @param exitNode - The exit node to route to (could be after_agent or END)\n   */\n  #createModelRouter(exitNode: string | typeof END = END) {\n    /**\n     * determine if the agent should continue or not\n     */\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as BuiltInState;\n      const messages = builtInState.messages;\n      const lastMessage = messages.at(-1);\n\n      if (\n        !AIMessage.isInstance(lastMessage) ||\n        !lastMessage.tool_calls ||\n        lastMessage.tool_calls.length === 0\n      ) {\n        return exitNode;\n      }\n\n      // Check if all tool calls are for structured response extraction\n      const hasOnlyStructuredResponseCalls = lastMessage.tool_calls.every(\n        (toolCall) => toolCall.name.startsWith(\"extract-\")\n      );\n\n      if (hasOnlyStructuredResponseCalls) {\n        // If all tool calls are for structured response extraction, go to exit node\n        // The AgentNode will handle these internally and return the structured response\n        return exitNode;\n      }\n\n      /**\n       * The tool node processes a single message.\n       */\n      if (this.#toolBehaviorVersion === \"v1\") {\n        return TOOLS_NODE_NAME;\n      }\n\n      /**\n       * Route to tools node (filter out any structured response tool calls)\n       */\n      const regularToolCalls = lastMessage.tool_calls.filter(\n        (toolCall) => !toolCall.name.startsWith(\"extract-\")\n      );\n\n      if (regularToolCalls.length === 0) {\n        return exitNode;\n      }\n\n      return regularToolCalls.map(\n        (toolCall) =>\n          new Send(TOOLS_NODE_NAME, { ...state, lg_tool_call: toolCall })\n      );\n    };\n  }\n\n  /**\n   * Create routing function for jumpTo functionality after afterModel hooks.\n   *\n   * This router checks if the `jumpTo` property is set in the state after afterModel middleware\n   * execution. If set, it routes to the specified target (\"model_request\" or \"tools\").\n   * If not set, it falls back to the normal model routing logic for afterModel context.\n   *\n   * The jumpTo property is automatically cleared after use to prevent infinite loops.\n   *\n   * @param toolClasses - Available tool classes for validation\n   * @param allowJump - Whether jumping is allowed\n   * @param exitNode - The exit node to route to (could be after_agent or END)\n   * @param hasToolsAvailable - Whether tools are available (includes dynamic tools via middleware)\n   * @returns Router function that handles jumpTo logic and normal routing\n   */\n  #createAfterModelRouter(\n    toolClasses: (ClientTool | ServerTool)[],\n    allowJump: boolean,\n    exitNode: string | typeof END,\n    hasToolsAvailable: boolean = toolClasses.length > 0\n  ) {\n    const hasStructuredResponse = Boolean(this.options.responseFormat);\n\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as Omit<BuiltInState, \"jumpTo\"> & {\n        jumpTo?: JumpTo;\n      };\n      // First, check if we just processed a structured response\n      // If so, ignore any existing jumpTo and go to exitNode\n      const messages = builtInState.messages;\n      const lastMessage = messages.at(-1);\n      if (\n        AIMessage.isInstance(lastMessage) &&\n        (!lastMessage.tool_calls || lastMessage.tool_calls.length === 0)\n      ) {\n        return exitNode;\n      }\n\n      // Check if jumpTo is set in the state and allowed\n      if (allowJump && builtInState.jumpTo) {\n        const destination = parseJumpToTarget(builtInState.jumpTo);\n        if (destination === END) {\n          return exitNode;\n        }\n        if (destination === TOOLS_NODE_NAME) {\n          // If trying to jump to tools but no tools are available, go to exitNode\n          if (!hasToolsAvailable) {\n            return exitNode;\n          }\n          return new Send(TOOLS_NODE_NAME, { ...state, jumpTo: undefined });\n        }\n        // destination === \"model_request\"\n        return new Send(AGENT_NODE_NAME, { ...state, jumpTo: undefined });\n      }\n\n      // check if there are pending tool calls\n      const toolMessages = messages.filter(ToolMessage.isInstance);\n      const lastAiMessage = messages.filter(AIMessage.isInstance).at(-1);\n      const pendingToolCalls = lastAiMessage?.tool_calls?.filter(\n        (call) => !toolMessages.some((m) => m.tool_call_id === call.id)\n      );\n      if (pendingToolCalls && pendingToolCalls.length > 0) {\n        /**\n         * v1: route the full message to the ToolNode; it filters already-processed\n         * calls internally and runs the remaining ones via Promise.all.\n         * v2: dispatch each pending call as a separate Send task.\n         */\n        if (this.#toolBehaviorVersion === \"v1\") {\n          return TOOLS_NODE_NAME;\n        }\n        return pendingToolCalls.map(\n          (toolCall) =>\n            new Send(TOOLS_NODE_NAME, { ...state, lg_tool_call: toolCall })\n        );\n      }\n\n      // if we exhausted all tool calls, but still have no structured response tool calls,\n      // go back to model_request\n      const hasStructuredResponseCalls = lastAiMessage?.tool_calls?.some(\n        (toolCall) => toolCall.name.startsWith(\"extract-\")\n      );\n\n      if (\n        pendingToolCalls &&\n        pendingToolCalls.length === 0 &&\n        !hasStructuredResponseCalls &&\n        hasStructuredResponse\n      ) {\n        return AGENT_NODE_NAME;\n      }\n\n      if (\n        !AIMessage.isInstance(lastMessage) ||\n        !lastMessage.tool_calls ||\n        lastMessage.tool_calls.length === 0\n      ) {\n        return exitNode;\n      }\n\n      // Check if all tool calls are for structured response extraction\n      const hasOnlyStructuredResponseCalls = lastMessage.tool_calls.every(\n        (toolCall) => toolCall.name.startsWith(\"extract-\")\n      );\n\n      // Check if there are any regular tool calls (non-structured response)\n      const hasRegularToolCalls = lastMessage.tool_calls.some(\n        (toolCall) => !toolCall.name.startsWith(\"extract-\")\n      );\n\n      if (hasOnlyStructuredResponseCalls || !hasRegularToolCalls) {\n        return exitNode;\n      }\n\n      /**\n       * v1: route the full AIMessage to a single ToolNode invocation so all\n       * tool calls run concurrently via Promise.all.\n       *\n       * v2: dispatch each regular tool call as a separate Send task, matching\n       * the behaviour of #createModelRouter when no afterModel middleware is\n       * present.\n       */\n      if (this.#toolBehaviorVersion === \"v1\") {\n        return TOOLS_NODE_NAME;\n      }\n\n      const regularToolCalls = (lastMessage as AIMessage).tool_calls!.filter(\n        (toolCall) => !toolCall.name.startsWith(\"extract-\")\n      );\n\n      if (regularToolCalls.length === 0) {\n        return exitNode;\n      }\n\n      return regularToolCalls.map(\n        (toolCall) =>\n          new Send(TOOLS_NODE_NAME, { ...state, lg_tool_call: toolCall })\n      );\n    };\n  }\n\n  /**\n   * Router for afterModel sequence nodes (connecting later middlewares to earlier ones),\n   * honoring allowed jump targets and defaulting to the next node.\n   * @param toolClasses - Available tool classes for validation\n   * @param allowed - List of allowed jump targets\n   * @param nextDefault - Default node to route to\n   * @param hasToolsAvailable - Whether tools are available (includes dynamic tools via middleware)\n   */\n  #createAfterModelSequenceRouter(\n    toolClasses: (ClientTool | ServerTool)[],\n    allowed: string[],\n    nextDefault: string,\n    hasToolsAvailable: boolean = toolClasses.length > 0\n  ) {\n    const allowedSet = new Set(allowed.map((t) => parseJumpToTarget(t)));\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as BuiltInState;\n      if (builtInState.jumpTo) {\n        const dest = parseJumpToTarget(builtInState.jumpTo);\n        if (dest === END && allowedSet.has(END)) {\n          return END;\n        }\n        if (dest === TOOLS_NODE_NAME && allowedSet.has(TOOLS_NODE_NAME)) {\n          if (!hasToolsAvailable) return END;\n          return new Send(TOOLS_NODE_NAME, { ...state, jumpTo: undefined });\n        }\n        if (dest === AGENT_NODE_NAME && allowedSet.has(AGENT_NODE_NAME)) {\n          return new Send(AGENT_NODE_NAME, { ...state, jumpTo: undefined });\n        }\n      }\n      return nextDefault;\n    };\n  }\n\n  /**\n   * Create routing function for jumpTo functionality after beforeAgent hooks.\n   * Falls back to the default next node if no jumpTo is present.\n   * When jumping to END, routes to exitNode (which could be an afterAgent node).\n   * @param toolClasses - Available tool classes for validation\n   * @param nextDefault - Default node to route to\n   * @param exitNode - Exit node to route to (could be after_agent or END)\n   * @param hasToolsAvailable - Whether tools are available (includes dynamic tools via middleware)\n   */\n  #createBeforeAgentRouter(\n    toolClasses: (ClientTool | ServerTool)[],\n    nextDefault: string,\n    exitNode: string | typeof END,\n    hasToolsAvailable: boolean = toolClasses.length > 0\n  ) {\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as BuiltInState;\n      if (!builtInState.jumpTo) {\n        return nextDefault;\n      }\n      const destination = parseJumpToTarget(builtInState.jumpTo);\n      if (destination === END) {\n        /**\n         * When beforeAgent jumps to END, route to exitNode (first afterAgent node)\n         */\n        return exitNode;\n      }\n      if (destination === TOOLS_NODE_NAME) {\n        if (!hasToolsAvailable) {\n          return exitNode;\n        }\n        return new Send(TOOLS_NODE_NAME, { ...state, jumpTo: undefined });\n      }\n      return new Send(AGENT_NODE_NAME, { ...state, jumpTo: undefined });\n    };\n  }\n\n  /**\n   * Create routing function for jumpTo functionality after beforeModel hooks.\n   * Falls back to the default next node if no jumpTo is present.\n   * @param toolClasses - Available tool classes for validation\n   * @param nextDefault - Default node to route to\n   * @param hasToolsAvailable - Whether tools are available (includes dynamic tools via middleware)\n   */\n  #createBeforeModelRouter(\n    toolClasses: (ClientTool | ServerTool)[],\n    nextDefault: string,\n    hasToolsAvailable: boolean = toolClasses.length > 0\n  ) {\n    return (state: Record<string, unknown>) => {\n      const builtInState = state as unknown as BuiltInState;\n      if (!builtInState.jumpTo) {\n        return nextDefault;\n      }\n      const destination = parseJumpToTarget(builtInState.jumpTo);\n      if (destination === END) {\n        return END;\n      }\n      if (destination === TOOLS_NODE_NAME) {\n        if (!hasToolsAvailable) {\n          return END;\n        }\n        return new Send(TOOLS_NODE_NAME, { ...state, jumpTo: undefined });\n      }\n      return new Send(AGENT_NODE_NAME, { ...state, jumpTo: undefined });\n    };\n  }\n\n  /**\n   * Initialize middleware states if not already present in the input state.\n   */\n  async #initializeMiddlewareStates(\n    state: InvokeStateParameter<Types>,\n    config: RunnableConfig\n  ): Promise<InvokeStateParameter<Types>> {\n    if (\n      !this.options.middleware ||\n      this.options.middleware.length === 0 ||\n      state instanceof Command ||\n      !state\n    ) {\n      return state;\n    }\n\n    const defaultStates = await initializeMiddlewareStates(\n      this.options.middleware,\n      state\n    );\n    const threadState = await this.#graph\n      .getState(config)\n      .catch(() => ({ values: {} }));\n    const updatedState = {\n      ...threadState.values,\n      ...state,\n    } as InvokeStateParameter<Types>;\n    if (!updatedState) {\n      return updatedState;\n    }\n\n    // Only add defaults for keys that don't exist in current state\n    for (const [key, value] of Object.entries(defaultStates)) {\n      if (!(key in updatedState)) {\n        updatedState[key as keyof typeof updatedState] = value;\n      }\n    }\n\n    return updatedState;\n  }\n\n  /**\n   * Executes the agent with the given state and returns the final state after all processing.\n   *\n   * This method runs the agent's entire workflow synchronously, including:\n   * - Processing the input messages through any configured middleware\n   * - Calling the language model to generate responses\n   * - Executing any tool calls made by the model\n   * - Running all middleware hooks (beforeModel, afterModel, etc.)\n   *\n   * @param state - The initial state for the agent execution. Can be:\n   *   - An object containing `messages` array and any middleware-specific state properties\n   *   - A Command object for more advanced control flow\n   *\n   * @param config - Optional runtime configuration including:\n   * @param config.context - The context for the agent execution.\n   * @param config.configurable - LangGraph configuration options like `thread_id`, `run_id`, etc.\n   * @param config.store - The store for the agent execution for persisting state, see more in {@link https://docs.langchain.com/oss/javascript/langgraph/memory#memory-storage | Memory storage}.\n   * @param config.signal - An optional {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | `AbortSignal`} for the agent execution.\n   * @param config.recursionLimit - The recursion limit for the agent execution.\n   *\n   * @returns A Promise that resolves to the final agent state after execution completes.\n   *          The returned state includes:\n   *          - a `messages` property containing an array with all messages (input, AI responses, tool calls/results)\n   *          - a `structuredResponse` property containing the structured response (if configured)\n   *          - all state values defined in the middleware\n   *\n   * @example\n   * ```typescript\n   * const agent = new ReactAgent({\n   *   llm: myModel,\n   *   tools: [calculator, webSearch],\n   *   responseFormat: z.object({\n   *     weather: z.string(),\n   *   }),\n   * });\n   *\n   * const result = await agent.invoke({\n   *   messages: [{ role: \"human\", content: \"What's the weather in Paris?\" }]\n   * });\n   *\n   * console.log(result.structuredResponse.weather); // outputs: \"It's sunny and 75°F.\"\n   * ```\n   */\n  async invoke(\n    state: InvokeStateParameter<Types>,\n    config?: InvokeConfiguration<\n      InferContextInput<\n        Types[\"Context\"] extends AnyAnnotationRoot | InteropZodObject\n          ? Types[\"Context\"]\n          : AnyAnnotationRoot\n      > &\n        InferMiddlewareContextInputs<Types[\"Middleware\"]>\n    >\n  ) {\n    type FullState = MergedAgentState<Types>;\n    const mergedConfig = mergeConfigs(this.#defaultConfig, config);\n    const initializedState = await this.#initializeMiddlewareStates(\n      state,\n      mergedConfig as RunnableConfig\n    );\n\n    return this.#graph.invoke(\n      initializedState,\n      mergedConfig as unknown as InferContextInput<\n        Types[\"Context\"] extends AnyAnnotationRoot | InteropZodObject\n          ? Types[\"Context\"]\n          : AnyAnnotationRoot\n      > &\n        InferMiddlewareContextInputs<Types[\"Middleware\"]>\n    ) as Promise<FullState>;\n  }\n\n  /**\n   * Executes the agent with streaming, returning an async iterable of state updates as they occur.\n   *\n   * This method runs the agent's workflow similar to `invoke`, but instead of waiting for\n   * completion, it streams high-level state updates in real-time. This allows you to:\n   * - Display intermediate results to users as they're generated\n   * - Monitor the agent's progress through each step\n   * - React to state changes as nodes complete\n   *\n   * For more granular event-level streaming (like individual LLM tokens), use `streamEvents` instead.\n   *\n   * @param state - The initial state for the agent execution. Can be:\n   *   - An object containing `messages` array and any middleware-specific state properties\n   *   - A Command object for more advanced control flow\n   *\n   * @param config - Optional runtime configuration including:\n   * @param config.context - The context for the agent execution.\n   * @param config.configurable - LangGraph configuration options like `thread_id`, `run_id`, etc.\n   * @param config.store - The store for the agent execution for persisting state, see more in {@link https://docs.langchain.com/oss/javascript/langgraph/memory#memory-storage | Memory storage}.\n   * @param config.signal - An optional {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | `AbortSignal`} for the agent execution.\n   * @param config.streamMode - The streaming mode for the agent execution, see more in {@link https://docs.langchain.com/oss/javascript/langgraph/streaming#supported-stream-modes | Supported stream modes}.\n   * @param config.recursionLimit - The recursion limit for the agent execution.\n   *\n   * @returns A Promise that resolves to an IterableReadableStream of state updates.\n   *          Each update contains the current state after a node completes.\n   *\n   * @example\n   * ```typescript\n   * const agent = new ReactAgent({\n   *   llm: myModel,\n   *   tools: [calculator, webSearch]\n   * });\n   *\n   * const stream = await agent.stream({\n   *   messages: [{ role: \"human\", content: \"What's 2+2 and the weather in NYC?\" }]\n   * });\n   *\n   * for await (const chunk of stream) {\n   *   console.log(chunk); // State update from each node\n   * }\n   * ```\n   */\n  async stream<\n    TStreamMode extends StreamMode | StreamMode[] | undefined,\n    TSubgraphs extends boolean,\n    TEncoding extends \"text/event-stream\" | undefined,\n  >(\n    state: InvokeStateParameter<Types>,\n    config?: StreamConfiguration<\n      InferContextInput<\n        Types[\"Context\"] extends AnyAnnotationRoot | InteropZodObject\n          ? Types[\"Context\"]\n          : AnyAnnotationRoot\n      > &\n        InferMiddlewareContextInputs<Types[\"Middleware\"]>,\n      TStreamMode,\n      TSubgraphs,\n      TEncoding\n    >\n  ) {\n    const mergedConfig = mergeConfigs(this.#defaultConfig, config);\n    const initializedState = await this.#initializeMiddlewareStates(\n      state,\n      mergedConfig as RunnableConfig\n    );\n    return this.#graph.stream(\n      initializedState,\n      mergedConfig as Record<string, any>\n    ) as Promise<\n      IterableReadableStream<\n        StreamOutputMap<\n          TStreamMode,\n          TSubgraphs,\n          MergedAgentState<Types>,\n          MergedAgentState<Types>,\n          string,\n          unknown,\n          unknown,\n          TEncoding\n        >\n      >\n    >;\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  /**\n   * The following are internal methods to enable support for LangGraph Platform.\n   * They are not part of the createAgent public API.\n   *\n   * Note: we intentionally return as `never` to avoid type errors due to type inference.\n   */\n\n  /**\n   * @internal\n   */\n  streamEvents(\n    state: InvokeStateParameter<Types>,\n    config?: StreamConfiguration<\n      InferContextInput<\n        Types[\"Context\"] extends AnyAnnotationRoot | InteropZodObject\n          ? Types[\"Context\"]\n          : AnyAnnotationRoot\n      > &\n        InferMiddlewareContextInputs<Types[\"Middleware\"]>,\n      StreamMode | StreamMode[] | undefined,\n      boolean,\n      \"text/event-stream\" | undefined\n    > & { version?: \"v1\" | \"v2\" },\n    streamOptions?: Parameters<Runnable[\"streamEvents\"]>[2]\n  ): IterableReadableStream<StreamEvent> {\n    const mergedConfig = mergeConfigs(this.#defaultConfig, config);\n    return this.#graph.streamEvents(\n      state,\n      {\n        ...(mergedConfig as Partial<\n          PregelOptions<\n            any,\n            any,\n            any,\n            StreamMode | StreamMode[] | undefined,\n            boolean,\n            \"text/event-stream\"\n          >\n        >),\n        version: config?.version ?? \"v2\",\n      },\n      streamOptions\n    );\n  }\n  /**\n   * @internal\n   */\n  getGraphAsync(config?: RunnableConfig) {\n    return this.#graph.getGraphAsync(config) as never;\n  }\n  /**\n   * @internal\n   */\n  getState(config: RunnableConfig, options?: GetStateOptions) {\n    return this.#graph.getState(config, options) as never;\n  }\n  /**\n   * @internal\n   */\n  getStateHistory(config: RunnableConfig, options?: CheckpointListOptions) {\n    return this.#graph.getStateHistory(config, options) as never;\n  }\n  /**\n   * @internal\n   */\n  getSubgraphs(namespace?: string, recurse?: boolean) {\n    return this.#graph.getSubgraphs(namespace, recurse) as never;\n  }\n  /**\n   * @internal\n   */\n  getSubgraphsAsync(namespace?: string, recurse?: boolean) {\n    return this.#graph.getSubgraphsAsync(namespace, recurse) as never;\n  }\n  /**\n   * @internal\n   */\n  updateState(\n    inputConfig: LangGraphRunnableConfig,\n    values: Record<string, unknown> | unknown,\n    asNode?: string\n  ) {\n    return this.#graph.updateState(inputConfig, values, asNode) as never;\n  }\n\n  /**\n   * @internal\n   */\n  get builder() {\n    return this.#graph.builder;\n  }\n}\n"],"mappings":"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"}

package/dist/agents/middleware/summarization.cjs

@@ -9,7 +9,7 @@ let _langchain_langgraph = require("@langchain/langgraph");
 let _langchain_core_utils_types = require("@langchain/core/utils/types");
 let zod_v4 = require("zod/v4");
 let zod_v3 = require("zod/v3");
-let uuid = require("uuid");
+let _langchain_core_utils_uuid = require("@langchain/core/utils/uuid");
 let _langchain_core_language_models_base = require("@langchain/core/language_models/base");
 //#region src/agents/middleware/summarization.ts
 const DEFAULT_SUMMARY_PROMPT = `<role>
@@ -201,7 +201,7 @@ function summarizationMiddleware(options) {
 			const { messagesToSummarize, preservedMessages } = partitionMessages(systemPrompt, conversationMessages, cutoffIndex);
 			const summaryMessage = new _langchain_core_messages.HumanMessage({
 				content: `${summaryPrefix}\n\n${await createSummary(messagesToSummarize, model, summaryPrompt, tokenCounter, trimTokensToSummarize, runtime)}`,
-				id: (0, uuid.v4)(),
+				id: (0, _langchain_core_utils_uuid.v4)(),
 				additional_kwargs: { lc_source: "summarization" }
 			});
 			return { messages: [
@@ -216,7 +216,7 @@ function summarizationMiddleware(options) {
 * Ensure all messages have unique IDs
 */
 function ensureMessageIds(messages) {
-	for (const msg of messages) if (!msg.id) msg.id = (0, uuid.v4)();
+	for (const msg of messages) if (!msg.id) msg.id = (0, _langchain_core_utils_uuid.v4)();
 }
 /**
 * Separate system message from conversation messages

package/dist/agents/middleware/summarization.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"summarization.cjs","names":["z","z4","createMiddleware","initChatModel","countTokensApproximately","HumanMessage","RemoveMessage","REMOVE_ALL_MESSAGES","SystemMessage","AIMessage","hasToolCalls","ToolMessage"],"sources":["../../../src/agents/middleware/summarization.ts"],"sourcesContent":["import { z } from \"zod/v3\";\nimport { z as z4 } from \"zod/v4\";\nimport { v4 as uuid } from \"uuid\";\nimport {\n  BaseMessage,\n  AIMessage,\n  SystemMessage,\n  ToolMessage,\n  RemoveMessage,\n  trimMessages,\n  HumanMessage,\n  getBufferString,\n} from \"@langchain/core/messages\";\nimport {\n  BaseLanguageModel,\n  getModelContextSize,\n} from \"@langchain/core/language_models/base\";\nimport {\n  interopSafeParse,\n  InferInteropZodInput,\n  InferInteropZodOutput,\n} from \"@langchain/core/utils/types\";\nimport {\n  mergeConfigs,\n  pickRunnableConfigKeys,\n  type RunnableConfig,\n} from \"@langchain/core/runnables\";\nimport { REMOVE_ALL_MESSAGES } from \"@langchain/langgraph\";\nimport { createMiddleware } from \"../middleware.js\";\nimport { countTokensApproximately } from \"./utils.js\";\nimport { hasToolCalls } from \"../utils.js\";\nimport { initChatModel } from \"../../chat_models/universal.js\";\nimport type { Runtime } from \"../runtime.js\";\n\nexport const DEFAULT_SUMMARY_PROMPT = `<role>\nContext Extraction Assistant\n</role>\n\n<primary_objective>\nYour sole objective in this task is to extract the highest quality/most relevant context from the conversation history below.\n</primary_objective>\n\n<objective_information>\nYou're nearing the total number of input tokens you can accept, so you must extract the highest quality/most relevant pieces of information from your conversation history.\nThis context will then overwrite the conversation history presented below. Because of this, ensure the context you extract is only the most important information to your overall goal.\n</objective_information>\n\n<instructions>\nThe conversation history below will be replaced with the context you extract in this step. Because of this, you must do your very best to extract and record all of the most important context from the conversation history.\nYou want to ensure that you don't repeat any actions you've already completed, so the context you extract from the conversation history should be focused on the most important information to your overall goal.\n</instructions>\n\nThe user will message you with the full message history you'll be extracting context from, to then replace. Carefully read over it all, and think deeply about what information is most important to your overall goal that should be saved:\n\nWith all of this in mind, please carefully read over the entire conversation history, and extract the most important and relevant context to replace it so that you can free up space in the conversation history.\nRespond ONLY with the extracted context. Do not include any additional information, or text before or after the extracted context.\n\n<messages>\nMessages to summarize:\n{messages}\n</messages>`;\n\nconst DEFAULT_SUMMARY_PREFIX = \"Here is a summary of the conversation to date:\";\nconst DEFAULT_MESSAGES_TO_KEEP = 20;\nconst DEFAULT_TRIM_TOKEN_LIMIT = 4000;\nconst DEFAULT_FALLBACK_MESSAGE_COUNT = 15;\nconst SEARCH_RANGE_FOR_TOOL_PAIRS = 5;\n\nconst tokenCounterSchema = z\n  .function()\n  .args(z.array(z.custom<BaseMessage>()))\n  .returns(z.union([z.number(), z.promise(z.number())]));\nexport type TokenCounter = (\n  messages: BaseMessage[]\n) => number | Promise<number>;\n\nexport const contextSizeSchema = z\n  .object({\n    /**\n     * Fraction of the model's context size to use as the trigger\n     */\n    fraction: z\n      .number()\n      .gt(0, \"Fraction must be greater than 0\")\n      .max(1, \"Fraction must be less than or equal to 1\")\n      .optional(),\n    /**\n     * Number of tokens to use as the trigger\n     */\n    tokens: z.number().positive(\"Tokens must be greater than 0\").optional(),\n    /**\n     * Number of messages to use as the trigger\n     */\n    messages: z\n      .number()\n      .int(\"Messages must be an integer\")\n      .positive(\"Messages must be greater than 0\")\n      .optional(),\n  })\n  .refine(\n    (data) => {\n      const count = [data.fraction, data.tokens, data.messages].filter(\n        (v) => v !== undefined\n      ).length;\n      return count >= 1;\n    },\n    {\n      message: \"At least one of fraction, tokens, or messages must be provided\",\n    }\n  );\nexport type ContextSize = z.infer<typeof contextSizeSchema>;\n\nexport const keepSchema = z\n  .object({\n    /**\n     * Fraction of the model's context size to keep\n     */\n    fraction: z\n      .number()\n      .min(0, \"Messages must be non-negative\")\n      .max(1, \"Fraction must be less than or equal to 1\")\n      .optional(),\n    /**\n     * Number of tokens to keep\n     */\n    tokens: z\n      .number()\n      .min(0, \"Tokens must be greater than or equal to 0\")\n      .optional(),\n    messages: z\n      .number()\n      .int(\"Messages must be an integer\")\n      .min(0, \"Messages must be non-negative\")\n      .optional(),\n  })\n  .refine(\n    (data) => {\n      const count = [data.fraction, data.tokens, data.messages].filter(\n        (v) => v !== undefined\n      ).length;\n      return count === 1;\n    },\n    {\n      message: \"Exactly one of fraction, tokens, or messages must be provided\",\n    }\n  );\nexport type KeepSize = z.infer<typeof keepSchema>;\n\nconst contextSchema = z.object({\n  /**\n   * Model to use for summarization\n   */\n  model: z.custom<string | BaseLanguageModel>(),\n  /**\n   * Trigger conditions for summarization.\n   * Can be a single condition object (all properties must be met) or an array of conditions (any condition must be met).\n   *\n   * @example\n   * ```ts\n   * // Single condition: trigger if tokens >= 5000 AND messages >= 3\n   * trigger: { tokens: 5000, messages: 3 }\n   *\n   * // Multiple conditions: trigger if (tokens >= 5000 AND messages >= 3) OR (tokens >= 3000 AND messages >= 6)\n   * trigger: [\n   *   { tokens: 5000, messages: 3 },\n   *   { tokens: 3000, messages: 6 }\n   * ]\n   * ```\n   */\n  trigger: z.union([contextSizeSchema, z.array(contextSizeSchema)]).optional(),\n  /**\n   * Keep conditions for summarization\n   */\n  keep: keepSchema.optional(),\n  /**\n   * Token counter function to use for summarization\n   */\n  tokenCounter: tokenCounterSchema.optional(),\n  /**\n   * Summary prompt to use for summarization\n   * @default {@link DEFAULT_SUMMARY_PROMPT}\n   */\n  summaryPrompt: z.string().default(DEFAULT_SUMMARY_PROMPT),\n  /**\n   * Number of tokens to trim to before summarizing\n   */\n  trimTokensToSummarize: z.number().optional(),\n  /**\n   * Prefix to add to the summary\n   */\n  summaryPrefix: z.string().optional(),\n  /**\n   * @deprecated Use `trigger: { tokens: value }` instead.\n   */\n  maxTokensBeforeSummary: z.number().optional(),\n  /**\n   * @deprecated Use `keep: { messages: value }` instead.\n   */\n  messagesToKeep: z.number().optional(),\n});\n\nexport type SummarizationMiddlewareConfig = InferInteropZodInput<\n  typeof contextSchema\n>;\n\n/**\n * Get max input tokens from model profile or fallback to model name lookup\n */\nexport function getProfileLimits(input: BaseLanguageModel): number | undefined {\n  // Access maxInputTokens on the model profile directly if available\n  if (\n    \"profile\" in input &&\n    typeof input.profile === \"object\" &&\n    input.profile &&\n    \"maxInputTokens\" in input.profile &&\n    (typeof input.profile.maxInputTokens === \"number\" ||\n      input.profile.maxInputTokens == null)\n  ) {\n    return input.profile.maxInputTokens ?? undefined;\n  }\n\n  // Fallback to using model name if available\n  if (\"model\" in input && typeof input.model === \"string\") {\n    return getModelContextSize(input.model);\n  }\n  if (\"modelName\" in input && typeof input.modelName === \"string\") {\n    return getModelContextSize(input.modelName);\n  }\n\n  return undefined;\n}\n\n/**\n * Summarization middleware that automatically summarizes conversation history when token limits are approached.\n *\n * This middleware monitors message token counts and automatically summarizes older\n * messages when a threshold is reached, preserving recent messages and maintaining\n * context continuity by ensuring AI/Tool message pairs remain together.\n *\n * @param options Configuration options for the summarization middleware\n * @returns A middleware instance\n *\n * @example\n * ```ts\n * import { summarizationMiddleware } from \"langchain\";\n * import { createAgent } from \"langchain\";\n *\n * // Single condition: trigger if tokens >= 4000 AND messages >= 10\n * const agent1 = createAgent({\n *   llm: model,\n *   tools: [getWeather],\n *   middleware: [\n *     summarizationMiddleware({\n *       model: new ChatOpenAI({ model: \"gpt-4o\" }),\n *       trigger: { tokens: 4000, messages: 10 },\n *       keep: { messages: 20 },\n *     })\n *   ],\n * });\n *\n * // Multiple conditions: trigger if (tokens >= 5000 AND messages >= 3) OR (tokens >= 3000 AND messages >= 6)\n * const agent2 = createAgent({\n *   llm: model,\n *   tools: [getWeather],\n *   middleware: [\n *     summarizationMiddleware({\n *       model: new ChatOpenAI({ model: \"gpt-4o\" }),\n *       trigger: [\n *         { tokens: 5000, messages: 3 },\n *         { tokens: 3000, messages: 6 },\n *       ],\n *       keep: { messages: 20 },\n *     })\n *   ],\n * });\n *\n * ```\n */\nexport function summarizationMiddleware(\n  options: SummarizationMiddlewareConfig\n) {\n  /**\n   * Parse user options to get their explicit values\n   */\n  const { data: userOptions, error } = interopSafeParse(contextSchema, options);\n  if (error) {\n    throw new Error(\n      `Invalid summarization middleware options: ${z4.prettifyError(error)}`\n    );\n  }\n\n  return createMiddleware({\n    name: \"SummarizationMiddleware\",\n    contextSchema: contextSchema.extend({\n      /**\n       * `model` should be required when initializing the middleware,\n       * but can be omitted within context when invoking the middleware.\n       */\n      model: z.custom<BaseLanguageModel>().optional(),\n    }),\n    beforeModel: async (state, runtime) => {\n      let trigger: ContextSize | ContextSize[] | undefined =\n        userOptions.trigger;\n      let keep: ContextSize = userOptions.keep as InferInteropZodOutput<\n        typeof keepSchema\n      >;\n\n      /**\n       * Handle deprecated parameters\n       */\n      if (userOptions.maxTokensBeforeSummary !== undefined) {\n        console.warn(\n          \"maxTokensBeforeSummary is deprecated. Use `trigger: { tokens: value }` instead.\"\n        );\n        if (trigger === undefined) {\n          trigger = { tokens: userOptions.maxTokensBeforeSummary };\n        }\n      }\n\n      /**\n       * Handle deprecated parameters\n       */\n      if (userOptions.messagesToKeep !== undefined) {\n        console.warn(\n          \"messagesToKeep is deprecated. Use `keep: { messages: value }` instead.\"\n        );\n        if (\n          !keep ||\n          (keep &&\n            \"messages\" in keep &&\n            keep.messages === DEFAULT_MESSAGES_TO_KEEP)\n        ) {\n          keep = { messages: userOptions.messagesToKeep };\n        }\n      }\n\n      /**\n       * Merge context with user options\n       */\n      const resolvedTrigger =\n        runtime.context?.trigger !== undefined\n          ? runtime.context.trigger\n          : trigger;\n      const resolvedKeep =\n        runtime.context?.keep !== undefined\n          ? runtime.context.keep\n          : (keep ?? { messages: DEFAULT_MESSAGES_TO_KEEP });\n\n      const validatedKeep = keepSchema.parse(resolvedKeep);\n\n      /**\n       * Validate trigger conditions\n       */\n      let triggerConditions: ContextSize[] = [];\n      if (resolvedTrigger === undefined) {\n        triggerConditions = [];\n      } else if (Array.isArray(resolvedTrigger)) {\n        /**\n         * It's an array of ContextSize objects\n         */\n        triggerConditions = (resolvedTrigger as ContextSize[]).map((t) =>\n          contextSizeSchema.parse(t)\n        );\n      } else {\n        /**\n         * Single ContextSize object - all properties must be satisfied (AND logic)\n         */\n        triggerConditions = [contextSizeSchema.parse(resolvedTrigger)];\n      }\n\n      /**\n       * Check if profile is required\n       */\n      const requiresProfile =\n        triggerConditions.some((c) => \"fraction\" in c) ||\n        \"fraction\" in validatedKeep;\n\n      const model =\n        typeof userOptions.model === \"string\"\n          ? await initChatModel(userOptions.model)\n          : userOptions.model;\n\n      if (requiresProfile && !getProfileLimits(model)) {\n        throw new Error(\n          \"Model profile information is required to use fractional token limits. \" +\n            \"Use absolute token counts instead.\"\n        );\n      }\n\n      const summaryPrompt =\n        runtime.context?.summaryPrompt === DEFAULT_SUMMARY_PROMPT\n          ? (userOptions.summaryPrompt ?? DEFAULT_SUMMARY_PROMPT)\n          : (runtime.context?.summaryPrompt ??\n            userOptions.summaryPrompt ??\n            DEFAULT_SUMMARY_PROMPT);\n      const summaryPrefix =\n        runtime.context.summaryPrefix ??\n        userOptions.summaryPrefix ??\n        DEFAULT_SUMMARY_PREFIX;\n      const trimTokensToSummarize =\n        runtime.context?.trimTokensToSummarize !== undefined\n          ? runtime.context.trimTokensToSummarize\n          : (userOptions.trimTokensToSummarize ?? DEFAULT_TRIM_TOKEN_LIMIT);\n\n      /**\n       * Ensure all messages have IDs\n       */\n      ensureMessageIds(state.messages);\n\n      const tokenCounter =\n        runtime.context?.tokenCounter !== undefined\n          ? runtime.context.tokenCounter\n          : (userOptions.tokenCounter ?? countTokensApproximately);\n      const totalTokens = await tokenCounter(state.messages);\n      const doSummarize = await shouldSummarize(\n        state.messages,\n        totalTokens,\n        triggerConditions,\n        model\n      );\n\n      if (!doSummarize) {\n        return;\n      }\n\n      const { systemPrompt, conversationMessages } = splitSystemMessage(\n        state.messages\n      );\n      const cutoffIndex = await determineCutoffIndex(\n        conversationMessages,\n        validatedKeep,\n        tokenCounter,\n        model\n      );\n\n      if (cutoffIndex <= 0) {\n        return;\n      }\n\n      const { messagesToSummarize, preservedMessages } = partitionMessages(\n        systemPrompt,\n        conversationMessages,\n        cutoffIndex\n      );\n\n      const summary = await createSummary(\n        messagesToSummarize,\n        model,\n        summaryPrompt,\n        tokenCounter,\n        trimTokensToSummarize,\n        runtime\n      );\n\n      const summaryMessage = new HumanMessage({\n        content: `${summaryPrefix}\\n\\n${summary}`,\n        id: uuid(),\n        additional_kwargs: { lc_source: \"summarization\" },\n      });\n\n      return {\n        messages: [\n          new RemoveMessage({ id: REMOVE_ALL_MESSAGES }),\n          summaryMessage,\n          ...preservedMessages,\n        ],\n      };\n    },\n  });\n}\n\n/**\n * Ensure all messages have unique IDs\n */\nfunction ensureMessageIds(messages: BaseMessage[]): void {\n  for (const msg of messages) {\n    if (!msg.id) {\n      msg.id = uuid();\n    }\n  }\n}\n\n/**\n * Separate system message from conversation messages\n */\nfunction splitSystemMessage(messages: BaseMessage[]): {\n  systemPrompt?: SystemMessage;\n  conversationMessages: BaseMessage[];\n} {\n  if (messages.length > 0 && SystemMessage.isInstance(messages[0])) {\n    return {\n      systemPrompt: messages[0] as SystemMessage,\n      conversationMessages: messages.slice(1),\n    };\n  }\n  return {\n    conversationMessages: messages,\n  };\n}\n\n/**\n * Partition messages into those to summarize and those to preserve\n */\nfunction partitionMessages(\n  systemPrompt: SystemMessage | undefined,\n  conversationMessages: BaseMessage[],\n  cutoffIndex: number\n): { messagesToSummarize: BaseMessage[]; preservedMessages: BaseMessage[] } {\n  const messagesToSummarize = conversationMessages.slice(0, cutoffIndex);\n  const preservedMessages = conversationMessages.slice(cutoffIndex);\n\n  // Include system message in messages to summarize to capture previous summaries\n  if (systemPrompt) {\n    messagesToSummarize.unshift(systemPrompt);\n  }\n\n  return { messagesToSummarize, preservedMessages };\n}\n\n/**\n * Determine whether summarization should run for the current token usage\n *\n * @param messages - Current messages in the conversation\n * @param totalTokens - Total token count for all messages\n * @param triggerConditions - Array of trigger conditions. Returns true if ANY condition is satisfied (OR logic).\n *                           Within each condition, ALL specified properties must be satisfied (AND logic).\n * @param model - The language model being used\n * @returns true if summarization should be triggered\n */\nasync function shouldSummarize(\n  messages: BaseMessage[],\n  totalTokens: number,\n  triggerConditions: ContextSize[],\n  model: BaseLanguageModel\n): Promise<boolean> {\n  if (triggerConditions.length === 0) {\n    return false;\n  }\n\n  /**\n   * Check each condition (OR logic between conditions)\n   */\n  for (const trigger of triggerConditions) {\n    /**\n     * Within a single condition, all specified properties must be satisfied (AND logic)\n     */\n    let conditionMet = true;\n    let hasAnyProperty = false;\n\n    if (trigger.messages !== undefined) {\n      hasAnyProperty = true;\n      if (messages.length < trigger.messages) {\n        conditionMet = false;\n      }\n    }\n\n    if (trigger.tokens !== undefined) {\n      hasAnyProperty = true;\n      if (totalTokens < trigger.tokens) {\n        conditionMet = false;\n      }\n    }\n\n    if (trigger.fraction !== undefined) {\n      hasAnyProperty = true;\n      const maxInputTokens = getProfileLimits(model);\n      if (typeof maxInputTokens === \"number\") {\n        const threshold = Math.floor(maxInputTokens * trigger.fraction);\n        if (totalTokens < threshold) {\n          conditionMet = false;\n        }\n      } else {\n        /**\n         * If fraction is specified but we can't get model limits, skip this condition\n         */\n        conditionMet = false;\n      }\n    }\n\n    /**\n     * If condition has at least one property and all properties are satisfied, trigger summarization\n     */\n    if (hasAnyProperty && conditionMet) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Determine cutoff index respecting retention configuration\n */\nasync function determineCutoffIndex(\n  messages: BaseMessage[],\n  keep: ContextSize,\n  tokenCounter: TokenCounter,\n  model: BaseLanguageModel\n): Promise<number> {\n  if (\"tokens\" in keep || \"fraction\" in keep) {\n    const tokenBasedCutoff = await findTokenBasedCutoff(\n      messages,\n      keep,\n      tokenCounter,\n      model\n    );\n    if (typeof tokenBasedCutoff === \"number\") {\n      return tokenBasedCutoff;\n    }\n    /**\n     * Fallback to message count if token-based fails\n     */\n    return findSafeCutoff(messages, DEFAULT_MESSAGES_TO_KEEP);\n  }\n  /**\n   * find cutoff index based on message count\n   */\n  return findSafeCutoff(messages, keep.messages ?? DEFAULT_MESSAGES_TO_KEEP);\n}\n\n/**\n * Find cutoff index based on target token retention\n */\nasync function findTokenBasedCutoff(\n  messages: BaseMessage[],\n  keep: ContextSize,\n  tokenCounter: TokenCounter,\n  model: BaseLanguageModel\n): Promise<number | undefined> {\n  if (messages.length === 0) {\n    return 0;\n  }\n\n  let targetTokenCount: number;\n\n  if (\"fraction\" in keep && keep.fraction !== undefined) {\n    const maxInputTokens = getProfileLimits(model);\n    if (typeof maxInputTokens !== \"number\") {\n      return;\n    }\n    targetTokenCount = Math.floor(maxInputTokens * keep.fraction);\n  } else if (\"tokens\" in keep && keep.tokens !== undefined) {\n    targetTokenCount = Math.floor(keep.tokens);\n  } else {\n    return;\n  }\n\n  if (targetTokenCount <= 0) {\n    targetTokenCount = 1;\n  }\n\n  const totalTokens = await tokenCounter(messages);\n  if (totalTokens <= targetTokenCount) {\n    return 0;\n  }\n\n  /**\n   * Use binary search to identify the earliest message index that keeps the\n   * suffix within the token budget.\n   */\n  let left = 0;\n  let right = messages.length;\n  let cutoffCandidate = messages.length;\n  const maxIterations = Math.floor(Math.log2(messages.length)) + 1;\n\n  for (let i = 0; i < maxIterations; i++) {\n    if (left >= right) {\n      break;\n    }\n\n    const mid = Math.floor((left + right) / 2);\n    const suffixTokens = await tokenCounter(messages.slice(mid));\n    if (suffixTokens <= targetTokenCount) {\n      cutoffCandidate = mid;\n      right = mid;\n    } else {\n      left = mid + 1;\n    }\n  }\n\n  if (cutoffCandidate === messages.length) {\n    cutoffCandidate = left;\n  }\n\n  if (cutoffCandidate >= messages.length) {\n    if (messages.length === 1) {\n      return 0;\n    }\n    cutoffCandidate = messages.length - 1;\n  }\n\n  /**\n   * Find safe cutoff point that preserves AI/Tool pairs.\n   * If cutoff lands on ToolMessage, move backward to include the AIMessage.\n   */\n  const safeCutoff = findSafeCutoffPoint(messages, cutoffCandidate);\n\n  /**\n   * If findSafeCutoffPoint moved forward (fallback case), verify it's safe.\n   * If it moved backward, we already have a safe point.\n   */\n  if (safeCutoff <= cutoffCandidate) {\n    return safeCutoff;\n  }\n\n  /**\n   * Fallback: iterate backward to find a safe cutoff\n   */\n  for (let i = cutoffCandidate; i >= 0; i--) {\n    if (isSafeCutoffPoint(messages, i)) {\n      return i;\n    }\n  }\n\n  return 0;\n}\n\n/**\n * Find safe cutoff point that preserves AI/Tool message pairs\n */\nfunction findSafeCutoff(\n  messages: BaseMessage[],\n  messagesToKeep: number\n): number {\n  if (messages.length <= messagesToKeep) {\n    return 0;\n  }\n\n  const targetCutoff = messages.length - messagesToKeep;\n\n  /**\n   * First, try to find a safe cutoff point using findSafeCutoffPoint.\n   * This handles the case where cutoff lands on a ToolMessage by moving\n   * backward to include the corresponding AIMessage.\n   */\n  const safeCutoff = findSafeCutoffPoint(messages, targetCutoff);\n\n  /**\n   * If findSafeCutoffPoint moved backward (found matching AIMessage), use it.\n   */\n  if (safeCutoff <= targetCutoff) {\n    return safeCutoff;\n  }\n\n  /**\n   * Fallback: iterate backward to find a safe cutoff\n   */\n  for (let i = targetCutoff; i >= 0; i--) {\n    if (isSafeCutoffPoint(messages, i)) {\n      return i;\n    }\n  }\n\n  return 0;\n}\n\n/**\n * Check if cutting at index would separate AI/Tool message pairs\n */\nfunction isSafeCutoffPoint(\n  messages: BaseMessage[],\n  cutoffIndex: number\n): boolean {\n  if (cutoffIndex >= messages.length) {\n    return true;\n  }\n\n  /**\n   * Prevent preserved messages from starting with AI message containing tool calls\n   */\n  if (\n    cutoffIndex < messages.length &&\n    AIMessage.isInstance(messages[cutoffIndex]) &&\n    hasToolCalls(messages[cutoffIndex])\n  ) {\n    return false;\n  }\n\n  const searchStart = Math.max(0, cutoffIndex - SEARCH_RANGE_FOR_TOOL_PAIRS);\n  const searchEnd = Math.min(\n    messages.length,\n    cutoffIndex + SEARCH_RANGE_FOR_TOOL_PAIRS\n  );\n\n  for (let i = searchStart; i < searchEnd; i++) {\n    if (!hasToolCalls(messages[i])) {\n      continue;\n    }\n\n    const toolCallIds = extractToolCallIds(messages[i] as AIMessage);\n    if (cutoffSeparatesToolPair(messages, i, cutoffIndex, toolCallIds)) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\n/**\n * Extract tool call IDs from an AI message\n */\nfunction extractToolCallIds(aiMessage: AIMessage): Set<string> {\n  const toolCallIds = new Set<string>();\n  if (aiMessage.tool_calls) {\n    for (const toolCall of aiMessage.tool_calls) {\n      const id =\n        typeof toolCall === \"object\" && \"id\" in toolCall ? toolCall.id : null;\n      if (id) {\n        toolCallIds.add(id);\n      }\n    }\n  }\n  return toolCallIds;\n}\n\n/**\n * Find a safe cutoff point that doesn't split AI/Tool message pairs.\n *\n * If the message at `cutoffIndex` is a `ToolMessage`, search backward for the\n * `AIMessage` containing the corresponding `tool_calls` and adjust the cutoff to\n * include it. This ensures tool call requests and responses stay together.\n *\n * Falls back to advancing forward past `ToolMessage` objects only if no matching\n * `AIMessage` is found (edge case).\n */\nfunction findSafeCutoffPoint(\n  messages: BaseMessage[],\n  cutoffIndex: number\n): number {\n  if (\n    cutoffIndex >= messages.length ||\n    !ToolMessage.isInstance(messages[cutoffIndex])\n  ) {\n    return cutoffIndex;\n  }\n\n  // Collect tool_call_ids from consecutive ToolMessages at/after cutoff\n  const toolCallIds = new Set<string>();\n  let idx = cutoffIndex;\n  while (idx < messages.length && ToolMessage.isInstance(messages[idx])) {\n    const toolMsg = messages[idx] as ToolMessage;\n    if (toolMsg.tool_call_id) {\n      toolCallIds.add(toolMsg.tool_call_id);\n    }\n    idx++;\n  }\n\n  // Search backward for AIMessage with matching tool_calls\n  for (let i = cutoffIndex - 1; i >= 0; i--) {\n    const msg = messages[i];\n    if (AIMessage.isInstance(msg) && hasToolCalls(msg)) {\n      const aiToolCallIds = extractToolCallIds(msg as AIMessage);\n      // Check if there's any overlap between the tool_call_ids\n      for (const id of toolCallIds) {\n        if (aiToolCallIds.has(id)) {\n          // Found the AIMessage - move cutoff to include it\n          return i;\n        }\n      }\n    }\n  }\n\n  // Fallback: no matching AIMessage found, advance past ToolMessages to avoid\n  // orphaned tool responses\n  return idx;\n}\n\n/**\n * Check if cutoff separates an AI message from its corresponding tool messages\n */\nfunction cutoffSeparatesToolPair(\n  messages: BaseMessage[],\n  aiMessageIndex: number,\n  cutoffIndex: number,\n  toolCallIds: Set<string>\n): boolean {\n  for (let j = aiMessageIndex + 1; j < messages.length; j++) {\n    const message = messages[j];\n    if (\n      ToolMessage.isInstance(message) &&\n      toolCallIds.has(message.tool_call_id)\n    ) {\n      const aiBeforeCutoff = aiMessageIndex < cutoffIndex;\n      const toolBeforeCutoff = j < cutoffIndex;\n      if (aiBeforeCutoff !== toolBeforeCutoff) {\n        return true;\n      }\n    }\n  }\n  return false;\n}\n\n/**\n * Generate summary for the given messages.\n *\n * @param messagesToSummarize - Messages to summarize.\n * @param model - The language model to use for summarization.\n * @param summaryPrompt - The prompt template for summarization.\n * @param tokenCounter - Function to count tokens.\n * @param trimTokensToSummarize - Optional token limit for trimming messages.\n * @param runtime - The runtime environment, used to inherit config so that\n *   LangGraph's handlers can properly track and tag the summarization model call.\n */\nasync function createSummary(\n  messagesToSummarize: BaseMessage[],\n  model: BaseLanguageModel,\n  summaryPrompt: string,\n  tokenCounter: TokenCounter,\n  trimTokensToSummarize: number | undefined,\n  runtime: Runtime<unknown>\n): Promise<string> {\n  if (!messagesToSummarize.length) {\n    return \"No previous conversation history.\";\n  }\n\n  const trimmedMessages = await trimMessagesForSummary(\n    messagesToSummarize,\n    tokenCounter,\n    trimTokensToSummarize\n  );\n\n  if (!trimmedMessages.length) {\n    return \"Previous conversation was too long to summarize.\";\n  }\n\n  /**\n   * Format messages using getBufferString to avoid token inflation from metadata\n   * when str() / JSON.stringify is called on message objects.\n   * This produces compact output like:\n   * ```\n   * Human: What's the weather?\n   * AI: Let me check...[tool_calls]\n   * Tool: 72°F and sunny\n   * ```\n   */\n  const formattedMessages = getBufferString(trimmedMessages);\n\n  try {\n    const formattedPrompt = summaryPrompt.replace(\n      \"{messages}\",\n      formattedMessages\n    );\n    /**\n     * Merge parent runnable config with summarization metadata so LangGraph's\n     * stream handlers (and other callback-based consumers) can properly track\n     * and tag the summarization model call.\n     */\n    const baseConfig: RunnableConfig = pickRunnableConfigKeys(runtime) ?? {};\n    const config = mergeConfigs(baseConfig, {\n      metadata: { lc_source: \"summarization\" },\n    });\n    const response = await model.invoke(formattedPrompt, config);\n    const content = response.content;\n    /**\n     * Handle both string content and MessageContent array\n     */\n    if (typeof content === \"string\") {\n      return content.trim();\n    } else if (Array.isArray(content)) {\n      /**\n       * Extract text from MessageContent array\n       */\n      const textContent = content\n        .map((item) => {\n          if (typeof item === \"string\") return item;\n          if (typeof item === \"object\" && item !== null && \"text\" in item) {\n            return (item as { text: string }).text;\n          }\n          return \"\";\n        })\n        .join(\"\");\n      return textContent.trim();\n    }\n    return \"Error generating summary: Invalid response format\";\n  } catch (e) {\n    return `Error generating summary: ${e}`;\n  }\n}\n\n/**\n * Trim messages to fit within summary generation limits\n */\nasync function trimMessagesForSummary(\n  messages: BaseMessage[],\n  tokenCounter: TokenCounter,\n  trimTokensToSummarize: number | undefined\n): Promise<BaseMessage[]> {\n  if (trimTokensToSummarize === undefined) {\n    return messages;\n  }\n\n  try {\n    return await trimMessages(messages, {\n      maxTokens: trimTokensToSummarize,\n      tokenCounter: async (msgs) => tokenCounter(msgs),\n      strategy: \"last\",\n      allowPartial: true,\n      includeSystem: true,\n    });\n  } catch {\n    /**\n     * Fallback to last N messages if trimming fails\n     */\n    return messages.slice(-DEFAULT_FALLBACK_MESSAGE_COUNT);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"summarization.cjs","names":["z","z4","createMiddleware","initChatModel","countTokensApproximately","HumanMessage","RemoveMessage","REMOVE_ALL_MESSAGES","SystemMessage","AIMessage","hasToolCalls","ToolMessage"],"sources":["../../../src/agents/middleware/summarization.ts"],"sourcesContent":["import { z } from \"zod/v3\";\nimport { z as z4 } from \"zod/v4\";\nimport { v4 as uuid } from \"@langchain/core/utils/uuid\";\nimport {\n  BaseMessage,\n  AIMessage,\n  SystemMessage,\n  ToolMessage,\n  RemoveMessage,\n  trimMessages,\n  HumanMessage,\n  getBufferString,\n} from \"@langchain/core/messages\";\nimport {\n  BaseLanguageModel,\n  getModelContextSize,\n} from \"@langchain/core/language_models/base\";\nimport {\n  interopSafeParse,\n  InferInteropZodInput,\n  InferInteropZodOutput,\n} from \"@langchain/core/utils/types\";\nimport {\n  mergeConfigs,\n  pickRunnableConfigKeys,\n  type RunnableConfig,\n} from \"@langchain/core/runnables\";\nimport { REMOVE_ALL_MESSAGES } from \"@langchain/langgraph\";\nimport { createMiddleware } from \"../middleware.js\";\nimport { countTokensApproximately } from \"./utils.js\";\nimport { hasToolCalls } from \"../utils.js\";\nimport { initChatModel } from \"../../chat_models/universal.js\";\nimport type { Runtime } from \"../runtime.js\";\n\nexport const DEFAULT_SUMMARY_PROMPT = `<role>\nContext Extraction Assistant\n</role>\n\n<primary_objective>\nYour sole objective in this task is to extract the highest quality/most relevant context from the conversation history below.\n</primary_objective>\n\n<objective_information>\nYou're nearing the total number of input tokens you can accept, so you must extract the highest quality/most relevant pieces of information from your conversation history.\nThis context will then overwrite the conversation history presented below. Because of this, ensure the context you extract is only the most important information to your overall goal.\n</objective_information>\n\n<instructions>\nThe conversation history below will be replaced with the context you extract in this step. Because of this, you must do your very best to extract and record all of the most important context from the conversation history.\nYou want to ensure that you don't repeat any actions you've already completed, so the context you extract from the conversation history should be focused on the most important information to your overall goal.\n</instructions>\n\nThe user will message you with the full message history you'll be extracting context from, to then replace. Carefully read over it all, and think deeply about what information is most important to your overall goal that should be saved:\n\nWith all of this in mind, please carefully read over the entire conversation history, and extract the most important and relevant context to replace it so that you can free up space in the conversation history.\nRespond ONLY with the extracted context. Do not include any additional information, or text before or after the extracted context.\n\n<messages>\nMessages to summarize:\n{messages}\n</messages>`;\n\nconst DEFAULT_SUMMARY_PREFIX = \"Here is a summary of the conversation to date:\";\nconst DEFAULT_MESSAGES_TO_KEEP = 20;\nconst DEFAULT_TRIM_TOKEN_LIMIT = 4000;\nconst DEFAULT_FALLBACK_MESSAGE_COUNT = 15;\nconst SEARCH_RANGE_FOR_TOOL_PAIRS = 5;\n\nconst tokenCounterSchema = z\n  .function()\n  .args(z.array(z.custom<BaseMessage>()))\n  .returns(z.union([z.number(), z.promise(z.number())]));\nexport type TokenCounter = (\n  messages: BaseMessage[]\n) => number | Promise<number>;\n\nexport const contextSizeSchema = z\n  .object({\n    /**\n     * Fraction of the model's context size to use as the trigger\n     */\n    fraction: z\n      .number()\n      .gt(0, \"Fraction must be greater than 0\")\n      .max(1, \"Fraction must be less than or equal to 1\")\n      .optional(),\n    /**\n     * Number of tokens to use as the trigger\n     */\n    tokens: z.number().positive(\"Tokens must be greater than 0\").optional(),\n    /**\n     * Number of messages to use as the trigger\n     */\n    messages: z\n      .number()\n      .int(\"Messages must be an integer\")\n      .positive(\"Messages must be greater than 0\")\n      .optional(),\n  })\n  .refine(\n    (data) => {\n      const count = [data.fraction, data.tokens, data.messages].filter(\n        (v) => v !== undefined\n      ).length;\n      return count >= 1;\n    },\n    {\n      message: \"At least one of fraction, tokens, or messages must be provided\",\n    }\n  );\nexport type ContextSize = z.infer<typeof contextSizeSchema>;\n\nexport const keepSchema = z\n  .object({\n    /**\n     * Fraction of the model's context size to keep\n     */\n    fraction: z\n      .number()\n      .min(0, \"Messages must be non-negative\")\n      .max(1, \"Fraction must be less than or equal to 1\")\n      .optional(),\n    /**\n     * Number of tokens to keep\n     */\n    tokens: z\n      .number()\n      .min(0, \"Tokens must be greater than or equal to 0\")\n      .optional(),\n    messages: z\n      .number()\n      .int(\"Messages must be an integer\")\n      .min(0, \"Messages must be non-negative\")\n      .optional(),\n  })\n  .refine(\n    (data) => {\n      const count = [data.fraction, data.tokens, data.messages].filter(\n        (v) => v !== undefined\n      ).length;\n      return count === 1;\n    },\n    {\n      message: \"Exactly one of fraction, tokens, or messages must be provided\",\n    }\n  );\nexport type KeepSize = z.infer<typeof keepSchema>;\n\nconst contextSchema = z.object({\n  /**\n   * Model to use for summarization\n   */\n  model: z.custom<string | BaseLanguageModel>(),\n  /**\n   * Trigger conditions for summarization.\n   * Can be a single condition object (all properties must be met) or an array of conditions (any condition must be met).\n   *\n   * @example\n   * ```ts\n   * // Single condition: trigger if tokens >= 5000 AND messages >= 3\n   * trigger: { tokens: 5000, messages: 3 }\n   *\n   * // Multiple conditions: trigger if (tokens >= 5000 AND messages >= 3) OR (tokens >= 3000 AND messages >= 6)\n   * trigger: [\n   *   { tokens: 5000, messages: 3 },\n   *   { tokens: 3000, messages: 6 }\n   * ]\n   * ```\n   */\n  trigger: z.union([contextSizeSchema, z.array(contextSizeSchema)]).optional(),\n  /**\n   * Keep conditions for summarization\n   */\n  keep: keepSchema.optional(),\n  /**\n   * Token counter function to use for summarization\n   */\n  tokenCounter: tokenCounterSchema.optional(),\n  /**\n   * Summary prompt to use for summarization\n   * @default {@link DEFAULT_SUMMARY_PROMPT}\n   */\n  summaryPrompt: z.string().default(DEFAULT_SUMMARY_PROMPT),\n  /**\n   * Number of tokens to trim to before summarizing\n   */\n  trimTokensToSummarize: z.number().optional(),\n  /**\n   * Prefix to add to the summary\n   */\n  summaryPrefix: z.string().optional(),\n  /**\n   * @deprecated Use `trigger: { tokens: value }` instead.\n   */\n  maxTokensBeforeSummary: z.number().optional(),\n  /**\n   * @deprecated Use `keep: { messages: value }` instead.\n   */\n  messagesToKeep: z.number().optional(),\n});\n\nexport type SummarizationMiddlewareConfig = InferInteropZodInput<\n  typeof contextSchema\n>;\n\n/**\n * Get max input tokens from model profile or fallback to model name lookup\n */\nexport function getProfileLimits(input: BaseLanguageModel): number | undefined {\n  // Access maxInputTokens on the model profile directly if available\n  if (\n    \"profile\" in input &&\n    typeof input.profile === \"object\" &&\n    input.profile &&\n    \"maxInputTokens\" in input.profile &&\n    (typeof input.profile.maxInputTokens === \"number\" ||\n      input.profile.maxInputTokens == null)\n  ) {\n    return input.profile.maxInputTokens ?? undefined;\n  }\n\n  // Fallback to using model name if available\n  if (\"model\" in input && typeof input.model === \"string\") {\n    return getModelContextSize(input.model);\n  }\n  if (\"modelName\" in input && typeof input.modelName === \"string\") {\n    return getModelContextSize(input.modelName);\n  }\n\n  return undefined;\n}\n\n/**\n * Summarization middleware that automatically summarizes conversation history when token limits are approached.\n *\n * This middleware monitors message token counts and automatically summarizes older\n * messages when a threshold is reached, preserving recent messages and maintaining\n * context continuity by ensuring AI/Tool message pairs remain together.\n *\n * @param options Configuration options for the summarization middleware\n * @returns A middleware instance\n *\n * @example\n * ```ts\n * import { summarizationMiddleware } from \"langchain\";\n * import { createAgent } from \"langchain\";\n *\n * // Single condition: trigger if tokens >= 4000 AND messages >= 10\n * const agent1 = createAgent({\n *   llm: model,\n *   tools: [getWeather],\n *   middleware: [\n *     summarizationMiddleware({\n *       model: new ChatOpenAI({ model: \"gpt-4o\" }),\n *       trigger: { tokens: 4000, messages: 10 },\n *       keep: { messages: 20 },\n *     })\n *   ],\n * });\n *\n * // Multiple conditions: trigger if (tokens >= 5000 AND messages >= 3) OR (tokens >= 3000 AND messages >= 6)\n * const agent2 = createAgent({\n *   llm: model,\n *   tools: [getWeather],\n *   middleware: [\n *     summarizationMiddleware({\n *       model: new ChatOpenAI({ model: \"gpt-4o\" }),\n *       trigger: [\n *         { tokens: 5000, messages: 3 },\n *         { tokens: 3000, messages: 6 },\n *       ],\n *       keep: { messages: 20 },\n *     })\n *   ],\n * });\n *\n * ```\n */\nexport function summarizationMiddleware(\n  options: SummarizationMiddlewareConfig\n) {\n  /**\n   * Parse user options to get their explicit values\n   */\n  const { data: userOptions, error } = interopSafeParse(contextSchema, options);\n  if (error) {\n    throw new Error(\n      `Invalid summarization middleware options: ${z4.prettifyError(error)}`\n    );\n  }\n\n  return createMiddleware({\n    name: \"SummarizationMiddleware\",\n    contextSchema: contextSchema.extend({\n      /**\n       * `model` should be required when initializing the middleware,\n       * but can be omitted within context when invoking the middleware.\n       */\n      model: z.custom<BaseLanguageModel>().optional(),\n    }),\n    beforeModel: async (state, runtime) => {\n      let trigger: ContextSize | ContextSize[] | undefined =\n        userOptions.trigger;\n      let keep: ContextSize = userOptions.keep as InferInteropZodOutput<\n        typeof keepSchema\n      >;\n\n      /**\n       * Handle deprecated parameters\n       */\n      if (userOptions.maxTokensBeforeSummary !== undefined) {\n        console.warn(\n          \"maxTokensBeforeSummary is deprecated. Use `trigger: { tokens: value }` instead.\"\n        );\n        if (trigger === undefined) {\n          trigger = { tokens: userOptions.maxTokensBeforeSummary };\n        }\n      }\n\n      /**\n       * Handle deprecated parameters\n       */\n      if (userOptions.messagesToKeep !== undefined) {\n        console.warn(\n          \"messagesToKeep is deprecated. Use `keep: { messages: value }` instead.\"\n        );\n        if (\n          !keep ||\n          (keep &&\n            \"messages\" in keep &&\n            keep.messages === DEFAULT_MESSAGES_TO_KEEP)\n        ) {\n          keep = { messages: userOptions.messagesToKeep };\n        }\n      }\n\n      /**\n       * Merge context with user options\n       */\n      const resolvedTrigger =\n        runtime.context?.trigger !== undefined\n          ? runtime.context.trigger\n          : trigger;\n      const resolvedKeep =\n        runtime.context?.keep !== undefined\n          ? runtime.context.keep\n          : (keep ?? { messages: DEFAULT_MESSAGES_TO_KEEP });\n\n      const validatedKeep = keepSchema.parse(resolvedKeep);\n\n      /**\n       * Validate trigger conditions\n       */\n      let triggerConditions: ContextSize[] = [];\n      if (resolvedTrigger === undefined) {\n        triggerConditions = [];\n      } else if (Array.isArray(resolvedTrigger)) {\n        /**\n         * It's an array of ContextSize objects\n         */\n        triggerConditions = (resolvedTrigger as ContextSize[]).map((t) =>\n          contextSizeSchema.parse(t)\n        );\n      } else {\n        /**\n         * Single ContextSize object - all properties must be satisfied (AND logic)\n         */\n        triggerConditions = [contextSizeSchema.parse(resolvedTrigger)];\n      }\n\n      /**\n       * Check if profile is required\n       */\n      const requiresProfile =\n        triggerConditions.some((c) => \"fraction\" in c) ||\n        \"fraction\" in validatedKeep;\n\n      const model =\n        typeof userOptions.model === \"string\"\n          ? await initChatModel(userOptions.model)\n          : userOptions.model;\n\n      if (requiresProfile && !getProfileLimits(model)) {\n        throw new Error(\n          \"Model profile information is required to use fractional token limits. \" +\n            \"Use absolute token counts instead.\"\n        );\n      }\n\n      const summaryPrompt =\n        runtime.context?.summaryPrompt === DEFAULT_SUMMARY_PROMPT\n          ? (userOptions.summaryPrompt ?? DEFAULT_SUMMARY_PROMPT)\n          : (runtime.context?.summaryPrompt ??\n            userOptions.summaryPrompt ??\n            DEFAULT_SUMMARY_PROMPT);\n      const summaryPrefix =\n        runtime.context.summaryPrefix ??\n        userOptions.summaryPrefix ??\n        DEFAULT_SUMMARY_PREFIX;\n      const trimTokensToSummarize =\n        runtime.context?.trimTokensToSummarize !== undefined\n          ? runtime.context.trimTokensToSummarize\n          : (userOptions.trimTokensToSummarize ?? DEFAULT_TRIM_TOKEN_LIMIT);\n\n      /**\n       * Ensure all messages have IDs\n       */\n      ensureMessageIds(state.messages);\n\n      const tokenCounter =\n        runtime.context?.tokenCounter !== undefined\n          ? runtime.context.tokenCounter\n          : (userOptions.tokenCounter ?? countTokensApproximately);\n      const totalTokens = await tokenCounter(state.messages);\n      const doSummarize = await shouldSummarize(\n        state.messages,\n        totalTokens,\n        triggerConditions,\n        model\n      );\n\n      if (!doSummarize) {\n        return;\n      }\n\n      const { systemPrompt, conversationMessages } = splitSystemMessage(\n        state.messages\n      );\n      const cutoffIndex = await determineCutoffIndex(\n        conversationMessages,\n        validatedKeep,\n        tokenCounter,\n        model\n      );\n\n      if (cutoffIndex <= 0) {\n        return;\n      }\n\n      const { messagesToSummarize, preservedMessages } = partitionMessages(\n        systemPrompt,\n        conversationMessages,\n        cutoffIndex\n      );\n\n      const summary = await createSummary(\n        messagesToSummarize,\n        model,\n        summaryPrompt,\n        tokenCounter,\n        trimTokensToSummarize,\n        runtime\n      );\n\n      const summaryMessage = new HumanMessage({\n        content: `${summaryPrefix}\\n\\n${summary}`,\n        id: uuid(),\n        additional_kwargs: { lc_source: \"summarization\" },\n      });\n\n      return {\n        messages: [\n          new RemoveMessage({ id: REMOVE_ALL_MESSAGES }),\n          summaryMessage,\n          ...preservedMessages,\n        ],\n      };\n    },\n  });\n}\n\n/**\n * Ensure all messages have unique IDs\n */\nfunction ensureMessageIds(messages: BaseMessage[]): void {\n  for (const msg of messages) {\n    if (!msg.id) {\n      msg.id = uuid();\n    }\n  }\n}\n\n/**\n * Separate system message from conversation messages\n */\nfunction splitSystemMessage(messages: BaseMessage[]): {\n  systemPrompt?: SystemMessage;\n  conversationMessages: BaseMessage[];\n} {\n  if (messages.length > 0 && SystemMessage.isInstance(messages[0])) {\n    return {\n      systemPrompt: messages[0] as SystemMessage,\n      conversationMessages: messages.slice(1),\n    };\n  }\n  return {\n    conversationMessages: messages,\n  };\n}\n\n/**\n * Partition messages into those to summarize and those to preserve\n */\nfunction partitionMessages(\n  systemPrompt: SystemMessage | undefined,\n  conversationMessages: BaseMessage[],\n  cutoffIndex: number\n): { messagesToSummarize: BaseMessage[]; preservedMessages: BaseMessage[] } {\n  const messagesToSummarize = conversationMessages.slice(0, cutoffIndex);\n  const preservedMessages = conversationMessages.slice(cutoffIndex);\n\n  // Include system message in messages to summarize to capture previous summaries\n  if (systemPrompt) {\n    messagesToSummarize.unshift(systemPrompt);\n  }\n\n  return { messagesToSummarize, preservedMessages };\n}\n\n/**\n * Determine whether summarization should run for the current token usage\n *\n * @param messages - Current messages in the conversation\n * @param totalTokens - Total token count for all messages\n * @param triggerConditions - Array of trigger conditions. Returns true if ANY condition is satisfied (OR logic).\n *                           Within each condition, ALL specified properties must be satisfied (AND logic).\n * @param model - The language model being used\n * @returns true if summarization should be triggered\n */\nasync function shouldSummarize(\n  messages: BaseMessage[],\n  totalTokens: number,\n  triggerConditions: ContextSize[],\n  model: BaseLanguageModel\n): Promise<boolean> {\n  if (triggerConditions.length === 0) {\n    return false;\n  }\n\n  /**\n   * Check each condition (OR logic between conditions)\n   */\n  for (const trigger of triggerConditions) {\n    /**\n     * Within a single condition, all specified properties must be satisfied (AND logic)\n     */\n    let conditionMet = true;\n    let hasAnyProperty = false;\n\n    if (trigger.messages !== undefined) {\n      hasAnyProperty = true;\n      if (messages.length < trigger.messages) {\n        conditionMet = false;\n      }\n    }\n\n    if (trigger.tokens !== undefined) {\n      hasAnyProperty = true;\n      if (totalTokens < trigger.tokens) {\n        conditionMet = false;\n      }\n    }\n\n    if (trigger.fraction !== undefined) {\n      hasAnyProperty = true;\n      const maxInputTokens = getProfileLimits(model);\n      if (typeof maxInputTokens === \"number\") {\n        const threshold = Math.floor(maxInputTokens * trigger.fraction);\n        if (totalTokens < threshold) {\n          conditionMet = false;\n        }\n      } else {\n        /**\n         * If fraction is specified but we can't get model limits, skip this condition\n         */\n        conditionMet = false;\n      }\n    }\n\n    /**\n     * If condition has at least one property and all properties are satisfied, trigger summarization\n     */\n    if (hasAnyProperty && conditionMet) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Determine cutoff index respecting retention configuration\n */\nasync function determineCutoffIndex(\n  messages: BaseMessage[],\n  keep: ContextSize,\n  tokenCounter: TokenCounter,\n  model: BaseLanguageModel\n): Promise<number> {\n  if (\"tokens\" in keep || \"fraction\" in keep) {\n    const tokenBasedCutoff = await findTokenBasedCutoff(\n      messages,\n      keep,\n      tokenCounter,\n      model\n    );\n    if (typeof tokenBasedCutoff === \"number\") {\n      return tokenBasedCutoff;\n    }\n    /**\n     * Fallback to message count if token-based fails\n     */\n    return findSafeCutoff(messages, DEFAULT_MESSAGES_TO_KEEP);\n  }\n  /**\n   * find cutoff index based on message count\n   */\n  return findSafeCutoff(messages, keep.messages ?? DEFAULT_MESSAGES_TO_KEEP);\n}\n\n/**\n * Find cutoff index based on target token retention\n */\nasync function findTokenBasedCutoff(\n  messages: BaseMessage[],\n  keep: ContextSize,\n  tokenCounter: TokenCounter,\n  model: BaseLanguageModel\n): Promise<number | undefined> {\n  if (messages.length === 0) {\n    return 0;\n  }\n\n  let targetTokenCount: number;\n\n  if (\"fraction\" in keep && keep.fraction !== undefined) {\n    const maxInputTokens = getProfileLimits(model);\n    if (typeof maxInputTokens !== \"number\") {\n      return;\n    }\n    targetTokenCount = Math.floor(maxInputTokens * keep.fraction);\n  } else if (\"tokens\" in keep && keep.tokens !== undefined) {\n    targetTokenCount = Math.floor(keep.tokens);\n  } else {\n    return;\n  }\n\n  if (targetTokenCount <= 0) {\n    targetTokenCount = 1;\n  }\n\n  const totalTokens = await tokenCounter(messages);\n  if (totalTokens <= targetTokenCount) {\n    return 0;\n  }\n\n  /**\n   * Use binary search to identify the earliest message index that keeps the\n   * suffix within the token budget.\n   */\n  let left = 0;\n  let right = messages.length;\n  let cutoffCandidate = messages.length;\n  const maxIterations = Math.floor(Math.log2(messages.length)) + 1;\n\n  for (let i = 0; i < maxIterations; i++) {\n    if (left >= right) {\n      break;\n    }\n\n    const mid = Math.floor((left + right) / 2);\n    const suffixTokens = await tokenCounter(messages.slice(mid));\n    if (suffixTokens <= targetTokenCount) {\n      cutoffCandidate = mid;\n      right = mid;\n    } else {\n      left = mid + 1;\n    }\n  }\n\n  if (cutoffCandidate === messages.length) {\n    cutoffCandidate = left;\n  }\n\n  if (cutoffCandidate >= messages.length) {\n    if (messages.length === 1) {\n      return 0;\n    }\n    cutoffCandidate = messages.length - 1;\n  }\n\n  /**\n   * Find safe cutoff point that preserves AI/Tool pairs.\n   * If cutoff lands on ToolMessage, move backward to include the AIMessage.\n   */\n  const safeCutoff = findSafeCutoffPoint(messages, cutoffCandidate);\n\n  /**\n   * If findSafeCutoffPoint moved forward (fallback case), verify it's safe.\n   * If it moved backward, we already have a safe point.\n   */\n  if (safeCutoff <= cutoffCandidate) {\n    return safeCutoff;\n  }\n\n  /**\n   * Fallback: iterate backward to find a safe cutoff\n   */\n  for (let i = cutoffCandidate; i >= 0; i--) {\n    if (isSafeCutoffPoint(messages, i)) {\n      return i;\n    }\n  }\n\n  return 0;\n}\n\n/**\n * Find safe cutoff point that preserves AI/Tool message pairs\n */\nfunction findSafeCutoff(\n  messages: BaseMessage[],\n  messagesToKeep: number\n): number {\n  if (messages.length <= messagesToKeep) {\n    return 0;\n  }\n\n  const targetCutoff = messages.length - messagesToKeep;\n\n  /**\n   * First, try to find a safe cutoff point using findSafeCutoffPoint.\n   * This handles the case where cutoff lands on a ToolMessage by moving\n   * backward to include the corresponding AIMessage.\n   */\n  const safeCutoff = findSafeCutoffPoint(messages, targetCutoff);\n\n  /**\n   * If findSafeCutoffPoint moved backward (found matching AIMessage), use it.\n   */\n  if (safeCutoff <= targetCutoff) {\n    return safeCutoff;\n  }\n\n  /**\n   * Fallback: iterate backward to find a safe cutoff\n   */\n  for (let i = targetCutoff; i >= 0; i--) {\n    if (isSafeCutoffPoint(messages, i)) {\n      return i;\n    }\n  }\n\n  return 0;\n}\n\n/**\n * Check if cutting at index would separate AI/Tool message pairs\n */\nfunction isSafeCutoffPoint(\n  messages: BaseMessage[],\n  cutoffIndex: number\n): boolean {\n  if (cutoffIndex >= messages.length) {\n    return true;\n  }\n\n  /**\n   * Prevent preserved messages from starting with AI message containing tool calls\n   */\n  if (\n    cutoffIndex < messages.length &&\n    AIMessage.isInstance(messages[cutoffIndex]) &&\n    hasToolCalls(messages[cutoffIndex])\n  ) {\n    return false;\n  }\n\n  const searchStart = Math.max(0, cutoffIndex - SEARCH_RANGE_FOR_TOOL_PAIRS);\n  const searchEnd = Math.min(\n    messages.length,\n    cutoffIndex + SEARCH_RANGE_FOR_TOOL_PAIRS\n  );\n\n  for (let i = searchStart; i < searchEnd; i++) {\n    if (!hasToolCalls(messages[i])) {\n      continue;\n    }\n\n    const toolCallIds = extractToolCallIds(messages[i] as AIMessage);\n    if (cutoffSeparatesToolPair(messages, i, cutoffIndex, toolCallIds)) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\n/**\n * Extract tool call IDs from an AI message\n */\nfunction extractToolCallIds(aiMessage: AIMessage): Set<string> {\n  const toolCallIds = new Set<string>();\n  if (aiMessage.tool_calls) {\n    for (const toolCall of aiMessage.tool_calls) {\n      const id =\n        typeof toolCall === \"object\" && \"id\" in toolCall ? toolCall.id : null;\n      if (id) {\n        toolCallIds.add(id);\n      }\n    }\n  }\n  return toolCallIds;\n}\n\n/**\n * Find a safe cutoff point that doesn't split AI/Tool message pairs.\n *\n * If the message at `cutoffIndex` is a `ToolMessage`, search backward for the\n * `AIMessage` containing the corresponding `tool_calls` and adjust the cutoff to\n * include it. This ensures tool call requests and responses stay together.\n *\n * Falls back to advancing forward past `ToolMessage` objects only if no matching\n * `AIMessage` is found (edge case).\n */\nfunction findSafeCutoffPoint(\n  messages: BaseMessage[],\n  cutoffIndex: number\n): number {\n  if (\n    cutoffIndex >= messages.length ||\n    !ToolMessage.isInstance(messages[cutoffIndex])\n  ) {\n    return cutoffIndex;\n  }\n\n  // Collect tool_call_ids from consecutive ToolMessages at/after cutoff\n  const toolCallIds = new Set<string>();\n  let idx = cutoffIndex;\n  while (idx < messages.length && ToolMessage.isInstance(messages[idx])) {\n    const toolMsg = messages[idx] as ToolMessage;\n    if (toolMsg.tool_call_id) {\n      toolCallIds.add(toolMsg.tool_call_id);\n    }\n    idx++;\n  }\n\n  // Search backward for AIMessage with matching tool_calls\n  for (let i = cutoffIndex - 1; i >= 0; i--) {\n    const msg = messages[i];\n    if (AIMessage.isInstance(msg) && hasToolCalls(msg)) {\n      const aiToolCallIds = extractToolCallIds(msg as AIMessage);\n      // Check if there's any overlap between the tool_call_ids\n      for (const id of toolCallIds) {\n        if (aiToolCallIds.has(id)) {\n          // Found the AIMessage - move cutoff to include it\n          return i;\n        }\n      }\n    }\n  }\n\n  // Fallback: no matching AIMessage found, advance past ToolMessages to avoid\n  // orphaned tool responses\n  return idx;\n}\n\n/**\n * Check if cutoff separates an AI message from its corresponding tool messages\n */\nfunction cutoffSeparatesToolPair(\n  messages: BaseMessage[],\n  aiMessageIndex: number,\n  cutoffIndex: number,\n  toolCallIds: Set<string>\n): boolean {\n  for (let j = aiMessageIndex + 1; j < messages.length; j++) {\n    const message = messages[j];\n    if (\n      ToolMessage.isInstance(message) &&\n      toolCallIds.has(message.tool_call_id)\n    ) {\n      const aiBeforeCutoff = aiMessageIndex < cutoffIndex;\n      const toolBeforeCutoff = j < cutoffIndex;\n      if (aiBeforeCutoff !== toolBeforeCutoff) {\n        return true;\n      }\n    }\n  }\n  return false;\n}\n\n/**\n * Generate summary for the given messages.\n *\n * @param messagesToSummarize - Messages to summarize.\n * @param model - The language model to use for summarization.\n * @param summaryPrompt - The prompt template for summarization.\n * @param tokenCounter - Function to count tokens.\n * @param trimTokensToSummarize - Optional token limit for trimming messages.\n * @param runtime - The runtime environment, used to inherit config so that\n *   LangGraph's handlers can properly track and tag the summarization model call.\n */\nasync function createSummary(\n  messagesToSummarize: BaseMessage[],\n  model: BaseLanguageModel,\n  summaryPrompt: string,\n  tokenCounter: TokenCounter,\n  trimTokensToSummarize: number | undefined,\n  runtime: Runtime<unknown>\n): Promise<string> {\n  if (!messagesToSummarize.length) {\n    return \"No previous conversation history.\";\n  }\n\n  const trimmedMessages = await trimMessagesForSummary(\n    messagesToSummarize,\n    tokenCounter,\n    trimTokensToSummarize\n  );\n\n  if (!trimmedMessages.length) {\n    return \"Previous conversation was too long to summarize.\";\n  }\n\n  /**\n   * Format messages using getBufferString to avoid token inflation from metadata\n   * when str() / JSON.stringify is called on message objects.\n   * This produces compact output like:\n   * ```\n   * Human: What's the weather?\n   * AI: Let me check...[tool_calls]\n   * Tool: 72°F and sunny\n   * ```\n   */\n  const formattedMessages = getBufferString(trimmedMessages);\n\n  try {\n    const formattedPrompt = summaryPrompt.replace(\n      \"{messages}\",\n      formattedMessages\n    );\n    /**\n     * Merge parent runnable config with summarization metadata so LangGraph's\n     * stream handlers (and other callback-based consumers) can properly track\n     * and tag the summarization model call.\n     */\n    const baseConfig: RunnableConfig = pickRunnableConfigKeys(runtime) ?? {};\n    const config = mergeConfigs(baseConfig, {\n      metadata: { lc_source: \"summarization\" },\n    });\n    const response = await model.invoke(formattedPrompt, config);\n    const content = response.content;\n    /**\n     * Handle both string content and MessageContent array\n     */\n    if (typeof content === \"string\") {\n      return content.trim();\n    } else if (Array.isArray(content)) {\n      /**\n       * Extract text from MessageContent array\n       */\n      const textContent = content\n        .map((item) => {\n          if (typeof item === \"string\") return item;\n          if (typeof item === \"object\" && item !== null && \"text\" in item) {\n            return (item as { text: string }).text;\n          }\n          return \"\";\n        })\n        .join(\"\");\n      return textContent.trim();\n    }\n    return \"Error generating summary: Invalid response format\";\n  } catch (e) {\n    return `Error generating summary: ${e}`;\n  }\n}\n\n/**\n * Trim messages to fit within summary generation limits\n */\nasync function trimMessagesForSummary(\n  messages: BaseMessage[],\n  tokenCounter: TokenCounter,\n  trimTokensToSummarize: number | undefined\n): Promise<BaseMessage[]> {\n  if (trimTokensToSummarize === undefined) {\n    return messages;\n  }\n\n  try {\n    return await trimMessages(messages, {\n      maxTokens: trimTokensToSummarize,\n      tokenCounter: async (msgs) => tokenCounter(msgs),\n      strategy: \"last\",\n      allowPartial: true,\n      includeSystem: true,\n    });\n  } catch {\n    /**\n     * Fallback to last N messages if trimming fails\n     */\n    return messages.slice(-DEFAULT_FALLBACK_MESSAGE_COUNT);\n  }\n}\n"],"mappings":"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"}

package/dist/agents/middleware/summarization.js

@@ -8,7 +8,7 @@ import { REMOVE_ALL_MESSAGES } from "@langchain/langgraph";
 import { interopSafeParse } from "@langchain/core/utils/types";
 import { z } from "zod/v4";
 import { z as z$1 } from "zod/v3";
-import { v4 } from "uuid";
+import { v4 } from "@langchain/core/utils/uuid";
 import { getModelContextSize } from "@langchain/core/language_models/base";
 //#region src/agents/middleware/summarization.ts
 const DEFAULT_SUMMARY_PROMPT = `<role>

package/dist/agents/middleware/summarization.js.map

@@ -1 +1 @@
-{"version":3,"file":"summarization.js","names":["z","z4","uuid"],"sources":["../../../src/agents/middleware/summarization.ts"],"sourcesContent":["import { z } from \"zod/v3\";\nimport { z as z4 } from \"zod/v4\";\nimport { v4 as uuid } from \"uuid\";\nimport {\n  BaseMessage,\n  AIMessage,\n  SystemMessage,\n  ToolMessage,\n  RemoveMessage,\n  trimMessages,\n  HumanMessage,\n  getBufferString,\n} from \"@langchain/core/messages\";\nimport {\n  BaseLanguageModel,\n  getModelContextSize,\n} from \"@langchain/core/language_models/base\";\nimport {\n  interopSafeParse,\n  InferInteropZodInput,\n  InferInteropZodOutput,\n} from \"@langchain/core/utils/types\";\nimport {\n  mergeConfigs,\n  pickRunnableConfigKeys,\n  type RunnableConfig,\n} from \"@langchain/core/runnables\";\nimport { REMOVE_ALL_MESSAGES } from \"@langchain/langgraph\";\nimport { createMiddleware } from \"../middleware.js\";\nimport { countTokensApproximately } from \"./utils.js\";\nimport { hasToolCalls } from \"../utils.js\";\nimport { initChatModel } from \"../../chat_models/universal.js\";\nimport type { Runtime } from \"../runtime.js\";\n\nexport const DEFAULT_SUMMARY_PROMPT = `<role>\nContext Extraction Assistant\n</role>\n\n<primary_objective>\nYour sole objective in this task is to extract the highest quality/most relevant context from the conversation history below.\n</primary_objective>\n\n<objective_information>\nYou're nearing the total number of input tokens you can accept, so you must extract the highest quality/most relevant pieces of information from your conversation history.\nThis context will then overwrite the conversation history presented below. Because of this, ensure the context you extract is only the most important information to your overall goal.\n</objective_information>\n\n<instructions>\nThe conversation history below will be replaced with the context you extract in this step. Because of this, you must do your very best to extract and record all of the most important context from the conversation history.\nYou want to ensure that you don't repeat any actions you've already completed, so the context you extract from the conversation history should be focused on the most important information to your overall goal.\n</instructions>\n\nThe user will message you with the full message history you'll be extracting context from, to then replace. Carefully read over it all, and think deeply about what information is most important to your overall goal that should be saved:\n\nWith all of this in mind, please carefully read over the entire conversation history, and extract the most important and relevant context to replace it so that you can free up space in the conversation history.\nRespond ONLY with the extracted context. Do not include any additional information, or text before or after the extracted context.\n\n<messages>\nMessages to summarize:\n{messages}\n</messages>`;\n\nconst DEFAULT_SUMMARY_PREFIX = \"Here is a summary of the conversation to date:\";\nconst DEFAULT_MESSAGES_TO_KEEP = 20;\nconst DEFAULT_TRIM_TOKEN_LIMIT = 4000;\nconst DEFAULT_FALLBACK_MESSAGE_COUNT = 15;\nconst SEARCH_RANGE_FOR_TOOL_PAIRS = 5;\n\nconst tokenCounterSchema = z\n  .function()\n  .args(z.array(z.custom<BaseMessage>()))\n  .returns(z.union([z.number(), z.promise(z.number())]));\nexport type TokenCounter = (\n  messages: BaseMessage[]\n) => number | Promise<number>;\n\nexport const contextSizeSchema = z\n  .object({\n    /**\n     * Fraction of the model's context size to use as the trigger\n     */\n    fraction: z\n      .number()\n      .gt(0, \"Fraction must be greater than 0\")\n      .max(1, \"Fraction must be less than or equal to 1\")\n      .optional(),\n    /**\n     * Number of tokens to use as the trigger\n     */\n    tokens: z.number().positive(\"Tokens must be greater than 0\").optional(),\n    /**\n     * Number of messages to use as the trigger\n     */\n    messages: z\n      .number()\n      .int(\"Messages must be an integer\")\n      .positive(\"Messages must be greater than 0\")\n      .optional(),\n  })\n  .refine(\n    (data) => {\n      const count = [data.fraction, data.tokens, data.messages].filter(\n        (v) => v !== undefined\n      ).length;\n      return count >= 1;\n    },\n    {\n      message: \"At least one of fraction, tokens, or messages must be provided\",\n    }\n  );\nexport type ContextSize = z.infer<typeof contextSizeSchema>;\n\nexport const keepSchema = z\n  .object({\n    /**\n     * Fraction of the model's context size to keep\n     */\n    fraction: z\n      .number()\n      .min(0, \"Messages must be non-negative\")\n      .max(1, \"Fraction must be less than or equal to 1\")\n      .optional(),\n    /**\n     * Number of tokens to keep\n     */\n    tokens: z\n      .number()\n      .min(0, \"Tokens must be greater than or equal to 0\")\n      .optional(),\n    messages: z\n      .number()\n      .int(\"Messages must be an integer\")\n      .min(0, \"Messages must be non-negative\")\n      .optional(),\n  })\n  .refine(\n    (data) => {\n      const count = [data.fraction, data.tokens, data.messages].filter(\n        (v) => v !== undefined\n      ).length;\n      return count === 1;\n    },\n    {\n      message: \"Exactly one of fraction, tokens, or messages must be provided\",\n    }\n  );\nexport type KeepSize = z.infer<typeof keepSchema>;\n\nconst contextSchema = z.object({\n  /**\n   * Model to use for summarization\n   */\n  model: z.custom<string | BaseLanguageModel>(),\n  /**\n   * Trigger conditions for summarization.\n   * Can be a single condition object (all properties must be met) or an array of conditions (any condition must be met).\n   *\n   * @example\n   * ```ts\n   * // Single condition: trigger if tokens >= 5000 AND messages >= 3\n   * trigger: { tokens: 5000, messages: 3 }\n   *\n   * // Multiple conditions: trigger if (tokens >= 5000 AND messages >= 3) OR (tokens >= 3000 AND messages >= 6)\n   * trigger: [\n   *   { tokens: 5000, messages: 3 },\n   *   { tokens: 3000, messages: 6 }\n   * ]\n   * ```\n   */\n  trigger: z.union([contextSizeSchema, z.array(contextSizeSchema)]).optional(),\n  /**\n   * Keep conditions for summarization\n   */\n  keep: keepSchema.optional(),\n  /**\n   * Token counter function to use for summarization\n   */\n  tokenCounter: tokenCounterSchema.optional(),\n  /**\n   * Summary prompt to use for summarization\n   * @default {@link DEFAULT_SUMMARY_PROMPT}\n   */\n  summaryPrompt: z.string().default(DEFAULT_SUMMARY_PROMPT),\n  /**\n   * Number of tokens to trim to before summarizing\n   */\n  trimTokensToSummarize: z.number().optional(),\n  /**\n   * Prefix to add to the summary\n   */\n  summaryPrefix: z.string().optional(),\n  /**\n   * @deprecated Use `trigger: { tokens: value }` instead.\n   */\n  maxTokensBeforeSummary: z.number().optional(),\n  /**\n   * @deprecated Use `keep: { messages: value }` instead.\n   */\n  messagesToKeep: z.number().optional(),\n});\n\nexport type SummarizationMiddlewareConfig = InferInteropZodInput<\n  typeof contextSchema\n>;\n\n/**\n * Get max input tokens from model profile or fallback to model name lookup\n */\nexport function getProfileLimits(input: BaseLanguageModel): number | undefined {\n  // Access maxInputTokens on the model profile directly if available\n  if (\n    \"profile\" in input &&\n    typeof input.profile === \"object\" &&\n    input.profile &&\n    \"maxInputTokens\" in input.profile &&\n    (typeof input.profile.maxInputTokens === \"number\" ||\n      input.profile.maxInputTokens == null)\n  ) {\n    return input.profile.maxInputTokens ?? undefined;\n  }\n\n  // Fallback to using model name if available\n  if (\"model\" in input && typeof input.model === \"string\") {\n    return getModelContextSize(input.model);\n  }\n  if (\"modelName\" in input && typeof input.modelName === \"string\") {\n    return getModelContextSize(input.modelName);\n  }\n\n  return undefined;\n}\n\n/**\n * Summarization middleware that automatically summarizes conversation history when token limits are approached.\n *\n * This middleware monitors message token counts and automatically summarizes older\n * messages when a threshold is reached, preserving recent messages and maintaining\n * context continuity by ensuring AI/Tool message pairs remain together.\n *\n * @param options Configuration options for the summarization middleware\n * @returns A middleware instance\n *\n * @example\n * ```ts\n * import { summarizationMiddleware } from \"langchain\";\n * import { createAgent } from \"langchain\";\n *\n * // Single condition: trigger if tokens >= 4000 AND messages >= 10\n * const agent1 = createAgent({\n *   llm: model,\n *   tools: [getWeather],\n *   middleware: [\n *     summarizationMiddleware({\n *       model: new ChatOpenAI({ model: \"gpt-4o\" }),\n *       trigger: { tokens: 4000, messages: 10 },\n *       keep: { messages: 20 },\n *     })\n *   ],\n * });\n *\n * // Multiple conditions: trigger if (tokens >= 5000 AND messages >= 3) OR (tokens >= 3000 AND messages >= 6)\n * const agent2 = createAgent({\n *   llm: model,\n *   tools: [getWeather],\n *   middleware: [\n *     summarizationMiddleware({\n *       model: new ChatOpenAI({ model: \"gpt-4o\" }),\n *       trigger: [\n *         { tokens: 5000, messages: 3 },\n *         { tokens: 3000, messages: 6 },\n *       ],\n *       keep: { messages: 20 },\n *     })\n *   ],\n * });\n *\n * ```\n */\nexport function summarizationMiddleware(\n  options: SummarizationMiddlewareConfig\n) {\n  /**\n   * Parse user options to get their explicit values\n   */\n  const { data: userOptions, error } = interopSafeParse(contextSchema, options);\n  if (error) {\n    throw new Error(\n      `Invalid summarization middleware options: ${z4.prettifyError(error)}`\n    );\n  }\n\n  return createMiddleware({\n    name: \"SummarizationMiddleware\",\n    contextSchema: contextSchema.extend({\n      /**\n       * `model` should be required when initializing the middleware,\n       * but can be omitted within context when invoking the middleware.\n       */\n      model: z.custom<BaseLanguageModel>().optional(),\n    }),\n    beforeModel: async (state, runtime) => {\n      let trigger: ContextSize | ContextSize[] | undefined =\n        userOptions.trigger;\n      let keep: ContextSize = userOptions.keep as InferInteropZodOutput<\n        typeof keepSchema\n      >;\n\n      /**\n       * Handle deprecated parameters\n       */\n      if (userOptions.maxTokensBeforeSummary !== undefined) {\n        console.warn(\n          \"maxTokensBeforeSummary is deprecated. Use `trigger: { tokens: value }` instead.\"\n        );\n        if (trigger === undefined) {\n          trigger = { tokens: userOptions.maxTokensBeforeSummary };\n        }\n      }\n\n      /**\n       * Handle deprecated parameters\n       */\n      if (userOptions.messagesToKeep !== undefined) {\n        console.warn(\n          \"messagesToKeep is deprecated. Use `keep: { messages: value }` instead.\"\n        );\n        if (\n          !keep ||\n          (keep &&\n            \"messages\" in keep &&\n            keep.messages === DEFAULT_MESSAGES_TO_KEEP)\n        ) {\n          keep = { messages: userOptions.messagesToKeep };\n        }\n      }\n\n      /**\n       * Merge context with user options\n       */\n      const resolvedTrigger =\n        runtime.context?.trigger !== undefined\n          ? runtime.context.trigger\n          : trigger;\n      const resolvedKeep =\n        runtime.context?.keep !== undefined\n          ? runtime.context.keep\n          : (keep ?? { messages: DEFAULT_MESSAGES_TO_KEEP });\n\n      const validatedKeep = keepSchema.parse(resolvedKeep);\n\n      /**\n       * Validate trigger conditions\n       */\n      let triggerConditions: ContextSize[] = [];\n      if (resolvedTrigger === undefined) {\n        triggerConditions = [];\n      } else if (Array.isArray(resolvedTrigger)) {\n        /**\n         * It's an array of ContextSize objects\n         */\n        triggerConditions = (resolvedTrigger as ContextSize[]).map((t) =>\n          contextSizeSchema.parse(t)\n        );\n      } else {\n        /**\n         * Single ContextSize object - all properties must be satisfied (AND logic)\n         */\n        triggerConditions = [contextSizeSchema.parse(resolvedTrigger)];\n      }\n\n      /**\n       * Check if profile is required\n       */\n      const requiresProfile =\n        triggerConditions.some((c) => \"fraction\" in c) ||\n        \"fraction\" in validatedKeep;\n\n      const model =\n        typeof userOptions.model === \"string\"\n          ? await initChatModel(userOptions.model)\n          : userOptions.model;\n\n      if (requiresProfile && !getProfileLimits(model)) {\n        throw new Error(\n          \"Model profile information is required to use fractional token limits. \" +\n            \"Use absolute token counts instead.\"\n        );\n      }\n\n      const summaryPrompt =\n        runtime.context?.summaryPrompt === DEFAULT_SUMMARY_PROMPT\n          ? (userOptions.summaryPrompt ?? DEFAULT_SUMMARY_PROMPT)\n          : (runtime.context?.summaryPrompt ??\n            userOptions.summaryPrompt ??\n            DEFAULT_SUMMARY_PROMPT);\n      const summaryPrefix =\n        runtime.context.summaryPrefix ??\n        userOptions.summaryPrefix ??\n        DEFAULT_SUMMARY_PREFIX;\n      const trimTokensToSummarize =\n        runtime.context?.trimTokensToSummarize !== undefined\n          ? runtime.context.trimTokensToSummarize\n          : (userOptions.trimTokensToSummarize ?? DEFAULT_TRIM_TOKEN_LIMIT);\n\n      /**\n       * Ensure all messages have IDs\n       */\n      ensureMessageIds(state.messages);\n\n      const tokenCounter =\n        runtime.context?.tokenCounter !== undefined\n          ? runtime.context.tokenCounter\n          : (userOptions.tokenCounter ?? countTokensApproximately);\n      const totalTokens = await tokenCounter(state.messages);\n      const doSummarize = await shouldSummarize(\n        state.messages,\n        totalTokens,\n        triggerConditions,\n        model\n      );\n\n      if (!doSummarize) {\n        return;\n      }\n\n      const { systemPrompt, conversationMessages } = splitSystemMessage(\n        state.messages\n      );\n      const cutoffIndex = await determineCutoffIndex(\n        conversationMessages,\n        validatedKeep,\n        tokenCounter,\n        model\n      );\n\n      if (cutoffIndex <= 0) {\n        return;\n      }\n\n      const { messagesToSummarize, preservedMessages } = partitionMessages(\n        systemPrompt,\n        conversationMessages,\n        cutoffIndex\n      );\n\n      const summary = await createSummary(\n        messagesToSummarize,\n        model,\n        summaryPrompt,\n        tokenCounter,\n        trimTokensToSummarize,\n        runtime\n      );\n\n      const summaryMessage = new HumanMessage({\n        content: `${summaryPrefix}\\n\\n${summary}`,\n        id: uuid(),\n        additional_kwargs: { lc_source: \"summarization\" },\n      });\n\n      return {\n        messages: [\n          new RemoveMessage({ id: REMOVE_ALL_MESSAGES }),\n          summaryMessage,\n          ...preservedMessages,\n        ],\n      };\n    },\n  });\n}\n\n/**\n * Ensure all messages have unique IDs\n */\nfunction ensureMessageIds(messages: BaseMessage[]): void {\n  for (const msg of messages) {\n    if (!msg.id) {\n      msg.id = uuid();\n    }\n  }\n}\n\n/**\n * Separate system message from conversation messages\n */\nfunction splitSystemMessage(messages: BaseMessage[]): {\n  systemPrompt?: SystemMessage;\n  conversationMessages: BaseMessage[];\n} {\n  if (messages.length > 0 && SystemMessage.isInstance(messages[0])) {\n    return {\n      systemPrompt: messages[0] as SystemMessage,\n      conversationMessages: messages.slice(1),\n    };\n  }\n  return {\n    conversationMessages: messages,\n  };\n}\n\n/**\n * Partition messages into those to summarize and those to preserve\n */\nfunction partitionMessages(\n  systemPrompt: SystemMessage | undefined,\n  conversationMessages: BaseMessage[],\n  cutoffIndex: number\n): { messagesToSummarize: BaseMessage[]; preservedMessages: BaseMessage[] } {\n  const messagesToSummarize = conversationMessages.slice(0, cutoffIndex);\n  const preservedMessages = conversationMessages.slice(cutoffIndex);\n\n  // Include system message in messages to summarize to capture previous summaries\n  if (systemPrompt) {\n    messagesToSummarize.unshift(systemPrompt);\n  }\n\n  return { messagesToSummarize, preservedMessages };\n}\n\n/**\n * Determine whether summarization should run for the current token usage\n *\n * @param messages - Current messages in the conversation\n * @param totalTokens - Total token count for all messages\n * @param triggerConditions - Array of trigger conditions. Returns true if ANY condition is satisfied (OR logic).\n *                           Within each condition, ALL specified properties must be satisfied (AND logic).\n * @param model - The language model being used\n * @returns true if summarization should be triggered\n */\nasync function shouldSummarize(\n  messages: BaseMessage[],\n  totalTokens: number,\n  triggerConditions: ContextSize[],\n  model: BaseLanguageModel\n): Promise<boolean> {\n  if (triggerConditions.length === 0) {\n    return false;\n  }\n\n  /**\n   * Check each condition (OR logic between conditions)\n   */\n  for (const trigger of triggerConditions) {\n    /**\n     * Within a single condition, all specified properties must be satisfied (AND logic)\n     */\n    let conditionMet = true;\n    let hasAnyProperty = false;\n\n    if (trigger.messages !== undefined) {\n      hasAnyProperty = true;\n      if (messages.length < trigger.messages) {\n        conditionMet = false;\n      }\n    }\n\n    if (trigger.tokens !== undefined) {\n      hasAnyProperty = true;\n      if (totalTokens < trigger.tokens) {\n        conditionMet = false;\n      }\n    }\n\n    if (trigger.fraction !== undefined) {\n      hasAnyProperty = true;\n      const maxInputTokens = getProfileLimits(model);\n      if (typeof maxInputTokens === \"number\") {\n        const threshold = Math.floor(maxInputTokens * trigger.fraction);\n        if (totalTokens < threshold) {\n          conditionMet = false;\n        }\n      } else {\n        /**\n         * If fraction is specified but we can't get model limits, skip this condition\n         */\n        conditionMet = false;\n      }\n    }\n\n    /**\n     * If condition has at least one property and all properties are satisfied, trigger summarization\n     */\n    if (hasAnyProperty && conditionMet) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Determine cutoff index respecting retention configuration\n */\nasync function determineCutoffIndex(\n  messages: BaseMessage[],\n  keep: ContextSize,\n  tokenCounter: TokenCounter,\n  model: BaseLanguageModel\n): Promise<number> {\n  if (\"tokens\" in keep || \"fraction\" in keep) {\n    const tokenBasedCutoff = await findTokenBasedCutoff(\n      messages,\n      keep,\n      tokenCounter,\n      model\n    );\n    if (typeof tokenBasedCutoff === \"number\") {\n      return tokenBasedCutoff;\n    }\n    /**\n     * Fallback to message count if token-based fails\n     */\n    return findSafeCutoff(messages, DEFAULT_MESSAGES_TO_KEEP);\n  }\n  /**\n   * find cutoff index based on message count\n   */\n  return findSafeCutoff(messages, keep.messages ?? DEFAULT_MESSAGES_TO_KEEP);\n}\n\n/**\n * Find cutoff index based on target token retention\n */\nasync function findTokenBasedCutoff(\n  messages: BaseMessage[],\n  keep: ContextSize,\n  tokenCounter: TokenCounter,\n  model: BaseLanguageModel\n): Promise<number | undefined> {\n  if (messages.length === 0) {\n    return 0;\n  }\n\n  let targetTokenCount: number;\n\n  if (\"fraction\" in keep && keep.fraction !== undefined) {\n    const maxInputTokens = getProfileLimits(model);\n    if (typeof maxInputTokens !== \"number\") {\n      return;\n    }\n    targetTokenCount = Math.floor(maxInputTokens * keep.fraction);\n  } else if (\"tokens\" in keep && keep.tokens !== undefined) {\n    targetTokenCount = Math.floor(keep.tokens);\n  } else {\n    return;\n  }\n\n  if (targetTokenCount <= 0) {\n    targetTokenCount = 1;\n  }\n\n  const totalTokens = await tokenCounter(messages);\n  if (totalTokens <= targetTokenCount) {\n    return 0;\n  }\n\n  /**\n   * Use binary search to identify the earliest message index that keeps the\n   * suffix within the token budget.\n   */\n  let left = 0;\n  let right = messages.length;\n  let cutoffCandidate = messages.length;\n  const maxIterations = Math.floor(Math.log2(messages.length)) + 1;\n\n  for (let i = 0; i < maxIterations; i++) {\n    if (left >= right) {\n      break;\n    }\n\n    const mid = Math.floor((left + right) / 2);\n    const suffixTokens = await tokenCounter(messages.slice(mid));\n    if (suffixTokens <= targetTokenCount) {\n      cutoffCandidate = mid;\n      right = mid;\n    } else {\n      left = mid + 1;\n    }\n  }\n\n  if (cutoffCandidate === messages.length) {\n    cutoffCandidate = left;\n  }\n\n  if (cutoffCandidate >= messages.length) {\n    if (messages.length === 1) {\n      return 0;\n    }\n    cutoffCandidate = messages.length - 1;\n  }\n\n  /**\n   * Find safe cutoff point that preserves AI/Tool pairs.\n   * If cutoff lands on ToolMessage, move backward to include the AIMessage.\n   */\n  const safeCutoff = findSafeCutoffPoint(messages, cutoffCandidate);\n\n  /**\n   * If findSafeCutoffPoint moved forward (fallback case), verify it's safe.\n   * If it moved backward, we already have a safe point.\n   */\n  if (safeCutoff <= cutoffCandidate) {\n    return safeCutoff;\n  }\n\n  /**\n   * Fallback: iterate backward to find a safe cutoff\n   */\n  for (let i = cutoffCandidate; i >= 0; i--) {\n    if (isSafeCutoffPoint(messages, i)) {\n      return i;\n    }\n  }\n\n  return 0;\n}\n\n/**\n * Find safe cutoff point that preserves AI/Tool message pairs\n */\nfunction findSafeCutoff(\n  messages: BaseMessage[],\n  messagesToKeep: number\n): number {\n  if (messages.length <= messagesToKeep) {\n    return 0;\n  }\n\n  const targetCutoff = messages.length - messagesToKeep;\n\n  /**\n   * First, try to find a safe cutoff point using findSafeCutoffPoint.\n   * This handles the case where cutoff lands on a ToolMessage by moving\n   * backward to include the corresponding AIMessage.\n   */\n  const safeCutoff = findSafeCutoffPoint(messages, targetCutoff);\n\n  /**\n   * If findSafeCutoffPoint moved backward (found matching AIMessage), use it.\n   */\n  if (safeCutoff <= targetCutoff) {\n    return safeCutoff;\n  }\n\n  /**\n   * Fallback: iterate backward to find a safe cutoff\n   */\n  for (let i = targetCutoff; i >= 0; i--) {\n    if (isSafeCutoffPoint(messages, i)) {\n      return i;\n    }\n  }\n\n  return 0;\n}\n\n/**\n * Check if cutting at index would separate AI/Tool message pairs\n */\nfunction isSafeCutoffPoint(\n  messages: BaseMessage[],\n  cutoffIndex: number\n): boolean {\n  if (cutoffIndex >= messages.length) {\n    return true;\n  }\n\n  /**\n   * Prevent preserved messages from starting with AI message containing tool calls\n   */\n  if (\n    cutoffIndex < messages.length &&\n    AIMessage.isInstance(messages[cutoffIndex]) &&\n    hasToolCalls(messages[cutoffIndex])\n  ) {\n    return false;\n  }\n\n  const searchStart = Math.max(0, cutoffIndex - SEARCH_RANGE_FOR_TOOL_PAIRS);\n  const searchEnd = Math.min(\n    messages.length,\n    cutoffIndex + SEARCH_RANGE_FOR_TOOL_PAIRS\n  );\n\n  for (let i = searchStart; i < searchEnd; i++) {\n    if (!hasToolCalls(messages[i])) {\n      continue;\n    }\n\n    const toolCallIds = extractToolCallIds(messages[i] as AIMessage);\n    if (cutoffSeparatesToolPair(messages, i, cutoffIndex, toolCallIds)) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\n/**\n * Extract tool call IDs from an AI message\n */\nfunction extractToolCallIds(aiMessage: AIMessage): Set<string> {\n  const toolCallIds = new Set<string>();\n  if (aiMessage.tool_calls) {\n    for (const toolCall of aiMessage.tool_calls) {\n      const id =\n        typeof toolCall === \"object\" && \"id\" in toolCall ? toolCall.id : null;\n      if (id) {\n        toolCallIds.add(id);\n      }\n    }\n  }\n  return toolCallIds;\n}\n\n/**\n * Find a safe cutoff point that doesn't split AI/Tool message pairs.\n *\n * If the message at `cutoffIndex` is a `ToolMessage`, search backward for the\n * `AIMessage` containing the corresponding `tool_calls` and adjust the cutoff to\n * include it. This ensures tool call requests and responses stay together.\n *\n * Falls back to advancing forward past `ToolMessage` objects only if no matching\n * `AIMessage` is found (edge case).\n */\nfunction findSafeCutoffPoint(\n  messages: BaseMessage[],\n  cutoffIndex: number\n): number {\n  if (\n    cutoffIndex >= messages.length ||\n    !ToolMessage.isInstance(messages[cutoffIndex])\n  ) {\n    return cutoffIndex;\n  }\n\n  // Collect tool_call_ids from consecutive ToolMessages at/after cutoff\n  const toolCallIds = new Set<string>();\n  let idx = cutoffIndex;\n  while (idx < messages.length && ToolMessage.isInstance(messages[idx])) {\n    const toolMsg = messages[idx] as ToolMessage;\n    if (toolMsg.tool_call_id) {\n      toolCallIds.add(toolMsg.tool_call_id);\n    }\n    idx++;\n  }\n\n  // Search backward for AIMessage with matching tool_calls\n  for (let i = cutoffIndex - 1; i >= 0; i--) {\n    const msg = messages[i];\n    if (AIMessage.isInstance(msg) && hasToolCalls(msg)) {\n      const aiToolCallIds = extractToolCallIds(msg as AIMessage);\n      // Check if there's any overlap between the tool_call_ids\n      for (const id of toolCallIds) {\n        if (aiToolCallIds.has(id)) {\n          // Found the AIMessage - move cutoff to include it\n          return i;\n        }\n      }\n    }\n  }\n\n  // Fallback: no matching AIMessage found, advance past ToolMessages to avoid\n  // orphaned tool responses\n  return idx;\n}\n\n/**\n * Check if cutoff separates an AI message from its corresponding tool messages\n */\nfunction cutoffSeparatesToolPair(\n  messages: BaseMessage[],\n  aiMessageIndex: number,\n  cutoffIndex: number,\n  toolCallIds: Set<string>\n): boolean {\n  for (let j = aiMessageIndex + 1; j < messages.length; j++) {\n    const message = messages[j];\n    if (\n      ToolMessage.isInstance(message) &&\n      toolCallIds.has(message.tool_call_id)\n    ) {\n      const aiBeforeCutoff = aiMessageIndex < cutoffIndex;\n      const toolBeforeCutoff = j < cutoffIndex;\n      if (aiBeforeCutoff !== toolBeforeCutoff) {\n        return true;\n      }\n    }\n  }\n  return false;\n}\n\n/**\n * Generate summary for the given messages.\n *\n * @param messagesToSummarize - Messages to summarize.\n * @param model - The language model to use for summarization.\n * @param summaryPrompt - The prompt template for summarization.\n * @param tokenCounter - Function to count tokens.\n * @param trimTokensToSummarize - Optional token limit for trimming messages.\n * @param runtime - The runtime environment, used to inherit config so that\n *   LangGraph's handlers can properly track and tag the summarization model call.\n */\nasync function createSummary(\n  messagesToSummarize: BaseMessage[],\n  model: BaseLanguageModel,\n  summaryPrompt: string,\n  tokenCounter: TokenCounter,\n  trimTokensToSummarize: number | undefined,\n  runtime: Runtime<unknown>\n): Promise<string> {\n  if (!messagesToSummarize.length) {\n    return \"No previous conversation history.\";\n  }\n\n  const trimmedMessages = await trimMessagesForSummary(\n    messagesToSummarize,\n    tokenCounter,\n    trimTokensToSummarize\n  );\n\n  if (!trimmedMessages.length) {\n    return \"Previous conversation was too long to summarize.\";\n  }\n\n  /**\n   * Format messages using getBufferString to avoid token inflation from metadata\n   * when str() / JSON.stringify is called on message objects.\n   * This produces compact output like:\n   * ```\n   * Human: What's the weather?\n   * AI: Let me check...[tool_calls]\n   * Tool: 72°F and sunny\n   * ```\n   */\n  const formattedMessages = getBufferString(trimmedMessages);\n\n  try {\n    const formattedPrompt = summaryPrompt.replace(\n      \"{messages}\",\n      formattedMessages\n    );\n    /**\n     * Merge parent runnable config with summarization metadata so LangGraph's\n     * stream handlers (and other callback-based consumers) can properly track\n     * and tag the summarization model call.\n     */\n    const baseConfig: RunnableConfig = pickRunnableConfigKeys(runtime) ?? {};\n    const config = mergeConfigs(baseConfig, {\n      metadata: { lc_source: \"summarization\" },\n    });\n    const response = await model.invoke(formattedPrompt, config);\n    const content = response.content;\n    /**\n     * Handle both string content and MessageContent array\n     */\n    if (typeof content === \"string\") {\n      return content.trim();\n    } else if (Array.isArray(content)) {\n      /**\n       * Extract text from MessageContent array\n       */\n      const textContent = content\n        .map((item) => {\n          if (typeof item === \"string\") return item;\n          if (typeof item === \"object\" && item !== null && \"text\" in item) {\n            return (item as { text: string }).text;\n          }\n          return \"\";\n        })\n        .join(\"\");\n      return textContent.trim();\n    }\n    return \"Error generating summary: Invalid response format\";\n  } catch (e) {\n    return `Error generating summary: ${e}`;\n  }\n}\n\n/**\n * Trim messages to fit within summary generation limits\n */\nasync function trimMessagesForSummary(\n  messages: BaseMessage[],\n  tokenCounter: TokenCounter,\n  trimTokensToSummarize: number | undefined\n): Promise<BaseMessage[]> {\n  if (trimTokensToSummarize === undefined) {\n    return messages;\n  }\n\n  try {\n    return await trimMessages(messages, {\n      maxTokens: trimTokensToSummarize,\n      tokenCounter: async (msgs) => tokenCounter(msgs),\n      strategy: \"last\",\n      allowPartial: true,\n      includeSystem: true,\n    });\n  } catch {\n    /**\n     * Fallback to last N messages if trimming fails\n     */\n    return messages.slice(-DEFAULT_FALLBACK_MESSAGE_COUNT);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"summarization.js","names":["z","z4","uuid"],"sources":["../../../src/agents/middleware/summarization.ts"],"sourcesContent":["import { z } from \"zod/v3\";\nimport { z as z4 } from \"zod/v4\";\nimport { v4 as uuid } from \"@langchain/core/utils/uuid\";\nimport {\n  BaseMessage,\n  AIMessage,\n  SystemMessage,\n  ToolMessage,\n  RemoveMessage,\n  trimMessages,\n  HumanMessage,\n  getBufferString,\n} from \"@langchain/core/messages\";\nimport {\n  BaseLanguageModel,\n  getModelContextSize,\n} from \"@langchain/core/language_models/base\";\nimport {\n  interopSafeParse,\n  InferInteropZodInput,\n  InferInteropZodOutput,\n} from \"@langchain/core/utils/types\";\nimport {\n  mergeConfigs,\n  pickRunnableConfigKeys,\n  type RunnableConfig,\n} from \"@langchain/core/runnables\";\nimport { REMOVE_ALL_MESSAGES } from \"@langchain/langgraph\";\nimport { createMiddleware } from \"../middleware.js\";\nimport { countTokensApproximately } from \"./utils.js\";\nimport { hasToolCalls } from \"../utils.js\";\nimport { initChatModel } from \"../../chat_models/universal.js\";\nimport type { Runtime } from \"../runtime.js\";\n\nexport const DEFAULT_SUMMARY_PROMPT = `<role>\nContext Extraction Assistant\n</role>\n\n<primary_objective>\nYour sole objective in this task is to extract the highest quality/most relevant context from the conversation history below.\n</primary_objective>\n\n<objective_information>\nYou're nearing the total number of input tokens you can accept, so you must extract the highest quality/most relevant pieces of information from your conversation history.\nThis context will then overwrite the conversation history presented below. Because of this, ensure the context you extract is only the most important information to your overall goal.\n</objective_information>\n\n<instructions>\nThe conversation history below will be replaced with the context you extract in this step. Because of this, you must do your very best to extract and record all of the most important context from the conversation history.\nYou want to ensure that you don't repeat any actions you've already completed, so the context you extract from the conversation history should be focused on the most important information to your overall goal.\n</instructions>\n\nThe user will message you with the full message history you'll be extracting context from, to then replace. Carefully read over it all, and think deeply about what information is most important to your overall goal that should be saved:\n\nWith all of this in mind, please carefully read over the entire conversation history, and extract the most important and relevant context to replace it so that you can free up space in the conversation history.\nRespond ONLY with the extracted context. Do not include any additional information, or text before or after the extracted context.\n\n<messages>\nMessages to summarize:\n{messages}\n</messages>`;\n\nconst DEFAULT_SUMMARY_PREFIX = \"Here is a summary of the conversation to date:\";\nconst DEFAULT_MESSAGES_TO_KEEP = 20;\nconst DEFAULT_TRIM_TOKEN_LIMIT = 4000;\nconst DEFAULT_FALLBACK_MESSAGE_COUNT = 15;\nconst SEARCH_RANGE_FOR_TOOL_PAIRS = 5;\n\nconst tokenCounterSchema = z\n  .function()\n  .args(z.array(z.custom<BaseMessage>()))\n  .returns(z.union([z.number(), z.promise(z.number())]));\nexport type TokenCounter = (\n  messages: BaseMessage[]\n) => number | Promise<number>;\n\nexport const contextSizeSchema = z\n  .object({\n    /**\n     * Fraction of the model's context size to use as the trigger\n     */\n    fraction: z\n      .number()\n      .gt(0, \"Fraction must be greater than 0\")\n      .max(1, \"Fraction must be less than or equal to 1\")\n      .optional(),\n    /**\n     * Number of tokens to use as the trigger\n     */\n    tokens: z.number().positive(\"Tokens must be greater than 0\").optional(),\n    /**\n     * Number of messages to use as the trigger\n     */\n    messages: z\n      .number()\n      .int(\"Messages must be an integer\")\n      .positive(\"Messages must be greater than 0\")\n      .optional(),\n  })\n  .refine(\n    (data) => {\n      const count = [data.fraction, data.tokens, data.messages].filter(\n        (v) => v !== undefined\n      ).length;\n      return count >= 1;\n    },\n    {\n      message: \"At least one of fraction, tokens, or messages must be provided\",\n    }\n  );\nexport type ContextSize = z.infer<typeof contextSizeSchema>;\n\nexport const keepSchema = z\n  .object({\n    /**\n     * Fraction of the model's context size to keep\n     */\n    fraction: z\n      .number()\n      .min(0, \"Messages must be non-negative\")\n      .max(1, \"Fraction must be less than or equal to 1\")\n      .optional(),\n    /**\n     * Number of tokens to keep\n     */\n    tokens: z\n      .number()\n      .min(0, \"Tokens must be greater than or equal to 0\")\n      .optional(),\n    messages: z\n      .number()\n      .int(\"Messages must be an integer\")\n      .min(0, \"Messages must be non-negative\")\n      .optional(),\n  })\n  .refine(\n    (data) => {\n      const count = [data.fraction, data.tokens, data.messages].filter(\n        (v) => v !== undefined\n      ).length;\n      return count === 1;\n    },\n    {\n      message: \"Exactly one of fraction, tokens, or messages must be provided\",\n    }\n  );\nexport type KeepSize = z.infer<typeof keepSchema>;\n\nconst contextSchema = z.object({\n  /**\n   * Model to use for summarization\n   */\n  model: z.custom<string | BaseLanguageModel>(),\n  /**\n   * Trigger conditions for summarization.\n   * Can be a single condition object (all properties must be met) or an array of conditions (any condition must be met).\n   *\n   * @example\n   * ```ts\n   * // Single condition: trigger if tokens >= 5000 AND messages >= 3\n   * trigger: { tokens: 5000, messages: 3 }\n   *\n   * // Multiple conditions: trigger if (tokens >= 5000 AND messages >= 3) OR (tokens >= 3000 AND messages >= 6)\n   * trigger: [\n   *   { tokens: 5000, messages: 3 },\n   *   { tokens: 3000, messages: 6 }\n   * ]\n   * ```\n   */\n  trigger: z.union([contextSizeSchema, z.array(contextSizeSchema)]).optional(),\n  /**\n   * Keep conditions for summarization\n   */\n  keep: keepSchema.optional(),\n  /**\n   * Token counter function to use for summarization\n   */\n  tokenCounter: tokenCounterSchema.optional(),\n  /**\n   * Summary prompt to use for summarization\n   * @default {@link DEFAULT_SUMMARY_PROMPT}\n   */\n  summaryPrompt: z.string().default(DEFAULT_SUMMARY_PROMPT),\n  /**\n   * Number of tokens to trim to before summarizing\n   */\n  trimTokensToSummarize: z.number().optional(),\n  /**\n   * Prefix to add to the summary\n   */\n  summaryPrefix: z.string().optional(),\n  /**\n   * @deprecated Use `trigger: { tokens: value }` instead.\n   */\n  maxTokensBeforeSummary: z.number().optional(),\n  /**\n   * @deprecated Use `keep: { messages: value }` instead.\n   */\n  messagesToKeep: z.number().optional(),\n});\n\nexport type SummarizationMiddlewareConfig = InferInteropZodInput<\n  typeof contextSchema\n>;\n\n/**\n * Get max input tokens from model profile or fallback to model name lookup\n */\nexport function getProfileLimits(input: BaseLanguageModel): number | undefined {\n  // Access maxInputTokens on the model profile directly if available\n  if (\n    \"profile\" in input &&\n    typeof input.profile === \"object\" &&\n    input.profile &&\n    \"maxInputTokens\" in input.profile &&\n    (typeof input.profile.maxInputTokens === \"number\" ||\n      input.profile.maxInputTokens == null)\n  ) {\n    return input.profile.maxInputTokens ?? undefined;\n  }\n\n  // Fallback to using model name if available\n  if (\"model\" in input && typeof input.model === \"string\") {\n    return getModelContextSize(input.model);\n  }\n  if (\"modelName\" in input && typeof input.modelName === \"string\") {\n    return getModelContextSize(input.modelName);\n  }\n\n  return undefined;\n}\n\n/**\n * Summarization middleware that automatically summarizes conversation history when token limits are approached.\n *\n * This middleware monitors message token counts and automatically summarizes older\n * messages when a threshold is reached, preserving recent messages and maintaining\n * context continuity by ensuring AI/Tool message pairs remain together.\n *\n * @param options Configuration options for the summarization middleware\n * @returns A middleware instance\n *\n * @example\n * ```ts\n * import { summarizationMiddleware } from \"langchain\";\n * import { createAgent } from \"langchain\";\n *\n * // Single condition: trigger if tokens >= 4000 AND messages >= 10\n * const agent1 = createAgent({\n *   llm: model,\n *   tools: [getWeather],\n *   middleware: [\n *     summarizationMiddleware({\n *       model: new ChatOpenAI({ model: \"gpt-4o\" }),\n *       trigger: { tokens: 4000, messages: 10 },\n *       keep: { messages: 20 },\n *     })\n *   ],\n * });\n *\n * // Multiple conditions: trigger if (tokens >= 5000 AND messages >= 3) OR (tokens >= 3000 AND messages >= 6)\n * const agent2 = createAgent({\n *   llm: model,\n *   tools: [getWeather],\n *   middleware: [\n *     summarizationMiddleware({\n *       model: new ChatOpenAI({ model: \"gpt-4o\" }),\n *       trigger: [\n *         { tokens: 5000, messages: 3 },\n *         { tokens: 3000, messages: 6 },\n *       ],\n *       keep: { messages: 20 },\n *     })\n *   ],\n * });\n *\n * ```\n */\nexport function summarizationMiddleware(\n  options: SummarizationMiddlewareConfig\n) {\n  /**\n   * Parse user options to get their explicit values\n   */\n  const { data: userOptions, error } = interopSafeParse(contextSchema, options);\n  if (error) {\n    throw new Error(\n      `Invalid summarization middleware options: ${z4.prettifyError(error)}`\n    );\n  }\n\n  return createMiddleware({\n    name: \"SummarizationMiddleware\",\n    contextSchema: contextSchema.extend({\n      /**\n       * `model` should be required when initializing the middleware,\n       * but can be omitted within context when invoking the middleware.\n       */\n      model: z.custom<BaseLanguageModel>().optional(),\n    }),\n    beforeModel: async (state, runtime) => {\n      let trigger: ContextSize | ContextSize[] | undefined =\n        userOptions.trigger;\n      let keep: ContextSize = userOptions.keep as InferInteropZodOutput<\n        typeof keepSchema\n      >;\n\n      /**\n       * Handle deprecated parameters\n       */\n      if (userOptions.maxTokensBeforeSummary !== undefined) {\n        console.warn(\n          \"maxTokensBeforeSummary is deprecated. Use `trigger: { tokens: value }` instead.\"\n        );\n        if (trigger === undefined) {\n          trigger = { tokens: userOptions.maxTokensBeforeSummary };\n        }\n      }\n\n      /**\n       * Handle deprecated parameters\n       */\n      if (userOptions.messagesToKeep !== undefined) {\n        console.warn(\n          \"messagesToKeep is deprecated. Use `keep: { messages: value }` instead.\"\n        );\n        if (\n          !keep ||\n          (keep &&\n            \"messages\" in keep &&\n            keep.messages === DEFAULT_MESSAGES_TO_KEEP)\n        ) {\n          keep = { messages: userOptions.messagesToKeep };\n        }\n      }\n\n      /**\n       * Merge context with user options\n       */\n      const resolvedTrigger =\n        runtime.context?.trigger !== undefined\n          ? runtime.context.trigger\n          : trigger;\n      const resolvedKeep =\n        runtime.context?.keep !== undefined\n          ? runtime.context.keep\n          : (keep ?? { messages: DEFAULT_MESSAGES_TO_KEEP });\n\n      const validatedKeep = keepSchema.parse(resolvedKeep);\n\n      /**\n       * Validate trigger conditions\n       */\n      let triggerConditions: ContextSize[] = [];\n      if (resolvedTrigger === undefined) {\n        triggerConditions = [];\n      } else if (Array.isArray(resolvedTrigger)) {\n        /**\n         * It's an array of ContextSize objects\n         */\n        triggerConditions = (resolvedTrigger as ContextSize[]).map((t) =>\n          contextSizeSchema.parse(t)\n        );\n      } else {\n        /**\n         * Single ContextSize object - all properties must be satisfied (AND logic)\n         */\n        triggerConditions = [contextSizeSchema.parse(resolvedTrigger)];\n      }\n\n      /**\n       * Check if profile is required\n       */\n      const requiresProfile =\n        triggerConditions.some((c) => \"fraction\" in c) ||\n        \"fraction\" in validatedKeep;\n\n      const model =\n        typeof userOptions.model === \"string\"\n          ? await initChatModel(userOptions.model)\n          : userOptions.model;\n\n      if (requiresProfile && !getProfileLimits(model)) {\n        throw new Error(\n          \"Model profile information is required to use fractional token limits. \" +\n            \"Use absolute token counts instead.\"\n        );\n      }\n\n      const summaryPrompt =\n        runtime.context?.summaryPrompt === DEFAULT_SUMMARY_PROMPT\n          ? (userOptions.summaryPrompt ?? DEFAULT_SUMMARY_PROMPT)\n          : (runtime.context?.summaryPrompt ??\n            userOptions.summaryPrompt ??\n            DEFAULT_SUMMARY_PROMPT);\n      const summaryPrefix =\n        runtime.context.summaryPrefix ??\n        userOptions.summaryPrefix ??\n        DEFAULT_SUMMARY_PREFIX;\n      const trimTokensToSummarize =\n        runtime.context?.trimTokensToSummarize !== undefined\n          ? runtime.context.trimTokensToSummarize\n          : (userOptions.trimTokensToSummarize ?? DEFAULT_TRIM_TOKEN_LIMIT);\n\n      /**\n       * Ensure all messages have IDs\n       */\n      ensureMessageIds(state.messages);\n\n      const tokenCounter =\n        runtime.context?.tokenCounter !== undefined\n          ? runtime.context.tokenCounter\n          : (userOptions.tokenCounter ?? countTokensApproximately);\n      const totalTokens = await tokenCounter(state.messages);\n      const doSummarize = await shouldSummarize(\n        state.messages,\n        totalTokens,\n        triggerConditions,\n        model\n      );\n\n      if (!doSummarize) {\n        return;\n      }\n\n      const { systemPrompt, conversationMessages } = splitSystemMessage(\n        state.messages\n      );\n      const cutoffIndex = await determineCutoffIndex(\n        conversationMessages,\n        validatedKeep,\n        tokenCounter,\n        model\n      );\n\n      if (cutoffIndex <= 0) {\n        return;\n      }\n\n      const { messagesToSummarize, preservedMessages } = partitionMessages(\n        systemPrompt,\n        conversationMessages,\n        cutoffIndex\n      );\n\n      const summary = await createSummary(\n        messagesToSummarize,\n        model,\n        summaryPrompt,\n        tokenCounter,\n        trimTokensToSummarize,\n        runtime\n      );\n\n      const summaryMessage = new HumanMessage({\n        content: `${summaryPrefix}\\n\\n${summary}`,\n        id: uuid(),\n        additional_kwargs: { lc_source: \"summarization\" },\n      });\n\n      return {\n        messages: [\n          new RemoveMessage({ id: REMOVE_ALL_MESSAGES }),\n          summaryMessage,\n          ...preservedMessages,\n        ],\n      };\n    },\n  });\n}\n\n/**\n * Ensure all messages have unique IDs\n */\nfunction ensureMessageIds(messages: BaseMessage[]): void {\n  for (const msg of messages) {\n    if (!msg.id) {\n      msg.id = uuid();\n    }\n  }\n}\n\n/**\n * Separate system message from conversation messages\n */\nfunction splitSystemMessage(messages: BaseMessage[]): {\n  systemPrompt?: SystemMessage;\n  conversationMessages: BaseMessage[];\n} {\n  if (messages.length > 0 && SystemMessage.isInstance(messages[0])) {\n    return {\n      systemPrompt: messages[0] as SystemMessage,\n      conversationMessages: messages.slice(1),\n    };\n  }\n  return {\n    conversationMessages: messages,\n  };\n}\n\n/**\n * Partition messages into those to summarize and those to preserve\n */\nfunction partitionMessages(\n  systemPrompt: SystemMessage | undefined,\n  conversationMessages: BaseMessage[],\n  cutoffIndex: number\n): { messagesToSummarize: BaseMessage[]; preservedMessages: BaseMessage[] } {\n  const messagesToSummarize = conversationMessages.slice(0, cutoffIndex);\n  const preservedMessages = conversationMessages.slice(cutoffIndex);\n\n  // Include system message in messages to summarize to capture previous summaries\n  if (systemPrompt) {\n    messagesToSummarize.unshift(systemPrompt);\n  }\n\n  return { messagesToSummarize, preservedMessages };\n}\n\n/**\n * Determine whether summarization should run for the current token usage\n *\n * @param messages - Current messages in the conversation\n * @param totalTokens - Total token count for all messages\n * @param triggerConditions - Array of trigger conditions. Returns true if ANY condition is satisfied (OR logic).\n *                           Within each condition, ALL specified properties must be satisfied (AND logic).\n * @param model - The language model being used\n * @returns true if summarization should be triggered\n */\nasync function shouldSummarize(\n  messages: BaseMessage[],\n  totalTokens: number,\n  triggerConditions: ContextSize[],\n  model: BaseLanguageModel\n): Promise<boolean> {\n  if (triggerConditions.length === 0) {\n    return false;\n  }\n\n  /**\n   * Check each condition (OR logic between conditions)\n   */\n  for (const trigger of triggerConditions) {\n    /**\n     * Within a single condition, all specified properties must be satisfied (AND logic)\n     */\n    let conditionMet = true;\n    let hasAnyProperty = false;\n\n    if (trigger.messages !== undefined) {\n      hasAnyProperty = true;\n      if (messages.length < trigger.messages) {\n        conditionMet = false;\n      }\n    }\n\n    if (trigger.tokens !== undefined) {\n      hasAnyProperty = true;\n      if (totalTokens < trigger.tokens) {\n        conditionMet = false;\n      }\n    }\n\n    if (trigger.fraction !== undefined) {\n      hasAnyProperty = true;\n      const maxInputTokens = getProfileLimits(model);\n      if (typeof maxInputTokens === \"number\") {\n        const threshold = Math.floor(maxInputTokens * trigger.fraction);\n        if (totalTokens < threshold) {\n          conditionMet = false;\n        }\n      } else {\n        /**\n         * If fraction is specified but we can't get model limits, skip this condition\n         */\n        conditionMet = false;\n      }\n    }\n\n    /**\n     * If condition has at least one property and all properties are satisfied, trigger summarization\n     */\n    if (hasAnyProperty && conditionMet) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Determine cutoff index respecting retention configuration\n */\nasync function determineCutoffIndex(\n  messages: BaseMessage[],\n  keep: ContextSize,\n  tokenCounter: TokenCounter,\n  model: BaseLanguageModel\n): Promise<number> {\n  if (\"tokens\" in keep || \"fraction\" in keep) {\n    const tokenBasedCutoff = await findTokenBasedCutoff(\n      messages,\n      keep,\n      tokenCounter,\n      model\n    );\n    if (typeof tokenBasedCutoff === \"number\") {\n      return tokenBasedCutoff;\n    }\n    /**\n     * Fallback to message count if token-based fails\n     */\n    return findSafeCutoff(messages, DEFAULT_MESSAGES_TO_KEEP);\n  }\n  /**\n   * find cutoff index based on message count\n   */\n  return findSafeCutoff(messages, keep.messages ?? DEFAULT_MESSAGES_TO_KEEP);\n}\n\n/**\n * Find cutoff index based on target token retention\n */\nasync function findTokenBasedCutoff(\n  messages: BaseMessage[],\n  keep: ContextSize,\n  tokenCounter: TokenCounter,\n  model: BaseLanguageModel\n): Promise<number | undefined> {\n  if (messages.length === 0) {\n    return 0;\n  }\n\n  let targetTokenCount: number;\n\n  if (\"fraction\" in keep && keep.fraction !== undefined) {\n    const maxInputTokens = getProfileLimits(model);\n    if (typeof maxInputTokens !== \"number\") {\n      return;\n    }\n    targetTokenCount = Math.floor(maxInputTokens * keep.fraction);\n  } else if (\"tokens\" in keep && keep.tokens !== undefined) {\n    targetTokenCount = Math.floor(keep.tokens);\n  } else {\n    return;\n  }\n\n  if (targetTokenCount <= 0) {\n    targetTokenCount = 1;\n  }\n\n  const totalTokens = await tokenCounter(messages);\n  if (totalTokens <= targetTokenCount) {\n    return 0;\n  }\n\n  /**\n   * Use binary search to identify the earliest message index that keeps the\n   * suffix within the token budget.\n   */\n  let left = 0;\n  let right = messages.length;\n  let cutoffCandidate = messages.length;\n  const maxIterations = Math.floor(Math.log2(messages.length)) + 1;\n\n  for (let i = 0; i < maxIterations; i++) {\n    if (left >= right) {\n      break;\n    }\n\n    const mid = Math.floor((left + right) / 2);\n    const suffixTokens = await tokenCounter(messages.slice(mid));\n    if (suffixTokens <= targetTokenCount) {\n      cutoffCandidate = mid;\n      right = mid;\n    } else {\n      left = mid + 1;\n    }\n  }\n\n  if (cutoffCandidate === messages.length) {\n    cutoffCandidate = left;\n  }\n\n  if (cutoffCandidate >= messages.length) {\n    if (messages.length === 1) {\n      return 0;\n    }\n    cutoffCandidate = messages.length - 1;\n  }\n\n  /**\n   * Find safe cutoff point that preserves AI/Tool pairs.\n   * If cutoff lands on ToolMessage, move backward to include the AIMessage.\n   */\n  const safeCutoff = findSafeCutoffPoint(messages, cutoffCandidate);\n\n  /**\n   * If findSafeCutoffPoint moved forward (fallback case), verify it's safe.\n   * If it moved backward, we already have a safe point.\n   */\n  if (safeCutoff <= cutoffCandidate) {\n    return safeCutoff;\n  }\n\n  /**\n   * Fallback: iterate backward to find a safe cutoff\n   */\n  for (let i = cutoffCandidate; i >= 0; i--) {\n    if (isSafeCutoffPoint(messages, i)) {\n      return i;\n    }\n  }\n\n  return 0;\n}\n\n/**\n * Find safe cutoff point that preserves AI/Tool message pairs\n */\nfunction findSafeCutoff(\n  messages: BaseMessage[],\n  messagesToKeep: number\n): number {\n  if (messages.length <= messagesToKeep) {\n    return 0;\n  }\n\n  const targetCutoff = messages.length - messagesToKeep;\n\n  /**\n   * First, try to find a safe cutoff point using findSafeCutoffPoint.\n   * This handles the case where cutoff lands on a ToolMessage by moving\n   * backward to include the corresponding AIMessage.\n   */\n  const safeCutoff = findSafeCutoffPoint(messages, targetCutoff);\n\n  /**\n   * If findSafeCutoffPoint moved backward (found matching AIMessage), use it.\n   */\n  if (safeCutoff <= targetCutoff) {\n    return safeCutoff;\n  }\n\n  /**\n   * Fallback: iterate backward to find a safe cutoff\n   */\n  for (let i = targetCutoff; i >= 0; i--) {\n    if (isSafeCutoffPoint(messages, i)) {\n      return i;\n    }\n  }\n\n  return 0;\n}\n\n/**\n * Check if cutting at index would separate AI/Tool message pairs\n */\nfunction isSafeCutoffPoint(\n  messages: BaseMessage[],\n  cutoffIndex: number\n): boolean {\n  if (cutoffIndex >= messages.length) {\n    return true;\n  }\n\n  /**\n   * Prevent preserved messages from starting with AI message containing tool calls\n   */\n  if (\n    cutoffIndex < messages.length &&\n    AIMessage.isInstance(messages[cutoffIndex]) &&\n    hasToolCalls(messages[cutoffIndex])\n  ) {\n    return false;\n  }\n\n  const searchStart = Math.max(0, cutoffIndex - SEARCH_RANGE_FOR_TOOL_PAIRS);\n  const searchEnd = Math.min(\n    messages.length,\n    cutoffIndex + SEARCH_RANGE_FOR_TOOL_PAIRS\n  );\n\n  for (let i = searchStart; i < searchEnd; i++) {\n    if (!hasToolCalls(messages[i])) {\n      continue;\n    }\n\n    const toolCallIds = extractToolCallIds(messages[i] as AIMessage);\n    if (cutoffSeparatesToolPair(messages, i, cutoffIndex, toolCallIds)) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\n/**\n * Extract tool call IDs from an AI message\n */\nfunction extractToolCallIds(aiMessage: AIMessage): Set<string> {\n  const toolCallIds = new Set<string>();\n  if (aiMessage.tool_calls) {\n    for (const toolCall of aiMessage.tool_calls) {\n      const id =\n        typeof toolCall === \"object\" && \"id\" in toolCall ? toolCall.id : null;\n      if (id) {\n        toolCallIds.add(id);\n      }\n    }\n  }\n  return toolCallIds;\n}\n\n/**\n * Find a safe cutoff point that doesn't split AI/Tool message pairs.\n *\n * If the message at `cutoffIndex` is a `ToolMessage`, search backward for the\n * `AIMessage` containing the corresponding `tool_calls` and adjust the cutoff to\n * include it. This ensures tool call requests and responses stay together.\n *\n * Falls back to advancing forward past `ToolMessage` objects only if no matching\n * `AIMessage` is found (edge case).\n */\nfunction findSafeCutoffPoint(\n  messages: BaseMessage[],\n  cutoffIndex: number\n): number {\n  if (\n    cutoffIndex >= messages.length ||\n    !ToolMessage.isInstance(messages[cutoffIndex])\n  ) {\n    return cutoffIndex;\n  }\n\n  // Collect tool_call_ids from consecutive ToolMessages at/after cutoff\n  const toolCallIds = new Set<string>();\n  let idx = cutoffIndex;\n  while (idx < messages.length && ToolMessage.isInstance(messages[idx])) {\n    const toolMsg = messages[idx] as ToolMessage;\n    if (toolMsg.tool_call_id) {\n      toolCallIds.add(toolMsg.tool_call_id);\n    }\n    idx++;\n  }\n\n  // Search backward for AIMessage with matching tool_calls\n  for (let i = cutoffIndex - 1; i >= 0; i--) {\n    const msg = messages[i];\n    if (AIMessage.isInstance(msg) && hasToolCalls(msg)) {\n      const aiToolCallIds = extractToolCallIds(msg as AIMessage);\n      // Check if there's any overlap between the tool_call_ids\n      for (const id of toolCallIds) {\n        if (aiToolCallIds.has(id)) {\n          // Found the AIMessage - move cutoff to include it\n          return i;\n        }\n      }\n    }\n  }\n\n  // Fallback: no matching AIMessage found, advance past ToolMessages to avoid\n  // orphaned tool responses\n  return idx;\n}\n\n/**\n * Check if cutoff separates an AI message from its corresponding tool messages\n */\nfunction cutoffSeparatesToolPair(\n  messages: BaseMessage[],\n  aiMessageIndex: number,\n  cutoffIndex: number,\n  toolCallIds: Set<string>\n): boolean {\n  for (let j = aiMessageIndex + 1; j < messages.length; j++) {\n    const message = messages[j];\n    if (\n      ToolMessage.isInstance(message) &&\n      toolCallIds.has(message.tool_call_id)\n    ) {\n      const aiBeforeCutoff = aiMessageIndex < cutoffIndex;\n      const toolBeforeCutoff = j < cutoffIndex;\n      if (aiBeforeCutoff !== toolBeforeCutoff) {\n        return true;\n      }\n    }\n  }\n  return false;\n}\n\n/**\n * Generate summary for the given messages.\n *\n * @param messagesToSummarize - Messages to summarize.\n * @param model - The language model to use for summarization.\n * @param summaryPrompt - The prompt template for summarization.\n * @param tokenCounter - Function to count tokens.\n * @param trimTokensToSummarize - Optional token limit for trimming messages.\n * @param runtime - The runtime environment, used to inherit config so that\n *   LangGraph's handlers can properly track and tag the summarization model call.\n */\nasync function createSummary(\n  messagesToSummarize: BaseMessage[],\n  model: BaseLanguageModel,\n  summaryPrompt: string,\n  tokenCounter: TokenCounter,\n  trimTokensToSummarize: number | undefined,\n  runtime: Runtime<unknown>\n): Promise<string> {\n  if (!messagesToSummarize.length) {\n    return \"No previous conversation history.\";\n  }\n\n  const trimmedMessages = await trimMessagesForSummary(\n    messagesToSummarize,\n    tokenCounter,\n    trimTokensToSummarize\n  );\n\n  if (!trimmedMessages.length) {\n    return \"Previous conversation was too long to summarize.\";\n  }\n\n  /**\n   * Format messages using getBufferString to avoid token inflation from metadata\n   * when str() / JSON.stringify is called on message objects.\n   * This produces compact output like:\n   * ```\n   * Human: What's the weather?\n   * AI: Let me check...[tool_calls]\n   * Tool: 72°F and sunny\n   * ```\n   */\n  const formattedMessages = getBufferString(trimmedMessages);\n\n  try {\n    const formattedPrompt = summaryPrompt.replace(\n      \"{messages}\",\n      formattedMessages\n    );\n    /**\n     * Merge parent runnable config with summarization metadata so LangGraph's\n     * stream handlers (and other callback-based consumers) can properly track\n     * and tag the summarization model call.\n     */\n    const baseConfig: RunnableConfig = pickRunnableConfigKeys(runtime) ?? {};\n    const config = mergeConfigs(baseConfig, {\n      metadata: { lc_source: \"summarization\" },\n    });\n    const response = await model.invoke(formattedPrompt, config);\n    const content = response.content;\n    /**\n     * Handle both string content and MessageContent array\n     */\n    if (typeof content === \"string\") {\n      return content.trim();\n    } else if (Array.isArray(content)) {\n      /**\n       * Extract text from MessageContent array\n       */\n      const textContent = content\n        .map((item) => {\n          if (typeof item === \"string\") return item;\n          if (typeof item === \"object\" && item !== null && \"text\" in item) {\n            return (item as { text: string }).text;\n          }\n          return \"\";\n        })\n        .join(\"\");\n      return textContent.trim();\n    }\n    return \"Error generating summary: Invalid response format\";\n  } catch (e) {\n    return `Error generating summary: ${e}`;\n  }\n}\n\n/**\n * Trim messages to fit within summary generation limits\n */\nasync function trimMessagesForSummary(\n  messages: BaseMessage[],\n  tokenCounter: TokenCounter,\n  trimTokensToSummarize: number | undefined\n): Promise<BaseMessage[]> {\n  if (trimTokensToSummarize === undefined) {\n    return messages;\n  }\n\n  try {\n    return await trimMessages(messages, {\n      maxTokens: trimTokensToSummarize,\n      tokenCounter: async (msgs) => tokenCounter(msgs),\n      strategy: \"last\",\n      allowPartial: true,\n      includeSystem: true,\n    });\n  } catch {\n    /**\n     * Fallback to last N messages if trimming fails\n     */\n    return messages.slice(-DEFAULT_FALLBACK_MESSAGE_COUNT);\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langchain",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "description": "Typescript bindings for langchain",
   "author": "LangChain",
   "license": "MIT",
@@ -50,20 +50,19 @@
     "typescript": "~5.8.3",
     "vitest": "^4.1.2",
     "yaml": "^2.8.3",
-    "@langchain/anthropic": "1.3.26",
-    "@langchain/core": "^1.1.40",
-    "@langchain/fireworks": "0.1.2",
-    "@langchain/openai": "1.4.4",
+    "@langchain/anthropic": "1.3.28",
+    "@langchain/core": "^1.1.42",
+    "@langchain/fireworks": "0.1.3",
+    "@langchain/openai": "1.4.5",
     "@langchain/tsconfig": "0.0.1"
   },
   "peerDependencies": {
-    "@langchain/core": "^1.1.40"
+    "@langchain/core": "^1.1.42"
   },
   "dependencies": {
-    "@langchain/langgraph": "^1.2.8",
+    "@langchain/langgraph": "^1.2.9",
     "@langchain/langgraph-checkpoint": "^1.0.1",
     "langsmith": ">=0.5.0 <1.0.0",
-    "uuid": "^11.1.0",
     "zod": "^3.25.76 || ^4"
   },
   "publishConfig": {