from typing import Dict, Union from langchain_core.tools import tool from rich.console import Console from rich.panel import Panel from ra_aid.proc.interactive import run_interactive_command from ra_aid.text.processing import truncate_output console = Console() @tool def run_shell_command(command: str) -> Dict[str, Union[str, int, bool]]: """Execute a shell command and return its output. Assume these are available: - rg - tree - standard linux utilities 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. Args: command: List of command arguments. First item is the command, rest are arguments. Returns: A dictionary containing: - output: The command output (stdout + stderr combined) - return_code: The process return code (0 typically means success) - success: Boolean indicating if the command succeeded (return code == 0) """ # Show just the command in a simple panel console.print(Panel(command, title="🐚 Shell", border_style="bright_yellow")) try: print() output, return_code = run_interactive_command(['/bin/bash', '-c', command]) print() return { "output": truncate_output(output.decode()) if output else "", "return_code": return_code, "success": return_code == 0 } except Exception as e: print() console.print(Panel(str(e), title="❌ Error", border_style="red")) return { "output": str(e), "return_code": 1, "success": False }