Watch
0
0
Fork
You've already forked hyperhive
0

docs: the swarm UI reference on /clear and the new-session route

This commit is contained in:
iris 2026-11-16 02:26:26 +01:00
commit 503a56853a

View file

@ -108,7 +108,9 @@ An opened card has six sections, and each reads nothing until you open it.
link), and its open config PR. link), and its open config PR.
- **terminal**: the live terminal with its message box. Typing `/` opens a menu - **terminal**: the live terminal with its message box. Typing `/` opens a menu
filled from `GET /api/agents/<name>/commands`, which lists the swarm's own filled from `GET /api/agents/<name>/commands`, which lists the swarm's own
commands and the skills the agent published. commands and the skills the agent published. Sending exactly `/clear` isn't a
message: the box POSTs `/api/agents/<name>/new-session` instead of `/input` (see
the command paragraph below).
- **open todos**: the agent's open todos from `GET /api/agents/<name>/todos`, newest first, each with - **open todos**: the agent's open todos from `GET /api/agents/<name>/todos`, newest first, each with
its subsystem, one line of text and how long ago it changed. Read only; refetched every ten seconds. its subsystem, one line of text and how long ago it changed. Read only; refetched every ten seconds.
- **subagents**: the agent's subagents and their terminal preview (next section). - **subagents**: the agent's subagents and their terminal preview (next section).
@ -561,6 +563,15 @@ Unlike input, the harness answers a command, so swarm-controller returns that
answer as 200, 503 for no subscriber, and 504 when the harness held the command answer as 200, 503 for no subscriber, and 504 when the harness held the command
and didn't answer within ten seconds. A 504 means unknown, not cancelled. and didn't answer within ten seconds. A 504 means unknown, not cancelled.
`POST /api/agents/<name>/new-session` is the second command, sent for `/clear` in
the message box. It sends `"new_session"` on the same subject, and the harness
queues the session reset its own page's button queues, which takes effect at the
agent's next turn; it always answers `{acted: true}`. The statuses are the cancel
route's, and a 504 means it's unknown whether the command took effect. The box
sends a command only when the served command list has `/clear` as a swarm
command: while the list hasn't loaded, or its request fails, `/clear` goes out
as a plain message.
</details> </details>
<details><summary>Where the subagent list and rows come from</summary> <details><summary>Where the subagent list and rows come from</summary>