Перейти к содержимому

Справочник MCP Tools

Moira предоставляет возможности выполнения процессов через MCP-инструменты. Каталог ниже — авторитетный справочник имён инструментов, операций, входных схем и корректных примеров входа. Сборка документации напрямую читает тот же чистый типизированный контракт, который используется при MCP-регистрации и в runtime-справке.

Описания инструментов и поддерживаемые варианты для агентов и моделей являются статической частью этого каталога и не переопределяются через настройки базы данных. Системные runtime-инструкции передаются отдельно при MCP-инициализации и никогда не изменяют описание инструмента.

Сервер проверяет принятую редакцию контракта инструментов аутентифицированного MCP-подключения. При HTTP 426 upgrade_required переподключите или переинициализируйте это подключение для обновления инструментов. Успешная MCP-инициализация принимает текущий каталог для этих credentials; чтение справки или вызов старого инструмента не обходят проверку.

Инструменты MCP

codespace

Показывает рабочие среды выбранного провайдера; диагностика и история явно открывают сохранённые недоступные или удалённые идентичности. Другие провайдеры и оплата не задерживают ответ. Находит репозитории и зарегистрированные контроллеры выбранного провайдера для новой работы. Наблюдает среду и возвращает новую ссылку для следующего явного действия. Создаёт одну среду по возвращённой цели и ветке. Запускает, останавливает или продолжает подготовку Local или GitHub по сохранённой ссылке. Подготавливает наблюдённую GitHub-среду на явно выбранном зарегистрированном контроллере. Безвозвратно удаляет именно подтверждённую наблюдённую среду. Объясняет текущую недостающую предпосылку без создания среды. Явно подготавливает собственную внешнюю GitHub-среду выбранным контроллером. Запрашивает одобренный владельцем допуск проверенного GitHub-репозитория. Создаёт приватный репозиторий в выбранной установке с согласия владельца. Явно продолжает сохранённую подготовку приватного репозитория только по исходной ссылке его создания; не повторяет команды и не создаёт другой репозиторий. Читает исходную операцию или процесс без повторной отправки эффекта. Находит исходные записи владельца; неоднозначные результаты не выбираются и не повторяются автоматически.

Операции: list, targets, observe, create, lifecycle, adopt, delete, setup_help, adopt_external, repository_admit, repository_create, resume, collect, find.

Схема входа

{
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "provider": {
          "type": "string",
          "enum": [
            "local-sandboxes",
            "github-codespaces"
          ]
        },
        "view": {
          "type": "string",
          "enum": [
            "actionable",
            "diagnostics",
            "history"
          ]
        },
        "action": {
          "type": "string",
          "const": "list"
        }
      },
      "required": [
        "provider",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "provider": {
          "type": "string",
          "enum": [
            "local-sandboxes",
            "github-codespaces"
          ]
        },
        "action": {
          "type": "string",
          "const": "targets"
        }
      },
      "required": [
        "provider",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "workspace": {
          "type": "string",
          "description": "Copy the returned workspace or workspace-identity reference; never manufacture or refresh it"
        },
        "action": {
          "type": "string",
          "const": "observe"
        }
      },
      "required": [
        "workspace",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "target": {
          "type": "string",
          "description": "Copy the returned target reference; never manufacture or refresh it"
        },
        "branch": {
          "type": "string",
          "minLength": 1,
          "maxLength": 255
        },
        "devcontainer_path": {
          "type": "string",
          "minLength": 1,
          "maxLength": 4096,
          "description": "Path relative to the selected workspace repository root, for example moira-ws/task/file.md. File tools reject absolute paths, parent traversal and symlinks; use '.' for directory operations at the root"
        },
        "action": {
          "type": "string",
          "const": "create"
        }
      },
      "required": [
        "target",
        "branch",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "lifecycle"
        },
        "workspace": {
          "type": "string",
          "description": "Copy the returned workspace reference; never manufacture or refresh it"
        },
        "operation": {
          "type": "string",
          "enum": [
            "start",
            "stop",
            "resume_setup"
          ]
        }
      },
      "required": [
        "action",
        "workspace",
        "operation"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "workspace": {
          "type": "string",
          "description": "Copy the returned workspace reference; never manufacture or refresh it"
        },
        "controller": {
          "type": "string",
          "description": "Copy the returned controller reference; never manufacture or refresh it"
        },
        "action": {
          "type": "string",
          "const": "adopt"
        }
      },
      "required": [
        "workspace",
        "controller",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "workspace": {
          "type": "string",
          "description": "Copy the returned workspace reference; never manufacture or refresh it"
        },
        "confirm_delete": {
          "type": "boolean",
          "const": true
        },
        "action": {
          "type": "string",
          "const": "delete"
        }
      },
      "required": [
        "workspace",
        "confirm_delete",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "target": {
          "type": "string",
          "description": "Copy the returned target reference; never manufacture or refresh it"
        },
        "action": {
          "type": "string",
          "const": "setup_help"
        }
      },
      "required": [
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "controller": {
          "type": "string",
          "description": "Copy the returned controller reference; never manufacture or refresh it"
        },
        "name": {
          "type": "string",
          "pattern": "^[A-Za-z0-9][A-Za-z0-9-]*$"
        },
        "action": {
          "type": "string",
          "const": "adopt_external"
        }
      },
      "required": [
        "controller",
        "name",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "controller": {
          "type": "string",
          "description": "Copy the returned controller reference; never manufacture or refresh it"
        },
        "repository": {
          "type": "string",
          "pattern": "^[1-9][0-9]*$"
        },
        "action": {
          "type": "string",
          "const": "repository_admit"
        }
      },
      "required": [
        "controller",
        "repository",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "controller": {
          "type": "string",
          "description": "Copy the returned controller reference; never manufacture or refresh it"
        },
        "installation": {
          "type": "string",
          "description": "Copy the returned installation reference; never manufacture or refresh it"
        },
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 100,
          "pattern": "^[A-Za-z0-9_.-]+$"
        },
        "action": {
          "type": "string",
          "const": "repository_create"
        }
      },
      "required": [
        "controller",
        "installation",
        "name",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "reference": {
          "type": "string",
          "description": "Copy the returned operation reference; never manufacture or refresh it"
        },
        "action": {
          "type": "string",
          "const": "resume"
        }
      },
      "required": [
        "reference",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "reference": {
          "type": "string",
          "description": "Copy the returned operation or process reference; never manufacture or refresh it"
        },
        "action": {
          "type": "string",
          "const": "collect"
        }
      },
      "required": [
        "reference",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "owner": {
          "type": "string",
          "description": "Copy the returned workspace or controller reference; never manufacture or refresh it"
        },
        "kind": {
          "type": "string",
          "enum": [
            "command",
            "file-change",
            "lifecycle",
            "repository",
            "pull-request",
            "delivery",
            "session",
            "unknown"
          ]
        },
        "query": {
          "type": "string"
        },
        "cursor": {
          "type": "string",
          "minLength": 1
        },
        "action": {
          "type": "string",
          "const": "find"
        }
      },
      "required": [
        "owner",
        "action"
      ],
      "additionalProperties": false
    }
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object"
}

Результат: Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие.

{
  "action": "list",
  "provider": "local-sandboxes"
}
{
  "action": "targets",
  "provider": "local-sandboxes"
}
{
  "action": "observe",
  "workspace": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9"
}
{
  "action": "create",
  "target": "moira-target:v1:eyJjb250cm9sbGVyIjp7ImNvbm5lY3Rpb25JZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSIsImRldmljZUlkIjoiMDAwMDAwMDAtMDAwMC00MDAwLTgwMDAtMDAwMDAwMDAwMDAxIn0sInByb3ZpZGVyIjoiZ2l0aHViLWNvZGVzcGFjZXMiLCJyZXBvc2l0b3J5SWQiOiI0MiJ9",
  "branch": "main"
}
{
  "action": "lifecycle",
  "workspace": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "operation": "start"
}
{
  "action": "adopt",
  "workspace": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "controller": "moira-controller:v1:eyJjb25uZWN0aW9uSWQiOiIwMDAwMDAwMC0wMDAwLTQwMDAtODAwMC0wMDAwMDAwMDAwMDEiLCJkZXZpY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9"
}
{
  "action": "delete",
  "workspace": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "confirm_delete": true
}
{
  "action": "setup_help"
}
{
  "action": "adopt_external",
  "controller": "moira-controller:v1:eyJjb25uZWN0aW9uSWQiOiIwMDAwMDAwMC0wMDAwLTQwMDAtODAwMC0wMDAwMDAwMDAwMDEiLCJkZXZpY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "name": "existing-environment"
}
{
  "action": "repository_admit",
  "controller": "moira-controller:v1:eyJjb25uZWN0aW9uSWQiOiIwMDAwMDAwMC0wMDAwLTQwMDAtODAwMC0wMDAwMDAwMDAwMDEiLCJkZXZpY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "repository": "42"
}
{
  "action": "repository_create",
  "controller": "moira-controller:v1:eyJjb25uZWN0aW9uSWQiOiIwMDAwMDAwMC0wMDAwLTQwMDAtODAwMC0wMDAwMDAwMDAwMDEiLCJkZXZpY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "installation": "moira-installation:v1:eyJjb250cm9sbGVyIjp7ImNvbm5lY3Rpb25JZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSIsImRldmljZUlkIjoiMDAwMDAwMDAtMDAwMC00MDAwLTgwMDAtMDAwMDAwMDAwMDAxIn0sImluc3RhbGxhdGlvbklkIjoiNDIifQ",
  "name": "new-project"
}
{
  "action": "resume",
  "reference": "moira-operation:v1:eyJqb3VybmFsIjoicmVwb3NpdG9yeS1jcmVhdGUiLCJraW5kIjoicmVwb3NpdG9yeSIsIm93bmVyIjp7ImNvbm5lY3Rpb25JZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSIsImRldmljZUlkIjoiMDAwMDAwMDAtMDAwMC00MDAwLTgwMDAtMDAwMDAwMDAwMDAxIiwia2luZCI6ImNvbnRyb2xsZXIifSwicmVxdWVzdElkIjoid3MxLTAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9"
}
{
  "action": "collect",
  "reference": "moira-process:v1:eyJvd25lciI6eyJraW5kIjoiZ2l0aHViIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9LCJyZXF1ZXN0SWQiOiJ3czEtMDAwMDAwMDAtMDAwMC00MDAwLTgwMDAtMDAwMDAwMDAwMDAxIn0"
}
{
  "action": "find",
  "owner": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "kind": "command"
}

codespace_terminal

