How legacydroid/android_packages_apps_luminaai works
LuminaAI is an Android system-overlay assistant: the user opens a fullscreen chat, the session coordinates assistant replies and tool calls, and results appear in the overlay. Its main branches are system tools, persistent memory and resumable history, and the optional Live2D avatar. The README documents capabilities whose detailed wiring was not sampled; those are included only where the documented ownership is clear.
Main entry points: ToolRegistry.kt Tool registry · LuminaSession.kt Assistant session · LuminaOverlayActivity.kt Overlay activity · LuminaRoot.kt Overlay composition
Components 23
Overlay and chat
- Overlay activity
src/com/legacydroid/luminaai/LuminaOverlayActivity.kt - Overlay composition
src/com/legacydroid/luminaai/LuminaRoot.kt - Chat overlay
src/com/legacydroid/luminaai/ui/components/LuminaChatOverlay.kt
Assistant workflow
- Assistant session
src/com/legacydroid/luminaai/LuminaSession.kt - Assistant API
src/com/legacydroid/luminaai/data/LumiApi.kt - Tool registry
src/com/legacydroid/luminaai/data/ToolRegistry.kt
Memory and history
- Chat history
src/com/legacydroid/luminaai/data/HistoryStore.kt - Long-term memory
src/com/legacydroid/luminaai/data/MemoryStore.kt
System capabilities
- Clipboard tools
src/com/legacydroid/luminaai/data/ClipboardTools.kt - Device tools
src/com/legacydroid/luminaai/data/SystemTools.kt - Notification buffer
src/com/legacydroid/luminaai/data/NotificationHub.kt - Local search index
src/com/legacydroid/luminaai/data/LocalSearchIndex.kt - Privacy audit
src/com/legacydroid/luminaai/data/PrivacyAudit.kt
Live2D avatar
- Avatar controller
src/com/legacydroid/luminaai/live2d/Live2DController.kt - Avatar view
src/com/legacydroid/luminaai/live2d/LuminaAvatar.kt - Kotlin JNI bridge
src/com/legacydroid/luminaai/live2d/Live2DBridge.kt - Native JNI bridge
live2d/cpp/JniBridgeC.cpp - Render engine
live2d/cpp/Live2DEngine.cpp - Cubism model
live2d/cpp/SampleModel.cpp - Texture manager
live2d/cpp/LAppTextureManager.cpp
Other components
- User
- Android system
- Assistant service
Connections 30
- User → Overlay activity: opens
- Overlay activity → Overlay composition: hosts
- Overlay activity → Assistant session: awakens
- Overlay composition → Chat overlay: renders
- Chat overlay → Assistant session: sends input
- Assistant session → Assistant API: requests reply
- Assistant API → Assistant service: sends request
- Assistant service → Assistant API: returns reply
- Assistant session → Tool registry: dispatches tools
- Tool registry → Device tools: executes
- Tool registry → Clipboard tools: executes
- Tool registry → Notification buffer: reads
- Tool registry → Local search index: searches
- Tool registry → Privacy audit: audits
- Tool registry → Long-term memory: manages
- Assistant session → Chat history: saves sessions
- Assistant session → Long-term memory: loads memories
- Device tools → Android system: reads and controls
- Clipboard tools → Android system: accesses clipboard
- Notification buffer → Android system: receives notifications
- Local search index → Android system: queries records
- Privacy audit → Android system: checks permissions
- Tool registry → Avatar controller: controls avatar
- Overlay composition → Avatar view: shows avatar
- Avatar view → Avatar controller: drives rendering
- Avatar controller → Kotlin JNI bridge: calls native methods
- Kotlin JNI bridge → Native JNI bridge: invokes JNI
- Native JNI bridge → Render engine: forwards calls
- Render engine → Cubism model: renders and animates
- Cubism model → Texture manager: loads textures