v1.4.5 - Cleanup & JSON Parsing Fixes Release

Bibble v1.4.5 Release Notes

Released: August 29, 2025

🧹 Cleanup & JSON Parsing Fixes Release

Version 1.4.5 delivers critical stability improvements that eliminate frustrating JSON parsing errors and provide a much cleaner, more professional chat experience. This release focuses on reliability and user experience enhancements.

---

🎯 Key Highlights

✨ No More JSON Parsing Errors!

The most common source of tool call failures has been completely eliminated. Multi-tool calls now work flawlessly without concatenated JSON errors.

🧹 Clean Professional Interface

Debug clutter is gone! Chat sessions now show clean, professional output without development noise.

🔌 Better MCP Server Visibility

All MCP servers now consistently show their connection status at startup, so you always know what tools are available.

---

🔧 Critical Fixes

JSON Parsing Errors - RESOLVED 🛠️

• Fixed: Tool call argument parsing errors caused by concatenated JSON objects
• Problem: Multiple tool calls resulted in malformed JSON like {"path": "..."}{"content": "..."}
• Solution: Implemented proper multi-tool call handling using Map-based tracking by tool call index
• Impact: Tool calls now work reliably with multiple simultaneous operations

Debug Output Cleanup 🧽

• Removed: All [CHAT DEBUG] messages cluttering the terminal
• Removed: [DEBUG] tool argument parsing messages
• Removed: Verbose tool call logging on every execution
• Result: Chat interface now shows clean, professional output

MCP Server Connection Logging 🔌

• Improved: Server connection status messages are now more accurate
• Changed: From "running on stdio" to "connected successfully" for all transport types
• Fixed: All MCP servers now consistently show their startup status
• Benefit: Users can clearly see which tools are available at startup

---

⚡ Performance & Reliability

Enhanced Error Handling

• JSON parsing now gracefully falls back to empty object {} on parse errors
• Improved tool call processing efficiency with better error recovery
• More robust handling of OpenAI streaming with multiple concurrent tool calls

Build System Improvements

• Updated build configuration to include missing zod-to-json-schema external dependency
• Resolved build stability issues for development and production environments

---

🎁 User Experience Improvements

Before v1.4.5:

[CHAT DEBUG] Processing tool call arguments: {...}
[DEBUG] Parsing tool arguments...
Error: Unexpected token '{' in JSON at position 25
Context7 Documentation MCP Server running on stdio
datetime MCP server running on stdio
web-scout MCP server running on stdio  // ❌ Sometimes missing

After v1.4.5:

Context7 Documentation MCP Server connected successfully
DateTime MCP server connected successfully  
web-scout MCP server connected successfully  // ✅ Always shows
MCPollinations MCP server connected successfully

// Clean chat with no debug noise! ✨

---

🔧 Technical Details

JSON Processing Enhancement

• Enhanced processStreamResponse method to track multiple tool calls by index
• Implemented Map-based tool call management for concurrent operations
• Added graceful fallback mechanisms for malformed JSON

Clean Interface Architecture

• Removed development debug output for production-ready experience
• Streamlined logging to focus on user-relevant information
• Maintained detailed error logging for debugging while keeping UI clean

MCP Integration Reliability

• Improved server connection reporting for better user visibility
• Enhanced startup logging consistency across all MCP server types
• Better error messages and status reporting

---

📦 Installation & Upgrade

NPM Installation

npm install -g @pinkpixel/[email protected]

From Source

git pull origin main
npm install
npm run build

Verify Installation

bibble --version  # Should show 1.4.5

---

🎯 Impact Summary

Area	Before	After
Tool Calls	JSON parsing errors, concatenated arguments	Reliable multi-tool execution
Chat Interface	Cluttered with debug output	Clean, professional output
Server Startup	Inconsistent server visibility	All servers show connection status
Error Handling	Crashes on malformed JSON	Graceful fallback and recovery
User Experience	Frustrating debugging noise	Smooth, professional operation

---

🚀 What's Next?

This release provides a solid foundation for the upcoming features in the roadmap:

• Enhanced built-in tools integration
• Advanced security policy management
• Cross-platform compatibility improvements
• Extended LLM provider support

---

🙏 Thank You!

Special thanks to the community for reporting the JSON parsing issues and providing feedback on the MCP server visibility. Your input helps make Bibble better for everyone!

---

📞 Support & Feedback

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Documentation: See README.md and OVERVIEW.md

---

Bibble v1.4.5 - Your personal AI assistant just got more reliable! ✨

Happy chatting!
— The Pink Pixel Team 💖

v1.4.3 - Agent Intelligence & Tool System Improvements

🎯 Agent Intelligence & Tool System Improvements

Version 1.4.3 delivers critical fixes for agent intelligence and task completion reliability, ensuring smoother workflows and proper conversation management.

🔧 Critical Fixes

MCP Tool Result Processing

