praval.hitl.policy

Policy helpers for HITL approval gating.

Functions

approval_reason(tool_definition)	Return operator-facing reason for approval requests.
requires_approval(tool_definition[, default])	Determine whether a tool call requires human approval.
risk_level(tool_definition)	Return normalized risk level from a tool definition.

praval.hitl.policy.requires_approval(tool_definition, default=False)

Determine whether a tool call requires human approval.

Return type:

bool

Parameters:

• tool_definition (Dict[str, Any])

• default (bool)

praval.hitl.policy.risk_level(tool_definition)

Return normalized risk level from a tool definition.

Return type:

str

Parameters:

tool_definition (Dict[str, Any])

praval.hitl.policy.approval_reason(tool_definition)

Return operator-facing reason for approval requests.

Return type:

str

Parameters:

tool_definition (Dict[str, Any])