s-clientkit 0.0.1__tar.gz → 0.2.0__tar.gz

{s_clientkit-0.0.1 → s_clientkit-0.2.0}/.gitignore

@@ -1,47 +1,47 @@
-# === atlas universal gitignore ===
-
-# OS / IDE
-.DS_Store
-Thumbs.db
-.vscode/
-.idea/
-*.swp
-*.swo
-
-# Sensitive
-.env
-.env.local
-*.key
-*.pem
-secrets/
-private/
-
-# Python
-__pycache__/
-*.py[cod]
-.venv/
-venv/
-.pytest_cache/
-.ruff_cache/
-*.egg-info/
-
-# Node / JS
-node_modules/
-.next/
-dist/
-build/
-
-# Temporary / large
-*.log
-*.tmp
-nul
-NUL
-*.zip
-*.rar
-*.7z
-
-# Media (selectively unignore via !path/*.ext if needed for fixtures)
-*.mp4
-*.mov
-*.avi
-*.mkv
+# === atlas universal gitignore ===
+
+# OS / IDE
+.DS_Store
+Thumbs.db
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Sensitive
+.env
+.env.local
+*.key
+*.pem
+secrets/
+private/
+
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+.pytest_cache/
+.ruff_cache/
+*.egg-info/
+
+# Node / JS
+node_modules/
+.next/
+dist/
+build/
+
+# Temporary / large
+*.log
+*.tmp
+nul
+NUL
+*.zip
+*.rar
+*.7z
+
+# Media (selectively unignore via !path/*.ext if needed for fixtures)
+*.mp4
+*.mov
+*.avi
+*.mkv

s_clientkit-0.2.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=cifropro1/products, project=clientkit,
+#   top-level pipeline file=.gitlab-ci.yml, environment — пусто).
+# Дистрибутив на PyPI: s-clientkit.
+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_clientkit-0.2.0/.importlinter

@@ -0,0 +1,65 @@
+# СГЕНЕРИРОВАНО из devcontour/tools/kits/template/importlinter.ini — не правь
+# здесь. Правка идёт в шаблон, затем `python tools/kits/apply_template.py <кит>`.
+#
+# Заготовка контракта слоёв. Запуск: `uv run --with import-linter lint-imports`.
+#
+# Контракт ниже — минимум, который годится ЛЮБОМУ киту и не требует ручной
+# настройки: «clientkit не импортирует те киты экосистемы, которых нет в его
+# объявленных зависимостях». Скрытая зависимость — это кит, который работает у
+# автора (сосед стоит в 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 =
+    clientkit
+exclude_type_checking_imports = True
+
+[importlinter:contract:no-undeclared-kits]
+name = clientkit не импортирует киты, которых нет в его зависимостях
+type = forbidden
+source_modules =
+    clientkit
+forbidden_modules =
+    accountpoolkit
+    agentskit
+    aichatkit
+    authkit_contracts
+    authkit_server
+    b24kit
+    browserkit
+    chatkit
+    clikit
+    emojikit
+    gitkit
+    installerkit
+    iokit
+    issuekit
+    leasekit
+    librarykit
+    maxkit
+    modelkit
+    ormkit
+    persistkit
+    servicekit
+    sessionkit
+    skillkit
+    socialkit
+    storagekit
+    telemetrykit
+    totp_client
+    worker_service

s_clientkit-0.2.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_clientkit-0.0.1 → s_clientkit-0.2.0}/AGENTS.md

