todo.

Author: femto

AGENTS.md

@@ -0,0 +1,82 @@
+# Agent Development Guidelines
+
+## File System Usage
+
+### Workspace Directory Convention
+
+When developing agents and tools that need to store persistent data or work with files, **always use `.minion_workspace`** as the default directory instead of other directory names.
+
+#### Why .minion_workspace?
+
+- **Consistency**: All agents and tools use the same workspace directory
+- **Organization**: Keeps agent-related files separate from project files
+- **Predictability**: Users know where to find agent-generated files
+- **Cleanup**: Easy to identify and manage agent workspace files
+
+#### Examples
+
+**✅ Correct Usage:**
+```python
+# In todo storage
+class TodoStorage:
+    def __init__(self, storage_dir: str = ".minion_workspace"):
+        self.storage_dir = storage_dir
+        os.makedirs(storage_dir, exist_ok=True)
+
+# In file tools
+def save_agent_data(data, filename):
+    workspace_dir = ".minion_workspace"
+    os.makedirs(workspace_dir, exist_ok=True)
+    filepath = os.path.join(workspace_dir, filename)
+    # ... save data
+```
+
+**❌ Avoid:**
+```python
+# Don't use custom directory names
+storage_dir = ".minion_todos"  # Too specific
+storage_dir = ".agent_data"   # Not standardized
+storage_dir = "temp_files"    # Not clearly agent-related
+```
+
+### File Naming Conventions
+
+Within `.minion_workspace`, use descriptive filenames that include:
+- Agent ID or identifier when relevant
+- File type or purpose
+- Appropriate file extensions
+
+Examples:
+- `todos_agent_123.json` - Todo data for specific agent
+- `memory_default.json` - Default memory storage
+- `logs_session_456.txt` - Session logs
+
+### Implementation Notes
+
+- Always create the `.minion_workspace` directory if it doesn't exist
+- Handle file permissions and access errors gracefully
+- Use appropriate file formats (JSON for structured data, TXT for logs)
+- Include proper error handling for file operations
+
+### Migration
+
+If you have existing tools using other directory names:
+1. Update the default directory to `.minion_workspace`
+2. Consider migration logic for existing data
+3. Update documentation and examples
+4. Test with existing agent configurations
+#
+# Migration from .minion_todos
+
+If you have existing data in `.minion_todos`, you can migrate it to `.minion_workspace`:
+
+```bash
+# Copy existing todo files
+mkdir -p .minion_workspace
+cp .minion_todos/*.json .minion_workspace/
+
+# Verify migration
+ls -la .minion_workspace/
+```
+
+The todo tools have been updated to use `.minion_workspace` by default, so existing todo data will continue to work after migration.

minion_code/utils/__init__.py

@@ -0,0 +1 @@
+# Utils package

minion_code/utils/todo_storage.py

