converse-mcp-server 2.29.2 → 3.0.1

package/src/prompts/helpPrompt.js

@@ -17,17 +17,12 @@ const SAMPLE_VALUES = {
   prompt: 'Explain the authentication flow in this codebase',
   files: ['src/auth.js'],
   images: ['./diagram.png'],
-  model: 'auto',
   models: ['codex', 'gemini', 'claude'],
+  mode: 'consensus',
   continuation_id: 'conv_abc123',
-  temperature: 0.5,
   reasoning_effort: 'medium',
-  verbosity: 'medium',
-  use_websearch: false,
   async: false,
   export: false,
-  enable_cross_feedback: true,
-  cross_feedback_prompt: null,
   full_history: false,
 };
 
@@ -122,24 +117,37 @@ function generateToolExamplesFromSchema(toolName, inputSchema) {
     }
   }
 
-  // For chat and consensus, add some optional parameters for richer examples
+  // For the chat tool, show one example per mode for richer documentation.
   if (toolName === 'chat') {
-    // Add commonly used optional parameters
-    if (properties.model) example.model = SAMPLE_VALUES.model;
-    if (properties.files) example.files = SAMPLE_VALUES.files;
-    if (properties.temperature) example.temperature = SAMPLE_VALUES.temperature;
-  } else if (toolName === 'consensus') {
-    // Add commonly used optional parameters
-    if (properties.files) example.files = SAMPLE_VALUES.files;
-    if (properties.enable_cross_feedback)
-      example.enable_cross_feedback = SAMPLE_VALUES.enable_cross_feedback;
-    if (properties.temperature) example.temperature = 0.2; // Lower for consensus
-  } else if (toolName === 'check_status') {
-    // For check_status, just show the continuation_id
-    if (properties.continuation_id)
-      example.continuation_id = SAMPLE_VALUES.continuation_id;
-  } else if (toolName === 'cancel_job') {
-    // For cancel_job, just show the continuation_id
+    const chatExample = { prompt: SAMPLE_VALUES.prompt, models: ['auto'] };
+    if (properties.files) chatExample.files = SAMPLE_VALUES.files;
+    const consensusExample = {
+      prompt: SAMPLE_VALUES.prompt,
+      models: SAMPLE_VALUES.models,
+      mode: 'consensus',
+    };
+    const roundtableExample = {
+      prompt: SAMPLE_VALUES.prompt,
+      models: SAMPLE_VALUES.models,
+      mode: 'roundtable',
+    };
+    return [
+      '```json',
+      '// mode "chat" (default) — independent parallel answers',
+      JSON.stringify(chatExample, null, 2),
+      '```',
+      '```json',
+      '// mode "consensus" — ≥2 models answer, then refine',
+      JSON.stringify(consensusExample, null, 2),
+      '```',
+      '```json',
+      '// mode "roundtable" — sequential turn-based dialogue',
+      JSON.stringify(roundtableExample, null, 2),
+      '```',
+    ].join('\n');
+  }
+
+  if (toolName === 'check_status' || toolName === 'cancel_job') {
     if (properties.continuation_id)
       example.continuation_id = SAMPLE_VALUES.continuation_id;
   }
