0
0
{
"lexicon": 1,
"id": "computer.socialweb.cicd.process.kill",
"defs": {
"main": {
"type": "procedure",
"description": "socialweb-guest-agent sends a signal to a job's process group; a job that already exited is left alone. 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 kill.",
"input": {
"encoding": "application/json",
"schema": {
"type": "object",
"required": ["id"],
"properties": {
"id": { "type": "string", "description": "The job id from start." },
"signal": { "type": "string", "knownValues": ["TERM", "KILL", "INT"], "default": "TERM", "description": "The signal, TERM when absent." }
}
}
},
"output": {
"encoding": "application/json",
"schema": {
"type": "object",
"description": "An empty object.",
"properties": {}
}
},
"errors": [
{ "name": "InvalidRequest", "description": "405: not a POST; 413: the body is over 8 MiB; 400: the arguments are not valid, there is no job with that id, or the signal is not one the agent sends." }
]
}
}
}