hermes-agent/website/docs/user-guide/messaging
Teknium 4b53ecb1c7
docs: update Home Assistant integration documentation (#1170)
* fix: Home Assistant event filtering now closed by default

Previously, when no watch_domains or watch_entities were configured,
ALL state_changed events passed through to the agent, causing users
to be flooded with notifications for every HA entity change.

Now events are dropped by default unless the user explicitly configures:
- watch_domains: list of domains to monitor (e.g. climate, light)
- watch_entities: list of specific entity IDs to monitor
- watch_all: true (new option — opt-in to receive all events)

A warning is logged at connect time if no filters are configured,
guiding users to set up their HA platform config.

All 49 gateway HA tests + 52 HA tool tests pass.

* docs: update Home Assistant integration documentation

- homeassistant.md: Fix event filtering docs to reflect closed-by-default
  behavior. Add watch_all option. Replace Python dict config example with
  YAML. Fix defaults table (was incorrectly showing 'all'). Add required
  configuration warning admonition.
- environment-variables.md: Add HASS_TOKEN and HASS_URL to Messaging section.
- messaging/index.md: Add Home Assistant to description, architecture
  diagram, platform toolsets table, and Next Steps links.
2026-03-13 07:45:06 -07:00
..
_category_.json feat: add documentation website (Docusaurus) 2026-03-05 05:24:55 -08:00
discord.md docs: comprehensive rewrite of all messaging platform setup guides 2026-03-08 19:51:42 -07:00
email.md fix: wire email platform into toolset mappings + add documentation 2026-03-11 06:34:32 -07:00
homeassistant.md docs: update Home Assistant integration documentation (#1170) 2026-03-13 07:45:06 -07:00
index.md docs: update Home Assistant integration documentation (#1170) 2026-03-13 07:45:06 -07:00
signal.md fix: Signal adapter parity pass — integration gaps, clawdbot features, env var simplification 2026-03-08 21:00:21 -07:00
slack.md feat(honcho): async memory integration with prefetch pipeline and recallMode 2026-03-10 16:21:07 -04:00
telegram.md docs: comprehensive rewrite of all messaging platform setup guides 2026-03-08 19:51:42 -07:00
whatsapp.md docs: comprehensive rewrite of all messaging platform setup guides 2026-03-08 19:51:42 -07:00