homeassistant-stubs 2025.4.0b9__py3-none-any.whl → 2026.1.0b0__py3-none-any.whl

homeassistant-stubs/components/matter/vacuum.pyi

@@ -1,21 +1,23 @@
-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 chip.clusters import Objects as clusters
+from dataclasses import dataclass
 from enum import IntEnum
 from homeassistant.components.vacuum import StateVacuumEntity as StateVacuumEntity, StateVacuumEntityDescription as StateVacuumEntityDescription, VacuumActivity as VacuumActivity, VacuumEntityFeature as VacuumEntityFeature
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import Platform as Platform
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
 from typing import Any
 
 class OperationalState(IntEnum):
-    NO_ERROR = 0
-    UNABLE_TO_START_OR_RESUME = 1
-    UNABLE_TO_COMPLETE_OPERATION = 2
-    COMMAND_INVALID_IN_STATE = 3
+    STOPPED = 0
+    RUNNING = 1
+    PAUSED = 2
+    ERROR = 3
     SEEKING_CHARGER = 64
     CHARGING = 65
     DOCKED = 66
@@ -27,17 +29,20 @@ class ModeTag(IntEnum):
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
+@dataclass(frozen=True, kw_only=True)
+class MatterStateVacuumEntityDescription(StateVacuumEntityDescription, MatterEntityDescription): ...
+
 class MatterVacuum(MatterEntity, StateVacuumEntity):
     _last_accepted_commands: list[int] | None
-    _supported_run_modes: dict[int, clusters.RvcCleanMode.Structs.ModeOptionStruct] | None
-    entity_description: StateVacuumEntityDescription
+    _supported_run_modes: dict[int, clusters.RvcRunMode.Structs.ModeOptionStruct] | None
+    entity_description: MatterStateVacuumEntityDescription
     _platform_translation_key: str
+    def _get_run_mode_by_tag(self, tag: ModeTag) -> clusters.RvcRunMode.Structs.ModeOptionStruct | None: ...
     async def async_stop(self, **kwargs: Any) -> None: ...
     async def async_return_to_base(self, **kwargs: Any) -> None: ...
     async def async_locate(self, **kwargs: Any) -> None: ...
     async def async_start(self) -> None: ...
     async def async_pause(self) -> None: ...
-    _attr_battery_level: Incomplete
     _attr_activity: Incomplete
     @callback
     def _update_from_device(self) -> None: ...

homeassistant-stubs/components/matter/valve.pyi

@@ -1,7 +1,8 @@
-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.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
@@ -13,9 +14,12 @@ ValveStateEnum: Incomplete
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
+@dataclass(frozen=True, kw_only=True)
+class MatterValveEntityDescription(ValveEntityDescription, MatterEntityDescription): ...
+
 class MatterValve(MatterEntity, ValveEntity):
     _feature_map: int | None
-    entity_description: ValveEntityDescription
+    entity_description: MatterValveEntityDescription
     _platform_translation_key: str
     async def async_open_valve(self) -> None: ...
     async def async_close_valve(self) -> None: ...

homeassistant-stubs/components/matter/water_heater.pyi

@@ -0,0 +1,46 @@
+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 chip.clusters import Objects as clusters
+from dataclasses import dataclass
+from homeassistant.components.water_heater import STATE_ECO as STATE_ECO, STATE_HIGH_DEMAND as STATE_HIGH_DEMAND, STATE_OFF as STATE_OFF, WaterHeaterEntity as WaterHeaterEntity, WaterHeaterEntityDescription as WaterHeaterEntityDescription, WaterHeaterEntityFeature as WaterHeaterEntityFeature
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.const import ATTR_TEMPERATURE as ATTR_TEMPERATURE, PRECISION_WHOLE as PRECISION_WHOLE, Platform as Platform, UnitOfTemperature as UnitOfTemperature
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+from typing import Any
+
+TEMPERATURE_SCALING_FACTOR: int
+WATER_HEATER_SYSTEM_MODE_MAP: Incomplete
+DEFAULT_BOOST_DURATION: int
+
+async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+@dataclass(frozen=True, kw_only=True)
+class MatterWaterHeaterEntityDescription(WaterHeaterEntityDescription, MatterEntityDescription): ...
+
+class MatterWaterHeater(MatterEntity, WaterHeaterEntity):
+    _attr_current_temperature: float | None
+    _attr_current_operation: str
+    _attr_operation_list: Incomplete
+    _attr_precision = PRECISION_WHOLE
+    _attr_supported_features: Incomplete
+    _attr_target_temperature: float | None
+    _attr_temperature_unit: Incomplete
+    _platform_translation_key: str
+    async def async_set_boost(self, duration: int, emergency_boost: bool = False, temporary_setpoint: int | None = None) -> None: ...
+    async def async_set_temperature(self, **kwargs: Any) -> None: ...
+    async def async_set_operation_mode(self, operation_mode: str) -> None: ...
+    async def async_turn_on(self, **kwargs: Any) -> None: ...
+    async def async_turn_off(self, **kwargs: Any) -> None: ...
+    _attr_temperature: Incomplete
+    _attr_min_temp: Incomplete
+    _attr_max_temp: Incomplete
+    @callback
+    def _update_from_device(self) -> None: ...
+    @callback
+    def _get_temperature_in_degrees(self, attribute: type[clusters.ClusterAttributeDescriptor]) -> float | None: ...
+
+DISCOVERY_SCHEMAS: Incomplete