@@ -1,45 +1,45 @@
-# AGENTS.md — clientkit
-
-> Контекст для AI-ассистентов (Claude Code, ChatGPT, Cursor и т.п.), работающих
-> над этим проектом.
-
-## Что это
-
-(заполнить one-line)
-
-## Atlas
-
-Проект зарегистрирован в Atlas-БД (Atlas). Карточка:
-
-```sh
-atlas project get clientkit
-```
-
-Любые изменения метаданных (приоритет, статус, теги) — через atlas CLI:
-
-- `atlas project update clientkit --priority P0` — поменять приоритет
-- `atlas project tag add clientkit -t domain:<slug>` — добавить тег
-- `atlas project move clientkit --to-type <type>` — конвертировать тип
-
-## Тип / Статус (на момент создания)
-
-- type=`kit`, status=`active`, priority=`P2`
-
-## Правила работы
-
-- Все исходные тексты, документы, код проекта — в этом репо.
-- Чувствительные данные (`.env`, токены, ключи) — игнорируются `.gitignore`.
-- AI-ассистенту разрешено: читать, генерировать, редактировать в этом репо.
-
-## Канонические команды
-
-- `atlas project get clientkit` — карточка проекта
-- `atlas task list --project clientkit` — задачи проекта (когда W7
-  волна будет реализована)
-
-<!-- atlas:usage:start -->
-## Управление проектом — через Atlas
-
-Этот проект ведётся в Atlas (личная PM-система портфеля). Для задач/проектов/эпиков/бэкапов
-используй CLI `atlas` и вызывай навык `atlas` — вся логика и роутинг внутри навыка.
-<!-- atlas:usage:end -->
+# AGENTS.md — clientkit
+
+> Контекст для AI-ассистентов (Claude Code, ChatGPT, Cursor и т.п.), работающих
+> над этим проектом.
+
+## Что это
+
+(заполнить one-line)
+
+## Atlas
+
+Проект зарегистрирован в Atlas-БД (Atlas). Карточка:
+
+```sh
+atlas project get clientkit
+```
+
+Любые изменения метаданных (приоритет, статус, теги) — через atlas CLI:
+
+- `atlas project update clientkit --priority P0` — поменять приоритет
+- `atlas project tag add clientkit -t domain:<slug>` — добавить тег
+- `atlas project move clientkit --to-type <type>` — конвертировать тип
+
+## Тип / Статус (на момент создания)
+
+- type=`kit`, status=`active`, priority=`P2`
+
+## Правила работы
+
+- Все исходные тексты, документы, код проекта — в этом репо.
+- Чувствительные данные (`.env`, токены, ключи) — игнорируются `.gitignore`.
+- AI-ассистенту разрешено: читать, генерировать, редактировать в этом репо.
+
+## Канонические команды
+
+- `atlas project get clientkit` — карточка проекта
+- `atlas task list --project clientkit` — задачи проекта (когда W7
+  волна будет реализована)
+
+<!-- atlas:usage:start -->
+## Управление проектом — через Atlas
+
+Этот проект ведётся в Atlas (личная PM-система портфеля). Для задач/проектов/эпиков/бэкапов
+используй CLI `atlas` и вызывай навык `atlas` — вся логика и роутинг внутри навыка.
+<!-- atlas:usage:end -->

s_clientkit-0.2.0/CHANGELOG.md

