@langchain/langgraph 1.0.12 → 1.0.13

package/dist/prebuilt/react_agent_executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react_agent_executor.js","names":["model","llm","prompt"],"sources":["../../src/prebuilt/react_agent_executor.ts"],"sourcesContent":["import {\n  BaseChatModel,\n  BindToolsInput,\n} from \"@langchain/core/language_models/chat_models\";\nimport { LanguageModelLike } from \"@langchain/core/language_models/base\";\nimport {\n  BaseMessage,\n  BaseMessageLike,\n  isAIMessage,\n  isBaseMessage,\n  isToolMessage,\n  SystemMessage,\n  type AIMessage,\n} from \"@langchain/core/messages\";\nimport {\n  Runnable,\n  RunnableLambda,\n  RunnableToolLike,\n  RunnableSequence,\n  RunnableBinding,\n  type RunnableLike,\n} from \"@langchain/core/runnables\";\nimport { DynamicTool, StructuredToolInterface } from \"@langchain/core/tools\";\nimport type {\n  InteropZodObject,\n  InteropZodType,\n} from \"@langchain/core/utils/types\";\nimport {\n  All,\n  BaseCheckpointSaver,\n  BaseStore,\n} from \"@langchain/langgraph-checkpoint\";\n\nimport {\n  StateGraph,\n  type CompiledStateGraph,\n  AnnotationRoot,\n} from \"../graph/index.js\";\nimport { MessagesAnnotation } from \"../graph/messages_annotation.js\";\nimport { ToolNode } from \"./tool_node.js\";\nimport { LangGraphRunnableConfig, Runtime } from \"../pregel/runnable_types.js\";\nimport { Annotation } from \"../graph/annotation.js\";\nimport { Messages, messagesStateReducer } from \"../graph/message.js\";\nimport { END, Send, START } from \"../constants.js\";\nimport { withAgentName } from \"./agentName.js\";\nimport type { InteropZodToStateDefinition } from \"../graph/zod/meta.js\";\n\n/**\n * @deprecated `AgentState` has been moved to {@link https://www.npmjs.com/package/langchain langchain} package.\n * Update your import to `import { AgentState } from \"langchain\";`\n */\nexport interface AgentState<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  StructuredResponseType extends Record<string, any> = Record<string, any>\n> {\n  messages: BaseMessage[];\n  // TODO: This won't be set until we\n  // implement managed values in LangGraphJS\n  // Will be useful for inserting a message on\n  // graph recursion end\n  // is_last_step: boolean;\n  structuredResponse: StructuredResponseType;\n}\n\nexport type N = typeof START | \"agent\" | \"tools\";\n\ntype StructuredResponseSchemaOptions<StructuredResponseType> = {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  schema: InteropZodType<StructuredResponseType> | Record<string, any>;\n  prompt?: string;\n\n  strict?: boolean;\n  [key: string]: unknown;\n};\n\nfunction _convertMessageModifierToPrompt(\n  messageModifier: MessageModifier\n): Prompt {\n  // Handle string or SystemMessage\n  if (\n    typeof messageModifier === \"string\" ||\n    (isBaseMessage(messageModifier) && messageModifier._getType() === \"system\")\n  ) {\n    return messageModifier;\n  }\n\n  // Handle callable function\n  if (typeof messageModifier === \"function\") {\n    return async (state: typeof MessagesAnnotation.State) =>\n      messageModifier(state.messages);\n  }\n\n  // Handle Runnable\n  if (Runnable.isRunnable(messageModifier)) {\n    return RunnableLambda.from(\n      (state: typeof MessagesAnnotation.State) => state.messages\n    ).pipe(messageModifier);\n  }\n\n  throw new Error(\n    `Unexpected type for messageModifier: ${typeof messageModifier}`\n  );\n}\n\nconst PROMPT_RUNNABLE_NAME = \"prompt\";\n\nfunction _getPromptRunnable(prompt?: Prompt): Runnable {\n  let promptRunnable: Runnable;\n\n  if (prompt == null) {\n    promptRunnable = RunnableLambda.from(\n      (state: typeof MessagesAnnotation.State) => state.messages\n    ).withConfig({ runName: PROMPT_RUNNABLE_NAME });\n  } else if (typeof prompt === \"string\") {\n    const systemMessage = new SystemMessage(prompt);\n    promptRunnable = RunnableLambda.from(\n      (state: typeof MessagesAnnotation.State) => {\n        return [systemMessage, ...(state.messages ?? [])];\n      }\n    ).withConfig({ runName: PROMPT_RUNNABLE_NAME });\n  } else if (isBaseMessage(prompt) && prompt._getType() === \"system\") {\n    promptRunnable = RunnableLambda.from(\n      (state: typeof MessagesAnnotation.State) => [prompt, ...state.messages]\n    ).withConfig({ runName: PROMPT_RUNNABLE_NAME });\n  } else if (typeof prompt === \"function\") {\n    promptRunnable = RunnableLambda.from(prompt).withConfig({\n      runName: PROMPT_RUNNABLE_NAME,\n    });\n  } else if (Runnable.isRunnable(prompt)) {\n    promptRunnable = prompt;\n  } else {\n    throw new Error(`Got unexpected type for 'prompt': ${typeof prompt}`);\n  }\n\n  return promptRunnable;\n}\n\ntype ServerTool = Record<string, unknown>;\ntype ClientTool = StructuredToolInterface | DynamicTool | RunnableToolLike;\n\nfunction isClientTool(tool: ClientTool | ServerTool): tool is ClientTool {\n  return Runnable.isRunnable(tool);\n}\n\nfunction _getPrompt(\n  prompt?: Prompt,\n  stateModifier?: CreateReactAgentParams[\"stateModifier\"],\n  messageModifier?: CreateReactAgentParams[\"messageModifier\"]\n): Runnable {\n  // Check if multiple modifiers exist\n  const definedCount = [prompt, stateModifier, messageModifier].filter(\n    (x) => x != null\n  ).length;\n  if (definedCount > 1) {\n    throw new Error(\n      \"Expected only one of prompt, stateModifier, or messageModifier, got multiple values\"\n    );\n  }\n\n  let finalPrompt = prompt;\n  if (stateModifier != null) {\n    finalPrompt = stateModifier;\n  } else if (messageModifier != null) {\n    finalPrompt = _convertMessageModifierToPrompt(messageModifier);\n  }\n\n  return _getPromptRunnable(finalPrompt);\n}\n\nfunction _isBaseChatModel(model: LanguageModelLike): model is BaseChatModel {\n  return (\n    \"invoke\" in model &&\n    typeof model.invoke === \"function\" &&\n    \"_modelType\" in model\n  );\n}\n\ninterface ConfigurableModelInterface {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  _queuedMethodOperations: Record<string, any>;\n  _model: () => Promise<BaseChatModel>;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction _isConfigurableModel(model: any): model is ConfigurableModelInterface {\n  return (\n    \"_queuedMethodOperations\" in model &&\n    \"_model\" in model &&\n    typeof model._model === \"function\"\n  );\n}\n\nfunction _isChatModelWithBindTools(\n  llm: LanguageModelLike\n): llm is BaseChatModel & Required<Pick<BaseChatModel, \"bindTools\">> {\n  if (!_isBaseChatModel(llm)) return false;\n  return \"bindTools\" in llm && typeof llm.bindTools === \"function\";\n}\n\nexport async function _shouldBindTools(\n  llm: LanguageModelLike,\n  tools: (ClientTool | ServerTool)[]\n): Promise<boolean> {\n  // If model is a RunnableSequence, find a RunnableBinding or BaseChatModel in its steps\n  let model = llm;\n  if (RunnableSequence.isRunnableSequence(model)) {\n    model =\n      model.steps.find(\n        (step) =>\n          RunnableBinding.isRunnableBinding(step) ||\n          _isBaseChatModel(step) ||\n          _isConfigurableModel(step)\n      ) || model;\n  }\n\n  if (_isConfigurableModel(model)) {\n    model = await model._model();\n  }\n\n  // If not a RunnableBinding, we should bind tools\n  if (!RunnableBinding.isRunnableBinding(model)) {\n    return true;\n  }\n\n  let boundTools = (() => {\n    // check if model.kwargs contain the tools key\n    if (\n      model.kwargs != null &&\n      typeof model.kwargs === \"object\" &&\n      \"tools\" in model.kwargs &&\n      Array.isArray(model.kwargs.tools)\n    ) {\n      return (model.kwargs.tools ?? null) as BindToolsInput[] | null;\n    }\n\n    // Some models can bind the tools via `withConfig()` instead of `bind()`\n    if (\n      model.config != null &&\n      typeof model.config === \"object\" &&\n      \"tools\" in model.config &&\n      Array.isArray(model.config.tools)\n    ) {\n      return (model.config.tools ?? null) as BindToolsInput[] | null;\n    }\n\n    return null;\n  })();\n\n  // google-style\n  if (\n    boundTools != null &&\n    boundTools.length === 1 &&\n    \"functionDeclarations\" in boundTools[0]\n  ) {\n    boundTools = boundTools[0].functionDeclarations;\n  }\n\n  // If no tools in kwargs, we should bind tools\n  if (boundTools == null) return true;\n\n  // Check if tools count matches\n  if (tools.length !== boundTools.length) {\n    throw new Error(\n      \"Number of tools in the model.bindTools() and tools passed to createReactAgent must match\"\n    );\n  }\n\n  const toolNames = new Set<string>(\n    tools.flatMap((tool) => (isClientTool(tool) ? tool.name : []))\n  );\n\n  const boundToolNames = new Set<string>();\n\n  for (const boundTool of boundTools) {\n    let boundToolName: string | undefined;\n\n    // OpenAI-style tool\n    if (\"type\" in boundTool && boundTool.type === \"function\") {\n      boundToolName = boundTool.function.name;\n    }\n    // Anthropic or Google-style tool\n    else if (\"name\" in boundTool) {\n      boundToolName = boundTool.name;\n    }\n    // Bedrock-style tool\n    else if (\"toolSpec\" in boundTool && \"name\" in boundTool.toolSpec) {\n      boundToolName = boundTool.toolSpec.name;\n    }\n    // unknown tool type so we'll ignore it\n    else {\n      continue;\n    }\n\n    if (boundToolName) {\n      boundToolNames.add(boundToolName);\n    }\n  }\n\n  const missingTools = [...toolNames].filter((x) => !boundToolNames.has(x));\n  if (missingTools.length > 0) {\n    throw new Error(\n      `Missing tools '${missingTools}' in the model.bindTools().` +\n        `Tools in the model.bindTools() must match the tools passed to createReactAgent.`\n    );\n  }\n\n  return false;\n}\n\nconst _simpleBindTools = (\n  llm: LanguageModelLike,\n  toolClasses: (ClientTool | ServerTool)[]\n) => {\n  if (_isChatModelWithBindTools(llm)) {\n    return llm.bindTools(toolClasses);\n  }\n\n  if (\n    RunnableBinding.isRunnableBinding(llm) &&\n    _isChatModelWithBindTools(llm.bound)\n  ) {\n    const newBound = llm.bound.bindTools(toolClasses);\n\n    if (RunnableBinding.isRunnableBinding(newBound)) {\n      return new RunnableBinding({\n        bound: newBound.bound,\n        config: { ...llm.config, ...newBound.config },\n        kwargs: { ...llm.kwargs, ...newBound.kwargs },\n        configFactories: newBound.configFactories ?? llm.configFactories,\n      });\n    }\n\n    return new RunnableBinding({\n      bound: newBound,\n      config: llm.config,\n      kwargs: llm.kwargs,\n      configFactories: llm.configFactories,\n    });\n  }\n\n  return null;\n};\n\nexport async function _bindTools(\n  llm: LanguageModelLike,\n  toolClasses: (ClientTool | ServerTool)[]\n) {\n  const model = _simpleBindTools(llm, toolClasses);\n  if (model) return model;\n\n  if (_isConfigurableModel(llm)) {\n    const model = _simpleBindTools(await llm._model(), toolClasses);\n    if (model) return model;\n  }\n\n  if (RunnableSequence.isRunnableSequence(llm)) {\n    const modelStep = llm.steps.findIndex(\n      (step) =>\n        RunnableBinding.isRunnableBinding(step) ||\n        _isBaseChatModel(step) ||\n        _isConfigurableModel(step)\n    );\n\n    if (modelStep >= 0) {\n      const model = _simpleBindTools(llm.steps[modelStep], toolClasses);\n      if (model) {\n        const nextSteps: unknown[] = llm.steps.slice();\n        nextSteps.splice(modelStep, 1, model);\n\n        return RunnableSequence.from(\n          nextSteps as [RunnableLike, ...RunnableLike[], RunnableLike]\n        );\n      }\n    }\n  }\n\n  throw new Error(`llm ${llm} must define bindTools method.`);\n}\n\nexport async function _getModel(\n  llm: LanguageModelLike | ConfigurableModelInterface\n): Promise<LanguageModelLike> {\n  // If model is a RunnableSequence, find a RunnableBinding or BaseChatModel in its steps\n  let model = llm;\n  if (RunnableSequence.isRunnableSequence(model)) {\n    model =\n      model.steps.find(\n        (step) =>\n          RunnableBinding.isRunnableBinding(step) ||\n          _isBaseChatModel(step) ||\n          _isConfigurableModel(step)\n      ) || model;\n  }\n\n  if (_isConfigurableModel(model)) {\n    model = await model._model();\n  }\n\n  // Get the underlying model from a RunnableBinding\n  if (RunnableBinding.isRunnableBinding(model)) {\n    model = model.bound;\n  }\n\n  if (!_isBaseChatModel(model)) {\n    throw new Error(\n      `Expected \\`llm\\` to be a ChatModel or RunnableBinding (e.g. llm.bind_tools(...)) with invoke() and generate() methods, got ${model.constructor.name}`\n    );\n  }\n\n  return model;\n}\n\nexport type Prompt =\n  | SystemMessage\n  | string\n  | ((\n      state: typeof MessagesAnnotation.State,\n      config: LangGraphRunnableConfig\n    ) => BaseMessageLike[])\n  | ((\n      state: typeof MessagesAnnotation.State,\n      config: LangGraphRunnableConfig\n    ) => Promise<BaseMessageLike[]>)\n  | Runnable;\n\n/** @deprecated Use Prompt instead. */\nexport type StateModifier = Prompt;\n\n/** @deprecated Use Prompt instead. */\nexport type MessageModifier =\n  | SystemMessage\n  | string\n  | ((messages: BaseMessage[]) => BaseMessage[])\n  | ((messages: BaseMessage[]) => Promise<BaseMessage[]>)\n  | Runnable;\n\nexport const createReactAgentAnnotation = <\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  T extends Record<string, any> = Record<string, any>\n>() =>\n  Annotation.Root({\n    messages: Annotation<BaseMessage[], Messages>({\n      reducer: messagesStateReducer,\n      default: () => [],\n    }),\n    structuredResponse: Annotation<T>,\n  });\n\ntype WithStateGraphNodes<K extends string, Graph> = Graph extends StateGraph<\n  infer SD,\n  infer S,\n  infer U,\n  infer N,\n  infer I,\n  infer O,\n  infer C\n>\n  ? StateGraph<SD, S, U, N | K, I, O, C>\n  : never;\n\nconst PreHookAnnotation = Annotation.Root({\n  llmInputMessages: Annotation<BaseMessage[], Messages>({\n    reducer: (_, update) => messagesStateReducer([], update),\n    default: () => [],\n  }),\n});\n\ntype PreHookAnnotation = typeof PreHookAnnotation;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyAnnotationRoot = AnnotationRoot<any>;\n\ntype ToAnnotationRoot<A extends AnyAnnotationRoot | InteropZodObject> =\n  A extends AnyAnnotationRoot\n    ? A\n    : A extends InteropZodObject\n    ? AnnotationRoot<InteropZodToStateDefinition<A>>\n    : never;\n\n/**\n * @deprecated `CreateReactAgentParams` has been moved to {@link https://www.npmjs.com/package/langchain langchain} package.\n * Update your import to `import { CreateAgentParams } from \"langchain\";`\n */\nexport type CreateReactAgentParams<\n  A extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  StructuredResponseType extends Record<string, any> = Record<string, any>,\n  C extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot\n> = {\n  /** The chat model that can utilize OpenAI-style tool calling. */\n  llm:\n    | LanguageModelLike\n    | ((\n        state: ToAnnotationRoot<A>[\"State\"] & PreHookAnnotation[\"State\"],\n        runtime: Runtime<ToAnnotationRoot<C>[\"State\"]>\n      ) => Promise<LanguageModelLike> | LanguageModelLike);\n\n  /** A list of tools or a ToolNode. */\n  tools: ToolNode | (ServerTool | ClientTool)[];\n\n  /**\n   * @deprecated Use prompt instead.\n   */\n  messageModifier?: MessageModifier;\n\n  /**\n   * @deprecated Use prompt instead.\n   */\n  stateModifier?: StateModifier;\n\n  /**\n   * An optional prompt for the LLM. This takes full graph state BEFORE the LLM is called and prepares the input to LLM.\n   *\n   * Can take a few different forms:\n   *\n   * - str: This is converted to a SystemMessage and added to the beginning of the list of messages in state[\"messages\"].\n   * - SystemMessage: this is added to the beginning of the list of messages in state[\"messages\"].\n   * - Function: This function should take in full graph state and the output is then passed to the language model.\n   * - Runnable: This runnable should take in full graph state and the output is then passed to the language model.\n   *\n   * Note:\n   * Prior to `v0.2.46`, the prompt was set using `stateModifier` / `messagesModifier` parameters.\n   * This is now deprecated and will be removed in a future release.\n   */\n  prompt?: Prompt;\n\n  /**\n   * Additional state schema for the agent.\n   */\n  stateSchema?: A;\n\n  /**\n   * An optional schema for the context.\n   */\n  contextSchema?: C;\n  /** An optional checkpoint saver to persist the agent's state. */\n  checkpointSaver?: BaseCheckpointSaver | boolean;\n  /** An optional checkpoint saver to persist the agent's state. Alias of \"checkpointSaver\". */\n  checkpointer?: BaseCheckpointSaver | boolean;\n  /** An optional list of node names to interrupt before running. */\n  interruptBefore?: N[] | All;\n  /** An optional list of node names to interrupt after running. */\n  interruptAfter?: N[] | All;\n  store?: BaseStore;\n  /**\n   * An optional schema for the final agent output.\n   *\n   * If provided, output will be formatted to match the given schema and returned in the 'structuredResponse' state key.\n   * If not provided, `structuredResponse` will not be present in the output state.\n   *\n   * Can be passed in as:\n   *   - Zod schema\n   *   - JSON schema\n   *   - { prompt, schema }, where schema is one of the above.\n   *        The prompt will be used together with the model that is being used to generate the structured response.\n   *\n   * @remarks\n   * **Important**: `responseFormat` requires the model to support `.withStructuredOutput()`.\n   *\n   * **Note**: The graph will make a separate call to the LLM to generate the structured response after the agent loop is finished.\n   * This is not the only strategy to get structured responses, see more options in [this guide](https://langchain-ai.github.io/langgraph/how-tos/react-agent-structured-output/).\n   */\n  responseFormat?:\n    | InteropZodType<StructuredResponseType>\n    | StructuredResponseSchemaOptions<StructuredResponseType>\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    | Record<string, any>;\n\n  /**\n   * An optional name for the agent.\n   */\n  name?: string;\n\n  /**\n   * An optional description for the agent.\n   * This can be used to describe the agent to the underlying supervisor LLM.\n   */\n  description?: string | undefined;\n\n  /**\n   * Use to specify how to expose the agent name to the underlying supervisor LLM.\n\n      - undefined: Relies on the LLM provider {@link AIMessage#name}. Currently, only OpenAI supports this.\n      - `\"inline\"`: Add the agent name directly into the content field of the {@link AIMessage} using XML-style tags.\n          Example: `\"How can I help you\"` -> `\"<name>agent_name</name><content>How can I help you?</content>\"`\n   */\n  includeAgentName?: \"inline\" | undefined;\n\n  /**\n   * An optional node to add before the `agent` node (i.e., the node that calls the LLM).\n   * Useful for managing long message histories (e.g., message trimming, summarization, etc.).\n   */\n  preModelHook?: RunnableLike<\n    ToAnnotationRoot<A>[\"State\"] & PreHookAnnotation[\"State\"],\n    ToAnnotationRoot<A>[\"Update\"] & PreHookAnnotation[\"Update\"],\n    LangGraphRunnableConfig\n  >;\n\n  /**\n   * An optional node to add after the `agent` node (i.e., the node that calls the LLM).\n   * Useful for implementing human-in-the-loop, guardrails, validation, or other post-processing.\n   */\n  postModelHook?: RunnableLike<\n    ToAnnotationRoot<A>[\"State\"],\n    ToAnnotationRoot<A>[\"Update\"],\n    LangGraphRunnableConfig\n  >;\n\n  /**\n   * Determines the version of the graph to create.\n   *\n   * Can be one of\n   * - `\"v1\"`: The tool node processes a single message. All tool calls in the message are\n   *           executed in parallel within the tool node.\n   * - `\"v2\"`: The tool node processes a single tool call. Tool calls are distributed across\n   *           multiple instances of the tool node using the Send API.\n   *\n   * @default `\"v1\"`\n   */\n  version?: \"v1\" | \"v2\";\n};\n\n/**\n * @deprecated `createReactAgent` has been moved to {@link https://www.npmjs.com/package/langchain langchain} package.\n * Update your import to `import { createAgent } from \"langchain\";`\n *\n * Creates a StateGraph agent that relies on a chat model utilizing tool calling.\n *\n * @example\n * ```ts\n * import { ChatOpenAI } from \"@langchain/openai\";\n * import { tool } from \"@langchain/core/tools\";\n * import { z } from \"zod\";\n * import { createReactAgent } from \"@langchain/langgraph/prebuilt\";\n *\n * const model = new ChatOpenAI({\n *   model: \"gpt-4o\",\n * });\n *\n * const getWeather = tool((input) => {\n *   if ([\"sf\", \"san francisco\"].includes(input.location.toLowerCase())) {\n *     return \"It's 60 degrees and foggy.\";\n *   } else {\n *     return \"It's 90 degrees and sunny.\";\n *   }\n * }, {\n *   name: \"get_weather\",\n *   description: \"Call to get the current weather.\",\n *   schema: z.object({\n *     location: z.string().describe(\"Location to get the weather for.\"),\n *   })\n * })\n *\n * const agent = createReactAgent({ llm: model, tools: [getWeather] });\n *\n * const inputs = {\n *   messages: [{ role: \"user\", content: \"what is the weather in SF?\" }],\n * };\n *\n * const stream = await agent.stream(inputs, { streamMode: \"values\" });\n *\n * for await (const { messages } of stream) {\n *   console.log(messages);\n * }\n * // Returns the messages in the state at each step of execution\n * ```\n */\nexport function createReactAgent<\n  A extends AnyAnnotationRoot | InteropZodObject = typeof MessagesAnnotation,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  StructuredResponseFormat extends Record<string, any> = Record<string, any>,\n  C extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot\n>(\n  params: CreateReactAgentParams<A, StructuredResponseFormat, C>\n): CompiledStateGraph<\n  ToAnnotationRoot<A>[\"State\"],\n  ToAnnotationRoot<A>[\"Update\"],\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any,\n  typeof MessagesAnnotation.spec & ToAnnotationRoot<A>[\"spec\"],\n  ReturnType<\n    typeof createReactAgentAnnotation<StructuredResponseFormat>\n  >[\"spec\"] &\n    ToAnnotationRoot<A>[\"spec\"]\n> {\n  const {\n    llm,\n    tools,\n    messageModifier,\n    stateModifier,\n    prompt,\n    stateSchema,\n    contextSchema,\n    checkpointSaver,\n    checkpointer,\n    interruptBefore,\n    interruptAfter,\n    store,\n    responseFormat,\n    preModelHook,\n    postModelHook,\n    name,\n    description,\n    version = \"v1\",\n    includeAgentName,\n  } = params;\n\n  let toolClasses: (ClientTool | ServerTool)[];\n\n  let toolNode: ToolNode;\n  if (!Array.isArray(tools)) {\n    toolClasses = tools.tools;\n    toolNode = tools;\n  } else {\n    toolClasses = tools;\n    toolNode = new ToolNode(toolClasses.filter(isClientTool));\n  }\n\n  let cachedStaticModel: Runnable | null = null;\n\n  const _getStaticModel = async (llm: LanguageModelLike): Promise<Runnable> => {\n    if (cachedStaticModel) return cachedStaticModel;\n\n    let modelWithTools: LanguageModelLike;\n    if (await _shouldBindTools(llm, toolClasses)) {\n      modelWithTools = await _bindTools(llm, toolClasses);\n    } else {\n      modelWithTools = llm;\n    }\n\n    const promptRunnable = _getPrompt(prompt, stateModifier, messageModifier);\n    const modelRunnable =\n      includeAgentName === \"inline\"\n        ? withAgentName(modelWithTools, includeAgentName)\n        : modelWithTools;\n\n    cachedStaticModel = promptRunnable.pipe(modelRunnable);\n    return cachedStaticModel;\n  };\n\n  const _getDynamicModel = async (\n    llm: (\n      state: AgentState<StructuredResponseFormat> & PreHookAnnotation[\"State\"],\n      runtime: Runtime<ToAnnotationRoot<C>[\"State\"]>\n    ) => Promise<LanguageModelLike> | LanguageModelLike,\n    state: AgentState<StructuredResponseFormat> & PreHookAnnotation[\"State\"],\n    config: Runtime<ToAnnotationRoot<C>[\"State\"]>\n  ) => {\n    const model = await llm(state, config);\n\n    return _getPrompt(prompt, stateModifier, messageModifier).pipe(\n      includeAgentName === \"inline\"\n        ? withAgentName(model, includeAgentName)\n        : model\n    );\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  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  function getModelInputState(\n    state: AgentState<StructuredResponseFormat> & PreHookAnnotation[\"State\"]\n  ): Omit<AgentState<StructuredResponseFormat>, \"llmInputMessages\"> {\n    const { messages, llmInputMessages, ...rest } = state;\n    if (llmInputMessages != null && llmInputMessages.length > 0) {\n      return { messages: llmInputMessages, ...rest };\n    }\n    return { messages, ...rest };\n  }\n\n  const generateStructuredResponse = async (\n    state: AgentState<StructuredResponseFormat> & PreHookAnnotation[\"State\"],\n    config: Runtime<ToAnnotationRoot<C>[\"State\"]>\n  ) => {\n    if (responseFormat == null) {\n      throw new Error(\n        \"Attempted to generate structured output with no passed response schema. Please contact us for help.\"\n      );\n    }\n    const messages = [...state.messages];\n    let modelWithStructuredOutput;\n\n    const model: LanguageModelLike =\n      typeof llm === \"function\"\n        ? await llm(state, config)\n        : await _getModel(llm);\n\n    if (!_isBaseChatModel(model)) {\n      throw new Error(\n        `Expected \\`llm\\` to be a ChatModel with .withStructuredOutput() method, got ${model.constructor.name}`\n      );\n    }\n\n    if (typeof responseFormat === \"object\" && \"schema\" in responseFormat) {\n      const { prompt, schema, ...options } =\n        responseFormat as StructuredResponseSchemaOptions<StructuredResponseFormat>;\n\n      modelWithStructuredOutput = model.withStructuredOutput(schema, options);\n      if (prompt != null) {\n        messages.unshift(new SystemMessage({ content: prompt }));\n      }\n    } else {\n      modelWithStructuredOutput = model.withStructuredOutput(responseFormat);\n    }\n\n    const response = await modelWithStructuredOutput.invoke(messages, config);\n    return { structuredResponse: response };\n  };\n\n  const callModel = async (\n    state: AgentState<StructuredResponseFormat> & PreHookAnnotation[\"State\"],\n    config: Runtime<ToAnnotationRoot<C>[\"State\"]>\n  ) => {\n    // NOTE: we're dynamically creating the model runnable here\n    // to ensure that we can validate ConfigurableModel properly\n    const modelRunnable: Runnable =\n      typeof llm === \"function\"\n        ? await _getDynamicModel(llm, state, config)\n        : await _getStaticModel(llm);\n\n    // TODO: Auto-promote streaming.\n    const response = (await modelRunnable.invoke(\n      getModelInputState(state),\n      config\n    )) as BaseMessage;\n    // add agent name to the AIMessage\n    // TODO: figure out if we can avoid mutating the message directly\n    response.name = name;\n    response.lc_kwargs.name = name;\n    return { messages: [response] };\n  };\n\n  const schema =\n    stateSchema ?? createReactAgentAnnotation<StructuredResponseFormat>();\n\n  const workflow = new StateGraph(\n    schema as AnyAnnotationRoot,\n    contextSchema\n  ).addNode(\"tools\", toolNode);\n\n  if (!(\"messages\" in workflow._schemaDefinition)) {\n    throw new Error(\"Missing required `messages` key in state schema.\");\n  }\n\n  const allNodeWorkflows = workflow as WithStateGraphNodes<\n    | \"pre_model_hook\"\n    | \"post_model_hook\"\n    | \"generate_structured_response\"\n    | \"agent\",\n    typeof workflow\n  >;\n\n  const conditionalMap = <T extends string>(map: Record<string, T | null>) => {\n    return Object.fromEntries(\n      Object.entries(map).filter(([_, v]) => v != null) as [string, T][]\n    );\n  };\n\n  let entrypoint: \"agent\" | \"pre_model_hook\" = \"agent\";\n  let inputSchema: AnnotationRoot<ToAnnotationRoot<A>[\"spec\"]> | undefined;\n  if (preModelHook != null) {\n    allNodeWorkflows\n      .addNode(\"pre_model_hook\", preModelHook)\n      .addEdge(\"pre_model_hook\", \"agent\");\n    entrypoint = \"pre_model_hook\";\n\n    inputSchema = Annotation.Root({\n      ...workflow._schemaDefinition,\n      ...PreHookAnnotation.spec,\n    });\n  } else {\n    entrypoint = \"agent\";\n  }\n\n  allNodeWorkflows\n    .addNode(\"agent\", callModel, { input: inputSchema })\n    .addEdge(START, entrypoint);\n\n  if (postModelHook != null) {\n    allNodeWorkflows\n      .addNode(\"post_model_hook\", postModelHook)\n      .addEdge(\"agent\", \"post_model_hook\")\n      .addConditionalEdges(\n        \"post_model_hook\",\n        (state: AgentState<StructuredResponseFormat>) => {\n          const { messages } = state;\n\n          const toolMessageIds: Set<string> = new Set(\n            messages.filter(isToolMessage).map((msg) => msg.tool_call_id)\n          );\n\n          let lastAiMessage: AIMessage | undefined;\n          for (let i = messages.length - 1; i >= 0; i -= 1) {\n            const message = messages[i];\n            if (isAIMessage(message)) {\n              lastAiMessage = message;\n              break;\n            }\n          }\n\n          const pendingToolCalls =\n            lastAiMessage?.tool_calls?.filter(\n              (i) => i.id == null || !toolMessageIds.has(i.id)\n            ) ?? [];\n\n          const lastMessage = messages.at(-1);\n          if (pendingToolCalls.length > 0) {\n            if (version === \"v2\") {\n              return pendingToolCalls.map(\n                (toolCall) =>\n                  new Send(\"tools\", { ...state, lg_tool_call: toolCall })\n              );\n            }\n            return \"tools\";\n          }\n\n          if (lastMessage && isToolMessage(lastMessage)) return entrypoint;\n          if (responseFormat != null) return \"generate_structured_response\";\n          return END;\n        },\n        conditionalMap({\n          tools: \"tools\",\n          [entrypoint]: entrypoint,\n          generate_structured_response:\n            responseFormat != null ? \"generate_structured_response\" : null,\n          [END]: responseFormat != null ? null : END,\n        })\n      );\n  }\n\n  if (responseFormat !== undefined) {\n    workflow\n      .addNode(\"generate_structured_response\", generateStructuredResponse)\n      .addEdge(\"generate_structured_response\", END);\n  }\n\n  if (postModelHook == null) {\n    allNodeWorkflows.addConditionalEdges(\n      \"agent\",\n      (state: AgentState<StructuredResponseFormat>) => {\n        const { messages } = state;\n        const lastMessage = messages[messages.length - 1];\n\n        // if there's no function call, we finish\n        if (!isAIMessage(lastMessage) || !lastMessage.tool_calls?.length) {\n          if (responseFormat != null) return \"generate_structured_response\";\n          return END;\n        }\n\n        // there are function calls, we continue\n        if (version === \"v2\") {\n          return lastMessage.tool_calls.map(\n            (toolCall) =>\n              new Send(\"tools\", { ...state, lg_tool_call: toolCall })\n          );\n        }\n\n        return \"tools\";\n      },\n      conditionalMap({\n        tools: \"tools\",\n        generate_structured_response:\n          responseFormat != null ? \"generate_structured_response\" : null,\n        [END]: responseFormat != null ? null : END,\n      })\n    );\n  }\n\n  if (shouldReturnDirect.size > 0) {\n    allNodeWorkflows.addConditionalEdges(\n      \"tools\",\n      (state: AgentState<StructuredResponseFormat>) => {\n        // Check the last consecutive tool calls\n        for (let i = state.messages.length - 1; i >= 0; i -= 1) {\n          const message = state.messages[i];\n          if (!isToolMessage(message)) break;\n\n          // Check if this tool is configured to return directly\n          if (\n            message.name !== undefined &&\n            shouldReturnDirect.has(message.name)\n          ) {\n            return END;\n          }\n        }\n\n        return entrypoint;\n      },\n      conditionalMap({ [entrypoint]: entrypoint, [END]: END })\n    );\n  } else {\n    allNodeWorkflows.addEdge(\"tools\", entrypoint);\n  }\n\n  return allNodeWorkflows.compile({\n    checkpointer: checkpointer ?? checkpointSaver,\n    interruptBefore,\n    interruptAfter,\n    store,\n    name,\n    description,\n  });\n}\n"],"mappings":";;;;;;;;;;;AA2EA,SAAS,gCACP,iBACQ;AAER,KACE,OAAO,oBAAoB,YAC1B,cAAc,gBAAgB,IAAI,gBAAgB,UAAU,KAAK,SAElE,QAAO;AAIT,KAAI,OAAO,oBAAoB,WAC7B,QAAO,OAAO,UACZ,gBAAgB,MAAM,SAAS;AAInC,KAAI,SAAS,WAAW,gBAAgB,CACtC,QAAO,eAAe,MACnB,UAA2C,MAAM,SACnD,CAAC,KAAK,gBAAgB;AAGzB,OAAM,IAAI,MACR,wCAAwC,OAAO,kBAChD;;AAGH,MAAM,uBAAuB;AAE7B,SAAS,mBAAmB,QAA2B;CACrD,IAAI;AAEJ,KAAI,UAAU,KACZ,kBAAiB,eAAe,MAC7B,UAA2C,MAAM,SACnD,CAAC,WAAW,EAAE,SAAS,sBAAsB,CAAC;UACtC,OAAO,WAAW,UAAU;EACrC,MAAM,gBAAgB,IAAI,cAAc,OAAO;AAC/C,mBAAiB,eAAe,MAC7B,UAA2C;AAC1C,UAAO,CAAC,eAAe,GAAI,MAAM,YAAY,EAAE,CAAE;IAEpD,CAAC,WAAW,EAAE,SAAS,sBAAsB,CAAC;YACtC,cAAc,OAAO,IAAI,OAAO,UAAU,KAAK,SACxD,kBAAiB,eAAe,MAC7B,UAA2C,CAAC,QAAQ,GAAG,MAAM,SAAS,CACxE,CAAC,WAAW,EAAE,SAAS,sBAAsB,CAAC;UACtC,OAAO,WAAW,WAC3B,kBAAiB,eAAe,KAAK,OAAO,CAAC,WAAW,EACtD,SAAS,sBACV,CAAC;UACO,SAAS,WAAW,OAAO,CACpC,kBAAiB;KAEjB,OAAM,IAAI,MAAM,qCAAqC,OAAO,SAAS;AAGvE,QAAO;;AAMT,SAAS,aAAa,MAAmD;AACvE,QAAO,SAAS,WAAW,KAAK;;AAGlC,SAAS,WACP,QACA,eACA,iBACU;AAKV,KAHqB;EAAC;EAAQ;EAAe;EAAgB,CAAC,QAC3D,MAAM,KAAK,KACb,CAAC,SACiB,EACjB,OAAM,IAAI,MACR,sFACD;CAGH,IAAI,cAAc;AAClB,KAAI,iBAAiB,KACnB,eAAc;UACL,mBAAmB,KAC5B,eAAc,gCAAgC,gBAAgB;AAGhE,QAAO,mBAAmB,YAAY;;AAGxC,SAAS,iBAAiB,OAAkD;AAC1E,QACE,YAAY,SACZ,OAAO,MAAM,WAAW,cACxB,gBAAgB;;AAWpB,SAAS,qBAAqB,OAAiD;AAC7E,QACE,6BAA6B,SAC7B,YAAY,SACZ,OAAO,MAAM,WAAW;;AAI5B,SAAS,0BACP,KACmE;AACnE,KAAI,CAAC,iBAAiB,IAAI,CAAE,QAAO;AACnC,QAAO,eAAe,OAAO,OAAO,IAAI,cAAc;;AAGxD,eAAsB,iBACpB,KACA,OACkB;CAElB,IAAI,QAAQ;AACZ,KAAI,iBAAiB,mBAAmB,MAAM,CAC5C,SACE,MAAM,MAAM,MACT,SACC,gBAAgB,kBAAkB,KAAK,IACvC,iBAAiB,KAAK,IACtB,qBAAqB,KAAK,CAC7B,IAAI;AAGT,KAAI,qBAAqB,MAAM,CAC7B,SAAQ,MAAM,MAAM,QAAQ;AAI9B,KAAI,CAAC,gBAAgB,kBAAkB,MAAM,CAC3C,QAAO;CAGT,IAAI,oBAAoB;AAEtB,MACE,MAAM,UAAU,QAChB,OAAO,MAAM,WAAW,YACxB,WAAW,MAAM,UACjB,MAAM,QAAQ,MAAM,OAAO,MAAM,CAEjC,QAAQ,MAAM,OAAO,SAAS;AAIhC,MACE,MAAM,UAAU,QAChB,OAAO,MAAM,WAAW,YACxB,WAAW,MAAM,UACjB,MAAM,QAAQ,MAAM,OAAO,MAAM,CAEjC,QAAQ,MAAM,OAAO,SAAS;AAGhC,SAAO;KACL;AAGJ,KACE,cAAc,QACd,WAAW,WAAW,KACtB,0BAA0B,WAAW,GAErC,cAAa,WAAW,GAAG;AAI7B,KAAI,cAAc,KAAM,QAAO;AAG/B,KAAI,MAAM,WAAW,WAAW,OAC9B,OAAM,IAAI,MACR,2FACD;CAGH,MAAM,YAAY,IAAI,IACpB,MAAM,SAAS,SAAU,aAAa,KAAK,GAAG,KAAK,OAAO,EAAE,CAAE,CAC/D;CAED,MAAM,iCAAiB,IAAI,KAAa;AAExC,MAAK,MAAM,aAAa,YAAY;EAClC,IAAI;AAGJ,MAAI,UAAU,aAAa,UAAU,SAAS,WAC5C,iBAAgB,UAAU,SAAS;WAG5B,UAAU,UACjB,iBAAgB,UAAU;WAGnB,cAAc,aAAa,UAAU,UAAU,SACtD,iBAAgB,UAAU,SAAS;MAInC;AAGF,MAAI,cACF,gBAAe,IAAI,cAAc;;CAIrC,MAAM,eAAe,CAAC,GAAG,UAAU,CAAC,QAAQ,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC;AACzE,KAAI,aAAa,SAAS,EACxB,OAAM,IAAI,MACR,kBAAkB,aAAa,4GAEhC;AAGH,QAAO;;AAGT,MAAM,oBACJ,KACA,gBACG;AACH,KAAI,0BAA0B,IAAI,CAChC,QAAO,IAAI,UAAU,YAAY;AAGnC,KACE,gBAAgB,kBAAkB,IAAI,IACtC,0BAA0B,IAAI,MAAM,EACpC;EACA,MAAM,WAAW,IAAI,MAAM,UAAU,YAAY;AAEjD,MAAI,gBAAgB,kBAAkB,SAAS,CAC7C,QAAO,IAAI,gBAAgB;GACzB,OAAO,SAAS;GAChB,QAAQ;IAAE,GAAG,IAAI;IAAQ,GAAG,SAAS;IAAQ;GAC7C,QAAQ;IAAE,GAAG,IAAI;IAAQ,GAAG,SAAS;IAAQ;GAC7C,iBAAiB,SAAS,mBAAmB,IAAI;GAClD,CAAC;AAGJ,SAAO,IAAI,gBAAgB;GACzB,OAAO;GACP,QAAQ,IAAI;GACZ,QAAQ,IAAI;GACZ,iBAAiB,IAAI;GACtB,CAAC;;AAGJ,QAAO;;AAGT,eAAsB,WACpB,KACA,aACA;CACA,MAAM,QAAQ,iBAAiB,KAAK,YAAY;AAChD,KAAI,MAAO,QAAO;AAElB,KAAI,qBAAqB,IAAI,EAAE;EAC7B,MAAMA,UAAQ,iBAAiB,MAAM,IAAI,QAAQ,EAAE,YAAY;AAC/D,MAAIA,QAAO,QAAOA;;AAGpB,KAAI,iBAAiB,mBAAmB,IAAI,EAAE;EAC5C,MAAM,YAAY,IAAI,MAAM,WACzB,SACC,gBAAgB,kBAAkB,KAAK,IACvC,iBAAiB,KAAK,IACtB,qBAAqB,KAAK,CAC7B;AAED,MAAI,aAAa,GAAG;GAClB,MAAMA,UAAQ,iBAAiB,IAAI,MAAM,YAAY,YAAY;AACjE,OAAIA,SAAO;IACT,MAAM,YAAuB,IAAI,MAAM,OAAO;AAC9C,cAAU,OAAO,WAAW,GAAGA,QAAM;AAErC,WAAO,iBAAiB,KACtB,UACD;;;;AAKP,OAAM,IAAI,MAAM,OAAO,IAAI,gCAAgC;;AAG7D,eAAsB,UACpB,KAC4B;CAE5B,IAAI,QAAQ;AACZ,KAAI,iBAAiB,mBAAmB,MAAM,CAC5C,SACE,MAAM,MAAM,MACT,SACC,gBAAgB,kBAAkB,KAAK,IACvC,iBAAiB,KAAK,IACtB,qBAAqB,KAAK,CAC7B,IAAI;AAGT,KAAI,qBAAqB,MAAM,CAC7B,SAAQ,MAAM,MAAM,QAAQ;AAI9B,KAAI,gBAAgB,kBAAkB,MAAM,CAC1C,SAAQ,MAAM;AAGhB,KAAI,CAAC,iBAAiB,MAAM,CAC1B,OAAM,IAAI,MACR,8HAA8H,MAAM,YAAY,OACjJ;AAGH,QAAO;;AA2BT,MAAa,mCAIX,WAAW,KAAK;CACd,UAAU,WAAoC;EAC5C,SAAS;EACT,eAAe,EAAE;EAClB,CAAC;CACF,oBAAoB;CACrB,CAAC;AAcJ,MAAM,oBAAoB,WAAW,KAAK,EACxC,kBAAkB,WAAoC;CACpD,UAAU,GAAG,WAAW,qBAAqB,EAAE,EAAE,OAAO;CACxD,eAAe,EAAE;CAClB,CAAC,EACH,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0MF,SAAgB,iBAMd,QAWA;CACA,MAAM,EACJ,KACA,OACA,iBACA,eACA,QACA,aACA,eACA,iBACA,cACA,iBACA,gBACA,OACA,gBACA,cACA,eACA,MACA,aACA,UAAU,MACV,qBACE;CAEJ,IAAI;CAEJ,IAAI;AACJ,KAAI,CAAC,MAAM,QAAQ,MAAM,EAAE;AACzB,gBAAc,MAAM;AACpB,aAAW;QACN;AACL,gBAAc;AACd,aAAW,IAAI,SAAS,YAAY,OAAO,aAAa,CAAC;;CAG3D,IAAI,oBAAqC;CAEzC,MAAM,kBAAkB,OAAO,UAA8C;AAC3E,MAAI,kBAAmB,QAAO;EAE9B,IAAI;AACJ,MAAI,MAAM,iBAAiBC,OAAK,YAAY,CAC1C,kBAAiB,MAAM,WAAWA,OAAK,YAAY;MAEnD,kBAAiBA;EAGnB,MAAM,iBAAiB,WAAW,QAAQ,eAAe,gBAAgB;EACzE,MAAM,gBACJ,qBAAqB,WACjB,cAAc,gBAAgB,iBAAiB,GAC/C;AAEN,sBAAoB,eAAe,KAAK,cAAc;AACtD,SAAO;;CAGT,MAAM,mBAAmB,OACvB,OAIA,OACA,WACG;EACH,MAAM,QAAQ,MAAMA,MAAI,OAAO,OAAO;AAEtC,SAAO,WAAW,QAAQ,eAAe,gBAAgB,CAAC,KACxD,qBAAqB,WACjB,cAAc,OAAO,iBAAiB,GACtC,MACL;;CAKH,MAAM,qBAAqB,IAAI,IAC7B,YACG,OAAO,aAAa,CACpB,QAAQ,SAAS,kBAAkB,QAAQ,KAAK,aAAa,CAC7D,KAAK,SAAS,KAAK,KAAK,CAC5B;CAED,SAAS,mBACP,OACgE;EAChE,MAAM,EAAE,UAAU,kBAAkB,GAAG,SAAS;AAChD,MAAI,oBAAoB,QAAQ,iBAAiB,SAAS,EACxD,QAAO;GAAE,UAAU;GAAkB,GAAG;GAAM;AAEhD,SAAO;GAAE;GAAU,GAAG;GAAM;;CAG9B,MAAM,6BAA6B,OACjC,OACA,WACG;AACH,MAAI,kBAAkB,KACpB,OAAM,IAAI,MACR,sGACD;EAEH,MAAM,WAAW,CAAC,GAAG,MAAM,SAAS;EACpC,IAAI;EAEJ,MAAM,QACJ,OAAO,QAAQ,aACX,MAAM,IAAI,OAAO,OAAO,GACxB,MAAM,UAAU,IAAI;AAE1B,MAAI,CAAC,iBAAiB,MAAM,CAC1B,OAAM,IAAI,MACR,+EAA+E,MAAM,YAAY,OAClG;AAGH,MAAI,OAAO,mBAAmB,YAAY,YAAY,gBAAgB;GACpE,MAAM,EAAE,kBAAQ,QAAQ,GAAG,YACzB;AAEF,+BAA4B,MAAM,qBAAqB,QAAQ,QAAQ;AACvE,OAAIC,YAAU,KACZ,UAAS,QAAQ,IAAI,cAAc,EAAE,SAASA,UAAQ,CAAC,CAAC;QAG1D,6BAA4B,MAAM,qBAAqB,eAAe;AAIxE,SAAO,EAAE,oBADQ,MAAM,0BAA0B,OAAO,UAAU,OAAO,EAClC;;CAGzC,MAAM,YAAY,OAChB,OACA,WACG;EASH,MAAM,WAAY,OALhB,OAAO,QAAQ,aACX,MAAM,iBAAiB,KAAK,OAAO,OAAO,GAC1C,MAAM,gBAAgB,IAAI,EAGM,OACpC,mBAAmB,MAAM,EACzB,OACD;AAGD,WAAS,OAAO;AAChB,WAAS,UAAU,OAAO;AAC1B,SAAO,EAAE,UAAU,CAAC,SAAS,EAAE;;CAMjC,MAAM,WAAW,IAAI,WAFnB,eAAe,4BAAsD,EAIrE,cACD,CAAC,QAAQ,SAAS,SAAS;AAE5B,KAAI,EAAE,cAAc,SAAS,mBAC3B,OAAM,IAAI,MAAM,mDAAmD;CAGrE,MAAM,mBAAmB;CAQzB,MAAM,kBAAoC,QAAkC;AAC1E,SAAO,OAAO,YACZ,OAAO,QAAQ,IAAI,CAAC,QAAQ,CAAC,GAAG,OAAO,KAAK,KAAK,CAClD;;CAGH,IAAI,aAAyC;CAC7C,IAAI;AACJ,KAAI,gBAAgB,MAAM;AACxB,mBACG,QAAQ,kBAAkB,aAAa,CACvC,QAAQ,kBAAkB,QAAQ;AACrC,eAAa;AAEb,gBAAc,WAAW,KAAK;GAC5B,GAAG,SAAS;GACZ,GAAG,kBAAkB;GACtB,CAAC;OAEF,cAAa;AAGf,kBACG,QAAQ,SAAS,WAAW,EAAE,OAAO,aAAa,CAAC,CACnD,QAAQ,OAAO,WAAW;AAE7B,KAAI,iBAAiB,KACnB,kBACG,QAAQ,mBAAmB,cAAc,CACzC,QAAQ,SAAS,kBAAkB,CACnC,oBACC,oBACC,UAAgD;EAC/C,MAAM,EAAE,aAAa;EAErB,MAAM,iBAA8B,IAAI,IACtC,SAAS,OAAO,cAAc,CAAC,KAAK,QAAQ,IAAI,aAAa,CAC9D;EAED,IAAI;AACJ,OAAK,IAAI,IAAI,SAAS,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG;GAChD,MAAM,UAAU,SAAS;AACzB,OAAI,YAAY,QAAQ,EAAE;AACxB,oBAAgB;AAChB;;;EAIJ,MAAM,mBACJ,eAAe,YAAY,QACxB,MAAM,EAAE,MAAM,QAAQ,CAAC,eAAe,IAAI,EAAE,GAAG,CACjD,IAAI,EAAE;EAET,MAAM,cAAc,SAAS,GAAG,GAAG;AACnC,MAAI,iBAAiB,SAAS,GAAG;AAC/B,OAAI,YAAY,KACd,QAAO,iBAAiB,KACrB,aACC,IAAI,KAAK,SAAS;IAAE,GAAG;IAAO,cAAc;IAAU,CAAC,CAC1D;AAEH,UAAO;;AAGT,MAAI,eAAe,cAAc,YAAY,CAAE,QAAO;AACtD,MAAI,kBAAkB,KAAM,QAAO;AACnC,SAAO;IAET,eAAe;EACb,OAAO;GACN,aAAa;EACd,8BACE,kBAAkB,OAAO,iCAAiC;GAC3D,MAAM,kBAAkB,OAAO,OAAO;EACxC,CAAC,CACH;AAGL,KAAI,mBAAmB,OACrB,UACG,QAAQ,gCAAgC,2BAA2B,CACnE,QAAQ,gCAAgC,IAAI;AAGjD,KAAI,iBAAiB,KACnB,kBAAiB,oBACf,UACC,UAAgD;EAC/C,MAAM,EAAE,aAAa;EACrB,MAAM,cAAc,SAAS,SAAS,SAAS;AAG/C,MAAI,CAAC,YAAY,YAAY,IAAI,CAAC,YAAY,YAAY,QAAQ;AAChE,OAAI,kBAAkB,KAAM,QAAO;AACnC,UAAO;;AAIT,MAAI,YAAY,KACd,QAAO,YAAY,WAAW,KAC3B,aACC,IAAI,KAAK,SAAS;GAAE,GAAG;GAAO,cAAc;GAAU,CAAC,CAC1D;AAGH,SAAO;IAET,eAAe;EACb,OAAO;EACP,8BACE,kBAAkB,OAAO,iCAAiC;GAC3D,MAAM,kBAAkB,OAAO,OAAO;EACxC,CAAC,CACH;AAGH,KAAI,mBAAmB,OAAO,EAC5B,kBAAiB,oBACf,UACC,UAAgD;AAE/C,OAAK,IAAI,IAAI,MAAM,SAAS,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG;GACtD,MAAM,UAAU,MAAM,SAAS;AAC/B,OAAI,CAAC,cAAc,QAAQ,CAAE;AAG7B,OACE,QAAQ,SAAS,UACjB,mBAAmB,IAAI,QAAQ,KAAK,CAEpC,QAAO;;AAIX,SAAO;IAET,eAAe;GAAG,aAAa;GAAa,MAAM;EAAK,CAAC,CACzD;KAED,kBAAiB,QAAQ,SAAS,WAAW;AAG/C,QAAO,iBAAiB,QAAQ;EAC9B,cAAc,gBAAgB;EAC9B;EACA;EACA;EACA;EACA;EACD,CAAC"}

