mobile-debug-mcp 0.20.1 → 0.21.1

package/test/observe/unit/wait_for_element_mock.ts

@@ -1,104 +1,2 @@
-import { AndroidInteract } from '../../../src/interact/index.js';
-import { AndroidObserve } from '../../../src/observe/index.js';
-
-const originalGetUITree = (AndroidObserve as any).prototype.getUITree;
-
-async function runTests() {
-  console.log("Starting tests for wait_for_element...");
-  const interact = new AndroidInteract();
-
-  console.log("\nTest 1: Element found immediately");
-  (AndroidObserve as any).prototype.getUITree = async () => ({
-    device: { platform: "android", id: "mock", osVersion: "12", model: "Pixel", simulator: true },
-    screen: "",
-    resolution: { width: 1080, height: 1920 },
-    elements: [{
-      text: "Target",
-      type: "Button",
-      contentDescription: null,
-      clickable: true,
-      enabled: true,
-      visible: true,
-      bounds: [0, 0, 100, 100],
-      resourceId: null
-    }]
-  });
-
-  const start1 = Date.now();
-  const result1 = await interact.waitForElement("Target", 1000);
-  const elapsed1 = Date.now() - start1;
-  console.log("Result:", result1.found === true ? "PASS" : "FAIL");
-  console.log("Element:", result1.element ? "FOUND" : "MISSING");
-  console.log("Elapsed:", elapsed1, "ms");
-
-  console.log("\nTest 2: Element not found (timeout)");
-  (AndroidObserve as any).prototype.getUITree = async () => ({
-    device: { platform: "android", id: "mock", osVersion: "12", model: "Pixel", simulator: true },
-    screen: "",
-    resolution: { width: 1080, height: 1920 },
-    elements: []
-  });
-
-  const start2 = Date.now();
-  const result2 = await interact.waitForElement("Target", 1200);
-  const elapsed2 = Date.now() - start2;
-  console.log("Result:", result2.found === false ? "PASS" : "FAIL");
-  console.log("Elapsed time (should be >= 1200ms):", elapsed2, elapsed2 >= 1200 ? "PASS" : "FAIL");
-
-  console.log("\nTest 3: Element found after polling");
-  let calls = 0;
-  (AndroidObserve as any).prototype.getUITree = async () => {
-    calls++;
-    if (calls < 3) {
-      return {
-        device: { platform: "android", id: "mock", osVersion: "12", model: "Pixel", simulator: true },
-        screen: "",
-        resolution: { width: 1080, height: 1920 },
-        elements: []
-      };
-    }
-    return {
-      device: { platform: "android", id: "mock", osVersion: "12", model: "Pixel", simulator: true },
-      screen: "",
-      resolution: { width: 1080, height: 1920 },
-      elements: [{
-        text: "Target",
-        type: "Button",
-        contentDescription: null,
-        clickable: true,
-        enabled: true,
-        visible: true,
-        bounds: [0, 0, 100, 100],
-        resourceId: null
-      }]
-    };
-  };
-
-  const start3 = Date.now();
-  const result3 = await interact.waitForElement("Target", 2000);
-  const elapsed3 = Date.now() - start3;
-  console.log("Result:", result3.found === true ? "PASS" : "FAIL");
-  console.log("Calls:", calls, calls >= 3 ? "PASS" : "FAIL");
-  console.log("Elapsed time (should be >= 1000ms):", elapsed3, elapsed3 >= 1000 ? "PASS" : "FAIL");
-
-  console.log("\nTest 4: Error handling (fast failure)");
-  (AndroidObserve as any).prototype.getUITree = async () => ({
-    device: { platform: "android", id: "mock", osVersion: "12", model: "Pixel", simulator: true },
-    screen: "",
-    resolution: { width: 0, height: 0 },
-    elements: [],
-    error: "ADB Connection Failed"
-  });
-
-  const start4 = Date.now();
-  const result4 = await interact.waitForElement("Target", 5000);
-  const elapsed4 = Date.now() - start4;
-  console.log("Result:", result4.found === false && result4.error === "ADB Connection Failed" ? "PASS" : "FAIL");
-  console.log("Error Message:", result4.error);
-  console.log("Elapsed time (should be < 1000ms):", elapsed4, elapsed4 < 1000 ? "PASS" : "FAIL");
-
-  // Restore
-  (AndroidObserve as any).prototype.getUITree = originalGetUITree;
-}
-
-runTests().catch(console.error);
+// wait_for_element tests removed — tool deprecated
+console.log('wait_for_element unit tests removed');

package/test/observe/unit/wait_for_ui_edge_cases.test.ts

