Struct WorkflowGuardConfig 

pub struct WorkflowGuardConfig {
    pub max_depth: u32,
    pub max_fan_out: u32,
    pub max_workflow_tokens: u64,
    pub workflow_timeout_secs: u64,
}

Configurable execution limits for a workflow run.

Each limit has a sensible default. Limits can be set per-handler via WorkflowHandler::guard_config or globally on the Engine.

Examples

use ironflow_engine::guard::WorkflowGuardConfig;

let config = WorkflowGuardConfig::new()
    .with_max_depth(3)
    .with_max_fan_out(10);

assert_eq!(config.max_depth, 3);
assert_eq!(config.max_fan_out, 10);
assert_eq!(config.max_workflow_tokens, 100_000);

Fields

max_depth: u32

Maximum depth of nested sub-workflows (default 5).

max_fan_out: u32

Maximum total number of workflow invocations (default 20).

max_workflow_tokens: u64

Cumulative token budget across all agent steps (default 100,000).

workflow_timeout_secs: u64

Global timeout in seconds (default 120).

Implementations

impl WorkflowGuardConfig

pub fn new() -> Self

Create a configuration with default limits.

Examples

use ironflow_engine::guard::WorkflowGuardConfig;

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

pub fn from_env() -> Self

Load configuration from environment variables.

Reads IRONFLOW_GUARD_MAX_DEPTH, IRONFLOW_GUARD_MAX_FAN_OUT, IRONFLOW_GUARD_MAX_WORKFLOW_TOKENS, and IRONFLOW_GUARD_WORKFLOW_TIMEOUT_SECS. Missing or unparseable variables fall back to defaults.

Examples

use ironflow_engine::guard::WorkflowGuardConfig;

let config = WorkflowGuardConfig::from_env();
// Without env vars set, returns defaults.
assert_eq!(config.max_depth, 5);

pub fn with_max_depth(self, max_depth: u32) -> Self

Set the maximum sub-workflow nesting depth.

Examples

use ironflow_engine::guard::WorkflowGuardConfig;

let config = WorkflowGuardConfig::new().with_max_depth(3);
assert_eq!(config.max_depth, 3);

pub fn with_max_fan_out(self, max_fan_out: u32) -> Self

Set the maximum total workflow invocations.

Examples

use ironflow_engine::guard::WorkflowGuardConfig;

let config = WorkflowGuardConfig::new().with_max_fan_out(10);
assert_eq!(config.max_fan_out, 10);

pub fn with_max_workflow_tokens(self, max: u64) -> Self

Set the cumulative token budget.

Examples

use ironflow_engine::guard::WorkflowGuardConfig;

let config = WorkflowGuardConfig::new().with_max_workflow_tokens(50_000);
assert_eq!(config.max_workflow_tokens, 50_000);

pub fn with_workflow_timeout_secs(self, secs: u64) -> Self

Set the global timeout in seconds.

Examples

use ironflow_engine::guard::WorkflowGuardConfig;

let config = WorkflowGuardConfig::new().with_workflow_timeout_secs(60);
assert_eq!(config.workflow_timeout_secs, 60);

Trait Implementations

impl Clone for WorkflowGuardConfig

fn clone(&self) -> WorkflowGuardConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorkflowGuardConfig

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

Formats the value using the given formatter.

impl Default for WorkflowGuardConfig

fn default() -> Self

Returns the “default value” for a type.

impl Eq for WorkflowGuardConfig

impl PartialEq for WorkflowGuardConfig

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for WorkflowGuardConfig