langchain 1.0.0a8__py3-none-any.whl → 1.0.0a10__py3-none-any.whl

langchain/__init__.py

@@ -2,7 +2,7 @@
 
 from typing import Any
 
-__version__ = "1.0.0a6"
+__version__ = "1.0.0a10"
 
 
 def __getattr__(name: str) -> Any:  # noqa: ANN401

langchain/agents/__init__.py

@@ -1,7 +1,7 @@
 """langgraph.prebuilt exposes a higher-level API for creating and executing agents and tools."""
 
 from langchain.agents.react_agent import AgentState, create_agent
-from langchain.agents.tool_node import ToolNode
+from langchain.tools import ToolNode
 
 __all__ = [
     "AgentState",

langchain/agents/middleware/human_in_the_loop.py

@@ -169,7 +169,7 @@ class HumanInTheLoopMiddleware(AgentMiddleware):
             return None
 
         # Process all tool calls that require interrupts
-        approved_tool_calls: list[ToolCall] = auto_approved_tool_calls.copy()
+        revised_tool_calls: list[ToolCall] = auto_approved_tool_calls.copy()
         artificial_tool_messages: list[ToolMessage] = []
 
         # Create interrupt requests for all tools that need approval
@@ -210,10 +210,10 @@ class HumanInTheLoopMiddleware(AgentMiddleware):
             config = self.interrupt_on[tool_call["name"]]
 
             if response["type"] == "accept" and config.get("allow_accept"):
-                approved_tool_calls.append(tool_call)
+                revised_tool_calls.append(tool_call)
             elif response["type"] == "edit" and config.get("allow_edit"):
                 edited_action = response["args"]
-                approved_tool_calls.append(
+                revised_tool_calls.append(
                     ToolCall(
                         type="tool_call",
                         name=edited_action["action"],
@@ -233,6 +233,7 @@ class HumanInTheLoopMiddleware(AgentMiddleware):
                     tool_call_id=tool_call["id"],
                     status="error",
                 )
+                revised_tool_calls.append(tool_call)
                 artificial_tool_messages.append(tool_message)
             else:
                 allowed_actions = [
@@ -249,9 +250,6 @@ class HumanInTheLoopMiddleware(AgentMiddleware):
                 raise ValueError(msg)
 
         # Update the AI message to only include approved tool calls
-        last_ai_msg.tool_calls = approved_tool_calls
+        last_ai_msg.tool_calls = revised_tool_calls
 
-        if len(approved_tool_calls) > 0:
-            return {"messages": [last_ai_msg, *artificial_tool_messages]}
-
-        return {"jump_to": "model", "messages": artificial_tool_messages}
+        return {"messages": [last_ai_msg, *artificial_tool_messages]}

langchain/agents/middleware/prompt_caching.py

@@ -1,6 +1,6 @@
 """Anthropic prompt caching middleware."""
 
-from typing import Literal
+from typing import Any, Literal
 from warnings import warn
 
 from langchain.agents.middleware.types import AgentMiddleware, ModelRequest
@@ -42,6 +42,7 @@ class AnthropicPromptCachingMiddleware(AgentMiddleware):
     def modify_model_request(  # type: ignore[override]
         self,
         request: ModelRequest,
+        state: dict[str, Any],  # noqa: ARG002
     ) -> ModelRequest:
         """Modify the model request to add cache control blocks."""
         try:

langchain/agents/middleware/types.py

@@ -45,7 +45,7 @@ __all__ = [
     "PublicAgentState",
 ]
 
-JumpTo = Literal["tools", "model", "__end__"]
+JumpTo = Literal["tools", "model", "end"]
 """Destination to jump to when a middleware node returns."""
 
 ResponseT = TypeVar("ResponseT")
@@ -237,7 +237,7 @@ def before_model(
             AgentState schema.
         tools: Optional list of additional tools to register with this middleware.
         jump_to: Optional list of valid jump destinations for conditional edges.
-            Valid values are: "tools", "model", "__end__"
+            Valid values are: "tools", "model", "end"
         name: Optional name for the generated middleware class. If not provided,
             uses the decorated function's name.
 
@@ -260,10 +260,10 @@ def before_model(
 
         Advanced usage with runtime and conditional jumping:
         ```python
-        @before_model(jump_to=["__end__"])
+        @before_model(jump_to=["end"])
         def conditional_before_model(state: AgentState, runtime: Runtime) -> dict[str, Any] | None:
             if some_condition(state):
-                return {"jump_to": "__end__"}
+                return {"jump_to": "end"}
             return None
         ```
 
@@ -474,7 +474,7 @@ def after_model(
             AgentState schema.
         tools: Optional list of additional tools to register with this middleware.
         jump_to: Optional list of valid jump destinations for conditional edges.
-            Valid values are: "tools", "model", "__end__"
+            Valid values are: "tools", "model", "end"
         name: Optional name for the generated middleware class. If not provided,
             uses the decorated function's name.
 

langchain/agents/middleware_agent.py

@@ -33,8 +33,8 @@ from langchain.agents.structured_output import (
     StructuredOutputValidationError,
     ToolStrategy,
 )
-from langchain.agents.tool_node import ToolNode
 from langchain.chat_models import init_chat_model
+from langchain.tools import ToolNode
 
 STRUCTURED_OUTPUT_ERROR_TEMPLATE = "Error: {error}\n Please fix your mistakes."
 
@@ -505,8 +505,10 @@ def create_agent(  # noqa: PLR0915
 def _resolve_jump(jump_to: JumpTo | None, first_node: str) -> str | None:
     if jump_to == "model":
         return first_node
-    if jump_to:
-        return jump_to
+    if jump_to == "end":
+        return "__end__"
+    if jump_to == "tools":
+        return "tools"
     return None
 
 
@@ -530,29 +532,34 @@ def _make_model_to_tools_edge(
     first_node: str, structured_output_tools: dict[str, OutputToolBinding], tool_node: ToolNode
 ) -> Callable[[dict[str, Any]], str | list[Send] | None]:
     def model_to_tools(state: dict[str, Any]) -> str | list[Send] | None:
+        # 1. if there's an explicit jump_to in the state, use it
         if jump_to := state.get("jump_to"):
             return _resolve_jump(jump_to, first_node)
 
         last_ai_message, tool_messages = _fetch_last_ai_and_tool_messages(state["messages"])
         tool_message_ids = [m.tool_call_id for m in tool_messages]
 
+        # 2. if the model hasn't called any tools, jump to END
+        # this is the classic exit condition for an agent loop
+        if len(last_ai_message.tool_calls) == 0:
+            return END
+
         pending_tool_calls = [
             c
             for c in last_ai_message.tool_calls
             if c["id"] not in tool_message_ids and c["name"] not in structured_output_tools
         ]
 
+        # 3. if there are pending tool calls, jump to the tool node
         if pending_tool_calls:
-            # imo we should not be injecting state, store here,
-            # this should be done by the tool node itself ideally but this is a consequence
-            # of using Send w/ tool calls directly which allows more intuitive interrupt behavior
-            # largely internal so can be fixed later
             pending_tool_calls = [
                 tool_node.inject_tool_args(call, state, None) for call in pending_tool_calls
             ]
             return [Send("tools", [tool_call]) for tool_call in pending_tool_calls]
 
-        return END
+        # 4. AIMessage has tool calls, but there are no pending tool calls
+        # which suggests the injection of artificial tool messages. jump to the first node
+        return first_node
 
     return model_to_tools
 
@@ -602,7 +609,7 @@ def _add_middleware_edge(
 
         destinations = [default_destination]
 
-        if "__end__" in jump_to:
+        if "end" in jump_to:
             destinations.append(END)
         if "tools" in jump_to:
             destinations.append("tools")

langchain/agents/react_agent.py

@@ -54,8 +54,8 @@ from langchain.agents.structured_output import (
     StructuredOutputValidationError,
     ToolStrategy,
 )
-from langchain.agents.tool_node import ToolNode
 from langchain.chat_models import init_chat_model
+from langchain.tools import ToolNode
 
 if TYPE_CHECKING:
     from langchain_core.tools import BaseTool
@@ -971,7 +971,7 @@ def create_agent(  # noqa: D417
                 return model.bind_tools(tools)
             ```
 
-            !!! note "Dynamic Model Requirements"
+            .. note::
                 Ensure returned models have appropriate tools bound via
                 `.bind_tools()` and support required functionality. Bound tools
                 must be a subset of those specified in the `tools` parameter.
@@ -985,10 +985,10 @@ def create_agent(  # noqa: D417
               of the list of messages in state["messages"].
             - SystemMessage: this is added to the beginning of the list of messages
               in state["messages"].
-            - Callable: This function should take in full graph state and the output is then passed
-              to the language model.
-            - Runnable: This runnable should take in full graph state and the output is then passed
-              to the language model.
+            - Callable: This function should take in full graph state and the output is
+              then passed to the language model.
+            - Runnable: This runnable should take in full graph state and the output is
+              then passed to the language model.
 
         response_format: An optional UsingToolStrategy configuration for structured responses.
 
@@ -1002,7 +1002,8 @@ def create_agent(  # noqa: D417
 
                 - schemas: A sequence of ResponseSchema objects that define
                   the structured output format
-                - tool_choice: Either "required" or "auto" to control when structured output is used
+                - tool_choice: Either "required" or "auto" to control when structured
+                  output is used
 
             Each ResponseSchema contains:
 
@@ -1011,12 +1012,12 @@ def create_agent(  # noqa: D417
                 - description: Optional custom description (defaults to model docstring)
                 - strict: Whether to enforce strict validation
 
-            !!! Important
+            .. important::
                 `response_format` requires the model to support tool calling
 
-            !!! Note
-                Structured responses are handled directly in the model call node via tool calls,
-                eliminating the need for separate structured response nodes.
+            .. note::
+                Structured responses are handled directly in the model call node via
+                tool calls, eliminating the need for separate structured response nodes.
 
         pre_model_hook: An optional node to add before the `agent` node
             (i.e., the node that calls the LLM).
@@ -1037,12 +1038,12 @@ def create_agent(  # noqa: D417
                 }
                 ```
 
-            !!! Important
+            .. important::
                 At least one of `messages` or `llm_input_messages` MUST be provided
                 and will be used as an input to the `agent` node.
                 The rest of the keys will be added to the graph state.
 
-            !!! Warning
+            .. warning::
                 If you are returning `messages` in the pre-model hook,
                 you should OVERWRITE the `messages` key by doing the following:
 
@@ -1059,7 +1060,7 @@ def create_agent(  # noqa: D417
             Post-model hook must be a callable or a runnable that takes in
             current graph state and returns a state update.
 
-            !!! Note
+            .. note::
                 Only available with `version="v2"`.
         state_schema: An optional state schema that defines graph state.
             Must have `messages` and `remaining_steps` keys.
@@ -1092,7 +1093,7 @@ def create_agent(  # noqa: D417
             another graph as a subgraph node -
             particularly useful for building multi-agent systems.
 
-    !!! warning "`config_schema` Deprecated"
+    .. warning::
         The `config_schema` parameter is deprecated in v0.6.0 and support will be removed in v2.0.0.
         Please use `context_schema` instead to specify the schema for run-scoped context.
 

langchain/tools/__init__.py

@@ -8,10 +8,19 @@ from langchain_core.tools import (
     tool,
 )
 
+from langchain.tools.tool_node import (
+    InjectedState,
+    InjectedStore,
+    ToolNode,
+)
+
 __all__ = [
     "BaseTool",
+    "InjectedState",
+    "InjectedStore",
     "InjectedToolArg",
     "InjectedToolCallId",
     "ToolException",
+    "ToolNode",
     "tool",
 ]

langchain/{agents → tools}/tool_node.py

@@ -21,7 +21,7 @@ Key Components:
 Typical Usage:
     ```python
     from langchain_core.tools import tool
-    from langchain.agents import ToolNode
+    from langchain.tools import ToolNode
 
 
     @tool
@@ -344,7 +344,7 @@ class ToolNode(RunnableCallable):
         Basic usage:
 
         ```python
-        from langchain.agents import ToolNode
+        from langchain.tools import ToolNode
         from langchain_core.tools import tool
 
         @tool
@@ -359,7 +359,7 @@ class ToolNode(RunnableCallable):
 
         ```python
         from typing_extensions import Annotated
-        from langgraph.agents.tool_node import InjectedState
+        from langchain.tools import InjectedState
 
         @tool
         def context_tool(query: str, state: Annotated[dict, InjectedState]) -> str:
@@ -885,7 +885,8 @@ def tools_condition(
 
         ```python
         from langgraph.graph import StateGraph
-        from langgraph.agents.tool_node import ToolNode, tools_condition
+        from langchain.tools import ToolNode
+        from langchain.tools.tool_node import tools_condition
         from typing_extensions import TypedDict
 
 
@@ -950,9 +951,7 @@ class InjectedState(InjectedToolArg):
         from typing_extensions import Annotated, TypedDict
 
         from langchain_core.messages import BaseMessage, AIMessage
-        from langchain_core.tools import tool
-
-        from langgraph.agents.tool_node import InjectedState, ToolNode
+        from langchain.tools import InjectedState, ToolNode, tool
 
 
         class AgentState(TypedDict):
@@ -1020,15 +1019,14 @@ class InjectedStore(InjectedToolArg):
     for maintaining context, user preferences, or any other data that needs to
     persist beyond individual workflow executions.
 
-    !!! Warning
+    .. warning::
         `InjectedStore` annotation requires `langchain-core >= 0.3.8`
 
     Example:
         ```python
         from typing_extensions import Annotated
-        from langchain_core.tools import tool
         from langgraph.store.memory import InMemoryStore
-        from langgraph.agents.tool_node import InjectedStore, ToolNode
+        from langchain.tools import InjectedStore, ToolNode, tool
 
         @tool
         def save_preference(

{langchain-1.0.0a8.dist-info → langchain-1.0.0a10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: langchain
-Version: 1.0.0a8
+Version: 1.0.0a10
 Summary: Building applications with LLMs through composability
 License: MIT
 Project-URL: Source Code, https://github.com/langchain-ai/langchain/tree/master/libs/langchain
@@ -9,7 +9,7 @@ Project-URL: repository, https://github.com/langchain-ai/langchain
 Requires-Python: <4.0.0,>=3.10.0
 Requires-Dist: langchain-core<2.0.0,>=0.3.75
 Requires-Dist: langchain-text-splitters<2.0.0,>=0.3.11
-Requires-Dist: langgraph<2.0.0,>=0.6.7
+Requires-Dist: langgraph==1.0.0a4
 Requires-Dist: pydantic<3.0.0,>=2.7.4
 Provides-Extra: community
 Requires-Dist: langchain-community; extra == "community"

{langchain-1.0.0a8.dist-info → langchain-1.0.0a10.dist-info}/RECORD

@@ -1,26 +1,25 @@
-langchain-1.0.0a8.dist-info/METADATA,sha256=slSRaiJXGZdoNrLCLCYpJqqaPdM0keHqtv2aCBHLC7w,6259
-langchain-1.0.0a8.dist-info/WHEEL,sha256=9P2ygRxDrTJz3gsagc0Z96ukrxjr-LFBGOgv3AuKlCA,90
-langchain-1.0.0a8.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
-langchain-1.0.0a8.dist-info/licenses/LICENSE,sha256=TsZ-TKbmch26hJssqCJhWXyGph7iFLvyFBYAa3stBHg,1067
-langchain/__init__.py,sha256=Z6r4MjNaC6DSyiMgFSRmi8EhizelVIOb_CVJJRAVjDc,604
+langchain-1.0.0a10.dist-info/METADATA,sha256=1--JBKKepNpXt-uDW1W7YUlJXTIKzRgF1ixdCchWKFM,6255
+langchain-1.0.0a10.dist-info/WHEEL,sha256=9P2ygRxDrTJz3gsagc0Z96ukrxjr-LFBGOgv3AuKlCA,90
+langchain-1.0.0a10.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
+langchain-1.0.0a10.dist-info/licenses/LICENSE,sha256=TsZ-TKbmch26hJssqCJhWXyGph7iFLvyFBYAa3stBHg,1067
+langchain/__init__.py,sha256=F9IyeZPtTvxD-i2stOzPvGbIUEkUwc-qEFBGM8jDI2U,605
 langchain/_internal/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 langchain/_internal/_documents.py,sha256=z9wAPukoASOMw4WTFFBKCCZYsvsKbo-Cq6CeHjdq9eE,1045
 langchain/_internal/_lazy_import.py,sha256=S_iSAxGvW7lVcUQYgi45KG8XhWZzkORsZ_olPMZPlqU,1258
 langchain/_internal/_prompts.py,sha256=MJ11D0MHbxb3guVGWKBcdjH3QdfBXWB2FO0g00wympc,5912
 langchain/_internal/_typing.py,sha256=lV5NUl0SggnjlJ1CrfK-hna2OMyH02vZwrSmub2FDc0,1657
 langchain/_internal/_utils.py,sha256=lG8X9muiRAWtQjRPudq-1x-wHbk0J3spu_rYZckVdYs,251
-langchain/agents/__init__.py,sha256=NG2S3dic9L3i4sAD9mpgaTv6Dl4L3u45xxK6jn-I4W8,281
+langchain/agents/__init__.py,sha256=a-h5B7Fx19y6CMSHRJh6t7c3Y0MLUKw11Jx5Hk10Als,270
 langchain/agents/_internal/__init__.py,sha256=5nNBeaeQIvv9IOQjY4_aNW8pffWzMXQgi0b6Nx-WghM,37
 langchain/agents/_internal/_typing.py,sha256=JoWa-KL5uLNeq6yrm56wnIvhDeFnCt2fTzgUcj5zWy4,270
 langchain/agents/middleware/__init__.py,sha256=-NzMTmD5ogpzlsqHGjv6SnTrfXqU3vTahGUoGDk299U,511
-langchain/agents/middleware/human_in_the_loop.py,sha256=_6THKNzp1dvYBwBLdnZ9PXsHJP3uedn4A60ZON4xlvI,10301
-langchain/agents/middleware/prompt_caching.py,sha256=QLoWdd9jUiXAytGqbXW0I_Mg8WgrgTBO8gOZ-s8Bx8g,3081
+langchain/agents/middleware/human_in_the_loop.py,sha256=RH5uuPLdJBdLivLmsx-KpgkzjAq8tIeANLJa74u4h_s,10230
+langchain/agents/middleware/prompt_caching.py,sha256=AwcsTUSIE0Ur2TeovfX-KTznv7GJdwbYFnIfSE60Wds,3133
 langchain/agents/middleware/summarization.py,sha256=qqEqAuJXQ5rfewhFHftHLnrX8jhdMu9dPfz0akhzfuc,10281
-langchain/agents/middleware/types.py,sha256=a9B6Ihx12mNTroopL1SqHxsO51ZfSkxdtkPeZXw8EJc,18606
-langchain/agents/middleware_agent.py,sha256=fncjAFNsqZqEkDYSsBfq-goxN4GqNlQixirWRBguXhs,23847
-langchain/agents/react_agent.py,sha256=6ZNI2dp0hTL7hTm7ao-HkQ3hmVvBQuFu9pJz0PSK_eg,49712
+langchain/agents/middleware/types.py,sha256=68VmyBQ5294Yi6SwOC9-LqdkdRLg8q3gP1FYs5XCpV0,18586
+langchain/agents/middleware_agent.py,sha256=BWuqQy4ACIZkQy89yRqnlg7E6vC2iqxbSQgw87NRRY4,24091
+langchain/agents/react_agent.py,sha256=SL9KxKEqLdRcyrt2kPHMbnYvqizENL1uLxNzjDPDjpk,49668
 langchain/agents/structured_output.py,sha256=QWNafJx7au_jJawJgIfovnDoP8Z9mLxDZNvDX_1RRJ0,13327
-langchain/agents/tool_node.py,sha256=QabTfIi8nGrwfzaSOeWfyHos6sgXjFTdRXexQG7u2HE,46596
 langchain/chat_models/__init__.py,sha256=PTq9qskQEbqXYAcUUxUXDsugOcwISgFhv4w40JgkbgU,181
 langchain/chat_models/base.py,sha256=kzEGebhYKoAcRIEeIPRmjwMx8F6y4Xw2TSC52W9BsWI,34754
 langchain/documents/__init__.py,sha256=DjuBCy1TQbem4Vz8SsCcGAbZeFwW5KgGPvDrA8e9oGA,94
@@ -34,5 +33,6 @@ langchain/storage/encoder_backed.py,sha256=4h_4ZgP_B9p1lwVMNdBgpEIC7UDAp--ncp9wm
 langchain/storage/exceptions.py,sha256=Fl_8tON3KmByBKwXtno5WSj0-c2RiZxnhw3gv5aS2T8,114
 langchain/storage/in_memory.py,sha256=ozrmu0EtaJJVSAzK_u7nzxWpr9OOscWkANHSg-qIVYQ,369
 langchain/text_splitter.py,sha256=yxWs4secpnkfK6VZDiNJNdlYOrRZ18RQZj1S3xNQ73A,1554
-langchain/tools/__init__.py,sha256=NYQzLxW2iI5Twu3voefVC-dJEI4Wgh7jC311CQEpvZs,252
-langchain-1.0.0a8.dist-info/RECORD,,
+langchain/tools/__init__.py,sha256=tWlUqT7jrnf1ouhMctuUkaYBWEuOPD3JQX4Y8uTHk5w,405
+langchain/tools/tool_node.py,sha256=_qwqqTbjNh3edcd3G50ZXHsqb0rg_LDlhGWYGiAUStw,46515
+langchain-1.0.0a10.dist-info/RECORD,,