@@ -0,0 +1,41 @@
+import { ToolsInteract } from '../../../../src/interact/index.js'
+import * as Observe from '../../../../src/observe/index.js'
+
+async function run() {
+  console.log('Unit: wait_for_ui edge cases')
+
+  const origFind = (ToolsInteract as any).findElementHandler
+  const origFp = (Observe as any).ToolsObserve.getScreenFingerprintHandler
+
+  try {
+    // 1) Immediate absence should pass for match='absent'
+    (ToolsInteract as any).findElementHandler = async () => ({ found: false })
+    const r1 = await (ToolsInteract as any).waitForUIHandler({ type: 'ui', query: 'Nothing', timeoutMs: 2000, pollIntervalMs: 100, stability_ms: 200, match: 'absent', platform: 'android' })
+    console.log('Immediate absent test:', r1 && (r1 as any).success ? 'PASS' : 'FAIL', JSON.stringify({ poll_count: (r1 as any).poll_count, duration_ms: (r1 as any).duration_ms, stable_duration_ms: (r1 as any).stable_duration_ms, matchSource: (r1 as any).matchSource }, null, 2))
+
+    // 2) Boundary stability: condition becomes true and stays exactly long enough
+    // Use pollInterval 100ms and stability 300ms -> need ~3 consecutive trues
+    let seq2 = [false, true, true, true]
+    (ToolsInteract as any).findElementHandler = async () => ({ found: seq2.shift() ?? true })
+    const r2 = await (ToolsInteract as any).waitForUIHandler({ type: 'ui', query: 'Boundary', timeoutMs: 2000, pollIntervalMs: 100, stability_ms: 300, match: 'present', platform: 'android' })
+    console.log('Boundary stability test:', r2 && (r2 as any).success ? 'PASS' : 'FAIL', JSON.stringify({ poll_count: (r2 as any).poll_count, duration_ms: (r2 as any).duration_ms, stable_duration_ms: (r2 as any).stable_duration_ms, matchSource: (r2 as any).matchSource }, null, 2))
+
+    // 3) Long flicker that never stabilizes should timeout/fail
+    // Sequence toggles true/false repeatedly
+    let seq3 = [false, true, false, true, false, true, false]
+    (ToolsInteract as any).findElementHandler = async () => ({ found: seq3.shift() ?? false })
+    const r3 = await (ToolsInteract as any).waitForUIHandler({ type: 'ui', query: 'Flicker', timeoutMs: 1200, pollIntervalMs: 150, stability_ms: 400, match: 'present', platform: 'android' })
+    console.log('Long flicker timeout test:', !(r3 && (r3 as any).success) ? 'PASS' : 'FAIL', JSON.stringify({ poll_count: (r3 as any).poll_count, duration_ms: (r3 as any).duration_ms, stable_duration_ms: (r3 as any).stable_duration_ms, matchSource: (r3 as any).matchSource }, null, 2))
+
+    // 4) Very short stability requirement should pass quickly
+    (ToolsInteract as any).findElementHandler = async () => ({ found: true })
+    const r4 = await (ToolsInteract as any).waitForUIHandler({ type: 'ui', query: 'ShortStable', timeoutMs: 2000, pollIntervalMs: 200, stability_ms: 50, match: 'present', platform: 'android' })
+    console.log('Short stability test:', r4 && (r4 as any).success ? 'PASS' : 'FAIL', JSON.stringify({ poll_count: (r4 as any).poll_count, duration_ms: (r4 as any).duration_ms, stable_duration_ms: (r4 as any).stable_duration_ms, matchSource: (r4 as any).matchSource }, null, 2))
+
+  } finally {
+    (ToolsInteract as any).findElementHandler = origFind
+    (Observe as any).ToolsObserve.getScreenFingerprintHandler = origFp
+  }
+}
+
+run().catch(e=>{ console.error(e); process.exit(1) })

package/test/observe/unit/wait_for_ui_stability.test.ts

@@ -0,0 +1,30 @@
+import { ToolsInteract } from '../../../../src/interact/index.js'
+import * as Observe from '../../../../src/observe/index.js'
+
+async function run() {
+  console.log('Unit: wait_for_ui stability behavior')
+
+  const origFind = (ToolsInteract as any).findElementHandler
+  const origFp = (Observe as any).ToolsObserve.getScreenFingerprintHandler
+
+  try {
+    // Simulate UI flicker: present, absent, present, then stable
+    const seq = [false, true, false, true, true, true]
+    (ToolsInteract as any).findElementHandler = async () => ({ found: seq.shift() ?? true })
+
+    const res = await (ToolsInteract as any).waitForUIHandler({ type: 'ui', query: 'X', timeoutMs: 5000, pollIntervalMs: 100, stability_ms: 500, platform: 'android' })
+    const ok = res && (res as any).success
+    console.log('Flicker stability test:', ok ? 'PASS' : 'FAIL', JSON.stringify((res as any).telemetry || {}, null, 2))
+
+    // Simulate immediate stable presence
+    (ToolsInteract as any).findElementHandler = async () => ({ found: true })
+    const res2 = await (ToolsInteract as any).waitForUIHandler({ type: 'ui', query: 'Y', timeoutMs: 2000, pollIntervalMs: 100, stability_ms: 300, platform: 'android' })
+    console.log('Immediate stable test:', res2 && (res2 as any).success ? 'PASS' : 'FAIL', JSON.stringify((res2 as any).telemetry || {}, null, 2))
+
+  } finally {
+    (ToolsInteract as any).findElementHandler = origFind
+    (Observe as any).ToolsObserve.getScreenFingerprintHandler = origFp
+  }
+}
+
+run().catch(e=>{ console.error(e); process.exit(1) })

