beeuni.toml heredado

Estado del soporte y ruta de migración de beeuni.toml v1 a beeuni.yaml v2.

Esta página trata el manifiesto v1 (beeuni.toml, beeuni_version: 1). Para consultar el manifiesto actual, ve a Referencia del manifiesto.

Estado de compatibilidad

Beeuni sigue admitiendo manifiestos v1. La plataforma busca el manifiesto de un proyecto en este orden: beeuni.yaml, luego beeuni.yml y, por último, beeuni.toml. El iniciador actual crea un beeuni_version: 2 beeuni.yaml. Los proyectos v1 siguen funcionando sin que se les obligue a actualizar.

v1 admite sintaxis TOML o YAML. La versión 2 solo admite YAML. Un manifiesto v2 escrito en TOML no supera la validación.

Migrar a v2

Crea beeuni.yaml en la raíz del repositorio. Define beeuni_version: 2.

Convierte [[agents]] en un mapa de agents:, con el nombre del agente como clave.

Cambia el campo env de cada agente por secrets. Enumera todos los secretos que necesita el agente: v2 no concede acceso a secretos de forma predeterminada.

Añade default_agent e indica el agente que se ejecuta de forma predeterminada.

Elimina [[channels]]. Vuelve a conectar cada canal desde el panel.

Si usas [sandbox] o [[sandboxes]], mueve cada definición de imagen bajo sandbox.templates.

Ejecuta beeuni validate contra beeuni.yaml. Corrige los errores que indique.

Elimina beeuni.toml.

El comportamiento del agente —el prompt del sistema, model, mode, temperature y más— nunca se mueve. Ya está en el frontmatter .md de cada agente, bajo .beeuni/opencode/agents/, tanto en v1 como en v2. Consulta Agentes.

Comprueba el resultado con beeuni validate --file beeuni.yaml. Obtén el esquema v2 completo con beeuni schema --version 2. Consulta la Referencia de la CLI para ambos comandos.

Diferencias clave

v1 (`beeuni_version: 1`)	v2 (`beeuni_version: 2`)	Cambio
`[[agents]]` (matriz)	`agents:` (mapa con el nombre como clave)	Convierte cada elemento de la matriz en una entrada del mapa.
`[[agents]].env`	`agents.<name>.secrets`	Se cambió el nombre. El valor predeterminado cambia de `all` a `none`; consulta la nota siguiente.
`[[agents]].model`	eliminado	No tenía efecto en v1 (se analizaba, pero nunca se aplicaba). El comportamiento del agente siempre proviene del frontmatter `.md` del agente.
`[[agents]].file`	`agents.<name>.file`	No tenía efecto en v1 (se analizaba, pero nunca se aplicaba). En v2, indica el `.md` del agente.
sin `default_agent`	`default_agent` (obligatorio)	Debe indicar un agente declarado y habilitado.
`[[channels]]`	eliminado	El enrutamiento de canales se administra desde el panel. Un canal conectado aparece como entrada `connectors:` con `provider: channel`.
`[sandbox]` (singular, con las claves de imagen directamente en él)	`sandbox.templates` (lista)	Mueve cada imagen a una entrada de plantilla.
`[[sandboxes]]`	`sandbox.templates`	Se cambió el nombre.

En v1, se toleran por compatibilidad algunas acciones de beeuni_permissions heredadas (project.session.exec, project.gateway.routing.edit, project.schedule.read, project.schedule.write, project.webhook.read, project.webhook.write, channel.read, channel.connect, channel.send, channel.disconnect): la plataforma muestra una advertencia, pero las permite. En v2, esas mismas acciones generan un error. Elimínalas de las concesiones de beeuni_permissions de cualquier agente antes de migrar.