Skip to content

assertWaypoint

Assert that the current screen has reached a named waypoint (a known place in the app, e.g. square/ios/more-tab-no-sheet). Waits up to timeoutMs for the screen to settle into that waypoint — all of its required selectors present and none of its forbidden selectors present. Succeeds when the waypoint matches; fails with the missing-required / present-forbidden diff if it does not match within the timeout. Reach for this to lock in that a step (or a branchy navigation tool) landed where it intended, instead of trusting that a tap/swipe “succeeded”.

Source

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

Contract

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

Input schema

Required parameters

  • waypoint — String Id of the waypoint to assert, e.g. square/ios/more-tab-no-sheet.

Optional parameters

  • timeoutMs — Integer Total milliseconds to wait for the screen to settle into the waypoint before failing. Default 5000.
  • pollIntervalMs — Integer Milliseconds between waypoint re-evaluations while waiting. Default 250.

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.