todo-agent 0.3.2__py3-none-any.whl → 0.3.5__py3-none-any.whl

todo_agent/interface/tools.py

@@ -16,7 +16,7 @@ Task Management Tools:
 - append_to_task(task_number, text) - Add text to end of existing task
 - prepend_to_task(task_number, text) - Add text to beginning of existing task
 - delete_task(task_number, term?) - Delete entire task or remove specific term
-- created_completed_task(description, completion_date?, project?, context?) - Create task and immediately mark as completed
+- create_completed_task(description, completion_date?, project?, context?) - Create task and immediately mark as completed
 
 Priority Management Tools:
 - set_priority(task_number, priority) - Set or change task priority (A-Z)
@@ -26,6 +26,7 @@ Task Modification Tools:
 - set_due_date(task_number, due_date) - Set or update due date for a task by intelligently rewriting it (use empty string to remove due date)
 - set_context(task_number, context) - Set or update context for a task by intelligently rewriting it (use empty string to remove context)
 - set_project(task_number, projects) - Set or update projects for a task by intelligently rewriting it (handles array of projects with add/remove operations)
+- set_parent(task_number, parent_number) - Set or update parent task number for a task by intelligently rewriting it (use None to remove parent)
 
 Utility Tools:
 - move_task(task_number, destination, source?) - Move task between files
@@ -176,11 +177,15 @@ class ToolCallHandler:
                                 "type": "string",
                                 "description": "Optional duration estimate in format: minutes (e.g., '30m'), hours (e.g., '2h'), or days (e.g., '1d'). Use for time planning and task prioritization.",
                             },
+                            "parent_number": {
+                                "type": "integer",
+                                "description": "Optional parent task number (required for subtasks)",
+                            },
                         },
                         "required": ["description"],
                     },
                 },
-                "progress_description": "➕ Creating new task...",
+                "progress_description": "✨ Creating new task: {description}...",
             },
             {
                 "type": "function",
@@ -204,7 +209,7 @@ class ToolCallHandler:
                         "required": ["task_number"],
                     },
                 },
-                "progress_description": "🎯 Marking task complete...",
+                "progress_description": "🎯 Marking task #{task_number} as complete...",
             },
             {
                 "type": "function",
@@ -232,7 +237,7 @@ class ToolCallHandler:
                         "required": ["task_number", "new_description"],
                     },
                 },
-                "progress_description": "✏️ Updating task description...",
+                "progress_description": "✏️ Updating task #{task_number} with new description...",
             },
             {
                 "type": "function",
@@ -254,15 +259,15 @@ class ToolCallHandler:
                                 "type": "integer",
                                 "description": "The line number of the task to modify (required)",
                             },
-                            "text_to_append": {
+                            "text": {
                                 "type": "string",
                                 "description": "Text to add to the end of the task (required)",
                             },
                         },
-                        "required": ["task_number", "text_to_append"],
+                        "required": ["task_number", "text"],
                     },
                 },
-                "progress_description": "📝 Adding notes to task...",
+                "progress_description": "📝 Adding notes to task #{task_number}...",
             },
             {
                 "type": "function",
@@ -289,7 +294,7 @@ class ToolCallHandler:
                         "required": ["task_number", "text"],
                     },
                 },
-                "progress_description": "📝 Adding prefix to task...",
+                "progress_description": "📝 Adding prefix to task #{task_number}...",
             },
             {
                 "type": "function",
@@ -320,7 +325,7 @@ class ToolCallHandler:
                         "required": ["task_number"],
                     },
                 },
-                "progress_description": "🗑️ Deleting task...",
+                "progress_description": "🗑️ Deleting task #{task_number}...",
             },
             {
                 "type": "function",
@@ -348,7 +353,7 @@ class ToolCallHandler:
                         "required": ["task_number", "priority"],
                     },
                 },
-                "progress_description": "🏷️ Setting priority...",
+                "progress_description": "🏷️ Setting priority {priority} for task #{task_number}...",
             },
             {
                 "type": "function",
@@ -372,7 +377,7 @@ class ToolCallHandler:
                         "required": ["task_number"],
                     },
                 },
-                "progress_description": "🏷️ Removing priority...",
+                "progress_description": "🏷️ Removing priority from task #{task_number}...",
             },
             {
                 "type": "function",
@@ -404,7 +409,7 @@ class ToolCallHandler:
                         "required": ["task_number", "due_date"],
                     },
                 },
