sim-mirror 2.1.0__tar.gz → 2.2.0__tar.gz

{sim_mirror-2.1.0 → sim_mirror-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sim-mirror
-Version: 2.1.0
+Version: 2.2.0
 Summary: Mirror and drive iOS Simulators and real iPhones from Claude Code, CLI agents and the browser.
 Project-URL: Homepage, https://github.com/AndrewKochulab/sim-mirror
 Project-URL: Documentation, https://github.com/AndrewKochulab/sim-mirror/tree/main/docs
@@ -39,7 +39,7 @@ Description-Content-Type: text/markdown
 
 # SimMirror
 
-**Mirror and drive iOS Simulators and real iPhones from Claude Code, CLI agents and the browser.**
+**Mirror and drive iOS Simulators, real iPhones and Android devices from Claude Code, CLI agents and the browser.**
 
 [![CI](https://github.com/AndrewKochulab/sim-mirror/actions/workflows/ci.yml/badge.svg)](https://github.com/AndrewKochulab/sim-mirror/actions/workflows/ci.yml)
 [![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
@@ -52,16 +52,18 @@ through its notes, then fills in and saves a new one, the agent's cursor gliding
 *A real session, sped up four times. [The whole recording](https://github.com/AndrewKochulab/sim-mirror/releases/download/v1.2.0/sim-mirror-plugin-demo.mp4)
 runs 1m 39s.*
 
-A live iOS Simulator -- or your own iPhone, over its cable -- in any browser tab or web page, an animated cursor that
+A live iOS Simulator -- or your own iPhone, over its cable, or an Android emulator or phone -- in any browser tab or
+web page, an animated cursor that
 shows exactly what your AI agent is about to tap, and token-efficient UI snapshots so agents read the screen as compact
 text instead of screenshots. Record any screen as an MP4 or a GIF for a pull request. Works with Claude Code, Codex,
 Cursor and any other MCP client.
 
-> **Status: 2.1.** The agent tools, the viewer, the protocol and the embedding API are stable, and a check holds every
+> **Status: 2.2.** The agent tools, the viewer, the protocol and the embedding API are stable, and a check holds every
 > release to [what SimMirror promises not to break](docs/stability.md). 2.0 brought real iPhones and iPads beside the
 > simulators -- live over the cable, driven through WebDriverAgent -- and records any screen as an MP4 or a GIF. 2.1
 > reads and touches apps turned to landscape, keeps taps off what a tab bar covers, builds the worktree the agent works
-> in, and adds observe mode for walkthroughs on accounts an agent must not change. It removes nothing 1.x promised.
+> in, and adds observe mode for walkthroughs on accounts an agent must not change. 2.2 adds Android emulators and
+> phones, with the same viewer, cursor and tools. It removes nothing 1.x promised.
 
 ## Why SimMirror
 
@@ -89,7 +91,7 @@ Cursor and any other MCP client.
 **Any MCP client**, as a stdio server:
 
 ```sh
-claude mcp add sim-mirror -- uvx --from sim-mirror==2.1.0 sim-mirror mcp
+claude mcp add sim-mirror -- uvx --from sim-mirror==2.2.0 sim-mirror mcp
 ```
 
 Configurations for [Codex](docs/clients/codex.md), [Cursor](docs/clients/cursor.md) and
@@ -98,7 +100,7 @@ Configurations for [Codex](docs/clients/codex.md), [Cursor](docs/clients/cursor.
 **The command**, for `sim-mirror open`, `doctor` and the rest:
 
 ```sh
-uv tool install sim-mirror==2.1.0
+uv tool install sim-mirror==2.2.0
 # or
 brew install andrewkochulab/tap/sim-mirror
 ```
@@ -165,6 +167,11 @@ location through Xcode's `devicectl`; and touching, typing and its element tree
 with a click and signed by your project's own team -- a tap lands in about a third of a second. It is reached only over
 the cable, and what SimMirror changes on it is put back when it is let go. See [Real devices](docs/real-devices.md).
 
+**Android.** Android emulators and phones sit beside the simulators, with the same viewer, cursor and tools: adb
+lists, starts and drives them, scrcpy's server -- set up once with a click -- shows the screen live, UI Automator reads
+it for snapshots, and `sim_build_run` and `sim_test` build a Gradle project with its own wrapper. A phone is never
+started or shut down, and what SimMirror changes on it is put back. See [Android](docs/android.md).
+
 **Recording.** The viewer's Record button, `sim_record` or `sim-mirror record` keep a device's screen as an MP4, a GIF
 or both, with each touch drawn where it landed and a 9:41 status bar, and `preset: "pr"` keeps one small enough for
 a pull request. See [Recording](docs/recording.md).
@@ -219,6 +226,7 @@ an image at about 750 pixels a token).
 | Xcode | 26 and 27 |
 | Connectors | native helper (full control), idb_companion 1.5 (full control), simctl (view-only) |
 | Real devices | an iPhone or iPad that Xcode's `devicectl` reaches, by cable (view-only without WebDriverAgent) |
+| Android | emulators and phones adb reaches, with the Android SDK; scrcpy 5.0.1 for the live screen; Gradle builds |
 | App SDK | Debug builds on the iOS Simulator, iOS 16 or later |
 | Clients | Claude Code, Codex, Cursor, any stdio MCP client |
 | Browsers | Chrome, Safari, Firefox, Edge |
@@ -244,8 +252,8 @@ the [command line](docs/reference/cli.md) and the [protocol](docs/reference/prot
 | **v1.0** | Stable protocol and embedding API, held by a check; PyPI, npm and the MCP Registry; a cursor that stays while the agent works |
 | **v1.2** | SimMirror's own native helper instead of idb_companion, screens read from their pixels and settling past endless animations, an optional in-app debug SDK, and a Homebrew tap |
 | **v2.0** | Real iPhones and iPads: the live screen over the cable, apps, logs, look and location without signing; full control through WebDriverAgent; recording a screen as an MP4 or GIF |
-| **v2.1** (now) | Apps turned to landscape and `sim_device rotate`, taps kept off what bars cover, builds of the agent's worktree, observe mode, `sim-mirror stop`, and recordings sized for a pull request |
-| **Android** | Android emulator support with the same viewer, cursor and tools |
+| **v2.1** | Apps turned to landscape and `sim_device rotate`, taps kept off what bars cover, builds of the agent's worktree, observe mode, `sim-mirror stop`, and recordings sized for a pull request |
+| **v2.2** (now) | Android emulators and phones with the same viewer, cursor and tools: adb, scrcpy's live screen, and Gradle builds |
 | **Website & launch** | Landing page, video tutorials and guides |
 
 See [ROADMAP.md](ROADMAP.md) and the [milestones](https://github.com/AndrewKochulab/sim-mirror/milestones). How

{sim_mirror-2.1.0 → sim_mirror-2.2.0}/README.md

@@ -2,7 +2,7 @@
 
 # SimMirror
 
-**Mirror and drive iOS Simulators and real iPhones from Claude Code, CLI agents and the browser.**
+**Mirror and drive iOS Simulators, real iPhones and Android devices from Claude Code, CLI agents and the browser.**
 
 [![CI](https://github.com/AndrewKochulab/sim-mirror/actions/workflows/ci.yml/badge.svg)](https://github.com/AndrewKochulab/sim-mirror/actions/workflows/ci.yml)
 [![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
@@ -15,16 +15,18 @@ through its notes, then fills in and saves a new one, the agent's cursor gliding
 *A real session, sped up four times. [The whole recording](https://github.com/AndrewKochulab/sim-mirror/releases/download/v1.2.0/sim-mirror-plugin-demo.mp4)
 runs 1m 39s.*
 
-A live iOS Simulator -- or your own iPhone, over its cable -- in any browser tab or web page, an animated cursor that
+A live iOS Simulator -- or your own iPhone, over its cable, or an Android emulator or phone -- in any browser tab or
+web page, an animated cursor that
 shows exactly what your AI agent is about to tap, and token-efficient UI snapshots so agents read the screen as compact
 text instead of screenshots. Record any screen as an MP4 or a GIF for a pull request. Works with Claude Code, Codex,
 Cursor and any other MCP client.
 
-> **Status: 2.1.** The agent tools, the viewer, the protocol and the embedding API are stable, and a check holds every
+> **Status: 2.2.** The agent tools, the viewer, the protocol and the embedding API are stable, and a check holds every
 > release to [what SimMirror promises not to break](docs/stability.md). 2.0 brought real iPhones and iPads beside the
 > simulators -- live over the cable, driven through WebDriverAgent -- and records any screen as an MP4 or a GIF. 2.1
 > reads and touches apps turned to landscape, keeps taps off what a tab bar covers, builds the worktree the agent works
-> in, and adds observe mode for walkthroughs on accounts an agent must not change. It removes nothing 1.x promised.
+> in, and adds observe mode for walkthroughs on accounts an agent must not change. 2.2 adds Android emulators and
+> phones, with the same viewer, cursor and tools. It removes nothing 1.x promised.
 
 ## Why SimMirror
 
@@ -52,7 +54,7 @@ Cursor and any other MCP client.
 **Any MCP client**, as a stdio server:
 
 ```sh
-claude mcp add sim-mirror -- uvx --from sim-mirror==2.1.0 sim-mirror mcp
+claude mcp add sim-mirror -- uvx --from sim-mirror==2.2.0 sim-mirror mcp
 ```
 
 Configurations for [Codex](docs/clients/codex.md), [Cursor](docs/clients/cursor.md) and
@@ -61,7 +63,7 @@ Configurations for [Codex](docs/clients/codex.md), [Cursor](docs/clients/cursor.
 **The command**, for `sim-mirror open`, `doctor` and the rest:
 
 ```sh
-uv tool install sim-mirror==2.1.0
+uv tool install sim-mirror==2.2.0
 # or
 brew install andrewkochulab/tap/sim-mirror
 ```
@@ -128,6 +130,11 @@ location through Xcode's `devicectl`; and touching, typing and its element tree
 with a click and signed by your project's own team -- a tap lands in about a third of a second. It is reached only over
 the cable, and what SimMirror changes on it is put back when it is let go. See [Real devices](docs/real-devices.md).
 
+**Android.** Android emulators and phones sit beside the simulators, with the same viewer, cursor and tools: adb
+lists, starts and drives them, scrcpy's server -- set up once with a click -- shows the screen live, UI Automator reads
+it for snapshots, and `sim_build_run` and `sim_test` build a Gradle project with its own wrapper. A phone is never
+started or shut down, and what SimMirror changes on it is put back. See [Android](docs/android.md).
+
 **Recording.** The viewer's Record button, `sim_record` or `sim-mirror record` keep a device's screen as an MP4, a GIF
 or both, with each touch drawn where it landed and a 9:41 status bar, and `preset: "pr"` keeps one small enough for
 a pull request. See [Recording](docs/recording.md).
@@ -182,6 +189,7 @@ an image at about 750 pixels a token).
 | Xcode | 26 and 27 |
 | Connectors | native helper (full control), idb_companion 1.5 (full control), simctl (view-only) |
 | Real devices | an iPhone or iPad that Xcode's `devicectl` reaches, by cable (view-only without WebDriverAgent) |
+| Android | emulators and phones adb reaches, with the Android SDK; scrcpy 5.0.1 for the live screen; Gradle builds |
 | App SDK | Debug builds on the iOS Simulator, iOS 16 or later |
 | Clients | Claude Code, Codex, Cursor, any stdio MCP client |
 | Browsers | Chrome, Safari, Firefox, Edge |
@@ -207,8 +215,8 @@ the [command line](docs/reference/cli.md) and the [protocol](docs/reference/prot
 | **v1.0** | Stable protocol and embedding API, held by a check; PyPI, npm and the MCP Registry; a cursor that stays while the agent works |
 | **v1.2** | SimMirror's own native helper instead of idb_companion, screens read from their pixels and settling past endless animations, an optional in-app debug SDK, and a Homebrew tap |
 | **v2.0** | Real iPhones and iPads: the live screen over the cable, apps, logs, look and location without signing; full control through WebDriverAgent; recording a screen as an MP4 or GIF |
-| **v2.1** (now) | Apps turned to landscape and `sim_device rotate`, taps kept off what bars cover, builds of the agent's worktree, observe mode, `sim-mirror stop`, and recordings sized for a pull request |
-| **Android** | Android emulator support with the same viewer, cursor and tools |
+| **v2.1** | Apps turned to landscape and `sim_device rotate`, taps kept off what bars cover, builds of the agent's worktree, observe mode, `sim-mirror stop`, and recordings sized for a pull request |
+| **v2.2** (now) | Android emulators and phones with the same viewer, cursor and tools: adb, scrcpy's live screen, and Gradle builds |
 | **Website & launch** | Landing page, video tutorials and guides |
 
 See [ROADMAP.md](ROADMAP.md) and the [milestones](https://github.com/AndrewKochulab/sim-mirror/milestones). How

{sim_mirror-2.1.0 → sim_mirror-2.2.0}/THIRD_PARTY_LICENSES.md

@@ -127,5 +127,32 @@ ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 ```
 
+## scrcpy server
+
+- **What:** the server SimMirror runs on an Android device to stream its screen as H.264 and take its touches, keys
+  and text ([Android](docs/android.md)). It is **not** shipped: a person's setup (Set up touch, or `sim-mirror android
+  setup`) fetches release 5.0.1's `scrcpy-server-v5.0.1`, checks its size and SHA-256
+  (`764eb6f79811d5211fe9df341120882ba9994c7a61b897d7bf3fb662e53bc536`), and keeps it on your Mac; it is pushed to a
+  device only while SimMirror shows it, and is unchanged.
+- **Source:** [Genymobile/scrcpy](https://github.com/Genymobile/scrcpy)
+- **License:** Apache-2.0
+
+```
+Copyright (C) 2018 Genymobile
+Copyright (C) 2018-2026 Romain Vimont
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+```
+
 Runtime dependencies installed from PyPI and npm (FastAPI, Uvicorn, grpclib, protobuf, tomlkit, Pillow and others) are
 not redistributed here; each carries its own license in its package.

{sim_mirror-2.1.0 → sim_mirror-2.2.0}/docs/README.md

@@ -13,10 +13,11 @@
 - [Cursor](clients/cursor.md)
 - [Any other MCP client](clients/other-mcp.md)
 
-## Use it with a real device, and record
+## Use it with a real device or Android, and record
 
 - [Real devices](real-devices.md) -- a cabled iPhone or iPad: its live screen, apps and logs, and WebDriverAgent for
   touch, typing and the element tree
+- [Android](android.md) -- Android emulators and phones: adb, scrcpy's live screen, and Gradle builds and tests
 - [Recording](recording.md) -- a screen as an MP4 or a GIF, with each touch drawn, and a demo in a pull request
 
 ## Change its settings

{sim_mirror-2.1.0 → sim_mirror-2.2.0}/examples/README.md

@@ -14,7 +14,9 @@ Each folder is one way to use SimMirror, small enough to copy.
 | [custom-connector](custom-connector/) | A connector of your own, installed through the `sim_mirror.connectors` entry point, with contract tests |
 | [token-budget](token-budget/) | Measuring what each tool's answer costs an agent |
 | [app-sdk](app-sdk/) | An iOS app sharing its own views through SimMirrorKit: icon buttons, a tap gesture, a hand-drawn control with a describer, `.simMirror` tags |
+| [android-app](android-app/) | An Android app and its instrumented tests, which `sim_build_run` and `sim_test` build with its Gradle wrapper |
 
-Every example assumes a Mac with Xcode and a booted-or-bootable simulator, and `sim-mirror doctor` passing. The
+Every example assumes a Mac with Xcode and a booted-or-bootable simulator -- android-app, the Android SDK and an
+emulator instead -- and `sim-mirror doctor` passing. The
 examples are tested with SimMirror's own suite (`tests/examples/`), without starting a simulator; app-sdk's hosted
 tests run on a simulator with `make sdk-app-test`.

sim_mirror-2.2.0/examples/android-app/README.md

@@ -0,0 +1,37 @@
+# Android app
+
+A grocery list in one Kotlin activity, with two instrumented tests: the smallest Android project `sim_build_run` and
+`sim_test` build, install and test on an Android emulator or phone.
+
+```
+examples/android-app/
+├── settings.gradle.kts         the Gradle build SimMirror finds
+├── gradlew, gradle/wrapper/    its own wrapper: Gradle 9.3.1, checked by its SHA-256
+└── app/                        the one app module (AGP 9.1, Kotlin built in)
+    ├── src/main/               MainActivity: type an item, press Add
+    └── src/androidTest/        MainActivityTest: startsEmpty, addsAnItem
+```
+
+## Try it
+
+With an Android emulator chosen (`sim_device list`, then `choose`) and `build.tools` on, point the build at this
+folder and ask the agent to
+
+- build and run it: `sim_build_run` with `folder: "examples/android-app"` builds `:app:assembleDebug`, installs
+  `app-debug.apk` and launches `dev.simmirror.example`;
+- run its tests: `sim_test` runs `:app:connectedDebugAndroidTest` on the device and answers with what failed and where;
+  `only_testing: ["dev.simmirror.example.MainActivityTest/addsAnItem"]` runs one;
+- launch it with an item already on the list: `sim_app` `launch` with `args: ["item=Milk"]` -- each launch argument is
+  a string extra of the launch intent.
+
+Gradle needs a JDK (17 or later): Android Studio's own is found, or name one with `android.java_home`. The first build
+fetches Gradle and the Android Gradle plugin, which takes a minute; later builds take seconds.
+
+From a shell, the same build is
+
+```sh
+cd examples/android-app
+./gradlew :app:assembleDebug
+```
+
+SimMirror's own suite never builds this project; `make live-android` does, on an emulator.

{sim_mirror-2.1.0 → sim_mirror-2.2.0}/examples/claude-code-cli/README.md

@@ -16,7 +16,7 @@ Its tools are named `mcp__plugin_sim-mirror_sim-mirror__sim_snapshot` and so on.
 ## Without the plugin
 
 ```sh
-claude mcp add sim-mirror -- uvx --from sim-mirror==2.1.0 sim-mirror mcp
+claude mcp add sim-mirror -- uvx --from sim-mirror==2.2.0 sim-mirror mcp
 ```
 
 Add `--scope project` before the name to write it to the project's `.mcp.json` for everyone working on it. Its tools
@@ -30,7 +30,7 @@ simulator (its scope) and this folder as the only place builds and installs may
 ## Watch it
 
 ```sh
-uvx --from sim-mirror==2.1.0 sim-mirror open
+uvx --from sim-mirror==2.2.0 sim-mirror open
 ```
 
 opens this folder's viewer in your browser. Every gesture the agent makes is drawn there as a cursor just before it

{sim_mirror-2.1.0 → sim_mirror-2.2.0}/examples/codex/README.md

@@ -6,7 +6,7 @@ Add [config.toml](config.toml)'s table to `~/.codex/config.toml`, then start Cod
   and installs may reach. The commented `args` pin a project by name and path instead.
 - `tool_timeout_sec` is raised because `sim_build_run` and `sim_test` can take minutes (they are there only when build
   tools are switched on).
-- Watch and take over in a browser: `uvx --from sim-mirror==2.1.0 sim-mirror open`
+- Watch and take over in a browser: `uvx --from sim-mirror==2.2.0 sim-mirror open`
   in the same folder.
 
 The tools are the same for every client; see [claude-code-cli](../claude-code-cli/) for a first prompt to try.

{sim_mirror-2.1.0 → sim_mirror-2.2.0}/examples/cursor/README.md

@@ -6,7 +6,7 @@ one), and enable the server in Cursor's MCP settings.
 - `sim-mirror mcp` gives the agent the simulator of the folder it starts in, and that folder as the only place builds
   and installs may reach. If the tools act on the wrong project, append `"--scope", "my-app", "--root",
   "/absolute/path/to/my-app"` to `args`.
-- Watch and take over in a browser: `uvx --from sim-mirror==2.1.0 sim-mirror open`
+- Watch and take over in a browser: `uvx --from sim-mirror==2.2.0 sim-mirror open`
   in the same folder.
 
 The tools are the same for every client; see [claude-code-cli](../claude-code-cli/) for a first prompt to try.

{sim_mirror-2.1.0 → sim_mirror-2.2.0}/examples/fastapi-embed/README.md

@@ -5,7 +5,7 @@ A Python application with SimMirror inside it: [app.py](app.py). No daemon runs;
 
 ```sh
 cd examples/fastapi-embed
-EXAMPLE_KEY=change-me uv run --with "sim-mirror==2.1.0" \
+EXAMPLE_KEY=change-me uv run --with "sim-mirror==2.2.0" \
   uvicorn --factory app:create_app --port 7484
 ```
 

{sim_mirror-2.1.0 → sim_mirror-2.2.0}/helper/Sources/HelperCore/Wire.swift

@@ -3,7 +3,7 @@ import Foundation
 
 /// The helper's version, which is SimMirror's: SimMirror refuses a helper of another version.
 public enum HelperVersion {
-    public static let current = "2.1.0"
+    public static let current = "2.2.0"
 }
 
 /// What a frame on the socket is.

{sim_mirror-2.1.0 → sim_mirror-2.2.0}/protocol/v1/client-input.schema.json

@@ -18,9 +18,9 @@
       "enum": ["down", "move", "up", "cancel"]
     },
     "PanelButton": {
-      "description": "The hardware buttons a person may press from a viewer.",
+      "description": "The hardware buttons a person may press from a viewer, where the device has them (Device.buttons): Back, the app switcher and the volume buttons are an Android device's.",
       "x-constant": "PANEL_BUTTONS",
-      "enum": ["home", "lock", "side", "siri"]
+      "enum": ["home", "lock", "side", "siri", "back", "app_switch", "volume_up", "volume_down"]
     },
     "KeyName": {
       "description": "Keys that are not text. Text is sent whole, as a text input.",

{sim_mirror-2.1.0 → sim_mirror-2.2.0}/protocol/v1/common.schema.json

@@ -31,9 +31,9 @@
       ]
     },
     "DeviceKind": {
-      "description": "What a device is: a simulator on this Mac, or a real iPhone or iPad connected to it.",
+      "description": "What a device is: a simulator on this Mac, a real iPhone or iPad connected to it, or an Android device -- an emulator on this Mac or a phone adb reaches.",
       "x-constant": "DEVICE_KINDS",
-      "enum": ["simulator", "physical"]
+      "enum": ["simulator", "physical", "android"]
     },
     "Connection": {
       "description": "How a real device reaches this Mac: by cable, or over the network.",
@@ -107,11 +107,16 @@
         },
         "kind": {
           "$ref": "#/$defs/DeviceKind",
-          "description": "Whether it is a simulator or a real device. An older server does not send it: read it as simulator."
+          "description": "Whether it is a simulator, a real iPhone or iPad, or an Android device. An older server does not send it: read it as simulator."
         },
         "connection": {
           "oneOf": [{ "$ref": "#/$defs/Connection" }, { "type": "null" }],
-          "description": "How a real device reaches this Mac; null for a simulator. An older server does not send it."
+          "description": "How a real device reaches this Mac; null for a simulator or an emulator. An older server does not send it."
+        },
+        "buttons": {
+          "type": "array",
+          "items": { "$ref": "client-input.schema.json#/$defs/PanelButton" },
+          "description": "The hardware buttons that can be pressed on this device now; empty when none can. An older server does not send it: read it as home and lock while the device has input_button."
         },
         "recording": {
           "oneOf": [{ "$ref": "#/$defs/RecordingState" }, { "type": "null" }],
@@ -122,7 +127,7 @@
           "description": "Whether the device is light or dark, as SimMirror last read or set it; null until it knows. An older server does not send it."
         }
       },
-      "required": ["udid", "name", "runtime", "state", "reason", "since_ms", "viewers", "busy", "created", "booted_by_us", "screen", "app_hierarchy", "kind", "connection", "recording", "appearance"]
+      "required": ["udid", "name", "runtime", "state", "reason", "since_ms", "viewers", "busy", "created", "booted_by_us", "screen", "app_hierarchy", "kind", "connection", "buttons", "recording", "appearance"]
     },
     "RecordingState": {
       "description": "A recording of a device's screen under way.",

{sim_mirror-2.1.0 → sim_mirror-2.2.0}/protocol/v1/http.schema.json

@@ -54,10 +54,14 @@
         "stopped": { "type": "boolean" },
         "shut_down": {
           "type": "boolean",
-          "description": "Whether the device was shut down too: only a simulator, and only when asked."
+          "description": "Whether the device was shut down too: only a simulator or an emulator, and only when asked."
+        },
+        "kind": {
+          "description": "What kind of device was let go; null when none was running. An older server does not send it.",
+          "oneOf": [{ "$ref": "common.schema.json#/$defs/DeviceKind" }, { "type": "null" }]
         }
       },
-      "required": ["stopped", "shut_down"]
+      "required": ["stopped", "shut_down", "kind"]
     },
     "DeviceList": {
       "description": "GET a scope's devices: the simulators it could use, for a picker.",

{sim_mirror-2.1.0 → sim_mirror-2.2.0}/protocol/v1/status.schema.json

@@ -66,7 +66,7 @@
       ]
     },
     "DeviceChoice": {
-      "description": "A device a scope could use, for a device picker: a simulator on this Mac, or a real device connected to it.",
+      "description": "A device a scope could use, for a device picker: a simulator on this Mac, a real device connected to it, or an Android emulator or phone.",
       "type": "object",
       "properties": {
         "udid": { "type": "string" },
@@ -74,7 +74,7 @@
         "runtime": { "type": "string" },
         "state": {
           "type": "string",
-          "description": "What simctl says of a simulator, such as Booted or Shutdown; Connected or Disconnected for a real device."
+          "description": "What simctl says of a simulator, such as Booted or Shutdown; Connected or Disconnected for a real device; Booted or Shutdown for an Android emulator, and Connected, Unauthorized or Offline for an Android phone."
         },
         "created": { "type": "boolean" },
         "kind": {
@@ -83,7 +83,7 @@
         },
         "connection": {
           "oneOf": [{ "$ref": "common.schema.json#/$defs/Connection" }, { "type": "null" }],
-          "description": "How a real device reaches this Mac; null for a simulator."
+          "description": "How a real device reaches this Mac; null for a simulator or an Android emulator."
         },
         "detail": {
           "type": ["string", "null"],

{sim_mirror-2.1.0 → sim_mirror-2.2.0}/pyproject.toml

@@ -145,6 +145,9 @@ markers = [
     # tests/live/test_device_live.py: a cabled phone, driven only by `make live-device` with
     # SIM_MIRROR_LIVE_DEVICE_UDID set; skipped everywhere else.
     "live_device: drives a real, cabled phone",
+    # tests/live/test_android_live.py: a running Android emulator, driven only by `make live-android` with
+    # SIM_MIRROR_LIVE_ANDROID_UDID set; skipped everywhere else.
+    "live_android: drives a real, running Android emulator",
 ]
 
 [tool.coverage.run]

{sim_mirror-2.1.0 → sim_mirror-2.2.0}/src/sim_mirror/_version.py

@@ -1,4 +1,4 @@
 # SPDX-License-Identifier: Apache-2.0
 """The package version, read by the build backend and by `sim-mirror version`."""
 
-__version__ = "2.1.0"
+__version__ = "2.2.0"

{sim_mirror-2.1.0 → sim_mirror-2.2.0}/src/sim_mirror/build/destination.py

@@ -4,8 +4,9 @@
 A test run uses the scope's own device unless the call names another -- to run the tests on an older iOS, or on an
 iPad, without changing which device the scope shows. It is named the way a person names it, ``{"name": "iPhone 17"}``
 or ``{"udid": "…"}``, with ``"runtime": "iOS 26.5"`` to choose between simulators of one name, and must be one of the
-iOS simulators the scope's Xcode lists (`DeviceManager.devices`). A name that matches none, or several, is refused
-with the ones there are, so an agent can pick again rather than guess.
+iOS simulators the scope's Xcode lists (`DeviceManager.devices`) -- or, for an Android device's tests, one of the
+Android devices running here. A name that matches none, or several, is refused with the ones there are, so an agent
+can pick again rather than guess.
 
 Whether the device is someone else's to use is the provider's to ask (`build/provider.py`): this only reads the call.
 """
@@ -13,6 +14,7 @@ Whether the device is someone else's to use is the provider's to ask (`build/pro
 from __future__ import annotations
 
 from collections.abc import Sequence
+from dataclasses import dataclass
 from typing import NoReturn
 
 from sim_mirror.build.xcodebuild import BuildRefused
@@ -32,11 +34,29 @@ USAGE = (
 )
 
 
-def _text(value: object) -> str | None:
+@dataclass(frozen=True)
+class Wording:
+    """How a refusal names the devices a destination can be."""
+
+    usage: str
+    noun: str
+    where: str
+
+
+SIMULATORS = Wording(USAGE, "simulator", "on this Mac for this Xcode")
+ANDROID = Wording(
+    'destination is {"name": "Pixel 9"} or {"udid": "…"}, with "runtime": "Android 16 (API 36)" to choose between '
+    "devices of one name",
+    "Android device",
+    "running here",
+)
+
+
+def _text(value: object, wording: Wording) -> str | None:
     if value is None:
         return None
     if not isinstance(value, str) or not value.strip() or len(value) > TEXT_MAX or not value.isprintable():
-        raise BuildRefused(USAGE)
+        raise BuildRefused(wording.usage)
     return value.strip()
 
 
@@ -50,13 +70,13 @@ def _listed(choices: Sequence[DeviceChoice]) -> str:
     return shown + (f" and {more} more" if more > 0 else "") if shown else "none"
 
 
-def choose_destination(choices: Sequence[DeviceChoice], value: object) -> DeviceChoice:
-    """The simulator a call's ``destination`` names, from the ones the scope could use. Raises `BuildRefused`."""
+def choose_destination(choices: Sequence[DeviceChoice], value: object, wording: Wording = SIMULATORS) -> DeviceChoice:
+    """The device a call's ``destination`` names, from the ones the scope could use. Raises `BuildRefused`."""
     if not isinstance(value, dict) or not value.keys() <= KEYS or ("name" in value) == ("udid" in value):
-        raise BuildRefused(USAGE)
-    name, udid, runtime = _text(value.get("name")), _text(value.get("udid")), _text(value.get("runtime"))
+        raise BuildRefused(wording.usage)
+    name, udid, runtime = (_text(value.get(key), wording) for key in ("name", "udid", "runtime"))
     if udid is not None and kind_of(udid) is None:
-        raise BuildRefused(f"{udid!r} is not a simulator's or a real device's udid; {USAGE}")
+        raise BuildRefused(f"{udid!r} is not a simulator's or a real device's udid; {wording.usage}")
     found = [
         choice
         for choice in choices
@@ -67,16 +87,16 @@ def choose_destination(choices: Sequence[DeviceChoice], value: object) -> Device
     if len(found) == 1:
         return found[0]
     if found:
-        _several(name or "", found)
+        _several(name or "", found, wording)
     wanted = udid or (f"{name} ({runtime})" if runtime else name)
-    raise BuildRefused(f"there is no simulator {wanted} on this Mac for this Xcode; there are {_listed(choices)}")
+    raise BuildRefused(f"there is no {wording.noun} {wanted} {wording.where}; there are {_listed(choices)}")
 
 
-def _several(name: str, found: Sequence[DeviceChoice]) -> NoReturn:
+def _several(name: str, found: Sequence[DeviceChoice], wording: Wording) -> NoReturn:
     runtimes = sorted({choice["runtime"] for choice in found})
     if len(runtimes) == len(found):
-        raise BuildRefused(f"several simulators are named {name}; add a runtime: {', '.join(runtimes)}")
+        raise BuildRefused(f"several {wording.noun}s are named {name}; add a runtime: {', '.join(runtimes)}")
     raise BuildRefused(
-        f"several simulators are named {name} on one runtime; name one by udid: "
+        f"several {wording.noun}s are named {name} on one runtime; name one by udid: "
         + ", ".join(f"{choice['udid']} ({choice['runtime']})" for choice in found[:LISTED_MAX])
     )