{"object":"list","data":[{"version":"1.3.0","apiVersion":"2026-09-15","date":"2026-09-17","title":"События платформы наружу: получатель-агент, реплей, живой поток","changes":[{"type":"added","title":"Подписка может вести к агенту: targetKind, agentProfile, deliveryMode","description":"deliveryMode `wake` запускает профиль Hermes с текстом события, `card` ставит задачу на доску тому же профилю. Профиль проверяется по реестру исполнителей."},{"type":"added","title":"Шторм-контроль и защита от петель","description":"Не более 6 пробуждений агента в минуту на подписку; однотипные события по одному объекту за 5 минут сворачиваются в одну доставку; событие, порождённое действием самого агента, ему не возвращается."},{"type":"added","title":"Реплей: POST /webhooks/{id}/deliveries/{deliveryId}/replay","description":"Запись журнала возвращается в очередь и доставляется сразу, без новой записи."},{"type":"added","title":"Живой поток: GET /events/stream (SSE)","description":"Событие появляется в панели и сессии агента без перезагрузки; тот же момент, что и доставка подписчикам."}]},{"version":"1.2.0","apiVersion":"2026-09-15","date":"2026-09-17","title":"Доска задач и исполнители в публичном API","changes":[{"type":"added","title":"Ресурс «Доска»: GET/POST /cards, GET/PATCH/DELETE /cards/{id}","description":"Карточки живут в том же kanban.db, что и панель: задача, заведённая агентом, сразу видна на доске и подхватывается диспетчером цифровых сотрудников. Движение карточки — смена status (in_progress — «взял в работу», done — закрыта), удаление — архивация."},{"type":"added","title":"Ресурс «Агенты»: GET /agents","description":"Исполнители, на которых можно назначить задачу: цифровые сотрудники (employee) и профили разработки платформы (developer). Значение id подставляется в assigneeId карточки."},{"type":"added","title":"MCP: инструменты get_cards, get_card, create_card, update_card, delete_card, get_agents","description":"Агент ведёт работу по доске теми же правами read:kanban / write:kanban, что и человек: 24 инструмента собираются из реестра маршрутов."},{"type":"added","title":"Лента карточки: GET/POST /cards/{id}/comments","description":"Комментарии людей и итоговые отчёты агентов в одном порядке. Автор по умолчанию — исполнитель карточки: отчёт агента виден в ленте задачи, а не теряется в чате сессии."},{"type":"added","title":"События доски: card.created, card.moved, card.done, card.commented","description":"Уходят подписчикам вебхуков с подписью X-Rkdash-Signature и журналом доставки, как события меню и склада."},{"type":"added","title":"Области доступа read:kanban, write:kanban, read:agents","description":"Выдаются ключу в «Настройки → API» вместе с остальными правами."}]},{"version":"1.1.0","apiVersion":"2026-09-15","date":"2026-09-17","title":"MCP-сервер и слой адаптеров агента","changes":[{"type":"added","title":"MCP-сервер: POST /api/mcp (Streamable HTTP, JSON-RPC 2.0)","description":"18 инструментов собираются из реестра эндпоинтов, поэтому не расходятся с REST. Авторизация — тот же ключ rk_live_/rk_test_, права проверяются на каждом вызове. По умолчанию сервер выключен: включение — «Настройки → API»."},{"type":"added","title":"Слой адаптеров агента: hermes_local и hermes_gateway","description":"Единый контракт запуска прогона (AdapterExecutionContext → AdapterExecutionResult) с событиями прогона, сессиями и проверкой окружения. Реестр изменяемый: внешний транспорт подключается регистрацией, без правки типов."},{"type":"added","title":"Новые области доступа: доска, агенты, операции, журнал","description":"read:kanban, write:kanban, write:dashboards, read:agents, write:agents, run:ops, read:audit, adapter:control."},{"type":"changed","title":"Инструменты изменения данных включаются отдельным флагом","description":"По умолчанию агент получает только чтение; цены, склад и интеграции открываются осознанно и требуют Idempotency-Key."}]},{"version":"1.0.0","apiVersion":"2026-09-15","date":"2026-09-16","title":"Первая публичная версия API","changes":[{"type":"added","title":"Ресурсы: заведения, меню, чеки, персонал, склад, дашборды, интеграции, AI","description":"22 операции под префиксом /api/v1 с пагинацией курсором, фильтрами и сортировкой."},{"type":"added","title":"Ключи доступа rk_live_ / rk_test_ с областями прав","description":"Ключ хранится хэшем, показывается один раз, отзывается и вращается в «Настройки → API»."},{"type":"added","title":"Лимит запросов и заголовки X-RateLimit-*","description":"100 запросов в минуту на ключ, всплеск до 20 в секунду, 429 с Retry-After."},{"type":"added","title":"Идемпотентность POST через Idempotency-Key","description":"Повтор с тем же телом возвращает прежний ответ, с другим — 409."},{"type":"added","title":"Вебхуки: dish.updated, check.created, stock.low","description":"Подпись X-Rkdash-Signature, три попытки доставки, журнал в панели и через API."},{"type":"added","title":"OpenAPI 3.1, документация и SDK","description":"Спецификация собирается из Zod-схем: /api/v1/openapi, страница /docs/api, пакеты @rkdash/api и rkdash (Python)."},{"type":"added","title":"Ошибки в формате RFC 7807","description":"application/problem+json с полями type, title, status, detail, instance, code, requestId."}]}],"meta":{"currentVersion":"1.3.0","apiVersion":"2026-09-15","semverPolicy":"Мажор — ломающие изменения (новый путь /api/v2), минор — новые поля и маршруты, патч — исправления."}}