Bash Execution Node

Executes a raw bash script. Can run within an isolated worktree if configured.

Value

An `AgentBashNode` object.

Super class

HydraR::AgentNode -> AgentBashNode

Public fields

script

Character string or Function. The bash script to execute.

env_vars

Named list. Environment variables to inject.

Methods

Public methods

• AgentBashNode$new()

• AgentBashNode$run()

• AgentBashNode$clone()

---

Method new()

Initialize Bash Node

Usage

AgentBashNode$new(id, label = NULL, script, env_vars = list(), params = list())

Arguments

id

Node ID

label

Node Label

script

String or Function(state) returning a string.

env_vars

Named list of environment variables

params

List of standard Node parameters Run Bash Execution

---

Method run()

Usage

AgentBashNode$run(state, working_dir = NULL)

Arguments

state

AgentState object.

working_dir

Directory context for execution.

Returns

List with output, status_code, and success flag.

---

Method clone()

The objects of this class are cloneable with this method.

Usage

AgentBashNode$clone(deep = FALSE)

Arguments

deep

Whether to make a deep clone.

Examples

if (FALSE) { # \dontrun{
# 1. Simple static bash command
node_simple <- AgentBashNode$new(id = "bash_ls", script = "ls -la")

# 2. Dynamic bash script using state values and environment variables
# The script is generated at runtime based on the current AgentState.
dynamic_script <- function(state) {
  input_file <- state$get("raw_data_path")
  sprintf("cat %s | grep 'ERR' > failure_log.txt", input_file)
}

node_dynamic <- AgentBashNode$new(
  id = "bash_filter",
  script = dynamic_script,
  env_vars = list(THRESHOLD = "100", CPU_LIMIT = "4")
)

# Execute the node
res <- node_dynamic$run(state = AgentState$new(list(raw_data_path = "data.csv")))
message(res$output)
} # }