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

homeassistant/components/number/const.py

@@ -57,7 +57,6 @@ ATTR_VALUE = "value"
 ATTR_MIN = "min"
 ATTR_MAX = "max"
 ATTR_STEP = "step"
-ATTR_STEP_VALIDATION = "step_validation"
 
 DEFAULT_MIN_VALUE = 0.0
 DEFAULT_MAX_VALUE = 100.0
@@ -89,7 +88,7 @@ class NumberDeviceClass(StrEnum):
     APPARENT_POWER = "apparent_power"
     """Apparent power.
 
-    Unit of measurement: `mVA`, `VA`
+    Unit of measurement: `mVA`, `VA`, `kVA`
     """
 
     AQI = "aqi"
@@ -125,7 +124,7 @@ class NumberDeviceClass(StrEnum):
     CO = "carbon_monoxide"
     """Carbon Monoxide gas concentration.
 
-    Unit of measurement: `ppm` (parts per million)
+    Unit of measurement: `ppm` (parts per million), mg/m³
     """
 
     CO2 = "carbon_dioxide"
@@ -207,7 +206,7 @@ class NumberDeviceClass(StrEnum):
 
     Unit of measurement:
     - SI / metric: `L`, `m³`
-    - USCS / imperial: `ft³`, `CCF`
+    - USCS / imperial: `ft³`, `CCF`, `MCF`
     """
 
     HUMIDITY = "humidity"
@@ -292,6 +291,12 @@ class NumberDeviceClass(StrEnum):
     Unit of measurement: `μg/m³`
     """
 
+    PM4 = "pm4"
+    """Particulate matter <= 4 μm.
+
+    Unit of measurement: `μg/m³`
+    """
+
     POWER_FACTOR = "power_factor"
     """Power factor.
 
@@ -328,6 +333,7 @@ class NumberDeviceClass(StrEnum):
     - `Pa`, `hPa`, `kPa`
     - `inHg`
     - `psi`
+    - `inH₂O`
     """
 
     REACTIVE_ENERGY = "reactive_energy"
@@ -398,7 +404,7 @@ class NumberDeviceClass(StrEnum):
 
     Unit of measurement: `VOLUME_*` units
     - SI / metric: `mL`, `L`, `m³`
