mLLMCelltype v1.2.9: Cache System Fix and Improvements

mLLMCelltype v1.2.9 Release Notes

🎉 Major Updates

Cache System Fix (#65)

• Fixed critical cache isolation issue: OpenRouter models were incorrectly reusing cache from regular models
• Solution: Modified create_cache_key() function to properly normalize provider for OpenRouter models (models containing '/')
• Impact: Prevents cache pollution and ensures accurate cell type annotations when switching between providers

New Features

• Cache Management Module: Added cache_manager.py with utilities for cache inspection and management
  • get_cache_info(): Get information about current cache state
  • clear_mllmcelltype_cache(): Interactive cache clearing
  • CLI interface: python -m mllmcelltype.cache_manager
• Comprehensive Documentation: Added detailed cache system documentation in docs/CACHE_SYSTEM.md
• Example Scripts: Added cache management examples in examples/cache_management_example.py

Code Quality Improvements

• Fixed all ruff linting errors across the Python package
• Added .gitignore to exclude temporary test files
• Updated import ordering and removed unused imports
• Added comprehensive test suite for cache system validation

📦 Package Information

Python Package

• Version: 1.2.9
• Files:
  • mllmcelltype-1.2.9.tar.gz - Source distribution
  • mllmcelltype-1.2.9-py3-none-any.whl - Wheel distribution

R Package

• Version: 1.2.9
• File: mLLMCelltype_1.2.9.tar.gz

🐛 Bug Fixes

• Cache isolation between regular and OpenRouter models
• Import order issues in examples
• Unused variable warnings
• F-string formatting issues

📚 Documentation Updates

• Added comprehensive cache system documentation
• Updated examples to demonstrate proper model usage
• Added API key configuration example (.env.example)

🧪 Testing

• Added extensive test suite for cache system
• Verified cache isolation with real API calls
• Tested edge cases including tissue context variations

Installation

Python

pip install mllmcelltype==1.2.9

R

install.packages("mLLMCelltype_1.2.9.tar.gz", repos = NULL, type = "source")

Acknowledgments

Thanks to @eason-analytics for reporting the cache issue (#65) and providing detailed reproduction steps!

mLLMCelltype v1.2.8

Release of mLLMCelltype v1.2.8 (R package) and v1.2.3 (Python package)

v1.2.4 - Critical Bug Fix Release

Critical Bug Fixes

Fixed Major as.logical(from) Error

• Resolved critical error that occurred when processing large numbers of clusters (60+ clusters)
• This error was caused by non-character data being passed to strsplit() functions
• Users can now successfully process datasets with many clusters without encountering type coercion errors

Enhanced API Response Handling

• Added comprehensive tryCatch() blocks around all strsplit() operations in API processing functions
• Improved response validation to prevent function/closure types from being processed as character strings
• Enhanced error handling for all API processing functions:
  • process_openrouter.R
  • process_anthropic.R
  • process_openai.R
  • process_deepseek.R
  • process_qwen.R
  • process_stepfun.R
  • process_minimax.R
  • process_zhipu.R
  • process_gemini.R
  • process_grok.R

Improvements

• Better NULL value handling: Improved unlist() operations to filter out NULL values and handle errors gracefully
• Enhanced logging: Added more detailed error logging for debugging API response issues
• Improved consensus checking: Enhanced check_consensus.R to handle edge cases with malformed responses

Technical Details

• Fixed issue where large cluster datasets could cause type coercion errors in response parsing
• Added validation for function/closure types in API responses to prevent downstream errors
• Improved error messages to provide better diagnostics for API response issues

Installation

# Install from GitHub
devtools::install_github("cafferychen777/mLLMCelltype", subdir = "R")

What's Changed

• Enhanced robustness when processing large datasets
• Improved error handling across all API integrations
• Better debugging capabilities with enhanced logging

Full Changelog: v1.2.3...v1.2.4

mLLMCelltype 1.2.0

1.2.0 (2025-04-28)

Improvements

• First CRAN release
• Updated documentation and vignettes
• Improved package structure for CRAN compliance
• Fixed CITATION file format
• Updated URL to https://cafferyang.com/mLLMCelltype/

v1.1.4 Release

mLLMCelltype v1.1.4 (2025-04-24)

New Features & Improvements

• Expanded OpenRouter models list to support free models
• Resolved inconsistency issues between international and mainland China versions of Qwen models

Bug Fixes

• Fixed OpenRouter model handling in the consensus check process
• Fixed undefined current_clusters variable in README files by adding explicit variable definition and comments

Other Updates

• Updated DESCRIPTION file

This version improves model compatibility and fixes several key issues. We recommend all users to update to this version.