converse-mcp-server 2.27.0 → 2.28.0

package/README.md

@@ -424,7 +424,7 @@ Use `"auto"` for automatic model selection, or specify exact models:
 Provider priority order (subscription-based SDK providers first, then API-key providers):
 
 1. Codex (`codex`)
-2. Gemini CLI (`gemini`)
+2. Gemini via Antigravity CLI (`gemini`, `gemini:flash`)
 3. Claude Agent SDK (`claude` → Claude Fable 5)
 4. Copilot (`copilot`)
 5. OpenAI (`gpt-5`)
@@ -601,7 +601,7 @@ npm run test:watch     # Run tests in watch mode
 # Code quality
 npm run lint           # Check code style
 npm run lint:fix       # Fix code style issues
-npm run format         # Format code with Prettier
+npm run format         # Format code with ESLint (alias for lint:fix)
 npm run validate       # Full validation (lint + test)
 
 # Utilities

package/docs/API.md

@@ -534,7 +534,7 @@ When complete, `check_status` for the continuation_id renders the full lap trans
 | `gemini-2.5-pro` | `pro 2.5` | 1M | 65K | Thinking mode | Deep reasoning, architecture |
 | `gemini-2.5-flash` | `flash` | 1M | 65K | Ultra-fast | Quick analysis, simple queries |
 
-**Note:** The short model name `gemini` now routes to **Gemini CLI** (OAuth-based). For Google API access, use specific model names like `gemini-2.5-pro` or `gemini-2.5-flash`.
+**Note:** The short model name `gemini` (and `gemini:flash` / `gemini:pro`) routes to the **Antigravity CLI** (`agy`, OAuth-based). For Google API access, use specific model names like `gemini-2.5-pro` or `gemini-2.5-flash` (bare `gemini-pro`/`gemini-flash` also route to the Google API).
 
 ### X.AI/Grok Models
 
@@ -608,29 +608,31 @@ When complete, `check_status` for the continuation_id renders the full lap trans
 - **Direct file access**: Reads files from working directory
 - **Note**: `temperature`, `use_websearch`, and `reasoning_effort` are managed by the SDK (ignored if specified)
 
-### Gemini CLI Models (OAuth-based)
+### Gemini Models via Antigravity CLI (OAuth-based)
 
-**Gemini CLI** provides subscription-based access to Gemini models through OAuth:
+The **Antigravity CLI** (`agy`) provides subscription-based access to Gemini models through Google OAuth:
 
-- **Model**: `gemini` (routes to gemini-3-pro-preview)
-- **Authentication**: OAuth via Gemini CLI (requires one-time setup)
-- **Setup**: Install `@google/gemini-cli` globally and run `gemini` to authenticate
-- **Billing**: Uses Google subscription (Google One AI Premium or Gemini Advanced) instead of API credits
-- **Credentials**: Stored in `~/.gemini/oauth_creds.json`
-- **Features**: Access to enhanced agentic features available through CLI
-- **Context**: 1M tokens (inherited from gemini-3-pro-preview)
-- **Output**: 64K tokens
+- **Models** (text-only): `gemini` (= `gemini:pro`, Gemini 3.1 Pro), `gemini:flash` (Gemini 3.5 Flash)
+- **Authentication**: Google OAuth via `agy` (requires one-time interactive login)
+- **Setup**: Install the Antigravity CLI and run `agy` once to log in
+- **Billing**: Uses your Antigravity subscription/compute allowance instead of API credits
+- **Detection**: The provider locates the `agy` binary on PATH or at the platform install location (no credentials file)
+- **Reasoning effort**: `low`/`medium`/`high`/`max` select the model variant (e.g. Flash Low/Medium/High; Pro Low/High)
+- **Context**: 1M tokens
+- **Note**: One-shot responses (no token-level streaming); ~7s minimum per call
+
+> Replaces the previous `@google/gemini-cli` integration, whose OAuth access Google sunsets on 2026-06-18.
 
 **Authentication Setup:**
 ```bash
-# Install Gemini CLI globally
-npm install -g @google/gemini-cli
-
-# Run interactive authentication
-gemini
-
-# Follow prompts to authenticate via browser
-# Credentials are saved to ~/.gemini/oauth_creds.json
+# Install the Antigravity CLI (agy)
+# Windows (PowerShell):
+irm https://antigravity.google/cli/install.ps1 | iex
+# macOS/Linux:
+curl -fsSL https://antigravity.google/cli/install.sh | bash
+
+# Run interactive login (one-time) — also establishes workspace trust
+agy
 ```
 
 **Usage Example:**

