Function restore_agents 

pub fn restore_agents(colony: &mut Colony, state: &GraphState) -> usize

Restore agents from a GraphState into a colony.

This is a convenience function that handles all built-in agent types. Returns the number of agents successfully restored.