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

todo_agent/interface/tools.py

@@ -10,22 +10,24 @@ Discovery Tools (Call FIRST):
 - list_completed_tasks() - List all completed tasks from done.txt
 
 Task Management Tools:
-- add_task(description, priority?, project?, context?, due?, recurring?) - Add new task to todo.txt
+- add_task(description, priority?, project?, context?, due?, duration?) - Add new task to todo.txt
 - complete_task(task_number) - Mark task as complete by line number
 - replace_task(task_number, new_description) - Replace entire task content
 - 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
 
 Priority Management Tools:
 - set_priority(task_number, priority) - Set or change task priority (A-Z)
 - remove_priority(task_number) - Remove priority from task
+
+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)
 
 Utility Tools:
-- get_overview() - Show task statistics and summary
 - move_task(task_number, destination, source?) - Move task between files
 - archive_tasks() - Archive completed tasks from todo.txt to done.txt
 - get_calendar(month, year) - Get calendar for specific month and year
@@ -68,6 +70,7 @@ class ToolCallHandler:
                     ),
                     "parameters": {"type": "object", "properties": {}, "required": []},
                 },
+                "progress_description": "📁 Discovering available projects...",
             },
             {
                 "type": "function",
@@ -83,6 +86,7 @@ class ToolCallHandler:
                     ),
                     "parameters": {"type": "object", "properties": {}, "required": []},
                 },
+                "progress_description": "📍 Finding available contexts...",
             },
             {
                 "type": "function",
@@ -102,6 +106,7 @@ class ToolCallHandler:
                     ),
                     "parameters": {"type": "object", "properties": {}, "required": []},
                 },
+                "progress_description": "📋 Scanning your task list...",
             },
             {
                 "type": "function",
@@ -120,6 +125,7 @@ class ToolCallHandler:
                     ),
                     "parameters": {"type": "object", "properties": {}, "required": []},
                 },
+                "progress_description": "✅ Checking completion history...",
             },
             {
                 "type": "function",
@@ -166,10 +172,6 @@ class ToolCallHandler:
                                 "type": "string",
                                 "description": "Optional due date in YYYY-MM-DD format. Use parse_date() tool to convert natural language expressions like 'tomorrow', 'next week', 'by Friday' to YYYY-MM-DD format",
                             },
-                            "recurring": {
-                                "type": "string",
-                                "description": "Optional recurring pattern in rec:frequency[:interval] format (e.g., 'rec:daily', 'rec:weekly:2', 'rec:monthly'). Use for tasks that repeat automatically.",
-                            },
                             "duration": {
                                 "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.",
@@ -178,6 +180,7 @@ class ToolCallHandler:
                         "required": ["description"],
                     },
                 },
+                "progress_description": "➕ Creating new task...",
             },
             {
                 "type": "function",
@@ -201,6 +204,7 @@ class ToolCallHandler:
                         "required": ["task_number"],
                     },
                 },
+                "progress_description": "🎯 Marking task complete...",
             },
             {
                 "type": "function",
@@ -228,6 +232,7 @@ class ToolCallHandler:
                         "required": ["task_number", "new_description"],
                     },
                 },
+                "progress_description": "✏️ Updating task description...",
             },
             {
                 "type": "function",
@@ -249,14 +254,15 @@ class ToolCallHandler:
                                 "type": "integer",
                                 "description": "The line number of the task to modify (required)",
                             },
-                            "text": {
+                            "text_to_append": {
                                 "type": "string",
-                                "description": "The text to append to the task (required)",
+                                "description": "Text to add to the end of the task (required)",
                             },
                         },
-                        "required": ["task_number", "text"],
+                        "required": ["task_number", "text_to_append"],
                     },
                 },
+                "progress_description": "📝 Adding notes to task...",
             },
             {
                 "type": "function",
@@ -283,6 +289,7 @@ class ToolCallHandler:
                         "required": ["task_number", "text"],
                     },
                 },
