s-orchestrationkit 0.1.0__tar.gz

s_orchestrationkit-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+dist/
+.venv
+__pycache__/
+.pytest_cache/
+*.egg-info/
+.coverage
+*.bak
+.ruff_cache/
+.import_linter_cache/
+.kits-gate3.json

s_orchestrationkit-0.1.0/.gitlab-ci.yml

@@ -0,0 +1,101 @@
+# СГЕНЕРИРОВАНО из devcontour/tools/kits/template/gitlab-ci.yml — не правь здесь.
+# Правка идёт в шаблон, затем `python tools/kits/apply_template.py <кит>`.
+# Сверка: `python tools/kits/apply_template.py <кит> --check` (код 1 при расхождении).
+#
+# Автопубликация на PyPI по семвер-тегу vX.Y.Z через Trusted Publishing (OIDC).
+# Три стадии, и это не украшение: версии на PyPI неизменяемы, и шесть китов
+# уезжали туда без единого теста (browserkit 0.0.18, netkit ≤0.0.12 — оба в бою).
+#   gates          — тесты, линтер, слои, doctor: на каждый push и на тег
+#   release-guard  — тег == версия во всех местах (pyproject/uv.lock/CHANGELOG)
+#   publish-pypi   — только после двух первых; версия, уже лежащая на PyPI, не
+#                    публикуется повторно (тег «догоняет» выпуск, а не роняет CI);
+#                    после сборки и до обмена токена — check_dist_leaks.py
+#                    (личные данные разработчика в собранном дистрибутиве)
+# Токены НИГДЕ не хранятся: GitLab выдаёт короткоживущий OIDC-токен (PYPI_ID_TOKEN),
+# он одноразово обменивается на PyPI API-токен. Издатель настраивается на pypi.org:
+#   Manage -> Publishing -> GitLab  (namespace=S-kits, project=orchestrationkit,
+#   top-level pipeline file=.gitlab-ci.yml, environment — пусто).
+# Дистрибутив на PyPI: s-orchestrationkit.
+stages: [test, guard, publish]
+
+.uv:
+  image: ghcr.io/astral-sh/uv:python3.12-bookworm
+
+gates:
+  extends: .uv
+  stage: test
+  rules:
+    - if: $CI_COMMIT_TAG =~ /^v\d+\.\d+\.\d+$/
+    - if: $CI_PIPELINE_SOURCE == "push"
+  script:
+    # dev-зависимости у китов объявлены двумя способами — extra `dev` и группа
+    # `[dependency-groups] dev`; --all-extras покрывает первое, группу добавляем
+    # только если она объявлена, иначе uv падает «Group dev is not defined».
+    - uv sync --all-extras $(python3 -c "import tomllib;print('--group dev' if 'dev' in tomllib.load(open('pyproject.toml','rb')).get('dependency-groups',{}) else '')")
+    - uv run pytest tests/ -q
+    # Линтер по ВСЕМУ пакету, а не по списку файлов: сужение до «файлов волны 0»
+    # держалось девять китов и ни разу не было расширено — сужение приживается,
+    # расширение нет.
+    - uv run ruff check .
+    # Границы слоёв: контракт в .importlinter (ставится тем же шаблоном).
+    #  — доп. пакеты через --with (пусто у большинства
+    # китов; adapterkit — пример кита, которому нужен сосед на прогоне
+    # lint-imports, см. apply_template.py --extra-with).
+    - uv run --with import-linter lint-imports
+    # Гейт 1, часть «согласованность локальных venv» (kitsctl doctor). Скрипт
+    # раздаётся шаблоном не всем: в раннере видно ОДИН репозиторий, соседних
+    # venv'ов там нет, — поэтому шаг условный и молча пропускается, когда
+    # инструмента у кита нет. Настоящее место doctor — локальный прогон перед
+    # тегом; см. docs/kits/SAFETY-NET.md, «Известные ограничения».
+    - 'if [ -f scripts/kitsctl.py ]; then python3 scripts/kitsctl.py doctor; else echo "kitsctl doctor — инструмента нет в репозитории, пропуск (см. SAFETY-NET.md)"; fi'
+
+release-guard:
+  extends: .uv
+  stage: guard
+  needs: [gates]
+  rules:
+    - if: $CI_COMMIT_TAG =~ /^v\d+\.\d+\.\d+$/
+  script:
+    - python3 scripts/release_guard.py "$CI_COMMIT_TAG"
+
+publish-pypi:
+  extends: .uv
+  stage: publish
+  needs: [release-guard]
+  rules:
+    - if: $CI_COMMIT_TAG =~ /^v\d+\.\d+\.\d+$/
+  id_tokens:
+    PYPI_ID_TOKEN:
+      aud: pypi
+  script:
+    - |
+      DIST=$(python3 -c "import tomllib;print(tomllib.load(open('pyproject.toml','rb'))['project']['name'])")
+      VER="${CI_COMMIT_TAG#v}"
+      if python3 - "$DIST" "$VER" <<'PY'
+      import json, sys, urllib.request
+      dist, ver = sys.argv[1], sys.argv[2]
+      try:
+          data = json.load(urllib.request.urlopen(f"https://pypi.org/pypi/{dist}/json"))
+      except Exception:
+          sys.exit(1)
+      sys.exit(0 if ver in data.get("releases", {}) else 1)
+      PY
+      then echo "версия $VER уже на PyPI — публикацию пропускаем"; exit 0; fi
+    - uv build
+    # Последний рубеж перед необратимым шагом (версии на PyPI неизменяемы,
+    # yank — не удаление). Прецедент — leasekit: реальный email и домашний
+    # путь разработчика уехали в публичный индекс из тестовых фикстур. Ловит
+    # по классам, не по строкам; см. docs/kits/SAFETY-NET.md.
+    - python3 scripts/check_dist_leaks.py dist/
+    - |
+      export UV_PUBLISH_TOKEN=$(python3 - <<'PY'
+      import json, os, urllib.request
+      req = urllib.request.Request(
+          "https://pypi.org/_/oidc/mint-token",
+          data=json.dumps({"token": os.environ["PYPI_ID_TOKEN"]}).encode(),
+          headers={"Content-Type": "application/json"},
+      )
+      print(json.load(urllib.request.urlopen(req))["token"])
+      PY
+      )
+    - uv publish

