homeassistant-stubs 2025.2.5__py3-none-any.whl → 2025.3.0b1__py3-none-any.whl

homeassistant-stubs/config_entries.pyi

@@ -23,6 +23,7 @@ from .helpers.service_info.zeroconf import ZeroconfServiceInfo as ZeroconfServic
 from .helpers.typing import ConfigType as ConfigType, DiscoveryInfoType as DiscoveryInfoType, UNDEFINED as UNDEFINED, UndefinedType as UndefinedType
 from .loader import async_suggest_report_issue as async_suggest_report_issue
 from .setup import DATA_SETUP_DONE as DATA_SETUP_DONE, SetupPhases as SetupPhases, async_pause_setup as async_pause_setup, async_process_deps_reqs as async_process_deps_reqs, async_setup_component as async_setup_component, async_start_setup as async_start_setup
+from .util import ulid as ulid_util
 from .util.async_ import create_eager_task as create_eager_task
 from .util.decorator import Registry as Registry
 from .util.dt import utc_from_timestamp as utc_from_timestamp, utcnow as utcnow
@@ -31,12 +32,13 @@ from _typeshed import Incomplete
 from collections import UserDict, defaultdict
 from collections.abc import Callable, Coroutine, Generator, Iterable, Mapping, ValuesView
 from contextvars import ContextVar
+from dataclasses import dataclass, field
 from datetime import datetime
 from enum import Enum, StrEnum
 from functools import cache
 from propcache.api import cached_property
 from types import MappingProxyType
-from typing import Any, Self
+from typing import Any, Self, TypedDict
 
 _LOGGER: Incomplete
 SOURCE_BLUETOOTH: str
@@ -73,6 +75,7 @@ class ConfigEntryState(Enum):
     NOT_LOADED = ('not_loaded', True)
     FAILED_UNLOAD = ('failed_unload', False)
     SETUP_IN_PROGRESS = ('setup_in_progress', False)
+    UNLOAD_IN_PROGRESS = ('unload_in_progress', False)
     _recoverable: bool
     def __new__(cls, value: str, recoverable: bool) -> Self: ...
     @property
@@ -109,6 +112,7 @@ CONN_CLASS_UNKNOWN: str
 
 class ConfigError(HomeAssistantError): ...
 class UnknownEntry(ConfigError): ...
+class UnknownSubEntry(ConfigError): ...
 class OperationNotAllowed(ConfigError): ...
 type UpdateListenerType = Callable[[HomeAssistant, ConfigEntry], Coroutine[Any, Any, None]]
 
@@ -128,10 +132,36 @@ class ConfigFlowContext(FlowContext, total=False):
 class ConfigFlowResult(FlowResult[ConfigFlowContext, str], total=False):
     minor_version: int
     options: Mapping[str, Any]
+    subentries: Iterable[ConfigSubentryData]
     version: int
 
 def _validate_item(*, disabled_by: ConfigEntryDisabler | Any | None = None) -> None: ...
 
+class ConfigSubentryData(TypedDict):
+    data: Mapping[str, Any]
+    subentry_type: str
+    title: str
+    unique_id: str | None
+
+class ConfigSubentryDataWithId(ConfigSubentryData):
+    subentry_id: str
+
+class SubentryFlowContext(FlowContext, total=False):
+    entry_id: str
+    subentry_id: str
+
+class SubentryFlowResult(FlowResult[SubentryFlowContext, tuple[str, str]], total=False):
+    unique_id: str | None
+
+@dataclass(frozen=True, kw_only=True)
+class ConfigSubentry:
+    data: MappingProxyType[str, Any]
+    subentry_id: str = field(default_factory=ulid_util.ulid_now)
+    subentry_type: str
+    title: str
+    unique_id: str | None
+    def as_dict(self) -> ConfigSubentryDataWithId: ...
+
 class ConfigEntry[_DataT = Any]:
     entry_id: str
     domain: str
@@ -139,6 +169,7 @@ class ConfigEntry[_DataT = Any]:
     data: MappingProxyType[str, Any]
     runtime_data: _DataT
     options: MappingProxyType[str, Any]
+    subentries: MappingProxyType[str, ConfigSubentry]
     unique_id: str | None
     state: ConfigEntryState
     reason: str | None
@@ -154,9 +185,11 @@ class ConfigEntry[_DataT = Any]:
     supports_remove_device: bool | None
     _supports_options: bool | None
     _supports_reconfigure: bool | None
+    _supported_subentry_types: dict[str, dict[str, bool]] | None
     update_listeners: list[UpdateListenerType]
     _async_cancel_retry_setup: Callable[[], Any] | None
     _on_unload: list[Callable[[], Coroutine[Any, Any, None] | None]] | None
+    _on_state_change: list[CALLBACK_TYPE] | None
     setup_lock: asyncio.Lock
     _reauth_lock: asyncio.Lock
     _tasks: set[asyncio.Future[Any]]
@@ -166,13 +199,15 @@ class ConfigEntry[_DataT = Any]:
     created_at: datetime
     modified_at: datetime
     discovery_keys: MappingProxyType[str, tuple[DiscoveryKey, ...]]
-    def __init__(self, *, created_at: datetime | None = None, data: Mapping[str, Any], disabled_by: ConfigEntryDisabler | None = None, discovery_keys: MappingProxyType[str, tuple[DiscoveryKey, ...]], domain: str, entry_id: str | None = None, minor_version: int, modified_at: datetime | None = None, options: Mapping[str, Any] | None, pref_disable_new_entities: bool | None = None, pref_disable_polling: bool | None = None, source: str, state: ConfigEntryState = ..., title: str, unique_id: str | None, version: int) -> None: ...
+    def __init__(self, *, created_at: datetime | None = None, data: Mapping[str, Any], disabled_by: ConfigEntryDisabler | None = None, discovery_keys: MappingProxyType[str, tuple[DiscoveryKey, ...]], domain: str, entry_id: str | None = None, minor_version: int, modified_at: datetime | None = None, options: Mapping[str, Any] | None, pref_disable_new_entities: bool | None = None, pref_disable_polling: bool | None = None, source: str, state: ConfigEntryState = ..., subentries_data: Iterable[ConfigSubentryData | ConfigSubentryDataWithId] | None, title: str, unique_id: str | None, version: int) -> None: ...
     def __repr__(self) -> str: ...
     def __setattr__(self, key: str, value: Any) -> None: ...
     @property
     def supports_options(self) -> bool: ...
     @property
     def supports_reconfigure(self) -> bool: ...
