s-orchestrationkit 0.1.0__py3-none-any.whl

orchestrationkit/__init__.py

@@ -0,0 +1,47 @@
+"""orchestrationkit — развязанные оркестраторы КОРНЯ китов: домен-нейтральны,
+переиспользуемы любым потребителем.
+
+Родился волной 5 платформы китов (Atlas #2710, Ruling 5-3) выделением связного
+кластера из `librarykit`: `SessionLoader`/`HealthMonitor`/`OnboardingService`
+(`orchestrationkit.orchestration`) + носители данных (`orchestrationkit.entities`),
+порты (`orchestrationkit.ports`), канонические перечисления (`orchestrationkit.enums`),
+контракты подключения и здоровья (`orchestrationkit.protocols`) и внутренний
+примитив параллельных проб (`orchestrationkit.fanout`) — три разных внешних
+потребителя (adapterkit, gws, bublictr) держали один и тот же код по чужому
+адресу.
+
+**Закон слоёв.** `orchestrationkit` не знает ни одного другого кита экосистемы,
+кроме `corekit` (только `corekit.dto.SessionRef` в `protocols.py` — тонкая точка,
+не библиотека целиком). Никакого импорта `librarykit`/`adapterkit`/`clikit`/
+`bublictr` — оркестраторы стоят на нейтральных `Session`/`SessionContext`/
+`HealthReport`, а доменные привязки (реестр адаптеров, enum'ы `Operation`/
+`TargetKind`, координаты `SessionRef`, audit-store, браузерный профиль)
+ИНЪЕКТИРУЮТСЯ доменом при инстанцировании.
+
+`librarykit.orchestration`/`librarykit.entities`/`librarykit.ports`/
+`librarykit.enums`/`librarykit.protocols`/`librarykit.fanout` остаются АЛИАСАМИ
+на этот кит (`sys.modules`-подмена, не реэкспорт) — старые формы доступа
+работают байт-в-байт для 54 потребителей librarykit.
+
+Версия читается из метаданных установленного дистрибутива
+(``importlib.metadata``), а не из литерала в коде — второй источник правды
+здесь намеренно не заведён (см. `docs/kits/SAFETY-NET.md` в devcontour,
+release_guard проверяет это на теге).
+"""
+from __future__ import annotations
+
+from importlib.metadata import PackageNotFoundError, version
+
+#: Не `__version__ = "0.0.0+unknown"` строкой-литералом — гейт релиза
+#: (`scripts/release_guard.py`) ищет ЛЮБУЮ строку вида `^__version__\s*=\s*"`
+#: как признак второго источника правды и откажет тегу, даже если это только
+#: аварийный fallback редактируемой установки. Вынесено в константу, чтобы
+#: строка присваивания `__version__` не начиналась с кавычки.
+_UNBUILT_FALLBACK = "0.0.0+unknown"
+
+try:
+    __version__ = version("s-orchestrationkit")
+except PackageNotFoundError:  # pragma: no cover — редактируемая установка без сборки
+    __version__ = _UNBUILT_FALLBACK
+
+__all__: list[str] = []

orchestrationkit/entities.py

