homeassistant-stubs 2025.9.0b0__py3-none-any.whl → 2026.1.0b0__py3-none-any.whl

homeassistant-stubs/helpers/condition.pyi

@@ -1,22 +1,25 @@
 import abc
 import logging
-from .automation import get_absolute_description_key as get_absolute_description_key, get_relative_description_key as get_relative_description_key
+from . import selector as selector
+from .automation import get_absolute_description_key as get_absolute_description_key, get_relative_description_key as get_relative_description_key, move_options_fields_to_top_level as move_options_fields_to_top_level
 from .integration_platform import async_process_integration_platforms as async_process_integration_platforms
+from .selector import TargetSelector as TargetSelector
 from .template import Template as Template, render_complex as render_complex
 from .trace import TraceElement as TraceElement, trace_append_element as trace_append_element, trace_path as trace_path, trace_path_get as trace_path_get, trace_stack_cv as trace_stack_cv, trace_stack_pop as trace_stack_pop, trace_stack_push as trace_stack_push, trace_stack_top as trace_stack_top
 from .typing import ConfigType as ConfigType, TemplateVarsType as TemplateVarsType
 from _typeshed import Incomplete
 from collections.abc import Callable, Container, Coroutine, Generator, Iterable
 from contextlib import contextmanager
+from dataclasses import dataclass
 from datetime import time as dt_time, timedelta
-from homeassistant.const import ATTR_DEVICE_CLASS as ATTR_DEVICE_CLASS, CONF_ABOVE as CONF_ABOVE, CONF_AFTER as CONF_AFTER, CONF_ATTRIBUTE as CONF_ATTRIBUTE, CONF_BEFORE as CONF_BEFORE, CONF_BELOW as CONF_BELOW, CONF_CONDITION as CONF_CONDITION, CONF_DEVICE_ID as CONF_DEVICE_ID, CONF_ENABLED as CONF_ENABLED, CONF_ENTITY_ID as CONF_ENTITY_ID, CONF_FOR as CONF_FOR, CONF_ID as CONF_ID, CONF_MATCH as CONF_MATCH, CONF_STATE as CONF_STATE, CONF_VALUE_TEMPLATE as CONF_VALUE_TEMPLATE, CONF_WEEKDAY as CONF_WEEKDAY, ENTITY_MATCH_ALL as ENTITY_MATCH_ALL, ENTITY_MATCH_ANY as ENTITY_MATCH_ANY, STATE_UNAVAILABLE as STATE_UNAVAILABLE, STATE_UNKNOWN as STATE_UNKNOWN, WEEKDAYS as WEEKDAYS
+from homeassistant.const import ATTR_DEVICE_CLASS as ATTR_DEVICE_CLASS, CONF_ABOVE as CONF_ABOVE, CONF_AFTER as CONF_AFTER, CONF_ATTRIBUTE as CONF_ATTRIBUTE, CONF_BEFORE as CONF_BEFORE, CONF_BELOW as CONF_BELOW, CONF_CONDITION as CONF_CONDITION, CONF_DEVICE_ID as CONF_DEVICE_ID, CONF_ENABLED as CONF_ENABLED, CONF_ENTITY_ID as CONF_ENTITY_ID, CONF_FOR as CONF_FOR, CONF_ID as CONF_ID, CONF_MATCH as CONF_MATCH, CONF_OPTIONS as CONF_OPTIONS, CONF_SELECTOR as CONF_SELECTOR, CONF_STATE as CONF_STATE, CONF_TARGET as CONF_TARGET, CONF_VALUE_TEMPLATE as CONF_VALUE_TEMPLATE, CONF_WEEKDAY as CONF_WEEKDAY, ENTITY_MATCH_ALL as ENTITY_MATCH_ALL, ENTITY_MATCH_ANY as ENTITY_MATCH_ANY, STATE_UNAVAILABLE as STATE_UNAVAILABLE, STATE_UNKNOWN as STATE_UNKNOWN, WEEKDAYS as WEEKDAYS
 from homeassistant.core import HomeAssistant as HomeAssistant, State as State, callback as callback
 from homeassistant.exceptions import ConditionError as ConditionError, ConditionErrorContainer as ConditionErrorContainer, ConditionErrorIndex as ConditionErrorIndex, ConditionErrorMessage as ConditionErrorMessage, HomeAssistantError as HomeAssistantError, TemplateError as TemplateError
 from homeassistant.loader import Integration as Integration, IntegrationNotFound as IntegrationNotFound, async_get_integration as async_get_integration, async_get_integrations as async_get_integrations
 from homeassistant.util.async_ import run_callback_threadsafe as run_callback_threadsafe
 from homeassistant.util.hass_dict import HassKey as HassKey
 from homeassistant.util.yaml import load_yaml_dict as load_yaml_dict
-from typing import Any, Protocol
+from typing import Any, Protocol, TypedDict, Unpack, overload
 
 ASYNC_FROM_CONFIG_FORMAT: str
 FROM_CONFIG_FORMAT: str
@@ -25,40 +28,63 @@ _LOGGER: Incomplete
 _PLATFORM_ALIASES: dict[str | None, str | None]
 INPUT_ENTITY_ID: Incomplete
 CONDITION_DESCRIPTION_CACHE: HassKey[dict[str, dict[str, Any] | None]]
+CONDITION_DISABLED_CONDITIONS: HassKey[set[str]]
 CONDITION_PLATFORM_SUBSCRIPTIONS: HassKey[list[Callable[[set[str]], Coroutine[Any, Any, None]]]]
 CONDITIONS: HassKey[dict[str, str]]
-_FIELD_SCHEMA: Incomplete
-_CONDITION_SCHEMA: Incomplete
+_FIELD_DESCRIPTION_SCHEMA: Incomplete
+_CONDITION_DESCRIPTION_SCHEMA: Incomplete
 
 def starts_with_dot(key: str) -> str: ...
 
