homeassistant 2025.9.4__py3-none-any.whl → 2025.10.0b1__py3-none-any.whl

homeassistant/components/openai_conversation/entity.py

@@ -7,7 +7,7 @@ from collections.abc import AsyncGenerator, Callable, Iterable
 import json
 from mimetypes import guess_file_type
 from pathlib import Path
-from typing import TYPE_CHECKING, Any, Literal
+from typing import TYPE_CHECKING, Any, Literal, cast
 
 import openai
 from openai._streaming import AsyncStream
@@ -37,14 +37,20 @@ from openai.types.responses import (
     ResponseReasoningSummaryTextDeltaEvent,
     ResponseStreamEvent,
     ResponseTextDeltaEvent,
+    ToolChoiceTypesParam,
     ToolParam,
     WebSearchToolParam,
 )
 from openai.types.responses.response_create_params import ResponseCreateParamsStreaming
-from openai.types.responses.response_input_param import FunctionCallOutput
+from openai.types.responses.response_input_param import (
+    FunctionCallOutput,
+    ImageGenerationCall as ImageGenerationCallParam,
+)
+from openai.types.responses.response_output_item import ImageGenerationCall
 from openai.types.responses.tool_param import (
     CodeInterpreter,
     CodeInterpreterContainerCodeInterpreterToolAuto,
+    ImageGeneration,
 )
 from openai.types.responses.web_search_tool_param import UserLocation
 import voluptuous as vol
@@ -54,7 +60,7 @@ from homeassistant.components import conversation
 from homeassistant.config_entries import ConfigSubentry
 from homeassistant.core import HomeAssistant
 from homeassistant.exceptions import HomeAssistantError
-from homeassistant.helpers import device_registry as dr, llm
+from homeassistant.helpers import device_registry as dr, issue_registry as ir, llm
 from homeassistant.helpers.entity import Entity
 from homeassistant.util import slugify
 
@@ -217,24 +223,30 @@ def _convert_content_to_param(
                     ResponseReasoningItemParam(
                         type="reasoning",
                         id=content.native.id,
-                        summary=[
-                            {
-                                "type": "summary_text",
-                                "text": summary,
-                            }
-                            for summary in reasoning_summary
-                        ]
-                        if content.thinking_content
-                        else [],
+                        summary=(
+                            [
+                                {
+                                    "type": "summary_text",
+                                    "text": summary,
+                                }
+                                for summary in reasoning_summary
+                            ]
+                            if content.thinking_content
+                            else []
+                        ),
                         encrypted_content=content.native.encrypted_content,
                     )
                 )
                 reasoning_summary = []
+            elif isinstance(content.native, ImageGenerationCall):
+                messages.append(
+                    cast(ImageGenerationCallParam, content.native.to_dict())
+                )
 
     return messages
 
 
-async def _transform_stream(
+async def _transform_stream(  # noqa: C901 - This is complex, but better to have it in one place
     chat_log: conversation.ChatLog,
     stream: AsyncStream[ResponseStreamEvent],
 ) -> AsyncGenerator[
@@ -298,9 +310,11 @@ async def _transform_stream(
                     "tool_call_id": event.item.id,
                     "tool_name": "code_interpreter",
                     "tool_result": {
-                        "output": [output.to_dict() for output in event.item.outputs]  # type: ignore[misc]
-                        if event.item.outputs is not None
-                        else None
+                        "output": (
+                            [output.to_dict() for output in event.item.outputs]  # type: ignore[misc]
+                            if event.item.outputs is not None
+                            else None
+                        )
                     },
                 }
                 last_role = "tool_result"
@@ -324,6 +338,9 @@ async def _transform_stream(
                     "tool_result": {"status": event.item.status},
                 }
                 last_role = "tool_result"
+            elif isinstance(event.item, ImageGenerationCall):
+                yield {"native": event.item}
+                last_summary_index = -1  # Trigger new assistant message on next turn
         elif isinstance(event, ResponseTextDeltaEvent):
             yield {"content": event.delta}
         elif isinstance(event, ResponseReasoningSummaryTextDeltaEvent):
@@ -429,6 +446,7 @@ class OpenAIBaseLLMEntity(Entity):
         chat_log: conversation.ChatLog,
         structure_name: str | None = None,
         structure: vol.Schema | None = None,
+        force_image: bool = False,
     ) -> None:
         """Generate an answer for the chat log."""
         options = self.subentry.data
@@ -495,6 +513,17 @@ class OpenAIBaseLLMEntity(Entity):
             )
             model_args.setdefault("include", []).append("code_interpreter_call.outputs")  # type: ignore[union-attr]
 
