Summary

Adds a scenario property to the Agent class for convenient access to the model's scenario from within agent code.

Motivation

With the introduction of scenarios in #3103, agents frequently need to access scenario parameters. Currently, this requires writing self.model.scenario.parameter_name, which is verbose and inconsistent with how agents access random and rng.

Implementation

Adds a simple property that returns self.model.scenario, following the same pattern as the existing random and rng properties.

@property
def scenario(self):
    """Return the scenario associated with the model."""
    return self.model.scenario

Usage Example

# Before
def __init__(self, model):
    super().__init__(model)
    self.vision = self.model.scenario.citizen_vision
    self.legitimacy = self.model.scenario.legitimacy

# After
def __init__(self, model):
    super().__init__(model)
    self.vision = self.scenario.citizen_vision
    self.legitimacy = self.scenario.legitimacy

Additional Notes

• Maintains consistency with existing random and rng properties
• No breaking changes
• Improves code readability and developer experience