homeassistant-stubs 2025.1.1__py3-none-any.whl → 2025.1.3__py3-none-any.whl

homeassistant-stubs/components/androidtv/config_flow.pyi

@@ -24,10 +24,12 @@ def _is_file(value: str) -> bool: ...
 class AndroidTVFlowHandler(ConfigFlow, domain=DOMAIN):
     VERSION: int
     MINOR_VERSION: int
+    @callback
     def _show_setup_form(self, user_input: dict[str, Any] | None = None, error: str | None = None) -> ConfigFlowResult: ...
     async def _async_check_connection(self, user_input: dict[str, Any]) -> tuple[str | None, str | None]: ...
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     @staticmethod
+    @callback
     def async_get_options_flow(config_entry: ConfigEntry) -> OptionsFlowHandler: ...
 
 class OptionsFlowHandler(OptionsFlow):
@@ -36,12 +38,16 @@ class OptionsFlowHandler(OptionsFlow):
     _conf_app_id: str | None
     _conf_rule_id: str | None
     def __init__(self, config_entry: ConfigEntry) -> None: ...
+    @callback
     def _save_config(self, data: dict[str, Any]) -> ConfigFlowResult: ...
     async def async_step_init(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    @callback
     def _async_init_form(self) -> ConfigFlowResult: ...
     async def async_step_apps(self, user_input: dict[str, Any] | None = None, app_id: str | None = None) -> ConfigFlowResult: ...
+    @callback
     def _async_apps_form(self, app_id: str) -> ConfigFlowResult: ...
     async def async_step_rules(self, user_input: dict[str, Any] | None = None, rule_id: str | None = None) -> ConfigFlowResult: ...
+    @callback
     def _async_rules_form(self, rule_id: str, default_id: str = '', errors: dict[str, str] | None = None) -> ConfigFlowResult: ...
 
 def _validate_state_det_rules(state_det_rules: Any) -> list[Any] | None: ...

homeassistant-stubs/components/androidtv_remote/config_flow.pyi

@@ -32,13 +32,16 @@ class AndroidTVRemoteConfigFlow(ConfigFlow, domain=DOMAIN):
     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: ...
     @staticmethod
+    @callback
     def async_get_options_flow(config_entry: ConfigEntry) -> AndroidTVRemoteOptionsFlowHandler: ...
 
 class AndroidTVRemoteOptionsFlowHandler(OptionsFlow):
     _apps: dict[str, Any]
     _conf_app_id: str | None
     def __init__(self, config_entry: ConfigEntry) -> None: ...
+    @callback
     def _save_config(self, data: dict[str, Any]) -> ConfigFlowResult: ...
     async def async_step_init(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def async_step_apps(self, user_input: dict[str, Any] | None = None, app_id: str | None = None) -> ConfigFlowResult: ...
+    @callback
     def _async_apps_form(self, app_id: str) -> ConfigFlowResult: ...

homeassistant-stubs/components/androidtv_remote/entity.pyi

@@ -22,7 +22,9 @@ class AndroidTVRemoteBaseEntity(Entity):
     _attr_device_info: Incomplete
     def __init__(self, api: AndroidTVRemote, config_entry: ConfigEntry) -> None: ...
     _attr_available: Incomplete
+    @callback
     def _is_available_updated(self, is_available: bool) -> None: ...
+    @callback
     def _is_on_updated(self, is_on: bool) -> None: ...
     async def async_added_to_hass(self) -> None: ...
     async def async_will_remove_from_hass(self) -> None: ...

homeassistant-stubs/components/androidtv_remote/media_player.pyi

@@ -26,7 +26,9 @@ class AndroidTVRemoteMediaPlayerEntity(AndroidTVRemoteBaseEntity, MediaPlayerEnt
     _attr_volume_level: Incomplete
     _attr_is_volume_muted: Incomplete
     def _update_volume_info(self, volume_info: dict[str, str | bool]) -> None: ...
+    @callback
     def _current_app_updated(self, current_app: str) -> None: ...
+    @callback
     def _volume_info_updated(self, volume_info: dict[str, str | bool]) -> None: ...
     async def async_added_to_hass(self) -> None: ...
     async def async_will_remove_from_hass(self) -> None: ...

homeassistant-stubs/components/androidtv_remote/remote.pyi

@@ -16,6 +16,7 @@ class AndroidTVRemoteEntity(AndroidTVRemoteBaseEntity, RemoteEntity):
     _attr_supported_features: Incomplete
     _attr_current_activity: Incomplete
     def _update_current_app(self, current_app: str) -> None: ...
+    @callback
     def _current_app_updated(self, current_app: str) -> None: ...
     _attr_activity_list: Incomplete
     async def async_added_to_hass(self) -> None: ...

homeassistant-stubs/components/anova/models.pyi

@@ -9,4 +9,3 @@ class AnovaData:
     api_jwt: str
     coordinators: list[AnovaCoordinator]
     api: AnovaApi
-    def __init__(self, api_jwt, coordinators, api) -> None: ...

homeassistant-stubs/components/anova/sensor.pyi

@@ -13,7 +13,6 @@ from homeassistant.helpers.typing import StateType as StateType
 @dataclass(frozen=True, kw_only=True)
 class AnovaSensorEntityDescription(SensorEntityDescription):
     value_fn: Callable[[APCUpdateSensor], StateType]
-    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., last_reset=..., native_unit_of_measurement=..., options=..., state_class=..., suggested_display_precision=..., suggested_unit_of_measurement=..., value_fn) -> None: ...
 
 SENSOR_DESCRIPTIONS: list[AnovaSensorEntityDescription]
 

homeassistant-stubs/components/anthemav/media_player.pyi

@@ -27,6 +27,7 @@ class AnthemAVR(MediaPlayerEntity):
     _attr_device_info: Incomplete
     def __init__(self, avr: AVR, name: str, mac_address: str, model: str, zone_number: int, entry_id: str) -> None: ...
     async def async_added_to_hass(self) -> None: ...
+    @callback
     def update_states(self) -> None: ...
     _attr_state: Incomplete
     _attr_is_volume_muted: Incomplete

homeassistant-stubs/components/apcupsd/sensor.pyi

@@ -22,6 +22,7 @@ class APCUPSdSensor(CoordinatorEntity[APCUPSdCoordinator], SensorEntity):
     entity_description: Incomplete
     _attr_device_info: Incomplete
     def __init__(self, coordinator: APCUPSdCoordinator, description: SensorEntityDescription) -> None: ...
+    @callback
     def _handle_coordinator_update(self) -> None: ...
     _attr_native_value: Incomplete
     _attr_native_unit_of_measurement: Incomplete

homeassistant-stubs/components/api/__init__.pyi

@@ -1,5 +1,7 @@
+import homeassistant.core as ha
 from _typeshed import Incomplete
 from aiohttp import web
+from functools import lru_cache
 from homeassistant.auth.models import User as User
 from homeassistant.auth.permissions.const import POLICY_READ as POLICY_READ
 from homeassistant.components.http import HomeAssistantView as HomeAssistantView, KEY_HASS as KEY_HASS, KEY_HASS_USER as KEY_HASS_USER, require_admin as require_admin
@@ -34,43 +36,52 @@ async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool: ...
 class APIStatusView(HomeAssistantView):
     url = URL_API
     name: str
+    @ha.callback
     def get(self, request: web.Request) -> web.Response: ...
 
 class APICoreStateView(HomeAssistantView):
     url = URL_API_CORE_STATE
     name: str
+    @ha.callback
     def get(self, request: web.Request) -> web.Response: ...
 
 class APIEventStream(HomeAssistantView):
     url = URL_API_STREAM
     name: str
+    @require_admin
     async def get(self, request: web.Request) -> web.StreamResponse: ...
 
 class APIConfigView(HomeAssistantView):
     url = URL_API_CONFIG
     name: str
+    @ha.callback
     def get(self, request: web.Request) -> web.Response: ...
 
 class APIStatesView(HomeAssistantView):
     url = URL_API_STATES
     name: str
+    @ha.callback
     def get(self, request: web.Request) -> web.Response: ...
 
 class APIEntityStateView(HomeAssistantView):
     url: str
     name: str
+    @ha.callback
     def get(self, request: web.Request, entity_id: str) -> web.Response: ...
     async def post(self, request: web.Request, entity_id: str) -> web.Response: ...
+    @ha.callback
     def delete(self, request: web.Request, entity_id: str) -> web.Response: ...
 
 class APIEventListenersView(HomeAssistantView):
     url = URL_API_EVENTS
     name: str
+    @ha.callback
     def get(self, request: web.Request) -> web.Response: ...
 
 class APIEventView(HomeAssistantView):
     url: str
     name: str
+    @require_admin
     async def post(self, request: web.Request, event_type: str) -> web.Response: ...
 
 class APIServicesView(HomeAssistantView):
@@ -86,19 +97,24 @@ class APIDomainServicesView(HomeAssistantView):
 class APIComponentsView(HomeAssistantView):
     url = URL_API_COMPONENTS
     name: str
+    @ha.callback
     def get(self, request: web.Request) -> web.Response: ...
 
+@lru_cache
 def _cached_template(template_str: str, hass: HomeAssistant) -> template.Template: ...
 
 class APITemplateView(HomeAssistantView):
     url = URL_API_TEMPLATE
     name: str
+    @require_admin
     async def post(self, request: web.Request) -> web.Response: ...
 
 class APIErrorLog(HomeAssistantView):
     url = URL_API_ERROR_LOG
     name: str
+    @require_admin
     async def get(self, request: web.Request) -> web.FileResponse: ...
 
 async def async_services_json(hass: HomeAssistant) -> list[dict[str, Any]]: ...
+@ha.callback
 def async_events_json(hass: HomeAssistant) -> list[dict[str, Any]]: ...

homeassistant-stubs/components/apple_tv/__init__.pyi

@@ -48,6 +48,7 @@ class AppleTVManager(DeviceListener):
     async def _connect_loop(self) -> None: ...
     async def _scan(self) -> AppleTV | None: ...
     async def _connect(self, conf: AppleTV, raise_missing_credentials: bool) -> None: ...
+    @callback
     def _async_setup_device_registry(self) -> None: ...
     @property
     def is_connecting(self) -> bool: ...

homeassistant-stubs/components/apple_tv/config_flow.pyi

@@ -36,18 +36,21 @@ class AppleTVConfigFlow(ConfigFlow, domain=DOMAIN):
     pairing: PairingHandler | None
     protocols_to_pair: deque[Protocol] | None
     @staticmethod
+    @callback
     def async_get_options_flow(config_entry: ConfigEntry) -> SchemaOptionsFlowHandler: ...
     credentials: dict[int, str | None]
     all_identifiers: set[str]
     def __init__(self) -> None: ...
     @property
     def device_identifier(self) -> str | None: ...
+    @callback
     def _entry_unique_id_from_identifers(self, all_identifiers: set[str]) -> str | None: ...
     async def async_step_reauth(self, entry_data: Mapping[str, Any]) -> ConfigFlowResult: ...
     async def async_step_restore_device(self, user_input: dict[str, str] | None = None) -> ConfigFlowResult: ...
     async def async_step_user(self, user_input: dict[str, str] | None = None) -> ConfigFlowResult: ...
     async def async_step_zeroconf(self, discovery_info: zeroconf.ZeroconfServiceInfo) -> ConfigFlowResult: ...
     async def _async_aggregate_discoveries(self, host: str, unique_id: str) -> None: ...
+    @callback
     def _async_check_and_update_in_progress(self, host: str, unique_id: str) -> None: ...
     def is_matching(self, other_flow: Self) -> bool: ...
     async def async_found_zeroconf_device(self, user_input: dict[str, str] | None = None) -> ConfigFlowResult: ...

homeassistant-stubs/components/apple_tv/media_player.pyi

@@ -25,15 +25,22 @@ class AppleTvMediaPlayer(AppleTVEntity, MediaPlayerEntity, PowerListener, AudioL
     _playing: Playing | None
     _app_list: dict[str, str]
     def __init__(self, name: str, identifier: str, manager: AppleTVManager) -> None: ...
+    @callback
     def async_device_connected(self, atv: AppleTV) -> None: ...
     async def _update_app_list(self) -> None: ...
+    @callback
     def async_device_disconnected(self) -> None: ...
     @property
     def state(self) -> MediaPlayerState | None: ...
+    @callback
     def playstatus_update(self, updater: PushUpdater, playstatus: Playing) -> None: ...
+    @callback
     def playstatus_error(self, updater: PushUpdater, exception: Exception) -> None: ...
+    @callback
     def powerstate_update(self, old_state: PowerState, new_state: PowerState) -> None: ...
+    @callback
     def volume_update(self, old_level: float, new_level: float) -> None: ...
+    @callback
     def outputdevices_update(self, old_devices: list[OutputDevice], new_devices: list[OutputDevice]) -> None: ...
     @property
     def app_id(self) -> str | None: ...

homeassistant-stubs/components/apsystems/__init__.pyi

@@ -11,7 +11,6 @@ PLATFORMS: list[Platform]
 class ApSystemsData:
     coordinator: ApSystemsDataCoordinator
     device_id: str
-    def __init__(self, coordinator, device_id) -> None: ...
 type ApSystemsConfigEntry = ConfigEntry[ApSystemsData]
 
 async def async_setup_entry(hass: HomeAssistant, entry: ApSystemsConfigEntry) -> bool: ...

homeassistant-stubs/components/apsystems/binary_sensor.pyi

@@ -14,7 +14,6 @@ from homeassistant.helpers.update_coordinator import CoordinatorEntity as Coordi
 @dataclass(frozen=True, kw_only=True)
 class ApsystemsLocalApiBinarySensorDescription(BinarySensorEntityDescription):
     is_on: Callable[[ReturnAlarmInfo], bool | None]
-    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., is_on) -> None: ...
 
 BINARY_SENSORS: tuple[ApsystemsLocalApiBinarySensorDescription, ...]
 

homeassistant-stubs/components/apsystems/coordinator.pyi

@@ -9,7 +9,6 @@ from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as Da
 class ApSystemsSensorData:
     output_data: ReturnOutputData
     alarm_info: ReturnAlarmInfo
-    def __init__(self, output_data, alarm_info) -> None: ...
 
 class ApSystemsDataCoordinator(DataUpdateCoordinator[ApSystemsSensorData]):
     api: Incomplete

homeassistant-stubs/components/apsystems/sensor.pyi

@@ -15,7 +15,6 @@ from homeassistant.helpers.update_coordinator import CoordinatorEntity as Coordi
 @dataclass(frozen=True, kw_only=True)
 class ApsystemsLocalApiSensorDescription(SensorEntityDescription):
     value_fn: Callable[[ReturnOutputData], float | None]
-    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., last_reset=..., native_unit_of_measurement=..., options=..., state_class=..., suggested_display_precision=..., suggested_unit_of_measurement=..., value_fn) -> None: ...
 
 SENSORS: tuple[ApsystemsLocalApiSensorDescription, ...]
 

homeassistant-stubs/components/aqualogic/sensor.pyi

@@ -12,7 +12,6 @@ from homeassistant.helpers.typing import ConfigType as ConfigType, DiscoveryInfo
 class AquaLogicSensorEntityDescription(SensorEntityDescription):
     unit_metric: str | None = ...
     unit_imperial: str | None = ...
-    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., last_reset=..., native_unit_of_measurement=..., options=..., state_class=..., suggested_display_precision=..., suggested_unit_of_measurement=..., unit_metric=..., unit_imperial=...) -> None: ...
 
 SENSOR_TYPES: tuple[AquaLogicSensorEntityDescription, ...]
 SENSOR_KEYS: list[str]
