subochev/agentik
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 16 Wiki Activity
Files
22a167ed038eecb6a80bff2eaaccec2aa41c4237
agentik/standalone
T
History
subochev 5bdc517988 Добавляет Cursor/OffsetSequencer в :outbox-api и интегрирует PersistentOffsetSequencer через :outbox-ksqlite. 
Введение монотонного offset'а как персистентного состояния агента:
offset'ы переживают рестарт standalone-агента, клиент продолжает
синхронизацию инкрементально, без полной re-sync с нуля.

outbox-api:
  - Cursor (offset: Long) — курсор в журнале событий агента.
  - OffsetSequencer — интерфейс резервирования уникального offset.
  - CursorStore — персистентное хранилище текущего offset'а.
  - PersistentOffsetSequencer — декоратор над любым OutboxStore,
    обновляет CursorStore на каждом append (atomic transaction).
  - OutboxGapException — клиент запросил after < earliestCursor() →
    сервер не может удовлетворить, клиент обязан делать full resync.
  - DurableEvent переименован из Event.kt → DurableEvent.kt (Event.kt
    был общим sealed-типом, теперь это термин из спеки).
  - MutableOutboxStore и OutboxStore теперь читают offset через
    CursorStore вместо in-memory counter'а.

outbox-inmemory:
  - InMemoryOffsetSequencer — для тестов и dev-режима.
  - InMemoryOutboxStore теперь принимает OffsetSequencer в конструкторе.

outbox-ksqlite (новый модуль):
  - KsqliteCursorStore — таблица outbox_cursor (agent_id TEXT PK,
    offset INTEGER NOT NULL DEFAULT 0, updated_at INTEGER NOT NULL).
  - KsqliteCursorStoreTest — 4 теста (set/get, monotonic, concurrent).

proto + server:
  - Snapshot.proto — server-state snapshot endpoint для клиентов,
    которым нужна полная материализация (использование TBD).
  - Routes.kt + SnapshotRouteTest — endpoint /agentik/snapshot (GET).

journal-ksqlite:
  - KsqliteJournalStore.listFlow/append — без изменений по API,
    нотации минимальные (codecs).

standalone:
  - DurableLog (бывший ChatAgent-orchestration) — атомарный commit
    события в OutboxStore + PersistentOffsetSequencer + materialization
    (через Reducer) одной транзакцией.
  - SqliteStores — добавляет KsqliteCursorStore в bundle, единая
    shared-connection для всех ksqlite-сторов standalone-агента.
  - ChatAgent / ConversationLoop / ConversationEvents / ReflectionScheduler /
    ToolDispatcher — переход на новые абстракции.
  - standalone/build.gradle.kts — implementation(project(':outbox-ksqlite'))
    включено (раньше было закомментировано — модуль только создавался).

client:
  - AgentikAgent / AgentClient / HttpEventStore / HttpJournalStore /
    ReconnectingOutbox — используют Cursor через transport API.
  - client/README.md — синхронизирован с новым поведением (468 строк
    diff — это в основном оформление и примеры).

kotlinx-io: 0.8.0 → 0.9.1 в libs.versions.toml (см. sync-core tests).

SYNC-SYSTEM.md (в корне) — спецификация, на которую ссылается и
:sync-core (эта сессия), и эта Cursor-абстракция в outbox-api.

Тесты: standalone 132, journal-ksqlite 25, outbox-inmemory 20,
outbox-ksqlite 4, client 10, sync-core 74 — все зелёные на jvm;
sync-core linuxX64 74 тоже зелёный.

sync2/ (заброшенный stub с одним build.gradle.kts) удалён.
2026-10-02 01:16:15 +03:00
..
src
Добавляет Cursor/OffsetSequencer в :outbox-api и интегрирует PersistentOffsetSequencer через :outbox-ksqlite.
2026-10-02 01:16:15 +03:00
build.gradle.kts
Добавляет Cursor/OffsetSequencer в :outbox-api и интегрирует PersistentOffsetSequencer через :outbox-ksqlite.
2026-10-02 01:16:15 +03:00
README.md
Add GET /conversations/{id}/count endpoint for total/filtered message counts, update JournalStore API, and implement client/server support with tests.
2026-09-23 05:43:55 +03:00

README.md

:standalone — single-jar HTTP-сервер со всеми транспортами

Что это

