mobile-debug-mcp 0.34.0 → 0.35.0

package/test/device/automated/interact/interaction.android.test.ts

@@ -0,0 +1,56 @@
+import assert from 'node:assert/strict'
+import { execFileSync } from 'node:child_process'
+import { rm } from 'node:fs/promises'
+import { Client } from '@modelcontextprotocol/sdk/client/index.js'
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js'
+import { buildDebuggerFixture, debuggerAppId } from '../../../fixtures/debugger-app/build.js'
+
+// Reuse the isolated fixture; the device runner executes fixture journeys sequentially.
+const deviceId = process.env.MCP_INTERACTION_DEVICE ?? process.env.MCP_DEBUGGER_DEVICE
+if (!deviceId) {
+  console.log('UNRUN Android interaction fixture: select an emulator with MCP_INTERACTION_DEVICE')
+} else {
+  const fixture = buildDebuggerFixture()
+  const adb = (...args: string[]) => execFileSync(process.env.ADB_PATH || 'adb', ['-s', deviceId, ...args], { encoding: 'utf8', timeout: 30000 })
+  const client = new Client({ name: 'interaction-service-smoke', version: '1.0.0' })
+  const target = { platform: 'android', deviceId }
+  const call = async (name: string, args: Record<string, unknown>) => {
+    const response = await client.callTool({ name, arguments: args }, undefined, { timeout: 120000 })
+    const text = response.content.find(item => item.type === 'text')
+    assert(text?.type === 'text')
+    return JSON.parse(text.text)
+  }
+  try {
+    await client.connect(new StdioClientTransport({ command: process.execPath, args: ['dist/server.js'], stderr: 'pipe' }))
+    adb('install', '-r', fixture.artifact)
+    const started = await call('start_app', { ...target, appId: debuggerAppId, verificationMode: 'none', responseMode: 'compact' })
+    assert.equal(started.success, true)
+    const waited = await call('wait_for_ui', { ...target, selector: { text: 'Calculate' }, condition: 'clickable', timeout_ms: 20000 })
+    assert.equal(waited.status, 'success', JSON.stringify(waited))
+    assert.ok(waited.element?.elementId)
+    const tapped = await call('tap_element', { ...target, elementId: waited.element.elementId, verificationMode: 'none', actionTimeoutMs: 30000 })
+    assert.equal(tapped.success, true, JSON.stringify(tapped))
+    const visible = await call('expect_element_visible', { ...target, selector: { text: 'Result 43' }, timeout_ms: 20000 })
+    assert.equal(visible.success, true, JSON.stringify(visible))
+    const journey = await call('run_journey', { ...target, steps: [
+      { id: 'calculate-again', type: 'tap', selector: { text: 'Calculate' }, verificationMode: 'none' },
+      { id: 'enabled-result', type: 'assert', timeoutMs: 30000, assertion: { kind: 'state_equals', selector: { text: 'Result 43' }, property: 'enabled', expected: true } },
+      { id: 'visible-result', type: 'assert', timeoutMs: 20000, assertion: { kind: 'element_visible', selector: { text: 'Result 43' } } }
+    ], defaults: { actionTimeoutMs: 30000 } })
+    assert.equal(journey.success, true, JSON.stringify(journey))
+    const adjusted = await call('adjust_control', { ...target, selector: { accessibility_id: 'Fixture level' },
+      property: 'value', targetValue: 75, tolerance: 5, maxAttempts: 5 })
+    assert.equal(adjusted.success, true, JSON.stringify(adjusted))
+    assert.equal(adjusted.converged, true, JSON.stringify(adjusted))
+    assert(Math.abs(adjusted.actual_state.value - 75) <= 5, JSON.stringify(adjusted))
+    const level = await call('expect_element_visible', { ...target, selector: { text: `${adjusted.actual_state.value} %` }, timeout_ms: 20000 })
+    assert.equal(level.success, true, JSON.stringify(level))
+    console.log(JSON.stringify({ status: 'PASS', server: client.getServerVersion(), device: deviceId,
+      api: adb('shell', 'getprop', 'ro.build.version.sdk').trim(), runtime: process.version,
+      journey: 'clickable wait, resolved-handle tap, visible assertion, selector journey and stable enabled-state assertion and labelled SeekBar convergence',
+      evidence: 'Result 43, enabled=true and adjusted slider label established by fresh hierarchy assertions', cleanup: 'Owned fixture removed in finally; no other app data or device settings changed' }))
+  } finally {
+    await client.close()
+    try { adb('uninstall', debuggerAppId) } finally { await rm(fixture.directory, { recursive: true, force: true }) }
+  }
+}

package/test/device/automated/observe/system-trace.smoke.ts

@@ -82,7 +82,7 @@ async function run() {
     const absent = await execCmd(getAdbCmd(), ['-s', device.id, 'shell', 'test', '!', '-e', remote], { timeout: 10000 })
     assert.equal(absent.exitCode, 0, `Shutdown must stop and remove its owned device capture: ${shutdownTrace.trace_id}; ${shutdownDiagnostics}; ${absent.stderr}`)
     const buildHash = createHash('sha256')
-    for (const file of ['dist/server.js', 'dist/observe/system-trace.js', 'dist/observe/system-trace-android.js', 'dist/server/tool-handlers.js', 'dist/observe/evidence.js']) buildHash.update(await fs.readFile(file))
+    for (const file of ['dist/server.js', 'dist/observe/system-trace.js', 'dist/observe/system-trace-android.js', 'dist/server/handlers/tool-handlers.js', 'dist/observe/evidence.js']) buildHash.update(await fs.readFile(file))
     const report = { status: 'PASS', build_sha256: buildHash.digest('hex'), runtime: process.version, server: client.getServerVersion(), device: device.id, osVersion: device.osVersion,
       starting_state: 'System Settings fixture', journey: 'start Settings, assert baseline Settings-owned resource visible in UI tree; explicit trace association',
       trace_id: start.trace_id, correlation_id: journey.evidence.correlation_id, phases: {

package/test/device/manual/interact/modul8_selector_tap.manual.ts

@@ -11,7 +11,7 @@ async function run() {
   const transport = new StdioClientTransport({ command: process.execPath, args: ['dist/server.js'], stderr: 'pipe' })
   const target = { platform: 'android', deviceId: 'emulator-5554' }
   const report: any = { verified_on: new Date().toISOString(), device: target, package: 'com.ideamechanics.modul8.dev',
-    source: 'rebuilt local MCP stdio server', build_sha256: createHash('sha256').update(readFileSync('dist/server/tool-handlers.js')).digest('hex'),
+    source: 'rebuilt local MCP stdio server', build_sha256: createHash('sha256').update(readFileSync('dist/server/handlers/tool-handlers.js')).digest('hex'),
     steps: [], status: 'UNRUN', cleanup: 'UNRUN' }
   const call = async (name: string, args: Record<string, unknown>) => {
     const response: any = await client.callTool({ name, arguments: { ...target, ...args } }, undefined, { timeout: 120000 })