+        if force_image:
+            tools.append(
+                ImageGeneration(
+                    type="image_generation",
+                    input_fidelity="high",
+                    output_format="png",
+                )
+            )
+            model_args["tool_choice"] = ToolChoiceTypesParam(type="image_generation")
+            model_args["store"] = True  # Avoid sending image data back and forth
+
         if tools:
             model_args["tools"] = tools
 
@@ -504,7 +533,7 @@ class OpenAIBaseLLMEntity(Entity):
         if last_content.role == "user" and last_content.attachments:
             files = await async_prepare_files_for_prompt(
                 self.hass,
-                [a.path for a in last_content.attachments],
+                [(a.path, a.mime_type) for a in last_content.attachments],
             )
             last_message = messages[-1]
             assert (
@@ -553,6 +582,20 @@ class OpenAIBaseLLMEntity(Entity):
                 ):
                     LOGGER.error("Insufficient funds for OpenAI: %s", err)
                     raise HomeAssistantError("Insufficient funds for OpenAI") from err
+                if "Verify Organization" in str(err):
+                    ir.async_create_issue(
+                        self.hass,
+                        DOMAIN,
+                        "organization_verification_required",
+                        is_fixable=False,
+                        is_persistent=False,
+                        learn_more_url="https://help.openai.com/en/articles/10910291-api-organization-verification",
+                        severity=ir.IssueSeverity.WARNING,
+                        translation_key="organization_verification_required",
+                        translation_placeholders={
+                            "platform_settings": "https://platform.openai.com/settings/organization/general"
+                        },
+                    )
 
                 LOGGER.error("Error talking to OpenAI: %s", err)
                 raise HomeAssistantError("Error talking to OpenAI") from err
