By default, a map of an agent can't be re-arranged. This is because at each agent update cycle, the aliases are refreshed adding/deleting aliases as their originals match - or cease to match the agent query.
However, if the agent is turned off ($AgentPriority or agent Create/Rename dialog) if is possible to then manipulate the map's contents. When 'off' the agents no longer updates but it retains its contents from the last active agent cycle. If the agent is turned on again, the map is re-arranged to the normal agent-organised layout.
An experimental feature, from v5.5.0, allows maps within an active agent to be rearranged by the user, which attempts to get around the above problem. Note that this flexibility applies to the agent-created aliases on the map; the user cannot add additional items. If the user deletes an alias it will be re-created next agent cycle. Also, like normal aliases, it is not possible for the agent's aliases to contain other notes - so no nesting is possible.
The feature is controlled by the agent's $CleanupAction. In the default mode, the agent's contents in map view will be organised in a grid, as was previously the case (see above); the order of items in the grid being set, again as before, via the sort attributes for the agent container. Thus the default behaviour is as pre v5.5.0.
But, if the $CleanupAction value is set to "none" - or indeed any value other than the default "grid" - the user is free to arrange the items within the agent containers as they would any other map. Whilst in this freeform mode the normal Map view Cleanup pop-up menu items may also be used.
In "none" mode Tinderbox adds new aliases to the agent map by the logic used for a normal map so it should avoid overlapping/hidden icons, etc.
Adornments are also allowed. If the agent sort is enabled, i.e. $CleanupAction is "grid", this trumps the effect of smart adornments; smart adornments themselves ignore $CleanupAction completely. From v5.8.0, adornments can be dragged or pasted into agent maps.
From v5.10.5, agents no longer force a default cleanup on file load. Thus agent maps using "none" correctly maintain their layout across different sessions.