janito 2.21.0__tar.gz → 2.24.0__tar.gz

{janito-2.21.0 → janito-2.24.0}/CHANGELOG.md

@@ -344,3 +344,73 @@ All notable changes to this project will be documented in this file.
 ---
 
 *Older changes may not be listed.*
+# Changelog v2.23.0
+
+## [2.23.0] - 2025-08-14
+
+### Added
+
+- **Remote Plugin Repository Support**: Added comprehensive support for loading plugins from the official `ikignosis/janito-plugins` repository
+  - **Automatic Discovery**: Plugins can be automatically discovered and loaded from remote GitHub repository
+  - **Configuration Management**: New configuration options for remote plugin management
+  - **Security Features**: Built-in verification and sandboxing for remote plugins
+  - **Update Mechanism**: Automatic and manual update capabilities for remote plugins
+
+- **Plugin System Enhancements**:
+  - **Plugin Categories**: Official and community plugin categorization
+  - **Configuration Schemas**: JSON schema validation for plugin configuration
+  - **Hot Loading**: Dynamic plugin loading/unloading without restart
+  - **CLI Integration**: New commands for plugin management (`--list-remote-plugins`, `--update-remote-plugins`)
+
+- **Documentation**: Comprehensive guides for remote plugin usage
+  - [Remote Plugins Guide](docs/guides/remote-plugins.md) - Complete documentation for remote plugin usage
+  - Updated [Plugin System Guide](docs/guides/plugins.md) with remote plugin integration
+  - Enhanced [README-PLUGINS.md](README-PLUGINS.md) with remote repository references
+
+### Changed
+
+- **Plugin Discovery**: Enhanced plugin discovery system to support both local and remote sources
+- **Configuration Format**: Extended `janito.json` to support remote plugin configuration
+- **CLI Interface**: Added new plugin management commands and improved existing ones
+
+### Security
+
+- **Repository Verification**: Added verification for remote plugin sources
+- **Access Control**: Implemented proper access controls for remote plugin loading
+- **Configuration Validation**: Enhanced validation for plugin configuration parameters
+
+### Developer Experience
+
+- **Plugin Templates**: Added example plugin structure in `plugins/example_plugin.py`
+- **Testing Framework**: Comprehensive test suite for plugin system in `tests/test_plugin_system.py`
+- **Documentation**: Detailed API documentation and usage examples
+
+### Migration Guide
+
+For users upgrading from previous versions:
+
+1. **Configuration Update**: Add remote plugin configuration to `janito.json`:
+   ```json
+   {
+     "plugins": {
+       "remote": {
+         "enabled": true,
+         "repository": "https://github.com/ikignosis/janito-plugins.git"
+       }
+     }
+   }
+   ```
+
+2. **Plugin Discovery**: Existing local plugins continue to work unchanged
+3. **CLI Commands**: New commands are backward compatible with existing usage
+
+### Contributors
+
+- Enhanced plugin system architecture
+- Added remote repository integration
+- Improved documentation and examples
+- Strengthened security and validation features
+
+---
+
+**Full Changelog**: https://github.com/ikignosis/janito/compare/v2.22.0...v2.23.0

janito-2.24.0/CHANGELOG_2.23.0.md

