socialweb.computer

Request and provide VMs on an atproto compute market.

lexicons and xrpc

lexicon

computer.socialweb.cicd.process.kill

procedure HTTP POST /xrpc/computer.socialweb.cicd.process.kill

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

fieldtypedescription
id *string
The job id from start.
signalstring
The signal, TERM when absent.
default TERM knownValues ["TERM","KILL","INT"]

output

encoding application/json

field: none.

errors

errordescription
InvalidRequest405: 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.

used in

no page of these docs names it yet.

raw schema: lexicons/computer/socialweb/cicd/process/kill.json
{
  "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."
        }
      ]
    }
  }
}