@@ -29,4 +28,5 @@ class AquaLogicSensor(SensorEntity):
     async def async_added_to_hass(self) -> None: ...
     _attr_native_unit_of_measurement: Incomplete
     _attr_native_value: Incomplete
+    @callback
     def async_update_callback(self) -> None: ...

homeassistant-stubs/components/aquostv/media_player.pyi

@@ -33,16 +33,28 @@ class SharpAquosTVDevice(MediaPlayerEntity):
     _attr_is_volume_muted: bool
     _attr_source: Incomplete
     _attr_volume_level: Incomplete
+    @_retry
     def update(self) -> None: ...
+    @_retry
     def turn_off(self) -> None: ...
+    @_retry
     def volume_up(self) -> None: ...
+    @_retry
     def volume_down(self) -> None: ...
+    @_retry
     def set_volume_level(self, volume: float) -> None: ...
+    @_retry
     def mute_volume(self, mute: bool) -> None: ...
+    @_retry
     def turn_on(self) -> None: ...
+    @_retry
     def media_play_pause(self) -> None: ...
+    @_retry
     def media_play(self) -> None: ...
+    @_retry
     def media_pause(self) -> None: ...
+    @_retry
     def media_next_track(self) -> None: ...
+    @_retry
     def media_previous_track(self) -> None: ...
     def select_source(self, source: str) -> None: ...

