diff --git a/README.md b/README.md index 62c0e00..850d74d 100644 --- a/README.md +++ b/README.md @@ -17,3 +17,41 @@ Talk to the bot in Slack, and your message goes to a [goose](https://github.com/ | [ARCHITECTURE.md](ARCHITECTURE.md) | How the system and the code are put together | | [AGENTS.md](AGENTS.md) | Rules for changing the code: tests, layout, style | + +# Technology Choices + +- [Goose Agent](https://github.com/block/goose) + - Builtin ACP Support: can spin up and manage multiple sessions via a websocket connections between the host and children + - Builtin support for most LLM provider out of the box +- Systemd NSpawn Containers with shared nix-store and bazel cache + - Lightweight virtulization + - Ability to set limits and requests for resources dynamically +- BTRFS Volumes + - Bultin backups via snapshots + - Ease of moving snapshots between host nodes + - Ease of extending storage capacity using RAID +- Custom Agent Scheduler + - Need extended support for ensuring agent sessions can survive a reboot + - Need extended support for managing user access controls to tools exposed by the meta-harness + - Need a simple clustering and scheduling solution that is purpose built for always-on agents +- Nix + - Easy reproducible rollouts + - Ensure the same version of packages like bazel is installed on the host and guest machines + - Allow the guest to pull any tools they want and reuse packages already installed on the global nix-store, which is effectively a massive cache + +# Toplevel Access Controls + +``` + User managers ──── edit all lists, DM switches, managers + │ + ▼ + Channel list (or the default list) DM switches + names who can scale · storage · on/off per action + move · keep · manage for your own DM container + │ │ + ▼ ▼ + Change a channel container Change your DM container + + Everyone: talk to the agent, view status, stop, cancel + Agent tool calls: checked as the person it's answering +```