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	9951
title	Scaffold signal_state_transition MCP Endpoint
state	Closed
labels	enhancementaiarchitecture
assignees	tobiu
createdAt	Apr 13, 2026, 11:28 AM
updatedAt	Apr 14, 2026, 12:32 AM
githubUrl	https://github.com/neomjs/neo/issues/9951
author	tobiu
commentsCount	0
parentIssue	160
subIssues	[]
subIssuesCompleted	0
subIssuesTotal	0
contentTrust
projected
quarantined	0
signals	[]
blockedBy	[]
blocking	[x] 160 Epic: Abstracting the Operating Environment (Agent OS v3)
closedAt	Apr 13, 2026, 7:15 PM

Scaffold signal_state_transition MCP Endpoint

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

tobiu commented on Apr 13, 2026, 11:28 AM

Goal

Provide a native state-trap for Headless Orchestration to gracefully capture the "PR Opened" state without abstracting away native Git CLI access. Additionally, provide a native mechanism for agents to signal insurmountable logic failures natively back to the framework.

Implementation Checklist

Enhance the neo-mjs-github-workflow MCP server with a signal_state_transition(state, target) tool.
Support state: 'PR_OPENED' to trigger autonomous turn-completion and shutdown sequences.
Support state: 'BLOCKED' and state: 'HANDOFF' for derailed agents, enabling them to pass a localized artifact mapping the problem back to the Orchestrator, which natively applies the agent-task:blocked label on GitHub.

tobiu cross-referenced by PR #9968 on Apr 13, 2026, 2:49 PM

tobiu cross-referenced by PR #9979 on Apr 13, 2026, 7:10 PM

tobiu cross-referenced by #9980 on Apr 13, 2026, 7:17 PM