homeassistant-stubs/components/aranet/sensor.pyi

@@ -17,7 +17,6 @@ from typing import Any
 class AranetSensorEntityDescription(SensorEntityDescription):
     name: str | None = ...
     scale: float | int = ...
-    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., last_reset=..., native_unit_of_measurement=..., options=..., state_class=..., suggested_display_precision=..., suggested_unit_of_measurement=..., scale=...) -> None: ...
 
 SENSOR_DESCRIPTIONS: Incomplete
 

homeassistant-stubs/components/arcam_fmj/media_player.pyi

@@ -31,15 +31,24 @@ class ArcamFmj(MediaPlayerEntity):
     def state(self) -> MediaPlayerState: ...
     async def async_added_to_hass(self) -> None: ...
     async def async_update(self) -> None: ...
+    @convert_exception
     async def async_mute_volume(self, mute: bool) -> None: ...
+    @convert_exception
     async def async_select_source(self, source: str) -> None: ...
+    @convert_exception
     async def async_select_sound_mode(self, sound_mode: str) -> None: ...
+    @convert_exception
     async def async_set_volume_level(self, volume: float) -> None: ...
+    @convert_exception
     async def async_volume_up(self) -> None: ...
+    @convert_exception
     async def async_volume_down(self) -> None: ...
