minion-code 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

examples/repl_tui.py

@@ -0,0 +1,129 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+REPL TUI Entry Point
+
+This is the main entry point for the modern TUI REPL interface.
+It provides a clean way to start the REPL from examples/ directory.
+"""
+
+import sys
+from pathlib import Path
+
+# Add project root to path
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+
+def run():
+    """Main entry point for REPL TUI"""
+    try:
+        # Setup TUI-friendly logging before importing REPL
+        from minion_code.utils.logs import setup_tui_logging
+
+        setup_tui_logging()
+
+        from minion_code.screens.REPL import run as run_repl
+
+        run_repl()
+    except ImportError as e:
+        print(f"❌ TUI dependencies not available: {e}")
+        print("💡 Install with: pip install textual rich")
+        print("🔄 Falling back to console interface...")
+        # Fallback to console
+        from minion_code.cli_simple import app
+
+        app()
+    except Exception as e:
+        print(f"❌ Error starting REPL: {e}")
+        sys.exit(1)
+
+
+def run_with_args():
+    """Entry point that handles command line arguments"""
+    import argparse
+
+    parser = argparse.ArgumentParser(
+        description="🤖 MinionCodeAgent REPL TUI",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  python examples/repl_tui.py
+  python examples/repl_tui.py --debug --verbose
+  python examples/repl_tui.py --prompt "Help me analyze this code"
+  python examples/repl_tui.py --dir /path/to/project
+        """,
+    )
+
+    parser.add_argument("--debug", action="store_true", help="Enable debug mode")
+
+    parser.add_argument(
+        "--verbose", "-v", action="store_true", help="Enable verbose output"
+    )
+
+    parser.add_argument(
+        "--prompt", "-p", type=str, help="Initial prompt to send to the agent"
+    )
+
+    parser.add_argument(
+        "--dir", "-d", type=str, help="Change to specified directory before starting"
+    )
+
+    parser.add_argument(
+        "--test-messages",
+        action="store_true",
+        help="Start with test messages for development",
+    )
+
+    args = parser.parse_args()
+
+    # Change directory if specified
+    if args.dir:
+        import os
+
+        try:
+            target_dir = Path(args.dir).resolve()
+            if not target_dir.exists():
+                print(f"❌ Directory does not exist: {args.dir}")
+                sys.exit(1)
+            if not target_dir.is_dir():
+                print(f"❌ Path is not a directory: {args.dir}")
+                sys.exit(1)
+
+            os.chdir(target_dir)
+            if args.verbose:
+                print(f"📁 Changed to directory: {target_dir}")
+        except Exception as e:
+            print(f"❌ Failed to change directory: {e}")
+            sys.exit(1)
+
+    # Start REPL with arguments
+    try:
+        # Setup TUI-friendly logging before importing REPL
+        from minion_code.utils.logs import setup_tui_logging
+
+        setup_tui_logging()
+
+        if args.test_messages:
+            # Use the test messages version
+            from examples.repl_with_test_messages import main as run_test_repl
+
+            run_test_repl()
+        else:
+            from minion_code.screens.REPL import run as run_repl
+
+            run_repl(initial_prompt=args.prompt, debug=args.debug, verbose=args.verbose)
+    except ImportError as e:
+        print(f"❌ TUI dependencies not available: {e}")
+        print("💡 Install with: pip install textual rich")
+        sys.exit(1)
+    except Exception as e:
+        print(f"❌ Error starting REPL: {e}")
+        if args.verbose:
+            import traceback
+
+            traceback.print_exc()
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    run_with_args()

examples/skills/example_usage.py

