new: increased shell namespace default timeout to 60 seconds and introduced NERVE_SHELL_TIMEOUT env variable to override it (closes #56)

Author: evilsocket

docs/namespaces.md

@@ -278,7 +278,10 @@ Let the agent execute shell commands.
 
 ### `shell`
 
-<pre>Execute a shell command on the local computer and return the output. Non interactive shell with a timeout of 30 seconds.</pre>
+<pre>Execute a shell command on the local computer and return the output. Non interactive shell with a timeout of 60 seconds.</pre>
+
+> [!TIP]  
+> The default timeout for shell commands is 60 seconds. You can override this value by setting the `NERVE_SHELL_TIMEOUT` environment variable.
 
 **Parameters**
 

nerve/defaults.py

@@ -7,6 +7,7 @@
 DEFAULT_MAX_STEPS: int = int(os.getenv("NERVE_MAX_STEPS", 100))
 DEFAULT_MAX_COST: float = float(os.getenv("NERVE_MAX_COST", 10.0))
 DEFAULT_TIMEOUT: int | None = int(os.getenv("NERVE_TIMEOUT", 0)) or None
+DEFAULT_SHELL_TIMEOUT: int = int(os.getenv("NERVE_SHELL_TIMEOUT", "60"))
 DEFAULT_CONVERSATION_STRATEGY: str = os.getenv("NERVE_CONVERSATION_STRATEGY", "full")
 
 DEFAULT_NERVE_HOME: pathlib.Path = pathlib.Path.home() / ".nerve"

nerve/tools/namespaces/shell.py

@@ -8,6 +8,7 @@
 import subprocess
 from typing import Annotated
 
+from nerve.defaults import DEFAULT_SHELL_TIMEOUT
 from nerve.tools.utils import maybe_text
 
 # for docs
@@ -19,7 +20,7 @@ def shell(
 ) -> str | bytes:
     """Execute a shell command on the local computer and return the output. Non interactive shell with a timeout of 30 seconds."""
 
-    result = subprocess.run(command, shell=True, capture_output=True, timeout=30)
+    result = subprocess.run(command, shell=True, capture_output=True, timeout=DEFAULT_SHELL_TIMEOUT)
 
     raw_output = result.stdout or b""