package/docs/ARCHITECTURE.md

@@ -544,7 +544,6 @@ npm run validate
 npm run lint
 npm run typecheck
 npm run test
-npm run format:check
 ```
 
 ---

package/docs/PROVIDERS.md

@@ -22,7 +22,7 @@ This guide documents all supported AI providers in the Converse MCP Server and t
   - `gemini-3-pro-preview` (alias: `pro`) - Enhanced reasoning with thinking levels (1M context, 64K output)
   - `gemini-2.5-pro` (alias: `pro 2.5`) - Deep reasoning with thinking budget (1M context, 65K output)
   - `gemini-2.5-flash` (alias: `flash`) - Ultra-fast model with thinking budget (1M context, 65K output)
-- **Note**: The short model name `gemini` now routes to **Gemini CLI** (OAuth-based access). For Google API access, use specific model names like `gemini-2.5-pro` or `gemini-2.5-flash`.
+- **Note**: The short model name `gemini` (and `gemini:flash` / `gemini:pro`) routes to the **Antigravity CLI** (`agy`, OAuth-based access). For Google API access, use specific model names like `gemini-2.5-pro` or `gemini-2.5-flash` (bare `gemini-pro`/`gemini-flash` also route to the Google API).
 
 ### X.AI (Grok)
 - **API Key Format**: `xai-...` (starts with `xai-`)
@@ -111,35 +111,36 @@ This guide documents all supported AI providers in the Converse MCP Server and t
 - Use `CODEX_APPROVAL_POLICY=never` for headless server deployments
 - Always use `continuation_id` for thread continuation
 
-### Gemini CLI
-- **Authentication**: OAuth via Gemini CLI (no API key needed)
+### Gemini (Antigravity CLI)
+- **Authentication**: Google OAuth via the Antigravity CLI (`agy`) — no API key needed
 - **Setup Required**:
-  1. Install Gemini CLI globally: `npm install -g @google/gemini-cli`
-  2. Authenticate: Run `gemini` command and follow interactive prompts
-  3. Credentials stored in `~/.gemini/oauth_creds.json`
-- **Environment Variables**: None (uses OAuth credentials file)
-- **Supported Models**:
-  - `gemini` - Routes to gemini-3-pro-preview via CLI
-  - Provides access to Gemini 3.0 Pro Preview through Google subscription (Google One AI Premium or Gemini Advanced)
+  1. Install the Antigravity CLI (`agy`):
+     - Windows (PowerShell): `irm https://antigravity.google/cli/install.ps1 | iex`
+     - macOS/Linux: `curl -fsSL https://antigravity.google/cli/install.sh | bash`
+  2. Authenticate: run `agy` once interactively and complete the Google OAuth login. This also establishes workspace trust for your home directory (the provider spawns each call in a per-call subdirectory under `~/.converse/agy-runs`).
+- **Environment Variables**: None (the provider detects the `agy` binary on PATH or at the platform install location)
+- **Supported Models** (text-only — print mode has no image input channel):
+  - `gemini` (= `gemini:pro`) - Gemini 3.1 Pro
+  - `gemini:flash` - Gemini 3.5 Flash
+  - `reasoning_effort` selects the variant: `low` → (Low), `medium` → (Medium) for Flash / (High) for Pro, `high`/`max` → (High); unset defaults to (High)
 
 **Key Features:**
