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

homeassistant-stubs/helpers/llm.pyi

@@ -6,8 +6,8 @@ from _typeshed import Incomplete
 from abc import ABC, abstractmethod
 from collections.abc import Callable as Callable
 from dataclasses import dataclass
+from homeassistant.components.calendar import SERVICE_GET_EVENTS as SERVICE_GET_EVENTS
 from homeassistant.components.climate import INTENT_GET_TEMPERATURE as INTENT_GET_TEMPERATURE
-from homeassistant.components.conversation import ConversationTraceEventType as ConversationTraceEventType, async_conversation_trace_append as async_conversation_trace_append
 from homeassistant.components.cover import INTENT_CLOSE_COVER as INTENT_CLOSE_COVER, INTENT_OPEN_COVER as INTENT_OPEN_COVER
 from homeassistant.components.homeassistant import async_should_expose as async_should_expose
 from homeassistant.components.intent import async_device_supports_timers as async_device_supports_timers
@@ -15,12 +15,11 @@ from homeassistant.components.weather import INTENT_GET_WEATHER as INTENT_GET_WE
 from homeassistant.const import ATTR_DOMAIN as ATTR_DOMAIN, ATTR_SERVICE as ATTR_SERVICE, EVENT_HOMEASSISTANT_CLOSE as EVENT_HOMEASSISTANT_CLOSE, EVENT_SERVICE_REMOVED as EVENT_SERVICE_REMOVED
 from homeassistant.core import Context as Context, Event as Event, HomeAssistant as HomeAssistant, callback as callback, split_entity_id as split_entity_id
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
-from homeassistant.util import yaml as yaml
 from homeassistant.util.hass_dict import HassKey as HassKey
 from homeassistant.util.json import JsonObjectType as JsonObjectType
 from typing import Any
 
-SCRIPT_PARAMETERS_CACHE: HassKey[dict[str, tuple[str | None, vol.Schema]]]
+ACTION_PARAMETERS_CACHE: HassKey[dict[str, dict[str, tuple[str | None, vol.Schema]]]]
 LLM_API_ASSIST: str
 BASE_PROMPT: str
 DEFAULT_INSTRUCTIONS_PROMPT: str
@@ -30,7 +29,7 @@ def async_render_no_api_prompt(hass: HomeAssistant) -> str: ...
 @callback
 def _async_get_apis(hass: HomeAssistant) -> dict[str, API]: ...
 @callback
-def async_register_api(hass: HomeAssistant, api: API) -> None: ...
+def async_register_api(hass: HomeAssistant, api: API) -> Callable[[], None]: ...
 async def async_get_api(hass: HomeAssistant, api_id: str, llm_context: LLMContext) -> APIInstance: ...
 @callback
 def async_get_apis(hass: HomeAssistant) -> list[API]: ...
@@ -90,14 +89,30 @@ class AssistAPI(API):
     @callback
     def _async_get_api_prompt(self, llm_context: LLMContext, exposed_entities: dict | None) -> str: ...
     @callback
+    def _async_get_preable(self, llm_context: LLMContext) -> list[str]: ...
+    @callback
+    def _async_get_exposed_entities_prompt(self, llm_context: LLMContext, exposed_entities: dict | None) -> list[str]: ...
+    @callback
     def _async_get_tools(self, llm_context: LLMContext, exposed_entities: dict | None) -> list[Tool]: ...
 
-def _get_exposed_entities(hass: HomeAssistant, assistant: str) -> dict[str, dict[str, Any]]: ...
+def _get_exposed_entities(hass: HomeAssistant, assistant: str) -> dict[str, dict[str, dict[str, Any]]]: ...
 def _selector_serializer(schema: Any) -> Any: ...
-def _get_cached_script_parameters(hass: HomeAssistant, entity_id: str) -> tuple[str | None, vol.Schema]: ...
+def _get_cached_action_parameters(hass: HomeAssistant, domain: str, action: str) -> tuple[str | None, vol.Schema]: ...
+
+class ActionTool(Tool):
+    _domain: Incomplete
+    _action: Incomplete
+    name: Incomplete
+    def __init__(self, hass: HomeAssistant, domain: str, action: str) -> None: ...
+    async def async_call(self, hass: HomeAssistant, tool_input: ToolInput, llm_context: LLMContext) -> JsonObjectType: ...
 
