Skip to content

v0.7.0 — wake hints, reservations, superseding, delegation scopes, coord-db

Choose a tag to compare

@datamoc datamoc released this 24 Sep 11:14
· 56 commits to master since this release

The rest of the v2 design notes, plus wake hints: the server cannot wake an agent, but it can tell it when to look again.

Changes

  • Wake hints: poll and context return wake: {next_at, in_seconds, reason} - a due routine or a task offered to you (now), a discussion deadline, a claim 10 min before it expires, and at the latest the poll that keeps the session alive (sessions die after 30 min). An agent that can schedule itself - a loop or scheduled wake-up, a cron, a wake-up when its quota returns - schedules its next look at next_at. The skill also says what to leave behind before stopping for lack of quota: a status post, a document, claims released or renewed for the wake-up.
  • Reservations: react P7 support-with-reservation "why" counts as support in every rule; coord discussion lists the reservations.
  • Objections need a reason: react P7 object without a comment is refused (comment_required).
  • Superseding: propose D3 "..." --supersedes P7 - the author (or the opener) replaces a proposal; the old one becomes superseded and can no longer be reacted to or decided; stances do not carry over.
  • Delegating part of a claim: coord delegate C12 --to codex-01 --scope src/parser/tests/ (inside C12; grant --scope too). Once accepted, the delegate claims that part with its own lease and fence - nothing outside it - and check follows the same rule. The owner keeps the rest.
  • coord-db for the administrator: export [--project P] [--out f.json], prune --older-than 30d [--apply] (dry run by default; keeps documents, memory, discussions, tasks, routines and unresolved questions/warnings), vacuum. Safe while the server runs.
  • Features published by the server: wake-hints, delegation-scopes, reservations, superseding.

Upgrading from 0.6.x

  • Stop coord-server, uv sync, start it again: two columns are added to existing databases on open; every project gets the upgrade notice.
  • Refresh plugin copies: muse plugins update coord; Codex: codex plugin remove coord@coord then codex plugin add coord@coord; Qwen: uninstall and install again; opencode/Kilo/Crush/Deep Code: rerun uv run tools/agent_plugins.py install ....

Install

uv tool install https://github.com/datamoc/coord/releases/download/v0.7.0/coord-0.7.0-py3-none-any.whl
npm install -g https://github.com/datamoc/coord/releases/download/v0.7.0/coord-client-0.7.0.tgz

Tested: test_coord.py 41/41 and the TS suite 20/20 (including an end-to-end CLI run of delegation, reservations and the wake hint) on Windows.