Watch
0
0
Fork
You've already forked hyperhive
0
Commit graph hyperhive/docs/4-implementation
Author SHA1 Message Date
damocles
eff209f756 agents can transcribe an audio file: the transcribe_audio tool, through the harness and the speech-to-text service 2026-11-12 12:18:18 +01:00
iris
ebcf838dd8 docs: the terminal's model and effort badges open the inference settings 2026-11-12 10:37:30 +01:00
atlas
bd79b58e78 log the agent bridge's forwarded flows in the hive_egress table
A forward chain in the hive-owned nft table logs each new flow from the agent bridge to the uplink (v4 and v6) and counts every packet. It never blocks. The mesh interface is skipped. Logging is rate limited per source address; a flow that limit cannot log gets one line from a shared limit with its own prefix. services.hyperhive.network.egress.forward selects accept, log (default) or drop; drop is refused at evaluation until the interception it needs exists.
2026-11-12 09:20:51 +01:00
damocles
f5e7caa2eb swarm-stt: reply deadline agrees with the limits, one request per agent, short errors to the sender 2026-11-12 09:07:04 +01:00
damocles
ee10acb154 swarm-stt: the daemon (queue connection, request/reply, busy limit, hourly purge) and its settings docs 2026-11-12 09:07:04 +01:00
atlas
8530a5b7fd swarm-nats: the auth responder has no start limit, always restarts, and is started after the server's restarts 2026-11-12 07:42:25 +01:00
iris
175019607c docs: the swarm UI pages say agent list where they said roster 2026-11-12 00:05:08 +01:00
iris
7ba684a1da docs: the agent roster page is Agent permissions, and the docs say agent list
Roster named the permissions page, the hive's topology file and the swarm's list of agents without saying which. The page and its links are renamed; the implementation docs and UI text follow separately.
2026-11-11 23:52:15 +01:00
damocles
33e63091d5 swarm-stt: only files that start like an audio container reach ffmpeg 2026-11-11 23:10:17 +01:00
damocles
f8e1d0fbbd swarm-stt: time-box a run and decode pipe-only 2026-11-11 23:10:17 +01:00
damocles
df4b2f1838 swarm-stt: the speech-to-text core (hash cache, shared runs, ffmpeg and whisper-cli engine) 2026-11-11 23:10:17 +01:00
atlas
f2e735a98f treefmt covers python with ruff-format and ruff-check, ruff in the dev shell 2026-11-11 22:35:54 +01:00
atlas
c1c5fe9704 vm-tests: full-setup script lives in full-setup.py, build-time values in env, ruff in ci 2026-11-11 22:35:54 +01:00
atlas
8847fa48c9 the classifier alert also fires on an undecodable request and an unpublished reply 2026-11-11 22:35:05 +01:00
damocles
ca977fda36 docs: the web UI's bulk mark-done deadline and id cap 2026-11-11 22:07:37 +01:00
atlas
13ff33ead0 archetype flows on the board list the agents the router sends to, and the docs say a switch-off key outlives its flow 2026-11-11 21:40:17 +01:00
atlas
68c24643f6 archetype flows behave like the built-ins: switch off per archetype or per agent, board cards, duplicate
The document's disabled list takes archetype:<archetype>/<flow> (off for every member) and the same with @<agent> (off for one member); a key naming nothing is ignored. GET /api/notify/flows lists the archetype flows with their members, the board draws a card for each with a switch, a checkbox per agent and duplicate, and the dry run counts their hits. The flows keep following the archetype.
2026-11-11 21:40:17 +01:00
atlas
1efbb72fdd an archetype carries its own notification-router flows for its agents
ArchetypeMeta gets flows, checked when the controller stores the record: every todo must go to the new members recipient, which the router expands to the agents of the archetype. The operator's flows document refuses members. The router reads the archetype records and each roster agent's archetype key, and its NATS grant gains read on both buckets.
2026-11-11 21:40:17 +01:00
atlas
493d2e6c37 ci-runner: warn when the host has no nix store gc 2026-11-11 20:34:11 +01:00
damocles
c5729b4124 forge notify: a review stays in the todo's inline block until the agent answers it, not just until it was delivered once
The todo row is last-write-wins, so a review delivered in one version of the row disappeared when a later comment rewrote it, because the inline tail only listed reviews newer than the last delivery. The baseline is now the agent's own last review or comment on the thread.
2026-11-11 19:12:06 +01:00
iris
119e225c17 docs: reword the set-key note without passive voice 2026-11-11 19:01:01 +01:00
iris
2370f99229 docs: a classifier key shown as set may still not work
The controller can only see that the leaf exists, so a key under the wrong field name or a deleted latest version still shows as set.
2026-11-11 19:01:01 +01:00
iris
6875a4f0f8 swarm-ui: set the review classifier's keys from the classifier settings
The classifier's Anthropic and ACP provider keys were written by hand in the
secret store's UI. The controller now stores them: GET
/api/review-classifier/keys says whether each is set and when it changed, and
PUT /api/review-classifier/keys/{runtime} writes one. No route answers a key.

