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.IsLoadedis 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; inspectExecuteInternal.AuraTriggerBase<T>- common trigger base; inspectCreateTriggerEventSource.
Prefer
- Use
auras/entities.mdfor registration and factories. - Use
auras/actions.mdfor action execution. - Use
auras/triggers.mdfor activation/event sources. - Use
auras/overlays.mdfor overlay entities.
Search Synonyms
- aura
- trigger
- action
- overlay
- aura pack
- behavior tree
- script action
- script trigger
- lifecycle action
- enabling condition
Related Maps
core/eyeauras-structure.mdauras/entities.mdauras/actions.mdauras/triggers.mdauras/overlays.mdscripting/runtime.md