hermes-agent/website/docs/user-guide
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
..
features feat: secure skill env setup on load (core #688) 2026-03-13 03:14:04 -07:00
messaging docs: update Home Assistant integration documentation (#1170) 2026-03-13 07:45:06 -07:00
_category_.json feat: add documentation website (Docusaurus) 2026-03-05 05:24:55 -08:00
cli.md feat(cli): add /reasoning command for effort level and display toggle 2026-03-11 06:02:18 -07:00
configuration.md Merge PR #736: feat(honcho): async writes, memory modes, session title integration, setup CLI 2026-03-12 19:05:11 -07:00
security.md docs: complete Daytona backend documentation coverage 2026-03-06 03:37:05 -08:00
sessions.md docs: add resume history display to sessions, CLI, config, and AGENTS docs 2026-03-08 17:55:14 -07:00