opencode-antigravity-auth 1.2.7-beta.0 → 1.2.7-beta.2

package/README.md

@@ -1,702 +1,461 @@
-# Antigravity + Gemini CLI OAuth Plugin for Opencode
+# opencode-antigravity-auth
 
 [![npm version](https://img.shields.io/npm/v/opencode-antigravity-auth.svg)](https://www.npmjs.com/package/opencode-antigravity-auth)
 [![npm beta](https://img.shields.io/npm/v/opencode-antigravity-auth/beta.svg?label=beta)](https://www.npmjs.com/package/opencode-antigravity-auth)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-Enable Opencode to authenticate against **Antigravity** (Google's IDE) via OAuth so you can use Antigravity rate limits and access models like `gemini-3-pro-high` and `claude-opus-4-5-thinking` with your Google credentials.
+OpenCode plugin for Google Antigravity OAuth authentication.
 
-## What you get
+## Features
 
-- **Google OAuth sign-in** (multi-account via `opencode auth login`) with automatic token refresh
-- **Multi-account load balancing** Automatically cycle through multiple Google accounts to maximize throughput
-- **Two quota sources for Gemini** Automatic fallback between **Antigravity quota** and **Gemini CLI quota** (same account) before switching accounts
-- **Real-time SSE streaming** including thinking blocks and incremental output
-- **Advanced Claude support** Interleaved thinking, stable multi-turn signatures, and validated tool calling
-- **Automatic endpoint fallback** between Antigravity API endpoints (daily → autopush → prod)
-- **Antigravity API compatibility** for OpenAI-style requests
-- **Debug logging** for requests and responses
-- **Drop-in setup** Opencode auto-installs the plugin from config
+- **Dual Quota System** - Access both Antigravity quota (Claude, Gemini 3) and Gemini CLI quota from a single plugin
+- **Multi-Account Rotation** - Add multiple Google accounts; automatically rotates when one is rate-limited
+- **Plugin Compatible** - Works alongside other OpenCode plugins (opencodesync, etc.)
+- **Extended Thinking** - Native support for Claude thinking budgets and Gemini 3 thinking levels
+- **Auto Recovery** - Automatic session recovery from Claude tool_result_missing errors
 
 ## Installation
 
-### For Humans
-
-**Option A: Let an LLM do it for you**
-
-Paste this into any LLM agent (Claude Code, OpenCode, Cursor, etc.):
-
-```
-Install the opencode-antigravity-auth plugin and add the Antigravity model definitions (see "Available models") to ~/.config/opencode/opencode.json by following: https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/main/README.md
+```bash
+npm install opencode-antigravity-auth
 ```
 
-If the agent only installs the plugin, ask it to also add models under `provider.google.models`.
-
-**Option B: Do it yourself**
-
-1. **Add the plugin to your config:**
-
-   ```bash
-   mkdir -p ~/.config/opencode
-   ```
-
-   Create or edit `~/.config/opencode/opencode.json`:
-
-   ```json
-   {
-     "plugin": ["opencode-antigravity-auth@1.2.4"]
-   }
-   ```
-
-2. **Authenticate:**
-
-   ```bash
-   opencode auth login
-   ```
+Add to your OpenCode config (`~/.config/opencode/opencode.json`):
 
-   Select **Google** → **OAuth with Google (Antigravity)** → Press Enter to skip Project ID → Sign in via browser.
-
-3. **Add models to your config:**
-
-   Add the models you want to use to the same config file:
-
-   ```json
-   {
-     "plugin": ["opencode-antigravity-auth@1.2.4"],
-     "provider": {
-       "google": {
-         "models": {
-           "gemini-3-pro-high": {
-             "name": "Gemini 3 Pro High (Antigravity)",
-             "limit": { "context": 1048576, "output": 65535 },
-             "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
-           },
-           "claude-sonnet-4-5": {
-             "name": "Claude Sonnet 4.5 (Antigravity)",
-             "limit": { "context": 200000, "output": 64000 },
-             "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
-           }
-         }
-       }
-     }
-   }
-   ```
-
-   > See [Available models](#available-models) for the full list.
-
-4. **Use it:**
-
-   ```bash
-   opencode run "Hello" --model=google/gemini-3-pro-high
-   ```
-
----
+```json
+{
+  "plugins": ["opencode-antigravity-auth@latest"],
+  "provider": "google",
+  "model": "google/antigravity-gemini-3-flash"
+}
+```
 
-### For LLMs
+On first run, a browser window opens for Google OAuth. Tokens are stored securely and refresh automatically.
 
 <details>
-<summary><b>🤖 Detailed Installation Guide for LLM Agents</b> (click to expand)</summary>
+<summary>Installation Guide for LLM Agents</summary>
 
-If you're an LLM agent helping a user set up this plugin, follow these steps:
+### Step-by-Step Instructions
 
-#### Step 1: Verify OpenCode is installed
+1. Edit the OpenCode configuration file:
+   - Linux/Mac: `~/.config/opencode/opencode.json`
+   - Windows: `%APPDATA%\opencode\opencode.json`
 
-```bash
-command -v opencode && opencode --version || echo "OpenCode not installed - see https://opencode.ai/docs"
-```
-
-#### Step 2: Create or update the config
-
-```bash
-mkdir -p ~/.config/opencode
-
-if [ -f ~/.config/opencode/opencode.json ]; then
-    if command -v jq &> /dev/null; then
-        jq '.plugin = ((.plugin // []) + ["opencode-antigravity-auth@1.2.4"] | unique)' \
-            ~/.config/opencode/opencode.json > /tmp/oc.json && \
-            mv /tmp/oc.json ~/.config/opencode/opencode.json
-    else
-        echo "Add \"opencode-antigravity-auth@1.2.4\" to the plugin array manually"
-    fi
-else
-    echo '{"plugin":["opencode-antigravity-auth@1.2.4"]}' > ~/.config/opencode/opencode.json
-fi
-```
+2. Add the plugin to the `plugins` array
 
-#### Step 3: Ask user about multi-account setup
+3. Set `provider` to `"google"` and choose a model
 
-Before running `opencode auth login`, ask the user:
+### Complete Configuration Example
 
-> **Do you want to add multiple Google accounts for load balancing?**
-> - Adding 2-10 accounts maximizes rate limits and provides automatic failover
-> - You can always add more accounts later
+Create `~/.config/opencode/antigravity.json`
+```jsonc
+{
+  // JSON Schema for IDE autocompletion
+  "$schema": "https://raw.githubusercontent.com/anthropics/opencode-antigravity-auth/main/assets/antigravity.schema.json",
 
-Based on their answer:
-- **Yes, multiple accounts** → After first login, prompt: "Sign in complete. Add another account? (up to 10 supported)"
-- **No, just one** → Single account is fine, they can add more later with `opencode auth login`
+  // === General ===
+  "quiet_mode": false,           // Suppress toast notifications (except recovery)
+  "debug": false,                // Enable debug logging to file
+  "log_dir": "/custom/log/path", // Custom debug log directory (optional)
+  "auto_update": true,           // Auto-update plugin
 
-#### Step 4: Run authentication
+  // === Thinking Blocks ===
+  "keep_thinking": false,        // Preserve thinking blocks (may cause signature errors)
 
-Tell the user to run:
+  // === Session Recovery ===
+  "session_recovery": true,      // Auto-recover from tool_result_missing errors
+  "auto_resume": true,           // Auto-send "continue" after recovery
+  "resume_text": "continue",     // Custom resume prompt text
 
-```bash
-opencode auth login
-```
+  // === Empty Response Handling ===
+  "empty_response_max_attempts": 4,      // Max retries for empty responses
+  "empty_response_retry_delay_ms": 2000, // Delay between retries (ms)
 
-Guide them through the prompts:
-1. Select **Google** as the provider
-2. Select **OAuth with Google (Antigravity)**
-3. **Project ID prompt** → Tell user: "Press Enter to skip (most users don't need this)"
-4. Browser opens for Google sign-in
-5. If multi-account: repeat for additional accounts, or press Enter to finish
+  // === Tool Handling ===
+  "tool_id_recovery": true,       // Fix mismatched tool IDs from context compaction
+  "claude_tool_hardening": true,  // Prevent Claude tool hallucinations
 
-#### Step 5: Add models to config
+  // === Token Refresh ===
+  "proactive_token_refresh": true,              // Background token refresh
+  "proactive_refresh_buffer_seconds": 1800,     // Refresh 30min before expiry
+  "proactive_refresh_check_interval_seconds": 300, // Check every 5min
 
-Merge model definitions into the user's config file (`~/.config/opencode/opencode.json`):
+  // === Rate Limiting ===
+  "max_rate_limit_wait_seconds": 300, // Max wait time when rate limited (0=unlimited)
+  "quota_fallback": false,            // Try alternate quota when rate limited
 
-```bash
-# If jq is available, merge models programmatically
-if command -v jq &> /dev/null; then
-    jq '.provider.google.models = {
-      "gemini-3-pro-low": {"name": "Gemini 3 Pro Low (Antigravity)", "limit": {"context": 1048576, "output": 65535}, "modalities": {"input": ["text", "image", "pdf"], "output": ["text"]}},
-      "gemini-3-pro-high": {"name": "Gemini 3 Pro High (Antigravity)", "limit": {"context": 1048576, "output": 65535}, "modalities": {"input": ["text", "image", "pdf"], "output": ["text"]}},
-      "gemini-3-flash": {"name": "Gemini 3 Flash (Antigravity)", "limit": {"context": 1048576, "output": 65536}, "modalities": {"input": ["text", "image", "pdf"], "output": ["text"]}},
-      "claude-sonnet-4-5": {"name": "Claude Sonnet 4.5 (Antigravity)", "limit": {"context": 200000, "output": 64000}, "modalities": {"input": ["text", "image", "pdf"], "output": ["text"]}},
-      "claude-sonnet-4-5-thinking-low": {"name": "Claude Sonnet 4.5 Thinking Low (Antigravity)", "limit": {"context": 200000, "output": 64000}, "modalities": {"input": ["text", "image", "pdf"], "output": ["text"]}},
-      "claude-sonnet-4-5-thinking-medium": {"name": "Claude Sonnet 4.5 Thinking Medium (Antigravity)", "limit": {"context": 200000, "output": 64000}, "modalities": {"input": ["text", "image", "pdf"], "output": ["text"]}},
-      "claude-sonnet-4-5-thinking-high": {"name": "Claude Sonnet 4.5 Thinking High (Antigravity)", "limit": {"context": 200000, "output": 64000}, "modalities": {"input": ["text", "image", "pdf"], "output": ["text"]}},
-      "claude-opus-4-5-thinking-low": {"name": "Claude Opus 4.5 Thinking Low (Antigravity)", "limit": {"context": 200000, "output": 64000}, "modalities": {"input": ["text", "image", "pdf"], "output": ["text"]}},
-      "claude-opus-4-5-thinking-medium": {"name": "Claude Opus 4.5 Thinking Medium (Antigravity)", "limit": {"context": 200000, "output": 64000}, "modalities": {"input": ["text", "image", "pdf"], "output": ["text"]}},
-      "claude-opus-4-5-thinking-high": {"name": "Claude Opus 4.5 Thinking High (Antigravity)", "limit": {"context": 200000, "output": 64000}, "modalities": {"input": ["text", "image", "pdf"], "output": ["text"]}},
-      "gpt-oss-120b-medium": {"name": "GPT-OSS 120B Medium (Antigravity)", "limit": {"context": 131072, "output": 32768}, "modalities": {"input": ["text", "image", "pdf"], "output": ["text"]}}
-    } + (.provider.google.models // {})' ~/.config/opencode/opencode.json > /tmp/oc.json && mv /tmp/oc.json ~/.config/opencode/opencode.json
-fi
+  // === Signature Cache (for keep_thinking=true) ===
+  "signature_cache": {
+    "enabled": true,
+    "memory_ttl_seconds": 3600,      // 1 hour in-memory
+    "disk_ttl_seconds": 172800,      // 48 hours on disk
+    "write_interval_seconds": 60     // Background write interval
+  }
+}
 ```
 
-Or edit the file manually and add the models from the [Available models](#available-models) section.
-
-#### Step 6: Verify setup
-
-```bash
-opencode run "Hello" --model=google/gemini-3-pro-high
+Create `~/.config/opencode/opencode.json`
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [
+    "opencode-antigravity-auth@latest"
+  ],
+  "provider": {
+    "google": {
+      "models": {
+        "antigravity-gemini-3-pro-low": {
+          "name": "Gemini 3 Pro Low (Antigravity)",
+          "limit": { "context": 1048576, "output": 65535 },
+          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
+        },
+        "antigravity-gemini-3-pro-high": {
+          "name": "Gemini 3 Pro High (Antigravity)",
+          "limit": { "context": 1048576, "output": 65535 },
+          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
+        },
+        "antigravity-gemini-3-flash": {
+          "name": "Gemini 3 Flash (Antigravity)",
+          "limit": { "context": 1048576, "output": 65536 },
+          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
+        },
+        "antigravity-claude-sonnet-4-5": {
+          "name": "Claude Sonnet 4.5 (Antigravity)",
+          "limit": { "context": 200000, "output": 64000 },
+          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
+        },
+        "antigravity-claude-sonnet-4-5-thinking-low": {
+          "name": "Claude Sonnet 4.5 Think Low (Antigravity)",
+          "limit": { "context": 200000, "output": 64000 },
+          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
+        },
+        "antigravity-claude-sonnet-4-5-thinking-medium": {
+          "name": "Claude Sonnet 4.5 Think Medium (Antigravity)",
+          "limit": { "context": 200000, "output": 64000 },
+          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
+        },
+        "antigravity-claude-sonnet-4-5-thinking-high": {
+          "name": "Claude Sonnet 4.5 Think High (Antigravity)",
+          "limit": { "context": 200000, "output": 64000 },
+          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
+        },
+        "antigravity-claude-opus-4-5-thinking-low": {
+          "name": "Claude Opus 4.5 Think Low (Antigravity)",
+          "limit": { "context": 200000, "output": 64000 },
+          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
+        },
+        "antigravity-claude-opus-4-5-thinking-medium": {
+          "name": "Claude Opus 4.5 Think Medium (Antigravity)",
+          "limit": { "context": 200000, "output": 64000 },
+          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
+        },
+        "antigravity-claude-opus-4-5-thinking-high": {
+          "name": "Claude Opus 4.5 Think High (Antigravity)",
+          "limit": { "context": 200000, "output": 64000 },
+          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
+        }
+      }
+    }
+  }
+}
 ```
 
-If successful, tell the user: **"Setup complete! You can now use Antigravity models in OpenCode."**
-
-</details>
-
----
-
-## Migration Guide
-
-### Upgrading to v1.2.5
-
-Version 1.2.5 introduces significant reliability improvements for Claude models. No breaking changes—existing configurations continue to work.
-
-#### What's New
-
-| Feature | Description |
-|---------|-------------|
-| **Session Recovery** | Auto-recovers from `tool_result_missing` errors |
-| **Defense-in-Depth Tool Pairing** | Multi-layer fix for "Could not process tool results" errors |
-| **Proactive Token Refresh** | Refreshes tokens 30min before expiry to prevent mid-session failures |
-| **Signature Caching** | Persistent disk cache for thinking block signatures |
+### Beta Versions
 
-#### Upgrade Steps
+For the latest development features, check the [dev branch README](https://github.com/anthropics/opencode-antigravity-auth/tree/dev) for beta installation instructions.
 
-1. **Update the plugin version** in `~/.config/opencode/opencode.json`:
-
-   ```json
-   {
-     "plugin": ["opencode-antigravity-auth@1.2.5"]
-   }
-   ```
-
-2. **Update model names to new thinking budget format** (REQUIRED for thinking models):
-
-   The old generic `-thinking` suffix is now replaced with explicit budget tiers:
-
-   | Old Model ID (deprecated) | New Model ID | Thinking Budget |
-   |---------------------------|--------------|-----------------|
-   | `claude-sonnet-4-5-thinking` | `claude-sonnet-4-5-thinking-low` | 8,192 tokens |
-   | `claude-sonnet-4-5-thinking` | `claude-sonnet-4-5-thinking-medium` | 16,384 tokens |
-   | `claude-sonnet-4-5-thinking` | `claude-sonnet-4-5-thinking-high` | 32,768 tokens |
-   | `claude-opus-4-5-thinking` | `claude-opus-4-5-thinking-low` | 8,192 tokens |
-   | `claude-opus-4-5-thinking` | `claude-opus-4-5-thinking-medium` | 16,384 tokens |
-   | `claude-opus-4-5-thinking` | `claude-opus-4-5-thinking-high` | 32,768 tokens |
-
-   Update your `~/.config/opencode/opencode.json`:
-
-   ```diff
-   {
-     "provider": {
-       "google": {
-         "models": {
-   -       "claude-sonnet-4-5-thinking": {
-   -         "name": "Claude Sonnet 4.5 Thinking (Antigravity)",
-   +       "claude-sonnet-4-5-thinking-medium": {
-   +         "name": "Claude Sonnet 4.5 Thinking Medium (Antigravity)",
-             "limit": { "context": 200000, "output": 64000 },
-             "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
-           }
-         }
-       }
-     }
-   }
-   ```
-
-   > **Tip:** Use `-medium` as a balanced default. Use `-high` for complex reasoning tasks, `-low` for faster responses.
-
-3. **Restart OpenCode** to load the new version:
-
-   ```bash
-   # If OpenCode is running, exit and restart
-   opencode
-   ```
-
-4. **(Optional) Review new config options** in `~/.config/opencode/antigravity.json`:
-
-   ```json
-   {
-     "session_recovery": true,
-     "auto_resume": true,
-     "resume_text": "continue",
-     "tool_id_recovery": true,
-     "claude_tool_hardening": true,
-     "proactive_token_refresh": true,
-     "signature_cache": {
-       "enabled": true,
-       "memory_ttl_seconds": 3600,
-       "disk_ttl_seconds": 172800
-     }
-   }
-   ```
-
-   All new options are **enabled by default**—no action required for most users.
-
-#### Breaking Changes
-
-**None.** v1.2.5 is fully backward compatible.
-
-#### Troubleshooting
+</details>
 
-| Issue | Solution |
-|-------|----------|
-| Signature errors after upgrade | Delete `~/.config/opencode/antigravity-signature-cache.json` and restart |
-| Recovery not triggering | Ensure `session_recovery: true` in config (default) |
-| Old version still loading | Clear npm cache: `npm cache clean --force` and restart OpenCode |
+## Available Models
 
-For detailed changes, see [docs/MILESTONE_v1.2.5.md](docs/MILESTONE_v1.2.5.md).
+### Antigravity Quota
 
----
+Models with `antigravity-` prefix use Antigravity quota:
 
-## Available models
+| Model | Description |
+|-------|-------------|
+| `google/antigravity-gemini-3-flash` | Gemini 3 Flash (minimal thinking) |
+| `google/antigravity-gemini-3-pro-low` | Gemini 3 Pro with low thinking |
+| `google/antigravity-gemini-3-pro-high` | Gemini 3 Pro with high thinking |
+| `google/antigravity-claude-sonnet-4-5` | Claude Sonnet 4.5 (no thinking) |
+| `google/antigravity-claude-sonnet-4-5-thinking-low` | Sonnet with 8K thinking budget |
+| `google/antigravity-claude-sonnet-4-5-thinking-medium` | Sonnet with 16K thinking budget |
+| `google/antigravity-claude-sonnet-4-5-thinking-high` | Sonnet with 32K thinking budget |
+| `google/antigravity-claude-opus-4-5-thinking-low` | Opus with 8K thinking budget |
+| `google/antigravity-claude-opus-4-5-thinking-medium` | Opus with 16K thinking budget |
+| `google/antigravity-claude-opus-4-5-thinking-high` | Opus with 32K thinking budget |
 
-Add these models to your `~/.config/opencode/opencode.json` under `provider.google.models`:
-
-### Gemini Models
-
-| Model ID | Description | Thinking |
-|----------|-------------|----------|
-| `gemini-3-pro-low` | Gemini 3 Pro (low thinking) | thinkingLevel: "low" |
-| `gemini-3-pro-high` | Gemini 3 Pro (high thinking) | thinkingLevel: "high" |
-| `gemini-3-flash` | Gemini 3 Flash | Default |
+### Gemini CLI Quota
 
-### Claude Models
+Models without `antigravity-` prefix use Gemini CLI quota:
 
-| Model ID | Description | Thinking Budget |
-|----------|-------------|-----------------|
-| `claude-sonnet-4-5` | Claude Sonnet 4.5 (no thinking) | None |
-| `claude-sonnet-4-5-thinking-low` | Claude Sonnet 4.5 Thinking | 8,192 tokens |
-| `claude-sonnet-4-5-thinking-medium` | Claude Sonnet 4.5 Thinking | 16,384 tokens |
-| `claude-sonnet-4-5-thinking-high` | Claude Sonnet 4.5 Thinking | 32,768 tokens |
-| `claude-opus-4-5-thinking-low` | Claude Opus 4.5 Thinking | 8,192 tokens |
-| `claude-opus-4-5-thinking-medium` | Claude Opus 4.5 Thinking | 16,384 tokens |
-| `claude-opus-4-5-thinking-high` | Claude Opus 4.5 Thinking | 32,768 tokens |
-
-### Other Models
-
-| Model ID | Description |
-|----------|-------------|
-| `gpt-oss-120b-medium` | GPT-OSS 120B Medium |
-
-> **Tier suffixes:** Use `-low`, `-medium`, or `-high` to control thinking budget. Higher tiers = more reasoning tokens.
+| Model | Description |
+|-------|-------------|
+| `google/gemini-2.5-flash` | Gemini 2.5 Flash |
+| `google/gemini-2.5-pro` | Gemini 2.5 Pro |
+| `google/gemini-3-flash` | Gemini 3 Flash |
+| `google/gemini-3-pro-low` | Gemini 3 Pro with low thinking |
+| `google/gemini-3-pro-high` | Gemini 3 Pro with high thinking |
 
 <details>
-<summary><b>Full model configuration</b> (click to expand)</summary>
+<summary>Full models configuration</summary>
 
-```json
+```jsonc
 {
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [
+    "opencode-antigravity-auth@latest"
+  ],
   "provider": {
     "google": {
       "models": {
-        "gemini-3-pro-low": {
+        "antigravity-gemini-3-pro-low": {
           "name": "Gemini 3 Pro Low (Antigravity)",
           "limit": { "context": 1048576, "output": 65535 },
           "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
         },
-        "gemini-3-pro-high": {
+        "antigravity-gemini-3-pro-high": {
           "name": "Gemini 3 Pro High (Antigravity)",
           "limit": { "context": 1048576, "output": 65535 },
           "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
         },
-        "gemini-3-flash": {
+        "antigravity-gemini-3-flash": {
           "name": "Gemini 3 Flash (Antigravity)",
           "limit": { "context": 1048576, "output": 65536 },
           "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
         },
-        "claude-sonnet-4-5": {
+        "antigravity-claude-sonnet-4-5": {
           "name": "Claude Sonnet 4.5 (Antigravity)",
           "limit": { "context": 200000, "output": 64000 },
           "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
         },
-        "claude-sonnet-4-5-thinking-low": {
-          "name": "Claude Sonnet 4.5 Thinking Low (Antigravity)",
+        "antigravity-claude-sonnet-4-5-thinking-low": {
+          "name": "Claude Sonnet 4.5 Think Low (Antigravity)",
           "limit": { "context": 200000, "output": 64000 },
           "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
         },
-        "claude-sonnet-4-5-thinking-medium": {
-          "name": "Claude Sonnet 4.5 Thinking Medium (Antigravity)",
+        "antigravity-claude-sonnet-4-5-thinking-medium": {
+          "name": "Claude Sonnet 4.5 Think Medium (Antigravity)",
           "limit": { "context": 200000, "output": 64000 },
           "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
         },
-        "claude-sonnet-4-5-thinking-high": {
-          "name": "Claude Sonnet 4.5 Thinking High (Antigravity)",
+        "antigravity-claude-sonnet-4-5-thinking-high": {
+          "name": "Claude Sonnet 4.5 Think High (Antigravity)",
           "limit": { "context": 200000, "output": 64000 },
           "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
         },
-        "claude-opus-4-5-thinking-low": {
-          "name": "Claude Opus 4.5 Thinking Low (Antigravity)",
+        "antigravity-claude-opus-4-5-thinking-low": {
+          "name": "Claude Opus 4.5 Think Low (Antigravity)",
           "limit": { "context": 200000, "output": 64000 },
           "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
         },
-        "claude-opus-4-5-thinking-medium": {
-          "name": "Claude Opus 4.5 Thinking Medium (Antigravity)",
+        "antigravity-claude-opus-4-5-thinking-medium": {
+          "name": "Claude Opus 4.5 Think Medium (Antigravity)",
           "limit": { "context": 200000, "output": 64000 },
           "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
         },
-        "claude-opus-4-5-thinking-high": {
-          "name": "Claude Opus 4.5 Thinking High (Antigravity)",
+        "antigravity-claude-opus-4-5-thinking-high": {
+          "name": "Claude Opus 4.5 Think High (Antigravity)",
           "limit": { "context": 200000, "output": 64000 },
           "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
-        },
-        "gpt-oss-120b-medium": {
-          "name": "GPT-OSS 120B Medium (Antigravity)",
-          "limit": { "context": 131072, "output": 32768 },
-          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
         }
       }
     }
   }
 }
 ```
-
 </details>
 
-## Multi-account load balancing
-
-The plugin supports multiple Google accounts to maximize rate limits and provide automatic failover.
-
-### How it works
-
-- **Sticky account selection:** The plugin sticks to the same account for all requests until it hits a rate limit. This preserves Anthropic's prompt cache, which is organization-scoped.
-- **Per-model-family rate limits:** Rate limits are tracked separately for Claude and Gemini models. If an account is rate-limited for Claude, it can still be used for Gemini requests.
-- **Dual quota pools for Gemini:** Gemini models have access to two separate quota pools (Antigravity and Gemini CLI). When one pool is exhausted, the plugin automatically switches to the other before trying a different account.
-- **Smart retry threshold:** Short rate limits (≤5s) are retried on the same account to avoid unnecessary switching.
-- **Exponential backoff:** Consecutive rate limits trigger exponential backoff with increasing delays.
-- **Quota-aware messages:** Rate limit toasts show quota reset times when available from the API.
-- **Automatic failover:** On HTTP `429` (rate limit), the plugin automatically switches to the next available account for that model family.
-- **Smart cooldown:** Rate-limited accounts are temporarily cooled down and automatically become available again after the cooldown expires.
-- **Single-account retry:** If you only have one account, the plugin waits for the rate limit to reset and retries automatically.
-- **Debounced notifications:** Toast notifications are debounced to avoid spam during streaming responses.
-
-### Dual quota pools (Gemini only)
-
-For Gemini models, the plugin can access **two independent quota pools** using the same Google account:
-
-| Quota Pool | Headers Used | When Used |
-|------------|--------------|-----------|
-| **Antigravity** | Antigravity headers | Primary (tried first) |
-| **Gemini CLI** | Gemini CLI headers | Fallback when Antigravity is rate-limited |
-
-This effectively **doubles your Gemini quota** per account. 
-
-**How it works:**
-1. Plugin tries Antigravity quota first
-2. If rate-limited (429), it automatically retries using Gemini CLI headers
-3. Only if **both** pools are exhausted does it switch to the next account
-4. This happens seamlessly — conversation context is preserved when switching between quota pools.
-
-> **Note:** Claude models only work with Antigravity headers, so this dual-pool fallback only applies to Gemini models.
+## Configuration
 
-### Quiet mode
 
-To suppress account-related toast notifications (useful for streaming/recording):
+### Environment Overrides
 
 ```bash
-export OPENCODE_ANTIGRAVITY_QUIET=1
+OPENCODE_ANTIGRAVITY_QUIET=1         # quiet_mode
+OPENCODE_ANTIGRAVITY_DEBUG=1         # debug
+OPENCODE_ANTIGRAVITY_LOG_DIR=/path   # log_dir
+OPENCODE_ANTIGRAVITY_KEEP_THINKING=1 # keep_thinking
 ```
 
-### Adding accounts
-
-**CLI flow (`opencode auth login`):**
-
-When you run `opencode auth login` and already have accounts saved, you'll be prompted:
-
-```
-2 account(s) saved:
-  1. user1@gmail.com
-  2. user2@gmail.com
-
-(a)dd new account(s) or (f)resh start? [a/f]:
-```
-
-- Press `a` to add more accounts to your existing pool
-- Press `f` to clear all existing accounts and start fresh
-
-**TUI flow (`/connect`):**
+<details>
+<summary>Create `~/.config/opencode/antigravity.json` (or `.opencode/antigravity.json` in project root):</summary>
 
-The `/connect` command in the TUI adds accounts non-destructively — it will never clear your existing accounts. To start fresh via TUI, run `opencode auth logout` first, then `/connect`.
+```jsonc
+{
+  // JSON Schema for IDE autocompletion
+  "$schema": "https://raw.githubusercontent.com/anthropics/opencode-antigravity-auth/main/assets/antigravity.schema.json",
 
-### Account storage
+  // === General ===
+  "quiet_mode": false,           // Suppress toast notifications (except recovery)
+  "debug": false,                // Enable debug logging to file
+  "log_dir": "/custom/log/path", // Custom debug log directory (optional)
+  "auto_update": true,           // Auto-update plugin
 
-- Account pool is stored in `~/.config/opencode/antigravity-accounts.json` (or `%APPDATA%\opencode\antigravity-accounts.json` on Windows)
-- This file contains OAuth refresh tokens; **treat it like a password** and don't share or commit it
-- The plugin automatically syncs with OpenCode's auth state — if you log out via OpenCode, stale account storage is cleared automatically
+  // === Thinking Blocks ===
+  "keep_thinking": false,        // Preserve thinking blocks (may cause signature errors)
 
-### Automatic account recovery
+  // === Session Recovery ===
+  "session_recovery": true,      // Auto-recover from tool_result_missing errors
+  "auto_resume": true,           // Auto-send "continue" after recovery
+  "resume_text": "continue",     // Custom resume prompt text
 
-- If Google revokes a refresh token (`invalid_grant`), that account is automatically removed from the pool
-- Rerun `opencode auth login` to re-add the account
+  // === Empty Response Handling ===
+  "empty_response_max_attempts": 4,      // Max retries for empty responses
+  "empty_response_retry_delay_ms": 2000, // Delay between retries (ms)
 
-## Configuration
+  // === Tool Handling ===
+  "tool_id_recovery": true,       // Fix mismatched tool IDs from context compaction
+  "claude_tool_hardening": true,  // Prevent Claude tool hallucinations
 
-### Config file
+  // === Token Refresh ===
+  "proactive_token_refresh": true,              // Background token refresh
+  "proactive_refresh_buffer_seconds": 1800,     // Refresh 30min before expiry
+  "proactive_refresh_check_interval_seconds": 300, // Check every 5min
 
-Create `~/.config/opencode/antigravity.json` (or `.opencode/antigravity.json` for project-specific settings):
+  // === Rate Limiting ===
+  "max_rate_limit_wait_seconds": 300, // Max wait time when rate limited (0=unlimited)
+  "quota_fallback": false,            // Try alternate quota when rate limited
 
-```json
-{
-  "$schema": "https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/main/assets/antigravity.schema.json",
-  "quiet_mode": false,
-  "debug": false,
-  "log_dir": null,
-  "keep_thinking": false,
-  "session_recovery": true,
-  "auto_resume": true,
-  "resume_text": "continue",
-  "empty_response_max_attempts": 4,
-  "empty_response_retry_delay_ms": 2000,
-  "tool_id_recovery": true,
-  "claude_tool_hardening": true,
-  "proactive_token_refresh": true,
-  "proactive_refresh_buffer_seconds": 1800,
-  "proactive_refresh_check_interval_seconds": 300,
-  "auto_update": true,
+  // === Signature Cache (for keep_thinking=true) ===
   "signature_cache": {
     "enabled": true,
-    "memory_ttl_seconds": 3600,
-    "disk_ttl_seconds": 172800,
-    "write_interval_seconds": 60
+    "memory_ttl_seconds": 3600,      // 1 hour in-memory
+    "disk_ttl_seconds": 172800,      // 48 hours on disk
+    "write_interval_seconds": 60     // Background write interval
   }
 }
 ```
 
-#### General Settings
+</details>
 
-| Option | Default | Description |
-|--------|---------|-------------|
-| `quiet_mode` | `false` | Suppress toast notifications (except recovery) |
-| `debug` | `false` | Enable debug logging to file |
-| `log_dir` | OS default | Custom directory for debug logs |
-| `auto_update` | `true` | Enable automatic plugin updates |
+## Multi-Account Setup
 
-#### Session Recovery
+Add multiple Google accounts for higher combined quotas. The plugin automatically rotates between accounts when one is rate-limited.
 
-| Option | Default | Description |
-|--------|---------|-------------|
-| `session_recovery` | `true` | Auto-recover from tool_result_missing errors |
-| `auto_resume` | `true` | Auto-send resume prompt after recovery |
-| `resume_text` | `"continue"` | Text to send when auto-resuming |
+```bash
+# Add accounts
+opencode auth login
+```
 
-#### Thinking Blocks (Claude)
+## Compatible Plugins
 
-| Option | Default | Description |
-|--------|---------|-------------|
-| `keep_thinking` | `false` | Preserve thinking blocks (may cause signature errors) |
-| `signature_cache.enabled` | `true` | Cache signatures to disk |
-| `signature_cache.memory_ttl_seconds` | `3600` | In-memory cache TTL |
-| `signature_cache.disk_ttl_seconds` | `172800` | Disk cache TTL (48h) |
+This plugin works alongside other OpenCode plugins. Some important notes:
 
-#### Error Recovery
+### Plugin Ordering
 
-| Option | Default | Description |
-|--------|---------|-------------|
-| `empty_response_max_attempts` | `4` | Retries for empty API responses |
-| `empty_response_retry_delay_ms` | `2000` | Delay between retries |
-| `tool_id_recovery` | `true` | Fix mismatched tool IDs from context compaction |
-| `claude_tool_hardening` | `true` | Prevent tool parameter hallucination |
+If using `@tarquinen/opencode-dcp` (Dynamic Context Protocol), **our plugin must be listed first**:
 
-#### Token Management
+```json
+{
+  "plugins": [
+    "opencode-antigravity-auth@latest",
+    "@tarquinen/opencode-dcp@1.1.2"
+  ]
+}
+```
 
-| Option | Default | Description |
-|--------|---------|-------------|
-| `proactive_token_refresh` | `true` | Refresh tokens before expiry |
-| `proactive_refresh_buffer_seconds` | `1800` | Refresh 30min before expiry |
-| `proactive_refresh_check_interval_seconds` | `300` | Check interval (5min) |
+### Plugins You Don't Need
 
-### Environment variables
+- **gemini-auth plugins** - Not needed. This plugin handles all Google OAuth authentication.
 
-Environment variables override config file values.
+### Rate Limit Considerations
 
-| Variable | Values | Description |
-|----------|--------|-------------|
-| `OPENCODE_ANTIGRAVITY_QUIET` | `1` | Suppress toast notifications |
-| `OPENCODE_ANTIGRAVITY_DEBUG` | `1`, `2` | Debug logging level (2 = verbose) |
-| `OPENCODE_ANTIGRAVITY_LOG_DIR` | path | Custom log directory |
-| `OPENCODE_ANTIGRAVITY_KEEP_THINKING` | `1` | Preserve thinking blocks |
-| `OPENCODE_ANTIGRAVITY_SESSION_RECOVERY` | `0`/`1` | Enable/disable session recovery |
-| `OPENCODE_ANTIGRAVITY_AUTO_RESUME` | `0`/`1` | Enable/disable auto-resume |
-| `OPENCODE_ANTIGRAVITY_RESUME_TEXT` | string | Custom resume text |
-| `OPENCODE_ANTIGRAVITY_AUTO_UPDATE` | `0`/`1` | Enable/disable auto-updates |
+- **oh-my-opencode** - This plugin may make background API calls that consume your quota. If you're hitting rate limits unexpectedly, check if oh-my-opencode is making requests.
 
-## Known plugin interactions
+## Migration Guide (v1.2.7+)
 
-### @tarquinen/opencode-dcp (Dynamic Context Pruning)
+<details>
+<summary>If upgrading from v1.2.6 or earlier, follow these steps:</summary>
 
-**Issue:** DCP creates synthetic assistant messages to summarize pruned tool outputs. These synthetic messages lack the thinking block that Claude's API requires for thinking-enabled models.
+### Step 1: Clear Old Tokens
 
-**Error you'll see:**
-```
-Expected 'thinking' or 'redacted_thinking', but found 'text'
+```bash
+rm -rf ~/.config/opencode/antigravity-tokens/
 ```
 
-**Solution:** Ensure DCP loads **before** this plugin. We inject `redacted_thinking` blocks into any assistant message that lacks one.
+### Step 2: Update opencode.json
 
-| Order | Result |
-|-------|--------|
-| DCP → antigravity | Works - we fix DCP's synthetic messages |
-| antigravity → DCP | Broken - DCP creates messages after our fix runs |
+Replace your old config with:
 
-**Correct:**
 ```json
 {
-  "plugin": [
-    "@tarquinen/opencode-dcp@latest",
-    "opencode-antigravity-auth@latest"
-  ]
+  "plugins": ["opencode-antigravity-auth@latest"],
+  "provider": "google",
+  "model": "google/antigravity-gemini-3-flash"
 }
 ```
 
-**Incorrect:**
+### Step 3: Create antigravity.json (Optional)
+
+If you had custom settings, migrate them to `~/.config/opencode/antigravity.json`:
+
 ```json
 {
-  "plugin": [
-    "opencode-antigravity-auth@latest",
-    "@tarquinen/opencode-dcp@latest"
-  ]
+  "$schema": "https://raw.githubusercontent.com/anthropics/opencode-antigravity-auth/main/assets/antigravity.schema.json",
+  "quiet_mode": false,
+  "debug": false
 }
 ```
 
-### oh-my-opencode (Subagent Orchestration)
+### Step 4: Re-authenticate
 
-**Issue:** When oh-my-opencode spawns multiple subagents in parallel, each subagent runs as a separate OpenCode process. Without coordination, multiple processes may select the same Antigravity account simultaneously, causing rate limit errors.
+Run OpenCode once. A browser window will open for Google OAuth:
 
-**Error you'll see:**
-```
-429 Too Many Requests
+```bash
+opencode
 ```
 
-**Current workaround:**
-- Increase your account pool (add more OAuth accounts via `opencode auth login`)
-- Reduce parallel subagent count in your configuration
-
-**Status:** A file-based reservation system to coordinate account selection across processes is planned but not yet implemented.
+### Breaking Changes
 
-## Architecture & Flow
+| Old (v1.2.6) | New (v1.2.7+) |
+|--------------|---------------|
+| `OPENCODE_ANTIGRAVITY_*` env vars | `~/.config/opencode/antigravity.json` |
+| `gemini-3-pro` | `google/antigravity-gemini-3-pro-low` |
+| `claude-sonnet-4-5` | `google/antigravity-claude-sonnet-4-5` |
 
-For contributors and advanced users, see the detailed documentation:
+</details>
 
-- **[Architecture Guide](docs/ARCHITECTURE.md)** - Full request/response flow, module structure, and troubleshooting
-- **[Antigravity API Spec](docs/ANTIGRAVITY_API_SPEC.md)** - API reference and schema support matrix
+## E2E Testing
 
-## Streaming & thinking
+The plugin includes regression tests for stability verification. Tests consume API quota.
 
-This plugin supports **real-time SSE streaming**, meaning you see thinking blocks and text output incrementally as they are generated.
+```bash
+# Sanity tests (7 tests, ~5 min)
+npx tsx script/test-regression.ts --sanity
 
-### Claude Thinking & Tools
+# Heavy tests (4 tests, ~30 min) - stress testing with 8-50 turn conversations
+npx tsx script/test-regression.ts --heavy
 
-For models like `claude-opus-4-5-thinking`:
+# Concurrent tests (3 tests) - rate limit handling with 5-10 parallel requests
+npx tsx script/test-regression.ts --category concurrency
 
-- **Interleaved Thinking:** The plugin automatically enables `anthropic-beta: interleaved-thinking-2025-05-14`. This allows Claude to think *between* tool calls and after tool results, improving complex reasoning.
-- **Smart System Hints:** A system instruction is silently added to encourage the model to "think" before and during tool use.
-- **Multi-turn Stability:** Thinking signatures are cached and restored using a stable `sessionId`, preventing "invalid signature" errors in long conversations.
-- **Thinking Budget Safety:** If a thinking budget is enabled, the plugin ensures output token limits are high enough to avoid budget-related errors.
-- **Tool Use:** Tool calls and responses are assigned proper IDs, and tool calling is set to validated mode for better Claude compatibility.
+# Run specific test
+npx tsx script/test-regression.ts --test thinking-tool-use
 
-**Troubleshooting:** If you see signature errors in multi-turn tool loops, restart `opencode` to reset the plugin session/signature cache.
+# List tests without running
+npx tsx script/test-regression.ts --dry-run
+```
 
 ## Debugging
 
-Enable debug logging via environment variable:
+Enable debug logging:
 
 ```bash
-export OPENCODE_ANTIGRAVITY_DEBUG=1
-```
+# Via environment
+OPENCODE_ANTIGRAVITY_DEBUG=1 opencode
 
-- **Level 1 (`1` or `true`):** Basic logging of URLs, headers, status codes, and request/response previews.
-- **Level 2 (`2` or `verbose`):** Verbose logging including full request and response bodies (up to 50KB).
-- **TUI Reasoning View:** Debug logs are injected into the model's "thinking/reasoning" blocks in the Opencode TUI (requires thinking-capable models).
-- **Log Files:** Logs are written to `~/.config/opencode/antigravity-logs/antigravity-debug-<timestamp>.log`. Override with `OPENCODE_ANTIGRAVITY_LOG_DIR`.
-- **Auto-Stripping:** Injected debug blocks are automatically stripped from outgoing requests to prevent leaking into conversation history.
-
-## Development
-
-```bash
-npm install
+# Via config
+echo '{"debug": true}' > ~/.config/opencode/antigravity.json
 ```
 
-## Safety, usage, and risk notices
-
-### Intended use
-
-- Personal / internal development only
-- Respect internal quotas and data handling policies
-- Not for production services or bypassing intended limits
-
-### Not suitable for
-
-- Production application traffic
-- High-volume automated extraction
-- Any use that violates Acceptable Use Policies
-
-### ⚠️ Warning (assumption of risk)
-
-By using this plugin, you acknowledge and accept the following:
-
-- **Terms of Service risk:** This approach may violate the Terms of Service of AI model providers (Anthropic, OpenAI, etc.). You are solely responsible for ensuring compliance with all applicable terms and policies.
-- **Account risk:** Providers may detect this usage pattern and take punitive action, including suspension, permanent ban, or loss of access to paid subscriptions.
-- **No guarantees:** Providers may change APIs, authentication, or policies at any time, which can break this method without notice.
-- **Assumption of risk:** You assume all legal, financial, and technical risks. The authors and contributors of this project bear no responsibility for any consequences arising from your use.
-
-Use at your own risk. Proceed only if you understand and accept these risks.
-
-## Legal
-
-- Not affiliated with Google. This is an independent open-source project and is not endorsed by, sponsored by, or affiliated with Google LLC.
-- "Antigravity", "Gemini", "Google Cloud", and "Google" are trademarks of Google LLC.
-- Software is provided "as is", without warranty. You are responsible for complying with Google's Terms of Service and Acceptable Use Policy.
-
-## Credits
-
-Built with help and inspiration from:
-
-- [opencode-gemini-auth](https://github.com/jenslys/opencode-gemini-auth) — Gemini OAuth groundwork by [@jenslys](https://github.com/jenslys)
-- [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI) — Helpful reference for Antigravity API
-
-## Support
+Logs are written to `~/.config/opencode/antigravity-logs/` (or `log_dir` if configured).
 
-If this plugin helps you, consider supporting its continued maintenance:
+## Documentation
 
-[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/S6S81QBOIR)
+- [Architecture](docs/ARCHITECTURE.md) - Plugin internals and request flow
+- [API Spec](docs/ANTIGRAVITY_API_SPEC.md) - Antigravity API reference
 
+## License
 
+MIT