socialweb.computer

Request and provide VMs on an atproto compute market.

lexicons and xrpc

lexicon

computer.socialweb.cicd.process.exec

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

socialweb-guest-agent runs a command with /bin/sh -c as root in the guest and answers when it ends. Served only on the agent's shell unix socket (/run/socialweb-guest-agent/shell.sock, root 0600; reached over webrtc, iroh ssh or ssh streamlocal forwarding), with no auth beyond the socket; the same tool the agent's /mcp server offers as exec.

input

encoding application/json

fieldtypedescription
command *string
The shell command.
stdinstring
Text written to the command's stdin.
timeoutMsinteger
How long the command may run, in milliseconds; at most 600000 (longer is cut to it), 60000 when absent.
default 60000 minimum 1 maximum 600000
cwdstring
The working directory.

output

encoding application/json

fieldtypedescription
exitCode *integer
The command's exit status; -1 when it was killed at its timeout.
stdout *string
The command's stdout, at most 256 KiB.
stderr *string
The command's stderr, at most 256 KiB.
truncated *boolean
True when stdout or stderr was cut at 256 KiB.
timedOutboolean
True when the command was killed (its process group) at its timeout.

errors

errordescription
InvalidRequest405: not a POST; 413: the body is over 8 MiB; 400: the arguments are not valid, command is missing, or the command could not be started.

used in

no page of these docs names it yet.

raw schema: lexicons/computer/socialweb/cicd/process/exec.json
{
  "lexicon": 1,
  "id": "computer.socialweb.cicd.process.exec",
  "defs": {
    "main": {
      "type": "procedure",
      "description": "socialweb-guest-agent runs a command with /bin/sh -c as root in the guest and answers when it ends. Served only on the agent's shell unix socket (/run/socialweb-guest-agent/shell.sock, root 0600; reached over webrtc, iroh ssh or ssh streamlocal forwarding), with no auth beyond the socket; the same tool the agent's /mcp server offers as exec.",
      "input": {
        "encoding": "application/json",
        "schema": {
          "type": "object",
          "required": [
            "command"
          ],
          "properties": {
            "command": {
              "type": "string",
              "description": "The shell command."
            },
            "stdin": {
              "type": "string",
              "description": "Text written to the command's stdin."
            },
            "timeoutMs": {
              "type": "integer",
              "minimum": 1,
              "maximum": 600000,
              "default": 60000,
              "description": "How long the command may run, in milliseconds; at most 600000 (longer is cut to it), 60000 when absent."
            },
            "cwd": {
              "type": "string",
              "description": "The working directory."
            }
          }
        }
      },
      "output": {
        "encoding": "application/json",
        "schema": {
          "type": "object",
          "required": [
            "exitCode",
            "stdout",
            "stderr",
            "truncated"
          ],
          "properties": {
            "exitCode": {
              "type": "integer",
              "description": "The command's exit status; -1 when it was killed at its timeout."
            },
            "stdout": {
              "type": "string",
              "description": "The command's stdout, at most 256 KiB."
            },
            "stderr": {
              "type": "string",
              "description": "The command's stderr, at most 256 KiB."
            },
            "truncated": {
              "type": "boolean",
              "description": "True when stdout or stderr was cut at 256 KiB."
            },
            "timedOut": {
              "type": "boolean",
              "description": "True when the command was killed (its process group) at its timeout."
            }
          }
        }
      },
      "errors": [
        {
          "name": "InvalidRequest",
          "description": "405: not a POST; 413: the body is over 8 MiB; 400: the arguments are not valid, command is missing, or the command could not be started."
        }
      ]
    }
  }
}