Changes for Home assistant support

.gitignore

@@ -15,3 +15,6 @@
 fastlane/report.xml
 fastlane/README.md
 fastlane_config.txt
+
+# Kiro specs (local only)
+.kiro/

README.md

@@ -41,6 +41,8 @@ Currently Dicio answers questions about:
 - **media**: play, pause, previous, next song
 - **translation**: translate from/to any language with **Lingva** - _How do I say Football in German?_
 - **wake word control**: turn on/off the wakeword - _Stop listening_
+- **home assistant**: query and control **Home Assistant** entities - _Turn living room light on_, _Turn kitchen radio to BBC Radio 2_
+  - Note: Media source selection with number homophones (e.g., "too" → "2") is currently English-only
 - **notifications**: reads all notifications currently in the status bar - _What are my notifications?_
 - **flashlight**: turn on/off the phone flashlight - _Turn on the flashlight_
 

app/build.gradle.kts

@@ -198,6 +198,9 @@ dependencies {
 
     // Used by skills
     implementation(libs.exp4j)
+
+    // YAML processing
+    implementation("org.yaml:snakeyaml:2.0")
 
     // Testing
     testImplementation(libs.kotest.runner.junit5)

app/src/main/kotlin/org/stypox/dicio/eval/SkillHandler.kt

@@ -20,6 +20,7 @@ import org.stypox.dicio.settings.datastore.UserSettingsModule
 import org.stypox.dicio.skills.calculator.CalculatorInfo
 import org.stypox.dicio.skills.current_time.CurrentTimeInfo
 import org.stypox.dicio.skills.fallback.text.TextFallbackInfo
+import org.stypox.dicio.skills.homeassistant.HomeAssistantInfo
 import org.stypox.dicio.skills.listening.ListeningInfo
 import org.stypox.dicio.skills.lyrics.LyricsInfo
 import org.stypox.dicio.skills.media.MediaInfo
@@ -57,6 +58,7 @@ class SkillHandler @Inject constructor(
         JokeInfo,
         ListeningInfo(dataStore),
         TranslationInfo,
+        HomeAssistantInfo,
         NotifyInfo,
         FlashlightInfo,
     )

app/src/main/kotlin/org/stypox/dicio/skills/homeassistant/HomeAssistantApi.kt

@@ -0,0 +1,63 @@
+package org.stypox.dicio.skills.homeassistant
+
+import org.json.JSONArray
+import org.json.JSONObject
+import org.stypox.dicio.util.ConnectionUtils
+import java.io.IOException
+import java.net.HttpURLConnection
+import java.net.URL
+
+object HomeAssistantApi {
+    @Throws(IOException::class)
+    suspend fun getAllStates(baseUrl: String, token: String): JSONArray {
+        val connection = URL("$baseUrl/api/states").openConnection() as HttpURLConnection
+        connection.setRequestProperty("Authorization", "Bearer $token")
+        connection.setRequestProperty("Content-Type", "application/json")
+
+        val scanner = java.util.Scanner(connection.inputStream)
+        val response = scanner.useDelimiter("\\A").next()
+        scanner.close()
+
+        return JSONArray(response)
+    }
+
+    @Throws(IOException::class)
+    suspend fun getEntityState(baseUrl: String, token: String, entityId: String): JSONObject {
+        val connection = URL("$baseUrl/api/states/$entityId").openConnection() as HttpURLConnection
+        connection.setRequestProperty("Authorization", "Bearer $token")
+        connection.setRequestProperty("Content-Type", "application/json")
+
+        val scanner = java.util.Scanner(connection.inputStream)
+        val response = scanner.useDelimiter("\\A").next()
+        scanner.close()
+
+        return JSONObject(response)
+    }
+
+    @Throws(IOException::class)
+    suspend fun callService(
+        baseUrl: String,
+        token: String,
+        domain: String,
+        service: String,
+        entityId: String,
+        extraParams: Map<String, String> = emptyMap()
+    ): JSONArray {
+        val connection = URL("$baseUrl/api/services/$domain/$service").openConnection() as HttpURLConnection
+        connection.requestMethod = "POST"
+        connection.setRequestProperty("Authorization", "Bearer $token")
+        connection.setRequestProperty("Content-Type", "application/json")
+        connection.doOutput = true
+
+        val body = JSONObject().put("entity_id", entityId)
+        extraParams.forEach { (key, value) -> body.put(key, value) }
+
+        connection.outputStream.write(body.toString().toByteArray())
+
+        val scanner = java.util.Scanner(connection.inputStream)
+        val response = scanner.useDelimiter("\\A").next()
+        scanner.close()
+
+        return JSONArray(response)
+    }
+}