@@ -0,0 +1,57 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+Example: MinionCodeAgent with Skill Tool
+
+This script demonstrates using MinionCodeAgent with the built-in SkillTool.
+"""
+
+import asyncio
+import sys
+from pathlib import Path
+
+# Add project root to path
+sys.path.insert(0, str(Path(__file__).parent.parent.parent))
+
+from minion_code.agents.code_agent import MinionCodeAgent
+
+
+async def main():
+    """Demonstrate MinionCodeAgent with skill tool."""
+    print("=" * 60)
+    print("MinionCodeAgent with Skill Tool Example")
+    print("=" * 60 + "\n")
+
+    # Create agent - SkillTool is included by default
+    print("Creating MinionCodeAgent...")
+    agent = await MinionCodeAgent.create(name="Skill Demo Agent", llm="sonnet")
+    print("✓ Agent created with SkillTool\n")
+
+    # Show available tools (including SkillTool)
+    print("Available tools:")
+    tools_info = agent.get_tools_info()
+    for tool in tools_info:
+        if "skill" in tool["name"].lower():
+            print(f"  ★ {tool['name']}: {tool['description']}")
+        else:
+            print(f"  - {tool['name']}")
+    print()
+
+    # Ask agent to list available skills
+    print("Asking agent to list available skills...")
+    print("-" * 40)
+
+    response = await agent.run_async("Please read Titans.pdf and give a summary")
+
+    print(
+        f"\nAgent response:\n{response.answer if hasattr(response, 'answer') else response}"
+    )
+    print()
+
+    print("=" * 60)
+    print("Example completed!")
+    print("=" * 60)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

examples/start.py

@@ -0,0 +1,173 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+Universal Start Script for MinionCodeAgent
+
+This script provides a unified way to start any interface of MinionCodeAgent.
+It automatically detects the best available interface and provides fallbacks.
+"""
+
+import sys
+import os
+from pathlib import Path
+
+# Add project root to path
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+
+def check_tui_available():
+    """Check if TUI dependencies are available"""
+    try:
+        import textual
+        import rich
+
+        return True
+    except ImportError:
+        return False
+
+
+def show_interface_menu():
+    """Show interface selection menu"""
+    print("🤖 MinionCodeAgent - Choose Interface")
+    print("=" * 40)
+    print("1. 🖥️  Modern TUI REPL (Recommended)")
+    print("2. 🖥️  Console CLI (Traditional)")
+    print("3. ❓ Auto-detect best interface")
+    print("4. 🚪 Exit")
+    print()
+
+    while True:
+        try:
+            choice = input("Select interface (1-4): ").strip()
+            if choice in ["1", "2", "3", "4"]:
+                return choice
+            else:
+                print("❌ Invalid choice. Please enter 1, 2, 3, or 4.")
+        except (EOFError, KeyboardInterrupt):
+            print("\n👋 Goodbye!")
+            sys.exit(0)
+
+
+def start_tui_repl():
+    """Start TUI REPL interface"""
+    print("🚀 Starting TUI REPL interface...")
+    try:
+        from minion_code.screens.REPL import run
+
+        run()
+    except ImportError as e:
+        print(f"❌ TUI dependencies not available: {e}")
+        print("💡 Install with: pip install textual rich")
+        return False
+    except Exception as e:
+        print(f"❌ Error starting TUI REPL: {e}")
+        return False
+    return True
+
+
+def start_console_cli():
+    """Start console CLI interface"""
+    print("🚀 Starting console CLI interface...")
+    try:
+        from minion_code.cli_simple import InterruptibleCLI
+        import asyncio
+
+        cli = InterruptibleCLI()
+        asyncio.run(cli.run())
+    except Exception as e:
+        print(f"❌ Error starting console CLI: {e}")
+        return False
+    return True
+
+
+def auto_detect_interface():
+    """Auto-detect and start the best available interface"""
+    print("🔍 Auto-detecting best interface...")
+
+    if check_tui_available():
+        print("✅ TUI dependencies available - starting TUI REPL")
+        return start_tui_repl()
+    else:
+        print("⚠️  TUI dependencies not available - starting console CLI")
+        return start_console_cli()
+
+
+def main():
+    """Main entry point"""
+    print("🤖 MinionCodeAgent Universal Launcher")
+    print("=" * 50)
+
+    # Check if command line arguments are provided
+    if len(sys.argv) > 1:
+        arg = sys.argv[1].lower()
+
+        if arg in ["repl", "tui", "r"]:
+            if not start_tui_repl():
+                print("🔄 Falling back to console CLI...")
+                start_console_cli()
+        elif arg in ["console", "cli", "c"]:
+            start_console_cli()
+        elif arg in ["auto", "a"]:
+            auto_detect_interface()
+        elif arg in ["help", "h", "--help", "-h"]:
+            print_help()
+        else:
+            print(f"❌ Unknown argument: {arg}")
+            print_help()
+            sys.exit(1)
+    else:
+        # Interactive mode
+        choice = show_interface_menu()
+
+        if choice == "1":
+            if not start_tui_repl():
+                print("🔄 Falling back to console CLI...")
+                start_console_cli()
+        elif choice == "2":
+            start_console_cli()
+        elif choice == "3":
+            auto_detect_interface()
+        elif choice == "4":
+            print("👋 Goodbye!")
+            sys.exit(0)
+
+
+def print_help():
+    """Print help information"""
+    print(
+        """
+Usage: python examples/start.py [INTERFACE]
+
+Interfaces:
+  repl, tui, r     Start TUI REPL interface (recommended)
+  console, cli, c  Start console CLI interface
+  auto, a          Auto-detect best interface
+  help, h          Show this help
+
+Examples:
+  python examples/start.py repl
+  python examples/start.py console
+  python examples/start.py auto
+  python examples/start.py
+
+If no interface is specified, an interactive menu will be shown.
+
+Dependencies:
+  TUI REPL requires: textual, rich
+  Console CLI requires: typer, rich (basic)
+
+Install TUI dependencies:
+  pip install textual rich
+    """
+    )
+
+
+if __name__ == "__main__":
+    try:
+        main()
+    except KeyboardInterrupt:
+        print("\n👋 Goodbye!")
+        sys.exit(0)
+    except Exception as e:
+        print(f"❌ Unexpected error: {e}")
+        sys.exit(1)

minion_code/__init__.py

@@ -3,7 +3,7 @@
 """
 Minion Code Tools Package
 
-A collection of tools and enhanced agents for the Minion framework including 
+A collection of tools and enhanced agents for the Minion framework including
 file operations, system commands, web interactions, and specialized agents
 with dynamic system prompts and state management.
 """

minion_code/acp_server/__init__.py

@@ -0,0 +1,34 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+ACP (Agent Client Protocol) integration for minion-code.
+
+This module provides ACP server implementation allowing minion-code
+to be used with ACP-compatible clients like Zed editor.
+
+Note: Imports are lazy to avoid circular import issues with the external 'acp' package.
+Use: from minion_code.acp.agent import MinionACPAgent
+"""
+
+__all__ = [
+    "MinionACPAgent",
+    "create_acp_hooks",
+    "ACPToolHooks",
+]
+
+
+def __getattr__(name):
+    """Lazy imports to avoid circular import with external 'acp' package."""
+    if name == "MinionACPAgent":
+        from .agent import MinionACPAgent
+
+        return MinionACPAgent
+    elif name == "create_acp_hooks":
+        from .hooks import create_acp_hooks
+
+        return create_acp_hooks
+    elif name == "ACPToolHooks":
+        from .hooks import ACPToolHooks
+
+        return ACPToolHooks
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")