homeassistant-stubs 2025.1.3__py3-none-any.whl → 2025.2.0__py3-none-any.whl

homeassistant-stubs/auth/mfa_modules/__init__.pyi

@@ -9,14 +9,12 @@ from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.helpers.importlib import async_import_module as async_import_module
 from homeassistant.util.decorator import Registry as Registry
 from homeassistant.util.hass_dict import HassKey as HassKey
-from typing import Any, Generic
-from typing_extensions import TypeVar
+from typing import Any
 
 MULTI_FACTOR_AUTH_MODULES: Registry[str, type[MultiFactorAuthModule]]
 MULTI_FACTOR_AUTH_MODULE_SCHEMA: Incomplete
 DATA_REQS: HassKey[set[str]]
 _LOGGER: Incomplete
-_MultiFactorAuthModuleT = TypeVar('_MultiFactorAuthModuleT', bound='MultiFactorAuthModule', default='MultiFactorAuthModule')
 
 class MultiFactorAuthModule:
     DEFAULT_TITLE: str
@@ -38,7 +36,7 @@ class MultiFactorAuthModule:
     async def async_is_user_setup(self, user_id: str) -> bool: ...
     async def async_validate(self, user_id: str, user_input: dict[str, Any]) -> bool: ...
 
-class SetupFlow(data_entry_flow.FlowHandler, Generic[_MultiFactorAuthModuleT]):
+class SetupFlow[_MultiFactorAuthModuleT: MultiFactorAuthModule = MultiFactorAuthModule](data_entry_flow.FlowHandler):
     _auth_module: Incomplete
     _setup_schema: Incomplete
     _user_id: Incomplete

homeassistant-stubs/auth/models.pyi

@@ -5,7 +5,7 @@ from datetime import datetime, timedelta
 from homeassistant.const import __version__ as __version__
 from homeassistant.data_entry_flow import FlowContext as FlowContext, FlowResult as FlowResult
 from ipaddress import IPv4Address, IPv6Address
-from propcache import cached_property
+from propcache.api import cached_property
 from typing import Any, NamedTuple
 
 TOKEN_TYPE_NORMAL: str

homeassistant-stubs/auth/permissions/__init__.pyi

@@ -4,7 +4,7 @@ from .types import PolicyType as PolicyType
 from _typeshed import Incomplete
 from collections.abc import Callable
 
-__all__ = ['POLICY_SCHEMA', 'merge_policies', 'PermissionLookup', 'PolicyType', 'AbstractPermissions', 'PolicyPermissions', 'OwnerPermissions']
+__all__ = ['POLICY_SCHEMA', 'AbstractPermissions', 'OwnerPermissions', 'PermissionLookup', 'PolicyPermissions', 'PolicyType', 'merge_policies']
 
 POLICY_SCHEMA: Incomplete
 

homeassistant-stubs/auth/providers/__init__.pyi

@@ -12,14 +12,12 @@ from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.helpers.importlib import async_import_module as async_import_module
 from homeassistant.util.decorator import Registry as Registry
 from homeassistant.util.hass_dict import HassKey as HassKey
-from typing import Any, Generic
-from typing_extensions import TypeVar
+from typing import Any
 
 _LOGGER: Incomplete
 DATA_REQS: HassKey[set[str]]
 AUTH_PROVIDERS: Registry[str, type[AuthProvider]]
 AUTH_PROVIDER_SCHEMA: Incomplete
-_AuthProviderT = TypeVar('_AuthProviderT', bound='AuthProvider', default='AuthProvider')
 
 class AuthProvider:
     DEFAULT_TITLE: str
@@ -48,7 +46,7 @@ class AuthProvider:
 async def auth_provider_from_config(hass: HomeAssistant, store: AuthStore, config: dict[str, Any]) -> AuthProvider: ...
 async def load_auth_provider_module(hass: HomeAssistant, provider: str) -> types.ModuleType: ...
 
-class LoginFlow(FlowHandler[AuthFlowContext, AuthFlowResult, tuple[str, str]], Generic[_AuthProviderT]):
+class LoginFlow[_AuthProviderT: AuthProvider = AuthProvider](FlowHandler[AuthFlowContext, AuthFlowResult, tuple[str, str]]):
     _flow_result = AuthFlowResult
     _auth_provider: Incomplete
     _auth_module_id: str | None

homeassistant-stubs/backup_restore.pyi

@@ -4,6 +4,7 @@ from dataclasses import dataclass
 from pathlib import Path
 
 RESTORE_BACKUP_FILE: str
+RESTORE_BACKUP_RESULT_FILE: str
 KEEP_BACKUPS: Incomplete
 KEEP_DATABASE: Incomplete
 _LOGGER: Incomplete
@@ -20,4 +21,5 @@ def password_to_key(password: str) -> bytes: ...
 def restore_backup_file_content(config_dir: Path) -> RestoreBackupFileContent | None: ...
 def _clear_configuration_directory(config_dir: Path, keep: Iterable[str]) -> None: ...
 def _extract_backup(config_dir: Path, restore_content: RestoreBackupFileContent) -> None: ...
+def _write_restore_result_file(config_dir: Path, success: bool, error: Exception | None) -> None: ...
 def restore_backup(config_dir_path: str) -> bool: ...

homeassistant-stubs/components/airgradient/button.pyi

@@ -1,7 +1,7 @@
 from . import AirGradientConfigEntry as AirGradientConfigEntry
 from .const import DOMAIN as DOMAIN
 from .coordinator import AirGradientCoordinator as AirGradientCoordinator
-from .entity import AirGradientEntity as AirGradientEntity
+from .entity import AirGradientEntity as AirGradientEntity, exception_handler as exception_handler
 from _typeshed import Incomplete
 from airgradient import AirGradientClient as AirGradientClient
 from collections.abc import Awaitable, Callable as Callable