s_orchestrationkit-0.1.0/.importlinter

@@ -0,0 +1,69 @@
+# СГЕНЕРИРОВАНО из devcontour/tools/kits/template/importlinter.ini — не правь
+# здесь. Правка идёт в шаблон, затем `python tools/kits/apply_template.py <кит>`.
+#
+# Заготовка контракта слоёв. Запуск: `uv run --with import-linter lint-imports`.
+#
+# Контракт ниже — минимум, который годится ЛЮБОМУ киту и не требует ручной
+# настройки: «orchestrationkit не импортирует те киты экосистемы, которых нет в его
+# объявленных зависимостях». Скрытая зависимость — это кит, который работает у
+# автора (сосед стоит в venv) и разваливается у потребителя на первом импорте;
+# именно так ломались pypi-publish и gemini-chat.
+#
+# Список forbidden_modules подставлен установщиком из реестра китов на момент
+# установки: все известные пакеты китов МИНУС собственный МИНУС объявленные в
+# pyproject зависимости. Появилась новая честная зависимость — объяви её в
+# pyproject и переустанови шаблон, а не правь этот файл.
+#
+# Собственные контракты кита (layers/eager_forbidden/declared_dependencies,
+# как у adapterkit) дописываются НИЖЕ отдельными секциями прямо в этом файле.
+# Установщик сверяет файл целиком, поэтому `--check` после такой правки
+# закономерно покажет расхождение с каноном — это ожидаемо и осознанно
+# игнорируется в отчёте ревью, см. docs/kits/SAFETY-NET.md, «Что делать при
+# расхождении» (п.2).
+
+[importlinter]
+# include_external_packages нужен: forbidden_modules перечисляет пакеты,
+# внешние относительно root_packages.
+include_external_packages = True
+root_packages =
+    orchestrationkit
+exclude_type_checking_imports = True
+
+[importlinter:contract:no-undeclared-kits]
+name = orchestrationkit не импортирует киты, которых нет в его зависимостях
+type = forbidden
+source_modules =
+    orchestrationkit
+forbidden_modules =
+    accountpoolkit
+    adapterkit
+    agentskit
+    aichatkit
+    authkit_client
+    authkit_contracts
+    authkit_server
+    b24kit
+    browserkit
+    chatkit
+    clientkit
+    clikit
+    emojikit
+    gitkit
+    installerkit
+    iokit
+    issuekit
+    leasekit
+    librarykit
+    maxkit
+    modelkit
+    netkit
+    ormkit
+    persistkit
+    servicekit
+    sessionkit
+    skillkit
+    socialkit
+    storagekit
+    telemetrykit
+    totp_client
+    worker_service

