Architecture
Service Layer
The Service Layer contains the core business logic and orchestration components of Arif AI.
Components
Tool Manager
Discovers tools via MCP, caches their schemas, and executes them with input validation and permission checks.
Conversation Manager
Handles conversation persistence, history retrieval, and archival. Manages message versioning and context auto-summarization for long conversations.
Onboarding Engine
Manages the smart onboarding flow — session state, question sequencing, answer validation, and configuration generation.
Token Manager
Enforces per-user token quotas with role-based tiers. Tracks input and output token consumption for every API call.
Analytics Service
Collects metrics on tool usage, response times, and token consumption. Provides usage data for monitoring dashboards.
Integration Connectors
| Connector | Purpose |
|---|---|
| MCP Client | Dynamic tool discovery via Model Context Protocol |
| RAG Client | Semantic search for knowledge base queries |
| Mjara Drive | File management and versioning |