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

homeassistant-stubs/components/lovelace/dashboard.pyi

@@ -0,0 +1,83 @@
+import abc
+from .const import CONF_ALLOW_SINGLE_WORD as CONF_ALLOW_SINGLE_WORD, CONF_ICON as CONF_ICON, CONF_URL_PATH as CONF_URL_PATH, ConfigNotFound as ConfigNotFound, DOMAIN as DOMAIN, EVENT_LOVELACE_UPDATED as EVENT_LOVELACE_UPDATED, LOVELACE_CONFIG_FILE as LOVELACE_CONFIG_FILE, LOVELACE_DATA as LOVELACE_DATA, MODE_STORAGE as MODE_STORAGE, MODE_YAML as MODE_YAML, STORAGE_DASHBOARD_CREATE_FIELDS as STORAGE_DASHBOARD_CREATE_FIELDS, STORAGE_DASHBOARD_UPDATE_FIELDS as STORAGE_DASHBOARD_UPDATE_FIELDS
+from _typeshed import Incomplete
+from abc import ABC, abstractmethod
+from homeassistant.components import websocket_api as websocket_api
+from homeassistant.components.frontend import DATA_PANELS as DATA_PANELS
+from homeassistant.const import CONF_FILENAME as CONF_FILENAME
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.helpers import collection as collection, storage as storage
+from homeassistant.helpers.json import json_bytes as json_bytes, json_fragment as json_fragment
+from homeassistant.util.yaml import Secrets as Secrets, load_yaml_dict as load_yaml_dict
+from typing import Any
+
+CONFIG_STORAGE_KEY_DEFAULT = DOMAIN
+CONFIG_STORAGE_KEY: str
+CONFIG_STORAGE_VERSION: int
+DASHBOARDS_STORAGE_KEY: Incomplete
+DASHBOARDS_STORAGE_VERSION: int
+_LOGGER: Incomplete
+
+class LovelaceConfig(ABC, metaclass=abc.ABCMeta):
+    hass: Incomplete
+    config: dict[str, Any] | None
+    def __init__(self, hass: HomeAssistant, url_path: str | None, config: dict[str, Any] | None) -> None: ...
+    @property
+    def url_path(self) -> str | None: ...
+    @property
+    @abstractmethod
+    def mode(self) -> str: ...
+    @abstractmethod
+    async def async_get_info(self) -> dict[str, Any]: ...
+    @abstractmethod
+    async def async_load(self, force: bool) -> dict[str, Any]: ...
+    async def async_save(self, config: dict[str, Any]) -> None: ...
+    async def async_delete(self) -> None: ...
+    @abstractmethod
+    async def async_json(self, force: bool) -> json_fragment: ...
+    @callback
+    def _config_updated(self) -> None: ...
+
+class LovelaceStorage(LovelaceConfig):
+    _store: Incomplete
+    _data: dict[str, Any] | None
+    _json_config: json_fragment | None
+    def __init__(self, hass: HomeAssistant, config: dict[str, Any] | None) -> None: ...
+    @property
+    def mode(self) -> str: ...
+    async def async_get_info(self) -> dict[str, Any]: ...
+    async def async_load(self, force: bool) -> dict[str, Any]: ...
+    async def async_json(self, force: bool) -> json_fragment: ...
+    async def async_save(self, config: dict[str, Any]) -> None: ...
+    async def async_delete(self) -> None: ...
+    async def _load(self) -> dict[str, Any]: ...
+    @callback
+    def _async_build_json(self) -> json_fragment: ...
+
+class LovelaceYAML(LovelaceConfig):
+    path: Incomplete
+    _cache: tuple[dict[str, Any], float, json_fragment] | None
+    def __init__(self, hass: HomeAssistant, url_path: str | None, config: dict[str, Any] | None) -> None: ...
+    @property
+    def mode(self) -> str: ...
+    async def async_get_info(self) -> dict[str, Any]: ...
+    async def async_load(self, force: bool) -> dict[str, Any]: ...
+    async def async_json(self, force: bool) -> json_fragment: ...
+    async def _async_load_or_cached(self, force: bool) -> tuple[dict[str, Any], json_fragment]: ...
+    def _load_config(self, force: bool) -> tuple[bool, dict[str, Any], json_fragment]: ...
+
+def _config_info(mode: str, config: dict[str, Any]) -> dict[str, Any]: ...
+
+class DashboardsCollection(collection.DictStorageCollection):
+    CREATE_SCHEMA: Incomplete
+    UPDATE_SCHEMA: Incomplete
+    def __init__(self, hass: HomeAssistant) -> None: ...
+    async def _process_create_data(self, data: dict) -> dict: ...
+    @callback
+    def _get_suggested_id(self, info: dict) -> str: ...
+    async def _update_data(self, item: dict, update_data: dict) -> dict: ...
+
+class DashboardsCollectionWebSocket(collection.DictStorageCollectionWebsocket):
+    @callback
+    def ws_list_item(self, hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...

homeassistant-stubs/components/lovelace/resources.pyi

@@ -0,0 +1,42 @@
+from .const import CONF_RESOURCE_TYPE_WS as CONF_RESOURCE_TYPE_WS, DOMAIN as DOMAIN, RESOURCE_CREATE_FIELDS as RESOURCE_CREATE_FIELDS, RESOURCE_SCHEMA as RESOURCE_SCHEMA, RESOURCE_UPDATE_FIELDS as RESOURCE_UPDATE_FIELDS
+from .dashboard import LovelaceConfig as LovelaceConfig
+from .websocket import websocket_lovelace_resources_impl as websocket_lovelace_resources_impl
+from _typeshed import Incomplete
+from homeassistant.components import websocket_api as websocket_api
+from homeassistant.const import CONF_ID as CONF_ID, CONF_RESOURCES as CONF_RESOURCES, CONF_TYPE as CONF_TYPE
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.helpers import collection as collection, storage as storage
+from typing import Any
+
+RESOURCE_STORAGE_KEY: Incomplete
+RESOURCES_STORAGE_VERSION: int
+_LOGGER: Incomplete
+
+class ResourceYAMLCollection:
+    loaded: bool
+    data: Incomplete
+    def __init__(self, data: list[dict[str, Any]]) -> None: ...
+    async def async_get_info(self) -> dict[str, int]: ...
+    @callback
+    def async_items(self) -> list[dict]: ...
+
+class ResourceStorageCollection(collection.DictStorageCollection):
+    loaded: bool
+    CREATE_SCHEMA: Incomplete
+    UPDATE_SCHEMA: Incomplete
+    ll_config: Incomplete
+    def __init__(self, hass: HomeAssistant, ll_config: LovelaceConfig) -> None: ...
+    async def async_get_info(self) -> dict[str, int]: ...
+    async def _async_load_data(self) -> collection.SerializedStorageCollection | None: ...
+    async def _process_create_data(self, data: dict) -> dict: ...
+    @callback
+    def _get_suggested_id(self, info: dict) -> str: ...
+    async def _update_data(self, item: dict, update_data: dict) -> dict: ...
+
+class ResourceStorageCollectionWebsocket(collection.DictStorageCollectionWebsocket):
+    @callback
+    def async_setup(self, hass: HomeAssistant) -> None: ...
+    @staticmethod
+    @websocket_api.async_response
+    async def ws_list_item(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...

homeassistant-stubs/components/lovelace/system_health.pyi

@@ -0,0 +1,9 @@
+from .const import LOVELACE_DATA as LOVELACE_DATA, MODE_AUTO as MODE_AUTO, MODE_STORAGE as MODE_STORAGE, MODE_YAML as MODE_YAML
+from homeassistant.components import system_health as system_health
+from homeassistant.const import CONF_MODE as CONF_MODE
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from typing import Any
+
+@callback
+def async_register(hass: HomeAssistant, register: system_health.SystemHealthRegistration) -> None: ...
+async def system_health_info(hass: HomeAssistant) -> dict[str, Any]: ...

homeassistant-stubs/components/lovelace/websocket.pyi

@@ -0,0 +1,26 @@
+from .const import CONF_URL_PATH as CONF_URL_PATH, ConfigNotFound as ConfigNotFound, LOVELACE_DATA as LOVELACE_DATA
+from .dashboard import LovelaceConfig as LovelaceConfig
+from .resources import ResourceStorageCollection as ResourceStorageCollection
+from collections.abc import Awaitable, Callable
+from homeassistant.components import websocket_api as websocket_api
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.helpers.json import json_fragment as json_fragment
+from typing import Any
+
+type AsyncLovelaceWebSocketCommandHandler[_R] = Callable[[HomeAssistant, websocket_api.ActiveConnection, dict[str, Any], LovelaceConfig], Awaitable[_R]]
+def _handle_errors[_R](func: AsyncLovelaceWebSocketCommandHandler[_R]) -> websocket_api.AsyncWebSocketCommandHandler: ...
+@websocket_api.async_response
+async def websocket_lovelace_resources(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+async def websocket_lovelace_resources_impl(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.async_response
+@_handle_errors
+async def websocket_lovelace_config(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any], config: LovelaceConfig) -> json_fragment: ...
+@websocket_api.require_admin
+@websocket_api.async_response
+@_handle_errors
+async def websocket_lovelace_save_config(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any], config: LovelaceConfig) -> None: ...
+@websocket_api.require_admin
+@websocket_api.async_response
+@_handle_errors
+async def websocket_lovelace_delete_config(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any], config: LovelaceConfig) -> None: ...

homeassistant-stubs/components/mastodon/config_flow.pyi

@@ -1,8 +1,8 @@
-from .const import CONF_BASE_URL as CONF_BASE_URL, DEFAULT_URL as DEFAULT_URL, DOMAIN as DOMAIN, LOGGER as LOGGER
+from .const import CONF_BASE_URL as CONF_BASE_URL, DOMAIN as DOMAIN, LOGGER as LOGGER
 from .utils import construct_mastodon_username as construct_mastodon_username, create_mastodon_client as create_mastodon_client
 from _typeshed import Incomplete
 from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult
-from homeassistant.const import CONF_ACCESS_TOKEN as CONF_ACCESS_TOKEN, CONF_CLIENT_ID as CONF_CLIENT_ID, CONF_CLIENT_SECRET as CONF_CLIENT_SECRET, CONF_NAME as CONF_NAME
+from homeassistant.const import CONF_ACCESS_TOKEN as CONF_ACCESS_TOKEN, CONF_CLIENT_ID as CONF_CLIENT_ID, CONF_CLIENT_SECRET as CONF_CLIENT_SECRET
 from homeassistant.helpers.selector import TextSelector as TextSelector, TextSelectorConfig as TextSelectorConfig, TextSelectorType as TextSelectorType
 from homeassistant.util import slugify as slugify
 from typing import Any
@@ -17,4 +17,3 @@ class MastodonConfigFlow(ConfigFlow, domain=DOMAIN):
     def check_connection(self, base_url: str, client_id: str, client_secret: str, access_token: str) -> tuple[dict[str, str] | None, dict[str, str] | None, dict[str, str]]: ...
     def show_user_form(self, user_input: dict[str, Any] | None = None, errors: dict[str, str] | None = None, description_placeholders: dict[str, str] | None = None, step_id: str = 'user') -> ConfigFlowResult: ...
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
-    async def async_step_import(self, import_data: dict[str, Any]) -> ConfigFlowResult: ...

homeassistant-stubs/components/mastodon/notify.pyi

@@ -1,10 +1,8 @@
-from .const import CONF_BASE_URL as CONF_BASE_URL, DEFAULT_URL as DEFAULT_URL, DOMAIN as DOMAIN, LOGGER as LOGGER
+from .const import CONF_BASE_URL as CONF_BASE_URL, DEFAULT_URL as DEFAULT_URL, LOGGER as LOGGER
 from _typeshed import Incomplete
 from homeassistant.components.notify import ATTR_DATA as ATTR_DATA, BaseNotificationService as BaseNotificationService
-from homeassistant.config_entries import SOURCE_IMPORT as SOURCE_IMPORT
 from homeassistant.const import CONF_ACCESS_TOKEN as CONF_ACCESS_TOKEN, CONF_CLIENT_ID as CONF_CLIENT_ID, CONF_CLIENT_SECRET as CONF_CLIENT_SECRET
 from homeassistant.core import HomeAssistant as HomeAssistant
-from homeassistant.data_entry_flow import FlowResultType as FlowResultType
 from homeassistant.helpers.typing import ConfigType as ConfigType, DiscoveryInfoType as DiscoveryInfoType
 from mastodon import Mastodon as Mastodon
 from typing import Any

homeassistant-stubs/components/matter/config_flow.pyi

@@ -5,7 +5,6 @@ from .const import ADDON_SLUG as ADDON_SLUG, CONF_INTEGRATION_CREATED_ADDON as C
 from _typeshed import Incomplete
 from homeassistant.components.hassio import AddonError as AddonError, AddonInfo as AddonInfo, AddonManager as AddonManager, AddonState as AddonState
 from homeassistant.components.onboarding import async_is_onboarded as async_is_onboarded
-from homeassistant.components.zeroconf import ZeroconfServiceInfo as ZeroconfServiceInfo
 from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult
 from homeassistant.const import CONF_URL as CONF_URL
 from homeassistant.core import HomeAssistant as HomeAssistant
@@ -14,6 +13,7 @@ from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.helpers import aiohttp_client as aiohttp_client
 from homeassistant.helpers.hassio import is_hassio as is_hassio
 from homeassistant.helpers.service_info.hassio import HassioServiceInfo as HassioServiceInfo
+from homeassistant.helpers.service_info.zeroconf import ZeroconfServiceInfo as ZeroconfServiceInfo
 from typing import Any
 
 ADDON_SETUP_TIMEOUT: int

homeassistant-stubs/components/matter/cover.pyi

@@ -31,7 +31,6 @@ class MatterCover(MatterEntity, CoverEntity):
     async def async_close_cover(self, **kwargs: Any) -> None: ...
     async def async_set_cover_position(self, **kwargs: Any) -> None: ...
     async def async_set_cover_tilt_position(self, **kwargs: Any) -> None: ...
-    async def send_device_command(self, command: Any) -> None: ...
     _attr_is_opening: bool
     _attr_is_closing: bool
     _attr_current_cover_position: Incomplete

homeassistant-stubs/components/matter/discovery.pyi

@@ -1,7 +1,7 @@
 from .const import FEATUREMAP_ATTRIBUTE_ID as FEATUREMAP_ATTRIBUTE_ID
-from .models import MatterDiscoverySchema as MatterDiscoverySchema, MatterEntityInfo as MatterEntityInfo
+from .models import MatterDiscoverySchema as MatterDiscoverySchema, MatterEntityInfo as MatterEntityInfo, UNSET as UNSET
 from _typeshed import Incomplete
-from chip.clusters.Objects import ClusterAttributeDescriptor as ClusterAttributeDescriptor
+from chip.clusters.ClusterObjects import ClusterAttributeDescriptor as ClusterAttributeDescriptor
 from collections.abc import Generator
 from homeassistant.const import Platform as Platform
 from homeassistant.core import callback as callback

homeassistant-stubs/components/matter/entity.pyi

@@ -2,21 +2,24 @@ from .const import DOMAIN as DOMAIN, FEATUREMAP_ATTRIBUTE_ID as FEATUREMAP_ATTRI
 from .discovery import MatterEntityInfo as MatterEntityInfo
 from .helpers import get_device_id as get_device_id
 from _typeshed import Incomplete
-from chip.clusters.Objects import ClusterAttributeDescriptor as ClusterAttributeDescriptor
-from collections.abc import Callable as Callable
+from chip.clusters.Objects import ClusterAttributeDescriptor as ClusterAttributeDescriptor, ClusterCommand as ClusterCommand
+from collections.abc import Callable as Callable, Coroutine
 from dataclasses import dataclass
 from homeassistant.core import callback as callback
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.helpers.device_registry import DeviceInfo as DeviceInfo
 from homeassistant.helpers.entity import Entity as Entity, EntityDescription as EntityDescription
 from homeassistant.helpers.typing import UndefinedType as UndefinedType
 from matter_server.client import MatterClient as MatterClient
 from matter_server.client.models.node import MatterEndpoint as MatterEndpoint
 from matter_server.common.models import EventType
-from propcache import cached_property
-from typing import Any
+from propcache.api import cached_property
+from typing import Any, Concatenate
 
 LOGGER: Incomplete
 
+def catch_matter_error[_R, **P](func: Callable[Concatenate[MatterEntity, P], Coroutine[Any, Any, _R]]) -> Callable[Concatenate[MatterEntity, P], Coroutine[Any, Any, _R]]: ...
+
 @dataclass(frozen=True)
 class MatterEntityDescription(EntityDescription):
     measurement_to_ha: Callable[[Any], Any] | None = ...
@@ -52,3 +55,7 @@ class MatterEntity(Entity):
     def get_matter_attribute_value(self, attribute: type[ClusterAttributeDescriptor], null_as_none: bool = True) -> Any: ...
     @callback
     def get_matter_attribute_path(self, attribute: type[ClusterAttributeDescriptor]) -> str: ...
+    @catch_matter_error
+    async def send_device_command(self, command: ClusterCommand, **kwargs: Any) -> None: ...
+    @catch_matter_error
+    async def write_attribute(self, value: Any, matter_attribute: type[ClusterAttributeDescriptor] | None = None) -> Any: ...

homeassistant-stubs/components/matter/light.pyi

@@ -34,7 +34,6 @@ class MatterLight(MatterEntity, LightEntity):
     def _get_color_temperature(self) -> int: ...
     def _get_brightness(self) -> int: ...
     def _get_color_mode(self) -> ColorMode: ...
-    async def send_device_command(self, command: Any) -> None: ...
     async def async_turn_on(self, **kwargs: Any) -> None: ...
     async def async_turn_off(self, **kwargs: Any) -> None: ...
     _attr_supported_color_modes: Incomplete

homeassistant-stubs/components/matter/lock.pyi

@@ -4,7 +4,6 @@ from .entity import MatterEntity as MatterEntity
 from .helpers import get_matter as get_matter
 from .models import MatterDiscoverySchema as MatterDiscoverySchema
 from _typeshed import Incomplete
-from chip.clusters import Objects as clusters
 from homeassistant.components.lock import LockEntity as LockEntity, LockEntityDescription as LockEntityDescription, LockEntityFeature as LockEntityFeature
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import ATTR_CODE as ATTR_CODE, Platform as Platform
@@ -22,7 +21,6 @@ class MatterLock(MatterEntity, LockEntity):
     _platform_translation_key: str
     @property
     def code_format(self) -> str | None: ...
-    async def send_device_command(self, command: clusters.ClusterCommand, timed_request_timeout_ms: int = 1000) -> None: ...
     _attr_is_locking: bool
     async def async_lock(self, **kwargs: Any) -> None: ...
     _attr_is_unlocking: bool

homeassistant-stubs/components/matter/models.pyi

@@ -1,3 +1,4 @@
+from _typeshed import Incomplete
 from chip.clusters import Objects as clusters
 from chip.clusters.Objects import Cluster as Cluster, ClusterAttributeDescriptor as ClusterAttributeDescriptor
 from dataclasses import dataclass
@@ -8,6 +9,10 @@ from matter_server.client.models.node import MatterEndpoint as MatterEndpoint
 from typing import Any, TypedDict
 
 type SensorValueTypes = type[clusters.uint | int | clusters.Nullable | clusters.float32 | float]
+class _UNSET_TYPE: ...
+
+UNSET: Incomplete
+
 class MatterDeviceInfo(TypedDict):
     unique_id: str
     vendor_id: str
@@ -38,6 +43,10 @@ class MatterDiscoverySchema:
     absent_attributes: tuple[type[ClusterAttributeDescriptor], ...] | None = ...
     absent_clusters: tuple[type[Cluster], ...] | None = ...
     optional_attributes: tuple[type[ClusterAttributeDescriptor], ...] | None = ...
-    value_contains: Any | None = ...
     featuremap_contains: int | None = ...
     allow_multi: bool = ...
+    allow_none_value: bool = ...
+    value_contains: Any = ...
+    secondary_value_contains: Any = ...
+    value_is_not: Any = ...
+    secondary_value_is_not: Any = ...

homeassistant-stubs/components/matter/number.pyi

@@ -5,7 +5,7 @@ from _typeshed import Incomplete
 from dataclasses import dataclass
 from homeassistant.components.number import NumberDeviceClass as NumberDeviceClass, NumberEntity as NumberEntity, NumberEntityDescription as NumberEntityDescription, NumberMode as NumberMode
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
-from homeassistant.const import EntityCategory as EntityCategory, Platform as Platform, UnitOfLength as UnitOfLength, UnitOfTime as UnitOfTime
+from homeassistant.const import EntityCategory as EntityCategory, Platform as Platform, UnitOfLength as UnitOfLength, UnitOfTemperature as UnitOfTemperature, UnitOfTime as UnitOfTime
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 

homeassistant-stubs/components/matter/select.pyi

@@ -3,7 +3,9 @@ from .helpers import get_matter as get_matter
 from .models import MatterDiscoverySchema as MatterDiscoverySchema
 from _typeshed import Incomplete
 from chip.clusters import Objects as clusters
+from chip.clusters.ClusterObjects import ClusterAttributeDescriptor as ClusterAttributeDescriptor, ClusterCommand as ClusterCommand
 from chip.clusters.Types import Nullable as Nullable
+from collections.abc import Callable as Callable
 from dataclasses import dataclass
 from homeassistant.components.select import SelectEntity as SelectEntity, SelectEntityDescription as SelectEntityDescription
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
@@ -11,20 +13,40 @@ from homeassistant.const import EntityCategory as EntityCategory, Platform as Pl
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 
+NUMBER_OF_RINSES_STATE_MAP: Incomplete
+NUMBER_OF_RINSES_STATE_MAP_REVERSE: Incomplete
 type SelectCluster = clusters.ModeSelect | clusters.OvenMode | clusters.LaundryWasherMode | clusters.RefrigeratorAndTemperatureControlledCabinetMode | clusters.RvcRunMode | clusters.RvcCleanMode | clusters.DishwasherMode | clusters.EnergyEvseMode | clusters.DeviceEnergyManagementMode
+
 async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 
 @dataclass(frozen=True)
 class MatterSelectEntityDescription(SelectEntityDescription, MatterEntityDescription): ...
 
-class MatterSelectEntity(MatterEntity, SelectEntity):
+@dataclass(frozen=True, kw_only=True)
+class MatterMapSelectEntityDescription(MatterSelectEntityDescription):
+    measurement_to_ha: Callable[[int], str | None]
+    ha_to_native_value: Callable[[str], int | None]
+    list_attribute: type[ClusterAttributeDescriptor]
+
+@dataclass(frozen=True, kw_only=True)
+class MatterListSelectEntityDescription(MatterSelectEntityDescription):
+    list_attribute: type[ClusterAttributeDescriptor]
+    command: Callable[[int], ClusterCommand] | None = ...
+
+class MatterAttributeSelectEntity(MatterEntity, SelectEntity):
     entity_description: MatterSelectEntityDescription
     async def async_select_option(self, option: str) -> None: ...
     _attr_current_option: Incomplete
     @callback
     def _update_from_device(self) -> None: ...
 
-class MatterModeSelectEntity(MatterSelectEntity):
+class MatterMapSelectEntity(MatterAttributeSelectEntity):
+    entity_description: MatterMapSelectEntityDescription
+    _attr_options: Incomplete
+    @callback
+    def _update_from_device(self) -> None: ...
+
+class MatterModeSelectEntity(MatterAttributeSelectEntity):
     async def async_select_option(self, option: str) -> None: ...
     _attr_options: Incomplete
     _attr_current_option: Incomplete
@@ -32,4 +54,12 @@ class MatterModeSelectEntity(MatterSelectEntity):
     @callback
     def _update_from_device(self) -> None: ...
 
+class MatterListSelectEntity(MatterEntity, SelectEntity):
+    entity_description: MatterListSelectEntityDescription
+    async def async_select_option(self, option: str) -> None: ...
+    _attr_options: Incomplete
+    _attr_current_option: Incomplete
+    @callback
+    def _update_from_device(self) -> None: ...
+
 DISCOVERY_SCHEMAS: Incomplete

homeassistant-stubs/components/matter/sensor.pyi

@@ -2,6 +2,7 @@ from .entity import MatterEntity as MatterEntity, MatterEntityDescription as Mat
 from .helpers import get_matter as get_matter
 from .models import MatterDiscoverySchema as MatterDiscoverySchema
 from _typeshed import Incomplete
+from chip.clusters.ClusterObjects import ClusterAttributeDescriptor as ClusterAttributeDescriptor
 from chip.clusters.Types import Nullable as Nullable
 from dataclasses import dataclass
 from homeassistant.components.sensor import SensorDeviceClass as SensorDeviceClass, SensorEntity as SensorEntity, SensorEntityDescription as SensorEntityDescription, SensorStateClass as SensorStateClass
@@ -20,17 +21,40 @@ async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, asyn
 @dataclass(frozen=True)
 class MatterSensorEntityDescription(SensorEntityDescription, MatterEntityDescription): ...
 
+@dataclass(frozen=True, kw_only=True)
+class MatterListSensorEntityDescription(MatterSensorEntityDescription):
+    list_attribute: type[ClusterAttributeDescriptor]
+
+@dataclass(frozen=True, kw_only=True)
+class MatterOperationalStateSensorEntityDescription(MatterSensorEntityDescription):
+    state_list_attribute: type[ClusterAttributeDescriptor] = ...
+
 class MatterSensor(MatterEntity, SensorEntity):
     entity_description: MatterSensorEntityDescription
     _attr_native_value: Incomplete
     @callback
     def _update_from_device(self) -> None: ...
 
+class MatterDraftElectricalMeasurementSensor(MatterEntity, SensorEntity):
+    entity_description: MatterSensorEntityDescription
+    _attr_native_value: Incomplete
+    @callback
+    def _update_from_device(self) -> None: ...
+
 class MatterOperationalStateSensor(MatterSensor):
+    entity_description: MatterOperationalStateSensorEntityDescription
     states_map: dict[int, str]
     _attr_options: Incomplete
     _attr_native_value: Incomplete
     @callback
     def _update_from_device(self) -> None: ...
 
+class MatterListSensor(MatterSensor):
+    entity_description: MatterListSensorEntityDescription
+    _attr_device_class: Incomplete
+    _attr_options: Incomplete
+    _attr_native_value: Incomplete
+    @callback
+    def _update_from_device(self) -> None: ...
+
 DISCOVERY_SCHEMAS: Incomplete

homeassistant-stubs/components/matter/switch.pyi

@@ -1,10 +1,11 @@
-from .entity import MatterEntity as MatterEntity
+from .entity import MatterEntity as MatterEntity, MatterEntityDescription as MatterEntityDescription
 from .helpers import get_matter as get_matter
 from .models import MatterDiscoverySchema as MatterDiscoverySchema
 from _typeshed import Incomplete
+from dataclasses import dataclass
 from homeassistant.components.switch import SwitchDeviceClass as SwitchDeviceClass, SwitchEntity as SwitchEntity, SwitchEntityDescription as SwitchEntityDescription
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
-from homeassistant.const import Platform as Platform
+from homeassistant.const import EntityCategory as EntityCategory, Platform as Platform
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 from typing import Any
@@ -19,4 +20,16 @@ class MatterSwitch(MatterEntity, SwitchEntity):
     @callback
     def _update_from_device(self) -> None: ...
 
+@dataclass(frozen=True)
+class MatterNumericSwitchEntityDescription(SwitchEntityDescription, MatterEntityDescription): ...
+
+class MatterNumericSwitch(MatterSwitch):
+    entity_description: MatterNumericSwitchEntityDescription
+    async def _async_set_native_value(self, value: bool) -> None: ...
+    async def async_turn_on(self, **kwargs: Any) -> None: ...
+    async def async_turn_off(self, **kwargs: Any) -> None: ...
+    _attr_is_on: Incomplete
+    @callback
+    def _update_from_device(self) -> None: ...
+
 DISCOVERY_SCHEMAS: Incomplete

homeassistant-stubs/components/matter/vacuum.pyi

@@ -37,7 +37,6 @@ class MatterVacuum(MatterEntity, StateVacuumEntity):
     async def async_locate(self, **kwargs: Any) -> None: ...
     async def async_start(self) -> None: ...
     async def async_pause(self) -> None: ...
-    async def _send_device_command(self, command: clusters.ClusterCommand) -> None: ...
     _attr_battery_level: Incomplete
     _attr_activity: Incomplete
     @callback

homeassistant-stubs/components/matter/valve.pyi

@@ -2,7 +2,6 @@ from .entity import MatterEntity as MatterEntity
 from .helpers import get_matter as get_matter
 from .models import MatterDiscoverySchema as MatterDiscoverySchema
 from _typeshed import Incomplete
-from chip.clusters import Objects as clusters
 from homeassistant.components.valve import ValveDeviceClass as ValveDeviceClass, ValveEntity as ValveEntity, ValveEntityDescription as ValveEntityDescription, ValveEntityFeature as ValveEntityFeature
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import Platform as Platform
@@ -18,7 +17,6 @@ class MatterValve(MatterEntity, ValveEntity):
     _feature_map: int | None
     entity_description: ValveEntityDescription
     _platform_translation_key: str
-    async def send_device_command(self, command: clusters.ClusterCommand) -> None: ...
     async def async_open_valve(self) -> None: ...
     async def async_close_valve(self) -> None: ...
     async def async_set_valve_position(self, position: int) -> None: ...

homeassistant-stubs/components/mcp/__init__.pyi

@@ -0,0 +1,16 @@
+from .const import DOMAIN as DOMAIN
+from .coordinator import ModelContextProtocolCoordinator
+from .types import ModelContextProtocolConfigEntry
+from dataclasses import dataclass
+from homeassistant.core import HomeAssistant
+from homeassistant.helpers import llm
+
+__all__ = ['DOMAIN', 'async_setup_entry', 'async_unload_entry']
+
+async def async_setup_entry(hass: HomeAssistant, entry: ModelContextProtocolConfigEntry) -> bool: ...
+async def async_unload_entry(hass: HomeAssistant, entry: ModelContextProtocolConfigEntry) -> bool: ...
+
+@dataclass(kw_only=True)
+class ModelContextProtocolAPI(llm.API):
+    coordinator: ModelContextProtocolCoordinator
+    async def async_get_api_instance(self, llm_context: llm.LLMContext) -> llm.APIInstance: ...

homeassistant-stubs/components/mcp/config_flow.pyi

@@ -0,0 +1,23 @@
+from .const import DOMAIN as DOMAIN
+from .coordinator import mcp_client as mcp_client
+from _typeshed import Incomplete
+from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult
+from homeassistant.const import CONF_URL as CONF_URL
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from typing import Any
+
+_LOGGER: Incomplete
+STEP_USER_DATA_SCHEMA: Incomplete
+
+async def validate_input(hass: HomeAssistant, data: dict[str, Any]) -> dict[str, Any]: ...
+
+class ModelContextProtocolConfigFlow(ConfigFlow, domain=DOMAIN):
+    VERSION: int
+    async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+
+class InvalidUrl(HomeAssistantError): ...
+class CannotConnect(HomeAssistantError): ...
+class TimeoutConnectError(HomeAssistantError): ...
+class InvalidAuth(HomeAssistantError): ...
+class MissingCapabilities(HomeAssistantError): ...

homeassistant-stubs/components/mcp/const.pyi

@@ -0,0 +1 @@
+DOMAIN: str

homeassistant-stubs/components/mcp/coordinator.pyi

@@ -0,0 +1,40 @@
+import asyncio
+import voluptuous as vol
+from .const import DOMAIN as DOMAIN
+from _typeshed import Incomplete
+from collections.abc import AsyncGenerator
+from contextlib import asynccontextmanager
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.const import CONF_URL as CONF_URL
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.helpers import llm as llm
+from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator, UpdateFailed as UpdateFailed
+from homeassistant.util.json import JsonObjectType as JsonObjectType
+from mcp.client.session import ClientSession
+
+_LOGGER: Incomplete
+UPDATE_INTERVAL: Incomplete
+TIMEOUT: int
+
+@asynccontextmanager
+async def mcp_client(url: str) -> AsyncGenerator[ClientSession]: ...
+
+class ModelContextProtocolTool(llm.Tool):
+    name: Incomplete
+    description: Incomplete
+    parameters: Incomplete
+    session: Incomplete
+    def __init__(self, name: str, description: str | None, parameters: vol.Schema, session: ClientSession) -> None: ...
+    async def async_call(self, hass: HomeAssistant, tool_input: llm.ToolInput, llm_context: llm.LLMContext) -> JsonObjectType: ...
+
+class ModelContextProtocolCoordinator(DataUpdateCoordinator[list[llm.Tool]]):
+    config_entry: ConfigEntry
+    _session: ClientSession | None
+    _setup_error: Exception | None
+    _stop: Incomplete
+    def __init__(self, hass: HomeAssistant, config_entry: ConfigEntry) -> None: ...
+    async def _async_setup(self) -> None: ...
+    async def _connect(self, connected: asyncio.Event, stop: asyncio.Event) -> None: ...
+    async def close(self) -> None: ...
+    async def _async_update_data(self) -> list[llm.Tool]: ...

homeassistant-stubs/components/mcp/types.pyi

@@ -0,0 +1,4 @@
+from .coordinator import ModelContextProtocolCoordinator as ModelContextProtocolCoordinator
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+
+type ModelContextProtocolConfigEntry = ConfigEntry[ModelContextProtocolCoordinator]

homeassistant-stubs/components/mcp_server/__init__.pyi

@@ -0,0 +1,13 @@
+from .const import DOMAIN as DOMAIN
+from .types import MCPServerConfigEntry
+from _typeshed import Incomplete
+from homeassistant.core import HomeAssistant
+from homeassistant.helpers.typing import ConfigType
+
+__all__ = ['CONFIG_SCHEMA', 'DOMAIN', 'async_setup', 'async_setup_entry', 'async_unload_entry']
+
+CONFIG_SCHEMA: Incomplete
+
+async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool: ...
+async def async_setup_entry(hass: HomeAssistant, entry: MCPServerConfigEntry) -> bool: ...
+async def async_unload_entry(hass: HomeAssistant, entry: MCPServerConfigEntry) -> bool: ...

homeassistant-stubs/components/mcp_server/config_flow.pyi

@@ -0,0 +1,14 @@
+from .const import DOMAIN as DOMAIN, LLM_API as LLM_API, LLM_API_NAME as LLM_API_NAME
+from _typeshed import Incomplete
+from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult
+from homeassistant.const import CONF_LLM_HASS_API as CONF_LLM_HASS_API
+from homeassistant.helpers import llm as llm
+from homeassistant.helpers.selector import SelectOptionDict as SelectOptionDict, SelectSelector as SelectSelector, SelectSelectorConfig as SelectSelectorConfig
+from typing import Any
+
+_LOGGER: Incomplete
+MORE_INFO_URL: str
+
+class ModelContextServerProtocolConfigFlow(ConfigFlow, domain=DOMAIN):
+    VERSION: int
+    async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...

homeassistant-stubs/components/mcp_server/const.pyi

@@ -0,0 +1,4 @@
+DOMAIN: str
+TITLE: str
+LLM_API: str
+LLM_API_NAME: str