homeassistant 2025.9.4__py3-none-any.whl → 2025.10.0b0__py3-none-any.whl

homeassistant/components/alexa_devices/translations/de.json

@@ -170,10 +170,6 @@
                 "sound": {
                     "description": "Die Ger\u00e4uschdatei, die abgespielt werden soll.",
                     "name": "Alexa Skill-Sounddatei"
-                },
-                "sound_variant": {
-                    "description": "Die Variante des abzuspielenden Ger\u00e4uschs.",
-                    "name": "Ger\u00e4usch-Variante"
                 }
             },
             "name": "Ger\u00e4usch senden"

homeassistant/components/alexa_devices/translations/en-GB.json

@@ -123,10 +123,6 @@
                 "sound": {
                     "description": "The sound file to play.",
                     "name": "Alexa Skill sound file"
-                },
-                "sound_variant": {
-                    "description": "The variant of the sound to play.",
-                    "name": "Sound variant"
                 }
             },
             "name": "Send sound"

homeassistant/components/alexa_devices/translations/en.json

@@ -170,10 +170,6 @@
                 "sound": {
                     "description": "The sound file to play.",
                     "name": "Alexa Skill sound file"
-                },
-                "sound_variant": {
-                    "description": "The variant of the sound to play.",
-                    "name": "Sound variant"
                 }
             },
             "name": "Send sound"

homeassistant/components/alexa_devices/translations/es.json

@@ -170,10 +170,6 @@
                 "sound": {
                     "description": "El archivo de sonido a reproducir.",
                     "name": "Archivo de sonido de Alexa Skill"
-                },
-                "sound_variant": {
-                    "description": "La variante del sonido a reproducir.",
-                    "name": "Variante de sonido"
                 }
             },
             "name": "Enviar sonido"

homeassistant/components/alexa_devices/translations/et.json

@@ -170,10 +170,6 @@
                 "sound": {
                     "description": "Esitatav helifail.",
                     "name": "Alexa Skill helifail"
-                },
-                "sound_variant": {
-                    "description": "Esitatava heli variant.",
-                    "name": "Heli variant"
                 }
             },
             "name": "Saada heli"

homeassistant/components/alexa_devices/translations/ga.json

@@ -166,10 +166,6 @@
                 "sound": {
                     "description": "An comhad fuaime le seinm.",
                     "name": "Comhad fuaime Alexa Skill"
-                },
-                "sound_variant": {
-                    "description": "An leagan den fhuaim at\u00e1 le seinm.",
-                    "name": "Leagan fuaime"
                 }
             },
             "name": "Seol fuaim"

homeassistant/components/alexa_devices/translations/lt.json

@@ -170,10 +170,6 @@
                 "sound": {
                     "description": "Garso failas, kur\u012f reikia leisti.",
                     "name": "Alexa \u012fg\u016bd\u017ei\u0173 garso failas"
-                },
-                "sound_variant": {
-                    "description": "Grojamo garso variantas.",
-                    "name": "Garso variantas"
                 }
             },
             "name": "Si\u0173sti gars\u0105"

homeassistant/components/alexa_devices/translations/nl.json

