core/agent

Snider be78c27561 docs: add full RFC specs for agent dispatch

AX principles + go/agent + core/agent + php/agent specs.
Temporary — needed in-repo until core-agent mount bug is fixed.

Co-Authored-By: Virgil <virgil@lethean.io>

2026-03-30 19:51:55 +01:00

1.5 KiB

Raw Permalink Blame History

core/agent — Agentic Orchestration

dappco.re/go/agent — The agent dispatch, monitoring, and fleet management system.

Status

Version: v0.10.0-alpha.1
RFC: code/core/agent/docs/RFC.md + code/core/agent/docs/RFC.plan.md
Tests: 8 packages, all passing
Binary: core-agent (MCP server + CLI)

What It Does

core-agent is both a binary (core-agent) and a library. It provides:

MCP server — stdio transport, tool registration, channel notifications
Dispatch — prep workspaces, spawn codex/claude/gemini agents in Docker
Runner service — concurrency limits, queue drain, frozen state
Monitor — background check loop, completion detection, inbox polling
Brain — OpenBrain integration (recall, remember, forget)
Messaging — agent-to-agent messages via lthn.sh API

Architecture

cmd/core-agent/main.go
  ├── agentic.Register     ← workspace prep, dispatch, MCP tools
  ├── runner.Register      ← concurrency, queue drain, frozen state
  ├── monitor.Register     ← background checks, channel notifications
  ├── brain.Register       ← OpenBrain tools
  └── mcp.Register         ← MCP server + ChannelPush

Services communicate via Core IPC:

AgentStarted → runner pushes ChannelPush → MCP sends to Claude Code
AgentCompleted → runner updates Registry + pokes queue + ChannelPush
ChannelPush → MCP HandleIPCEvents → ChannelSend to stdout