langchain-core 1.0.0rc1__py3-none-any.whl → 1.0.0rc2__py3-none-any.whl

langchain_core/messages/block_translators/google_genai.py

@@ -105,7 +105,7 @@ def _convert_to_v1_from_genai_input(
     Called when message isn't an `AIMessage` or `model_provider` isn't set on
     `response_metadata`.
 
-    During the `.content_blocks` parsing process, we wrap blocks not recognized as a v1
+    During the `content_blocks` parsing process, we wrap blocks not recognized as a v1
     block as a `'non_standard'` block with the original block stored in the `value`
     field. This function attempts to unpack those blocks and convert any blocks that
     might be GenAI format to v1 ContentBlocks.
@@ -453,9 +453,10 @@ def _convert_to_v1_from_genai(message: AIMessage) -> list[types.ContentBlock]:
                     "status": status,  # type: ignore[typeddict-item]
                     "output": item.get("code_execution_result", ""),
                 }
+                server_tool_result_block["extras"] = {"block_type": item_type}
                 # Preserve original outcome in extras
                 if outcome is not None:
-                    server_tool_result_block["extras"] = {"outcome": outcome}
+                    server_tool_result_block["extras"]["outcome"] = outcome
                 converted_blocks.append(server_tool_result_block)
             else:
                 # Unknown type, preserve as non-standard

langchain_core/messages/block_translators/google_vertexai.py

@@ -1,37 +1,9 @@
 """Derivations of standard content blocks from Google (VertexAI) content."""
 
-import warnings
-
-from langchain_core.messages import AIMessage, AIMessageChunk
-from langchain_core.messages import content as types
-
-WARNED = False
-
-
-def translate_content(message: AIMessage) -> list[types.ContentBlock]:  # noqa: ARG001
-    """Derive standard content blocks from a message with Google (VertexAI) content."""
-    global WARNED  # noqa: PLW0603
-    if not WARNED:
-        warning_message = (
-            "Content block standardization is not yet fully supported for Google "
-            "VertexAI."
-        )
-        warnings.warn(warning_message, stacklevel=2)
-        WARNED = True
-    raise NotImplementedError
-
-
-def translate_content_chunk(message: AIMessageChunk) -> list[types.ContentBlock]:  # noqa: ARG001
-    """Derive standard content blocks from a chunk with Google (VertexAI) content."""
-    global WARNED  # noqa: PLW0603
-    if not WARNED:
-        warning_message = (
-            "Content block standardization is not yet fully supported for Google "
-            "VertexAI."
-        )
-        warnings.warn(warning_message, stacklevel=2)
-        WARNED = True
-    raise NotImplementedError
+from langchain_core.messages.block_translators.google_genai import (
+    translate_content,
+    translate_content_chunk,
+)
 
 
 def _register_google_vertexai_translator() -> None:

langchain_core/messages/block_translators/langchain_v0.py

@@ -10,7 +10,7 @@ def _convert_v0_multimodal_input_to_v1(
 ) -> list[types.ContentBlock]:
     """Convert v0 multimodal blocks to v1 format.
 
-    During the `.content_blocks` parsing process, we wrap blocks not recognized as a v1
+    During the `content_blocks` parsing process, we wrap blocks not recognized as a v1
     block as a `'non_standard'` block with the original block stored in the `value`
     field. This function attempts to unpack those blocks and convert any v0 format
     blocks to v1 format.

langchain_core/messages/block_translators/openai.py

@@ -155,7 +155,7 @@ def _convert_to_v1_from_chat_completions_input(
 ) -> list[types.ContentBlock]:
     """Convert OpenAI Chat Completions format blocks to v1 format.
 
-    During the `.content_blocks` parsing process, we wrap blocks not recognized as a v1
+    During the `content_blocks` parsing process, we wrap blocks not recognized as a v1
     block as a `'non_standard'` block with the original block stored in the `value`
     field. This function attempts to unpack those blocks and convert any blocks that
     might be OpenAI format to v1 ContentBlocks.

langchain_core/messages/chat.py

@@ -19,7 +19,7 @@ class ChatMessage(BaseMessage):
     """The speaker / role of the Message."""
 
     type: Literal["chat"] = "chat"
-    """The type of the message (used during serialization). Defaults to "chat"."""
+    """The type of the message (used during serialization)."""
 
 
 class ChatMessageChunk(ChatMessage, BaseMessageChunk):
