Preview of pull request #30: Tidy-ups: History names every step, time fields start at current time, faster reopening. Built from 76af5b0 on 2026-10-12 06:19 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
Keyboard equivalents Phase 3 Requirements gathered

Analysts review the Phase 1 models before they are built.