waitForChange

Wait for the UI to settle after an action (a screen loads, content updates, a list scrolls). Returns as soon as the UI is quiet, so it cannot wait out a change that has not started yet. To wait out a spinner, use assertNotVisibleWithText.

Source

• Kind: class-backed
• Class: xyz.block.trailblaze.toolcalls.commands.WaitForChangeTrailblazeTool

Contract

• Visible to LLM: yes (surface_to_llm: true)
• Recordable: yes (is_recordable: true)
• Host-only: no (requires_host: false)

Input schema

Optional parameters

• timeoutMs — Integer Max wait in ms. Default 8000.
• quietWindowMs — Integer Time with no UI events that counts as settled, in ms. Default 300.
• requireChange — Boolean If true, timing out before the UI changes and settles fails; if false, it succeeds. Default true.

Output

Returns: string (opaque text content)

Typed result schemas (kind: query | action, MCP structuredContent) are not yet carried by the resolved manifest — this section will gain detail when that lands.