lexicons and xrpc
lexicon
computer.socialweb.cicd.process.start
socialweb-guest-agent starts a background job, a command with /bin/sh -c as root in the guest, and answers its id at once. The job outlives the connection; follow it with read, write, kill and list. 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 start.
input
| field | type | description |
|---|---|---|
command * | string | The shell command. |
cwd | string | The working directory. |
stdin | string | Text written to the job's stdin after it starts; the stdin stays open for write. |
output
| field | type | description |
|---|---|---|
id * | string | The job id. |
errors
| error | description |
|---|---|
InvalidRequest | 405: not a POST; 413: the body is over 8 MiB; 400: the arguments are not valid, command is missing, the job could not be started, or 128 jobs are running and none has exited to make room. |
used in
no page of these docs names it yet.
raw schema: lexicons/computer/socialweb/cicd/process/start.json
{
"lexicon": 1,
"id": "computer.socialweb.cicd.process.start",
"defs": {
"main": {
"type": "procedure",
"description": "socialweb-guest-agent starts a background job, a command with /bin/sh -c as root in the guest, and answers its id at once. The job outlives the connection; follow it with read, write, kill and list. 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 start.",
"input": {
"encoding": "application/json",
"schema": {
"type": "object",
"required": [
"command"
],
"properties": {
"command": {
"type": "string",
"description": "The shell command."
},
"cwd": {
"type": "string",
"description": "The working directory."
},
"stdin": {
"type": "string",
"description": "Text written to the job's stdin after it starts; the stdin stays open for write."
}
}
}
},
"output": {
"encoding": "application/json",
"schema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The job id."
}
}
}
},
"errors": [
{
"name": "InvalidRequest",
"description": "405: not a POST; 413: the body is over 8 MiB; 400: the arguments are not valid, command is missing, the job could not be started, or 128 jobs are running and none has exited to make room."
}
]
}
}
}