Awareness Core

What this core 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, display cards, and TTS routing.
• Entry sensors log both open and closed events, with open-only notifications and optional open-only TTS.
• The old Home Assistant-oriented brief system has moved out of Awareness Core; the Tater Dashboard now generates cached 12-hour awareness summaries from the Redis event timeline.
• Snapshot notification paths can send recent camera images and descriptions to Tater S3Box displays through the display event API.

Direct core support

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

Configuration schema

• Entity Catalog Cache (sec) number

  How long to cache provider entity discovery for UI dropdowns.

  Key: entity_catalog_ttl_sec Default: 30
• 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