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

todo_agent/interface/tools.py

@@ -6,26 +6,28 @@ AVAILABLE TOOLS:
 Discovery Tools (Call FIRST):
 - list_projects() - Get all available projects from todo.txt
 - list_contexts() - Get all available contexts from todo.txt
-- list_tasks(filter?) - List current tasks with optional filtering
-- list_completed_tasks(filter?, project?, context?, text_search?, date_from?, date_to?) - List completed tasks with optional filtering
+- list_tasks() - List all current tasks from todo.txt
+- 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,132 +86,67 @@ class ToolCallHandler:
                     ),
                     "parameters": {"type": "object", "properties": {}, "required": []},
                 },
+                "progress_description": "📍 Finding available contexts...",
             },
             {
                 "type": "function",
                 "function": {
                     "name": "list_tasks",
                     "description": (
-                        "List current tasks with optional filtering. Use this when: "
+                        "List all current tasks from todo.txt. Use this when: "
                         "1) User wants to see their tasks, "
-                        "2) You need to find a specific task by description, "
-                        "3) You need to check for potential duplicates before adding new tasks, "
-                        "4) You need to understand the current state before making changes, "
-                        "5) User says they finished/completed a task and you need to find the matching task. "
+                        "2) You need to check for potential duplicates before adding new tasks, "
+                        "3) You need to understand the current state before making changes, "
+                        "4) User says they finished/completed a task and you need to find the matching task. "
                         "CRITICAL: ALWAYS use this before add_task() to check for similar existing tasks. "
                         "CRITICAL: ALWAYS use this when user mentions task completion to find the correct task number. "
-                        "COMPLETION INTELLIGENCE: When searching for completion matches, if exactly one task clearly "
-                        "matches the user's description, proceed to complete it immediately without asking for confirmation. "
-                        "IMPORTANT: When presenting the results to the user, convert the raw todo.txt format "
-                        "into conversational language. Do not show the raw format like '(A) task +project @context'. "
                         "STRATEGIC CONTEXT: This is the primary discovery tool - call this FIRST when you need to "
-                        "understand existing tasks before making any modifications."
+                        "understand existing tasks before making any modifications. Always get the complete task list "
+                        "for full context rather than trying to filter."
                     ),
-                    "parameters": {
-                        "type": "object",
-                        "properties": {
-                            "filter": {
-                                "type": "string",
-                                "description": (
-                                    "Optional filter string (e.g., '+work', '@office', '(A)') - "
-                                    "use when you want to see only specific tasks or when searching for completion matches"
-                                ),
-                            }
-                        },
-                        "required": [],
-                    },
+                    "parameters": {"type": "object", "properties": {}, "required": []},
                 },
+                "progress_description": "📋 Scanning your task list...",
             },
             {
                 "type": "function",
                 "function": {
                     "name": "list_completed_tasks",
                     "description": (
-                        "List completed tasks from done.txt with optional filtering. Use this when: "
+                        "List all completed tasks from done.txt. Use this when: "
                         "1) User tries to complete a task that might already be done, "
                         "2) User asks about completed tasks, "
                         "3) You need to verify task status before taking action, "
-                        "4) User wants to search for specific completed tasks by project, context, text, or date. "
+                        "4) User wants to see their task completion history. "
                         "STRATEGIC CONTEXT: Call this BEFORE complete_task() to verify the task hasn't already "
                         "been completed, preventing duplicate completion attempts. "
-                        "FILTERING: Use the filtering parameters to help users find specific completed tasks "
-                        "when they ask about work tasks, home tasks, tasks from a specific date, etc. "
-                        "DATE FILTERING LIMITATIONS: Due to todo.sh constraints, date filtering has specific behavior: "
-                        "• When both date_from and date_to are provided, filtering uses the year-month pattern (YYYY-MM) "
-                        "from date_from, matching all tasks in that month. "
-                        "• When only date_from is provided, filtering uses the exact date pattern (YYYY-MM-DD). "
-                        "• When only date_to is provided, filtering uses the year-month pattern (YYYY-MM) from date_to. "
-                        "• Complex date ranges (e.g., spanning multiple months) are not supported by todo.sh."
+                        "Always get the complete completed task list for full historical context rather than "
+                        "trying to filter by specific criteria."
                     ),
-                    "parameters": {
-                        "type": "object",
-                        "properties": {
-                            "filter": {
-                                "type": "string",
-                                "description": (
-                                    "Optional raw filter string (e.g., '+work', '@office') - "
-                                    "use for advanced filtering when other parameters aren't sufficient"
-                                ),
-                            },
-                            "project": {
-                                "type": "string",
-                                "description": (
-                                    "Optional project name to filter by (without the + symbol) - "
-                                    "e.g., 'work', 'home', 'bills'"
-                                ),
-                            },
-                            "context": {
-                                "type": "string",
-                                "description": (
-                                    "Optional context name to filter by (without the @ symbol) - "
-                                    "e.g., 'office', 'home', 'phone'"
-                                ),
-                            },
-                            "text_search": {
-                                "type": "string",
-                                "description": (
-                                    "Optional text to search for in task descriptions - "
-                                    "e.g., 'review', 'call', 'email'"
-                                ),
-                            },
-                            "date_from": {
-                                "type": "string",
-                                "description": (
-                                    "Optional start date for filtering (YYYY-MM-DD format) - "
-                                    "e.g., '2025-08-01'. When used alone, matches exact date. "
-                                    "When used with date_to, uses year-month pattern (YYYY-MM) for month-based filtering."
-                                ),
-                            },
-                            "date_to": {
-                                "type": "string",
-                                "description": (
-                                    "Optional end date for filtering (YYYY-MM-DD format) - "
-                                    "e.g., '2025-08-31'. When used alone, uses year-month pattern (YYYY-MM) "
-                                    "for month-based filtering. When used with date_from, uses date_from's year-month pattern."
-                                ),
-                            },
-                        },
-                        "required": [],
-                    },
+                    "parameters": {"type": "object", "properties": {}, "required": []},
                 },
+                "progress_description": "✅ Checking completion history...",
             },
             {
                 "type": "function",
                 "function": {
                     "name": "add_task",
                     "description": (
-                        "Add a new task to todo.txt. CRITICAL: Before adding ANY task, you MUST "
-                        "use list_tasks() and list_completed_tasks() to check for potential duplicates. Look for tasks with "
-                        "similar descriptions, keywords, or intent. If you find similar tasks, "
+                        "Add a NEW task to todo.txt with intelligent automatic inference capabilities. "
+                        "USE CASE: Call this when user wants to create a NEW task, not when they want to complete, modify, or work with existing tasks. "
+                        "CRITICAL: Before adding ANY task, you MUST use list_tasks() and list_completed_tasks() to check for potential duplicates. "
+                        "Look for tasks with similar descriptions, keywords, or intent. If you find similar tasks, "
                         "ask the user if they want to add a new task or modify an existing one. "
-                        "AUTOMATIC INFERENCE: When project, context, or due date is not specified, automatically infer appropriate tags "
-                        "and due dates based on the task content, natural language expressions, task nature, calendar context, and existing patterns. "
-                        "DUE DATE INFERENCE: Use parse_date() tool to convert any temporal expressions to YYYY-MM-DD format. "
-                        "Extract temporal expressions and use common sense to infer appropriate due dates based on task type, "
-                        "work patterns, personal schedules, and existing task due date patterns. Only ask for clarification when genuinely ambiguous. "
-                        "Always provide a complete, natural response to the user. "
-                        "STRATEGIC CONTEXT: This is a modification tool - call this LAST after using "
-                        "discovery tools (list_tasks, list_projects, list_contexts list_completed_tasks) "
+                        "INTELLIGENT INFERENCE ENGINE: This tool automatically infers missing elements to create complete, actionable tasks: "
+                        "PROJECT INFERENCE: Automatically detect and add appropriate +project tags based on task keywords, semantic patterns, and existing project usage. "
+                        "CONTEXT INFERENCE: Automatically infer @context tags from task nature, location requirements, and historical context patterns. "
+                        "DUE DATE INFERENCE: Use parse_date() tool to convert natural language expressions ('tomorrow', 'next week', 'by Friday') to YYYY-MM-DD format. "
+                        "Apply strategic timing based on task type, work patterns, personal schedules, and existing due date patterns. "
+                        "DURATION INFERENCE: Automatically estimate appropriate duration: tags based on task complexity, context, and historical patterns. "
+                        "PRIORITY INFERENCE: Suggest appropriate priority levels (A-Z) based on urgency, importance, and existing priority patterns. "
+                        "Only ask for clarification when genuinely ambiguous. Always provide a complete, natural response to the user. "
+                        "STRATEGIC CONTEXT: This is a CREATION tool - call this LAST after using "
+                        "discovery tools (list_tasks, list_projects, list_contexts, list_completed_tasks) "
                         "to gather all necessary context and verify no duplicates exist."
                     ),
                     "parameters": {
@@ -234,28 +172,26 @@ 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": {
+                            "duration": {
                                 "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.",
+                                "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.",
                             },
                         },
                         "required": ["description"],
                     },
                 },