-    - USCS / imperial: `ft³`, `CCF`, `fl. oz.`, `gal` (warning: volumes expressed in
+    - USCS / imperial: `ft³`, `CCF`, `MCF`, `fl. oz.`, `gal` (warning: volumes expressed in
     USCS/imperial units are currently assumed to be US volumes)
     """
 
@@ -410,7 +416,7 @@ class NumberDeviceClass(StrEnum):
 
     Unit of measurement: `VOLUME_*` units
     - SI / metric: `mL`, `L`, `m³`
-    - USCS / imperial: `ft³`, `CCF`, `fl. oz.`, `gal` (warning: volumes expressed in
+    - USCS / imperial: `ft³`, `CCF`, `MCF`, `fl. oz.`, `gal` (warning: volumes expressed in
     USCS/imperial units are currently assumed to be US volumes)
     """
 
@@ -427,7 +433,7 @@ class NumberDeviceClass(StrEnum):
 
     Unit of measurement:
     - SI / metric: `m³`, `L`
-    - USCS / imperial: `ft³`, `CCF`, `gal` (warning: volumes expressed in
+    - USCS / imperial: `ft³`, `CCF`, `MCF`, `gal` (warning: volumes expressed in
     USCS/imperial units are currently assumed to be US volumes)
     """
 
@@ -469,7 +475,10 @@ DEVICE_CLASS_UNITS: dict[NumberDeviceClass, set[type[StrEnum] | str | None]] = {
     NumberDeviceClass.ATMOSPHERIC_PRESSURE: set(UnitOfPressure),
     NumberDeviceClass.BATTERY: {PERCENTAGE},
     NumberDeviceClass.BLOOD_GLUCOSE_CONCENTRATION: set(UnitOfBloodGlucoseConcentration),
-    NumberDeviceClass.CO: {CONCENTRATION_PARTS_PER_MILLION},
+    NumberDeviceClass.CO: {
+        CONCENTRATION_PARTS_PER_MILLION,
+        CONCENTRATION_MILLIGRAMS_PER_CUBIC_METER,
+    },
     NumberDeviceClass.CO2: {CONCENTRATION_PARTS_PER_MILLION},
     NumberDeviceClass.CONDUCTIVITY: set(UnitOfConductivity),
     NumberDeviceClass.CURRENT: set(UnitOfElectricCurrent),
@@ -493,6 +502,7 @@ DEVICE_CLASS_UNITS: dict[NumberDeviceClass, set[type[StrEnum] | str | None]] = {
         UnitOfVolume.CUBIC_FEET,
         UnitOfVolume.CUBIC_METERS,
         UnitOfVolume.LITERS,
+        UnitOfVolume.MILLE_CUBIC_FEET,
     },
     NumberDeviceClass.HUMIDITY: {PERCENTAGE},
     NumberDeviceClass.ILLUMINANCE: {LIGHT_LUX},
@@ -506,6 +516,7 @@ DEVICE_CLASS_UNITS: dict[NumberDeviceClass, set[type[StrEnum] | str | None]] = {
     NumberDeviceClass.PM1: {CONCENTRATION_MICROGRAMS_PER_CUBIC_METER},
     NumberDeviceClass.PM10: {CONCENTRATION_MICROGRAMS_PER_CUBIC_METER},
     NumberDeviceClass.PM25: {CONCENTRATION_MICROGRAMS_PER_CUBIC_METER},
+    NumberDeviceClass.PM4: {CONCENTRATION_MICROGRAMS_PER_CUBIC_METER},
     NumberDeviceClass.POWER_FACTOR: {PERCENTAGE, None},
     NumberDeviceClass.POWER: {
         UnitOfPower.MILLIWATT,
@@ -546,6 +557,7 @@ DEVICE_CLASS_UNITS: dict[NumberDeviceClass, set[type[StrEnum] | str | None]] = {
         UnitOfVolume.CUBIC_METERS,
         UnitOfVolume.GALLONS,
         UnitOfVolume.LITERS,
+        UnitOfVolume.MILLE_CUBIC_FEET,
     },
     NumberDeviceClass.WEIGHT: set(UnitOfMass),
     NumberDeviceClass.WIND_DIRECTION: {DEGREE},

homeassistant/components/number/icons.json

@@ -147,6 +147,9 @@
     "volume": {
       "default": "mdi:car-coolant-level"
     },
+    "volume_flow_rate": {
+      "default": "mdi:pipe-valve"
+    },
     "volume_storage": {
       "default": "mdi:storage-tank"
     },

homeassistant/components/nut/strings.json

@@ -295,7 +295,7 @@
       "ups_realpower": { "name": "Real power" },
       "ups_realpower_nominal": { "name": "Nominal real power" },
       "ups_shutdown": { "name": "Shutdown ability" },
-      "ups_start_auto": { "name": "Start on ac" },
+      "ups_start_auto": { "name": "Start on AC" },
       "ups_start_battery": { "name": "Start on battery" },
       "ups_start_reboot": { "name": "Reboot on battery" },
       "ups_status": { "name": "Status data" },

homeassistant/components/nut/translations/pt.json

@@ -548,7 +548,7 @@
         },
         "switch": {
             "outlet_number_load_poweronoff": {
-                "name": "Tomada el\u00e9ctrica {outlet_name}"
+                "name": "Tomada el\u00e9trica {outlet_name}"
             }
         }
     },

homeassistant/components/ohme/translations/pt.json

@@ -32,7 +32,7 @@
             },
             "user": {
                 "data": {
-                    "email": "E-mail",
+                    "email": "Email",
                     "password": "Palavra-passe"
                 },
                 "data_description": {

homeassistant/components/onedrive/translations/pt.json

@@ -148,7 +148,7 @@
                 },
                 "destination_folder": {
                     "description": "Pasta dentro da pasta da aplica\u00e7\u00e3o do Home Assistant (Apps/Home Assistant) para onde pretende carregar o ficheiro. Ser\u00e1 criada se n\u00e3o existir.",
-                    "example": "photos/snapshots",
+                    "example": "fotos/instant\u00e2neos",
                     "name": "Pasta de destino"
                 },
                 "filename": {

homeassistant/components/onewire/translations/vi.json

@@ -11,6 +11,11 @@
             "thermocouple_temperature_k": {
                 "name": "Nhi\u1ec7t \u0111\u1ed9 c\u1eb7p nhi\u1ec7t \u0111i\u1ec7n K"
             }
+        },
+        "switch": {
+            "iad": {
+                "name": "\u0110i\u1ec1u khi\u1ec3n A/D hi\u1ec7n t\u1ea1i"
+            }
         }
     }
 }

homeassistant/components/onvif/strings.json

@@ -4,7 +4,7 @@
       "already_configured": "[%key:common::config_flow::abort::already_configured_device%]",
       "no_devices_found": "[%key:common::config_flow::abort::no_devices_found%]",
       "already_in_progress": "[%key:common::config_flow::abort::already_in_progress%]",
-      "no_h264": "There were no H264 streams available.  Check the profile configuration on your device.",
+      "no_h264": "There were no H.264 streams available. Check the profile configuration on your device.",
       "no_mac": "Could not configure unique ID for ONVIF device.",
       "reauth_successful": "[%key:common::config_flow::abort::reauth_successful%]"
     },
@@ -43,7 +43,7 @@
       },
       "configure_profile": {
         "description": "Create camera entity for {profile} at {resolution} resolution?",
-        "title": "Configure Profiles",
+        "title": "Configure profiles",
         "data": {
           "include": "Create camera entity"
         }

homeassistant/components/onvif/translations/de.json

@@ -53,7 +53,7 @@
                 "data": {
                     "auto": "Automatisch suchen"
                 },
-                "description": "Wenn du auf **OK** dr\u00fcckst, durchsuchen wir dein Netzwerk nach ONVIF-Ger\u00e4ten, die Profil S unterst\u00fctzen. \n\nEinige Hersteller haben begonnen, ONVIF standardm\u00e4\u00dfig zu deaktivieren. Stelle sicher, dass ONVIF in der Konfiguration deiner Kamera aktiviert ist.",
+                "description": "Wenn du **OK** w\u00e4hlst, durchsuchen wir dein Netzwerk nach ONVIF-Ger\u00e4ten, die Profil S unterst\u00fctzen. \n\nEinige Hersteller haben begonnen, ONVIF standardm\u00e4\u00dfig zu deaktivieren. Stelle sicher, dass ONVIF in der Konfiguration deiner Kamera aktiviert ist.",
                 "title": "ONVIF-Ger\u00e4tekonfiguration"
             }
         }

homeassistant/components/onvif/translations/he.json

@@ -4,6 +4,7 @@
             "already_configured": "\u05ea\u05e6\u05d5\u05e8\u05ea \u05d4\u05d4\u05ea\u05e7\u05df \u05db\u05d1\u05e8 \u05e0\u05e7\u05d1\u05e2\u05d4",
             "already_in_progress": "\u05d6\u05e8\u05d9\u05de\u05ea \u05d4\u05ea\u05e6\u05d5\u05e8\u05d4 \u05db\u05d1\u05e8 \u05de\u05ea\u05d1\u05e6\u05e2\u05ea",
             "no_devices_found": "\u05dc\u05d0 \u05e0\u05de\u05e6\u05d0\u05d5 \u05d4\u05ea\u05e7\u05e0\u05d9\u05dd \u05d1\u05e8\u05e9\u05ea",
+            "no_h264": "\u05dc\u05d0 \u05d4\u05d9\u05d5 \u05d6\u05e8\u05de\u05d9 H264 \u05d6\u05de\u05d9\u05e0\u05d9\u05dd. \u05d9\u05e9 \u05dc\u05d1\u05d3\u05d5\u05e7 \u05d0\u05ea \u05ea\u05e6\u05d5\u05e8\u05ea \u05d4\u05e4\u05e8\u05d5\u05e4\u05d9\u05dc \u05d1\u05d4\u05ea\u05e7\u05df \u05e9\u05dc\u05da.",
             "no_mac": "\u05dc\u05d0 \u05d4\u05d9\u05ea\u05d4 \u05d0\u05e4\u05e9\u05e8\u05d5\u05ea \u05dc\u05e7\u05d1\u05d5\u05e2 \u05ea\u05e6\u05d5\u05e8\u05d4 \u05e9\u05dc \u05de\u05d6\u05d4\u05d4 \u05d9\u05d9\u05d7\u05d5\u05d3\u05d9 \u05e2\u05d1\u05d5\u05e8 \u05d4\u05ea\u05e7\u05df ONVIF.",
             "reauth_successful": "\u05d4\u05d0\u05d9\u05de\u05d5\u05ea \u05de\u05d7\u05d3\u05e9 \u05d4\u05e6\u05dc\u05d9\u05d7"
         },
@@ -25,7 +26,8 @@
                 "data": {
                     "include": "\u05e6\u05d5\u05e8 \u05d9\u05e9\u05d5\u05ea \u05de\u05e6\u05dc\u05de\u05d4"
                 },
-                "description": "\u05d4\u05d0\u05dd \u05dc\u05d9\u05e6\u05d5\u05e8 \u05d9\u05e9\u05d5\u05ea \u05de\u05e6\u05dc\u05de\u05d4 \u05e2\u05d1\u05d5\u05e8 {profile} \u05d1\u05e8\u05d6\u05d5\u05dc\u05d5\u05e6\u05d9\u05d9\u05ea {resolution}?"
+                "description": "\u05d4\u05d0\u05dd \u05dc\u05d9\u05e6\u05d5\u05e8 \u05d9\u05e9\u05d5\u05ea \u05de\u05e6\u05dc\u05de\u05d4 \u05e2\u05d1\u05d5\u05e8 {profile} \u05d1\u05e8\u05d6\u05d5\u05dc\u05d5\u05e6\u05d9\u05d9\u05ea {resolution}?",
+                "title": "\u05d4\u05d2\u05d3\u05e8\u05ea \u05e4\u05e8\u05d5\u05e4\u05d9\u05dc\u05d9\u05dd"
             },
             "device": {
                 "data": {

homeassistant/components/onvif/translations/pt.json

@@ -4,6 +4,7 @@
             "already_configured": "Dispositivo j\u00e1 configurado",
             "already_in_progress": "O processo de configura\u00e7\u00e3o j\u00e1 est\u00e1 a decorrer",
             "no_devices_found": "Nenhum dispositivo encontrado na rede",
+            "no_h264": "N\u00e3o existem fluxos H264 dispon\u00edveis. Verifique a configura\u00e7\u00e3o de perfil no seu dispositivo.",
             "no_mac": "N\u00e3o foi poss\u00edvel configurar o ID unico para o dispositivo ONVIF.",
             "reauth_successful": "Reautentica\u00e7\u00e3o bem sucedida"
         },
@@ -31,7 +32,8 @@
                 "data": {
                     "include": "Criar entidade da c\u00e2mara"
                 },
-                "description": "Criar entidade de c\u00e2mera para {profile} com resolu\u00e7\u00e3o {resolution} ?"
+                "description": "Criar entidade de c\u00e2mera para {profile} com resolu\u00e7\u00e3o {resolution} ?",
+                "title": "Configurar perfis"
             },
             "device": {
                 "data": {

homeassistant/components/onvif/translations/ru.json

@@ -4,6 +4,7 @@
             "already_configured": "\u042d\u0442\u043e \u0443\u0441\u0442\u0440\u043e\u0439\u0441\u0442\u0432\u043e \u0443\u0436\u0435 \u0434\u043e\u0431\u0430\u0432\u043b\u0435\u043d\u043e \u0432 Home Assistant",
             "already_in_progress": "\u041f\u0440\u043e\u0446\u0435\u0441\u0441 \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0438 \u0443\u0436\u0435 \u0432\u044b\u043f\u043e\u043b\u043d\u044f\u0435\u0442\u0441\u044f",
             "no_devices_found": "\u0423\u0441\u0442\u0440\u043e\u0439\u0441\u0442\u0432\u0430 \u043d\u0435 \u043d\u0430\u0439\u0434\u0435\u043d\u044b \u0432 \u0441\u0435\u0442\u0438",
+            "no_h264": "\u041d\u0435\u0442 \u0434\u043e\u0441\u0442\u0443\u043f\u043d\u044b\u0445 \u043f\u043e\u0442\u043e\u043a\u043e\u0432 H.264. \u041f\u0440\u043e\u0432\u0435\u0440\u044c\u0442\u0435 \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0438 \u043d\u0430 \u0412\u0430\u0448\u0435\u043c \u0443\u0441\u0442\u0440\u043e\u0439\u0441\u0442\u0432\u0435.",
             "no_mac": "\u041d\u0435 \u0443\u0434\u0430\u043b\u043e\u0441\u044c \u043d\u0430\u0441\u0442\u0440\u043e\u0438\u0442\u044c \u0443\u043d\u0438\u043a\u0430\u043b\u044c\u043d\u044b\u0439 \u0438\u0434\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0442\u043e\u0440 \u0434\u043b\u044f \u0443\u0441\u0442\u0440\u043e\u0439\u0441\u0442\u0432\u0430.",
             "reauth_successful": "\u041f\u043e\u0432\u0442\u043e\u0440\u043d\u0430\u044f \u0430\u0443\u0442\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044f \u0432\u044b\u043f\u043e\u043b\u043d\u0435\u043d\u0430 \u0443\u0441\u043f\u0435\u0448\u043d\u043e"
         },
@@ -31,7 +32,8 @@
                 "data": {
                     "include": "\u0421\u043e\u0437\u0434\u0430\u0442\u044c \u043e\u0431\u044a\u0435\u043a\u0442 \u043a\u0430\u043c\u0435\u0440\u044b"
                 },
-                "description": "\u0421\u043e\u0437\u0434\u0430\u0442\u044c \u043e\u0431\u044a\u0435\u043a\u0442 \u043a\u0430\u043c\u0435\u0440\u044b \u0434\u043b\u044f {profile} \u0441 \u0440\u0430\u0437\u0440\u0435\u0448\u0435\u043d\u0438\u0435\u043c {resolution}?"
+                "description": "\u0421\u043e\u0437\u0434\u0430\u0442\u044c \u043e\u0431\u044a\u0435\u043a\u0442 \u043a\u0430\u043c\u0435\u0440\u044b \u0434\u043b\u044f {profile} \u0441 \u0440\u0430\u0437\u0440\u0435\u0448\u0435\u043d\u0438\u0435\u043c {resolution}?",
+                "title": "\u041d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430 \u043f\u0440\u043e\u0444\u0438\u043b\u0435\u0439"
             },
             "device": {
                 "data": {

homeassistant/components/openai_conversation/__init__.py

@@ -148,7 +148,7 @@ async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool:
 
             content.extend(
                 await async_prepare_files_for_prompt(
-                    hass, [Path(filename) for filename in filenames]
+                    hass, [(Path(filename), None) for filename in filenames]
                 )
             )
 

homeassistant/components/openai_conversation/ai_task.py

@@ -2,8 +2,12 @@
 
 from __future__ import annotations
 
+import base64
 from json import JSONDecodeError
 import logging
+from typing import TYPE_CHECKING
+
+from openai.types.responses.response_output_item import ImageGenerationCall
 
 from homeassistant.components import ai_task, conversation
 from homeassistant.config_entries import ConfigEntry
@@ -12,8 +16,14 @@ from homeassistant.exceptions import HomeAssistantError
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback
 from homeassistant.util.json import json_loads
 
+from .const import CONF_CHAT_MODEL, RECOMMENDED_CHAT_MODEL, UNSUPPORTED_IMAGE_MODELS
 from .entity import OpenAIBaseLLMEntity
 
+if TYPE_CHECKING:
+    from homeassistant.config_entries import ConfigSubentry
+
+    from . import OpenAIConfigEntry
+
 _LOGGER = logging.getLogger(__name__)
 
 
@@ -39,10 +49,16 @@ class OpenAITaskEntity(
 ):
     """OpenAI AI Task entity."""
 
-    _attr_supported_features = (
-        ai_task.AITaskEntityFeature.GENERATE_DATA
-        | ai_task.AITaskEntityFeature.SUPPORT_ATTACHMENTS
-    )
+    def __init__(self, entry: OpenAIConfigEntry, subentry: ConfigSubentry) -> None:
+        """Initialize the entity."""
+        super().__init__(entry, subentry)
+        self._attr_supported_features = (
+            ai_task.AITaskEntityFeature.GENERATE_DATA
+            | ai_task.AITaskEntityFeature.SUPPORT_ATTACHMENTS
+        )
+        model = self.subentry.data.get(CONF_CHAT_MODEL, RECOMMENDED_CHAT_MODEL)
+        if not model.startswith(tuple(UNSUPPORTED_IMAGE_MODELS)):
+            self._attr_supported_features |= ai_task.AITaskEntityFeature.GENERATE_IMAGE
 
     async def _async_generate_data(
         self,
@@ -78,3 +94,56 @@ class OpenAITaskEntity(
             conversation_id=chat_log.conversation_id,
             data=data,
         )
+
+    async def _async_generate_image(
+        self,
+        task: ai_task.GenImageTask,
+        chat_log: conversation.ChatLog,
+    ) -> ai_task.GenImageTaskResult:
+        """Handle a generate image task."""
+        await self._async_handle_chat_log(chat_log, task.name, force_image=True)
+
+        if not isinstance(chat_log.content[-1], conversation.AssistantContent):
+            raise HomeAssistantError(
+                "Last content in chat log is not an AssistantContent"
+            )
+
+        image_call: ImageGenerationCall | None = None
+        for content in reversed(chat_log.content):
+            if not isinstance(content, conversation.AssistantContent):
+                break
+            if isinstance(content.native, ImageGenerationCall):
+                if image_call is None or image_call.result is None:
+                    image_call = content.native
+                else:  # Remove image data from chat log to save memory
+                    content.native.result = None
+
+        if image_call is None or image_call.result is None:
+            raise HomeAssistantError("No image returned")
+
+        image_data = base64.b64decode(image_call.result)
+        image_call.result = None
+
+        if hasattr(image_call, "output_format") and (
+            output_format := image_call.output_format
+        ):
+            mime_type = f"image/{output_format}"
+        else:
+            mime_type = "image/png"
+
+        if hasattr(image_call, "size") and (size := image_call.size):
+            width, height = tuple(size.split("x"))
+        else:
+            width, height = None, None
+
+        return ai_task.GenImageTaskResult(
+            image_data=image_data,
+            conversation_id=chat_log.conversation_id,
+            mime_type=mime_type,
+            width=int(width) if width else None,
+            height=int(height) if height else None,
+            model="gpt-image-1",
+            revised_prompt=image_call.revised_prompt
+            if hasattr(image_call, "revised_prompt")
+            else None,
+        )

homeassistant/components/openai_conversation/const.py

@@ -60,6 +60,15 @@ UNSUPPORTED_WEB_SEARCH_MODELS: list[str] = [
     "o3-mini",
 ]
 
+UNSUPPORTED_IMAGE_MODELS: list[str] = [
+    "gpt-5",
+    "o3-mini",
+    "o4",
+    "o1",
+    "gpt-3.5",
+    "gpt-4-turbo",
+]
+
 RECOMMENDED_CONVERSATION_OPTIONS = {
     CONF_RECOMMENDED: True,
     CONF_LLM_HASS_API: [llm.LLM_API_ASSIST],

homeassistant/components/openai_conversation/entity.py

@@ -7,7 +7,7 @@ from collections.abc import AsyncGenerator, Callable, Iterable
 import json
 from mimetypes import guess_file_type
 from pathlib import Path
-from typing import TYPE_CHECKING, Any, Literal
+from typing import TYPE_CHECKING, Any, Literal, cast
 
 import openai
 from openai._streaming import AsyncStream
@@ -37,14 +37,20 @@ from openai.types.responses import (
     ResponseReasoningSummaryTextDeltaEvent,
     ResponseStreamEvent,
     ResponseTextDeltaEvent,
+    ToolChoiceTypesParam,
     ToolParam,
     WebSearchToolParam,
 )
 from openai.types.responses.response_create_params import ResponseCreateParamsStreaming
-from openai.types.responses.response_input_param import FunctionCallOutput
+from openai.types.responses.response_input_param import (
+    FunctionCallOutput,
+    ImageGenerationCall as ImageGenerationCallParam,
+)
+from openai.types.responses.response_output_item import ImageGenerationCall
 from openai.types.responses.tool_param import (
     CodeInterpreter,
     CodeInterpreterContainerCodeInterpreterToolAuto,
+    ImageGeneration,
 )
 from openai.types.responses.web_search_tool_param import UserLocation
 import voluptuous as vol
@@ -54,7 +60,7 @@ from homeassistant.components import conversation
 from homeassistant.config_entries import ConfigSubentry
 from homeassistant.core import HomeAssistant
 from homeassistant.exceptions import HomeAssistantError
-from homeassistant.helpers import device_registry as dr, llm
+from homeassistant.helpers import device_registry as dr, issue_registry as ir, llm
 from homeassistant.helpers.entity import Entity
 from homeassistant.util import slugify
 
@@ -217,24 +223,30 @@ def _convert_content_to_param(
                     ResponseReasoningItemParam(
                         type="reasoning",
                         id=content.native.id,
-                        summary=[
-                            {
-                                "type": "summary_text",
-                                "text": summary,
-                            }
-                            for summary in reasoning_summary
-                        ]
-                        if content.thinking_content
-                        else [],
+                        summary=(
+                            [
+                                {
+                                    "type": "summary_text",
+                                    "text": summary,
+                                }
+                                for summary in reasoning_summary
+                            ]
+                            if content.thinking_content
+                            else []
+                        ),
                         encrypted_content=content.native.encrypted_content,
                     )
                 )
                 reasoning_summary = []
+            elif isinstance(content.native, ImageGenerationCall):
+                messages.append(
+                    cast(ImageGenerationCallParam, content.native.to_dict())
+                )
 
     return messages
 
 
-async def _transform_stream(
+async def _transform_stream(  # noqa: C901 - This is complex, but better to have it in one place
     chat_log: conversation.ChatLog,
     stream: AsyncStream[ResponseStreamEvent],
 ) -> AsyncGenerator[
@@ -298,9 +310,11 @@ async def _transform_stream(
                     "tool_call_id": event.item.id,
                     "tool_name": "code_interpreter",
                     "tool_result": {
-                        "output": [output.to_dict() for output in event.item.outputs]  # type: ignore[misc]
-                        if event.item.outputs is not None
-                        else None
+                        "output": (
+                            [output.to_dict() for output in event.item.outputs]  # type: ignore[misc]
+                            if event.item.outputs is not None
+                            else None
+                        )
                     },
                 }
                 last_role = "tool_result"
@@ -324,6 +338,9 @@ async def _transform_stream(
                     "tool_result": {"status": event.item.status},
                 }
                 last_role = "tool_result"
+            elif isinstance(event.item, ImageGenerationCall):
+                yield {"native": event.item}
+                last_summary_index = -1  # Trigger new assistant message on next turn
         elif isinstance(event, ResponseTextDeltaEvent):
             yield {"content": event.delta}
         elif isinstance(event, ResponseReasoningSummaryTextDeltaEvent):
@@ -429,6 +446,7 @@ class OpenAIBaseLLMEntity(Entity):
         chat_log: conversation.ChatLog,
         structure_name: str | None = None,
         structure: vol.Schema | None = None,
+        force_image: bool = False,
     ) -> None:
         """Generate an answer for the chat log."""
         options = self.subentry.data
@@ -495,6 +513,17 @@ class OpenAIBaseLLMEntity(Entity):
             )
             model_args.setdefault("include", []).append("code_interpreter_call.outputs")  # type: ignore[union-attr]
 
+        if force_image:
+            tools.append(
+                ImageGeneration(
+                    type="image_generation",
+                    input_fidelity="high",
+                    output_format="png",
+                )
+            )
+            model_args["tool_choice"] = ToolChoiceTypesParam(type="image_generation")
+            model_args["store"] = True  # Avoid sending image data back and forth
+
         if tools:
             model_args["tools"] = tools
 
@@ -504,7 +533,7 @@ class OpenAIBaseLLMEntity(Entity):
         if last_content.role == "user" and last_content.attachments:
             files = await async_prepare_files_for_prompt(
                 self.hass,
-                [a.path for a in last_content.attachments],
+                [(a.path, a.mime_type) for a in last_content.attachments],
             )
             last_message = messages[-1]
             assert (
@@ -553,6 +582,20 @@ class OpenAIBaseLLMEntity(Entity):
                 ):
                     LOGGER.error("Insufficient funds for OpenAI: %s", err)
                     raise HomeAssistantError("Insufficient funds for OpenAI") from err
+                if "Verify Organization" in str(err):
+                    ir.async_create_issue(
+                        self.hass,
+                        DOMAIN,
+                        "organization_verification_required",
+                        is_fixable=False,
+                        is_persistent=False,
+                        learn_more_url="https://help.openai.com/en/articles/10910291-api-organization-verification",
+                        severity=ir.IssueSeverity.WARNING,
+                        translation_key="organization_verification_required",
+                        translation_placeholders={
+                            "platform_settings": "https://platform.openai.com/settings/organization/general"
+                        },
+                    )
 
                 LOGGER.error("Error talking to OpenAI: %s", err)
                 raise HomeAssistantError("Error talking to OpenAI") from err
@@ -562,7 +605,7 @@ class OpenAIBaseLLMEntity(Entity):
 
 
 async def async_prepare_files_for_prompt(
-    hass: HomeAssistant, files: list[Path]
+    hass: HomeAssistant, files: list[tuple[Path, str | None]]
 ) -> ResponseInputMessageContentListParam:
     """Append files to a prompt.
 
@@ -572,11 +615,12 @@ async def async_prepare_files_for_prompt(
     def append_files_to_content() -> ResponseInputMessageContentListParam:
         content: ResponseInputMessageContentListParam = []
 
-        for file_path in files:
+        for file_path, mime_type in files:
             if not file_path.exists():
                 raise HomeAssistantError(f"`{file_path}` does not exist")
 
-            mime_type, _ = guess_file_type(file_path)
+            if mime_type is None:
+                mime_type = guess_file_type(file_path)[0]
 
             if not mime_type or not mime_type.startswith(("image/", "application/pdf")):
                 raise HomeAssistantError(

homeassistant/components/openai_conversation/manifest.json

@@ -2,7 +2,7 @@
   "domain": "openai_conversation",
   "name": "OpenAI",
   "after_dependencies": ["assist_pipeline", "intent"],
-  "codeowners": ["@balloob"],
+  "codeowners": [],
   "config_flow": true,
   "dependencies": ["conversation"],
   "documentation": "https://www.home-assistant.io/integrations/openai_conversation",

homeassistant/components/openai_conversation/strings.json

@@ -189,6 +189,12 @@
       }
     }
   },
+  "issues": {
+    "organization_verification_required": {
+      "title": "Organization verification required",
+      "description": "Your organization must be verified to use this model. Please go to {platform_settings} and select Verify Organization. If you just verified, it can take up to 15 minutes for access to propagate."
+    }
+  },
   "exceptions": {
     "invalid_config_entry": {
       "message": "Invalid config entry provided. Got {config_entry}"

homeassistant/components/openai_conversation/translations/cs.json

@@ -122,6 +122,12 @@
             "message": "Byla zad\u00e1na neplatn\u00e1 polo\u017eka nastaven\u00ed. M\u00e1m {config_entry}."
         }
     },
+    "issues": {
+        "organization_verification_required": {
+            "description": "Va\u0161e organizace mus\u00ed b\u00fdt pro pou\u017eit\u00ed tohoto modelu ov\u011b\u0159ena. P\u0159ejd\u011bte do {platform_settings} a vyberte volbu Ov\u011b\u0159it organizaci. Pokud jste ov\u011b\u0159ili pr\u00e1v\u011b te\u010f, m\u016f\u017ee trvat a\u017e 15 minut, ne\u017e se p\u0159\u00edstup roz\u0161\u00ed\u0159\u00ed.",
+            "title": "Vy\u017eadov\u00e1no ov\u011b\u0159en\u00ed organizace"
+        }
+    },
     "selector": {
         "reasoning_effort": {
             "options": {

homeassistant/components/openai_conversation/translations/de.json

@@ -122,6 +122,12 @@
             "message": "Ung\u00fcltiger Konfigurationseintrag angegeben. {config_entry} erhalten."
         }
     },
+    "issues": {
+        "organization_verification_required": {
+            "description": "Um dieses Modell verwenden zu k\u00f6nnen, muss deine Organisation verifiziert sein. Gehe zu {platform_settings} und w\u00e4hle \u201eOrganisation verifizieren\u201c. Wenn du die Verifizierung gerade erst durchgef\u00fchrt hast, kann es bis zu 15 Minuten dauern, bis der Zugriff freigegeben wird.",
+            "title": "Verifizierung der Organisation erforderlich"
+        }
+    },
     "selector": {
         "reasoning_effort": {
             "options": {

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

@@ -122,6 +122,12 @@
             "message": "Invalid config entry provided. Got {config_entry}"
         }
     },
+    "issues": {
+        "organization_verification_required": {
+            "description": "Your organisation must be verified to use this model. Please go to {platform_settings} and select Verify Organisation. If you just verified, it can take up to 15 minutes for access to propagate.",
+            "title": "Organisation verification required"
+        }
+    },
     "selector": {
         "reasoning_effort": {
             "options": {