Jevolution: A Framework for Studying Communication and Collective Dynamics in AI Agents
Organizations: University of Waterloo
Abstract
Experiments with remote decision-making agents depend on more than the policy: the world may change during inference, the simulator determines which actions are available, and births and immigration alter who can act. We present Jevolution, an instrumented spatial predator-prey framework that makes these dependencies explicit. Its reference implementation separates the evolving world, asynchronous request scheduling, controller adapters, and experiment records. The model combines local observations, energy and resource constraints, predefined signals, and inherited scalar traits. We describe these mechanisms using the ODD protocol and distinguish implemented controls from research questions requiring additional interventions. Free synthetic fixtures exercise scheduling, signaling, and inheritance against the pinned implementation; they validate specified software behavior rather than model intelligence or ecological realism. A completed communication case study illustrates the end-to-end workflow using Jev to control both species. Across 6 complete habitat-seed pairs, the mean signals-on minus signals-off difference in normalized rabbit abundance was -0.0095 (nominal 95% pair-bootstrap interval [-0.0772, 0.0602]). This small study does not resolve the direction of the signal-system effect. The contribution is an inspectable experimental system and its evidence boundaries, not a new policy-learning algorithm or a demonstration of emergent language, adaptive selection, or biological predictive validity.
Figures & tables
| Route | Supported operation and boundary |
|---|---|
| Run configuration | Seed, communication condition, timing settings, and audit runtime options. Predator–prey reset installs a fixed Jev roster: supplied provider, population, and group-delay roster edits are replaced. Arena roster configuration is a separate path. |
| Injected service | A host may replace choose while keeping the engine and observation builder. Synthetic responses test this boundary; virtual clocks additionally require the white-box harness described in Appendix C . |
| Source changes | New species, a supported clock port, receiver-only/fixed-trait controls, or policy optimization need additional implementation and validation. Frozen UI preview metadata is not an active experimental control. |
| Topic | Implemented basis | Evidence still needed for a scientific claim |
|---|---|---|
| Inference latency | Asynchronous requests, eligibility, deadlines, explicit clocks | A controlled delay intervention with matched policy, observation, and scheduling; population effects are not established by deadline tests. |
| Communication | Predefined messages; engine-enforced on/off mechanism | Receiver-only and cost-matched interventions to separate information use from energy/option changes. |
| Emergent behavior | Interacting agents, spatial resources, births, immigration | Repeated patterns and spatially matched nulls preserving resource attraction and demographic placement. |
| Natural selection | Inherited traits, ancestry state, and immigration counters; cohort reconstruction required | Cohort/lineage reproductive success and fixed-trait or inheritance controls separating mutation, drift, immigration, and selection. |
| Policy learning | Controller adapter boundary | A training loop, learning objective, and evaluation protocol; EPO is not implemented. |
| Injected delay (ms) | Capacity 1 | Capacity 3 |
|---|---|---|
| 0 | 238 / 238 / 0 / 0 | 240 / 240 / 0 / 0 |
| 100 | 76 / 74 / 0 / 2 | 126 / 120 / 0 / 6 |
| 500 | 18 / 16 / 0 / 2 | 42 / 36 / 0 / 6 |
| 1000 | 10 / 8 / 0 / 2 | 24 / 18 / 0 / 6 |
| 1001 | 10 / 0 / 8 / 2 | 24 / 0 / 18 / 6 |
| 1500 | 6 / 0 / 4 / 2 | 18 / 0 / 12 / 6 |
Appendix figures & tables11 assets
Supplementary material from the paper’s appendix.
Appendix
| System | Documented emphasis | Relationship to this implementation |
|---|---|---|
| NetLogo / Mesa [ Wilensky, 1999 , Masad and Kazil, 2015 ] | Environments and components for constructing agent-based models. | Jevolution supplies one specialized population task and a remote-decision execution/recording path; replacement of general ABM tools is not established. |
| Generative Agents, Project Sid, AgentSociety [ Park et al., 2023 , Altera.AL et al., 2024 , Piao et al., 2025 ] | Agent architectures, real-time social worlds, and simulation/intervention systems. | Real-time agent societies and framework-plus-intervention studies are prior art. This case uses a structured decision interface in a mechanistic population task. |
| flame / AgentTorch [ Chopra et al., 2024 ] | Differentiable agent-based models for calibration and action learning. | Jevolution does not differentiate through its world or optimize its controller in this study. |
| PettingZoo / Melting Pot [ Terry et al., 2021 , Leibo et al., 2021 ] | Explicit multi-agent interaction API; evaluation across social situations and partners. | The present service boundary is source-level and domain-specific; API compatibility and equivalent evaluation breadth are not established. |
| Jevolution | Pinned spatial engine, asynchronous requests, population turnover, signals, inherited traits, and joined records. | Evidence covers the declared software fixtures and one live-model communication intervention. Practical advantage over the systems above remains an open evaluation question. |
| Pair | Habitat seed | First arm |
|---|---|---|
| 1 | 80350226 | Signals on |
| 2 | 1766849094 | Signals on |
| 3 | 1976771215 | Signals off |
| 4 | 865173864 | Signals on |
| 5 | 1328634472 | Signals on |
| 6 | 415864476 | Signals on |
| Run | Time (s) | Req. | Applied | L/I/E/C | Usage ($) | Bound ($) | Status |
|---|---|---|---|---|---|---|---|
| E1+ | 2.0 | 20 | 20 | 0/0/0/0 | 0.0000 | 0.0000 | complete |
| E2- | 2.0 | 20 | 20 | 0/0/0/0 | 0.0000 | 0.0000 | complete |
| H01- | 90.0 | 900 | 900 | 0/0/0/0 | 0.0000 | 0.0000 | complete |
| H01+ | 90.0 | 900 | 900 | 0/0/0/0 | 0.0000 | 0.0000 | complete |
| H02- | 90.0 | 900 | 900 | 0/0/0/0 | 0.0000 | 0.0000 | complete |
| H02+ | 90.0 | 900 | 900 | 0/0/0/0 | 0.0000 | 0.0000 | complete |
| Run | Wolf AUC | Founder surv. | R births | R deaths | R arrivals | Signals |
|---|---|---|---|---|---|---|
| P01- | 3.3617 | 0.400 | 141 | 103 | 8 | 0 |
| P01+ | 3.1830 | 0.500 | 151 | 106 | 8 | 191 |
| P02- | 3.8189 | 0.386 | 149 | 121 | 8 | 0 |
| P02+ | 3.3332 | 0.457 | 143 | 104 | 8 | 169 |
| P03- | 3.1411 | 0.429 | 147 | 104 | 8 | 0 |
| P03+ | 3.0703 | 0.457 | 135 | 104 | 8 | 222 |
| Pair | On AUC | Off AUC | On off |
|---|---|---|---|
| pair-01 | 1.6974 | 1.7245 | -0.0271 |
| pair-02 | 1.6762 | 1.6677 | 0.0085 |
| pair-03 | 1.6028 | 1.5810 | 0.0218 |
| pair-04 | 1.6469 | 1.6192 | 0.0277 |
| pair-05 | 1.6734 | 1.6774 | -0.0039 |
| pair-06 | 1.7273 | 1.7530 | -0.0258 |
| Mechanism | Main-study setting |
|---|---|
| Rabbit recruitment | Maturity 8 s; minimum energy and water 30 each; global crowding scale 160 rabbits; hard birth cap 250; local crowding disabled. |
| Rabbit birth cost | Parent loses energy; birth or crowding rejection resets cooldown to s. Newborn energy/water: 60/80. |
| Wolf recruitment | Maturity 5 s; energy threshold 80; parent cost 30; birth cooldown 10 s; initial founder birth delay 20 s; birth cap 150. Newborn energy: 33. |
| Wolf energy | Metabolism 1.2 energy/s; a kill adds 40, capped at 100; movement energy charge is zero. |
| Movement | Rabbit speed tiles/s; wolf speed 1.6 tiles/s. Forest multiplies speed by 0.77; a wolf’s eating cooldown adds a factor 0.35. |
| Detection and capture | Rabbit sight radius ; wolf sight radius 9, or 2 for a rabbit hiding in forest. Capture distance ; eating cooldown 10 s; interference coefficient 1. |
| Run | Obs. | Any | % | Danger | Food | Follow | R req/min | W req/min |
|---|---|---|---|---|---|---|---|---|
| P01- | 440 | 0 | 0.0 | 0 | 0 | 0 | 2.65 | 10.88 |
| P01+ | 439 | 148 | 33.7 | 105 | 46 | 0 | 2.44 | 11.49 |
| P02- | 403 | 0 | 0.0 | 0 | 0 | 0 | 2.46 | 9.88 |
| P02+ | 440 | 121 | 27.5 | 97 | 25 | 0 | 2.56 | 10.98 |
| P03- | 441 | 0 | 0.0 | 0 | 0 | 0 | 2.56 | 11.67 |
| P03+ | 439 | 162 | 36.9 | 146 | 18 | 2 | 2.70 | 11.89 |
| Run/species | Obs. | Q (sim s) | Return n/N | W (wall ms) | Age n/applied | Age (sim s) |
|---|---|---|---|---|---|---|
| P01- R | 440 | 18.24/19.49 | 438/440 | 112.5/172.5 | 438/438 | 0.102/0.153 |
| P01- W | 439 | 3.46/7.80 | 439/439 | 107.5/154.9 | 438/438 | 0.101/0.152 |
| P01+ R | 439 | 19.03/22.98 | 439/439 | 116.0/170.9 | 439/439 | 0.102/0.153 |
| P01+ W | 439 | 3.11/7.63 | 438/439 | 107.3/152.1 | 435/435 | 0.101/0.152 |
| P02- R | 403 | 17.36/24.82 | 398/403 | 112.9/161.8 | 398/398 | 0.102/0.153 |
| P02- W | 453 | 3.64/9.44 | 451/453 | 108.6/156.8 | 446/446 | 0.101/0.152 |
| Run | Horizon (sim s) | On (elapsed s) | Off (elapsed s) |
|---|---|---|---|
| P01 | 90.0 | 90.067 | 90.106 |
| P02 | 90.0 | 90.110 | 90.064 |
| P03 | 90.0 | 90.107 | 90.056 |
| P04 | 90.0 | 90.091 | 90.106 |
| P05 | 90.0 | 90.183 | 90.122 |
| P06 | 90.0 | 90.051 | 90.062 |
Agent-Based Modeling
Agent-based modeling simulates how interacting, heterogeneous entities and their environments produce patterns in social, economic, biological, and engineered systems.
See all 160 papers