SubochevAV
8f616f359f
ci / JVM build + tests (pull_request) Failing after 54s
Every subproject now has README.md:
- 3 runnable modules (:standalone, :agentik-cli, :agentik-tui):
quickstart, env table, parameters, known limits
- 11 library modules: what it is, which problem solves, how to
wire it in, where versions live
Root README.md is the navigation hub (Quickstart, Modules table,
publish + CI/CD notes).
Also: ci.yml prunes the :memory-vector -x excludes now that
text-embedding-kmp artifacts are published to caffeine.
518 tests green.
Verified publish pipeline: :proto:publish to caffeine produces
pom.module + per-target klibs + sources for all 9 KMP targets.
🤖 Generated with [opencode]
81 lines
2.4 KiB
Markdown
81 lines
2.4 KiB
Markdown
# `:memory-api` — контракт долговременной памяти (KMP, jvm + native)
|
|
|
|
## Что это
|
|
|
|
Интерфейсы долговременной памяти агента:
|
|
|
|
- `MemoryStore` — append-only журнал `MemoryNote(id, content, createdAt)`.
|
|
- `MemoryCategory` — discriminator (`USER`, `WORLD`, `PREFERENCE`,
|
|
кастомные).
|
|
- `MemoryNote` — структурная единица памяти; immutable.
|
|
- Прелоадер / ревьювер по контракту, не по реализации.
|
|
|
|
Решает: как единая абстракция позволяет иметь одновременно файловую
|
|
память (`:memory-md`), SQLite + ANN (`:memory-vector`) и тестовую
|
|
in-memory (в `:standalone/tests`). Агент работает с `MemoryStore`,
|
|
не с конкретным бэкендом.
|
|
|
|
## Где используется
|
|
|
|
- `:memory-md` — Hermes-style `§`-файлы (user.md / world.md /
|
|
preference.md).
|
|
- `:memory-vector` — SQLite + JVector + LLM-эмбеддинги.
|
|
- `:standalone` подключает обе реализации и переключает через
|
|
`AGENTIK_MEMORY_BACKEND=md|vector|off`.
|
|
|
|
## Как подключить
|
|
|
|
```kotlin
|
|
kotlin {
|
|
sourceSets.commonMain.dependencies {
|
|
api("pw.binom.agentik:memory-api:0.1.0")
|
|
}
|
|
}
|
|
```
|
|
|
|
Артефакт публикуется в `caffeine`.
|
|
|
|
## Версии
|
|
|
|
`gradle/libs.versions.toml` → `[versions] agentik-memory-api`.
|
|
|
|
## Что в API
|
|
|
|
```kotlin
|
|
interface MemoryStore {
|
|
suspend fun save(category: MemoryCategory, content: String): MemoryNote
|
|
suspend fun query(category: MemoryCategory?, q: String, limit: Int = 10): List<MemoryNote>
|
|
suspend fun all(category: MemoryCategory? = null): List<MemoryNote>
|
|
}
|
|
|
|
enum class MemoryCategory(val path: String) {
|
|
USER("user"),
|
|
WORLD("world"),
|
|
PREFERENCE("preference");
|
|
}
|
|
|
|
data class MemoryNote(
|
|
val id: String,
|
|
val category: MemoryCategory,
|
|
val content: String,
|
|
val createdAt: Instant,
|
|
)
|
|
```
|
|
|
|
## Тесты
|
|
|
|
```
|
|
./gradlew :memory-api:allTests
|
|
```
|
|
|
|
Контрактные тесты на Kotlin Multiplatform (без jvmTest-специфики).
|
|
|
|
## Чего здесь НЕТ
|
|
|
|
- Никаких конкретных storage — это API. Backend-ы в `:memory-md` и
|
|
`:memory-vector`.
|
|
|
|
## Текущий статус
|
|
|
|
Используется продакшеном. Контракт стабильный.
|