mobile-debug-mcp 0.30.1 → 0.30.2

package/test/unit/interact/adjust_control.test.ts

@@ -10,6 +10,7 @@ async function run() {
     const originalTapHandler = (ToolsInteract as any).tapHandler
     const originalSwipeHandler = (ToolsInteract as any).swipeHandler
     const originalExpectStateHandler = (ToolsInteract as any).expectStateHandler
+    const originalGetInteractionService = (ToolsInteract as any).getInteractionService
 
   try {
     ;(Observe as any).ToolsObserve.getUITreeHandler = async () => ({
@@ -298,6 +299,253 @@ async function run() {
     assert.strictEqual(disabledAdjust.success, false)
     assert.strictEqual(disabledAdjust.failure_code, 'ELEMENT_NOT_INTERACTABLE')
 
+    const bothTargetsAdjust = await ToolsInteract.adjustControlHandler({
+      selector: { text: 'Duration' },
+      element_id: wait.element.elementId,
+      property: 'value',
+      targetValue: 8,
+      platform: 'android'
+    })
+
+    assert.strictEqual(bothTargetsAdjust.success, false)
+    assert.strictEqual(bothTargetsAdjust.failure_code, 'ELEMENT_NOT_FOUND')
+
+    ;(Observe as any).ToolsObserve.getUITreeHandler = async () => ({
+      device: { platform: 'android', id: 'mock-device', osVersion: '14', model: 'Pixel', simulator: true },
+      screen: '',
+      resolution: { width: 1080, height: 2400 },
+      elements: [
+        {
+          text: 'Plain button',
+          type: 'android.widget.Button',
+          contentDescription: null,
+          clickable: true,
+          enabled: true,
+          visible: true,
+          bounds: [0, 0, 200, 40],
+          resourceId: 'plain_button',
+          state: null
+        }
+      ]
+    })
+
+    const nonAdjustable = await ToolsInteract.adjustControlHandler({
+      selector: { text: 'Plain button' },
+      property: 'value',
+      targetValue: 1,
+      platform: 'android'
+    })
+
+    assert.strictEqual(nonAdjustable.success, false)
+    assert.strictEqual(nonAdjustable.failure_code, 'ELEMENT_NOT_INTERACTABLE')
+
+    ;(Observe as any).ToolsObserve.getUITreeHandler = async () => ({
+      device: { platform: 'android', id: 'mock-device', osVersion: '14', model: 'Pixel', simulator: true },
+      screen: '',
+      resolution: { width: 1080, height: 2400 },
+      elements: [
+        {
+          text: 'Direct slider',
+          type: 'android.widget.SeekBar',
+          contentDescription: null,
+          clickable: true,
+          enabled: true,
+          visible: true,
+          bounds: [0, 0, 200, 40],
+          resourceId: 'seek_direct',
+          actions: ['ACTION_SET_PROGRESS'],
+          state: {
+            value: 10,
+            raw_value: 10,
+            value_range: { min: 0, max: 100 }
+          }
+        }
+      ]
+    })
+
+    let directCalls = 0
+    ;(ToolsInteract as any).getInteractionService = async () => ({
+      resolved: { id: 'mock-device' },
+      interact: {
+        setAdjustableValue: async ({ value }: any) => {
+          directCalls++
+          assert.strictEqual(value, 42)
+          return {
+            device: { platform: 'android', id: 'mock-device', osVersion: '14', model: 'Pixel', simulator: true },
+            success: true
+          }
+        }
+      },
+      platform: 'android'
+    })
+
+    ;(ToolsInteract as any).expectStateHandler = async () => ({
+      success: true,
+      selector: { text: 'Direct slider' },
+      element_id: null,
+      expected_state: { property: 'value', expected: 42 },
+      observed_state: { property: 'value', value: 42, raw_value: 42 },
+      reason: 'value matches expected value'
+    })
+
+    const directAdjust = await ToolsInteract.adjustControlHandler({
+      selector: { text: 'Direct slider' },
+      property: 'value',
+      targetValue: 42,
+      platform: 'android'
+    })
+
+    assert.strictEqual(directAdjust.success, true)
+    assert.strictEqual(directAdjust.adjustment_mode, 'semantic')
+    assert.strictEqual(directAdjust.attempts, 1)
+    assert.strictEqual(directCalls, 1)
+
+    let directRefreshValue = 10
+    let directRefreshTreeFetches = 0
+    ;(Observe as any).ToolsObserve.getUITreeHandler = async () => {
+      directRefreshTreeFetches++
+      return {
+        device: { platform: 'android', id: 'mock-device', osVersion: '14', model: 'Pixel', simulator: true },
+        screen: '',
+        resolution: { width: 1080, height: 2400 },
+        elements: [
+          {
+            text: 'Retrying direct slider',
+            type: 'android.widget.SeekBar',
+            contentDescription: null,
+            clickable: true,
+            enabled: true,
+            visible: true,
+            bounds: [0, 0, 200, 40],
+            resourceId: 'seek_direct_retry',
+            actions: ['ACTION_SET_PROGRESS'],
+            state: {
+              value: directRefreshValue,
+              raw_value: directRefreshValue,
+              value_range: { min: 0, max: 100 }
+            }
+          }
+        ]
+      }
+    }
+
+    let retryingDirectCalls = 0
+    ;(ToolsInteract as any).getInteractionService = async () => ({
+      resolved: { id: 'mock-device' },
+      interact: {
+        setAdjustableValue: async () => {
+          retryingDirectCalls++
+          directRefreshValue = retryingDirectCalls === 1 ? 60 : 80
+          return {
+            device: { platform: 'android', id: 'mock-device', osVersion: '14', model: 'Pixel', simulator: true },
+            success: true
+          }
+        }
+      },
+      platform: 'android'
+    })
+
+    ;(ToolsInteract as any).tapHandler = async () => {
+      throw new Error('coordinate fallback should not run before direct retry refreshes state')
+    }
+
+    ;(ToolsInteract as any).expectStateHandler = async () => ({
+      success: directRefreshValue === 80,
+      selector: { text: 'Retrying direct slider' },
+      element_id: null,
+      expected_state: { property: 'value', expected: 80 },
+      observed_state: { property: 'value', value: directRefreshValue, raw_value: directRefreshValue },
+      reason: directRefreshValue === 80 ? 'value matches expected value' : 'direct adjustment partially applied'
+    })
+
+    const retryingDirectAdjust = await ToolsInteract.adjustControlHandler({
+      selector: { text: 'Retrying direct slider' },
+      property: 'value',
+      targetValue: 80,
+      maxAttempts: 2,
+      platform: 'android'
+    })
+
+    assert.strictEqual(retryingDirectAdjust.success, true)
+    assert.strictEqual(retryingDirectAdjust.adjustment_mode, 'semantic')
+    assert.strictEqual(retryingDirectAdjust.attempts, 2)
+    assert.strictEqual(retryingDirectCalls, 2)
+    assert.ok(directRefreshTreeFetches >= 2, 'direct retry should refetch the UI tree instead of cascading into stale coordinate fallback')
+
+    let incrementalTreeValue = 1
+    let incrementalTreeFetches = 0
+    ;(Observe as any).ToolsObserve.getUITreeHandler = async () => {
+      incrementalTreeFetches++
+      return {
+        device: { platform: 'ios', id: 'booted', osVersion: '17', model: 'Simulator', simulator: true },
+        screen: '',
+        resolution: { width: 390, height: 844 },
+        elements: [
+          {
+            text: 'Stepper',
+            type: 'XCUIElementTypeStepper',
+            contentDescription: null,
+            clickable: true,
+            enabled: true,
+            visible: true,
+            bounds: [0, 0, 120, 44],
+            resourceId: 'stepper',
+            actions: ['increment', 'decrement'],
+            state: {
+              value: incrementalTreeValue,
+              raw_value: incrementalTreeValue,
+              value_range: { min: 0, max: 5, step: 1 },
+              step: 1
+            }
+          }
+        ]
+      }
+    }
+
+    const directions: string[] = []
+    ;(ToolsInteract as any).getInteractionService = async () => ({
+      resolved: { id: 'booted' },
+      interact: {
+        adjustAccessibleValue: async ({ direction }: any) => {
+          directions.push(direction)
+          incrementalTreeValue += direction === 'increment' ? 1 : -1
+          return {
+            device: { platform: 'ios', id: 'booted', osVersion: '17', model: 'Simulator', simulator: true },
+            success: true
+          }
+        }
+      },
+      platform: 'ios'
+    })
+
+    ;(ToolsInteract as any).expectStateHandler = async () => {
+      return {
+        success: incrementalTreeValue === 3,
+        selector: { text: 'Stepper' },
+        element_id: null,
+        expected_state: { property: 'value', expected: 3 },
+        observed_state: { property: 'value', value: incrementalTreeValue, raw_value: incrementalTreeValue },
+        reason: incrementalTreeValue === 3 ? 'value matches expected value' : 'value still below target'
+      }
+    }
+
+    const incrementalAdjust = await ToolsInteract.adjustControlHandler({
+      selector: { text: 'Stepper' },
+      property: 'value',
+      targetValue: 3,
+      maxAttempts: 5,
+      platform: 'ios'
+    })
+
+    assert.strictEqual(incrementalAdjust.success, true)
+    assert.strictEqual(incrementalAdjust.adjustment_mode, 'semantic')
+    assert.strictEqual(incrementalAdjust.attempts, 2)
+    assert.deepStrictEqual(directions, ['increment', 'increment'])
+    assert.strictEqual(incrementalAdjust.target_state.tolerance, 0)
+    assert.ok(incrementalTreeFetches >= 2, 'incremental retry should refetch the UI tree instead of cascading into stale coordinate fallback')
+
+    ;(ToolsInteract as any).getInteractionService = originalGetInteractionService
+
     ;(Observe as any).ToolsObserve.getUITreeHandler = async () => ({
       device: { platform: 'android', id: 'mock-device', osVersion: '14', model: 'Pixel', simulator: true },
       screen: '',
@@ -399,8 +647,9 @@ async function run() {
       tapCalls.push({ platform, x, y, deviceId })
       return {
         device: { platform: platform || 'android', id: deviceId || 'mock-device', osVersion: '14', model: 'Pixel', simulator: true },
-        success: false,
-        error: 'tap failed'
+        success: true,
+        x,
+        y
       }
     }
 
@@ -450,37 +699,43 @@ async function run() {
     assert.strictEqual(cachedResolveAdjust.success, true)
     assert.strictEqual(cachedResolveAdjust.converged, true)
     assert.strictEqual(cachedResolveAdjust.within_tolerance, true)
-    assert.ok(cachedResolveAdjust.attempts >= 3)
-    assert.strictEqual(treeFetches, 1, 'second attempt should reuse the resolved element instead of refetching the UI tree')
+    assert.strictEqual(cachedResolveAdjust.attempts, 2)
+    assert.ok(treeFetches >= 2, 'second attempt should refetch after a non-converged coordinate tap updates observed state')
 
     const probeTapStart = tapCalls.length
     const probeSwipeStart = swipeCalls.length
-    let probeVerificationCount = 0
-    ;(Observe as any).ToolsObserve.getUITreeHandler = async () => ({
-      device: { platform: 'android', id: 'mock-device', osVersion: '14', model: 'Pixel', simulator: true },
-      screen: '',
-      resolution: { width: 1080, height: 2400 },
-      elements: [
-        {
-          text: 'Duration',
-          type: 'android.widget.SeekBar',
-          contentDescription: null,
-          clickable: true,
-          enabled: true,
-          visible: true,
-          bounds: [0, 0, 200, 40],
-          resourceId: 'seek_duration',
-          state: {
-            value: 10,
-            raw_value: 10,
-            value_range: { min: 0, max: 20 }
+    const probeSwipeFetches: number[] = []
+    let probeTreeValue = 10
+    let probeTreeFetches = 0
+    ;(Observe as any).ToolsObserve.getUITreeHandler = async () => {
+      probeTreeFetches++
+      return {
+        device: { platform: 'android', id: 'mock-device', osVersion: '14', model: 'Pixel', simulator: true },
+        screen: '',
+        resolution: { width: 1080, height: 2400 },
+        elements: [
+          {
+            text: 'Duration',
+            type: 'android.widget.SeekBar',
+            contentDescription: null,
+            clickable: true,
+            enabled: true,
+            visible: true,
+            bounds: [0, 0, 200, 40],
+            resourceId: 'seek_duration',
+            state: {
+              value: probeTreeValue,
+              raw_value: probeTreeValue,
+              value_range: { min: 0, max: 20 }
+            }
           }
-        }
-      ]
-    })
+        ]
+      }
+    }
 
     ;(ToolsInteract as any).tapHandler = async ({ platform, x, y, deviceId }: any) => {
       tapCalls.push({ platform, x, y, deviceId })
+      probeTreeValue = probeTreeValue === 10 ? 11 : 12
       return {
         device: { platform: platform || 'android', id: deviceId || 'mock-device', osVersion: '14', model: 'Pixel', simulator: true },
         success: true,
@@ -488,10 +743,19 @@ async function run() {
         y
       }
     }
+    ;(ToolsInteract as any).swipeHandler = async ({ platform, x1, y1, x2, y2, duration, deviceId }: any) => {
+      probeSwipeFetches.push(probeTreeFetches)
+      swipeCalls.push({ platform, x1, y1, x2, y2, duration, deviceId })
+      return {
+        device: { platform: platform || 'android', id: deviceId || 'mock-device', osVersion: '14', model: 'Pixel', simulator: true },
+        success: true,
+        start: [x1, y1],
+        end: [x2, y2],
+        duration
+      }
+    }
 
     ;(ToolsInteract as any).expectStateHandler = async () => {
-      probeVerificationCount++
-      const value = probeVerificationCount === 1 ? 11 : 12
       return {
         success: true,
         selector: { text: 'Duration' },
@@ -505,10 +769,10 @@ async function run() {
           class: 'android.widget.SeekBar',
           bounds: [0, 0, 200, 40],
           index: 0,
-          state: { value, raw_value: value, value_range: { min: 0, max: 20 } }
+          state: { value: probeTreeValue, raw_value: probeTreeValue, value_range: { min: 0, max: 20 } }
         },
-        observed_state: { property: 'value', value, raw_value: value },
-        reason: value === 12 ? 'value matches expected value' : 'value still below target'
+        observed_state: { property: 'value', value: probeTreeValue, raw_value: probeTreeValue },
+        reason: probeTreeValue === 12 ? 'value matches expected value' : 'value still below target'
       }
     }
 
@@ -525,9 +789,297 @@ async function run() {
     assert.strictEqual(probeAdjust.converged, true)
     assert.strictEqual(probeAdjust.within_tolerance, true)
     assert.strictEqual(probeAdjust.adjustment_mode, 'coordinate')
-    assert.strictEqual(probeAdjust.attempts, 2)
+    assert.strictEqual(probeAdjust.attempts, 3)
     assert.strictEqual(tapCalls.length, probeTapStart + 2)
-    assert.strictEqual(swipeCalls.length, probeSwipeStart)
+    assert.strictEqual(swipeCalls.length, probeSwipeStart + 1)
+    assert.ok(probeTreeFetches >= 2, 'coordinate retry should refetch the UI tree instead of cascading into stale swipe fallback')
+    assert.ok(probeSwipeFetches[0] >= 2, 'swipe fallback should run only after a fresh UI tree read')
+
+    let defaultToleranceVerificationCount = 0
+    ;(Observe as any).ToolsObserve.getUITreeHandler = async () => ({
+      device: { platform: 'android', id: 'mock-device', osVersion: '14', model: 'Pixel', simulator: true },
+      screen: '',
+      resolution: { width: 1080, height: 2400 },
+      elements: [
+        {
+          text: 'Default tolerance',
+          type: 'android.widget.SeekBar',
+          contentDescription: null,
+          clickable: true,
+          enabled: true,
+          visible: true,
+          bounds: [0, 0, 200, 40],
+          resourceId: 'seek_default',
+          state: {
+            value: 10,
+            raw_value: 10,
+            value_range: { min: 0, max: 100 }
+          }
+        }
+      ]
+    })
+
+    ;(ToolsInteract as any).expectStateHandler = async () => {
+      defaultToleranceVerificationCount++
+      return {
+        success: false,
+        selector: { text: 'Default tolerance' },
+        element_id: null,
+        expected_state: { property: 'value', expected: 50 },
+        observed_state: { property: 'value', value: 50.6, raw_value: 50.6 },
+        reason: 'exact value mismatch'
+      }
+    }
+
+    const defaultToleranceAdjust = await ToolsInteract.adjustControlHandler({
+      selector: { text: 'Default tolerance' },
+      property: 'value',
+      targetValue: 50,
+      platform: 'android'
+    })
+
+    assert.strictEqual(defaultToleranceAdjust.success, true)
+    assert.strictEqual(defaultToleranceAdjust.target_state.tolerance, 1)
+    assert.strictEqual(defaultToleranceVerificationCount, 1)
+
+    ;(Observe as any).ToolsObserve.getUITreeHandler = async () => ({
+      device: { platform: 'android', id: 'mock-device', osVersion: '14', model: 'Pixel', simulator: true },
+      screen: '',
+      resolution: { width: 1080, height: 2400 },
+      elements: [
+        {
+          text: 'Discrete slider',
+          type: 'android.widget.SeekBar',
+          contentDescription: null,
+          clickable: true,
+          enabled: true,
+          visible: true,
+          bounds: [0, 0, 200, 40],
+          resourceId: 'seek_discrete',
+          state: {
+            value: 0,
+            raw_value: 0,
+            value_range: { min: 0, max: 20, step: 5 },
+            step: 5
+          }
+        }
+      ]
+    })
+
+    ;(ToolsInteract as any).expectStateHandler = async () => ({
+      success: true,
+      selector: { text: 'Discrete slider' },
+      element_id: null,
+      expected_state: { property: 'value', expected: 10 },
+      observed_state: { property: 'value', value: 10, raw_value: 10 },
+      reason: 'value matches expected value'
+    })
+
+    const discreteAdjust = await ToolsInteract.adjustControlHandler({
+      selector: { text: 'Discrete slider' },
+      property: 'value',
+      targetValue: 12,
+      platform: 'android'
+    })
+
+    assert.strictEqual(discreteAdjust.success, true)
+    assert.strictEqual(discreteAdjust.target_state.target_value, 10)
+    assert.strictEqual(discreteAdjust.target_state.tolerance, 0)
+
+    ;(Observe as any).ToolsObserve.getUITreeHandler = async () => ({
+      device: { platform: 'android', id: 'mock-device', osVersion: '14', model: 'Pixel', simulator: true },
+      screen: '',
+      resolution: { width: 1080, height: 2400 },
+      elements: [
+        {
+          text: 'Scientific step slider',
+          type: 'android.widget.SeekBar',
+          contentDescription: null,
+          clickable: true,
+          enabled: true,
+          visible: true,
+          bounds: [0, 0, 200, 40],
+          resourceId: 'seek_scientific_step',
+          state: {
+            value: 0,
+            raw_value: 0,
+            value_range: { min: 0, max: 0.000001, step: 1e-7 },
+            step: 1e-7
+          }
+        }
+      ]
+    })
+
+    ;(ToolsInteract as any).expectStateHandler = async () => ({
+      success: true,
+      selector: { text: 'Scientific step slider' },
+      element_id: null,
+      expected_state: { property: 'value', expected: 0.0000003 },
+      observed_state: { property: 'value', value: 0.0000003, raw_value: 0.0000003 },
+      reason: 'value matches expected value'
+    })
+
+    const scientificStepAdjust = await ToolsInteract.adjustControlHandler({
+      selector: { text: 'Scientific step slider' },
+      property: 'value',
+      targetValue: 0.00000034,
+      platform: 'android'
+    })
+
+    assert.strictEqual(scientificStepAdjust.success, true)
+    assert.strictEqual(scientificStepAdjust.target_state.target_value, 0.0000003)
+    assert.strictEqual(scientificStepAdjust.target_state.tolerance, 0)
+
+    ;(Observe as any).ToolsObserve.getUITreeHandler = async () => ({
+      device: { platform: 'android', id: 'mock-device', osVersion: '14', model: 'Pixel', simulator: true },
+      screen: '',
+      resolution: { width: 1080, height: 2400 },
+      elements: [
+        {
+          text: 'Out of range',
+          type: 'android.widget.SeekBar',
+          contentDescription: null,
+          clickable: true,
+          enabled: true,
+          visible: true,
+          bounds: [0, 0, 200, 40],
+          resourceId: 'seek_range',
+          state: {
+            value: 10,
+            raw_value: 10,
+            value_range: { min: 0, max: 20 }
+          }
+        }
+      ]
+    })
+
+    const outOfRangeAdjust = await ToolsInteract.adjustControlHandler({
+      selector: { text: 'Out of range' },
+      property: 'value',
+      targetValue: 30,
+      platform: 'android'
+    })
+
+    assert.strictEqual(outOfRangeAdjust.success, false)
+    assert.strictEqual(outOfRangeAdjust.failure_code, 'CONTROL_CONVERGENCE_FAILED')
+
+    let inferredLabelTreeValue = 3
+    const inferredLabelTree = () => ({
+      device: { platform: 'android', id: 'mock-device', osVersion: '14', model: 'Pixel', simulator: true },
+      screen: '',
+      resolution: { width: 1280, height: 2856 },
+      elements: [
+        {
+          text: 'Duration',
+          type: 'android.widget.TextView',
+          contentDescription: null,
+          clickable: false,
+          enabled: true,
+          visible: true,
+          bounds: [132, 1855, 404, 1951],
+          resourceId: null,
+          state: { value: 'Duration' }
+        },
+        {
+          text: String(inferredLabelTreeValue),
+          type: 'android.widget.TextView',
+          contentDescription: null,
+          clickable: false,
+          enabled: true,
+          visible: true,
+          bounds: [987, 1827, 1063, 1985],
+          resourceId: null,
+          state: { value: String(inferredLabelTreeValue) }
+        },
+        {
+          text: 'min',
+          type: 'android.widget.TextView',
+          contentDescription: null,
+          clickable: false,
+          enabled: true,
+          visible: true,
+          bounds: [1075, 1891, 1148, 1951],
+          resourceId: null,
+          state: { value: 'min' }
+        },
+        {
+          text: '1 min',
+          type: 'android.widget.TextView',
+          contentDescription: null,
+          clickable: false,
+          enabled: true,
+          visible: true,
+          bounds: [132, 2177, 228, 2225],
+          resourceId: null,
+          state: { value: '1 min' }
+        },
+        {
+          text: '15 min',
+          type: 'android.widget.TextView',
+          contentDescription: null,
+          clickable: false,
+          enabled: true,
+          visible: true,
+          bounds: [1031, 2177, 1148, 2225],
+          resourceId: null,
+          state: { value: '15 min' }
+        },
+        {
+          text: null,
+          type: 'android.view.View',
+          contentDescription: null,
+          clickable: true,
+          enabled: true,
+          visible: true,
+          bounds: [84, 2369, 1196, 2513],
+          resourceId: null,
+          state: { selected: true, enabled: true }
+        }
+      ]
+    })
+
+    ;(Observe as any).ToolsObserve.getUITreeHandler = async () => inferredLabelTree()
+    ;(ToolsInteract as any).tapHandler = async ({ platform, x, y, deviceId }: any) => {
+      tapCalls.push({ platform, x, y, deviceId })
+      return {
+        device: { platform: platform || 'android', id: deviceId || 'mock-device', osVersion: '14', model: 'Pixel', simulator: true },
+        success: true,
+        x,
+        y
+      }
+    }
+    ;(ToolsInteract as any).swipeHandler = async ({ platform, x1, y1, x2, y2, duration, deviceId }: any) => {
+      swipeCalls.push({ platform, x1, y1, x2, y2, duration, deviceId })
+      inferredLabelTreeValue = 5
+      return {
+        device: { platform: platform || 'android', id: deviceId || 'mock-device', osVersion: '14', model: 'Pixel', simulator: true },
+        success: true,
+        start: [x1, y1],
+        end: [x2, y2],
+        duration
+      }
+    }
+
+    const inferredTapStart = tapCalls.length
+    const inferredSwipeStart = swipeCalls.length
+    const inferredLabelAdjust = await ToolsInteract.adjustControlHandler({
+      selector: { text: 'Duration' },
+      property: 'value',
+      targetValue: 5,
+      tolerance: 0.5,
+      platform: 'android'
+    })
+
+    assert.strictEqual(inferredLabelAdjust.success, true)
+    assert.strictEqual(inferredLabelAdjust.adjustment_mode, 'gesture')
+    assert.strictEqual(inferredLabelAdjust.target_state.target_value, 5)
+    assert.strictEqual(inferredLabelAdjust.actual_state?.value, 5)
+    assert.strictEqual(tapCalls.length, inferredTapStart + 1)
+    assert.strictEqual(swipeCalls.length, inferredSwipeStart + 1)
+    assert.strictEqual(swipeCalls[swipeCalls.length - 1].duration, 520)
+    assert.ok(tapCalls[tapCalls.length - 1].y < 2369, 'inferred slider tap should avoid the clickable view below the min/max labels')
+    assert.ok(swipeCalls[swipeCalls.length - 1].y1 < 2369, 'inferred slider drag should start above the clickable view below the min/max labels')
+    assert.ok(swipeCalls[swipeCalls.length - 1].y2 < 2369, 'inferred slider drag should end above the clickable view below the min/max labels')
 
     console.log('adjust_control unit tests passed')
   } finally {
@@ -536,6 +1088,7 @@ async function run() {
     ;(ToolsInteract as any).tapHandler = originalTapHandler
     ;(ToolsInteract as any).swipeHandler = originalSwipeHandler
     ;(ToolsInteract as any).expectStateHandler = originalExpectStateHandler
+    ;(ToolsInteract as any).getInteractionService = originalGetInteractionService
   }
 }
 

package/test/unit/server/contract.test.ts

@@ -70,6 +70,10 @@ async function run() {
   const adjustControl = toolDefinitions.find((tool) => tool.name === 'adjust_control')
   assert(adjustControl, 'adjust_control should be registered')
   assert.deepStrictEqual((adjustControl as any).inputSchema.required, ['targetValue'])
+  assert.deepStrictEqual((adjustControl as any).inputSchema.oneOf, [
+    { required: ['selector'] },
+    { required: ['element_id'] }
+  ])
   assert.strictEqual((adjustControl as any).inputSchema.properties.targetValue.type, 'number')
   assert.match((adjustControl as any).description, /numeric control value/i)
   assert.match((adjustControl as any).description, /expect_state/i)