converse-mcp-server 2.27.2 → 2.28.1

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.2",
+  "version": "2.28.1",
   "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,30 +93,29 @@
     ".env.example"
   ],
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.3.169",
-    "@anthropic-ai/sdk": "^0.102.0",
-    "@github/copilot-sdk": "^1.0.0",
-    "@google/genai": "^2.8.0",
-    "@mistralai/mistralai": "^2.2.5",
+    "@anthropic-ai/claude-agent-sdk": "^0.3.185",
+    "@anthropic-ai/sdk": "^0.105.0",
+    "@github/copilot-sdk": "^1.0.3",
+    "@google/genai": "^2.9.0",
+    "@lydell/node-pty": "1.2.0-beta.12",
+    "@mistralai/mistralai": "^2.2.6",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@openai/codex-sdk": "^0.138.0",
-    "ai": "^6.0.198",
-    "ai-sdk-provider-gemini-cli": "^2.0.1",
+    "@openai/codex-sdk": "^0.141.0",
+    "ai": "^6.0.208",
     "cors": "^2.8.6",
     "dotenv": "^17.4.2",
     "express": "^5.2.1",
     "lru-cache": "^11.5.1",
-    "nanoid": "^5.1.11",
-    "openai": "^6.42.0",
+    "nanoid": "^5.1.15",
+    "openai": "^6.44.0",
     "p-limit": "^7.3.0",
     "vite": "^8.0.16"
   },
   "devDependencies": {
-    "@vitest/coverage-v8": "^4.1.8",
+    "@vitest/coverage-v8": "^4.1.9",
     "cross-env": "^10.1.0",
-    "eslint": "^10.4.1",
-    "prettier": "^3.8.3",
+    "eslint": "^10.5.0",
     "rimraf": "^6.1.3",
-    "vitest": "^4.1.8"
+    "vitest": "^4.1.9"
   }
 }

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)
@@ -295,6 +296,12 @@ const CONFIG_SCHEMA = {
       description:
         'Default model for Copilot SDK sessions (e.g., gpt-5, claude-sonnet-4.5)',
     },
+    COPILOT_CLI_PATH: {
+      type: 'string',
+      required: false,
+      description:
+        'Explicit path to the Copilot CLI runtime (index.js or copilot binary). Overrides automatic resolution.',
+    },
   },
 
   // MCP configuration
@@ -655,12 +662,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 +675,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

@@ -12,6 +12,9 @@
  * - Requires GitHub CLI authenticated (gh auth login) with active Copilot subscription
  */
 