@@ -0,0 +1,146 @@
+"""Todo storage utilities for managing todo items."""
+
+import json
+import os
+from typing import List, Dict, Any, Optional
+from dataclasses import dataclass, asdict
+from enum import Enum
+
+
+class TodoStatus(Enum):
+    PENDING = "pending"
+    IN_PROGRESS = "in_progress"
+    COMPLETED = "completed"
+
+
+class TodoPriority(Enum):
+    HIGH = "high"
+    MEDIUM = "medium"
+    LOW = "low"
+
+
+@dataclass
+class TodoItem:
+    id: str
+    content: str
+    status: TodoStatus
+    priority: TodoPriority
+    
+    def to_dict(self) -> Dict[str, Any]:
+        return {
+            "id": self.id,
+            "content": self.content,
+            "status": self.status.value,
+            "priority": self.priority.value
+        }
+    
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> 'TodoItem':
+        return cls(
+            id=data["id"],
+            content=data["content"],
+            status=TodoStatus(data["status"]),
+            priority=TodoPriority(data["priority"])
+        )
+
+
+class TodoStorage:
+    def __init__(self, storage_dir: str = ".minion_workspace"):
+        self.storage_dir = storage_dir
+        os.makedirs(storage_dir, exist_ok=True)
+    
+    def _get_file_path(self, agent_id: Optional[str] = None) -> str:
+        filename = f"todos_{agent_id}.json" if agent_id else "todos_default.json"
+        return os.path.join(self.storage_dir, filename)
+    
+    def get_todos(self, agent_id: Optional[str] = None) -> List[TodoItem]:
+        """Get all todos for a specific agent or default."""
+        file_path = self._get_file_path(agent_id)
+        
+        if not os.path.exists(file_path):
+            return []
+        
+        try:
+            with open(file_path, 'r', encoding='utf-8') as f:
+                data = json.load(f)
+                return [TodoItem.from_dict(item) for item in data]
+        except (json.JSONDecodeError, KeyError, ValueError):
+            return []
+    
+    def set_todos(self, todos: List[TodoItem], agent_id: Optional[str] = None) -> None:
+        """Set todos for a specific agent or default."""
+        file_path = self._get_file_path(agent_id)
+        
+        data = [todo.to_dict() for todo in todos]
+        
+        with open(file_path, 'w', encoding='utf-8') as f:
+            json.dump(data, f, indent=2, ensure_ascii=False)
+    
+    def add_todo(self, todo: TodoItem, agent_id: Optional[str] = None) -> None:
+        """Add a new todo."""
+        todos = self.get_todos(agent_id)
+        todos.append(todo)
+        self.set_todos(todos, agent_id)
+    
+    def update_todo(self, todo_id: str, updates: Dict[str, Any], agent_id: Optional[str] = None) -> bool:
+        """Update a specific todo. Returns True if found and updated."""
+        todos = self.get_todos(agent_id)
+        
+        for todo in todos:
+            if todo.id == todo_id:
+                if 'content' in updates:
+                    todo.content = updates['content']
+                if 'status' in updates:
+                    todo.status = TodoStatus(updates['status'])
+                if 'priority' in updates:
+                    todo.priority = TodoPriority(updates['priority'])
+                
+                self.set_todos(todos, agent_id)
+                return True
+        
+        return False
+    
+    def remove_todo(self, todo_id: str, agent_id: Optional[str] = None) -> bool:
+        """Remove a todo by ID. Returns True if found and removed."""
+        todos = self.get_todos(agent_id)
+        original_length = len(todos)
+        
+        todos = [todo for todo in todos if todo.id != todo_id]
+        
+        if len(todos) < original_length:
+            self.set_todos(todos, agent_id)
+            return True
+        
+        return False
+    
+    def clear_todos(self, agent_id: Optional[str] = None) -> None:
+        """Clear all todos for a specific agent."""
+        self.set_todos([], agent_id)
+
+
+# Global storage instance
+_storage = TodoStorage()
+
+def get_todos(agent_id: Optional[str] = None) -> List[TodoItem]:
+    """Get todos from global storage."""
+    return _storage.get_todos(agent_id)
+
+def set_todos(todos: List[TodoItem], agent_id: Optional[str] = None) -> None:
+    """Set todos in global storage."""
+    _storage.set_todos(todos, agent_id)
+
+def add_todo(todo: TodoItem, agent_id: Optional[str] = None) -> None:
+    """Add todo to global storage."""
+    _storage.add_todo(todo, agent_id)
+
+def update_todo(todo_id: str, updates: Dict[str, Any], agent_id: Optional[str] = None) -> bool:
+    """Update todo in global storage."""
+    return _storage.update_todo(todo_id, updates, agent_id)
+
+def remove_todo(todo_id: str, agent_id: Optional[str] = None) -> bool:
+    """Remove todo from global storage."""
+    return _storage.remove_todo(todo_id, agent_id)
+
+def clear_todos(agent_id: Optional[str] = None) -> None:
+    """Clear all todos in global storage."""
+    _storage.clear_todos(agent_id)