12. State and control reference
Three state tracks remain independent:
- View: Main, a focused Tan chat, or an overlay.
- Agent: running, idle, parked, aborted, or absent.
- Job: running, completed, failed, cancelled, or no longer retained.
| Actor / control | Target | Preconditions | Effect | Does not imply |
|---|---|---|---|---|
Operator: /tan <work> | New child conversation and initial job | Main; work; model; manager; persisted parent | Forks and dispatches background work | Isolation, automatic focus, successful task |
| Operator: Hub Enter | Selected exact agent ID | Usable live agent or successful revival | Focuses chat | New assignment or old job restart |
| Operator: focused Enter | Current Tan session | Nonempty prompt or actual attachment | Prompt if idle; steering if streaming | Immediate hard stop |
| Operator: Ctrl+Q / Ctrl+Enter | Current Tan session | Prompt/attachment | Follow-up if streaming; prompt if idle | A paused queue when idle |
| Operator: empty Enter | Current Tan turn | Streaming; queued message; no text/images | Requests turn abort; leaves queue handling to session | Job cancellation, kill, universal queue flush |
| Operator: ordinary focused Escape | Draft or view | No higher-priority handling | Clears text, otherwise returns Main | Cancelling the tan |
| Operator: focused double-left | View | Empty editor; recognized gesture | Returns directly Main | A one-level parent hop |
Main: /jobs | Main-owned jobs | Main composer | Status snapshot | Result consumption or cancellation |
Main: Hub jobs / wait | Visible owner-scoped jobs | Available manager; valid IDs when supplied | Observes; can consume settled delivery | All work succeeded, perpetual result retrieval |
Main: Hub send | Exact agent ID in to | Addressable recipient | Delivers; may wake/revive | Focused steering timing or acknowledged compliance |
Main: Hub cancel with job ID | Running owned job | Current verified job ID | Marks cancelled and signals abort | Durable Tan tombstone |
| Main: Hub cancel registration fallback | Exact direct-child agent ID | Applicable registration; ownership check | Aborts/disposes and removes registration | Same behavior as x |
| Operator: Hub x | Selected exact Tan ID | Matching row; successful release | Explicit kill with tombstone; transcript retained | Job necessarily says cancelled; rollback |
| Operator: Hub r | Selected parked agent | Successful reviver | Rebuilds live session | Reissues original task |
Main: read history://… | Discovered transcript | Reachable live history or retained file | Read-only transcript access | A live controllable agent |
| Main: Hub process control | Verified process name | Available process supervision | Inspects or controls that process | Tan conversation control |
Tangent work and live control · Source chapter: tan/12-state-and-control-reference. Original evidence remains scoped to its recorded snapshot.