-_CONDITIONS_SCHEMA: Incomplete
+_CONDITIONS_DESCRIPTION_SCHEMA: Incomplete
 
 async def async_setup(hass: HomeAssistant) -> None: ...
 @callback
 def async_subscribe_platform_events(hass: HomeAssistant, on_event: Callable[[set[str]], Coroutine[Any, Any, None]]) -> Callable[[], None]: ...
 async def _register_condition_platform(hass: HomeAssistant, integration_domain: str, platform: ConditionProtocol) -> None: ...
 
+_CONDITION_BASE_SCHEMA: Incomplete
+_CONDITION_SCHEMA: Incomplete
+
 class Condition(abc.ABC, metaclass=abc.ABCMeta):
-    def __init__(self, hass: HomeAssistant, config: ConfigType) -> None: ...
+    _hass: HomeAssistant
+    @classmethod
+    async def async_validate_complete_config(cls, hass: HomeAssistant, complete_config: ConfigType) -> ConfigType: ...
     @classmethod
     @abc.abstractmethod
     async def async_validate_config(cls, hass: HomeAssistant, config: ConfigType) -> ConfigType: ...
+    def __init__(self, hass: HomeAssistant, config: ConditionConfig) -> None: ...
     @abc.abstractmethod
-    async def async_get_checker(self) -> ConditionCheckerType: ...
+    async def async_get_checker(self) -> ConditionChecker: ...
 
 class ConditionProtocol(Protocol):
     async def async_get_conditions(self, hass: HomeAssistant) -> dict[str, type[Condition]]: ...
-type ConditionCheckerType = Callable[[HomeAssistant, TemplateVarsType], bool | None]
+
+@dataclass(slots=True)
+class ConditionConfig:
+    options: dict[str, Any] | None = ...
+    target: dict[str, Any] | None = ...
+
+class ConditionCheckParams(TypedDict, total=False):
+    variables: TemplateVarsType
+
+class ConditionChecker(Protocol):
+    def __call__(self, **kwargs: Unpack[ConditionCheckParams]) -> bool: ...
+type ConditionCheckerType = Callable[[HomeAssistant, TemplateVarsType], bool]
+type ConditionCheckerTypeOptional = Callable[[HomeAssistant, TemplateVarsType], bool | None]
 
 def condition_trace_append(variables: TemplateVarsType, path: str) -> TraceElement: ...
 def condition_trace_set_result(result: bool, **kwargs: Any) -> None: ...
 def condition_trace_update_result(**kwargs: Any) -> None: ...
 @contextmanager
 def trace_condition(variables: TemplateVarsType) -> Generator[TraceElement]: ...
+@overload
 def trace_condition_function(condition: ConditionCheckerType) -> ConditionCheckerType: ...
+@overload
+def trace_condition_function(condition: ConditionCheckerTypeOptional) -> ConditionCheckerTypeOptional: ...
 async def _async_get_condition_platform(hass: HomeAssistant, condition_key: str) -> tuple[str, ConditionProtocol | None]: ...
-async def async_from_config(hass: HomeAssistant, config: ConfigType) -> ConditionCheckerType: ...
+async def _async_get_checker(condition: Condition) -> ConditionCheckerType: ...
+async def async_from_config(hass: HomeAssistant, config: ConfigType) -> ConditionCheckerTypeOptional: ...
 async def async_and_from_config(hass: HomeAssistant, config: ConfigType) -> ConditionCheckerType: ...
 async def async_or_from_config(hass: HomeAssistant, config: ConfigType) -> ConditionCheckerType: ...
 async def async_not_from_config(hass: HomeAssistant, config: ConfigType) -> ConditionCheckerType: ...

homeassistant-stubs/helpers/config_entry_oauth2_flow.pyi

@@ -13,6 +13,7 @@ from collections.abc import Awaitable, Callable as Callable
 from habluetooth import BluetoothServiceInfoBleak as BluetoothServiceInfoBleak
 from homeassistant import config_entries as config_entries
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.loader import async_get_application_credentials as async_get_application_credentials
 from homeassistant.util.hass_dict import HassKey as HassKey
 from typing import Any
@@ -28,6 +29,8 @@ CLOCK_OUT_OF_SYNC_MAX_SEC: int
 OAUTH_AUTHORIZE_URL_TIMEOUT_SEC: int
 OAUTH_TOKEN_TIMEOUT_SEC: int
 
+class ImplementationUnavailableError(HomeAssistantError): ...
+
 @callback
 def async_get_redirect_uri(hass: HomeAssistant) -> str: ...
 

homeassistant-stubs/helpers/config_validation.pyi

@@ -115,8 +115,8 @@ def slugify(value: Any) -> str: ...
 def string(value: Any) -> str: ...
 def string_with_no_html(value: Any) -> str: ...
 def temperature_unit(value: Any) -> UnitOfTemperature: ...
-def template(value: Any | None) -> template_helper.Template: ...
-def dynamic_template(value: Any | None) -> template_helper.Template: ...
+def template(value: Any) -> template_helper.Template: ...
+def dynamic_template(value: Any) -> template_helper.Template: ...
 def template_complex(value: Any) -> Any: ...
 def _positive_time_period_template_complex(value: Any) -> Any: ...
 