+    @convert_exception
     async def async_turn_on(self) -> None: ...
+    @convert_exception
     async def async_turn_off(self) -> None: ...
     async def async_browse_media(self, media_content_type: MediaType | str | None = None, media_content_id: str | None = None) -> BrowseMedia: ...
+    @convert_exception
     async def async_play_media(self, media_type: MediaType | str, media_id: str, **kwargs: Any) -> None: ...
     @property
     def source(self) -> str | None: ...

homeassistant-stubs/components/aseko_pool_live/binary_sensor.pyi

@@ -10,7 +10,6 @@ from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEnti
 @dataclass(frozen=True, kw_only=True)
 class AsekoBinarySensorEntityDescription(BinarySensorEntityDescription):
     value_fn: Callable[[Unit], bool | None]
-    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., value_fn) -> None: ...
 
 BINARY_SENSORS: tuple[AsekoBinarySensorEntityDescription, ...]
 

homeassistant-stubs/components/aseko_pool_live/sensor.pyi

@@ -12,7 +12,6 @@ from homeassistant.helpers.typing import StateType as StateType
 @dataclass(frozen=True, kw_only=True)
 class AsekoSensorEntityDescription(SensorEntityDescription):
     value_fn: Callable[[Unit], StateType]
-    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., last_reset=..., native_unit_of_measurement=..., options=..., state_class=..., suggested_display_precision=..., suggested_unit_of_measurement=..., value_fn) -> None: ...
 
 SENSORS: list[AsekoSensorEntityDescription]
 

