Download core/agents/runner/tool_manager.py from Kyrlos11/nniback: direct link, hf CLI and curl.
- Browser
- Download file 12.2 kB
-
https://huggingface.co/spaces/Kyrlos11/nniback/resolve/main/core/agents/runner/tool_manager.py
- Command line
-
hf download hf://spaces/Kyrlos11/nniback/core/agents/runner/tool_manager.py
-
curl -L -o tool_manager.py https://huggingface.co/spaces/Kyrlos11/nniback/resolve/main/core/agents/runner/tool_manager.py
12.2 kB
| import time | |
| from typing import Optional, List, Set | |
| from core.tools.message_tool import MessageTool | |
| from core.tools.web_search_tool import SandboxWebSearchTool | |
| from core.tools.image_search_tool import SandboxImageSearchTool | |
| from core.tools.expand_msg_tool import ExpandMessageTool | |
| from core.tools.task_list_tool import TaskListTool | |
| from core.agentpress.thread_manager import ThreadManager | |
| from core.utils.config import config | |
| from core.utils.logger import logger | |
| # Default core tools - can be overridden by agent config | |
| DEFAULT_CORE_TOOLS = [ | |
| 'expand_msg_tool', # Always needed for tool loading | |
| 'message_tool', # Always needed for user communication | |
| 'task_list_tool', # Task management | |
| 'web_search_tool', # Web search | |
| 'image_search_tool', # Image search | |
| 'browser_tool', # Web browsing | |
| 'sb_shell_tool', # Shell commands | |
| 'sb_git_sync', # Git operations | |
| 'sb_files_tool', # File operations | |
| 'sb_file_reader_tool', # File reading | |
| 'sb_vision_tool', # Image understanding | |
| 'sb_image_edit_tool', # Image generation | |
| 'sb_upload_file_tool', # File uploads | |
| 'sb_expose_tool', # Port exposure | |
| 'sb_kb_tool', # Knowledge base operations | |
| 'composio_upload_tool', # Composio S3 uploads for email attachments | |
| 'agent_config_tool', | |
| 'agent_creation_tool', | |
| 'mcp_search_tool', | |
| 'credential_profile_tool', | |
| 'trigger_tool', | |
| ] | |
| class ToolManager: | |
| """ | |
| Manages tool registration for agent threads. | |
| Tools are registered based on agent config AND user tier: | |
| - Core tools (preloaded): Registered at startup if enabled in config | |
| - On-demand tools: Loaded via initialize_tools() when needed | |
| - Tier restrictions: Some tools disabled for free tier users | |
| Agent config structure: | |
| { | |
| "agentpress_tools": { | |
| "web_search_tool": true, # enabled | |
| "sb_presentation_tool": false, # disabled | |
| "browser_tool": {"enabled": true} # enabled with config | |
| } | |
| } | |
| """ | |
| def __init__(self, thread_manager: ThreadManager, project_id: str, thread_id: str, agent_config: Optional[dict] = None): | |
| self.thread_manager = thread_manager | |
| self.project_id = project_id | |
| self.thread_id = thread_id | |
| self.agent_config = agent_config | |
| self.disabled_tools = self._get_disabled_tools() | |
| def _get_disabled_tools(self) -> Set[str]: | |
| """Get set of disabled tools from agent config. | |
| Note: Tier-based tool restrictions are now handled at execution time | |
| in tool_executor.py via check_tool_access_for_account(). This allows | |
| the agent to see all tools but get a proper upgrade CTA when blocked. | |
| """ | |
| disabled = set() | |
| # Get agent config disabled tools (NOT tier-based - that's handled at execution time) | |
| if self.agent_config and 'agentpress_tools' in self.agent_config: | |
| raw_tools = self.agent_config.get('agentpress_tools', {}) | |
| if isinstance(raw_tools, dict): | |
| # For default Suna agent with no explicit config, only use tier restrictions | |
| if not (self.agent_config.get('is_suna_default', False) and not raw_tools): | |
| for tool_name, tool_config in raw_tools.items(): | |
| if isinstance(tool_config, bool) and not tool_config: | |
| disabled.add(tool_name) | |
| elif isinstance(tool_config, dict) and not tool_config.get('enabled', True): | |
| disabled.add(tool_name) | |
| if disabled: | |
| logger.info(f"Total disabled tools: {disabled}") | |
| return disabled | |
| def _is_tool_enabled(self, tool_name: str) -> bool: | |
| """Check if a tool is enabled based on agent config.""" | |
| return tool_name not in self.disabled_tools | |
| def register_core_tools(self): | |
| """Register core tools that are enabled in agent config.""" | |
| start = time.time() | |
| self.migrated_tools = self._get_migrated_tools_config() | |
| self._register_enabled_core_tools() | |
| total = (time.time() - start) * 1000 | |
| tool_count = len(self.thread_manager.tool_registry.tools) | |
| logger.info(f"✅ Registered {tool_count} core tool functions in {total:.1f}ms") | |
| def _register_enabled_core_tools(self): | |
| """Register core tools that are enabled.""" | |
| from core.tools.tool_registry import get_tool_info, get_tool_class | |
| # These are ALWAYS loaded (required for agent operation) | |
| self.thread_manager.add_tool(ExpandMessageTool, thread_id=self.thread_id, thread_manager=self.thread_manager) | |
| self.thread_manager.add_tool(MessageTool) | |
| self.thread_manager.add_tool(TaskListTool, project_id=self.project_id, thread_manager=self.thread_manager, thread_id=self.thread_id) | |
| # Search tools (if API keys configured AND enabled in config) | |
| if (config.TAVILY_API_KEY or config.FIRECRAWL_API_KEY) and self._is_tool_enabled('web_search_tool'): | |
| enabled_methods = self._get_enabled_methods_for_tool('web_search_tool') | |
| self.thread_manager.add_tool(SandboxWebSearchTool, function_names=enabled_methods, thread_manager=self.thread_manager, project_id=self.project_id) | |
| if config.SERPER_API_KEY and self._is_tool_enabled('image_search_tool'): | |
| enabled_methods = self._get_enabled_methods_for_tool('image_search_tool') | |
| self.thread_manager.add_tool(SandboxImageSearchTool, function_names=enabled_methods, thread_manager=self.thread_manager, project_id=self.project_id) | |
| # Browser tool | |
| if self._is_tool_enabled('browser_tool'): | |
| from core.tools.browser_tool import BrowserTool | |
| enabled_methods = self._get_enabled_methods_for_tool('browser_tool') | |
| self.thread_manager.add_tool( | |
| BrowserTool, | |
| function_names=enabled_methods, | |
| project_id=self.project_id, | |
| thread_id=self.thread_id, | |
| thread_manager=self.thread_manager | |
| ) | |
| # Core sandbox tools - only register if enabled | |
| core_sandbox_tools = [ | |
| 'sb_shell_tool', | |
| 'sb_git_sync', | |
| 'sb_files_tool', | |
| 'sb_file_reader_tool', | |
| 'sb_vision_tool', | |
| 'sb_image_edit_tool', | |
| 'sb_upload_file_tool', | |
| 'sb_expose_tool', | |
| 'sb_kb_tool', # Knowledge base operations | |
| 'composio_upload_tool', # Composio S3 uploads for email attachments | |
| ] | |
| tools_needing_thread_id = {'sb_vision_tool', 'sb_image_edit_tool', 'sb_design_tool'} | |
| for tool_name in core_sandbox_tools: | |
| if not self._is_tool_enabled(tool_name): | |
| logger.debug(f"Skipping disabled tool: {tool_name}") | |
| continue | |
| tool_info = get_tool_info(tool_name) | |
| if tool_info: | |
| _, module_path, class_name = tool_info | |
| try: | |
| tool_class = get_tool_class(module_path, class_name) | |
| kwargs = { | |
| 'project_id': self.project_id, | |
| 'thread_manager': self.thread_manager | |
| } | |
| if tool_name in tools_needing_thread_id: | |
| kwargs['thread_id'] = self.thread_id | |
| enabled_methods = self._get_enabled_methods_for_tool(tool_name) | |
| self.thread_manager.add_tool(tool_class, function_names=enabled_methods, **kwargs) | |
| except (ImportError, AttributeError) as e: | |
| logger.warning(f"Failed to load core tool {tool_name}: {e}") | |
| self._register_agent_builder_tools() | |
| def _register_agent_builder_tools(self): | |
| from core.tools.tool_registry import get_tool_info, get_tool_class | |
| # Tools that need agent_id | |
| agent_id_tools = [ | |
| 'agent_config_tool', | |
| 'mcp_search_tool', | |
| 'credential_profile_tool', | |
| 'trigger_tool', | |
| ] | |
| # Tools that need account_id | |
| account_id_tools = [ | |
| 'agent_creation_tool', | |
| ] | |
| agent_id = self.agent_config.get('agent_id') if self.agent_config else None | |
| # Get account_id from thread_manager (it's not in agent_config) | |
| account_id = getattr(self.thread_manager, 'account_id', None) | |
| db_connection = getattr(self.thread_manager, 'db', None) | |
| logger.info(f"🔧 Registering agent builder tools (agent_id={agent_id}, account_id={account_id}, has_db={db_connection is not None})") | |
| for tool_name in agent_id_tools: | |
| if not self._is_tool_enabled(tool_name): | |
| logger.debug(f"Skipping disabled agent builder tool: {tool_name}") | |
| continue | |
| tool_info = get_tool_info(tool_name) | |
| if tool_info: | |
| _, module_path, class_name = tool_info | |
| try: | |
| tool_class = get_tool_class(module_path, class_name) | |
| enabled_methods = self._get_enabled_methods_for_tool(tool_name) | |
| self.thread_manager.add_tool( | |
| tool_class, | |
| function_names=enabled_methods, | |
| thread_manager=self.thread_manager, | |
| db_connection=db_connection, | |
| agent_id=agent_id | |
| ) | |
| logger.info(f"✅ Registered agent builder tool: {tool_name}") | |
| except (ImportError, AttributeError) as e: | |
| logger.warning(f"Failed to load agent builder tool {tool_name}: {e}") | |
| except Exception as e: | |
| logger.warning(f"Failed to register agent builder tool {tool_name}: {e}") | |
| # Register tools that need account_id | |
| for tool_name in account_id_tools: | |
| if not self._is_tool_enabled(tool_name): | |
| logger.debug(f"Skipping disabled agent builder tool: {tool_name}") | |
| continue | |
| tool_info = get_tool_info(tool_name) | |
| if tool_info: | |
| _, module_path, class_name = tool_info | |
| try: | |
| tool_class = get_tool_class(module_path, class_name) | |
| enabled_methods = self._get_enabled_methods_for_tool(tool_name) | |
| self.thread_manager.add_tool( | |
| tool_class, | |
| function_names=enabled_methods, | |
| thread_manager=self.thread_manager, | |
| db_connection=db_connection, | |
| account_id=account_id | |
| ) | |
| logger.info(f"✅ Registered agent builder tool: {tool_name}") | |
| except (ImportError, AttributeError) as e: | |
| logger.warning(f"Failed to load agent builder tool {tool_name}: {e}") | |
| except Exception as e: | |
| logger.warning(f"Failed to register agent builder tool {tool_name}: {e}") | |
| def _get_migrated_tools_config(self) -> dict: | |
| if not self.agent_config or 'agentpress_tools' not in self.agent_config: | |
| return {} | |
| from core.utils.tool_migration import migrate_legacy_tool_config | |
| raw_tools = self.agent_config['agentpress_tools'] | |
| if not isinstance(raw_tools, dict): | |
| return {} | |
| return migrate_legacy_tool_config(raw_tools) | |
| def _get_enabled_methods_for_tool(self, tool_name: str) -> Optional[List[str]]: | |
| """Get list of enabled methods for a tool based on agent config.""" | |
| if not hasattr(self, 'migrated_tools') or not self.migrated_tools: | |
| return None | |
| from core.utils.tool_discovery import get_enabled_methods_for_tool | |
| return get_enabled_methods_for_tool(tool_name, self.migrated_tools) | |