package/dist/prebuilt/tool_executor.cjs

@@ -0,0 +1,43 @@
+let _langchain_core_runnables = require("@langchain/core/runnables");
+
+//#region src/prebuilt/tool_executor.ts
+const INVALID_TOOL_MSG_TEMPLATE = `{requestedToolName} is not a valid tool, try one of {availableToolNamesString}.`;
+/** @deprecated Use {@link ToolNode} instead. */
+var ToolExecutor = class extends _langchain_core_runnables.RunnableBinding {
+	lc_graph_name = "ToolExecutor";
+	tools;
+	toolMap;
+	invalidToolMsgTemplate;
+	constructor(fields) {
+		const fieldsWithDefaults = {
+			invalidToolMsgTemplate: INVALID_TOOL_MSG_TEMPLATE,
+			...fields
+		};
+		const bound = _langchain_core_runnables.RunnableLambda.from(async (input, config) => this._execute(input, config));
+		super({
+			bound,
+			config: {}
+		});
+		this.tools = fieldsWithDefaults.tools;
+		this.invalidToolMsgTemplate = fieldsWithDefaults.invalidToolMsgTemplate;
+		this.toolMap = this.tools.reduce((acc, tool) => {
+			acc[tool.name] = tool;
+			return acc;
+		}, {});
+	}
+	/**
+	* Execute a tool invocation
+	*
+	* @param {ToolInvocationInterface} toolInvocation The tool to invoke and the input to pass to it.
+	* @param {RunnableConfig | undefined} config Optional configuration to pass to the tool when invoked.
+	* @returns Either the result of the tool invocation (`string` or `ToolMessage`, set by the `ToolOutput` generic) or a string error message.
+	*/
+	async _execute(toolInvocation, config) {
+		if (!(toolInvocation.tool in this.toolMap)) return this.invalidToolMsgTemplate.replace("{requestedToolName}", toolInvocation.tool).replace("{availableToolNamesString}", Object.keys(this.toolMap).join(", "));
+		else return await this.toolMap[toolInvocation.tool].invoke(toolInvocation.toolInput, config);
+	}
+};
+
+//#endregion
+exports.ToolExecutor = ToolExecutor;
+//# sourceMappingURL=tool_executor.cjs.map

