@link-assistant/hive-mind 1.9.2 → 1.10.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @link-assistant/hive-mind
 
+## 1.10.0
+
+### Minor Changes
+
+- 9b56b26: feat(solve): configure MCP_TIMEOUT and MCP_TOOL_TIMEOUT for claude tool calls
+
+  Added MCP timeout configuration to prevent tool calls from hanging indefinitely:
+  - Added `mcpTimeout` config (default: 900000ms / 15 minutes) for MCP server startup
+  - Added `mcpToolTimeout` config (default: 900000ms / 15 minutes) for MCP tool execution
+  - Support for override via `MCP_TIMEOUT`/`HIVE_MIND_MCP_TIMEOUT` and `MCP_TOOL_TIMEOUT`/`HIVE_MIND_MCP_TOOL_TIMEOUT` environment variables
+  - Updated `getClaudeEnv()` to pass both timeout values to Claude CLI
+  - Added verbose logging for MCP timeout values
+
+  Fixes #1066
+
 ## 1.9.2
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/hive-mind",
-  "version": "1.9.2",
+  "version": "1.10.0",
   "description": "AI-powered issue solver and hive mind for collaborative problem solving",
   "main": "src/hive.mjs",
   "type": "module",

package/src/claude.lib.mjs

@@ -881,9 +881,12 @@ export const executeClaudeCommand = async params => {
       // See issue #1146 for details on thinking budget translation
       const { thinkingBudget: resolvedThinkingBudget, thinkLevel, isNewVersion } = await resolveThinkingSettings(argv, log);
 
-      // Set CLAUDE_CODE_MAX_OUTPUT_TOKENS (see issue #1076) and optionally MAX_THINKING_TOKENS (see issue #1146)
+      // Set CLAUDE_CODE_MAX_OUTPUT_TOKENS (see issue #1076), MAX_THINKING_TOKENS (see issue #1146),
+      // and MCP timeout configurations (see issue #1066)
       const claudeEnv = getClaudeEnv({ thinkingBudget: resolvedThinkingBudget });
       if (argv.verbose) await log(`📊 CLAUDE_CODE_MAX_OUTPUT_TOKENS: ${claudeCode.maxOutputTokens}`, { verbose: true });
+      if (argv.verbose) await log(`📊 MCP_TIMEOUT: ${claudeCode.mcpTimeout}ms (server startup)`, { verbose: true });
+      if (argv.verbose) await log(`📊 MCP_TOOL_TIMEOUT: ${claudeCode.mcpToolTimeout}ms (tool execution)`, { verbose: true });
       if (resolvedThinkingBudget !== undefined) {
         await log(`📊 MAX_THINKING_TOKENS: ${resolvedThinkingBudget}`, { verbose: true });
       }

package/src/config.lib.mjs

@@ -90,6 +90,15 @@ export const claudeCode = {
   // Default: 64000 (matches Claude Sonnet/Opus/Haiku 4.5 model capabilities)
   // Set via CLAUDE_CODE_MAX_OUTPUT_TOKENS or HIVE_MIND_CLAUDE_CODE_MAX_OUTPUT_TOKENS
   maxOutputTokens: parseIntWithDefault('CLAUDE_CODE_MAX_OUTPUT_TOKENS', parseIntWithDefault('HIVE_MIND_CLAUDE_CODE_MAX_OUTPUT_TOKENS', 64000)),
+  // MCP (Model Context Protocol) timeout configurations
+  // See: https://github.com/link-assistant/hive-mind/issues/1066
+  // See: https://code.claude.com/docs/en/settings#environment-variables
+  // MCP_TIMEOUT: Timeout in milliseconds for MCP server startup
+  // MCP_TOOL_TIMEOUT: Timeout in milliseconds for MCP tool execution
+  // Default: 900000ms (15 minutes) to accommodate long-running Playwright operations
+  // Set via MCP_TIMEOUT/MCP_TOOL_TIMEOUT or HIVE_MIND_MCP_TIMEOUT/HIVE_MIND_MCP_TOOL_TIMEOUT
+  mcpTimeout: parseIntWithDefault('MCP_TIMEOUT', parseIntWithDefault('HIVE_MIND_MCP_TIMEOUT', 900000)),
+  mcpToolTimeout: parseIntWithDefault('MCP_TOOL_TIMEOUT', parseIntWithDefault('HIVE_MIND_MCP_TOOL_TIMEOUT', 900000)),
 };
 
 // Default max thinking budget for Claude Code (see issue #1146)
@@ -156,8 +165,18 @@ export const supportsThinkingBudget = (version, minVersion = '2.1.12') => {
 
 // Helper function to get Claude CLI environment with CLAUDE_CODE_MAX_OUTPUT_TOKENS set
 // Optionally sets MAX_THINKING_TOKENS when thinkingBudget is provided (see issue #1146)
+// Also sets MCP_TIMEOUT and MCP_TOOL_TIMEOUT for MCP tool execution (see issue #1066)
 export const getClaudeEnv = (options = {}) => {
-  const env = { ...process.env, CLAUDE_CODE_MAX_OUTPUT_TOKENS: String(claudeCode.maxOutputTokens) };
+  const env = {
+    ...process.env,
+    CLAUDE_CODE_MAX_OUTPUT_TOKENS: String(claudeCode.maxOutputTokens),
+    // MCP timeout configurations to prevent tool calls from hanging indefinitely
+    // See: https://github.com/link-assistant/hive-mind/issues/1066
+    // MCP_TIMEOUT: Timeout for MCP server startup
+    // MCP_TOOL_TIMEOUT: Timeout for MCP tool execution (the one that prevents stuck tools)
+    MCP_TIMEOUT: String(claudeCode.mcpTimeout),
+    MCP_TOOL_TIMEOUT: String(claudeCode.mcpToolTimeout),
+  };
   // Set MAX_THINKING_TOKENS if thinkingBudget is provided
   // This controls Claude Code's extended thinking feature (Claude Code >= 2.1.12)
   // Default is 31999, set to 0 to disable thinking, max is 63999 for 64K output models