Struct UtilityScoringConfig 

pub struct UtilityScoringConfig {
    pub enabled: bool,
    pub threshold: f32,
    pub gain_weight: f32,
    pub cost_weight: f32,
    pub redundancy_weight: f32,
    pub uncertainty_bonus: f32,
    pub exempt_tools: Vec<String>,
}

Configuration for utility-guided tool dispatch ([tools.utility] TOML section).

Implements the utility gate from arXiv:2603.19896: each tool call is scored U = gain_weight*gain - cost_weight*cost - redundancy_weight*redundancy + uncertainty_bonus*uncertainty. Calls with U < threshold are skipped (fail-closed on scoring errors).

Fields

enabled: bool

Enable utility-guided gating. Default: false (opt-in).

threshold: f32

Minimum utility score required to execute a tool call. Default: 0.1.

gain_weight: f32

Weight for the estimated gain component. Must be >= 0. Default: 1.0.

cost_weight: f32

Weight for the step cost component. Must be >= 0. Default: 0.5.

redundancy_weight: f32

Weight for the redundancy penalty. Must be >= 0. Default: 0.3.

uncertainty_bonus: f32

Weight for the exploration bonus. Must be >= 0. Default: 0.2.

exempt_tools: Vec<String>

Tool names that bypass the utility gate unconditionally (case-insensitive). Auto-populated with file-read tools when MagicDocs is enabled. User-specified entries are preserved and merged additively with any auto-populated names.

Implementations

impl UtilityScoringConfig

pub fn validate(&self) -> Result<(), String>

Validate that all weights and threshold are non-negative and finite.

Errors

Returns a description of the first invalid field found.

Trait Implementations

impl Clone for UtilityScoringConfig

fn clone(&self) -> UtilityScoringConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UtilityScoringConfig

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

Formats the value using the given formatter.

impl Default for UtilityScoringConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for UtilityScoringConfig

where UtilityScoringConfig: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for UtilityScoringConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.