TaskFlow MCP

Instructions

Implementation Reference

• src/tools/TaskFlowTools.ts:615-618 (handler)

  MCP tool handler function that parses arguments and delegates to the TaskFlowService.deleteSubtask method.

  async delete_subtask(args: any) {
    const { requestId, taskId, subtaskId } = args ?? {};
    return service.deleteSubtask(String(requestId), String(taskId), String(subtaskId));
  },

• src/services/TaskFlowService.ts:511-528 (helper)

  Core implementation of subtask deletion in TaskFlowService: loads tasks, validates existence and incompletion, removes subtask, saves, and returns progress table.

  public async deleteSubtask(requestId: string, taskId: string, subtaskId: string) {
    await this.loadTasks();
    const req = this.getRequest(requestId);
    if (!req) return { status: "error", message: "Request not found" };
  
    const task = req.tasks.find((t) => t.id === taskId);
    if (!task) return { status: "error", message: "Task not found" };
  
    const subtaskIndex = task.subtasks.findIndex((s) => s.id === subtaskId);
    if (subtaskIndex === -1) return { status: "error", message: "Subtask not found" };
    if (task.subtasks[subtaskIndex].done) return { status: "error", message: "Cannot delete completed subtask" };
  
    task.subtasks.splice(subtaskIndex, 1);
    await this.saveTasks();
  
    const progressTable = formatTaskProgressTableForRequest(req);
    return { status: "subtask_deleted", message: `Subtask ${subtaskId} has been deleted.\n${progressTable}` };
  }

• src/schemas/TaskFlowSchemas.ts:190-198 (schema)

  Input schema definition for the delete_subtask tool parameters.

  delete_subtask: {
    type: "object",
    properties: {
      requestId: { type: "string" },
      taskId: { type: "string" },
      subtaskId: { type: "string" },
    },
    required: ["requestId", "taskId", "subtaskId"],
  },

• src/tools/TaskFlowTools.ts:299-314 (registration)

  Tool registration: exports the DELETE_SUBTASK_TOOL object with name, description, and inputSchema used by the MCP server.

  export const DELETE_SUBTASK_TOOL: Tool = {
    name: "delete_subtask",
    description:
      "Delete a subtask from a task. Provide 'requestId', 'taskId', and 'subtaskId'.\n\n" +
      "Only uncompleted subtasks can be deleted.\n\n" +
      "A progress table will be displayed showing the updated task with its remaining subtasks.",
    inputSchema: {
      type: "object",
      properties: {
        requestId: { type: "string" },
        taskId: { type: "string" },
        subtaskId: { type: "string" },
      },
      required: ["requestId", "taskId", "subtaskId"],
    },
  };

• src/server/TaskFlowServer.ts:76-76 (registration)

  Tool registration in the MCP server's listTools response, including DELETE_SUBTASK_TOOL in the available tools array.

  DELETE_SUBTASK_TOOL,