+                "progress_description": "📝 Adding prefix to task...",
             },
             {
                 "type": "function",
@@ -313,6 +320,7 @@ class ToolCallHandler:
                         "required": ["task_number"],
                     },
                 },
+                "progress_description": "🗑️ Deleting task...",
             },
             {
                 "type": "function",
@@ -340,6 +348,7 @@ class ToolCallHandler:
                         "required": ["task_number", "priority"],
                     },
                 },
+                "progress_description": "🏷️ Setting priority...",
             },
             {
                 "type": "function",
@@ -363,6 +372,7 @@ class ToolCallHandler:
                         "required": ["task_number"],
                     },
                 },
+                "progress_description": "🏷️ Removing priority...",
             },
             {
                 "type": "function",
@@ -394,6 +404,7 @@ class ToolCallHandler:
                         "required": ["task_number", "due_date"],
                     },
                 },
+                "progress_description": "📅 Setting due date...",
             },
             {
                 "type": "function",
@@ -425,6 +436,7 @@ class ToolCallHandler:
                         "required": ["task_number", "context"],
                     },
                 },
+                "progress_description": "📍 Setting context...",
             },
             {
                 "type": "function",
@@ -460,17 +472,7 @@ class ToolCallHandler:
                         "required": ["task_number", "projects"],
                     },
                 },
-            },
-            {
-                "type": "function",
-                "function": {
-                    "name": "get_overview",
-                    "description": (
-                        "Show task statistics and summary. Use this when user asks for "
-                        "an overview, summary, or statistics about their tasks."
-                    ),
-                    "parameters": {"type": "object", "properties": {}, "required": []},
-                },
+                "progress_description": "🏷️ Setting project tags...",
             },
             {
                 "type": "function",
@@ -502,6 +504,7 @@ class ToolCallHandler:
                         "required": ["task_number", "destination"],
                     },
                 },
+                "progress_description": "📦 Moving task...",
             },
             {
                 "type": "function",
@@ -514,6 +517,7 @@ class ToolCallHandler:
                     ),
                     "parameters": {"type": "object", "properties": {}, "required": []},
                 },
+                "progress_description": "📦 Archiving completed tasks...",
             },
             {
                 "type": "function",
@@ -540,6 +544,7 @@ class ToolCallHandler:
                         "required": ["date_expression"],
                     },
                 },
+                "progress_description": "📅 Converting date expression...",
             },
             {
                 "type": "function",
@@ -575,6 +580,73 @@ class ToolCallHandler:
                         "required": ["month", "year"],
                     },
                 },
+                "progress_description": "📅 Generating calendar...",
+            },
+            {
+                "type": "function",
+                "function": {
+                    "name": "created_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') "
+                        "and you have already researched existing tasks to determine no match exists. "
+                        "WORKFLOW: 1) Use list_tasks() to search for existing tasks, 2) Use list_completed_tasks() to verify it's not already done, "
+                        "3) If no match found, call this tool to create and complete the task in one operation. "
+                        "STRATEGIC CONTEXT: This is a convenience tool for the common pattern of 'I did X on [date]' - "
+                        "it creates a task with the specified completion date and immediately marks it complete. "
+                        "The LLM should handle the research and decision-making about whether to use this tool."
+                    ),
+                    "parameters": {
+                        "type": "object",
+                        "properties": {
+                            "description": {
+                                "type": "string",
+                                "description": "The task description of what was completed (required)",
+                            },
+                            "completion_date": {
+                                "type": "string",
+                                "description": "Optional completion date in YYYY-MM-DD format (defaults to today)",
+                            },
+                            "project": {
+                                "type": "string",
+                                "description": "Optional project name (without the + symbol) for new task creation",
+                            },
+                            "context": {
+                                "type": "string",
+                                "description": "Optional context name (without the @ symbol) for new task creation",
+                            },
+                        },
+                        "required": ["description"],
+                    },
+                },
+                "progress_description": "✅ Creating completed task...",
+            },
+            {
+                "type": "function",
+                "function": {
+                    "name": "restore_completed_task",
+                    "description": (
+                        "Restore a completed task from done.txt back to todo.txt, making it active again. "
+                        "USE CASE: Call this when user wants to reactivate a previously completed task. "
+                        "WORKFLOW: 1) Use list_completed_tasks() to find the completed task to restore, "
+                        "2) Call restore_completed_task() with the task number from done.txt. "
+                        "NOT FOR: Creating new tasks, completing tasks, or any other task operations. "
+                        "This tool ONLY restores existing completed tasks to active status. "
+                        "IMPORTANT: Use list_completed_tasks() first to find the correct task number "
+                        "if user doesn't specify it."
+                    ),
+                    "parameters": {
+                        "type": "object",
+                        "properties": {
+                            "task_number": {
+                                "type": "integer",
+                                "description": "The line number of the completed task in done.txt to restore (required)",
+                            }
+                        },
+                        "required": ["task_number"],
+                    },
+                },
+                "progress_description": "🔄 Restoring completed task...",
             },
         ]
 
