# Variables API
SUMMARY: Швидке сховище ключ-значення для стану LLM — лічильники, прапорці, мітки часу останнього бачення, частковий прогрес.

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 — це швидке сховище ключ-значення для ефемерного стану. На відміну
від спогадів (які індексуються, доступні для пошуку та структуровані), змінні
оптимізовані для швидкого читання/запису — ідеально для лічильників, прапорців та
стану сесії.
Кінцеві точки
POST /var
Встановити або оновити змінну.
[CODE BLOCK]
GET /var/:key
Отримати одну змінну.
[CODE BLOCK]
Відповідь:
[CODE BLOCK]
GET /var
Список усіх змінних.
[CODE BLOCK]
DELETE /var/:key
Видалити змінну.
[CODE BLOCK]
Коли використовувати змінні, а коли пам'ять
| Варіант використання | Використовувати |
|----------|-----|
| Ім'я користувача, уподобання | Memory (доступно для пошуку, структуровано) |
| Мітка часу останньої сесії | Variable (ефемерний стан) |
| Лічильник (напр. надіслані повідомлення) | Variable (часті оновлення) |
| Стан робочого процесу («крок 3 з 5 виконано») | Variable (перехідний) |
| Розгорнуті нотатки про проєкт | Memory (повнотекстовий індекс) |
| Багаторазові скрипти | Script store (іменовані, версіоновані) |
Типові шаблони
Відстеження останньої сесії
[CODE BLOCK]
Шаблон лічильника
[CODE BLOCK]
Прапорці функцій
[CODE BLOCK]
Наступні кроки
- Memory API — для структурованих даних, придатних для пошуку
- Cron та планувальник