@@ -29,11 +29,7 @@ class ChatMessageChunk(ChatMessage, BaseMessageChunk):
     # to make sure that the chunk variant can be discriminated from the
     # non-chunk variant.
     type: Literal["ChatMessageChunk"] = "ChatMessageChunk"  # type: ignore[assignment]
-    """The type of the message (used during serialization).
-
-    Defaults to `'ChatMessageChunk'`.
-
-    """
+    """The type of the message (used during serialization)."""
 
     @override
     def __add__(self, other: Any) -> BaseMessageChunk:  # type: ignore[override]

langchain_core/messages/content.py

@@ -143,7 +143,7 @@ class Citation(TypedDict):
         not the source text. This means that the indices are relative to the model's
         response, not the original document (as specified in the `url`).
 
-    !!! note
+    !!! note "Factory function"
         `create_citation` may also be used as a factory to create a `Citation`.
         Benefits include:
 
@@ -156,7 +156,9 @@ class Citation(TypedDict):
     """Type of the content block. Used for discrimination."""
 
     id: NotRequired[str]
-    """Content block identifier. Either:
+    """Content block identifier.
+
+    Either:
 
     - Generated by the provider (e.g., OpenAI's file ID)
     - Generated by LangChain upon creation (`UUID4` prefixed with `'lc_'`))
@@ -201,6 +203,7 @@ class NonStandardAnnotation(TypedDict):
     """Content block identifier.
 
     Either:
+
     - Generated by the provider (e.g., OpenAI's file ID)
     - Generated by LangChain upon creation (`UUID4` prefixed with `'lc_'`))
 
@@ -211,6 +214,7 @@ class NonStandardAnnotation(TypedDict):
 
 
 Annotation = Citation | NonStandardAnnotation
+"""A union of all defined `Annotation` types."""
 
 
 class TextContentBlock(TypedDict):
@@ -219,7 +223,7 @@ class TextContentBlock(TypedDict):
     This typically represents the main text content of a message, such as the response
     from a language model or the text of a user message.
 
-    !!! note
+    !!! note "Factory function"
         `create_text_block` may also be used as a factory to create a
         `TextContentBlock`. Benefits include:
 
@@ -235,6 +239,7 @@ class TextContentBlock(TypedDict):
     """Content block identifier.
 
     Either:
+
     - Generated by the provider (e.g., OpenAI's file ID)
     - Generated by LangChain upon creation (`UUID4` prefixed with `'lc_'`))
 
@@ -254,7 +259,7 @@ class TextContentBlock(TypedDict):
 
 
 class ToolCall(TypedDict):