homeassistant-stubs/components/assist_pipeline/audio_enhancer.pyi

@@ -13,7 +13,6 @@ class EnhancedAudioChunk:
     audio: bytes
     timestamp_ms: int
     speech_probability: float | None
-    def __init__(self, audio, timestamp_ms, speech_probability) -> None: ...
 
 class AudioEnhancer(ABC, metaclass=abc.ABCMeta):
     auto_gain: Incomplete

homeassistant-stubs/components/assist_pipeline/logbook.pyi

@@ -4,4 +4,5 @@ from homeassistant.components.logbook import LOGBOOK_ENTRY_MESSAGE as LOGBOOK_EN
 from homeassistant.const import ATTR_DEVICE_ID as ATTR_DEVICE_ID
 from homeassistant.core import Event as Event, HomeAssistant as HomeAssistant, callback as callback
 
+@callback
 def async_describe_events(hass: HomeAssistant, async_describe_event: Callable[[str, str, Callable[[Event], dict[str, str]]], None]) -> None: ...

homeassistant-stubs/components/assist_pipeline/pipeline.pyi

@@ -6,7 +6,7 @@ from .vad import AudioBuffer as AudioBuffer, VoiceActivityTimeout as VoiceActivi
 from _typeshed import Incomplete
 from collections import deque
 from collections.abc import AsyncGenerator, AsyncIterable, Callable
-from dataclasses import dataclass
+from dataclasses import dataclass, field
 from enum import StrEnum
 from homeassistant.components import conversation as conversation, media_source as media_source, stt as stt, tts as tts, wake_word as wake_word, websocket_api as websocket_api
 from homeassistant.const import MATCH_ALL as MATCH_ALL
@@ -17,6 +17,7 @@ from homeassistant.helpers.collection import CHANGE_UPDATED as CHANGE_UPDATED, C
 from homeassistant.helpers.singleton import singleton as singleton
 from homeassistant.helpers.storage import Store as Store
 from homeassistant.helpers.typing import UNDEFINED as UNDEFINED, UndefinedType as UndefinedType, VolDictType as VolDictType
+from homeassistant.util import ulid as ulid_util
 from homeassistant.util.limited_size_dict import LimitedSizeDict as LimitedSizeDict
 from pathlib import Path
 from queue import Queue
@@ -35,11 +36,15 @@ PIPELINE_FIELDS: VolDictType
 STORED_PIPELINE_RUNS: int
 SAVE_DELAY: int
 