-class ScriptTool(Tool):
-    _object_id: Incomplete
+class ScriptTool(ActionTool):
     name: Incomplete
     def __init__(self, hass: HomeAssistant, script_entity_id: str) -> None: ...
+
+class CalendarGetEventsTool(Tool):
+    name: str
+    description: str
+    parameters: Incomplete
+    def __init__(self, calendars: list[str]) -> None: ...
     async def async_call(self, hass: HomeAssistant, tool_input: ToolInput, llm_context: LLMContext) -> JsonObjectType: ...

homeassistant-stubs/helpers/script.pyi

@@ -26,7 +26,7 @@ from homeassistant.util.async_ import create_eager_task as create_eager_task
 from homeassistant.util.dt import utcnow as utcnow
 from homeassistant.util.hass_dict import HassKey as HassKey
 from homeassistant.util.signal_type import SignalType as SignalType, SignalTypeFormat as SignalTypeFormat
-from propcache import cached_property
+from propcache.api import cached_property
 from types import MappingProxyType
 from typing import Any, Literal, TypedDict, overload
 

homeassistant-stubs/helpers/service_info/dhcp.pyi

@@ -0,0 +1,8 @@
+from dataclasses import dataclass
+from homeassistant.data_entry_flow import BaseServiceInfo as BaseServiceInfo
+
+@dataclass(slots=True)
+class DhcpServiceInfo(BaseServiceInfo):
+    ip: str
+    hostname: str
+    macaddress: str

homeassistant-stubs/helpers/service_info/ssdp.pyi

@@ -0,0 +1,34 @@
+from collections.abc import Mapping
+from dataclasses import dataclass, field
+from homeassistant.data_entry_flow import BaseServiceInfo as BaseServiceInfo
+from typing import Any, Final
+
+ATTR_ST: Final[str]
+ATTR_NT: Final[str]
+ATTR_UPNP_DEVICE_TYPE: Final[str]
+ATTR_UPNP_FRIENDLY_NAME: Final[str]
+ATTR_UPNP_MANUFACTURER: Final[str]
+ATTR_UPNP_MANUFACTURER_URL: Final[str]
+ATTR_UPNP_MODEL_DESCRIPTION: Final[str]
+ATTR_UPNP_MODEL_NAME: Final[str]
+ATTR_UPNP_MODEL_NUMBER: Final[str]
+ATTR_UPNP_MODEL_URL: Final[str]
+ATTR_UPNP_SERIAL: Final[str]
+ATTR_UPNP_SERVICE_LIST: Final[str]
+ATTR_UPNP_UDN: Final[str]
+ATTR_UPNP_UPC: Final[str]
+ATTR_UPNP_PRESENTATION_URL: Final[str]
+
+@dataclass(slots=True)
+class SsdpServiceInfo(BaseServiceInfo):
+    ssdp_usn: str
+    ssdp_st: str
+    upnp: Mapping[str, Any]
+    ssdp_location: str | None = ...
+    ssdp_nt: str | None = ...
+    ssdp_udn: str | None = ...
+    ssdp_ext: str | None = ...
+    ssdp_server: str | None = ...
+    ssdp_headers: Mapping[str, Any] = field(default_factory=dict)
+    ssdp_all_locations: set[str] = field(default_factory=set)
+    x_homeassistant_matching_domains: set[str] = field(default_factory=set)

homeassistant-stubs/helpers/service_info/usb.pyi

@@ -0,0 +1,11 @@
+from dataclasses import dataclass
+from homeassistant.data_entry_flow import BaseServiceInfo as BaseServiceInfo
+
+@dataclass(slots=True)
+class UsbServiceInfo(BaseServiceInfo):
+    device: str
+    vid: str
+    pid: str
+    serial_number: str | None
+    manufacturer: str | None
+    description: str | None

homeassistant-stubs/helpers/service_info/zeroconf.pyi