@@ -11,6 +11,8 @@ from homeassistant.const import EntityCategory as EntityCategory
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 
+PARALLEL_UPDATES: int
+
 @dataclass(frozen=True, kw_only=True)
 class AirGradientButtonEntityDescription(ButtonEntityDescription):
     press_fn: Callable[[AirGradientClient], Awaitable[None]]
@@ -24,4 +26,5 @@ class AirGradientButton(AirGradientEntity, ButtonEntity):
     entity_description: AirGradientButtonEntityDescription
     _attr_unique_id: Incomplete
     def __init__(self, coordinator: AirGradientCoordinator, description: AirGradientButtonEntityDescription) -> None: ...
+    @exception_handler
     async def async_press(self) -> None: ...

homeassistant-stubs/components/airgradient/config_flow.pyi

@@ -1,10 +1,11 @@
 from .const import DOMAIN as DOMAIN
 from _typeshed import Incomplete
 from airgradient import AirGradientClient
-from homeassistant.components import zeroconf as zeroconf
-from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult
+from collections.abc import Mapping
+from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult, SOURCE_RECONFIGURE as SOURCE_RECONFIGURE, SOURCE_USER as SOURCE_USER
 from homeassistant.const import CONF_HOST as CONF_HOST, CONF_MODEL as CONF_MODEL
 from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
+from homeassistant.helpers.service_info.zeroconf import ZeroconfServiceInfo as ZeroconfServiceInfo
 from typing import Any
 
 MIN_VERSION: Incomplete
@@ -14,6 +15,7 @@ class AirGradientConfigFlow(ConfigFlow, domain=DOMAIN):
     client: AirGradientClient | None
     def __init__(self) -> None: ...
     async def set_configuration_source(self) -> None: ...
