langchain 0.3.8__py3-none-any.whl → 0.3.10__py3-none-any.whl

langchain/_api/deprecation.py

@@ -7,7 +7,20 @@ from langchain_core._api.deprecation import (
     warn_deprecated,
 )
 
+AGENT_DEPRECATION_WARNING = (
+    "LangChain agents will continue to be supported, but it is recommended for new "
+    "use cases to be built with LangGraph. LangGraph offers a more flexible and "
+    "full-featured framework for building agents, including support for "
+    "tool-calling, persistence of state, and human-in-the-loop workflows. See "
+    "LangGraph documentation for more details: "
+    "https://langchain-ai.github.io/langgraph/. Refer here for its pre-built "
+    "ReAct agent: "
+    "https://langchain-ai.github.io/langgraph/how-tos/create-react-agent/"
+)
+
+
 __all__ = [
+    "AGENT_DEPRECATION_WARNING",
     "LangChainDeprecationWarning",
     "LangChainPendingDeprecationWarning",
     "deprecated",

langchain/agents/agent.py

@@ -47,6 +47,7 @@ from langchain_core.utils.input import get_color_mapping
 from pydantic import BaseModel, ConfigDict, model_validator
 from typing_extensions import Self
 
+from langchain._api.deprecation import AGENT_DEPRECATION_WARNING
 from langchain.agents.agent_iterator import AgentExecutorIterator
 from langchain.agents.agent_types import AgentType
 from langchain.agents.tools import InvalidTool
@@ -633,10 +634,7 @@ class RunnableMultiActionAgent(BaseMultiActionAgent):
 
 @deprecated(
     "0.1.0",
-    message=(
-        "Use new agent constructor methods like create_react_agent, create_json_agent, "
-        "create_structured_chat_agent, etc."
-    ),
+    message=AGENT_DEPRECATION_WARNING,
     removal="1.0",
 )
 class LLMSingleActionAgent(BaseSingleActionAgent):
@@ -724,10 +722,7 @@ class LLMSingleActionAgent(BaseSingleActionAgent):
 
 @deprecated(
     "0.1.0",
-    message=(
-        "Use new agent constructor methods like create_react_agent, create_json_agent, "
-        "create_structured_chat_agent, etc."
-    ),
+    message=AGENT_DEPRECATION_WARNING,
     removal="1.0",
 )
 class Agent(BaseSingleActionAgent):

langchain/agents/agent_toolkits/vectorstore/base.py

@@ -20,6 +20,10 @@ from langchain.chains.llm import LLMChain
     since="0.2.13",
     removal="1.0",
     message=(
+        "This function will continue to be supported, but it is recommended for new "
+        "use cases to be built with LangGraph. LangGraph offers a more flexible and "
+        "full-featured framework for building agents, including support for "
+        "tool-calling, persistence of state, and human-in-the-loop workflows. "
         "See API reference for this function for a replacement implementation: "
         "https://api.python.langchain.com/en/latest/agents/langchain.agents.agent_toolkits.vectorstore.base.create_vectorstore_agent.html "  # noqa: E501
         "Read more here on how to create agents that query vector stores: "
@@ -109,6 +113,10 @@ def create_vectorstore_agent(
     since="0.2.13",
     removal="1.0",
     message=(
+        "This function will continue to be supported, but it is recommended for new "
+        "use cases to be built with LangGraph. LangGraph offers a more flexible and "
+        "full-featured framework for building agents, including support for "
+        "tool-calling, persistence of state, and human-in-the-loop workflows. "
         "See API reference for this function for a replacement implementation: "
         "https://api.python.langchain.com/en/latest/agents/langchain.agents.agent_toolkits.vectorstore.base.create_vectorstore_router_agent.html "  # noqa: E501
         "Read more here on how to create agents that query vector stores: "

langchain/agents/agent_types.py

@@ -4,13 +4,12 @@ from enum import Enum
 
 from langchain_core._api import deprecated
 
+from langchain._api.deprecation import AGENT_DEPRECATION_WARNING
+
 
 @deprecated(
     "0.1.0",
-    message=(
-        "Use new agent constructor methods like create_react_agent, create_json_agent, "
-        "create_structured_chat_agent, etc."
-    ),
+    message=AGENT_DEPRECATION_WARNING,
     removal="1.0",
 )
 class AgentType(str, Enum):

langchain/agents/chat/base.py

@@ -13,6 +13,7 @@ from langchain_core.prompts.chat import (
 from langchain_core.tools import BaseTool
 from pydantic import Field
 
+from langchain._api.deprecation import AGENT_DEPRECATION_WARNING
 from langchain.agents.agent import Agent, AgentOutputParser
 from langchain.agents.chat.output_parser import ChatOutputParser
 from langchain.agents.chat.prompt import (
@@ -25,7 +26,11 @@ from langchain.agents.utils import validate_tools_single_input
 from langchain.chains.llm import LLMChain
 
 
-@deprecated("0.1.0", alternative="create_react_agent", removal="1.0")
+@deprecated(
+    "0.1.0",
+    message=AGENT_DEPRECATION_WARNING,
+    removal="1.0",
+)
 class ChatAgent(Agent):
     """Chat Agent."""
 

langchain/agents/conversational/base.py

@@ -11,6 +11,7 @@ from langchain_core.prompts import PromptTemplate
 from langchain_core.tools import BaseTool
 from pydantic import Field
 
+from langchain._api.deprecation import AGENT_DEPRECATION_WARNING
 from langchain.agents.agent import Agent, AgentOutputParser
 from langchain.agents.agent_types import AgentType
 from langchain.agents.conversational.output_parser import ConvoOutputParser
@@ -19,7 +20,11 @@ from langchain.agents.utils import validate_tools_single_input
 from langchain.chains import LLMChain
 
 
-@deprecated("0.1.0", alternative="create_react_agent", removal="1.0")
+@deprecated(
+    "0.1.0",
+    message=AGENT_DEPRECATION_WARNING,
+    removal="1.0",
+)
 class ConversationalAgent(Agent):
     """An agent that holds a conversation in addition to using tools."""
 

langchain/agents/initialize.py

@@ -7,6 +7,7 @@ from langchain_core.callbacks import BaseCallbackManager
 from langchain_core.language_models import BaseLanguageModel
 from langchain_core.tools import BaseTool
 
+from langchain._api.deprecation import AGENT_DEPRECATION_WARNING
 from langchain.agents.agent import AgentExecutor
 from langchain.agents.agent_types import AgentType
 from langchain.agents.loading import AGENT_TO_CLASS, load_agent
@@ -14,10 +15,7 @@ from langchain.agents.loading import AGENT_TO_CLASS, load_agent
 
 @deprecated(
     "0.1.0",
-    alternative=(
-        "Use new agent constructor methods like create_react_agent, create_json_agent, "
-        "create_structured_chat_agent, etc."
-    ),
+    message=AGENT_DEPRECATION_WARNING,
     removal="1.0",
 )
 def initialize_agent(

langchain/agents/mrkl/base.py

@@ -12,6 +12,7 @@ from langchain_core.tools import BaseTool, Tool
 from langchain_core.tools.render import render_text_description
 from pydantic import Field
 
+from langchain._api.deprecation import AGENT_DEPRECATION_WARNING
 from langchain.agents.agent import Agent, AgentExecutor, AgentOutputParser
 from langchain.agents.agent_types import AgentType
 from langchain.agents.mrkl.output_parser import MRKLOutputParser
@@ -34,7 +35,11 @@ class ChainConfig(NamedTuple):
     action_description: str
 
 
-@deprecated("0.1.0", alternative="create_react_agent", removal="1.0")
+@deprecated(
+    "0.1.0",
+    message=AGENT_DEPRECATION_WARNING,
+    removal="1.0",
+)
 class ZeroShotAgent(Agent):
     """Agent for the MRKL chain.
 
@@ -168,7 +173,11 @@ class ZeroShotAgent(Agent):
         super()._validate_tools(tools)
 
 
-@deprecated("0.1.0", removal="1.0")
+@deprecated(
+    "0.1.0",
+    message=AGENT_DEPRECATION_WARNING,
+    removal="1.0",
+)
 class MRKLChain(AgentExecutor):
     """Chain that implements the MRKL system."""
 

langchain/agents/react/base.py

@@ -11,6 +11,7 @@ from langchain_core.prompts import BasePromptTemplate
 from langchain_core.tools import BaseTool, Tool
 from pydantic import Field
 
+from langchain._api.deprecation import AGENT_DEPRECATION_WARNING
 from langchain.agents.agent import Agent, AgentExecutor, AgentOutputParser
 from langchain.agents.agent_types import AgentType
 from langchain.agents.react.output_parser import ReActOutputParser
@@ -22,7 +23,11 @@ if TYPE_CHECKING:
     from langchain_community.docstore.base import Docstore
 
 
-@deprecated("0.1.0", removal="1.0")
+@deprecated(
+    "0.1.0",
+    message=AGENT_DEPRECATION_WARNING,
+    removal="1.0",
+)
 class ReActDocstoreAgent(Agent):
     """Agent for the ReAct chain."""
 
@@ -69,7 +74,11 @@ class ReActDocstoreAgent(Agent):
         return "Thought:"
 
 
-@deprecated("0.1.0", removal="1.0")
+@deprecated(
+    "0.1.0",
+    message=AGENT_DEPRECATION_WARNING,
+    removal="1.0",
+)
 class DocstoreExplorer:
     """Class to assist with exploration of a document store."""
 
@@ -119,7 +128,11 @@ class DocstoreExplorer:
         return self.document.page_content.split("\n\n")
 
 
-@deprecated("0.1.0", removal="1.0")
+@deprecated(
+    "0.1.0",
+    message=AGENT_DEPRECATION_WARNING,
+    removal="1.0",
+)
 class ReActTextWorldAgent(ReActDocstoreAgent):
     """Agent for the ReAct TextWorld chain."""
 
@@ -139,7 +152,11 @@ class ReActTextWorldAgent(ReActDocstoreAgent):
             raise ValueError(f"Tool name should be Play, got {tool_names}")
 
 
-@deprecated("0.1.0", removal="1.0")
+@deprecated(
+    "0.1.0",
+    message=AGENT_DEPRECATION_WARNING,
+    removal="1.0",
+)
 class ReActChain(AgentExecutor):
     """[Deprecated] Chain that implements the ReAct paper."""
 

langchain/chains/router/multi_prompt.py

@@ -20,9 +20,8 @@ from langchain.chains.router.multi_prompt_prompt import MULTI_PROMPT_ROUTER_TEMP
     since="0.2.12",
     removal="1.0",
     message=(
-        "Use RunnableLambda to select from multiple prompt templates. See example "
-        "in API reference: "
-        "https://api.python.langchain.com/en/latest/chains/langchain.chains.router.multi_prompt.MultiPromptChain.html"  # noqa: E501
+        "Please see migration guide here for recommended implementation: "
+        "https://python.langchain.com/docs/versions/migrating_chains/multi_prompt_chain/"  # noqa: E501
     ),
 )
 class MultiPromptChain(MultiRouteChain):
@@ -37,60 +36,109 @@ class MultiPromptChain(MultiRouteChain):
 
             from operator import itemgetter
             from typing import Literal
-            from typing_extensions import TypedDict
 
             from langchain_core.output_parsers import StrOutputParser
             from langchain_core.prompts import ChatPromptTemplate
-            from langchain_core.runnables import RunnableLambda, RunnablePassthrough
+            from langchain_core.runnables import RunnableConfig
             from langchain_openai import ChatOpenAI
+            from langgraph.graph import END, START, StateGraph
+            from typing_extensions import TypedDict
 
             llm = ChatOpenAI(model="gpt-4o-mini")
 
+            # Define the prompts we will route to
             prompt_1 = ChatPromptTemplate.from_messages(
                 [
                     ("system", "You are an expert on animals."),
-                    ("human", "{query}"),
+                    ("human", "{input}"),
                 ]
             )
             prompt_2 = ChatPromptTemplate.from_messages(
                 [
                     ("system", "You are an expert on vegetables."),
-                    ("human", "{query}"),
+                    ("human", "{input}"),
                 ]
             )
 
+            # Construct the chains we will route to. These format the input query
+            # into the respective prompt, run it through a chat model, and cast
+            # the result to a string.
             chain_1 = prompt_1 | llm | StrOutputParser()
             chain_2 = prompt_2 | llm | StrOutputParser()
 
+
+            # Next: define the chain that selects which branch to route to.
+            # Here we will take advantage of tool-calling features to force
+            # the output to select one of two desired branches.
             route_system = "Route the user's query to either the animal or vegetable expert."
             route_prompt = ChatPromptTemplate.from_messages(
                 [
                     ("system", route_system),
-                    ("human", "{query}"),
+                    ("human", "{input}"),
                 ]
             )
 
 
+            # Define schema for output:
             class RouteQuery(TypedDict):
-                \"\"\"Route query to destination.\"\"\"
+                \"\"\"Route query to destination expert.\"\"\"
+
                 destination: Literal["animal", "vegetable"]
 
 
-            route_chain = (
-                route_prompt
-                | llm.with_structured_output(RouteQuery)
-                | itemgetter("destination")
-            )
+            route_chain = route_prompt | llm.with_structured_output(RouteQuery)
 
-            chain = {
-                "destination": route_chain,  # "animal" or "vegetable"
-                "query": lambda x: x["query"],  # pass through input query
-            } | RunnableLambda(
-                # if animal, chain_1. otherwise, chain_2.
-                lambda x: chain_1 if x["destination"] == "animal" else chain_2,
-            )
 
-            chain.invoke({"query": "what color are carrots"})
+            # For LangGraph, we will define the state of the graph to hold the query,
+            # destination, and final answer.
+            class State(TypedDict):
+                query: str
+                destination: RouteQuery
+                answer: str
+
+
+            # We define functions for each node, including routing the query:
+            async def route_query(state: State, config: RunnableConfig):
+                destination = await route_chain.ainvoke(state["query"], config)
+                return {"destination": destination}
+
+
+            # And one node for each prompt
+            async def prompt_1(state: State, config: RunnableConfig):
+                return {"answer": await chain_1.ainvoke(state["query"], config)}
+
+
+            async def prompt_2(state: State, config: RunnableConfig):
+                return {"answer": await chain_2.ainvoke(state["query"], config)}
+
+
+            # We then define logic that selects the prompt based on the classification
+            def select_node(state: State) -> Literal["prompt_1", "prompt_2"]:
+                if state["destination"] == "animal":
+                    return "prompt_1"
+                else:
+                    return "prompt_2"
+
+
+            # Finally, assemble the multi-prompt chain. This is a sequence of two steps:
+            # 1) Select "animal" or "vegetable" via the route_chain, and collect the answer
+            # alongside the input query.
+            # 2) Route the input query to chain_1 or chain_2, based on the
+            # selection.
+            graph = StateGraph(State)
+            graph.add_node("route_query", route_query)
+            graph.add_node("prompt_1", prompt_1)
+            graph.add_node("prompt_2", prompt_2)
+
+            graph.add_edge(START, "route_query")
+            graph.add_conditional_edges("route_query", select_node)
+            graph.add_edge("prompt_1", END)
+            graph.add_edge("prompt_2", END)
+            app = graph.compile()
+
+            result = await app.ainvoke({"query": "what color are carrots"})
+            print(result["destination"])
+            print(result["answer"])
     """  # noqa: E501
 
     @property

langchain/chat_models/base.py

@@ -328,13 +328,7 @@ def init_chat_model(
 def _init_chat_model_helper(
     model: str, *, model_provider: Optional[str] = None, **kwargs: Any
 ) -> BaseChatModel:
-    model_provider = model_provider or _attempt_infer_model_provider(model)
-    if not model_provider:
-        raise ValueError(
-            f"Unable to infer model provider for {model=}, please specify "
-            f"model_provider directly."
-        )
-    model_provider = model_provider.replace("-", "_").lower()
+    model, model_provider = _parse_model(model, model_provider)
     if model_provider == "openai":
         _check_pkg("langchain_openai")
         from langchain_openai import ChatOpenAI
@@ -461,6 +455,24 @@ def _attempt_infer_model_provider(model_name: str) -> Optional[str]:
         return None
 
 
+def _parse_model(model: str, model_provider: Optional[str]) -> Tuple[str, str]:
+    if (
+        not model_provider
+        and ":" in model
+        and model.split(":")[0] in _SUPPORTED_PROVIDERS
+    ):
+        model_provider = model.split(":")[0]
+        model = ":".join(model.split(":")[1:])
+    model_provider = model_provider or _attempt_infer_model_provider(model)
+    if not model_provider:
+        raise ValueError(
+            f"Unable to infer model provider for {model=}, please specify "
+            f"model_provider directly."
+        )
+    model_provider = model_provider.replace("-", "_").lower()
+    return model, model_provider
+
+
 def _check_pkg(pkg: str) -> None:
     if not util.find_spec(pkg):
         pkg_kebab = pkg.replace("_", "-")

langchain/embeddings/__init__.py

@@ -14,6 +14,7 @@ import logging
 from typing import TYPE_CHECKING, Any
 
 from langchain._api import create_importer
+from langchain.embeddings.base import init_embeddings
 from langchain.embeddings.cache import CacheBackedEmbeddings
 
 if TYPE_CHECKING:
@@ -221,4 +222,5 @@ __all__ = [
     "VertexAIEmbeddings",
     "VoyageEmbeddings",
     "XinferenceEmbeddings",
+    "init_embeddings",
 ]

langchain/embeddings/base.py

@@ -1,4 +1,224 @@
+import functools
+from importlib import util
+from typing import Any, List, Optional, Tuple, Union
+
+from langchain_core._api import beta
 from langchain_core.embeddings import Embeddings
+from langchain_core.runnables import Runnable
+
+_SUPPORTED_PROVIDERS = {
+    "azure_openai": "langchain_openai",
+    "bedrock": "langchain_aws",
+    "cohere": "langchain_cohere",
+    "google_vertexai": "langchain_google_vertexai",
+    "huggingface": "langchain_huggingface",
+    "mistralai": "langchain_mistralai",
+    "openai": "langchain_openai",
+}
+
+
+def _get_provider_list() -> str:
+    """Get formatted list of providers and their packages."""
+    return "\n".join(
+        f"  - {p}: {pkg.replace('_', '-')}" for p, pkg in _SUPPORTED_PROVIDERS.items()
+    )
+
+
+def _parse_model_string(model_name: str) -> Tuple[str, str]:
+    """Parse a model string into provider and model name components.
+
+    The model string should be in the format 'provider:model-name', where provider
+    is one of the supported providers.
+
+    Args:
+        model_name: A model string in the format 'provider:model-name'
+
+    Returns:
+        A tuple of (provider, model_name)
+
+    .. code-block:: python
+
+        _parse_model_string("openai:text-embedding-3-small")
+        # Returns: ("openai", "text-embedding-3-small")
+
+        _parse_model_string("bedrock:amazon.titan-embed-text-v1")
+        # Returns: ("bedrock", "amazon.titan-embed-text-v1")
+
+    Raises:
+        ValueError: If the model string is not in the correct format or
+            the provider is unsupported
+    """
+    if ":" not in model_name:
+        providers = _SUPPORTED_PROVIDERS
+        raise ValueError(
+            f"Invalid model format '{model_name}'.\n"
+            f"Model name must be in format 'provider:model-name'\n"
+            f"Example valid model strings:\n"
+            f"  - openai:text-embedding-3-small\n"
+            f"  - bedrock:amazon.titan-embed-text-v1\n"
+            f"  - cohere:embed-english-v3.0\n"
+            f"Supported providers: {providers}"
+        )
+
+    provider, model = model_name.split(":", 1)
+    provider = provider.lower().strip()
+    model = model.strip()
+
+    if provider not in _SUPPORTED_PROVIDERS:
+        raise ValueError(
+            f"Provider '{provider}' is not supported.\n"
+            f"Supported providers and their required packages:\n"
+            f"{_get_provider_list()}"
+        )
+    if not model:
+        raise ValueError("Model name cannot be empty")
+    return provider, model
+
+
+def _infer_model_and_provider(
+    model: str, *, provider: Optional[str] = None
+) -> Tuple[str, str]:
+    if not model.strip():
+        raise ValueError("Model name cannot be empty")
+    if provider is None and ":" in model:
+        provider, model_name = _parse_model_string(model)
+    else:
+        provider = provider
+        model_name = model
+
+    if not provider:
+        providers = _SUPPORTED_PROVIDERS
+        raise ValueError(
+            "Must specify either:\n"
+            "1. A model string in format 'provider:model-name'\n"
+            "   Example: 'openai:text-embedding-3-small'\n"
+            "2. Or explicitly set provider from: "
+            f"{providers}"
+        )
+
+    if provider not in _SUPPORTED_PROVIDERS:
+        raise ValueError(
+            f"Provider '{provider}' is not supported.\n"
+            f"Supported providers and their required packages:\n"
+            f"{_get_provider_list()}"
+        )
+    return provider, model_name
+
+
+@functools.lru_cache(maxsize=len(_SUPPORTED_PROVIDERS))
+def _check_pkg(pkg: str) -> None:
+    """Check if a package is installed."""
+    if not util.find_spec(pkg):
+        raise ImportError(
+            f"Could not import {pkg} python package. "
+            f"Please install it with `pip install {pkg}`"
+        )
+
+
+@beta()
+def init_embeddings(
+    model: str,
+    *,
+    provider: Optional[str] = None,
+    **kwargs: Any,
+) -> Union[Embeddings, Runnable[Any, List[float]]]:
+    """Initialize an embeddings model from a model name and optional provider.
+
+    **Note:** Must have the integration package corresponding to the model provider
+    installed.
+
+    Args:
+        model: Name of the model to use. Can be either:
+            - A model string like "openai:text-embedding-3-small"
+            - Just the model name if provider is specified
+        provider: Optional explicit provider name. If not specified,
+            will attempt to parse from the model string. Supported providers
+            and their required packages:
+
+            {_get_provider_list()}
+
+        **kwargs: Additional model-specific parameters passed to the embedding model.
+            These vary by provider, see the provider-specific documentation for details.
+
+    Returns:
+        An Embeddings instance that can generate embeddings for text.
+
+    Raises:
+        ValueError: If the model provider is not supported or cannot be determined
+        ImportError: If the required provider package is not installed
+
+    .. dropdown:: Example Usage
+        :open:
+
+        .. code-block:: python
+
+            # Using a model string
+            model = init_embeddings("openai:text-embedding-3-small")
+            model.embed_query("Hello, world!")
+
+            # Using explicit provider
+            model = init_embeddings(
+                model="text-embedding-3-small",
+                provider="openai"
+            )
+            model.embed_documents(["Hello, world!", "Goodbye, world!"])
+
+            # With additional parameters
+            model = init_embeddings(
+                "openai:text-embedding-3-small",
+                api_key="sk-..."
+            )
+
+    .. versionadded:: 0.3.9
+    """
+    if not model:
+        providers = _SUPPORTED_PROVIDERS.keys()
+        raise ValueError(
+            "Must specify model name. "
+            f"Supported providers are: {', '.join(providers)}"
+        )
+
+    provider, model_name = _infer_model_and_provider(model, provider=provider)
+    pkg = _SUPPORTED_PROVIDERS[provider]
+    _check_pkg(pkg)
+
+    if provider == "openai":
+        from langchain_openai import OpenAIEmbeddings
+
+        return OpenAIEmbeddings(model=model_name, **kwargs)
+    elif provider == "azure_openai":
+        from langchain_openai import AzureOpenAIEmbeddings
+
+        return AzureOpenAIEmbeddings(model=model_name, **kwargs)
+    elif provider == "google_vertexai":
+        from langchain_google_vertexai import VertexAIEmbeddings
+
+        return VertexAIEmbeddings(model=model_name, **kwargs)
+    elif provider == "bedrock":
+        from langchain_aws import BedrockEmbeddings
+
+        return BedrockEmbeddings(model_id=model_name, **kwargs)
+    elif provider == "cohere":
+        from langchain_cohere import CohereEmbeddings
+
+        return CohereEmbeddings(model=model_name, **kwargs)
+    elif provider == "mistralai":
+        from langchain_mistralai import MistralAIEmbeddings
+
+        return MistralAIEmbeddings(model=model_name, **kwargs)
+    elif provider == "huggingface":
+        from langchain_huggingface import HuggingFaceEmbeddings
+
+        return HuggingFaceEmbeddings(model_name=model_name, **kwargs)
+    else:
+        raise ValueError(
+            f"Provider '{provider}' is not supported.\n"
+            f"Supported providers and their required packages:\n"
+            f"{_get_provider_list()}"
+        )
+
 
-# This is for backwards compatibility
-__all__ = ["Embeddings"]
+__all__ = [
+    "init_embeddings",
+    "Embeddings",  # This one is for backwards compatibility
+]

langchain/retrievers/self_query/base.py

@@ -161,6 +161,14 @@ def _get_builtin_translator(vectorstore: VectorStore) -> Visitor:
             if isinstance(vectorstore, MongoDBAtlasVectorSearch):
                 return MongoDBAtlasTranslator()
 
+        try:
+            from langchain_neo4j import Neo4jVector
+        except ImportError:
+            pass
+        else:
+            if isinstance(vectorstore, Neo4jVector):
+                return Neo4jTranslator()
+
         try:
             from langchain_chroma import Chroma
         except ImportError:

{langchain-0.3.8.dist-info → langchain-0.3.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: langchain
-Version: 0.3.8
+Version: 0.3.10
 Summary: Building applications with LLMs through composability
 Home-page: https://github.com/langchain-ai/langchain
 License: MIT
@@ -11,15 +11,16 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Requires-Dist: PyYAML (>=5.3)
 Requires-Dist: SQLAlchemy (>=1.4,<3)
 Requires-Dist: aiohttp (>=3.8.3,<4.0.0)
 Requires-Dist: async-timeout (>=4.0.0,<5.0.0) ; python_version < "3.11"
-Requires-Dist: langchain-core (>=0.3.21,<0.4.0)
+Requires-Dist: langchain-core (>=0.3.22,<0.4.0)
 Requires-Dist: langchain-text-splitters (>=0.3.0,<0.4.0)
 Requires-Dist: langsmith (>=0.1.17,<0.2.0)
 Requires-Dist: numpy (>=1.22.4,<2) ; python_version < "3.12"
-Requires-Dist: numpy (>=1.26.2,<2) ; python_version >= "3.12"
+Requires-Dist: numpy (>=1.26.2,<3) ; python_version >= "3.12"
 Requires-Dist: pydantic (>=2.7.4,<3.0.0)
 Requires-Dist: requests (>=2,<3)
 Requires-Dist: tenacity (>=8.1.0,!=8.4.0,<10)

{langchain-0.3.8.dist-info → langchain-0.3.10.dist-info}/RECORD

@@ -1,13 +1,13 @@
 langchain/__init__.py,sha256=4cqV-N_QJnfjk52DqtR2e72vsmJC1R6PkflvRdLjZQI,13709
 langchain/_api/__init__.py,sha256=0FuHuMNUBMrst1Y1nm5yZzQr2xbLmb7rxMsimqKBXhs,733
-langchain/_api/deprecation.py,sha256=MpH4S7a11UDuoAGCv1RLWGn4pwhoFwEOrtONJGep40U,471
+langchain/_api/deprecation.py,sha256=GuafNmTTzxJ8eveGcVrPx9pmeu1Oe_d2cTrvOIZYuvo,1082
 langchain/_api/interactive_env.py,sha256=NlnXizhm1TG3l_qKNI0qHJiHkh9q2jRjt5zGJsg_BCA,139
 langchain/_api/module_import.py,sha256=q6UZ1WadWx7curQq8HV8nGwt9WmKd7tJ0mipUyG7ll0,6347
 langchain/_api/path.py,sha256=ovJP6Pcf7L_KaKvMMet9G9OzfLTb-sZV2pEw3Tp7o3I,122
 langchain/adapters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 langchain/adapters/openai.py,sha256=kWvS_DdRtpcc49vDY8zLUo3BrtXA3a89bLJu3Sksvaw,1996
 langchain/agents/__init__.py,sha256=JQJ3VlqRMRpHbjR-pkzy1yowJkdEmsQEPXTptkyHc-o,6282
-langchain/agents/agent.py,sha256=OyOGrmxzZ2Cirn3hB74P5Jen1o1Lcnat0pHtYHcuRT0,62383
+langchain/agents/agent.py,sha256=-DP3U47kQGphkOYYcXDS8k90xOTkR3hCMLZ1mE_RAgE,62216
 langchain/agents/agent_iterator.py,sha256=Zr0aikktn-aotTvoaVGJxXIBIkHidIQGkfQIKvovkxg,16454
 langchain/agents/agent_toolkits/__init__.py,sha256=N0ylx2gzwaOqaoHRXQs9jvYNIzrnTM-2rgjNkCU5UII,7370
 langchain/agents/agent_toolkits/ainetwork/__init__.py,sha256=henfKntuAEjG1KoN-Hk1IHy3fFGCYPWLEuZtF2bIdZI,25
@@ -74,19 +74,19 @@ langchain/agents/agent_toolkits/sql/toolkit.py,sha256=CCVWRJKVuECq-eFRjatJjYsy81
 langchain/agents/agent_toolkits/steam/__init__.py,sha256=iOMgxWCt0FTNLMNq0wScgSN_YdBBq-56VM6j0Ud8GpI,21
 langchain/agents/agent_toolkits/steam/toolkit.py,sha256=V0_xpO4mC4rfWBaLyTPW-pKwd-EScTTUnvgtB1sW6Cw,659
 langchain/agents/agent_toolkits/vectorstore/__init__.py,sha256=uT5qVHjIcx3yFkWfxOzbRKL5xwWcMuFGQ-es9O7b2NQ,56
-langchain/agents/agent_toolkits/vectorstore/base.py,sha256=lnzst1sehVH8FExMPF8Q1TFg9BROmfp5uHRzE2LB7Mo,8462
+langchain/agents/agent_toolkits/vectorstore/base.py,sha256=nahqycVjELCoK8psm49wf3pXmxyNaJUM8FJ5dH8GmXw,9122
 langchain/agents/agent_toolkits/vectorstore/prompt.py,sha256=DndLnLxi9iKjuYKo5E1nscHCOPeCoNcpl8dFHcSltxU,834
 langchain/agents/agent_toolkits/vectorstore/toolkit.py,sha256=dJhQ-0bfPOSliIFickPnJ40iefUPUyL3uV2pVaYP4pA,3210
 langchain/agents/agent_toolkits/xorbits/__init__.py,sha256=LJ-yZ3UKg4vjibzbgMXocR03vcsU_7ZvU7TlScM9RlE,1095
 langchain/agents/agent_toolkits/zapier/__init__.py,sha256=19Hc7HG8DzQfg83qqEbYiXA5FklLoRAEOfIs9JqTjX8,22
 langchain/agents/agent_toolkits/zapier/toolkit.py,sha256=BcFOzvckA9ZBz8HTeWUPFc_eIeifE3fIGE5RBSb7Yls,670
-langchain/agents/agent_types.py,sha256=6OjV-ZClMEaSqjAnv-7wUBG-gEGhhmjp_VsfKR8QWmQ,1943
+langchain/agents/agent_types.py,sha256=b6WCaXUAXi6CK9vDaKRgGaOM5VIiUI7I5pHEdO2lRCM,1893
 langchain/agents/chat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-langchain/agents/chat/base.py,sha256=m1HPKGB-W-pVNioqX1l1QF6pC8BS_skiJoa1uurHPfo,6509
+langchain/agents/chat/base.py,sha256=AfUJZB-zsj9sSQ0HK1CiHYODPcZJlEygw-KaVAZCK3s,6590
 langchain/agents/chat/output_parser.py,sha256=0GRXvbNl18xqfSVHzA614pxVBuentIn--vC_QjFctoA,2367
 langchain/agents/chat/prompt.py,sha256=4Ub4oZyIKmJRpWwxOyGcYwlyoK8jJ0kR60jW0lPspC8,1158
 langchain/agents/conversational/__init__.py,sha256=TnMfDzoRzR-xCiR6ph3tn3H7OPbBPpuTsFuqkLMzjiA,75
-langchain/agents/conversational/base.py,sha256=K9E4iWsFnyeOqZTgbSp8ncHnRhvtbY5YaTaXf4LINtc,6237
+langchain/agents/conversational/base.py,sha256=2raEsfYQ5kw0voUSUF09UjJuSWRgkCYkXvGxznxS7hw,6318
 langchain/agents/conversational/output_parser.py,sha256=OXFq_96ASiAVgz-Ra0UYO_ZxAIDSWaAWEKrXQlHIgVc,1610
 langchain/agents/conversational/prompt.py,sha256=6eiZYQT9liZQr30wAhoqP_2Unph7i-qSqTWqfqdMijI,1859
 langchain/agents/conversational_chat/__init__.py,sha256=TnMfDzoRzR-xCiR6ph3tn3H7OPbBPpuTsFuqkLMzjiA,75
@@ -100,14 +100,14 @@ langchain/agents/format_scratchpad/openai_functions.py,sha256=LtIroeeK_SQaxx3yAt
 langchain/agents/format_scratchpad/openai_tools.py,sha256=vyBEqvIZ5HCradWWg0weg4bj9R3nr-CpGZqvSua9HnE,166
 langchain/agents/format_scratchpad/tools.py,sha256=nyp_Z9sTnS6FLXSUfAEeZUxhpXcBLck52kdSz0Kas7I,1932
 langchain/agents/format_scratchpad/xml.py,sha256=DtMBd2-Rgi2LdfxXNImYYNcCEy5lxk8ix7-SSCOpWQY,578
-langchain/agents/initialize.py,sha256=7X-pR92W2sruOYlnJJnos4EmtaR0g_ZHSPAc510V_go,3629
+langchain/agents/initialize.py,sha256=n2mWPXV_ZyTbmUVq4yLSP4prOvXQbFBCau-7doGprGQ,3574
 langchain/agents/json_chat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 langchain/agents/json_chat/base.py,sha256=V4jl4Vt_WxTotmSw8Py4rQU9GMnhHpXYC5x-wtRinxg,7994
 langchain/agents/json_chat/prompt.py,sha256=gZukOH50C1llQ-AB2QvtL-PSrczv-a-gJLIPYP8z6vA,551
 langchain/agents/load_tools.py,sha256=uMi1EZtkv2sgyUw6iXMNlCSZlIaju0Rw2svwMtkeW3E,286
 langchain/agents/loading.py,sha256=WRE-hsYnjnv1QPW91Sh9GNIJmVzcMOB-8b6YgmSwqmA,4814
 langchain/agents/mrkl/__init__.py,sha256=Gpz8w88wAF4GSXoGnuYOwZY5rhjFL5WGZvTVQa-YJas,86
-langchain/agents/mrkl/base.py,sha256=GnWny1MWbfms9b3tF18nyuejzC5NHwDxJbXQBsXxrSw,7046
+langchain/agents/mrkl/base.py,sha256=yonYGfgMkTixmrknWROMjwjddiUCgmWEkfIaWVlJdAU,7177
 langchain/agents/mrkl/output_parser.py,sha256=YQGSjQq5pR4kFUg1HrOS3laV6xgtHgtIOQ_TtJY0UFI,3720
 langchain/agents/mrkl/prompt.py,sha256=2dTMP2lAWiLvCtuEijgQRjbKDlbPEnmx77duMwdJ7e4,641
 langchain/agents/openai_assistant/__init__.py,sha256=Xssaqoxrix3hn1gKSOLmDRQzTxAoJk0ProGXmXQe8Mw,114
@@ -130,7 +130,7 @@ langchain/agents/output_parsers/tools.py,sha256=go3kYKW406Wi8tR8Oqy6YGD26Ab-9PHQ
 langchain/agents/output_parsers/xml.py,sha256=2MjxW4nAM4sZN-in3K40_K5DBx6cI2Erb0TZbpSoZIY,1658
 langchain/agents/react/__init__.py,sha256=9RIjjaUDfWnoMEMpV57JQ0CwZZC5Soh357QdKpVIM-4,76
 langchain/agents/react/agent.py,sha256=TWjUeto0zrhf3YtKZ9NoM-kfOu4VR0ircrST_8HLAaM,5568
-langchain/agents/react/base.py,sha256=Rypd4p-ew5vGePBjo7vNVcxrcLEHn1D9_YZFKPWEXrA,5773
+langchain/agents/react/base.py,sha256=26burAhSYnELPwiOCcz24VMSslJm0TlZDiiUbbR6Nv4,6038
 langchain/agents/react/output_parser.py,sha256=bEL3U3mxYGK7_7Lm4GlOq8JKQTgyHFQQIEVUUZjV1qs,1231
 langchain/agents/react/textworld_prompt.py,sha256=b9WDM8pFmqrfAWJ8n6zkxlPlxQI5oHljZ1R9g5y6cRE,1906
 langchain/agents/react/wiki_prompt.py,sha256=iQxqKo5IjsP9manfQwf5sz038Hv_hZH_CMWHtAZYKNM,6127
@@ -327,7 +327,7 @@ langchain/chains/router/__init__.py,sha256=r66J28FWIORVB5QIZ1d8R_HsiBaV1eQMZDZvM
 langchain/chains/router/base.py,sha256=ws6i8C4nk7YWmBqkXBcJ-FybNx4OeDJE-L1IELLK3M4,4517
 langchain/chains/router/embedding_router.py,sha256=hR5hOuwBdMBo_U3lo9SSwBfnVACR0ZpNc-nmDpei5hw,3069
 langchain/chains/router/llm_router.py,sha256=6FQUTXvZ9pekVkPeTNvQsj1jD9JdmfpMkxIPMe4oTMU,6994
-langchain/chains/router/multi_prompt.py,sha256=pqBIW8fLH6esLd9uiuGS5aJeXuuPTQcv7jaOHU8YhSE,4887
+langchain/chains/router/multi_prompt.py,sha256=lLpJsYShzRBnvwtV3AaBbUcB8x6sK1PSxqDveCSC65A,6994
 langchain/chains/router/multi_prompt_prompt.py,sha256=T8UbIuxblnI6Byhw-BMAzwQcbB5ww3N6BiMqMJxS6Jc,1156
 langchain/chains/router/multi_retrieval_prompt.py,sha256=VUYGLWbwGiv03aSMW5sjdGNwsEa9FKgq0RcK5o3lkH4,1079
 langchain/chains/router/multi_retrieval_qa.py,sha256=tjIhHEbOwtF3CLq0qQ8Kd78ao5BXRKZLsm9UlmHrdtQ,4254
@@ -360,7 +360,7 @@ langchain/chat_models/azure_openai.py,sha256=aRNol2PNC49PmvdZnwjhQeMFRDOOelPNAXz
 langchain/chat_models/azureml_endpoint.py,sha256=6mxXm8UFXataLp0NYRGA88V3DpiNKPo095u_JGj7XGE,863
 langchain/chat_models/baichuan.py,sha256=3-GveFoF5ZNyLdRNK6V4i3EDDjdseOTFWbCMhDbtO9w,643
 langchain/chat_models/baidu_qianfan_endpoint.py,sha256=CZrX2SMpbE9H7wBXNC6rGvw-YqQl9zjuJrClYQxEzuI,715
-langchain/chat_models/base.py,sha256=9LDM93_1-pEV_kRbCebXmZdnWLsoepp2M_J6u6YGXbk,32221
+langchain/chat_models/base.py,sha256=DL0OTo4ro35oyrVLGzRcce5bF34k32C788mUZ4lFEcE,32616
 langchain/chat_models/bedrock.py,sha256=HRV3T_0mEnZ8LvJJqAA_UVpt-_03G715oIgomRJw55M,757
 langchain/chat_models/cohere.py,sha256=EYOECHX-nKRhZVfCfmFGZ2lr51PzaB5OvOEqmBCu1fI,633
 langchain/chat_models/databricks.py,sha256=5_QkC5lG4OldaHC2FS0XylirJouyZx1YT95SKwc12M0,653
@@ -572,12 +572,12 @@ langchain/document_transformers/long_context_reorder.py,sha256=uRPWoCzkRvS-rp6L3
 langchain/document_transformers/nuclia_text_transform.py,sha256=IIg8LuX116M_PrnqQE7RwN_gy45BBs1UTONtujFEMeU,678
 langchain/document_transformers/openai_functions.py,sha256=UfhBLrya4MRRNWofT87qRKcZI27J8UjZTX9gn005jEA,929
 langchain/document_transformers/xsl/html_chunks_with_headers.xslt,sha256=ti9sT_zWqZQf0aaeX5zT6tfHT1CuUpAVCvzoZWutE0o,6033
-langchain/embeddings/__init__.py,sha256=-DhjrerMIQyCaktSOsGqkf5lWc8zqpWZGunxDdkd-6w,8313
+langchain/embeddings/__init__.py,sha256=9f7XVRZhOkU1ME7ZV-ODihjMYrEN32EP2kGdXoCRDHI,8390
 langchain/embeddings/aleph_alpha.py,sha256=_yTqGDHsHbh83Zp0MjJ497ilIxkEJm5ccmxOWbJJay4,890
 langchain/embeddings/awa.py,sha256=1cnMiwKKU3ml3Zz5s5WIpcZSlYNVFFGCaeJilrxN8HE,626
 langchain/embeddings/azure_openai.py,sha256=tmICp-NOrxoVFENBy4F_0-c0l3znf8bOtBBo-UZhajg,650
 langchain/embeddings/baidu_qianfan_endpoint.py,sha256=w7BeE53d7o9Y8Xf0cZntmmziih7oBJcmF-jBW70KJlc,662
-langchain/embeddings/base.py,sha256=1f9mAt3_kGWFWZVrt2H_6VXzPdbe8910YtJYKoYmoJs,113
+langchain/embeddings/base.py,sha256=YOZ4S2qmbnJ889P3mzvSD_2uQdr3a-U5QMhHIXU8Fo0,7385
 langchain/embeddings/bedrock.py,sha256=tCBm3vcN0B21Ga6KvNwhgJpgjobC2VEcmPApUmwXO4E,638
 langchain/embeddings/bookend.py,sha256=qWaQXZw9Gq11kEdfIO71h1H0NaXqVKm45TiStxd2xaM,638
 langchain/embeddings/cache.py,sha256=69qxrvD4S5gtQvzv72a4sP9cES-KE3fH908C1XRDIDI,10187
@@ -901,7 +901,7 @@ langchain/retrievers/re_phraser.py,sha256=5H2CAhUNl95wLY2IZf155hlCGr_wgDq7Y1DcYq
 langchain/retrievers/remote_retriever.py,sha256=f1jPII31IkNrhkH1LvlUlNLRQNMKNvgE_7qHa3o3P04,659
 langchain/retrievers/self_query/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 langchain/retrievers/self_query/astradb.py,sha256=lxlkYOr8xicH7MNyQKIg3Wc-XwhVpKGBn7maqYyR3Hk,670
-langchain/retrievers/self_query/base.py,sha256=obiSvc-wbF3FTI1cwHZSl6CKS4m-RDcSDrgacsbKVLQ,13751
+langchain/retrievers/self_query/base.py,sha256=6HLzqmChwlM1jiXRWUPkDJMPi8-dvNJPUfsE-Aqputg,13970
 langchain/retrievers/self_query/chroma.py,sha256=F0u_3Id1J1hIYM2D8_oNL2JJVetTFDyqW6fuGhjZ0ew,665
 langchain/retrievers/self_query/dashvector.py,sha256=CJAJQuJYNmw_GUIwwlPx3Scu1uDESTnFF-CzZEwFRRg,685
 langchain/retrievers/self_query/databricks_vector_search.py,sha256=S9V-XRfG6taeW3yRx_NZs4h-R4TiyHLnuJTIZa5rsqM,782
@@ -1335,8 +1335,8 @@ langchain/vectorstores/xata.py,sha256=HW_Oi5Hz8rH2JaUhRNWQ-3hLYmNzD8eAz6K5YqPArm
 langchain/vectorstores/yellowbrick.py,sha256=-lnjGcRE8Q1nEPOTdbKYTw5noS2cy2ce1ePOU804-_o,624
 langchain/vectorstores/zep.py,sha256=RJ2auxoA6uHHLEZknw3_jeFmYJYVt-PWKMBcNMGV6TM,798
 langchain/vectorstores/zilliz.py,sha256=XhPPIUfKPFJw0_svCoBgCnNkkBLoRVVcyuMfOnE5IxU,609
-langchain-0.3.8.dist-info/LICENSE,sha256=TsZ-TKbmch26hJssqCJhWXyGph7iFLvyFBYAa3stBHg,1067
-langchain-0.3.8.dist-info/METADATA,sha256=ppLVCXbqfVMXsuKkeLbxThC7VSxWU5kwV5Li-z_uOeY,7077
-langchain-0.3.8.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
-langchain-0.3.8.dist-info/entry_points.txt,sha256=IgKjoXnkkVC8Nm7ggiFMCNAk01ua6RVTb9cmZTVNm5w,58
-langchain-0.3.8.dist-info/RECORD,,
+langchain-0.3.10.dist-info/LICENSE,sha256=TsZ-TKbmch26hJssqCJhWXyGph7iFLvyFBYAa3stBHg,1067
+langchain-0.3.10.dist-info/METADATA,sha256=P5V_UT3Cp3vgRhV8lYufDJquT0X09f0J-UoJ_dFGxPA,7129
+langchain-0.3.10.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+langchain-0.3.10.dist-info/entry_points.txt,sha256=IgKjoXnkkVC8Nm7ggiFMCNAk01ua6RVTb9cmZTVNm5w,58
+langchain-0.3.10.dist-info/RECORD,,

{langchain-0.3.8.dist-info → langchain-0.3.10.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 1.8.1
+Generator: poetry-core 1.9.1
 Root-Is-Purelib: true
 Tag: py3-none-any