# Variables API
SUMMARY: Szybki magazyn klucz-wartość dla stanu LLM — liczniki, flagi, znaczniki ostatniego wyświetlenia, częściowe postępy.

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 jest szybkim magazynem klucz-wartość dla stanu efemerycznego. W
przeciwieństwie do wspomnień (które są indeksowane, przeszukiwalne i
ustrukturyzowane), zmienne są zoptymalizowane pod kątem szybkiego odczytu i
zapisu — idealne dla liczników, flag i stanu sesji.
Endpointy
POST /var
Ustawia lub aktualizuje zmienną.
[CODE BLOCK]
GET /var/:key
Pobiera pojedynczą zmienną.
[CODE BLOCK]
Odpowiedź:
[CODE BLOCK]
GET /var
Lista wszystkich zmiennych.
[CODE BLOCK]
DELETE /var/:key
Usuwa zmienną.
[CODE BLOCK]
Kiedy używać zmiennych, a kiedy pamięci
| Przypadek użycia | Wybór |
|----------|-----|
| Imię użytkownika, preferencje | Pamięć (przeszukiwalne, ustrukturyzowane) |
| Znacznik czasu ostatniej sesji | Zmienna (stan efemeryczny) |
| Licznik (np. wysłane wiadomości) | Zmienna (częste aktualizacje) |
| Stan przepływu pracy („krok 3 z 5 ukończony") | Zmienna (przejściowy) |
| Długie notatki projektowe | Pamięć (indeksowane pełnotekstowo) |
| Skrypty wielokrotnego użytku | Magazyn skryptów (nazywane, wersjonowane) |
Typowe wzorce
Śledzenie ostatniej sesji
[CODE BLOCK]
Wzorzec licznika
[CODE BLOCK]
Flagi funkcji
[CODE BLOCK]
Następne kroki
- Memory API — dla ustrukturyzowanych, przeszukiwalnych danych
- Cron i Scheduler