Выполняет argv или скрипт; возвращает ссылки исходной операции/процесса без общего срока исполнения. Выполняет команду с обязательным нативным stdin без смешивания с текстовым вводом. Читает исходный вывод процесса с продолжением по полным символам. Отменяет только процесс, указанный возвращённой ссылкой. Закрывает именованную сессию среды. Читает исходную операцию или процесс без повторной отправки эффекта. Находит исходные записи владельца; неоднозначные результаты не выбираются и не повторяются автоматически.

Операции: run, run_native, output, stop, close, collect, find.

Схема входа

{
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "workspace": {
          "type": "string",
          "description": "Copy the returned workspace reference; never manufacture or refresh it"
        },
        "command": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "argv": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "minItems": 1
                }
              },
              "required": [
                "argv"
              ],
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "script": {
                  "type": "string",
                  "minLength": 1
                }
              },
              "required": [
                "script"
              ],
              "additionalProperties": false
            }
          ]
        },
        "session": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]*$"
            },
            "mode": {
              "type": "string",
              "enum": [
                "open",
                "continue"
              ]
            }
          },
          "required": [
            "name",
            "mode"
          ],
          "additionalProperties": false
        },
        "cwd": {
          "type": "string",
          "minLength": 1,
          "maxLength": 4096,
          "description": "Working directory inside the selected workspace repository; defaults to '.'. Prefer a repository-relative directory such as moira-ws/task. A directory created elsewhere in the VM cannot be used as cwd or accessed through workspace file tools"
        },
        "env": {
          "type": "object",
          "additionalProperties": {
            "type": "string"
          },
          "propertyNames": {
            "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
          }
        },
        "background": {
          "type": "boolean"
        },
        "timeout_seconds": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "max_stdout_bytes": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "max_stderr_bytes": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "stdin_text": {
          "type": "string"
        },
        "action": {
          "type": "string",
          "const": "run"
        }
      },
      "required": [
        "workspace",
        "command",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "workspace": {
          "type": "string",
          "description": "Copy the returned workspace reference; never manufacture or refresh it"
        },
        "command": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "argv": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "minItems": 1
                }
              },
              "required": [
                "argv"
              ],
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "script": {
                  "type": "string",
                  "minLength": 1
                }
              },
              "required": [
                "script"
              ],
              "additionalProperties": false
            }
          ]
        },
        "session": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]*$"
            },
            "mode": {
              "type": "string",
              "enum": [
                "open",
                "continue"
              ]
            }
          },
          "required": [
            "name",
            "mode"
          ],
          "additionalProperties": false
        },
        "cwd": {
          "type": "string",
          "minLength": 1,
          "maxLength": 4096,
          "description": "Working directory inside the selected workspace repository; defaults to '.'. Prefer a repository-relative directory such as moira-ws/task. A directory created elsewhere in the VM cannot be used as cwd or accessed through workspace file tools"
        },
        "env": {
          "type": "object",
          "additionalProperties": {
            "type": "string"
          },
          "propertyNames": {
            "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
          }
        },
        "background": {
          "type": "boolean"
        },
        "timeout_seconds": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "max_stdout_bytes": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "max_stderr_bytes": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "stdin_file": {},
        "action": {
          "type": "string",
          "const": "run_native"
        }
      },
      "required": [
        "workspace",
        "command",
        "stdin_file",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "process": {
          "type": "string",
          "description": "Copy the returned process reference; never manufacture or refresh it"
        },
        "stream": {
          "type": "string",
          "enum": [
            "stdout",
            "stderr"
          ]
        },
        "cursor": {
          "type": "string",
          "description": "Copy the returned output-cursor reference; never manufacture or refresh it"
        },
        "max_bytes": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "action": {
          "type": "string",
          "const": "output"
        }
      },
      "required": [
        "process",
        "stream",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "process": {
          "type": "string",
          "description": "Copy the returned process reference; never manufacture or refresh it"
        },
        "action": {
          "type": "string",
          "const": "stop"
        }
      },
      "required": [
        "process",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "workspace": {
          "type": "string",
          "description": "Copy the returned workspace reference; never manufacture or refresh it"
        },
        "name": {
          "type": "string",
          "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]*$"
        },
        "action": {
          "type": "string",
          "const": "close"
        }
      },
      "required": [
        "workspace",
        "name",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "reference": {
          "type": "string",
          "description": "Copy the returned operation or process reference; never manufacture or refresh it"
        },
        "action": {
          "type": "string",
          "const": "collect"
        }
      },
      "required": [
        "reference",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "owner": {
          "type": "string",
          "description": "Copy the returned workspace or controller reference; never manufacture or refresh it"
        },
        "kind": {
          "type": "string",
          "enum": [
            "command",
            "file-change",
            "lifecycle",
            "repository",
            "pull-request",
            "delivery",
            "session",
            "unknown"
          ]
        },
        "query": {
          "type": "string"
        },
        "cursor": {
          "type": "string",
          "minLength": 1
        },
        "action": {
          "type": "string",
          "const": "find"
        }
      },
      "required": [
        "owner",
        "action"
      ],
      "additionalProperties": false
    }
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "stdin_file": {
      "type": "object",
      "properties": {
        "file_id": {
          "type": "string",
          "maxLength": 512,
          "pattern": "^(?:sediment:\\/\\/)?file_[A-Za-z0-9]+$"
        },
        "download_url": {
          "type": "string",
          "format": "uri"
        },
        "file_name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 255
        },
        "mime_type": {
          "type": "string",
          "maxLength": 127,
          "pattern": "^[a-z0-9][a-z0-9!#$&^_.+-]*\\/[a-z0-9][a-z0-9!#$&^_.+-]*$"
        },
        "size_bytes": {
          "type": "integer",
          "minimum": 0
        }
      },
      "required": [
        "file_id",
        "download_url"
      ],
      "additionalProperties": false,
      "description": "Native ChatGPT reference acquired by the workspace owner; pass it without base64. Source refusal before admission is confirmed, not a lost accepted mutation"
    }
  },
  "type": "object"
}

Результат: Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие.

{
  "action": "run",
  "workspace": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "command": {
    "argv": [
      "git",
      "status",
      "--short"
    ]
  }
}
{
  "action": "run_native",
  "workspace": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "command": {
    "argv": [
      "cat"
    ]
  },
  "stdin_file": {
    "file_id": "file_Example",
    "download_url": "https://files.oaiusercontent.com/example"
  }
}
{
  "action": "output",
  "process": "moira-process:v1:eyJvd25lciI6eyJraW5kIjoiZ2l0aHViIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9LCJyZXF1ZXN0SWQiOiJ3czEtMDAwMDAwMDAtMDAwMC00MDAwLTgwMDAtMDAwMDAwMDAwMDAxIn0",
  "stream": "stdout"
}
{
  "action": "stop",
  "process": "moira-process:v1:eyJvd25lciI6eyJraW5kIjoiZ2l0aHViIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9LCJyZXF1ZXN0SWQiOiJ3czEtMDAwMDAwMDAtMDAwMC00MDAwLTgwMDAtMDAwMDAwMDAwMDAxIn0"
}
{
  "action": "close",
  "workspace": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "name": "shell"
}
{
  "action": "collect",
  "reference": "moira-process:v1:eyJvd25lciI6eyJraW5kIjoiZ2l0aHViIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9LCJyZXF1ZXN0SWQiOiJ3czEtMDAwMDAwMDAtMDAwMC00MDAwLTgwMDAtMDAwMDAwMDAwMDAxIn0"
}
{
  "action": "find",
  "owner": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "kind": "command"
}

codespace_read

Читает полные UTF-8 символы со ссылкой целого файла и продолжением. Читает метаданные и возвращает проверенную ссылку обычного файла. Возвращает проверенный нативный предпросмотр изображения.

Операции: read, stat, preview.

Схема входа

{
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "workspace": {
          "type": "string",
          "description": "Copy the returned workspace reference; never manufacture or refresh it"
        },
        "path": {
          "type": "string",
          "minLength": 1,
          "maxLength": 4096,
          "description": "Path relative to the selected workspace repository root, for example moira-ws/task/file.md. File tools reject absolute paths, parent traversal and symlinks; use '.' for directory operations at the root"
        },
        "window": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "start_line": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                "max_lines": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                }
              },
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "cursor": {
                  "type": "string",
                  "description": "Copy the returned file-cursor reference; never manufacture or refresh it"
                }
              },
              "required": [
                "cursor"
              ],
              "additionalProperties": false
            }
          ]
        },
        "max_bytes": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "action": {
          "type": "string",
          "const": "read"
        }
      },
      "required": [
        "workspace",
        "path",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "workspace": {
          "type": "string",
          "description": "Copy the returned workspace reference; never manufacture or refresh it"
        },
        "path": {
          "type": "string",
          "minLength": 1,
          "maxLength": 4096,
          "description": "Path relative to the selected workspace repository root, for example moira-ws/task/file.md. File tools reject absolute paths, parent traversal and symlinks; use '.' for directory operations at the root"
        },
        "action": {
          "type": "string",
          "const": "stat"
        }
      },
      "required": [
        "workspace",
        "path",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "workspace": {
          "type": "string",
          "description": "Copy the returned workspace reference; never manufacture or refresh it"
        },
        "path": {
          "type": "string",
          "minLength": 1,
          "maxLength": 4096,
          "description": "Path relative to the selected workspace repository root, for example moira-ws/task/file.md. File tools reject absolute paths, parent traversal and symlinks; use '.' for directory operations at the root"
        },
        "max_bytes": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "action": {
          "type": "string",
          "const": "preview"
        }
      },
      "required": [
        "workspace",
        "path",
        "action"
      ],
      "additionalProperties": false
    }
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object"
}

Результат: Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие.

{
  "action": "read",
  "workspace": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "path": "README.md"
}
{
  "action": "stat",
  "workspace": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "path": "README.md"
}
{
  "action": "preview",
  "workspace": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "path": "screen.png"
}

codespace_edit

Создаёт текстовый файл только при его отсутствии. Заменяет текст только по полному ожидаемому тексту или наблюдённой ссылке файла. Атомарно заменяет старый текст по одному исходному состоянию выбранных файлов. Читает исходную операцию или процесс без повторной отправки эффекта. Находит исходные записи владельца; неоднозначные результаты не выбираются и не повторяются автоматически.

Операции: create, replace, patch, collect, find.

Схема входа