s_orchestrationkit-0.1.0/.skillgateignore

@@ -0,0 +1,12 @@
+# Исключения для секрет-скана s-skillgate перед push. Глобы — от корня репо.
+#
+# scripts/check_dist_leaks.py — сам гейт утечки личных данных (сетка
+# безопасности китов, docs/kits/SAFETY-NET.md в devcontour), копия из
+# tools/kits/template/check_dist_leaks.py. Ловит по классам, не по строкам:
+# windows-путь с числовым именем пользователя, личный ящик на публичном
+# провайдере, юникс-домашний путь. Regex-паттерны и пример подсказки
+# (windows-путь с числовым account, «/home/user») по определению совпадают
+# с собственным денилистом — иначе гейт не проверял бы то, ради чего написан (та же
+# ситуация, что и с tests/golden/ у самого check_dist_leaks.py). Файл
+# копируется буквально из канона — правки идут в шаблон, не сюда.
+scripts/check_dist_leaks.py

s_orchestrationkit-0.1.0/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+Формат — [Keep a Changelog](https://keepachangelog.com/ru/1.0.0/).
+
+## [0.1.0] — 2026-09-08
+
+Первый выпуск. Волна 5 платформы китов (Atlas #2710, Ruling 5-3): связный
+кластер оркестрации выделен из `librarykit` (`orchestration/*`, `entities.py`,
+`ports.py`, `enums.py`, `protocols.py`, `fanout.py`, 1 763 строки) — три
+внешних потребителя (`adapterkit`, `gws`, `bublictr`).
+
+### Added
+
+- `orchestrationkit.orchestration` — `SessionLoader`, `HealthMonitor`,
+  `OnboardingService`/`OnboardingDeps`.
+- `orchestrationkit.entities`, `orchestrationkit.ports`, `orchestrationkit.enums`,
+  `orchestrationkit.protocols`, `orchestrationkit.fanout`.
+- Сетка безопасности (`apply_template.py . --namespace S-kits`).

s_orchestrationkit-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dmitry
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

s_orchestrationkit-0.1.0/PKG-INFO

@@ -0,0 +1,67 @@
+Metadata-Version: 2.5
+Name: s-orchestrationkit
+Version: 0.1.0
+Summary: Развязанные оркестраторы КОРНЯ китов (SessionLoader/HealthMonitor/OnboardingService) + сущности/порты/перечисления/протоколы/веер проб — связный кластер, переехавший из librarykit (волна 5, Ruling 5-3), три внешних потребителя.
+Author: Dmitry
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: s-corekit>=0.0.13
+Description-Content-Type: text/markdown
+
+# orchestrationkit
+
+Развязанные оркестраторы КОРНЯ китов экосистемы S-kits: `SessionLoader`,
+`HealthMonitor`, `OnboardingService` — плюс их общий фундамент (нейтральные
+сущности, порты, канонические перечисления, контракты и внутренний веер
+параллельных проб).
+
+## Откуда
+
+Родился волной 5 платформы китов (Atlas #2710, `docs/superpowers/plans/
+2026-09-08-kits-wave5-librarykit.md`, Ruling 5-3) выделением из `librarykit`
+связного кластера в 1 763 строки, у которого было ТРИ разных внешних
+потребителя (`adapterkit`, `gws`, `bublictr`) — оркестрация стоит на сущностях
+и портах, протоколы — контракт для неё же, веер проб — её внутренний примитив.
+Это случай «новый дом», а не «раскидать по чужим китам».
+
+## Состав
+
+- `orchestrationkit.orchestration` — `SessionLoader`, `HealthMonitor` (+
+  `classify_health_state`, `register_health_probe`/`get_health_probe`,
+  `GenericAdapterHealthProbe`), `OnboardingService`/`OnboardingDeps`.
+- `orchestrationkit.entities` — домен-нейтральные носители данных (`Session`,
+  `SessionContext`, `HealthReport`, `RawHealthStatus`, ...).
+- `orchestrationkit.ports` — Protocol-порты под оркестрацию (репозитории,
+  probe, secret store).
+- `orchestrationkit.enums` — канонические перечисления состояний
+  (`HealthState`, `SsoState`).
+- `orchestrationkit.protocols` — контракты подключения и здоровья.
+- `orchestrationkit.fanout` — веер параллельных проб (внутренний примитив
+  здоровья, используется `HealthMonitor`).
+
+## Закон слоёв
+
+Только `corekit` (единственная точка — `corekit.dto.SessionRef` в
+`protocols.py`). Никакого импорта `librarykit`/`adapterkit`/`clikit`/
+`bublictr` — доменные привязки (реестр адаптеров, `Operation`/`TargetKind`,
+координаты `SessionRef`, audit-store, браузерный профиль) инъектируются
+доменом при инстанцировании. Контракт закреплён `.importlinter`.
+
+## Совместимость
+
+`librarykit.orchestration`/`.entities`/`.ports`/`.enums`/`.protocols`/`.fanout`
+остаются алиасами (`sys.modules`-подмена) на этот кит — прежние импорты
+работают байт-в-байт.
+
+## Разработка
+
+```
+uv sync
+uv run pytest -q
+uv run ruff check .
+uv run lint-imports
+```
+
+Сетка безопасности (CI/release_guard/check_dist_leaks/importlinter) — из
+`devcontour/tools/kits/template/`, см. `docs/kits/SAFETY-NET.md` в devcontour.

s_orchestrationkit-0.1.0/README.md

@@ -0,0 +1,56 @@
+# orchestrationkit
+
+Развязанные оркестраторы КОРНЯ китов экосистемы S-kits: `SessionLoader`,
+`HealthMonitor`, `OnboardingService` — плюс их общий фундамент (нейтральные
+сущности, порты, канонические перечисления, контракты и внутренний веер
+параллельных проб).
+
+## Откуда
+
+Родился волной 5 платформы китов (Atlas #2710, `docs/superpowers/plans/
+2026-09-08-kits-wave5-librarykit.md`, Ruling 5-3) выделением из `librarykit`
+связного кластера в 1 763 строки, у которого было ТРИ разных внешних
+потребителя (`adapterkit`, `gws`, `bublictr`) — оркестрация стоит на сущностях
+и портах, протоколы — контракт для неё же, веер проб — её внутренний примитив.
+Это случай «новый дом», а не «раскидать по чужим китам».
+
+## Состав
+
+- `orchestrationkit.orchestration` — `SessionLoader`, `HealthMonitor` (+
+  `classify_health_state`, `register_health_probe`/`get_health_probe`,
+  `GenericAdapterHealthProbe`), `OnboardingService`/`OnboardingDeps`.
+- `orchestrationkit.entities` — домен-нейтральные носители данных (`Session`,
+  `SessionContext`, `HealthReport`, `RawHealthStatus`, ...).
+- `orchestrationkit.ports` — Protocol-порты под оркестрацию (репозитории,
+  probe, secret store).
+- `orchestrationkit.enums` — канонические перечисления состояний
+  (`HealthState`, `SsoState`).
+- `orchestrationkit.protocols` — контракты подключения и здоровья.
+- `orchestrationkit.fanout` — веер параллельных проб (внутренний примитив
+  здоровья, используется `HealthMonitor`).
+
+## Закон слоёв
+
+Только `corekit` (единственная точка — `corekit.dto.SessionRef` в
+`protocols.py`). Никакого импорта `librarykit`/`adapterkit`/`clikit`/
+`bublictr` — доменные привязки (реестр адаптеров, `Operation`/`TargetKind`,
+координаты `SessionRef`, audit-store, браузерный профиль) инъектируются
+доменом при инстанцировании. Контракт закреплён `.importlinter`.
+
+## Совместимость
+
+`librarykit.orchestration`/`.entities`/`.ports`/`.enums`/`.protocols`/`.fanout`
+остаются алиасами (`sys.modules`-подмена) на этот кит — прежние импорты
+работают байт-в-байт.
+
+## Разработка
+
+```
+uv sync
+uv run pytest -q
+uv run ruff check .
+uv run lint-imports
+```
+
+Сетка безопасности (CI/release_guard/check_dist_leaks/importlinter) — из
+`devcontour/tools/kits/template/`, см. `docs/kits/SAFETY-NET.md` в devcontour.

s_orchestrationkit-0.1.0/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] = []

s_orchestrationkit-0.1.0/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}")