DRAFT: feat: webview commands for listing and evaluating js

.github/workflows/build.yml

@@ -17,9 +17,45 @@ on:
 
 jobs:
 
+  build_agents:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+    - uses: actions/checkout@v5
+
+    - name: Set up JDK 21
+      uses: actions/setup-java@v4
+      with:
+        java-version: '21'
+        distribution: 'temurin'
+
+    - name: Install Android NDK and build tools
+      run: |
+        sdkmanager --install \
+          "ndk;29.0.13113456" \
+          "build-tools;36.0.0" \
+          "platforms;android-35"
+      env:
+        ANDROID_HOME: /usr/local/lib/android/sdk
+
+    - name: Build agents
+      run: make -C agents/android all
+      env:
+        ANDROID_HOME: /usr/local/lib/android/sdk
+
+    - name: Upload agent binaries
+      uses: actions/upload-artifact@v5
+      with:
+        name: android-agents
+        path: |
+          agents/android/devicekit.so
+          agents/android/devicekit.dex
+        retention-days: 1
+
   test:
     runs-on: ubuntu-latest
     timeout-minutes: 10
+    needs: [build_agents]
     steps:
     - uses: actions/checkout@v5
 
@@ -28,9 +64,14 @@ jobs:
       with:
         go-version-file: go.mod
 
+    - name: Download agent binaries
+      uses: actions/download-artifact@v5
+      with:
+        name: android-agents
+        path: agents/android/
+
     - name: Run Unit Tests
-      run: |
-        make build test
+      run: make build test
 
   lint:
     runs-on: ubuntu-latest
@@ -80,7 +121,7 @@ jobs:
     timeout-minutes: 10
     permissions:
       contents: read
-    needs: [test, lint, security]
+    needs: [build_agents, test, lint, security]
     steps:
     - uses: actions/checkout@v5
 
@@ -89,6 +130,12 @@ jobs:
       with:
         go-version-file: go.mod
 
+    - name: Download agent binaries
+      uses: actions/download-artifact@v5
+      with:
+        name: android-agents
+        path: agents/android/
+
     - name: Install dependencies
       run: |
         go install golang.org/x/tools/cmd/goimports@latest
@@ -120,7 +167,7 @@ jobs:
     timeout-minutes: 10
     permissions:
       contents: read
-    needs: [test, lint, security]
+    needs: [build_agents, test, lint, security]
     steps:
     - uses: actions/checkout@v5
 
@@ -129,6 +176,12 @@ jobs:
       with:
         go-version-file: go.mod
 
+    - name: Download agent binaries
+      uses: actions/download-artifact@v5
+      with:
+        name: android-agents
+        path: agents/android/
+
     - name: Install dependencies
       run: |
         go install golang.org/x/tools/cmd/goimports@latest
@@ -161,9 +214,16 @@ jobs:
     timeout-minutes: 10
     permissions:
       contents: read
-    needs: [test, lint, security]
+    needs: [build_agents, test, lint, security]
     steps:
     - uses: actions/checkout@v5
+
+    - name: Download agent binaries
+      uses: actions/download-artifact@v5
+      with:
+        name: android-agents
+        path: agents/android/
+
     - name: Set up Go
       uses: actions/setup-go@v5
       with:

.gitignore

@@ -5,3 +5,7 @@ screenshot.png
 **/coverage*.out
 **/coverage*.html
 test/coverage
+agents/android/devicekit.so
+agents/android/devicekit.dex
+agents/ios/agent-sim.dylib
+agents/ios/agent-dev.dylib

Makefile

@@ -1,12 +1,16 @@
-.PHONY: all build test test-cover lint fmt clean
+.PHONY: all build agents test test-cover lint fmt clean
 
 all: build
 
-build:
+agents:
+	$(MAKE) -C agents/android all
+	$(MAKE) -C agents/ios all
+
+build: agents
 	go mod tidy
 	CGO_ENABLED=0 go build -ldflags="-s -w"
 
-build-cover:
+build-cover: agents
 	go mod tidy
 	CGO_ENABLED=0 go build -ldflags="-s -w" -cover
 
@@ -31,4 +35,5 @@ fmt:
 	$(shell go env GOPATH)/bin/goimports -w .
 
 clean:
+	$(MAKE) -C agents/android clean
 	rm -f mobilecli coverage.out coverage.html

README.md

@@ -37,6 +37,7 @@ A universal command-line tool for managing iOS and Android devices, simulators,
 - **Device Control**: Reboot devices, tap screen coordinates, press hardware buttons
 - **App Management**: Launch, terminate, install, uninstall, list, and get foreground apps
 - **Crash Reports**: List and fetch crash reports from iOS and Android devices
+- **Webview Inspection**: List, navigate, query DOM, and evaluate JavaScript in embedded webviews
 
 ### 🎯 Platform Support
 
