bash

Bash execution tool. Runs shell commands through the guardrail pipeline.

Values

pub fn check_foreground_timeout(
  timeout_seconds: Int,
) -> Result(Nil, String)

Reject foreground commands that exceed the configured max runtime. To be wired once the bash tool schema gains a timeout parameter.

</>

pub fn tool() -> tool.Tool

Create a bash tool that auto-denies any command requiring approval. Use this for non-interactive contexts (API servers, background workers).

</>

pub fn tool_with_approval(
  on_approval: fn(String, String) -> Bool,
) -> tool.Tool

Create a bash tool with a custom approval callback. The callback receives (reason, command) and returns True to approve.