janito 2.32.0__tar.gz → 3.0.0__tar.gz

{janito-2.32.0 → janito-3.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: janito
-Version: 2.32.0
+Version: 3.0.0
 Summary: A new Python package called janito.
 Author-email: João Pinto <janito@ikignosis.org>
 Project-URL: Homepage, https://github.com/ikignosis/janito
@@ -30,7 +30,6 @@ Requires-Dist: black; extra == "dev"
 Requires-Dist: questionary>=2.0.1; extra == "dev"
 Requires-Dist: setuptools_scm>=8.0; extra == "dev"
 Provides-Extra: coder
-Requires-Dist: janito-coder; extra == "coder"
 Dynamic: license-file
 
 # nctl

janito-3.0.0/docs/CHANGELOG.md

@@ -0,0 +1,133 @@
+# 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.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.0.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.0.0/init_janito_tools.py

@@ -0,0 +1,51 @@
+#!/usr/bin/env python3
+"""
+Initialize janito tools for CLI usage.
+
+This script loads all core plugins and registers their tools
+with the local tools adapter.
+"""
+
+import sys
+import os
+from pathlib import Path
+
+# Add current directory to path
+sys.path.insert(0, str(Path.cwd()))
+
+from janito.plugins.core_loader_fixed import load_core_plugin
+from janito.tools.adapters.local.adapter import LocalToolsAdapter
+
+
+def init_janito_tools():
+    """Initialize all janito tools for CLI usage."""
+    adapter = LocalToolsAdapter()
+
+    # Core plugins to load
+    core_plugins = [
+        "core.filemanager",
+        "core.codeanalyzer",
+        "core.system",
+        "core.imagedisplay",
+        "dev.pythondev",
+        "dev.visualization",
+    ]
+
+    loaded = 0
+    for plugin_name in core_plugins:
+        plugin = load_core_plugin(plugin_name)
+        if plugin:
+            tools = plugin.get_tools()
+            for tool_class in tools:
+                adapter.register_tool(tool_class)
+                loaded += 1
+
+    return adapter, loaded
+
+
+if __name__ == "__main__":
+    adapter, count = init_janito_tools()
+    print(f"Initialized {count} tools")
+    print("Available tools:")
+    for tool_name in sorted(list(adapter._tools.keys())):
+        print(f"  - {tool_name}")

{janito-2.32.0 → janito-3.0.0}/janito/agent/setup_agent.py

@@ -155,6 +155,32 @@ def _prepare_template_context(role, profile, allowed_permissions, args=None):
         getattr(args, "emoji", False) if "args" in locals() else False
     )
 
+    # Add current date/time with timezone using standard library
+    from datetime import datetime, timezone
+    import time
+
+    # Get local time with timezone info
+    local_time = datetime.now()
+
+    # Get timezone offset
+    if time.daylight:
+        offset = time.altzone
+    else:
+        offset = time.timezone
+
+    # Format offset as +HHMM or -HHMM
+    offset_hours = -offset // 3600
+    offset_minutes = abs(offset) % 3600 // 60
+    offset_str = f"{offset_hours:+03d}{offset_minutes:02d}"
+
+    # Get timezone name
+    tz_name = time.tzname[time.daylight and time.daylight or 0]
+
+    context["current_datetime"] = local_time.strftime(
+        f"%Y-%m-%d %H:%M:%S {tz_name}{offset_str}"
+    )
+    context["timezone"] = f"{tz_name} (UTC{offset_str})"
+
     return context
 
 

{janito-2.32.0 → janito-3.0.0}/janito/agent/templates/profiles/system_prompt_template_Developer_with_Python_Tools.txt.j2

@@ -4,6 +4,8 @@
 {% if description %}Description: {{ description }}{% endif %}
 {% if author %}Author: {{ author }}{% endif %}
 {% if tags %}Tags: {{ tags | join(', ') }}{% endif %}
