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

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
+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,2 @@
+DOMAIN: str
+TITLE: str

homeassistant-stubs/components/mcp_server/http.pyi

@@ -0,0 +1,31 @@
+from .const import DOMAIN as DOMAIN
+from .server import create_server as create_server
+from .session import Session as Session
+from .types import MCPServerConfigEntry as MCPServerConfigEntry
+from _typeshed import Incomplete
+from aiohttp import web
+from anyio.streams.memory import MemoryObjectReceiveStream as MemoryObjectReceiveStream, MemoryObjectSendStream as MemoryObjectSendStream
+from homeassistant.components import conversation as conversation
+from homeassistant.components.http import HomeAssistantView as HomeAssistantView, KEY_HASS as KEY_HASS
+from homeassistant.config_entries import ConfigEntryState as ConfigEntryState
+from homeassistant.const import CONF_LLM_HASS_API as CONF_LLM_HASS_API
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.helpers import llm as llm
+
+_LOGGER: Incomplete
+SSE_API: Incomplete
+MESSAGES_API: Incomplete
+
+@callback
+def async_register(hass: HomeAssistant) -> None: ...
+def async_get_config_entry(hass: HomeAssistant) -> MCPServerConfigEntry: ...
+
+class ModelContextProtocolSSEView(HomeAssistantView):
+    name: Incomplete
+    url = SSE_API
+    async def get(self, request: web.Request) -> web.StreamResponse: ...
+
+class ModelContextProtocolMessagesView(HomeAssistantView):
+    name: Incomplete
+    url = MESSAGES_API
+    async def post(self, request: web.Request, session_id: str) -> web.StreamResponse: ...

homeassistant-stubs/components/mcp_server/server.pyi

@@ -0,0 +1,13 @@
+from _typeshed import Incomplete
+from collections.abc import Callable as Callable
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.helpers import llm as llm
+from mcp import types
+from mcp.server import Server
+from typing import Any
+
+_LOGGER: Incomplete
+
+def _format_tool(tool: llm.Tool, custom_serializer: Callable[[Any], Any] | None) -> types.Tool: ...
+async def create_server(hass: HomeAssistant, llm_api_id: str, llm_context: llm.LLMContext) -> Server: ...

homeassistant-stubs/components/mcp_server/session.pyi

@@ -0,0 +1,20 @@
+from _typeshed import Incomplete
+from anyio.streams.memory import MemoryObjectSendStream as MemoryObjectSendStream
+from collections.abc import AsyncGenerator
+from contextlib import asynccontextmanager
+from dataclasses import dataclass
+from mcp import types as types
+
+_LOGGER: Incomplete
+
+@dataclass
+class Session:
+    read_stream_writer: MemoryObjectSendStream[types.JSONRPCMessage | Exception]
+
+class SessionManager:
+    _sessions: dict[str, Session]
+    def __init__(self) -> None: ...
+    @asynccontextmanager
+    async def create(self, session: Session) -> AsyncGenerator[str]: ...
+    def get(self, session_id: str) -> Session | None: ...
+    def close(self) -> None: ...

homeassistant-stubs/components/mcp_server/types.pyi

@@ -0,0 +1,4 @@
+from .session import SessionManager as SessionManager
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+
+type MCPServerConfigEntry = ConfigEntry[SessionManager]

homeassistant-stubs/components/media_player/__init__.pyi

@@ -25,7 +25,7 @@ from homeassistant.helpers.network import get_url as get_url
 from homeassistant.helpers.typing import ConfigType as ConfigType
 from homeassistant.loader import bind_hass as bind_hass
 from homeassistant.util.hass_dict import HassKey as HassKey
-from propcache import cached_property
+from propcache.api import cached_property
 from typing import Any, Final, Required, TypedDict, final
 
 _LOGGER: Incomplete

homeassistant-stubs/components/media_source/__init__.pyi

@@ -9,7 +9,7 @@ from homeassistant.helpers.typing import UndefinedType
 from homeassistant.loader import bind_hass
 from typing import Protocol
 
