# wilkessidney/ai-worker-suite architecture

> Architecture diagram of the GitHub repository wilkessidney/ai-worker-suite, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wilkessidney/ai-worker-suite
- Repository: https://github.com/wilkessidney/ai-worker-suite

## Overview

The tree contains two substantial products: WebDataScope, a WorldQuant Brain browser extension with community, AI, session, memo, sharing, and telemetry features; and a separate Python AIWorker/simulation workspace. The WebDataScope workflow is represented by its content/UI surfaces, background services, and sharing or telemetry workers. Python filenames indicate project setup, model configuration, knowledge-base creation, and simulation allocation, but no README or excerpts establish their runtime call sequence. Edges therefore show only relationships supported by indexed references or excerpts; unsampled feature connections are omitted.

Main entry points: [`WebDataScope-1.7.3/src/background/services/storageService.js`](https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/src/background/services/storageService.js) (Extension Storage), [`WebDataScope-1.7.3/src/background/services/supportCommunityService.js`](https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/src/background/services/supportCommunityService.js) (Community Service), [`WebDataScope-1.7.3/pnl-share-worker/src/index.js`](https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/pnl-share-worker/src/index.js) (PnL Share API), [`WebDataScope-1.7.3/telemetry-worker/src/index.js`](https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/telemetry-worker/src/index.js) (Telemetry API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_extension["Browser Extension"]
  node_platform_ui["Platform Features<br/>[platform]"]
  node_community_ui["Community Features<br/>[support]"]
  node_sidebar["Sidebar UI<br/>[sidebar]"]
  node_popup["Popup UI<br/>[popup.js]"]
  node_data_store[("Shared Data Store<br/>[dataStore.js]")]
end

subgraph group_services["Background Services"]
  node_background["Extension Runtime<br/>[background.js]"]
  node_community_service["Community Service"]
  node_llm["LLM Service<br/>[llmService.js]"]
  node_storage[("Extension Storage<br/>[storageService.js]")]
  node_session["Session Keeper"]
  node_memo["Product Memo<br/>[prodMemoService.js]"]
  node_pnl_service["PnL Sharing Service<br/>[pnlShareService.js]"]
  node_telemetry_service["Telemetry Service"]
end

subgraph group_workers["Cloud Workers"]
  node_pnl_worker["PnL Share API<br/>[index.js]"]
  node_pnl_admin["Sharing Admin<br/>[admin.js]"]
  node_pnl_crypto["Sharing Crypto<br/>[crypto.js]"]
  node_pnl_validation["Sharing Validation<br/>[validation.js]"]
  node_telemetry_worker["Telemetry API<br/>[index.js]"]
  node_telemetry_admin["Telemetry Admin<br/>[admin.js]"]
  node_telemetry_registration["Registration<br/>[registration.js]"]
  node_telemetry_crypto["Telemetry Crypto<br/>[crypto.js]"]
end

subgraph group_aiworker["AIWorker Workspace"]
  node_project_setup["Project Setup"]
  node_model_config["Model Configuration"]
  node_knowledge_base["Knowledge Base"]
  node_allocator["Osmosis Allocator"]
  node_platform_functions["Platform Functions"]
  node_app_main["Application Entry<br/>[main.py]"]
  node_control_store[("Control Store<br/>[control_store.py]")]
  node_root_allocator["Allocator Module"]
end

node_brain_user(("Brain User"))
node_aiworker_user(("AIWorker Operator"))

node_community_service -->|"calls"| node_llm
node_community_service -->|"reads and writes"| node_storage
node_llm -->|"reads and writes"| node_storage
node_session -->|"reads and writes"| node_storage
node_pnl_worker -->|"uses crypto"| node_pnl_crypto
node_pnl_worker -->|"validates requests"| node_pnl_validation
node_pnl_admin -->|"uses crypto"| node_pnl_crypto
node_telemetry_worker -->|"dispatches to"| node_telemetry_admin
node_telemetry_worker -->|"dispatches to"| node_telemetry_registration
node_telemetry_admin -->|"uses crypto"| node_telemetry_crypto
node_telemetry_registration -->|"uses crypto"| node_telemetry_crypto

click node_platform_ui "https://github.com/wilkessidney/ai-worker-suite/tree/main/WebDataScope-1.7.3/src/content/platform"
click node_community_ui "https://github.com/wilkessidney/ai-worker-suite/tree/main/WebDataScope-1.7.3/src/content/support"
click node_sidebar "https://github.com/wilkessidney/ai-worker-suite/tree/main/WebDataScope-1.7.3/src/ui/sidebar"
click node_popup "https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/src/ui/popup/popup.js"
click node_data_store "https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/src/shared/dataStore.js"
click node_background "https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/src/background/background.js"
click node_community_service "https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/src/background/services/supportCommunityService.js"
click node_llm "https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/src/background/services/llmService.js"
click node_storage "https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/src/background/services/storageService.js"
click node_session "https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/src/background/services/sessionKeeperService.js"
click node_memo "https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/src/background/services/prodMemoService.js"
click node_pnl_service "https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/src/background/services/pnlShareService.js"
click node_telemetry_service "https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/src/background/services/telemetryService.js"
click node_pnl_worker "https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/pnl-share-worker/src/index.js"
click node_pnl_admin "https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/pnl-share-worker/src/admin.js"
click node_pnl_crypto "https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/pnl-share-worker/src/crypto.js"
click node_pnl_validation "https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/pnl-share-worker/src/validation.js"
click node_telemetry_worker "https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/telemetry-worker/src/index.js"
click node_telemetry_admin "https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/telemetry-worker/src/admin.js"
click node_telemetry_registration "https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/telemetry-worker/src/registration.js"
click node_telemetry_crypto "https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/telemetry-worker/src/crypto.js"
click node_project_setup "https://github.com/wilkessidney/ai-worker-suite/blob/main/AIWorker_MacLinux/Step1_init_project_files.py"
click node_model_config "https://github.com/wilkessidney/ai-worker-suite/blob/main/AIWorker_MacLinux/Step4_SetAPI_And_Check_LLMModel.py"
click node_knowledge_base "https://github.com/wilkessidney/ai-worker-suite/blob/main/AIWorker_MacLinux/Step5_create_knowledge_base.py"
click node_allocator "https://github.com/wilkessidney/ai-worker-suite/blob/main/AIWorker/Step6_osmosis_allocator.py"
click node_platform_functions "https://github.com/wilkessidney/ai-worker-suite/blob/main/AIWorker/platform_functions.py"
click node_app_main "https://github.com/wilkessidney/ai-worker-suite/blob/main/main.py"
click node_control_store "https://github.com/wilkessidney/ai-worker-suite/blob/main/control_store.py"
click node_root_allocator "https://github.com/wilkessidney/ai-worker-suite/blob/main/osmosis_allocator.py"

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_platform_ui,node_community_ui,node_sidebar,node_popup,node_data_store,node_brain_user toneBlue
class node_background,node_community_service,node_llm,node_storage,node_session,node_memo,node_pnl_service,node_telemetry_service toneAmber
class node_pnl_worker,node_pnl_admin,node_pnl_crypto,node_pnl_validation,node_telemetry_worker,node_telemetry_admin,node_telemetry_registration,node_telemetry_crypto toneMint
class node_project_setup,node_model_config,node_knowledge_base,node_allocator,node_platform_functions,node_app_main,node_control_store,node_root_allocator,node_aiworker_user toneRose
```

## Components

### Browser Extension

- [Platform Features](https://github.com/wilkessidney/ai-worker-suite/tree/main/WebDataScope-1.7.3/src/content/platform): `WebDataScope-1.7.3/src/content/platform`
- [Community Features](https://github.com/wilkessidney/ai-worker-suite/tree/main/WebDataScope-1.7.3/src/content/support): `WebDataScope-1.7.3/src/content/support`
- [Sidebar UI](https://github.com/wilkessidney/ai-worker-suite/tree/main/WebDataScope-1.7.3/src/ui/sidebar): `WebDataScope-1.7.3/src/ui/sidebar`
- [Popup UI](https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/src/ui/popup/popup.js): `WebDataScope-1.7.3/src/ui/popup/popup.js`
- [Shared Data Store](https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/src/shared/dataStore.js): `WebDataScope-1.7.3/src/shared/dataStore.js`

### Background Services

- [Extension Runtime](https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/src/background/background.js): `WebDataScope-1.7.3/src/background/background.js`
- [Community Service](https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/src/background/services/supportCommunityService.js): `WebDataScope-1.7.3/src/background/services/supportCommunityService.js`
- [LLM Service](https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/src/background/services/llmService.js): `WebDataScope-1.7.3/src/background/services/llmService.js`
- [Extension Storage](https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/src/background/services/storageService.js): `WebDataScope-1.7.3/src/background/services/storageService.js`
- [Session Keeper](https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/src/background/services/sessionKeeperService.js): `WebDataScope-1.7.3/src/background/services/sessionKeeperService.js`
- [Product Memo](https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/src/background/services/prodMemoService.js): `WebDataScope-1.7.3/src/background/services/prodMemoService.js`
- [PnL Sharing Service](https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/src/background/services/pnlShareService.js): `WebDataScope-1.7.3/src/background/services/pnlShareService.js`
- [Telemetry Service](https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/src/background/services/telemetryService.js): `WebDataScope-1.7.3/src/background/services/telemetryService.js`

### Cloud Workers

- [PnL Share API](https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/pnl-share-worker/src/index.js): `WebDataScope-1.7.3/pnl-share-worker/src/index.js`
- [Sharing Admin](https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/pnl-share-worker/src/admin.js): `WebDataScope-1.7.3/pnl-share-worker/src/admin.js`
- [Sharing Crypto](https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/pnl-share-worker/src/crypto.js): `WebDataScope-1.7.3/pnl-share-worker/src/crypto.js`
- [Sharing Validation](https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/pnl-share-worker/src/validation.js): `WebDataScope-1.7.3/pnl-share-worker/src/validation.js`
- [Telemetry API](https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/telemetry-worker/src/index.js): `WebDataScope-1.7.3/telemetry-worker/src/index.js`
- [Telemetry Admin](https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/telemetry-worker/src/admin.js): `WebDataScope-1.7.3/telemetry-worker/src/admin.js`
- [Registration](https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/telemetry-worker/src/registration.js): `WebDataScope-1.7.3/telemetry-worker/src/registration.js`
- [Telemetry Crypto](https://github.com/wilkessidney/ai-worker-suite/blob/main/WebDataScope-1.7.3/telemetry-worker/src/crypto.js): `WebDataScope-1.7.3/telemetry-worker/src/crypto.js`

### AIWorker Workspace

- [Project Setup](https://github.com/wilkessidney/ai-worker-suite/blob/main/AIWorker_MacLinux/Step1_init_project_files.py): `AIWorker_MacLinux/Step1_init_project_files.py`
- [Model Configuration](https://github.com/wilkessidney/ai-worker-suite/blob/main/AIWorker_MacLinux/Step4_SetAPI_And_Check_LLMModel.py): `AIWorker_MacLinux/Step4_SetAPI_And_Check_LLMModel.py`
- [Knowledge Base](https://github.com/wilkessidney/ai-worker-suite/blob/main/AIWorker_MacLinux/Step5_create_knowledge_base.py): `AIWorker_MacLinux/Step5_create_knowledge_base.py`
- [Osmosis Allocator](https://github.com/wilkessidney/ai-worker-suite/blob/main/AIWorker/Step6_osmosis_allocator.py): `AIWorker/Step6_osmosis_allocator.py`
- [Platform Functions](https://github.com/wilkessidney/ai-worker-suite/blob/main/AIWorker/platform_functions.py): `AIWorker/platform_functions.py`
- [Application Entry](https://github.com/wilkessidney/ai-worker-suite/blob/main/main.py): `main.py`
- [Control Store](https://github.com/wilkessidney/ai-worker-suite/blob/main/control_store.py): `control_store.py`
- [Allocator Module](https://github.com/wilkessidney/ai-worker-suite/blob/main/osmosis_allocator.py): `osmosis_allocator.py`

### Other components

- **Brain User**
- **AIWorker Operator**

## Connections

- Community Service → LLM Service: calls (evidence: `WebDataScope-1.7.3/src/background/services/supportCommunityService.js`)
- Community Service → Extension Storage: reads and writes (evidence: `WebDataScope-1.7.3/src/background/services/supportCommunityService.js`)
- LLM Service → Extension Storage: reads and writes (evidence: `WebDataScope-1.7.3/src/background/services/llmService.js`)
- Session Keeper → Extension Storage: reads and writes (evidence: `WebDataScope-1.7.3/src/background/services/sessionKeeperService.js`)
- PnL Share API → Sharing Crypto: uses crypto (evidence: `WebDataScope-1.7.3/pnl-share-worker/src/index.js`)
- PnL Share API → Sharing Validation: validates requests (evidence: `WebDataScope-1.7.3/pnl-share-worker/src/index.js`)
- Sharing Admin → Sharing Crypto: uses crypto (evidence: `WebDataScope-1.7.3/pnl-share-worker/src/admin.js`)
- Telemetry API → Telemetry Admin: dispatches to (evidence: `WebDataScope-1.7.3/telemetry-worker/src/index.js`)
- Telemetry API → Registration: dispatches to (evidence: `WebDataScope-1.7.3/telemetry-worker/src/index.js`)
- Telemetry Admin → Telemetry Crypto: uses crypto (evidence: `WebDataScope-1.7.3/telemetry-worker/src/admin.js`)
- Registration → Telemetry Crypto: uses crypto (evidence: `WebDataScope-1.7.3/telemetry-worker/src/registration.js`)