lexicons and xrpc
lexicon
computer.socialweb.cicd.process.list
socialweb-guest-agent lists the jobs it holds, oldest first; an exited job stays listed until a new job needs its place among the 128. Served only on the agent's shell unix socket (/run/socialweb-guest-agent/shell.sock, root 0600), with no auth beyond the socket; the same tool the agent's /mcp server offers as list.
definitions: #job
input
field: none.
output
| field | type | description |
|---|---|---|
jobs * | array of #job |
errors
| error | description |
|---|---|
InvalidRequest | 405: not a POST; 413: the body is over 8 MiB. |
#job object
One job.
| field | type | description |
|---|---|---|
id * | string | The job id. |
command * | string | The job's shell command. |
startedAt * | string datetime | When the job started. |
done * | boolean | True once the job exited. |
exitCode | integer | The job's exit status, once it exited. |
used in
no page of these docs names it yet.
raw schema: lexicons/computer/socialweb/cicd/process/list.json
{
"lexicon": 1,
"id": "computer.socialweb.cicd.process.list",
"defs": {
"main": {
"type": "procedure",
"description": "socialweb-guest-agent lists the jobs it holds, oldest first; an exited job stays listed until a new job needs its place among the 128. Served only on the agent's shell unix socket (/run/socialweb-guest-agent/shell.sock, root 0600), with no auth beyond the socket; the same tool the agent's /mcp server offers as list.",
"input": {
"encoding": "application/json",
"schema": {
"type": "object",
"description": "No arguments; an empty body is taken as {}.",
"properties": {}
}
},
"output": {
"encoding": "application/json",
"schema": {
"type": "object",
"required": [
"jobs"
],
"properties": {
"jobs": {
"type": "array",
"items": {
"type": "ref",
"ref": "#job"
}
}
}
}
},
"errors": [
{
"name": "InvalidRequest",
"description": "405: not a POST; 413: the body is over 8 MiB."
}
]
},
"job": {
"type": "object",
"description": "One job.",
"required": [
"id",
"command",
"startedAt",
"done"
],
"properties": {
"id": {
"type": "string",
"description": "The job id."
},
"command": {
"type": "string",
"description": "The job's shell command."
},
"startedAt": {
"type": "string",
"format": "datetime",
"description": "When the job started."
},
"done": {
"type": "boolean",
"description": "True once the job exited."
},
"exitCode": {
"type": "integer",
"description": "The job's exit status, once it exited."
}
}
}
}
}