dev.knotless.putRunOutput

Sends the appview what a check's steps printed since the runner last sent, for the pages following the check while it runs: the dev.knotless.check record says nothing of a run until it ends. Only whole lines are sent, with the run's secrets masked as its log's are. The appview keeps the tail of each run in memory, never for good: the record's log is what is kept. Only the runner that files the check may send its output, and an appview holding as many runs as it keeps, or as many of the caller's, refuses more until some end. Requires a service token from the caller's PDS, audience the appview's DID, for this method.

Details · procedure
Kindprocedure
Authorityknotless.dev
Indexed

Procedure

procedure · POST

Input

application/json

check

requiredstring · at-uri

The dev.knotless.check record the run files, in the caller's repo.

ended

boolean

Set on the last send: the run's steps are over, and its record is about to be filed.

going

string

The name of the step running now, sent with `steps`: none between steps.

  • maxLength: 512

offset

requiredinteger

Where `text` starts in all the run has sent, in bytes: text sent again is passed over, and a gap, from output the runner let go, starts what is kept anew.

  • minimum: 0

startedAt

string · datetime

When the run started, as its check record says. A run of the same check that started at another time, as a rerun at the same commit is, starts what is kept anew.

steps

array

The steps that ended so far, as the check's record will say.

  • maxLength: 256
itemsref

text

string

What the steps printed since the last send, as UTF-8.

  • maxLength: 20000

Output

application/json

watched

requiredboolean

Whether a page follows the run now: a runner may send less often when none does.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.