@@ -731,8 +803,54 @@ class ToolCallHandler:
 
     def execute_tool(self, tool_call: Dict[str, Any]) -> Dict[str, Any]:
         """Execute a tool call and return the result."""
-        tool_name = tool_call["function"]["name"]
-        arguments = tool_call["function"]["arguments"]
+        # Validate tool call structure
+        if not isinstance(tool_call, dict):
+            return {
+                "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."
+            }
+            
+        if "function" not in tool_call:
+            return {
+                "tool_call_id": tool_call.get("id", "unknown"),
+                "name": "unknown",
+                "output": "ERROR: Tool call missing function definition",
+                "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."
+            }
+            
+        function = tool_call["function"]
+        if not isinstance(function, dict):
+            return {
+                "tool_call_id": tool_call.get("id", "unknown"),
+                "name": "unknown",
+                "output": "ERROR: Function definition is not a dictionary",
+                "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."
+            }
+            
+        tool_name = function.get("name")
+        if not tool_name:
+            return {
+                "tool_call_id": tool_call.get("id", "unknown"),
+                "name": "unknown",
+                "output": "ERROR: Tool call missing function name",
+                "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."
+            }
+            
+        arguments = function.get("arguments", {})
         tool_call_id = tool_call.get("id", "unknown")
 
         # Handle arguments that might be a string (JSON) or already a dict
@@ -779,11 +897,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,
-            "get_overview": self.todo_manager.get_overview,
             "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,
+            "restore_completed_task": self.todo_manager.restore_completed_task,
         }
 
         if tool_name not in method_map:

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: todo-agent
-Version: 0.3.1
+Version: 0.3.2
 Summary: A natural language interface for todo.sh task management
 Author: codeprimate
 Maintainer: codeprimate
@@ -68,7 +68,7 @@ todo-agent "show my work tasks"
 
 **Get intelligent insights** beyond basic task lists. It organizes tasks strategically, suggests priorities, and recommends optimal timing based on your patterns.
 
-**Work smarter** with automatic duplicate detection, recurring task handling, and calendar-aware scheduling.
+**Work smarter** with automatic duplicate detection and calendar-aware scheduling.
 
 **Choose your privacy** - use cloud AI (OpenRouter) or run locally (Ollama).
 
@@ -163,7 +163,7 @@ todo-agent "what tasks are blocking other work?"
 ### Natural Language Intelligence
 ```bash
 todo-agent "add dentist appointment next Monday"
-todo-agent "set up recurring daily vitamin reminder"
+
 todo-agent "move all completed tasks to archive"
 todo-agent "show me tasks I can do from home"
 ```

todo_agent-0.3.2.dist-info/RECORD

