Mesh Architecture

System Overview

┌─────────────────────────────────────────────┐
│              AgentField Control Plane        │
│  Registration · Discovery · Execution · Memory │
└──────────┬──────────────┬──────────────┬────┘
           │              │              │
    ┌──────┴──────┐ ┌─────┴─────┐ ┌─────┴─────┐
    │ consumer-   │ │ fast-     │ │ customer- │
    │ agent       │ │ analytics │ │ agent     │
    │ :8957       │ │ :8202     │ │ :8616     │
    └─────────────┘ └───────────┘ └───────────┘
           │              │              │
    ┌──────┴──────┐ ┌─────┴─────┐
    │ external-   │ │ fast-     │
    │ agent-call  │ │ query     │
    │ (connector) │ │ (connector)│
    └─────────────┘ └───────────┘
           │              │
    ┌──────┴──────┐ ┌─────┴─────┐
    │ Stage       │ │ Stage     │
    │ Consumer API│ │ FAST API  │
    └─────────────┘ └───────────┘

Components

Component	What it does
Control Plane	AgentField server — registration, discovery, execution gateway, memory
Mesh API	FAM server — agent CRUD, skills, connectors, execution streaming
Agents	AI-powered services with reasoners and skills
Connectors	Deterministic tools that call external APIs
Skills	Prompt instructions that compose connectors
Web UI	React app for visual agent building and chat
TUI	Terminal UI (mesh builder)

Data Flow

1. Registration: Agent starts → registers with control plane → becomes discoverable
2. Discovery: Reasoner runs → queries control plane → gets available tools
3. Execution: LLM calls tool → routes through control plane → target executes → result returns
4. Memory: Agents read/write shared state via control plane memory API

Ports

Each agent gets a deterministic port: 8001 + hash(node_id) % 999. Same port every restart.