converse-mcp-server 2.3.1 → 2.4.1

package/docs/API.md

@@ -99,6 +99,12 @@ MCP_TRANSPORT=stdio npm start
       "default": false,
       "description": "Enable web search for current information. Example: true for framework docs, false for private code analysis"
     },
+    "media_resolution": {
+      "type": "string",
+      "enum": ["MEDIA_RESOLUTION_LOW", "MEDIA_RESOLUTION_MEDIUM", "MEDIA_RESOLUTION_HIGH", "MEDIA_RESOLUTION_UNSPECIFIED"],
+      "default": "MEDIA_RESOLUTION_HIGH",
+      "description": "Control image/PDF/video processing quality (Gemini 3.0). Defaults to 'MEDIA_RESOLUTION_HIGH' for Gemini 3.0. Examples: 'MEDIA_RESOLUTION_LOW' (faster, less detail), 'MEDIA_RESOLUTION_MEDIUM' (balanced), 'MEDIA_RESOLUTION_HIGH' (maximum detail)"
+    },
     "async": {
       "type": "boolean",
       "default": false,
@@ -329,10 +335,13 @@ MCP_TRANSPORT=stdio npm start
 
 | Model | Alias | Context | Tokens | Features | Use Cases |
 |-------|-------|---------|--------|----------|-----------|
+| `gemini-3-pro-preview` | `pro`, `gemini` | 1M | 64K | Thinking levels, enhanced reasoning | Complex problems, deep analysis |
 | `gemini-2.5-flash` | `flash` | 1M | 65K | Ultra-fast | Quick analysis, simple queries |
-| `gemini-2.5-pro` | `pro` | 1M | 65K | Thinking mode | Deep reasoning, architecture |
+| `gemini-2.5-pro` | `pro 2.5` | 1M | 65K | Thinking mode | Deep reasoning, architecture |
 | `gemini-2.0-flash` | `flash2` | 1M | 65K | Latest | Experimental thinking |
 
+**Note:** Default aliases `gemini`, `pro`, and `gemini-pro` now point to Gemini 3.0 Pro. Use `gemini-2.5-pro` explicitly if you need the 2.5 version.
+
 ### X.AI/Grok Models
 
 | Model | Alias | Context | Tokens | Features | Use Cases |

package/docs/PROVIDERS.md

@@ -20,9 +20,11 @@ This guide documents all supported AI providers in the Converse MCP Server and t
 - **Get Key**: [makersuite.google.com/app/apikey](https://makersuite.google.com/app/apikey)
 - **Environment Variable**: `GOOGLE_API_KEY`
 - **Supported Models**:
-  - `gemini-2.5-pro` - Deep reasoning with thinking mode
-  - `gemini-2.5-flash` - Ultra-fast model
-  - `gemini-2.0-flash`, `gemini-2.0-flash-lite` - Latest generation
+  - `gemini-3-pro-preview` (aliases: `pro`, `gemini`) - 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)
+  - `gemini-2.0-flash`, `gemini-2.0-flash-lite` - Latest generation (1M context, 65K output)
+- **Note**: Default aliases (`gemini`, `pro`, `gemini-pro`) now point to Gemini 3.0 Pro. Use `gemini-2.5-pro` explicitly if you need version 2.5.
 
 ### X.AI (Grok)
 - **API Key Format**: `xai-...` (starts with `xai-`)
@@ -176,7 +178,9 @@ All providers support streaming responses for real-time output.
 
 ### Thinking/Reasoning Modes
 - **OpenAI**: O3 series models support `reasoning_effort` parameter
-- **Google**: Gemini Pro/Flash support thinking mode with configurable budget
+- **Google**:
+  - Gemini 3.0 Pro: Thinking levels (low/high) via `reasoning_effort` - always enabled
+  - Gemini 2.5 Pro/Flash: Thinking budget (token-based) via `reasoning_effort`
 - **Anthropic**: Claude 4 and 3.7 models support extended thinking with `reasoning_effort`
 - **Codex**: Thread-based agentic reasoning with persistent context
 - **Others**: Standard inference only

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "converse-mcp-server",
-  "version": "2.3.1",
+  "version": "2.4.1",
   "description": "Converse MCP Server - Converse with other LLMs with chat and consensus tools",
   "type": "module",
   "main": "src/index.js",
@@ -40,26 +40,26 @@
     ".env.example"
   ],
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.65.0",
-    "@google/genai": "^1.22.0",
+    "@anthropic-ai/sdk": "^0.70.0",
+    "@google/genai": "^1.30.0",
     "@mistralai/mistralai": "^1.10.0",
