langchain-core 1.1.0__tar.gz → 1.2.0__tar.gz

{langchain_core-1.1.0 → langchain_core-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langchain-core
-Version: 1.1.0
+Version: 1.2.0
 Summary: Building applications with LLMs through composability
 Project-URL: Homepage, https://docs.langchain.com/
 Project-URL: Documentation, https://reference.langchain.com/python/langchain_core/
@@ -18,6 +18,7 @@ Requires-Dist: pydantic<3.0.0,>=2.7.4
 Requires-Dist: pyyaml<7.0.0,>=5.3.0
 Requires-Dist: tenacity!=8.4.0,<10.0.0,>=8.1.0
 Requires-Dist: typing-extensions<5.0.0,>=4.7.0
+Requires-Dist: uuid-utils<1.0,>=0.12.0
 Description-Content-Type: text/markdown
 
 # 🦜🍎️ LangChain Core

{langchain_core-1.1.0 → langchain_core-1.2.0}/langchain_core/callbacks/manager.py

@@ -6,7 +6,6 @@ import asyncio
 import atexit
 import functools
 import logging
-import uuid
 from abc import ABC, abstractmethod
 from collections.abc import Callable
 from concurrent.futures import ThreadPoolExecutor
@@ -41,6 +40,7 @@ from langchain_core.tracers.context import (
 from langchain_core.tracers.langchain import LangChainTracer
 from langchain_core.tracers.stdout import ConsoleCallbackHandler
 from langchain_core.utils.env import env_var_is_set
+from langchain_core.utils.uuid import uuid7
 
 if TYPE_CHECKING:
     from collections.abc import AsyncGenerator, Coroutine, Generator, Sequence
@@ -504,7 +504,7 @@ class BaseRunManager(RunManagerMixin):
 
         """
         return cls(
-            run_id=uuid.uuid4(),
+            run_id=uuid7(),
             handlers=[],
             inheritable_handlers=[],
             tags=[],
@@ -1330,7 +1330,7 @@ class CallbackManager(BaseCallbackManager):
         managers = []
         for i, prompt in enumerate(prompts):
             # Can't have duplicate runs with the same run ID (if provided)
-            run_id_ = run_id if i == 0 and run_id is not None else uuid.uuid4()
+            run_id_ = run_id if i == 0 and run_id is not None else uuid7()
             handle_event(
                 self.handlers,
                 "on_llm_start",
@@ -1384,7 +1384,7 @@ class CallbackManager(BaseCallbackManager):
                 run_id_ = run_id
                 run_id = None
             else:
-                run_id_ = uuid.uuid4()
+                run_id_ = uuid7()
             handle_event(
                 self.handlers,
                 "on_chat_model_start",
@@ -1433,7 +1433,7 @@ class CallbackManager(BaseCallbackManager):
 
         """
         if run_id is None:
-            run_id = uuid.uuid4()
+            run_id = uuid7()
         handle_event(
             self.handlers,
             "on_chain_start",
@@ -1488,7 +1488,7 @@ class CallbackManager(BaseCallbackManager):
 
         """
         if run_id is None:
-            run_id = uuid.uuid4()
+            run_id = uuid7()
 
         handle_event(
             self.handlers,
@@ -1537,7 +1537,7 @@ class CallbackManager(BaseCallbackManager):
             The callback manager for the retriever run.
         """
         if run_id is None:
-            run_id = uuid.uuid4()
+            run_id = uuid7()
 
         handle_event(
             self.handlers,
@@ -1594,7 +1594,7 @@ class CallbackManager(BaseCallbackManager):
             )
             raise ValueError(msg)
         if run_id is None:
-            run_id = uuid.uuid4()
+            run_id = uuid7()
 
         handle_event(
             self.handlers,
@@ -1816,7 +1816,7 @@ class AsyncCallbackManager(BaseCallbackManager):
                 run_id_ = run_id
                 run_id = None
             else:
-                run_id_ = uuid.uuid4()
+                run_id_ = uuid7()
 
             if inline_handlers:
                 inline_tasks.append(
@@ -1900,7 +1900,7 @@ class AsyncCallbackManager(BaseCallbackManager):
                 run_id_ = run_id
                 run_id = None
             else:
-                run_id_ = uuid.uuid4()
+                run_id_ = uuid7()
 
             for handler in self.handlers:
                 task = ahandle_event(
@@ -1962,7 +1962,7 @@ class AsyncCallbackManager(BaseCallbackManager):
             The async callback manager for the chain run.
         """
         if run_id is None:
-            run_id = uuid.uuid4()
+            run_id = uuid7()
 
         await ahandle_event(
             self.handlers,
@@ -2010,7 +2010,7 @@ class AsyncCallbackManager(BaseCallbackManager):
             The async callback manager for the tool run.
         """
         if run_id is None:
-            run_id = uuid.uuid4()
+            run_id = uuid7()
 
         await ahandle_event(
             self.handlers,
@@ -2060,7 +2060,7 @@ class AsyncCallbackManager(BaseCallbackManager):
         if not self.handlers:
             return
         if run_id is None:
-            run_id = uuid.uuid4()
+            run_id = uuid7()
 
         if kwargs:
             msg = (
@@ -2102,7 +2102,7 @@ class AsyncCallbackManager(BaseCallbackManager):
             The async callback manager for the retriever run.
         """
         if run_id is None:
-            run_id = uuid.uuid4()
+            run_id = uuid7()
 
         await ahandle_event(
             self.handlers,

{langchain_core-1.1.0 → langchain_core-1.2.0}/langchain_core/callbacks/usage.py

@@ -95,7 +95,7 @@ def get_usage_metadata_callback(
     """Get usage metadata callback.
 
     Get context manager for tracking usage metadata across chat model calls using
-    `AIMessage.usage_metadata`.
+    [`AIMessage.usage_metadata`][langchain.messages.AIMessage.usage_metadata].
 
     Args:
         name: The name of the context variable.

{langchain_core-1.1.0 → langchain_core-1.2.0}/langchain_core/indexing/api.py

@@ -302,6 +302,7 @@ def index(
     are not able to specify the uid of the document.
 
     !!! warning "Behavior changed in `langchain-core` 0.3.25"
+
         Added `scoped_full` cleanup mode.
 
     !!! warning
@@ -640,6 +641,7 @@ async def aindex(
     are not able to specify the uid of the document.
 
     !!! warning "Behavior changed in `langchain-core` 0.3.25"
+
         Added `scoped_full` cleanup mode.
 
     !!! warning

{langchain_core-1.1.0 → langchain_core-1.2.0}/langchain_core/language_models/__init__.py

@@ -1,7 +1,7 @@
-"""Language models.
+"""Core language model abstractions.
 
 LangChain has two main classes to work with language models: chat models and
-"old-fashioned" LLMs.
+"old-fashioned" LLMs (string-in, string-out).
 
 **Chat models**
 
@@ -11,14 +11,16 @@ as outputs (as opposed to using plain text).
 Chat models support the assignment of distinct roles to conversation messages, helping
 to distinguish messages from the AI, users, and instructions such as system messages.
 
-The key abstraction for chat models is `BaseChatModel`. Implementations should inherit
-from this class.
+The key abstraction for chat models is
+[`BaseChatModel`][langchain_core.language_models.BaseChatModel]. Implementations should
+inherit from this class.
 
 See existing [chat model integrations](https://docs.langchain.com/oss/python/integrations/chat).
 
-**LLMs**
+**LLMs (legacy)**
 
 Language models that takes a string as input and returns a string.
+
 These are traditionally older models (newer models generally are chat models).
 
 Although the underlying models are string in, string out, the LangChain wrappers also

{langchain_core-1.1.0 → langchain_core-1.2.0}/langchain_core/language_models/_utils.py

@@ -140,6 +140,7 @@ def _normalize_messages(
     - LangChain v0 standard content blocks for backward compatibility
 
     !!! warning "Behavior changed in `langchain-core` 1.0.0"
+
         In previous versions, this function returned messages in LangChain v0 format.
         Now, it returns messages in LangChain v1 format, which upgraded chat models now
         expect to receive when passing back in message history. For backward

{langchain_core-1.1.0 → langchain_core-1.2.0}/langchain_core/language_models/chat_models.py

@@ -333,7 +333,7 @@ class BaseChatModel(BaseLanguageModel[AIMessage], ABC):
     [`langchain-openai`](https://pypi.org/project/langchain-openai)) can also use this
     field to roll out new content formats in a backward-compatible way.
 
-    !!! version-added "Added in `langchain-core` 1.0"
+    !!! version-added "Added in `langchain-core` 1.0.0"
 
     """
 
@@ -349,7 +349,7 @@ class BaseChatModel(BaseLanguageModel[AIMessage], ABC):
     Example profile data includes context window sizes, supported modalities, or support
     for tool calling, structured output, and other features.
 
-    !!! version-added "Added in `langchain-core` 1.1"
+    !!! version-added "Added in `langchain-core` 1.1.0"
     """
 
     model_config = ConfigDict(
@@ -1578,88 +1578,89 @@ class BaseChatModel(BaseLanguageModel[AIMessage], ABC):
                     depends on the `schema` as described above.
                 - `'parsing_error'`: `BaseException | None`
 
-        Example: Pydantic schema (`include_raw=False`):
+        ???+ example "Pydantic schema (`include_raw=False`)"
 
-        ```python
-        from pydantic import BaseModel
+            ```python
+            from pydantic import BaseModel
 
 
-        class AnswerWithJustification(BaseModel):
-            '''An answer to the user question along with justification for the answer.'''
+            class AnswerWithJustification(BaseModel):
+                '''An answer to the user question along with justification for the answer.'''
 
-            answer: str
-            justification: str
+                answer: str
+                justification: str
 
 
-        model = ChatModel(model="model-name", temperature=0)
-        structured_model = model.with_structured_output(AnswerWithJustification)
+            model = ChatModel(model="model-name", temperature=0)
+            structured_model = model.with_structured_output(AnswerWithJustification)
 
-        structured_model.invoke(
-            "What weighs more a pound of bricks or a pound of feathers"
-        )
+            structured_model.invoke(
+                "What weighs more a pound of bricks or a pound of feathers"
+            )
 
-        # -> AnswerWithJustification(
-        #     answer='They weigh the same',
-        #     justification='Both a pound of bricks and a pound of feathers weigh one pound. The weight is the same, but the volume or density of the objects may differ.'
-        # )
-        ```
+            # -> AnswerWithJustification(
+            #     answer='They weigh the same',
+            #     justification='Both a pound of bricks and a pound of feathers weigh one pound. The weight is the same, but the volume or density of the objects may differ.'
+            # )
+            ```
 
-        Example: Pydantic schema (`include_raw=True`):
+        ??? example "Pydantic schema (`include_raw=True`)"
 
-        ```python
-        from pydantic import BaseModel
+            ```python
+            from pydantic import BaseModel
 
 
-        class AnswerWithJustification(BaseModel):
-            '''An answer to the user question along with justification for the answer.'''
+            class AnswerWithJustification(BaseModel):
+                '''An answer to the user question along with justification for the answer.'''
 
-            answer: str
-            justification: str
+                answer: str
+                justification: str
 
 
-        model = ChatModel(model="model-name", temperature=0)
-        structured_model = model.with_structured_output(
-            AnswerWithJustification, include_raw=True
-        )
+            model = ChatModel(model="model-name", temperature=0)
+            structured_model = model.with_structured_output(
+                AnswerWithJustification, include_raw=True
+            )
 
-        structured_model.invoke(
-            "What weighs more a pound of bricks or a pound of feathers"
-        )
-        # -> {
-        #     'raw': AIMessage(content='', additional_kwargs={'tool_calls': [{'id': 'call_Ao02pnFYXD6GN1yzc0uXPsvF', 'function': {'arguments': '{"answer":"They weigh the same.","justification":"Both a pound of bricks and a pound of feathers weigh one pound. The weight is the same, but the volume or density of the objects may differ."}', 'name': 'AnswerWithJustification'}, 'type': 'function'}]}),
-        #     'parsed': AnswerWithJustification(answer='They weigh the same.', justification='Both a pound of bricks and a pound of feathers weigh one pound. The weight is the same, but the volume or density of the objects may differ.'),
-        #     'parsing_error': None
-        # }
-        ```
+            structured_model.invoke(
+                "What weighs more a pound of bricks or a pound of feathers"
+            )
+            # -> {
+            #     'raw': AIMessage(content='', additional_kwargs={'tool_calls': [{'id': 'call_Ao02pnFYXD6GN1yzc0uXPsvF', 'function': {'arguments': '{"answer":"They weigh the same.","justification":"Both a pound of bricks and a pound of feathers weigh one pound. The weight is the same, but the volume or density of the objects may differ."}', 'name': 'AnswerWithJustification'}, 'type': 'function'}]}),
+            #     'parsed': AnswerWithJustification(answer='They weigh the same.', justification='Both a pound of bricks and a pound of feathers weigh one pound. The weight is the same, but the volume or density of the objects may differ.'),
+            #     'parsing_error': None
+            # }
+            ```
 
-        Example: `dict` schema (`include_raw=False`):
+        ??? example "Dictionary schema (`include_raw=False`)"
 
-        ```python
-        from pydantic import BaseModel
-        from langchain_core.utils.function_calling import convert_to_openai_tool
+            ```python
+            from pydantic import BaseModel
+            from langchain_core.utils.function_calling import convert_to_openai_tool
 
 
-        class AnswerWithJustification(BaseModel):
-            '''An answer to the user question along with justification for the answer.'''
+            class AnswerWithJustification(BaseModel):
+                '''An answer to the user question along with justification for the answer.'''
 
-            answer: str
-            justification: str
+                answer: str
+                justification: str
 
 
-        dict_schema = convert_to_openai_tool(AnswerWithJustification)
-        model = ChatModel(model="model-name", temperature=0)
-        structured_model = model.with_structured_output(dict_schema)
+            dict_schema = convert_to_openai_tool(AnswerWithJustification)
+            model = ChatModel(model="model-name", temperature=0)
+            structured_model = model.with_structured_output(dict_schema)
 
-        structured_model.invoke(
-            "What weighs more a pound of bricks or a pound of feathers"
-        )
-        # -> {
-        #     'answer': 'They weigh the same',
-        #     'justification': 'Both a pound of bricks and a pound of feathers weigh one pound. The weight is the same, but the volume and density of the two substances differ.'
-        # }
-        ```
+            structured_model.invoke(
+                "What weighs more a pound of bricks or a pound of feathers"
+            )
+            # -> {
+            #     'answer': 'They weigh the same',
+            #     'justification': 'Both a pound of bricks and a pound of feathers weigh one pound. The weight is the same, but the volume and density of the two substances differ.'
+            # }
+            ```
 
         !!! warning "Behavior changed in `langchain-core` 0.2.26"
+
             Added support for `TypedDict` class.
 
         """  # noqa: E501

{langchain_core-1.1.0 → langchain_core-1.2.0}/langchain_core/language_models/llms.py

@@ -61,6 +61,8 @@ if TYPE_CHECKING:
 
 logger = logging.getLogger(__name__)
 
+_background_tasks: set[asyncio.Task] = set()
+
 
 @functools.lru_cache
 def _log_error_once(msg: str) -> None:
@@ -100,9 +102,9 @@ def create_base_retry_decorator(
                         asyncio.run(coro)
                     else:
                         if loop.is_running():
-                            # TODO: Fix RUF006 - this task should have a reference
-                            #  and be awaited somewhere
-                            loop.create_task(coro)  # noqa: RUF006
+                            task = loop.create_task(coro)
+                            _background_tasks.add(task)
+                            task.add_done_callback(_background_tasks.discard)
                         else:
                             asyncio.run(coro)
                 except Exception as e:

{langchain_core-1.1.0 → langchain_core-1.2.0}/langchain_core/load/load.py

@@ -1,4 +1,9 @@
-"""Load LangChain objects from JSON strings or objects."""
+"""Load LangChain objects from JSON strings or objects.
+
+!!! warning
+    `load` and `loads` are vulnerable to remote code execution. Never use with untrusted
+    input.
+"""
 
 import importlib
 import json
@@ -193,6 +198,10 @@ def loads(
 ) -> Any:
     """Revive a LangChain class from a JSON string.
 
+    !!! warning
+        This function is vulnerable to remote code execution. Never use with untrusted
+        input.
+
     Equivalent to `load(json.loads(text))`.
 
     Args:
@@ -236,6 +245,10 @@ def load(
 ) -> Any:
     """Revive a LangChain class from a JSON object.
 
+    !!! warning
+        This function is vulnerable to remote code execution. Never use with untrusted
+        input.
+
     Use this if you already have a parsed JSON object,
     eg. from `json.load` or `orjson.loads`.
 

{langchain_core-1.1.0 → langchain_core-1.2.0}/langchain_core/messages/ai.py

@@ -51,22 +51,22 @@ class InputTokenDetails(TypedDict, total=False):
     May also hold extra provider-specific keys.
 
     !!! version-added "Added in `langchain-core` 0.3.9"
-
     """
 
     audio: int
     """Audio input tokens."""
+
     cache_creation: int
     """Input tokens that were cached and there was a cache miss.
 
     Since there was a cache miss, the cache was created from these tokens.
     """
+
     cache_read: int
     """Input tokens that were cached and there was a cache hit.
 
     Since there was a cache hit, the tokens were read from the cache. More precisely,
     the model state given these tokens was read from the cache.
-
     """
 
 
@@ -91,12 +91,12 @@ class OutputTokenDetails(TypedDict, total=False):
 
     audio: int
     """Audio output tokens."""
+
     reasoning: int
     """Reasoning output tokens.
 
     Tokens generated by the model in a chain of thought process (i.e. by OpenAI's o1
     models) that are not returned as part of model output.
-
     """
 
 
@@ -124,9 +124,11 @@ class UsageMetadata(TypedDict):
         ```
 
     !!! warning "Behavior changed in `langchain-core` 0.3.9"
+
         Added `input_token_details` and `output_token_details`.
 
     !!! note "LangSmith SDK"
+
         The LangSmith SDK also has a `UsageMetadata` class. While the two share fields,
         LangSmith's `UsageMetadata` has additional fields to capture cost information
         used by the LangSmith platform.
@@ -134,15 +136,19 @@ class UsageMetadata(TypedDict):
 
     input_tokens: int
     """Count of input (or prompt) tokens. Sum of all input token types."""
+
     output_tokens: int
     """Count of output (or completion) tokens. Sum of all output token types."""
+
     total_tokens: int
     """Total token count. Sum of `input_tokens` + `output_tokens`."""
+
     input_token_details: NotRequired[InputTokenDetails]
     """Breakdown of input token counts.
 
     Does *not* need to sum to full input token count. Does *not* need to have all keys.
     """
+
     output_token_details: NotRequired[OutputTokenDetails]
     """Breakdown of output token counts.
 
@@ -162,8 +168,10 @@ class AIMessage(BaseMessage):
 
     tool_calls: list[ToolCall] = []
     """If present, tool calls associated with the message."""
+
     invalid_tool_calls: list[InvalidToolCall] = []
     """If present, tool calls with parsing errors associated with the message."""
+
     usage_metadata: UsageMetadata | None = None
     """If present, usage metadata for a message, such as token counts.
 
@@ -555,7 +563,7 @@ class AIMessageChunk(AIMessage, BaseMessageChunk):
 
     @model_validator(mode="after")
     def init_server_tool_calls(self) -> Self:
-        """Parse `server_tool_call_chunks`."""
+        """Parse `server_tool_call_chunks` from [`ServerToolCallChunk`][langchain.messages.ServerToolCallChunk] objects."""  # noqa: E501
         if (
             self.chunk_position == "last"
             and self.response_metadata.get("output_version") == "v1"

{langchain_core-1.1.0 → langchain_core-1.2.0}/langchain_core/messages/base.py

@@ -391,12 +391,12 @@ class BaseMessageChunk(BaseMessage):
         Raises:
             TypeError: If the other object is not a message chunk.
 
-        For example,
-
-        `AIMessageChunk(content="Hello") + AIMessageChunk(content=" World")`
-
-        will give `AIMessageChunk(content="Hello World")`
-
+        Example:
+            ```txt
+              AIMessageChunk(content="Hello", ...)
+            + AIMessageChunk(content=" World", ...)
+            = AIMessageChunk(content="Hello World", ...)
+            ```
         """
         if isinstance(other, BaseMessageChunk):
             # If both are (subclasses of) BaseMessageChunk,

{langchain_core-1.1.0 → langchain_core-1.2.0}/langchain_core/messages/block_translators/anthropic.py

@@ -248,8 +248,14 @@ def _convert_to_v1_from_anthropic(message: AIMessage) -> list[types.ContentBlock
                     tool_call_chunk: types.ToolCallChunk = (
                         message.tool_call_chunks[0].copy()  # type: ignore[assignment]
                     )
+                    if "caller" in block:
+                        if "extras" not in tool_call_chunk:
+                            tool_call_chunk["extras"] = {}
+                        tool_call_chunk["extras"]["caller"] = block["caller"]
+
                     if "type" not in tool_call_chunk:
                         tool_call_chunk["type"] = "tool_call_chunk"
+
                     yield tool_call_chunk
                 else:
                     tool_call_block: types.ToolCall | None = None
@@ -282,6 +288,11 @@ def _convert_to_v1_from_anthropic(message: AIMessage) -> list[types.ContentBlock
                         }
                     if "index" in block:
                         tool_call_block["index"] = block["index"]
+                    if "caller" in block:
+                        if "extras" not in tool_call_block:
+                            tool_call_block["extras"] = {}
+                        tool_call_block["extras"]["caller"] = block["caller"]
+
                     yield tool_call_block
 
             elif block_type == "input_json_delta" and isinstance(

{langchain_core-1.1.0 → langchain_core-1.2.0}/langchain_core/messages/block_translators/google_genai.py

@@ -76,21 +76,36 @@ def translate_grounding_metadata_to_citations(
         for chunk_index in chunk_indices:
             if chunk_index < len(grounding_chunks):
                 chunk = grounding_chunks[chunk_index]
-                web_info = chunk.get("web", {})
+
+                # Handle web and maps grounding
+                web_info = chunk.get("web") or {}
+                maps_info = chunk.get("maps") or {}
+
+                # Extract citation info depending on source
+                url = maps_info.get("uri") or web_info.get("uri")
+                title = maps_info.get("title") or web_info.get("title")
+
+                # Note: confidence_scores is a legacy field from Gemini 2.0 and earlier
+                # that indicated confidence (0.0-1.0) for each grounding chunk.
+                #
+                # In Gemini 2.5+, this field is always None/empty and should be ignored.
+                extras_metadata = {
+                    "web_search_queries": web_search_queries,
+                    "grounding_chunk_index": chunk_index,
+                    "confidence_scores": support.get("confidence_scores") or [],
+                }
+
+                # Add maps-specific metadata if present
+                if maps_info.get("placeId"):
+                    extras_metadata["place_id"] = maps_info["placeId"]
 
                 citation = create_citation(
-                    url=web_info.get("uri"),
-                    title=web_info.get("title"),
+                    url=url,
+                    title=title,
                     start_index=start_index,
                     end_index=end_index,
                     cited_text=cited_text,
-                    extras={
-                        "google_ai_metadata": {
-                            "web_search_queries": web_search_queries,
-                            "grounding_chunk_index": chunk_index,
-                            "confidence_scores": support.get("confidence_scores", []),
-                        }
-                    },
+                    google_ai_metadata=extras_metadata,
                 )
                 citations.append(citation)
 

{langchain_core-1.1.0 → langchain_core-1.2.0}/langchain_core/messages/content.py

@@ -654,7 +654,7 @@ class PlainTextContentBlock(TypedDict):
 
     !!! note
         Title and context are optional fields that may be passed to the model. See
-        Anthropic [example](https://docs.claude.com/en/docs/build-with-claude/citations#citable-vs-non-citable-content).
+        Anthropic [example](https://platform.claude.com/docs/en/build-with-claude/citations#citable-vs-non-citable-content).
 
     !!! note "Factory function"
         `create_plaintext_block` may also be used as a factory to create a