Skip to content

Revise architecture diagram for better representation #66

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
dj-ryan wants to merge 1 commit into from
Closed

Revise architecture diagram for better representation #66

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
84 changes: 48 additions & 36 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -181,42 +181,54 @@ External content passes through multiple security layers:
## Architecture

```
┌────────────────────────────────────────────────────────────────────┐
│ Channels │
│ ┌──────┐ ┌──────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ REPL │ │ HTTP │ │WASM Channels│ │ Web Gateway │ │
│ └──┬───┘ └──┬───┘ └──────┬──────┘ │ (SSE + WS) │ │
│ │ │ │ └──────┬──────┘ │
│ └─────────┴──────────────┴────────────────┘ │
│ │ │
│ ┌─────────▼─────────┐ │
│ │ Agent Loop │ Intent routing │
│ └────┬─────────┬────┘ │
│ │ │ │
│ ┌──────────▼───┐ ┌──▼──────────────┐ │
│ │ Scheduler │ │ Routines Engine │ │
│ │(parallel jobs)│ │(cron, event, wh) │ │
│ └──────┬───────┘ └────────┬─────────┘ │
│ │ │ │
│ ┌─────────────┼───────────────────┘ │
│ │ │ │
│ ┌───▼────┐ ┌────▼────────────────┐ │
│ │ Local │ │ Orchestrator │ │
│ │Workers │ │ ┌───────────────┐ │ │
│ │(in-proc)│ │ │ Docker Sandbox│ │ │
│ └───┬────┘ │ │ Containers │ │ │
│ │ │ │ ┌───────────┐ │ │ │
│ │ │ │ │Worker / CC│ │ │ │
│ │ │ │ └───────────┘ │ │ │
│ │ │ └───────────────┘ │ │
│ │ └─────────┬───────────┘ │
│ └──────────────────┤ │
│ │ │
│ ┌───────────▼──────────┐ │
│ │ Tool Registry │ │
│ │ Built-in, MCP, WASM │ │
│ └──────────────────────┘ │
└────────────────────────────────────────────────────────────────────┘
╭──────╮ ╭──────╮ ╭──────╮ ╭───────────────╮ ╭───────────────╮
│ REPL │ │ HTTP │ │ HTTP │ │ WASM Channels │ │ Web Gateway │
╰──●───╯ ╰──●───╯ ╰──●───╯ ╰───────●───────╯ │ (SSE + WS) │
│ │ │ │ ╰───────●───────╯
│ │ │ │ │
└─────────┴─────────┴──────────┬───┴──────────────────┘
Comment on lines +184 to +189

@gemini-code-assist gemini-code-assist Bot Feb 13, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The architecture diagram has a duplicate HTTP channel. This suggestion removes the duplicate and adjusts the connecting line.

For further improvement, consider reviewing the alignment of all connectors (e.g., for WASM Channels and Web Gateway) to ensure they line up with their corresponding ● symbols, which would enhance the diagram's clarity.

Suggested change
╭──────╮ ╭──────╮ ╭──────╮ ╭───────────────╮ ╭───────────────╮
│ REPL │ │ HTTP │ │ HTTP │ │ WASM Channels │ │ Web Gateway │
╰──●───╯ ╰──●───╯ ╰──●───╯ ╰───────●───────╯ │ (SSE + WS) │
│ │ │ │ ╰───────●───────╯
│ │ │ │ │
└─────────┴─────────┴──────────┬───┴──────────────────┘
╭──────╮ ╭──────╮ ╭───────────────╮ ╭───────────────╮
│ REPL │ │ HTTP │ │ WASM Channels │ │ Web Gateway │
╰──●───╯ ╰──●───╯ ╰───────●───────╯ │ (SSE + WS) │
│ │ │ ╰───────●───────╯
│ │ │ │
└─────────┴────────────────────┬───┴──────────────────┘

│
│
╭────────▼────────╮
│ │
│ Agent Loop │
│ │
╰────────┬────────╯
┌──────────────┴──────────────┐
│ │
╭────────▼────────╮ ╭────────▼────────╮
│ │ │ │
│ Scheduler │ │ Routines Engine │
│ (parallel jobs) │ │(cron, event, wh)│
│ │ │ │
╰────────┬────────╯ ╰────────┬────────╯
│ │
┌─────────┼─────────────────────────────┘
│ └──────────────┐
│ │
│ ╭────────────▼──────────────╮
│ │ Orchestrator │
│ │ │
│ │ ╭───────────────────────╮ │
╭──────▼──────╮ │ │ Docker Sandbox │ │
│ │ │ │ Containers │ │
│Local Workers│ │ │ │ │
│ (in-proc) │ │ │ ╭─────────────────╮ │ │
│ │ │ │ │ │ │ │
╰──────┬──────╯ │ │ │ Worker / CC │ │ │
│ │ │ │ │ │ │
│ │ │ ╰─────────────────╯ │ │
│ │ ╰───────────────────────╯ │
│ ╰─────────────┬─────────────╯
│ │
└─────────────────────────┤
│
╭──────────▼──────────╮
│ │
│ Tool Registry │
│ Built-in, MCP, WASM │
│ │
╰─────────────────────╯
```

### Core Components
Expand Down