@@ -562,7 +605,7 @@ class OpenAIBaseLLMEntity(Entity):
 
 
 async def async_prepare_files_for_prompt(
-    hass: HomeAssistant, files: list[Path]
+    hass: HomeAssistant, files: list[tuple[Path, str | None]]
 ) -> ResponseInputMessageContentListParam:
     """Append files to a prompt.
 
@@ -572,11 +615,12 @@ async def async_prepare_files_for_prompt(
     def append_files_to_content() -> ResponseInputMessageContentListParam:
         content: ResponseInputMessageContentListParam = []
 
-        for file_path in files:
+        for file_path, mime_type in files:
             if not file_path.exists():
                 raise HomeAssistantError(f"`{file_path}` does not exist")
 
-            mime_type, _ = guess_file_type(file_path)
+            if mime_type is None:
+                mime_type = guess_file_type(file_path)[0]
 
             if not mime_type or not mime_type.startswith(("image/", "application/pdf")):
                 raise HomeAssistantError(

homeassistant/components/openai_conversation/manifest.json

@@ -2,7 +2,7 @@
   "domain": "openai_conversation",
   "name": "OpenAI",
   "after_dependencies": ["assist_pipeline", "intent"],
-  "codeowners": ["@balloob"],
+  "codeowners": [],
   "config_flow": true,
   "dependencies": ["conversation"],
   "documentation": "https://www.home-assistant.io/integrations/openai_conversation",

homeassistant/components/openai_conversation/strings.json

@@ -189,6 +189,12 @@
       }
     }
   },
+  "issues": {
+    "organization_verification_required": {
+      "title": "Organization verification required",
+      "description": "Your organization must be verified to use this model. Please go to {platform_settings} and select Verify Organization. If you just verified, it can take up to 15 minutes for access to propagate."
+    }
+  },
   "exceptions": {
     "invalid_config_entry": {
       "message": "Invalid config entry provided. Got {config_entry}"

homeassistant/components/openai_conversation/translations/cs.json

@@ -122,6 +122,12 @@
             "message": "Byla zad\u00e1na neplatn\u00e1 polo\u017eka nastaven\u00ed. M\u00e1m {config_entry}."
         }
     },
+    "issues": {
+        "organization_verification_required": {
+            "description": "Va\u0161e organizace mus\u00ed b\u00fdt pro pou\u017eit\u00ed tohoto modelu ov\u011b\u0159ena. P\u0159ejd\u011bte do {platform_settings} a vyberte volbu Ov\u011b\u0159it organizaci. Pokud jste ov\u011b\u0159ili pr\u00e1v\u011b te\u010f, m\u016f\u017ee trvat a\u017e 15 minut, ne\u017e se p\u0159\u00edstup roz\u0161\u00ed\u0159\u00ed.",
+            "title": "Vy\u017eadov\u00e1no ov\u011b\u0159en\u00ed organizace"
+        }
+    },
     "selector": {
         "reasoning_effort": {
             "options": {

homeassistant/components/openai_conversation/translations/de.json

@@ -122,6 +122,12 @@
             "message": "Ung\u00fcltiger Konfigurationseintrag angegeben. {config_entry} erhalten."
         }
     },
+    "issues": {
+        "organization_verification_required": {
+            "description": "Um dieses Modell verwenden zu k\u00f6nnen, muss deine Organisation verifiziert sein. Gehe zu {platform_settings} und w\u00e4hle \u201eOrganisation verifizieren\u201c. Wenn du die Verifizierung gerade erst durchgef\u00fchrt hast, kann es bis zu 15 Minuten dauern, bis der Zugriff freigegeben wird.",
+            "title": "Verifizierung der Organisation erforderlich"
+        }
+    },
     "selector": {
         "reasoning_effort": {
             "options": {

homeassistant/components/openai_conversation/translations/en-GB.json

@@ -122,6 +122,12 @@
             "message": "Invalid config entry provided. Got {config_entry}"
         }
     },
+    "issues": {
+        "organization_verification_required": {
+            "description": "Your organisation must be verified to use this model. Please go to {platform_settings} and select Verify Organisation. If you just verified, it can take up to 15 minutes for access to propagate.",
+            "title": "Organisation verification required"
+        }
+    },
     "selector": {
         "reasoning_effort": {
             "options": {

homeassistant/components/openai_conversation/translations/en.json

@@ -122,6 +122,12 @@
             "message": "Invalid config entry provided. Got {config_entry}"
         }
     },
+    "issues": {
+        "organization_verification_required": {
+            "description": "Your organization must be verified to use this model. Please go to {platform_settings} and select Verify Organization. If you just verified, it can take up to 15 minutes for access to propagate.",
+            "title": "Organization verification required"
+        }
+    },
     "selector": {
         "reasoning_effort": {
             "options": {

homeassistant/components/openai_conversation/translations/es.json

@@ -122,6 +122,12 @@
             "message": "Se proporcion\u00f3 una entrada de configuraci\u00f3n no v\u00e1lida. Se obtuvo {config_entry}"
         }
     },
+    "issues": {
+        "organization_verification_required": {
+            "description": "Tu organizaci\u00f3n debe estar verificada para usar este modelo. Ve a {platform_settings} y selecciona Verificar organizaci\u00f3n. Si acabas de verificar, el acceso puede tardar hasta 15 minutos en propagarse.",
+            "title": "Se requiere verificaci\u00f3n de la organizaci\u00f3n"
+        }
+    },
     "selector": {
         "reasoning_effort": {
             "options": {

homeassistant/components/openai_conversation/translations/et.json

@@ -122,6 +122,12 @@
             "message": "Esitatud on vigane seadekanne. Saadi {config_entry}."
         }
     },
+    "issues": {
+        "organization_verification_required": {
+            "description": "Selle mudeli kasutamiseks peab organisatsioon olema kinnitatud. Mine aadressile {platform_settings} ja vali Kinnita organisatsioon. Kui oled just kinnitanud, v\u00f5ib juurdep\u00e4\u00e4su levitamiseks kuluda kuni 15 minutit.",
+            "title": "Organisatsiooni kinnitus on vajalik"
+        }
+    },
     "selector": {
         "reasoning_effort": {
             "options": {

homeassistant/components/openai_conversation/translations/fr.json

@@ -122,6 +122,12 @@
             "message": "Entr\u00e9e de configuration non valide fournie. Re\u00e7u {config_entry}"
         }
     },
+    "issues": {
+        "organization_verification_required": {
+            "description": "Votre organisation doit \u00eatre v\u00e9rifi\u00e9e pour utiliser ce mod\u00e8le. Acc\u00e9dez \u00e0 {platform_settings} et s\u00e9lectionnez Verify Organization. Si vous venez de v\u00e9rifier, la propagation de l'acc\u00e8s peut prendre jusqu'\u00e0 15\u00a0minutes.",
+            "title": "V\u00e9rification de l'organisation requise"
+        }
+    },
     "selector": {
         "reasoning_effort": {
             "options": {

homeassistant/components/openai_conversation/translations/ga.json

@@ -116,6 +116,12 @@
             "message": "Iontr\u00e1il chumra\u00edochta neamhbhail\u00ed curtha ar f\u00e1il. Fuarthas {config_entry}"
         }
     },
+    "issues": {
+        "organization_verification_required": {
+            "description": "N\u00ed m\u00f3r d\u2019eagra\u00edocht a fh\u00edor\u00fa chun an tsamhail seo a \u00fas\u00e1id. T\u00e9igh go {platform_settings} agus roghnaigh F\u00edoraigh Eagra\u00edocht. M\u00e1 rinne t\u00fa f\u00edor\u00fa d\u00edreach, f\u00e9adfaidh s\u00e9 suas le 15 n\u00f3im\u00e9ad a th\u00f3g\u00e1il chun rochtain a scaipeadh.",
+            "title": "F\u00edor\u00fa eagra\u00edochta ag teast\u00e1il"
+        }
+    },
     "selector": {
         "reasoning_effort": {
             "options": {

homeassistant/components/openai_conversation/translations/lt.json

@@ -122,6 +122,12 @@
             "message": "Pateiktas neteisingas konfig\u016bracijos \u012fra\u0161as. Gauta {config_entry}"
         }
     },
+    "issues": {
+        "organization_verification_required": {
+            "description": "J\u016bs\u0173 organizacija turi b\u016bti patvirtinta, kad gal\u0117tum\u0117te naudoti \u0161\u012f model\u012f. Eikite \u012f {platform_settings} ir pasirinkite Patvirtinti organizacij\u0105. Jei k\u0105 tik patvirtinote, prieigos suteikimas gali u\u017etrukti iki 15 minu\u010di\u0173.",
+            "title": "Reikalingas organizacijos patvirtinimas"
+        }
+    },
     "selector": {
         "reasoning_effort": {
             "options": {

homeassistant/components/openai_conversation/translations/pt.json

@@ -122,6 +122,12 @@
             "message": "Entrada de configura\u00e7\u00e3o inv\u00e1lida fornecida. Recebido {config_entry}."
         }
     },
+    "issues": {
+        "organization_verification_required": {
+            "description": "A sua organiza\u00e7\u00e3o tem de ser verificada para utilizar este modelo. V\u00e1 para {platform_settings} e selecione Verificar organiza\u00e7\u00e3o. Se acabou de efetuar a verifica\u00e7\u00e3o, pode demorar at\u00e9 15 minutos para que o acesso seja propagado.",
+            "title": "\u00c9 necess\u00e1ria verifica\u00e7\u00e3o da organiza\u00e7\u00e3o"
+        }
+    },
     "selector": {
         "reasoning_effort": {
             "options": {

homeassistant/components/openai_conversation/translations/sk.json

@@ -122,6 +122,12 @@
             "message": "Zadan\u00e1 neplatn\u00e1 konfigura\u010dn\u00e1 polo\u017eka. M\u00e1m {config_entry}"
         }
     },
+    "issues": {
+        "organization_verification_required": {
+            "description": "Va\u0161a organiz\u00e1cia mus\u00ed by\u0165 overen\u00e1, aby mohla pou\u017e\u00edva\u0165 tento model. Prejdite na str\u00e1nku {platform_settings} a vyberte polo\u017eku Overi\u0165 organiz\u00e1ciu. Ak ste pr\u00e1ve overili, propag\u00e1cia pr\u00edstupu m\u00f4\u017ee trva\u0165 a\u017e 15 min\u00fat.",
+            "title": "Po\u017eadovan\u00e9 overenie organiz\u00e1cie"
+        }
+    },
     "selector": {
         "reasoning_effort": {
             "options": {

homeassistant/components/openai_conversation/translations/zh-Hans.json

@@ -122,6 +122,12 @@
             "message": "\u63d0\u4f9b\u7684\u914d\u7f6e\u6761\u76ee\u65e0\u6548\u3002\u73b0\u5728\u7684\u662f {config_entry}"
         }
     },
+    "issues": {
+        "organization_verification_required": {
+            "description": "\u60a8\u7684\u7ec4\u7ec7\u5fc5\u987b\u7ecf\u8fc7\u9a8c\u8bc1\u624d\u80fd\u4f7f\u7528\u6b64\u6a21\u578b\u3002\u8bf7\u524d\u5f80{platform_settings}\u5e76\u9009\u62e9\u201c\u9a8c\u8bc1\u7ec4\u7ec7\u201d\u3002\u5982\u679c\u60a8\u521a\u521a\u9a8c\u8bc1\uff0c\u8bbf\u95ee\u6743\u9650\u6700\u591a\u53ef\u80fd\u9700\u8981 15 \u5206\u949f\u624d\u80fd\u751f\u6548\u3002",
+            "title": "\u9700\u8981\u7ec4\u7ec7\u9a8c\u8bc1"
+        }
+    },
     "selector": {
         "reasoning_effort": {
             "options": {

homeassistant/components/openai_conversation/translations/zh-Hant.json

@@ -122,6 +122,12 @@
             "message": "\u6240\u63d0\u4f9b\u7684\u8a2d\u5b9a\u689d\u76ee\u7121\u6548\u3002\u53d6\u5f97 {config_entry}"
         }
     },
+    "issues": {
+        "organization_verification_required": {
+            "description": "\u60a8\u7684\u7d44\u7e54\u5fc5\u9808\u7d93\u904e\u9a57\u8b49\u624d\u80fd\u4f7f\u7528\u6b64\u6a21\u578b\u3002\u8acb\u524d\u5f80 {platform_settings} \u4e26\u9078\u64c7\u300c\u9a57\u8b49\u7d44\u7e54\u300d\u3002\u5047\u5982\u525b\u5b8c\u6210\u9a57\u8b49\uff0c\u5b58\u53d6\u6b0a\u9650\u53ef\u80fd\u9700\u8981\u6700\u591a 15 \u5206\u9418\u624d\u80fd\u751f\u6548\u3002",
+            "title": "\u9700\u8981\u7d44\u7e54\u9a57\u8b49"
+        }
+    },
     "selector": {
         "reasoning_effort": {
             "options": {

homeassistant/components/openuv/__init__.py

@@ -30,7 +30,7 @@ from .const import (
     DOMAIN,
     LOGGER,
 )
-from .coordinator import OpenUvCoordinator
+from .coordinator import OpenUvCoordinator, OpenUvProtectionWindowCoordinator
 
 PLATFORMS = [Platform.BINARY_SENSOR, Platform.SENSOR]
 
@@ -54,7 +54,7 @@ async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
         return await client.uv_protection_window(low=low, high=high)
 
     coordinators: dict[str, OpenUvCoordinator] = {
-        coordinator_name: OpenUvCoordinator(
+        coordinator_name: coordinator_cls(
             hass,
             entry=entry,
             name=coordinator_name,
@@ -62,9 +62,13 @@ async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
             longitude=client.longitude,
             update_method=update_method,
         )
-        for coordinator_name, update_method in (
-            (DATA_UV, client.uv_index),
-            (DATA_PROTECTION_WINDOW, async_update_protection_data),
+        for coordinator_cls, coordinator_name, update_method in (
+            (OpenUvCoordinator, DATA_UV, client.uv_index),
+            (
+                OpenUvProtectionWindowCoordinator,
+                DATA_PROTECTION_WINDOW,
+                async_update_protection_data,
+            ),
         )
     }
 

homeassistant/components/openuv/binary_sensor.py

@@ -7,7 +7,7 @@ from homeassistant.components.binary_sensor import (
 from homeassistant.config_entries import ConfigEntry
 from homeassistant.core import HomeAssistant, callback
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback
-from homeassistant.util.dt import as_local, parse_datetime, utcnow
+from homeassistant.util.dt import as_local
 
 from .const import DATA_PROTECTION_WINDOW, DOMAIN, LOGGER, TYPE_PROTECTION_WINDOW
 from .coordinator import OpenUvCoordinator
@@ -55,30 +55,27 @@ class OpenUvBinarySensor(OpenUvEntity, BinarySensorEntity):
     def _update_attrs(self) -> None:
         data = self.coordinator.data
 
-        for key in ("from_time", "to_time", "from_uv", "to_uv"):
-            if not data.get(key):
-                LOGGER.warning("Skipping update due to missing data: %s", key)
-                return
+        if not data:
+            LOGGER.warning("Skipping update due to missing data")
+            return
 
         if self.entity_description.key == TYPE_PROTECTION_WINDOW:
-            from_dt = parse_datetime(data["from_time"])
-            to_dt = parse_datetime(data["to_time"])
-
-            if not from_dt or not to_dt:
-                LOGGER.warning(
-                    "Unable to parse protection window datetimes: %s, %s",
-                    data["from_time"],
-                    data["to_time"],
-                )
-                self._attr_is_on = False
-                return
-
-            self._attr_is_on = from_dt <= utcnow() <= to_dt
+            self._attr_is_on = data.get("is_on", False)
+            self._attr_extra_state_attributes.update(
+                {
+                    attr_key: data[data_key]
+                    for attr_key, data_key in (
+                        (ATTR_PROTECTION_WINDOW_STARTING_UV, "from_uv"),
+                        (ATTR_PROTECTION_WINDOW_ENDING_UV, "to_uv"),
+                    )
+                }
+            )
             self._attr_extra_state_attributes.update(
                 {
-                    ATTR_PROTECTION_WINDOW_ENDING_TIME: as_local(to_dt),
-                    ATTR_PROTECTION_WINDOW_ENDING_UV: data["to_uv"],
-                    ATTR_PROTECTION_WINDOW_STARTING_UV: data["from_uv"],
-                    ATTR_PROTECTION_WINDOW_STARTING_TIME: as_local(from_dt),
+                    attr_key: as_local(data[data_key])
+                    for attr_key, data_key in (
+                        (ATTR_PROTECTION_WINDOW_STARTING_TIME, "from_time"),
+                        (ATTR_PROTECTION_WINDOW_ENDING_TIME, "to_time"),
+                    )
                 }
             )

homeassistant/components/openuv/coordinator.py

@@ -3,15 +3,18 @@
 from __future__ import annotations
 
 from collections.abc import Awaitable, Callable
+import datetime as dt
 from typing import Any, cast
 
 from pyopenuv.errors import InvalidApiKeyError, OpenUvError
 
 from homeassistant.config_entries import ConfigEntry
-from homeassistant.core import HomeAssistant
+from homeassistant.core import CALLBACK_TYPE, HomeAssistant, callback
 from homeassistant.exceptions import ConfigEntryAuthFailed
+from homeassistant.helpers import event as evt
 from homeassistant.helpers.debounce import Debouncer
 from homeassistant.helpers.update_coordinator import DataUpdateCoordinator, UpdateFailed
+from homeassistant.util.dt import parse_datetime, utcnow
 
 from .const import LOGGER
 
@@ -62,3 +65,90 @@ class OpenUvCoordinator(DataUpdateCoordinator[dict[str, Any]]):
             raise UpdateFailed(str(err)) from err
 
         return cast(dict[str, Any], data["result"])
+
+
+class OpenUvProtectionWindowCoordinator(OpenUvCoordinator):
+    """Define an OpenUV data coordinator for the protetction window."""
+
+    _reprocess_listener: CALLBACK_TYPE | None = None
+
+    async def _async_update_data(self) -> dict[str, Any]:
+        data = await super()._async_update_data()
+
+        for key in ("from_time", "to_time", "from_uv", "to_uv"):
+            if not data.get(key):
+                msg = "Skipping update due to missing data: {key}"
+                raise UpdateFailed(msg)
+
+        data = self._parse_data(data)
+        data = self._process_data(data)
+
+        self._schedule_reprocessing(data)
+
+        return data
+
+    def _parse_data(self, data: dict[str, Any]) -> dict[str, Any]:
+        """Parse & update datetime values in data."""
+
+        from_dt = parse_datetime(data["from_time"])
+        to_dt = parse_datetime(data["to_time"])
+
+        if not from_dt or not to_dt:
+            LOGGER.warning(
+                "Unable to parse protection window datetimes: %s, %s",
+                data["from_time"],
+                data["to_time"],
+            )
+            return {}
+
+        return {**data, "from_time": from_dt, "to_time": to_dt}
+
+    def _process_data(self, data: dict[str, Any]) -> dict[str, Any]:
+        """Process data for consumption by entities.
+
+        Adds the `is_on` key to the resulting data.
+        """
+        if not {"from_time", "to_time"}.issubset(data):
+            return {}
+
+        return {**data, "is_on": data["from_time"] <= utcnow() <= data["to_time"]}
+
+    def _schedule_reprocessing(self, data: dict[str, Any]) -> None:
+        """Schedule reprocessing of data."""
+
+        if not {"from_time", "to_time"}.issubset(data):
+            return
+
+        now = utcnow()
+        from_dt = data["from_time"]
+        to_dt = data["to_time"]
+        reprocess_at: dt.datetime | None = None
+
+        if from_dt and from_dt > now:
+            reprocess_at = from_dt
+        if to_dt and to_dt > now:
+            reprocess_at = to_dt if not reprocess_at else min(to_dt, reprocess_at)
+
+        if reprocess_at:
+            self._async_cancel_reprocess_listener()
+            self._reprocess_listener = evt.async_track_point_in_utc_time(
+                self.hass,
+                self._async_handle_reprocess_event,
+                reprocess_at,
+            )
+
+    def _async_cancel_reprocess_listener(self) -> None:
+        """Cancel the reprocess event listener."""
+        if self._reprocess_listener:
+            self._reprocess_listener()
+            self._reprocess_listener = None
+
+    @callback
+    def _async_handle_reprocess_event(self, now: dt.datetime) -> None:
+        """Timer callback for reprocessing the data & updating listeners."""
+        self._async_cancel_reprocess_listener()
+
+        self.data = self._process_data(self.data)
+        self._schedule_reprocessing(self.data)
+
+        self.async_update_listeners()