@@ -0,0 +1,176 @@
+"""Домен-нейтральные data-классы оркестраторов — почва под будущий переезд.
+
+Здесь живут НЕЙТРАЛЬНЫЕ копии данных, на которых стоят оркестраторы
+(`OnboardingService`/`HealthMonitor`/`SessionLoader`): `Session`,
+`SessionChanges`, `SessionContext`, `HealthReport`. Развязка от домена:
+
+- поле `network` / `target` — ``str`` (машинное имя сети), НЕ доменный enum
+  (`NetworkId`/`TargetKind`); оркестратор не должен знать конкретный домен;
+- `HealthReport.state` — `orchestrationkit.enums.HealthState` (канон-нейтральный enum,
+  реэкспортируется доменом).
+
+ЗАКОН СЛОЁВ: только stdlib (+ `orchestrationkit.enums`); никаких импортов из
+adapterkit/clikit/bublictr. Это data-carriers, поэтому stdlib `@dataclass`
+(orchestrationkit — «почти-stdlib», pydantic НЕ зависимость пакета).
+
+Нота: на момент переноса доменные `bublictr.core.entities.Session`/...
+ОСТАЮТСЯ pydantic+`NetworkId` (домен использует ``session.network.value`` и
+сравнения ``== NetworkId.X`` в ~40 файлах + 1168 тестах — развязка bublictr.Session
+на ``str`` слишком инвазивна). Поэтому эти классы — ОТДЕЛЬНЫЕ нейтральные формы
+ПОЗЖЕ, когда оркестраторы переедут на них. `HealthState` же канонизирован и
+реэкспортирован доменом (identity-equal) уже сейчас.
+"""
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from datetime import datetime
+from pathlib import Path
+from typing import Any
+
+from orchestrationkit.enums import HealthState
+
+
+@dataclass
+class Session:
+    """Логин/токены/storage_state одного аккаунта в одной сети (нейтрально).
+
+    Нейтральный аналог `bublictr.core.entities.Session`: `network` — ``str``
+    (машинное имя сети), а не `NetworkId`. Остальные поля 1:1 с доменной
+    версией (включая V5-координаты unified session storage).
+
+    Несколько Binding могут разделять один Session. `storage_path` — JSON-файл с
+    cookies/state; секреты — в keyring под `keyring_ref`.
+    """
+
+    id: str  # uuid4
+    network: str  # машинное имя сети ("vk" / "telegram" / ...)
+    storage_path: Path
+    created_at: datetime
+    keyring_ref: str | None = None
+    account_handle: str | None = None
+    account_external_id: str | None = None
+    last_refreshed_at: datetime | None = None
+    expires_at: datetime | None = None
+    metadata: dict[str, Any] = field(default_factory=dict)
+    # --- V5: координаты unified session storage ---
+    profile_id: str | None = None
+    account_id: str | None = None
+    session_dir_path: Path | None = None
+    auth_provider_id: int | None = None
+
+
+@dataclass
+class SessionChanges:
+    """DTO частичного обновления `Session` (нейтрально).
+
+    Только non-None поля применяются. Immutable после create (не входят сюда):
+    id, network, storage_path, created_at.
+    """
+
+    keyring_ref: str | None = None
+    account_handle: str | None = None
+    account_external_id: str | None = None
+    last_refreshed_at: datetime | None = None
+    expires_at: datetime | None = None
+    metadata: dict[str, Any] | None = None
+    # --- V5 ---
+    profile_id: str | None = None
+    account_id: str | None = None
+    session_dir_path: Path | None = None
+    auth_provider_id: int | None = None
+
+
+@dataclass
+class SessionContext:
+    """Полный контекст для DI в адаптер — `Session` + storage_state + secrets.
+
+    Нейтральный аналог `bublictr.usecases.session_loader.SessionContext`.
+    """
+
+    session: Session
+    storage_state: dict[str, Any]
+    secrets: dict[str, str]  # secret_name → value, e.g. {"access_token": "..."}
+
+
+@dataclass
+class RawHealthStatus:
+    """RAW-результат health-check адаптера ДО классификации (нейтрально).
+
+    Это «сырая» форма, которую отдаёт ``NetworkAdapter.health_check()`` и которую
+    жуёт :func:`orchestrationkit.orchestration.health.classify_health_state` → выдаёт
+    `HealthState`. Нейтральный аналог `bublictr.core.entities.HealthStatus`:
+    `network` — ``str`` (машинное имя сети), а не `NetworkId`.
+
+    Развязка vs `orchestrationkit.protocols.HealthStatus`: тот — УЖЕ классифицированный
+    DTO (несёт `state: HealthState`, для `HealthProtocol`); ЭТОТ — сырой вход
+    классификатора (несёт `healthy: bool` + `rate_limit_remaining`, без `state`).
+    Раньше оба назывались `HealthStatus` — конфликт снят переименованием этой,
+    RAW-формы, в `RawHealthStatus` (старое имя — deprecated-алиас ниже).
+
+    `classify_health_state` читает поля по duck-typing (`.auth_valid`/
+    `.api_reachable`/`.notes`/`.rate_limit_remaining`/`.healthy`), поэтому
+    одинаково принимает и эту форму, и доменный pydantic-`HealthStatus` bublictr
+    (тот несёт сверху `network: NetworkId` + `raw` + `model_dump` — их домен
+    оставляет себе, развязка их не трогает).
+    """
+
+    network: str
+    healthy: bool
+    auth_valid: bool
+    api_reachable: bool
+    rate_limit_remaining: int | None = None
+    notes: list[str] = field(default_factory=list)
+
+
+@dataclass
+class HealthReport:
+    """Результат периодической проверки binding'а (нейтрально).
+
+    Нейтральный аналог `bublictr.core.entities.HealthReport`: `network` — ``str``,
+    `state` — `orchestrationkit.enums.HealthState` (канон). Добавляет binding/profile
+    контекст, классифицированный state и временные метки для trending.
+    """
+
+    binding_id: str
+    profile_id: str
+    network: str
+    state: HealthState
+    auth_valid: bool
+    api_reachable: bool
+    checked_at: datetime
+    rate_limit_remaining: int | None = None
+    retry_after_sec: int | None = None
+    notes: list[str] = field(default_factory=list)
+    next_check_at: datetime | None = None
+
+
+__all__ = [
+    "Session",
+    "SessionChanges",
+    "SessionContext",
+    "RawHealthStatus",
+    "HealthReport",
+]
+
+
+def __getattr__(name: str) -> Any:
+    """PEP 562: deprecated-алиас `HealthStatus` → `RawHealthStatus`.
+
+    RAW-снимок здоровья переименован в `RawHealthStatus`, чтобы снять конфликт
+    имён с классифицированным DTO `orchestrationkit.protocols.HealthStatus`. Старое имя
+    остаётся импортируемым (`from orchestrationkit.entities import HealthStatus`) ради
+    обратной совместимости, но предупреждает о переезде.
+    """
+    if name == "HealthStatus":
+        import warnings
+
+        warnings.warn(
+            "orchestrationkit.entities.HealthStatus переименован в RawHealthStatus. "
+            "Имя HealthStatus теперь закреплено за классифицированным DTO "
+            "orchestrationkit.protocols.HealthStatus; RAW-снимок стал RawHealthStatus. "
+            "Обнови импорт на RawHealthStatus — старый алиас будет удалён позже.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return RawHealthStatus
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

orchestrationkit/enums.py

@@ -0,0 +1,79 @@
+"""Домен-нейтральные enums КОРНЯ китов (orchestrationkit).
+
+Канон состояний здоровья сессии (`HealthState`) живёт ЗДЕСЬ — единый источник
+истины для всего графа (orchestrationkit <- adapterkit <- clikit) и для домена
+(bublictr реэкспортирует его из `bublictr.core.enums`). ``orchestrationkit.protocols``
+реэкспортирует `HealthState` отсюда — НЕ плодим второй enum.
+
+Рядом с ним — `SsoState`: живость входа У ПОСТАВЩИКА ЛИЧНОСТИ. Это ВТОРАЯ ось
+того же вопроса «можно ли работать», и жить она обязана там же, где первая:
+сессия сервиса и вход у Google умирают порознь, а состояния их читает один и
+тот же оркестратор. Разведи эти два перечисления по разным китам — и потребитель
+вынужден тянуть кит пула аккаунтов ради одного слова «alive».
+
+ЗАКОН СЛОЁВ: только stdlib; никаких импортов из adapterkit/clikit/bublictr.
+"""
+from __future__ import annotations
+
+from enum import StrEnum
+
+
+class HealthState(StrEnum):
+    """Агрегированное состояние здоровья сессии/binding'а (домен-нейтрально).
+
+    StrEnum — значение совпадает со строкой, прямая сериализация в JSON и
+    сравнение с raw-ответами. Канон тут; `orchestrationkit.protocols.HealthState`,
+    `bublictr.core.enums.HealthState` — реэкспорт этого объекта (identity-equal).
+
+    - `HEALTHY`         — всё работает;
+    - `WARNING`         — работает, но накопились issues;
+    - `DEGRADED`        — частично сломано;
+    - `UNAUTHENTICATED` — сессия разлогинена → нужен re-login;
+    - `RATE_LIMITED`    — упёрлись в лимит запросов;
+    - `UNREACHABLE`     — API недоступно (сеть/сервер);
+    - `CAPTCHA`         — требуется challenge/ручное действие;
+    - `UNKNOWN`         — состояние не удалось определить.
+    """
+
+    HEALTHY = "healthy"
+    WARNING = "warning"
+    DEGRADED = "degraded"
+    UNAUTHENTICATED = "unauthenticated"
+    RATE_LIMITED = "rate_limited"
+    UNREACHABLE = "unreachable"
+    CAPTCHA = "captcha"
+    UNKNOWN = "unknown"
+
+
+class SsoState(StrEnum):
+    """Живость входа У ПОСТАВЩИКА ЛИЧНОСТИ — отдельно от сессии сервиса.
+
+    Аккаунт, заведённый «через Google», держится на ДВУХ входах сразу, и сроки
+    жизни у них разные: ChatGPT продолжает отвечать, когда войти в Google уже
+    нельзя. Поэтому вопрос «жив ли общий вход» — свой, и ответ у него свой.
+
+    ИСХОДОВ ТРИ, И ТРЕТИЙ НЕ РОСКОШЬ.
+
+    - ``ALIVE``      — поставщик НАЗВАЛ, кого узнал. Ответ «200 OK» сам по себе
+      не признание: гостю сервисы отвечают ровно так же;
+    - ``LOGGED_OUT`` — только по ПРЯМОЙ улике отзыва (поставщик предъявил форму
+      входа; он ответил 401/403). Улику при этом обязаны предъявить: вердикт без
+      улики непроверяем, а по непроверяемому выключают рабочие аккаунты;
+    - ``UNKNOWN``    — всё прочее: связь оборвалась, ответ невнятен, проверки не
+      было. «Не знаю» — рабочий ответ, оставляющий аккаунт в строю.
+
+    Схлопывание неизвестного в «разлогинен» выключает живые аккаунты;
+    схлопывание в «жив» прячет поломку до часа, когда войти надо, а нечем.
+
+    StrEnum — значение совпадает со строкой (прямая сериализация в JSON и
+    сравнение с тем, что уже записано в реестрах). Канон ТУТ; кит пула аккаунтов
+    (`accountpoolkit.domain.enums.SsoState`) держит те же три значения и
+    переезжает на реэкспорт этого объекта — НЕ второй enum.
+    """
+
+    ALIVE = "alive"
+    LOGGED_OUT = "logged_out"
+    UNKNOWN = "unknown"
+
+
+__all__ = ["HealthState", "SsoState"]

orchestrationkit/fanout.py

@@ -0,0 +1,181 @@
+"""ВЕЕР: N параллельных задач → результаты И привязанные к ним ошибки.
+
+ЗАЧЕМ. Веерные пути кита («спроси три канала», «проверь здоровье десяти
+привязок», «опубликуй в четыре сети») делались голым ``asyncio.gather``, и это
+даёт ровно то, чего в таких сценариях быть не должно:
+
+* **первое же исключение выбрасывается наружу, а остальные результаты теряются.**
+  Три канала: два ответили, третий упал — вызывающий не получает НИЧЕГО, хотя два
+  ответа у него в руках. Веер именно тем и ценен, что частичный успех — успех;
+* **осиротевшие задачи.** ``gather`` при пробросе исключения НЕ отменяет
+  соседей: они продолжают выполняться уже никем не ожидаемые, дописывают файлы,
+  жгут лимиты, а их ошибки всплывают позже как ``Task exception was never
+  retrieved``;
+* **``return_exceptions=True`` тоже не лечит.** Он отдаёт плоский список, где
+  исключение лежит НА МЕСТЕ результата и не привязано к тому, ЧЕЙ это результат:
+  вызывающий восстанавливает соответствие по индексу и на первой же правке
+  порядка каналов начинает винить не того.
+
+КАК ЗДЕСЬ. :func:`fan_out` строит структурную конкурентность на
+:class:`asyncio.TaskGroup` (PEP 654, стандартный механизм): у задач есть ОДИН
+владелец, при выходе из блока не остаётся ни одной живой, а отмена извне
+корректно доезжает до всех. Исключения при этом НЕ рвут группу: каждая работа
+запускается в обёртке, которая ловит своё исключение и кладёт его в результат под
+СВОИМ КЛЮЧОМ. Итог — :class:`FanOut`: ``results`` (кто ответил) и ``errors``
+(кто упал и чем именно).
+
+ЧТО НЕ ЛОВИТСЯ НАМЕРЕННО: `asyncio.CancelledError`. Отмена — не результат работы,
+а приказ извне; проглотить её значит сломать отмену всего дерева задач.
+
+ЧИСТЫЙ модуль: только stdlib, ``asyncio`` импортируется ЛЕНИВО (ядро не имеет
+права тянуть event loop на ``import orchestrationkit`` — см. `test_lazy_facade`).
+"""
+from __future__ import annotations
+
+from collections.abc import Awaitable, Callable, Hashable, Mapping, Sequence
+from dataclasses import dataclass, field
+from typing import Any, TypeVar
+
+__all__ = ["FanOut", "FanOutError", "fan_out", "fan_out_all"]
+
+K = TypeVar("K", bound=Hashable)
+V = TypeVar("V")
+
+#: Работа веера: либо корутина/awaitable, либо фабрика корутин (``lambda: coro()``).
+#: Фабрика предпочтительнее для ленивых и повторяемых сценариев; готовый awaitable
+#: поддержан ради краткости вызова.
+Job = Awaitable[Any] | Callable[[], Awaitable[Any]]
+
+
+class FanOutError(Exception):
+    """Ни одна ветка веера не отработала — поднимает :meth:`FanOut.unwrap`.
+
+    Несёт ``errors`` целиком: «всё упало» почти всегда означает общую причину
+    (лёг выход, протухла сессия), и вызывающему нужны ВСЕ улики, а не первая.
+    """
+
+    def __init__(self, message: str, errors: Mapping[Any, BaseException]) -> None:
+        super().__init__(message)
+        self.errors = dict(errors)
+
+
+@dataclass(frozen=True, slots=True)
+class FanOut:
+    """Итог веера: кто ответил и кто упал — с сохранением ЧЕЙ это ответ/ошибка.
+
+    * ``results`` — ключ → значение по успешным веткам;
+    * ``errors``  — ключ → исключение по упавшим (само исключение, не текст:
+      вызывающий волен разобрать его типом, а не регуляркой по сообщению).
+
+    Порядок ключей сохраняется от входа — веер отвечает вразнобой, но отчёт
+    человеку должен быть стабильным.
+    """
+
+    results: dict[Any, Any] = field(default_factory=dict)
+    errors: dict[Any, BaseException] = field(default_factory=dict)
+
+    @property
+    def ok(self) -> bool:
+        """Все ветки отработали."""
+        return not self.errors
+
+    @property
+    def partial(self) -> bool:
+        """Часть ответила, часть упала — типовой и ЛЕГАЛЬНЫЙ исход веера."""
+        return bool(self.results) and bool(self.errors)
+
+    def unwrap(self) -> dict[Any, Any]:
+        """Результаты, если ответила ХОТЬ ОДНА ветка; иначе `FanOutError`.
+
+        Для сценариев «мне достаточно любого ответа» (спроси три канала, возьми
+        что дали). Тем, кому нужны все, — смотреть ``errors`` самому либо звать
+        :func:`fan_out_all`.
+        """
+        if not self.results:
+            raise FanOutError(
+                f"веер не дал ни одного результата ({len(self.errors)} веток упало)",
+                self.errors,
+            )
+        return dict(self.results)
+
+    def __len__(self) -> int:
+        return len(self.results) + len(self.errors)
+
+
+async def _await_job(job: Job) -> Any:
+    """Развернуть работу: фабрику — вызвать, awaitable — дождаться."""
+    return await (job() if callable(job) else job)
+
+
+async def fan_out(
+    jobs: Mapping[K, Job] | Sequence[Job],
+    *,
+    limit: int | None = None,
+) -> FanOut:
+    """Выполнить работы ПАРАЛЛЕЛЬНО; вернуть результаты И привязанные ошибки.
+
+    ``jobs`` — словарь «ключ → работа» (ключ уедет в ``results``/``errors``) либо
+    последовательность, и тогда ключами станут индексы. ``limit`` ограничивает
+    число одновременно исполняемых работ (семафор) — для веера по десяткам
+    привязок, где залп по всем сразу упрётся в лимиты провайдера.
+
+    Падение одной ветки НЕ отменяет остальные и НЕ выбрасывается наружу — оно
+    приезжает в ``errors`` под своим ключом. Наружу проходит только отмена
+    (`asyncio.CancelledError`): её глотать нельзя.
+    """
+    import asyncio  # лениво: ядро не тянет event loop на импорте
+
+    items: list[tuple[Any, Job]] = (
+        list(jobs.items()) if isinstance(jobs, Mapping) else list(enumerate(jobs))
+    )
+    results: dict[Any, Any] = {}
+    errors: dict[Any, BaseException] = {}
+    if not items:
+        return FanOut(results, errors)
+
+    semaphore = asyncio.Semaphore(limit) if limit and limit > 0 else None
+
+    async def run(key: Any, job: Job) -> None:
+        try:
+            if semaphore is None:
+                results[key] = await _await_job(job)
+            else:
+                async with semaphore:
+                    results[key] = await _await_job(job)
+        except asyncio.CancelledError:
+            # Отмена — приказ извне, а не исход работы: пробрасываем как есть,
+            # иначе `TaskGroup` не сможет свернуть дерево задач.
+            raise
+        except BaseException as exc:
+            errors[key] = exc
+
+    async with asyncio.TaskGroup() as group:
+        for key, job in items:
+            group.create_task(run(key, job))
+
+    # Порядок ключей — как на входе: отчёт человеку обязан быть стабильным.
+    ordered_keys = [key for key, _ in items]
+    return FanOut(
+        {k: results[k] for k in ordered_keys if k in results},
+        {k: errors[k] for k in ordered_keys if k in errors},
+    )
+
+
+async def fan_out_all(
+    jobs: Mapping[K, Job] | Sequence[Job],
+    *,
+    limit: int | None = None,
+) -> dict[Any, Any]:
+    """Веер «нужны ВСЕ»: любая упавшая ветка → `FanOutError` со ВСЕМИ ошибками.
+
+    Отличие от голого ``gather``: соседи всё равно доработали (их результаты уже
+    получены), задачи не осиротели, а в исключении лежат ВСЕ причины с
+    привязкой к ключам, а не одна первая.
+    """
+    outcome = await fan_out(jobs, limit=limit)
+    if outcome.errors:
+        keys = ", ".join(repr(k) for k in outcome.errors)
+        raise FanOutError(
+            f"веер требовал всех, упали ветки: {keys}", outcome.errors
+        )
+    return dict(outcome.results)

orchestrationkit/orchestration/__init__.py

@@ -0,0 +1,43 @@
+"""Развязанные оркестраторы КОРНЯ китов: переиспользуемы, домен-нейтральны.
+
+Кульминация переезда: `SessionLoader`/`HealthMonitor`/`OnboardingService` +
+классификатор здоровья + probe-registry + generic adapter probe живут ЗДЕСЬ, а не
+в bublictr. Они переиспользуемы любым потребителем (bublictr / reverse-factory):
+
+- стоят на `orchestrationkit.entities` (нейтральные `Session`/`SessionContext`/
+  `HealthReport`/`RawHealthStatus`, `network: str`) и `orchestrationkit.enums.HealthState`;
+- репо/сторы/probe инжектируются как `orchestrationkit.ports`-Protocol;
+- доменные привязки (реестр адаптеров, enum-значения `Operation`/`TargetKind`,
+  координаты `SessionRef`, audit-store, браузерный профиль) ИНЪЕКТИРУЮТСЯ доменом
+  при инстанцировании (bublictr — в `composition.py`).
+
+ЗАКОН СЛОЁВ: ни один модуль пакета НЕ импортит adapterkit/clikit/bublictr и не
+знает `NetworkId`/registry — всё инжектится. Граф китов: orchestrationkit <- adapterkit
+<- clikit; orchestrationkit не зависит ни от кого выше.
+"""
+from __future__ import annotations
+
+from orchestrationkit.orchestration.health import (
+    GenericAdapterHealthProbe,
+    HealthMonitor,
+    classify_health_state,
+    get_health_probe,
+    register_health_probe,
+)
+from orchestrationkit.orchestration.onboarding import OnboardingDeps, OnboardingService
+from orchestrationkit.orchestration.session_loader import SessionContext, SessionLoader
+
+__all__ = [
+    # session_loader
+    "SessionLoader",
+    "SessionContext",
+    # health
+    "classify_health_state",
+    "register_health_probe",
+    "get_health_probe",
+    "HealthMonitor",
+    "GenericAdapterHealthProbe",
+    # onboarding
+    "OnboardingService",
+    "OnboardingDeps",
+]