-- **OAuth Authentication**: Uses Google account login instead of API keys
-- **Subscription Access**: Leverage Google subscription instead of paying per API call
-- **Enhanced Features**: Access to agentic features available through CLI that aren't in standard API
-- **Model Support**: Currently supports gemini-3-pro-preview only
+- **OAuth Authentication**: Uses your Antigravity Google login instead of API keys
+- **Subscription Access**: Leverages the Antigravity weekly compute allowance instead of pay-per-API-call
+- **One-shot responses**: The provider shells out to `agy -p` under a pseudo-terminal and returns the full response in a single chunk (no token-level streaming; ~7s minimum per call, ~30-60s for very large prompts)
+
+> Note: This replaces the previous `@google/gemini-cli` (`ai-sdk-provider-gemini-cli`) integration, whose OAuth access Google sunsets on 2026-06-18.
 
 **Authentication Setup:**
 ```bash
-# Install Gemini CLI globally
-npm install -g @google/gemini-cli
-
-# Run interactive authentication (one-time setup)
-gemini
-
-# Follow prompts to:
-# 1. Select authentication method (Personal OAuth recommended)
-# 2. Authorize via browser
-# 3. Credentials are saved to ~/.gemini/oauth_creds.json
+# Install the Antigravity CLI (agy)
+# Windows (PowerShell):
+irm https://antigravity.google/cli/install.ps1 | iex
+# macOS/Linux:
+curl -fsSL https://antigravity.google/cli/install.sh | bash
+
+# Run interactive login (one-time setup) — also establishes workspace trust
+agy
 ```
 
 **Usage Examples:**
