OmniClaw

graph TB
    subgraph Input
        V["🎙️ Voice Engine<br/><small>Whisper STT</small>"]
        T["⌨️ Text Input<br/><small>CLI / Web UI</small>"]
    end

    subgraph Core["🧠 Core Intelligence"]
        FP["⚡ Fast-Path Router<br/><small>Regex pattern matching</small>"]
        O["🦀 Orchestrator<br/><small>ReAct Loop</small>"]
        LLM["🤖 Llama 3.1 70B<br/><small>NVIDIA NIM API</small>"]
        INT["🛡️ Intent Interceptor<br/><small>Guardrail Layer</small>"]
    end

    subgraph Tools["🔧 Tool Registry"]
        AID["📱 Intent Dispatcher<br/><small>Gmail, WhatsApp, SMS,<br/>Alarm, Timer, Calendar</small>"]
        UI["🖱️ UI Automation<br/><small>Tap, Type, Navigate</small>"]
        APP["📦 App Launcher<br/><small>Dynamic Package Search</small>"]
        WEB["🌐 Web Search<br/><small>DuckDuckGo</small>"]
        FS["📂 File Tools<br/><small>Search, Push, Install</small>"]
        HW["⌨️ Hardware Keys<br/><small>Back, Home, Enter</small>"]
    end

    subgraph Device["📲 Android Device"]
        ADB["ADB Bridge"]
        PHONE["Phone Screen"]
    end

    V --> FP
    T --> FP
    FP -->|"Known pattern"| AID
    FP -->|"Complex task"| O
    O <-->|"Reason ↔ Act"| LLM
    O --> INT
    INT --> AID
    INT --> UI
    INT --> APP
    INT --> WEB
    INT --> FS
    INT --> HW
    AID --> ADB
    UI --> ADB
    APP --> ADB
    HW --> ADB
    ADB --> PHONE

    style FP fill:#ff6b35,color:#fff
    style O fill:#6c5ce7,color:#fff
    style LLM fill:#0984e3,color:#fff
    style INT fill:#d63031,color:#fff

flowchart LR
    A["🎯 User Goal"] --> B{"⚡ Fast-Path?"}
    B -->|Yes| C["🚀 Intent Dispatch"]
    B -->|No| D["🧠 LLM Thinks"]
    D --> E["📋 JSON Action"]
    E --> F{"🛡️ Interceptor"}
    F -->|Corrected| G["🔧 Execute Tool"]
    F -->|Blocked| D
    G --> H["📤 Tool Result"]
    H --> I{"✅ DONE?"}
    I -->|No| D
    I -->|Yes| J["🏁 Complete"]
    C --> J

graph LR
    subgraph Layer1["Layer 1: Fast-Path"]
        FP["Regex Pattern Match<br/><small>alarm, call, sms, browser,<br/>timer, calendar, WhatsApp</small>"]
    end

    subgraph Layer2["Layer 2: Orchestrator LLM"]
        ORC["Llama 3.1 70B<br/><small>ReAct reasoning loop<br/>Tool selection & arguments</small>"]
    end

    subgraph Layer3["Layer 3: Inner UI LLM"]
        INNER["Llama 3.1 70B<br/><small>Screen understanding<br/>Tap/Type decisions</small>"]
    end

    subgraph Layer4["Layer 4: Evaluator"]
        EVAL["Progress Evaluator<br/><small>On-track assessment<br/>Course correction</small>"]
    end

    FP -->|"Miss"| ORC
    ORC -->|"UI task"| INNER
    ORC -->|"Check progress"| EVAL
    EVAL -->|"Correction"| ORC

    style FP fill:#ff6b35,color:#fff
    style ORC fill:#6c5ce7,color:#fff
    style INNER fill:#0984e3,color:#fff
    style EVAL fill:#00b894,color:#fff

flowchart TD
    LLM["🤖 LLM Output"] --> G1{"🛡️ Guard 1:<br/>Intent Redirect"}
    G1 -->|"LLM tries UI for alarm"| FIX1["→ Redirect to<br/>intent_dispatcher(alarm)"]
    G1 -->|"Pass"| G2{"🛡️ Guard 2:<br/>Package Block"}
    G2 -->|"LLM uses com.samsung.*"| FIX2["→ BLOCKED<br/>Use find_and_launch_app"]
    G2 -->|"Pass"| G3{"🛡️ Guard 3:<br/>Action Block"}
    G3 -->|"Inner LLM tries launch/call"| FIX3["→ BLOCKED<br/>Return DONE"]
    G3 -->|"Pass"| EXEC["✅ Execute Action"]

    style G1 fill:#e17055,color:#fff
    style G2 fill:#d63031,color:#fff
    style G3 fill:#c0392b,color:#fff
    style EXEC fill:#00b894,color:#fff

sequenceDiagram
    actor User
    participant Voice as 🎙️ Voice Engine
    participant FP as ⚡ Fast-Path
    participant Orch as 🧠 Orchestrator
    participant LLM as 🤖 Llama 3.1
    participant Tools as 🔧 Tools
    participant ADB as 📱 ADB
    participant Phone as 📲 Phone

    User->>Voice: "Email alex about SpaceX"
    Voice->>FP: Transcribed text
    FP->>Orch: No fast-path match
    Orch->>LLM: GOAL + System Prompt
    LLM->>Orch: {"tool": "search_web", ...}
    Orch->>Tools: search_web("SpaceX launch")
    Tools-->>Orch: "Starship Flight 10..."
    Orch->>LLM: Tool result + context
    LLM->>Orch: {"tool": "android_intent_dispatcher", ...}
    Orch->>Tools: intent_dispatcher(gmail, ...)
    Tools->>ADB: am start -a SEND ...
    ADB->>Phone: Opens Gmail compose
    Phone-->>Orch: Success
    Orch->>LLM: Intent result
    LLM->>Orch: {"tool": "DONE", ...}
    Orch-->>User: ✅ "Email sent to alex@gmail.com"