create_task

Instructions

Implementation Reference

• src/index.ts:354-374 (handler)

  The handler function for the 'create_task' tool. It constructs a Task object from the input parameters (title, projectId required; content, dueDate, priority optional), sends a POST request to the Dida365 API endpoint '/task', and returns the response detailing the created task.

  case "create_task": {
      const task: Task = {
          title: args.title as string,
          projectId: args.projectId as string,
      };
  
      if (args.content) task.content = args.content as string;
      if (args.dueDate) task.dueDate = args.dueDate as string;
      if (args.priority !== undefined) task.priority = args.priority as number;
  
      const response: AxiosResponse = await dida365Api.post("/task", task);
  
      return {
          content: [
              {
                  type: "text",
                  text: `任务创建成功: ${JSON.stringify(response.data, null, 2)}`,
              },
          ],
      };
  }

• src/index.ts:111-136 (schema)

  Input schema definition for the 'create_task' tool, specifying the JSON object structure with required 'title' and 'projectId' fields, and optional 'content', 'dueDate', and 'priority' fields.

  inputSchema: {
      type: "object",
      properties: {
          title: {
              type: "string",
              description: "The title/name of the task (required)",
          },
          projectId: {
              type: "string",
              description: "The ID of the project where this task belongs (required)",
          },
          content: {
              type: "string",
              description: "Detailed description/content of the task",
          },
          dueDate: {
              type: "string",
              description: "Due date in ISO 8601 format (e.g., 2023-12-31T23:59:59Z)",
          },
          priority: {
              type: "number",
              description: "Priority level from 0 (none) to 5 (highest)",
          },
      },
      required: ["title", "projectId"],
  },

• src/index.ts:108-137 (registration)

  Registration of the 'create_task' tool in the ListTools response handler. Includes the tool name, description, and input schema.

  {
      name: "create_task",
      description: "Create a new task in Dida365 with specified details including title, project ID, content, due date and priority. The task will be created under the specified project. Requires at least title and projectId. Returns the created task details.",
      inputSchema: {
          type: "object",
          properties: {
              title: {
                  type: "string",
                  description: "The title/name of the task (required)",
              },
              projectId: {
                  type: "string",
                  description: "The ID of the project where this task belongs (required)",
              },
              content: {
                  type: "string",
                  description: "Detailed description/content of the task",
              },
              dueDate: {
                  type: "string",
                  description: "Due date in ISO 8601 format (e.g., 2023-12-31T23:59:59Z)",
              },
              priority: {
                  type: "number",
                  description: "Priority level from 0 (none) to 5 (highest)",
              },
          },
          required: ["title", "projectId"],
      },
  },

• src/index.ts:47-64 (helper)

  TypeScript interface defining the structure of a Task object, used in the create_task handler for type safety.

  interface Task {
      id?: string;                     // Task identifier
      projectId?: string;              // Task project id
      title?: string;                  // Task title
      isAllDay?: boolean;              // All day
      completedTime?: string;          // Task completed time in "yyyy-MM-dd'T'HH:mm:ssZ"
      content?: string;                // Task content
      desc?: string;                   // Task description of checklist
      dueDate?: string;                // Task due date time in "yyyy-MM-dd'T'HH:mm:ssZ"
      items?: ChecklistItem[];         // Subtasks of Task
      priority?: 0 | 1 | 3 | 5 | number;        // Task priority: None:0, Low:1, Medium:3, High:5
      reminders?: string[];            // List of reminder triggers
      repeatFlag?: string;             // Recurring rules of task
      sortOrder?: number;              // Task sort order
      startDate?: string;              // Start date time in "yyyy-MM-dd'T'HH:mm:ssZ"
      status?: 0 | 2 | number;                  // Task completion status: Normal: 0, Completed: 2
      timeZone?: string;               // Task timezone
  }