letta-nightly 0.8.0.dev20250606195656__py3-none-any.whl → 0.8.3.dev20250607000559__py3-none-any.whl

letta/services/tool_executor/tool_executor.py

@@ -1,720 +1,25 @@
-import asyncio
-import json
-import math
 import traceback
-from abc import ABC, abstractmethod
-from textwrap import shorten
-from typing import Any, Dict, List, Literal, Optional
+from typing import Any, Dict, Optional
 
-from letta.constants import (
-    COMPOSIO_ENTITY_ENV_VAR_KEY,
-    CORE_MEMORY_LINE_NUMBER_WARNING,
-    MCP_TOOL_TAG_NAME_PREFIX,
-    MEMORY_TOOLS_LINE_NUMBER_PREFIX_REGEX,
-    READ_ONLY_BLOCK_EDIT_ERROR,
-    RETRIEVAL_QUERY_DEFAULT_PAGE_SIZE,
-    WEB_SEARCH_CLIP_CONTENT,
-    WEB_SEARCH_INCLUDE_SCORE,
-    WEB_SEARCH_SEPARATOR,
-)
 from letta.functions.ast_parsers import coerce_dict_args_by_annotations, get_function_annotations_from_source
-from letta.functions.composio_helpers import execute_composio_action_async, generate_composio_action_from_func_name
-from letta.helpers.composio_helpers import get_composio_api_key_async
-from letta.helpers.json_helpers import json_dumps
 from letta.log import get_logger
+from letta.otel.tracing import trace_method
 from letta.schemas.agent import AgentState
-from letta.schemas.enums import MessageRole
-from letta.schemas.letta_message import AssistantMessage
-from letta.schemas.letta_message_content import TextContent
-from letta.schemas.message import MessageCreate
 from letta.schemas.sandbox_config import SandboxConfig
 from letta.schemas.tool import Tool
 from letta.schemas.tool_execution_result import ToolExecutionResult
 from letta.schemas.user import User
 from letta.services.agent_manager import AgentManager
-from letta.services.block_manager import BlockManager
-from letta.services.mcp_manager import MCPManager
-from letta.services.message_manager import MessageManager
-from letta.services.passage_manager import PassageManager
+from letta.services.tool_executor.tool_executor_base import ToolExecutor
 from letta.services.tool_sandbox.e2b_sandbox import AsyncToolSandboxE2B
 from letta.services.tool_sandbox.local_sandbox import AsyncToolSandboxLocal
 from letta.settings import tool_settings
-from letta.tracing import trace_method
 from letta.types import JsonDict
 from letta.utils import get_friendly_error_msg
 
 logger = get_logger(__name__)
 
 
