# AI Agent Architecture Diagrams

## System Context Diagram
```mermaid
graph TD
    A[AI Agent System] -->|CLI Commands\nHTTP Requests| B[End User]
    A -->|API Calls| C[Home Automation System]
    A -->|Calendar API| D[Calendar Services]
    A -->|Docker API| E[Infrastructure]
    A -->|MCP Protocol| F[MCP Providers]
```

## Container Diagram
```mermaid
graph TD
    A[AI Agent] --> B[Orchestrator]
    A --> C[MCP Manager]
    A --> D[CLI Interface]
    A --> E[Web Interface]
    A --> F[Persistent Storage]
    A --> G[External Integrations]
    
    B -->|Task Delegation| C
    B -->|Configuration| F
    C -->|Service Discovery| G
    D -->|Command Execution| B
    E -->|API Calls| B
```

## Core Orchestrator Component Diagram
```mermaid
graph TD
    A[Task Dispatcher] --> B[Role Manager]
    A --> C[Tool Registry]
    A --> D[Memory Controller]
    B --> E[RBAC Engine]
    C --> F[Plugin Loader]
    D --> G[SQLite Adapter]
    D --> H[PostgreSQL Adapter]
    
    style A fill:#f9f,stroke:#333
    style B fill:#ccf,stroke:#333
    style C fill:#cfc,stroke:#333