# Variables API
SUMMARY: Key-value store cepat untuk state LLM — penghitung, flag, timestamp terakhir dilihat, kemajuan parsial.

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
Variables API adalah key-value store cepat untuk state efemeral. Berbeda
dengan memori (yang diindeks, dapat dicari, dan terstruktur), variabel
dioptimalkan untuk akses baca/tulis cepat — sempurna untuk penghitung, flag,
dan state sesi.
Endpoint
POST /var
Menetapkan atau memperbarui variabel.
[CODE BLOCK]
GET /var/:key
Mengambil satu variabel.
[CODE BLOCK]
Respons:
[CODE BLOCK]
GET /var
Mendaftar semua variabel.
[CODE BLOCK]
DELETE /var/:key
Menghapus variabel.
[CODE BLOCK]
Kapan Menggunakan Variabel vs Memori
| Kasus Penggunaan | Gunakan |
|----------|-----|
| Nama pengguna, preferensi | Memori (dapat dicari, terstruktur) |
| Timestamp sesi terakhir | Variabel (state efemeral) |
| Penghitung (mis. pesan terkirim) | Variabel (pembaruan sering) |
| State alur kerja ("langkah 3 dari 5 selesai") | Variabel (sementara) |
| Catatan proyek panjang | Memori (diindeks teks penuh) |
| Skrip yang dapat digunakan kembali | Penyimpanan skrip (diberi nama, diberi versi) |
Pola Umum
Lacak sesi terakhir
[CODE BLOCK]
Pola penghitung
[CODE BLOCK]
Feature flags
[CODE BLOCK]
Langkah Berikutnya
- Memory API — untuk data terstruktur yang dapat dicari
- Cron & Scheduler