# API de Variables
SUMMARY: Almacén rápido clave-valor para estado de LLM — contadores, flags, timestamps de última actividad, progreso parcial.

KEY CONTEXT:
Auth: Mind Key
Set: POST /var { key, value }
Get: GET /var/:key
List: GET /var
Delete: DELETE /var/:key
Use case: store last-seen timestamps, counters, flags, partial workflow state
Faster than memory (PostgreSQL direct, no FTS5 indexing)
Not for: structured facts (use /memory), long content (use /script)

API de Variables
La API de Variables es un almacén rápido clave-valor para estado efímero. A
diferencia de las memorias (que están indexadas, son buscables y estructuradas),
las variables están optimizadas para acceso rápido de lectura/escritura —
perfectas para contadores, flags y estado de sesión.
Endpoints
POST /var
Establece o actualiza una variable.
[CODE BLOCK]
GET /var/:key
Obtiene una variable individual.
[CODE BLOCK]
Respuesta:
[CODE BLOCK]
GET /var
Lista todas las variables.
[CODE BLOCK]
DELETE /var/:key
Elimina una variable.
[CODE BLOCK]
Cuándo usar Variables vs Memory
| Caso de uso | Usar |
|----------|-----|
| Nombre, preferencias | Memory (buscable, estructurado) |
| Timestamp de última sesión | Variable (estado efímero) |
| Contador (p. ej. mensajes enviados) | Variable (actualizaciones frecuentes) |
| Estado de workflow ("paso 3 de 5 completado") | Variable (transitorio) |
| Notas largas de proyecto | Memory (indexado de texto completo) |
| Scripts reutilizables | Script store (con nombre, versionado) |
Patrones comunes
Seguimiento de la última sesión
[CODE BLOCK]
Patrón contador
[CODE BLOCK]
Feature flags
[CODE BLOCK]
Próximos pasos
- API de Memory — para datos estructurados y buscables
- Cron y Scheduler