+    @property
+    def supported_subentry_types(self) -> dict[str, dict[str, bool]]: ...
     def clear_state_cache(self) -> None: ...
     @cached_property
     def as_json_fragment(self) -> json_fragment: ...
@@ -199,6 +234,9 @@ class ConfigEntry[_DataT = Any]:
     def async_on_unload(self, func: Callable[[], Coroutine[Any, Any, None] | None]) -> None: ...
     async def _async_process_on_unload(self, hass: HomeAssistant) -> None: ...
     @callback
+    def async_on_state_change(self, func: CALLBACK_TYPE) -> CALLBACK_TYPE: ...
+    def _async_process_on_state_change(self) -> None: ...
+    @callback
     def async_start_reauth(self, hass: HomeAssistant, context: ConfigFlowContext | None = None, data: dict[str, Any] | None = None) -> None: ...
     async def _async_init_reauth(self, hass: HomeAssistant, context: ConfigFlowContext | None = None, data: dict[str, Any] | None = None) -> None: ...
     @callback
@@ -263,6 +301,7 @@ class ConfigEntries:
     hass: Incomplete
     flow: Incomplete
     options: Incomplete
+    subentries: Incomplete
     _hass_config: Incomplete
     _entries: Incomplete
     _store: Incomplete
@@ -300,6 +339,17 @@ class ConfigEntries:
     @callback
     def async_update_entry(self, entry: ConfigEntry, *, data: Mapping[str, Any] | UndefinedType = ..., discovery_keys: MappingProxyType[str, tuple[DiscoveryKey, ...]] | UndefinedType = ..., minor_version: int | UndefinedType = ..., options: Mapping[str, Any] | UndefinedType = ..., pref_disable_new_entities: bool | UndefinedType = ..., pref_disable_polling: bool | UndefinedType = ..., title: str | UndefinedType = ..., unique_id: str | None | UndefinedType = ..., version: int | UndefinedType = ...) -> bool: ...
     @callback
+    def _async_update_entry(self, entry: ConfigEntry, *, data: Mapping[str, Any] | UndefinedType = ..., discovery_keys: MappingProxyType[str, tuple[DiscoveryKey, ...]] | UndefinedType = ..., minor_version: int | UndefinedType = ..., options: Mapping[str, Any] | UndefinedType = ..., pref_disable_new_entities: bool | UndefinedType = ..., pref_disable_polling: bool | UndefinedType = ..., subentries: dict[str, ConfigSubentry] | UndefinedType = ..., title: str | UndefinedType = ..., unique_id: str | None | UndefinedType = ..., version: int | UndefinedType = ...) -> bool: ...
+    @callback
+    def _async_save_and_notify(self, entry: ConfigEntry) -> None: ...
+    @callback
+    def async_add_subentry(self, entry: ConfigEntry, subentry: ConfigSubentry) -> bool: ...
+    @callback
+    def async_remove_subentry(self, entry: ConfigEntry, subentry_id: str) -> bool: ...
+    @callback
+    def async_update_subentry(self, entry: ConfigEntry, subentry: ConfigSubentry, *, data: Mapping[str, Any] | UndefinedType = ..., title: str | UndefinedType = ..., unique_id: str | None | UndefinedType = ...) -> bool: ...
+    def _raise_if_subentry_unique_id_exists(self, entry: ConfigEntry, unique_id: str | None) -> None: ...
+    @callback
     def _async_dispatch(self, change_type: ConfigEntryChange, entry: ConfigEntry) -> None: ...
     async def async_forward_entry_setups(self, entry: ConfigEntry, platforms: Iterable[Platform | str]) -> None: ...
     async def _async_forward_entry_setups_locked(self, entry: ConfigEntry, platforms: Iterable[Platform | str]) -> None: ...
@@ -331,6 +381,9 @@ class ConfigFlow(ConfigEntryBaseFlow):
     @classmethod
     @callback
     def async_supports_options_flow(cls, config_entry: ConfigEntry) -> bool: ...
+    @classmethod
+    @callback
+    def async_get_supported_subentry_types(cls, config_entry: ConfigEntry) -> dict[str, type[ConfigSubentryFlow]]: ...
     @callback
     def _async_abort_entries_match(self, match_dict: dict[str, Any] | None = None) -> None: ...
     @callback
@@ -363,7 +416,7 @@ class ConfigFlow(ConfigEntryBaseFlow):
     async def async_step_usb(self, discovery_info: UsbServiceInfo) -> ConfigFlowResult: ...
     async def async_step_zeroconf(self, discovery_info: ZeroconfServiceInfo) -> ConfigFlowResult: ...
     @callback
-    def async_create_entry(self, *, title: str, data: Mapping[str, Any], description: str | None = None, description_placeholders: Mapping[str, str] | None = None, options: Mapping[str, Any] | None = None) -> ConfigFlowResult: ...
+    def async_create_entry(self, *, title: str, data: Mapping[str, Any], description: str | None = None, description_placeholders: Mapping[str, str] | None = None, options: Mapping[str, Any] | None = None, subentries: Iterable[ConfigSubentryData] | None = None) -> ConfigFlowResult: ...
     @callback
     def async_update_reload_and_abort(self, entry: ConfigEntry, *, unique_id: str | None | UndefinedType = ..., title: str | UndefinedType = ..., data: Mapping[str, Any] | UndefinedType = ..., data_updates: Mapping[str, Any] | UndefinedType = ..., options: Mapping[str, Any] | UndefinedType = ..., reason: str | UndefinedType = ..., reload_even_if_entry_is_unchanged: bool = True) -> ConfigFlowResult: ...
     @callback
@@ -378,9 +431,33 @@ class ConfigFlow(ConfigEntryBaseFlow):
     @callback
     def _get_reconfigure_entry(self) -> ConfigEntry: ...
 
-class OptionsFlowManager(data_entry_flow.FlowManager[ConfigFlowContext, ConfigFlowResult]):
-    _flow_result = ConfigFlowResult
+class _ConfigSubFlowManager:
+    hass: HomeAssistant
     def _async_get_config_entry(self, config_entry_id: str) -> ConfigEntry: ...
