mobile-debug-mcp 0.30.1 → 0.30.2

package/src/server/tool-definitions.ts

@@ -568,11 +568,11 @@ Adjust a numeric control value with verification.
 This is the initial adjustable-control surface for slider-like controls and other controls that expose a numeric value or value_range.
 
 Inputs:
-- selector or element_id
+- exactly one of selector or element_id
 - property (defaults to "value")
 - targetValue
-- tolerance (optional)
-- maxAttempts (optional)
+- tolerance (optional; discrete default is 0, continuous default is max(step / 2, 1% of range) when omitted)
+- maxAttempts (optional; defaults to 5)
 - platform/deviceId (optional)
 
 Output Structure:
@@ -584,14 +584,14 @@ Output Structure:
 - success = true when the control converges within tolerance
 
 Verification Guidance:
-- Prefer direct target placement when value_range is available; fall back to a drag only if the direct tap does not converge
+- Prefer direct platform adjustment when the runtime exposes it; then verified increment/decrement actions; use coordinate fallback only as degraded mode
 - Use expect_state for the control value readback
-- Treat coordinate fallback as degraded mode
+- Do not use derived semantic metadata as proof of success
 
 Failure Handling:
 - ELEMENT_NOT_FOUND → re-resolve the control
 - ELEMENT_NOT_INTERACTABLE → the control cannot be adjusted through the current runtime
-- TIMEOUT → the control did not converge within bounded retries
+- CONTROL_CONVERGENCE_FAILED → the control did not converge within bounded retries or the requested value is out of range
 - UNKNOWN → capture a snapshot and stop`,
     inputSchema: {
       type: 'object',
@@ -608,12 +608,16 @@ Failure Handling:
         element_id: { type: 'string', description: 'Optional previously resolved element identifier.' },
         property: { type: 'string', description: 'Readable numeric state property to adjust.', default: 'value' },
         targetValue: { type: 'number', description: 'Target numeric value.' },
-        tolerance: { type: 'number', description: 'Accepted numeric tolerance around the target value.', default: 0 },
-        maxAttempts: { type: 'number', description: 'Maximum adjustment attempts.', default: 3 },
+        tolerance: { type: 'number', description: 'Accepted numeric tolerance around the target value. Defaults are derived from the readable control domain.' },
+        maxAttempts: { type: 'number', description: 'Maximum adjustment attempts.', default: 5 },
         platform: { type: 'string', enum: ['android', 'ios'], description: 'Optional platform override' },
         deviceId: { type: 'string', description: 'Optional device serial/udid' }
       },
-      required: ['targetValue']
+      required: ['targetValue'],
+      oneOf: [
+        { required: ['selector'] },
+        { required: ['element_id'] }
+      ]
     }
   },
   {

package/src/server/tool-handlers.ts

@@ -282,12 +282,12 @@ async function handleAdjustControl(args: ToolCallArgs) {
   const element_id = getStringArg(args, 'element_id')
   const property = getStringArg(args, 'property') ?? 'value'
   const targetValue = requireNumberArg(args, 'targetValue')
-  const tolerance = getNumberArg(args, 'tolerance') ?? 0
-  const maxAttempts = getNumberArg(args, 'maxAttempts') ?? 3
+  const tolerance = getNumberArg(args, 'tolerance')
+  const maxAttempts = getNumberArg(args, 'maxAttempts')
   const platform = getStringArg(args, 'platform') as PlatformArg | undefined
   const deviceId = getStringArg(args, 'deviceId')
-  if (!selector && !element_id) {
-    throw new Error('Missing selector or element_id argument')
+  if ((!selector && !element_id) || (selector && element_id)) {
+    throw new Error('Exactly one of selector or element_id argument is required')
   }
   const res = await ToolsInteract.adjustControlHandler({
     selector: selector ?? undefined,

package/src/server-core.ts

@@ -16,7 +16,7 @@ export { wrapResponse, toolDefinitions, handleToolCall }
 
 export const serverInfo = {
   name: 'mobile-debug-mcp',
-  version: '0.30.1'
+  version: '0.30.2'
 }
 
 export function createServer() {

package/src/types.ts

@@ -91,7 +91,9 @@ export interface UIElementState {
   value_range?: {
     min: number;
     max: number;
+    step?: number | null;
   } | null;
+  step?: number | null;
 }
 
 export interface SelectorConfidence {