halkyon-days/halkyon
Watch
1
0
Fork
You've already forked halkyon
 0
Code Issues Pull requests Projects Releases 37 Packages Wiki Activity Actions

feat(app,learn,todo): the assistants in Settings and on the operator's screen

Browse source 
ADR 0021, step 2's app half. halkyon_app asks the module's assistant
endpoints (ServerpodAssistantGateway, ServerpodAssistantOperatorGateway)
and a person's own provider directly (halkyon_llm), behind
AssistantRepository: an AssistantChoice is a GrantedAssistant, asked
through the instance, which counts it, or a PersonalAssistant with the
person's own key, which the instance never sees. assistant_messages.dart
turns a conversation into the endpoint's models and back.

AssistantsCard, for an app's settings: what is granted and left of its
limits, agreed to once on a sheet saying what goes where, the person's
use by UTC month, the instance's privacy page, and their own assistants
where the operator allows own keys (kept ones stay listed, unasked,
where it doesn't). AssistantGrantsCard on InstanceOperatorScreen: grants
by handle with their limits in the pricing's unit, changed and taken
back after asking, everyone's use by month; a found account's menu
grants too. Nothing shows where nothing is offered or can be read.
package:halkyon_app/assistant_models.dart holds the models in pure Dart.

Learn keeps own assistants in the person's settings (ownAssistants,
schema 12, SettingsOwnAssistants); SettingsRepository.update refuses
(OwnAssistantRefused) to write a key where the settings would not be
sealed (SettingsGateway.seals). Learn depends on halkyon_llm directly.
Todo wires the gateways; a member offers no assistant. No feature asks
an assistant yet (step 3).

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-25 18:59:41 +01:00
commit 36899cdc3b
Signed by: raisondetredev
GPG key ID: 07F6FCF405488B64
1 changed files with 7505 additions and 46 deletions
Download patch file Download diff file Expand all files Collapse all files

17
packages/halkyon_app/README.md
View file

@ -67,6 +67,23 @@ Written as the apps are: Dart 3.13's primary constructors, Material from
refused; who operates, named by handle and taken back (never the last);
accounts found by the start of their handle, suspended or named. Only the
register's service answers: on a member, nothing shows.
- **Assistants** (`lib/src/assistant/`, Halkyon Learn's ADR 0021, step 2):
`AssistantRepository` on `ServerpodAssistantGateway` (the module's
`assistant` endpoint; refusals as `AssistantFailed`) asks an
`AssistantChoice` in halkyon_llm's terms: a `GrantedAssistant` through the
instance, which counts it, or a `PersonalAssistant` with the person's own
key directly (`LlmClient`), the instance seeing neither key nor question;
`assistant_messages.dart` turns a conversation into the endpoint's models
and back, part by part. `AssistantsCard` is an app's settings' card: what
is granted and left of its limits, agreed to once (the consent sheet),
the person's use by UTC month, the instance's privacy page, and the
person's own assistants where the operator allows them, kept where the
app says (`OwnAssistantStore`: Learn's sealed settings). For the operator,
`AssistantOperatorRepository` (grants by exact handle) and
`AssistantGrantsCard` on `InstanceOperatorScreen`: grants with their
limits, granted, changed and taken back, and everyone's use by month.
`package:halkyon_app/assistant_models.dart` holds the models alone, in
pure Dart, for an app's own models.
- **About** (`showAppAbout`): the app's name (its frame's), its version,
icon and legalese where it gives them, where the source of what the
instance runs is (`InstanceSourceCode`, from `AppDependencies.sourceCodeUrl`;