Watch
0
0
Fork
You've already forked hyperhive
0
hyperhive/docs/4-implementation/swarm
Repository files (latest commit first)
Filename Latest commit message Latest commit date
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
..
archetypes.md an archetype carries its own notification-router flows for its agents 2026-11-11 21:40:17 +01:00
bao.md 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
builder.md 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
ca.md document the controller tcp listener and its two leaves 2026-11-20 19:24:20 +01:00
ci-metrics.md docs: swarm/services.md is one blurb per service, the host detail moves to the service's implementation page 2026-11-14 13:28:02 +01:00
claude-login.md remove the agent's live terminal page and the endpoints only it used 2026-11-16 08:06:47 +01:00
controller.md document the controller tcp listener and its two leaves 2026-11-20 19:24:20 +01:00
credential-delivery.md docs: the swarm README and credentials page keep the overview, the rest moves to its own pages 2026-11-14 13:33:50 +01:00
credentials-reference.md swarm: an agent's backend secrets get a store leaf of their own, and its backend environment reads back 2026-11-20 20:36:33 +01:00
credentials.md swarm-nats: the units the responder requires uphold it 2026-11-19 12:26:13 +01:00
forge-accounts.md a removed hive's OIDC client secret is deleted with its other store credentials 2026-11-19 08:42:46 +01:00
inference.md 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
knowledge.md docs: the forge, knowledge, archetypes, matrix and SSO pages move their implementation detail out 2026-11-11 01:47:20 +01:00
matrix-provisioning.md 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
notify-router.md docs: swarm/services.md is one blurb per service, the host detail moves to the service's implementation page 2026-11-14 13:28:02 +01:00
readiness.md swarm-controller: an opt-in plain /healthz and /readyz listener a kubelet can probe 2026-11-19 12:23:17 +01:00
review-classifier.md swarm ui: ask before actions that cannot be undone, with a danger button and a useConfirm hook 2026-11-20 02:13:23 +01:00
ssh-ca.md egress: document the allowed ssh connections 2026-11-20 04:04:30 +01:00
sso.md docs: swarm/services.md is one blurb per service, the host detail moves to the service's implementation page 2026-11-14 13:28:02 +01:00
stt.md docs: swarm/services.md is one blurb per service, the host detail moves to the service's implementation page 2026-11-14 13:28:02 +01:00
telemetry.md swarm-victorialogs: own network namespace, gateway over a unix socket 2026-11-18 19:17:58 +01:00