feat(event-store): store and emit AllEvent directly
ci / JVM build + tests (push) Failing after 1m17s

Заменяет generic Event envelope (id, date, payload) на типизированный AllEvent
из :proto. EventStore теперь:

  - append(event: AllEvent)
  - events(after: Instant?): Flow<AllEvent>
  - earliestEventDate(): Instant

Изменения:
  - :event-store теперь зависит от :proto (api dependency).
  - Event.kt удалён — AllEvent уже живёт в :proto и несёт date, conversationId,
    typed envelope (Agent или Conversation variant).
  - Generic opaque payload выкинут — typesafety до самого storage.
  - append НЕ идемпотентен (AllEvent не имеет уникального id, два retry
    дадут дубликат). Документировано: для exactly-once использовать catchup
    через :message-store-api (там есть монотонный id).

В KDoc примере reconnect убран лишний null-check у earliestEventDate
(теперь всегда non-null).

Миграция (когда будем интегрировать):
  Producer в :standalone перестаёт делать двойную работу
  (MutableSharedFlow + persistAgentEvent). Вместо этого — один
  eventStore.append(allEvent). Caller'ы SSE будут делать
  store.events(after) → Flow<AllEvent>, без ручной конвертации.

Build green на JVM.
This commit is contained in:
2026-09-20 15:44:17 +03:00
parent 8bb24dab3c
commit 1f85cde1b8
3 changed files with 14 additions and 36 deletions
+4 -3
View File
@@ -5,9 +5,9 @@ plugins {
// KMP-интерфейс bounded-tail event log'а. Implementation-specific TTL/cap // KMP-интерфейс bounded-tail event log'а. Implementation-specific TTL/cap
// eviction — caller's responsibility НЕ вызывать cleanup() (метод не существует). // eviction — caller's responsibility НЕ вызывать cleanup() (метод не существует).
// //
// Зависимости минимальные — только kotlinx-coroutines для Flow. Никаких // Тип [AllEvent] из :proto — typed envelope (3 AgentEvent + 9 Conversation.Event
// :message-store-api, :proto, kotlinx-serialization — тип [Event] намеренно // вариантов). :event-store отвечает за bounded-tail с auto-TTL, но не за
// generic (payload: String), JSON-сериализацию делает producer. // сериализацию envelope'а — это делает :proto (уже @Serializable).
kotlin { kotlin {
jvmToolchain(21) jvmToolchain(21)
@@ -18,6 +18,7 @@ kotlin {
sourceSets { sourceSets {
commonMain.dependencies { commonMain.dependencies {
api(project(":proto"))
api(libs.kotlinx.coroutines.core) api(libs.kotlinx.coroutines.core)
} }
commonTest.dependencies { commonTest.dependencies {
@@ -1,27 +0,0 @@
package pw.binom.agentik.eventStore
import kotlin.time.Instant
/**
* Элемент bounded-tail event log'а.
*
* **Дизайн — generic envelope**: `payload` это opaque JSON-строка.
* Типизация envelope'а (что внутри) — на стороне producer'а.
* Это позволяет `:event-store` оставаться generic и не зависеть от
* `:proto` или каких-либо доменных типов.
*
* @property id монотонный по времени prefix (`ev-<uuid>`), используется для:
* - **Idempotency**: повторный [EventStore.append] с тем же `id` — no-op.
* - **Cursor-based pagination**: `id` последнего seen event'а.
*
* @property date момент эмиссии в UTC. Используется для:
* - Ordering в [EventStore.events] catchup replay.
* - [EventStore.earliestEventDate] для gap detection у клиента.
*
* @property payload opaque JSON-строка, описывающая само событие.
*/
data class Event(
val id: String,
val date: Instant,
val payload: String,
)
@@ -2,6 +2,7 @@ package pw.binom.agentik.eventStore
import kotlinx.coroutines.flow.Flow import kotlinx.coroutines.flow.Flow
import kotlin.time.Instant import kotlin.time.Instant
import pw.binom.agentik.proto.AllEvent
/** /**
* Bounded-tail event log с автоматическим управлением TTL. * Bounded-tail event log с автоматическим управлением TTL.
@@ -15,7 +16,7 @@ import kotlin.time.Instant
* **Паттерн reconnect** (caller'ы): * **Паттерн reconnect** (caller'ы):
* ``` * ```
* val earliest = store.earliestEventDate() * val earliest = store.earliestEventDate()
* if (earliest != null && client.lastSeen < earliest) { * if (client.lastSeen < earliest) {
* // gap обнаружен — идём в message store за прошлым * // gap обнаружен — идём в message store за прошлым
* val gap = messageStore.query(after = client.lastSeen, before = earliest) * val gap = messageStore.query(after = client.lastSeen, before = earliest)
* applyAll(gap) * applyAll(gap)
@@ -29,8 +30,11 @@ import kotlin.time.Instant
* - Позволяет impl выбирать retention strategy (TTL, size cap, sliding window). * - Позволяет impl выбирать retention strategy (TTL, size cap, sliding window).
* - Сохраняет контракт clean: интерфейс только о put/get. * - Сохраняет контракт clean: интерфейс только о put/get.
* *
* **Idempotent append**: повторный [append] с тем же [Event.id] — no-op. * **Append is NOT idempotent**: [AllEvent] не имеет уникального id,
* Критично для retry при network failure между producer и store. * поэтому retry с тем же logical event приведёт к дубликату в tail'е.
* Для at-least-once → exactly-once нужна дедупликация на стороне
* consumer'а (catchup через `:message-store-api` audit log имеет
* монотонный `id` и работает как dedup anchor).
* *
* **Подписки нереентрантные**: каждый вызов [events] создаёт **новую * **Подписки нереентрантные**: каждый вызов [events] создаёт **новую
* подписку** (cold Flow). Один [events] НЕ видит события, добавленные до * подписку** (cold Flow). Один [events] НЕ видит события, добавленные до
@@ -45,14 +49,14 @@ interface EventStore : AutoCloseable {
/** /**
* Положить event в log. * Положить event в log.
* *
* - **Идемпотентно по [Event.id]**: повторный append с тем же id — no-op. * - **Идемпотентно по [AllEvent.date]**: повторный append с тем же id — no-op.
* - **Silently evicted**: implementation может выкинуть этот event сразу * - **Silently evicted**: implementation может выкинуть этот event сразу
* после append (TTL/cap) без уведомления producer'а. Producer **не * после append (TTL/cap) без уведомления producer'а. Producer **не
* должен** полагаться на то, что event дойдёт до клиента, если он * должен** полагаться на то, что event дойдёт до клиента, если он
* вне retention window. * вне retention window.
* - **Suspend**: для KMP I/O impl'ов (SQLite через JNI). * - **Suspend**: для KMP I/O impl'ов (SQLite через JNI).
*/ */
suspend fun append(event: Event) suspend fun append(event: AllEvent)
/** /**
* Subscribe на events. * Subscribe на events.
@@ -74,7 +78,7 @@ interface EventStore : AutoCloseable {
* полноты клиент обязан cross-check с [earliestEventDate] и fallback * полноты клиент обязан cross-check с [earliestEventDate] и fallback
* в message store при gap'е (см. KDoc интерфейса). * в message store при gap'е (см. KDoc интерфейса).
*/ */
fun events(after: Instant?): Flow<Event> fun events(after: Instant?): Flow<AllEvent>
/** /**
* Date **стартовой точки** буфера. * Date **стартовой точки** буфера.