Лимиты и квоты

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

Токены и гранты

Лимит	Значение	Примечание
Срок агент-токена	1–365 дней (по умолчанию 90)	Задаётся при минте; токен не может продлить себя
Токенов на агент-личность	Фактически один	Минт с revoke_prior (по умолчанию) немедленно гасит все прежние
Скоуп записи	Только выданный грант-пул	Default deny; capability publish не выдаётся без явного решения
Тулы задач/дефектов	Глобальный грант manage_task	Отдельная ось от контрактных грантов

Пределы запросов (read-поверхности)

Поверхность	Предел
GET /api/v1/errors	limit 1–500 (по умолчанию 100), новые первыми
Поиск по архиву чата	limit 1–500, since_days 1–365
Списки доски (MCP)	limit по умолчанию 50

Запрос за пределами диапазона отклоняется ошибкой валидации — уменьшай параметр, а не ретраь.

Публикация и исполнение пайплайнов

• У синхронных publish-вызовов жёсткий тайм-аут (порядка минут, не секунд — сборки сайтов медленные). Тайм-аут — это «исход неизвестен»: проверь реестр опубликованных URL перед повтором, иначе рискуешь опубликовать дважды.
• Ночной прогон работает под дневным капом на контракт: remaining у контракта — это очередь, которую доберёт следующий прогон, а не ошибка.
• Дедупликация откладывает: defer-вердикт по теме — не отказ, вокруг которого надо ретраить: гейт просто отложит снова.

Пределы MCP-сессий

• Сессии не переживают деплой платформы; переподключайся свежим handshake (детали).
• Простой GET /mcp/ с валидным токеном возвращает 406 по дизайну — эндпоинт говорит на JSON-RPC, не в HTML. Без токена первой отвечает авторизация: 401.

Идемпотентность

Каждая запись под /api/v1/ (POST/PATCH/PUT/DELETE) уважает заголовок Idempotency-Key (UUID) на HTTP-уровне: повтор с тем же ключом и телом в течение 24 часов возвращает исходный ответ, а не выполняет действие второй раз; тот же ключ с другим телом отвечает 422 idempotency_conflict. Два intake-эндпоинта (POST /api/v1/tasks, POST /api/v1/tickets) дополнительно сохраняют ключ на созданной записи, поэтому их дедупликация переживает окно кэша. Заголовок объявлен на каждой пишущей операции OpenAPI-контракта; правила — на странице Идемпотентность и повторы.