-class ToolExecutor(ABC):
-    """Abstract base class for tool executors."""
-
-    def __init__(
-        self,
-        message_manager: MessageManager,
-        agent_manager: AgentManager,
-        block_manager: BlockManager,
-        passage_manager: PassageManager,
-        actor: User,
-    ):
-        self.message_manager = message_manager
-        self.agent_manager = agent_manager
-        self.block_manager = block_manager
-        self.passage_manager = passage_manager
-        self.actor = actor
-
-    @abstractmethod
-    async def execute(
-        self,
-        function_name: str,
-        function_args: dict,
-        tool: Tool,
-        actor: User,
-        agent_state: Optional[AgentState] = None,
-        sandbox_config: Optional[SandboxConfig] = None,
-        sandbox_env_vars: Optional[Dict[str, Any]] = None,
-    ) -> ToolExecutionResult:
-        """Execute the tool and return the result."""
-
-
-class LettaCoreToolExecutor(ToolExecutor):
-    """Executor for LETTA core tools with direct implementation of functions."""
-
-    async def execute(
-        self,
-        function_name: str,
-        function_args: dict,
-        tool: Tool,
-        actor: User,
-        agent_state: Optional[AgentState] = None,
-        sandbox_config: Optional[SandboxConfig] = None,
-        sandbox_env_vars: Optional[Dict[str, Any]] = None,
-    ) -> ToolExecutionResult:
-        # Map function names to method calls
-        assert agent_state is not None, "Agent state is required for core tools"
-        function_map = {
-            "send_message": self.send_message,
-            "conversation_search": self.conversation_search,
-            "archival_memory_search": self.archival_memory_search,
-            "archival_memory_insert": self.archival_memory_insert,
-            "core_memory_append": self.core_memory_append,
-            "core_memory_replace": self.core_memory_replace,
-            "memory_replace": self.memory_replace,
-            "memory_insert": self.memory_insert,
-            "memory_rethink": self.memory_rethink,
-            "memory_finish_edits": self.memory_finish_edits,
-        }
-
-        if function_name not in function_map:
-            raise ValueError(f"Unknown function: {function_name}")
-
-        # Execute the appropriate function
-        function_args_copy = function_args.copy()  # Make a copy to avoid modifying the original
-        try:
-            function_response = await function_map[function_name](agent_state, actor, **function_args_copy)
-            return ToolExecutionResult(
-                status="success",
-                func_return=function_response,
-                agent_state=agent_state,
-            )
-        except Exception as e:
-            return ToolExecutionResult(
-                status="error",
-                func_return=e,
-                agent_state=agent_state,
-                stderr=[get_friendly_error_msg(function_name=function_name, exception_name=type(e).__name__, exception_message=str(e))],
-            )
-
-    async def send_message(self, agent_state: AgentState, actor: User, message: str) -> Optional[str]:
-        """
-        Sends a message to the human user.
-
-        Args:
-            message (str): Message contents. All unicode (including emojis) are supported.
-
-        Returns:
-            Optional[str]: None is always returned as this function does not produce a response.
-        """
-        return "Sent message successfully."
-
-    async def conversation_search(self, agent_state: AgentState, actor: User, query: str, page: Optional[int] = 0) -> Optional[str]:
-        """
-        Search prior conversation history using case-insensitive string matching.
-
-        Args:
-            query (str): String to search for.
-            page (int): Allows you to page through results. Only use on a follow-up query. Defaults to 0 (first page).
-
-        Returns:
-            str: Query result string
-        """
-        if page is None or (isinstance(page, str) and page.lower().strip() == "none"):
-            page = 0
-        try:
-            page = int(page)
-        except:
-            raise ValueError(f"'page' argument must be an integer")
-
-        count = RETRIEVAL_QUERY_DEFAULT_PAGE_SIZE
-        messages = await MessageManager().list_user_messages_for_agent_async(
-            agent_id=agent_state.id,
-            actor=actor,
-            query_text=query,
-            limit=count,
-        )
-
-        total = len(messages)
-        num_pages = math.ceil(total / count) - 1  # 0 index
-
-        if len(messages) == 0:
-            results_str = f"No results found."
-        else:
-            results_pref = f"Showing {len(messages)} of {total} results (page {page}/{num_pages}):"
-            results_formatted = [message.content[0].text for message in messages]
-            results_str = f"{results_pref} {json_dumps(results_formatted)}"
-
-        return results_str
-
-    async def archival_memory_search(
-        self, agent_state: AgentState, actor: User, query: str, page: Optional[int] = 0, start: Optional[int] = 0
-    ) -> Optional[str]:
-        """
-        Search archival memory using semantic (embedding-based) search.
-
-        Args:
-            query (str): String to search for.
-            page (Optional[int]): Allows you to page through results. Only use on a follow-up query. Defaults to 0 (first page).
-            start (Optional[int]): Starting index for the search results. Defaults to 0.
-
-        Returns:
-            str: Query result string
-        """
-        if page is None or (isinstance(page, str) and page.lower().strip() == "none"):
-            page = 0
-        try:
-            page = int(page)
-        except:
-            raise ValueError(f"'page' argument must be an integer")
-
-        count = RETRIEVAL_QUERY_DEFAULT_PAGE_SIZE
-
-        try:
-            # Get results using passage manager
-            all_results = await AgentManager().list_passages_async(
-                actor=actor,
-                agent_id=agent_state.id,
-                query_text=query,
-                limit=count + start,  # Request enough results to handle offset
-                embedding_config=agent_state.embedding_config,
-                embed_query=True,
-            )
-
-            # Apply pagination
-            end = min(count + start, len(all_results))
-            paged_results = all_results[start:end]
-
-            # Format results to match previous implementation
-            formatted_results = [{"timestamp": str(result.created_at), "content": result.text} for result in paged_results]
-
-            return formatted_results, len(formatted_results)
-
-        except Exception as e:
-            raise e
-
-    async def archival_memory_insert(self, agent_state: AgentState, actor: User, content: str) -> Optional[str]:
-        """
-        Add to archival memory. Make sure to phrase the memory contents such that it can be easily queried later.
-
-        Args:
-            content (str): Content to write to the memory. All unicode (including emojis) are supported.
-
-        Returns:
-            Optional[str]: None is always returned as this function does not produce a response.
-        """
-        await PassageManager().insert_passage_async(
-            agent_state=agent_state,
-            agent_id=agent_state.id,
-            text=content,
-            actor=actor,
-        )
-        await AgentManager().rebuild_system_prompt_async(agent_id=agent_state.id, actor=actor, force=True)
-        return None
-
-    async def core_memory_append(self, agent_state: AgentState, actor: User, label: str, content: str) -> Optional[str]:
-        """
-        Append to the contents of core memory.
-
-        Args:
-            label (str): Section of the memory to be edited (persona or human).
-            content (str): Content to write to the memory. All unicode (including emojis) are supported.
-
-        Returns:
-            Optional[str]: None is always returned as this function does not produce a response.
-        """
-        if agent_state.memory.get_block(label).read_only:
-            raise ValueError(f"{READ_ONLY_BLOCK_EDIT_ERROR}")
-        current_value = str(agent_state.memory.get_block(label).value)
-        new_value = current_value + "\n" + str(content)
-        agent_state.memory.update_block_value(label=label, value=new_value)
-        await AgentManager().update_memory_if_changed_async(agent_id=agent_state.id, new_memory=agent_state.memory, actor=actor)
-        return None
-
-    async def core_memory_replace(
-        self,
-        agent_state: AgentState,
-        actor: User,
-        label: str,
-        old_content: str,
-        new_content: str,
-    ) -> Optional[str]:
-        """
-        Replace the contents of core memory. To delete memories, use an empty string for new_content.
-
-        Args:
-            label (str): Section of the memory to be edited (persona or human).
-            old_content (str): String to replace. Must be an exact match.
-            new_content (str): Content to write to the memory. All unicode (including emojis) are supported.
-
-        Returns:
-            Optional[str]: None is always returned as this function does not produce a response.
-        """
-        if agent_state.memory.get_block(label).read_only:
-            raise ValueError(f"{READ_ONLY_BLOCK_EDIT_ERROR}")
-        current_value = str(agent_state.memory.get_block(label).value)
-        if old_content not in current_value:
-            raise ValueError(f"Old content '{old_content}' not found in memory block '{label}'")
-        new_value = current_value.replace(str(old_content), str(new_content))
-        agent_state.memory.update_block_value(label=label, value=new_value)
-        await AgentManager().update_memory_if_changed_async(agent_id=agent_state.id, new_memory=agent_state.memory, actor=actor)
-        return None
-
-    async def memory_replace(
-        self,
-        agent_state: AgentState,
-        actor: User,
-        label: str,
-        old_str: str,
-        new_str: Optional[str] = None,
-    ) -> str:
-        """
-        The memory_replace command allows you to replace a specific string in a memory
-        block with a new string. This is used for making precise edits.
-
-        Args:
-            label (str): Section of the memory to be edited, identified by its label.
-            old_str (str): The text to replace (must match exactly, including whitespace
-                and indentation). Do not include line number prefixes.
-            new_str (Optional[str]): The new text to insert in place of the old text.
-                Omit this argument to delete the old_str. Do not include line number prefixes.
-
-        Returns:
-            str: The success message
-        """
-
-        if agent_state.memory.get_block(label).read_only:
-            raise ValueError(f"{READ_ONLY_BLOCK_EDIT_ERROR}")
-
-        if bool(MEMORY_TOOLS_LINE_NUMBER_PREFIX_REGEX.search(old_str)):
-            raise ValueError(
-                "old_str contains a line number prefix, which is not allowed. "
-                "Do not include line numbers when calling memory tools (line "
-                "numbers are for display purposes only)."
-            )
-        if CORE_MEMORY_LINE_NUMBER_WARNING in old_str:
-            raise ValueError(
-                "old_str contains a line number warning, which is not allowed. "
-                "Do not include line number information when calling memory tools "
-                "(line numbers are for display purposes only)."
-            )
-        if bool(MEMORY_TOOLS_LINE_NUMBER_PREFIX_REGEX.search(new_str)):
-            raise ValueError(
-                "new_str contains a line number prefix, which is not allowed. "
-                "Do not include line numbers when calling memory tools (line "
-                "numbers are for display purposes only)."
-            )
-
-        old_str = str(old_str).expandtabs()
-        new_str = str(new_str).expandtabs()
-        current_value = str(agent_state.memory.get_block(label).value).expandtabs()
-
-        # Check if old_str is unique in the block
-        occurences = current_value.count(old_str)
-        if occurences == 0:
-            raise ValueError(
-                f"No replacement was performed, old_str `{old_str}` did not appear " f"verbatim in memory block with label `{label}`."
-            )
-        elif occurences > 1:
-            content_value_lines = current_value.split("\n")
-            lines = [idx + 1 for idx, line in enumerate(content_value_lines) if old_str in line]
-            raise ValueError(
-                f"No replacement was performed. Multiple occurrences of "
-                f"old_str `{old_str}` in lines {lines}. Please ensure it is unique."
-            )
-
-        # Replace old_str with new_str
-        new_value = current_value.replace(str(old_str), str(new_str))
-
-        # Write the new content to the block
-        agent_state.memory.update_block_value(label=label, value=new_value)
-
-        await AgentManager().update_memory_if_changed_async(agent_id=agent_state.id, new_memory=agent_state.memory, actor=actor)
-
-        # Create a snippet of the edited section
-        SNIPPET_LINES = 3
-        replacement_line = current_value.split(old_str)[0].count("\n")
-        start_line = max(0, replacement_line - SNIPPET_LINES)
-        end_line = replacement_line + SNIPPET_LINES + new_str.count("\n")
-        snippet = "\n".join(new_value.split("\n")[start_line : end_line + 1])
-
-        # Prepare the success message
-        success_msg = f"The core memory block with label `{label}` has been edited. "
-        # success_msg += self._make_output(
-        #     snippet, f"a snippet of {path}", start_line + 1
-        # )
-        # success_msg += f"A snippet of core memory block `{label}`:\n{snippet}\n"
-        success_msg += (
-            "Review the changes and make sure they are as expected (correct indentation, "
-            "no duplicate lines, etc). Edit the memory block again if necessary."
-        )
-
-        # return None
-        return success_msg
-
-    async def memory_insert(
-        self,
-        agent_state: AgentState,
-        actor: User,
-        label: str,
-        new_str: str,
-        insert_line: int = -1,
-    ) -> str:
-        """
-        The memory_insert command allows you to insert text at a specific location
-        in a memory block.
-
-        Args:
-            label (str): Section of the memory to be edited, identified by its label.
-            new_str (str): The text to insert. Do not include line number prefixes.
-            insert_line (int): The line number after which to insert the text (0 for
-                beginning of file). Defaults to -1 (end of the file).
-
-        Returns:
-            str: The success message
-        """
-
-        if agent_state.memory.get_block(label).read_only:
-            raise ValueError(f"{READ_ONLY_BLOCK_EDIT_ERROR}")
-
-        if bool(MEMORY_TOOLS_LINE_NUMBER_PREFIX_REGEX.search(new_str)):
-            raise ValueError(
-                "new_str contains a line number prefix, which is not allowed. Do not "
-                "include line numbers when calling memory tools (line numbers are for "
-                "display purposes only)."
-            )
-        if CORE_MEMORY_LINE_NUMBER_WARNING in new_str:
-            raise ValueError(
-                "new_str contains a line number warning, which is not allowed. Do not "
-                "include line number information when calling memory tools (line numbers "
-                "are for display purposes only)."
-            )
-
-        current_value = str(agent_state.memory.get_block(label).value).expandtabs()
-        new_str = str(new_str).expandtabs()
-        current_value_lines = current_value.split("\n")
-        n_lines = len(current_value_lines)
-
-        # Check if we're in range, from 0 (pre-line), to 1 (first line), to n_lines (last line)
-        if insert_line == -1:
-            insert_line = n_lines
-        elif insert_line < 0 or insert_line > n_lines:
-            raise ValueError(
-                f"Invalid `insert_line` parameter: {insert_line}. It should be within "
-                f"the range of lines of the memory block: {[0, n_lines]}, or -1 to "
-                f"append to the end of the memory block."
-            )
-
-        # Insert the new string as a line
-        SNIPPET_LINES = 3
-        new_str_lines = new_str.split("\n")
-        new_value_lines = current_value_lines[:insert_line] + new_str_lines + current_value_lines[insert_line:]
-        snippet_lines = (
-            current_value_lines[max(0, insert_line - SNIPPET_LINES) : insert_line]
-            + new_str_lines
-            + current_value_lines[insert_line : insert_line + SNIPPET_LINES]
-        )
-
-        # Collate into the new value to update
-        new_value = "\n".join(new_value_lines)
-        snippet = "\n".join(snippet_lines)
-
-        # Write into the block
-        agent_state.memory.update_block_value(label=label, value=new_value)
-
-        await AgentManager().update_memory_if_changed_async(agent_id=agent_state.id, new_memory=agent_state.memory, actor=actor)
-
-        # Prepare the success message
-        success_msg = f"The core memory block with label `{label}` has been edited. "
-        # success_msg += self._make_output(
-        #     snippet,
-        #     "a snippet of the edited file",
-        #     max(1, insert_line - SNIPPET_LINES + 1),
-        # )
-        # success_msg += f"A snippet of core memory block `{label}`:\n{snippet}\n"
-        success_msg += (
-            "Review the changes and make sure they are as expected (correct indentation, "
-            "no duplicate lines, etc). Edit the memory block again if necessary."
-        )
-
-        return success_msg
-
-    async def memory_rethink(self, agent_state: AgentState, actor: User, label: str, new_memory: str) -> str:
-        """
-        The memory_rethink command allows you to completely rewrite the contents of a
-        memory block. Use this tool to make large sweeping changes (e.g. when you want
-        to condense or reorganize the memory blocks), do NOT use this tool to make small
-        precise edits (e.g. add or remove a line, replace a specific string, etc).
-
-        Args:
-            label (str): The memory block to be rewritten, identified by its label.
-            new_memory (str): The new memory contents with information integrated from
-                existing memory blocks and the conversation context. Do not include line number prefixes.
-
-        Returns:
-            str: The success message
-        """
-        if agent_state.memory.get_block(label).read_only:
-            raise ValueError(f"{READ_ONLY_BLOCK_EDIT_ERROR}")
-
-        if bool(MEMORY_TOOLS_LINE_NUMBER_PREFIX_REGEX.search(new_memory)):
-            raise ValueError(
-                "new_memory contains a line number prefix, which is not allowed. Do not "
-                "include line numbers when calling memory tools (line numbers are for "
-                "display purposes only)."
-            )
-        if CORE_MEMORY_LINE_NUMBER_WARNING in new_memory:
-            raise ValueError(
-                "new_memory contains a line number warning, which is not allowed. Do not "
-                "include line number information when calling memory tools (line numbers "
-                "are for display purposes only)."
-            )
-
-        if agent_state.memory.get_block(label) is None:
-            agent_state.memory.create_block(label=label, value=new_memory)
-
-        agent_state.memory.update_block_value(label=label, value=new_memory)
-
-        await AgentManager().update_memory_if_changed_async(agent_id=agent_state.id, new_memory=agent_state.memory, actor=actor)
-
-        # Prepare the success message
-        success_msg = f"The core memory block with label `{label}` has been edited. "
-        # success_msg += self._make_output(
-        #     snippet, f"a snippet of {path}", start_line + 1
-        # )
-        # success_msg += f"A snippet of core memory block `{label}`:\n{snippet}\n"
-        success_msg += (
-            "Review the changes and make sure they are as expected (correct indentation, "
-            "no duplicate lines, etc). Edit the memory block again if necessary."
-        )
-
-        # return None
-        return success_msg
-
-    async def memory_finish_edits(self, agent_state: AgentState, actor: User) -> None:
-        """
-        Call the memory_finish_edits command when you are finished making edits
-        (integrating all new information) into the memory blocks. This function
-        is called when the agent is done rethinking the memory.
-
-        Returns:
-            Optional[str]: None is always returned as this function does not produce a response.
-        """
-        return None
-
-
-class LettaMultiAgentToolExecutor(ToolExecutor):
-    """Executor for LETTA multi-agent core tools."""
-
-    async def execute(
-        self,
-        function_name: str,
-        function_args: dict,
-        tool: Tool,
-        actor: User,
-        agent_state: Optional[AgentState] = None,
-        sandbox_config: Optional[SandboxConfig] = None,
-        sandbox_env_vars: Optional[Dict[str, Any]] = None,
-    ) -> ToolExecutionResult:
-        assert agent_state is not None, "Agent state is required for multi-agent tools"
-        function_map = {
-            "send_message_to_agent_and_wait_for_reply": self.send_message_to_agent_and_wait_for_reply,
-            "send_message_to_agent_async": self.send_message_to_agent_async,
-            "send_message_to_agents_matching_tags": self.send_message_to_agents_matching_tags_async,
-        }
-
-        if function_name not in function_map:
-            raise ValueError(f"Unknown function: {function_name}")
-
-        # Execute the appropriate function
-        function_args_copy = function_args.copy()  # Make a copy to avoid modifying the original
-        function_response = await function_map[function_name](agent_state, **function_args_copy)
-        return ToolExecutionResult(
-            status="success",
-            func_return=function_response,
-        )
-
-    async def send_message_to_agent_and_wait_for_reply(self, agent_state: AgentState, message: str, other_agent_id: str) -> str:
-        augmented_message = (
-            f"[Incoming message from agent with ID '{agent_state.id}' - to reply to this message, "
-            f"make sure to use the 'send_message' at the end, and the system will notify the sender of your response] "
-            f"{message}"
-        )
-
-        return str(await self._process_agent(agent_id=other_agent_id, message=augmented_message))
-
-    async def send_message_to_agent_async(self, agent_state: AgentState, message: str, other_agent_id: str) -> str:
-        # 1) Build the prefixed system‐message
-        prefixed = (
-            f"[Incoming message from agent with ID '{agent_state.id}' - "
-            f"to reply to this message, make sure to use the "
-            f"'send_message_to_agent_async' tool, or the agent will not receive your message] "
-            f"{message}"
-        )
-
-        task = asyncio.create_task(self._process_agent(agent_id=other_agent_id, message=prefixed))
-
-        task.add_done_callback(lambda t: (logger.error(f"Async send_message task failed: {t.exception()}") if t.exception() else None))
-
-        return "Successfully sent message"
-
-    async def send_message_to_agents_matching_tags_async(
-        self, agent_state: AgentState, message: str, match_all: List[str], match_some: List[str]
-    ) -> str:
-        # Find matching agents
-        matching_agents = await self.agent_manager.list_agents_matching_tags_async(
-            actor=self.actor, match_all=match_all, match_some=match_some
-        )
-        if not matching_agents:
-            return str([])
-
-        augmented_message = (
-            "[Incoming message from external Letta agent - to reply to this message, "
-            "make sure to use the 'send_message' at the end, and the system will notify "
-            "the sender of your response] "
-            f"{message}"
-        )
-
-        tasks = [
-            asyncio.create_task(self._process_agent(agent_id=agent_state.id, message=augmented_message)) for agent_state in matching_agents
-        ]
-        results = await asyncio.gather(*tasks)
-        return str(results)
-
-    async def _process_agent(self, agent_id: str, message: str) -> Dict[str, Any]:
-        from letta.agents.letta_agent import LettaAgent
-
-        try:
-            letta_agent = LettaAgent(
-                agent_id=agent_id,
-                message_manager=self.message_manager,
-                agent_manager=self.agent_manager,
-                block_manager=self.block_manager,
-                passage_manager=self.passage_manager,
-                actor=self.actor,
-            )
-
-            letta_response = await letta_agent.step([MessageCreate(role=MessageRole.system, content=[TextContent(text=message)])])
-            messages = letta_response.messages
-
-            send_message_content = [message.content for message in messages if isinstance(message, AssistantMessage)]
-
-            return {
-                "agent_id": agent_id,
-                "response": send_message_content if send_message_content else ["<no response>"],
-            }
-
-        except Exception as e:
-            return {
-                "agent_id": agent_id,
-                "error": str(e),
-                "type": type(e).__name__,
-            }
-
-
-class ExternalComposioToolExecutor(ToolExecutor):
-    """Executor for external Composio tools."""
-
-    @trace_method
-    async def execute(
-        self,
-        function_name: str,
-        function_args: dict,
-        tool: Tool,
-        actor: User,
-        agent_state: Optional[AgentState] = None,
-        sandbox_config: Optional[SandboxConfig] = None,
-        sandbox_env_vars: Optional[Dict[str, Any]] = None,
-    ) -> ToolExecutionResult:
-        assert agent_state is not None, "Agent state is required for external Composio tools"
-        action_name = generate_composio_action_from_func_name(tool.name)
-
-        # Get entity ID from the agent_state
-        entity_id = self._get_entity_id(agent_state)
-
-        # Get composio_api_key
-        composio_api_key = await get_composio_api_key_async(actor=actor)
-
-        # TODO (matt): Roll in execute_composio_action into this class
-        function_response = await execute_composio_action_async(
-            action_name=action_name, args=function_args, api_key=composio_api_key, entity_id=entity_id
-        )
-
-        return ToolExecutionResult(
-            status="success",
-            func_return=function_response,
-        )
-
-    def _get_entity_id(self, agent_state: AgentState) -> Optional[str]:
-        """Extract the entity ID from environment variables."""
-        for env_var in agent_state.tool_exec_environment_variables:
-            if env_var.key == COMPOSIO_ENTITY_ENV_VAR_KEY:
-                return env_var.value
-        return None
-
-
-class ExternalMCPToolExecutor(ToolExecutor):
-    """Executor for external MCP tools."""
-
-    @trace_method
-    async def execute(
-        self,
-        function_name: str,
-        function_args: dict,
-        tool: Tool,
-        actor: User,
-        agent_state: Optional[AgentState] = None,
-        sandbox_config: Optional[SandboxConfig] = None,
-        sandbox_env_vars: Optional[Dict[str, Any]] = None,
-    ) -> ToolExecutionResult:
-
-        pass
-
-        mcp_server_tag = [tag for tag in tool.tags if tag.startswith(f"{MCP_TOOL_TAG_NAME_PREFIX}:")]
-        if not mcp_server_tag:
-            raise ValueError(f"Tool {tool.name} does not have a valid MCP server tag")
-        mcp_server_name = mcp_server_tag[0].split(":")[1]
-
-        mcp_manager = MCPManager()
-        # TODO: may need to have better client connection management
-        function_response, success = await mcp_manager.execute_mcp_server_tool(
-            mcp_server_name=mcp_server_name, tool_name=function_name, tool_args=function_args, actor=actor
-        )
-
-        return ToolExecutionResult(
-            status="success" if success else "error",
-            func_return=function_response,
-        )
-
-
 class SandboxToolExecutor(ToolExecutor):
     """Executor for sandboxed tools."""
 
