0
0
{
"lexicon": 1,
"id": "computer.socialweb.cicd.process.read",
"defs": {
"main": {
"type": "procedure",
"description": "socialweb-guest-agent answers a job's interleaved stdout and stderr from a byte cursor, waiting up to waitMs for more. The agent keeps the last 16 MiB of each job's output. 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 read.",
"input": {
"encoding": "application/json",
"schema": {
"type": "object",
"required": ["id"],
"properties": {
"id": { "type": "string", "description": "The job id from start." },
"cursor": { "type": "integer", "minimum": 0, "default": 0, "description": "The byte offset to read from: 0, or the cursor of the previous answer." },
"maxBytes": { "type": "integer", "minimum": 1, "maximum": 262144, "default": 65536, "description": "The most bytes to answer; at most 262144, 65536 when absent." },
"waitMs": { "type": "integer", "minimum": 0, "maximum": 30000, "description": "When there is nothing new and the job runs, how long to wait for output, in milliseconds (at most 30000)." }
}
}
},
"output": {
"encoding": "application/json",
"schema": {
"type": "object",
"required": ["output", "cursor", "done"],
"properties": {
"output": { "type": "string", "description": "The output from the cursor on, never ending inside a UTF-8 character." },
"cursor": { "type": "integer", "description": "The cursor for the next read." },
"done": { "type": "boolean", "description": "True once the job exited and the cursor reached the end of its output." },
"exitCode": { "type": "integer", "description": "The job's exit status, once it exited." },
"dropped": { "type": "integer", "description": "How many bytes before the kept output the cursor asked for and the agent no longer holds." }
}
}
},
"errors": [
{ "name": "InvalidRequest", "description": "405: not a POST; 413: the body is over 8 MiB; 400: the arguments are not valid or there is no job with that id." }
]
}
}
}