Skip to content

v2.0.0 — the eight-tool surface

Choose a tag to compare

@aaronsb aaronsb released this 20 Aug 16:09
· 33 commits to main since this release
v2.0.0

The breaking release the last three ADRs built toward.

The surface: 17 tools → 8 (ADR-009)

Verb encodes effect, noun encodes domain, parameter encodes scope.

Tool Kind What it does
inbox noun What needs you: view='new' (since your last dismiss), 'unreads', 'mentions'
messages noun Conversation content: target= reads, +around= context, +since= window, query= full Slack search
estate noun Workspace shape + relationships: about/families/person/initiatives/convergence/people/channels
say verb Contribute content (a message, or an emoji reaction)
dismiss verb Mark inbox items handled — private watermark, invisible to Slack
mark-read verb Fire read receipts — the one visibly-public signal
auth verb Interactive token setup (localhost only)
download verb Download a shared file

Every response opens with its effective invocation; every capped list pages with the exact next call.

The estate (ADR-007, ADR-008)

  • Durable workspace ledger: users and channels accumulate forever, with dated tombstones instead of silent gaps
  • The attention ledger: activity observed from your own reading (author/conversation/day, never message text; 90-day window)
  • Relationship views: estate view='about' person='X' answers "tell me about X" whole — founder plane, activity plane, circle, and a ranked reading plan
  • The compiled executor backfills unobserved people with bounded searches and records the results, so the second ask is free

Breaking

All v1 tool names are gone — the mapping table above is complete. Message content never lands in local stores; reads remain stealth (only mark-read fires receipts).