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

docs(web-ui/agent): update inbox flyout to reflect unread-only filter

Browse source 
The broker's recent_for was fixed to filter acked_at IS NULL (commit
5264828091), so the agent inbox flyout
now shows only unread messages and empties after 'mark all read'.

The agent.md prose still described the old behaviour ('shows the
most-recent N regardless of ack state; the list stays put after drain').
Update it to match: unread-only, list empties on reload after drain.
This commit is contained in:
iris 2026-07-02 12:14:11 +02:00 • committed by mara
commit 2c317c1106
1 changed files with 6 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -142,17 +142,16 @@ prompt" below).
**Side panel** (slide-in from right): singleton shared with the **Side panel** (slide-in from right): singleton shared with the
dashboard's side panel shape. Carries inbox and loose-ends flyouts dashboard's side panel shape. Carries inbox and loose-ends flyouts
(opened via the header pills) as well as long content (file previews, (opened via the header pills) as well as long content (file previews,
diffs, journald logs). Inbox flyout: last 30 messages addressed to diffs, journald logs). Inbox flyout: unread messages addressed to
this agent (`AgentRequest::Recent { limit: 30 }`); reply messages this agent (`acked_at IS NULL`, newest-first, up to 30); reply
indented with `↳ reply ·` in amber. A `✓ mark all read` button messages indented with `↳ reply ·` in amber. A `✓ mark all read`
appears in the flyout header when the inbox is non-empty; button appears in the flyout header when the inbox is non-empty;
clicking it confirms then POSTs cross-origin to the core clicking it confirms then POSTs cross-origin to the core
dashboard's `POST /api/agent/{name}/mark-all-read` — all pending dashboard's `POST /api/agent/{name}/mark-all-read` — all pending
messages for this agent are acked, the harness won't receive messages for this agent are acked, the harness won't receive
wake-prompts for them. A `{ marked: N }` pill surfaces the count. wake-prompts for them. A `{ marked: N }` pill surfaces the count.
The displayed message list stays put (it shows the most-recent N After the drain the inbox list empties on reload (the filter is
regardless of ack state); the unread badge on the next turn-start `acked_at IS NULL`, so drained messages disappear). Loose-ends flyout: questions,
will reflect zero. Loose-ends flyout: questions,
approvals, and reminders pending against this agent (`GET /api/loose-ends`); approvals, and reminders pending against this agent (`GET /api/loose-ends`);
question rows carry an inline answer form that POSTs cross-origin to question rows carry an inline answer form that POSTs cross-origin to
the core dashboard's `/answer-question/{id}` so the operator answers the core dashboard's `/answer-question/{id}` so the operator answers