converse-mcp-server 1.14.4 → 1.15.1

package/.env.example

@@ -48,4 +48,11 @@ OPENROUTER_API_KEY=your_openrouter_api_key_here
 # OpenRouter requires a referer for compliance (your app URL or GitHub repo)
 OPENROUTER_REFERER=https://github.com/FallDownTheSystem/converse
 
+# ============================================
+# Server Configuration
+# ============================================
+
+# Disable async execution tools (check_status, cancel_job) and async parameter
+# When true, removes async capabilities from chat/consensus tools
+# DISABLE_ASYNC_TOOLS=false
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "converse-mcp-server",
-  "version": "1.14.4",
+  "version": "1.15.1",
   "description": "Converse MCP Server - Converse with other LLMs with chat and consensus tools",
   "type": "module",
   "main": "src/index.js",

package/src/config.js

@@ -112,6 +112,11 @@ const CONFIG_SCHEMA = {
     ENABLE_RESPONSE_SUMMARIZATION: { type: 'boolean', default: false, description: 'Enable AI-powered response summarization for async operations' },
     SUMMARIZATION_MODEL: { type: 'string', default: 'gpt-5-nano', description: 'Model to use for summarization tasks (title generation, streaming summaries, final summaries)' },
   },
+
+  // Async tools configuration
+  async: {
+    DISABLE_ASYNC_TOOLS: { type: 'boolean', default: false, description: 'Disable async execution support (removes async parameter from tools and status check tools)' },
+  },
 };
 
 // ConfigurationError now imported from errorHandler
@@ -318,6 +323,19 @@ export async function loadConfig() {
       }
     }
 
