Agent Mesh — microservices¶

Generated from the architecture model

This page is rendered from model/**/*.yaml by tools/docs_model during mkdocs build. Edit the YAML, not this page; hand-written design lives on the linked service, platform and plane pages.

Every logical service keeps its own design page and model entry; deployment granularity says how it is shipped at first (decision D23). Modules of a host are deployed inside that host until an extraction decision is recorded.

flowchart TB
    subgraph AgentRuntimeWorker["AgentRuntimeWorker (host)"]
        AgentCorrectionService["AgentCorrectionService"]
        AgentExecutionService["AgentExecutionService"]
        AgentRuntimeService["AgentRuntimeService"]
        AgentValidationService["AgentValidationService"]
        WorkflowEngineService["WorkflowEngineService"]
    end
    classDef later stroke-dasharray: 4 4;

Hold "Alt" / "Option" to enable pan & zoom

Service	Context	Granularity	Host	Status	Page
AgentCorrectionService	BC-06	module of host	AgentRuntimeWorker	unmodelled	—
AgentExecutionService	BC-06	module of host	AgentRuntimeWorker	unmodelled	—
AgentRuntimeService	BC-06	module of host	AgentRuntimeWorker	target	design
AgentRuntimeWorker	BC-06	standalone host	—	target	design
AgentValidationService	BC-06	module of host	AgentRuntimeWorker	unmodelled	—
WorkflowEngineService	BC-38	module of host	AgentRuntimeWorker	target	design

AgentCorrectionService¶

Bounded self-correction loop; merged into AgentRuntimeService.


Bounded context	BC-06 Execution
Granularity	module of host · host `AgentRuntimeWorker`
Former catalog group	Agent Mesh (merge)
Status	unmodelled
Design page	not written yet

AgentExecutionService¶

Attempt records; merged into AgentRuntimeService.


Bounded context	BC-06 Execution
Granularity	module of host · host `AgentRuntimeWorker`
Former catalog group	Agent Mesh (merge)
Status	unmodelled
Design page	not written yet

AgentRuntimeService¶

Attempt execution under a lease: release loading, context, plan-call-observe-verify loop on the MAF adapter, checkpoints, decisions, sub-agents, one outcome (BC-06).


Bounded context	BC-06 Execution
Granularity	module of host · host `AgentRuntimeWorker`
Former catalog group	Agent Mesh (module)
Status	target
Modelled	2 aggregates · 3 REST + 3 gRPC · 9 events · 4 workers · 6 tables
Design page	planes/agent-runtime/services/agent-runtime-service/index.md

AgentRuntimeWorker¶

Runtime worker host executing attempts, workflow engine steps and release loading.


Bounded context	BC-06 Execution
Granularity	standalone host
Former catalog group	(host added 2026-10-09) (module)
Status	target
Modelled	0 aggregates · 2 REST + 0 gRPC · 0 events · 0 workers · 0 tables
Design page	planes/agent-runtime/services/agent-runtime-worker/index.md

AgentValidationService¶

Output validation against contract, schema and policy; merged into AgentRuntimeService.


Bounded context	BC-06 Execution
Granularity	module of host · host `AgentRuntimeWorker`
Former catalog group	Agent Mesh (merge)
Status	unmodelled
Design page	not written yet

WorkflowEngineService¶

Workflow definition versions and the deterministic engine (DAG, conditions, retries, compensation, timers).


Bounded context	BC-38 Workflow Definitions & Engine
Granularity	module of host · host `AgentRuntimeWorker`
Former catalog group	(added 2026-10-09) (module)
Status	target
Modelled	2 aggregates · 3 REST + 2 gRPC · 9 events · 3 workers · 7 tables
Design page	planes/agent-runtime/services/workflow-engine-service/index.md