Struct UtilityAction 

pub struct UtilityAction<W> {
    pub name: String,
    pub considerations: Vec<Consideration>,
    pub min_threshold: f32,
    pub momentum: f32,
    pub use_geo_mean: bool,
    pub execute: Box<dyn Fn(&mut W, f32) -> bool + Send + Sync>,
    pub input_provider: Box<dyn Fn(&W) -> HashMap<String, f32> + Send + Sync>,
}

An action with a set of considerations.

Fields

name: String

considerations: Vec<Consideration>

min_threshold: f32

Minimum score threshold to select this action.

momentum: f32

Bonus score added when this action was selected last tick (momentum).

use_geo_mean: bool

Score normalisation: geometric mean vs product.

execute: Box<dyn Fn(&mut W, f32) -> bool + Send + Sync>

The action to execute when selected.

input_provider: Box<dyn Fn(&W) -> HashMap<String, f32> + Send + Sync>

Input provider: maps W → [0, 1] per consideration name.

Implementations

impl<W> UtilityAction<W>

pub fn new( name: &str, execute: impl Fn(&mut W, f32) -> bool + Send + Sync + 'static, input_provider: impl Fn(&W) -> HashMap<String, f32> + Send + Sync + 'static, ) -> Self

pub fn with_consideration(self, c: Consideration) -> Self

pub fn score(&self, world: &W, is_current: bool) -> f32

Evaluate this action’s combined utility score.