Watch
0
0
Fork
You've already forked hyperhive
0
Commit graph hyperhive/docs/4-implementation/swarm
Author SHA1 Message Date
damocles
5814f177c8 docs: the swarm-builder status gates the merge now, and no promise about rebasing a PR branch 2026-11-21 21:40:56 +01:00
damocles
2ea8c9de60 docs: controller merge gate paragraph without passive voice 2026-11-21 21:40:56 +01:00
damocles
7a7041452e swarm-controller: config repos require the swarm-builder status and default to fast-forward-only merges 2026-11-21 21:40:56 +01:00
iris
33fdd5205e swarm: an agent's backend secrets get a store leaf of their own, and its backend environment reads back
The credentials of an agent's backend (ANTHROPIC_API_KEY and the like) move to their own leaf, swarm/agents/<agent>/backend-secrets, written through new PUT, GET and DELETE routes on /api/hives/{hive}/agents/{agent}/backend-secrets. GET says only whether any are stored. The backend environment at backend-env now reads back as stored through GET on its route, so it holds configuration only.

The agent's hive-agent-backend-env unit now runs on every agent with a store, reads both leaves and writes the configuration and then the secrets into the one file the harness and the subagent daemon load, so a secret wins over a variable of the same name. It removes the file when the store holds neither. The harness counts an agent whose environment holds ANTHROPIC_API_KEY or ANTHROPIC_AUTH_TOKEN as API-billed, so it tries the key instead of waiting for a Claude login; a real 401 still sets needs-login. The controller's policy may delete the new leaf.

