janito 3.3.0__tar.gz → 3.5.0__tar.gz

janito-3.5.0/ANNOUNCEMENT_v3.1.0.md

@@ -0,0 +1,63 @@
+# 🚀 Janito v3.1.0 Released - Enter Key Cancellation for Chat Mode
+
+**Release Date:** August 23, 2025  
+**Version:** v3.1.0  
+**PyPI:** [janito 3.1.0](https://pypi.org/project/janito/3.1.0/)
+
+## 🎯 What's New
+
+### Instant Request Cancellation in Chat Mode
+
+Say goodbye to waiting for stuck LLM requests! Janito v3.1.0 introduces **Enter key cancellation support** for interactive chat mode.
+
+#### ✨ Key Features
+- **Press Enter to Cancel**: Instantly cancel any running request with a single key press
+- **Real-time Feedback**: Clear visual confirmation when cancellation occurs
+- **Clean Recovery**: Session remains active and ready for your next prompt
+- **Cross-Platform**: Works seamlessly across all supported platforms
+
+#### 🎮 How to Use
+1. Start chat mode: `janito`
+2. Submit any prompt
+3. **Press Enter** at any time to cancel the current request
+4. See immediate confirmation: "Request cancelled by Enter key"
+5. Continue chatting without interruption
+
+## 📦 Installation & Upgrade
+
+```bash
+# New installation
+pip install janito==3.1.0
+
+# Upgrade existing installation
+pip install --upgrade janito
+```
+
+## 🔧 Technical Highlights
+
+- **Global Cancellation Manager**: Robust cross-component cancellation system
+- **Thread-Safe**: Safe cancellation across async operations
+- **Backward Compatible**: All existing functionality preserved
+- **Clean Architecture**: Extensible design for future enhancements
+
+## 📚 Documentation
+
+- [Full Release Notes](docs/changelogs/CHANGELOG_3.1.0.md)
+- [Updated Usage Guide](docs/guides/using.md)
+- [CLI Options Reference](docs/reference/cli-options.md)
+
+## 🌟 Try It Now
+
+Experience the improved chat mode with instant cancellation:
+
+```bash
+janito
+# Then try: "Write a comprehensive analysis of quantum computing applications"
+# Press Enter anytime to cancel if needed!
+```
+
+---
+
+**Happy coding!** 🎉
+
+*Join our community for support and discussions.*

janito-3.5.0/PKG-INFO

@@ -0,0 +1,229 @@
+Metadata-Version: 2.4
+Name: janito
+Version: 3.5.0
+Summary: A new Python package called janito.
+Author-email: João Pinto <janito@ikignosis.org>
+Project-URL: Homepage, https://github.com/ikignosis/janito
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: attrs==25.3.0
+Requires-Dist: rich==14.0.0
+Requires-Dist: pathspec==0.12.1
+Requires-Dist: setuptools>=61.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: jinja2>=3.0.0
+Requires-Dist: prompt_toolkit>=3.0.51
+Requires-Dist: lxml>=5.4.0
+Requires-Dist: requests>=2.32.4
+Requires-Dist: bs4>=0.0.2
+Requires-Dist: questionary>=2.0.1
+Requires-Dist: openai>=1.68.0
+Requires-Dist: Pillow>=10.0.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: ruff==0.11.9; extra == "dev"
+Requires-Dist: detect-secrets==1.4.0; extra == "dev"
+Requires-Dist: codespell==2.4.1; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: questionary>=2.0.1; extra == "dev"
+Requires-Dist: setuptools_scm>=8.0; extra == "dev"
+Provides-Extra: coder
+Dynamic: license-file
+
+# Janito CLI
+
+A powerful command-line tool for running LLM-powered workflows with built-in tool execution capabilities.
+
+## Quick Start
+
+### Installation
+
+```bash
+pip install janito
+```
+
+### First-Time Setup
+
+1. **Get your API key**: Sign up at [Moonshot AI](https://platform.moonshot.cn/) and get your API key
+2. **Set your API key**:
+   ```bash
+   janito --set-api-key YOUR_MOONSHOT_API_KEY -p moonshot
+   ```
+
+### Basic Usage
+
+**Moonshot (Recommended - Default Provider)**
+```bash
+# Using the default provider (moonshot) and model
+janito "Create a Python script that reads a CSV file"
+
+# Using a specific Moonshot model
+janito -m kimi-k1-8k "Explain quantum computing"
+```
+
+**Other Providers**
+```bash
+# OpenAI
+janito -p openai -m gpt-4 "Write a React component"
+
+# Anthropic
+janito -p anthropic -m claude-3-5-sonnet-20241022 "Analyze this code"
+
+# Google
+janito -p google -m gemini-2.0-flash-exp "Generate unit tests"
+```
+
+### Interactive Chat Mode
+
+Start an interactive session (default mode):
+```bash
+janito
+```
+
+Or explicitly:
+```bash
+janito --chat
+```
+
+In chat mode, you can:
+
+- Have multi-turn conversations
+- Execute code and commands
+- Read and write files
+- Use built-in tools
+
+### Available Commands
+
+- `janito --list-providers` - List all supported providers
+- `janito --list-models` - List all available models
+- `janito --list-tools` - List available tools
+- `janito --show-config` - Show current configuration
+
+### Configuration
+
+Set default provider and model:
+```bash
+janito --set provider=moonshot
+janito --set model=kimi-k1-8k
+```
+
+## Providers
+
+### Moonshot (Recommended)
+
+- **Models**: kimi-k1-8k, kimi-k1-32k, kimi-k1-128k, kimi-k2-turbo-preview
+- **Strengths**: Excellent Chinese/English support, competitive pricing, fast responses
+- **Setup**: Get API key from [Moonshot AI Platform](https://platform.moonshot.cn/)
+
+### OpenAI
+
+- **Models**: gpt-5, gpt-4.1, gpt-4o, gpt-4-turbo, gpt-3.5-turbo
+- **Setup**: Get API key from [OpenAI Platform](https://platform.openai.com/)
+
+### Anthropic
+
+- **Models**: claude-3-7-sonnet-20250219, claude-3-5-sonnet-20241022, claude-3-opus-20250514
+- **Setup**: Get API key from [Anthropic Console](https://console.anthropic.com/)
+
+### IBM WatsonX
+
+- **Models**: ibm/granite-3-8b-instruct, ibm/granite-3-2b-instruct, meta-llama/llama-3-1-8b-instruct, meta-llama/llama-3-1-70b-instruct, mistralai/mistral-large
+- **Strengths**: Enterprise-grade AI, IBM Granite models, hosted Llama and Mistral models
+- **Setup**: Get API key and project ID from [IBM Cloud](https://cloud.ibm.com/)
+
+### Google
+
+- **Models**: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-lite-preview-06-17
+- **Setup**: Get API key from [Google AI Studio](https://makersuite.google.com/)
+
+## Advanced Features
+
+### 🚀 New in v3.1.0: Enter Key Cancellation
+**Chat Mode Enhancement**: Press **Enter** at any time to instantly cancel long-running requests in interactive chat mode. No more waiting for stuck requests!
+
+### Tool Usage
+
+Janito includes powerful built-in tools for:
+
+- File operations (read, write, search)
+- Code execution
+- Web scraping
+- System commands
+- And more...
+
+### Profiles
+Use predefined system prompts:
+```bash
+janito --developer "Create a REST API"  # Same as --profile developer
+janito --market "Analyze market trends"   # Same as --profile market-analyst
+```
+
+### Environment Variables
+You can also configure via environment variables:
+
+**Moonshot:**
+```bash
+export MOONSHOT_API_KEY=your_key_here
+export JANITO_PROVIDER=moonshot
+export JANITO_MODEL=kimi-k1-8k
+```
+
+**OpenAI:**
+```bash
+export OPENAI_API_KEY=your_key_here
+export JANITO_PROVIDER=openai
+export JANITO_MODEL=gpt-5
+```
+
+**IBM WatsonX:**
+```bash
+export WATSONX_API_KEY=your_key_here
+export WATSONX_PROJECT_ID=your_project_id
+export WATSONX_SPACE_ID=your_space_id  # optional
+export JANITO_PROVIDER=ibm
+export JANITO_MODEL=ibm/granite-3-8b-instruct
+```
+
+**Anthropic:**
+```bash
+export ANTHROPIC_API_KEY=your_key_here
+export JANITO_PROVIDER=anthropic
+export JANITO_MODEL=claude-3-7-sonnet-20250219
+```
+
+**Google:**
+```bash
+export GOOGLE_API_KEY=your_key_here
+export JANITO_PROVIDER=google
+export JANITO_MODEL=gemini-2.5-flash
+```
+
+## Examples
+
+### Code Generation
+```bash
+janito "Create a Python FastAPI application with user authentication"
+```
+
+### File Analysis
+```bash
+janito "Analyze the performance bottlenecks in my_app.py"
+```
+
+### Data Processing
+```bash
+janito "Process this CSV file and generate summary statistics"
+```
+
+### Web Development
+```bash
+janito "Create a responsive landing page with Tailwind CSS"
+```
+
+## Support
+
+- **Documentation**: Check individual provider directories for detailed setup guides
+- **Issues**: Report bugs and feature requests on GitHub
+- **Discord**: Join our community for help and discussions

{janito-3.3.0/janito → janito-3.5.0}/README.md

@@ -106,6 +106,9 @@ janito --set model=kimi-k1-8k
 
 ## Advanced Features
 
+### 🚀 New in v3.1.0: Enter Key Cancellation
+**Chat Mode Enhancement**: Press **Enter** at any time to instantly cancel long-running requests in interactive chat mode. No more waiting for stuck requests!
+
 ### Tool Usage
 
 Janito includes powerful built-in tools for:

janito-3.5.0/docs/CHANGELOG.md

@@ -0,0 +1,178 @@
+# Changelog
+
+All notable changes to Janito will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+### Changed
+
+### Deprecated
+
+### Removed
+
+### Fixed
+
+### Security
+
+## [3.5.0] - 2025-08-28
+
+### Added
+
+- **Live Timer Display**: Added real-time timer display while waiting for LLM responses
+  - Shows elapsed time during LLM processing
+  - Provides visual feedback for long-running requests
+  - Clean, non-intrusive display in terminal interface
+
+- **Social Media Integration**: Added comprehensive social media preview support
+  - **LinkedIn Integration**: Custom preview images and meta tags for LinkedIn sharing
+  - **Platform Support**: Enhanced meta tags for Twitter, Facebook, and other social platforms
+  - **Professional Branding**: Consistent visual identity across social media platforms
+
+- **Enhanced Documentation**: Major improvements to documentation system
+  - **Navigation Features**: Added comprehensive navigation and search capabilities
+  - **Google Integration**: Added Google site verification meta tag for better indexing
+  - **Preview Tags**: Enhanced markdown extensions with preview tag support
+  - **User Experience**: Improved documentation layout and accessibility
+
+### Changed
+
+- **Loop Protection Enhancement**: Relaxed create_file loop protection from 10 seconds to 1 hour per path
+  - **Better User Experience**: Reduced false positives for legitimate rapid file creation
+  - **Maintained Security**: Still prevents abuse while allowing normal development workflows
+  - **Configurable**: Protection adapts to actual usage patterns
+
+- **Terminal Output Cleanup**: Removed styling from stdout/stderr output in rich terminal reporter
+  - **Cleaner Output**: Plain text output for better readability and copy-paste compatibility
+  - **Tool Integration**: Improved compatibility with external tools and scripts
+  - **Consistent Formatting**: Standardized output across all terminal environments
+
+### Fixed
+
+- **Documentation Corrections**: Fixed various documentation issues and broken links
+- **Shell Command Fixes**: Updated documentation with correct shell commands and examples
+- **Thin Client Description**: Restored accurate thin client documentation
+
+### Technical Improvements
+
+- **Code Quality**: Minor cleanups and structure improvements across CLI and plugins
+- **Cancellation Handling**: Improved cancellation handling mechanisms
+- **Provider Configuration**: Updated bindings and provider configurations for latest APIs
+- **Working Directory**: Cleaned working directory before release for optimal distribution
+
+## [3.0.0] - 2025-08-23
+
+### Major Architecture Refactoring
+
+#### Plugin System Overhaul
+- **Complete plugin system redesign** with unified architecture
+- **Consolidated core plugins** into cohesive `janito/plugins/` structure
+- **Eliminated legacy loading mechanisms** (`core_loader.py`, `core_loader_fixed.py`, `base.py`)
+- **Streamlined plugin discovery** with improved initialization process
+- **Enhanced maintainability** through simplified plugin architecture
+
+#### Removed Legacy Components
+- Deleted deprecated plugin loading systems
+- Removed redundant `plugins.txt` configuration file
+- Eliminated duplicate tool adapter implementations
+- Cleaned up temporary test files (`test_core_plugins*.py`)
+
+#### Enhanced Plugin Organization
+- **Unified plugin structure** with clear module hierarchy
+- **Consolidated tool categories**:
+  - Core system tools (file operations, system commands)
+  - Development tools (Python execution, code analysis)
+  - UI tools (user interaction, visualization)
+  - Web tools (URL fetching, browser integration)
+- **Improved plugin discovery** with automatic initialization
+
+### Technical Improvements
+
+#### Code Quality
+- **Reduced complexity** through architectural simplification
+- **Eliminated code duplication** across plugin implementations
+- **Enhanced modularity** with clear separation of concerns
+- **Improved testability** with focused plugin modules
+
+#### Configuration Simplification
+- **Streamlined plugin configuration** with unified settings
+- **Simplified initialization process** for new plugins
+- **Reduced configuration overhead** for plugin developers
+
+### Breaking Changes
+
+#### Plugin System
+- **Legacy plugin loading mechanisms removed** - plugins must use new system
+- **Plugin directory structure changed** - see updated documentation
+- **Configuration format updated** - simplified plugin settings
+
+#### Removed Files
+- `plugins.txt` configuration file
+- Legacy plugin loading modules
+- Temporary test files
+- Redundant tool adapter implementations
+
+### Migration Guide
+
+#### For Plugin Developers
+1. **Update plugin structure** to match new unified architecture
+2. **Migrate configuration** to new simplified format
+3. **Test compatibility** with new plugin discovery system
+4. **Review documentation** for updated development patterns
+
+#### For Users
+1. **Update configuration files** to use new plugin system
+2. **Review plugin settings** for simplified format
+3. **Test existing workflows** with new architecture
+
+### Documentation Updates
+- **Comprehensive plugin development guide** with updated patterns
+- **Migration documentation** for legacy plugin system
+- **Enhanced API reference** with new plugin interfaces
+
+## [2.27.0] - 2025-08-22
+
+### Removed
+
+- **Breaking Change**: Removed `--role` argument and interactive profile selection
+  - The `--role` argument has been completely removed from the CLI
+  - Interactive profile selection has been removed from chat mode
+  - Use `--profile <name>` or shorthand flags like `--developer` and `--market` instead
+  - Default behavior now uses the Developer profile when no profile is specified
+
+### Changed
+
+- Updated documentation to reflect removal of role argument
+- Added comprehensive profile documentation in `PROFILES.md`
+- Simplified profile selection to use explicit flags only
+
+## [Previous Versions]
+
+### Added
+
+- Initial support for profiles and roles
+- Interactive profile selection in chat mode
+- `--role` argument for specifying developer roles
+- `--profile` argument for system prompt templates
+- `--developer` and `--market` shorthand flags
+
+### Available Profiles
+
+- **Developer**: Optimized for software development tasks
+- **Market Analyst**: Specialized for market analysis and business insights
+
+### Supported Providers
+
+- Moonshot AI (default)
+- OpenAI
+- Anthropic
+- IBM WatsonX
+- Google AI
+
+---
+
+For detailed information about profiles and their usage, see [PROFILES.md](PROFILES.md).

janito-3.5.0/docs/CHANGELOG_3.0.0.md

@@ -0,0 +1,141 @@
+# Changelog - Version 3.0.0
+
+## [3.0.0] - 2025-08-23
+
+### Major Architecture Refactoring
+
+#### Plugin System Overhaul
+- **Complete plugin system redesign** with unified architecture
+- **Consolidated core plugins** into cohesive `janito/plugins/` structure
+- **Eliminated legacy loading mechanisms** (`core_loader.py`, `core_loader_fixed.py`, `base.py`)
+- **Streamlined plugin discovery** with improved initialization process
+- **Enhanced maintainability** through simplified plugin architecture
+
+#### Removed Legacy Components
+- Deleted deprecated plugin loading systems
+- Removed redundant `plugins.txt` configuration file
+- Eliminated duplicate tool adapter implementations
+- Cleaned up temporary test files (`test_core_plugins*.py`)
+
+#### Enhanced Plugin Organization
+- **Unified plugin structure** with clear module hierarchy
+- **Consolidated tool categories**:
+  - Core system tools (file operations, system commands)
+  - Development tools (Python execution, code analysis)
+  - UI tools (user interaction, visualization)
+  - Web tools (URL fetching, browser integration)
+- **Improved plugin discovery** with automatic initialization
+
+### Technical Improvements
+
+#### Code Quality
+- **Reduced complexity** through architectural simplification
+- **Eliminated code duplication** across plugin implementations
+- **Enhanced modularity** with clear separation of concerns
+- **Improved testability** with focused plugin modules
+
+#### Configuration Simplification
+- **Streamlined plugin configuration** with unified settings
+- **Simplified initialization process** for new plugins
+- **Reduced configuration overhead** for plugin developers
+
+### Developer Experience
+
+#### Plugin Development
+- **Simplified plugin creation** with consistent patterns
+- **Clear plugin boundaries** and responsibilities
+- **Enhanced documentation** with comprehensive examples
+- **Reduced boilerplate** code for new plugins
+
+#### Migration Path
+- **Backward compatibility** maintained for existing plugins
+- **Smooth transition** from legacy plugin system
+- **Comprehensive documentation** for migration guidance
+
+### Breaking Changes
+
+#### Plugin System
+- **Legacy plugin loading mechanisms removed** - plugins must use new system
+- **Plugin directory structure changed** - see updated documentation
+- **Configuration format updated** - simplified plugin settings
+
+#### Removed Files
+- `plugins.txt` configuration file
+- Legacy plugin loading modules
+- Temporary test files
+- Redundant tool adapter implementations
+
+### Migration Guide
+
+#### For Plugin Developers
+1. **Update plugin structure** to match new unified architecture
+2. **Migrate configuration** to new simplified format
+3. **Test compatibility** with new plugin discovery system
+4. **Review documentation** for updated development patterns
+
+#### For Users
+1. **Update configuration files** to use new plugin system
+2. **Review plugin settings** for simplified format
+3. **Test existing workflows** with new architecture
+
+### Documentation Updates
+
+#### New Documentation
+- **Comprehensive plugin development guide** with updated patterns
+- **Migration documentation** for legacy plugin system
+- **Enhanced API reference** with new plugin interfaces
+- **Updated examples** demonstrating new architecture
+
+#### Updated Guides
+- **Plugin creation tutorials** with modern patterns
+- **Configuration documentation** reflecting new system
+- **Best practices** for plugin development
+
+### Performance Improvements
+
+#### Startup Time
+- **Faster plugin discovery** through optimized loading
+- **Reduced initialization overhead** with consolidated modules
+- **Improved caching** for plugin metadata
+
+#### Memory Usage
+- **Reduced memory footprint** through code consolidation
+- **Eliminated duplicate implementations** across plugins
+- **Optimized plugin loading** with lazy initialization
+
+### Security Enhancements
+
+#### Plugin Isolation
+- **Improved plugin sandboxing** with clear boundaries
+- **Enhanced security validation** for plugin loading
+- **Reduced attack surface** through simplified architecture
+
+### Future Roadmap
+
+#### Plugin Ecosystem
+- **Community plugin repository** integration planned
+- **Plugin marketplace** development in progress
+- **Advanced plugin features** for complex workflows
+
+#### Technical Enhancements
+- **Performance optimizations** for large plugin sets
+- **Advanced plugin configuration** options
+- **Plugin dependency management** improvements
+
+---
+
+## Upgrade Notes
+
+### Before Upgrading
+1. **Backup existing configuration** files
+2. **Document current plugin setup** for reference
+3. **Test critical workflows** with current version
+
+### After Upgrading
+1. **Review new plugin documentation** for updated patterns
+2. **Update configuration files** to new format
+3. **Test all plugins** for compatibility
+4. **Report any issues** to development team
+
+### Support
+- **Migration assistance** available through GitHub issues

janito-3.5.0/docs/CNAME

@@ -0,0 +1 @@
+janito.xyz

{janito-3.3.0 → janito-3.5.0}/docs/changelogs/CHANGELOG.md

@@ -517,4 +517,37 @@ For users upgrading from previous versions:
 
 ---
 
+## [3.1.0] - 2025-08-23
+
+### Added
+
+- **Enter Key Cancellation Support for Chat Mode**: Revolutionary usability improvement for interactive chat sessions
+  - **Instant Request Cancellation**: Press **Enter key** at any time to immediately cancel current LLM operations
+  - **Global Cancellation Manager**: Robust cross-component cancellation system spanning agent, driver, and prompt handler
+  - **User Feedback**: Clear visual confirmation with red "Request cancelled by Enter key" message
+  - **Clean State Management**: Automatic cleanup of cancellation state after request completion
+  - **Thread-Safe Implementation**: Safe cancellation across multiple threads and async operations
+
+### Technical Implementation
+
+- **Global Cancellation Manager**: New `janito.llm.cancellation_manager` module provides centralized cancellation handling
+- **Key Binding Integration**: Enhanced chat mode with dedicated Enter key handling for cancellation
+- **Cross-Component Support**: Cancellation signals properly propagate through entire application stack
+- **Backward Compatible**: All existing functionality preserved, cancellation is additive feature
+
+### Developer Experience
+
+- **Extensible Architecture**: Cancellation system designed for future integration with other components
+- **Clean API**: Simple interface for starting, cancelling, and clearing requests across application
+- **Comprehensive Testing**: Full test coverage for cancellation scenarios and edge cases
+
+### Documentation
+
+- Updated CLI options documentation with new cancellation behavior
+- Enhanced chat mode guides with cancellation instructions
+- Added troubleshooting section for long-running requests
+- New dedicated changelog: [CHANGELOG_3.1.0.md](../changelogs/CHANGELOG_3.1.0.md)
+
+---
+
 **Full Changelog**: https://github.com/ikignosis/janito/compare/v2.22.0...v2.23.0