# `:storage-sqlite` — SQLite реализация `:storage-core` (JVM-only)

## Что что это

Production persistence для `:standalone` на [SQLDelight](https://cashapp.github.io/sqldelight/):

- **messages** — append-only журнал с `conversation_id`, `created_at`.
- **working_memory** — rolling buffer последних 100 entries, типы
  в JSON (`UserMessage / AssistantMessage / ToolExchange / SystemPrompt`).
- **conversations** — метаданные (id, title, model, timestamps).
- **reflections** — произвольные заметки ("I notice you often
  prefer short replies").
- Промпт хранителя (`@mem0`) индексирован отдельно для быстрого
  доступа.

Решает: стабильная, локальная, нулевая-настройка БД. Подходит и для
desktop-продакшена, и для Android, и для тестов (через Testcontainers).

## Где используется

- `:standalone` подключает по умолчанию (`storage.db` = путь из
  `AGENTIK_DB_PATH`).

## Как подключить

```kotlin
jvmMain.dependencies {
    implementation("pw.binom.agentik:storage-sqlite:0.1.0")
    implementation("pw.binom.agentik:storage-core:0.1.0")
}

val storage = SqliteStorageSystem.open(Path("agentik.db"))
val messages: MessageStore = storage.messages
```

## Версии

`gradle/libs.versions.toml` → `[versions] agentik-storage-sqlite`.

Зависит от `app.cash.sqldelight:sqlite-driver:2.1.0` (через
`gradle/libs.versions.toml`).

## Тесты

```
./gradlew :storage-sqlite:jvmTest
```

Покрывают: миграции (через `migrations/` каталог и SQLDelight
`*.sqm`), round-trip, race-conditions (concurrent append), paged
flow.

## Что в схеме (упрощённо)

```sql
CREATE TABLE messages (
    id TEXT PRIMARY KEY,
    conversation_id TEXT NOT NULL,
    created_at TEXT NOT NULL,  -- ISO Instant
    kind TEXT NOT NULL,        -- 'user', 'assistant', 'tool_call', 'tool_result'
    body_json TEXT NOT NULL
);
CREATE INDEX idx_messages_conv_time ON messages(conversation_id, created_at);

CREATE TABLE working_memory (
    conversation_id TEXT NOT NULL,
    entry_id TEXT PRIMARY KEY,
    created_at TEXT NOT NULL,
    kind TEXT NOT NULL,
    body_json TEXT NOT NULL
);
```

Полная схема + миграции — в `src/jvmMain/sqldelight/`.

## Текущий статус

Используется продакшеном. Миграции 1.0+.