feat(memory): add :memory-md-vector hybrid backend + :reflection-api + outbox/journal entity splits

- :memory-md-vector (KMP jvm+linuxX64+mingwX64): .md-файлы как source of truth, векторный индекс (sqlite-vec) как derived cache. reconcile() на старте: orphan-cleanup + content-hash-gated re-embed. Гибридный скор 0.7*vector + 0.3*keyword. Заменяет EmbeddingProvider на KMP-TextEmbeddingExecutor из :memory-api. - :reflection-api: новый 4-й API-модуль (Reflection, ReflectionStore, ReflectionEvent). Зависит только от :memory-api. - :journal-api получил ConversationRecord/ConversationStore/Ids (бывший :message-store-api, полностью удалён). :outbox-api получил Event, CommonEvent, AgentEvent (бывший :event-store). - :memory-api получил MemoryVectorIndex + NoteMatches + TextEmbeddingExecutor (suspend-обёртка над TextEmbeddingExtractor). - :memory-vector KMP-цели достигнуты через commonMain-only TextEmbedding- Executor, EmbeddingProvider выпилен; :memory-md-vector тянет text-embedding-api транзитивно через :memory-api. - :standalone flatten в commonMain/commonTest завершён (тесты из jvmTest переехали в commonTest). Включён optional деп :memory-md-vector через AGENTIK_MEMORY_BACKEND=md-vector. jvmTest: 96 задач, 407 тестов, 0 падений.
2026-09-21 23:10:28 +03:00
parent 161be41adf
commit 0a7c40688c
41 changed files with 4952 additions and 0 deletions
@@ -0,0 +1,48 @@
+package pw.binom.agentik.outbox
+
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+import kotlin.time.Instant
+
+/**
+ * Live-события уровня агента: изменения в множестве диалогов
+ * (создание, удаление, переименование). События, происходящие **внутри**
+ * конкретного диалога, приходят через `Conversation.events` (live-stream
+ * per-turn Event'ов), а не сюда.
+ *
+ * Каждое событие несёт [date] — момент эмиссии в UTC. Семантика подписки
+ * идентична `OutboxStore.events`: поток **не реплеит** прошлое, для бэкфилла
+ * используются `Agent.getConversations` / `getConversation`.
+ *
+ * **История**: раньше жил в `:proto` (как `pw.binom.agentik.proto.AgentEvent`).
+ * После миграции в `:outbox-api` — `:proto.AgentEvent` стал typealias'ом,
+ * backward-compat для существующих импортов сохранён.
+ */
+@Serializable
+sealed interface AgentEvent {
+    /** Момент эмиссии события в UTC. */
+    val date: Instant
+
+    /**
+     * Создан новый диалог. Передаётся его id — handle можно получить через
+     * `Agent.getConversation`. Подписчик после [Created] может сразу открыть
+     * live-подписку на этот диалог через `Conversation.events`.
+     */
+    @Serializable
+    @SerialName("created")
+    data class Created(override val date: Instant, val conversationId: String) : AgentEvent
+
+    /**
+     * Диалог удалён. Переданный `Conversation`-handle реализация обязана
+     * закрыть (`close()`) до эмиссии этого события — после [Deleted]
+     * пользоваться handle нельзя.
+     */
+    @Serializable
+    @SerialName("deleted")
+    data class Deleted(override val date: Instant, val id: String) : AgentEvent
+
+    /** У диалога сменился заголовок. */
+    @Serializable
+    @SerialName("renamed")
+    data class Renamed(override val date: Instant, val id: String, val title: String?) : AgentEvent
+}
@@ -0,0 +1,42 @@
+package pw.binom.agentik.outbox
+
+import kotlin.time.Instant
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+
+/**
+ * Unified wrapper for all agent events in a single stream.
+ *
+ * Useful for admin dashboards, debug tools, parent agents: one subscription
+ * instead of N+1. For regular UI use two separate SSE feeds
+ * ([AgentEvent] via `/events` и `Event` via `/conversations/{id}/events`);
+ * [CommonEvent] — for those who need everything in one place.
+ *
+ * Server endpoint: `GET /events/all` (SSE), or replay via `OutboxStore.events(after)`.
+ *
+ * **История**: раньше жил в `:proto` (как `pw.binom.agentik.proto.CommonEvent`).
+ * После миграции в `:outbox-api` — `:proto.CommonEvent` стал typealias'ом,
+ * backward-compat для существующих импортов сохранён. `CommonEvent.Conversation`
+ * ссылается на [Event] (тоже в `:outbox-api` теперь) — раньше был
+ * `pw.binom.agentik.proto.Event`, теперь это `pw.binom.agentik.outbox.Event`
+ * (он тоже typealias-нут в `:proto.Event`).
+ */
+@Serializable
+sealed interface CommonEvent {
+    val date: Instant
+
+    @Serializable
+    @SerialName("agent")
+    data class Agent(
+        override val date: Instant,
+        val event: AgentEvent,
+    ) : CommonEvent
+
+    @Serializable
+    @SerialName("conversation")
+    data class Conversation(
+        override val date: Instant,
+        val conversationId: String,
+        val event: Event,
+    ) : CommonEvent
+}
@@ -0,0 +1,92 @@
+package pw.binom.agentik.outbox
+
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+import kotlin.time.Instant
+
+/**
+ * Элемент live-потока `Conversation.events(after)`.
+ *
+ * Каждое событие несёт [date] — момент эмиссии в UTC. Используется клиентом
+ * для трекинга «где остановился» при обрыве/переподключении и для разрешения
+ * порядка при равных timestamps.
+ *
+ * Базовая структура хода:
+ * `StartReasoning?` → `StartResponse(TEXT|IMAGE)` → ...контент... → `End` | `Interrupted` | `Error`.
+ * `StartReasoning` может отсутствовать, если агент не показывал рассуждения.
+ *
+ * **История**: раньше жил в `:proto` (как `pw.binom.agentik.proto.Event`).
+ * После миграции в `:outbox-api` — `:proto.Event` стал typealias'ом,
+ * backward-compat для существующих импортов сохранён.
+ */
+@Serializable
+sealed interface Event {
+    /** Момент эмиссии события в UTC. */
+    val date: Instant
+
+    @Serializable
+    enum class ResponseType {
+        @SerialName("text") TEXT,
+        @SerialName("image") IMAGE
+    }
+
+    /** Ассистент начал рассуждение (опциональный маркер; контент рассуждения приходит через [AppendText]). */
+    @Serializable
+    @SerialName("start_reasoning")
+    data class StartReasoning(override val date: Instant) : Event
+
+    /** Начало ответа ассистента заданного типа. После него идут соответствующие `Append*`/`Tool*`-события, потом [End]/[Interrupted]/[Error]. */
+    @Serializable
+    @SerialName("start_response")
+    data class StartResponse(override val date: Instant, val responseType: ResponseType) : Event
+
+    /** Ход завершён нормально. Соответствующий `Message.AssistantMessage` появится в `getMessages`. */
+    @Serializable
+    @SerialName("end")
+    data class End(override val date: Instant) : Event
+
+    /** Ход прерван через `Conversation.interrupt`. Частичный ответ НЕ сохраняется в истории. */
+    @Serializable
+    @SerialName("interrupted")
+    data class Interrupted(override val date: Instant) : Event
+
+    @Serializable
+    @SerialName("append_text")
+    data class AppendText(override val date: Instant, val body: String) : Event
+
+    @Serializable
+    @SerialName("append_image")
+    data class AppendImage(override val date: Instant, val body: ByteArray, val mime: String) : Event
+
+    /**
+     * Агент начал вызов тула. Аргументы приходят целиком — стриминга нет.
+     * [id] совпадает с id соответствующего `Message.ToolCall` в истории
+     * после завершения хода.
+     */
+    @Serializable
+    @SerialName("tool_call")
+    data class ToolCall(
+        override val date: Instant,
+        val id: String,
+        val title: String?,
+        val toolName: String,
+        val toolArgs: String,
+    ) : Event
+
+    /**
+     * Результат вызова тула. Приходит целиком после завершения исполнения.
+     * [id] совпадает с [ToolCall.id], к которому относится результат, и
+     * с id `Message.ToolResult` в истории.
+     */
+    @Serializable
+    @SerialName("tool_result")
+    data class ToolResult(override val date: Instant, val id: String, val result: String?) : Event
+
+    /**
+     * Ошибка хода. После неё поток завершается; дальнейшие события могут
+     * прийти, но ход считается проваленным.
+     */
+    @Serializable
+    @SerialName("error")
+    data class Error(override val date: Instant, val message: String, val code: String? = null) : Event
+}