State endpoint

GET /v1/state

Current allostatic state. See state and the Allostatic State concept.

curl https://mneva.dev/v1/state -H "x-mneva-key: $MNEVA_KEY"

No parameters.

Response:

{
  "state": "overloaded",
  "load": 20,
  "variance": 0,
  "reserve": 0.67,
  "active_minutes": 1,
  "window_minutes": 60,
  "last_active": "2026-05-23T00:14"
}

Field	Type	Description
`state`	`rest` \| `engaged` \| `overloaded`	The summary verdict.
`load`	number	Mean tool-calls per minute across active minutes in the window.
`variance`	number	Std-dev across active minutes.
`reserve`	number 0..1	Headroom against a 60/min per-tenant soft cap.
`active_minutes`	int	How many minutes in the window had any activity.
`window_minutes`	int	Always 60 today.
`last_active`	string \| null	Minute-truncated ISO timestamp of the latest activity. `null` on fresh tenants.

Calls to /v1/state are exempt from the per-minute activity tick — polling state does not inflate the load it returns.

Verdict bands:

load > 15 OR (load > 4 AND variance > load × 1.5) → overloaded
load >= 2 → engaged
otherwise → rest