• FIXED: LLM missing complete tool output data that users could see
• Enhanced McpClient.callTool method to preserve complete MCP result content by combining all content items
• Resolved agent making incorrect tool calls due to incomplete data in conversation context
• Ensures agent sees same comprehensive information as users (e.g., correct library IDs like /tailwindlabs/tailwindcss.com)

Conversation Termination Logic

• FIXED: Premature conversation ending when agent said "I will now..." instead of continuing
• Implemented smart termination detection to distinguish preparation messages from completion signals
• Added contextual awareness to prevent ending on "about to do" messages
• Enhanced conversation flow to continue working when tasks are clearly incomplete

Exit Loop Tools Availability

• FIXED: Missing task completion functionality - agent couldn't properly end conversations
• Restored task_complete and ask_question tools to LLM's available tools list
• Added explicit task completion instructions to system prompt
• Ensured proper conversation ending mechanism through tool calls rather than content parsing

System Prompt Enhancement

• Improved tool selection guidance with generic principles (no hardcoded tool names)
• Enhanced "Tool Priority Guidelines" to favor direct action over workflow management
• Added "TASK COMPLETION" section instructing use of 'task_complete' tool
• Maintained compatibility with user-configured MCP servers

🚀 Key Improvements

Agent Decision Making

• Implemented smarter tool selection principles favoring direct actions over complex workflows
• Added guidance to avoid over-engineering simple tasks with elaborate planning
• Enhanced focus on efficient execution over elaborate planning
• Improved workflow to act decisively once information is gathered

Conversation Flow Control

• Enhanced termination logic with preparation message detection ("I will now", "I am going to")
• Improved completion signal recognition ("task complete", "successfully created")
• Added fallback termination for very short messages after multiple turns
• Maintained proper tool-based conversation ending as primary mechanism

📊 Technical Details

• MCP Integration: Complete MCP result content preservation with proper multi-item handling
• Agent Logic: Smart conversation state detection with contextual message analysis
• Tool Management: Proper exit loop tools integration with LLM tool availability
• System Prompt: Generic, user-agnostic tool selection guidance for maximum compatibility

🎉 Impact

Before: Agent missing tool data, stopping mid-task, unable to complete conversations properly
After: Agent sees complete tool results, continues working as intended, properly signals completion

---

This release significantly improves agent intelligence and task completion reliability, making Bibble more robust and user-friendly for complex workflows!

Installation

npm install -g @pinkpixel/[email protected]

What's Next?

With these critical fixes in place, Bibble now provides a much more reliable agent experience. The agent will:

• ✅ See complete tool output data
• ✅ Continue working when tasks are in progress
• ✅ Properly signal completion when finished
• ✅ Make better tool selection decisions

Full Changelog: https://github.com/pinkpixel-dev/bibble/blob/main/CHANGELOG.md

v1.4.0 - Enhanced Tool Display System & Critical Bug Fixes

🎨 MAJOR UI ENHANCEMENT - Enhanced Tool Calling Display

✨ What's New in v1.4.0

🧰 Enhanced Tool Display System

Revolutionary tool calling interface with Pink Pixel branding:

• Beautiful gradient headers with status badges (Running, Success, Error, Cancelled)
• Boxed parameter sections with magenta borders and JSON syntax highlighting
• Boxed result sections with cyan borders and intelligent content formatting
• Dynamic status updates with timing information (start time, duration)
• Support for progress indicators using Ora spinners during tool execution

🎯 Smart Content Formatting

Intelligent detection and display of different data types:

• Arrays of objects → Beautiful tables with proper column headers and data truncation
• Simple arrays → Clean numbered lists with item formatting
• JSON objects → Syntax-highlighted key-value displays with colored brackets
• URLs → Clickable links with terminal-link integration where supported
• File paths → Green highlighting for easy identification
• Text content → Smart line wrapping and proper indentation

🖼️ Interactive Features

Clipboard integration and keyboard shortcuts:

• Copy tool results to clipboard with c key using clipboardy
• Expand/collapse JSON sections with space key
• Quit detailed view with q key
• Interactive hints footer with keyboard shortcut guidance

🎨 Pink Pixel Brand Integration

Consistent theming throughout tool displays:

• Gradient "Tool Call" banners with fire gradient effect
• Color-coded status badges (cyan for running, green for success, red for errors)
• Pink pixel branded icons and symbols throughout the interface
• Beautiful gradient separators between tool calls

🔧 Critical Bug Fixes

🚨 FIXED: MCP Tools System Prompt Issue

• Resolved critical bug where tools list was generated before MCP servers were loaded
• Fixed Agent constructor to defer system prompt generation until after tool loading
• Updated Agent.initialize() to properly update system prompt with complete tools list
• Enhanced system-prompt command to show actual loaded tools and descriptions
• Models now properly recognize available MCP tools including Context7 documentation tools

🚨 FIXED: Duplicate Tool Display

