remove the agent's live terminal page and the endpoints only it used
This commit is contained in:
parent
802151820c
commit
6289b8d64b
54 changed files with 127 additions and 4053 deletions
|
|
@ -97,8 +97,9 @@ box it gets:
|
||||||
- **knowledge** — the swarm's shared `internal/knowledge` repo, read-only
|
- **knowledge** — the swarm's shared `internal/knowledge` repo, read-only
|
||||||
at `/knowledge`, plus hyperhive's own docs in the container. →
|
at `/knowledge`, plus hyperhive's own docs in the container. →
|
||||||
[knowledge](docs/2-handbook/swarm/knowledge.md)
|
[knowledge](docs/2-handbook/swarm/knowledge.md)
|
||||||
- **web UI** — a per-agent page behind the gateway: live terminal of the
|
- **web UI** — the swarm UI's terminal for each agent: the live turn stream and a
|
||||||
turn stream, model / effort switching, cancel.
|
message box, with `/compact` and `/clear`; a per-agent stats page behind the
|
||||||
|
gateway.
|
||||||
- **GUI** (opt-in, `services.hyperhive.agent.gui.enable`) — a Wayland
|
- **GUI** (opt-in, `services.hyperhive.agent.gui.enable`) — a Wayland
|
||||||
desktop with screenshot / keyboard / mouse tools, viewable over VNC in
|
desktop with screenshot / keyboard / mouse tools, viewable over VNC in
|
||||||
the web UI.
|
the web UI.
|
||||||
|
|
|
||||||
|
|
@ -11,8 +11,8 @@ config changes, what its own page shows and how far you can trust it.
|
||||||
- **[Persistence and config changes](persistence.md)** — what survives a
|
- **[Persistence and config changes](persistence.md)** — what survives a
|
||||||
restart, a destroy and a purge, and how a change to an agent's config flows
|
restart, a destroy and a purge, and how a change to an agent's config flows
|
||||||
from a pull request to its container.
|
from a pull request to its container.
|
||||||
- **[The agent's web page](web-page.md)** — the per-agent terminal view, its
|
- **[The agent's web server](web-page.md)** — the stats and screen pages and
|
||||||
actions and its endpoints.
|
what the dashboard reads from each agent.
|
||||||
- **[Security model](security.md)** — the trust model, the prompt-injection
|
- **[Security model](security.md)** — the trust model, the prompt-injection
|
||||||
threat model and credential isolation.
|
threat model and credential isolation.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,24 +1,18 @@
|
||||||
# Per-agent page
|
# Per-agent web server
|
||||||
|
|
||||||
> Part of [Agents](README.md). See also: [Dashboard layout](../hives/dashboard.md)
|
> Part of [Agents](README.md). See also: [Dashboard layout](../hives/dashboard.md)
|
||||||
|
|
||||||
Every agent's harness serves a page of its own, reached from the agent's row on
|
Every agent's harness serves a small web server of its own, reached from the
|
||||||
the hive dashboard. It shows a live terminal view of what the agent is doing: its
|
agent's row on the hive dashboard. It has no terminal and no message box: to
|
||||||
turns, tool calls and results as they happen, with the recent history replayed
|
watch an agent work or write to it, use its terminal in the
|
||||||
when you open it. The page has no message box; to write to an agent, use the
|
[swarm UI](../swarm/ui.md), and `hivectl watch` follows it from the command
|
||||||
terminal in the [swarm UI](../swarm/ui.md). Like the hive dashboard, it
|
line. What the server offers:
|
||||||
keeps shrinking, bit by bit.
|
|
||||||
|
|
||||||
- **Header**: the agent's icon and name, a state badge (idle, thinking, needs
|
- **Stats page**: the agent's turn statistics. The same figures are in
|
||||||
login), and pills for its inbox and todos. Selecting a pill opens the list in
|
Grafana's `agents` board.
|
||||||
a side panel. The inbox panel has **mark all read**, and the todos panel lets
|
- **Screen page**: a live view of the agent's desktop, for an agent with a GUI.
|
||||||
you dismiss todos.
|
- **Dashboard card data**: the status text and the links the hive dashboard shows
|
||||||
- **State badge menu**: **cancel turn** stops the turn in flight, **new session**
|
for the agent.
|
||||||
starts the next turn without the resume session, and **log out** wipes the
|
|
||||||
agent's claude login (it then waits in `needs_login`).
|
|
||||||
- **Stats page**: the agent's turn statistics. The same figures are in Grafana's
|
|
||||||
`agents` board.
|
|
||||||
|
|
||||||
The header's parts, the live view, the endpoints the page and the harness serve,
|
The endpoints and the stats page are in
|
||||||
and the stats page are in
|
[the per-agent web server reference](../../4-implementation/web-ui/agent-page.md).
|
||||||
[the agent page reference](../../4-implementation/web-ui/agent-page.md).
|
|
||||||
|
|
|
||||||
|
|
@ -36,17 +36,17 @@ The dashboard is a single page with these tabs:
|
||||||
- **K3PT ST4T3** — kept state from agents with no container (tombstones),
|
- **K3PT ST4T3** — kept state from agents with no container (tombstones),
|
||||||
with a purge button per entry.
|
with a purge button per entry.
|
||||||
|
|
||||||
Each agent also has its own page, a full terminal view of that agent's
|
Each agent also serves a small web server, with its stats and screen pages: open
|
||||||
session. Select its name anywhere in the dashboard, or open `/agent/<name>/`
|
`/agent/<name>/` (or `http://<host>:<port>/` if the gateway isn't in front).
|
||||||
(or `http://<host>:<port>/` if the gateway isn't in front). [The agent's web page](../agents/web-page.md)
|
[The agent's web server](../agents/web-page.md) covers it. To watch an agent
|
||||||
covers it.
|
work, use its terminal in the swarm UI.
|
||||||
|
|
||||||
## The things you do here
|
## The things you do here
|
||||||
|
|
||||||
**Check on an agent.** 4G3NTS shows every container as a row: name, whether
|
**Check on an agent.** 4G3NTS shows every container as a row: name, whether
|
||||||
it's running, what it's doing (a live status pill such as `rebuilding…` or
|
it's running, what it's doing (a live status pill such as `rebuilding…` or
|
||||||
`starting…` while something's in flight), and quick links (stats, screen).
|
`starting…` while something's in flight), and quick links (stats, screen).
|
||||||
Select the name to open its terminal and watch it work.
|
Open the agent in the swarm UI to watch it work.
|
||||||
|
|
||||||
**Review a config change.** Agent config changes (new packages, env vars, MCP
|
**Review a config change.** Agent config changes (new packages, env vars, MCP
|
||||||
servers) are pull requests on the agent's `agent-configs` repo. Review and
|
servers) are pull requests on the agent's `agent-configs` repo. Review and
|
||||||
|
|
@ -79,9 +79,8 @@ schedules card on the swarm UI's messages tab ([`swarm-ui.md`](../../4-implement
|
||||||
|
|
||||||
## More depth
|
## More depth
|
||||||
|
|
||||||
The dashboard and the per-agent pages are single-page apps that share one
|
The dashboard is a single-page app: `GET /` returns a static shell, `/api/state`
|
||||||
skeleton: `GET /` returns a static shell, `/api/state` returns JSON, and
|
returns JSON, and JavaScript renders, with no full-page reloads.
|
||||||
JavaScript renders, with no full-page reloads.
|
|
||||||
|
|
||||||
- **[Shape (shared by both)](../../4-implementation/web-ui/shape.md)** — the
|
- **[Shape (shared by both)](../../4-implementation/web-ui/shape.md)** — the
|
||||||
SPA skeleton, SSE multiplexing, terminal pane, listener bind, per-agent
|
SPA skeleton, SSE multiplexing, terminal pane, listener bind, per-agent
|
||||||
|
|
@ -105,10 +104,9 @@ For the code, these jump straight to the relevant section:
|
||||||
- **"What endpoints does the dashboard expose?"** →
|
- **"What endpoints does the dashboard expose?"** →
|
||||||
[`dashboard.md`](../../4-implementation/web-ui/dashboard.md) (Dashboard endpoints,
|
[`dashboard.md`](../../4-implementation/web-ui/dashboard.md) (Dashboard endpoints,
|
||||||
Dashboard event channel).
|
Dashboard event channel).
|
||||||
- **"How does the per-agent terminal render tool calls?"** →
|
- **"How does a terminal render tool calls?"** →
|
||||||
[`terminal-rendering.md`](../../4-implementation/web-ui/terminal-rendering.md)
|
[`terminal-rendering.md`](../../4-implementation/web-ui/terminal-rendering.md)
|
||||||
(the full row taxonomy and dispatch walkthrough); for a summary see
|
(the full row taxonomy and dispatch walkthrough).
|
||||||
[`agent-page.md`](../../4-implementation/web-ui/agent-page.md) (Per-stream rendering).
|
|
||||||
- **"Which CSS variable to use, and where are the colours defined?"** →
|
- **"Which CSS variable to use, and where are the colours defined?"** →
|
||||||
[`css-vars.md`](../../4-implementation/web-ui/css-vars.md) (Palette, the
|
[`css-vars.md`](../../4-implementation/web-ui/css-vars.md) (Palette, the
|
||||||
single-source `base.css` rule).
|
single-source `base.css` rule).
|
||||||
|
|
|
||||||
|
|
@ -17,7 +17,7 @@ always on), the gateway proxies all operator-facing traffic, and
|
||||||
## Two principals, two paths
|
## Two principals, two paths
|
||||||
|
|
||||||
- **Operator** — reaches every UI (the dashboard + every
|
- **Operator** — reaches every UI (the dashboard + every
|
||||||
per-agent page) through the gateway, on one origin.
|
per-agent web server) through the gateway, on one origin.
|
||||||
The core daemon serves operator-authority actions
|
The core daemon serves operator-authority actions
|
||||||
(answer-as-operator, lifecycle POSTs), reachable only via the
|
(answer-as-operator, lifecycle POSTs), reachable only via the
|
||||||
gateway.
|
gateway.
|
||||||
|
|
@ -67,13 +67,11 @@ netns-isolated for the same reason.
|
||||||
|
|
||||||
The boundary rests on three layers:
|
The boundary rests on three layers:
|
||||||
|
|
||||||
1. **Gateway** — fronts all surfaces (dashboard + every per-agent UI)
|
1. **Gateway** — fronts all surfaces (dashboard + every per-agent web
|
||||||
on one origin. An nginx nixos-container proxies per-agent UIs under
|
server) on one origin. An nginx nixos-container proxies the per-agent
|
||||||
`/agent/<name>/`, which is what lets each agent page's inbox panel
|
servers under `/agent/<name>/`, so the dashboard's links to them go
|
||||||
POST `mark-all-read` to the core dashboard's
|
same-origin instead of needing a cross-origin CORS shim. Pure
|
||||||
`/api/agent/{name}/mark-all-read` go same-origin instead of needing
|
ergonomics — no behavioural risk on its own.
|
||||||
a cross-origin CORS shim. Pure ergonomics — no behavioural risk on
|
|
||||||
its own.
|
|
||||||
2. **Network isolation** — the load-bearing layer: every agent
|
2. **Network isolation** — the load-bearing layer: every agent
|
||||||
container runs in a private netns behind the hive bridge, always
|
container runs in a private netns behind the hive bridge, always
|
||||||
on and unconditional. This is what turns the operator/agent split
|
on and unconditional. This is what turns the operator/agent split
|
||||||
|
|
|
||||||
|
|
@ -379,7 +379,7 @@ checking file existence):
|
||||||
|
|
||||||
| request | resolved | outcome |
|
| request | resolved | outcome |
|
||||||
| --- | --- | --- |
|
| --- | --- | --- |
|
||||||
| `/agent/iris/` | `<frontend>/index.html` | main agent page |
|
| `/agent/iris/` | no file match → `@iris_dynamic` | proxied to the agent daemon, which redirects to `stats` |
|
||||||
| `/agent/iris/stats` | `<frontend>/stats.html` | stats page |
|
| `/agent/iris/stats` | `<frontend>/stats.html` | stats page |
|
||||||
| `/agent/iris/screen` | `<frontend>/screen.html` | screen page |
|
| `/agent/iris/screen` | `<frontend>/screen.html` | screen page |
|
||||||
| `/agent/iris/static/app.js` | caught by `^~` block first | served with immutable cache |
|
| `/agent/iris/static/app.js` | caught by `^~` block first | served with immutable cache |
|
||||||
|
|
|
||||||
|
|
@ -71,7 +71,7 @@ time the first time it reads the same number.
|
||||||
- it logs the agent out when the store holds nothing although a version was
|
- it logs the agent out when the store holds nothing although a version was
|
||||||
installed: the operator deleted the stored login. A read that failed never
|
installed: the operator deleted the stored login. A read that failed never
|
||||||
does it, since an unreachable store says nothing about the login. The
|
does it, since an unreachable store says nothing about the login. The
|
||||||
logout is the one `/api/logout` does, and the recorded version is
|
logout wipes the credential files and flips the agent to `needs_login`, and the recorded version is
|
||||||
forgotten so the next login installs.
|
forgotten so the next login installs.
|
||||||
|
|
||||||
## Credentials
|
## Credentials
|
||||||
|
|
|
||||||
|
|
@ -95,8 +95,8 @@ primary mechanism; hyperhive still owns that). `outputStyle` is fleet-wide
|
||||||
preamble/recap Concise drops carries no information a turn-loop consumer
|
preamble/recap Concise drops carries no information a turn-loop consumer
|
||||||
needs.
|
needs.
|
||||||
|
|
||||||
**Session reset** is available via `POST /api/new-session` (the state
|
**Session reset** is available as `/clear` in the swarm UI's message box
|
||||||
badge's `new session` menu row). It does _not_ touch the session inline —
|
(`POST /api/agents/<name>/new-session`, a command on the agent's control subject). It does _not_ touch the session inline —
|
||||||
that would race a mid-write claude process. Instead `Bus::request_session_reset()`
|
that would race a mid-write claude process. Instead `Bus::request_session_reset()`
|
||||||
sets a one-shot flag consumed at the next turn boundary by `drive_turn`,
|
sets a one-shot flag consumed at the next turn boundary by `drive_turn`,
|
||||||
which **archives** the current session: it renames the backing
|
which **archives** the current session: it renames the backing
|
||||||
|
|
|
||||||
|
|
@ -30,7 +30,7 @@ services.hyperhive.agent.icon = ./icon.svg; # default: null (falls back to shar
|
||||||
```
|
```
|
||||||
|
|
||||||
Path to an SVG file used as this agent's visual identity — shown in
|
Path to an SVG file used as this agent's visual identity — shown in
|
||||||
the per-agent page header, as the page favicon, and uploaded to the
|
the swarm UI's agent card, as the page favicon, and uploaded to the
|
||||||
agent's Forgejo profile avatar (via the `forge-avatar-sync` boot
|
agent's Forgejo profile avatar (via the `forge-avatar-sync` boot
|
||||||
unit) and Matrix profile avatar (set by `hive-matrix-daemon` over its
|
unit) and Matrix profile avatar (set by `hive-matrix-daemon` over its
|
||||||
live Client). Commit the SVG next to `agent.nix` in the config repo
|
live Client). Commit the SVG next to `agent.nix` in the config repo
|
||||||
|
|
@ -73,8 +73,8 @@ services.hyperhive.agent.dashboardLinks = [
|
||||||
];
|
];
|
||||||
```
|
```
|
||||||
|
|
||||||
Declares extra navigation links that appear in the per-agent page
|
Declares extra navigation links that appear in the hive dashboard's agent row
|
||||||
header alongside the built-in forge / config / container links. Each
|
alongside the built-in stats and screen links. Each
|
||||||
entry has:
|
entry has:
|
||||||
|
|
||||||
| Field | Required | Description |
|
| Field | Required | Description |
|
||||||
|
|
|
||||||
|
|
@ -171,9 +171,9 @@ addition to the broadcast channel and the events history. Variants:
|
||||||
The harness flips state at the relevant transitions
|
The harness flips state at the relevant transitions
|
||||||
(`set_state(Thinking)` before `drive_turn`, `set_state(Idle)`
|
(`set_state(Thinking)` before `drive_turn`, `set_state(Idle)`
|
||||||
after; `set_state(Compacting)` around an idle operator compact in
|
after; `set_state(Compacting)` around an idle operator compact in
|
||||||
`turn::run_pending_compact`). Exposed via `/api/state.turn_state` +
|
`turn::run_pending_compact`). Published to the swarm queue as `turn_state` +
|
||||||
`turn_state_since` (unix seconds); the agent page renders this rather
|
`turn_state_since` (unix seconds), which the swarm UI renders rather
|
||||||
than deriving from SSE events.
|
than deriving from the terminal rows.
|
||||||
|
|
||||||
## Tool envelope
|
## Tool envelope
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,325 +1,43 @@
|
||||||
# Per-agent page: header, live view and endpoints
|
# Per-agent web server: stats, screen and endpoints
|
||||||
|
|
||||||
The page each agent's harness serves: header, live view, side panel, actions,
|
What each agent's harness serves on its own port: the stats page, the GUI
|
||||||
its endpoints and the stats page. The operator's overview is
|
screen page, the stream `hivectl watch` reads, the dashboard card's state and
|
||||||
[the agent page](../../2-handbook/agents/web-page.md).
|
the extra proxies. The operator's overview is
|
||||||
|
[the agent web server](../../2-handbook/agents/web-page.md). The agent has no
|
||||||
Two fixed-position layers frame a full-viewport terminal: a header and
|
terminal page of its own: the live terminal and its message box are in the swarm
|
||||||
scrollable main content — plus a slide-in side panel for flyouts and long
|
UI.
|
||||||
content. The page has no message box: to write to an agent, use the swarm
|
|
||||||
UI's terminal.
|
|
||||||
|
|
||||||
## Header
|
|
||||||
|
|
||||||
Preact component tree (`Header.tsx` + `StatusChips.tsx` +
|
|
||||||
`MetaNav.tsx` + `HeaderPill.tsx`, wired together in `Root.tsx`) — see
|
|
||||||
`frontend/packages/agent/src/components/`. This section describes the
|
|
||||||
rendered component tree: every element is Preact component output.
|
|
||||||
|
|
||||||
**Fixed-overlay header** (`<header class="agent-header">`): frosted
|
|
||||||
glass — `backdrop-filter: blur` lets scrolled terminal rows show
|
|
||||||
through. Measures its own rendered height via `ResizeObserver`
|
|
||||||
(`Header.tsx`) and writes it to a CSS custom property the content
|
|
||||||
below reads for its offset, so content never overlaps the header
|
|
||||||
regardless of how many rows of badges/pills wrap onto an extra line
|
|
||||||
at a given viewport width. Two columns:
|
|
||||||
|
|
||||||
<!-- vale write-good.Passive = NO -->
|
|
||||||
|
|
||||||
- **Agent icon** (`<img class="agent-icon">`): fixed-size square
|
|
||||||
identity anchor — `width: 5em; height: 5em` with explicit pixel
|
|
||||||
sizing so the `<img>`'s intrinsic (large) dimensions don't push
|
|
||||||
the parent flex container open via `align-items: stretch`-driven
|
|
||||||
height feedback. Falls back to the dimmed hyperhive mark
|
|
||||||
(`/favicon.svg`) on load error (`/icon` 404s when the agent has no
|
|
||||||
`services.hyperhive.agent.icon` override — there is no server-side default image).
|
|
||||||
- **Main column** (`.agent-header-main`, `Header.tsx`): two rows —
|
|
||||||
title (`◆ <label> ◆`) and, when set, the "swarm / hive" identity
|
|
||||||
line. Nothing else lives here; both rows are short, fixed-shape text
|
|
||||||
that doesn't wrap in practice, so this column's height stays stable
|
|
||||||
regardless of how many badges or pills are showing (a design
|
|
||||||
correction mid-review — the first pass put the variable-width
|
|
||||||
content here instead, which is exactly the kind of thing the
|
|
||||||
`ResizeObserver` measurement above exists to catch even when a
|
|
||||||
layout choice reintroduces it).
|
|
||||||
- **Pills cluster** (`.agent-header-pills`, right-aligned): status
|
|
||||||
badges (`StatusChips.tsx`) and flyout triggers together in one row,
|
|
||||||
so the header reads as one identity zone + one status/actions zone:
|
|
||||||
- **Status badge**, one badge for liveness and turn state: `● alive`
|
|
||||||
(green) / `⊘ rate limited` (red) / `◌ needs login` / `◌ logging in` /
|
|
||||||
`○ offline` / `… connecting` / `💤 idle` / `🧠 thinking` /
|
|
||||||
`📦 compacting` / `… booting` + age suffix, or paused. Selecting it
|
|
||||||
opens a menu: `⏸ pause` / `▶ resume` (via the same hive-c0re-owned
|
|
||||||
`/api/pause/<name>` / `/api/resume/<name>` endpoints the dashboard
|
|
||||||
uses; pausing needs a write this unprivileged process can't make
|
|
||||||
directly), `■ cancel turn` (only while a turn is running),
|
|
||||||
`↻ new session` and `🔓 logout`. Cancel turn, new session and logout
|
|
||||||
need a second selection to confirm.
|
|
||||||
- **Model and effort badges** (`model · <name>`, `effort · <level>`):
|
|
||||||
display only. Each tooltip says where the value comes from
|
|
||||||
(`state.model_source` / `state.effort_source`: set on the swarm,
|
|
||||||
agent.nix, an existing `hyperhive-model` / `hyperhive-effort` file, or
|
|
||||||
the built-in default); the model's also says what the last turn
|
|
||||||
resolved it to. Both are set on the swarm: the swarm UI's agents page,
|
|
||||||
or `swarmctl agent inference set`
|
|
||||||
([`inference.md`](../swarm/inference.md)).
|
|
||||||
- On an ACP agent each badge shows the session's own value when it
|
|
||||||
doesn't offer the requested one. The effort badge is hidden
|
|
||||||
(`state.effort` is `null`) until the first turn has attached a
|
|
||||||
session, when the model offers no effort levels, and while a newly
|
|
||||||
set model waits for the next turn, since the levels come with the
|
|
||||||
model.
|
|
||||||
- **Ctx / cost badges**: `ctx · 142k` (last inference's prompt size,
|
|
||||||
tooltip shows % of context window) / `cost · 1.3M` (cumulative
|
|
||||||
tokens billed across every inference in the last turn).
|
|
||||||
- **Inbox / todos pills** (`📬 inbox · N` / `📋 todos · N`): hidden
|
|
||||||
when empty; selecting it opens the matching flyout in the side panel.
|
|
||||||
- **Profile avatar**: the signed-in user's initial, opening a popover with
|
|
||||||
their name and links to authelia's settings and sign-out pages, as on the
|
|
||||||
dashboard (`AgentUserMenu.tsx`). It shows only behind the gateway, where
|
|
||||||
the page shares the dashboard's origin and session; opened on the agent's
|
|
||||||
own port there is no sign-in and no avatar. The name comes from the
|
|
||||||
dashboard's `/api/whoami`, authelia's URL from the dashboard's
|
|
||||||
`/api/state`.
|
|
||||||
- **Links badge** (`🔗`): opens a popover listing `↑ dashboard`
|
|
||||||
(back-link to the host dashboard, `${dashboardBase}`)
|
|
||||||
followed by this agent's `agent_links()`-sourced navigation (stats,
|
|
||||||
screen when VNC is enabled, any `services.hyperhive.agent.dashboardLinks`
|
|
||||||
extras) — all as real `<a>` elements, not a `Dropdown`-style
|
|
||||||
command list, so ctrl/middle-click and "copy link address" keep
|
|
||||||
working. Each `AgentLink.kind` resolves differently: `container` →
|
|
||||||
same-origin path; `external` → already absolute. Same source
|
|
||||||
(`GET /api/state`'s `links` field) also feeds
|
|
||||||
`DashboardState.links` for the dashboard card's icon strip —
|
|
||||||
`agent_links()` in hive-agent is the single source of truth for
|
|
||||||
both. The dashboard link lives in this 🔗 popover. `cancel turn`,
|
|
||||||
`new session` and `log out` are rows of the state badge's menu, each
|
|
||||||
with a click-again confirm (see Actions below).
|
|
||||||
<!-- vale write-good.Passive = YES -->
|
|
||||||
|
|
||||||
Values throughout come from `GET /api/state`'s cold-load snapshot,
|
|
||||||
kept in sync afterwards by the SSE stream (see Live view below) —
|
|
||||||
`qualified_label`
|
|
||||||
(the hive-qualified `name@domain` form, used for the browser tab title
|
|
||||||
so two tabs from different hives are distinguishable; the header's own
|
|
||||||
`◆ <label> ◆` stays short).
|
|
||||||
|
|
||||||
## Main content
|
|
||||||
|
|
||||||
**Main content** (`<main class="agent-main">`): fills the viewport
|
|
||||||
and scrolls behind the fixed header + footer.
|
|
||||||
|
|
||||||
<!-- vale write-good.Passive = NO -->
|
|
||||||
|
|
||||||
- `#status` overlay: empty when online; shows the login form / OAuth
|
|
||||||
URL when `status` is `needs_login_*`. The OAuth code input is
|
|
||||||
`type="password"` with a `👁 reveal` toggle that flips it back to
|
|
||||||
`text` on press so the operator can sanity-check the paste before
|
|
||||||
submit — avoids accidental on-screen token exposure to
|
|
||||||
shoulder-surfers or screenshots. `autocomplete="one-time-code"`
|
|
||||||
is the semantic value for OAuth codes (per WHATWG): browsers may
|
|
||||||
silently ignore `autocomplete="off"` on `type="password"`, but
|
|
||||||
browsers honour `one-time-code` and suppress the "save password
|
|
||||||
for this site?" prompt that would otherwise fire on submit.
|
|
||||||
- Terminal-wrap: live event tail (sticky-bottom autoscroll +
|
|
||||||
`↓ N new` pill when not at bottom). The pill is **anchored in
|
|
||||||
`.agent-main`**, not in `log.parentElement = .terminal-wrap`:
|
|
||||||
`.terminal-wrap` applies `backdrop-filter: blur` for the frost
|
|
||||||
effect, which creates a CSS stacking context — anchoring the
|
|
||||||
pill inside that context would confine its `z-index` below the
|
|
||||||
fixed header in the root stacking context, and it'd never
|
|
||||||
float. `.agent-main` has no backdrop-filter (no stacking-context
|
|
||||||
creators), so the pill's `z-index` reaches the root and properly
|
|
||||||
composites above the header. Geometry is unchanged —
|
|
||||||
`.agent-main` and `.terminal-wrap` both `inset: 0` fill the same
|
|
||||||
area.
|
|
||||||
<!-- vale write-good.Passive = YES -->
|
|
||||||
|
|
||||||
## Side panel
|
|
||||||
|
|
||||||
**Side panel** (slide-in from right): singleton shared with the
|
|
||||||
dashboard's side panel shape. Carries inbox and todos flyouts (opened
|
|
||||||
via the header pills) as well as long content (file previews, diffs,
|
|
||||||
journald logs). Inbox flyout: unread messages addressed to this agent
|
|
||||||
(`acked_at IS NULL`, newest-first, up to 30); reply messages indented
|
|
||||||
with `↳ reply ·` in amber. A `✓ mark all read` button appears in the
|
|
||||||
flyout header when the inbox is non-empty; selecting it confirms then
|
|
||||||
POSTs cross-origin to the core dashboard's `POST
|
|
||||||
/api/agent/{name}/mark-all-read`, which acks all pending messages for
|
|
||||||
this agent so the harness won't receive wake-prompts for them. A `{
|
|
||||||
marked: N }` pill surfaces the count. After the drain the inbox list
|
|
||||||
empties on reload (the filter is `acked_at IS NULL`, so drained
|
|
||||||
messages disappear). Todos flyout ("loose-ends v2"): the harness-local
|
|
||||||
todos other subsystems push at this agent (`GET /api/todos`) — matrix,
|
|
||||||
forge, and bash are the built-in producers, but any user-configured MCP
|
|
||||||
server can push its own via the same in-agent socket. Each row shows the
|
|
||||||
producing subsystem, an
|
|
||||||
optional source label, a summary, and age. A checkbox per row plus a
|
|
||||||
select-all / select-none / `✓ mark done` bulk row above the list POSTs
|
|
||||||
the checked ids to `POST /api/todos/mark-done`, which dismisses them
|
|
||||||
from the harness-local store (same effect as `cancel_loose_end(kind:
|
|
||||||
"todo")`, just from the web UI instead of the agent's own tool calls).
|
|
||||||
If the todo store errors or doesn't answer for any id, the endpoint returns
|
|
||||||
500 naming how many ids failed, and the panel shows `failed: …` instead of
|
|
||||||
`✓ marked done`. The calls share one 3-second deadline, so a stalled store
|
|
||||||
gets its 500 after about 3 seconds however many ids you check; ids not
|
|
||||||
answered by then count as failed. A request with more than 200 ids gets a 400.
|
|
||||||
|
|
||||||
## Live view
|
|
||||||
|
|
||||||
Each agent runs an `events::Bus`: a `tokio::sync::broadcast<LiveEvent>`
|
|
||||||
plus a sqlite-backed history at `/harness/hyperhive-events.sqlite`.
|
|
||||||
The harness emits `TurnStart { from, body, unread }`,
|
|
||||||
`Stream(value)` (one per parsed stream-json line), `Note`,
|
|
||||||
`TurnEnd { ok, note }`. Each event also carries a `ts` (unix
|
|
||||||
seconds) — a flattened sibling of the event tag on both the live
|
|
||||||
SSE frame and the replayed history rows. The web UI:
|
|
||||||
|
|
||||||
- fetches `GET /events/history` on page load and replays the last
|
|
||||||
2000 events (oldest first);
|
|
||||||
- then subscribes to `GET /events/stream` (SSE) for live tail;
|
|
||||||
- shows a granular state badge above the terminal, driven
|
|
||||||
authoritatively from `/api/state.turn_state`. SSE turn_start /
|
|
||||||
turn_end still flip the badge instantly between renders;
|
|
||||||
- terminal-themed: phosphor mauve glow, Crust bg,
|
|
||||||
backdrop-filter blur, row fade-in slide-up.
|
|
||||||
|
|
||||||
The backfill/live-tail dedupe, sticky-bottom autoscroll, and "↓ N
|
|
||||||
new" pill are the shared terminal-pane mechanics described in
|
|
||||||
[Shape](../web-ui/shape.md#shared-terminal-pane) — this page's log is one
|
|
||||||
instance of that same factory.
|
|
||||||
|
|
||||||
Per-stream rendering (see [`docs/4-implementation/web-ui/terminal-rendering.md`](../web-ui/terminal-rendering.md) for
|
|
||||||
the full row taxonomy and dispatch logic):
|
|
||||||
|
|
||||||
- `Stream` `tool_use` →
|
|
||||||
- `Write` / `Edit`: collapsed `<details>` with a +/- diff body
|
|
||||||
(`-` lines from `input.old_string`, `+` lines from
|
|
||||||
`input.new_string` or every line of `input.content`).
|
|
||||||
Summary carries the path + line counts.
|
|
||||||
- others (`Read /path`, `Bash $ cmd`, `mcp__matrix__send_dm →
|
|
||||||
iris: "..."`, etc.): flat one-line per-tool format with
|
|
||||||
per-tool salient-arg extraction (`fmtToolUse`).
|
|
||||||
- `Stream` `tool_result` short → flat `← ...`; long → collapsed
|
|
||||||
`<details>` `▸ ← Nl · headline` (select to expand full body).
|
|
||||||
- `Stream` `thinking` → `.thinking` row with a `💭 thinking …`
|
|
||||||
indicator.
|
|
||||||
- `Stream` `system` → handled by subtype: `plugin_install` and
|
|
||||||
`compact_boundary` emit muted notes; `commands_changed` emits an
|
|
||||||
expandable details row listing slash commands; `thinking_tokens`
|
|
||||||
updates a single in-place `🧠` counter; `init`, `result`, and
|
|
||||||
`rate_limit_event` drop silently (noise / used elsewhere); other
|
|
||||||
subtypes → muted `⚙ <subtype>` note.
|
|
||||||
- `Note` → `· text`.
|
|
||||||
- `TurnStart` → `◆ TURN ← <from>` with the wake-prompt body; a
|
|
||||||
muted `· HH:MM:SS` time suffix from the event `ts`.
|
|
||||||
- `TurnEnd` → `✓ turn ok` / `✗ turn fail — note`, with a
|
|
||||||
`· HH:MM:SS · <duration>` suffix (duration = end − the paired
|
|
||||||
turn-start), triggers a `refreshState()`. The time suffix is
|
|
||||||
guarded on a numeric `ts`, so rows degrade cleanly when absent.
|
|
||||||
|
|
||||||
## Actions
|
|
||||||
|
|
||||||
The state badge's menu carries the actions on the agent's claude:
|
|
||||||
|
|
||||||
- `cancel turn` — `POST /api/cancel` → SIGINT to the turn's claude and every
|
|
||||||
command it started (its process group), emits a Note. On an ACP agent
|
|
||||||
it sends the agent `session/cancel` instead, and SIGINT if the turn
|
|
||||||
hasn't ended 10s later. Offered while the state is `thinking`.
|
|
||||||
- `new session` — `POST /api/new-session` (confirms first).
|
|
||||||
Arms a one-shot on the Bus; next turn runs without
|
|
||||||
`--continue`, dropping the resume session entirely.
|
|
||||||
- `log out` — `POST /api/logout` (confirms first). Wipes OAuth
|
|
||||||
credential files, parks the agent in `needs_login`, and preserves
|
|
||||||
session history (`~/.claude/projects/`).
|
|
||||||
|
|
||||||
The agent's `compact` MCP tool sets the deferred `Bus::request_compact()` flag and
|
|
||||||
returns immediately. The harness runs the `/compact` at the next turn
|
|
||||||
boundary (end of the in-flight turn, or `turn::run_pending_compact` when
|
|
||||||
idle); output streams into the live panel, which ends with a `/compact done`
|
|
||||||
or `/compact failed: …` note. It works mid-turn, not only when idle.
|
|
||||||
|
|
||||||
## Per-agent endpoints
|
## Per-agent endpoints
|
||||||
|
|
||||||
Successful POSTs return 200 (no 303 redirects). Error responses
|
|
||||||
use semantic status codes: **400** for missing/malformed input
|
|
||||||
(`/api/todos/mark-done` with no todo ids), **500** only for genuine
|
|
||||||
server/transport failures. A queued `/compact` never conflicts: it
|
|
||||||
runs at the end of the current turn. The matching
|
|
||||||
mutations fire `LiveEvent` variants on the per-agent bus, so the
|
|
||||||
client doesn't refetch `/api/state` on submit — the SSE stream
|
|
||||||
delivers the new state faster anyway.
|
|
||||||
|
|
||||||
The agent has no login flow of its own. An agent without credentials
|
The agent has no login flow of its own. An agent without credentials
|
||||||
reports `needs_login_idle`, the operator logs in from the swarm UI, and the
|
reports `needs_login_idle`, the operator logs in from the swarm UI, and the
|
||||||
credentials arrive from the swarm secret store.
|
credentials arrive from the swarm secret store.
|
||||||
|
|
||||||
- `POST /api/cancel` — SIGINT the in-flight claude turn and the
|
- `GET /api/state` — `{label, dashboard_port}`: the agent's name, for the stats
|
||||||
commands it started. Emits a `LiveEvent::Note`.
|
and screen pages' titles and the screen's login, and the hive dashboard's port
|
||||||
- `POST /api/new-session` — arm a one-shot for the next turn to
|
for their way back.
|
||||||
drop `--continue`. Emits a `LiveEvent::Note`.
|
|
||||||
- `POST /api/logout` — three-step teardown that re-uses the
|
|
||||||
existing `wait_for_login` resumption path:
|
|
||||||
1. SIGINT any running claude (matches `/api/cancel`'s pattern —
|
|
||||||
idempotent no-op when nothing is running) so the credential
|
|
||||||
wipe doesn't race a mid-API-call turn.
|
|
||||||
2. Delete only the OAuth credential files
|
|
||||||
(`.credentials.json` + `mcp-needs-auth-cache.json` under
|
|
||||||
`~/.claude/`). **Preserves** session history files
|
|
||||||
(`projects/<hash>/*.jsonl`), sessions, shell-snapshots,
|
|
||||||
plans, settings, telemetry, and the dir itself, so
|
|
||||||
`claude --continue` keeps working after a fresh login.
|
|
||||||
⚠️ Deleting the whole `~/.claude/` directory instead breaks
|
|
||||||
session continuity — logout must stay narrowed to just the
|
|
||||||
credential files.
|
|
||||||
3. Flip `LoginState::NeedsLogin` + emit a `LiveEvent::Note`
|
|
||||||
naming the files it just deleted, then emit
|
|
||||||
`needs_login_idle`. The turn-loop's next iteration parks
|
|
||||||
into `wait_for_login`, which snapshots the credential dir
|
|
||||||
(now missing the wiped files) and resumes when a fresh
|
|
||||||
credentials file appears (a login from the swarm UI stores one,
|
|
||||||
and the agent installs it).
|
|
||||||
|
|
||||||
Always returns 200 with a body describing what happened — it
|
|
||||||
folds per-file errors into the response + the Note so the
|
|
||||||
operator sees them in the live panel rather than as an HTTP
|
|
||||||
error. Missing files (already logged out) count as
|
|
||||||
idempotent.
|
|
||||||
|
|
||||||
- `GET /api/state` — cold-load snapshot (`StateSnapshot`) consumed by
|
|
||||||
the frontend (`useAgentState.ts`) on page load. Includes `turn_state`,
|
|
||||||
`qualified_label`,
|
|
||||||
`model`, `model_source`, `effort`, `effort_source`, `links`, and
|
|
||||||
other fields described inline throughout this document. All
|
|
||||||
subsequent state updates arrive via SSE.
|
|
||||||
- `GET /api/dashboard-state` — lean snapshot of agent-owned fields
|
- `GET /api/dashboard-state` — lean snapshot of agent-owned fields
|
||||||
fetched once per running agent by the dashboard's container row to
|
fetched once per running agent by the dashboard's container row to
|
||||||
get fresh values without relying on hive-c0re's periodic file-reads.
|
get fresh values without relying on hive-c0re's periodic file-reads.
|
||||||
Returns `{ status_text?, status_set_at?, rate_limited, links }`. Only called when the container is running;
|
Returns `{ status_text?, status_set_at?, rate_limited, links }`. Only called when the container is running;
|
||||||
skipped (muted badges) when stopped. Also accessible via the gateway
|
skipped (muted badges) when stopped. Also accessible via the gateway
|
||||||
at `/agent/<name>/api/dashboard-state`.
|
at `/agent/<name>/api/dashboard-state`.
|
||||||
- `GET /api/todos` — harness-local todos snapshot (loose-ends v2)
|
|
||||||
consumed by the todos flyout (`refreshTodos` / `buildTodosList`).
|
|
||||||
See the todos-flyout paragraph above for the producer/subsystem
|
|
||||||
model and the bulk mark-done row.
|
|
||||||
- `GET /api/stats?window=24h|7d|30d|all` — time-bucketed turn analytics
|
- `GET /api/stats?window=24h|7d|30d|all` — time-bucketed turn analytics
|
||||||
`Snapshot` consumed by the `/stats` page. `all` ranges from the
|
`Snapshot` consumed by the `/stats` page. `all` ranges from the
|
||||||
earliest recorded turn with an adaptive bucket width.
|
earliest recorded turn with an adaptive bucket width.
|
||||||
- `GET /icon` — agent's icon as `image/svg+xml`. Returns
|
- `GET /icon` — agent's icon as `image/svg+xml`. Returns
|
||||||
`/etc/hyperhive/icon.svg` (set via `services.hyperhive.agent.icon` in `agent.nix`)
|
`/etc/hyperhive/icon.svg` (set via `services.hyperhive.agent.icon` in `agent.nix`)
|
||||||
when present, otherwise **404** — there is no server-side default.
|
when present, otherwise **404** — there is no server-side default.
|
||||||
Consumers (dashboard container row, this page's own header icon)
|
Consumers (the dashboard container row)
|
||||||
hit `/icon` optimistically and fall back client-side on load failure
|
hit `/icon` optimistically and fall back client-side on load failure
|
||||||
to the frontend-bundled `/favicon.svg` rather than probing first.
|
to the frontend-bundled `/favicon.svg` rather than probing first.
|
||||||
- `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
|
||||||
desktop + forward pointer + keyboard. A production-grade viewer
|
desktop + forward pointer + keyboard. A production-grade viewer
|
||||||
would vendor noVNC; this file ships the minimal in-tree variant).
|
would vendor noVNC; this file ships the minimal in-tree variant).
|
||||||
Only accessible when `services.hyperhive.agent.gui.enable = true` in the agent's
|
Only accessible when `services.hyperhive.agent.gui.enable = true` in the agent's
|
||||||
`agent.nix`; the harness shows a 🖥 screen link in the state row
|
`agent.nix`; the harness shows a 🖥 screen link in the state row
|
||||||
when `gui_vnc_port` is present. A `← agent` back-link in the page
|
when `gui_vnc_port` is present. Controls: `⤢ fit` CSS-downscales
|
||||||
header returns to the main per-agent page. Controls: `⤢ fit` CSS-downscales
|
|
||||||
the canvas to the window via `relayoutCanvas()` setting explicit
|
the canvas to the window via `relayoutCanvas()` setting explicit
|
||||||
pixel dimensions on the canvas — _not_ CSS `max-width/max-height`,
|
pixel dimensions on the canvas — _not_ CSS `max-width/max-height`,
|
||||||
because a flex item's automatic minimum size (`min-width: auto`
|
because a flex item's automatic minimum size (`min-width: auto`
|
||||||
|
|
@ -354,8 +72,11 @@ credentials arrive from the swarm secret store.
|
||||||
spelled `unix:<path>` (for example `unix:/run/myapp/http.sock`) — dialed
|
spelled `unix:<path>` (for example `unix:/run/myapp/http.sock`) — dialed
|
||||||
directly with a raw HTTP/1.1 client per request, since `reqwest` has
|
directly with a raw HTTP/1.1 client per request, since `reqwest` has
|
||||||
no UDS transport. Implemented in `web_ui/proxy.rs`.
|
no UDS transport. Implemented in `web_ui/proxy.rs`.
|
||||||
|
- `GET /events/stream` — the live SSE stream of classified terminal rows, which
|
||||||
|
`hivectl watch` reads. The swarm UI shows the same rows from the swarm queue.
|
||||||
|
- `GET /` redirects to `/stats`.
|
||||||
|
|
||||||
Bus events (new vocabulary on `/events/stream`):
|
Bus events on `/events/stream`:
|
||||||
|
|
||||||
- `status_changed { status }` — `online` / `rate_limited` /
|
- `status_changed { status }` — `online` / `rate_limited` /
|
||||||
`needs_login_idle`. Drives the
|
`needs_login_idle`. Drives the
|
||||||
|
|
@ -376,10 +97,8 @@ Bus events (new vocabulary on `/events/stream`):
|
||||||
|
|
||||||
## Stats page
|
## Stats page
|
||||||
|
|
||||||
`GET /stats` is a separate per-agent page (served by the
|
`GET /stats` is a per-agent page (served by the
|
||||||
harness, linked from the per-agent page's `📊 stats →` and from
|
harness, linked from each dashboard container row). Turn analytics, read-only, from
|
||||||
each dashboard container row). A `← live` back-link in the page
|
|
||||||
header returns to the main per-agent page. 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|all` 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
|
||||||
|
|
|
||||||
|
|
@ -45,8 +45,7 @@
|
||||||
dashboard stream carries broker `Sent` / `Delivered` (mirrored
|
dashboard stream carries broker `Sent` / `Delivered` (mirrored
|
||||||
by a forwarder task from the broker's intra-process channel)
|
by a forwarder task from the broker's intra-process channel)
|
||||||
plus mutation events (`transient_set` / `transient_cleared`). The
|
plus mutation events (`transient_set` / `transient_cleared`). The
|
||||||
agent's matching backfill endpoint is `GET /events/history` (last 2000
|
agent's own stream is `GET /events/stream`.
|
||||||
`LiveEvent`s wrapped in `{ seq, events }`).
|
|
||||||
**One unified channel**: browsers cap concurrent SSE
|
**One unified channel**: browsers cap concurrent SSE
|
||||||
connections per origin (~6 in Chrome). Using one channel per
|
connections per origin (~6 in Chrome). Using one channel per
|
||||||
domain would exhaust this budget on a live hive; dispatching
|
domain would exhaust this budget on a live hive; dispatching
|
||||||
|
|
@ -79,7 +78,7 @@
|
||||||
## Shared terminal pane
|
## Shared terminal pane
|
||||||
|
|
||||||
The shared terminal factory in `@hive/shared/terminal.js` backs the
|
The shared terminal factory in `@hive/shared/terminal.js` backs the
|
||||||
per-agent page's scrollable log stream (`#live`). The factory wires up
|
scrollable log stream. The factory wires up
|
||||||
sticky-bottom autoscroll, a "↓ N new" pill, history backfill, and
|
sticky-bottom autoscroll, a "↓ N new" pill, history backfill, and
|
||||||
SSE replay. Pages register a `kind → renderer` map; unknown kinds
|
SSE replay. Pages register a `kind → renderer` map; unknown kinds
|
||||||
fall through to a JSON-dump note row. The factory ships three row
|
fall through to a JSON-dump note row. The factory ships three row
|
||||||
|
|
|
||||||
|
|
@ -9,7 +9,7 @@ The operator's overview, with how to reach the UI and who may, is
|
||||||
|
|
||||||
The signed-in user's avatar sits at the right end of the header on every page.
|
The signed-in user's avatar sits at the right end of the header on every page.
|
||||||
It opens a menu with the user's name and links to authelia's settings and
|
It opens a menu with the user's name and links to authelia's settings and
|
||||||
sign-out pages; the hive dashboard and the per-agent page have the same menu.
|
sign-out pages; the hive dashboard has the same menu.
|
||||||
|
|
||||||
Every dropdown (a form's select, the refresh interval, the history window) opens a
|
Every dropdown (a form's select, the refresh interval, the history window) opens a
|
||||||
list in the swarm UI's own theme, not the browser's, and works the same in every
|
list in the swarm UI's own theme, not the browser's, and works the same in every
|
||||||
|
|
@ -173,7 +173,7 @@ the muted debug rows (thinking, coalesced ticks, harness chatter) from every
|
||||||
terminal, the preview and the tabs, and rows already on screen hide or show as
|
terminal, the preview and the tabs, and rows already on screen hide or show as
|
||||||
you flip it. It also hides the **components** tab, a page for developers, which
|
you flip it. It also hides the **components** tab, a page for developers, which
|
||||||
still answers at `/components`. The browser keeps the choice for the swarm UI, apart from the
|
still answers at `/components`. The browser keeps the choice for the swarm UI, apart from the
|
||||||
per-agent pages'.
|
hive dashboard's.
|
||||||
|
|
||||||
The menu also has a **solid backgrounds** toggle. It turns the frosted, see-through
|
The menu also has a **solid backgrounds** toggle. It turns the frosted, see-through
|
||||||
surfaces opaque: the header bar, the badges and the terminal panes. It stays off
|
surfaces opaque: the header bar, the badges and the terminal panes. It stays off
|
||||||
|
|
|
||||||
|
|
@ -1,12 +1,12 @@
|
||||||
# Per-agent terminal: row taxonomy (as built)
|
# Agent terminal: row taxonomy (as built)
|
||||||
|
|
||||||
The per-agent web UI's live pane renders one row per `TermMsg`
|
An agent's terminal in the swarm UI renders one row per `TermMsg`
|
||||||
(`hive-agent/src/term_msg.rs`): `{ts, icon?, level: debug|info|warn|error,
|
(`hive-agent/src/term_msg.rs`): `{ts, icon?, level: debug|info|warn|error,
|
||||||
summary, body?, body_format?: markdown|diff, coalesce_key?}`. Classification
|
summary, body?, body_format?: markdown|diff, coalesce_key?}`. Classification
|
||||||
(icon, summary text, whether a tool call gets an expandable body) happens
|
(icon, summary text, whether a tool call gets an expandable body) happens
|
||||||
server-side, once — `term_msg.rs` + `stream_enrich.rs` — and both
|
server-side, once — `term_msg.rs` + `stream_enrich.rs` — and the swarm queue's
|
||||||
`GET /api/events/history` and `GET /api/events/stream` serve it identically
|
terminal rows and `GET /events/stream` carry it identically. The stream wraps
|
||||||
as `TermEnvelope { seq?, msgs: TermMsg[] }` frames
|
rows as `TermEnvelope { seq?, msgs: TermMsg[] }` frames
|
||||||
(`hive-agent/src/web_ui/stream.rs`).
|
(`hive-agent/src/web_ui/stream.rs`).
|
||||||
|
|
||||||
`ts` is ISO 8601 UTC (`2026-09-13T12:35:03Z`) and is the **source event's**
|
`ts` is ISO 8601 UTC (`2026-09-13T12:35:03Z`) and is the **source event's**
|
||||||
|
|
@ -53,8 +53,8 @@ that motivated the change.
|
||||||
|
|
||||||
The settings menu's "hide developer details" toggle (`getHideDebugPref()`,
|
The settings menu's "hide developer details" toggle (`getHideDebugPref()`,
|
||||||
`@hive/shared/prefs.js`) skips `debug`-level rows entirely rather than
|
`@hive/shared/prefs.js`) skips `debug`-level rows entirely rather than
|
||||||
muting them further — client-side only, no reload. The per-agent page and
|
muting them further — client-side only, no reload. The swarm UI and the hive
|
||||||
the swarm UI both have the toggle, as one shared row
|
dashboard both have the toggle, as one shared row
|
||||||
(`@hive/shared/hide-debug-setting.js`). Each browser origin keeps its own
|
(`@hive/shared/hide-debug-setting.js`). Each browser origin keeps its own
|
||||||
setting. A `debug` row follows the toggle as it changes, so rows already
|
setting. A `debug` row follows the toggle as it changes, so rows already
|
||||||
on screen hide or show at once, not only the rows that arrive after it.
|
on screen hide or show at once, not only the rows that arrive after it.
|
||||||
|
|
|
||||||
|
|
@ -86,7 +86,7 @@ One agent: its entry in the agent list, state, config and page. Start at
|
||||||
[`2-handbook/agents/persistence.md`](2-handbook/agents/persistence.md).
|
[`2-handbook/agents/persistence.md`](2-handbook/agents/persistence.md).
|
||||||
- **Who can do what to whom — the agent list and privilege?** →
|
- **Who can do what to whom — the agent list and privilege?** →
|
||||||
[`2-handbook/agents/agent-permissions.md`](2-handbook/agents/agent-permissions.md).
|
[`2-handbook/agents/agent-permissions.md`](2-handbook/agents/agent-permissions.md).
|
||||||
- **What does an agent's own page show?** →
|
- **What does an agent's own web server offer?** →
|
||||||
[`2-handbook/agents/web-page.md`](2-handbook/agents/web-page.md).
|
[`2-handbook/agents/web-page.md`](2-handbook/agents/web-page.md).
|
||||||
- **Agent trust model, prompt-injection threat model, credential
|
- **Agent trust model, prompt-injection threat model, credential
|
||||||
isolation?** → [`2-handbook/agents/security.md`](2-handbook/agents/security.md).
|
isolation?** → [`2-handbook/agents/security.md`](2-handbook/agents/security.md).
|
||||||
|
|
@ -207,7 +207,7 @@ Nothing of it sits in this tree.
|
||||||
[`swarm-ui`](4-implementation/web-ui/swarm-ui.md).
|
[`swarm-ui`](4-implementation/web-ui/swarm-ui.md).
|
||||||
- **What's on each tab of the hive dashboard?** →
|
- **What's on each tab of the hive dashboard?** →
|
||||||
[`dashboard`](4-implementation/web-ui/dashboard.md).
|
[`dashboard`](4-implementation/web-ui/dashboard.md).
|
||||||
- **What does an agent's own page show, in full?** →
|
- **What does an agent's own web server serve, in full?** →
|
||||||
[`agent-page`](4-implementation/web-ui/agent-page.md).
|
[`agent-page`](4-implementation/web-ui/agent-page.md).
|
||||||
|
|
||||||
### Crate reference
|
### Crate reference
|
||||||
|
|
|
||||||
|
|
@ -5,8 +5,7 @@ npm workspaces project for the hyperhive browser-facing assets:
|
||||||
- `packages/shared/` — shared modules used by every surface (terminal
|
- `packages/shared/` — shared modules used by every surface (terminal
|
||||||
pane, Catppuccin palette + body typography).
|
pane, Catppuccin palette + body typography).
|
||||||
- `packages/dashboard/` — the hive-c0re dashboard SPA.
|
- `packages/dashboard/` — the hive-c0re dashboard SPA.
|
||||||
- `packages/agent/` — the per-container web UI (default agent page,
|
- `packages/agent/` — the per-container web pages (stats, screen).
|
||||||
stats, screen).
|
|
||||||
- `packages/swarm-ui/` — the swarm-level operator UI shell (hives,
|
- `packages/swarm-ui/` — the swarm-level operator UI shell (hives,
|
||||||
agents, jobs, issue-report pages).
|
agents, jobs, issue-report pages).
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,18 +1,10 @@
|
||||||
// esbuild build for @hive/agent. Output layout (`dist/`):
|
// esbuild build for @hive/agent. Output layout (`dist/`):
|
||||||
//
|
//
|
||||||
// dist/index.html served at GET / (the Preact rewrite —
|
|
||||||
// the old vanilla-JS app.js is deleted)
|
|
||||||
// dist/stats.html served at GET /stats
|
// dist/stats.html served at GET /stats
|
||||||
// dist/screen.html served at GET /screen
|
// dist/screen.html served at GET /screen
|
||||||
// dist/static/stats.js served at /static/stats.js (pulls in
|
// dist/static/stats.js served at /static/stats.js (pulls in
|
||||||
// chart.js/auto)
|
// chart.js/auto)
|
||||||
// dist/static/stats.js.map source map sibling
|
// dist/static/stats.js.map source map sibling
|
||||||
// dist/static/main.js served at /static/main.js (the Preact
|
|
||||||
// bundle — see main.tsx)
|
|
||||||
// dist/static/main.js.map source map sibling
|
|
||||||
// dist/static/main.css served at /static/main.css (bundled
|
|
||||||
// component CSS — see main.tsx's build
|
|
||||||
// step below)
|
|
||||||
// dist/static/agent.css served at /static/agent.css (@import
|
// dist/static/agent.css served at /static/agent.css (@import
|
||||||
// resolved from @hive/shared)
|
// resolved from @hive/shared)
|
||||||
//
|
//
|
||||||
|
|
@ -50,31 +42,10 @@ await build({
|
||||||
loader: { ".css": "text" },
|
loader: { ".css": "text" },
|
||||||
});
|
});
|
||||||
|
|
||||||
// The main agent page (the Preact rewrite — the old vanilla-JS app.js,
|
|
||||||
// which used to share this build step, is deleted). A separate bundle
|
|
||||||
// from stats.js above rather than folded in: different loader needs
|
|
||||||
// (`.css: 'css'`, real stylesheets a component imports, vs. the raw-
|
|
||||||
// text shadow-DOM CSS `stats.js` still needs for `@hive/shared/
|
|
||||||
// modal.js`) and JSX transpilation, same split swarm-ui's own build
|
|
||||||
// already makes.
|
|
||||||
await build({
|
|
||||||
entryPoints: [src("main.tsx")],
|
|
||||||
outfile: staticDir("main.js"),
|
|
||||||
bundle: true,
|
|
||||||
format: "esm",
|
|
||||||
platform: "browser",
|
|
||||||
target: ["es2022"],
|
|
||||||
sourcemap: true,
|
|
||||||
logLevel: "info",
|
|
||||||
jsx: "automatic",
|
|
||||||
jsxImportSource: "preact",
|
|
||||||
loader: { ".css": "css" },
|
|
||||||
});
|
|
||||||
|
|
||||||
// Bundle the CSS. `colors.css` re-exports the standalone base16 palette
|
// Bundle the CSS. `colors.css` re-exports the standalone base16 palette
|
||||||
// (the theme swap contract — its own output file so a swap replaces only
|
// (the theme swap contract — its own output file so a swap replaces only
|
||||||
// it, no bundle rebuild); `theme.css` is the semantic derivation layer;
|
// it, no bundle rebuild); `theme.css` is the semantic derivation layer;
|
||||||
// `agent.css`'s @import lines pull in shared base.css + terminal.css from
|
// `agent.css`'s @import lines pull in the shared base.css, chrome.css and pill.css from
|
||||||
// the @hive/shared workspace dep.
|
// the @hive/shared workspace dep.
|
||||||
for (const entry of ["colors.css", "theme.css", "agent.css"]) {
|
for (const entry of ["colors.css", "theme.css", "agent.css"]) {
|
||||||
await build({
|
await build({
|
||||||
|
|
@ -86,7 +57,7 @@ for (const entry of ["colors.css", "theme.css", "agent.css"]) {
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
for (const html of ["index.html", "stats.html", "screen.html"]) {
|
for (const html of ["stats.html", "screen.html"]) {
|
||||||
copyFileSync(src(html), dist(html));
|
copyFileSync(src(html), dist(html));
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,339 +0,0 @@
|
||||||
// <Root> — root of the Preact rewrite. Wires `Header` + `StatusChips`
|
|
||||||
// to the real `/api/state` snapshot via `useAgentState`. Covers
|
|
||||||
// everything `app.js` did. An agent without credentials shows the
|
|
||||||
// `needs_login_idle` badge; it logs in from the swarm UI, not here.
|
|
||||||
import { useEffect, useRef, useState } from "preact/hooks";
|
|
||||||
import type { BadgeTone } from "@hive/shared/badge.js";
|
|
||||||
import { SettingsMenu } from "@hive/shared/settings-menu.js";
|
|
||||||
import { useApplyThemeOverride } from "@hive/shared/theme-apply.js";
|
|
||||||
import { useApplyMotionOverride } from "@hive/shared/motion-apply.js";
|
|
||||||
import { Header } from "./components/Header.js";
|
|
||||||
import { MetaNav } from "./components/MetaNav.js";
|
|
||||||
import { AgentUserMenu } from "./components/AgentUserMenu.js";
|
|
||||||
import { ExpandDetailsSetting } from "@hive/shared/expand-details-setting.js";
|
|
||||||
import { HideDebugSetting } from "@hive/shared/hide-debug-setting.js";
|
|
||||||
import { StatusChips } from "./components/StatusChips.js";
|
|
||||||
import { LiveStream, type LiveStreamHandle } from "./components/LiveStream.js";
|
|
||||||
import { HeaderPill } from "./components/HeaderPill.js";
|
|
||||||
import { SidePanel } from "./components/SidePanel.js";
|
|
||||||
import { InboxPanel } from "./components/InboxPanel.js";
|
|
||||||
import { TodosPanel } from "./components/TodosPanel.js";
|
|
||||||
import { useAgentState } from "./hooks/useAgentState.js";
|
|
||||||
import { useTodos } from "./hooks/useTodos.js";
|
|
||||||
import { fmtAge, fmtTokens } from "./lib/format.js";
|
|
||||||
import { resolveDashboardBase } from "./lib/dashboardBase.js";
|
|
||||||
import { submitPauseResume } from "./lib/pauseAction.js";
|
|
||||||
import {
|
|
||||||
postCancelTurn,
|
|
||||||
postLogout,
|
|
||||||
postNewSession,
|
|
||||||
} from "./lib/termActions.js";
|
|
||||||
import type { TokenUsage } from "./types.js";
|
|
||||||
|
|
||||||
type OpenPanel = "inbox" | "todos" | null;
|
|
||||||
|
|
||||||
// Storage keys this page owns for `@hive/shared`'s settings mechanism —
|
|
||||||
// kept here, not derived, so `useApplyThemeOverride`/`useApplyMotionOverride`
|
|
||||||
// (mounted once below) and `<SettingsMenu>` (in `pills`, further down)
|
|
||||||
// always agree on which browser-local key they're reading/writing.
|
|
||||||
const THEME_KEY = "agent:theme-override";
|
|
||||||
const MOTION_KEY = "agent:motion-override";
|
|
||||||
|
|
||||||
const ALIVE_LABELS: Record<
|
|
||||||
string,
|
|
||||||
{ glyph: string; text: string; tone: BadgeTone }
|
|
||||||
> = {
|
|
||||||
online: { glyph: "●", text: "alive", tone: "positive" },
|
|
||||||
rate_limited: { glyph: "⊘", text: "rate limited", tone: "warning" },
|
|
||||||
needs_login_idle: { glyph: "◌", text: "needs login", tone: "warning" },
|
|
||||||
};
|
|
||||||
const STATE_LABELS: Record<
|
|
||||||
string,
|
|
||||||
{ glyph: string; text: string; tone: BadgeTone }
|
|
||||||
> = {
|
|
||||||
idle: { glyph: "💤", text: "idle", tone: "neutral" },
|
|
||||||
thinking: { glyph: "🧠", text: "thinking", tone: "accent" },
|
|
||||||
compacting: { glyph: "📦", text: "compacting", tone: "warning" },
|
|
||||||
};
|
|
||||||
const STATE_TOOLTIPS: Record<string, string> = {
|
|
||||||
offline: "harness unreachable or claude not logged in",
|
|
||||||
idle: "turn loop running, no claude invocation in flight",
|
|
||||||
thinking: "claude is executing the current turn",
|
|
||||||
compacting: "agent-requested /compact running on the persistent session",
|
|
||||||
};
|
|
||||||
|
|
||||||
// `total` here matches app.js's `renderOneUsage` exactly: input + both
|
|
||||||
// cache buckets, output_tokens deliberately excluded (it's shown in the
|
|
||||||
// title breakdown, not folded into the headline number).
|
|
||||||
function tokenTotal(u: TokenUsage | null): number | null {
|
|
||||||
if (!u) return null;
|
|
||||||
return (
|
|
||||||
(u.input_tokens ?? 0) +
|
|
||||||
(u.cache_read_input_tokens ?? 0) +
|
|
||||||
(u.cache_creation_input_tokens ?? 0)
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
// `?hide=header` — an embedding companion window (e.g. a native desktop
|
|
||||||
// shell) supplies its own header chrome around this page, so it asks for
|
|
||||||
// just the terminal feed. Read once per load (the value can't change without
|
|
||||||
// a navigation); comma-separated so more parts can be hidden in one param.
|
|
||||||
const hideParam = new URLSearchParams(window.location.search).get("hide");
|
|
||||||
const HIDDEN = new Set(hideParam ? hideParam.split(",").filter(Boolean) : []);
|
|
||||||
|
|
||||||
export function Root() {
|
|
||||||
useApplyThemeOverride(THEME_KEY);
|
|
||||||
useApplyMotionOverride(MOTION_KEY);
|
|
||||||
const { state, refresh } = useAgentState();
|
|
||||||
const { todos, refresh: refreshTodos } = useTodos();
|
|
||||||
const [openPanel, setOpenPanel] = useState<OpenPanel>(null);
|
|
||||||
const liveStreamRef = useRef<LiveStreamHandle>(null);
|
|
||||||
const hideHeader = HIDDEN.has("header");
|
|
||||||
// Body classes, not inline styles: agent.css's `--agent-header-h`/
|
|
||||||
// `--agent-header-real-h` custom properties already drive every
|
|
||||||
// dependent calc() (overlay offset, terminal scroll padding) — zeroing
|
|
||||||
// them here collapses all of that in one place instead of touching each rule.
|
|
||||||
useEffect(() => {
|
|
||||||
document.body.classList.toggle("agent-hide-header", hideHeader);
|
|
||||||
}, [hideHeader]);
|
|
||||||
|
|
||||||
// Ticks the status badge's "thinking Xm Ys" age once a second,
|
|
||||||
// independent of the ~4s `/api/state` poll cadence — without its own
|
|
||||||
// clock the age text only advances when a poll happens to land, so it
|
|
||||||
// visibly stair-steps instead of counting up, and freezes outright for
|
|
||||||
// however long a poll is delayed (e.g. a backgrounded tab).
|
|
||||||
const [now, setNow] = useState(() => Date.now());
|
|
||||||
useEffect(() => {
|
|
||||||
const id = setInterval(() => setNow(Date.now()), 1000);
|
|
||||||
return () => clearInterval(id);
|
|
||||||
}, []);
|
|
||||||
|
|
||||||
// Browser tab title — ports app.js's setHeader logic verbatim: prefer
|
|
||||||
// the human display name + hive_name ("iris // pr1ma") so tabs read
|
|
||||||
// naturally; fall back to the qualified domain label for multi-hive
|
|
||||||
// disambiguation when hive_name is unset, then to plain label for
|
|
||||||
// single-hive deploys. Without this every agent's tab reads the
|
|
||||||
// static index.html <title> forever — can't tell tabs apart with
|
|
||||||
// several open.
|
|
||||||
useEffect(() => {
|
|
||||||
if (!state) return;
|
|
||||||
const tab =
|
|
||||||
state.qualified_label && state.qualified_label !== state.label
|
|
||||||
? state.qualified_label
|
|
||||||
: state.label;
|
|
||||||
document.title = state.hive_name
|
|
||||||
? `${state.label} // ${state.hive_name}`
|
|
||||||
: `${tab} // hyperhive`;
|
|
||||||
}, [state?.label, state?.qualified_label, state?.hive_name]);
|
|
||||||
const pills = (
|
|
||||||
<>
|
|
||||||
<HeaderPill
|
|
||||||
kind="inbox"
|
|
||||||
icon="📬"
|
|
||||||
label="inbox"
|
|
||||||
count={state?.inbox.length ?? 0}
|
|
||||||
onClick={() => setOpenPanel("inbox")}
|
|
||||||
/>
|
|
||||||
<HeaderPill
|
|
||||||
kind="todos"
|
|
||||||
icon="📋"
|
|
||||||
label="todos"
|
|
||||||
count={todos.length}
|
|
||||||
onClick={() => setOpenPanel("todos")}
|
|
||||||
/>
|
|
||||||
{/* Needs a loaded snapshot for its data (links,
|
|
||||||
* dashboard_port) — omitted until the first /api/state resolves,
|
|
||||||
* same as the old page's populateOverflowMenu (now deleted —
|
|
||||||
* dashboard-link moved here, rebuild removed outright, see
|
|
||||||
* MetaNav.tsx's file comment). */}
|
|
||||||
{state ? (
|
|
||||||
<MetaNav
|
|
||||||
links={state.links}
|
|
||||||
dashboardBase={resolveDashboardBase(state.dashboard_port)}
|
|
||||||
/>
|
|
||||||
) : null}
|
|
||||||
<SettingsMenu themeKey={THEME_KEY} motionKey={MOTION_KEY}>
|
|
||||||
<ExpandDetailsSetting />
|
|
||||||
<HideDebugSetting />
|
|
||||||
</SettingsMenu>
|
|
||||||
{state ? (
|
|
||||||
<AgentUserMenu
|
|
||||||
dashboardBase={resolveDashboardBase(state.dashboard_port)}
|
|
||||||
/>
|
|
||||||
) : null}
|
|
||||||
</>
|
|
||||||
);
|
|
||||||
// Kept mounted regardless of `openPanel` (open/closed toggles just the
|
|
||||||
// `open` prop) rather than conditionally rendering the whole
|
|
||||||
// component — SidePanel's slide/fade CSS transitions only fire on a
|
|
||||||
// class change after mount, not on an already-open initial render, so
|
|
||||||
// mount-on-open would skip both the open AND the close animation.
|
|
||||||
const panelTitle =
|
|
||||||
openPanel === "inbox"
|
|
||||||
? `inbox · ${state?.inbox.length ?? 0}`
|
|
||||||
: openPanel === "todos"
|
|
||||||
? `todos · ${todos.length}`
|
|
||||||
: "";
|
|
||||||
const panel = (
|
|
||||||
<SidePanel
|
|
||||||
open={openPanel !== null}
|
|
||||||
title={panelTitle}
|
|
||||||
onClose={() => setOpenPanel(null)}
|
|
||||||
>
|
|
||||||
{openPanel === "inbox" ? (
|
|
||||||
<InboxPanel
|
|
||||||
rows={state?.inbox ?? []}
|
|
||||||
label={state?.label ?? ""}
|
|
||||||
dashboardBase={
|
|
||||||
state ? resolveDashboardBase(state.dashboard_port) : ""
|
|
||||||
}
|
|
||||||
onCleared={refresh}
|
|
||||||
/>
|
|
||||||
) : openPanel === "todos" ? (
|
|
||||||
<TodosPanel todos={todos} onCleared={refreshTodos} />
|
|
||||||
) : null}
|
|
||||||
</SidePanel>
|
|
||||||
);
|
|
||||||
|
|
||||||
if (!state) {
|
|
||||||
return (
|
|
||||||
<>
|
|
||||||
{hideHeader ? null : (
|
|
||||||
<Header label="…" pills={pills}>
|
|
||||||
<StatusChips
|
|
||||||
statusLabel="… connecting"
|
|
||||||
statusTone="neutral"
|
|
||||||
model=""
|
|
||||||
paused={false}
|
|
||||||
onTogglePause={() => {}}
|
|
||||||
thinking={false}
|
|
||||||
onCancelTurn={() => Promise.resolve()}
|
|
||||||
onNewSession={() => Promise.resolve()}
|
|
||||||
onLogout={() => Promise.resolve()}
|
|
||||||
/>
|
|
||||||
</Header>
|
|
||||||
)}
|
|
||||||
<main className="agent-main">
|
|
||||||
<LiveStream ref={liveStreamRef} />
|
|
||||||
</main>
|
|
||||||
{panel}
|
|
||||||
</>
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
const alive = ALIVE_LABELS[state.status] ?? {
|
|
||||||
glyph: "○",
|
|
||||||
text: "offline",
|
|
||||||
tone: "negative" as BadgeTone,
|
|
||||||
};
|
|
||||||
// Mirrors app.js's refreshState: any non-'online' status forces the
|
|
||||||
// turn-state badge to 'offline' regardless of the server's last-known
|
|
||||||
// turn_state (login/rate-limit takes visual priority over a stale
|
|
||||||
// idle/thinking reading from before the harness went offline).
|
|
||||||
const effectiveTurnState =
|
|
||||||
state.status === "online" ? state.turn_state : "offline";
|
|
||||||
const turnDef = STATE_LABELS[effectiveTurnState] ?? {
|
|
||||||
glyph: "○",
|
|
||||||
text: "offline",
|
|
||||||
tone: "negative" as BadgeTone,
|
|
||||||
};
|
|
||||||
const stateAge = fmtAge(now - state.turn_state_since * 1000);
|
|
||||||
// Consolidated status badge (mara: "why do we have separate alive
|
|
||||||
// badge? ... one badge that shows thinking / idle / paused").
|
|
||||||
// Not online → the alive-table's own reading (rate-limited/needs-login/
|
|
||||||
// offline), no age (nothing to age). Online + paused → 'paused'
|
|
||||||
// overrides the turn-state reading, since a paused agent won't be
|
|
||||||
// thinking regardless of its last turn_state. Online + running →
|
|
||||||
// turn-state + age, same as before.
|
|
||||||
const primaryStatus =
|
|
||||||
state.status !== "online"
|
|
||||||
? {
|
|
||||||
glyph: alive.glyph,
|
|
||||||
text: alive.text,
|
|
||||||
tone: alive.tone,
|
|
||||||
tooltip: undefined as string | undefined,
|
|
||||||
}
|
|
||||||
: state.paused
|
|
||||||
? {
|
|
||||||
glyph: "⏸",
|
|
||||||
text: "paused",
|
|
||||||
tone: "warning" as BadgeTone,
|
|
||||||
tooltip: undefined,
|
|
||||||
}
|
|
||||||
: {
|
|
||||||
glyph: turnDef.glyph,
|
|
||||||
text: `${turnDef.text} · ${stateAge}`,
|
|
||||||
tone: turnDef.tone,
|
|
||||||
tooltip: STATE_TOOLTIPS[effectiveTurnState],
|
|
||||||
};
|
|
||||||
const ctx = tokenTotal(state.ctx_usage);
|
|
||||||
const cost = tokenTotal(state.cost_usage);
|
|
||||||
|
|
||||||
return (
|
|
||||||
<>
|
|
||||||
{hideHeader ? null : (
|
|
||||||
<Header
|
|
||||||
label={state.label}
|
|
||||||
hiveLabel={
|
|
||||||
[state.swarm_name, state.hive_name].filter(Boolean).join(" / ") ||
|
|
||||||
null
|
|
||||||
}
|
|
||||||
pills={pills}
|
|
||||||
>
|
|
||||||
<StatusChips
|
|
||||||
statusLabel={`${primaryStatus.glyph} ${primaryStatus.text}`}
|
|
||||||
statusTone={primaryStatus.tone}
|
|
||||||
statusTooltip={primaryStatus.tooltip}
|
|
||||||
model={state.model}
|
|
||||||
resolvedModel={state.resolved_model ?? undefined}
|
|
||||||
modelSource={state.model_source}
|
|
||||||
effort={state.effort}
|
|
||||||
effortSource={state.effort_source}
|
|
||||||
ctxLabel={ctx !== null ? fmtTokens(ctx) : undefined}
|
|
||||||
costLabel={cost !== null ? fmtTokens(cost) : undefined}
|
|
||||||
paused={state.paused}
|
|
||||||
onTogglePause={() => {
|
|
||||||
submitPauseResume(
|
|
||||||
resolveDashboardBase(state.dashboard_port),
|
|
||||||
state.label,
|
|
||||||
state.paused ? "resume" : "pause",
|
|
||||||
).then(() => refresh());
|
|
||||||
}}
|
|
||||||
thinking={effectiveTurnState === "thinking"}
|
|
||||||
onCancelTurn={() =>
|
|
||||||
postCancelTurn().then((r) => {
|
|
||||||
if (!r.ok)
|
|
||||||
liveStreamRef.current?.pushNote(
|
|
||||||
`✗ /cancel failed${r.detail ? ": " + r.detail : ""}`,
|
|
||||||
);
|
|
||||||
refresh();
|
|
||||||
})
|
|
||||||
}
|
|
||||||
onNewSession={() =>
|
|
||||||
postNewSession().then((r) => {
|
|
||||||
if (!r.ok)
|
|
||||||
liveStreamRef.current?.pushNote(
|
|
||||||
`✗ /new-session failed${r.detail ? ": " + r.detail : ""}`,
|
|
||||||
);
|
|
||||||
refresh();
|
|
||||||
})
|
|
||||||
}
|
|
||||||
onLogout={() =>
|
|
||||||
postLogout().then((r) => {
|
|
||||||
if (!r.ok)
|
|
||||||
liveStreamRef.current?.pushNote(
|
|
||||||
`✗ /logout failed${r.detail ? ": " + r.detail : ""}`,
|
|
||||||
);
|
|
||||||
refresh();
|
|
||||||
})
|
|
||||||
}
|
|
||||||
/>
|
|
||||||
</Header>
|
|
||||||
)}
|
|
||||||
<main className="agent-main">
|
|
||||||
<LiveStream ref={liveStreamRef} />
|
|
||||||
</main>
|
|
||||||
{panel}
|
|
||||||
</>
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
@ -1,10 +1,9 @@
|
||||||
/* Shared Catppuccin palette + body typography + terminal pane styles.
|
/* Shared Catppuccin palette + body typography.
|
||||||
Bundled in front of the agent-only rules below via esbuild. */
|
Bundled in front of the stats and screen pages' rules below via esbuild. */
|
||||||
@import "@hive/shared/base.css";
|
@import "@hive/shared/base.css";
|
||||||
@import "@hive/shared/terminal.css";
|
|
||||||
/* Shared page-header chrome (page-header / page-back / page-title) — gives the
|
/* Shared page-header chrome (page-header / page-back / page-title) — gives the
|
||||||
agent SUB-pages (stats, screen) the same back-link nav the dashboard's
|
agent SUB-pages (stats, screen) the same back-link nav the dashboard's
|
||||||
standalone pages use. The live terminal page keeps its own header. */
|
standalone pages use. */
|
||||||
@import "@hive/shared/chrome.css";
|
@import "@hive/shared/chrome.css";
|
||||||
/* Shared pill/chip/badge shape (the "extract pill component" issue,
|
/* Shared pill/chip/badge shape (the "extract pill component" issue,
|
||||||
resolved as shared CSS rather than a JS component) — see pill.css
|
resolved as shared CSS rather than a JS component) — see pill.css
|
||||||
|
|
@ -14,653 +13,20 @@
|
||||||
component's own shadow root (adoptedStyleSheets), not a global
|
component's own shadow root (adoptedStyleSheets), not a global
|
||||||
stylesheet — nothing to @import here. */
|
stylesheet — nothing to @import here. */
|
||||||
|
|
||||||
/* ─── full-screen layout overrides ─────────────────────────────────
|
|
||||||
The agent page mounts a full-viewport terminal under a fixed
|
|
||||||
frosted-glass header. See docs/4-implementation/web-ui/agent-page.md::Per-agent
|
|
||||||
page for the layer / pill / side-panel structure; rules below
|
|
||||||
override the in-page defaults from @hive/shared. */
|
|
||||||
|
|
||||||
:root {
|
|
||||||
/* 6em min-height accommodates the full-height agent icon (5em +
|
|
||||||
padding) alongside the two-row main column (title + nav-links
|
|
||||||
on top, state strip below). */
|
|
||||||
--agent-header-h: 6em;
|
|
||||||
--agent-frost-bg: color-mix(in srgb, var(--bg) 72%, transparent);
|
|
||||||
--agent-frost-blur: blur(12px) saturate(140%);
|
|
||||||
}
|
|
||||||
|
|
||||||
/* `?hide=header` (per-agent-page embed mode): `Root.tsx` toggles
|
|
||||||
this body class when it omits `<Header>`.
|
|
||||||
Zeroing the custom properties here — rather than overriding each
|
|
||||||
dependent rule — collapses every calc() that reads them (overlay
|
|
||||||
offset, terminal scroll padding) in one place. */
|
|
||||||
body.agent-hide-header {
|
|
||||||
--agent-header-h: 0px;
|
|
||||||
--agent-header-real-h: 0px;
|
|
||||||
}
|
|
||||||
|
|
||||||
html,
|
html,
|
||||||
body {
|
body {
|
||||||
height: 100%;
|
height: 100%;
|
||||||
margin: 0;
|
margin: 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
/* Legacy in-page layout retained for the sibling stats page
|
/* Normal-document scroll for the stats page. screen-shell is excluded: it
|
||||||
(`stats.html`) which doesn't apply `body.agent-shell` and stays
|
|
||||||
on a normal-document scroll. screen-shell is also excluded — it
|
|
||||||
manages its own full-viewport layout below. */
|
manages its own full-viewport layout below. */
|
||||||
body:not(.agent-shell):not(.screen-shell) {
|
body:not(.screen-shell) {
|
||||||
max-width: 110em;
|
max-width: 110em;
|
||||||
margin: 1.5em auto;
|
margin: 1.5em auto;
|
||||||
padding: 0 1.5em;
|
padding: 0 1.5em;
|
||||||
height: auto;
|
height: auto;
|
||||||
}
|
}
|
||||||
.banner {
|
|
||||||
text-align: center;
|
|
||||||
margin: 0 0 1em 0;
|
|
||||||
font-size: 0.95em;
|
|
||||||
overflow-x: auto;
|
|
||||||
background: linear-gradient(
|
|
||||||
90deg,
|
|
||||||
var(--purple-dim) 0%,
|
|
||||||
var(--purple) 50%,
|
|
||||||
var(--purple-dim) 100%
|
|
||||||
);
|
|
||||||
background-size: 200% 100%;
|
|
||||||
background-position: 50% 0;
|
|
||||||
-webkit-background-clip: text;
|
|
||||||
background-clip: text;
|
|
||||||
color: transparent;
|
|
||||||
filter: drop-shadow(
|
|
||||||
0 0 6px color-mix(in srgb, var(--purple) 45%, transparent)
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
body.agent-shell {
|
|
||||||
background: var(--bg);
|
|
||||||
color: var(--fg);
|
|
||||||
/* Body itself doesn't scroll; the terminal does inside .agent-main. */
|
|
||||||
overflow: hidden;
|
|
||||||
/* Subtle radial accent to give the otherwise-flat full-screen
|
|
||||||
surface some depth and reinforce the vibec0re mood. */
|
|
||||||
background:
|
|
||||||
radial-gradient(
|
|
||||||
ellipse 80% 60% at 50% 0%,
|
|
||||||
color-mix(in srgb, var(--purple) 6%, transparent) 0%,
|
|
||||||
transparent 60%
|
|
||||||
),
|
|
||||||
var(--bg);
|
|
||||||
}
|
|
||||||
|
|
||||||
.agent-header {
|
|
||||||
position: fixed;
|
|
||||||
top: 0;
|
|
||||||
left: 0;
|
|
||||||
right: 0;
|
|
||||||
z-index: 30;
|
|
||||||
min-height: var(--agent-header-h);
|
|
||||||
display: flex;
|
|
||||||
/* align-items: stretch lets the icon take the full header height
|
|
||||||
(it sizes itself via aspect-ratio off the stretched height). The
|
|
||||||
main column + pills column self-centre via inner layout. */
|
|
||||||
align-items: stretch;
|
|
||||||
gap: 0.9em;
|
|
||||||
padding: 0.5em 1em;
|
|
||||||
background: var(--agent-frost-bg);
|
|
||||||
-webkit-backdrop-filter: var(--agent-frost-blur);
|
|
||||||
backdrop-filter: var(--agent-frost-blur);
|
|
||||||
border-bottom: 1px solid var(--purple-dim);
|
|
||||||
box-shadow: 0 6px 18px rgba(0, 0, 0, 0.35);
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Main column: title row on top, state strip below. Centred
|
|
||||||
vertically against the full-height icon on the left. */
|
|
||||||
.agent-header-main {
|
|
||||||
display: flex;
|
|
||||||
flex-direction: column;
|
|
||||||
justify-content: center;
|
|
||||||
gap: 0.45em;
|
|
||||||
min-width: 0;
|
|
||||||
flex: 1 1 auto;
|
|
||||||
}
|
|
||||||
.agent-header-row {
|
|
||||||
display: flex;
|
|
||||||
align-items: center;
|
|
||||||
gap: 0.8em;
|
|
||||||
flex-wrap: wrap;
|
|
||||||
min-width: 0;
|
|
||||||
}
|
|
||||||
.agent-header-title-row h2 {
|
|
||||||
margin: 0;
|
|
||||||
line-height: 1;
|
|
||||||
}
|
|
||||||
.agent-nav {
|
|
||||||
display: flex;
|
|
||||||
flex-wrap: wrap;
|
|
||||||
gap: 0.4em 0.8em;
|
|
||||||
margin: 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
.agent-state-row {
|
|
||||||
margin: 0;
|
|
||||||
gap: 0.5em;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Right cluster — flyout pills, and (new Preact page only) the status
|
|
||||||
badges (`StatusChips`) too — mara, live: "move badges to where the
|
|
||||||
dropdowns are". `flex-wrap: wrap` alone doesn't help if this
|
|
||||||
container can't itself shrink: the old `flex-shrink: 0` here (fine
|
|
||||||
for app.js's 2-3-small-pills case, which never needed to shrink)
|
|
||||||
told the flex layout "give this its full natural width no matter
|
|
||||||
what," so once badges made that natural width wider than the
|
|
||||||
viewport, it just overflowed past the edge instead of ever getting
|
|
||||||
narrow enough to trigger its own wrap — mara, live, on the 500px
|
|
||||||
screenshot: "does not overflow properly". Dropping `flex-shrink: 0`
|
|
||||||
(default is `1`) is the whole fix — deliberately NOT pairing it
|
|
||||||
with `min-width: 0` (tried that first, made it worse: an unset
|
|
||||||
`min-width` still floors shrinking at this container's own
|
|
||||||
min-content — the widest single wrapped child, e.g. one badge, not
|
|
||||||
the full unwrapped row — which is the correct floor; `min-width: 0`
|
|
||||||
removes that floor entirely, so at a narrow enough viewport the
|
|
||||||
container shrinks past what its own content needs and the content
|
|
||||||
overflows its box sideways, landing on top of `.agent-header-main`
|
|
||||||
instead of wrapping cleanly — confirmed live, reproducible at
|
|
||||||
320px, not a one-off capture glitch). */
|
|
||||||
.agent-header-pills {
|
|
||||||
display: flex;
|
|
||||||
align-items: center;
|
|
||||||
gap: 0.5em;
|
|
||||||
flex-wrap: wrap;
|
|
||||||
justify-content: flex-end;
|
|
||||||
align-self: center;
|
|
||||||
}
|
|
||||||
|
|
||||||
h2,
|
|
||||||
h3 {
|
|
||||||
color: var(--purple);
|
|
||||||
text-transform: uppercase;
|
|
||||||
letter-spacing: 0.15em;
|
|
||||||
text-shadow: 0 0 8px color-mix(in srgb, var(--purple) 40%, transparent);
|
|
||||||
}
|
|
||||||
.agent-icon {
|
|
||||||
/* Square identity anchor — explicit 5em sizing + align-self.
|
|
||||||
See docs/4-implementation/web-ui/agent-page.md::Per-agent page (Agent icon) for the
|
|
||||||
intrinsic-dim-pushes-parent-flex-open + sticks-to-top
|
|
||||||
rationale. */
|
|
||||||
width: 5em;
|
|
||||||
height: 5em;
|
|
||||||
flex-shrink: 0;
|
|
||||||
align-self: flex-start;
|
|
||||||
border-radius: 8px;
|
|
||||||
box-shadow: 0 0 18px -2px color-mix(in srgb, var(--purple) 40%, transparent);
|
|
||||||
object-fit: cover;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Meta-nav links (stats / screen / dashboard / extras) —
|
|
||||||
no underline; hover lights with cyan glow + subtle background
|
|
||||||
tint. Reads as a row of soft tabs rather than default-styled
|
|
||||||
inline anchors. */
|
|
||||||
.agent-nav-link {
|
|
||||||
color: var(--cyan);
|
|
||||||
text-decoration: none;
|
|
||||||
font-size: 0.85em;
|
|
||||||
letter-spacing: 0.04em;
|
|
||||||
padding: 0.1em 0.35em;
|
|
||||||
border-radius: 3px;
|
|
||||||
text-shadow: 0 0 4px color-mix(in srgb, var(--cyan) 40%, transparent);
|
|
||||||
transition:
|
|
||||||
color 0.15s ease,
|
|
||||||
text-shadow 0.15s ease,
|
|
||||||
background 0.15s ease;
|
|
||||||
}
|
|
||||||
.agent-nav-link:hover {
|
|
||||||
color: var(--fg);
|
|
||||||
background: color-mix(in srgb, var(--cyan) 8%, transparent);
|
|
||||||
text-shadow: 0 0 10px color-mix(in srgb, var(--cyan) 85%, transparent);
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Header pill (inbox / loose-ends triggers) — no CSS of its own any
|
|
||||||
more. `HeaderPill.tsx` renders `@hive/shared`'s `Badge` directly now
|
|
||||||
(mara: "cant we reuse the badge component") instead of a hand-styled
|
|
||||||
pill matched to Badge's own values; nothing left to override here. */
|
|
||||||
|
|
||||||
.agent-main {
|
|
||||||
position: absolute;
|
|
||||||
top: 0;
|
|
||||||
left: 0;
|
|
||||||
right: 0;
|
|
||||||
bottom: 0;
|
|
||||||
overflow: hidden;
|
|
||||||
}
|
|
||||||
|
|
||||||
.meta {
|
|
||||||
color: var(--muted);
|
|
||||||
font-size: 0.85em;
|
|
||||||
}
|
|
||||||
.status-online {
|
|
||||||
color: var(--green);
|
|
||||||
text-shadow: 0 0 6px color-mix(in srgb, var(--green) 55%, transparent);
|
|
||||||
}
|
|
||||||
.status-needs-login {
|
|
||||||
color: var(--amber);
|
|
||||||
text-shadow: 0 0 6px color-mix(in srgb, var(--amber) 55%, transparent);
|
|
||||||
}
|
|
||||||
code {
|
|
||||||
background: color-mix(in srgb, var(--purple) 12%, transparent);
|
|
||||||
padding: 0.05em 0.3em;
|
|
||||||
border-radius: 2px;
|
|
||||||
}
|
|
||||||
a {
|
|
||||||
color: var(--cyan);
|
|
||||||
text-shadow: 0 0 4px color-mix(in srgb, var(--cyan) 50%, transparent);
|
|
||||||
}
|
|
||||||
a:hover {
|
|
||||||
color: var(--fg);
|
|
||||||
text-shadow: 0 0 12px color-mix(in srgb, var(--cyan) 90%, transparent);
|
|
||||||
}
|
|
||||||
.btn {
|
|
||||||
font-family: inherit;
|
|
||||||
font-size: 1em;
|
|
||||||
background: var(--bg);
|
|
||||||
border: 1px solid var(--purple);
|
|
||||||
color: var(--purple);
|
|
||||||
padding: 0.25em 0.8em;
|
|
||||||
cursor: pointer;
|
|
||||||
letter-spacing: 0.1em;
|
|
||||||
}
|
|
||||||
.btn {
|
|
||||||
text-shadow: 0 0 4px currentColor;
|
|
||||||
transition:
|
|
||||||
box-shadow 0.15s ease,
|
|
||||||
text-shadow 0.15s ease;
|
|
||||||
}
|
|
||||||
.btn:hover {
|
|
||||||
background: color-mix(in srgb, var(--fg) 6%, transparent);
|
|
||||||
text-shadow: 0 0 10px currentColor;
|
|
||||||
box-shadow: 0 0 10px -2px currentColor;
|
|
||||||
}
|
|
||||||
/* Orphaned rules — left here as a tombstone so a search for the
|
|
||||||
class name finds them. Live consumers gone:
|
|
||||||
- `.btn-rebuild` was a per-agent header chip, then briefly an
|
|
||||||
overflow-menu item (`.overflow-item-rebuild`, also since deleted,
|
|
||||||
see MetaNav.tsx's file comment) — the button itself is gone
|
|
||||||
outright now, no replacement.
|
|
||||||
- `.btn-send` was a green send-button variant — the dashboard's
|
|
||||||
compose form that used it is retired. */
|
|
||||||
.sendform {
|
|
||||||
display: flex;
|
|
||||||
gap: 0.6em;
|
|
||||||
margin-top: 0.5em;
|
|
||||||
}
|
|
||||||
.sendform input {
|
|
||||||
font-family: inherit;
|
|
||||||
font-size: 1em;
|
|
||||||
background: rgba(255, 255, 255, 0.04);
|
|
||||||
color: var(--fg);
|
|
||||||
border: 1px solid var(--purple-dim);
|
|
||||||
padding: 0.4em 0.6em;
|
|
||||||
flex: 1;
|
|
||||||
}
|
|
||||||
.sendform input:focus {
|
|
||||||
outline: 1px solid var(--purple);
|
|
||||||
}
|
|
||||||
pre.diff {
|
|
||||||
background: rgba(255, 255, 255, 0.03);
|
|
||||||
border: 1px solid var(--purple-dim);
|
|
||||||
padding: 0.6em 0.8em;
|
|
||||||
overflow-x: auto;
|
|
||||||
white-space: pre-wrap;
|
|
||||||
word-break: break-all;
|
|
||||||
max-height: 30em;
|
|
||||||
}
|
|
||||||
/* Per-agent inbox section — collapsible, dim, lives between the
|
|
||||||
state row and the terminal so the operator can peek at what
|
|
||||||
landed without scrolling through the live tail. */
|
|
||||||
.agent-inbox {
|
|
||||||
margin: 0.4em 0;
|
|
||||||
font-size: 0.85em;
|
|
||||||
color: var(--muted);
|
|
||||||
}
|
|
||||||
.agent-inbox > summary {
|
|
||||||
cursor: pointer;
|
|
||||||
letter-spacing: 0.05em;
|
|
||||||
list-style: none;
|
|
||||||
}
|
|
||||||
.agent-inbox > summary::marker {
|
|
||||||
content: "";
|
|
||||||
}
|
|
||||||
.agent-inbox[open] > summary > span::before {
|
|
||||||
content: "";
|
|
||||||
}
|
|
||||||
.agent-inbox ul {
|
|
||||||
list-style: none;
|
|
||||||
padding: 0.4em 0.8em;
|
|
||||||
margin: 0.3em 0 0;
|
|
||||||
background: rgba(255, 255, 255, 0.02);
|
|
||||||
border-left: 2px solid var(--purple-dim);
|
|
||||||
max-height: 16em;
|
|
||||||
overflow-y: auto;
|
|
||||||
}
|
|
||||||
/* Inbox / loose-ends rows: header (from / sep / ts) on one line,
|
|
||||||
body on its own line below — gives the body the full panel width
|
|
||||||
instead of squeezing it into a fourth grid column that wrapped
|
|
||||||
long messages over many narrow lines. */
|
|
||||||
.agent-inbox li {
|
|
||||||
padding: 0.4em 0;
|
|
||||||
display: block;
|
|
||||||
}
|
|
||||||
.agent-inbox .inbox-ts {
|
|
||||||
color: var(--muted);
|
|
||||||
font-size: 0.9em;
|
|
||||||
margin-left: 0.5em;
|
|
||||||
}
|
|
||||||
.agent-inbox .inbox-from {
|
|
||||||
color: var(--amber);
|
|
||||||
}
|
|
||||||
.agent-inbox .inbox-sep {
|
|
||||||
color: var(--muted);
|
|
||||||
margin-left: 0.4em;
|
|
||||||
}
|
|
||||||
/* Todos flyout per-row checkbox (bulk mark-done) — sits inline before the
|
|
||||||
existing `.inbox-from` label, same row. */
|
|
||||||
.agent-inbox .todo-cb {
|
|
||||||
vertical-align: middle;
|
|
||||||
margin-right: 0.2em;
|
|
||||||
}
|
|
||||||
.agent-inbox .inbox-body {
|
|
||||||
display: block;
|
|
||||||
color: var(--fg);
|
|
||||||
white-space: pre-wrap;
|
|
||||||
word-break: break-word;
|
|
||||||
margin-top: 0.3em;
|
|
||||||
padding-left: 0.8em;
|
|
||||||
border-left: 2px solid var(--purple-dim);
|
|
||||||
}
|
|
||||||
/* Running bash-tasks flyout rows (buildBashTasksList). */
|
|
||||||
.agent-inbox .bash-task-status {
|
|
||||||
font-weight: bold;
|
|
||||||
font-size: 0.9em;
|
|
||||||
}
|
|
||||||
.agent-inbox .bash-task-running {
|
|
||||||
color: var(--green);
|
|
||||||
}
|
|
||||||
.agent-inbox .bash-task-pending {
|
|
||||||
color: var(--blue);
|
|
||||||
}
|
|
||||||
.agent-inbox .bash-task-cmd {
|
|
||||||
font-family: monospace;
|
|
||||||
font-size: 0.92em;
|
|
||||||
}
|
|
||||||
.agent-inbox li.inbox-reply {
|
|
||||||
padding-left: 1em;
|
|
||||||
border-left: 2px solid var(--border);
|
|
||||||
margin-left: 0.4em;
|
|
||||||
}
|
|
||||||
.agent-inbox .inbox-reply-tag {
|
|
||||||
color: var(--muted);
|
|
||||||
font-size: 0.85em;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Bulk-action header row: "mark all read" above the recent-messages
|
|
||||||
list in the inbox flyout, and "select all / select none / mark
|
|
||||||
done" above the list in the todos flyout — same classes, shared
|
|
||||||
look (mauve hover, bg-elev background) so both read as part of
|
|
||||||
the same affordance family. */
|
|
||||||
.agent-inbox .inbox-mark-all-row {
|
|
||||||
display: flex;
|
|
||||||
gap: 0.6em;
|
|
||||||
align-items: center;
|
|
||||||
padding: 0.4em 0.2em 0.6em;
|
|
||||||
margin-bottom: 0.5em;
|
|
||||||
border-bottom: 1px solid var(--border);
|
|
||||||
}
|
|
||||||
.agent-inbox .inbox-mark-all-btn {
|
|
||||||
font-family: inherit;
|
|
||||||
font-size: inherit;
|
|
||||||
background: var(--bg-elev);
|
|
||||||
color: var(--fg);
|
|
||||||
border: 1px solid var(--border);
|
|
||||||
border-radius: 3px;
|
|
||||||
padding: 0.3em 0.7em;
|
|
||||||
cursor: pointer;
|
|
||||||
white-space: nowrap;
|
|
||||||
}
|
|
||||||
.agent-inbox .inbox-mark-all-btn:hover:not(:disabled) {
|
|
||||||
border-color: var(--purple);
|
|
||||||
color: var(--purple);
|
|
||||||
}
|
|
||||||
.agent-inbox .inbox-mark-all-btn:disabled {
|
|
||||||
opacity: 0.5;
|
|
||||||
cursor: default;
|
|
||||||
}
|
|
||||||
.agent-inbox .inbox-mark-status {
|
|
||||||
color: var(--muted);
|
|
||||||
font-size: 0.9em;
|
|
||||||
}
|
|
||||||
|
|
||||||
.last-turn {
|
|
||||||
color: var(--muted);
|
|
||||||
font-size: 0.8em;
|
|
||||||
letter-spacing: 0.05em;
|
|
||||||
}
|
|
||||||
/* Markup carries `hive-pill-sm` alongside each of these (shared
|
|
||||||
pill.css supplies the shape); rules below are colour only. */
|
|
||||||
.model-chip,
|
|
||||||
.effort-chip {
|
|
||||||
border-color: var(--purple-dim);
|
|
||||||
}
|
|
||||||
.model-chip {
|
|
||||||
color: var(--cyan);
|
|
||||||
}
|
|
||||||
.effort-chip {
|
|
||||||
color: var(--amber);
|
|
||||||
}
|
|
||||||
/* Context-window badge. Mirrors Claude Code's bottom-right "N tokens"
|
|
||||||
chip — single primary number (total prompt tokens in use), full
|
|
||||||
breakdown on hover. Sized/coloured like a peer of model-chip so
|
|
||||||
the state row reads as one row of chrome. */
|
|
||||||
.ctx-badge {
|
|
||||||
border-color: var(--purple-dim);
|
|
||||||
color: var(--green);
|
|
||||||
cursor: default;
|
|
||||||
white-space: pre-line;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Harness reachability badge. Markup carries `hive-pill` alongside
|
|
||||||
`status-badge` (shared pill.css supplies the shape); colour
|
|
||||||
communicates the actual reachability state. */
|
|
||||||
.status-badge.status-loading {
|
|
||||||
color: var(--muted);
|
|
||||||
border-color: var(--purple-dim);
|
|
||||||
}
|
|
||||||
.status-badge.status-online {
|
|
||||||
color: var(--green);
|
|
||||||
border-color: var(--green);
|
|
||||||
text-shadow: 0 0 6px color-mix(in srgb, var(--green) 55%, transparent);
|
|
||||||
}
|
|
||||||
.status-badge.status-rate-limited {
|
|
||||||
color: var(--red);
|
|
||||||
border-color: var(--red);
|
|
||||||
text-shadow: 0 0 6px color-mix(in srgb, var(--red) 55%, transparent);
|
|
||||||
}
|
|
||||||
.status-badge.status-needs-login {
|
|
||||||
color: var(--amber);
|
|
||||||
border-color: var(--amber);
|
|
||||||
}
|
|
||||||
.status-badge.status-offline {
|
|
||||||
color: var(--muted);
|
|
||||||
border-color: var(--muted);
|
|
||||||
}
|
|
||||||
/* Orphaned tombstone — `.btn-dashlink` chip that lived beside the
|
|
||||||
title moved into the overflow menu, then into `MetaNav`'s `🔗`
|
|
||||||
popover (the `↑ dashboard` item) once the overflow menu itself was
|
|
||||||
deleted — see MetaNav.tsx's file comment. */
|
|
||||||
/* Orphaned tombstone — `.btn-cancel-turn` standalone button moved into
|
|
||||||
the consolidated status badge's dropdown as a danger-toned row
|
|
||||||
(StatusChips.tsx's `StatusMenu`, `@hive/shared`'s
|
|
||||||
`.ui-dropdown-item-danger`). */
|
|
||||||
/* Orphaned tombstone — `.btn-new-session` round-pill moved into the
|
|
||||||
overflow menu, then out of the header entirely: it's a row of the
|
|
||||||
state badge's menu now, no button/chip left to style. */
|
|
||||||
/* Markup carries `hive-pill` alongside `state-badge` (shared pill.css
|
|
||||||
supplies the shape); this rule is only the transition + state-
|
|
||||||
specific colour below. */
|
|
||||||
.state-badge {
|
|
||||||
transition:
|
|
||||||
color 280ms ease,
|
|
||||||
border-color 280ms ease,
|
|
||||||
box-shadow 280ms ease,
|
|
||||||
background 280ms ease;
|
|
||||||
}
|
|
||||||
.state-badge.state-loading {
|
|
||||||
color: var(--muted);
|
|
||||||
border-color: var(--purple-dim);
|
|
||||||
}
|
|
||||||
.state-badge.state-offline {
|
|
||||||
color: var(--muted);
|
|
||||||
border-color: var(--muted);
|
|
||||||
}
|
|
||||||
.state-badge.state-idle {
|
|
||||||
color: var(--cyan);
|
|
||||||
border-color: var(--cyan);
|
|
||||||
text-shadow: 0 0 6px color-mix(in srgb, var(--cyan) 55%, transparent);
|
|
||||||
}
|
|
||||||
.state-badge.state-thinking {
|
|
||||||
color: var(--amber);
|
|
||||||
border-color: var(--amber);
|
|
||||||
text-shadow: 0 0 6px color-mix(in srgb, var(--amber) 65%, transparent);
|
|
||||||
animation: badge-pulse 1.8s ease-in-out infinite;
|
|
||||||
}
|
|
||||||
.state-badge.state-compacting {
|
|
||||||
color: var(--purple);
|
|
||||||
border-color: var(--purple);
|
|
||||||
text-shadow: 0 0 6px color-mix(in srgb, var(--purple) 65%, transparent);
|
|
||||||
animation: badge-pulse 1.8s ease-in-out infinite;
|
|
||||||
}
|
|
||||||
.state-badge.state-just-changed {
|
|
||||||
animation: state-flash 600ms ease-out;
|
|
||||||
}
|
|
||||||
@keyframes state-flash {
|
|
||||||
0% {
|
|
||||||
box-shadow:
|
|
||||||
0 0 0 0 currentColor,
|
|
||||||
0 0 0 0 currentColor;
|
|
||||||
}
|
|
||||||
60% {
|
|
||||||
box-shadow:
|
|
||||||
0 0 18px -4px currentColor,
|
|
||||||
0 0 4px 0 currentColor;
|
|
||||||
}
|
|
||||||
100% {
|
|
||||||
box-shadow:
|
|
||||||
0 0 0 0 currentColor,
|
|
||||||
0 0 0 0 currentColor;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
/* Full-screen overrides for the shared terminal rules. The base
|
|
||||||
`.terminal-wrap` (in shared/src/terminal.css) ships a crust-on-
|
|
||||||
black frame for the in-page case; the agent page now owns the
|
|
||||||
whole viewport so the frame chrome would be redundant noise.
|
|
||||||
`.live.terminal` similarly drops the in-page max-height cap so
|
|
||||||
it can fill the main area top-to-bottom; the floating header
|
|
||||||
overlays it via fixed positioning. */
|
|
||||||
.agent-main .terminal-wrap {
|
|
||||||
position: absolute;
|
|
||||||
inset: 0;
|
|
||||||
border: 0;
|
|
||||||
background: transparent;
|
|
||||||
box-shadow: none;
|
|
||||||
border-radius: 0;
|
|
||||||
margin: 0;
|
|
||||||
padding: 0;
|
|
||||||
}
|
|
||||||
.agent-main .live.terminal {
|
|
||||||
position: absolute;
|
|
||||||
inset: 0;
|
|
||||||
height: auto;
|
|
||||||
max-height: none;
|
|
||||||
/* Scroll behind the floating header, but keep the first
|
|
||||||
and last rows reachable with extra padding inside the scroll
|
|
||||||
area. scroll-padding-* keeps anchor-jumps (the `↓ N new` pill,
|
|
||||||
focus restore) clear of the floats too. */
|
|
||||||
padding-top: calc(var(--agent-header-real-h, var(--agent-header-h)) + 0.8em);
|
|
||||||
padding-bottom: 0.8em;
|
|
||||||
scroll-padding-top: calc(
|
|
||||||
var(--agent-header-real-h, var(--agent-header-h)) + 0.8em
|
|
||||||
);
|
|
||||||
scroll-padding-bottom: 0.8em;
|
|
||||||
overflow: auto;
|
|
||||||
}
|
|
||||||
/* Tail pill (↓ N new): z-index bumped above the floating chrome so the
|
|
||||||
pill sits on the top layer instead of being clipped by it. (Pill is anchored in
|
|
||||||
`.agent-main` rather than `.terminal-wrap` — see
|
|
||||||
docs/4-implementation/web-ui/agent-page.md::Per-agent page Terminal-wrap paragraph for the
|
|
||||||
backdrop-filter stacking-context rationale.) */
|
|
||||||
.agent-main .tail-pill {
|
|
||||||
bottom: 0.6em;
|
|
||||||
z-index: 35;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* ─── side panel (singleton drawer) ────────────────────────────────
|
|
||||||
Inbox + loose-ends details open here instead of expanding inline. The
|
|
||||||
drawer chrome itself (backdrop, drawer, resize handle, header, title,
|
|
||||||
close button) is the shared `<hive-side-panel>` element
|
|
||||||
(@hive/shared/side-panel.js, including drag-to-resize); what's left
|
|
||||||
here is the drag cursor-override escape hatch (has to be a global,
|
|
||||||
light-DOM rule — it reaches every element on the page during a
|
|
||||||
drag, not just the shared element's own shadow tree) and the
|
|
||||||
styling for the panel's own content types, which the shared
|
|
||||||
element's shadow tree can never reach (see
|
|
||||||
@hive/shared/side-panel/hive-side-panel.css's header comment). The
|
|
||||||
`hive-side-panel .agent-inbox …` rules below use the element's own
|
|
||||||
tag name as the selector root — no compatibility class needed, the
|
|
||||||
tag name already uniquely identifies the light-DOM instance app.js's
|
|
||||||
`sidePanel` creates. */
|
|
||||||
body.side-panel-resizing {
|
|
||||||
user-select: none;
|
|
||||||
}
|
|
||||||
body.side-panel-resizing * {
|
|
||||||
cursor: ew-resize !important;
|
|
||||||
}
|
|
||||||
/* Inbox / loose-ends lists rendered into the side-panel body: strip
|
|
||||||
the inbox-only chrome (background, border-left) here and let the
|
|
||||||
panel body's own padding own the framing. */
|
|
||||||
hive-side-panel .agent-inbox {
|
|
||||||
margin: 0;
|
|
||||||
font-size: inherit;
|
|
||||||
color: var(--fg);
|
|
||||||
}
|
|
||||||
hive-side-panel .agent-inbox ul {
|
|
||||||
background: transparent;
|
|
||||||
border-left: 0;
|
|
||||||
padding: 0;
|
|
||||||
max-height: none;
|
|
||||||
overflow: visible;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Empty-state placeholders for the side panel (when count drops to 0
|
|
||||||
between the click and the render — rare, but possible). */
|
|
||||||
.side-panel-empty {
|
|
||||||
color: var(--muted);
|
|
||||||
font-style: italic;
|
|
||||||
padding: 1em 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Hive identity row — shows "swarm / hive" label beneath the title.
|
|
||||||
Hidden until JS populates from /api/state (hive_name + swarm_name).
|
|
||||||
Mirrors the `.banner-thin` style in dashboard.css but kept tight
|
|
||||||
(no letter-spacing, smaller text) so it reads as a sub-label. */
|
|
||||||
.agent-hive-row {
|
|
||||||
/* Omit the default row gap when the row is hidden to avoid a
|
|
||||||
blank gap between the title row and the state row. */
|
|
||||||
gap: 0;
|
|
||||||
}
|
|
||||||
.agent-hive-label {
|
|
||||||
font-size: 0.72em;
|
|
||||||
letter-spacing: 0.1em;
|
|
||||||
color: var(--purple-dim);
|
|
||||||
text-transform: uppercase;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* ─── /stats page ────────────────────────────────────────────────────────── */
|
/* ─── /stats page ────────────────────────────────────────────────────────── */
|
||||||
/* The stats page header (back link + title) uses the shared
|
/* The stats page header (back link + title) uses the shared
|
||||||
|
|
|
||||||
|
|
@ -1,44 +0,0 @@
|
||||||
// <AgentUserMenu> — the profile menu (`@hive/shared/user-menu.js`) in this
|
|
||||||
// page's header. Only behind the gateway: the page is then on the dashboard's
|
|
||||||
// own origin, where the session cookie is valid and nginx proxies
|
|
||||||
// `/api/whoami` to authelia. Opened directly on the agent's own port there is
|
|
||||||
// no sign-in to show, so the page has no menu.
|
|
||||||
//
|
|
||||||
// Authelia's URL, for the settings and sign-out links, comes from the
|
|
||||||
// dashboard's `/api/state` (`authelia_public_url`), the one place hive-c0re
|
|
||||||
// states it.
|
|
||||||
import { useEffect, useState } from "preact/hooks";
|
|
||||||
import { UserMenu } from "@hive/shared/user-menu.js";
|
|
||||||
import "@hive/shared/user-menu.css";
|
|
||||||
import { isBehindGateway } from "../lib/dashboardBase.js";
|
|
||||||
|
|
||||||
export function AgentUserMenu({ dashboardBase }: { dashboardBase: string }) {
|
|
||||||
const behind = isBehindGateway();
|
|
||||||
const [autheliaUrl, setAutheliaUrl] = useState<string | null>(null);
|
|
||||||
|
|
||||||
useEffect(() => {
|
|
||||||
if (!behind) return;
|
|
||||||
let cancelled = false;
|
|
||||||
fetch(`${dashboardBase}api/state`)
|
|
||||||
.then((r) =>
|
|
||||||
r.ok ? r.json() : Promise.reject(new Error(`http ${r.status}`)),
|
|
||||||
)
|
|
||||||
.then((state: { authelia_public_url?: string | null }) => {
|
|
||||||
if (!cancelled) setAutheliaUrl(state.authelia_public_url ?? null);
|
|
||||||
})
|
|
||||||
.catch(() => {
|
|
||||||
/* cosmetic only: the menu then shows the name without the links */
|
|
||||||
});
|
|
||||||
return () => {
|
|
||||||
cancelled = true;
|
|
||||||
};
|
|
||||||
}, [behind, dashboardBase]);
|
|
||||||
|
|
||||||
if (!behind) return null;
|
|
||||||
return (
|
|
||||||
<UserMenu
|
|
||||||
whoamiUrl={`${dashboardBase}api/whoami`}
|
|
||||||
autheliaUrl={autheliaUrl}
|
|
||||||
/>
|
|
||||||
);
|
|
||||||
}
|
|
||||||
Some files were not shown because too many files have changed in this diff Show more
Loading…
Reference in a new issue