@@ -0,0 +1,20 @@
+from dataclasses import dataclass
+from homeassistant.data_entry_flow import BaseServiceInfo as BaseServiceInfo
+from ipaddress import IPv4Address, IPv6Address
+from typing import Any, Final
+
+ATTR_PROPERTIES_ID: Final[str]
+
+@dataclass(slots=True)
+class ZeroconfServiceInfo(BaseServiceInfo):
+    ip_address: IPv4Address | IPv6Address
+    ip_addresses: list[IPv4Address | IPv6Address]
+    port: int | None
+    hostname: str
+    type: str
+    name: str
+    properties: dict[str, Any]
+    @property
+    def host(self) -> str: ...
+    @property
+    def addresses(self) -> list[str]: ...

homeassistant-stubs/helpers/singleton.pyi

@@ -1,11 +1,15 @@
-from collections.abc import Callable
+from collections.abc import Callable, Coroutine
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.loader import bind_hass as bind_hass
 from homeassistant.util.hass_dict import HassKey as HassKey
-from typing import overload
+from typing import Any, Literal, overload
 
 type _FuncType[_T] = Callable[[HomeAssistant], _T]
+type _Coro[_T] = Coroutine[Any, Any, _T]
+@overload
+def singleton[_T](data_key: HassKey[_T], *, async_: Literal[True]) -> Callable[[_FuncType[_Coro[_T]]], _FuncType[_Coro[_T]]]: ...
 @overload
 def singleton[_T](data_key: HassKey[_T]) -> Callable[[_FuncType[_T]], _FuncType[_T]]: ...
 @overload
 def singleton[_T](data_key: str) -> Callable[[_FuncType[_T]], _FuncType[_T]]: ...
+async def _test_singleton_typing(hass: HomeAssistant) -> None: ...

homeassistant-stubs/helpers/storage.pyi

@@ -10,7 +10,7 @@ from homeassistant.util.file import WriteError as WriteError
 from homeassistant.util.hass_dict import HassKey as HassKey
 from json import JSONEncoder
 from pathlib import Path
-from propcache import cached_property
+from propcache.api import cached_property
 from typing import Any
 
 MAX_LOAD_CONCURRENTLY: int

homeassistant-stubs/helpers/template.pyi

@@ -25,7 +25,7 @@ from homeassistant.util.thread import ThreadWithException as ThreadWithException
 from jinja2 import pass_context
 from jinja2.sandbox import ImmutableSandboxedEnvironment
 from lru import LRU
-from propcache import under_cached_property
+from propcache.api import under_cached_property
 from types import CodeType, TracebackType
 from typing import Any, Literal, NoReturn, Self, overload
 
@@ -268,9 +268,9 @@ def _label_id_or_name(hass: HomeAssistant, label_id_or_name: str) -> str | None:
 def label_areas(hass: HomeAssistant, label_id_or_name: str) -> Iterable[str]: ...
 def label_devices(hass: HomeAssistant, label_id_or_name: str) -> Iterable[str]: ...
 def label_entities(hass: HomeAssistant, label_id_or_name: str) -> Iterable[str]: ...
-def closest(hass, *args): ...
-def closest_filter(hass, *args): ...
-def distance(hass, *args): ...
+def closest(hass: HomeAssistant, *args: Any) -> State | None: ...
+def closest_filter(hass: HomeAssistant, *args: Any) -> State | None: ...
+def distance(hass: HomeAssistant, *args: Any) -> float | None: ...
 def is_hidden_entity(hass: HomeAssistant, entity_id: str) -> bool: ...
 def is_state(hass: HomeAssistant, entity_id: str, state: str | list[str]) -> bool: ...
 def is_state_attr(hass: HomeAssistant, entity_id: str, name: str, value: Any) -> bool: ...

homeassistant-stubs/helpers/update_coordinator.pyi

@@ -14,14 +14,12 @@ from homeassistant.const import EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_
 from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, Event as Event, HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import ConfigEntryAuthFailed as ConfigEntryAuthFailed, ConfigEntryError as ConfigEntryError, ConfigEntryNotReady as ConfigEntryNotReady, HomeAssistantError as HomeAssistantError
 from homeassistant.util.dt import utcnow as utcnow
