docs: document auth_failed / needs_login-on-401 behavior (follow-up to #423)

This commit is contained in:
lexis 2026-05-25 22:11:45 +02:00 committed by Mara
commit 8d40499e8d
2 changed files with 13 additions and 1 deletions

View file

@ -237,6 +237,10 @@ read them à la carte.
- **Rate-limit sentinel:** `{state_dir}/hyperhive-rate-limited`
is written by the harness on 429 and cleared on retry.
`ContainerView.rate_limited` reads it for the dashboard badge.
- **Auth-failed sentinel:** `{state_dir}/hyperhive-needs-login`
is written on a 401 mid-turn (OAuth credentials expired).
Harness requeues the inflight message and parks in
`wait_for_login` until the operator re-auths via the web UI.
- **Context window:** defaults are in `services.hive-c0re.contextWindowTokens`
(host nix, affects all agents). Per-agent default model via
`hyperhive.model` in `agent.nix`. Watermarks are 75%/50% of the