Struct Agency 

pub struct Agency {
    pub max_children: Option<usize>,
    pub allowed_roles: Vec<AgentRole>,
    pub capability_ceiling: AgentCapabilities,
    pub children: Vec<Pid>,
}

Agency: the ability to spawn child agents.

Hierarchical: root has unlimited agency, supervisors can spawn service/worker agents, services can spawn workers only, and workers have no agency.

Fields

max_children: Option<usize>

Maximum number of child agents this agent can spawn. None = unlimited.

allowed_roles: Vec<AgentRole>

Which roles this agent is allowed to spawn.

capability_ceiling: AgentCapabilities

Capability ceiling: spawned agents cannot exceed these capabilities.

children: Vec<Pid>

Currently spawned child PIDs.

Implementations

impl Agency

pub fn root() -> Self

Root agent: unlimited agency.

pub fn supervisor(max_children: usize) -> Self

Supervisor: can spawn services and workers.

pub fn service(max_workers: usize) -> Self

Service: can spawn workers only.

pub fn none() -> Self

Worker: no agency (leaf agent).

pub fn can_spawn(&self, role: &AgentRole) -> bool

Check if this agency allows spawning a child with the given role.

pub fn add_child(&mut self, pid: Pid)

Record a spawned child.

pub fn remove_child(&mut self, pid: Pid)

Remove a terminated child.

pub fn remaining_capacity(&self) -> Option<usize>

How many children remain before hitting the limit.

Trait Implementations

impl Clone for Agency

fn clone(&self) -> Agency

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Agency

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

Formats the value using the given formatter.

impl Default for Agency

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Agency

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Agency

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

where __S: Serializer,

Serialize this value into the given Serde serializer.