homeassistant-stubs/components/mcp/__init__.pyi

@@ -1,14 +1,9 @@
 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: ...
+__all__ = ['DOMAIN']
 
 @dataclass(kw_only=True)
 class ModelContextProtocolAPI(llm.API):

homeassistant-stubs/components/mcp/application_credentials.pyi

@@ -0,0 +1,12 @@
+import contextvars
+from collections.abc import Generator
+from contextlib import contextmanager
+from homeassistant.components.application_credentials import AuthorizationServer as AuthorizationServer
+from homeassistant.core import HomeAssistant as HomeAssistant
+
+CONF_ACTIVE_AUTHORIZATION_SERVER: str
+_mcp_context: contextvars.ContextVar[AuthorizationServer]
+
+@contextmanager
+def authorization_server_context(authorization_server: AuthorizationServer) -> Generator[None]: ...
+async def async_get_authorization_server(hass: HomeAssistant) -> AuthorizationServer: ...

homeassistant-stubs/components/mcp/config_flow.pyi

@@ -1,20 +1,51 @@
-from .const import DOMAIN as DOMAIN
-from .coordinator import mcp_client as mcp_client
+from . import async_get_config_entry_implementation as async_get_config_entry_implementation
+from .application_credentials import authorization_server_context as authorization_server_context
+from .const import CONF_ACCESS_TOKEN as CONF_ACCESS_TOKEN, CONF_AUTHORIZATION_URL as CONF_AUTHORIZATION_URL, CONF_SCOPE as CONF_SCOPE, CONF_TOKEN_URL as CONF_TOKEN_URL, DOMAIN as DOMAIN
+from .coordinator import TokenManager as TokenManager, 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 collections.abc import Mapping
+from dataclasses import dataclass
+from homeassistant.components.application_credentials import AuthorizationServer as AuthorizationServer
+from homeassistant.config_entries import ConfigFlowResult as ConfigFlowResult, SOURCE_REAUTH as SOURCE_REAUTH
+from homeassistant.const import CONF_TOKEN as CONF_TOKEN, CONF_URL as CONF_URL
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.helpers.config_entry_oauth2_flow import AbstractOAuth2FlowHandler as AbstractOAuth2FlowHandler, async_get_implementations as async_get_implementations
 from typing import Any
 
 _LOGGER: Incomplete
 STEP_USER_DATA_SCHEMA: Incomplete
+OAUTH_DISCOVERY_ENDPOINT: str
+MCP_DISCOVERY_HEADERS: Incomplete
+EXAMPLE_URL: str
 
-async def validate_input(hass: HomeAssistant, data: dict[str, Any]) -> dict[str, Any]: ...
+@dataclass
+class OAuthConfig:
+    authorization_server: AuthorizationServer
+    scopes: list[str] | None = ...
 
-class ModelContextProtocolConfigFlow(ConfigFlow, domain=DOMAIN):
+async def async_discover_oauth_config(hass: HomeAssistant, mcp_server_url: str) -> OAuthConfig: ...
+async def validate_input(hass: HomeAssistant, data: dict[str, Any], token_manager: TokenManager | None = None) -> dict[str, Any]: ...
+
+class ModelContextProtocolConfigFlow(AbstractOAuth2FlowHandler, domain=DOMAIN):
     VERSION: int