+
+class ConfigSubentryFlowManager(data_entry_flow.FlowManager[SubentryFlowContext, SubentryFlowResult, tuple[str, str]], _ConfigSubFlowManager):
+    _flow_result = SubentryFlowResult
+    async def async_create_flow(self, handler_key: tuple[str, str], *, context: FlowContext | None = None, data: dict[str, Any] | None = None) -> ConfigSubentryFlow: ...
+    async def async_finish_flow(self, flow: data_entry_flow.FlowHandler[SubentryFlowContext, SubentryFlowResult, tuple[str, str]], result: SubentryFlowResult) -> SubentryFlowResult: ...
+
+class ConfigSubentryFlow(data_entry_flow.FlowHandler[SubentryFlowContext, SubentryFlowResult, tuple[str, str]]):
+    _flow_result = SubentryFlowResult
+    handler: tuple[str, str]
+    @callback
+    def async_create_entry(self, *, title: str | None = None, data: Mapping[str, Any], description: str | None = None, description_placeholders: Mapping[str, str] | None = None, unique_id: str | None = None) -> SubentryFlowResult: ...
+    @callback
+    def async_update_and_abort(self, entry: ConfigEntry, subentry: ConfigSubentry, *, unique_id: str | None | UndefinedType = ..., title: str | UndefinedType = ..., data: Mapping[str, Any] | UndefinedType = ..., data_updates: Mapping[str, Any] | UndefinedType = ...) -> SubentryFlowResult: ...
+    @property
+    def _reconfigure_entry_id(self) -> str: ...
+    @callback
+    def _get_reconfigure_entry(self) -> ConfigEntry: ...
+    @property
+    def _reconfigure_subentry_id(self) -> str: ...
+    @callback
+    def _get_reconfigure_subentry(self) -> ConfigSubentry: ...
+
+class OptionsFlowManager(data_entry_flow.FlowManager[ConfigFlowContext, ConfigFlowResult], _ConfigSubFlowManager):
+    _flow_result = ConfigFlowResult
     async def async_create_flow(self, handler_key: str, *, context: ConfigFlowContext | None = None, data: dict[str, Any] | None = None) -> OptionsFlow: ...
     async def async_finish_flow(self, flow: data_entry_flow.FlowHandler[ConfigFlowContext, ConfigFlowResult], result: ConfigFlowResult) -> ConfigFlowResult: ...
     async def _async_setup_preview(self, flow: data_entry_flow.FlowHandler[ConfigFlowContext, ConfigFlowResult]) -> None: ...

homeassistant-stubs/const.pyi

@@ -421,6 +421,11 @@ class UnitOfEnergy(StrEnum):
     MEGA_CALORIE = 'Mcal'
     GIGA_CALORIE = 'Gcal'
 
+class UnitOfEnergyDistance(StrEnum):
+    KILO_WATT_HOUR_PER_100_KM = 'kWh/100km'
+    MILES_PER_KILO_WATT_HOUR = 'mi/kWh'
+    KM_PER_KILO_WATT_HOUR = 'km/kWh'
+
 class UnitOfElectricCurrent(StrEnum):
     MILLIAMPERE = 'mA'
     AMPERE = 'A'

homeassistant-stubs/helpers/backup.pyi

@@ -0,0 +1,21 @@
+import asyncio
+from collections.abc import Callable as Callable
+from dataclasses import dataclass, field
+from homeassistant.components.backup import BackupManager as BackupManager, ManagerStateEvent as ManagerStateEvent
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.util.hass_dict import HassKey as HassKey
+
+DATA_BACKUP: HassKey[BackupData]
+DATA_MANAGER: HassKey[BackupManager]
+
+@dataclass(slots=True)
+class BackupData:
+    backup_event_subscriptions: list[Callable[[ManagerStateEvent], None]] = field(default_factory=list)
+    manager_ready: asyncio.Future[None] = field(default_factory=asyncio.Future)
+
+@callback
+def async_initialize_backup(hass: HomeAssistant) -> None: ...
+async def async_get_manager(hass: HomeAssistant) -> BackupManager: ...
+@callback
+def async_subscribe_events(hass: HomeAssistant, on_event: Callable[[ManagerStateEvent], None]) -> Callable[[], None]: ...

homeassistant-stubs/helpers/chat_session.pyi

@@ -0,0 +1,45 @@
+from .event import async_call_later as async_call_later
+from _typeshed import Incomplete
+from collections.abc import Generator
+from contextlib import contextmanager
+from contextvars import ContextVar
+from dataclasses import dataclass, field
+from datetime import datetime
+from homeassistant.const import EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_STOP
+from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, Event as Event, HassJob as HassJob, HassJobType as HassJobType, HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.util import dt as dt_util
+from homeassistant.util.hass_dict import HassKey as HassKey
+from homeassistant.util.ulid import ulid_now as ulid_now, ulid_to_bytes as ulid_to_bytes
+
+DATA_CHAT_SESSION: HassKey[dict[str, ChatSession]]
+DATA_CHAT_SESSION_CLEANUP: HassKey[SessionCleanup]
+CONVERSATION_TIMEOUT: Incomplete
+LOGGER: Incomplete
+current_session: ContextVar[ChatSession | None]
+
+@dataclass
+class ChatSession:
+    conversation_id: str
+    last_updated: datetime = field(default_factory=dt_util.utcnow)
+    _cleanup_callbacks: list[CALLBACK_TYPE] = field(default_factory=list)
+    @callback
+    def async_updated(self) -> None: ...
+    @callback
+    def async_on_cleanup(self, cb: CALLBACK_TYPE) -> None: ...
+    @callback
+    def async_cleanup(self) -> None: ...
+
+class SessionCleanup:
+    unsub: CALLBACK_TYPE | None
+    hass: Incomplete
+    cleanup_job: Incomplete
+    def __init__(self, hass: HomeAssistant) -> None: ...
+    @callback
+    def schedule(self) -> None: ...
+    @callback
+    def _on_hass_stop(self, event: Event) -> None: ...
+    @callback
+    def _cleanup(self, now: datetime) -> None: ...
+
+@contextmanager
+def async_get_chat_session(hass: HomeAssistant, conversation_id: str | None = None) -> Generator[ChatSession]: ...

