izteamslots 1.6.1 → 1.7.1

package/CHANGELOG.md

@@ -1,3 +1,29 @@
+## [1.7.1](https://github.com/izzzzzi/izTeamSlots/compare/v1.7.0...v1.7.1) (2026-04-13)
+
+
+### Bug Fixes
+
+* **codex-switcher:** eliminate redundant _load_accounts calls in pick_first_ready ([1024e95](https://github.com/izzzzzi/izTeamSlots/commit/1024e9582137aeaaea43484c94002455160ed37d))
+* deduplicate _decode_jwt_payload — single canonical implementation in codex_switcher ([5e579fe](https://github.com/izzzzzi/izTeamSlots/commit/5e579fe44caccf381d47d43484c56b4242589f87))
+* **jobs:** move thread assignment inside lock to prevent race condition ([40a3be2](https://github.com/izzzzzi/izTeamSlots/commit/40a3be2ce0937ae6eeef72c508c820d5de2d1029))
+* **logger:** use UTC timestamps consistent with rest of codebase ([302dfa1](https://github.com/izzzzzi/izTeamSlots/commit/302dfa1c2c5348fcab11c5606c5eb916ff0b5d26))
+* remove redundant Mailbox creation in relogin_worker_email ([883af9b](https://github.com/izzzzzi/izTeamSlots/commit/883af9bd7650c887056885514329b38d6bd5acab))
+* **security:** set chmod 0600 on meta.json and index.json files ([08c27af](https://github.com/izzzzzi/izTeamSlots/commit/08c27af9b330fae9f9a6316fd0fc7c6d38813506))
+* **security:** strengthen API key masking — show at most 4 chars for long keys ([545ac15](https://github.com/izzzzzi/izTeamSlots/commit/545ac15c4505fa94aff59ef5f1ede2b11a8819c2))
+* **workspace-api:** add pagination to get_members and get_pending_invites ([48229d2](https://github.com/izzzzzi/izTeamSlots/commit/48229d209a20593be9693df18f504dba9ee18ddc))
+
+# [1.7.0](https://github.com/izzzzzi/izTeamSlots/compare/v1.6.1...v1.7.0) (2026-03-07)
+
+
+### Bug Fixes
+
+* remove unused variable to satisfy ruff F841 ([e5cfb77](https://github.com/izzzzzi/izTeamSlots/commit/e5cfb773e4449037aa96f7f940c22cd7eb78ecdc))
+
+
+### Features
+
+* add Codex account switcher with auto-rotation ([70c8953](https://github.com/izzzzzi/izTeamSlots/commit/70c8953a6cde92127a17a5ea220bd8476bbc3447))
+
 ## [1.6.1](https://github.com/izzzzzi/izTeamSlots/compare/v1.6.0...v1.6.1) (2026-03-07)
 
 

package/README.md

@@ -2,7 +2,7 @@
 
 # izTeamSlots
 
-**Менеджер ChatGPT Team слотов с авто-регистрацией через временную почту и обновлением Codex-сессий**
+**Локальный менеджер ChatGPT Team слотов: админы, инвайты, регистрация, перелогин и Codex-сессии**
 
 [![CI](https://github.com/izzzzzi/izTeamSlots/actions/workflows/ci.yml/badge.svg)](https://github.com/izzzzzi/izTeamSlots/actions/workflows/ci.yml)
 [![Release](https://github.com/izzzzzi/izTeamSlots/actions/workflows/release.yml/badge.svg)](https://github.com/izzzzzi/izTeamSlots/actions/workflows/release.yml)
@@ -18,111 +18,54 @@
 
 </div>
 
----
-
-## Обзор
-
-**izTeamSlots** — локальное приложение с архитектурой:
-
-- **Python backend** (бизнес-логика, браузерная автоматизация, storage);
-- **TypeScript OpenTUI frontend** (терминальный интерфейс оператора).
-
----
-
-## Возможности
-
-- Управление админами: добавить, перелогинить, удалить, открыть браузерный профиль.
-- Пайплайн слотов: `создать почту -> инвайт -> регистрация -> OAuth-логин`.
-- Перелогин слотов: одного выбранного или всех по очереди.
-- Codex-файлы: авто-сохранение `codex-<email>-Team.json` в аккаунт и в `./codex/`.
-- Doctor-проверка: валидация/восстановление файловой структуры аккаунтов при старте.
----
-
-## Структура проекта
-
-```text
-izTeamSlots/
-├── bin/                            # CLI-бинарники
-│   └── izteamslots.mjs             # Кроссплатформенный entrypoint (Node.js)
-├── scripts/                        # Установочные скрипты
-│   ├── setup.mjs                   # Диспетчер: выбирает .sh или .cmd
-│   ├── setup.sh                    # Unix: uv + venv + Bun
-│   └── setup.cmd                   # Windows: uv + venv + Bun
-├── backend/                        # Весь Python-бэкенд
-│   ├── __init__.py                 # PROJECT_ROOT
-│   ├── __main__.py                 # python -m backend
-│   ├── account_store.py            # CRUD аккаунтов (JSON storage)
-│   ├── mail/                       # Почтовые провайдеры (плагины)
-│   │   ├── __init__.py             # Фабрики: create_provider, create_slot_provider
-│   │   ├── base.py                 # MailProvider ABC, Mailbox, Mail, Inbox
-│   │   ├── boomlify.py             # Boomlify Temp Mail API
-│   │   ├── trickads.py             # trickadsagencyltd.com temp mail
-│   │   └── imap.py                 # Любой IMAP-сервер
-│   ├── openai_web_auth.py          # Браузерная автоматизация (SeleniumBase)
-│   ├── chatgpt_workspace_api.py    # ChatGPT Workspace API через браузер
-│   ├── slot_orchestrator.py        # Оркестратор пайплайна слотов
-│   ├── dto.py                      # DTO для UI
-│   ├── file_logger.py              # Логирование в файл
-│   ├── jobs.py                     # Задачи в потоках
-│   ├── rpc_protocol.py             # JSON-RPC протокол
-│   ├── rpc_server.py               # RPC-сервер (stdio)
-│   └── ui_facade.py                # Фасад между RPC и бизнес-логикой
-├── ui/                             # TypeScript TUI (OpenTUI)
-│   ├── package.json
-│   └── src/
-│       ├── main.ts                 # Entrypoint UI
-│       ├── screens/MainScreen.ts   # Главный экран
-│       ├── transport/stdioClient.ts # JSON-RPC клиент
-│       └── menus/                  # Меню, таблицы, форматирование
-├── requirements.txt                # Python-зависимости
-├── ruff.toml                       # Конфиг линтера Python
-├── LICENSE                         # MIT
-└── README.md
-```
-
----
-
-## Установка
-
-### npm (рекомендуется)
+## Quick Start
 
 ```bash
-npm cache clean --force && npm install -g izteamslots@latest
+npm install -g izteamslots@latest
+izteamslots
 ```
 
-Установщик автоматически поставит Python-зависимости (через [uv](https://docs.astral.sh/uv/)), [Bun](https://bun.sh) и всё остальное.
+Дальше:
+1. Откройте `Настройки` и задайте почтовый провайдер / API-ключ.
+2. Добавьте админа через ручной вход в браузере.
+3. Запустите создание слотов.
 
-> Chrome и chromedriver скачиваются автоматически при первом запуске через SeleniumBase.
+## Что умеет
 
-### Где лежат данные после `npm install -g`
+- Добавление и ручной перелогин админов.
+- Создание слотов: `почта -> инвайт -> регистрация -> OAuth`.
+- Перелогин одного слота или всех сразу.
+- Сохранение `codex-<email>-Team.json`.
+- Логи, локальные browser profiles и doctor-проверка.
+- Синхронизация workspace с локальными слотами.
+- Свитч Codex-аккаунтов: мониторинг usage, авто-ротация auth.json при достижении лимита.
 
-При глобальной установке runtime-данные сохраняются не в папку пакета, а в пользовательскую директорию `~/.izteamslots`.
+## Ограничения
 
-- `codex/`:
-  - Windows: `C:\Users\<USER>\.izteamslots\codex`
-  - macOS / Linux: `~/.izteamslots/codex`
-- `.env`:
-  - Windows: `C:\Users\<USER>\.izteamslots\.env`
-  - macOS / Linux: `~/.izteamslots/.env`
-- аккаунты и профили браузера:
-  - Windows: `C:\Users\<USER>\.izteamslots\accounts`
-  - macOS / Linux: `~/.izteamslots/accounts`
+- Вход админа сейчас поддерживается только в ручном режиме.
+- Проект зависит от текущего web UI OpenAI / ChatGPT.
+- Браузерная автоматизация может ломаться после изменений на стороне сайта.
+- Токены, профили браузера и `codex` хранятся локально.
+- Основные платформы: macOS и Windows.
 
-Если вы обновляете старую версию, `codex`-файлы могут временно лежать ещё и внутри директории пакета. В актуальной версии основным путём считается именно `~/.izteamslots`.
+## Где лежат данные
 
-### Из исходников
+При глобальной установке данные сохраняются в `~/.izteamslots`.
 
-```bash
-git clone https://github.com/izzzzzi/izTeamSlots.git
-cd izTeamSlots
-npm install
-```
+- `accounts/` — аккаунты и browser profiles
+- `codex/` — сохранённые codex-файлы
+- `logs/` — app/job logs
+- `.env` — локальные настройки
 
-### Настройка
+Примеры:
+- Windows: `C:\Users\<USER>\.izteamslots`
+- macOS / Linux: `~/.izteamslots`
+
+Если вы обновляете старую версию, `codex`-файлы могут временно лежать ещё и внутри директории пакета. В актуальной версии основным путём считается именно `~/.izteamslots`.
 
-API-ключи и провайдеры почты настраиваются прямо в приложении через меню **«Настройки»**. Значения сохраняются в `~/.izteamslots/.env`.
+## Настройка
 
-Альтернативно — создайте файл вручную:
+Настройки можно задать через меню `Настройки` внутри приложения или вручную через `~/.izteamslots/.env`.
 
 ```bash
 # Linux / macOS
@@ -134,122 +77,41 @@ mkdir "$env:USERPROFILE\.izteamslots" -Force
 echo "BOOMLIFY_API_KEY=your_api_key" > "$env:USERPROFILE\.izteamslots\.env"
 ```
 
-Конфиг загружается в порядке приоритета: `~/.izteamslots/.env` > `./.env` > встроенный.
-
 | Переменная | По умолчанию | Описание |
 |-----------|:------------:|----------|
-| `BOOMLIFY_API_KEY` | — | API-ключ Boomlify (обязательно для слотов) |
-| `BOOMLIFY_DOMAIN` | авто | Домен для временных почт |
+| `BOOMLIFY_API_KEY` | — | API-ключ Boomlify |
+| `BOOMLIFY_DOMAIN` | авто | Домен временных почт |
 | `BOOMLIFY_TIME` | `permanent` | Время жизни ящика |
 | `SLOT_MAIL_PROVIDER` | `boomlify` | Провайдер почты для слотов |
 | `MAIL_PROVIDER` | `trickads` | Провайдер почты для админов |
+| `CODEX_SWITCHER_ENABLED` | `false` | Включить автосвитч Codex-аккаунтов |
+| `CODEX_SWITCHER_INTERVAL_MINUTES` | `15` | Интервал фоновой проверки usage (минуты) |
 
-## Запуск
-
-```bash
-izteamslots
-```
-
-Из исходников: `npm start`
-
-Это запустит OpenTUI frontend через **Bun**, который поднимет Python RPC backend (`python -m backend`) по `stdio`.
-
----
-
-## Архитектура
+## Свитч Codex-аккаунтов
 
-```mermaid
-flowchart TD
-    A[izteamslots CLI] -->|bun| B[ui/src/main.ts]
-    B --> C[MainScreen.ts]
-    C --> D[StdioRpcClient]
-    D -->|spawns + stdio JSON-RPC| E[python -m backend]
-    E --> F[RPCServer]
-    F --> G[UIFacade]
-    G --> H[AccountStore]
-    G --> I[SlotManager]
-    I --> J[openai_web_auth]
-    I --> K[chatgpt_workspace_api]
-    I --> L[Mail Providers]
-```
-
-## Почтовые провайдеры (плагины)
-
-Система почты построена на плагинах — абстрактный класс `MailProvider` и конкретные реализации.
-
-```mermaid
-flowchart TD
-    MP[MailProvider — абстрактный класс]
-    MP --> B[BoomlifyProvider]
-    MP --> T[TrickAdsProvider]
-    MP --> I[IMAPProvider]
-
-    CF[create_provider] -->|MAIL_PROVIDER env| MP
-    CSP[create_slot_provider] -->|SLOT_MAIL_PROVIDER env| MP
-    CPM[create_provider_for_mailbox] -->|по формату password| MP
-
-    style MP fill:#1e3a5f,color:#fff
-    style B fill:#1a4731,color:#fff
-    style T fill:#1a4731,color:#fff
-    style I fill:#1a4731,color:#fff
-```
-
-### Встроенные провайдеры
-
-| Провайдер | Модуль | Описание | Env-переменные |
-|-----------|--------|----------|----------------|
-| `boomlify` | `mail/boomlify.py` | Boomlify Temp Mail API (по умолчанию для слотов) | `BOOMLIFY_API_KEY`, `BOOMLIFY_DOMAIN`, `BOOMLIFY_TIME` |
-| `trickads` | `mail/trickads.py` | trickadsagencyltd.com temp mail (по умолчанию для админов) | — |
-| `imap` | `mail/imap.py` | Любой IMAP-сервер | `IMAP_HOST`, `IMAP_PORT`, `IMAP_SSL`, `IMAP_FOLDER` |
-
-### Фабричные функции
+Встроенный механизм ротации Codex-аккаунтов. Все codex-файлы из пула (`<DATA_ROOT>/codex`) отображаются в разделе **Свитч аккаунтов** главного меню.
 
-- `create_provider(name)` — создаёт провайдер по имени (или `MAIL_PROVIDER` env, по умолчанию `trickads`)
-- `create_slot_provider(name)` — для слотов (`SLOT_MAIL_PROVIDER` env, по умолчанию `boomlify`)
-- `create_provider_for_mailbox(mailbox)` — автоопределение по формату пароля (если `boomlify:<uuid>` → Boomlify)
+Что доступно:
+- **Таблица аккаунтов** — active-статус, primary usage %, reset time, состояние токена.
+- **Ручное обновление** — запросить usage по всем аккаунтам.
+- **Ручное переключение** — выбрать аккаунт и записать его в `auth.json`.
+- **Первый готовый** — автоматически выбрать первый аккаунт без near-limit.
+- **Автосвитч** — фоновый шедулер проверяет usage и переключает `auth.json`, если `primary_used_percent >= 90%`. Включается через настройку `CODEX_SWITCHER_ENABLED`.
+- **Авто-рефреш токенов** — если access token истекает, обновляется через OAuth.
 
-### Свой провайдер
+Путь к `auth.json` определяется через `CODEX_HOME` или `~/.codex/auth.json`.
 
-Наследуйте `MailProvider` из `backend/mail/base.py` и реализуйте два метода:
+## Почтовые провайдеры
 
-```python
-from backend.mail.base import MailProvider, Mailbox, Inbox
-
-class MyProvider(MailProvider):
-    name = "my_provider"
-
-    def generate(self) -> Mailbox:
-        # создать временный ящик, вернуть Mailbox(email, password)
-        ...
-
-    def inbox(self, mailbox: Mailbox) -> Inbox:
-        # получить письма, вернуть Inbox(email, messages=[Mail(...), ...])
-        ...
-```
-
----
-
-## Пайплайн слотов
-
-```mermaid
-flowchart TD
-    S1[Создать временную почту] --> S2[Отправить инвайт через API]
-    S2 --> S3[Ожидать письмо с инвайт-ссылкой]
-    S3 --> S4[Регистрация по ссылке в браузере]
-    S4 --> S5[Ввод email / пароль / код подтверждения]
-    S5 --> S6[Заполнение имени и даты рождения]
-    S6 --> S7[Закрыть браузер регистрации]
-    S7 --> S8[OAuth PKCE логин]
-    S8 --> S9[Сохранить access_token и codex-файл]
-
-    style S1 fill:#1e3a5f,color:#fff
-    style S9 fill:#1a4731,color:#fff
-```
+- В проект уже встроены `boomlify`, `trickads` и `imap`.
+- Можно добавлять собственные почтовые провайдеры.
+- Для этого нужно реализовать `MailProvider` и зарегистрировать его в backend.
 
----
+Подробности: [docs/providers.md](./docs/providers.md)
 
-## Важно
+## Документация
 
-- Проект хранит токены и браузерные профили локально на диске.
-- Не публикуйте папки `accounts/` и `codex/` в публичные репозитории.
-- Для стабильной работы перелогина у worker должен быть `openai_password`.
+- [docs/providers.md](./docs/providers.md) — встроенные и кастомные почтовые провайдеры
+- [docs/architecture.md](./docs/architecture.md) — структура проекта, архитектура и пайплайн слотов
+- [docs/troubleshooting.md](./docs/troubleshooting.md) — частые проблемы и способы диагностики
+- [CONTRIBUTING.md](./CONTRIBUTING.md) — вклад в проект, проверки и тесты

package/backend/account_store.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import json
+import os
 import shutil
 import threading
 import uuid
@@ -77,6 +78,8 @@ class AccountStore:
         tmp = path.with_suffix(".tmp")
         tmp.write_text(json.dumps(data, indent=2, ensure_ascii=False), encoding="utf-8")
         tmp.replace(path)
+        if os.name != "nt":
+            os.chmod(path, 0o600)
 
     # --- Admin CRUD ---
 

package/backend/chatgpt_workspace_api.py

@@ -91,20 +91,42 @@ class ChatGPTWorkspaceAPI:
         )
 
     def get_pending_invites(self) -> list[dict]:
-        """Получить список ожидающих инвайтов."""
-        data = self._request(
-            "GET",
-            f"/backend-api/accounts/{self.account_id}/invites?offset=0&limit=100",
+        """Получить список ожидающих инвайтов (с пагинацией)."""
+        return self._paginate(
+            f"/backend-api/accounts/{self.account_id}/invites",
+            items_key="invites",
         )
-        return data.get("invites", [])
 
     def get_members(self) -> list[dict]:
-        """Получить список участников workspace."""
-        data = self._request(
-            "GET",
-            f"/backend-api/accounts/{self.account_id}/users?offset=0&limit=100",
+        """Получить список участников workspace (с пагинацией)."""
+        return self._paginate(
+            f"/backend-api/accounts/{self.account_id}/users",
+            items_key="items",
+            fallback_key="users",
         )
-        return data.get("items", data.get("users", []))
+
+    def _paginate(
+        self,
+        path: str,
+        items_key: str,
+        fallback_key: str | None = None,
+        page_size: int = 100,
+        max_pages: int = 20,
+    ) -> list[dict]:
+        """Fetch all pages from a paginated endpoint."""
+        all_items: list[dict] = []
+        for page_num in range(max_pages):
+            offset = page_num * page_size
+            data = self._request("GET", f"{path}?offset={offset}&limit={page_size}")
+            items = data.get(items_key) or (data.get(fallback_key, []) if fallback_key else [])
+            all_items.extend(items)
+            if not data.get("has_more") and len(items) >= page_size:
+                continue
+            if len(items) < page_size:
+                break
+            if data.get("has_more") is False:
+                break
+        return all_items
 
     def delete_member(self, user_id: str) -> dict:
         """Удалить участника из workspace по user_id."""