# deepagentlabs/agenticops-control-tower architecture

> Architecture diagram of the GitHub repository deepagentlabs/agenticops-control-tower, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/deepagentlabs/agenticops-control-tower
- Repository: https://github.com/deepagentlabs/agenticops-control-tower

## Overview

Control Tower is an early-stage, runtime-agnostic agent operations control plane. The implemented workflow is registration and heartbeat intake, in-memory inventory updates, then capability and status views through an API and CLI. The README also describes planned configuration, console, and MCP-facing operations; these are shown as planned or optional rather than implemented flows. Edges reflect sampled source or explicit README statements; unsampled subsystem wiring is not inferred.

Main entry points: [`src/agenticops_control_tower/api/surface.py`](https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/api/surface.py) (Control API), [`src/agenticops_control_tower/status/service.py`](https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/status/service.py) (Status rollups), [`src/agenticops_control_tower/discovery/service.py`](https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/discovery/service.py) (Capability discovery), [`src/agenticops_control_tower/snapshot.py`](https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/snapshot.py) (Snapshot loading)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_surfaces["Operator surfaces"]
  node_cli["CLI<br/>[main.py]"]
  node_http["HTTP API<br/>[http.py]"]
end

subgraph group_control["Control plane"]
  node_facade["Control API<br/>[surface.py]"]
  node_registry[("Agent registry<br/>[service.py]")]
  node_discovery["Capability discovery<br/>[service.py]"]
  node_status["Status rollups<br/>[service.py]"]
  node_snapshot["Snapshot loading<br/>[snapshot.py]"]
  node_adapters["Adapter catalog<br/>[catalog.py]"]
end

subgraph group_domain["Domain data"]
  node_agentdata["Agent records<br/>[agent.py]"]
  node_statusdata["Status and snapshot models<br/>[status.py]"]
end

subgraph group_planned["Planned capabilities"]
  node_console["Web console<br/>[app.py]"]
  node_mcp["Agentic MCP"]
  node_configuration["Configuration<br/>[models.py]"]
end

node_human(("Human operator"))

node_human -->|"operates through"| node_cli
node_cli -->|"calls"| node_http
node_http -->|"routes to"| node_facade
node_facade -->|"reads and writes"| node_registry
node_facade -->|"queries"| node_discovery
node_facade -->|"uses"| node_status
node_status -->|"aggregates"| node_discovery
node_snapshot -->|"loads through"| node_facade
node_registry -->|"stores"| node_agentdata
node_discovery -->|"reads"| node_agentdata
node_status -->|"builds summaries"| node_statusdata
node_snapshot -->|"validates snapshot"| node_statusdata
node_human -.->|"will operate through"| node_console
node_mcp -.->|"planned interface"| node_facade
node_facade -.->|"planned management"| node_configuration
node_facade -.->|"potential discovery support"| node_adapters

click node_cli "https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/cli/main.py"
click node_http "https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/api/http.py"
click node_console "https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/console/app.py"
click node_facade "https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/api/surface.py"
click node_registry "https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/registry/service.py"
click node_discovery "https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/discovery/service.py"
click node_status "https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/status/service.py"
click node_snapshot "https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/snapshot.py"
click node_adapters "https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/adapters/catalog.py"
click node_configuration "https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/config/models.py"
click node_agentdata "https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/models/agent.py"
click node_statusdata "https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/models/status.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_http toneBlue
class node_facade,node_registry,node_discovery,node_status,node_snapshot,node_adapters toneAmber
class node_agentdata,node_statusdata toneMint
class node_console,node_mcp,node_configuration toneRose
class node_human toneIndigo
```

## Components

### Operator surfaces

- [CLI](https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/cli/main.py): `src/agenticops_control_tower/cli/main.py`
- [HTTP API](https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/api/http.py): `src/agenticops_control_tower/api/http.py`

### Control plane

- [Control API](https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/api/surface.py): `src/agenticops_control_tower/api/surface.py`
- [Agent registry](https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/registry/service.py): `src/agenticops_control_tower/registry/service.py`
- [Capability discovery](https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/discovery/service.py): `src/agenticops_control_tower/discovery/service.py`
- [Status rollups](https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/status/service.py): `src/agenticops_control_tower/status/service.py`
- [Snapshot loading](https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/snapshot.py): `src/agenticops_control_tower/snapshot.py`
- [Adapter catalog](https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/adapters/catalog.py): `src/agenticops_control_tower/adapters/catalog.py`

### Domain data

- [Agent records](https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/models/agent.py): `src/agenticops_control_tower/models/agent.py`
- [Status and snapshot models](https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/models/status.py): `src/agenticops_control_tower/models/status.py`

### Planned capabilities

- [Web console](https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/console/app.py): `src/agenticops_control_tower/console/app.py`
- **Agentic MCP**
- [Configuration](https://github.com/deepagentlabs/agenticops-control-tower/blob/main/src/agenticops_control_tower/config/models.py): `src/agenticops_control_tower/config/models.py`

### Other components

- **Human operator**

## Connections

- Human operator → CLI: operates through (evidence: `README.md`)
- CLI → HTTP API: calls (evidence: `README.md`)
- HTTP API → Control API: routes to (evidence: `src/agenticops_control_tower/api/http.py`)
- Control API → Agent registry: reads and writes (evidence: `src/agenticops_control_tower/api/surface.py`)
- Control API → Capability discovery: queries (evidence: `src/agenticops_control_tower/api/surface.py`)
- Control API → Status rollups: uses (evidence: `src/agenticops_control_tower/api/surface.py`)
- Status rollups → Capability discovery: aggregates (evidence: `src/agenticops_control_tower/status/service.py`)
- Snapshot loading → Control API: loads through (evidence: `src/agenticops_control_tower/snapshot.py`)
- Agent registry → Agent records: stores (evidence: `src/agenticops_control_tower/registry/service.py`)
- Capability discovery → Agent records: reads (evidence: `src/agenticops_control_tower/discovery/service.py`)
- Status rollups → Status and snapshot models: builds summaries (evidence: `src/agenticops_control_tower/status/service.py`)
- Snapshot loading → Status and snapshot models: validates snapshot (evidence: `src/agenticops_control_tower/snapshot.py`)
- Human operator → Web console: will operate through (evidence: `README.md`)
- Agentic MCP → Control API: planned interface (evidence: `README.md`)
- Control API → Configuration: planned management (evidence: `README.md`)
- Control API → Adapter catalog: potential discovery support
