~ knotless Search/
↑↓ move↵ open⇧↵ all results

socialweb.computer/socialweb-computer-kcp

socialweb.computer: a compute market on atproto (kcp)

1 collaborator
0
0
40 lines · 2.2 KB Raw History
{
  "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." }
      ]
    }
  }
}