Files
agentik/storage-inmemory
subochev 5f0e0da361 feat(client): client-side caching for conversation list via agent.outbox events
Adds `agent.conversationStore` (read-only view on `conversation` table) to
the :proto Agent interface, plus `agent.renameConversation(id, title?)`
command. Client-side cache in :client is built from a snapshot
(`remote.listFlow(0)` → `local.upsert(...)`) + live updates via
`outbox.agentEvents()` (Created/Deleted/Renamed/Touched).

Changes:
- :journal-api — split `ConversationStore` (read-only: get/list) and
  `MutableConversationStore` (CRUD: upsert/delete/rename/touch);
  `ConversationStore` gained `listFlow` (cold-flow paging via `list`).
- :outbox-api — `AgentEvent.Touched(date, id, updatedAt)` event so
  client cache stays fresh after `send()` (which bumps `updatedAt`).
- :proto.Agent — added `conversationStore: ConversationStore` property,
  added `renameConversation(id, title?): Instant?` command, removed
  `getConversations(offset, limit)` (now: `conversationStore.list(...)`).
- :server — `GET /conversations` now returns `List<ConversationRecord>`
  (lightweight metadata, no handle/image-support flags); `PATCH
  /conversations/{id}` uses `agent.renameConversation` and returns
  the updated `ConversationRecord`.
- :journal-inmemory — expanded targets to jvm+macos+linux+mingw (matches
  :client); moved `InMemoryMutableConversationStore` here from
  :storage-inmemory so :client can use it without pulling ios targets.
- :storage-inmemory — depends on :journal-inmemory.
- :storage-ksqlite — pre-staged rename `KsqliteConversationStore` →
  `KsqliteMutableConversationStore` to match the new interface split.
- :standalone — `ChatAgent` exposes `conversationStore` as a read-only
  view of its `mutableConversationStore`; emits `AgentEvent.Touched`
  after each `send()` (after `conversationStore.touch(id, ts)`).
- :client — new `HttpConversationStore` (read-only HTTP impl);
  `AgentikAgent` wraps the agent with `wrapWithLocalConversationCache`
  so the client sees an in-memory cache (snapshot + outbox events)
  instead of direct HTTP. Cache scope + HttpClient + background job
  all cancelled in `agent.close()`.
- :client/README — new «Кэш списка бесед» section with the
  `listFlow → upsert` / `agentEvents → apply` pattern and a note that
  `conversationStore` is read-only (writes only via Agent commands).

All 96 jvmTest tasks green.
2026-09-22 05:21:01 +03:00
..

:storage-inmemory — in-memory реализация :storage-core (KMP, jvm + native)

Что это

In-memory реализация MessageStore / WorkingMemoryStore / ConversationStore / ReflectionStore. Все структуры держит в ConcurrentHashMap + MutableList, фолотится на RAM (никаких файлов).

Решает: дешёвая тестовая среда без поднятия SQLite. Позволяет прогонять ChatAgentTest за миллисекунды и держать сценарии детерминированными.

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

  • В тестах :standalone (AbstractITTest).
  • В Android-имплементации (in-memory + Android-database микс).
  • В любых юнит-тестах на агенте.

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

commonMain.dependencies {
    api("pw.binom.agentik:storage-inmemory:0.1.0")
    api("pw.binom.agentik:storage-core:0.1.0")
}

val storage = InMemoryStorageSystem()
val messages: MessageStore = storage.messages
val working: WorkingMemoryStore = storage.working

Версии

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

Тесты

./gradlew :storage-inmemory:allTests

Покрывают (через общие contract-tests): round-trip, paged flow, concurrent appends, working-memory replay, очистку.

Чего здесь НЕТ

  • Никакого persistence. Перезапуск процесса — данные пропали. Это нормально для тестов и Android in-memory.

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

Используется продакшеном (в режиме тестов). Контракт-совместима с :storage-sqlite 1:1 — переключение AGENTIK_STORAGE_BACKEND=memory в :standalone.