package/dist/prebuilt/tool_executor.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool_executor.cjs","names":["RunnableBinding","RunnableLambda"],"sources":["../../src/prebuilt/tool_executor.ts"],"sourcesContent":["import {\n  RunnableBinding,\n  RunnableConfig,\n  RunnableLambda,\n  RunnableToolLike,\n} from \"@langchain/core/runnables\";\nimport { StructuredToolInterface } from \"@langchain/core/tools\";\n\nconst INVALID_TOOL_MSG_TEMPLATE = `{requestedToolName} is not a valid tool, try one of {availableToolNamesString}.`;\n\n/** @deprecated Use {@link ToolNode} instead. */\nexport interface ToolExecutorArgs {\n  tools: Array<StructuredToolInterface | RunnableToolLike>;\n  /**\n   * @default {INVALID_TOOL_MSG_TEMPLATE}\n   */\n  invalidToolMsgTemplate?: string;\n}\n\n/**\n * Interface for invoking a tool\n */\nexport interface ToolInvocationInterface {\n  tool: string;\n  toolInput: string;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype ToolExecutorInputType = any;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype ToolExecutorOutputType = any;\n\n/** @deprecated Use {@link ToolNode} instead. */\nexport class ToolExecutor extends RunnableBinding<\n  ToolExecutorInputType,\n  ToolExecutorOutputType\n> {\n  lc_graph_name = \"ToolExecutor\";\n\n  tools: Array<StructuredToolInterface | RunnableToolLike>;\n\n  toolMap: Record<string, StructuredToolInterface | RunnableToolLike>;\n\n  invalidToolMsgTemplate: string;\n\n  constructor(fields: ToolExecutorArgs) {\n    const fieldsWithDefaults = {\n      invalidToolMsgTemplate: INVALID_TOOL_MSG_TEMPLATE,\n      ...fields,\n    };\n    const bound = RunnableLambda.from(\n      async (input: ToolInvocationInterface, config?: RunnableConfig) =>\n        this._execute(input, config)\n    );\n    super({\n      bound,\n      config: {},\n    });\n    this.tools = fieldsWithDefaults.tools;\n    this.invalidToolMsgTemplate = fieldsWithDefaults.invalidToolMsgTemplate;\n    this.toolMap = this.tools.reduce((acc, tool) => {\n      acc[tool.name] = tool;\n      return acc;\n    }, {} as Record<string, StructuredToolInterface | RunnableToolLike>);\n  }\n\n  /**\n   * Execute a tool invocation\n   *\n   * @param {ToolInvocationInterface} toolInvocation The tool to invoke and the input to pass to it.\n   * @param {RunnableConfig | undefined} config Optional configuration to pass to the tool when invoked.\n   * @returns Either the result of the tool invocation (`string` or `ToolMessage`, set by the `ToolOutput` generic) or a string error message.\n   */\n  async _execute(\n    toolInvocation: ToolInvocationInterface,\n    config?: RunnableConfig\n  ): Promise<ToolExecutorOutputType> {\n    if (!(toolInvocation.tool in this.toolMap)) {\n      return this.invalidToolMsgTemplate\n        .replace(\"{requestedToolName}\", toolInvocation.tool)\n        .replace(\n          \"{availableToolNamesString}\",\n          Object.keys(this.toolMap).join(\", \")\n        );\n    } else {\n      const tool = this.toolMap[toolInvocation.tool];\n      const output = await tool.invoke(toolInvocation.toolInput, config);\n      return output;\n    }\n  }\n}\n"],"mappings":";;;AAQA,MAAM,4BAA4B;;AA0BlC,IAAa,eAAb,cAAkCA,0CAGhC;CACA,gBAAgB;CAEhB;CAEA;CAEA;CAEA,YAAY,QAA0B;EACpC,MAAM,qBAAqB;GACzB,wBAAwB;GACxB,GAAG;GACJ;EACD,MAAM,QAAQC,yCAAe,KAC3B,OAAO,OAAgC,WACrC,KAAK,SAAS,OAAO,OAAO,CAC/B;AACD,QAAM;GACJ;GACA,QAAQ,EAAE;GACX,CAAC;AACF,OAAK,QAAQ,mBAAmB;AAChC,OAAK,yBAAyB,mBAAmB;AACjD,OAAK,UAAU,KAAK,MAAM,QAAQ,KAAK,SAAS;AAC9C,OAAI,KAAK,QAAQ;AACjB,UAAO;KACN,EAAE,CAA+D;;;;;;;;;CAUtE,MAAM,SACJ,gBACA,QACiC;AACjC,MAAI,EAAE,eAAe,QAAQ,KAAK,SAChC,QAAO,KAAK,uBACT,QAAQ,uBAAuB,eAAe,KAAK,CACnD,QACC,8BACA,OAAO,KAAK,KAAK,QAAQ,CAAC,KAAK,KAAK,CACrC;MAIH,QADe,MADF,KAAK,QAAQ,eAAe,MACf,OAAO,eAAe,WAAW,OAAO"}

