Struct PolicyEngine 

pub struct PolicyEngine { /* private fields */ }

The referee engine that evaluates tool calls against configured policies.

The PolicyEngine holds a set of ApprovalPolicy rules and an ApprovalHandler for escalating decisions that require human input. It tracks auto-approval counts per policy to enforce rate limits.

Implementations

impl PolicyEngine

pub fn new( policies: Vec<ApprovalPolicy>, handler: Arc<dyn ApprovalHandler>, ) -> Self

Create a new policy engine with the given rules and handler.

pub async fn evaluate( &self, tool_name: &str, input: &Value, fighter_id: &FighterId, ) -> PunchResult<ApprovalDecision>

Evaluate a tool call against the configured policies.

The referee checks the ring rules:

1. Find the first policy whose tool patterns match the tool name
2. If no policy matches, the move is allowed (permissive by default)
3. If the matched policy auto-approves and the risk is not Critical, check the auto-approval counter
4. If the counter is exhausted (or risk is Critical), escalate to the handler

pub fn auto_approve_count(&self, policy_index: usize) -> Option<u32>

Get the current auto-approval count for a policy at the given index. Returns None if the index is out of bounds.

pub fn reset_counters(&self)

Reset all auto-approval counters to zero.

Trait Implementations

impl Debug for PolicyEngine

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.