Appendix D: Model Library Catalog

The SDK ships with 23 reference models spanning 10 domains. Each model includes model.py, config.json, settings.json, a gold-standard PDF report, and an output/ directory with pre-generated results. Models are located in examples/models/.

Financial Markets (7 models)

Model	Agents	Agent Types	Key Mechanisms	SDK Features Used
chiarella_market	101	Fundamentalist, Chartist, Noise, MarketMaker	Mean-reversion vs trend-following, linear price impact, noise perturbation	Sequence, PriceBroadcast messages, directed links per trader type
chiarella_llm	101	Fundamentalist, LLMTrader, Noise, MarketMaker	Same as chiarella_market but chartists replaced by HybridAgent LLM traders	HybridAgent, MockLLMBackend, ResponseCache, llm_probability
volatility_market	201	Trader, Market	Strategy switching between fundamentalist and chartist modes, endogenous volatility	Sequence, adaptive agent state, regime switching
cda_market	102	Buyer, Seller, Market	Continuous double auction with limit order book, price discovery	Sequence (multi-phase), order matching logic, bid/ask spread
trading	201	Trader, Exchange	Information cascades, threshold-based strategy adaptation, volume dynamics	Sequence, heterogeneous thresholds, adaptive learning
tokyo_banks	100	LargeBank, SmallBank	Heterogeneous signal weighting, fire-sale externalities, liquidity spirals	scale_free topology, heterogeneous agent types, contagion
llm_trading	varies	RuleTrader, LLMTrader, MarketMaker	LLM vs rule-based strategy comparison, momentum/contrarian strategies, price impact	HybridAgent, Links, AWS Bedrock, MockLLMBackend

Systemic Risk (2 models)

Model	Agents	Agent Types	Key Mechanisms	SDK Features Used
gai_kapadia	100	Bank	Threshold contagion on scale-free network, heterogeneous cash buffers	scale_free topology, broadcast(), threshold dynamics, buffer_heterogeneity
counterparty_credit	51	Bank, CCP	Bilateral interbank exposures, central counterparty clearing, collateral thresholds	NetworkSpace, multiple link types, bilateral vs CCP clearing comparison

Consumer Finance (2 models)

Model	Agents	Agent Types	Key Mechanisms	SDK Features Used
credit_card	202	Household, CreditCardProvider	Utility-based balance split, Delta Learning rate adaptation, BoE consumption model, reward programme	Bipartite links (4 types), 4 message types, multi-phase Sequence, empirical income distribution
mortgage	201	Household, Bank	LTI/LTV regulatory constraints, income shocks, foreclosure dynamics	Sequence, regulatory thresholds, heterogeneous income

Market Integrity (1 model)

Model	Agents	Agent Types	Key Mechanisms	SDK Features Used
market_surveillance	91	HonestTrader, Manipulator, Surveillor, Market	Spoofing, layering, wash trading strategies; statistical detection algorithms	Multiple agent types, detection thresholds, strategy classification

Insurance (1 model)

Model	Agents	Agent Types	Key Mechanisms	SDK Features Used
insurance_claims	206	Policyholder, Insurer, Reinsurer	Two-tier insurance, reinsurance backstop, catastrophe events, premium adaptation	Multiple agent types, heterogeneous risk profiles, cascading claims

Operations (3 models)

Model	Agents	Agent Types	Key Mechanisms	SDK Features Used
supply_chain	20	Supplier, Manufacturer, Distributor, Retailer	Four-tier serial supply chain, bullwhip effect, (s, S) inventory policy, demand amplification	Sequence (tier-ordered), inventory dynamics, order amplification
supply_chain_v2	27	Supplier, Manufacturer, Distributor, Retailer	Four-tier logistics network, physically-grounded transit delays, safety-stock ordering, supply disruption	Sequence, Links, multi-supplier sourcing, scenario presets
supply_chain_v3	50+	Supplier, Manufacturer, Hub (T1/T2/T3), Retailer	Global supply chain with tiered distribution hubs, haversine-based transit, seasonal demand, dynamic pricing	Space2D, FieldLayer, GeoMap visualization, tiered hub cascading

Spatial Dynamics (4 models)

Model	Agents	Agent Types	Key Mechanisms	SDK Features Used
forest_fire	900	Cell	Spatial contagion on 30x30 grid, spontaneous ignition, percolation dynamics	GridSpace (Von Neumann), broadcast(), cell state transitions
schelling	300	BlueResident, RedResident	Segregation: agents relocate if same-type neighbour fraction < threshold	GridSpace (Moore), agent movement, get_empty_positions()
sir_grid	900	Cell	SIR epidemic on 30x30 grid with local transmission and recovery	GridSpace, spatial contagion, S/I/R state transitions
game_of_life	2,500	Cell	Conway's Game of Life with spontaneous mutation, aging, and nutrient field	GridSpace (Moore), toroidal wrap, cellular automaton, __color_map__

Epidemiology (1 model)

Model	Agents	Agent Types	Key Mechanisms	SDK Features Used
sir_network	100	Person	SIR epidemic on Watts-Strogatz small-world network with probabilistic transmission	NetworkSpace, small_world topology, transmission rate, recovery rate

Reference / Macro (1 model)

Model	Agents	Agent Types	Key Mechanisms	SDK Features Used
simple_economy	55	Worker, Firm, Government	Production, consumption, taxation, wage bargaining, unemployment	Multiple agent types, fully_connected topology, accumulator-heavy

Swarm Intelligence (1 model)

Model	Agents	Agent Types	Key Mechanisms	SDK Features Used
ant_colony	2000	Ant	Pheromone stigmergy, Weber-Fechner gradient following, two-pheromone bidirectional signalling, beacon emission	Space2D, FieldLayer, Space2DEnvironment, no links/messages, environment-as-mediator

Domain Coverage Summary

Domain	Models	Total Agent Types	SDK Features Exercised
Financial Markets	7	14	LLMAgent, HybridAgent, adaptive learning, price formation, LLM vs rule comparison
Systemic Risk	2	3	scale_free topology, threshold contagion, CCP clearing
Consumer Finance	2	4	Bipartite links, Delta Learning, regulatory constraints
Market Integrity	1	4	Detection algorithms, strategy classification
Insurance	1	3	Two-tier reinsurance, catastrophe events
Operations	3	10	Serial supply chain, bullwhip effect, Space2D logistics, tiered hub cascading, GeoMap
Spatial Dynamics	4	5	GridSpace (Von Neumann + Moore), movement, percolation, cellular automaton, __color_map__
Epidemiology	1	1	NetworkSpace, small_world, SIR compartments
Reference	1	3	Full SDK validation, multiple types + topology
Swarm Intelligence	1	1	Space2D, FieldLayer, pheromone, environment-as-mediator
Total	23	48