# Variables API
SUMMARY: Key-value store veloce per stato LLM — contatori, flag, timestamp ultimo accesso, avanzamento parziale.

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)

Variables API
La Variables API è un key-value store veloce per stato effimero. A differenza
delle memorie (che sono indicizzate, ricercabili e strutturate), le variabili
sono ottimizzate per accesso rapido in lettura/scrittura — perfette per
contatori, flag e stato di sessione.
Endpoint
POST /var
Imposta o aggiorna una variabile.
[CODE BLOCK]
GET /var/:key
Ottiene una singola variabile.
[CODE BLOCK]
Risposta:
[CODE BLOCK]
GET /var
Elenca tutte le variabili.
[CODE BLOCK]
DELETE /var/:key
Elimina una variabile.
[CODE BLOCK]
Quando usare le variabili rispetto alla memoria
| Caso d'uso | Usi |
|----------|-----|
| Nome utente, preferenze | Memoria (ricercabile, strutturata) |
| Timestamp ultima sessione | Variabile (stato effimero) |
| Contatore (es. messaggi inviati) | Variabile (aggiornamenti frequenti) |
| Stato workflow ("passo 3 di 5 fatto") | Variabile (transiente) |
| Note di progetto lunghe | Memoria (indicizzata full-text) |
| Script riutilizzabili | Script store (nominati, versionati) |
Modelli comuni
Traccia l'ultima sessione
[CODE BLOCK]
Modello contatore
[CODE BLOCK]
Feature flag
[CODE BLOCK]
Prossimi passi
- Memory API — per dati strutturati e ricercabili
- Cron & Scheduler