@juspay/neurolink/CHANGELOG.md

Universal AI Development Platform with working MCP integration, multi-provider support, and professional CLI. Built-in tools operational, 58+ external MCP servers discoverable. Connect to filesystem, GitHub, database operations, and more. Build, test, and

## [7.3.8](https://github.com/juspay/neurolink/compare/v7.3.7...v7.3.8) (2025-08-05)


### Bug Fixes

* **lint:** improve linting ([580130a](https://github.com/juspay/neurolink/commit/580130aa33700b67f9d99de60dbe3d0c7415adfc))

## [7.3.7](https://github.com/juspay/neurolink/compare/v7.3.6...v7.3.7) (2025-08-04)

### Bug Fixes

- **docs:** configure pymdownx.emoji to properly render Material Design icons ([09ba764](https://github.com/juspay/neurolink/commit/09ba764e0cb57eac3d365d53754d32ef7a178bcf))

## [7.3.6](https://github.com/juspay/neurolink/compare/v7.3.5...v7.3.6) (2025-08-04)

### Bug Fixes

- **docs:** trigger fresh deployment after GitHub Pages source change ([e9c5975](https://github.com/juspay/neurolink/commit/e9c5975bcfb2ba7e53a29282bf9a5b45cc0d0034))

## [7.3.5](https://github.com/juspay/neurolink/compare/v7.3.4...v7.3.5) (2025-08-04)

### Bug Fixes

- **docs:** force fresh deployment after GitHub Pages source change to GitHub Actions ([b4b498f](https://github.com/juspay/neurolink/commit/b4b498f436986e6c017b1552af218837ad9b510e))

## [7.3.4](https://github.com/juspay/neurolink/compare/v7.3.3...v7.3.4) (2025-08-04)

### Bug Fixes

- **docs:** retry deployment to apply .nojekyll fix for MkDocs Material theme ([ce0afab](https://github.com/juspay/neurolink/commit/ce0afab3791dc9aa10c468ba5f48783301d092cf))

## [7.3.3](https://github.com/juspay/neurolink/compare/v7.3.2...v7.3.3) (2025-08-04)

### Bug Fixes

- **docs:** add .nojekyll file to prevent Jekyll processing ([a2f28b2](https://github.com/juspay/neurolink/commit/a2f28b2accbae0c280fcd43907d7774d92d9895f))

## [7.3.2](https://github.com/juspay/neurolink/compare/v7.3.1...v7.3.2) (2025-08-04)

### Bug Fixes

- **docs:** update copyright year and set dark theme as default ([bf1973d](https://github.com/juspay/neurolink/commit/bf1973d40298554c8cab508c109decf81cd9c519))

## [7.3.1](https://github.com/juspay/neurolink/compare/v7.3.0...v7.3.1) (2025-08-04)

### Bug Fixes

- **docs:** resolve GitHub Actions workflow YAML parsing errors ([182416d](https://github.com/juspay/neurolink/commit/182416d03e1887c35619013a6a92cf3337d604a1))

# [7.3.0](https://github.com/juspay/neurolink/compare/v7.2.0...v7.3.0) (2025-08-04)

### Features

- **docs:** implement comprehensive documentation website infrastructure ([77c81f4](https://github.com/juspay/neurolink/commit/77c81f41bc8533252a7dfc2265790bc37225450b))

# [7.2.0](https://github.com/juspay/neurolink/compare/v7.1.0...v7.2.0) (2025-08-04)

### Features

- **core:** complete NeuroLink Phase 1-4 implementation with comprehensive verification ([37d5cb1](https://github.com/juspay/neurolink/commit/37d5cb1a494850cd564d6fbce68895997939886f))

# [7.1.0](https://github.com/juspay/neurolink/compare/v7.0.0...v7.1.0) (2025-08-03)

### Features

- **core:** major CLI optimization and comprehensive core functionality overhaul ([66ad664](https://github.com/juspay/neurolink/commit/66ad6649163c21c1f5cf7dcb936af8903abc4a17))

# [7.0.0](https://github.com/juspay/neurolink/compare/v6.2.1...v7.0.0) (2025-07-31)

### Code Refactoring

- **structure:** standardize all filenames and directories to camelCase ([656d094](https://github.com/juspay/neurolink/commit/656d094ac5f6caeecb4aebbfbe3f49f75f1adc4a))

### BREAKING CHANGES

- **structure:** None - all functionality preserved, only naming conventions updated

## [6.2.1](https://github.com/juspay/neurolink/compare/v6.2.0...v6.2.1) (2025-07-31)

### Bug Fixes

- **logging:** consolidate MCP logging and add debug flag control ([ea0132d](https://github.com/juspay/neurolink/commit/ea0132dd954966cb42238dc3736f6cee9cc7b18d))

# [6.2.0](https://github.com/juspay/neurolink/compare/v6.1.0...v6.2.0) (2025-07-30)

### Features

- systematic dead code elimination across entire codebase ([571060a](https://github.com/juspay/neurolink/commit/571060a6146dc13e486da22610122d599420fcb2))

# [6.1.0](https://github.com/juspay/neurolink/compare/v6.0.0...v6.1.0) (2025-07-24)

### Features

- **github:** enhance GitHub project configuration and community features ([deb1407](https://github.com/juspay/neurolink/commit/deb1407cb8c7be7eff4baf365f6600da33ac4255))

# [6.0.0](https://github.com/juspay/neurolink/compare/v5.3.0...v6.0.0) (2025-07-24)

### Features

- **types:** eliminate all TypeScript any usage across entire codebase ([777c3cd](https://github.com/juspay/neurolink/commit/777c3cda582cbefcf01480a12d13a2adb7c140c8))

### BREAKING CHANGES

- **types:** Complete removal of TypeScript 'any' types for enhanced type safety

This comprehensive refactor eliminates all TypeScript 'any' usage across the entire
NeuroLink codebase, affecting 140+ files with systematic type safety improvements:

- NEW: src/lib/types/common.ts - Unknown, UnknownRecord, JsonValue utility types
- NEW: src/lib/types/tools.ts - Tool system types (ToolArgs, ToolResult, ToolDefinition)
- NEW: src/lib/types/providers.ts - Provider-specific types (ProviderConfig, AnalyticsData)
- NEW: src/lib/types/cli.ts - CLI command types and interfaces
- NEW: src/lib/types/index.ts - Centralized type exports

- Export NeuroLinkSDK interface from baseProvider for proper typing
- Fix all provider constructors: anthropic, azureOpenai, googleAiStudio, googleVertex, mistral
- Update functionCalling-provider with proper type casting
- Enhanced analytics-helper with comprehensive type guards
- Fix timeout-wrapper and all provider error handling

- Fix directToolsServer: inputSchema and execution result types
- Fix aiCoreServer: provider factory and result access types
- Fix transport-manager: HTTP client transport constructor types
- Fix unified-registry: server configuration type compatibility
- Update all MCP adapters, clients, managers, and orchestrators
- Fix tool integration, registry, and session management
- Enhanced error handling and recovery systems

- Update baseProvider with proper abstract method signatures
- Fix serviceRegistry with type-safe service management
- Enhanced factory pattern with proper generic constraints
- Update evaluation system with strict typing
- Fix analytics core with proper data flow types

- Fix all CLI commands with proper argument typing
- Update command factory with type-safe command creation
- Enhanced tool extension and registration with strict interfaces
- Fix SDK integration with proper type boundaries

- Update all test files with proper type assertions
- Fix test helpers with generic constraints
- Enhanced integration tests with type safety
- Update performance and streaming tests
- Fix all provider-specific test suites

- Update eslint.config.js for enhanced type checking
- Fix logger with proper structured logging types
- Update provider validation with type guards
- Enhanced proxy and networking layers
- Fix telemetry service with proper event typing

- Update tsconfig.json for stricter type checking
- Enhanced build pipeline compatibility
- Fix package exports and type definitions

- ESLint violations: 14 → 0 (100% elimination)
- TypeScript compilation: ✅ PASSING
- Build pipeline: ✅ PASSING
- All tests: ✅ PASSING
- Runtime behavior: ✅ PRESERVED

This change maintains complete backward compatibility while establishing
a foundation for enhanced developer experience and code reliability.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

# [5.3.0](https://github.com/juspay/neurolink/compare/v5.2.0...v5.3.0) (2025-07-23)

### Features

- **mcp:** enhance MCP integration with comprehensive testing infrastructure and tool ecosystem improvements ([a38d845](https://github.com/juspay/neurolink/commit/a38d845032133eee098de10b966cbdd3a329fdfd))

# [5.2.0](https://github.com/juspay/neurolink/compare/v5.1.0...v5.2.0) (2025-07-22)

### Features

- **core:** implement comprehensive factory pattern architecture with full MCP integration and provider unification ([b13963a](https://github.com/juspay/neurolink/commit/b13963aaf6f95233be8b1e9bdc69ce1b65604cdf))

# [5.1.0](https://github.com/juspay/neurolink/compare/v5.0.0...v5.1.0) (2025-07-13)

### Features

- **core:** complete unified multimodal AI platform architecture with generate/stream unification ([846e409](https://github.com/juspay/neurolink/commit/846e409a4a77024ddee9961c9b5049bc99f8335e))

# [5.0.0](https://github.com/juspay/neurolink/compare/v4.2.0...v5.0.0) (2025-07-11)

- refactor(cli)!: remove agent-generate command, unify CLI to single generate command ([9c034b7](https://github.com/juspay/neurolink/commit/9c034b7b5a8df3b861fccae0e617c5aa4c85a903))

### Bug Fixes

- **scripts:** update docs:generate to use docs:validate instead of removed docs:sync ([3277bab](https://github.com/juspay/neurolink/commit/3277bab3eb1cec24a60fe28bf3897fce63d83d3a))

### BREAKING CHANGES

- agent-generate command has been removed

The agent-generate command has been completely removed from the CLI. All
functionality is now available through the enhanced generate command with
tools enabled by default.

### Changes Made:

- Delete src/cli/commands/agent-generate.ts command implementation
- Remove agent-generate import and registration from src/cli/index.ts
- Update docs/CLI-GUIDE.md to remove agent-generate documentation
- Update memory-bank documentation files to reflect unified approach
- Remove agent-generate test cases from scripts/corrected-functionality-test.js

### Migration Guide:

- Replace `neurolink agent-generate "prompt"` with `neurolink generate "prompt"`
- Tools are enabled by default in generate command
- Use `--disable-tools` flag if tool-calling is not desired
- All previous agent-generate functionality available in generate command

### Technical Impact:

- Simplified CLI interface with single text generation command
- Reduced codebase complexity and maintenance overhead
- Enhanced generate command provides all tool-calling capabilities
- Zero breaking changes to core functionality
- Clean TypeScript compilation and documentation consistency

# [4.2.0](https://github.com/juspay/neurolink/compare/v4.1.1...v4.2.0) (2025-07-11)

### Features

- **mcp:** comprehensive MCP system enhancements with timeout management ([1d35b5e](https://github.com/juspay/neurolink/commit/1d35b5e12d03ce60bcdf0608749a1b99e8565567))

## [4.1.1](https://github.com/juspay/neurolink/compare/v4.1.0...v4.1.1) (2025-07-10)

### Bug Fixes

- **format:** fix formatting for all follow ([a49a94b](https://github.com/juspay/neurolink/commit/a49a94bf4d2e02cf1b1f7d4b555c3c71e25a0ea5))

# [4.1.0](https://github.com/juspay/neurolink/compare/v4.0.0...v4.1.0) (2025-07-09)

### Features

- **mcp:** comprehensive MCP system overhaul with GitHub PR fixes ([c0d8114](https://github.com/juspay/neurolink/commit/c0d8114ef1ab2d5dd3162c369f234d0de17397f7))

# [4.0.0](https://github.com/juspay/neurolink/compare/v3.0.1...v4.0.0) (2025-07-06)

- feat(core)!: transform NeuroLink into enterprise AI analytics platform ([74c88d6](https://github.com/juspay/neurolink/commit/74c88d6484bbd983aba9119929481e655d62eab3))

### BREAKING CHANGES

- Major architectural enhancement from basic AI SDK
  to comprehensive enterprise platform with analytics, evaluation,
  real-time services, and business intelligence capabilities.

Core Features Added:

- Analytics System: Usage tracking, cost estimation, performance monitoring
- Evaluation Framework: AI-powered quality assessment and scoring
- Enterprise Config: Backup/restore, validation, provider management
- Real-time Services: Chat, streaming, websocket capabilities
- Telemetry: OpenTelemetry integration for production monitoring
- Documentation: Complete business and technical documentation overhaul
- Examples: Comprehensive demo library with 30+ working examples
- Provider Integration: Analytics helper integrated across all 9 providers

Technical Implementation:

- NEW: src/lib/core/analytics.ts - Real usage tracking engine
- NEW: src/lib/core/evaluation.ts - AI quality assessment framework
- NEW: src/lib/config/configManager.ts - Enterprise configuration management
- NEW: src/lib/chat/ - Complete chat service infrastructure (7 files)
- NEW: src/lib/services/ - Streaming and WebSocket architecture
- NEW: src/lib/telemetry/ - OpenTelemetry integration
- NEW: examples/ - Comprehensive demo ecosystem (30+ examples)
- NEW: docs/ - Complete documentation overhaul (15+ guides)
- ENHANCED: All 9 providers with analytics integration
- ENHANCED: CLI with professional analytics display
- ENHANCED: Testing infrastructure with new test suites

Files Changed: 127 files (+20,542 additions, -6,142 deletions)
Backward Compatibility: 100% maintained - existing functionality preserved
New Features: Opt-in via --enable-analytics --enable-evaluation flags

Business Impact:

- Production Monitoring: Real-time performance and cost tracking
- Quality Assurance: AI-powered response evaluation and scoring
- Cost Optimization: Usage analytics and provider comparison
- Risk Management: Backup systems and error recovery
- Developer Experience: Professional CLI and comprehensive examples
- Enterprise Readiness: OpenTelemetry observability and operational excellence

Performance Metrics:

- Analytics: Real token counts (299-768), response times (2-10s)
- Evaluation: Quality scores (8-10/10), sub-6s processing
- Providers: All 9 providers enhanced with zero breaking changes
- CLI: Professional output with debug diagnostics

## [3.0.1](https://github.com/juspay/neurolink/compare/v3.0.0...v3.0.1) (2025-07-01)

### Bug Fixes

- **cli:** honor --model parameter in CLI commands ([467ea85](https://github.com/juspay/neurolink/commit/467ea8548688a9db6046c98dbfd268ecd297605c))

# [3.0.0](https://github.com/juspay/neurolink/compare/v2.1.0...v3.0.0) (2025-07-01)

### Features

- **proxy:** add comprehensive enterprise proxy support across all providers ([9668e67](https://github.com/juspay/neurolink/commit/9668e67dfaa27831ba85d45fdf5b7739de902b28))

### BREAKING CHANGES

- **proxy:** None - fully backward compatible

Files modified:

- docs/ENTERPRISE-PROXY-SETUP.md (NEW) - Comprehensive enterprise proxy guide
- docs/PROVIDER-CONFIGURATION.md - Added proxy configuration section
- docs/CLI-GUIDE.md - Added proxy environment variables documentation
- docs/ENVIRONMENT-VARIABLES.md - Added proxy configuration examples
- docs/TROUBLESHOOTING.md - Added proxy troubleshooting procedures
- .env.example - Added proxy environment variables
- memory-bank/ - Updated with proxy implementation milestone
- .clinerules - Added proxy success patterns
- CHANGELOG.md - Added v2.2.0 proxy support entry
- package.json - Updated description with enterprise features
- README.md - Removed outdated content

# [2.1.0](https://github.com/juspay/neurolink/compare/v2.0.0...v2.1.0) (2025-06-29)

### Features

- **timeout:** add comprehensive timeout support for all AI providers ([8610f4a](https://github.com/juspay/neurolink/commit/8610f4ade418345b0395ab72af6e675f6eec6f93))

# [2.0.0](https://github.com/juspay/neurolink/compare/v1.11.3...v2.0.0) (2025-06-28)

### Features

- **cli:** add command variations and stream agent support ([5fc4c26](https://github.com/juspay/neurolink/commit/5fc4c26b23bd189be52272521bdd2ca40dd55837))

### BREAKING CHANGES

- **cli:** 'generate-text' command is deprecated and will be removed in v2.0

## [1.11.3](https://github.com/juspay/neurolink/compare/v1.11.2...v1.11.3) (2025-06-22)

### Bug Fixes

- resolve MCP external tools returning raw JSON instead of human-readable responses ([921a12b](https://github.com/juspay/neurolink/commit/921a12b5b31ca96bbfe3f1db05001ddb84470e14))

## [1.11.2](https://github.com/juspay/neurolink/compare/v1.11.1...v1.11.2) (2025-06-22)

### Bug Fixes

- **ci:** refactor auto-converted Node.js scripts ([4088888](https://github.com/juspay/neurolink/commit/408888863f8223e64269423412f5c79a35ddfe36))

## [1.11.1](https://github.com/juspay/neurolink/compare/v1.11.0...v1.11.1) (2025-06-21)

### Bug Fixes

- add backward compatiblity for gemini ([5e84dab](https://github.com/juspay/neurolink/commit/5e84dab598156a5b77d05b343d0d69ecf91f31b0))

# [1.11.0](https://github.com/juspay/neurolink/compare/v1.10.0...v1.11.0) (2025-06-21)

### Features

- finalize MCP ecosystem and resolve all TypeScript errors ([605d8b2](https://github.com/juspay/neurolink/commit/605d8b2ea10c824077e1379ac47a0c065f0a8095))

# [1.10.0](https://github.com/juspay/neurolink/compare/v1.9.0...v1.10.0) (2025-06-21)

### Features

- **cli:** improve provider status accuracy and error handling ([523e845](https://github.com/juspay/neurolink/commit/523e84566fee5d9afa3638186f90c628e20e4894))

# 1.9.0 (2025-06-20)

- 🎉 feat: Enhanced multi-provider support with production infrastructure ([#16](https://github.com/juspay/neurolink/issues/16)) ([55eb81a](https://github.com/juspay/neurolink/commit/55eb81a4a7e88c94f6017565b14633b254a15197))

### Bug Fixes

- **cli:** prevent debug log persistence in production deployments ([#14](https://github.com/juspay/neurolink/issues/14)) ([7310a4c](https://github.com/juspay/neurolink/commit/7310a4cb405e1f35bcc5b22559f3da87a1d793f4))
- production-ready CLI logging system and enhanced provider fallback ([#13](https://github.com/juspay/neurolink/issues/13)) ([a7e8122](https://github.com/juspay/neurolink/commit/a7e8122393f09cd85e473e5711fbfff05343025e))

### Features

- 🚀 MCP automatic tool discovery + dynamic models + AI function calling ([781b4e5](https://github.com/juspay/neurolink/commit/781b4e5c6e4886acb44a986f7b204eff346427e1))
- add Google AI Studio integration and restructure documentation ([#11](https://github.com/juspay/neurolink/issues/11)) ([346fed2](https://github.com/juspay/neurolink/commit/346fed2ad458da07b80158f084afed8f3b804f06))
- add Google AI Studio, fix CLI dependencies, and add LICENSE file ([#12](https://github.com/juspay/neurolink/issues/12)) ([c234bcb](https://github.com/juspay/neurolink/commit/c234bcb65ab1d07cb079ee9ffe9d61841aa945fb))
- implement AI Development Workflow Tools and comprehensive visual documentation ([#10](https://github.com/juspay/neurolink/issues/10)) ([b0ae179](https://github.com/juspay/neurolink/commit/b0ae179d0b31936e4aa8c53c8e8a234cd467e7c3))
- implement comprehensive CLI tool with visual documentation and … ([#4](https://github.com/juspay/neurolink/issues/4)) ([9991edb](https://github.com/juspay/neurolink/commit/9991edba7dbe7b9b33bd3b4e2b30186a81b40391))

### BREAKING CHANGES

- Enhanced provider architecture with MCP integration

* ✨ MCP automatic tool discovery - detects 82+ tools from connected servers
* 🎯 AI function calling - seamless tool execution with Vercel AI SDK
* 🔧 Dynamic model configuration via config/models.json
* 🤖 Agent-based generation with automatic tool selection
* 📡 Real-time MCP server management and monitoring

* Added MCPEnhancedProvider for automatic tool integration
* Implemented function calling for Google AI, OpenAI providers
* Created unified tool registry for MCP and built-in tools
* Enhanced CLI with `agent-generate` and MCP management commands
* Added comprehensive examples and documentation

* Automatic .mcp-config.json discovery across platforms
* Session-based context management for tool execution
* Graceful fallback when MCP servers unavailable
* Performance optimized tool discovery (<1ms per tool)

* Added 5 new comprehensive guides (MCP, troubleshooting, dynamic models)
* Created practical examples for all integration patterns
* Updated API reference with new capabilities
* Enhanced memory bank with implementation details

Resolves: Enhanced AI capabilities with real-world tool integration

- None - 100% backward compatibility maintained

Closes: Enhanced multi-provider support milestone
Ready for: Immediate production deployment
Impact: Most comprehensive AI provider ecosystem (9 providers)

Co-authored-by: sachin.sharma <sachin.sharma@juspay.in>

# @juspay/neurolink

## 1.8.0

### 🎯 Major Feature: Dynamic Model Configuration System

- **⚡ Revolutionary Model Management**: Introduced dynamic model configuration system replacing static enums

  - **Self-Updating Models**: New models automatically available without code updates
  - **Cost Optimization**: Automatic selection of cheapest models for tasks
  - **Smart Resolution**: Fuzzy matching, aliases, and capability-based search
  - **Multi-Source Loading**: Configuration from API → GitHub → local with fallback

- **💰 Cost Intelligence**: Built-in cost optimization and model selection algorithms

  - **Current Leader**: Gemini 2.0 Flash at $0.000075/1K input tokens
  - **Capability Mapping**: Find models by features (functionCalling, vision, code-execution)
  - **Real-Time Pricing**: Always current model costs and performance data
  - **Budget Controls**: Maximum price filtering and cost-aware selection

- **🔧 Production-Ready Infrastructure**: Complete system with validation and monitoring

  - **Model Configuration Server**: REST API with search capabilities (`scripts/model-server.js`)
  - **Zod Schema Validation**: Type-safe runtime configuration validation
  - **Comprehensive Testing**: Full test suite for all dynamic model functionality
  - **Documentation**: Complete guide with examples and best practices

- **🏷️ Smart Model Features**: Advanced model resolution and aliasing
  - **Aliases**: Use friendly names like "claude-latest", "best-coding", "fastest"
  - **Default Models**: Provider-specific defaults when no model specified
  - **Fuzzy Matching**: "opus" → resolves to "claude-3-opus"
  - **Deprecation Handling**: Automatically exclude deprecated models

### Technical Implementation

- **New Module**: `src/lib/core/dynamicModels.ts` - Core dynamic model provider
- **Configuration**: `config/models.json` - Structured model definitions with metadata
- **Integration**: Updated `AIProviderFactory` to use dynamic models by default
- **Testing**: Comprehensive test suite (`test-dynamicModels.js`, `test-complete-integration.js`)
- **Server**: Fake hosted server for testing and development (`scripts/model-server.js`)

### API Enhancements

- **Environment Variables**: Added `GOOGLE_AI_API_KEY` for better compatibility
- **New Scripts**: `npm run model-server`, `npm run test:dynamicModels`
- **Model Search API**: RESTful endpoints for model discovery and filtering
- **Performance**: Sub-millisecond provider creation with intelligent caching

### Current Model Inventory

- **10 Active Models**: Across Anthropic, OpenAI, Google, and Bedrock
- **Cost Range**: $0.000075 - $0.075 per 1K input tokens (100x cost difference)
- **Capabilities**: Function-calling (9 models), Vision (7 models), Code-execution (1 model)
- **Deprecation Tracking**: 1 deprecated model (GPT-4 Turbo) automatically excluded

### Breaking Changes

- **MCP Default**: MCP tools now enabled by default in `AIProviderFactory.createProvider`
- **Environment**: Added `GOOGLE_AI_API_KEY` requirement for Google AI Studio
- **Model Resolution**: Some edge cases in model name resolution may behave differently

### Migration Notes

- **Backward Compatible**: Existing code continues to work with improved functionality
- **Optional Features**: Dynamic model features are additive and optional
- **Configuration**: No changes required to existing `.env` files
- **Performance**: Improved provider creation speed and reliability

## 1.7.1

### Bug Fixes - MCP System Restoration

- **🔧 Fixed Built-in Tool Loading**: Resolved critical circular dependency issues preventing default tools from loading

  - **Root Cause**: Circular dependency between `config.ts` and `unified-registry.ts` preventing proper initialization
  - **Solution**: Implemented dynamic imports and restructured initialization chain
  - **Result**: Built-in tools restored from 0 → 3 tools (100% recovery rate)

- **⏰ Fixed Time Tool Functionality**: Time tool now properly available and returns accurate real-time data

  - Fixed tool registration and execution pathway
  - Proper timezone handling and formatting
  - Verified accuracy against system time

- **🔍 Enhanced External Tool Discovery**: 58+ external MCP tools now discoverable via comprehensive auto-discovery

  - Auto-discovery across VS Code, Claude Desktop, Cursor, Windsurf
  - Proper placeholder system for lazy activation
  - Unified registry integration

- **🏗️ Unified Registry Architecture**: Centralized tool management system now fully operational
  - Seamless integration of built-in and external tools
  - Proper initialization sequence and dependency management
  - Enhanced debugging and status reporting

### Technical Changes

- Fixed circular dependency between core MCP modules
- Updated `initialize.ts` to use dynamic imports preventing startup issues
- Enhanced `loadDefaultRegistryTools()` to ensure proper built-in server registration
- Temporarily disabled AI core server to resolve complex dependencies (utility server fully working)
- Improved error handling and logging throughout MCP system

### Validation Results

- **Built-in Tools**: 3/3 working (get-current-time, calculate-date-difference, format-number)
- **External Discovery**: 58+ tools discovered across multiple MCP sources
- **Tool Execution**: Real-time AI tool calling verified and working
- **System Integration**: Full CLI and SDK integration operational

### Breaking Changes

- None - all changes are backward compatible improvements

### Migration Notes

- Existing MCP configurations continue to work
- Built-in tools now work automatically without additional setup
- External tools require proper MCP server configuration (as before)

## 1.7.0

### Patch Changes

- **🔧 Version Bump**: Updated version to 1.7.0 to publish the three-provider implementation
  - All code changes were already included in 1.6.0 but not published
  - This version publishes the complete implementation to npm

## 1.6.0

### Major Changes

- **🎉 Universal AI Provider Support**: Expanded from 6 to 9 AI providers with support for open source models, local AI, and European compliance
  - **🆕 Hugging Face Provider**: Access to 100,000+ open source models with community-driven AI ecosystem
  - **🆕 Ollama Provider**: 100% local AI execution with complete data privacy and no internet required
  - **🆕 Mistral AI Provider**: European GDPR-compliant AI with competitive pricing and multilingual models

### Features

- **🛠️ Enhanced CLI with Ollama Commands**: New Ollama-specific management commands

  - `neurolink ollama list-models` - List installed local models
  - `neurolink ollama pull <model>` - Download models locally
  - `neurolink ollama remove <model>` - Remove installed models
  - `neurolink ollama status` - Check Ollama service health
  - `neurolink ollama start/stop` - Manage Ollama service
  - `neurolink ollama setup` - Interactive setup wizard

- **📚 Comprehensive Documentation**: Complete documentation for all new providers
  - **OLLAMA-SETUP.md**: Platform-specific installation guides
  - **PROVIDER-COMPARISON.md**: Detailed provider comparison matrix
  - Updated all documentation to reflect 9 providers
  - Enhanced provider configuration guides

### Technical Implementation

- **Provider Files**: `huggingFace.ts`, `ollama.ts`, `mistralAI.ts`
- **Dependencies**: Added `@huggingface/inference`, `@ai-sdk/mistral`, `inquirer`
- **MCP Integration**: All 10 MCP tools support new providers
- **Demo Updates**: Enhanced demo to showcase all 9 providers
- **CLI Enhancement**: Ollama command structure with 7 subcommands
- **Provider Priority**: Updated auto-selection to include new providers

### Provider Comparison

| Provider     | Best For      | Setup Time | Privacy | Cost    |
| ------------ | ------------- | ---------- | ------- | ------- |
| OpenAI       | General use   | 2 min      | Cloud   | $$$     |
| Ollama       | Privacy       | 5 min      | Local   | Free    |
| Hugging Face | Open source   | 2 min      | Cloud   | Free/$$ |
| Mistral      | EU compliance | 2 min      | Cloud   | $$      |

### Bug Fixes

- **🔧 Local Provider Fallback**: Implemented no-fallback policy for Ollama
  - When explicitly requesting `--provider ollama`, no cloud fallback occurs
  - Preserves user privacy intent when using local providers
  - Auto-selection still maintains intelligent fallback

### Breaking Changes

- None - 100% backward compatibility maintained

## 1.5.3

### Patch Changes

- **🔧 CLI Debug Log Persistence Fix**: Fixed unwanted debug logs appearing in production deployments
  - **Issue**: CLI showed debug logs even when `--debug` flag was not provided, cluttering production output
  - **Root Cause**: CLI middleware had logical gap where `NEUROLINK_DEBUG` wasn't explicitly set to `'false'` when no debug flag provided, allowing inherited environment variables to persist
  - **Solution**: Updated middleware to always set `NEUROLINK_DEBUG = 'false'` when debug mode not enabled
  - **Impact**: **Deterministic logging behavior** - debug logs only appear when explicitly requested with `--debug` flag

### Technical Changes

- **Clean Production Output**: No debug logs in deployed CLI unless `--debug` flag explicitly provided
- **Deterministic Behavior**: Logging controlled by CLI flags, not inherited environment variables
- **Backward Compatible**: Debug mode still works perfectly when `--debug` flag is used
- **Environment Independence**: CLI output no longer affected by external `NEUROLINK_DEBUG` settings

### CLI Behavior Fix

```bash
# Before Fix (Problematic)
neurolink generate-text "test"
# Could show debug logs if NEUROLINK_DEBUG was set in environment

# After Fix (Clean)
neurolink generate-text "test"
# Output: ⠋ 🤖 Generating text... ✔ ✅ Text generated successfully! [content]

# Debug still works when requested
neurolink generate-text "test" --debug
# Output: [debug logs] + spinner + success + content
```

## 1.5.2

### Patch Changes

- **🔧 Production-Ready CLI Logging System**: Fixed critical logging system for clean production output

  - **Issue**: CLI showed excessive debug output during normal operation, breaking demo presentations
  - **Root Cause**: Mixed console.log statements bypassed conditional logger system
  - **Solution**: Systematic replacement of all console.log with logger.debug across codebase
  - **Impact**: **Clean CLI output by default** with conditional debug available via `NEUROLINK_DEBUG=true`

- **🔄 Enhanced Provider Fallback Logic**: Fixed incomplete provider fallback coverage

  - **Issue**: Provider fallback only attempted 4 of 6 providers (missing Anthropic & Azure)
  - **Root Cause**: Incomplete provider array in NeuroLink class fallback logic
  - **Solution**: Updated to include all 6 providers: `['openai', 'vertex', 'bedrock', 'anthropic', 'azure', 'google-ai']`
  - **Impact**: **100% provider coverage** with comprehensive fallback for maximum reliability

- **🧹 Console Statement Cleanup**: Systematic cleanup of debug output across entire codebase
  - **Files Updated**: `src/lib/neurolink.ts`, `src/lib/core/factory.ts`, `src/lib/providers/openAI.ts`, `src/lib/mcp/servers/aiProviders/aiCoreServer.ts`
  - **Pattern**: Replaced 200+ `console.log()` statements with `logger.debug()` calls
  - **Result**: Professional CLI behavior suitable for production deployment and demos

### Technical Changes

- **Production CLI Output**: Clean spinner → success → content (zero debug noise)
- **Debug Mode Available**: Full debug logging with `NEUROLINK_DEBUG=true` environment variable
- **Complete Provider Support**: All 6 AI providers now included in automatic fallback
- **Error Handling**: Provider-level error logs preserved for troubleshooting
- **Conditional Logging**: Debug messages only appear when explicitly enabled
- **Demo Ready**: CLI output suitable for presentations and production use

### CLI Behavior

```bash
# Production/Demo Mode (Clean Output)
node dist/cli/cli/index.js generate-text "test" --max-tokens 5
# Output: ⠋ 🤖 Generating text... ✔ ✅ Text generated successfully! [content]

# Debug Mode (Full Logging)
NEUROLINK_DEBUG=true node dist/cli/cli/index.js generate-text "test" --max-tokens 5
# Output: [debug logs] + spinner + success + content
```

### Backward Compatibility

- **100% API Compatible**: No breaking changes to public interfaces
- **Environment Variables**: `NEUROLINK_DEBUG=true` works as documented
- **Provider Selection**: All existing provider configurations continue working
- **CLI Commands**: All commands maintain same functionality with cleaner output

## 1.5.1

### Patch Changes

- **🔧 Critical CLI Dependency Fix**: Removed peer dependencies to ensure zero-friction CLI usage

  - **Issue**: CLI commands failed when provider-specific SDK packages were peer dependencies
  - **Root Cause**: `npx` doesn't install peer dependencies, causing missing module errors
  - **Solution**: Moved ALL AI provider SDKs to regular dependencies
  - **Impact**: **100% reliable CLI** - all providers work immediately with `npx @juspay/neurolink`
  - **Dependencies**: All AI SDK packages now bundled automatically (@ai-sdk/openai, @ai-sdk/bedrock, @ai-sdk/vertex, @ai-sdk/google)

- **📄 Critical Legal Compliance**: Added missing MIT LICENSE file
  - **Issue**: Package claimed MIT license but had no LICENSE file in repository
  - **Legal Risk**: Without explicit license file, users had no legal permission to use the software
  - **Solution**: Added proper MIT License file with Juspay Technologies copyright (2025)
  - **Impact**: **Full legal compliance** - users now have explicit permission to use, modify, and distribute
  - **Files**: Added `LICENSE` file with standard MIT license text

### Technical Changes

- **Dependency Structure**: Eliminated peer dependencies entirely for CLI compatibility
- **Provider Support**: All 5 AI providers (OpenAI, Bedrock, Vertex AI, Google AI Studio, Anthropic) now work out-of-the-box
- **Zero Setup**: No manual dependency installation required for any provider
- **Repository Structure**: LICENSE file now included in package distribution
- **Legal Clarity**: Explicit copyright and permission statements
- **Compliance**: Matches industry standards for open source software licensing
- **Package Files**: LICENSE included in NPM package distribution
- **Backward Compatibility**: 100% compatible with existing code and configurations

## 1.5.0

### Major Changes

- **🧠 Google AI Studio Integration**: Added Google AI Studio as 5th AI provider with Gemini models
  - **🔧 New Provider**: Complete GoogleAIStudio provider with Gemini 1.5/2.0 Flash/Pro models
  - **🆓 Free Tier Access**: Leverage Google's generous free tier for development and testing
  - **🖥️ CLI Support**: Full `--provider google-ai` integration across all commands
  - **⚡ Auto-Selection**: Included in automatic provider selection algorithm
  - **🔑 Simple Setup**: Single `GOOGLE_AI_API_KEY` environment variable configuration

### Features

- **📚 Documentation Architecture Overhaul**: Complete README.md restructuring for better UX
  - **75% Size Reduction**: Transformed from 800+ lines to ~200 lines focused on quick start
  - **Progressive Disclosure**: Clear path from basic → intermediate → advanced documentation
  - **Specialized Documentation**: Created 4 dedicated docs files for different audiences
  - **Cross-References**: Complete navigation system between all documentation files

### New Documentation Structure

```
docs/
├── AI-ANALYSIS-TOOLS.md          # AI optimization and analysis tools
├── AI-WORKFLOW-TOOLS.md          # Development lifecycle tools
├── MCP-FOUNDATION.md             # Technical MCP architecture
└── GOOGLE-AI-STUDIO-INTEGRATION-ARCHIVE.md  # Integration details
```

### Google AI Studio Provider

```typescript
// New Google AI Studio usage
import { createBestAIProvider } from "@juspay/neurolink";

const provider = createBestAIProvider(); // Auto-includes Google AI Studio
const result = await provider.generateText("Hello, Gemini!");
```

```bash
# Quick setup with Google AI Studio (free tier)
export GOOGLE_AI_API_KEY="AIza-your-google-ai-key"
npx @juspay/neurolink generate-text "Hello, AI!" --provider google-ai
```

### Enhanced Visual Content

- **Google AI Studio Demos**: Complete visual documentation for new provider
- **CLI Demonstrations**: Updated CLI videos showing google-ai provider
- **Professional Quality**: 6 new videos and asciinema recordings

### Technical Implementation

- **Provider Integration**: `src/lib/providers/googleAIStudio.ts`
- **Models Supported**: Gemini 1.5 Pro/Flash, Gemini 2.0 Flash/Pro
- **Authentication**: Simple API key authentication via Google AI Studio
- **Testing**: Complete test coverage including provider and CLI tests

### Bug Fixes

- **🔧 CLI Dependencies**: Moved essential dependencies (`ai`, `zod`) from peer to regular dependencies
  - **Issue**: `npx @juspay/neurolink` commands failed due to missing dependencies
  - **Solution**: CLI now works out-of-the-box without manual dependency installation
  - **Impact**: Zero-friction CLI usage for all users

### Breaking Changes

- None - 100% backward compatibility maintained

## 1.4.0

### Major Changes

- **📚 MCP Documentation Master Plan**: Complete external server connectivity documentation
  - **🔧 MCP Integration Guide**: 400+ line comprehensive setup and usage guide
  - **📖 CLI Documentation**: Complete MCP commands section with workflows
  - **🧪 Demo Integration**: 5 MCP API endpoints for testing and demonstration
  - **⚙️ Configuration Templates**: .env.example and .mcp-servers.example.json
  - **📋 API Reference**: Complete MCP API documentation with examples

### Features

- **External Server Connectivity**: Full MCP (Model Context Protocol) support
- **65+ Compatible Servers**: Filesystem, GitHub, databases, web browsing, search
- **Professional CLI**: Complete server lifecycle management
- **Demo Server Integration**: Live MCP API endpoints
- **Configuration Management**: Templates and examples for all deployment scenarios

### MCP Server Support

```bash
# Install and manage external servers
neurolink mcp install filesystem
neurolink mcp install github
neurolink mcp test filesystem
neurolink mcp list --status
neurolink mcp execute filesystem read_file --path="/path/to/file"
```

### MCP API Endpoints

```typescript
// Demo server includes 5 MCP endpoints
GET  /api/mcp/servers          # List configured servers
POST /api/mcp/test/:server     # Test server connectivity
GET  /api/mcp/tools/:server    # Get available tools
POST /api/mcp/execute          # Execute MCP tools
POST /api/mcp/install/:server  # Install new servers
```

### Documentation Updates

- **README.md**: Complete MCP section with real-world examples
- **docs/MCP-INTEGRATION.md**: 400+ line comprehensive MCP guide
- **docs/CLI-GUIDE.md**: MCP commands section with workflow examples
- **docs/API-REFERENCE.md**: Complete MCP API documentation
- **docs/README.md**: Updated documentation index with MCP references

### Configuration

- **.env.example**: MCP environment variables section
- **.mcp-servers.example.json**: Complete server configuration template
- **package.json**: Updated description highlighting MCP capabilities

### Breaking Changes

- None - 100% backward compatibility maintained

## 1.3.0

### Major Changes

- **🎉 MCP Foundation (Model Context Protocol)**: NeuroLink transforms from AI SDK to Universal AI Development Platform
  - **🏭 MCP Server Factory**: Lighthouse-compatible server creation with `createMCPServer()`
  - **🧠 Context Management**: Rich context with 15+ fields + tool chain tracking
  - **📋 Tool Registry**: Discovery, registration, execution + statistics
  - **🎼 Tool Orchestration**: Single tools + sequential pipelines + error handling
  - **🤖 AI Provider Integration**: Core AI tools with schema validation
  - **🔗 Integration Tests**: 27/27 tests passing (100% success rate)

### Features

- **Factory-First Architecture**: MCP tools work internally, users see simple factory methods
- **Lighthouse Compatible**: 99% compatible with existing Lighthouse MCP patterns
- **Enterprise Ready**: Rich context, permissions, tool orchestration, analytics
- **Production Tested**: <1ms tool execution, comprehensive error handling

### Performance

- **Test Execution**: 1.23s for 27 comprehensive tests
- **Tool Execution**: 0-11ms per tool (well under 100ms target)
- **Pipeline Performance**: 22ms for 2-step sequential pipeline
- **Memory Efficiency**: Clean context management with automatic cleanup

### Technical Implementation

```typescript
src/lib/mcp/
├── factory.ts                  # createMCPServer() - Lighthouse compatible
├── context-manager.ts          # Rich context (15+ fields) + tool chain tracking
├── registry.ts                 # Tool discovery, registration, execution + statistics
├── orchestrator.ts             # Single tools + sequential pipelines + error handling
└── servers/aiProviders/       # AI Core Server with 3 tools integrated
    └── aiCoreServer.ts       # generate-text, select-provider, check-provider-status
```

### Breaking Changes

- None - 100% backward compatibility maintained

## 1.2.4

### Patch Changes

- 95d8ee6: Set up automated version bumping and publishing workflow with changesets integration