# Variables API
SUMMARY: Быстрое key-value хранилище для состояния 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 — это быстрое key-value хранилище для эфемерного состояния. В отличие
от воспоминаний (которые индексируются, доступны для поиска и структурированы),
переменные оптимизированы для быстрого чтения/записи — идеально для счётчиков,
флагов и состояния сессии.
Эндпоинты
POST /var
Установить или обновить переменную.
[CODE BLOCK]
GET /var/:key
Получить одну переменную.
[CODE BLOCK]
Ответ:
[CODE BLOCK]
GET /var
Получить список всех переменных.
[CODE BLOCK]
DELETE /var/:key
Удалить переменную.
[CODE BLOCK]
Когда использовать переменные, а когда — память
| Сценарий | Использовать |
|----------|-----|
| Имя пользователя, предпочтения | Память (поиск, структура) |
| Временная метка последней сессии | Переменная (эфемерное состояние) |
| Счётчик (например, отправлено сообщений) | Переменная (частые обновления) |
| Состояние рабочего процесса («выполнен шаг 3 из 5») | Переменная (переходящее) |
| Длинные заметки по проекту | Память (полнотекстовая индексация) |
| Повторно используемые скрипты | Хранилище скриптов (именованные, версии) |
Типовые паттерны
Отслеживание последней сессии
[CODE BLOCK]
Паттерн счётчика
[CODE BLOCK]
Флаги функций
[CODE BLOCK]
Следующие шаги
- Memory API — для структурированных, доступных для поиска данных
- Cron и планировщик