Agent Status
Query the current state of all loaded agents.
GET /api/v1/status
Returns an array of agent status objects.
Response 200 OK
[
{
"name": "log-monitor",
"status": "running",
"uptime_ms": 360000,
"last_activity_ms_ago": 1200,
"restart_count": 0,
"memory_profile": {
"heap_bytes": 2097152,
"fuel_remaining": 500000
}
},
{
"name": "researcher",
"status": "idle",
"uptime_ms": 360000,
"last_activity_ms_ago": 45000,
"restart_count": 1,
"memory_profile": {
"heap_bytes": 4194304,
"fuel_remaining": 250000
}
}
]
Agent status fields
| Field | Type | Description |
|---|---|---|
name | string | Agent name from configuration |
status | string | One of running, idle, stopped, error |
uptime_ms | integer | Milliseconds since agent was last started |
last_activity_ms_ago | integer | Milliseconds since the agent last executed |
restart_count | integer | Number of times the agent has been restarted |
memory_profile.heap_bytes | integer | Current WASM linear memory usage |
memory_profile.fuel_remaining | integer | Remaining WASM fuel budget (null if unlimited) |
Filtering
Pass ?agent=NAME to filter to a single agent:
GET /api/v1/status?agent=log-monitor