-from propcache import cached_property
-from typing import Any, Generic, Protocol
-from typing_extensions import TypeVar
+from propcache.api import cached_property
+from typing import Any, Generic, Protocol, TypeVar
 
 REQUEST_REFRESH_DEFAULT_COOLDOWN: int
 REQUEST_REFRESH_DEFAULT_IMMEDIATE: bool
 _DataT = TypeVar('_DataT', default=dict[str, Any])
-_DataUpdateCoordinatorT = TypeVar('_DataUpdateCoordinatorT', bound='DataUpdateCoordinator[Any]', default='DataUpdateCoordinator[dict[str, Any]]')
 
 class UpdateFailed(HomeAssistantError): ...
 
@@ -41,7 +39,8 @@ class DataUpdateCoordinator(BaseDataUpdateCoordinatorProtocol, Generic[_DataT]):
     always_update: Incomplete
     data: _DataT
     _microsecond: Incomplete
-    _listeners: dict[CALLBACK_TYPE, tuple[CALLBACK_TYPE, object | None]]
+    _listeners: dict[int, tuple[CALLBACK_TYPE, object | None]]
+    _last_listener_id: int
     _unsub_refresh: CALLBACK_TYPE | None
     _unsub_shutdown: CALLBACK_TYPE | None
     _request_refresh_task: asyncio.TimerHandle | None
@@ -53,6 +52,8 @@ class DataUpdateCoordinator(BaseDataUpdateCoordinatorProtocol, Generic[_DataT]):
     @callback
     def async_add_listener(self, update_callback: CALLBACK_TYPE, context: Any = None) -> Callable[[], None]: ...
     @callback
+    def __async_remove_listener_internal(self, listener_id: int) -> None: ...
+    @callback
     def async_update_listeners(self) -> None: ...
     async def async_shutdown(self) -> None: ...
     @callback
