Preview of pull request #34: Annotations, part A: shapes, labels, circles and ellipses, styling and a timeline, added through forms. Built from 54991f1 on 2026-10-13 10:37 UTC. All previews
Skip to content

Interaction models

North Star: predictable and forgiving: the same gesture does the same thing everywhere, and nothing is silent or irreversible (SUB-21, SUB-28).

Worked patterns applied the same way across hosts, tools and agents (DEV-08). Each model is one short page: the requirements it cites, a Mermaid sequence diagram, and a pointer to its reference implementation. Where an interaction is already a requirement, the model cites it rather than restating it.

Model Written in Status
Selection and tool offering Phase 1 Requirements gathered
Tool invocation and forms Phase 1 Requirements gathered
Unavailable capabilities Phase 1 Requirements gathered
Undo Phase 2 Written
Conflicts Phase 2 Written
Long-running operations Phase 2 Requirements gathered
Check overrides Phase 2 Requirements gathered
Time controller Phase 3 Written
Annotations Phase 3 Written (part A: forms)
Keyboard equivalents Phase 3 Requirements gathered

Analysts review the Phase 1 models before they are built.