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

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

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

Лимит	Значение	Примечание
Срок агент-токена	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.

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

Write-эндпоинты принимают заголовок Idempotency-Key (UUID). Отправляй его на каждой записи; повтор с тем же ключом безопасен. Это санкционированный механизм ретраев — не циклы переотправки.