# viztrrx/donnajbesaints architecture

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

- Interactive diagram: https://gitdiagram.com/viztrrx/donnajbesaints
- Repository: https://github.com/viztrrx/donnajbesaints

## Overview

Agent Console is an injectable floating assistant for the current web page, with an optional Cloudflare Worker providing API proxying and account/admin services. The main workflow starts when a visitor injects the console, uses page context or a tool, and receives AI or interactive results. README capabilities are represented as product branches; source excerpts are partial, so internal links not demonstrated there are omitted.

Main entry points: [`backup.js`](https://github.com/viztrrx/donnajbesaints/blob/main/backup.js) (Assistant panel), [`worker.js`](https://github.com/viztrrx/donnajbesaints/blob/main/worker.js) (Worker API), [`eaglercraft/loader/bridge.js`](https://github.com/viztrrx/donnajbesaints/blob/main/eaglercraft/loader/bridge.js) (Eaglercraft bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_console["Browser console"]
  node_panel["Assistant panel<br/>[backup.js]"]
  node_localdata[("Browser storage<br/>[backup.js]")]
end

subgraph group_tools["Page tools"]
  node_insights["Page insights<br/>[backup.js]"]
  node_quiz["Quiz and tutor<br/>[backup.js]"]
  node_study["Study tools<br/>[backup.js]"]
  node_notes["Notes and memory<br/>[backup.js]"]
  node_writing["Writing tools<br/>[backup.js]"]
  node_browse["Browse and automate<br/>[backup.js]"]
  node_music["Music player<br/>[backup.js]"]
  node_games["Games<br/>[backup.js]"]
end

subgraph group_worker["Worker services"]
  node_workerapi["Worker API<br/>[worker.js]"]
  node_accounts["Accounts and sessions<br/>[worker.js]"]
  node_admin["Admin and moderation<br/>[worker.js]"]
  node_telemetry[("Usage and security<br/>[worker.js]")]
end

subgraph group_game["Eaglercraft"]
  node_eagler["Eaglercraft bridge<br/>[bridge.js]"]
end

node_visitor(("Page visitor"))
node_page["Current page"]
node_ai{{"AI provider"}}
node_kv[("Cloudflare KV")]
node_youtube{{"YouTube API"}}
node_client["Eaglercraft client"]

node_visitor -->|"injects"| node_panel
node_panel -->|"offers"| node_insights
node_panel -->|"offers"| node_quiz
node_panel -->|"offers"| node_study
node_panel -->|"offers"| node_notes
node_panel -->|"offers"| node_writing
node_panel -->|"offers"| node_browse
node_panel -->|"offers"| node_music
node_panel -->|"offers"| node_games
node_insights -->|"reads"| node_page
node_quiz -->|"reads"| node_page
node_browse -->|"acts on"| node_page
node_panel -->|"stores keys"| node_localdata
node_insights -->|"asks"| node_ai
node_quiz -->|"asks"| node_ai
node_writing -.->|"asks"| node_ai
node_music -->|"searches"| node_youtube
node_panel -.->|"proxies requests"| node_workerapi
node_workerapi -.->|"forwards requests"| node_ai
node_workerapi -->|"routes auth"| node_accounts
node_workerapi -->|"routes admin"| node_admin
node_workerapi -->|"records usage"| node_telemetry
node_accounts -->|"reads and writes"| node_kv
node_telemetry -->|"reads and writes"| node_kv
node_admin -->|"reads and writes"| node_kv
node_eagler -->|"loads and starts"| node_client
node_eagler -.->|"served by"| node_workerapi

click node_panel "https://github.com/viztrrx/donnajbesaints/blob/main/backup.js"
click node_insights "https://github.com/viztrrx/donnajbesaints/blob/main/backup.js"
click node_quiz "https://github.com/viztrrx/donnajbesaints/blob/main/backup.js"
click node_study "https://github.com/viztrrx/donnajbesaints/blob/main/backup.js"
click node_notes "https://github.com/viztrrx/donnajbesaints/blob/main/backup.js"
click node_writing "https://github.com/viztrrx/donnajbesaints/blob/main/backup.js"
click node_browse "https://github.com/viztrrx/donnajbesaints/blob/main/backup.js"
click node_music "https://github.com/viztrrx/donnajbesaints/blob/main/backup.js"
click node_games "https://github.com/viztrrx/donnajbesaints/blob/main/backup.js"
click node_localdata "https://github.com/viztrrx/donnajbesaints/blob/main/backup.js"
click node_workerapi "https://github.com/viztrrx/donnajbesaints/blob/main/worker.js"
click node_accounts "https://github.com/viztrrx/donnajbesaints/blob/main/worker.js"
click node_admin "https://github.com/viztrrx/donnajbesaints/blob/main/worker.js"
click node_telemetry "https://github.com/viztrrx/donnajbesaints/blob/main/worker.js"
click node_eagler "https://github.com/viztrrx/donnajbesaints/blob/main/eaglercraft/loader/bridge.js"

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_panel,node_localdata,node_client toneBlue
class node_insights,node_quiz,node_study,node_notes,node_writing,node_browse,node_music,node_games,node_kv toneAmber
class node_workerapi,node_accounts,node_admin,node_telemetry,node_youtube toneMint
class node_eagler toneRose
class node_visitor,node_page,node_ai toneIndigo
```

## Components

### Browser console

- [Assistant panel](https://github.com/viztrrx/donnajbesaints/blob/main/backup.js): `backup.js`
- [Browser storage](https://github.com/viztrrx/donnajbesaints/blob/main/backup.js): `backup.js`

### Page tools

- [Page insights](https://github.com/viztrrx/donnajbesaints/blob/main/backup.js): `backup.js`
- [Quiz and tutor](https://github.com/viztrrx/donnajbesaints/blob/main/backup.js): `backup.js`
- [Study tools](https://github.com/viztrrx/donnajbesaints/blob/main/backup.js): `backup.js`
- [Notes and memory](https://github.com/viztrrx/donnajbesaints/blob/main/backup.js): `backup.js`
- [Writing tools](https://github.com/viztrrx/donnajbesaints/blob/main/backup.js): `backup.js`
- [Browse and automate](https://github.com/viztrrx/donnajbesaints/blob/main/backup.js): `backup.js`
- [Music player](https://github.com/viztrrx/donnajbesaints/blob/main/backup.js): `backup.js`
- [Games](https://github.com/viztrrx/donnajbesaints/blob/main/backup.js): `backup.js`

### Worker services

- [Worker API](https://github.com/viztrrx/donnajbesaints/blob/main/worker.js): `worker.js`
- [Accounts and sessions](https://github.com/viztrrx/donnajbesaints/blob/main/worker.js): `worker.js`
- [Admin and moderation](https://github.com/viztrrx/donnajbesaints/blob/main/worker.js): `worker.js`
- [Usage and security](https://github.com/viztrrx/donnajbesaints/blob/main/worker.js): `worker.js`

### Eaglercraft

- [Eaglercraft bridge](https://github.com/viztrrx/donnajbesaints/blob/main/eaglercraft/loader/bridge.js): `eaglercraft/loader/bridge.js`

### Other components

- **Page visitor**
- **Current page**
- **AI provider**
- **Cloudflare KV**
- **YouTube API**
- **Eaglercraft client**

## Connections

- Page visitor → Assistant panel: injects (evidence: `README.md`)
- Assistant panel → Page insights: offers (evidence: `README.md`)
- Assistant panel → Quiz and tutor: offers (evidence: `README.md`)
- Assistant panel → Study tools: offers (evidence: `README.md`)
- Assistant panel → Notes and memory: offers (evidence: `README.md`)
- Assistant panel → Writing tools: offers (evidence: `README.md`)
- Assistant panel → Browse and automate: offers (evidence: `README.md`)
- Assistant panel → Music player: offers (evidence: `README.md`)
- Assistant panel → Games: offers (evidence: `README.md`)
- Page insights → Current page: reads (evidence: `README.md`)
- Quiz and tutor → Current page: reads (evidence: `README.md`)
- Browse and automate → Current page: acts on (evidence: `README.md`)
- Assistant panel → Browser storage: stores keys (evidence: `README.md`)
- Page insights → AI provider: asks (evidence: `README.md`)
- Quiz and tutor → AI provider: asks (evidence: `README.md`)
- Writing tools → AI provider: asks (evidence: `README.md`)
- Music player → YouTube API: searches (evidence: `README.md`)
- Assistant panel → Worker API: proxies requests (evidence: `README.md`)
- Worker API → AI provider: forwards requests (evidence: `README.md`)
- Worker API → Accounts and sessions: routes auth (evidence: `worker.js`)
- Worker API → Admin and moderation: routes admin (evidence: `worker.js`)
- Worker API → Usage and security: records usage (evidence: `worker.js`)
- Accounts and sessions → Cloudflare KV: reads and writes (evidence: `worker.js`)
- Usage and security → Cloudflare KV: reads and writes (evidence: `worker.js`)
- Admin and moderation → Cloudflare KV: reads and writes (evidence: `worker.js`)
- Eaglercraft bridge → Eaglercraft client: loads and starts (evidence: `eaglercraft/loader/bridge.js`)
- Eaglercraft bridge → Worker API: served by (evidence: `eaglercraft/loader/bridge.js`)
