# API de Variáveis
SUMMARY: Armazenamento key-value rápido para estado de LLM — contadores, flags, timestamps de última atividade, progresso 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 Variáveis
A API de Variáveis é um armazenamento key-value rápido para estado efêmero.
Diferente das memórias (que são indexadas, pesquisáveis e estruturadas), as
variáveis são otimizadas para acesso rápido de leitura/escrita — perfeitas para
contadores, flags e estado de sessão.
Endpoints
POST /var
Define ou atualiza uma variável.
[CODE BLOCK]
GET /var/:key
Obtém uma única variável.
[CODE BLOCK]
Resposta:
[CODE BLOCK]
GET /var
Lista todas as variáveis.
[CODE BLOCK]
DELETE /var/:key
Exclui uma variável.
[CODE BLOCK]
Quando usar Variáveis vs Memória
| Caso de uso | Use |
|-------------|-----|
| Nome do usuário, preferências | Memória (pesquisável, estruturada) |
| Timestamp da última sessão | Variável (estado efêmero) |
| Contador (ex.: mensagens enviadas) | Variável (atualizações frequentes) |
| Estado de workflow ("passo 3 de 5 concluído") | Variável (transitório) |
| Notas longas de projeto | Memória (indexada em texto completo) |
| Scripts reutilizáveis | Armazenamento de scripts (nomeados, versionados) |
Padrões comuns
Rastrear última sessão
[CODE BLOCK]
Padrão de contador
[CODE BLOCK]
Feature flags
[CODE BLOCK]
Próximos passos
- API de Memória — para dados estruturados e pesquisáveis
- Cron & Agendador