docs(agent): update model quick-picker description — list is now configurable

This commit is contained in:
iris 2026-06-05 13:46:30 +02:00 committed by mara
commit bf25d71fc9

View file

@ -73,14 +73,20 @@ through. Three flex columns:
preserved). All destructive actions require one extra click to
acknowledge — rare ops shouldn't live in the primary state strip.
Below a separator, a **model quick-picker** section labelled
`model` renders three one-click shortcuts: `haiku (fast)`,
`sonnet (balanced)`, `opus (powerful)`. Clicking a button POSTs
`/api/model` with the alias (same path as the `/model <name>`
slash command). The button for the currently-active model is
highlighted via the `active` class; `renderModelChip` keeps the
picker state in sync with live `model_changed` events so it stays
accurate when the model is changed from another session. Clicking
the already-active model closes the menu without an extra POST.
`model` renders one button per model in the operator-configured
list. The list is driven by `state.available_models` (sourced from
the `HIVE_AVAILABLE_MODELS` env var, injected by the
`services.hyperhive.availableModels` NixOS option; defaults to
`["haiku", "sonnet", "opus"]` when unset). Well-known aliases get
a parenthetical description (`haiku (fast)`, `sonnet (balanced)`,
`opus (powerful)`); operator-declared custom names show as-is.
Clicking a button POSTs `/api/model` with the alias (same path as
the `/model <name>` slash command). The button for the
currently-active model is highlighted via the `active` class;
`renderModelChip` keeps the picker state in sync with live
`model_changed` events so it stays accurate when the model is
changed from another session. Clicking the already-active model
closes the menu without an extra POST.
The popover's display rules are scoped to `:not([hidden])` so the
`[hidden]` HTML attribute's UA `display: none` isn't overridden by
the author CSS's `display: flex` — the popover stays hidden until