package/dist/prebuilt/tool_executor.d.cts

@@ -0,0 +1,40 @@
+import { RunnableBinding, RunnableConfig, RunnableToolLike } from "@langchain/core/runnables";
+import { StructuredToolInterface } from "@langchain/core/tools";
+
+//#region src/prebuilt/tool_executor.d.ts
+/** @deprecated Use {@link ToolNode} instead. */
+interface ToolExecutorArgs {
+  tools: Array<StructuredToolInterface | RunnableToolLike>;
+  /**
+   * @default {INVALID_TOOL_MSG_TEMPLATE}
+   */
+  invalidToolMsgTemplate?: string;
+}
+/**
+ * Interface for invoking a tool
+ */
+interface ToolInvocationInterface {
+  tool: string;
+  toolInput: string;
+}
+type ToolExecutorInputType = any;
+type ToolExecutorOutputType = any;
+/** @deprecated Use {@link ToolNode} instead. */
+declare class ToolExecutor extends RunnableBinding<ToolExecutorInputType, ToolExecutorOutputType> {
+  lc_graph_name: string;
+  tools: Array<StructuredToolInterface | RunnableToolLike>;
+  toolMap: Record<string, StructuredToolInterface | RunnableToolLike>;
+  invalidToolMsgTemplate: string;
+  constructor(fields: ToolExecutorArgs);
+  /**
+   * Execute a tool invocation
+   *
+   * @param {ToolInvocationInterface} toolInvocation The tool to invoke and the input to pass to it.
+   * @param {RunnableConfig | undefined} config Optional configuration to pass to the tool when invoked.
+   * @returns Either the result of the tool invocation (`string` or `ToolMessage`, set by the `ToolOutput` generic) or a string error message.
+   */
+  _execute(toolInvocation: ToolInvocationInterface, config?: RunnableConfig): Promise<ToolExecutorOutputType>;
+}
+//#endregion
+export { ToolExecutor, ToolExecutorArgs, ToolInvocationInterface };
+//# sourceMappingURL=tool_executor.d.cts.map

