What is the Neural Link?

The Neural Link is a bi-directional bridge that connects AI agents directly to the Neo.mjs runtime. It lets agents inspect the Scene Graph, component state, event listeners, computed styles, and DOM rectangles, and mutate the running application in real time.

Why is Neo.mjs called an Application Engine instead of a framework?

Neo.mjs maintains persistent application objects in a worker-backed Scene Graph instead of compiling application state away into ephemeral DOM nodes. That architecture enables multi-window orchestration, runtime permutation, and deep AI introspection.

What is Context Engineering?

Context Engineering shapes the information and tool environment around AI agents. Neo.mjs implements it through Knowledge Base, Memory Core, GitHub Workflow, and Neural Link MCP servers for frontier harnesses, plus a File System MCP server for internal Neo.ai.Agent local loops.

What is the Neo.mjs Agent OS?

The Neo.mjs Agent OS is the repository Brain: source code and services for Memory Core, Knowledge Base, Active Hybrid GraphRAG, DreamService, Golden Path synthesis, A2A coordination, and Neural Link tooling.

Frontmatter

id	10001
title	Dynamic Topology: Unified vs. Federated Routing
state	Closed
labels	enhancementaiarchitecture
assignees	tobiu
createdAt	Apr 14, 2026, 5:10 PM
updatedAt	Apr 20, 2026, 1:05 PM
githubUrl	https://github.com/neomjs/neo/issues/10001
author	tobiu
commentsCount	0
parentIssue	10015
subIssues	[]
subIssuesCompleted	0
subIssuesTotal	0
blockedBy	[]
blocking	[x] 10009 Playwright Test Coverage: Federated Cloud Topology, [x] 10007 Memory Core: Bypass Database Initialization in Unified Mode
closedAt	Apr 20, 2026, 1:05 PM

Dynamic Topology: Unified vs. Federated Routing

Closed v13.0.0/archive-v13-0-0-chunk-4 enhancementaiarchitecture

tobiu commented on Apr 14, 2026, 5:10 PM

Objective

Refactor the Agent OS networking topology to support seamless hot-swapping between single-tenant monolithic environments and multi-tenant federated cloud environments.

Tasks

Introduce a boolean NEO_CHROMA_UNIFIED environment variable into both memory-core and knowledge-base config templates.
Refactor DreamService (and its underlying dependency StorageRouter) to conditionally configure its ChromaDB client.
- Unified (True): Connect to the shared, local instance natively.
- Federated (False): Instantiate a secondary, remote ChromaClient pointed at the knowledge-base domain.
Ensure the federated client implementation securely passes the necessary authentication headers if the Knowledge Base is protected by an OAuth gateway.

tobiu added the enhancement label on Apr 14, 2026, 5:10 PM

tobiu added the ai label on Apr 14, 2026, 5:10 PM

tobiu added the architecture label on Apr 14, 2026, 5:10 PM

tobiu added parent issue #9999 on Apr 14, 2026, 5:11 PM

tobiu cross-referenced by #10015 on Apr 14, 2026, 6:43 PM

tobiu removed parent issue #9999 on Apr 14, 2026, 6:44 PM

tobiu added parent issue #10015 on Apr 14, 2026, 6:44 PM

tobiu marked this issue as blocking #10007 on Apr 14, 2026, 6:44 PM

tobiu marked this issue as blocking #10009 on Apr 14, 2026, 6:44 PM

tobiu assigned to @tobiu on Apr 20, 2026, 12:10 PM

tobiu referenced in commit 8e9dbfb - "feat(ai): introduce chromaUnified flag for shared-ChromaDB topology (#10001)" on Apr 20, 2026, 12:37 PM

tobiu cross-referenced by PR #10121 on Apr 20, 2026, 12:40 PM

tobiu referenced in commit 2e2bb47 - "refactor(ai): nest kbChroma under engines + guard unified mode against missing config (#10001)" on Apr 20, 2026, 1:02 PM

tobiu referenced in commit 2be1b30 - "feat(ai): introduce chromaUnified flag for shared-ChromaDB topology (#10001) (#10121) on Apr 20, 2026, 1:05 PM

tobiu closed this issue on Apr 20, 2026, 1:05 PM

tobiu cross-referenced by #9748 on Apr 20, 2026, 1:13 PM

tobiu cross-referenced by PR #10122 on Apr 20, 2026, 1:19 PM

tobiu cross-referenced by PR #10123 on Apr 20, 2026, 3:06 PM

tobiu cross-referenced by PR #10124 on Apr 20, 2026, 3:15 PM

tobiu cross-referenced by #10125 on Apr 20, 2026, 3:53 PM

tobiu cross-referenced by #10126 on Apr 20, 2026, 3:53 PM

tobiu cross-referenced by #10127 on Apr 20, 2026, 3:53 PM

tobiu cross-referenced by PR #10128 on Apr 20, 2026, 4:12 PM

tobiu cross-referenced by #10129 on Apr 20, 2026, 5:04 PM

tobiu cross-referenced by PR #10130 on Apr 20, 2026, 5:26 PM

tobiu cross-referenced by PR #10131 on Apr 20, 2026, 8:26 PM

tobiu referenced in commit f70c48f - "feat(memory-core): surface effective chromadb topology in /health (#10127) (#10268) on Apr 24, 2026, 1:32 AM

tobiu referenced in commit e2210a8 - "docs(agentos): document shared KB/MC team deployment profile (#10694) (#10716) on May 4, 2026, 11:24 PM