• Eliminated double tool call rendering
• Fixed Agent stream processing to prevent tool marker emission when enhanced display is active
• Ensured single, beautiful tool display per execution

🚨 FIXED: Object Serialization

• Fixed "[object Object]" display issues
• Ensured tool result content is properly stringified before display processing
• Resolved object-to-string conversion issues in tool result rendering

🔧 Backward Compatibility

Feature flag system for smooth adoption:

• BIBBLE_ENHANCED_TOOLS=true (default) - Enable enhanced tool display
• BIBBLE_ENHANCED_TOOLS=false - Use legacy tool display for compatibility
• BIBBLE_TOOL_DISPLAY_MODE: Set to basic, compact, or full (default)

📦 New Dependencies

Added essential UI enhancement packages:

• cli-highlight for JSON syntax highlighting
• clipboardy for clipboard integration
• json-stringify-pretty-compact for optimal JSON formatting

🎉 Visual Impact

• Before: Basic text output with minimal formatting and duplicate displays
• After: Professional, branded tool interface with boxed sections, syntax highlighting, status badges, and interactive features

This release transforms Bibble's tool calling interface from basic text output into a professional, interactive, and beautifully designed system that showcases tool execution results with Pink Pixel's signature style! ✨

🚀 Upgrade Instructions

npm install -g @pinkpixel/bibble@latest

If you experience any compatibility issues with the new tool display, you can temporarily disable it:

export BIBBLE_ENHANCED_TOOLS=false

v1.3.10 - Cross-Terminal Compatibility & Reliability Update 🚀

🚀 Major Reliability Update - Cross-Terminal Compatibility

This release resolves critical terminal compatibility issues and introduces robust fallback systems that ensure Bibble works consistently across all major terminals.

🎯 Key Fix: Universal Terminal Support

Problem Solved: Bibble previously only worked reliably in Warp terminal, failing with "Connection closed" errors in Windows Terminal, Hyper, and other terminals.

Solution: Multi-tier fallback system with comprehensive environment detection ensures MCP servers start successfully regardless of terminal environment.

✨ New Features

🔧 Environment Resolver System

• Universal executable detection: Cross-platform Node.js, npm, and npx path resolution
• Smart fallbacks: Automatic detection via which, where, and Get-Command
• Comprehensive coverage: Supports Program Files, Homebrew, NVM, Volta, asdf, and more
• Performance optimized: Cached resolution for fast startup

🛡️ Multi-Tier Fallback System

• Primary Strategy: Resolved executable paths with environment enhancement
• Direct Command Fallback: Original command execution without path resolution
• Corepack Fallback: Node.js-based package execution for npm compatibility
• Bundled npm Fallback: Direct Node.js execution for simplified npx functionality

🩺 Enhanced Diagnostic Command

• bibble diagnose: Comprehensive environment troubleshooting
• bibble diagnose --verbose: Detailed system analysis with PATH inspection
• Platform detection: OS, shell, and terminal identification
• Real-time testing: Live npx execution verification

🔄 Graceful Degradation

• Non-blocking failures: Continue operation even if some MCP servers fail
• Connection summaries: Clear reporting of successful vs failed connections
• Fallback notifications: Informative messages when fallback strategies succeed

🛠️ Improvements

🔧 Environment Path Resolution

• Windows compatibility: Fixed .cmd file execution issues
• Enhanced PATH handling: Robust environment variable management
• Actionable error messages: Clear troubleshooting suggestions with references to diagnostic tools

⚡ MCP Server Reliability

• Multi-strategy connections: Prevent single-point failures
• Better error handling: User-friendly messages with specific solutions
• Diagnostic integration: Built-in troubleshooting guidance

🖥️ Terminal Compatibility Matrix

• ✅ Warp Terminal - Fully supported
• ✅ Windows Terminal - Now fully supported
• ✅ Hyper - Now fully supported
• ✅ Command Prompt - Now fully supported
• ✅ PowerShell - Now fully supported
• ✅ Git Bash - Now fully supported
• ✅ Most Unix terminals - Fully supported

📚 Enhanced Documentation

• Comprehensive troubleshooting guide in README.md
• Environment diagnostics documentation
• Common issues and solutions
• Bug reporting guidelines
• Version compatibility information

🔧 Technical Details

• Architecture: New modular environment resolution system
• Cross-Platform: Tested on Windows, macOS, and Linux
• Performance: Cached executable resolution for optimal startup
• Reliability: Multi-tier fallback ensures maximum connectivity

📈 Impact

• Before: Terminal-specific compatibility issues, "Connection closed" errors
• After: Universal compatibility across all major terminals and environments

🚀 Getting Started

# Install the latest version
npm install -g @pinkpixel/bibble@latest

# Run diagnostics if you experience issues
bibble diagnose --verbose

# Start chatting!
bibble

This update makes Bibble accessible to all users regardless of their terminal preference! 🎉

---

Full Changelog: CHANGELOG.md