Реестр плагинов
PluginRegistry — центральный объект, который хранит загруженные плагины, управляет их жизненным циклом и предоставляет доступ по kind+name.
Манифест плагина
Схема файла dagstack.toml — обязательные и опциональные поля, виды (kind), исполняющие среды (runtime), требования к ресурсам.
Обнаружение плагинов
Функция discover(path) — рекурсивный обход каталога, правила обнаружения dagstack.toml, исключения, ограничения.
Виды (kinds) плагинов
Что такое вид плагина, встроенные виды, как объявить свой собственный вид через hookspec.
Исполняющие среды (runtimes)
Три runtime-адаптера — in_process, mcp_stdio, mcp_http. Какой выбирать, как декларировать, последствия для сериализации и жизненного цикла.
Диспетчеризация
Пять классов диспетчеризации — как выбирается, какой плагин (или плагины) обрабатывает вызов. Обзор для пользователей plugin-system.
Ресурсы (Resources DI)
Как plugin-system инъектирует HTTP-клиенты, БД-соединения, часы и источники случайности через PluginContext.resources — протоколы, стандартные реализации, тестовые подмены.
Runtime-инварианты
Восемь поведенческих инвариантов, обязательных для любого плагина — что именно делает плагин работоспособным в разных средах оркестрации без условного кода.