@@ -0,0 +1,70 @@
+# Changelog v2.23.0
+
+## [2.23.0] - 2025-08-14
+
+### Added
+
+- **Remote Plugin Repository Support**: Added comprehensive support for loading plugins from the official `ikignosis/janito-plugins` repository
+  - **Automatic Discovery**: Plugins can be automatically discovered and loaded from remote GitHub repository
+  - **Configuration Management**: New configuration options for remote plugin management
+  - **Security Features**: Built-in verification and sandboxing for remote plugins
+  - **Update Mechanism**: Automatic and manual update capabilities for remote plugins
+
+- **Plugin System Enhancements**:
+  - **Plugin Categories**: Official and community plugin categorization
+  - **Configuration Schemas**: JSON schema validation for plugin configuration
+  - **Hot Loading**: Dynamic plugin loading/unloading without restart
+  - **CLI Integration**: New commands for plugin management (`--list-remote-plugins`, `--update-remote-plugins`)
+
+- **Documentation**: Comprehensive guides for remote plugin usage
+  - [Remote Plugins Guide](docs/guides/remote-plugins.md) - Complete documentation for remote plugin usage
+  - Updated [Plugin System Guide](docs/guides/plugins.md) with remote plugin integration
+  - Enhanced [README-PLUGINS.md](README-PLUGINS.md) with remote repository references
+
+### Changed
+
+- **Plugin Discovery**: Enhanced plugin discovery system to support both local and remote sources
+- **Configuration Format**: Extended `janito.json` to support remote plugin configuration
+- **CLI Interface**: Added new plugin management commands and improved existing ones
+
+### Security
+
+- **Repository Verification**: Added verification for remote plugin sources
+- **Access Control**: Implemented proper access controls for remote plugin loading
+- **Configuration Validation**: Enhanced validation for plugin configuration parameters
+
+### Developer Experience
+
+- **Plugin Templates**: Added example plugin structure in `plugins/example_plugin.py`
+- **Testing Framework**: Comprehensive test suite for plugin system in `tests/test_plugin_system.py`
+- **Documentation**: Detailed API documentation and usage examples
+
+### Migration Guide
+
+For users upgrading from previous versions:
+
+1. **Configuration Update**: Add remote plugin configuration to `janito.json`:
+   ```json
+   {
+     "plugins": {
+       "remote": {
+         "enabled": true,
+         "repository": "https://github.com/ikignosis/janito-plugins.git"
+       }
+     }
+   }
+   ```
+
+2. **Plugin Discovery**: Existing local plugins continue to work unchanged
+3. **CLI Commands**: New commands are backward compatible with existing usage
+
+### Contributors
+
+- Enhanced plugin system architecture
+- Added remote repository integration
+- Improved documentation and examples
+- Strengthened security and validation features
+
+---
+
+**Full Changelog**: https://github.com/ikignosis/janito/compare/v2.22.0...v2.23.0

janito-2.24.0/MARKET_ANALYST_README.md