{
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "workspace": {
          "type": "string",
          "description": "Copy the returned workspace reference; never manufacture or refresh it"
        },
        "path": {
          "type": "string",
          "minLength": 1,
          "maxLength": 4096,
          "description": "Path relative to the selected workspace repository root, for example moira-ws/task/file.md. File tools reject absolute paths, parent traversal and symlinks; use '.' for directory operations at the root"
        },
        "text": {
          "type": "string"
        },
        "action": {
          "type": "string",
          "const": "create"
        }
      },
      "required": [
        "workspace",
        "path",
        "text",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "workspace": {
          "type": "string",
          "description": "Copy the returned workspace reference; never manufacture or refresh it"
        },
        "path": {
          "type": "string",
          "minLength": 1,
          "maxLength": 4096,
          "description": "Path relative to the selected workspace repository root, for example moira-ws/task/file.md. File tools reject absolute paths, parent traversal and symlinks; use '.' for directory operations at the root"
        },
        "text": {
          "type": "string"
        },
        "expected": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "text": {
                  "type": "string"
                }
              },
              "required": [
                "text"
              ],
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "file": {
                  "type": "string",
                  "description": "Copy the returned file reference; never manufacture or refresh it"
                }
              },
              "required": [
                "file"
              ],
              "additionalProperties": false
            }
          ]
        },
        "action": {
          "type": "string",
          "const": "replace"
        }
      },
      "required": [
        "workspace",
        "path",
        "text",
        "expected",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "workspace": {
          "type": "string",
          "description": "Copy the returned workspace reference; never manufacture or refresh it"
        },
        "files": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "path": {
                "type": "string",
                "minLength": 1,
                "maxLength": 4096,
                "description": "Path relative to the selected workspace repository root, for example moira-ws/task/file.md. File tools reject absolute paths, parent traversal and symlinks; use '.' for directory operations at the root"
              },
              "expected": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "text": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "text"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "file": {
                        "type": "string",
                        "description": "Copy the returned file reference; never manufacture or refresh it"
                      }
                    },
                    "required": [
                      "file"
                    ],
                    "additionalProperties": false
                  }
                ]
              },
              "replacements": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "old_text": {
                      "type": "string",
                      "minLength": 1
                    },
                    "new_text": {
                      "type": "string"
                    },
                    "occurrence": {
                      "type": "string",
                      "enum": [
                        "one",
                        "all"
                      ]
                    }
                  },
                  "required": [
                    "old_text",
                    "new_text"
                  ],
                  "additionalProperties": false
                },
                "minItems": 1
              }
            },
            "required": [
              "path",
              "replacements"
            ],
            "additionalProperties": false
          },
          "minItems": 1
        },
        "action": {
          "type": "string",
          "const": "patch"
        }
      },
      "required": [
        "workspace",
        "files",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "reference": {
          "type": "string",
          "description": "Copy the returned operation or process reference; never manufacture or refresh it"
        },
        "action": {
          "type": "string",
          "const": "collect"
        }
      },
      "required": [
        "reference",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "owner": {
          "type": "string",
          "description": "Copy the returned workspace or controller reference; never manufacture or refresh it"
        },
        "kind": {
          "type": "string",
          "enum": [
            "command",
            "file-change",
            "lifecycle",
            "repository",
            "pull-request",
            "delivery",
            "session",
            "unknown"
          ]
        },
        "query": {
          "type": "string"
        },
        "cursor": {
          "type": "string",
          "minLength": 1
        },
        "action": {
          "type": "string",
          "const": "find"
        }
      },
      "required": [
        "owner",
        "action"
      ],
      "additionalProperties": false
    }
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object"
}

Результат: Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие.

{
  "action": "create",
  "workspace": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "path": "notes.txt",
  "text": "Hello\n"
}
{
  "action": "replace",
  "workspace": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "path": "notes.txt",
  "text": "Updated\n",
  "expected": {
    "text": "Hello\n"
  }
}
{
  "action": "patch",
  "workspace": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "files": [
    {
      "path": "notes.txt",
      "replacements": [
        {
          "old_text": "Hello",
          "new_text": "Welcome"
        }
      ]
    }
  ]
}
{
  "action": "collect",
  "reference": "moira-process:v1:eyJvd25lciI6eyJraW5kIjoiZ2l0aHViIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9LCJyZXF1ZXN0SWQiOiJ3czEtMDAwMDAwMDAtMDAwMC00MDAwLTgwMDAtMDAwMDAwMDAwMDAxIn0"
}
{
  "action": "find",
  "owner": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "kind": "command"
}

codespace_git

Создаёт один pull request через ограниченный Git-брокер среды. Читает pull request по номеру или опубликованным head/base без создания. Читает исходную операцию или процесс без повторной отправки эффекта. Находит исходные записи владельца; неоднозначные результаты не выбираются и не повторяются автоматически.

Операции: create, read, collect, find.

Схема входа

{
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "workspace": {
          "type": "string",
          "description": "Copy the returned workspace reference; never manufacture or refresh it"
        },
        "head": {
          "type": "string",
          "minLength": 1,
          "maxLength": 255
        },
        "base": {
          "type": "string",
          "minLength": 1,
          "maxLength": 255
        },
        "title": {
          "type": "string",
          "minLength": 1
        },
        "body": {
          "type": "string"
        },
        "draft": {
          "type": "boolean"
        },
        "action": {
          "type": "string",
          "const": "create"
        }
      },
      "required": [
        "workspace",
        "head",
        "base",
        "title",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "workspace": {
          "type": "string",
          "description": "Copy the returned workspace reference; never manufacture or refresh it"
        },
        "query": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "number": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                }
              },
              "required": [
                "number"
              ],
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "head": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255
                },
                "base": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255
                }
              },
              "required": [
                "head",
                "base"
              ],
              "additionalProperties": false
            }
          ]
        },
        "action": {
          "type": "string",
          "const": "read"
        }
      },
      "required": [
        "workspace",
        "query",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "reference": {
          "type": "string",
          "description": "Copy the returned operation or process reference; never manufacture or refresh it"
        },
        "action": {
          "type": "string",
          "const": "collect"
        }
      },
      "required": [
        "reference",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "owner": {
          "type": "string",
          "description": "Copy the returned workspace or controller reference; never manufacture or refresh it"
        },
        "kind": {
          "type": "string",
          "enum": [
            "command",
            "file-change",
            "lifecycle",
            "repository",
            "pull-request",
            "delivery",
            "session",
            "unknown"
          ]
        },
        "query": {
          "type": "string"
        },
        "cursor": {
          "type": "string",
          "minLength": 1
        },
        "action": {
          "type": "string",
          "const": "find"
        }
      },
      "required": [
        "owner",
        "action"
      ],
      "additionalProperties": false
    }
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object"
}

Результат: Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие.

{
  "action": "create",
  "workspace": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "head": "feature/change",
  "base": "main",
  "title": "Change"
}
{
  "action": "read",
  "workspace": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "query": {
    "number": 42
  }
}
{
  "action": "collect",
  "reference": "moira-process:v1:eyJvd25lciI6eyJraW5kIjoiZ2l0aHViIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9LCJyZXF1ZXN0SWQiOiJ3czEtMDAwMDAwMDAtMDAwMC00MDAwLTgwMDAtMDAwMDAwMDAwMDAxIn0"
}
{
  "action": "find",
  "owner": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "kind": "command"
}

communication

Отправляет обычный текст в настроенные каналы пользователя без выбора credentials или получателей. Доставляет обязательное нативное вложение выбранным сопряжённым владельцем в настроенные каналы. Доставляет существующую неизменяемую публикацию владельца без повторного получения или перезаписи байтов. Читает исходную операцию или процесс без повторной отправки эффекта. Находит исходные записи владельца; неоднозначные результаты не выбираются и не повторяются автоматически.

Операции: send, deliver, deliver_publication, collect, find.

Схема входа

{
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "message": {
          "type": "string",
          "minLength": 1
        },
        "format": {
          "type": "string",
          "enum": [
            "plain",
            "markdown",
            "html"
          ]
        },
        "silent": {
          "type": "boolean"
        },
        "channel": {
          "type": "string",
          "pattern": "^[a-z0-9][a-z0-9._-]*$"
        },
        "action": {
          "type": "string",
          "const": "send"
        }
      },
      "required": [
        "message",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "owner": {
          "type": "string",
          "description": "Copy the returned controller reference; never manufacture or refresh it"
        },
        "file": {},
        "kind": {
          "type": "string",
          "enum": [
            "image",
            "document"
          ]
        },
        "message": {
          "type": "string"
        },
        "format": {
          "type": "string",
          "enum": [
            "plain",
            "markdown",
            "html"
          ]
        },
        "silent": {
          "type": "boolean"
        },
        "channel": {
          "type": "string",
          "pattern": "^[a-z0-9][a-z0-9._-]*$"
        },
        "action": {
          "type": "string",
          "const": "deliver"
        }
      },
      "required": [
        "file",
        "kind",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "publication": {
          "type": "string",
          "pattern": "^owner-file:\\/\\/(workspace|controller)\\/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}\\/[A-Za-z0-9_-]{43}$"
        },
        "kind": {
          "type": "string",
          "enum": [
            "image",
            "document"
          ]
        },
        "message": {
          "type": "string"
        },
        "format": {
          "type": "string",
          "enum": [
            "plain",
            "markdown",
            "html"
          ]
        },
        "silent": {
          "type": "boolean"
        },
        "channel": {
          "type": "string",
          "pattern": "^[a-z0-9][a-z0-9._-]*$"
        },
        "action": {
          "type": "string",
          "const": "deliver_publication"
        }
      },
      "required": [
        "publication",
        "kind",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "reference": {
          "type": "string",
          "description": "Copy the returned operation or process reference; never manufacture or refresh it"
        },
        "action": {
          "type": "string",
          "const": "collect"
        }
      },
      "required": [
        "reference",
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "owner": {
          "type": "string",
          "description": "Copy the returned workspace or controller reference; never manufacture or refresh it"
        },
        "kind": {
          "type": "string",
          "enum": [
            "command",
            "file-change",
            "lifecycle",
            "repository",
            "pull-request",
            "delivery",
            "session",
            "unknown"
          ]
        },
        "query": {
          "type": "string"
        },
        "cursor": {
          "type": "string",
          "minLength": 1
        },
        "action": {
          "type": "string",
          "const": "find"
        }
      },
      "required": [
        "owner",
        "action"
      ],
      "additionalProperties": false
    }
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "file": {
      "type": "object",
      "properties": {
        "file_id": {
          "type": "string",
          "maxLength": 512,
          "pattern": "^(?:sediment:\\/\\/)?file_[A-Za-z0-9]+$"
        },
        "download_url": {
          "type": "string",
          "format": "uri"
        },
        "file_name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 255
        },
        "mime_type": {
          "type": "string",
          "maxLength": 127,
          "pattern": "^[a-z0-9][a-z0-9!#$&^_.+-]*\\/[a-z0-9][a-z0-9!#$&^_.+-]*$"
        },
        "size_bytes": {
          "type": "integer",
          "minimum": 0
        }
      },
      "required": [
        "file_id",
        "download_url"
      ],
      "additionalProperties": false,
      "description": "Native ChatGPT reference acquired by the workspace owner; pass it without base64. Source refusal before admission is confirmed, not a lost accepted mutation"
    }
  },
  "type": "object"
}