+{% if current_datetime %}Current Date/Time: {{ current_datetime }}{% endif %}
+{% if timezone %}Timezone: {{ timezone }}{% endif %}
 
 {# General role setup
   ex. "Search in code" -> Python Developer -> find(*.py) | Java Developer -> find(*.java)

{janito-2.32.0 → janito-3.0.0}/janito/agent/templates/profiles/system_prompt_template_developer.txt.j2

@@ -4,6 +4,8 @@
 {% if description %}Description: {{ description }}{% endif %}
 {% if author %}Author: {{ author }}{% endif %}
 {% if tags %}Tags: {{ tags | join(', ') }}{% endif %}
+{% if current_datetime %}Current Date/Time: {{ current_datetime }}{% endif %}
+{% if timezone %}Timezone: {{ timezone }}{% endif %}
 
 You are: {{ role | default('software developer') }}
 

{janito-2.32.0 → janito-3.0.0}/janito/agent/templates/profiles/system_prompt_template_market_analyst.txt.j2

@@ -4,6 +4,8 @@
 {% if description %}Description: {{ description }}{% endif %}
 {% if author %}Author: {{ author }}{% endif %}
 {% if tags %}Tags: {{ tags | join(', ') }}{% endif %}
+{% if current_datetime %}Current Date/Time: {{ current_datetime }}{% endif %}
+{% if timezone %}Timezone: {{ timezone }}{% endif %}
 
 You are: {{ role | default('market analyst specializing in financial markets, business intelligence, and economic research') }}
 

{janito-2.32.0 → janito-3.0.0}/janito/agent/templates/profiles/system_prompt_template_model_conversation_without_tools_or_context.txt.j2

@@ -4,6 +4,8 @@
 {% if description %}Description: {{ description }}{% endif %}
 {% if author %}Author: {{ author }}{% endif %}
 {% if tags %}Tags: {{ tags | join(', ') }}{% endif %}
+{% if current_datetime %}Current Date/Time: {{ current_datetime }}{% endif %}
+{% if timezone %}Timezone: {{ timezone }}{% endif %}
 
 You are: {{ role | default('helpful assistant') }}
 

janito-3.0.0/janito/cli/cli_commands/check_tools.py

@@ -0,0 +1,212 @@
+"""
+CLI Command: Check all registered tools for signature validation and availability
+"""
+
+import inspect
+import sys
+from typing import Dict, List, Tuple, Any
+
+
+def _validate_tool_signature(tool_instance) -> Tuple[bool, List[str]]:
+    """Validate the signature of a tool's run method."""
+    errors = []
+
+    if not hasattr(tool_instance, "run"):
+        errors.append("Missing 'run' method")
+        return False, errors
+
+    try:
+        sig = inspect.signature(tool_instance.run)
+    except ValueError as e:
+        errors.append(f"Invalid signature: {e}")
+        return False, errors
+
+    # Basic signature validation - just check if it's callable
+    if not callable(getattr(tool_instance, "run")):
+        errors.append("'run' method is not callable")
+
+    return len(errors) == 0, errors
+
+
+def _check_tool_availability(tool_instance) -> Tuple[bool, List[str]]:
+    """Check if a tool is available for use."""
+    errors = []
+
+    # Check if tool has required attributes
+    required_attrs = ["tool_name"]
+    for attr in required_attrs:
+        if not hasattr(tool_instance, attr):
+            errors.append(f"Missing required attribute: {attr}")
+
+    # Check description (optional for now)
+    if not hasattr(tool_instance, "description"):
+        pass  # Allow missing description
+
+    # Check permissions
+    if not hasattr(tool_instance, "permissions"):
+        # Function-based tools use permissions from function decorators
+        pass  # Allow missing permissions for function-based tools
+    else:
+        perms = tool_instance.permissions
+        if (
+            not hasattr(perms, "read")
+            or not hasattr(perms, "write")
+            or not hasattr(perms, "execute")
+        ):
+            errors.append("Invalid permissions structure")
+
+    return len(errors) == 0, errors
+
+
+def _get_tool_status_summary(
+    tools: List[Any], disabled_tools: List[str]
+) -> Dict[str, Any]:
+    """Get a comprehensive status summary for all tools."""
+    summary = {
+        "total": len(tools),
+        "available": 0,
+        "disabled": 0,
+        "invalid": 0,
+        "details": [],
+    }
+
+    for tool in tools:
+        tool_name = getattr(tool, "tool_name", str(tool))
+
+        # Check if disabled
+        is_disabled = tool_name in disabled_tools
+
+        # Validate signature and availability
+        sig_valid, sig_errors = _validate_tool_signature(tool)
+        avail_valid, avail_errors = _check_tool_availability(tool)
+
+        status = {
+            "name": tool_name,
+            "disabled": is_disabled,
+            "signature_valid": sig_valid,
+            "available": avail_valid,
+            "signature_errors": sig_errors,
+            "availability_errors": avail_errors,
+        }
+
+        summary["details"].append(status)
+
+        if is_disabled:
+            summary["disabled"] += 1
+        elif not sig_valid or not avail_valid:
+            summary["invalid"] += 1
+        else:
+            summary["available"] += 1
+
+    return summary
+
+
+def _print_check_results(console, summary: Dict[str, Any], verbose: bool = False):
+    """Print the tool check results in a formatted way."""
+    from rich.table import Table
+    from rich.panel import Panel
+    from rich.text import Text
+
+    # Overall summary
+    summary_text = Text()
+    summary_text.append(f"Total tools: {summary['total']}", style="cyan")
+    summary_text.append(" | ")
+    summary_text.append(f"Available: {summary['available']}", style="green")
+    summary_text.append(" | ")
+    summary_text.append(f"Disabled: {summary['disabled']}", style="yellow")
+    summary_text.append(" | ")
+    summary_text.append(f"Invalid: {summary['invalid']}", style="red")
+
+    console.print(Panel(summary_text, title="Tool Check Summary", style="bold"))
+
+    # Always show the table for check-tools
+    table = Table(title="Tool Details", show_header=True, header_style="bold")
+    table.add_column("Tool", style="cyan", no_wrap=True)
+    table.add_column("Status", style="green")
+    table.add_column("Issues", style="red")
+
+    for detail in summary["details"]:
+        name = detail["name"]
+
+        if detail["disabled"]:
+            status = "[yellow]Disabled[/yellow]"
+            issues = "-"
+        elif not detail["available"] or not detail["signature_valid"]:
+            status = "[red]Invalid[/red]"
+            all_issues = detail["signature_errors"] + detail["availability_errors"]
+            issues = "\n".join(all_issues)
+        else:
+            status = "[green]Available[/green]"
+            issues = "-"
+
+        table.add_row(name, status, issues)
+
+    console.print(table)
+
+
+def handle_check_tools(args=None):
+    """Handle the --check-tools CLI command."""
+    from janito.tools.adapters.local.adapter import LocalToolsAdapter
+    import janito.tools  # Ensure all tools are registered
+
+    # Load disabled tools from config
+    from janito.tools.disabled_tools import DisabledToolsState
+    from janito.config import config
+
+    disabled_str = config.get("disabled_tools", "")
+    if disabled_str:
+        DisabledToolsState.set_disabled_tools(disabled_str)
+    disabled_tools = DisabledToolsState.get_disabled_tools()
+
+    # Initialize tools properly using the same approach as list_tools.py
+    from janito.tools.adapters.local.adapter import LocalToolsAdapter
+    from janito.tools.tool_base import ToolPermissions
+    import janito.tools  # Ensure all tools are registered
+
+    read = getattr(args, "read", False) if args else False
+    write = getattr(args, "write", False) if args else False
+    execute = getattr(args, "exec", False) if args else False
+    if not (read or write or execute):
+        read = write = execute = True
+    from janito.tools.permissions import set_global_allowed_permissions
+
+    set_global_allowed_permissions(
+        ToolPermissions(read=read, write=write, execute=execute)
+    )
+
+    # Load disabled tools from config
+    from janito.tools.disabled_tools import DisabledToolsState
+    from janito.config import config
+
+    disabled_str = config.get("disabled_tools", "")
+    if disabled_str:
+        DisabledToolsState.set_disabled_tools(disabled_str)
+    disabled_tools = DisabledToolsState.get_disabled_tools()
+
+    # Initialize tools using the same method as list_tools.py
+    from janito.tools.initialize import initialize_tools
+
+    registry = initialize_tools()
+
+    # Get actual tool instances
+    tool_instances = []
+    for name, tool_info in registry._tools.items():
+        if "instance" in tool_info:
+            tool_instances.append(tool_info["instance"])
+
+    if not tool_instances:
+        print("No tools registered.")
+        return
+
+    from rich.console import Console
+
+    console = Console()
+
+    verbose = getattr(args, "verbose", False) if args else False
+
+    summary = _get_tool_status_summary(tool_instances, disabled_tools)
+    _print_check_results(console, summary, verbose=verbose)
+
+    # Exit with error code if there are invalid tools
+    if summary["invalid"] > 0:
+        sys.exit(1)