TurnAware v0.1.0
First release of TurnAware — a portable, stdlib-only pre-reply admission gate for turn-aware agents. It decides, before an agent replies on a shared surface, whether to PASS / ACK / ASK / SPEAK.
Highlights
- Provider-backed classifier (default
google/gemini-3.1-flash-lite;qwen/qwen3-235b-a22b-2507as an open-weight alternative), security-hardened config, bounded retry/backoff on transient provider errors. - Deterministic fast-path cuts per-turn cost/latency — resolves
@mention-elsewhere and self-echo to PASS with no LLM call; everything ambiguous escalates to the model. - Transport-neutral channel adapter (
verdict+silent); cc-connect is an opt-in preset, not a dependency. Generic--silent-tokenfor any transport. - Opt-in PASS-corroboration mode for surfaces that must challenge unverified "done" claims.
- CI matrix (3.11/3.12/3.13) + clean-install packaging;
docs/STABILITY.mdcontract; scheduled live drift-eval. - Install:
pip install/uvxfrom git. PyPI publishing is wired into the release workflow — add aPYPI_API_TOKENsecret to enable it.
See CHANGELOG.md and docs/integration.md for full details.