homeassistant-stubs/helpers/data_entry_flow.pyi

@@ -5,7 +5,7 @@ from homeassistant.components.http import HomeAssistantView as HomeAssistantView
 from homeassistant.components.http.data_validator import RequestDataValidator as RequestDataValidator
 from typing import Any, Generic, TypeVar
 
-_FlowManagerT = TypeVar('_FlowManagerT', bound=data_entry_flow.FlowManager[Any, Any], default=data_entry_flow.FlowManager)
+_FlowManagerT = TypeVar('_FlowManagerT', bound=data_entry_flow.FlowManager[Any, Any, Any], default=data_entry_flow.FlowManager)
 
 class _BaseFlowManagerView(HomeAssistantView, Generic[_FlowManagerT]):
     _flow_mgr: Incomplete

homeassistant-stubs/helpers/deprecation.pyi

@@ -1,7 +1,7 @@
 import functools
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
-from enum import EnumType, IntEnum, IntFlag, StrEnum, _EnumDict
+from enum import EnumType, IntEnum as IntEnum, IntFlag as IntFlag, StrEnum as StrEnum, _EnumDict
 from typing import Any, NamedTuple
 
 def deprecated_substitute[_ObjectT: object](substitute_name: str) -> Callable[[Callable[[_ObjectT], Any]], Callable[[_ObjectT], Any]]: ...