Результат: Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие. Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие.

{
  "action": "send",
  "message": "The report is ready."
}
{
  "action": "deliver",
  "file": {
    "file_id": "file_Example",
    "download_url": "https://files.oaiusercontent.com/example"
  },
  "kind": "document"
}
{
  "action": "deliver_publication",
  "publication": "owner-file://workspace/00000000-0000-4000-8000-000000000001/AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
  "kind": "document"
}
{
  "action": "collect",
  "reference": "moira-process:v1:eyJvd25lciI6eyJraW5kIjoiZ2l0aHViIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9LCJyZXF1ZXN0SWQiOiJ3czEtMDAwMDAwMDAtMDAwMC00MDAwLTgwMDAtMDAwMDAwMDAwMDAxIn0"
}
{
  "action": "find",
  "owner": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "kind": "command"
}

codespace_search

Ищет код у владельца среды с явно заданными окнами результата.

Схема входа

{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "Copy the returned workspace reference; never manufacture or refresh it"
    },
    "path": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "description": "Path relative to the selected workspace repository root, for example moira-ws/task/file.md. File tools reject absolute paths, parent traversal and symlinks; use '.' for directory operations at the root"
    },
    "query": {
      "type": "string",
      "minLength": 1
    },
    "mode": {
      "type": "string",
      "enum": [
        "literal",
        "regex"
      ]
    },
    "max_matches": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "max_bytes": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "workspace",
    "path",
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Результат: Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие.

{
  "workspace": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "path": ".",
  "query": "TODO"
}

codespace_upload

Передаёт обязательное нативное вложение в новый путь или наблюдённую цель замены.

Схема входа

{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "Copy the returned workspace reference; never manufacture or refresh it"
    },
    "target": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "create": {
              "type": "object",
              "properties": {
                "path": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 4096,
                  "description": "Path relative to the selected workspace repository root, for example moira-ws/task/file.md. File tools reject absolute paths, parent traversal and symlinks; use '.' for directory operations at the root"
                }
              },
              "required": [
                "path"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "create"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "replace": {
              "type": "object",
              "properties": {
                "file": {
                  "type": "string",
                  "description": "Copy the returned file reference; never manufacture or refresh it"
                }
              },
              "required": [
                "file"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "replace"
          ],
          "additionalProperties": false
        }
      ]
    },
    "file": {
      "type": "object",
      "properties": {
        "file_id": {
          "type": "string",
          "maxLength": 512,
          "pattern": "^(?:sediment:\\/\\/)?file_[A-Za-z0-9]+$"
        },
        "download_url": {
          "type": "string",
          "format": "uri"
        },
        "file_name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 255
        },
        "mime_type": {
          "type": "string",
          "maxLength": 127,
          "pattern": "^[a-z0-9][a-z0-9!#$&^_.+-]*\\/[a-z0-9][a-z0-9!#$&^_.+-]*$"
        },
        "size_bytes": {
          "type": "integer",
          "minimum": 0
        }
      },
      "required": [
        "file_id",
        "download_url"
      ],
      "additionalProperties": false,
      "description": "Native ChatGPT reference acquired by the workspace owner; pass it without base64. Source refusal before admission is confirmed, not a lost accepted mutation"
    }
  },
  "required": [
    "workspace",
    "target",
    "file"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Результат: Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие.

{
  "workspace": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "target": {
    "create": {
      "path": "input.bin"
    }
  },
  "file": {
    "file_id": "file_Example",
    "download_url": "https://files.oaiusercontent.com/example"
  }
}

codespace_download

Публикует ссылку полного файла с автоматически выбранными именем и типом.

Схема входа

{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "Copy the returned workspace reference; never manufacture or refresh it"
    },
    "path": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "description": "Path relative to the selected workspace repository root, for example moira-ws/task/file.md. File tools reject absolute paths, parent traversal and symlinks; use '.' for directory operations at the root"
    },
    "file_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    },
    "mime_type": {
      "type": "string",
      "pattern": "^[a-z0-9!#$&^_.+-]+\\/[a-z0-9!#$&^_.+-]+$"
    },
    "max_bytes": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "workspace",
    "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Результат: Данные владельца, нативный контент или ссылки исходных операций; недоступность наблюдения не доказывает отсутствие.

{
  "workspace": "moira-workspace:v1:eyJnZW5lcmF0aW9uIjoxLCJwcm92aWRlciI6ImdpdGh1Yi1jb2Rlc3BhY2VzIiwicmVzb3VyY2VJZCI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMSJ9",
  "path": "report.pdf"
}

workflow

Показывает доступные текущему пользователю процессы. Создаёт, проверяет и изменяет процессы. Решение выражайте через `cases` на ноде, у которой есть данные (директива маршрутизирует по своему ответу, `success` — когда ни один кейс не сработал), а простую арифметику — через её `expressions`; отдельную ноду condition или expression оставляйте только для общего или самостоятельного решения. Блок прогресса привязывайте к списку, по которому он идёт, через `list`. Создаёт временные токены загрузки или скачивания процесса. Показывает и разрешает конфликты сверки встроенных процессов. Статус возвращает ссылки на кандидатов всем агентам, а полные состояния кандидатов — администраторам. Чтение кандидата и разрешение конфликта доступны только администратору; для смыслового слияния кандидатов используйте Workflow Management Flow, затем передайте объединённый граф.

Операции: list, create, edit, get, get-structure, get-node, search-nodes, validate, list-variables, get-variable, set-variable, delete-variable, diff, copy, clone-node, move-node, list-nodes, get-nodes, analyze-variables, set-visibility, create-invite, list-access, list-invites, revoke-access, revoke-invite, history, get-revision, compare-revisions, rollback, upload, download, reconciliation_status, reconciliation_get, reconciliation_resolve.

Схема входа

