docs(adr): ADR 0021's D57–D63, the operator's screen, budgets and effort

After the first use on learn.halkyon.eu, the developer decided how the
operator's side scales and how much an assistant thinks: the figures'
months oldest first (D57); a budget per person covering the assistants
granted, one sheet granting several people several assistants (D58,
amending D3); the budget in money and tokens, each optional (D59);
assistants grouped by provider, each in its colour, no logos (D60); a
handle chosen among those that exist (D61); the operator's screen an
overview of screens, loaded 50 at a time (D62); and effort within the
operator's range, chosen by the person (D63).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Tizian 「ティツィアーン」 <raisondetredev@pm.me>
This commit is contained in:
Tizian 「ティツィアーン」 2026-10-26 14:18:33 +01:00
commit 33c9a7df1c
Signed by: raisondetredev
GPG key ID: 07F6FCF405488B64

View file

@ -6,7 +6,9 @@
and when it is built (D13–D18), who signs up and who operates (D19–D22), waiting
accounts (D23–D26), what people are told and what never goes (D27–D30), how the first
step is built (D31–D34), the second (D35–D46) and the third (D47–D56), whose D55 and D56
the developer amended on 26 Oct to what was built.
the developer amended on 26 Oct to what was built; on 26 Oct, after the first use, the
operator's screen, budgets per person and the assistants' effort (D57–D63), for
v0.22.0.
- **Builds on:** ADR 0016 (the register), ADR 0019 (private studysets), ADR 0020
(SimpleLogin), ADR 0022 (the hand-off and the connector gone).
- **Amended by:** [ADR 0024](0024-languagetool-sidecar.md), D3 (26 Oct 2026): the field's
@ -364,6 +366,45 @@ On 26 Oct, how the third step is built (the assistant answering in Learn):
be reached from its app bar as the PDF reader's is; and the entry is named for what it
makes, as the other Add material entries are, not "With an assistant".
On 26 Oct, after the first use on learn.halkyon.eu (the developer: granting three people
all models of two providers would take dozens of sheets; a list of hundreds waiting would
push everything else down; and the effort of each model), how the operator's side and the
assistants' effort work:
- **D57 The months of the figures run oldest first** (recommended, over the newest first,
as built): Aug · Sep · Oct, the current month chosen on the right, as a timeline reads.
- **D58 A budget per person, and the assistants it covers** (recommended, over granting
several people and assistants at once with limits per assistant, and over a budget
with caps per assistant): a grant says only which assistant a person may use, and keeps
their agreement (D40); the limits move to the person, one daily and one monthly budget
for all their assistants together, as proxies in front of several providers keep them.
One sheet grants several people several assistants, each person getting the budget
set there. Amends D3, whose limits were each grant's.
- **D59 The budget counts money and tokens, each optional** (the developer's choice, over
money alone with unpriced assistants counting nothing, which was recommended, and over
refusing an assistant without prices): a daily and a monthly limit in the instance's
currency, and a daily and a monthly one in tokens; whichever runs out first stops the
person. An assistant without prices counts against the tokens alone.
- **D60 Assistants are grouped by their provider, each in its colour** (recommended, over
the provider's name alone and over its logo too): under the provider's name (Anthropic,
OpenAI, Google, Mistral, OpenRouter by the host; any other host by itself), with a
small accent in the provider's colour, wherever assistants are listed. No logos: they
are their companies' trademarks, under each one's terms.
- **D61 A handle is chosen among those that exist** (the developer's ask): typing one
suggests the accounts whose handle starts so, as the operator's search finds them, and
Grant and Appoint take only a handle suggested.
- **D62 The operator's screen is an overview of screens** (recommended, over its cards
showing five each with Show all, and over tabs): Waiting, Operators, Accounts and
Assistants, each a row with its count leading to a screen of its own, searched and
loaded 50 at a time as it scrolls, so hundreds waiting push nothing else down.
- **D63 Effort is the operator's range, chosen by the person within it** (recommended,
over a fixed level per assistant and over any level the model has): `assistants.env`
gives each assistant a default and a highest level (`low`, `medium`, `high`, `xhigh`,
`max`; Anthropic's names, mapped to each provider's own); the field offers a chip with
the levels allowed, remembered per assistant on the device, and the instance refuses
one above the highest. Effort spends more tokens at the same price per token, so the
budget (D58) still bounds what it costs.
## Proposal
1. **Who signs up, per instance:** `SIGN_UP`: `open` (as today), `approval`, or