feat: Add Home Assistant smart device integration (Issue #366)

[Wanbogang]

Summary

Implements Home Assistant smart device integration, allowing OM1 robots to control smart home devices via Home Assistant. #366

Changes

New: src/actions/home_assistant/

• interface.py — defines HADeviceType, HAAction, HomeAssistantInput, and shared COLOR_MAP
• connector/rest_api.py — REST API connector
• connector/websocket.py — WebSocket connector
• connector/mqtt.py — MQTT connector

Each connector supports:

• Light: turn on/off, set brightness, set color
• Switch: turn on/off
• Climate: set temperature, turn on/off

New: src/inputs/plugins/home_assistant.py

• HomeAssistantStateInput plugin for real-time device state monitoring via REST polling

New: config/home_assistant.json5

• Example configuration file for Home Assistant integration

Updated: pyproject.toml

• Added aiomqtt==2.5.0 dependency for MQTT connector

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

📢 Thoughts on this report? Let us know!

[Prachi1615]

Hi @Wanbogang
Do you have a demo video showcasing the working of this?

[Wanbogang]

Hi @Prachi1615
thanks for reviewing!

I don't have a recorded video at the moment (screen recording is glitchy on my setup), but I tested the integration end-to-end against a real Home Assistant instance (HA running in Docker with the demo platform providing virtual light/switch/climate entities). I'm attaching screenshots below that walk through the full pipeline.

Setup: OM1 running the home_assistant config, connected to HA via the REST connector using a long-lived token. Commands are sent to the agent, the LLM decides the home_assistant action, and the connector calls the HA REST API.

What the screenshots show:

1. Turn on — voice command "turn on the bed light" → agent calls home_assistant(action=turn_on, entity_id=light.bed_light) → HomeAssistantRESTConnector: success 200.
2. Set brightness — "set brightness to 30%" → agent calls set_brightness (LLM maps to brightness 77/255) → success 200.
3. Turn off + HA Logbook showing every action recorded as "Bed Light turned on/off triggered by action Light" with timestamps.

The HomeAssistantStateInput plugin also picks up the state changes back into the agent (e.g. "Bed Light (light.bed_light) is on, brightness 30%"), so the loop is bidirectional.

One extra thing I found while testing: when the LLM emits empty-string values for optional numeric params (brightness/temperature) on a plain turn_on, the orchestrator's int()/float() cast raised ValueError: invalid literal for int(). I pushed a fix (commit 81a8f00) that changes those params to str in the interface and converts them safely inside each connector (rest_api, mqtt, websocket) with sane fallbacks. All 125 tests pass.

I can record a proper video once I sort out the screen-recording issue on my machine — let me know if the screenshots are enough for now. Thanks!

[Prachi1615]

Hi @Wanbogang
Thanks for the screen grabs.
Can you migrate your implementation to Go and sync with current codebase?
The python version is no longer being maintained!