{
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "list"
        },
        "search": {
          "type": "string",
          "description": "Search in workflow name and description"
        },
        "visibility": {
          "type": "string",
          "enum": [
            "public",
            "private",
            "all"
          ],
          "description": "Filter by visibility (default: all accessible)"
        },
        "sort": {
          "type": "string",
          "enum": [
            "createdAt",
            "name"
          ],
          "description": "Sort field (default: createdAt)"
        },
        "sortOrder": {
          "type": "string",
          "enum": [
            "asc",
            "desc"
          ],
          "description": "Sort order (default: desc)"
        },
        "limit": {
          "type": "number",
          "minimum": 1,
          "maximum": 100,
          "description": "Number of results (default: 20, max: 100)"
        },
        "offset": {
          "type": "number",
          "minimum": 0,
          "description": "Offset for pagination (default: 0)"
        }
      },
      "required": [
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "create"
        },
        "overwrite": {
          "type": "boolean",
          "description": "Overwrite existing workflow with same ID (default: false)"
        },
        "workflow": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "description": "Workflow ID (auto-generated if not provided)"
            },
            "metadata": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "Human-readable workflow name"
                },
                "version": {
                  "type": "string",
                  "description": "Semantic version (e.g., '1.0.0')"
                },
                "description": {
                  "type": "string",
                  "description": "Brief workflow description"
                },
                "author": {
                  "type": "string",
                  "description": "Workflow author"
                },
                "tags": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Workflow tags"
                },
                "schemaVersion": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "required": [
                "name",
                "version",
                "description"
              ],
              "additionalProperties": true
            },
            "nodes": {
              "type": "array",
              "items": {
                "type": "object",
                "additionalProperties": {}
              },
              "description": "Array of workflow nodes. Decisions are `cases` on the deciding node (condition or agent-directive) with a default output; a separate condition or expression node serves shared or standalone decisions."
            },
            "variableRegistry": {
              "type": "object",
              "additionalProperties": {},
              "description": "Declared global variables (JSON-Schema-shaped: name -> {type, description, default?}). Required for any variable referenced by bare name in directives, routing cases, expressions, progress list bindings and templates."
            },
            "runtimePolicy": {
              "type": "object",
              "properties": {
                "externalVariableWrites": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "object",
                    "properties": {
                      "allowedNodeIds": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      }
                    },
                    "additionalProperties": false
                  }
                }
              },
              "additionalProperties": false
            },
            "progress": {
              "type": "object",
              "properties": {
                "title": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "goal": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 1000
                },
                "facts": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "label": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "value": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 500
                      },
                      "tone": {
                        "type": "string",
                        "enum": [
                          "neutral",
                          "positive",
                          "warning",
                          "critical"
                        ]
                      }
                    },
                    "required": [
                      "label",
                      "value"
                    ],
                    "additionalProperties": false
                  },
                  "maxItems": 8
                },
                "nodes": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "minLength": 1
                      },
                      "label": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "content": {
                        "type": "object",
                        "properties": {
                          "summary": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 1000
                          },
                          "details": {
                            "type": "array",
                            "items": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 500
                            },
                            "maxItems": 12
                          },
                          "outcome": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 1000
                          },
                          "next": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 500
                          }
                        },
                        "required": [
                          "summary"
                        ],
                        "additionalProperties": false
                      },
                      "connections": {
                        "type": "object",
                        "properties": {
                          "default": {
                            "type": "string",
                            "minLength": 1
                          }
                        },
                        "additionalProperties": false
                      },
                      "list": {
                        "type": "object",
                        "properties": {
                          "items": {
                            "type": "string",
                            "minLength": 1
                          },
                          "title": {
                            "type": "string",
                            "minLength": 1
                          },
                          "current": {
                            "type": "string",
                            "minLength": 1
                          },
                          "done": {
                            "type": "string",
                            "minLength": 1
                          },
                          "total": {
                            "type": "string",
                            "minLength": 1
                          },
                          "indexBase": {
                            "type": "number",
                            "enum": [
                              0,
                              1
                            ]
                          }
                        },
                        "additionalProperties": false
                      }
                    },
                    "required": [
                      "id",
                      "label",
                      "content"
                    ],
                    "additionalProperties": false
                  },
                  "minItems": 1,
                  "maxItems": 18
                }
              },
              "required": [
                "nodes"
              ],
              "additionalProperties": false
            },
            "visibility": {
              "type": "string",
              "enum": [
                "public",
                "private"
              ],
              "description": "Workflow visibility (default: private)"
            },
            "systemReminder": {
              "type": "string",
              "description": "System reminder shown to agent on each step"
            }
          },
          "required": [
            "metadata",
            "nodes"
          ],
          "additionalProperties": true,
          "description": "Complete authored workflow for create or validate; preserve the graph and metadata, including fields not edited by this caller"
        }
      },
      "required": [
        "action",
        "workflow"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "edit"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "changes": {
          "type": "object",
          "properties": {
            "metadata": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "version": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "author": {
                  "type": "string"
                },
                "tags": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "additionalProperties": true
            },
            "variableRegistry": {
              "type": "object",
              "additionalProperties": {},
              "description": "Replace the workflow's declared global variable registry"
            },
            "runtimePolicy": {
              "type": "object",
              "properties": {
                "externalVariableWrites": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "object",
                    "properties": {
                      "allowedNodeIds": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      }
                    },
                    "additionalProperties": false
                  }
                }
              },
              "additionalProperties": false
            },
            "progress": {
              "type": "object",
              "properties": {
                "title": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "goal": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 1000
                },
                "facts": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "label": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "value": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 500
                      },
                      "tone": {
                        "type": "string",
                        "enum": [
                          "neutral",
                          "positive",
                          "warning",
                          "critical"
                        ]
                      }
                    },
                    "required": [
                      "label",
                      "value"
                    ],
                    "additionalProperties": false
                  },
                  "maxItems": 8
                },
                "nodes": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "minLength": 1
                      },
                      "label": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "content": {
                        "type": "object",
                        "properties": {
                          "summary": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 1000
                          },
                          "details": {
                            "type": "array",
                            "items": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 500
                            },
                            "maxItems": 12
                          },
                          "outcome": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 1000
                          },
                          "next": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 500
                          }
                        },
                        "required": [
                          "summary"
                        ],
                        "additionalProperties": false
                      },
                      "connections": {
                        "type": "object",
                        "properties": {
                          "default": {
                            "type": "string",
                            "minLength": 1
                          }
                        },
                        "additionalProperties": false
                      },
                      "list": {
                        "type": "object",
                        "properties": {
                          "items": {
                            "type": "string",
                            "minLength": 1
                          },
                          "title": {
                            "type": "string",
                            "minLength": 1
                          },
                          "current": {
                            "type": "string",
                            "minLength": 1
                          },
                          "done": {
                            "type": "string",
                            "minLength": 1
                          },
                          "total": {
                            "type": "string",
                            "minLength": 1
                          },
                          "indexBase": {
                            "type": "number",
                            "enum": [
                              0,
                              1
                            ]
                          }
                        },
                        "additionalProperties": false
                      }
                    },
                    "required": [
                      "id",
                      "label",
                      "content"
                    ],
                    "additionalProperties": false
                  },
                  "minItems": 1,
                  "maxItems": 18
                }
              },
              "required": [
                "nodes"
              ],
              "additionalProperties": false
            },
            "addNodes": {
              "type": "array",
              "items": {
                "type": "object",
                "additionalProperties": {}
              },
              "description": "New nodes to add"
            },
            "removeNodes": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Node IDs to remove"
            },
            "updateNodes": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "nodeId": {
                    "type": "string",
                    "description": "ID of node to update"
                  },
                  "changes": {
                    "description": "Fields to update on the node"
                  }
                },
                "required": [
                  "nodeId"
                ],
                "additionalProperties": false
              },
              "description": "Nodes to update with specific changes"
            },
            "removeConnections": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "nodeId": {
                    "type": "string",
                    "description": "ID of node with connection to remove"
                  },
                  "connectionKey": {
                    "type": "string",
                    "description": "Connection key to remove (e.g., 'default', 'true', 'false')"
                  }
                },
                "required": [
                  "nodeId",
                  "connectionKey"
                ],
                "additionalProperties": false
              },
              "description": "Connections to remove from nodes"
            },
            "systemReminder": {
              "type": "string",
              "description": "New system reminder text"
            }
          },
          "additionalProperties": false
        },
        "expectedRevision": {
          "type": "integer",
          "minimum": 0,
          "description": "edit or rollback: the current definition revision from get; required for rollback; a stale value refuses the write"
        }
      },
      "required": [
        "action",
        "workflowId",
        "changes"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "get"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "includeNodes": {
          "type": "boolean",
          "description": "Include full node definitions in get response"
        },
        "includeValidation": {
          "type": "boolean",
          "description": "Include validation results in response"
        },
        "offset": {
          "type": "number",
          "description": "Pagination offset for node listing"
        },
        "limit": {
          "type": "number",
          "description": "Maximum nodes to return"
        }
      },
      "required": [
        "action",
        "workflowId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "get-structure"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "graph": {
          "type": "boolean",
          "description": "Return ASCII flow graph (get-structure only)"
        },
        "detailed": {
          "type": "boolean",
          "description": "Include directive preview in structure (get-structure only)"
        }
      },
      "required": [
        "action",
        "workflowId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "get-node"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "nodeId": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "workflowId",
        "nodeId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "search-nodes"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "query": {
          "type": "string",
          "minLength": 1
        },
        "includeVariables": {
          "type": "boolean",
          "description": "Include variables in search (search-nodes only)"
        },
        "snippetMode": {
          "type": "boolean",
          "description": "Return only snippets, not full nodes (search-nodes only)"
        }
      },
      "required": [
        "action",
        "workflowId",
        "query"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "validate"
        },
        "workflow": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "description": "Workflow ID (auto-generated if not provided)"
            },
            "metadata": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "Human-readable workflow name"
                },
                "version": {
                  "type": "string",
                  "description": "Semantic version (e.g., '1.0.0')"
                },
                "description": {
                  "type": "string",
                  "description": "Brief workflow description"
                },
                "author": {
                  "type": "string",
                  "description": "Workflow author"
                },
                "tags": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Workflow tags"
                },
                "schemaVersion": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "required": [
                "name",
                "version",
                "description"
              ],
              "additionalProperties": true
            },
            "nodes": {
              "type": "array",
              "items": {
                "type": "object",
                "additionalProperties": {}
              },
              "description": "Array of workflow nodes. Decisions are `cases` on the deciding node (condition or agent-directive) with a default output; a separate condition or expression node serves shared or standalone decisions."
            },
            "variableRegistry": {
              "type": "object",
              "additionalProperties": {},
              "description": "Declared global variables (JSON-Schema-shaped: name -> {type, description, default?}). Required for any variable referenced by bare name in directives, routing cases, expressions, progress list bindings and templates."
            },
            "runtimePolicy": {
              "type": "object",
              "properties": {
                "externalVariableWrites": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "object",
                    "properties": {
                      "allowedNodeIds": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      }
                    },
                    "additionalProperties": false
                  }
                }
              },
              "additionalProperties": false
            },
            "progress": {
              "type": "object",
              "properties": {
                "title": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "goal": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 1000
                },
                "facts": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "label": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "value": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 500
                      },
                      "tone": {
                        "type": "string",
                        "enum": [
                          "neutral",
                          "positive",
                          "warning",
                          "critical"
                        ]
                      }
                    },
                    "required": [
                      "label",
                      "value"
                    ],
                    "additionalProperties": false
                  },
                  "maxItems": 8
                },
                "nodes": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "minLength": 1
                      },
                      "label": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "content": {
                        "type": "object",
                        "properties": {
                          "summary": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 1000
                          },
                          "details": {
                            "type": "array",
                            "items": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 500
                            },
                            "maxItems": 12
                          },
                          "outcome": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 1000
                          },
                          "next": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 500
                          }
                        },
                        "required": [
                          "summary"
                        ],
                        "additionalProperties": false
                      },
                      "connections": {
                        "type": "object",
                        "properties": {
                          "default": {
                            "type": "string",
                            "minLength": 1
                          }
                        },
                        "additionalProperties": false
                      },
                      "list": {
                        "type": "object",
                        "properties": {
                          "items": {
                            "type": "string",
                            "minLength": 1
                          },
                          "title": {
                            "type": "string",
                            "minLength": 1
                          },
                          "current": {
                            "type": "string",
                            "minLength": 1
                          },
                          "done": {
                            "type": "string",
                            "minLength": 1
                          },
                          "total": {
                            "type": "string",
                            "minLength": 1
                          },
                          "indexBase": {
                            "type": "number",
                            "enum": [
                              0,
                              1
                            ]
                          }
                        },
                        "additionalProperties": false
                      }
                    },
                    "required": [
                      "id",
                      "label",
                      "content"
                    ],
                    "additionalProperties": false
                  },
                  "minItems": 1,
                  "maxItems": 18
                }
              },
              "required": [
                "nodes"
              ],
              "additionalProperties": false
            },
            "visibility": {
              "type": "string",
              "enum": [
                "public",
                "private"
              ],
              "description": "Workflow visibility (default: private)"
            },
            "systemReminder": {
              "type": "string",
              "description": "System reminder shown to agent on each step"
            }
          },
          "required": [
            "metadata",
            "nodes"
          ],
          "additionalProperties": true,
          "description": "Complete authored workflow for create or validate; preserve the graph and metadata, including fields not edited by this caller"
        }
      },
      "required": [
        "action",
        "workflow"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "list-variables"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "variableNames": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "query": {
          "type": "string",
          "description": "Search query for search-nodes action"
        },
        "variableTypes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "hasDefault": {
          "type": "boolean"
        },
        "externallyWritable": {
          "type": "boolean"
        }
      },
      "required": [
        "action",
        "workflowId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "get-variable"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "variableName": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "workflowId",
        "variableName"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "set-variable"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "variableName": {
          "type": "string",
          "minLength": 1
        },
        "variableValue": {}
      },
      "required": [
        "action",
        "workflowId",
        "variableName",
        "variableValue"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "delete-variable"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "variableName": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "workflowId",
        "variableName"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "diff"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "compareWorkflowId": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "workflowId",
        "compareWorkflowId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "copy"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "newName": {
          "type": "string",
          "description": "New name for copied workflow (copy action)"
        }
      },
      "required": [
        "action",
        "workflowId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "clone-node"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "nodeId": {
          "type": "string",
          "minLength": 1
        },
        "newId": {
          "type": "string",
          "description": "New ID for cloned node (clone-node action)"
        }
      },
      "required": [
        "action",
        "workflowId",
        "nodeId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "move-node"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "nodeId": {
          "type": "string",
          "minLength": 1
        },
        "targetIndex": {
          "type": "number"
        }
      },
      "required": [
        "action",
        "workflowId",
        "nodeId",
        "targetIndex"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "move-node"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "nodeId": {
          "type": "string",
          "minLength": 1
        },
        "afterNodeId": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "workflowId",
        "nodeId",
        "afterNodeId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "list-nodes"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "typeFilter": {
          "type": "string",
          "description": "Filter nodes by type (list-nodes only)"
        },
        "includePreview": {
          "type": "boolean",
          "description": "Include directive preview (list-nodes only)"
        },
        "previewLength": {
          "type": "number",
          "description": "Length of directive preview (list-nodes only, default 100)"
        }
      },
      "required": [
        "action",
        "workflowId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "get-nodes"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "nodeIds": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "minItems": 1
        }
      },
      "required": [
        "action",
        "workflowId",
        "nodeIds"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "analyze-variables"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "workflowId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "set-visibility"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "visibility": {
          "type": "string",
          "enum": [
            "public",
            "private"
          ]
        }
      },
      "required": [
        "action",
        "workflowId",
        "visibility"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "create-invite"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "ttlMs": {
          "type": "number",
          "description": "Invite expiration time in milliseconds (create-invite only, default 7 days)"
        }
      },
      "required": [
        "action",
        "workflowId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "list-access"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "limit": {
          "type": "number",
          "description": "Maximum nodes to return"
        },
        "offset": {
          "type": "number",
          "description": "Pagination offset for node listing"
        }
      },
      "required": [
        "action",
        "workflowId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "list-invites"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "activeOnly": {
          "type": "boolean",
          "description": "Filter to active (unused) invites only (list-invites only, default true)"
        },
        "limit": {
          "type": "number",
          "description": "Maximum nodes to return"
        },
        "offset": {
          "type": "number",
          "description": "Pagination offset for node listing"
        }
      },
      "required": [
        "action",
        "workflowId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "revoke-access"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "targetUserId": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "workflowId",
        "targetUserId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "revoke-invite"
        },
        "inviteId": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "inviteId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "history"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "workflowId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "get-revision"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "revision": {
          "type": "integer",
          "exclusiveMinimum": 0
        }
      },
      "required": [
        "action",
        "workflowId",
        "revision"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "compare-revisions"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "fromRevision": {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        "toRevision": {
          "type": "integer",
          "exclusiveMinimum": 0
        }
      },
      "required": [
        "action",
        "workflowId",
        "fromRevision",
        "toRevision"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "rollback"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "revision": {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        "expectedRevision": {
          "type": "integer",
          "minimum": 0
        }
      },
      "required": [
        "action",
        "workflowId",
        "revision",
        "expectedRevision"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "upload"
        },
        "ttlMinutes": {
          "type": "number",
          "default": 60,
          "description": "Token expiration time in minutes (default: 60)"
        }
      },
      "required": [
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "download"
        },
        "workflowId": {
          "type": "string",
          "minLength": 1
        },
        "ttlMinutes": {
          "type": "number",
          "default": 60,
          "description": "Token expiration time in minutes (default: 60)"
        }
      },
      "required": [
        "action",
        "workflowId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "reconciliation_status"
        }
      },
      "required": [
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "reconciliation_get"
        },
        "reference": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "reference"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "reconciliation_resolve"
        },
        "reference": {
          "type": "string",
          "minLength": 1
        },
        "selection": {
          "type": "string",
          "enum": [
            "current",
            "incoming",
            "previous"
          ]
        },
        "revision": {
          "type": "string",
          "pattern": "^[a-f0-9]{64}$",
          "minLength": 1
        },
        "rationale": {
          "type": "string",
          "minLength": 1,
          "maxLength": 2000
        }
      },
      "required": [
        "action",
        "reference",
        "selection",
        "revision",
        "rationale"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "reconciliation_resolve"
        },
        "reference": {
          "type": "string",
          "minLength": 1
        },
        "revision": {
          "type": "string",
          "pattern": "^[a-f0-9]{64}$",
          "minLength": 1
        },
        "rationale": {
          "type": "string",
          "minLength": 1,
          "maxLength": 2000
        },
        "mergedGraph": {
          "type": "object",
          "additionalProperties": {}
        },
        "visibility": {
          "type": "string",
          "enum": [
            "public",
            "private"
          ]
        },
        "selection": {
          "type": "string",
          "const": "current"
        }
      },
      "required": [
        "action",
        "reference",
        "revision",
        "rationale",
        "mergedGraph",
        "visibility",
        "selection"
      ],
      "additionalProperties": false
    }
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object"
}