package/dist/prebuilt/tool_executor.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool_executor.d.cts","names":["RunnableBinding","RunnableConfig","RunnableToolLike","StructuredToolInterface","ToolExecutorArgs","Array","ToolInvocationInterface","ToolExecutorInputType","ToolExecutorOutputType","ToolExecutor","Record","Promise"],"sources":["../../src/prebuilt/tool_executor.d.ts"],"sourcesContent":["import { RunnableBinding, RunnableConfig, RunnableToolLike } from \"@langchain/core/runnables\";\nimport { StructuredToolInterface } from \"@langchain/core/tools\";\n/** @deprecated Use {@link ToolNode} instead. */\nexport interface ToolExecutorArgs {\n    tools: Array<StructuredToolInterface | RunnableToolLike>;\n    /**\n     * @default {INVALID_TOOL_MSG_TEMPLATE}\n     */\n    invalidToolMsgTemplate?: string;\n}\n/**\n * Interface for invoking a tool\n */\nexport interface ToolInvocationInterface {\n    tool: string;\n    toolInput: string;\n}\ntype ToolExecutorInputType = any;\ntype ToolExecutorOutputType = any;\n/** @deprecated Use {@link ToolNode} instead. */\nexport declare class ToolExecutor extends RunnableBinding<ToolExecutorInputType, ToolExecutorOutputType> {\n    lc_graph_name: string;\n    tools: Array<StructuredToolInterface | RunnableToolLike>;\n    toolMap: Record<string, StructuredToolInterface | RunnableToolLike>;\n    invalidToolMsgTemplate: string;\n    constructor(fields: ToolExecutorArgs);\n    /**\n     * Execute a tool invocation\n     *\n     * @param {ToolInvocationInterface} toolInvocation The tool to invoke and the input to pass to it.\n     * @param {RunnableConfig | undefined} config Optional configuration to pass to the tool when invoked.\n     * @returns Either the result of the tool invocation (`string` or `ToolMessage`, set by the `ToolOutput` generic) or a string error message.\n     */\n    _execute(toolInvocation: ToolInvocationInterface, config?: RunnableConfig): Promise<ToolExecutorOutputType>;\n}\nexport {};\n"],"mappings":";;;;;UAGiBI,gBAAAA;EAAAA,KAAAA,EACNC,KADMD,CACAD,uBADgB,GACUD,gBADV,CAAA;EAAA;;;wBACtBG,CAAAA,EAAAA,MAAAA;;AASX;AAGC;AACyB;AAGLI,UAPJH,uBAAAA,CAOgB;EAAA,IAAA,EAAA,MAAA;WAAyBC,EAAAA,MAAAA;;KAHrDA,qBAAAA,GAKYJ,GAAAA;KAJZK,sBAAAA,GAIsCN,GAAAA;;AACfC,cAHPM,YAAAA,SAAqBT,eAGdG,CAH8BI,qBAG9BJ,EAHqDK,sBAGrDL,CAAAA,CAAAA;eAA0BD,EAAAA,MAAAA;OAAzCQ,EADFL,KACEK,CADIP,uBACJO,GAD8BR,gBAC9BQ,CAAAA;SAEWN,EAFXM,MAEWN,CAAAA,MAAAA,EAFID,uBAEJC,GAF8BF,gBAE9BE,CAAAA;wBAQKE,EAAAA,MAAAA;aAAkCL,CAAAA,MAAAA,EARvCG,gBAQuCH;;;;;;;;2BAAlCK,kCAAkCL,iBAAiBU,QAAQH"}

