socialweb.computer

Request and provide VMs on an atproto compute market.

lexicons and xrpc

lexicon

computer.socialweb.cicd.process.start

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

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

fieldtypedescription
command *string
The shell command.
cwdstring
The working directory.
stdinstring
Text written to the job's stdin after it starts; the stdin stays open for write.

output

encoding application/json

fieldtypedescription
id *string
The job id.

errors

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

used in

no page of these docs names it yet.

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