API Reference

use rg_types::{Config, HookInput, Verdict};
use rg_policy::{RuntimePolicy, inspect};
 
fn main() -> eyre::Result<()> {
    // Load config
    let config: Config = toml::from_str(&std::fs::read_to_string("railgun.toml")?)?;
 
    // Build runtime policy
    let policy = RuntimePolicy::from_config(&config)?;
 
    // Inspect a tool call
    let input = HookInput {
        tool_name: "Bash".to_string(),
        tool_input: serde_json::json!({
            "command": "ls -la"
        }),
    };
 
    let verdict = inspect(&input, &policy);
 
    match verdict {
        Verdict::Allow => println!("Allowed"),
        Verdict::Deny { reason } => println!("Denied: {}", reason),
        Verdict::Ask { message } => println!("Ask user: {}", message),
    }
 
    Ok(())
}

use rg_policy::{RuntimePolicy, PolicyError};
 
fn load_policy(config: &Config) -> Result<RuntimePolicy, PolicyError> {
    RuntimePolicy::from_config(config)
}
 
// PolicyError variants:
// - InvalidPattern { pattern, reason }
// - ConfigParsing { source }