-    """Represents a request to call a tool.
+    """Represents an AI's request to call a tool.
 
     Example:
         ```python
@@ -264,7 +269,7 @@ class ToolCall(TypedDict):
         This represents a request to call the tool named "foo" with arguments {"a": 1}
         and an identifier of "123".
 
-    !!! note
+    !!! note "Factory function"
         `create_tool_call` may also be used as a factory to create a
         `ToolCall`. Benefits include:
 
@@ -299,7 +304,7 @@ class ToolCall(TypedDict):
 
 
 class ToolCallChunk(TypedDict):
-    """A chunk of a tool call (e.g., as part of a stream).
+    """A chunk of a tool call (yielded when streaming).
 
     When merging `ToolCallChunks` (e.g., via `AIMessageChunk.__add__`),
     all string attributes are concatenated. Chunks are only merged if their
@@ -381,7 +386,10 @@ class InvalidToolCall(TypedDict):
 
 
 class ServerToolCall(TypedDict):
-    """Tool call that is executed server-side."""
+    """Tool call that is executed server-side.
+
+    For example: code execution, web search, etc.
+    """
 
     type: Literal["server_tool_call"]
     """Used for discrimination."""
@@ -403,7 +411,7 @@ class ServerToolCall(TypedDict):
 
 
 class ServerToolCallChunk(TypedDict):
-    """A chunk of a tool call (as part of a stream)."""
+    """A chunk of a server-side tool call (yielded when streaming)."""
 
     type: Literal["server_tool_call_chunk"]
     """Used for discrimination."""
@@ -452,7 +460,7 @@ class ServerToolResult(TypedDict):
 class ReasoningContentBlock(TypedDict):
     """Reasoning output from a LLM.
 
-    !!! note
+    !!! note "Factory function"
         `create_reasoning_block` may also be used as a factory to create a
         `ReasoningContentBlock`. Benefits include:
 
@@ -468,6 +476,7 @@ class ReasoningContentBlock(TypedDict):
     """Content block identifier.
 
     Either:
+
     - Generated by the provider (e.g., OpenAI's file ID)
     - Generated by LangChain upon creation (`UUID4` prefixed with `'lc_'`))
 
@@ -494,7 +503,7 @@ class ReasoningContentBlock(TypedDict):
 class ImageContentBlock(TypedDict):
     """Image data.
 
-    !!! note
+    !!! note "Factory function"
         `create_image_block` may also be used as a factory to create a
         `ImageContentBlock`. Benefits include:
 
@@ -510,6 +519,7 @@ class ImageContentBlock(TypedDict):
     """Content block identifier.
 
     Either:
+
     - Generated by the provider (e.g., OpenAI's file ID)
     - Generated by LangChain upon creation (`UUID4` prefixed with `'lc_'`))
 
@@ -541,7 +551,7 @@ class ImageContentBlock(TypedDict):
 class VideoContentBlock(TypedDict):
     """Video data.
 
-    !!! note
+    !!! note "Factory function"
         `create_video_block` may also be used as a factory to create a
         `VideoContentBlock`. Benefits include:
 
@@ -557,6 +567,7 @@ class VideoContentBlock(TypedDict):
     """Content block identifier.
 
     Either:
+
     - Generated by the provider (e.g., OpenAI's file ID)
     - Generated by LangChain upon creation (`UUID4` prefixed with `'lc_'`))
 
@@ -588,7 +599,7 @@ class VideoContentBlock(TypedDict):
 class AudioContentBlock(TypedDict):
     """Audio data.
 
-    !!! note
+    !!! note "Factory function"
         `create_audio_block` may also be used as a factory to create an
         `AudioContentBlock`. Benefits include:
         * Automatic ID generation (when not provided)
@@ -603,6 +614,7 @@ class AudioContentBlock(TypedDict):
     """Content block identifier.
 
     Either:
+
     - Generated by the provider (e.g., OpenAI's file ID)
     - Generated by LangChain upon creation (`UUID4` prefixed with `'lc_'`))
 
@@ -642,9 +654,9 @@ class PlainTextContentBlock(TypedDict):
 
     !!! note
         Title and context are optional fields that may be passed to the model. See
-        Anthropic [example](https://docs.anthropic.com/en/docs/build-with-claude/citations#citable-vs-non-citable-content).
+        Anthropic [example](https://docs.claude.com/en/docs/build-with-claude/citations#citable-vs-non-citable-content).
 
-    !!! note
+    !!! note "Factory function"
         `create_plaintext_block` may also be used as a factory to create a
         `PlainTextContentBlock`. Benefits include:
 
@@ -660,6 +672,7 @@ class PlainTextContentBlock(TypedDict):
     """Content block identifier.
 
     Either:
+
     - Generated by the provider (e.g., OpenAI's file ID)
     - Generated by LangChain upon creation (`UUID4` prefixed with `'lc_'`))
 
@@ -694,7 +707,7 @@ class PlainTextContentBlock(TypedDict):
 
 
 class FileContentBlock(TypedDict):
-    """File data that doesn't fit into other multimodal blocks.
+    """File data that doesn't fit into other multimodal block types.
 
     This block is intended for files that are not images, audio, or plaintext. For
     example, it can be used for PDFs, Word documents, etc.
@@ -703,7 +716,7 @@ class FileContentBlock(TypedDict):
     content block type (e.g., `ImageContentBlock`, `AudioContentBlock`,
     `PlainTextContentBlock`).
 
-    !!! note
+    !!! note "Factory function"
         `create_file_block` may also be used as a factory to create a
         `FileContentBlock`. Benefits include:
 
@@ -719,6 +732,7 @@ class FileContentBlock(TypedDict):
     """Content block identifier.
 
     Either:
+
     - Generated by the provider (e.g., OpenAI's file ID)
     - Generated by LangChain upon creation (`UUID4` prefixed with `'lc_'`))
 
@@ -765,7 +779,7 @@ class NonStandardContentBlock(TypedDict):
     Has no `extras` field, as provider-specific data should be included in the
     `value` field.
 
-    !!! note
+    !!! note "Factory function"
         `create_non_standard_block` may also be used as a factory to create a
         `NonStandardContentBlock`. Benefits include:
 
@@ -781,6 +795,7 @@ class NonStandardContentBlock(TypedDict):
     """Content block identifier.
 
     Either:
+
     - Generated by the provider (e.g., OpenAI's file ID)
     - Generated by LangChain upon creation (`UUID4` prefixed with `'lc_'`))
 
@@ -801,6 +816,7 @@ DataContentBlock = (
     | PlainTextContentBlock
     | FileContentBlock
 )
+"""A union of all defined multimodal data `ContentBlock` types."""
 
 ToolContentBlock = (
     ToolCall | ToolCallChunk | ServerToolCall | ServerToolCallChunk | ServerToolResult
@@ -814,6 +830,7 @@ ContentBlock = (
     | DataContentBlock
     | ToolContentBlock
 )
+"""A union of all defined `ContentBlock` types and aliases."""
 
 
 KNOWN_BLOCK_TYPES = {

langchain_core/messages/function.py

@@ -19,7 +19,7 @@ class FunctionMessage(BaseMessage):
     do not contain the `tool_call_id` field.
 
     The `tool_call_id` field is used to associate the tool call request with the
-    tool call response. This is useful in situations where a chat model is able
+    tool call response. Useful in situations where a chat model is able
     to request multiple tool calls in parallel.
 
     """
@@ -28,7 +28,7 @@ class FunctionMessage(BaseMessage):
     """The name of the function that was executed."""
 
     type: Literal["function"] = "function"
-    """The type of the message (used for serialization). Defaults to `'function'`."""
+    """The type of the message (used for serialization)."""
 
 
 class FunctionMessageChunk(FunctionMessage, BaseMessageChunk):
@@ -38,11 +38,7 @@ class FunctionMessageChunk(FunctionMessage, BaseMessageChunk):
     # to make sure that the chunk variant can be discriminated from the
     # non-chunk variant.
     type: Literal["FunctionMessageChunk"] = "FunctionMessageChunk"  # type: ignore[assignment]
-    """The type of the message (used for serialization).
-
-    Defaults to `'FunctionMessageChunk'`.
-
-    """
+    """The type of the message (used for serialization)."""
 
     @override
     def __add__(self, other: Any) -> BaseMessageChunk:  # type: ignore[override]

langchain_core/messages/human.py

@@ -7,9 +7,9 @@ from langchain_core.messages.base import BaseMessage, BaseMessageChunk
 
 
 class HumanMessage(BaseMessage):
-    """Message from a human.
+    """Message from the user.
 
-    `HumanMessage`s are messages that are passed in from a human to the model.
+    A `HumanMessage` is a message that is passed in from a user to the model.
 
     Example:
         ```python
