langchain[patch]: Migrate agents module into optional imports for community (#21088)

libs/langchain/langchain/agents/__init__.py

@@ -29,19 +29,12 @@ Agents select and use **Tools** and **Toolkits** for actions.
     
 """  # noqa: E501
 from pathlib import Path
-from typing import Any
+from typing import TYPE_CHECKING, Any
 
-from langchain_community.agent_toolkits import (
-    create_json_agent,
-    create_openapi_agent,
-    create_pbi_agent,
-    create_pbi_chat_agent,
-    create_spark_sql_agent,
-    create_sql_agent,
-)
 from langchain_core._api.path import as_import_path
 from langchain_core.tools import Tool, tool
 
+from langchain._api import create_importer
 from langchain.agents.agent import (
     Agent,
     AgentExecutor,
@@ -86,6 +79,16 @@ from langchain.agents.structured_chat.base import (
 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.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",
@@ -93,6 +96,20 @@ DEPRECATED_CODE = [
     "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",
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
 
 def __getattr__(name: str) -> Any:
     """Get attr name."""
@@ -110,7 +127,7 @@ def __getattr__(name: str) -> Any:
             "for more information.\n"
             f"Please update your import statement from: `{old_path}` to `{new_path}`."
         )
-    raise AttributeError(f"{name} does not exist")
+    return _import_attribute(name)
 
 
 __all__ = [

libs/langchain/langchain/agents/agent_toolkits/__init__.py

@@ -13,13 +13,12 @@ whether permissions of the given toolkit are appropriate for the application.
 
 See [Security](https://python.langchain.com/docs/security) for more information.
 """
-import warnings
 from pathlib import Path
-from typing import Any
+from typing import TYPE_CHECKING, Any
 
-from langchain_core._api import LangChainDeprecationWarning
 from langchain_core._api.path import as_import_path
 
+from langchain._api import create_importer
 from langchain.agents.agent_toolkits.conversational_retrieval.openai_functions import (
     create_conversational_retrieval_agent,
 )
@@ -33,7 +32,41 @@ from langchain.agents.agent_toolkits.vectorstore.toolkit import (
     VectorStoreToolkit,
 )
 from langchain.tools.retriever import create_retriever_tool
-from langchain.utils.interactive_env import is_interactive_env
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.ainetwork.toolkit import AINetworkToolkit
+    from langchain_community.agent_toolkits.amadeus.toolkit import AmadeusToolkit
+    from langchain_community.agent_toolkits.azure_cognitive_services import (
+        AzureCognitiveServicesToolkit,
+    )
+    from langchain_community.agent_toolkits.file_management.toolkit import (
+        FileManagementToolkit,
+    )
+    from langchain_community.agent_toolkits.gmail.toolkit import GmailToolkit
+    from langchain_community.agent_toolkits.jira.toolkit import JiraToolkit
+    from langchain_community.agent_toolkits.json.base import create_json_agent
+    from langchain_community.agent_toolkits.json.toolkit import JsonToolkit
+    from langchain_community.agent_toolkits.multion.toolkit import MultionToolkit
+    from langchain_community.agent_toolkits.nasa.toolkit import NasaToolkit
+    from langchain_community.agent_toolkits.nla.toolkit import NLAToolkit
+    from langchain_community.agent_toolkits.office365.toolkit import O365Toolkit
+    from langchain_community.agent_toolkits.openapi.base import create_openapi_agent
+    from langchain_community.agent_toolkits.openapi.toolkit import OpenAPIToolkit
+    from langchain_community.agent_toolkits.playwright.toolkit import (
+        PlayWrightBrowserToolkit,
+    )
+    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.powerbi.toolkit import PowerBIToolkit
+    from langchain_community.agent_toolkits.slack.toolkit import SlackToolkit
+    from langchain_community.agent_toolkits.spark_sql.base import create_spark_sql_agent
+    from langchain_community.agent_toolkits.spark_sql.toolkit import SparkSQLToolkit
+    from langchain_community.agent_toolkits.sql.base import create_sql_agent
+    from langchain_community.agent_toolkits.sql.toolkit import SQLDatabaseToolkit
+    from langchain_community.agent_toolkits.steam.toolkit import SteamToolkit
+    from langchain_community.agent_toolkits.zapier.toolkit import ZapierToolkit
 
 DEPRECATED_AGENTS = [
     "create_csv_agent",
@@ -43,6 +76,43 @@ DEPRECATED_AGENTS = [
     "create_spark_dataframe_agent",
 ]
 
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {
+    "AINetworkToolkit": "langchain_community.agent_toolkits.ainetwork.toolkit",
+    "AmadeusToolkit": "langchain_community.agent_toolkits.amadeus.toolkit",
+    "AzureCognitiveServicesToolkit": (
+        "langchain_community.agent_toolkits.azure_cognitive_services"
+    ),
+    "FileManagementToolkit": (
+        "langchain_community.agent_toolkits.file_management.toolkit"
+    ),
+    "GmailToolkit": "langchain_community.agent_toolkits.gmail.toolkit",
+    "JiraToolkit": "langchain_community.agent_toolkits.jira.toolkit",
+    "JsonToolkit": "langchain_community.agent_toolkits.json.toolkit",
+    "MultionToolkit": "langchain_community.agent_toolkits.multion.toolkit",
+    "NasaToolkit": "langchain_community.agent_toolkits.nasa.toolkit",
+    "NLAToolkit": "langchain_community.agent_toolkits.nla.toolkit",
+    "O365Toolkit": "langchain_community.agent_toolkits.office365.toolkit",
+    "OpenAPIToolkit": "langchain_community.agent_toolkits.openapi.toolkit",
+    "PlayWrightBrowserToolkit": "langchain_community.agent_toolkits.playwright.toolkit",
+    "PowerBIToolkit": "langchain_community.agent_toolkits.powerbi.toolkit",
+    "SlackToolkit": "langchain_community.agent_toolkits.slack.toolkit",
+    "SteamToolkit": "langchain_community.agent_toolkits.steam.toolkit",
+    "SQLDatabaseToolkit": "langchain_community.agent_toolkits.sql.toolkit",
+    "SparkSQLToolkit": "langchain_community.agent_toolkits.spark_sql.toolkit",
+    "ZapierToolkit": "langchain_community.agent_toolkits.zapier.toolkit",
+    "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",
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
 
 def __getattr__(name: str) -> Any:
     """Get attr name."""
@@ -56,21 +126,7 @@ def __getattr__(name: str) -> Any:
             "for more information.\n"
             f"Please update your import statement from: `{old_path}` to `{new_path}`."
         )
-
+    return _import_attribute(name)
-    from langchain_community import agent_toolkits
-
-    # If not in interactive env, raise warning.
-    if not is_interactive_env():
-        warnings.warn(
-            "Importing this agent toolkit from langchain is deprecated. Importing it "
-            "from langchain will no longer be supported as of langchain==0.2.0. "
-            "Please import from langchain-community instead:\n\n"
-            f"`from langchain_community.agent_toolkits import {name}`.\n\n"
-            "To install langchain-community run `pip install -U langchain-community`.",
-            category=LangChainDeprecationWarning,
-        )
-
-    return getattr(agent_toolkits, name)
 
 
 __all__ = [

libs/langchain/langchain/agents/agent_toolkits/ainetwork/toolkit.py

@@ -1,3 +1,25 @@
-from langchain_community.agent_toolkits.ainetwork.toolkit import AINetworkToolkit
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["AINetworkToolkit"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.ainetwork.toolkit import AINetworkToolkit
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {
+    "AINetworkToolkit": "langchain_community.agent_toolkits.ainetwork.toolkit"
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "AINetworkToolkit",
+]

libs/langchain/langchain/agents/agent_toolkits/azure_cognitive_services.py

@@ -1,5 +1,29 @@
-from langchain_community.agent_toolkits.azure_cognitive_services import (
+from typing import TYPE_CHECKING, Any
-    AzureCognitiveServicesToolkit,
-)
 
-__all__ = ["AzureCognitiveServicesToolkit"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.azure_cognitive_services import (
+        AzureCognitiveServicesToolkit,
+    )
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {
+    "AzureCognitiveServicesToolkit": (
+        "langchain_community.agent_toolkits.azure_cognitive_services"
+    )
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "AzureCognitiveServicesToolkit",
+]

libs/langchain/langchain/agents/agent_toolkits/clickup/toolkit.py

@@ -1,3 +1,25 @@
-from langchain_community.agent_toolkits.clickup.toolkit import ClickupToolkit
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["ClickupToolkit"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.clickup.toolkit import ClickupToolkit
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {
+    "ClickupToolkit": "langchain_community.agent_toolkits.clickup.toolkit"
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "ClickupToolkit",
+]

libs/langchain/langchain/agents/agent_toolkits/file_management/__init__.py

@@ -1,7 +1,30 @@
 """Local file management toolkit."""
+from typing import TYPE_CHECKING, Any
 
-from langchain_community.agent_toolkits.file_management.toolkit import (
+from langchain._api import create_importer
-    FileManagementToolkit,
-)
 
-__all__ = ["FileManagementToolkit"]
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.file_management.toolkit import (
+        FileManagementToolkit,
+    )
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {
+    "FileManagementToolkit": (
+        "langchain_community.agent_toolkits.file_management.toolkit"
+    )
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "FileManagementToolkit",
+]

libs/langchain/langchain/agents/agent_toolkits/file_management/toolkit.py

@@ -1,5 +1,29 @@
-from langchain_community.agent_toolkits.file_management.toolkit import (
+from typing import TYPE_CHECKING, Any
-    FileManagementToolkit,
-)
 
-__all__ = ["FileManagementToolkit"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.file_management.toolkit import (
+        FileManagementToolkit,
+    )
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {
+    "FileManagementToolkit": (
+        "langchain_community.agent_toolkits.file_management.toolkit"
+    )
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "FileManagementToolkit",
+]

libs/langchain/langchain/agents/agent_toolkits/github/toolkit.py

@@ -1,20 +1,54 @@
-from langchain_community.agent_toolkits.github.toolkit import (
+from typing import TYPE_CHECKING, Any
-    BranchName,
+
-    CommentOnIssue,
+from langchain._api import create_importer
-    CreateFile,
+
-    CreatePR,
+if TYPE_CHECKING:
-    CreateReviewRequest,
+    from langchain_community.agent_toolkits.github.toolkit import (
-    DeleteFile,
+        BranchName,
-    DirectoryPath,
+        CommentOnIssue,
-    GetIssue,
+        CreateFile,
-    GetPR,
+        CreatePR,
-    GitHubToolkit,
+        CreateReviewRequest,
-    NoInput,
+        DeleteFile,
-    ReadFile,
+        DirectoryPath,
-    SearchCode,
+        GetIssue,
-    SearchIssuesAndPRs,
+        GetPR,
-    UpdateFile,
+        GitHubToolkit,
-)
+        NoInput,
+        ReadFile,
+        SearchCode,
+        SearchIssuesAndPRs,
+        UpdateFile,
+    )
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {
+    "NoInput": "langchain_community.agent_toolkits.github.toolkit",
+    "GetIssue": "langchain_community.agent_toolkits.github.toolkit",
+    "CommentOnIssue": "langchain_community.agent_toolkits.github.toolkit",
+    "GetPR": "langchain_community.agent_toolkits.github.toolkit",
+    "CreatePR": "langchain_community.agent_toolkits.github.toolkit",
+    "CreateFile": "langchain_community.agent_toolkits.github.toolkit",
+    "ReadFile": "langchain_community.agent_toolkits.github.toolkit",
+    "UpdateFile": "langchain_community.agent_toolkits.github.toolkit",
+    "DeleteFile": "langchain_community.agent_toolkits.github.toolkit",
+    "DirectoryPath": "langchain_community.agent_toolkits.github.toolkit",
+    "BranchName": "langchain_community.agent_toolkits.github.toolkit",
+    "SearchCode": "langchain_community.agent_toolkits.github.toolkit",
+    "CreateReviewRequest": "langchain_community.agent_toolkits.github.toolkit",
+    "SearchIssuesAndPRs": "langchain_community.agent_toolkits.github.toolkit",
+    "GitHubToolkit": "langchain_community.agent_toolkits.github.toolkit",
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
 
 __all__ = [
     "NoInput",

libs/langchain/langchain/agents/agent_toolkits/gitlab/toolkit.py

@@ -1,3 +1,25 @@
-from langchain_community.agent_toolkits.gitlab.toolkit import GitLabToolkit
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["GitLabToolkit"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.gitlab.toolkit import GitLabToolkit
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {
+    "GitLabToolkit": "langchain_community.agent_toolkits.gitlab.toolkit"
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "GitLabToolkit",
+]

libs/langchain/langchain/agents/agent_toolkits/gmail/toolkit.py

@@ -1,3 +1,23 @@
-from langchain_community.agent_toolkits.gmail.toolkit import SCOPES, GmailToolkit
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["SCOPES", "GmailToolkit"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.gmail.toolkit import GmailToolkit
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {"GmailToolkit": "langchain_community.agent_toolkits.gmail.toolkit"}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "GmailToolkit",
+]

libs/langchain/langchain/agents/agent_toolkits/jira/toolkit.py

@@ -1,3 +1,23 @@
-from langchain_community.agent_toolkits.jira.toolkit import JiraToolkit
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["JiraToolkit"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.jira.toolkit import JiraToolkit
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {"JiraToolkit": "langchain_community.agent_toolkits.jira.toolkit"}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "JiraToolkit",
+]

libs/langchain/langchain/agents/agent_toolkits/json/base.py

@@ -1,3 +1,25 @@
-from langchain_community.agent_toolkits.json.base import create_json_agent
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["create_json_agent"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.json.base import create_json_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"
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "create_json_agent",
+]

libs/langchain/langchain/agents/agent_toolkits/json/toolkit.py

@@ -1,3 +1,23 @@
-from langchain_community.agent_toolkits.json.toolkit import JsonToolkit
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["JsonToolkit"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.json.toolkit import JsonToolkit
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {"JsonToolkit": "langchain_community.agent_toolkits.json.toolkit"}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "JsonToolkit",
+]

libs/langchain/langchain/agents/agent_toolkits/multion/toolkit.py

@@ -1,3 +1,25 @@
-from langchain_community.agent_toolkits.multion.toolkit import MultionToolkit
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["MultionToolkit"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.multion.toolkit import MultionToolkit
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {
+    "MultionToolkit": "langchain_community.agent_toolkits.multion.toolkit"
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "MultionToolkit",
+]

libs/langchain/langchain/agents/agent_toolkits/nasa/toolkit.py

@@ -1,3 +1,23 @@
-from langchain_community.agent_toolkits.nasa.toolkit import NasaToolkit
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["NasaToolkit"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.nasa.toolkit import NasaToolkit
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {"NasaToolkit": "langchain_community.agent_toolkits.nasa.toolkit"}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "NasaToolkit",
+]

libs/langchain/langchain/agents/agent_toolkits/nla/tool.py

@@ -1,3 +1,23 @@
-from langchain_community.agent_toolkits.nla.tool import NLATool
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["NLATool"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.nla.tool import NLATool
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {"NLATool": "langchain_community.agent_toolkits.nla.tool"}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "NLATool",
+]

libs/langchain/langchain/agents/agent_toolkits/nla/toolkit.py

@@ -1,3 +1,23 @@
-from langchain_community.agent_toolkits.nla.toolkit import NLAToolkit
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["NLAToolkit"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.nla.toolkit import NLAToolkit
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {"NLAToolkit": "langchain_community.agent_toolkits.nla.toolkit"}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "NLAToolkit",
+]

libs/langchain/langchain/agents/agent_toolkits/office365/toolkit.py

@@ -1,3 +1,25 @@
-from langchain_community.agent_toolkits.office365.toolkit import O365Toolkit
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["O365Toolkit"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.office365.toolkit import O365Toolkit
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {
+    "O365Toolkit": "langchain_community.agent_toolkits.office365.toolkit"
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "O365Toolkit",
+]

libs/langchain/langchain/agents/agent_toolkits/openapi/base.py

@@ -1,3 +1,25 @@
-from langchain_community.agent_toolkits.openapi.base import create_openapi_agent
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["create_openapi_agent"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.openapi.base import create_openapi_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_openapi_agent": "langchain_community.agent_toolkits.openapi.base"
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "create_openapi_agent",
+]

libs/langchain/langchain/agents/agent_toolkits/openapi/planner.py

@@ -1,15 +1,48 @@
-from langchain_community.agent_toolkits.openapi.planner import (
+from typing import TYPE_CHECKING, Any
-    MAX_RESPONSE_LENGTH,
+
-    RequestsDeleteToolWithParsing,
+from langchain._api import create_importer
-    RequestsGetToolWithParsing,
+
-    RequestsPatchToolWithParsing,
+if TYPE_CHECKING:
-    RequestsPostToolWithParsing,
+    from langchain_community.agent_toolkits.openapi.planner import (
-    RequestsPutToolWithParsing,
+        RequestsDeleteToolWithParsing,
-    create_openapi_agent,
+        RequestsGetToolWithParsing,
-)
+        RequestsPatchToolWithParsing,
+        RequestsPostToolWithParsing,
+        RequestsPutToolWithParsing,
+        create_openapi_agent,
+    )
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {
+    "RequestsGetToolWithParsing": (
+        "langchain_community.agent_toolkits.openapi.planner"
+    ),
+    "RequestsPostToolWithParsing": (
+        "langchain_community.agent_toolkits.openapi.planner"
+    ),
+    "RequestsPatchToolWithParsing": (
+        "langchain_community.agent_toolkits.openapi.planner"
+    ),
+    "RequestsPutToolWithParsing": (
+        "langchain_community.agent_toolkits.openapi.planner"
+    ),
+    "RequestsDeleteToolWithParsing": (
+        "langchain_community.agent_toolkits.openapi.planner"
+    ),
+    "create_openapi_agent": "langchain_community.agent_toolkits.openapi.planner",
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
 
 __all__ = [
-    "MAX_RESPONSE_LENGTH",
     "RequestsGetToolWithParsing",
     "RequestsPostToolWithParsing",
     "RequestsPatchToolWithParsing",

libs/langchain/langchain/agents/agent_toolkits/openapi/spec.py

@@ -1,6 +1,30 @@
-from langchain_community.agent_toolkits.openapi.spec import (
+from typing import TYPE_CHECKING, Any
-    ReducedOpenAPISpec,
-    reduce_openapi_spec,
-)
 
-__all__ = ["ReducedOpenAPISpec", "reduce_openapi_spec"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.openapi.spec import (
+        ReducedOpenAPISpec,
+        reduce_openapi_spec,
+    )
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {
+    "ReducedOpenAPISpec": "langchain_community.agent_toolkits.openapi.spec",
+    "reduce_openapi_spec": "langchain_community.agent_toolkits.openapi.spec",
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "ReducedOpenAPISpec",
+    "reduce_openapi_spec",
+]

libs/langchain/langchain/agents/agent_toolkits/openapi/toolkit.py

@@ -1,6 +1,30 @@
-from langchain_community.agent_toolkits.openapi.toolkit import (
+from typing import TYPE_CHECKING, Any
-    OpenAPIToolkit,
-    RequestsToolkit,
-)
 
-__all__ = ["RequestsToolkit", "OpenAPIToolkit"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.openapi.toolkit import (
+        OpenAPIToolkit,
+        RequestsToolkit,
+    )
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {
+    "RequestsToolkit": "langchain_community.agent_toolkits.openapi.toolkit",
+    "OpenAPIToolkit": "langchain_community.agent_toolkits.openapi.toolkit",
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "RequestsToolkit",
+    "OpenAPIToolkit",
+]

libs/langchain/langchain/agents/agent_toolkits/playwright/__init__.py

@@ -1,6 +1,28 @@
 """Playwright browser toolkit."""
-from langchain_community.agent_toolkits.playwright.toolkit import (
+from typing import TYPE_CHECKING, Any
-    PlayWrightBrowserToolkit,
-)
 
-__all__ = ["PlayWrightBrowserToolkit"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.playwright.toolkit import (
+        PlayWrightBrowserToolkit,
+    )
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {
+    "PlayWrightBrowserToolkit": "langchain_community.agent_toolkits.playwright.toolkit"
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "PlayWrightBrowserToolkit",
+]

libs/langchain/langchain/agents/agent_toolkits/playwright/toolkit.py

@@ -1,5 +1,27 @@
-from langchain_community.agent_toolkits.playwright.toolkit import (
+from typing import TYPE_CHECKING, Any
-    PlayWrightBrowserToolkit,
-)
 
-__all__ = ["PlayWrightBrowserToolkit"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.playwright.toolkit import (
+        PlayWrightBrowserToolkit,
+    )
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {
+    "PlayWrightBrowserToolkit": "langchain_community.agent_toolkits.playwright.toolkit"
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "PlayWrightBrowserToolkit",
+]

libs/langchain/langchain/agents/agent_toolkits/powerbi/base.py

@@ -1,3 +1,25 @@
-from langchain_community.agent_toolkits.powerbi.base import create_pbi_agent
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["create_pbi_agent"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.powerbi.base import create_pbi_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_pbi_agent": "langchain_community.agent_toolkits.powerbi.base"
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "create_pbi_agent",
+]

libs/langchain/langchain/agents/agent_toolkits/powerbi/chat_base.py

@@ -1,3 +1,27 @@
-from langchain_community.agent_toolkits.powerbi.chat_base import create_pbi_chat_agent
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["create_pbi_chat_agent"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.powerbi.chat_base import (
+        create_pbi_chat_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_pbi_chat_agent": "langchain_community.agent_toolkits.powerbi.chat_base"
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "create_pbi_chat_agent",
+]

libs/langchain/langchain/agents/agent_toolkits/powerbi/toolkit.py

@@ -1,3 +1,25 @@
-from langchain_community.agent_toolkits.powerbi.toolkit import PowerBIToolkit
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["PowerBIToolkit"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.powerbi.toolkit import PowerBIToolkit
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {
+    "PowerBIToolkit": "langchain_community.agent_toolkits.powerbi.toolkit"
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "PowerBIToolkit",
+]

libs/langchain/langchain/agents/agent_toolkits/slack/toolkit.py

@@ -1,3 +1,23 @@
-from langchain_community.agent_toolkits.slack.toolkit import SlackToolkit
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["SlackToolkit"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.slack.toolkit import SlackToolkit
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {"SlackToolkit": "langchain_community.agent_toolkits.slack.toolkit"}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "SlackToolkit",
+]

libs/langchain/langchain/agents/agent_toolkits/spark_sql/base.py

@@ -1,3 +1,25 @@
-from langchain_community.agent_toolkits.spark_sql.base import create_spark_sql_agent
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["create_spark_sql_agent"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.spark_sql.base import create_spark_sql_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_spark_sql_agent": "langchain_community.agent_toolkits.spark_sql.base"
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "create_spark_sql_agent",
+]

libs/langchain/langchain/agents/agent_toolkits/spark_sql/toolkit.py

@@ -1,3 +1,25 @@
-from langchain_community.agent_toolkits.spark_sql.toolkit import SparkSQLToolkit
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["SparkSQLToolkit"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.spark_sql.toolkit import SparkSQLToolkit
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {
+    "SparkSQLToolkit": "langchain_community.agent_toolkits.spark_sql.toolkit"
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "SparkSQLToolkit",
+]

libs/langchain/langchain/agents/agent_toolkits/sql/base.py

@@ -1,3 +1,23 @@
-from langchain_community.agent_toolkits.sql.base import create_sql_agent
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["create_sql_agent"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.sql.base import create_sql_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_sql_agent": "langchain_community.agent_toolkits.sql.base"}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "create_sql_agent",
+]

libs/langchain/langchain/agents/agent_toolkits/sql/toolkit.py

@@ -1,3 +1,25 @@
-from langchain_community.agent_toolkits.sql.toolkit import SQLDatabaseToolkit
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["SQLDatabaseToolkit"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.sql.toolkit import SQLDatabaseToolkit
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {
+    "SQLDatabaseToolkit": "langchain_community.agent_toolkits.sql.toolkit"
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "SQLDatabaseToolkit",
+]

libs/langchain/langchain/agents/agent_toolkits/steam/toolkit.py

@@ -1,3 +1,23 @@
-from langchain_community.agent_toolkits.steam.toolkit import SteamToolkit
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["SteamToolkit"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.steam.toolkit import SteamToolkit
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {"SteamToolkit": "langchain_community.agent_toolkits.steam.toolkit"}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "SteamToolkit",
+]

libs/langchain/langchain/agents/agent_toolkits/zapier/toolkit.py

@@ -1,3 +1,25 @@
-from langchain_community.agent_toolkits.zapier.toolkit import ZapierToolkit
+from typing import TYPE_CHECKING, Any
 
-__all__ = ["ZapierToolkit"]
+from langchain._api import create_importer
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.zapier.toolkit import ZapierToolkit
+
+# Create a way to dynamically look up deprecated imports.
+# Used to consolidate logic for raising deprecation warnings and
+# handling optional imports.
+DEPRECATED_LOOKUP = {
+    "ZapierToolkit": "langchain_community.agent_toolkits.zapier.toolkit"
+}
+
+_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
+
+
+def __getattr__(name: str) -> Any:
+    """Look up attributes dynamically."""
+    return _import_attribute(name)
+
+
+__all__ = [
+    "ZapierToolkit",
+]