+    // Load Async tools configuration
+    config.async = {};
+    for (const [key, schema] of Object.entries(CONFIG_SCHEMA.async)) {
+      try {
+        const value = validateEnvVar(key, process.env[key], schema);
+        if (key === 'DISABLE_ASYNC_TOOLS') {
+          config.async.disableAsyncTools = value;
+        }
+      } catch (error) {
+        errors.push(error.message);
+      }
+    }
+
     // Load name and version from package.json
     try {
       const packagePath = join(dirname(fileURLToPath(import.meta.url)), '../package.json');

package/src/prompts/helpPrompt.js

@@ -9,8 +9,9 @@ import { getTools } from '../tools/index.js';
 
 /**
  * Generate comprehensive help content dynamically based on current providers
+ * @param {object} config - Configuration object (optional)
  */
-export function generateHelpContent() {
+export function generateHelpContent(config = null) {
   const providers = getProviders();
 
   // Collect all models from all providers
@@ -58,7 +59,7 @@ export function generateHelpContent() {
   };
 
   // Get tools and format their documentation
-  const tools = getTools();
+  const tools = getTools(config);
   const formatToolParameters = (inputSchema) => {
     if (!inputSchema || !inputSchema.properties) return '';
 
@@ -235,11 +236,13 @@ Note: Server name and version are automatically read from package.json.
 
 /**
  * Help prompt handler function
+ * @param {object} args - Prompt arguments
+ * @param {object} config - Configuration object (optional)
  */
-export async function helpPromptHandler(args = {}) {
+export async function helpPromptHandler(args = {}, config = null) {
   const { topic } = args;
 
-  const fullHelp = generateHelpContent();
+  const fullHelp = generateHelpContent(config);
 
   // If no topic specified, return full help
   if (!topic) {

package/src/providers/google.js

@@ -41,7 +41,7 @@ const SUPPORTED_MODELS = {
     aliases: ['flashlite', 'flash-lite', 'flash lite', 'flash-lite-2.0', 'gemini flash lite', 'gemini-2.0-flash-lite-latest']
   },
   'gemini-2.5-flash': {
-    modelName: 'gemini-2.5-flash',
+    modelName: 'gemini-flash-latest',
     friendlyName: 'Gemini (Flash 2.5)',
     contextWindow: 1048576, // 1M tokens
     maxOutputTokens: 65536,
@@ -53,7 +53,22 @@ const SUPPORTED_MODELS = {
     maxThinkingTokens: 24576,
     timeout: 300000,
     description: 'Ultra-fast (1M context) - Quick analysis, simple queries, rapid iterations with grounding',
-    aliases: ['flash', 'flash2.5', 'gemini-flash', 'gemini-flash-2.5', 'flash 2.5', 'gemini flash 2.5', 'gemini-2.5-flash-latest']
+    aliases: ['flash', 'flash2.5', 'gemini-flash', 'gemini-flash-2.5', 'flash 2.5', 'gemini flash 2.5', 'gemini-2.5-flash', 'gemini-2.5-flash-preview-09-2025', 'gemini-2.5-flash-latest']
+  },
+  'gemini-2.5-flash-lite': {
+    modelName: 'gemini-flash-lite-latest',
+    friendlyName: 'Gemini (Flash Lite 2.5)',
+    contextWindow: 1048576, // 1M tokens
+    maxOutputTokens: 65536,
+    supportsStreaming: true,
+    supportsImages: true,
+    supportsTemperature: true,
+    supportsThinking: true,
+    supportsWebSearch: true,
+    maxThinkingTokens: 24576,
+    timeout: 300000,
+    description: 'Lightweight fast model (1M context) - Efficient quick responses with grounding',
+    aliases: ['flashlite2.5', 'flash-lite', 'flash lite', 'gemini-flash-lite', 'gemini flash lite', 'gemini-2.5-flash-lite-preview-09-2025', 'gemini-2.5-flash-lite-latest']
   },
   'gemini-2.5-pro': {
     modelName: 'gemini-2.5-pro',

package/src/providers/openai.js

@@ -389,9 +389,9 @@ export const openaiProvider = {
 
       // Add reasoning effort for thinking models (o3 series and GPT-5 family)
       if ((resolvedModel.startsWith('o3') || resolvedModel.startsWith('gpt-5')) && reasoning_effort) {
-        requestPayload.reasoning = { 
+        requestPayload.reasoning = {
           effort: reasoning_effort,
-          summary: "auto" // Enable reasoning summaries
+          summary: 'auto' // Enable reasoning summaries
         };
       }
 
@@ -483,23 +483,23 @@ export const openaiProvider = {
       if (shouldUseResponsesAPI) {
         // Handle Responses API response format
         let reasoningSummary = null;
-        
+
         if (response.output) {
           // New format with output array (includes reasoning summaries)
           const messageOutput = response.output.find(item => item.type === 'message');
           const reasoningOutput = response.output.find(item => item.type === 'reasoning');
-          
+
           if (!messageOutput || !messageOutput.content) {
             throw new OpenAIProviderError('No message content in Responses API response', 'NO_RESPONSE_CONTENT');
           }
-          
+
           // Extract content from message output
           const textContent = messageOutput.content.find(item => item.type === 'output_text');
           if (!textContent) {
             throw new OpenAIProviderError('No text content in message output', 'NO_RESPONSE_CONTENT');
           }
           content = textContent.text;
-          
+
           // Extract reasoning summary if available
           if (reasoningOutput && reasoningOutput.summary) {
             const summaryText = reasoningOutput.summary.find(item => item.type === 'summary_text');
@@ -513,17 +513,17 @@ export const openaiProvider = {
         } else {
           throw new OpenAIProviderError('No output in Responses API response', 'NO_RESPONSE_CONTENT');
         }
-        
+
         stopReason = response.status || 'stop';
         usage = response.usage || {};
-        
+
         // Store reasoning summary in metadata
         if (reasoningSummary) {
           usage.reasoning_summary = reasoningSummary;
           debugLog(`[OpenAI] Found reasoning summary: ${reasoningSummary.substring(0, 100)}...`);
         } else {
-          debugLog(`[OpenAI] No reasoning summary found in response`);
-          debugLog(`[OpenAI] Response structure:`, JSON.stringify(response, null, 2).substring(0, 500));
+          debugLog('[OpenAI] No reasoning summary found in response');
+          debugLog('[OpenAI] Response structure:', JSON.stringify(response, null, 2).substring(0, 500));
         }
       } else {
         // Handle Chat Completions API response format
@@ -652,7 +652,7 @@ export const openaiProvider = {
             break;
           }
           if (shouldUseResponsesAPI) {
-            
+
             // Handle Responses API streaming format
             if (chunk.type === 'response.output_text.delta') {
               const content = chunk.delta || '';
@@ -666,14 +666,14 @@ export const openaiProvider = {
               }
             } else if (chunk.type === 'response.reasoning_summary_part.added') {
               // Event 1: reasoning summary part added (usually empty initially)
-              debugLog(`[OpenAI] *** REASONING PART ADDED`);
+              debugLog('[OpenAI] *** REASONING PART ADDED');
             } else if (chunk.type === 'response.reasoning_summary_part.done') {
               // Event 2: reasoning summary part completed with full text
               const summaryText = chunk.part?.text || '';
               if (summaryText) {
                 totalReasoningSummary = summaryText;
                 debugLog(`[OpenAI] *** REASONING PART DONE: "${summaryText.substring(0, 100)}..."`);
-                
+
                 yield {
                   type: 'reasoning_summary',
                   content: totalReasoningSummary,
@@ -686,7 +686,7 @@ export const openaiProvider = {
               if (summaryDelta) {
                 totalReasoningSummary += summaryDelta;
                 debugLog(`[OpenAI] *** REASONING TEXT DELTA: "${summaryDelta}"`);
-                
+
                 yield {
                   type: 'reasoning_summary',
                   content: totalReasoningSummary,
@@ -699,7 +699,7 @@ export const openaiProvider = {
               if (fullSummary) {
                 totalReasoningSummary = fullSummary;
                 debugLog(`[OpenAI] *** REASONING TEXT DONE: "${fullSummary.substring(0, 100)}..."`);
-                
+
                 yield {
                   type: 'reasoning_summary',
                   content: fullSummary,

package/src/providers/openrouter.js

@@ -68,6 +68,19 @@ const SUPPORTED_MODELS = {
     timeout: 300000,
     description: 'Auto-selects the best model for your prompt using NotDiamond routing',
     aliases: ['openrouter auto', 'auto router', 'auto-router', 'openrouter-auto']
+  },
+  'z-ai/glm-4.6': {
+    modelName: 'z-ai/glm-4.6',
+    friendlyName: 'Z.AI GLM 4.6 (via OpenRouter)',
+    contextWindow: 202752,
+    maxOutputTokens: 8192,
+    supportsStreaming: true,
+    supportsImages: false,
+    supportsTemperature: true,
+    supportsWebSearch: false,
+    timeout: 300000,
+    description: 'Z.AI GLM 4.6 with 200K context - improved coding, reasoning, and agent performance',
+    aliases: ['glm-4.6', 'glm4.6', 'glm 4.6', 'z-ai glm', 'z-ai-glm', 'zai-glm']
   }
 };
 

package/src/resources/helpResource.js

@@ -39,10 +39,11 @@ export const helpResourceMetadata = {
 
 /**
  * Handler for reading the help resource
+ * @param {object} config - Configuration object (optional)
  * @returns {object} Resource content
  */
-export async function helpResourceHandler() {
-  const helpContent = generateHelpContent();
+export async function helpResourceHandler(config = null) {
+  const helpContent = generateHelpContent(config);
   const version = getServerVersion();
 
   // Add version information to the help content
@@ -63,4 +64,4 @@ export async function helpResourceHandler() {
  */
 export function listResources() {
   return [helpResourceMetadata];
-}
+}

package/src/router.js

@@ -97,7 +97,7 @@ function validateTool(toolName, tools) {
 async function createDependencies(config, context = {}) {
   try {
     const continuationStore = getContinuationStore();
-    const tools = getTools();
+    const tools = getTools(config);
     const providers = getProviders();
 
     // Initialize async infrastructure
@@ -181,7 +181,7 @@ export async function createRouter(server, config) {
 
     // Initialize dependencies with validation
     const dependencies = await createDependencies(config);
-    const tools = getTools();
+    const tools = getTools(config);
 
     createRouterLogger.info(`Router initialized with ${Object.keys(tools).length} tools`);
 
@@ -307,7 +307,7 @@ export async function createRouter(server, config) {
 
       if (promptName === 'help') {
         const promptArgs = request.params?.arguments || {};
-        const result = await helpPromptHandler(promptArgs);
+        const result = await helpPromptHandler(promptArgs, config);
 
         return {
           description: helpPromptMetadata.description,
@@ -335,7 +335,7 @@ export async function createRouter(server, config) {
       const resourceUri = request.params?.uri;
 
       if (resourceUri === helpResourceMetadata.uri) {
-        return await helpResourceHandler();
+        return await helpResourceHandler(config);
       }
 
       throw new RouterError(
@@ -360,7 +360,7 @@ export async function createRouter(server, config) {
     // Return router interface for testing purposes
     return {
       listTools: async () => {
-        const tools = getTools();
+        const tools = getTools(config);
         return {
           tools: Object.entries(tools).map(([name, tool]) => {
             const toolSchema = {
@@ -553,7 +553,7 @@ export function validateToolArguments(args, schema) {
  */
 export async function getRouterStats(dependencies) {
   try {
-    const tools = getTools();
+    const tools = getTools(dependencies.config);
     const storeStats = await dependencies.continuationStore.getStats();
 
     return {

package/src/tools/cancelJob.js

@@ -97,7 +97,7 @@ export async function cancelJobTool(args, dependencies) {
       // Calculate actual elapsed time from job creation
       const elapsedMs = Date.now() - (updatedJobState?.createdAt || jobState.createdAt || Date.now());
       const elapsedSeconds = elapsedMs / 1000;
-      
+
       // Format elapsed time
       let timeStr;
       if (elapsedSeconds >= 60) {
@@ -110,24 +110,24 @@ export async function cancelJobTool(args, dependencies) {
 
       // Build human-readable response parts
       const parts = [];
-      
+
       // Status line with proper timing
       const statusEmoji = '⛔';
       const startTime = updatedJobState?.createdAt ? new Date(updatedJobState.createdAt).toLocaleString() : 'unknown';
-      
+
       let statusLine = `${statusEmoji} CANCELLED | ${updatedJobState?.tool?.toUpperCase() || jobState.tool?.toUpperCase() || 'UNKNOWN'} | ${continuation_id} | Started: ${startTime} | ${timeStr} elapsed`;
-      
+
       // Add title if available
       if (updatedJobState?.title) {
         statusLine += ` | "${updatedJobState.title}"`;
       }
-      
+
       parts.push(statusLine);
-      
+
       // Add cancellation info
       parts.push(`Cancelled at: ${new Date().toLocaleString()}`);
       parts.push(`Previous status: ${jobState.status}`);
-      
+
       // Add partial results info if available
       if (updatedJobState?.accumulated_content) {
         const preview = updatedJobState.accumulated_content.length > 200
@@ -137,7 +137,7 @@ export async function cancelJobTool(args, dependencies) {
       } else if (updatedJobState?.result) {
         parts.push('Partial results available in job state');
       }
-      
+
       // Add continuation_id for easy reference
       parts.push(`continuation_id: ${continuation_id}`);
 

package/src/tools/chat.js

@@ -741,7 +741,7 @@ async function executeChatWithStreaming(args, dependencies, context) {
       await context.updateJob({
         reasoning_summary: response.metadata.usage.reasoning_summary
       });
-      debugLog(`Chat: Stored reasoning summary`);
+      debugLog('Chat: Stored reasoning summary');
     } catch (error) {
       debugError('Chat: Failed to store reasoning summary', error);
     }
@@ -810,7 +810,7 @@ async function executeChatWithStreaming(args, dependencies, context) {
 }
 
 // Tool metadata
-chatTool.description = 'GENERAL CHAT & COLLABORATIVE THINKING - For development assistance, brainstorming, and code analysis. Supports files, images, and conversation continuation. Use model: "auto" for automatic model selection.';
+chatTool.description = 'GENERAL CHAT & COLLABORATIVE THINKING - Development assistance, brainstorming, code analysis. Supports files, images, continuation_id for multi-turn conversations. Use model: "auto" for automatic selection.';
 chatTool.inputSchema = {
   type: 'object',
   properties: {

package/src/tools/consensus.js

@@ -508,7 +508,7 @@ Please provide your refined response:`;
 
     // Create unified status line (similar to async status display)
     const finalCount = refinedPhase ? refinedPhase.filter(r => r.status === 'success').length : initialPhase.successful.length;
-    const totalCount = models.length;
+    const totalCount = providerCalls.length;
     const statusLine = config.environment?.nodeEnv !== 'test'
       ? `✅ COMPLETED | CONSENSUS | ${continuationId} | ${consensusExecutionTime.toFixed(1)}s elapsed | ${finalCount}/${totalCount} succeeded | ${modelsList}\n`
       : '';
@@ -1336,7 +1336,7 @@ async function executeConsensusPhaseWithStreaming(providerCalls, messages, phase
 }
 
 // Tool metadata
-consensusTool.description = 'PARALLEL CONSENSUS WITH CROSS-MODEL FEEDBACK - Gathers perspectives from multiple AI models simultaneously. Models provide initial responses, then optionally refine based on others\' insights. Returns both phases in a single call. Handles partial failures gracefully. For: complex decisions, architectural choices, technical evaluations. Use models: ["auto"] for automatic model selection.';
+consensusTool.description = 'PARALLEL CONSENSUS WITH CROSS-MODEL FEEDBACK - Query multiple models simultaneously, then optionally refine responses based on cross-feedback. For complex decisions, architectural choices, technical evaluations. Use models: ["auto"] for automatic selection.';
 consensusTool.inputSchema = {
   type: 'object',
   properties: {

package/src/tools/index.js

@@ -24,11 +24,50 @@ const tools = {
 };
 
 /**
- * Get all available tools
+ * Get all available tools, optionally filtered based on configuration
+ * @param {object} config - Configuration object (optional)
  * @returns {object} Map of tool name to tool implementation
  */
-export function getTools() {
-  return tools;
+export function getTools(config = null) {
+  // If no config provided or async tools not disabled, return all tools
+  if (!config || !config.async?.disableAsyncTools) {
+    return tools;
+  }
+
+  // Filter out async-only tools when async is disabled
+  const filteredTools = {};
+  for (const [name, tool] of Object.entries(tools)) {
+    // Exclude check_status and cancel_job tools
+    if (name === 'check_status' || name === 'cancel_job') {
+      continue;
+    }
+
+    // Clone the tool to avoid mutating the original
+    const clonedTool = tool;
+
+    // For chat and consensus tools, remove the 'async' parameter from their schemas
+    if (name === 'chat' || name === 'consensus') {
+      // Create a modified inputSchema without the async parameter
+      const modifiedSchema = {
+        ...tool.inputSchema,
+        properties: { ...tool.inputSchema.properties }
+      };
+      delete modifiedSchema.properties.async;
+
+      // Create a wrapper function with modified metadata
+      const wrappedTool = async function(...args) {
+        return await tool(...args);
+      };
+      wrappedTool.description = tool.description;
+      wrappedTool.inputSchema = modifiedSchema;
+
+      filteredTools[name] = wrappedTool;
+    } else {
+      filteredTools[name] = clonedTool;
+    }
+  }
+
+  return filteredTools;
 }
 
 /**