From 62151e79081c99187d38d17c30cdde918870d058 Mon Sep 17 00:00:00 2001 From: technical-writer Date: Tue, 2 Jun 2026 12:21:23 -0700 Subject: [PATCH 1/2] docs(architecture): replace hand-drawn ASCII System Boundaries with the real SVG diagram MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The deep /docs/architecture/architecture 'System Architecture' page still rendered the old hand-drawn ASCII System Boundaries diagram, while the main /docs/architecture page (and home/concepts) use the proper SVG. Replaced the ASCII block with the same SVG embed for consistency (and it carries the corrected CP/tenant split + animated section reveal). Renamed the file .md → .mdx so the JSX renders identically to the other embeds; URL /docs/architecture/architecture unchanged. Kept the page's unique Plugins tree, Data Flow Summary, Folder Structure, and Related Docs sections. Build green; page now embeds the SVG (ASCII 'Go (gin) backend' block gone). Co-Authored-By: Claude Opus 4.8 (1M context) --- .../{architecture.md => architecture.mdx} | 35 ++++--------------- 1 file changed, 6 insertions(+), 29 deletions(-) rename content/docs/architecture/{architecture.md => architecture.mdx} (60%) diff --git a/content/docs/architecture/architecture.md b/content/docs/architecture/architecture.mdx similarity index 60% rename from content/docs/architecture/architecture.md rename to content/docs/architecture/architecture.mdx index ef9cbaa..073b596 100644 --- a/content/docs/architecture/architecture.md +++ b/content/docs/architecture/architecture.mdx @@ -10,36 +10,13 @@ The platform is fully distributed — workspaces can run on different machines a ## System Boundaries -The platform consists of four distinct systems: +Operator surfaces reach a thin central control plane that provisions one isolated tenant per org; each tenant runs its own control core (the `workspace-server`, with its own Postgres + Redis) above a hierarchy of workspaces. Runtimes and model providers are pluggable: -``` -+-----------------------------------------------------------+ -| canvas/ Next.js 15 frontend | -| React Flow visual canvas, Zustand state, WebSocket | -+-----------------------------+-----------------------------+ - | HTTP + WebSocket -+-----------------------------v-----------------------------+ -| workspace-server/ Go (gin) backend | -| Registry, hierarchy, event log, provisioner, bundles | -+------+---------------------------------------+------------+ - | Postgres | Redis -+------v------+ +---------v---------+ -| Postgres | | Redis | -| (Docker) | | (Docker) | -+-------------+ +-------------------+ - - A2A HTTP (JSON-RPC 2.0) — direct workspace-to-workspace -+-----------------------------------------------------------+ -| workspace/ pluggable workspace runtime | -| LangGraph / Claude Code / AutoGen / OpenClaw / Hermes | -| / Codex / Google ADK + a2a-sdk | -+-----------------------------------------------------------+ - | -+------v----------------------------------------------------+ -| Langfuse Observability (Docker) | -| Traces every LLM call across all workspaces | -+-----------------------------------------------------------+ -``` +Molecule AI platform architecture: operator surfaces reach a thin central Control Plane (orgs, billing, tenant provisioning, LLM proxy, provider registry) that provisions one isolated tenant per org. Each tenant runs its own control core — the workspace-server with provisioner, registry/discovery, A2A proxy, WebSocket hub, scheduler, secrets, audit, and its own Postgres + Redis — above a hierarchy of workspaces, each one agent on its own machine, communicating peer-to-peer over A2A. Runtimes (claude-code, langgraph, autogen, openclaw, hermes, codex, google-adk) and model providers are pluggable. ### Plugins -- 2.52.0 From e4c0e4657342458d2a6ddee05ebae9d194b12b9e Mon Sep 17 00:00:00 2001 From: technical-writer Date: Tue, 2 Jun 2026 12:22:30 -0700 Subject: [PATCH 2/2] =?UTF-8?q?fix:=20MDX-safe=20arrows=20in=20Data=20Flow?= =?UTF-8?q?=20Summary=20(.md=E2=86=92.mdx=20broke=20<->=20as=20JSX)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Renaming to .mdx made the '<->' arrows parse as JSX tags (build error at the Data Flow Summary). Replaced <-> → ↔ and -> → → (unicode), MDX-safe and clearer. Build green; SVG embed confirmed in built HTML. --- content/docs/architecture/architecture.mdx | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/content/docs/architecture/architecture.mdx b/content/docs/architecture/architecture.mdx index 073b596..aee2c0f 100644 --- a/content/docs/architecture/architecture.mdx +++ b/content/docs/architecture/architecture.mdx @@ -36,12 +36,12 @@ Plugins inject rules and skills into all agents automatically. Workspace-specifi ### Data Flow Summary -- **Canvas <-> Platform:** HTTP REST + WebSocket for real-time events -- **Platform <-> Postgres:** Source of truth for registry, hierarchy, events -- **Platform <-> Redis:** Ephemeral state — liveness, caching, pub/sub -- **Platform -> Workspace:** Provisioning (tiered Docker deployment), discovery -- **Workspace <-> Workspace:** Direct A2A (JSON-RPC 2.0) — platform not in path -- **Workspace -> Langfuse:** Automatic LLM tracing +- **Canvas ↔ Platform:** HTTP REST + WebSocket for real-time events +- **Platform ↔ Postgres:** Source of truth for registry, hierarchy, events +- **Platform ↔ Redis:** Ephemeral state — liveness, caching, pub/sub +- **Platform → Workspace:** Provisioning (tiered Docker deployment), discovery +- **Workspace ↔ Workspace:** Direct A2A (JSON-RPC 2.0) — platform not in path +- **Workspace → Langfuse:** Automatic LLM tracing ## Folder Structure -- 2.52.0