Результат: Страница каталога процессов с явными offset, limit, returnedCount, hasMore и nextOffset. Данные процесса, зависящие от операции. Ссылка и инструкция по использованию. Статус конфликта, кандидат или результат разрешения.

{
  "limit": 20,
  "offset": 0,
  "action": "list"
}
{
  "limit": 20,
  "offset": 20,
  "action": "list"
}
{
  "action": "get",
  "workflowId": "moira/quick-task",
  "includeNodes": false,
  "includeValidation": false
}
{
  "action": "list-nodes",
  "workflowId": "moira/quick-task",
  "includePreview": true
}
{
  "action": "get-nodes",
  "workflowId": "moira/quick-task",
  "nodeIds": [
    "start",
    "end"
  ]
}
{
  "action": "analyze-variables",
  "workflowId": "moira/quick-task"
}
{
  "action": "set-visibility",
  "workflowId": "my-workflow",
  "visibility": "private"
}
{
  "action": "upload",
  "ttlMinutes": 60
}
{
  "action": "reconciliation_status"
}

execution

Подготавливает, затем выполняет защищённый от повторов запуск процесса. Продолжает существующее выполнение процесса. Читает и изменяет состояние выполнения. Проверяет, создаёт или снимает блокировки выполнения.

Операции: prepare, execute, step, user, executions, execution_context, current_step, diagnose, materialize, recover, cancel-execution, stop-execution, update-note, update-task-title, set-parent, reminders, add-reminder, update-reminder, remove-reminder, variables, set-variable, await-user, progress, progress-image-token, lock_status, lock_list, unlock, lock.

Схема входа

