Skip to content

switchDevice

Hand the session over to another device bound to this multi-device session. All subsequent screen observations and tool calls act on that device until the next switchDevice call. Address devices by the names declared in the trail’s multi-device configuration (e.g. ‘buyer’ or ‘seller’). Only available when the session bound a multi-device configuration. Issue a switch as its own step, then act on the new device’s screen.

Source

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

Contract

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

Input schema

Required parameters

  • name — String Name of the device to hand the session to — a name declared in the trail’s multi-device configuration.

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.