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>,
    pub utility_window: usize,
    pub high_gain_tools: Vec<String>,
}

Configuration for utility-guided tool dispatch.

Fields

enabled: bool

Enable utility-guided gating. Default: false.

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.

utility_window: usize

Consecutive low-utility calls before early-stopping the loop. 0 = disabled.

Exempt tools (invoke_skill, load_skill) do not count toward this window. The counter resets between outer loop iterations.

high_gain_tools: Vec<String>

Tool names that always receive the 0.75 “direct action” gain tier, matching diagnostics/edit/etc in the built-in default_gain table.

Opt-in override for tool ids the built-in table has no entry for — most notably MCP-registered tools, whose ids are {server_id}_{name} (see McpTool::sanitized_id) and therefore never match a hardcoded name. Without an entry here, such a tool falls to the generic 0.5 bucket and can stall behind a Retrieve -> redundant retry -> vetoed cycle on its first call (#5659). Default: empty (no behavior change for existing configs).

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.