Files
agentik/agent-toolsets
subochev d74af621d8
ci / JVM build + tests (push) Successful in 6m13s
refactor(storage): drop StorageBundle + legacy EventStore, add HttpEventStore
- Remove legacy pw.binom.agentik.messageStore.events.EventStore (EventRecord,
  EventType) and all three impls (in-memory, sqlite, ksqlite) + tests + .sq
- Drop :storage-bundle module entirely; ChatAgent / ChatConversation /
  ConversationLoop / DebugRoutes now take stores individually
  (conversationStore, messageStore, workingMemoryStore, reflectionStore,
  eventStore) instead of StorageBundle
- Delete server endpoints /events/replay and /conversations/{id}/events/replay;
  Route.agentikAgent no longer takes eventStore param
- Add :client/HttpEventStore implementing :event-store/EventStore over HTTP:
  events() -> GET /events/all, agentEvents() -> GET /events,
  conversationEvents(convId) -> GET /conversations/{id}/events;
  exposed via AgentClient.eventStore
- :event-store: add macosX64/macosArm64/linuxArm64 targets to match :client KMP
- :working-memory-api: drop api dep on :message-store-api (no longer needed)
- :storage-{inmemory,sqlite,ksqlite}: drop deps on :storage-bundle
2026-09-20 18:06:46 +03:00
..

:agent-toolsets — реестр инструментов агента (KMP, jvm + native)

Что это

Ядро системы tools для LLM-агента:

  • Toolset — интерфейс, объединяющий несколько связанных tools (MemoryTools, SkillsTools, FileSystemTools).
  • ToolRegistry — глобальный реестр + фильтр enabled/disabled.
  • ToolDispatcher — берёт решение LLM (вызов инструмента с аргументами) → запускает → возвращает результат.
  • Cooperative cancel — interrupt() корректно отменяет in-flight вызов, помечая результат [cancelled by user].
  • Concurrency budget — backgroundScope = Dispatchers.IO .limitedParallelism(4) (см. коммит 86eb063) — защищает threadpool от переполнения при fan-out 30+ диалогов.

Решает: надёжный механизм tool-calls с прерываниями, без blocking-pool exhaustion, без утечки. Переиспользуется во всех IM-фронтендах (CLI, TUI, IRC, web).

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

  • :standalone подключает несколько Toolset-имплементаций (memory / skills / files / web), фильтрует через AGENTIK_TOOLSETS_DEFAULT env.

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

commonMain.dependencies {
    api("pw.binom.agentik:agent-toolsets:0.1.0")
}

class MyToolset : Toolset {
    override val name = "my"
    override val description = "Custom user-defined tools"
    override val tools = listOf(myTool1, myTool2)
}

val dispatcher = ToolDispatcher(
    toolsets = listOf(MemoryTools(memory), MyToolset()),
    enabled = setOf("memory", "my"),
)

Версии

gradle/libs.versions.toml → [versions] agentik-agent-toolsets.

Как пишется tool

data object EchoTool : Tool {
    override val name = "echo"
    override val description = "Echoes back the argument"
    override val argsSchema = jsonSchema {
        property("text", JsonType.STRING) { required = true }
    }

    override suspend fun invoke(args: JsonObject): ToolResult {
        val text = args["text"]?.jsonPrimitive?.content ?: return ToolResult.Error("missing text")
        return ToolResult.Text(text)
    }
}

Тесты

./gradlew :agent-toolsets:allTests

Покрывают: invoke happy-path, invalid args, cooperative cancel, budget exhaustion, registry filter, parallel dispatch.

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

  • Никакого конкретного LLM. Dispatcher вызывает tools, не LLM.
  • Никакого persistent storage. Опирается на контракт WorkingMemoryStore (см. :storage-core).

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

Используется продакшеном. Реализует полную спецификацию из INTERRUPT-DESIGN.md: tool exchange log, rolling buffer, partial-state persistence.