{
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "prepare"
        },
        "workflowId": {
          "type": "string",
          "description": "Workflow ID to prepare; discover accessible definitions with workflow({action:\"list\"})"
        },
        "note": {
          "type": "string",
          "maxLength": 500,
          "description": "Optional prepare execution note (max 500 chars)"
        },
        "parentExecutionId": {
          "type": "string",
          "description": "Required for prepare. Use \"none\" for standalone, or a parent process UUID."
        },
        "skipTelegramCheck": {
          "type": "boolean",
          "description": "Prepare only. Deprecated alias for skipNotificationCheck"
        }
      },
      "required": [
        "action",
        "workflowId",
        "parentExecutionId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "prepare"
        },
        "workflowId": {
          "type": "string",
          "description": "Workflow ID to prepare; discover accessible definitions with workflow({action:\"list\"})"
        },
        "note": {
          "type": "string",
          "maxLength": 500,
          "description": "Optional prepare execution note (max 500 chars)"
        },
        "parentExecutionId": {
          "type": "string",
          "description": "Required for prepare. Use \"none\" for standalone, or a parent process UUID."
        },
        "skipNotificationCheck": {
          "type": "boolean",
          "const": false
        },
        "skipTelegramCheck": {
          "type": "boolean",
          "const": false
        }
      },
      "required": [
        "action",
        "workflowId",
        "parentExecutionId",
        "skipNotificationCheck"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "prepare"
        },
        "workflowId": {
          "type": "string",
          "description": "Workflow ID to prepare; discover accessible definitions with workflow({action:\"list\"})"
        },
        "note": {
          "type": "string",
          "maxLength": 500,
          "description": "Optional prepare execution note (max 500 chars)"
        },
        "parentExecutionId": {
          "type": "string",
          "description": "Required for prepare. Use \"none\" for standalone, or a parent process UUID."
        },
        "skipNotificationCheck": {
          "type": "boolean",
          "const": true
        },
        "skipTelegramCheck": {
          "type": "boolean",
          "const": true
        }
      },
      "required": [
        "action",
        "workflowId",
        "parentExecutionId",
        "skipNotificationCheck"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "execute"
        },
        "startAttemptId": {
          "type": "string",
          "format": "uuid",
          "description": "Required for execute. Start attempt ID returned by prepare"
        }
      },
      "required": [
        "action",
        "startAttemptId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "step"
        },
        "processId": {
          "type": "string",
          "description": "Process ID from successful execution execute or a previous execution step response"
        },
        "attemptId": {
          "type": "string",
          "description": "Step attempt ID from successful execution execute, execution step, or execution current_step"
        },
        "input": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "object",
              "additionalProperties": {}
            },
            {
              "type": "array",
              "items": {}
            },
            {
              "type": "number"
            },
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "description": "Input data matching the step's inputSchema. Structure depends on current step requirements."
        }
      },
      "required": [
        "action",
        "processId",
        "attemptId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "step"
        },
        "processId": {
          "type": "string",
          "description": "Process ID from successful execution execute or a previous execution step response"
        },
        "attemptId": {
          "type": "string",
          "description": "Step attempt ID from successful execution execute, execution step, or execution current_step"
        },
        "teleportTo": {
          "type": "string"
        }
      },
      "required": [
        "action",
        "processId",
        "attemptId",
        "teleportTo"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "user"
        }
      },
      "required": [
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "executions"
        },
        "status": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "running",
              "waiting",
              "completed",
              "failed",
              "locked"
            ]
          },
          "description": "Filter executions by status (array of statuses)"
        },
        "workflowId": {
          "type": "string",
          "description": "Filter by workflow ID"
        },
        "search": {
          "type": "string",
          "description": "Search in execution notes"
        },
        "sort": {
          "type": "string",
          "enum": [
            "createdAt",
            "updatedAt"
          ],
          "description": "Sort field for executions list"
        },
        "sortOrder": {
          "type": "string",
          "enum": [
            "asc",
            "desc"
          ],
          "description": "Sort order (ascending or descending)"
        },
        "limit": {
          "type": "number",
          "minimum": 1,
          "maximum": 100,
          "description": "Maximum executions to return (1-100)"
        },
        "offset": {
          "type": "number",
          "minimum": 0,
          "description": "Pagination offset"
        }
      },
      "required": [
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "execution_context"
        },
        "executionId": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "executionId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "current_step"
        },
        "executionId": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "executionId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "diagnose"
        },
        "executionId": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "executionId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "materialize"
        },
        "executionId": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "executionId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "recover"
        },
        "executionId": {
          "type": "string",
          "minLength": 1
        },
        "nodeId": {
          "type": "string",
          "minLength": 1
        },
        "variableValues": {
          "type": "object",
          "additionalProperties": {},
          "description": "Variable values written into the execution context while recovering (recover only)"
        }
      },
      "required": [
        "action",
        "executionId",
        "nodeId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "cancel-execution"
        },
        "executionId": {
          "type": "string",
          "minLength": 1
        },
        "expectedRevision": {
          "type": "integer",
          "minimum": 0
        }
      },
      "required": [
        "action",
        "executionId",
        "expectedRevision"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "stop-execution"
        },
        "executionId": {
          "type": "string",
          "minLength": 1
        },
        "expectedRevision": {
          "type": "integer",
          "minimum": 0
        },
        "reason": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500
        }
      },
      "required": [
        "action",
        "executionId",
        "expectedRevision",
        "reason"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "update-note"
        },
        "executionId": {
          "type": "string",
          "minLength": 1
        },
        "note": {
          "type": "string",
          "maxLength": 500
        }
      },
      "required": [
        "action",
        "executionId",
        "note"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "update-task-title"
        },
        "executionId": {
          "type": "string",
          "minLength": 1
        },
        "taskTitle": {
          "type": "string",
          "maxLength": 500,
          "minLength": 1
        },
        "expectedRevision": {
          "type": "integer",
          "minimum": 0
        },
        "expectedTaskIdentityRevision": {
          "type": "string",
          "minLength": 64,
          "maxLength": 64
        }
      },
      "required": [
        "action",
        "executionId",
        "taskTitle",
        "expectedRevision",
        "expectedTaskIdentityRevision"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "set-parent"
        },
        "executionId": {
          "type": "string",
          "minLength": 1
        },
        "expectedRevision": {
          "type": "integer",
          "minimum": 0
        },
        "expectedParentRevision": {
          "type": "string",
          "minLength": 64,
          "maxLength": 64
        },
        "parentExecutionId": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid"
            },
            {
              "type": "string",
              "const": "none"
            }
          ]
        }
      },
      "required": [
        "action",
        "executionId",
        "expectedRevision",
        "expectedParentRevision",
        "parentExecutionId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "reminders"
        },
        "executionId": {
          "type": "string",
          "minLength": 1
        },
        "reminderStatus": {
          "type": "string",
          "enum": [
            "active",
            "cancelled"
          ],
          "description": "Reminder status filter"
        },
        "search": {
          "type": "string",
          "description": "Search in execution notes"
        }
      },
      "required": [
        "action",
        "executionId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "add-reminder"
        },
        "executionId": {
          "type": "string",
          "minLength": 1
        },
        "expectedRevision": {
          "type": "integer",
          "minimum": 0
        },
        "expectedRemindersRevision": {
          "type": "string",
          "minLength": 64,
          "maxLength": 64
        },
        "idempotencyKey": {
          "type": "string",
          "maxLength": 100
        },
        "reminderText": {
          "type": "string",
          "minLength": 1,
          "maxLength": 1000
        }
      },
      "required": [
        "action",
        "executionId",
        "expectedRevision",
        "expectedRemindersRevision",
        "reminderText"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "update-reminder"
        },
        "executionId": {
          "type": "string",
          "minLength": 1
        },
        "expectedRevision": {
          "type": "integer",
          "minimum": 0
        },
        "expectedRemindersRevision": {
          "type": "string",
          "minLength": 64,
          "maxLength": 64
        },
        "reminderId": {
          "type": "string",
          "minLength": 1
        },
        "reminderText": {
          "type": "string",
          "minLength": 1,
          "maxLength": 1000
        }
      },
      "required": [
        "action",
        "executionId",
        "expectedRevision",
        "expectedRemindersRevision",
        "reminderId",
        "reminderText"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "remove-reminder"
        },
        "executionId": {
          "type": "string",
          "minLength": 1
        },
        "expectedRevision": {
          "type": "integer",
          "minimum": 0
        },
        "expectedRemindersRevision": {
          "type": "string",
          "minLength": 64,
          "maxLength": 64
        },
        "reminderId": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "executionId",
        "expectedRevision",
        "expectedRemindersRevision",
        "reminderId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "variables"
        },
        "executionId": {
          "type": "string",
          "minLength": 1
        },
        "names": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "search": {
          "type": "string",
          "description": "Search in execution notes"
        },
        "types": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "editable": {
          "type": "boolean"
        },
        "hasValue": {
          "type": "boolean"
        },
        "writePhase": {
          "type": "string",
          "enum": [
            "current",
            "other"
          ]
        }
      },
      "required": [
        "action",
        "executionId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "set-variable"
        },
        "executionId": {
          "type": "string",
          "minLength": 1
        },
        "variableName": {
          "type": "string",
          "minLength": 1
        },
        "expectedRevision": {
          "type": "integer",
          "minimum": 0
        },
        "expectedContextRevision": {
          "type": "string",
          "minLength": 64,
          "maxLength": 64
        },
        "variableValue": {}
      },
      "required": [
        "action",
        "executionId",
        "variableName",
        "expectedRevision",
        "expectedContextRevision",
        "variableValue"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "await-user"
        },
        "executionId": {
          "type": "string",
          "minLength": 1
        },
        "question": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500
        },
        "options": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "minItems": 1,
          "maxItems": 4,
          "description": "await-user: the choices, when the question is a choice"
        }
      },
      "required": [
        "action",
        "executionId",
        "question"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "await-user"
        },
        "executionId": {
          "type": "string",
          "minLength": 1
        },
        "resolve": {
          "type": "boolean",
          "const": true
        }
      },
      "required": [
        "action",
        "executionId",
        "resolve"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "progress"
        },
        "executionId": {
          "type": "string",
          "minLength": 1
        },
        "at": {
          "type": "integer",
          "minimum": 0,
          "description": "Route cursor for progress: project the run as of this visit sequence number (the route is cut there, variables carry the values written up to it)"
        }
      },
      "required": [
        "action",
        "executionId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "progress-image-token"
        },
        "executionId": {
          "type": "string",
          "minLength": 1
        },
        "device_id": {
          "type": "string",
          "format": "uuid",
          "description": "Selected paired controller for progress-image-token; omit only when exactly one live controller is eligible"
        },
        "theme": {
          "type": "string",
          "enum": [
            "light",
            "dark"
          ]
        },
        "viewportWidth": {
          "type": "integer",
          "minimum": 480,
          "maximum": 4096
        },
        "view": {
          "type": "string",
          "enum": [
            "cards",
            "process"
          ],
          "description": "progress-image-token: cards (default) draws every block as a content card; process draws the aggregated block view with labelled transitions and loops"
        },
        "hide": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "maxItems": 100,
          "description": "progress-image-token: block ids or authored node ids (resolved to their block) left out of the image; their transitions collapse"
        },
        "collapse": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "maxItems": 100,
          "description": "progress-image-token: block ids or authored node ids drawn as a label-only chip"
        }
      },
      "required": [
        "action",
        "executionId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "lock_status"
        },
        "executionId": {
          "type": "string",
          "description": "Execution ID (required for all actions)"
        }
      },
      "required": [
        "action",
        "executionId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "lock_list"
        },
        "executionId": {
          "type": "string",
          "description": "Execution ID (required for all actions)"
        }
      },
      "required": [
        "action",
        "executionId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "unlock"
        },
        "executionId": {
          "type": "string",
          "description": "Execution ID (required for all actions)"
        },
        "pin": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "executionId",
        "pin"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "lock"
        },
        "executionId": {
          "type": "string",
          "description": "Execution ID (required for all actions)"
        },
        "reason": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "executionId",
        "reason"
      ],
      "additionalProperties": false
    }
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object"
}

Результат: Квитанция попытки запуска либо идентификатор выполнения и первая инструкция. Следующая инструкция с идентификатором попытки шага или итоговый результат. Данные сессии или выполнения для выбранной операции. Состояние блокировки без секретного PIN-кода.

{
  "action": "prepare",
  "workflowId": "moira/quick-task",
  "parentExecutionId": "none"
}
{
  "action": "execute",
  "startAttemptId": "00000000-0000-4000-8000-000000000000"
}
{
  "processId": "00000000-0000-4000-8000-000000000000",
  "attemptId": "11111111-1111-4111-8111-111111111111",
  "input": {
    "outcome": "completed"
  },
  "action": "step"
}
{
  "action": "executions",
  "limit": 20,
  "offset": 0
}
{
  "action": "lock_status",
  "executionId": "00000000-0000-4000-8000-000000000000"
}

notes

Хранит и возвращает версионируемые заметки.

Операции: list, get, save, delete, history, stats.

Схема входа

{
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "list"
        },
        "tag": {
          "type": "string",
          "description": "Filter notes by tag (for list action)"
        },
        "keySearch": {
          "type": "string",
          "description": "Search notes by key pattern (for list action)"
        },
        "limit": {
          "type": "number",
          "minimum": 1,
          "maximum": 100,
          "description": "Maximum notes to return (1-100, default 50)"
        },
        "offset": {
          "type": "number",
          "minimum": 0,
          "description": "Pagination offset (default 0)"
        }
      },
      "required": [
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "get"
        },
        "key": {
          "type": "string",
          "minLength": 1
        },
        "version": {
          "type": "number",
          "description": "Specific version number to retrieve (for get action)"
        }
      },
      "required": [
        "action",
        "key"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "save"
        },
        "key": {
          "type": "string",
          "minLength": 1
        },
        "value": {
          "type": "string"
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Tags for the note (for save action, max 10 tags)"
        }
      },
      "required": [
        "action",
        "key",
        "value"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "delete"
        },
        "key": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "key"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "history"
        },
        "key": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "key"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "stats"
        }
      },
      "required": [
        "action"
      ],
      "additionalProperties": false
    }
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object"
}

Результат: Данные заметок для выбранной операции.

{
  "action": "list",
  "limit": 20,
  "offset": 0
}

playbooks

Хранит именованный переиспользуемый текст поведения для чтения агентом.

Операции: list, get, save, delete, history, compare, restore, visibility.

Схема входа

