graph TB
    subgraph Browser["Browser (React 19 + Vite 7)"]
        CK["CopilotKit Provider"]
        Dashboard["Dashboard UI"]
        MockDB["Mock Database<br/>(in-memory NoSQL)"]
        EB["Event Bus<br/>(BroadcastChannel)"]
        
        CK -->|"useCopilotAction<br/>useCopilotReadable"| Dashboard
        Dashboard -->|"subscribe() / CRUD"| MockDB
        EB -->|"ui:switchView<br/>ui:selectEmail"| Dashboard
    end

    subgraph Vite["Vite Dev Server"]
        Proxy["Reverse Proxy<br/>/v1/clawg-ui → :18789"]
        InfoStub["Info Stub Middleware<br/>/v1/clawg-ui/info"]
    end

    subgraph OpenClaw["OpenClaw Gateway (localhost:18789)"]
        ClawGUI["ClawGUI Plugin<br/>(@contextableai/clawg-ui)"]
        Router["Task Router"]
        State["State Manager"]
        LLM["LLM Provider"]
        
        ClawGUI --> Router
        Router --> State
        Router --> LLM
    end

    CK -->|"POST /v1/clawg-ui<br/>Bearer token auth"| Proxy
    Proxy -->|"Forward"| ClawGUI
    ClawGUI -->|"SSE stream<br/>(AG-UI events)"| CK

sequenceDiagram
    participant User
    participant Chat as Chat Panel
    participant CK as CopilotKit
    participant Proxy as Vite Proxy
    participant CG as ClawGUI
    participant OC as OpenClaw Agent

    User->>Chat: "Add a task to follow up with Jessica"
    Chat->>CK: sendMessage({ role: user, content })
    CK->>Proxy: POST /v1/clawg-ui (tools + context + messages)
    Proxy->>CG: Forward with Bearer auth
    CG->>OC: Route to agent with MsgContext
    OC->>CG: Tool call: createtask(...)
    CG-->>CK: SSE: TOOL_CALL_START → ARGS → END
    CK->>Chat: Execute client handler
    Note over Chat: db.collection('tasks').add(...)
    Note over Chat: subscribe() fires → UI re-renders
    OC->>CG: Text: "Done — added follow-up task"
    CG-->>CK: SSE: TEXT_MESSAGE_START → CONTENT → END
    CK->>Chat: Render assistant message

graph LR
    subgraph Tools["Client Tools (useCopilotAction)"]
        direction TB
        Nav["Navigation"]
        Email["Email"]
        Cal["Calendar"]
        Task["Tasks"]
    end

    subgraph NavTools["switchworkspace<br/>selectemail"]
    end
    subgraph EmailTools["sendemail<br/>markemailread<br/>staremail"]
    end
    subgraph CalTools["createcalendarevent<br/>updatecalendarevent<br/>deletecalendarevent"]
    end
    subgraph TaskTools["createtask<br/>updatetask<br/>deletetask"]
    end

    Nav --> NavTools
    Email --> EmailTools
    Cal --> CalTools
    Task --> TaskTools

    NavTools -->|"eventBus.emit()"| UI["Dashboard Views"]
    EmailTools -->|"db.collection('inbox')"| DB["Mock DB"]
    CalTools -->|"db.collection('calendar')"| DB
    TaskTools -->|"db.collection('tasks')"| DB
    DB -->|"subscribe() callback"| UI

graph TD
    subgraph Collections["Mock DB Collections"]
        inbox["inbox"]
        calendar["calendar"]
        tasks["tasks"]
        clients["clients"]
        briefs["dailyBriefs"]
        invoices["invoices"]
    end

    subgraph Subscriptions["useState + subscribe()"]
        sInbox["setInboxEmails"]
        sCal["setCalendarEvents"]
        sTask["setTasks"]
        sClient["setClients"]
        sBrief["setBriefs"]
        sInv["setInvoices"]
    end

    subgraph Derived["useMemo — Derived Display Data"]
        mockEmails["mockEmails"]
        mockSchedule["mockSchedule"]
        todoItems["todoItems"]
        mockClients["mockClients"]
        dailyBrief["dailyBrief"]
        invoiceDetails["mockInvoiceDetails"]
    end

    inbox --> sInbox --> mockEmails
    calendar --> sCal --> mockSchedule
    tasks --> sTask --> todoItems
    clients --> sClient --> mockClients
    briefs --> sBrief --> dailyBrief
    invoices --> sInv --> invoiceDetails

sequenceDiagram
    participant FE as ChiefClaw Frontend
    participant CG as ClawGUI (port 18789)
    participant GW as OpenClaw Gateway

    FE->>CG: POST /v1/clawg-ui (no auth)
    CG-->>FE: 403 { pairingCode, token }
    Note over FE: User copies pairingCode
    FE->>GW: openclaw pairing approve clawg-ui <code>
    GW->>CG: Device approved
    FE->>CG: POST /v1/clawg-ui (Bearer token)
    CG-->>FE: 200 SSE stream