ui.activate

Since next

[editor (test session)] Press a node by its ui.tree id, as a click would.

Refuses with a code when it is hidden, disabled, clipped away, not hit-testable, painted over by something (named) or on a screen under the top one: the answer to "why did nothing happen". Needs input granted: an editor you started does; a person's Play grants only observe and capture: use play.input there.


Title	Press a UI node
Mode
Token cost	about 159 tokens (listed only when its toolset is enabled)
Toolset	`ui`

Arguments

Argument	Type	Required	Default	Allowed values	Description
`agent`	`string`	no			The name of the agent making the call, when several agents share one connection: each named agent is its own actor and plays its own game. Leave it out when there is one agent.
`id`	`string`	yes			The node, qualified or bare

Example

An MCP tools/call with the required arguments (placeholders in angle brackets).

{
  "name": "ui.activate",
  "arguments": {
    "id": "<id>"
  }
}