agent-toolsets: ядро механики toolsets (реестр, диспетчер, встроенные тулы)

Новый KMP-модуль :agent-toolsets с основными абстракциями для тулсетов:

- ToolsetContribution(name, description, tools: List<ToolEntry>) — декларация
  тулсета: имя + описание + список входящих LiteTool'ов с именами.
- ToolsetContext + Logger + NoOpLogger — что тулсеты получают при активации.
- ToolsetRegistry — реестр тулсетов с Mutex-защитой; методы
  activate/deactivate/isActive/activeNames/inactiveNames/activeTools/
  findByName/findOwnerByToolName.
- ToolsetDispatchPolicy — диспетчер с прощающей auto-activation: если тул из
  неактивного тулсета вызван — молча активирует тулсет и выполняет. Если тул
  вообще неизвестен — fallback в BaseToolDispatcher (плоские тулы вне toolsets).
- EnableToolsetTool / DisableToolsetTool — встроенные LiteTool'ы (4-case
  контракт зафиксирован в docs/TOOLSETS-PLAN.md): activate/deactivate с
  равномерным сообщением 'X deactivated' независимо от того, был ли он активен.
- SyncLiteTool — обёртка suspend-handler'а в синхронный LiteTool (через
  runBlocking). LiteTool.invoke синхронен по контракту litert-kmp.

Дизайн:
- :agent-toolsets НЕ зависит от :standalone — может быть переиспользован в
  Android-сборке и любом LiteTool-агенте.
- Модуль KMP (jvm + native), общие интерфейсы в commonMain, JVM-специфика
  только в SyncLiteTool (runBlocking).
- ToolsetContext минимален (logger); storage/skill добавятся в commit 5+.

Тесты: 29 новых покрывают activate/deactivate/idempotency, activeTools,
findOwnerByToolName, auto-activation в диспетчере, fallback в base, оба
контракта enable/disable со всеми 4 кейсами.

Tests: 328/328 green (299 ранее + 29 в :agent-toolsets)

This commit is contained in:

Субочев Антон

2026-09-15 14:55:51 +03:00

parent a7d8cbe713

commit 2e1387273a

13 changed files with 870 additions and 0 deletions

									
										settings.gradle.kts
									
		+4
		
												View File
												
				@@ -58,3 +58,7 @@ include(":storage-inmemory")

				// SqliteWorkingMemoryStore, SqliteReflectionStore. Бэкенд для прод-запуска

				// :standalone (путь к .db файлу в AGENTIK_DB).

				include(":storage-sqlite")

				// Ядро механики toolsets: ToolsetRegistry + ToolsetDispatchPolicy + встроенные

				// тулы enable_toolset/disable_toolset. KMP, не зависит от :standalone, может быть

				// переиспользован в Android-сборке. Интеграция с ChatAgent — commit 5+.

				include(":agent-toolsets")