GET /api/agents
List all active agent adapters with health and execution statistics.200
GET /api/agents/types
List registered adapter type identifiers.200
Agent Adapter Interface
Adapters are registered viagetAgentRegistry() from src/adapters/registry.ts. Each adapter implements:
Health Checks
Agent health is checked on demand whenGET /api/agents is called. Each adapter runs its own healthCheck() which typically:
- Verifies API key is present
- Makes a lightweight probe request to the underlying AI service
- Returns
healthy: booleanandlatencyMs
degraded or unhealthy (visible at GET /api/health).
Registering Custom Adapters
Custom adapters are registered programmatically at startup:Related
- Agent Sessions API - Start and monitor execution sessions
- Tasks API - Create tasks that agents process
- Health API - System-wide health including agent status
- profclaw agent - Inspect agents from the CLI