package/dist/prebuilt/tool_executor.d.ts

@@ -0,0 +1,40 @@
+import { RunnableBinding, RunnableConfig, RunnableToolLike } from "@langchain/core/runnables";
+import { StructuredToolInterface } from "@langchain/core/tools";
+
+//#region src/prebuilt/tool_executor.d.ts
+/** @deprecated Use {@link ToolNode} instead. */
+interface ToolExecutorArgs {
+  tools: Array<StructuredToolInterface | RunnableToolLike>;
+  /**
+   * @default {INVALID_TOOL_MSG_TEMPLATE}
+   */
+  invalidToolMsgTemplate?: string;
+}
+/**
+ * Interface for invoking a tool
+ */
+interface ToolInvocationInterface {
+  tool: string;
+  toolInput: string;
+}
+type ToolExecutorInputType = any;
+type ToolExecutorOutputType = any;
+/** @deprecated Use {@link ToolNode} instead. */
+declare class ToolExecutor extends RunnableBinding<ToolExecutorInputType, ToolExecutorOutputType> {
+  lc_graph_name: string;
+  tools: Array<StructuredToolInterface | RunnableToolLike>;
+  toolMap: Record<string, StructuredToolInterface | RunnableToolLike>;
+  invalidToolMsgTemplate: string;
+  constructor(fields: ToolExecutorArgs);
+  /**
+   * Execute a tool invocation
+   *
+   * @param {ToolInvocationInterface} toolInvocation The tool to invoke and the input to pass to it.
+   * @param {RunnableConfig | undefined} config Optional configuration to pass to the tool when invoked.
+   * @returns Either the result of the tool invocation (`string` or `ToolMessage`, set by the `ToolOutput` generic) or a string error message.
+   */
+  _execute(toolInvocation: ToolInvocationInterface, config?: RunnableConfig): Promise<ToolExecutorOutputType>;
+}
+//#endregion
+export { ToolExecutor, ToolExecutorArgs, ToolInvocationInterface };
+//# sourceMappingURL=tool_executor.d.ts.map

package/dist/prebuilt/tool_executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool_executor.d.ts","names":["RunnableBinding","RunnableConfig","RunnableToolLike","StructuredToolInterface","ToolExecutorArgs","Array","ToolInvocationInterface","ToolExecutorInputType","ToolExecutorOutputType","ToolExecutor","Record","Promise"],"sources":["../../src/prebuilt/tool_executor.d.ts"],"sourcesContent":["import { RunnableBinding, RunnableConfig, RunnableToolLike } from \"@langchain/core/runnables\";\nimport { StructuredToolInterface } from \"@langchain/core/tools\";\n/** @deprecated Use {@link ToolNode} instead. */\nexport interface ToolExecutorArgs {\n    tools: Array<StructuredToolInterface | RunnableToolLike>;\n    /**\n     * @default {INVALID_TOOL_MSG_TEMPLATE}\n     */\n    invalidToolMsgTemplate?: string;\n}\n/**\n * Interface for invoking a tool\n */\nexport interface ToolInvocationInterface {\n    tool: string;\n    toolInput: string;\n}\ntype ToolExecutorInputType = any;\ntype ToolExecutorOutputType = any;\n/** @deprecated Use {@link ToolNode} instead. */\nexport declare class ToolExecutor extends RunnableBinding<ToolExecutorInputType, ToolExecutorOutputType> {\n    lc_graph_name: string;\n    tools: Array<StructuredToolInterface | RunnableToolLike>;\n    toolMap: Record<string, StructuredToolInterface | RunnableToolLike>;\n    invalidToolMsgTemplate: string;\n    constructor(fields: ToolExecutorArgs);\n    /**\n     * Execute a tool invocation\n     *\n     * @param {ToolInvocationInterface} toolInvocation The tool to invoke and the input to pass to it.\n     * @param {RunnableConfig | undefined} config Optional configuration to pass to the tool when invoked.\n     * @returns Either the result of the tool invocation (`string` or `ToolMessage`, set by the `ToolOutput` generic) or a string error message.\n     */\n    _execute(toolInvocation: ToolInvocationInterface, config?: RunnableConfig): Promise<ToolExecutorOutputType>;\n}\nexport {};\n"],"mappings":";;;;;UAGiBI,gBAAAA;EAAAA,KAAAA,EACNC,KADMD,CACAD,uBADgB,GACUD,gBADV,CAAA;EAAA;;;wBACtBG,CAAAA,EAAAA,MAAAA;;AASX;AAGC;AACyB;AAGLI,UAPJH,uBAAAA,CAOgB;EAAA,IAAA,EAAA,MAAA;WAAyBC,EAAAA,MAAAA;;KAHrDA,qBAAAA,GAKYJ,GAAAA;KAJZK,sBAAAA,GAIsCN,GAAAA;;AACfC,cAHPM,YAAAA,SAAqBT,eAGdG,CAH8BI,qBAG9BJ,EAHqDK,sBAGrDL,CAAAA,CAAAA;eAA0BD,EAAAA,MAAAA;OAAzCQ,EADFL,KACEK,CADIP,uBACJO,GAD8BR,gBAC9BQ,CAAAA;SAEWN,EAFXM,MAEWN,CAAAA,MAAAA,EAFID,uBAEJC,GAF8BF,gBAE9BE,CAAAA;wBAQKE,EAAAA,MAAAA;aAAkCL,CAAAA,MAAAA,EARvCG,gBAQuCH;;;;;;;;2BAAlCK,kCAAkCL,iBAAiBU,QAAQH"}

package/dist/prebuilt/tool_executor.js

@@ -0,0 +1,43 @@
+import { RunnableBinding, RunnableLambda } from "@langchain/core/runnables";
+
+//#region src/prebuilt/tool_executor.ts
+const INVALID_TOOL_MSG_TEMPLATE = `{requestedToolName} is not a valid tool, try one of {availableToolNamesString}.`;
+/** @deprecated Use {@link ToolNode} instead. */
+var ToolExecutor = class extends RunnableBinding {
+	lc_graph_name = "ToolExecutor";
+	tools;
+	toolMap;
+	invalidToolMsgTemplate;
+	constructor(fields) {
+		const fieldsWithDefaults = {
+			invalidToolMsgTemplate: INVALID_TOOL_MSG_TEMPLATE,
+			...fields
+		};
+		const bound = RunnableLambda.from(async (input, config) => this._execute(input, config));
+		super({
+			bound,
+			config: {}
+		});
+		this.tools = fieldsWithDefaults.tools;
+		this.invalidToolMsgTemplate = fieldsWithDefaults.invalidToolMsgTemplate;
+		this.toolMap = this.tools.reduce((acc, tool) => {
+			acc[tool.name] = tool;
+			return acc;
+		}, {});
+	}
+	/**
+	* Execute a tool invocation
+	*
+	* @param {ToolInvocationInterface} toolInvocation The tool to invoke and the input to pass to it.
+	* @param {RunnableConfig | undefined} config Optional configuration to pass to the tool when invoked.
+	* @returns Either the result of the tool invocation (`string` or `ToolMessage`, set by the `ToolOutput` generic) or a string error message.
+	*/
+	async _execute(toolInvocation, config) {
+		if (!(toolInvocation.tool in this.toolMap)) return this.invalidToolMsgTemplate.replace("{requestedToolName}", toolInvocation.tool).replace("{availableToolNamesString}", Object.keys(this.toolMap).join(", "));
+		else return await this.toolMap[toolInvocation.tool].invoke(toolInvocation.toolInput, config);
+	}
+};
+
+//#endregion
+export { ToolExecutor };
+//# sourceMappingURL=tool_executor.js.map

