langchain 1.2.4__tar.gz → 1.2.5__tar.gz

{langchain-1.2.4 → langchain-1.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langchain
-Version: 1.2.4
+Version: 1.2.5
 Summary: Building applications with LLMs through composability
 Project-URL: Homepage, https://docs.langchain.com/
 Project-URL: Documentation, https://reference.langchain.com/python/langchain/langchain/
@@ -12,7 +12,7 @@ Project-URL: Reddit, https://www.reddit.com/r/LangChain/
 License: MIT
 License-File: LICENSE
 Requires-Python: <4.0.0,>=3.10.0
-Requires-Dist: langchain-core<2.0.0,>=1.2.1
+Requires-Dist: langchain-core<2.0.0,>=1.2.7
 Requires-Dist: langgraph<1.1.0,>=1.0.2
 Requires-Dist: pydantic<3.0.0,>=2.7.4
 Provides-Extra: anthropic

{langchain-1.2.4 → langchain-1.2.5}/langchain/__init__.py

@@ -1,3 +1,3 @@
 """Main entrypoint into LangChain."""
 
-__version__ = "1.2.4"
+__version__ = "1.2.5"

{langchain-1.2.4 → langchain-1.2.5}/langchain/agents/middleware/summarization.py

@@ -19,6 +19,8 @@ from langchain_core.messages.utils import (
     get_buffer_string,
     trim_messages,
 )
+from langchain_core.runnables.config import RunnableConfig, merge_configs
+from langgraph.config import get_config
 from langgraph.graph.message import (
     REMOVE_ALL_MESSAGES,
 )
@@ -40,12 +42,27 @@ Your sole objective in this task is to extract the highest quality/most relevant
 
 <objective_information>
 You're nearing the total number of input tokens you can accept, so you must extract the highest quality/most relevant pieces of information from your conversation history.
-This context will then overwrite the conversation history presented below. Because of this, ensure the context you extract is only the most important information to your overall goal.
+This context will then overwrite the conversation history presented below. Because of this, ensure the context you extract is only the most important information to continue working toward your overall goal.
 </objective_information>
 
 <instructions>
-The conversation history below will be replaced with the context you extract in this step. Because of this, you must do your very best to extract and record all of the most important context from the conversation history.
+The conversation history below will be replaced with the context you extract in this step.
 You want to ensure that you don't repeat any actions you've already completed, so the context you extract from the conversation history should be focused on the most important information to your overall goal.
+
+You should structure your summary using the following sections. Each section acts as a checklist - you must populate it with relevant information or explicitly state "None" if there is nothing to report for that section:
+
+## SESSION INTENT
+What is the user's primary goal or request? What overall task are you trying to accomplish? This should be concise but complete enough to understand the purpose of the entire session.
+
+## SUMMARY
+Extract and record all of the most important context from the conversation history. Include important choices, conclusions, or strategies determined during this conversation. Include the reasoning behind key decisions. Document any rejected options and why they were not pursued.
+
+## ARTIFACTS
+What artifacts, files, or resources were created, modified, or accessed during this conversation? For file modifications, list specific file paths and briefly describe the changes made to each. This section prevents silent loss of artifact information.
+
+## NEXT STEPS
+What specific tasks remain to be completed to achieve the session intent? What should you do next?
+
 </instructions>
 
 The user will message you with the full message history you'll be extracting context from, to then replace. Carefully read over it all, and think deeply about what information is most important to your overall goal that should be saved:
@@ -269,7 +286,7 @@ class SummarizationMiddleware(AgentMiddleware):
             raise ValueError(msg)
 
     @override
-    def before_model(self, state: AgentState[Any], runtime: Runtime) -> dict[str, Any] | None:
+    def before_model(self, state: AgentState[Any], _runtime: Runtime) -> dict[str, Any] | None:
         """Process messages before model invocation, potentially triggering summarization.
 
         Args:
@@ -306,7 +323,7 @@ class SummarizationMiddleware(AgentMiddleware):
 
     @override
     async def abefore_model(
-        self, state: AgentState[Any], runtime: Runtime
+        self, state: AgentState[Any], _runtime: Runtime
     ) -> dict[str, Any] | None:
         """Process messages before model invocation, potentially triggering summarization.
 
@@ -563,7 +580,11 @@ class SummarizationMiddleware(AgentMiddleware):
         return idx
 
     def _create_summary(self, messages_to_summarize: list[AnyMessage]) -> str:
-        """Generate summary for the given messages."""
+        """Generate summary for the given messages.
+
+        Args:
+            messages_to_summarize: Messages to summarize.
+        """
         if not messages_to_summarize:
             return "No previous conversation history."
 
@@ -575,14 +596,33 @@ class SummarizationMiddleware(AgentMiddleware):
         # message objects
         formatted_messages = get_buffer_string(trimmed_messages)
 
+        # Merge parent config with summarization metadata.
+        # Use get_config() to get the current LangGraph config which contains
+        # langgraph_checkpoint_ns - required by StreamMessagesHandler to properly
+        # track the model call and propagate metadata (including lc_source) to
+        # stream chunks.
         try:
-            response = self.model.invoke(self.summary_prompt.format(messages=formatted_messages))
+            base_config: RunnableConfig = get_config()
+        except RuntimeError:
+            # Fallback if called outside a runnable context
+            base_config = {}
+        config = merge_configs(base_config, {"metadata": {"lc_source": "summarization"}})
+
+        try:
+            response = self.model.invoke(
+                self.summary_prompt.format(messages=formatted_messages),
+                config=config,
+            )
             return response.text.strip()
         except Exception as e:
             return f"Error generating summary: {e!s}"
 
     async def _acreate_summary(self, messages_to_summarize: list[AnyMessage]) -> str:
-        """Generate summary for the given messages."""
+        """Generate summary for the given messages.
+
+        Args:
+            messages_to_summarize: Messages to summarize.
+        """
         if not messages_to_summarize:
             return "No previous conversation history."
 
@@ -594,9 +634,22 @@ class SummarizationMiddleware(AgentMiddleware):
         # message objects
         formatted_messages = get_buffer_string(trimmed_messages)
 
+        # Merge parent config with summarization metadata.
+        # Use get_config() to get the current LangGraph config which contains
+        # langgraph_checkpoint_ns - required by StreamMessagesHandler to properly
+        # track the model call and propagate metadata (including lc_source) to
+        # stream chunks.
+        try:
+            base_config: RunnableConfig = get_config()
+        except RuntimeError:
+            # Fallback if called outside a runnable context
+            base_config = {}
+        config = merge_configs(base_config, {"metadata": {"lc_source": "summarization"}})
+
         try:
             response = await self.model.ainvoke(
-                self.summary_prompt.format(messages=formatted_messages)
+                self.summary_prompt.format(messages=formatted_messages),
+                config=config,
             )
             return response.text.strip()
         except Exception as e:

{langchain-1.2.4 → langchain-1.2.5}/pyproject.toml

@@ -9,10 +9,10 @@ license = { text = "MIT" }
 readme = "README.md"
 authors = []
 
-version = "1.2.4"
+version = "1.2.5"
 requires-python = ">=3.10.0,<4.0.0"
 dependencies = [
-    "langchain-core>=1.2.1,<2.0.0",
+    "langchain-core>=1.2.7,<2.0.0",
     "langgraph>=1.0.2,<1.1.0",
     "pydantic>=2.7.4,<3.0.0",
 ]

{langchain-1.2.4 → langchain-1.2.5}/tests/unit_tests/agents/middleware/implementations/test_summarization.py

@@ -1214,3 +1214,73 @@ def test_usage_metadata_trigger() -> None:
         ]
     )
     assert not middleware._should_summarize(messages, 0)