-                "progress_description": "📅 Setting due date...",
+                "progress_description": "📅 Setting due date {due_date} for task #{task_number}...",
             },
             {
                 "type": "function",
@@ -436,7 +441,7 @@ class ToolCallHandler:
                         "required": ["task_number", "context"],
                     },
                 },
-                "progress_description": "📍 Setting context...",
+                "progress_description": "📍 Setting context {context} for task #{task_number}...",
             },
             {
                 "type": "function",
@@ -472,7 +477,40 @@ class ToolCallHandler:
                         "required": ["task_number", "projects"],
                     },
                 },
-                "progress_description": "🏷️ Setting project tags...",
+                "progress_description": "🏷️ Setting project tags for task #{task_number}...",
+            },
+            {
+                "type": "function",
+                "function": {
+                    "name": "set_parent",
+                    "description": (
+                        "Set or update the parent task number for an EXISTING task by intelligently rewriting it. "
+                        "USE CASE: Call this when user wants to add, change, or remove a parent task relationship on an existing task. "
+                        "NOT FOR: Creating new tasks, completing tasks, or any other task operations. "
+                        "This preserves all existing task components (priority, projects, contexts, due date, etc.) "
+                        "while updating or adding the parent relationship. Use None to remove the parent. "
+                        "PREFERRED METHOD: Use this instead of append_to_task() when adding parent tags (parent:XX). "
+                        "This tool properly manages parent relationships and prevents formatting issues. "
+                        "IMPORTANT: Use list_tasks() first "
+                        "to find the correct task number if user doesn't specify it. "
+                        "Parent task numbers should be provided as integers (e.g., 12 not 'parent:12')."
+                    ),
+                    "parameters": {
+                        "type": "object",
+                        "properties": {
+                            "task_number": {
+                                "type": "integer",
+                                "description": "The line number of the task to modify (required)",
+                            },
+                            "parent_number": {
+                                "type": "integer",
+                                "description": "Parent task number to set, or null to remove parent (required)",
+                            },
+                        },
+                        "required": ["task_number", "parent_number"],
+                    },
+                },
+                "progress_description": "🔗 Setting parent task {parent_number} for task #{task_number}...",
             },
             {
                 "type": "function",
@@ -504,7 +542,7 @@ class ToolCallHandler:
                         "required": ["task_number", "destination"],
                     },
                 },
-                "progress_description": "📦 Moving task...",
+                "progress_description": "📦 Moving task #{task_number} to {destination}...",
             },
             {
                 "type": "function",
@@ -544,7 +582,7 @@ class ToolCallHandler:
                         "required": ["date_expression"],
                     },
                 },
-                "progress_description": "📅 Converting date expression...",
+                "progress_description": "📅 Converting date expression '{date_expression}'...",
             },
             {
                 "type": "function",
@@ -580,12 +618,12 @@ class ToolCallHandler:
                         "required": ["month", "year"],
                     },
                 },
-                "progress_description": "📅 Generating calendar...",
+                "progress_description": "📅 Generating calendar for {month}/{year}...",
             },
             {
                 "type": "function",
                 "function": {
-                    "name": "created_completed_task",
+                    "name": "create_completed_task",
                     "description": (
                         "Create a task and immediately mark it as completed. "
                         "USE CASE: Call this when user says they completed something on a specific date (e.g., 'I did the laundry today', 'I finished the report yesterday', 'I cleaned the garage last week') "
@@ -615,11 +653,15 @@ class ToolCallHandler:
                                 "type": "string",
                                 "description": "Optional context name (without the @ symbol) for new task creation",
                             },
+                            "parent_number": {
+                                "type": "integer",
+                                "description": "Optional parent task number (required for subtasks)",
+                            },
                         },
                         "required": ["description"],
                     },
                 },
-                "progress_description": "✅ Creating completed task...",
+                "progress_description": "✅ Creating completed task: {description}...",
             },
             {
                 "type": "function",
@@ -646,7 +688,7 @@ class ToolCallHandler:
                         "required": ["task_number"],
                     },
                 },
-                "progress_description": "🔄 Restoring completed task...",
+                "progress_description": "🔄 Restoring completed task #{task_number}...",
             },
         ]
 
@@ -805,16 +847,16 @@ class ToolCallHandler:
         """Execute a tool call and return the result."""
         # Validate tool call structure
         if not isinstance(tool_call, dict):