-    "@modelcontextprotocol/sdk": "^1.19.1",
-    "@openai/codex-sdk": "^0.45.0",
+    "@modelcontextprotocol/sdk": "^1.22.0",
+    "@openai/codex-sdk": "^0.58.0",
     "cors": "^2.8.5",
     "dotenv": "^17.2.3",
     "express": "^5.1.0",
     "lru-cache": "^11.2.2",
-    "openai": "^6.1.0",
-    "p-limit": "^4.0.0",
-    "vite": "^7.1.9"
+    "openai": "^6.9.1",
+    "p-limit": "^7.2.0",
+    "vite": "^7.2.2"
   },
   "devDependencies": {
-    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/coverage-v8": "^4.0.10",
     "cross-env": "^10.1.0",
-    "eslint": "^9.36.0",
+    "eslint": "^9.39.1",
     "prettier": "^3.6.2",
-    "rimraf": "^6.0.1",
-    "vitest": "^3.2.4"
+    "rimraf": "^6.1.0",
+    "vitest": "^4.0.10"
   },
   "scripts": {
     "kill-server": "node scripts/kill-server.js",

package/src/async/asyncJobStore.js

@@ -92,7 +92,9 @@ export class AsyncJobStoreInterface {
    * @returns {Promise<Array>} Array of all jobs
    */
   async getAllJobs(_options = {}) {
-    throw new Error('getAllJobs() method must be implemented by storage backend');
+    throw new Error(
+      'getAllJobs() method must be implemented by storage backend',
+    );
   }
 
   /**
@@ -133,7 +135,9 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
     super();
 
     // Check environment variable for memory TTL
-    const envMemoryTTL = process.env.ASYNC_MEMORY_TTL_MS ? parseInt(process.env.ASYNC_MEMORY_TTL_MS, 10) : null;
+    const envMemoryTTL = process.env.ASYNC_MEMORY_TTL_MS
+      ? parseInt(process.env.ASYNC_MEMORY_TTL_MS, 10)
+      : null;
     const ttl = envMemoryTTL || 24 * 60 * 60 * 1000; // Default 24 hours
 
     // Configure LRU cache with configurable TTL and 10k job capacity
@@ -166,7 +170,7 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
       if (!tool || !['chat', 'consensus'].includes(tool)) {
         throw new AsyncJobStoreError(
           'Invalid tool: must be "chat" or "consensus"',
-          'INVALID_TOOL'
+          'INVALID_TOOL',
         );
       }
 
@@ -175,7 +179,7 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
       if (!jobId) {
         throw new AsyncJobStoreError(
           'jobId is required in options',
-          'MISSING_JOB_ID'
+          'MISSING_JOB_ID',
         );
       }
       const now = Date.now();
@@ -211,19 +215,18 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
 
       // Log event
       this._addEvent(jobState, 'job_created', {
-        tool
+        tool,
       });
 
       debugLog(`AsyncJobStore: Created job ${jobId} for ${tool}`);
       return jobId;
-
     } catch (error) {
       if (error instanceof AsyncJobStoreError) {
         throw error;
       }
       throw new AsyncJobStoreError(
         `Failed to create job: ${error.message}`,
-        'CREATION_ERROR'
+        'CREATION_ERROR',
       );
     }
   }
@@ -240,7 +243,7 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
       if (!jobId || typeof jobId !== 'string') {
         throw new AsyncJobStoreError(
           'Invalid job ID: must be a non-empty string',
-          'INVALID_JOB_ID'
+          'INVALID_JOB_ID',
         );
       }
 
@@ -254,14 +257,13 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
 
       // Return deep copy to prevent external mutations
       return this._deepClone(job);
-
     } catch (error) {
       if (error instanceof AsyncJobStoreError) {
         throw error;
       }
       throw new AsyncJobStoreError(
         `Failed to retrieve job: ${error.message}`,
-        'RETRIEVAL_ERROR'
+        'RETRIEVAL_ERROR',
       );
     }
   }
@@ -279,14 +281,14 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
       if (!jobId || typeof jobId !== 'string') {
         throw new AsyncJobStoreError(
           'Invalid job ID: must be a non-empty string',
-          'INVALID_JOB_ID'
+          'INVALID_JOB_ID',
         );
       }
 
       if (!updates || typeof updates !== 'object') {
         throw new AsyncJobStoreError(
           'Invalid updates: must be an object',
-          'INVALID_UPDATES'
+          'INVALID_UPDATES',
         );
       }
 
@@ -298,7 +300,10 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
       const now = Date.now();
 
       // Apply updates
-      if (updates.status && Object.values(JOB_STATUS).includes(updates.status)) {
+      if (
+        updates.status &&
+        Object.values(JOB_STATUS).includes(updates.status)
+      ) {
         job.status = updates.status;
 
         // Set startedAt when status changes to running
@@ -314,7 +319,10 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
       if (updates.providers) {
         // Update provider states
         Object.entries(updates.providers).forEach(([provider, state]) => {
-          job.providers.set(provider, { ...job.providers.get(provider), ...state });
+          job.providers.set(provider, {
+            ...job.providers.get(provider),
+            ...state,
+          });
         });
       }
 
@@ -336,7 +344,22 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
       }
 
       // Apply any other updates as direct properties on the job
-      const reservedFields = ['status', 'progress', 'providers', 'overall', 'jobId', 'sessionId', 'createdAt', 'updatedAt', 'events', 'seq', 'accumulated_content', 'title', 'final_summary', 'reasoning_summary'];
+      const reservedFields = [
+        'status',
+        'progress',
+        'providers',
+        'overall',
+        'jobId',
+        'sessionId',
+        'createdAt',
+        'updatedAt',
+        'events',
+        'seq',
+        'accumulated_content',
+        'title',
+        'final_summary',
+        'reasoning_summary',
+      ];
       Object.entries(updates).forEach(([key, value]) => {
         if (!reservedFields.includes(key)) {
           job[key] = value;
@@ -350,14 +373,13 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
       this._addEvent(job, 'job_updated', updates);
 
       return true;
-
     } catch (error) {
       if (error instanceof AsyncJobStoreError) {
         throw error;
       }
       throw new AsyncJobStoreError(
         `Failed to update job: ${error.message}`,
-        'UPDATE_ERROR'
+        'UPDATE_ERROR',
       );
     }
   }
@@ -392,11 +414,10 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
 
       debugLog(`AsyncJobStore: Completed job ${jobId}`);
       return true;
-
     } catch (error) {
       throw new AsyncJobStoreError(
         `Failed to complete job: ${error.message}`,
-        'COMPLETION_ERROR'
+        'COMPLETION_ERROR',
       );
     }
   }
@@ -418,9 +439,10 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
       const now = Date.now();
 
       // Serialize error information
-      const errorInfo = error instanceof Error
-        ? { message: error.message, name: error.name, stack: error.stack }
-        : error;
+      const errorInfo =
+        error instanceof Error
+          ? { message: error.message, name: error.name, stack: error.stack }
+          : error;
 
       // Update job state
       job.status = JOB_STATUS.FAILED;
@@ -435,11 +457,10 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
 
       debugError(`AsyncJobStore: Failed job ${jobId}:`, errorInfo);
       return true;
-
     } catch (err) {
       throw new AsyncJobStoreError(
         `Failed to fail job: ${err.message}`,
-        'FAILURE_ERROR'
+        'FAILURE_ERROR',
       );
     }
   }
@@ -453,7 +474,7 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
     let totalEvents = 0;
 
     // Count jobs by status
-    Object.values(JOB_STATUS).forEach(status => {
+    Object.values(JOB_STATUS).forEach((status) => {
       statusCounts[status] = 0;
     });
 
@@ -512,26 +533,25 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
    */
   async getAllJobs(options = {}) {
     try {
-
       const {
         limit = 50,
         status,
         sortBy = 'updatedAt',
-        sortOrder = 'desc'
+        sortOrder = 'desc',
       } = options;
 
       // Validate options
       if (!Number.isInteger(limit) || limit < 1 || limit > 1000) {
         throw new AsyncJobStoreError(
           'Limit must be an integer between 1 and 1000',
-          'INVALID_LIMIT'
+          'INVALID_LIMIT',
         );
       }
 
       if (status && !Object.values(JOB_STATUS).includes(status)) {
         throw new AsyncJobStoreError(
           `Invalid status: must be one of ${Object.values(JOB_STATUS).join(', ')}`,
-          'INVALID_STATUS'
+          'INVALID_STATUS',
         );
       }
 
@@ -557,14 +577,13 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
 
       debugLog(`AsyncJobStore: Found ${limitedJobs.length} jobs`);
       return limitedJobs;
-
     } catch (error) {
       if (error instanceof AsyncJobStoreError) {
         throw error;
       }
       throw new AsyncJobStoreError(
         `Failed to get all jobs: ${error.message}`,
-        'QUERY_ERROR'
+        'QUERY_ERROR',
       );
     }
   }
@@ -584,13 +603,15 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
       EVENT_TYPES.JOB_CANCELLED,
     ];
 
-    eventTypes.forEach(eventType => {
+    eventTypes.forEach((eventType) => {
       this.eventBus.on(eventType, (eventData) => {
         this._storeEventInJob(eventData);
       });
     });
 
-    debugLog('AsyncJobStore: Set up EventBus listeners for job lifecycle events');
+    debugLog(
+      'AsyncJobStore: Set up EventBus listeners for job lifecycle events',
+    );
   }
 
   /**
@@ -625,9 +646,11 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
 
       // Update job's last activity
       job.updatedAt = Date.now();
-
     } catch (error) {
-      debugError('AsyncJobStore: Failed to store EventBus event in job:', error);
+      debugError(
+        'AsyncJobStore: Failed to store EventBus event in job:',
+        error,
+      );
     }
   }
 
@@ -651,11 +674,11 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
 
       // Apply filters
       if (options.eventType) {
-        events = events.filter(event => event.type === options.eventType);
+        events = events.filter((event) => event.type === options.eventType);
       }
 
       if (options.afterSeq !== undefined) {
-        events = events.filter(event => event.seq > options.afterSeq);
+        events = events.filter((event) => event.seq > options.afterSeq);
       }
 
       // Apply limit
@@ -665,9 +688,11 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
 
       // Return deep copy to prevent mutations
       return this._deepClone(events);
-
     } catch (error) {
-      debugError(`AsyncJobStore: Failed to get events for job ${jobId}:`, error);
+      debugError(
+        `AsyncJobStore: Failed to get events for job ${jobId}:`,
+        error,
+      );
       return [];
     }
   }
@@ -686,9 +711,11 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
 
       const latestEvent = job.events[job.events.length - 1];
       return this._deepClone(latestEvent);
-
     } catch (error) {
-      debugError(`AsyncJobStore: Failed to get latest event for job ${jobId}:`, error);
+      debugError(
+        `AsyncJobStore: Failed to get latest event for job ${jobId}:`,
+        error,
+      );
       return null;
     }
   }
@@ -750,7 +777,7 @@ class LRUAsyncJobStore extends AsyncJobStoreInterface {
     }
 
     if (Array.isArray(obj)) {
-      return obj.map(item => this._deepClone(item));
+      return obj.map((item) => this._deepClone(item));
     }
 
     const cloned = {};
@@ -774,16 +801,19 @@ export function getAsyncJobStore() {
     asyncJobStore = new LRUAsyncJobStore();
 
     // Set up periodic cleanup (runs every 10 minutes, same as continuation store)
-    cleanupIntervalId = setInterval(async () => {
-      try {
-        const cleaned = await asyncJobStore.cleanup();
-        if (cleaned > 0) {
-          debugLog(`AsyncJobStore: Cleaned up ${cleaned} old jobs`);
+    cleanupIntervalId = setInterval(
+      async () => {
+        try {
+          const cleaned = await asyncJobStore.cleanup();
+          if (cleaned > 0) {
+            debugLog(`AsyncJobStore: Cleaned up ${cleaned} old jobs`);
+          }
+        } catch (error) {
+          debugError('AsyncJobStore cleanup failed:', error);
         }
-      } catch (error) {
-        debugError('AsyncJobStore cleanup failed:', error);
-      }
-    }, 10 * 60 * 1000);
+      },
+      10 * 60 * 1000,
+    );
 
     // Unref the interval so it doesn't keep the process alive
     if (cleanupIntervalId && typeof cleanupIntervalId.unref === 'function') {
@@ -801,7 +831,7 @@ export function setAsyncJobStore(store) {
   if (store !== null && !(store instanceof AsyncJobStoreInterface)) {
     throw new AsyncJobStoreError(
       'Store must extend AsyncJobStoreInterface',
-      'INVALID_STORE'
+      'INVALID_STORE',
     );
   }
   asyncJobStore = store;

package/src/async/eventBus.js

@@ -78,7 +78,7 @@ export class EventBus extends EventEmitter {
       tool: data.tool,
       options: data.options,
       timestamp: Date.now(),
-      ...data
+      ...data,
     });
   }
 
@@ -94,7 +94,7 @@ export class EventBus extends EventEmitter {
       status: data.status,
       providers: data.providers,
       timestamp: Date.now(),
-      ...data
+      ...data,
     });
   }
 
@@ -108,7 +108,7 @@ export class EventBus extends EventEmitter {
     return this._emitJobEvent(EVENT_TYPES.JOB_COMPLETED, jobId, {
       result,
       timestamp: Date.now(),
-      duration: this._calculateDuration(jobId)
+      duration: this._calculateDuration(jobId),
     });
   }
 
@@ -119,16 +119,19 @@ export class EventBus extends EventEmitter {
    * @returns {boolean} True if event was emitted
    */
   emitJobFailed(jobId, error) {
-    const errorData = error instanceof Error ? {
-      message: error.message,
-      code: error.code || 'UNKNOWN_ERROR',
-      stack: error.stack
-    } : { message: String(error) };
+    const errorData =
+      error instanceof Error
+        ? {
+          message: error.message,
+          code: error.code || 'UNKNOWN_ERROR',
+          stack: error.stack,
+        }
+        : { message: String(error) };
 
     return this._emitJobEvent(EVENT_TYPES.JOB_FAILED, jobId, {
       error: errorData,
       timestamp: Date.now(),
-      duration: this._calculateDuration(jobId)
+      duration: this._calculateDuration(jobId),
     });
   }
 
@@ -143,7 +146,7 @@ export class EventBus extends EventEmitter {
       reason: data.reason || 'User cancelled',
       partial_result: data.partial_result,
       timestamp: Date.now(),
-      ...data
+      ...data,
     });
   }
 
