The Podium coordinator manages agent processes on a host. It is normally reached through the gateway, not directly by clients.
Runtime
| Field | Value |
|---|---|
| Local endpoint | 127.0.0.1:8003 only when FABRIC_PODIUM_MODE=local |
| Config source | Coordinator configuration file |
| Public exposure | Internal behind the gateway |
Responsibilities
- Maintain deployment cache on the host.
- Create and manage agent instance directories.
- Spawn and supervise agent processes.
- Maintain local IPC with agents.
- Expose health and status to the gateway.
- Attach Chronicle-backed workspace mounts when enabled.
Route Families
| Route family | Purpose |
|---|---|
| Health/status | Coordinator health and active-instance inspection |
| Deployment | Ensure an agent bundle is available on the host |
| Instances | Create, inspect, message, and stop agent instances |
| Logs/files | Operational inspection where enabled |
| Runtime stream | Agent event stream through the gateway |
Coordinator routes are internal implementation details. New client-facing work should go through Diminuendo or the Podium gateway.