@link-assistant/hive-mind 1.9.2 → 1.10.1

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @link-assistant/hive-mind
 
+## 1.10.1
+
+### Patch Changes
+
+- 24e70f8: Fix agent --verbose output by properly handling stderr stream
+  - Agent CLI sends ALL output (including verbose logs and structured events) to stderr, not stdout
+  - Previous code only processed stdout with JSON parsing, treating stderr as plain error text
+  - Now stderr is processed the same way as stdout: NDJSON line-by-line parsing with JSON formatting
+  - Session IDs are now correctly extracted from stderr messages
+  - stderr output is now collected for error detection
+
+  Fixes #1151
+
+## 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.1",
   "description": "AI-powered issue solver and hive mind for collaborative problem solving",
   "main": "src/hive.mjs",
   "type": "module",

package/src/agent.lib.mjs

@@ -440,7 +440,27 @@ export const executeAgentCommand = async params => {
         if (chunk.type === 'stderr') {
           const errorOutput = chunk.data.toString();
           if (errorOutput) {
-            await log(errorOutput, { stream: 'stderr' });
+            // Agent sends all output (including verbose logs and structured events) to stderr
+            // Process each line as NDJSON, same as stdout handling
+            const stderrLines = errorOutput.split('\n');
+            for (const stderrLine of stderrLines) {
+              if (!stderrLine.trim()) continue;
+              try {
+                const stderrData = JSON.parse(stderrLine);
+                // Output formatted JSON (same formatting as stdout)
+                await log(JSON.stringify(stderrData, null, 2));
+                // Capture session ID from stderr too (agent sends it via stderr)
+                if (!sessionId && stderrData.sessionID) {
+                  sessionId = stderrData.sessionID;
+                  await log(`📌 Session ID: ${sessionId}`);
+                }
+              } catch {
+                // Not JSON - log as plain text
+                await log(stderrLine);
+              }
+            }
+            // Also collect stderr for error detection
+            fullOutput += errorOutput;
           }
         } else if (chunk.type === 'exit') {
           exitCode = chunk.code;

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