@@ -167,16 +168,16 @@ gemini
 ```
 
 **Best Practices:**
-- Authenticate before first use (run `gemini` CLI command)
+- Authenticate before first use (run `agy` once interactively to log in)
 - Use specific model names for Google API access (e.g., `gemini-2.5-pro`)
-- Model name `gemini` is reserved for CLI-based access
-- Check credentials file exists at `~/.gemini/oauth_creds.json` if authentication fails
+- Model names `gemini`, `gemini:pro`, and `gemini:flash` are reserved for Antigravity CLI access
+- If a call returns an empty response, the CLI is likely not authenticated — run `agy` interactively once
 
 **Differences from Google API Provider:**
-- **Authentication**: OAuth (CLI) vs API Key (Google API)
-- **Billing**: Google subscription vs pay-per-use API
-- **Model Routing**: `gemini` → CLI provider, specific names (e.g., `gemini-2.5-pro`) → API provider
-- **Models**: Only gemini-3-pro-preview vs full Gemini model family
+- **Authentication**: Google OAuth via `agy` vs API Key (Google API)
+- **Billing**: Antigravity subscription/compute allowance vs pay-per-use API
+- **Model Routing**: `gemini` / `gemini:flash` / `gemini:pro` → Antigravity CLI provider, specific names (e.g., `gemini-2.5-pro`, bare `gemini-pro`) → Google API provider
+- **Images**: Not supported (text-only) vs full multimodal on the Google API provider
 
 ### Claude Agent SDK
 - **Authentication**: Claude Code CLI login (no API key needed)
@@ -281,7 +282,7 @@ When using the chat or consensus tools, specify models using their identifiers:
 
 1. **SDK Providers** (exact matches and prefixes, checked first):
    - `codex` → Codex
-   - `gemini`, `gemini-cli` → Gemini CLI
+   - `gemini`, `gemini-cli`, and any `gemini:`-prefixed name (e.g., `gemini:flash`, `gemini:pro`) → Gemini via Antigravity CLI
    - `claude`, `claude-sdk`, `claude-code` and any `claude:`-prefixed name (e.g., `claude:fable`, `claude:opus`) → Claude Agent SDK
    - `copilot`, `copilot-sdk`, `github-copilot` and any `copilot:`-prefixed name (e.g., `copilot:codex`) → Copilot SDK
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "converse-mcp-server",
-  "version": "2.27.0",
+  "version": "2.28.0",
   "description": "Converse MCP Server - Converse with other LLMs with chat and consensus tools",
   "type": "module",
   "main": "src/index.js",
@@ -49,10 +49,9 @@
     "lint": "eslint src/ tests/",
     "lint:fix": "eslint src/ tests/ --fix",
     "lint:watch": "nodemon --exec \"npm run lint\" --watch src --watch tests",
-    "format": "prettier --write src/ tests/ *.md *.json",
-    "format:check": "prettier --check src/ tests/ *.md *.json",
+    "format": "eslint src/ tests/ --fix",
     "typecheck": "node scripts/typecheck.js",
-    "validate:simple": "npm run typecheck && npm run lint && npm run format:check && npm run test",
+    "validate:simple": "npm run typecheck && npm run lint && npm run test",
     "clean": "rimraf node_modules package-lock.json && npm install",
     "debug": "cross-env NODE_ENV=development LOG_LEVEL=trace node --inspect src/index.js",
     "debug:break": "cross-env NODE_ENV=development LOG_LEVEL=trace node --inspect-brk src/index.js",
@@ -94,15 +93,15 @@
     ".env.example"
   ],
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.3.168",
+    "@anthropic-ai/claude-agent-sdk": "^0.3.169",
     "@anthropic-ai/sdk": "^0.102.0",
-    "@github/copilot-sdk": "^0.3.0",
+    "@github/copilot-sdk": "^1.0.0",
     "@google/genai": "^2.8.0",
+    "@lydell/node-pty": "1.2.0-beta.12",
     "@mistralai/mistralai": "^2.2.5",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@openai/codex-sdk": "^0.137.0",
-    "ai": "^6.0.197",
-    "ai-sdk-provider-gemini-cli": "^2.0.1",
+    "@openai/codex-sdk": "^0.138.0",
+    "ai": "^6.0.198",
     "cors": "^2.8.6",
     "dotenv": "^17.4.2",
     "express": "^5.2.1",
@@ -116,7 +115,6 @@
     "@vitest/coverage-v8": "^4.1.8",
     "cross-env": "^10.1.0",
     "eslint": "^10.4.1",
-    "prettier": "^3.8.3",
     "rimraf": "^6.1.3",
     "vitest": "^4.1.8"
   }

package/src/config.js

@@ -12,6 +12,7 @@ import { ConfigurationError } from './utils/errorHandler.js';
 import { fileURLToPath } from 'url';
 import { dirname, join, resolve } from 'path';
 import { readFileSync } from 'fs';
+import { findAgyBinary } from './providers/gemini-cli.js';
 
 // Load environment variables from appropriate .env file
 // Priority: .env.test (for test env) > .env (default)
@@ -655,12 +656,11 @@ export async function loadConfig() {
       config.providers.googlecloudproject &&
       config.providers.googlecloudlocation;
     const sdkPackages = {
-      codex: '@anthropic-ai/claude-code',
+      codex: '@openai/codex-sdk',
       claude: '@anthropic-ai/claude-agent-sdk',
-      'gemini-cli': '@anthropic-ai/claude-code', // shares codex check
       copilot: '@github/copilot-sdk',
     };
-    const hasSdkProvider = Object.values(sdkPackages).some((pkg) => {
+    let hasSdkProvider = Object.values(sdkPackages).some((pkg) => {
       try {
         import.meta.resolve(pkg);
         return true;
@@ -669,9 +669,22 @@ export async function loadConfig() {
       }
     });
 
+    // gemini-cli availability comes from the Antigravity CLI binary, not an
+    // npm package — reuse the provider's probe (safe to import: node-pty is
+    // lazy-loaded at invoke time). Only probed when validation would otherwise
+    // fail, since hasSdkProvider is only read by the check below.
+    if (
+      availableKeys.length === 0 &&
+      !hasVertexAI &&
+      !hasSdkProvider &&
+      findAgyBinary() !== null
+    ) {
+      hasSdkProvider = true;
+    }
+
     if (availableKeys.length === 0 && !hasVertexAI && !hasSdkProvider) {
       errors.push(
-        'At least one API key must be configured: OPENAI_API_KEY, XAI_API_KEY, GOOGLE_API_KEY, GEMINI_API_KEY, ANTHROPIC_API_KEY, MISTRAL_API_KEY, DEEPSEEK_API_KEY, or OPENROUTER_API_KEY. Alternatively, configure Google Vertex AI or use an SDK-based provider (codex, claude, gemini-cli, copilot).',
+        'At least one API key must be configured: OPENAI_API_KEY, XAI_API_KEY, GOOGLE_API_KEY, GEMINI_API_KEY, ANTHROPIC_API_KEY, MISTRAL_API_KEY, DEEPSEEK_API_KEY, or OPENROUTER_API_KEY. Alternatively, configure Google Vertex AI or use an SDK-based provider (codex, claude, copilot) or the Antigravity CLI (gemini-cli).',
       );
     }
 

package/src/prompts/helpPrompt.js

@@ -462,7 +462,7 @@ ${formatProviderModels('DeepSeek', allModels.deepseek)}
 ${formatProviderModels('OpenRouter', allModels.openrouter)}
 ${formatProviderModels('Codex', allModels.codex)}
 ${formatProviderModels('Claude CLI', allModels.claude)}
-${formatProviderModels('Gemini CLI', allModels['gemini-cli'])}
+${formatProviderModels('Gemini (Antigravity CLI)', allModels['gemini-cli'])}
 
 ${generateModelCategories(allModels)}
 
@@ -500,7 +500,7 @@ These providers use local CLI tools and don't require API keys:
 
 - **codex**: Requires ChatGPT login or CODEX_API_KEY environment variable
 - **claude**: Requires \`claude login\` command (Claude Code CLI authentication)
-- **gemini-cli**: Requires Gemini OAuth authentication via \`gemini\` CLI
+- **gemini-cli**: Requires the Antigravity CLI (\`agy\`) installed and authenticated via Google OAuth (run \`agy\` once interactively to log in)
 
 ## Need More Help?
 

package/src/providers/copilot.js

@@ -7,12 +7,11 @@
  * Key differences from traditional providers:
  * - Uses GitHub Copilot CLI subscription authentication - NOT API keys
  * - Manages a singleton CopilotClient (spawns CLI process via JSON-RPC)
- * - Creates a fresh CopilotSession per request, destroyed after each request
+ * - Creates a fresh CopilotSession per request, disconnected after each request
  * - Bridges SDK push-based events to pull-based async generator for streaming
  * - Requires GitHub CLI authenticated (gh auth login) with active Copilot subscription
  */
 
-import { register } from 'node:module';
 import { debugLog, debugError } from '../utils/console.js';
 import { ProviderError, ErrorCodes, StopReasons } from './interface.js';
 
@@ -317,28 +316,10 @@ function isCopilotSDKAvailable() {
   return _sdkAvailable;
 }
 
-/**
- * Register a module resolution hook to fix the extensionless
- * "vscode-jsonrpc/node" import in @github/copilot-sdk >=0.1.29.
- * The SDK's session.js imports "vscode-jsonrpc/node" without a .js extension,
- * which fails under Node.js strict ESM resolution. The hook rewrites it to
- * "vscode-jsonrpc/node.js". Runs once, works regardless of package manager.
- */
-let _hookRegistered = false;
-function ensureJsonrpcResolveHook() {
-  if (_hookRegistered) return;
-  _hookRegistered = true;
-  register(`data:text/javascript,${encodeURIComponent(
-    'export function resolve(s,c,n){' +
-    'return s==="vscode-jsonrpc/node"?n("vscode-jsonrpc/node.js",c):n(s,c);}',
-  )}`);
-}
-
 /**
  * Dynamically import Copilot SDK (lazy loading)
  */
 async function getCopilotSDK() {
-  ensureJsonrpcResolveHook();
   try {
     const { CopilotClient } = await import('@github/copilot-sdk');
     return CopilotClient;
@@ -370,14 +351,13 @@ async function getCopilotClient(cwd) {
 
   clientInitPromise = (async () => {
     const CopilotClient = await getCopilotSDK();
+    const workingDirectory = cwd || process.cwd();
     clientInstance = new CopilotClient({
-      autoStart: true,
-      autoRestart: true,
       useLoggedInUser: true,
-      cwd: cwd || process.cwd(),
+      workingDirectory,
     });
     await clientInstance.start();
-    debugLog('[Copilot SDK] Client started (cwd: %s)', clientInstance.options?.cwd || cwd);
+    debugLog('[Copilot SDK] Client started (cwd: %s)', workingDirectory);
     return clientInstance;
   })();
 
@@ -808,9 +788,9 @@ async function* createStreamingGenerator(client, prompt, options, signal, config
     }
   } finally {
     try {
-      await session.destroy();
-    } catch (destroyError) {
-      debugError('[Copilot SDK] Session destroy error', destroyError);
+      await session.disconnect();
+    } catch (disconnectError) {
+      debugError('[Copilot SDK] Session disconnect error', disconnectError);
     }
   }
 }