@@ -71,9 +71,11 @@
     "selector": {
         "sound": {
             "options": {
+                "amzn_sfx_dog_med_bark_1x_02": "Blaffende hond",
                 "amzn_sfx_doorbell_01": "Deurbel 1",
                 "amzn_sfx_doorbell_chime_01": "Deurbel 2",
                 "amzn_sfx_doorbell_chime_02": "Deurbel 3",
+                "amzn_sfx_lion_roar_02": "Leeuwengebrul",
                 "amzn_sfx_scifi_alarm_01": "Sirenes",
                 "amzn_sfx_trumpet_bugle_04": "Trompet",
                 "bell_02": "Klokken",

homeassistant/components/alexa_devices/translations/pt.json

@@ -4,7 +4,7 @@
         "data_description_code": "A palavra-passe de uso \u00fanico para iniciar sess\u00e3o na sua conta. Atualmente, apenas s\u00e3o suportados tokens de aplica\u00e7\u00f5es OTP.",
         "data_description_password": "A palavra-passe da sua conta Amazon.",
         "data_description_username": "O endere\u00e7o de correio eletr\u00f3nico da sua conta Amazon.",
-        "device_id_description": "A ID do dispositivo para o qual enviar o comando."
+        "device_id_description": "O ID do dispositivo para o qual enviar o comando."
     },
     "config": {
         "abort": {
@@ -164,16 +164,12 @@
             "description": "Envia um som para um dispositivo",
             "fields": {
                 "device_id": {
-                    "description": "A ID do dispositivo para o qual enviar o comando.",
+                    "description": "O ID do dispositivo para o qual enviar o comando.",
                     "name": "Dispositivo"
                 },
                 "sound": {
                     "description": "O ficheiro de som a reproduzir.",
                     "name": "Ficheiro de som Alexa Skill"
-                },
-                "sound_variant": {
-                    "description": "A variante do som a reproduzir.",
-                    "name": "Variante de som"
                 }
             },
             "name": "Enviar som"
@@ -182,7 +178,7 @@
             "description": "Envia um comando de texto para um dispositivo",
             "fields": {
                 "device_id": {
-                    "description": "A ID do dispositivo para o qual enviar o comando.",
+                    "description": "O ID do dispositivo para o qual enviar o comando.",
                     "name": "Dispositivo"
                 },
                 "text_command": {

homeassistant/components/alexa_devices/translations/sk.json

@@ -170,10 +170,6 @@
                 "sound": {
                     "description": "Zvukov\u00fd s\u00fabor na prehr\u00e1vanie.",
                     "name": "Zvukov\u00fd s\u00fabor Alexa Skill"
-                },
-                "sound_variant": {
-                    "description": "Variant zvuku, ktor\u00fd sa m\u00e1 prehra\u0165.",
-                    "name": "Zvukov\u00fd variant"
                 }
             },
             "name": "Odosla\u0165 zvuk"

homeassistant/components/alexa_devices/translations/zh-Hans.json

@@ -170,10 +170,6 @@
                 "sound": {
                     "description": "\u8981\u64ad\u653e\u7684\u58f0\u97f3\u6587\u4ef6\u3002",
                     "name": "Alexa Skill \u58f0\u97f3\u6587\u4ef6"
-                },
-                "sound_variant": {
-                    "description": "\u8981\u64ad\u653e\u7684\u58f0\u97f3\u7684\u53d8\u4f53\u3002",
-                    "name": "\u58f0\u97f3\u53d8\u4f53"
                 }
             },
             "name": "\u53d1\u9001\u58f0\u97f3"

homeassistant/components/alexa_devices/translations/zh-Hant.json

@@ -170,10 +170,6 @@
                 "sound": {
                     "description": "\u8981\u64ad\u653e\u7684\u97f3\u6548\u6a94\u3002",
                     "name": "Alexa Skill \u97f3\u6548\u6a94"
-                },
-                "sound_variant": {
-                    "description": "\u6240\u8981\u64ad\u653e\u7684\u97f3\u6548\u8b8a\u9ad4\u3002",
-                    "name": "\u97f3\u6548\u8b8a\u9ad4"
                 }
             },
             "name": "\u50b3\u9001\u97f3\u6548"

homeassistant/components/amcrest/services.py

@@ -41,7 +41,7 @@ def async_setup_services(hass: HomeAssistant) -> None:
         if call.data.get(ATTR_ENTITY_ID) == ENTITY_MATCH_NONE:
             return []
 
-        call_ids = await async_extract_entity_ids(hass, call)
+        call_ids = await async_extract_entity_ids(call)
         entity_ids = []
         for entity_id in hass.data[DATA_AMCREST][CAMERAS]:
             if entity_id not in call_ids:

homeassistant/components/analytics/__init__.py

@@ -12,10 +12,25 @@ from homeassistant.helpers.event import async_call_later, async_track_time_inter
 from homeassistant.helpers.typing import ConfigType
 from homeassistant.util.hass_dict import HassKey
 
-from .analytics import Analytics
+from .analytics import (
+    Analytics,
+    AnalyticsInput,
+    AnalyticsModifications,
+    DeviceAnalyticsModifications,
+    EntityAnalyticsModifications,
+    async_devices_payload,
+)
 from .const import ATTR_ONBOARDED, ATTR_PREFERENCES, DOMAIN, INTERVAL, PREFERENCE_SCHEMA
 from .http import AnalyticsDevicesView
 
+__all__ = [
+    "AnalyticsInput",
+    "AnalyticsModifications",
+    "DeviceAnalyticsModifications",
+    "EntityAnalyticsModifications",
+    "async_devices_payload",
+]
+
 CONFIG_SCHEMA = cv.empty_config_schema(DOMAIN)
 
 DATA_COMPONENT: HassKey[Analytics] = HassKey(DOMAIN)

homeassistant/components/analytics/analytics.py

@@ -4,9 +4,10 @@ from __future__ import annotations
 
 import asyncio
 from asyncio import timeout
-from dataclasses import asdict as dataclass_asdict, dataclass
+from collections.abc import Awaitable, Callable, Iterable, Mapping
+from dataclasses import asdict as dataclass_asdict, dataclass, field
 from datetime import datetime
-from typing import Any
+from typing import Any, Protocol
 import uuid
 
 import aiohttp
@@ -24,17 +25,25 @@ from homeassistant.components.recorder import (
     get_instance as get_recorder_instance,
 )
 from homeassistant.config_entries import SOURCE_IGNORE
-from homeassistant.const import ATTR_DOMAIN, BASE_PLATFORMS, __version__ as HA_VERSION
+from homeassistant.const import (
+    ATTR_ASSUMED_STATE,
+    ATTR_DOMAIN,
+    BASE_PLATFORMS,
+    __version__ as HA_VERSION,
+)
 from homeassistant.core import HomeAssistant, callback
 from homeassistant.exceptions import HomeAssistantError
 from homeassistant.helpers import device_registry as dr, entity_registry as er
 from homeassistant.helpers.aiohttp_client import async_get_clientsession
 from homeassistant.helpers.hassio import is_hassio
+from homeassistant.helpers.singleton import singleton
 from homeassistant.helpers.storage import Store
 from homeassistant.helpers.system_info import async_get_system_info
+from homeassistant.helpers.typing import UNDEFINED
 from homeassistant.loader import (
     Integration,
     IntegrationNotFound,
+    async_get_integration,
     async_get_integrations,
 )
 from homeassistant.setup import async_get_loaded_integrations
@@ -70,12 +79,115 @@ from .const import (
     ATTR_USER_COUNT,
     ATTR_UUID,
     ATTR_VERSION,
+    DOMAIN,
     LOGGER,
     PREFERENCE_SCHEMA,
     STORAGE_KEY,
     STORAGE_VERSION,
 )
 
+DATA_ANALYTICS_MODIFIERS = "analytics_modifiers"
+
+type AnalyticsModifier = Callable[
+    [HomeAssistant, AnalyticsInput], Awaitable[AnalyticsModifications]
+]
+
+
+@singleton(DATA_ANALYTICS_MODIFIERS)
+def _async_get_modifiers(
+    hass: HomeAssistant,
+) -> dict[str, AnalyticsModifier | None]:
+    """Return the analytics modifiers."""
+    return {}
+
+
+@dataclass
+class AnalyticsInput:
+    """Analytics input for a single integration.
+
+    This is sent to integrations that implement the platform.
+    """
+
+    device_ids: Iterable[str] = field(default_factory=list)
+    entity_ids: Iterable[str] = field(default_factory=list)
+
+
+@dataclass
+class AnalyticsModifications:
+    """Analytics config for a single integration.
+
+    This is used by integrations that implement the platform.
+    """
+
+    remove: bool = False
+    devices: Mapping[str, DeviceAnalyticsModifications] | None = None
+    entities: Mapping[str, EntityAnalyticsModifications] | None = None
+
+
+@dataclass
+class DeviceAnalyticsModifications:
+    """Analytics config for a single device.
+
+    This is used by integrations that implement the platform.
+    """
+
+    remove: bool = False
+
+
+@dataclass
+class EntityAnalyticsModifications:
+    """Analytics config for a single entity.
+
+    This is used by integrations that implement the platform.
+    """
+
+    remove: bool = False
+
+
+class AnalyticsPlatformProtocol(Protocol):
+    """Define the format of analytics platforms."""
+
+    async def async_modify_analytics(
+        self,
+        hass: HomeAssistant,
+        analytics_input: AnalyticsInput,
+    ) -> AnalyticsModifications:
+        """Modify the analytics."""
+
+
+async def _async_get_analytics_platform(
+    hass: HomeAssistant, domain: str
+) -> AnalyticsPlatformProtocol | None:
+    """Get analytics platform."""
+    try:
+        integration = await async_get_integration(hass, domain)
+    except IntegrationNotFound:
+        return None
+    try:
+        return await integration.async_get_platform(DOMAIN)
+    except ImportError:
+        return None
+
+
+async def _async_get_modifier(
+    hass: HomeAssistant, domain: str
+) -> AnalyticsModifier | None:
+    """Get analytics modifier."""
+    modifiers = _async_get_modifiers(hass)
+    modifier = modifiers.get(domain, UNDEFINED)
+
+    if modifier is not UNDEFINED:
+        return modifier
+
+    platform = await _async_get_analytics_platform(hass, domain)
+    if platform is None:
+        modifiers[domain] = None
+        return None
+
+    modifier = getattr(platform, "async_modify_analytics", None)
+    modifiers[domain] = modifier
+    return modifier
+
 
 def gen_uuid() -> str:
     """Generate a new UUID."""
@@ -388,67 +500,208 @@ def _domains_from_yaml_config(yaml_configuration: dict[str, Any]) -> set[str]:
     return domains
 
 
+DEFAULT_ANALYTICS_CONFIG = AnalyticsModifications()
+DEFAULT_DEVICE_ANALYTICS_CONFIG = DeviceAnalyticsModifications()
+DEFAULT_ENTITY_ANALYTICS_CONFIG = EntityAnalyticsModifications()
+
+
 async def async_devices_payload(hass: HomeAssistant) -> dict:
-    """Return the devices payload."""
-    devices: list[dict[str, Any]] = []
+    """Return detailed information about entities and devices."""
     dev_reg = dr.async_get(hass)
-    # Devices that need via device info set
-    new_indexes: dict[str, int] = {}
-    via_devices: dict[str, str] = {}
+    ent_reg = er.async_get(hass)
 
-    seen_integrations = set()
+    integration_inputs: dict[str, tuple[list[str], list[str]]] = {}
+    integration_configs: dict[str, AnalyticsModifications] = {}
 
-    for device in dev_reg.devices.values():
-        if not device.primary_config_entry:
+    # Get device list
+    for device_entry in dev_reg.devices.values():
+        if not device_entry.primary_config_entry:
             continue
 
-        config_entry = hass.config_entries.async_get_entry(device.primary_config_entry)
+        config_entry = hass.config_entries.async_get_entry(
+            device_entry.primary_config_entry
+        )
 
         if config_entry is None:
             continue
 
-        seen_integrations.add(config_entry.domain)
-
-        new_indexes[device.id] = len(devices)
-        devices.append(
-            {
-                "integration": config_entry.domain,
-                "manufacturer": device.manufacturer,
-                "model_id": device.model_id,
-                "model": device.model,
-                "sw_version": device.sw_version,
-                "hw_version": device.hw_version,
-                "has_configuration_url": device.configuration_url is not None,
-                "via_device": None,
-                "entry_type": device.entry_type.value if device.entry_type else None,
-            }
-        )
+        integration_domain = config_entry.domain
 
-        if device.via_device_id:
-            via_devices[device.id] = device.via_device_id
+        integration_input = integration_inputs.setdefault(integration_domain, ([], []))
+        integration_input[0].append(device_entry.id)
 
-    for from_device, via_device in via_devices.items():
-        if via_device not in new_indexes:
-            continue
-        devices[new_indexes[from_device]]["via_device"] = new_indexes[via_device]
+    # Get entity list
+    for entity_entry in ent_reg.entities.values():
+        integration_domain = entity_entry.platform
+
+        integration_input = integration_inputs.setdefault(integration_domain, ([], []))
+        integration_input[1].append(entity_entry.entity_id)
 
     integrations = {
         domain: integration
         for domain, integration in (
-            await async_get_integrations(hass, seen_integrations)
+            await async_get_integrations(hass, integration_inputs.keys())
         ).items()
         if isinstance(integration, Integration)
     }
 
-    for device_info in devices:
-        if integration := integrations.get(device_info["integration"]):
-            device_info["is_custom_integration"] = not integration.is_built_in
-            # Include version for custom integrations
-            if not integration.is_built_in and integration.version:
-                device_info["custom_integration_version"] = str(integration.version)
+    # Filter out custom integrations and integrations that are not device or hub type
+    integration_inputs = {
+        domain: integration_info
+        for domain, integration_info in integration_inputs.items()
+        if (integration := integrations.get(domain)) is not None
+        and integration.is_built_in
+        and integration.integration_type in ("device", "hub")
+    }
+
+    # Call integrations that implement the analytics platform
+    for integration_domain, integration_input in integration_inputs.items():
+        if (
+            modifier := await _async_get_modifier(hass, integration_domain)
+        ) is not None:
+            try:
+                integration_config = await modifier(
+                    hass, AnalyticsInput(*integration_input)
+                )
+            except Exception as err:  # noqa: BLE001
+                LOGGER.exception(
+                    "Calling async_modify_analytics for integration '%s' failed: %s",
+                    integration_domain,
+                    err,
+                )
+                integration_configs[integration_domain] = AnalyticsModifications(
+                    remove=True
+                )
+                continue
+
+            if not isinstance(integration_config, AnalyticsModifications):
+                LOGGER.error(  # type: ignore[unreachable]
+                    "Calling async_modify_analytics for integration '%s' did not return an AnalyticsConfig",
+                    integration_domain,
+                )
+                integration_configs[integration_domain] = AnalyticsModifications(
+                    remove=True
+                )
+                continue
+
+            integration_configs[integration_domain] = integration_config
+
+    integrations_info: dict[str, dict[str, Any]] = {}
+
+    # We need to refer to other devices, for example in `via_device` field.
+    # We don't however send the original device ids outside of Home Assistant,
+    # instead we refer to devices by (integration_domain, index_in_integration_device_list).
+    device_id_mapping: dict[str, tuple[str, int]] = {}
+
+    # Fill out information about devices
+    for integration_domain, integration_input in integration_inputs.items():
+        integration_config = integration_configs.get(
+            integration_domain, DEFAULT_ANALYTICS_CONFIG
+        )
+
+        if integration_config.remove:
+            continue
+
+        integration_info = integrations_info.setdefault(
+            integration_domain, {"devices": [], "entities": []}
+        )
+
+        devices_info = integration_info["devices"]
+
+        for device_id in integration_input[0]:
+            device_config = DEFAULT_DEVICE_ANALYTICS_CONFIG
+            if integration_config.devices is not None:
+                device_config = integration_config.devices.get(device_id, device_config)
+
+            if device_config.remove:
+                continue
+
+            device_entry = dev_reg.devices[device_id]
+
+            device_id_mapping[device_entry.id] = (integration_domain, len(devices_info))
+
+            devices_info.append(
+                {
+                    "entities": [],
+                    "entry_type": device_entry.entry_type,
+                    "has_configuration_url": device_entry.configuration_url is not None,
+                    "hw_version": device_entry.hw_version,
+                    "manufacturer": device_entry.manufacturer,
+                    "model": device_entry.model,
+                    "model_id": device_entry.model_id,
+                    "sw_version": device_entry.sw_version,
+                    "via_device": device_entry.via_device_id,
+                }
+            )
+
+    # Fill out via_device with new device ids
+    for integration_info in integrations_info.values():
+        for device_info in integration_info["devices"]:
+            if device_info["via_device"] is None:
+                continue
+            device_info["via_device"] = device_id_mapping.get(device_info["via_device"])
+
+    # Fill out information about entities
+    for integration_domain, integration_input in integration_inputs.items():
+        integration_config = integration_configs.get(
+            integration_domain, DEFAULT_ANALYTICS_CONFIG
+        )
+
+        if integration_config.remove:
+            continue
+
+        integration_info = integrations_info.setdefault(
+            integration_domain, {"devices": [], "entities": []}
+        )
+
+        devices_info = integration_info["devices"]
+        entities_info = integration_info["entities"]
+
+        for entity_id in integration_input[1]:
+            entity_config = DEFAULT_ENTITY_ANALYTICS_CONFIG
+            if integration_config.entities is not None:
+                entity_config = integration_config.entities.get(
+                    entity_id, entity_config
+                )
+
+            if entity_config.remove:
+                continue
+
+            entity_entry = ent_reg.entities[entity_id]
+
+            entity_state = hass.states.get(entity_entry.entity_id)
+
+            entity_info = {
+                # LIMITATION: `assumed_state` can be overridden by users;
+                # we should replace it with the original value in the future.
+                # It is also not present, if entity is not in the state machine,
+                # which can happen for disabled entities.
+                "assumed_state": (
+                    entity_state.attributes.get(ATTR_ASSUMED_STATE, False)
+                    if entity_state is not None
+                    else None
+                ),
+                "domain": entity_entry.domain,
+                "entity_category": entity_entry.entity_category,
+                "has_entity_name": entity_entry.has_entity_name,
+                "original_device_class": entity_entry.original_device_class,
+                # LIMITATION: `unit_of_measurement` can be overridden by users;
+                # we should replace it with the original value in the future.
+                "unit_of_measurement": entity_entry.unit_of_measurement,
+            }
+
+            if (
+                ((device_id_ := entity_entry.device_id) is not None)
+                and ((new_device_id := device_id_mapping.get(device_id_)) is not None)
+                and (new_device_id[0] == integration_domain)
+            ):
+                device_info = devices_info[new_device_id[1]]
+                device_info["entities"].append(entity_info)
+            else:
+                entities_info.append(entity_info)
 
     return {
         "version": "home-assistant:1",
         "home_assistant": HA_VERSION,
-        "devices": devices,
+        "integrations": integrations_info,
     }

homeassistant/components/analytics/manifest.json

@@ -2,7 +2,7 @@
   "domain": "analytics",
   "name": "Analytics",
   "after_dependencies": ["energy", "hassio", "recorder"],
-  "codeowners": ["@home-assistant/core", "@ludeeus"],
+  "codeowners": ["@home-assistant/core"],
   "dependencies": ["api", "websocket_api", "http"],
   "documentation": "https://www.home-assistant.io/integrations/analytics",
   "integration_type": "system",

homeassistant/components/androidtv/__init__.py

@@ -33,9 +33,11 @@ from homeassistant.const import (
 )
 from homeassistant.core import Event, HomeAssistant
 from homeassistant.exceptions import ConfigEntryNotReady
+from homeassistant.helpers import config_validation as cv
 from homeassistant.helpers.device_registry import format_mac
 from homeassistant.helpers.dispatcher import async_dispatcher_send
 from homeassistant.helpers.storage import STORAGE_DIR
+from homeassistant.helpers.typing import ConfigType
 
 from .const import (
     CONF_ADB_SERVER_IP,
@@ -46,10 +48,12 @@ from .const import (
     DEFAULT_ADB_SERVER_PORT,
     DEVICE_ANDROIDTV,
     DEVICE_FIRETV,
+    DOMAIN,
     PROP_ETHMAC,
     PROP_WIFIMAC,
     SIGNAL_CONFIG_ENTITY,
 )
+from .services import async_setup_services
 
 ADB_PYTHON_EXCEPTIONS: tuple = (
     AdbTimeoutError,
@@ -63,6 +67,8 @@ ADB_PYTHON_EXCEPTIONS: tuple = (
 )
 ADB_TCP_EXCEPTIONS: tuple = (ConnectionResetError, RuntimeError)
 
+CONFIG_SCHEMA = cv.config_entry_only_config_schema(DOMAIN)
+
 PLATFORMS = [Platform.MEDIA_PLAYER, Platform.REMOTE]
 RELOAD_OPTIONS = [CONF_STATE_DETECTION_RULES]
 
@@ -188,6 +194,12 @@ async def async_migrate_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
     return True
 
 
+async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool:
+    """Set up the Android TV / Fire TV integration."""
+    async_setup_services(hass)
+    return True
+
+
 async def async_setup_entry(hass: HomeAssistant, entry: AndroidTVConfigEntry) -> bool:
     """Set up Android Debug Bridge platform."""