vinzenz/hyperhive
vinzenz/hyperhive
Watch
0
0
Fork
You've already forked hyperhive
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

docs(web-ui): document the 'all' stats window

Browse source 
Follow-up to the stats 'all' time-range feature: the agent and hive
stats endpoint docs enumerated the window options but predated 'all'.
Add it to the /api/stats and /api/stats-hive window lists, and note
that 'all' ranges from the earliest recorded turn with an adaptive
bucket width.
This commit is contained in:
iris 2026-06-23 00:21:11 +02:00
commit 9634327b59
2 changed files with 5 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

7
docs/web-ui/agent.md
View file

@ -328,8 +328,9 @@ shaped).
flyout (`renderLooseEnds`). Returns pending questions the agent asked flyout (`renderLooseEnds`). Returns pending questions the agent asked
or owes, plus pending reminders. Also calls `reconcileAskBinds()` to or owes, plus pending reminders. Also calls `reconcileAskBinds()` to
wire inline answer forms to open `question_asked` events. wire inline answer forms to open `question_asked` events.
- `GET /api/stats?window=24h|7d|30d` — time-bucketed turn analytics - `GET /api/stats?window=24h|7d|30d|all` — time-bucketed turn analytics
`Snapshot` consumed by the `/stats` page. `Snapshot` consumed by the `/stats` page. `all` ranges from the
earliest recorded turn with an adaptive bucket width.
- `GET /events/history` — replay buffer for the terminal. - `GET /events/history` — replay buffer for the terminal.
- `GET /screen` — VNC viewer page (minimal RFB-over-WebSocket - `GET /screen` — VNC viewer page (minimal RFB-over-WebSocket
renderer — deliberately thin, just enough to display the renderer — deliberately thin, just enough to display the
@ -380,7 +381,7 @@ Bus events (new vocabulary on `/events/stream`):
harness, linked from the per-agent page's `📊 stats →` and from harness, linked from the per-agent page's `📊 stats →` and from
each dashboard container row). Turn analytics, read-only, from each dashboard container row). Turn analytics, read-only, from
`/state/hyperhive-turn-stats.sqlite`. `GET /api/stats?window= `/state/hyperhive-turn-stats.sqlite`. `GET /api/stats?window=
24h|7d|30d` returns a time-bucketed `Snapshot`; the page renders 24h|7d|30d|all` returns a time-bucketed `Snapshot`; the page renders
it with Chart.js (bundled into `stats.js` via esbuild — no CDN it with Chart.js (bundled into `stats.js` via esbuild — no CDN
dependency). Charts: turns, duration (p50 · p95 · avg), context dependency). Charts: turns, duration (p50 · p95 · avg), context
tokens, token cost per bucket, a **turns-by-model** stacked bar tokens, token cost per bucket, a **turns-by-model** stacked bar

2
docs/web-ui/dashboard.md
View file

@ -1094,7 +1094,7 @@ that's a browser-level decision, not ours.
`/dashboard/history` backfill. `/dashboard/history` backfill.
- `GET /api/reminders` — list pending reminders for the - `GET /api/reminders` — list pending reminders for the
dashboard's queued-reminders panel. dashboard's queued-reminders panel.
- `GET /api/stats-hive?window=<1h|4h|24h|3d|7d|30d>` — hive-wide - `GET /api/stats-hive?window=<1h|4h|24h|3d|7d|30d|all>` — hive-wide
turn-stats rollup for the ST4TS tab. Aggregates every agent's turn-stats rollup for the ST4TS tab. Aggregates every agent's
`hyperhive-turn-stats.sqlite` read-only (skips missing / unreadable / `hyperhive-turn-stats.sqlite` read-only (skips missing / unreadable /
zero-turn dbs); returns swarm totals, a busiest-first per-agent zero-turn dbs); returns swarm totals, a busiest-first per-agent