package/dist/prebuilt/tool_executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool_executor.js","names":[],"sources":["../../src/prebuilt/tool_executor.ts"],"sourcesContent":["import {\n  RunnableBinding,\n  RunnableConfig,\n  RunnableLambda,\n  RunnableToolLike,\n} from \"@langchain/core/runnables\";\nimport { StructuredToolInterface } from \"@langchain/core/tools\";\n\nconst INVALID_TOOL_MSG_TEMPLATE = `{requestedToolName} is not a valid tool, try one of {availableToolNamesString}.`;\n\n/** @deprecated Use {@link ToolNode} instead. */\nexport interface ToolExecutorArgs {\n  tools: Array<StructuredToolInterface | RunnableToolLike>;\n  /**\n   * @default {INVALID_TOOL_MSG_TEMPLATE}\n   */\n  invalidToolMsgTemplate?: string;\n}\n\n/**\n * Interface for invoking a tool\n */\nexport interface ToolInvocationInterface {\n  tool: string;\n  toolInput: string;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype ToolExecutorInputType = any;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype ToolExecutorOutputType = any;\n\n/** @deprecated Use {@link ToolNode} instead. */\nexport class ToolExecutor extends RunnableBinding<\n  ToolExecutorInputType,\n  ToolExecutorOutputType\n> {\n  lc_graph_name = \"ToolExecutor\";\n\n  tools: Array<StructuredToolInterface | RunnableToolLike>;\n\n  toolMap: Record<string, StructuredToolInterface | RunnableToolLike>;\n\n  invalidToolMsgTemplate: string;\n\n  constructor(fields: ToolExecutorArgs) {\n    const fieldsWithDefaults = {\n      invalidToolMsgTemplate: INVALID_TOOL_MSG_TEMPLATE,\n      ...fields,\n    };\n    const bound = RunnableLambda.from(\n      async (input: ToolInvocationInterface, config?: RunnableConfig) =>\n        this._execute(input, config)\n    );\n    super({\n      bound,\n      config: {},\n    });\n    this.tools = fieldsWithDefaults.tools;\n    this.invalidToolMsgTemplate = fieldsWithDefaults.invalidToolMsgTemplate;\n    this.toolMap = this.tools.reduce((acc, tool) => {\n      acc[tool.name] = tool;\n      return acc;\n    }, {} as Record<string, StructuredToolInterface | RunnableToolLike>);\n  }\n\n  /**\n   * Execute a tool invocation\n   *\n   * @param {ToolInvocationInterface} toolInvocation The tool to invoke and the input to pass to it.\n   * @param {RunnableConfig | undefined} config Optional configuration to pass to the tool when invoked.\n   * @returns Either the result of the tool invocation (`string` or `ToolMessage`, set by the `ToolOutput` generic) or a string error message.\n   */\n  async _execute(\n    toolInvocation: ToolInvocationInterface,\n    config?: RunnableConfig\n  ): Promise<ToolExecutorOutputType> {\n    if (!(toolInvocation.tool in this.toolMap)) {\n      return this.invalidToolMsgTemplate\n        .replace(\"{requestedToolName}\", toolInvocation.tool)\n        .replace(\n          \"{availableToolNamesString}\",\n          Object.keys(this.toolMap).join(\", \")\n        );\n    } else {\n      const tool = this.toolMap[toolInvocation.tool];\n      const output = await tool.invoke(toolInvocation.toolInput, config);\n      return output;\n    }\n  }\n}\n"],"mappings":";;;AAQA,MAAM,4BAA4B;;AA0BlC,IAAa,eAAb,cAAkC,gBAGhC;CACA,gBAAgB;CAEhB;CAEA;CAEA;CAEA,YAAY,QAA0B;EACpC,MAAM,qBAAqB;GACzB,wBAAwB;GACxB,GAAG;GACJ;EACD,MAAM,QAAQ,eAAe,KAC3B,OAAO,OAAgC,WACrC,KAAK,SAAS,OAAO,OAAO,CAC/B;AACD,QAAM;GACJ;GACA,QAAQ,EAAE;GACX,CAAC;AACF,OAAK,QAAQ,mBAAmB;AAChC,OAAK,yBAAyB,mBAAmB;AACjD,OAAK,UAAU,KAAK,MAAM,QAAQ,KAAK,SAAS;AAC9C,OAAI,KAAK,QAAQ;AACjB,UAAO;KACN,EAAE,CAA+D;;;;;;;;;CAUtE,MAAM,SACJ,gBACA,QACiC;AACjC,MAAI,EAAE,eAAe,QAAQ,KAAK,SAChC,QAAO,KAAK,uBACT,QAAQ,uBAAuB,eAAe,KAAK,CACnD,QACC,8BACA,OAAO,KAAK,KAAK,QAAQ,CAAC,KAAK,KAAK,CACrC;MAIH,QADe,MADF,KAAK,QAAQ,eAAe,MACf,OAAO,eAAe,WAAW,OAAO"}

package/dist/prebuilt/tool_node.cjs

@@ -0,0 +1,247 @@
+const require_errors = require('../errors.cjs');
+const require_constants = require('../constants.cjs');
+const require_utils = require('../utils.cjs');
+let _langchain_core_messages = require("@langchain/core/messages");
+
+//#region src/prebuilt/tool_node.ts
+const isBaseMessageArray = (input) => Array.isArray(input) && input.every(_langchain_core_messages.isBaseMessage);
+const isMessagesState = (input) => typeof input === "object" && input != null && "messages" in input && isBaseMessageArray(input.messages);
+const isSendInput = (input) => typeof input === "object" && input != null && "lg_tool_call" in input;
+/**
+* A node that runs the tools requested in the last AIMessage. It can be used
+* either in StateGraph with a "messages" key or in MessageGraph. If multiple
+* tool calls are requested, they will be run in parallel. The output will be
+* a list of ToolMessages, one for each tool call.
+*
+* @example
+* ```ts
+* import { ToolNode } from "@langchain/langgraph/prebuilt";
+* import { tool } from "@langchain/core/tools";
+* import { z } from "zod";
+* import { AIMessage } from "@langchain/core/messages";
+*
+* const getWeather = tool((input) => {
+*   if (["sf", "san francisco"].includes(input.location.toLowerCase())) {
+*     return "It's 60 degrees and foggy.";
+*   } else {
+*     return "It's 90 degrees and sunny.";
+*   }
+* }, {
+*   name: "get_weather",
+*   description: "Call to get the current weather.",
+*   schema: z.object({
+*     location: z.string().describe("Location to get the weather for."),
+*   }),
+* });
+*
+* const tools = [getWeather];
+* const toolNode = new ToolNode(tools);
+*
+* const messageWithSingleToolCall = new AIMessage({
+*   content: "",
+*   tool_calls: [
+*     {
+*       name: "get_weather",
+*       args: { location: "sf" },
+*       id: "tool_call_id",
+*       type: "tool_call",
+*     }
+*   ]
+* })
+*
+* await toolNode.invoke({ messages: [messageWithSingleToolCall] });
+* // Returns tool invocation responses as:
+* // { messages: ToolMessage[] }
+* ```
+*
+* @example
+* ```ts
+* import {
+*   StateGraph,
+*   MessagesAnnotation,
+* } from "@langchain/langgraph";
+* import { ToolNode } from "@langchain/langgraph/prebuilt";
+* import { tool } from "@langchain/core/tools";
+* import { z } from "zod";
+* import { ChatAnthropic } from "@langchain/anthropic";
+*
+* const getWeather = tool((input) => {
+*   if (["sf", "san francisco"].includes(input.location.toLowerCase())) {
+*     return "It's 60 degrees and foggy.";
+*   } else {
+*     return "It's 90 degrees and sunny.";
+*   }
+* }, {
+*   name: "get_weather",
+*   description: "Call to get the current weather.",
+*   schema: z.object({
+*     location: z.string().describe("Location to get the weather for."),
+*   }),
+* });
+*
+* const tools = [getWeather];
+* const modelWithTools = new ChatAnthropic({
+*   model: "claude-3-haiku-20240307",
+*   temperature: 0
+* }).bindTools(tools);
+*
+* const toolNodeForGraph = new ToolNode(tools)
+*
+* const shouldContinue = (state: typeof MessagesAnnotation.State) => {
+*   const { messages } = state;
+*   const lastMessage = messages[messages.length - 1];
+*   if ("tool_calls" in lastMessage && Array.isArray(lastMessage.tool_calls) && lastMessage.tool_calls?.length) {
+*     return "tools";
+*   }
+*   return "__end__";
+* }
+*
+* const callModel = async (state: typeof MessagesAnnotation.State) => {
+*   const { messages } = state;
+*   const response = await modelWithTools.invoke(messages);
+*   return { messages: response };
+* }
+*
+* const graph = new StateGraph(MessagesAnnotation)
+*   .addNode("agent", callModel)
+*   .addNode("tools", toolNodeForGraph)
+*   .addEdge("__start__", "agent")
+*   .addConditionalEdges("agent", shouldContinue)
+*   .addEdge("tools", "agent")
+*   .compile();
+*
+* const inputs = {
+*   messages: [{ role: "user", content: "what is the weather in SF?" }],
+* };
+*
+* const stream = await graph.stream(inputs, {
+*   streamMode: "values",
+* });
+*
+* for await (const { messages } of stream) {
+*   console.log(messages);
+* }
+* // Returns the messages in the state at each step of execution
+* ```
+*/
+var ToolNode = class extends require_utils.RunnableCallable {
+	tools;
+	handleToolErrors = true;
+	trace = false;
+	constructor(tools, options) {
+		const { name, tags, handleToolErrors } = options ?? {};
+		super({
+			name,
+			tags,
+			func: (input, config) => this.run(input, config)
+		});
+		this.tools = tools;
+		this.handleToolErrors = handleToolErrors ?? this.handleToolErrors;
+	}
+	async runTool(call, config) {
+		const tool = this.tools.find((tool$1) => tool$1.name === call.name);
+		try {
+			if (tool === void 0) throw new Error(`Tool "${call.name}" not found.`);
+			const output = await tool.invoke({
+				...call,
+				type: "tool_call"
+			}, config);
+			if ((0, _langchain_core_messages.isBaseMessage)(output) && output.getType() === "tool" || require_constants.isCommand(output)) return output;
+			return new _langchain_core_messages.ToolMessage({
+				status: "success",
+				name: tool.name,
+				content: typeof output === "string" ? output : JSON.stringify(output),
+				tool_call_id: call.id
+			});
+		} catch (e) {
+			if (!this.handleToolErrors) throw e;
+			if (require_errors.isGraphInterrupt(e)) throw e;
+			return new _langchain_core_messages.ToolMessage({
+				status: "error",
+				content: `Error: ${e.message}\n Please fix your mistakes.`,
+				name: call.name,
+				tool_call_id: call.id ?? ""
+			});
+		}
+	}
+	async run(input, config) {
+		let outputs;
+		if (isSendInput(input)) outputs = [await this.runTool(input.lg_tool_call, config)];
+		else {
+			let messages;
+			if (isBaseMessageArray(input)) messages = input;
+			else if (isMessagesState(input)) messages = input.messages;
+			else throw new Error("ToolNode only accepts BaseMessage[] or { messages: BaseMessage[] } as input.");
+			const toolMessageIds = new Set(messages.filter((msg) => msg.getType() === "tool").map((msg) => msg.tool_call_id));
+			let aiMessage;
+			for (let i = messages.length - 1; i >= 0; i -= 1) {
+				const message = messages[i];
+				if ((0, _langchain_core_messages.isAIMessage)(message)) {
+					aiMessage = message;
+					break;
+				}
+			}
+			if (aiMessage == null || !(0, _langchain_core_messages.isAIMessage)(aiMessage)) throw new Error("ToolNode only accepts AIMessages as input.");
+			outputs = await Promise.all(aiMessage.tool_calls?.filter((call) => call.id == null || !toolMessageIds.has(call.id)).map((call) => this.runTool(call, config)) ?? []);
+		}
+		if (!outputs.some(require_constants.isCommand)) return Array.isArray(input) ? outputs : { messages: outputs };
+		const combinedOutputs = [];
+		let parentCommand = null;
+		for (const output of outputs) if (require_constants.isCommand(output)) if (output.graph === require_constants.Command.PARENT && Array.isArray(output.goto) && output.goto.every((send) => require_constants._isSend(send))) if (parentCommand) parentCommand.goto.push(...output.goto);
+		else parentCommand = new require_constants.Command({
+			graph: require_constants.Command.PARENT,
+			goto: output.goto
+		});
+		else combinedOutputs.push(output);
+		else combinedOutputs.push(Array.isArray(input) ? [output] : { messages: [output] });
+		if (parentCommand) combinedOutputs.push(parentCommand);
+		return combinedOutputs;
+	}
+};
+/**
+* A conditional edge function that determines whether to route to a tools node or end the graph.
+*
+* This function is designed to be used as a conditional edge in a LangGraph state graph to implement
+* the common pattern of checking if an AI message contains tool calls that need to be executed.
+*
+* @param state - The current state of the graph, which can be either:
+*   - An array of `BaseMessage` objects, where the last message is checked for tool calls
+*   - A state object conforming to `MessagesAnnotation.State`, which contains a `messages` array
+*
+* @returns A string indicating the next node to route to:
+*   - `"tools"` - If the last message contains tool calls that need to be executed
+*   - `END` - If there are no tool calls, indicating the graph should terminate
+*
+* @example
+* ```typescript
+* import { StateGraph, MessagesAnnotation, END, START } from "@langchain/langgraph";
+* import { ToolNode, toolsCondition } from "@langchain/langgraph/prebuilt";
+*
+* const graph = new StateGraph(MessagesAnnotation)
+*   .addNode("agent", agentNode)
+*   .addNode("tools", new ToolNode([searchTool, calculatorTool]))
+*   .addEdge(START, "agent")
+*   .addConditionalEdges("agent", toolsCondition, ["tools", END])
+*   .addEdge("tools", "agent")
+*   .compile();
+* ```
+*
+* @remarks
+* The function checks the last message in the state for the presence of `tool_calls`.
+* If the message is an `AIMessage` with one or more tool calls, it returns `"tools"`,
+* indicating that the graph should route to a tools node (typically a `ToolNode`) to
+* execute those tool calls. Otherwise, it returns `END` to terminate the graph execution.
+*
+* This is a common pattern in agentic workflows where an AI model decides whether to
+* use tools or provide a final response.
+*/
+function toolsCondition(state) {
+	const message = Array.isArray(state) ? state[state.length - 1] : state.messages[state.messages.length - 1];
+	if (message !== void 0 && "tool_calls" in message && (message.tool_calls?.length ?? 0) > 0) return "tools";
+	else return require_constants.END;
+}
+
+//#endregion
+exports.ToolNode = ToolNode;
+exports.toolsCondition = toolsCondition;
+//# sourceMappingURL=tool_node.cjs.map

