from typing import Dict, Union from langchain_core.tools import tool from rich.console import Console from rich.panel import Panel from rich.prompt import Prompt from ra_aid.console.cowboy_messages import get_cowboy_message from ra_aid.proc.interactive import run_interactive_command from ra_aid.text.processing import truncate_output from ra_aid.tools.memory import log_work_event from ra_aid.database.repositories.config_repository import get_config_repository console = Console() def _truncate_for_log(text: str, max_length: int = 300) -> str: """Truncate text for logging, adding [truncated] if necessary.""" if len(text) <= max_length: return text return text[:max_length] + "... [truncated]" @tool def run_shell_command( command: str, timeout: int = 30 ) -> Dict[str, Union[str, int, bool]]: """Execute a shell command and return its output. Args: command: The shell command to execute. Keep it to 300 words or less. timeout: Expected runtime in seconds, defaults to 30. If process exceeds 2x this value, it will be terminated gracefully. If process exceeds 3x this value, it will be killed forcefully. Important notes: 1. Try to constrain/limit the output. Output processing is expensive, and infinite/looping output will cause us to fail. 2. When using commands like 'find', 'grep', or similar recursive search tools, always exclude common development directories and files that can cause excessive output or slow performance: - Version control: .git - Dependencies: node_modules, vendor, .venv - Cache: __pycache__, .cache - Build: dist, build - Environment: .env, venv, env - IDE: .idea, .vscode 3. Avoid doing recursive lists, finds, etc. that could be slow and have a ton of output. Likewise, avoid flags like '-l' that needlessly increase the output. But if you really need to, you can. 4. Add flags e.g. git --no-pager in order to reduce interaction required by the human. """ # Check if we need approval cowboy_mode = get_config_repository().get("cowboy_mode", False) if cowboy_mode: console.print("") console.print(" " + get_cowboy_message()) console.print("") # Show just the command in a simple panel console.print(Panel(command, title="🐚 Shell", border_style="bright_yellow")) if not cowboy_mode: choices = ["y", "n", "c"] response = Prompt.ask( "Execute this command? (y=yes, n=no, c=enable cowboy mode for session)", choices=choices, default="y", show_choices=True, show_default=True, ) if response == "n": print() return { "output": "Command execution cancelled by user", "return_code": 1, "success": False, } elif response == "c": get_config_repository().set("cowboy_mode", True) console.print("") console.print(" " + get_cowboy_message()) console.print("") try: print() output, return_code = run_interactive_command( ["/bin/bash", "-c", command], expected_runtime_seconds=timeout, ) print() result = { "output": truncate_output(output.decode()) if output else "", "return_code": return_code, "success": return_code == 0, } log_work_event(f"Executed shell command: {_truncate_for_log(command)}") return result except Exception as e: print() console.print(Panel(str(e), title="❌ Error", border_style="red")) return {"output": str(e), "return_code": 1, "success": False}