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

examples/simple_tui.py

@@ -1,267 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-Simple TUI using MinionCodeAgent
-
-This example shows how the new MinionCodeAgent class simplifies
-the TUI implementation by handling all the tool setup internally.
-
-Compare this with minion_agent_tui.py to see the reduction in boilerplate code.
-"""
-
-import asyncio
-import sys
-from pathlib import Path
-
-# Add project root to path
-sys.path.insert(0, str(Path(__file__).parent.parent))
-
-from minion_code import MinionCodeAgent
-from minion_code.commands import command_registry
-from rich.console import Console
-from rich.panel import Panel
-from rich.text import Text
-from rich.markdown import Markdown
-from rich.table import Table
-from rich.progress import Progress, SpinnerColumn, TextColumn
-from rich.prompt import Prompt
-
-
-class SimpleTUI:
-    """Simplified TUI using MinionCodeAgent."""
-    
-    def __init__(self):
-        self.agent = None
-        self.running = True
-        self.console = Console()
-    
-    async def setup(self):
-        """Setup the agent."""
-        with Progress(
-            SpinnerColumn(),
-            TextColumn("[progress.description]{task.description}"),
-            console=self.console,
-        ) as progress:
-            task = progress.add_task("🔧 Setting up MinionCodeAgent...", total=None)
-            
-            # Much simpler setup - no manual tool configuration needed
-            self.agent = await MinionCodeAgent.create(
-                name="Simple TUI Assistant",
-                llm="gpt-4o-mini",
-            )
-            
-            progress.update(task, completed=True)
-        
-        success_panel = Panel(
-            f"✅ Agent ready with [bold green]{len(self.agent.tools)}[/bold green] tools!",
-            title="[bold green]Setup Complete[/bold green]",
-            border_style="green"
-        )
-        self.console.print(success_panel)
-    
-    def show_help(self):
-        """Show help information."""
-        help_table = Table(title="📚 Simple TUI Help", show_header=True, header_style="bold blue")
-        help_table.add_column("Command", style="cyan", no_wrap=True)
-        help_table.add_column("Description", style="white")
-        
-        help_table.add_row("help", "Show this help")
-        help_table.add_row("tools", "List available tools")
-        help_table.add_row("history", "Show conversation history")
-        help_table.add_row("clear", "Clear history")
-        help_table.add_row("quit", "Exit")
-        
-        self.console.print(help_table)
-        self.console.print("\n💡 [italic]Just type your message to chat with the AI agent![/italic]")
-    
-    async def process_input(self, user_input: str):
-        """Process user input."""
-        user_input = user_input.strip()
-        
-        # Check if it's a command (starts with /)
-        if user_input.startswith('/'):
-            await self.process_command(user_input)
-            return
-        
-        # Process with agent
-        try:
-            with Progress(
-                SpinnerColumn(),
-                TextColumn("[progress.description]{task.description}"),
-                console=self.console,
-            ) as progress:
-                task = progress.add_task("🤖 Processing...", total=None)
-                response = await self.agent.run_async(user_input)
-                progress.update(task, completed=True)
-            
-            # Display agent response with rich formatting
-            if "```" in response.answer:
-                # If response contains code blocks, render as markdown
-                agent_content = Markdown(response.answer)
-            else:
-                agent_content = response.answer
-            
-            response_panel = Panel(
-                agent_content,
-                title="🤖 [bold green]Agent Response[/bold green]",
-                border_style="green"
-            )
-            self.console.print(response_panel)
-            
-        except Exception as e:
-            error_panel = Panel(
-                f"❌ [bold red]Error: {e}[/bold red]",
-                title="[bold red]Error[/bold red]",
-                border_style="red"
-            )
-            self.console.print(error_panel)
-    
-    async def process_command(self, command_input: str):
-        """Process a command input."""
-        # Remove the leading /
-        command_input = command_input[1:] if command_input.startswith('/') else command_input
-        
-        # Split command and arguments
-        parts = command_input.split(' ', 1)
-        command_name = parts[0].lower()
-        args = parts[1] if len(parts) > 1 else ""
-        
-        # Get command class
-        command_class = command_registry.get_command(command_name)
-        if not command_class:
-            error_panel = Panel(
-                f"❌ [bold red]Unknown command: /{command_name}[/bold red]\n"
-                f"💡 [italic]Use '/help' to see available commands[/italic]",
-                title="[bold red]Error[/bold red]",
-                border_style="red"
-            )
-            self.console.print(error_panel)
-            return
-        
-        # Create and execute command
-        try:
-            command_instance = command_class(self.console, self.agent)
-            
-            # Special handling for quit command
-            if command_name in ["quit", "exit", "q", "bye"]:
-                command_instance._tui_instance = self
-            
-            await command_instance.execute(args)
-            
-        except Exception as e:
-            error_panel = Panel(
-                f"❌ [bold red]Error executing command /{command_name}: {e}[/bold red]",
-                title="[bold red]Command Error[/bold red]",
-                border_style="red"
-            )
-            self.console.print(error_panel)
-    
-    def show_tools(self):
-        """Show available tools in a beautiful table."""
-        if not self.agent or not self.agent.tools:
-            self.console.print("❌ No tools available")
-            return
-        
-        tools_table = Table(title="🛠️ Available Tools", show_header=True, header_style="bold magenta")
-        tools_table.add_column("Tool Name", style="cyan", no_wrap=True)
-        tools_table.add_column("Description", style="white")
-        tools_table.add_column("Type", style="yellow")
-        
-        for tool in self.agent.tools:
-            tool_type = "Read-only" if getattr(tool, 'readonly', False) else "Read-write"
-            tools_table.add_row(
-                tool.name,
-                tool.description[:60] + "..." if len(tool.description) > 60 else tool.description,
-                tool_type
-            )
-        
-        self.console.print(tools_table)
-    
-    def show_history(self):
-        """Show conversation history in a beautiful format."""
-        if not self.agent:
-            return
-            
-        history = self.agent.get_conversation_history()
-        if not history:
-            no_history_panel = Panel(
-                "📝 [italic]No conversation history yet.[/italic]",
-                title="[bold blue]History[/bold blue]",
-                border_style="blue"
-            )
-            self.console.print(no_history_panel)
-            return
-        
-        history_panel = Panel(
-            f"📝 [bold blue]Conversation History ({len(history)} messages)[/bold blue]",
-            border_style="blue"
-        )
-        self.console.print(history_panel)
-        
-        for i, entry in enumerate(history[-5:], 1):  # Show last 5 messages
-            # User message
-            user_panel = Panel(
-                entry['user_message'][:200] + "..." if len(entry['user_message']) > 200 else entry['user_message'],
-                title=f"👤 [bold cyan]You (Message {len(history)-5+i})[/bold cyan]",
-                border_style="cyan"
-            )
-            self.console.print(user_panel)
-            
-            # Agent response
-            agent_response = entry['agent_response'][:200] + "..." if len(entry['agent_response']) > 200 else entry['agent_response']
-            agent_panel = Panel(
-                agent_response,
-                title="🤖 [bold green]Agent[/bold green]",
-                border_style="green"
-            )
-            self.console.print(agent_panel)
-            self.console.print()  # Add spacing
-    
-    async def run(self):
-        """Run the TUI."""
-        # Welcome banner
-        welcome_panel = Panel(
-            "🚀 [bold blue]Simple MinionCodeAgent TUI[/bold blue]\n"
-            "💡 [italic]Use '/help' for commands or just chat with the agent![/italic]\n"
-            "🛑 [italic]Type '/quit' to exit[/italic]",
-            title="[bold magenta]Welcome[/bold magenta]",
-            border_style="magenta"
-        )
-        self.console.print(welcome_panel)
-        
-        await self.setup()
-        
-        while self.running:
-            try:
-                # Use rich prompt for better input experience
-                user_input = Prompt.ask(
-                    "\n[bold cyan]👤 You[/bold cyan]",
-                    console=self.console
-                ).strip()
-                
-                if user_input:
-                    await self.process_input(user_input)
-                    
-            except (EOFError, KeyboardInterrupt):
-                goodbye_panel = Panel(
-                    "\n👋 [bold yellow]Goodbye![/bold yellow]",
-                    title="[bold red]Exit[/bold red]",
-                    border_style="red"
-                )
-                self.console.print(goodbye_panel)
-                break
-
-
-async def main():
-    """Main function."""
-    tui = SimpleTUI()
-    await tui.run()
-
-
-def run():
-    """Synchronous entry point."""
-    asyncio.run(main())
-
-
-if __name__ == "__main__":
-    run()

examples/simple_usage.py

@@ -1,69 +0,0 @@
-#!/usr/bin/env python3
-"""Simple usage example of FileFreshnessService."""
-
-import os
-import sys
-
-# Add parent directory to path for imports
-sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
-
-from minion_code.services import (
-    record_file_read,
-    record_file_edit,
-    check_file_freshness,
-    generate_file_modification_reminder,
-    add_event_listener,
-    emit_event,
-)
-
-
-def main():
-    """Simple usage demonstration."""
-    
-    # Set up a simple event listener
-    def on_conflict(context):
-        print(f"⚠️  Conflict: {context.data['file_path']}")
-    
-    add_event_listener('file:conflict', on_conflict)
-    
-    # Create test file
-    test_file = "example.py"
-    with open(test_file, "w") as f:
-        f.write("print('Hello, World!')")
-    
-    # Record reading the file
-    record_file_read(test_file)
-    print(f"✅ Recorded reading {test_file}")
-    
-    # Check freshness (should be fresh)
-    result = check_file_freshness(test_file)
-    print(f"📊 File is fresh: {result.is_fresh}")
-    
-    # Simulate external modification
-    with open(test_file, "w") as f:
-        f.write("print('Modified externally!')")
-    
-    # Check freshness again (should detect conflict)
-    result = check_file_freshness(test_file)
-    print(f"📊 After external change - Fresh: {result.is_fresh}, Conflict: {result.conflict}")
-    
-    # Generate reminder for external modification
-    reminder = generate_file_modification_reminder(test_file)
-    if reminder:
-        print(f"💡 Reminder: {reminder}")
-    
-    # Record agent edit (resolves conflict)
-    record_file_edit(test_file, "print('Agent fixed this!')")
-    print(f"✅ Agent edited {test_file}")
-    
-    # Check freshness after agent edit
-    result = check_file_freshness(test_file)
-    print(f"📊 After agent edit - Fresh: {result.is_fresh}, Conflict: {result.conflict}")
-    
-    # Cleanup
-    os.remove(test_file)
-    print("🧹 Cleaned up test file")
-
-
-if __name__ == "__main__":
-    main()

minion_code-0.1.0.dist-info/METADATA

@@ -1,350 +0,0 @@
-Metadata-Version: 2.4
-Name: minion-code
-Version: 0.1.0
-Summary: A Python project depending on minion
-Author-email: User <user@example.com>
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: minionx
-Requires-Dist: typer>=0.9.0
-Provides-Extra: dev
-Requires-Dist: pytest; extra == "dev"
-Requires-Dist: black; extra == "dev"
-Requires-Dist: flake8; extra == "dev"
-Requires-Dist: mypy; extra == "dev"
-Provides-Extra: tui
-Requires-Dist: textual>=0.40.0; extra == "tui"
-Requires-Dist: rich>=13.0.0; extra == "tui"
-Provides-Extra: agent
-Requires-Dist: openai>=1.0.0; extra == "agent"
-Dynamic: license-file
-
-# MinionCodeAgent
-
-一个增强的AI代码助手，基于Minion框架构建，预配置了丰富的开发工具，专为代码开发任务优化。
-
-## 特性
-
-- 🤖 **智能代码助手**：预配置的AI agent，专为编程任务设计
-- 🔧 **丰富的工具集**：自动包含文件操作、命令执行、网络搜索等12+个工具
-- ⚡ **即开即用**：一行代码创建，无需复杂配置
-- 📝 **对话历史**：内置对话历史跟踪和管理
-- 🎯 **优化提示**：专为代码开发任务优化的系统提示
-- 🛡️ **安全设计**：内置安全检查，防止危险操作
-
-## 安装
-
-```bash
-# 克隆仓库
-git clone <repository-url>
-cd minion-code
-pip install -e .
-```
-
-## 快速开始
-
-### CLI使用
-
-```bash
-# 基本使用
-mcode
-
-# 指定工作目录
-mcode --dir /path/to/project
-
-# 启用详细输出
-mcode --verbose
-
-# 使用MCP配置文件加载额外工具
-mcode --config mcp.json
-
-# 组合使用
-mcode --dir /path/to/project --config mcp.json --verbose
-```
-
-### 编程接口
-
-```python
-import asyncio
-from minion_code import MinionCodeAgent
-
-async def main():
-    # 创建AI代码助手，自动配置所有工具
-    agent = await MinionCodeAgent.create(
-        name="My Code Assistant",
-        llm="gpt-4.1"
-    )
-    
-    # 与AI助手对话
-    response = await agent.run_async("List files in current directory")
-    print(response.answer)
-    
-    response = await agent.run_async("Read the README.md file")
-    print(response.answer)
-
-asyncio.run(main())
-```
-
-### 自定义配置
-
-```python
-# 自定义系统提示和工作目录
-agent = await MinionCodeAgent.create(
-    name="Python Expert",
-    llm="gpt-4.1",
-    system_prompt="You are a specialized Python developer assistant.",
-    workdir="/path/to/project",
-    additional_tools=[MyCustomTool()]
-)
-```
-
-### 查看可用工具
-
-```python
-# 打印工具摘要
-agent.print_tools_summary()
-
-# 获取工具信息
-tools_info = agent.get_tools_info()
-for tool in tools_info:
-    print(f"{tool['name']}: {tool['description']}")
-```
-
-## 内置工具
-
-MinionCodeAgent自动包含以下工具类别：
-
-### 📁 文件和目录工具
-- **FileReadTool**: 读取文件内容
-- **FileWriteTool**: 写入文件
-- **GrepTool**: 在文件中搜索文本
-- **GlobTool**: 文件模式匹配
-- **LsTool**: 列出目录内容
-
-### 💻 系统和执行工具
-- **BashTool**: 执行shell命令
-- **PythonInterpreterTool**: 执行Python代码
-
-### 🌐 网络和搜索工具
-- **WebSearchTool**: 网络搜索
-- **WikipediaSearchTool**: Wikipedia搜索
-- **VisitWebpageTool**: 访问网页
-
-### 🔧 其他工具
-- **UserInputTool**: 用户输入
-- **TodoWriteTool**: 任务管理写入
-- **TodoReadTool**: 任务管理读取
-
-## MCP工具集成
-
-MinionCodeAgent支持通过MCP (Model Context Protocol) 配置文件加载额外的工具。
-
-### MCP配置文件格式
-
-创建一个JSON配置文件（如`mcp.json`）：
-
-```json
-{
-  "mcpServers": {
-    "chrome-devtools": {
-      "command": "npx",
-      "args": ["-y", "chrome-devtools-mcp@latest"],
-      "env": {
-        "FASTMCP_LOG_LEVEL": "ERROR"
-      },
-      "disabled": false,
-      "autoApprove": []
-    },
-    "filesystem": {
-      "command": "uvx",
-      "args": ["mcp-server-filesystem", "/tmp"],
-      "disabled": true,
-      "autoApprove": ["read_file", "list_directory"]
-    },
-    "git": {
-      "command": "uvx", 
-      "args": ["mcp-server-git"],
-      "disabled": false,
-      "autoApprove": ["git_status", "git_log"]
-    }
-  }
-}
-```
-
-### 配置选项说明
-
-- `command`: 启动MCP服务器的命令
-- `args`: 命令参数列表
-- `env`: 环境变量（可选）
-- `disabled`: 是否禁用此服务器（默认false）
-- `autoApprove`: 自动批准的工具名称列表（可选）
-
-### 使用MCP配置
-
-```bash
-# 使用MCP配置文件
-minion-code --config examples/mcp_config.json
-
-# 查看加载的工具（包括MCP工具）
-# 在CLI中输入: tools
-```
-
-### 编程接口中使用MCP工具
-
-```python
-from minion_code.utils.mcp_loader import load_mcp_tools
-from pathlib import Path
-
-async def main():
-    # 加载MCP工具
-    mcp_tools = await load_mcp_tools(Path("mcp.json"))
-    
-    # 创建包含MCP工具的agent
-    agent = await MinionCodeAgent.create(
-        name="Enhanced Assistant",
-        llm="gpt-4o-mini",
-        additional_tools=mcp_tools
-    )
-```
-
-## 对话历史管理
-
-```python
-# 获取对话历史
-history = agent.get_conversation_history()
-for entry in history:
-    print(f"User: {entry['user_message']}")
-    print(f"Agent: {entry['agent_response']}")
-
-# 清除历史
-agent.clear_conversation_history()
-```
-
-## 与原始实现的对比
-
-### 之前 (复杂的手动配置)
-```python
-# 需要手动导入和配置所有工具
-from minion_code.tools import (
-    FileReadTool, FileWriteTool, BashTool, 
-    GrepTool, GlobTool, LsTool, 
-    PythonInterpreterTool, WebSearchTool,
-    # ... 更多工具
-)
-
-# 手动创建工具实例
-custom_tools = [
-    FileReadTool(),
-    FileWriteTool(),
-    BashTool(),
-    # ... 更多工具配置
-]
-
-# 手动设置系统提示
-SYSTEM_PROMPT = "You are a coding agent..."
-
-# 创建agent (约50行代码)
-agent = await CodeAgent.create(
-    name="Minion Code Assistant",
-    llm="gpt-4o-mini",
-    system_prompt=SYSTEM_PROMPT,
-    tools=custom_tools,
-)
-```
-
-### 现在 (使用MinionCodeAgent)
-```python
-# 一行代码完成所有设置
-agent = await MinionCodeAgent.create(
-    name="Minion Code Assistant",
-    llm="gpt-4o-mini"
-)
-```
-
-## API参考
-
-### MinionCodeAgent.create()
-
-```python
-async def create(
-    name: str = "Minion Code Assistant",
-    llm: str = "gpt-4o-mini", 
-    system_prompt: Optional[str] = None,
-    workdir: Optional[Union[str, Path]] = None,
-    additional_tools: Optional[List[Any]] = None,
-    **kwargs
-) -> MinionCodeAgent
-```
-
-**参数:**
-- `name`: Agent名称
-- `llm`: 使用的LLM模型
-- `system_prompt`: 自定义系统提示（可选）
-- `workdir`: 工作目录（可选，默认当前目录）
-- `additional_tools`: 额外工具列表（可选）
-- `**kwargs`: 传递给CodeAgent.create()的其他参数
-
-### 实例方法
-
-- `run_async(message: str)`: 异步运行agent
-- `run(message: str)`: 同步运行agent  
-- `get_conversation_history()`: 获取对话历史
-- `clear_conversation_history()`: 清除对话历史
-- `get_tools_info()`: 获取工具信息
-- `print_tools_summary()`: 打印工具摘要
-
-### 属性
-
-- `agent`: 访问底层CodeAgent实例
-- `tools`: 获取可用工具列表
-- `name`: 获取agent名称
-
-## 安全特性
-
-- **命令执行安全**：BashTool禁止执行危险命令（如`rm -rf`、`sudo`等）
-- **Python执行限制**：PythonInterpreterTool在受限环境中执行，只允许安全的内置函数和指定模块
-- **文件访问控制**：所有文件操作都有路径验证和错误处理
-
-## 示例
-
-查看 `examples/` 目录中的完整示例：
-
-- `simple_code_agent.py`: 基本MinionCodeAgent使用示例
-- `simple_tui.py`: 简化的TUI实现
-- `advanced_textual_tui.py`: 高级TUI界面（使用Textual库）
-- `minion_agent_tui.py`: 原始复杂实现（对比参考）
-- `mcp_config.json`: MCP配置文件示例
-- `test_mcp_config.py`: MCP配置加载测试
-- `demo_mcp_cli.py`: MCP CLI功能演示
-
-运行示例：
-
-```bash
-# 基本使用示例
-python examples/simple_code_agent.py
-
-# 简单TUI
-python examples/simple_tui.py
-
-# 高级TUI (需要安装 textual: pip install textual rich)
-python examples/advanced_textual_tui.py
-
-# 测试MCP配置加载
-python examples/test_mcp_config.py
-
-# MCP CLI功能演示
-python examples/demo_mcp_cli.py
-```
-
-## 文档
-
-- [MCP工具集成指南](docs/MCP_GUIDE.md) - 详细的MCP配置和使用指南
-
-## 贡献
-
-欢迎提交Issue和Pull Request来改进这个项目！
-
-## 许可证
-
-MIT License