covel

Covel — модульный агентный ИИ-фреймворк для ролевых игр и интерактивная студия. Архитектура разделяет ядро (планирование, сбор контекста, инструменты, валидация, сохранение, рендеринг), плагинные пакеты (игровое поведение: агентные и функциональные рантаймы, UI, схемы, инструменты, события, проекции и хуки жизненного цикла) и переносимые пакеты миров (лор, персонажи, правила, значения по умолчанию для плагинов, блоки памяти, квесты, предметы, портреты и сцены). Включены два режима игры: Stage — полноэкранная визуальная новелла с фоновыми сценами, спрайтами персонажей, эффектом печатной машинки для диалогов, оверлеями выбора и генерацией фонов по запросу для новых локаций; Story — текстовый режим с нарративными ходами, предложенными действиями, встроенными формами и таймлайном агентов на каждый ход. Плагины — это пакеты возможностей, а не фиксированные роли. Среди встроенных примеров: агентные рантаймы narrator, codex и core-quest; функциональные рантаймы pregame, dice-check/roller и scene-cast; смешанные пакеты npc-graph и генерации изображений; хуки жизненного цикла cost-gate, story-guard и director; UI- и данные-контракты memory, character-blueprint и character-presence. Ядро обнаруживает возможности и outputKind без ветвления по конкретным ID плагинов, поэтому компоненты остаются заменяемыми. Встроенные RPG-механики включают предварительные проверки кубиков с видимыми арифметическими расчётами, автоматически отслеживаемый журнал квестов, управляемый игроком инвентарь и шкалы симпатии для каждого НПС; все они являются необязательными плагинами, а миры могут задавать стартовые квесты, начальное снаряжение и начальную симпатию. После каждого хода общая проекция фактов WorldIR позволяет плагинам квестов, инвентаря, симпатии, кодекса и отношений повторно использовать одни и те же данные. Пакеты миров объявляются через world.yaml, WORLD.md и импорты WorldData; pluginPolicy может отмечать плагины как обязательные, рекомендуемые или исключённые, а memoryBlocks могут добавлять память, специфичную для жанра, например улики или журналы сигналов. Фреймворк поставляется с UI-каталогами zh-CN, en-US и ru-RU и поддерживает локализованные инструкции плагинов, файлы миров, данные персонажей и правила с откатом к каноническим источникам. Trace Inspector группирует выполнение по сессиям и ходам, показывая рантаймы, потоки, запросы к LLM, инструменты, сообщения, состояние и события хуков, а также представления Session Data и Cost. Хранение локальное по умолчанию: SQLite на диске. В веб-режиме API-ключи сохраняются в localStorage браузера, а в настольном режиме — в виде открытого текста в ~/.covel/keys.env. Проект предоставляет настольные сборки для macOS Apple Silicon и Windows x64, а исходный код запускается через pnpm с целями web и server. Среди встроенных пакетов миров: Mistport Chronicles, Haruka Academy и Emberback Relay. Авторы могут создать пакет мира через AI Create World flow или сгенерировать каркас плагина через create-plugin. Текущий выпуск v0.0.32 находится на этапе раннего доступа, а API, данные миров и манифесты плагинов могут меняться между версиями. Проект распространяется под лицензией MIT, а функции community hub и маркетплейса запланированы в дорожной карте.