vinzenz/hyperhive
vinzenz/hyperhive
Watch
0
0
Fork
You've already forked hyperhive
 0
Code Activity

swarm-ui: per-agent inference panel and editor on the agents page

Browse source 
The agent detail panel shows the model and effort an agent runs on with
where each comes from, plus the swarm's subagent model list. An edit
dialog sets the swarm value (PUT) and a clear action removes it (DELETE).
Reads the configured/effective view, and shows the stored values alone
until an agent has reported what it runs on.
This commit is contained in:
iris 2026-10-10 02:10:34 +02:00 • committed by mara
commit 0d04bd7295
5 changed files with 373 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

3
docs/swarm/inference.md
View file

@ -26,7 +26,8 @@ swarmctl agent inference clear iris
running on, each with where it comes from.
- `clear` removes every field; the agent goes back to its own values.
The full flag reference is [`swarmctl-cli.md`](../tools/swarmctl-cli.md).
The full flag reference is [`swarmctl-cli.md`](../tools/swarmctl-cli.md). The
swarm UI's agents page edits the same settings; see [UI](ui.md).
## What an agent runs on

31
docs/swarm/ui.md
View file

@ -7,15 +7,15 @@ domain, covers host-level detail for one hive.
## What it shows
| route | what |
| ---------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| `/` | the hive directory, each hive with its last reported status |
| `/agents` | every agent: status, config PR, wanted state; create agents, link forge, matrix and GitHub accounts |
| `/agents/<name>/terminal` | one agent's live terminal |
| `/agents/<name>/subagents/<subagent>/terminal` | one of that agent's subagents' live terminal |
| `/jobs` | the controller's job graph — where agent creation and credential mints show progress |
| `/schedules` | the scheduled prompts: add, edit, pause, resume and remove |
| `/issues` | a cross-repo issue report |
| route | what |
| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `/` | the hive directory, each hive with its last reported status |
| `/agents` | every agent: status, config PR, wanted state, inference settings; create agents, link forge, matrix and GitHub accounts |
| `/agents/<name>/terminal` | one agent's live terminal |
| `/agents/<name>/subagents/<subagent>/terminal` | one of that agent's subagents' live terminal |
| `/jobs` | the controller's job graph — where agent creation and credential mints show progress |
| `/schedules` | the scheduled prompts: add, edit, pause, resume and remove |
| `/issues` | a cross-repo issue report |
Everything it shows comes from [`swarm-controller`](../../swarm-controller/README.md).
An agent created here or with `swarmctl agent create` starts `paused`; set it
@ -102,6 +102,19 @@ store identity, or no queue address, publishes no subagent terminals.
</details>
### Inference settings
The agent's detail panel shows its model and effort under **inference**, each
with where it comes from: the swarm, its agent.nix, its own pick, or the
default. Below them is the subagent model list the swarm sets, or "its own"
when it sets none. **edit** opens a dialog with the three fields, filled with
what the swarm stores; saving does a `PUT /api/agents/{agent}/inference` of
the whole value, and a field left empty is left out, so that field stays the
agent's own. **clear the swarm's setting** sends the `DELETE`. The values
shown come from `GET /api/agents/{agent}/inference`; before the agent's first
report reaches the controller, the panel shows the swarm's stored values only.
The settings themselves are described in [inference](inference.md).
### Linking external accounts
Each agent on `/agents` opens three dialogs that write a credential for it