Gemini Scribe

Gemini Scribe 3.1.0 - Dynamic Parameter Controls & Advanced Settings

🎯 Major Features

Dynamic Model Parameter Controls

• Smart Temperature Ranges: Temperature sliders now automatically adjust based on your available Gemini models' actual capabilities (e.g., 0-2.0 instead of hardcoded 0-1)

• Model-Aware Top P: Top P controls show unique model default values and enforce proper 0-1 ranges

• Real-time Validation: Parameters are validated against model-specific limits with automatic adjustment and user notifications

• Contextual Information: Settings display actual supported ranges and model defaults for better user guidance

  Advanced Settings Panel

• Developer Settings Toggle: New "Show Advanced Settings" button reveals developer-focused options without cluttering the main interface

• Organized Configuration: Temperature, Top P, API settings, and model discovery controls now grouped in a dedicated advanced section

• Clean UI: Basic users see essential settings, power users can access advanced controls when needed

  Model Discovery System

• Automatic Model Updates: Plugin automatically discovers and updates available Gemini models from Google's API

• Parameter Limit Detection: Fetches actual temperature limits and Top P defaults for each model

• Smart Caching: 24-hour cache with manual refresh options to stay current with new Google model releases

• Fallback Support: Graceful handling when API discovery fails, with fallback to built-in model list

  🔧 Technical Improvements

  Performance Optimizations

• Debounced Validation: Added 300ms debouncing to slider controls to prevent excessive API calls during adjustment

• Efficient Array Handling: Replaced spread operator with reduce() for better performance with large model lists

• Concurrent Request Management: Improved handling of multiple API calls with Promise.allSettled()

  Enhanced Error Handling

• Graceful Failures: Individual model discovery failures no longer crash the entire system

• Better Error Messages: More specific validation feedback and user-friendly error descriptions

• Robust API Handling: Improved retry logic and fallback mechanisms for API interactions

  Code Quality

• Comprehensive Testing: Added 274 lines of new tests covering edge cases, large arrays, and error scenarios

• Type Safety: Enhanced TypeScript interfaces and optional chaining for better reliability

• Service Architecture: Clean separation of concerns with dedicated validation and discovery services

  📚 Documentation

  New Advanced Settings Guide

• Complete Configuration Reference: Detailed guide for all advanced settings and their use cases

• Parameter Tuning Guidance: Specific recommendations for different content types (research, creative writing, technical docs)

• Performance Optimization Tips: Best practices for model selection and context management

• Troubleshooting Section: Common issues and solutions for advanced settings

  Updated Documentation

• Enhanced README: Added "What's New" section highlighting dynamic parameter controls

• Improved Navigation: Added Advanced Settings Guide to documentation hub

• Better Troubleshooting: Enhanced troubleshooting section with parameter-specific guidance

  🛠️ Settings Reorganization

  Moved to Advanced Settings

• API Provider Selection: Now in advanced settings for cleaner main interface

• Temperature Controls: Dynamic ranges with model-specific validation

• Top P Controls: Enhanced with model default information

• Model Discovery Options: Automatic updates, manual refresh, and cache management

• Retry Configuration: API failure handling and backoff settings

  Improved User Experience

• Responsive Sliders: Immediate visual feedback while validation happens in background

• Smart Defaults: Better default values based on actual model capabilities

• Contextual Help: Descriptions show actual ranges and explain parameter effects

  🔄 Migration Notes

• Automatic Migration: Existing settings are automatically updated to work with new parameter ranges

• Backward Compatibility: All existing functionality preserved with enhanced capabilities

• No Breaking Changes: Plugin continues to work with existing configurations

  🎨 UI Improvements

• Cleaner Interface: Main settings focus on essential configuration

• Progressive Disclosure: Advanced options revealed only when needed

• Better Information Density: More informative descriptions without overwhelming basic users

• Consistent Styling: Improved visual hierarchy and organization

  🧪 For Developers

• New Services: ParameterValidationService and enhanced ModelDiscoveryService

• Enhanced APIs: Better model management with parameter validation capabilities

• Improved Testing: Comprehensive test coverage for new functionality

• Code Quality: Addressed performance and robustness issues identified in code review

Upgrade Instructions

1. Automatic Update: Plugin will automatically update through Obsidian's community plugins

2. New Features: Access advanced settings by clicking "Show Advanced Settings" in plugin configuration

3. Model Discovery: Enable automatic model discovery for the latest parameter ranges

4. Documentation: Visit the new docs/advanced-settings-guide.md for detailed configuration instructions

   What's Next

   This release establishes the foundation for more advanced AI parameter controls and model management. Future releases will build on this architecture to provide even more
   sophisticated AI interaction capabilities.

Thank you to all users who provided feedback and helped test these new features!