Get Accessibility Tree Node

G

Automation/Computer/Accessibility

Retrieves the accessibility tree for a window (requires platform-specific accessibility APIs)

computer_get_accessibility_treeautomationLocal only

Inputs4

Outputs7

Security exposure5/10

Packageautomation

Ratings

Scores range from 0 to 10. Higher values mean more impact, exposure, or operational weight.

SecurityAttack surface and exposure impact.

5/10Medium

PrivacyPotential sensitivity of processed data.

5/10Medium

PerformanceRuntime or resource pressure.

6/10Medium

GovernancePolicy, audit, or compliance impact.

6/10Medium

ReliabilityOperational stability considerations.

6/10Medium

CostExternal or compute cost impact.

9/10High

Input Pins

4

▶

Execution

exec_in

Trigger

Session

Struct

session

Computer session handle

SchemaAutomationSessionAutomationSessionAutomationSession11 fields

session_refstringrequired

platformPlatformrequired

enum "Windows", "MacOS", "Linux"

default_delay_msinteger:uint64required

format uint64min 0

click_delay_msinteger:uint64required

format uint64min 0

debug_modebooleanrequired

browser_typeanyOf (2)

Browser context info if browser is attached

variant 1BrowserTypevariant

enum "Chrome", "Firefox", "Edge", "Safari"

variant 2nullvariant

browser_headlessboolean | null

browser_user_data_dirstring | null

current_page_refstring | null

Current page info if a page is open

current_window_handlestring | null

browser_frame_selectorsArray<Selector>

default []

itemsSelectorarray item

kindSelectorKindrequired

variant 1enumvariant

enum "Css", "Xpath", "TextExact", "TestId"...

variant 2constvariant

Visible text contained in the element; script, style and head content is ignored.

const "Text"

variant 3constvariant

ARIA role, optionally filtered by accessible name: `button`, `button|Sign in` (case-insensitive substring), `button|=Sign in` (exact) or `button|/^sign/i` (regex).

const "Role"

variant 4constvariant

Element ref from the latest Browser Snapshot, such as `e12`.

const "Ref"

valuestringrequired

confidencenumber | null

format double

scopestring | null

Window Title

String

window_title

Window title; empty targets the focused window outside Flow-Like (on Linux the desktop accessibility root when no window resolves)

Max Depth

Integer

max_depth

Maximum tree depth (1–32); results are limited to 2000 elements

Default 10

Output Pins

7

▶

Execution

exec_out

Continue

⚠

Execution

exec_error

Triggered if accessibility APIs are unavailable

Session

Struct

session_out

Computer session handle (pass-through)

SchemaAutomationSessionAutomationSessionAutomationSession11 fields

session_refstringrequired

platformPlatformrequired

enum "Windows", "MacOS", "Linux"

default_delay_msinteger:uint64required

format uint64min 0

click_delay_msinteger:uint64required

format uint64min 0

debug_modebooleanrequired

browser_typeanyOf (2)

Browser context info if browser is attached

variant 1BrowserTypevariant

enum "Chrome", "Firefox", "Edge", "Safari"

variant 2nullvariant

browser_headlessboolean | null

browser_user_data_dirstring | null

current_page_refstring | null

Current page info if a page is open

current_window_handlestring | null

browser_frame_selectorsArray<Selector>

default []

itemsSelectorarray item

kindSelectorKindrequired

variant 1enumvariant

enum "Css", "Xpath", "TextExact", "TestId"...

variant 2constvariant

Visible text contained in the element; script, style and head content is ignored.

const "Text"

variant 3constvariant

ARIA role, optionally filtered by accessible name: `button`, `button|Sign in` (case-insensitive substring), `button|=Sign in` (exact) or `button|/^sign/i` (regex).

const "Role"

variant 4constvariant

Element ref from the latest Browser Snapshot, such as `e12`.

const "Ref"

valuestringrequired

confidencenumber | null

format double

scopestring | null

Tree

Struct

tree

Accessibility tree root node

SchemaAccessibilityNodeAccessibilityNodeAccessibilityNode12 fields

native_idstring | null

default null

rolestringrequired

namestring | null

valuestring | null

descriptionstring | null

boundsanyOf (2)

variant 1AccessibilityBoundsvariant

xinteger:int32required

format int32

yinteger:int32required

format int32

widthinteger:int32required

format int32

heightinteger:int32required

format int32

variant 2nullvariant

statesArray<string>required

itemsstringarray item

actionsArray<string>required

itemsstringarray item

childrenArray<#>required

items#array item

normalized_rolestring

button, link, text_field, checkbox, radio_button, combo_box, menu_item, tab, list_item, …

default ""

normalized_statesArray<string>

enabled, disabled, focused, focusable, selected, checked, mixed, expanded, collapsed, editable, …

default []

itemsstringarray item

normalized_actionsArray<string>

Actions accepted by Act on Accessibility Element: invoke, focus, select, expand, collapse, set_value.

default []

itemsstringarray item

Tree JSON

String

tree_json

Accessibility tree as JSON string for LLM processing

Elements

Struct Array

elements

Every element of the tree as a flat list in document order (children omitted); each can be passed to Act on Accessibility Element

SchemaAccessibilityNodeAccessibilityNodeAccessibilityNode12 fields

native_idstring | null

default null

rolestringrequired

namestring | null

valuestring | null

descriptionstring | null

boundsanyOf (2)

variant 1AccessibilityBoundsvariant

xinteger:int32required

format int32

yinteger:int32required

format int32

widthinteger:int32required

format int32

heightinteger:int32required

format int32

variant 2nullvariant

statesArray<string>required

itemsstringarray item

actionsArray<string>required

itemsstringarray item

childrenArray<#>required

items#array item

normalized_rolestring

button, link, text_field, checkbox, radio_button, combo_box, menu_item, tab, list_item, …

default ""

normalized_statesArray<string>

enabled, disabled, focused, focusable, selected, checked, mixed, expanded, collapsed, editable, …

default []

itemsstringarray item

normalized_actionsArray<string>

Actions accepted by Act on Accessibility Element: invoke, focus, select, expand, collapse, set_value.

default []

itemsstringarray item

Error

String

error

Error message if accessibility APIs are unavailable

Node Info

Internal name

computer_get_accessibility_tree

Category

Automation/Computer/Accessibility

Version

2