@@ -101,7 +102,7 @@ class BaseCoordinatorEntity[_BaseDataUpdateCoordinatorT: BaseDataUpdateCoordinat
     @abstractmethod
     async def async_update(self) -> None: ...
 
-class CoordinatorEntity(BaseCoordinatorEntity[_DataUpdateCoordinatorT]):
+class CoordinatorEntity[_DataUpdateCoordinatorT: DataUpdateCoordinator[Any] = DataUpdateCoordinator[dict[str, Any]]](BaseCoordinatorEntity[_DataUpdateCoordinatorT]):
     def __init__(self, coordinator: _DataUpdateCoordinatorT, context: Any = None) -> None: ...
     @property
     def available(self) -> bool: ...

homeassistant-stubs/loader.pyi

@@ -22,7 +22,7 @@ from _typeshed import Incomplete
 from awesomeversion import AwesomeVersion
 from collections.abc import Callable as Callable, Iterable
 from dataclasses import dataclass
-from propcache import cached_property
+from propcache.api import cached_property
 from types import ModuleType
 from typing import Any, Literal, Protocol, TypedDict
 

homeassistant-stubs/scripts/benchmark/__init__.pyi

@@ -11,18 +11,18 @@ def run(args) -> None: ...
 async def run_benchmark(bench) -> None: ...
 def benchmark[_CallableT: Callable](func: _CallableT) -> _CallableT: ...
 @benchmark
-async def fire_events(hass): ...
+async def fire_events(hass: core.HomeAssistant) -> float: ...
 @benchmark
-async def fire_events_with_filter(hass): ...
+async def fire_events_with_filter(hass: core.HomeAssistant) -> float: ...
 @benchmark
-async def state_changed_helper(hass): ...
+async def state_changed_helper(hass: core.HomeAssistant) -> float: ...
 @benchmark
-async def state_changed_event_helper(hass): ...
+async def state_changed_event_helper(hass: core.HomeAssistant) -> float: ...
 @benchmark
-async def state_changed_event_filter_helper(hass): ...
+async def state_changed_event_filter_helper(hass: core.HomeAssistant) -> float: ...
 @benchmark
-async def filtering_entity_id(hass): ...
+async def filtering_entity_id(hass: core.HomeAssistant) -> float: ...
 @benchmark
-async def valid_entity_id(hass): ...
+async def valid_entity_id(hass: core.HomeAssistant) -> float: ...
 @benchmark
-async def json_serialize_states(hass): ...
+async def json_serialize_states(hass: core.HomeAssistant) -> float: ...

homeassistant-stubs/util/event_type.pyi

@@ -1,6 +1,5 @@
 from collections.abc import Mapping
-from typing import Any, Generic
-from typing_extensions import TypeVar
+from typing import Any, Generic, TypeVar
 
 __all__ = ['EventType']
 

homeassistant-stubs/util/ulid.pyi

@@ -1,5 +1,5 @@
 from ulid_transform import bytes_to_ulid as bytes_to_ulid, bytes_to_ulid_or_none as bytes_to_ulid_or_none, ulid_at_time as ulid_at_time, ulid_hex as ulid_hex, ulid_now as ulid_now, ulid_to_bytes as ulid_to_bytes, ulid_to_bytes_or_none as ulid_to_bytes_or_none
 
-__all__ = ['ulid', 'ulid_hex', 'ulid_at_time', 'ulid_to_bytes', 'bytes_to_ulid', 'ulid_now', 'ulid_to_bytes_or_none', 'bytes_to_ulid_or_none']
+__all__ = ['bytes_to_ulid', 'bytes_to_ulid_or_none', 'ulid', 'ulid_at_time', 'ulid_hex', 'ulid_now', 'ulid_to_bytes', 'ulid_to_bytes_or_none']
 
 def ulid(timestamp: float | None = None) -> str: ...

homeassistant-stubs/util/yaml/__init__.pyi

@@ -4,4 +4,4 @@ from .input import UndefinedSubstitution as UndefinedSubstitution, extract_input
 from .loader import Secrets as Secrets, YamlTypeError as YamlTypeError, load_yaml as load_yaml, load_yaml_dict as load_yaml_dict, parse_yaml as parse_yaml, secret_yaml as secret_yaml
 from .objects import Input as Input
 
-__all__ = ['SECRET_YAML', 'Input', 'dump', 'save_yaml', 'Secrets', 'YamlTypeError', 'load_yaml', 'load_yaml_dict', 'secret_yaml', 'parse_yaml', 'UndefinedSubstitution', 'extract_inputs', 'substitute']
+__all__ = ['SECRET_YAML', 'Input', 'Secrets', 'UndefinedSubstitution', 'YamlTypeError', 'dump', 'extract_inputs', 'load_yaml', 'load_yaml_dict', 'parse_yaml', 'save_yaml', 'secret_yaml', 'substitute']

homeassistant-stubs/util/yaml/loader.pyi

@@ -7,7 +7,7 @@ from collections.abc import Callable as Callable, Iterator
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from io import StringIO
 from pathlib import Path
-from propcache import cached_property
+from propcache.api import cached_property
 from typing import Any, TextIO, overload
 from yaml import SafeLoader as FastestAvailableSafeLoader
 

{homeassistant_stubs-2025.1.3.dist-info → homeassistant_stubs-2025.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: homeassistant-stubs
-Version: 2025.1.3
+Version: 2025.2.0
 Summary: PEP 484 typing stubs for Home Assistant Core
 Project-URL: Homepage, https://github.com/KapJI/homeassistant-stubs
 Project-URL: Bug Tracker, https://github.com/KapJI/homeassistant-stubs/issues
@@ -13,12 +13,12 @@ Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Home Automation
 Classifier: Topic :: Software Development
 Classifier: Typing :: Typed
-Requires-Python: <3.14,>=3.12
-Requires-Dist: homeassistant==2025.1.3
+Requires-Python: <3.14,>=3.13
+Requires-Dist: homeassistant==2025.2.0
 Description-Content-Type: text/markdown
 
 [![CI](https://github.com/KapJI/homeassistant-stubs/actions/workflows/ci.yaml/badge.svg)](https://github.com/KapJI/homeassistant-stubs/actions/workflows/ci.yaml)