@@ -0,0 +1,97 @@
+# Janito Market Analyst Profile
+
+## Overview
+The Market Analyst profile in janito provides comprehensive financial market analysis capabilities, including stock recommendations, technical analysis, and trading strategies.
+
+## Usage
+
+### Command Line
+```bash
+# Use Market Analyst profile
+janito --market "Analyze AAPL stock"
+
+# Or explicitly specify profile
+janito --profile "Market Analyst" "List top tech stocks to buy"
+```
+
+### Interactive Mode
+```bash
+# Start interactive chat with Market Analyst profile
+janito --market
+
+# Then ask questions like:
+# "What are the best NASDAQ stocks to sell tomorrow?"
+# "Analyze TSLA technical indicators"
+# "Provide options strategy for NVDA earnings"
+```
+
+## Capabilities
+
+### Technical Analysis
+- **Indicators**: RSI, MACD, Bollinger Bands, VWAP, Moving averages
+- **Patterns**: Head & shoulders, triangles, flags, support/resistance levels
+- **Volume Analysis**: OBV, volume profile, accumulation/distribution
+- **Multi-timeframe**: Daily, 4-hour, 15-minute analysis
+
+### Fundamental Analysis
+- **Valuation Metrics**: P/E, EV/EBITDA, P/S, P/B ratios
+- **Growth Analysis**: EPS revisions, revenue growth trends
+- **Financial Health**: Debt ratios, cash flow analysis, ROIC
+- **DCF Modeling**: 2-stage and 3-stage models
+
+### Sentiment & Flow Analysis
+- **Analyst Sentiment**: EPS revisions, price target changes
+- **Options Flow**: Put/call ratios, unusual activity, implied volatility
+- **Institutional Flows**: 13F changes, short interest, ETF flows
+- **Retail Sentiment**: Social media trends, Google search data
+
+### Risk Management
+- **Position Sizing**: Kelly criterion, fixed fractional risk
+- **Stop Loss**: ATR-based, structure-based stops
+- **Options Strategies**: Vertical spreads, straddles, strangles
+- **Portfolio Management**: Correlation analysis, beta adjustment
+
+## Example Queries
+
+### Stock Analysis
+```
+"Analyze TSLA with technical and fundamental view"
+"Compare NVDA vs AMD valuation metrics"
+"What are the key risks for AAPL in Q3?"
+```
+
+### Market Timing
+```
+"Best NASDAQ stocks to sell tomorrow based on technicals"
+"Which tech stocks are showing bearish divergence?"
+"Identify oversold stocks in the S&P 500"
+```
+
+### Strategy Development
+```
+"Create a pairs trading strategy for FAANG stocks"
+"Design an options strategy for earnings season"
+"Build a momentum screening system"
+```
+
+## Data Sources
+The Market Analyst uses publicly available data and standard analytical frameworks. No real-time brokerage feeds or proprietary data is accessed.
+
+## Important Disclaimer
+This tool provides analytical insights for educational and research purposes. It does not provide personalized investment advice. Always conduct your own due diligence and consult with qualified financial professionals before making investment decisions.
+
+## Troubleshooting
+
+### Profile Not Found
+If you see "Could not find profile 'Market Analyst'", ensure you're using the correct syntax:
+```bash
+janito --profile "Market Analyst" "your query"
+# or
+janito --market "your query"
+```
+
+### Permission Issues
+For full functionality, ensure read permissions are enabled:
+```bash
+janito --read --market "analyze stock data"
+```

