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