@@ -12,27 +12,27 @@ def _print_deprecation_warning(obj: Any, replacement: str, description: str, ver
 def _print_deprecation_warning_internal(obj_name: str, module_name: str, replacement: str, description: str, verb: str, breaks_in_ha_version: str | None, *, log_when_no_integration_is_found: bool) -> None: ...
 def _print_deprecation_warning_internal_impl(obj_name: str, module_name: str, replacement: str, description: str, verb: str, breaks_in_ha_version: str | None, *, log_when_no_integration_is_found: bool) -> None: ...
 
-class DeprecatedConstant(NamedTuple):
-    value: Any
+class DeprecatedConstant[T](NamedTuple):
+    value: T
     replacement: str
     breaks_in_ha_version: str | None
 
-class DeprecatedConstantEnum(NamedTuple):
-    enum: StrEnum | IntEnum | IntFlag
+class DeprecatedConstantEnum[T: StrEnum | IntEnum | IntFlag](NamedTuple):
+    enum: T
     breaks_in_ha_version: str | None
 
-class DeprecatedAlias(NamedTuple):
-    value: Any
+class DeprecatedAlias[T](NamedTuple):
+    value: T
     replacement: str
     breaks_in_ha_version: str | None
 
-class DeferredDeprecatedAlias:
+class DeferredDeprecatedAlias[T]:
     breaks_in_ha_version: Incomplete
     replacement: Incomplete
     _value_fn: Incomplete
-    def __init__(self, value_fn: Callable[[], Any], replacement: str, breaks_in_ha_version: str | None) -> None: ...
+    def __init__(self, value_fn: Callable[[], T], replacement: str, breaks_in_ha_version: str | None) -> None: ...
     @functools.cached_property
-    def value(self) -> Any: ...
+    def value(self) -> T: ...
 
 _PREFIX_DEPRECATED: str
 

homeassistant-stubs/helpers/device_registry.pyi

@@ -6,7 +6,7 @@ from .registry import BaseRegistry as BaseRegistry, BaseRegistryItems as BaseReg
 from .singleton import singleton as singleton
 from .typing import UNDEFINED as UNDEFINED, UndefinedType as UndefinedType
 from _typeshed import Incomplete
-from collections.abc import Mapping
+from collections.abc import Iterable, Mapping
 from datetime import datetime
 from enum import StrEnum
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
@@ -103,6 +103,7 @@ def _validate_configuration_url(value: Any) -> str | None: ...
 class DeviceEntry:
     area_id: str | None
     config_entries: set[str]
+    config_entries_subentries: dict[str, set[str | None]]
     configuration_url: str | None
     connections: set[tuple[str, str]]
     created_at: datetime
@@ -133,7 +134,7 @@ class DeviceEntry:
     def json_repr(self) -> bytes | None: ...
     @under_cached_property
     def as_storage_fragment(self) -> json_fragment: ...
-    def __init__(self, area_id, config_entries, configuration_url, connections, created_at, disabled_by, entry_type, hw_version, id, identifiers, labels, manufacturer, model, model_id, modified_at, name_by_user, name, primary_config_entry, serial_number, suggested_area, sw_version, via_device_id, is_new, cache) -> None: ...
+    def __init__(self, area_id, config_entries, config_entries_subentries, configuration_url, connections, created_at, disabled_by, entry_type, hw_version, id, identifiers, labels, manufacturer, model, model_id, modified_at, name_by_user, name, primary_config_entry, serial_number, suggested_area, sw_version, via_device_id, is_new, cache) -> None: ...
     def __lt__(self, other): ...
     def __le__(self, other): ...
     def __gt__(self, other): ...
@@ -141,6 +142,7 @@ class DeviceEntry:
 
 class DeletedDeviceEntry:
     config_entries: set[str]
+    config_entries_subentries: dict[str, set[str | None]]
     connections: set[tuple[str, str]]
     identifiers: set[tuple[str, str]]
     id: str
@@ -148,10 +150,10 @@ class DeletedDeviceEntry:
     created_at: datetime
     modified_at: datetime
     _cache: dict[str, Any]
-    def to_device_entry(self, config_entry_id: str, connections: set[tuple[str, str]], identifiers: set[tuple[str, str]]) -> DeviceEntry: ...
+    def to_device_entry(self, config_entry_id: str, config_subentry_id: str | None, connections: set[tuple[str, str]], identifiers: set[tuple[str, str]]) -> DeviceEntry: ...
     @under_cached_property
     def as_storage_fragment(self) -> json_fragment: ...
-    def __init__(self, config_entries, connections, identifiers, id, orphaned_timestamp, created_at, modified_at, cache) -> None: ...
+    def __init__(self, config_entries, config_entries_subentries, connections, identifiers, id, orphaned_timestamp, created_at, modified_at, cache) -> None: ...
     def __lt__(self, other): ...
     def __le__(self, other): ...
     def __gt__(self, other): ...
@@ -169,6 +171,7 @@ class DeviceRegistryItems[_EntryTypeT: (DeviceEntry, DeletedDeviceEntry)](BaseRe
     def _index_entry(self, key: str, entry: _EntryTypeT) -> None: ...
     def _unindex_entry(self, key: str, replacement_entry: _EntryTypeT | None = None) -> None: ...
     def get_entry(self, identifiers: set[tuple[str, str]] | None, connections: set[tuple[str, str]] | None) -> _EntryTypeT | None: ...
+    def get_entries(self, identifiers: set[tuple[str, str]] | None, connections: set[tuple[str, str]] | None) -> Iterable[_EntryTypeT]: ...
 
 class ActiveDeviceRegistryItems(DeviceRegistryItems[DeviceEntry]):
     _area_id_index: RegistryIndexType
@@ -193,11 +196,12 @@ class DeviceRegistry(BaseRegistry[dict[str, list[dict[str, Any]]]]):
     @callback
     def async_get_device(self, identifiers: set[tuple[str, str]] | None = None, connections: set[tuple[str, str]] | None = None) -> DeviceEntry | None: ...
     def _async_get_deleted_device(self, identifiers: set[tuple[str, str]], connections: set[tuple[str, str]]) -> DeletedDeviceEntry | None: ...
+    def _async_get_deleted_devices(self, identifiers: set[tuple[str, str]] | None = None, connections: set[tuple[str, str]] | None = None) -> Iterable[DeletedDeviceEntry]: ...
     def _substitute_name_placeholders(self, domain: str, name: str, translation_placeholders: Mapping[str, str]) -> str: ...
     @callback
-    def async_get_or_create(self, *, config_entry_id: str, configuration_url: str | URL | None | UndefinedType = ..., connections: set[tuple[str, str]] | None | UndefinedType = ..., created_at: str | datetime | UndefinedType = ..., default_manufacturer: str | None | UndefinedType = ..., default_model: str | None | UndefinedType = ..., default_name: str | None | UndefinedType = ..., disabled_by: DeviceEntryDisabler | None | UndefinedType = ..., entry_type: DeviceEntryType | None | UndefinedType = ..., hw_version: str | None | UndefinedType = ..., identifiers: set[tuple[str, str]] | None | UndefinedType = ..., manufacturer: str | None | UndefinedType = ..., model: str | None | UndefinedType = ..., model_id: str | None | UndefinedType = ..., modified_at: str | datetime | UndefinedType = ..., name: str | None | UndefinedType = ..., serial_number: str | None | UndefinedType = ..., suggested_area: str | None | UndefinedType = ..., sw_version: str | None | UndefinedType = ..., translation_key: str | None = None, translation_placeholders: Mapping[str, str] | None = None, via_device: tuple[str, str] | None | UndefinedType = ...) -> DeviceEntry: ...
+    def async_get_or_create(self, *, config_entry_id: str, config_subentry_id: str | None | UndefinedType = ..., configuration_url: str | URL | None | UndefinedType = ..., connections: set[tuple[str, str]] | None | UndefinedType = ..., created_at: str | datetime | UndefinedType = ..., default_manufacturer: str | None | UndefinedType = ..., default_model: str | None | UndefinedType = ..., default_name: str | None | UndefinedType = ..., disabled_by: DeviceEntryDisabler | None | UndefinedType = ..., entry_type: DeviceEntryType | None | UndefinedType = ..., hw_version: str | None | UndefinedType = ..., identifiers: set[tuple[str, str]] | None | UndefinedType = ..., manufacturer: str | None | UndefinedType = ..., model: str | None | UndefinedType = ..., model_id: str | None | UndefinedType = ..., modified_at: str | datetime | UndefinedType = ..., name: str | None | UndefinedType = ..., serial_number: str | None | UndefinedType = ..., suggested_area: str | None | UndefinedType = ..., sw_version: str | None | UndefinedType = ..., translation_key: str | None = None, translation_placeholders: Mapping[str, str] | None = None, via_device: tuple[str, str] | None | UndefinedType = ...) -> DeviceEntry: ...
     @callback
-    def async_update_device(self, device_id: str, *, add_config_entry_id: str | UndefinedType = ..., allow_collisions: bool = False, area_id: str | None | UndefinedType = ..., configuration_url: str | URL | None | UndefinedType = ..., device_info_type: str | UndefinedType = ..., disabled_by: DeviceEntryDisabler | None | UndefinedType = ..., entry_type: DeviceEntryType | None | UndefinedType = ..., hw_version: str | None | UndefinedType = ..., labels: set[str] | UndefinedType = ..., manufacturer: str | None | UndefinedType = ..., merge_connections: set[tuple[str, str]] | UndefinedType = ..., merge_identifiers: set[tuple[str, str]] | UndefinedType = ..., model: str | None | UndefinedType = ..., model_id: str | None | UndefinedType = ..., name_by_user: str | None | UndefinedType = ..., name: str | None | UndefinedType = ..., new_connections: set[tuple[str, str]] | UndefinedType = ..., new_identifiers: set[tuple[str, str]] | UndefinedType = ..., remove_config_entry_id: str | UndefinedType = ..., serial_number: str | None | UndefinedType = ..., suggested_area: str | None | UndefinedType = ..., sw_version: str | None | UndefinedType = ..., via_device_id: str | None | UndefinedType = ...) -> DeviceEntry | None: ...
+    def async_update_device(self, device_id: str, *, add_config_entry_id: str | UndefinedType = ..., add_config_subentry_id: str | None | UndefinedType = ..., allow_collisions: bool = False, area_id: str | None | UndefinedType = ..., configuration_url: str | URL | None | UndefinedType = ..., device_info_type: str | UndefinedType = ..., disabled_by: DeviceEntryDisabler | None | UndefinedType = ..., entry_type: DeviceEntryType | None | UndefinedType = ..., hw_version: str | None | UndefinedType = ..., labels: set[str] | UndefinedType = ..., manufacturer: str | None | UndefinedType = ..., merge_connections: set[tuple[str, str]] | UndefinedType = ..., merge_identifiers: set[tuple[str, str]] | UndefinedType = ..., model: str | None | UndefinedType = ..., model_id: str | None | UndefinedType = ..., name_by_user: str | None | UndefinedType = ..., name: str | None | UndefinedType = ..., new_connections: set[tuple[str, str]] | UndefinedType = ..., new_identifiers: set[tuple[str, str]] | UndefinedType = ..., remove_config_entry_id: str | UndefinedType = ..., remove_config_subentry_id: str | None | UndefinedType = ..., serial_number: str | None | UndefinedType = ..., suggested_area: str | None | UndefinedType = ..., sw_version: str | None | UndefinedType = ..., via_device_id: str | None | UndefinedType = ...) -> DeviceEntry | None: ...
     @callback
     def _validate_connections(self, device_id: str, connections: set[tuple[str, str]], allow_collisions: bool) -> set[tuple[str, str]]: ...
     @callback
@@ -210,6 +214,8 @@ class DeviceRegistry(BaseRegistry[dict[str, list[dict[str, Any]]]]):
     @callback
     def async_clear_config_entry(self, config_entry_id: str) -> None: ...
     @callback
+    def async_clear_config_subentry(self, config_entry_id: str, config_subentry_id: str) -> None: ...
+    @callback
     def async_purge_expired_orphaned_devices(self) -> None: ...
     @callback
     def async_clear_area_id(self, area_id: str) -> None: ...

homeassistant-stubs/helpers/entity_platform.pyi

@@ -34,10 +34,13 @@ _LOGGER: Incomplete
 class AddEntitiesCallback(Protocol):
     def __call__(self, new_entities: Iterable[Entity], update_before_add: bool = False) -> None: ...
 
+class AddConfigEntryEntitiesCallback(Protocol):
+    def __call__(self, new_entities: Iterable[Entity], update_before_add: bool = False, *, config_subentry_id: str | None = None) -> None: ...
+
 class EntityPlatformModule(Protocol):
     async def async_setup_platform(self, hass: HomeAssistant, config: ConfigType, async_add_entities: AddEntitiesCallback, discovery_info: DiscoveryInfoType | None = None) -> None: ...
     def setup_platform(self, hass: HomeAssistant, config: ConfigType, add_entities: AddEntitiesCallback, discovery_info: DiscoveryInfoType | None = None) -> None: ...
-    async def async_setup_entry(self, hass: HomeAssistant, entry: config_entries.ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+    async def async_setup_entry(self, hass: HomeAssistant, entry: config_entries.ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
 class EntityPlatform:
     hass: Incomplete
@@ -82,15 +85,15 @@ class EntityPlatform:
     @callback
     def _async_schedule_add_entities(self, new_entities: Iterable[Entity], update_before_add: bool = False) -> None: ...
     @callback
-    def _async_schedule_add_entities_for_entry(self, new_entities: Iterable[Entity], update_before_add: bool = False) -> None: ...
+    def _async_schedule_add_entities_for_entry(self, new_entities: Iterable[Entity], update_before_add: bool = False, *, config_subentry_id: str | None = None) -> None: ...
     def add_entities(self, new_entities: Iterable[Entity], update_before_add: bool = False) -> None: ...
     async def _async_add_and_update_entities(self, coros: list[Coroutine[Any, Any, None]], entities: list[Entity], timeout: float) -> None: ...
     async def _async_add_entities(self, coros: list[Coroutine[Any, Any, None]], entities: list[Entity], timeout: float) -> None: ...
-    async def async_add_entities(self, new_entities: Iterable[Entity], update_before_add: bool = False) -> None: ...
+    async def async_add_entities(self, new_entities: Iterable[Entity], update_before_add: bool = False, *, config_subentry_id: str | None = None) -> None: ...
     @callback
     def _async_handle_interval_callback(self) -> None: ...
     def _entity_id_already_exists(self, entity_id: str) -> tuple[bool, bool]: ...
-    async def _async_add_entity(self, entity: Entity, update_before_add: bool, entity_registry: EntityRegistry) -> None: ...
+    async def _async_add_entity(self, entity: Entity, update_before_add: bool, entity_registry: EntityRegistry, config_subentry_id: str | None) -> None: ...
     async def async_reset(self) -> None: ...
     @callback
     def async_unsub_polling(self) -> None: ...

homeassistant-stubs/helpers/entity_registry.pyi

@@ -72,6 +72,7 @@ class RegistryEntry:
     categories: dict[str, str]
     capabilities: Mapping[str, Any] | None
     config_entry_id: str | None
+    config_subentry_id: str | None
     created_at: datetime
     device_class: str | None
     device_id: str | None
@@ -113,7 +114,7 @@ class RegistryEntry:
     def as_storage_fragment(self) -> json_fragment: ...
     @callback
     def write_unavailable_state(self, hass: HomeAssistant) -> None: ...
-    def __init__(self, entity_id, unique_id, platform, previous_unique_id, aliases, area_id, categories, capabilities, config_entry_id, created_at, device_class, device_id, domain, disabled_by, entity_category, hidden_by, icon, id, has_entity_name, labels, modified_at, name, options, original_device_class, original_icon, original_name, supported_features, translation_key, unit_of_measurement, cache) -> None: ...
+    def __init__(self, entity_id, unique_id, platform, previous_unique_id, aliases, area_id, categories, capabilities, config_entry_id, config_subentry_id, created_at, device_class, device_id, domain, disabled_by, entity_category, hidden_by, icon, id, has_entity_name, labels, modified_at, name, options, original_device_class, original_icon, original_name, supported_features, translation_key, unit_of_measurement, cache) -> None: ...
     def __lt__(self, other): ...
     def __le__(self, other): ...
     def __gt__(self, other): ...
@@ -124,6 +125,7 @@ class DeletedRegistryEntry:
     unique_id: str
     platform: str
     config_entry_id: str | None
+    config_subentry_id: str | None
     domain: str
     id: str
     orphaned_timestamp: float | None
@@ -134,7 +136,7 @@ class DeletedRegistryEntry:
     def _domain_default(self) -> str: ...
     @under_cached_property
     def as_storage_fragment(self) -> json_fragment: ...
-    def __init__(self, entity_id, unique_id, platform, config_entry_id, domain, id, orphaned_timestamp, created_at, modified_at, cache) -> None: ...
+    def __init__(self, entity_id, unique_id, platform, config_entry_id, config_subentry_id, domain, id, orphaned_timestamp, created_at, modified_at, cache) -> None: ...
     def __lt__(self, other): ...
     def __le__(self, other): ...
     def __gt__(self, other): ...
@@ -161,7 +163,7 @@ class EntityRegistryItems(BaseRegistryItems[RegistryEntry]):
     def get_entries_for_area_id(self, area_id: str) -> list[RegistryEntry]: ...
     def get_entries_for_label(self, label: str) -> list[RegistryEntry]: ...
 
-def _validate_item(hass: HomeAssistant, domain: str, platform: str, *, config_entry_id: str | None | UndefinedType = None, device_id: str | None | UndefinedType = None, disabled_by: RegistryEntryDisabler | None | UndefinedType = None, entity_category: EntityCategory | None | UndefinedType = None, hidden_by: RegistryEntryHider | None | UndefinedType = None, report_non_string_unique_id: bool = True, unique_id: str | Hashable | UndefinedType | Any) -> None: ...
+def _validate_item(hass: HomeAssistant, domain: str, platform: str, *, config_entry_id: str | None | UndefinedType = None, config_subentry_id: str | None | UndefinedType = None, device_id: str | None | UndefinedType = None, disabled_by: RegistryEntryDisabler | None | UndefinedType = None, entity_category: EntityCategory | None | UndefinedType = None, hidden_by: RegistryEntryHider | None | UndefinedType = None, old_config_subentry_id: str | None = None, report_non_string_unique_id: bool = True, unique_id: str | Hashable | UndefinedType | Any) -> None: ...
 
 class EntityRegistry(BaseRegistry):
     deleted_entities: dict[tuple[str, str, str], DeletedRegistryEntry]
@@ -182,17 +184,17 @@ class EntityRegistry(BaseRegistry):
     @callback
     def async_generate_entity_id(self, domain: str, suggested_object_id: str, known_object_ids: Container[str] | None = None) -> str: ...
     @callback
-    def async_get_or_create(self, domain: str, platform: str, unique_id: str, *, known_object_ids: Container[str] | None = None, suggested_object_id: str | None = None, disabled_by: RegistryEntryDisabler | None = None, hidden_by: RegistryEntryHider | None = None, get_initial_options: Callable[[], EntityOptionsType | None] | None = None, capabilities: Mapping[str, Any] | None | UndefinedType = ..., config_entry: ConfigEntry | None | UndefinedType = ..., device_id: str | None | UndefinedType = ..., entity_category: EntityCategory | UndefinedType | None = ..., has_entity_name: bool | UndefinedType = ..., original_device_class: str | None | UndefinedType = ..., original_icon: str | None | UndefinedType = ..., original_name: str | None | UndefinedType = ..., supported_features: int | None | UndefinedType = ..., translation_key: str | None | UndefinedType = ..., unit_of_measurement: str | None | UndefinedType = ...) -> RegistryEntry: ...
+    def async_get_or_create(self, domain: str, platform: str, unique_id: str, *, known_object_ids: Container[str] | None = None, suggested_object_id: str | None = None, disabled_by: RegistryEntryDisabler | None = None, hidden_by: RegistryEntryHider | None = None, get_initial_options: Callable[[], EntityOptionsType | None] | None = None, capabilities: Mapping[str, Any] | None | UndefinedType = ..., config_entry: ConfigEntry | None | UndefinedType = ..., config_subentry_id: str | None | UndefinedType = ..., device_id: str | None | UndefinedType = ..., entity_category: EntityCategory | UndefinedType | None = ..., has_entity_name: bool | UndefinedType = ..., original_device_class: str | None | UndefinedType = ..., original_icon: str | None | UndefinedType = ..., original_name: str | None | UndefinedType = ..., supported_features: int | None | UndefinedType = ..., translation_key: str | None | UndefinedType = ..., unit_of_measurement: str | None | UndefinedType = ...) -> RegistryEntry: ...
     @callback
     def async_remove(self, entity_id: str) -> None: ...
     @callback
     def async_device_modified(self, event: Event[EventDeviceRegistryUpdatedData]) -> None: ...
     @callback
-    def _async_update_entity(self, entity_id: str, *, aliases: set[str] | UndefinedType = ..., area_id: str | None | UndefinedType = ..., categories: dict[str, str] | UndefinedType = ..., capabilities: Mapping[str, Any] | None | UndefinedType = ..., config_entry_id: str | None | UndefinedType = ..., device_class: str | None | UndefinedType = ..., device_id: str | None | UndefinedType = ..., disabled_by: RegistryEntryDisabler | None | UndefinedType = ..., entity_category: EntityCategory | None | UndefinedType = ..., hidden_by: RegistryEntryHider | None | UndefinedType = ..., icon: str | None | UndefinedType = ..., has_entity_name: bool | UndefinedType = ..., labels: set[str] | UndefinedType = ..., name: str | None | UndefinedType = ..., new_entity_id: str | UndefinedType = ..., new_unique_id: str | UndefinedType = ..., options: EntityOptionsType | UndefinedType = ..., original_device_class: str | None | UndefinedType = ..., original_icon: str | None | UndefinedType = ..., original_name: str | None | UndefinedType = ..., platform: str | None | UndefinedType = ..., supported_features: int | UndefinedType = ..., translation_key: str | None | UndefinedType = ..., unit_of_measurement: str | None | UndefinedType = ...) -> RegistryEntry: ...
+    def _async_update_entity(self, entity_id: str, *, aliases: set[str] | UndefinedType = ..., area_id: str | None | UndefinedType = ..., categories: dict[str, str] | UndefinedType = ..., capabilities: Mapping[str, Any] | None | UndefinedType = ..., config_entry_id: str | None | UndefinedType = ..., config_subentry_id: str | None | UndefinedType = ..., device_class: str | None | UndefinedType = ..., device_id: str | None | UndefinedType = ..., disabled_by: RegistryEntryDisabler | None | UndefinedType = ..., entity_category: EntityCategory | None | UndefinedType = ..., hidden_by: RegistryEntryHider | None | UndefinedType = ..., icon: str | None | UndefinedType = ..., has_entity_name: bool | UndefinedType = ..., labels: set[str] | UndefinedType = ..., name: str | None | UndefinedType = ..., new_entity_id: str | UndefinedType = ..., new_unique_id: str | UndefinedType = ..., options: EntityOptionsType | UndefinedType = ..., original_device_class: str | None | UndefinedType = ..., original_icon: str | None | UndefinedType = ..., original_name: str | None | UndefinedType = ..., platform: str | None | UndefinedType = ..., supported_features: int | UndefinedType = ..., translation_key: str | None | UndefinedType = ..., unit_of_measurement: str | None | UndefinedType = ...) -> RegistryEntry: ...
     @callback
-    def async_update_entity(self, entity_id: str, *, aliases: set[str] | UndefinedType = ..., area_id: str | None | UndefinedType = ..., categories: dict[str, str] | UndefinedType = ..., capabilities: Mapping[str, Any] | None | UndefinedType = ..., config_entry_id: str | None | UndefinedType = ..., device_class: str | None | UndefinedType = ..., device_id: str | None | UndefinedType = ..., disabled_by: RegistryEntryDisabler | None | UndefinedType = ..., entity_category: EntityCategory | None | UndefinedType = ..., hidden_by: RegistryEntryHider | None | UndefinedType = ..., icon: str | None | UndefinedType = ..., has_entity_name: bool | UndefinedType = ..., labels: set[str] | UndefinedType = ..., name: str | None | UndefinedType = ..., new_entity_id: str | UndefinedType = ..., new_unique_id: str | UndefinedType = ..., original_device_class: str | None | UndefinedType = ..., original_icon: str | None | UndefinedType = ..., original_name: str | None | UndefinedType = ..., supported_features: int | UndefinedType = ..., translation_key: str | None | UndefinedType = ..., unit_of_measurement: str | None | UndefinedType = ...) -> RegistryEntry: ...
+    def async_update_entity(self, entity_id: str, *, aliases: set[str] | UndefinedType = ..., area_id: str | None | UndefinedType = ..., categories: dict[str, str] | UndefinedType = ..., capabilities: Mapping[str, Any] | None | UndefinedType = ..., config_entry_id: str | None | UndefinedType = ..., config_subentry_id: str | None | UndefinedType = ..., device_class: str | None | UndefinedType = ..., device_id: str | None | UndefinedType = ..., disabled_by: RegistryEntryDisabler | None | UndefinedType = ..., entity_category: EntityCategory | None | UndefinedType = ..., hidden_by: RegistryEntryHider | None | UndefinedType = ..., icon: str | None | UndefinedType = ..., has_entity_name: bool | UndefinedType = ..., labels: set[str] | UndefinedType = ..., name: str | None | UndefinedType = ..., new_entity_id: str | UndefinedType = ..., new_unique_id: str | UndefinedType = ..., original_device_class: str | None | UndefinedType = ..., original_icon: str | None | UndefinedType = ..., original_name: str | None | UndefinedType = ..., supported_features: int | UndefinedType = ..., translation_key: str | None | UndefinedType = ..., unit_of_measurement: str | None | UndefinedType = ...) -> RegistryEntry: ...
     @callback
-    def async_update_entity_platform(self, entity_id: str, new_platform: str, *, new_config_entry_id: str | UndefinedType = ..., new_unique_id: str | UndefinedType = ..., new_device_id: str | None | UndefinedType = ...) -> RegistryEntry: ...
+    def async_update_entity_platform(self, entity_id: str, new_platform: str, *, new_config_entry_id: str | UndefinedType = ..., new_config_subentry_id: str | UndefinedType = ..., new_unique_id: str | UndefinedType = ..., new_device_id: str | None | UndefinedType = ...) -> RegistryEntry: ...
     @callback
     def async_update_entity_options(self, entity_id: str, domain: str, options: Mapping[str, Any] | None) -> RegistryEntry: ...
     async def async_load(self) -> None: ...
@@ -205,6 +207,8 @@ class EntityRegistry(BaseRegistry):
     @callback
     def async_clear_config_entry(self, config_entry_id: str) -> None: ...
     @callback
+    def async_clear_config_subentry(self, config_entry_id: str, config_subentry_id: str) -> None: ...
+    @callback
     def async_purge_expired_orphaned_entities(self) -> None: ...
     @callback
     def async_clear_area_id(self, area_id: str) -> None: ...

homeassistant-stubs/helpers/llm.pyi

@@ -5,7 +5,7 @@ from .singleton import singleton as singleton
 from _typeshed import Incomplete
 from abc import ABC, abstractmethod
 from collections.abc import Callable as Callable
-from dataclasses import dataclass
+from dataclasses import dataclass, field as dc_field
 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.cover import INTENT_CLOSE_COVER as INTENT_CLOSE_COVER, INTENT_OPEN_COVER as INTENT_OPEN_COVER
@@ -17,6 +17,7 @@ from homeassistant.core import Context as Context, Event as Event, HomeAssistant
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.util.hass_dict import HassKey as HassKey
 from homeassistant.util.json import JsonObjectType as JsonObjectType
+from homeassistant.util.ulid import ulid_now as ulid_now
 from typing import Any
 
 ACTION_PARAMETERS_CACHE: HassKey[dict[str, dict[str, tuple[str | None, vol.Schema]]]]
@@ -47,6 +48,7 @@ class LLMContext:
 class ToolInput:
     tool_name: str
     tool_args: dict[str, Any]
+    id: str = dc_field(default_factory=Incomplete)
 
 class Tool(metaclass=abc.ABCMeta):
     name: str

homeassistant-stubs/helpers/recorder.pyi

@@ -10,7 +10,7 @@ from sqlalchemy.orm.session import Session as Session
 from typing import Any
 
 _LOGGER: Incomplete
-DOMAIN: HassKey[RecorderData]
+DATA_RECORDER: HassKey[RecorderData]
 DATA_INSTANCE: HassKey[Recorder]
 
 @dataclass(slots=True)
@@ -24,7 +24,6 @@ def async_migration_in_progress(hass: HomeAssistant) -> bool: ...
 def async_migration_is_live(hass: HomeAssistant) -> bool: ...
 @callback
 def async_initialize_recorder(hass: HomeAssistant) -> None: ...
-async def async_wait_recorder(hass: HomeAssistant) -> bool: ...
 def get_instance(hass: HomeAssistant) -> Recorder: ...
 @contextmanager
 def session_scope(*, hass: HomeAssistant | None = None, session: Session | None = None, exception_filter: Callable[[Exception], bool] | None = None, read_only: bool = False) -> Generator[Session]: ...