@@ -149,7 +149,7 @@ def deprecated(key: str, replacement_key: str | None = None, default: Any | None
 def removed(key: str, default: Any | None = None, raise_if_present: bool | None = True) -> Callable[[dict], dict]: ...
 def renamed(old_key: str, new_key: str) -> Callable[[Any], Any]: ...
 type ValueSchemas = dict[Hashable, VolSchemaType | Callable[[Any], dict[str, Any]]]
-def key_value_schemas(key: str, value_schemas: ValueSchemas, default_schema: VolSchemaType | Callable[[Any], dict[str, Any]] | None = None, default_description: str | None = None) -> Callable[[Any], dict[Hashable, Any]]: ...
+def key_value_schemas(key: str, value_schemas: ValueSchemas, default_schema: VolSchemaType | Callable[[Any], dict[str, Any]] | None = None, default_description: str | None = None, list_alternatives: bool = True) -> Callable[[Any], dict[Hashable, Any]]: ...
 def key_dependency[_KT: Hashable, _VT](key: Hashable, dependency: Hashable) -> Callable[[dict[_KT, _VT]], dict[_KT, _VT]]: ...
 def custom_serializer(schema: Any) -> Any: ...
 def _custom_serializer(schema: Any, *, allow_section: bool) -> Any: ...
@@ -162,7 +162,8 @@ PLATFORM_SCHEMA: Incomplete
 PLATFORM_SCHEMA_BASE: Incomplete
 TARGET_FIELDS: VolDictType
 ENTITY_SERVICE_FIELDS: VolDictType
-TARGET_SERVICE_FIELDS: Incomplete
+TARGET_SERVICE_FIELDS: VolDictType
+_TARGET_SERVICE_FIELDS_TEMPLATED: VolDictType
 _HAS_ENTITY_SERVICE_FIELD: Incomplete
 
 def is_entity_service_schema(validator: VolSchemaType) -> bool: ...

homeassistant-stubs/helpers/debounce.pyi

@@ -1,8 +1,10 @@
 import asyncio
 from _typeshed import Incomplete
-from collections.abc import Callable as Callable
+from collections.abc import AsyncGenerator, Callable as Callable
+from contextlib import asynccontextmanager
 from homeassistant.core import HassJob as HassJob, HomeAssistant as HomeAssistant, callback as callback
 from logging import Logger
+from typing import Any
 
 class Debouncer[_R_co]:
     hass: Incomplete
@@ -13,10 +15,13 @@ class Debouncer[_R_co]:
     _timer_task: asyncio.TimerHandle | None
     _execute_at_end_of_timer: bool
     _execute_lock: Incomplete
+    _execute_lock_owner: asyncio.Task[Any] | None
     _background: Incomplete
     _job: HassJob[[], _R_co] | None
     _shutdown_requested: bool
     def __init__(self, hass: HomeAssistant, logger: Logger, *, cooldown: float, immediate: bool, function: Callable[[], _R_co] | None = None, background: bool = False) -> None: ...
+    @asynccontextmanager
+    async def async_lock(self) -> AsyncGenerator[None]: ...
     @property
     def function(self) -> Callable[[], _R_co] | None: ...
     @function.setter

homeassistant-stubs/helpers/deprecation.pyi

@@ -8,6 +8,7 @@ def deprecated_substitute[_ObjectT: object](substitute_name: str) -> Callable[[C
 def get_deprecated(config: dict[str, Any], new_name: str, old_name: str, default: Any | None = None) -> Any | None: ...
 def deprecated_class[**_P, _R](replacement: str, *, breaks_in_ha_version: str | None = None) -> Callable[[Callable[_P, _R]], Callable[_P, _R]]: ...
 def deprecated_function[**_P, _R](replacement: str, *, breaks_in_ha_version: str | None = None) -> Callable[[Callable[_P, _R]], Callable[_P, _R]]: ...
+def deprecated_hass_argument[**_P, _T](breaks_in_ha_version: str | None = None) -> Callable[[Callable[_P, _T]], Callable[_P, _T]]: ...
 def _print_deprecation_warning(obj: Any, replacement: str, description: str, verb: str, breaks_in_ha_version: str | None) -> None: ...
 def _print_deprecation_warning_internal(obj_name: str, module_name: str, replacement: str, description: str, verb: str, breaks_in_ha_version: str | None, *, log_when_no_integration_is_found: bool) -> None: ...
 def _print_deprecation_warning_internal_impl(obj_name: str, module_name: str, replacement: str, description: str, verb: str, breaks_in_ha_version: str | None, *, log_when_no_integration_is_found: bool) -> None: ...

homeassistant-stubs/helpers/device_registry.pyi

@@ -133,7 +133,6 @@ class DeviceEntry:
     _suggested_area: str | None
     sw_version: str | None
     via_device_id: str | None
-    is_new: bool
     _cache: dict[str, Any]
     @property
     def disabled(self) -> bool: ...
@@ -145,7 +144,7 @@ class DeviceEntry:
     def as_storage_fragment(self) -> json_fragment: ...
     @property
     def suggested_area(self) -> str | None: ...
-    def __init__(self, area_id, config_entries, config_entries_subentries, configuration_url, connections, created_at, disabled_by, entry_type, hw_version, id, identifiers, labels, manufacturer, model, model_id, modified_at, name_by_user, name, primary_config_entry, serial_number, suggested_area, sw_version, via_device_id, is_new, cache) -> None: ...
+    def __init__(self, area_id, config_entries, config_entries_subentries, configuration_url, connections, created_at, disabled_by, entry_type, hw_version, id, identifiers, labels, manufacturer, model, model_id, modified_at, name_by_user, name, primary_config_entry, serial_number, suggested_area, sw_version, via_device_id, cache) -> None: ...
     def __lt__(self, other): ...
     def __le__(self, other): ...
     def __gt__(self, other): ...
@@ -157,7 +156,7 @@ class DeletedDeviceEntry:
     config_entries_subentries: dict[str, set[str | None]]
     connections: set[tuple[str, str]]
     created_at: datetime
-    disabled_by: DeviceEntryDisabler | None
+    disabled_by: DeviceEntryDisabler | UndefinedType | None
     id: str
     identifiers: set[tuple[str, str]]
     labels: set[str]
@@ -165,7 +164,7 @@ class DeletedDeviceEntry:
     name_by_user: str | None
     orphaned_timestamp: float | None
     _cache: dict[str, Any]
-    def to_device_entry(self, config_entry: ConfigEntry, config_subentry_id: str | None, connections: set[tuple[str, str]], identifiers: set[tuple[str, str]]) -> DeviceEntry: ...
+    def to_device_entry(self, config_entry: ConfigEntry, config_subentry_id: str | None, connections: set[tuple[str, str]], identifiers: set[tuple[str, str]], disabled_by: DeviceEntryDisabler | UndefinedType | None) -> DeviceEntry: ...
     @under_cached_property
     def as_storage_fragment(self) -> json_fragment: ...
     def __init__(self, area_id, config_entries, config_entries_subentries, connections, created_at, disabled_by, id, identifiers, labels, modified_at, name_by_user, orphaned_timestamp, cache) -> None: ...
@@ -212,7 +211,9 @@ class DeviceRegistry(BaseRegistry[dict[str, list[dict[str, Any]]]]):
     @callback
     def async_get_or_create(self, *, config_entry_id: str, config_subentry_id: str | None | UndefinedType = ..., configuration_url: str | URL | None | UndefinedType = ..., connections: set[tuple[str, str]] | None | UndefinedType = ..., created_at: str | datetime | UndefinedType = ..., default_manufacturer: str | None | UndefinedType = ..., default_model: str | None | UndefinedType = ..., default_name: str | None | UndefinedType = ..., disabled_by: DeviceEntryDisabler | None | UndefinedType = ..., entry_type: DeviceEntryType | None | UndefinedType = ..., hw_version: str | None | UndefinedType = ..., identifiers: set[tuple[str, str]] | None | UndefinedType = ..., manufacturer: str | None | UndefinedType = ..., model: str | None | UndefinedType = ..., model_id: str | None | UndefinedType = ..., modified_at: str | datetime | UndefinedType = ..., name: str | None | UndefinedType = ..., serial_number: str | None | UndefinedType = ..., suggested_area: str | None | UndefinedType = ..., sw_version: str | None | UndefinedType = ..., translation_key: str | None = None, translation_placeholders: Mapping[str, str] | None = None, via_device: tuple[str, str] | None | UndefinedType = ...) -> DeviceEntry: ...
     @callback
-    def async_update_device(self, device_id: str, *, add_config_entry_id: str | UndefinedType = ..., add_config_subentry_id: str | None | UndefinedType = ..., allow_collisions: bool = False, area_id: str | None | UndefinedType = ..., configuration_url: str | URL | None | UndefinedType = ..., device_info_type: str | UndefinedType = ..., disabled_by: DeviceEntryDisabler | None | UndefinedType = ..., entry_type: DeviceEntryType | None | UndefinedType = ..., hw_version: str | None | UndefinedType = ..., labels: set[str] | UndefinedType = ..., manufacturer: str | None | UndefinedType = ..., merge_connections: set[tuple[str, str]] | UndefinedType = ..., merge_identifiers: set[tuple[str, str]] | UndefinedType = ..., model: str | None | UndefinedType = ..., model_id: str | None | UndefinedType = ..., name_by_user: str | None | UndefinedType = ..., name: str | None | UndefinedType = ..., new_connections: set[tuple[str, str]] | UndefinedType = ..., new_identifiers: set[tuple[str, str]] | UndefinedType = ..., remove_config_entry_id: str | UndefinedType = ..., remove_config_subentry_id: str | None | UndefinedType = ..., serial_number: str | None | UndefinedType = ..., _suggested_area: str | None | UndefinedType = ..., suggested_area: str | None | UndefinedType = ..., sw_version: str | None | UndefinedType = ..., via_device_id: str | None | UndefinedType = ...) -> DeviceEntry | None: ...
+    def _async_update_device(self, device_id: str, *, add_config_entry_id: str | UndefinedType = ..., add_config_subentry_id: str | None | UndefinedType = ..., allow_collisions: bool = False, area_id: str | None | UndefinedType = ..., configuration_url: str | URL | None | UndefinedType = ..., device_info_type: str | UndefinedType = ..., disabled_by: DeviceEntryDisabler | None | UndefinedType = ..., entry_type: DeviceEntryType | None | UndefinedType = ..., hw_version: str | None | UndefinedType = ..., is_new: bool = False, labels: set[str] | UndefinedType = ..., manufacturer: str | None | UndefinedType = ..., merge_connections: set[tuple[str, str]] | UndefinedType = ..., merge_identifiers: set[tuple[str, str]] | UndefinedType = ..., model: str | None | UndefinedType = ..., model_id: str | None | UndefinedType = ..., name_by_user: str | None | UndefinedType = ..., name: str | None | UndefinedType = ..., new_connections: set[tuple[str, str]] | UndefinedType = ..., new_identifiers: set[tuple[str, str]] | UndefinedType = ..., remove_config_entry_id: str | UndefinedType = ..., remove_config_subentry_id: str | None | UndefinedType = ..., serial_number: str | None | UndefinedType = ..., suggested_area: str | None | UndefinedType = ..., sw_version: str | None | UndefinedType = ..., via_device_id: str | None | UndefinedType = ...) -> DeviceEntry | None: ...
+    @callback
+    def async_update_device(self, device_id: str, *, add_config_entry_id: str | UndefinedType = ..., add_config_subentry_id: str | None | UndefinedType = ..., area_id: str | None | UndefinedType = ..., configuration_url: str | URL | None | UndefinedType = ..., device_info_type: str | UndefinedType = ..., disabled_by: DeviceEntryDisabler | None | UndefinedType = ..., entry_type: DeviceEntryType | None | UndefinedType = ..., hw_version: str | None | UndefinedType = ..., labels: set[str] | UndefinedType = ..., manufacturer: str | None | UndefinedType = ..., merge_connections: set[tuple[str, str]] | UndefinedType = ..., merge_identifiers: set[tuple[str, str]] | UndefinedType = ..., model: str | None | UndefinedType = ..., model_id: str | None | UndefinedType = ..., name_by_user: str | None | UndefinedType = ..., name: str | None | UndefinedType = ..., new_connections: set[tuple[str, str]] | UndefinedType = ..., new_identifiers: set[tuple[str, str]] | UndefinedType = ..., remove_config_entry_id: str | UndefinedType = ..., remove_config_subentry_id: str | None | UndefinedType = ..., serial_number: str | None | UndefinedType = ..., suggested_area: str | None | UndefinedType = ..., sw_version: str | None | UndefinedType = ..., via_device_id: str | None | UndefinedType = ...) -> DeviceEntry | None: ...
     @callback
     def _validate_connections(self, device_id: str, connections: set[tuple[str, str]], allow_collisions: bool) -> set[tuple[str, str]]: ...
     @callback

homeassistant-stubs/helpers/entity.pyi

@@ -78,7 +78,6 @@ class EntityDescription(frozen_or_thawed=True, metaclass=FrozenOrThawed):
 class CalculatedState:
     state: str
     attributes: dict[str, Any]
-    capability_attributes: Mapping[str, Any] | None
 
 class CachedProperties(type):
     def __new__(mcs, name: str, bases: tuple[type, ...], namespace: dict[Any, Any], cached_properties: set[str] | None = None, **kwargs: Any) -> Any: ...

homeassistant-stubs/helpers/entity_component.pyi

@@ -3,11 +3,11 @@ from . import discovery as discovery, entity as entity, service as service
 from .entity_platform import EntityPlatform as EntityPlatform, async_calculate_suggested_object_id as async_calculate_suggested_object_id
 from .typing import ConfigType as ConfigType, DiscoveryInfoType as DiscoveryInfoType, VolDictType as VolDictType, VolSchemaType as VolSchemaType
 from _typeshed import Incomplete
-from collections.abc import Callable as Callable, Iterable
+from collections.abc import Callable as Callable, Iterable, Mapping
 from datetime import timedelta
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import CONF_ENTITY_NAMESPACE as CONF_ENTITY_NAMESPACE, CONF_SCAN_INTERVAL as CONF_SCAN_INTERVAL, EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_STOP
-from homeassistant.core import Event as Event, HassJob as HassJob, HassJobType as HassJobType, HomeAssistant as HomeAssistant, ServiceCall as ServiceCall, ServiceResponse as ServiceResponse, SupportsResponse as SupportsResponse, callback as callback
+from homeassistant.core import Event as Event, HassJobType as HassJobType, HomeAssistant as HomeAssistant, ServiceCall as ServiceCall, SupportsResponse as SupportsResponse, callback as callback
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.loader import async_get_integration as async_get_integration, bind_hass as bind_hass
 from homeassistant.setup import async_prepare_setup_platform as async_prepare_setup_platform
@@ -45,9 +45,7 @@ class EntityComponent[_EntityT: entity.Entity = entity.Entity]:
     async def async_unload_entry(self, config_entry: ConfigEntry) -> bool: ...
     async def async_extract_from_service(self, service_call: ServiceCall, expand_group: bool = True) -> list[_EntityT]: ...
     @callback
-    def async_register_legacy_entity_service(self, name: str, schema: VolDictType | VolSchemaType, func: str | Callable[..., Any], required_features: list[int] | None = None, supports_response: SupportsResponse = ...) -> None: ...
-    @callback
-    def async_register_entity_service(self, name: str, schema: VolDictType | VolSchemaType | None, func: str | Callable[..., Any], required_features: list[int] | None = None, supports_response: SupportsResponse = ...) -> None: ...
+    def async_register_entity_service(self, name: str, schema: VolDictType | VolSchemaType | None, func: str | Callable[..., Any], required_features: list[int] | None = None, supports_response: SupportsResponse = ..., *, description_placeholders: Mapping[str, str] | None = None) -> None: ...
     async def async_setup_platform(self, platform_type: str, platform_config: ConfigType, discovery_info: DiscoveryInfoType | None = None) -> None: ...
     async def _async_reset(self) -> None: ...
     async def async_remove_entity(self, entity_id: str) -> None: ...

homeassistant-stubs/helpers/entity_platform.pyi

@@ -7,7 +7,7 @@ from .event import async_call_later as async_call_later
 from .issue_registry import IssueSeverity as IssueSeverity, async_create_issue as async_create_issue
 from .typing import ConfigType as ConfigType, DiscoveryInfoType as DiscoveryInfoType, UNDEFINED as UNDEFINED, VolDictType as VolDictType, VolSchemaType as VolSchemaType
 from _typeshed import Incomplete
-from collections.abc import Awaitable, Callable as Callable, Iterable
+from collections.abc import Awaitable, Callable as Callable, Iterable, Mapping
 from contextvars import ContextVar
 from datetime import timedelta
 from homeassistant import config_entries as config_entries
@@ -109,7 +109,7 @@ class EntityPlatform:
     async def async_remove_entity(self, entity_id: str) -> None: ...
     async def async_extract_from_service(self, service_call: ServiceCall, expand_group: bool = True) -> list[Entity]: ...
     @callback
-    def async_register_entity_service(self, name: str, schema: VolDictType | VolSchemaType | None, func: str | Callable[..., Any], required_features: Iterable[int] | None = None, supports_response: SupportsResponse = ...) -> None: ...
+    def async_register_entity_service(self, name: str, schema: VolDictType | VolSchemaType | None, func: str | Callable[..., Any], required_features: Iterable[int] | None = None, supports_response: SupportsResponse = ..., *, entity_device_classes: Iterable[str | None] | None = None, description_placeholders: Mapping[str, str] | None = None) -> None: ...
     async def _async_update_entity_states(self) -> None: ...
     @property
     def domain(self) -> str: ...

homeassistant-stubs/helpers/entity_registry.pyi

@@ -61,6 +61,7 @@ type ReadOnlyEntityOptionsType = ReadOnlyDict[str, ReadOnlyDict[str, Any]]
 DISPLAY_DICT_OPTIONAL: Incomplete
 
 def _protect_entity_options(data: EntityOptionsType | None) -> ReadOnlyEntityOptionsType: ...
+def _protect_optional_entity_options(data: EntityOptionsType | UndefinedType | None) -> ReadOnlyEntityOptionsType | UndefinedType: ...
 
 class RegistryEntry:
     entity_id: str
@@ -132,15 +133,15 @@ class DeletedRegistryEntry:
     config_subentry_id: str | None
     created_at: datetime
     device_class: str | None
-    disabled_by: RegistryEntryDisabler | None
+    disabled_by: RegistryEntryDisabler | UndefinedType | None
     domain: str
-    hidden_by: RegistryEntryHider | None
+    hidden_by: RegistryEntryHider | UndefinedType | None
     icon: str | None
     id: str
     labels: set[str]
     modified_at: datetime
     name: str | None
-    options: ReadOnlyEntityOptionsType
+    options: ReadOnlyEntityOptionsType | UndefinedType
     orphaned_timestamp: float | None
     _cache: dict[str, Any]
     @domain.default
@@ -209,7 +210,6 @@ class EntityRegistry(BaseRegistry):
     @callback
     def async_update_entity_options(self, entity_id: str, domain: str, options: Mapping[str, Any] | None) -> RegistryEntry: ...
     async def async_load(self) -> None: ...
-    @callback
     def _data_to_save(self) -> dict[str, Any]: ...
     @callback
     def async_clear_category_id(self, scope: str, category_id: str) -> None: ...

homeassistant-stubs/helpers/event.pyi

@@ -5,7 +5,8 @@ from .device_registry import EVENT_DEVICE_REGISTRY_UPDATED as EVENT_DEVICE_REGIS
 from .entity_registry import EVENT_ENTITY_REGISTRY_UPDATED as EVENT_ENTITY_REGISTRY_UPDATED, EventEntityRegistryUpdatedData as EventEntityRegistryUpdatedData
 from .ratelimit import KeyedRateLimit as KeyedRateLimit
 from .sun import get_astral_event_next as get_astral_event_next
-from .template import RenderInfo as RenderInfo, Template as Template, result_as_boolean as result_as_boolean
+from .template import Template as Template, result_as_boolean as result_as_boolean
+from .template.render_info import RenderInfo as RenderInfo
 from .typing import TemplateVarsType as TemplateVarsType
 from _typeshed import Incomplete
 from collections import defaultdict
@@ -14,7 +15,7 @@ from dataclasses import dataclass
 from datetime import datetime, timedelta
 from homeassistant.const import EVENT_CORE_CONFIG_UPDATE as EVENT_CORE_CONFIG_UPDATE, EVENT_STATE_CHANGED as EVENT_STATE_CHANGED, EVENT_STATE_REPORTED as EVENT_STATE_REPORTED, MATCH_ALL as MATCH_ALL, SUN_EVENT_SUNRISE as SUN_EVENT_SUNRISE, SUN_EVENT_SUNSET as SUN_EVENT_SUNSET
 from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, Event as Event, EventStateChangedData as EventStateChangedData, EventStateEventData as EventStateEventData, EventStateReportedData as EventStateReportedData, HassJob as HassJob, HassJobType as HassJobType, HomeAssistant as HomeAssistant, State as State, callback as callback, split_entity_id as split_entity_id
-from homeassistant.exceptions import TemplateError as TemplateError
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError, TemplateError as TemplateError
 from homeassistant.loader import bind_hass as bind_hass
 from homeassistant.util.async_ import run_callback_threadsafe as run_callback_threadsafe
 from homeassistant.util.event_type import EventType as EventType

homeassistant-stubs/helpers/floor_registry.pyi

@@ -30,9 +30,13 @@ class _FloorStoreData(TypedDict):
 class FloorRegistryStoreData(TypedDict):
     floors: list[_FloorStoreData]
 
-class EventFloorRegistryUpdatedData(TypedDict):
+class _EventFloorRegistryUpdatedData_Create_Remove_Update(TypedDict):
     action: Literal['create', 'remove', 'update']
     floor_id: str
+
+class _EventFloorRegistryUpdatedData_Reorder(TypedDict):
+    action: Literal['reorder']
+type EventFloorRegistryUpdatedData = _EventFloorRegistryUpdatedData_Create_Remove_Update | _EventFloorRegistryUpdatedData_Reorder
 type EventFloorRegistryUpdated = Event[EventFloorRegistryUpdatedData]
 
 @dataclass(slots=True, kw_only=True, frozen=True)
@@ -73,6 +77,8 @@ class FloorRegistry(BaseRegistry[FloorRegistryStoreData]):
     def async_delete(self, floor_id: str) -> None: ...
     @callback
     def async_update(self, floor_id: str, *, aliases: set[str] | UndefinedType = ..., icon: str | None | UndefinedType = ..., level: int | UndefinedType = ..., name: str | UndefinedType = ...) -> FloorEntry: ...
+    @callback
+    def async_reorder(self, floor_ids: list[str]) -> None: ...
     async def async_load(self) -> None: ...
     @callback
     def _data_to_save(self) -> FloorRegistryStoreData: ...

homeassistant-stubs/helpers/instance_id.pyi

@@ -8,3 +8,4 @@ LEGACY_UUID_FILE: str
 _LOGGER: Incomplete
 
 async def async_get(hass: HomeAssistant) -> str: ...
+async def async_recreate(hass: HomeAssistant) -> str: ...

homeassistant-stubs/helpers/intent.pyi

@@ -2,6 +2,7 @@ import abc
 import asyncio
 import voluptuous as vol
 from . import area_registry as area_registry, device_registry as device_registry, entity_registry as entity_registry, floor_registry as floor_registry
+from .deprecation import EnumWithDeprecatedMembers as EnumWithDeprecatedMembers
 from .typing import VolSchemaType as VolSchemaType
 from _typeshed import Incomplete
 from abc import abstractmethod
@@ -26,6 +27,7 @@ INTENT_TOGGLE: str
 INTENT_GET_STATE: str
 INTENT_NEVERMIND: str
 INTENT_SET_POSITION: str
+INTENT_STOP_MOVING: str
 INTENT_START_TIMER: str
 INTENT_CANCEL_TIMER: str
 INTENT_CANCEL_ALL_TIMERS: str
@@ -53,7 +55,7 @@ def async_remove(hass: HomeAssistant, intent_type: str) -> None: ...
 @callback
 def async_get(hass: HomeAssistant) -> Iterable[IntentHandler]: ...
 @bind_hass
-async def async_handle(hass: HomeAssistant, platform: str, intent_type: str, slots: _SlotsType | None = None, text_input: str | None = None, context: Context | None = None, language: str | None = None, assistant: str | None = None, device_id: str | None = None, conversation_agent_id: str | None = None) -> IntentResponse: ...
+async def async_handle(hass: HomeAssistant, platform: str, intent_type: str, slots: _SlotsType | None = None, text_input: str | None = None, context: Context | None = None, language: str | None = None, assistant: str | None = None, device_id: str | None = None, satellite_id: str | None = None, conversation_agent_id: str | None = None) -> IntentResponse: ...
 
 class IntentError(HomeAssistantError): ...
 class UnknownIntent(IntentError): ...
@@ -197,10 +199,6 @@ class ServiceIntentHandler(DynamicServiceIntentHandler):
     def __init__(self, intent_type: str, domain: str, service: str, speech: str | None = None, required_slots: _IntentSlotsType | None = None, optional_slots: _IntentSlotsType | None = None, required_domains: set[str] | None = None, required_features: int | None = None, required_states: set[str] | None = None, description: str | None = None, platforms: set[str] | None = None, device_classes: set[type[StrEnum]] | None = None) -> None: ...
     def get_domain_and_service(self, intent_obj: Intent, state: State) -> tuple[str, str]: ...
 
-class IntentCategory(Enum):
-    ACTION = 'action'
-    QUERY = 'query'
-
 class Intent:
     __slots__: Incomplete
     hass: Incomplete
@@ -210,15 +208,15 @@ class Intent:
     text_input: Incomplete
     context: Incomplete
     language: Incomplete
-    category: Incomplete
     assistant: Incomplete
     device_id: Incomplete
+    satellite_id: Incomplete
     conversation_agent_id: Incomplete
-    def __init__(self, hass: HomeAssistant, platform: str, intent_type: str, slots: _SlotsType, text_input: str | None, context: Context, language: str, category: IntentCategory | None = None, assistant: str | None = None, device_id: str | None = None, conversation_agent_id: str | None = None) -> None: ...
+    def __init__(self, hass: HomeAssistant, platform: str, intent_type: str, slots: _SlotsType, text_input: str | None, context: Context, language: str, assistant: str | None = None, device_id: str | None = None, satellite_id: str | None = None, conversation_agent_id: str | None = None) -> None: ...
     @callback
     def create_response(self) -> IntentResponse: ...
 
-class IntentResponseType(Enum):
+class IntentResponseType(Enum, deprecated={'PARTIAL_ACTION_DONE': ('IntentResponseType.ACTION_DONE or IntentResponseType.ERROR', '2026.3.0')}, metaclass=EnumWithDeprecatedMembers):
     ACTION_DONE = 'action_done'
     PARTIAL_ACTION_DONE = 'partial_action_done'
     QUERY_ANSWER = 'query_answer'

homeassistant-stubs/helpers/json.pyi

@@ -31,5 +31,6 @@ JSON_DUMP: Final[Incomplete]
 
 def _orjson_default_encoder(data: Any) -> str: ...
 def _orjson_bytes_default_encoder(data: Any) -> bytes: ...
+def prepare_save_json(data: list | dict, *, encoder: type[json.JSONEncoder] | None = None) -> tuple[str, str | bytes]: ...
 def save_json(filename: str, data: list | dict, private: bool = False, *, encoder: type[json.JSONEncoder] | None = None, atomic_writes: bool = False) -> None: ...
 def find_paths_unserializable_data(bad_data: Any, *, dump: Callable[[Any], str] = ...) -> dict[str, Any]: ...

homeassistant-stubs/helpers/llm.pyi

@@ -22,7 +22,7 @@ from typing import Any
 
 ACTION_PARAMETERS_CACHE: HassKey[dict[str, dict[str, tuple[str | None, vol.Schema]]]]
 LLM_API_ASSIST: str
-BASE_PROMPT: str
+DATE_TIME_PROMPT: str
 DEFAULT_INSTRUCTIONS_PROMPT: str
 NO_ENTITIES_PROMPT: str
 DYNAMIC_CONTEXT_PROMPT: str
@@ -151,3 +151,8 @@ class GetLiveContextTool(Tool):
     name: str
     description: str
     async def async_call(self, hass: HomeAssistant, tool_input: ToolInput, llm_context: LLMContext) -> JsonObjectType: ...
+
+class GetDateTimeTool(Tool):
+    name: str
+    description: str
+    async def async_call(self, hass: HomeAssistant, tool_input: ToolInput, llm_context: LLMContext) -> JsonObjectType: ...

homeassistant-stubs/helpers/registry.pyi

@@ -26,6 +26,5 @@ class BaseRegistry[_StoreDataT: Mapping[str, Any] | Sequence[Any]](ABC, metaclas
     _store: Store[_StoreDataT]
     @callback
     def async_schedule_save(self) -> None: ...
-    @callback
     @abstractmethod
     def _data_to_save(self) -> _StoreDataT: ...

homeassistant-stubs/helpers/schema_config_entry_flow.pyi

@@ -6,7 +6,7 @@ from _typeshed import Incomplete
 from abc import ABC, abstractmethod
 from collections.abc import Callable, Container, Coroutine, Mapping
 from dataclasses import dataclass
-from homeassistant.config_entries import ConfigEntry as ConfigEntry, ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult, OptionsFlow as OptionsFlow
+from homeassistant.config_entries import ConfigEntry as ConfigEntry, ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult, OptionsFlow as OptionsFlow, OptionsFlowWithReload as OptionsFlowWithReload
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback, split_entity_id as split_entity_id
 from homeassistant.data_entry_flow import UnknownHandler as UnknownHandler
 from typing import Any
@@ -27,6 +27,7 @@ class SchemaFlowFormStep(SchemaFlowStep):
 @dataclass(slots=True)
 class SchemaFlowMenuStep(SchemaFlowStep):
     options: Container[str] | Callable[[SchemaCommonFlowHandler], Coroutine[Any, Any, Container[str]]]
+    sort: bool = ...
 
 class SchemaCommonFlowHandler:
     _flow: Incomplete
@@ -52,6 +53,7 @@ class SchemaCommonFlowHandler:
 class SchemaConfigFlowHandler(ConfigFlow, ABC, metaclass=abc.ABCMeta):
     config_flow: Mapping[str, SchemaFlowStep]
     options_flow: Mapping[str, SchemaFlowStep] | None
+    options_flow_reloads: bool
     VERSION: int
     def __init_subclass__(cls, **kwargs: Any) -> None: ...
     _common_handler: Incomplete
@@ -86,6 +88,8 @@ class SchemaOptionsFlowHandler(OptionsFlow):
     @callback
     def async_create_entry(self, data: Mapping[str, Any], **kwargs: Any) -> ConfigFlowResult: ...
 
+class SchemaOptionsFlowHandlerWithReload(SchemaOptionsFlowHandler, OptionsFlowWithReload): ...
+
 @callback
 def wrapped_entity_config_entry_title(hass: HomeAssistant, entity_id_or_uuid: str) -> str: ...
 @callback

homeassistant-stubs/helpers/script.pyi

@@ -2,7 +2,7 @@ import asyncio
 import logging
 import voluptuous as vol
 from . import condition as condition, service as service, template as template
-from .condition import ConditionCheckerType as ConditionCheckerType, trace_condition_function as trace_condition_function
+from .condition import ConditionCheckerTypeOptional as ConditionCheckerTypeOptional, trace_condition_function as trace_condition_function
 from .dispatcher import async_dispatcher_connect as async_dispatcher_connect, async_dispatcher_send_internal as async_dispatcher_send_internal
 from .event import async_call_later as async_call_later, async_track_template as async_track_template
 from .script_variables import ScriptRunVariables as ScriptRunVariables, ScriptVariables as ScriptVariables
@@ -110,8 +110,8 @@ class _ScriptRun:
     async def _async_run_script(self, script: Script, *, parallel: bool = False) -> None: ...
     async def _async_step_parallel(self) -> None: ...
     async def _async_step_sequence(self) -> None: ...
-    async def _async_get_condition(self, config: ConfigType) -> ConditionCheckerType: ...
-    def _test_conditions(self, conditions: list[ConditionCheckerType], name: str, condition_path: str | None = None) -> bool | None: ...
+    async def _async_get_condition(self, config: ConfigType) -> ConditionCheckerTypeOptional: ...
+    def _test_conditions(self, conditions: list[ConditionCheckerTypeOptional], name: str, condition_path: str | None = None) -> bool | None: ...
     async def _async_step_choose(self) -> None: ...
     async def _async_step_condition(self) -> None: ...
     async def _async_step_if(self) -> None: ...
@@ -150,11 +150,11 @@ type _VarsType = dict[str, Any] | Mapping[str, Any] | ScriptRunVariables
 def _referenced_extract_ids(data: Any, key: str, found: set[str]) -> None: ...
 
 class _ChooseData(TypedDict):
-    choices: list[tuple[list[ConditionCheckerType], Script]]
+    choices: list[tuple[list[ConditionCheckerTypeOptional], Script]]
     default: Script | None
 
 class _IfData(TypedDict):
-    if_conditions: list[ConditionCheckerType]
+    if_conditions: list[ConditionCheckerTypeOptional]
     if_then: Script
     if_else: Script | None
 
@@ -183,7 +183,7 @@ class Script:
     max_runs: Incomplete
     _max_exceeded: Incomplete
     _queue_lck: Incomplete
-    _config_cache: dict[frozenset[tuple[str, str]], ConditionCheckerType]
+    _config_cache: dict[frozenset[tuple[str, str]], ConditionCheckerTypeOptional]
     _repeat_script: dict[int, Script]
     _choose_data: dict[int, _ChooseData]
     _if_data: dict[int, _IfData]
@@ -227,7 +227,7 @@ class Script:
     async def async_run(self, run_variables: _VarsType | None = None, context: Context | None = None, started_action: Callable[..., Any] | None = None) -> ScriptRunResult | None: ...
     async def _async_stop(self, aws: list[asyncio.Task[None]], update_state: bool) -> None: ...
     async def async_stop(self, update_state: bool = True, spare: _ScriptRun | None = None) -> None: ...
-    async def _async_get_condition(self, config: ConfigType) -> ConditionCheckerType: ...
+    async def _async_get_condition(self, config: ConfigType) -> ConditionCheckerTypeOptional: ...
     def _prep_repeat_script(self, step: int) -> Script: ...
     def _get_repeat_script(self, step: int) -> Script: ...
     async def _async_prep_choose_data(self, step: int) -> _ChooseData: ...