halkyon/apps/learn/halkyon_learn_agent/pubspec.yaml
Tizian 「ティツィアーン」 54e212a51c
Some checks failed
CI / check (push) Failing after 1m56s
feat(learn): Learn's agent, an MCP server suggesting in shared studysets
Halkyon's ADR 0044, step 6c (D7, D49 to D52). apps/learn/halkyon_learn_agent
is one executable, `halkyon-agent --instance URL sign-in | sync | mcp`:

- sign-in keeps the token read from stdin, signs in with it, makes the
  agent's key pair on its first sign-in, keeps it before setting the
  public halves on the register (agents.setKeys), and syncs;
- it opens its data as the app's _openPersonData does, on
  halkyon_learn_core and halkyon_content: its own SQLite database, the
  sync's space router, its keys and those of the spaces shared with it,
  and the repositories of studysets, cards, notes, paths, files and
  feedback;
- mcp serves ten tools over stdio (dart_mcp): list, read and search the
  studysets shared with it, suggest a change or a new card or note,
  report, list a studyset's suggestions and reply. Each syncs first and
  a suggestion again at once; a refusal is the tool's error;
- its files live in $XDG_CONFIG_HOME/halkyon-agent/<host>, 0700 and
  0600, refused when others may read them (D50);
- tool/install.sh builds it with `dart build cli` (libsodium and SQLite
  bundled) and copies it to its user on the host, the build before kept
  (D52).

The synced gateways of learning paths and files, and the fakes of the
core's gateways, move into halkyon_learn_core (its testing.dart), which
the app's tests and the agent's share.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Tizian 「ティツィアーン」 <raisondetredev@pm.me>
2026-11-11 22:08:31 +01:00

39 lines
1.1 KiB
YAML

name: halkyon_learn_agent
description: >-
Halkyon Learn's agent (Halkyon's ADR 0044, D6, D7, D49 to D52): signs in to
an instance with its token, syncs the shared studysets it is a member of,
opens them with its own keys and suggests changes to them, for Claude Code
or another MCP client, over stdio.
version: 0.1.0
publish_to: none
resolution: workspace
environment:
sdk: ^3.13.0
executables:
halkyon-agent: halkyon_agent
dependencies:
args: ^2.7.0
# The Model Context Protocol, the Dart team's own (D51).
dart_mcp: ^0.5.2
halkyon_base_client:
path: ../../../packages/halkyon_base_client
halkyon_content:
path: ../../../packages/halkyon_content
halkyon_core:
path: ../../../packages/halkyon_core
halkyon_learn_client:
path: ../halkyon_learn_client
# Learn's content, as the app reads and writes it (D41, D49).
halkyon_learn_core:
path: ../halkyon_learn_core
path: ^1.9.1
serverpod_auth_core_client: 4.0.4
serverpod_offline_sync_client: 0.0.10
dev_dependencies:
# The tests' channel to the MCP server, in memory.
stream_channel: ^2.1.4
test: ^1.31.1