+import { existsSync } from 'node:fs';
+import { delimiter, dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { debugLog, debugError } from '../utils/console.js';
 import { ProviderError, ErrorCodes, StopReasons } from './interface.js';
 
@@ -321,8 +324,10 @@ function isCopilotSDKAvailable() {
  */
 async function getCopilotSDK() {
   try {
-    const { CopilotClient } = await import('@github/copilot-sdk');
-    return CopilotClient;
+    const { CopilotClient, RuntimeConnection } = await import(
+      '@github/copilot-sdk'
+    );
+    return { CopilotClient, RuntimeConnection };
   } catch (error) {
     throw new CopilotProviderError(
       `Copilot SDK import failed: ${error.message}`,
@@ -332,6 +337,78 @@ async function getCopilotSDK() {
   }
 }
 
+/**
+ * Locate a runnable `copilot` executable on PATH (e.g. a winget or global
+ * install). On Windows only real executables (.exe/.com) qualify — .cmd/.bat
+ * shims can't be spawned without a shell, and the SDK spawns the CLI without
+ * one, so handing it a shim would fail.
+ */
+function findCopilotBinaryOnPath() {
+  const pathDirs = (process.env.PATH || process.env.Path || '')
+    .split(delimiter)
+    .filter(Boolean);
+  const exts = process.platform === 'win32' ? ['.exe', '.com'] : [''];
+  for (const dir of pathDirs) {
+    for (const ext of exts) {
+      const candidate = join(dir, `copilot${ext}`);
+      if (existsSync(candidate)) return candidate;
+    }
+  }
+  return null;
+}
+
+/**
+ * Resolve the Copilot CLI runtime path deterministically.
+ *
+ * The SDK's built-in resolver (getBundledCliPath) reconstructs
+ * `<@github/copilot root>/index.js` from the package's `./sdk` export. That
+ * assumption breaks across layouts — pnpm stores with multiple versions, global
+ * installs, and loader-style `@github/copilot` variants that ship no root
+ * `index.js` — and there is no escape hatch wired up, so a wrong/missing
+ * bundled copy takes down the whole provider (the "Copilot CLI not found at
+ * ...@github\index.js" failure). We own discovery here and hand the SDK an
+ * explicit, verified path so that entire class of resolution failures can't
+ * occur.
+ *
+ * Precedence: explicit override → bundled npm CLI (index.js, run via node) →
+ * `copilot` on PATH. Returns null to let the SDK fall back to its own
+ * resolution as a last resort (preserves behavior on flat installs).
+ */
+function resolveCopilotCliPath(config) {
+  // 1. Explicit override (COPILOT_CLI_PATH via config or env)
+  const override =
+    config?.providers?.copilotclipath || process.env.COPILOT_CLI_PATH;
+  if (override && existsSync(override)) {
+    debugLog('[Copilot SDK] Using configured CLI path: %s', override);
+    return override;
+  }
+
+  // 2. Bundled npm CLI: resolve the @github/copilot/sdk export, walk to the
+  // package root, and use its index.js. A .js path is spawned via `node`, which
+  // also sidesteps Windows .cmd/.bat shim issues.
+  try {
+    const sdkEntry = fileURLToPath(import.meta.resolve('@github/copilot/sdk'));
+    const candidate = join(dirname(dirname(sdkEntry)), 'index.js');
+    if (existsSync(candidate)) {
+      debugLog('[Copilot SDK] Using bundled CLI: %s', candidate);
+      return candidate;
+    }
+  } catch {
+    // @github/copilot not resolvable from here — fall through.
+  }
+
+  // 3. Standalone `copilot` binary on PATH.
+  const binary = findCopilotBinaryOnPath();
+  if (binary) {
+    debugLog('[Copilot SDK] Using copilot binary from PATH: %s', binary);
+    return binary;
+  }
+
+  // 4. Nothing found — defer to the SDK's own resolution.
+  debugLog('[Copilot SDK] No CLI path resolved — deferring to SDK default');
+  return null;
+}
+
 // Module-level singleton client
 let clientInstance = null;
 let clientInitPromise = null;
@@ -340,7 +417,7 @@ let clientInitPromise = null;
  * Get or create the singleton CopilotClient
  * The client manages the CLI process lifecycle via JSON-RPC
  */
-async function getCopilotClient(cwd) {
+async function getCopilotClient(cwd, config) {
   if (clientInstance) {
     return clientInstance;
   }
@@ -350,12 +427,19 @@ async function getCopilotClient(cwd) {
   }
 
   clientInitPromise = (async () => {
-    const CopilotClient = await getCopilotSDK();
+    const { CopilotClient, RuntimeConnection } = await getCopilotSDK();
     const workingDirectory = cwd || process.cwd();
-    clientInstance = new CopilotClient({
+    const clientOptions = {
       useLoggedInUser: true,
       workingDirectory,
-    });
+    };
+
+    const cliPath = resolveCopilotCliPath(config);
+    if (cliPath) {
+      clientOptions.connection = RuntimeConnection.forStdio({ path: cliPath });
+    }
+
+    clientInstance = new CopilotClient(clientOptions);
     await clientInstance.start();
     debugLog('[Copilot SDK] Client started (cwd: %s)', workingDirectory);
     return clientInstance;
@@ -795,7 +879,7 @@ async function* createStreamingGenerator(client, prompt, options, signal, config
   }
 }
 
-export { resolveModelAlias, resolveSessionModel };
+export { resolveModelAlias, resolveSessionModel, resolveCopilotCliPath };
 
 /**
  * Copilot SDK Provider Implementation
@@ -831,7 +915,7 @@ export const copilotProvider = {
     }
     try {
       const cwd = config.server?.client_cwd || process.cwd();
-      const client = await getCopilotClient(cwd);
+      const client = await getCopilotClient(cwd, config);
       const prompt = convertMessagesToPrompt(messages);
 
       const sessionModel = resolveSessionModel(model, config);