-            return {
+            return {  # type: ignore[unreachable]
                 "tool_call_id": "unknown",
                 "name": "unknown",
                 "output": "ERROR: Invalid tool call format",
                 "error": True,
                 "error_type": "malformed_tool_call",
                 "error_details": "Tool call is not a dictionary",
-                "user_message": "I received a malformed request. Please try again, or type 'clear' to reset our conversation."
+                "user_message": "I received a malformed request. Please try again, or type 'clear' to reset our conversation.",
             }
-            
+
         if "function" not in tool_call:
             return {
                 "tool_call_id": tool_call.get("id", "unknown"),
@@ -823,9 +865,9 @@ class ToolCallHandler:
                 "error": True,
                 "error_type": "malformed_tool_call",
                 "error_details": "Tool call missing function field",
-                "user_message": "I received a malformed request. Please try again, or type 'clear' to reset our conversation."
+                "user_message": "I received a malformed request. Please try again, or type 'clear' to reset our conversation.",
             }
-            
+
         function = tool_call["function"]
         if not isinstance(function, dict):
             return {
@@ -835,9 +877,9 @@ class ToolCallHandler:
                 "error": True,
                 "error_type": "malformed_tool_call",
                 "error_details": "Function field is not a dictionary",
-                "user_message": "I received a malformed request. Please try again, or type 'clear' to reset our conversation."
+                "user_message": "I received a malformed request. Please try again, or type 'clear' to reset our conversation.",
             }
-            
+
         tool_name = function.get("name")
         if not tool_name:
             return {
@@ -847,9 +889,9 @@ class ToolCallHandler:
                 "error": True,
                 "error_type": "malformed_tool_call",
                 "error_details": "Function missing name field",
-                "user_message": "I received a malformed request. Please try again, or type 'clear' to reset our conversation."
+                "user_message": "I received a malformed request. Please try again, or type 'clear' to reset our conversation.",
             }
-            
+
         arguments = function.get("arguments", {})
         tool_call_id = tool_call.get("id", "unknown")
 
@@ -897,11 +939,12 @@ class ToolCallHandler:
             "set_due_date": self.todo_manager.set_due_date,
             "set_context": self.todo_manager.set_context,
             "set_project": self.todo_manager.set_project,
+            "set_parent": self.todo_manager.set_parent,
             "move_task": self.todo_manager.move_task,
             "archive_tasks": self.todo_manager.archive_tasks,
             "parse_date": self._parse_date,
             "get_calendar": self._get_calendar,
-            "created_completed_task": self.todo_manager.created_completed_task,
+            "create_completed_task": self.todo_manager.create_completed_task,
             "restore_completed_task": self.todo_manager.restore_completed_task,
         }
 

todo_agent/main.py

@@ -11,9 +11,12 @@ from .interface.cli import CLI
 
 def main() -> None:
     """Main application entry point."""
+    from ._version import __version__
+    
     parser = argparse.ArgumentParser(
-        description="Todo.sh LLM Agent - Natural language task management",
+        description=f"Todo.sh LLM Agent - Natural language task management (v{__version__})",
         formatter_class=argparse.RawDescriptionHelpFormatter,
+        add_help=False,
         epilog="""
 Examples:
   todo-agent                    # Interactive mode
@@ -23,6 +26,19 @@ Examples:
         """,
     )
 
