From 2c0ed2cbfe2075b5de3290647eb63bff20593f35 Mon Sep 17 00:00:00 2001
From: Michael Hansen <mike@rhasspy.org>
Date: Wed, 13 Aug 2025 11:57:25 -0500
Subject: [PATCH] Add intent for setting fan speed (#150576)

---
 homeassistant/components/fan/intent.py | 31 +++++++++++++++++++++
 tests/components/fan/test_intent.py    | 37 ++++++++++++++++++++++++++
 2 files changed, 68 insertions(+)
 create mode 100644 homeassistant/components/fan/intent.py
 create mode 100644 tests/components/fan/test_intent.py

diff --git a/homeassistant/components/fan/intent.py b/homeassistant/components/fan/intent.py
new file mode 100644
index 00000000000..ef088a4bba9
--- /dev/null
+++ b/homeassistant/components/fan/intent.py
@@ -0,0 +1,31 @@
+"""Intents for the fan integration."""
+
+import voluptuous as vol
+
+from homeassistant.core import HomeAssistant
+from homeassistant.helpers import intent
+
+from . import ATTR_PERCENTAGE, DOMAIN, SERVICE_TURN_ON
+
+INTENT_FAN_SET_SPEED = "HassFanSetSpeed"
+
+
+async def async_setup_intents(hass: HomeAssistant) -> None:
+    """Set up the fan intents."""
+    intent.async_register(
+        hass,
+        intent.ServiceIntentHandler(
+            INTENT_FAN_SET_SPEED,
+            DOMAIN,
+            SERVICE_TURN_ON,
+            description="Sets a fan's speed by percentage",
+            required_domains={DOMAIN},
+            platforms={DOMAIN},
+            required_slots={
+                ATTR_PERCENTAGE: intent.IntentSlotInfo(
+                    description="The speed percentage of the fan",
+                    value_schema=vol.All(vol.Coerce(int), vol.Range(min=0, max=100)),
+                )
+            },
+        ),
+    )
diff --git a/tests/components/fan/test_intent.py b/tests/components/fan/test_intent.py
new file mode 100644
index 00000000000..450d81e9dff
--- /dev/null
+++ b/tests/components/fan/test_intent.py
@@ -0,0 +1,37 @@
+"""Intent tests for the fan platform."""
+
+from homeassistant.components.fan import (
+    ATTR_PERCENTAGE,
+    DOMAIN,
+    SERVICE_TURN_ON,
+    intent as fan_intent,
+)
+from homeassistant.const import STATE_OFF
+from homeassistant.core import HomeAssistant
+from homeassistant.helpers import intent
+
+from tests.common import async_mock_service
+
+
+async def test_set_speed_intent(hass: HomeAssistant) -> None:
+    """Test set speed intent for fans."""
+    await fan_intent.async_setup_intents(hass)
+
+    entity_id = f"{DOMAIN}.test_fan"
+    hass.states.async_set(entity_id, STATE_OFF)
+    calls = async_mock_service(hass, DOMAIN, SERVICE_TURN_ON)
+
+    response = await intent.async_handle(
+        hass,
+        "test",
+        fan_intent.INTENT_FAN_SET_SPEED,
+        {"name": {"value": "test fan"}, ATTR_PERCENTAGE: {"value": 50}},
+    )
+    await hass.async_block_till_done()
+
+    assert response.response_type == intent.IntentResponseType.ACTION_DONE
+    assert len(calls) == 1
+    call = calls[0]
+    assert call.domain == DOMAIN
+    assert call.service == SERVICE_TURN_ON
+    assert call.data == {"entity_id": entity_id, "percentage": 50}