Watch
0
0
Fork
You've already forked hyperhive
0

swarm ui: the terminal's status badges overhaul

The connection is a light on the agent's icon instead of a "live" badge, the
model and the effort are one badge, the context badge has an icon, subagents
and a new bash tasks badge are an icon and a count, and an agent's tab shows a
drag grip on hover.

It also removes two things the overhaul replaces: the cost badge, and the
"split" badge with its menu in group panes (splitting is by dragging a tab, or
from the subagents list).
This commit is contained in:
iris 2026-11-16 23:40:59 +01:00 • committed by mara
commit 3a846c8c45

View file

@ -101,7 +101,7 @@ when the data arrives. The placeholders stand still where motion is off.
An opened card has six sections, and each reads nothing until you open it.
**status** and **terminal** start open, the other four folded:
- **status**: how fresh the agent's last report is (with its age), its turn state, context and cost, its hive, links to its
- **status**: how fresh the agent's last report is (with its age), its turn state and context, its hive, links to its
profile and its config repo on the swarm's forge (built from the forge entry
of `GET /api/links`; the row stays hidden when the swarm lists none, and an
agent built from an archetype has no config repo, so it gets no config repo
@ -136,22 +136,28 @@ Each subagent in the list shows the model and effort it runs, like
`opus · high`, beside its name; one on the default model shows only the effort.
The `/agents/<name>/terminal` page's subagent list shows them too.
The preview carries only the connection badge and **expand**, so it stays clear
of the text. What the agent is doing shows in the details table above it, in
the **state** row: the turn state (idle, thinking or compacting), a **paused**
badge for a paused agent, and the tokens in its context and billed. The row
The preview carries only a small connection light and **expand**, so it stays
clear of the text. What the agent is doing shows in the details table above it,
in the **state** row: the turn state (idle, thinking or compacting), a **paused**
badge for a paused agent, and the tokens in its context. The row
shows the latest report the controller holds, if it's under 150 seconds old, as
soon as you look. It reads "no report yet" when there is none: for an agent
that's offline, and until the first report after the controller restarts. The
agent sends a report when its state changes and once a minute. If
the browser gives up on the stream, a **reconnect** badge opens it again. The
terminal's own tab keeps these badges, with the model and the effort, beside the
connection badge; the turn-state badge says how long the agent has been in that
state. Clicking the model or the effort badge opens the agent's inference
settings in a popover, the same settings its card shows.
terminal's own tab keeps these badges, with the model, beside the agent's name;
the turn-state badge says how long the agent has been in that state.
The connection is a **light** on the agent's icon in the name badge: green when
the stream is live, amber while it connects or reconnects, red when it closes.
In the card's preview, which has no name badge, the light stands alone. The
model and the effort are one badge, a chip icon and "opus (high)," and the
context is a dial icon and a size. Select the model badge to open the agent's
inference settings in a popover, the same settings its card shows. The terminal
shows no cost badge: the cost is a metric in Grafana.
On a terminal's own page (`/agents/<name>/terminal`, or a subagent's) the
header has an **N running subagents** badge. It opens a list of the agent's
header has a **subagents** badge, a branching icon and the number running. It opens a list of the agent's
subagents. Choosing one puts its terminal to the right of this one in a
[group](#groups-of-terminals); in a group, it splits that pane. A subagent
already in the group shows a marker and does nothing when chosen, and **maximize**
@ -162,6 +168,11 @@ swarm doesn't report more than when the newest row came, so a subagent that
thinks quietly for longer drops out of the count. The list shows the others below,
dimmed, as **not running**.
Beside it, an agent with background bash tasks has a **bash tasks** badge, a
prompt icon and the number running, which opens the same list of tasks the card's
"background tasks" section shows. An agent with no tasks has no badge, and a
subagent's terminal has none.
An agent's terminal opens with its last 100 rows from the past 24 hours, then
follows new ones; a reconnect picks up after the last row it showed. A subagent
terminal does the same with that subagent's rows, and has no turn-state badges.
@ -193,8 +204,8 @@ A terminal's own tab takes the agent's icon as its browser-tab icon, so tabs of
different agents tell apart. A subagent's tab shows its agent's icon. An agent
with no icon keeps the hyperhive mark. Everywhere else the swarm UI shows an agent's icon (the cards, the pickers, the badges), an agent with none shows the default agent icon.
The tab also has an agent badge, with the agent's icon and name, ahead of the
connection badge. It opens the agent's details in a popover under the badge:
The tab also has an agent badge, with the agent's icon (carrying the connection
light) and name, ahead of the state badges. It opens the agent's details in a popover under the badge:
the same status, state, wanted state and folded **status** and **settings** sections (inference, resource caps, internet, allowed domains, permissions and linked accounts) as the
opened card on `/agents`, without the terminal and subagents. The popover doesn't dim the
page. Selecting outside it, or Escape, closes it. From the keyboard, opening a
@ -210,9 +221,9 @@ another agent's terminal tab from the header onto the left, right, top or
bottom half of a terminal: the half it would take lights up, and the drop makes
a group of the two, with its own header tab at `/agents/group/<id>`. In a group,
the same drag onto a pane splits that pane, as many times as you like, and
dragging a pane's header badge onto another pane moves it there. The **split**
button in a pane's header does the same for an agent whose terminal tab is open:
**right** or **below** puts it beside the pane. A pane can hold a subagent's
dragging a pane's header badge onto another pane moves it there. A tab you can
drag shows a grip at its left edge when the pointer is over it, and its tooltip
reads "drag onto a terminal to split it." A pane can hold a subagent's
terminal (its header reads `agent/subagent`), put there by the **subagents**
badge in the pane's header. Two icon buttons sit in a pane's top right corner.
**Maximize** (the arrows pointing to the corners) opens that pane's own terminal