Struct BoundedWorkGraph 

pub struct BoundedWorkGraph { /* private fields */ }

Bounded, acyclic work graph with enforced fan-out and budget constraints.

Implementations

impl BoundedWorkGraph

pub fn new(max_fan_out: usize, max_depth: u16) -> Self

pub fn add_root( &mut self, node_id: String, agent_id: String, capsule_ref: String, budget: WorkNodeBudget, ) -> Result<&WorkNode, WorkGraphError>

Add a root node (no parent).

pub fn delegate( &mut self, parent_node_id: &str, child_node_id: String, child_agent_id: String, capsule_ref: String, child_budget: WorkNodeBudget, ) -> Result<&WorkNode, WorkGraphError>

Delegate work to a child node. Validates budget inheritance and fan-out.

pub fn allocate_child_budget( &mut self, parent_id: &str, child_id: &str, fraction: f64, ) -> Result<WorkNodeBudget, WorkGraphError>

Allocates budget for a child node using cascade rules.

The returned budget is reserved for child_id until it is passed to Self::delegate, so chain allocation is not counted twice.

pub fn complete( &mut self, node_id: &str, outcome_ref: String, ) -> Result<(), WorkGraphError>

Mark a node as completed with an outcome reference.

pub fn stop( &mut self, node_id: &str, reason: StopReason, ) -> Result<Vec<String>, WorkGraphError>

Stop a node and all its descendants (cascade).

pub fn consume_budget( &mut self, node_id: &str, tokens: u64, cost_micros: u64, ) -> Result<bool, WorkGraphError>

Record token consumption on a node.

pub fn consume_tokens( &mut self, node_id: &str, tokens: u64, ) -> Result<(), WorkGraphError>

Records token consumption for a node and updates its chain budget.

pub fn chain_budget_for(&self, node_id: &str) -> Option<&ChainBudget>

Returns the chain budget for a given node’s chain.

pub fn over_budget_chains(&self, threshold_pct: f64) -> Vec<&ChainBudget>

Returns all chains at or above their utilization threshold.

pub fn enforce_stop_conditions(&mut self) -> Vec<(String, StopReason)>

Check all nodes for stop conditions and cascade.

pub fn get_node(&self, node_id: &str) -> Option<&WorkNode>

pub fn children_of(&self, node_id: &str) -> &[String]

pub fn active_count(&self) -> usize

pub fn total_count(&self) -> usize

Trait Implementations

impl Clone for BoundedWorkGraph

fn clone(&self) -> BoundedWorkGraph

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BoundedWorkGraph

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

Formats the value using the given formatter.

impl Default for BoundedWorkGraph

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for BoundedWorkGraph

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for BoundedWorkGraph

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

where __S: Serializer,

Serialize this value into the given Serde serializer.