# 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]
Variables와 Memory 사용 시기
| 사용 사례 | 사용 |
|----------|-----|
| 사용자 이름, 선호도 | Memory (검색 가능, 구조화) |
| 마지막 세션 타임스탬프 | Variable (임시 상태) |
| 카운터 (예: 전송된 메시지) | Variable (빈번한 업데이트) |
| 워크플로우 상태 ("5단계 중 3단계 완료") | Variable (일시적) |
| 긴 형식의 프로젝트 노트 | Memory (전문 인덱싱) |
| 재사용 가능한 스크립트 | Script store (이름 지정, 버전 관리) |
일반적인 패턴
마지막 세션 추적
[CODE BLOCK]
카운터 패턴
[CODE BLOCK]
기능 플래그
[CODE BLOCK]
다음 단계
- Memory API — 구조화되고 검색 가능한 데이터용
- Cron 및 Scheduler