Short prompts don't engage DeepSeek prefix caching. Inflated the immutable prefix past the cacheable threshold (~3.7k tokens, byte-stable, COLIBRI_PROBE_PREFIX_REPEAT) + a 2s commit delay (COLIBRI_PROBE_DELAY_MS). Live run on domedog: second call served 3584/3661 prompt tokens from cache (~98% hit), cache_hit_observed=true, model deepseek-v4-flash. Records the key-free result as manifests/2026-05-26-domedog-deepseek-cache-result.json (proof gate #2 evidence) and adds it as a colibri-contracts golden test (6 pass). No key in repo; .env stays gitignored. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> |
||
|---|---|---|
| crates | ||
| docs | ||
| manifests | ||
| src | ||
| .env.example | ||
| .gitignore | ||
| Cargo.lock | ||
| Cargo.toml | ||
| README.md | ||
| rust-toolchain.toml | ||
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:
- Rust +
rustls+tokiobuild cross-platform (Linux first, FreeBSD next). - A raw DeepSeek HTTPS call works.
- DeepSeek prefix caching is real on our infra: send a byte-stable prefix
twice and observe
prompt_cache_hit_tokens > 0on 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.