-__all__ = ['DOMAIN', 'is_media_source_id', 'generate_media_source_id', 'async_browse_media', 'async_resolve_media', 'BrowseMediaSource', 'PlayMedia', 'MediaSourceItem', 'Unresolvable', 'MediaSource', 'MediaSourceError', 'MEDIA_CLASS_MAP', 'MEDIA_MIME_TYPES']
+__all__ = ['DOMAIN', 'MEDIA_CLASS_MAP', 'MEDIA_MIME_TYPES', 'BrowseMediaSource', 'MediaSource', 'MediaSourceError', 'MediaSourceItem', 'PlayMedia', 'Unresolvable', 'async_browse_media', 'async_resolve_media', 'generate_media_source_id', 'is_media_source_id']
 
 class MediaSourceProtocol(Protocol):
     async def async_get_media_source(self, hass: HomeAssistant) -> MediaSource: ...

homeassistant-stubs/components/media_source/models.pyi

@@ -1,6 +1,5 @@
 from .const import DOMAIN as DOMAIN, URI_SCHEME as URI_SCHEME, URI_SCHEME_REGEX as URI_SCHEME_REGEX
 from _typeshed import Incomplete
-from abc import ABC
 from dataclasses import dataclass
 from homeassistant.components.media_player import BrowseMedia as BrowseMedia, MediaClass as MediaClass, MediaType as MediaType
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
@@ -29,7 +28,7 @@ class MediaSourceItem:
     @classmethod
     def from_uri(cls, hass: HomeAssistant, uri: str, target_media_player: str | None) -> MediaSourceItem: ...
 
-class MediaSource(ABC):
+class MediaSource:
     name: str | None
     domain: Incomplete
     def __init__(self, domain: str) -> None: ...

homeassistant-stubs/components/minecraft_server/__init__.pyi

@@ -1,4 +1,3 @@
-import homeassistant.helpers.entity_registry as er
 from .api import MinecraftServer as MinecraftServer, MinecraftServerAddressError as MinecraftServerAddressError, MinecraftServerType as MinecraftServerType
 from .const import DOMAIN as DOMAIN, KEY_LATENCY as KEY_LATENCY, KEY_MOTD as KEY_MOTD
 from .coordinator import MinecraftServerCoordinator as MinecraftServerCoordinator
@@ -7,6 +6,7 @@ from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import CONF_ADDRESS as CONF_ADDRESS, CONF_HOST as CONF_HOST, CONF_NAME as CONF_NAME, CONF_PORT as CONF_PORT, CONF_TYPE as CONF_TYPE, Platform as Platform
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import ConfigEntryNotReady as ConfigEntryNotReady
+from homeassistant.helpers import entity_registry as er
 from typing import Any
 
 PLATFORMS: Incomplete

homeassistant-stubs/components/modbus/__init__.pyi

