lexicons and xrpc
lexicon
computer.socialweb.cicd.process.exec
socialweb-guest-agent runs a command with /bin/sh -c as root in the guest and answers when it ends. Served only on the agent's shell unix socket (/run/socialweb-guest-agent/shell.sock, root 0600; reached over webrtc, iroh ssh or ssh streamlocal forwarding), with no auth beyond the socket; the same tool the agent's /mcp server offers as exec.
input
| field | type | description |
|---|---|---|
command * | string | The shell command. |
stdin | string | Text written to the command's stdin. |
timeoutMs | integer | How long the command may run, in milliseconds; at most 600000 (longer is cut to it), 60000 when absent. default 60000 minimum 1 maximum 600000 |
cwd | string | The working directory. |
output
| field | type | description |
|---|---|---|
exitCode * | integer | The command's exit status; -1 when it was killed at its timeout. |
stdout * | string | The command's stdout, at most 256 KiB. |
stderr * | string | The command's stderr, at most 256 KiB. |
truncated * | boolean | True when stdout or stderr was cut at 256 KiB. |
timedOut | boolean | True when the command was killed (its process group) at its timeout. |
errors
| error | description |
|---|---|
InvalidRequest | 405: not a POST; 413: the body is over 8 MiB; 400: the arguments are not valid, command is missing, or the command could not be started. |
used in
no page of these docs names it yet.
raw schema: lexicons/computer/socialweb/cicd/process/exec.json
{
"lexicon": 1,
"id": "computer.socialweb.cicd.process.exec",
"defs": {
"main": {
"type": "procedure",
"description": "socialweb-guest-agent runs a command with /bin/sh -c as root in the guest and answers when it ends. Served only on the agent's shell unix socket (/run/socialweb-guest-agent/shell.sock, root 0600; reached over webrtc, iroh ssh or ssh streamlocal forwarding), with no auth beyond the socket; the same tool the agent's /mcp server offers as exec.",
"input": {
"encoding": "application/json",
"schema": {
"type": "object",
"required": [
"command"
],
"properties": {
"command": {
"type": "string",
"description": "The shell command."
},
"stdin": {
"type": "string",
"description": "Text written to the command's stdin."
},
"timeoutMs": {
"type": "integer",
"minimum": 1,
"maximum": 600000,
"default": 60000,
"description": "How long the command may run, in milliseconds; at most 600000 (longer is cut to it), 60000 when absent."
},
"cwd": {
"type": "string",
"description": "The working directory."
}
}
}
},
"output": {
"encoding": "application/json",
"schema": {
"type": "object",
"required": [
"exitCode",
"stdout",
"stderr",
"truncated"
],
"properties": {
"exitCode": {
"type": "integer",
"description": "The command's exit status; -1 when it was killed at its timeout."
},
"stdout": {
"type": "string",
"description": "The command's stdout, at most 256 KiB."
},
"stderr": {
"type": "string",
"description": "The command's stderr, at most 256 KiB."
},
"truncated": {
"type": "boolean",
"description": "True when stdout or stderr was cut at 256 KiB."
},
"timedOut": {
"type": "boolean",
"description": "True when the command was killed (its process group) at its timeout."
}
}
}
},
"errors": [
{
"name": "InvalidRequest",
"description": "405: not a POST; 413: the body is over 8 MiB; 400: the arguments are not valid, command is missing, or the command could not be started."
}
]
}
}
}