+@callback
 def _async_resolve_default_pipeline_settings(hass: HomeAssistant, *, conversation_engine_id: str | None = None, stt_engine_id: str | None = None, tts_engine_id: str | None = None, pipeline_name: str) -> dict[str, str | None]: ...
 async def _async_create_default_pipeline(hass: HomeAssistant, pipeline_store: PipelineStorageCollection) -> Pipeline: ...
 async def async_create_default_pipeline(hass: HomeAssistant, stt_engine_id: str, tts_engine_id: str, pipeline_name: str) -> Pipeline | None: ...
+@callback
 def _async_get_pipeline_from_conversation_entity(hass: HomeAssistant, entity_id: str) -> Pipeline: ...
+@callback
 def async_get_pipeline(hass: HomeAssistant, pipeline_id: str | None = None) -> Pipeline: ...
+@callback
 def async_get_pipelines(hass: HomeAssistant) -> list[Pipeline]: ...
 async def async_update_pipeline(hass: HomeAssistant, pipeline: Pipeline, *, conversation_engine: str | UndefinedType = ..., conversation_language: str | UndefinedType = ..., language: str | UndefinedType = ..., name: str | UndefinedType = ..., stt_engine: str | None | UndefinedType = ..., stt_language: str | None | UndefinedType = ..., tts_engine: str | None | UndefinedType = ..., tts_language: str | None | UndefinedType = ..., tts_voice: str | None | UndefinedType = ..., wake_word_entity: str | None | UndefinedType = ..., wake_word_id: str | None | UndefinedType = ..., prefer_local_intents: bool | UndefinedType = ...) -> None: ...
 
@@ -62,8 +67,7 @@ class PipelineEventType(StrEnum):
 class PipelineEvent:
     type: PipelineEventType
     data: dict[str, Any] | None = ...
-    timestamp: str = ...
-    def __init__(self, type, data=..., timestamp=...) -> None: ...
+    timestamp: str = field(default_factory=Incomplete)
 type PipelineEventCallback = Callable[[PipelineEvent], None]
 
 @dataclass(frozen=True)
@@ -80,11 +84,10 @@ class Pipeline:
     wake_word_entity: str | None
     wake_word_id: str | None
     prefer_local_intents: bool = ...
-    id: str = ...
+    id: str = field(default_factory=ulid_util.ulid_now)
     @classmethod
     def from_json(cls, data: dict[str, Any]) -> Pipeline: ...
     def to_json(self) -> dict[str, Any]: ...
-    def __init__(self, conversation_engine, conversation_language, language, name, stt_engine, stt_language, tts_engine, tts_language, tts_voice, wake_word_entity, wake_word_id, prefer_local_intents=..., id=...) -> None: ...
 
 class PipelineStage(StrEnum):
     WAKE_WORD = 'wake_word'
@@ -104,7 +107,6 @@ class InvalidPipelineStagesError(PipelineRunValidationError):
 class WakeWordSettings:
     timeout: float | None = ...
     audio_seconds_to_buffer: float = ...
-    def __init__(self, timeout=..., audio_seconds_to_buffer=...) -> None: ...
 
 @dataclass(frozen=True)
 class AudioSettings:
@@ -116,7 +118,6 @@ class AudioSettings:
     def __post_init__(self) -> None: ...
     @property
     def needs_processor(self) -> bool: ...
-    def __init__(self, noise_suppression_level=..., auto_gain_dbfs=..., volume_multiplier=..., is_vad_enabled=..., silence_seconds=...) -> None: ...
 
 @dataclass
 class PipelineRun:
@@ -131,21 +132,22 @@ class PipelineRun:
     intent_agent: str | None = ...
     tts_audio_output: str | dict[str, Any] | None = ...
     wake_word_settings: WakeWordSettings | None = ...
-    audio_settings: AudioSettings = ...
-    id: str = ...
-    stt_provider: stt.SpeechToTextEntity | stt.Provider = ...
-    tts_engine: str = ...
-    tts_options: dict | None = ...
-    wake_word_entity_id: str | None = ...
-    wake_word_entity: wake_word.WakeWordDetectionEntity = ...
-    abort_wake_word_detection: bool = ...
+    audio_settings: AudioSettings = field(default_factory=AudioSettings)
+    id: str = field(default_factory=ulid_util.ulid_now)
+    stt_provider: stt.SpeechToTextEntity | stt.Provider = field(init=False, repr=False)
+    tts_engine: str = field(init=False, repr=False)
+    tts_options: dict | None = field(init=False, default=None)
+    wake_word_entity_id: str | None = field(init=False, default=None, repr=False)
+    wake_word_entity: wake_word.WakeWordDetectionEntity = field(init=False, repr=False)
+    abort_wake_word_detection: bool = field(init=False, default=False)
     debug_recording_thread: Thread | None = ...
     debug_recording_queue: Queue[str | bytes | None] | None = ...
     audio_enhancer: AudioEnhancer | None = ...