The controller's store policy gains create and update on the two leaves with
no read of their values, and a metadata read for the set state. The swarm UI's
classifier settings card gets a key form beside the settings, saved apart
because it goes to the secret store.
2026-11-11 19:01:01 +01:00
atlas
c5d601e3a2 alert when a review-classifier run fails 2026-11-11 18:39:44 +01:00
atlas
eb39a90057 load the agent-bridge to loopback drop in its own nft table 2026-11-11 16:54:07 +01:00
damocles
748ef2da08 hives report an agent being updated: its status shows updating from the update's stop until the container is back up
A hive marks an agent updating when StopForUpdate stops its running container and clears it when the tail Reconcile or Start settles it, success or failure. The flag rides in the agent status snapshot (absent when false, so older readers and documents are unchanged), the status publisher sends a change at once instead of at the next sweep, and the swarm UI card shows an updating badge.
2026-11-11 16:51:42 +01:00
iris
ca1e25b21e grafana: the egress board filters by domain as well as by agent
A domain variable, the destination host from the proxy's access log, sits beside
the agent one and every query on the board filters on both, so one domain and
its agents show which agents queried it and when.
2026-11-11 15:28:13 +01:00
atlas
5233259b3b ruth is created from a ruth archetype that runs sonnet 2026-11-11 12:24:40 +01:00
iris
aff8cf629d docs: three anchors that were already broken point at their headings
The swarm UI reference links the try-out section by its heading, and drops a
pointer to a hivectl section that never existed along with the sentence that
claimed hivectl sets the hive's limits. The turn-loop index links the
persistence reference's /harness/paused heading by its real slug.
2026-11-11 10:31:14 +01:00
iris
77ac5bab4a docs: the swarm UI reference describes the archetype tiles in the create dialog 2026-11-11 10:09:50 +01:00
iris
f52bc673c6 docs: the roster pages use contractions and the active voice 2026-11-11 10:07:46 +01:00
iris
e746ed1888 docs: the agent roster page keeps the operator view and moves the topology detail out
The page says who is on the roster, who may reach whose state and that the
manager is a normal agent. How topology.json is read and rebuilt, the wire
protocol and the prompt blocks move to 4-implementation/agent-state/roster.md,
unchanged, since the code they describe still exists.
2026-11-11 10:07:46 +01:00
atlas
02f21940a4 pr conflicts: bound the forge list and skip branches no pr targets 2026-11-11 09:12:05 +01:00
atlas
11eb7dac9c an agent gets one todo when its pr starts conflicting with the target branch 2026-11-11 09:12:05 +01:00
atlas
32155f70aa the operator's bao works on a store host without a hive 2026-11-11 09:10:50 +01:00
atlas
039896c506 the built-in archetypes come with a default prompt 2026-11-11 09:10:12 +01:00
iris
7053dcffc0 docs: the claude login reference names the stored-login routes 2026-11-11 09:05:59 +01:00
iris
aa1ae2729f docs: the claude login page keeps the operator steps and moves the minter detail out
The queue subjects, scratch directory and stdio steps of a login, the harness's
newer-version rule, the minter's grants, the caveat and the metrics move to
4-implementation/swarm/claude-login.md. The handbook page keeps how to log an agent
in, the stored login and who may do it. Design pointers in the nix module, the
crate README and AGENTS.md name the new page.
2026-11-11 09:05:59 +01:00
damocles
c0eb6780ec templates: the agent system prompt is a Jinja template, rendered through hive-template
system.md carries {{ label }}-style variables and an {% if not archetype %} block in place of the config:repo / config:archetype marker pairs, so prompt.rs drops its line filter, marker parsers and string replaces. The rendered prompt is byte for byte the old one for a custom agent, an archetype agent and an empty archetype name, with and without hive, swarm, docs and operators. hive-template now drops a block tag's own line.
2026-11-11 09:04:42 +01:00
iris
4adbc939f2 docs: the swarm UI page shrinks to an overview
The page-by-page and control-by-control description of the swarm UI moves to
4-implementation/web-ui/swarm-ui.md, with the quick-links wiring. The handbook
page keeps the route table, how to reach the UI, who may and what the browser
keeps. Links to the moved sections point at the new page.
2026-11-11 09:03:05 +01:00
atlas
d48cc83dcb collectors: retry a failed start forever with a growing delay instead of hitting start-limit 2026-11-11 09:01:44 +01:00
damocles
8ef3138863 templates: one Jinja language (hive-template) for the notify router's flows, flows document version 2
A todo node's key and text were hand-expanded `{field}` strings. They are now Jinja templates rendered through the new hive-template crate (minijinja, an unknown variable is an error), and the controller's save check reads the variables the template uses. The flows document is version 2; a version 1 document reads as version 2 with each `{field}` converted to `{{ field }}`, and the next save writes it.
2026-11-11 03:40:22 +01:00
atlas
11393bc538 budgeted agents throttle at 90% of the cap; alert on repeated oom kills 2026-11-11 02:38:53 +01:00
atlas
c014b48c22 document budgeted-agent swap and oom metrics; add oom kills panel 2026-11-11 02:38:53 +01:00
iris
2acde41e54 docs: the hive dashboard and agent page shrink to overviews
The hive dashboard and the per-agent page lose their control-by-control UI
description and endpoint tables from the handbook. The full text moves to
4-implementation/web-ui/dashboard.md and agent-page.md, and the handbook pages
keep what an operator needs to find and use them. Code comments that named the
old sections point at the new pages.
2026-11-11 01:50:55 +01:00
iris
ead667da42 docs: the credentials page keeps the approach and moves the mechanics out
credentials.md drops the target-shape framing and keeps the rules, where a
secret lives, the swarm- and hive-level secrets and how to add one. The queue
responder's keys, per-principal identities, how a reader reaches the store, the
store UI's login and where the root lives move to
4-implementation/swarm/credentials.md. The per-secret reference moves to
4-implementation/swarm/credentials-reference.md. Links and comments follow.
2026-11-11 01:50:55 +01:00
iris
c3791a0c8a docs: the destroy-versus-purge pointer names the handbook persistence section 2026-11-11 01:50:35 +01:00
iris
0ae34b1cd0 docs: persistence and config changes become one operator page
The operator parts of the persistence and config-changes pages merge into
agents/persistence.md. The sqlite tables, state dirs, mounts and migrations move
to 4-implementation/agent-state/persistence.md, and the deploy path, meta flake,
deploy markers, startup migrations, root container, system messages and
autoupdate move to 4-implementation/agent-state/config-changes.md. Links, code
comments and nix comments that named the old sections point at the new pages.
2026-11-11 01:50:35 +01:00
iris
0f39bdaaa4 docs: the forge, knowledge, archetypes, matrix and SSO pages move their implementation detail out
Account minting, knowledge sync, the archetype refresh, the matrix appservice
flow and the SSO secret delivery move to pages under 4-implementation/swarm.
Each handbook page keeps what an operator does or sees, with a pointer.
2026-11-11 01:47:20 +01:00
iris
7832223536 docs: the failures-only setting names the dropped rows in the active voice 2026-11-11 01:39:05 +01:00