0
0
{
"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." }
]
}
}
}