@@ -1,5 +1,5 @@
-from .const import CALL_TYPE_COIL as CALL_TYPE_COIL, CALL_TYPE_DISCRETE as CALL_TYPE_DISCRETE, CALL_TYPE_REGISTER_HOLDING as CALL_TYPE_REGISTER_HOLDING, CALL_TYPE_REGISTER_INPUT as CALL_TYPE_REGISTER_INPUT, CALL_TYPE_X_COILS as CALL_TYPE_X_COILS, CALL_TYPE_X_REGISTER_HOLDINGS as CALL_TYPE_X_REGISTER_HOLDINGS, CONF_BAUDRATE as CONF_BAUDRATE, CONF_BYTESIZE as CONF_BYTESIZE, CONF_CLIMATES as CONF_CLIMATES, CONF_DATA_TYPE as CONF_DATA_TYPE, CONF_DEVICE_ADDRESS as CONF_DEVICE_ADDRESS, CONF_FANS as CONF_FANS, CONF_FAN_MODE_AUTO as CONF_FAN_MODE_AUTO, CONF_FAN_MODE_DIFFUSE as CONF_FAN_MODE_DIFFUSE, CONF_FAN_MODE_FOCUS as CONF_FAN_MODE_FOCUS, CONF_FAN_MODE_HIGH as CONF_FAN_MODE_HIGH, CONF_FAN_MODE_LOW as CONF_FAN_MODE_LOW, CONF_FAN_MODE_MEDIUM as CONF_FAN_MODE_MEDIUM, CONF_FAN_MODE_MIDDLE as CONF_FAN_MODE_MIDDLE, CONF_FAN_MODE_OFF as CONF_FAN_MODE_OFF, CONF_FAN_MODE_ON as CONF_FAN_MODE_ON, CONF_FAN_MODE_REGISTER as CONF_FAN_MODE_REGISTER, CONF_FAN_MODE_TOP as CONF_FAN_MODE_TOP, CONF_FAN_MODE_VALUES as CONF_FAN_MODE_VALUES, CONF_HVAC_MODE_AUTO as CONF_HVAC_MODE_AUTO, CONF_HVAC_MODE_COOL as CONF_HVAC_MODE_COOL, CONF_HVAC_MODE_DRY as CONF_HVAC_MODE_DRY, CONF_HVAC_MODE_FAN_ONLY as CONF_HVAC_MODE_FAN_ONLY, CONF_HVAC_MODE_HEAT as CONF_HVAC_MODE_HEAT, CONF_HVAC_MODE_HEAT_COOL as CONF_HVAC_MODE_HEAT_COOL, CONF_HVAC_MODE_OFF as CONF_HVAC_MODE_OFF, CONF_HVAC_MODE_REGISTER as CONF_HVAC_MODE_REGISTER, CONF_HVAC_MODE_VALUES as CONF_HVAC_MODE_VALUES, CONF_HVAC_ONOFF_REGISTER as CONF_HVAC_ONOFF_REGISTER, CONF_INPUT_TYPE as CONF_INPUT_TYPE, CONF_MAX_TEMP as CONF_MAX_TEMP, CONF_MAX_VALUE as CONF_MAX_VALUE, CONF_MIN_TEMP as CONF_MIN_TEMP, CONF_MIN_VALUE as CONF_MIN_VALUE, CONF_MSG_WAIT as CONF_MSG_WAIT, CONF_NAN_VALUE as CONF_NAN_VALUE, CONF_PARITY as CONF_PARITY, CONF_PRECISION as CONF_PRECISION, CONF_SCALE as CONF_SCALE, CONF_SLAVE_COUNT as CONF_SLAVE_COUNT, CONF_STATE_CLOSED as CONF_STATE_CLOSED, CONF_STATE_CLOSING as CONF_STATE_CLOSING, CONF_STATE_OFF as CONF_STATE_OFF, CONF_STATE_ON as CONF_STATE_ON, CONF_STATE_OPEN as CONF_STATE_OPEN, CONF_STATE_OPENING as CONF_STATE_OPENING, CONF_STATUS_REGISTER as CONF_STATUS_REGISTER, CONF_STATUS_REGISTER_TYPE as CONF_STATUS_REGISTER_TYPE, CONF_STEP as CONF_STEP, CONF_STOPBITS as CONF_STOPBITS, CONF_SWAP as CONF_SWAP, CONF_SWAP_BYTE as CONF_SWAP_BYTE, CONF_SWAP_WORD as CONF_SWAP_WORD, CONF_SWAP_WORD_BYTE as CONF_SWAP_WORD_BYTE, CONF_SWING_MODE_REGISTER as CONF_SWING_MODE_REGISTER, CONF_SWING_MODE_SWING_BOTH as CONF_SWING_MODE_SWING_BOTH, CONF_SWING_MODE_SWING_HORIZ as CONF_SWING_MODE_SWING_HORIZ, CONF_SWING_MODE_SWING_OFF as CONF_SWING_MODE_SWING_OFF, CONF_SWING_MODE_SWING_ON as CONF_SWING_MODE_SWING_ON, CONF_SWING_MODE_SWING_VERT as CONF_SWING_MODE_SWING_VERT, CONF_SWING_MODE_VALUES as CONF_SWING_MODE_VALUES, CONF_TARGET_TEMP as CONF_TARGET_TEMP, CONF_TARGET_TEMP_WRITE_REGISTERS as CONF_TARGET_TEMP_WRITE_REGISTERS, CONF_VERIFY as CONF_VERIFY, CONF_VIRTUAL_COUNT as CONF_VIRTUAL_COUNT, CONF_WRITE_REGISTERS as CONF_WRITE_REGISTERS, CONF_WRITE_TYPE as CONF_WRITE_TYPE, CONF_ZERO_SUPPRESS as CONF_ZERO_SUPPRESS, DEFAULT_HUB as DEFAULT_HUB, DEFAULT_SCAN_INTERVAL as DEFAULT_SCAN_INTERVAL, DEFAULT_TEMP_UNIT as DEFAULT_TEMP_UNIT, DataType as DataType, RTUOVERTCP as RTUOVERTCP, SERIAL as SERIAL, TCP as TCP, UDP as UDP
-from .modbus import ModbusHub as ModbusHub, async_modbus_setup as async_modbus_setup
+from .const import CALL_TYPE_COIL as CALL_TYPE_COIL, CALL_TYPE_DISCRETE as CALL_TYPE_DISCRETE, CALL_TYPE_REGISTER_HOLDING as CALL_TYPE_REGISTER_HOLDING, CALL_TYPE_REGISTER_INPUT as CALL_TYPE_REGISTER_INPUT, CALL_TYPE_X_COILS as CALL_TYPE_X_COILS, CALL_TYPE_X_REGISTER_HOLDINGS as CALL_TYPE_X_REGISTER_HOLDINGS, CONF_BAUDRATE as CONF_BAUDRATE, CONF_BYTESIZE as CONF_BYTESIZE, CONF_CLIMATES as CONF_CLIMATES, CONF_DATA_TYPE as CONF_DATA_TYPE, CONF_DEVICE_ADDRESS as CONF_DEVICE_ADDRESS, CONF_FANS as CONF_FANS, CONF_FAN_MODE_AUTO as CONF_FAN_MODE_AUTO, CONF_FAN_MODE_DIFFUSE as CONF_FAN_MODE_DIFFUSE, CONF_FAN_MODE_FOCUS as CONF_FAN_MODE_FOCUS, CONF_FAN_MODE_HIGH as CONF_FAN_MODE_HIGH, CONF_FAN_MODE_LOW as CONF_FAN_MODE_LOW, CONF_FAN_MODE_MEDIUM as CONF_FAN_MODE_MEDIUM, CONF_FAN_MODE_MIDDLE as CONF_FAN_MODE_MIDDLE, CONF_FAN_MODE_OFF as CONF_FAN_MODE_OFF, CONF_FAN_MODE_ON as CONF_FAN_MODE_ON, CONF_FAN_MODE_REGISTER as CONF_FAN_MODE_REGISTER, CONF_FAN_MODE_TOP as CONF_FAN_MODE_TOP, CONF_FAN_MODE_VALUES as CONF_FAN_MODE_VALUES, CONF_HVAC_MODE_AUTO as CONF_HVAC_MODE_AUTO, CONF_HVAC_MODE_COOL as CONF_HVAC_MODE_COOL, CONF_HVAC_MODE_DRY as CONF_HVAC_MODE_DRY, CONF_HVAC_MODE_FAN_ONLY as CONF_HVAC_MODE_FAN_ONLY, CONF_HVAC_MODE_HEAT as CONF_HVAC_MODE_HEAT, CONF_HVAC_MODE_HEAT_COOL as CONF_HVAC_MODE_HEAT_COOL, CONF_HVAC_MODE_OFF as CONF_HVAC_MODE_OFF, CONF_HVAC_MODE_REGISTER as CONF_HVAC_MODE_REGISTER, CONF_HVAC_MODE_VALUES as CONF_HVAC_MODE_VALUES, CONF_HVAC_OFF_VALUE as CONF_HVAC_OFF_VALUE, CONF_HVAC_ONOFF_REGISTER as CONF_HVAC_ONOFF_REGISTER, CONF_HVAC_ON_VALUE as CONF_HVAC_ON_VALUE, CONF_INPUT_TYPE as CONF_INPUT_TYPE, CONF_MAX_TEMP as CONF_MAX_TEMP, CONF_MAX_VALUE as CONF_MAX_VALUE, CONF_MIN_TEMP as CONF_MIN_TEMP, CONF_MIN_VALUE as CONF_MIN_VALUE, CONF_MSG_WAIT as CONF_MSG_WAIT, CONF_NAN_VALUE as CONF_NAN_VALUE, CONF_PARITY as CONF_PARITY, CONF_PRECISION as CONF_PRECISION, CONF_SCALE as CONF_SCALE, CONF_SLAVE_COUNT as CONF_SLAVE_COUNT, CONF_STATE_CLOSED as CONF_STATE_CLOSED, CONF_STATE_CLOSING as CONF_STATE_CLOSING, CONF_STATE_OFF as CONF_STATE_OFF, CONF_STATE_ON as CONF_STATE_ON, CONF_STATE_OPEN as CONF_STATE_OPEN, CONF_STATE_OPENING as CONF_STATE_OPENING, CONF_STATUS_REGISTER as CONF_STATUS_REGISTER, CONF_STATUS_REGISTER_TYPE as CONF_STATUS_REGISTER_TYPE, CONF_STEP as CONF_STEP, CONF_STOPBITS as CONF_STOPBITS, CONF_SWAP as CONF_SWAP, CONF_SWAP_BYTE as CONF_SWAP_BYTE, CONF_SWAP_WORD as CONF_SWAP_WORD, CONF_SWAP_WORD_BYTE as CONF_SWAP_WORD_BYTE, CONF_SWING_MODE_REGISTER as CONF_SWING_MODE_REGISTER, CONF_SWING_MODE_SWING_BOTH as CONF_SWING_MODE_SWING_BOTH, CONF_SWING_MODE_SWING_HORIZ as CONF_SWING_MODE_SWING_HORIZ, CONF_SWING_MODE_SWING_OFF as CONF_SWING_MODE_SWING_OFF, CONF_SWING_MODE_SWING_ON as CONF_SWING_MODE_SWING_ON, CONF_SWING_MODE_SWING_VERT as CONF_SWING_MODE_SWING_VERT, CONF_SWING_MODE_VALUES as CONF_SWING_MODE_VALUES, CONF_TARGET_TEMP as CONF_TARGET_TEMP, CONF_TARGET_TEMP_WRITE_REGISTERS as CONF_TARGET_TEMP_WRITE_REGISTERS, CONF_VERIFY as CONF_VERIFY, CONF_VIRTUAL_COUNT as CONF_VIRTUAL_COUNT, CONF_WRITE_REGISTERS as CONF_WRITE_REGISTERS, CONF_WRITE_TYPE as CONF_WRITE_TYPE, CONF_ZERO_SUPPRESS as CONF_ZERO_SUPPRESS, DEFAULT_HUB as DEFAULT_HUB, DEFAULT_HVAC_OFF_VALUE as DEFAULT_HVAC_OFF_VALUE, DEFAULT_HVAC_ON_VALUE as DEFAULT_HVAC_ON_VALUE, DEFAULT_SCAN_INTERVAL as DEFAULT_SCAN_INTERVAL, DEFAULT_TEMP_UNIT as DEFAULT_TEMP_UNIT, DataType as DataType, RTUOVERTCP as RTUOVERTCP, SERIAL as SERIAL, TCP as TCP, UDP as UDP
+from .modbus import DATA_MODBUS_HUBS as DATA_MODBUS_HUBS, ModbusHub as ModbusHub, async_modbus_setup as async_modbus_setup
 from .validators import duplicate_fan_mode_validator as duplicate_fan_mode_validator, duplicate_swing_mode_validator as duplicate_swing_mode_validator, hvac_fixedsize_reglist_validator as hvac_fixedsize_reglist_validator, nan_validator as nan_validator, register_int_list_validator as register_int_list_validator, struct_validator as struct_validator
 from _typeshed import Incomplete
 from homeassistant.components.sensor import CONF_STATE_CLASS as CONF_STATE_CLASS

