---
title: "Una: el agente escribe, Una verifica"
url: https://una-lang.org/es/
release: v0.4.0
---

# Una

> Tu agente de IA escribe el código. Una prueba que cumple sus contratos antes de ejecutarlo. Un lenguaje con autoridad declarada y salida en JSON para agentes.

El agente escribe. Una verifica.

Tu agente escribe el código. Una prueba el contrato declarado de cada función para toda entrada, o muestra la entrada que lo rompe; lo que no puede decidir es un error, nunca una aprobación. Lo que una función puede tocar, como archivos, la red o datos sensibles, también está en la cabecera.

## Una vuelta del ciclo

1. El agente escribe. Tu agente escribió esta función. Se lee bien, y una prueba con 5 o 50 artículos pasaría.

```una
pub kind Availability = SoldOut | Few | Open

--- How much of an item is left to sell.
pub availability(remaining: Int) -> Availability
  requires remaining >= 0
  ensures remaining == 0 implies result is SoldOut
=
  if remaining < 20 then Few else Open
```

2. Una refuta.

```text
$ una check stock.una   # trimmed
[U5001] postcondition of `availability` is refuted
counterexample: remaining = 0, result = Few
repair 1: add a guard or an arm so that the failing path returns a value for which `remaining == 0 implies result is SoldOut` holds
```

3. El agente repara. El agente aplica la reparación 1: una guarda para la entrada que señala el contraejemplo.

```una
  if remaining == 0 then SoldOut else if remaining < 20 then Few else Open
```

4. Probado. Nada impreso, salida 0. La promesa ahora vale para todo `remaining >= 0`, no solo para las entradas que probó un test.

```text
$ una --json check stock.una
{"schema":"una.diagnostics/1","diagnostics":[],"fixable":0}
```

Una prueba que el código corresponde a lo que declaraste. Declarar lo correcto sigue siendo tarea tuya.

## Lo que Una comprueba, y lo que te dice que no comprobó.

- Contratos: Las precondiciones, las poscondiciones y los tipos refinados se prueban antes de que el programa se ejecute. Una prueba que falla, o que el probador no logra terminar, es un error y nunca un éxito.
- Autoridad: Cada función pública declara las capacidades y operaciones que usa, y Una infiere y comprueba las demás. Un programa solo recibe autoridad del host mediante concesiones: las que declara su paquete y las dadas en la línea de comandos para una ejecución.
- Flujo de información: Las etiquetas siguen a los datos a través de asignaciones y condiciones. Un valor etiquetado como secreto solo llega a un lugar menos restringido mediante una política declarada, que el informe de compilación lista.
- Interfaz para agentes: Cada comando, salvo el servidor de lenguaje, devuelve JSON con un esquema: códigos de diagnóstico, posiciones exactas y, cuando existen, reparaciones ordenadas que un agente puede aplicar.

## Empieza desde donde estás.

```sh
curl -fsSL https://raw.githubusercontent.com/una-lang/una/main/install.sh | sh
export PATH="$HOME/.una/bin:$PATH"
una explain U5001
```

- [En cinco minutos: Instala Una, escribe un contrato, míralo fallar, arréglalo.](https://una-lang.org/en/docs/get-started.md)
- [Con tu agente: Dale a tu agente el lenguaje en una página y el ciclo que debe ejecutar.](https://una-lang.org/en/docs/agents/compact.md)
- [Desde el principio: Una by Example: programas pequeños y completos, una idea por página.](https://una-lang.org/en/learn.md)
- [Guía del lenguaje](https://una-lang.org/en/docs/language.md)
- [Diagnósticos](https://una-lang.org/en/docs/errors.md)

Una es una beta de investigación y no está lista para producción. Los comentarios son bienvenidos.
