deer-flow/backend/src/sandbox/tools.py

from langchain.tools import tool

from src.sandbox.sandbox_provider import get_sandbox_provider


@tool("bash", parse_docstring=True)
def bash_tool(description: str, command: str) -> str:
    """Execute a bash command.

    Args:
        description: Explain why you are running this command in short words.
        command: The bash command to execute. Always use absolute paths for files and directories.
    """
    # TODO: get sandbox ID from LangGraph's context
    sandbox_id = "local"
    sandbox = get_sandbox_provider().get(sandbox_id)
    try:
        return sandbox.execute_command(command)
    except Exception as e:
        return f"Error: {e}"


@tool("ls", parse_docstring=True)
def ls_tool(description: str, path: str) -> str:
    """List the contents of a directory up to 2 levels deep in tree format.

    Args:
        description: Explain why you are listing this directory in short words.
        path: The **absolute** path to the directory to list.
    """
    try:
        # TODO: get sandbox ID from LangGraph's context
        sandbox = get_sandbox_provider().get("local")
        children = sandbox.list_dir(path)
        if not children:
            return "(empty)"
        return "\n".join(children)
    except Exception as e:
        return f"Error: {e}"


@tool("read_file", parse_docstring=True)
def read_file_tool(
    description: str,
    path: str,
    view_range: tuple[int, int] | None = None,
) -> str:
    """Read the contents of a text file.

    Args:
        description: Explain why you are viewing this file in short words.
        path: The **absolute** path to the file to read.
        view_range: The range of lines to view. The range is inclusive and starts at 1. For example, (1, 10) will view the first 10 lines of the file.
    """
    try:
        # TODO: get sandbox ID from LangGraph's context
        sandbox = get_sandbox_provider().get("local")
        content = sandbox.read_file(path)
        if not content:
            return "(empty)"
        if view_range:
            start, end = view_range
            content = "\n".join(content.splitlines()[start - 1 : end])
        return content
    except Exception as e:
        return f"Error: {e}"


@tool("write_file", parse_docstring=True)
def write_file_tool(
    description: str,
    path: str,
    content: str,
    append: bool = False,
) -> str:
    """Write text content to a file.

    Args:
        description: Explain why you are writing to this file in short words.
        path: The **absolute** path to the file to write to.
        content: The content to write to the file.
    """
    try:
        # TODO: get sandbox ID from LangGraph's context
        sandbox = get_sandbox_provider().get("local")
        sandbox.write_file(path, content, append)
        return "OK"
    except Exception as e:
        return f"Error: {e}"


@tool("str_replace", parse_docstring=True)
def str_replace_tool(
    description: str,
    path: str,
    old_str: str,
    new_str: str,
    replace_all: bool = False,
) -> str:
    """Replace a substring in a file with another substring.
    If `replace_all` is False (default), the substring to replace must appear **exactly once** in the file.

    Args:
        description: Explain why you are replacing the substring in short words.
        path: The **absolute** path to the file to replace the substring in.
        old_str: The substring to replace.
        new_str: The new substring.
        replace_all: Whether to replace all occurrences of the substring. If False, only the first occurrence will be replaced. Default is False.
    """
    try:
        # TODO: get sandbox ID from LangGraph's context
        sandbox = get_sandbox_provider().get("local")
        content = sandbox.read_file(path)
        if not content:
            return "OK"
        if replace_all:
            content = content.replace(old_str, new_str)
        else:
            content = content.replace(old_str, new_str, 1)
        sandbox.write_file(path, content)
        return "OK"
    except Exception as e:
        return f"Error: {e}"