@@ -27,11 +27,7 @@ class HumanMessage(BaseMessage):
     """
 
     type: Literal["human"] = "human"
-    """The type of the message (used for serialization).
-
-    Defaults to `'human'`.
-
-    """
+    """The type of the message (used for serialization)."""
 
     @overload
     def __init__(
@@ -71,5 +67,4 @@ class HumanMessageChunk(HumanMessage, BaseMessageChunk):
     # to make sure that the chunk variant can be discriminated from the
     # non-chunk variant.
     type: Literal["HumanMessageChunk"] = "HumanMessageChunk"  # type: ignore[assignment]
-    """The type of the message (used for serialization).
-    Defaults to "HumanMessageChunk"."""
+    """The type of the message (used for serialization)."""

langchain_core/messages/modifier.py

@@ -9,7 +9,7 @@ class RemoveMessage(BaseMessage):
     """Message responsible for deleting other messages."""
 
     type: Literal["remove"] = "remove"
-    """The type of the message (used for serialization). Defaults to "remove"."""
+    """The type of the message (used for serialization)."""
 
     def __init__(
         self,

langchain_core/messages/system.py

@@ -27,11 +27,7 @@ class SystemMessage(BaseMessage):
     """
 
     type: Literal["system"] = "system"
-    """The type of the message (used for serialization).
-
-    Defaults to `'system'`.
-
-    """
+    """The type of the message (used for serialization)."""
 
     @overload
     def __init__(
@@ -71,8 +67,4 @@ class SystemMessageChunk(SystemMessage, BaseMessageChunk):
     # to make sure that the chunk variant can be discriminated from the
     # non-chunk variant.
     type: Literal["SystemMessageChunk"] = "SystemMessageChunk"  # type: ignore[assignment]
-    """The type of the message (used for serialization).
-
-    Defaults to `'SystemMessageChunk'`.
-
-    """
+    """The type of the message (used for serialization)."""

langchain_core/messages/tool.py

@@ -31,36 +31,34 @@ class ToolMessage(BaseMessage, ToolOutputMixin):
 
     Example: A `ToolMessage` representing a result of `42` from a tool call with id
 
-        ```python
-        from langchain_core.messages import ToolMessage
+    ```python
+    from langchain_core.messages import ToolMessage
 
-        ToolMessage(content="42", tool_call_id="call_Jja7J89XsjrOLA5r!MEOW!SL")
-        ```
+    ToolMessage(content="42", tool_call_id="call_Jja7J89XsjrOLA5r!MEOW!SL")
+    ```
 
     Example: A `ToolMessage` where only part of the tool output is sent to the model
-        and the full output is passed in to artifact.
-
-        !!! version-added "Added in version 0.2.17"
+    and the full output is passed in to artifact.
 
-        ```python
-        from langchain_core.messages import ToolMessage
-
-        tool_output = {
-            "stdout": "From the graph we can see that the correlation between "
-            "x and y is ...",
-            "stderr": None,
-            "artifacts": {"type": "image", "base64_data": "/9j/4gIcSU..."},
-        }
-
-        ToolMessage(
-            content=tool_output["stdout"],
-            artifact=tool_output,
-            tool_call_id="call_Jja7J89XsjrOLA5r!MEOW!SL",
-        )
-        ```
+    ```python
+    from langchain_core.messages import ToolMessage
+
+    tool_output = {
+        "stdout": "From the graph we can see that the correlation between "
+        "x and y is ...",
+        "stderr": None,
+        "artifacts": {"type": "image", "base64_data": "/9j/4gIcSU..."},
+    }
+
+    ToolMessage(
+        content=tool_output["stdout"],
+        artifact=tool_output,
+        tool_call_id="call_Jja7J89XsjrOLA5r!MEOW!SL",
+    )
+    ```
 
     The `tool_call_id` field is used to associate the tool call request with the
-    tool call response. This is useful in situations where a chat model is able
+    tool call response. Useful in situations where a chat model is able
     to request multiple tool calls in parallel.
 
     """
@@ -69,11 +67,7 @@ class ToolMessage(BaseMessage, ToolOutputMixin):
     """Tool call that this message is responding to."""
 
     type: Literal["tool"] = "tool"
-    """The type of the message (used for serialization).
-
-    Defaults to `'tool'`.
-
-    """
+    """The type of the message (used for serialization)."""
 
     artifact: Any = None
     """Artifact of the Tool execution which is not meant to be sent to the model.
@@ -82,21 +76,15 @@ class ToolMessage(BaseMessage, ToolOutputMixin):
     a subset of the full tool output is being passed as message content but the full
     output is needed in other parts of the code.
 
-    !!! version-added "Added in version 0.2.17"
-
     """
 
     status: Literal["success", "error"] = "success"
-    """Status of the tool invocation.
-
-    !!! version-added "Added in version 0.2.24"
-
-    """
+    """Status of the tool invocation."""
 
     additional_kwargs: dict = Field(default_factory=dict, repr=False)
-    """Currently inherited from BaseMessage, but not used."""
+    """Currently inherited from `BaseMessage`, but not used."""
     response_metadata: dict = Field(default_factory=dict, repr=False)
-    """Currently inherited from BaseMessage, but not used."""
+    """Currently inherited from `BaseMessage`, but not used."""
 
     @model_validator(mode="before")
     @classmethod
@@ -164,12 +152,12 @@ class ToolMessage(BaseMessage, ToolOutputMixin):
         content_blocks: list[types.ContentBlock] | None = None,
         **kwargs: Any,
     ) -> None:
-        """Initialize `ToolMessage`.
+        """Initialize a `ToolMessage`.
 
         Specify `content` as positional arg or `content_blocks` for typing.
 
         Args:
-            content: The string contents of the message.
+            content: The contents of the message.
             content_blocks: Typed standard content.
             **kwargs: Additional fields.
         """
@@ -215,7 +203,7 @@ class ToolMessageChunk(ToolMessage, BaseMessageChunk):
 
 
 class ToolCall(TypedDict):
-    """Represents a request to call a tool.
+    """Represents an AI's request to call a tool.
 
     Example:
         ```python
@@ -261,7 +249,7 @@ def tool_call(
 
 
 class ToolCallChunk(TypedDict):
-    """A chunk of a tool call (e.g., as part of a stream).
+    """A chunk of a tool call (yielded when streaming).
 
     When merging `ToolCallChunk`s (e.g., via `AIMessageChunk.__add__`),
     all string attributes are concatenated. Chunks are only merged if their