@@ -255,6 +256,66 @@ Example output for `agent status`:
 }
 ```
 
+### Webview Inspection 🌐
+
+Inspect and interact with embedded webviews (`WKWebView` on iOS, `android.webkit.WebView` on Android) running inside native apps.
+
+```bash
+# List embedded webviews in the foreground app
+mobilecli webview list --device <device-id>
+
+# Navigate a webview to a URL
+mobilecli webview goto <id> https://example.com --device <device-id>
+
+# Reload, go back or forward
+mobilecli webview reload <id> --device <device-id>
+mobilecli webview back <id> --device <device-id>
+mobilecli webview forward <id> --device <device-id>
+
+# Get current URL and page title
+mobilecli webview url <id> --device <device-id>
+mobilecli webview title <id> --device <device-id>
+
+# Dump the full HTML content of the page
+mobilecli webview content <id> --device <device-id>
+
+# Query DOM elements by CSS selector
+mobilecli webview query <id> "button" --device <device-id>
+mobilecli webview query <id> "[data-testid='submit']" --device <device-id>
+
+# Evaluate arbitrary JavaScript
+mobilecli webview eval <id> "document.querySelectorAll('a').length" --device <device-id>
+
+# Wait for the page to finish loading
+mobilecli webview wait <id> --state load --device <device-id>
+mobilecli webview wait <id> --state domcontentloaded --timeout 5000 --device <device-id>
+```
+
+Example output for `webview list`:
+```json
+{
+  "status": "ok",
+  "data": [
+    {
+      "id": "1",
+      "url": "https://example.com",
+      "title": "Example Domain"
+    }
+  ]
+}
+```
+
+Example output for `webview query <id> "button"`:
+```json
+{
+  "status": "ok",
+  "data": [
+    { "tag": "button", "text": "Sign In", "id": "login-btn", "class": "btn-primary", "value": null, "href": null },
+    { "tag": "button", "text": "Cancel", "id": null, "class": "btn-secondary", "value": null, "href": null }
+  ]
+}
+```
+
 ### Crash Reports 💥
 
 ```bash

agents/agents.go

@@ -0,0 +1,13 @@
+package agents
+
+import _ "embed"
+
+//go:embed android/devicekit.so
+var AndroidDevicekitSO []byte
+
+//go:embed android/devicekit.dex
+var AndroidDevicekitDEX []byte
+
+//go:embed ios/agent-sim.dylib
+var IOSAgentSimDylib []byte
+

agents/android/Makefile

@@ -0,0 +1,57 @@
+NDK_VERSION         ?= 29.0.13113456
+BUILD_TOOLS_VERSION ?= 36.0.0
+
+# macOS default; override with ANDROID_HOME env var (e.g. on Linux CI)
+ANDROID_HOME ?= $(HOME)/Library/Android/sdk
+
+# Detect host OS for NDK toolchain path and JNI header subdir
+UNAME_S := $(shell uname -s)
+ifeq ($(UNAME_S),Linux)
+  PREBUILT     := linux-x86_64
+  JDK_PLATFORM := linux
+else
+  PREBUILT     := darwin-x86_64
+  JDK_PLATFORM := darwin
+endif
+
+NDK       := $(ANDROID_HOME)/ndk/$(NDK_VERSION)
+TOOLCHAIN := $(NDK)/toolchains/llvm/prebuilt/$(PREBUILT)/bin
+SYSROOT   := $(NDK)/toolchains/llvm/prebuilt/$(PREBUILT)/sysroot/usr/include
+
+CC_ANDROID  := $(TOOLCHAIN)/aarch64-linux-android26-clang
+D8          := $(ANDROID_HOME)/build-tools/$(BUILD_TOOLS_VERSION)/d8
+ANDROID_JAR := $(ANDROID_HOME)/platforms/android-35/android.jar
+
+# Java: prefer JAVA_HOME, then macOS java_home helper, then system javac
+ifndef JAVA_HOME
+  JAVA_HOME := $(shell /usr/libexec/java_home 2>/dev/null)
+endif
+ifeq ($(JAVA_HOME),)
+  JAVAC   := $(shell which javac)
+  JDK_INC := $(shell dirname $$(dirname $$(which javac)))/include
+else
+  JAVAC   := $(JAVA_HOME)/bin/javac
+  JDK_INC := $(JAVA_HOME)/include
+endif
+
+JAVA_SRCS := $(wildcard java/*.java)
+
+.PHONY: all clean
+
+all: devicekit.so devicekit.dex
+
+devicekit.so: jvmti_agent.c
+	$(CC_ANDROID) -shared -fPIC -O2 \
+		-I$(SYSROOT) -I$(JDK_INC) -I$(JDK_INC)/$(JDK_PLATFORM) \
+		-o $@ $< -llog
+
+devicekit.dex: $(JAVA_SRCS)
+	mkdir -p .dex_build
+	$(JAVAC) --release 8 -cp $(ANDROID_JAR) -d .dex_build $(JAVA_SRCS)
+	$(D8) --min-api 26 --output .dex_build $$(find .dex_build -name "*.class")
+	mv .dex_build/classes.dex devicekit.dex
+	rm -rf .dex_build
+
+clean:
+	rm -f devicekit.so devicekit.dex
+	rm -rf .dex_build