covel

Covel es un marco de juego de rol de IA agente modular y un estudio jugable. Su arquitectura separa el kernel (planificación, ensamblaje de contexto, herramientas, validación, persistencia, renderizado), paquetes de plugin (comportamiento de juego como runtimes de agente y función, UI, esquemas, herramientas, eventos, proyecciones y ganchos de ciclo de vida), y paquetes de mundo portátiles (lore, personajes, reglas, valores predeterminados de plugin, bloques de memoria, misiones, objetos, retratos y escenas). Se incluyen dos modos de juego: el modo Escenario es una novela visual de pantalla completa con fondos de escena, sprites de personajes, diálogo de máquina de escribir, superposiciones de opciones y generación de fondos bajo demanda para nuevas ubicaciones; el modo Historia es basado en texto con turnos narrados, acciones sugeridas, formularios en línea y una línea de tiempo de agente por turno. Los plugins son paquetes de capacidad en lugar de roles fijos. Los ejemplos incluidos son runtimes de agente como narrador, codex y core-quest; runtimes de función como pregame, dice-check/roller y scene-cast; paquetes mixtos como npc-graph y generación de imágenes; ganchos de ciclo de vida como cost-gate, story-guard y director; y contratos de UI o datos como memory, character-blueprint y character-presence. El kernel descubre capacidades y outputKind sin ramificar en IDs de plugin concretos, por lo que los componentes permanecen reemplazables. Las mecánicas de RPG integradas incluyen tiradas de dados pre‑lanzadas con recibos de aritmética visibles, un registro de misiones auto‑rastreado, inventario gestionado por el jugador y medidores de afinidad por NPC; todos son plugins opcionales y los mundos pueden sembrar misiones iniciales, equipo de inicio y afinidad inicial. Después de cada turno, una proyección de hechos WorldIR compartida permite que las plugins de misiones, inventario, afinidad, codex y relación reutilicen la misma evidencia. Los paquetes de mundo se declaran mediante world.yaml, WORLD.md e importaciones de WorldData; pluginPolicy puede marcar plugins como requeridos, recomendados o excluidos, y memoryBlocks puede añadir memoria específica de género como pistas o registros de señal. El framework incluye catálogos de UI zh-CN, en-US y ru-RU y admite instrucciones de plugin localizadas, archivos de mundo, datos de personajes y reglas con respaldo a fuentes canónicas. Un Inspector de Traza agrupa la ejecución por sesión y turno, exponiendo runtimes, flujos, solicitudes LLM, herramientas, mensajes, estado y eventos de gancho, además de vistas de Datos de Sesión y Coste. El almacenamiento es local‑primero con SQLite en disco; el modo Web mantiene las claves de API en el localStorage del navegador, mientras que el modo de escritorio las guarda como texto plano en ~/.covel/keys.env. El proyecto proporciona compilaciones de escritorio para macOS Apple Silicon y Windows x64, y el código fuente se ejecuta mediante pnpm con objetivos web y servidor. Los paquetes de mundo incluidos son Mistport Chronicles, Haruka Academy y Emberback Relay. Los autores pueden generar un paquete de mundo con el flujo AI Create World o esqueleto de plugins con create-plugin. La versión actual v0.0.32 es acceso temprano, y las APIs, los datos de mundo y los manifiestos de plugin pueden cambiar entre versiones. El proyecto está licenciado bajo MIT y las funciones de centro comunitario y mercado están en la hoja de ruta.