Struct Colony 

pub struct Colony { /* private fields */ }

The colony — manages agent lifecycle and simulation.

Implementations

impl Colony

pub fn new() -> Self

pub fn spawn( &mut self, agent: Box<dyn Agent<Input = String, Fragment = String, Presentation = Vec<String>>>, ) -> AgentId

Spawn an agent into the colony.

pub fn ingest_document( &mut self, title: &str, content: &str, position: Position, ) -> DocumentId

Ingest a document into the substrate.

Places the document at the given position and emits an Input signal to attract nearby agents via chemotaxis.

pub fn tick(&mut self) -> Vec<ColonyEvent>

Run a single simulation tick.

pub fn run(&mut self, ticks: u64) -> Vec<Vec<ColonyEvent>>

Run the simulation for N ticks.

pub fn stats(&self) -> ColonyStats

Get colony statistics.

pub fn substrate(&self) -> &SubstrateImpl

Get a reference to the substrate.

pub fn substrate_mut(&mut self) -> &mut SubstrateImpl

Get a mutable reference to the substrate.

pub fn alive_count(&self) -> usize

Number of agents currently alive.

pub fn death_signals(&self) -> &[DeathSignal]

All death signals collected during the simulation.

pub fn feed_agent( &mut self, agent_idx: usize, input: String, ) -> Option<DigestionResult>

Feed text input to a specific agent by index.

pub fn snapshot(&self) -> ColonySnapshot

Take a serializable snapshot of the colony’s current state.

pub fn event_history(&self) -> &[(Tick, ColonyEvent)]

Get the full event history with tick numbers.

pub fn agents( &self, ) -> &[Box<dyn Agent<Input = String, Fragment = String, Presentation = Vec<String>>>]

Get a reference to the agents.

pub fn fitness_tracker(&self) -> &FitnessTracker

Get a reference to the fitness tracker.

pub fn fitness_tracker_mut(&mut self) -> &mut FitnessTracker

Get a mutable reference to the fitness tracker.

pub fn emit_input_signal(&mut self, position: Position, intensity: f64)

Emit an input signal at a position (to attract agents).

Trait Implementations

impl Default for Colony

fn default() -> Self

Returns the “default value” for a type.