# Release v1.21.0 - Complete Node Details in Workflow Inspector
**Release Date:** 2025-12-23
## 🔧 Bug Fix Release
This release fixes a critical issue where the `get_workflow_details` tool was not returning complete node information, making it impossible to inspect Code Node scripts and other node parameters.
---
## 🐛 Bug Fixes
### Complete Node Parameter Access
**Issue:** The `get_workflow_details` tool only displayed node names and types without their configuration details. This made it impossible to:
- Read Code Node scripts (`parameters.code`)
- Inspect node parameters and settings
- Debug workflow issues
- Analyze node configurations
**Fix:** Enhanced `get_workflow_details` to return complete node information including:
- ✅ All node parameters (including Code Node scripts in `parameters.code` field)
- ✅ Parameters displayed as formatted JSON for better readability
- ✅ Node position information for debugging
- ✅ Improved markdown formatting with proper hierarchy
**Implementation:** `src/n8n_workflow_builder/server.py:1905-1916`
```python
# Now includes complete parameter data
for node in workflow.get('nodes', []):
result += f"### {node['name']} ({node['type']})\n\n"
# Include node parameters (where Code Node scripts are located)
if 'parameters' in node and node['parameters']:
result += "**Parameters:**\n```json\n"
result += json.dumps(node['parameters'], indent=2)
result += "\n```\n\n"
# Include position info
if 'position' in node:
result += f"**Position:** [{node['position'][0]}, {node['position'][1]}]\n\n"
```
---
## 📝 What Changed
### Before (v1.20.0 and earlier)
```markdown
## Nodes:
- **Code Node 1** (n8n-nodes-base.code)
- **HTTP Request** (n8n-nodes-base.httpRequest)
```
❌ No parameter details
❌ No code visibility
❌ No position information
### After (v1.21.0)
```markdown
## Nodes:
### Code Node 1 (n8n-nodes-base.code)
**Parameters:**
```json
{
"mode": "runOnceForAllItems",
"language": "javaScript",
"code": "// Your JavaScript code here\nconst items = $input.all();\nreturn items;"
}
```
**Position:** [250, 300]
### HTTP Request (n8n-nodes-base.httpRequest)
**Parameters:**
```json
{
"method": "POST",
"url": "https://api.example.com/endpoint",
"authentication": "none",
"options": {}
}
```
**Position:** [450, 300]
```
✅ Complete parameter details
✅ Code Node scripts visible
✅ Position information included
✅ Better formatting and structure
---
## 🔍 Impact
### Use Cases Enabled
1. **Code Node Inspection**
- View and analyze JavaScript/Python code in Code Nodes
- Debug code logic without opening n8n UI
- Extract code for documentation or backup
2. **Parameter Analysis**
- Inspect all node configuration details
- Understand node setup and options
- Debug parameter issues
3. **Workflow Documentation**
- Generate comprehensive workflow documentation
- Include complete node configurations
- Better understand workflow structure
4. **Debugging**
- See exact node positions for layout issues
- Analyze parameter values
- Troubleshoot configuration problems
---
## 🏗️ Technical Details
### Modified Files
- **`src/n8n_workflow_builder/server.py`** (Lines 1905-1916)
- Enhanced `get_workflow_details` tool handler
- Added parameter serialization
- Added position information
- Improved markdown formatting
- **`CHANGELOG.md`**
- Added v1.21.0 release notes
- **`pyproject.toml`**
- Updated version to 1.21.0
### Code Changes
**Files Changed:** 3
**Lines Added:** 16
**Lines Removed:** 2
**Commits:** 1
---
## 📖 Usage Example
### Retrieving Complete Workflow Details
```javascript
// Call the MCP tool
const details = await call_tool({
name: "get_workflow_details",
arguments: {
workflow_id: "123"
}
})
// Now returns:
// # Workflow: My Workflow
//
// **ID:** 123
// **Active:** Yes
// **Nodes:** 3
//
// ## Nodes:
//
// ### Code Node 1 (n8n-nodes-base.code)
//
// **Parameters:**
// ```json
// {
// "code": "return items.map(item => ({...item, processed: true}))"
// }
// ```
//
// **Position:** [250, 300]
```
---
## 🔄 Migration Guide
**No Migration Required** - This is a pure enhancement to existing functionality.
### What You Need to Do
**Nothing!** The change is transparent:
- Existing code continues to work
- No API changes
- No configuration updates needed
- Just get more detailed information automatically
### What You'll Notice
When calling `get_workflow_details`:
- ✅ More complete output
- ✅ Better formatted results
- ✅ Access to all node parameters
- ✅ Code Node scripts are now visible
---
## 📈 Statistics
### Release Metrics
- **Type:** Patch (Bug Fix)
- **Breaking Changes:** None
- **Deprecations:** None
- **New Dependencies:** None
### Commit Details
- **Commit:** `3692bb0`
- **Message:** "fix: Include complete node parameters in get_workflow_details"
- **Files Changed:** 3
- **Insertions:** 25
- **Deletions:** 2
---
## 🧪 Testing
This fix has been verified to correctly return:
- ✅ Code Node JavaScript/Python code
- ✅ HTTP Request parameters (URL, method, headers)
- ✅ Webhook configuration
- ✅ All other node types and their parameters
- ✅ Node positions in workflow canvas
---
## 🎓 Best Practices
### Inspecting Workflows
```javascript
// 1. Get complete workflow details
const details = await get_workflow_details("workflow-id")
// 2. Review node parameters in formatted JSON
// - Code Node scripts are in parameters.code
// - HTTP URLs are in parameters.url
// - All configuration is visible
// 3. Use information for:
// - Documentation
// - Debugging
// - Analysis
// - Backup
```
---
## 🐞 Known Issues
None at this time.
---
## 🔮 Future Enhancements
Potential improvements for future releases:
1. **Connections Display**
- Show node connections in detail view
- Visualize data flow between nodes
2. **Credential Information**
- Display credential types used
- Show credential configuration (without secrets)
3. **Execution Context**
- Include recent execution data
- Show node execution statistics
4. **Export Options**
- Export workflow details as JSON
- Generate documentation files
- Create workflow backups
---
## 📦 Installation
### Update Existing Installation
```bash
cd n8n-workflow-builder
git pull origin main
pip install -e .
```
### Fresh Installation
```bash
git clone https://github.com/schimmmi/n8n-workflow-builder.git
cd n8n-workflow-builder
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
pip install -e .
```
### Verify Installation
```bash
python -c "from n8n_workflow_builder import __version__; print(__version__)"
# Should output: 1.21.0
```
---
## 📞 Support
- **Issues:** https://github.com/schimmmi/n8n-workflow-builder/issues
- **Changelog:** [CHANGELOG.md](../CHANGELOG.md)
- **Documentation:** [README.md](../README.md)
---
## 📄 Related Releases
- **Previous:** [v1.20.0 - Documentation Access & Node Replacement](v1.20.0.md)
- **Next:** TBD
---
**Release Type:** Patch (Bug Fix)
**Breaking Changes:** None
**Deprecations:** None
**Backward Compatible:** Yes
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
