dev.knotless.getRunOutput

What a running check's steps printed, as its runner sent it (dev.knotless.putRunOutput): the text after a cursor, the steps that ended and the one going, for a client that follows no server-sent events. The appview keeps the last megabyte of a run in memory while it runs, and a while after; the check's record keeps its log. With nothing new and the run going, it waits up to `wait` seconds for more. Answers as dev.knotless.getCheck does for the same viewer: anyone may read a public repository's, its members a private one's.

Details · query
Kindquery
Authorityknotless.dev
Commit rev3mzwyeqg7z2ac
Indexed
cid bafyreidtlofwmztv4u3vzrf7tvrprxssp5u3vzmukzh7ti3bwab2zfxv4i

Checks

Valid
  • unlimited-string defs.main.output.schema.properties.cursorNo maxLength, maxGraphemes or format limits this string.
  • unlimited-string defs.main.output.schema.properties.goingNo maxLength, maxGraphemes or format limits this string.
  • unlimited-string defs.main.output.schema.properties.textNo maxLength, maxGraphemes or format limits this string.
JSONDownload
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "What a running check's steps printed, as its runner sent it (dev.knotless.putRunOutput): the text after a cursor, the steps that ended and the one going, for a client that follows no server-sent events. The appview keeps the last megabyte of a run in memory while it runs, and a while after; the check's record keeps its log. With nothing new and the run going, it waits up to `wait` seconds for more. Answers as dev.knotless.getCheck does for the same viewer: anyone may read a public repository's, its members a private one's.",
      "errors": [
        {
          "description": "`uri` names no dev.knotless.check record.",
          "name": "InvalidRequest"
        },
        {
          "description": "No such repository, no such check of it by a runner it names, or as many runs followed as the appview keeps.",
          "name": "NotFound"
        }
      ],
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "cursor": {
              "description": "Where `text` ends, in this run: given back, it asks for what comes after.",
              "type": "string"
            },
            "ended": {
              "description": "Whether the run's steps are over: its record is filed with its result in a moment.",
              "type": "boolean"
            },
            "going": {
              "description": "The name of the step running now: none between steps.",
              "type": "string"
            },
            "steps": {
              "description": "The steps that ended so far, as the check's record will say.",
              "items": {
                "ref": "dev.knotless.check#step",
                "type": "ref"
              },
              "type": "array"
            },
            "text": {
              "description": "What the steps printed after `cursor`, each step's after a line `==> <name>`, in whole lines masked as the log is: nothing before the runner first sends.",
              "type": "string"
            }
          },
          "required": [
            "text",
            "cursor",
            "steps",
            "ended"
          ],
          "type": "object"
        }
      },
      "parameters": {
        "properties": {
          "cursor": {
            "description": "Where an earlier answer ended: only what was printed after it is given. With none, or one of another run of the check, as a rerun at the same commit is, all that is kept.",
            "maxLength": 128,
            "type": "string"
          },
          "repo": {
            "description": "The repository's dev.knotless.repo record, as dev.knotless.getCheck takes it.",
            "format": "at-uri",
            "type": "string"
          },
          "uri": {
            "description": "The dev.knotless.check record, by a runner the repository names.",
            "format": "at-uri",
            "type": "string"
          },
          "wait": {
            "description": "Seconds to wait for more when nothing was printed after `cursor` and the run has not ended.",
            "maximum": 25,
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "repo",
          "uri"
        ],
        "type": "params"
      },
      "type": "query"
    }
  },
  "description": "What a check's run has printed so far, as its runner sends it to the appview.",
  "id": "dev.knotless.getRunOutput",
  "lexicon": 1
}