Tests: the secret-client path, the controller routes, the script test of the unit with a stub bao, the module-eval cases and the harness's mode check. Docs: the swarm UI routes, the credentials reference and the API-key provider page.
2026-11-20 20:36:33 +01:00
atlas
cd786ef401 document the controller tcp listener and its two leaves 2026-11-20 19:24:20 +01:00
atlas
eab2dcb0a2 egress: document the allowed ssh connections 2026-11-20 04:04:30 +01:00
atlas
934da6f31f agent ssh connections: declare per agent, render into the agent's ssh config 2026-11-20 03:10:41 +01:00
iris
c3e24fe2c6 swarm ui: ask before actions that cannot be undone, with a danger button and a useConfirm hook
Button gains a danger variant and an autofocus prop; ConfirmDialog gains danger (red confirm, focus on cancel). Destroy, delete linked account, delete claude login, remove schedule and delete flow use it. New useConfirm hook asks from inside a handler (await confirm({...})) without a dialog's state at the call site. It now guards: removing a swarm-wide egress domain, removing a domain for every agent from an agent's popover, removing a stored API-key environment, firing a schedule now, moving an agent's internet to a looser mode, the /clear message, and reload over unsaved instructions (replacing window.confirm). The review try-out's button is now called push a branch for a PR, since it pushes a branch and does not open one, and asks first. loosensInternet is a tested helper.
2026-11-20 02:13:23 +01:00
atlas
887ea26c56 swarm-nats: the units the responder requires uphold it
A start job of swarm-nats-auth that fails on a dependency (the server, or
the container's trust bundle, failing first) leaves the unit inactive
rather than failed, so Restart=always never applies. Its recovery was a
set of one-shot host kicks; when the last of them still found a
dependency down, the responder stayed dead and the queue refused every
client (nightly full-setup, runs 8058 and 7917).

upheldBy the units it requires: whichever comes up last starts it.
2026-11-19 12:26:13 +01:00
maia
ffbd2f4dea swarm-controller: an opt-in plain /healthz and /readyz listener a kubelet can probe 2026-11-19 12:23:17 +01:00
maia
b0239914b8 readiness follows a cached store check instead of a constant or a login per probe 2026-11-19 08:43:43 +01:00
maia
2eacb83b21 a removed hive's OIDC client secret is deleted with its other store credentials 2026-11-19 08:42:46 +01:00
maia
c7d37ca455 grant-bootstrap re-applies the granter and restarts failed policy units; setup treats a refused granting unit as not done 2026-11-19 08:17:02 +01:00
maia
188dbcea8b swarm-victorialogs: own network namespace, gateway over a unix socket 2026-11-18 19:17:58 +01:00
maia
a3682a5e9a ship the cache's init units' journal from a host with no collector, with the cache's own client 2026-11-18 09:43:57 +01:00
atlas
b6dc46d315 document the hive cut-off 2026-11-17 06:48:05 +01:00
iris
fe4d68c13f the harness no longer publishes the agent's icon; the controller is its only writer 2026-11-17 06:47:48 +01:00
iris
78a7f7f72c fix the prose lint on the builder icon paragraph 2026-11-16 23:01:08 +01:00
iris
181ef5f421 the builder reads an agent's icon from its config and the controller writes the swarm's copy 2026-11-16 23:01:08 +01:00
maia
6b3e1f0fb2 revoking a linked Matrix account also deletes its key-backup passphrase; a plain unlink keeps it for a relink 2026-11-16 22:49:16 +01:00
atlas
87dc4c5533 lock the service forge accounts out of creating organizations 2026-11-16 21:40:02 +01:00
atlas
3d7541c0af sign ssh certificates on demand from ssh itself, warn before setup, say what to do when a host key changes 2026-11-16 20:31:18 +01:00
atlas
e621397252 swarm ui ssh row with target snippets, docs for the per-agent switch 2026-11-16 20:31:18 +01:00
atlas
aeb9317ad1 correct the ssh revocation docs and say the sign permission is shared 2026-11-16 20:31:18 +01:00
atlas
0afb111862 add an ssh ca to bao, agent ssh certificates and a target module 2026-11-16 20:31:18 +01:00
iris
50d318c92a fix two references to removed things in the stats page removal 2026-11-16 19:55:48 +01:00
atlas
299b922039 disable a destroyed agent's identity entity and delete its login role 2026-11-16 17:09:08 +01:00
iris
0db9868eee swarm ui: an unset fresh-session handle does not hold the soft handle up; docs vale fixes 2026-11-16 11:04:04 +01:00
iris
5175d3663e swarm: set the fresh-session threshold per agent 2026-11-16 10:50:13 +01:00
iris
6289b8d64b remove the agent's live terminal page and the endpoints only it used 2026-11-16 08:06:47 +01:00
iris
fb9d4b5040 swarm: /clear starts an agent's next turn on a fresh session 2026-11-16 03:21:20 +01:00
damocles
07c66e3a1c agents get read, not write, on their own agent-configs repo; an existing grant is left alone 2026-11-16 01:34:25 +01:00
iris
b239500f88 swarm: an agent's open todos, mirrored to the queue and served by the controller 2026-11-16 01:21:52 +01:00
damocles
dc0d08b7fb add a /clear-todos command that marks the agent's todos done 2026-11-16 01:06:02 +01:00
damocles
49719842b0 publish the agent's skills to the agent-commands bucket 2026-11-15 21:31:07 +01:00
iris
8f11a38d17 swarm: the commands and skills an agent's message box offers
GET /api/agents/{name}/commands answers with the swarm's own commands, a table
in the controller, then the skills the agent's harness published to its key of
the agent-commands bucket. The published part is untrusted and cut down: plain
names only, no repeats, never a command's name, a capped list and one short line
per description. The agent credential may publish its own key. Nothing publishes
yet; the harness half and the swarm UI menu follow.
2026-11-15 20:05:54 +01:00
iris
5de20f31dd swarm: list an agent's bash tasks from their published status
GET /api/agents/{name}/bash-tasks reads the agent's keys of the bash-task-status
bucket and reports each task's state, command and times, with a live task whose
daemon stopped reporting as stale. The swarm UI shows them in a background tasks
section of the agent card, running ones first. The task output stays unread.
2026-11-15 19:51:37 +01:00
damocles
c0b9c1778c hive-bash-mcp: publish each task's status and output to the swarm queue 2026-11-15 18:23:28 +01:00
iris
1a698f1a97 swarm: bash task status keys expire after 72 hours
Nothing deletes the key of a finished task, so the bucket would grow with every
task an agent runs. The shared bucket helper takes an optional max age, applied
when the bucket is created; a live task's republishing keeps its own key.
2026-11-15 18:22:16 +01:00
iris
1779fa0568 swarm: the contract for an agent's bash task status and output
A status key per task in the bash-task-status bucket and the task's output rows
in a per-agent stream, kept apart as for subagents. The controller creates the
bucket and the streams, and the agent credential may publish its own keys and
subjects. Nothing publishes yet; the bash MCP half follows.
2026-11-15 18:22:16 +01:00
damocles
b19b730a3a prettier the inference.md table 2026-11-15 17:21:13 +01:00
damocles
8147b76cda docs: fix the two vale errors in the soft context limit paragraph 2026-11-15 17:21:13 +01:00
damocles
1e03979836 swarm: a soft context limit per agent, as a percent of the window, applied at turn end 2026-11-15 17:21:13 +01:00
iris
91cf4d2ae1 icons for the swarm's own forge accounts, and a default agent icon
The builder, ci-metrics and review-classifier forge accounts get an avatar: an
icon each in a hexagonal frame, the hyperhive logo when one is missing. The
controller sets them with a short-lived write:user token it mints for the
account, since only an account can set its own avatar.

An agent with no icon of its own shows a default agent icon in the swarm UI, a
robot head in a round frame, instead of the dimmed hyperhive mark.
2026-11-15 17:14:16 +01:00
iris
c7d7f0df55 swarm: subagent-status KV bucket, the run state of each subagent
One key per subagent (<agent>.<subagent>) holding running/finished, since,
exit, model, effort and the publish time. The controller creates the bucket,
and the agent credential may publish its own keys. Nothing reads or writes
it yet; the daemon publisher and the controller list follow.
2026-11-15 15:36:12 +01:00
atlas
4bd02ea14d agents keep their github token in /run, fetched on every start, not in the state dir 2026-11-15 14:08:57 +01:00
atlas
adc61c9043 remove the swarm wireguard mesh; tombstone its options 2026-11-15 02:17:44 +01:00
atlas
3fa926d7d6 otel: collectors drop their own export-failure lines instead of shipping them 2026-11-15 01:20:18 +01:00
atlas
f5e99fe248 gateway: cache authelia's 200 verdicts on the log and metric ingest routes 2026-11-14 22:05:08 +01:00
iris
0e99662710 docs: the swarm README and credentials page keep the overview, the rest moves to its own pages
The hive directory and the WireGuard mesh become handbook pages of their own,
the controller's mint-failure handling moves to controller.md, and the
credential-by-credential mechanics and the secret store UI's proxy move to a new
implementation page.
2026-11-14 13:33:50 +01:00