Главный исполняемый модуль проекта — single-jar HTTP-сервер с:

  • A2A transport на POST / (JSON-RPC) + GET /.well-known/agent-card.json.
  • :proto transport на POST /agentik/* (HTTP+JSON+SSE) — наш stateful.
  • Embedded LLM backend: GOOGLE (LiteRT) или OPENAI-совместимый (vLLM, LiteLLM, OpenAI API).
  • SQLite persistence через :storage-sqlite.
  • Memory backend: md (файловый) или vector (SQLite+JVector+ HTTP/SIGLIP-embeddings).
  • Skills из ~/.agentik/skills/*.md.
  • SOUL из ~/.agentik/SOUL.md.
  • Background подпроцессы: рефлексия, skill-mining, memory-reviewer.

Решает: даёт пользователю один JAR (10–250 МБ), который запускается через java -jar agentik-0.1.0-all.jar, и поднимает сразу все транспорты, которые другие системы могут хавать.

Как запустить

Требования

  • JVM 21+.
  • (Опционально) CUDA-устройство для :backend=google (LiteRT).
  • (Опционально) LM через OpenAI-совместимый endpoint (vLLM / Ollama / OpenAI) для :backend=openai.

Запуск из готового fatjar

java --enable-native-access=ALL-UNNAMED \
     -jar agentik-0.1.0-all.jar

С дефолтами — встроенный SQLite, OpenAI-compatible backend на http://localhost:8001/v1, порт 8080.

Запуск через Gradle (dev)

./gradlew :standalone:run

pull-model subcommand (для LiteRT)

# Сначала скачать модель под LiteRT-Gemma-4-E2B
AGENTIK_LLM_BACKEND=google \
AGENTIK_GOOGLE_MODEL_PATH=/root/gemma-4-E2B-it.litertlm \
  java --enable-native-access=ALL-UNNAMED \
       -jar agentik-0.1.0-all.jar pull-model

Скачивает https://static.binom.pw/models/gemma-4-E2B-it.litertlm (2.5 ГБ, с Range-resume). Поддерживает override через AGENTIK_GOOGLE_MODEL_URL и verify через AGENTIK_GOOGLE_MODEL_SHA256_URL.

Переменные среды

Полный список — общий для всего :standalone-процесса:

Env Default Что делает
AGENTIK_PORT 8080 Порт HTTP-сервера
AGENTIK_DB_PATH ./agentik.db Путь к SQLite
AGENTIK_TOKEN (пусто) Bearer-токен для HTTP-фасада /agentik. Пусто — авторизация выключена
AGENTIK_A2A_TOKEN (пусто) Bearer-токен для A2A-фасада /a2a. Пусто — авторизация выключена (независим от AGENTIK_TOKEN)
AGENTIK_AGENT_ID agentik ID агента (для multi-instance)
AGENTIK_LLM_BACKEND openai openai или google
AGENTIK_LLM_MODEL (выбирается по backend) Имя модели
AGENTIK_LLM_API_URL http://localhost:8001/v1 Endpoint для OpenAI-compatible
AGENTIK_LLM_API_KEY no-key-needed Auth header
AGENTIK_LLM_CONTEXT_TOKENS 115000 Сколько токенов остаётся модели
AGENTIK_GOOGLE_MODEL_PATH /root/gemma-4-E2B-it.litertlm Путь к .litertlm файлу
AGENTIK_GOOGLE_MODEL_URL https://static.binom.pw/models/gemma-4-E2B-it.litertlm Откуда скачивать
AGENTIK_GOOGLE_MODEL_SHA256_URL — Если задан — verify по SHA-256
AGENTIK_AUTO_DOWNLOAD_MODEL 0 1 = скачать модель если её нет
AGENTIK_MEMORY_BACKEND vector md, vector или off
AGENTIK_EMBEDDING_BACKEND http http или siglip (только для vector)
AGENTIK_EMBEDDING_API_URL http://localhost:8001/v1 Endpoint для эмбеддингов
AGENTIK_EMBEDDING_MODEL text-embedding-3-small Имя embedding-модели
AGENTIK_SOUL_PATH ~/.agentik/SOUL.md Путь к SOUL.md
AGENTIK_SKILLS_DIR ~/.agentik/skills/ Каталог SKILL.md
AGENTIK_MEMORY_DIR ~/.agentik/memory/ Каталог для md-памяти
AGENTIK_TOOLSETS_DEFAULT memory,skills,files,web Включённые тулы
AGENTIK_DEBUG 0 1 = verbose logging

Значения читаются через AgentikConfig.fromEnv() в :standalone/.../Main.kt.

Эндпоинты

Метод Путь Transport Описание
GET /health любой health-check ({"ok":true})
POST / A2A JSON-RPC message/send, tasks/get, tasks/cancel
GET /.well-known/agent-card.json A2A Discovery
POST /agentik/conversations :proto Создать диалог
GET /agentik/conversations :proto Список диалогов
GET /agentik/conversations/:id :proto Snapshot
GET /agentik/conversations/:id/messages :proto История
POST /agentik/conversations/:id/send :proto Send (SSE)
GET /agentik/conversations/:id/events :proto Live-events (SSE)
POST /agentik/conversations/:id/interrupt :proto Прервать
POST /agentik/conversations/:id/rename :proto Переименовать
DELETE /agentik/conversations/:id :proto Удалить

Тесты

./gradlew :standalone:jvmTest                       # unit-тесты
./gradlew :standalone:integrationTest               # integration (Testcontainers)
./gradlew :standalone:shadowJar                     # → build/libs/agentik-0.1.0-all.jar

Известные ограничения

  1. vLLM не поддерживает cancel-inference (interrupt() только закрывает client SSE-socket; бэкенд всё равно генерирует до конца).
  2. A2A JSON discriminator — "kind" (text/file/data), а не "type". См. A2aJson в :standalone.
  3. SSE в не-TTY ssh закрывается на default Ktor timeout.

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

Production-ready. Все KMP-модули проекта интегрированы. Полный manual-test checklist смотрите в MANUAL-TESTS.md или MANUAL-TESTS.md в корне.

Где скачать

  • Source: git clone https://git.binom.pw/subochev/agentik
  • Fatjar: Gitea CI artifacts (через .gitea/workflows/release.yml на tag v*) или собирается через ./gradlew :standalone:shadowJar.

Версии

Все gradle/libs.versions.toml. Поднять версию → release через git tag v0.2.0 && git push --tags → CI собирает все KMP-таргеты публикует артефакты.

Reference in New Issue View Git Blame Copy Permalink