Struct BudgetConfig 

pub struct BudgetConfig {
    pub default_run_max_cost_usd: Option<Decimal>,
    pub monthly_cost_limit_usd: Option<Decimal>,
}

Server-level cost guardrails.

Both fields default to None, which disables the corresponding check and preserves the pre-existing behaviour exactly.

Examples

use ironflow_engine::budget::BudgetConfig;

let config = BudgetConfig::new();
assert!(config.default_run_max_cost_usd.is_none());
assert!(config.monthly_cost_limit_usd.is_none());

Fields

default_run_max_cost_usd: Option<Decimal>

Default cost cap applied to a run when neither the creation request nor the handler declares one. None means no default cap.

monthly_cost_limit_usd: Option<Decimal>

Global quota for the current calendar month (UTC). None disables the monthly check.

Implementations

impl BudgetConfig

pub fn new() -> Self

Create a configuration with both guardrails disabled.

Examples

use ironflow_engine::budget::BudgetConfig;

assert_eq!(BudgetConfig::new(), BudgetConfig::default());

pub fn default_run_max_cost_usd(self, cap: Decimal) -> Self

Set the server-wide default per-run cost cap.

Examples

use ironflow_engine::budget::BudgetConfig;
use rust_decimal::Decimal;

let config = BudgetConfig::new().default_run_max_cost_usd(Decimal::new(150, 2));
assert_eq!(config.default_run_max_cost_usd, Some(Decimal::new(150, 2)));

pub fn monthly_cost_limit_usd(self, limit: Decimal) -> Self

Set the global monthly cost quota.

Examples

use ironflow_engine::budget::BudgetConfig;
use rust_decimal::Decimal;

let config = BudgetConfig::new().monthly_cost_limit_usd(Decimal::new(10000, 2));
assert_eq!(config.monthly_cost_limit_usd, Some(Decimal::new(10000, 2)));

pub fn from_env() -> Self

Load the configuration from the environment.

Reads DEFAULT_RUN_MAX_COST_ENV and MONTHLY_COST_LIMIT_ENV. A variable that is unset, empty, unparseable, or negative is ignored (the corresponding guardrail stays disabled) and logged at WARN. Loading never fails, so a malformed value can never prevent the server from starting.

Examples

use ironflow_engine::budget::BudgetConfig;

let config = BudgetConfig::from_env();

pub fn resolve_run_cap( &self, requested: Option<Decimal>, handler_default: Option<Decimal>, ) -> Option<Decimal>

Resolve the cost cap of a run being created.

Priority, strongest first: the value supplied at creation time, then the handler default, then the server default. None at every level means the run has no cap.

Examples

use ironflow_engine::budget::BudgetConfig;
use rust_decimal::Decimal;

let server = Decimal::new(100, 2);
let handler = Decimal::new(200, 2);
let requested = Decimal::new(300, 2);
let config = BudgetConfig::new().default_run_max_cost_usd(server);

assert_eq!(config.resolve_run_cap(Some(requested), Some(handler)), Some(requested));
assert_eq!(config.resolve_run_cap(None, Some(handler)), Some(handler));
assert_eq!(config.resolve_run_cap(None, None), Some(server));

Trait Implementations

impl Clone for BudgetConfig

fn clone(&self) -> BudgetConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BudgetConfig

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

Formats the value using the given formatter.

impl Default for BudgetConfig

fn default() -> BudgetConfig

Returns the “default value” for a type.

impl Eq for BudgetConfig

impl PartialEq for BudgetConfig

fn eq(&self, other: &BudgetConfig) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for BudgetConfig