opencode-gemini-business 2.0.5 → 2.2.0

package/README.md

@@ -1,102 +1,64 @@
-# 🔄 opencode-gemini-business
+<div align="center">
 
-[🇬🇧 **English**](README.md) | [🇷🇺 Русский](README.ru.md)
+# 🔄 opencode-gemini-business
 
-> Multi-account Gemini Business pool with intelligent rotation for OpenCode
+**Мульти-аккаунтный пул Gemini Business с интеллектуальной ротацией для OpenCode**
 
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![npm version](https://img.shields.io/npm/v/opencode-gemini-business.svg)](https://www.npmjs.com/package/opencode-gemini-business)
-[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
+[![npm version](https://img.shields.io/npm/v/opencode-gemini-business.svg?style=flat&colorA=18181B&colorB=28CF8D)](https://www.npmjs.com/package/opencode-gemini-business)
+[![npm downloads](https://img.shields.io/npm/dm/opencode-gemini-business.svg?style=flat&colorA=18181B&colorB=28CF8D)](https://www.npmjs.com/package/opencode-gemini-business)
+[![GitHub release](https://img.shields.io/github/v/release/izzzzzi/opencode-gemini-business?style=flat&colorA=18181B&colorB=28CF8D)](https://github.com/izzzzzi/opencode-gemini-business/releases)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat&colorA=18181B&colorB=28CF8D)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue?style=flat&colorA=18181B&colorB=3178C6)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-ESM-green?style=flat&colorA=18181B&colorB=339933)](https://nodejs.org/)
 
----
+**🇷🇺 Русский** | [🇬🇧 English](README.en.md)
 
-## 📖 Overview
+<br />
 
-**opencode-gemini-business** is an OpenCode plugin that enables multi-account rotation for **Gemini Business API**, providing automatic failover and load balancing across multiple accounts. Pool multiple Gemini Business accounts with intelligent rotation strategies to overcome rate limits.
+*Auth-плагин для [OpenCode](https://github.com/anomalyco/opencode) — пул из нескольких аккаунтов Gemini Business с автоматической ротацией, фейловером и балансировкой нагрузки.*
 
-**⚠️ Important**: This plugin uses the **official Gemini Business API** (`business.gemini.google`), NOT Google AI Studio.
+</div>
 
-## ✨ Key Features
+---
 
-| Feature | Description |
-|---------|-------------|
-| 🔄 **Multi-Account Rotation** | Automatically rotate between multiple Gemini Business accounts |
-| 🛡️ **Automatic Failover** | Retry failed requests with different accounts seamlessly |
-| 🔐 **Session Management** | Built-in XSRF token and session lifecycle management |
-| ⚙️ **Flexible Strategies** | Round-robin, least-used, or random rotation |
-| 📊 **Health Monitoring** | Track usage statistics and error counts per account |
-| 🚀 **OpenCode Compatible** | Works seamlessly with OpenCode's provider system |
-| 💾 **Persistent Config** | Secure storage in `~/.config/opencode/gemini-business-accounts.json` |
+## 📖 Обзор
 
-## 🤖 Supported Models
+**opencode-gemini-business** — плагин для OpenCode, который обеспечивает ротацию между несколькими аккаунтами **Gemini Business API** (`business.gemini.google`), предоставляя автоматическое переключение при ошибках и балансировку нагрузки.
 
-The plugin supports all Gemini Business models:
+> **Важно**: Плагин использует **Gemini Business / Enterprise API**, НЕ Google AI Studio.
 
-| Model | Context Length | Max Output | Best For |
-|-------|---------------|------------|----------|
-| `gemini-2.5-pro` | 1M tokens | 32K tokens | Complex reasoning, long documents |
-| `gemini-2.5-flash` | 1M tokens | 8K tokens | Fast responses, simple tasks |
-| `gemini-2.0-pro` | 2M tokens | 32K tokens | Massive context, deep analysis |
-| `gemini-1.5-pro` | 2M tokens | 8K tokens | Production workloads |
-| `gemini-1.5-flash` | 1M tokens | 8K tokens | Cost-effective development |
+---
 
-## 🔧 Installation & Configuration
+## ✨ Возможности
 
-### 📦 Install the Plugin
+| Возможность | Описание |
+|-------------|----------|
+| 🔄 **Ротация аккаунтов** | Автоматическое переключение между несколькими аккаунтами Gemini Business |
+| 🛡️ **Автоматический фейловер** | Повторные запросы с другим аккаунтом при ошибках |
+| 🔐 **JWT-аутентификация** | Встроенное получение XSRF-токена и подписание JWT (HS256) |
+| 📡 **Поддержка стриминга** | Полная поддержка SSE, JSON-lines и fallback-парсинга |
+| ⚙️ **Гибкие стратегии** | Round-robin, least-used или случайный выбор |
+| 🔑 **Автонастройка auth** | `add-account` автоматически создаёт auth-запись OpenCode |
 
-```bash
-npm install -g opencode-gemini-business
-```
+---
 
-Or use with npx:
+## 🤖 Поддерживаемые модели
 
-```bash
-npx opencode-gemini-business@latest
-```
+| Модель | Internal API ID | Для чего |
+|--------|:---------------:|----------|
+| `gemini-2.5-flash` | `gemini-2.5-flash` | Повседневные задачи, быстрые ответы |
+| `gemini-2.5-pro` | `gemini-2.5-pro` | Сложные рассуждения |
+| `gemini-3-flash` | `gemini-3-flash-preview` | Новое поколение, быстрая |
+| `gemini-3.1-pro` | `gemini-3.1-pro-preview` | Продвинутые рассуждения (preview) |
+| `auto` | *(пусто)* | Gemini автоматически выберет лучшую модель |
 
-### ⚙️ Configure OpenCode
+---
 
-Add to `~/.config/opencode/opencode.json`:
+## 🚀 Быстрый старт
 
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "plugin": ["opencode-gemini-business@latest"],
-  "provider": {
-    "gemini-business": {
-      "models": {
-        "gemini-2.5-pro": {
-          "name": "Gemini 2.5 Pro (Business)",
-          "limit": { "context": 1048576, "output": 32768 },
-          "modalities": { "input": ["text"], "output": ["text"] }
-        },
-        "gemini-2.5-flash": {
-          "name": "Gemini 2.5 Flash (Business)",
-          "limit": { "context": 1048576, "output": 8192 },
-          "modalities": { "input": ["text"], "output": ["text"] }
-        },
-        "gemini-2.0-pro": {
-          "name": "Gemini 2.0 Pro (Business)",
-          "limit": { "context": 2097152, "output": 32768 },
-          "modalities": { "input": ["text"], "output": ["text"] }
-        },
-        "gemini-1.5-pro": {
-          "name": "Gemini 1.5 Pro (Business)",
-          "limit": { "context": 2097152, "output": 8192 },
-          "modalities": { "input": ["text"], "output": ["text"] }
-        },
-        "gemini-1.5-flash": {
-          "name": "Gemini 1.5 Flash (Business)",
-          "limit": { "context": 1048576, "output": 8192 },
-          "modalities": { "input": ["text"], "output": ["text"] }
-        }
-      }
-    }
-  }
-}
-```
+### Шаг 1: Настроить OpenCode
 
-**Or use short aliases:**
+Добавьте в `~/.config/opencode/opencode.json`:
 
 ```json
 {
@@ -104,288 +66,213 @@ Add to `~/.config/opencode/opencode.json`:
   "plugin": ["opencode-gemini-business@latest"],
   "provider": {
     "gemini-business": {
+      "name": "Gemini Business",
+      "options": {
+        "baseURL": "https://business.gemini.google/v1",
+        "apiKey": "unused"
+      },
       "models": {
-        "gemini-2.5-pro": { "name": "Gemini 2.5 Pro" },
         "gemini-2.5-flash": { "name": "Gemini 2.5 Flash" },
-        "gemini-2.0-pro": { "name": "Gemini 2.0 Pro" },
-        "gemini-1.5-pro": { "name": "Gemini 1.5 Pro" },
-        "gemini-1.5-flash": { "name": "Gemini 1.5 Flash" }
+        "gemini-2.5-pro": { "name": "Gemini 2.5 Pro" },
+        "gemini-3-flash": { "name": "Gemini 3 Flash" },
+        "gemini-3.1-pro": { "name": "Gemini 3.1 Pro" },
+        "auto": { "name": "Авто-выбор" }
       }
     }
   }
 }
 ```
 
-### 🔑 Extract Credentials
+### Шаг 2: Добавить аккаунт Gemini Business
 
-#### Method 1: Using Browser Extension (RECOMMENDED) ⚡
+Установите CLI-инструмент:
 
-**Use the "Get cookies.txt LOCALLY" extension** to export cookies including HttpOnly:
-
-1. **Install Extension**:
-   - [Chrome Web Store: Get cookies.txt LOCALLY](https://chromewebstore.google.com/detail/get-cookiestxt-locally/cclelndahbckbenkjhflpdbgdldlbecc)
-   - This extension can export **all cookies** including HttpOnly (which JavaScript cannot access)
-
-2. **Login** to [Gemini Business](https://business.gemini.google)
-
-3. **Click extension icon** → Export cookies for `business.gemini.google`
-
-4. **Find in exported file**:
-   - `__Secure-C_SES`: `CSE.xxx...`
-   - `__Host-C_OSES`: `COS.xxx...`
-
-5. **Get csesidx from URL**:
-   - Look at your browser URL: `?csesidx=1370433092`
-   - Copy the number after `csesidx=`
-
-6. **Get team_id from URL**:
-   - Look at your browser URL: `/cid/e1f353e7-0291-44cf-9085-e0b6efd20e41/`
-   - Copy the UUID after `/cid/` - this is your `team_id`
-   - Format: `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`
-
-7. **Add account** (see below)
-
-#### Method 2: Manual Extraction via DevTools
+```bash
+npm install -g opencode-gemini-business
+```
 
-1. **Login** to [Gemini Business](https://business.gemini.google)
+Добавьте аккаунт (нужен Google Chrome или Chromium):
 
-2. **Get team_id from URL**:
-   - Look at your browser URL: `/cid/e1f353e7-0291-44cf-9085-e0b6efd20e41/`
-   - Copy the UUID after `/cid/` - this is your `team_id`
+```bash
+opencode-gemini-business add-account
+```
 
-3. **Get csesidx from URL**:
-   - Look at your browser URL: `?csesidx=1370433092`
-   - Copy the number after `csesidx=`
+Откроется окно Chrome — войдите в аккаунт Gemini Business и отправьте любое сообщение в чат. Куки и учётные данные будут захвачены автоматически. Готово!
 
-4. **Open DevTools** (F12) → **Application** tab → **Cookies** → `https://business.gemini.google`
+> **Примечание:** `add-account` автоматически создаёт auth-запись в `~/.local/share/opencode/auth.json`, поэтому запускать `opencode auth login` не нужно.
 
-5. **Copy cookies**:
-   - Find `__Secure-C_SES` → copy the value
-   - Find `__Host-C_OSES` → copy the value
+<details>
+<summary>Ручной режим (для продвинутых)</summary>
 
-6. **Add account**:
+Если хотите указать данные вручную или Chrome не установлен:
 
 ```bash
-opencode-gemini-business add-account \
-  "My Account" \
+opencode-gemini-business add-account --manual \
+  "Мой аккаунт" \
   "e1f353e7-0291-44cf-9085-e0b6efd20e41" \
   "CSE.AXUaAj_MKeqeFLr_..." \
   "COS.AfQtEyCcW1aLwKb3..." \
   "1370433092"
 ```
 
-**Or use environment variables**:
+| # | Аргумент | Описание |
+|:-:|----------|----------|
+| 1 | Имя аккаунта | Отображаемое имя аккаунта |
+| 2 | `team_id` | UUID из URL `/cid/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/` |
+| 3 | `__Secure-C_SES` | Значение cookie (начинается с `CSE.`) |
+| 4 | `__Host-C_OSES` | Значение cookie (начинается с `COS.`) |
+| 5 | `csesidx` | Число из URL `?csesidx=...` |
+
+Или через переменные окружения:
 
 ```bash
-export GEMINI_ACCOUNT_NAME="My Account"
+export GEMINI_ACCOUNT_NAME="Мой аккаунт"
 export GEMINI_TEAM_ID="e1f353e7-0291-44cf-9085-e0b6efd20e41"
 export GEMINI_SECURE_C_SES="CSE.AXUaAj_MKeqeFLr_..."
 export GEMINI_HOST_C_OSES="COS.AfQtEyCcW1aLwKb3..."
 export GEMINI_CSESIDX="1370433092"
 
-opencode-gemini-business add-account
+opencode-gemini-business add-account --manual
 ```
 
-## 🚀 Usage
+</details>
 
-### Basic Usage
+### Шаг 3: Использовать
 
 ```bash
-# Use Pro model (best quality)
-opencode run "Analyze this codebase architecture" --model=gemini-pro
+# Flash (быстрая)
+opencode run --model=gemini-business/gemini-2.5-flash "Исправь баг"
 
-# Use Flash model (fastest)
-opencode run "Fix this syntax error" --model=gemini-flash
+# Pro (лучшее качество)
+opencode run --model=gemini-business/gemini-2.5-pro "Спроектируй архитектуру"
 
-# Use 2.0 Pro (largest context - 2M tokens)
-opencode run "Summarize these 100 files" --model=gemini-2-pro
+# Модели нового поколения
+opencode run --model=gemini-business/gemini-3-flash "Быстрая задача"
+opencode run --model=gemini-business/gemini-3.1-pro "Продвинутые рассуждения"
+opencode run --model=gemini-business/auto "Gemini выберет сам"
 ```
 
-### Model-Specific Usage
+Установить модель по умолчанию в `opencode.json`:
 
-```bash
-# Complex reasoning tasks → gemini-2.5-pro
-opencode run "Design microservices architecture" --model=gemini-pro
+```json
+{
+  "model": "gemini-business/gemini-2.5-flash"
+}
+```
 
-# Quick simple tasks → gemini-2.5-flash
-opencode run "Write hello world" --model=gemini-flash
+---
+
+## 🔍 Извлечение учётных данных
 
-# Massive context → gemini-2.0-pro (2M tokens)
-opencode run "Analyze entire codebase" --model=gemini-2-pro
+### Где найти каждое значение
 
-# Production workloads → gemini-1.5-pro
-opencode run "Review this PR" --model=gemini-1.5-pro
+Войдите в [business.gemini.google](https://business.gemini.google) и посмотрите URL:
 
-# Cost-effective → gemini-1.5-flash
-opencode run "Generate tests" --model=gemini-1.5-flash
+```
+https://business.gemini.google/home/cid/e1f353e7-0291-44cf-9085-e0b6efd20e41/r/session/123?csesidx=1370433092
+                                        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^                  ^^^^^^^^^^
+                                        team_id (UUID после /cid/)                            csesidx
 ```
 
-### Set Default Model
+### Cookies
 
-```bash
-# Set your preferred model as default
-export OPENCODE_MODEL=gemini-pro
-opencode run "Your task here"
-```
+**Способ 1: Расширение браузера (рекомендуется)**
+
+1. Установите [Get cookies.txt LOCALLY](https://chromewebstore.google.com/detail/get-cookiestxt-locally/cclelndahbckbenkjhflpdbgdldlbecc)
+2. Откройте `business.gemini.google` и экспортируйте cookies
+3. Найдите `__Secure-C_SES` (начинается с `CSE.`) и `__Host-C_OSES` (начинается с `COS.`)
+
+**Способ 2: DevTools**
+
+1. Откройте DevTools (F12) → **Application** → **Cookies** → `https://business.gemini.google`
+2. Скопируйте значения `__Secure-C_SES` и `__Host-C_OSES`
+
+---
 
-### 🛠️ Account Management
+## 🔧 Управление аккаунтами
 
 ```bash
-# List all accounts
+# Список аккаунтов
 opencode-gemini-business list-accounts
 
-# Test specific account
+# Тест подключения
 opencode-gemini-business test-account <account_id>
 
-# Remove account
+# Удалить аккаунт
 opencode-gemini-business remove-account <account_id>
 
-# Show help
+# Помощь
 opencode-gemini-business help
 ```
 
-## 🔄 Rotation Strategies
-
-| Strategy | Behavior | Use Case |
-|----------|----------|----------|
-| `round-robin` | Cycles through accounts in order | Balanced usage across all accounts |
-| `least-used` | Selects account with oldest last_used timestamp | Minimize individual account usage |
-| `random` | Random probabilistic selection | Unpredictable load distribution |
-
-**Configure strategy** in OpenCode config:
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "plugin": ["opencode-gemini-business@latest"],
-  "provider": {
-    "gemini-business": {
-      "rotation_strategy": "least-used",  // ← Change here
-      "models": {
-        "gemini-2.5-pro": {
-          "name": "Gemini 2.5 Pro (Business)",
-          "limit": { "context": 1048576, "output": 32768 },
-          "modalities": { "input": ["text"], "output": ["text"] }
-        }
-      }
-    }
-  }
-}
-```
+---
 
+## ⚙️ Стратегии ротации
 
-## ❓ FAQ
+| Стратегия | Поведение |
+|-----------|-----------|
+| `round-robin` (по умолчанию) | Циклический обход аккаунтов по порядку |
+| `least-used` | Выбор наименее недавно использованного |
+| `random` | Случайный выбор |
 
-<details>
-<summary><b>Q: How do I handle session expiration?</b></summary>
+Настраивается в `~/.config/opencode/gemini-business-accounts.json` (создаётся автоматически при первом `add-account`).
 
-The plugin automatically refreshes sessions. Sessions are cached for 50 minutes and auto-refresh when needed. If you see "Session has expired" errors, the plugin will create a new session automatically.
+---
 
-</details>
+## 🛠️ Как это работает
 
-<details>
-<summary><b>Q: Which model should I use?</b></summary>
+1. Плагин регистрируется как auth-провайдер `gemini-business` в OpenCode
+2. При запросе `loader()` возвращает кастомную функцию `fetch()`
+3. Кастомный `fetch()` перехватывает запрос от `@ai-sdk/openai-compatible`
+4. Вместо вызова `baseURL/chat/completions` он:
+   - Выбирает аккаунт по стратегии ротации
+   - Получает XSRF-токен и создаёт JWT (HS256)
+   - Создаёт сессию через `widgetCreateSession`
+   - Отправляет запрос на `widgetStreamAssist`
+   - Конвертирует ответ в OpenAI-совместимый формат
+5. Поддерживает стриминг (SSE) и обычные ответы
 
-- **Complex tasks**: `gemini-2.5-pro` or `gemini-2.0-pro` for best reasoning
-- **Quick tasks**: `gemini-2.5-flash` or `gemini-1.5-flash` for speed
-- **Large contexts**: `gemini-2.0-pro` supports up to 2M tokens
+---
 
-</details>
+## ❓ FAQ
 
 <details>
-<summary><b>Q: How many accounts should I add?</b></summary>
+<summary><b>В: Где найти team_id?</b></summary>
 
-Recommended: 2-5 accounts for optimal failover and load distribution. More accounts provide better redundancy but increase configuration complexity.
+Посмотрите URL в браузере: `https://business.gemini.google/home/cid/e1f353e7-0291-44cf-9085-e0b6efd20e41/...`
 
+UUID после `/cid/` — это ваш `team_id`.
 </details>
 
 <details>
-<summary><b>Q: Where do I find team_id?</b></summary>
-
-**Easy way:** Look at your browser URL when logged into Gemini Business:
-```
-https://business.gemini.google/home/cid/e1f353e7-0291-44cf-9085-e0b6efd20e41/...
-```
-
-The UUID after `/cid/` is your `team_id`. Format: `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`
-
-This ID identifies your organization/team in Google Workspace and is required for all API requests.
+<summary><b>В: Нужно ли запускать `opencode auth login`?</b></summary>
 
+Нет. Команда `add-account` автоматически создаёт auth-запись в `~/.local/share/opencode/auth.json`. Если по какой-то причине запись не создалась, запустите `opencode auth login`, выберите **gemini-business** и введите любой ключ (например `unused`).
 </details>
 
 <details>
-<summary><b>Q: Is the credential extraction script safe?</b></summary>
-
-**YES, 100% safe!** The script:
-- ✅ Runs ONLY in your browser (locally)
-- ✅ Does NOT send data to external servers
-- ✅ Only reads cookies from business.gemini.google
-- ✅ Open source - you can review the code
-
-**Never** run scripts from untrusted sources. Only use from official repository.
+<summary><b>В: Ошибки истечения сессии?</b></summary>
 
+Плагин автоматически обновляет сессии (кешируются на 50 минут). Если ошибки не проходят — cookies могли истечь, извлеките их заново из браузера.
 </details>
 
 <details>
-<summary><b>Q: What's the difference from Google AI Studio?</b></summary>
-
-This plugin uses **Gemini Business API** (`business.gemini.google`), which is:
-- ✅ Enterprise/business accounts
-- ✅ Higher rate limits
-- ✅ Business-grade features
-
-**NOT** Google AI Studio (`aistudio.google.com`), which is:
-- ❌ Free/developer tier
-- ❌ Lower rate limits
-- ❌ Different API endpoints
+<summary><b>В: Чем отличается от Google AI Studio?</b></summary>
 
+Плагин использует **Gemini Business API** (`business.gemini.google`) — корпоративные аккаунты с высокими лимитами. НЕ Google AI Studio (`aistudio.google.com`).
 </details>
 
-## 🔒 Security Best Practices
-
-### Credential Safety
-
-```
-⚠️ CRITICAL: Keep your credentials PRIVATE!
-
-✅ DO:
-- Store credentials only in ~/.config/opencode/gemini-business-accounts.json
-- Use environment variables for temporary access
-- Rotate credentials regularly
-- Add *.json to .gitignore
-
-❌ DON'T:
-- Commit credentials to git repositories
-- Share credentials with others
-- Store credentials in plain text files
-- Use credentials in public environments
-```
-
-### Cookie Extraction Script Safety
-
-```
-✅ The extraction script is SAFE because:
-- Runs 100% locally in your browser
-- NO external network requests
-- NO data transmission to servers
-- Open source and reviewable
-
-⚠️ Security Tips:
-- Only use from official repository
-- Review code before running (it's short!)
-- Never paste modified scripts
-- Check browser console for any warnings
-```
-
-## 📄 License
-
-MIT License - feel free to use this plugin!
+---
 
-## 💬 Need Help?
+## 🔒 Безопасность
 
-- Check the [FAQ](#-faq) above for common questions
-- Test your accounts: `opencode-gemini-business test-account <account_id>`
-- Report issues: [GitHub Issues](https://github.com/izzzzzi/opencode-gemini-business/issues)
+- Учётные данные хранятся локально в `~/.config/opencode/gemini-business-accounts.json`
+- Не коммитьте credentials в git
+- Регулярно обновляйте cookies
+- Плагин не отправляет данные третьим сторонам
 
 ---
 
+## 📄 Лицензия
+
+[MIT](LICENSE) © opencode-gemini-business contributors

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../cli.ts"],"names":[],"mappings":";AAMA;;GAEG;AACH,wBAAsB,GAAG,kBAkCxB"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../cli.ts"],"names":[],"mappings":";AAUA;;GAEG;AACH,wBAAsB,GAAG,kBAkCxB"}