# mangi-11/eta architecture

> Architecture diagram of the GitHub repository mangi-11/eta, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mangi-11/eta
- Repository: https://github.com/mangi-11/eta

## Overview

Eta is an Android system-level AI assistant. A task starts in chat or a system-assistant entry, enters the shared runtime, and is coordinated by an agent loop that requests model responses, dispatches tools, and returns results for display or local archiving. Tools span GUI interaction, device APIs, browser, terminal/files, and personal data; Skills and MCP extend tool availability. The README documents these capabilities, while source excerpts are partial, so edges below rely on documented relationships rather than unshown call paths.

Main entry points: [`app/src/main/kotlin/io/github/mangi/eta/agent/model/AgentToolCatalog.kt`](https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/model/AgentToolCatalog.kt) (Tool catalogs), [`app/src/main/kotlin/io/github/mangi/eta/agent/runtime/AgentRuntimeService.kt`](https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/runtime/AgentRuntimeService.kt) (Runtime service), [`app/src/main/kotlin/io/github/mangi/eta/agent/model/AgentModelClient.kt`](https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/model/AgentModelClient.kt) (Agent loop), [`app/src/main/kotlin/io/github/mangi/eta/ui/MainActivity.kt`](https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/ui/MainActivity.kt) (Chat interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User entry"]
  node_chat["Chat interface<br/>[MainActivity.kt]"]
  node_voice["Voice assistant"]
  node_system_hooks["System hooks"]
end

subgraph group_runtime["Agent runtime"]
  node_runtime_service["Runtime service"]
  node_agent_loop["Agent loop"]
  node_provider["Model providers"]
  node_tool_catalog["Tool catalogs"]
end

subgraph group_tools["Task capabilities"]
  node_accessibility["GUI automation"]
  node_device["Device operations"]
  node_browser["Web browser"]
  node_terminal["Terminal and files"]
  node_web["Web search<br/>[AgentWebTools.kt]"]
end

subgraph group_extensions["Extensions and context"]
  node_personal_context["Personal context"]
  node_memory["Long-term memory"]
  node_skills["Skills<br/>[SkillRuntime.kt]"]
  node_mcp["MCP tools"]
  node_roleplay["Character sessions"]
end

subgraph group_platform["Platform and persistence"]
  node_database[("Local database<br/>[EtaDatabase.kt]")]
  node_repositories["Data repositories"]
  node_overlay["Run overlay"]
end

node_user(("User"))
node_model_service(("Model service"))
node_android(("Android device"))

node_user -->|"starts chat"| node_chat
node_user -->|"speaks or types"| node_voice
node_user -->|"invokes entry"| node_system_hooks
node_chat -->|"submits task"| node_runtime_service
node_voice -->|"submits task"| node_runtime_service
node_system_hooks -->|"hands off task"| node_runtime_service
node_runtime_service -->|"runs agent"| node_agent_loop
node_agent_loop -->|"requests response"| node_provider
node_provider -->|"sends request"| node_model_service
node_agent_loop -->|"selects tools"| node_tool_catalog
node_tool_catalog -->|"dispatches GUI"| node_accessibility
node_tool_catalog -->|"dispatches operations"| node_device
node_tool_catalog -->|"dispatches browser"| node_browser
node_tool_catalog -->|"dispatches commands"| node_terminal
node_tool_catalog -->|"dispatches search"| node_web
node_tool_catalog -->|"dispatches retrieval"| node_personal_context
node_tool_catalog -->|"uses memory"| node_memory
node_tool_catalog -->|"loads skills"| node_skills
node_tool_catalog -->|"dispatches MCP"| node_mcp
node_agent_loop -->|"uses character context"| node_roleplay
node_accessibility -->|"observes and acts"| node_android
node_device -->|"reads and controls"| node_android
node_browser -.->|"renders pages"| node_android
node_runtime_service -->|"archives runs"| node_repositories
node_repositories -.->|"persists data"| node_database
node_runtime_service -->|"reports run state"| node_overlay
node_runtime_service -->|"returns events"| node_chat
node_runtime_service -->|"returns events"| node_voice

click node_chat "https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/ui/MainActivity.kt"
click node_voice "https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/voice/EtaAssistantOverlayService.kt"
click node_system_hooks "https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/hook/system/AssistantManager.kt"
click node_runtime_service "https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/runtime/AgentRuntimeService.kt"
click node_agent_loop "https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/model/AgentModelClient.kt"
click node_provider "https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/model/ProviderClientFactory.kt"
click node_tool_catalog "https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/model/AgentToolCatalog.kt"
click node_accessibility "https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/accessibility/AgentAccessibilityService.kt"
click node_device "https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/device/RootShellDeviceController.kt"
click node_browser "https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/browser/AgentBrowserSession.kt"
click node_terminal "https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/terminal/RootShellTerminalController.kt"
click node_web "https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/web/AgentWebTools.kt"
click node_personal_context "https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/context/PersonalContextQueryService.kt"
click node_memory "https://github.com/mangi-11/eta/tree/main/app/src/main/kotlin/io/github/mangi/eta/agent/memory"
click node_skills "https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/skill/SkillRuntime.kt"
click node_mcp "https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/mcp/McpServerManager.kt"
click node_roleplay "https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/roleplay/RoleplayRunContext.kt"
click node_database "https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/data/db/EtaDatabase.kt"
click node_repositories "https://github.com/mangi-11/eta/tree/main/app/src/main/kotlin/io/github/mangi/eta/data/repository"
click node_overlay "https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/overlay/AgentOverlayContent.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_chat,node_voice,node_system_hooks,node_user toneBlue
class node_runtime_service,node_agent_loop,node_provider,node_tool_catalog toneAmber
class node_accessibility,node_device,node_browser,node_terminal,node_web toneMint
class node_personal_context,node_memory,node_skills,node_mcp,node_roleplay toneRose
class node_database,node_repositories,node_overlay,node_model_service,node_android toneIndigo
```

## Components

### User entry

- [Chat interface](https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/ui/MainActivity.kt): `app/src/main/kotlin/io/github/mangi/eta/ui/MainActivity.kt`
- [Voice assistant](https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/voice/EtaAssistantOverlayService.kt): `app/src/main/kotlin/io/github/mangi/eta/agent/voice/EtaAssistantOverlayService.kt`
- [System hooks](https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/hook/system/AssistantManager.kt): `app/src/main/kotlin/io/github/mangi/eta/hook/system/AssistantManager.kt`

### Agent runtime

- [Runtime service](https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/runtime/AgentRuntimeService.kt): `app/src/main/kotlin/io/github/mangi/eta/agent/runtime/AgentRuntimeService.kt`
- [Agent loop](https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/model/AgentModelClient.kt): `app/src/main/kotlin/io/github/mangi/eta/agent/model/AgentModelClient.kt`
- [Model providers](https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/model/ProviderClientFactory.kt): `app/src/main/kotlin/io/github/mangi/eta/agent/model/ProviderClientFactory.kt`
- [Tool catalogs](https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/model/AgentToolCatalog.kt): `app/src/main/kotlin/io/github/mangi/eta/agent/model/AgentToolCatalog.kt`

### Task capabilities

- [GUI automation](https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/accessibility/AgentAccessibilityService.kt): `app/src/main/kotlin/io/github/mangi/eta/agent/accessibility/AgentAccessibilityService.kt`
- [Device operations](https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/device/RootShellDeviceController.kt): `app/src/main/kotlin/io/github/mangi/eta/agent/device/RootShellDeviceController.kt`
- [Web browser](https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/browser/AgentBrowserSession.kt): `app/src/main/kotlin/io/github/mangi/eta/agent/browser/AgentBrowserSession.kt`
- [Terminal and files](https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/terminal/RootShellTerminalController.kt): `app/src/main/kotlin/io/github/mangi/eta/agent/terminal/RootShellTerminalController.kt`
- [Web search](https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/web/AgentWebTools.kt): `app/src/main/kotlin/io/github/mangi/eta/agent/web/AgentWebTools.kt`

### Extensions and context

- [Personal context](https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/context/PersonalContextQueryService.kt): `app/src/main/kotlin/io/github/mangi/eta/agent/context/PersonalContextQueryService.kt`
- [Long-term memory](https://github.com/mangi-11/eta/tree/main/app/src/main/kotlin/io/github/mangi/eta/agent/memory): `app/src/main/kotlin/io/github/mangi/eta/agent/memory`
- [Skills](https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/skill/SkillRuntime.kt): `app/src/main/kotlin/io/github/mangi/eta/agent/skill/SkillRuntime.kt`
- [MCP tools](https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/mcp/McpServerManager.kt): `app/src/main/kotlin/io/github/mangi/eta/agent/mcp/McpServerManager.kt`
- [Character sessions](https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/roleplay/RoleplayRunContext.kt): `app/src/main/kotlin/io/github/mangi/eta/agent/roleplay/RoleplayRunContext.kt`

### Platform and persistence

- [Local database](https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/data/db/EtaDatabase.kt): `app/src/main/kotlin/io/github/mangi/eta/data/db/EtaDatabase.kt`
- [Data repositories](https://github.com/mangi-11/eta/tree/main/app/src/main/kotlin/io/github/mangi/eta/data/repository): `app/src/main/kotlin/io/github/mangi/eta/data/repository`
- [Run overlay](https://github.com/mangi-11/eta/blob/main/app/src/main/kotlin/io/github/mangi/eta/agent/overlay/AgentOverlayContent.kt): `app/src/main/kotlin/io/github/mangi/eta/agent/overlay/AgentOverlayContent.kt`

### Other components

- **User**
- **Model service**
- **Android device**

## Connections

- User → Chat interface: starts chat (evidence: `README.md`)
- User → Voice assistant: speaks or types (evidence: `README.md`)
- User → System hooks: invokes entry (evidence: `README.md`)
- Chat interface → Runtime service: submits task (evidence: `README.md`)
- Voice assistant → Runtime service: submits task (evidence: `app/src/main/kotlin/io/github/mangi/eta/agent/voice/EtaAssistantOverlayService.kt`)
- System hooks → Runtime service: hands off task (evidence: `README.md`)
- Runtime service → Agent loop: runs agent (evidence: `README.md`)
- Agent loop → Model providers: requests response (evidence: `README.md`)
- Model providers → Model service: sends request (evidence: `README.md`)
- Agent loop → Tool catalogs: selects tools (evidence: `README.md`)
- Tool catalogs → GUI automation: dispatches GUI (evidence: `README.md`)
- Tool catalogs → Device operations: dispatches operations (evidence: `README.md`)
- Tool catalogs → Web browser: dispatches browser (evidence: `README.md`)
- Tool catalogs → Terminal and files: dispatches commands (evidence: `README.md`)
- Tool catalogs → Web search: dispatches search (evidence: `README.md`)
- Tool catalogs → Personal context: dispatches retrieval (evidence: `README.md`)
- Tool catalogs → Long-term memory: uses memory (evidence: `README.md`)
- Tool catalogs → Skills: loads skills (evidence: `README.md`)
- Tool catalogs → MCP tools: dispatches MCP (evidence: `README.md`)
- Agent loop → Character sessions: uses character context (evidence: `README.md`)
- GUI automation → Android device: observes and acts (evidence: `README.md`)
- Device operations → Android device: reads and controls (evidence: `README.md`)
- Web browser → Android device: renders pages
- Runtime service → Data repositories: archives runs (evidence: `README.md`)
- Data repositories → Local database: persists data (evidence: `app/src/main/kotlin/io/github/mangi/eta/data/repository/CharacterRepository.kt`)
- Runtime service → Run overlay: reports run state (evidence: `README.md`)
- Runtime service → Chat interface: returns events (evidence: `README.md`)
- Runtime service → Voice assistant: returns events (evidence: `app/src/main/kotlin/io/github/mangi/eta/agent/voice/EtaAssistantOverlayService.kt`)
