fix(ui-automation): Preserve AXe tab roles

Bundle AXe 1.7.1 so SwiftUI tab bar accessibility nodes are exposed through the packaged AXe artifact.

Also classify AXe radio button nodes with role_description "tab" as runtime tabs so wait-for-ui and tap selectors can target them by role.

Fixes GH-439

Co-Authored-By: OpenAI Codex <codex@openai.com>

Author: cameroncooke

.axe-version

@@ -1 +1 @@
-1.7.0
+1.7.1

src/mcp/tools/ui-automation/__tests__/runtime-snapshot.test.ts

@@ -142,6 +142,31 @@ describe('runtime snapshot normalization', () => {
     expect(snapshot.payload.elements[0]?.actions).not.toContain('tap');
   });
 
+  it('classifies tab radio buttons from AXe as tabs', () => {
+    const snapshot = createRuntimeSnapshotRecord({
+      simulatorId,
+      uiHierarchy: [
+        createNode({
+          type: 'RadioButton',
+          role: 'AXRadioButton',
+          role_description: 'tab',
+          AXLabel: 'Reports',
+          AXValue: '0',
+        }),
+      ],
+      nowMs: 1_000,
+    });
+
+    expect(snapshot.payload.elements[0]).toEqual(
+      expect.objectContaining({
+        role: 'tab',
+        label: 'Reports',
+        value: '0',
+        actions: expect.arrayContaining(['tap', 'longPress', 'touch']),
+      }),
+    );
+  });
+
   it('derives deterministic screen hashes from normalized UI content', () => {
     const uiHierarchy = [createNode({ AXLabel: 'Continue' }), createNode({ AXLabel: 'Cancel' })];
 

src/mcp/tools/ui-automation/shared/runtime-snapshot.ts

@@ -108,6 +108,9 @@ function deriveRole(
   node: AccessibilityNode,
   identifier: string | undefined,
 ): RuntimeElementRoleV1 | undefined {
+  const roleDescription = normalizeText(node.role_description)?.toLowerCase();
+  if (roleDescription === 'tab') return 'tab';
+
   const roleText = [node.role, node.type, node.subrole, node.role_description]
     .map((value) => normalizeText(value)?.toLowerCase())
     .filter((value): value is string => value !== undefined)