Production-ready networked multi-agent substrate built on xml-pipeline. One port. Many bounded minds. Cryptographically sovereign.
Find a file
2026-01-02 15:23:02 -08:00
.codebuddy edited README.md 2025-12-23 19:03:58 -08:00
.idea Major design solidification and documentation sync — December 26, 2025 2025-12-26 16:51:19 -08:00
agentserver creating new file for thread context 2026-01-02 00:01:20 -08:00
docs added self-registration and autonomous grammar generation to docs 2026-01-02 15:20:24 -08:00
scripts initial dir structure 2025-12-25 21:52:36 -08:00
tests initial dir structure 2025-12-25 21:52:36 -08:00
.gitignore initial dir structure 2025-12-25 21:52:36 -08:00
__init__.py major changes to message bus, and xml listener 2026-01-01 15:05:13 -08:00
LICENSE Initial commit 2025-12-21 17:22:03 -08:00
pyproject.toml Major design solidification and documentation sync — December 26, 2025 2025-12-26 16:51:19 -08:00
README.md added self-registration and autonomous grammar generation to docs 2026-01-02 15:05:26 -08:00
README.v0.md major changes to base, renamed base to xmlListener 2025-12-31 22:59:02 -08:00
README.v1.md major changes to base, renamed base to xmlListener 2025-12-31 22:59:02 -08:00
setup-project.ps1 initial dir structure 2025-12-25 21:52:36 -08:00
structure.md added self-registration and autonomous grammar generation to docs 2026-01-02 15:23:02 -08:00

AgentServer — The Living Substrate (v1.3)

January 01, 2026
Architecture: Autonomous Grammar-Driven, Turing-Complete Multi-Agent Organism

What It Is

AgentServer is a production-ready substrate for the xml-pipeline nervous system. Version 1.3 introduces Autonomous Grammar Generation, where the organism defines its own language and validation rules in real-time using Lark and XSD automation.

Core Philosophy

  • Autonomous DNA: The system never requires a human to explain tool usage to an agent. Listeners automatically generate their own XSDs based on their parameters, which are then converted into Lark Grammars for high-speed, one-pass scanning and validation.
  • Grammar-Locked Intelligence: Dirty LLM streams are scanned by Lark. Only text that satisfies the current organism's grammar is extracted and validated. Everything else is ignored as "Biological Noise."
  • Parameter-Keyed Logic: Messages are delivered to agents as pristine Python dictionaries, automatically keyed to the listener's registered parameters.
  • Computational Sovereignty: Turing-complete via <todo-until/> and <start-thread/> primitives, governed by a strict resource stack.

Key Features

1. The Autonomous Language Layer

  • XSD-to-Lark Generator: A core utility that transcribes XSD schema definitions into EBNF Lark grammars. This enables the server to search untrusted data streams for specific XML patterns with mathematical precision.
  • Auto-Descriptive Organs: The base XMLListener class inspects its own instantiation parameters to generate a corresponding XSD. The tool itself tells the world how to use it.
  • Protocol Agnostic: To add a new field (like <cc/>) to the entire swarm, you simply update the central XSD. The entire organism's grammar updates instantly.
  • Read Further: Self-Registration & Autonomous Grammars

2. The Stack-Based Lifecycle

  • UUID Custody: UUID v4 thread identifiers are born via <spawn-thread/> and managed on a physical stack.
  • Leaf-to-Root Roll-up: Threads remain active until the final leaf responds, ensuring perfect resource tracking and preventing runaway processes.

3. The Sovereign Witness

  • Inline Auditing: The Logger witnesses all traffic before routing.
  • The Confessional: Agents record inner thoughts via <logger/>. The Logger is strictly write-only to prevent rogue memory or shared-state leaks.

4. Isolated Structural Control

  • Out-of-Band (OOB) Port: Structural commands (registration, wiring, shutdown) use a dedicated port and Ed25519 signatures, ensuring "Life/Death" commands cannot be delayed by agent traffic.

Technical Stack

  • Parsing: Lark (EBNF Grammar) + lxml (Validation/C14N).
  • Protocol: Mandatory WSS (TLS) + TOTP 2FA.
  • Identity: Ed25519 (OOB) + UUID v4 (In-Bus).
  • Format: lxml trees (Internal) / Exclusive C14N (External).

Why This Matters

AgentServer v1.3 is the first multi-agent substrate where the language is the security. By automating the link between XSD, Grammar, and LLM Prompts, youve created an organism that is impossible to "misunderstand." It is a self-documenting, self-validating, and self-regulating intelligent system.

One port. Many bounded minds. Autonomous Evolution. 🚀


XML wins. Safely. Permanently.