-    audio_chunking_buffer: AudioBuffer = ...
+    audio_chunking_buffer: AudioBuffer = field(default_factory=Incomplete)
     _device_id: str | None = ...
     def __post_init__(self) -> None: ...
     def __eq__(self, other: object) -> bool: ...
+    @callback
     def process_event(self, event: PipelineEvent) -> None: ...
     def start(self, device_id: str | None) -> None: ...
     async def end(self) -> None: ...
@@ -164,7 +166,6 @@ class PipelineRun:
     async def _stop_debug_recording_thread(self) -> None: ...
     async def process_volume_only(self, audio_stream: AsyncIterable[bytes]) -> AsyncGenerator[EnhancedAudioChunk]: ...
     async def process_enhance_audio(self, audio_stream: AsyncIterable[bytes]) -> AsyncGenerator[EnhancedAudioChunk]: ...
-    def __init__(self, hass, context, pipeline, start_stage, end_stage, event_callback, language=..., runner_data=..., intent_agent=..., tts_audio_output=..., wake_word_settings=..., audio_settings=..., id=..., debug_recording_thread=..., debug_recording_queue=..., audio_enhancer=..., audio_chunking_buffer=..., _device_id=...) -> None: ...
 
 def _multiply_volume(chunk: bytes, volume_multiplier: float) -> bytes: ...
 def _pipeline_debug_recording_thread_proc(run_recording_dir: Path, queue: Queue[str | bytes | None], message_timeout: float = 5) -> None: ...
@@ -181,7 +182,6 @@ class PipelineInput:
     device_id: str | None = ...
     async def execute(self) -> None: ...
     async def validate(self) -> None: ...
-    def __init__(self, run, stt_metadata=..., stt_stream=..., wake_word_phrase=..., intent_input=..., tts_input=..., conversation_id=..., device_id=...) -> None: ...
 
 class PipelinePreferred(CollectionError):
     item_id: Incomplete