-    async def async_step_zeroconf(self, discovery_info: zeroconf.ZeroconfServiceInfo) -> ConfigFlowResult: ...
+    async def async_step_zeroconf(self, discovery_info: ZeroconfServiceInfo) -> ConfigFlowResult: ...
     async def async_step_discovery_confirm(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def async_step_reconfigure(self, user_input: Mapping[str, Any]) -> ConfigFlowResult: ...

homeassistant-stubs/components/airgradient/entity.pyi

@@ -1,10 +1,15 @@
 from .const import DOMAIN as DOMAIN
 from .coordinator import AirGradientCoordinator as AirGradientCoordinator
 from _typeshed import Incomplete
+from collections.abc import Callable as Callable, Coroutine
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.helpers.device_registry import DeviceInfo as DeviceInfo
 from homeassistant.helpers.update_coordinator import CoordinatorEntity as CoordinatorEntity
+from typing import Any, Concatenate
 
 class AirGradientEntity(CoordinatorEntity[AirGradientCoordinator]):
     _attr_has_entity_name: bool
     _attr_device_info: Incomplete
     def __init__(self, coordinator: AirGradientCoordinator) -> None: ...
+
+def exception_handler[_EntityT: AirGradientEntity, **_P](func: Callable[Concatenate[_EntityT, _P], Coroutine[Any, Any, Any]]) -> Callable[Concatenate[_EntityT, _P], Coroutine[Any, Any, None]]: ...

homeassistant-stubs/components/airgradient/number.pyi

@@ -1,7 +1,7 @@
 from . import AirGradientConfigEntry as AirGradientConfigEntry
 from .const import DOMAIN as DOMAIN
 from .coordinator import AirGradientCoordinator as AirGradientCoordinator
-from .entity import AirGradientEntity as AirGradientEntity
+from .entity import AirGradientEntity as AirGradientEntity, exception_handler as exception_handler
 from _typeshed import Incomplete
 from airgradient import AirGradientClient as AirGradientClient, Config as Config
 from collections.abc import Awaitable, Callable as Callable
@@ -11,6 +11,8 @@ from homeassistant.const import EntityCategory as EntityCategory, PERCENTAGE as
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 
+PARALLEL_UPDATES: int
+
 @dataclass(frozen=True, kw_only=True)
 class AirGradientNumberEntityDescription(NumberEntityDescription):
     value_fn: Callable[[Config], int]
@@ -27,4 +29,5 @@ class AirGradientNumber(AirGradientEntity, NumberEntity):
     def __init__(self, coordinator: AirGradientCoordinator, description: AirGradientNumberEntityDescription) -> None: ...
     @property
     def native_value(self) -> int | None: ...
+    @exception_handler
     async def async_set_native_value(self, value: float) -> None: ...

homeassistant-stubs/components/airgradient/select.pyi

@@ -1,7 +1,7 @@
 from . import AirGradientConfigEntry as AirGradientConfigEntry
 from .const import DOMAIN as DOMAIN, PM_STANDARD as PM_STANDARD, PM_STANDARD_REVERSE as PM_STANDARD_REVERSE
 from .coordinator import AirGradientCoordinator as AirGradientCoordinator
-from .entity import AirGradientEntity as AirGradientEntity
+from .entity import AirGradientEntity as AirGradientEntity, exception_handler as exception_handler
 from _typeshed import Incomplete
 from airgradient import AirGradientClient as AirGradientClient, Config as Config
 from collections.abc import Awaitable, Callable as Callable
@@ -11,6 +11,8 @@ from homeassistant.const import EntityCategory as EntityCategory
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 
+PARALLEL_UPDATES: int
+
 @dataclass(frozen=True, kw_only=True)
 class AirGradientSelectEntityDescription(SelectEntityDescription):
     value_fn: Callable[[Config], str | None]
@@ -34,4 +36,5 @@ class AirGradientSelect(AirGradientEntity, SelectEntity):
     def __init__(self, coordinator: AirGradientCoordinator, description: AirGradientSelectEntityDescription) -> None: ...
     @property
     def current_option(self) -> str | None: ...
+    @exception_handler
     async def async_select_option(self, option: str) -> None: ...

homeassistant-stubs/components/airgradient/sensor.pyi

@@ -13,6 +13,8 @@ from homeassistant.core import HomeAssistant as HomeAssistant, callback as callb
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 from homeassistant.helpers.typing import StateType as StateType
 
+PARALLEL_UPDATES: int
+
 @dataclass(frozen=True, kw_only=True)
 class AirGradientMeasurementSensorEntityDescription(SensorEntityDescription):
     value_fn: Callable[[Measures], StateType]

homeassistant-stubs/components/airgradient/switch.pyi

@@ -1,7 +1,7 @@
 from . import AirGradientConfigEntry as AirGradientConfigEntry
 from .const import DOMAIN as DOMAIN
 from .coordinator import AirGradientCoordinator as AirGradientCoordinator
-from .entity import AirGradientEntity as AirGradientEntity
+from .entity import AirGradientEntity as AirGradientEntity, exception_handler as exception_handler
 from _typeshed import Incomplete
 from airgradient import AirGradientClient as AirGradientClient, Config as Config
 from collections.abc import Awaitable, Callable as Callable
@@ -12,6 +12,8 @@ from homeassistant.core import HomeAssistant as HomeAssistant, callback as callb
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 from typing import Any
 
+PARALLEL_UPDATES: int
+
 @dataclass(frozen=True, kw_only=True)
 class AirGradientSwitchEntityDescription(SwitchEntityDescription):
     value_fn: Callable[[Config], bool]
@@ -27,5 +29,7 @@ class AirGradientSwitch(AirGradientEntity, SwitchEntity):
     def __init__(self, coordinator: AirGradientCoordinator, description: AirGradientSwitchEntityDescription) -> None: ...
     @property
     def is_on(self) -> bool: ...
+    @exception_handler
     async def async_turn_on(self, **kwargs: Any) -> None: ...
+    @exception_handler
     async def async_turn_off(self, **kwargs: Any) -> None: ...

homeassistant-stubs/components/airgradient/update.pyi

@@ -4,8 +4,9 @@ from _typeshed import Incomplete
 from homeassistant.components.update import UpdateDeviceClass as UpdateDeviceClass, UpdateEntity as UpdateEntity
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
-from propcache import cached_property
+from propcache.api import cached_property
 
+PARALLEL_UPDATES: int
 SCAN_INTERVAL: Incomplete
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: AirGradientConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...

homeassistant-stubs/components/airnow/coordinator.pyi

@@ -1,4 +1,4 @@
-from .const import ATTR_API_AQI as ATTR_API_AQI, ATTR_API_AQI_DESCRIPTION as ATTR_API_AQI_DESCRIPTION, ATTR_API_AQI_LEVEL as ATTR_API_AQI_LEVEL, ATTR_API_AQI_PARAM as ATTR_API_AQI_PARAM, ATTR_API_CATEGORY as ATTR_API_CATEGORY, ATTR_API_CAT_DESCRIPTION as ATTR_API_CAT_DESCRIPTION, ATTR_API_CAT_LEVEL as ATTR_API_CAT_LEVEL, ATTR_API_PM25 as ATTR_API_PM25, ATTR_API_POLLUTANT as ATTR_API_POLLUTANT, ATTR_API_REPORT_DATE as ATTR_API_REPORT_DATE, ATTR_API_REPORT_HOUR as ATTR_API_REPORT_HOUR, ATTR_API_REPORT_TZ as ATTR_API_REPORT_TZ, ATTR_API_STATE as ATTR_API_STATE, ATTR_API_STATION as ATTR_API_STATION, ATTR_API_STATION_LATITUDE as ATTR_API_STATION_LATITUDE, ATTR_API_STATION_LONGITUDE as ATTR_API_STATION_LONGITUDE, DOMAIN as DOMAIN
+from .const import ATTR_API_AQI as ATTR_API_AQI, ATTR_API_AQI_DESCRIPTION as ATTR_API_AQI_DESCRIPTION, ATTR_API_AQI_LEVEL as ATTR_API_AQI_LEVEL, ATTR_API_AQI_PARAM as ATTR_API_AQI_PARAM, ATTR_API_CATEGORY as ATTR_API_CATEGORY, ATTR_API_CAT_DESCRIPTION as ATTR_API_CAT_DESCRIPTION, ATTR_API_CAT_LEVEL as ATTR_API_CAT_LEVEL, ATTR_API_POLLUTANT as ATTR_API_POLLUTANT, ATTR_API_REPORT_DATE as ATTR_API_REPORT_DATE, ATTR_API_REPORT_HOUR as ATTR_API_REPORT_HOUR, ATTR_API_REPORT_TZ as ATTR_API_REPORT_TZ, ATTR_API_STATE as ATTR_API_STATE, ATTR_API_STATION as ATTR_API_STATION, ATTR_API_STATION_LATITUDE as ATTR_API_STATION_LATITUDE, ATTR_API_STATION_LONGITUDE as ATTR_API_STATION_LONGITUDE, DOMAIN as DOMAIN
 from _typeshed import Incomplete
 from aiohttp import ClientSession as ClientSession
 from datetime import timedelta

homeassistant-stubs/components/airzone/__init__.pyi

@@ -1,3 +1,4 @@
+from .const import DOMAIN as DOMAIN, MANUFACTURER as MANUFACTURER
 from .coordinator import AirzoneUpdateCoordinator as AirzoneUpdateCoordinator
 from _typeshed import Incomplete
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
@@ -12,3 +13,4 @@ type AirzoneConfigEntry = ConfigEntry[AirzoneUpdateCoordinator]
 async def _async_migrate_unique_ids(hass: HomeAssistant, entry: AirzoneConfigEntry, coordinator: AirzoneUpdateCoordinator) -> None: ...
 async def async_setup_entry(hass: HomeAssistant, entry: AirzoneConfigEntry) -> bool: ...
 async def async_unload_entry(hass: HomeAssistant, entry: AirzoneConfigEntry) -> bool: ...
+async def async_migrate_entry(hass: HomeAssistant, entry: AirzoneConfigEntry) -> bool: ...

homeassistant-stubs/components/airzone/config_flow.pyi

@@ -1,11 +1,11 @@
 from .const import DOMAIN as DOMAIN
 from _typeshed import Incomplete
-from homeassistant.components import dhcp as dhcp
 from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult
 from homeassistant.const import CONF_HOST as CONF_HOST, CONF_ID as CONF_ID, CONF_PORT as CONF_PORT
 from homeassistant.data_entry_flow import AbortFlow as AbortFlow
 from homeassistant.helpers import aiohttp_client as aiohttp_client
 from homeassistant.helpers.device_registry import format_mac as format_mac
+from homeassistant.helpers.service_info.dhcp import DhcpServiceInfo as DhcpServiceInfo
 from typing import Any
 
 _LOGGER: Incomplete
@@ -17,6 +17,7 @@ def short_mac(addr: str) -> str: ...
 class AirZoneConfigFlow(ConfigFlow, domain=DOMAIN):
     _discovered_ip: str | None
     _discovered_mac: str | None
+    MINOR_VERSION: int
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
-    async def async_step_dhcp(self, discovery_info: dhcp.DhcpServiceInfo) -> ConfigFlowResult: ...
+    async def async_step_dhcp(self, discovery_info: DhcpServiceInfo) -> ConfigFlowResult: ...
     async def async_step_discovered_connection(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...

homeassistant-stubs/components/alarm_control_panel/__init__.pyi

@@ -12,7 +12,7 @@ from homeassistant.helpers.entity_platform import EntityPlatform as EntityPlatfo
 from homeassistant.helpers.frame import ReportBehavior as ReportBehavior, report_usage as report_usage
 from homeassistant.helpers.typing import ConfigType as ConfigType
 from homeassistant.util.hass_dict import HassKey as HassKey
-from propcache import cached_property
+from propcache.api import cached_property
 from typing import Any, Final, final
 
 _LOGGER: Final[Incomplete]

homeassistant-stubs/components/androidtv_remote/config_flow.pyi

@@ -3,12 +3,12 @@ from .helpers import create_api as create_api, get_enable_ime as get_enable_ime
 from _typeshed import Incomplete
 from androidtvremote2 import AndroidTVRemote as AndroidTVRemote
 from collections.abc import Mapping
-from homeassistant.components import zeroconf as zeroconf
 from homeassistant.config_entries import ConfigEntry as ConfigEntry, ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult, OptionsFlow as OptionsFlow, SOURCE_REAUTH as SOURCE_REAUTH
 from homeassistant.const import CONF_HOST as CONF_HOST, CONF_MAC as CONF_MAC, CONF_NAME as CONF_NAME
 from homeassistant.core import callback as callback
 from homeassistant.helpers.device_registry import format_mac as format_mac
 from homeassistant.helpers.selector import SelectOptionDict as SelectOptionDict, SelectSelector as SelectSelector, SelectSelectorConfig as SelectSelectorConfig, SelectSelectorMode as SelectSelectorMode
+from homeassistant.helpers.service_info.zeroconf import ZeroconfServiceInfo as ZeroconfServiceInfo
 from typing import Any
 
 _LOGGER: Incomplete
@@ -27,7 +27,7 @@ class AndroidTVRemoteConfigFlow(ConfigFlow, domain=DOMAIN):
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def _async_start_pair(self) -> ConfigFlowResult: ...
     async def async_step_pair(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
-    async def async_step_zeroconf(self, discovery_info: zeroconf.ZeroconfServiceInfo) -> ConfigFlowResult: ...
+    async def async_step_zeroconf(self, discovery_info: ZeroconfServiceInfo) -> ConfigFlowResult: ...
     async def async_step_zeroconf_confirm(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def async_step_reauth(self, entry_data: Mapping[str, Any]) -> ConfigFlowResult: ...
     async def async_step_reauth_confirm(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...

homeassistant-stubs/components/api/__init__.pyi

@@ -1,7 +1,7 @@
-import homeassistant.core as ha
 from _typeshed import Incomplete
 from aiohttp import web
 from functools import lru_cache
+from homeassistant import core as ha
 from homeassistant.auth.models import User as User
 from homeassistant.auth.permissions.const import POLICY_READ as POLICY_READ
 from homeassistant.components.http import HomeAssistantView as HomeAssistantView, KEY_HASS as KEY_HASS, KEY_HASS_USER as KEY_HASS_USER, require_admin as require_admin

homeassistant-stubs/components/apple_tv/config_flow.pyi

@@ -11,6 +11,7 @@ from homeassistant.data_entry_flow import AbortFlow as AbortFlow
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
 from homeassistant.helpers.schema_config_entry_flow import SchemaFlowFormStep as SchemaFlowFormStep, SchemaOptionsFlowHandler as SchemaOptionsFlowHandler
+from homeassistant.helpers.service_info.zeroconf import ZeroconfServiceInfo as ZeroconfServiceInfo
 from pyatv.const import Protocol
 from pyatv.interface import BaseConfig as BaseConfig, PairingHandler as PairingHandler
 from typing import Any, Self
@@ -48,7 +49,7 @@ class AppleTVConfigFlow(ConfigFlow, domain=DOMAIN):
     async def async_step_reauth(self, entry_data: Mapping[str, Any]) -> ConfigFlowResult: ...
     async def async_step_restore_device(self, user_input: dict[str, str] | None = None) -> ConfigFlowResult: ...
     async def async_step_user(self, user_input: dict[str, str] | None = None) -> ConfigFlowResult: ...
-    async def async_step_zeroconf(self, discovery_info: zeroconf.ZeroconfServiceInfo) -> ConfigFlowResult: ...
+    async def async_step_zeroconf(self, discovery_info: ZeroconfServiceInfo) -> ConfigFlowResult: ...
     async def _async_aggregate_discoveries(self, host: str, unique_id: str) -> None: ...
     @callback
     def _async_check_and_update_in_progress(self, host: str, unique_id: str) -> None: ...

homeassistant-stubs/components/apsystems/coordinator.pyi

@@ -11,6 +11,7 @@ class ApSystemsSensorData:
     alarm_info: ReturnAlarmInfo
 
 class ApSystemsDataCoordinator(DataUpdateCoordinator[ApSystemsSensorData]):
+    device_version: str
     api: Incomplete
     def __init__(self, hass: HomeAssistant, api: APsystemsEZ1M) -> None: ...
     async def _async_setup(self) -> None: ...

homeassistant-stubs/components/aranet/sensor.pyi

@@ -6,7 +6,7 @@ from bleak.backends.device import BLEDevice as BLEDevice
 from dataclasses import dataclass
 from homeassistant.components.bluetooth.passive_update_processor import PassiveBluetoothDataProcessor as PassiveBluetoothDataProcessor, PassiveBluetoothDataUpdate as PassiveBluetoothDataUpdate, PassiveBluetoothEntityKey as PassiveBluetoothEntityKey, PassiveBluetoothProcessorEntity as PassiveBluetoothProcessorEntity
 from homeassistant.components.sensor import SensorDeviceClass as SensorDeviceClass, SensorEntity as SensorEntity, SensorEntityDescription as SensorEntityDescription, SensorStateClass as SensorStateClass
-from homeassistant.const import ATTR_MANUFACTURER as ATTR_MANUFACTURER, ATTR_NAME as ATTR_NAME, ATTR_SW_VERSION as ATTR_SW_VERSION, CONCENTRATION_PARTS_PER_MILLION as CONCENTRATION_PARTS_PER_MILLION, EntityCategory as EntityCategory, PERCENTAGE as PERCENTAGE, UnitOfPressure as UnitOfPressure, UnitOfTemperature as UnitOfTemperature, UnitOfTime as UnitOfTime
+from homeassistant.const import ATTR_MANUFACTURER as ATTR_MANUFACTURER, ATTR_MODEL as ATTR_MODEL, ATTR_NAME as ATTR_NAME, ATTR_SW_VERSION as ATTR_SW_VERSION, CONCENTRATION_PARTS_PER_MILLION as CONCENTRATION_PARTS_PER_MILLION, EntityCategory as EntityCategory, PERCENTAGE as PERCENTAGE, UnitOfPressure as UnitOfPressure, UnitOfTemperature as UnitOfTemperature, UnitOfTime as UnitOfTime
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.device_registry import DeviceInfo as DeviceInfo
 from homeassistant.helpers.entity import EntityDescription as EntityDescription

homeassistant-stubs/components/arcam_fmj/config_flow.pyi

@@ -1,8 +1,8 @@
 from .const import DEFAULT_NAME as DEFAULT_NAME, DEFAULT_PORT as DEFAULT_PORT, DOMAIN as DOMAIN
-from homeassistant.components import ssdp as ssdp
 from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult
 from homeassistant.const import CONF_HOST as CONF_HOST, CONF_PORT as CONF_PORT
 from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
+from homeassistant.helpers.service_info.ssdp import ATTR_UPNP_UDN as ATTR_UPNP_UDN, SsdpServiceInfo as SsdpServiceInfo
 from typing import Any
 
 class ArcamFmjFlowHandler(ConfigFlow, domain=DOMAIN):
@@ -13,4 +13,4 @@ class ArcamFmjFlowHandler(ConfigFlow, domain=DOMAIN):
     async def _async_check_and_create(self, host: str, port: int) -> ConfigFlowResult: ...
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def async_step_confirm(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
-    async def async_step_ssdp(self, discovery_info: ssdp.SsdpServiceInfo) -> ConfigFlowResult: ...
+    async def async_step_ssdp(self, discovery_info: SsdpServiceInfo) -> ConfigFlowResult: ...

homeassistant-stubs/components/assist_pipeline/__init__.pyi

@@ -7,7 +7,7 @@ from homeassistant.core import Context, HomeAssistant
 from homeassistant.helpers.typing import ConfigType
 from typing import Any
 
-__all__ = ['DOMAIN', 'async_create_default_pipeline', 'async_get_pipelines', 'async_migrate_engine', 'async_setup', 'async_pipeline_from_audio_stream', 'async_update_pipeline', 'AudioSettings', 'Pipeline', 'PipelineEvent', 'PipelineEventType', 'PipelineNotFound', 'WakeWordSettings', 'EVENT_RECORDING', 'OPTION_PREFERRED', 'SAMPLES_PER_CHUNK', 'SAMPLE_RATE', 'SAMPLE_WIDTH', 'SAMPLE_CHANNELS']
+__all__ = ['DOMAIN', 'EVENT_RECORDING', 'OPTION_PREFERRED', 'SAMPLES_PER_CHUNK', 'SAMPLE_CHANNELS', 'SAMPLE_RATE', 'SAMPLE_WIDTH', 'AudioSettings', 'Pipeline', 'PipelineEvent', 'PipelineEventType', 'PipelineNotFound', 'WakeWordSettings', 'async_create_default_pipeline', 'async_get_pipelines', 'async_migrate_engine', 'async_pipeline_from_audio_stream', 'async_setup', 'async_update_pipeline']
 
 async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool: ...
-async def async_pipeline_from_audio_stream(hass: HomeAssistant, *, context: Context, event_callback: PipelineEventCallback, stt_metadata: stt.SpeechMetadata, stt_stream: AsyncIterable[bytes], wake_word_phrase: str | None = None, pipeline_id: str | None = None, conversation_id: str | None = None, tts_audio_output: str | dict[str, Any] | None = None, wake_word_settings: WakeWordSettings | None = None, audio_settings: AudioSettings | None = None, device_id: str | None = None, start_stage: PipelineStage = ..., end_stage: PipelineStage = ...) -> None: ...
+async def async_pipeline_from_audio_stream(hass: HomeAssistant, *, context: Context, event_callback: PipelineEventCallback, stt_metadata: stt.SpeechMetadata, stt_stream: AsyncIterable[bytes], wake_word_phrase: str | None = None, pipeline_id: str | None = None, conversation_id: str | None = None, tts_audio_output: str | dict[str, Any] | None = None, wake_word_settings: WakeWordSettings | None = None, audio_settings: AudioSettings | None = None, device_id: str | None = None, start_stage: PipelineStage = ..., end_stage: PipelineStage = ..., conversation_extra_system_prompt: str | None = None) -> None: ...

homeassistant-stubs/components/assist_pipeline/pipeline.pyi

@@ -18,6 +18,7 @@ from homeassistant.helpers.singleton import singleton as singleton
 from homeassistant.helpers.storage import Store as Store
 from homeassistant.helpers.typing import UNDEFINED as UNDEFINED, UndefinedType as UndefinedType, VolDictType as VolDictType
 from homeassistant.util import ulid as ulid_util
+from homeassistant.util.hass_dict import HassKey as HassKey
 from homeassistant.util.limited_size_dict import LimitedSizeDict as LimitedSizeDict
 from pathlib import Path
 from queue import Queue
@@ -29,6 +30,7 @@ STORAGE_KEY: Incomplete
 STORAGE_VERSION: int
 STORAGE_VERSION_MINOR: int
 ENGINE_LANGUAGE_PAIRS: Incomplete
+KEY_ASSIST_PIPELINE: HassKey[PipelineData]
 
 def validate_language(data: dict[str, Any]) -> Any: ...
 
@@ -158,7 +160,7 @@ class PipelineRun:
     async def speech_to_text(self, metadata: stt.SpeechMetadata, stream: AsyncIterable[EnhancedAudioChunk]) -> str: ...
     async def _speech_to_text_stream(self, audio_stream: AsyncIterable[EnhancedAudioChunk], stt_vad: VoiceCommandSegmenter | None, sample_rate: int = ..., sample_width: int = ...) -> AsyncGenerator[bytes]: ...
     async def prepare_recognize_intent(self) -> None: ...
-    async def recognize_intent(self, intent_input: str, conversation_id: str | None, device_id: str | None) -> str: ...
+    async def recognize_intent(self, intent_input: str, conversation_id: str | None, device_id: str | None, conversation_extra_system_prompt: str | None) -> str: ...
     async def prepare_text_to_speech(self) -> None: ...
     async def text_to_speech(self, tts_input: str) -> None: ...
     def _capture_chunk(self, audio_bytes: bytes | None) -> None: ...
@@ -179,6 +181,7 @@ class PipelineInput:
     intent_input: str | None = ...
     tts_input: str | None = ...
     conversation_id: str | None = ...
+    conversation_extra_system_prompt: str | None = ...
     device_id: str | None = ...
     async def execute(self) -> None: ...
     async def validate(self) -> None: ...

homeassistant-stubs/components/assist_pipeline/select.pyi

@@ -1,5 +1,5 @@
-from .const import DOMAIN as DOMAIN, OPTION_PREFERRED as OPTION_PREFERRED
-from .pipeline import AssistDevice as AssistDevice, PipelineData as PipelineData, PipelineStorageCollection as PipelineStorageCollection
+from .const import OPTION_PREFERRED as OPTION_PREFERRED
+from .pipeline import AssistDevice as AssistDevice, KEY_ASSIST_PIPELINE as KEY_ASSIST_PIPELINE
 from .vad import VadSensitivity as VadSensitivity
 from _typeshed import Incomplete
 from collections.abc import Iterable

homeassistant-stubs/components/assist_pipeline/websocket_api.pyi

@@ -1,6 +1,6 @@
-from .const import DEFAULT_PIPELINE_TIMEOUT as DEFAULT_PIPELINE_TIMEOUT, DEFAULT_WAKE_WORD_TIMEOUT as DEFAULT_WAKE_WORD_TIMEOUT, DOMAIN as DOMAIN, EVENT_RECORDING as EVENT_RECORDING, SAMPLE_CHANNELS as SAMPLE_CHANNELS, SAMPLE_RATE as SAMPLE_RATE, SAMPLE_WIDTH as SAMPLE_WIDTH
+from .const import DEFAULT_PIPELINE_TIMEOUT as DEFAULT_PIPELINE_TIMEOUT, DEFAULT_WAKE_WORD_TIMEOUT as DEFAULT_WAKE_WORD_TIMEOUT, EVENT_RECORDING as EVENT_RECORDING, SAMPLE_CHANNELS as SAMPLE_CHANNELS, SAMPLE_RATE as SAMPLE_RATE, SAMPLE_WIDTH as SAMPLE_WIDTH
 from .error import PipelineNotFound as PipelineNotFound
-from .pipeline import AudioSettings as AudioSettings, DeviceAudioQueue as DeviceAudioQueue, PipelineData as PipelineData, PipelineError as PipelineError, PipelineEvent as PipelineEvent, PipelineEventType as PipelineEventType, PipelineInput as PipelineInput, PipelineRun as PipelineRun, PipelineStage as PipelineStage, WakeWordSettings as WakeWordSettings, async_get_pipeline as async_get_pipeline
+from .pipeline import AudioSettings as AudioSettings, DeviceAudioQueue as DeviceAudioQueue, KEY_ASSIST_PIPELINE as KEY_ASSIST_PIPELINE, PipelineError as PipelineError, PipelineEvent as PipelineEvent, PipelineEventType as PipelineEventType, PipelineInput as PipelineInput, PipelineRun as PipelineRun, PipelineStage as PipelineStage, WakeWordSettings as WakeWordSettings, async_get_pipeline as async_get_pipeline
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
 from homeassistant.components import conversation as conversation, stt as stt, tts as tts, websocket_api as websocket_api

homeassistant-stubs/components/assist_satellite/__init__.pyi

@@ -2,4 +2,4 @@ from .const import AssistSatelliteEntityFeature as AssistSatelliteEntityFeature,
 from .entity import AssistSatelliteAnnouncement as AssistSatelliteAnnouncement, AssistSatelliteConfiguration as AssistSatelliteConfiguration, AssistSatelliteEntity as AssistSatelliteEntity, AssistSatelliteEntityDescription as AssistSatelliteEntityDescription, AssistSatelliteWakeWord as AssistSatelliteWakeWord
 from .errors import SatelliteBusyError as SatelliteBusyError
 
-__all__ = ['DOMAIN', 'AssistSatelliteAnnouncement', 'AssistSatelliteEntity', 'AssistSatelliteConfiguration', 'AssistSatelliteEntityDescription', 'AssistSatelliteEntityFeature', 'AssistSatelliteWakeWord', 'SatelliteBusyError']
+__all__ = ['DOMAIN', 'AssistSatelliteAnnouncement', 'AssistSatelliteConfiguration', 'AssistSatelliteEntity', 'AssistSatelliteEntityDescription', 'AssistSatelliteEntityFeature', 'AssistSatelliteWakeWord', 'SatelliteBusyError']

homeassistant-stubs/components/assist_satellite/const.pyi

@@ -10,3 +10,4 @@ CONNECTION_TEST_DATA: HassKey[dict[str, asyncio.Event]]
 
 class AssistSatelliteEntityFeature(IntFlag):
     ANNOUNCE = 1
+    START_CONVERSATION = 2

homeassistant-stubs/components/assist_satellite/entity.pyi

@@ -7,10 +7,11 @@ from abc import abstractmethod
 from collections.abc import AsyncIterable
 from dataclasses import dataclass
 from enum import StrEnum
-from homeassistant.components import media_source as media_source, stt as stt, tts as tts
+from homeassistant.components import conversation as conversation, media_source as media_source, stt as stt, tts as tts
 from homeassistant.components.assist_pipeline import AudioSettings as AudioSettings, OPTION_PREFERRED as OPTION_PREFERRED, PipelineEvent as PipelineEvent, PipelineEventType as PipelineEventType, PipelineStage as PipelineStage, async_get_pipeline as async_get_pipeline, async_get_pipelines as async_get_pipelines, async_pipeline_from_audio_stream as async_pipeline_from_audio_stream, vad as vad
 from homeassistant.components.media_player import async_process_play_media_url as async_process_play_media_url
 from homeassistant.core import Context as Context, callback as callback
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.helpers import entity as entity
 from homeassistant.helpers.entity import EntityDescription as EntityDescription
 from typing import Any, Final, Literal, final
@@ -42,6 +43,7 @@ class AssistSatelliteConfiguration:
 class AssistSatelliteAnnouncement:
     message: str
     media_id: str
+    original_media_id: str
     media_id_source: Literal['url', 'media_id', 'tts']
 
 class AssistSatelliteEntity(entity.Entity, metaclass=abc.ABCMeta):
@@ -54,6 +56,7 @@ class AssistSatelliteEntity(entity.Entity, metaclass=abc.ABCMeta):
     _conversation_id_time: float | None
     _run_has_tts: bool
     _is_announcing: bool
+    _extra_system_prompt: str | None
     _wake_word_intercept_future: asyncio.Future[str | None] | None
     _attr_tts_options: dict[str, Any] | None
     _pipeline_task: asyncio.Task | None
@@ -75,6 +78,8 @@ class AssistSatelliteEntity(entity.Entity, metaclass=abc.ABCMeta):
     async def async_intercept_wake_word(self) -> str | None: ...
     async def async_internal_announce(self, message: str | None = None, media_id: str | None = None) -> None: ...
     async def async_announce(self, announcement: AssistSatelliteAnnouncement) -> None: ...
+    async def async_internal_start_conversation(self, start_message: str | None = None, start_media_id: str | None = None, extra_system_prompt: str | None = None) -> None: ...
+    async def async_start_conversation(self, start_announcement: AssistSatelliteAnnouncement) -> None: ...
     async def async_accept_pipeline_from_satellite(self, audio_stream: AsyncIterable[bytes], start_stage: PipelineStage = ..., end_stage: PipelineStage = ..., wake_word_phrase: str | None = None) -> None: ...
     async def _cancel_running_pipeline(self) -> None: ...
     @abstractmethod
@@ -89,3 +94,4 @@ class AssistSatelliteEntity(entity.Entity, metaclass=abc.ABCMeta):
     def _resolve_pipeline(self) -> str | None: ...
     @callback
     def _resolve_vad_sensitivity(self) -> float: ...
+    async def _resolve_announcement_media_id(self, message: str, media_id: str | None) -> AssistSatelliteAnnouncement: ...

homeassistant-stubs/components/assist_satellite/intent.pyi

@@ -0,0 +1,13 @@
+from .const import AssistSatelliteEntityFeature as AssistSatelliteEntityFeature, DOMAIN as DOMAIN
+from _typeshed import Incomplete
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers import intent as intent
+
+async def async_setup_intents(hass: HomeAssistant) -> None: ...
+
+class BroadcastIntentHandler(intent.IntentHandler):
+    intent_type: Incomplete
+    description: str
+    @property
+    def slot_schema(self) -> dict | None: ...
+    async def async_handle(self, intent_obj: intent.Intent) -> intent.IntentResponse: ...

homeassistant-stubs/components/assist_satellite/websocket_api.pyi

@@ -1,10 +1,8 @@
 from .connection_test import CONNECTION_TEST_URL_BASE as CONNECTION_TEST_URL_BASE
 from .const import AssistSatelliteEntityFeature as AssistSatelliteEntityFeature, CONNECTION_TEST_DATA as CONNECTION_TEST_DATA, DATA_COMPONENT as DATA_COMPONENT, DOMAIN as DOMAIN
-from .entity import AssistSatelliteEntity as AssistSatelliteEntity
 from homeassistant.components import websocket_api as websocket_api
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
-from homeassistant.helpers.entity_component import EntityComponent as EntityComponent
 from typing import Any
 
 CONNECTION_TEST_TIMEOUT: int

homeassistant-stubs/components/automation/__init__.pyi

@@ -26,7 +26,7 @@ from homeassistant.helpers.typing import ConfigType as ConfigType
 from homeassistant.loader import bind_hass as bind_hass
 from homeassistant.util.dt import parse_datetime as parse_datetime
 from homeassistant.util.hass_dict import HassKey as HassKey
-from propcache import cached_property
+from propcache.api import cached_property
 from typing import Any, Protocol
 
 DATA_COMPONENT: HassKey[EntityComponent[BaseAutomationEntity]]

homeassistant-stubs/components/awair/config_flow.pyi

@@ -1,10 +1,11 @@
 from .const import DOMAIN as DOMAIN, LOGGER as LOGGER
 from collections.abc import Mapping
-from homeassistant.components import onboarding as onboarding, zeroconf as zeroconf
+from homeassistant.components import onboarding as onboarding
 from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult, SOURCE_ZEROCONF as SOURCE_ZEROCONF
 from homeassistant.const import CONF_ACCESS_TOKEN as CONF_ACCESS_TOKEN, CONF_DEVICE as CONF_DEVICE, CONF_HOST as CONF_HOST
 from homeassistant.core import callback as callback
 from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
+from homeassistant.helpers.service_info.zeroconf import ZeroconfServiceInfo as ZeroconfServiceInfo
 from python_awair import AwairLocalDevice as AwairLocalDevice
 from python_awair.user import AwairUser as AwairUser
 from typing import Any
@@ -13,7 +14,7 @@ class AwairFlowHandler(ConfigFlow, domain=DOMAIN):
     VERSION: int
     _device: AwairLocalDevice
     host: str
-    async def async_step_zeroconf(self, discovery_info: zeroconf.ZeroconfServiceInfo) -> ConfigFlowResult: ...
+    async def async_step_zeroconf(self, discovery_info: ZeroconfServiceInfo) -> ConfigFlowResult: ...
     async def async_step_discovery_confirm(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def async_step_user(self, user_input: dict[str, str] | None = None) -> ConfigFlowResult: ...
     async def async_step_cloud(self, user_input: Mapping[str, Any]) -> ConfigFlowResult: ...

homeassistant-stubs/components/axis/config_flow.pyi

@@ -4,11 +4,13 @@ from .errors import AuthenticationRequired as AuthenticationRequired, CannotConn
 from .hub import AxisHub as AxisHub, get_axis_api as get_axis_api
 from _typeshed import Incomplete
 from collections.abc import Mapping
-from homeassistant.components import dhcp as dhcp, ssdp as ssdp, zeroconf as zeroconf
 from homeassistant.config_entries import ConfigEntry as ConfigEntry, ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult, OptionsFlow as OptionsFlow, SOURCE_IGNORE as SOURCE_IGNORE, SOURCE_REAUTH as SOURCE_REAUTH, SOURCE_RECONFIGURE as SOURCE_RECONFIGURE
 from homeassistant.const import CONF_HOST as CONF_HOST, CONF_MAC as CONF_MAC, CONF_MODEL as CONF_MODEL, CONF_NAME as CONF_NAME, CONF_PASSWORD as CONF_PASSWORD, CONF_PORT as CONF_PORT, CONF_PROTOCOL as CONF_PROTOCOL, CONF_USERNAME as CONF_USERNAME
 from homeassistant.core import callback as callback
 from homeassistant.helpers.device_registry import format_mac as format_mac
+from homeassistant.helpers.service_info.dhcp import DhcpServiceInfo as DhcpServiceInfo
+from homeassistant.helpers.service_info.ssdp import ATTR_UPNP_FRIENDLY_NAME as ATTR_UPNP_FRIENDLY_NAME, ATTR_UPNP_PRESENTATION_URL as ATTR_UPNP_PRESENTATION_URL, ATTR_UPNP_SERIAL as ATTR_UPNP_SERIAL, SsdpServiceInfo as SsdpServiceInfo
+from homeassistant.helpers.service_info.zeroconf import ZeroconfServiceInfo as ZeroconfServiceInfo
 from homeassistant.helpers.typing import VolDictType as VolDictType
 from homeassistant.util.network import is_link_local as is_link_local
 from typing import Any
@@ -31,9 +33,9 @@ class AxisFlowHandler(ConfigFlow, domain=AXIS_DOMAIN):
     async def async_step_reconfigure(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def async_step_reauth(self, entry_data: Mapping[str, Any]) -> ConfigFlowResult: ...
     async def _redo_configuration(self, entry_data: Mapping[str, Any], keep_password: bool) -> ConfigFlowResult: ...
-    async def async_step_dhcp(self, discovery_info: dhcp.DhcpServiceInfo) -> ConfigFlowResult: ...
-    async def async_step_ssdp(self, discovery_info: ssdp.SsdpServiceInfo) -> ConfigFlowResult: ...
-    async def async_step_zeroconf(self, discovery_info: zeroconf.ZeroconfServiceInfo) -> ConfigFlowResult: ...
+    async def async_step_dhcp(self, discovery_info: DhcpServiceInfo) -> ConfigFlowResult: ...
+    async def async_step_ssdp(self, discovery_info: SsdpServiceInfo) -> ConfigFlowResult: ...
+    async def async_step_zeroconf(self, discovery_info: ZeroconfServiceInfo) -> ConfigFlowResult: ...
     async def _process_discovered_device(self, discovery_info: dict[str, Any]) -> ConfigFlowResult: ...
 
 class AxisOptionsFlowHandler(OptionsFlow):