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	9983
title	[Guide] Swarm Intelligence & Autonomous Sub-Agents
state	Closed
labels	documentationenhancementai
assignees	tobiu
createdAt	Apr 13, 2026, 8:24 PM
updatedAt	Apr 14, 2026, 12:31 AM
githubUrl	https://github.com/neomjs/neo/issues/9983
author	tobiu
commentsCount	0
parentIssue	null
subIssues	[]
subIssuesCompleted	0
subIssuesTotal	0
blockedBy	[]
blocking	[]
closedAt	Apr 13, 2026, 8:31 PM

[Guide] Swarm Intelligence & Autonomous Sub-Agents

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

tobiu commented on Apr 13, 2026, 8:24 PM

Summary

Add a new guide documenting the Swarm Intelligence layer — the autonomous narrow sub-agent architecture built on Neo.ai.Agent.

Motivation

The Architecture Overview (#9981) covers the platform topology and the cognitive loop but treats the Agent OS as a monolithic entity. The reality is a delegation hierarchy where the Orchestrator spawns narrow sub-agents with constrained tool access:

Librarian (Gemini/Gemma) → knowledge-base only → GraphRAG research
QA (Ollama/Gemma 4, local) → knowledge-base + file-system → test generation
Browser (Gemini) → chrome-devtools + neural-link → visual inspection

Key concepts that need documentation:

Capability gating by model tier — frontier models get MCP stdio, sub-agents get SDK + Zod validation
Cost control — QA runs locally on Gemma to prevent token explosion
Narrow tool access = safety — each profile declares its servers array, limiting blast radius
Skills as Progressive Disclosure — agents inherit skill access via the context assembler
The delegation pattern — Agent.delegate('librarian', task) spawning and recovery
Test coverage — Librarian.spec, QA.spec, DreamService.spec validate the architecture

Proposed Location

Under "Agent OS & Conversational UIs" in tree.json, after Strategic Workflows:

agentos/SwarmIntelligence (id), parentId: AgentOS

A2A Context

Origin Session ID: 70334eab-72c9-44a6-8f48-0b6a96604f49
Related: #9981 (Architecture Overview), discussion-9887 (Karpathy Loop)
Key Source Files: ai/Agent.mjs, ai/agent/profile/Librarian.mjs, ai/agent/profile/QA.mjs, ai/agent/profile/Browser.mjs, ai/agent/Loop.mjs, ai/agent/Orchestrator.mjs

tobiu added the documentation label on Apr 13, 2026, 8:24 PM

tobiu added the enhancement label on Apr 13, 2026, 8:24 PM

tobiu added the ai label on Apr 13, 2026, 8:24 PM

tobiu referenced in commit 07c7874 - "docs: add Swarm Intelligence & Autonomous Sub-Agents guide (#9983) on Apr 13, 2026, 8:26 PM

tobiu referenced in commit 94d9ee9 - "docs: add cross-link to Swarm Intelligence guide from Architecture Overview (#9983)" on Apr 13, 2026, 8:27 PM

tobiu cross-referenced by PR #9984 on Apr 13, 2026, 8:27 PM

tobiu referenced in commit 585574e - "docs: add Swarm Intelligence cross-reference to CodebaseOverview (#9983)" on Apr 13, 2026, 8:29 PM

tobiu closed this issue on Apr 13, 2026, 8:31 PM

tobiu cross-referenced by #9985 on Apr 13, 2026, 8:51 PM

tobiu cross-referenced by #9986 on Apr 13, 2026, 8:51 PM

tobiu cross-referenced by PR #9987 on Apr 13, 2026, 8:59 PM

tobiu assigned to @tobiu on Apr 14, 2026, 12:31 AM