AI Auras Overview

AI-first overview of aura entities, actions, triggers, overlays, and runtime infrastructure.

Auras Overview Discovery Map

Reference map for the broad aura model: auras, folders, triggers, actions, overlays, behavior trees, script entities, and built-in aura packs.

Concept Model

  • An aura is a user-facing automation unit.
  • Enabling conditions gate whether an aura may activate.
  • Triggers watch state and drive activation.
  • Actions perform work in lifecycle lists.
  • Overlays display UI/presentation.
  • Behavior tree nodes are tick-based aura entities.
  • Aura packs are registered by modules and described by metadata assemblies.

API Details

  • DefaultAurasModule - default triggers/actions/overlays/settings.
  • AdvancedAurasModule - advanced integrations such as Telegram.
  • CsScriptAurasModule - C# script triggers, actions, and overlays.
  • BehaviorTreeModule - behavior-tree nodes and runtime integration.
  • BehaviorTreeRootNode.IsLoaded is desired load state, not an awaited drain receipt. Unload closes all root/node Tick entrypoints, cancels the root epoch, then waits for admitted calls before resetting structural node state and the session. A quick reload waits for that cleanup; graph/config/blackboard remain. Manual ticks on an unloaded or draining root return Failure without execution. Loaded but inactive/Disabled roots still permit manual ticks. Same-root SubTree uses exclusive containing-tree ownership keyed by entry/alias-chain/epoch. Running and live script iterators retain it, including a terminal yield. Another caller receives Failure until captured-owner cancel/drain/reset finishes. Retarget cleans the OLD target; the same owner can continue its terminal iterator. Ordinary IsTicking=false keeps Session-only maintenance; explicit status-reset/unload clears owned state. Foreign roots and whole-application disposal completion remain separate contracts.
  • IAuraRegistrator - central entity registration service.
  • AuraActionBase<T> - common action base; inspect ExecuteInternal.
  • AuraTriggerBase<T> - common trigger base; inspect CreateTriggerEventSource.

Prefer

  • Use auras/entities.md for registration and factories.
  • Use auras/actions.md for action execution.
  • Use auras/triggers.md for activation/event sources.
  • Use auras/overlays.md for overlay entities.

Search Synonyms

  • aura
  • trigger
  • action
  • overlay
  • aura pack
  • behavior tree
  • script action
  • script trigger
  • lifecycle action
  • enabling condition
  • core/eyeauras-structure.md
  • auras/entities.md
  • auras/actions.md
  • auras/triggers.md
  • auras/overlays.md
  • scripting/runtime.md