@@ -157,7 +160,7 @@ export class EventBus extends EventEmitter {
     return this._emitJobEvent(EVENT_TYPES.JOB_STARTED, jobId, {
       tool: data.tool,
       timestamp: Date.now(),
-      ...data
+      ...data,
     });
   }
 
@@ -171,14 +174,14 @@ export class EventBus extends EventEmitter {
     if (!Object.values(EVENT_TYPES).includes(eventType)) {
       throw new EventBusError(
         `Invalid event type: ${eventType}`,
-        'INVALID_EVENT_TYPE'
+        'INVALID_EVENT_TYPE',
       );
     }
 
     if (typeof listener !== 'function') {
       throw new EventBusError(
         'Listener must be a function',
-        'INVALID_LISTENER'
+        'INVALID_LISTENER',
       );
     }
 
@@ -218,7 +221,7 @@ export class EventBus extends EventEmitter {
       ...this.stats,
       totalListeners: this.listenerCount(),
       eventHistorySize: this.eventHistory.size,
-      memoryUsage: this._calculateMemoryUsage()
+      memoryUsage: this._calculateMemoryUsage(),
     };
   }
 
@@ -236,7 +239,7 @@ export class EventBus extends EventEmitter {
       if (!jobId || typeof jobId !== 'string') {
         throw new EventBusError(
           'Invalid job ID: must be a non-empty string',
-          'INVALID_JOB_ID'
+          'INVALID_JOB_ID',
         );
       }
 
@@ -245,7 +248,7 @@ export class EventBus extends EventEmitter {
         type: eventType,
         jobId,
         data,
-        timestamp: data.timestamp || Date.now()
+        timestamp: data.timestamp || Date.now(),
       };
 
       // Add to history
@@ -259,15 +262,17 @@ export class EventBus extends EventEmitter {
 
       debugLog(`EventBus: Emitted ${eventType} for job ${jobId}`);
       return hasListeners;
-
     } catch (error) {
-      debugError(`EventBus: Failed to emit event ${eventType} for job ${jobId}:`, error);
+      debugError(
+        `EventBus: Failed to emit event ${eventType} for job ${jobId}:`,
+        error,
+      );
       if (error instanceof EventBusError) {
         throw error;
       }
       throw new EventBusError(
         `Failed to emit event: ${error.message}`,
-        'EMISSION_ERROR'
+        'EMISSION_ERROR',
       );
     }
   }
@@ -304,7 +309,7 @@ export class EventBus extends EventEmitter {
       return null;
     }
 
-    const createEvent = history.find(e => e.type === EVENT_TYPES.JOB_CREATED);
+    const createEvent = history.find((e) => e.type === EVENT_TYPES.JOB_CREATED);
     if (!createEvent) {
       return null;
     }