homeassistant-stubs/components/modbus/binary_sensor.pyi

@@ -3,7 +3,6 @@ from .const import CALL_TYPE_COIL as CALL_TYPE_COIL, CALL_TYPE_DISCRETE as CALL_
 from .entity import BasePlatform as BasePlatform
 from .modbus import ModbusHub as ModbusHub
 from _typeshed import Incomplete
-from datetime import datetime
 from homeassistant.components.binary_sensor import BinarySensorEntity as BinarySensorEntity
 from homeassistant.const import CONF_BINARY_SENSORS as CONF_BINARY_SENSORS, CONF_DEVICE_CLASS as CONF_DEVICE_CLASS, CONF_NAME as CONF_NAME, CONF_UNIQUE_ID as CONF_UNIQUE_ID, STATE_ON as STATE_ON
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
@@ -26,9 +25,8 @@ class ModbusBinarySensor(BasePlatform, RestoreEntity, BinarySensorEntity):
     async def async_setup_slaves(self, hass: HomeAssistant, slave_count: int, entry: dict[str, Any]) -> list[SlaveSensor]: ...
     _attr_is_on: Incomplete
     async def async_added_to_hass(self) -> None: ...
-    _call_active: bool
     _attr_available: bool
-    async def async_update(self, now: datetime | None = None) -> None: ...
+    async def _async_update(self) -> None: ...
 
 class SlaveSensor(CoordinatorEntity[DataUpdateCoordinator[list[int] | None]], RestoreEntity, BinarySensorEntity):
     _attr_name: Incomplete