@@ -194,20 +194,27 @@ class PipelineStorageCollection(StorageCollection[Pipeline, SerializedPipelineSt
     _preferred_item: str
     async def _async_load_data(self) -> SerializedPipelineStorageCollection | None: ...
     async def _process_create_data(self, data: dict) -> dict: ...
+    @callback
     def _get_suggested_id(self, info: dict) -> str: ...
     async def _update_data(self, item: Pipeline, update_data: dict) -> Pipeline: ...
     def _create_item(self, item_id: str, data: dict) -> Pipeline: ...
     def _deserialize_item(self, data: dict) -> Pipeline: ...
     def _serialize_item(self, item_id: str, item: Pipeline) -> dict: ...
     async def async_delete_item(self, item_id: str) -> None: ...
+    @callback
     def async_get_preferred_item(self) -> str: ...
+    @callback
     def async_set_preferred_item(self, item_id: str) -> None: ...
+    @callback
     def _data_to_save(self) -> SerializedPipelineStorageCollection: ...
 
 class PipelineStorageCollectionWebsocket(StorageCollectionWebsocket[PipelineStorageCollection]):
+    @callback
     def async_setup(self, hass: HomeAssistant) -> None: ...
     async def ws_delete_item(self, hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict) -> None: ...
+    @callback
     def ws_get_item(self, hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict) -> None: ...
+    @callback
     def ws_list_item(self, hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict) -> None: ...
     async def ws_set_preferred_item(self, hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
 
@@ -222,15 +229,13 @@ class PipelineRuns:
 @dataclass(slots=True)
 class DeviceAudioQueue:
     queue: asyncio.Queue[bytes | None]
-    id: str = ...
+    id: str = field(default_factory=ulid_util.ulid_now)
     overflow: bool = ...
-    def __init__(self, queue, id=..., overflow=...) -> None: ...
 
 @dataclass(slots=True)
 class AssistDevice:
     domain: str
     unique_id_prefix: str
-    def __init__(self, domain, unique_id_prefix) -> None: ...
 
 class PipelineData:
     pipeline_store: Incomplete
@@ -242,13 +247,13 @@ class PipelineData:
 
 @dataclass(slots=True)
 class PipelineRunDebug:
-    events: list[PipelineEvent] = ...
-    timestamp: str = ...
-    def __init__(self) -> None: ...
+    events: list[PipelineEvent] = field(default_factory=list, init=False)
+    timestamp: str = field(default_factory=Incomplete, init=False)
 
 class PipelineStore(Store[SerializedPipelineStorageCollection]):
     async def _async_migrate_func(self, old_major_version: int, old_minor_version: int, old_data: SerializedPipelineStorageCollection) -> SerializedPipelineStorageCollection: ...
 
 async def async_setup_pipeline_store(hass: HomeAssistant) -> PipelineData: ...
+@callback
 def async_migrate_engine(hass: HomeAssistant, engine_type: Literal['conversation', 'stt', 'tts', 'wake_word'], old_value: str, new_value: str) -> None: ...
 async def async_run_migrations(hass: HomeAssistant) -> None: ...

homeassistant-stubs/components/assist_pipeline/select.pyi

@@ -8,7 +8,9 @@ from homeassistant.const import EntityCategory as EntityCategory, Platform as Pl
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers import collection as collection, restore_state as restore_state
 
+@callback
 def get_chosen_pipeline(hass: HomeAssistant, domain: str, unique_id_prefix: str) -> str | None: ...
+@callback
 def get_vad_sensitivity(hass: HomeAssistant, domain: str, unique_id_prefix: str) -> VadSensitivity: ...
 
 class AssistPipelineSelect(SelectEntity, restore_state.RestoreEntity):
@@ -24,6 +26,7 @@ class AssistPipelineSelect(SelectEntity, restore_state.RestoreEntity):
     async def async_added_to_hass(self) -> None: ...
     async def async_select_option(self, option: str) -> None: ...
     async def _pipelines_updated(self, change_set: Iterable[collection.CollectionChange]) -> None: ...
+    @callback
     def _update_options(self) -> None: ...
 
 class VadSensitivitySelect(SelectEntity, restore_state.RestoreEntity):

homeassistant-stubs/components/assist_pipeline/vad.pyi

@@ -45,7 +45,6 @@ class VoiceCommandSegmenter:
     def reset(self) -> None: ...
     def process(self, chunk_seconds: float, speech_probability: float | None) -> bool: ...
     def process_with_vad(self, chunk: bytes, vad_samples_per_chunk: int | None, vad_is_speech: Callable[[bytes], bool], leftover_chunk_buffer: AudioBuffer | None) -> bool: ...
-    def __init__(self, speech_seconds=..., command_seconds=..., silence_seconds=..., timeout_seconds=..., reset_seconds=..., in_command=..., timed_out=..., before_command_speech_threshold=..., in_command_speech_threshold=..., _speech_seconds_left=..., _command_seconds_left=..., _silence_seconds_left=..., _timeout_seconds_left=..., _reset_seconds_left=...) -> None: ...
 
 @dataclass
 class VoiceActivityTimeout:
@@ -57,6 +56,5 @@ class VoiceActivityTimeout:
     def __post_init__(self) -> None: ...
     def reset(self) -> None: ...
     def process(self, chunk_seconds: float, speech_probability: float | None) -> bool: ...
-    def __init__(self, silence_seconds, reset_seconds=..., speech_threshold=..., _silence_seconds_left=..., _reset_seconds_left=...) -> None: ...
 
 def chunk_samples(samples: bytes, bytes_per_chunk: int, leftover_chunk_buffer: AudioBuffer) -> Iterable[bytes]: ...

homeassistant-stubs/components/assist_pipeline/websocket_api.pyi

@@ -14,10 +14,21 @@ CAPTURE_WIDTH: Final[int]
 CAPTURE_CHANNELS: Final[int]
 MAX_CAPTURE_TIMEOUT: Final[float]
 
+@callback
 def async_register_websocket_api(hass: HomeAssistant) -> None: ...
+@websocket_api.async_response
 async def websocket_run(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@callback
+@websocket_api.require_admin
 def websocket_list_runs(hass: HomeAssistant, connection: websocket_api.connection.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@callback
+@websocket_api.require_admin
 def websocket_list_devices(hass: HomeAssistant, connection: websocket_api.connection.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@callback
+@websocket_api.require_admin
 def websocket_get_run(hass: HomeAssistant, connection: websocket_api.connection.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@callback
 def websocket_list_languages(hass: HomeAssistant, connection: websocket_api.connection.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@websocket_api.async_response
 async def websocket_device_capture(hass: HomeAssistant, connection: websocket_api.connection.ActiveConnection, msg: dict[str, Any]) -> None: ...