The agent engineering platform.
Python agentsaiai-agentsanthropicchatgptdeepagentsenterpriseframeworkgeminigenerative-ailangchainlanggraphllmmultiagentopen-sourceopenaipydanticpythonragtypescript
style(langchain): drop `target-version = py39` (#33288)
Mason Daugherty66889e280439
diff --git a/libs/langchain/langchain_classic/__init__.py b/libs/langchain/langchain_classic/__init__.pyindex d52e4abd6b..3f404d931e 100644--- a/libs/langchain/langchain_classic/__init__.py+++ b/libs/langchain/langchain_classic/__init__.py@@ -2,7 +2,7 @@import warningsfrom importlib import metadata-from typing import Any, Optional+from typing import Anyfrom langchain_core._api.deprecation import surface_langchain_deprecation_warnings@@ -14,7 +14,7 @@ except metadata.PackageNotFoundError:del metadata # optional, avoids polluting the results of dir(__package__)-def _warn_on_import(name: str, replacement: Optional[str] = None) -> None:+def _warn_on_import(name: str, replacement: str | None = None) -> None:"""Warn on import of deprecated module."""from langchain_classic._api.interactive_env import is_interactive_envdiff --git a/libs/langchain/langchain_classic/_api/module_import.py b/libs/langchain/langchain_classic/_api/module_import.pyindex 10ec27b8d7..b19ef5d359 100644--- a/libs/langchain/langchain_classic/_api/module_import.py+++ b/libs/langchain/langchain_classic/_api/module_import.py@@ -1,5 +1,6 @@import importlib-from typing import Any, Callable, Optional+from collections.abc import Callable+from typing import Anyfrom langchain_core._api import internal, warn_deprecated@@ -15,9 +16,9 @@ ALLOWED_TOP_LEVEL_PKGS = {def create_importer(package: str,*,- module_lookup: Optional[dict[str, str]] = None,- deprecated_lookups: Optional[dict[str, str]] = None,- fallback_module: Optional[str] = None,+ module_lookup: dict[str, str] | None = None,+ deprecated_lookups: dict[str, str] | None = None,+ fallback_module: str | None = None,) -> Callable[[str], Any]:"""Create a function that helps retrieve objects from their new locations.diff --git a/libs/langchain/langchain_classic/agents/agent.py b/libs/langchain/langchain_classic/agents/agent.pyindex aaaaf5400b..bd80f59236 100644--- a/libs/langchain/langchain_classic/agents/agent.py+++ b/libs/langchain/langchain_classic/agents/agent.py@@ -9,13 +9,10 @@ import jsonimport loggingimport timefrom abc import abstractmethod-from collections.abc import AsyncIterator, Iterator, Sequence+from collections.abc import AsyncIterator, Callable, Iterator, Sequencefrom pathlib import Pathfrom typing import (Any,- Callable,- Optional,- Union,cast,)@@ -63,7 +60,7 @@ class BaseSingleActionAgent(BaseModel):"""Return values of the agent."""return ["output"]- def get_allowed_tools(self) -> Optional[list[str]]:+ def get_allowed_tools(self) -> list[str] | None:"""Get allowed tools."""return None@@ -73,7 +70,7 @@ class BaseSingleActionAgent(BaseModel):intermediate_steps: list[tuple[AgentAction, str]],callbacks: Callbacks = None,**kwargs: Any,- ) -> Union[AgentAction, AgentFinish]:+ ) -> AgentAction | AgentFinish:"""Given input, decided what to do.Args:@@ -92,7 +89,7 @@ class BaseSingleActionAgent(BaseModel):intermediate_steps: list[tuple[AgentAction, str]],callbacks: Callbacks = None,**kwargs: Any,- ) -> Union[AgentAction, AgentFinish]:+ ) -> AgentAction | AgentFinish:"""Async given input, decided what to do.Args:@@ -146,7 +143,7 @@ class BaseSingleActionAgent(BaseModel):cls,llm: BaseLanguageModel,tools: Sequence[BaseTool],- callback_manager: Optional[BaseCallbackManager] = None,+ callback_manager: BaseCallbackManager | None = None,**kwargs: Any,) -> BaseSingleActionAgent:"""Construct an agent from an LLM and tools.@@ -185,7 +182,7 @@ class BaseSingleActionAgent(BaseModel):_dict["_type"] = _typereturn _dict- def save(self, file_path: Union[Path, str]) -> None:+ def save(self, file_path: Path | str) -> None:"""Save the agent.Args:@@ -233,7 +230,7 @@ class BaseMultiActionAgent(BaseModel):"""Return values of the agent."""return ["output"]- def get_allowed_tools(self) -> Optional[list[str]]:+ def get_allowed_tools(self) -> list[str] | None:"""Get allowed tools.Returns:@@ -247,7 +244,7 @@ class BaseMultiActionAgent(BaseModel):intermediate_steps: list[tuple[AgentAction, str]],callbacks: Callbacks = None,**kwargs: Any,- ) -> Union[list[AgentAction], AgentFinish]:+ ) -> list[AgentAction] | AgentFinish:"""Given input, decided what to do.Args:@@ -266,7 +263,7 @@ class BaseMultiActionAgent(BaseModel):intermediate_steps: list[tuple[AgentAction, str]],callbacks: Callbacks = None,**kwargs: Any,- ) -> Union[list[AgentAction], AgentFinish]:+ ) -> list[AgentAction] | AgentFinish:"""Async given input, decided what to do.Args:@@ -325,7 +322,7 @@ class BaseMultiActionAgent(BaseModel):_dict["_type"] = str(self._agent_type)return _dict- def save(self, file_path: Union[Path, str]) -> None:+ def save(self, file_path: Path | str) -> None:"""Save the agent.Args:@@ -369,16 +366,16 @@ class BaseMultiActionAgent(BaseModel):return {}-class AgentOutputParser(BaseOutputParser[Union[AgentAction, AgentFinish]]):+class AgentOutputParser(BaseOutputParser[AgentAction | AgentFinish]):"""Base class for parsing agent output into agent action/finish."""@abstractmethod- def parse(self, text: str) -> Union[AgentAction, AgentFinish]:+ def parse(self, text: str) -> AgentAction | AgentFinish:"""Parse text into agent action/finish."""class MultiActionAgentOutputParser(- BaseOutputParser[Union[list[AgentAction], AgentFinish]],+ BaseOutputParser[list[AgentAction] | AgentFinish],):"""Base class for parsing agent output into agent actions/finish.@@ -386,7 +383,7 @@ class MultiActionAgentOutputParser("""@abstractmethod- def parse(self, text: str) -> Union[list[AgentAction], AgentFinish]:+ def parse(self, text: str) -> list[AgentAction] | AgentFinish:"""Parse text into agent actions/finish.Args:@@ -401,7 +398,7 @@ class MultiActionAgentOutputParser(class RunnableAgent(BaseSingleActionAgent):"""Agent powered by Runnables."""- runnable: Runnable[dict, Union[AgentAction, AgentFinish]]+ runnable: Runnable[dict, AgentAction | AgentFinish]"""Runnable to call to get agent action."""input_keys_arg: list[str] = []return_keys_arg: list[str] = []@@ -433,7 +430,7 @@ class RunnableAgent(BaseSingleActionAgent):intermediate_steps: list[tuple[AgentAction, str]],callbacks: Callbacks = None,**kwargs: Any,- ) -> Union[AgentAction, AgentFinish]:+ ) -> AgentAction | AgentFinish:"""Based on past history and current inputs, decide what to do.Args:@@ -469,10 +466,7 @@ class RunnableAgent(BaseSingleActionAgent):intermediate_steps: list[tuple[AgentAction, str]],callbacks: Callbacks = None,**kwargs: Any,- ) -> Union[- AgentAction,- AgentFinish,- ]:+ ) -> AgentAction | AgentFinish:"""Async based on past history and current inputs, decide what to do.Args:@@ -512,7 +506,7 @@ class RunnableAgent(BaseSingleActionAgent):class RunnableMultiActionAgent(BaseMultiActionAgent):"""Agent powered by Runnables."""- runnable: Runnable[dict, Union[list[AgentAction], AgentFinish]]+ runnable: Runnable[dict, list[AgentAction] | AgentFinish]"""Runnable to call to get agent actions."""input_keys_arg: list[str] = []return_keys_arg: list[str] = []@@ -548,10 +542,7 @@ class RunnableMultiActionAgent(BaseMultiActionAgent):intermediate_steps: list[tuple[AgentAction, str]],callbacks: Callbacks = None,**kwargs: Any,- ) -> Union[- list[AgentAction],- AgentFinish,- ]:+ ) -> list[AgentAction] | AgentFinish:"""Based on past history and current inputs, decide what to do.Args:@@ -587,10 +578,7 @@ class RunnableMultiActionAgent(BaseMultiActionAgent):intermediate_steps: list[tuple[AgentAction, str]],callbacks: Callbacks = None,**kwargs: Any,- ) -> Union[- list[AgentAction],- AgentFinish,- ]:+ ) -> list[AgentAction] | AgentFinish:"""Async based on past history and current inputs, decide what to do.Args:@@ -664,7 +652,7 @@ class LLMSingleActionAgent(BaseSingleActionAgent):intermediate_steps: list[tuple[AgentAction, str]],callbacks: Callbacks = None,**kwargs: Any,- ) -> Union[AgentAction, AgentFinish]:+ ) -> AgentAction | AgentFinish:"""Given input, decided what to do.Args:@@ -689,7 +677,7 @@ class LLMSingleActionAgent(BaseSingleActionAgent):intermediate_steps: list[tuple[AgentAction, str]],callbacks: Callbacks = None,**kwargs: Any,- ) -> Union[AgentAction, AgentFinish]:+ ) -> AgentAction | AgentFinish:"""Async given input, decided what to do.Args:@@ -734,7 +722,7 @@ class Agent(BaseSingleActionAgent):"""LLMChain to use for agent."""output_parser: AgentOutputParser"""Output parser to use for agent."""- allowed_tools: Optional[list[str]] = None+ allowed_tools: list[str] | None = None"""Allowed tools for the agent. If None, all tools are allowed."""@override@@ -744,7 +732,7 @@ class Agent(BaseSingleActionAgent):del _dict["output_parser"]return _dict- def get_allowed_tools(self) -> Optional[list[str]]:+ def get_allowed_tools(self) -> list[str] | None:"""Get allowed tools."""return self.allowed_tools@@ -763,7 +751,7 @@ class Agent(BaseSingleActionAgent):def _construct_scratchpad(self,intermediate_steps: list[tuple[AgentAction, str]],- ) -> Union[str, list[BaseMessage]]:+ ) -> str | list[BaseMessage]:"""Construct the scratchpad that lets the agent continue its thought process."""thoughts = ""for action, observation in intermediate_steps:@@ -776,7 +764,7 @@ class Agent(BaseSingleActionAgent):intermediate_steps: list[tuple[AgentAction, str]],callbacks: Callbacks = None,**kwargs: Any,- ) -> Union[AgentAction, AgentFinish]:+ ) -> AgentAction | AgentFinish:"""Given input, decided what to do.Args:@@ -797,7 +785,7 @@ class Agent(BaseSingleActionAgent):intermediate_steps: list[tuple[AgentAction, str]],callbacks: Callbacks = None,**kwargs: Any,- ) -> Union[AgentAction, AgentFinish]:+ ) -> AgentAction | AgentFinish:"""Async given input, decided what to do.Args:@@ -910,8 +898,8 @@ class Agent(BaseSingleActionAgent):cls,llm: BaseLanguageModel,tools: Sequence[BaseTool],- callback_manager: Optional[BaseCallbackManager] = None,- output_parser: Optional[AgentOutputParser] = None,+ callback_manager: BaseCallbackManager | None = None,+ output_parser: AgentOutputParser | None = None,**kwargs: Any,) -> Agent:"""Construct an agent from an LLM and tools.@@ -1016,7 +1004,7 @@ class ExceptionTool(BaseTool):def _run(self,query: str,- run_manager: Optional[CallbackManagerForToolRun] = None,+ run_manager: CallbackManagerForToolRun | None = None,) -> str:return query@@ -1024,19 +1012,19 @@ class ExceptionTool(BaseTool):async def _arun(self,query: str,- run_manager: Optional[AsyncCallbackManagerForToolRun] = None,+ run_manager: AsyncCallbackManagerForToolRun | None = None,) -> str:return query-NextStepOutput = list[Union[AgentFinish, AgentAction, AgentStep]]-RunnableAgentType = Union[RunnableAgent, RunnableMultiActionAgent]+NextStepOutput = list[AgentFinish | AgentAction | AgentStep]+RunnableAgentType = RunnableAgent | RunnableMultiActionAgentclass AgentExecutor(Chain):"""Agent that is using tools."""- agent: Union[BaseSingleActionAgent, BaseMultiActionAgent, Runnable]+ agent: BaseSingleActionAgent | BaseMultiActionAgent | Runnable"""The agent to run for creating a plan and determining actionsto take at each step of the execution loop."""tools: Sequence[BaseTool]@@ -1044,12 +1032,12 @@ class AgentExecutor(Chain):return_intermediate_steps: bool = False"""Whether to return the agent's trajectory of intermediate stepsat the end in addition to the final output."""- max_iterations: Optional[int] = 15+ max_iterations: int | None = 15"""The maximum number of steps to take before ending the executionloop.Setting to 'None' could lead to an infinite loop."""- max_execution_time: Optional[float] = None+ max_execution_time: float | None = None"""The maximum amount of wall clock time to spend in the executionloop."""@@ -1063,9 +1051,7 @@ class AgentExecutor(Chain):`"generate"` calls the agent's LLM Chain one final time to generatea final answer based on the previous steps."""- handle_parsing_errors: Union[bool, str, Callable[[OutputParserException], str]] = (- False- )+ handle_parsing_errors: bool | str | Callable[[OutputParserException], str] = False"""How to handle errors raised by the agent's output parser.Defaults to `False`, which raises the error.If `true`, the error will be sent back to the LLM as an observation.@@ -1074,10 +1060,9 @@ class AgentExecutor(Chain):as an argument, and the result of that function will be passed to the agentas an observation."""- trim_intermediate_steps: Union[- int,- Callable[[list[tuple[AgentAction, str]]], list[tuple[AgentAction, str]]],- ] = -1+ trim_intermediate_steps: (+ int | Callable[[list[tuple[AgentAction, str]]], list[tuple[AgentAction, str]]]+ ) = -1"""How to trim the intermediate steps before returning them.Defaults to -1, which means no trimming."""@@ -1085,7 +1070,7 @@ class AgentExecutor(Chain):@classmethoddef from_agent_and_tools(cls,- agent: Union[BaseSingleActionAgent, BaseMultiActionAgent, Runnable],+ agent: BaseSingleActionAgent | BaseMultiActionAgent | Runnable,tools: Sequence[BaseTool],callbacks: Callbacks = None,**kwargs: Any,@@ -1155,7 +1140,7 @@ class AgentExecutor(Chain):logger.exception("Unexpected error getting OutputType from agent")multi_action = Falseelse:- multi_action = output_type == Union[list[AgentAction], AgentFinish]+ multi_action = output_type == list[AgentAction] | AgentFinishstream_runnable = values.pop("stream_runnable", True)if multi_action:@@ -1171,7 +1156,7 @@ class AgentExecutor(Chain):return values@property- def _action_agent(self) -> Union[BaseSingleActionAgent, BaseMultiActionAgent]:+ def _action_agent(self) -> BaseSingleActionAgent | BaseMultiActionAgent:"""Type cast self.agent.If the `agent` attribute is a Runnable, it will be converted one of@@ -1185,7 +1170,7 @@ class AgentExecutor(Chain):return self.agent@override- def save(self, file_path: Union[Path, str]) -> None:+ def save(self, file_path: Path | str) -> None:"""Raise error - saving not supported for Agent Executors.Args:@@ -1201,7 +1186,7 @@ class AgentExecutor(Chain):)raise ValueError(msg)- def save_agent(self, file_path: Union[Path, str]) -> None:+ def save_agent(self, file_path: Path | str) -> None:"""Save the underlying agent.Args:@@ -1274,7 +1259,7 @@ class AgentExecutor(Chain):self,output: AgentFinish,intermediate_steps: list,- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, Any]:if run_manager:run_manager.on_agent_finish(output, color="green", verbose=self.verbose)@@ -1287,7 +1272,7 @@ class AgentExecutor(Chain):self,output: AgentFinish,intermediate_steps: list,- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, Any]:if run_manager:await run_manager.on_agent_finish(@@ -1303,7 +1288,7 @@ class AgentExecutor(Chain):def _consume_next_step(self,values: NextStepOutput,- ) -> Union[AgentFinish, list[tuple[AgentAction, str]]]:+ ) -> AgentFinish | list[tuple[AgentAction, str]]:if isinstance(values[-1], AgentFinish):if len(values) != 1:msg = "Expected a single AgentFinish output, but got multiple values."@@ -1317,8 +1302,8 @@ class AgentExecutor(Chain):color_mapping: dict[str, str],inputs: dict[str, str],intermediate_steps: list[tuple[AgentAction, str]],- run_manager: Optional[CallbackManagerForChainRun] = None,- ) -> Union[AgentFinish, list[tuple[AgentAction, str]]]:+ run_manager: CallbackManagerForChainRun | None = None,+ ) -> AgentFinish | list[tuple[AgentAction, str]]:return self._consume_next_step(list(self._iter_next_step(@@ -1337,8 +1322,8 @@ class AgentExecutor(Chain):color_mapping: dict[str, str],inputs: dict[str, str],intermediate_steps: list[tuple[AgentAction, str]],- run_manager: Optional[CallbackManagerForChainRun] = None,- ) -> Iterator[Union[AgentFinish, AgentAction, AgentStep]]:+ run_manager: CallbackManagerForChainRun | None = None,+ ) -> Iterator[AgentFinish | AgentAction | AgentStep]:"""Take a single step in the thought-action-observation loop.Override this to take control of how the agent makes and acts on choices.@@ -1415,7 +1400,7 @@ class AgentExecutor(Chain):name_to_tool_map: dict[str, BaseTool],color_mapping: dict[str, str],agent_action: AgentAction,- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> AgentStep:if run_manager:run_manager.on_agent_action(agent_action, color="green")@@ -1455,8 +1440,8 @@ class AgentExecutor(Chain):color_mapping: dict[str, str],inputs: dict[str, str],intermediate_steps: list[tuple[AgentAction, str]],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,- ) -> Union[AgentFinish, list[tuple[AgentAction, str]]]:+ run_manager: AsyncCallbackManagerForChainRun | None = None,+ ) -> AgentFinish | list[tuple[AgentAction, str]]:return self._consume_next_step([a@@ -1476,8 +1461,8 @@ class AgentExecutor(Chain):color_mapping: dict[str, str],inputs: dict[str, str],intermediate_steps: list[tuple[AgentAction, str]],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,- ) -> AsyncIterator[Union[AgentFinish, AgentAction, AgentStep]]:+ run_manager: AsyncCallbackManagerForChainRun | None = None,+ ) -> AsyncIterator[AgentFinish | AgentAction | AgentStep]:"""Take a single step in the thought-action-observation loop.Override this to take control of how the agent makes and acts on choices.@@ -1562,7 +1547,7 @@ class AgentExecutor(Chain):name_to_tool_map: dict[str, BaseTool],color_mapping: dict[str, str],agent_action: AgentAction,- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> AgentStep:if run_manager:await run_manager.on_agent_action(@@ -1603,7 +1588,7 @@ class AgentExecutor(Chain):def _call(self,inputs: dict[str, str],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, Any]:"""Run text through and get agent response."""# Construct a mapping of tool name to tool for easy lookup@@ -1657,7 +1642,7 @@ class AgentExecutor(Chain):async def _acall(self,inputs: dict[str, str],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, str]:"""Async run text through and get agent response."""# Construct a mapping of tool name to tool for easy lookup@@ -1730,7 +1715,7 @@ class AgentExecutor(Chain):def _get_tool_return(self,next_step_output: tuple[AgentAction, str],- ) -> Optional[AgentFinish]:+ ) -> AgentFinish | None:"""Check if the tool is a returning tool."""agent_action, observation = next_step_outputname_to_tool_map = {tool.name: tool for tool in self.tools}@@ -1764,8 +1749,8 @@ class AgentExecutor(Chain):@overridedef stream(self,- input: Union[dict[str, Any], Any],- config: Optional[RunnableConfig] = None,+ input: dict[str, Any] | Any,+ config: RunnableConfig | None = None,**kwargs: Any,) -> Iterator[AddableDict]:"""Enables streaming over steps taken to reach final output.@@ -1795,8 +1780,8 @@ class AgentExecutor(Chain):@overrideasync def astream(self,- input: Union[dict[str, Any], Any],- config: Optional[RunnableConfig] = None,+ input: dict[str, Any] | Any,+ config: RunnableConfig | None = None,**kwargs: Any,) -> AsyncIterator[AddableDict]:"""Async enables streaming over steps taken to reach final output.diff --git a/libs/langchain/langchain_classic/agents/agent_iterator.py b/libs/langchain/langchain_classic/agents/agent_iterator.pyindex e8e2419bf1..874173a423 100644--- a/libs/langchain/langchain_classic/agents/agent_iterator.py+++ b/libs/langchain/langchain_classic/agents/agent_iterator.py@@ -7,8 +7,6 @@ from collections.abc import AsyncIterator, Iteratorfrom typing import (TYPE_CHECKING,Any,- Optional,- Union,)from uuid import UUID@@ -48,10 +46,10 @@ class AgentExecutorIterator:inputs: Any,callbacks: Callbacks = None,*,- tags: Optional[list[str]] = None,- metadata: Optional[dict[str, Any]] = None,- run_name: Optional[str] = None,- run_id: Optional[UUID] = None,+ tags: list[str] | None = None,+ metadata: dict[str, Any] | None = None,+ run_name: str | None = None,+ run_id: UUID | None = None,include_run_info: bool = False,yield_actions: bool = False,):@@ -89,10 +87,10 @@ class AgentExecutorIterator:_inputs: dict[str, str]callbacks: Callbacks- tags: Optional[list[str]]- metadata: Optional[dict[str, Any]]- run_name: Optional[str]- run_id: Optional[UUID]+ tags: list[str] | None+ metadata: dict[str, Any] | None+ run_name: str | None+ run_id: UUID | Noneinclude_run_info: boolyield_actions: bool@@ -155,7 +153,7 @@ class AgentExecutorIterator:def make_final_outputs(self,outputs: dict[str, Any],- run_manager: Union[CallbackManagerForChainRun, AsyncCallbackManagerForChainRun],+ run_manager: CallbackManagerForChainRun | AsyncCallbackManagerForChainRun,) -> AddableDict:"""Make final outputs for the iterator.@@ -324,7 +322,7 @@ class AgentExecutorIterator:def _process_next_step_output(self,- next_step_output: Union[AgentFinish, list[tuple[AgentAction, str]]],+ next_step_output: AgentFinish | list[tuple[AgentAction, str]],run_manager: CallbackManagerForChainRun,) -> AddableDict:"""Process the output of the next step.@@ -353,7 +351,7 @@ class AgentExecutorIterator:async def _aprocess_next_step_output(self,- next_step_output: Union[AgentFinish, list[tuple[AgentAction, str]]],+ next_step_output: AgentFinish | list[tuple[AgentAction, str]],run_manager: AsyncCallbackManagerForChainRun,) -> AddableDict:"""Process the output of the next async step.diff --git a/libs/langchain/langchain_classic/agents/agent_toolkits/conversational_retrieval/openai_functions.py b/libs/langchain/langchain_classic/agents/agent_toolkits/conversational_retrieval/openai_functions.pyindex f4812b2b56..e95a233ec2 100644--- a/libs/langchain/langchain_classic/agents/agent_toolkits/conversational_retrieval/openai_functions.py+++ b/libs/langchain/langchain_classic/agents/agent_toolkits/conversational_retrieval/openai_functions.py@@ -1,4 +1,4 @@-from typing import Any, Optional+from typing import Anyfrom langchain_core.language_models import BaseLanguageModelfrom langchain_core.memory import BaseMemory@@ -29,7 +29,7 @@ def create_conversational_retrieval_agent(tools: list[BaseTool],remember_intermediate_steps: bool = True, # noqa: FBT001,FBT002memory_key: str = "chat_history",- system_message: Optional[SystemMessage] = None,+ system_message: SystemMessage | None = None,verbose: bool = False, # noqa: FBT001,FBT002max_token_limit: int = 2000,**kwargs: Any,diff --git a/libs/langchain/langchain_classic/agents/agent_toolkits/vectorstore/base.py b/libs/langchain/langchain_classic/agents/agent_toolkits/vectorstore/base.pyindex c8d7c9b534..0e74a0900b 100644--- a/libs/langchain/langchain_classic/agents/agent_toolkits/vectorstore/base.py+++ b/libs/langchain/langchain_classic/agents/agent_toolkits/vectorstore/base.py@@ -1,6 +1,6 @@"""VectorStore agent."""-from typing import Any, Optional+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.callbacks.base import BaseCallbackManager@@ -36,10 +36,10 @@ from langchain_classic.chains.llm import LLMChaindef create_vectorstore_agent(llm: BaseLanguageModel,toolkit: VectorStoreToolkit,- callback_manager: Optional[BaseCallbackManager] = None,+ callback_manager: BaseCallbackManager | None = None,prefix: str = PREFIX,verbose: bool = False, # noqa: FBT001,FBT002- agent_executor_kwargs: Optional[dict[str, Any]] = None,+ agent_executor_kwargs: dict[str, Any] | None = None,**kwargs: Any,) -> AgentExecutor:"""Construct a VectorStore agent from an LLM and tools.@@ -134,10 +134,10 @@ def create_vectorstore_agent(def create_vectorstore_router_agent(llm: BaseLanguageModel,toolkit: VectorStoreRouterToolkit,- callback_manager: Optional[BaseCallbackManager] = None,+ callback_manager: BaseCallbackManager | None = None,prefix: str = ROUTER_PREFIX,verbose: bool = False, # noqa: FBT001,FBT002- agent_executor_kwargs: Optional[dict[str, Any]] = None,+ agent_executor_kwargs: dict[str, Any] | None = None,**kwargs: Any,) -> AgentExecutor:"""Construct a VectorStore router agent from an LLM and tools.diff --git a/libs/langchain/langchain_classic/agents/chat/base.py b/libs/langchain/langchain_classic/agents/chat/base.pyindex 9505ffe487..136d4f1f4f 100644--- a/libs/langchain/langchain_classic/agents/chat/base.py+++ b/libs/langchain/langchain_classic/agents/chat/base.py@@ -1,5 +1,5 @@from collections.abc import Sequence-from typing import Any, Optional+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.agents import AgentAction@@ -87,7 +87,7 @@ class ChatAgent(Agent):system_message_suffix: str = SYSTEM_MESSAGE_SUFFIX,human_message: str = HUMAN_MESSAGE,format_instructions: str = FORMAT_INSTRUCTIONS,- input_variables: Optional[list[str]] = None,+ input_variables: list[str] | None = None,) -> BasePromptTemplate:"""Create a prompt from a list of tools.@@ -127,13 +127,13 @@ class ChatAgent(Agent):cls,llm: BaseLanguageModel,tools: Sequence[BaseTool],- callback_manager: Optional[BaseCallbackManager] = None,- output_parser: Optional[AgentOutputParser] = None,+ callback_manager: BaseCallbackManager | None = None,+ output_parser: AgentOutputParser | None = None,system_message_prefix: str = SYSTEM_MESSAGE_PREFIX,system_message_suffix: str = SYSTEM_MESSAGE_SUFFIX,human_message: str = HUMAN_MESSAGE,format_instructions: str = FORMAT_INSTRUCTIONS,- input_variables: Optional[list[str]] = None,+ input_variables: list[str] | None = None,**kwargs: Any,) -> Agent:"""Construct an agent from an LLM and tools.diff --git a/libs/langchain/langchain_classic/agents/chat/output_parser.py b/libs/langchain/langchain_classic/agents/chat/output_parser.pyindex e9608b26e2..64dbf3d370 100644--- a/libs/langchain/langchain_classic/agents/chat/output_parser.py+++ b/libs/langchain/langchain_classic/agents/chat/output_parser.py@@ -1,7 +1,6 @@import jsonimport refrom re import Pattern-from typing import Unionfrom langchain_core.agents import AgentAction, AgentFinishfrom langchain_core.exceptions import OutputParserException@@ -25,7 +24,7 @@ class ChatOutputParser(AgentOutputParser):"""Returns formatting instructions for the given output parser."""return self.format_instructions- def parse(self, text: str) -> Union[AgentAction, AgentFinish]:+ def parse(self, text: str) -> AgentAction | AgentFinish:"""Parse the output from the agent into an AgentAction or AgentFinish object.Args:diff --git a/libs/langchain/langchain_classic/agents/conversational/base.py b/libs/langchain/langchain_classic/agents/conversational/base.pyindex 61151c53cc..f198bb733d 100644--- a/libs/langchain/langchain_classic/agents/conversational/base.py+++ b/libs/langchain/langchain_classic/agents/conversational/base.py@@ -3,7 +3,7 @@from __future__ import annotationsfrom collections.abc import Sequence-from typing import Any, Optional+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.callbacks import BaseCallbackManager@@ -80,7 +80,7 @@ class ConversationalAgent(Agent):format_instructions: str = FORMAT_INSTRUCTIONS,ai_prefix: str = "AI",human_prefix: str = "Human",- input_variables: Optional[list[str]] = None,+ input_variables: list[str] | None = None,) -> PromptTemplate:"""Create prompt in the style of the zero-shot agent.@@ -124,14 +124,14 @@ class ConversationalAgent(Agent):cls,llm: BaseLanguageModel,tools: Sequence[BaseTool],- callback_manager: Optional[BaseCallbackManager] = None,- output_parser: Optional[AgentOutputParser] = None,+ callback_manager: BaseCallbackManager | None = None,+ output_parser: AgentOutputParser | None = None,prefix: str = PREFIX,suffix: str = SUFFIX,format_instructions: str = FORMAT_INSTRUCTIONS,ai_prefix: str = "AI",human_prefix: str = "Human",- input_variables: Optional[list[str]] = None,+ input_variables: list[str] | None = None,**kwargs: Any,) -> Agent:"""Construct an agent from an LLM and tools.diff --git a/libs/langchain/langchain_classic/agents/conversational/output_parser.py b/libs/langchain/langchain_classic/agents/conversational/output_parser.pyindex 80c19dc43e..ba130965c4 100644--- a/libs/langchain/langchain_classic/agents/conversational/output_parser.py+++ b/libs/langchain/langchain_classic/agents/conversational/output_parser.py@@ -1,5 +1,4 @@import re-from typing import Unionfrom langchain_core.agents import AgentAction, AgentFinishfrom langchain_core.exceptions import OutputParserException@@ -21,7 +20,7 @@ class ConvoOutputParser(AgentOutputParser):"""Returns formatting instructions for the given output parser."""return self.format_instructions- def parse(self, text: str) -> Union[AgentAction, AgentFinish]:+ def parse(self, text: str) -> AgentAction | AgentFinish:"""Parse the output from the agent into an AgentAction or AgentFinish object.Args:diff --git a/libs/langchain/langchain_classic/agents/conversational_chat/base.py b/libs/langchain/langchain_classic/agents/conversational_chat/base.pyindex 6fd49d1fd9..313ee266c5 100644--- a/libs/langchain/langchain_classic/agents/conversational_chat/base.py+++ b/libs/langchain/langchain_classic/agents/conversational_chat/base.py@@ -3,7 +3,7 @@from __future__ import annotationsfrom collections.abc import Sequence-from typing import Any, Optional+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.agents import AgentAction@@ -80,8 +80,8 @@ class ConversationalChatAgent(Agent):tools: Sequence[BaseTool],system_message: str = PREFIX,human_message: str = SUFFIX,- input_variables: Optional[list[str]] = None,- output_parser: Optional[BaseOutputParser] = None,+ input_variables: list[str] | None = None,+ output_parser: BaseOutputParser | None = None,) -> BasePromptTemplate:"""Create a prompt for the agent.@@ -138,11 +138,11 @@ class ConversationalChatAgent(Agent):cls,llm: BaseLanguageModel,tools: Sequence[BaseTool],- callback_manager: Optional[BaseCallbackManager] = None,- output_parser: Optional[AgentOutputParser] = None,+ callback_manager: BaseCallbackManager | None = None,+ output_parser: AgentOutputParser | None = None,system_message: str = PREFIX,human_message: str = SUFFIX,- input_variables: Optional[list[str]] = None,+ input_variables: list[str] | None = None,**kwargs: Any,) -> Agent:"""Construct an agent from an LLM and tools.diff --git a/libs/langchain/langchain_classic/agents/conversational_chat/output_parser.py b/libs/langchain/langchain_classic/agents/conversational_chat/output_parser.pyindex f554dbb95f..491ed697f5 100644--- a/libs/langchain/langchain_classic/agents/conversational_chat/output_parser.py+++ b/libs/langchain/langchain_classic/agents/conversational_chat/output_parser.py@@ -1,7 +1,5 @@from __future__ import annotations-from typing import Union-from langchain_core.agents import AgentAction, AgentFinishfrom langchain_core.exceptions import OutputParserExceptionfrom langchain_core.utils.json import parse_json_markdown@@ -21,7 +19,7 @@ class ConvoOutputParser(AgentOutputParser):"""Returns formatting instructions for the given output parser."""return self.format_instructions- def parse(self, text: str) -> Union[AgentAction, AgentFinish]:+ def parse(self, text: str) -> AgentAction | AgentFinish:"""Attempts to parse the given text into an AgentAction or AgentFinish.Raises:diff --git a/libs/langchain/langchain_classic/agents/format_scratchpad/xml.py b/libs/langchain/langchain_classic/agents/format_scratchpad/xml.pyindex 942b2ec8fa..3bdda8520e 100644--- a/libs/langchain/langchain_classic/agents/format_scratchpad/xml.py+++ b/libs/langchain/langchain_classic/agents/format_scratchpad/xml.py@@ -1,4 +1,4 @@-from typing import Literal, Optional+from typing import Literalfrom langchain_core.agents import AgentAction@@ -21,7 +21,7 @@ def _escape(xml: str) -> str:def format_xml(intermediate_steps: list[tuple[AgentAction, str]],*,- escape_format: Optional[Literal["minimal"]] = "minimal",+ escape_format: Literal["minimal"] | None = "minimal",) -> str:"""Format the intermediate steps as XML.diff --git a/libs/langchain/langchain_classic/agents/initialize.py b/libs/langchain/langchain_classic/agents/initialize.pyindex 3987fb5ba9..edd1e32440 100644--- a/libs/langchain/langchain_classic/agents/initialize.py+++ b/libs/langchain/langchain_classic/agents/initialize.py@@ -2,7 +2,7 @@import contextlibfrom collections.abc import Sequence-from typing import Any, Optional+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.callbacks import BaseCallbackManager@@ -24,12 +24,12 @@ from langchain_classic.agents.types import AGENT_TO_CLASSdef initialize_agent(tools: Sequence[BaseTool],llm: BaseLanguageModel,- agent: Optional[AgentType] = None,- callback_manager: Optional[BaseCallbackManager] = None,- agent_path: Optional[str] = None,- agent_kwargs: Optional[dict] = None,+ agent: AgentType | None = None,+ callback_manager: BaseCallbackManager | None = None,+ agent_path: str | None = None,+ agent_kwargs: dict | None = None,*,- tags: Optional[Sequence[str]] = None,+ tags: Sequence[str] | None = None,**kwargs: Any,) -> AgentExecutor:"""Load an agent executor given tools and LLM.diff --git a/libs/langchain/langchain_classic/agents/json_chat/base.py b/libs/langchain/langchain_classic/agents/json_chat/base.pyindex 6f6e017dfa..b174879f48 100644--- a/libs/langchain/langchain_classic/agents/json_chat/base.py+++ b/libs/langchain/langchain_classic/agents/json_chat/base.py@@ -1,5 +1,4 @@from collections.abc import Sequence-from typing import Unionfrom langchain_core.language_models import BaseLanguageModelfrom langchain_core.prompts.chat import ChatPromptTemplate@@ -16,7 +15,7 @@ def create_json_chat_agent(llm: BaseLanguageModel,tools: Sequence[BaseTool],prompt: ChatPromptTemplate,- stop_sequence: Union[bool, list[str]] = True, # noqa: FBT001,FBT002+ stop_sequence: bool | list[str] = True, # noqa: FBT001,FBT002tools_renderer: ToolsRenderer = render_text_description,template_tool_response: str = TEMPLATE_TOOL_RESPONSE,) -> Runnable:diff --git a/libs/langchain/langchain_classic/agents/loading.py b/libs/langchain/langchain_classic/agents/loading.pyindex 6173268fd7..4560ab1d80 100644--- a/libs/langchain/langchain_classic/agents/loading.py+++ b/libs/langchain/langchain_classic/agents/loading.py@@ -3,7 +3,7 @@import jsonimport loggingfrom pathlib import Path-from typing import Any, Optional, Union+from typing import Anyimport yamlfrom langchain_core._api import deprecated@@ -24,7 +24,7 @@ def _load_agent_from_tools(llm: BaseLanguageModel,tools: list[Tool],**kwargs: Any,-) -> Union[BaseSingleActionAgent, BaseMultiActionAgent]:+) -> BaseSingleActionAgent | BaseMultiActionAgent:config_type = config.pop("_type")if config_type not in AGENT_TO_CLASS:msg = f"Loading {config_type} agent not supported"@@ -38,10 +38,10 @@ def _load_agent_from_tools(@deprecated("0.1.0", removal="1.0")def load_agent_from_config(config: dict,- llm: Optional[BaseLanguageModel] = None,- tools: Optional[list[Tool]] = None,+ llm: BaseLanguageModel | None = None,+ tools: list[Tool] | None = None,**kwargs: Any,-) -> Union[BaseSingleActionAgent, BaseMultiActionAgent]:+) -> BaseSingleActionAgent | BaseMultiActionAgent:"""Load agent from Config Dict.Args:@@ -100,9 +100,9 @@ def load_agent_from_config(@deprecated("0.1.0", removal="1.0")def load_agent(- path: Union[str, Path],+ path: str | Path,**kwargs: Any,-) -> Union[BaseSingleActionAgent, BaseMultiActionAgent]:+) -> BaseSingleActionAgent | BaseMultiActionAgent:"""Unified method for loading an agent from LangChainHub or local fs.Args:@@ -127,9 +127,9 @@ def load_agent(def _load_agent_from_file(- file: Union[str, Path],+ file: str | Path,**kwargs: Any,-) -> Union[BaseSingleActionAgent, BaseMultiActionAgent]:+) -> BaseSingleActionAgent | BaseMultiActionAgent:"""Load agent from file."""valid_suffixes = {"json", "yaml"}# Convert file to Path object.diff --git a/libs/langchain/langchain_classic/agents/mrkl/base.py b/libs/langchain/langchain_classic/agents/mrkl/base.pyindex df7f86db8a..d0b05766ee 100644--- a/libs/langchain/langchain_classic/agents/mrkl/base.py+++ b/libs/langchain/langchain_classic/agents/mrkl/base.py@@ -2,8 +2,8 @@from __future__ import annotations-from collections.abc import Sequence-from typing import Any, Callable, NamedTuple, Optional+from collections.abc import Callable, Sequence+from typing import Any, NamedTuplefrom langchain_core._api import deprecatedfrom langchain_core.callbacks import BaseCallbackManager@@ -86,7 +86,7 @@ class ZeroShotAgent(Agent):prefix: str = PREFIX,suffix: str = SUFFIX,format_instructions: str = FORMAT_INSTRUCTIONS,- input_variables: Optional[list[str]] = None,+ input_variables: list[str] | None = None,) -> PromptTemplate:"""Create prompt in the style of the zero shot agent.@@ -116,12 +116,12 @@ class ZeroShotAgent(Agent):cls,llm: BaseLanguageModel,tools: Sequence[BaseTool],- callback_manager: Optional[BaseCallbackManager] = None,- output_parser: Optional[AgentOutputParser] = None,+ callback_manager: BaseCallbackManager | None = None,+ output_parser: AgentOutputParser | None = None,prefix: str = PREFIX,suffix: str = SUFFIX,format_instructions: str = FORMAT_INSTRUCTIONS,- input_variables: Optional[list[str]] = None,+ input_variables: list[str] | None = None,**kwargs: Any,) -> Agent:"""Construct an agent from an LLM and tools.diff --git a/libs/langchain/langchain_classic/agents/mrkl/output_parser.py b/libs/langchain/langchain_classic/agents/mrkl/output_parser.pyindex b17e415171..ba9598c68f 100644--- a/libs/langchain/langchain_classic/agents/mrkl/output_parser.py+++ b/libs/langchain/langchain_classic/agents/mrkl/output_parser.py@@ -1,5 +1,4 @@import re-from typing import Unionfrom langchain_core.agents import AgentAction, AgentFinishfrom langchain_core.exceptions import OutputParserException@@ -29,7 +28,7 @@ class MRKLOutputParser(AgentOutputParser):"""Returns formatting instructions for the given output parser."""return self.format_instructions- def parse(self, text: str) -> Union[AgentAction, AgentFinish]:+ def parse(self, text: str) -> AgentAction | AgentFinish:"""Parse the output from the agent into an AgentAction or AgentFinish object.Args:diff --git a/libs/langchain/langchain_classic/agents/openai_assistant/base.py b/libs/langchain/langchain_classic/agents/openai_assistant/base.pyindex 12702e1607..db09216195 100644--- a/libs/langchain/langchain_classic/agents/openai_assistant/base.py+++ b/libs/langchain/langchain_classic/agents/openai_assistant/base.py@@ -2,15 +2,12 @@ from __future__ import annotationsimport asyncioimport json-from collections.abc import Sequence+from collections.abc import Callable, Sequencefrom json import JSONDecodeErrorfrom time import sleepfrom typing import (TYPE_CHECKING,Any,- Callable,- Optional,- Union,)from langchain_core.agents import AgentAction, AgentFinish@@ -107,7 +104,7 @@ def _get_openai_async_client() -> openai.AsyncOpenAI:def _is_assistants_builtin_tool(- tool: Union[dict[str, Any], type[BaseModel], Callable, BaseTool],+ tool: dict[str, Any] | type[BaseModel] | Callable | BaseTool,) -> bool:"""Determine if tool corresponds to OpenAI Assistants built-in."""assistants_builtin_tools = ("code_interpreter", "file_search")@@ -119,7 +116,7 @@ def _is_assistants_builtin_tool(def _get_assistants_tool(- tool: Union[dict[str, Any], type[BaseModel], Callable, BaseTool],+ tool: dict[str, Any] | type[BaseModel] | Callable | BaseTool,) -> dict[str, Any]:"""Convert a raw function/class to an OpenAI tool.@@ -131,12 +128,12 @@ def _get_assistants_tool(return convert_to_openai_tool(tool)-OutputType = Union[- list[OpenAIAssistantAction],- OpenAIAssistantFinish,- list["ThreadMessage"],- list["RequiredActionFunctionToolCall"],-]+OutputType = (+ list[OpenAIAssistantAction]+ | OpenAIAssistantFinish+ | list["ThreadMessage"]+ | list["RequiredActionFunctionToolCall"]+)class OpenAIAssistantRunnable(RunnableSerializable[dict, OutputType]):@@ -260,10 +257,10 @@ class OpenAIAssistantRunnable(RunnableSerializable[dict, OutputType]):cls,name: str,instructions: str,- tools: Sequence[Union[BaseTool, dict]],+ tools: Sequence[BaseTool | dict],model: str,*,- client: Optional[Union[openai.OpenAI, openai.AzureOpenAI]] = None,+ client: openai.OpenAI | openai.AzureOpenAI | None = None,**kwargs: Any,) -> OpenAIAssistantRunnable:"""Create an OpenAI Assistant and instantiate the Runnable.@@ -293,7 +290,7 @@ class OpenAIAssistantRunnable(RunnableSerializable[dict, OutputType]):def invoke(self,input: dict,- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,**kwargs: Any,) -> OutputType:"""Invoke assistant.@@ -392,12 +389,10 @@ class OpenAIAssistantRunnable(RunnableSerializable[dict, OutputType]):cls,name: str,instructions: str,- tools: Sequence[Union[BaseTool, dict]],+ tools: Sequence[BaseTool | dict],model: str,*,- async_client: Optional[- Union[openai.AsyncOpenAI, openai.AsyncAzureOpenAI]- ] = None,+ async_client: openai.AsyncOpenAI | openai.AsyncAzureOpenAI | None = None,**kwargs: Any,) -> OpenAIAssistantRunnable:"""Async create an AsyncOpenAI Assistant and instantiate the Runnable.@@ -428,7 +423,7 @@ class OpenAIAssistantRunnable(RunnableSerializable[dict, OutputType]):async def ainvoke(self,input: dict,- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,**kwargs: Any,) -> OutputType:"""Async invoke assistant.diff --git a/libs/langchain/langchain_classic/agents/openai_functions_agent/base.py b/libs/langchain/langchain_classic/agents/openai_functions_agent/base.pyindex 2d6630a92f..c5ca2ef595 100644--- a/libs/langchain/langchain_classic/agents/openai_functions_agent/base.py+++ b/libs/langchain/langchain_classic/agents/openai_functions_agent/base.py@@ -1,7 +1,7 @@"""Module implements an agent that uses OpenAI's APIs function enabled API."""from collections.abc import Sequence-from typing import Any, Optional, Union+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.agents import AgentAction, AgentFinish@@ -100,7 +100,7 @@ class OpenAIFunctionsAgent(BaseSingleActionAgent):callbacks: Callbacks = None,with_functions: bool = True, # noqa: FBT001,FBT002**kwargs: Any,- ) -> Union[AgentAction, AgentFinish]:+ ) -> AgentAction | AgentFinish:"""Given input, decided what to do.Args:@@ -140,7 +140,7 @@ class OpenAIFunctionsAgent(BaseSingleActionAgent):intermediate_steps: list[tuple[AgentAction, str]],callbacks: Callbacks = None,**kwargs: Any,- ) -> Union[AgentAction, AgentFinish]:+ ) -> AgentAction | AgentFinish:"""Async given input, decided what to do.Args:@@ -214,8 +214,8 @@ class OpenAIFunctionsAgent(BaseSingleActionAgent):@classmethoddef create_prompt(cls,- system_message: Optional[SystemMessage] = _NOT_SET, # type: ignore[assignment]- extra_prompt_messages: Optional[list[BaseMessagePromptTemplate]] = None,+ system_message: SystemMessage | None = _NOT_SET, # type: ignore[assignment]+ extra_prompt_messages: list[BaseMessagePromptTemplate] | None = None,) -> ChatPromptTemplate:"""Create prompt for this agent.@@ -234,7 +234,7 @@ class OpenAIFunctionsAgent(BaseSingleActionAgent):if system_message is not _NOT_SETelse SystemMessage(content="You are a helpful AI assistant."))- messages: list[Union[BaseMessagePromptTemplate, BaseMessage]]+ messages: list[BaseMessagePromptTemplate | BaseMessage]messages = [system_message_] if system_message_ else []messages.extend(@@ -251,9 +251,9 @@ class OpenAIFunctionsAgent(BaseSingleActionAgent):cls,llm: BaseLanguageModel,tools: Sequence[BaseTool],- callback_manager: Optional[BaseCallbackManager] = None,- extra_prompt_messages: Optional[list[BaseMessagePromptTemplate]] = None,- system_message: Optional[SystemMessage] = _NOT_SET, # type: ignore[assignment]+ callback_manager: BaseCallbackManager | None = None,+ extra_prompt_messages: list[BaseMessagePromptTemplate] | None = None,+ system_message: SystemMessage | None = _NOT_SET, # type: ignore[assignment]**kwargs: Any,) -> BaseSingleActionAgent:"""Construct an agent from an LLM and tools.diff --git a/libs/langchain/langchain_classic/agents/openai_functions_multi_agent/base.py b/libs/langchain/langchain_classic/agents/openai_functions_multi_agent/base.pyindex 46d4bbc5df..3c3383dd45 100644--- a/libs/langchain/langchain_classic/agents/openai_functions_multi_agent/base.py+++ b/libs/langchain/langchain_classic/agents/openai_functions_multi_agent/base.py@@ -3,7 +3,7 @@import jsonfrom collections.abc import Sequencefrom json import JSONDecodeError-from typing import Any, Optional, Union+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.agents import AgentAction, AgentActionMessageLog, AgentFinish@@ -35,7 +35,7 @@ from langchain_classic.agents.format_scratchpad.openai_functions import (_FunctionsAgentAction = AgentActionMessageLog-def _parse_ai_message(message: BaseMessage) -> Union[list[AgentAction], AgentFinish]:+def _parse_ai_message(message: BaseMessage) -> list[AgentAction] | AgentFinish:"""Parse an AI message."""if not isinstance(message, AIMessage):msg = f"Expected an AI message got {type(message)}"@@ -206,7 +206,7 @@ class OpenAIMultiFunctionsAgent(BaseMultiActionAgent):intermediate_steps: list[tuple[AgentAction, str]],callbacks: Callbacks = None,**kwargs: Any,- ) -> Union[list[AgentAction], AgentFinish]:+ ) -> list[AgentAction] | AgentFinish:"""Given input, decided what to do.Args:@@ -237,7 +237,7 @@ class OpenAIMultiFunctionsAgent(BaseMultiActionAgent):intermediate_steps: list[tuple[AgentAction, str]],callbacks: Callbacks = None,**kwargs: Any,- ) -> Union[list[AgentAction], AgentFinish]:+ ) -> list[AgentAction] | AgentFinish:"""Async given input, decided what to do.Args:@@ -266,8 +266,8 @@ class OpenAIMultiFunctionsAgent(BaseMultiActionAgent):@classmethoddef create_prompt(cls,- system_message: Optional[SystemMessage] = _NOT_SET, # type: ignore[assignment]- extra_prompt_messages: Optional[list[BaseMessagePromptTemplate]] = None,+ system_message: SystemMessage | None = _NOT_SET, # type: ignore[assignment]+ extra_prompt_messages: list[BaseMessagePromptTemplate] | None = None,) -> BasePromptTemplate:"""Create prompt for this agent.@@ -286,7 +286,7 @@ class OpenAIMultiFunctionsAgent(BaseMultiActionAgent):if system_message is not _NOT_SETelse SystemMessage(content="You are a helpful AI assistant."))- messages: list[Union[BaseMessagePromptTemplate, BaseMessage]]+ messages: list[BaseMessagePromptTemplate | BaseMessage]messages = [system_message_] if system_message_ else []messages.extend(@@ -303,9 +303,9 @@ class OpenAIMultiFunctionsAgent(BaseMultiActionAgent):cls,llm: BaseLanguageModel,tools: Sequence[BaseTool],- callback_manager: Optional[BaseCallbackManager] = None,- extra_prompt_messages: Optional[list[BaseMessagePromptTemplate]] = None,- system_message: Optional[SystemMessage] = _NOT_SET, # type: ignore[assignment]+ callback_manager: BaseCallbackManager | None = None,+ extra_prompt_messages: list[BaseMessagePromptTemplate] | None = None,+ system_message: SystemMessage | None = _NOT_SET, # type: ignore[assignment]**kwargs: Any,) -> BaseMultiActionAgent:"""Construct an agent from an LLM and tools.diff --git a/libs/langchain/langchain_classic/agents/openai_tools/base.py b/libs/langchain/langchain_classic/agents/openai_tools/base.pyindex a1f69b520c..327ad268fc 100644--- a/libs/langchain/langchain_classic/agents/openai_tools/base.py+++ b/libs/langchain/langchain_classic/agents/openai_tools/base.py@@ -1,5 +1,4 @@from collections.abc import Sequence-from typing import Optionalfrom langchain_core.language_models import BaseLanguageModelfrom langchain_core.prompts.chat import ChatPromptTemplate@@ -19,7 +18,7 @@ def create_openai_tools_agent(llm: BaseLanguageModel,tools: Sequence[BaseTool],prompt: ChatPromptTemplate,- strict: Optional[bool] = None, # noqa: FBT001+ strict: bool | None = None, # noqa: FBT001) -> Runnable:"""Create an agent that uses OpenAI tools.diff --git a/libs/langchain/langchain_classic/agents/output_parsers/json.py b/libs/langchain/langchain_classic/agents/output_parsers/json.pyindex e1b63c8779..31a1ca9606 100644--- a/libs/langchain/langchain_classic/agents/output_parsers/json.py+++ b/libs/langchain/langchain_classic/agents/output_parsers/json.py@@ -1,7 +1,6 @@from __future__ import annotationsimport logging-from typing import Unionfrom langchain_core.agents import AgentAction, AgentFinishfrom langchain_core.exceptions import OutputParserException@@ -36,7 +35,7 @@ class JSONAgentOutputParser(AgentOutputParser):"""@override- def parse(self, text: str) -> Union[AgentAction, AgentFinish]:+ def parse(self, text: str) -> AgentAction | AgentFinish:try:response = parse_json_markdown(text)if isinstance(response, list): # type: ignore[unreachable]diff --git a/libs/langchain/langchain_classic/agents/output_parsers/openai_functions.py b/libs/langchain/langchain_classic/agents/output_parsers/openai_functions.pyindex 95b2846261..a0d6bc32e7 100644--- a/libs/langchain/langchain_classic/agents/output_parsers/openai_functions.py+++ b/libs/langchain/langchain_classic/agents/output_parsers/openai_functions.py@@ -1,6 +1,5 @@import jsonfrom json import JSONDecodeError-from typing import Unionfrom langchain_core.agents import AgentAction, AgentActionMessageLog, AgentFinishfrom langchain_core.exceptions import OutputParserException@@ -31,7 +30,7 @@ class OpenAIFunctionsAgentOutputParser(AgentOutputParser):return "openai-functions-agent"@staticmethod- def parse_ai_message(message: BaseMessage) -> Union[AgentAction, AgentFinish]:+ def parse_ai_message(message: BaseMessage) -> AgentAction | AgentFinish:"""Parse an AI message."""if not isinstance(message, AIMessage):msg = f"Expected an AI message got {type(message)}"@@ -86,7 +85,7 @@ class OpenAIFunctionsAgentOutputParser(AgentOutputParser):result: list[Generation],*,partial: bool = False,- ) -> Union[AgentAction, AgentFinish]:+ ) -> AgentAction | AgentFinish:if not isinstance(result[0], ChatGeneration):msg = "This output parser only works on ChatGeneration output"raise ValueError(msg) # noqa: TRY004@@ -94,6 +93,6 @@ class OpenAIFunctionsAgentOutputParser(AgentOutputParser):return self.parse_ai_message(message)@override- def parse(self, text: str) -> Union[AgentAction, AgentFinish]:+ def parse(self, text: str) -> AgentAction | AgentFinish:msg = "Can only parse messages"raise ValueError(msg)diff --git a/libs/langchain/langchain_classic/agents/output_parsers/openai_tools.py b/libs/langchain/langchain_classic/agents/output_parsers/openai_tools.pyindex 02065ef4b2..c4a3c8c40b 100644--- a/libs/langchain/langchain_classic/agents/output_parsers/openai_tools.py+++ b/libs/langchain/langchain_classic/agents/output_parsers/openai_tools.py@@ -1,5 +1,3 @@-from typing import Union-from langchain_core.agents import AgentAction, AgentFinishfrom langchain_core.messages import BaseMessagefrom langchain_core.outputs import ChatGeneration, Generation@@ -16,7 +14,7 @@ OpenAIToolAgentAction = ToolAgentActiondef parse_ai_message_to_openai_tool_action(message: BaseMessage,-) -> Union[list[AgentAction], AgentFinish]:+) -> list[AgentAction] | AgentFinish:"""Parse an AI message potentially containing tool_calls."""tool_actions = parse_ai_message_to_tool_action(message)if isinstance(tool_actions, AgentFinish):@@ -60,7 +58,7 @@ class OpenAIToolsAgentOutputParser(MultiActionAgentOutputParser):result: list[Generation],*,partial: bool = False,- ) -> Union[list[AgentAction], AgentFinish]:+ ) -> list[AgentAction] | AgentFinish:if not isinstance(result[0], ChatGeneration):msg = "This output parser only works on ChatGeneration output"raise ValueError(msg) # noqa: TRY004@@ -68,6 +66,6 @@ class OpenAIToolsAgentOutputParser(MultiActionAgentOutputParser):return parse_ai_message_to_openai_tool_action(message)@override- def parse(self, text: str) -> Union[list[AgentAction], AgentFinish]:+ def parse(self, text: str) -> list[AgentAction] | AgentFinish:msg = "Can only parse messages"raise ValueError(msg)diff --git a/libs/langchain/langchain_classic/agents/output_parsers/react_json_single_input.py b/libs/langchain/langchain_classic/agents/output_parsers/react_json_single_input.pyindex 89747664d8..9cf66269a7 100644--- a/libs/langchain/langchain_classic/agents/output_parsers/react_json_single_input.py+++ b/libs/langchain/langchain_classic/agents/output_parsers/react_json_single_input.py@@ -1,7 +1,6 @@import jsonimport refrom re import Pattern-from typing import Unionfrom langchain_core.agents import AgentAction, AgentFinishfrom langchain_core.exceptions import OutputParserException@@ -52,7 +51,7 @@ class ReActJsonSingleInputOutputParser(AgentOutputParser):return FORMAT_INSTRUCTIONS@override- def parse(self, text: str) -> Union[AgentAction, AgentFinish]:+ def parse(self, text: str) -> AgentAction | AgentFinish:includes_answer = FINAL_ANSWER_ACTION in texttry:found = self.pattern.search(text)diff --git a/libs/langchain/langchain_classic/agents/output_parsers/react_single_input.py b/libs/langchain/langchain_classic/agents/output_parsers/react_single_input.pyindex 1a86f52ba9..ed5053cf28 100644--- a/libs/langchain/langchain_classic/agents/output_parsers/react_single_input.py+++ b/libs/langchain/langchain_classic/agents/output_parsers/react_single_input.py@@ -1,5 +1,4 @@import re-from typing import Unionfrom langchain_core.agents import AgentAction, AgentFinishfrom langchain_core.exceptions import OutputParserException@@ -51,7 +50,7 @@ class ReActSingleInputOutputParser(AgentOutputParser):return FORMAT_INSTRUCTIONS@override- def parse(self, text: str) -> Union[AgentAction, AgentFinish]:+ def parse(self, text: str) -> AgentAction | AgentFinish:includes_answer = FINAL_ANSWER_ACTION in textregex = (r"Action\s*\d*\s*:[\s]*(.*?)[\s]*Action\s*\d*\s*Input\s*\d*\s*:[\s]*(.*)"diff --git a/libs/langchain/langchain_classic/agents/output_parsers/self_ask.py b/libs/langchain/langchain_classic/agents/output_parsers/self_ask.pyindex 34895c0b98..620e6c794a 100644--- a/libs/langchain/langchain_classic/agents/output_parsers/self_ask.py+++ b/libs/langchain/langchain_classic/agents/output_parsers/self_ask.py@@ -1,5 +1,4 @@from collections.abc import Sequence-from typing import Unionfrom langchain_core.agents import AgentAction, AgentFinishfrom langchain_core.exceptions import OutputParserException@@ -37,7 +36,7 @@ class SelfAskOutputParser(AgentOutputParser):finish_string: str = "So the final answer is: "@override- def parse(self, text: str) -> Union[AgentAction, AgentFinish]:+ def parse(self, text: str) -> AgentAction | AgentFinish:last_line = text.split("\n")[-1]if not any(follow in last_line for follow in self.followups):if self.finish_string not in last_line:diff --git a/libs/langchain/langchain_classic/agents/output_parsers/tools.py b/libs/langchain/langchain_classic/agents/output_parsers/tools.pyindex d64f0d65b7..d4175bab7a 100644--- a/libs/langchain/langchain_classic/agents/output_parsers/tools.py+++ b/libs/langchain/langchain_classic/agents/output_parsers/tools.py@@ -1,6 +1,5 @@import jsonfrom json import JSONDecodeError-from typing import Unionfrom langchain_core.agents import AgentAction, AgentActionMessageLog, AgentFinishfrom langchain_core.exceptions import OutputParserException@@ -24,7 +23,7 @@ class ToolAgentAction(AgentActionMessageLog):def parse_ai_message_to_tool_action(message: BaseMessage,-) -> Union[list[AgentAction], AgentFinish]:+) -> list[AgentAction] | AgentFinish:"""Parse an AI message potentially containing tool_calls."""if not isinstance(message, AIMessage):msg = f"Expected an AI message got {type(message)}"@@ -104,7 +103,7 @@ class ToolsAgentOutputParser(MultiActionAgentOutputParser):result: list[Generation],*,partial: bool = False,- ) -> Union[list[AgentAction], AgentFinish]:+ ) -> list[AgentAction] | AgentFinish:if not isinstance(result[0], ChatGeneration):msg = "This output parser only works on ChatGeneration output"raise ValueError(msg) # noqa: TRY004@@ -112,6 +111,6 @@ class ToolsAgentOutputParser(MultiActionAgentOutputParser):return parse_ai_message_to_tool_action(message)@override- def parse(self, text: str) -> Union[list[AgentAction], AgentFinish]:+ def parse(self, text: str) -> list[AgentAction] | AgentFinish:msg = "Can only parse messages"raise ValueError(msg)diff --git a/libs/langchain/langchain_classic/agents/output_parsers/xml.py b/libs/langchain/langchain_classic/agents/output_parsers/xml.pyindex f6b919d159..b5cd6058f2 100644--- a/libs/langchain/langchain_classic/agents/output_parsers/xml.py+++ b/libs/langchain/langchain_classic/agents/output_parsers/xml.py@@ -1,5 +1,5 @@import re-from typing import Literal, Optional, Union+from typing import Literalfrom langchain_core.agents import AgentAction, AgentFinishfrom pydantic import Field@@ -57,7 +57,7 @@ class XMLAgentOutputParser(AgentOutputParser):contains malformed XML structure."""- escape_format: Optional[Literal["minimal"]] = Field(default="minimal")+ escape_format: Literal["minimal"] | None = Field(default="minimal")"""The format to use for escaping XML characters.minimal - uses custom delimiters to replace XML tags within content,@@ -67,7 +67,7 @@ class XMLAgentOutputParser(AgentOutputParser):"""@override- def parse(self, text: str) -> Union[AgentAction, AgentFinish]:+ def parse(self, text: str) -> AgentAction | AgentFinish:# Check for tool invocation firsttool_matches = re.findall(r"<tool>(.*?)</tool>", text, re.DOTALL)if tool_matches:diff --git a/libs/langchain/langchain_classic/agents/react/agent.py b/libs/langchain/langchain_classic/agents/react/agent.pyindex 5c49ba7750..b290281a8c 100644--- a/libs/langchain/langchain_classic/agents/react/agent.py+++ b/libs/langchain/langchain_classic/agents/react/agent.py@@ -1,7 +1,6 @@from __future__ import annotationsfrom collections.abc import Sequence-from typing import Optional, Unionfrom langchain_core.language_models import BaseLanguageModelfrom langchain_core.prompts import BasePromptTemplate@@ -18,10 +17,10 @@ def create_react_agent(llm: BaseLanguageModel,tools: Sequence[BaseTool],prompt: BasePromptTemplate,- output_parser: Optional[AgentOutputParser] = None,+ output_parser: AgentOutputParser | None = None,tools_renderer: ToolsRenderer = render_text_description,*,- stop_sequence: Union[bool, list[str]] = True,+ stop_sequence: bool | list[str] = True,) -> Runnable:r"""Create an agent that uses ReAct prompting.diff --git a/libs/langchain/langchain_classic/agents/react/base.py b/libs/langchain/langchain_classic/agents/react/base.pyindex eecfea4111..34c41b709a 100644--- a/libs/langchain/langchain_classic/agents/react/base.py+++ b/libs/langchain/langchain_classic/agents/react/base.py@@ -3,7 +3,7 @@from __future__ import annotationsfrom collections.abc import Sequence-from typing import TYPE_CHECKING, Any, Optional+from typing import TYPE_CHECKING, Anyfrom langchain_core._api import deprecatedfrom langchain_core.documents import Document@@ -92,7 +92,7 @@ class DocstoreExplorer:def __init__(self, docstore: Docstore):"""Initialize with a docstore, and set initial document to None."""self.docstore = docstore- self.document: Optional[Document] = None+ self.document: Document | None = Noneself.lookup_str = ""self.lookup_index = 0diff --git a/libs/langchain/langchain_classic/agents/react/output_parser.py b/libs/langchain/langchain_classic/agents/react/output_parser.pyindex 3c2a60ad5a..a1aae0e036 100644--- a/libs/langchain/langchain_classic/agents/react/output_parser.py+++ b/libs/langchain/langchain_classic/agents/react/output_parser.py@@ -1,5 +1,4 @@import re-from typing import Unionfrom langchain_core.agents import AgentAction, AgentFinishfrom langchain_core.exceptions import OutputParserException@@ -12,7 +11,7 @@ class ReActOutputParser(AgentOutputParser):"""Output parser for the ReAct agent."""@override- def parse(self, text: str) -> Union[AgentAction, AgentFinish]:+ def parse(self, text: str) -> AgentAction | AgentFinish:action_prefix = "Action: "if not text.strip().split("\n")[-1].startswith(action_prefix):msg = f"Could not parse LLM Output: {text}"diff --git a/libs/langchain/langchain_classic/agents/self_ask_with_search/base.py b/libs/langchain/langchain_classic/agents/self_ask_with_search/base.pyindex 345a5bf80f..c0ca6078a6 100644--- a/libs/langchain/langchain_classic/agents/self_ask_with_search/base.py+++ b/libs/langchain/langchain_classic/agents/self_ask_with_search/base.py@@ -3,7 +3,7 @@from __future__ import annotationsfrom collections.abc import Sequence-from typing import TYPE_CHECKING, Any, Union+from typing import TYPE_CHECKING, Anyfrom langchain_core._api import deprecatedfrom langchain_core.language_models import BaseLanguageModel@@ -80,11 +80,7 @@ class SelfAskWithSearchChain(AgentExecutor):def __init__(self,llm: BaseLanguageModel,- search_chain: Union[- GoogleSerperAPIWrapper,- SearchApiAPIWrapper,- SerpAPIWrapper,- ],+ search_chain: GoogleSerperAPIWrapper | SearchApiAPIWrapper | SerpAPIWrapper,**kwargs: Any,):"""Initialize only with an LLM and a search chain."""diff --git a/libs/langchain/langchain_classic/agents/structured_chat/base.py b/libs/langchain/langchain_classic/agents/structured_chat/base.pyindex 599699ba79..488fb24281 100644--- a/libs/langchain/langchain_classic/agents/structured_chat/base.py+++ b/libs/langchain/langchain_classic/agents/structured_chat/base.py@@ -1,6 +1,6 @@import refrom collections.abc import Sequence-from typing import Any, Optional, Union+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.agents import AgentAction@@ -78,7 +78,7 @@ class StructuredChatAgent(Agent):@overridedef _get_default_output_parser(cls,- llm: Optional[BaseLanguageModel] = None,+ llm: BaseLanguageModel | None = None,**kwargs: Any,) -> AgentOutputParser:return StructuredChatOutputParserWithRetries.from_llm(llm=llm)@@ -97,8 +97,8 @@ class StructuredChatAgent(Agent):suffix: str = SUFFIX,human_message_template: str = HUMAN_MESSAGE_TEMPLATE,format_instructions: str = FORMAT_INSTRUCTIONS,- input_variables: Optional[list[str]] = None,- memory_prompts: Optional[list[BasePromptTemplate]] = None,+ input_variables: list[str] | None = None,+ memory_prompts: list[BasePromptTemplate] | None = None,) -> BasePromptTemplate:tool_strings = []for tool in tools:@@ -123,14 +123,14 @@ class StructuredChatAgent(Agent):cls,llm: BaseLanguageModel,tools: Sequence[BaseTool],- callback_manager: Optional[BaseCallbackManager] = None,- output_parser: Optional[AgentOutputParser] = None,+ callback_manager: BaseCallbackManager | None = None,+ output_parser: AgentOutputParser | None = None,prefix: str = PREFIX,suffix: str = SUFFIX,human_message_template: str = HUMAN_MESSAGE_TEMPLATE,format_instructions: str = FORMAT_INSTRUCTIONS,- input_variables: Optional[list[str]] = None,- memory_prompts: Optional[list[BasePromptTemplate]] = None,+ input_variables: list[str] | None = None,+ memory_prompts: list[BasePromptTemplate] | None = None,**kwargs: Any,) -> Agent:"""Construct an agent from an LLM and tools."""@@ -169,7 +169,7 @@ def create_structured_chat_agent(prompt: ChatPromptTemplate,tools_renderer: ToolsRenderer = render_text_description_and_args,*,- stop_sequence: Union[bool, list[str]] = True,+ stop_sequence: bool | list[str] = True,) -> Runnable:"""Create an agent aimed at supporting tools with multiple inputs.diff --git a/libs/langchain/langchain_classic/agents/structured_chat/output_parser.py b/libs/langchain/langchain_classic/agents/structured_chat/output_parser.pyindex 46beaae8c5..1a64825bc7 100644--- a/libs/langchain/langchain_classic/agents/structured_chat/output_parser.py+++ b/libs/langchain/langchain_classic/agents/structured_chat/output_parser.py@@ -4,7 +4,6 @@ import jsonimport loggingimport refrom re import Pattern-from typing import Optional, Unionfrom langchain_core.agents import AgentAction, AgentFinishfrom langchain_core.exceptions import OutputParserException@@ -34,7 +33,7 @@ class StructuredChatOutputParser(AgentOutputParser):return self.format_instructions@override- def parse(self, text: str) -> Union[AgentAction, AgentFinish]:+ def parse(self, text: str) -> AgentAction | AgentFinish:try:action_match = self.pattern.search(text)if action_match is not None:@@ -65,7 +64,7 @@ class StructuredChatOutputParserWithRetries(AgentOutputParser):base_parser: AgentOutputParser = Field(default_factory=StructuredChatOutputParser)"""The base parser to use."""- output_fixing_parser: Optional[OutputFixingParser] = None+ output_fixing_parser: OutputFixingParser | None = None"""The output fixing parser to use."""@override@@ -73,7 +72,7 @@ class StructuredChatOutputParserWithRetries(AgentOutputParser):return FORMAT_INSTRUCTIONS@override- def parse(self, text: str) -> Union[AgentAction, AgentFinish]:+ def parse(self, text: str) -> AgentAction | AgentFinish:try:if self.output_fixing_parser is not None:return self.output_fixing_parser.parse(text)@@ -85,8 +84,8 @@ class StructuredChatOutputParserWithRetries(AgentOutputParser):@classmethoddef from_llm(cls,- llm: Optional[BaseLanguageModel] = None,- base_parser: Optional[StructuredChatOutputParser] = None,+ llm: BaseLanguageModel | None = None,+ base_parser: StructuredChatOutputParser | None = None,) -> StructuredChatOutputParserWithRetries:"""Create a StructuredChatOutputParserWithRetries from a language model.diff --git a/libs/langchain/langchain_classic/agents/tool_calling_agent/base.py b/libs/langchain/langchain_classic/agents/tool_calling_agent/base.pyindex 5d6fc7d0fd..8018a94535 100644--- a/libs/langchain/langchain_classic/agents/tool_calling_agent/base.py+++ b/libs/langchain/langchain_classic/agents/tool_calling_agent/base.py@@ -1,5 +1,4 @@-from collections.abc import Sequence-from typing import Callable+from collections.abc import Callable, Sequencefrom langchain_core.agents import AgentActionfrom langchain_core.language_models import BaseLanguageModeldiff --git a/libs/langchain/langchain_classic/agents/tools.py b/libs/langchain/langchain_classic/agents/tools.pyindex ec50400faf..9b599ef556 100644--- a/libs/langchain/langchain_classic/agents/tools.py+++ b/libs/langchain/langchain_classic/agents/tools.py@@ -1,7 +1,5 @@"""Interface for tools."""-from typing import Optional-from langchain_core.callbacks import (AsyncCallbackManagerForToolRun,CallbackManagerForToolRun,@@ -23,7 +21,7 @@ class InvalidTool(BaseTool):self,requested_tool_name: str,available_tool_names: list[str],- run_manager: Optional[CallbackManagerForToolRun] = None,+ run_manager: CallbackManagerForToolRun | None = None,) -> str:"""Use the tool."""available_tool_names_str = ", ".join(list(available_tool_names))@@ -37,7 +35,7 @@ class InvalidTool(BaseTool):self,requested_tool_name: str,available_tool_names: list[str],- run_manager: Optional[AsyncCallbackManagerForToolRun] = None,+ run_manager: AsyncCallbackManagerForToolRun | None = None,) -> str:"""Use the tool asynchronously."""available_tool_names_str = ", ".join(list(available_tool_names))diff --git a/libs/langchain/langchain_classic/agents/types.py b/libs/langchain/langchain_classic/agents/types.pyindex 97910a7552..406d814b59 100644--- a/libs/langchain/langchain_classic/agents/types.py+++ b/libs/langchain/langchain_classic/agents/types.py@@ -1,5 +1,3 @@-from typing import Union-from langchain_classic.agents.agent import BaseSingleActionAgentfrom langchain_classic.agents.agent_types import AgentTypefrom langchain_classic.agents.chat.base import ChatAgent@@ -14,7 +12,7 @@ from langchain_classic.agents.react.base import ReActDocstoreAgentfrom langchain_classic.agents.self_ask_with_search.base import SelfAskWithSearchAgentfrom langchain_classic.agents.structured_chat.base import StructuredChatAgent-AGENT_TYPE = Union[type[BaseSingleActionAgent], type[OpenAIMultiFunctionsAgent]]+AGENT_TYPE = type[BaseSingleActionAgent] | type[OpenAIMultiFunctionsAgent]AGENT_TO_CLASS: dict[AgentType, AGENT_TYPE] = {AgentType.ZERO_SHOT_REACT_DESCRIPTION: ZeroShotAgent,diff --git a/libs/langchain/langchain_classic/agents/xml/base.py b/libs/langchain/langchain_classic/agents/xml/base.pyindex ad146ecb61..8dc226aad9 100644--- a/libs/langchain/langchain_classic/agents/xml/base.py+++ b/libs/langchain/langchain_classic/agents/xml/base.py@@ -1,5 +1,5 @@from collections.abc import Sequence-from typing import Any, Union+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.agents import AgentAction, AgentFinish@@ -68,7 +68,7 @@ class XMLAgent(BaseSingleActionAgent):intermediate_steps: list[tuple[AgentAction, str]],callbacks: Callbacks = None,**kwargs: Any,- ) -> Union[AgentAction, AgentFinish]:+ ) -> AgentAction | AgentFinish:log = ""for action, observation in intermediate_steps:log += (@@ -93,7 +93,7 @@ class XMLAgent(BaseSingleActionAgent):intermediate_steps: list[tuple[AgentAction, str]],callbacks: Callbacks = None,**kwargs: Any,- ) -> Union[AgentAction, AgentFinish]:+ ) -> AgentAction | AgentFinish:log = ""for action, observation in intermediate_steps:log += (@@ -119,7 +119,7 @@ def create_xml_agent(prompt: BasePromptTemplate,tools_renderer: ToolsRenderer = render_text_description,*,- stop_sequence: Union[bool, list[str]] = True,+ stop_sequence: bool | list[str] = True,) -> Runnable:r"""Create an agent that uses XML to format its logic.diff --git a/libs/langchain/langchain_classic/callbacks/streaming_aiter.py b/libs/langchain/langchain_classic/callbacks/streaming_aiter.pyindex f5f2ba43e6..0811e86a3e 100644--- a/libs/langchain/langchain_classic/callbacks/streaming_aiter.py+++ b/libs/langchain/langchain_classic/callbacks/streaming_aiter.py@@ -2,7 +2,7 @@ from __future__ import annotationsimport asynciofrom collections.abc import AsyncIterator-from typing import Any, Literal, Union, cast+from typing import Any, Literal, castfrom langchain_core.callbacks import AsyncCallbackHandlerfrom langchain_core.outputs import LLMResult@@ -73,7 +73,7 @@ class AsyncIteratorCallbackHandler(AsyncCallbackHandler):other.pop().cancel()# Extract the value of the first completed task- token_or_done = cast("Union[str, Literal[True]]", done.pop().result())+ token_or_done = cast("str | Literal[True]", done.pop().result())# If the extracted value is the boolean True, the done event was setif token_or_done is True:diff --git a/libs/langchain/langchain_classic/callbacks/streaming_aiter_final_only.py b/libs/langchain/langchain_classic/callbacks/streaming_aiter_final_only.pyindex 52ec1fea11..744475e662 100644--- a/libs/langchain/langchain_classic/callbacks/streaming_aiter_final_only.py+++ b/libs/langchain/langchain_classic/callbacks/streaming_aiter_final_only.py@@ -1,6 +1,6 @@from __future__ import annotations-from typing import Any, Optional+from typing import Anyfrom langchain_core.outputs import LLMResultfrom typing_extensions import override@@ -33,7 +33,7 @@ class AsyncFinalIteratorCallbackHandler(AsyncIteratorCallbackHandler):def __init__(self,*,- answer_prefix_tokens: Optional[list[str]] = None,+ answer_prefix_tokens: list[str] | None = None,strip_tokens: bool = True,stream_prefix: bool = False,) -> None:diff --git a/libs/langchain/langchain_classic/callbacks/streaming_stdout_final_only.py b/libs/langchain/langchain_classic/callbacks/streaming_stdout_final_only.pyindex a154dfcf59..e8eee519b3 100644--- a/libs/langchain/langchain_classic/callbacks/streaming_stdout_final_only.py+++ b/libs/langchain/langchain_classic/callbacks/streaming_stdout_final_only.py@@ -1,7 +1,7 @@"""Callback Handler streams to stdout on new llm token."""import sys-from typing import Any, Optional+from typing import Anyfrom langchain_core.callbacks import StreamingStdOutCallbackHandlerfrom typing_extensions import override@@ -34,7 +34,7 @@ class FinalStreamingStdOutCallbackHandler(StreamingStdOutCallbackHandler):def __init__(self,*,- answer_prefix_tokens: Optional[list[str]] = None,+ answer_prefix_tokens: list[str] | None = None,strip_tokens: bool = True,stream_prefix: bool = False,) -> None:diff --git a/libs/langchain/langchain_classic/callbacks/streamlit/__init__.py b/libs/langchain/langchain_classic/callbacks/streamlit/__init__.pyindex a36aaa2f9d..04a9222eba 100644--- a/libs/langchain/langchain_classic/callbacks/streamlit/__init__.py+++ b/libs/langchain/langchain_classic/callbacks/streamlit/__init__.py@@ -1,6 +1,6 @@from __future__ import annotations-from typing import TYPE_CHECKING, Optional+from typing import TYPE_CHECKINGfrom langchain_core.callbacks.base import BaseCallbackHandler@@ -15,7 +15,7 @@ def StreamlitCallbackHandler( # noqa: N802max_thought_containers: int = 4,expand_new_thoughts: bool = True,collapse_completed_thoughts: bool = True,- thought_labeler: Optional[LLMThoughtLabeler] = None,+ thought_labeler: LLMThoughtLabeler | None = None,) -> BaseCallbackHandler:"""Callback Handler that writes to a Streamlit app.diff --git a/libs/langchain/langchain_classic/callbacks/tracers/logging.py b/libs/langchain/langchain_classic/callbacks/tracers/logging.pyindex 13e4cb0459..884e9f4f1f 100644--- a/libs/langchain/langchain_classic/callbacks/tracers/logging.py+++ b/libs/langchain/langchain_classic/callbacks/tracers/logging.py@@ -1,7 +1,7 @@__all__ = ["LoggingCallbackHandler"]import logging-from typing import Any, Optional+from typing import Anyfrom uuid import UUIDfrom langchain_core.exceptions import TracerException@@ -19,7 +19,7 @@ class LoggingCallbackHandler(FunctionCallbackHandler):self,logger: logging.Logger,log_level: int = logging.INFO,- extra: Optional[dict] = None,+ extra: dict | None = None,**kwargs: Any,) -> None:"""Initialize the LoggingCallbackHandler.@@ -43,7 +43,7 @@ class LoggingCallbackHandler(FunctionCallbackHandler):text: str,*,run_id: UUID,- parent_run_id: Optional[UUID] = None,+ parent_run_id: UUID | None = None,**kwargs: Any,) -> None:try:diff --git a/libs/langchain/langchain_classic/chains/api/base.py b/libs/langchain/langchain_classic/chains/api/base.pyindex a54f8ce030..33867cabdf 100644--- a/libs/langchain/langchain_classic/chains/api/base.py+++ b/libs/langchain/langchain_classic/chains/api/base.py@@ -3,7 +3,7 @@from __future__ import annotationsfrom collections.abc import Sequence-from typing import Any, Optional+from typing import Anyfrom urllib.parse import urlparsefrom langchain_core._api import deprecated@@ -202,7 +202,7 @@ try:api_docs: strquestion_key: str = "question" #: :meta private:output_key: str = "output" #: :meta private:- limit_to_domains: Optional[Sequence[str]] = Field(default_factory=list) # type: ignore[arg-type]+ limit_to_domains: Sequence[str] | None = Field(default_factory=list) # type: ignore[arg-type]"""Use to limit the domains that can be accessed by the API chain.* For example, to limit to just the domain `https://www.example.com`, set@@ -278,7 +278,7 @@ try:def _call(self,inputs: dict[str, Any],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, str]:_run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()question = inputs[self.question_key]@@ -316,7 +316,7 @@ try:async def _acall(self,inputs: dict[str, Any],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, str]:_run_manager = (run_manager or AsyncCallbackManagerForChainRun.get_noop_manager()@@ -363,10 +363,10 @@ try:cls,llm: BaseLanguageModel,api_docs: str,- headers: Optional[dict] = None,+ headers: dict | None = None,api_url_prompt: BasePromptTemplate = API_URL_PROMPT,api_response_prompt: BasePromptTemplate = API_RESPONSE_PROMPT,- limit_to_domains: Optional[Sequence[str]] = (),+ limit_to_domains: Sequence[str] | None = (),**kwargs: Any,) -> APIChain:"""Load chain from just an LLM and the api docs."""diff --git a/libs/langchain/langchain_classic/chains/base.py b/libs/langchain/langchain_classic/chains/base.pyindex 941053832f..7c522d4879 100644--- a/libs/langchain/langchain_classic/chains/base.py+++ b/libs/langchain/langchain_classic/chains/base.py@@ -8,7 +8,7 @@ import loggingimport warningsfrom abc import ABC, abstractmethodfrom pathlib import Path-from typing import Any, Optional, Union, cast+from typing import Any, castimport yamlfrom langchain_core._api import deprecated@@ -72,7 +72,7 @@ class Chain(RunnableSerializable[dict[str, Any], dict[str, Any]], ABC):chains and cannot return as rich of an output as `__call__`."""- memory: Optional[BaseMemory] = None+ memory: BaseMemory | None = None"""Optional memory object. Defaults to None.Memory is a class that gets called at the startand at the end of every chain. At the start, memory loads variables and passes@@ -89,19 +89,19 @@ class Chain(RunnableSerializable[dict[str, Any], dict[str, Any]], ABC):"""Whether or not run in verbose mode. In verbose mode, some intermediate logswill be printed to the console. Defaults to the global `verbose` value,accessible via `langchain.globals.get_verbose()`."""- tags: Optional[list[str]] = None+ tags: list[str] | None = None"""Optional list of tags associated with the chain. Defaults to None.These tags will be associated with each call to this chain,and passed as arguments to the handlers defined in `callbacks`.You can use these to eg identify a specific instance of a chain with its use case."""- metadata: Optional[dict[str, Any]] = None+ metadata: dict[str, Any] | None = None"""Optional metadata associated with the chain. Defaults to None.This metadata will be associated with each call to this chain,and passed as arguments to the handlers defined in `callbacks`.You can use these to eg identify a specific instance of a chain with its use case."""- callback_manager: Optional[BaseCallbackManager] = Field(default=None, exclude=True)+ callback_manager: BaseCallbackManager | None = Field(default=None, exclude=True)"""[DEPRECATED] Use `callbacks` instead."""model_config = ConfigDict(@@ -111,7 +111,7 @@ class Chain(RunnableSerializable[dict[str, Any], dict[str, Any]], ABC):@overridedef get_input_schema(self,- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,) -> type[BaseModel]:# This is correct, but pydantic typings/mypy don't think so.return create_model("ChainInput", **dict.fromkeys(self.input_keys, (Any, None)))@@ -119,7 +119,7 @@ class Chain(RunnableSerializable[dict[str, Any], dict[str, Any]], ABC):@overridedef get_output_schema(self,- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,) -> type[BaseModel]:# This is correct, but pydantic typings/mypy don't think so.return create_model(@@ -131,7 +131,7 @@ class Chain(RunnableSerializable[dict[str, Any], dict[str, Any]], ABC):def invoke(self,input: dict[str, Any],- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,**kwargs: Any,) -> dict[str, Any]:config = ensure_config(config)@@ -187,7 +187,7 @@ class Chain(RunnableSerializable[dict[str, Any], dict[str, Any]], ABC):async def ainvoke(self,input: dict[str, Any],- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,**kwargs: Any,) -> dict[str, Any]:config = ensure_config(config)@@ -266,7 +266,7 @@ class Chain(RunnableSerializable[dict[str, Any], dict[str, Any]], ABC):@classmethoddef set_verbose(cls,- verbose: Optional[bool], # noqa: FBT001+ verbose: bool | None, # noqa: FBT001) -> bool:"""Set the chain verbosity.@@ -318,7 +318,7 @@ class Chain(RunnableSerializable[dict[str, Any], dict[str, Any]], ABC):def _call(self,inputs: dict[str, Any],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, Any]:"""Execute the chain.@@ -340,7 +340,7 @@ class Chain(RunnableSerializable[dict[str, Any], dict[str, Any]], ABC):async def _acall(self,inputs: dict[str, Any],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, Any]:"""Asynchronously execute the chain.@@ -368,13 +368,13 @@ class Chain(RunnableSerializable[dict[str, Any], dict[str, Any]], ABC):@deprecated("0.1.0", alternative="invoke", removal="1.0")def __call__(self,- inputs: Union[dict[str, Any], Any],+ inputs: dict[str, Any] | Any,return_only_outputs: bool = False, # noqa: FBT001,FBT002callbacks: Callbacks = None,*,- tags: Optional[list[str]] = None,- metadata: Optional[dict[str, Any]] = None,- run_name: Optional[str] = None,+ tags: list[str] | None = None,+ metadata: dict[str, Any] | None = None,+ run_name: str | None = None,include_run_info: bool = False,) -> dict[str, Any]:"""Execute the chain.@@ -420,13 +420,13 @@ class Chain(RunnableSerializable[dict[str, Any], dict[str, Any]], ABC):@deprecated("0.1.0", alternative="ainvoke", removal="1.0")async def acall(self,- inputs: Union[dict[str, Any], Any],+ inputs: dict[str, Any] | Any,return_only_outputs: bool = False, # noqa: FBT001,FBT002callbacks: Callbacks = None,*,- tags: Optional[list[str]] = None,- metadata: Optional[dict[str, Any]] = None,- run_name: Optional[str] = None,+ tags: list[str] | None = None,+ metadata: dict[str, Any] | None = None,+ run_name: str | None = None,include_run_info: bool = False,) -> dict[str, Any]:"""Asynchronously execute the chain.@@ -518,7 +518,7 @@ class Chain(RunnableSerializable[dict[str, Any], dict[str, Any]], ABC):return outputsreturn {**inputs, **outputs}- def prep_inputs(self, inputs: Union[dict[str, Any], Any]) -> dict[str, str]:+ def prep_inputs(self, inputs: dict[str, Any] | Any) -> dict[str, str]:"""Prepare chain inputs, including adding inputs from memory.Args:@@ -542,7 +542,7 @@ class Chain(RunnableSerializable[dict[str, Any], dict[str, Any]], ABC):inputs = dict(inputs, **external_context)return inputs- async def aprep_inputs(self, inputs: Union[dict[str, Any], Any]) -> dict[str, str]:+ async def aprep_inputs(self, inputs: dict[str, Any] | Any) -> dict[str, str]:"""Prepare chain inputs, including adding inputs from memory.Args:@@ -581,8 +581,8 @@ class Chain(RunnableSerializable[dict[str, Any], dict[str, Any]], ABC):self,*args: Any,callbacks: Callbacks = None,- tags: Optional[list[str]] = None,- metadata: Optional[dict[str, Any]] = None,+ tags: list[str] | None = None,+ metadata: dict[str, Any] | None = None,**kwargs: Any,) -> Any:"""Convenience method for executing chain.@@ -656,8 +656,8 @@ class Chain(RunnableSerializable[dict[str, Any], dict[str, Any]], ABC):self,*args: Any,callbacks: Callbacks = None,- tags: Optional[list[str]] = None,- metadata: Optional[dict[str, Any]] = None,+ tags: list[str] | None = None,+ metadata: dict[str, Any] | None = None,**kwargs: Any,) -> Any:"""Convenience method for executing chain.@@ -759,7 +759,7 @@ class Chain(RunnableSerializable[dict[str, Any], dict[str, Any]], ABC):_dict["_type"] = self._chain_typereturn _dict- def save(self, file_path: Union[Path, str]) -> None:+ def save(self, file_path: Path | str) -> None:"""Save the chain.Expects `Chain._chain_type` property to be implemented and for memory to bediff --git a/libs/langchain/langchain_classic/chains/combine_documents/base.py b/libs/langchain/langchain_classic/chains/combine_documents/base.pyindex 222cd9da58..afe7301d3d 100644--- a/libs/langchain/langchain_classic/chains/combine_documents/base.py+++ b/libs/langchain/langchain_classic/chains/combine_documents/base.py@@ -1,7 +1,7 @@"""Base interface for chains combining documents."""from abc import ABC, abstractmethod-from typing import Any, Optional+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.callbacks import (@@ -50,7 +50,7 @@ class BaseCombineDocumentsChain(Chain, ABC):@overridedef get_input_schema(self,- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,) -> type[BaseModel]:return create_model("CombineDocumentsInput",@@ -60,7 +60,7 @@ class BaseCombineDocumentsChain(Chain, ABC):@overridedef get_output_schema(self,- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,) -> type[BaseModel]:return create_model("CombineDocumentsOutput",@@ -83,7 +83,7 @@ class BaseCombineDocumentsChain(Chain, ABC):"""return [self.output_key]- def prompt_length(self, docs: list[Document], **kwargs: Any) -> Optional[int]: # noqa: ARG002+ def prompt_length(self, docs: list[Document], **kwargs: Any) -> int | None: # noqa: ARG002"""Return the prompt length given the documents passed in.This can be used by a caller to determine whether passing in a list@@ -137,7 +137,7 @@ class BaseCombineDocumentsChain(Chain, ABC):def _call(self,inputs: dict[str, list[Document]],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, str]:"""Prepare inputs, call combine docs, prepare outputs."""_run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()@@ -155,7 +155,7 @@ class BaseCombineDocumentsChain(Chain, ABC):async def _acall(self,inputs: dict[str, list[Document]],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, str]:"""Prepare inputs, call combine docs, prepare outputs."""_run_manager = run_manager or AsyncCallbackManagerForChainRun.get_noop_manager()@@ -258,7 +258,7 @@ class AnalyzeDocumentChain(Chain):@overridedef get_input_schema(self,- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,) -> type[BaseModel]:return create_model("AnalyzeDocumentChain",@@ -268,14 +268,14 @@ class AnalyzeDocumentChain(Chain):@overridedef get_output_schema(self,- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,) -> type[BaseModel]:return self.combine_docs_chain.get_output_schema(config)def _call(self,inputs: dict[str, str],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, str]:"""Split document into chunks and pass to CombineDocumentsChain."""_run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()diff --git a/libs/langchain/langchain_classic/chains/combine_documents/map_reduce.py b/libs/langchain/langchain_classic/chains/combine_documents/map_reduce.pyindex 83baa7bb46..f2a6ae14b4 100644--- a/libs/langchain/langchain_classic/chains/combine_documents/map_reduce.py+++ b/libs/langchain/langchain_classic/chains/combine_documents/map_reduce.py@@ -2,7 +2,7 @@from __future__ import annotations-from typing import Any, Optional+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.callbacks import Callbacks@@ -111,7 +111,7 @@ class MapReduceDocumentsChain(BaseCombineDocumentsChain):@overridedef get_output_schema(self,- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,) -> type[BaseModel]:if self.return_intermediate_steps:return create_model(@@ -228,7 +228,7 @@ class MapReduceDocumentsChain(BaseCombineDocumentsChain):def combine_docs(self,docs: list[Document],- token_max: Optional[int] = None,+ token_max: int | None = None,callbacks: Callbacks = None,**kwargs: Any,) -> tuple[str, dict]:@@ -262,7 +262,7 @@ class MapReduceDocumentsChain(BaseCombineDocumentsChain):async def acombine_docs(self,docs: list[Document],- token_max: Optional[int] = None,+ token_max: int | None = None,callbacks: Callbacks = None,**kwargs: Any,) -> tuple[str, dict]:diff --git a/libs/langchain/langchain_classic/chains/combine_documents/map_rerank.py b/libs/langchain/langchain_classic/chains/combine_documents/map_rerank.pyindex 4254566116..1ba6c3e5e4 100644--- a/libs/langchain/langchain_classic/chains/combine_documents/map_rerank.py+++ b/libs/langchain/langchain_classic/chains/combine_documents/map_rerank.py@@ -3,7 +3,7 @@from __future__ import annotationsfrom collections.abc import Sequence-from typing import Any, Optional, Union, cast+from typing import Any, castfrom langchain_core._api import deprecatedfrom langchain_core.callbacks import Callbacks@@ -81,7 +81,7 @@ class MapRerankDocumentsChain(BaseCombineDocumentsChain):"""Key in output of llm_chain to rank on."""answer_key: str"""Key in output of llm_chain to return as answer."""- metadata_keys: Optional[list[str]] = None+ metadata_keys: list[str] | None = None"""Additional metadata from the chosen document to return."""return_intermediate_steps: bool = False"""Return intermediate steps.@@ -95,7 +95,7 @@ class MapRerankDocumentsChain(BaseCombineDocumentsChain):@overridedef get_output_schema(self,- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,) -> type[BaseModel]:schema: dict[str, Any] = {self.output_key: (str, None),@@ -228,11 +228,11 @@ class MapRerankDocumentsChain(BaseCombineDocumentsChain):def _process_results(self,docs: list[Document],- results: Sequence[Union[str, list[str], dict[str, str]]],+ results: Sequence[str | list[str] | dict[str, str]],) -> tuple[str, dict]:typed_results = cast("list[dict]", results)sorted_res = sorted(- zip(typed_results, docs),+ zip(typed_results, docs, strict=False),key=lambda x: -int(x[0][self.rank_key]),)output, document = sorted_res[0]diff --git a/libs/langchain/langchain_classic/chains/combine_documents/reduce.py b/libs/langchain/langchain_classic/chains/combine_documents/reduce.pyindex 5a72bfa5a6..86f5f07d9c 100644--- a/libs/langchain/langchain_classic/chains/combine_documents/reduce.py+++ b/libs/langchain/langchain_classic/chains/combine_documents/reduce.py@@ -2,7 +2,8 @@from __future__ import annotations-from typing import Any, Callable, Optional, Protocol+from collections.abc import Callable+from typing import Any, Protocolfrom langchain_core._api import deprecatedfrom langchain_core.callbacks import Callbacks@@ -204,7 +205,7 @@ class ReduceDocumentsChain(BaseCombineDocumentsChain):combine_documents_chain: BaseCombineDocumentsChain"""Final chain to call to combine documents.This is typically a StuffDocumentsChain."""- collapse_documents_chain: Optional[BaseCombineDocumentsChain] = None+ collapse_documents_chain: BaseCombineDocumentsChain | None = None"""Chain to use to collapse documents if needed until they can all fit.If None, will use the combine_documents_chain.This is typically a StuffDocumentsChain."""@@ -212,7 +213,7 @@ class ReduceDocumentsChain(BaseCombineDocumentsChain):"""The maximum number of tokens to group documents into. For example, ifset to 3000 then documents will be grouped into chunks of no greater than3000 tokens before trying to combine them into a smaller chunk."""- collapse_max_retries: Optional[int] = None+ collapse_max_retries: int | None = None"""The maximum number of retries to collapse documents to fit token_max.If None, it will keep trying to collapse documents to fit token_max.Otherwise, after it reaches the max number, it will throw an error"""@@ -231,7 +232,7 @@ class ReduceDocumentsChain(BaseCombineDocumentsChain):def combine_docs(self,docs: list[Document],- token_max: Optional[int] = None,+ token_max: int | None = None,callbacks: Callbacks = None,**kwargs: Any,) -> tuple[str, dict]:@@ -265,7 +266,7 @@ class ReduceDocumentsChain(BaseCombineDocumentsChain):async def acombine_docs(self,docs: list[Document],- token_max: Optional[int] = None,+ token_max: int | None = None,callbacks: Callbacks = None,**kwargs: Any,) -> tuple[str, dict]:@@ -299,7 +300,7 @@ class ReduceDocumentsChain(BaseCombineDocumentsChain):def _collapse(self,docs: list[Document],- token_max: Optional[int] = None,+ token_max: int | None = None,callbacks: Callbacks = None,**kwargs: Any,) -> tuple[list[Document], dict]:@@ -338,7 +339,7 @@ class ReduceDocumentsChain(BaseCombineDocumentsChain):async def _acollapse(self,docs: list[Document],- token_max: Optional[int] = None,+ token_max: int | None = None,callbacks: Callbacks = None,**kwargs: Any,) -> tuple[list[Document], dict]:diff --git a/libs/langchain/langchain_classic/chains/combine_documents/stuff.py b/libs/langchain/langchain_classic/chains/combine_documents/stuff.pyindex 89e0a4fb50..8900c8b0ff 100644--- a/libs/langchain/langchain_classic/chains/combine_documents/stuff.py+++ b/libs/langchain/langchain_classic/chains/combine_documents/stuff.py@@ -1,6 +1,6 @@"""Chain that combines documents by stuffing into context."""-from typing import Any, Optional+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.callbacks import Callbacks@@ -26,8 +26,8 @@ def create_stuff_documents_chain(llm: LanguageModelLike,prompt: BasePromptTemplate,*,- output_parser: Optional[BaseOutputParser] = None,- document_prompt: Optional[BasePromptTemplate] = None,+ output_parser: BaseOutputParser | None = None,+ document_prompt: BasePromptTemplate | None = None,document_separator: str = DEFAULT_DOCUMENT_SEPARATOR,document_variable_name: str = DOCUMENTS_KEY,) -> Runnable[dict[str, Any], Any]:@@ -226,7 +226,7 @@ class StuffDocumentsChain(BaseCombineDocumentsChain):inputs[self.document_variable_name] = self.document_separator.join(doc_strings)return inputs- def prompt_length(self, docs: list[Document], **kwargs: Any) -> Optional[int]:+ def prompt_length(self, docs: list[Document], **kwargs: Any) -> int | None:"""Return the prompt length given the documents passed in.This can be used by a caller to determine whether passing in a listdiff --git a/libs/langchain/langchain_classic/chains/constitutional_ai/base.py b/libs/langchain/langchain_classic/chains/constitutional_ai/base.pyindex 2b0ddf76c4..f6d534a1d7 100644--- a/libs/langchain/langchain_classic/chains/constitutional_ai/base.py+++ b/libs/langchain/langchain_classic/chains/constitutional_ai/base.py@@ -1,6 +1,6 @@"""Chain for applying constitutional principles to the outputs of another chain."""-from typing import Any, Optional+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.callbacks import CallbackManagerForChainRun@@ -203,7 +203,7 @@ class ConstitutionalChain(Chain):@classmethoddef get_principles(cls,- names: Optional[list[str]] = None,+ names: list[str] | None = None,) -> list[ConstitutionalPrinciple]:"""Get constitutional principles by name.@@ -249,7 +249,7 @@ class ConstitutionalChain(Chain):def _call(self,inputs: dict[str, Any],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, Any]:_run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()response = self.chain.run(diff --git a/libs/langchain/langchain_classic/chains/conversational_retrieval/base.py b/libs/langchain/langchain_classic/chains/conversational_retrieval/base.pyindex 9678749c4b..7d7d8692ef 100644--- a/libs/langchain/langchain_classic/chains/conversational_retrieval/base.py+++ b/libs/langchain/langchain_classic/chains/conversational_retrieval/base.py@@ -5,8 +5,9 @@ from __future__ import annotationsimport inspectimport warningsfrom abc import abstractmethod+from collections.abc import Callablefrom pathlib import Path-from typing import Any, Callable, Optional, Union+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.callbacks import (@@ -35,7 +36,7 @@ from langchain_classic.chains.question_answering import load_qa_chain# Depending on the memory type and configuration, the chat history format may differ.# This needs to be consolidated.-CHAT_TURN_TYPE = Union[tuple[str, str], BaseMessage]+CHAT_TURN_TYPE = tuple[str, str] | BaseMessage_ROLE_MAP = {"human": "Human: ", "ai": "Assistant: "}@@ -94,10 +95,10 @@ class BaseConversationalRetrievalChain(Chain):"""Return the retrieved source documents as part of the final result."""return_generated_question: bool = False"""Return the generated question as part of the final result."""- get_chat_history: Optional[Callable[[list[CHAT_TURN_TYPE]], str]] = None+ get_chat_history: Callable[[list[CHAT_TURN_TYPE]], str] | None = None"""An optional function to get a string of the chat history.If None is provided, will use a default."""- response_if_no_docs_found: Optional[str] = None+ response_if_no_docs_found: str | None = None"""If specified, the chain will return a fixed response if no docsare found for the question. """@@ -115,7 +116,7 @@ class BaseConversationalRetrievalChain(Chain):@overridedef get_input_schema(self,- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,) -> type[BaseModel]:return InputType@@ -145,7 +146,7 @@ class BaseConversationalRetrievalChain(Chain):def _call(self,inputs: dict[str, Any],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, Any]:_run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()question = inputs["question"]@@ -202,7 +203,7 @@ class BaseConversationalRetrievalChain(Chain):async def _acall(self,inputs: dict[str, Any],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, Any]:_run_manager = run_manager or AsyncCallbackManagerForChainRun.get_noop_manager()question = inputs["question"]@@ -247,7 +248,7 @@ class BaseConversationalRetrievalChain(Chain):return output@override- def save(self, file_path: Union[Path, str]) -> None:+ def save(self, file_path: Path | str) -> None:if self.get_chat_history:msg = "Chain not saveable when `get_chat_history` is not None."raise ValueError(msg)@@ -385,7 +386,7 @@ class ConversationalRetrievalChain(BaseConversationalRetrievalChain):retriever: BaseRetriever"""Retriever to use to fetch documents."""- max_tokens_limit: Optional[int] = None+ max_tokens_limit: int | None = None"""If set, enforces that the documents returned are less than this limit.This is only enforced if ``combine_docs_chain`` is of type StuffDocumentsChain.@@ -447,8 +448,8 @@ class ConversationalRetrievalChain(BaseConversationalRetrievalChain):condense_question_prompt: BasePromptTemplate = CONDENSE_QUESTION_PROMPT,chain_type: str = "stuff",verbose: bool = False, # noqa: FBT001,FBT002- condense_question_llm: Optional[BaseLanguageModel] = None,- combine_docs_chain_kwargs: Optional[dict] = None,+ condense_question_llm: BaseLanguageModel | None = None,+ combine_docs_chain_kwargs: dict | None = None,callbacks: Callbacks = None,**kwargs: Any,) -> BaseConversationalRetrievalChain:@@ -557,7 +558,7 @@ class ChatVectorDBChain(BaseConversationalRetrievalChain):vectorstore: VectorStore,condense_question_prompt: BasePromptTemplate = CONDENSE_QUESTION_PROMPT,chain_type: str = "stuff",- combine_docs_chain_kwargs: Optional[dict] = None,+ combine_docs_chain_kwargs: dict | None = None,callbacks: Callbacks = None,**kwargs: Any,) -> BaseConversationalRetrievalChain:diff --git a/libs/langchain/langchain_classic/chains/elasticsearch_database/base.py b/libs/langchain/langchain_classic/chains/elasticsearch_database/base.pyindex 8244624257..70b681e1ee 100644--- a/libs/langchain/langchain_classic/chains/elasticsearch_database/base.py+++ b/libs/langchain/langchain_classic/chains/elasticsearch_database/base.py@@ -2,7 +2,7 @@from __future__ import annotations-from typing import TYPE_CHECKING, Any, Optional+from typing import TYPE_CHECKING, Anyfrom langchain_core.callbacks import CallbackManagerForChainRunfrom langchain_core.language_models import BaseLanguageModel@@ -48,8 +48,8 @@ class ElasticsearchDatabaseChain(Chain):"""Elasticsearch database to connect to of type elasticsearch.Elasticsearch."""top_k: int = 10"""Number of results to return from the query"""- ignore_indices: Optional[list[str]] = None- include_indices: Optional[list[str]] = None+ ignore_indices: list[str] | None = None+ include_indices: list[str] | None = Noneinput_key: str = "question" #: :meta private:output_key: str = "result" #: :meta private:sample_documents_in_index_info: int = 3@@ -123,7 +123,7 @@ class ElasticsearchDatabaseChain(Chain):def _call(self,inputs: dict[str, Any],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, Any]:_run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()input_text = f"{inputs[self.input_key]}\nESQuery:"@@ -186,9 +186,9 @@ class ElasticsearchDatabaseChain(Chain):llm: BaseLanguageModel,database: Elasticsearch,*,- query_prompt: Optional[BasePromptTemplate] = None,- answer_prompt: Optional[BasePromptTemplate] = None,- query_output_parser: Optional[BaseOutputParser] = None,+ query_prompt: BasePromptTemplate | None = None,+ answer_prompt: BasePromptTemplate | None = None,+ query_output_parser: BaseOutputParser | None = None,**kwargs: Any,) -> ElasticsearchDatabaseChain:"""Convenience method to construct ElasticsearchDatabaseChain from an LLM.diff --git a/libs/langchain/langchain_classic/chains/flare/base.py b/libs/langchain/langchain_classic/chains/flare/base.pyindex 9831ee72c4..9be627a631 100644--- a/libs/langchain/langchain_classic/chains/flare/base.py+++ b/libs/langchain/langchain_classic/chains/flare/base.py@@ -3,7 +3,7 @@ from __future__ import annotationsimport loggingimport refrom collections.abc import Sequence-from typing import Any, Optional+from typing import Anyfrom langchain_core.callbacks import (CallbackManagerForChainRun,@@ -198,7 +198,7 @@ class FlareChain(Chain):def _call(self,inputs: dict[str, Any],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, Any]:_run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()@@ -249,7 +249,7 @@ class FlareChain(Chain):@classmethoddef from_llm(cls,- llm: Optional[BaseLanguageModel],+ llm: BaseLanguageModel | None,max_generation_len: int = 32,**kwargs: Any,) -> FlareChain:diff --git a/libs/langchain/langchain_classic/chains/hyde/base.py b/libs/langchain/langchain_classic/chains/hyde/base.pyindex c5180971e2..7ee9780b4a 100644--- a/libs/langchain/langchain_classic/chains/hyde/base.py+++ b/libs/langchain/langchain_classic/chains/hyde/base.py@@ -6,7 +6,7 @@ https://arxiv.org/abs/2212.10496from __future__ import annotationsimport logging-from typing import Any, Optional+from typing import Anyfrom langchain_core.callbacks import CallbackManagerForChainRunfrom langchain_core.embeddings import Embeddings@@ -70,7 +70,10 @@ class HypotheticalDocumentEmbedder(Chain, Embeddings):if not embeddings:return []num_vectors = len(embeddings)- return [sum(dim_values) / num_vectors for dim_values in zip(*embeddings)]+ return [+ sum(dim_values) / num_vectors+ for dim_values in zip(*embeddings, strict=False)+ ]def embed_query(self, text: str) -> list[float]:"""Generate a hypothetical document and embedded it."""@@ -86,7 +89,7 @@ class HypotheticalDocumentEmbedder(Chain, Embeddings):def _call(self,inputs: dict[str, Any],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, str]:"""Call the internal llm chain."""_run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()@@ -100,8 +103,8 @@ class HypotheticalDocumentEmbedder(Chain, Embeddings):cls,llm: BaseLanguageModel,base_embeddings: Embeddings,- prompt_key: Optional[str] = None,- custom_prompt: Optional[BasePromptTemplate] = None,+ prompt_key: str | None = None,+ custom_prompt: BasePromptTemplate | None = None,**kwargs: Any,) -> HypotheticalDocumentEmbedder:"""Load and use LLMChain with either a specific prompt key or custom prompt."""diff --git a/libs/langchain/langchain_classic/chains/llm.py b/libs/langchain/langchain_classic/chains/llm.pyindex 0018da8169..5e792501cb 100644--- a/libs/langchain/langchain_classic/chains/llm.py+++ b/libs/langchain/langchain_classic/chains/llm.py@@ -4,7 +4,7 @@ from __future__ import annotationsimport warningsfrom collections.abc import Sequence-from typing import Any, Optional, Union, cast+from typing import Any, castfrom langchain_core._api import deprecatedfrom langchain_core.callbacks import (@@ -85,10 +85,7 @@ class LLMChain(Chain):prompt: BasePromptTemplate"""Prompt object to use."""- llm: Union[- Runnable[LanguageModelInput, str],- Runnable[LanguageModelInput, BaseMessage],- ]+ llm: Runnable[LanguageModelInput, str] | Runnable[LanguageModelInput, BaseMessage]"""Language model to call."""output_key: str = "text" #: :meta private:output_parser: BaseLLMOutputParser = Field(default_factory=StrOutputParser)@@ -126,7 +123,7 @@ class LLMChain(Chain):def _call(self,inputs: dict[str, Any],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, str]:response = self.generate([inputs], run_manager=run_manager)return self.create_outputs(response)[0]@@ -134,7 +131,7 @@ class LLMChain(Chain):def generate(self,input_list: list[dict[str, Any]],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> LLMResult:"""Generate LLM result from inputs."""prompts, stop = self.prep_prompts(input_list, run_manager=run_manager)@@ -161,7 +158,7 @@ class LLMChain(Chain):async def agenerate(self,input_list: list[dict[str, Any]],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> LLMResult:"""Generate LLM result from inputs."""prompts, stop = await self.aprep_prompts(input_list, run_manager=run_manager)@@ -188,8 +185,8 @@ class LLMChain(Chain):def prep_prompts(self,input_list: list[dict[str, Any]],- run_manager: Optional[CallbackManagerForChainRun] = None,- ) -> tuple[list[PromptValue], Optional[list[str]]]:+ run_manager: CallbackManagerForChainRun | None = None,+ ) -> tuple[list[PromptValue], list[str] | None]:"""Prepare prompts from inputs."""stop = Noneif len(input_list) == 0:@@ -213,8 +210,8 @@ class LLMChain(Chain):async def aprep_prompts(self,input_list: list[dict[str, Any]],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,- ) -> tuple[list[PromptValue], Optional[list[str]]]:+ run_manager: AsyncCallbackManagerForChainRun | None = None,+ ) -> tuple[list[PromptValue], list[str] | None]:"""Prepare prompts from inputs."""stop = Noneif len(input_list) == 0:@@ -306,7 +303,7 @@ class LLMChain(Chain):async def _acall(self,inputs: dict[str, Any],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, str]:response = await self.agenerate([inputs], run_manager=run_manager)return self.create_outputs(response)[0]@@ -351,7 +348,7 @@ class LLMChain(Chain):self,callbacks: Callbacks = None,**kwargs: Any,- ) -> Union[str, list[str], dict[str, Any]]:+ ) -> str | list[str] | dict[str, Any]:"""Call predict and then parse the results."""warnings.warn("The predict_and_parse method is deprecated, "@@ -367,7 +364,7 @@ class LLMChain(Chain):self,callbacks: Callbacks = None,**kwargs: Any,- ) -> Union[str, list[str], dict[str, str]]:+ ) -> str | list[str] | dict[str, str]:"""Call apredict and then parse the results."""warnings.warn("The apredict_and_parse method is deprecated, "@@ -383,7 +380,7 @@ class LLMChain(Chain):self,input_list: list[dict[str, Any]],callbacks: Callbacks = None,- ) -> Sequence[Union[str, list[str], dict[str, str]]]:+ ) -> Sequence[str | list[str] | dict[str, str]]:"""Call apply and then parse the results."""warnings.warn("The apply_and_parse method is deprecated, "@@ -396,7 +393,7 @@ class LLMChain(Chain):def _parse_generation(self,generation: list[dict[str, str]],- ) -> Sequence[Union[str, list[str], dict[str, str]]]:+ ) -> Sequence[str | list[str] | dict[str, str]]:if self.prompt.output_parser is not None:return [self.prompt.output_parser.parse(res[self.output_key])@@ -408,7 +405,7 @@ class LLMChain(Chain):self,input_list: list[dict[str, Any]],callbacks: Callbacks = None,- ) -> Sequence[Union[str, list[str], dict[str, str]]]:+ ) -> Sequence[str | list[str] | dict[str, str]]:"""Call apply and then parse the results."""warnings.warn("The aapply_and_parse method is deprecated, "diff --git a/libs/langchain/langchain_classic/chains/llm_checker/base.py b/libs/langchain/langchain_classic/chains/llm_checker/base.pyindex 7b97df06f6..39e1b92d74 100644--- a/libs/langchain/langchain_classic/chains/llm_checker/base.py+++ b/libs/langchain/langchain_classic/chains/llm_checker/base.py@@ -3,7 +3,7 @@from __future__ import annotationsimport warnings-from typing import Any, Optional+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.callbacks import CallbackManagerForChainRun@@ -88,7 +88,7 @@ class LLMCheckerChain(Chain):question_to_checked_assertions_chain: SequentialChain- llm: Optional[BaseLanguageModel] = None+ llm: BaseLanguageModel | None = None"""[Deprecated] LLM wrapper to use."""create_draft_answer_prompt: PromptTemplate = CREATE_DRAFT_ANSWER_PROMPT"""[Deprecated]"""@@ -156,7 +156,7 @@ class LLMCheckerChain(Chain):def _call(self,inputs: dict[str, Any],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, str]:_run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()question = inputs[self.input_key]diff --git a/libs/langchain/langchain_classic/chains/llm_math/base.py b/libs/langchain/langchain_classic/chains/llm_math/base.pyindex 27a467c045..7d262b69d5 100644--- a/libs/langchain/langchain_classic/chains/llm_math/base.py+++ b/libs/langchain/langchain_classic/chains/llm_math/base.py@@ -5,7 +5,7 @@ from __future__ import annotationsimport mathimport reimport warnings-from typing import Any, Optional+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.callbacks import (@@ -153,7 +153,7 @@ class LLMMathChain(Chain):""" # noqa: E501llm_chain: LLMChain- llm: Optional[BaseLanguageModel] = None+ llm: BaseLanguageModel | None = None"""[Deprecated] LLM wrapper to use."""prompt: BasePromptTemplate = PROMPT"""[Deprecated] Prompt to use to translate to python if necessary."""@@ -275,7 +275,7 @@ class LLMMathChain(Chain):def _call(self,inputs: dict[str, str],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, str]:_run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()_run_manager.on_text(inputs[self.input_key])@@ -289,7 +289,7 @@ class LLMMathChain(Chain):async def _acall(self,inputs: dict[str, str],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, str]:_run_manager = run_manager or AsyncCallbackManagerForChainRun.get_noop_manager()await _run_manager.on_text(inputs[self.input_key])diff --git a/libs/langchain/langchain_classic/chains/llm_summarization_checker/base.py b/libs/langchain/langchain_classic/chains/llm_summarization_checker/base.pyindex 055b17eeb1..fabf4603bc 100644--- a/libs/langchain/langchain_classic/chains/llm_summarization_checker/base.py+++ b/libs/langchain/langchain_classic/chains/llm_summarization_checker/base.py@@ -4,7 +4,7 @@ from __future__ import annotationsimport warningsfrom pathlib import Path-from typing import Any, Optional+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.callbacks import CallbackManagerForChainRun@@ -90,7 +90,7 @@ class LLMSummarizationCheckerChain(Chain):"""sequential_chain: SequentialChain- llm: Optional[BaseLanguageModel] = None+ llm: BaseLanguageModel | None = None"""[Deprecated] LLM wrapper to use."""create_assertions_prompt: PromptTemplate = CREATE_ASSERTIONS_PROMPT@@ -152,7 +152,7 @@ class LLMSummarizationCheckerChain(Chain):def _call(self,inputs: dict[str, Any],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, str]:_run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()all_true = Falsediff --git a/libs/langchain/langchain_classic/chains/loading.py b/libs/langchain/langchain_classic/chains/loading.pyindex 1c4959a138..bb926081cf 100644--- a/libs/langchain/langchain_classic/chains/loading.py+++ b/libs/langchain/langchain_classic/chains/loading.py@@ -4,7 +4,7 @@ from __future__ import annotationsimport jsonfrom pathlib import Path-from typing import TYPE_CHECKING, Any, Union+from typing import TYPE_CHECKING, Anyimport yamlfrom langchain_core._api import deprecated@@ -705,7 +705,7 @@ def load_chain_from_config(config: dict, **kwargs: Any) -> Chain:),removal="1.0",)-def load_chain(path: Union[str, Path], **kwargs: Any) -> Chain:+def load_chain(path: str | Path, **kwargs: Any) -> Chain:"""Unified method for loading a chain from LangChainHub or local fs."""if isinstance(path, str) and path.startswith("lc://"):msg = (@@ -717,7 +717,7 @@ def load_chain(path: Union[str, Path], **kwargs: Any) -> Chain:return _load_chain_from_file(path, **kwargs)-def _load_chain_from_file(file: Union[str, Path], **kwargs: Any) -> Chain:+def _load_chain_from_file(file: str | Path, **kwargs: Any) -> Chain:"""Load chain from file."""# Convert file to Path object.file_path = Path(file) if isinstance(file, str) else filediff --git a/libs/langchain/langchain_classic/chains/mapreduce.py b/libs/langchain/langchain_classic/chains/mapreduce.pyindex ed24a84fbc..81dc973190 100644--- a/libs/langchain/langchain_classic/chains/mapreduce.py+++ b/libs/langchain/langchain_classic/chains/mapreduce.py@@ -7,7 +7,7 @@ then combines the results with another one.from __future__ import annotationsfrom collections.abc import Mapping-from typing import Any, Optional+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.callbacks import CallbackManagerForChainRun, Callbacks@@ -54,8 +54,8 @@ class MapReduceChain(Chain):prompt: BasePromptTemplate,text_splitter: TextSplitter,callbacks: Callbacks = None,- combine_chain_kwargs: Optional[Mapping[str, Any]] = None,- reduce_chain_kwargs: Optional[Mapping[str, Any]] = None,+ combine_chain_kwargs: Mapping[str, Any] | None = None,+ reduce_chain_kwargs: Mapping[str, Any] | None = None,**kwargs: Any,) -> MapReduceChain:"""Construct a map-reduce chain that uses the chain for map and reduce."""@@ -105,7 +105,7 @@ class MapReduceChain(Chain):def _call(self,inputs: dict[str, str],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, str]:_run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()# Split the larger text into smaller chunks.diff --git a/libs/langchain/langchain_classic/chains/moderation.py b/libs/langchain/langchain_classic/chains/moderation.pyindex 50102dcd61..f009ac6c90 100644--- a/libs/langchain/langchain_classic/chains/moderation.py+++ b/libs/langchain/langchain_classic/chains/moderation.py@@ -1,6 +1,6 @@"""Pass input through a moderation endpoint."""-from typing import Any, Optional+from typing import Anyfrom langchain_core.callbacks import (AsyncCallbackManagerForChainRun,@@ -33,14 +33,14 @@ class OpenAIModerationChain(Chain):client: Any = None #: :meta private:async_client: Any = None #: :meta private:- model_name: Optional[str] = None+ model_name: str | None = None"""Moderation model name to use."""error: bool = False"""Whether or not to error if bad content was found."""input_key: str = "input" #: :meta private:output_key: str = "output" #: :meta private:- openai_api_key: Optional[str] = None- openai_organization: Optional[str] = None+ openai_api_key: str | None = None+ openai_organization: str | None = Noneopenai_pre_1_0: bool = Field(default=False)@model_validator(mode="before")@@ -112,7 +112,7 @@ class OpenAIModerationChain(Chain):def _call(self,inputs: dict[str, Any],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, Any]:text = inputs[self.input_key]if self.openai_pre_1_0:@@ -126,7 +126,7 @@ class OpenAIModerationChain(Chain):async def _acall(self,inputs: dict[str, Any],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, Any]:if self.openai_pre_1_0:return await super()._acall(inputs, run_manager=run_manager)diff --git a/libs/langchain/langchain_classic/chains/natbot/base.py b/libs/langchain/langchain_classic/chains/natbot/base.pyindex 5babc55e15..45b63fbcc2 100644--- a/libs/langchain/langchain_classic/chains/natbot/base.py+++ b/libs/langchain/langchain_classic/chains/natbot/base.py@@ -3,7 +3,7 @@from __future__ import annotationsimport warnings-from typing import Any, Optional+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.callbacks import CallbackManagerForChainRun@@ -54,7 +54,7 @@ class NatBotChain(Chain):llm_chain: Runnableobjective: str"""Objective that NatBot is tasked with completing."""- llm: Optional[BaseLanguageModel] = None+ llm: BaseLanguageModel | None = None"""[Deprecated] LLM wrapper to use."""input_url_key: str = "url" #: :meta private:input_browser_content_key: str = "browser_content" #: :meta private:@@ -120,7 +120,7 @@ class NatBotChain(Chain):def _call(self,inputs: dict[str, str],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, str]:_run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()url = inputs[self.input_url_key]diff --git a/libs/langchain/langchain_classic/chains/natbot/crawler.py b/libs/langchain/langchain_classic/chains/natbot/crawler.pyindex d9c76ed918..692d90fad3 100644--- a/libs/langchain/langchain_classic/chains/natbot/crawler.py+++ b/libs/langchain/langchain_classic/chains/natbot/crawler.py@@ -4,9 +4,7 @@ from sys import platformfrom typing import (TYPE_CHECKING,Any,- Optional,TypedDict,- Union,)if TYPE_CHECKING:@@ -35,8 +33,8 @@ class ElementInViewPort(TypedDict):node_index: strbackend_node_id: int- node_name: Optional[str]- node_value: Optional[str]+ node_name: str | None+ node_value: str | Nonenode_meta: list[str]is_clickable: boolorigin_x: int@@ -111,7 +109,7 @@ class Crawler:"window.innerHeight;")- def click(self, id_: Union[str, int]) -> None:+ def click(self, id_: str | int) -> None:"""Click on an element with the given id.Args:@@ -135,7 +133,7 @@ class Crawler:else:print("Could not find element") # noqa: T201- def type(self, id_: Union[str, int], text: str) -> None:+ def type(self, id_: str | int, text: str) -> None:"""Type text into an element with the given id.Args:@@ -215,12 +213,12 @@ class Crawler:child_nodes: dict[str, list[dict[str, Any]]] = {}elements_in_view_port: list[ElementInViewPort] = []- anchor_ancestry: dict[str, tuple[bool, Optional[int]]] = {"-1": (False, None)}- button_ancestry: dict[str, tuple[bool, Optional[int]]] = {"-1": (False, None)}+ anchor_ancestry: dict[str, tuple[bool, int | None]] = {"-1": (False, None)}+ button_ancestry: dict[str, tuple[bool, int | None]] = {"-1": (False, None)}def convert_name(- node_name: Optional[str],- has_click_handler: Optional[bool], # noqa: FBT001+ node_name: str | None,+ has_click_handler: bool | None, # noqa: FBT001) -> str:if node_name == "a":return "link"@@ -239,7 +237,7 @@ class Crawler:) -> dict[str, str]:values = {}- for [key_index, value_index] in zip(*(iter(attributes),) * 2):+ for [key_index, value_index] in zip(*(iter(attributes),) * 2, strict=False):if value_index < 0:continuekey = strings[key_index]@@ -255,12 +253,12 @@ class Crawler:return valuesdef add_to_hash_tree(- hash_tree: dict[str, tuple[bool, Optional[int]]],+ hash_tree: dict[str, tuple[bool, int | None]],tag: str,node_id: int,- node_name: Optional[str],+ node_name: str | None,parent_id: int,- ) -> tuple[bool, Optional[int]]:+ ) -> tuple[bool, int | None]:parent_id_str = str(parent_id)if parent_id_str not in hash_tree:parent_name = strings[node_names[parent_id]].lower()@@ -275,7 +273,7 @@ class Crawler:# even if the anchor is nested in another anchor, we set the "root" for all# descendants to be ::Selfif node_name == tag:- value: tuple[bool, Optional[int]] = (True, node_id)+ value: tuple[bool, int | None] = (True, node_id)elif (is_parent_desc_anchor): # reuse the parent's anchor_id (which could be much higher in the tree)@@ -294,7 +292,7 @@ class Crawler:for index, node_name_index in enumerate(node_names):node_parent = parent[index]- node_name: Optional[str] = strings[node_name_index].lower()+ node_name: str | None = strings[node_name_index].lower()is_ancestor_of_anchor, anchor_id = add_to_hash_tree(anchor_ancestry, "a", index, node_name, node_parent@@ -432,7 +430,7 @@ class Crawler:node_name = element.get("node_name")element_node_value = element.get("node_value")node_is_clickable = element.get("is_clickable")- node_meta_data: Optional[list[str]] = element.get("node_meta")+ node_meta_data: list[str] | None = element.get("node_meta")inner_text = f"{element_node_value} " if element_node_value else ""meta = ""diff --git a/libs/langchain/langchain_classic/chains/openai_functions/base.py b/libs/langchain/langchain_classic/chains/openai_functions/base.pyindex 1b8bd6973f..0a4586f91b 100644--- a/libs/langchain/langchain_classic/chains/openai_functions/base.py+++ b/libs/langchain/langchain_classic/chains/openai_functions/base.py@@ -1,11 +1,8 @@"""Methods for creating chains that use OpenAI function-calling APIs."""-from collections.abc import Sequence+from collections.abc import Callable, Sequencefrom typing import (Any,- Callable,- Optional,- Union,)from langchain_core._api import deprecated@@ -43,13 +40,13 @@ __all__ = [@deprecated(since="0.1.1", removal="1.0", alternative="create_openai_fn_runnable")def create_openai_fn_chain(- functions: Sequence[Union[dict[str, Any], type[BaseModel], Callable]],+ functions: Sequence[dict[str, Any] | type[BaseModel] | Callable],llm: BaseLanguageModel,prompt: BasePromptTemplate,*,enforce_single_function_usage: bool = True,output_key: str = "function",- output_parser: Optional[BaseLLMOutputParser] = None,+ output_parser: BaseLLMOutputParser | None = None,**kwargs: Any,) -> LLMChain:"""[Legacy] Create an LLM chain that uses OpenAI functions.@@ -150,12 +147,12 @@ def create_openai_fn_chain(alternative="ChatOpenAI.with_structured_output",)def create_structured_output_chain(- output_schema: Union[dict[str, Any], type[BaseModel]],+ output_schema: dict[str, Any] | type[BaseModel],llm: BaseLanguageModel,prompt: BasePromptTemplate,*,output_key: str = "function",- output_parser: Optional[BaseLLMOutputParser] = None,+ output_parser: BaseLLMOutputParser | None = None,**kwargs: Any,) -> LLMChain:"""[Legacy] Create an LLMChain that uses an OpenAI function to get a structured output.diff --git a/libs/langchain/langchain_classic/chains/openai_functions/extraction.py b/libs/langchain/langchain_classic/chains/openai_functions/extraction.pyindex ff383cf396..1230bc769f 100644--- a/libs/langchain/langchain_classic/chains/openai_functions/extraction.py+++ b/libs/langchain/langchain_classic/chains/openai_functions/extraction.py@@ -1,4 +1,4 @@-from typing import Any, Optional+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.language_models import BaseLanguageModel@@ -82,8 +82,8 @@ Passage:def create_extraction_chain(schema: dict,llm: BaseLanguageModel,- prompt: Optional[BasePromptTemplate] = None,- tags: Optional[list[str]] = None,+ prompt: BasePromptTemplate | None = None,+ tags: list[str] | None = None,verbose: bool = False, # noqa: FBT001,FBT002) -> Chain:"""Creates a chain that extracts information from a passage.@@ -152,7 +152,7 @@ def create_extraction_chain(def create_extraction_chain_pydantic(pydantic_schema: Any,llm: BaseLanguageModel,- prompt: Optional[BasePromptTemplate] = None,+ prompt: BasePromptTemplate | None = None,verbose: bool = False, # noqa: FBT001,FBT002) -> Chain:"""Creates a chain that extracts information from a passage using pydantic schema.diff --git a/libs/langchain/langchain_classic/chains/openai_functions/openapi.py b/libs/langchain/langchain_classic/chains/openai_functions/openapi.pyindex 41a912949d..7c1e065dbb 100644--- a/libs/langchain/langchain_classic/chains/openai_functions/openapi.py+++ b/libs/langchain/langchain_classic/chains/openai_functions/openapi.py@@ -4,7 +4,8 @@ import jsonimport loggingimport refrom collections import defaultdict-from typing import TYPE_CHECKING, Any, Callable, Optional, Union+from collections.abc import Callable+from typing import TYPE_CHECKING, Anyimport requestsfrom langchain_core._api import deprecated@@ -170,9 +171,9 @@ def openapi_spec_to_openai_fn(def default_call_api(name: str,fn_args: dict,- headers: Optional[dict] = None,- params: Optional[dict] = None,- timeout: Optional[int] = 30,+ headers: dict | None = None,+ params: dict | None = None,+ timeout: int | None = 30,**kwargs: Any,) -> Any:method = _name_to_call_map[name]["method"]@@ -220,7 +221,7 @@ class SimpleRequestChain(Chain):def _call(self,inputs: dict[str, Any],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, Any]:"""Run the logic of this chain and return the output."""_run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()@@ -258,14 +259,14 @@ class SimpleRequestChain(Chain):removal="1.0",)def get_openapi_chain(- spec: Union[OpenAPISpec, str],- llm: Optional[BaseLanguageModel] = None,- prompt: Optional[BasePromptTemplate] = None,- request_chain: Optional[Chain] = None,- llm_chain_kwargs: Optional[dict] = None,+ spec: OpenAPISpec | str,+ llm: BaseLanguageModel | None = None,+ prompt: BasePromptTemplate | None = None,+ request_chain: Chain | None = None,+ llm_chain_kwargs: dict | None = None,verbose: bool = False, # noqa: FBT001,FBT002- headers: Optional[dict] = None,- params: Optional[dict] = None,+ headers: dict | None = None,+ params: dict | None = None,**kwargs: Any,) -> SequentialChain:r"""Create a chain for querying an API from a OpenAPI spec.diff --git a/libs/langchain/langchain_classic/chains/openai_functions/qa_with_structure.py b/libs/langchain/langchain_classic/chains/openai_functions/qa_with_structure.pyindex f7171f7022..8e7bede26c 100644--- a/libs/langchain/langchain_classic/chains/openai_functions/qa_with_structure.py+++ b/libs/langchain/langchain_classic/chains/openai_functions/qa_with_structure.py@@ -1,4 +1,4 @@-from typing import Any, Optional, Union, cast+from typing import Any, castfrom langchain_core._api import deprecatedfrom langchain_core.language_models import BaseLanguageModel@@ -38,9 +38,9 @@ class AnswerWithSources(BaseModel):)def create_qa_with_structure_chain(llm: BaseLanguageModel,- schema: Union[dict, type[BaseModel]],+ schema: dict | type[BaseModel],output_parser: str = "base",- prompt: Optional[Union[PromptTemplate, ChatPromptTemplate]] = None,+ prompt: PromptTemplate | ChatPromptTemplate | None = None,verbose: bool = False, # noqa: FBT001,FBT002) -> LLMChain:"""Create a question answering chain with structure.diff --git a/libs/langchain/langchain_classic/chains/openai_functions/tagging.py b/libs/langchain/langchain_classic/chains/openai_functions/tagging.pyindex a160df031e..3b3dbf6788 100644--- a/libs/langchain/langchain_classic/chains/openai_functions/tagging.py+++ b/libs/langchain/langchain_classic/chains/openai_functions/tagging.py@@ -1,4 +1,4 @@-from typing import Any, Optional+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.language_models import BaseLanguageModel@@ -51,7 +51,7 @@ Passage:def create_tagging_chain(schema: dict,llm: BaseLanguageModel,- prompt: Optional[ChatPromptTemplate] = None,+ prompt: ChatPromptTemplate | None = None,**kwargs: Any,) -> Chain:"""Create tagging chain from schema.@@ -126,7 +126,7 @@ def create_tagging_chain(def create_tagging_chain_pydantic(pydantic_schema: Any,llm: BaseLanguageModel,- prompt: Optional[ChatPromptTemplate] = None,+ prompt: ChatPromptTemplate | None = None,**kwargs: Any,) -> Chain:"""Create tagging chain from pydantic schema.diff --git a/libs/langchain/langchain_classic/chains/openai_tools/extraction.py b/libs/langchain/langchain_classic/chains/openai_tools/extraction.pyindex 8aa4d0cb1e..36c5729cdb 100644--- a/libs/langchain/langchain_classic/chains/openai_tools/extraction.py+++ b/libs/langchain/langchain_classic/chains/openai_tools/extraction.py@@ -1,5 +1,3 @@-from typing import Union-from langchain_core._api import deprecatedfrom langchain_core.language_models import BaseLanguageModelfrom langchain_core.output_parsers.openai_tools import PydanticToolsParser@@ -51,7 +49,7 @@ If a property is not present and is not required in the function parameters, do),)def create_extraction_chain_pydantic(- pydantic_schemas: Union[list[type[BaseModel]], type[BaseModel]],+ pydantic_schemas: list[type[BaseModel]] | type[BaseModel],llm: BaseLanguageModel,system_message: str = _EXTRACTION_TEMPLATE,) -> Runnable:diff --git a/libs/langchain/langchain_classic/chains/prompt_selector.py b/libs/langchain/langchain_classic/chains/prompt_selector.pyindex adc1ddce9b..bb8665b9fc 100644--- a/libs/langchain/langchain_classic/chains/prompt_selector.py+++ b/libs/langchain/langchain_classic/chains/prompt_selector.py@@ -1,5 +1,5 @@from abc import ABC, abstractmethod-from typing import Callable+from collections.abc import Callablefrom langchain_core.language_models import BaseLanguageModelfrom langchain_core.language_models.chat_models import BaseChatModeldiff --git a/libs/langchain/langchain_classic/chains/qa_generation/base.py b/libs/langchain/langchain_classic/chains/qa_generation/base.pyindex a419818e26..365ab96452 100644--- a/libs/langchain/langchain_classic/chains/qa_generation/base.py+++ b/libs/langchain/langchain_classic/chains/qa_generation/base.py@@ -1,7 +1,7 @@from __future__ import annotationsimport json-from typing import Any, Optional+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.callbacks import CallbackManagerForChainRun@@ -76,14 +76,14 @@ class QAGenerationChain(Chain):"""Key of the input to the chain."""output_key: str = "questions""""Key of the output of the chain."""- k: Optional[int] = None+ k: int | None = None"""Number of questions to generate."""@classmethoddef from_llm(cls,llm: BaseLanguageModel,- prompt: Optional[BasePromptTemplate] = None,+ prompt: BasePromptTemplate | None = None,**kwargs: Any,) -> QAGenerationChain:"""Create a QAGenerationChain from a language model.@@ -117,7 +117,7 @@ class QAGenerationChain(Chain):def _call(self,inputs: dict[str, Any],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, list]:docs = self.text_splitter.create_documents([inputs[self.input_key]])results = self.llm_chain.generate(diff --git a/libs/langchain/langchain_classic/chains/qa_with_sources/base.py b/libs/langchain/langchain_classic/chains/qa_with_sources/base.pyindex 89d2ba80b4..30966c177c 100644--- a/libs/langchain/langchain_classic/chains/qa_with_sources/base.py+++ b/libs/langchain/langchain_classic/chains/qa_with_sources/base.py@@ -5,7 +5,7 @@ from __future__ import annotationsimport inspectimport refrom abc import ABC, abstractmethod-from typing import Any, Optional+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.callbacks import (@@ -90,7 +90,7 @@ class BaseQAWithSourcesChain(Chain, ABC):cls,llm: BaseLanguageModel,chain_type: str = "stuff",- chain_type_kwargs: Optional[dict] = None,+ chain_type_kwargs: dict | None = None,**kwargs: Any,) -> BaseQAWithSourcesChain:"""Load chain from chain type."""@@ -159,7 +159,7 @@ class BaseQAWithSourcesChain(Chain, ABC):def _call(self,inputs: dict[str, Any],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, str]:_run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()accepts_run_manager = (@@ -196,7 +196,7 @@ class BaseQAWithSourcesChain(Chain, ABC):async def _acall(self,inputs: dict[str, Any],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, Any]:_run_manager = run_manager or AsyncCallbackManagerForChainRun.get_noop_manager()accepts_run_manager = (diff --git a/libs/langchain/langchain_classic/chains/qa_with_sources/loading.py b/libs/langchain/langchain_classic/chains/qa_with_sources/loading.pyindex ea19ebef56..2589309170 100644--- a/libs/langchain/langchain_classic/chains/qa_with_sources/loading.py+++ b/libs/langchain/langchain_classic/chains/qa_with_sources/loading.py@@ -3,7 +3,7 @@from __future__ import annotationsfrom collections.abc import Mapping-from typing import Any, Optional, Protocol+from typing import Any, Protocolfrom langchain_core._api import deprecatedfrom langchain_core.language_models import BaseLanguageModel@@ -67,7 +67,7 @@ def _load_stuff_chain(prompt: BasePromptTemplate = stuff_prompt.PROMPT,document_prompt: BasePromptTemplate = stuff_prompt.EXAMPLE_PROMPT,document_variable_name: str = "summaries",- verbose: Optional[bool] = None,+ verbose: bool | None = None,**kwargs: Any,) -> StuffDocumentsChain:llm_chain = LLMChain(llm=llm, prompt=prompt, verbose=verbose)@@ -88,10 +88,10 @@ def _load_map_reduce_chain(document_prompt: BasePromptTemplate = map_reduce_prompt.EXAMPLE_PROMPT,combine_document_variable_name: str = "summaries",map_reduce_document_variable_name: str = "context",- collapse_prompt: Optional[BasePromptTemplate] = None,- reduce_llm: Optional[BaseLanguageModel] = None,- collapse_llm: Optional[BaseLanguageModel] = None,- verbose: Optional[bool] = None,+ collapse_prompt: BasePromptTemplate | None = None,+ reduce_llm: BaseLanguageModel | None = None,+ collapse_llm: BaseLanguageModel | None = None,+ verbose: bool | None = None,token_max: int = 3000,**kwargs: Any,) -> MapReduceDocumentsChain:@@ -146,8 +146,8 @@ def _load_refine_chain(document_prompt: BasePromptTemplate = refine_prompts.EXAMPLE_PROMPT,document_variable_name: str = "context_str",initial_response_name: str = "existing_answer",- refine_llm: Optional[BaseLanguageModel] = None,- verbose: Optional[bool] = None,+ refine_llm: BaseLanguageModel | None = None,+ verbose: bool | None = None,**kwargs: Any,) -> RefineDocumentsChain:initial_chain = LLMChain(llm=llm, prompt=question_prompt, verbose=verbose)@@ -182,7 +182,7 @@ def _load_refine_chain(def load_qa_with_sources_chain(llm: BaseLanguageModel,chain_type: str = "stuff",- verbose: Optional[bool] = None, # noqa: FBT001+ verbose: bool | None = None, # noqa: FBT001**kwargs: Any,) -> BaseCombineDocumentsChain:"""Load a question answering with sources chain.diff --git a/libs/langchain/langchain_classic/chains/query_constructor/base.py b/libs/langchain/langchain_classic/chains/query_constructor/base.pyindex c5402a1ddc..46eda5ef5b 100644--- a/libs/langchain/langchain_classic/chains/query_constructor/base.py+++ b/libs/langchain/langchain_classic/chains/query_constructor/base.py@@ -3,8 +3,8 @@from __future__ import annotationsimport json-from collections.abc import Sequence-from typing import Any, Callable, Optional, Union, cast+from collections.abc import Callable, Sequence+from typing import Any, castfrom langchain_core._api import deprecatedfrom langchain_core.exceptions import OutputParserException@@ -71,9 +71,9 @@ class StructuredQueryOutputParser(BaseOutputParser[StructuredQuery]):@classmethoddef from_components(cls,- allowed_comparators: Optional[Sequence[Comparator]] = None,- allowed_operators: Optional[Sequence[Operator]] = None,- allowed_attributes: Optional[Sequence[str]] = None,+ allowed_comparators: Sequence[Comparator] | None = None,+ allowed_operators: Sequence[Operator] | None = None,+ allowed_attributes: Sequence[str] | None = None,fix_invalid: bool = False, # noqa: FBT001,FBT002) -> StructuredQueryOutputParser:"""Create a structured query output parser from components.@@ -90,9 +90,9 @@ class StructuredQueryOutputParser(BaseOutputParser[StructuredQuery]):ast_parse: Callableif fix_invalid:- def ast_parse(raw_filter: str) -> Optional[FilterDirective]:+ def ast_parse(raw_filter: str) -> FilterDirective | None:filter_directive = cast(- "Optional[FilterDirective]",+ "FilterDirective | None",get_parser().parse(raw_filter),)return fix_filter_directive(@@ -112,12 +112,12 @@ class StructuredQueryOutputParser(BaseOutputParser[StructuredQuery]):def fix_filter_directive(- filter: Optional[FilterDirective], # noqa: A002+ filter: FilterDirective | None, # noqa: A002*,- allowed_comparators: Optional[Sequence[Comparator]] = None,- allowed_operators: Optional[Sequence[Operator]] = None,- allowed_attributes: Optional[Sequence[str]] = None,-) -> Optional[FilterDirective]:+ allowed_comparators: Sequence[Comparator] | None = None,+ allowed_operators: Sequence[Operator] | None = None,+ allowed_attributes: Sequence[str] | None = None,+) -> FilterDirective | None:"""Fix invalid filter directive.Args:@@ -167,7 +167,7 @@ def fix_filter_directive(return filter-def _format_attribute_info(info: Sequence[Union[AttributeInfo, dict]]) -> str:+def _format_attribute_info(info: Sequence[AttributeInfo | dict]) -> str:info_dicts = {}for i in info:i_dict = dict(i)@@ -200,13 +200,13 @@ def construct_examples(input_output_pairs: Sequence[tuple[str, dict]]) -> list[ddef get_query_constructor_prompt(document_contents: str,- attribute_info: Sequence[Union[AttributeInfo, dict]],+ attribute_info: Sequence[AttributeInfo | dict],*,- examples: Optional[Sequence] = None,+ examples: Sequence | None = None,allowed_comparators: Sequence[Comparator] = tuple(Comparator),allowed_operators: Sequence[Operator] = tuple(Operator),enable_limit: bool = False,- schema_prompt: Optional[BasePromptTemplate] = None,+ schema_prompt: BasePromptTemplate | None = None,**kwargs: Any,) -> BasePromptTemplate:"""Create query construction prompt.@@ -273,12 +273,12 @@ def get_query_constructor_prompt(def load_query_constructor_chain(llm: BaseLanguageModel,document_contents: str,- attribute_info: Sequence[Union[AttributeInfo, dict]],- examples: Optional[list] = None,+ attribute_info: Sequence[AttributeInfo | dict],+ examples: list | None = None,allowed_comparators: Sequence[Comparator] = tuple(Comparator),allowed_operators: Sequence[Operator] = tuple(Operator),enable_limit: bool = False, # noqa: FBT001,FBT002- schema_prompt: Optional[BasePromptTemplate] = None,+ schema_prompt: BasePromptTemplate | None = None,**kwargs: Any,) -> LLMChain:"""Load a query constructor chain.@@ -325,13 +325,13 @@ def load_query_constructor_chain(def load_query_constructor_runnable(llm: BaseLanguageModel,document_contents: str,- attribute_info: Sequence[Union[AttributeInfo, dict]],+ attribute_info: Sequence[AttributeInfo | dict],*,- examples: Optional[Sequence] = None,+ examples: Sequence | None = None,allowed_comparators: Sequence[Comparator] = tuple(Comparator),allowed_operators: Sequence[Operator] = tuple(Operator),enable_limit: bool = False,- schema_prompt: Optional[BasePromptTemplate] = None,+ schema_prompt: BasePromptTemplate | None = None,fix_invalid: bool = False,**kwargs: Any,) -> Runnable:diff --git a/libs/langchain/langchain_classic/chains/query_constructor/parser.py b/libs/langchain/langchain_classic/chains/query_constructor/parser.pyindex 5a13b2f030..d7e4de680e 100644--- a/libs/langchain/langchain_classic/chains/query_constructor/parser.py+++ b/libs/langchain/langchain_classic/chains/query_constructor/parser.py@@ -1,7 +1,7 @@import datetimeimport warningsfrom collections.abc import Sequence-from typing import Any, Literal, Optional, Union+from typing import Any, Literalfrom langchain_core.utils import check_package_versionfrom typing_extensions import TypedDict@@ -81,9 +81,9 @@ class QueryTransformer(Transformer):def __init__(self,*args: Any,- allowed_comparators: Optional[Sequence[Comparator]] = None,- allowed_operators: Optional[Sequence[Operator]] = None,- allowed_attributes: Optional[Sequence[str]] = None,+ allowed_comparators: Sequence[Comparator] | None = None,+ allowed_operators: Sequence[Operator] | None = None,+ allowed_attributes: Sequence[str] | None = None,**kwargs: Any,):"""Initialize the QueryTransformer.@@ -131,7 +131,7 @@ class QueryTransformer(Transformer):return args[0]return Operation(operator=func, arguments=args)- def _match_func_name(self, func_name: str) -> Union[Operator, Comparator]:+ def _match_func_name(self, func_name: str) -> Operator | Comparator:if func_name in set(Comparator):if (self.allowed_comparators is not None@@ -255,9 +255,9 @@ class QueryTransformer(Transformer):def get_parser(- allowed_comparators: Optional[Sequence[Comparator]] = None,- allowed_operators: Optional[Sequence[Operator]] = None,- allowed_attributes: Optional[Sequence[str]] = None,+ allowed_comparators: Sequence[Comparator] | None = None,+ allowed_operators: Sequence[Operator] | None = None,+ allowed_attributes: Sequence[str] | None = None,) -> Lark:"""Return a parser for the query language.diff --git a/libs/langchain/langchain_classic/chains/question_answering/chain.py b/libs/langchain/langchain_classic/chains/question_answering/chain.pyindex 25f62ac09d..f772517f95 100644--- a/libs/langchain/langchain_classic/chains/question_answering/chain.py+++ b/libs/langchain/langchain_classic/chains/question_answering/chain.py@@ -1,7 +1,7 @@"""Load question answering chains."""from collections.abc import Mapping-from typing import Any, Optional, Protocol+from typing import Any, Protocolfrom langchain_core._api import deprecatedfrom langchain_core.callbacks import BaseCallbackManager, Callbacks@@ -48,7 +48,7 @@ def _load_map_rerank_chain(document_variable_name: str = "context",rank_key: str = "score",answer_key: str = "answer",- callback_manager: Optional[BaseCallbackManager] = None,+ callback_manager: BaseCallbackManager | None = None,callbacks: Callbacks = None,**kwargs: Any,) -> MapRerankDocumentsChain:@@ -73,10 +73,10 @@ def _load_map_rerank_chain(def _load_stuff_chain(llm: BaseLanguageModel,*,- prompt: Optional[BasePromptTemplate] = None,+ prompt: BasePromptTemplate | None = None,document_variable_name: str = "context",- verbose: Optional[bool] = None,- callback_manager: Optional[BaseCallbackManager] = None,+ verbose: bool | None = None,+ callback_manager: BaseCallbackManager | None = None,callbacks: Callbacks = None,**kwargs: Any,) -> StuffDocumentsChain:@@ -102,15 +102,15 @@ def _load_stuff_chain(def _load_map_reduce_chain(llm: BaseLanguageModel,*,- question_prompt: Optional[BasePromptTemplate] = None,- combine_prompt: Optional[BasePromptTemplate] = None,+ question_prompt: BasePromptTemplate | None = None,+ combine_prompt: BasePromptTemplate | None = None,combine_document_variable_name: str = "summaries",map_reduce_document_variable_name: str = "context",- collapse_prompt: Optional[BasePromptTemplate] = None,- reduce_llm: Optional[BaseLanguageModel] = None,- collapse_llm: Optional[BaseLanguageModel] = None,- verbose: Optional[bool] = None,- callback_manager: Optional[BaseCallbackManager] = None,+ collapse_prompt: BasePromptTemplate | None = None,+ reduce_llm: BaseLanguageModel | None = None,+ collapse_llm: BaseLanguageModel | None = None,+ verbose: bool | None = None,+ callback_manager: BaseCallbackManager | None = None,callbacks: Callbacks = None,token_max: int = 3000,**kwargs: Any,@@ -186,13 +186,13 @@ def _load_map_reduce_chain(def _load_refine_chain(llm: BaseLanguageModel,*,- question_prompt: Optional[BasePromptTemplate] = None,- refine_prompt: Optional[BasePromptTemplate] = None,+ question_prompt: BasePromptTemplate | None = None,+ refine_prompt: BasePromptTemplate | None = None,document_variable_name: str = "context_str",initial_response_name: str = "existing_answer",- refine_llm: Optional[BaseLanguageModel] = None,- verbose: Optional[bool] = None,- callback_manager: Optional[BaseCallbackManager] = None,+ refine_llm: BaseLanguageModel | None = None,+ verbose: bool | None = None,+ callback_manager: BaseCallbackManager | None = None,callbacks: Callbacks = None,**kwargs: Any,) -> RefineDocumentsChain:@@ -246,8 +246,8 @@ def _load_refine_chain(def load_qa_chain(llm: BaseLanguageModel,chain_type: str = "stuff",- verbose: Optional[bool] = None, # noqa: FBT001- callback_manager: Optional[BaseCallbackManager] = None,+ verbose: bool | None = None, # noqa: FBT001+ callback_manager: BaseCallbackManager | None = None,**kwargs: Any,) -> BaseCombineDocumentsChain:"""Load question answering chain.diff --git a/libs/langchain/langchain_classic/chains/retrieval.py b/libs/langchain/langchain_classic/chains/retrieval.pyindex e9dd975ce2..eb1860fefc 100644--- a/libs/langchain/langchain_classic/chains/retrieval.py+++ b/libs/langchain/langchain_classic/chains/retrieval.py@@ -1,6 +1,6 @@from __future__ import annotations-from typing import Any, Union+from typing import Anyfrom langchain_core.retrievers import (BaseRetriever,@@ -10,7 +10,7 @@ from langchain_core.runnables import Runnable, RunnablePassthroughdef create_retrieval_chain(- retriever: Union[BaseRetriever, Runnable[dict, RetrieverOutput]],+ retriever: BaseRetriever | Runnable[dict, RetrieverOutput],combine_docs_chain: Runnable[dict[str, Any], str],) -> Runnable:"""Create retrieval chain that retrieves documents and then passes them on.diff --git a/libs/langchain/langchain_classic/chains/retrieval_qa/base.py b/libs/langchain/langchain_classic/chains/retrieval_qa/base.pyindex d409c110cc..4277e89f73 100644--- a/libs/langchain/langchain_classic/chains/retrieval_qa/base.py+++ b/libs/langchain/langchain_classic/chains/retrieval_qa/base.py@@ -4,7 +4,7 @@ from __future__ import annotationsimport inspectfrom abc import abstractmethod-from typing import Any, Optional+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.callbacks import (@@ -76,9 +76,9 @@ class BaseRetrievalQA(Chain):def from_llm(cls,llm: BaseLanguageModel,- prompt: Optional[PromptTemplate] = None,+ prompt: PromptTemplate | None = None,callbacks: Callbacks = None,- llm_chain_kwargs: Optional[dict] = None,+ llm_chain_kwargs: dict | None = None,**kwargs: Any,) -> BaseRetrievalQA:"""Initialize from LLM."""@@ -111,7 +111,7 @@ class BaseRetrievalQA(Chain):cls,llm: BaseLanguageModel,chain_type: str = "stuff",- chain_type_kwargs: Optional[dict] = None,+ chain_type_kwargs: dict | None = None,**kwargs: Any,) -> BaseRetrievalQA:"""Load chain from chain type."""@@ -135,7 +135,7 @@ class BaseRetrievalQA(Chain):def _call(self,inputs: dict[str, Any],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, Any]:"""Run get_relevant_text and llm on input query.@@ -180,7 +180,7 @@ class BaseRetrievalQA(Chain):async def _acall(self,inputs: dict[str, Any],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, Any]:"""Run get_relevant_text and llm on input query.diff --git a/libs/langchain/langchain_classic/chains/router/base.py b/libs/langchain/langchain_classic/chains/router/base.pyindex 6190cb288a..497e001bbb 100644--- a/libs/langchain/langchain_classic/chains/router/base.py+++ b/libs/langchain/langchain_classic/chains/router/base.py@@ -4,7 +4,7 @@ from __future__ import annotationsfrom abc import ABCfrom collections.abc import Mapping-from typing import Any, NamedTuple, Optional+from typing import Any, NamedTuplefrom langchain_core.callbacks import (AsyncCallbackManagerForChainRun,@@ -20,7 +20,7 @@ from langchain_classic.chains.base import Chainclass Route(NamedTuple):"""A route to a destination chain."""- destination: Optional[str]+ destination: str | Nonenext_inputs: dict[str, Any]@@ -100,7 +100,7 @@ class MultiRouteChain(Chain):def _call(self,inputs: dict[str, Any],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, Any]:_run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()callbacks = _run_manager.get_child()@@ -125,7 +125,7 @@ class MultiRouteChain(Chain):async def _acall(self,inputs: dict[str, Any],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, Any]:_run_manager = run_manager or AsyncCallbackManagerForChainRun.get_noop_manager()callbacks = _run_manager.get_child()diff --git a/libs/langchain/langchain_classic/chains/router/embedding_router.py b/libs/langchain/langchain_classic/chains/router/embedding_router.pyindex ac340927a7..a519fabc2a 100644--- a/libs/langchain/langchain_classic/chains/router/embedding_router.py+++ b/libs/langchain/langchain_classic/chains/router/embedding_router.py@@ -1,7 +1,7 @@from __future__ import annotationsfrom collections.abc import Sequence-from typing import Any, Optional+from typing import Anyfrom langchain_core.callbacks import (AsyncCallbackManagerForChainRun,@@ -39,7 +39,7 @@ class EmbeddingRouterChain(RouterChain):def _call(self,inputs: dict[str, Any],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, Any]:_input = ", ".join([inputs[k] for k in self.routing_keys])results = self.vectorstore.similarity_search(_input, k=1)@@ -49,7 +49,7 @@ class EmbeddingRouterChain(RouterChain):async def _acall(self,inputs: dict[str, Any],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, Any]:_input = ", ".join([inputs[k] for k in self.routing_keys])results = await self.vectorstore.asimilarity_search(_input, k=1)diff --git a/libs/langchain/langchain_classic/chains/router/llm_router.py b/libs/langchain/langchain_classic/chains/router/llm_router.pyindex 55c6fc4a9c..64e4823b8e 100644--- a/libs/langchain/langchain_classic/chains/router/llm_router.py+++ b/libs/langchain/langchain_classic/chains/router/llm_router.py@@ -2,7 +2,7 @@from __future__ import annotations-from typing import Any, Optional, cast+from typing import Any, castfrom langchain_core._api import deprecatedfrom langchain_core.callbacks import (@@ -132,7 +132,7 @@ class LLMRouterChain(RouterChain):def _call(self,inputs: dict[str, Any],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, Any]:_run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()callbacks = _run_manager.get_child()@@ -146,7 +146,7 @@ class LLMRouterChain(RouterChain):async def _acall(self,inputs: dict[str, Any],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, Any]:_run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()callbacks = _run_manager.get_child()diff --git a/libs/langchain/langchain_classic/chains/router/multi_prompt.py b/libs/langchain/langchain_classic/chains/router/multi_prompt.pyindex ad47bcaece..413f1cd58a 100644--- a/libs/langchain/langchain_classic/chains/router/multi_prompt.py+++ b/libs/langchain/langchain_classic/chains/router/multi_prompt.py@@ -2,7 +2,7 @@from __future__ import annotations-from typing import Any, Optional+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.language_models import BaseLanguageModel@@ -159,7 +159,7 @@ class MultiPromptChain(MultiRouteChain):cls,llm: BaseLanguageModel,prompt_infos: list[dict[str, str]],- default_chain: Optional[Chain] = None,+ default_chain: Chain | None = None,**kwargs: Any,) -> MultiPromptChain:"""Convenience constructor for instantiating from destination prompts."""diff --git a/libs/langchain/langchain_classic/chains/router/multi_retrieval_qa.py b/libs/langchain/langchain_classic/chains/router/multi_retrieval_qa.pyindex 489b2aab25..bf710cd804 100644--- a/libs/langchain/langchain_classic/chains/router/multi_retrieval_qa.py+++ b/libs/langchain/langchain_classic/chains/router/multi_retrieval_qa.py@@ -3,7 +3,7 @@from __future__ import annotationsfrom collections.abc import Mapping-from typing import Any, Optional+from typing import Anyfrom langchain_core.language_models import BaseLanguageModelfrom langchain_core.prompts import PromptTemplate@@ -48,11 +48,11 @@ class MultiRetrievalQAChain(MultiRouteChain):cls,llm: BaseLanguageModel,retriever_infos: list[dict[str, Any]],- default_retriever: Optional[BaseRetriever] = None,- default_prompt: Optional[PromptTemplate] = None,- default_chain: Optional[Chain] = None,+ default_retriever: BaseRetriever | None = None,+ default_prompt: PromptTemplate | None = None,+ default_chain: Chain | None = None,*,- default_chain_llm: Optional[BaseLanguageModel] = None,+ default_chain_llm: BaseLanguageModel | None = None,**kwargs: Any,) -> MultiRetrievalQAChain:"""Create a multi retrieval qa chain from an LLM and a default chain.diff --git a/libs/langchain/langchain_classic/chains/sequential.py b/libs/langchain/langchain_classic/chains/sequential.pyindex d38553623c..78b576fc6a 100644--- a/libs/langchain/langchain_classic/chains/sequential.py+++ b/libs/langchain/langchain_classic/chains/sequential.py@@ -1,6 +1,6 @@"""Chain pipeline where the outputs of one step feed directly into next."""-from typing import Any, Optional+from typing import Anyfrom langchain_core.callbacks import (AsyncCallbackManagerForChainRun,@@ -98,7 +98,7 @@ class SequentialChain(Chain):def _call(self,inputs: dict[str, str],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, str]:known_values = inputs.copy()_run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()@@ -111,7 +111,7 @@ class SequentialChain(Chain):async def _acall(self,inputs: dict[str, Any],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, Any]:known_values = inputs.copy()_run_manager = run_manager or AsyncCallbackManagerForChainRun.get_noop_manager()@@ -176,7 +176,7 @@ class SimpleSequentialChain(Chain):def _call(self,inputs: dict[str, str],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, str]:_run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()_input = inputs[self.input_key]@@ -199,7 +199,7 @@ class SimpleSequentialChain(Chain):async def _acall(self,inputs: dict[str, Any],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, Any]:_run_manager = run_manager or AsyncCallbackManagerForChainRun.get_noop_manager()_input = inputs[self.input_key]diff --git a/libs/langchain/langchain_classic/chains/sql_database/query.py b/libs/langchain/langchain_classic/chains/sql_database/query.pyindex f96e927e9a..9995412149 100644--- a/libs/langchain/langchain_classic/chains/sql_database/query.py+++ b/libs/langchain/langchain_classic/chains/sql_database/query.py@@ -1,6 +1,6 @@from __future__ import annotations-from typing import TYPE_CHECKING, Any, Optional, TypedDict, Union+from typing import TYPE_CHECKING, Any, TypedDictfrom langchain_core.language_models import BaseLanguageModelfrom langchain_core.output_parsers import StrOutputParser@@ -33,11 +33,11 @@ class SQLInputWithTables(TypedDict):def create_sql_query_chain(llm: BaseLanguageModel,db: SQLDatabase,- prompt: Optional[BasePromptTemplate] = None,+ prompt: BasePromptTemplate | None = None,k: int = 5,*,- get_col_comments: Optional[bool] = None,-) -> Runnable[Union[SQLInput, SQLInputWithTables, dict[str, Any]], str]:+ get_col_comments: bool | None = None,+) -> Runnable[SQLInput | SQLInputWithTables | dict[str, Any], str]:r"""Create a chain that generates SQL queries.*Security Note*: This chain generates SQL queries for the given database.diff --git a/libs/langchain/langchain_classic/chains/structured_output/base.py b/libs/langchain/langchain_classic/chains/structured_output/base.pyindex c47cf1c216..58512f99a8 100644--- a/libs/langchain/langchain_classic/chains/structured_output/base.py+++ b/libs/langchain/langchain_classic/chains/structured_output/base.py@@ -1,6 +1,6 @@import json-from collections.abc import Sequence-from typing import Any, Callable, Literal, Optional, Union+from collections.abc import Callable, Sequence+from typing import Any, Literalfrom langchain_core._api import deprecatedfrom langchain_core.output_parsers import (@@ -64,12 +64,12 @@ from pydantic import BaseModel),)def create_openai_fn_runnable(- functions: Sequence[Union[dict[str, Any], type[BaseModel], Callable]],+ functions: Sequence[dict[str, Any] | type[BaseModel] | Callable],llm: Runnable,- prompt: Optional[BasePromptTemplate] = None,+ prompt: BasePromptTemplate | None = None,*,enforce_single_function_usage: bool = True,- output_parser: Optional[Union[BaseOutputParser, BaseGenerationOutputParser]] = None,+ output_parser: BaseOutputParser | BaseGenerationOutputParser | None = None,**llm_kwargs: Any,) -> Runnable:"""Create a runnable sequence that uses OpenAI functions.@@ -183,11 +183,11 @@ def create_openai_fn_runnable(),)def create_structured_output_runnable(- output_schema: Union[dict[str, Any], type[BaseModel]],+ output_schema: dict[str, Any] | type[BaseModel],llm: Runnable,- prompt: Optional[BasePromptTemplate] = None,+ prompt: BasePromptTemplate | None = None,*,- output_parser: Optional[Union[BaseOutputParser, BaseGenerationOutputParser]] = None,+ output_parser: BaseOutputParser | BaseGenerationOutputParser | None = None,enforce_function_usage: bool = True,return_single: bool = True,mode: Literal[@@ -447,11 +447,11 @@ def create_structured_output_runnable(def _create_openai_tools_runnable(- tool: Union[dict[str, Any], type[BaseModel], Callable],+ tool: dict[str, Any] | type[BaseModel] | Callable,llm: Runnable,*,- prompt: Optional[BasePromptTemplate],- output_parser: Optional[Union[BaseOutputParser, BaseGenerationOutputParser]],+ prompt: BasePromptTemplate | None,+ output_parser: BaseOutputParser | BaseGenerationOutputParser | None,enforce_tool_usage: bool,first_tool_only: bool,) -> Runnable:@@ -472,12 +472,12 @@ def _create_openai_tools_runnable(def _get_openai_tool_output_parser(- tool: Union[dict[str, Any], type[BaseModel], Callable],+ tool: dict[str, Any] | type[BaseModel] | Callable,*,first_tool_only: bool = False,-) -> Union[BaseOutputParser, BaseGenerationOutputParser]:+) -> BaseOutputParser | BaseGenerationOutputParser:if isinstance(tool, type) and is_basemodel_subclass(tool):- output_parser: Union[BaseOutputParser, BaseGenerationOutputParser] = (+ output_parser: BaseOutputParser | BaseGenerationOutputParser = (PydanticToolsParser(tools=[tool], first_tool_only=first_tool_only))else:@@ -490,8 +490,8 @@ def _get_openai_tool_output_parser(def get_openai_output_parser(- functions: Sequence[Union[dict[str, Any], type[BaseModel], Callable]],-) -> Union[BaseOutputParser, BaseGenerationOutputParser]:+ functions: Sequence[dict[str, Any] | type[BaseModel] | Callable],+) -> BaseOutputParser | BaseGenerationOutputParser:"""Get the appropriate function output parser given the user functions.Args:@@ -507,12 +507,12 @@ def get_openai_output_parser("""if isinstance(functions[0], type) and is_basemodel_subclass(functions[0]):if len(functions) > 1:- pydantic_schema: Union[dict, type[BaseModel]] = {+ pydantic_schema: dict | type[BaseModel] = {convert_to_openai_function(fn)["name"]: fn for fn in functions}else:pydantic_schema = functions[0]- output_parser: Union[BaseOutputParser, BaseGenerationOutputParser] = (+ output_parser: BaseOutputParser | BaseGenerationOutputParser = (PydanticOutputFunctionsParser(pydantic_schema=pydantic_schema))else:@@ -521,11 +521,11 @@ def get_openai_output_parser(def _create_openai_json_runnable(- output_schema: Union[dict[str, Any], type[BaseModel]],+ output_schema: dict[str, Any] | type[BaseModel],llm: Runnable,- prompt: Optional[BasePromptTemplate] = None,+ prompt: BasePromptTemplate | None = None,*,- output_parser: Optional[Union[BaseOutputParser, BaseGenerationOutputParser]] = None,+ output_parser: BaseOutputParser | BaseGenerationOutputParser | None = None,) -> Runnable:if isinstance(output_schema, type) and is_basemodel_subclass(output_schema):output_parser = output_parser or PydanticOutputParser(@@ -546,11 +546,11 @@ def _create_openai_json_runnable(def _create_openai_functions_structured_output_runnable(- output_schema: Union[dict[str, Any], type[BaseModel]],+ output_schema: dict[str, Any] | type[BaseModel],llm: Runnable,- prompt: Optional[BasePromptTemplate] = None,+ prompt: BasePromptTemplate | None = None,*,- output_parser: Optional[Union[BaseOutputParser, BaseGenerationOutputParser]] = None,+ output_parser: BaseOutputParser | BaseGenerationOutputParser | None = None,**llm_kwargs: Any,) -> Runnable:if isinstance(output_schema, dict):diff --git a/libs/langchain/langchain_classic/chains/summarize/chain.py b/libs/langchain/langchain_classic/chains/summarize/chain.pyindex bf0741694c..f5ae19f571 100644--- a/libs/langchain/langchain_classic/chains/summarize/chain.py+++ b/libs/langchain/langchain_classic/chains/summarize/chain.py@@ -1,7 +1,7 @@"""Load summarizing chains."""from collections.abc import Mapping-from typing import Any, Optional, Protocol+from typing import Any, Protocolfrom langchain_core.callbacks import Callbacksfrom langchain_core.language_models import BaseLanguageModel@@ -38,7 +38,7 @@ def _load_stuff_chain(*,prompt: BasePromptTemplate = stuff_prompt.PROMPT,document_variable_name: str = "text",- verbose: Optional[bool] = None,+ verbose: bool | None = None,**kwargs: Any,) -> StuffDocumentsChain:llm_chain = LLMChain(llm=llm, prompt=prompt, verbose=verbose)@@ -72,13 +72,13 @@ def _load_map_reduce_chain(combine_prompt: BasePromptTemplate = map_reduce_prompt.PROMPT,combine_document_variable_name: str = "text",map_reduce_document_variable_name: str = "text",- collapse_prompt: Optional[BasePromptTemplate] = None,- reduce_llm: Optional[BaseLanguageModel] = None,- collapse_llm: Optional[BaseLanguageModel] = None,- verbose: Optional[bool] = None,+ collapse_prompt: BasePromptTemplate | None = None,+ reduce_llm: BaseLanguageModel | None = None,+ collapse_llm: BaseLanguageModel | None = None,+ verbose: bool | None = None,token_max: int = 3000,callbacks: Callbacks = None,- collapse_max_retries: Optional[int] = None,+ collapse_max_retries: int | None = None,**kwargs: Any,) -> MapReduceDocumentsChain:map_chain = LLMChain(@@ -179,8 +179,8 @@ def _load_refine_chain(refine_prompt: BasePromptTemplate = refine_prompts.REFINE_PROMPT,document_variable_name: str = "text",initial_response_name: str = "existing_answer",- refine_llm: Optional[BaseLanguageModel] = None,- verbose: Optional[bool] = None,+ refine_llm: BaseLanguageModel | None = None,+ verbose: bool | None = None,**kwargs: Any,) -> RefineDocumentsChain:initial_chain = LLMChain(llm=llm, prompt=question_prompt, verbose=verbose)@@ -199,7 +199,7 @@ def _load_refine_chain(def load_summarize_chain(llm: BaseLanguageModel,chain_type: str = "stuff",- verbose: Optional[bool] = None, # noqa: FBT001+ verbose: bool | None = None, # noqa: FBT001**kwargs: Any,) -> BaseCombineDocumentsChain:"""Load summarizing chain.diff --git a/libs/langchain/langchain_classic/chains/transform.py b/libs/langchain/langchain_classic/chains/transform.pyindex 335fba0202..7926b33e63 100644--- a/libs/langchain/langchain_classic/chains/transform.py+++ b/libs/langchain/langchain_classic/chains/transform.py@@ -2,8 +2,8 @@import functoolsimport logging-from collections.abc import Awaitable-from typing import Any, Callable, Optional+from collections.abc import Awaitable, Callable+from typing import Anyfrom langchain_core.callbacks import (AsyncCallbackManagerForChainRun,@@ -35,8 +35,8 @@ class TransformChain(Chain):"""The keys returned by the transform's output dictionary."""transform_cb: Callable[[dict[str, str]], dict[str, str]] = Field(alias="transform")"""The transform function."""- atransform_cb: Optional[Callable[[dict[str, Any]], Awaitable[dict[str, Any]]]] = (- Field(None, alias="atransform")+ atransform_cb: Callable[[dict[str, Any]], Awaitable[dict[str, Any]]] | None = Field(+ None, alias="atransform")"""The async coroutine transform function."""@@ -69,7 +69,7 @@ class TransformChain(Chain):def _call(self,inputs: dict[str, str],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, str]:return self.transform_cb(inputs)@@ -77,7 +77,7 @@ class TransformChain(Chain):async def _acall(self,inputs: dict[str, Any],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, Any]:if self.atransform_cb is not None:return await self.atransform_cb(inputs)diff --git a/libs/langchain/langchain_classic/chat_models/base.py b/libs/langchain/langchain_classic/chat_models/base.pyindex d8bbe072db..2bc4e3171a 100644--- a/libs/langchain/langchain_classic/chat_models/base.py+++ b/libs/langchain/langchain_classic/chat_models/base.py@@ -1,9 +1,9 @@from __future__ import annotationsimport warnings-from collections.abc import AsyncIterator, Iterator, Sequence+from collections.abc import AsyncIterator, Callable, Iterator, Sequencefrom importlib import util-from typing import Any, Callable, Literal, Optional, Union, cast, overload+from typing import Any, Literal, TypeAlias, cast, overloadfrom langchain_core.language_models import (BaseChatModel,@@ -20,7 +20,7 @@ from langchain_core.runnables.schema import StreamEventfrom langchain_core.tools import BaseToolfrom langchain_core.tracers import RunLog, RunLogPatchfrom pydantic import BaseModel-from typing_extensions import TypeAlias, override+from typing_extensions import override__all__ = [# For backwards compatibility@@ -36,9 +36,9 @@ __all__ = [def init_chat_model(model: str,*,- model_provider: Optional[str] = None,+ model_provider: str | None = None,configurable_fields: None = None,- config_prefix: Optional[str] = None,+ config_prefix: str | None = None,**kwargs: Any,) -> BaseChatModel: ...@@ -47,20 +47,20 @@ def init_chat_model(def init_chat_model(model: None = None,*,- model_provider: Optional[str] = None,+ model_provider: str | None = None,configurable_fields: None = None,- config_prefix: Optional[str] = None,+ config_prefix: str | None = None,**kwargs: Any,) -> _ConfigurableModel: ...@overloaddef init_chat_model(- model: Optional[str] = None,+ model: str | None = None,*,- model_provider: Optional[str] = None,- configurable_fields: Union[Literal["any"], list[str], tuple[str, ...]] = ...,- config_prefix: Optional[str] = None,+ model_provider: str | None = None,+ configurable_fields: Literal["any"] | list[str] | tuple[str, ...] = ...,+ config_prefix: str | None = None,**kwargs: Any,) -> _ConfigurableModel: ...@@ -69,15 +69,13 @@ def init_chat_model(# name to the supported list in the docstring below. Do *not* change the order of the# existing providers.def init_chat_model(- model: Optional[str] = None,+ model: str | None = None,*,- model_provider: Optional[str] = None,- configurable_fields: Optional[- Union[Literal["any"], list[str], tuple[str, ...]]- ] = None,- config_prefix: Optional[str] = None,+ model_provider: str | None = None,+ configurable_fields: Literal["any"] | list[str] | tuple[str, ...] | None = None,+ config_prefix: str | None = None,**kwargs: Any,-) -> Union[BaseChatModel, _ConfigurableModel]:+) -> BaseChatModel | _ConfigurableModel:"""Initialize a ChatModel in a single line using the model's name and provider.!!! note@@ -341,7 +339,7 @@ def init_chat_model(def _init_chat_model_helper(model: str,*,- model_provider: Optional[str] = None,+ model_provider: str | None = None,**kwargs: Any,) -> BaseChatModel:model, model_provider = _parse_model(model, model_provider)@@ -492,7 +490,7 @@ _SUPPORTED_PROVIDERS = {}-def _attempt_infer_model_provider(model_name: str) -> Optional[str]:+def _attempt_infer_model_provider(model_name: str) -> str | None:if any(model_name.startswith(pre) for pre in ("gpt-", "o1", "o3")):return "openai"if model_name.startswith("claude"):@@ -516,7 +514,7 @@ def _attempt_infer_model_provider(model_name: str) -> Optional[str]:return None-def _parse_model(model: str, model_provider: Optional[str]) -> tuple[str, str]:+def _parse_model(model: str, model_provider: str | None) -> tuple[str, str]:if (not model_providerand ":" in model@@ -535,7 +533,7 @@ def _parse_model(model: str, model_provider: Optional[str]) -> tuple[str, str]:return model, model_provider-def _check_pkg(pkg: str, *, pkg_kebab: Optional[str] = None) -> None:+def _check_pkg(pkg: str, *, pkg_kebab: str | None = None) -> None:if not util.find_spec(pkg):pkg_kebab = pkg_kebab if pkg_kebab is not None else pkg.replace("_", "-")msg = (@@ -551,13 +549,13 @@ class _ConfigurableModel(Runnable[LanguageModelInput, Any]):def __init__(self,*,- default_config: Optional[dict] = None,- configurable_fields: Union[Literal["any"], list[str], tuple[str, ...]] = "any",+ default_config: dict | None = None,+ configurable_fields: Literal["any"] | list[str] | tuple[str, ...] = "any",config_prefix: str = "",queued_declarative_operations: Sequence[tuple[str, tuple, dict]] = (),) -> None:self._default_config: dict = default_config or {}- self._configurable_fields: Union[Literal["any"], list[str]] = (+ self._configurable_fields: Literal["any"] | list[str] = (configurable_fieldsif configurable_fields == "any"else list(configurable_fields)@@ -601,14 +599,14 @@ class _ConfigurableModel(Runnable[LanguageModelInput, Any]):msg += "."raise AttributeError(msg)- def _model(self, config: Optional[RunnableConfig] = None) -> Runnable:+ def _model(self, config: RunnableConfig | None = None) -> Runnable:params = {**self._default_config, **self._model_params(config)}model = _init_chat_model_helper(**params)for name, args, kwargs in self._queued_declarative_operations:model = getattr(model, name)(*args, **kwargs)return model- def _model_params(self, config: Optional[RunnableConfig]) -> dict:+ def _model_params(self, config: RunnableConfig | None) -> dict:config = ensure_config(config)model_params = {k.removeprefix(self._config_prefix): v@@ -623,7 +621,7 @@ class _ConfigurableModel(Runnable[LanguageModelInput, Any]):def with_config(self,- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,**kwargs: Any,) -> _ConfigurableModel:"""Bind config to a Runnable, returning a new Runnable."""@@ -665,17 +663,13 @@ class _ConfigurableModel(Runnable[LanguageModelInput, Any]):# This is a version of LanguageModelInput which replaces the abstract# base class BaseMessage with a union of its subclasses, which makes# for a much better schema.- return Union[- str,- Union[StringPromptValue, ChatPromptValueConcrete],- list[AnyMessage],- ]+ return str | StringPromptValue | ChatPromptValueConcrete | list[AnyMessage]@overridedef invoke(self,input: LanguageModelInput,- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,**kwargs: Any,) -> Any:return self._model(config).invoke(input, config=config, **kwargs)@@ -684,7 +678,7 @@ class _ConfigurableModel(Runnable[LanguageModelInput, Any]):async def ainvoke(self,input: LanguageModelInput,- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,**kwargs: Any,) -> Any:return await self._model(config).ainvoke(input, config=config, **kwargs)@@ -693,8 +687,8 @@ class _ConfigurableModel(Runnable[LanguageModelInput, Any]):def stream(self,input: LanguageModelInput,- config: Optional[RunnableConfig] = None,- **kwargs: Optional[Any],+ config: RunnableConfig | None = None,+ **kwargs: Any | None,) -> Iterator[Any]:yield from self._model(config).stream(input, config=config, **kwargs)@@ -702,8 +696,8 @@ class _ConfigurableModel(Runnable[LanguageModelInput, Any]):async def astream(self,input: LanguageModelInput,- config: Optional[RunnableConfig] = None,- **kwargs: Optional[Any],+ config: RunnableConfig | None = None,+ **kwargs: Any | None,) -> AsyncIterator[Any]:async for x in self._model(config).astream(input, config=config, **kwargs):yield x@@ -711,10 +705,10 @@ class _ConfigurableModel(Runnable[LanguageModelInput, Any]):def batch(self,inputs: list[LanguageModelInput],- config: Optional[Union[RunnableConfig, list[RunnableConfig]]] = None,+ config: RunnableConfig | list[RunnableConfig] | None = None,*,return_exceptions: bool = False,- **kwargs: Optional[Any],+ **kwargs: Any | None,) -> list[Any]:config = config or None# If <= 1 config use the underlying models batch implementation.@@ -739,10 +733,10 @@ class _ConfigurableModel(Runnable[LanguageModelInput, Any]):async def abatch(self,inputs: list[LanguageModelInput],- config: Optional[Union[RunnableConfig, list[RunnableConfig]]] = None,+ config: RunnableConfig | list[RunnableConfig] | None = None,*,return_exceptions: bool = False,- **kwargs: Optional[Any],+ **kwargs: Any | None,) -> list[Any]:config = config or None# If <= 1 config use the underlying models batch implementation.@@ -767,11 +761,11 @@ class _ConfigurableModel(Runnable[LanguageModelInput, Any]):def batch_as_completed(self,inputs: Sequence[LanguageModelInput],- config: Optional[Union[RunnableConfig, Sequence[RunnableConfig]]] = None,+ config: RunnableConfig | Sequence[RunnableConfig] | None = None,*,return_exceptions: bool = False,**kwargs: Any,- ) -> Iterator[tuple[int, Union[Any, Exception]]]:+ ) -> Iterator[tuple[int, Any | Exception]]:config = config or None# If <= 1 config use the underlying models batch implementation.if config is None or isinstance(config, dict) or len(config) <= 1:@@ -796,7 +790,7 @@ class _ConfigurableModel(Runnable[LanguageModelInput, Any]):async def abatch_as_completed(self,inputs: Sequence[LanguageModelInput],- config: Optional[Union[RunnableConfig, Sequence[RunnableConfig]]] = None,+ config: RunnableConfig | Sequence[RunnableConfig] | None = None,*,return_exceptions: bool = False,**kwargs: Any,@@ -830,8 +824,8 @@ class _ConfigurableModel(Runnable[LanguageModelInput, Any]):def transform(self,input: Iterator[LanguageModelInput],- config: Optional[RunnableConfig] = None,- **kwargs: Optional[Any],+ config: RunnableConfig | None = None,+ **kwargs: Any | None,) -> Iterator[Any]:yield from self._model(config).transform(input, config=config, **kwargs)@@ -839,8 +833,8 @@ class _ConfigurableModel(Runnable[LanguageModelInput, Any]):async def atransform(self,input: AsyncIterator[LanguageModelInput],- config: Optional[RunnableConfig] = None,- **kwargs: Optional[Any],+ config: RunnableConfig | None = None,+ **kwargs: Any | None,) -> AsyncIterator[Any]:async for x in self._model(config).atransform(input, config=config, **kwargs):yield x@@ -849,16 +843,16 @@ class _ConfigurableModel(Runnable[LanguageModelInput, Any]):def astream_log(self,input: Any,- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,*,diff: Literal[True] = True,with_streamed_output_list: bool = True,- include_names: Optional[Sequence[str]] = None,- include_types: Optional[Sequence[str]] = None,- include_tags: Optional[Sequence[str]] = None,- exclude_names: Optional[Sequence[str]] = None,- exclude_types: Optional[Sequence[str]] = None,- exclude_tags: Optional[Sequence[str]] = None,+ include_names: Sequence[str] | None = None,+ include_types: Sequence[str] | None = None,+ include_tags: Sequence[str] | None = None,+ exclude_names: Sequence[str] | None = None,+ exclude_types: Sequence[str] | None = None,+ exclude_tags: Sequence[str] | None = None,**kwargs: Any,) -> AsyncIterator[RunLogPatch]: ...@@ -866,16 +860,16 @@ class _ConfigurableModel(Runnable[LanguageModelInput, Any]):def astream_log(self,input: Any,- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,*,diff: Literal[False],with_streamed_output_list: bool = True,- include_names: Optional[Sequence[str]] = None,- include_types: Optional[Sequence[str]] = None,- include_tags: Optional[Sequence[str]] = None,- exclude_names: Optional[Sequence[str]] = None,- exclude_types: Optional[Sequence[str]] = None,- exclude_tags: Optional[Sequence[str]] = None,+ include_names: Sequence[str] | None = None,+ include_types: Sequence[str] | None = None,+ include_tags: Sequence[str] | None = None,+ exclude_names: Sequence[str] | None = None,+ exclude_types: Sequence[str] | None = None,+ exclude_tags: Sequence[str] | None = None,**kwargs: Any,) -> AsyncIterator[RunLog]: ...@@ -883,18 +877,18 @@ class _ConfigurableModel(Runnable[LanguageModelInput, Any]):async def astream_log(self,input: Any,- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,*,diff: bool = True,with_streamed_output_list: bool = True,- include_names: Optional[Sequence[str]] = None,- include_types: Optional[Sequence[str]] = None,- include_tags: Optional[Sequence[str]] = None,- exclude_names: Optional[Sequence[str]] = None,- exclude_types: Optional[Sequence[str]] = None,- exclude_tags: Optional[Sequence[str]] = None,+ include_names: Sequence[str] | None = None,+ include_types: Sequence[str] | None = None,+ include_tags: Sequence[str] | None = None,+ exclude_names: Sequence[str] | None = None,+ exclude_types: Sequence[str] | None = None,+ exclude_tags: Sequence[str] | None = None,**kwargs: Any,- ) -> Union[AsyncIterator[RunLogPatch], AsyncIterator[RunLog]]:+ ) -> AsyncIterator[RunLogPatch] | AsyncIterator[RunLog]:async for x in self._model(config).astream_log( # type: ignore[call-overload, misc]input,config=config,@@ -914,15 +908,15 @@ class _ConfigurableModel(Runnable[LanguageModelInput, Any]):async def astream_events(self,input: Any,- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,*,version: Literal["v1", "v2"] = "v2",- include_names: Optional[Sequence[str]] = None,- include_types: Optional[Sequence[str]] = None,- include_tags: Optional[Sequence[str]] = None,- exclude_names: Optional[Sequence[str]] = None,- exclude_types: Optional[Sequence[str]] = None,- exclude_tags: Optional[Sequence[str]] = None,+ include_names: Sequence[str] | None = None,+ include_types: Sequence[str] | None = None,+ include_tags: Sequence[str] | None = None,+ exclude_names: Sequence[str] | None = None,+ exclude_types: Sequence[str] | None = None,+ exclude_tags: Sequence[str] | None = None,**kwargs: Any,) -> AsyncIterator[StreamEvent]:async for x in self._model(config).astream_events(@@ -942,7 +936,7 @@ class _ConfigurableModel(Runnable[LanguageModelInput, Any]):# Explicitly added to satisfy downstream linters.def bind_tools(self,- tools: Sequence[Union[dict[str, Any], type[BaseModel], Callable, BaseTool]],+ tools: Sequence[dict[str, Any] | type[BaseModel] | Callable | BaseTool],**kwargs: Any,) -> Runnable[LanguageModelInput, AIMessage]:return self.__getattr__("bind_tools")(tools, **kwargs)@@ -950,7 +944,7 @@ class _ConfigurableModel(Runnable[LanguageModelInput, Any]):# Explicitly added to satisfy downstream linters.def with_structured_output(self,- schema: Union[dict, type[BaseModel]],+ schema: dict | type[BaseModel],**kwargs: Any,- ) -> Runnable[LanguageModelInput, Union[dict, BaseModel]]:+ ) -> Runnable[LanguageModelInput, dict | BaseModel]:return self.__getattr__("with_structured_output")(schema, **kwargs)diff --git a/libs/langchain/langchain_classic/embeddings/base.py b/libs/langchain/langchain_classic/embeddings/base.pyindex a0052fe0b5..a8a62ac084 100644--- a/libs/langchain/langchain_classic/embeddings/base.py+++ b/libs/langchain/langchain_classic/embeddings/base.py@@ -1,6 +1,6 @@import functoolsfrom importlib import util-from typing import Any, Optional, Union+from typing import Anyfrom langchain_core.embeddings import Embeddingsfrom langchain_core.runnables import Runnable@@ -82,7 +82,7 @@ def _parse_model_string(model_name: str) -> tuple[str, str]:def _infer_model_and_provider(model: str,*,- provider: Optional[str] = None,+ provider: str | None = None,) -> tuple[str, str]:if not model.strip():msg = "Model name cannot be empty"@@ -127,9 +127,9 @@ def _check_pkg(pkg: str) -> None:def init_embeddings(model: str,*,- provider: Optional[str] = None,+ provider: str | None = None,**kwargs: Any,-) -> Union[Embeddings, Runnable[Any, list[float]]]:+) -> Embeddings | Runnable[Any, list[float]]:"""Initialize an embeddings model from a model name and optional provider.**Note:** Must have the integration package corresponding to the model providerdiff --git a/libs/langchain/langchain_classic/embeddings/cache.py b/libs/langchain/langchain_classic/embeddings/cache.pyindex 00a6e85687..c9a207d713 100644--- a/libs/langchain/langchain_classic/embeddings/cache.py+++ b/libs/langchain/langchain_classic/embeddings/cache.py@@ -13,8 +13,8 @@ import hashlibimport jsonimport uuidimport warnings-from collections.abc import Sequence-from typing import Callable, Literal, Optional, Union, cast+from collections.abc import Callable, Sequence+from typing import Literal, castfrom langchain_core.embeddings import Embeddingsfrom langchain_core.stores import BaseStore, ByteStore@@ -144,8 +144,8 @@ class CacheBackedEmbeddings(Embeddings):underlying_embeddings: Embeddings,document_embedding_store: BaseStore[str, list[float]],*,- batch_size: Optional[int] = None,- query_embedding_store: Optional[BaseStore[str, list[float]]] = None,+ batch_size: int | None = None,+ query_embedding_store: BaseStore[str, list[float]] | None = None,) -> None:"""Initialize the embedder.@@ -175,7 +175,7 @@ class CacheBackedEmbeddings(Embeddings):Returns:A list of embeddings for the given texts."""- vectors: list[Union[list[float], None]] = self.document_embedding_store.mget(+ vectors: list[list[float] | None] = self.document_embedding_store.mget(texts,)all_missing_indices: list[int] = [@@ -186,9 +186,11 @@ class CacheBackedEmbeddings(Embeddings):missing_texts = [texts[i] for i in missing_indices]missing_vectors = self.underlying_embeddings.embed_documents(missing_texts)self.document_embedding_store.mset(- list(zip(missing_texts, missing_vectors)),+ list(zip(missing_texts, missing_vectors, strict=False)),)- for index, updated_vector in zip(missing_indices, missing_vectors):+ for index, updated_vector in zip(+ missing_indices, missing_vectors, strict=False+ ):vectors[index] = updated_vectorreturn cast(@@ -209,9 +211,9 @@ class CacheBackedEmbeddings(Embeddings):Returns:A list of embeddings for the given texts."""- vectors: list[- Union[list[float], None]- ] = await self.document_embedding_store.amget(texts)+ vectors: list[list[float] | None] = await self.document_embedding_store.amget(+ texts+ )all_missing_indices: list[int] = [i for i, vector in enumerate(vectors) if vector is None]@@ -224,9 +226,11 @@ class CacheBackedEmbeddings(Embeddings):missing_texts,)await self.document_embedding_store.amset(- list(zip(missing_texts, missing_vectors)),+ list(zip(missing_texts, missing_vectors, strict=False)),)- for index, updated_vector in zip(missing_indices, missing_vectors):+ for index, updated_vector in zip(+ missing_indices, missing_vectors, strict=False+ ):vectors[index] = updated_vectorreturn cast(@@ -287,12 +291,10 @@ class CacheBackedEmbeddings(Embeddings):document_embedding_cache: ByteStore,*,namespace: str = "",- batch_size: Optional[int] = None,- query_embedding_cache: Union[bool, ByteStore] = False,- key_encoder: Union[- Callable[[str], str],- Literal["sha1", "blake2b", "sha256", "sha512"],- ] = "sha1",+ batch_size: int | None = None,+ query_embedding_cache: bool | ByteStore = False,+ key_encoder: Callable[[str], str]+ | Literal["sha1", "blake2b", "sha256", "sha512"] = "sha1",) -> CacheBackedEmbeddings:"""On-ramp that adds the necessary serialization and encoding to the store.diff --git a/libs/langchain/langchain_classic/evaluation/agents/trajectory_eval_chain.py b/libs/langchain/langchain_classic/evaluation/agents/trajectory_eval_chain.pyindex bfc486d251..49b144a36e 100644--- a/libs/langchain/langchain_classic/evaluation/agents/trajectory_eval_chain.py+++ b/libs/langchain/langchain_classic/evaluation/agents/trajectory_eval_chain.py@@ -9,9 +9,7 @@ import refrom collections.abc import Sequencefrom typing import (Any,- Optional,TypedDict,- Union,cast,)@@ -143,7 +141,7 @@ class TrajectoryEvalChain(AgentTrajectoryEvaluator, LLMEvalChain):"""- agent_tools: Optional[list[BaseTool]] = None+ agent_tools: list[BaseTool] | None = None"""A list of tools available to the agent."""eval_chain: LLMChain"""The language model chain used for evaluation."""@@ -182,7 +180,7 @@ Description: {tool.description}"""@staticmethoddef get_agent_trajectory(- steps: Union[str, Sequence[tuple[AgentAction, str]]],+ steps: str | Sequence[tuple[AgentAction, str]],) -> str:"""Get the agent trajectory as a formatted string.@@ -206,7 +204,7 @@ Tool output: {output}""")@staticmethod- def _format_reference(reference: Optional[str]) -> str:+ def _format_reference(reference: str | None) -> str:"""Format the reference text.Args:@@ -229,8 +227,8 @@ The following is the expected answer. Use this to measure correctness:def from_llm(cls,llm: BaseLanguageModel,- agent_tools: Optional[Sequence[BaseTool]] = None,- output_parser: Optional[TrajectoryOutputParser] = None,+ agent_tools: Sequence[BaseTool] | None = None,+ output_parser: TrajectoryOutputParser | None = None,**kwargs: Any,) -> "TrajectoryEvalChain":"""Create a TrajectoryEvalChain object from a language model chain.@@ -275,7 +273,7 @@ The following is the expected answer. Use this to measure correctness:"""return ["score", "reasoning"]- def prep_inputs(self, inputs: Union[dict[str, Any], Any]) -> dict[str, str]:+ def prep_inputs(self, inputs: dict[str, Any] | Any) -> dict[str, str]:"""Validate and prep inputs."""inputs["reference"] = self._format_reference(inputs.get("reference"))return super().prep_inputs(inputs)@@ -283,7 +281,7 @@ The following is the expected answer. Use this to measure correctness:def _call(self,inputs: dict[str, str],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, Any]:"""Run the chain and generate the output.@@ -308,7 +306,7 @@ The following is the expected answer. Use this to measure correctness:async def _acall(self,inputs: dict[str, str],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, Any]:"""Run the chain and generate the output.@@ -337,10 +335,10 @@ The following is the expected answer. Use this to measure correctness:prediction: str,input: str,agent_trajectory: Sequence[tuple[AgentAction, str]],- reference: Optional[str] = None,+ reference: str | None = None,callbacks: Callbacks = None,- tags: Optional[list[str]] = None,- metadata: Optional[dict[str, Any]] = None,+ tags: list[str] | None = None,+ metadata: dict[str, Any] | None = None,include_run_info: bool = False,**kwargs: Any,) -> dict:@@ -383,10 +381,10 @@ The following is the expected answer. Use this to measure correctness:prediction: str,input: str,agent_trajectory: Sequence[tuple[AgentAction, str]],- reference: Optional[str] = None,+ reference: str | None = None,callbacks: Callbacks = None,- tags: Optional[list[str]] = None,- metadata: Optional[dict[str, Any]] = None,+ tags: list[str] | None = None,+ metadata: dict[str, Any] | None = None,include_run_info: bool = False,**kwargs: Any,) -> dict:diff --git a/libs/langchain/langchain_classic/evaluation/comparison/eval_chain.py b/libs/langchain/langchain_classic/evaluation/comparison/eval_chain.pyindex f724a62b24..e35dfec3b6 100644--- a/libs/langchain/langchain_classic/evaluation/comparison/eval_chain.py+++ b/libs/langchain/langchain_classic/evaluation/comparison/eval_chain.py@@ -4,7 +4,7 @@ from __future__ import annotationsimport loggingimport re-from typing import Any, Optional, Union+from typing import Anyfrom langchain_core.callbacks import Callbacksfrom langchain_core.language_models import BaseLanguageModel@@ -50,7 +50,7 @@ _SUPPORTED_CRITERIA = {def resolve_pairwise_criteria(- criteria: Optional[Union[CRITERIA_TYPE, str, list[CRITERIA_TYPE]]],+ criteria: CRITERIA_TYPE | str | list[CRITERIA_TYPE] | None,) -> dict:"""Resolve the criteria for the pairwise evaluator.@@ -241,8 +241,8 @@ class PairwiseStringEvalChain(PairwiseStringEvaluator, LLMEvalChain, LLMChain):cls,llm: BaseLanguageModel,*,- prompt: Optional[PromptTemplate] = None,- criteria: Optional[Union[CRITERIA_TYPE, str]] = None,+ prompt: PromptTemplate | None = None,+ criteria: CRITERIA_TYPE | str | None = None,**kwargs: Any,) -> PairwiseStringEvalChain:"""Initialize the PairwiseStringEvalChain from an LLM.@@ -284,8 +284,8 @@ Performance may be significantly worse with other models.",self,prediction: str,prediction_b: str,- input_: Optional[str],- reference: Optional[str],+ input_: str | None,+ reference: str | None,) -> dict:"""Prepare the input for the chain.@@ -321,11 +321,11 @@ Performance may be significantly worse with other models.",*,prediction: str,prediction_b: str,- input: Optional[str] = None,- reference: Optional[str] = None,+ input: str | None = None,+ reference: str | None = None,callbacks: Callbacks = None,- tags: Optional[list[str]] = None,- metadata: Optional[dict[str, Any]] = None,+ tags: list[str] | None = None,+ metadata: dict[str, Any] | None = None,include_run_info: bool = False,**kwargs: Any,) -> dict:@@ -367,11 +367,11 @@ Performance may be significantly worse with other models.",*,prediction: str,prediction_b: str,- reference: Optional[str] = None,- input: Optional[str] = None,+ reference: str | None = None,+ input: str | None = None,callbacks: Callbacks = None,- tags: Optional[list[str]] = None,- metadata: Optional[dict[str, Any]] = None,+ tags: list[str] | None = None,+ metadata: dict[str, Any] | None = None,include_run_info: bool = False,**kwargs: Any,) -> dict:@@ -435,8 +435,8 @@ class LabeledPairwiseStringEvalChain(PairwiseStringEvalChain):cls,llm: BaseLanguageModel,*,- prompt: Optional[PromptTemplate] = None,- criteria: Optional[Union[CRITERIA_TYPE, str]] = None,+ prompt: PromptTemplate | None = None,+ criteria: CRITERIA_TYPE | str | None = None,**kwargs: Any,) -> PairwiseStringEvalChain:"""Initialize the LabeledPairwiseStringEvalChain from an LLM.diff --git a/libs/langchain/langchain_classic/evaluation/criteria/eval_chain.py b/libs/langchain/langchain_classic/evaluation/criteria/eval_chain.pyindex 32b128ded0..210f915800 100644--- a/libs/langchain/langchain_classic/evaluation/criteria/eval_chain.py+++ b/libs/langchain/langchain_classic/evaluation/criteria/eval_chain.py@@ -3,7 +3,7 @@ from __future__ import annotationsimport refrom collections.abc import Mappingfrom enum import Enum-from typing import Any, Optional, Union+from typing import Anyfrom langchain_core.callbacks import Callbacksfrom langchain_core.language_models import BaseLanguageModel@@ -110,15 +110,11 @@ class CriteriaResultOutputParser(BaseOutputParser[dict]):}-CRITERIA_TYPE = Union[- Mapping[str, str],- Criteria,- ConstitutionalPrinciple,-]+CRITERIA_TYPE = Mapping[str, str] | Criteria | ConstitutionalPrincipledef resolve_criteria(- criteria: Optional[Union[CRITERIA_TYPE, str]],+ criteria: CRITERIA_TYPE | str | None,) -> dict[str, str]:"""Resolve the criteria to evaluate.@@ -275,7 +271,7 @@ class CriteriaEvalChain(StringEvaluator, LLMEvalChain, LLMChain):@classmethoddef _resolve_prompt(cls,- prompt: Optional[BasePromptTemplate] = None,+ prompt: BasePromptTemplate | None = None,) -> BasePromptTemplate:expected_input_vars = {"input", "output", "criteria"}prompt_ = prompt or PROMPT@@ -290,7 +286,7 @@ class CriteriaEvalChain(StringEvaluator, LLMEvalChain, LLMChain):@classmethoddef resolve_criteria(cls,- criteria: Optional[Union[CRITERIA_TYPE, str]],+ criteria: CRITERIA_TYPE | str | None,) -> dict[str, str]:"""Resolve the criteria to evaluate.@@ -319,9 +315,9 @@ class CriteriaEvalChain(StringEvaluator, LLMEvalChain, LLMChain):def from_llm(cls,llm: BaseLanguageModel,- criteria: Optional[CRITERIA_TYPE] = None,+ criteria: CRITERIA_TYPE | None = None,*,- prompt: Optional[BasePromptTemplate] = None,+ prompt: BasePromptTemplate | None = None,**kwargs: Any,) -> CriteriaEvalChain:"""Create a `CriteriaEvalChain` instance from an llm and criteria.@@ -385,8 +381,8 @@ class CriteriaEvalChain(StringEvaluator, LLMEvalChain, LLMChain):def _get_eval_input(self,prediction: str,- reference: Optional[str],- input_: Optional[str],+ reference: str | None,+ input_: str | None,) -> dict:"""Get the evaluation input."""input_dict = {@@ -409,11 +405,11 @@ class CriteriaEvalChain(StringEvaluator, LLMEvalChain, LLMChain):self,*,prediction: str,- reference: Optional[str] = None,- input: Optional[str] = None,+ reference: str | None = None,+ input: str | None = None,callbacks: Callbacks = None,- tags: Optional[list[str]] = None,- metadata: Optional[dict[str, Any]] = None,+ tags: list[str] | None = None,+ metadata: dict[str, Any] | None = None,include_run_info: bool = False,**kwargs: Any,) -> dict:@@ -461,11 +457,11 @@ class CriteriaEvalChain(StringEvaluator, LLMEvalChain, LLMChain):self,*,prediction: str,- reference: Optional[str] = None,- input: Optional[str] = None,+ reference: str | None = None,+ input: str | None = None,callbacks: Callbacks = None,- tags: Optional[list[str]] = None,- metadata: Optional[dict[str, Any]] = None,+ tags: list[str] | None = None,+ metadata: dict[str, Any] | None = None,include_run_info: bool = False,**kwargs: Any,) -> dict:@@ -525,7 +521,7 @@ class LabeledCriteriaEvalChain(CriteriaEvalChain):@classmethoddef _resolve_prompt(cls,- prompt: Optional[BasePromptTemplate] = None,+ prompt: BasePromptTemplate | None = None,) -> BasePromptTemplate:expected_input_vars = {"input", "output", "criteria", "reference"}prompt_ = prompt or PROMPT_WITH_REFERENCES@@ -541,9 +537,9 @@ class LabeledCriteriaEvalChain(CriteriaEvalChain):def from_llm(cls,llm: BaseLanguageModel,- criteria: Optional[CRITERIA_TYPE] = None,+ criteria: CRITERIA_TYPE | None = None,*,- prompt: Optional[BasePromptTemplate] = None,+ prompt: BasePromptTemplate | None = None,**kwargs: Any,) -> CriteriaEvalChain:"""Create a `LabeledCriteriaEvalChain` instance from an llm and criteria.diff --git a/libs/langchain/langchain_classic/evaluation/embedding_distance/base.py b/libs/langchain/langchain_classic/evaluation/embedding_distance/base.pyindex 626d737cce..35f994a2af 100644--- a/libs/langchain/langchain_classic/evaluation/embedding_distance/base.py+++ b/libs/langchain/langchain_classic/evaluation/embedding_distance/base.py@@ -4,7 +4,7 @@ import functoolsimport loggingfrom enum import Enumfrom importlib import util-from typing import Any, Optional+from typing import Anyfrom langchain_core.callbacks import Callbacksfrom langchain_core.callbacks.manager import (@@ -231,7 +231,7 @@ class _EmbeddingDistanceChainMixin(Chain):if hasattr(b, "flatten"):b_flat = b.flatten()- dot_product = sum(x * y for x, y in zip(a_flat, b_flat))+ dot_product = sum(x * y for x, y in zip(a_flat, b_flat, strict=False))norm_a = sum(x * x for x in a_flat) ** 0.5norm_b = sum(x * x for x in b_flat) ** 0.5if norm_a == 0 or norm_b == 0:@@ -259,7 +259,7 @@ class _EmbeddingDistanceChainMixin(Chain):return np.linalg.norm(a - b)- return sum((x - y) * (x - y) for x, y in zip(a, b)) ** 0.5+ return sum((x - y) * (x - y) for x, y in zip(a, b, strict=False)) ** 0.5@staticmethoddef _manhattan_distance(a: Any, b: Any) -> Any:@@ -281,7 +281,7 @@ class _EmbeddingDistanceChainMixin(Chain):np = _import_numpy()return np.sum(np.abs(a - b))- return sum(abs(x - y) for x, y in zip(a, b))+ return sum(abs(x - y) for x, y in zip(a, b, strict=False))@staticmethoddef _chebyshev_distance(a: Any, b: Any) -> Any:@@ -303,7 +303,7 @@ class _EmbeddingDistanceChainMixin(Chain):np = _import_numpy()return np.max(np.abs(a - b))- return max(abs(x - y) for x, y in zip(a, b))+ return max(abs(x - y) for x, y in zip(a, b, strict=False))@staticmethoddef _hamming_distance(a: Any, b: Any) -> Any:@@ -325,7 +325,7 @@ class _EmbeddingDistanceChainMixin(Chain):np = _import_numpy()return np.mean(a != b)- return sum(1 for x, y in zip(a, b) if x != y) / len(a)+ return sum(1 for x, y in zip(a, b, strict=False) if x != y) / len(a)def _compute_score(self, vectors: Any) -> float:"""Compute the score based on the distance metric.@@ -384,7 +384,7 @@ class EmbeddingDistanceEvalChain(_EmbeddingDistanceChainMixin, StringEvaluator):def _call(self,inputs: dict[str, Any],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, Any]:"""Compute the score for a prediction and reference.@@ -409,7 +409,7 @@ class EmbeddingDistanceEvalChain(_EmbeddingDistanceChainMixin, StringEvaluator):async def _acall(self,inputs: dict[str, Any],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, Any]:"""Asynchronously compute the score for a prediction and reference.@@ -438,10 +438,10 @@ class EmbeddingDistanceEvalChain(_EmbeddingDistanceChainMixin, StringEvaluator):self,*,prediction: str,- reference: Optional[str] = None,+ reference: str | None = None,callbacks: Callbacks = None,- tags: Optional[list[str]] = None,- metadata: Optional[dict[str, Any]] = None,+ tags: list[str] | None = None,+ metadata: dict[str, Any] | None = None,include_run_info: bool = False,**kwargs: Any,) -> dict:@@ -474,10 +474,10 @@ class EmbeddingDistanceEvalChain(_EmbeddingDistanceChainMixin, StringEvaluator):self,*,prediction: str,- reference: Optional[str] = None,+ reference: str | None = None,callbacks: Callbacks = None,- tags: Optional[list[str]] = None,- metadata: Optional[dict[str, Any]] = None,+ tags: list[str] | None = None,+ metadata: dict[str, Any] | None = None,include_run_info: bool = False,**kwargs: Any,) -> dict:@@ -537,7 +537,7 @@ class PairwiseEmbeddingDistanceEvalChain(def _call(self,inputs: dict[str, Any],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, Any]:"""Compute the score for two predictions.@@ -565,7 +565,7 @@ class PairwiseEmbeddingDistanceEvalChain(async def _acall(self,inputs: dict[str, Any],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, Any]:"""Asynchronously compute the score for two predictions.@@ -596,8 +596,8 @@ class PairwiseEmbeddingDistanceEvalChain(prediction: str,prediction_b: str,callbacks: Callbacks = None,- tags: Optional[list[str]] = None,- metadata: Optional[dict[str, Any]] = None,+ tags: list[str] | None = None,+ metadata: dict[str, Any] | None = None,include_run_info: bool = False,**kwargs: Any,) -> dict:@@ -632,8 +632,8 @@ class PairwiseEmbeddingDistanceEvalChain(prediction: str,prediction_b: str,callbacks: Callbacks = None,- tags: Optional[list[str]] = None,- metadata: Optional[dict[str, Any]] = None,+ tags: list[str] | None = None,+ metadata: dict[str, Any] | None = None,include_run_info: bool = False,**kwargs: Any,) -> dict:diff --git a/libs/langchain/langchain_classic/evaluation/loading.py b/libs/langchain/langchain_classic/evaluation/loading.pyindex 12b100c623..2ca00803b5 100644--- a/libs/langchain/langchain_classic/evaluation/loading.py+++ b/libs/langchain/langchain_classic/evaluation/loading.py@@ -1,7 +1,7 @@"""Loading datasets and evaluators."""from collections.abc import Sequence-from typing import Any, Optional, Union+from typing import Anyfrom langchain_core.language_models import BaseLanguageModel@@ -88,7 +88,7 @@ def load_dataset(uri: str) -> list[dict]:_EVALUATOR_MAP: dict[EvaluatorType,- Union[type[LLMEvalChain], type[Chain], type[StringEvaluator]],+ type[LLMEvalChain] | type[Chain] | type[StringEvaluator],] = {EvaluatorType.QA: QAEvalChain,EvaluatorType.COT_QA: CotQAEvalChain,@@ -116,9 +116,9 @@ _EVALUATOR_MAP: dict[def load_evaluator(evaluator: EvaluatorType,*,- llm: Optional[BaseLanguageModel] = None,+ llm: BaseLanguageModel | None = None,**kwargs: Any,-) -> Union[Chain, StringEvaluator]:+) -> Chain | StringEvaluator:"""Load the requested evaluation chain specified by a string.Parameters@@ -183,10 +183,10 @@ def load_evaluator(def load_evaluators(evaluators: Sequence[EvaluatorType],*,- llm: Optional[BaseLanguageModel] = None,- config: Optional[dict] = None,+ llm: BaseLanguageModel | None = None,+ config: dict | None = None,**kwargs: Any,-) -> list[Union[Chain, StringEvaluator]]:+) -> list[Chain | StringEvaluator]:"""Load evaluators specified by a list of evaluator types.Parametersdiff --git a/libs/langchain/langchain_classic/evaluation/parsing/base.py b/libs/langchain/langchain_classic/evaluation/parsing/base.pyindex f529141ce6..33d7867808 100644--- a/libs/langchain/langchain_classic/evaluation/parsing/base.py+++ b/libs/langchain/langchain_classic/evaluation/parsing/base.py@@ -2,8 +2,9 @@import jsonimport logging+from collections.abc import Callablefrom operator import eq-from typing import Any, Callable, Optional, Union, cast+from typing import Any, castfrom langchain_core.utils.json import parse_json_markdownfrom typing_extensions import override@@ -119,7 +120,7 @@ class JsonEqualityEvaluator(StringEvaluator):"""- def __init__(self, operator: Optional[Callable] = None, **_: Any) -> None:+ def __init__(self, operator: Callable | None = None, **_: Any) -> None:"""Initialize the JsonEqualityEvaluator.Args:@@ -147,7 +148,7 @@ class JsonEqualityEvaluator(StringEvaluator):def _parse_json(self,string: Any,- ) -> Union[dict, list, None, float, bool, int, str]:+ ) -> dict | list | None | float | bool | int | str:if isinstance(string, str):return parse_json_markdown(string)return string@@ -156,7 +157,7 @@ class JsonEqualityEvaluator(StringEvaluator):def _evaluate_strings(self,prediction: str,- reference: Optional[str] = None,+ reference: str | None = None,**kwargs: Any,) -> dict:"""Evaluate the prediction string.diff --git a/libs/langchain/langchain_classic/evaluation/parsing/json_distance.py b/libs/langchain/langchain_classic/evaluation/parsing/json_distance.pyindex b9ca33cda6..b1167cd40c 100644--- a/libs/langchain/langchain_classic/evaluation/parsing/json_distance.py+++ b/libs/langchain/langchain_classic/evaluation/parsing/json_distance.py@@ -1,5 +1,6 @@import json-from typing import Any, Callable, Optional, Union+from collections.abc import Callable+from typing import Anyfrom langchain_core.utils.json import parse_json_markdownfrom typing_extensions import override@@ -32,8 +33,8 @@ class JsonEditDistanceEvaluator(StringEvaluator):def __init__(self,- string_distance: Optional[Callable[[str, str], float]] = None,- canonicalize: Optional[Callable[[Any], Any]] = None,+ string_distance: Callable[[str, str], float] | None = None,+ canonicalize: Callable[[Any], Any] | None = None,**_: Any,) -> None:"""Initialize the JsonEditDistanceEvaluator.@@ -90,7 +91,7 @@ class JsonEditDistanceEvaluator(StringEvaluator):def evaluation_name(self) -> str:return "json_edit_distance"- def _parse_json(self, node: Any) -> Union[dict, list, None, float, bool, int, str]:+ def _parse_json(self, node: Any) -> dict | list | None | float | bool | int | str:if isinstance(node, str):return parse_json_markdown(node)return node@@ -99,7 +100,7 @@ class JsonEditDistanceEvaluator(StringEvaluator):def _evaluate_strings(self,prediction: str,- reference: Optional[str] = None,+ reference: str | None = None,**kwargs: Any,) -> dict:parsed = self._canonicalize(self._parse_json(prediction))diff --git a/libs/langchain/langchain_classic/evaluation/parsing/json_schema.py b/libs/langchain/langchain_classic/evaluation/parsing/json_schema.pyindex 8f68a2fba1..ed533339a7 100644--- a/libs/langchain/langchain_classic/evaluation/parsing/json_schema.py+++ b/libs/langchain/langchain_classic/evaluation/parsing/json_schema.py@@ -1,4 +1,4 @@-from typing import Any, Union+from typing import Anyfrom langchain_core.utils.json import parse_json_markdownfrom typing_extensions import override@@ -64,7 +64,7 @@ class JsonSchemaEvaluator(StringEvaluator):"""Returns the name of the evaluation."""return "json_schema_validation"- def _parse_json(self, node: Any) -> Union[dict, list, None, float, bool, int, str]:+ def _parse_json(self, node: Any) -> dict | list | None | float | bool | int | str:if isinstance(node, str):return parse_json_markdown(node)if hasattr(node, "model_json_schema") and callable(node.model_json_schema):@@ -87,9 +87,9 @@ class JsonSchemaEvaluator(StringEvaluator):@overridedef _evaluate_strings(self,- prediction: Union[str, Any],- input: Union[str, Any] = None,- reference: Union[str, Any] = None,+ prediction: str | Any,+ input: str | Any = None,+ reference: str | Any = None,**kwargs: Any,) -> dict:parsed_prediction = self._parse_json(prediction)diff --git a/libs/langchain/langchain_classic/evaluation/qa/eval_chain.py b/libs/langchain/langchain_classic/evaluation/qa/eval_chain.pyindex 3f4c4d9303..eaea6f4106 100644--- a/libs/langchain/langchain_classic/evaluation/qa/eval_chain.py+++ b/libs/langchain/langchain_classic/evaluation/qa/eval_chain.py@@ -5,7 +5,7 @@ from __future__ import annotationsimport reimport stringfrom collections.abc import Sequence-from typing import Any, Optional+from typing import Anyfrom langchain_core.callbacks import Callbacksfrom langchain_core.language_models import BaseLanguageModel@@ -23,7 +23,7 @@ from langchain_classic.evaluation.schema import LLMEvalChain, StringEvaluatorfrom langchain_classic.schema import RUN_KEY-def _get_score(text: str) -> Optional[tuple[str, int]]:+def _get_score(text: str) -> tuple[str, int] | None:match = re.search(r"grade:\s*(correct|incorrect)", text.strip(), re.IGNORECASE)if match:if match.group(1).upper() == "CORRECT":@@ -107,7 +107,7 @@ class QAEvalChain(LLMChain, StringEvaluator, LLMEvalChain):def from_llm(cls,llm: BaseLanguageModel,- prompt: Optional[PromptTemplate] = None,+ prompt: PromptTemplate | None = None,**kwargs: Any,) -> QAEvalChain:"""Load QA Eval Chain from LLM.@@ -168,8 +168,8 @@ class QAEvalChain(LLMChain, StringEvaluator, LLMEvalChain):self,*,prediction: str,- reference: Optional[str] = None,- input: Optional[str] = None,+ reference: str | None = None,+ input: str | None = None,callbacks: Callbacks = None,include_run_info: bool = False,**kwargs: Any,@@ -205,8 +205,8 @@ class QAEvalChain(LLMChain, StringEvaluator, LLMEvalChain):self,*,prediction: str,- reference: Optional[str] = None,- input: Optional[str] = None,+ reference: str | None = None,+ input: str | None = None,callbacks: Callbacks = None,include_run_info: bool = False,**kwargs: Any,@@ -260,7 +260,7 @@ class ContextQAEvalChain(LLMChain, StringEvaluator, LLMEvalChain):def from_llm(cls,llm: BaseLanguageModel,- prompt: Optional[PromptTemplate] = None,+ prompt: PromptTemplate | None = None,**kwargs: Any,) -> ContextQAEvalChain:"""Load QA Eval Chain from LLM.@@ -315,8 +315,8 @@ class ContextQAEvalChain(LLMChain, StringEvaluator, LLMEvalChain):self,*,prediction: str,- reference: Optional[str] = None,- input: Optional[str] = None,+ reference: str | None = None,+ input: str | None = None,callbacks: Callbacks = None,include_run_info: bool = False,**kwargs: Any,@@ -337,8 +337,8 @@ class ContextQAEvalChain(LLMChain, StringEvaluator, LLMEvalChain):self,*,prediction: str,- reference: Optional[str] = None,- input: Optional[str] = None,+ reference: str | None = None,+ input: str | None = None,callbacks: Callbacks = None,include_run_info: bool = False,**kwargs: Any,@@ -368,7 +368,7 @@ class CotQAEvalChain(ContextQAEvalChain):def from_llm(cls,llm: BaseLanguageModel,- prompt: Optional[PromptTemplate] = None,+ prompt: PromptTemplate | None = None,**kwargs: Any,) -> CotQAEvalChain:"""Load QA Eval Chain from LLM."""diff --git a/libs/langchain/langchain_classic/evaluation/schema.py b/libs/langchain/langchain_classic/evaluation/schema.pyindex 1506035bcf..5e8139e5bc 100644--- a/libs/langchain/langchain_classic/evaluation/schema.py+++ b/libs/langchain/langchain_classic/evaluation/schema.py@@ -6,7 +6,7 @@ import loggingfrom abc import ABC, abstractmethodfrom collections.abc import Sequencefrom enum import Enum-from typing import Any, Optional, Union+from typing import Anyfrom warnings import warnfrom langchain_core.agents import AgentAction@@ -108,8 +108,8 @@ class _EvalArgsMixin:def _check_evaluation_args(self,- reference: Optional[str] = None,- input_: Optional[str] = None,+ reference: str | None = None,+ input_: str | None = None,) -> None:"""Check if the evaluation arguments are valid.@@ -154,9 +154,9 @@ class StringEvaluator(_EvalArgsMixin, ABC):def _evaluate_strings(self,*,- prediction: Union[str, Any],- reference: Optional[Union[str, Any]] = None,- input: Optional[Union[str, Any]] = None, # noqa: A002+ prediction: str | Any,+ reference: str | Any | None = None,+ input: str | Any | None = None, # noqa: A002**kwargs: Any,) -> dict:"""Evaluate Chain or LLM output, based on optional input and label.@@ -178,9 +178,9 @@ class StringEvaluator(_EvalArgsMixin, ABC):async def _aevaluate_strings(self,*,- prediction: Union[str, Any],- reference: Optional[Union[str, Any]] = None,- input: Optional[Union[str, Any]] = None, # noqa: A002+ prediction: str | Any,+ reference: str | Any | None = None,+ input: str | Any | None = None, # noqa: A002**kwargs: Any,) -> dict:"""Asynchronously evaluate Chain or LLM output, based on optional input and label.@@ -211,8 +211,8 @@ class StringEvaluator(_EvalArgsMixin, ABC):self,*,prediction: str,- reference: Optional[str] = None,- input: Optional[str] = None, # noqa: A002+ reference: str | None = None,+ input: str | None = None, # noqa: A002**kwargs: Any,) -> dict:"""Evaluate Chain or LLM output, based on optional input and label.@@ -238,8 +238,8 @@ class StringEvaluator(_EvalArgsMixin, ABC):self,*,prediction: str,- reference: Optional[str] = None,- input: Optional[str] = None, # noqa: A002+ reference: str | None = None,+ input: str | None = None, # noqa: A002**kwargs: Any,) -> dict:"""Asynchronously evaluate Chain or LLM output, based on optional input and label.@@ -271,8 +271,8 @@ class PairwiseStringEvaluator(_EvalArgsMixin, ABC):*,prediction: str,prediction_b: str,- reference: Optional[str] = None,- input: Optional[str] = None, # noqa: A002+ reference: str | None = None,+ input: str | None = None, # noqa: A002**kwargs: Any,) -> dict:"""Evaluate the output string pairs.@@ -293,8 +293,8 @@ class PairwiseStringEvaluator(_EvalArgsMixin, ABC):*,prediction: str,prediction_b: str,- reference: Optional[str] = None,- input: Optional[str] = None, # noqa: A002+ reference: str | None = None,+ input: str | None = None, # noqa: A002**kwargs: Any,) -> dict:"""Asynchronously evaluate the output string pairs.@@ -324,8 +324,8 @@ class PairwiseStringEvaluator(_EvalArgsMixin, ABC):*,prediction: str,prediction_b: str,- reference: Optional[str] = None,- input: Optional[str] = None, # noqa: A002+ reference: str | None = None,+ input: str | None = None, # noqa: A002**kwargs: Any,) -> dict:"""Evaluate the output string pairs.@@ -354,8 +354,8 @@ class PairwiseStringEvaluator(_EvalArgsMixin, ABC):*,prediction: str,prediction_b: str,- reference: Optional[str] = None,- input: Optional[str] = None, # noqa: A002+ reference: str | None = None,+ input: str | None = None, # noqa: A002**kwargs: Any,) -> dict:"""Asynchronously evaluate the output string pairs.@@ -395,7 +395,7 @@ class AgentTrajectoryEvaluator(_EvalArgsMixin, ABC):prediction: str,agent_trajectory: Sequence[tuple[AgentAction, str]],input: str, # noqa: A002- reference: Optional[str] = None,+ reference: str | None = None,**kwargs: Any,) -> dict:"""Evaluate a trajectory.@@ -418,7 +418,7 @@ class AgentTrajectoryEvaluator(_EvalArgsMixin, ABC):prediction: str,agent_trajectory: Sequence[tuple[AgentAction, str]],input: str, # noqa: A002- reference: Optional[str] = None,+ reference: str | None = None,**kwargs: Any,) -> dict:"""Asynchronously evaluate a trajectory.@@ -450,7 +450,7 @@ class AgentTrajectoryEvaluator(_EvalArgsMixin, ABC):prediction: str,agent_trajectory: Sequence[tuple[AgentAction, str]],input: str, # noqa: A002- reference: Optional[str] = None,+ reference: str | None = None,**kwargs: Any,) -> dict:"""Evaluate a trajectory.@@ -481,7 +481,7 @@ class AgentTrajectoryEvaluator(_EvalArgsMixin, ABC):prediction: str,agent_trajectory: Sequence[tuple[AgentAction, str]],input: str, # noqa: A002- reference: Optional[str] = None,+ reference: str | None = None,**kwargs: Any,) -> dict:"""Asynchronously evaluate a trajectory.diff --git a/libs/langchain/langchain_classic/evaluation/scoring/eval_chain.py b/libs/langchain/langchain_classic/evaluation/scoring/eval_chain.pyindex 61eb178291..61b12eaf96 100644--- a/libs/langchain/langchain_classic/evaluation/scoring/eval_chain.py+++ b/libs/langchain/langchain_classic/evaluation/scoring/eval_chain.py@@ -4,7 +4,7 @@ from __future__ import annotationsimport loggingimport re-from typing import Any, Optional, Union+from typing import Anyfrom langchain_core.callbacks import Callbacksfrom langchain_core.language_models import BaseLanguageModel@@ -51,7 +51,7 @@ _SUPPORTED_CRITERIA = {def resolve_criteria(- criteria: Optional[Union[CRITERIA_TYPE, str, list[CRITERIA_TYPE]]],+ criteria: CRITERIA_TYPE | str | list[CRITERIA_TYPE] | None,) -> dict:"""Resolve the criteria for the pairwise evaluator.@@ -177,7 +177,7 @@ class ScoreStringEvalChain(StringEvaluator, LLMEvalChain, LLMChain):output_parser: BaseOutputParser = Field(default_factory=ScoreStringResultOutputParser,)- normalize_by: Optional[float] = None+ normalize_by: float | None = None"""The value to normalize the score by, if specified."""criterion_name: str"""The name of the criterion being evaluated."""@@ -241,9 +241,9 @@ class ScoreStringEvalChain(StringEvaluator, LLMEvalChain, LLMChain):cls,llm: BaseLanguageModel,*,- prompt: Optional[PromptTemplate] = None,- criteria: Optional[Union[CRITERIA_TYPE, str]] = None,- normalize_by: Optional[float] = None,+ prompt: PromptTemplate | None = None,+ criteria: CRITERIA_TYPE | str | None = None,+ normalize_by: float | None = None,**kwargs: Any,) -> ScoreStringEvalChain:"""Initialize the ScoreStringEvalChain from an LLM.@@ -296,8 +296,8 @@ Performance may be significantly worse with other models.",def _prepare_input(self,prediction: str,- input_: Optional[str],- reference: Optional[str],+ input_: str | None,+ reference: str | None,) -> dict:"""Prepare the input for the chain.@@ -333,11 +333,11 @@ Performance may be significantly worse with other models.",self,*,prediction: str,- input: Optional[str] = None,- reference: Optional[str] = None,+ input: str | None = None,+ reference: str | None = None,callbacks: Callbacks = None,- tags: Optional[list[str]] = None,- metadata: Optional[dict[str, Any]] = None,+ tags: list[str] | None = None,+ metadata: dict[str, Any] | None = None,include_run_info: bool = False,**kwargs: Any,) -> dict:@@ -374,11 +374,11 @@ Performance may be significantly worse with other models.",self,*,prediction: str,- reference: Optional[str] = None,- input: Optional[str] = None,+ reference: str | None = None,+ input: str | None = None,callbacks: Callbacks = None,- tags: Optional[list[str]] = None,- metadata: Optional[dict[str, Any]] = None,+ tags: list[str] | None = None,+ metadata: dict[str, Any] | None = None,include_run_info: bool = False,**kwargs: Any,) -> dict:@@ -434,9 +434,9 @@ class LabeledScoreStringEvalChain(ScoreStringEvalChain):cls,llm: BaseLanguageModel,*,- prompt: Optional[PromptTemplate] = None,- criteria: Optional[Union[CRITERIA_TYPE, str]] = None,- normalize_by: Optional[float] = None,+ prompt: PromptTemplate | None = None,+ criteria: CRITERIA_TYPE | str | None = None,+ normalize_by: float | None = None,**kwargs: Any,) -> LabeledScoreStringEvalChain:"""Initialize the LabeledScoreStringEvalChain from an LLM.diff --git a/libs/langchain/langchain_classic/evaluation/string_distance/base.py b/libs/langchain/langchain_classic/evaluation/string_distance/base.pyindex 2c670f5098..acb8cc52ec 100644--- a/libs/langchain/langchain_classic/evaluation/string_distance/base.py+++ b/libs/langchain/langchain_classic/evaluation/string_distance/base.py@@ -1,7 +1,8 @@"""String distance evaluators based on the RapidFuzz library."""+from collections.abc import Callablefrom enum import Enum-from typing import Any, Callable, Optional+from typing import Anyfrom langchain_core.callbacks import Callbacksfrom langchain_core.callbacks.manager import (@@ -215,7 +216,7 @@ class StringDistanceEvalChain(StringEvaluator, _RapidFuzzChainMixin):def _call(self,inputs: dict[str, Any],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, Any]:"""Compute the string distance between the prediction and the reference.@@ -233,7 +234,7 @@ class StringDistanceEvalChain(StringEvaluator, _RapidFuzzChainMixin):async def _acall(self,inputs: dict[str, Any],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, Any]:"""Compute the string distance between the prediction and the reference.@@ -252,11 +253,11 @@ class StringDistanceEvalChain(StringEvaluator, _RapidFuzzChainMixin):self,*,prediction: str,- reference: Optional[str] = None,- input: Optional[str] = None,+ reference: str | None = None,+ input: str | None = None,callbacks: Callbacks = None,- tags: Optional[list[str]] = None,- metadata: Optional[dict[str, Any]] = None,+ tags: list[str] | None = None,+ metadata: dict[str, Any] | None = None,include_run_info: bool = False,**kwargs: Any,) -> dict:@@ -290,11 +291,11 @@ class StringDistanceEvalChain(StringEvaluator, _RapidFuzzChainMixin):self,*,prediction: str,- reference: Optional[str] = None,- input: Optional[str] = None,+ reference: str | None = None,+ input: str | None = None,callbacks: Callbacks = None,- tags: Optional[list[str]] = None,- metadata: Optional[dict[str, Any]] = None,+ tags: list[str] | None = None,+ metadata: dict[str, Any] | None = None,include_run_info: bool = False,**kwargs: Any,) -> dict:@@ -348,7 +349,7 @@ class PairwiseStringDistanceEvalChain(PairwiseStringEvaluator, _RapidFuzzChainMidef _call(self,inputs: dict[str, Any],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, Any]:"""Compute the string distance between two predictions.@@ -368,7 +369,7 @@ class PairwiseStringDistanceEvalChain(PairwiseStringEvaluator, _RapidFuzzChainMiasync def _acall(self,inputs: dict[str, Any],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, Any]:"""Asynchronously compute the string distance between two predictions.@@ -391,8 +392,8 @@ class PairwiseStringDistanceEvalChain(PairwiseStringEvaluator, _RapidFuzzChainMiprediction: str,prediction_b: str,callbacks: Callbacks = None,- tags: Optional[list[str]] = None,- metadata: Optional[dict[str, Any]] = None,+ tags: list[str] | None = None,+ metadata: dict[str, Any] | None = None,include_run_info: bool = False,**kwargs: Any,) -> dict:@@ -426,8 +427,8 @@ class PairwiseStringDistanceEvalChain(PairwiseStringEvaluator, _RapidFuzzChainMiprediction: str,prediction_b: str,callbacks: Callbacks = None,- tags: Optional[list[str]] = None,- metadata: Optional[dict[str, Any]] = None,+ tags: list[str] | None = None,+ metadata: dict[str, Any] | None = None,include_run_info: bool = False,**kwargs: Any,) -> dict:diff --git a/libs/langchain/langchain_classic/hub.py b/libs/langchain/langchain_classic/hub.pyindex eacc61c2dc..be61be67df 100644--- a/libs/langchain/langchain_classic/hub.py+++ b/libs/langchain/langchain_classic/hub.py@@ -4,7 +4,7 @@ from __future__ import annotationsimport jsonfrom collections.abc import Sequence-from typing import Any, Optional+from typing import Anyfrom langchain_core.load.dump import dumpsfrom langchain_core.load.load import loads@@ -12,8 +12,8 @@ from langchain_core.prompts import BasePromptTemplatedef _get_client(- api_key: Optional[str] = None,- api_url: Optional[str] = None,+ api_key: str | None = None,+ api_url: str | None = None,) -> Any:try:from langsmith import Client as LangSmithClient@@ -41,13 +41,13 @@ def push(repo_full_name: str,object: Any, # noqa: A002*,- api_url: Optional[str] = None,- api_key: Optional[str] = None,- parent_commit_hash: Optional[str] = None,+ api_url: str | None = None,+ api_key: str | None = None,+ parent_commit_hash: str | None = None,new_repo_is_public: bool = False,- new_repo_description: Optional[str] = None,- readme: Optional[str] = None,- tags: Optional[Sequence[str]] = None,+ new_repo_description: str | None = None,+ readme: str | None = None,+ tags: Sequence[str] | None = None,) -> str:"""Push an object to the hub and returns the URL it can be viewed at in a browser.@@ -92,9 +92,9 @@ def push(def pull(owner_repo_commit: str,*,- include_model: Optional[bool] = None,- api_url: Optional[str] = None,- api_key: Optional[str] = None,+ include_model: bool | None = None,+ api_url: str | None = None,+ api_key: str | None = None,) -> Any:"""Pull an object from the hub and returns it as a LangChain object.diff --git a/libs/langchain/langchain_classic/indexes/_sql_record_manager.py b/libs/langchain/langchain_classic/indexes/_sql_record_manager.pyindex 707bb7d54e..c5dbcfd8a6 100644--- a/libs/langchain/langchain_classic/indexes/_sql_record_manager.py+++ b/libs/langchain/langchain_classic/indexes/_sql_record_manager.py@@ -18,7 +18,7 @@ import contextlibimport decimalimport uuidfrom collections.abc import AsyncGenerator, Generator, Sequence-from typing import Any, Optional, Union+from typing import Anyfrom langchain_core.indexing import RecordManagerfrom sqlalchemy import (@@ -89,9 +89,9 @@ class SQLRecordManager(RecordManager):self,namespace: str,*,- engine: Optional[Union[Engine, AsyncEngine]] = None,- db_url: Union[None, str, URL] = None,- engine_kwargs: Optional[dict[str, Any]] = None,+ engine: Engine | AsyncEngine | None = None,+ db_url: None | str | URL = None,+ engine_kwargs: dict[str, Any] | None = None,async_mode: bool = False,) -> None:"""Initialize the SQLRecordManager.@@ -126,7 +126,7 @@ class SQLRecordManager(RecordManager):msg = "Must specify either db_url or engine, not both"raise ValueError(msg)- _engine: Union[Engine, AsyncEngine]+ _engine: Engine | AsyncEngineif db_url:if async_mode:_engine = create_async_engine(db_url, **(engine_kwargs or {}))@@ -139,7 +139,7 @@ class SQLRecordManager(RecordManager):msg = "Something went wrong with configuration of engine."raise AssertionError(msg)- _session_factory: Union[sessionmaker[Session], async_sessionmaker[AsyncSession]]+ _session_factory: sessionmaker[Session] | async_sessionmaker[AsyncSession]if isinstance(_engine, AsyncEngine):_session_factory = async_sessionmaker(bind=_engine)else:@@ -258,8 +258,8 @@ class SQLRecordManager(RecordManager):self,keys: Sequence[str],*,- group_ids: Optional[Sequence[Optional[str]]] = None,- time_at_least: Optional[float] = None,+ group_ids: Sequence[str | None] | None = None,+ time_at_least: float | None = None,) -> None:"""Upsert records into the SQLite database."""if group_ids is None:@@ -293,7 +293,7 @@ class SQLRecordManager(RecordManager):"updated_at": update_time,"group_id": group_id,}- for key, group_id in zip(keys, group_ids)+ for key, group_id in zip(keys, group_ids, strict=False)]with self._make_session() as session:@@ -340,8 +340,8 @@ class SQLRecordManager(RecordManager):self,keys: Sequence[str],*,- group_ids: Optional[Sequence[Optional[str]]] = None,- time_at_least: Optional[float] = None,+ group_ids: Sequence[str | None] | None = None,+ time_at_least: float | None = None,) -> None:"""Upsert records into the SQLite database."""if group_ids is None:@@ -375,7 +375,7 @@ class SQLRecordManager(RecordManager):"updated_at": update_time,"group_id": group_id,}- for key, group_id in zip(keys, group_ids)+ for key, group_id in zip(keys, group_ids, strict=False)]async with self._amake_session() as session:@@ -455,10 +455,10 @@ class SQLRecordManager(RecordManager):def list_keys(self,*,- before: Optional[float] = None,- after: Optional[float] = None,- group_ids: Optional[Sequence[str]] = None,- limit: Optional[int] = None,+ before: float | None = None,+ after: float | None = None,+ group_ids: Sequence[str] | None = None,+ limit: int | None = None,) -> list[str]:"""List records in the SQLite database based on the provided date range."""session: Session@@ -482,10 +482,10 @@ class SQLRecordManager(RecordManager):async def alist_keys(self,*,- before: Optional[float] = None,- after: Optional[float] = None,- group_ids: Optional[Sequence[str]] = None,- limit: Optional[int] = None,+ before: float | None = None,+ after: float | None = None,+ group_ids: Sequence[str] | None = None,+ limit: int | None = None,) -> list[str]:"""List records in the SQLite database based on the provided date range."""session: AsyncSessiondiff --git a/libs/langchain/langchain_classic/indexes/vectorstore.py b/libs/langchain/langchain_classic/indexes/vectorstore.pyindex c337472fca..d23951d0da 100644--- a/libs/langchain/langchain_classic/indexes/vectorstore.py+++ b/libs/langchain/langchain_classic/indexes/vectorstore.py@@ -1,6 +1,6 @@"""Vectorstore stubs for the indexing api."""-from typing import Any, Optional+from typing import Anyfrom langchain_core.document_loaders import BaseLoaderfrom langchain_core.documents import Document@@ -34,8 +34,8 @@ class VectorStoreIndexWrapper(BaseModel):def query(self,question: str,- llm: Optional[BaseLanguageModel] = None,- retriever_kwargs: Optional[dict[str, Any]] = None,+ llm: BaseLanguageModel | None = None,+ retriever_kwargs: dict[str, Any] | None = None,**kwargs: Any,) -> str:"""Query the vectorstore using the provided LLM.@@ -69,8 +69,8 @@ class VectorStoreIndexWrapper(BaseModel):async def aquery(self,question: str,- llm: Optional[BaseLanguageModel] = None,- retriever_kwargs: Optional[dict[str, Any]] = None,+ llm: BaseLanguageModel | None = None,+ retriever_kwargs: dict[str, Any] | None = None,**kwargs: Any,) -> str:"""Asynchronously query the vectorstore using the provided LLM.@@ -104,8 +104,8 @@ class VectorStoreIndexWrapper(BaseModel):def query_with_sources(self,question: str,- llm: Optional[BaseLanguageModel] = None,- retriever_kwargs: Optional[dict[str, Any]] = None,+ llm: BaseLanguageModel | None = None,+ retriever_kwargs: dict[str, Any] | None = None,**kwargs: Any,) -> dict:"""Query the vectorstore and retrieve the answer along with sources.@@ -139,8 +139,8 @@ class VectorStoreIndexWrapper(BaseModel):async def aquery_with_sources(self,question: str,- llm: Optional[BaseLanguageModel] = None,- retriever_kwargs: Optional[dict[str, Any]] = None,+ llm: BaseLanguageModel | None = None,+ retriever_kwargs: dict[str, Any] | None = None,**kwargs: Any,) -> dict:"""Asynchronously query the vectorstore and retrieve the answer and sources.diff --git a/libs/langchain/langchain_classic/llms/__init__.py b/libs/langchain/langchain_classic/llms/__init__.pyindex 35f01a9b41..0d5fc5b8d1 100644--- a/libs/langchain/langchain_classic/llms/__init__.py+++ b/libs/langchain/langchain_classic/llms/__init__.py@@ -19,7 +19,8 @@""" # noqa: E501import warnings-from typing import Any, Callable+from collections.abc import Callable+from typing import Anyfrom langchain_core._api import LangChainDeprecationWarningfrom langchain_core.language_models.llms import BaseLLMdiff --git a/libs/langchain/langchain_classic/memory/buffer.py b/libs/langchain/langchain_classic/memory/buffer.pyindex 60b58ccf28..c356b70da0 100644--- a/libs/langchain/langchain_classic/memory/buffer.py+++ b/libs/langchain/langchain_classic/memory/buffer.py@@ -1,4 +1,4 @@-from typing import Any, Optional+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.memory import BaseMemory@@ -116,8 +116,8 @@ class ConversationStringBufferMemory(BaseMemory):ai_prefix: str = "AI""""Prefix to use for AI generated responses."""buffer: str = ""- output_key: Optional[str] = None- input_key: Optional[str] = None+ output_key: str | None = None+ input_key: str | None = Nonememory_key: str = "history" #: :meta private:@pre_initdiff --git a/libs/langchain/langchain_classic/memory/buffer_window.py b/libs/langchain/langchain_classic/memory/buffer_window.pyindex 839c6eb7b4..264a836caa 100644--- a/libs/langchain/langchain_classic/memory/buffer_window.py+++ b/libs/langchain/langchain_classic/memory/buffer_window.py@@ -1,4 +1,4 @@-from typing import Any, Union+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.messages import BaseMessage, get_buffer_string@@ -29,7 +29,7 @@ class ConversationBufferWindowMemory(BaseChatMemory):"""Number of messages to store in buffer."""@property- def buffer(self) -> Union[str, list[BaseMessage]]:+ def buffer(self) -> str | list[BaseMessage]:"""String buffer of memory."""return self.buffer_as_messages if self.return_messages else self.buffer_as_strdiff --git a/libs/langchain/langchain_classic/memory/chat_memory.py b/libs/langchain/langchain_classic/memory/chat_memory.pyindex a170d467de..5a86a78024 100644--- a/libs/langchain/langchain_classic/memory/chat_memory.py+++ b/libs/langchain/langchain_classic/memory/chat_memory.py@@ -1,6 +1,6 @@import warningsfrom abc import ABC-from typing import Any, Optional+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.chat_history import (@@ -36,8 +36,8 @@ class BaseChatMemory(BaseMemory, ABC):chat_memory: BaseChatMessageHistory = Field(default_factory=InMemoryChatMessageHistory,)- output_key: Optional[str] = None- input_key: Optional[str] = None+ output_key: str | None = None+ input_key: str | None = Nonereturn_messages: bool = Falsedef _get_input_output(diff --git a/libs/langchain/langchain_classic/memory/entity.py b/libs/langchain/langchain_classic/memory/entity.pyindex a38a835336..3b45140792 100644--- a/libs/langchain/langchain_classic/memory/entity.py+++ b/libs/langchain/langchain_classic/memory/entity.py@@ -4,7 +4,7 @@ import loggingfrom abc import ABC, abstractmethodfrom collections.abc import Iterablefrom itertools import islice-from typing import TYPE_CHECKING, Any, Optional+from typing import TYPE_CHECKING, Anyfrom langchain_core._api import deprecatedfrom langchain_core.language_models import BaseLanguageModel@@ -39,11 +39,11 @@ class BaseEntityStore(BaseModel, ABC):"""Abstract base class for Entity store."""@abstractmethod- def get(self, key: str, default: Optional[str] = None) -> Optional[str]:+ def get(self, key: str, default: str | None = None) -> str | None:"""Get entity value from store."""@abstractmethod- def set(self, key: str, value: Optional[str]) -> None:+ def set(self, key: str, value: str | None) -> None:"""Set entity value in store."""@abstractmethod@@ -70,14 +70,14 @@ class BaseEntityStore(BaseModel, ABC):class InMemoryEntityStore(BaseEntityStore):"""In-memory Entity store."""- store: dict[str, Optional[str]] = {}+ store: dict[str, str | None] = {}@override- def get(self, key: str, default: Optional[str] = None) -> Optional[str]:+ def get(self, key: str, default: str | None = None) -> str | None:return self.store.get(key, default)@override- def set(self, key: str, value: Optional[str]) -> None:+ def set(self, key: str, value: str | None) -> None:self.store[key] = value@override@@ -114,8 +114,8 @@ class UpstashRedisEntityStore(BaseEntityStore):url: str = "",token: str = "",key_prefix: str = "memory_store",- ttl: Optional[int] = 60 * 60 * 24,- recall_ttl: Optional[int] = 60 * 60 * 24 * 3,+ ttl: int | None = 60 * 60 * 24,+ recall_ttl: int | None = 60 * 60 * 24 * 3,*args: Any,**kwargs: Any,):@@ -160,7 +160,7 @@ class UpstashRedisEntityStore(BaseEntityStore):return f"{self.key_prefix}:{self.session_id}"@override- def get(self, key: str, default: Optional[str] = None) -> Optional[str]:+ def get(self, key: str, default: str | None = None) -> str | None:res = (self.redis_client.getex(f"{self.full_key_prefix}:{key}", ex=self.recall_ttl)or default@@ -172,7 +172,7 @@ class UpstashRedisEntityStore(BaseEntityStore):return res@override- def set(self, key: str, value: Optional[str]) -> None:+ def set(self, key: str, value: str | None) -> None:if not value:return self.delete(key)self.redis_client.set(f"{self.full_key_prefix}:{key}", value, ex=self.ttl)@@ -226,16 +226,16 @@ class RedisEntityStore(BaseEntityStore):redis_client: Anysession_id: str = "default"key_prefix: str = "memory_store"- ttl: Optional[int] = 60 * 60 * 24- recall_ttl: Optional[int] = 60 * 60 * 24 * 3+ ttl: int | None = 60 * 60 * 24+ recall_ttl: int | None = 60 * 60 * 24 * 3def __init__(self,session_id: str = "default",url: str = "redis://localhost:6379/0",key_prefix: str = "memory_store",- ttl: Optional[int] = 60 * 60 * 24,- recall_ttl: Optional[int] = 60 * 60 * 24 * 3,+ ttl: int | None = 60 * 60 * 24,+ recall_ttl: int | None = 60 * 60 * 24 * 3,*args: Any,**kwargs: Any,):@@ -286,7 +286,7 @@ class RedisEntityStore(BaseEntityStore):return f"{self.key_prefix}:{self.session_id}"@override- def get(self, key: str, default: Optional[str] = None) -> Optional[str]:+ def get(self, key: str, default: str | None = None) -> str | None:res = (self.redis_client.getex(f"{self.full_key_prefix}:{key}", ex=self.recall_ttl)or default@@ -296,7 +296,7 @@ class RedisEntityStore(BaseEntityStore):return res@override- def set(self, key: str, value: Optional[str]) -> None:+ def set(self, key: str, value: str | None) -> None:if not value:return self.delete(key)self.redis_client.set(f"{self.full_key_prefix}:{key}", value, ex=self.ttl)@@ -410,7 +410,7 @@ class SQLiteEntityStore(BaseEntityStore):"""self._execute_query(create_table_query)- def get(self, key: str, default: Optional[str] = None) -> Optional[str]:+ def get(self, key: str, default: str | None = None) -> str | None:"""Retrieves a value, safely quoting the table name."""# `?` placeholder is used for the value to prevent SQL injection# Ignore S608 since we validate for malicious table/session names in `__init__`@@ -419,7 +419,7 @@ class SQLiteEntityStore(BaseEntityStore):result = cursor.fetchone()return result[0] if result is not None else default- def set(self, key: str, value: Optional[str]) -> None:+ def set(self, key: str, value: str | None) -> None:"""Inserts or replaces a value, safely quoting the table name."""if not value:return self.delete(key)diff --git a/libs/langchain/langchain_classic/memory/summary_buffer.py b/libs/langchain/langchain_classic/memory/summary_buffer.pyindex e42991169a..fffcceb27b 100644--- a/libs/langchain/langchain_classic/memory/summary_buffer.py+++ b/libs/langchain/langchain_classic/memory/summary_buffer.py@@ -1,4 +1,4 @@-from typing import Any, Union+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.messages import BaseMessage, get_buffer_string@@ -30,11 +30,11 @@ class ConversationSummaryBufferMemory(BaseChatMemory, SummarizerMixin):memory_key: str = "history"@property- def buffer(self) -> Union[str, list[BaseMessage]]:+ def buffer(self) -> str | list[BaseMessage]:"""String buffer of memory."""return self.load_memory_variables({})[self.memory_key]- async def abuffer(self) -> Union[str, list[BaseMessage]]:+ async def abuffer(self) -> str | list[BaseMessage]:"""Async memory buffer."""memory_variables = await self.aload_memory_variables({})return memory_variables[self.memory_key]diff --git a/libs/langchain/langchain_classic/memory/vectorstore.py b/libs/langchain/langchain_classic/memory/vectorstore.pyindex b9be9f68ff..ce09cb3a3a 100644--- a/libs/langchain/langchain_classic/memory/vectorstore.py+++ b/libs/langchain/langchain_classic/memory/vectorstore.py@@ -1,7 +1,7 @@"""Class for a VectorStore-backed memory object."""from collections.abc import Sequence-from typing import Any, Optional, Union+from typing import Anyfrom langchain_core._api import deprecatedfrom langchain_core.documents import Document@@ -33,7 +33,7 @@ class VectorStoreRetrieverMemory(BaseMemory):memory_key: str = "history" #: :meta private:"""Key name to locate the memories in the result of load_memory_variables."""- input_key: Optional[str] = None+ input_key: str | None = None"""Key name to index the inputs to load_memory_variables."""return_docs: bool = False@@ -56,8 +56,8 @@ class VectorStoreRetrieverMemory(BaseMemory):def _documents_to_memory_variables(self,docs: list[Document],- ) -> dict[str, Union[list[Document], str]]:- result: Union[list[Document], str]+ ) -> dict[str, list[Document] | str]:+ result: list[Document] | strif not self.return_docs:result = "\n".join([doc.page_content for doc in docs])else:@@ -67,7 +67,7 @@ class VectorStoreRetrieverMemory(BaseMemory):def load_memory_variables(self,inputs: dict[str, Any],- ) -> dict[str, Union[list[Document], str]]:+ ) -> dict[str, list[Document] | str]:"""Return history buffer."""input_key = self._get_prompt_input_key(inputs)query = inputs[input_key]@@ -77,7 +77,7 @@ class VectorStoreRetrieverMemory(BaseMemory):async def aload_memory_variables(self,inputs: dict[str, Any],- ) -> dict[str, Union[list[Document], str]]:+ ) -> dict[str, list[Document] | str]:"""Return history buffer."""input_key = self._get_prompt_input_key(inputs)query = inputs[input_key]diff --git a/libs/langchain/langchain_classic/memory/vectorstore_token_buffer_memory.py b/libs/langchain/langchain_classic/memory/vectorstore_token_buffer_memory.pyindex 713b1cfff0..525b322b47 100644--- a/libs/langchain/langchain_classic/memory/vectorstore_token_buffer_memory.py+++ b/libs/langchain/langchain_classic/memory/vectorstore_token_buffer_memory.py@@ -8,7 +8,7 @@ sessions.import warningsfrom datetime import datetime-from typing import Any, Optional+from typing import Anyfrom langchain_core.messages import BaseMessagefrom langchain_core.prompts.chat import SystemMessagePromptTemplate@@ -112,7 +112,7 @@ class ConversationVectorStoreTokenBufferMemory(ConversationTokenBufferMemory):previous_history_template: str = DEFAULT_HISTORY_TEMPLATEsplit_chunk_size: int = 1000- _memory_retriever: Optional[VectorStoreRetrieverMemory] = PrivateAttr(default=None)+ _memory_retriever: VectorStoreRetrieverMemory | None = PrivateAttr(default=None)_timestamps: list[datetime] = PrivateAttr(default_factory=list)@propertydiff --git a/libs/langchain/langchain_classic/model_laboratory.py b/libs/langchain/langchain_classic/model_laboratory.pyindex 7b4737c658..ae4494aefb 100644--- a/libs/langchain/langchain_classic/model_laboratory.py+++ b/libs/langchain/langchain_classic/model_laboratory.py@@ -3,7 +3,6 @@from __future__ import annotationsfrom collections.abc import Sequence-from typing import Optionalfrom langchain_core.language_models.llms import BaseLLMfrom langchain_core.prompts.prompt import PromptTemplate@@ -16,7 +15,7 @@ from langchain_classic.chains.llm import LLMChainclass ModelLaboratory:"""A utility to experiment with and compare the performance of different models."""- def __init__(self, chains: Sequence[Chain], names: Optional[list[str]] = None):+ def __init__(self, chains: Sequence[Chain], names: list[str] | None = None):"""Initialize the ModelLaboratory with chains to experiment with.Args:@@ -63,7 +62,7 @@ class ModelLaboratory:def from_llms(cls,llms: list[BaseLLM],- prompt: Optional[PromptTemplate] = None,+ prompt: PromptTemplate | None = None,) -> ModelLaboratory:"""Initialize the ModelLaboratory with LLMs and an optional prompt.diff --git a/libs/langchain/langchain_classic/output_parsers/combining.py b/libs/langchain/langchain_classic/output_parsers/combining.pyindex e5fde8817c..6e26864936 100644--- a/libs/langchain/langchain_classic/output_parsers/combining.py+++ b/libs/langchain/langchain_classic/output_parsers/combining.py@@ -53,6 +53,6 @@ class CombiningOutputParser(BaseOutputParser[dict[str, Any]]):"""Parse the output of an LLM call."""texts = text.split("\n\n")output = {}- for txt, parser in zip(texts, self.parsers):+ for txt, parser in zip(texts, self.parsers, strict=False):output.update(parser.parse(txt.strip()))return outputdiff --git a/libs/langchain/langchain_classic/output_parsers/fix.py b/libs/langchain/langchain_classic/output_parsers/fix.pyindex cbe4ef630c..32a1222252 100644--- a/libs/langchain/langchain_classic/output_parsers/fix.py+++ b/libs/langchain/langchain_classic/output_parsers/fix.py@@ -1,6 +1,6 @@from __future__ import annotations-from typing import Annotated, Any, TypeVar, Union+from typing import Annotated, Any, TypeVarfrom langchain_core.exceptions import OutputParserExceptionfrom langchain_core.output_parsers import BaseOutputParser, StrOutputParser@@ -35,7 +35,7 @@ class OutputFixingParser(BaseOutputParser[T]):# Should be an LLMChain but we want to avoid top-level imports from# langchain_classic.chainsretry_chain: Annotated[- Union[RunnableSerializable[OutputFixingParserRetryChainInput, str], Any],+ RunnableSerializable[OutputFixingParserRetryChainInput, str] | Any,SkipValidation(),]"""The RunnableSerializable to use to retry the completion (Legacy: LLMChain)."""diff --git a/libs/langchain/langchain_classic/output_parsers/pandas_dataframe.py b/libs/langchain/langchain_classic/output_parsers/pandas_dataframe.pyindex a90bb631d1..05c08884ee 100644--- a/libs/langchain/langchain_classic/output_parsers/pandas_dataframe.py+++ b/libs/langchain/langchain_classic/output_parsers/pandas_dataframe.py@@ -1,5 +1,5 @@import re-from typing import Any, Union+from typing import Anyfrom langchain_core.exceptions import OutputParserExceptionfrom langchain_core.output_parsers.base import BaseOutputParser@@ -36,7 +36,7 @@ class PandasDataFrameOutputParser(BaseOutputParser[dict[str, Any]]):self,array: str,original_request_params: str,- ) -> tuple[list[Union[int, str]], str]:+ ) -> tuple[list[int | str], str]:"""Parse the array from the request parameters.Args:@@ -49,7 +49,7 @@ class PandasDataFrameOutputParser(BaseOutputParser[dict[str, Any]]):Raises:OutputParserException: If the array format is invalid or cannot be parsed."""- parsed_array: list[Union[int, str]] = []+ parsed_array: list[int | str] = []# Check if the format is [1,3,5]if re.match(r"\[\d+(,\s*\d+)*\]", array):diff --git a/libs/langchain/langchain_classic/output_parsers/regex.py b/libs/langchain/langchain_classic/output_parsers/regex.pyindex 9b3657e4bf..94d700a1f6 100644--- a/libs/langchain/langchain_classic/output_parsers/regex.py+++ b/libs/langchain/langchain_classic/output_parsers/regex.py@@ -1,7 +1,6 @@from __future__ import annotationsimport re-from typing import Optionalfrom langchain_core.output_parsers import BaseOutputParserfrom typing_extensions import override@@ -19,7 +18,7 @@ class RegexParser(BaseOutputParser[dict[str, str]]):"""The regex to use to parse the output."""output_keys: list[str]"""The keys to use for the output."""- default_output_key: Optional[str] = None+ default_output_key: str | None = None"""The default key to use for the output."""@propertydiff --git a/libs/langchain/langchain_classic/output_parsers/regex_dict.py b/libs/langchain/langchain_classic/output_parsers/regex_dict.pyindex b61e5149ac..5bcafb3715 100644--- a/libs/langchain/langchain_classic/output_parsers/regex_dict.py+++ b/libs/langchain/langchain_classic/output_parsers/regex_dict.py@@ -1,7 +1,6 @@from __future__ import annotationsimport re-from typing import Optionalfrom langchain_core.output_parsers import BaseOutputParser@@ -13,7 +12,7 @@ class RegexDictParser(BaseOutputParser[dict[str, str]]):"""The regex pattern to use to parse the output."""output_key_to_format: dict[str, str]"""The keys to use for the output."""- no_update_value: Optional[str] = None+ no_update_value: str | None = None"""The default key to use for the output."""@propertydiff --git a/libs/langchain/langchain_classic/output_parsers/retry.py b/libs/langchain/langchain_classic/output_parsers/retry.pyindex 1401321650..88c5d73743 100644--- a/libs/langchain/langchain_classic/output_parsers/retry.py+++ b/libs/langchain/langchain_classic/output_parsers/retry.py@@ -1,6 +1,6 @@from __future__ import annotations-from typing import Annotated, Any, TypeVar, Union+from typing import Annotated, Any, TypeVarfrom langchain_core.exceptions import OutputParserExceptionfrom langchain_core.language_models import BaseLanguageModel@@ -63,7 +63,7 @@ class RetryOutputParser(BaseOutputParser[T]):# Should be an LLMChain but we want to avoid top-level imports from# langchain_classic.chainsretry_chain: Annotated[- Union[RunnableSerializable[RetryOutputParserRetryChainInput, str], Any],+ RunnableSerializable[RetryOutputParserRetryChainInput, str] | Any,SkipValidation(),]"""The RunnableSerializable to use to retry the completion (Legacy: LLMChain)."""@@ -199,10 +199,7 @@ class RetryWithErrorOutputParser(BaseOutputParser[T]):# Should be an LLMChain but we want to avoid top-level imports from# langchain_classic.chainsretry_chain: Annotated[- Union[- RunnableSerializable[RetryWithErrorOutputParserRetryChainInput, str],- Any,- ],+ RunnableSerializable[RetryWithErrorOutputParserRetryChainInput, str] | Any,SkipValidation(),]"""The RunnableSerializable to use to retry the completion (Legacy: LLMChain)."""diff --git a/libs/langchain/langchain_classic/retrievers/document_compressors/base.py b/libs/langchain/langchain_classic/retrievers/document_compressors/base.pyindex 5f4daef678..39c0c2074b 100644--- a/libs/langchain/langchain_classic/retrievers/document_compressors/base.py+++ b/libs/langchain/langchain_classic/retrievers/document_compressors/base.py@@ -1,6 +1,5 @@from collections.abc import Sequencefrom inspect import signature-from typing import Optional, Unionfrom langchain_core.callbacks import Callbacksfrom langchain_core.documents import (@@ -14,7 +13,7 @@ from pydantic import ConfigDictclass DocumentCompressorPipeline(BaseDocumentCompressor):"""Document compressor that uses a pipeline of Transformers."""- transformers: list[Union[BaseDocumentTransformer, BaseDocumentCompressor]]+ transformers: list[BaseDocumentTransformer | BaseDocumentCompressor]"""List of document filters that are chained together and run in sequence."""model_config = ConfigDict(@@ -25,7 +24,7 @@ class DocumentCompressorPipeline(BaseDocumentCompressor):self,documents: Sequence[Document],query: str,- callbacks: Optional[Callbacks] = None,+ callbacks: Callbacks | None = None,) -> Sequence[Document]:"""Transform a list of documents."""for _transformer in self.transformers:@@ -55,7 +54,7 @@ class DocumentCompressorPipeline(BaseDocumentCompressor):self,documents: Sequence[Document],query: str,- callbacks: Optional[Callbacks] = None,+ callbacks: Callbacks | None = None,) -> Sequence[Document]:"""Compress retrieved documents given the query context."""for _transformer in self.transformers:diff --git a/libs/langchain/langchain_classic/retrievers/document_compressors/chain_extract.py b/libs/langchain/langchain_classic/retrievers/document_compressors/chain_extract.pyindex 57bdd190a0..d1d3da3ad1 100644--- a/libs/langchain/langchain_classic/retrievers/document_compressors/chain_extract.py+++ b/libs/langchain/langchain_classic/retrievers/document_compressors/chain_extract.py@@ -2,8 +2,8 @@from __future__ import annotations-from collections.abc import Sequence-from typing import Any, Callable, Optional, cast+from collections.abc import Callable, Sequence+from typing import Any, castfrom langchain_core.callbacks import Callbacksfrom langchain_core.documents import BaseDocumentCompressor, Document@@ -69,7 +69,7 @@ class LLMChainExtractor(BaseDocumentCompressor):self,documents: Sequence[Document],query: str,- callbacks: Optional[Callbacks] = None,+ callbacks: Callbacks | None = None,) -> Sequence[Document]:"""Compress page content of raw documents."""compressed_docs = []@@ -93,7 +93,7 @@ class LLMChainExtractor(BaseDocumentCompressor):self,documents: Sequence[Document],query: str,- callbacks: Optional[Callbacks] = None,+ callbacks: Callbacks | None = None,) -> Sequence[Document]:"""Compress page content of raw documents asynchronously."""inputs = [self.get_input(query, doc) for doc in documents]@@ -111,9 +111,9 @@ class LLMChainExtractor(BaseDocumentCompressor):def from_llm(cls,llm: BaseLanguageModel,- prompt: Optional[PromptTemplate] = None,- get_input: Optional[Callable[[str, Document], str]] = None,- llm_chain_kwargs: Optional[dict] = None, # noqa: ARG003+ prompt: PromptTemplate | None = None,+ get_input: Callable[[str, Document], str] | None = None,+ llm_chain_kwargs: dict | None = None, # noqa: ARG003) -> LLMChainExtractor:"""Initialize from LLM."""_prompt = prompt if prompt is not None else _get_default_chain_prompt()diff --git a/libs/langchain/langchain_classic/retrievers/document_compressors/chain_filter.py b/libs/langchain/langchain_classic/retrievers/document_compressors/chain_filter.pyindex a4053c2cc9..b4c41cda5c 100644--- a/libs/langchain/langchain_classic/retrievers/document_compressors/chain_filter.py+++ b/libs/langchain/langchain_classic/retrievers/document_compressors/chain_filter.py@@ -1,7 +1,7 @@"""Filter that uses an LLM to drop documents that aren't relevant to the query."""-from collections.abc import Sequence-from typing import Any, Callable, Optional+from collections.abc import Callable, Sequence+from typing import Anyfrom langchain_core.callbacks import Callbacksfrom langchain_core.documents import BaseDocumentCompressor, Document@@ -50,7 +50,7 @@ class LLMChainFilter(BaseDocumentCompressor):self,documents: Sequence[Document],query: str,- callbacks: Optional[Callbacks] = None,+ callbacks: Callbacks | None = None,) -> Sequence[Document]:"""Filter down documents based on their relevance to the query."""filtered_docs = []@@ -62,6 +62,7 @@ class LLMChainFilter(BaseDocumentCompressor):config=config,),documents,+ strict=False,)for output_, doc in outputs:@@ -81,7 +82,7 @@ class LLMChainFilter(BaseDocumentCompressor):self,documents: Sequence[Document],query: str,- callbacks: Optional[Callbacks] = None,+ callbacks: Callbacks | None = None,) -> Sequence[Document]:"""Filter down documents based on their relevance to the query."""filtered_docs = []@@ -93,6 +94,7 @@ class LLMChainFilter(BaseDocumentCompressor):config=config,),documents,+ strict=False,)for output_, doc in outputs:include_doc = None@@ -111,7 +113,7 @@ class LLMChainFilter(BaseDocumentCompressor):def from_llm(cls,llm: BaseLanguageModel,- prompt: Optional[BasePromptTemplate] = None,+ prompt: BasePromptTemplate | None = None,**kwargs: Any,) -> "LLMChainFilter":"""Create a LLMChainFilter from a language model.diff --git a/libs/langchain/langchain_classic/retrievers/document_compressors/cohere_rerank.py b/libs/langchain/langchain_classic/retrievers/document_compressors/cohere_rerank.pyindex 6f0d55ec57..8907911671 100644--- a/libs/langchain/langchain_classic/retrievers/document_compressors/cohere_rerank.py+++ b/libs/langchain/langchain_classic/retrievers/document_compressors/cohere_rerank.py@@ -2,7 +2,7 @@ from __future__ import annotationsfrom collections.abc import Sequencefrom copy import deepcopy-from typing import Any, Optional, Union+from typing import Anyfrom langchain_core._api.deprecation import deprecatedfrom langchain_core.callbacks import Callbacks@@ -22,11 +22,11 @@ class CohereRerank(BaseDocumentCompressor):client: Any = None"""Cohere client to use for compressing documents."""- top_n: Optional[int] = 3+ top_n: int | None = 3"""Number of documents to return."""model: str = "rerank-english-v2.0""""Model to use for reranking."""- cohere_api_key: Optional[str] = None+ cohere_api_key: str | None = None"""Cohere API key. Must be specified directly or via environment variableCOHERE_API_KEY."""user_agent: str = "langchain"@@ -61,12 +61,12 @@ class CohereRerank(BaseDocumentCompressor):def rerank(self,- documents: Sequence[Union[str, Document, dict]],+ documents: Sequence[str | Document | dict],query: str,*,- model: Optional[str] = None,- top_n: Optional[int] = -1,- max_chunks_per_doc: Optional[int] = None,+ model: str | None = None,+ top_n: int | None = -1,+ max_chunks_per_doc: int | None = None,) -> list[dict[str, Any]]:"""Returns an ordered list of documents ordered by their relevance to the provided query.@@ -104,7 +104,7 @@ class CohereRerank(BaseDocumentCompressor):self,documents: Sequence[Document],query: str,- callbacks: Optional[Callbacks] = None,+ callbacks: Callbacks | None = None,) -> Sequence[Document]:"""Compress documents using Cohere's rerank API.diff --git a/libs/langchain/langchain_classic/retrievers/document_compressors/cross_encoder_rerank.py b/libs/langchain/langchain_classic/retrievers/document_compressors/cross_encoder_rerank.pyindex 45edcc165d..fa7c14bcd2 100644--- a/libs/langchain/langchain_classic/retrievers/document_compressors/cross_encoder_rerank.py+++ b/libs/langchain/langchain_classic/retrievers/document_compressors/cross_encoder_rerank.py@@ -2,7 +2,6 @@ from __future__ import annotationsimport operatorfrom collections.abc import Sequence-from typing import Optionalfrom langchain_core.callbacks import Callbacksfrom langchain_core.documents import BaseDocumentCompressor, Document@@ -33,7 +32,7 @@ class CrossEncoderReranker(BaseDocumentCompressor):self,documents: Sequence[Document],query: str,- callbacks: Optional[Callbacks] = None,+ callbacks: Callbacks | None = None,) -> Sequence[Document]:"""Rerank documents using CrossEncoder.@@ -46,6 +45,6 @@ class CrossEncoderReranker(BaseDocumentCompressor):A sequence of compressed documents."""scores = self.model.score([(query, doc.page_content) for doc in documents])- docs_with_scores = list(zip(documents, scores))+ docs_with_scores = list(zip(documents, scores, strict=False))result = sorted(docs_with_scores, key=operator.itemgetter(1), reverse=True)return [doc for doc, _ in result[: self.top_n]]diff --git a/libs/langchain/langchain_classic/retrievers/document_compressors/embeddings_filter.py b/libs/langchain/langchain_classic/retrievers/document_compressors/embeddings_filter.pyindex 9dd2998f22..017863373b 100644--- a/libs/langchain/langchain_classic/retrievers/document_compressors/embeddings_filter.py+++ b/libs/langchain/langchain_classic/retrievers/document_compressors/embeddings_filter.py@@ -1,5 +1,4 @@-from collections.abc import Sequence-from typing import Callable, Optional+from collections.abc import Callable, Sequencefrom langchain_core.callbacks import Callbacksfrom langchain_core.documents import BaseDocumentCompressor, Document@@ -33,10 +32,10 @@ class EmbeddingsFilter(BaseDocumentCompressor):"""Similarity function for comparing documents. Function expected to take as inputtwo matrices (List[List[float]]) and return a matrix of scores where higher valuesindicate greater similarity."""- k: Optional[int] = 20+ k: int | None = 20"""The number of relevant documents to return. Can be set to None, in which case`similarity_threshold` must be specified. Defaults to 20."""- similarity_threshold: Optional[float] = None+ similarity_threshold: float | None = None"""Threshold for determining when two documents are similar enoughto be considered redundant. Defaults to None, must be specified if `k` is setto None."""@@ -58,7 +57,7 @@ class EmbeddingsFilter(BaseDocumentCompressor):self,documents: Sequence[Document],query: str,- callbacks: Optional[Callbacks] = None,+ callbacks: Callbacks | None = None,) -> Sequence[Document]:"""Filter documents based on similarity of their embeddings to the query."""try:@@ -102,7 +101,7 @@ class EmbeddingsFilter(BaseDocumentCompressor):self,documents: Sequence[Document],query: str,- callbacks: Optional[Callbacks] = None,+ callbacks: Callbacks | None = None,) -> Sequence[Document]:"""Filter documents based on similarity of their embeddings to the query."""try:diff --git a/libs/langchain/langchain_classic/retrievers/document_compressors/listwise_rerank.py b/libs/langchain/langchain_classic/retrievers/document_compressors/listwise_rerank.pyindex 1ce0d2888c..e5ad73ace7 100644--- a/libs/langchain/langchain_classic/retrievers/document_compressors/listwise_rerank.py+++ b/libs/langchain/langchain_classic/retrievers/document_compressors/listwise_rerank.py@@ -1,7 +1,7 @@"""Filter that uses an LLM to rerank documents listwise and select top-k."""from collections.abc import Sequence-from typing import Any, Optional+from typing import Anyfrom langchain_core.callbacks import Callbacksfrom langchain_core.documents import BaseDocumentCompressor, Document@@ -89,7 +89,7 @@ class LLMListwiseRerank(BaseDocumentCompressor):self,documents: Sequence[Document],query: str,- callbacks: Optional[Callbacks] = None,+ callbacks: Callbacks | None = None,) -> Sequence[Document]:"""Filter down documents based on their relevance to the query."""results = self.reranker.invoke(@@ -103,7 +103,7 @@ class LLMListwiseRerank(BaseDocumentCompressor):cls,llm: BaseLanguageModel,*,- prompt: Optional[BasePromptTemplate] = None,+ prompt: BasePromptTemplate | None = None,**kwargs: Any,) -> "LLMListwiseRerank":"""Create a LLMListwiseRerank document compressor from a language model.diff --git a/libs/langchain/langchain_classic/retrievers/ensemble.py b/libs/langchain/langchain_classic/retrievers/ensemble.pyindex 797c6ddcb3..bdce26c6e2 100644--- a/libs/langchain/langchain_classic/retrievers/ensemble.py+++ b/libs/langchain/langchain_classic/retrievers/ensemble.py@@ -6,12 +6,10 @@ multiple retrievers by using weighted Reciprocal Rank Fusion.import asynciofrom collections import defaultdict-from collections.abc import Hashable, Iterable, Iterator+from collections.abc import Callable, Hashable, Iterable, Iteratorfrom itertools import chainfrom typing import (Any,- Callable,- Optional,TypeVar,cast,)@@ -71,7 +69,7 @@ class EnsembleRetriever(BaseRetriever):retrievers: list[RetrieverLike]weights: list[float]c: int = 60- id_key: Optional[str] = None+ id_key: str | None = None@propertydef config_specs(self) -> list[ConfigurableFieldSpec]:@@ -92,7 +90,7 @@ class EnsembleRetriever(BaseRetriever):def invoke(self,input: str,- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,**kwargs: Any,) -> list[Document]:from langchain_core.callbacks import CallbackManager@@ -129,7 +127,7 @@ class EnsembleRetriever(BaseRetriever):async def ainvoke(self,input: str,- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,**kwargs: Any,) -> list[Document]:from langchain_core.callbacks import AsyncCallbackManager@@ -207,7 +205,7 @@ class EnsembleRetriever(BaseRetriever):query: str,run_manager: CallbackManagerForRetrieverRun,*,- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,) -> list[Document]:"""Rank fusion.@@ -249,7 +247,7 @@ class EnsembleRetriever(BaseRetriever):query: str,run_manager: AsyncCallbackManagerForRetrieverRun,*,- config: Optional[RunnableConfig] = None,+ config: RunnableConfig | None = None,) -> list[Document]:"""Rank fusion.@@ -311,7 +309,7 @@ class EnsembleRetriever(BaseRetriever):# Associate each doc's content with its RRF score for later sorting by it# Duplicated contents across retrievers are collapsed & scored cumulativelyrrf_score: dict[str, float] = defaultdict(float)- for doc_list, weight in zip(doc_lists, self.weights):+ for doc_list, weight in zip(doc_lists, self.weights, strict=False):for rank, doc in enumerate(doc_list, start=1):rrf_score[(diff --git a/libs/langchain/langchain_classic/retrievers/merger_retriever.py b/libs/langchain/langchain_classic/retrievers/merger_retriever.pyindex ba6e64abf4..f556b7d178 100644--- a/libs/langchain/langchain_classic/retrievers/merger_retriever.py+++ b/libs/langchain/langchain_classic/retrievers/merger_retriever.py@@ -77,7 +77,7 @@ class MergerRetriever(BaseRetriever):merged_documents = []max_docs = max(map(len, retriever_docs), default=0)for i in range(max_docs):- for _retriever, doc in zip(self.retrievers, retriever_docs):+ for _retriever, doc in zip(self.retrievers, retriever_docs, strict=False):if i < len(doc):merged_documents.append(doc[i])@@ -112,7 +112,7 @@ class MergerRetriever(BaseRetriever):merged_documents = []max_docs = max(map(len, retriever_docs), default=0)for i in range(max_docs):- for _retriever, doc in zip(self.retrievers, retriever_docs):+ for _retriever, doc in zip(self.retrievers, retriever_docs, strict=False):if i < len(doc):merged_documents.append(doc[i])diff --git a/libs/langchain/langchain_classic/retrievers/multi_query.py b/libs/langchain/langchain_classic/retrievers/multi_query.pyindex 7dc5b18950..76105cbfd7 100644--- a/libs/langchain/langchain_classic/retrievers/multi_query.py+++ b/libs/langchain/langchain_classic/retrievers/multi_query.py@@ -1,7 +1,6 @@import asyncioimport loggingfrom collections.abc import Sequence-from typing import Optionalfrom langchain_core.callbacks import (AsyncCallbackManagerForRetrieverRun,@@ -67,7 +66,7 @@ class MultiQueryRetriever(BaseRetriever):retriever: BaseRetriever,llm: BaseLanguageModel,prompt: BasePromptTemplate = DEFAULT_QUERY_PROMPT,- parser_key: Optional[str] = None, # noqa: ARG003+ parser_key: str | None = None, # noqa: ARG003include_original: bool = False, # noqa: FBT001,FBT002) -> "MultiQueryRetriever":"""Initialize from llm using default template.diff --git a/libs/langchain/langchain_classic/retrievers/multi_vector.py b/libs/langchain/langchain_classic/retrievers/multi_vector.pyindex 32d752a6ab..d603424f7a 100644--- a/libs/langchain/langchain_classic/retrievers/multi_vector.py+++ b/libs/langchain/langchain_classic/retrievers/multi_vector.py@@ -1,5 +1,5 @@from enum import Enum-from typing import Any, Optional+from typing import Anyfrom langchain_core.callbacks import (AsyncCallbackManagerForRetrieverRun,@@ -32,7 +32,7 @@ class MultiVectorRetriever(BaseRetriever):vectorstore: VectorStore"""The underlying vectorstore to use to store small chunksand their embedding vectors"""- byte_store: Optional[ByteStore] = None+ byte_store: ByteStore | None = None"""The lower-level backing storage layer for the parent documents"""docstore: BaseStore[str, Document]"""The storage interface for the parent documents"""diff --git a/libs/langchain/langchain_classic/retrievers/parent_document_retriever.py b/libs/langchain/langchain_classic/retrievers/parent_document_retriever.pyindex 4301d8ebd4..abb955757d 100644--- a/libs/langchain/langchain_classic/retrievers/parent_document_retriever.py+++ b/libs/langchain/langchain_classic/retrievers/parent_document_retriever.py@@ -1,6 +1,6 @@import uuidfrom collections.abc import Sequence-from typing import Any, Optional+from typing import Anyfrom langchain_core.documents import Documentfrom langchain_text_splitters import TextSplitter@@ -66,11 +66,11 @@ class ParentDocumentRetriever(MultiVectorRetriever):"""The key to use to track the parent id. This will be stored in themetadata of child documents."""- parent_splitter: Optional[TextSplitter] = None+ parent_splitter: TextSplitter | None = None"""The text splitter to use to create parent documents.If none, then the parent documents will be the raw documents passed in."""- child_metadata_fields: Optional[Sequence[str]] = None+ child_metadata_fields: Sequence[str] | None = None"""Metadata fields to leave in child documents. If None, leave all parent documentmetadata."""@@ -78,7 +78,7 @@ class ParentDocumentRetriever(MultiVectorRetriever):def _split_docs_for_adding(self,documents: list[Document],- ids: Optional[list[str]] = None,+ ids: list[str] | None = None,*,add_to_docstore: bool = True,) -> tuple[list[Document], list[tuple[str, Document]]]:@@ -118,7 +118,7 @@ class ParentDocumentRetriever(MultiVectorRetriever):def add_documents(self,documents: list[Document],- ids: Optional[list[str]] = None,+ ids: list[str] | None = None,add_to_docstore: bool = True, # noqa: FBT001,FBT002**kwargs: Any,) -> None:@@ -149,7 +149,7 @@ class ParentDocumentRetriever(MultiVectorRetriever):async def aadd_documents(self,documents: list[Document],- ids: Optional[list[str]] = None,+ ids: list[str] | None = None,add_to_docstore: bool = True, # noqa: FBT001,FBT002**kwargs: Any,) -> None:diff --git a/libs/langchain/langchain_classic/retrievers/self_query/base.py b/libs/langchain/langchain_classic/retrievers/self_query/base.pyindex acda20676a..624143dd18 100644--- a/libs/langchain/langchain_classic/retrievers/self_query/base.py+++ b/libs/langchain/langchain_classic/retrievers/self_query/base.py@@ -2,7 +2,7 @@import loggingfrom collections.abc import Sequence-from typing import Any, Optional, Union+from typing import Anyfrom langchain_core.callbacks.manager import (AsyncCallbackManagerForRetrieverRun,@@ -344,9 +344,9 @@ class SelfQueryRetriever(BaseRetriever):llm: BaseLanguageModel,vectorstore: VectorStore,document_contents: str,- metadata_field_info: Sequence[Union[AttributeInfo, dict]],- structured_query_translator: Optional[Visitor] = None,- chain_kwargs: Optional[dict] = None,+ metadata_field_info: Sequence[AttributeInfo | dict],+ structured_query_translator: Visitor | None = None,+ chain_kwargs: dict | None = None,enable_limit: bool = False, # noqa: FBT001,FBT002use_original_query: bool = False, # noqa: FBT001,FBT002**kwargs: Any,diff --git a/libs/langchain/langchain_classic/retrievers/time_weighted_retriever.py b/libs/langchain/langchain_classic/retrievers/time_weighted_retriever.pyindex 6416008578..9823318baa 100644--- a/libs/langchain/langchain_classic/retrievers/time_weighted_retriever.py+++ b/libs/langchain/langchain_classic/retrievers/time_weighted_retriever.py@@ -1,6 +1,6 @@import datetimefrom copy import deepcopy-from typing import Any, Optional+from typing import Anyfrom langchain_core.callbacks import (AsyncCallbackManagerForRetrieverRun,@@ -43,7 +43,7 @@ class TimeWeightedVectorStoreRetriever(BaseRetriever):other_score_keys: list[str] = []"""Other keys in the metadata to factor into the score, e.g. 'importance'."""- default_salience: Optional[float] = None+ default_salience: float | None = None"""The salience to assign memories not retrieved from the vector store.None assigns no salience to documents not fetched from the vector store.@@ -64,7 +64,7 @@ class TimeWeightedVectorStoreRetriever(BaseRetriever):def _get_combined_score(self,document: Document,- vector_relevance: Optional[float],+ vector_relevance: float | None,current_time: datetime.datetime,) -> float:"""Return the combined score for a document."""@@ -114,7 +114,7 @@ class TimeWeightedVectorStoreRetriever(BaseRetriever):def _get_rescored_docs(self,- docs_and_scores: dict[Any, tuple[Document, Optional[float]]],+ docs_and_scores: dict[Any, tuple[Document, float | None]],) -> list[Document]:current_time = datetime.datetime.now()rescored_docs = [diff --git a/libs/langchain/langchain_classic/runnables/hub.py b/libs/langchain/langchain_classic/runnables/hub.pyindex fe2320408f..9d0bdbf56c 100644--- a/libs/langchain/langchain_classic/runnables/hub.py+++ b/libs/langchain/langchain_classic/runnables/hub.py@@ -1,4 +1,4 @@-from typing import Any, Optional+from typing import Anyfrom langchain_core.runnables.base import RunnableBindingBasefrom langchain_core.runnables.utils import Input, Output@@ -13,8 +13,8 @@ class HubRunnable(RunnableBindingBase[Input, Output]): # type: ignore[no-redef]self,owner_repo_commit: str,*,- api_url: Optional[str] = None,- api_key: Optional[str] = None,+ api_url: str | None = None,+ api_key: str | None = None,**kwargs: Any,) -> None:"""Initialize the HubRunnable.diff --git a/libs/langchain/langchain_classic/runnables/openai_functions.py b/libs/langchain/langchain_classic/runnables/openai_functions.pyindex a62737f0a4..38434559a9 100644--- a/libs/langchain/langchain_classic/runnables/openai_functions.py+++ b/libs/langchain/langchain_classic/runnables/openai_functions.py@@ -1,6 +1,6 @@-from collections.abc import Mapping+from collections.abc import Callable, Mappingfrom operator import itemgetter-from typing import Any, Callable, Optional, Union+from typing import Anyfrom langchain_core.messages import BaseMessagefrom langchain_core.output_parsers.openai_functions import JsonOutputFunctionsParser@@ -23,18 +23,15 @@ class OpenAIFunction(TypedDict):class OpenAIFunctionsRouter(RunnableBindingBase[BaseMessage, Any]): # type: ignore[no-redef]"""A runnable that routes to the selected function."""- functions: Optional[list[OpenAIFunction]]+ functions: list[OpenAIFunction] | Nonedef __init__(self,runnables: Mapping[str,- Union[- Runnable[dict, Any],- Callable[[dict], Any],- ],+ Runnable[dict, Any] | Callable[[dict], Any],],- functions: Optional[list[OpenAIFunction]] = None,+ functions: list[OpenAIFunction] | None = None,):"""Initialize the OpenAIFunctionsRouter.diff --git a/libs/langchain/langchain_classic/smith/evaluation/config.py b/libs/langchain/langchain_classic/smith/evaluation/config.pyindex 9ab5ff9eed..d190d03299 100644--- a/libs/langchain/langchain_classic/smith/evaluation/config.py+++ b/libs/langchain/langchain_classic/smith/evaluation/config.py@@ -1,7 +1,7 @@"""Configuration for run evaluators."""-from collections.abc import Sequence-from typing import Any, Callable, Optional, Union+from collections.abc import Callable, Sequence+from typing import Anyfrom langchain_core.embeddings import Embeddingsfrom langchain_core.language_models import BaseLanguageModel@@ -22,12 +22,12 @@ from langchain_classic.evaluation.string_distance.base import ()RUN_EVALUATOR_LIKE = Callable[- [Run, Optional[Example]],- Union[EvaluationResult, EvaluationResults, dict],+ [Run, Example | None],+ EvaluationResult | EvaluationResults | dict,]BATCH_EVALUATOR_LIKE = Callable[- [Sequence[Run], Optional[Sequence[Example]]],- Union[EvaluationResult, EvaluationResults, dict],+ [Sequence[Run], Sequence[Example] | None],+ EvaluationResult | EvaluationResults | dict,]@@ -68,14 +68,14 @@ class EvalConfig(BaseModel):class SingleKeyEvalConfig(EvalConfig):"""Configuration for a run evaluator that only requires a single key."""- reference_key: Optional[str] = None+ reference_key: str | None = None"""The key in the dataset run to use as the reference string.If not provided, we will attempt to infer automatically."""- prediction_key: Optional[str] = None+ prediction_key: str | None = None"""The key from the traced run's outputs dictionary to use torepresent the prediction. If not provided, it will be inferredautomatically."""- input_key: Optional[str] = None+ input_key: str | None = None"""The key from the traced run's inputs dictionary to use to represent theinput. If not provided, it will be inferred automatically."""@@ -88,19 +88,16 @@ class SingleKeyEvalConfig(EvalConfig):return kwargs-CUSTOM_EVALUATOR_TYPE = Union[RUN_EVALUATOR_LIKE, RunEvaluator, StringEvaluator]-SINGLE_EVAL_CONFIG_TYPE = Union[EvaluatorType, str, EvalConfig]+CUSTOM_EVALUATOR_TYPE = RUN_EVALUATOR_LIKE | RunEvaluator | StringEvaluator+SINGLE_EVAL_CONFIG_TYPE = EvaluatorType | str | EvalConfigclass RunEvalConfig(BaseModel):"""Configuration for a run evaluation."""- evaluators: list[- Union[- SINGLE_EVAL_CONFIG_TYPE,- CUSTOM_EVALUATOR_TYPE,- ]- ] = Field(default_factory=list)+ evaluators: list[SINGLE_EVAL_CONFIG_TYPE | CUSTOM_EVALUATOR_TYPE] = Field(+ default_factory=list+ )"""Configurations for which evaluators to apply to the dataset run.Each can be the string of an`EvaluatorType <langchain.evaluation.schema.EvaluatorType>`, such@@ -108,26 +105,26 @@ class RunEvalConfig(BaseModel):given evaluator(e.g.,`RunEvalConfig.QA <langchain.smith.evaluation.config.RunEvalConfig.QA>`)."""- custom_evaluators: Optional[list[CUSTOM_EVALUATOR_TYPE]] = None+ custom_evaluators: list[CUSTOM_EVALUATOR_TYPE] | None = None"""Custom evaluators to apply to the dataset run."""- batch_evaluators: Optional[list[BATCH_EVALUATOR_LIKE]] = None+ batch_evaluators: list[BATCH_EVALUATOR_LIKE] | None = None"""Evaluators that run on an aggregate/batch level.These generate 1 or more metrics that are assigned to the full test run.As a result, they are not associated with individual traces."""- reference_key: Optional[str] = None+ reference_key: str | None = None"""The key in the dataset run to use as the reference string.If not provided, we will attempt to infer automatically."""- prediction_key: Optional[str] = None+ prediction_key: str | None = None"""The key from the traced run's outputs dictionary to use torepresent the prediction. If not provided, it will be inferredautomatically."""- input_key: Optional[str] = None+ input_key: str | None = None"""The key from the traced run's inputs dictionary to use to represent theinput. If not provided, it will be inferred automatically."""- eval_llm: Optional[BaseLanguageModel] = None+ eval_llm: BaseLanguageModel | None = None"""The language model to pass to any evaluators that require one."""model_config = ConfigDict(@@ -146,8 +143,8 @@ class RunEvalConfig(BaseModel):"""- criteria: Optional[CRITERIA_TYPE] = None- llm: Optional[BaseLanguageModel] = None+ criteria: CRITERIA_TYPE | None = None+ llm: BaseLanguageModel | None = Noneevaluator_type: EvaluatorType = EvaluatorType.CRITERIAclass LabeledCriteria(SingleKeyEvalConfig):@@ -161,8 +158,8 @@ class RunEvalConfig(BaseModel):The language model to use for the evaluation chain."""- criteria: Optional[CRITERIA_TYPE] = None- llm: Optional[BaseLanguageModel] = None+ criteria: CRITERIA_TYPE | None = None+ llm: BaseLanguageModel | None = Noneevaluator_type: EvaluatorType = EvaluatorType.LABELED_CRITERIAclass EmbeddingDistance(SingleKeyEvalConfig):@@ -179,8 +176,8 @@ class RunEvalConfig(BaseModel):"""evaluator_type: EvaluatorType = EvaluatorType.EMBEDDING_DISTANCE- embeddings: Optional[Embeddings] = None- distance_metric: Optional[EmbeddingDistanceEnum] = None+ embeddings: Embeddings | None = None+ distance_metric: EmbeddingDistanceEnum | None = Nonemodel_config = ConfigDict(arbitrary_types_allowed=True,@@ -197,7 +194,7 @@ class RunEvalConfig(BaseModel):"""evaluator_type: EvaluatorType = EvaluatorType.STRING_DISTANCE- distance: Optional[StringDistanceEnum] = None+ distance: StringDistanceEnum | None = None"""The string distance metric to use.damerau_levenshtein: The Damerau-Levenshtein distance.levenshtein: The Levenshtein distance.@@ -220,8 +217,8 @@ class RunEvalConfig(BaseModel):"""evaluator_type: EvaluatorType = EvaluatorType.QA- llm: Optional[BaseLanguageModel] = None- prompt: Optional[BasePromptTemplate] = None+ llm: BaseLanguageModel | None = None+ prompt: BasePromptTemplate | None = Noneclass ContextQA(SingleKeyEvalConfig):"""Configuration for a context-based QA evaluator.@@ -236,8 +233,8 @@ class RunEvalConfig(BaseModel):"""evaluator_type: EvaluatorType = EvaluatorType.CONTEXT_QA- llm: Optional[BaseLanguageModel] = None- prompt: Optional[BasePromptTemplate] = None+ llm: BaseLanguageModel | None = None+ prompt: BasePromptTemplate | None = Noneclass CoTQA(SingleKeyEvalConfig):"""Configuration for a context-based QA evaluator.@@ -252,8 +249,8 @@ class RunEvalConfig(BaseModel):"""evaluator_type: EvaluatorType = EvaluatorType.CONTEXT_QA- llm: Optional[BaseLanguageModel] = None- prompt: Optional[BasePromptTemplate] = None+ llm: BaseLanguageModel | None = None+ prompt: BasePromptTemplate | None = Noneclass JsonValidity(SingleKeyEvalConfig):"""Configuration for a json validity evaluator.@@ -326,10 +323,10 @@ class RunEvalConfig(BaseModel):"""evaluator_type: EvaluatorType = EvaluatorType.SCORE_STRING- criteria: Optional[CRITERIA_TYPE] = None- llm: Optional[BaseLanguageModel] = None- normalize_by: Optional[float] = None- prompt: Optional[BasePromptTemplate] = None+ criteria: CRITERIA_TYPE | None = None+ llm: BaseLanguageModel | None = None+ normalize_by: float | None = None+ prompt: BasePromptTemplate | None = Noneclass LabeledScoreString(ScoreString):"""Configuration for a labeled score string evaluator."""diff --git a/libs/langchain/langchain_classic/smith/evaluation/progress.py b/libs/langchain/langchain_classic/smith/evaluation/progress.pyindex 79672b0e90..42862e3d1a 100644--- a/libs/langchain/langchain_classic/smith/evaluation/progress.py+++ b/libs/langchain/langchain_classic/smith/evaluation/progress.py@@ -2,7 +2,7 @@import threadingfrom collections.abc import Sequence-from typing import Any, Optional+from typing import Anyfrom uuid import UUIDfrom langchain_core.callbacks import base as base_callbacks@@ -55,7 +55,7 @@ class ProgressBarCallback(base_callbacks.BaseCallbackHandler):error: BaseException,*,run_id: UUID,- parent_run_id: Optional[UUID] = None,+ parent_run_id: UUID | None = None,**kwargs: Any,) -> Any:if parent_run_id is None:@@ -67,7 +67,7 @@ class ProgressBarCallback(base_callbacks.BaseCallbackHandler):outputs: dict[str, Any],*,run_id: UUID,- parent_run_id: Optional[UUID] = None,+ parent_run_id: UUID | None = None,**kwargs: Any,) -> Any:if parent_run_id is None:@@ -79,7 +79,7 @@ class ProgressBarCallback(base_callbacks.BaseCallbackHandler):error: BaseException,*,run_id: UUID,- parent_run_id: Optional[UUID] = None,+ parent_run_id: UUID | None = None,**kwargs: Any,) -> Any:if parent_run_id is None:@@ -91,7 +91,7 @@ class ProgressBarCallback(base_callbacks.BaseCallbackHandler):documents: Sequence[Document],*,run_id: UUID,- parent_run_id: Optional[UUID] = None,+ parent_run_id: UUID | None = None,**kwargs: Any,) -> Any:if parent_run_id is None:@@ -103,7 +103,7 @@ class ProgressBarCallback(base_callbacks.BaseCallbackHandler):error: BaseException,*,run_id: UUID,- parent_run_id: Optional[UUID] = None,+ parent_run_id: UUID | None = None,**kwargs: Any,) -> Any:if parent_run_id is None:@@ -115,7 +115,7 @@ class ProgressBarCallback(base_callbacks.BaseCallbackHandler):response: LLMResult,*,run_id: UUID,- parent_run_id: Optional[UUID] = None,+ parent_run_id: UUID | None = None,**kwargs: Any,) -> Any:if parent_run_id is None:@@ -127,7 +127,7 @@ class ProgressBarCallback(base_callbacks.BaseCallbackHandler):error: BaseException,*,run_id: UUID,- parent_run_id: Optional[UUID] = None,+ parent_run_id: UUID | None = None,**kwargs: Any,) -> Any:if parent_run_id is None:@@ -139,7 +139,7 @@ class ProgressBarCallback(base_callbacks.BaseCallbackHandler):output: str,*,run_id: UUID,- parent_run_id: Optional[UUID] = None,+ parent_run_id: UUID | None = None,**kwargs: Any,) -> Any:if parent_run_id is None:diff --git a/libs/langchain/langchain_classic/smith/evaluation/runner_utils.py b/libs/langchain/langchain_classic/smith/evaluation/runner_utils.pyindex bfdb26edf7..9bf01b6242 100644--- a/libs/langchain/langchain_classic/smith/evaluation/runner_utils.py+++ b/libs/langchain/langchain_classic/smith/evaluation/runner_utils.py@@ -8,13 +8,11 @@ import functoolsimport inspectimport loggingimport uuid+from collections.abc import Callablefrom datetime import datetime, timezonefrom typing import (TYPE_CHECKING,Any,- Callable,- Optional,- Union,cast,)@@ -62,14 +60,14 @@ if TYPE_CHECKING:logger = logging.getLogger(__name__)-MODEL_OR_CHAIN_FACTORY = Union[- Callable[[], Union[Chain, Runnable]],- BaseLanguageModel,- Callable[[dict], Any],- Runnable,- Chain,-]-MCF = Union[Callable[[], Union[Chain, Runnable]], BaseLanguageModel]+MODEL_OR_CHAIN_FACTORY = (+ Callable[[], Chain | Runnable]+ | BaseLanguageModel+ | Callable[[dict], Any]+ | Runnable+ | Chain+)+MCF = Callable[[], Chain | Runnable] | BaseLanguageModelclass InputFormatError(Exception):@@ -351,7 +349,7 @@ def _get_messages(inputs: dict[str, Any]) -> dict:## Shared data validation utilitiesdef _validate_example_inputs_for_language_model(first_example: Example,- input_mapper: Optional[Callable[[dict], Any]],+ input_mapper: Callable[[dict], Any] | None,) -> None:if input_mapper:prompt_input = input_mapper(first_example.inputs or {})@@ -387,7 +385,7 @@ def _validate_example_inputs_for_language_model(def _validate_example_inputs_for_chain(first_example: Example,chain: Chain,- input_mapper: Optional[Callable[[dict], Any]],+ input_mapper: Callable[[dict], Any] | None,) -> None:"""Validate that the example inputs match the chain input keys."""if input_mapper:@@ -427,7 +425,7 @@ def _validate_example_inputs_for_chain(def _validate_example_inputs(example: Example,llm_or_chain_factory: MCF,- input_mapper: Optional[Callable[[dict], Any]],+ input_mapper: Callable[[dict], Any] | None,) -> None:"""Validate that the example inputs are valid for the model."""if isinstance(llm_or_chain_factory, BaseLanguageModel):@@ -447,9 +445,9 @@ def _validate_example_inputs(def _setup_evaluation(llm_or_chain_factory: MCF,examples: list[Example],- evaluation: Optional[smith_eval.RunEvalConfig],+ evaluation: smith_eval.RunEvalConfig | None,data_type: DataType,-) -> Optional[list[RunEvaluator]]:+) -> list[RunEvaluator] | None:"""Configure the evaluators to run on the results of the chain."""if evaluation:if isinstance(llm_or_chain_factory, BaseLanguageModel):@@ -476,8 +474,8 @@ def _setup_evaluation(def _determine_input_key(config: smith_eval.RunEvalConfig,- run_inputs: Optional[list[str]],-) -> Optional[str]:+ run_inputs: list[str] | None,+) -> str | None:input_key = Noneif config.input_key:input_key = config.input_key@@ -503,8 +501,8 @@ def _determine_input_key(def _determine_prediction_key(config: smith_eval.RunEvalConfig,- run_outputs: Optional[list[str]],-) -> Optional[str]:+ run_outputs: list[str] | None,+) -> str | None:prediction_key = Noneif config.prediction_key:prediction_key = config.prediction_key@@ -529,8 +527,8 @@ def _determine_prediction_key(def _determine_reference_key(config: smith_eval.RunEvalConfig,- example_outputs: Optional[list[str]],-) -> Optional[str]:+ example_outputs: list[str] | None,+) -> str | None:if config.reference_key:reference_key = config.reference_keyif example_outputs and reference_key not in example_outputs:@@ -547,17 +545,15 @@ def _determine_reference_key(def _construct_run_evaluator(- eval_config: Union[- smith_eval_config.SINGLE_EVAL_CONFIG_TYPE,- smith_eval_config.CUSTOM_EVALUATOR_TYPE,- ],- eval_llm: Optional[BaseLanguageModel],+ eval_config: smith_eval_config.SINGLE_EVAL_CONFIG_TYPE+ | smith_eval_config.CUSTOM_EVALUATOR_TYPE,+ eval_llm: BaseLanguageModel | None,run_type: str,data_type: DataType,- example_outputs: Optional[list[str]],- reference_key: Optional[str],- input_key: Optional[str],- prediction_key: Optional[str],+ example_outputs: list[str] | None,+ reference_key: str | None,+ input_key: str | None,+ prediction_key: str | None,) -> RunEvaluator:if isinstance(eval_config, RunEvaluator):return eval_config@@ -617,10 +613,10 @@ def _construct_run_evaluator(def _get_keys(config: smith_eval.RunEvalConfig,- run_inputs: Optional[list[str]],- run_outputs: Optional[list[str]],- example_outputs: Optional[list[str]],-) -> tuple[Optional[str], Optional[str], Optional[str]]:+ run_inputs: list[str] | None,+ run_outputs: list[str] | None,+ example_outputs: list[str] | None,+) -> tuple[str | None, str | None, str | None]:input_key = _determine_input_key(config, run_inputs)prediction_key = _determine_prediction_key(config, run_outputs)reference_key = _determine_reference_key(config, example_outputs)@@ -631,9 +627,9 @@ def _load_run_evaluators(config: smith_eval.RunEvalConfig,run_type: str,data_type: DataType,- example_outputs: Optional[list[str]],- run_inputs: Optional[list[str]],- run_outputs: Optional[list[str]],+ example_outputs: list[str] | None,+ run_inputs: list[str] | None,+ run_outputs: list[str] | None,) -> list[RunEvaluator]:"""Load run evaluators from a configuration.@@ -706,11 +702,11 @@ async def _arun_llm(llm: BaseLanguageModel,inputs: dict[str, Any],*,- tags: Optional[list[str]] = None,+ tags: list[str] | None = None,callbacks: Callbacks = None,- input_mapper: Optional[Callable[[dict], Any]] = None,- metadata: Optional[dict[str, Any]] = None,-) -> Union[str, BaseMessage]:+ input_mapper: Callable[[dict], Any] | None = None,+ metadata: dict[str, Any] | None = None,+) -> str | BaseMessage:"""Asynchronously run the language model.Args:@@ -751,7 +747,7 @@ async def _arun_llm(try:prompt = _get_prompt(inputs)- llm_output: Union[str, BaseMessage] = await llm.ainvoke(+ llm_output: str | BaseMessage = await llm.ainvoke(prompt,config=RunnableConfig(callbacks=callbacks,@@ -773,14 +769,14 @@ async def _arun_llm(async def _arun_chain(- chain: Union[Chain, Runnable],+ chain: Chain | Runnable,inputs: dict[str, Any],callbacks: Callbacks,*,- tags: Optional[list[str]] = None,- input_mapper: Optional[Callable[[dict], Any]] = None,- metadata: Optional[dict[str, Any]] = None,-) -> Union[dict, str]:+ tags: list[str] | None = None,+ input_mapper: Callable[[dict], Any] | None = None,+ metadata: dict[str, Any] | None = None,+) -> dict | str:"""Run a chain asynchronously on inputs."""inputs_ = inputs if input_mapper is None else input_mapper(inputs)if (@@ -813,8 +809,8 @@ async def _arun_llm_or_chain(config: RunnableConfig,*,llm_or_chain_factory: MCF,- input_mapper: Optional[Callable[[dict], Any]] = None,-) -> Union[dict, str, LLMResult, ChatResult]:+ input_mapper: Callable[[dict], Any] | None = None,+) -> dict | str | LLMResult | ChatResult:"""Asynchronously run the Chain or language model.Args:@@ -871,10 +867,10 @@ def _run_llm(inputs: dict[str, Any],callbacks: Callbacks,*,- tags: Optional[list[str]] = None,- input_mapper: Optional[Callable[[dict], Any]] = None,- metadata: Optional[dict[str, Any]] = None,-) -> Union[str, BaseMessage]:+ tags: list[str] | None = None,+ input_mapper: Callable[[dict], Any] | None = None,+ metadata: dict[str, Any] | None = None,+) -> str | BaseMessage:"""Run the language model on the example.Args:@@ -899,7 +895,7 @@ def _run_llm(isinstance(prompt_or_messages, list)and all(isinstance(msg, BaseMessage) for msg in prompt_or_messages)):- llm_output: Union[str, BaseMessage] = llm.invoke(+ llm_output: str | BaseMessage = llm.invoke(prompt_or_messages,config=RunnableConfig(callbacks=callbacks,@@ -935,14 +931,14 @@ def _run_llm(def _run_chain(- chain: Union[Chain, Runnable],+ chain: Chain | Runnable,inputs: dict[str, Any],callbacks: Callbacks,*,- tags: Optional[list[str]] = None,- input_mapper: Optional[Callable[[dict], Any]] = None,- metadata: Optional[dict[str, Any]] = None,-) -> Union[dict, str]:+ tags: list[str] | None = None,+ input_mapper: Callable[[dict], Any] | None = None,+ metadata: dict[str, Any] | None = None,+) -> dict | str:"""Run a chain on inputs."""inputs_ = inputs if input_mapper is None else input_mapper(inputs)if (@@ -975,8 +971,8 @@ def _run_llm_or_chain(config: RunnableConfig,*,llm_or_chain_factory: MCF,- input_mapper: Optional[Callable[[dict], Any]] = None,-) -> Union[dict, str, LLMResult, ChatResult]:+ input_mapper: Callable[[dict], Any] | None = None,+) -> dict | str | LLMResult | ChatResult:"""Run the Chain or language model synchronously.Args:@@ -1033,9 +1029,9 @@ def _prepare_eval_run(dataset_name: str,llm_or_chain_factory: MODEL_OR_CHAIN_FACTORY,project_name: str,- project_metadata: Optional[dict[str, Any]] = None,- tags: Optional[list[str]] = None,- dataset_version: Optional[Union[str, datetime]] = None,+ project_metadata: dict[str, Any] | None = None,+ tags: list[str] | None = None,+ dataset_version: str | datetime | None = None,) -> tuple[MCF, TracerSession, Dataset, list[Example]]:wrapped_model = _wrap_in_chain_factory(llm_or_chain_factory, dataset_name)dataset = client.read_dataset(dataset_name=dataset_name)@@ -1094,9 +1090,9 @@ run_on_dataset(class _RowResult(TypedDict, total=False):"""A dictionary of the results for a single example row."""- feedback: Optional[list[EvaluationResult]]- execution_time: Optional[float]- run_id: Optional[str]+ feedback: list[EvaluationResult] | None+ execution_time: float | None+ run_id: str | None@dataclasses.dataclass@@ -1108,7 +1104,7 @@ class _DatasetRunContainer:wrapped_model: MCFexamples: list[Example]configs: list[RunnableConfig]- batch_evaluators: Optional[list[smith_eval_config.BATCH_EVALUATOR_LIKE]] = None+ batch_evaluators: list[smith_eval_config.BATCH_EVALUATOR_LIKE] | None = Nonedef _merge_test_outputs(self,@@ -1116,7 +1112,7 @@ class _DatasetRunContainer:all_eval_results: dict[str, _RowResult],) -> dict:results: dict = {}- for example, output in zip(self.examples, batch_results):+ for example, output in zip(self.examples, batch_results, strict=False):row_result = cast("_RowResult", all_eval_results.get(str(example.id), {}))results[str(example.id)] = {"input": example.inputs,@@ -1188,7 +1184,7 @@ class _DatasetRunContainer:def _collect_test_results(self,- batch_results: list[Union[dict, str, LLMResult, ChatResult]],+ batch_results: list[dict | str | LLMResult | ChatResult],) -> TestResult:logger.info("Waiting for evaluators to complete.")wait_for_all_evaluators()@@ -1232,14 +1228,14 @@ class _DatasetRunContainer:client: Client,dataset_name: str,llm_or_chain_factory: MODEL_OR_CHAIN_FACTORY,- project_name: Optional[str],- evaluation: Optional[smith_eval.RunEvalConfig] = None,- tags: Optional[list[str]] = None,- input_mapper: Optional[Callable[[dict], Any]] = None,+ project_name: str | None,+ evaluation: smith_eval.RunEvalConfig | None = None,+ tags: list[str] | None = None,+ input_mapper: Callable[[dict], Any] | None = None,concurrency_level: int = 5,- project_metadata: Optional[dict[str, Any]] = None,- revision_id: Optional[str] = None,- dataset_version: Optional[Union[datetime, str]] = None,+ project_metadata: dict[str, Any] | None = None,+ revision_id: str | None = None,+ dataset_version: datetime | str | None = None,) -> _DatasetRunContainer:project_name = project_name or name_generation.random_name()if revision_id:@@ -1345,17 +1341,17 @@ _INPUT_MAPPER_DEP_WARNING = (async def arun_on_dataset(- client: Optional[Client],+ client: Client | None,dataset_name: str,llm_or_chain_factory: MODEL_OR_CHAIN_FACTORY,*,- evaluation: Optional[smith_eval.RunEvalConfig] = None,- dataset_version: Optional[Union[datetime, str]] = None,+ evaluation: smith_eval.RunEvalConfig | None = None,+ dataset_version: datetime | str | None = None,concurrency_level: int = 5,- project_name: Optional[str] = None,- project_metadata: Optional[dict[str, Any]] = None,+ project_name: str | None = None,+ project_metadata: dict[str, Any] | None = None,verbose: bool = False,- revision_id: Optional[str] = None,+ revision_id: str | None = None,**kwargs: Any,) -> dict[str, Any]:"""Run on dataset.@@ -1523,17 +1519,17 @@ async def arun_on_dataset(def run_on_dataset(- client: Optional[Client],+ client: Client | None,dataset_name: str,llm_or_chain_factory: MODEL_OR_CHAIN_FACTORY,*,- evaluation: Optional[smith_eval.RunEvalConfig] = None,- dataset_version: Optional[Union[datetime, str]] = None,+ evaluation: smith_eval.RunEvalConfig | None = None,+ dataset_version: datetime | str | None = None,concurrency_level: int = 5,- project_name: Optional[str] = None,- project_metadata: Optional[dict[str, Any]] = None,+ project_name: str | None = None,+ project_metadata: dict[str, Any] | None = None,verbose: bool = False,- revision_id: Optional[str] = None,+ revision_id: str | None = None,**kwargs: Any,) -> dict[str, Any]:"""Run on dataset.@@ -1693,7 +1689,9 @@ def run_on_dataset(llm_or_chain_factory=container.wrapped_model,input_mapper=input_mapper,)- for example, config in zip(container.examples, container.configs)+ for example, config in zip(+ container.examples, container.configs, strict=False+ )]else:with runnable_config.get_executor_for_config(container.configs[0]) as executor:diff --git a/libs/langchain/langchain_classic/smith/evaluation/string_run_evaluator.py b/libs/langchain/langchain_classic/smith/evaluation/string_run_evaluator.pyindex 63a6c3dbee..4551371f32 100644--- a/libs/langchain/langchain_classic/smith/evaluation/string_run_evaluator.py+++ b/libs/langchain/langchain_classic/smith/evaluation/string_run_evaluator.py@@ -5,7 +5,7 @@ from __future__ import annotationsimport loggingimport uuidfrom abc import abstractmethod-from typing import Any, Optional, Union, cast+from typing import Any, castfrom langchain_core.callbacks.manager import (AsyncCallbackManagerForChainRun,@@ -58,9 +58,7 @@ class StringRunMapper(Serializable):class LLMStringRunMapper(StringRunMapper):"""Extract items to evaluate from the run object."""- def serialize_chat_messages(- self, messages: Union[list[dict], list[list[dict]]]- ) -> str:+ def serialize_chat_messages(self, messages: list[dict] | list[list[dict]]) -> str:"""Extract the input messages from the run."""if isinstance(messages, list) and messages:if isinstance(messages[0], dict):@@ -116,11 +114,11 @@ class LLMStringRunMapper(StringRunMapper):if not outputs.get("generations"):msg = "Cannot evaluate LLM Run without generations."raise ValueError(msg)- generations: Union[list[dict], list[list[dict]]] = outputs["generations"]+ generations: list[dict] | list[list[dict]] = outputs["generations"]if not generations:msg = "Cannot evaluate LLM run with empty generations."raise ValueError(msg)- first_generation: Union[dict, list[dict]] = generations[0]+ first_generation: dict | list[dict] = generations[0]if isinstance(first_generation, list):# Runs from Tracer have generations as a list of lists of dicts# Whereas Runs from the API have a list of dicts@@ -158,16 +156,16 @@ class LLMStringRunMapper(StringRunMapper):class ChainStringRunMapper(StringRunMapper):"""Extract items to evaluate from the run object from a chain."""- input_key: Optional[str] = None+ input_key: str | None = None"""The key from the model Run's inputs to use as the eval input.If not provided, will use the only input key or raise anerror if there are multiple."""- prediction_key: Optional[str] = None+ prediction_key: str | None = None"""The key from the model Run's outputs to use as the eval prediction.If not provided, will use the only output key or raise an errorif there are multiple."""- def _get_key(self, source: dict, key: Optional[str], which: str) -> str:+ def _get_key(self, source: dict, key: str | None, which: str) -> str:if key is not None:return source[key]if len(source) == 1:@@ -227,7 +225,7 @@ class ToolStringRunMapper(StringRunMapper):class StringExampleMapper(Serializable):"""Map an example, or row in the dataset, to the inputs of an evaluation."""- reference_key: Optional[str] = None+ reference_key: str | None = None@propertydef output_keys(self) -> list[str]:@@ -279,7 +277,7 @@ class StringRunEvaluatorChain(Chain, RunEvaluator):run_mapper: StringRunMapper"""Maps the Run to a dictionary with 'input' and 'prediction' strings."""- example_mapper: Optional[StringExampleMapper] = None+ example_mapper: StringExampleMapper | None = None"""Maps the Example (dataset row) to a dictionarywith a 'reference' string."""name: str@@ -299,7 +297,7 @@ class StringRunEvaluatorChain(Chain, RunEvaluator):def _prepare_input(self, inputs: dict[str, Any]) -> dict[str, str]:run: Run = inputs["run"]- example: Optional[Example] = inputs.get("example")+ example: Example | None = inputs.get("example")evaluate_strings_inputs = self.run_mapper(run)if not self.string_evaluator.requires_input:# Hide warning about unused input@@ -329,7 +327,7 @@ class StringRunEvaluatorChain(Chain, RunEvaluator):def _call(self,inputs: dict[str, str],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, Any]:"""Call the evaluation chain."""evaluate_strings_inputs = self._prepare_input(inputs)@@ -345,7 +343,7 @@ class StringRunEvaluatorChain(Chain, RunEvaluator):async def _acall(self,inputs: dict[str, str],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, Any]:"""Call the evaluation chain."""evaluate_strings_inputs = self._prepare_input(inputs)@@ -368,8 +366,8 @@ class StringRunEvaluatorChain(Chain, RunEvaluator):def evaluate_run(self,run: Run,- example: Optional[Example] = None,- evaluator_run_id: Optional[uuid.UUID] = None,+ example: Example | None = None,+ evaluator_run_id: uuid.UUID | None = None,) -> EvaluationResult:"""Evaluate an example."""try:@@ -387,8 +385,8 @@ class StringRunEvaluatorChain(Chain, RunEvaluator):async def aevaluate_run(self,run: Run,- example: Optional[Example] = None,- evaluator_run_id: Optional[uuid.UUID] = None,+ example: Example | None = None,+ evaluator_run_id: uuid.UUID | None = None,) -> EvaluationResult:"""Evaluate an example."""try:@@ -410,10 +408,10 @@ class StringRunEvaluatorChain(Chain, RunEvaluator):evaluator: StringEvaluator,run_type: str,data_type: DataType,- input_key: Optional[str] = None,- prediction_key: Optional[str] = None,- reference_key: Optional[str] = None,- tags: Optional[list[str]] = None,+ input_key: str | None = None,+ prediction_key: str | None = None,+ reference_key: str | None = None,+ tags: list[str] | None = None,) -> StringRunEvaluatorChain:"""Create a StringRunEvaluatorChain.diff --git a/libs/langchain/langchain_classic/storage/_lc_store.py b/libs/langchain/langchain_classic/storage/_lc_store.pyindex 9dec5f4306..f4f64939ea 100644--- a/libs/langchain/langchain_classic/storage/_lc_store.py+++ b/libs/langchain/langchain_classic/storage/_lc_store.py@@ -1,6 +1,7 @@"""Create a key-value store for any langchain serializable object."""-from typing import Any, Callable, Optional+from collections.abc import Callable+from typing import Anyfrom langchain_core.documents import Documentfrom langchain_core.load import Serializable, dumps, loads@@ -47,7 +48,7 @@ def _identity(x: str) -> str:def create_lc_store(store: ByteStore,*,- key_encoder: Optional[Callable[[str], str]] = None,+ key_encoder: Callable[[str], str] | None = None,) -> BaseStore[str, Serializable]:"""Create a store for langchain serializable objects from a bytes store.@@ -69,7 +70,7 @@ def create_lc_store(def create_kv_docstore(store: ByteStore,*,- key_encoder: Optional[Callable[[str], str]] = None,+ key_encoder: Callable[[str], str] | None = None,) -> BaseStore[str, Document]:"""Create a store for langchain Document objects from a bytes store.diff --git a/libs/langchain/langchain_classic/storage/encoder_backed.py b/libs/langchain/langchain_classic/storage/encoder_backed.pyindex cd031889f4..16cb57958e 100644--- a/libs/langchain/langchain_classic/storage/encoder_backed.py+++ b/libs/langchain/langchain_classic/storage/encoder_backed.py@@ -1,10 +1,7 @@-from collections.abc import AsyncIterator, Iterator, Sequence+from collections.abc import AsyncIterator, Callable, Iterator, Sequencefrom typing import (Any,- Callable,- Optional,TypeVar,- Union,)from langchain_core.stores import BaseStore@@ -66,7 +63,7 @@ class EncoderBackedStore(BaseStore[K, V]):self.value_serializer = value_serializerself.value_deserializer = value_deserializer- def mget(self, keys: Sequence[K]) -> list[Optional[V]]:+ def mget(self, keys: Sequence[K]) -> list[V | None]:"""Get the values associated with the given keys."""encoded_keys: list[str] = [self.key_encoder(key) for key in keys]values = self.store.mget(encoded_keys)@@ -75,7 +72,7 @@ class EncoderBackedStore(BaseStore[K, V]):for value in values]- async def amget(self, keys: Sequence[K]) -> list[Optional[V]]:+ async def amget(self, keys: Sequence[K]) -> list[V | None]:"""Get the values associated with the given keys."""encoded_keys: list[str] = [self.key_encoder(key) for key in keys]values = await self.store.amget(encoded_keys)@@ -113,8 +110,8 @@ class EncoderBackedStore(BaseStore[K, V]):def yield_keys(self,*,- prefix: Optional[str] = None,- ) -> Union[Iterator[K], Iterator[str]]:+ prefix: str | None = None,+ ) -> Iterator[K] | Iterator[str]:"""Get an iterator over keys that match the given prefix."""# For the time being this does not return K, but str# it's for debugging purposes. Should fix this.@@ -123,8 +120,8 @@ class EncoderBackedStore(BaseStore[K, V]):async def ayield_keys(self,*,- prefix: Optional[str] = None,- ) -> Union[AsyncIterator[K], AsyncIterator[str]]:+ prefix: str | None = None,+ ) -> AsyncIterator[K] | AsyncIterator[str]:"""Get an iterator over keys that match the given prefix."""# For the time being this does not return K, but str# it's for debugging purposes. Should fix this.diff --git a/libs/langchain/langchain_classic/storage/file_system.py b/libs/langchain/langchain_classic/storage/file_system.pyindex 1709148110..5618ff3cec 100644--- a/libs/langchain/langchain_classic/storage/file_system.py+++ b/libs/langchain/langchain_classic/storage/file_system.py@@ -3,7 +3,6 @@ import reimport timefrom collections.abc import Iterator, Sequencefrom pathlib import Path-from typing import Optional, Unionfrom langchain_core.stores import ByteStore@@ -40,10 +39,10 @@ class LocalFileStore(ByteStore):def __init__(self,- root_path: Union[str, Path],+ root_path: str | Path,*,- chmod_file: Optional[int] = None,- chmod_dir: Optional[int] = None,+ chmod_file: int | None = None,+ chmod_dir: int | None = None,update_atime: bool = False,) -> None:"""Implement the BaseStore interface for the local file system.@@ -107,7 +106,7 @@ class LocalFileStore(ByteStore):if self.chmod_dir is not None:dir_path.chmod(self.chmod_dir)- def mget(self, keys: Sequence[str]) -> list[Optional[bytes]]:+ def mget(self, keys: Sequence[str]) -> list[bytes | None]:"""Get the values associated with the given keys.Args:@@ -117,7 +116,7 @@ class LocalFileStore(ByteStore):A sequence of optional values associated with the keys.If a key is not found, the corresponding value will be None."""- values: list[Optional[bytes]] = []+ values: list[bytes | None] = []for key in keys:full_path = self._get_full_path(key)if full_path.exists():@@ -160,7 +159,7 @@ class LocalFileStore(ByteStore):if full_path.exists():full_path.unlink()- def yield_keys(self, prefix: Optional[str] = None) -> Iterator[str]:+ def yield_keys(self, prefix: str | None = None) -> Iterator[str]:"""Get an iterator over keys that match the given prefix.Args:diff --git a/libs/langchain/pyproject.toml b/libs/langchain/pyproject.tomlindex 11d5b0f6e2..d3a60fa98d 100644--- a/libs/langchain/pyproject.toml+++ b/libs/langchain/pyproject.toml@@ -119,7 +119,6 @@ langchain-text-splitters = { path = "../text-splitters", editable = true }langchain-openai = { path = "../partners/openai", editable = true }[tool.ruff]-target-version = "py39"exclude = ["tests/integration_tests/examples/non-utf8-encoding.py"][tool.mypy]diff --git a/libs/langchain/tests/mock_servers/robot/server.py b/libs/langchain/tests/mock_servers/robot/server.pyindex 4d92a8c1b9..31db19c585 100644--- a/libs/langchain/tests/mock_servers/robot/server.py+++ b/libs/langchain/tests/mock_servers/robot/server.py@@ -1,7 +1,7 @@"""A mock Robot server."""from enum import Enum-from typing import Annotated, Any, Optional, Union+from typing import Annotated, Anyfrom uuid import uuid4import uvicorn@@ -80,8 +80,8 @@ class WalkInput(BaseModel):"""Input for walking."""direction: Direction- speed: Optional[float]- style_or_cautiousness: Union[Style, Cautiousness]+ speed: float | None+ style_or_cautiousness: Style | Cautiousnessother_commands: Anydiff --git a/libs/langchain/tests/unit_tests/agents/test_agent.py b/libs/langchain/tests/unit_tests/agents/test_agent.pyindex 9a2046192f..072a3c7faf 100644--- a/libs/langchain/tests/unit_tests/agents/test_agent.py+++ b/libs/langchain/tests/unit_tests/agents/test_agent.py@@ -5,7 +5,7 @@ import jsonimport operatorfrom functools import reducefrom itertools import cycle-from typing import Any, Optional, Union, cast+from typing import Any, castfrom langchain_core.agents import (AgentAction,@@ -53,8 +53,8 @@ class FakeListLLM(LLM):def _call(self,prompt: str,- stop: Optional[list[str]] = None,- run_manager: Optional[CallbackManagerForLLMRun] = None,+ stop: list[str] | None = None,+ run_manager: CallbackManagerForLLMRun | None = None,**kwargs: Any,) -> str:"""Increment counter, and then return response in that index."""@@ -463,7 +463,7 @@ async def test_runnable_agent() -> None:],)- def fake_parse(_: dict) -> Union[AgentFinish, AgentAction]:+ def fake_parse(_: dict) -> AgentFinish | AgentAction:"""A parser."""return AgentFinish(return_values={"foo": "meow"}, log="hard-coded-message")@@ -570,9 +570,9 @@ async def test_runnable_agent_with_function_calls() -> None:],)- def fake_parse(_: dict) -> Union[AgentFinish, AgentAction]:+ def fake_parse(_: dict) -> AgentFinish | AgentAction:"""A parser."""- return cast("Union[AgentFinish, AgentAction]", next(parser_responses))+ return cast("AgentFinish | AgentAction", next(parser_responses))@tooldef find_pet(pet: str) -> str:@@ -682,9 +682,9 @@ async def test_runnable_with_multi_action_per_step() -> None:],)- def fake_parse(_: dict) -> Union[AgentFinish, AgentAction]:+ def fake_parse(_: dict) -> AgentFinish | AgentAction:"""A parser."""- return cast("Union[AgentFinish, AgentAction]", next(parser_responses))+ return cast("AgentFinish | AgentAction", next(parser_responses))@tooldef find_pet(pet: str) -> str:diff --git a/libs/langchain/tests/unit_tests/agents/test_agent_async.py b/libs/langchain/tests/unit_tests/agents/test_agent_async.pyindex 47dd4e9294..5d3239192f 100644--- a/libs/langchain/tests/unit_tests/agents/test_agent_async.py+++ b/libs/langchain/tests/unit_tests/agents/test_agent_async.py@@ -1,6 +1,6 @@"""Unit tests for agents."""-from typing import Any, Optional+from typing import Anyfrom langchain_core.agents import AgentAction, AgentStepfrom langchain_core.callbacks.manager import CallbackManagerForLLMRun@@ -24,8 +24,8 @@ class FakeListLLM(LLM):def _call(self,prompt: str,- stop: Optional[list[str]] = None,- run_manager: Optional[CallbackManagerForLLMRun] = None,+ stop: list[str] | None = None,+ run_manager: CallbackManagerForLLMRun | None = None,**kwargs: Any,) -> str:"""Increment counter, and then return response in that index."""diff --git a/libs/langchain/tests/unit_tests/callbacks/fake_callback_handler.py b/libs/langchain/tests/unit_tests/callbacks/fake_callback_handler.pyindex 8b97e226ec..59488532e8 100644--- a/libs/langchain/tests/unit_tests/callbacks/fake_callback_handler.py+++ b/libs/langchain/tests/unit_tests/callbacks/fake_callback_handler.py@@ -1,7 +1,7 @@"""A fake callback handler for testing purposes."""from itertools import chain-from typing import Any, Optional, Union+from typing import Anyfrom uuid import UUIDfrom langchain_core.callbacks.base import AsyncCallbackHandler, BaseCallbackHandler@@ -24,7 +24,7 @@ class BaseFakeCallbackHandler(BaseModel):ignore_chat_model_: bool = False# to allow for similar callback handlers that are not technically equal- fake_id: Union[str, None] = None+ fake_id: str | None = None# add finer-grained counters for easier debugging of failing testschain_starts: int = 0@@ -284,7 +284,7 @@ class FakeCallbackHandlerWithChatStart(FakeCallbackHandler):messages: list[list[BaseMessage]],*,run_id: UUID,- parent_run_id: Optional[UUID] = None,+ parent_run_id: UUID | None = None,**kwargs: Any,) -> Any:assert all(isinstance(m, BaseMessage) for m in chain(*messages))diff --git a/libs/langchain/tests/unit_tests/callbacks/test_file.py b/libs/langchain/tests/unit_tests/callbacks/test_file.pyindex 28e3dde8a4..5a20823cc5 100644--- a/libs/langchain/tests/unit_tests/callbacks/test_file.py+++ b/libs/langchain/tests/unit_tests/callbacks/test_file.py@@ -1,6 +1,5 @@import pathlibimport re-from typing import Optionalfrom langchain_core.callbacks import CallbackManagerForChainRunfrom typing_extensions import override@@ -30,7 +29,7 @@ class FakeChain(Chain):def _call(self,inputs: dict[str, str],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, str]:return {"bar": "bar"}diff --git a/libs/langchain/tests/unit_tests/callbacks/test_stdout.py b/libs/langchain/tests/unit_tests/callbacks/test_stdout.pyindex a0ebcba85e..4783e81682 100644--- a/libs/langchain/tests/unit_tests/callbacks/test_stdout.py+++ b/libs/langchain/tests/unit_tests/callbacks/test_stdout.py@@ -1,4 +1,4 @@-from typing import Any, Optional+from typing import Anyimport pytestfrom langchain_core.callbacks import CallbackManagerForChainRun@@ -29,7 +29,7 @@ class FakeChain(Chain):def _call(self,inputs: dict[str, str],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, str]:return {"bar": "bar"}diff --git a/libs/langchain/tests/unit_tests/chains/query_constructor/test_parser.py b/libs/langchain/tests/unit_tests/chains/query_constructor/test_parser.pyindex 9aba3693dc..8ac11349ef 100644--- a/libs/langchain/tests/unit_tests/chains/query_constructor/test_parser.py+++ b/libs/langchain/tests/unit_tests/chains/query_constructor/test_parser.py@@ -1,6 +1,6 @@"""Test LLM-generated structured query parsing."""-from typing import Any, Optional, cast+from typing import Any, castimport larkimport pytest@@ -145,7 +145,7 @@ def test_parse_date_value(x: str) -> None:),],)-def test_parse_datetime_value(x: str, expected: Optional[dict[str, str]]) -> None:+def test_parse_datetime_value(x: str, expected: dict[str, str] | None) -> None:"""Test parsing of datetime values with ISO 8601 format."""parsed = cast("Comparison", DEFAULT_PARSER.parse(f'eq("publishedAt", {x})'))actual = parsed.valuediff --git a/libs/langchain/tests/unit_tests/chains/test_base.py b/libs/langchain/tests/unit_tests/chains/test_base.pyindex 8f8e525f04..a0e21fab2b 100644--- a/libs/langchain/tests/unit_tests/chains/test_base.py+++ b/libs/langchain/tests/unit_tests/chains/test_base.py@@ -2,7 +2,7 @@import reimport uuid-from typing import Any, Optional+from typing import Anyimport pytestfrom langchain_core.callbacks.manager import CallbackManagerForChainRun@@ -26,7 +26,7 @@ class FakeMemory(BaseMemory):@overridedef load_memory_variables(self,- inputs: Optional[dict[str, Any]] = None,+ inputs: dict[str, Any] | None = None,) -> dict[str, str]:"""Return baz variable."""return {"baz": "foo"}@@ -59,7 +59,7 @@ class FakeChain(Chain):def _call(self,inputs: dict[str, str],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, str]:if self.be_correct:return {"bar": "baz"}diff --git a/libs/langchain/tests/unit_tests/chains/test_conversation.py b/libs/langchain/tests/unit_tests/chains/test_conversation.pyindex 58fceebb78..0913204b77 100644--- a/libs/langchain/tests/unit_tests/chains/test_conversation.py+++ b/libs/langchain/tests/unit_tests/chains/test_conversation.py@@ -1,7 +1,7 @@"""Test conversation chain and memory."""import re-from typing import Any, Optional+from typing import Anyimport pytestfrom langchain_core.callbacks import CallbackManagerForLLMRun@@ -31,8 +31,8 @@ class DummyLLM(LLM):def _call(self,prompt: str,- stop: Optional[list[str]] = None,- run_manager: Optional[CallbackManagerForLLMRun] = None,+ stop: list[str] | None = None,+ run_manager: CallbackManagerForLLMRun | None = None,**kwargs: Any,) -> str:self.last_prompt = promptdiff --git a/libs/langchain/tests/unit_tests/chains/test_hyde.py b/libs/langchain/tests/unit_tests/chains/test_hyde.pyindex 5d3355dcc2..d714733c2d 100644--- a/libs/langchain/tests/unit_tests/chains/test_hyde.py+++ b/libs/langchain/tests/unit_tests/chains/test_hyde.py@@ -1,6 +1,6 @@"""Test HyDE."""-from typing import Any, Optional+from typing import Anyimport numpy as npfrom langchain_core.callbacks.manager import (@@ -39,8 +39,8 @@ class FakeLLM(BaseLLM):def _generate(self,prompts: list[str],- stop: Optional[list[str]] = None,- run_manager: Optional[CallbackManagerForLLMRun] = None,+ stop: list[str] | None = None,+ run_manager: CallbackManagerForLLMRun | None = None,**kwargs: Any,) -> LLMResult:return LLMResult(generations=[[Generation(text="foo") for _ in range(self.n)]])@@ -49,8 +49,8 @@ class FakeLLM(BaseLLM):async def _agenerate(self,prompts: list[str],- stop: Optional[list[str]] = None,- run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,+ stop: list[str] | None = None,+ run_manager: AsyncCallbackManagerForLLMRun | None = None,**kwargs: Any,) -> LLMResult:return LLMResult(generations=[[Generation(text="foo") for _ in range(self.n)]])diff --git a/libs/langchain/tests/unit_tests/chains/test_sequential.py b/libs/langchain/tests/unit_tests/chains/test_sequential.pyindex dd0de9dbc0..d0c4e023ba 100644--- a/libs/langchain/tests/unit_tests/chains/test_sequential.py+++ b/libs/langchain/tests/unit_tests/chains/test_sequential.py@@ -1,7 +1,6 @@"""Test pipeline functionality."""import re-from typing import Optionalimport pytestfrom langchain_core.callbacks.manager import (@@ -37,7 +36,7 @@ class FakeChain(Chain):def _call(self,inputs: dict[str, str],- run_manager: Optional[CallbackManagerForChainRun] = None,+ run_manager: CallbackManagerForChainRun | None = None,) -> dict[str, str]:outputs = {}for var in self.output_variables:@@ -49,7 +48,7 @@ class FakeChain(Chain):async def _acall(self,inputs: dict[str, str],- run_manager: Optional[AsyncCallbackManagerForChainRun] = None,+ run_manager: AsyncCallbackManagerForChainRun | None = None,) -> dict[str, str]:outputs = {}for var in self.output_variables:diff --git a/libs/langchain/tests/unit_tests/chat_models/test_base.py b/libs/langchain/tests/unit_tests/chat_models/test_base.pyindex c85ad0d96c..686a627830 100644--- a/libs/langchain/tests/unit_tests/chat_models/test_base.py+++ b/libs/langchain/tests/unit_tests/chat_models/test_base.py@@ -1,5 +1,4 @@import os-from typing import Optionalfrom unittest import mockimport pytest@@ -38,7 +37,7 @@ def test_all_imports() -> None:("mixtral-8x7b-32768", "groq"),],)-def test_init_chat_model(model_name: str, model_provider: Optional[str]) -> None:+def test_init_chat_model(model_name: str, model_provider: str | None) -> None:llm1: BaseChatModel = init_chat_model(model_name,model_provider=model_provider,diff --git a/libs/langchain/tests/unit_tests/evaluation/agents/test_eval_chain.py b/libs/langchain/tests/unit_tests/evaluation/agents/test_eval_chain.pyindex 1139cc8823..e31943c4d0 100644--- a/libs/langchain/tests/unit_tests/evaluation/agents/test_eval_chain.py+++ b/libs/langchain/tests/unit_tests/evaluation/agents/test_eval_chain.py@@ -1,6 +1,6 @@"""Test agent trajectory evaluation chain."""-from typing import Any, Optional+from typing import Anyimport pytestfrom langchain_core.agents import AgentAction@@ -41,15 +41,15 @@ def foo(bar: str) -> str:class _FakeTrajectoryChatModel(FakeChatModel):queries: dict = Field(default_factory=dict)- sequential_responses: Optional[bool] = False+ sequential_responses: bool | None = Falseresponse_index: int = 0@overridedef _call(self,messages: list[BaseMessage],- stop: Optional[list[str]] = None,- run_manager: Optional[CallbackManagerForLLMRun] = None,+ stop: list[str] | None = None,+ run_manager: CallbackManagerForLLMRun | None = None,**kwargs: Any,) -> str:if self.sequential_responses:diff --git a/libs/langchain/tests/unit_tests/indexes/test_indexing.py b/libs/langchain/tests/unit_tests/indexes/test_indexing.pyindex 383ca1862a..ebc87aee00 100644--- a/libs/langchain/tests/unit_tests/indexes/test_indexing.py+++ b/libs/langchain/tests/unit_tests/indexes/test_indexing.py@@ -2,7 +2,6 @@ from collections.abc import AsyncIterator, Iterable, Iterator, Sequencefrom datetime import datetime, timezonefrom typing import (Any,- Optional,)from unittest.mock import patch@@ -47,14 +46,14 @@ class InMemoryVectorStore(VectorStore):self.permit_upserts = permit_upserts@override- def delete(self, ids: Optional[Sequence[str]] = None, **kwargs: Any) -> None:+ def delete(self, ids: Sequence[str] | None = None, **kwargs: Any) -> None:"""Delete the given documents from the store using their IDs."""if ids:for _id in ids:self.store.pop(_id, None)@override- async def adelete(self, ids: Optional[Sequence[str]] = None, **kwargs: Any) -> None:+ async def adelete(self, ids: Sequence[str] | None = None, **kwargs: Any) -> None:"""Delete the given documents from the store using their IDs."""if ids:for _id in ids:@@ -65,7 +64,7 @@ class InMemoryVectorStore(VectorStore):self,documents: Sequence[Document],*,- ids: Optional[Sequence[str]] = None,+ ids: Sequence[str] | None = None,**kwargs: Any,) -> list[str]:"""Add the given documents to the store (insert behavior)."""@@ -77,7 +76,7 @@ class InMemoryVectorStore(VectorStore):msg = "This is not implemented yet."raise NotImplementedError(msg)- for _id, document in zip(ids, documents):+ for _id, document in zip(ids, documents, strict=False):if _id in self.store and not self.permit_upserts:msg = f"Document with uid {_id} already exists in the store."raise ValueError(msg)@@ -90,7 +89,7 @@ class InMemoryVectorStore(VectorStore):self,documents: Sequence[Document],*,- ids: Optional[Sequence[str]] = None,+ ids: Sequence[str] | None = None,**kwargs: Any,) -> list[str]:if ids and len(ids) != len(documents):@@ -101,7 +100,7 @@ class InMemoryVectorStore(VectorStore):msg = "This is not implemented yet."raise NotImplementedError(msg)- for _id, document in zip(ids, documents):+ for _id, document in zip(ids, documents, strict=False):if _id in self.store and not self.permit_upserts:msg = f"Document with uid {_id} already exists in the store."raise ValueError(msg)@@ -111,7 +110,7 @@ class InMemoryVectorStore(VectorStore):def add_texts(self,texts: Iterable[str],- metadatas: Optional[list[dict[Any, Any]]] = None,+ metadatas: list[dict[Any, Any]] | None = None,**kwargs: Any,) -> list[str]:"""Add the given texts to the store (insert behavior)."""@@ -122,7 +121,7 @@ class InMemoryVectorStore(VectorStore):cls: type[VST],texts: list[str],embedding: Embeddings,- metadatas: Optional[list[dict[Any, Any]]] = None,+ metadatas: list[dict[Any, Any]] | None = None,**kwargs: Any,) -> VST:"""Create a vector store from a list of texts."""diff --git a/libs/langchain/tests/unit_tests/llms/fake_chat_model.py b/libs/langchain/tests/unit_tests/llms/fake_chat_model.pyindex 521279eaff..2cb65ac393 100644--- a/libs/langchain/tests/unit_tests/llms/fake_chat_model.py+++ b/libs/langchain/tests/unit_tests/llms/fake_chat_model.py@@ -2,7 +2,7 @@import refrom collections.abc import AsyncIterator, Iterator-from typing import Any, Optional, cast+from typing import Any, castfrom langchain_core.callbacks.manager import (AsyncCallbackManagerForLLMRun,@@ -26,8 +26,8 @@ class FakeChatModel(SimpleChatModel):def _call(self,messages: list[BaseMessage],- stop: Optional[list[str]] = None,- run_manager: Optional[CallbackManagerForLLMRun] = None,+ stop: list[str] | None = None,+ run_manager: CallbackManagerForLLMRun | None = None,**kwargs: Any,) -> str:return "fake response"@@ -36,8 +36,8 @@ class FakeChatModel(SimpleChatModel):async def _agenerate(self,messages: list[BaseMessage],- stop: Optional[list[str]] = None,- run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,+ stop: list[str] | None = None,+ run_manager: AsyncCallbackManagerForLLMRun | None = None,**kwargs: Any,) -> ChatResult:output_str = "fake response"@@ -83,8 +83,8 @@ class GenericFakeChatModel(BaseChatModel):def _generate(self,messages: list[BaseMessage],- stop: Optional[list[str]] = None,- run_manager: Optional[CallbackManagerForLLMRun] = None,+ stop: list[str] | None = None,+ run_manager: CallbackManagerForLLMRun | None = None,**kwargs: Any,) -> ChatResult:"""Top Level call."""@@ -95,8 +95,8 @@ class GenericFakeChatModel(BaseChatModel):def _stream(self,messages: list[BaseMessage],- stop: Optional[list[str]] = None,- run_manager: Optional[CallbackManagerForLLMRun] = None,+ stop: list[str] | None = None,+ run_manager: CallbackManagerForLLMRun | None = None,**kwargs: Any,) -> Iterator[ChatGenerationChunk]:"""Stream the output of the model."""@@ -201,8 +201,8 @@ class GenericFakeChatModel(BaseChatModel):async def _astream(self,messages: list[BaseMessage],- stop: Optional[list[str]] = None,- run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,+ stop: list[str] | None = None,+ run_manager: AsyncCallbackManagerForLLMRun | None = None,**kwargs: Any,) -> AsyncIterator[ChatGenerationChunk]:"""Stream the output of the model."""diff --git a/libs/langchain/tests/unit_tests/llms/fake_llm.py b/libs/langchain/tests/unit_tests/llms/fake_llm.pyindex f403374425..ceeea9fcef 100644--- a/libs/langchain/tests/unit_tests/llms/fake_llm.py+++ b/libs/langchain/tests/unit_tests/llms/fake_llm.py@@ -1,7 +1,7 @@"""Fake LLM wrapper for testing purposes."""from collections.abc import Mapping-from typing import Any, Optional, cast+from typing import Any, castfrom langchain_core.callbacks.manager import CallbackManagerForLLMRunfrom langchain_core.language_models.llms import LLM@@ -12,8 +12,8 @@ from typing_extensions import overrideclass FakeLLM(LLM):"""Fake LLM wrapper for testing purposes."""- queries: Optional[Mapping] = None- sequential_responses: Optional[bool] = False+ queries: Mapping | None = None+ sequential_responses: bool | None = Falseresponse_index: int = 0@model_validator(mode="before")@@ -37,8 +37,8 @@ class FakeLLM(LLM):def _call(self,prompt: str,- stop: Optional[list[str]] = None,- run_manager: Optional[CallbackManagerForLLMRun] = None,+ stop: list[str] | None = None,+ run_manager: CallbackManagerForLLMRun | None = None,**kwargs: Any,) -> str:if self.sequential_responses:diff --git a/libs/langchain/tests/unit_tests/llms/test_fake_chat_model.py b/libs/langchain/tests/unit_tests/llms/test_fake_chat_model.pyindex 4bcb363d8f..88cd91c3d1 100644--- a/libs/langchain/tests/unit_tests/llms/test_fake_chat_model.py+++ b/libs/langchain/tests/unit_tests/llms/test_fake_chat_model.py@@ -1,7 +1,7 @@"""Tests for verifying that testing utility code works as expected."""from itertools import cycle-from typing import Any, Optional, Union+from typing import Anyfrom uuid import UUIDfrom langchain_core.callbacks.base import AsyncCallbackHandler@@ -161,9 +161,9 @@ async def test_callback_handlers() -> None:messages: list[list[BaseMessage]],*,run_id: UUID,- parent_run_id: Optional[UUID] = None,- tags: Optional[list[str]] = None,- metadata: Optional[dict[str, Any]] = None,+ parent_run_id: UUID | None = None,+ tags: list[str] | None = None,+ metadata: dict[str, Any] | None = None,**kwargs: Any,) -> Any:# Do nothing@@ -175,10 +175,10 @@ async def test_callback_handlers() -> None:self,token: str,*,- chunk: Optional[Union[GenerationChunk, ChatGenerationChunk]] = None,+ chunk: GenerationChunk | ChatGenerationChunk | None = None,run_id: UUID,- parent_run_id: Optional[UUID] = None,- tags: Optional[list[str]] = None,+ parent_run_id: UUID | None = None,+ tags: list[str] | None = None,**kwargs: Any,) -> None:self.store.append(token)diff --git a/libs/langchain/tests/unit_tests/output_parsers/test_yaml_parser.py b/libs/langchain/tests/unit_tests/output_parsers/test_yaml_parser.pyindex be79e63c0d..cca1409ff4 100644--- a/libs/langchain/tests/unit_tests/output_parsers/test_yaml_parser.py+++ b/libs/langchain/tests/unit_tests/output_parsers/test_yaml_parser.py@@ -1,7 +1,6 @@"""Test yamlOutputParser."""from enum import Enum-from typing import Optionalimport pytestfrom langchain_core.exceptions import OutputParserException@@ -20,7 +19,7 @@ class Actions(Enum):class TestModel(BaseModel):action: Actions = Field(description="Action to be performed")action_input: str = Field(description="Input to be used in the action")- additional_fields: Optional[str] = Field(+ additional_fields: str | None = Field(description="Additional fields",default=None,)diff --git a/libs/langchain/tests/unit_tests/retrievers/self_query/test_base.py b/libs/langchain/tests/unit_tests/retrievers/self_query/test_base.pyindex c5c3390aa7..a2e98a8efb 100644--- a/libs/langchain/tests/unit_tests/retrievers/self_query/test_base.py+++ b/libs/langchain/tests/unit_tests/retrievers/self_query/test_base.py@@ -1,4 +1,4 @@-from typing import Any, Union+from typing import Anyimport pytestfrom langchain_core.callbacks.manager import (@@ -35,7 +35,7 @@ class FakeTranslator(Visitor):)allowed_operators = (Operator.AND, Operator.OR, Operator.NOT)- def _format_func(self, func: Union[Operator, Comparator]) -> str:+ def _format_func(self, func: Operator | Comparator) -> str:self._validate_func(func)return f"${func.value}"diff --git a/libs/langchain/tests/unit_tests/retrievers/test_ensemble.py b/libs/langchain/tests/unit_tests/retrievers/test_ensemble.pyindex b5c659710c..1826b379e7 100644--- a/libs/langchain/tests/unit_tests/retrievers/test_ensemble.py+++ b/libs/langchain/tests/unit_tests/retrievers/test_ensemble.py@@ -1,5 +1,3 @@-from typing import Optional-from langchain_core.callbacks.manager import CallbackManagerForRetrieverRunfrom langchain_core.documents import Documentfrom langchain_core.retrievers import BaseRetriever@@ -16,7 +14,7 @@ class MockRetriever(BaseRetriever):self,query: str,*,- run_manager: Optional[CallbackManagerForRetrieverRun] = None,+ run_manager: CallbackManagerForRetrieverRun | None = None,) -> list[Document]:"""Return the documents."""return self.docsdiff --git a/libs/langchain/tests/unit_tests/retrievers/test_multi_vector.py b/libs/langchain/tests/unit_tests/retrievers/test_multi_vector.pyindex a37febb7b2..6def7ebe0d 100644--- a/libs/langchain/tests/unit_tests/retrievers/test_multi_vector.py+++ b/libs/langchain/tests/unit_tests/retrievers/test_multi_vector.py@@ -1,4 +1,5 @@-from typing import Any, Callable+from collections.abc import Callable+from typing import Anyfrom langchain_core.documents import Documentfrom typing_extensions import override@@ -50,7 +51,7 @@ def test_multi_vector_retriever_initialization() -> None:)documents = [Document(page_content="test document", metadata={"doc_id": "1"})]retriever.vectorstore.add_documents(documents, ids=["1"])- retriever.docstore.mset(list(zip(["1"], documents)))+ retriever.docstore.mset(list(zip(["1"], documents, strict=False)))results = retriever.invoke("1")assert len(results) > 0assert results[0].page_content == "test document"@@ -65,7 +66,7 @@ async def test_multi_vector_retriever_initialization_async() -> None:)documents = [Document(page_content="test document", metadata={"doc_id": "1"})]await retriever.vectorstore.aadd_documents(documents, ids=["1"])- await retriever.docstore.amset(list(zip(["1"], documents)))+ await retriever.docstore.amset(list(zip(["1"], documents, strict=False)))results = await retriever.ainvoke("1")assert len(results) > 0assert results[0].page_content == "test document"@@ -84,7 +85,7 @@ def test_multi_vector_retriever_similarity_search_with_score() -> None:search_kwargs={"score_threshold": 0.5},search_type=SearchType.similarity_score_threshold,)- retriever.docstore.mset(list(zip(["1"], documents)))+ retriever.docstore.mset(list(zip(["1"], documents, strict=False)))results = retriever.invoke("1")assert len(results) == 1assert results[0].page_content == "test document"@@ -97,7 +98,7 @@ def test_multi_vector_retriever_similarity_search_with_score() -> None:search_kwargs={"score_threshold": 0.9},search_type=SearchType.similarity_score_threshold,)- retriever.docstore.mset(list(zip(["1"], documents)))+ retriever.docstore.mset(list(zip(["1"], documents, strict=False)))results = retriever.invoke("1")assert len(results) == 0@@ -115,7 +116,7 @@ async def test_multi_vector_retriever_similarity_search_with_score_async() -> Nosearch_kwargs={"score_threshold": 0.5},search_type=SearchType.similarity_score_threshold,)- await retriever.docstore.amset(list(zip(["1"], documents)))+ await retriever.docstore.amset(list(zip(["1"], documents, strict=False)))results = retriever.invoke("1")assert len(results) == 1assert results[0].page_content == "test document"@@ -128,6 +129,6 @@ async def test_multi_vector_retriever_similarity_search_with_score_async() -> Nosearch_kwargs={"score_threshold": 0.9},search_type=SearchType.similarity_score_threshold,)- await retriever.docstore.amset(list(zip(["1"], documents)))+ await retriever.docstore.amset(list(zip(["1"], documents, strict=False)))results = retriever.invoke("1")assert len(results) == 0diff --git a/libs/langchain/tests/unit_tests/retrievers/test_time_weighted_retriever.py b/libs/langchain/tests/unit_tests/retrievers/test_time_weighted_retriever.pyindex 7f15b0f8cd..dbc9ecff50 100644--- a/libs/langchain/tests/unit_tests/retrievers/test_time_weighted_retriever.py+++ b/libs/langchain/tests/unit_tests/retrievers/test_time_weighted_retriever.py@@ -2,7 +2,7 @@from collections.abc import Iterablefrom datetime import datetime, timedelta-from typing import Any, Optional+from typing import Anyimport pytestfrom langchain_core.documents import Document@@ -36,7 +36,7 @@ class MockVectorStore(VectorStore):def add_texts(self,texts: Iterable[str],- metadatas: Optional[list[dict]] = None,+ metadatas: list[dict] | None = None,**kwargs: Any,) -> list[str]:return list(texts)@@ -56,7 +56,7 @@ class MockVectorStore(VectorStore):cls: type["MockVectorStore"],texts: list[str],embedding: Embeddings,- metadatas: Optional[list[dict]] = None,+ metadatas: list[dict] | None = None,**kwargs: Any,) -> "MockVectorStore":return cls()diff --git a/libs/langchain/tests/unit_tests/runnables/test_openai_functions.py b/libs/langchain/tests/unit_tests/runnables/test_openai_functions.pyindex 18f2b3c3b5..f544cfdecc 100644--- a/libs/langchain/tests/unit_tests/runnables/test_openai_functions.py+++ b/libs/langchain/tests/unit_tests/runnables/test_openai_functions.py@@ -1,4 +1,4 @@-from typing import Any, Optional+from typing import Anyfrom langchain_core.callbacks.manager import CallbackManagerForLLMRunfrom langchain_core.language_models.chat_models import BaseChatModel@@ -20,8 +20,8 @@ class FakeChatOpenAI(BaseChatModel):def _generate(self,messages: list[BaseMessage],- stop: Optional[list[str]] = None,- run_manager: Optional[CallbackManagerForLLMRun] = None,+ stop: list[str] | None = None,+ run_manager: CallbackManagerForLLMRun | None = None,**kwargs: Any,) -> ChatResult:return ChatResult(diff --git a/libs/langchain/tests/unit_tests/test_imports.py b/libs/langchain/tests/unit_tests/test_imports.pyindex cfceabc6cf..b3a799ef90 100644--- a/libs/langchain/tests/unit_tests/test_imports.py+++ b/libs/langchain/tests/unit_tests/test_imports.py@@ -2,7 +2,7 @@ import astimport importlibimport warningsfrom pathlib import Path-from typing import Any, Optional+from typing import Any# Attempt to recursively import all modules in langchainPKG_ROOT = Path(__file__).parent.parent.parent@@ -107,7 +107,7 @@ def test_no_more_changes_to_proxy_community() -> None:)-def extract_deprecated_lookup(file_path: str) -> Optional[dict[str, Any]]:+def extract_deprecated_lookup(file_path: str) -> dict[str, Any] | None:"""Detect and extracts the value of a dictionary named DEPRECATED_LOOKUP.This variable is located in the global namespace of a Python file.@@ -142,7 +142,7 @@ def _dict_from_ast(node: ast.Dict) -> dict[str, str]:dict: The corresponding Python dictionary."""result: dict[str, str] = {}- for key, value in zip(node.keys, node.values):+ for key, value in zip(node.keys, node.values, strict=False):py_key = _literal_eval_str(key) # type: ignore[arg-type]py_value = _literal_eval_str(value)result[py_key] = py_valuediff --git a/libs/langchain/tests/unit_tests/test_schema.py b/libs/langchain/tests/unit_tests/test_schema.pyindex ff8f00d561..c8456030dd 100644--- a/libs/langchain/tests/unit_tests/test_schema.py+++ b/libs/langchain/tests/unit_tests/test_schema.py@@ -1,7 +1,5 @@"""Test formatting functionality."""-from typing import Union-import pytestfrom langchain_core.agents import AgentAction, AgentActionMessageLog, AgentFinishfrom langchain_core.documents import Document@@ -27,27 +25,25 @@ from pydantic import RootModel, ValidationErrordef test_serialization_of_wellknown_objects() -> None:"""Test that pydantic is able to serialize and deserialize well known objects."""well_known_lc_object = RootModel[- Union[- Document,- HumanMessage,- SystemMessage,- ChatMessage,- FunctionMessage,- FunctionMessageChunk,- AIMessage,- HumanMessageChunk,- SystemMessageChunk,- ChatMessageChunk,- AIMessageChunk,- StringPromptValue,- ChatPromptValueConcrete,- AgentFinish,- AgentAction,- AgentActionMessageLog,- ChatGeneration,- Generation,- ChatGenerationChunk,- ]+ Document+ | HumanMessage+ | SystemMessage+ | ChatMessage+ | FunctionMessage+ | FunctionMessageChunk+ | AIMessage+ | HumanMessageChunk+ | SystemMessageChunk+ | ChatMessageChunk+ | AIMessageChunk+ | StringPromptValue+ | ChatPromptValueConcrete+ | AgentFinish+ | AgentAction+ | AgentActionMessageLog+ | ChatGeneration+ | Generation+ | ChatGenerationChunk,]lc_objects = [