Awareness Core

What this surface is for

Home awareness engine

Behavior in the current codebase

• Replaces the old HA automations bridge with an in-core awareness runtime.
• Connects to Home Assistant state changes and runs camera, doorbell, and entry-sensor rules directly.
• Stores newest-first events in Redis with source area context, timestamps, and metadata for later querying.
• Camera and doorbell paths support snapshot + vision summaries, with optional notifications and TTS routing.
• Entry sensors log both open and closed events, with open-only notifications and optional open-only TTS.
• Brief jobs generate compact text updates (events/weather/greetings) on schedules for dashboard-style use.

Direct core support

This surface mainly handles runtime orchestration rather than exposing its own direct Verba target.

Configuration schema

• Brief Scheduler Tick (sec) number

  How often the brief scheduler checks for due jobs.

  Key: brief_scheduler_tick_sec Default: 5
• Entity Catalog Cache (sec) number

  How long to cache provider entity discovery for UI dropdowns.

  Key: entity_catalog_ttl_sec Default: 30
• Event Provider select

  Select which provider powers camera/doorbell/sensor event rules.

  Key: event_provider Default: homeassistant Options: homeassistant, unifi_protect
• Snapshot Max Size (KB) number

  Maximum JPEG size to store per event snapshot.

  Key: event_snapshot_max_kb Default: 768
• Events Retention select

  How long to retain awareness events written to Redis.

  Key: events_retention Default: 7d Options: 2d, 7d, 30d, forever
• Store Event Snapshots checkbox

  Store camera/doorbell snapshot images in Redis for future event gallery UI.

  Key: store_event_snapshots Default: True
• UniFi WS Reconnect (sec) number

  Seconds between UniFi Protect websocket reconnect attempts while UniFi provider is active.

  Key: unifi_ws_reconnect_seconds Default: 5
• UniFi WS URL (optional) string

  Optional full websocket URL override for UniFi Protect updates. Leave blank to auto-use /proxy/protect/integration/v1/subscribe/events.

  Key: unifi_ws_url
• HA WS Reconnect (sec) number

  Seconds between Home Assistant websocket reconnect attempts.

  Key: ws_reconnect_seconds Default: 5