ihompadmin/tasq
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity
master
tasq/node_modules/agentic-flow/docs/archived/HOTFIX_1.1.7.md

3.7 KiB
Raw Permalink Blame History

Hotfix v1.1.7 - Critical Bug Fix

Issue

v1.1.6 CRITICAL BUG: All agent executions failed with "Claude Code process exited with code 1"

Root Cause: v1.1.6 attempted to spawn external MCP server subprocesses (claude-flow, flow-nexus, agentic-payments) which failed in environments without these packages installed, causing the entire execution to fail.

Fix

v1.1.7 makes external MCP servers optional and disabled by default:

  • ✅ Default behavior: Only uses in-SDK MCP server (6 basic tools)
  • ✅ No subprocess failures: Won't try to spawn unavailable packages
  • ✅ Backward compatible: Works like v1.1.5 by default
  • ✅ Optional advanced features: Can enable via environment variables

Changes

Before (v1.1.6 - BROKEN)

// Always tried to spawn these subprocesses (FAILED if not installed)
mcpServers: {
  'claude-flow-sdk': claudeFlowSdkServer,
  'claude-flow': { command: 'npx', args: ['claude-flow@alpha', ...] },
  'flow-nexus': { command: 'npx', args: ['flow-nexus@latest', ...] },
  'agentic-payments': { command: 'npx', args: ['agentic-payments', ...] }
}

After (v1.1.7 - FIXED)

// Only uses in-SDK server by default (WORKS everywhere)
const mcpServers: any = {
  'claude-flow-sdk': claudeFlowSdkServer  // Always enabled (in-SDK)
};

// Optional: Enable advanced MCP servers only if explicitly requested
if (process.env.ENABLE_CLAUDE_FLOW_MCP === 'true') {
  mcpServers['claude-flow'] = {...};  // 101 advanced tools
}
// ... etc

Usage

Default (Recommended)

# Works out of the box - no extra packages needed
npx agentic-flow@1.1.7 --agent coder --task "Create function" --provider gemini

With Advanced MCP Tools (Optional)

# Enable all external MCP servers
export ENABLE_CLAUDE_FLOW_MCP=true
export ENABLE_FLOW_NEXUS_MCP=true
export ENABLE_AGENTIC_PAYMENTS_MCP=true

npx agentic-flow@1.1.7 --agent coder --task "..."

Migration

From v1.1.5

# v1.1.7 works exactly like v1.1.5 by default
npm uninstall -g agentic-flow
npm install -g agentic-flow@1.1.7

From v1.1.6

# v1.1.7 fixes the critical bug
npm uninstall -g agentic-flow
npm install -g agentic-flow@1.1.7

Test Results

v1.1.6 (Broken)

❌ coder agent + gemini: FAILED (exit code 1)
❌ researcher agent + gemini: FAILED (exit code 1)

v1.1.7 (Fixed)

✅ coder agent + gemini: WORKS
✅ researcher agent + gemini: WORKS
✅ All providers: WORKS
✅ All agents: WORKS

Available MCP Tools

Default (In-SDK - Always Available)

  • Memory management (6 tools)
  • Basic swarm coordination

Optional (Requires ENABLE_*_MCP=true)

  • claude-flow: 101 advanced tools (neural, GitHub, analysis)
  • flow-nexus: 96 cloud tools (sandboxes, cloud swarms)
  • agentic-payments: Payment authorization tools

Backward Compatibility

Version MCP Servers Works? Notes
v1.1.5 None (direct API) ✅ Yes Stable baseline
v1.1.6 All enabled (forced) ❌ BROKEN Subprocess failures
v1.1.7 In-SDK only (default) ✅ FIXED Like v1.1.5 + SDK

Recommendations

  1. Immediate upgrade from v1.1.6: Required - v1.1.6 is broken
  2. Upgrade from v1.1.5: Optional - v1.1.7 adds Claude Agent SDK benefits
  3. Enable advanced MCP: Only if you need the 111 extra tools

Related

  • Bug Report: See detailed analysis in bug report document
  • Issue: Critical execution failure in v1.1.6
  • Status: ✅ RESOLVED in v1.1.7
  • Severity: 🔴 CRITICAL → ✅ FIXED

Version: 1.1.7 Release Date: 2025-10-05 Type: Hotfix Priority: Critical Status: ✅ Production Ready