colibri/README.md
Sam & Claude 247ffc76a1 Add FreeBSD runtime inventory manifest
Expose COLIBRI_AGENT for lane attribution and add a runtime inventory binary matching the Clawdie runtime schema.

---

Build: pass — cargo build --release

Tests: pass — cargo test (0 tests)
2026-05-26 10:45:18 +02:00

1.7 KiB

Colibri

The Clawdie control plane core — a small, cross-platform (FreeBSD + Linux) Rust daemon. It unifies a coordination model (agents-as-teammates, task board, team skills) with a cache-first cost discipline (byte-stable prompt prefixes, cache-hit metering), sitting on top of the existing Pi engine, watchdog, hostd and Postgres.

Design + implementation path: see doc/COLIBRI-CONTROLPLANE-PLAN.md in clawdie-ai.

Phase 1 — colibri-probe

A falsifiable first build that proves three things at once:

  1. Rust + rustls + tokio build cross-platform (Linux first, FreeBSD next).
  2. A raw DeepSeek HTTPS call works.
  3. DeepSeek prefix caching is real on our infra: send a byte-stable prefix twice and observe prompt_cache_hit_tokens > 0 on the second request.

It prints a clawdie.provider-smoke.result.v1 manifest on stdout.

Build (no key needed)

cargo build --release

Run

# Build-only / skipped mode (no key): verifies the binary runs.
./target/release/colibri-probe

# Live cache probe:
DEEPSEEK_API_KEY=sk-... ./target/release/colibri-probe

Env overrides: DEEPSEEK_MODEL (default deepseek-chat, the DeepSeek API model string — distinct from our internal deepseek-v4-flash alias), DEEPSEEK_ENDPOINT, COLIBRI_HOST, COLIBRI_AGENT.

Runtime inventory

The FreeBSD/Linux build lane can emit the existing Clawdie runtime contract:

cargo run --release --bin colibri-runtime-inventory

It prints a clawdie.runtime-version-inventory.v1 manifest on stdout.

FreeBSD note

Target x86_64-unknown-freebsd (Rust Tier-2). Install via pkg install rust or rustup; the rust-toolchain.toml pins the channel for cross-host reproducibility. TLS is rustls to avoid openssl-sys linking on FreeBSD.