@@ -271,19 +279,12 @@ function generateConfigurationTips(tools) {
   // Get chat tool schema for parameter info
   const chatSchema = tools.chat?.inputSchema?.properties || {};
 
-  // Temperature Settings
-  if (chatSchema.temperature) {
-    const tempSchema = chatSchema.temperature;
-    output += '### Temperature Settings\n';
-    if (tempSchema.minimum !== undefined && tempSchema.maximum !== undefined) {
-      output += `Range: ${tempSchema.minimum} to ${tempSchema.maximum}\n`;
-    }
-    output += '- **0.0-0.3**: Factual, deterministic responses\n';
-    output += '- **0.4-0.7**: Balanced creativity and accuracy (recommended)\n';
-    output += '- **0.8-1.2**: Creative writing, brainstorming\n';
-    if (tempSchema.maximum && tempSchema.maximum > 1.2) {
-      output += `- **1.3-${tempSchema.maximum}**: Highly experimental, unpredictable\n`;
-    }
+  // Modes
+  if (chatSchema.mode) {
+    output += '### Modes\n';
+    output += '- **chat** (default): 1..N models answer independently in parallel\n';
+    output += '- **consensus**: ≥2 models answer, then refine after seeing each other\n';
+    output += '- **roundtable**: models answer sequentially in the given order, each building on the transcript\n';
     output += '\n';
   }
 
@@ -307,23 +308,6 @@ function generateConfigurationTips(tools) {
     output += '\n';
   }
 
-  // Verbosity
-  if (chatSchema.verbosity) {
-    const verbSchema = chatSchema.verbosity;
-    output += '### Verbosity (for GPT-5 models)\n';
-    if (verbSchema.enum) {
-      const descriptions = {
-        low: 'Concise answers',
-        medium: 'Balanced detail (default)',
-        high: 'Thorough explanations',
-      };
-      for (const value of verbSchema.enum) {
-        output += `- **${value}**: ${descriptions[value] || value}\n`;
-      }
-    }
-    output += '\n';
-  }
-
   // File Context
   output += '### File Context\n';
   output +=
@@ -391,7 +375,6 @@ export function generateHelpContent(config = null) {
       const features = [];
       if (config.supportsStreaming) features.push('Streaming');
       if (config.supportsImages) features.push('Images');
-      if (config.supportsTemperature) features.push('Temperature');
       if (config.supportsWebSearch) features.push('Web Search');
       if (config.supportsThinking) features.push('Thinking Mode');
       if (config.supportsResponsesAPI) features.push('Responses API');
@@ -475,15 +458,15 @@ ${generateConfigurationTips(tools)}
    - Specify models when you need specific capabilities
    - Consider cost vs performance tradeoffs
 
-2. **Consensus Tool**
-   - Mix different model types for diverse perspectives
-   - Enable cross-feedback for refined responses
-   - Use lower temperature for more consistent consensus
+2. **Choosing a Mode**
+   - Use **chat** for a single answer or independent parallel answers
+   - Use **consensus** to have ≥2 models cross-check and refine each other
+   - Use **roundtable** for a sequential discussion where each model builds on the last
 
 3. **Context Management**
    - Include only relevant files to avoid token limits
    - Use descriptive prompts to guide model focus
-   - Leverage continuation IDs for multi-turn conversations
+   - Leverage continuation IDs for multi-turn conversations (you may switch modes on resume)
 
 4. **Error Handling**
    - Check for API key configuration if providers fail
@@ -505,8 +488,7 @@ These providers use local CLI tools and don't require API keys:
 ## Need More Help?
 
 - Check the documentation at: https://github.com/FallDownTheSystem/converse
-- Report issues at: https://github.com/FallDownTheSystem/converse/issues
-- View examples in the \`/examples\` directory`;
+- Report issues at: https://github.com/FallDownTheSystem/converse/issues`;
 
   return helpContent;
 }

package/src/providers/anthropic.js

@@ -20,7 +20,6 @@ const SUPPORTED_MODELS = {
     maxOutputTokens: 128000,
     supportsStreaming: true,
     supportsImages: true,
-    supportsTemperature: false, // Fable 5 rejects temperature/top_p/top_k (400)
     supportsWebSearch: false,
     supportsThinking: true,
     supportsAdaptiveThinking: true, // Adaptive thinking is the only thinking mode
@@ -46,7 +45,6 @@ const SUPPORTED_MODELS = {
     maxOutputTokens: 128000,
     supportsStreaming: true,
     supportsImages: true,
-    supportsTemperature: true,
     supportsWebSearch: false,
     supportsThinking: true,
     supportsAdaptiveThinking: true,
@@ -79,7 +77,6 @@ const SUPPORTED_MODELS = {
     maxOutputTokens: 128000,
     supportsStreaming: true,
     supportsImages: true,
-    supportsTemperature: true,
     supportsWebSearch: false,
     supportsThinking: true,
     supportsAdaptiveThinking: true,
@@ -110,7 +107,6 @@ const SUPPORTED_MODELS = {
     maxOutputTokens: 128000,
     supportsStreaming: true,
     supportsImages: true,
-    supportsTemperature: true,
     supportsWebSearch: false,
     supportsThinking: true,
     supportsAdaptiveThinking: true,
@@ -141,7 +137,6 @@ const SUPPORTED_MODELS = {
     maxOutputTokens: 64000,
     supportsStreaming: true,
     supportsImages: true,
-    supportsTemperature: true,
     supportsWebSearch: false,
     supportsThinking: true,
     minThinkingTokens: 1024,
@@ -168,7 +163,6 @@ const SUPPORTED_MODELS = {
     maxOutputTokens: 32000,
     supportsStreaming: true,
     supportsImages: true,
-    supportsTemperature: true,
     supportsWebSearch: false,
     supportsThinking: true,
     minThinkingTokens: 1024,
@@ -197,7 +191,6 @@ const SUPPORTED_MODELS = {
     maxOutputTokens: 64000,
     supportsStreaming: true,
     supportsImages: true,
-    supportsTemperature: true,
     supportsWebSearch: false,
     supportsThinking: true,
     supportsAdaptiveThinking: true, // Sonnet 4.6: thinking: {type: "adaptive"} recommended
@@ -230,7 +223,6 @@ const SUPPORTED_MODELS = {
     maxOutputTokens: 64000,
     supportsStreaming: true,
     supportsImages: true,
-    supportsTemperature: true,
     supportsWebSearch: false,
     supportsThinking: true,
     minThinkingTokens: 1024,
@@ -255,7 +247,6 @@ const SUPPORTED_MODELS = {
     maxOutputTokens: 64000,
     supportsStreaming: true,
     supportsImages: true,
-    supportsTemperature: true,
     supportsWebSearch: false,
     supportsThinking: true,
     minThinkingTokens: 1024,
@@ -550,14 +541,9 @@ export const anthropicProvider = {
   async invoke(messages, options = {}) {
     const {
       model = 'claude-3-5-sonnet-20241022',
-      temperature = 0.7,
       maxTokens = null,
       stream = false,
       reasoning_effort = 'medium',
-      // eslint-disable-next-line no-unused-vars
-      use_websearch = false, // Not supported by Anthropic, ignored
-      // eslint-disable-next-line no-unused-vars
-      verbosity = 'medium', // OpenAI-specific parameter, ignored by Anthropic
       config,
       // Note: We don't use ...otherOptions because it can include non-API parameters
       // like continuationStore that cause "Extra inputs are not permitted" errors
@@ -704,22 +690,6 @@ export const anthropicProvider = {
       }
     }
 
-    // Add temperature if specified and the model accepts it
-    // (Fable 5 removed sampling parameters entirely - sending them returns 400)
-    // When legacy thinking (type: "enabled") is active, temperature must be 1
-    // Adaptive thinking (type: "adaptive") does not have this constraint
-    if (temperature !== undefined && modelConfig.supportsTemperature !== false) {
-      if (
-        requestPayload.thinking &&
-        requestPayload.thinking.type === 'enabled'
-      ) {
-        requestPayload.temperature = 1;
-        debugLog('[Anthropic] Temperature forced to 1 for legacy thinking mode');
-      } else {
-        requestPayload.temperature = Math.max(0, Math.min(1, temperature));
-      }
-    }
-
     // Add effort parameter for models that support it (uses output_config)
     if (modelConfig.supportsEffort && reasoning_effort) {
       const effortValue = EFFORT_MAP[reasoning_effort];
@@ -764,7 +734,6 @@ export const anthropicProvider = {
             model: requestPayload.model,
             max_tokens: requestPayload.max_tokens,
             thinking: requestPayload.thinking,
-            temperature: requestPayload.temperature,
             output_config: requestPayload.output_config,
             betas: requestPayload.betas,
             message_count: requestPayload.messages?.length,

package/src/providers/claude.js

@@ -28,7 +28,6 @@ const SUPPORTED_MODELS = {
     maxOutputTokens: 128000,
     supportsStreaming: true,
     supportsImages: true, // Supported via streaming input mode
-    supportsTemperature: false, // SDK manages temperature internally
     supportsWebSearch: false, // SDK accesses files directly, not web
     timeout: 600000, // 10 minutes
     description:
@@ -50,7 +49,6 @@ const SUPPORTED_MODELS = {
     maxOutputTokens: 128000,
     supportsStreaming: true,
     supportsImages: true, // Supported via streaming input mode
-    supportsTemperature: false, // SDK manages temperature internally
     supportsWebSearch: false, // SDK accesses files directly, not web
     timeout: 600000, // 10 minutes
     description:
@@ -451,8 +449,6 @@ export const claudeProvider = {
       stream = false,
       signal,
       reasoning_effort,
-      temperature,
-      use_websearch,
     } = options;
 
     // Validate configuration
@@ -464,16 +460,6 @@ export const claudeProvider = {
     }
 
     // Log unsupported parameters at debug level
-    if (temperature !== undefined) {
-      debugLog(
-        '[Claude SDK] Parameter "temperature" not supported by Claude SDK (ignored)',
-      );
-    }
-    if (use_websearch) {
-      debugLog(
-        '[Claude SDK] Parameter "use_websearch" not supported by Claude SDK (ignored)',
-      );
-    }
     if (reasoning_effort !== undefined) {
       debugLog(
         '[Claude SDK] Parameter "reasoning_effort" not supported by Claude SDK (ignored)',

package/src/providers/codex.js

@@ -26,7 +26,6 @@ const SUPPORTED_MODELS = {
     maxOutputTokens: 128000,
     supportsStreaming: true,
     supportsImages: true, // Codex SDK 0.118+ supports images via --image (local_image input)
-    supportsTemperature: false, // Codex manages temperature internally
     supportsWebSearch: false, // Codex accesses files directly, not web
     timeout: 600000, // 10 minutes
     description:
@@ -104,7 +103,7 @@ async function getCodexSDK() {
  * passes local_image paths to the CLI via --image.
  *
  * Images must be on-disk files — Converse stores the original path in
- * metadata.path (chat.js / consensus.js set includeMetadata: true). Images
+ * metadata.path (chat.js sets includeMetadata: true). Images
  * without a path (e.g. pasted base64 with no metadata) are skipped.
  */
 function convertMessagesToCodexInput(messages) {
@@ -192,13 +191,20 @@ function extractPromptText(input) {
 }
 
 /**
- * Get thread ID from continuation metadata
- * Codex thread IDs are stored in continuation store for resumption
+ * Get thread ID from continuation metadata.
+ * Codex thread IDs are stored per call-plan in `providerThreads`, keyed by a
+ * stable `threadKey` (the requested model spec, e.g. "auto" or "codex") passed
+ * through provider options — NOT the resolved provider/model, so an "auto" spec
+ * that resolves to Codex still finds its thread on the next turn.
  */
-async function getThreadIdFromContinuation(continuationId, continuationStore) {
+async function getThreadIdFromContinuation(
+  continuationId,
+  continuationStore,
+  threadKey,
+) {
   try {
     const state = await continuationStore.get(continuationId);
-    return state?.codexThreadId || null;
+    return state?.providerThreads?.[threadKey] || null;
   } catch (error) {
     debugError('[Codex] Failed to retrieve continuation state', error);
     return null;
@@ -267,9 +273,8 @@ export const codexProvider = {
       signal,
       continuation_id,
       continuationStore,
+      threadKey,
       reasoning_effort,
-      temperature,
-      use_websearch,
     } = options;
 
     // Validate configuration
@@ -280,18 +285,6 @@ export const codexProvider = {
       );
     }
 
-    // Log unsupported parameters at debug level
-    if (temperature !== undefined) {
-      debugLog(
-        '[Codex] Parameter "temperature" not supported by Codex (ignored)',
-      );
-    }
-    if (use_websearch) {
-      debugLog(
-        '[Codex] Parameter "use_websearch" not supported by Codex (ignored)',
-      );
-    }
-
     try {
       // Get Codex SDK
       const Codex = await getCodexSDK();
@@ -302,10 +295,11 @@ export const codexProvider = {
 
       // Get thread ID if resuming conversation
       const threadId =
-        continuation_id && continuationStore
+        continuation_id && continuationStore && threadKey
           ? await getThreadIdFromContinuation(
             continuation_id,
             continuationStore,
+            threadKey,
           )
           : null;