@@ -801,107 +106,3 @@ class SandboxToolExecutor(ToolExecutor):
             func_return=error_message,
             stderr=[stderr],
         )
-
-
-class LettaBuiltinToolExecutor(ToolExecutor):
-    """Executor for built in Letta tools."""
-
-    @trace_method
-    async def execute(
-        self,
-        function_name: str,
-        function_args: dict,
-        tool: Tool,
-        actor: User,
-        agent_state: Optional[AgentState] = None,
-        sandbox_config: Optional[SandboxConfig] = None,
-        sandbox_env_vars: Optional[Dict[str, Any]] = None,
-    ) -> ToolExecutionResult:
-        function_map = {"run_code": self.run_code, "web_search": self.web_search}
-
-        if function_name not in function_map:
-            raise ValueError(f"Unknown function: {function_name}")
-
-        # Execute the appropriate function
-        function_args_copy = function_args.copy()  # Make a copy to avoid modifying the original
-        function_response = await function_map[function_name](**function_args_copy)
-
-        return ToolExecutionResult(
-            status="success",
-            func_return=function_response,
-            agent_state=agent_state,
-        )
-
-    async def run_code(self, code: str, language: Literal["python", "js", "ts", "r", "java"]) -> str:
-        from e2b_code_interpreter import AsyncSandbox
-
-        if tool_settings.e2b_api_key is None:
-            raise ValueError("E2B_API_KEY is not set")
-
-        sbx = await AsyncSandbox.create(api_key=tool_settings.e2b_api_key)
-        params = {"code": code}
-        if language != "python":
-            # Leave empty for python
-            params["language"] = language
-
-        res = self._llm_friendly_result(await sbx.run_code(**params))
-        return json.dumps(res, ensure_ascii=False)
-
-    def _llm_friendly_result(self, res):
-        out = {
-            "results": [r.text if hasattr(r, "text") else str(r) for r in res.results],
-            "logs": {
-                "stdout": getattr(res.logs, "stdout", []),
-                "stderr": getattr(res.logs, "stderr", []),
-            },
-        }
-        err = getattr(res, "error", None)
-        if err is not None:
-            out["error"] = err
-        return out
-
-    async def web_search(agent_state: "AgentState", query: str) -> str:
-        """
-        Search the web for information.
-        Args:
-            query (str): The query to search the web for.
-        Returns:
-            str: The search results.
-        """
-
-        try:
-            from tavily import AsyncTavilyClient
-        except ImportError:
-            raise ImportError("tavily is not installed in the tool execution environment")
-
-        # Check if the API key exists
-        if tool_settings.tavily_api_key is None:
-            raise ValueError("TAVILY_API_KEY is not set")
-
-        # Instantiate client and search
-        tavily_client = AsyncTavilyClient(api_key=tool_settings.tavily_api_key)
-        search_results = await tavily_client.search(query=query, auto_parameters=True)
-
-        results = search_results.get("results", [])
-        if not results:
-            return "No search results found."
-
-        # ---- format for the LLM -------------------------------------------------
-        formatted_blocks = []
-        for idx, item in enumerate(results, start=1):
-            title = item.get("title") or "Untitled"
-            url = item.get("url") or "Unknown URL"
-            # keep each content snippet reasonably short so you don’t blow up context
-            content = (
-                shorten(item.get("content", "").strip(), width=600, placeholder=" …")
-                if WEB_SEARCH_CLIP_CONTENT
-                else item.get("content", "").strip()
-            )
-            score = item.get("score")
-            if WEB_SEARCH_INCLUDE_SCORE:
-                block = f"\nRESULT {idx}:\n" f"Title: {title}\n" f"URL: {url}\n" f"Relevance score: {score:.4f}\n" f"Content: {content}\n"
-            else:
-                block = f"\nRESULT {idx}:\n" f"Title: {title}\n" f"URL: {url}\n" f"Content: {content}\n"
-            formatted_blocks.append(block)
-
-        return WEB_SEARCH_SEPARATOR.join(formatted_blocks)