package/dist/prebuilt/tool_node.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool_node.cjs","names":["isBaseMessage","RunnableCallable","tool","isCommand","ToolMessage","isGraphInterrupt","Command","_isSend","END"],"sources":["../../src/prebuilt/tool_node.ts"],"sourcesContent":["import {\n  BaseMessage,\n  ToolMessage,\n  AIMessage,\n  isBaseMessage,\n  isAIMessage,\n} from \"@langchain/core/messages\";\nimport { RunnableConfig, RunnableToolLike } from \"@langchain/core/runnables\";\nimport { DynamicTool, StructuredToolInterface } from \"@langchain/core/tools\";\nimport type { ToolCall } from \"@langchain/core/messages/tool\";\nimport { RunnableCallable } from \"../utils.js\";\nimport { MessagesAnnotation } from \"../graph/messages_annotation.js\";\nimport { isGraphInterrupt } from \"../errors.js\";\nimport { END, isCommand, Command, _isSend, Send } from \"../constants.js\";\n\nexport type ToolNodeOptions = {\n  name?: string;\n  tags?: string[];\n  handleToolErrors?: boolean;\n};\n\nconst isBaseMessageArray = (input: unknown): input is BaseMessage[] =>\n  Array.isArray(input) && input.every(isBaseMessage);\n\nconst isMessagesState = (\n  input: unknown\n): input is { messages: BaseMessage[] } =>\n  typeof input === \"object\" &&\n  input != null &&\n  \"messages\" in input &&\n  isBaseMessageArray(input.messages);\n\nconst isSendInput = (input: unknown): input is { lg_tool_call: ToolCall } =>\n  typeof input === \"object\" && input != null && \"lg_tool_call\" in input;\n\n/**\n * A node that runs the tools requested in the last AIMessage. It can be used\n * either in StateGraph with a \"messages\" key or in MessageGraph. If multiple\n * tool calls are requested, they will be run in parallel. The output will be\n * a list of ToolMessages, one for each tool call.\n *\n * @example\n * ```ts\n * import { ToolNode } from \"@langchain/langgraph/prebuilt\";\n * import { tool } from \"@langchain/core/tools\";\n * import { z } from \"zod\";\n * import { AIMessage } from \"@langchain/core/messages\";\n *\n * const getWeather = tool((input) => {\n *   if ([\"sf\", \"san francisco\"].includes(input.location.toLowerCase())) {\n *     return \"It's 60 degrees and foggy.\";\n *   } else {\n *     return \"It's 90 degrees and sunny.\";\n *   }\n * }, {\n *   name: \"get_weather\",\n *   description: \"Call to get the current weather.\",\n *   schema: z.object({\n *     location: z.string().describe(\"Location to get the weather for.\"),\n *   }),\n * });\n *\n * const tools = [getWeather];\n * const toolNode = new ToolNode(tools);\n *\n * const messageWithSingleToolCall = new AIMessage({\n *   content: \"\",\n *   tool_calls: [\n *     {\n *       name: \"get_weather\",\n *       args: { location: \"sf\" },\n *       id: \"tool_call_id\",\n *       type: \"tool_call\",\n *     }\n *   ]\n * })\n *\n * await toolNode.invoke({ messages: [messageWithSingleToolCall] });\n * // Returns tool invocation responses as:\n * // { messages: ToolMessage[] }\n * ```\n *\n * @example\n * ```ts\n * import {\n *   StateGraph,\n *   MessagesAnnotation,\n * } from \"@langchain/langgraph\";\n * import { ToolNode } from \"@langchain/langgraph/prebuilt\";\n * import { tool } from \"@langchain/core/tools\";\n * import { z } from \"zod\";\n * import { ChatAnthropic } from \"@langchain/anthropic\";\n *\n * const getWeather = tool((input) => {\n *   if ([\"sf\", \"san francisco\"].includes(input.location.toLowerCase())) {\n *     return \"It's 60 degrees and foggy.\";\n *   } else {\n *     return \"It's 90 degrees and sunny.\";\n *   }\n * }, {\n *   name: \"get_weather\",\n *   description: \"Call to get the current weather.\",\n *   schema: z.object({\n *     location: z.string().describe(\"Location to get the weather for.\"),\n *   }),\n * });\n *\n * const tools = [getWeather];\n * const modelWithTools = new ChatAnthropic({\n *   model: \"claude-3-haiku-20240307\",\n *   temperature: 0\n * }).bindTools(tools);\n *\n * const toolNodeForGraph = new ToolNode(tools)\n *\n * const shouldContinue = (state: typeof MessagesAnnotation.State) => {\n *   const { messages } = state;\n *   const lastMessage = messages[messages.length - 1];\n *   if (\"tool_calls\" in lastMessage && Array.isArray(lastMessage.tool_calls) && lastMessage.tool_calls?.length) {\n *     return \"tools\";\n *   }\n *   return \"__end__\";\n * }\n *\n * const callModel = async (state: typeof MessagesAnnotation.State) => {\n *   const { messages } = state;\n *   const response = await modelWithTools.invoke(messages);\n *   return { messages: response };\n * }\n *\n * const graph = new StateGraph(MessagesAnnotation)\n *   .addNode(\"agent\", callModel)\n *   .addNode(\"tools\", toolNodeForGraph)\n *   .addEdge(\"__start__\", \"agent\")\n *   .addConditionalEdges(\"agent\", shouldContinue)\n *   .addEdge(\"tools\", \"agent\")\n *   .compile();\n *\n * const inputs = {\n *   messages: [{ role: \"user\", content: \"what is the weather in SF?\" }],\n * };\n *\n * const stream = await graph.stream(inputs, {\n *   streamMode: \"values\",\n * });\n *\n * for await (const { messages } of stream) {\n *   console.log(messages);\n * }\n * // Returns the messages in the state at each step of execution\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport class ToolNode<T = any> extends RunnableCallable<T, T> {\n  tools: (StructuredToolInterface | DynamicTool | RunnableToolLike)[];\n\n  handleToolErrors = true;\n\n  trace = false;\n\n  constructor(\n    tools: (StructuredToolInterface | DynamicTool | RunnableToolLike)[],\n    options?: ToolNodeOptions\n  ) {\n    const { name, tags, handleToolErrors } = options ?? {};\n    super({ name, tags, func: (input, config) => this.run(input, config) });\n    this.tools = tools;\n    this.handleToolErrors = handleToolErrors ?? this.handleToolErrors;\n  }\n\n  protected async runTool(\n    call: ToolCall,\n    config: RunnableConfig\n  ): Promise<ToolMessage | Command> {\n    const tool = this.tools.find((tool) => tool.name === call.name);\n    try {\n      if (tool === undefined) {\n        throw new Error(`Tool \"${call.name}\" not found.`);\n      }\n      const output = await tool.invoke({ ...call, type: \"tool_call\" }, config);\n\n      if (\n        (isBaseMessage(output) && output.getType() === \"tool\") ||\n        isCommand(output)\n      ) {\n        return output as ToolMessage | Command;\n      }\n\n      return new ToolMessage({\n        status: \"success\",\n        name: tool.name,\n        content: typeof output === \"string\" ? output : JSON.stringify(output),\n        tool_call_id: call.id!,\n      });\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    } catch (e: any) {\n      if (!this.handleToolErrors) throw e;\n\n      if (isGraphInterrupt(e)) {\n        // `NodeInterrupt` errors are a breakpoint to bring a human into the loop.\n        // As such, they are not recoverable by the agent and shouldn't be fed\n        // back. Instead, re-throw these errors even when `handleToolErrors = true`.\n        throw e;\n      }\n\n      return new ToolMessage({\n        status: \"error\",\n        content: `Error: ${e.message}\\n Please fix your mistakes.`,\n        name: call.name,\n        tool_call_id: call.id ?? \"\",\n      });\n    }\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  protected async run(input: unknown, config: RunnableConfig): Promise<T> {\n    let outputs: (ToolMessage | Command)[];\n\n    if (isSendInput(input)) {\n      outputs = [await this.runTool(input.lg_tool_call, config)];\n    } else {\n      let messages: BaseMessage[];\n      if (isBaseMessageArray(input)) {\n        messages = input;\n      } else if (isMessagesState(input)) {\n        messages = input.messages;\n      } else {\n        throw new Error(\n          \"ToolNode only accepts BaseMessage[] or { messages: BaseMessage[] } as input.\"\n        );\n      }\n\n      const toolMessageIds: Set<string> = new Set(\n        messages\n          .filter((msg) => msg.getType() === \"tool\")\n          .map((msg) => (msg as ToolMessage).tool_call_id)\n      );\n\n      let aiMessage: AIMessage | undefined;\n      for (let i = messages.length - 1; i >= 0; i -= 1) {\n        const message = messages[i];\n        if (isAIMessage(message)) {\n          aiMessage = message;\n          break;\n        }\n      }\n\n      if (aiMessage == null || !isAIMessage(aiMessage)) {\n        throw new Error(\"ToolNode only accepts AIMessages as input.\");\n      }\n\n      outputs = await Promise.all(\n        aiMessage.tool_calls\n          ?.filter((call) => call.id == null || !toolMessageIds.has(call.id))\n          .map((call) => this.runTool(call, config)) ?? []\n      );\n    }\n\n    // Preserve existing behavior for non-command tool outputs for backwards compatibility\n    if (!outputs.some(isCommand)) {\n      return (Array.isArray(input) ? outputs : { messages: outputs }) as T;\n    }\n\n    // Handle mixed Command and non-Command outputs\n    const combinedOutputs: (\n      | { messages: BaseMessage[] }\n      | BaseMessage[]\n      | Command\n    )[] = [];\n    let parentCommand: Command | null = null;\n\n    for (const output of outputs) {\n      if (isCommand(output)) {\n        if (\n          output.graph === Command.PARENT &&\n          Array.isArray(output.goto) &&\n          output.goto.every((send) => _isSend(send))\n        ) {\n          if (parentCommand) {\n            (parentCommand.goto as Send[]).push(...(output.goto as Send[]));\n          } else {\n            parentCommand = new Command({\n              graph: Command.PARENT,\n              goto: output.goto,\n            });\n          }\n        } else {\n          combinedOutputs.push(output);\n        }\n      } else {\n        combinedOutputs.push(\n          Array.isArray(input) ? [output] : { messages: [output] }\n        );\n      }\n    }\n\n    if (parentCommand) {\n      combinedOutputs.push(parentCommand);\n    }\n\n    return combinedOutputs as T;\n  }\n}\n\n/**\n * A conditional edge function that determines whether to route to a tools node or end the graph.\n *\n * This function is designed to be used as a conditional edge in a LangGraph state graph to implement\n * the common pattern of checking if an AI message contains tool calls that need to be executed.\n *\n * @param state - The current state of the graph, which can be either:\n *   - An array of `BaseMessage` objects, where the last message is checked for tool calls\n *   - A state object conforming to `MessagesAnnotation.State`, which contains a `messages` array\n *\n * @returns A string indicating the next node to route to:\n *   - `\"tools\"` - If the last message contains tool calls that need to be executed\n *   - `END` - If there are no tool calls, indicating the graph should terminate\n *\n * @example\n * ```typescript\n * import { StateGraph, MessagesAnnotation, END, START } from \"@langchain/langgraph\";\n * import { ToolNode, toolsCondition } from \"@langchain/langgraph/prebuilt\";\n *\n * const graph = new StateGraph(MessagesAnnotation)\n *   .addNode(\"agent\", agentNode)\n *   .addNode(\"tools\", new ToolNode([searchTool, calculatorTool]))\n *   .addEdge(START, \"agent\")\n *   .addConditionalEdges(\"agent\", toolsCondition, [\"tools\", END])\n *   .addEdge(\"tools\", \"agent\")\n *   .compile();\n * ```\n *\n * @remarks\n * The function checks the last message in the state for the presence of `tool_calls`.\n * If the message is an `AIMessage` with one or more tool calls, it returns `\"tools\"`,\n * indicating that the graph should route to a tools node (typically a `ToolNode`) to\n * execute those tool calls. Otherwise, it returns `END` to terminate the graph execution.\n *\n * This is a common pattern in agentic workflows where an AI model decides whether to\n * use tools or provide a final response.\n */\nexport function toolsCondition(\n  state: BaseMessage[] | typeof MessagesAnnotation.State\n): \"tools\" | typeof END {\n  const message = Array.isArray(state)\n    ? state[state.length - 1]\n    : state.messages[state.messages.length - 1];\n\n  if (\n    message !== undefined &&\n    \"tool_calls\" in message &&\n    ((message as AIMessage).tool_calls?.length ?? 0) > 0\n  ) {\n    return \"tools\";\n  } else {\n    return END;\n  }\n}\n"],"mappings":"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"}