@@ -0,0 +1,71 @@
+# Changelog — s-clientkit
+
+## [0.2.0] — 2026-09-08
+
+Слияние в adapterkit (волна 5, задача 2, Atlas #2710): у кита не набралось
+живой массы под отдельный релизный цикл — единственный внешний потребитель
+(reverse-factory) ходит только за `clientkit.identity`, а адреса-кандидаты уже
+были тонкой обёрткой над `adapterkit.endpoints.EndpointRegistry`.
+
+### Breaking
+
+- Весь код (декларация сервиса, сборка белого/скрытого клиента, каталог имён
+  сервисов, адреса-кандидаты) переехал в `adapterkit.clientkit`. Пакет
+  `clientkit` — ТЕПЕРЬ ТОНКИЙ АЛИАС: каждый модуль (`clientkit.identity`,
+  `clientkit.declaration`, `clientkit.builder`, `clientkit.hidden`,
+  `clientkit.white`, `clientkit.ports`, `clientkit.errors`, `clientkit._base`,
+  `clientkit._candidates`) реэкспортирует одноимённый модуль
+  `adapterkit.clientkit.*`. Публичная поверхность (`from clientkit import
+  build_from_toml`, `from clientkit.identity import CATALOG`, …) сохранена 1:1.
+- `s-adapterkit` — теперь ОБЯЗАТЕЛЬНАЯ базовая зависимость (`>=0.2.0,<0.3`,
+  extra `client` внутри неё тянет `s-netkit`): даже `clientkit.identity` физически
+  лежит в `adapterkit.clientkit.identity`.
+- Extra `endpoints` — теперь no-op (`s-adapterkit` и так обязателен, ставить
+  отдельно больше нечего). Оставлен пустым, а не удалён, чтобы старый
+  `pip install s-clientkit[endpoints]` не падал `ExtraNotFound`.
+- Extra `hidden` теперь форвардит `s-adapterkit[client-hidden]` вместо прямого
+  `s-authkit-client` (тот же пакет приезжает транзитивно).
+
+## [0.1.0] — 2026-09-06
+
+Волна китов-оснований: транспорт только через netkit, свой `TokenBucket` удалён.
+
+### Breaking
+- `s-netkit` теперь ОБЯЗАТЕЛЬНАЯ базовая зависимость (`>=0.1.1,<0.2`), extra
+  `net` убран — «поставил кит без netkit» больше не собирается вовсе.
+- `clientkit._limit.TokenBucket` удалён. Гейт лимита в
+  `ServiceClientBase` — теперь `netkit.limit.RateLimiter` (тот же смысл:
+  «не чаще `rate` в секунду при ёмкости `burst`», объявленный в `[limits]`
+  декларации сервиса).
+- `resolve_transport()` больше НЕ откатывается на голый `httpx.AsyncClient()`,
+  если под netkit что-то пошло не так, — молчаливая деградация с
+  `except Exception` заменена на `except ImportError`. Без netkit — отказ
+  `clientkit.errors.TransportUnavailable` с рецептом (`pip install s-netkit`
+  либо свой `transport=`), а не «тихо поехали на другом транспорте».
+
+### Changed
+- `clientkit.errors` — новый `TransportUnavailable` (та же доменная иерархия,
+  код `TRANSPORT_UNAVAILABLE`).
+
+## 0.0.1 — кит-сборщик (задача #1423)
+
+Первый выпуск.
+
+- `clientkit.declaration` — декларация сервиса как ДАННЫЕ (`ServiceDecl` и
+  соседи, frozen dataclass'ы, round-trip в обычный dict, загрузка из TOML,
+  валидация при загрузке).
+- `clientkit.builder` — `build_client` / `build_from_toml`: единственная развилка
+  кита, и она смотрит на `decl.kind`.
+- `clientkit.white` — белый API: заголовок авторизации (`api_key`/`bearer`/
+  `oauth` с проактивным TTL) + прямой запрос. Ни сессий, ни чеканки, ни антибота.
+- `clientkit.hidden` — скрытый API: лестница доступа из декларации, чеканка через
+  порт слоя доступа, ротация адресов-кандидатов, разбор отказов через
+  `corekit.diagnosis.access`.
+- `clientkit._candidates` — книга адресов поверх `adapterkit.EndpointRegistry`
+  либо равнозначная встроенная (совпадение проверено тестом).
+- `clientkit.ports` — `RequestPort` / `SecretLookup`; умолчание транспорта
+  (netkit → httpx) резолвится лениво.
+
+Главное свойство: потребитель зовёт `await client.call("me")` одинаково в обоих
+мирах, при этом белый путь не поднимает ни сессий, ни чеканки, ни антибота и
+делает ровно один запрос.

{s_clientkit-0.0.1 → s_clientkit-0.2.0}/PKG-INFO

@@ -1,27 +1,30 @@
 Metadata-Version: 2.5
 Name: s-clientkit
-Version: 0.0.1
-Summary: КИТ-СБОРЩИК: по ДЕКЛАРАЦИИ сервиса (TOML/dataclass) собирает готовый клиент из слоёв — белый API прямыми запросами, скрытый с удержанием доступа. Потребитель зовёт одинаково.
+Version: 0.2.0
+Summary: КИТ-АЛИАС: код-сборщик клиента переехал в adapterkit.clientkit (волна 5, задача 2, Atlas #2710) — этот пакет тонко реэкспортирует его модули под прежними именами (clientkit.identity и остальные).
 Author: Dmitry
 License: MIT
 License-File: LICENSE
 Requires-Python: >=3.11
+Requires-Dist: s-adapterkit[client]<0.3,>=0.2.0
 Requires-Dist: s-corekit>=0.0.2
 Provides-Extra: dev
 Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
 Requires-Dist: pytest>=8; extra == 'dev'
 Requires-Dist: ruff>=0.8; extra == 'dev'
 Provides-Extra: endpoints
-Requires-Dist: s-adapterkit>=0.1.8; extra == 'endpoints'
 Provides-Extra: hidden
-Requires-Dist: s-authkit-client>=0.0.2; extra == 'hidden'
+Requires-Dist: s-adapterkit[client-hidden]<0.3,>=0.2.0; extra == 'hidden'
 Provides-Extra: http
 Requires-Dist: httpx>=0.27; extra == 'http'
-Provides-Extra: net
-Requires-Dist: s-netkit>=0.0.2; extra == 'net'
 Description-Content-Type: text/markdown
 
-# s-clientkit — кит-сборщик клиентов
+# s-clientkit — тонкий алиас поверх adapterkit.clientkit
+
+> **Волна 5, задача 2 (Atlas #2710):** живой код переехал в
+> `adapterkit.clientkit` — здесь остались тонкие модули-реэкспорты. Публичная
+> поверхность (всё, что описано ниже) не изменилась; изменился только адрес
+> кода под ней.
 
 Готовый клиент сервиса **собирается по декларации**, а не пишется заново.
 
@@ -72,7 +75,8 @@ await hidden.call("me")     # скрытый API с сессией и лестн
 ## Чего в ките нет
 
 * **своего HTTP** — «чем ходить» приходит аргументом (`RequestPort`), умолчание
-  (netkit → httpx) резолвится лениво;
+  (только netkit; без него — `TransportUnavailable` с рецептом установки) резолвится
+  лениво;
 * **своего браузера** — чеканка приходит через порт слоя доступа;
 * **своей таксономии отказов** — диагноз ставит `corekit.diagnosis.access`, та же
   функция, что у живой пробы и у реестра эндпоинтов.

{s_clientkit-0.0.1 → s_clientkit-0.2.0}/README.md

@@ -1,4 +1,9 @@
-# s-clientkit — кит-сборщик клиентов
+# s-clientkit — тонкий алиас поверх adapterkit.clientkit
+
+> **Волна 5, задача 2 (Atlas #2710):** живой код переехал в
+> `adapterkit.clientkit` — здесь остались тонкие модули-реэкспорты. Публичная
+> поверхность (всё, что описано ниже) не изменилась; изменился только адрес
+> кода под ней.
 
 Готовый клиент сервиса **собирается по декларации**, а не пишется заново.
 
@@ -49,7 +54,8 @@ await hidden.call("me")     # скрытый API с сессией и лестн
 ## Чего в ките нет
 
 * **своего HTTP** — «чем ходить» приходит аргументом (`RequestPort`), умолчание
-  (netkit → httpx) резолвится лениво;
+  (только netkit; без него — `TransportUnavailable` с рецептом установки) резолвится
+  лениво;
 * **своего браузера** — чеканка приходит через порт слоя доступа;
 * **своей таксономии отказов** — диагноз ставит `corekit.diagnosis.access`, та же
   функция, что у живой пробы и у реестра эндпоинтов.

s_clientkit-0.2.0/clientkit/__init__.py

@@ -0,0 +1,126 @@
+"""clientkit — ТОНКИЙ АЛИАС поверх ``adapterkit.clientkit`` (волна 5, задача 2,
+Atlas #2710).
+
+БЫЛО СВОИМ КИТОМ-СБОРЩИКОМ, СТАЛО АЛИАСОМ. Живой код (декларация сервиса,
+сборка белого/скрытого клиента, каталог имён сервисов, адреса-кандидаты)
+переехал в :mod:`adapterkit.clientkit` — рядом с реестром адресов
+(:class:`adapterkit.endpoints.EndpointRegistry`), которым адреса-кандидаты и
+раньше пользовались (см. историю ``clientkit._candidates``). Единственный
+известный внешний потребитель на момент переноса — reverse-factory, и он ходит
+ТОЛЬКО за :mod:`clientkit.identity` (``CATALOG``/``ServiceIdentity``/
+``UnknownService``/``canonical``): этот путь работает как раньше, включая
+установку без extra-флагов.
+
+Каждый модуль здесь (``clientkit.identity``, ``clientkit.declaration``,
+``clientkit.builder``, ``clientkit.hidden``, ``clientkit.white``,
+``clientkit.ports``, ``clientkit.errors``, ``clientkit._base``,
+``clientkit._candidates``) — тонкий файл-реэкспорт одноимённого модуля
+``adapterkit.clientkit.*``: ``import clientkit.builder`` и т.п. продолжает
+работать, даже если что-то в экосистеме импортирует их напрямую, а не через
+корень пакета.
+
+ОДИН ВЫЗОВ НА ОБА МИРА (без изменений)::
+
+    from clientkit import build_from_toml
+
+    white  = build_from_toml("examples/white_service.toml",  secrets=os.environ.get)
+    hidden = build_from_toml("examples/hidden_service.toml", session_store=store)
+
+    await white.call("me")      # белый REST с api-ключом
+    await hidden.call("me")     # скрытый API с сессией и лестницей деградации
+"""
+from __future__ import annotations
+
+import importlib
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:  # pragma: no cover — для тайпчекера/IDE
+    from adapterkit.clientkit._base import ServiceClient
+    from adapterkit.clientkit.builder import build_client, build_from_toml
+    from adapterkit.clientkit.declaration import (
+        AccessRecipe,
+        AuthDecl,
+        AuthScheme,
+        EndpointDecl,
+        LimitDecl,
+        ServiceDecl,
+        ServiceKind,
+        decl_from_data,
+        decl_to_data,
+        load_toml,
+    )
+    from adapterkit.clientkit.errors import AccessUnavailable, ClientBuildError, OperationFailed
+    from adapterkit.clientkit.hidden import HiddenApiClient
+    from adapterkit.clientkit.identity import (
+        CATALOG,
+        Instancing,
+        ServiceIdentity,
+        UnknownService,
+        canonical,
+        resolve_service,
+        suggest_service,
+    )
+    from adapterkit.clientkit.ports import RequestPort, SecretLookup
+    from adapterkit.clientkit.white import WhiteApiClient
+
+#: имя -> модуль-владелец В adapterkit.clientkit (не в этом пакете — этот
+#: пакет сам ничего не реализует). `hidden` в этой таблице стоит РЯДОМ с
+#: `white`, но цена у них разная: обращение к `HiddenApiClient` подтягивает
+#: слой доступа, а к `WhiteApiClient` — нет. Ленивость здесь и защищает эту
+#: разницу.
+_LAZY_NAMES: dict[str, str] = {
+    "build_client": "adapterkit.clientkit.builder",
+    "build_from_toml": "adapterkit.clientkit.builder",
+    "ServiceClient": "adapterkit.clientkit._base",
+    # ИМЯ сервиса — тоже данные, и притом нужные тем, кто базы не держит:
+    # навыку назвать свою сессию, записи трафика — положить снимок.
+    "ServiceIdentity": "adapterkit.clientkit.identity",
+    "Instancing": "adapterkit.clientkit.identity",
+    "UnknownService": "adapterkit.clientkit.identity",
+    "CATALOG": "adapterkit.clientkit.identity",
+    "canonical": "adapterkit.clientkit.identity",
+    "resolve_service": "adapterkit.clientkit.identity",
+    "suggest_service": "adapterkit.clientkit.identity",
+    # декларация — данные
+    "ServiceDecl": "adapterkit.clientkit.declaration",
+    "ServiceKind": "adapterkit.clientkit.declaration",
+    "AuthDecl": "adapterkit.clientkit.declaration",
+    "AuthScheme": "adapterkit.clientkit.declaration",
+    "LimitDecl": "adapterkit.clientkit.declaration",
+    "EndpointDecl": "adapterkit.clientkit.declaration",
+    "AccessRecipe": "adapterkit.clientkit.declaration",
+    "decl_from_data": "adapterkit.clientkit.declaration",
+    "decl_to_data": "adapterkit.clientkit.declaration",
+    "load_toml": "adapterkit.clientkit.declaration",
+    # порты
+    "RequestPort": "adapterkit.clientkit.ports",
+    "SecretLookup": "adapterkit.clientkit.ports",
+    # клиенты (обычно не нужны напрямую — собирает build_client)
+    "WhiteApiClient": "adapterkit.clientkit.white",
+    "HiddenApiClient": "adapterkit.clientkit.hidden",
+    # ошибки
+    "ClientBuildError": "adapterkit.clientkit.errors",
+    "AccessUnavailable": "adapterkit.clientkit.errors",
+    "OperationFailed": "adapterkit.clientkit.errors",
+}
+
+__all__ = ["__version__", *sorted(_LAZY_NAMES)]
+
+
+def __getattr__(name: str):
+    if name == "__version__":
+        from ._version import resolve_version
+
+        value = resolve_version()
+        globals()["__version__"] = value
+        return value
+    module_name = _LAZY_NAMES.get(name)
+    if module_name is None:
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+    value = getattr(importlib.import_module(module_name), name)
+    globals()[name] = value
+    return value
+
+
+def __dir__() -> list[str]:
+    return sorted({*globals(), *_LAZY_NAMES})

s_clientkit-0.2.0/clientkit/_base.py

@@ -0,0 +1,9 @@
+"""Тонкий алиас — код переехал в ``adapterkit.clientkit._base`` (волна 5,
+задача 2, Atlas #2710). Реэкспорт ради back-compat: ``from clientkit._base
+import ServiceClient`` работает идентично.
+"""
+from __future__ import annotations
+
+from adapterkit.clientkit._base import ServiceClient, ServiceClientBase
+
+__all__ = ["ServiceClient", "ServiceClientBase"]

s_clientkit-0.2.0/clientkit/_candidates.py

@@ -0,0 +1,9 @@
+"""Тонкий алиас — код переехал в ``adapterkit.clientkit._candidates`` (волна 5,
+задача 2, Atlas #2710). Реэкспорт ради back-compat: ``from clientkit._candidates
+import CandidateBook`` работает идентично.
+"""
+from __future__ import annotations
+
+from adapterkit.clientkit._candidates import CandidateBook
+
+__all__ = ["CandidateBook"]