+
+
+class ConfigCapturingModel(BaseChatModel):
+    """Mock model that captures the config passed to invoke/ainvoke."""
+
+    captured_configs: list[RunnableConfig | None] = Field(default_factory=list, exclude=True)
+
+    @override
+    def invoke(
+        self,
+        input: LanguageModelInput,
+        config: RunnableConfig | None = None,
+        *,
+        stop: list[str] | None = None,
+        **kwargs: Any,
+    ) -> AIMessage:
+        self.captured_configs.append(config)
+        return AIMessage(content="Summary")
+
+    @override
+    async def ainvoke(
+        self,
+        input: LanguageModelInput,
+        config: RunnableConfig | None = None,
+        *,
+        stop: list[str] | None = None,
+        **kwargs: Any,
+    ) -> AIMessage:
+        self.captured_configs.append(config)
+        return AIMessage(content="Summary")
+
+    @override
+    def _generate(
+        self,
+        messages: list[BaseMessage],
+        stop: list[str] | None = None,
+        run_manager: CallbackManagerForLLMRun | None = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        return ChatResult(generations=[ChatGeneration(message=AIMessage(content="Summary"))])
+
+    @property
+    def _llm_type(self) -> str:
+        return "config-capturing"
+
+
+@pytest.mark.parametrize("use_async", [False, True], ids=["sync", "async"])
+async def test_create_summary_passes_lc_source_metadata(use_async: bool) -> None:  # noqa: FBT001
+    """Test that summary creation passes `lc_source` metadata to the model.
+
+    When called outside a LangGraph runnable context, `get_config()` raises
+    `RuntimeError`. The middleware catches this and still passes the `lc_source`
+    metadata to the model.
+    """
+    model = ConfigCapturingModel()
+    model.captured_configs = []  # Reset for this test
+    middleware = SummarizationMiddleware(model=model, trigger=("tokens", 1000))
+    messages: list[AnyMessage] = [HumanMessage(content="Hello"), AIMessage(content="Hi")]
+
+    if use_async:
+        summary = await middleware._acreate_summary(messages)
+    else:
+        summary = middleware._create_summary(messages)
+
+    assert summary == "Summary"
+    assert len(model.captured_configs) == 1
+    config = model.captured_configs[0]
+    assert config is not None
+    assert "metadata" in config
+    assert config["metadata"]["lc_source"] == "summarization"

langchain-1.2.5/tests/unit_tests/agents/test_agent_name.py

@@ -0,0 +1,219 @@
+"""Test agent name parameter in create_agent.
+
+This module tests that the name parameter correctly sets .name on AIMessage outputs.
+"""
+
+from __future__ import annotations
+
+from langchain_core.messages import (
+    AIMessage,
+    HumanMessage,
+    ToolCall,
+)
+from langchain_core.tools import tool
+
+from langchain.agents import create_agent
+from tests.unit_tests.agents.model import FakeToolCallingModel
+
+
+@tool
+def simple_tool(x: int) -> str:
+    """Simple tool for basic tests."""
+    return f"Result: {x}"
+
+
+def test_agent_name_set_on_ai_message() -> None:
+    """Test that agent name is set on AIMessage when name is provided."""
+    tool_calls: list[list[ToolCall]] = [[]]
+    agent = create_agent(
+        model=FakeToolCallingModel(tool_calls=tool_calls),
+        name="test_agent",
+    )
+
+    result = agent.invoke({"messages": [HumanMessage("Hello")]})
+
+    ai_messages = [m for m in result["messages"] if isinstance(m, AIMessage)]
+    assert len(ai_messages) == 1
+    assert ai_messages[0].name == "test_agent"
+
+
+def test_agent_name_not_set_when_none() -> None:
+    """Test that AIMessage.name is not set when name is not provided."""
+    tool_calls: list[list[ToolCall]] = [[]]
+    agent = create_agent(
+        model=FakeToolCallingModel(tool_calls=tool_calls),
+    )
+
+    result = agent.invoke({"messages": [HumanMessage("Hello")]})
+
+    ai_messages = [m for m in result["messages"] if isinstance(m, AIMessage)]
+    assert len(ai_messages) == 1
+    assert ai_messages[0].name is None
+
+
+def test_agent_name_on_multiple_iterations() -> None:
+    """Test that agent name is set on all AIMessages in multi-turn conversation."""
+    agent = create_agent(
+        model=FakeToolCallingModel(
+            tool_calls=[[{"args": {"x": 1}, "id": "call_1", "name": "simple_tool"}], []]
+        ),
+        tools=[simple_tool],
+        name="multi_turn_agent",
+    )
+
+    result = agent.invoke({"messages": [HumanMessage("Call a tool")]})
+
+    ai_messages = [m for m in result["messages"] if isinstance(m, AIMessage)]
+    assert len(ai_messages) == 2
+    for msg in ai_messages:
+        assert msg.name == "multi_turn_agent"
+
+
+async def test_agent_name_async() -> None:
+    """Test that agent name is set on AIMessage in async execution."""
+    tool_calls: list[list[ToolCall]] = [[]]
+    agent = create_agent(
+        model=FakeToolCallingModel(tool_calls=tool_calls),
+        name="async_agent",
+    )
+
+    result = await agent.ainvoke({"messages": [HumanMessage("Hello async")]})
+
+    ai_messages = [m for m in result["messages"] if isinstance(m, AIMessage)]
+    assert len(ai_messages) == 1
+    assert ai_messages[0].name == "async_agent"
+
+
+async def test_agent_name_async_multiple_iterations() -> None:
+    """Test that agent name is set on all AIMessages in async multi-turn."""
+    agent = create_agent(
+        model=FakeToolCallingModel(
+            tool_calls=[[{"args": {"x": 5}, "id": "call_1", "name": "simple_tool"}], []]
+        ),
+        tools=[simple_tool],
+        name="async_multi_agent",
+    )
+
+    result = await agent.ainvoke({"messages": [HumanMessage("Call tool async")]})
+
+    ai_messages = [m for m in result["messages"] if isinstance(m, AIMessage)]
+    assert len(ai_messages) == 2
+    for msg in ai_messages:
+        assert msg.name == "async_multi_agent"
+
+
+# Tests for lc_agent_name in streaming metadata
+
+
+def test_lc_agent_name_in_stream_metadata() -> None:
+    """Test that lc_agent_name is included in metadata when streaming with name."""
+    tool_calls: list[list[ToolCall]] = [[]]
+    agent = create_agent(
+        model=FakeToolCallingModel(tool_calls=tool_calls),
+        name="streaming_agent",
+    )
+
+    metadata_with_agent_name = []
+    for _chunk, metadata in agent.stream(
+        {"messages": [HumanMessage("Hello")]},
+        stream_mode="messages",
+    ):
+        if "lc_agent_name" in metadata:
+            metadata_with_agent_name.append(metadata["lc_agent_name"])
+
+    assert len(metadata_with_agent_name) > 0
+    assert all(name == "streaming_agent" for name in metadata_with_agent_name)
+
+
+def test_lc_agent_name_not_in_stream_metadata_when_name_not_provided() -> None:
+    """Test that lc_agent_name is not in metadata when name is not provided."""
+    tool_calls: list[list[ToolCall]] = [[]]
+    agent = create_agent(
+        model=FakeToolCallingModel(tool_calls=tool_calls),
+    )
+
+    for _chunk, metadata in agent.stream(
+        {"messages": [HumanMessage("Hello")]},
+        stream_mode="messages",
+    ):
+        assert "lc_agent_name" not in metadata
+
+
+def test_lc_agent_name_in_stream_metadata_multiple_iterations() -> None:
+    """Test that lc_agent_name is in metadata for all stream events in multi-turn."""
+    agent = create_agent(
+        model=FakeToolCallingModel(
+            tool_calls=[[{"args": {"x": 1}, "id": "call_1", "name": "simple_tool"}], []]
+        ),
+        tools=[simple_tool],
+        name="multi_turn_streaming_agent",
+    )
+
+    metadata_with_agent_name = []
+    for _chunk, metadata in agent.stream(
+        {"messages": [HumanMessage("Call a tool")]},
+        stream_mode="messages",
+    ):
+        if "lc_agent_name" in metadata:
+            metadata_with_agent_name.append(metadata["lc_agent_name"])
+
+    # Should have metadata entries for messages from both iterations
+    assert len(metadata_with_agent_name) > 0
+    assert all(name == "multi_turn_streaming_agent" for name in metadata_with_agent_name)
+
+
+async def test_lc_agent_name_in_astream_metadata() -> None:
+    """Test that lc_agent_name is included in metadata when async streaming with name."""
+    tool_calls: list[list[ToolCall]] = [[]]
+    agent = create_agent(
+        model=FakeToolCallingModel(tool_calls=tool_calls),
+        name="async_streaming_agent",
+    )
+
+    metadata_with_agent_name = []
+    async for _chunk, metadata in agent.astream(
+        {"messages": [HumanMessage("Hello async")]},
+        stream_mode="messages",
+    ):
+        if "lc_agent_name" in metadata:
+            metadata_with_agent_name.append(metadata["lc_agent_name"])
+
+    assert len(metadata_with_agent_name) > 0
+    assert all(name == "async_streaming_agent" for name in metadata_with_agent_name)
+
+
+async def test_lc_agent_name_not_in_astream_metadata_when_name_not_provided() -> None:
+    """Test that lc_agent_name is not in async stream metadata when name not provided."""
+    tool_calls: list[list[ToolCall]] = [[]]
+    agent = create_agent(
+        model=FakeToolCallingModel(tool_calls=tool_calls),
+    )
+
+    async for _chunk, metadata in agent.astream(
+        {"messages": [HumanMessage("Hello async")]},
+        stream_mode="messages",
+    ):
+        assert "lc_agent_name" not in metadata
+
+
+async def test_lc_agent_name_in_astream_metadata_multiple_iterations() -> None:
+    """Test that lc_agent_name is in metadata for all async stream events in multi-turn."""
+    agent = create_agent(
+        model=FakeToolCallingModel(
+            tool_calls=[[{"args": {"x": 5}, "id": "call_1", "name": "simple_tool"}], []]
+        ),
+        tools=[simple_tool],
+        name="async_multi_turn_streaming_agent",
+    )
+
+    metadata_with_agent_name = []
+    async for _chunk, metadata in agent.astream(
+        {"messages": [HumanMessage("Call tool async")]},
+        stream_mode="messages",
+    ):
+        if "lc_agent_name" in metadata:
+            metadata_with_agent_name.append(metadata["lc_agent_name"])
+
+    # Should have metadata entries for messages from both iterations
+    assert len(metadata_with_agent_name) > 0
+    assert all(name == "async_multi_turn_streaming_agent" for name in metadata_with_agent_name)

{langchain-1.2.4 → langchain-1.2.5}/uv.lock

@@ -1,5 +1,5 @@
 version = 1
-revision = 3
+revision = 2
 requires-python = ">=3.10.0, <4.0.0"
 resolution-markers = [
     "python_full_version >= '3.14' and platform_python_implementation == 'PyPy'",
@@ -1863,7 +1863,7 @@ wheels = [
 
 [[package]]
 name = "langchain"
-version = "1.2.4"
+version = "1.2.5"
 source = { editable = "." }
 dependencies = [
     { name = "langchain-core" },

langchain-1.2.4/tests/unit_tests/agents/test_agent_name.py

@@ -1,105 +0,0 @@
-"""Test agent name parameter in create_agent.
-
-This module tests that the name parameter correctly sets .name on AIMessage outputs.
-"""
-
-from __future__ import annotations
-
-import pytest
-from langchain_core.messages import (
-    AIMessage,
-    HumanMessage,
-    ToolCall,
-)
-from langchain_core.tools import tool
-
-from langchain.agents import create_agent
-from tests.unit_tests.agents.model import FakeToolCallingModel
-
-
-@tool
-def simple_tool(x: int) -> str:
-    """Simple tool for basic tests."""
-    return f"Result: {x}"
-
-
-def test_agent_name_set_on_ai_message() -> None:
-    """Test that agent name is set on AIMessage when name is provided."""
-    tool_calls: list[list[ToolCall]] = [[]]
-    agent = create_agent(
-        model=FakeToolCallingModel(tool_calls=tool_calls),
-        name="test_agent",
-    )
-
-    result = agent.invoke({"messages": [HumanMessage("Hello")]})
-
-    ai_messages = [m for m in result["messages"] if isinstance(m, AIMessage)]
-    assert len(ai_messages) == 1
-    assert ai_messages[0].name == "test_agent"
-
-
-def test_agent_name_not_set_when_none() -> None:
-    """Test that AIMessage.name is not set when name is not provided."""
-    tool_calls: list[list[ToolCall]] = [[]]
-    agent = create_agent(
-        model=FakeToolCallingModel(tool_calls=tool_calls),
-    )
-
-    result = agent.invoke({"messages": [HumanMessage("Hello")]})
-
-    ai_messages = [m for m in result["messages"] if isinstance(m, AIMessage)]
-    assert len(ai_messages) == 1
-    assert ai_messages[0].name is None
-
-
-def test_agent_name_on_multiple_iterations() -> None:
-    """Test that agent name is set on all AIMessages in multi-turn conversation."""
-    agent = create_agent(
-        model=FakeToolCallingModel(
-            tool_calls=[[{"args": {"x": 1}, "id": "call_1", "name": "simple_tool"}], []]
-        ),
-        tools=[simple_tool],
-        name="multi_turn_agent",
-    )
-
-    result = agent.invoke({"messages": [HumanMessage("Call a tool")]})
-
-    ai_messages = [m for m in result["messages"] if isinstance(m, AIMessage)]
-    assert len(ai_messages) == 2
-    for msg in ai_messages:
-        assert msg.name == "multi_turn_agent"
-
-
-@pytest.mark.asyncio
-async def test_agent_name_async() -> None:
-    """Test that agent name is set on AIMessage in async execution."""
-    tool_calls: list[list[ToolCall]] = [[]]
-    agent = create_agent(
-        model=FakeToolCallingModel(tool_calls=tool_calls),
-        name="async_agent",
-    )
-
-    result = await agent.ainvoke({"messages": [HumanMessage("Hello async")]})
-
-    ai_messages = [m for m in result["messages"] if isinstance(m, AIMessage)]
-    assert len(ai_messages) == 1
-    assert ai_messages[0].name == "async_agent"
-
-
-@pytest.mark.asyncio
-async def test_agent_name_async_multiple_iterations() -> None:
-    """Test that agent name is set on all AIMessages in async multi-turn."""
-    agent = create_agent(
-        model=FakeToolCallingModel(
-            tool_calls=[[{"args": {"x": 5}, "id": "call_1", "name": "simple_tool"}], []]
-        ),
-        tools=[simple_tool],
-        name="async_multi_agent",
-    )
-
-    result = await agent.ainvoke({"messages": [HumanMessage("Call tool async")]})
-
-    ai_messages = [m for m in result["messages"] if isinstance(m, AIMessage)]
-    assert len(ai_messages) == 2
-    for msg in ai_messages:
-        assert msg.name == "async_multi_agent"