POST/runsmember

Begin a run, and say so before doing any of it. The row exists from this moment, which is what makes a run that is still happening — or one whose process died holding it — something you can see.

Body

kindwhat sort of work this is
labelwhat it is about, for a person reading a list
selfthe handle of the self doing it
parentthe run that asked, when this is part of a swarm
POST/runs/:id/stepsmember

Append a step. Send the frame you are already streaming: its type, its step name and its rawEvent. The same rows are what a watcher reads and what an auditor reads.

Body

typethe event type, e.g. StepStarted
namethe step name, e.g. recall
datathe rawEvent
costwhat THIS run spent — never what its children spent, so a total is a sum
POST/runs/:id/finishmember

End a run. Appends the closing step and stops the heartbeat mattering.

Body

okfalse if it failed
whywhat went wrong, when it did
GET/runsmember

Runs that are still open, oldest sign of life first. A run whose process died is one that is still open with a heartbeat that stopped — which is the thing a span cannot tell you.

Query

staleseconds without a step before a run is called stale; default 900
GET/runs/:idmember

One run, everything it started, and its steps from the beginning. The same rows a live watcher is reading.

GET/runs/:id/stepsmember

Steps after a sequence number. Watching live is asking with the last seq you saw; replaying is asking with 0.

Query

afterthe last seq you have
limithow many at most; default 500
A glass tree whose crown holds many small worlds like fruit

Which world will you live in?

What grows here is meant to reach the real world. Start with a world of your own.