Coordinate Agent State
Coordinator owns agent and delegation runtime state. SDKs and Console use it to create, inspect, suspend, resume, terminate, traverse, and revoke agent/delegation state.
Runtime
Section titled “Runtime”| Property | Value |
|---|---|
| Port | 4000 |
| Health | GET /health |
| Readiness | GET /ready |
| Metrics | GET /metrics |
| Auth scope | AGENT_COORDINATOR_SCOPE, default agent:lifecycle in deployment templates |
Dependencies
Section titled “Dependencies”| Dependency | Purpose |
|---|---|
| Postgres | Agent sessions, service leases, invocations, delegation edges, graph epochs, Coordinator outbox. |
| Redis | Lifecycle, invocation, delegation, and revocation streams. |
| STS/JWKS | Token validation and authority alignment. |
| Coordinator token | Console/operator access to agent and delegation views. |
| Job | Purpose |
|---|---|
| TTL sweeper | Expires stale sessions and delegation state. |
| Service lease sweeper | Marks stale service agents unhealthy. |
| Deadline enforcer | Handles invocation deadlines. |
| Retention cleaner | Removes expired historical coordination records. |
| Outbox publisher | Publishes Coordinator outbox messages to Redis. |
| Lifecycle relay | Observes caracal.agents.lifecycle delivery with HMAC origin verification and dedupe. |
Event Topics
Section titled “Event Topics”Coordinator publishes caracal.agents.lifecycle, caracal.invocations.lifecycle, caracal.delegations.invalidate, and session revocation events.
Next Step
Section titled “Next Step”Use Issue Mandates to understand how STS validates sessions and delegation edges during token exchange.