Skip to content

TurnAware v0.1.0

Choose a tag to compare

@mentatzoe mentatzoe released this 16 Jun 02:31

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-2507 as 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-token for 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.md contract; scheduled live drift-eval.
  • Install: pip install/uvx from git. PyPI publishing is wired into the release workflow — add a PYPI_API_TOKEN secret to enable it.

See CHANGELOG.md and docs/integration.md for full details.