@kazuph/mcp-taskmanager

Instructions

Implementation Reference

• index.ts:535-558 (handler)

  The main handler method in TaskManagerServer class that implements the logic for retrieving detailed information about a specific task by its ID across all requests.

  public async openTaskDetails(taskId: string) {
    await this.loadTasks();
    for (const req of this.data.requests) {
      const target = req.tasks.find((t) => t.id === taskId);
      if (target) {
        return {
          status: "task_details",
          requestId: req.requestId,
          originalRequest: req.originalRequest,
          splitDetails: req.splitDetails,
          completed: req.completed,
          task: {
            id: target.id,
            title: target.title,
            description: target.description,
            done: target.done,
            approved: target.approved,
            completedDetails: target.completedDetails,
          },
        };
      }
    }
    return { status: "task_not_found", message: "No such task found" };
  }

• index.ts:776-786 (handler)

  The dispatch handler in the CallToolRequestSchema handler that parses the arguments using the schema and calls the openTaskDetails method on the server instance.

  case "open_task_details": {
    const parsed = OpenTaskDetailsSchema.safeParse(args);
    if (!parsed.success) {
      throw new Error(`Invalid arguments: ${parsed.error}`);
    }
    const { taskId } = parsed.data;
    const result = await taskManagerServer.openTaskDetails(taskId);
    return {
      content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
    };
  }

• index.ts:71-73 (schema)

  Zod schema defining the input validation for the open_task_details tool, requiring a 'taskId' string.

  const OpenTaskDetailsSchema = z.object({
    taskId: z.string(),
  });

• index.ts:202-213 (registration)

  Tool registration object defining the name, description, and input schema for the open_task_details tool, used in listTools response.

  const OPEN_TASK_DETAILS_TOOL: Tool = {
    name: "open_task_details",
    description:
      "Get details of a specific task by 'taskId'. This is for inspecting task information at any point.",
    inputSchema: {
      type: "object",
      properties: {
        taskId: { type: "string" },
      },
      required: ["taskId"],
    },
  };

• index.ts:683-696 (registration)

  Registration of all tools including OPEN_TASK_DETAILS_TOOL in the listTools request handler.

  server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: [
      REQUEST_PLANNING_TOOL,
      GET_NEXT_TASK_TOOL,
      MARK_TASK_DONE_TOOL,
      APPROVE_TASK_COMPLETION_TOOL,
      APPROVE_REQUEST_COMPLETION_TOOL,
      OPEN_TASK_DETAILS_TOOL,
      LIST_REQUESTS_TOOL,
      ADD_TASKS_TO_REQUEST_TOOL,
      UPDATE_TASK_TOOL,
      DELETE_TASK_TOOL,
    ],
  }));