+    DOMAIN = DOMAIN
+    logger = _LOGGER
+    data: dict[str, Any]
+    oauth_config: OAuthConfig | None
+    def __init__(self) -> None: ...
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def async_step_auth_discovery(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    def authorization_server(self) -> AuthorizationServer: ...
+    @property
+    def extra_authorize_data(self) -> dict: ...
+    async def async_step_credentials_choice(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def async_step_new_credentials(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def async_step_pick_implementation(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def async_oauth_create_entry(self, data: dict) -> ConfigFlowResult: ...
+    async def async_step_reauth(self, entry_data: Mapping[str, Any]) -> ConfigFlowResult: ...
+    flow_impl: Incomplete
+    async def async_step_reauth_confirm(self, user_input: Mapping[str, Any] | None = None) -> ConfigFlowResult: ...
 
 class InvalidUrl(HomeAssistantError): ...
 class CannotConnect(HomeAssistantError): ...

homeassistant-stubs/components/mcp/const.pyi

@@ -1 +1,5 @@
 DOMAIN: str
+CONF_ACCESS_TOKEN: str
+CONF_AUTHORIZATION_URL: str
+CONF_TOKEN_URL: str
+CONF_SCOPE: str

homeassistant-stubs/components/mcp/coordinator.pyi

@@ -1,12 +1,12 @@
 import voluptuous as vol
 from .const import DOMAIN as DOMAIN
 from _typeshed import Incomplete
-from collections.abc import AsyncGenerator
+from collections.abc import AsyncGenerator, Awaitable, Callable
 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.exceptions import ConfigEntryAuthFailed as ConfigEntryAuthFailed, 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
@@ -15,19 +15,22 @@ from mcp.client.session import ClientSession
 _LOGGER: Incomplete
 UPDATE_INTERVAL: Incomplete
 TIMEOUT: int
+type TokenManager = Callable[[], Awaitable[str]]
 
 @asynccontextmanager
-async def mcp_client(url: str) -> AsyncGenerator[ClientSession]: ...
+async def mcp_client(url: str, token_manager: TokenManager | None = None) -> AsyncGenerator[ClientSession]: ...
 
 class ModelContextProtocolTool(llm.Tool):
     name: Incomplete
     description: Incomplete
     parameters: Incomplete
     server_url: Incomplete
-    def __init__(self, name: str, description: str | None, parameters: vol.Schema, server_url: str) -> None: ...
+    token_manager: Incomplete
+    def __init__(self, name: str, description: str | None, parameters: vol.Schema, server_url: str, token_manager: TokenManager | None = None) -> 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
-    def __init__(self, hass: HomeAssistant, config_entry: ConfigEntry) -> None: ...
+    token_manager: Incomplete
+    def __init__(self, hass: HomeAssistant, config_entry: ConfigEntry, token_manager: TokenManager | None = None) -> None: ...
     async def _async_update_data(self) -> list[llm.Tool]: ...

homeassistant-stubs/components/mcp_server/__init__.pyi

@@ -1,13 +1,6 @@
 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']
+__all__ = ['CONFIG_SCHEMA', 'DOMAIN']
 
 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/http.pyi

@@ -5,13 +5,19 @@ 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 dataclasses import dataclass
 from homeassistant.components import conversation as conversation
 from homeassistant.components.http import HomeAssistantView as HomeAssistantView, KEY_HASS as KEY_HASS
 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.core import Context as Context, HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers import llm as llm
+from mcp.server import InitializationOptions as InitializationOptions, Server as Server
+from mcp.shared.message import SessionMessage
 
 _LOGGER: Incomplete
+STREAMABLE_API: str
+TIMEOUT: int
+CONTENT_TYPE_JSON: str
 SSE_API: Incomplete
 MESSAGES_API: Incomplete
 
@@ -19,6 +25,16 @@ MESSAGES_API: Incomplete
 def async_register(hass: HomeAssistant) -> None: ...
 def async_get_config_entry(hass: HomeAssistant) -> MCPServerConfigEntry: ...
 
+@dataclass
+class Streams:
+    read_stream: MemoryObjectReceiveStream[SessionMessage | Exception]
+    read_stream_writer: MemoryObjectSendStream[SessionMessage | Exception]
+    write_stream: MemoryObjectSendStream[SessionMessage]
+    write_stream_reader: MemoryObjectReceiveStream[SessionMessage]
+
+def create_streams() -> Streams: ...
+async def create_mcp_server(hass: HomeAssistant, context: Context, entry: MCPServerConfigEntry) -> tuple[Server, InitializationOptions]: ...
+
 class ModelContextProtocolSSEView(HomeAssistantView):
     name: Incomplete
     url = SSE_API
@@ -28,3 +44,9 @@ class ModelContextProtocolMessagesView(HomeAssistantView):
     name: Incomplete
     url = MESSAGES_API
     async def post(self, request: web.Request, session_id: str) -> web.StreamResponse: ...
+
+class ModelContextProtocolStreamableView(HomeAssistantView):
+    name: Incomplete
+    url = STREAMABLE_API
+    async def get(self, request: web.Request) -> web.StreamResponse: ...
+    async def post(self, request: web.Request) -> web.StreamResponse: ...

homeassistant-stubs/components/mcp_server/server.pyi

@@ -11,4 +11,4 @@ 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: ...
+async def create_server(hass: HomeAssistant, llm_api_id: str | list[str], llm_context: llm.LLMContext) -> Server: ...

homeassistant-stubs/components/mcp_server/session.pyi

@@ -3,13 +3,13 @@ from anyio.streams.memory import MemoryObjectSendStream as MemoryObjectSendStrea
 from collections.abc import AsyncGenerator
 from contextlib import asynccontextmanager
 from dataclasses import dataclass
-from mcp import types as types
+from mcp.shared.message import SessionMessage as SessionMessage
 
 _LOGGER: Incomplete
 
 @dataclass
 class Session:
-    read_stream_writer: MemoryObjectSendStream[types.JSONRPCMessage | Exception]
+    read_stream_writer: MemoryObjectSendStream[SessionMessage | Exception]
 
 class SessionManager:
     _sessions: dict[str, Session]

homeassistant-stubs/components/mealie/__init__.pyi

@@ -1,6 +1,6 @@
 from .const import DOMAIN as DOMAIN, LOGGER as LOGGER, MIN_REQUIRED_MEALIE_VERSION as MIN_REQUIRED_MEALIE_VERSION
 from .coordinator import MealieConfigEntry as MealieConfigEntry, MealieData as MealieData, MealieMealplanCoordinator as MealieMealplanCoordinator, MealieShoppingListCoordinator as MealieShoppingListCoordinator, MealieStatisticsCoordinator as MealieStatisticsCoordinator
-from .services import setup_services as setup_services
+from .services import async_setup_services as async_setup_services
 from .utils import create_version as create_version
 from _typeshed import Incomplete
 from homeassistant.const import CONF_API_TOKEN as CONF_API_TOKEN, CONF_HOST as CONF_HOST, CONF_VERIFY_SSL as CONF_VERIFY_SSL, Platform as Platform

homeassistant-stubs/components/mealie/config_flow.pyi

@@ -3,18 +3,26 @@ from .utils import create_version as create_version
 from _typeshed import Incomplete
 from collections.abc import Mapping
 from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult
-from homeassistant.const import CONF_API_TOKEN as CONF_API_TOKEN, CONF_HOST as CONF_HOST, CONF_VERIFY_SSL as CONF_VERIFY_SSL
+from homeassistant.const import CONF_API_TOKEN as CONF_API_TOKEN, CONF_HOST as CONF_HOST, CONF_PORT as CONF_PORT, CONF_VERIFY_SSL as CONF_VERIFY_SSL
 from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
+from homeassistant.helpers.service_info.hassio import HassioServiceInfo as HassioServiceInfo
 from typing import Any
 
 USER_SCHEMA: Incomplete
 REAUTH_SCHEMA: Incomplete
+DISCOVERY_SCHEMA: Incomplete
+EXAMPLE_URL: str
 
 class MealieConfigFlow(ConfigFlow, domain=DOMAIN):
+    VERSION: int
     host: str | None
     verify_ssl: bool
+    _hassio_discovery: dict[str, Any] | None
     async def check_connection(self, api_token: str) -> tuple[dict[str, str], str | None]: ...
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def async_step_reauth(self, entry_data: Mapping[str, Any]) -> ConfigFlowResult: ...
     async def async_step_reauth_confirm(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def async_step_reconfigure(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def async_step_hassio(self, discovery_info: HassioServiceInfo) -> ConfigFlowResult: ...
+    async def async_step_hassio_confirm(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def _show_hassio_form(self, errors: dict[str, str] | None = None) -> ConfigFlowResult: ...

homeassistant-stubs/components/mealie/const.pyi

@@ -2,7 +2,6 @@ from _typeshed import Incomplete
 
 DOMAIN: str
 LOGGER: Incomplete
-ATTR_CONFIG_ENTRY_ID: str
 ATTR_START_DATE: str
 ATTR_END_DATE: str
 ATTR_RECIPE_ID: str
@@ -11,4 +10,6 @@ ATTR_INCLUDE_TAGS: str
 ATTR_ENTRY_TYPE: str
 ATTR_NOTE_TITLE: str
 ATTR_NOTE_TEXT: str
+ATTR_SEARCH_TERMS: str
+ATTR_RESULT_LIMIT: str
 MIN_REQUIRED_MEALIE_VERSION: Incomplete

homeassistant-stubs/components/mealie/coordinator.pyi

@@ -3,6 +3,7 @@ from .const import DOMAIN as DOMAIN, LOGGER as LOGGER
 from _typeshed import Incomplete
 from abc import abstractmethod
 from aiomealie import MealieClient as MealieClient, Mealplan, MealplanEntryType, ShoppingItem as ShoppingItem, ShoppingList as ShoppingList, Statistics
+from awesomeversion import AwesomeVersion as AwesomeVersion
 from dataclasses import dataclass
 from datetime import timedelta
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
@@ -15,6 +16,7 @@ WEEK: Incomplete
 @dataclass
 class MealieData:
     client: MealieClient
+    version: AwesomeVersion
     mealplan_coordinator: MealieMealplanCoordinator
     shoppinglist_coordinator: MealieShoppingListCoordinator
     statistics_coordinator: MealieStatisticsCoordinator

homeassistant-stubs/components/mealie/services.pyi

@@ -1,15 +1,18 @@
-from .const import ATTR_CONFIG_ENTRY_ID as ATTR_CONFIG_ENTRY_ID, ATTR_END_DATE as ATTR_END_DATE, ATTR_ENTRY_TYPE as ATTR_ENTRY_TYPE, ATTR_INCLUDE_TAGS as ATTR_INCLUDE_TAGS, ATTR_NOTE_TEXT as ATTR_NOTE_TEXT, ATTR_NOTE_TITLE as ATTR_NOTE_TITLE, ATTR_RECIPE_ID as ATTR_RECIPE_ID, ATTR_START_DATE as ATTR_START_DATE, ATTR_URL as ATTR_URL, DOMAIN as DOMAIN
+from .const import ATTR_END_DATE as ATTR_END_DATE, ATTR_ENTRY_TYPE as ATTR_ENTRY_TYPE, ATTR_INCLUDE_TAGS as ATTR_INCLUDE_TAGS, ATTR_NOTE_TEXT as ATTR_NOTE_TEXT, ATTR_NOTE_TITLE as ATTR_NOTE_TITLE, ATTR_RECIPE_ID as ATTR_RECIPE_ID, ATTR_RESULT_LIMIT as ATTR_RESULT_LIMIT, ATTR_SEARCH_TERMS as ATTR_SEARCH_TERMS, ATTR_START_DATE as ATTR_START_DATE, ATTR_URL as ATTR_URL, DOMAIN as DOMAIN
 from .coordinator import MealieConfigEntry as MealieConfigEntry
 from _typeshed import Incomplete
+from awesomeversion import AwesomeVersion
 from homeassistant.config_entries import ConfigEntryState as ConfigEntryState
-from homeassistant.const import ATTR_DATE as ATTR_DATE
-from homeassistant.core import HomeAssistant as HomeAssistant, ServiceCall as ServiceCall, ServiceResponse as ServiceResponse, SupportsResponse as SupportsResponse
+from homeassistant.const import ATTR_CONFIG_ENTRY_ID as ATTR_CONFIG_ENTRY_ID, ATTR_DATE as ATTR_DATE
+from homeassistant.core import HomeAssistant as HomeAssistant, ServiceCall as ServiceCall, ServiceResponse as ServiceResponse, SupportsResponse as SupportsResponse, callback as callback
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError, ServiceValidationError as ServiceValidationError
 
 SERVICE_GET_MEALPLAN: str
 SERVICE_GET_MEALPLAN_SCHEMA: Incomplete
 SERVICE_GET_RECIPE: str
 SERVICE_GET_RECIPE_SCHEMA: Incomplete
+SERVICE_GET_RECIPES: str
+SERVICE_GET_RECIPES_SCHEMA: Incomplete
 SERVICE_IMPORT_RECIPE: str
 SERVICE_IMPORT_RECIPE_SCHEMA: Incomplete
 SERVICE_SET_RANDOM_MEALPLAN: str
@@ -17,5 +20,13 @@ SERVICE_SET_RANDOM_MEALPLAN_SCHEMA: Incomplete
 SERVICE_SET_MEALPLAN: str
 SERVICE_SET_MEALPLAN_SCHEMA: Incomplete
 
-def async_get_entry(hass: HomeAssistant, config_entry_id: str) -> MealieConfigEntry: ...
-def setup_services(hass: HomeAssistant) -> None: ...
+def _async_get_entry(call: ServiceCall) -> MealieConfigEntry: ...
+def _validate_mealplan_type(version: AwesomeVersion, entry_type: str) -> None: ...
+async def _async_get_mealplan(call: ServiceCall) -> ServiceResponse: ...
+async def _async_get_recipe(call: ServiceCall) -> ServiceResponse: ...
+async def _async_get_recipes(call: ServiceCall) -> ServiceResponse: ...
+async def _async_import_recipe(call: ServiceCall) -> ServiceResponse: ...
+async def _async_set_random_mealplan(call: ServiceCall) -> ServiceResponse: ...
+async def _async_set_mealplan(call: ServiceCall) -> ServiceResponse: ...
+@callback
+def async_setup_services(hass: HomeAssistant) -> None: ...

homeassistant-stubs/components/media_player/__init__.pyi

@@ -2,9 +2,9 @@ import asyncio
 import collections
 import datetime as dt
 import logging
-from .browse_media import BrowseMedia as BrowseMedia, async_process_play_media_url as async_process_play_media_url
-from .const import ATTR_APP_ID as ATTR_APP_ID, ATTR_APP_NAME as ATTR_APP_NAME, ATTR_ENTITY_PICTURE_LOCAL as ATTR_ENTITY_PICTURE_LOCAL, ATTR_GROUP_MEMBERS as ATTR_GROUP_MEMBERS, ATTR_INPUT_SOURCE as ATTR_INPUT_SOURCE, ATTR_INPUT_SOURCE_LIST as ATTR_INPUT_SOURCE_LIST, ATTR_MEDIA_ALBUM_ARTIST as ATTR_MEDIA_ALBUM_ARTIST, ATTR_MEDIA_ALBUM_NAME as ATTR_MEDIA_ALBUM_NAME, ATTR_MEDIA_ANNOUNCE as ATTR_MEDIA_ANNOUNCE, ATTR_MEDIA_ARTIST as ATTR_MEDIA_ARTIST, ATTR_MEDIA_CHANNEL as ATTR_MEDIA_CHANNEL, ATTR_MEDIA_CONTENT_ID as ATTR_MEDIA_CONTENT_ID, ATTR_MEDIA_CONTENT_TYPE as ATTR_MEDIA_CONTENT_TYPE, ATTR_MEDIA_DURATION as ATTR_MEDIA_DURATION, ATTR_MEDIA_ENQUEUE as ATTR_MEDIA_ENQUEUE, ATTR_MEDIA_EPISODE as ATTR_MEDIA_EPISODE, ATTR_MEDIA_EXTRA as ATTR_MEDIA_EXTRA, ATTR_MEDIA_PLAYLIST as ATTR_MEDIA_PLAYLIST, ATTR_MEDIA_POSITION as ATTR_MEDIA_POSITION, ATTR_MEDIA_POSITION_UPDATED_AT as ATTR_MEDIA_POSITION_UPDATED_AT, ATTR_MEDIA_REPEAT as ATTR_MEDIA_REPEAT, ATTR_MEDIA_SEASON as ATTR_MEDIA_SEASON, ATTR_MEDIA_SEEK_POSITION as ATTR_MEDIA_SEEK_POSITION, ATTR_MEDIA_SERIES_TITLE as ATTR_MEDIA_SERIES_TITLE, ATTR_MEDIA_SHUFFLE as ATTR_MEDIA_SHUFFLE, ATTR_MEDIA_TITLE as ATTR_MEDIA_TITLE, ATTR_MEDIA_TRACK as ATTR_MEDIA_TRACK, ATTR_MEDIA_VOLUME_LEVEL as ATTR_MEDIA_VOLUME_LEVEL, ATTR_MEDIA_VOLUME_MUTED as ATTR_MEDIA_VOLUME_MUTED, ATTR_SOUND_MODE as ATTR_SOUND_MODE, ATTR_SOUND_MODE_LIST as ATTR_SOUND_MODE_LIST, CONTENT_AUTH_EXPIRY_TIME as CONTENT_AUTH_EXPIRY_TIME, DOMAIN as DOMAIN, MediaClass as MediaClass, MediaPlayerEntityFeature as MediaPlayerEntityFeature, MediaPlayerState as MediaPlayerState, MediaType as MediaType, REPEAT_MODES as REPEAT_MODES, RepeatMode as RepeatMode, SERVICE_BROWSE_MEDIA as SERVICE_BROWSE_MEDIA, SERVICE_CLEAR_PLAYLIST as SERVICE_CLEAR_PLAYLIST, SERVICE_JOIN as SERVICE_JOIN, SERVICE_PLAY_MEDIA as SERVICE_PLAY_MEDIA, SERVICE_SELECT_SOUND_MODE as SERVICE_SELECT_SOUND_MODE, SERVICE_SELECT_SOURCE as SERVICE_SELECT_SOURCE, SERVICE_UNJOIN as SERVICE_UNJOIN, _DEPRECATED_MEDIA_CLASS_DIRECTORY as _DEPRECATED_MEDIA_CLASS_DIRECTORY, _DEPRECATED_SUPPORT_BROWSE_MEDIA as _DEPRECATED_SUPPORT_BROWSE_MEDIA, _DEPRECATED_SUPPORT_CLEAR_PLAYLIST as _DEPRECATED_SUPPORT_CLEAR_PLAYLIST, _DEPRECATED_SUPPORT_GROUPING as _DEPRECATED_SUPPORT_GROUPING, _DEPRECATED_SUPPORT_NEXT_TRACK as _DEPRECATED_SUPPORT_NEXT_TRACK, _DEPRECATED_SUPPORT_PAUSE as _DEPRECATED_SUPPORT_PAUSE, _DEPRECATED_SUPPORT_PLAY as _DEPRECATED_SUPPORT_PLAY, _DEPRECATED_SUPPORT_PLAY_MEDIA as _DEPRECATED_SUPPORT_PLAY_MEDIA, _DEPRECATED_SUPPORT_PREVIOUS_TRACK as _DEPRECATED_SUPPORT_PREVIOUS_TRACK, _DEPRECATED_SUPPORT_REPEAT_SET as _DEPRECATED_SUPPORT_REPEAT_SET, _DEPRECATED_SUPPORT_SEEK as _DEPRECATED_SUPPORT_SEEK, _DEPRECATED_SUPPORT_SELECT_SOUND_MODE as _DEPRECATED_SUPPORT_SELECT_SOUND_MODE, _DEPRECATED_SUPPORT_SELECT_SOURCE as _DEPRECATED_SUPPORT_SELECT_SOURCE, _DEPRECATED_SUPPORT_SHUFFLE_SET as _DEPRECATED_SUPPORT_SHUFFLE_SET, _DEPRECATED_SUPPORT_STOP as _DEPRECATED_SUPPORT_STOP, _DEPRECATED_SUPPORT_TURN_OFF as _DEPRECATED_SUPPORT_TURN_OFF, _DEPRECATED_SUPPORT_TURN_ON as _DEPRECATED_SUPPORT_TURN_ON, _DEPRECATED_SUPPORT_VOLUME_MUTE as _DEPRECATED_SUPPORT_VOLUME_MUTE, _DEPRECATED_SUPPORT_VOLUME_SET as _DEPRECATED_SUPPORT_VOLUME_SET, _DEPRECATED_SUPPORT_VOLUME_STEP as _DEPRECATED_SUPPORT_VOLUME_STEP
-from .errors import BrowseError as BrowseError
+from .browse_media import BrowseMedia as BrowseMedia, SearchMedia as SearchMedia, SearchMediaQuery as SearchMediaQuery, async_process_play_media_url as async_process_play_media_url
+from .const import ATTR_APP_ID as ATTR_APP_ID, ATTR_APP_NAME as ATTR_APP_NAME, ATTR_ENTITY_PICTURE_LOCAL as ATTR_ENTITY_PICTURE_LOCAL, ATTR_GROUP_MEMBERS as ATTR_GROUP_MEMBERS, ATTR_INPUT_SOURCE as ATTR_INPUT_SOURCE, ATTR_INPUT_SOURCE_LIST as ATTR_INPUT_SOURCE_LIST, ATTR_MEDIA_ALBUM_ARTIST as ATTR_MEDIA_ALBUM_ARTIST, ATTR_MEDIA_ALBUM_NAME as ATTR_MEDIA_ALBUM_NAME, ATTR_MEDIA_ANNOUNCE as ATTR_MEDIA_ANNOUNCE, ATTR_MEDIA_ARTIST as ATTR_MEDIA_ARTIST, ATTR_MEDIA_CHANNEL as ATTR_MEDIA_CHANNEL, ATTR_MEDIA_CONTENT_ID as ATTR_MEDIA_CONTENT_ID, ATTR_MEDIA_CONTENT_TYPE as ATTR_MEDIA_CONTENT_TYPE, ATTR_MEDIA_DURATION as ATTR_MEDIA_DURATION, ATTR_MEDIA_ENQUEUE as ATTR_MEDIA_ENQUEUE, ATTR_MEDIA_EPISODE as ATTR_MEDIA_EPISODE, ATTR_MEDIA_EXTRA as ATTR_MEDIA_EXTRA, ATTR_MEDIA_FILTER_CLASSES as ATTR_MEDIA_FILTER_CLASSES, ATTR_MEDIA_PLAYLIST as ATTR_MEDIA_PLAYLIST, ATTR_MEDIA_POSITION as ATTR_MEDIA_POSITION, ATTR_MEDIA_POSITION_UPDATED_AT as ATTR_MEDIA_POSITION_UPDATED_AT, ATTR_MEDIA_REPEAT as ATTR_MEDIA_REPEAT, ATTR_MEDIA_SEARCH_QUERY as ATTR_MEDIA_SEARCH_QUERY, ATTR_MEDIA_SEASON as ATTR_MEDIA_SEASON, ATTR_MEDIA_SEEK_POSITION as ATTR_MEDIA_SEEK_POSITION, ATTR_MEDIA_SERIES_TITLE as ATTR_MEDIA_SERIES_TITLE, ATTR_MEDIA_SHUFFLE as ATTR_MEDIA_SHUFFLE, ATTR_MEDIA_TITLE as ATTR_MEDIA_TITLE, ATTR_MEDIA_TRACK as ATTR_MEDIA_TRACK, ATTR_MEDIA_VOLUME_LEVEL as ATTR_MEDIA_VOLUME_LEVEL, ATTR_MEDIA_VOLUME_MUTED as ATTR_MEDIA_VOLUME_MUTED, ATTR_SOUND_MODE as ATTR_SOUND_MODE, ATTR_SOUND_MODE_LIST as ATTR_SOUND_MODE_LIST, CONTENT_AUTH_EXPIRY_TIME as CONTENT_AUTH_EXPIRY_TIME, DOMAIN as DOMAIN, INTENT_MEDIA_SEARCH_AND_PLAY as INTENT_MEDIA_SEARCH_AND_PLAY, MediaClass as MediaClass, MediaPlayerEntityFeature as MediaPlayerEntityFeature, MediaPlayerState as MediaPlayerState, MediaType as MediaType, REPEAT_MODES as REPEAT_MODES, RepeatMode as RepeatMode, SERVICE_BROWSE_MEDIA as SERVICE_BROWSE_MEDIA, SERVICE_CLEAR_PLAYLIST as SERVICE_CLEAR_PLAYLIST, SERVICE_JOIN as SERVICE_JOIN, SERVICE_PLAY_MEDIA as SERVICE_PLAY_MEDIA, SERVICE_SEARCH_MEDIA as SERVICE_SEARCH_MEDIA, SERVICE_SELECT_SOUND_MODE as SERVICE_SELECT_SOUND_MODE, SERVICE_SELECT_SOURCE as SERVICE_SELECT_SOURCE, SERVICE_UNJOIN as SERVICE_UNJOIN
+from .errors import BrowseError as BrowseError, SearchError as SearchError
 from _typeshed import Incomplete
 from aiohttp import web
 from aiohttp.typedefs import LooseHeaders as LooseHeaders
@@ -18,7 +18,6 @@ from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import ATTR_ENTITY_PICTURE as ATTR_ENTITY_PICTURE, SERVICE_MEDIA_NEXT_TRACK as SERVICE_MEDIA_NEXT_TRACK, SERVICE_MEDIA_PAUSE as SERVICE_MEDIA_PAUSE, SERVICE_MEDIA_PLAY as SERVICE_MEDIA_PLAY, SERVICE_MEDIA_PLAY_PAUSE as SERVICE_MEDIA_PLAY_PAUSE, SERVICE_MEDIA_PREVIOUS_TRACK as SERVICE_MEDIA_PREVIOUS_TRACK, SERVICE_MEDIA_SEEK as SERVICE_MEDIA_SEEK, SERVICE_MEDIA_STOP as SERVICE_MEDIA_STOP, SERVICE_REPEAT_SET as SERVICE_REPEAT_SET, SERVICE_SHUFFLE_SET as SERVICE_SHUFFLE_SET, SERVICE_TOGGLE as SERVICE_TOGGLE, SERVICE_TURN_OFF as SERVICE_TURN_OFF, SERVICE_TURN_ON as SERVICE_TURN_ON, SERVICE_VOLUME_DOWN as SERVICE_VOLUME_DOWN, SERVICE_VOLUME_MUTE as SERVICE_VOLUME_MUTE, SERVICE_VOLUME_SET as SERVICE_VOLUME_SET, SERVICE_VOLUME_UP as SERVICE_VOLUME_UP, STATE_IDLE as STATE_IDLE, STATE_OFF as STATE_OFF, STATE_PLAYING as STATE_PLAYING, STATE_STANDBY as STATE_STANDBY
 from homeassistant.core import HomeAssistant as HomeAssistant, SupportsResponse as SupportsResponse
 from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
-from homeassistant.helpers.deprecation import DeprecatedConstantEnum as DeprecatedConstantEnum, all_with_deprecated_constants as all_with_deprecated_constants, check_if_deprecated_constant as check_if_deprecated_constant, dir_with_deprecated_constants as dir_with_deprecated_constants
 from homeassistant.helpers.entity import Entity as Entity, EntityDescription as EntityDescription
 from homeassistant.helpers.entity_component import EntityComponent as EntityComponent
 from homeassistant.helpers.network import get_url as get_url
@@ -39,6 +38,7 @@ CACHE_MAXSIZE: Final[str]
 CACHE_LOCK: Final[str]
 CACHE_URL: Final[str]
 CACHE_CONTENT: Final[str]
+ATTR_MEDIA: str
 
 class MediaPlayerEnqueue(StrEnum):
     ADD = 'add'
@@ -52,10 +52,10 @@ class MediaPlayerDeviceClass(StrEnum):
     RECEIVER = 'receiver'
 
 DEVICE_CLASSES_SCHEMA: Incomplete
-_DEPRECATED_DEVICE_CLASS_TV: Incomplete
-_DEPRECATED_DEVICE_CLASS_SPEAKER: Incomplete
-_DEPRECATED_DEVICE_CLASS_RECEIVER: Incomplete
 DEVICE_CLASSES: Incomplete
+
+def _promote_media_fields(data: dict[str, Any]) -> dict[str, Any]: ...
+
 MEDIA_PLAYER_PLAY_MEDIA_SCHEMA: Incomplete
 MEDIA_PLAYER_BROWSE_MEDIA_SCHEMA: Incomplete
 ATTR_TO_PROPERTY: Incomplete
@@ -193,8 +193,6 @@ class MediaPlayerEntity(Entity, cached_properties=CACHED_PROPERTIES_WITH_ATTR_):
     def group_members(self) -> list[str] | None: ...
     @cached_property
     def supported_features(self) -> MediaPlayerEntityFeature: ...
-    @property
-    def supported_features_compat(self) -> MediaPlayerEntityFeature: ...
     def turn_on(self) -> None: ...
     async def async_turn_on(self) -> None: ...
     def turn_off(self) -> None: ...
@@ -283,6 +281,8 @@ class MediaPlayerEntity(Entity, cached_properties=CACHED_PROPERTIES_WITH_ATTR_):
     @property
     def state_attributes(self) -> dict[str, Any]: ...
     async def async_browse_media(self, media_content_type: MediaType | str | None = None, media_content_id: str | None = None) -> BrowseMedia: ...
+    async def async_internal_search_media(self, search_query: str, media_content_type: MediaType | str | None = None, media_content_id: str | None = None, media_filter_classes: list[MediaClass] | None = None) -> SearchMedia: ...
+    async def async_search_media(self, query: SearchMediaQuery) -> SearchMedia: ...
     def join_players(self, group_members: list[str]) -> None: ...
     async def async_join_players(self, group_members: list[str]) -> None: ...
     def unjoin_player(self) -> None: ...
@@ -302,11 +302,9 @@ class MediaPlayerImageView(HomeAssistantView):
 
 @websocket_api.async_response
 async def websocket_browse_media(hass: HomeAssistant, connection: websocket_api.connection.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.async_response
+async def websocket_search_media(hass: HomeAssistant, connection: websocket_api.connection.ActiveConnection, msg: dict[str, Any]) -> None: ...
 
 _FETCH_TIMEOUT: Incomplete
 
 async def async_fetch_image(logger: logging.Logger, hass: HomeAssistant, url: str) -> tuple[bytes | None, str | None]: ...
-
-__getattr__: Incomplete
-__dir__: Incomplete
-__all__: Incomplete

homeassistant-stubs/components/media_player/browse_media.pyi

@@ -1,6 +1,7 @@
 from .const import CONTENT_AUTH_EXPIRY_TIME as CONTENT_AUTH_EXPIRY_TIME, MediaClass as MediaClass, MediaType as MediaType
 from _typeshed import Incomplete
 from collections.abc import Sequence
+from dataclasses import dataclass, field
 from homeassistant.components.http.auth import async_sign_path as async_sign_path
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
@@ -23,7 +24,21 @@ class BrowseMedia:
     children_media_class: Incomplete
     thumbnail: Incomplete
     not_shown: Incomplete
-    def __init__(self, *, media_class: MediaClass | str, media_content_id: str, media_content_type: MediaType | str, title: str, can_play: bool, can_expand: bool, children: Sequence[BrowseMedia] | None = None, children_media_class: MediaClass | str | None = None, thumbnail: str | None = None, not_shown: int = 0) -> None: ...
+    can_search: Incomplete
+    def __init__(self, *, media_class: MediaClass | str, media_content_id: str, media_content_type: MediaType | str, title: str, can_play: bool, can_expand: bool, children: Sequence[BrowseMedia] | None = None, children_media_class: MediaClass | str | None = None, thumbnail: str | None = None, not_shown: int = 0, can_search: bool = False) -> None: ...
     def as_dict(self, *, parent: bool = True) -> dict[str, Any]: ...
     def calculate_children_class(self) -> None: ...
     def __repr__(self) -> str: ...
+
+@dataclass(kw_only=True, frozen=True)
+class SearchMedia:
+    version: int = field(default=1)
+    result: list[BrowseMedia]
+    def as_dict(self, *, parent: bool = True) -> dict[str, Any]: ...
+
+@dataclass(kw_only=True, frozen=True)
+class SearchMediaQuery:
+    search_query: str
+    media_content_type: MediaType | str | None = field(default=None)
+    media_content_id: str | None = ...
+    media_filter_classes: list[MediaClass] | None = field(default=None)