SDK и интеграции
SDK нужны, когда вы встраиваете Universal Agent Plugins в своё приложение или реализуете типизированные обработчики событий агента. Для обычной установки плагинов используйте CLI, а не runtime SDK.
Какой SDK выбрать
| Задача | Руководство | API |
|---|---|---|
| Обрабатывать нативные hooks агента | Go Hooks SDK | github.com/777genius/plugin-kit-ai/sdk |
| Узнать, Claude Code или Codex запустил hook | Определение агента | sdk/hostdetect |
| Управлять установкой и восстановлением внутри Go-хоста | Go Installer SDK | install/integrationctl/agentplugins/installer |
| Управлять плагинами из Node/Electron/desktop приложения | TypeScript Management SDK | universal-agent-plugins-management-sdk |
Не путайте разные виды определения агента
hostdetect.Detect распознаёт запустивший hook процесс по его JSON. discoverTargets в TypeScript SDK выясняет наличие нативных клиентов и их приватных профилей через Go-движок. Engine.Discover в Go installer facade показывает возможности явно зарегистрированных адаптеров. Ни одна из этих операций не устанавливает плагин автоматически.
Версии и доступность
- Go Hooks SDK: опубликованный модуль
github.com/777genius/plugin-kit-ai/sdk@v1.3.0. У разных событий свой уровень стабильности; смотрите политику SDK. - Host detector: доступен в текущих исходниках
sdk/hostdetect. Проверяйте его наличие в конкретном теге Go-модуля перед использованием в опубликованной интеграции. - Go Installer facade: API в текущем модуле
install/integrationctl/agentplugins; фиксируйте ревизию кода и зависимости. Не приписывайте ему версию Go Hooks SDK. - TypeScript Management SDK: версия исходного пакета
0.1.1, Node.js 22.18+, Management API v1; наличие версии в npm проверяйте черезnpm view. - Go-движок управления: публичный CLI 0.1.95+ поддерживает
manage serveиmanage discover. Но методcheckUpdatesиз TS SDK не поддерживается CLI 0.1.95 и более ранними.
SDK для hooks, Go установщик и TS-клиент имеют разные контракты и независимые версии. Проверка схемы, запись файлов, обнаружение агента, авторизация и настоящий вызов инструмента — отдельные стадии проверки.
Что ещё умеет UAP
| Возможность | Где читать |
|---|---|
| Подписанный каталог, Git/SSH/архивы, отдельные Skills, установка в проект | Установка |
uap.toml, uap.lock, импорт, обновление, ремонт, удаление | Управление |
| Типизированные события Claude, Codex, Gemini и Qoder | Go Hooks |
| Распознавание агента, вызвавшего hook | Host detection |
| Встраивание движка: план, подтверждение, операции, восстановление и миграции | Go Installer |
| Обнаружение профилей, Skills, операции и проверка доступных обновлений | TypeScript Management |
| Разработка пакетов из Skills и MCP | Создание |
Выбирайте по задаче: CLI — для пользователя, TypeScript Management — для desktop/Node, Go Installer — для хоста установки, Go Hooks — для событий агента. Подготовленные файлы не гарантируют авторизацию и выполнение MCP-инструмента.
Что изучить дальше
Go Hooks SDK — события, обработчики, transport и статусы стабильности. Host detection — приоритет сигналов, ошибки, неизвестный агент. Go Installer — план, подтверждение, применение, восстановление. TypeScript Management — запуск собственного движка, обнаружение профилей, управление установленными пакетами.