subochev
15f3952eba
ci / JVM build + tests (push) Successful in 6m15s
Выделяет append-only message log в отдельный KMP-модуль.
Цель — разделить ДВЕ сущности по своей природе:
:message-log-api — append-only audit log (User/Assistant/ToolCall/
ToolResult/Error). Никаких update, только insert + read.
Это иммутабельная история диалога.
:working-memory-api — mutable runtime context (compact, summary, WM order).
Live state. Compaction-логика.
Раньше оба жили в :message-store-api, что:
- смешивало контракты: append-only audit vs mutable runtime;
- делало невозможным лёгкого клиента который читает только audit log
без WM-runtime зависимости;
- затрудняло compaction-логике жить в одном модуле с audit-записью.
Миграция:
- В :message-log-api переехали: Content, MessageRecord, MessageStore,
MessageContext (с MessageOrigin), MessageEvent, TokenStats, TurnTokens,
helpers (encode/decodeBodyPayload, MessageBodyPayload, BodyDecoded).
Пакет pw.binom.agentik.messageLog.
- В :message-store-api остались: ConversationStore, ConversationRecord,
ReflectionStore, Ids, legacy events.EventStore (paginated replay).
Пакет pw.binom.agentik.messageStore.
- :working-memory-api: обновил deps (api → :message-log-api для Content/MessageContext).
- 23 consumer-файла обновлены (FQN renames).
- storage-sqlite/ksqlite: убраны недостижимые ветки Summary/System
(эти synthetic records живут ТОЛЬКО в :working-memory-api, не попадают
в audit log :message-log-api).
Файлы:
+ :message-log-api (5 файлов, ~280 строк)
- :message-store-api (5 файлов, ~430 строк)
~ 23 файла обновлены
Совместимость схем не меняется. Все 5 storage impl'ов (3 backend × 5 store)
работают на тех же таблицах.
:storage-sqlite — SQLite реализация :storage-core (JVM-only)
Что что это
Production persistence для :standalone на 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).
Как подключить
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.
Что в схеме (упрощённо)
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+.