langchain 0.3.27__py3-none-any.whl → 1.0.0__py3-none-any.whl

langchain/__init__.py

@@ -1,453 +1,3 @@
-"""Main entrypoint into package."""
+"""Main entrypoint into LangChain."""
 
-import warnings
-from importlib import metadata
-from typing import Any, Optional
-
-from langchain_core._api.deprecation import surface_langchain_deprecation_warnings
-
-try:
-    __version__ = metadata.version(__package__)
-except metadata.PackageNotFoundError:
-    # Case where package metadata is not available.
-    __version__ = ""
-del metadata  # optional, avoids polluting the results of dir(__package__)
-
-
-def _warn_on_import(name: str, replacement: Optional[str] = None) -> None:
-    """Warn on import of deprecated module."""
-    from langchain._api.interactive_env import is_interactive_env
-
-    if is_interactive_env():
-        # No warnings for interactive environments.
-        # This is done to avoid polluting the output of interactive environments
-        # where users rely on auto-complete and may trigger this warning
-        # even if they are not using any deprecated modules
-        return
-
-    if replacement:
-        warnings.warn(
-            f"Importing {name} from langchain root module is no longer supported. "
-            f"Please use {replacement} instead.",
-            stacklevel=3,
-        )
-    else:
-        warnings.warn(
-            f"Importing {name} from langchain root module is no longer supported.",
-            stacklevel=3,
-        )
-
-
-# Surfaces Deprecation and Pending Deprecation warnings from langchain.
-surface_langchain_deprecation_warnings()
-
-
-def __getattr__(name: str) -> Any:
-    if name == "MRKLChain":
-        from langchain.agents import MRKLChain
-
-        _warn_on_import(name, replacement="langchain.agents.MRKLChain")
-
-        return MRKLChain
-    if name == "ReActChain":
-        from langchain.agents import ReActChain
-
-        _warn_on_import(name, replacement="langchain.agents.ReActChain")
-
-        return ReActChain
-    if name == "SelfAskWithSearchChain":
-        from langchain.agents import SelfAskWithSearchChain
-
-        _warn_on_import(name, replacement="langchain.agents.SelfAskWithSearchChain")
-
-        return SelfAskWithSearchChain
-    if name == "ConversationChain":
-        from langchain.chains import ConversationChain
-
-        _warn_on_import(name, replacement="langchain.chains.ConversationChain")
-
-        return ConversationChain
-    if name == "LLMBashChain":
-        msg = (
-            "This module has been moved to langchain-experimental. "
-            "For more details: "
-            "https://github.com/langchain-ai/langchain/discussions/11352."
-            "To access this code, install it with `pip install langchain-experimental`."
-            "`from langchain_experimental.llm_bash.base "
-            "import LLMBashChain`"
-        )
-        raise ImportError(msg)
-
-    if name == "LLMChain":
-        from langchain.chains import LLMChain
-
-        _warn_on_import(name, replacement="langchain.chains.LLMChain")
-
-        return LLMChain
-    if name == "LLMCheckerChain":
-        from langchain.chains import LLMCheckerChain
-
-        _warn_on_import(name, replacement="langchain.chains.LLMCheckerChain")
-
-        return LLMCheckerChain
-    if name == "LLMMathChain":
-        from langchain.chains import LLMMathChain
-
-        _warn_on_import(name, replacement="langchain.chains.LLMMathChain")
-
-        return LLMMathChain
-    if name == "QAWithSourcesChain":
-        from langchain.chains import QAWithSourcesChain
-
-        _warn_on_import(name, replacement="langchain.chains.QAWithSourcesChain")
-
-        return QAWithSourcesChain
-    if name == "VectorDBQA":
-        from langchain.chains import VectorDBQA
-
-        _warn_on_import(name, replacement="langchain.chains.VectorDBQA")
-
-        return VectorDBQA
-    if name == "VectorDBQAWithSourcesChain":
-        from langchain.chains import VectorDBQAWithSourcesChain
-
-        _warn_on_import(name, replacement="langchain.chains.VectorDBQAWithSourcesChain")
-
-        return VectorDBQAWithSourcesChain
-    if name == "InMemoryDocstore":
-        from langchain_community.docstore import InMemoryDocstore
-
-        _warn_on_import(name, replacement="langchain.docstore.InMemoryDocstore")
-
-        return InMemoryDocstore
-    if name == "Wikipedia":
-        from langchain_community.docstore import Wikipedia
-
-        _warn_on_import(name, replacement="langchain.docstore.Wikipedia")
-
-        return Wikipedia
-    if name == "Anthropic":
-        from langchain_community.llms import Anthropic
-
-        _warn_on_import(name, replacement="langchain_community.llms.Anthropic")
-
-        return Anthropic
-    if name == "Banana":
-        from langchain_community.llms import Banana
-
-        _warn_on_import(name, replacement="langchain_community.llms.Banana")
-
-        return Banana
-    if name == "CerebriumAI":
-        from langchain_community.llms import CerebriumAI
-
-        _warn_on_import(name, replacement="langchain_community.llms.CerebriumAI")
-
-        return CerebriumAI
-    if name == "Cohere":
-        from langchain_community.llms import Cohere
-
-        _warn_on_import(name, replacement="langchain_community.llms.Cohere")
-
-        return Cohere
-    if name == "ForefrontAI":
-        from langchain_community.llms import ForefrontAI
-
-        _warn_on_import(name, replacement="langchain_community.llms.ForefrontAI")
-
-        return ForefrontAI
-    if name == "GooseAI":
-        from langchain_community.llms import GooseAI
-
-        _warn_on_import(name, replacement="langchain_community.llms.GooseAI")
-
-        return GooseAI
-    if name == "HuggingFaceHub":
-        from langchain_community.llms import HuggingFaceHub
-
-        _warn_on_import(name, replacement="langchain_community.llms.HuggingFaceHub")
-
-        return HuggingFaceHub
-    if name == "HuggingFaceTextGenInference":
-        from langchain_community.llms import HuggingFaceTextGenInference
-
-        _warn_on_import(
-            name,
-            replacement="langchain_community.llms.HuggingFaceTextGenInference",
-        )
-
-        return HuggingFaceTextGenInference
-    if name == "LlamaCpp":
-        from langchain_community.llms import LlamaCpp
-
-        _warn_on_import(name, replacement="langchain_community.llms.LlamaCpp")
-
-        return LlamaCpp
-    if name == "Modal":
-        from langchain_community.llms import Modal
-
-        _warn_on_import(name, replacement="langchain_community.llms.Modal")
-
-        return Modal
-    if name == "OpenAI":
-        from langchain_community.llms import OpenAI
-
-        _warn_on_import(name, replacement="langchain_community.llms.OpenAI")
-
-        return OpenAI
-    if name == "Petals":
-        from langchain_community.llms import Petals
-
-        _warn_on_import(name, replacement="langchain_community.llms.Petals")
-
-        return Petals
-    if name == "PipelineAI":
-        from langchain_community.llms import PipelineAI
-
-        _warn_on_import(name, replacement="langchain_community.llms.PipelineAI")
-
-        return PipelineAI
-    if name == "SagemakerEndpoint":
-        from langchain_community.llms import SagemakerEndpoint
-
-        _warn_on_import(name, replacement="langchain_community.llms.SagemakerEndpoint")
-
-        return SagemakerEndpoint
-    if name == "StochasticAI":
-        from langchain_community.llms import StochasticAI
-
-        _warn_on_import(name, replacement="langchain_community.llms.StochasticAI")
-
-        return StochasticAI
-    if name == "Writer":
-        from langchain_community.llms import Writer
-
-        _warn_on_import(name, replacement="langchain_community.llms.Writer")
-
-        return Writer
-    if name == "HuggingFacePipeline":
-        from langchain_community.llms.huggingface_pipeline import HuggingFacePipeline
-
-        _warn_on_import(
-            name,
-            replacement="langchain_community.llms.huggingface_pipeline.HuggingFacePipeline",
-        )
-
-        return HuggingFacePipeline
-    if name == "FewShotPromptTemplate":
-        from langchain_core.prompts import FewShotPromptTemplate
-
-        _warn_on_import(
-            name,
-            replacement="langchain_core.prompts.FewShotPromptTemplate",
-        )
-
-        return FewShotPromptTemplate
-    if name == "Prompt":
-        from langchain_core.prompts import PromptTemplate
-
-        _warn_on_import(name, replacement="langchain_core.prompts.PromptTemplate")
-
-        # it's renamed as prompt template anyways
-        # this is just for backwards compat
-        return PromptTemplate
-    if name == "PromptTemplate":
-        from langchain_core.prompts import PromptTemplate
-
-        _warn_on_import(name, replacement="langchain_core.prompts.PromptTemplate")
-
-        return PromptTemplate
-    if name == "BasePromptTemplate":
-        from langchain_core.prompts import BasePromptTemplate
-
-        _warn_on_import(name, replacement="langchain_core.prompts.BasePromptTemplate")
-
-        return BasePromptTemplate
-    if name == "ArxivAPIWrapper":
-        from langchain_community.utilities import ArxivAPIWrapper
-
-        _warn_on_import(
-            name,
-            replacement="langchain_community.utilities.ArxivAPIWrapper",
-        )
-
-        return ArxivAPIWrapper
-    if name == "GoldenQueryAPIWrapper":
-        from langchain_community.utilities import GoldenQueryAPIWrapper
-
-        _warn_on_import(
-            name,
-            replacement="langchain_community.utilities.GoldenQueryAPIWrapper",
-        )
-
-        return GoldenQueryAPIWrapper
-    if name == "GoogleSearchAPIWrapper":
-        from langchain_community.utilities import GoogleSearchAPIWrapper
-
-        _warn_on_import(
-            name,
-            replacement="langchain_community.utilities.GoogleSearchAPIWrapper",
-        )
-
-        return GoogleSearchAPIWrapper
-    if name == "GoogleSerperAPIWrapper":
-        from langchain_community.utilities import GoogleSerperAPIWrapper
-
-        _warn_on_import(
-            name,
-            replacement="langchain_community.utilities.GoogleSerperAPIWrapper",
-        )
-
-        return GoogleSerperAPIWrapper
-    if name == "PowerBIDataset":
-        from langchain_community.utilities import PowerBIDataset
-
-        _warn_on_import(
-            name,
-            replacement="langchain_community.utilities.PowerBIDataset",
-        )
-
-        return PowerBIDataset
-    if name == "SearxSearchWrapper":
-        from langchain_community.utilities import SearxSearchWrapper
-
-        _warn_on_import(
-            name,
-            replacement="langchain_community.utilities.SearxSearchWrapper",
-        )
-
-        return SearxSearchWrapper
-    if name == "WikipediaAPIWrapper":
-        from langchain_community.utilities import WikipediaAPIWrapper
-
-        _warn_on_import(
-            name,
-            replacement="langchain_community.utilities.WikipediaAPIWrapper",
-        )
-
-        return WikipediaAPIWrapper
-    if name == "WolframAlphaAPIWrapper":
-        from langchain_community.utilities import WolframAlphaAPIWrapper
-
-        _warn_on_import(
-            name,
-            replacement="langchain_community.utilities.WolframAlphaAPIWrapper",
-        )
-
-        return WolframAlphaAPIWrapper
-    if name == "SQLDatabase":
-        from langchain_community.utilities import SQLDatabase
-
-        _warn_on_import(name, replacement="langchain_community.utilities.SQLDatabase")
-
-        return SQLDatabase
-    if name == "FAISS":
-        from langchain_community.vectorstores import FAISS
-
-        _warn_on_import(name, replacement="langchain_community.vectorstores.FAISS")
-
-        return FAISS
-    if name == "ElasticVectorSearch":
-        from langchain_community.vectorstores import ElasticVectorSearch
-
-        _warn_on_import(
-            name,
-            replacement="langchain_community.vectorstores.ElasticVectorSearch",
-        )
-
-        return ElasticVectorSearch
-    # For backwards compatibility
-    if name in {"SerpAPIChain", "SerpAPIWrapper"}:
-        from langchain_community.utilities import SerpAPIWrapper
-
-        _warn_on_import(
-            name,
-            replacement="langchain_community.utilities.SerpAPIWrapper",
-        )
-
-        return SerpAPIWrapper
-    if name == "verbose":
-        from langchain.globals import _verbose
-
-        _warn_on_import(
-            name,
-            replacement=(
-                "langchain.globals.set_verbose() / langchain.globals.get_verbose()"
-            ),
-        )
-
-        return _verbose
-    if name == "debug":
-        from langchain.globals import _debug
-
-        _warn_on_import(
-            name,
-            replacement=(
-                "langchain.globals.set_debug() / langchain.globals.get_debug()"
-            ),
-        )
-
-        return _debug
-    if name == "llm_cache":
-        from langchain.globals import _llm_cache
-
-        _warn_on_import(
-            name,
-            replacement=(
-                "langchain.globals.set_llm_cache() / langchain.globals.get_llm_cache()"
-            ),
-        )
-
-        return _llm_cache
-    msg = f"Could not find: {name}"
-    raise AttributeError(msg)
-
-
-__all__ = [
-    "FAISS",
-    "Anthropic",
-    "ArxivAPIWrapper",
-    "Banana",
-    "BasePromptTemplate",
-    "CerebriumAI",
-    "Cohere",
-    "ConversationChain",
-    "ElasticVectorSearch",
-    "FewShotPromptTemplate",
-    "ForefrontAI",
-    "GoldenQueryAPIWrapper",
-    "GoogleSearchAPIWrapper",
-    "GoogleSerperAPIWrapper",
-    "GooseAI",
-    "HuggingFaceHub",
-    "HuggingFacePipeline",
-    "HuggingFaceTextGenInference",
-    "InMemoryDocstore",
-    "LLMChain",
-    "LLMCheckerChain",
-    "LLMMathChain",
-    "LlamaCpp",
-    "MRKLChain",
-    "Modal",
-    "OpenAI",
-    "Petals",
-    "PipelineAI",
-    "PowerBIDataset",
-    "Prompt",
-    "PromptTemplate",
-    "QAWithSourcesChain",
-    "ReActChain",
-    "SQLDatabase",
-    "SagemakerEndpoint",
-    "SearxSearchWrapper",
-    "SelfAskWithSearchChain",
-    "SerpAPIChain",
-    "SerpAPIWrapper",
-    "StochasticAI",
-    "VectorDBQA",
-    "VectorDBQAWithSourcesChain",
-    "Wikipedia",
-    "WikipediaAPIWrapper",
-    "WolframAlphaAPIWrapper",
-    "Writer",
-]
+__version__ = "1.0.0"

