/** * tools/remove-task.js * Tool to remove a task by ID */ import { z } from 'zod'; import { handleApiResult, createErrorResponse, getProjectRootFromSession } from './utils.js'; import { removeTaskDirect } from '../core/task-master-core.js'; import { findTasksJsonPath } from '../core/utils/path-utils.js'; /** * Register the remove-task tool with the MCP server * @param {Object} server - FastMCP server instance */ export function registerRemoveTaskTool(server) { server.addTool({ name: 'remove_task', description: 'Remove a task or subtask permanently from the tasks list', parameters: z.object({ id: z .string() .describe( "ID of the task or subtask to remove (e.g., '5' or '5.2'). Can be comma-separated to update multiple tasks/subtasks at once." ), file: z.string().optional().describe('Absolute path to the tasks file'), projectRoot: z .string() .describe('The directory of the project. Must be an absolute path.'), confirm: z .boolean() .optional() .describe('Whether to skip confirmation prompt (default: false)') }), execute: async (args, { log, session }) => { try { log.info(`Removing task(s) with ID(s): ${args.id}`); // Get project root from args or session const rootFolder = args.projectRoot || getProjectRootFromSession(session, log); // Ensure project root was determined if (!rootFolder) { return createErrorResponse( 'Could not determine project root. Please provide it explicitly or ensure your session contains valid root information.' ); } log.info(`Using project root: ${rootFolder}`); // Resolve the path to tasks.json let tasksJsonPath; try { tasksJsonPath = findTasksJsonPath( { projectRoot: rootFolder, file: args.file }, log ); } catch (error) { log.error(`Error finding tasks.json: ${error.message}`); return createErrorResponse( `Failed to find tasks.json: ${error.message}` ); } log.info(`Using tasks file path: ${tasksJsonPath}`); // Assume client has already handled confirmation if needed const result = await removeTaskDirect( { tasksJsonPath: tasksJsonPath, id: args.id }, log ); if (result.success) { log.info(`Successfully removed task: ${args.id}`); } else { log.error(`Failed to remove task: ${result.error.message}`); } return handleApiResult(result, log, 'Error removing task'); } catch (error) { log.error(`Error in remove-task tool: ${error.message}`); return createErrorResponse(`Failed to remove task: ${error.message}`); } } }); }