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

socialweb.computer/socialweb-computer-kcp

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

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