langchain/agents/__init__.py

@@ -1,184 +1,15 @@
-"""
-**Agent** is a class that uses an LLM to choose a sequence of actions to take.
-
-In Chains, a sequence of actions is hardcoded. In Agents,
-a language model is used as a reasoning engine to determine which actions
-to take and in which order.
-
-Agents select and use **Tools** and **Toolkits** for actions.
-
-**Class hierarchy:**
-
-.. code-block::
-
-    BaseSingleActionAgent --> LLMSingleActionAgent
-                              OpenAIFunctionsAgent
-                              XMLAgent
-                              Agent --> <name>Agent  # Examples: ZeroShotAgent, ChatAgent
-
-
-    BaseMultiActionAgent  --> OpenAIMultiFunctionsAgent
-
-
-**Main helpers:**
-
-.. code-block::
-
-    AgentType, AgentExecutor, AgentOutputParser, AgentExecutorIterator,
-    AgentAction, AgentFinish
+"""Entrypoint to building [Agents](https://docs.langchain.com/oss/python/langchain/agents) with LangChain.
 
+!!! warning "Reference docs"
+    This page contains **reference documentation** for Agents. See
+    [the docs](https://docs.langchain.com/oss/python/langchain/agents) for conceptual
+    guides, tutorials, and examples on using Agents.
 """  # noqa: E501
 
-from pathlib import Path
-from typing import TYPE_CHECKING, Any
-
-from langchain_core._api.path import as_import_path
-from langchain_core.tools import Tool
-from langchain_core.tools.convert import tool
-
-from langchain._api import create_importer
-from langchain.agents.agent import (
-    Agent,
-    AgentExecutor,
-    AgentOutputParser,
-    BaseMultiActionAgent,
-    BaseSingleActionAgent,
-    LLMSingleActionAgent,
-)
-from langchain.agents.agent_iterator import AgentExecutorIterator
-from langchain.agents.agent_toolkits.vectorstore.base import (
-    create_vectorstore_agent,
-    create_vectorstore_router_agent,
-)
-from langchain.agents.agent_types import AgentType
-from langchain.agents.conversational.base import ConversationalAgent
-from langchain.agents.conversational_chat.base import ConversationalChatAgent
-from langchain.agents.initialize import initialize_agent
-from langchain.agents.json_chat.base import create_json_chat_agent
-from langchain.agents.loading import load_agent
-from langchain.agents.mrkl.base import MRKLChain, ZeroShotAgent
-from langchain.agents.openai_functions_agent.base import (
-    OpenAIFunctionsAgent,
-    create_openai_functions_agent,
-)
-from langchain.agents.openai_functions_multi_agent.base import OpenAIMultiFunctionsAgent
-from langchain.agents.openai_tools.base import create_openai_tools_agent
-from langchain.agents.react.agent import create_react_agent
-from langchain.agents.react.base import ReActChain, ReActTextWorldAgent
-from langchain.agents.self_ask_with_search.base import (
-    SelfAskWithSearchChain,
-    create_self_ask_with_search_agent,
-)
-from langchain.agents.structured_chat.base import (
-    StructuredChatAgent,
-    create_structured_chat_agent,
-)
-from langchain.agents.tool_calling_agent.base import create_tool_calling_agent
-from langchain.agents.xml.base import XMLAgent, create_xml_agent
-
-if TYPE_CHECKING:
-    from langchain_community.agent_toolkits.json.base import create_json_agent
-    from langchain_community.agent_toolkits.load_tools import (
-        get_all_tool_names,
-        load_huggingface_tool,
-        load_tools,
-    )
-    from langchain_community.agent_toolkits.openapi.base import create_openapi_agent
-    from langchain_community.agent_toolkits.powerbi.base import create_pbi_agent
-    from langchain_community.agent_toolkits.powerbi.chat_base import (
-        create_pbi_chat_agent,
-    )
-    from langchain_community.agent_toolkits.spark_sql.base import create_spark_sql_agent
-    from langchain_community.agent_toolkits.sql.base import create_sql_agent
-
-DEPRECATED_CODE = [
-    "create_csv_agent",
-    "create_pandas_dataframe_agent",
-    "create_spark_dataframe_agent",
-    "create_xorbits_agent",
-]
-
-# Create a way to dynamically look up deprecated imports.
-# Used to consolidate logic for raising deprecation warnings and
-# handling optional imports.
-DEPRECATED_LOOKUP = {
-    "create_json_agent": "langchain_community.agent_toolkits.json.base",
-    "create_openapi_agent": "langchain_community.agent_toolkits.openapi.base",
-    "create_pbi_agent": "langchain_community.agent_toolkits.powerbi.base",
-    "create_pbi_chat_agent": "langchain_community.agent_toolkits.powerbi.chat_base",
-    "create_spark_sql_agent": "langchain_community.agent_toolkits.spark_sql.base",
-    "create_sql_agent": "langchain_community.agent_toolkits.sql.base",
-    "load_tools": "langchain_community.agent_toolkits.load_tools",
-    "load_huggingface_tool": "langchain_community.agent_toolkits.load_tools",
-    "get_all_tool_names": "langchain_community.agent_toolkits.load_tools",
-}
-
-_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
-
-
-def __getattr__(name: str) -> Any:
-    """Get attr name."""
-    if name in DEPRECATED_CODE:
-        # Get directory of langchain package
-        HERE = Path(__file__).parents[1]
-        relative_path = as_import_path(
-            Path(__file__).parent,
-            suffix=name,
-            relative_to=HERE,
-        )
-        old_path = "langchain." + relative_path
-        new_path = "langchain_experimental." + relative_path
-        msg = (
-            f"{name} has been moved to langchain experimental. "
-            "See https://github.com/langchain-ai/langchain/discussions/11680"
-            "for more information.\n"
-            f"Please update your import statement from: `{old_path}` to `{new_path}`."
-        )
-        raise ImportError(msg)
-    return _import_attribute(name)
-
+from langchain.agents.factory import create_agent
+from langchain.agents.middleware.types import AgentState
 
 __all__ = [
-    "Agent",
-    "AgentExecutor",
-    "AgentExecutorIterator",
-    "AgentOutputParser",
-    "AgentType",
-    "BaseMultiActionAgent",
-    "BaseSingleActionAgent",
-    "ConversationalAgent",
-    "ConversationalChatAgent",
-    "LLMSingleActionAgent",
-    "MRKLChain",
-    "OpenAIFunctionsAgent",
-    "OpenAIMultiFunctionsAgent",
-    "ReActChain",
-    "ReActTextWorldAgent",
-    "SelfAskWithSearchChain",
-    "StructuredChatAgent",
-    "Tool",
-    "XMLAgent",
-    "ZeroShotAgent",
-    "create_json_agent",
-    "create_json_chat_agent",
-    "create_openai_functions_agent",
-    "create_openai_tools_agent",
-    "create_openapi_agent",
-    "create_pbi_agent",
-    "create_pbi_chat_agent",
-    "create_react_agent",
-    "create_self_ask_with_search_agent",
-    "create_spark_sql_agent",
-    "create_sql_agent",
-    "create_structured_chat_agent",
-    "create_tool_calling_agent",
-    "create_vectorstore_agent",
-    "create_vectorstore_router_agent",
-    "create_xml_agent",
-    "get_all_tool_names",
-    "initialize_agent",
-    "load_agent",
-    "load_huggingface_tool",
-    "load_tools",
-    "tool",
+    "AgentState",
+    "create_agent",
 ]