homeassistant-stubs 2025.3.4__py3-none-any.whl → 2025.4.0__py3-none-any.whl

homeassistant-stubs/components/vodafone_station/sensor.pyi

@@ -0,0 +1,38 @@
+from .const import LINE_TYPES as LINE_TYPES, _LOGGER as _LOGGER
+from .coordinator import VodafoneConfigEntry as VodafoneConfigEntry, VodafoneStationRouter as VodafoneStationRouter
+from _typeshed import Incomplete
+from collections.abc import Callable as Callable
+from dataclasses import dataclass
+from datetime import datetime
+from homeassistant.components.sensor import SensorDeviceClass as SensorDeviceClass, SensorEntity as SensorEntity, SensorEntityDescription as SensorEntityDescription
+from homeassistant.const import EntityCategory as EntityCategory, PERCENTAGE as PERCENTAGE, UnitOfDataRate as UnitOfDataRate
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+from homeassistant.helpers.update_coordinator import CoordinatorEntity as CoordinatorEntity
+from typing import Final
+
+PARALLEL_UPDATES: int
+NOT_AVAILABLE: list
+UPTIME_DEVIATION: int
+
+@dataclass(frozen=True, kw_only=True)
+class VodafoneStationEntityDescription(SensorEntityDescription):
+    value: Callable[[VodafoneStationRouter, str | datetime | float | None, str], str | datetime | float | None] = ...
+    is_suitable: Callable[[dict], bool] = ...
+
+def _calculate_uptime(coordinator: VodafoneStationRouter, last_value: str | datetime | float | None, key: str) -> datetime: ...
+def _line_connection(coordinator: VodafoneStationRouter, last_value: str | datetime | float | None, key: str) -> str | None: ...
+
+SENSOR_TYPES: Final[Incomplete]
+
+async def async_setup_entry(hass: HomeAssistant, entry: VodafoneConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+class VodafoneStationSensorEntity(CoordinatorEntity[VodafoneStationRouter], SensorEntity):
+    _attr_has_entity_name: bool
+    entity_description: VodafoneStationEntityDescription
+    _attr_device_info: Incomplete
+    _attr_unique_id: Incomplete
+    _old_state: str | datetime | float | None
+    def __init__(self, coordinator: VodafoneStationRouter, description: VodafoneStationEntityDescription) -> None: ...
+    @property
+    def native_value(self) -> str | datetime | float | None: ...

homeassistant-stubs/components/zwave_js/__init__.pyi

@@ -9,10 +9,10 @@ from .services import ZWaveServices as ZWaveServices
 from _typeshed import Incomplete
 from homeassistant.components.hassio import AddonError as AddonError, AddonManager as AddonManager, AddonState as AddonState
 from homeassistant.components.persistent_notification import async_create as async_create
-from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.config_entries import ConfigEntry as ConfigEntry, ConfigEntryState as ConfigEntryState
 from homeassistant.const import ATTR_DEVICE_ID as ATTR_DEVICE_ID, ATTR_DOMAIN as ATTR_DOMAIN, ATTR_ENTITY_ID as ATTR_ENTITY_ID, CONF_URL as CONF_URL, EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_STOP, EVENT_LOGGING_CHANGED as EVENT_LOGGING_CHANGED, Platform as Platform
 from homeassistant.core import Event as Event, HomeAssistant as HomeAssistant, callback as callback
-from homeassistant.exceptions import ConfigEntryNotReady as ConfigEntryNotReady
+from homeassistant.exceptions import ConfigEntryNotReady as ConfigEntryNotReady, HomeAssistantError as HomeAssistantError
 from homeassistant.helpers import device_registry as dr
 from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
 from homeassistant.helpers.dispatcher import async_dispatcher_send as async_dispatcher_send
@@ -25,26 +25,23 @@ from zwave_js_server.model.node import Node as ZwaveNode
 from zwave_js_server.model.value import Value as Value, ValueNotification as ValueNotification
 
 CONNECT_TIMEOUT: int
-DATA_CLIENT_LISTEN_TASK: str
 DATA_DRIVER_EVENTS: str
-DATA_START_CLIENT_TASK: str
+DRIVER_READY_TIMEOUT: int
 CONFIG_SCHEMA: Incomplete
+PLATFORMS: Incomplete
 
 async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool: ...
 async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...
-async def start_client(hass: HomeAssistant, entry: ConfigEntry, client: ZwaveClient) -> None: ...
+def _get_listen_task_error(listen_task: asyncio.Task) -> tuple[BaseException | None, str]: ...
 
 class DriverEvents:
     driver: Driver
     config_entry: Incomplete
     dev_reg: Incomplete
     hass: Incomplete
-    platform_setup_tasks: dict[str, asyncio.Task]
-    ready: Incomplete
     controller_events: Incomplete
     def __init__(self, hass: HomeAssistant, entry: ConfigEntry) -> None: ...
     async def setup(self, driver: Driver) -> None: ...
-    async def async_setup_platform(self, platform: Platform) -> None: ...
 
 class ControllerEvents:
     hass: Incomplete
@@ -83,7 +80,6 @@ class NodeEvents:
     def async_on_value_updated_fire_event(self, value_updates_disc_info: dict[str, ZwaveDiscoveryInfo], value: Value) -> None: ...
 
 async def client_listen(hass: HomeAssistant, entry: ConfigEntry, client: ZwaveClient, driver_ready: asyncio.Event) -> None: ...
-async def disconnect_client(hass: HomeAssistant, entry: ConfigEntry) -> None: ...
 async def async_unload_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...
 async def async_remove_entry(hass: HomeAssistant, entry: ConfigEntry) -> None: ...
 async def async_remove_config_entry_device(hass: HomeAssistant, config_entry: ConfigEntry, device_entry: dr.DeviceEntry) -> bool: ...

homeassistant-stubs/components/zwave_js/api.pyi

@@ -153,6 +153,11 @@ async def websocket_try_parse_dsk_from_qr_code_string(hass: HomeAssistant, conne
 @websocket_api.async_response
 @async_handle_failed_command
 @async_get_entry
+async def websocket_lookup_device(hass: HomeAssistant, connection: ActiveConnection, msg: dict[str, Any], entry: ConfigEntry, client: Client, driver: Driver) -> None: ...
+@websocket_api.require_admin
+@websocket_api.async_response
+@async_handle_failed_command
+@async_get_entry
 async def websocket_supports_feature(hass: HomeAssistant, connection: ActiveConnection, msg: dict[str, Any], entry: ConfigEntry, client: Client, driver: Driver) -> None: ...
 @websocket_api.require_admin
 @websocket_api.async_response
@@ -329,3 +334,13 @@ async def websocket_invoke_cc_api(hass: HomeAssistant, connection: ActiveConnect
 @callback
 @websocket_api.require_admin
 def websocket_get_integration_settings(hass: HomeAssistant, connection: ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@websocket_api.async_response
+@async_handle_failed_command
+@async_get_entry
+async def websocket_backup_nvm(hass: HomeAssistant, connection: ActiveConnection, msg: dict[str, Any], entry: ConfigEntry, client: Client, driver: Driver) -> None: ...
+@websocket_api.require_admin
+@websocket_api.async_response
+@async_handle_failed_command
+@async_get_entry
+async def websocket_restore_nvm(hass: HomeAssistant, connection: ActiveConnection, msg: dict[str, Any], entry: ConfigEntry, client: Client, driver: Driver) -> None: ...

homeassistant-stubs/components/zwave_js/config_flow.pyi

@@ -1,7 +1,6 @@
 import abc
 import asyncio
 import voluptuous as vol
-from . import disconnect_client as disconnect_client
 from .addon import get_addon_manager as get_addon_manager
 from .const import ADDON_SLUG as ADDON_SLUG, CONF_ADDON_DEVICE as CONF_ADDON_DEVICE, CONF_ADDON_EMULATE_HARDWARE as CONF_ADDON_EMULATE_HARDWARE, CONF_ADDON_LOG_LEVEL as CONF_ADDON_LOG_LEVEL, CONF_ADDON_LR_S2_ACCESS_CONTROL_KEY as CONF_ADDON_LR_S2_ACCESS_CONTROL_KEY, CONF_ADDON_LR_S2_AUTHENTICATED_KEY as CONF_ADDON_LR_S2_AUTHENTICATED_KEY, CONF_ADDON_NETWORK_KEY as CONF_ADDON_NETWORK_KEY, CONF_ADDON_S0_LEGACY_KEY as CONF_ADDON_S0_LEGACY_KEY, CONF_ADDON_S2_ACCESS_CONTROL_KEY as CONF_ADDON_S2_ACCESS_CONTROL_KEY, CONF_ADDON_S2_AUTHENTICATED_KEY as CONF_ADDON_S2_AUTHENTICATED_KEY, CONF_ADDON_S2_UNAUTHENTICATED_KEY as CONF_ADDON_S2_UNAUTHENTICATED_KEY, CONF_INTEGRATION_CREATED_ADDON as CONF_INTEGRATION_CREATED_ADDON, CONF_LR_S2_ACCESS_CONTROL_KEY as CONF_LR_S2_ACCESS_CONTROL_KEY, CONF_LR_S2_AUTHENTICATED_KEY as CONF_LR_S2_AUTHENTICATED_KEY, CONF_S0_LEGACY_KEY as CONF_S0_LEGACY_KEY, CONF_S2_ACCESS_CONTROL_KEY as CONF_S2_ACCESS_CONTROL_KEY, CONF_S2_AUTHENTICATED_KEY as CONF_S2_AUTHENTICATED_KEY, CONF_S2_UNAUTHENTICATED_KEY as CONF_S2_UNAUTHENTICATED_KEY, CONF_USB_PATH as CONF_USB_PATH, CONF_USE_ADDON as CONF_USE_ADDON, DOMAIN as DOMAIN
 from _typeshed import Incomplete

homeassistant-stubs/config_entries.pyi

@@ -84,7 +84,6 @@ class ConfigEntryState(Enum):
 DEFAULT_DISCOVERY_UNIQUE_ID: str
 DISCOVERY_NOTIFICATION_ID: str
 DISCOVERY_SOURCES: Incomplete
-RECONFIGURE_NOTIFICATION_ID: str
 EVENT_FLOW_DISCOVERED: str
 SIGNAL_CONFIG_ENTRY_CHANGED: Incomplete
 
@@ -404,8 +403,6 @@ class ConfigFlow(ConfigEntryBaseFlow):
     async def _async_handle_discovery_without_unique_id(self) -> None: ...
     async def _async_step_discovery_without_unique_id(self) -> ConfigFlowResult: ...
     async def async_step_discovery(self, discovery_info: DiscoveryInfoType) -> ConfigFlowResult: ...
-    @callback
-    def async_abort(self, *, reason: str, description_placeholders: Mapping[str, str] | None = None) -> ConfigFlowResult: ...
     async def async_step_bluetooth(self, discovery_info: BluetoothServiceInfoBleak) -> ConfigFlowResult: ...
     async def async_step_dhcp(self, discovery_info: DhcpServiceInfo) -> ConfigFlowResult: ...
     async def async_step_hassio(self, discovery_info: HassioServiceInfo) -> ConfigFlowResult: ...
@@ -448,9 +445,9 @@ class ConfigSubentryFlow(data_entry_flow.FlowHandler[SubentryFlowContext, Subent
     @callback
     def async_update_and_abort(self, entry: ConfigEntry, subentry: ConfigSubentry, *, unique_id: str | None | UndefinedType = ..., title: str | UndefinedType = ..., data: Mapping[str, Any] | UndefinedType = ..., data_updates: Mapping[str, Any] | UndefinedType = ...) -> SubentryFlowResult: ...
     @property
-    def _reconfigure_entry_id(self) -> str: ...
+    def _entry_id(self) -> str: ...
     @callback
-    def _get_reconfigure_entry(self) -> ConfigEntry: ...
+    def _get_entry(self) -> ConfigEntry: ...
     @property
     def _reconfigure_subentry_id(self) -> str: ...
     @callback

homeassistant-stubs/helpers/backup.pyi

@@ -1,7 +1,7 @@
 import asyncio
 from collections.abc import Callable as Callable
 from dataclasses import dataclass, field
-from homeassistant.components.backup import BackupManager as BackupManager, ManagerStateEvent as ManagerStateEvent
+from homeassistant.components.backup import BackupManager as BackupManager, BackupPlatformEvent as BackupPlatformEvent, ManagerStateEvent as ManagerStateEvent
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.util.hass_dict import HassKey as HassKey
@@ -12,6 +12,7 @@ DATA_MANAGER: HassKey[BackupManager]
 @dataclass(slots=True)
 class BackupData:
     backup_event_subscriptions: list[Callable[[ManagerStateEvent], None]] = field(default_factory=list)
+    backup_platform_event_subscriptions: list[Callable[[BackupPlatformEvent], None]] = field(default_factory=list)
     manager_ready: asyncio.Future[None] = field(default_factory=asyncio.Future)
 
 @callback
@@ -19,3 +20,5 @@ def async_initialize_backup(hass: HomeAssistant) -> None: ...
 async def async_get_manager(hass: HomeAssistant) -> BackupManager: ...
 @callback
 def async_subscribe_events(hass: HomeAssistant, on_event: Callable[[ManagerStateEvent], None]) -> Callable[[], None]: ...
+@callback
+def async_subscribe_platform_events(hass: HomeAssistant, on_event: Callable[[BackupPlatformEvent], None]) -> Callable[[], None]: ...

homeassistant-stubs/helpers/config_entry_oauth2_flow.pyi

@@ -58,11 +58,25 @@ class LocalOAuth2Implementation(AbstractOAuth2Implementation):
     def redirect_uri(self) -> str: ...
     @property
     def extra_authorize_data(self) -> dict: ...
+    @property
+    def extra_token_resolve_data(self) -> dict: ...
     async def async_generate_authorize_url(self, flow_id: str) -> str: ...
     async def async_resolve_external_data(self, external_data: Any) -> dict: ...
     async def _async_refresh_token(self, token: dict) -> dict: ...
     async def _token_request(self, data: dict) -> dict: ...
 
+class LocalOAuth2ImplementationWithPkce(LocalOAuth2Implementation):
+    code_verifier: Incomplete
+    def __init__(self, hass: HomeAssistant, domain: str, client_id: str, authorize_url: str, token_url: str, client_secret: str = '', code_verifier_length: int = 128) -> None: ...
+    @property
+    def extra_authorize_data(self) -> dict: ...
+    @property
+    def extra_token_resolve_data(self) -> dict: ...
+    @staticmethod
+    def generate_code_verifier(code_verifier_length: int = 128) -> str: ...
+    @staticmethod
+    def compute_code_challenge(code_verifier: str) -> str: ...
+
 class AbstractOAuth2FlowHandler(config_entries.ConfigFlow, metaclass=ABCMeta):
     DOMAIN: str
     VERSION: int

homeassistant-stubs/helpers/config_validation.pyi

@@ -149,7 +149,6 @@ def key_value_schemas(key: str, value_schemas: dict[Hashable, VolSchemaType | Ca
 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: ...
-def expand_condition_shorthand(value: Any | None) -> Any: ...
 def empty_config_schema(domain: str) -> Callable[[dict], dict]: ...
 def _no_yaml_config_schema(domain: str, issue_base: str, translation_key: str, translation_placeholders: dict[str, str]) -> Callable[[dict], dict]: ...
 def config_entry_only_config_schema(domain: str) -> Callable[[dict], dict]: ...
@@ -202,10 +201,14 @@ NOT_CONDITION_SCHEMA: Incomplete
 NOT_CONDITION_SHORTHAND_SCHEMA: Incomplete
 DEVICE_CONDITION_BASE_SCHEMA: Incomplete
 DEVICE_CONDITION_SCHEMA: Incomplete
-dynamic_template_condition_action: Incomplete
+
+def expand_condition_shorthand(value: Any | None) -> Any: ...
+
+dynamic_template_condition: Incomplete
 CONDITION_SHORTHAND_SCHEMA: Incomplete
 CONDITION_SCHEMA: vol.Schema
 CONDITIONS_SCHEMA: Incomplete
+dynamic_template_condition_action: Incomplete
 CONDITION_ACTION_SCHEMA: vol.Schema
 
 def _trigger_pre_validator(value: Any | None) -> Any: ...

homeassistant-stubs/helpers/frame.pyi

@@ -3,15 +3,24 @@ import logging
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
 from dataclasses import dataclass
-from homeassistant.core import HomeAssistant as HomeAssistant, async_get_hass_or_none as async_get_hass_or_none
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.loader import Integration as Integration, async_get_issue_integration as async_get_issue_integration, async_suggest_report_issue as async_suggest_report_issue
+from homeassistant.util.async_ import run_callback_threadsafe as run_callback_threadsafe
 from propcache.api import cached_property
 from types import FrameType
 
 _LOGGER: Incomplete
 _REPORTED_INTEGRATIONS: set[str]
 
+class _Hass:
+    hass: HomeAssistant | None
+
+_hass: Incomplete
+
+@callback
+def async_setup(hass: HomeAssistant) -> None: ...
+
 @dataclass(kw_only=True)
 class IntegrationFrame:
     custom_integration: bool
@@ -32,15 +41,15 @@ def get_integration_frame(exclude_integrations: set | None = None) -> Integratio
 
 class MissingIntegrationFrame(HomeAssistantError): ...
 
-def report(what: str, *, exclude_integrations: set[str] | None = None, error_if_core: bool = True, error_if_integration: bool = False, level: int = ..., log_custom_component_only: bool = False) -> None: ...
-
 class ReportBehavior(enum.Enum):
     IGNORE = ...
     LOG = ...
     ERROR = ...
 
 def report_usage(what: str, *, breaks_in_ha_version: str | None = None, core_behavior: ReportBehavior = ..., core_integration_behavior: ReportBehavior = ..., custom_integration_behavior: ReportBehavior = ..., exclude_integrations: set[str] | None = None, integration_domain: str | None = None, level: int = ...) -> None: ...
-def _report_integration_domain(hass: HomeAssistant | None, what: str, breaks_in_ha_version: str | None, integration: Integration, core_integration_behavior: ReportBehavior, custom_integration_behavior: ReportBehavior, level: int) -> None: ...
-def _report_integration_frame(what: str, breaks_in_ha_version: str | None, integration_frame: IntegrationFrame, level: int = ..., error: bool = False) -> None: ...
+def _report_usage(hass: HomeAssistant, what: str, *, breaks_in_ha_version: str | None, core_behavior: ReportBehavior, core_integration_behavior: ReportBehavior, custom_integration_behavior: ReportBehavior, exclude_integrations: set[str] | None, integration_domain: str | None, level: int) -> None: ...
+def _report_usage_integration_domain(hass: HomeAssistant | None, what: str, breaks_in_ha_version: str | None, integration: Integration, core_integration_behavior: ReportBehavior, custom_integration_behavior: ReportBehavior, level: int) -> None: ...
+def _report_usage_integration_frame(hass: HomeAssistant, what: str, breaks_in_ha_version: str | None, integration_frame: IntegrationFrame, level: int = ..., error: bool = False) -> None: ...
+def _report_usage_no_integration(what: str, core_behavior: ReportBehavior, breaks_in_ha_version: str | None, err: MissingIntegrationFrame | None) -> None: ...
 def warn_use[_CallableT: Callable](func: _CallableT, what: str) -> _CallableT: ...
 def report_non_thread_safe_operation(what: str) -> None: ...

homeassistant-stubs/helpers/intent.pyi

@@ -19,7 +19,7 @@ from typing import Any
 
 _LOGGER: Incomplete
 type _SlotsType = dict[str, Any]
-type _IntentSlotsType = dict[str | tuple[str, str], VolSchemaType | Callable[[Any], Any]]
+type _IntentSlotsType = dict[str | tuple[str, str], IntentSlotInfo | VolSchemaType | Callable[[Any], Any]]
 INTENT_TURN_OFF: str
 INTENT_TURN_ON: str
 INTENT_TOGGLE: str
@@ -135,8 +135,9 @@ def _filter_by_name(name: str, candidates: Iterable[MatchTargetsCandidate]) -> I
 def _filter_by_features(features: int, candidates: Iterable[MatchTargetsCandidate]) -> Iterable[MatchTargetsCandidate]: ...
 def _filter_by_device_classes(device_classes: Iterable[str], candidates: Iterable[MatchTargetsCandidate]) -> Iterable[MatchTargetsCandidate]: ...
 def _add_areas(areas: area_registry.AreaRegistry, devices: device_registry.DeviceRegistry, candidates: Iterable[MatchTargetsCandidate]) -> None: ...
+def _default_area_candidate_filter(candidate: MatchTargetsCandidate, possible_area_ids: Collection[str]) -> bool: ...
 @callback
-def async_match_targets(hass: HomeAssistant, constraints: MatchTargetsConstraints, preferences: MatchTargetsPreferences | None = None, states: list[State] | None = None) -> MatchTargetsResult: ...
+def async_match_targets(hass: HomeAssistant, constraints: MatchTargetsConstraints, preferences: MatchTargetsPreferences | None = None, states: list[State] | None = None, area_candidate_filter: Callable[[MatchTargetsCandidate, Collection[str]], bool] = ...) -> MatchTargetsResult: ...
 @callback
 @bind_hass
 def async_match_states(hass: HomeAssistant, name: str | None = None, area_name: str | None = None, floor_name: str | None = None, domains: Collection[str] | None = None, device_classes: Collection[str] | None = None, states: list[State] | None = None, assistant: str | None = None) -> Iterable[State]: ...
@@ -160,6 +161,14 @@ class IntentHandler:
 
 def non_empty_string(value: Any) -> str: ...
 
+@dataclass(kw_only=True)
+class IntentSlotInfo:
+    service_data_name: str | None = ...
+    description: str | None = ...
+    value_schema: VolSchemaType | Callable[[Any], Any] = ...
+
+def _convert_slot_info(key: str | tuple[str, str], value: IntentSlotInfo | VolSchemaType | Callable[[Any], Any]) -> tuple[str, IntentSlotInfo]: ...
+
 class DynamicServiceIntentHandler(IntentHandler, metaclass=abc.ABCMeta):
     service_timeout: float
     intent_type: Incomplete
@@ -170,8 +179,8 @@ class DynamicServiceIntentHandler(IntentHandler, metaclass=abc.ABCMeta):
     description: Incomplete
     platforms: Incomplete
     device_classes: Incomplete
-    required_slots: _IntentSlotsType
-    optional_slots: _IntentSlotsType
+    required_slots: dict[str, IntentSlotInfo]
+    optional_slots: dict[str, IntentSlotInfo]
     def __init__(self, intent_type: 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: ...
     @cached_property
     def slot_schema(self) -> dict: ...

homeassistant-stubs/helpers/llm.pyi

@@ -23,6 +23,7 @@ ACTION_PARAMETERS_CACHE: HassKey[dict[str, dict[str, tuple[str | None, vol.Schem
 LLM_API_ASSIST: str
 BASE_PROMPT: str
 DEFAULT_INSTRUCTIONS_PROMPT: str
+NO_ENTITIES_PROMPT: str
 
 @callback
 def async_render_no_api_prompt(hass: HomeAssistant) -> str: ...
@@ -96,7 +97,7 @@ class AssistAPI(API):
     @callback
     def _async_get_tools(self, llm_context: LLMContext, exposed_entities: dict | None) -> list[Tool]: ...
 
-def _get_exposed_entities(hass: HomeAssistant, assistant: str) -> dict[str, dict[str, dict[str, Any]]]: ...
+def _get_exposed_entities(hass: HomeAssistant, assistant: str, include_state: bool = True) -> dict[str, dict[str, dict[str, Any]]]: ...
 def _selector_serializer(schema: Any) -> Any: ...
 def _get_cached_action_parameters(hass: HomeAssistant, domain: str, action: str) -> tuple[str | None, vol.Schema]: ...
 
@@ -117,3 +118,8 @@ class CalendarGetEventsTool(Tool):
     parameters: Incomplete
     def __init__(self, calendars: list[str]) -> None: ...
     async def async_call(self, hass: HomeAssistant, tool_input: ToolInput, llm_context: LLMContext) -> JsonObjectType: ...
+
+class GetHomeStateTool(Tool):
+    name: str
+    description: str
+    async def async_call(self, hass: HomeAssistant, tool_input: ToolInput, llm_context: LLMContext) -> JsonObjectType: ...

homeassistant-stubs/helpers/script.pyi

@@ -139,7 +139,7 @@ class _ScriptRun:
 
 class _QueuedScriptRun(_ScriptRun):
     lock_acquired: bool
-    async def async_run(self) -> None: ...
+    async def async_run(self) -> ScriptRunResult | None: ...
     def _finish(self) -> None: ...
 
 @callback

homeassistant-stubs/helpers/selector.pyi

@@ -42,6 +42,7 @@ class DeviceFilterSelectorConfig(TypedDict, total=False):
     integration: str
     manufacturer: str
     model: str
+    model_id: str
 
 class ActionSelectorConfig(TypedDict): ...
 

homeassistant-stubs/helpers/template.pyi

@@ -7,7 +7,7 @@ from .singleton import singleton as singleton
 from .translation import async_translate_state as async_translate_state
 from .typing import TemplateVarsType as TemplateVarsType
 from _typeshed import Incomplete, OptExcInfo as OptExcInfo
-from collections.abc import Callable as Callable, Generator, Iterable
+from collections.abc import Callable as Callable, Generator, Iterable, MutableSequence
 from contextlib import AbstractContextManager
 from contextvars import ContextVar
 from datetime import datetime, timedelta
@@ -255,6 +255,7 @@ def floors(hass: HomeAssistant) -> Iterable[str | None]: ...
 def floor_id(hass: HomeAssistant, lookup_value: Any) -> str | None: ...
 def floor_name(hass: HomeAssistant, lookup_value: str) -> str | None: ...
 def floor_areas(hass: HomeAssistant, floor_id_or_name: str) -> Iterable[str]: ...
+def floor_entities(hass: HomeAssistant, floor_id_or_name: str) -> Iterable[str]: ...
 def areas(hass: HomeAssistant) -> Iterable[str | None]: ...
 def area_id(hass: HomeAssistant, lookup_value: str) -> str | None: ...
 def _get_area_name(area_reg: area_registry.AreaRegistry, valid_area_id: str) -> str: ...
@@ -345,6 +346,18 @@ def time_until(hass: HomeAssistant, value: Any | datetime, precision: int = 1) -
 def urlencode(value): ...
 def slugify(value, separator: str = '_'): ...
 def iif(value: Any, if_true: Any = True, if_false: Any = False, if_none: Any = ...) -> Any: ...
+def shuffle(*args: Any, seed: Any = None) -> MutableSequence[Any]: ...
+def typeof(value: Any) -> Any: ...
+def flatten(value: Iterable[Any], levels: int | None = None) -> list[Any]: ...
+def intersect(value: Iterable[Any], other: Iterable[Any]) -> list[Any]: ...
+def difference(value: Iterable[Any], other: Iterable[Any]) -> list[Any]: ...
+def union(value: Iterable[Any], other: Iterable[Any]) -> list[Any]: ...
+def symmetric_difference(value: Iterable[Any], other: Iterable[Any]) -> list[Any]: ...
+def combine(*args: Any, recursive: bool = False) -> dict[Any, Any]: ...
+def md5(value: str) -> str: ...
+def sha1(value: str) -> str: ...
+def sha256(value: str) -> str: ...
+def sha512(value: str) -> str: ...
 
 class TemplateContextManager(AbstractContextManager):
     def set_template(self, template_str: str, action: str) -> None: ...

homeassistant-stubs/loader.pyi

@@ -15,7 +15,8 @@ from .generated.usb import USB as USB
 from .generated.zeroconf import HOMEKIT as HOMEKIT, ZEROCONF as ZEROCONF
 from .helpers import device_registry as dr
 from .helpers.json import json_bytes as json_bytes, json_fragment as json_fragment
-from .helpers.typing import ConfigType as ConfigType
+from .helpers.typing import ConfigType as ConfigType, UNDEFINED as UNDEFINED, UndefinedType as UndefinedType
+from .util.async_ import create_eager_task as create_eager_task
 from .util.hass_dict import HassKey as HassKey
 from .util.json import JSON_DECODE_EXCEPTIONS as JSON_DECODE_EXCEPTIONS, json_loads as json_loads
 from _typeshed import Incomplete
@@ -158,8 +159,7 @@ class Integration:
     pkg_path: Incomplete
     file_path: Incomplete
     manifest: Incomplete
-    _all_dependencies_resolved: bool | None
-    _all_dependencies: set[str] | None
+    _all_dependencies: set[str] | Exception | None
     _platforms_to_preload: Incomplete
     _component_future: asyncio.Future[ComponentProtocol] | None
     _import_futures: dict[str, asyncio.Future[ModuleType]]
@@ -227,7 +227,7 @@ class Integration:
     def all_dependencies(self) -> set[str]: ...
     @property
     def all_dependencies_resolved(self) -> bool: ...
-    async def resolve_dependencies(self) -> bool: ...
+    async def resolve_dependencies(self) -> set[str] | None: ...
     async def async_get_component(self) -> ComponentProtocol: ...
     def get_component(self) -> ComponentProtocol: ...
     def _get_component(self, preload_platforms: bool = False) -> ComponentProtocol: ...
@@ -250,6 +250,18 @@ def async_get_loaded_integration(hass: HomeAssistant, domain: str) -> Integratio
 async def async_get_integration(hass: HomeAssistant, domain: str) -> Integration: ...
 async def async_get_integrations(hass: HomeAssistant, domains: Iterable[str]) -> dict[str, Integration | Exception]: ...
 
+class _ResolveDependenciesCacheProtocol(Protocol):
+    def get(self, itg: Integration) -> set[str] | Exception | None: ...
+    def __setitem__(self, itg: Integration, all_dependencies: set[str] | Exception) -> None: ...
+
+class _ResolveDependenciesCache(_ResolveDependenciesCacheProtocol):
+    def get(self, itg: Integration) -> set[str] | Exception | None: ...
+    def __setitem__(self, itg: Integration, all_dependencies: set[str] | Exception) -> None: ...
+
+async def resolve_integrations_dependencies(hass: HomeAssistant, integrations: Iterable[Integration]) -> dict[str, set[str]]: ...
+async def resolve_integrations_after_dependencies(hass: HomeAssistant, integrations: Iterable[Integration], possible_after_dependencies: set[str] | None = None, *, ignore_exceptions: bool = False) -> dict[str, set[str]]: ...
+async def _do_resolve_dependencies(itg: Integration, *, cache: _ResolveDependenciesCacheProtocol, possible_after_dependencies: set[str] | None | UndefinedType = ..., ignore_exceptions: bool = False) -> set[str]: ...
+
 class LoaderError(Exception): ...
 
 class IntegrationNotFound(LoaderError):
@@ -261,9 +273,8 @@ class IntegrationNotLoaded(LoaderError):
     def __init__(self, domain: str) -> None: ...
 
 class CircularDependency(LoaderError):
-    from_domain: Incomplete
-    to_domain: Incomplete
-    def __init__(self, from_domain: str | set[str], to_domain: str) -> None: ...
+    def __init__(self, domain_cycle: list[str]) -> None: ...
+    def extend_cycle(self, domain: str) -> None: ...
 
 def _load_file(hass: HomeAssistant, comp_or_platform: str, base_paths: list[str]) -> ComponentProtocol | None: ...
 
@@ -284,7 +295,6 @@ class Helpers:
     def __getattr__(self, helper_name: str) -> ModuleWrapper: ...
 
 def bind_hass[_CallableT: Callable[..., Any]](func: _CallableT) -> _CallableT: ...
-async def _async_component_dependencies(hass: HomeAssistant, integration: Integration) -> set[str]: ...
 def _async_mount_config_dir(hass: HomeAssistant) -> None: ...
 def _lookup_path(hass: HomeAssistant) -> list[str]: ...
 def is_component_module_loaded(hass: HomeAssistant, module: str) -> bool: ...

homeassistant-stubs/scripts/check_config.pyi

@@ -5,7 +5,6 @@ from homeassistant.config import get_default_config_dir as get_default_config_di
 from homeassistant.config_entries import ConfigEntries as ConfigEntries
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.helpers.check_config import async_check_ha_config_file as async_check_ha_config_file
-from homeassistant.util.yaml import Secrets as Secrets
 from typing import Any
 
 REQUIREMENTS: Incomplete

homeassistant-stubs/util/logging.pyi

@@ -1,8 +1,25 @@
 import logging
 import logging.handlers
+from _typeshed import Incomplete
 from collections.abc import Callable, Coroutine
 from homeassistant.core import HassJobType as HassJobType, HomeAssistant as HomeAssistant, callback as callback, get_hassjob_callable_job_type as get_hassjob_callable_job_type
-from typing import Any, overload
+from queue import SimpleQueue
+from typing import Any, overload, override
+
+_LOGGER: Incomplete
+
+class HomeAssistantQueueListener(logging.handlers.QueueListener):
+    LOG_COUNTS_RESET_INTERVAL: int
+    MAX_LOGS_COUNT: int
+    EXCLUDED_LOG_COUNT_MODULES: Incomplete
+    _last_reset: float
+    _log_counts: dict[str, int]
+    _module_log_count_skip_flags: dict[str, bool]
+    def __init__(self, queue: SimpleQueue[logging.Handler], *handlers: logging.Handler) -> None: ...
+    @override
+    def handle(self, record: logging.LogRecord) -> None: ...
+    def _reset_counters(self, time_sec: float) -> None: ...
+    def _update_skip_flags(self, module_name: str) -> bool: ...
 
 class HomeAssistantQueueHandler(logging.handlers.QueueHandler):
     listener: logging.handlers.QueueListener | None

homeassistant-stubs/util/unit_conversion.pyi

@@ -58,6 +58,9 @@ class BaseUnitConverter:
     def get_unit_ratio(cls, from_unit: str | None, to_unit: str | None) -> float: ...
     @classmethod
     @lru_cache
+    def get_unit_floored_log_ratio(cls, from_unit: str | None, to_unit: str | None) -> float: ...
+    @classmethod
+    @lru_cache
     def _are_unit_inverses(cls, from_unit: str | None, to_unit: str | None) -> bool: ...
 
 class DataRateConverter(BaseUnitConverter):

homeassistant-stubs/util/unit_system.pyi

@@ -1,5 +1,6 @@
 from .unit_conversion import AreaConverter as AreaConverter, DistanceConverter as DistanceConverter, PressureConverter as PressureConverter, SpeedConverter as SpeedConverter, TemperatureConverter as TemperatureConverter, VolumeConverter as VolumeConverter
 from _typeshed import Incomplete
+from dataclasses import dataclass
 from homeassistant.components.sensor import SensorDeviceClass as SensorDeviceClass
 from homeassistant.const import ACCUMULATED_PRECIPITATION as ACCUMULATED_PRECIPITATION, AREA as AREA, LENGTH as LENGTH, MASS as MASS, PRESSURE as PRESSURE, TEMPERATURE as TEMPERATURE, UNIT_NOT_RECOGNIZED_TEMPLATE as UNIT_NOT_RECOGNIZED_TEMPLATE, UnitOfArea as UnitOfArea, UnitOfLength as UnitOfLength, UnitOfMass as UnitOfMass, UnitOfPrecipitationDepth as UnitOfPrecipitationDepth, UnitOfPressure as UnitOfPressure, UnitOfSpeed as UnitOfSpeed, UnitOfTemperature as UnitOfTemperature, UnitOfVolume as UnitOfVolume, UnitOfVolumetricFlux as UnitOfVolumetricFlux, VOLUME as VOLUME, WIND_SPEED as WIND_SPEED
 from typing import Final
@@ -18,17 +19,18 @@ _VALID_BY_TYPE: dict[str, set[str] | set[str | None]]
 
 def _is_valid_unit(unit: str, unit_type: str) -> bool: ...
 
+@dataclass(frozen=True, kw_only=True)
 class UnitSystem:
-    _name: Incomplete
-    accumulated_precipitation_unit: Incomplete
-    area_unit: Incomplete
-    length_unit: Incomplete
-    mass_unit: Incomplete
-    pressure_unit: Incomplete
-    temperature_unit: Incomplete
-    volume_unit: Incomplete
-    wind_speed_unit: Incomplete
-    _conversions: Incomplete
+    _name: str
+    accumulated_precipitation_unit: UnitOfPrecipitationDepth
+    area_unit: UnitOfArea
+    length_unit: UnitOfLength
+    mass_unit: UnitOfMass
+    pressure_unit: UnitOfPressure
+    temperature_unit: UnitOfTemperature
+    volume_unit: UnitOfVolume
+    wind_speed_unit: UnitOfSpeed
+    _conversions: dict[tuple[SensorDeviceClass | str | None, str | None], str]
     def __init__(self, name: str, *, accumulated_precipitation: UnitOfPrecipitationDepth, area: UnitOfArea, conversions: dict[tuple[SensorDeviceClass | str | None, str | None], str], length: UnitOfLength, mass: UnitOfMass, pressure: UnitOfPressure, temperature: UnitOfTemperature, volume: UnitOfVolume, wind_speed: UnitOfSpeed) -> None: ...
     def temperature(self, temperature: float, from_unit: str) -> float: ...
     def length(self, length: float | None, from_unit: str) -> float: ...

homeassistant-stubs/util/yaml/__init__.pyi

@@ -1,7 +1,6 @@
-from .const import SECRET_YAML as SECRET_YAML
 from .dumper import dump as dump, save_yaml as save_yaml
-from .input import UndefinedSubstitution as UndefinedSubstitution, extract_inputs as extract_inputs, substitute as substitute
-from .loader import Secrets as Secrets, YamlTypeError as YamlTypeError, load_yaml as load_yaml, load_yaml_dict as load_yaml_dict, parse_yaml as parse_yaml, secret_yaml as secret_yaml
-from .objects import Input as Input
+from .loader import Secrets as Secrets, load_yaml as load_yaml, load_yaml_dict as load_yaml_dict, parse_yaml as parse_yaml, secret_yaml as secret_yaml
+from annotatedyaml import Input as Input, SECRET_YAML as SECRET_YAML, YamlTypeError as YamlTypeError
+from annotatedyaml.input import UndefinedSubstitution as UndefinedSubstitution, extract_inputs as extract_inputs, substitute as substitute
 
 __all__ = ['SECRET_YAML', 'Input', 'Secrets', 'UndefinedSubstitution', 'YamlTypeError', 'dump', 'extract_inputs', 'load_yaml', 'load_yaml_dict', 'parse_yaml', 'save_yaml', 'secret_yaml', 'substitute']

homeassistant-stubs/util/yaml/dumper.pyi

@@ -1,9 +1,3 @@
-import yaml
-from .objects import Input as Input, NodeDictClass as NodeDictClass, NodeListClass as NodeListClass, NodeStrClass as NodeStrClass
-from _typeshed import Incomplete
-from typing import Any
+from annotatedyaml.dumper import add_representer as add_representer, dump as dump, represent_odict as represent_odict, save_yaml as save_yaml
 
-def dump(_dict: dict | list) -> str: ...
-def save_yaml(path: str, data: dict) -> None: ...
-def represent_odict(dumper, tag, mapping, flow_style: Incomplete | None = None) -> yaml.MappingNode: ...
-def add_representer(klass: Any, representer: Any) -> None: ...
+__all__ = ['add_representer', 'dump', 'represent_odict', 'save_yaml']

homeassistant-stubs/util/yaml/input.pyi

@@ -1,11 +1,4 @@
 from .objects import Input as Input
-from _typeshed import Incomplete
-from typing import Any
+from annotatedyaml.input import UndefinedSubstitution as UndefinedSubstitution, extract_inputs as extract_inputs, substitute as substitute
 
-class UndefinedSubstitution(Exception):
-    input: Incomplete
-    def __init__(self, input_name: str) -> None: ...
-
-def extract_inputs(obj: Any) -> set[str]: ...
-def _extract_inputs(obj: Any, found: set[str]) -> None: ...
-def substitute(obj: Any, substitutions: dict[str, Any]) -> Any: ...
+__all__ = ['Input', 'UndefinedSubstitution', 'extract_inputs', 'substitute']