@@ -0,0 +1,30 @@
+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,,

todo_agent-0.3.1.dist-info/RECORD

@@ -1,29 +0,0 @@
-todo_agent/__init__.py,sha256=RUowhd14r3tqB_7rl83unGV8oBjra3UOIl7jix-33fk,254
-todo_agent/_version.py,sha256=gGLpQUQx-ty9SEy9PYw9OgJWWzJLBnCpfJOfzL7SjlI,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=nRFcDMqZtumVipggzVe94Hwz9HDbc2CrTssk_HImwEI,13548
-todo_agent/core/exceptions.py,sha256=cPvvkIbKdI7l51wC7cE-ZxUi54P3nf2m7x2lMNMRFYM,399
-todo_agent/core/todo_manager.py,sha256=wOgwXZCS5xZw7lHDnIar0L8r1pvgdUguu6kmFF9xSi8,16282
-todo_agent/infrastructure/__init__.py,sha256=SGbHXgzq6U1DMgOfWPMsWEK99zjPSF-6gzy7xqc5fsI,284
-todo_agent/infrastructure/calendar_utils.py,sha256=HmF0ykXF_6GbdoJvZLIv6fKwT6ipixoywdTMkIXmkGU,1871
-todo_agent/infrastructure/config.py,sha256=zyp6qOlg1nN_awphivlgGNBE6fL0Hf66YgvWxR8ldyQ,2117
-todo_agent/infrastructure/inference.py,sha256=T_xwSd2oB5CsPKExJoQ_RahpMB4U0PKIOUMR0vQyE5I,11883
-todo_agent/infrastructure/llm_client.py,sha256=ZoObyqaRP6i_eqGYGfJWGeWTJ-VNxpY70ay04vt2v_E,1390
-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=RVgHqX37k7q5xEaEXdhcCv2HYQiszs1QV39RxFFMIas,5902
-todo_agent/infrastructure/openrouter_client.py,sha256=2Ysf69z265dgkgDMLJR92v26-32DkuSAqKSN-ZCEX_Y,6948
-todo_agent/infrastructure/todo_shell.py,sha256=0-GT_ReYMPCujy1KrB5PEQ98fbIZJm9-sVre5iCkFYE,17633
-todo_agent/infrastructure/token_counter.py,sha256=PCKheOVJbp1s89yhh_i6iKgURMt9mVoYkwjQJCc2xCE,4958
-todo_agent/infrastructure/prompts/system_prompt.txt,sha256=sin8wOFrDntTgKL1udlwE3iNxf_Pk1H1ZGzxGon23Wc,18931
-todo_agent/interface/__init__.py,sha256=vDD3rQu4qDkpvVwGVtkDzE1M4IiSHYzTif4GbYSFWaI,457
-todo_agent/interface/cli.py,sha256=rSHJjSlKEV8dirCcMT1zX55i8raMOE_3IB6CUFGLgiI,12094
-todo_agent/interface/formatters.py,sha256=DiQLemndiuFWjLcBRPpu1wVnJcoYAFP8t_fJstOgaDs,18918
-todo_agent/interface/tools.py,sha256=nPO4Sx-JlRUv0-JTzg6caSdDr7tGLGagMvEqblnDJfU,44364
-todo_agent-0.3.1.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-todo_agent-0.3.1.dist-info/METADATA,sha256=HXdjiFn4ELWARfPjhQjpLY8lx2tiHezZ7ylkvQ8EXsI,10134
-todo_agent-0.3.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-todo_agent-0.3.1.dist-info/entry_points.txt,sha256=4W7LrCib6AXP5IZDwWRht8S5gutLu5oNfTJHGbt4oHs,52
-todo_agent-0.3.1.dist-info/top_level.txt,sha256=a65mlPIhPZHuq2bRIi_sCMAIJsUddvXt171OBF6r6co,11
-todo_agent-0.3.1.dist-info/RECORD,,