Fix alert flash RGB payload

Normalize alert flash colors to RGB lists so Home Assistant service validation accepts internally triggered visual alerts. Add regression coverage for the flash payload shape and document the fix in the changelog.

Author: senyo888

CHANGELOG.md

@@ -6,6 +6,7 @@ This project follows a practical changelog format for Home Assistant and HACS us
 
 ## Unreleased
 
+- Fixed alert flash color payloads so internally triggered visual alerts send RGB lists accepted by Home Assistant service validation.
 - Added user-friendly headers to V2 card YAML exports with Manual-card paste instructions, `dump_cards` refresh guidance, and frontend dependency reminders.
 - Fixed alert flash payloads so optional visual-indicator power entities are omitted when unset, avoiding schema errors and repeated debug logs.
 - Refined Air Control UI chips so AQ and humidity rows use House, Upstairs, Downstairs ordering and removed the Kitchen temperature-slope chip from the humidity row.

automations/engine.py

@@ -492,7 +492,7 @@ async def _handle_alerts(self) -> Tuple[bool, List[Dict[str, Any]]]:
             try:
                 flash_payload = {
                     "lights": lights,
-                    "color": (255, 0, 0) if alert.get("flash_mode") == "red" else (255, 255, 255),
+                    "color": [255, 0, 0] if alert.get("flash_mode") == "red" else [255, 255, 255],
                     "duration": alert.get("duration", 10),
                 }
                 power_entity = alert.get("power_entity")

services.py

@@ -106,10 +106,25 @@ def _validate_dashboard_url_path(value: str) -> str:
     return text
 
 
+def _validate_rgb_color(value) -> List[int]:
+    """Accept service/YAML RGB colors and normalize them to a plain list."""
+    if isinstance(value, tuple):
+        values = list(value)
+    else:
+        values = cv.ensure_list(value)
+    values = [vol.Coerce(int)(item) for item in values]
+    if len(values) < 3:
+        raise vol.Invalid("RGB color must include red, green, and blue values")
+    for item in values[:3]:
+        if item < 0 or item > 255:
+            raise vol.Invalid("RGB color values must be between 0 and 255")
+    return values[:3]
+
+
 SERVICE_FLASH_SCHEMA = vol.Schema({
     vol.Optional("power_entity"): cv.entity_id,
     vol.Optional("lights", default=[]): cv.entity_ids,
-    vol.Optional("color", default=(255, 0, 0)): vol.All(cv.ensure_list, [vol.Coerce(int)]),
+    vol.Optional("color", default=[255, 0, 0]): _validate_rgb_color,
     vol.Optional("duration", default=10): vol.All(vol.Coerce(int), vol.Range(min=1, max=300)),
     vol.Optional("flash_count", default=None): vol.Any(
         None,

tests 2/test_runtime_card_sanity.py

@@ -825,6 +825,12 @@ async def _run_runtime_assertions(engine_mod) -> None:
     ]
     assert dynamic_flash_calls
     assert all("power_entity" not in data for data in dynamic_flash_calls)
+    assert all(isinstance(data.get("color"), list) for data in dynamic_flash_calls)
+    assert all(len(data.get("color")) == 3 for data in dynamic_flash_calls)
+    assert all(
+        all(isinstance(channel, int) for channel in data.get("color"))
+        for data in dynamic_flash_calls
+    )
 
     # Alerts without target lights should still activate runtime alert mode,
     # but skip light flash service calls cleanly.