{janito-2.21.0/janito.egg-info → janito-2.24.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: janito
-Version: 2.21.0
+Version: 2.24.0
 Summary: A new Python package called janito.
 Author-email: João Pinto <janito@ikignosis.org>
 Project-URL: Homepage, https://github.com/ikignosis/janito

janito-2.24.0/README-PLUGINS.md

@@ -0,0 +1,68 @@
+# Janito Plugin System
+
+A flexible plugin system for extending janito's functionality.
+
+## Quick Start
+
+1. **Create a plugin:**
+   ```python
+   # plugins/hello_plugin.py
+   from janito.plugins.base import Plugin, PluginMetadata
+   from janito.tools.tool_base import ToolBase, ToolPermissions
+
+   class HelloTool(ToolBase):
+       tool_name = "hello"
+       permissions = ToolPermissions(read=True, write=False, execute=True)
+       
+       def run(self, name="World"):
+           return f"Hello, {name}!"
+
+   class HelloPlugin(Plugin):
+       def get_metadata(self):
+           return PluginMetadata(
+               name="hello",
+               version="1.0.0",
+               description="A simple greeting plugin",
+               author="You"
+           )
+       
+       def get_tools(self):
+           return [HelloTool]
+   ```
+
+2. **Enable the plugin:**
+   ```json
+   // janito.json
+   {
+     "plugins": {
+       "load": {
+         "hello": true
+       }
+     }
+   }
+   ```
+
+3. **Use the plugin:**
+   ```bash
+   janito --list-plugins
+   janito "Use the hello tool to greet Alice"
+   ```
+
+## Features
+
+- **Dynamic Tool Registration**: Add new tools without modifying core code
+- **Configuration Support**: Plugins can accept runtime configuration
+- **Hot Loading**: Load/unload plugins at runtime
+- **Multiple Sources**: Load from files, directories, or installed packages
+- **Validation**: Built-in configuration validation and error handling
+
+## Documentation
+
+- [Plugin System Guide](docs/guides/plugins.md) - Complete documentation
+- [Remote Plugins Guide](docs/guides/remote-plugins.md) - Using plugins from remote repositories
+- [Example Plugin](plugins/example_plugin.py) - Working example
+- [API Reference](docs/reference/plugins.md) - Technical details
+
+## Development
+
+See `tests/test_plugin_system.py` for comprehensive test examples.

janito-2.24.0/RELEASE_COMPARISON.md

@@ -0,0 +1,118 @@
+# Janito Release Comparison: v2.21.0 vs v2.22.0
+
+## 📊 Side-by-Side Overview
+
+| Aspect | v2.21.0 | v2.22.0 |
+|--------|---------|---------|
+| **Release Date** | August 12, 2025 | August 14, 2025 |
+| **Primary Focus** | IBM WatsonX Provider Foundation | IBM WatsonX Enhancement + Market Analysis |
+| **New Providers** | IBM WatsonX (initial) | IBM WatsonX (enhanced) |
+| **New Profiles** | - | Market Analyst Profile |
+| **Documentation** | Basic IBM setup | Comprehensive guides + market data |
+
+## 🚀 Feature Comparison
+
+### New Features
+
+#### v2.21.0
+- **IBM WatsonX Provider**: Initial implementation with basic Granite, Llama, and Mistral models
+- **Enhanced fetch_url**: Added configurable limits (max_length, max_lines, context_chars)
+- **Environment Variables**: Added examples for all providers
+- **Model Lists**: Updated OpenAI, Anthropic, and Google provider models
+
+#### v2.22.0
+- **IBM WatsonX Enhancement**: Complete provider with enterprise-grade models
+- **Market Analyst Profile**: Specialized for financial analysis workflows
+- **Enhanced fetch_url**: Added error caching for 403/404 responses
+- **Comprehensive Documentation**: Complete setup guides and market data sources
+
+### Documentation Improvements
+
+#### v2.21.0
+- Basic IBM WatsonX setup guide (`janito/providers/ibm/README.md`)
+- Updated GETTING_STARTED.md with IBM instructions
+- Environment variable examples
+
+#### v2.22.0
+- **New Guides**:
+  - `docs/ibm-setup.md` - Complete step-by-step IBM configuration
+  - `docs/guides/market-data-sources.md` - Public financial data sources
+  - `docs/guides/stock-market-guide.md` - Stock market analysis workflows
+  - `docs/public-sources.md` - Comprehensive public data sources
+- **Enhanced Documentation**: Updated all provider comparisons and model listings
+
+## 🔧 Technical Improvements
+
+### Code Changes
+
+#### v2.21.0
+- **Files Modified**: 9 files, +306/-36 lines
+- **Focus**: IBM provider foundation and fetch_url enhancements
+- **Complexity**: Reduced fetch_url complexity by splitting into helper methods
+
+#### v2.22.0
+- **Files Modified**: 14 files, +732/-29 lines
+- **Focus**: IBM enhancement, market analyst profile, and comprehensive documentation
+- **Bug Fixes**: Profile template path resolution
+- **Performance**: fetch_url error caching for better reliability
+
+### Provider Capabilities
+
+#### v2.21.0 IBM WatsonX
+- Basic model support (Granite, Llama, Mistral)
+- Initial configuration setup
+- Basic authentication handling
+
+#### v2.22.0 IBM WatsonX
+- **Enhanced Model Support**: IBM Granite enterprise models + open-source models
+- **Complete Setup Guide**: Step-by-step configuration with examples
+- **Enterprise Integration**: Better suited for business and financial analysis
+
+## 🎯 Usage Evolution
+
+### v2.21.0 Usage
+```bash
+# Basic IBM setup
+janito config set provider ibm
+janito config set model ibm/granite-3-8b-instruct
+```
+
+### v2.22.0 Usage
+```bash
+# Enhanced IBM setup with market analysis
+janito config set provider ibm
+janito config set model ibm/granite-3-8b-instruct
+janito --profile market_analyst "Analyze AAPL stock performance"
+```
+
+## 📈 Impact Summary
+
+### v2.21.0 Impact
+- **Foundation**: Established IBM WatsonX as a supported provider
+- **Technical**: Improved URL fetching capabilities
+- **Documentation**: Basic setup instructions
+
+### v2.22.0 Impact
+- **Specialization**: Added domain-specific profile for financial analysis
+- **Completeness**: Comprehensive IBM WatsonX integration
+- **Usability**: Rich documentation for market analysis workflows
+- **Reliability**: Enhanced error handling in URL fetching
+
+## 🔄 Migration Path
+
+Both versions are fully backward compatible. Users can upgrade seamlessly:
+
+```bash
+# From any previous version
+pip install --upgrade janito
+
+# New capabilities immediately available
+janito --profile market_analyst "help with stock analysis"
+```
+
+## 🎉 Summary
+
+- **v2.21.0**: Laid the foundation with IBM WatsonX support
+- **v2.22.0**: Built upon that foundation with specialized market analysis capabilities and comprehensive documentation
+
+The progression from v2.21.0 to v2.22.0 represents a shift from basic provider support to domain-specific specialization, making Janito more valuable for financial analysis and market research use cases.

janito-2.24.0/RELEASE_NOTES_2.22.0.md

@@ -0,0 +1,86 @@
+# Janito v2.22.0 Release Notes
+
+## 🚀 New Features
+
+### IBM WatsonX Provider Support
+- **New Provider**: Added comprehensive IBM WatsonX provider integration
+- **Model Support**: Includes IBM Granite models and various open-source models available through WatsonX
+- **Documentation**: Complete setup guide with authentication and configuration instructions
+- **Enhanced Capabilities**: Access to enterprise-grade AI models for business and financial analysis
+
+### Market Analyst Profile
+- **New Profile**: Added specialized Market Analyst profile for financial analysis workflows
+- **Financial Analysis**: Optimized for stock market analysis, financial data interpretation, and market research
+- **Data Sources**: Integrated support for public financial data sources and market APIs
+- **Templates**: Comprehensive system prompt template for market-focused conversations
+
+## 🔧 Improvements
+
+### Enhanced fetch_url Tool
+- **Error Handling**: Added intelligent error caching for 403 (Forbidden) and 404 (Not Found) responses
+- **Performance**: Reduced redundant network requests when URLs are known to be inaccessible
+- **Reliability**: Better handling of rate limiting and temporary access restrictions
+
+### Documentation Updates
+- **IBM Setup Guide**: Complete step-by-step documentation for IBM WatsonX configuration
+- **Market Data Sources**: Comprehensive guide to public financial data sources
+- **Stock Market Guide**: Detailed instructions for stock market analysis workflows
+- **Provider Platform Access**: Updated documentation covering all supported providers
+- **Portuguese Translation**: Updated README-pt.md with latest features
+
+## 🐛 Bug Fixes
+
+- **Profile Selection**: Fixed profile template path resolution in session selection
+- **Template Loading**: Improved handling of profile template paths across different environments
+
+## 📚 Documentation
+
+### New Documentation Files
+- `docs/ibm-setup.md` - Complete IBM WatsonX setup guide
+- `docs/guides/market-data-sources.md` - Public financial data sources guide
+- `docs/guides/stock-market-guide.md` - Stock market analysis workflows
+- `docs/public-sources.md` - Comprehensive public data sources documentation
+
+### Updated Documentation
+- `docs/drivers.md` - Updated with IBM WatsonX driver information
+- `docs/index.md` - Enhanced with new provider and profile information
+- `docs/provider-platform-access.md` - Updated provider comparison table
+- `docs/supported-providers-models.md` - Added IBM WatsonX model listings
+
+## 🎯 Usage Examples
+
+### IBM WatsonX Configuration
+```bash
+# Set up IBM WatsonX provider
+janito config set provider ibm
+janito config set model ibm/granite-3-8b-instruct
+janito config set api_key YOUR_IBM_API_KEY
+```
+
+### Market Analyst Profile
+```bash
+# Use the new Market Analyst profile
+janito --profile market_analyst "Analyze AAPL stock performance for Q3 2024"
+```
+
+## 🔍 Technical Details
+
+### Files Added/Modified
+- `janito/providers/ibm/model_info.py` - IBM WatsonX model definitions
+- `janito/agent/templates/profiles/system_prompt_template_market_analyst.txt.j2` - Market analyst profile template
+- `janito/cli/chat_mode/session_profile_select.py` - Fixed profile selection logic
+- `janito/tools/adapters/local/fetch_url.py` - Enhanced error handling and caching
+
+### Dependencies
+- No new dependencies added
+- Compatible with existing Janito installations
+
+## 🎉 Acknowledgments
+
+Special thanks to the community for feedback and contributions that helped shape this release, particularly around financial analysis use cases and enterprise AI integration.
+
+---
+
+**Full Changelog**: https://github.com/ikignosis/janito/compare/v2.21.0...v2.22.0
+
+**Installation**: `pip install janito==2.22.0` or `pip install --upgrade janito`

{janito-2.21.0 → janito-2.24.0}/docs/drivers.md

@@ -7,11 +7,13 @@ This document describes the architecture of the LLM driver system in Janito, foc
 All LLM drivers in Janito inherit from the abstract base class `LLMDriver` (`janito/llm/driver.py`). This class provides a threaded, queue-based interface for interacting with language model APIs in a provider-agnostic way.
 
 ### Key Responsibilities
+
 - **Threaded Operation:** Each driver runs a background thread that processes requests from an input queue and emits results/events to an output queue.
 - **Standardized Events:** Drivers emit standardized events (e.g., `RequestStarted`, `ResponseReceived`, `RequestFinished`) for downstream consumers.
 - **Provider Abstraction:** The base class defines abstract methods for provider-specific logic, ensuring a uniform interface for all drivers.
 
 ### Required Abstract Methods
+
 To implement a new driver, you must subclass `LLMDriver` and implement the following methods:
 
 - `def _prepare_api_kwargs(self, config, conversation)`
@@ -30,12 +32,14 @@ To implement a new driver, you must subclass `LLMDriver` and implement the follo
   - Extract the relevant message object from the provider's API result for further processing.
 
 ### Threading and Queues
+
 - Each driver instance has its own `input_queue` and `output_queue`.
 - Use the `start()` method to launch the driver's background thread.
 - Submit requests by putting `DriverInput` objects into `input_queue`.
 - Listen for events/results by reading from `output_queue`.
 
 ## Implementing a New Driver: Checklist
+
 1. **Subclass `LLMDriver`.**
 2. **Implement all required abstract methods** listed above.
 3. **Handle provider-specific configuration** (e.g., API keys, endpoints) in your constructor or via config objects.
@@ -45,7 +49,9 @@ To implement a new driver, you must subclass `LLMDriver` and implement the follo
 7. **Convert provider responses** to standardized message parts for downstream processing.
 
 ## Example: OpenAI Driver
+
 See `janito/drivers/openai/driver.py` for a complete example. Highlights:
+
 - Implements all required methods for the OpenAI API.
 - Handles tool/function call schemas if tools are present.
 - Converts conversation history to OpenAI's message format.
@@ -53,7 +59,8 @@ See `janito/drivers/openai/driver.py` for a complete example. Highlights:
 - Handles cancellation and error reporting robustly.
 
 ## References
-- Base class: [`janito/llm/driver.py`](git@github.com:ikignosis/janito.git/tree/main/janito/llm/driver.py)
-- OpenAI driver: [`janito/drivers/openai/driver.py`](git@github.com:ikignosis/janito.git/tree/main/janito/drivers/openai/driver.py)
-- Driver events: [`janito/driver_events.py`](git@github.com:ikignosis/janito.git/tree/main/janito/driver_events.py)
+
+- Base class: `janito/llm/driver.py`
+- OpenAI driver: `janito/drivers/openai/driver.py`
+- Driver events: `janito/driver_events.py`