Expose exclusion_bounds through PowerManager reporting streams

Signed-off-by: Sahas Subramanian <[email protected]>

Author: shsms

src/frequenz/sdk/actor/_power_managing/_base_classes.py

@@ -55,6 +55,16 @@ class Report:
     priorities.
     """
 
+    exclusion_bounds: timeseries.Bounds[Power] | None
+    """The exclusion bounds for the batteries.
+
+    The power manager doesn't manage exclusion bounds, so these are aggregations of
+    values reported by the microgrid API.
+
+    These bounds are adjusted to any restrictions placed by actors with higher
+    priorities.
+    """
+
 
 @dataclasses.dataclass(frozen=True)
 class Proposal:

src/frequenz/sdk/actor/_power_managing/_matryoshka.py

@@ -155,7 +155,7 @@ def get_status(
         """
         target_power = self._target_power.get(battery_ids)
         if system_bounds.inclusion_bounds is None:
-            return Report(target_power, None)
+            return Report(target_power, None, system_bounds.exclusion_bounds)
 
         lower_bound = system_bounds.inclusion_bounds.lower
         upper_bound = system_bounds.inclusion_bounds.upper
@@ -177,4 +177,5 @@ def get_status(
             inclusion_bounds=timeseries.Bounds[Power](
                 lower=lower_bound, upper=upper_bound
             ),
+            exclusion_bounds=system_bounds.exclusion_bounds,
         )

tests/timeseries/_battery_pool/test_battery_pool_control_methods.py

@@ -145,6 +145,10 @@ def _make_report(
                 lower=Power.from_watts(lower),
                 upper=Power.from_watts(upper),
             ),
+            exclusion_bounds=timeseries.Bounds(
+                lower=Power.from_watts(0.0),
+                upper=Power.from_watts(0.0),
+            ),
         )
 
     async def test_case_1(