{
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "list"
        },
        "search": {
          "type": "string",
          "description": "Search playbooks by name or description (for list)"
        },
        "limit": {
          "type": "number",
          "minimum": 1,
          "maximum": 100,
          "description": "Maximum playbooks to return (1-100, default 50)"
        },
        "offset": {
          "type": "number",
          "minimum": 0,
          "description": "Pagination offset (default 0)"
        }
      },
      "required": [
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "get"
        },
        "name": {
          "type": "string",
          "minLength": 1
        },
        "owner": {
          "type": "string",
          "description": "Owner handle or id when reading someone else's public playbook; defaults to you"
        },
        "revision": {
          "type": "number",
          "description": "Revision number to read or restore (for get and restore)"
        }
      },
      "required": [
        "action",
        "name"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "save"
        },
        "name": {
          "type": "string",
          "minLength": 1
        },
        "content": {
          "type": "string"
        },
        "title": {
          "type": "string",
          "description": "Human-readable name (for save)"
        },
        "description": {
          "type": "string",
          "description": "What this playbook is for (for save)"
        }
      },
      "required": [
        "action",
        "name",
        "content"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "delete"
        },
        "name": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "name"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "history"
        },
        "name": {
          "type": "string",
          "minLength": 1
        },
        "owner": {
          "type": "string",
          "description": "Owner handle or id when reading someone else's public playbook; defaults to you"
        }
      },
      "required": [
        "action",
        "name"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "compare"
        },
        "name": {
          "type": "string",
          "minLength": 1
        },
        "fromRevision": {
          "type": "number"
        },
        "toRevision": {
          "type": "number"
        },
        "owner": {
          "type": "string",
          "description": "Owner handle or id when reading someone else's public playbook; defaults to you"
        }
      },
      "required": [
        "action",
        "name",
        "fromRevision",
        "toRevision"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "restore"
        },
        "name": {
          "type": "string",
          "minLength": 1
        },
        "revision": {
          "type": "number"
        }
      },
      "required": [
        "action",
        "name",
        "revision"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "visibility"
        },
        "name": {
          "type": "string",
          "minLength": 1
        },
        "visibility": {
          "type": "string",
          "enum": [
            "private",
            "public"
          ]
        }
      },
      "required": [
        "action",
        "name",
        "visibility"
      ],
      "additionalProperties": false
    }
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object"
}

Результат: Данные playbook для выбранной операции.

{
  "action": "list",
  "limit": 20,
  "offset": 0
}

artifacts

Управляет статическими HTML-артефактами.

Операции: token, upload, update, delete, list, stats.

Схема входа

{
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "token"
        },
        "ttlMinutes": {
          "type": "number",
          "minimum": 1,
          "maximum": 1440,
          "description": "Token expiration in minutes (1-1440, default 60)"
        }
      },
      "required": [
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "upload"
        },
        "name": {
          "type": "string",
          "minLength": 1
        },
        "executionId": {
          "type": "string",
          "description": "Link inline upload to an execution; for HTTP upload send executionId in the body"
        },
        "content": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "name",
        "content"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "update"
        },
        "uuid": {
          "type": "string",
          "minLength": 1
        },
        "name": {
          "type": "string",
          "description": "Artifact name (required for upload action)"
        },
        "content": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "uuid",
        "content"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "delete"
        },
        "uuid": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "action",
        "uuid"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "list"
        },
        "limit": {
          "type": "number",
          "minimum": 1,
          "maximum": 100,
          "description": "Maximum artifacts to return (1-100, default 50)"
        },
        "offset": {
          "type": "number",
          "minimum": 0,
          "description": "Pagination offset (default 0)"
        }
      },
      "required": [
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "stats"
        }
      },
      "required": [
        "action"
      ],
      "additionalProperties": false
    }
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object"
}

Результат: Метаданные, квота или токен артефакта.

{
  "action": "list",
  "limit": 20,
  "offset": 0
}

settings

Читает или изменяет настройки пользователя.

Операции: get, set, list.

Схема входа

{
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "get"
        }
      },
      "required": [
        "action"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "get"
        },
        "key": {
          "type": "string",
          "minLength": 1,
          "pattern": "\\S"
        }
      },
      "required": [
        "action",
        "key"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "get"
        },
        "category": {
          "type": "string",
          "minLength": 1,
          "pattern": "\\S"
        }
      },
      "required": [
        "action",
        "category"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "set"
        },
        "key": {
          "type": "string",
          "minLength": 1,
          "pattern": "\\S"
        },
        "value": {}
      },
      "required": [
        "action",
        "key",
        "value"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "const": "list"
        },
        "category": {
          "type": "string",
          "minLength": 1,
          "pattern": "\\S",
          "description": "Category filter for get and list; do not combine with key for get"
        }
      },
      "required": [
        "action"
      ],
      "additionalProperties": false
    }
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object"
}

Результат: Безопасно скрытые настройки или результат изменения.

{
  "action": "get",
  "key": "telegram.enabled"
}
{
  "action": "get",
  "category": "notifications"
}
{
  "action": "get"
}

help

Возвращает документацию и фактический справочник инструментов.

Схема входа

{
  "type": "object",
  "properties": {
    "topic": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ],
      "description": "Documentation topic(s) to retrieve. Call without a topic to discover the current topics and accepted aliases."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Результат: Документация в Markdown.

{
  "topic": "tools"
}

Каталог задаёт допустимые входные данные. Тематические разделы ниже объясняют полномочия, долговечное состояние и эффекты, которые сама схема не доказывает.

Выберите группу инструмента и точную ветвь action до составления аргументов. Поля другого действия отклоняются; отсутствие поля, null, false и пустое значение различаются. codespace_search, codespace_upload и codespace_download имеют одну цель и не принимают action. Для нативного ввода используйте объявленное корневое поле file или stdin_file, сохраняя дескриптор хоста и метаданные без изменений. Нативные метаданные опубликованной схемы обозначают это поле, но не делают его необязательным для действия, которому нужен файл.

communication (send) использует настроенные каналы текущего пользователя; вызывающий не передаёт реквизиты получателя или произвольные заголовки. Действуют лимиты провайдера (обычный текст Telegram — 4096 символов).

В communication (deliver) передавайте нативный дескриптор файла хоста и метаданные без изменений. Явно выбранный зарегистрированный контроллер не заменяется другим из-за доступности. communication (deliver_publication) обращается к владельцу через существующую неизменяемую публикацию. Публикация не отправляет сообщение; доставка не расходует и не продлевает её. Чтение требует действующих прав и неистёкшего срока.

Владелец хранит байты и исходный receipt. Облачная Moira разрешает канал и передаёт поток в фиксированный транспорт провайдера, не сохраняя копию нативного файла. Владелец проверяет весь план файла и текста до staging; неподдерживаемый явно выбранный вид отклоняется, а не подменяется. Читайте возвращённую исходную операцию через communication (collect). Если первый ответ потерян, найдите кандидатов у того же владельца и явно выберите исходную операцию даже при одном совпадении. Отсутствие или недоступность наблюдения не доказывает, что доставка не состоялась. См. восстановление доставки.

Обнаружение возвращает непрозрачные ссылки workspace, контроллера, цели и установки. Копируйте их без изменений; адрес не даёт полномочий. Конфликт lifecycle требует нового наблюдения и осознанного решения, в том числе повторного подтверждения удаления.

Команда принимает argv или script; нативный stdin требует codespace_terminal (run_native). Каждый намеренный неконтролируемый вызов — отдельное намерение: текст команды не устраняет дублирование при потере первого ответа. Исходные операции и процессы читаются действием collect исходной группы по возвращённым ссылкам; find находит кандидатов у того же владельца без выполнения работы. Известный неопределённый исход отображается как unconfirmed; подтверждённый отказ — как завершённый с outcome.ok:false. Ни то ни другое не разрешает повтор эффекта и не меняет сохранённый receipt. codespace (resume) продолжает только исходную сохранённую настройку приватного репозитория, а не команды или создание замены. Lifecycle использует codespace с action: "lifecycle" и отдельным полем operation: start, stop или resume_setup.

Чтение файла возвращает полные UTF-8 символы и проверенные ссылки или курсоры. Создание требует отсутствия файла; замена проверяет полный ожидаемый текст или наблюдённую ссылку; patch сопоставляет текст с одним оригиналом без вычисленных вызывающим смещений и хешей. Upload требует нативный дескриптор и явную цель создания либо проверенной замены. Download публикует весь файл, а не только прочитанный префикс. Окно наблюдения не задаёт срок исполнения команды. См. решение проблем workspace и файлов и паттерн workspace.

Руководство агента описывает prepare/execute, identity текущей попытки шага, точный replay, сопоставление устаревшего состояния, схему ответа и ревизии метаданных. Решение проблем описывает diagnose/recover: восстановление не повторяет эффекты, не открывает терминальный запуск и не обходит шаг здорового выполнения.

Ответ шага подтверждает сохранённое состояние выполнения, а не выполнение агентом директивы. Отсутствующее значение, пустое значение и отклонённый ответ различаются. Архив materialize, хранение у владельца, чтение исходной операции, fallback и завершение описаны в Materialize. Названия задач и одноразовые разрешения изображения прогресса — в Workflows.

Для отмены идущего workflow используйте защищённую остановку. Она сохраняет окончательный остановленный результат, а не успех задачи, и не останавливает активные дочерние запуски. cancel-execution применяется к заблокированному старту и не заменяет остановку идущего выполнения.

Руководство агента описывает чтение и изменение определений, пагинацию и административную сверку. Изменение определения не исполняет workflow. Для смыслового авторинга и разрешения конфликтов используйте Workflow Management Flow.

MCP-блокировка принадлежит текущему пользователю и требует идущего выполнения и доверенной доставки в Telegram. Ни один skip-флаг не обходит доставку PIN; неудачная доставка не оставляет пригодной активной блокировки. MCP никогда не раскрывает PIN. Отдельный аутентифицированный ответ Web-создания показывает его владельцу один раз. См. ноды lock.

Руководство агента описывает выбор, маскирование и валидацию настроек. Маска секрета не служит значением для записи. Заметки описывают версионируемый пользовательский текст, мягкое удаление и настраиваемые лимиты размера, хранения, версий, ключей и тегов.

Playbooks хранят именованный переиспользуемый текст поведения. Публикация даёт аутентифицированное чтение текста владельца, а не право его менять. Имена изолированы по аккаунтам; сохранение или восстановление создаёт ревизию с действующими лимитами хранения и размера. Для чтения чужого публичного playbook явно укажите handle или ID владельца.

Артефакты описывают публичный статический HTML, разрешения загрузки, сроки, пользовательские квоты и владение. Действия upload и download группы workflow выдают краткоживущие разрешения импорта и экспорта JSON workflow; multipart-загрузка использует поле workflow. Обычное чтение и изменение workflow выполняется другими действиями workflow.

Выберите одного провайдера для обнаружения; другие провайдеры и биллинг не должны задерживать его. Для lifecycle, доступа к репозиторию и Git используйте возвращённые ссылки и текущие права. Не заменяйте выбранного зарегистрированного владельца другим доступным контроллером. Лимиты простоя и провайдера, диагностика описаны в Self-hosting и Решении проблем.

Используйте поддерживаемый гостевой CLI для разрешённого кодспейса. Сохраняйте полный вывод операции и диагностику daemon, не выводите успех из кода shell или наличия workspace. resume_setup продолжает ту же доказанную жизнь гостя и не разрешает замену VM. См. Решение проблем.

help() показывает английские темы и aliases; help({ topic: "tools" }) выводит тот же типизированный каталог. Это не чтение действующих системных инструкций с database override. Инструкции агента показывают канонический файловый default.