package/test/unit/index.ts

@@ -1,18 +1,30 @@
 // Aggregator entrypoint for unit tests (updated to new test layout)
-import '../observe/unit/logparse.test.ts'
-import '../observe/unit/logstream.test.ts'
-import '../observe/unit/wait_for_element_mock.ts'
-import '../observe/unit/get_screen_fingerprint.test.ts'
+(async function() {
+  // Core unit tests that do not require real devices
+  await import('../observe/unit/logparse.test.ts')
+  await import('../observe/unit/logstream.test.ts')
+  await import('../observe/unit/get_screen_fingerprint.test.ts')
 
-import '../manage/unit/install.test.ts'
-import '../manage/unit/build.test.ts'
-import '../manage/unit/build_and_install.test.ts'
-import '../manage/unit/diagnostics.test.ts'
-import '../manage/unit/detection.test.ts'
-import '../manage/unit/mcp_disable_autodetect.test.ts'
-import '../interact/unit/wait_for_screen_change.test.ts'
-import '../observe/unit/capture_debug_snapshot.test.ts'
-import '../observe/unit/find_element.test.ts'
-import '../interact/unit/observe_until.test.ts'
+  await import('../manage/unit/install.test.ts')
+  await import('../manage/unit/build.test.ts')
+  await import('../manage/unit/build_and_install.test.ts')
+  await import('../manage/unit/diagnostics.test.ts')
+  await import('../manage/unit/detection.test.ts')
+  await import('../manage/unit/mcp_disable_autodetect.test.ts')
+  await import('../interact/unit/wait_for_screen_change.test.ts')
 
-console.log('Unit tests loaded.')
+  // Conditionally include device-dependent unit tests. Set SKIP_DEVICE_TESTS=1 to exclude.
+  if (process.env.SKIP_DEVICE_TESTS !== '1') {
+    try {
+      await import('../observe/unit/capture_debug_snapshot.test.ts')
+      await import('../observe/unit/find_element.test.ts')
+      await import('../interact/unit/wait_for_ui.test.ts')
+    } catch (e) {
+      console.warn('Skipping some device-dependent tests due to import error:', e instanceof Error ? e.message : String(e))
+    }
+  } else {
+    console.log('SKIP_DEVICE_TESTS=1 detected - skipping device-dependent unit tests')
+  }
+
+  console.log('Unit tests loaded.')
+})().catch(e => { console.error(e); process.exit(1) })

package/test/interact/device/observe_until_device.ts

@@ -1,24 +0,0 @@
-(async function main(){
-  try{
-    const inter = await import('../../src/interact/index.ts')
-    const manage = await import('../../src/manage/index.ts')
-    const ToolsInteract = (inter as any).ToolsInteract
-    const ToolsManage = (manage as any).ToolsManage
-
-    const ANDROID_ID = process.env.ANDROID_DEVICE || 'emulator-5554'
-    const IOS_UDID = process.env.IOS_DEVICE || '2EFFD8FD-5D09-47CC-95F8-28BBE30AF7ED'
-    console.log('Device test starting. Android:', ANDROID_ID, 'iOS:', IOS_UDID)
-
-    // Start modul8 on both platforms if present
-    try { await ToolsManage.startAppHandler({ platform: 'android', appId: 'com.ideamechanics.modul8', deviceId: ANDROID_ID }); console.log('Started android app (if installed)') } catch(e){ console.error('Android start skipped:', e.message || e) }
-    try { await ToolsManage.startAppHandler({ platform: 'ios', appId: 'com.ideamechanics.modul8.Modul8', deviceId: IOS_UDID }); console.log('Started ios app (if installed)') } catch(e){ console.error('iOS start skipped:', e.message || e) }
-
-    // Observe UI for Generate Session on both devices (will timeout if not present)
-    const aRes = await ToolsInteract.observeUntilHandler({ type: 'ui', query: 'Generate Session', timeoutMs: 20000, pollIntervalMs: 500, platform: 'android', deviceId: ANDROID_ID })
-    console.log('Android observe result:', JSON.stringify(aRes, null, 2))
-
-    const iRes = await ToolsInteract.observeUntilHandler({ type: 'ui', query: 'Generate Session', timeoutMs: 20000, pollIntervalMs: 500, platform: 'ios', deviceId: IOS_UDID })
-    console.log('iOS observe result:', JSON.stringify(iRes, null, 2))
-
-  } catch (e) { console.error('ERR', e); process.exit(1) }
-})()