feat: modernize langchain integration social tools

langchain_apify/__init__.py

@@ -1,19 +1,84 @@
+from __future__ import annotations
+
 from importlib import metadata
+from typing import TYPE_CHECKING
 
+from langchain_apify._actor_tools import (
+    ApifyFacebookPostsScraperTool,
+    ApifyInstagramScraperTool,
+    ApifyLinkedInProfileDetailTool,
+    ApifyLinkedInProfilePostsTool,
+    ApifyLinkedInProfileSearchTool,
+    ApifyTikTokScraperTool,
+    ApifyTwitterScraperTool,
+)
 from langchain_apify.document_loaders import ApifyDatasetLoader
-from langchain_apify.tools import ApifyActorsTool
+from langchain_apify.tools import (
+    ApifyActorsTool,
+    ApifyGetDatasetItemsTool,
+    ApifyRunActorAndGetDatasetTool,
+    ApifyRunActorTool,
+    ApifyRunTaskAndGetDatasetTool,
+    ApifyRunTaskTool,
+    ApifyScrapeUrlTool,
+)
 from langchain_apify.wrappers import ApifyWrapper
 
+if TYPE_CHECKING:
+    from langchain_core.tools import BaseTool
+
 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__)
 
+# Convenience tool-class lists for selective agent binding.
+# Binding all tools at once overwhelms the LLM context window;
+# pick the group(s) relevant to your use case.
+
+APIFY_CORE_TOOLS: list[type[BaseTool]] = [
+    ApifyRunActorTool,
+    ApifyGetDatasetItemsTool,
+    ApifyRunActorAndGetDatasetTool,
+    ApifyScrapeUrlTool,
+    ApifyRunTaskTool,
+    ApifyRunTaskAndGetDatasetTool,
+]
+
+APIFY_SOCIAL_TOOLS: list[type[BaseTool]] = [
+    ApifyInstagramScraperTool,
+    ApifyLinkedInProfilePostsTool,
+    ApifyLinkedInProfileSearchTool,
+    ApifyLinkedInProfileDetailTool,
+    ApifyTwitterScraperTool,
+    ApifyTikTokScraperTool,
+    ApifyFacebookPostsScraperTool,
+]
+
 __all__ = [
+    # Existing components (backward-compatible)
     'ApifyActorsTool',
     'ApifyDatasetLoader',
     'ApifyWrapper',
+    # Core generic tools
+    'ApifyGetDatasetItemsTool',
+    'ApifyRunActorAndGetDatasetTool',
+    'ApifyRunActorTool',
+    'ApifyRunTaskAndGetDatasetTool',
+    'ApifyRunTaskTool',
+    'ApifyScrapeUrlTool',
+    # Social media Actor tools
+    'ApifyFacebookPostsScraperTool',
+    'ApifyInstagramScraperTool',
+    'ApifyLinkedInProfileDetailTool',
+    'ApifyLinkedInProfilePostsTool',
+    'ApifyLinkedInProfileSearchTool',
+    'ApifyTikTokScraperTool',
+    'ApifyTwitterScraperTool',
+    # Tool group lists
+    'APIFY_CORE_TOOLS',
+    'APIFY_SOCIAL_TOOLS',
+    # Meta
     '__version__',
 ]