feat: Add tool annotations for improved LLM tool understanding

src/index.ts

@@ -94,104 +94,164 @@ async function main() {
               "toolsDescription/planTask.md"
             ),
             inputSchema: zodToJsonSchema(planTaskSchema),
+            annotations: {
+              title: "Plan Task",
+              readOnlyHint: true,
+            },
           },
           {
             name: "analyze_task",
             description: await loadPromptFromTemplate(
               "toolsDescription/analyzeTask.md"
             ),
             inputSchema: zodToJsonSchema(analyzeTaskSchema),
+            annotations: {
+              title: "Analyze Task",
+              readOnlyHint: true,
+            },
           },
           {
             name: "reflect_task",
             description: await loadPromptFromTemplate(
               "toolsDescription/reflectTask.md"
             ),
             inputSchema: zodToJsonSchema(reflectTaskSchema),
+            annotations: {
+              title: "Reflect Task",
+              readOnlyHint: true,
+            },
           },
           {
             name: "split_tasks",
             description: await loadPromptFromTemplate(
               "toolsDescription/splitTasks.md"
             ),
             inputSchema: zodToJsonSchema(splitTasksRawSchema),
+            annotations: {
+              title: "Split Tasks",
+              destructiveHint: true,
+            },
           },
           {
             name: "list_tasks",
             description: await loadPromptFromTemplate(
               "toolsDescription/listTasks.md"
             ),
             inputSchema: zodToJsonSchema(listTasksSchema),
+            annotations: {
+              title: "List Tasks",
+              readOnlyHint: true,
+            },
           },
           {
             name: "execute_task",
             description: await loadPromptFromTemplate(
               "toolsDescription/executeTask.md"
             ),
             inputSchema: zodToJsonSchema(executeTaskSchema),
+            annotations: {
+              title: "Execute Task",
+              destructiveHint: true,
+            },
           },
           {
             name: "verify_task",
             description: await loadPromptFromTemplate(
               "toolsDescription/verifyTask.md"
             ),
             inputSchema: zodToJsonSchema(verifyTaskSchema),
+            annotations: {
+              title: "Verify Task",
+              readOnlyHint: true,
+            },
           },
           {
             name: "delete_task",
             description: await loadPromptFromTemplate(
               "toolsDescription/deleteTask.md"
             ),
             inputSchema: zodToJsonSchema(deleteTaskSchema),
+            annotations: {
+              title: "Delete Task",
+              destructiveHint: true,
+            },
           },
           {
             name: "clear_all_tasks",
             description: await loadPromptFromTemplate(
               "toolsDescription/clearAllTasks.md"
             ),
             inputSchema: zodToJsonSchema(clearAllTasksSchema),
+            annotations: {
+              title: "Clear All Tasks",
+              destructiveHint: true,
+            },
           },
           {
             name: "update_task",
             description: await loadPromptFromTemplate(
               "toolsDescription/updateTask.md"
             ),
             inputSchema: zodToJsonSchema(updateTaskContentSchema),
+            annotations: {
+              title: "Update Task",
+              destructiveHint: true,
+            },
           },
           {
             name: "query_task",
             description: await loadPromptFromTemplate(
               "toolsDescription/queryTask.md"
             ),
             inputSchema: zodToJsonSchema(queryTaskSchema),
+            annotations: {
+              title: "Query Task",
+              readOnlyHint: true,
+            },
           },
           {
             name: "get_task_detail",
             description: await loadPromptFromTemplate(
               "toolsDescription/getTaskDetail.md"
             ),
             inputSchema: zodToJsonSchema(getTaskDetailSchema),
+            annotations: {
+              title: "Get Task Detail",
+              readOnlyHint: true,
+            },
           },
           {
             name: "process_thought",
             description: await loadPromptFromTemplate(
               "toolsDescription/processThought.md"
             ),
             inputSchema: zodToJsonSchema(processThoughtSchema),
+            annotations: {
+              title: "Process Thought",
+              readOnlyHint: true,
+            },
           },
           {
             name: "init_project_rules",
             description: await loadPromptFromTemplate(
               "toolsDescription/initProjectRules.md"
             ),
             inputSchema: zodToJsonSchema(initProjectRulesSchema),
+            annotations: {
+              title: "Init Project Rules",
+              readOnlyHint: true,
+            },
           },
           {
             name: "research_mode",
             description: await loadPromptFromTemplate(
               "toolsDescription/researchMode.md"
             ),
             inputSchema: zodToJsonSchema(researchModeSchema),
+            annotations: {
+              title: "Research Mode",
+              readOnlyHint: true,
+            },
           },
         ],
       };