s-accountpoolkit 0.0.1__tar.gz

s_accountpoolkit-0.0.1/.gitignore

@@ -0,0 +1,8 @@
+.venv/
+__pycache__/
+*.pyc
+dist/
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+uv.lock

s_accountpoolkit-0.0.1/.gitlab-ci.yml

@@ -0,0 +1,31 @@
+# Автопубликация на PyPI по семвер-тегу vX.Y.Z через Trusted Publishing (OIDC).
+# Токены НИГДЕ не хранятся: GitLab выдаёт короткоживущий OIDC-токен (PYPI_ID_TOKEN),
+# он одноразово обменивается на PyPI API-токен. Издатель настраивается на pypi.org:
+#   Manage -> Publishing -> GitLab  (namespace=S-kits, project=accountpoolkit,
+#   top-level pipeline file=.gitlab-ci.yml, environment — пусто).
+# Запускается ТОЛЬКО на тег vX.Y.Z (обычный push на main ничего не публикует).
+stages: [publish]
+
+publish-pypi:
+  stage: publish
+  image: ghcr.io/astral-sh/uv:python3.12-bookworm
+  rules:
+    - if: $CI_COMMIT_TAG =~ /^v\d+\.\d+\.\d+$/
+  id_tokens:
+    PYPI_ID_TOKEN:
+      aud: pypi
+  script:
+    - uv build
+    # обмен GitLab OIDC -> одноразовый PyPI API-токен (Trusted Publishing):
+    - |
+      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_accountpoolkit-0.0.1/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.4
+Name: s-accountpoolkit
+Version: 0.0.1
+Summary: Зрелый пул аккаунтов/сессий поверх librarykit: статус-машина аккаунта, quota/подписки, rate-limit + circuit-breaker, OAuth-ротация (single-flight DCL-lock), egress-пул с quarantine, import/export, headless-фасад. Обобщение gemini-balancer в переиспользуемый доменный слой.
+Author: Dmitry
+License: MIT
+Requires-Python: >=3.11
+Requires-Dist: pydantic>=2.6
+Requires-Dist: s-librarykit>=0.1.17
+Provides-Extra: cli
+Requires-Dist: s-clikit>=0.1; extra == 'cli'
+Provides-Extra: egress
+Requires-Dist: s-librarykit[antibot]>=0.1.17; extra == 'egress'
+Provides-Extra: rest
+Requires-Dist: starlette>=0.37; extra == 'rest'
+Requires-Dist: uvicorn>=0.30; extra == 'rest'
+Description-Content-Type: text/markdown
+
+# s-accountpoolkit
+
+Зрелый **пул аккаунтов/сессий** поверх [`s-librarykit`](https://gitlab.com/S-kits/librarykit) — доменный слой над `SessionStore`/`SessionPool`/`RateLimiter`/`RotatingAuth`/antibot-транспортами. Обобщение gemini-balancer в переиспользуемый кит.
+
+**import-имя** `accountpoolkit` · **dist-имя** `s-accountpoolkit` (как s-librarykit → librarykit).
+
+## Что даёт (сверх librarykit)
+
+- **Account со статус-машиной** — `available / cooldown / quota_exhausted / disabled / blocked` с причинами и таймстемпами (не строка+`is_active`).
+- **Quota / подписки** — `QuotaData` union (dual-window weekly+5h / header-based / JWT-claims), приоритет `ULTRA > PRO > FREE`, model-level изоляция.
+- **Rate-limit + circuit-breaker** — разбор 429/403/5xx/Retry-After, exp-backoff по причинам, cooldown отдельно от CB-open, авто-recovery.
+- **Selector** — двухслойный (жёсткий eligibility-фильтр → Power-of-Two-Choices), приоритет-каскад подписка→квота→health→reset, sticky-сессии, slow-start.
+- **OAuth-ротация** — single-flight (double-checked-locking) на аккаунт, атомарный rolling-refresh, fallback-цепочка OAuth-клиентов, `invalid_grant` → карантин, проактивный фоновый рефреш, keyring-экспорт токена.
+- **Egress-пул** — привязка аккаунт↔прокси (sticky IP) vs глобальный пул, стратегии (RR/Weighted/LeastConn/Priority/P2C), health-check, **настоящий per-proxy circuit-breaker/quarantine**.
+- **Import/export** — версионированный конверт, идемпотентный upsert, чтение чужих сторов.
+- **Headless `AccountService`-фасад** + `clikit` CLI (json-by-default); опц. REST admin (`[rest]`) + cloudflared tunnel (`[tunnel]`).
+
+Секреты — только через librarykit `SessionStore` (envelope KEK/DEK) / `SecretStore` (keyring+fallback). Никакого plaintext.
+
+Провайдер-специфика (gemini / codex / …) — через `AccountProvider` Protocol-плагины; ядро её не знает.
+
+## Установка
+
+```bash
+uv add s-accountpoolkit          # ядро
+uv add "s-accountpoolkit[egress]"  # + antibot health-транспорт для egress-пула
+uv add "s-accountpoolkit[cli]"     # + CLI `accountpool` (json-by-default)
+```
+
+import-имя — `accountpoolkit`. `AccountService` — headless-фасад над всеми слоями:
+
+```python
+import accountpoolkit as apk
+from librarykit.sessions import SessionStore
+
+store = apk.AccountStore(SessionStore(root=None, encrypt=True), social="myservice")
+pool = apk.AccountPool(store, tracker=apk.RateLimitTracker())
+svc = apk.AccountService(store=store, pool=pool)
+
+choice = await svc.acquire(require_tier=apk.SubscriptionTier.PRO)
+if choice:
+    ...  # запрос через choice.proxy (egress) + choice.account (device/creds)
+    await svc.report(choice.ref, response=resp)  # 429/5xx → cooldown/circuit-breaker
+```
+
+## Статус
+
+Ядро стабильно: статус-машина аккаунта, quota/подписки, rate-limit + circuit-breaker,
+OAuth-ротация (single-flight), egress-пул, import/export, `AccountService`-фасад + CLI.
+Провайдер-плагины подключаются через entry-points `accountpoolkit.providers`.

s_accountpoolkit-0.0.1/README.md

@@ -0,0 +1,50 @@
+# s-accountpoolkit
+
+Зрелый **пул аккаунтов/сессий** поверх [`s-librarykit`](https://gitlab.com/S-kits/librarykit) — доменный слой над `SessionStore`/`SessionPool`/`RateLimiter`/`RotatingAuth`/antibot-транспортами. Обобщение gemini-balancer в переиспользуемый кит.
+
+**import-имя** `accountpoolkit` · **dist-имя** `s-accountpoolkit` (как s-librarykit → librarykit).
+
+## Что даёт (сверх librarykit)
+
+- **Account со статус-машиной** — `available / cooldown / quota_exhausted / disabled / blocked` с причинами и таймстемпами (не строка+`is_active`).
+- **Quota / подписки** — `QuotaData` union (dual-window weekly+5h / header-based / JWT-claims), приоритет `ULTRA > PRO > FREE`, model-level изоляция.
+- **Rate-limit + circuit-breaker** — разбор 429/403/5xx/Retry-After, exp-backoff по причинам, cooldown отдельно от CB-open, авто-recovery.
+- **Selector** — двухслойный (жёсткий eligibility-фильтр → Power-of-Two-Choices), приоритет-каскад подписка→квота→health→reset, sticky-сессии, slow-start.
+- **OAuth-ротация** — single-flight (double-checked-locking) на аккаунт, атомарный rolling-refresh, fallback-цепочка OAuth-клиентов, `invalid_grant` → карантин, проактивный фоновый рефреш, keyring-экспорт токена.
+- **Egress-пул** — привязка аккаунт↔прокси (sticky IP) vs глобальный пул, стратегии (RR/Weighted/LeastConn/Priority/P2C), health-check, **настоящий per-proxy circuit-breaker/quarantine**.
+- **Import/export** — версионированный конверт, идемпотентный upsert, чтение чужих сторов.
+- **Headless `AccountService`-фасад** + `clikit` CLI (json-by-default); опц. REST admin (`[rest]`) + cloudflared tunnel (`[tunnel]`).
+
+Секреты — только через librarykit `SessionStore` (envelope KEK/DEK) / `SecretStore` (keyring+fallback). Никакого plaintext.
+
+Провайдер-специфика (gemini / codex / …) — через `AccountProvider` Protocol-плагины; ядро её не знает.
+
+## Установка
+
+```bash
+uv add s-accountpoolkit          # ядро
+uv add "s-accountpoolkit[egress]"  # + antibot health-транспорт для egress-пула
+uv add "s-accountpoolkit[cli]"     # + CLI `accountpool` (json-by-default)
+```
+
+import-имя — `accountpoolkit`. `AccountService` — headless-фасад над всеми слоями:
+
+```python
+import accountpoolkit as apk
+from librarykit.sessions import SessionStore
+
+store = apk.AccountStore(SessionStore(root=None, encrypt=True), social="myservice")
+pool = apk.AccountPool(store, tracker=apk.RateLimitTracker())
+svc = apk.AccountService(store=store, pool=pool)
+
+choice = await svc.acquire(require_tier=apk.SubscriptionTier.PRO)
+if choice:
+    ...  # запрос через choice.proxy (egress) + choice.account (device/creds)
+    await svc.report(choice.ref, response=resp)  # 429/5xx → cooldown/circuit-breaker
+```
+
+## Статус
+
+Ядро стабильно: статус-машина аккаунта, quota/подписки, rate-limit + circuit-breaker,
+OAuth-ротация (single-flight), egress-пул, import/export, `AccountService`-фасад + CLI.
+Провайдер-плагины подключаются через entry-points `accountpoolkit.providers`.

s_accountpoolkit-0.0.1/pyproject.toml

@@ -0,0 +1,55 @@
+[project]
+name = "s-accountpoolkit"
+version = "0.0.1"
+description = "Зрелый пул аккаунтов/сессий поверх librarykit: статус-машина аккаунта, quota/подписки, rate-limit + circuit-breaker, OAuth-ротация (single-flight DCL-lock), egress-пул с quarantine, import/export, headless-фасад. Обобщение gemini-balancer в переиспользуемый доменный слой."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.11"
+authors = [{ name = "Dmitry" }]
+# Ядро: librarykit (SessionStore envelope-крипто/атомик, SessionPool, RateLimiter,
+# RotatingAuth, RetryPolicy, SecretStore, antibot proxy-транспорты) + pydantic (модель).
+dependencies = [
+  "s-librarykit>=0.1.17",
+  "pydantic>=2.6",
+]
+
+[project.optional-dependencies]
+# rest — headless admin REST (ASGI), tunnel — cloudflared quick-tunnel. Тяжёлое —
+# только с extra, ядро остаётся лёгким (lazy-import).
+rest = ["starlette>=0.37", "uvicorn>=0.30"]
+egress = ["s-librarykit[antibot]>=0.1.17"]
+# cli — clikit pool-CLI (typer+command_kit). Тонкий фасад поверх AccountService;
+# ядро/фасад без него не тянут typer (lazy — cli.py импортирует clikit локально).
+cli = ["s-clikit>=0.1"]
+
+[project.scripts]
+accountpool = "accountpoolkit.cli:app"
+
+[dependency-groups]
+dev = [
+  "pytest>=8.2",
+  "pytest-asyncio>=0.23",
+  "respx>=0.21",
+  "ruff>=0.4",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/accountpoolkit"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+src = ["src"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP", "N", "SIM", "RUF"]
+# RUF002/003 — кириллица в докстрингах/комментах намеренная; RUF022 — __all__
+# сгруппирован по модулям осознанно (как в librarykit).
+ignore = ["RUF002", "RUF003", "RUF022"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"

s_accountpoolkit-0.0.1/src/accountpoolkit/__init__.py

@@ -0,0 +1,209 @@
+"""accountpoolkit — зрелый пул аккаунтов/сессий поверх librarykit.
+
+Доменный слой над librarykit-примитивами (SessionStore/SessionPool/RateLimiter/
+RotatingAuth/antibot): статус-машина аккаунта, quota/подписки, rate-limit +
+circuit-breaker, OAuth-ротация с single-flight (DCL) lock, egress-пул с настоящим
+quarantine, import/export, headless AccountService-фасад + CLI. НЕ переписывает
+librarykit — оборачивает его. Провайдер-специфика (gemini/codex/…) подключается
+через Protocol-плагины, ядро её не знает.
+
+dist-имя ``s-accountpoolkit`` · import-имя ``accountpoolkit`` (как s-librarykit →
+librarykit). Публичная поверхность собирается здесь по мере наполнения срезов.
+"""
+from __future__ import annotations
+
+from accountpoolkit import compat
+from accountpoolkit.egress import (
+    DEFAULT_FAILURE_THRESHOLD,
+    DEFAULT_HEALTH_INTERVAL,
+    DEFAULT_HEALTH_TIMEOUT,
+    DEFAULT_HEALTH_URL,
+    EgressPool,
+    EgressStrategy,
+    HealthChecker,
+    LeastConnStrategy,
+    PowerOfTwoStrategy,
+    PriorityStrategy,
+    Proxy,
+    ProxyEntry,
+    ProxyState,
+    RoundRobinStrategy,
+    WeightedStrategy,
+)
+from accountpoolkit.io import (
+    CURRENT_FORMAT,
+    FORMAT_V1,
+    AccountRecord,
+    CodexAuthReader,
+    ForeignStoreReader,
+    FormatMigrator,
+    ImportError,
+    ImportReport,
+    ProtobufReader,
+    SqliteReader,
+    export,
+    import_,
+)
+from accountpoolkit.model import (
+    Account,
+    AccountState,
+    CircuitBreaker,
+    ClaimsQuota,
+    DeviceProfile,
+    DualWindowQuota,
+    HeaderQuota,
+    ModelWindow,
+    ProxyBinding,
+    QuotaData,
+    SubscriptionTier,
+    TokenMeta,
+)
+from accountpoolkit.providers import (
+    PROVIDER_ENTRY_POINT_GROUP,
+    AccountProvider,
+    GeminiProvider,
+    NullProvider,
+    ProviderRegistry,
+)
+from accountpoolkit.ratelimit import (
+    LimitReason,
+    LimitSignal,
+    RateLimitTracker,
+    ResponseLike,
+)
+from accountpoolkit.rotation import (
+    DEFAULT_AHEAD_SECONDS,
+    DEFAULT_GRACE_SECONDS,
+    DEFAULT_SKEW_SECONDS,
+    InvalidGrantError,
+    OAuthClient,
+    OAuthClientMismatch,
+    ProactiveRefreshScheduler,
+    RefreshError,
+    RefreshExhausted,
+    RefreshManager,
+    RefreshResult,
+    RefreshTransportError,
+)
+from accountpoolkit.selector import (
+    DEFAULT_PRIORITY_BAND,
+    SLOW_START_SECONDS,
+    AccountChoice,
+    AccountPool,
+    EgressResolver,
+)
+from accountpoolkit.service import (
+    PROVENANCE_META_KEY,
+    SECRET_ALLOW_LIST,
+    AccountService,
+    AccountView,
+    Provenance,
+    correlation_id,
+    redact,
+    with_correlation_id,
+)
+from accountpoolkit.store import (
+    APK_META_KEY,
+    CREDS_STATE_KEY,
+    LOCK_FILENAME,
+    AccountStore,
+)
+
+# compat (срез 9) — namespace-модуль back-compat фасада gemini-balancer: символы
+# под `compat.*` (дублируют librarykit-примитивы, нужны лишь gemini-shim). cli
+# (срез 9) НЕ реэкспортируем в корень — он тянет typer/clikit ([cli]-экстра);
+# точка входа `accountpoolkit.cli:app` (project.scripts).
+
+__version__ = "0.0.1"
+
+__all__ = [
+    "__version__",
+    # model (срез 1)
+    "Account",
+    "AccountState",
+    "SubscriptionTier",
+    "QuotaData",
+    "DualWindowQuota",
+    "HeaderQuota",
+    "ClaimsQuota",
+    "ModelWindow",
+    "TokenMeta",
+    "ProxyBinding",
+    "DeviceProfile",
+    "CircuitBreaker",
+    # store (срез 1)
+    "AccountStore",
+    "APK_META_KEY",
+    "CREDS_STATE_KEY",
+    "LOCK_FILENAME",
+    # ratelimit (срез 2)
+    "RateLimitTracker",
+    "LimitReason",
+    "LimitSignal",
+    "ResponseLike",
+    # selector (срез 3)
+    "AccountPool",
+    "AccountChoice",
+    "EgressResolver",
+    "DEFAULT_PRIORITY_BAND",
+    "SLOW_START_SECONDS",
+    # egress (срез 5)
+    "EgressPool",
+    "Proxy",
+    "ProxyEntry",
+    "ProxyState",
+    "EgressStrategy",
+    "RoundRobinStrategy",
+    "WeightedStrategy",
+    "LeastConnStrategy",
+    "PriorityStrategy",
+    "PowerOfTwoStrategy",
+    "HealthChecker",
+    "DEFAULT_HEALTH_URL",
+    "DEFAULT_HEALTH_TIMEOUT",
+    "DEFAULT_HEALTH_INTERVAL",
+    "DEFAULT_FAILURE_THRESHOLD",
+    # rotation (срез 4)
+    "RefreshManager",
+    "ProactiveRefreshScheduler",
+    "OAuthClient",
+    "RefreshResult",
+    "RefreshError",
+    "InvalidGrantError",
+    "OAuthClientMismatch",
+    "RefreshTransportError",
+    "RefreshExhausted",
+    "DEFAULT_SKEW_SECONDS",
+    "DEFAULT_GRACE_SECONDS",
+    "DEFAULT_AHEAD_SECONDS",
+    # providers (срез 6)
+    "AccountProvider",
+    "ProviderRegistry",
+    "NullProvider",
+    "GeminiProvider",
+    "PROVIDER_ENTRY_POINT_GROUP",
+    # io (срез 7)
+    "export",
+    "import_",
+    "AccountRecord",
+    "ImportReport",
+    "ImportError",
+    "FormatMigrator",
+    "ForeignStoreReader",
+    "SqliteReader",
+    "CodexAuthReader",
+    "ProtobufReader",
+    "FORMAT_V1",
+    "CURRENT_FORMAT",
+    # service (срез 8)
+    "AccountService",
+    "AccountView",
+    "Provenance",
+    "PROVENANCE_META_KEY",
+    "SECRET_ALLOW_LIST",
+    "correlation_id",
+    "with_correlation_id",
+    "redact",
+    # compat (срез 9) — namespace-модуль back-compat фасада gemini
+    "compat",
+]