+                "progress_description": "➕ Creating new task...",
             },
             {
                 "type": "function",
                 "function": {
                     "name": "complete_task",
                     "description": (
-                        "Mark a specific task as complete by its line number. IMPORTANT: "
-                        "When user says they finished/completed a task, FIRST use list_tasks() to find matching tasks, "
-                        "then list_completed_tasks() to verify it's not already done. "
-                        "COMPLETION LOGIC: If user's statement clearly matches exactly one task, complete it immediately. "
-                        "If multiple tasks match, show numbered options and ask for clarification. "
-                        "If the match is ambiguous, ask for confirmation. "
-                        "STRATEGIC CONTEXT: This is a modification tool - call this LAST after using "
-                        "discovery tools (list_tasks, list_completed_tasks) to verify the task exists and status."
+                        "Mark an existing task as complete by its line number. "
+                        "USE CASE: Only call this when user explicitly states they have finished/completed a task. "
+                        "WORKFLOW: 1) Use list_tasks() to find the task to complete, 2) Use list_completed_tasks() to verify it's not already done, 3) Call complete_task() with the task number. "
+                        "NOT FOR: Adding new tasks, modifying task content, or any other task operations. "
+                        "This tool ONLY marks existing tasks as complete."
                     ),
                     "parameters": {
                         "type": "object",
@@ -268,14 +204,17 @@ class ToolCallHandler:
                         "required": ["task_number"],
                     },
                 },
+                "progress_description": "🎯 Marking task complete...",
             },
             {
                 "type": "function",
                 "function": {
                     "name": "replace_task",
                     "description": (
-                        "Replace the entire content of a task. IMPORTANT: Use list_tasks() first "
-                        "to find the correct task number if user doesn't specify it. "
+                        "Replace the entire content of an EXISTING task. "
+                        "USE CASE: Call this when user wants to completely rewrite an existing task description. "
+                        "NOT FOR: Creating new tasks, completing tasks, or adding to tasks. "
+                        "Use list_tasks() first to find the correct task number if user doesn't specify it. "
                         "If multiple tasks match the description, ask for clarification."
                     ),
                     "parameters": {
@@ -293,18 +232,20 @@ class ToolCallHandler:
                         "required": ["task_number", "new_description"],
                     },
                 },
+                "progress_description": "✏️ Updating task description...",
             },
             {
                 "type": "function",
                 "function": {
                     "name": "append_to_task",
                     "description": (
-                        "Add text to the end of an existing task. Use this when user wants "
-                        "to add additional information to a task without replacing it entirely. "
+                        "Add text to the end of an EXISTING task. "
+                        "USE CASE: Call this when user wants to add additional descriptive text, notes, or comments to an existing task. "
+                        "NOT FOR: Creating new tasks, completing tasks, or adding project/context/due date tags. "
                         "CRITICAL: DO NOT use this for adding project tags (+project) or context tags (@context) - "
                         "use set_project() or set_context() instead. "
                         "DO NOT use this for adding due dates - use set_due_date() instead. "
-                        "This tool is for adding descriptive text, notes, or comments to tasks."
+                        "This tool is ONLY for adding descriptive text, notes, or comments to existing tasks."
                     ),
                     "parameters": {
                         "type": "object",
@@ -313,22 +254,25 @@ 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",
                 "function": {
                     "name": "prepend_to_task",
                     "description": (
-                        "Add text to the beginning of an existing task. Use this when user "
-                        "wants to add a prefix or modifier to a task."
+                        "Add text to the beginning of an EXISTING task. "
+                        "USE CASE: Call this when user wants to add a prefix or modifier to an existing task. "
+                        "NOT FOR: Creating new tasks, completing tasks, or adding project/context/due date tags. "
+                        "This tool is ONLY for modifying existing tasks by adding text at the beginning."
                     ),
                     "parameters": {
                         "type": "object",
@@ -345,13 +289,16 @@ class ToolCallHandler:
                         "required": ["task_number", "text"],
                     },
                 },
+                "progress_description": "📝 Adding prefix to task...",
             },
             {
                 "type": "function",
                 "function": {
                     "name": "delete_task",
                     "description": (
-                        "Delete an entire task or remove a specific term from a task. "
+                        "Delete an entire EXISTING task or remove a specific term from an EXISTING task. "
+                        "USE CASE: Call this when user wants to delete a task completely or remove specific text from an existing task. "
+                        "NOT FOR: Creating new tasks, completing tasks, or any other task operations. "
                         "IMPORTANT: Use list_tasks() first to find the correct task number "
                         "if user doesn't specify it."
                     ),
@@ -373,13 +320,16 @@ class ToolCallHandler:
                         "required": ["task_number"],
                     },
                 },
+                "progress_description": "🗑️ Deleting task...",
             },
             {
                 "type": "function",
                 "function": {
                     "name": "set_priority",
                     "description": (
-                        "Set or change the priority of a task (A-Z, where A is highest). "
+                        "Set or change the priority of an EXISTING task (A-Z, where A is highest). "
+                        "USE CASE: Call this when user wants to add, change, or remove priority on an existing task. "
+                        "NOT FOR: Creating new tasks, completing tasks, or any other task operations. "
                         "IMPORTANT: Use list_tasks() first to find the correct task number "
                         "if user doesn't specify it."
                     ),
@@ -398,13 +348,17 @@ class ToolCallHandler:
                         "required": ["task_number", "priority"],
                     },
                 },
+                "progress_description": "🏷️ Setting priority...",
             },
             {
                 "type": "function",
                 "function": {
                     "name": "remove_priority",
                     "description": (
-                        "Remove the priority from a task. IMPORTANT: Use list_tasks() first "
+                        "Remove the priority from an EXISTING task. "
+                        "USE CASE: Call this when user wants to remove priority from an existing task. "
+                        "NOT FOR: Creating new tasks, completing tasks, or any other task operations. "
+                        "IMPORTANT: Use list_tasks() first "
                         "to find the correct task number if user doesn't specify it."
                     ),
                     "parameters": {
@@ -418,13 +372,16 @@ class ToolCallHandler:
                         "required": ["task_number"],
                     },
                 },
+                "progress_description": "🏷️ Removing priority...",
             },
             {
                 "type": "function",
                 "function": {
                     "name": "set_due_date",
                     "description": (
-                        "Set or update the due date for a task by intelligently rewriting it. "
+                        "Set or update the due date for an EXISTING task by intelligently rewriting it. "
+                        "USE CASE: Call this when user wants to add, change, or remove a due date 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, etc.) "
                         "while updating or adding the due date. Use empty string to remove the due date. "
                         "IMPORTANT: Use list_tasks() first "
@@ -447,13 +404,16 @@ class ToolCallHandler:
                         "required": ["task_number", "due_date"],
                     },
                 },
+                "progress_description": "📅 Setting due date...",
             },
             {
                 "type": "function",
                 "function": {
                     "name": "set_context",
                     "description": (
-                        "Set or update the context for a task by intelligently rewriting it. "
+                        "Set or update the context for an EXISTING task by intelligently rewriting it. "
+                        "USE CASE: Call this when user wants to add, change, or remove a context tag on an existing task. "
+                        "NOT FOR: Creating new tasks, completing tasks, or any other task operations. "
                         "This preserves all existing task components (priority, projects, due date, etc.) "
                         "while updating or adding the context. Use empty string to remove the context. "
                         "PREFERRED METHOD: Use this instead of append_to_task() when adding context tags (@context). "
@@ -476,13 +436,16 @@ class ToolCallHandler:
                         "required": ["task_number", "context"],
                     },
                 },
+                "progress_description": "📍 Setting context...",
             },
             {
                 "type": "function",
                 "function": {
                     "name": "set_project",
                     "description": (
-                        "Set or update projects for a task by intelligently rewriting it. "
+                        "Set or update projects for an EXISTING task by intelligently rewriting it. "
+                        "USE CASE: Call this when user wants to add, change, or remove project tags on an existing task. "
+                        "NOT FOR: Creating new tasks, completing tasks, or any other task operations. "
                         "This preserves all existing task components and manages projects intelligently. "
                         "Supports multiple projects, prevents duplicates, and groups them together. "
                         "Empty array or empty strings are NOOPs (no changes). "
@@ -509,24 +472,16 @@ 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",
                 "function": {
                     "name": "move_task",
                     "description": (
-                        "Move a task from one file to another (e.g., from todo.txt to done.txt). "
+                        "Move an EXISTING task from one file to another (e.g., from todo.txt to done.txt). "
+                        "USE CASE: Call this when user wants to move a task between different todo files. "
+                        "NOT FOR: Creating new tasks, completing tasks, or any other task operations. "
                         "IMPORTANT: Use list_tasks() first to find the correct task number "
                         "if user doesn't specify it."
                     ),
@@ -549,6 +504,7 @@ class ToolCallHandler:
                         "required": ["task_number", "destination"],
                     },
                 },
+                "progress_description": "📦 Moving task...",
             },
             {
                 "type": "function",
@@ -561,6 +517,7 @@ class ToolCallHandler:
                     ),
                     "parameters": {"type": "object", "properties": {}, "required": []},
                 },
+                "progress_description": "📦 Archiving completed tasks...",
             },
             {
                 "type": "function",
@@ -587,6 +544,7 @@ class ToolCallHandler:
                         "required": ["date_expression"],
                     },
                 },
+                "progress_description": "📅 Converting date expression...",
             },
             {
                 "type": "function",
@@ -622,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...",
             },
         ]
 
@@ -778,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
@@ -826,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: