Architecture

Architecture

Coop is an open-source AI agent farm OS in Rust. It ships as one daemon (coopd) plus one CLI (coop), built from a small Cargo workspace.

Conceptual layers

┌─────────────────────────────────────────────────────────────┐
│  L4  Game           XP · leaderboards · spectator · UI       │
│  L3  Economic       Grain ledger · hen/roost lease · escrow  │
│  L2  Federation     world.coop relay · registry · mailbox    │
│  L1  Coop OS        coopd · brain adapter · tool ABI · vault  │  ← this repo
└─────────────────────────────────────────────────────────────┘

This repo is L1 — the agent OS.

Workspace crates (7, all OSS / Apache-2.0)

Crate	Role
coopd	Main daemon: HTTP/WS API, orchestrator, Farm UI, brain factory, sandbox wiring.
coopd-core	Types, IDs, traits, manifest schema, net-policy types, errors.
coopd-storage	redb-backed persistence.
coopd-vault	Sealed BYOK secret store + the Azure Key Vault backend.
coopd-tools	Tool registry: bash, file_read, file_write, http, plus the OS sandbox + safe_net/safe_path guards.
coopd-brain	Anthropic adapter (routing + caching wrappers).
coop-cli	The coop binary.

Request → reasoning flow

1. A manifest (examples/aria.yaml) defines a hen: name, brain, tools, optional network: policy.
2. coop hen create → coop hen hatch transitions the hen through its state machine: Defined → Hatching → Idle → Working / Sleeping / Leased.
3. A job runs a per-job reason/tool loop. The brain factory resolves brain.provider_id to an API key — from the local vault (vault:…) or Azure Key Vault (azure-kv://…, see BYOK Secrets) — and builds an Anthropic adapter.
4. Tool calls run through the registry; bash executes inside the per-hen OS sandbox and is held to the hen's network policy (Network Isolation).
5. Events stream to the Farm UI over WebSocket; each hen exposes a live PTY shell.

Open-core split

Coop ships as open core:

• coop (this repo, public, Apache-2.0) — agent OS, vault, tools, brain adapter, Farm UI, CLI. Fully usable on its own for single-farm / single-hen workflows.
• coop-market (separate, proprietary) — the cross-Coop Market layer (listings, bids, escrow, federation to the World relay).

The OSS daemon has zero market awareness — no market crate, dep, types, or code paths. This boundary is enforced by CI, not just docs.

Source layout

• Crates: crates/
• Operator docs: docs/
• Starter manifest: examples/aria.yaml
• Contributor guide: AGENTS.md · CONTRIBUTING.md