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

docs: say that re-creating an undeclared agent leaves it paused

Browse source 
`swarmctl agent create` declares an agent the swarm has no declaration
for as paused, so ruth needs setting `up` from her card after step 4.
Restores the warning to re-create agents before a hive-side change makes
a container require a store identity.
This commit is contained in:
atlas 2026-10-13 01:17:42 +02:00 • committed by mara
commit ff0a6f1ca3
2 changed files with 14 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

5
docs/getting-started/setup.md
View file

@ -99,6 +99,11 @@ swarmctl agent create ruth --hive <hive> # on the swarm-controller's host
hivectl agent ruth rebuild # on ruth's hive: hands her the identity hivectl agent ruth rebuild # on ruth's hive: hands her the identity
``` ```
`agent create` declares an agent the swarm has no declaration for as
`paused`, so without a further step ruth keeps running but drives no turns.
`swarmctl` has no verb for wanted state: open `/agents` in the swarm UI and set
her `up` from her card.
Within about ten minutes the controller creates her forge user and matrix Within about ten minutes the controller creates her forge user and matrix
account and mints their tokens into the store, where she fetches them. account and mints their tokens into the store, where she fetches them.
`swarmctl agent mint-forge-token ruth` skips the wait for the forge token. `swarmctl agent mint-forge-token ruth` skips the wait for the forge token.

10
docs/swarm/credentials.md
View file

@ -113,7 +113,15 @@ swarmctl agent mint-forge-token <agent>
An agent without a store identity gets no swarm token and keeps using the An agent without a store identity gets no swarm token and keeps using the
`forge-token` file in its state dir, if it has one; re-create it with `forge-token` file in its state dir, if it has one; re-create it with
`swarmctl agent create` to give it one. `swarmctl agent create` to give it one. The swarm leaves an agent it already
declares as it is. For an agent with no declaration, such as one only its hive
knows about, `agent create` declares it `paused`; set it `up` from its card in
the swarm UI.
⚠️ **Re-create existing agents before deploying a hive-side change that makes a
container require a credential it may not have.** A container whose store
identity is absent doesn't start (`nix/agent-modules/bao.nix` exits 1), so
create the identities first, setting any newly paused agent `up` as above.
**Revoking an agent's queue credential.** Declaring an agent `destroyed` — **Revoking an agent's queue credential.** Declaring an agent `destroyed` —
`PUT /api/hives/{hive}/agents/{agent}/state` — deletes `PUT /api/hives/{hive}/agents/{agent}/state` — deletes