langchain 1.0.0a12__py3-none-any.whl → 1.0.4__py3-none-any.whl

langchain-1.0.4.dist-info/METADATA

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: langchain
+Version: 1.0.4
+Summary: Building applications with LLMs through composability
+Project-URL: Homepage, https://docs.langchain.com/
+Project-URL: Documentation, https://reference.langchain.com/python/langchain/langchain/
+Project-URL: Source, https://github.com/langchain-ai/langchain/tree/master/libs/langchain
+Project-URL: Changelog, https://github.com/langchain-ai/langchain/releases?q=tag%3A%22langchain%3D%3D1%22
+Project-URL: Twitter, https://x.com/LangChainAI
+Project-URL: Slack, https://www.langchain.com/join-community
+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.0.0
+Requires-Dist: langgraph<1.1.0,>=1.0.2
+Requires-Dist: pydantic<3.0.0,>=2.7.4
+Provides-Extra: anthropic
+Requires-Dist: langchain-anthropic; extra == 'anthropic'
+Provides-Extra: aws
+Requires-Dist: langchain-aws; extra == 'aws'
+Provides-Extra: azure-ai
+Requires-Dist: langchain-azure-ai; extra == 'azure-ai'
+Provides-Extra: community
+Requires-Dist: langchain-community; extra == 'community'
+Provides-Extra: deepseek
+Requires-Dist: langchain-deepseek; extra == 'deepseek'
+Provides-Extra: fireworks
+Requires-Dist: langchain-fireworks; extra == 'fireworks'
+Provides-Extra: google-genai
+Requires-Dist: langchain-google-genai; extra == 'google-genai'
+Provides-Extra: google-vertexai
+Requires-Dist: langchain-google-vertexai; extra == 'google-vertexai'
+Provides-Extra: groq
+Requires-Dist: langchain-groq; extra == 'groq'
+Provides-Extra: huggingface
+Requires-Dist: langchain-huggingface; extra == 'huggingface'
+Provides-Extra: mistralai
+Requires-Dist: langchain-mistralai; extra == 'mistralai'
+Provides-Extra: model-profiles
+Requires-Dist: langchain-model-profiles; extra == 'model-profiles'
+Provides-Extra: ollama
+Requires-Dist: langchain-ollama; extra == 'ollama'
+Provides-Extra: openai
+Requires-Dist: langchain-openai; extra == 'openai'
+Provides-Extra: perplexity
+Requires-Dist: langchain-perplexity; extra == 'perplexity'
+Provides-Extra: together
+Requires-Dist: langchain-together; extra == 'together'
+Provides-Extra: xai
+Requires-Dist: langchain-xai; extra == 'xai'
+Description-Content-Type: text/markdown
+
+# 🦜️🔗 LangChain
+
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain?label=%20)](https://pypi.org/project/langchain/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain)](https://pypistats.org/packages/langchain)
+[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchainai.svg?style=social&label=Follow%20%40LangChainAI)](https://twitter.com/langchainai)
+
+Looking for the JS/TS version? Check out [LangChain.js](https://github.com/langchain-ai/langchainjs).
+
+To help you ship LangChain apps to production faster, check out [LangSmith](https://smith.langchain.com).
+[LangSmith](https://smith.langchain.com) is a unified developer platform for building, testing, and monitoring LLM applications.
+
+## Quick Install
+
+```bash
+pip install langchain
+```
+
+## 🤔 What is this?
+
+LangChain is the easiest way to start building agents and applications powered by LLMs. With under 10 lines of code, you can connect to OpenAI, Anthropic, Google, and [more](https://docs.langchain.com/oss/python/integrations/providers/overview). LangChain provides a pre-built agent architecture and model integrations to help you get started quickly and seamlessly incorporate LLMs into your agents and applications.
+
+We recommend you use LangChain if you want to quickly build agents and autonomous applications. Use [LangGraph](https://docs.langchain.com/oss/python/langgraph/overview), our low-level agent orchestration framework and runtime, when you have more advanced needs that require a combination of deterministic and agentic workflows, heavy customization, and carefully controlled latency.
+
+LangChain [agents](https://docs.langchain.com/oss/python/langchain/agents) are built on top of LangGraph in order to provide durable execution, streaming, human-in-the-loop, persistence, and more. (You do not need to know LangGraph for basic LangChain agent usage.)
+
+## 📖 Documentation
+
+For full documentation, see the [API reference](https://reference.langchain.com/python/langchain/langchain/).
+
+## 📕 Releases & Versioning
+
+See our [Releases](https://docs.langchain.com/oss/python/release-policy) and [Versioning](https://docs.langchain.com/oss/python/versioning) policies.
+
+## 💁 Contributing
+
+As an open-source project in a rapidly developing field, we are extremely open to contributions, whether it be in the form of a new feature, improved infrastructure, or better documentation.
+
+For detailed information on how to contribute, see the [Contributing Guide](https://docs.langchain.com/oss/python/contributing/overview).

langchain-1.0.4.dist-info/RECORD

@@ -0,0 +1,34 @@
+langchain/__init__.py,sha256=6ZpcmOCcqhKHHCh2pnjoWxfV5iHK24TAYhVsLU3QJZs,61
+langchain/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/agents/__init__.py,sha256=tDjbhFSC6XHQUZ_XvjHwmbICFfjxmE9xKFMbUVSIwfs,522
+langchain/agents/factory.py,sha256=IZXTYMUCsqglVD9082kplSuhxpgYKoNlvjzTtTr8_aE,63985
+langchain/agents/structured_output.py,sha256=nTVyron52uqRIaj2rVY5pJWGd-0mubdA15VR2htx6Mo,14083
+langchain/agents/middleware/__init__.py,sha256=Vm-Ajh4YoaahAa9b_XEAuiyoupKNIwZVzX-8JN1xKkA,2251
+langchain/agents/middleware/_execution.py,sha256=Xyjh3HxTHbgA-C9FFE4WXUOqKUW8mdOB455XRlA_BOU,14251
+langchain/agents/middleware/_redaction.py,sha256=LJeNOvdZ0gd4273Lqgpbxh7EiuuZ6q5LlqeHK4eyin4,11210
+langchain/agents/middleware/context_editing.py,sha256=suWxzSoBTgDse3n4myHooNJ8db7FJRzxZw_vLtoD_dw,8733
+langchain/agents/middleware/file_search.py,sha256=RiBNJRfy8R5E8TvjQRVgXf1O0UDtXqEarirFPnihbtI,12757
+langchain/agents/middleware/human_in_the_loop.py,sha256=N7Vt31rlHS7J-cA0EBDS2mlQW-SMvvxyAwjBnAY9vZU,12650
+langchain/agents/middleware/model_call_limit.py,sha256=2tMKzXeRU2zH_Iu4flyk47Ycg4Al503tdGAltkCH_NE,7719
+langchain/agents/middleware/model_fallback.py,sha256=5DhMhF-mpWlGyZ0FWTXjdtIw6VTpFG-OEkv_cVTtj80,4106
+langchain/agents/middleware/pii.py,sha256=I3nTAnfvrHqre9SoRJvlw0koT8-x3gGZdSvb0uKH5xg,10978
+langchain/agents/middleware/shell_tool.py,sha256=zKy8eTLhYoW5ogLpVBMQ1wK8lrfUCElCdG7gxvlKIeY,26635
+langchain/agents/middleware/summarization.py,sha256=RgsRVuNEdf_2d-YM6P9txyi5eJW_xLteqMw1YmEDSXg,10313
+langchain/agents/middleware/todo.py,sha256=ZH129wzq7nTWPg2A2SqEbGqZeaTa8w7DIbJluZ2irX0,9853
+langchain/agents/middleware/tool_call_limit.py,sha256=N17JNRI4MC36TDFXv1cYQbWZOF8FtYToAjGSJZLjXWc,17682
+langchain/agents/middleware/tool_emulator.py,sha256=jCgojSbb5EYPk6BmOzN0tAkEeRpzvDcAVky7duQkQG0,7209
+langchain/agents/middleware/tool_retry.py,sha256=xeR_i48DnHRZGKLQuRs6gry9Kx0q_x2S0hcnnftPnBs,13795
+langchain/agents/middleware/tool_selection.py,sha256=6RYdgkg6aSNx1w-YxRyL2Hct7UPnMRgGg6YVZVtW5TU,11638
+langchain/agents/middleware/types.py,sha256=6kPHwSwUU47QsW_O_X5Y9XP56_qJmXG9CfjoXtciX94,55873
+langchain/chat_models/__init__.py,sha256=lQwcJkHtGjrclCL7sBFocQuzRdRgZRPzIIPnGhEJmVQ,533
+langchain/chat_models/base.py,sha256=qkLfLXx1Cc836quJk05CvjFIa8OaEYeDg53qUShS6jw,36527
+langchain/embeddings/__init__.py,sha256=6gZ5HnxoKdlYNG84vf6kuJi6vA59Saa3WZ2vMn0LYxY,850
+langchain/embeddings/base.py,sha256=LTaC-CTPnluyo6wBDygQUwZSpa9ms3A1fFMabT__U2w,8921
+langchain/messages/__init__.py,sha256=IL1zvUHXvJ__3N80hhXhPj10KY0Drtq9K0CkK4uvVxU,1868
+langchain/rate_limiters/__init__.py,sha256=5490xUNhet37N2nX6kbJlDgf8u1DX-C1Cs_r7etXn8A,351
+langchain/tools/__init__.py,sha256=hMzbaGcfHhNYfJx20uV57uMd9a-gNLbmopG4gDReeEc,628
+langchain/tools/tool_node.py,sha256=1DRMsm5tc31T76rtqtqJkGINw7ny1zqVCF-ViGUymFs,477
+langchain-1.0.4.dist-info/METADATA,sha256=e60jqwezLwnstgJQTEjryaVeQYmcXiP2kUgDRrBRmlU,4890
+langchain-1.0.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+langchain-1.0.4.dist-info/licenses/LICENSE,sha256=TsZ-TKbmch26hJssqCJhWXyGph7iFLvyFBYAa3stBHg,1067
+langchain-1.0.4.dist-info/RECORD,,

langchain/_internal/_documents.py

@@ -1,35 +0,0 @@
-"""Internal document utilities."""
-
-from __future__ import annotations
-
-from typing import TYPE_CHECKING
-
-if TYPE_CHECKING:
-    from langchain_core.documents import Document
-
-
-def format_document_xml(doc: Document) -> str:
-    """Format a document as XML-like structure for LLM consumption.
-
-    Args:
-        doc: Document to format
-
-    Returns:
-        Document wrapped in XML tags:
-            <document>
-                <id>...</id>
-                <content>...</content>
-                <metadata>...</metadata>
-            </document>
-
-    !!! note
-        Does not generate valid XML or escape special characters. Intended for
-        semi-structured LLM input only.
-
-    """
-    id_str = f"<id>{doc.id}</id>" if doc.id is not None else "<id></id>"
-    metadata_str = ""
-    if doc.metadata:
-        metadata_items = [f"{k}: {v!s}" for k, v in doc.metadata.items()]
-        metadata_str = f"<metadata>{', '.join(metadata_items)}</metadata>"
-    return f"<document>{id_str}<content>{doc.page_content}</content>{metadata_str}</document>"

langchain/_internal/_lazy_import.py

@@ -1,35 +0,0 @@
-"""Lazy import utilities."""
-
-from importlib import import_module
-
-
-def import_attr(
-    attr_name: str,
-    module_name: str | None,
-    package: str | None,
-) -> object:
-    """Import an attribute from a module located in a package.
-
-    This utility function is used in custom __getattr__ methods within __init__.py
-    files to dynamically import attributes.
-
-    Args:
-        attr_name: The name of the attribute to import.
-        module_name: The name of the module to import from. If None, the attribute
-            is imported from the package itself.
-        package: The name of the package where the module is located.
-    """
-    if module_name == "__module__" or module_name is None:
-        try:
-            result = import_module(f".{attr_name}", package=package)
-        except ModuleNotFoundError:
-            msg = f"module '{package!r}' has no attribute {attr_name!r}"
-            raise AttributeError(msg) from None
-    else:
-        try:
-            module = import_module(f".{module_name}", package=package)
-        except ModuleNotFoundError as err:
-            msg = f"module '{package!r}.{module_name!r}' not found ({err})"
-            raise ImportError(msg) from None
-        result = getattr(module, attr_name)
-    return result

langchain/_internal/_prompts.py

@@ -1,158 +0,0 @@
-"""Internal prompt resolution utilities.
-
-This module provides utilities for resolving different types of prompt specifications
-into standardized message formats for language models. It supports both synchronous
-and asynchronous prompt resolution with automatic detection of callable types.
-
-The module is designed to handle common prompt patterns across LangChain components,
-particularly for summarization chains and other document processing workflows.
-
-"""
-
-from __future__ import annotations
-
-import inspect
-from typing import TYPE_CHECKING
-
-if TYPE_CHECKING:
-    from collections.abc import Awaitable, Callable
-
-    from langchain_core.messages import MessageLikeRepresentation
-    from langgraph.runtime import Runtime
-
-    from langchain._internal._typing import ContextT, StateT
-
-
-def resolve_prompt(
-    prompt: str | None | Callable[[StateT, Runtime[ContextT]], list[MessageLikeRepresentation]],
-    state: StateT,
-    runtime: Runtime[ContextT],
-    default_user_content: str,
-    default_system_content: str,
-) -> list[MessageLikeRepresentation]:
-    """Resolve a prompt specification into a list of messages.
-
-    Handles prompt resolution across different strategies. Supports callable functions,
-    string system messages, and None for default behavior.
-
-    Args:
-        prompt: The prompt specification to resolve. Can be:
-            - Callable: Function taking (state, runtime) returning message list.
-            - str: A system message string.
-            - None: Use the provided default system message.
-        state: Current state, passed to callable prompts.
-        runtime: LangGraph runtime instance, passed to callable prompts.
-        default_user_content: User content to include (e.g., document text).
-        default_system_content: Default system message when prompt is None.
-
-    Returns:
-        List of message dictionaries for language models, typically containing
-        a system message and user message with content.
-
-    Raises:
-        TypeError: If prompt type is not str, None, or callable.
-
-    Example:
-        ```python
-        def custom_prompt(state, runtime):
-            return [{"role": "system", "content": "Custom"}]
-
-
-        messages = resolve_prompt(custom_prompt, state, runtime, "content", "default")
-        messages = resolve_prompt("Custom system", state, runtime, "content", "default")
-        messages = resolve_prompt(None, state, runtime, "content", "Default")
-        ```
-
-    !!! note
-        Callable prompts have full control over message structure and content parameter
-        is ignored. String/None prompts create standard system + user structure.
-
-    """
-    if callable(prompt):
-        return prompt(state, runtime)
-    if isinstance(prompt, str):
-        system_msg = prompt
-    elif prompt is None:
-        system_msg = default_system_content
-    else:
-        msg = f"Invalid prompt type: {type(prompt)}. Expected str, None, or callable."
-        raise TypeError(msg)
-
-    return [
-        {"role": "system", "content": system_msg},
-        {"role": "user", "content": default_user_content},
-    ]
-
-
-async def aresolve_prompt(
-    prompt: str
-    | None
-    | Callable[[StateT, Runtime[ContextT]], list[MessageLikeRepresentation]]
-    | Callable[[StateT, Runtime[ContextT]], Awaitable[list[MessageLikeRepresentation]]],
-    state: StateT,
-    runtime: Runtime[ContextT],
-    default_user_content: str,
-    default_system_content: str,
-) -> list[MessageLikeRepresentation]:
-    """Async version of resolve_prompt supporting both sync and async callables.
-
-    Handles prompt resolution across different strategies. Supports sync/async callable
-    functions, string system messages, and None for default behavior.
-
-    Args:
-        prompt: The prompt specification to resolve. Can be:
-            - Callable (sync): Function taking (state, runtime) returning message list.
-            - Callable (async): Async function taking (state, runtime) returning
-              awaitable message list.
-            - str: A system message string.
-            - None: Use the provided default system message.
-        state: Current state, passed to callable prompts.
-        runtime: LangGraph runtime instance, passed to callable prompts.
-        default_user_content: User content to include (e.g., document text).
-        default_system_content: Default system message when prompt is None.
-
-    Returns:
-        List of message dictionaries for language models, typically containing
-        a system message and user message with content.
-
-    Raises:
-        TypeError: If prompt type is not str, None, or callable.
-
-    Example:
-        ```python
-        async def async_prompt(state, runtime):
-            return [{"role": "system", "content": "Async"}]
-
-
-        def sync_prompt(state, runtime):
-            return [{"role": "system", "content": "Sync"}]
-
-
-        messages = await aresolve_prompt(async_prompt, state, runtime, "content", "default")
-        messages = await aresolve_prompt(sync_prompt, state, runtime, "content", "default")
-        messages = await aresolve_prompt("Custom", state, runtime, "content", "default")
-        ```
-
-    !!! note
-        Callable prompts have full control over message structure and content parameter
-        is ignored. Automatically detects and handles async callables.
-
-    """
-    if callable(prompt):
-        result = prompt(state, runtime)
-        # Check if the result is awaitable (async function)
-        if inspect.isawaitable(result):
-            return await result
-        return result
-    if isinstance(prompt, str):
-        system_msg = prompt
-    elif prompt is None:
-        system_msg = default_system_content
-    else:
-        msg = f"Invalid prompt type: {type(prompt)}. Expected str, None, or callable."
-        raise TypeError(msg)
-
-    return [
-        {"role": "system", "content": system_msg},
-        {"role": "user", "content": default_user_content},
-    ]

langchain/_internal/_typing.py

@@ -1,70 +0,0 @@
-"""Private typing utilities for langchain."""
-
-from __future__ import annotations
-
-from typing import TYPE_CHECKING, Any, ClassVar, Protocol, TypeAlias, TypeVar
-
-from langgraph.graph._node import StateNode
-from pydantic import BaseModel
-
-if TYPE_CHECKING:
-    from dataclasses import Field
-
-
-class TypedDictLikeV1(Protocol):
-    """Protocol to represent types that behave like ``TypedDict``s.
-
-    Version 1: using ``ClassVar`` for keys.
-
-    """
-
-    __required_keys__: ClassVar[frozenset[str]]
-    __optional_keys__: ClassVar[frozenset[str]]
-
-
-class TypedDictLikeV2(Protocol):
-    """Protocol to represent types that behave like ``TypedDict``s.
-
-    Version 2: not using ``ClassVar`` for keys.
-
-    """
-
-    __required_keys__: frozenset[str]
-    __optional_keys__: frozenset[str]
-
-
-class DataclassLike(Protocol):
-    """Protocol to represent types that behave like dataclasses.
-
-    Inspired by the private ``_DataclassT`` from dataclasses that uses a similar
-    protocol as a bound.
-
-    """
-
-    __dataclass_fields__: ClassVar[dict[str, Field[Any]]]
-
-
-StateLike: TypeAlias = TypedDictLikeV1 | TypedDictLikeV2 | DataclassLike | BaseModel
-"""Type alias for state-like types.
-
-It can either be a ``TypedDict``, ``dataclass``, or Pydantic ``BaseModel``.
-
-!!! note
-    We cannot use either ``TypedDict`` or ``dataclass`` directly due to limitations in
-    type checking.
-
-"""
-
-StateT = TypeVar("StateT", bound=StateLike)
-"""Type variable used to represent the state in a graph."""
-
-ContextT = TypeVar("ContextT", bound=StateLike | None)
-"""Type variable for context types."""
-
-
-__all__ = [
-    "ContextT",
-    "StateLike",
-    "StateNode",
-    "StateT",
-]

langchain/_internal/_utils.py

@@ -1,7 +0,0 @@
-# Re-exporting internal utilities from LangGraph for internal use in LangChain.
-# A different wrapper needs to be created for this purpose in LangChain.
-from langgraph._internal._runnable import RunnableCallable
-
-__all__ = [
-    "RunnableCallable",
-]

langchain/agents/_internal/__init__.py

@@ -1 +0,0 @@
-"""Internal utilities for agents."""

langchain/agents/_internal/_typing.py

@@ -1,13 +0,0 @@
-"""Typing utilities for agents."""
-
-from __future__ import annotations
-
-from collections.abc import Awaitable, Callable
-from typing import TypeVar
-
-from typing_extensions import ParamSpec
-
-P = ParamSpec("P")
-R = TypeVar("R")
-
-SyncOrAsync = Callable[P, R | Awaitable[R]]

langchain/agents/middleware/prompt_caching.py

@@ -1,86 +0,0 @@
-"""Anthropic prompt caching middleware."""
-
-from typing import Literal
-from warnings import warn
-
-from langgraph.runtime import Runtime
-
-from langchain.agents.middleware.types import AgentMiddleware, AgentState, ModelRequest
-
-
-class AnthropicPromptCachingMiddleware(AgentMiddleware):
-    """Prompt Caching Middleware.
-
-    Optimizes API usage by caching conversation prefixes for Anthropic models.
-
-    Learn more about Anthropic prompt caching
-    `here <https://docs.anthropic.com/en/docs/build-with-claude/prompt-caching>`__.
-    """
-
-    def __init__(
-        self,
-        type: Literal["ephemeral"] = "ephemeral",
-        ttl: Literal["5m", "1h"] = "5m",
-        min_messages_to_cache: int = 0,
-        unsupported_model_behavior: Literal["ignore", "warn", "raise"] = "warn",
-    ) -> None:
-        """Initialize the middleware with cache control settings.
-
-        Args:
-            type: The type of cache to use, only "ephemeral" is supported.
-            ttl: The time to live for the cache, only "5m" and "1h" are supported.
-            min_messages_to_cache: The minimum number of messages until the cache is used,
-                default is 0.
-            unsupported_model_behavior: The behavior to take when an unsupported model is used.
-                "ignore" will ignore the unsupported model and continue without caching.
-                "warn" will warn the user and continue without caching.
-                "raise" will raise an error and stop the agent.
-        """
-        self.type = type
-        self.ttl = ttl
-        self.min_messages_to_cache = min_messages_to_cache
-        self.unsupported_model_behavior = unsupported_model_behavior
-
-    def modify_model_request(
-        self,
-        request: ModelRequest,
-        state: AgentState,  # noqa: ARG002
-        runtime: Runtime,  # noqa: ARG002
-    ) -> ModelRequest:
-        """Modify the model request to add cache control blocks."""
-        try:
-            from langchain_anthropic import ChatAnthropic
-        except ImportError:
-            ChatAnthropic = None  # noqa: N806
-
-        msg: str | None = None
-
-        if ChatAnthropic is None:
-            msg = (
-                "AnthropicPromptCachingMiddleware caching middleware only supports "
-                "Anthropic models. "
-                "Please install langchain-anthropic."
-            )
-        elif not isinstance(request.model, ChatAnthropic):
-            msg = (
-                "AnthropicPromptCachingMiddleware caching middleware only supports "
-                f"Anthropic models, not instances of {type(request.model)}"
-            )
-
-        if msg is not None:
-            if self.unsupported_model_behavior == "raise":
-                raise ValueError(msg)
-            if self.unsupported_model_behavior == "warn":
-                warn(msg, stacklevel=3)
-            else:
-                return request
-
-        messages_count = (
-            len(request.messages) + 1 if request.system_prompt else len(request.messages)
-        )
-        if messages_count < self.min_messages_to_cache:
-            return request
-
-        request.model_settings["cache_control"] = {"type": self.type, "ttl": self.ttl}
-
-        return request

langchain/documents/__init__.py

@@ -1,7 +0,0 @@
-"""Document."""
-
-from langchain_core.documents import Document
-
-__all__ = [
-    "Document",
-]