+    parser.add_argument(
+        "--version", "-v",
+        action="version",
+        version=f"%(prog)s {__version__}",
+        help="Show version information and exit",
+    )
+    
+    parser.add_argument(
+        "--help", "-h",
+        action="help",
+        help="Show this help message and exit",
+    )
+    
     parser.add_argument(
         "command",
         nargs="?",

{todo_agent-0.3.2.dist-info → todo_agent-0.3.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: todo-agent
-Version: 0.3.2
+Version: 0.3.5
 Summary: A natural language interface for todo.sh task management
 Author: codeprimate
 Maintainer: codeprimate

todo_agent-0.3.5.dist-info/RECORD

@@ -0,0 +1,30 @@
+todo_agent/__init__.py,sha256=RUowhd14r3tqB_7rl83unGV8oBjra3UOIl7jix-33fk,254
+todo_agent/_version.py,sha256=UAb2Toi6SAdScDfq1uKRRv5QpMUuRtJqqwNxTMGe5Q4,704
+todo_agent/main.py,sha256=DfcZuTsHkmpm6kw0coB0-B677K3hyRwutWIuO4noQ3w,2026
+todo_agent/core/__init__.py,sha256=QAZ4it63pXv5-DxtNcuSAmg7ZnCY5ackI5yycvKHr9I,365
+todo_agent/core/conversation_manager.py,sha256=9aAWogswZe9Cs7wKT47RG-cLh1LQ5D9RbhUHJVUyTS8,13549
+todo_agent/core/exceptions.py,sha256=ilVL5hyPHGYQXsLm0pYivMbhbamupG77r8TbiQr2tAU,2034
+todo_agent/core/todo_manager.py,sha256=qnMT6TOhxvh-e_2IkC8rA87T56iJQ9mHT1AyffrAFr8,25134
+todo_agent/infrastructure/__init__.py,sha256=SGbHXgzq6U1DMgOfWPMsWEK99zjPSF-6gzy7xqc5fsI,284
+todo_agent/infrastructure/calendar_utils.py,sha256=8tOZHN5CNrRHpTQHYzskmsZNJKWuUFjrjyvHQ76AhzU,1837
+todo_agent/infrastructure/config.py,sha256=zyp6qOlg1nN_awphivlgGNBE6fL0Hf66YgvWxR8ldyQ,2117
+todo_agent/infrastructure/inference.py,sha256=nv0ZbYHiJtWOwsN1VoXY1f0Zlf9SOIOVQZDhnAeC1YU,16212
+todo_agent/infrastructure/llm_client.py,sha256=Knb6yvQt0q8mobnwVH08mGCd8xBHK_g1S66DOdp7cO8,9807
+todo_agent/infrastructure/llm_client_factory.py,sha256=-tktnVOIF7B45WR7AuLoi7MKnEyuM8lgg1jjc4T1FhM,1929
+todo_agent/infrastructure/logger.py,sha256=2ykG_0lyzmEGxDF6ZRl1qiTUGDuFeQgzv4Na6vRmXcM,4110
+todo_agent/infrastructure/ollama_client.py,sha256=V_zAeBjIEzB8PZXyzFeiLMLA5qf3y4WV2_6Vqxn1ujc,5629
+todo_agent/infrastructure/openrouter_client.py,sha256=0pxIKvHItwVijFz8l4loOeCa4HUpMvTYROcwYJh3iyI,6748
+todo_agent/infrastructure/todo_shell.py,sha256=2iPPhsLsTcjVx8Wv2mJJBu11kLJOK9Tk5KBAyVQ3Yjs,20596
+todo_agent/infrastructure/token_counter.py,sha256=PCKheOVJbp1s89yhh_i6iKgURMt9mVoYkwjQJCc2xCE,4958
+todo_agent/infrastructure/prompts/system_prompt.txt,sha256=ZHGYgd7lCuWaSX5io3IYWFhdjcGbdqKXf2uhEWdbzQ8,12380
+todo_agent/interface/__init__.py,sha256=vDD3rQu4qDkpvVwGVtkDzE1M4IiSHYzTif4GbYSFWaI,457
+todo_agent/interface/cli.py,sha256=Ikh5AYoOZnNUVXzHjfv2bsE33yK3VhCdzza83HOzFp8,16460
+todo_agent/interface/formatters.py,sha256=a9PW-5DbY8K5QYZjBXFZSdzlCmy263kwBI9nXgP8LXI,20081
+todo_agent/interface/progress.py,sha256=EpPa20Hrnjv_TBIp0tzViVciThqsOvAHuYO4v2rc8eI,1751
+todo_agent/interface/tools.py,sha256=Q6h2zpe1yRUwJOZZFArjXgBN6WPDI56CDQQJcdF1I5M,54448
+todo_agent-0.3.5.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+todo_agent-0.3.5.dist-info/METADATA,sha256=eP-pVo55MQvK1G9b9vaoOhir6fQnjOr4CD-D8n29Ha0,10056
+todo_agent-0.3.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+todo_agent-0.3.5.dist-info/entry_points.txt,sha256=4W7LrCib6AXP5IZDwWRht8S5gutLu5oNfTJHGbt4oHs,52
+todo_agent-0.3.5.dist-info/top_level.txt,sha256=a65mlPIhPZHuq2bRIi_sCMAIJsUddvXt171OBF6r6co,11
+todo_agent-0.3.5.dist-info/RECORD,,

todo_agent-0.3.2.dist-info/RECORD

@@ -1,30 +0,0 @@
-todo_agent/__init__.py,sha256=RUowhd14r3tqB_7rl83unGV8oBjra3UOIl7jix-33fk,254
-todo_agent/_version.py,sha256=e8NqPtZ8fggRgk3GPrqZ_U_BDV8aSULw1u_Gn9NNbnk,704
-todo_agent/main.py,sha256=-ryhMm4c4sz4e4anXI8B-CYnpEh5HIkmnYcnGxcWHDk,1628
-todo_agent/core/__init__.py,sha256=QAZ4it63pXv5-DxtNcuSAmg7ZnCY5ackI5yycvKHr9I,365
-todo_agent/core/conversation_manager.py,sha256=9aAWogswZe9Cs7wKT47RG-cLh1LQ5D9RbhUHJVUyTS8,13549
-todo_agent/core/exceptions.py,sha256=kH-xf30H1vlMHk7GTWclkhIdR_mGPylYu4vWiTl7_zA,2058
-todo_agent/core/todo_manager.py,sha256=H-cBB0wm9_KdHBWm9bGJVpoNYRgikSegLpFE4QcJOAw,18991
-todo_agent/infrastructure/__init__.py,sha256=SGbHXgzq6U1DMgOfWPMsWEK99zjPSF-6gzy7xqc5fsI,284
-todo_agent/infrastructure/calendar_utils.py,sha256=8tOZHN5CNrRHpTQHYzskmsZNJKWuUFjrjyvHQ76AhzU,1837
-todo_agent/infrastructure/config.py,sha256=zyp6qOlg1nN_awphivlgGNBE6fL0Hf66YgvWxR8ldyQ,2117
-todo_agent/infrastructure/inference.py,sha256=lsaxfXu5gJIy9vkX9qbX9jtZL4XGpRT9KNbcNU-4tro,14683
-todo_agent/infrastructure/llm_client.py,sha256=zkgET3tbLK7utLzrhKFxLxSDhEeJ2DuCSZ8FFYceZQk,9371
-todo_agent/infrastructure/llm_client_factory.py,sha256=-tktnVOIF7B45WR7AuLoi7MKnEyuM8lgg1jjc4T1FhM,1929
-todo_agent/infrastructure/logger.py,sha256=2ykG_0lyzmEGxDF6ZRl1qiTUGDuFeQgzv4Na6vRmXcM,4110
-todo_agent/infrastructure/ollama_client.py,sha256=9qwY1fdwh9H55HJoNvXZS0xm2ooAXRKqYYsYrmJOetM,5570
-todo_agent/infrastructure/openrouter_client.py,sha256=jWzGBnr9tqt4HFGUyVLjjUpM3QGMcdDsjCH6pT3CmFE,6727
-todo_agent/infrastructure/todo_shell.py,sha256=NwbXTRF3dLNKzBYPS_4ObG-R1UV1dzXXf2asyKi36x0,17199
-todo_agent/infrastructure/token_counter.py,sha256=PCKheOVJbp1s89yhh_i6iKgURMt9mVoYkwjQJCc2xCE,4958
-todo_agent/infrastructure/prompts/system_prompt.txt,sha256=yXyYWJeB7IV6QK7NnywdUwPL_dKV0fxUD38hxr2Bc90,22984
-todo_agent/interface/__init__.py,sha256=vDD3rQu4qDkpvVwGVtkDzE1M4IiSHYzTif4GbYSFWaI,457
-todo_agent/interface/cli.py,sha256=5mUgCz3kJUfko5bVbpkWcMDvDPY_ysJhMEpbQlwBnBY,16226
-todo_agent/interface/formatters.py,sha256=81Rud5tw7p3eSsXf6Ifuii8Iy7igT8kkX8eltHZ6l9A,20077
-todo_agent/interface/progress.py,sha256=fcBSB1xodQ1xE7iU5hWe_G3t4_rE6lJpoqeCuazTnis,1811
-todo_agent/interface/tools.py,sha256=A09LSxbobvHUu8XfEYTYs5uiM7bVgaqAvbY0qEcSYGI,51373
-todo_agent-0.3.2.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-todo_agent-0.3.2.dist-info/METADATA,sha256=IVSq9-aM-JkzSEHWPVOrvkW3PwjqSbaXEW4SIOo-CCc,10056
-todo_agent-0.3.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-todo_agent-0.3.2.dist-info/entry_points.txt,sha256=4W7LrCib6AXP5IZDwWRht8S5gutLu5oNfTJHGbt4oHs,52
-todo_agent-0.3.2.dist-info/top_level.txt,sha256=a65mlPIhPZHuq2bRIi_sCMAIJsUddvXt171OBF6r6co,11
-todo_agent-0.3.2.dist-info/RECORD,,